@downcity/agent 1.1.237 → 1.1.258

package/README.md

@@ -75,32 +75,31 @@ src/
 
 - `src/agent/`
   - SDK facade 层
-  - `local/Agent.ts` 负责本地 Agent 实例装配、plugin/session/RPC 生命周期
-  - `remote/RemoteAgent.ts` 负责远程 Agent 客户端入口
-  - `remote/RemoteSession.ts` 负责远程 session actor 与 turn lifecycle
-  - `remote/transports/*` 负责 HTTP/RPC transport 适配
+  - `Agent.ts` 负责本地 Agent 实例装配
+  - `AgentSessions.ts` 负责 Session 集合生命周期
+
+- `src/session/`
+  - `Session.ts` 是公开 facade 与 Session 对象装配入口
+  - `SessionState.ts` 管理配置与 metadata
+  - `SessionTurn.ts` 管理输入队列和 Turn 生命周期
+  - `SessionMessages.ts` 是 canonical Message 唯一事实源
+  - `DefaultSessionComposer.ts` 负责 system/history/tools 与压缩计划定制
+  - `messages/` 放 JSONL Store、Assistant writer、Message codec 与 compaction
 
 - `src/executor/`
   - 内部执行内核
-  - `Session` 是 SDK 用户面对的会话整体，`Executor` 是内部单轮执行引擎
-  - Store 负责 history 事实源落盘，Composer 是可替换的 session 阶段策略协议，负责定义 system / history / context / compaction 等执行阶段逻辑
-  - `Executor.prepareExecuteInput()` 串起四类 Composer，`Executor.runCoreEngine()` 负责进入模型 tool loop
-  - 负责 history、system、context、CoreEngine、增量输出与消息持久化
+  - `Executor` 只负责单轮 LLM/Tool Loop、Step 状态和上下文恢复
+  - 不持有 History Store，不负责 Message 或 metadata 持久化
 
 - `src/plugin/`
   - 插件框架与内建插件
   - `core/` 负责注册、启用态、hook 调度、本地 action
-  - `builtins/` 放 `auth`、`chat`、`contact`、`memory`、`shell`、`skill`、`task`、`web`、`asr`、`tts`、`voice`、`workboard` 等内建插件
+  - `builtins/` 放 `auth`、`chat`、`contact`、`memory`、`shell`、`skill`、`task`、`web`、`sound`、`workboard` 等内建插件
   - `types/` 放插件公共协议类型
 
-- `src/runtime/`
-  - 单 Agent 的运行时实现细节层
-  - `host/` 放宿主注入能力协议
-  - `sandbox/` 放命令执行隔离与沙箱协议
-  - `control/` 放 runtime 控制面内部协议与处理器
-- `src/rpc/` 放 Agent 本机 RPC runtime；HTTP gateway 由 downcity CLI 基于 RPC 转发提供
-- 模型实例解析不在 `agent` 包内完成，而由宿主先创建 `LanguageModel`，再通过 `new Agent({ model })` 或 `session.set({ model })` 注入
-- `model` 也可以接收 City City 返回的 `CityModel`，Agent 会在内部适配成 AI SDK `LanguageModel`
+- `src/remote/transports/` 放 HTTP、RPC transport 及其内部客户端；RPC Server 与 HTTP gateway 由上游宿主管理
+- Agent 与 Session 都持有宿主传入的 `AgentModel` 实例；`AgentModel` 可以是 AI SDK `LanguageModel` 或 City 返回的 `CityModel`
+- Session 可通过 `session.set({ model })` 覆盖，执行时固定按 Session 模型、Agent 模型的顺序解析，并在 LLM 调用边界转换为 `LanguageModel`
 
 - `src/types/`
   - 跨模块、跨包共享协议类型
@@ -117,13 +116,15 @@ src/
 `@downcity/agent` 的核心是一条单 Agent 执行链：
 
 ```text
-入口协议 -> Agent facade -> AgentContext -> Session / Executor / Plugin -> Runtime 子系统 -> History / Reply
+入口协议 -> Agent facade -> Session / Plugin -> Executor -> Runtime 子系统 -> History / Reply
 ```
 
 其中：
 
-- `agent/local` 与 `agent/remote` 是用户 API 面
-- `Agent` facade 是实例级装配中心
+- `agent` 承载本地 Agent 核心运行时，`remote` 承载独立的远程 SDK 客户端
+- `config` 承载项目初始化等宿主集成能力，不进入 Agent 核心生命周期
+- `Agent` facade 是实例级装配中心，也是 env、instruction、model、tools、plugins 与 sessions 的唯一状态所有者
+- `AgentContext` 只向 Plugin 与宿主投影受限运行时能力，不保存完整项目 config 或第二份 Agent 状态
 - `session / executor / plugin` 是三大核心分层
 - `runtime` 是 control / sandbox / host 这类实现细节的统一容器
 - `types / utils` 提供横向公共支撑

package/bin/agent/{local/Agent.d.ts → Agent.d.ts}

@@ -1,54 +1,69 @@
 /**
- * Agent local：本地入口与 facade。
+ * Agent：本地 Agent 核心入口与 facade。
  *
  * 职责说明（中文）
  * - 对外暴露 `Agent` 这一唯一的本地实例类。
- * - facade 只保留公开 API 与 service 组合，不再直接承载装配、session 管理与生命周期细节。
- * - 单个 agent 的长期对象装配、session 管理、后台能力生命周期分别下沉到独立 service。
+ * - Agent 直接持有自身状态与长期运行时对象，避免额外 Assembly 复制同一批字段。
+ * - Session 集合由 `AgentSessions` 管理；长期运行状态由 `AgentState` 管理。
  */
 import type { Tool } from "ai";
-import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
-import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
-import type { AgentPlugins } from "../../types/plugin/PluginRuntime.js";
-import type { AgentOptions } from "../../types/agent/AgentOptions.js";
-import type { AgentSessions as AgentSessionsApi } from "../../types/agent/SessionActor.js";
+import type { AgentModel } from "../agent/AgentModel.js";
+import { AgentContext } from "../agent/AgentContext.js";
+import type { AgentOptions } from "../types/agent/AgentOptions.js";
 import type { Shell } from "@downcity/shell";
-import { Logger } from "../../utils/logger/Logger.js";
+import { Logger } from "../utils/logger/Logger.js";
+import { AgentSessions } from "../agent/AgentSessions.js";
+import { PluginRegistry } from "../plugin/core/PluginRegistry.js";
 /**
  * SDK 本地 Agent。
  */
 export declare class Agent {
+    /** 当前 Agent 的稳定标识，用于区分 Session 存储目录与运行时归属。 */
     readonly id: string;
+    /** 当前 Agent 绑定的项目根目录绝对路径。 */
     readonly path: string;
+    /** 当前 Agent 向所有 Session 提供的工具集合。 */
     readonly tools: Record<string, Tool>;
-    readonly plugins: AgentPlugins;
-    readonly sessions: AgentSessionsApi;
+    /** 当前 Agent 已装配的 Plugin 调用与注册入口。 */
+    readonly plugins: PluginRegistry;
+    /** 当前 Agent 的本地 Session 创建、恢复、查询与归档入口。 */
+    readonly sessions: AgentSessions;
+    /**
+     * 当前 Agent 持有的默认运行时模型实例。
+     *
+     * 关键点（中文）
+     * - Agent 只持有调用方传入的实例，不负责模型选择、持久化或恢复。
+     * - Session 未设置自己的模型时，执行会回退使用该实例。
+     */
+    readonly model?: AgentModel;
+    /** 当前 Agent 独享的运行日志器。 */
     private readonly logger;
-    private readonly agentContext;
-    private readonly config;
+    /** 提供给 Plugin、Session 与宿主集成层共享的 Agent 执行上下文。 */
+    private readonly context;
+    /** 当前 Agent configured env 的可变共享对象。 */
     private readonly env;
-    private readonly defaultModel?;
-    private readonly default_model_id?;
-    private readonly resolve_model?;
+    /** 调用方提供的自定义 Session 类；省略时使用 SDK 默认实现。 */
     private readonly SessionClass;
-    private readonly backgroundService;
+    /** 当前 Agent 的长期运行状态与生命周期。 */
+    private readonly state;
+    /** 当前 Agent 可选的内建 Shell 实例。 */
     private readonly shell?;
-    private readonly local_sessions;
+    /** 当前 Agent configured instruction 的可变有序集合。 */
     private instruction;
     constructor(options: AgentOptions);
     /**
-     * 等待 Agent 后台能力启动完成。
+     * 等待 Agent 持有的长期运行时启动完成。
      *
      * 关键点（中文）
      * - Agent 构造完成即开始启动 plugin lifecycle 与 ActionSchedule。
-     * - 调用方在需要确认后台能力就绪时使用，例如启动后立刻读取 plugin 状态。
+     * - 调用方在需要确认运行时就绪时使用，例如启动后立刻读取 plugin 状态。
      */
     ready(): Promise<void>;
     /**
-     * 释放当前 Agent 的后台能力。
+     * 释放当前 Agent 持有的长期运行时对象。
      *
      * 关键点（中文）
-     * - 关闭 plugin lifecycle、ActionSchedule、shell 等后台资源。
+     * - 关闭 plugin lifecycle、ActionSchedule、shell 等 Agent 自有资源。
      * - 不负责任何 transport（RPC / HTTP）；transport 由 `@downcity/server` 自行管理。
      */
     dispose(): Promise<void>;
@@ -84,10 +99,6 @@ export declare class Agent {
      * 原地应用一次 env patch，不触发重复广播。
      */
     private apply_env_patch;
-    /**
-     * 返回当前项目根目录解析后的配置快照。
-     */
-    getConfig(): DowncityConfig;
     /**
      * 返回当前 agent 绑定的统一日志器。
      */
@@ -100,6 +111,5 @@ export declare class Agent {
      * 返回当前 agent 挂载的 Shell。
      */
     getShell(): Shell | undefined;
-    private create_sessions;
 }
 //# sourceMappingURL=Agent.d.ts.map

package/bin/agent/Agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/agent/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;GAEG;AACH,qBAAa,KAAK;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAErC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAE5B,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAE7C,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IAEvD,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAwB;IAE/C,+CAA+C;IAC/C,OAAO,CAAC,WAAW,CAAW;gBAElB,OAAO,EAAE,YAAY;IA8DjC;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAM9C;;;;;;OAMG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhC;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI;IAQ7D;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI;IAKhE;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,QAAQ,IAAI,KAAK,GAAG,SAAS;CAG9B"}

package/bin/agent/Agent.js

@@ -0,0 +1,211 @@
+/**
+ * Agent：本地 Agent 核心入口与 facade。
+ *
+ * 职责说明（中文）
+ * - 对外暴露 `Agent` 这一唯一的本地实例类。
+ * - Agent 直接持有自身状态与长期运行时对象，避免额外 Assembly 复制同一批字段。
+ * - Session 集合由 `AgentSessions` 管理；长期运行状态由 `AgentState` 管理。
+ */
+import { AgentContext } from "../agent/AgentContext.js";
+import { Logger } from "../utils/logger/Logger.js";
+import { resolve_agent_env } from "../config/AgentEnv.js";
+import { normalizeInstructionInput } from "../agent/AgentInstructions.js";
+import { AgentSessions } from "../agent/AgentSessions.js";
+import { AgentState } from "../agent/AgentState.js";
+import { generateId } from "../utils/Id.js";
+import { PluginRegistry } from "../plugin/core/PluginRegistry.js";
+/**
+ * SDK 本地 Agent。
+ */
+export class Agent {
+    /** 当前 Agent 的稳定标识，用于区分 Session 存储目录与运行时归属。 */
+    id;
+    /** 当前 Agent 绑定的项目根目录绝对路径。 */
+    path;
+    /** 当前 Agent 向所有 Session 提供的工具集合。 */
+    tools;
+    /** 当前 Agent 已装配的 Plugin 调用与注册入口。 */
+    plugins;
+    /** 当前 Agent 的本地 Session 创建、恢复、查询与归档入口。 */
+    sessions;
+    /**
+     * 当前 Agent 持有的默认运行时模型实例。
+     *
+     * 关键点（中文）
+     * - Agent 只持有调用方传入的实例，不负责模型选择、持久化或恢复。
+     * - Session 未设置自己的模型时，执行会回退使用该实例。
+     */
+    model;
+    /** 当前 Agent 独享的运行日志器。 */
+    logger;
+    /** 提供给 Plugin、Session 与宿主集成层共享的 Agent 执行上下文。 */
+    context;
+    /** 当前 Agent configured env 的可变共享对象。 */
+    env;
+    /** 调用方提供的自定义 Session 类；省略时使用 SDK 默认实现。 */
+    SessionClass;
+    /** 当前 Agent 的长期运行状态与生命周期。 */
+    state;
+    /** 当前 Agent 可选的内建 Shell 实例。 */
+    shell;
+    /** 当前 Agent configured instruction 的可变有序集合。 */
+    instruction;
+    constructor(options) {
+        this.id = String(options.id || "").trim();
+        this.path = String(options.path || "").trim();
+        if (!this.id)
+            throw new Error("Agent requires a non-empty id");
+        if (!this.path)
+            throw new Error("Agent requires a non-empty path");
+        this.SessionClass = options.Session;
+        this.model = options.model;
+        this.tools = options.tools && typeof options.tools === "object"
+            ? { ...options.tools }
+            : {};
+        this.logger = new Logger();
+        this.logger.bindProjectRoot(this.path);
+        this.env = resolve_agent_env(this.path, options.env);
+        this.instruction = normalizeInstructionInput(options.instruction);
+        this.shell = options.shell;
+        this.plugins = new PluginRegistry(options.plugins || []);
+        if (this.shell) {
+            this.shell.configure({
+                root_path: this.path,
+                env: this.env,
+                agent_id: this.id,
+                logger: this.logger,
+            });
+            Object.assign(this.tools, this.shell.tools);
+        }
+        this.sessions = new AgentSessions({
+            agent_id: this.id,
+            project_root: this.path,
+            tools: this.tools,
+            logger: this.logger,
+            get_instruction: () => this.instruction,
+            get_agent_env: () => this.getEnv(),
+            get_agent_plugins: () => this.plugins.execution_view(),
+            ensure_agent_ready: async () => {
+                await this.ready();
+            },
+            get_agent_model: () => this.model,
+            SessionClass: this.SessionClass,
+        });
+        this.context = new AgentContext({
+            agent_id: this.id,
+            rootPath: this.path,
+            logger: this.logger,
+            get_env: () => this.env,
+            get_systems: () => this.instruction,
+            sessions: this.sessions,
+            plugins: this.plugins,
+        });
+        // 关键点（中文）：装配完成后创建唯一状态对象，并立即启动长期运行时。
+        this.state = new AgentState({
+            context: this.context,
+            plugins: this.plugins,
+            sessions: this.sessions,
+            tools: this.tools,
+            shell: this.shell,
+        });
+    }
+    /**
+     * 等待 Agent 持有的长期运行时启动完成。
+     *
+     * 关键点（中文）
+     * - Agent 构造完成即开始启动 plugin lifecycle 与 ActionSchedule。
+     * - 调用方在需要确认运行时就绪时使用，例如启动后立刻读取 plugin 状态。
+     */
+    async ready() {
+        await this.state.ready();
+    }
+    /**
+     * 释放当前 Agent 持有的长期运行时对象。
+     *
+     * 关键点（中文）
+     * - 关闭 plugin lifecycle、ActionSchedule、shell 等 Agent 自有资源。
+     * - 不负责任何 transport（RPC / HTTP）；transport 由 `@downcity/server` 自行管理。
+     */
+    async dispose() {
+        await this.state.dispose();
+    }
+    /**
+     * 更新当前 SDK Agent 的静态基础指令。
+     */
+    setInstruction(input) {
+        const next_instruction = normalizeInstructionInput(input);
+        this.instruction.splice(0, this.instruction.length, ...next_instruction);
+        this.sessions.broadcast_instruction(this.instruction, generateId());
+    }
+    /**
+     * 返回当前 agent env 的浅拷贝快照。
+     *
+     * 关键点（中文）
+     * - 返回的是拷贝，调用方修改它不会影响 agent 真实状态。
+     * - 想改 env 请使用 `setEnv` / `patchEnv`。
+     */
+    getEnv() {
+        return { ...this.env };
+    }
+    /**
+     * 整体覆盖 agent env。
+     *
+     * 关键点（中文）
+     * - 直接清空当前共享 env 对象，再写入新值，保证 plugin / runtime / shell 看到的是同一引用。
+     * - 仅写入字符串值，`null` / `undefined` 表示删除该 key。
+     */
+    setEnv(next) {
+        for (const key of Object.keys(this.env)) {
+            delete this.env[key];
+        }
+        this.apply_env_patch(next);
+        this.sessions.broadcast_env(this.env, generateId());
+    }
+    /**
+     * 增量合并 agent env。
+     *
+     * 关键点（中文）
+     * - `null` / `undefined` 表示删除该 key；其他值会强制转字符串后写入。
+     * - configured env 原地更新；已有 Session 在下一 step 检查点提交 effective env。
+     */
+    patchEnv(patch) {
+        this.apply_env_patch(patch);
+        this.sessions.broadcast_env(this.env, generateId());
+    }
+    /**
+     * 原地应用一次 env patch，不触发重复广播。
+     */
+    apply_env_patch(patch) {
+        if (!patch || typeof patch !== "object")
+            return;
+        for (const [raw_key, raw_value] of Object.entries(patch)) {
+            const key = String(raw_key || "").trim();
+            if (!key)
+                continue;
+            if (raw_value === null || raw_value === undefined) {
+                delete this.env[key];
+                continue;
+            }
+            this.env[key] = String(raw_value);
+        }
+    }
+    /**
+     * 返回当前 agent 绑定的统一日志器。
+     */
+    getLogger() {
+        return this.logger;
+    }
+    /**
+     * 返回当前 agent context。
+     */
+    getContext() {
+        return this.context;
+    }
+    /**
+     * 返回当前 agent 挂载的 Shell。
+     */
+    getShell() {
+        return this.shell;
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/bin/agent/Agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../src/agent/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;GAEG;AACH,MAAM,OAAO,KAAK;IAChB,8CAA8C;IACrC,EAAE,CAAS;IAEpB,6BAA6B;IACpB,IAAI,CAAS;IAEtB,oCAAoC;IAC3B,KAAK,CAAuB;IAErC,oCAAoC;IAC3B,OAAO,CAAiB;IAEjC,0CAA0C;IACjC,QAAQ,CAAgB;IAEjC;;;;;;OAMG;IACM,KAAK,CAAc;IAE5B,yBAAyB;IACR,MAAM,CAAS;IAEhC,gDAAgD;IAC/B,OAAO,CAAe;IAEvC,uCAAuC;IACtB,GAAG,CAAyB;IAE7C,0CAA0C;IACzB,YAAY,CAA0B;IAEvD,6BAA6B;IACZ,KAAK,CAAa;IAEnC,+BAA+B;IACd,KAAK,CAAyB;IAE/C,+CAA+C;IACvC,WAAW,CAAW;IAE9B,YAAY,OAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAEnE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAC7D,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE;YACtB,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,WAAW,GAAG,yBAAyB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE3B,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,IAAI,CAAC,IAAI;gBACpB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC;YAChC,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW;YACvC,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;YAClC,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YACtD,kBAAkB,EAAE,KAAK,IAAI,EAAE;gBAC7B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YACD,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC;YAC9B,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG;YACvB,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW;YACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QAEH,oCAAoC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAwB;QACrC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAA+C;QACpD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,KAAgD;QACvD,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,KAAgD;QAEhD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO;QAChD,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAClD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/bin/agent/AgentContext.d.ts

@@ -0,0 +1,64 @@
+/**
+ * AgentContext：本地 Agent 的统一执行上下文。
+ *
+ * 职责说明（中文）
+ * - 同一 Agent 实例全程共享同一个 Context。
+ * - 向 Plugin、Session 与宿主投影当前 Agent 的稳定运行时能力。
+ * - Context 不复制 Agent 状态，env 与 systems 始终从唯一状态源读取。
+ */
+import type { AgentSessions } from "../agent/AgentSessions.js";
+import type { AgentPlugins } from "../types/plugin/PluginRuntime.js";
+import type { Logger } from "../utils/logger/Logger.js";
+/**
+ * AgentContext 构造参数。
+ */
+interface AgentContextOptions {
+    /** 当前 Agent 稳定标识。 */
+    agent_id: string;
+    /** 当前项目根目录。 */
+    rootPath: string;
+    /** 当前 Agent 统一日志器。 */
+    logger: Logger;
+    /** 读取当前 Agent configured env。 */
+    get_env: () => Readonly<Record<string, string>>;
+    /** 读取当前 Agent configured systems。 */
+    get_systems: () => readonly string[];
+    /** 当前 Agent 直接持有的 Session 集合。 */
+    sessions: AgentSessions;
+    /** 当前 Agent 唯一的 Plugin 调用入口。 */
+    plugins: AgentPlugins;
+}
+/**
+ * 本地 Agent 的统一执行上下文。
+ */
+export declare class AgentContext {
+    /** 当前 Agent 稳定标识。 */
+    readonly agent_id: string;
+    /** 当前项目根目录。 */
+    readonly rootPath: string;
+    /** 当前 Agent 统一日志器。 */
+    readonly logger: Logger;
+    /** 当前 Agent configured env 读取器。 */
+    private readonly get_env;
+    /** 当前 Agent configured systems 读取器。 */
+    private readonly get_systems;
+    /** 当前 Agent 直接持有的 Session 集合。 */
+    readonly sessions: AgentSessions;
+    /** 当前 Agent 唯一的 Plugin 调用入口。 */
+    readonly plugins: AgentPlugins;
+    constructor(options: AgentContextOptions);
+    /**
+     * 读取 Agent 已配置的 env。
+     *
+     * 关键点（中文）
+     * - Session step 的 effective env 由 Plugin action 参数 `run_context.agentEnv` 显式提供。
+     * - 该 getter 不根据异步调用链隐式切换结果。
+     */
+    get env(): Readonly<Record<string, string>>;
+    /**
+     * 读取 Agent 已配置的 instruction。
+     */
+    get systems(): readonly string[];
+}
+export {};
+//# sourceMappingURL=AgentContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../src/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;GAEG;AACH,UAAU,mBAAmB;IAC3B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,OAAO,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEhD,qCAAqC;IACrC,WAAW,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAErC,iCAAiC;IACjC,QAAQ,EAAE,aAAa,CAAC;IAExB,gCAAgC;IAChC,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IAEzD,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IAEjE,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;gBAEnB,OAAO,EAAE,mBAAmB;IAUxC;;;;;;OAMG;IACH,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE1C;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,MAAM,EAAE,CAE/B;CACF"}

package/bin/agent/AgentContext.js

@@ -0,0 +1,53 @@
+/**
+ * AgentContext：本地 Agent 的统一执行上下文。
+ *
+ * 职责说明（中文）
+ * - 同一 Agent 实例全程共享同一个 Context。
+ * - 向 Plugin、Session 与宿主投影当前 Agent 的稳定运行时能力。
+ * - Context 不复制 Agent 状态，env 与 systems 始终从唯一状态源读取。
+ */
+/**
+ * 本地 Agent 的统一执行上下文。
+ */
+export class AgentContext {
+    /** 当前 Agent 稳定标识。 */
+    agent_id;
+    /** 当前项目根目录。 */
+    rootPath;
+    /** 当前 Agent 统一日志器。 */
+    logger;
+    /** 当前 Agent configured env 读取器。 */
+    get_env;
+    /** 当前 Agent configured systems 读取器。 */
+    get_systems;
+    /** 当前 Agent 直接持有的 Session 集合。 */
+    sessions;
+    /** 当前 Agent 唯一的 Plugin 调用入口。 */
+    plugins;
+    constructor(options) {
+        this.agent_id = options.agent_id;
+        this.rootPath = options.rootPath;
+        this.logger = options.logger;
+        this.get_env = options.get_env;
+        this.get_systems = options.get_systems;
+        this.sessions = options.sessions;
+        this.plugins = options.plugins;
+    }
+    /**
+     * 读取 Agent 已配置的 env。
+     *
+     * 关键点（中文）
+     * - Session step 的 effective env 由 Plugin action 参数 `run_context.agentEnv` 显式提供。
+     * - 该 getter 不根据异步调用链隐式切换结果。
+     */
+    get env() {
+        return this.get_env();
+    }
+    /**
+     * 读取 Agent 已配置的 instruction。
+     */
+    get systems() {
+        return this.get_systems();
+    }
+}
+//# sourceMappingURL=AgentContext.js.map

package/bin/agent/AgentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContext.js","sourceRoot":"","sources":["../../src/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgCH;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB,qBAAqB;IACZ,QAAQ,CAAS;IAE1B,eAAe;IACN,QAAQ,CAAS;IAE1B,sBAAsB;IACb,MAAM,CAAS;IAExB,mCAAmC;IAClB,OAAO,CAAiC;IAEzD,uCAAuC;IACtB,WAAW,CAAqC;IAEjE,iCAAiC;IACxB,QAAQ,CAAgB;IAEjC,gCAAgC;IACvB,OAAO,CAAe;IAE/B,YAAY,OAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/bin/agent/{local/AgentInstructions.d.ts → AgentInstructions.d.ts}

@@ -6,12 +6,7 @@
  * - instruction 永远在 core 前面；core 不会被调用方 instruction 替代。
  * - 不读取 session、plugin 或 runtime 状态，保持为纯函数。
  */
-import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
-import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
-/**
- * 创建 SDK 场景的最小 fallback 配置。
- */
-export declare function createFallbackSdkConfig(agent_id: string): DowncityConfig;
+import type { AgentSessionSystemBlock } from "../types/agent/SessionTypes.js";
 /**
  * 归一化调用方传入的静态 instruction。
  */

package/bin/agent/AgentInstructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInstructions.d.ts","sourceRoot":"","sources":["../../src/agent/AgentInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GACnC,MAAM,EAAE,CASV;AAUD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,EAAE,MAAM,GACnB,uBAAuB,EAAE,CAc3B"}

package/bin/agent/{local/AgentInstructions.js → AgentInstructions.js}

@@ -6,16 +6,7 @@
  * - instruction 永远在 core 前面；core 不会被调用方 instruction 替代。
  * - 不读取 session、plugin 或 runtime 状态，保持为纯函数。
  */
-import { DEFAULT_SHIP_PROMPTS } from "../../executor/composer/system/default/SystemDomain.js";
-/**
- * 创建 SDK 场景的最小 fallback 配置。
- */
-export function createFallbackSdkConfig(agent_id) {
-    return {
-        id: agent_id,
-        version: "0.0.0",
-    };
-}
+import { DEFAULT_SHIP_PROMPTS } from "../executor/composer/system/default/SystemDomain.js";
 /**
  * 归一化调用方传入的静态 instruction。
  */

package/bin/agent/AgentInstructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInstructions.js","sourceRoot":"","sources":["../../src/agent/AgentInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAEzF;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAoC;IAEpC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,CAAC,KAAK,CAAC;YACT,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,4BAA4B,CAAC,YAAoB;IACxD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,OAAO,oBAAoB;SACxB,UAAU,CAAC,kBAAkB,EAAE,YAAY,CAAC;SAC5C,UAAU,CAAC,kBAAkB,EAAE,YAAY,CAAC;SAC5C,UAAU,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,WAAqB,EACrB,YAAoB;IAEpB,MAAM,kBAAkB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,EAAE,aAAsB;QAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,EAAE;QAC/D,OAAO;KACR,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,GAAG,kBAAkB;QACrB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,4BAA4B,CAAC,YAAY,CAAC;SACpD;KACF,CAAC;AACJ,CAAC"}

package/bin/{model/CityModelAdapter.d.ts → agent/AgentModel.d.ts}

@@ -1,8 +1,8 @@
 /**
- * CityModel 到 AI SDK LanguageModel 的归一化模块。
+ * AgentModel：Agent 与 Session 统一使用的运行时模型协议。
  *
  * 关键点（中文）
- * - Agent 对外可以接收 CityModel，但 executor 内部只处理 AI SDK LanguageModel。
+ * - Agent 与 Session 对外统一接收 AgentModel，executor 内部只处理 AI SDK LanguageModel。
  * - CityModel 保留模型目录信息；运行时连接信息通过隐藏协议提供。
  * - 这里直接创建 OpenAI-compatible LanguageModel，不再保留旧的 text/stream 反向适配。
  * - 这里不依赖 @downcity/city，只依赖 @downcity/type 的共享协议。
@@ -27,4 +27,4 @@ export declare function read_agent_model_context_window(model: AgentModel | unde
  * 从 Agent 模型输入推导展示标签。
  */
 export declare function inferAgentModelLabel(model: AgentModel | undefined): string | undefined;
-//# sourceMappingURL=CityModelAdapter.d.ts.map
+//# sourceMappingURL=AgentModel.d.ts.map

package/bin/agent/AgentModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentModel.d.ts","sourceRoot":"","sources":["../../src/agent/AgentModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAKxC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAenD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CASpE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS,CAMpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAqBtF"}

package/bin/{model/CityModelAdapter.js → agent/AgentModel.js}

@@ -1,14 +1,16 @@
 /**
- * CityModel 到 AI SDK LanguageModel 的归一化模块。
+ * AgentModel：Agent 与 Session 统一使用的运行时模型协议。
  *
  * 关键点（中文）
- * - Agent 对外可以接收 CityModel，但 executor 内部只处理 AI SDK LanguageModel。
+ * - Agent 与 Session 对外统一接收 AgentModel，executor 内部只处理 AI SDK LanguageModel。
  * - CityModel 保留模型目录信息；运行时连接信息通过隐藏协议提供。
  * - 这里直接创建 OpenAI-compatible LanguageModel，不再保留旧的 text/stream 反向适配。
  * - 这里不依赖 @downcity/city，只依赖 @downcity/type 的共享协议。
  */
 import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 import { CITY_MODEL_INVOKER, isCityModel, } from "@downcity/type";
+/** 已完成转换的 CityModel 与 LanguageModel 对应关系。 */
+const normalized_models = new WeakMap();
 /**
  * 将 CityModel 的 hidden connection 转换为 AI SDK LanguageModel。
  */
@@ -26,7 +28,12 @@ function cityModelToLanguageModel(model) {
  */
 export function normalizeAgentModel(model) {
     if (isCityModel(model)) {
-        return cityModelToLanguageModel(model);
+        const cached = normalized_models.get(model);
+        if (cached)
+            return cached;
+        const normalized = cityModelToLanguageModel(model);
+        normalized_models.set(model, normalized);
+        return normalized;
     }
     return model;
 }
@@ -71,4 +78,4 @@ export function inferAgentModelLabel(model) {
         : "";
     return constructorName || "configured-model";
 }
-//# sourceMappingURL=CityModelAdapter.js.map
+//# sourceMappingURL=AgentModel.js.map

package/bin/agent/AgentModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentModel.js","sourceRoot":"","sources":["../../src/agent/AgentModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,WAAW,GAEZ,MAAM,gBAAgB,CAAC;AAGxB,6CAA6C;AAC7C,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAyB,CAAC;AAO/D;;GAEG;AACH,SAAS,wBAAwB,CAAC,KAAgB;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC,UAAU,EAAE,CAAC;IAC1D,MAAM,QAAQ,GAAG,sBAAsB,CAAC;QACtC,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU,CAAC,QAAQ;QAC5B,MAAM,EAAE,UAAU,CAAC,OAAO;KAC3B,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAkB,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACnD,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAA6B;IAE7B,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC5C,OAAO,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC;QACvE,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;QACxB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA6B;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,UAAU,GAAG;QACjB,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,KAAK;QACZ,MAAM,CAAC,EAAE;QACT,MAAM,CAAC,IAAI;QACX,MAAM,CAAC,KAAK;KACb,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,MAAM,eAAe,GACnB,KAAK,CAAC,WAAW,IAAI,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ;QAC7D,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE;QAC/B,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,eAAe,IAAI,kBAAkB,CAAC;AAC/C,CAAC"}