@downcity/agent 1.1.35 → 1.1.43

package/bin/types/common/EnvFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvFile.js","sourceRoot":"","sources":["../../../src/types/common/EnvFile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/types/common/ResolvedConfigValue.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 配置值递归结构类型。
+ *
+ * 职责说明（中文）
+ * - 描述 `downcity.json` 在“读取原始 JSON -> 解析环境变量占位符”阶段可接受的值结构。
+ * - 允许对象、数组、JSON 标量与 `undefined` 递归嵌套，供配置解析工具复用。
+ * - 该类型只服务配置装配阶段，不承诺运行时最终配置的严格业务语义。
+ */
+export type ResolvedConfigValue = string | number | boolean | null | undefined | {
+    [key: string]: ResolvedConfigValue;
+} | ResolvedConfigValue[];
+//# sourceMappingURL=ResolvedConfigValue.d.ts.map

package/bin/types/common/ResolvedConfigValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolvedConfigValue.d.ts","sourceRoot":"","sources":["../../../src/types/common/ResolvedConfigValue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAE,GACtC,mBAAmB,EAAE,CAAC"}

package/bin/types/common/ResolvedConfigValue.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ResolvedConfigValue.js.map

package/bin/types/common/ResolvedConfigValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolvedConfigValue.js","sourceRoot":"","sources":["../../../src/types/common/ResolvedConfigValue.ts"],"names":[],"mappings":""}

package/bin/types/config/AgentProject.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Agent 项目初始化相关类型定义。
+ *
+ * 关键点（中文）
+ * - 统一承载 CLI 与 control plane 共用的初始化输入/输出结构。
+ * - 所有字段都面向"项目骨架创建"语义，不掺杂 runtime 状态。
+ */
+import type { ExecutionBindingConfig } from "../../types/config/ExecutionBinding.js";
+import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
+/**
+ * 可选的 chat channel 标识。
+ */
+export type AgentProjectChannel = "telegram" | "feishu" | "qq";
+/**
+ * 初始化 agent 项目的输入参数。
+ */
+export interface AgentProjectInitializationInput {
+    /**
+     * agent 项目根目录（绝对路径或可解析相对路径）。
+     */
+    projectRoot: string;
+    /**
+     * agent 展示名。
+     *
+     * 关键点（中文）
+     * - 为空时会自动回退到目录名推导出的默认名称。
+     */
+    agentName?: string;
+    /**
+     * 项目执行绑定配置。
+     *
+     * 说明（中文）
+     * - 绑定平台全局模型池中的模型 ID。
+     */
+    execution: ExecutionBindingConfig;
+    /**
+     * 需要一并写入项目的 plugin 配置补丁。
+     *
+     * 说明（中文）
+     * - 这里只承载初始化时的最小配置，不负责 city 级 plugin lifecycle。
+     */
+    plugins?: DowncityConfig["plugins"];
+    /**
+     * 需要启用的 chat channels。
+     *
+     * 关键点（中文）
+     * - 仅写入用户选择的渠道，未选择的渠道不会写入 `downcity.json`。
+     */
+    channels?: AgentProjectChannel[];
+    /**
+     * 是否允许覆盖已存在的 `downcity.json`。
+     */
+    forceOverwriteShipJson?: boolean;
+}
+/**
+ * 初始化完成后的摘要结果。
+ */
+export interface AgentProjectInitializationResult {
+    /**
+     * 已解析后的 agent 项目根目录（绝对路径）。
+     */
+    projectRoot: string;
+    /**
+     * 最终写入的 agent 名称。
+     */
+    agentName: string;
+    /**
+     * 最终启用的 chat channels。
+     */
+    channels: AgentProjectChannel[];
+    /**
+     * 本次实际创建/写入的文件列表。
+     */
+    createdFiles: string[];
+    /**
+     * 因已存在而跳过的文件列表。
+     */
+    skippedFiles: string[];
+}
+//# sourceMappingURL=AgentProject.d.ts.map

package/bin/types/config/AgentProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentProject.d.ts","sourceRoot":"","sources":["../../../src/types/config/AgentProject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,EAAE,sBAAsB,CAAC;IAElC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAEpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEjC;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAEhC;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/bin/types/config/AgentProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentProject.js","sourceRoot":"","sources":["../../../src/types/config/AgentProject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/types/runtime/agent/AgentContext.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Agent 执行上下文类型定义。
+ *
+ * 职责说明（中文）
+ * - 这里定义 plugin runtime、plugin、prompt system 共用的统一执行上下文。
+ * - `AgentContext` 表达的是“当前一次执行可见的能力面”，不是宿主状态本体。
+ *
+ * 边界说明（中文）
+ * - `AgentRuntime` 负责保存长期状态；`AgentContext` 负责把这些状态暴露成执行接口。
+ * - 这里只定义协议，不负责任何上下文装配逻辑。
+ */
+import type { LanguageModel } from "ai";
+import type { Logger } from "../../../utils/logger/Logger.js";
+import type { AgentRuntime } from "../../../types/runtime/agent/AgentRuntime.js";
+import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/runtime/host/AgentHost.js";
+import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
+import type { JsonValue } from "../../../types/common/Json.js";
+import type { PluginPort } from "../../../plugin/types/Plugin.js";
+import type { SessionMetadataV1, SessionMessageV1 } from "../../../executor/types/SessionMessages.js";
+import type { SessionRunInput, SessionRunResult } from "../../../executor/types/SessionRun.js";
+import type { SessionHistoryStore } from "../../../executor/store/history/SessionHistoryStore.js";
+import type { AgentSessionPromptInput } from "../../../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../../../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionTurnHandle } from "../../../types/sdk/AgentSessionTurn.js";
+/**
+ * 跨 plugin runtime 调用参数。
+ */
+export interface InvokePluginParams {
+    /**
+     * 目标 plugin 名称。
+     */
+    plugin: string;
+    /**
+     * 目标 action 名称。
+     */
+    action: string;
+    /**
+     * 调用时附带的结构化 payload。
+     */
+    payload?: JsonValue;
+}
+/**
+ * 跨 plugin runtime 调用结果。
+ */
+export interface InvokePluginResult {
+    /**
+     * 调用是否成功。
+     */
+    success: boolean;
+    /**
+     * 成功时返回的数据载荷。
+     */
+    data?: JsonValue;
+    /**
+     * 失败时的错误信息。
+     */
+    error?: string;
+}
+/**
+ * 跨 plugin runtime 调用端口。
+ */
+export interface InvokePluginPort {
+    /**
+     * 调用指定 plugin action。
+     */
+    invoke(params: InvokePluginParams): Promise<InvokePluginResult>;
+}
+/**
+ * 单个 Session 执行端口。
+ */
+export interface SessionExecutorPort {
+    /**
+     * 执行一次 session run。
+     */
+    run(params: SessionRunInput): Promise<SessionRunResult>;
+}
+/**
+ * 单个 Session 实例端口。
+ */
+export interface SessionPort {
+    /**
+     * 当前 session 标识。
+     */
+    readonly sessionId: string;
+    /**
+     * 获取当前 session 的执行端口。
+     */
+    getExecutor(): SessionExecutorPort;
+    /**
+     * 获取当前 session 的持久化端口。
+     */
+    getHistoryStore(): SessionHistoryStore;
+    /**
+     * 向当前 session actor 追加一条新的 prompt。
+     *
+     * 关键点（中文）
+     * - 这是面向 SDK / transport 的统一交互输入入口。
+     * - 返回值只有在当前输入被绑定到某个 turn 后才会兑现。
+     */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /**
+     * 订阅当前 session 后续产生的 future 事件。
+     *
+     * 关键点（中文）
+     * - 只广播订阅之后产生的事件。
+     * - 历史消息仍通过 `getHistoryStore()` / SDK `history()` 读取。
+     */
+    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
+    /**
+     * 清理当前 session 的 executor 缓存。
+     */
+    clearExecutor(): void;
+    /**
+     * 当前 session 更新后的异步通知钩子。
+     */
+    afterSessionUpdatedAsync(): Promise<void>;
+    /**
+     * 追加一条 user 消息。
+     */
+    appendUserMessage(params: {
+        /**
+         * 已构造好的完整消息。
+         */
+        message?: SessionMessageV1 | null;
+        /**
+         * 兜底文本内容。
+         */
+        text?: string;
+        /**
+         * 附加元数据。
+         */
+        extra?: SessionMetadataV1["extra"];
+    }): Promise<void>;
+    /**
+     * 追加一条 assistant 消息。
+     */
+    appendAssistantMessage(params: {
+        /**
+         * 已构造好的完整消息。
+         */
+        message?: SessionMessageV1 | null;
+        /**
+         * 兜底文本内容。
+         */
+        fallbackText?: string;
+        /**
+         * 附加元数据。
+         */
+        extra?: SessionMetadataV1["extra"];
+    }): Promise<void>;
+    /**
+     * 返回当前 session 是否正在执行。
+     */
+    isExecuting(): boolean;
+}
+/**
+ * Session 集合入口。
+ */
+export interface SessionCollectionPort {
+    /**
+     * 获取指定 sessionId 对应的 Session 实例。
+     */
+    get(sessionId: string): SessionPort;
+    /**
+     * 返回当前所有执行中的 sessionId。
+     */
+    listExecutingSessionIds(): string[];
+    /**
+     * 返回当前执行中的 session 数量。
+     */
+    getExecutingSessionCount(): number;
+    /**
+     * 解析指定 session 当前绑定的模型实例。
+     *
+     * 关键点（中文）
+     * - 模型归属于 session，而不是 agent 全局运行时。
+     * - 这里会触发 session 初始化/宿主配置，适合 task 等后台链路按 session 读取模型。
+     */
+    resolveModel(sessionId: string): Promise<LanguageModel | undefined>;
+}
+/**
+ * 统一执行上下文。
+ */
+export interface AgentContext {
+    /**
+     * 当前执行上下文对应的 agent 状态。
+     */
+    agent: AgentRuntime;
+    /**
+     * 当前命令工作目录。
+     */
+    cwd: string;
+    /**
+     * 当前项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 统一日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前运行时已解析配置。
+     */
+    config: DowncityConfig;
+    /**
+     * 当前项目环境变量快照。
+     */
+    env: Record<string, string>;
+    /**
+     * 当前生效的 system 文本集合。
+     */
+    systems: string[];
+    /**
+     * 当前可见的路径能力集合。
+     */
+    paths: AgentPathRuntime;
+    /**
+     * 当前可见的 plugin 配置持久化能力集合。
+     */
+    pluginConfig: AgentPluginConfigRuntime;
+    /**
+     * Session 能力入口。
+     *
+     * 关键点（中文）
+     * - plugin runtime 与 plugin 都通过这里访问 session 执行与持久化能力。
+     * - 内外统一使用 `sessionId` 语义。
+     */
+    session: SessionCollectionPort;
+    /**
+     * 跨 plugin runtime 调用主入口。
+     */
+    invoke: InvokePluginPort;
+    /**
+     * Plugin 调用入口。
+     */
+    plugins: PluginPort;
+}
+/**
+ * 允许 optional 字段的结构化配置对象。
+ */
+export type StructuredConfig = {
+    [key: string]: JsonValue | undefined;
+};
+//# sourceMappingURL=AgentContext.d.ts.map

package/bin/types/runtime/agent/AgentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentContext.ts"],"names":[],"mappings":"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"}

package/bin/types/runtime/agent/AgentContext.js

@@ -0,0 +1,13 @@
+/**
+ * Agent 执行上下文类型定义。
+ *
+ * 职责说明（中文）
+ * - 这里定义 plugin runtime、plugin、prompt system 共用的统一执行上下文。
+ * - `AgentContext` 表达的是“当前一次执行可见的能力面”，不是宿主状态本体。
+ *
+ * 边界说明（中文）
+ * - `AgentRuntime` 负责保存长期状态；`AgentContext` 负责把这些状态暴露成执行接口。
+ * - 这里只定义协议，不负责任何上下文装配逻辑。
+ */
+export {};
+//# sourceMappingURL=AgentContext.js.map

package/bin/types/runtime/agent/AgentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContext.js","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/bin/types/runtime/agent/AgentRuntime.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Agent 实例运行时类型定义。
+ *
+ * 职责说明（中文）
+ * - 这里定义单个 `Agent` 实例持有的长期运行状态视图。
+ * - Session、plugin、server 等长期对象都通过这组类型共享统一状态结构。
+ *
+ * 边界说明（中文）
+ * - 这些类型描述的是“实例级长期状态”，不是某一次执行的上下文视图。
+ * - 运行时实现细节仍分散在各模块中，这里只保留稳定的共享结构定义。
+ */
+import type { Logger } from "../../../utils/logger/Logger.js";
+import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
+import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/runtime/host/AgentHost.js";
+import type { BasePlugin } from "../../../plugin/core/BasePlugin.js";
+import type { SessionPort } from "../../../types/runtime/agent/AgentContext.js";
+/**
+ * Agent 实例启动早期的基础状态。
+ */
+export interface AgentRuntimeBase {
+    /**
+     * 当前命令工作目录。
+     */
+    cwd: string;
+    /**
+     * 当前 agent 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 当前统一日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前解析后的项目配置。
+     */
+    config: DowncityConfig;
+    /**
+     * 当前 agent 局部环境变量快照。
+     */
+    env: Record<string, string>;
+    /**
+     * 当前生效的静态 system 文本集合。
+     */
+    systems: string[];
+    /**
+     * 当前 agent 可见的路径能力集合。
+     */
+    paths: AgentPathRuntime;
+    /**
+     * 当前 agent 可见的 plugin 配置持久化能力集合。
+     */
+    pluginConfig: AgentPluginConfigRuntime;
+}
+/**
+ * Agent 实例完整运行状态。
+ */
+export interface AgentRuntime extends AgentRuntimeBase {
+    /**
+     * 读取指定 sessionId 对应的 session 端口。
+     *
+     * 关键点（中文）
+     * - 返回值是统一的 `SessionPort`，而不是裸 `Executor`。
+     * - 这样 HTTP / plugin runtime / chat queue / contact 等入口都能复用同一层会话装配与执行兜底。
+     */
+    getSession(sessionId: string): SessionPort;
+    /**
+     * 返回当前执行中的 sessionId 列表。
+     */
+    listExecutingSessionIds(): string[];
+    /**
+     * 返回当前执行中的 session 数量。
+     */
+    getExecutingSessionCount(): number;
+    /**
+     * 当前 agent 持有的插件实例集合。
+     */
+    pluginInstances: Map<string, BasePlugin>;
+}
+//# sourceMappingURL=AgentRuntime.d.ts.map

package/bin/types/runtime/agent/AgentRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB;;OAEG;IACH,YAAY,EAAE,wBAAwB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3C;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE,CAAC;IACpC;;OAEG;IACH,wBAAwB,IAAI,MAAM,CAAC;IACnC;;OAEG;IACH,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C"}

package/bin/types/runtime/agent/AgentRuntime.js

@@ -0,0 +1,13 @@
+/**
+ * Agent 实例运行时类型定义。
+ *
+ * 职责说明（中文）
+ * - 这里定义单个 `Agent` 实例持有的长期运行状态视图。
+ * - Session、plugin、server 等长期对象都通过这组类型共享统一状态结构。
+ *
+ * 边界说明（中文）
+ * - 这些类型描述的是“实例级长期状态”，不是某一次执行的上下文视图。
+ * - 运行时实现细节仍分散在各模块中，这里只保留稳定的共享结构定义。
+ */
+export {};
+//# sourceMappingURL=AgentRuntime.js.map

package/bin/types/runtime/agent/AgentRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.js","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/bin/types/runtime/host/AgentHost.d.ts

@@ -4,15 +4,9 @@
  * 关键点（中文）
  * - 这里统一描述由 agent runtime 装配、再挂入 AgentRuntime 的宿主能力。
  * - plugin runtime / session / plugin 作者 API 只能消费这些稳定能力，不应直接依赖具体宿主实现。
- * - 当前先收敛路径、认证、plugin 配置持久化三类高频能力。
+ * - 当前先收敛路径与 plugin 配置持久化两类高频能力。
  */
 import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
-import type { ChatAuthorizationChannel, ChatAuthorizationConfig } from "../../../plugin/builtins/auth/types/AuthPlugin.js";
-import type { ChatChannelAccountCreateInput, ChatChannelAccountListItem, ChatChannelAccountProbeResult, ChatChannelAccountUpsertInput } from "../../../plugin/builtins/chat/types/ChannelAccount.js";
-import type { StoredChannelAccount, StoredModel, StoredModelProvider } from "../../../types/runtime/host/Store.js";
-import type { ChatChannelName } from "../../../plugin/builtins/chat/types/ChannelStatus.js";
-import type { AgentProjectInitializationInput } from "../../../config/project/types/AgentProject.js";
-import type { PlatformModelChoice } from "../../../config/project/AgentInitializer.js";
 /**
  * Agent 路径能力集合。
  */
@@ -75,118 +69,4 @@ export interface AgentPluginConfigRuntime {
      */
     persistProjectPlugins(plugins: DowncityConfig["plugins"] | undefined): Promise<string>;
 }
-/**
- * Agent 可见的平台能力集合。
- *
- * 关键点（中文）
- * - agent 只消费这些平台能力，不直接管理平台级持久化实现。
- * - 具体数据存储与管理应由 city / control plane 提供。
- */
-export interface AgentPlatformRuntime {
-    /**
-     * 读取当前平台级全局环境变量快照。
-     */
-    getGlobalEnv(): Record<string, string>;
-    /**
-     * 读取指定 agent 项目的私有环境变量快照。
-     */
-    getAgentEnv(projectRoot: string): Record<string, string>;
-    /**
-     * 读取当前平台模型池中的全部模型。
-     */
-    listModels(): StoredModel[];
-    /**
-     * 读取当前平台模型池中的全部 provider。
-     */
-    listProviders(): Promise<StoredModelProvider[]>;
-    /**
-     * 按模型 ID 读取单个模型。
-     */
-    getModel(modelId: string): StoredModel | null;
-    /**
-     * 按账户 ID 读取单个渠道账户。
-     */
-    getChannelAccount(channelAccountId: string): StoredChannelAccount | null;
-    /**
-     * 列出当前平台保存的全部渠道账户安全视图。
-     */
-    listChannelAccounts?(): Promise<ChatChannelAccountListItem[]>;
-    /**
-     * 探测渠道凭据并返回建议账户信息。
-     */
-    probeChannelAccount?(input: {
-        channel: string;
-        botToken?: string;
-        appId?: string;
-        appSecret?: string;
-        domain?: string;
-        sandbox?: boolean;
-    }): Promise<ChatChannelAccountProbeResult>;
-    /**
-     * 创建新的渠道账户。
-     */
-    createChannelAccount?(input: ChatChannelAccountCreateInput): Promise<{
-        id: string;
-        probed: boolean;
-        message?: string;
-    }>;
-    /**
-     * 更新现有渠道账户。
-     */
-    updateChannelAccount?(input: ChatChannelAccountUpsertInput): Promise<void>;
-    /**
-     * 删除渠道账户。
-     */
-    removeChannelAccount?(channelAccountId: string): Promise<void>;
-    /**
-     * 解析某个渠道当前应使用的账户。
-     */
-    resolveChannelAccount?(params: {
-        projectRoot: string;
-        channel: ChatChannelName;
-        channelAccountId?: string;
-    }): StoredChannelAccount | null;
-    /**
-     * 读取当前 agent 的 chat 授权配置。
-     */
-    readChatAuthorizationConfig(projectRoot: string): ChatAuthorizationConfig;
-    /**
-     * 覆盖写入当前 agent 的 chat 授权配置。
-     */
-    writeChatAuthorizationConfig(projectRoot: string, nextConfig: ChatAuthorizationConfig): Promise<ChatAuthorizationConfig>;
-    /**
-     * 设置当前 agent 某个渠道用户的授权角色。
-     */
-    setChatAuthorizationUserRole(params: {
-        projectRoot: string;
-        channel: ChatAuthorizationChannel;
-        userId: string;
-        roleId: string;
-    }): Promise<ChatAuthorizationConfig>;
-    /**
-     * 判断指定 plugin 当前是否启用。
-     */
-    isPluginEnabled(pluginName: string): boolean;
-    /**
-     * 设置指定 plugin 的全局启用态。
-     */
-    setPluginEnabled?(pluginName: string, enabled: boolean): void;
-    /**
-     * 列出平台模型选项。
-     */
-    listPlatformModelChoices?(): Promise<PlatformModelChoice[]>;
-    /**
-     * 初始化 agent 项目。
-     */
-    initializeAgentProject?(input: AgentProjectInitializationInput): Promise<{
-        projectRoot: string;
-        agentName: string;
-        createdFiles: string[];
-        skippedFiles: string[];
-    }>;
-    /**
-     * 校验项目执行绑定是否已就绪。
-     */
-    ensureRuntimeExecutionBindingReady?(projectRoot: string): void;
-}
 //# sourceMappingURL=AgentHost.d.ts.map

package/bin/types/runtime/host/AgentHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentHost.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/host/AgentHost.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentHost.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/host/AgentHost.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAC7B;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;IAC1B;;OAEG;IACH,yBAAyB,IAAI,MAAM,CAAC;IACpC;;OAEG;IACH,0BAA0B,IAAI,MAAM,CAAC;IACrC;;OAEG;IACH,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACtD;;OAEG;IACH,6BAA6B,IAAI,MAAM,CAAC;IACxC;;OAEG;IACH,6BAA6B,IAAI,MAAM,CAAC;IACxC;;OAEG;IACH,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD;;OAEG;IACH,6BAA6B,IAAI,MAAM,CAAC;IACxC;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxF"}

package/bin/types/runtime/host/AgentHost.js

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 这里统一描述由 agent runtime 装配、再挂入 AgentRuntime 的宿主能力。
  * - plugin runtime / session / plugin 作者 API 只能消费这些稳定能力，不应直接依赖具体宿主实现。
- * - 当前先收敛路径、认证、plugin 配置持久化三类高频能力。
+ * - 当前先收敛路径与 plugin 配置持久化两类高频能力。
  */
 export {};
 //# sourceMappingURL=AgentHost.js.map

package/bin/utils/object/DeepMerge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 通用深合并工具模块。
+ *
+ * 职责说明（中文）
+ * - 提供对象递归合并能力，供配置装配等“层层覆盖”场景复用。
+ * - 统一约束数组与标量的覆盖语义，避免不同模块出现不一致行为。
+ * - 这里只负责结构合并，不负责字段合法性校验。
+ */
+/**
+ * 深合并两个未知值。
+ *
+ * 关键点（中文）
+ * - 只有“对象 + 对象”会递归合并。
+ * - 数组始终以 `override` 为准，不做拼接。
+ * - 当 `override === undefined` 时保留 `base`，便于做配置层覆盖。
+ */
+export declare function deepMerge(base: unknown, override: unknown): unknown;
+//# sourceMappingURL=DeepMerge.d.ts.map

package/bin/utils/object/DeepMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepMerge.d.ts","sourceRoot":"","sources":["../../../src/utils/object/DeepMerge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAoBnE"}