@downcity/agent 1.1.430 → 1.1.437

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

@@ -3,29 +3,29 @@
  *
  * 关键点（中文）
  * - `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 { RuntimeToolEffect } from "@downcity/type";
-import type { SessionAssistantResultPart, SessionPromptPart } 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[];

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;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,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;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"}
+{"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,7 @@
  *
  * 关键点（中文）
  * - `output` 是标准 Tool Result，原样交给模型执行器和 canonical Tool Part。
- * - `messages` 是执行后写入 Session 的真实 User / Assistant Message 内容。
+ * - `messages` 是执行后产生的运行期 User 输入或 canonical Agent 内容。
  * - `effects` 是当前 Turn 只追加收集、并在收口检查点解释的已发生副作用。
  * - Message Parts 复用 Downcity Session UI 协议，不再建立文件、图片或 Plugin 专用桥接。
  */

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

@@ -7,6 +7,7 @@
  */
 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 类。
  *
@@ -73,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,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,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;;;;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;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/AgentStorage.d.ts

@@ -5,13 +5,15 @@
  * Workspace 只提供执行上下文，不拥有这份存储。
  */
 import type { SessionStore } from "../../types/store/SessionStore.js";
-import type { FileSystem } from "@downcity/type";
+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,gBAAgB,CAAC;AAEjD,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

@@ -11,7 +11,6 @@ import type { RespondSessionInteractionInput, SessionInteractionResult, SessionP
 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 { AgentSessionCompactHandle } from "../../types/sdk/AgentSessionCompact.js";
 import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
 import type { SessionOrigin } from "@downcity/type";
 /**
@@ -47,14 +46,6 @@ export interface AgentSessionActor {
     prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
     /** 停止当前 turn，并取消尚未被吸收的排队 prompt。 */
     stop(): Promise<AgentSessionStopResult>;
-    /**
-     * 把一次显式历史压缩加入当前 Session 的有序输入队列。
-     *
-     * 关键点（中文）
-     * - 返回句柄表示 Command 已成功入队。
-     * - `handle.finished` 在压缩真正完成或失败后兑现。
-     */
-    compact(): Promise<AgentSessionCompactHandle>;
     /** 订阅当前 session 的未来事件。 */
     subscribe(subscriber: SessionMutationSubscriber): SessionMutationUnsubscribe;
     /** 读取当前 session messages 分页。 */

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":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,iBAAiB,GAAG,YAAY;IAC9E,oBAAoB;IACpB,MAAM,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3D,wBAAwB;IACxB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEjE,gCAAgC;IAChC,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,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEjF,uBAAuB;IACvB,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAEnD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B,uBAAuB;IACvB,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtC,qBAAqB;IACrB,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAExE,oCAAoC;IACpC,IAAI,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAExC,0BAA0B;IAC1B,SAAS,CACP,UAAU,EAAE,yBAAyB,GACpC,0BAA0B,CAAC;IAE9B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAExE,kCAAkC;IAClC,MAAM,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAE9C,0CAA0C;IAC1C,YAAY,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAErD,6BAA6B;IAC7B,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEtC,uCAAuC;IACvC,OAAO,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAE5C,yBAAyB;IACzB,GAAG,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF,kDAAkD;IAClD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,0DAA0D;IAC1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,8DAA8D;IAC9D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,4BAA4B;IAC5B,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,gCAAgC;IAChC,GAAG,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF,8BAA8B;IAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC3E"}

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

@@ -85,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`。
@@ -161,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;
     /** 事件所属消息种类。 */
@@ -264,7 +264,7 @@ export interface AgentSessionSummary {
      * 当前 session 可读标题。
      *
      * 说明（中文）
-     * - 标题持久化在 session `meta.json` 顶层。
+     * - 标题持久化在 Session SQLite 的 `session_state` 中。
      * - SDK 只在模型成功生成标题时写入，不再从首条用户消息生成 fallback。
      * - 标题允许为空，调用方需要展示占位文案时可自行回退到 `session_id`。
      */

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

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

@@ -4,8 +4,8 @@
  * 该端口直接消费 Downcity Model Protocol 事件，不定义或转发 UI-shaped chunk。
  */
 import type { ModelStreamEvent } from "@downcity/type";
-import type { SessionAssistantResultPart } from "@downcity/type";
-import type { SessionAssistantMessagePart } from "@downcity/type";
+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 {
@@ -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,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAClE,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/SessionTurnContext.d.ts

@@ -8,8 +8,8 @@
  */
 import type { RuntimeToolEffect } from "@downcity/type";
 import type { ShellApprovalGateway } from "@downcity/type";
-import type { SessionUserMessage } from "@downcity/type";
-import type { SessionAssistantResultPart } from "@downcity/type";
+import type { SessionModelUserContent, SessionUserMessage } from "@downcity/type";
+import type { SessionAgentContent } from "@downcity/type";
 import type { SessionAssistantOutput } from "../../types/executor/SessionAssistantOutput.js";
 import type { SessionHookContext } from "@downcity/type";
 import type { SessionHookScopeRuntime } from "@downcity/type";
@@ -34,12 +34,12 @@ export interface SessionTurnContextInit {
     project_root?: string;
     /** 上游取消信号；上下文会把它转发到自身拥有的运行生命周期。 */
     abort_signal?: AbortSignal;
-    /** 在 Step 检查点消费 Session 队列，并返回应并入模型上下文的 User 消息。 */
-    merge_step_input?: () => Promise<SessionUserMessage[]>;
+    /** 在 Step 检查点提交 Session 输入队列；持久化消息由 Composer 重新读取。 */
+    commit_step_input?: () => Promise<void>;
+    /** 将 Executor 产生的内部模型输入持久化为当前 Turn 的 canonical User Message。 */
+    append_internal_user_message?: (parts: readonly SessionModelUserContent[]) => Promise<SessionUserMessage>;
     /** 判断是否仍有等待下一个 Step 消费的 User prompt。 */
     has_pending_step_input?: () => boolean;
-    /** 消费一次 canonical history 重载请求。 */
-    consume_history_reload?: () => boolean;
     /** Executor 写入 canonical Assistant Message 使用的唯一输出端口。 */
     assistant_output?: SessionAssistantOutput;
     /** 当前 Session 执行面创建用户异步交互的端口。 */
@@ -103,29 +103,27 @@ export interface SessionTurnContext {
         /** 为 City Plugin 生成只包含稳定、只读运行快照的新对象。 */
         hook_context(call_id?: string): SessionHookContext;
     };
-    /** 当前运行的动态 User 输入及延迟持久化输入。 */
+    /** 当前运行的动态 User 输入。 */
     readonly input: {
-        /** 在 Step 边界消费运行期注入消息与 Session 队列消息。 */
-        checkpoint(): Promise<SessionUserMessage[]>;
+        /** 登记已经持久化、属于本 Turn 的 canonical User Message。 */
+        observe_user_message(message: SessionUserMessage): void;
+        /** 返回本 Turn 已登记 User Message 的不可变快照。 */
+        user_messages(): readonly SessionUserMessage[];
+        /** 提交输入队列；下一 Step 由 Composer 重新读取 canonical history。 */
+        checkpoint(): Promise<void>;
         /** 判断是否有等待下一个 Step 消费的 Session prompt。 */
         has_pending(): boolean;
-        /** 注入一条只影响当前运行、在下一 Step 生效的 User 消息。 */
-        inject_user_message(message: SessionUserMessage): void;
-        /** 延迟到 Assistant 结果落盘后再持久化一条 User 消息。 */
-        defer_user_message(message: SessionUserMessage): void;
-        /** 返回延迟持久化 User 消息的不可变快照。 */
-        deferred_user_messages(): readonly SessionUserMessage[];
-        /** 消费一次 canonical history 重载请求。 */
-        consume_history_reload(): boolean;
+        /** 持久化一条只供模型消费的内部 canonical User Message。 */
+        append_internal(parts: readonly SessionModelUserContent[]): Promise<SessionUserMessage>;
     };
     /** 当前运行的 Assistant Message 与辅助 Action 输出能力。 */
     readonly output: {
         /** canonical Assistant Message 的唯一写入端口。 */
         readonly assistant?: SessionAssistantOutput;
         /** 把 Action 产生的 Assistant Parts 加入当前 Step 收口队列。 */
-        enqueue_assistant_parts(parts: readonly SessionAssistantResultPart[]): void;
+        enqueue_assistant_parts(parts: readonly SessionAgentContent[]): void;
         /** 消费当前 Step 中等待写入 canonical Assistant Message 的 Parts。 */
-        take_assistant_parts(): SessionAssistantResultPart[];
+        take_assistant_parts(): SessionAgentContent[];
         /** 发布一条不进入 LLM 输入的 Session Action。 */
         publish_action(event: AgentSessionActionEvent): Promise<void>;
         /** 把当前 Turn 的内部模型请求失败交给 Session 边界。 */

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

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

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

@@ -2,7 +2,7 @@
  * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - Action 运行事件由 Session 收口为 canonical `SessionActionMessage`。
+ * - Action 运行事件由 Session 收口为 canonical `SessionAgentActionPart`。
  * - Action 不进入模型输入。
  */
 import type { SessionActionEvent, SessionActionStatus } from "@downcity/type";

package/bin/types/sdk/AgentSessionAction.js

@@ -2,7 +2,7 @@
  * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - Action 运行事件由 Session 收口为 canonical `SessionActionMessage`。
+ * - Action 运行事件由 Session 收口为 canonical `SessionAgentActionPart`。
  * - Action 不进入模型输入。
  */
 export {};

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

@@ -5,7 +5,7 @@
  * - `prompt()` 是 Session actor 模型下唯一的输入入口。
  * - 首条输入、运行中补充输入、排队到下一轮的输入，调用侧都使用同一结构。
  */
-import type { SessionPromptPart } from "@downcity/type";
+import type { SessionUserContent } from "@downcity/type";
 /**
  * Session user message part 类型。
  *
@@ -13,7 +13,7 @@ import type { SessionPromptPart } from "@downcity/type";
  * - 这是 Downcity Session 输入边界，不依赖模型协议或第三方 SDK。
  * - 可直接用于 `session.prompt({ query: [...parts] })` 传入 text、context、file 等 parts。
  */
-export type SessionUserMessagePart = SessionPromptPart;
+export type AgentSessionPromptContent = SessionUserContent;
 /**
  * Session prompt 输入。
  *
@@ -41,24 +41,33 @@ export type SessionUserMessagePart = SessionPromptPart;
  * - 远程 Session 中，Data URL 在服务端落盘；调用方本地路径必须对服务端可访问。
  */
 export interface AgentSessionPromptInput {
+    /**
+     * 调用方为同一业务输入提供的稳定幂等标识。
+     *
+     * 说明（中文）
+     * - 相同 Session 内重复提交同一个 `request_id`，只会创建一条 canonical User Message。
+     * - 已完成的请求直接返回原 Turn 结果；进程重启后未完成的请求会复用原 Turn 恢复执行。
+     * - 不同业务输入不得复用同一个值；不需要跨进程重试的交互式调用可以省略。
+     */
+    request_id?: string;
     /**
      * 当前这次要追加到 Session 的用户文本或 parts 数组。
      *
      * 说明（中文）
      * - 支持两种格式：
      *   1. `string`：纯文本用户输入，Session 会将其包装为用户消息。
-     *   2. `SessionUserMessagePart[]`：Downcity Session user parts，可直接携带 text、context、file 等内容。
+     *   2. `AgentSessionPromptContent[]`：Downcity Session 内容，可直接携带 text、context、file 等内容。
      * - 调用侧永远只传"新的用户输入"。
      * - 它是否并入当前 turn，还是排到下一 turn，由 Session 内部决定。
      */
-    query: string | SessionUserMessagePart[];
+    query: string | AgentSessionPromptContent[];
 }
 /**
  * 判断 prompt 输入是否为空。
  *
  * 说明（中文）
  * - `string`：trim 后为空即视为空。
- * - `SessionUserMessagePart[]`：数组为空，或仅包含空文本和空 Context 时视为空。
+ * - `AgentSessionPromptContent[]`：数组为空，或仅包含空文本和空 Context 时视为空。
  */
 export declare function is_agent_session_prompt_input_empty(input: AgentSessionPromptInput): boolean;
 //# sourceMappingURL=AgentSessionPrompt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionPrompt.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAiB3F"}
+{"version":3,"file":"AgentSessionPrompt.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,GAAG,yBAAyB,EAAE,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAiB3F"}

package/bin/types/sdk/AgentSessionPrompt.js

@@ -10,7 +10,7 @@
  *
  * 说明（中文）
  * - `string`：trim 后为空即视为空。
- * - `SessionUserMessagePart[]`：数组为空，或仅包含空文本和空 Context 时视为空。
+ * - `AgentSessionPromptContent[]`：数组为空，或仅包含空文本和空 Context 时视为空。
  */
 export function is_agent_session_prompt_input_empty(input) {
     const query = input.query;

package/bin/types/sdk/AgentSessionPrompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionPrompt.js","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqDH;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAA8B;IAChF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,8BAA8B;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YACzD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"AgentSessionPrompt.js","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+DH;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAA8B;IAChF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,8BAA8B;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YACzD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * AdaptivePartContextPolicy 内部持久化与候选类型。
+ *
+ * 类型集中在 types 目录，策略模块只保留上下文选择行为。
+ */
+import type { SessionAgentMessagePart, SessionMessage, SessionUserMessagePart } from "@downcity/type";
+/** Part 级累计摘要 checkpoint。 */
+export interface AdaptivePartCheckpointRow {
+    /** checkpoint 稳定标识。 */
+    checkpoint_id: string;
+    /** 边界所属 Message 标识。 */
+    through_message_id: string;
+    /** 边界所属 Message sequence。 */
+    through_message_sequence: number;
+    /** 边界 Part sequence。 */
+    through_part_sequence: number;
+    /** 累计摘要正文。 */
+    summary: string;
+    /** 生成派生结果的策略版本。 */
+    policy_version: number;
+    /** 派生记录创建时间。 */
+    created_at: number;
+}
+/** 可参与摘要的稳定 Part 及其 canonical 位置。 */
+export interface StablePartCandidate {
+    /** Part 所属完整 Message。 */
+    message: SessionMessage;
+    /** 具体 canonical Part。 */
+    part: SessionUserMessagePart | SessionAgentMessagePart;
+}
+//# sourceMappingURL=AdaptivePartContextPolicy.d.ts.map

package/bin/types/session/AdaptivePartContextPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptivePartContextPolicy.d.ts","sourceRoot":"","sources":["../../../src/types/session/AdaptivePartContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB,6BAA6B;AAC7B,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,yBAAyB;IACzB,IAAI,EAAE,sBAAsB,GAAG,uBAAuB,CAAC;CACxD"}

package/bin/types/session/AdaptivePartContextPolicy.js

@@ -0,0 +1,7 @@
+/**
+ * AdaptivePartContextPolicy 内部持久化与候选类型。
+ *
+ * 类型集中在 types 目录，策略模块只保留上下文选择行为。
+ */
+export {};
+//# sourceMappingURL=AdaptivePartContextPolicy.js.map

package/bin/types/session/AdaptivePartContextPolicy.js.map

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

package/bin/types/session/{SessionAssistantMessageState.d.ts → SessionAgentMessageState.d.ts}

@@ -4,20 +4,20 @@
  * 该类型只暴露 canonical Message 所有者允许使用的最小能力，避免内部协作者
  * 复制 SessionMessages 的消息索引或 Mutation 发布状态。
  */
-import type { SessionMessageStore } from "../../types/store/SessionDataStore.js";
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
 import type { SessionMessage } from "@downcity/type";
 import type { SessionMutation } from "@downcity/type";
 /** Assistant Message 状态转换器的构造参数。 */
-export interface SessionAssistantMessageStateOptions {
+export interface SessionAgentMessageStateOptions {
     /** 当前 Assistant Message 所属 Session 的稳定标识。 */
     session_id: string;
-    /** 负责持久化 canonical Message 与 Assistant 草稿的 Store。 */
-    store: SessionMessageStore;
+    /** 负责持久化 canonical Message 稳定检查点的 Store。 */
+    store: SessionStorage;
     /** 读取 SessionMessages 当前持有的 canonical Message 集合。 */
     list_messages: () => Iterable<SessionMessage>;
     /** 接受已持久化的完整 Message 快照，并按需发布 Mutation。 */
     accept_message: (message: SessionMessage, publish_mutation?: boolean) => void;
-    /** 接受已持久化的增量 Mutation，并更新 canonical Message 快照。 */
-    accept_mutation: (mutation: SessionMutation, message: SessionMessage) => void;
+    /** 接受未持久化的实时 Mutation，并只更新当前运行投影。 */
+    project_mutation: (mutation: SessionMutation, message: SessionMessage) => void;
 }
-//# sourceMappingURL=SessionAssistantMessageState.d.ts.map
+//# sourceMappingURL=SessionAgentMessageState.d.ts.map

package/bin/types/session/SessionAgentMessageState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAgentMessageState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionAgentMessageState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,oCAAoC;AACpC,MAAM,WAAW,+BAA+B;IAC9C,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,cAAc,CAAC;IACtB,qDAAqD;IACrD,aAAa,EAAE,MAAM,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9C,2CAA2C;IAC3C,cAAc,EAAE,CACd,OAAO,EAAE,cAAc,EACvB,gBAAgB,CAAC,EAAE,OAAO,KACvB,IAAI,CAAC;IACV,qCAAqC;IACrC,gBAAgB,EAAE,CAChB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,KACpB,IAAI,CAAC;CACX"}

package/bin/types/session/{SessionAssistantMessageState.js → SessionAgentMessageState.js}

@@ -5,4 +5,4 @@
  * 复制 SessionMessages 的消息索引或 Mutation 发布状态。
  */
 export {};
-//# sourceMappingURL=SessionAssistantMessageState.js.map
+//# sourceMappingURL=SessionAgentMessageState.js.map

package/bin/types/session/SessionAgentMessageState.js.map

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

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

@@ -3,8 +3,18 @@
  *
  * Command 只存在于 Session 运行进程内，不属于 Remote Transport 协议，也不持久化。
  */
-/** Session Command 构造参数。 */
-export interface SessionCommandOptions {
+/** Session Command 的执行类别。 */
+export type SessionCommandKind = 
+/** Prompt Command 需要创建或加入一个 Turn。 */
+"prompt"
+/** Maintenance Command 可以在 Session 空闲期独立执行。 */
+ | "maintenance";
+/** Session 有序输入队列中的 Command。 */
+export interface SessionCommand {
+    /** 当前 Command 的执行类别。 */
+    kind: SessionCommandKind;
+    /** Prompt 恢复执行时要求复用的稳定 Turn ID。 */
+    turn_id?: string;
     /** Command 出队后执行的完整行为。 */
     execute: () => Promise<void>;
     /** Session stop 时取消该 Command 的可选行为；未提供时 Command 继续保留。 */
@@ -12,17 +22,19 @@ export interface SessionCommandOptions {
     /** Command 成功执行后需要持久化的完成信息；未提供时静默完成。 */
     completion?: SessionCommandCompletion;
 }
+/** Session facade 创建 Command 时使用的输入。 */
+export type SessionCommandOptions = SessionCommand;
 /** Session Command 成功执行后的 canonical 持久化信息。 */
 export interface SessionCommandCompletion {
-    /** 完成信息固定持久化为 Action Message。 */
+    /** 完成信息固定持久化为 Agent Message 内的 Action Part。 */
     type: "action";
-    /** Action Message 使用的稳定业务标识。 */
+    /** Action Part 及其所属 Agent Message 共用的稳定业务标识。 */
     id: string;
-    /** Action Message 展示的用户可读标题。 */
+    /** Action Part 展示的用户可读标题。 */
     title: string;
-    /** Action Message 展示的可选结果说明。 */
+    /** Action Part 展示的可选结果说明。 */
     description?: string;
-    /** Action Message 持久化后是否发布对应 Session Mutation。 */
+    /** Action Part 所属 Agent Message 持久化后是否发布对应 Session Mutation。 */
     publish_mutation?: boolean;
 }
 //# sourceMappingURL=SessionCommand.d.ts.map

package/bin/types/session/SessionCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionCommand.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4BAA4B;AAC5B,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC;AAED,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"SessionCommand.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB;AAC5B,qCAAqC;AACnC,QAAQ;AACV,+CAA+C;GAC7C,aAAa,CAAC;AAElB,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC;AAED,wCAAwC;AACxC,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAEnD,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}