@downcity/agent 1.1.73 → 1.1.79

package/README.md

@@ -7,7 +7,7 @@
 - 本地 SDK：`Agent`、`Session`、`RemoteAgent`
 - 内部执行内核：history、system、tool loop、增量输出
 - Plugin 框架：hook、action、内建插件
-- 运行时实现：HTTP server、sandbox、host
+- 运行时实现：RPC runtime、sandbox、host
 
 `downcity` 负责多 Agent 管理、控制面网关、平台 CLI、共享模型目录接入与 daemon 进程管理；`@downcity/agent` 只负责单 Agent 的执行面。
 
@@ -15,14 +15,14 @@
 
 - 面向单个 Agent 项目的执行面
 - 对外通过 `@downcity/agent` 根入口暴露公共 API
-- 负责 session SDK、executor 内核、plugin、sandbox、HTTP server、SDK 本地 Agent
+- 负责 session SDK、executor 内核、plugin、sandbox、RPC runtime、SDK 本地 Agent
 - 不负责多 Agent registry、control plane daemon、console UI 聚合和平台级编排
 
 ## 与其他包的边界
 
 - `@downcity/agent`
   - 单 Agent runtime
-  - 单 Agent HTTP server
+  - 单 Agent RPC runtime
   - session SDK、executor 内核、plugin 框架、sandbox
   - 本地 SDK facade
 - `downcity`
@@ -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、内建插件与插件类型
-├── runtime/               # 运行时实现细节层，统一收纳 host / sandbox / server / transport
-│   ├── host/              # 宿主注入能力与 daemon 协议
-│   ├── sandbox/           # 命令沙箱与沙箱协议
-│   └── server/            # HTTP 服务端实现
-├── sdk/                   # 本地 SDK facade，提供 Agent / RemoteAgent / Session 等高层 API
-│   └── session/           # SDK session 的 metadata、落盘路径、持久化与 runtime 端口适配
+├── rpc/                   # Agent 本机 RPC runtime，对外 HTTP gateway 由 Town 提供
+├── runtime/               # 运行时实现细节层，统一收纳 host / sandbox / control 等内部能力
+│   ├── host/              # 宿主注入能力协议
+│   └── sandbox/           # 命令沙箱与沙箱协议
+├── session/               # SDK session actor、metadata、落盘路径、持久化与 runtime 端口适配
 ├── types/                 # 跨模块共享协议类型，集中放置 common / config / runtime 等稳定契约
 └── utils/                 # 低层工具，负责 CLI、日志、存储与模板辅助
 ```
@@ -72,16 +73,12 @@ 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/`
   - 内部执行内核
@@ -98,9 +95,10 @@ src/
 
 - `src/runtime/`
   - 单 Agent 的运行时实现细节层
-  - `host/` 放宿主注入能力与 daemon 协议
+  - `host/` 放宿主注入能力协议
   - `sandbox/` 放命令执行隔离与沙箱协议
-  - `server/` 放 HTTP 服务端实现
+  - `control/` 放 runtime 控制面内部协议与处理器
+- `src/rpc/` 放 Agent 本机 RPC runtime；HTTP gateway 由 Town CLI 基于 RPC 转发提供
 - 模型实例解析不在 `agent` 包内完成，而由宿主先创建 `LanguageModel`，再通过 `new Agent({ model })` 或 `session.set({ model })` 注入
 - `model` 也可以接收 City City 返回的 `CityModel`，Agent 会在内部适配成 AI SDK `LanguageModel`
 
@@ -108,7 +106,7 @@ src/
   - 跨模块、跨包共享协议类型
   - `common/` 放 JSON、模板等无领域依赖的基础类型
   - `config/` 放 `downcity.json`、LLM、execution binding、plugin 配置、start options 等配置契约
-  - `runtime/` 放 auth、daemon、host、http、platform 等运行时与控制面共享协议
+  - `runtime/` 放 auth、agent、host、platform 等运行时与控制面共享协议
   - 领域内部类型仍保留在对应领域目录，例如 `plugin/types/`、`executor/types/`
 
 - `src/utils/`
@@ -119,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` 是三大核心分层
-- `runtime` 是 server / transport / sandbox / host 这类实现细节的统一容器
+- `agent/local` 与 `agent/remote` 是用户 API 面
+- `Agent` facade 是实例级装配中心
+- `session / executor / plugin` 是三大核心分层
+- `runtime` 是 control / sandbox / host 这类实现细节的统一容器
 - `types / utils` 提供横向公共支撑

package/bin/agent/{Agent.d.ts → local/Agent.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Agent 本地入口与实例装配中心。
+ * Agent local：本地入口与实例装配中心。
  *
  * 职责说明（中文）
  * - 对外暴露 `Agent` 这一唯一的本地实例类。
@@ -11,12 +11,12 @@
  * - 这里不直接实现 session 执行细节，而是继续复用 `Session` / `Executor` 体系。
  */
 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 { Logger } from "../utils/logger/Logger.js";
+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 { Logger } from "../../utils/logger/Logger.js";
 /**
  * SDK 本地 Agent。
  */
@@ -98,7 +98,7 @@ export declare class Agent {
      * 返回当前 agent runtime。
      *
      * 关键点（中文）
-     * - 供宿主在 agent 外部装配 transport（例如 city HTTP gateway）时复用。
+     * - 供宿主在 agent 外部装配 transport（例如 Town HTTP gateway）时复用。
      * - 不暴露启动语义，只暴露运行时访问口。
      */
     getRuntime(): AgentRuntime;
@@ -163,18 +163,6 @@ export declare class Agent {
      * - 所有 plugin 在注册前都会绑定到当前实例 runtime。
      */
     private registerPlugins;
-    /**
-     * 创建 plugin 注册表。
-     *
-     * 关键点（中文）
-     * - registry 本身不直接持有静态上下文，而是通过 resolver 延迟读取当前 `agentContext`。
-     * - 这样 hook 调度与 availability 判断都能复用同一份上下文视图。
-     */
-    private createPluginRegistry;
-    /**
-     * 创建对外暴露的 plugin 调用门面。
-     */
-    private createPluginPort;
     /**
      * 读取当前 agent 静态 instruction blocks。
      */
@@ -187,22 +175,6 @@ export declare class Agent {
      * - 这里只加载当前启用且可用的 plugin system 文本。
      */
     private loadPluginSystemBlocks;
-    /**
-     * 创建实例级 runtime 视图。
-     *
-     * 关键点（中文）
-     * - runtime 描述的是当前 agent 实例持有的长期状态。
-     * - 其他 server / plugin / transport 都通过这个视图读取统一状态。
-     */
-    private createRuntime;
-    /**
-     * 创建统一执行上下文。
-     *
-     * 关键点（中文）
-     * - `AgentContext` 是执行期能力视图，不是状态实体本身。
-     * - plugin runtime、chat runtime、shell tool 都通过这里消费能力。
-     */
-    private createAgentContext;
     /**
      * 获取或创建一个本地 Session 实例。
      *

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

package/bin/agent/{Agent.js → local/Agent.js}

@@ -1,5 +1,5 @@
 /**
- * Agent 本地入口与实例装配中心。
+ * Agent local：本地入口与实例装配中心。
  *
  * 职责说明（中文）
  * - 对外暴露 `Agent` 这一唯一的本地实例类。
@@ -12,58 +12,18 @@
  */
 import fs from "fs-extra";
 import { nanoid } from "nanoid";
-import { Logger } from "../utils/logger/Logger.js";
-import { Session } from "../session/Session.js";
-import { DEFAULT_SHIP_PROMPTS } from "../executor/composer/system/default/SystemDomain.js";
-import { getSdkAgentSessionDirPath, listAgentSessionSummaryPage, } from "../session/index.js";
-import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../runtime/host/AgentHostRuntime.js";
-import { loadDowncityConfig, resolveAgentEnv } from "../config/Config.js";
-import { HookRegistry } from "../plugin/core/HookRegistry.js";
-import { PluginRegistry } from "../plugin/core/PluginRegistry.js";
-import { isPluginEnabled } from "../plugin/core/Activation.js";
-import { setShellToolRuntime } from "../executor/tools/shell/ShellToolDefinition.js";
-import { startAllPlugins, stopAllPlugins } from "../plugin/core/Manager.js";
-import { startActionScheduleRuntime } from "../plugin/core/ActionScheduleRuntime.js";
-import { startRpcServer } from "../rpc/Server.js";
-function createFallbackSdkConfig(agentId) {
-    return {
-        id: agentId,
-        version: "0.0.0",
-    };
-}
-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(projectRoot) {
-    const currentYear = String(new Date().getFullYear());
-    return DEFAULT_SHIP_PROMPTS
-        .replaceAll("{{project_path}}", projectRoot)
-        .replaceAll("{{project_root}}", projectRoot)
-        .replaceAll("{{current_year}}", currentYear);
-}
-function createInstructionSystemBlocks(instruction, projectRoot) {
-    if (instruction.length === 0) {
-        return [
-            {
-                source: "core",
-                name: "default",
-                content: createCoreInstructionContent(projectRoot),
-            },
-        ];
-    }
-    return instruction.map((content, index) => ({
-        source: "instruction",
-        name: instruction.length === 1 ? "agent" : `agent:${index + 1}`,
-        content,
-    }));
-}
+import { Logger } from "../../utils/logger/Logger.js";
+import { Session } from "../../session/Session.js";
+import { getSdkAgentSessionDirPath, listAgentSessionSummaryPage, } from "../../session/index.js";
+import { loadDowncityConfig, resolveAgentEnv } from "../../config/Config.js";
+import { isPluginEnabled } from "../../plugin/core/Activation.js";
+import { setShellToolRuntime } from "../../executor/tools/shell/ShellToolDefinition.js";
+import { startAllPlugins, stopAllPlugins } from "../../plugin/core/Manager.js";
+import { startActionScheduleRuntime } from "../../plugin/core/ActionScheduleRuntime.js";
+import { startRpcServer } from "../../rpc/Server.js";
+import { createFallbackSdkConfig, createInstructionSystemBlocks, normalizeInstructionInput, } from "../../agent/local/AgentInstructions.js";
+import { createAgentPluginPort, createAgentPluginRegistry, } from "../../agent/local/AgentPluginFactory.js";
+import { createAgentContext, createAgentRuntime, } from "../../agent/local/AgentRuntimeFactory.js";
 /**
  * SDK 本地 Agent。
  */
@@ -107,13 +67,38 @@ export class Agent {
         this.defaultModel = options.model;
         this.config = this.loadConfig();
         this.pluginInstances = new Map();
-        this.runtime = this.createRuntime();
+        this.runtime = createAgentRuntime({
+            agent_id: this.id,
+            project_root: this.path,
+            logger: this.logger,
+            config: this.config,
+            env: this.env,
+            systems: this.instruction,
+            plugin_instances: this.pluginInstances,
+            get_session_port: (session_id) => this.getOrCreateSession(session_id).getRuntimePort(),
+            list_cached_sessions: () => [...this.sessionsById.values()],
+        });
         this.registerPlugins(options.plugins || []);
-        this.pluginRegistry = this.createPluginRegistry([
-            ...this.pluginInstances.values(),
-        ]);
-        this.plugins = this.createPluginPort();
-        this.agentContext = this.createAgentContext();
+        this.pluginRegistry = createAgentPluginRegistry({
+            plugins: [...this.pluginInstances.values()],
+            get_context: () => this.agentContext,
+        });
+        this.plugins = createAgentPluginPort(this.pluginRegistry);
+        this.agentContext = createAgentContext({
+            runtime: this.runtime,
+            project_root: this.path,
+            logger: this.logger,
+            config: this.config,
+            env: this.env,
+            systems: this.instruction,
+            plugin_instances: this.pluginInstances,
+            plugins: this.plugins,
+            get_session_port: (session_id) => this.getOrCreateSession(session_id).getRuntimePort(),
+            resolve_session_model: async (session_id) => {
+                const session = await this.getSession(session_id);
+                return session.config.model;
+            },
+        });
         setShellToolRuntime(this.agentContext.invoke);
         this.sessionCollection = {
             createSession: async (input) => await this.createSession(input),
@@ -255,7 +240,7 @@ export class Agent {
      * 返回当前 agent runtime。
      *
      * 关键点（中文）
-     * - 供宿主在 agent 外部装配 transport（例如 city HTTP gateway）时复用。
+     * - 供宿主在 agent 外部装配 transport（例如 Town HTTP gateway）时复用。
      * - 不暴露启动语义，只暴露运行时访问口。
      */
     getRuntime() {
@@ -397,52 +382,6 @@ export class Agent {
             this.pluginInstances.set(name, plugin);
         }
     }
-    /**
-     * 创建 plugin 注册表。
-     *
-     * 关键点（中文）
-     * - registry 本身不直接持有静态上下文，而是通过 resolver 延迟读取当前 `agentContext`。
-     * - 这样 hook 调度与 availability 判断都能复用同一份上下文视图。
-     */
-    createPluginRegistry(input) {
-        let pluginRegistryRef = null;
-        const hookRegistry = new HookRegistry({
-            contextResolver: () => this.agentContext,
-            pluginEnabledChecker: (pluginName) => {
-                const plugin = pluginRegistryRef?.get(pluginName);
-                return plugin
-                    ? isPluginEnabled({ plugin, context: this.agentContext })
-                    : false;
-            },
-        });
-        const registry = new PluginRegistry({
-            contextResolver: () => this.agentContext,
-            hookRegistry,
-        });
-        pluginRegistryRef = registry;
-        for (const plugin of input) {
-            registry.register(plugin);
-        }
-        return registry;
-    }
-    /**
-     * 创建对外暴露的 plugin 调用门面。
-     */
-    createPluginPort() {
-        return {
-            list: () => this.pluginRegistry.list(),
-            availability: async (pluginName) => await this.pluginRegistry.availability(pluginName),
-            runAction: async (params) => await this.pluginRegistry.runAction(params),
-            pipeline: async (pointName, value) => await this.pluginRegistry.pipeline(pointName, value),
-            guard: async (pointName, value) => {
-                await this.pluginRegistry.guard(pointName, value);
-            },
-            effect: async (pointName, value) => {
-                await this.pluginRegistry.effect(pointName, value);
-            },
-            resolve: async (pointName, value) => await this.pluginRegistry.resolve(pointName, value),
-        };
-    }
     /**
      * 读取当前 agent 静态 instruction blocks。
      */
@@ -484,100 +423,6 @@ export class Agent {
         }
         return out;
     }
-    /**
-     * 创建实例级 runtime 视图。
-     *
-     * 关键点（中文）
-     * - runtime 描述的是当前 agent 实例持有的长期状态。
-     * - 其他 server / plugin / transport 都通过这个视图读取统一状态。
-     */
-    createRuntime() {
-        const runtime = {
-            cwd: this.path,
-            rootPath: this.path,
-            logger: this.logger,
-            config: this.config,
-            env: this.env,
-            systems: this.instruction,
-            paths: createAgentPathRuntime(this.path, this.id),
-            pluginConfig: createAgentPluginConfigRuntime(this.path),
-            getSession: (sessionId) => this.getOrCreateSession(sessionId).getRuntimePort(),
-            listExecutingSessionIds: () => [...this.sessionsById.values()]
-                .filter((session) => session.isExecuting())
-                .map((session) => session.id),
-            getExecutingSessionCount: () => [...this.sessionsById.values()].filter((session) => session.isExecuting()).length,
-            pluginInstances: this.pluginInstances,
-        };
-        return runtime;
-    }
-    /**
-     * 创建统一执行上下文。
-     *
-     * 关键点（中文）
-     * - `AgentContext` 是执行期能力视图，不是状态实体本身。
-     * - plugin runtime、chat runtime、shell tool 都通过这里消费能力。
-     */
-    createAgentContext() {
-        let context;
-        context = {
-            agent: this.runtime,
-            cwd: this.path,
-            rootPath: this.path,
-            logger: this.logger,
-            config: this.config,
-            env: this.env,
-            systems: this.instruction,
-            paths: this.runtime.paths,
-            pluginConfig: this.runtime.pluginConfig,
-            session: {
-                get: (sessionId) => this.getOrCreateSession(sessionId).getRuntimePort(),
-                listExecutingSessionIds: () => this.runtime.listExecutingSessionIds(),
-                getExecutingSessionCount: () => this.runtime.getExecutingSessionCount(),
-                resolveModel: async (sessionId) => {
-                    const session = await this.getSession(sessionId);
-                    return session.config.model;
-                },
-            },
-            invoke: {
-                invoke: async (params) => {
-                    const pluginName = String(params.plugin || "").trim();
-                    const actionName = String(params.action || "").trim();
-                    const plugin = this.pluginInstances.get(pluginName);
-                    if (!plugin) {
-                        return {
-                            success: false,
-                            error: `Unknown plugin: ${pluginName}`,
-                        };
-                    }
-                    const action = plugin.actions[actionName];
-                    if (!action) {
-                        return {
-                            success: false,
-                            error: `Unknown action: ${pluginName}.${actionName}`,
-                        };
-                    }
-                    const result = await action.execute({
-                        context,
-                        payload: params.payload ?? null,
-                        pluginName,
-                        actionName,
-                    });
-                    if (!result.success) {
-                        return {
-                            success: false,
-                            ...(result.error ? { error: result.error } : {}),
-                        };
-                    }
-                    return {
-                        success: true,
-                        ...(result.data !== undefined ? { data: result.data } : {}),
-                    };
-                },
-            },
-            plugins: this.plugins,
-        };
-        return context;
-    }
     /**
      * 获取或创建一个本地 Session 实例。
      *

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