@downcity/agent 1.1.408 → 1.1.437

package/src/types/session/SessionInteraction.ts

@@ -1,268 +0,0 @@
-/**
- * Session Interaction 通用协议。
- *
- * Interaction 只定义可持久化的生命周期与通用信封；业务类型和 payload
- * 由 Tool、Plugin、Shell 或宿主应用动态定义，前端可以自由选择渲染方式。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-
-/** Interaction 当前生命周期状态。 */
-export type SessionInteractionStatus =
-  | "pending"
-  | "resolved"
-  | "denied"
-  | "expired"
-  | "cancelled"
-  | "failed";
-
-/** 高风险操作审批请求是否需要用户逐次确认。 */
-export type SessionApprovalMode = "ask" | "always-allow";
-
-/** Interaction 的执行来源。 */
-export type SessionInteractionSource =
-  | {
-      /** 来源为 Tool Call。 */
-      type: "tool";
-      /** 发起 Interaction 的稳定 Tool Call 标识。 */
-      tool_call_id?: string;
-      /** 发起 Interaction 的工具注册名称。 */
-      tool_name?: string;
-    }
-  | {
-      /** 来源为 Plugin。 */
-      type: "plugin";
-      /** 发起 Interaction 的 Plugin 名称。 */
-      plugin_name: string;
-      /** Plugin 关联的 Tool Call 标识。 */
-      tool_call_id?: string;
-      /** Plugin 关联的 Tool 名称。 */
-      tool_name?: string;
-    }
-  | {
-      /** 来源为 Shell。 */
-      type: "shell";
-      /** 发起 Interaction 的 Shell Tool Call 标识。 */
-      tool_call_id?: string;
-      /** 发起 Interaction 的 Shell 工具名称。 */
-      tool_name?: string;
-    }
-  | {
-      /** 来源为不绑定具体 Tool 的 Session 执行过程。 */
-      type: "execution";
-      /** 可选关联的 Tool Call 标识。 */
-      tool_call_id?: string;
-      /** 可选关联的 Tool 名称。 */
-      tool_name?: string;
-    };
-
-/** Interaction 请求公共字段。 */
-export interface SessionInteractionRequest {
-  /** 当前 Interaction 的稳定唯一标识。 */
-  interaction_id: string;
-  /** 当前 Interaction 所属 Turn 标识。 */
-  turn_id: string;
-  /** 动态业务类型；核心类型使用 question、approval 等，Plugin 使用命名空间。 */
-  type: string;
-  /** 当前 Interaction 的执行来源。 */
-  source: SessionInteractionSource;
-  /** 前端可选展示标题。 */
-  title?: string;
-  /** 前端可选展示描述。 */
-  description?: string;
-  /** 业务请求数据，由 type 对应的生产者解释。 */
-  payload: JsonValue;
-  /** 响应数据的声明式校验结构；不包含可执行 UI 代码。 */
-  response_schema?: JsonValue;
-  /** 当前 Interaction 创建时间戳，单位为毫秒。 */
-  created_at: number;
-  /** 当前 Interaction 自动过期时间戳，省略表示不自动过期。 */
-  expires_at?: number;
-}
-
-/** Approval Interaction 的默认 payload 结构。 */
-export interface SessionApprovalPayload {
-  /** 当前审批决定对应的操作。 */
-  operation: "exec" | "start" | "write" | "tool";
-  /** 请求执行的命令或输入文本。 */
-  command?: string;
-  /** 请求执行时使用的工作目录。 */
-  cwd?: string;
-  /** 请求高风险操作的明确原因。 */
-  reason?: string;
-  /** Tool schema 校验通过后的真实调用输入。 */
-  validated_input?: JsonValue;
-  /** Tool 定义提供的稳定能力说明。 */
-  tool_description?: string;
-  /** 模型为当前调用给出的可选解释。 */
-  model_explanation?: string;
-}
-
-/** Question 支持的回答形式。 */
-export type SessionInteractionQuestionResponseType =
-  | "text"
-  | "single_select"
-  | "multi_select";
-
-/** Question 选择项。 */
-export interface SessionInteractionOption {
-  /** 当前选项在问题内的稳定值。 */
-  value: string;
-  /** 当前选项向用户展示的标签。 */
-  label: string;
-  /** 当前选项的可选解释。 */
-  description?: string;
-}
-
-/** 一条等待用户回答的问题。 */
-export interface SessionInteractionQuestion {
-  /** 当前问题在 Interaction 内的稳定标识。 */
-  question_id: string;
-  /** 向用户展示的完整问题文本。 */
-  prompt: string;
-  /** 当前问题要求的回答形式。 */
-  response_type: SessionInteractionQuestionResponseType;
-  /** 单选或多选问题允许选择的候选项。 */
-  options?: SessionInteractionOption[];
-}
-
-/** Question Interaction 的默认 payload 结构。 */
-export interface SessionQuestionPayload {
-  /** Interaction 包含的一到多条问题。 */
-  questions: SessionInteractionQuestion[];
-}
-
-/** Approval Interaction 的用户响应 payload。 */
-export interface SessionApprovalResponsePayload {
-  /** 用户对审批作出的最终决定。 */
-  decision: "approved" | "denied";
-  /** 拒绝时的可选原因。 */
-  reason?: string;
-}
-
-/** 单条 Question 回答。 */
-export interface SessionInteractionAnswer {
-  /** 当前回答对应的问题标识。 */
-  question_id: string;
-  /** 文本或选择回答值；多选回答使用字符串数组。 */
-  value: string | string[];
-}
-
-/** Question Interaction 的用户响应 payload。 */
-export interface SessionQuestionResponsePayload {
-  /** 按 question_id 关联的完整回答集合。 */
-  answers: SessionInteractionAnswer[];
-}
-
-/** 用户提交一次 Interaction 响应的通用结构。 */
-export interface SessionInteractionResponse {
-  /** 必须与原请求 type 一致。 */
-  type: string;
-  /** 用户是否允许当前 Interaction 继续。 */
-  outcome: "resolved" | "denied";
-  /** 业务响应数据，由 type 对应的生产者解释。 */
-  payload: JsonValue;
-}
-
-/** 用户提交一次 Interaction 响应的公开输入。 */
-export interface RespondSessionInteractionInput {
-  /** 需要响应的 pending Interaction 标识。 */
-  interaction_id: string;
-  /** 与原请求 type 一致的结构化响应。 */
-  response: SessionInteractionResponse;
-}
-
-/** Interaction 已成功收到用户响应。 */
-export interface SessionResolvedInteractionResult {
-  /** 终态固定为 resolved。 */
-  status: "resolved";
-  /** 已完成的 Interaction 标识。 */
-  interaction_id: string;
-  /** 已持久化的结构化用户响应。 */
-  response: SessionInteractionResponse;
-}
-
-/** Interaction 被拒绝。 */
-export interface SessionDeniedInteractionResult {
-  /** 终态固定为 denied。 */
-  status: "denied";
-  /** 被拒绝的 Interaction 标识。 */
-  interaction_id: string;
-  /** 可选拒绝原因。 */
-  reason?: string;
-}
-
-/** Interaction 因等待超时结束。 */
-export interface SessionExpiredInteractionResult {
-  /** 终态固定为 expired。 */
-  status: "expired";
-  /** 已过期的 Interaction 标识。 */
-  interaction_id: string;
-}
-
-/** Interaction 因 Session 生命周期变化被取消。 */
-export interface SessionCancelledInteractionResult {
-  /** 终态固定为 cancelled。 */
-  status: "cancelled";
-  /** 已取消的 Interaction 标识。 */
-  interaction_id: string;
-  /** Interaction 被取消的稳定原因。 */
-  reason: "turn_stopped" | "session_disposed" | "runtime_interrupted";
-}
-
-/** Interaction 执行失败。 */
-export interface SessionFailedInteractionResult {
-  /** 终态固定为 failed。 */
-  status: "failed";
-  /** 执行失败的 Interaction 标识。 */
-  interaction_id: string;
-  /** 稳定失败说明。 */
-  error: string;
-}
-
-/** Interaction 等待方最终收到的领域结果。 */
-export type SessionInteractionResult =
-  | SessionResolvedInteractionResult
-  | SessionDeniedInteractionResult
-  | SessionExpiredInteractionResult
-  | SessionCancelledInteractionResult
-  | SessionFailedInteractionResult;
-
-/** 当前 Session 中一条 pending Interaction 的公开快照。 */
-export interface SessionPendingInteraction {
-  /** 已持久化的完整 Interaction 请求。 */
-  request: SessionInteractionRequest;
-}
-
-/** 执行方等待一次 Interaction 的运行时句柄。 */
-export interface SessionInteractionHandle {
-  /** 已成功持久化并等待响应的 Interaction 标识。 */
-  interaction_id: string;
-  /** Interaction 进入终态后兑现的领域结果。 */
-  result: Promise<SessionInteractionResult>;
-}
-
-/** 执行面请求用户异步参与的最小端口。 */
-export interface SessionInteractionPort {
-  /** 创建并持久化一次 Interaction，返回等待终态结果的句柄。 */
-  request(
-    request: SessionInteractionRequest,
-  ): Promise<SessionInteractionHandle>;
-}
-
-/** 控制面结束 Turn 时使用的 Interaction 生命周期端口。 */
-export interface SessionInteractionLifecycle {
-  /** 取消当前 Session 中全部 pending Interaction。 */
-  cancel_all(
-    reason: "turn_stopped" | "session_disposed" | "runtime_interrupted",
-  ): Promise<void>;
-}
-
-/** 默认审批响应 schema，供前端生成自由实现的控件。 */
-export const SESSION_APPROVAL_RESPONSE_SCHEMA: JsonValue = {
-  type: "object",
-  required: ["decision"],
-  properties: {
-    decision: { type: "string", enum: ["approved", "denied"] },
-  },
-};

package/src/types/session/SessionMessage.ts

@@ -1,306 +0,0 @@
-/**
- * Session canonical 消息类型。
- *
- * Session 只维护一条由 sequence 排序的消息序列；assistant 的 text、reasoning、tool、file
- * 均为内部 part，不提升为顶层消息。
- */
-
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-import type {
-  SessionInteractionRequest,
-  SessionInteractionResponse,
-  SessionInteractionStatus,
-} from "@/types/session/SessionInteraction.js";
-
-/** Message 默认展示范围。 */
-export type SessionMessageVisibility = "visible" | "internal";
-
-/** 从其他 Session 导入时保留的来源身份。 */
-export interface SessionMessageOrigin {
-  /** 来源 Session 标识。 */
-  session_id: string;
-  /** 来源 Message 标识。 */
-  message_id: string;
-  /** 来源 turn 标识。 */
-  turn_id?: string;
-}
-
-/** Session Message 公共字段。 */
-export interface SessionMessageBase {
-  /** 当前 Message 在 Session 内的稳定唯一标识。 */
-  message_id: string;
-  /** 当前 Message 所属 Session 标识。 */
-  session_id: string;
-  /** 当前 Message 所属 turn；独立 action 可以省略。 */
-  turn_id?: string;
-  /** Message 的线性位置；创建后永远不变。 */
-  sequence: number;
-  /** Message 版本号；每次对外发布的消息变化后递增。 */
-  revision: number;
-  /** 当前 Message 是否默认对用户可见。 */
-  visibility: SessionMessageVisibility;
-  /** Message 首次创建时间戳（ms）。 */
-  created_at: number;
-  /** Message 最近更新时间戳（ms）。 */
-  updated_at: number;
-  /** 从其他 Session 导入时的来源信息。 */
-  origin?: SessionMessageOrigin;
-}
-
-/** User 文本 part。 */
-export interface SessionUserTextPart {
-  /** User Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** part 类型固定为 text。 */
-  type: "text";
-  /** 用户输入文本。 */
-  text: string;
-  /** User 文本已经完整，不参与流式更新。 */
-  state: "done";
-}
-
-/** User 文件 part。 */
-export interface SessionUserFilePart {
-  /** User Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** part 类型固定为 file。 */
-  type: "file";
-  /** 文件可读取地址或 data URL。 */
-  url: string;
-  /** 文件 MIME 类型。 */
-  media_type: string;
-  /** 可选原始文件名。 */
-  filename?: string;
-}
-
-/** User 结构化数据 part。 */
-export interface SessionUserDataPart {
-  /** User Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** part 类型固定为 data。 */
-  type: "data";
-  /** Session data part 的类型名称。 */
-  data_type: `data-${string}` | string;
-  /** 可 JSON 序列化的数据。 */
-  data: JsonValue;
-  /** Session data part 的可选稳定标识。 */
-  data_id?: string;
-}
-
-/** User Message part。 */
-export type SessionUserMessagePart =
-  | SessionUserTextPart
-  | SessionUserFilePart
-  | SessionUserDataPart;
-
-/** User 顶层 Message。 */
-export interface SessionUserMessage extends SessionMessageBase {
-  /** Message 类型固定为 user。 */
-  type: "user";
-  /** 普通 prompt 或当前 turn 中的 steering 输入。 */
-  input_type: "prompt" | "steer";
-  /** 用户消息的结构化 parts。 */
-  parts: SessionUserMessagePart[];
-}
-
-/** Assistant 普通文本 part。 */
-export interface SessionAssistantTextPart {
-  /** Assistant Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** Assistant Part 在当前 Message 中的不可变线性顺序，从 1 开始。 */
-  sequence: number;
-  /** part 类型固定为 text。 */
-  type: "text";
-  /** 当前已经累计的完整文本。 */
-  text: string;
-  /** 文本 part 是否已经结束。 */
-  state: "streaming" | "done";
-}
-
-/** Assistant 推理文本 part。 */
-export interface SessionAssistantReasoningPart {
-  /** Assistant Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** Assistant Part 在当前 Message 中的不可变线性顺序，从 1 开始。 */
-  sequence: number;
-  /** part 类型固定为 reasoning。 */
-  type: "reasoning";
-  /** 当前已经累计的完整推理文本。 */
-  text: string;
-  /** 推理 part 是否已经结束。 */
-  state: "streaming" | "done";
-  /** Provider 用于后续模型上下文续接的可选不透明签名。 */
-  reasoning_signature?: string;
-}
-
-/** Assistant 工具 part。 */
-export interface SessionAssistantToolPart {
-  /** Assistant Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** Assistant Part 在当前 Message 中的不可变线性顺序，从 1 开始。 */
-  sequence: number;
-  /** part 类型固定为 tool。 */
-  type: "tool";
-  /** 模型工具调用稳定标识。 */
-  tool_call_id: string;
-  /** 工具注册名称。 */
-  tool_name: string;
-  /** 工具当前生命周期状态。 */
-  state: "input-streaming" | "ready" | "waiting-user" | "running" | "completed" | "failed";
-  /** 流式接收中的参数原文。 */
-  input_text?: string;
-  /** 收敛后的结构化输入。 */
-  input?: JsonValue;
-  /** 工具成功输出。 */
-  output?: JsonValue;
-  /** 工具失败信息。 */
-  error?: string;
-  /** 工具调用的可选展示标题。 */
-  title?: string;
-}
-
-/** Assistant 用户异步交互 part。 */
-export interface SessionAssistantInteractionPart {
-  /** Assistant Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** Assistant Part 在当前 Message 中的不可变线性顺序，从 1 开始。 */
-  sequence: number;
-  /** part 类型固定为 interaction。 */
-  type: "interaction";
-  /** 当前 Interaction 的稳定唯一标识。 */
-  interaction_id: string;
-  /** 当前 Interaction 的具体业务类型。 */
-  interaction_type: string;
-  /** 当前 Interaction 的生命周期状态。 */
-  status: SessionInteractionStatus;
-  /** 已持久化的完整 Interaction 请求。 */
-  request: SessionInteractionRequest;
-  /** 用户已响应时保存的结构化响应。 */
-  response?: SessionInteractionResponse;
-  /** Interaction 进入终态的时间戳，单位为毫秒。 */
-  resolved_at?: number;
-  /** Interaction 被取消时保存的稳定原因。 */
-  cancel_reason?: "turn_stopped" | "session_disposed" | "runtime_interrupted";
-}
-
-/** Assistant 文件 part。 */
-export interface SessionAssistantFilePart {
-  /** Assistant Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** Assistant Part 在当前 Message 中的不可变线性顺序，从 1 开始。 */
-  sequence: number;
-  /** part 类型固定为 file。 */
-  type: "file";
-  /** 文件 MIME 类型。 */
-  media_type: string;
-  /** 文件可读取地址或 data URL。 */
-  url: string;
-  /** 可选原始文件名。 */
-  filename?: string;
-}
-
-/** Assistant 结构化数据 part。 */
-export interface SessionAssistantDataPart {
-  /** Assistant Message 内稳定的 part 标识。 */
-  part_id: string;
-  /** Assistant Part 在当前 Message 中的不可变线性顺序，从 1 开始。 */
-  sequence: number;
-  /** part 类型固定为 data。 */
-  type: "data";
-  /** Session data part 的类型名称。 */
-  data_type: `data-${string}` | string;
-  /** 可 JSON 序列化的数据。 */
-  data: JsonValue;
-  /** Session data part 的可选稳定标识。 */
-  data_id?: string;
-}
-
-/** Assistant Message part。 */
-export type SessionAssistantMessagePart =
-  | SessionAssistantTextPart
-  | SessionAssistantReasoningPart
-  | SessionAssistantToolPart
-  | SessionAssistantInteractionPart
-  | SessionAssistantFilePart
-  | SessionAssistantDataPart;
-
-/** Assistant 顶层 Message。 */
-export interface SessionAssistantMessage extends SessionMessageBase {
-  /** Message 类型固定为 assistant。 */
-  type: "assistant";
-  /** 普通 Assistant 回复或内部 compact summary。 */
-  kind: "normal" | "summary";
-  /** Assistant 当前执行状态。 */
-  status: "streaming" | "completed" | "stopped" | "failed";
-  /** Assistant 内按真实生成顺序保存的 parts。 */
-  parts: SessionAssistantMessagePart[];
-  /** Summary 已覆盖到的来源 Message 标识。 */
-  summary_through_message_id?: string;
-}
-
-/** Action 顶层 Message。 */
-export interface SessionActionMessage extends SessionMessageBase {
-  /** Message 类型固定为 action。 */
-  type: "action";
-  /** Action 业务类型。 */
-  action_type: string;
-  /** Action 当前状态。 */
-  status: "running" | "completed" | "failed";
-  /** Action 展示标题。 */
-  title: string;
-  /** Action 展示描述。 */
-  description?: string;
-  /** Action 附加结构化信息。 */
-  data?: JsonObject;
-}
-
-/** Error 顶层 Message。 */
-export interface SessionErrorMessage extends SessionMessageBase {
-  /** Message 类型固定为 error。 */
-  type: "error";
-  /** 错误影响范围。 */
-  scope: "session" | "turn";
-  /** 稳定错误码。 */
-  code: string;
-  /** 用户可见错误信息。 */
-  message: string;
-  /** 当前错误是否允许重试恢复。 */
-  recoverable: boolean;
-}
-
-/** Session 唯一顶层 Message 联合类型。 */
-export type SessionMessage =
-  | SessionUserMessage
-  | SessionAssistantMessage
-  | SessionActionMessage
-  | SessionErrorMessage;
-
-/** 读取 Session Message snapshot 的分页输入。 */
-export interface ListSessionMessagesInput {
-  /**
-   * 返回该 sequence 之前的最近一个完整历史 Segment。
-   *
-   * 必须是正整数；省略时直接返回 Active 中的全部 Message。
-   */
-  before_sequence?: number;
-  /** 是否包含 internal Message。 */
-  include_internal?: boolean;
-}
-
-/** Session Message snapshot 分页结果。 */
-export interface SessionMessagePage {
-  /** 当前 Active 或 Segment 中按 sequence 升序排列的 Message。 */
-  items: SessionMessage[];
-  /** 当前 Session 已分配的真实 Message 总数。 */
-  total: number;
-  /** 当前结果来自 Active 还是已关闭 Segment。 */
-  source: "active" | "segment";
-  /** 当前结果覆盖的第一条真实 Message sequence。 */
-  start_sequence?: number;
-  /** 当前结果覆盖的最后一条真实 Message sequence。 */
-  end_sequence?: number;
-  /** 继续向前读取时应作为 before_sequence 传入的边界。 */
-  next_before_sequence?: number;
-  /** 当前结果之前是否仍有更早 Segment。 */
-  has_more: boolean;
-}