@downcity/agent 1.1.79 → 1.1.82

package/README.md

@@ -83,7 +83,7 @@ src/
 - `src/executor/`
   - 内部执行内核
   - `Session` 是 SDK 用户面对的会话整体，`Executor` 是内部单轮执行引擎
-  - Store 负责 history 事实源落盘，Composer 是纯 interface 协议，负责组装 system / history / context / compaction
+  - Store 负责 history 事实源落盘，Composer 是可替换的 session 阶段策略协议，负责定义 system / history / context / compaction 等执行阶段逻辑
   - `Executor.prepareExecuteInput()` 串起四类 Composer，`Executor.runCoreEngine()` 负责进入模型 tool loop
   - 负责 history、system、context、CoreEngine、增量输出与消息持久化
 

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

@@ -1,21 +1,17 @@
 /**
- * Agent local：本地入口与实例装配中心。
+ * Agent local：本地入口与 facade。
  *
  * 职责说明（中文）
  * - 对外暴露 `Agent` 这一唯一的本地实例类。
- * - 统一承接单个 agent 实例的配置加载、plugin 装配、session 创建、RPC 启停。
- * - 把原先独立的实例内核装配逻辑收敛到 `Agent` 内部，避免 facade 与 core 双层跳转。
- *
- * 边界说明（中文）
- * - 这里负责“单个 agent 实例”的长期状态与装配，不负责平台级多 agent 管理。
- * - 这里不直接实现 session 执行细节，而是继续复用 `Session` / `Executor` 体系。
+ * - facade 只保留公开 API 与 service 组合，不再直接承载装配、session 管理与生命周期细节。
+ * - 单个 agent 的长期对象装配、session 管理、后台能力生命周期分别下沉到独立 service。
  */
 import type { Tool } from "ai";
 import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
 import type { AgentRuntime } from "../../types/runtime/agent/AgentRuntime.js";
 import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
 import type { PluginPort } from "../../plugin/types/Plugin.js";
-import type { AgentSession, AgentCreateSessionInput, AgentListSessionsInput, AgentOptions, AgentStartOptions, AgentStartResult, AgentStopResult, AgentSessionCollection, AgentSessionSummaryPage } from "../../types/agent/AgentTypes.js";
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentOptions, AgentSession, AgentSessionCollection, AgentSessionSummaryPage, AgentStartOptions, AgentStartResult, AgentStopResult } from "../../types/agent/AgentTypes.js";
 import { Logger } from "../../utils/logger/Logger.js";
 /**
  * SDK 本地 Agent。
@@ -26,36 +22,23 @@ export declare class Agent {
     readonly tools: Record<string, Tool>;
     readonly plugins: PluginPort;
     private readonly logger;
-    private readonly sessionsById;
     private readonly runtime;
     private readonly agentContext;
     private readonly pluginRegistry;
     private readonly config;
     private readonly env;
     private readonly defaultModel?;
-    private readonly pluginInstances;
-    private readonly sessionCollection;
+    private readonly SessionClass;
+    private readonly sessionManager;
+    private readonly lifecycleService;
     private instruction;
-    private configuredSessionIds;
-    private pluginsStarted;
-    private actionScheduleRuntime;
-    private startPromise;
-    private rpcBinding;
     constructor(options: AgentOptions);
     /**
      * 新建一个 session。
-     *
-     * 关键点（中文）
-     * - 若调用方显式传入 `sessionId`，这里会先检查缓存与磁盘目录，避免重复创建。
-     * - session 初始化完成后会立即应用默认模型。
      */
     createSession(input?: AgentCreateSessionInput): Promise<AgentSession>;
     /**
      * 获取一个已存在的 session。
-     *
-     * 关键点（中文）
-     * - 若缓存中没有该 session，会根据磁盘目录决定是否允许懒加载恢复。
-     * - 返回前同样会兜底执行一次默认配置装配。
      */
     getSession(sessionId: string): Promise<AgentSession>;
     /**
@@ -64,26 +47,14 @@ export declare class Agent {
     listSessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
     /**
      * 启动当前 agent 实例的长期运行能力。
-     *
-     * 关键点（中文）
-     * - `start()` 是唯一公开的长期运行生命周期入口。
-     * - 多次并发调用会复用同一个启动 Promise，避免重复启动 plugins / rpc。
      */
     start(options?: AgentStartOptions): Promise<AgentStartResult>;
     /**
      * 停止当前 agent 实例的长期运行能力。
-     *
-     * 关键点（中文）
-     * - 停止顺序保持为 plugins -> rpc，与当前运行语义一致。
-     * - 停止后会清空 `startPromise`，允许后续再次 `start()`。
      */
     stop(): Promise<AgentStopResult>;
     /**
      * 更新当前 SDK Agent 的静态基础指令。
-     *
-     * 关键点（中文）
-     * - instruction 不做动态变量替换。
-     * - 已创建的 session 后续 run 会读取最新 instruction blocks。
      */
     setInstruction(input: string | string[]): void;
     /**
@@ -96,100 +67,16 @@ export declare class Agent {
     getLogger(): Logger;
     /**
      * 返回当前 agent runtime。
-     *
-     * 关键点（中文）
-     * - 供宿主在 agent 外部装配 transport（例如 Town HTTP gateway）时复用。
-     * - 不暴露启动语义，只暴露运行时访问口。
      */
     getRuntime(): AgentRuntime;
     /**
      * 返回当前 agent context。
-     *
-     * 关键点（中文）
-     * - 供宿主装配 plugin/control 相关外层协议面。
      */
     getContext(): AgentContext;
     /**
      * 返回当前 session collection。
-     *
-     * 关键点（中文）
-     * - 供宿主在外层挂载 RemoteAgent transport 时复用。
      */
     getSessionCollection(): AgentSessionCollection;
-    /**
-     * 确保当前 plugins 已启动。
-     *
-     * 关键点（中文）
-     * - 这里只负责托管 plugin 的生命周期启动，不隐式启动 RPC 能力。
-     * - 启动失败的 plugin 会记录日志，但保留与原行为一致的整体启动流程。
-     */
-    private ensurePluginsStarted;
-    /**
-     * 确保 ActionSchedule runtime 已随 Agent 长期生命周期启动。
-     *
-     * 关键点（中文）
-     * - ActionSchedule 不作为 plugin 注册，但它依赖 plugin action 执行能力。
-     * - 因此这里放在普通 plugins 启动之后，避免到期任务执行到尚未启动的 plugin。
-     */
-    private ensureActionScheduleRuntimeStarted;
-    /**
-     * 停止 ActionSchedule runtime。
-     *
-     * 关键点（中文）
-     * - Agent 停止时先停 ActionSchedule，再停普通 plugin，避免关停期间继续触发 action。
-     */
-    private stopActionScheduleRuntime;
-    /**
-     * 启动当前 agent 的本机 RPC server。
-     */
-    private startRpc;
-    /**
-     * 停止当前 agent 的本机 RPC server。
-     */
-    private stopRpc;
-    /**
-     * 读取当前项目配置。
-     *
-     * 关键点（中文）
-     * - 若项目根目录尚未存在合法 `downcity.json`，会退回最小 SDK 占位配置。
-     * - 这样可以允许纯 SDK 场景在尚未初始化项目时继续装配本地 Agent。
-     */
-    private loadConfig;
-    /**
-     * 注册当前 agent 可见的 plugin 实例。
-     *
-     * 关键点（中文）
-     * - SDK 只注册宿主显式传入的 plugin 实例，不再隐式装配 built-in 集合。
-     * - 所有 plugin 在注册前都会绑定到当前实例 runtime。
-     */
-    private registerPlugins;
-    /**
-     * 读取当前 agent 静态 instruction blocks。
-     */
-    private loadInstructionSystemBlocks;
-    /**
-     * 读取当前可用 plugin 暴露的 system blocks。
-     *
-     * 关键点（中文）
-     * - 单个 plugin system 失败不会阻断 session 主链路。
-     * - 这里只加载当前启用且可用的 plugin system 文本。
-     */
-    private loadPluginSystemBlocks;
-    /**
-     * 获取或创建一个本地 Session 实例。
-     *
-     * 关键点（中文）
-     * - 同一个 `sessionId` 在单个 Agent 实例内只会装配一次。
-     * - 新建 session 时会把 instruction 与 plugin system 读取能力注入进去。
-     */
-    private getOrCreateSession;
-    /**
-     * 为 session 应用默认模型。
-     *
-     * 关键点（中文）
-     * - 同一个 session 在单个 Agent 实例中只会执行一次配置装配。
-     * - 默认模型会在首次访问/首次执行前写入当前 session。
-     */
-    private applySessionDefaults;
+    private create_session_manager;
 }
 //# sourceMappingURL=Agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../src/agent/local/Agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../src/agent/local/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EAEtB,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AASlD;;GAEG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwB;IAEzD,OAAO,CAAC,WAAW,CAAW;gBAElB,OAAO,EAAE,YAAY;IA2CjC;;OAEG;IACG,aAAa,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI3E;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1D;;OAEG;IACG,YAAY,CAChB,KAAK,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;IAInC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAItC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAI9C;;OAEG;IACH,SAAS,IAAI,cAAc;IAI3B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,oBAAoB,IAAI,sBAAsB;IAI9C,OAAO,CAAC,sBAAsB;CAgB/B"}