@downcity/agent 1.1.25 → 1.1.32

package/bin/session/types/SessionMessages.d.ts

@@ -12,7 +12,7 @@ import type { JsonObject } from "../../types/common/Json.js";
  * Session 消息：以 UIMessage[] 作为唯一事实源。
  *
  * 关键点（中文）
- * - 持久化存储在 `.downcity/session/<encodedSessionId>/messages/messages.jsonl`
+ * - 持久化存储在 `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`
  * - 默认只存 `role=user|assistant`
  * - compact 会把更早消息压缩为一条 `assistant` 摘要消息
  */

package/bin/types/config/DowncityConfig.d.ts

@@ -151,7 +151,7 @@ export interface DowncityConfig {
      * 上下文管理（工程向配置）。
      *
      * 说明
-     * - 对话消息以 UIMessage[] 为唯一事实源（`.downcity/session/<sessionId>/messages/messages.jsonl`）。
+     * - 对话消息以 UIMessage[] 为唯一事实源（`.downcity/agents/<agentId>/sessions/<sessionId>/messages/messages.jsonl`）。
      * - Agent 每次执行直接把 UIMessage[] 转成 ModelMessage[] 作为 messages 输入。
      * - 超出上下文窗口时会自动 compact（更早段压缩为摘要 + 保留最近窗口）。
      */

package/bin/types/runtime/auth/AuthPermission.d.ts

@@ -8,7 +8,7 @@
 /**
  * V1 支持的权限 key 列表。
  */
-export declare const AUTH_PERMISSION_KEYS: readonly ["agent.read", "agent.write", "agent.execute", "service.read", "service.write", "task.read", "task.run", "model.read", "model.write", "env.read", "env.write", "channel.read", "channel.write", "auth.read", "auth.write", "shell.execute", "session.read", "session.write", "plugin.read", "plugin.write"];
+export declare const AUTH_PERMISSION_KEYS: readonly ["agent.read", "agent.write", "agent.execute", "task.read", "task.run", "model.read", "model.write", "env.read", "env.write", "channel.read", "channel.write", "auth.read", "auth.write", "shell.execute", "session.read", "session.write", "plugin.read", "plugin.write"];
 /**
  * 权限 key 联合类型。
  */

package/bin/types/runtime/auth/AuthPermission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthPermission.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/auth/AuthPermission.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,sTAqBvB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAqB1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,0CAA2C,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,yBAAyB,EA4BzD,CAAC"}
+{"version":3,"file":"AuthPermission.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/auth/AuthPermission.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,qRAmBvB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAmB1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,0CAA2C,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,yBAAyB,EA2BzD,CAAC"}

package/bin/types/runtime/auth/AuthPermission.js

@@ -12,8 +12,6 @@ export const AUTH_PERMISSION_KEYS = [
     "agent.read",
     "agent.write",
     "agent.execute",
-    "service.read",
-    "service.write",
     "task.read",
     "task.run",
     "model.read",
@@ -37,8 +35,6 @@ export const AUTH_PERMISSION_DESCRIPTIONS = {
     "agent.read": "读取 agent 基础信息与运行状态。",
     "agent.write": "修改 agent 配置与元信息。",
     "agent.execute": "触发 agent 执行与会话运行。",
-    "service.read": "查看 service 状态与元数据。",
-    "service.write": "启动、停止或修改 service。",
     "task.read": "查看 task 定义与运行结果。",
     "task.run": "创建或手动执行 task。",
     "model.read": "查看模型池与模型绑定。",
@@ -78,7 +74,6 @@ export const AUTH_DEFAULT_ROLES = [
         description: "只读角色，可查看状态但不能执行高危变更。",
         permissions: [
             "agent.read",
-            "service.read",
             "task.read",
             "model.read",
             "env.read",

package/bin/types/runtime/auth/AuthPermission.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthPermission.js","sourceRoot":"","sources":["../../../../src/types/runtime/auth/AuthPermission.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,YAAY;IACZ,aAAa;IACb,eAAe;IACf,cAAc;IACd,eAAe;IACf,WAAW;IACX,UAAU;IACV,YAAY;IACZ,aAAa;IACb,UAAU;IACV,WAAW;IACX,cAAc;IACd,eAAe;IACf,WAAW;IACX,YAAY;IACZ,eAAe;IACf,cAAc;IACd,eAAe;IACf,aAAa;IACb,cAAc;CACN,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAsC;IAC7E,YAAY,EAAE,qBAAqB;IACnC,aAAa,EAAE,kBAAkB;IACjC,eAAe,EAAE,mBAAmB;IACpC,cAAc,EAAE,oBAAoB;IACpC,eAAe,EAAE,mBAAmB;IACpC,WAAW,EAAE,kBAAkB;IAC/B,UAAU,EAAE,eAAe;IAC3B,YAAY,EAAE,aAAa;IAC3B,aAAa,EAAE,aAAa;IAC5B,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,WAAW;IACxB,cAAc,EAAE,cAAc;IAC9B,eAAe,EAAE,cAAc;IAC/B,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,yBAAyB;IACvC,eAAe,EAAE,cAAc;IAC/B,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,kBAAkB;IACjC,cAAc,EAAE,sBAAsB;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC;AAyBhF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,CAAC,GAAG,oBAAoB,CAAC;KACvC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CACtD,UAAU,KAAK,YAAY,IAAI,UAAU,KAAK,WAAW,CAC1D;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,YAAY;YACZ,cAAc;YACd,WAAW;YACX,YAAY;YACZ,UAAU;YACV,cAAc;YACd,WAAW;YACX,cAAc;YACd,aAAa;SACd;KACF;CACF,CAAC"}
+{"version":3,"file":"AuthPermission.js","sourceRoot":"","sources":["../../../../src/types/runtime/auth/AuthPermission.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,YAAY;IACZ,aAAa;IACb,eAAe;IACf,WAAW;IACX,UAAU;IACV,YAAY;IACZ,aAAa;IACb,UAAU;IACV,WAAW;IACX,cAAc;IACd,eAAe;IACf,WAAW;IACX,YAAY;IACZ,eAAe;IACf,cAAc;IACd,eAAe;IACf,aAAa;IACb,cAAc;CACN,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAsC;IAC7E,YAAY,EAAE,qBAAqB;IACnC,aAAa,EAAE,kBAAkB;IACjC,eAAe,EAAE,mBAAmB;IACpC,WAAW,EAAE,kBAAkB;IAC/B,UAAU,EAAE,eAAe;IAC3B,YAAY,EAAE,aAAa;IAC3B,aAAa,EAAE,aAAa;IAC5B,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,WAAW;IACxB,cAAc,EAAE,cAAc;IAC9B,eAAe,EAAE,cAAc;IAC/B,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,yBAAyB;IACvC,eAAe,EAAE,cAAc;IAC/B,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,kBAAkB;IACjC,cAAc,EAAE,sBAAsB;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC;AAyBhF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,CAAC,GAAG,oBAAoB,CAAC;KACvC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CACtD,UAAU,KAAK,YAAY,IAAI,UAAU,KAAK,WAAW,CAC1D;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,YAAY;YACZ,WAAW;YACX,YAAY;YACZ,UAAU;YACV,cAAc;YACd,WAAW;YACX,cAAc;YACd,aAAa;SACd;KACF;CACF,CAAC"}

package/bin/types/runtime/host/AgentHost.d.ts

@@ -8,9 +8,9 @@
  */
 import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
 import type { ChatAuthorizationChannel, ChatAuthorizationConfig } from "../../../plugin/builtins/auth/types/AuthPlugin.js";
-import type { ChatChannelAccountCreateInput, ChatChannelAccountListItem, ChatChannelAccountProbeResult, ChatChannelAccountUpsertInput } from "../../../service/builtins/chat/types/ChannelAccount.js";
+import type { ChatChannelAccountCreateInput, ChatChannelAccountListItem, ChatChannelAccountProbeResult, ChatChannelAccountUpsertInput } from "../../../plugin/builtins/chat/types/ChannelAccount.js";
 import type { StoredChannelAccount, StoredModel, StoredModelProvider } from "../../../types/runtime/host/Store.js";
-import type { ChatChannelName } from "../../../service/builtins/chat/types/ChannelStatus.js";
+import type { ChatChannelName } from "../../../plugin/builtins/chat/types/ChannelStatus.js";
 import type { AgentProjectInitializationInput } from "../../../config/project/types/AgentProject.js";
 import type { PlatformModelChoice } from "../../../config/project/AgentInitializer.js";
 /**
@@ -21,6 +21,10 @@ export interface AgentPathRuntime {
      * 当前项目根目录。
      */
     projectRoot: string;
+    /**
+     * 当前 agent 的稳定标识。
+     */
+    agentId: string;
     /**
      * `.downcity` 根目录路径。
      */
@@ -54,11 +58,11 @@ export interface AgentPathRuntime {
      */
     getDowncityMemoryDailyPath(date: string): string;
     /**
-     * `.downcity/session` 根目录路径。
+     * `.downcity/agents/<agentId>/sessions` 根目录路径。
      */
     getDowncitySessionRootDirPath(): string;
     /**
-     * `.downcity/session/<sessionId>` 目录路径。
+     * `.downcity/agents/<agentId>/sessions/<sessionId>` 目录路径。
      */
     getDowncitySessionDirPath(sessionId: string): string;
 }

package/bin/types/runtime/host/AgentHost.d.ts.map

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

package/bin/types/sdk/AgentSessionEvent.d.ts

@@ -6,6 +6,7 @@
  * - 事件只表达“当前 turn 正在发生什么”，不负责历史回放。
  */
 import type { JsonValue } from "../../types/common/Json.js";
+import type { SessionAssistantStepVisibility } from "../../session/types/SessionRun.js";
 /**
  * 单个 turn 开始事件。
  */
@@ -107,6 +108,31 @@ export interface AgentSessionToolResultEvent {
      */
     result: JsonValue;
 }
+/**
+ * assistant step 完成事件。
+ */
+export interface AgentSessionAssistantStepEvent {
+    /**
+     * 当前事件类型。
+     */
+    type: "assistant-step";
+    /**
+     * 当前 assistant step 所属 turn。
+     */
+    turnId: string;
+    /**
+     * 当前 step 文本。
+     */
+    text: string;
+    /**
+     * 当前 step 序号（从 1 开始）。
+     */
+    stepIndex: number;
+    /**
+     * 当前 step 可见性。
+     */
+    visibility?: SessionAssistantStepVisibility;
+}
 /**
  * 单个 turn 完成事件。
  */
@@ -148,7 +174,7 @@ export interface AgentSessionErrorEvent {
 /**
  * Session 订阅可见事件联合类型。
  */
-export type AgentSessionEvent = AgentSessionTurnStartEvent | AgentSessionTextDeltaEvent | AgentSessionReasoningDeltaEvent | AgentSessionToolCallEvent | AgentSessionToolResultEvent | AgentSessionTurnFinishEvent | AgentSessionErrorEvent;
+export type AgentSessionEvent = AgentSessionTurnStartEvent | AgentSessionTextDeltaEvent | AgentSessionReasoningDeltaEvent | AgentSessionToolCallEvent | AgentSessionToolResultEvent | AgentSessionAssistantStepEvent | AgentSessionTurnFinishEvent | AgentSessionErrorEvent;
 /**
  * Session 事件订阅回调。
  */

package/bin/types/sdk/AgentSessionEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,+BAA+B,GAC/B,yBAAyB,GACzB,2BAA2B,GAC3B,2BAA2B,GAC3B,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC"}
+{"version":3,"file":"AgentSessionEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,8BAA8B,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,+BAA+B,GAC/B,yBAAyB,GACzB,2BAA2B,GAC3B,8BAA8B,GAC9B,2BAA2B,GAC3B,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC"}

package/bin/types/sdk/AgentSessionTurn.d.ts

@@ -6,6 +6,7 @@
  * - 同一个 turn 可以吸收多条 prompt，因此多个 prompt 可能返回相同 `id` 的 turn handle。
  * - 增量过程继续通过 `session.subscribe()` 观察；turn handle 只负责等待最终完成结果。
  */
+import type { SessionMessageV1 } from "../../session/types/SessionMessages.js";
 /**
  * 单个 Session turn 的最终结果。
  */
@@ -22,6 +23,14 @@ export interface AgentSessionTurnResult {
      * 当前 turn 是否成功结束。
      */
     success: boolean;
+    /**
+     * 当前 turn 最终 assistant 消息。
+     *
+     * 说明（中文）
+     * - `turn.finished` 返回的结果以这条消息作为最终事实源。
+     * - transport / runtime service 若需要读取最终结构化输出，应优先消费这里。
+     */
+    assistantMessage?: SessionMessageV1;
     /**
      * 当前 turn 失败时的错误文本。
      */

package/bin/types/sdk/AgentSessionTurn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionTurn.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionTurn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C"}
+{"version":3,"file":"AgentSessionTurn.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionTurn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.25",
+  "version": "1.1.32",
   "type": "module",
   "description": "Downcity Agent 运行时 — 执行壳，通过 RPC/HTTP 调用 City 的能力",
   "main": "./bin/index.js",
@@ -12,16 +12,7 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^3.0.28",
-    "@ai-sdk/google": "^3.0.6",
-    "@ai-sdk/huggingface": "^1.0.37",
-    "@ai-sdk/moonshotai": "^2.0.10",
-    "@ai-sdk/open-responses": "^1.0.6",
-    "@ai-sdk/openai": "^3.0.21",
-    "@ai-sdk/openai-compatible": "^2.0.0",
-    "@ai-sdk/xai": "^3.0.67",
     "@larksuiteoapi/node-sdk": "^1.40.0",
-    "@openrouter/ai-sdk-provider": "^2.2.3",
     "ai": "^6.0.57",
     "commander": "^12.0.0",
     "dotenv": "^16.4.0",
@@ -31,6 +22,7 @@
     "js-yaml": "^4.1.0",
     "nanoid": "^5.1.6",
     "node-cron": "^3.0.0",
+    "ws": "^8.18.3",
     "zod": "^3.24.0"
   },
   "devDependencies": {

package/src/config/Paths.ts

@@ -124,50 +124,91 @@ export function getDowncityDataDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "data");
 }
 
-export function getDowncitySessionRootDirPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "session");
+export function getDowncityAgentsRootDirPath(cwd: string): string {
+  return path.join(getDowncityDirPath(cwd), "agents");
 }
 
-export function getDowncitySessionDirPath(cwd: string, sessionId: string): string {
-  return path.join(getDowncitySessionRootDirPath(cwd), encodeURIComponent(sessionId));
+export function getDowncityAgentDirPath(cwd: string, agentId: string): string {
+  return path.join(
+    getDowncityAgentsRootDirPath(cwd),
+    encodeURIComponent(String(agentId || "").trim()),
+  );
+}
+
+export function getDowncitySessionRootDirPath(
+  cwd: string,
+  agentId: string,
+): string {
+  return path.join(getDowncityAgentDirPath(cwd, agentId), "sessions");
+}
+
+export function getDowncitySessionDirPath(
+  cwd: string,
+  agentId: string,
+  sessionId: string,
+): string {
+  return path.join(
+    getDowncitySessionRootDirPath(cwd, agentId),
+    encodeURIComponent(String(sessionId || "").trim()),
+  );
 }
 
 /**
  * Session Messages（会话消息，唯一事实源）。
  *
  * 关键点（中文）
- * - `.downcity/session/<encodedSessionId>/messages/messages.jsonl`：每行一个 UIMessage（user/assistant）
+ * - `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`：每行一个 UIMessage（user/assistant）
  * - compact 会把被折叠的原始段写入 `messages/archive/*`（可审计）
  */
 export function getDowncitySessionMessagesDirPath(
   cwd: string,
+  agentId: string,
   sessionId: string,
 ): string {
-  return path.join(getDowncitySessionDirPath(cwd, sessionId), "messages");
+  return path.join(getDowncitySessionDirPath(cwd, agentId, sessionId), "messages");
 }
 
-export function getDowncitySessionMessagesPath(cwd: string, sessionId: string): string {
-  return path.join(getDowncitySessionMessagesDirPath(cwd, sessionId), "messages.jsonl");
+export function getDowncitySessionMessagesPath(
+  cwd: string,
+  agentId: string,
+  sessionId: string,
+): string {
+  return path.join(
+    getDowncitySessionMessagesDirPath(cwd, agentId, sessionId),
+    "messages.jsonl",
+  );
 }
 
-export function getDowncitySessionHistoryMetaPath(cwd: string, sessionId: string): string {
-  return path.join(getDowncitySessionMessagesDirPath(cwd, sessionId), "meta.json");
+export function getDowncitySessionHistoryMetaPath(
+  cwd: string,
+  agentId: string,
+  sessionId: string,
+): string {
+  return path.join(
+    getDowncitySessionMessagesDirPath(cwd, agentId, sessionId),
+    "meta.json",
+  );
 }
 
 export function getDowncitySessionMessagesArchiveDirPath(
   cwd: string,
+  agentId: string,
   sessionId: string,
 ): string {
-  return path.join(getDowncitySessionMessagesDirPath(cwd, sessionId), "archive");
+  return path.join(
+    getDowncitySessionMessagesDirPath(cwd, agentId, sessionId),
+    "archive",
+  );
 }
 
 export function getDowncitySessionMessagesArchivePath(
   cwd: string,
+  agentId: string,
   sessionId: string,
   archiveId: string,
 ): string {
   return path.join(
-    getDowncitySessionMessagesArchiveDirPath(cwd, sessionId),
+    getDowncitySessionMessagesArchiveDirPath(cwd, agentId, sessionId),
     `${encodeURIComponent(String(archiveId || "").trim())}.json`,
   );
 }

package/src/config/project/AgentInitializer.ts

@@ -10,6 +10,7 @@ import fs from "fs-extra";
 import path from "node:path";
 import {
   getCacheDirPath,
+  getDowncityAgentsRootDirPath,
   getLogsDirPath,
   getProfileMdPath,
   getDowncityConfigDirPath,
@@ -22,7 +23,6 @@ import {
   getDowncityProfilePrimaryPath,
   getDowncityPublicDirPath,
   getDowncitySchemaPath,
-  getDowncitySessionRootDirPath,
   getDowncityTasksDirPath,
   getSoulMdPath,
 } from "@/config/Paths.js";
@@ -392,7 +392,7 @@ export async function initializeAgentProject(
     getCacheDirPath(projectRoot),
     getDowncityProfileDirPath(projectRoot),
     getDowncityDataDirPath(projectRoot),
-    getDowncitySessionRootDirPath(projectRoot),
+    getDowncityAgentsRootDirPath(projectRoot),
     getDowncityPublicDirPath(projectRoot),
     getDowncityConfigDirPath(projectRoot),
     path.join(projectRoot, ".agents", "skills"),

package/src/core/AgentContextTypes.ts

@@ -2,7 +2,7 @@
  * AgentCore 执行上下文类型定义。
  *
  * 关键点（中文）
- * - 这里定义 service / plugin / prompt system 共用的统一执行上下文。
+ * - 这里定义 runtime plugin / plugin / prompt system 共用的统一执行上下文。
  * - `AgentContext` 表达的是“当前一次执行可见的能力面”，不是宿主状态本体。
  * - `AgentRuntime` 负责保存长期状态；`AgentContext` 负责把这些状态暴露成执行接口。
  */
@@ -18,18 +18,16 @@ import type {
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 import type { PluginPort } from "@/plugin/types/Plugin.js";
-import type { ChatMetaV1 } from "@/service/builtins/chat/types/ChatMeta.js";
+import type { ChatMetaV1 } from "@/plugin/builtins/chat/types/ChatMeta.js";
 import type {
   ChatQueueEnqueueParams,
   ChatQueueEnqueueResult,
-} from "@/service/builtins/chat/types/ChatQueue.js";
+} from "@/plugin/builtins/chat/types/ChatQueue.js";
 import type {
   SessionMetadataV1,
   SessionMessageV1,
-  SessionUserMessageV1,
 } from "@/session/types/SessionMessages.js";
 import type {
-  SessionAssistantStepCallback,
   SessionRunInput,
   SessionRunResult,
 } from "@/session/types/SessionRun.js";
@@ -42,13 +40,13 @@ import type {
 import type { AgentSessionTurnHandle } from "@/types/sdk/AgentSessionTurn.js";
 
 /**
- * 跨 service 调用参数。
+ * 跨 runtime plugin 调用参数。
  */
-export interface InvokeServiceParams {
+export interface InvokePluginParams {
   /**
-   * 目标 service 名称。
+   * 目标 plugin 名称。
    */
-  service: string;
+  plugin: string;
   /**
    * 目标 action 名称。
    */
@@ -60,9 +58,9 @@ export interface InvokeServiceParams {
 }
 
 /**
- * 跨 service 调用结果。
+ * 跨 runtime plugin 调用结果。
  */
-export interface InvokeServiceResult {
+export interface InvokePluginResult {
   /**
    * 调用是否成功。
    */
@@ -78,13 +76,13 @@ export interface InvokeServiceResult {
 }
 
 /**
- * 跨 service 调用端口。
+ * 跨 runtime plugin 调用端口。
  */
-export interface InvokeServicePort {
+export interface InvokePluginPort {
   /**
-   * 调用指定 service action。
+   * 调用指定 plugin action。
    */
-  invoke(params: InvokeServiceParams): Promise<InvokeServiceResult>;
+  invoke(params: InvokePluginParams): Promise<InvokePluginResult>;
 }
 
 /**
@@ -121,23 +119,6 @@ export interface SessionPort {
    * 获取当前 session 的持久化端口。
    */
   getHistoryStore(): SessionHistoryStore;
-  /**
-   * 执行当前 session 的一次内部请求。
-   */
-  execute(params: {
-    /**
-     * 本轮输入文本。
-     */
-    query: string;
-    /**
-     * step 边界回调。
-     */
-    onStepCallback?: () => Promise<SessionUserMessageV1[]>;
-    /**
-     * assistant step 回调。
-     */
-    onAssistantStepCallback?: SessionAssistantStepCallback;
-  }): Promise<SessionRunResult>;
   /**
    * 向当前 session actor 追加一条新的 prompt。
    *
@@ -233,30 +214,13 @@ export interface SessionCollectionPort {
  *
  * 关键点（中文）
  * - 这是当前 agent 已装配好的 chat 运行时视图。
- * - 其他 service 只能通过这里消费 chat 能力，不能直接 import chat runtime 模块。
+ * - 其他 runtime plugin 只能通过这里消费 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 入队一条消息。
    */
@@ -315,14 +279,14 @@ export interface AgentContext {
    * Session 能力入口。
    *
    * 关键点（中文）
-   * - service 与 plugin 都通过这里访问 session 执行与持久化能力。
+   * - runtime plugin 与 plugin 都通过这里访问 session 执行与持久化能力。
    * - 内外统一使用 `sessionId` 语义。
    */
   session: SessionCollectionPort;
   /**
-   * 跨 service 调用主入口。
+   * 跨 runtime plugin 调用主入口。
    */
-  invoke: InvokeServicePort;
+  invoke: InvokePluginPort;
   /**
    * Chat 运行时能力入口。
    */