@downcity/agent 1.1.408 → 1.1.437

package/src/types/rpc/RpcProtocol.ts

@@ -1,464 +0,0 @@
-/**
- * Agent RPC 协议类型。
- *
- * 关键点（中文）
- * - 该文件只描述本机 RPC 的线协议，不包含 socket 或业务执行逻辑。
- * - Client 与 Server 共享同一份 request/frame 类型，避免协议两边漂移。
- * - 字段名保持现有协议格式，兼容已发布的 downcity 托管 runtime 调用。
- */
-
-import type {
-  AgentCreateSessionInput,
-  AgentListSessionsInput,
-  AgentArchiveSessionInput,
-  AgentArchiveSessionsInput,
-  AgentArchiveSessionResult,
-  AgentArchiveSessionsResult,
-  AgentCleanArchiveResult,
-  AgentSessionSetOptions,
-  RemoteSessionSetInput,
-  AgentSessionSystemSnapshot,
-} from "@/types/agent/SessionTypes.js";
-import type { SessionMutation } from "@/types/session/SessionMutation.js";
-import type { RespondSessionInteractionInput } from "@/types/session/SessionInteraction.js";
-import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
-import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
-import type { ListSessionMessagesInput } from "@/types/session/SessionMessage.js";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-
-/**
- * RPC 请求。
- *
- * 关键点（中文）
- * - `sdk.*` 面向 RemoteAgent 的稳定会话 SDK。
- * - `internal.*` 面向 downcity 本机管理通道。
- */
-type RpcRequestPayload =
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 列出 sessions。 */
-      method: "sdk.sessions.list";
-      /** 列表过滤与分页参数。 */
-      params?: AgentListSessionsInput;
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 创建 session。 */
-      method: "sdk.sessions.create";
-      /** 创建参数。 */
-      params?: AgentCreateSessionInput;
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 获取 session。 */
-      method: "sdk.sessions.get";
-      /** 目标 session 参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 归档 session。 */
-      method: "sdk.sessions.archive";
-      /** 归档参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 列出已归档 sessions。 */
-      method: "sdk.sessions.archived.list";
-      /** 列表过滤与分页参数。 */
-      params?: AgentArchiveSessionsInput;
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 清空已归档 sessions。 */
-      method: "sdk.sessions.archived.clean";
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 向 session 发送 prompt。 */
-      method: "sdk.sessions.prompt";
-      /** prompt 参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-        /** SDK prompt 输入。 */
-        input: AgentSessionPromptInput;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 停止当前 session turn。 */
-      method: "sdk.sessions.stop";
-      /** 停止参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 把显式历史压缩加入 Session 的有序输入队列。 */
-      method: "sdk.sessions.compact";
-      /** 目标 Session 参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 读取 session messages。 */
-      method: "sdk.sessions.messages";
-      /** messages 查询参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-        /** messages 分页参数。 */
-        input?: ListSessionMessagesInput;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 列出指定 Session 正在等待用户响应的 Interaction。 */
-      method: "sdk.sessions.interactions";
-      /** 目标 Session 参数。 */
-      params: { session_id: string };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 读取指定 Session 的运行与安全状态。 */
-      method: "sdk.sessions.status";
-      /** 目标 Session 参数。 */
-      params: { session_id: string };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 更新指定 Session 的可序列化动态配置。 */
-      method: "sdk.sessions.set";
-      /** Session 与动态配置参数。 */
-      params: {
-        session_id: string;
-        input: RemoteSessionSetInput;
-        options?: AgentSessionSetOptions;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 提交指定 Session 的 Interaction 用户响应。 */
-      method: "sdk.sessions.respond";
-      /** Session 与 Interaction 响应参数。 */
-      params: { session_id: string; input: RespondSessionInteractionInput };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 读取 session system snapshot。 */
-      method: "sdk.sessions.system";
-      /** 目标 session 参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 分叉 session。 */
-      method: "sdk.sessions.fork";
-      /** 分叉参数。 */
-      params: {
-        /** 源 session id。 */
-        session_id: string;
-        /** 可选源消息 id。 */
-        message_id?: string;
-        /** 是否包含源消息；默认包含。 */
-        include_message?: boolean;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 订阅 session 事件。 */
-      method: "sdk.sessions.subscribe";
-      /** 订阅参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 取消 session 事件订阅。 */
-      method: "sdk.sessions.unsubscribe";
-      /** 取消订阅参数。 */
-      params: {
-        /** 当前订阅 id。 */
-        subscription_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 读取 Agent 内部状态。 */
-      method: "internal.status.get";
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 让宿主从事实源重新加载 Workspace Env。 */
-      method: "internal.workspace.reload_env";
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 清空 session messages。 */
-      method: "internal.sessions.clear_messages";
-      /** 目标 session 参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 清空 chat history。 */
-      method: "internal.sessions.clear_chat_history";
-      /** 目标 session 参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 解析 session system prompt。 */
-      method: "internal.sessions.resolve_system_prompt";
-      /** 目标 session 参数。 */
-      params: {
-        /** 目标 session id。 */
-        session_id: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 列出 plugin catalog。 */
-      method: "internal.plugins.catalog";
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 列出 plugin 状态。 */
-      method: "internal.plugins.list";
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 检查 plugin 可用性。 */
-      method: "internal.plugins.availability";
-      /** plugin 参数。 */
-      params: {
-        /** plugin 名称。 */
-        plugin_name: string;
-      };
-    }
-  | {
-      /** 请求 id，用于匹配响应。 */
-      id: string;
-      /** 执行 plugin action。 */
-      method: "internal.plugins.action";
-      /** plugin action 参数。 */
-      params: {
-        /** plugin 名称。 */
-        plugin_name: string;
-        /** action 名称。 */
-        action_name: string;
-        /** action payload。 */
-        payload?: JsonValue;
-      };
-    };
-
-/**
- * RPC 请求。
- *
- * `agent_id` 与 `workspace_id` 由 `RemoteAgent(rpc://host:port/<agent_id>/<workspace_id>)`
- * 自动附加，供 City 级
- * RPC Server 在同一端口内选择 Agent。独立 `AgentRPC` 不要求该字段。
- */
-export type RpcRequest = RpcRequestPayload & {
-  /** 目标 Agent 的稳定 ID；CityRPC 请求必须提供。 */
-  agent_id?: string;
-  /** 目标 Workspace 的稳定 ID；CityRPC 请求必须提供。 */
-  workspace_id?: string;
-};
-
-/**
- * RPC 成功响应帧。
- */
-export interface RpcSuccessFrame {
-  /** 请求 id。 */
-  id: string;
-  /** 成功标记。 */
-  success: true;
-  /** 响应数据。 */
-  data?: unknown;
-}
-
-/**
- * RPC 失败响应帧。
- */
-export interface RpcErrorFrame {
-  /** 请求 id。 */
-  id: string;
-  /** 失败标记。 */
-  success: false;
-  /** 错误信息。 */
-  error: string;
-}
-
-/**
- * RPC 普通响应帧。
- */
-export type RpcResponseFrame = RpcSuccessFrame | RpcErrorFrame;
-
-/**
- * RPC 订阅 ready 帧。
- */
-export interface RpcReadyFrame {
-  /** 帧类型。 */
-  type: "ready";
-  /** 当前订阅 id。 */
-  subscription_id: string;
-}
-
-/**
- * RPC 事件帧。
- */
-export interface RpcEventFrame {
-  /** 帧类型。 */
-  type: "event";
-  /** 当前订阅 id。 */
-  subscription_id: string;
-  /** session 事件。 */
-  event: SessionMutation;
-}
-
-/**
- * RPC server 可写帧。
- */
-export type RpcServerFrame = RpcSuccessFrame | RpcErrorFrame | RpcEventFrame;
-
-/**
- * RPC client 可读帧。
- */
-export type RpcClientFrame = RpcResponseFrame | RpcReadyFrame | RpcEventFrame;
-
-/**
- * RPC endpoint。
- */
-export interface RpcClientEndpoint {
-  /** RPC host。 */
-  host: string;
-  /** RPC port。 */
-  port: number;
-  /** City RPC 中的目标 Agent ID；独立 AgentRPC 可省略。 */
-  agent_id?: string;
-  /** City RPC 中的目标 Workspace ID；独立 AgentRPC 可省略。 */
-  workspace_id?: string;
-}
-
-/** Agent 本机 internal.status.get 返回的进程身份。 */
-export interface RpcInternalStatus {
-  /** RPC 服务健康状态。 */
-  status: string;
-  /** RPC 服务所属进程的操作系统 pid。 */
-  pid: number;
-  /** 当前 Agent 的稳定全局 ID。 */
-  agent_id: string;
-  /** 当前执行使用的 Workspace 稳定 ID。 */
-  workspace_id: string;
-  /** 当前请求执行所在的 Workspace 绝对路径。 */
-  workspace_path: string;
-  /** daemon 启动实例 ID；非 daemon 前台进程返回空字符串。 */
-  instance_id: string;
-}
-
-/**
- * RPC Session 订阅句柄。
- */
-export interface RpcSessionSubscription {
-  /** 当前订阅 id。 */
-  subscription_id: string;
-  /** 取消订阅。 */
-  unsubscribe(): Promise<void>;
-}
-
-/**
- * RPC system prompt 分段条目。
- */
-export interface RpcSystemPromptSectionItem {
-  /** 消息序号。 */
-  index: number;
-  /** system message 文本内容。 */
-  content: string;
-}
-
-/**
- * RPC system prompt 分段。
- */
-export interface RpcSystemPromptSection {
-  /** 分段稳定 key。 */
-  key: string;
-  /** 分段展示标题。 */
-  title: string;
-  /** 分段内消息条目。 */
-  items: RpcSystemPromptSectionItem[];
-}
-
-/**
- * RPC system prompt 响应。
- */
-export interface RpcSystemPromptPayload {
-  /** 请求是否成功。 */
-  success?: boolean;
-  /** 当前 session id。 */
-  session_id: string;
-  /** system message 总数。 */
-  total_messages: number;
-  /** system message 总字符数。 */
-  total_chars: number;
-  /** system message 分段。 */
-  sections: RpcSystemPromptSection[];
-}
-
-/**
- * RPC session system snapshot 响应。
- */
-export interface RpcSessionSystemResult {
-  /** system snapshot。 */
-  system: AgentSessionSystemSnapshot;
-}

package/src/types/sdk/AgentSessionCompact.ts

@@ -1,36 +0,0 @@
-/**
- * Session 显式压缩句柄与结果类型。
- *
- * `session.compact()` 返回句柄表示请求已进入有序队列；压缩真正结束后由
- * `finished` 兑现最终结果，调用方不需要从 Action Message 反推完成状态。
- */
-
-/** Session 显式压缩的稳定结束原因。 */
-export type AgentSessionCompactReason =
-  | "compacted"
-  | "nothing_to_compact"
-  | "compact_failed";
-
-/** 一次显式 Session 压缩的最终结果。 */
-export interface AgentSessionCompactResult {
-  /** 当前压缩请求的稳定标识。 */
-  compact_id: string;
-  /** 压缩请求是否成功完成；没有可压缩内容同样视为成功。 */
-  success: boolean;
-  /** 是否实际生成并提交了压缩计划。 */
-  compacted: boolean;
-  /** 当前请求结束的稳定原因。 */
-  reason: AgentSessionCompactReason;
-  /** 压缩失败时的错误文本。 */
-  error?: string;
-}
-
-/** 一次显式 Session 压缩的等待句柄。 */
-export interface AgentSessionCompactHandle {
-  /** 当前句柄绑定的压缩请求标识。 */
-  id: string;
-  /** 已完成后的最终结果；`finished` 兑现前为 null。 */
-  result: AgentSessionCompactResult | null;
-  /** 等待压缩 Command 真正完成的 Promise。 */
-  finished: Promise<AgentSessionCompactResult>;
-}

package/src/types/session/SessionAction.ts

@@ -1,41 +0,0 @@
-/**
- * Session Action 运行事件协议。
- *
- * Action 事件描述尚未持久化或正在更新的领域事实；`SessionMessages` 负责把它收口为
- * canonical `SessionActionMessage`。该协议不属于模型消息。
- */
-
-/** Session Action 生命周期状态。 */
-export type SessionActionStatus = "running" | "completed" | "failed";
-
-/** Session Action 运行事件。 */
-export interface SessionActionEvent {
-  /** 同一 Action 生命周期内稳定复用的标识。 */
-  action_id: string;
-  /** Action 的业务类别。 */
-  action_type: string;
-  /** Action 所属 Turn；独立 Session 操作允许省略。 */
-  turn_id?: string;
-  /** Action 的用户可读标题。 */
-  title: string;
-  /** Action 的可选用户可读说明。 */
-  description?: string;
-  /** Action 当前生命周期状态。 */
-  status: SessionActionStatus;
-}
-
-/** 创建 Session Action 事件的输入。 */
-export interface SessionActionEventInput {
-  /** 可选稳定标识；省略时由 Session 分配。 */
-  action_id?: string;
-  /** Action 的业务类别。 */
-  action_type: string;
-  /** Action 所属 Turn；独立 Session 操作允许省略。 */
-  turn_id?: string;
-  /** Action 的用户可读标题。 */
-  title: string;
-  /** Action 的可选用户可读说明。 */
-  description?: string;
-  /** Action 当前生命周期状态。 */
-  status: SessionActionStatus;
-}

package/src/types/session/SessionContent.ts

@@ -1,52 +0,0 @@
-/**
- * Session 入站与 Action 内容类型。
- *
- * 这些类型只描述尚未分配 Session identity 的内容。进入 Session 后，
- * `SessionMessages` 会为每个 part 分配稳定标识并转换成 canonical `SessionMessage`。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-
-/** Session 输入中的文本内容。 */
-export interface SessionTextInputPart {
-  /** 内容判别字段。 */
-  type: "text";
-  /** 用户或 Action 产生的完整文本。 */
-  text: string;
-}
-
-/** Session 输入中的文件内容。 */
-export interface SessionFileInputPart {
-  /** 内容判别字段。 */
-  type: "file";
-  /** 文件的 IANA MIME 类型。 */
-  media_type: string;
-  /** 文件的远程 URL、本地路径或 Data URL。 */
-  url: string;
-  /** 可选原始文件名。 */
-  filename?: string;
-}
-
-/** Session 输入中的结构化数据内容。 */
-export interface SessionDataInputPart {
-  /** 内容判别字段。 */
-  type: "data";
-  /** 结构化数据的业务类型。 */
-  data_type: string;
-  /** 可跨进程传输的结构化值。 */
-  data: JsonValue;
-  /** 可选稳定数据标识。 */
-  data_id?: string;
-}
-
-/** `session.prompt()` 接受的封闭内容集合。 */
-export type SessionPromptPart =
-  | SessionTextInputPart
-  | SessionFileInputPart
-  | SessionDataInputPart;
-
-/** Action 可以追加到 Assistant Message 的封闭内容集合。 */
-export type SessionAssistantResultPart =
-  | SessionTextInputPart
-  | SessionFileInputPart
-  | SessionDataInputPart;