@downcity/agent 1.1.408 → 1.1.437

package/bin/tools/ask/AskQuestionsToolSchemas.d.ts

@@ -14,8 +14,8 @@ export declare const ask_questions_input_schema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         question: z.ZodString;
         type: z.ZodEnum<{
-            single_select: "single_select";
             multi_select: "multi_select";
+            single_select: "single_select";
         }>;
         options: z.ZodArray<z.ZodObject<{
             value: z.ZodString;

package/bin/types/action/ActionResult.d.ts

@@ -3,28 +3,32 @@
  *
  * 关键点（中文）
  * - `output` 是标准 Tool Result，原样交给模型执行器和 canonical Tool Part。
- * - `messages` 是执行后写入 Session 的真实 User / Assistant Message 内容。
+ * - `messages` 是执行后产生的运行期 User 输入或 canonical Agent 内容。
+ * - `effects` 是当前 Turn 只追加收集、并在收口检查点解释的已发生副作用。
  * - Message Parts 复用 Downcity Session UI 协议，不再建立文件、图片或 Plugin 专用桥接。
  */
-import type { SessionAssistantResultPart, SessionPromptPart } from "../session/SessionContent.js";
+import type { RuntimeToolEffect } from "@downcity/type";
+import type { SessionAgentContent, SessionModelUserContent } from "@downcity/type";
 /** Action 执行后产生的一条 Session 消息。 */
 export type ActionResultMessage = {
     /** User 内容在下一 Step 生效。 */
     role: "user";
-    /** 等待进入 canonical User Message 的内容。 */
-    parts: SessionPromptPart[];
+    /** 只在当前 Turn 生效、不会伪装成 canonical Message 的模型输入。 */
+    parts: SessionModelUserContent[];
 } | {
-    /** Assistant 内容写入当前回复。 */
-    role: "assistant";
-    /** 等待进入 canonical Assistant Message 的内容。 */
-    parts: SessionAssistantResultPart[];
+    /** Agent 内容写入当前 canonical 回复。 */
+    role: "agent";
+    /** 等待追加到 canonical Agent Message 的内容。 */
+    parts: SessionAgentContent[];
 };
 /** Action 或 Tool 内部实现返回的统一结果。 */
 export interface ActionResult<TOutput = unknown> {
     /** 返回给调用方、模型执行器与 canonical Tool Part 的标准执行输出。 */
     output: TOutput;
-    /** 执行产生的真实 Session 消息；没有附加消息时传入空数组。 */
+    /** 执行产生的运行期 User 输入或 Agent 输出；没有附加内容时传入空数组。 */
     messages: ActionResultMessage[];
+    /** 已经发生且需要由当前 Turn 收集的副作用；不会发送给模型或直接持久化。 */
+    effects?: readonly RuntimeToolEffect[];
 }
 /** 判断未知 Tool 输出是否使用统一 ActionResult 协议。 */
 export declare function is_action_result(value: unknown): value is ActionResult;

package/bin/types/action/ActionResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionResult.d.ts","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAE3C,kCAAkC;AAClC,MAAM,MAAM,mBAAmB,GAC3B;IACE,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,GACD;IACE,0BAA0B;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,4CAA4C;IAC5C,KAAK,EAAE,0BAA0B,EAAE,CAAC;CACrC,CAAC;AAEN,iCAAiC;AACjC,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO;IAC7C,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAEhB,uCAAuC;IACvC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAKtE"}
+{"version":3,"file":"ActionResult.d.ts","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,kCAAkC;AAClC,MAAM,MAAM,mBAAmB,GAC3B;IACE,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,EAAE,uBAAuB,EAAE,CAAC;CAClC,GACD;IACE,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B,CAAC;AAEN,iCAAiC;AACjC,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO;IAC7C,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAEhB,+CAA+C;IAC/C,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAEhC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACxC;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAKtE"}

package/bin/types/action/ActionResult.js

@@ -3,7 +3,8 @@
  *
  * 关键点（中文）
  * - `output` 是标准 Tool Result，原样交给模型执行器和 canonical Tool Part。
- * - `messages` 是执行后写入 Session 的真实 User / Assistant Message 内容。
+ * - `messages` 是执行后产生的运行期 User 输入或 canonical Agent 内容。
+ * - `effects` 是当前 Turn 只追加收集、并在收口检查点解释的已发生副作用。
  * - Message Parts 复用 Downcity Session UI 协议，不再建立文件、图片或 Plugin 专用桥接。
  */
 /** 判断未知 Tool 输出是否使用统一 ActionResult 协议。 */

package/bin/types/action/ActionResult.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionResult.js","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC3D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"ActionResult.js","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC3D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/bin/types/agent/AgentOptions.d.ts

@@ -5,11 +5,9 @@
  * - 只描述本地 Agent 的构造、启动、停止与 RPC 绑定。
  * - RemoteAgent 与 Session 数据结构拆到独立类型文件。
  */
-import type { RuntimeTool as Tool } from "@downcity/type";
-import type { AgentModel } from "../../agent/AgentModel.js";
-import type { Plugin } from "../plugin/PluginDefinition.js";
-import type { PluginWebServices } from "../plugin/PluginServices.js";
-import type { AgentManagedSession, SessionOptions } from "../session/SessionOptions.js";
+import type { ModelClient, RuntimeTool as Tool } from "@downcity/type";
+import type { AgentManagedSession, SessionOptions } from "../../types/session/SessionOptions.js";
+import type { SessionComposer } from "../../types/session/SessionComposer.js";
 /**
  * Agent 可使用的 Session 类。
  *
@@ -30,6 +28,18 @@ export interface AgentOptions {
      * - 应保持稳定、可 URL 编码、尽量不要依赖展示名称。
      */
     id: string;
+    /**
+     * 当前 Agent 的用户可见名称。
+     *
+     * 省略或传入空字符串时使用 `id`；Group 调度会使用该名称理解成员身份。
+     */
+    name?: string;
+    /**
+     * 当前 Agent 的一句话能力描述。
+     *
+     * 该字段用于展示和 Group 语义调度，不替代决定 Agent 行为的 `instruction`。
+     */
+    description?: string;
     /**
      * 当前 agent 默认可用的工具集合。
      *
@@ -54,19 +64,7 @@ export interface AgentOptions {
      * - Agent 不选择或恢复模型，只持有宿主传入的实例。
      * - Session 未显式设置模型时，执行自动回退到该实例。
      */
-    model?: AgentModel;
-    /** 当前 Agent 持有的 Web 搜索与文档能力。 */
-    web?: PluginWebServices;
-    /**
-     * 当前 agent 显式持有的插件实例集合。
-     *
-     * 关键点（中文）
-     * - 这里接收已经创建好的 `Plugin` 对象，而不是 plugin class。
-     * - `Agent` 会在构造阶段按名称注册这些实例，并自动绑定到当前 runtime。
-     * - 同名 plugin 会直接报错，避免 action / hook / resolve 行为被静默覆盖。
-     * - SDK 不再自动注入任何 built-in plugin；需要的能力都应由宿主显式传入。
-     */
-    plugins?: Plugin[];
+    model?: ModelClient;
     /**
      * 当前 agent 使用的本地 Session 类。
      *
@@ -76,5 +74,14 @@ export interface AgentOptions {
      * - 该能力仅适用于本地 `Agent`。
      */
     session_class?: AgentSessionConstructor;
+    /**
+     * 为每个 Session 创建独立 Composer 的工厂。
+     *
+     * 关键点（中文）
+     * - 每次创建、恢复或 fork Session 都会调用一次，禁止返回共享实例。
+     * - 省略时创建默认 `DefaultSessionComposer`。
+     * - Context Policy 应在工厂内部随 Composer 一起创建，避免跨 Session 共享派生状态。
+     */
+    session_composer?: () => SessionComposer;
 }
 //# sourceMappingURL=AgentOptions.d.ts.map

package/bin/types/agent/AgentOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentOptions.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,KACpC,OAAO,EAAE,cAAc,KACpB,mBAAmB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB,gCAAgC;IAChC,GAAG,CAAC,EAAE,iBAAiB,CAAC;IAExB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAEzC"}
+{"version":3,"file":"AgentOptions.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,KACpC,OAAO,EAAE,cAAc,KACpB,mBAAmB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;IAExC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,eAAe,CAAC;CAE1C"}

package/bin/types/agent/AgentSessionCollection.d.ts

@@ -3,25 +3,27 @@
  *
  * Session 归 Agent 所有；Workspace 只在创建时声明本次执行使用的资源环境。
  */
-import type { WorkspaceBase } from "@downcity/workspace";
-import type { SessionOrigin } from "../session/SessionOrigin.js";
-import type { AgentSession } from "./SessionActor.js";
-import type { AgentCreateSessionInput } from "./SessionTypes.js";
-import type { SessionPort } from "../session/SessionPort.js";
-import type { AgentArchiveSessionInput, AgentArchiveSessionResult, AgentArchiveSessionsInput, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "./SessionTypes.js";
+import type { WorkspaceRuntime } from "@downcity/type";
+import type { AgentSession } from "../../types/agent/SessionActor.js";
+import type { AgentCreateSessionInput } from "../../types/agent/SessionTypes.js";
+import type { SessionPort } from "../../types/session/SessionPort.js";
+import type { AgentArchiveSessionInput, AgentArchiveSessionResult, AgentArchiveSessionsInput, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "../../types/agent/SessionTypes.js";
 /** 创建 Agent Session 的公开参数。 */
 export interface AgentCreateSessionOptions extends AgentCreateSessionInput {
     /** 本次 Session 可选使用的 Workspace 资源；未传入时使用内存执行上下文。 */
-    workspace?: WorkspaceBase;
-    /** 当前 Session 的创建来源；未填写时视为用户直接创建。 */
-    origin?: SessionOrigin;
+    workspace?: WorkspaceRuntime;
+}
+/** 恢复 Agent Session 时使用的本地执行上下文。 */
+export interface AgentGetSessionOptions {
+    /** 当前 Session 使用的 Workspace；必须与持久化 Metadata 一致。 */
+    workspace?: WorkspaceRuntime;
 }
 /** Agent 公开的 Session 创建入口。 */
 export interface AgentSessionCollection {
     /** 在指定 Workspace 中创建一个属于当前 Agent 的 Session。 */
     create(options?: AgentCreateSessionOptions): Promise<AgentSession>;
     /** 在指定 Workspace 中恢复一个已经属于当前 Agent 的 Session。 */
-    get(session_id: string, options?: AgentCreateSessionOptions): Promise<AgentSession>;
+    get(session_id: string, origin_type?: string, options?: AgentGetSessionOptions): Promise<AgentSession>;
     /** 列出当前 Agent 的活动 Session。 */
     list(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
     /** 归档一个 Session。 */
@@ -30,13 +32,15 @@ export interface AgentSessionCollection {
     archived(input?: AgentArchiveSessionsInput): Promise<AgentArchiveSessionsResult>;
     /** 清空已归档 Session。 */
     clean_archive(): Promise<AgentCleanArchiveResult>;
+    /** 把 Session 重新绑定到另一个 Workspace，并返回新上下文下的 Session 实例。 */
+    workspace(session_id: string, workspace: WorkspaceRuntime): Promise<AgentSession>;
     /** 获取 Session runtime port。 */
-    runtime(session_id: string): SessionPort;
+    runtime(session_id: string, origin_type?: string): SessionPort;
     /** 返回当前 Agent 正在执行的 Session 标识。 */
     list_executing_session_ids(): string[];
     /** 永久删除 Session。 */
-    remove(session_id: string): Promise<boolean>;
+    remove(session_id: string, origin_type?: string): Promise<boolean>;
     /** 清空 Session 消息。 */
-    clear_messages(session_id: string): Promise<boolean>;
+    clear_messages(session_id: string, origin_type?: string): Promise<boolean>;
 }
 //# sourceMappingURL=AgentSessionCollection.d.ts.map

package/bin/types/agent/AgentSessionCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionCollection.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentSessionCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,8BAA8B;AAC9B,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,mDAAmD;IACnD,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,qCAAqC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,MAAM,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnE,iDAAiD;IACjD,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpF,8BAA8B;IAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEvE,oBAAoB;IACpB,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAE7E,qBAAqB;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEjF,qBAAqB;IACrB,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAElD,+BAA+B;IAC/B,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAEzC,mCAAmC;IACnC,0BAA0B,IAAI,MAAM,EAAE,CAAC;IAEvC,oBAAoB;IACpB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7C,qBAAqB;IACrB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD"}
+{"version":3,"file":"AgentSessionCollection.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentSessionCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,8BAA8B;AAC9B,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,mDAAmD;IACnD,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,MAAM,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnE,iDAAiD;IACjD,GAAG,CACD,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,8BAA8B;IAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEvE,oBAAoB;IACpB,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAE7E,qBAAqB;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEjF,qBAAqB;IACrB,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAElD,yDAAyD;IACzD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElF,+BAA+B;IAC/B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAE/D,mCAAmC;IACnC,0BAA0B,IAAI,MAAM,EAAE,CAAC;IAEvC,oBAAoB;IACpB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnE,qBAAqB;IACrB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5E"}

package/bin/types/agent/AgentStorage.d.ts

@@ -4,14 +4,16 @@
  * Agent 在 City 中使用持久化文件系统；未加入 City 时使用进程内文件系统。
  * Workspace 只提供执行上下文，不拥有这份存储。
  */
-import type { SessionStore } from "../store/SessionStore.js";
-import type { FileSystem } from "@downcity/workspace";
+import type { SessionStore } from "../../types/store/SessionStore.js";
+import type { FileSystem, StorageDatabaseLocation } from "@downcity/type";
 /** Agent 持有的 Session、日志与调度共享存储。 */
 export interface AgentStorage {
     /** Agent 内部数据的稳定根路径。 */
     root_path: string;
     /** 受当前 Agent 根路径约束的文件能力。 */
     files: FileSystem;
+    /** Agent 私有结构化数据库使用的位置类型。 */
+    database_location: StorageDatabaseLocation;
     /** 当前 Agent 的 Session 集合存储。 */
     sessions: SessionStore;
 }

package/bin/types/agent/AgentStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentStorage.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentStorage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,YAAY,CAAC;CACxB"}
+{"version":3,"file":"AgentStorage.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentStorage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,6BAA6B;IAC7B,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,+BAA+B;IAC/B,QAAQ,EAAE,YAAY,CAAC;CACxB"}

package/bin/types/agent/SessionActor.d.ts

@@ -5,15 +5,14 @@
  * - 这里只描述 session 的可调用能力。
  * - session 的数据结构、history/system payload 放在 `SessionTypes.ts`。
  */
-import type { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionInfo, AgentSessionSetInput, AgentSessionSetOptions, AgentSessionStatus, AgentSessionSummaryPage, AgentSessionSystemSnapshot, RemoteSessionSetInput } from "./SessionTypes.js";
-import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "../session/SessionMutation.js";
-import type { RespondSessionInteractionInput, SessionInteractionResult, SessionPendingInteraction } from "../session/SessionInteraction.js";
-import type { ListSessionMessagesInput, SessionMessagePage } from "../session/SessionMessage.js";
-import type { AgentSessionPromptInput } from "../sdk/AgentSessionPrompt.js";
-import type { AgentSessionStopResult } from "../sdk/AgentSessionStop.js";
-import type { AgentSessionCompactHandle } from "../sdk/AgentSessionCompact.js";
-import type { AgentSessionTurnHandle } from "../sdk/AgentSessionTurn.js";
-import type { SessionOrigin } from "../session/SessionOrigin.js";
+import type { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionInfo, AgentSessionSetInput, AgentSessionSetOptions, AgentSessionStatus, AgentSessionSummaryPage, AgentSessionSystemSnapshot, RemoteSessionSetInput } from "../../types/agent/SessionTypes.js";
+import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "@downcity/type";
+import type { RespondSessionInteractionInput, SessionInteractionResult, SessionPendingInteraction } from "@downcity/type";
+import type { ListSessionMessagesInput, SessionMessagePage } from "@downcity/type";
+import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionStopResult } from "../../types/sdk/AgentSessionStop.js";
+import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
+import type { SessionOrigin } from "@downcity/type";
 /**
  * SDK Session 集合入口。
  */
@@ -21,7 +20,7 @@ export interface AgentSessions<TSession extends AgentSessionActor = AgentSession
     /** 新建一个 session。 */
     create(input?: AgentCreateSessionInput): Promise<TSession>;
     /** 获取一个已存在的 session。 */
-    get(session_id: string): Promise<TSession>;
+    get(session_id: string, origin_type?: string): Promise<TSession>;
     /** 列出当前 agent 的 session 摘要页。 */
     list(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
     /** 归档单个 session。 */
@@ -40,21 +39,13 @@ export interface AgentSessionActor {
     /** 当前 Session 创建时绑定的 Workspace ID；无 Workspace 时为空。 */
     readonly workspace_id?: string;
     /** 当前 Session 的创建来源。 */
-    readonly origin?: SessionOrigin;
+    readonly origin: SessionOrigin;
     /** 读取当前 session 详情。 */
     get_info(): Promise<AgentSessionInfo>;
     /** 追加一条新的 prompt。 */
     prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
     /** 停止当前 turn，并取消尚未被吸收的排队 prompt。 */
     stop(): Promise<AgentSessionStopResult>;
-    /**
-     * 把一次显式历史压缩加入当前 Session 的有序输入队列。
-     *
-     * 关键点（中文）
-     * - 返回句柄表示 Command 已成功入队。
-     * - `handle.finished` 在压缩真正完成或失败后兑现。
-     */
-    compact(): Promise<AgentSessionCompactHandle>;
     /** 订阅当前 session 的未来事件。 */
     subscribe(subscriber: SessionMutationSubscriber): SessionMutationUnsubscribe;
     /** 读取当前 session messages 分页。 */
@@ -82,7 +73,7 @@ export interface AgentSession extends AgentSessionActor {
     rename(title: string): Promise<string>;
     /** 把当前 Session 首次生成后固定的完整 system 显式固化到 instruction.md。 */
     snapshot(): Promise<void>;
-    /** 使用 Agent 当前 instruction 与 plugin 显式重新生成 Session system。 */
+    /** 使用 Agent 当前 instruction 与 Plugin 显式重新生成 Session system。 */
     syncshot(): Promise<void>;
     /** 从当前 session 创建一个分叉会话。 */
     fork(input?: AgentSessionForkInput | string): Promise<AgentSession>;

package/bin/types/agent/SessionActor.d.ts.map

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

package/bin/types/agent/SessionTypes.d.ts

@@ -5,9 +5,10 @@
  * - 只描述 session 的输入、摘要、历史、system snapshot 与配置快照。
  * - session actor 方法接口拆到 `SessionActor.ts`。
  */
-import type { AgentModel } from "../../agent/AgentModel.js";
-import type { SessionApprovalMode } from "../session/SessionInteraction.js";
-import type { SessionOrigin } from "../session/SessionOrigin.js";
+import type { ModelClient } from "@downcity/type";
+import type { SessionApprovalMode } from "@downcity/type";
+import type { SessionOrigin } from "@downcity/type";
+import type { SessionSystemBlock, SessionSystemBlockSource } from "@downcity/type/session";
 /**
  * 新建 Session 的输入参数。
  *
@@ -15,13 +16,19 @@ import type { SessionOrigin } from "../session/SessionOrigin.js";
  * `sessions.get(session_id)` 指定已有 ID。
  */
 export interface AgentCreateSessionInput {
-    /** 保持创建输入为无配置字段的协议对象。 */
-    readonly __create_session_input?: never;
+    /**
+     * 当前 Session 的创建来源。
+     *
+     * 省略时使用 `{ type: "chat" }`；其他调用方可以使用任意稳定的非空类型。
+     */
+    readonly origin?: SessionOrigin;
 }
 /**
  * Session 列表查询输入。
  */
 export interface AgentListSessionsInput {
+    /** 要查询的来源分区；省略时只查询 `chat`。 */
+    origin_type?: string;
     /**
      * 只返回绑定到指定 Workspace 的 Session。
      *
@@ -65,7 +72,7 @@ export interface AgentSessionSetInput {
      * - SDK 只接受宿主已经解析完成的运行时模型实例。
      * - 模型选择、ID 与持久化全部由宿主负责。
      */
-    model?: AgentModel;
+    model?: ModelClient;
     /**
      * 当前 Session 的安全策略。
      *
@@ -78,16 +85,16 @@ export interface AgentSessionSetInput {
 /** Session 配置提交后的 Action 可观测性选项。 */
 export interface AgentSessionSetOptions {
     /**
-     * 是否把真实配置变化持久化为 completed Action Message。
+     * 是否把真实配置变化持久化为包含 completed Action Part 的 Agent Message。
      *
      * 关键点（中文）
      * - 默认值为 true。
-     * - 设为 false 只关闭 Action Message，不影响配置写入与检查点提交。
+     * - 设为 false 只关闭 Action Part 历史，不影响配置写入与检查点提交。
      * - 适用于 Session 初始化、恢复与其他不应进入时间线的宿主装配流程。
      */
     persist_action?: boolean;
     /**
-     * 是否在 Action Message 持久化成功后发布对应 Session Mutation。
+     * 是否在 Action Part 所属 Agent Message 持久化成功后发布对应 Session Mutation。
      *
      * 关键点（中文）
      * - 默认跟随 `persist_action`。
@@ -107,7 +114,7 @@ export interface RemoteSessionSetInput {
      *
      * 关键点（中文）
      * - 远程边界只传递稳定、可序列化的模型 ID。
-     * - 服务端宿主负责把模型 ID 解析为运行时 AgentModel。
+     * - 服务端宿主负责把模型 ID 解析为运行时 ModelClient。
      */
     model_id?: string;
     /** 当前远程 Session 的安全策略。 */
@@ -136,7 +143,7 @@ export interface AgentSessionStatus {
  */
 export interface AgentSessionConfigSnapshot {
     /** 当前 session 绑定的默认模型实例。 */
-    model?: AgentModel;
+    model?: ModelClient;
     /** 当前模型的轻量可读标签。 */
     model_label?: string;
     /** 当前模型支持的总上下文窗口长度，单位为 token。 */
@@ -154,7 +161,7 @@ export interface AgentSessionTimelineEvent {
      * 说明（中文）
      * - `tool-call` / `tool-result` 用于把 assistant 内部工具过程平铺给 UI。
      */
-    role: "user" | "assistant" | "tool-call" | "tool-result" | "action";
+    role: "user" | "agent" | "tool-call" | "tool-result" | "action";
     /** 事件时间戳（毫秒）。 */
     ts?: number;
     /** 事件所属消息种类。 */
@@ -195,32 +202,11 @@ export interface AgentSessionTimelineEvent {
 /**
  * Session system block 来源类型。
  */
-export type AgentSessionSystemBlockSource = "core" | "instruction" | "plugin" | "session";
+export type AgentSessionSystemBlockSource = SessionSystemBlockSource;
 /**
  * Session system prompt 的单个组成块。
  */
-export interface AgentSessionSystemBlock {
-    /** 当前 block 的来源层级。 */
-    source: AgentSessionSystemBlockSource;
-    /**
-     * 当前 block 在来源层级内的名称。
-     *
-     * 说明（中文）
-     * - `instruction` 通常使用 `agent`。
-     * - `plugin` 使用对应 plugin 名称。
-     * - `core` 使用 `default`。
-     * - `session` 使用当前 session 上下文名称。
-     */
-    name: string;
-    /**
-     * 已归一化后的 system 文本内容。
-     *
-     * 关键点（中文）
-     * - SDK 不对 instruction 做动态变量替换。
-     * - 动态上下文应由调用方放入 user message。
-     */
-    content: string;
-}
+export type AgentSessionSystemBlock = SessionSystemBlock;
 /**
  * 当前 session 的稳定上下文信息。
  */
@@ -278,7 +264,7 @@ export interface AgentSessionSummary {
      * 当前 session 可读标题。
      *
      * 说明（中文）
-     * - 标题持久化在 session `meta.json` 顶层。
+     * - 标题持久化在 Session SQLite 的 `session_state` 中。
      * - SDK 只在模型成功生成标题时写入，不再从首条用户消息生成 fallback。
      * - 标题允许为空，调用方需要展示占位文案时可自行回退到 `session_id`。
      */
@@ -300,7 +286,9 @@ export interface AgentSessionSummary {
     /** 当前 session 绑定模型的可读标签。 */
     model_label?: string;
     /** 当前 Session 的创建来源。 */
-    origin?: SessionOrigin;
+    origin: SessionOrigin;
+    /** 当前 Session 绑定的 Workspace ID；未绑定时为空。 */
+    workspace_id?: string;
     /** 当前 session 是否处于执行中。 */
     executing?: boolean;
 }
@@ -361,11 +349,15 @@ export interface AgentArchiveSessionInput {
      * - 正在执行中的 session 不允许归档。
      */
     id: string;
+    /** Session 所在的来源分区；省略时使用 `chat`。 */
+    origin_type?: string;
 }
 /**
  * 列出已归档 session 的输入参数。
  */
 export interface AgentArchiveSessionsInput {
+    /** 要查询的来源分区；省略时只查询 `chat`。 */
+    origin_type?: string;
     /**
      * 只返回绑定到指定 Workspace 的归档 Session。
      *

package/bin/types/agent/SessionTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionTypes.d.ts","sourceRoot":"","sources":["../../../src/types/agent/SessionTypes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionTypes.d.ts","sourceRoot":"","sources":["../../../src/types/agent/SessionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,kCAAkC;AAClC,MAAM,WAAW,0BAA0B;IACzC,uBAAuB;IACvB,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED,8BAA8B;AAC9B,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED,sBAAsB;AACtB,MAAM,WAAW,0BAA0B;IACzC,oCAAoC;IACpC,aAAa,EAAE,mBAAmB,CAAC;IACnC,8BAA8B;IAC9B,uBAAuB,EAAE,mBAAmB,CAAC;CAC9C;AAED,sBAAsB;AACtB,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,QAAQ,EAAE,0BAA0B,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,4BAA4B;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;IAChE,iBAAiB;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,EAAE,6BAA6B,CAAC;IACvC,yCAAyC;IACzC,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;CAAG;AAE9E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B"}

package/bin/types/executor/ModelRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent 内部模型请求执行类型。
+ *
+ * 这些类型描述模型请求恢复过程，不依赖 Session 的公开 Mutation 协议。
+ */
+import type { ModelRequestFailureNotice } from "@downcity/type";
+/** 模型请求失败通知回调。 */
+export type ModelRequestFailureReporter = (notice: ModelRequestFailureNotice, 
+/** 保留完整内部错误对象，仅供执行恢复决策使用。 */
+error: unknown) => void | Promise<void>;
+//# sourceMappingURL=ModelRequest.d.ts.map

package/bin/types/executor/ModelRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRequest.d.ts","sourceRoot":"","sources":["../../../src/types/executor/ModelRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,kBAAkB;AAClB,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,EAAE,yBAAyB;AACjC,6BAA6B;AAC7B,KAAK,EAAE,OAAO,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/types/executor/ModelRequest.js

@@ -0,0 +1,7 @@
+/**
+ * Agent 内部模型请求执行类型。
+ *
+ * 这些类型描述模型请求恢复过程，不依赖 Session 的公开 Mutation 协议。
+ */
+export {};
+//# sourceMappingURL=ModelRequest.js.map

package/bin/types/executor/ModelRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRequest.js","sourceRoot":"","sources":["../../../src/types/executor/ModelRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/types/executor/SessionAssistantOutput.d.ts

@@ -4,9 +4,9 @@
  * 该端口直接消费 Downcity Model Protocol 事件，不定义或转发 UI-shaped chunk。
  */
 import type { ModelStreamEvent } from "@downcity/type";
-import type { SessionAssistantResultPart } from "../session/SessionContent.js";
-import type { SessionAssistantMessagePart } from "../session/SessionMessage.js";
-import type { SessionToolExecutionResult, SessionToolInputReady } from "../session/SessionTool.js";
+import type { SessionAgentContent } from "@downcity/type";
+import type { SessionAgentMessagePart } from "@downcity/type";
+import type { SessionToolExecutionResult, SessionToolInputReady } from "../../types/session/SessionTool.js";
 /** Executor 写入当前 Turn Assistant Message 的稳定能力。 */
 export interface SessionAssistantOutput {
     /** 开始一个模型 Step 的独立 Part 作用域。 */
@@ -18,13 +18,24 @@ export interface SessionAssistantOutput {
     /** 写入 Tool 执行终态。 */
     write_tool_result(result: SessionToolExecutionResult): Promise<void>;
     /** 使用模型流聚合出的 canonical Parts 校验当前 Step。 */
-    finish_step(parts: SessionAssistantMessagePart[]): Promise<void>;
+    finish_step(parts: SessionAgentMessagePart[]): Promise<void>;
     /** 放弃当前未完成 Step 的临时作用域。 */
     abort_step(): Promise<void>;
     /** User steer 插入前关闭当前连续 Assistant Message。 */
     close_current_message(): Promise<void>;
     /** 把 Action 产生的封闭内容追加到当前 Assistant Message。 */
-    append_result_parts(parts: readonly SessionAssistantResultPart[]): Promise<void>;
+    append_result_parts(parts: readonly SessionAgentContent[]): Promise<SessionAgentMessagePart[]>;
+    /** 在 Turn 收口产物之前追加用户可见的 canonical Error Part。 */
+    append_error(input: {
+        /** 错误影响范围。 */
+        scope: "session" | "turn";
+        /** 稳定错误码。 */
+        code: string;
+        /** 用户可见错误信息。 */
+        message: string;
+        /** 当前错误是否允许重试恢复。 */
+        recoverable: boolean;
+    }): Promise<void>;
     /** 按 Turn 最终结果收口 Assistant 输出。 */
     finish(input: {
         /** Assistant 最终状态。 */

package/bin/types/executor/SessionAssistantOutput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionAssistantOutput.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionAssistantOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,qBAAqB;IACrB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2BAA2B;IAC3B,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,oBAAoB;IACpB,iBAAiB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,2CAA2C;IAC3C,WAAW,CAAC,KAAK,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,2BAA2B;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,8CAA8C;IAC9C,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,+CAA+C;IAC/C,mBAAmB,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,kCAAkC;IAClC,MAAM,CAAC,KAAK,EAAE;QACZ,sBAAsB;QACtB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC3C,qCAAqC;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB"}
+{"version":3,"file":"SessionAssistantOutput.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionAssistantOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,qBAAqB;IACrB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2BAA2B;IAC3B,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,oBAAoB;IACpB,iBAAiB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,2CAA2C;IAC3C,WAAW,CAAC,KAAK,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,2BAA2B;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,8CAA8C;IAC9C,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,+CAA+C;IAC/C,mBAAmB,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC/F,iDAAiD;IACjD,YAAY,CAAC,KAAK,EAAE;QAClB,cAAc;QACd,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;QAC1B,aAAa;QACb,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,oBAAoB;QACpB,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,KAAK,EAAE;QACZ,sBAAsB;QACtB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC3C,qCAAqC;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB"}

package/bin/types/executor/SessionToolExecutionContext.d.ts

@@ -6,9 +6,9 @@
  * - Agent 工具读取 session_turn_context，Shell 工具只读取 shell_execution_context。
  * - 上下文归属当前 Turn，不通过进程级或异步全局容器共享。
  */
-import type { ShellExecutionContext } from "@downcity/workspace/shell/types/ShellRuntime.js";
-import type { SessionTurnContext } from "./SessionTurnContext.js";
-import type { ToolActionExecutionContext } from "../tools/ToolActionExecutionContext.js";
+import type { ShellExecutionContext } from "@downcity/type/shell";
+import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
+import type { ToolActionExecutionContext } from "../../types/tools/ToolActionExecutionContext.js";
 /**
  * Agent 与 Shell 工具共用的单次执行上下文。
  */

package/bin/types/executor/SessionToolExecutionContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionToolExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B;IAC1B,wBAAwB,EAAE,0BAA0B,CAAC;IACrD,uCAAuC;IACvC,uBAAuB,EAAE,qBAAqB,CAAC;IAC/C,oCAAoC;IACpC,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C"}
+{"version":3,"file":"SessionToolExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B;IAC1B,wBAAwB,EAAE,0BAA0B,CAAC;IACrD,uCAAuC;IACvC,uBAAuB,EAAE,qBAAqB,CAAC;IAC/C,oCAAoC;IACpC,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C"}