@downcity/agent 1.1.1 → 1.1.5

package/README.md

@@ -0,0 +1,226 @@
+# @downcity/agent
+
+`@downcity/agent` 是 Downcity 的单 Agent 运行时包。
+
+它负责把一个 agent 项目目录装配成可执行运行时，包括 session、service、plugin、HTTP、RPC、sandbox 与宿主能力。  
+`@downcity/city` 负责多 Agent 管理、控制面网关、console/daemon；真正的单 Agent 执行内核在这个包里。
+
+## 包定位
+
+- 面向单个 Agent 运行时。
+- 对外暴露统一公开 API，供 `@downcity/city` 和其他调用方使用。
+- 负责执行层，不负责多 Agent 编排和全局控制面。
+- 包外调用统一从 `@downcity/agent` 根入口读取，不再依赖内部子路径。
+
+## 与其他包的边界
+
+- `@downcity/agent`
+  - 单 Agent 宿主、执行、会话、服务、插件、HTTP/RPC、沙箱。
+- `@downcity/city`
+  - 多 Agent registry、control-plane runtime、gateway/control plane、用户入口 CLI。
+- `@downcity/ui`
+  - React UI 组件与展示层，不承载运行时执行。
+
+## 根目录结构
+
+```text
+packages/agent
+├── bin/                # 构建输出目录
+├── scripts/            # 构建辅助脚本
+├── src/                # 源码目录
+├── package.json        # 包信息、导出面、脚本
+├── README.md           # 面向使用者的包说明
+└── tsconfig.json       # TypeScript 配置
+```
+
+## 源码结构树
+
+```text
+src
+├── index.ts
+├── agent/
+├── config/
+├── host/
+│   ├── daemon/
+│   ├── rpc/
+│   ├── runtime/
+│   └── sdk/
+├── http/
+├── model/
+├── plugin/
+├── plugins/
+├── sandbox/
+├── service/
+│   ├── builtins/
+│   ├── core/
+│   └── schedule/
+├── session/
+├── shared/
+└── types/
+```
+
+## 目录职责
+
+- `src/index.ts`
+  - 包的唯一公开入口。
+  - 统一导出单 Agent 运行时最常用的能力，避免上层依赖内部目录树。
+
+- `src/agent/`
+  - Agent 宿主装配层。
+  - 负责初始化 runtime、构建 `AgentContext`、装配 model、session、service、plugin。
+  - `project/` 子目录负责项目初始化和 execution binding。
+
+- `src/config/`
+  - 配置与路径解析层。
+  - 负责读取 `downcity.json`、env 快照和 `.downcity` 相关路径。
+
+- `src/host/`
+  - 单 Agent 宿主相关能力。
+  - `daemon/`：项目准备、宿主接入、启动前校验。
+  - `rpc/`：本地 IPC / RPC 入口与客户端。
+  - `runtime/`：宿主运行时辅助能力，例如路径与 plugin runtime 装配。
+  - `sdk/`：对外 SDK，包括 `Agent`、`RemoteAgent`、`Session` 等宿主访问封装。
+
+- `src/http/`
+  - 单 Agent HTTP 服务层。
+  - `auth/`：认证与路由鉴权。
+  - `control/`：单 Agent control API。
+  - `execute/`：直接执行入口。
+  - `health/`：健康检查。
+  - `plugins/`：插件相关 HTTP 入口。
+  - `services/`：service HTTP 路由挂载。
+  - `static/`：静态资源路由。
+
+- `src/model/`
+  - 模型创建与模型管理辅助层。
+
+- `src/plugin/`
+  - 插件框架层。
+  - 负责插件注册、启用态、命令桥接、HTTP 路由与生命周期。
+
+- `src/plugins/`
+  - 内建插件实现。
+  - 当前包括 `auth`、`skill`、`web`、`asr`、`tts`、`voice`、`workboard` 等。
+
+- `src/sandbox/`
+  - 命令执行沙箱实现。
+  - 负责 shell/task 等执行进入受限环境。
+  - 这是 agent 内部真实执行沙箱，不是 city 侧控制面概念。
+
+- `src/service/`
+  - 单 Agent service 域。
+  - `core/`：service 框架层，负责注册、生命周期控制、action 分发、系统提示注入。
+  - `builtins/`：内建 service 实现，例如 chat、task、memory、shell、contact。
+  - `schedule/`：service action 的调度与持久化。
+
+- `src/session/`
+  - 会话执行内核。
+  - 负责消息历史、system prompt、tools、compaction、executor。
+
+- `src/shared/`
+  - 跨层共享常量、共享协议类型、共享工具。
+  - 适合包内跨层复用的内容。
+  - 这里的目录结构用于内部组织，不作为包外公开导入路径。
+
+- `src/types/`
+  - 当前只保留少量基础运行时类型。
+  - 主要剩余 `session/` 与 `sandbox/` 这类仍适合集中维护的底层类型。
+  - 其他领域类型应优先放回各自模块旁边，避免重新形成“大一统 types 目录”。
+
+## 导出约定
+
+- 唯一公开入口是 `@downcity/agent`。
+- `shared/types`、`host/*`、`service/*`、`session/*`、`plugin/*` 等目录只表达源码分层，不作为公开导入地址。
+- 如果 `city` 或其他包需要新能力，应先补到 `src/index.ts`，而不是直接依赖内部文件路径。
+
+## 关键边界
+
+- `host/`
+  - 表示“单 Agent 宿主能力”。
+  - 比旧的 `daemon/rpc/runtime/sdk` 平铺结构更清晰。
+
+- `service/core/`
+  - 表示 service 框架和管理层。
+  - 不放具体业务 service 实现。
+
+- `service/builtins/`
+  - 表示内建单 Agent service 实现。
+  - 这里的 `chat`、`task`、`memory`、`shell`、`contact` 都是业务 service。
+
+- `http/control/`
+  - 表示单 Agent control API。
+  - 不等于 city 的 gateway/control plane。
+  - 当前统一路径是 `/api/control/*`。
+
+- `city`
+  - 不复制 agent 内部执行逻辑。
+  - 应优先通过 `@downcity/agent` 根入口拿能力，而不是深入内部子路径。
+
+## 关键调用关系
+
+### 1. Agent 启动
+
+```text
+initAgentRuntime()
+  -> 读取 config / env
+  -> 创建 model
+  -> 创建 session 组件
+  -> 创建 service 实例
+  -> 初始化 plugins
+  -> 导出 AgentContext
+```
+
+关键入口：
+
+- `src/agent/AgentRuntime.ts`
+- `src/agent/AgentContext.ts`
+
+### 2. HTTP 执行
+
+```text
+HTTP Request
+  -> src/http/Server.ts
+  -> src/http/execute or src/http/control
+  -> Session / Executor
+  -> tools / services / plugins
+```
+
+### 3. Service 调用
+
+```text
+AgentContext.invoke
+  -> src/service/core/Manager.ts
+  -> src/service/core/ServiceActionRunner.ts
+  -> src/service/builtins/* 具体实现
+```
+
+### 4. 沙箱执行
+
+```text
+task / shell service
+  -> src/sandbox/SandboxRunner.ts
+  -> src/sandbox/MacOsSeatbeltSandbox.ts
+```
+
+## 当前最重要的入口文件
+
+- `src/index.ts`
+  - 包的统一公开入口。
+- `src/agent/AgentRuntime.ts`
+  - 单 Agent runtime 主装配入口。
+- `src/http/Server.ts`
+  - HTTP 服务装配入口。
+- `src/session/Session.ts`
+  - 单 Session 外层实例。
+- `src/service/core/Manager.ts`
+  - service 管理门面。
+- `src/host/sdk/Agent.ts`
+  - SDK 访问入口。
+
+## 维护约定
+
+- 不要把多 Agent 管理逻辑写进这个包。
+- 不要在 `city` 中复制 agent 的执行期实现。
+- 上层产品优先从 `@downcity/agent` 根入口获取能力。
+- `service/core` 和 `service/builtins` 必须保持边界清晰。
+- `bin/` 是构建产物，不直接修改。

package/bin/agent/AgentContext.d.ts

@@ -6,8 +6,8 @@
  * - `AgentContext` 表达的是“执行期能力面”，不是宿主本体；真正的宿主状态仍由 `AgentRuntime` 持有。
  * - 该模块把 service invoke、plugin port、chat runtime port 收敛成稳定端口集合。
  */
-import type { AgentContext } from "../types/agent/AgentContext.js";
-import type { AgentRuntime } from "../types/agent/AgentRuntime.js";
+import type { AgentContext } from "../agent/AgentContextTypes.js";
+import type { AgentRuntime } from "../agent/AgentRuntimeTypes.js";
 /**
  * 从 agent 状态派生统一执行上下文。
  */

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

@@ -1 +1 @@
-{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../src/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,+BAA+B,CAAC;AAOvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA6HlE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAmBpE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;GAGG"}
+{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../src/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAOtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA6HjE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAmBpE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;GAGG"}

package/bin/agent/AgentContext.js

@@ -6,12 +6,12 @@
  * - `AgentContext` 表达的是“执行期能力面”，不是宿主本体；真正的宿主状态仍由 `AgentRuntime` 持有。
  * - 该模块把 service invoke、plugin port、chat runtime port 收敛成稳定端口集合。
  */
-import { runServiceCommand } from "../service/Manager.js";
+import { runServiceCommand } from "../service/core/Manager.js";
 import { getPluginManager } from "../plugin/PluginManager.js";
 import { getAgentRuntime } from "../agent/AgentRuntimeState.js";
-import { appendExecSessionMessage } from "../services/chat/runtime/ChatIngressStore.js";
-import { readChatMetaBySessionId } from "../services/chat/runtime/ChatMetaStore.js";
-import { resolveChatQueueStore } from "../services/chat/runtime/ChatQueue.js";
+import { appendExecSessionMessage } from "../service/builtins/chat/runtime/ChatIngressStore.js";
+import { readChatMetaBySessionId } from "../service/builtins/chat/runtime/ChatMetaStore.js";
+import { resolveChatQueueStore } from "../service/builtins/chat/runtime/ChatQueue.js";
 /**
  * service 调用端口实现。
  */

package/bin/agent/AgentContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentContext.js","sourceRoot":"","sources":["../../src/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;GAEG;AACH,MAAM,iBAAiB,GAAsB;IAC3C,KAAK,CAAC,MAAM,CAAC,MAIZ;QACC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4BAA4B;aACpC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,2BAA2B;aACnC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACrC,WAAW;YACX,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,eAAe,EAAE;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,uBAAuB;aACjD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAmB;IAC3C,OAAO;QACL,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC;QAC/C,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,uBAAuB,EAAE;QAC9D,wBAAwB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,wBAAwB,EAAE;QAChE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAmB;IAC1C,OAAO;QACL,IAAI;YACF,OAAO,gBAAgB,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,UAAkB;YACnC,OAAO,gBAAgB,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,MAIf;YACC,OAAO,gBAAgB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,QAAQ,CAAgB,SAAiB,EAAE,KAAQ;YACvD,OAAO,gBAAgB,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,KAAK,CAAgB,SAAiB,EAAE,KAAQ;YACpD,OAAO,gBAAgB,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,MAAM,CAAgB,SAAiB,EAAE,KAAQ;YACrD,OAAO,gBAAgB,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,KAAa;YAEb,OAAO,gBAAgB,EAAE,CAAC,OAAO,CAAkB,SAAS,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,UAA8B;IACnD,OAAO;QACL,KAAK,CAAC,mBAAmB,CAAC,SAAiB;YACzC,OAAO,uBAAuB,CAAC;gBAC7B,OAAO,EAAE,UAAU,EAAE;gBACrB,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,wBAAwB,CAAC,MAAM;YACnC,MAAM,wBAAwB,CAAC;gBAC7B,OAAO,EAAE,UAAU,EAAE;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,MAAM;YACZ,OAAO,qBAAqB,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,IAAI,OAAsB,CAAC;IAC3B,OAAO,GAAG;QACR,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC;QAChC,MAAM,EAAE,iBAAiB;QACzB,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;QAClC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC;KAChC,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,kBAAkB,CAAC,eAAe,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG"}
+{"version":3,"file":"AgentContext.js","sourceRoot":"","sources":["../../src/agent/AgentContext.ts"],"names":[],"mappings":"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"}

package/bin/agent/AgentContextTypes.d.ts

@@ -0,0 +1,345 @@
+/**
+ * AgentContext 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里定义 service / plugin / prompt system 共用的统一执行上下文。
+ * - `AgentContext` 表达的是“当前一次执行可见的能力面”，不是宿主状态本体。
+ * - `AgentRuntime` 才负责保存长期状态；`AgentContext` 只负责把这些状态暴露成执行接口。
+ */
+import type { LanguageModel } from "ai";
+import type { Logger } from "../shared/utils/logger/Logger.js";
+import type { AgentRuntime } from "../agent/AgentRuntimeTypes.js";
+import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../shared/types/AgentHost.js";
+import type { DowncityConfig } from "../shared/types/DowncityConfig.js";
+import type { JsonObject, JsonValue } from "../shared/types/Json.js";
+import type { PluginPort } from "../shared/types/Plugin.js";
+import type { ChatMetaV1 } from "../service/builtins/chat/types/ChatMeta.js";
+import type { ChatQueueEnqueueParams, ChatQueueEnqueueResult } from "../service/builtins/chat/types/ChatQueue.js";
+import type { SessionMetadataV1, SessionMessageV1, SessionUserMessageV1 } from "../types/session/SessionMessages.js";
+import type { SessionAssistantStepCallback, SessionRunInput, SessionRunResult } from "../types/session/SessionRun.js";
+/**
+ * 跨 service 调用参数。
+ */
+export interface InvokeServiceParams {
+    /**
+     * 目标 service 名称。
+     */
+    service: string;
+    /**
+     * 目标 action 名称。
+     */
+    action: string;
+    /**
+     * 调用时附带的结构化 payload。
+     */
+    payload?: JsonValue;
+}
+/**
+ * 跨 service 调用结果。
+ */
+export interface InvokeServiceResult {
+    /**
+     * 调用是否成功。
+     */
+    success: boolean;
+    /**
+     * 成功时返回的数据载荷。
+     */
+    data?: JsonValue;
+    /**
+     * 失败时的错误信息。
+     */
+    error?: string;
+}
+/**
+ * 跨 service 调用端口。
+ */
+export interface InvokeServicePort {
+    /**
+     * 调用指定 service action。
+     */
+    invoke(params: InvokeServiceParams): Promise<InvokeServiceResult>;
+}
+/**
+ * Session 持久化端口。
+ */
+export interface SessionHistoryComposerPort {
+    /**
+     * 读取全部消息。
+     */
+    list(): Promise<SessionMessageV1[]>;
+    /**
+     * 读取指定范围消息。
+     */
+    slice(start: number, end: number): Promise<SessionMessageV1[]>;
+    /**
+     * 追加一条消息。
+     */
+    append(message: SessionMessageV1): Promise<void>;
+    /**
+     * 获取当前消息数量。
+     */
+    size(): Promise<number>;
+    /**
+     * 读取附加元信息。
+     */
+    meta(): Promise<Record<string, unknown>>;
+    /**
+     * 构造一条 user 文本消息。
+     */
+    userText(params: {
+        /**
+         * 用户文本内容。
+         */
+        text: string;
+        /**
+         * 消息元信息。
+         */
+        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
+        /**
+         * 显式指定消息 id。
+         */
+        id?: string;
+    }): SessionMessageV1;
+    /**
+     * 构造一条 assistant 文本消息。
+     */
+    assistantText(params: {
+        /**
+         * 助手文本内容。
+         */
+        text: string;
+        /**
+         * 消息元信息。
+         */
+        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
+        /**
+         * 显式指定消息 id。
+         */
+        id?: string;
+        /**
+         * 消息逻辑类型。
+         */
+        kind?: "normal" | "summary";
+        /**
+         * 消息来源。
+         */
+        source?: "egress" | "compact";
+    }): SessionMessageV1;
+}
+/**
+ * 单个 Session 执行端口。
+ */
+export interface SessionExecutorPort {
+    /**
+     * 执行一次 session run。
+     */
+    run(params: SessionRunInput): Promise<SessionRunResult>;
+}
+/**
+ * Session 集合入口。
+ */
+/**
+ * 单个 Session 实例端口。
+ */
+export interface SessionPort {
+    /**
+     * 当前 session 标识。
+     */
+    readonly sessionId: string;
+    /**
+     * 获取当前 session 的执行端口。
+     */
+    getExecutor(): SessionExecutorPort;
+    /**
+     * 获取当前 session 的持久化端口。
+     */
+    getHistoryComposer(): SessionHistoryComposerPort;
+    /**
+     * 执行当前 session 的一次请求。
+     */
+    run(params: {
+        /**
+         * 本轮输入文本。
+         */
+        query: string;
+        /**
+         * step 边界回调。
+         */
+        onStepCallback?: () => Promise<SessionUserMessageV1[]>;
+        /**
+         * assistant step 回调。
+         */
+        onAssistantStepCallback?: SessionAssistantStepCallback;
+    }): Promise<SessionRunResult>;
+    /**
+     * 清理当前 session 的 executor 缓存。
+     */
+    clearExecutor(): void;
+    /**
+     * 当前 session 更新后的异步通知钩子。
+     */
+    afterSessionUpdatedAsync(): Promise<void>;
+    /**
+     * 追加一条 user 消息。
+     */
+    appendUserMessage(params: {
+        /**
+         * 已构造好的完整消息。
+         */
+        message?: SessionMessageV1 | null;
+        /**
+         * 兜底文本内容。
+         */
+        text?: string;
+        /**
+         * 附加元数据。
+         */
+        extra?: SessionMetadataV1["extra"];
+    }): Promise<void>;
+    /**
+     * 追加一条 assistant 消息。
+     */
+    appendAssistantMessage(params: {
+        /**
+         * 已构造好的完整消息。
+         */
+        message?: SessionMessageV1 | null;
+        /**
+         * 兜底文本内容。
+         */
+        fallbackText?: string;
+        /**
+         * 附加元数据。
+         */
+        extra?: SessionMetadataV1["extra"];
+    }): Promise<void>;
+    /**
+     * 返回当前 session 是否正在执行。
+     */
+    isExecuting(): boolean;
+}
+export interface SessionCollectionPort {
+    /**
+     * 获取指定 sessionId 对应的 Session 实例。
+     */
+    get(sessionId: string): SessionPort;
+    /**
+     * 返回当前所有执行中的 sessionId。
+     */
+    listExecutingSessionIds(): string[];
+    /**
+     * 返回当前执行中的 session 数量。
+     */
+    getExecutingSessionCount(): number;
+    /**
+     * 当前统一模型实例。
+     */
+    model?: LanguageModel;
+}
+/**
+ * Chat 运行时能力入口。
+ *
+ * 关键点（中文）
+ * - 这是当前 agent 已装配好的 chat 运行时视图。
+ * - 其他 service 只能通过这里消费 chat 能力，不能直接 import chat runtime 模块。
+ */
+export interface ChatRuntimePort {
+    /**
+     * 按 sessionId 读取 chat 路由元信息。
+     */
+    readMetaBySessionId(sessionId: string): Promise<ChatMetaV1 | null>;
+    /**
+     * 向指定 session 追加一条 exec 入站消息。
+     */
+    appendExecSessionMessage(params: {
+        /**
+         * 目标 session 标识。
+         */
+        sessionId: string;
+        /**
+         * 要写入的文本。
+         */
+        text: string;
+        /**
+         * 附加结构化元数据。
+         */
+        extra?: JsonObject;
+    }): Promise<void>;
+    /**
+     * 向 chat queue 入队一条消息。
+     */
+    enqueue(params: ChatQueueEnqueueParams): ChatQueueEnqueueResult;
+}
+/**
+ * 统一执行上下文。
+ */
+export interface AgentContext {
+    /**
+     * 当前执行上下文对应的 agent 状态。
+     */
+    agent: AgentRuntime;
+    /**
+     * 当前命令工作目录。
+     */
+    cwd: string;
+    /**
+     * 当前项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 统一日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前运行时已解析配置。
+     */
+    config: DowncityConfig;
+    /**
+     * 当前项目环境变量快照。
+     */
+    env: Record<string, string>;
+    /**
+     * 当前平台级全局环境变量快照。
+     */
+    globalEnv: Record<string, string>;
+    /**
+     * 当前生效的 system 文本集合。
+     */
+    systems: string[];
+    /**
+     * 当前可见的路径能力集合。
+     */
+    paths: AgentPathRuntime;
+    /**
+     * 当前可见的 plugin 配置持久化能力集合。
+     */
+    pluginConfig: AgentPluginConfigRuntime;
+    /**
+     * Session 能力入口。
+     *
+     * 关键点（中文）
+     * - service 与 plugin 都通过这里访问 session 执行与持久化能力。
+     * - 内外统一使用 `sessionId` 语义。
+     */
+    session: SessionCollectionPort;
+    /**
+     * 跨 service 调用主入口。
+     */
+    invoke: InvokeServicePort;
+    /**
+     * Chat 运行时能力入口。
+     */
+    chat: ChatRuntimePort;
+    /**
+     * Plugin 调用入口。
+     */
+    plugins: PluginPort;
+}
+/**
+ * 允许 optional 字段的结构化配置对象。
+ */
+export type StructuredConfig = {
+    [key: string]: JsonValue | undefined;
+};
+//# sourceMappingURL=AgentContextTypes.d.ts.map

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

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

package/bin/agent/AgentContextTypes.js

@@ -0,0 +1,10 @@
+/**
+ * AgentContext 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里定义 service / plugin / prompt system 共用的统一执行上下文。
+ * - `AgentContext` 表达的是“当前一次执行可见的能力面”，不是宿主状态本体。
+ * - `AgentRuntime` 才负责保存长期状态；`AgentContext` 只负责把这些状态暴露成执行接口。
+ */
+export {};
+//# sourceMappingURL=AgentContextTypes.js.map

package/bin/agent/AgentContextTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContextTypes.js","sourceRoot":"","sources":["../../src/agent/AgentContextTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/agent/AgentRuntime.js

@@ -11,26 +11,26 @@ import path from "path";
 import fs from "fs";
 import { logger as defaultLogger } from "../shared/utils/logger/Logger.js";
 import { LocalSessionExecutor } from "../session/executors/local/LocalSessionExecutor.js";
-import { ensureRuntimeProjectReady } from "../daemon/ProjectSetup.js";
+import { ensureRuntimeProjectReady } from "../host/daemon/ProjectSetup.js";
 import { createModel } from "../model/CreateModel.js";
 import { loadGlobalEnvFromStore, loadAgentEnvSnapshot, loadDowncityConfig, } from "../config/Config.js";
 import { getDowncityJsonPath } from "../config/Paths.js";
-import { getTaskRunDir, parseTaskRunSessionId, } from "../services/task/runtime/Paths.js";
+import { getTaskRunDir, parseTaskRunSessionId, } from "../service/builtins/task/runtime/Paths.js";
 import { setShellToolRuntime, shellTools } from "../session/tools/shell/ShellToolDefinition.js";
 import { getSessionRunScope } from "../session/SessionRunScope.js";
 import { JsonlSessionHistoryComposer } from "../session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
 import { JsonlSessionCompactionComposer } from "../session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
 import { DefaultSessionSystemComposer } from "../session/composer/system/default/DefaultSessionSystemComposer.js";
-import { ChatSession } from "../services/chat/runtime/ChatSession.js";
-import { ChatSessionExecutionComposer } from "../services/chat/runtime/ChatSessionExecutionComposer.js";
+import { ChatSession } from "../service/builtins/chat/runtime/ChatSession.js";
+import { ChatSessionExecutionComposer } from "../service/builtins/chat/runtime/ChatSessionExecutionComposer.js";
 import { loadStaticSystemPrompts, StaticPromptCatalog, } from "../session/composer/system/default/StaticPromptCatalog.js";
 import { getAgentContext, } from "../agent/AgentContext.js";
 import { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, } from "../agent/AgentRuntimeState.js";
-import { createRegisteredServiceInstances } from "../service/ServiceClassRegistry.js";
+import { createRegisteredServiceInstances } from "../service/core/ServiceClassRegistry.js";
 import { readProjectPrimaryModelId } from "../agent/project/ProjectExecutionBinding.js";
 import { initializePluginManager, resetPluginManager } from "../plugin/PluginManager.js";
-import { clearPluginRuntimeContextResolver, setPluginRuntimeContextResolver, } from "../runtime/PluginRuntime.js";
-import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../runtime/AgentHostRuntime.js";
+import { clearPluginRuntimeContextResolver, setPluginRuntimeContextResolver, } from "../host/runtime/PluginRuntime.js";
+import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../host/runtime/AgentHostRuntime.js";
 import { updateAgentRuntimeConfig } from "../agent/AgentRuntimeState.js";
 export { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, requireAgentModel, } from "../agent/AgentRuntimeState.js";
 export { getAgentContext } from "../agent/AgentContext.js";