@downcity/agent 1.1.237 → 1.1.258

package/bin/types/session/SessionQueue.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Session 输入队列类型。
+ *
+ * 队列只保存明确的输入事实，不保存可执行闭包。SessionTurn 是这些输入的唯一解释者。
+ */
+import type { AgentSessionConfigSnapshot, AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
+import type { AgentPluginExecutionRuntime } from "../../types/plugin/PluginRuntime.js";
+import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
+/** Session 模型配置在 Step 检查点生效的命令。 */
+export interface SessionModelQueueCommand {
+    /** 命令种类固定为 Session 模型更新。 */
+    type: "session_model";
+    /** 当前命令的稳定唯一标识。 */
+    command_id: string;
+    /** 等待提交为 effective state 的完整 Session 配置。 */
+    config: AgentSessionConfigSnapshot;
+    /** 配置生效后需要写入的可选 Action 标识。 */
+    action_id?: string;
+    /** 配置生效后需要写入的可选 Action 标题。 */
+    action_title?: string;
+}
+/** Agent instruction 在 Session Step 检查点生效的命令。 */
+export interface SessionInstructionQueueCommand {
+    /** 命令种类固定为 Agent instruction 更新。 */
+    type: "agent_instruction";
+    /** 当前命令的稳定唯一标识。 */
+    command_id: string;
+    /** 下一 Step 使用的完整 instruction blocks。 */
+    instruction_blocks: AgentSessionSystemBlock[];
+}
+/** Agent env 在 Session Step 检查点生效的命令。 */
+export interface SessionEnvQueueCommand {
+    /** 命令种类固定为 Agent env 更新。 */
+    type: "agent_env";
+    /** 当前命令的稳定唯一标识。 */
+    command_id: string;
+    /** 下一 Step 使用的完整环境变量快照。 */
+    env: Record<string, string>;
+}
+/** Agent Plugin 视图在 Session Step 检查点生效的命令。 */
+export interface SessionPluginsQueueCommand {
+    /** 命令种类固定为 Agent Plugin 更新。 */
+    type: "agent_plugins";
+    /** 当前命令的稳定唯一标识。 */
+    command_id: string;
+    /** 当前 Plugin 修改的用户可读标题。 */
+    title: string;
+    /** 下一 Step 使用的 Plugin 执行视图。 */
+    plugins: AgentPluginExecutionRuntime;
+}
+/** 显式持久化历史压缩命令。 */
+export interface SessionCompactQueueCommand {
+    /** 命令种类固定为 compact。 */
+    type: "compact";
+    /** 当前命令的稳定唯一标识。 */
+    command_id: string;
+}
+/** Session FIFO 中允许出现的领域命令。 */
+export type SessionQueueCommand = SessionModelQueueCommand | SessionInstructionQueueCommand | SessionEnvQueueCommand | SessionPluginsQueueCommand | SessionCompactQueueCommand;
+/** Agent configured state 广播给既有 Session 的输入。 */
+export type AgentSessionCommand = {
+    /** 当前修改固定为 instruction。 */
+    type: "instruction";
+    /** 当前命令唯一标识。 */
+    command_id: string;
+    /** 下一 Session Step 使用的 instruction blocks。 */
+    instruction_blocks: AgentSessionSystemBlock[];
+} | {
+    /** 当前修改固定为 env。 */
+    type: "env";
+    /** 当前命令唯一标识。 */
+    command_id: string;
+    /** 下一 Session Step 使用的完整 Agent env。 */
+    env: Record<string, string>;
+} | {
+    /** 当前修改固定为 plugins。 */
+    type: "plugins";
+    /** 当前命令唯一标识。 */
+    command_id: string;
+    /** 当前 Plugin 修改的用户可读标题。 */
+    title: string;
+    /** 下一 Session Step 使用的 Plugin 执行视图。 */
+    plugins: AgentPluginExecutionRuntime;
+};
+/** Promise 的显式兑现控制器。 */
+export interface SessionQueueDeferred<T> {
+    /** 调用方等待的 Promise。 */
+    promise: Promise<T>;
+    /** 成功兑现 Promise。 */
+    resolve: (value: T) => void;
+}
+/** FIFO 中等待创建或并入 Turn 的 Prompt。 */
+export interface SessionQueuedPrompt {
+    /** 队列项种类固定为 prompt。 */
+    type: "prompt";
+    /** 当前 Prompt 的结构化输入。 */
+    input: AgentSessionPromptInput;
+    /** 等待 SessionTurn 返回 Turn Handle 的控制器。 */
+    deferred_handle: SessionQueueDeferred<AgentSessionTurnHandle>;
+}
+/** Session FIFO 中的全部输入类型。 */
+export type SessionQueueItem = SessionQueuedPrompt | SessionQueueCommand;
+//# sourceMappingURL=SessionQueue.d.ts.map

package/bin/types/session/SessionQueue.d.ts.map

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

package/bin/types/session/SessionQueue.js

@@ -0,0 +1,7 @@
+/**
+ * Session 输入队列类型。
+ *
+ * 队列只保存明确的输入事实，不保存可执行闭包。SessionTurn 是这些输入的唯一解释者。
+ */
+export {};
+//# sourceMappingURL=SessionQueue.js.map

package/bin/types/session/SessionQueue.js.map

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

package/bin/types/session/SessionState.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SessionState 构造与配置变更类型。
+ *
+ * 这些类型只描述 Session 配置和 Metadata 状态，不承载 Message 行为。
+ */
+import type { LanguageModel } from "ai";
+import type { SessionMessages } from "../../session/SessionMessages.js";
+import type { SessionLocalState } from "../../types/session/SessionLocalState.js";
+import type { SessionMutation } from "../../types/session/SessionMutation.js";
+import type { SessionQueueCommand } from "../../types/session/SessionQueue.js";
+import type { Logger } from "../../utils/logger/Logger.js";
+/** SessionState 构造参数。 */
+export interface SessionStateOptions {
+    /** 当前 Agent 的稳定标识。 */
+    agent_id: string;
+    /** 当前项目的绝对根目录。 */
+    project_root: string;
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Session 的 canonical Message 入口。 */
+    messages: SessionMessages;
+    /** 当前 Session 的可变内存状态。 */
+    state: SessionLocalState;
+    /** 当前 Session 的运行日志器。 */
+    logger: Logger;
+    /** 在执行前补齐宿主级配置的异步钩子。 */
+    ensure_configured_hook?: () => Promise<void>;
+    /** 按 Session 优先、Agent 兜底规则读取当前模型。 */
+    get_model: () => LanguageModel | undefined;
+    /** 发布 Session Mutation 的函数。 */
+    publish_event: (mutation: SessionMutation) => void;
+}
+/** Session 配置写入选项。 */
+export interface SessionSetOptions {
+    /** 是否为本次配置变化生成 Model Switching Action。 */
+    emit_action?: boolean;
+}
+/** Session 配置成功写入后的队列提交结果。 */
+export interface SessionConfiguredCommandResult {
+    /** 等待在下一 Session Step 检查点执行的 Command。 */
+    command?: SessionQueueCommand;
+}
+//# sourceMappingURL=SessionState.d.ts.map

package/bin/types/session/SessionState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,yBAAyB;AACzB,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,iBAAiB,CAAC;IACzB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,qCAAqC;IACrC,SAAS,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;IAC3C,+BAA+B;IAC/B,aAAa,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAED,sBAAsB;AACtB,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,8BAA8B;AAC9B,MAAM,WAAW,8BAA8B;IAC7C,yCAAyC;IACzC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B"}

package/bin/types/session/SessionState.js

@@ -0,0 +1,7 @@
+/**
+ * SessionState 构造与配置变更类型。
+ *
+ * 这些类型只描述 Session 配置和 Metadata 状态，不承载 Message 行为。
+ */
+export {};
+//# sourceMappingURL=SessionState.js.map

package/bin/types/session/SessionState.js.map

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

package/bin/types/session/SessionSystem.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Session System Block 组装类型。
+ *
+ * 该类型只描述默认 Composer 组装 system block 所需的只读输入。
+ */
+import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
+/** 默认 Session System Block 的组装参数。 */
+export interface BuildSessionSystemBlocksInput {
+    /** 当前 Agent 的稳定标识。 */
+    agent_id: string;
+    /** 当前 Agent 绑定的项目绝对根目录。 */
+    project_root: string;
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Session 首次创建时间，单位为毫秒。 */
+    created_at: number;
+    /** 当前 Session 初始化时解析到的系统时区。 */
+    timezone: string;
+    /** 读取当前调用方传入的 Instruction System Block。 */
+    get_instruction_system_blocks: () => AgentSessionSystemBlock[];
+    /** 读取当前显式注入的受托管 Plugin System Block。 */
+    get_managed_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
+    /** 读取当前显式注册 Plugin 的 System Block。 */
+    get_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
+}
+//# sourceMappingURL=SessionSystem.d.ts.map

package/bin/types/session/SessionSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSystem.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionSystem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,qCAAqC;AACrC,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAC/D,wCAAwC;IACxC,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC3E,sCAAsC;IACtC,wBAAwB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACpE"}

package/bin/types/session/SessionSystem.js

@@ -0,0 +1,7 @@
+/**
+ * Session System Block 组装类型。
+ *
+ * 该类型只描述默认 Composer 组装 system block 所需的只读输入。
+ */
+export {};
+//# sourceMappingURL=SessionSystem.js.map

package/bin/types/session/SessionSystem.js.map

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

package/bin/types/session/SessionTool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Session Tool Message 类型。
+ *
+ * 这些类型描述 Tool 生命周期协调器与 Recorder 之间的稳定边界。
+ */
+import type { SessionAssistantToolPart } from "../../types/session/SessionMessage.js";
+/** 当前流式 Assistant 中的 Tool Part 定位结果。 */
+export interface SessionStreamingToolLocation {
+    /** Tool Part 所属 Assistant Message。 */
+    message_id: string;
+    /** 当前 Tool Part 完整快照。 */
+    part: SessionAssistantToolPart;
+}
+/** Executor 在调用 Tool 实现前提交的完整输入。 */
+export interface SessionToolInputReady {
+    /** 当前 Tool Call 标识。 */
+    tool_call_id: string;
+    /** 当前 Tool 注册名称。 */
+    tool_name: string;
+    /** 已完成解析的 Tool 输入。 */
+    input: unknown;
+}
+//# sourceMappingURL=SessionTool.d.ts.map

package/bin/types/session/SessionTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTool.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAElF,wCAAwC;AACxC,MAAM,WAAW,4BAA4B;IAC3C,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/bin/types/session/SessionTool.js

@@ -0,0 +1,7 @@
+/**
+ * Session Tool Message 类型。
+ *
+ * 这些类型描述 Tool 生命周期协调器与 Recorder 之间的稳定边界。
+ */
+export {};
+//# sourceMappingURL=SessionTool.js.map

package/bin/types/session/SessionTool.js.map

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

package/bin/types/session/SessionTurn.d.ts

@@ -0,0 +1,52 @@
+/**
+ * SessionTurn 构造参数与内部运行态类型。
+ *
+ * 这些类型描述 Turn 编排所依赖的领域对象，不实现任何调度行为。
+ */
+import type { Executor } from "../../executor/Executor.js";
+import type { SessionApprovalBroker } from "../../session/approval/SessionApprovalBroker.js";
+import type { SessionEventHub } from "../../session/runtime/SessionEventHub.js";
+import type { SessionMessages } from "../../session/SessionMessages.js";
+import type { SessionState } from "../../session/SessionState.js";
+import type { AgentSessionTurnResult } from "../../types/sdk/AgentSessionTurn.js";
+import type { SessionQueueCommand } from "../../types/session/SessionQueue.js";
+/** Promise 延迟控制器。 */
+export interface SessionDeferred<T> {
+    /** 等待兑现的 Promise。 */
+    promise: Promise<T>;
+    /** 兑现 Promise 的函数。 */
+    resolve: (value: T) => void;
+}
+/** 当前活跃 Turn 的内存状态。 */
+export interface ActiveSessionTurnState {
+    /** 当前 Turn 的稳定标识。 */
+    turn_id: string;
+    /** 当前 Turn 的最终结果快照。 */
+    result: AgentSessionTurnResult | null;
+    /** 当前 Turn 完成状态的延迟控制器。 */
+    deferred_finished: SessionDeferred<AgentSessionTurnResult>;
+    /** 当前 Turn 的取消控制器。 */
+    abort_controller: AbortController;
+}
+/** SessionTurn 构造参数。 */
+export interface SessionTurnOptions {
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前项目的绝对根目录。 */
+    project_root: string;
+    /** 当前 Session 的模型执行器。 */
+    executor: Executor;
+    /** 当前 Session 的配置与 Metadata 状态。 */
+    state: SessionState;
+    /** 当前 Session 的 canonical Message 入口。 */
+    messages: SessionMessages;
+    /** 当前 Session 的 Mutation 总线。 */
+    events: SessionEventHub;
+    /** 当前 Session 的 Tool 审批入口。 */
+    approvals: SessionApprovalBroker;
+    /** 在 Step 检查点提交 Session 或 Agent 状态 Command。 */
+    apply_command: (command: Exclude<SessionQueueCommand, {
+        type: "compact";
+    }>, turn_id: string) => Promise<void>;
+}
+//# sourceMappingURL=SessionTurn.d.ts.map

package/bin/types/session/SessionTurn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurn.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTurn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,qBAAqB;AACrB,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,sBAAsB;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,uBAAuB;AACvB,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,0BAA0B;IAC1B,iBAAiB,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAC3D,sBAAsB;IACtB,gBAAgB,EAAE,eAAe,CAAC;CACnC;AAED,wBAAwB;AACxB,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,qBAAqB,CAAC;IACjC,+CAA+C;IAC/C,aAAa,EAAE,CACb,OAAO,EAAE,OAAO,CAAC,mBAAmB,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,EAC1D,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB"}

package/bin/types/session/SessionTurn.js

@@ -0,0 +1,7 @@
+/**
+ * SessionTurn 构造参数与内部运行态类型。
+ *
+ * 这些类型描述 Turn 编排所依赖的领域对象，不实现任何调度行为。
+ */
+export {};
+//# sourceMappingURL=SessionTurn.js.map

package/bin/types/session/SessionTurn.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.237",
+  "version": "1.1.258",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与本机 RPC 能力",
   "main": "./bin/index.js",
@@ -13,8 +13,8 @@
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.48",
-    "@downcity/shell": "^0.1.95",
-    "@downcity/type": "0.1.128",
+    "@downcity/shell": "^0.1.112",
+    "@downcity/type": "0.1.145",
     "ai": "^6.0.193",
     "commander": "^15.0.0",
     "dotenv": "^17.4.2",

package/scripts/agent-env.test.mjs

@@ -37,7 +37,7 @@ test("项目 .env 覆盖宿主环境且不修改 process.env", () => {
   }
 });
 
-test("SDK 未传 config 时不读取 downcity.json", async () => {
+test("Agent 运行时只使用显式 id，不读取完整项目 config", async () => {
   const project_root = create_project_root();
   try {
     fs.writeFileSync(path.join(project_root, "downcity.json"), JSON.stringify({
@@ -45,23 +45,9 @@ test("SDK 未传 config 时不读取 downcity.json", async () => {
       version: "9.9.9",
     }));
     const agent = new Agent({ id: "sdk_id", path: project_root });
-    assert.equal(agent.getContext().config.id, "sdk_id");
-    assert.equal(agent.getContext().config.version, "0.0.0");
-    await agent.ready();
-    await agent.dispose();
-  } finally {
-    fs.rmSync(project_root, { recursive: true, force: true, maxRetries: 5, retryDelay: 20 });
-  }
-});
-
-test("SDK 未注入 plugin_config 时明确拒绝持久化", async () => {
-  const project_root = create_project_root();
-  try {
-    const agent = new Agent({ id: "sdk_id", path: project_root });
-    await assert.rejects(
-      agent.getContext().pluginConfig.persistProjectPlugins({}),
-      /Plugin config persistence is not configured/,
-    );
+    assert.equal(agent.id, "sdk_id");
+    assert.equal(agent.getContext().agent_id, "sdk_id");
+    assert.equal(agent.getContext().rootPath, project_root);
     await agent.ready();
     await agent.dispose();
   } finally {

package/scripts/agent-ready.test.mjs

@@ -1,5 +1,5 @@
 /**
- * @file 验证 session.prompt 会等待当前 Agent 后台能力 ready。
+ * @file 验证 session.prompt 会等待当前 Agent runtime ready。
  *
  * 关键点（中文）
  * - 这里走编译后的公开 SDK，覆盖宿主真实入口。
@@ -86,7 +86,7 @@ function create_stream_text_result(text) {
   };
 }
 
-test("session.prompt waits for agent background ready before model execution", async () => {
+test("session.prompt waits for agent runtime ready before model execution", async () => {
   const agent_path = await fs.mkdtemp(
     path.join(os.tmpdir(), "downcity-agent-ready-"),
   );
@@ -203,3 +203,34 @@ test("agent ready isolates plugin lifecycle start failures", async () => {
     await agent.dispose();
   }
 });
+
+test("AgentState installs plugin tools when an action plugin is registered", async () => {
+  const agent_path = await fs.mkdtemp(
+    path.join(os.tmpdir(), "downcity-agent-state-plugin-tools-"),
+  );
+  const agent = new Agent({
+    id: "state_plugin_tools_agent",
+    path: agent_path,
+  });
+  const action_plugin = createPlugin({
+    name: "dynamic_action",
+    actions: {
+      ping: {
+        description: "Return pong",
+        execute: async () => ({ success: true, data: { value: "pong" } }),
+      },
+    },
+  });
+
+  try {
+    assert.equal(agent.tools.plugin_read, undefined);
+    assert.equal(agent.tools.plugin_call, undefined);
+
+    await agent.plugins.register(action_plugin);
+
+    assert.notEqual(agent.tools.plugin_read, undefined);
+    assert.notEqual(agent.tools.plugin_call, undefined);
+  } finally {
+    await agent.dispose();
+  }
+});

package/scripts/agent-session-maintenance.test.mjs

@@ -0,0 +1,52 @@
+/**
+ * Agent Session 领域维护能力测试。
+ */
+
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { Agent } from "../bin/index.js";
+
+function create_project_root() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), "downcity-session-maintenance-"));
+}
+
+function get_session_path(root_path, agent_id, session_id) {
+  return path.join(
+    root_path,
+    ".downcity",
+    "agents",
+    encodeURIComponent(agent_id),
+    "sessions",
+    encodeURIComponent(session_id),
+  );
+}
+
+test("AgentContext sessions 负责清空消息和删除 Session 数据", async () => {
+  const root_path = create_project_root();
+  const agent = new Agent({ id: "agent_test", path: root_path });
+  try {
+    assert.equal(agent.getContext().sessions, agent.sessions);
+    const session_id = "session_test";
+    await agent.sessions.create({ sessionId: session_id });
+    const session_path = get_session_path(root_path, agent.id, session_id);
+    const messages_path = path.join(session_path, "messages");
+    fs.mkdirSync(messages_path, { recursive: true });
+    fs.writeFileSync(path.join(messages_path, "active.jsonl"), "{}\n");
+
+    assert.equal(
+      await agent.getContext().sessions.clear_messages(session_id),
+      true,
+    );
+    assert.equal(fs.existsSync(messages_path), false);
+    assert.equal(fs.existsSync(session_path), true);
+
+    assert.equal(await agent.getContext().sessions.remove(session_id), true);
+    assert.equal(fs.existsSync(session_path), false);
+  } finally {
+    await agent.dispose();
+    fs.rmSync(root_path, { recursive: true, force: true });
+  }
+});

package/scripts/city-model-tool-loop.test.mjs

@@ -15,7 +15,6 @@ import os from "node:os";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { Agent } from "../bin/index.js";
-import { enqueueAssistantFileParts } from "../bin/executor/SessionRunScope.js";
 import { createAction, createPlugin } from "../bin/plugin/core/PluginActionFactory.js";
 import { CITY_MODEL_INVOKER, CITY_MODEL_KIND } from "@downcity/type";
 import { tool } from "ai";
@@ -256,14 +255,14 @@ test("CityModel uses direct LanguageModel path and sends tool result back", asyn
           inputSchema: z.object({
             value: z.string(),
           }),
-          execute: async ({ value }) => {
+          execute: async ({ value }, options) => {
             tool_executed = true;
-            enqueueAssistantFileParts([{
+            options.experimental_context.session_run_context.pendingAssistantFileParts.push({
               type: "file",
               mediaType: "image/png",
               url: ".downcity/resources/tool-output.png",
               filename: "tool-output.png",
-            }]);
+            });
             return { echoed: value };
           },
         }),

package/scripts/core-engine-context-compaction.test.mjs

@@ -13,7 +13,6 @@ import {
   should_compact_after_usage,
 } from "../bin/executor/core-engine/CoreEngineContextCompaction.js";
 import { CoreEngineRunner } from "../bin/executor/core-engine/CoreEngineRunner.js";
-import { LocalSessionContextComposer } from "../bin/executor/composer/context/LocalSessionContextComposer.js";
 
 function create_stream_text_result(text, input_tokens, output_tokens) {
   return {
@@ -47,26 +46,16 @@ function create_stream_text_result(text, input_tokens, output_tokens) {
 }
 
 function create_runner() {
-  const context_composer = new LocalSessionContextComposer({
-    sessionId: "compact-runner-session",
-    getTools: () => ({}),
-  });
   return new CoreEngineRunner({
-    history_store: { sessionId: "compact-runner-session" },
-    context_composer,
+    session_id: "compact-runner-session",
     logger: { log: async () => {} },
     should_compact_on_error: () => false,
   });
 }
 
 function create_context_error_runner() {
-  const context_composer = new LocalSessionContextComposer({
-    sessionId: "compact-runner-session",
-    getTools: () => ({}),
-  });
   return new CoreEngineRunner({
-    history_store: { sessionId: "compact-runner-session" },
-    context_composer,
+    session_id: "compact-runner-session",
     logger: { log: async () => {} },
     should_compact_on_error: (error) =>
       String(error || "").includes("context length"),
@@ -94,6 +83,7 @@ function create_run_input(model, messages, context_window = 100) {
       tools: {},
       context_window,
     }),
+    reload_history: async () => messages,
   };
 }
 
@@ -191,16 +181,8 @@ test("显式 compact 后在下一次 provider 调用前重载 canonical history"
     },
     parts: [{ type: "text", text: "compacted checkpoint" }],
   }];
-  const context_composer = new LocalSessionContextComposer({
-    sessionId: "compact-runner-session",
-    getTools: () => ({}),
-  });
   const runner = new CoreEngineRunner({
-    history_store: {
-      sessionId: "compact-runner-session",
-      list_records: async () => compacted_records,
-    },
-    context_composer,
+    session_id: "compact-runner-session",
     logger: { log: async () => {} },
     should_compact_on_error: () => false,
   });
@@ -229,6 +211,7 @@ test("显式 compact 后在下一次 provider 调用前重载 canonical history"
     reload_requested = false;
     return requested;
   };
+  input.reload_history = async () => compacted_records;
 
   const result = await runner.run(input);
 

package/scripts/image-plugin-job.test.mjs

@@ -14,7 +14,7 @@ import os from "node:os";
 import path from "node:path";
 
 import { ImagePlugin } from "../../plugins/bin/index.js";
-import { createAgentPluginRegistry } from "../bin/agent/local/AgentPluginFactory.js";
+import { PluginRegistry } from "../bin/plugin/core/PluginRegistry.js";
 
 function create_image_message() {
   return {
@@ -36,11 +36,9 @@ function create_context(rootPath = process.cwd()) {
 }
 
 function create_registry(plugin, rootPath = process.cwd()) {
-  return createAgentPluginRegistry({
-    plugins: [plugin],
-    plugin_instances: new Map(),
-    get_context: () => create_context(rootPath),
-  });
+  const registry = new PluginRegistry([plugin]);
+  registry.bind_context(create_context(rootPath));
+  return registry;
 }
 
 test("ImagePlugin exposes only job-style image actions", async () => {