@downcity/agent 1.1.74 → 1.1.81

package/README.md

@@ -50,17 +50,18 @@ packages/agent
 ```text
 src/
 ├── index.ts               # 包公开入口，集中导出外部可依赖的 API 与协议类型
+├── agent/                 # Agent SDK 入口，按 local / remote 拆分本地与远程实现
+│   ├── local/             # 本地 Agent facade 与实例装配中心
+│   └── remote/            # RemoteAgent facade、RemoteSession 与 HTTP/RPC transport
 ├── config/                # 配置与项目初始化，负责 downcity.json、默认配置、execution binding 与脚手架
 │   └── project/           # Agent 项目初始化与项目初始化类型
-├── core/                  # 单 Agent 运行时装配中心，负责 AgentCore / AgentContext
 ├── executor/              # 内部执行内核，负责历史、system、tool loop、增量输出与消息持久化
 ├── plugin/                # 插件系统，负责插件注册、hook、action、内建插件与插件类型
 ├── rpc/                   # Agent 本机 RPC runtime，对外 HTTP gateway 由 Town 提供
 ├── runtime/               # 运行时实现细节层，统一收纳 host / sandbox / control 等内部能力
 │   ├── host/              # 宿主注入能力协议
 │   └── sandbox/           # 命令沙箱与沙箱协议
-├── sdk/                   # 本地 SDK facade，提供 Agent / RemoteAgent / Session 等高层 API
-│   └── session/           # SDK session 的 metadata、落盘路径、持久化与 runtime 端口适配
+├── session/               # SDK session actor、metadata、落盘路径、持久化与 runtime 端口适配
 ├── types/                 # 跨模块共享协议类型，集中放置 common / config / runtime 等稳定契约
 └── utils/                 # 低层工具，负责 CLI、日志、存储与模板辅助
 ```
@@ -72,21 +73,17 @@ src/
   - `project/` 收口 agent 项目脚手架与初始化结果类型
   - 负责 `downcity.json`、项目 env、`.downcity/*` 路径规则与 execution binding
 
-- `src/core/`
-  - 单 Agent 装配中心
-  - `AgentCore` 负责把 config、session SDK、executor、plugin、runtime 组装成一个实例级执行内核
-  - `AgentContext` 提供统一能力面，供 session / executor / plugin 复用
-
-- `src/sdk/`
-  - 本地 SDK facade
-  - 包括 `Agent`、`RemoteAgent`、`Session` 与 `sdk/session/*`
-  - `Agent.ts` 通过 `start()/stop()` 统一收口长期运行生命周期
-  - `sdk/session/*` 负责 SDK session metadata、落盘路径、持久化与 runtime 端口适配
+- `src/agent/`
+  - SDK facade 层
+  - `local/Agent.ts` 负责本地 Agent 实例装配、plugin/session/RPC 生命周期
+  - `remote/RemoteAgent.ts` 负责远程 Agent 客户端入口
+  - `remote/RemoteSession.ts` 负责远程 session actor 与 turn lifecycle
+  - `remote/transports/*` 负责 HTTP/RPC transport 适配
 
 - `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、增量输出与消息持久化
 
@@ -120,13 +117,13 @@ src/
 `@downcity/agent` 的核心是一条单 Agent 执行链：
 
 ```text
-入口协议 -> AgentCore -> AgentContext -> Session SDK / Executor / Plugin -> Runtime 子系统 -> History / Reply
+入口协议 -> Agent facade -> AgentContext -> Session / Executor / Plugin -> Runtime 子系统 -> History / Reply
 ```
 
 其中：
 
-- `sdk` 是用户 API 面
-- `core` 是实例级装配中心
-- `session SDK / executor / plugin` 是三大核心分层
+- `agent/local` 与 `agent/remote` 是用户 API 面
+- `Agent` facade 是实例级装配中心
+- `session / executor / plugin` 是三大核心分层
 - `runtime` 是 control / sandbox / host 这类实现细节的统一容器
 - `types / utils` 提供横向公共支撑

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

@@ -0,0 +1,82 @@
+/**
+ * Agent local：本地入口与 facade。
+ *
+ * 职责说明（中文）
+ * - 对外暴露 `Agent` 这一唯一的本地实例类。
+ * - 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 { AgentCreateSessionInput, AgentListSessionsInput, AgentOptions, AgentSession, AgentSessionCollection, AgentSessionSummaryPage, AgentStartOptions, AgentStartResult, AgentStopResult } from "../../types/agent/AgentTypes.js";
+import { Logger } from "../../utils/logger/Logger.js";
+/**
+ * SDK 本地 Agent。
+ */
+export declare class Agent {
+    readonly id: string;
+    readonly path: string;
+    readonly tools: Record<string, Tool>;
+    readonly plugins: PluginPort;
+    private readonly logger;
+    private readonly runtime;
+    private readonly agentContext;
+    private readonly pluginRegistry;
+    private readonly config;
+    private readonly env;
+    private readonly defaultModel?;
+    private readonly SessionClass;
+    private readonly sessionManager;
+    private readonly lifecycleService;
+    private instruction;
+    constructor(options: AgentOptions);
+    /**
+     * 新建一个 session。
+     */
+    createSession(input?: AgentCreateSessionInput): Promise<AgentSession>;
+    /**
+     * 获取一个已存在的 session。
+     */
+    getSession(sessionId: string): Promise<AgentSession>;
+    /**
+     * 列出当前 agent 的 session 摘要页。
+     */
+    listSessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+    /**
+     * 启动当前 agent 实例的长期运行能力。
+     */
+    start(options?: AgentStartOptions): Promise<AgentStartResult>;
+    /**
+     * 停止当前 agent 实例的长期运行能力。
+     */
+    stop(): Promise<AgentStopResult>;
+    /**
+     * 更新当前 SDK Agent 的静态基础指令。
+     */
+    setInstruction(input: string | string[]): void;
+    /**
+     * 返回当前项目根目录解析后的配置快照。
+     */
+    getConfig(): DowncityConfig;
+    /**
+     * 返回当前 agent 绑定的统一日志器。
+     */
+    getLogger(): Logger;
+    /**
+     * 返回当前 agent runtime。
+     */
+    getRuntime(): AgentRuntime;
+    /**
+     * 返回当前 agent context。
+     */
+    getContext(): AgentContext;
+    /**
+     * 返回当前 session collection。
+     */
+    getSessionCollection(): AgentSessionCollection;
+    private create_session_manager;
+}
+//# sourceMappingURL=Agent.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}

package/bin/agent/local/Agent.js

@@ -0,0 +1,154 @@
+/**
+ * Agent local：本地入口与 facade。
+ *
+ * 职责说明（中文）
+ * - 对外暴露 `Agent` 这一唯一的本地实例类。
+ * - facade 只保留公开 API 与 service 组合，不再直接承载装配、session 管理与生命周期细节。
+ * - 单个 agent 的长期对象装配、session 管理、后台能力生命周期分别下沉到独立 service。
+ */
+import { normalizeInstructionInput } from "../../agent/local/AgentInstructions.js";
+import { AgentAssemblyService, } from "../../agent/local/services/AgentAssemblyService.js";
+import { AgentSessionManager } from "../../agent/local/services/AgentSessionManager.js";
+import { AgentLifecycleService } from "../../agent/local/services/AgentLifecycleService.js";
+/**
+ * SDK 本地 Agent。
+ */
+export class Agent {
+    id;
+    path;
+    tools;
+    plugins;
+    logger;
+    runtime;
+    agentContext;
+    pluginRegistry;
+    config;
+    env;
+    defaultModel;
+    SessionClass;
+    sessionManager;
+    lifecycleService;
+    instruction;
+    constructor(options) {
+        this.defaultModel = options.model;
+        this.SessionClass = options.Session;
+        let session_manager_ref = null;
+        const assembly_service = new AgentAssemblyService({
+            options,
+            list_cached_sessions: () => session_manager_ref?.list_cached_sessions() || [],
+            get_session_port: (session_id) => {
+                if (!session_manager_ref) {
+                    throw new Error("Agent session manager is not initialized");
+                }
+                return session_manager_ref.get_session_port(session_id);
+            },
+            resolve_session_model: async (session_id) => {
+                if (!session_manager_ref)
+                    return undefined;
+                const session = await session_manager_ref.get_session(session_id);
+                return session.config.model;
+            },
+        });
+        const assembly = assembly_service.assemble();
+        this.id = assembly.id;
+        this.path = assembly.path;
+        this.tools = assembly.tools;
+        this.plugins = assembly.plugins;
+        this.logger = assembly.logger;
+        this.runtime = assembly.runtime;
+        this.agentContext = assembly.agent_context;
+        this.pluginRegistry = assembly.plugin_registry;
+        this.config = assembly.config;
+        this.env = assembly.env;
+        this.instruction = assembly.instruction;
+        this.sessionManager = this.create_session_manager(assembly);
+        session_manager_ref = this.sessionManager;
+        this.lifecycleService = new AgentLifecycleService({
+            logger: this.logger,
+            agent_context: this.agentContext,
+            session_collection: this.sessionManager.get_session_collection(),
+            get_runtime: () => this.runtime,
+        });
+    }
+    /**
+     * 新建一个 session。
+     */
+    async createSession(input) {
+        return await this.sessionManager.create_session(input);
+    }
+    /**
+     * 获取一个已存在的 session。
+     */
+    async getSession(sessionId) {
+        return await this.sessionManager.get_session(sessionId);
+    }
+    /**
+     * 列出当前 agent 的 session 摘要页。
+     */
+    async listSessions(input) {
+        return await this.sessionManager.list_sessions(input);
+    }
+    /**
+     * 启动当前 agent 实例的长期运行能力。
+     */
+    async start(options) {
+        return await this.lifecycleService.start(options);
+    }
+    /**
+     * 停止当前 agent 实例的长期运行能力。
+     */
+    async stop() {
+        return await this.lifecycleService.stop();
+    }
+    /**
+     * 更新当前 SDK Agent 的静态基础指令。
+     */
+    setInstruction(input) {
+        this.instruction = normalizeInstructionInput(input);
+    }
+    /**
+     * 返回当前项目根目录解析后的配置快照。
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * 返回当前 agent 绑定的统一日志器。
+     */
+    getLogger() {
+        return this.logger;
+    }
+    /**
+     * 返回当前 agent runtime。
+     */
+    getRuntime() {
+        return this.runtime;
+    }
+    /**
+     * 返回当前 agent context。
+     */
+    getContext() {
+        return this.agentContext;
+    }
+    /**
+     * 返回当前 session collection。
+     */
+    getSessionCollection() {
+        return this.sessionManager.get_session_collection();
+    }
+    create_session_manager(assembly) {
+        return new AgentSessionManager({
+            agent_id: this.id || assembly.id,
+            project_root: this.path || assembly.path,
+            tools: this.tools || assembly.tools,
+            logger: this.logger || assembly.logger,
+            runtime: this.runtime || assembly.runtime,
+            get_agent_context: () => this.agentContext || assembly.agent_context,
+            get_instruction: () => this.instruction,
+            plugin_instances: assembly.plugin_instances,
+            default_model: this.defaultModel,
+            SessionClass: this.SessionClass,
+        });
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/bin/agent/local/Agent.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Agent instruction 组装工具。
+ *
+ * 关键点（中文）
+ * - 这里只处理静态 instruction 与默认 core prompt。
+ * - 不读取 session、plugin 或 runtime 状态，保持为纯函数。
+ */
+import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
+import type { AgentSessionSystemBlock } from "../../types/agent/AgentTypes.js";
+/**
+ * 创建 SDK 场景的最小 fallback 配置。
+ */
+export declare function createFallbackSdkConfig(agent_id: string): DowncityConfig;
+/**
+ * 归一化调用方传入的静态 instruction。
+ */
+export declare function normalizeInstructionInput(input: string | string[] | undefined): string[];
+/**
+ * 构造进入 session system prompt 的 instruction block。
+ */
+export declare function createInstructionSystemBlocks(instruction: string[], project_root: string): AgentSessionSystemBlock[];
+//# sourceMappingURL=AgentInstructions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInstructions.d.ts","sourceRoot":"","sources":["../../../src/agent/local/AgentInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAG3E;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAKxE;AAED;;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,CAe3B"}

package/bin/agent/local/AgentInstructions.js

@@ -0,0 +1,57 @@
+/**
+ * Agent instruction 组装工具。
+ *
+ * 关键点（中文）
+ * - 这里只处理静态 instruction 与默认 core prompt。
+ * - 不读取 session、plugin 或 runtime 状态，保持为纯函数。
+ */
+import { DEFAULT_SHIP_PROMPTS } from "../../executor/composer/system/default/SystemDomain.js";
+/**
+ * 创建 SDK 场景的最小 fallback 配置。
+ */
+export function createFallbackSdkConfig(agent_id) {
+    return {
+        id: agent_id,
+        version: "0.0.0",
+    };
+}
+/**
+ * 归一化调用方传入的静态 instruction。
+ */
+export function normalizeInstructionInput(input) {
+    const items = Array.isArray(input)
+        ? input
+        : typeof input === "string"
+            ? [input]
+            : [];
+    return items
+        .map((item) => String(item || "").trim())
+        .filter((item) => item.length > 0);
+}
+function createCoreInstructionContent(project_root) {
+    const current_year = String(new Date().getFullYear());
+    return DEFAULT_SHIP_PROMPTS
+        .replaceAll("{{project_path}}", project_root)
+        .replaceAll("{{project_root}}", project_root)
+        .replaceAll("{{current_year}}", current_year);
+}
+/**
+ * 构造进入 session system prompt 的 instruction block。
+ */
+export function createInstructionSystemBlocks(instruction, project_root) {
+    if (instruction.length === 0) {
+        return [
+            {
+                source: "core",
+                name: "default",
+                content: createCoreInstructionContent(project_root),
+            },
+        ];
+    }
+    return instruction.map((content, index) => ({
+        source: "instruction",
+        name: instruction.length === 1 ? "agent" : `agent:${index + 1}`,
+        content,
+    }));
+}
+//# sourceMappingURL=AgentInstructions.js.map

package/bin/agent/local/AgentInstructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInstructions.js","sourceRoot":"","sources":["../../../src/agent/local/AgentInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAEzF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,OAAO;KACC,CAAC;AACtB,CAAC;AAED;;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,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL;gBACE,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,4BAA4B,CAAC,YAAY,CAAC;aACpD;SACF,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,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;AACN,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Agent plugin 装配工厂。
+ *
+ * 关键点（中文）
+ * - 这里只负责把 plugin 实例装配成 registry 与对外 port。
+ * - Agent 仍然持有长期状态；这里不创建新的运行时层级。
+ */
+import type { BasePlugin } from "../../plugin/core/BasePlugin.js";
+import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
+import type { PluginPort } from "../../plugin/types/Plugin.js";
+import { PluginRegistry } from "../../plugin/core/PluginRegistry.js";
+/**
+ * 创建 plugin registry 的参数。
+ */
+export interface CreateAgentPluginRegistryOptions {
+    /** 当前 agent 显式注册的 plugin 实例。 */
+    plugins: BasePlugin[];
+    /** 延迟读取当前 AgentContext。 */
+    get_context: () => AgentContext;
+}
+/**
+ * 创建 plugin 注册表。
+ */
+export declare function createAgentPluginRegistry(options: CreateAgentPluginRegistryOptions): PluginRegistry;
+/**
+ * 创建对外暴露的 plugin 调用门面。
+ */
+export declare function createAgentPluginPort(plugin_registry: PluginRegistry): PluginPort;
+//# sourceMappingURL=AgentPluginFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPluginFactory.d.ts","sourceRoot":"","sources":["../../../src/agent/local/AgentPluginFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAEV,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,gCAAgC;IAChC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,YAAY,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,cAAc,CAqBhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,cAAc,GAC9B,UAAU,CAoBZ"}

package/bin/agent/local/AgentPluginFactory.js

@@ -0,0 +1,53 @@
+/**
+ * Agent plugin 装配工厂。
+ *
+ * 关键点（中文）
+ * - 这里只负责把 plugin 实例装配成 registry 与对外 port。
+ * - Agent 仍然持有长期状态；这里不创建新的运行时层级。
+ */
+import { HookRegistry } from "../../plugin/core/HookRegistry.js";
+import { PluginRegistry } from "../../plugin/core/PluginRegistry.js";
+import { isPluginEnabled } from "../../plugin/core/Activation.js";
+/**
+ * 创建 plugin 注册表。
+ */
+export function createAgentPluginRegistry(options) {
+    let plugin_registry_ref = null;
+    const hook_registry = new HookRegistry({
+        contextResolver: options.get_context,
+        pluginEnabledChecker: (plugin_name) => {
+            const plugin = plugin_registry_ref?.get(plugin_name);
+            return plugin
+                ? isPluginEnabled({ plugin, context: options.get_context() })
+                : false;
+        },
+    });
+    const registry = new PluginRegistry({
+        contextResolver: options.get_context,
+        hookRegistry: hook_registry,
+    });
+    plugin_registry_ref = registry;
+    for (const plugin of options.plugins) {
+        registry.register(plugin);
+    }
+    return registry;
+}
+/**
+ * 创建对外暴露的 plugin 调用门面。
+ */
+export function createAgentPluginPort(plugin_registry) {
+    return {
+        list: () => plugin_registry.list(),
+        availability: async (plugin_name) => await plugin_registry.availability(plugin_name),
+        runAction: async (params) => await plugin_registry.runAction(params),
+        pipeline: async (point_name, value) => await plugin_registry.pipeline(point_name, value),
+        guard: async (point_name, value) => {
+            await plugin_registry.guard(point_name, value);
+        },
+        effect: async (point_name, value) => {
+            await plugin_registry.effect(point_name, value);
+        },
+        resolve: async (point_name, value) => await plugin_registry.resolve(point_name, value),
+    };
+}
+//# sourceMappingURL=AgentPluginFactory.js.map

package/bin/agent/local/AgentPluginFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPluginFactory.js","sourceRoot":"","sources":["../../../src/agent/local/AgentPluginFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAY9D;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAyC;IAEzC,IAAI,mBAAmB,GAA0B,IAAI,CAAC;IACtD,MAAM,aAAa,GAAG,IAAI,YAAY,CAAC;QACrC,eAAe,EAAE,OAAO,CAAC,WAAW;QACpC,oBAAoB,EAAE,CAAC,WAAW,EAAE,EAAE;YACpC,MAAM,MAAM,GAAG,mBAAmB,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;YACrD,OAAO,MAAM;gBACX,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC7D,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QAClC,eAAe,EAAE,OAAO,CAAC,WAAW;QACpC,YAAY,EAAE,aAAa;KAC5B,CAAC,CAAC;IACH,mBAAmB,GAAG,QAAQ,CAAC;IAE/B,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,eAA+B;IAE/B,OAAO;QACL,IAAI,EAAE,GAAiB,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE;QAChD,YAAY,EAAE,KAAK,EAAE,WAAmB,EAA+B,EAAE,CACvE,MAAM,eAAe,CAAC,YAAY,CAAC,WAAW,CAAC;QACjD,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC;QACpE,QAAQ,EAAE,KAAK,EAAK,UAAkB,EAAE,KAAQ,EAAc,EAAE,CAC9D,MAAM,eAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;QACnD,KAAK,EAAE,KAAK,EAAK,UAAkB,EAAE,KAAQ,EAAiB,EAAE;YAC9D,MAAM,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,EAAE,KAAK,EAAK,UAAkB,EAAE,KAAQ,EAAiB,EAAE;YAC/D,MAAM,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,EAAE,KAAK,EACZ,UAAkB,EAClB,KAAa,EACK,EAAE,CACpB,MAAM,eAAe,CAAC,OAAO,CAAkB,UAAU,EAAE,KAAK,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/bin/{runtime/host/AgentHostRuntime.d.ts → agent/local/AgentRuntimeAssembly.d.ts}

@@ -1,4 +1,4 @@
-import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../types/runtime/host/AgentHost.js";
+import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../types/agent/AgentRuntimeAssembly.js";
 /**
  * 创建当前项目的路径能力集合。
  */
@@ -7,4 +7,4 @@ export declare function createAgentPathRuntime(projectRoot: string, agentIdInput
  * 创建 plugin 配置持久化能力集合。
  */
 export declare function createAgentPluginConfigRuntime(projectRoot: string): AgentPluginConfigRuntime;
-//# sourceMappingURL=AgentHostRuntime.d.ts.map
+//# sourceMappingURL=AgentRuntimeAssembly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeAssembly.d.ts","sourceRoot":"","sources":["../../../src/agent/local/AgentRuntimeAssembly.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,uCAAuC,CAAC;AAG/C;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAkBlB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAY5F"}

package/bin/{runtime/host/AgentHostRuntime.js → agent/local/AgentRuntimeAssembly.js}

@@ -1,5 +1,5 @@
 /**
- * AgentHostRuntime：装配 AgentRuntime 宿主能力。
+ * AgentRuntimeAssembly：装配本地 AgentRuntime 能力。
  *
  * 关键点（中文）
  * - agent runtime 负责创建这些宿主能力对象，再注入到 AgentRuntime。
@@ -45,4 +45,4 @@ export function createAgentPluginConfigRuntime(projectRoot) {
         },
     };
 }
-//# sourceMappingURL=AgentHostRuntime.js.map
+//# sourceMappingURL=AgentRuntimeAssembly.js.map

package/bin/agent/local/AgentRuntimeAssembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeAssembly.js","sourceRoot":"","sources":["../../../src/agent/local/AgentRuntimeAssembly.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAOjF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO;QACL,WAAW,EAAE,QAAQ;QACrB,OAAO;QACP,kBAAkB,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QACtD,eAAe,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC;QAChD,yBAAyB,EAAE,GAAG,EAAE,CAAC,yBAAyB,CAAC,QAAQ,CAAC;QACpE,0BAA0B,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,QAAQ,CAAC;QACtE,0BAA0B,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,0BAA0B,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC1F,6BAA6B,EAAE,GAAG,EAAE,CAAC,6BAA6B,CAAC,QAAQ,CAAC;QAC5E,6BAA6B,EAAE,GAAG,EAAE,CAAC,6BAA6B,CAAC,QAAQ,CAAC;QAC5E,0BAA0B,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC,QAAQ,EAAE,IAAI,CAAC;QAChF,6BAA6B,EAAE,GAAG,EAAE,CAAC,6BAA6B,CAAC,QAAQ,EAAE,OAAO,CAAC;QACrF,yBAAyB,EAAE,CAAC,SAAS,EAAE,EAAE,CACvC,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAChE,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO;QACL,KAAK,CAAC,qBAAqB,CAAC,OAA8C;YACxE,OAAO,0BAA0B,CAAC;gBAChC,WAAW,EAAE,QAAQ;gBACrB,QAAQ,EAAE;oBACR,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9C;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,72 @@
+/**
+ * Agent runtime / context 装配工厂。
+ *
+ * 关键点（中文）
+ * - 这里只创建长期 runtime 视图与执行期 context 视图。
+ * - Agent 仍然持有 session/plugin 状态；这里通过函数参数读取状态。
+ */
+import type { BasePlugin } from "../../plugin/core/BasePlugin.js";
+import type { Logger } from "../../utils/logger/Logger.js";
+import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
+import type { LanguageModel } from "ai";
+import type { AgentContext, SessionPort } from "../../types/runtime/agent/AgentContext.js";
+import type { AgentRuntime } from "../../types/runtime/agent/AgentRuntime.js";
+import type { PluginPort } from "../../plugin/types/Plugin.js";
+import type { AgentManagedSession } from "../../types/agent/AgentTypes.js";
+/**
+ * 创建 AgentRuntime 的参数。
+ */
+export interface CreateAgentRuntimeOptions {
+    /** 当前 agent id。 */
+    agent_id: string;
+    /** 当前项目根目录。 */
+    project_root: string;
+    /** 统一日志器。 */
+    logger: Logger;
+    /** 当前解析后的配置。 */
+    config: DowncityConfig;
+    /** 当前环境变量快照。 */
+    env: Record<string, string>;
+    /** 当前静态 system 文本集合。 */
+    systems: string[];
+    /** 当前 plugin 实例集合。 */
+    plugin_instances: Map<string, BasePlugin>;
+    /** 获取或创建 session runtime port。 */
+    get_session_port: (session_id: string) => SessionPort;
+    /** 读取当前已缓存的 session 实例。 */
+    list_cached_sessions: () => AgentManagedSession[];
+}
+/**
+ * 创建 AgentContext 的参数。
+ */
+export interface CreateAgentContextOptions {
+    /** 当前 AgentRuntime。 */
+    runtime: AgentRuntime;
+    /** 当前项目根目录。 */
+    project_root: string;
+    /** 统一日志器。 */
+    logger: Logger;
+    /** 当前解析后的配置。 */
+    config: DowncityConfig;
+    /** 当前环境变量快照。 */
+    env: Record<string, string>;
+    /** 当前静态 system 文本集合。 */
+    systems: string[];
+    /** 当前 plugin 实例集合。 */
+    plugin_instances: Map<string, BasePlugin>;
+    /** 对外 plugin 调用端口。 */
+    plugins: PluginPort;
+    /** 获取或创建 session runtime port。 */
+    get_session_port: (session_id: string) => SessionPort;
+    /** 解析 session 当前绑定的模型实例。 */
+    resolve_session_model: (session_id: string) => Promise<LanguageModel | undefined>;
+}
+/**
+ * 创建实例级 runtime 视图。
+ */
+export declare function createAgentRuntime(options: CreateAgentRuntimeOptions): AgentRuntime;
+/**
+ * 创建统一执行上下文。
+ */
+export declare function createAgentContext(options: CreateAgentContextOptions): AgentContext;
+//# sourceMappingURL=AgentRuntimeFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeFactory.d.ts","sourceRoot":"","sources":["../../../src/agent/local/AgentRuntimeFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMvE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,wBAAwB;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sBAAsB;IACtB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,kCAAkC;IAClC,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,WAAW,CAAC;IACtD,2BAA2B;IAC3B,oBAAoB,EAAE,MAAM,mBAAmB,EAAE,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,wBAAwB;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sBAAsB;IACtB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,sBAAsB;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,kCAAkC;IAClC,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,WAAW,CAAC;IACtD,4BAA4B;IAC5B,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;CACnF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAuBd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAyCd"}