@downcity/agent 1.1.222 → 1.1.224

package/src/session/recorder/SessionMessageReducer.ts

@@ -1,155 +0,0 @@
-/**
- * Session Message Mutation reducer。
- *
- * 历史重放与实时消费者共享 message、part、delta 三种归并语义。
- */
-
-import type { SessionAssistantMessage, SessionMessage } from "@/types/session/SessionMessage.js";
-import type { SessionMessageMutation } from "@/types/session/SessionMessageMutation.js";
-
-/** 将单条 Mutation 应用到已有 Message。 */
-export function reduce_session_message(
-  current_message: SessionMessage | undefined,
-  mutation: SessionMessageMutation,
-): SessionMessage {
-  if (mutation.variant === "message") {
-    validate_message_snapshot(current_message, mutation);
-    return structuredClone(mutation.message);
-  }
-  if (!current_message) {
-    throw new Error(`Session Message does not exist: ${mutation.message_id}`);
-  }
-  validate_next_revision(current_message, mutation);
-  const assistant = require_streaming_assistant(current_message);
-
-  if (mutation.variant === "part") {
-    if (mutation.part.part_id !== mutation.part_id) {
-      throw new Error(`Part Mutation identity mismatch: ${mutation.part_id}`);
-    }
-    if (mutation.part.type !== mutation.type) {
-      throw new Error(`Part Mutation type mismatch: ${mutation.part_id}`);
-    }
-    const exists = assistant.parts.some(
-      (part) => part.part_id === mutation.part_id,
-    );
-    const parts = exists
-      ? assistant.parts.map((part) =>
-          part.part_id === mutation.part_id
-            ? structuredClone(mutation.part)
-            : part,
-        )
-      : [...assistant.parts, structuredClone(mutation.part)];
-    return with_revision(assistant, mutation, { parts });
-  }
-
-  const existing_part = assistant.parts.find(
-    (part) => part.part_id === mutation.part_id,
-  );
-  if (
-    !existing_part ||
-    (existing_part.type !== "text" && existing_part.type !== "reasoning")
-  ) {
-    throw new Error(`Delta target Part does not exist: ${mutation.part_id}`);
-  }
-  if (existing_part.type !== mutation.type) {
-    throw new Error(`Delta type changed for Part: ${mutation.part_id}`);
-  }
-  const parts = assistant.parts.map((part) =>
-    part.part_id === mutation.part_id &&
-    (part.type === "text" || part.type === "reasoning")
-      ? { ...part, text: part.text + mutation.delta }
-      : part,
-  );
-  return with_revision(assistant, mutation, { parts });
-}
-
-/** 按 commit_sequence 重放 Mutation，恢复线性 Message snapshot。 */
-export function reduce_session_messages(
-  mutations: SessionMessageMutation[],
-): SessionMessage[] {
-  const messages = new Map<string, SessionMessage>();
-  const ordered = [...mutations].sort(
-    (left, right) => left.commit_sequence - right.commit_sequence,
-  );
-  let previous_commit_sequence = 0;
-  for (const mutation of ordered) {
-    if (mutation.commit_sequence <= previous_commit_sequence) {
-      throw new Error(`Duplicate commit_sequence: ${String(mutation.commit_sequence)}`);
-    }
-    messages.set(
-      mutation.message_id,
-      reduce_session_message(messages.get(mutation.message_id), mutation),
-    );
-    previous_commit_sequence = mutation.commit_sequence;
-  }
-  return [...messages.values()].sort(
-    (left, right) => left.sequence - right.sequence,
-  );
-}
-
-function validate_message_snapshot(
-  current_message: SessionMessage | undefined,
-  mutation: Extract<SessionMessageMutation, { variant: "message" }>,
-): void {
-  if (mutation.message.message_id !== mutation.message_id) {
-    throw new Error(`Message Mutation identity mismatch: ${mutation.message_id}`);
-  }
-  if (mutation.message.type !== mutation.type) {
-    throw new Error(`Message Mutation type mismatch: ${mutation.message_id}`);
-  }
-  if (mutation.message.sequence !== mutation.sequence) {
-    throw new Error(`Message Mutation sequence mismatch: ${mutation.message_id}`);
-  }
-  if (mutation.message.revision !== mutation.revision) {
-    throw new Error(`Message Mutation revision mismatch: ${mutation.message_id}`);
-  }
-  if (!current_message) {
-    if (mutation.revision !== 1) {
-      throw new Error(`New Message revision must be 1: ${mutation.message_id}`);
-    }
-    return;
-  }
-  validate_next_revision(current_message, mutation);
-  if (current_message.type !== mutation.type) {
-    throw new Error(`Message type changed: ${mutation.message_id}`);
-  }
-  if (current_message.sequence !== mutation.sequence) {
-    throw new Error(`Message sequence changed: ${mutation.message_id}`);
-  }
-}
-
-function validate_next_revision(
-  current_message: SessionMessage,
-  mutation: SessionMessageMutation,
-): void {
-  if (mutation.revision !== current_message.revision + 1) {
-    throw new Error(
-      `Invalid Message revision for ${mutation.message_id}: expected ${String(current_message.revision + 1)}, received ${String(mutation.revision)}`,
-    );
-  }
-}
-
-function require_streaming_assistant(
-  message: SessionMessage,
-): SessionAssistantMessage {
-  if (message.type !== "assistant") {
-    throw new Error(`Session Message is not assistant: ${message.message_id}`);
-  }
-  if (message.status !== "streaming") {
-    throw new Error(`Assistant Message is already closed: ${message.message_id}`);
-  }
-  return message;
-}
-
-function with_revision<TMessage extends SessionMessage>(
-  message: TMessage,
-  mutation: SessionMessageMutation,
-  changes: object,
-): TMessage {
-  return {
-    ...message,
-    ...changes,
-    revision: mutation.revision,
-    updated_at: mutation.created_at,
-  } as TMessage;
-}

package/src/session/runtime/SessionMessageEventHub.ts

@@ -1,35 +0,0 @@
-/**
- * SessionMessage mutation 事件总线。
- *
- * EventHub 只广播 Recorder 已成功提交的 mutation，不创建或转换事件。
- */
-
-import type {
-  SessionMessageMutation,
-  SessionMessageMutationSubscriber,
-  SessionMessageMutationUnsubscribe,
-} from "@/types/session/SessionMessageMutation.js";
-
-/** SessionMessage mutation 的进程内广播器。 */
-export class SessionMessageEventHub {
-  private readonly subscribers = new Set<SessionMessageMutationSubscriber>();
-
-  /** 订阅未来成功提交的 mutation。 */
-  subscribe(subscriber: SessionMessageMutationSubscriber): SessionMessageMutationUnsubscribe {
-    this.subscribers.add(subscriber);
-    return () => {
-      this.subscribers.delete(subscriber);
-    };
-  }
-
-  /** 广播一条已持久化 mutation。 */
-  publish(mutation: SessionMessageMutation): void {
-    for (const subscriber of this.subscribers) {
-      try {
-        subscriber(mutation);
-      } catch {
-        // 单个订阅者失败不能影响提交结果和其他订阅者。
-      }
-    }
-  }
-}

package/src/types/sdk/AgentSessionEvent.ts

@@ -1,372 +0,0 @@
-/**
- * Agent Session 事件类型定义。
- *
- * 关键点（中文）
- * - `subscribe()` 暴露的是 session 级长期事件序列，而不是单次执行的局部结果。
- * - 事件只表达“当前 turn 正在发生什么”，不负责历史回放。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-import type { SessionAssistantStepVisibility } from "@/executor/types/SessionRun.js";
-import type { AgentSessionActionEvent } from "@/types/sdk/AgentSessionAction.js";
-import type { SessionMessageMutation } from "@/types/session/SessionMessageMutation.js";
-
-/**
- * 单个 turn 开始事件。
- */
-export interface AgentSessionTurnStartEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "turn-start";
-
-  /**
-   * 当前 turn 的稳定标识。
-   *
-   * 说明（中文）
-   * - 同一个 turn 内的全部增量事件都会复用这个 turnId。
-   * - 当 Session 排队进入下一轮时，会生成新的 turnId。
-   */
-  turnId: string;
-}
-
-/**
- * 普通文本增量事件。
- */
-export interface AgentSessionTextDeltaEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "text-delta";
-
-  /**
-   * 当前文本所属 turn。
-   */
-  turnId: string;
-
-  /**
-   * 当前这次新增的可见文本片段。
-   */
-  text: string;
-}
-
-/**
- * reasoning 文本增量事件。
- */
-export interface AgentSessionReasoningDeltaEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "reasoning-delta";
-
-  /**
-   * 当前 reasoning 所属 turn。
-   */
-  turnId: string;
-
-  /**
-   * 当前这次新增的 reasoning 文本片段。
-   */
-  text: string;
-}
-
-/**
- * 工具调用事件。
- */
-export interface AgentSessionToolCallEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "tool-call";
-
-  /**
-   * 当前工具调用所属 turn。
-   */
-  turnId: string;
-
-  /**
-   * 当前工具调用唯一标识。
-   */
-  toolCallId: string;
-
-  /**
-   * 当前工具名称。
-   */
-  toolName: "shell_exec" | "shell_session" | "shell_write" | string;
-
-  /**
-   * 当前工具输入参数。
-   */
-  args: JsonValue;
-}
-
-/**
- * 工具结果事件。
- */
-export interface AgentSessionToolResultEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "tool-result";
-
-  /**
-   * 当前工具结果所属 turn。
-   */
-  turnId: string;
-
-  /**
-   * 当前工具调用唯一标识。
-   */
-  toolCallId: string;
-
-  /**
-   * 当前工具名称。
-   */
-  toolName: "shell_exec" | "shell_session" | "shell_write" | string;
-
-  /**
-   * 当前工具输出结果。
-   */
-  result: JsonValue;
-}
-
-/**
- * 工具审批请求事件。
- */
-export interface AgentSessionToolApprovalRequestEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "tool-approval-request";
-
-  /**
-   * 当前审批所属 turn。
-   */
-  turnId: string;
-
-  /**
-   * 当前工具调用唯一标识。
-   */
-  toolCallId: string;
-
-  /**
-   * 当前工具名称。
-   */
-  toolName: "shell_exec" | "shell_session" | "shell_write" | string;
-
-  /**
-   * 当前审批请求唯一标识。
-   */
-  approvalId: string;
-
-  /**
-   * 请求执行的 sandbox 模式。
-   */
-  sandbox: "unrestricted";
-
-  /**
-   * 请求执行的命令文本。
-   *
-   * 说明（中文）
-   * - `shell_exec` / `shell_session` start 中是命令文本。
-   * - `shell_write` 中是 stdin 写入内容，用于兼容内部审批展示。
-   */
-  cmd: string;
-
-  /**
-   * 当前审批动作类型。
-   */
-  operation?: "exec" | "start" | "write";
-
-  /**
-   * 关联 shell_id；session 输入审批时用于标识目标会话。
-   */
-  shellId?: string;
-
-  /**
-   * stdin 写入内容预览；仅 session 输入审批存在。
-   */
-  inputPreview?: string;
-
-  /**
-   * stdin 写入字符数；仅 session 输入审批存在。
-   */
-  inputChars?: number;
-
-  /**
-   * 命令执行目录。
-   */
-  cwd: string;
-
-  /**
-   * Agent 给用户展示的申请原因。
-   */
-  reason: string;
-
-  /**
-   * 当前审批状态。
-   */
-  status: "pending";
-}
-
-/**
- * 工具审批结果事件。
- */
-export interface AgentSessionToolApprovalResultEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "tool-approval-result";
-
-  /**
-   * 当前审批所属 turn。
-   */
-  turnId: string;
-
-  /**
-   * 当前工具调用唯一标识。
-   */
-  toolCallId: string;
-
-  /**
-   * 当前工具名称。
-   */
-  toolName: "shell_exec" | "shell_session" | "shell_write" | string;
-
-  /**
-   * 当前审批请求唯一标识。
-   */
-  approvalId: string;
-
-  /**
-   * 用户最终决策。
-   */
-  decision: "approved" | "denied" | "expired";
-}
-
-/**
- * assistant step 完成事件。
- */
-export interface AgentSessionAssistantStepEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "assistant-step";
-
-  /**
-   * 当前 assistant step 所属 turn。
-   */
-  turnId: string;
-
-  /**
-   * 当前 step 文本。
-   */
-  text: string;
-
-  /**
-   * 当前 step 序号（从 1 开始）。
-   */
-  stepIndex: number;
-
-  /**
-   * 当前 step 可见性。
-   */
-  visibility?: SessionAssistantStepVisibility;
-}
-
-/**
- * Session 标题更新事件。
- */
-export interface AgentSessionTitleEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "session-title";
-
-  /**
-   * 当前 session 唯一标识。
-   */
-  sessionId: string;
-
-  /**
-   * 当前 session 最新标题。
-   *
-   * 说明（中文）
-   * - 标题已持久化到 session meta。
-   * - 新 session 通常在首条 user message 落盘后生成标题。
-   */
-  title: string;
-}
-
-/**
- * 单个 turn 完成事件。
- */
-export interface AgentSessionTurnFinishEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "turn-finish";
-
-  /**
-   * 当前已完成 turn 的稳定标识。
-   */
-  turnId: string;
-
-  /**
-   * 当前 turn 最终可见文本。
-   */
-  text: string;
-
-  /**
-   * 当前 turn 是否成功结束。
-   */
-  success: boolean;
-
-  /**
-   * 当前 turn 失败时的错误文本。
-   */
-  error?: string;
-}
-
-/**
- * Session 级错误事件。
- */
-export interface AgentSessionErrorEvent {
-  /**
-   * 当前事件类型。
-   */
-  type: "error";
-
-  /**
-   * 当前错误文本。
-   */
-  message: string;
-}
-
-/**
- * Session 订阅可见事件联合类型。
- */
-export type AgentSessionEvent =
-  | SessionMessageMutation
-  | AgentSessionTurnStartEvent
-  | AgentSessionTextDeltaEvent
-  | AgentSessionReasoningDeltaEvent
-  | AgentSessionToolCallEvent
-  | AgentSessionToolResultEvent
-  | AgentSessionToolApprovalRequestEvent
-  | AgentSessionToolApprovalResultEvent
-  | AgentSessionAssistantStepEvent
-  | AgentSessionTitleEvent
-  | AgentSessionActionEvent
-  | AgentSessionTurnFinishEvent
-  | AgentSessionErrorEvent;
-
-/**
- * Session 事件订阅回调。
- */
-export type AgentSessionSubscriber = (event: AgentSessionEvent) => void;
-
-/**
- * 取消 Session 订阅的返回函数。
- */
-export type AgentSessionUnsubscribe = () => void;

package/src/types/session/SessionMessageMutation.ts

@@ -1,121 +0,0 @@
-/**
- * Session Message Mutation 与增量读取类型。
- *
- * Mutation 只按变化层级分成 message、part、delta 三种 variant；`type` 在各 variant
- * 内直接表达对应的 Message 或 Part 类型。
- */
-
-import type { SessionAssistantMessagePart, SessionMessage } from "@/types/session/SessionMessage.js";
-
-/** Mutation 公共字段。 */
-export interface SessionMessageMutationBase {
-  /** Mutation 稳定唯一标识。 */
-  mutation_id: string;
-  /** Mutation 在 Session 内的单调提交序号。 */
-  commit_sequence: number;
-  /** Mutation 目标 Message。 */
-  message_id: string;
-  /** 应用 Mutation 后的 Message revision。 */
-  revision: number;
-  /** Mutation 所属 Session。 */
-  session_id: string;
-  /** Mutation 所属 turn。 */
-  turn_id?: string;
-  /** Mutation 创建时间戳（ms）。 */
-  created_at: number;
-}
-
-/** 顶层 Message 创建或状态更新 Mutation。 */
-export type SessionMessageSnapshotMutation = {
-  [TType in SessionMessage["type"]]: SessionMessageMutationBase & {
-    /** Mutation 层级固定为 message。 */
-    variant: "message";
-    /** 当前完整 Message 类型。 */
-    type: TType;
-    /** Message 在线性 Session 中的固定位置。 */
-    sequence: number;
-    /** 创建或更新后的完整 Message 快照。 */
-    message: Extract<SessionMessage, { type: TType }>;
-  };
-}[SessionMessage["type"]];
-
-/** Assistant Part 创建或状态更新 Mutation。 */
-export type SessionPartSnapshotMutation = {
-  [TType in SessionAssistantMessagePart["type"]]: SessionMessageMutationBase & {
-    /** Mutation 层级固定为 part。 */
-    variant: "part";
-    /** 当前完整 Part 类型。 */
-    type: TType;
-    /** 被创建或更新的 Part 标识。 */
-    part_id: string;
-    /** 创建或更新后的完整 Part 快照。 */
-    part: SessionAssistantMessagePart & { type: TType };
-  };
-}[SessionAssistantMessagePart["type"]];
-
-/** Assistant 文本或推理原始增量 Mutation。 */
-export interface SessionDeltaMutation extends SessionMessageMutationBase {
-  /** Mutation 层级固定为 delta。 */
-  variant: "delta";
-  /** Delta 类型只允许 text 或 reasoning。 */
-  type: "text" | "reasoning";
-  /** Delta 所属 Part 标识。 */
-  part_id: string;
-  /** 本次模型新增的原始文本，不是累计全文。 */
-  delta: string;
-}
-
-/** 全部合法 Session Message Mutation。 */
-export type SessionMessageMutation =
-  | SessionMessageSnapshotMutation
-  | SessionPartSnapshotMutation
-  | SessionDeltaMutation;
-
-/** 从 commit cursor 增量读取 Mutation 的输入。 */
-export interface ListSessionMessageChangesInput {
-  /** 只返回 commit_sequence 严格大于该值的 Mutation。 */
-  after_commit_sequence: number;
-  /** 单页数量上限。 */
-  limit?: number;
-}
-
-/** Mutation 增量分页结果。 */
-export interface SessionMessageMutationPage {
-  /** 当前页按 commit_sequence 升序排列的 Mutation。 */
-  items: SessionMessageMutation[];
-  /** 当前页之后是否仍有 Mutation。 */
-  has_more: boolean;
-  /** 下一次增量读取应使用的 commit_sequence。 */
-  next_commit_sequence: number;
-  /** 当前 Session 已提交的最大 commit_sequence。 */
-  latest_commit_sequence: number;
-}
-
-/** Session Mutation 订阅回调。 */
-export type SessionMessageMutationSubscriber = (mutation: SessionMessageMutation) => void;
-
-/** 取消 Session Mutation 订阅的函数。 */
-export type SessionMessageMutationUnsubscribe = () => void;
-
-/** 判断未知事件是否为 Session Message Mutation。 */
-export function is_session_message_mutation(input: unknown): input is SessionMessageMutation {
-  if (!input || typeof input !== "object") return false;
-  const candidate = input as {
-    variant?: unknown;
-    type?: unknown;
-    mutation_id?: unknown;
-    commit_sequence?: unknown;
-  };
-  if (
-    typeof candidate.mutation_id !== "string" ||
-    typeof candidate.commit_sequence !== "number" ||
-    typeof candidate.type !== "string"
-  ) {
-    return false;
-  }
-  return (
-    candidate.variant === "message" ||
-    candidate.variant === "part" ||
-    candidate.variant === "delta"
-  );
-}