@downcity/agent 1.1.287 → 1.1.310

package/README.md

@@ -6,7 +6,7 @@
 
 - 本地 SDK：`Agent`、`Session`、`RemoteAgent`
 - 内部执行内核：Session Composer、LLM/Tool Loop、增量输出
-- Plugin 框架：registry、action、tool bridge 与执行生命周期
+- Plugin 框架：registry、action、tool runtime 与执行生命周期
 - 远程访问：`RemoteAgent`、HTTP/RPC transport
 
 `downcity` 负责多 Agent 管理、控制面网关、平台 CLI、共享模型目录接入与 daemon 进程管理；`@downcity/agent` 只负责单 Agent 的执行面。
@@ -27,7 +27,7 @@
 - `downcity`
   - 多 Agent registry
   - control plane / gateway
-  - 平台 CLI、共享模型目录接入、模型运行时绑定、全局 env、channel account store
+  - 平台 CLI、共享模型目录接入、模型运行时绑定、全局 env、Plugin Resource Store
   - agent daemon 进程管理
 - `@downcity/ui`
   - React UI 组件与展示层
@@ -49,35 +49,39 @@ packages/agent
 ```text
 src/
 ├── index.ts               # 包公开入口
-├── agent/                 # Agent facade、AgentState、AgentSessions 与 AgentModel
-├── config/                # 项目环境、运行路径与初始化能力
+├── agent/                 # Agent facade、状态、模型、环境与执行绑定
 ├── executor/              # LLM/Tool Loop、执行恢复与内存上下文折叠
 ├── plugin/                # Plugin registry、执行视图、工具桥接与生命周期
 ├── remote/                # RemoteAgent、RemoteSession 与 HTTP/RPC transport
 ├── session/               # Session facade、State、Turn、Queue、Messages 与 Composer
 ├── types/                 # agent / executor / session / plugin 等共享协议类型
-└── utils/                 # 日志、存储、资源和通用辅助能力
+├── utils/                 # 日志、资源和通用辅助能力
+└── workspace/             # 项目文件、工具、初始化、路径与结构化存储
 ```
 
 ## 顶层目录职责
 
-- `src/config/`
-  - 项目配置、项目级路径解析与项目初始化
-  - `project/` 收口 agent 项目脚手架与初始化结果类型
-  - 负责项目 `.env`、`.downcity/*` 路径规则与 execution binding
-
 - `src/agent/`
   - SDK facade 层
   - `Agent.ts` 负责本地 Agent 实例装配
   - `AgentSessions.ts` 负责 Session 集合生命周期
+  - `ExecutionBinding.ts` 负责 Agent 执行目标绑定
+
+- `src/workspace/`
+  - 统一承载项目根目录、文件系统、模型工具、初始化和结构化存储
+  - `setup/` 负责项目 `.env`、`.gitignore` 与 `.downcity` 初始化
+  - `store/` 负责 Agent、Session 和 JSONL Message 的本地持久化
+  - `WorkspaceEnv.ts` 负责 Workspace 环境变量装配
+  - `tool/WorkspaceTools.ts` 组合文件、搜索与可选 Shell 工具
+  - `WorkspacePaths.ts` 负责 Workspace 内部路径布局
 
 - `src/session/`
   - `Session.ts` 是公开 facade 与 Session 对象装配入口
   - `SessionState.ts` 管理配置与 metadata
-  - `SessionTurn.ts` 管理输入队列和 Turn 生命周期
+  - `SessionLoop.ts` 管理输入队列和 Turn 生命周期
   - `SessionMessages.ts` 是 canonical Message 唯一事实源
   - `DefaultSessionComposer.ts` 负责 system/history/tools 与压缩计划定制
-  - `messages/` 放 JSONL Store、Assistant writer、Message codec 与 compaction
+  - `messages/` 放 Assistant writer、Message codec 与 compaction；JSONL Store 位于 `workspace/store/`
   - 完整设计见 [`docs/session-runtime-architecture.md`](../../docs/session-runtime-architecture.md)
 
 - `src/executor/`
@@ -108,15 +112,18 @@ src/
 `@downcity/agent` 的核心是一条单 Agent 执行链：
 
 ```text
-入口协议 -> Agent facade -> SessionTurn -> SessionComposer -> Executor -> SessionMessages
+入口协议 -> Agent facade -> SessionLoop -> SessionComposer -> Executor -> SessionMessages
 ```
 
 其中：
 
 - `agent` 承载本地 Agent 核心运行时，`remote` 承载独立的远程 SDK 客户端
-- `config` 承载项目初始化等宿主集成能力，不进入 Agent 核心生命周期
-- `Agent` facade 是实例级装配中心，也是 env、instruction、model、tools、plugins 与 sessions 的唯一状态所有者
-- `AgentContext` 只向 Plugin 与宿主投影受限运行时能力，不保存完整项目 config 或第二份 Agent 状态
+- `workspace` 承载项目资源、初始化和持久化能力，`platform` 只处理系统级路径
+- `Agent` facade 是实例级装配中心，持有 instruction、model、tools、plugins 与 sessions；env 由 Workspace 持有
+- `PluginContext` 只在 Agent 内部向 Plugin 投影稳定能力，不向宿主暴露
 - `session / executor / plugin` 是三大核心分层
 - `SessionMessages` 是 Message 唯一事实源，Executor 不持有 Store
 - `types / utils` 提供横向公共支撑
+
+完整架构、执行链、持久化、Plugin、Shell 与跨平台设计见
+[`docs/agent-sdk-architecture.md`](../../docs/agent-sdk-architecture.md)。

package/bin/agent/Agent.d.ts

@@ -8,20 +8,24 @@
  */
 import type { Tool } from "ai";
 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 type { Workspace } from "../workspace/Workspace.js";
 import { Logger } from "../utils/logger/Logger.js";
 import { AgentSessions } from "../agent/AgentSessions.js";
 import { PluginRegistry } from "../plugin/core/PluginRegistry.js";
+import type { Hono } from "hono";
+import type { PluginSnapshot } from "../types/plugin/PluginState.js";
+import { type SystemProfile } from "../executor/composer/system/default/SystemDomain.js";
+import type { SystemModelMessage } from "ai";
 /**
  * SDK 本地 Agent。
  */
 export declare class Agent {
     /** 当前 Agent 的稳定标识，用于区分 Session 存储目录与运行时归属。 */
     readonly id: string;
-    /** 当前 Agent 绑定的项目根目录绝对路径。 */
-    readonly path: string;
+    /** 当前 Agent 引用的项目资源与安全边界。 */
+    readonly workspace: Workspace;
     /** 当前 Agent 向所有 Session 提供的工具集合。 */
     readonly tools: Record<string, Tool>;
     /** 当前 Agent 已装配的 Plugin 调用与注册入口。 */
@@ -39,17 +43,19 @@ export declare class Agent {
     /** 当前 Agent 独享的运行日志器。 */
     private readonly logger;
     /** 提供给 Plugin、Session 与宿主集成层共享的 Agent 执行上下文。 */
-    private readonly context;
-    /** 当前 Agent configured env 的可变共享对象。 */
-    private readonly env;
+    private readonly plugin_context;
     /** 调用方提供的自定义 Session 类；省略时使用 SDK 默认实现。 */
-    private readonly SessionClass;
+    private readonly session_class;
     /** 当前 Agent 的长期运行状态与生命周期。 */
     private readonly state;
-    /** 当前 Agent 可选的内建 Shell 实例。 */
-    private readonly shell?;
     /** 当前 Agent configured instruction 的可变有序集合。 */
     private instruction;
+    /** 取消 Workspace env 变化订阅的函数。 */
+    private readonly unsubscribe_workspace_env;
+    /** 取消 PluginRegistry 变化订阅的函数。 */
+    private readonly unsubscribe_plugin_change;
+    /** 当前由 PluginRegistry 注册到 Agent 的 Tool 名称。 */
+    private readonly plugin_tool_names;
     constructor(options: AgentOptions);
     /**
      * 等待 Agent 持有的长期运行时启动完成。
@@ -63,53 +69,37 @@ export declare class Agent {
      * 释放当前 Agent 持有的长期运行时对象。
      *
      * 关键点（中文）
-     * - 关闭 plugin lifecycle、ActionSchedule、shell 等 Agent 自有资源。
+     * - 关闭 plugin lifecycle 与 ActionSchedule 等 Agent 自有资源。
+     * - Workspace 与 Agent 一对一绑定，因此这里同时关闭 Shell 与 Sandbox。
      * - 不负责任何 transport（RPC / HTTP）；transport 由 `@downcity/server` 自行管理。
      */
     dispose(): Promise<void>;
     /**
      * 更新当前 SDK Agent 的静态基础指令。
      */
-    setInstruction(input: string | string[]): void;
-    /**
-     * 返回当前 agent env 的浅拷贝快照。
-     *
-     * 关键点（中文）
-     * - 返回的是拷贝，调用方修改它不会影响 agent 真实状态。
-     * - 想改 env 请使用 `setEnv` / `patchEnv`。
-     */
-    getEnv(): Record<string, string>;
-    /**
-     * 整体覆盖 agent env。
-     *
-     * 关键点（中文）
-     * - 直接清空当前共享 env 对象，再写入新值，保证 plugin / runtime / shell 看到的是同一引用。
-     * - 仅写入字符串值，`null` / `undefined` 表示删除该 key。
-     */
-    setEnv(next: Record<string, string | null | undefined>): void;
-    /**
-     * 增量合并 agent env。
-     *
-     * 关键点（中文）
-     * - `null` / `undefined` 表示删除该 key；其他值会强制转字符串后写入。
-     * - configured env 原地更新；已有 Session 在下一 step 检查点提交 effective env。
-     */
-    patchEnv(patch: Record<string, string | null | undefined>): void;
-    /**
-     * 原地应用一次 env patch，不触发重复广播。
-     */
-    private apply_env_patch;
+    set_instruction(input: string | string[]): void;
     /**
      * 返回当前 agent 绑定的统一日志器。
      */
-    getLogger(): Logger;
-    /**
-     * 返回当前 agent context。
-     */
-    getContext(): AgentContext;
+    get_logger(): Logger;
     /**
      * 返回当前 agent 挂载的 Shell。
      */
-    getShell(): Shell | undefined;
+    get_shell(): Shell | undefined;
+    /** 返回当前 Agent 已配置的静态指令快照。 */
+    get_instructions(): readonly string[];
+    /** 列出当前 Agent 已注册的 Plugin 状态。 */
+    list_plugin_states(): PluginSnapshot[];
+    /** 把当前 Agent 已注册 Plugin 的 HTTP 路由装配到宿主应用。 */
+    register_plugin_http_routes(app: Hono): void;
+    /** 解析指定 Session 当前可见的完整 system messages。 */
+    resolve_system_messages(input: {
+        /** 需要解析 system 的 Session 标识。 */
+        session_id: string;
+        /** system 组合档位；省略时使用 chat。 */
+        profile?: SystemProfile;
+    }): Promise<SystemModelMessage[]>;
+    /** 将 PluginRegistry 当前 Tool Set 同步到 Agent 持有的工具集合。 */
+    private sync_plugin_tools;
 }
 //# sourceMappingURL=Agent.d.ts.map

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

@@ -1 +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;IA+DjC;;;;;;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;IAK9C;;;;;;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"}
+{"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;AAGxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAoB7C;;GAEG;AACH,qBAAa,KAAK;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,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,cAAc,CAAgB;IAE/C,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAE9D,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,+CAA+C;IAC/C,OAAO,CAAC,WAAW,CAAW;IAE9B,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA0B;IAEpE,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA4B;IAEtE,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;gBAE3C,OAAO,EAAE,YAAY;IAkFjC;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAK/C;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,SAAS,IAAI,KAAK,GAAG,SAAS;IAI9B,6BAA6B;IAC7B,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAIrC,iCAAiC;IACjC,kBAAkB,IAAI,cAAc,EAAE;IAItC,6CAA6C;IAC7C,2BAA2B,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAU5C,4CAA4C;IACtC,uBAAuB,CAAC,KAAK,EAAE;QACnC,gCAAgC;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,8BAA8B;QAC9B,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAUjC,sDAAsD;IACtD,OAAO,CAAC,iBAAiB;CAW1B"}

package/bin/agent/Agent.js

@@ -6,22 +6,34 @@
  * - Agent 直接持有自身状态与长期运行时对象，避免额外 Assembly 复制同一批字段。
  * - Session 集合由 `AgentSessions` 管理；长期运行状态由 `AgentState` 管理。
  */
-import { AgentContext } from "../agent/AgentContext.js";
+import { create_plugin_context } from "../plugin/core/PluginContext.js";
 import { Logger } from "../utils/logger/Logger.js";
-import { resolve_agent_env } from "../config/AgentEnv.js";
-import { normalizeInstructionInput } from "../agent/AgentInstructions.js";
+import { normalize_instruction_input } from "../agent/AgentInstructions.js";
 import { AgentSessions } from "../agent/AgentSessions.js";
 import { AgentState } from "../agent/AgentState.js";
-import { generateId } from "../utils/Id.js";
+import { generate_id } from "../utils/Id.js";
 import { PluginRegistry } from "../plugin/core/PluginRegistry.js";
+import { list_plugin_states } from "../plugin/core/PluginStateController.js";
+import { register_plugin_http_routes } from "../plugin/core/PluginHttpRoutes.js";
+import { resolve_session_system_messages, } from "../executor/composer/system/default/SystemDomain.js";
+const RESERVED_PLUGIN_TOOL_NAMES = new Set(["plugin_read", "plugin_call"]);
+/** 将一个来源明确的 Tool Set 注册到 Agent，并拒绝静默覆盖。 */
+function register_agent_tools(target, source, source_name) {
+    for (const [tool_name, tool_definition] of Object.entries(source)) {
+        if (Object.prototype.hasOwnProperty.call(target, tool_name)) {
+            throw new Error(`Agent tool name conflict: "${tool_name}" from ${source_name}`);
+        }
+        target[tool_name] = tool_definition;
+    }
+}
 /**
  * SDK 本地 Agent。
  */
 export class Agent {
     /** 当前 Agent 的稳定标识，用于区分 Session 存储目录与运行时归属。 */
     id;
-    /** 当前 Agent 绑定的项目根目录绝对路径。 */
-    path;
+    /** 当前 Agent 引用的项目资源与安全边界。 */
+    workspace;
     /** 当前 Agent 向所有 Session 提供的工具集合。 */
     tools;
     /** 当前 Agent 已装配的 Plugin 调用与注册入口。 */
@@ -39,75 +51,92 @@ export class Agent {
     /** 当前 Agent 独享的运行日志器。 */
     logger;
     /** 提供给 Plugin、Session 与宿主集成层共享的 Agent 执行上下文。 */
-    context;
-    /** 当前 Agent configured env 的可变共享对象。 */
-    env;
+    plugin_context;
     /** 调用方提供的自定义 Session 类；省略时使用 SDK 默认实现。 */
-    SessionClass;
+    session_class;
     /** 当前 Agent 的长期运行状态与生命周期。 */
     state;
-    /** 当前 Agent 可选的内建 Shell 实例。 */
-    shell;
     /** 当前 Agent configured instruction 的可变有序集合。 */
     instruction;
+    /** 取消 Workspace env 变化订阅的函数。 */
+    unsubscribe_workspace_env;
+    /** 取消 PluginRegistry 变化订阅的函数。 */
+    unsubscribe_plugin_change;
+    /** 当前由 PluginRegistry 注册到 Agent 的 Tool 名称。 */
+    plugin_tool_names = new Set();
     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;
+        if (!options.workspace)
+            throw new Error("Agent requires a Workspace");
+        this.workspace = options.workspace;
+        this.session_class = options.session_class;
         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.tools = {};
+        for (const tool_name of Object.keys(this.workspace.tools)) {
+            if (RESERVED_PLUGIN_TOOL_NAMES.has(tool_name)) {
+                throw new Error(`Agent tool name conflict: "${tool_name}" is reserved for PluginRegistry`);
+            }
         }
+        register_agent_tools(this.tools, this.workspace.tools, "WorkspaceTools");
+        this.sync_plugin_tools();
+        const custom_tools = options.tools && typeof options.tools === "object"
+            ? options.tools
+            : {};
+        for (const tool_name of Object.keys(custom_tools)) {
+            if (RESERVED_PLUGIN_TOOL_NAMES.has(tool_name)) {
+                throw new Error(`Agent tool name conflict: "${tool_name}" is reserved for PluginRegistry`);
+            }
+        }
+        register_agent_tools(this.tools, custom_tools, "AgentOptions.tools");
+        this.logger = new Logger();
+        this.logger.bind_workspace(this.workspace.files);
+        this.instruction = normalize_instruction_input(options.instruction);
+        const store = this.workspace.bind_agent(this.id);
         this.sessions = new AgentSessions({
             agent_id: this.id,
-            project_root: this.path,
+            workspace_path: this.workspace.path,
+            store,
             tools: this.tools,
             logger: this.logger,
             get_instruction: () => this.instruction,
-            get_agent_env: () => this.getEnv(),
+            get_workspace_env: () => this.workspace.get_env(),
             get_agent_plugins: () => this.plugins.execution_view(),
             ensure_agent_ready: async () => {
                 await this.ready();
             },
             get_agent_model: () => this.model,
-            SessionClass: this.SessionClass,
+            session_class: this.session_class,
         });
-        this.context = new AgentContext({
-            ...(this.shell ? { shell: this.shell } : {}),
+        this.plugin_context = create_plugin_context({
+            ...(this.workspace.shell ? { shell: this.workspace.shell } : {}),
             agent_id: this.id,
-            rootPath: this.path,
+            workspace_path: this.workspace.path,
+            files: this.workspace.files,
             logger: this.logger,
-            get_env: () => this.env,
-            get_systems: () => this.instruction,
+            get_workspace_env: () => this.workspace.get_env(),
+            get_instructions: () => this.instruction,
             sessions: this.sessions,
             plugins: this.plugins,
         });
+        this.unsubscribe_workspace_env = this.workspace.subscribe_env((env) => {
+            this.sessions.broadcast_env({ ...env }, generate_id());
+        });
+        this.unsubscribe_plugin_change = this.plugins.subscribe_change((change) => {
+            this.sync_plugin_tools();
+            const verb = change.type === "register" ? "registered" : "unregistered";
+            this.sessions.broadcast_plugins({
+                command_id: generate_id(),
+                title: `Agent plugin ${change.plugin_name} ${verb}`,
+                plugins: this.plugins.execution_view(),
+            });
+        });
         // 关键点（中文）：装配完成后创建唯一状态对象，并立即启动长期运行时。
         this.state = new AgentState({
-            context: this.context,
+            context: this.plugin_context,
             plugins: this.plugins,
-            sessions: this.sessions,
-            tools: this.tools,
-            shell: this.shell,
         });
     }
     /**
@@ -124,88 +153,83 @@ export class Agent {
      * 释放当前 Agent 持有的长期运行时对象。
      *
      * 关键点（中文）
-     * - 关闭 plugin lifecycle、ActionSchedule、shell 等 Agent 自有资源。
+     * - 关闭 plugin lifecycle 与 ActionSchedule 等 Agent 自有资源。
+     * - Workspace 与 Agent 一对一绑定，因此这里同时关闭 Shell 与 Sandbox。
      * - 不负责任何 transport（RPC / HTTP）；transport 由 `@downcity/server` 自行管理。
      */
     async dispose() {
-        await this.state.dispose();
+        this.unsubscribe_workspace_env();
+        this.unsubscribe_plugin_change();
+        try {
+            await this.state.dispose();
+        }
+        finally {
+            try {
+                await this.logger.save_all_logs();
+            }
+            finally {
+                await this.workspace.dispose();
+            }
+        }
     }
     /**
      * 更新当前 SDK Agent 的静态基础指令。
      */
-    setInstruction(input) {
-        const next_instruction = normalizeInstructionInput(input);
+    set_instruction(input) {
+        const next_instruction = normalize_instruction_input(input);
         this.instruction.splice(0, this.instruction.length, ...next_instruction);
     }
     /**
-     * 返回当前 agent env 的浅拷贝快照。
-     *
-     * 关键点（中文）
-     * - 返回的是拷贝，调用方修改它不会影响 agent 真实状态。
-     * - 想改 env 请使用 `setEnv` / `patchEnv`。
+     * 返回当前 agent 绑定的统一日志器。
      */
-    getEnv() {
-        return { ...this.env };
+    get_logger() {
+        return this.logger;
     }
     /**
-     * 整体覆盖 agent env。
-     *
-     * 关键点（中文）
-     * - 直接清空当前共享 env 对象，再写入新值，保证 plugin / runtime / shell 看到的是同一引用。
-     * - 仅写入字符串值，`null` / `undefined` 表示删除该 key。
+     * 返回当前 agent 挂载的 Shell。
      */
-    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());
+    get_shell() {
+        return this.workspace.shell;
     }
-    /**
-     * 增量合并 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());
+    /** 返回当前 Agent 已配置的静态指令快照。 */
+    get_instructions() {
+        return [...this.instruction];
     }
-    /**
-     * 原地应用一次 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 已注册的 Plugin 状态。 */
+    list_plugin_states() {
+        return list_plugin_states({ context: this.plugin_context });
     }
-    /**
-     * 返回当前 agent 绑定的统一日志器。
-     */
-    getLogger() {
-        return this.logger;
+    /** 把当前 Agent 已注册 Plugin 的 HTTP 路由装配到宿主应用。 */
+    register_plugin_http_routes(app) {
+        register_plugin_http_routes({
+            app,
+            get_context: () => this.plugin_context,
+            plugins: this.plugins.snapshots()
+                .map((snapshot) => this.plugins.get(snapshot.name))
+                .filter((plugin) => plugin !== null),
+        });
     }
-    /**
-     * 返回当前 agent context。
-     */
-    getContext() {
-        return this.context;
+    /** 解析指定 Session 当前可见的完整 system messages。 */
+    async resolve_system_messages(input) {
+        return await resolve_session_system_messages({
+            project_root: this.workspace.path,
+            session_id: input.session_id,
+            profile: input.profile || "chat",
+            static_system_prompts: [...this.instruction],
+            context: this.plugin_context,
+        });
     }
-    /**
-     * 返回当前 agent 挂载的 Shell。
-     */
-    getShell() {
-        return this.shell;
+    /** 将 PluginRegistry 当前 Tool Set 同步到 Agent 持有的工具集合。 */
+    sync_plugin_tools() {
+        for (const tool_name of this.plugin_tool_names) {
+            delete this.tools[tool_name];
+        }
+        this.plugin_tool_names.clear();
+        const plugin_tools = this.plugins.tools();
+        register_agent_tools(this.tools, plugin_tools, "PluginRegistry");
+        for (const tool_name of Object.keys(plugin_tools)) {
+            this.plugin_tool_names.add(tool_name);
+        }
     }
 }
 //# sourceMappingURL=Agent.js.map

package/bin/agent/Agent.js.map

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

package/bin/agent/AgentInstructions.d.ts

@@ -10,9 +10,9 @@ import type { AgentSessionSystemBlock } from "../types/agent/SessionTypes.js";
 /**
  * 归一化调用方传入的静态 instruction。
  */
-export declare function normalizeInstructionInput(input: string | string[] | undefined): string[];
+export declare function normalize_instruction_input(input: string | string[] | undefined): string[];
 /**
  * 构造进入 session system prompt 的 instruction block。
  */
-export declare function createInstructionSystemBlocks(instruction: string[], project_root: string): AgentSessionSystemBlock[];
+export declare function create_instruction_system_blocks(instruction: string[], project_root: string): AgentSessionSystemBlock[];
 //# sourceMappingURL=AgentInstructions.d.ts.map

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

@@ -1 +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"}
+{"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,2BAA2B,CACzC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GACnC,MAAM,EAAE,CASV;AAUD;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,EAAE,MAAM,GACnB,uBAAuB,EAAE,CAc3B"}

package/bin/agent/AgentInstructions.js

@@ -10,7 +10,7 @@ import { DEFAULT_SHIP_PROMPTS } from "../executor/composer/system/default/System
 /**
  * 归一化调用方传入的静态 instruction。
  */
-export function normalizeInstructionInput(input) {
+export function normalize_instruction_input(input) {
     const items = Array.isArray(input)
         ? input
         : typeof input === "string"
@@ -30,7 +30,7 @@ function createCoreInstructionContent(project_root) {
 /**
  * 构造进入 session system prompt 的 instruction block。
  */
-export function createInstructionSystemBlocks(instruction, project_root) {
+export function create_instruction_system_blocks(instruction, project_root) {
     const instruction_blocks = instruction.map((content, index) => ({
         source: "instruction",
         name: instruction.length === 1 ? "agent" : `agent:${index + 1}`,

package/bin/agent/AgentInstructions.js.map

@@ -1 +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"}
+{"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,2BAA2B,CACzC,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,gCAAgC,CAC9C,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"}