@downcity/agent 1.1.287 → 1.1.310

package/src/types/config/ExecutionBinding.ts

@@ -1,27 +0,0 @@
-/**
- * 项目执行绑定类型定义（api 模式）。
- *
- * 关键点（中文）
- * - 项目运行入口只有一种执行模式：`api`。
- * - 绑定 City AIService 暴露的模型 ID。
- * - 该类型是 Agent 全局配置中的执行绑定结构。
- */
-
-/**
- * 项目执行绑定配置（api 模式）。
- */
-export interface ExecutionBindingConfig {
-  /**
-   * 执行模式类型，固定为 `api`。
-   */
-  type: "api";
-
-  /**
-   * City AIService 中的模型 ID。
-   *
-   * 说明（中文）
-   * - 必须能通过 City 的 `/v1/ai/models` 目录查询到。
-   * - 例如：`deepseek-v4-flash`、`fast`、`quality`。
-   */
-  modelId: string;
-}

package/src/types/config/LlmConfig.ts

@@ -1,115 +0,0 @@
-/**
- * LLM 配置类型定义。
- *
- * 设计目标（中文）
- * - 将“provider 连接信息”与“model 选择/采样参数”解耦。
- * - 支持在平台全局层配置多个 provider 与多个 model。
- * - 避免在每个 model 上重复填写 apiKey/baseUrl。
- */
-
-/**
- * Provider 类型枚举。
- *
- * 说明（中文）
- * - `open-compatible` 表示 OpenAI 兼容（Chat Completions）网关。
- * - `open-responses` 表示 OpenAI Responses 兼容网关。
- * - `moonshot-cn` 表示 Moonshot(Kimi) 中国站 OpenAI 兼容网关。
- * - `moonshot-ai` 表示 Moonshot(Kimi) 国际站 OpenAI 兼容网关。
- * - `kimi-code` 表示 Kimi Code 的 OpenAI 兼容 coding 网关。
- */
-export type LlmProviderType =
-  | "anthropic"
-  | "openai"
-  | "deepseek"
-  | "gemini"
-  | "open-compatible"
-  | "open-responses"
-  | "moonshot-cn"
-  | "moonshot-ai"
-  | "kimi-code"
-  | "xai"
-  | "huggingface"
-  | "openrouter";
-
-/**
- * 单个 provider 连接配置。
- */
-export interface LlmProviderConfig {
-  /**
-   * Provider 类型。
-   * 决定运行时使用哪个 SDK 分支和默认 baseUrl。
-   */
-  type: LlmProviderType;
-  /**
-   * Provider API 基础地址。
-   * 可选；留空时按 `type` 使用内置默认地址。
-   */
-  baseUrl?: string;
-  /**
-   * Provider API 密钥。
-   * 建议由 Console 模型池直接保存，或由宿主在运行时显式注入 env 后再回退读取。
-   */
-  apiKey?: string;
-}
-
-/**
- * 单个模型配置。
- */
-export interface LlmModelConfig {
-  /**
-   * 引用 `llm.providers` 的 key。
-   * 运行时会通过该 key 找到 provider 连接信息。
-   */
-  provider: string;
-  /**
-   * 上游模型名称。
-   * 例如：`claude-sonnet-4-5`、`gpt-4o`、`gemini-2.5-pro`。
-   */
-  name: string;
-  /**
-   * 采样温度。
-   * 值越高随机性越强。
-   */
-  temperature?: number;
-  /**
-   * 最大输出 token 数。
-   */
-  maxTokens?: number;
-  /**
-   * nucleus sampling 参数。
-   */
-  topP?: number;
-  /**
-   * 频率惩罚参数。
-   */
-  frequencyPenalty?: number;
-  /**
-   * 存在惩罚参数。
-   */
-  presencePenalty?: number;
-  /**
-   * Anthropic 专用版本字段（可选）。
-   */
-  anthropicVersion?: string;
-}
-
-/**
- * Ship 主配置中的 llm 节点结构。
- */
-export interface LlmConfig {
-  /**
-   * Provider 配置集合。
-   * key 由用户自定义（例如：`openai_main`、`google`）。
-   */
-  providers: Record<string, LlmProviderConfig>;
-  /**
-   * 模型配置集合。
-   * key 由用户自定义（例如：`fast`、`quality`、`coding`）。
-   */
-  models: Record<string, LlmModelConfig>;
-  /**
-   * 是否记录发给 LLM 的请求 payload。
-   * 默认启用；设为 false 可关闭。
-   */
-  logMessages?: boolean;
-}

package/src/types/executor/SessionRunContext.ts

@@ -1,191 +0,0 @@
-/**
- * SessionRunContext：单次 session run 的显式运行上下文。
- *
- * 关键点（中文）
- * - 这里承载本轮执行过程中需要在多个组件间透传的运行期数据。
- * - 业务侧上下文优先通过该对象显式传递，避免分散读取隐式全局状态。
- * - tool 回调通过单次 tool execution context 显式读取该对象。
- */
-
-import type {
-  AgentSessionActionCallback,
-  AgentSessionActionEvent,
-  AgentSessionActionRecord,
-} from "@/types/sdk/AgentSessionAction.js";
-import type {
-  SessionAssistantStepCallback,
-  SessionUiMessageChunkCallback,
-  SessionUiMessageStepAbortCallback,
-  SessionUiMessageStepFinishCallback,
-  SessionUiMessageStepStartCallback,
-} from "@/executor/types/SessionRun.js";
-import type { SessionUserMessageV1 } from "@/executor/types/SessionRecords.js";
-import type { FileUIPart } from "ai";
-import type { AgentPluginExecutionLease } from "@/types/plugin/PluginRuntime.js";
-import type { ShellApprovalGateway } from "@downcity/shell";
-import type { SessionToolInputReady } from "@/types/session/SessionTool.js";
-
-/**
- * 单次 session run 的运行上下文。
- */
-export interface SessionRunContext {
-  /**
-   * 当前执行所属的 turn 标识。
-   *
-   * 关键点（中文）
-   * - session 是长期对话容器，turn 是单次用户输入触发的执行轮次。
-   * - 工具运行时发布 session event 时应优先使用该字段，避免把 sessionId 误当 turnId。
-   */
-  turnId?: string;
-
-  /**
-   * 当前执行所属的 session 标识。
-   */
-  sessionId: string;
-
-  /**
-   * 当前执行所属的项目根目录。
-   *
-   * 关键点（中文）
-   * - 用于 tool/plugin 运行期把二进制资源写入项目级 `.downcity/resources`。
-   * - 未提供时，底层资源写入逻辑会回退到当前进程工作目录，兼容旧入口。
-   */
-  projectRoot?: string;
-
-  /**
-   * step 边界合并回调。
-   *
-   * 关键点（中文）
-   * - 由 Session actor 在 turn 运行期间注入。
-   * - 用于把运行中追加的 user 消息并入下一 step。
-   */
-  onStepCallback?: () => Promise<SessionUserMessageV1[]>;
-
-  /**
-   * 判断是否仍有等待并入下一 Session step 的 steer prompt。
-   *
-   * 关键点（中文）
-   * - 只检查 prompt，不把单独的 command 当成继续调用模型的理由。
-   * - 真正的队列消费统一发生在 `onStepCallback`。
-   */
-  hasPendingStepInput?: () => boolean;
-
-  /**
-   * 消费一次 canonical history 重载请求。
-   *
-   * 关键点（中文）
-   * - QueueCommand 重写持久化历史后返回 true。
-   * - CoreEngine 必须在下一次 provider 调用前重新读取 records，并且每次请求只能消费一次。
-   */
-  consume_history_reload?: () => boolean;
-
-  /**
-   * 当前 Session step 实际使用的 Agent env。
-   *
-   * 关键点（中文）
-   * - 由 Session 统一输入队列在 step 检查点更新。
-   * - tool/plugin 调用通过显式 run_context 读取，避免看到刚写入但尚未生效的 env。
-   */
-  agentEnv?: Readonly<Record<string, string>>;
-
-  /** 当前 Session step 已提交生效的 Agent instruction 文本。 */
-  agentSystems?: readonly string[];
-
-  /** 当前 Session step 持有的 Plugin 执行 lease。 */
-  agentPlugins?: AgentPluginExecutionLease;
-
-  /**
-   * assistant step 完成回调。
-   *
-   * 关键点（中文）
-   * - 用于把中间 step 文本或 reasoning 事件回传给 Session 事件流。
-   */
-  onAssistantStepCallback?: SessionAssistantStepCallback;
-
-  /**
-   * UI stream chunk 回调。
-   *
-   * 关键点（中文）
-   * - 用于把底层模型 UI chunk 旁路输出到订阅流或 transport。
-   */
-  onUiMessageChunkCallback?: SessionUiMessageChunkCallback;
-
-  /**
-   * 单个模型 UI stream 开始回调。
-   *
-   * 关键点（中文）：Session writer 用它建立独立 step 作用域，确保重复 chunk id
-   * 不会跨模型调用复用同一个 canonical Part。
-   */
-  on_ui_message_step_start?: SessionUiMessageStepStartCallback;
-
-  /**
-   * 单个模型 UI stream 完成快照回调。
-   *
-   * 关键点（中文）：最终快照只校验当前 step 的顺序并补充 metadata，不能创建、
-   * 删除或重排 canonical Part。
-   */
-  on_ui_message_step_finish?: SessionUiMessageStepFinishCallback;
-
-  /**
-   * 单个模型 UI stream 异常结束回调。
-   *
-   * 关键点（中文）：用于释放 step 作用域；已经持久化的流式 Part 继续保留。
-   */
-  on_ui_message_step_abort?: SessionUiMessageStepAbortCallback;
-
-  /** Tool 实现开始执行前提交完整输入的顺序屏障。 */
-  on_tool_input_ready?: (input: SessionToolInputReady) => Promise<void>;
-
-  /** 当前 Session 拥有的 unrestricted 审批网关。 */
-  shell_approval_gateway?: ShellApprovalGateway;
-
-  /**
-   * action 发布回调。
-   *
-   * 关键点（中文）
-   * - 用于把 compaction 等辅助动作转成 session event 与 action record。
-   * - action 不代表 assistant 正文，也不会进入 LLM 输入。
-   */
-  onActionCallback?: AgentSessionActionCallback;
-
-  /**
-   * 当前 turn 的取消信号。
-   *
-   * 关键点（中文）
-   * - `session.stop()` 会触发该 signal。
-   * - 模型流、tool-loop 与长耗时 composer 应优先监听它，尽快结束当前 turn。
-   */
-  abortSignal?: AbortSignal;
-
-  /**
-   * 本轮运行中待并入下一 step 的 user 消息。
-   *
-   * 关键点（中文）
-   * - 主要由 tool runtime 在当前 turn 内动态注入。
-   * - 这些消息只影响当前执行，不会自动持久化。
-   */
-  injectedUserMessages: SessionUserMessageV1[];
-
-  /**
-   * 本轮运行结束后待写入长期历史的 user 消息。
-   *
-   * 关键点（中文）
-   * - 为保证时间线顺序稳定，这些消息会在 assistant 结果落盘之后统一持久化。
-   */
-  deferredPersistedUserMessages: SessionUserMessageV1[];
-
-  /**
-   * 本轮运行结束前待并入最终 assistant 消息的 file parts。
-   *
-   * 关键点（中文）
-   * - 用于 tool/plugin 在执行期产生图片、文件等最终输出。
-   * - 这些 part 不依赖模型把 tool result 再复述一遍，直接落入 assistant UIMessage。
-   */
-  pendingAssistantFileParts: FileUIPart[];
-}
-
-export type {
-  AgentSessionActionCallback,
-  AgentSessionActionEvent,
-  AgentSessionActionRecord,
-};

package/src/types/platform/Store.ts

@@ -1,197 +0,0 @@
-/**
- * 平台存储类型定义。
- *
- * 关键点（中文）
- * - downcity 只保存平台级 env、channel account 与安全配置。
- * - 模型能力由 City AIService 暴露，downcity 不再声明 provider/model 存储类型。
- */
-
-/**
- * Channel Account 支持的渠道类型。
- */
-export type StoredChannelAccountChannel = "telegram" | "feishu" | "qq";
-
-/**
- * 平台环境变量记录。
- */
-export interface StoredEnvEntry {
-  /**
-   * Env 作用域。
-   *
-   * 关键点（中文）
-   * - 当前版本只保留 `global` 单一作用域。
-   * - 所有平台 Env 都视为宿主级共享变量，由宿主决定是否注入具体运行实例。
-   */
-  scope: "global";
-  /**
-   * 环境变量 key（例如 `OPENAI_API_KEY`）。
-   */
-  key: string;
-  /**
-   * 环境变量描述。
-   *
-   * 关键点（中文）
-   * - 面向用户说明该变量的用途。
-   * - 可为空，用于兼容历史只存 key/value 的数据。
-   */
-  description?: string;
-  /**
-   * 环境变量 value（解密后的明文，仅运行时内存可见）。
-   */
-  value: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * Env 写入参数。
- */
-export interface UpsertEnvEntryInput {
-  /**
-   * Env 作用域。
-   *
-   * 关键点（中文）
-   * - 当前只允许写入 `global`。
-   * - 保留该字段是为了让宿主侧调用点显式表达“这是平台全局 env 写入”。
-   */
-  scope: "global";
-  /**
-   * 环境变量 key。
-   */
-  key: string;
-  /**
-   * 环境变量描述。
-   *
-   * 关键点（中文）
-   * - 允许为空，表示暂未填写用途说明。
-   */
-  description?: string;
-  /**
-   * 环境变量值；空字符串也允许（用于显式置空）。
-   */
-  value: string;
-}
-
-/**
- * 全局环境变量记录。
- */
-export type StoredGlobalEnvEntry = StoredEnvEntry;
-
-/**
- * 全局环境变量写入参数。
- */
-export type UpsertGlobalEnvEntryInput = Omit<UpsertEnvEntryInput, "scope">;
-
-/**
- * Channel Account 记录。
- */
-export interface StoredChannelAccount {
-  /**
-   * 账户主键 ID（例如 `qq-main`）。
-   */
-  id: string;
-  /**
-   * 账户归属渠道（telegram/feishu/qq）。
-   */
-  channel: StoredChannelAccountChannel;
-  /**
-   * UI 展示名（例如“主 QQ 机器人”）。
-   */
-  name: string;
-  /**
-   * 身份展示文案（例如 `@my_bot`、`app:123`），可选。
-   */
-  identity?: string;
-  /**
-   * 机器人所有者信息（可选，平台可获取时自动同步）。
-   */
-  owner?: string;
-  /**
-   * 机器人创建者信息（可选，平台可获取时自动同步）。
-   */
-  creator?: string;
-  /**
-   * Telegram Token（解密后，可选）。
-   */
-  botToken?: string;
-  /**
-   * AppId（解密后，可选）。
-   */
-  appId?: string;
-  /**
-   * AppSecret（解密后，可选）。
-   */
-  appSecret?: string;
-  /**
-   * 渠道域名（主要用于 Feishu/Lark），可选。
-   */
-  domain?: string;
-  /**
-   * QQ 沙箱模式开关，可选。
-   */
-  sandbox?: boolean;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * Channel Account 写入参数。
- */
-export interface UpsertChannelAccountInput {
-  /**
-   * 账户主键 ID。
-   */
-  id: string;
-  /**
-   * 账户归属渠道。
-   */
-  channel: StoredChannelAccountChannel;
-  /**
-   * 账户展示名。
-   */
-  name: string;
-  /**
-   * 身份展示文案，可选。
-   */
-  identity?: string;
-  /**
-   * 机器人所有者信息（可选）。
-   */
-  owner?: string;
-  /**
-   * 机器人创建者信息（可选）。
-   */
-  creator?: string;
-  /**
-   * Telegram Token，可选。
-   */
-  botToken?: string;
-  /**
-   * AppId，可选。
-   */
-  appId?: string;
-  /**
-   * AppSecret，可选。
-   */
-  appSecret?: string;
-  /**
-   * 渠道域名，可选。
-   */
-  domain?: string;
-  /**
-   * QQ 沙箱模式，可选。
-   */
-  sandbox?: boolean;
-}

package/src/types/plugin/PluginConfig.ts

@@ -1,13 +0,0 @@
-/**
- * Plugin 配置协议类型。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-
-/**
- * 允许 optional 字段的结构化 Plugin 配置对象。
- */
-export type StructuredConfig = {
-  /** 当前配置字段；省略或 `undefined` 表示未配置。 */
-  [key: string]: JsonValue | undefined;
-};

package/src/types/plugin/PluginControl.ts

@@ -1,80 +0,0 @@
-/**
- * Plugin 控制面协议类型。
- *
- * 关键点（中文）
- * - CLI、HTTP 与 RPC 共用同一套 plugin 控制请求和响应结构。
- * - 状态数据统一复用 `PluginSnapshot`，不再复制字段或保留旧别名。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-import type { PluginControlAction, PluginSnapshot } from "@/types/plugin/PluginState.js";
-
-export type { PluginControlAction } from "@/types/plugin/PluginState.js";
-
-/**
- * plugin 状态列表响应。
- */
-export type PluginStateListResponse = {
-  /** 请求是否成功。 */
-  success: boolean;
-  /** 当前已注册 plugin 快照。 */
-  plugins?: PluginSnapshot[];
-  /** 失败原因。 */
-  error?: string;
-};
-
-/**
- * 单个 plugin 控制响应。
- */
-export type PluginControlResponse = {
-  /** 请求是否成功。 */
-  success: boolean;
-  /** 当前 plugin 快照。 */
-  plugin?: PluginSnapshot;
-  /** 失败原因。 */
-  error?: string;
-};
-
-/**
- * plugin command/action 执行响应。
- */
-export type PluginCommandResponse = {
-  /** 调用是否成功。 */
-  success: boolean;
-  /** 当前 plugin 快照。 */
-  plugin?: PluginSnapshot;
-  /** 人类可读结果。 */
-  message?: string;
-  /** 结构化结果。 */
-  data?: JsonValue;
-  /** 失败原因。 */
-  error?: string;
-};
-
-/**
- * plugin CLI 通用选项。
- */
-export type PluginCliBaseOptions = {
-  /** agent 项目路径。 */
-  path?: string;
-  /** 目标 agent 标识。 */
-  agent?: string;
-  /** HTTP 主机。 */
-  host?: string;
-  /** HTTP 端口。 */
-  port?: number;
-  /** 控制面认证令牌。 */
-  token?: string;
-  /** 是否输出 JSON。 */
-  json?: boolean;
-};
-
-/**
- * plugin 控制请求。
- */
-export type PluginControlRequest = {
-  /** 目标 plugin 名称。 */
-  plugin_name: string;
-  /** 控制动作。 */
-  action: PluginControlAction;
-};

package/src/types/plugin/PluginRunContext.ts

@@ -1,31 +0,0 @@
-/**
- * Plugin 单次调用的运行上下文。
- *
- * 关键点（中文）
- * - 只暴露 plugin 业务需要的只读 Session 快照。
- * - 不暴露 Executor 内部队列、callback 或 plugin lease。
- * - CLI、HTTP 与 scheduler 等非 Session 调用可能不提供该对象。
- */
-
-/**
- * Plugin action 与 system provider 可读取的 Session 运行快照。
- */
-export interface PluginRunContext {
-  /** 当前调用所属的 Session 标识。 */
-  readonly sessionId: string;
-
-  /** 当前调用所属的 turn 标识。 */
-  readonly turnId?: string;
-
-  /** 当前 Agent 绑定的项目根目录。 */
-  readonly projectRoot?: string;
-
-  /** 当前 Session step 已提交生效的 Agent env 快照。 */
-  readonly agentEnv?: Readonly<Record<string, string>>;
-
-  /** 当前 Session step 已提交生效的 instruction 快照。 */
-  readonly agentSystems?: readonly string[];
-
-  /** 当前 turn 的取消信号。 */
-  readonly abortSignal?: AbortSignal;
-}