@downcity/agent 1.1.238 → 1.1.259

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"}

package/bin/agent/{local/services/AgentSessions.d.ts → AgentSessions.d.ts}

@@ -7,16 +7,14 @@
  * - Session 对象创建细节集中在这里，避免 facade 和 lifecycle 重复依赖 Session 构造逻辑。
  */
 import type { Tool } from "ai";
-import type { Logger } from "../../../utils/logger/Logger.js";
-import type { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "../../../types/agent/SessionTypes.js";
-import type { AgentModel } from "../../../model/CityModelAdapter.js";
-import type { AgentSessionConstructor } from "../../../types/agent/AgentOptions.js";
-import type { AgentSession, AgentSessions as AgentSessionsApi } from "../../../types/agent/SessionActor.js";
-import type { AgentManagedSession } from "../../../types/session/SessionOptions.js";
-import type { AgentContext } from "../../../types/runtime/agent/AgentContext.js";
-import type { SessionPort } from "../../../types/runtime/agent/AgentContext.js";
-import type { Shell } from "@downcity/shell";
-import type { AgentPluginExecutionRuntime } from "../../../types/plugin/PluginRuntime.js";
+import type { AgentModel } from "../agent/AgentModel.js";
+import type { Logger } from "../utils/logger/Logger.js";
+import type { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "../types/agent/SessionTypes.js";
+import type { AgentSessionConstructor } from "../types/agent/AgentOptions.js";
+import type { AgentSession, AgentSessions as AgentSessionsContract } from "../types/agent/SessionActor.js";
+import type { AgentManagedSession } from "../types/session/SessionOptions.js";
+import type { SessionPort } from "../types/session/SessionPort.js";
+import type { AgentPluginExecutionRuntime } from "../types/plugin/PluginRuntime.js";
 type AgentSessionsOptions = {
     /**
      * 当前 agent 稳定标识。
@@ -34,15 +32,6 @@ type AgentSessionsOptions = {
      * 当前统一日志器。
      */
     logger: Logger;
-    /**
-     * 延迟读取当前 agent context。
-     *
-     * 关键点（中文）
-     * - 装配期通过 getter 拿到 context，避免循环引用。
-     */
-    get_agent_context: () => AgentContext;
-    /** 延迟读取当前 Agent 挂载的 Shell Runtime。 */
-    get_shell: () => Shell | undefined;
     /**
      * 当前静态 instruction 文本集合。
      */
@@ -52,47 +41,40 @@ type AgentSessionsOptions = {
     /** 创建当前 configured Plugin registry 的 Session step 执行视图。 */
     get_agent_plugins: () => AgentPluginExecutionRuntime;
     /**
-     * 等待当前 Agent 后台能力启动完成。
+     * 等待当前 Agent 持有的长期运行时启动完成。
      */
     ensure_agent_ready: () => Promise<void>;
-    /**
-     * 当前默认模型实例。
-     */
-    default_model?: AgentModel;
-    /** 当前默认模型的稳定 ID。 */
-    default_model_id?: string;
-    /** 按稳定 ID 解析 Session 模型。 */
-    resolve_model?: (model_id: string) => Promise<AgentModel>;
     /**
      * 当前 agent 使用的本地 Session 类。
      */
     SessionClass?: AgentSessionConstructor;
+    /** 读取 Agent 当前持有的运行时模型实例。 */
+    get_agent_model: () => AgentModel | undefined;
 };
 /**
  * 本地 Agent session 管理服务。
  */
-export declare class AgentSessions implements AgentSessionsApi<AgentSession> {
+export declare class AgentSessions implements AgentSessionsContract<AgentSession> {
     private readonly agent_id;
     private readonly project_root;
     private readonly tools;
     private readonly logger;
-    private readonly get_agent_context;
-    private readonly get_shell;
     private readonly get_instruction;
     private readonly get_agent_env;
     private readonly get_agent_plugins;
     private readonly ensure_agent_ready;
-    private readonly default_model?;
-    private readonly default_model_id?;
-    private readonly resolve_model?;
     private readonly SessionClass;
+    private readonly get_agent_model;
     private readonly sessions_by_id;
-    private readonly configured_session_ids;
     constructor(options: AgentSessionsOptions);
     /**
      * 返回当前缓存的 session 实例。
      */
     list_cached_sessions(): AgentManagedSession[];
+    /** 返回当前所有执行中的 Session 标识。 */
+    list_executing_session_ids(): string[];
+    /** 返回当前执行中的 Session 数量。 */
+    get_executing_session_count(): number;
     /**
      * 把 Agent instruction 修改广播到已有 Session 的统一输入队列。
      */
@@ -112,7 +94,7 @@ export declare class AgentSessions implements AgentSessionsApi<AgentSession> {
     /**
      * 获取或创建一个 session runtime port。
      */
-    get_session_port(session_id: string): SessionPort;
+    runtime(session_id: string): SessionPort;
     /**
      * 新建一个 session。
      */
@@ -121,6 +103,18 @@ export declare class AgentSessions implements AgentSessionsApi<AgentSession> {
      * 获取一个已存在的 session。
      */
     get(session_id: string): Promise<AgentSession>;
+    /**
+     * 永久删除一个 Session 及其全部 Agent 领域数据。
+     *
+     * 关键点（中文）
+     * - 正在执行的 Session 会先停止，避免删除后继续写入。
+     * - 该方法不处理任何 Plugin 自有数据。
+     */
+    remove(session_id: string): Promise<boolean>;
+    /**
+     * 清空一个 Session 的消息目录。
+     */
+    clear_messages(session_id: string): Promise<boolean>;
     /**
      * 列出当前 agent 的 session 摘要页。
      */
@@ -138,11 +132,7 @@ export declare class AgentSessions implements AgentSessionsApi<AgentSession> {
      */
     clean_archive(): Promise<AgentCleanArchiveResult>;
     private get_or_create_session;
-    private require_shell;
-    private list_session_approvals;
-    private apply_session_defaults;
     private load_instruction_system_blocks;
-    private load_plugin_system_blocks;
 }
 export {};
 //# sourceMappingURL=AgentSessions.d.ts.map

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

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

package/bin/agent/{local/services/AgentSessions.js → AgentSessions.js}

@@ -8,10 +8,10 @@
  */
 import fs from "fs-extra";
 import { nanoid } from "nanoid";
-import { Session } from "../../../session/Session.js";
-import { getSdkAgentArchivedSessionDirPath, getSdkAgentArchivedSessionsDirPath, getSdkAgentSessionDirPath, } from "../../../session/storage/Paths.js";
-import { listArchivedAgentSessionSummaryPage, listAgentSessionSummaryPage, } from "../../../session/browse/Browse.js";
-import { createInstructionSystemBlocks } from "../../../agent/local/AgentInstructions.js";
+import { Session } from "../session/Session.js";
+import { getSdkAgentArchivedSessionDirPath, getSdkAgentArchivedSessionsDirPath, getSdkAgentSessionDirPath, getSdkAgentSessionMessagesDirPath, } from "../session/storage/Paths.js";
+import { listArchivedAgentSessionSummaryPage, listAgentSessionSummaryPage, } from "../session/browse/Browse.js";
+import { createInstructionSystemBlocks } from "../agent/AgentInstructions.js";
 function decodeMaybe(input) {
     try {
         return decodeURIComponent(input);
@@ -28,33 +28,24 @@ export class AgentSessions {
     project_root;
     tools;
     logger;
-    get_agent_context;
-    get_shell;
     get_instruction;
     get_agent_env;
     get_agent_plugins;
     ensure_agent_ready;
-    default_model;
-    default_model_id;
-    resolve_model;
     SessionClass;
+    get_agent_model;
     sessions_by_id = new Map();
-    configured_session_ids = new Set();
     constructor(options) {
         this.agent_id = options.agent_id;
         this.project_root = options.project_root;
         this.tools = options.tools;
         this.logger = options.logger;
-        this.get_agent_context = options.get_agent_context;
-        this.get_shell = options.get_shell;
         this.get_instruction = options.get_instruction;
         this.get_agent_env = options.get_agent_env;
         this.get_agent_plugins = options.get_agent_plugins;
         this.ensure_agent_ready = options.ensure_agent_ready;
-        this.default_model = options.default_model;
-        this.default_model_id = options.default_model_id;
-        this.resolve_model = options.resolve_model;
         this.SessionClass = options.SessionClass || Session;
+        this.get_agent_model = options.get_agent_model;
     }
     /**
      * 返回当前缓存的 session 实例。
@@ -62,6 +53,16 @@ export class AgentSessions {
     list_cached_sessions() {
         return [...this.sessions_by_id.values()];
     }
+    /** 返回当前所有执行中的 Session 标识。 */
+    list_executing_session_ids() {
+        return this.list_cached_sessions()
+            .filter((session) => session.isExecuting())
+            .map((session) => session.id);
+    }
+    /** 返回当前执行中的 Session 数量。 */
+    get_executing_session_count() {
+        return this.list_executing_session_ids().length;
+    }
     /**
      * 把 Agent instruction 修改广播到已有 Session 的统一输入队列。
      */
@@ -103,7 +104,7 @@ export class AgentSessions {
     /**
      * 获取或创建一个 session runtime port。
      */
-    get_session_port(session_id) {
+    runtime(session_id) {
         return this.get_or_create_session({
             session_id,
         }).getRuntimePort();
@@ -122,7 +123,6 @@ export class AgentSessions {
             session_id: explicit_session_id,
         });
         await session.initialize();
-        await this.apply_session_defaults(session);
         return session;
     }
     /**
@@ -142,9 +142,50 @@ export class AgentSessions {
             session_id: resolved_session_id,
         });
         await session.initialize();
-        await this.apply_session_defaults(session);
         return session;
     }
+    /**
+     * 永久删除一个 Session 及其全部 Agent 领域数据。
+     *
+     * 关键点（中文）
+     * - 正在执行的 Session 会先停止，避免删除后继续写入。
+     * - 该方法不处理任何 Plugin 自有数据。
+     */
+    async remove(session_id) {
+        const resolved_session_id = String(session_id || "").trim();
+        if (!resolved_session_id) {
+            throw new Error("sessions.remove requires a non-empty sessionId");
+        }
+        const cached = this.sessions_by_id.get(resolved_session_id);
+        if (cached?.isExecuting()) {
+            await cached.stop();
+        }
+        const session_dir_path = getSdkAgentSessionDirPath(this.project_root, this.agent_id, resolved_session_id);
+        const existed = await fs.pathExists(session_dir_path);
+        if (existed)
+            await fs.remove(session_dir_path);
+        this.sessions_by_id.delete(resolved_session_id);
+        return existed;
+    }
+    /**
+     * 清空一个 Session 的消息目录。
+     */
+    async clear_messages(session_id) {
+        const resolved_session_id = String(session_id || "").trim();
+        if (!resolved_session_id) {
+            throw new Error("sessions.clear_messages requires a non-empty sessionId");
+        }
+        const cached = this.sessions_by_id.get(resolved_session_id);
+        if (cached?.isExecuting()) {
+            throw new Error(`Session "${resolved_session_id}" is currently executing`);
+        }
+        const messages_dir_path = getSdkAgentSessionMessagesDirPath(this.project_root, this.agent_id, resolved_session_id);
+        const existed = await fs.pathExists(messages_dir_path);
+        if (existed)
+            await fs.remove(messages_dir_path);
+        this.sessions_by_id.delete(resolved_session_id);
+        return existed;
+    }
     /**
      * 列出当前 agent 的 session 摘要页。
      */
@@ -153,7 +194,7 @@ export class AgentSessions {
             projectRoot: this.project_root,
             agentId: this.agent_id,
             input,
-            executingSessionIds: new Set(this.get_agent_context().listExecutingSessionIds()),
+            executingSessionIds: new Set(this.list_executing_session_ids()),
         });
     }
     /**
@@ -164,7 +205,7 @@ export class AgentSessions {
         if (!session_id) {
             throw new Error("sessions.archive requires a non-empty id");
         }
-        const executing_session_ids = new Set(this.get_agent_context().listExecutingSessionIds());
+        const executing_session_ids = new Set(this.list_executing_session_ids());
         if (executing_session_ids.has(session_id)) {
             throw new Error(`Session "${session_id}" is currently executing`);
         }
@@ -180,7 +221,6 @@ export class AgentSessions {
         await fs.move(source_path, target_path);
         // 关键点（中文）：归档后清理缓存，避免后续操作访问已移动目录。
         this.sessions_by_id.delete(session_id);
-        this.configured_session_ids.delete(session_id);
         return {
             sessionId: session_id,
             archivedAt: Date.now(),
@@ -236,75 +276,18 @@ export class AgentSessions {
             logger: this.logger,
             getInstructionSystemBlocks: () => this.load_instruction_system_blocks(),
             getAgentEnv: () => this.get_agent_env(),
+            getAgentModel: () => this.get_agent_model(),
             get_agent_plugins: () => this.get_agent_plugins(),
             getManagedPluginSystemBlocks: async () => [],
-            getPluginSystemBlocks: async () => await this.load_plugin_system_blocks(),
             ensureConfigured: async (session) => {
                 await this.ensure_agent_ready();
-                await this.apply_session_defaults(session);
-            },
-            ...(this.resolve_model ? { resolve_model: this.resolve_model } : {}),
-            list_approvals: async (session_id) => this.list_session_approvals(session_id),
-            get_approval_mode: async (session_id) => {
-                const shell = this.require_shell();
-                return shell.approval_mode({ session_id });
-            },
-            set_approval_mode: async (session_id, { mode }) => {
-                const shell = this.require_shell();
-                return shell.set_approval_mode({ session_id, mode });
-            },
-            resolve_approval: async (session_id, { approval_id, decision }) => {
-                const approval = this.list_session_approvals(session_id)
-                    .find((item) => item.approval_id === approval_id);
-                if (!approval)
-                    return { success: false, approval_id, decision };
-                return decision === "approved"
-                    ? await this.require_shell().approve({ approval_id })
-                    : await this.require_shell().deny({ approval_id });
             },
         });
         this.sessions_by_id.set(resolved_session_id, created);
         return created;
     }
-    require_shell() {
-        const shell = this.get_shell();
-        if (!shell)
-            throw new Error("Session shell is not configured");
-        return shell;
-    }
-    list_session_approvals(session_id) {
-        return (this.get_shell()?.approvals() || [])
-            .filter((approval) => approval.session_id === session_id)
-            .map((approval) => ({
-            approval_id: approval.approval_id,
-            session_id,
-            ...(approval.turn_id ? { turn_id: approval.turn_id } : {}),
-            ...(approval.tool_call_id ? { tool_call_id: approval.tool_call_id } : {}),
-            tool_name: approval.tool_name,
-            command: approval.cmd,
-            cwd: approval.cwd,
-            reason: approval.reason,
-            operation: approval.operation,
-            created_at: approval.created_at,
-        }));
-    }
-    async apply_session_defaults(session) {
-        if (this.configured_session_ids.has(session.id))
-            return;
-        const persisted_model_id = String(session.config.modelId || "").trim();
-        if (!persisted_model_id && this.default_model) {
-            await session.set({
-                model: this.default_model,
-                ...(this.default_model_id ? { modelId: this.default_model_id } : {}),
-            });
-        }
-        this.configured_session_ids.add(session.id);
-    }
     load_instruction_system_blocks() {
         return createInstructionSystemBlocks(this.get_instruction(), this.project_root);
     }
-    async load_plugin_system_blocks() {
-        return await this.get_agent_context().plugins.systemBlocks();
-    }
 }
 //# sourceMappingURL=AgentSessions.js.map

package/bin/agent/AgentSessions.js.map

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

package/bin/agent/AgentState.d.ts

@@ -0,0 +1,64 @@
+/**
+ * AgentState：本地 Agent 长期运行状态与生命周期。
+ *
+ * 职责说明（中文）
+ * - 统一连接 PluginRegistry、AgentContext、AgentSessions 与共享 tools。
+ * - 持有 Plugin lifecycle 与 ActionSchedule 的启动状态。
+ * - Agent 构造完成后立即开始启动，调用方通过 `ready()` 等待。
+ * - Agent 释放时统一停止 ActionSchedule、Plugin lifecycle 与 Shell。
+ * - RPC / HTTP 等 transport 不属于 AgentState，由上游宿主独立管理。
+ */
+import type { AgentStateOptions } from "../types/agent/AgentState.js";
+/**
+ * 本地 Agent 长期运行状态。
+ */
+export declare class AgentState {
+    /** 当前 Agent 共用的执行上下文。 */
+    private readonly context;
+    /** 当前 Agent 唯一的 PluginRegistry 实例。 */
+    private readonly plugins;
+    /** 当前 Agent 唯一的 Session 集合。 */
+    private readonly sessions;
+    /** 当前 Agent 与 Session 共享的可变工具集合。 */
+    private readonly tools;
+    /** 当前 Agent 持有的可选 Shell 实例。 */
+    private readonly shell?;
+    /** Plugin lifecycle 与 ActionSchedule 的唯一启动 Promise。 */
+    private readonly ready_promise;
+    /** Plugin lifecycle 是否已经完成启动流程。 */
+    private plugins_started;
+    /** 当前 Agent 持有的 ActionSchedule 轮询运行时。 */
+    private action_schedule_runtime;
+    constructor(options: AgentStateOptions);
+    /**
+     * 等待当前 Agent 持有的长期运行时启动完成。
+     */
+    ready(): Promise<void>;
+    /**
+     * 释放当前 Agent 持有的长期运行时对象。
+     */
+    dispose(): Promise<void>;
+    /**
+     * 启动 Plugin lifecycle 与 ActionSchedule。
+     *
+     * 关键点（中文）
+     * - Plugin lifecycle 先启动，避免到期任务调用未就绪的 Plugin。
+     * - 单个 Plugin 启动失败由 PluginRegistry 隔离，只记录错误并继续启动 Agent。
+     * - ActionSchedule 启动失败不阻断 Agent ready。
+     */
+    private start_runtime;
+    /**
+     * 确保带 action 的 PluginRegistry 已连接通用调用工具。
+     *
+     * 关键点（中文）
+     * - 初始 Plugin 与运行中动态注册 Plugin 统一走这里。
+     * - 只补充缺失工具，不覆盖调用方提供的同名自定义工具。
+     * - tools 是 AgentSessions 与 Session 共享引用，原地写入会立即对现有 Session 生效。
+     */
+    private ensure_plugin_tools;
+    /**
+     * 处理 PluginRegistry 修改后的 Agent 运行时同步。
+     */
+    private handle_plugin_change;
+}
+//# sourceMappingURL=AgentState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentState.d.ts","sourceRoot":"","sources":["../../src/agent/AgentState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAQrE;;GAEG;AACH,qBAAa,UAAU;IACrB,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAQ;IAE/B,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C,mCAAmC;IACnC,OAAO,CAAC,eAAe,CAAS;IAEhC,yCAAyC;IACzC,OAAO,CAAC,uBAAuB,CAA4C;gBAE/D,OAAO,EAAE,iBAAiB;IAetC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B;;;;;;;OAOG;YACW,aAAa;IAsB3B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAY7B"}

package/bin/agent/AgentState.js

@@ -0,0 +1,118 @@
+/**
+ * AgentState：本地 Agent 长期运行状态与生命周期。
+ *
+ * 职责说明（中文）
+ * - 统一连接 PluginRegistry、AgentContext、AgentSessions 与共享 tools。
+ * - 持有 Plugin lifecycle 与 ActionSchedule 的启动状态。
+ * - Agent 构造完成后立即开始启动，调用方通过 `ready()` 等待。
+ * - Agent 释放时统一停止 ActionSchedule、Plugin lifecycle 与 Shell。
+ * - RPC / HTTP 等 transport 不属于 AgentState，由上游宿主独立管理。
+ */
+import { createPluginTools } from "../executor/tools/plugin/PluginToolDefinition.js";
+import { generateId } from "../utils/Id.js";
+import { startActionScheduleRuntime, } from "../plugin/core/ActionScheduleRuntime.js";
+/**
+ * 本地 Agent 长期运行状态。
+ */
+export class AgentState {
+    /** 当前 Agent 共用的执行上下文。 */
+    context;
+    /** 当前 Agent 唯一的 PluginRegistry 实例。 */
+    plugins;
+    /** 当前 Agent 唯一的 Session 集合。 */
+    sessions;
+    /** 当前 Agent 与 Session 共享的可变工具集合。 */
+    tools;
+    /** 当前 Agent 持有的可选 Shell 实例。 */
+    shell;
+    /** Plugin lifecycle 与 ActionSchedule 的唯一启动 Promise。 */
+    ready_promise;
+    /** Plugin lifecycle 是否已经完成启动流程。 */
+    plugins_started = false;
+    /** 当前 Agent 持有的 ActionSchedule 轮询运行时。 */
+    action_schedule_runtime = null;
+    constructor(options) {
+        this.context = options.context;
+        this.plugins = options.plugins;
+        this.sessions = options.sessions;
+        this.tools = options.tools;
+        this.shell = options.shell;
+        this.plugins.bind_context(this.context);
+        this.ensure_plugin_tools();
+        this.plugins.set_change_listener(({ type, plugin_name }) => {
+            this.handle_plugin_change(type, plugin_name);
+        });
+        this.ready_promise = this.start_runtime();
+    }
+    /**
+     * 等待当前 Agent 持有的长期运行时启动完成。
+     */
+    async ready() {
+        await this.ready_promise;
+    }
+    /**
+     * 释放当前 Agent 持有的长期运行时对象。
+     */
+    async dispose() {
+        await this.ready_promise.catch(() => undefined);
+        this.action_schedule_runtime?.stop();
+        this.action_schedule_runtime = null;
+        if (this.plugins_started) {
+            await this.context.plugins.unregisterAll();
+            this.plugins_started = false;
+        }
+        await this.shell?.dispose();
+    }
+    /**
+     * 启动 Plugin lifecycle 与 ActionSchedule。
+     *
+     * 关键点（中文）
+     * - Plugin lifecycle 先启动，避免到期任务调用未就绪的 Plugin。
+     * - 单个 Plugin 启动失败由 PluginRegistry 隔离，只记录错误并继续启动 Agent。
+     * - ActionSchedule 启动失败不阻断 Agent ready。
+     */
+    async start_runtime() {
+        const snapshots = await this.plugins.startAll();
+        this.plugins_started = true;
+        for (const item of snapshots) {
+            if (item.status === "error") {
+                this.context.logger.error(`Plugin start failed: ${item.name} - ${item.last_error || "unknown error"}`);
+            }
+        }
+        try {
+            this.action_schedule_runtime = await startActionScheduleRuntime(this.context);
+        }
+        catch (error) {
+            this.context.logger.error(`ActionSchedule start failed: ${String(error)}`);
+        }
+    }
+    /**
+     * 确保带 action 的 PluginRegistry 已连接通用调用工具。
+     *
+     * 关键点（中文）
+     * - 初始 Plugin 与运行中动态注册 Plugin 统一走这里。
+     * - 只补充缺失工具，不覆盖调用方提供的同名自定义工具。
+     * - tools 是 AgentSessions 与 Session 共享引用，原地写入会立即对现有 Session 生效。
+     */
+    ensure_plugin_tools() {
+        if (!this.plugins.list().some((plugin) => plugin.actions.length > 0)) {
+            return;
+        }
+        const plugin_tools = createPluginTools({ plugins: this.plugins });
+        this.tools.plugin_read = this.tools.plugin_read || plugin_tools.plugin_read;
+        this.tools.plugin_call = this.tools.plugin_call || plugin_tools.plugin_call;
+    }
+    /**
+     * 处理 PluginRegistry 修改后的 Agent 运行时同步。
+     */
+    handle_plugin_change(type, plugin_name) {
+        this.ensure_plugin_tools();
+        const verb = type === "register" ? "registered" : "unregistered";
+        this.sessions.broadcast_plugins({
+            command_id: generateId(),
+            title: `Agent plugin ${plugin_name} ${verb}`,
+            plugins: this.plugins.execution_view(),
+        });
+    }
+}
+//# sourceMappingURL=AgentState.js.map