@downcity/agent 1.1.437 → 1.1.445

package/README.md

@@ -71,7 +71,7 @@ src/
 ├── index.ts               # 包公开入口
 ├── agent/                 # Agent facade、状态、模型、环境与执行绑定
 ├── group/                 # Group 主体、GroupSession 和消息调度策略
-├── executor/              # LLM/Tool Loop、usage 观测与执行恢复
+├── model/                 # 模型请求与 Tool Loop 内核、消息转换与 prompt 资产
 ├── host/                  # Agent 宿主端口
 ├── internal/              # Agent 与 Group 的内部运行时装配
 ├── plugin/                # Agent 使用的 Plugin 执行协议辅助
@@ -91,27 +91,34 @@ src/
   - `ExecutionBinding.ts` 负责 Agent 执行目标绑定
 
 - `src/session/`
-  - `Session.ts` 是公开 facade 与 Session 对象装配入口
-  - `SessionState.ts` 管理配置与 metadata
-  - `SessionLoop.ts` 是 Command Queue 的唯一消费者，并管理 Turn 生命周期
-  - Prompt Command 创建或加入 Turn；配置与压缩等 Maintenance Command 在空闲期独立执行
-  - `SessionComposition.ts` 管理 system snapshot、检查点 env/hook 与 Composer 输入
-  - `session.db` 是 canonical Message 唯一事实源，`SessionMessages.ts` 负责领域写入、恢复和有界运行态投影
-  - `DefaultSessionComposer.ts` 负责 system/history/tools，并默认使用 Part 级上下文策略
-  - `SessionTurnContext.effects` 只负责按发生顺序收集当前 Turn 的 Tool 副作用，不解释具体业务
-  - `messages/` 放 Assistant 状态转换与 writer、Message codec、Tool effect 投影与结构化文件编辑 Diff
-  - `composer/policies/` 放只读 canonical Message 并管理自有派生表的上下文策略
-  - `storage/` 负责 Session SQLite、附件和事务；只使用 AgentStorage，不访问项目 Workspace
+  - 目录分两类：执行链（`loop` → `input` → `runner`）与支撑层（`messages`、`storage`）
+  - `Session.ts` 是公开 facade 与 Session 对象装配入口（顶层）
+  - `loop/` 轮次编排：`SessionLoop`（队列消费与 Turn 生命周期）、`SessionQueue`、
+    `SessionTurnContext`、`SessionTurnCompletion`、`SessionTurnFileDiff`，以及驱动它
+    所需的跨轮配置状态（`SessionState`、`SessionTitle`、`SessionTitleTask`）
+  - `input/` 组装模型输入：`StepInput`（每步输入与冻结 system）、`SessionSystem`、
+    `SessionHooks`、`SessionHookPoints`，以及 `composer/`（Composer 实现、组装原语、
+    压缩算法与 checkpoint 表读写）
+  - `runner/` 发请求与跑工具：`SessionExecutor` 及上限、决策、诊断、错误归一、
+    usage 阈值与上下文重试等纯逻辑
+  - `messages/` 消息领域：`SessionMessages` 领域入口、Assistant 状态转换与 writer、
+    Message codec、Tool effect 投影、文件 Diff、Mutation 广播、用户交互、时间线投影
+    （见目录 README）
+  - `storage/` 持久化与列表读取：Session SQLite、codec、schema、本地存储、附件，
+    以及 `Browse`（列表页轻量状态）与 `SessionMessagePreview`；只使用 AgentStorage，
+    不访问项目 Workspace
+  - `session.db` 是 canonical Message 唯一事实源
   - Session 由 `AgentSessions` 统一持有；Workspace 只作为 `agent.sessions.create({ workspace })` 或 `agent.sessions.get(session_id, origin_type, { workspace })` 的单次执行输入
 
 - `src/group/`
   - `storage/` 负责 GroupSession 的 metadata、共享消息和调度记录持久化
 
-- `src/executor/`
-  - 内部执行内核
-  - `Executor` 只负责单轮 LLM/Tool Loop、Step 状态和上下文恢复
-  - 不持有 History Store，不负责 Message 或 metadata 持久化
-  - 默认 system block 只由 `session/SessionSystem.ts` 组装，不维护第二套 system composer
+- `src/model/`
+  - 模型协议与 Provider 请求的低层内核，不持有 History Store，也不负责 Message 或 metadata 持久化
+  - `ModelStepRunner` / `ModelRequestRunner` 负责单步模型请求与重试；`ModelGenerate` 是共享的一次性生成入口
+  - `messages/` 负责 Session Message 与 Model Protocol 之间的转换
+  - `prompts/` 放默认 core system prompt 资产及相关生成模块
+  - 模型请求与 Tool Loop 的执行编排在 `session/runner/`；模型输入组装在 `session/input/`
 
 - `src/plugin/`
   - 只保留 Agent 公开的 Action schedule 与 Plugin 协议辅助
@@ -125,7 +132,7 @@ src/
   - 跨模块、跨包共享协议类型
   - `config/` 放 LLM、execution binding、plugin 配置、start options 等宿主配置契约
   - `runtime/` 放 auth、agent、host、platform 等运行时与控制面共享协议
-  - 领域内部类型仍保留在对应领域目录，例如 `plugin/types/`、`executor/types/`
+  - 领域内部类型统一放在 `types/` 下的领域目录，例如 `types/session/`、`types/turn/`；实现目录不再自建 `types/` 子目录
 
 - `src/utils/`
   - 包内通用工具、日志、CLI 输出与存储辅助

package/bin/agent/Agent.d.ts

@@ -3,14 +3,14 @@
  *
  * 职责说明（中文）
  * - Agent 不绑定 Workspace；调用方通过 `agent.sessions.create({ workspace })` 选择本次执行环境。
- * - Plugin 与 Transport 由 City 持有，Agent 只通过 CityRuntime 使用最小执行能力。
+ * - 能力与 Transport 由容器持有，Agent 只收下容器在绑定时推送的能力，不持有容器引用。
  * - Session 由 AgentSessions 统一持有；Workspace 只在单个 Session 创建时提供执行资源。
  */
-import type { CityRuntime, ModelClient, RuntimeTool as Tool, WorkspaceRuntime } from "@downcity/type";
+import type { CityRuntime, ModelClient, AgentTool as Tool, WorkspaceRuntime } from "@downcity/type";
 import type { AgentOptions, AgentSessionConstructor } from "../types/agent/AgentOptions.js";
 import type { AgentSessionCollection } from "../types/agent/AgentSessionCollection.js";
 import { Logger } from "../utils/logger/Logger.js";
-import type { SessionSystemMessage } from "../executor/types/SessionPrompts.js";
+import type { SessionSystemMessage } from "@downcity/type";
 import type { SessionComposer } from "../types/session/SessionComposer.js";
 /** SDK Agent 主体。 */
 export declare class Agent {
@@ -28,24 +28,24 @@ export declare class Agent {
     readonly custom_tools: Record<string, Tool>;
     /** Agent 使用的 Session 类。 */
     readonly session_class?: AgentSessionConstructor;
-    /** 为每个 Session 创建独立 Composer 的工厂。 */
-    readonly session_composer?: () => SessionComposer;
+    /** 当前 Agent 使用的 Session Composer；其所有 Session 共享该实例。 */
+    readonly session_composer?: SessionComposer;
     /** Agent 级日志器，不绑定任何 Workspace。 */
     private readonly logger;
     /** 当前 Agent configured instruction。 */
     private readonly instruction;
+    /** Agent 自有检查点处理器；与容器提供的 Power hooks 合并使用。 */
+    private readonly custom_hooks;
     /** Agent 释放状态。 */
     private dispose_promise?;
     /** Agent 唯一的 Session 集合。 */
     private readonly session_manager;
-    /** 未加入宿主时使用的隔离进程内存储。 */
+    /** 未加入容器时使用的隔离进程内存储。 */
     private storage_provider;
-    /** Agent 当前所属的唯一 City；独立运行时为空。 */
-    private city?;
+    /** 当前绑定的容器运行环境；独立运行时为空。 */
+    private host?;
     /** 延迟创建的 Agent 私有持久化视图。 */
     private agent_storage?;
-    /** 是否已经在无宿主存储中创建或恢复过 Session。 */
-    private memory_session_started;
     constructor(options: AgentOptions);
     /** 更新 Agent 的静态基础指令。 */
     set_instruction(input: string | string[]): void;
@@ -53,10 +53,22 @@ export declare class Agent {
     get_instructions(): readonly string[];
     /** 返回 Agent 级日志器。 */
     get_logger(): Logger;
-    /** 将 Agent 加入 City；必须在创建或恢复 Session 前完成。 */
-    attach(city: CityRuntime): void;
-    /** 解除指定 City 关系；其他 City 不能解除当前绑定。 */
-    detach(city: CityRuntime): void;
+    /**
+     * 绑定容器运行环境；必须在创建或恢复 Session 前完成。
+     *
+     * 关键点（中文）
+     * - 主体只收下容器推送的存储能力，不持有容器引用。
+     * - 存储一旦在独立模式下被使用就不能再切换，否则已有 Session 会写入两个事实源。
+     */
+    bind(host: CityRuntime): void;
+    /**
+     * 解除容器绑定，主体回到独立运行状态。
+     *
+     * 关键点（中文）
+     * - 由容器在放下引用后调用；主体不反向通知容器。
+     * - 已解析的存储视图同时丢弃，避免解绑后继续写旧容器存储。
+     */
+    unbind(): void;
     /** 停止绑定到指定 Workspace 的运行中 Session，并释放后台标题任务。 */
     release_workspace(workspace_id: string): Promise<void>;
     /** 解析指定 Workspace 下一个 Session 当前可见的 system messages。 */
@@ -64,15 +76,27 @@ export declare class Agent {
         /** 目标 Session 稳定标识。 */
         session_id: string;
     }): Promise<SessionSystemMessage[]>;
-    /** 释放 Agent 的 Session 后台任务、存储与宿主引用。 */
+    /** 构造不属任何 Turn 的调用环境；用于 system 查询。 */
+    private create_session_call_context;
+    /**
+     * 释放 Agent 的 Session 后台任务、存储与运行环境。
+     *
+     * 关键点（中文）
+     * - 已绑定的 Agent 不能自行释放：容器仍持有引用，必须走 `city.agents.remove(id)`。
+     * - 这把「已注册主体不能自行释放」变成可检查的不变量，而不是靠时序掩盖。
+     */
     dispose(): Promise<void>;
-    /** 等待 Agent 自身运行时 ready，供内部运行时使用。 */
-    ensure_ready(): Promise<void>;
     /** 获取或创建 Agent 唯一的 Session 存储。 */
     private resolve_storage;
-    /** 校验宿主模式下使用的 Workspace 来自当前宿主事实源。 */
-    private assert_workspace;
-    /** 在明确检查点合并 Workspace、宿主扩展和 Agent Tool。 */
+    /**
+     * 返回当前生效的工具集合：Workspace 工具 + 容器 Power 工具 + Agent 自有工具。
+     *
+     * 关键点（中文）
+     * - 容器 Power 工具从环境句柄实时读取，不缓存；容器增删 Power 后下一次求值即生效。
+     * - 静态 Workspace Tool 与 Agent Tool 的命名冲突属于 Session 创建不变量，装配时立即失败。
+     */
     private resolve_tools;
+    /** 合并容器 Power hooks 与 Agent 自有 hooks。 */
+    private resolve_hooks;
 }
 //# 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,EACV,WAAW,EACX,WAAW,EACX,WAAW,IAAI,IAAI,EAEnB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,sBAAsB,EACvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAMlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAQ1E,oBAAoB;AACpB,qBAAa,KAAK;IAChB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAE7B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAE1C,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5C,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IAEjD,qCAAqC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,eAAe,CAAC;IAElD,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IAEvC,kBAAkB;IAClB,OAAO,CAAC,eAAe,CAAC,CAAgB;IAExC,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAEhD,wBAAwB;IACxB,OAAO,CAAC,gBAAgB,CAAqD;IAE7E,kCAAkC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAc;IAE3B,2BAA2B;IAC3B,OAAO,CAAC,aAAa,CAAC,CAAe;IAErC,iCAAiC;IACjC,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,OAAO,EAAE,YAAY;IAoDjC,wBAAwB;IACxB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAK/C,qBAAqB;IACrB,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAIrC,qBAAqB;IACrB,UAAU,IAAI,MAAM;IAIpB,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAe/B,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI/B,gDAAgD;IAC1C,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D,wDAAwD;IAClD,uBAAuB,CAC3B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE;QACL,uBAAuB;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAqClC,uCAAuC;IACjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B,qCAAqC;IAC/B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,kCAAkC;IAClC,OAAO,CAAC,eAAe;IAkBvB,sCAAsC;IACtC,OAAO,CAAC,gBAAgB;IAQxB,2CAA2C;IAC3C,OAAO,CAAC,aAAa;CAYtB"}
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/agent/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,SAAS,IAAI,IAAI,EAIjB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,sBAAsB,EACvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAMlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAQ1E,oBAAoB;AACpB,qBAAa,KAAK;IAChB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAE7B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAE1C,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5C,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IAEjD,uDAAuD;IACvD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IAE5C,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IAEvC,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAE3C,kBAAkB;IAClB,OAAO,CAAC,eAAe,CAAC,CAAgB;IAExC,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAEhD,wBAAwB;IACxB,OAAO,CAAC,gBAAgB,CAAqD;IAE7E,2BAA2B;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAc;IAE3B,2BAA2B;IAC3B,OAAO,CAAC,aAAa,CAAC,CAAe;gBAEzB,OAAO,EAAE,YAAY;IAmDjC,wBAAwB;IACxB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAK/C,qBAAqB;IACrB,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAIrC,qBAAqB;IACrB,UAAU,IAAI,MAAM;IAIpB;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAc7B;;;;;;OAMG;IACH,MAAM,IAAI,IAAI;IAMd,gDAAgD;IAC1C,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D,wDAAwD;IAClD,uBAAuB,CAC3B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE;QACL,uBAAuB;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAiClC,sCAAsC;IACtC,OAAO,CAAC,2BAA2B;IAuBnC;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB9B,kCAAkC;IAClC,OAAO,CAAC,eAAe;IAkBvB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAQrB,yCAAyC;IACzC,OAAO,CAAC,aAAa;CAOtB"}

package/bin/agent/Agent.js

@@ -3,7 +3,7 @@
  *
  * 职责说明（中文）
  * - Agent 不绑定 Workspace；调用方通过 `agent.sessions.create({ workspace })` 选择本次执行环境。
- * - Plugin 与 Transport 由 City 持有，Agent 只通过 CityRuntime 使用最小执行能力。
+ * - 能力与 Transport 由容器持有，Agent 只收下容器在绑定时推送的能力，不持有容器引用。
  * - Session 由 AgentSessions 统一持有；Workspace 只在单个 Session 创建时提供执行资源。
  */
 import { create_instruction_system_blocks, normalize_instruction_input, } from "../agent/AgentInstructions.js";
@@ -11,9 +11,8 @@ import { Logger } from "../utils/logger/Logger.js";
 import { AgentSessions } from "../agent/AgentSessions.js";
 import { AgentMemoryStorageProvider } from "../agent/AgentMemoryStorage.js";
 import { LocalSessionStore } from "../session/storage/LocalSessionStore.js";
-import { EMPTY_SESSION_HOOKS } from "../session/SessionHooks.js";
-import { build_session_system_blocks, resolve_session_plugin_system_blocks, } from "../session/SessionSystem.js";
-import { create_session_hook_context } from "../session/runtime/SessionTurnContext.js";
+import { EMPTY_TOOL_HOOK_SET } from "@downcity/type";
+import { build_session_system_blocks, resolve_session_power_system_blocks, } from "../session/input/SessionSystem.js";
 import { resolve_system_timezone } from "../session/storage/Metadata.js";
 /** SDK Agent 主体。 */
 export class Agent {
@@ -31,24 +30,24 @@ export class Agent {
     custom_tools;
     /** Agent 使用的 Session 类。 */
     session_class;
-    /** 为每个 Session 创建独立 Composer 的工厂。 */
+    /** 当前 Agent 使用的 Session Composer；其所有 Session 共享该实例。 */
     session_composer;
     /** Agent 级日志器，不绑定任何 Workspace。 */
     logger = new Logger();
     /** 当前 Agent configured instruction。 */
     instruction;
+    /** Agent 自有检查点处理器；与容器提供的 Power hooks 合并使用。 */
+    custom_hooks;
     /** Agent 释放状态。 */
     dispose_promise;
     /** Agent 唯一的 Session 集合。 */
     session_manager;
-    /** 未加入宿主时使用的隔离进程内存储。 */
+    /** 未加入容器时使用的隔离进程内存储。 */
     storage_provider = new AgentMemoryStorageProvider();
-    /** Agent 当前所属的唯一 City；独立运行时为空。 */
-    city;
+    /** 当前绑定的容器运行环境；独立运行时为空。 */
+    host;
     /** 延迟创建的 Agent 私有持久化视图。 */
     agent_storage;
-    /** 是否已经在无宿主存储中创建或恢复过 Session。 */
-    memory_session_started = false;
     constructor(options) {
         this.id = String(options.id || "").trim();
         if (!this.id)
@@ -62,30 +61,28 @@ export class Agent {
         this.custom_tools = options.tools && typeof options.tools === "object"
             ? { ...options.tools }
             : {};
+        this.custom_hooks = options.hooks ?? EMPTY_TOOL_HOOK_SET;
         this.session_manager = new AgentSessions({
             agent_id: this.id,
+            agent_name: this.name,
+            agent_description: this.description,
             logger: this.logger,
             get_instruction: () => [...this.get_instructions()],
-            ensure_agent_ready: async () => await this.ensure_ready(),
             get_agent_model: () => this.model,
             session_class: this.session_class,
-            create_session_composer: this.session_composer,
-            on_session_routed: () => {
-                if (!this.city)
-                    this.memory_session_started = true;
-            },
+            session_composer: this.session_composer,
             resolve_session_context: (workspace) => {
                 const storage = this.resolve_storage();
                 if (!workspace)
                     return {
                         workspace_path: ".",
                         logger: this.logger,
-                        get_tools: () => ({ ...this.custom_tools }),
+                        get_tools: () => this.resolve_tools(),
                         get_workspace_env: () => ({}),
-                        get_hooks: () => EMPTY_SESSION_HOOKS,
+                        get_workspace: () => undefined,
+                        get_hooks: () => this.resolve_hooks(),
                         store: storage.sessions,
                     };
-                this.assert_workspace(workspace);
                 // 静态 Workspace Tool 与 Agent Tool 的命名冲突属于 Session 创建不变量，
                 // 在装配时立即失败；执行时仍通过 getter 读取最新宿主扩展。
                 this.resolve_tools(workspace);
@@ -95,8 +92,8 @@ export class Agent {
                     logger: this.logger,
                     get_tools: () => this.resolve_tools(workspace),
                     get_workspace_env: () => workspace.get_env(),
-                    get_hooks: () => this.city?.get_session_hooks(this.id, workspace)
-                        ?? EMPTY_SESSION_HOOKS,
+                    get_workspace: () => workspace,
+                    get_hooks: () => this.resolve_hooks(),
                     store: storage.sessions,
                 };
             },
@@ -116,25 +113,36 @@ export class Agent {
     get_logger() {
         return this.logger;
     }
-    /** 将 Agent 加入 City；必须在创建或恢复 Session 前完成。 */
-    attach(city) {
-        if (this.dispose_promise)
-            throw new Error(`Agent "${this.id}" is disposing`);
-        if (this.city) {
-            if (this.city === city)
+    /**
+     * 绑定容器运行环境；必须在创建或恢复 Session 前完成。
+     *
+     * 关键点（中文）
+     * - 主体只收下容器推送的存储能力，不持有容器引用。
+     * - 存储一旦在独立模式下被使用就不能再切换，否则已有 Session 会写入两个事实源。
+     */
+    bind(host) {
+        if (this.host) {
+            if (this.host === host)
                 return;
-            throw new Error(`Agent "${this.id}" already belongs to another City`);
+            throw new Error(`Agent "${this.id}" is already bound to another container`);
         }
-        if (this.memory_session_started || this.agent_storage) {
-            throw new Error(`Agent "${this.id}" already used standalone storage; attach it before using Sessions`);
+        if (this.agent_storage) {
+            throw new Error(`Agent "${this.id}" already used standalone storage; bind it before using Sessions`);
         }
-        this.city = city;
-        this.storage_provider = city.storage;
+        this.host = host;
+        this.storage_provider = host.storage;
     }
-    /** 解除指定 City 关系；其他 City 不能解除当前绑定。 */
-    detach(city) {
-        if (this.city === city)
-            this.city = undefined;
+    /**
+     * 解除容器绑定，主体回到独立运行状态。
+     *
+     * 关键点（中文）
+     * - 由容器在放下引用后调用；主体不反向通知容器。
+     * - 已解析的存储视图同时丢弃，避免解绑后继续写旧容器存储。
+     */
+    unbind() {
+        this.host = undefined;
+        this.storage_provider = new AgentMemoryStorageProvider();
+        this.agent_storage = undefined;
     }
     /** 停止绑定到指定 Workspace 的运行中 Session，并释放后台标题任务。 */
     async release_workspace(workspace_id) {
@@ -143,25 +151,25 @@ export class Agent {
     }
     /** 解析指定 Workspace 下一个 Session 当前可见的 system messages。 */
     async resolve_system_messages(workspace, input) {
-        this.assert_workspace(workspace);
         const session_id = String(input.session_id || "").trim();
         if (!session_id) {
             throw new Error("resolve_system_messages requires a non-empty session_id");
         }
-        const instruction_system_blocks = create_instruction_system_blocks([...this.get_instructions()], workspace.path);
-        const hooks = this.city?.get_session_hooks(this.id, workspace)
-            ?? EMPTY_SESSION_HOOKS;
-        const hook_context = create_session_hook_context({
+        const instruction_system_blocks = create_instruction_system_blocks({
+            agent_id: this.id,
+            agent_name: this.name,
+            instruction: [...this.get_instructions()],
+        });
+        const hooks = this.resolve_hooks();
+        const context = this.create_session_call_context({
             session_id,
-            session_origin: { type: "chat" },
-            project_root: workspace.path,
-            workspace_env: Object.freeze({ ...workspace.get_env() }),
-            agent_systems: instruction_system_blocks.map((block) => block.content),
+            workspace,
+            instruction_system_blocks,
         });
-        const plugin_system_blocks = await resolve_session_plugin_system_blocks({
+        const power_system_blocks = await resolve_session_power_system_blocks({
             session_id,
             hooks,
-            context: hook_context,
+            context,
         });
         const blocks = await build_session_system_blocks({
             agent_id: this.id,
@@ -170,36 +178,51 @@ export class Agent {
             created_at: Date.now(),
             timezone: resolve_system_timezone(),
             get_instruction_system_blocks: () => instruction_system_blocks,
-            get_managed_plugin_system_blocks: async () => [],
-            get_plugin_system_blocks: async () => plugin_system_blocks,
+            get_power_system_blocks: async () => power_system_blocks,
         });
         return blocks.map((block) => ({ role: "system", content: block.content }));
     }
-    /** 释放 Agent 的 Session 后台任务、存储与宿主引用。 */
+    /** 构造不属任何 Turn 的调用环境；用于 system 查询。 */
+    create_session_call_context(input) {
+        return Object.freeze({
+            agent_id: this.id,
+            agent_name: this.name,
+            agent_description: this.description,
+            agent_instructions: Object.freeze(input.instruction_system_blocks.map((block) => block.content)),
+            session_id: input.session_id,
+            session_origin: { type: "chat" },
+            workspace: input.workspace,
+            messages: Object.freeze([]),
+            workspace_env: Object.freeze({ ...input.workspace.get_env() }),
+        });
+    }
+    /**
+     * 释放 Agent 的 Session 后台任务、存储与运行环境。
+     *
+     * 关键点（中文）
+     * - 已绑定的 Agent 不能自行释放：容器仍持有引用，必须走 `city.agents.remove(id)`。
+     * - 这把「已注册主体不能自行释放」变成可检查的不变量，而不是靠时序掩盖。
+     */
     async dispose() {
+        if (this.host) {
+            throw new Error(`Agent "${this.id}" is bound to a container; release it with city.agents.remove(id)`);
+        }
         this.dispose_promise ??= (async () => {
             const results = await Promise.allSettled([
                 this.session_manager.stop_executing_sessions(),
             ]);
             this.session_manager.dispose_title_generation();
-            const city = this.city;
             results.push(...await Promise.allSettled([
-                city?.release_agent(this) ?? Promise.resolve(),
                 this.agent_storage?.sessions.dispose() ?? Promise.resolve(),
                 this.logger.save_all_logs(),
             ]));
             const errors = results.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
-            this.city = undefined;
             this.agent_storage = undefined;
             if (errors.length > 0)
                 throw new AggregateError(errors, "Agent dispose failed");
         })();
         await this.dispose_promise;
     }
-    /** 等待 Agent 自身运行时 ready，供内部运行时使用。 */
-    async ensure_ready() {
-        await this.city?.ensure_ready();
-    }
     /** 获取或创建 Agent 唯一的 Session 存储。 */
     resolve_storage() {
         if (this.agent_storage)
@@ -219,23 +242,45 @@ export class Agent {
         };
         return this.agent_storage;
     }
-    /** 校验宿主模式下使用的 Workspace 来自当前宿主事实源。 */
-    assert_workspace(workspace) {
-        const workspace_id = String(workspace?.id || "").trim();
-        if (!workspace_id)
-            throw new Error("Agent sessions require a Workspace with a stable id");
-        if (this.city && this.city.workspaces.get(workspace_id) !== workspace) {
-            throw new Error(`Workspace "${workspace_id}" does not belong to the Agent City`);
-        }
-    }
-    /** 在明确检查点合并 Workspace、宿主扩展和 Agent Tool。 */
+    /**
+     * 返回当前生效的工具集合：Workspace 工具 + 容器 Power 工具 + Agent 自有工具。
+     *
+     * 关键点（中文）
+     * - 容器 Power 工具从环境句柄实时读取，不缓存；容器增删 Power 后下一次求值即生效。
+     * - 静态 Workspace Tool 与 Agent Tool 的命名冲突属于 Session 创建不变量，装配时立即失败。
+     */
     resolve_tools(workspace) {
         const tools = {};
-        register_tools(tools, workspace.tools, "WorkspaceTools");
-        register_tools(tools, this.city?.get_session_tools(this.id, workspace) ?? {}, "City");
+        if (workspace)
+            register_tools(tools, workspace.tools, "WorkspaceTools");
+        register_tools(tools, this.host?.power_tools ?? {}, "Power");
         register_tools(tools, this.custom_tools, "AgentOptions.tools");
         return tools;
     }
+    /** 合并容器 Power hooks 与 Agent 自有 hooks。 */
+    resolve_hooks() {
+        const power_hooks = this.host?.power_hooks;
+        if (!power_hooks)
+            return this.custom_hooks;
+        if (this.custom_hooks === EMPTY_TOOL_HOOK_SET)
+            return power_hooks;
+        return merge_tool_hook_sets(power_hooks, this.custom_hooks);
+    }
+}
+/** 按检查点合并两组 hooks；同名检查点按容器在前、自有在后的顺序拼接。 */
+function merge_tool_hook_sets(base, extra) {
+    const merge_points = (left, right) => {
+        const merged = { ...left };
+        for (const [point_name, handlers] of Object.entries(right)) {
+            merged[point_name] = [...(merged[point_name] ?? []), ...handlers];
+        }
+        return merged;
+    };
+    return {
+        pipeline: merge_points(base.pipeline, extra.pipeline),
+        guard: merge_points(base.guard, extra.guard),
+        effect: merge_points(base.effect, extra.effect),
+    };
 }
 /** 注册 Tool 集合，并拒绝不同来源静默覆盖。 */
 function register_tools(target, source, source_name) {

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

@@ -2,17 +2,31 @@
  * Agent instruction 组装工具。
  *
  * 关键点（中文）
- * - 这里只处理静态 instruction 与默认 core prompt。
- * - instruction 永远在 core 前面；core 不会被调用方 instruction 替代。
- * - 不读取 Session、Plugin 或 runtime 状态，保持为纯函数。
+ * - 这里只处理 Agent 身份、静态 instruction 与默认 core prompt。
+ * - 顺序固定为 identity → instruction → core；core 不会被调用方 instruction 替代。
+ * - identity 与 core 都由 SDK 注入，调用方 instruction 只决定中间一段。
+ * - 不读取 Session、Power 或 runtime 状态，保持为纯函数。
  */
 import type { AgentSessionSystemBlock } from "../types/agent/SessionTypes.js";
+/** 构造 instruction system block 所需的 Agent 身份与调用方指令。 */
+export interface CreateInstructionSystemBlocksInput {
+    /** 当前 Agent 的稳定标识。 */
+    agent_id: string;
+    /** 当前 Agent 的用户可见名称；为空时回退到 agent_id。 */
+    agent_name: string;
+    /** 调用方传入的静态 instruction，应已由 `normalize_instruction_input` 归一化。 */
+    instruction: readonly string[];
+}
 /**
  * 归一化调用方传入的静态 instruction。
  */
 export declare function normalize_instruction_input(input: string | string[] | undefined): string[];
 /**
  * 构造进入 session system prompt 的 instruction block。
+ *
+ * 关键点（中文）
+ * - 顺序为 identity → instruction → core。
+ * - identity 复用 `instruction` 来源，但块名独立为 `identity`，便于消费端区分。
  */
-export declare function create_instruction_system_blocks(instruction: string[], project_root: string): AgentSessionSystemBlock[];
+export declare function create_instruction_system_blocks(input: CreateInstructionSystemBlocksInput): 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,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"}
+{"version":3,"file":"AgentInstructions.d.ts","sourceRoot":"","sources":["../../src/agent/AgentInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,sDAAsD;AACtD,MAAM,WAAW,kCAAkC;IACjD,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GACnC,MAAM,EAAE,CASV;AAwBD;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,kCAAkC,GACxC,uBAAuB,EAAE,CAmB3B"}