@downcity/agent 1.1.408 → 1.1.437

package/bin/session/storage/Metadata.d.ts

@@ -2,11 +2,12 @@
  * SDK Session 元数据辅助。
  *
  * 关键点（中文）
- * - 统一负责 Workspace `sessions/<session_id>/meta.json` 的规范化读取。
- * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
+ * - 统一负责 Session SQLite 中轻量配置摘要与索引字段的规范化。
+ * - 不负责数据库连接、消息聚合或附件读写。
  */
-import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
-import type { FileSystem } from "@downcity/workspace";
+import type { SessionHistoryMeta } from "../../executor/types/SessionHistoryMeta.js";
+import type { SessionOrigin } from "@downcity/type";
+import type { FileSystem } from "@downcity/type";
 /**
  * 归一化 session 标题。
  */
@@ -16,14 +17,14 @@ export declare function normalize_session_title(input: unknown): string | undefi
  */
 export declare function resolve_system_timezone(): string;
 /**
- * 从指定路径读取 session meta.json。
+ * 从指定路径读取旧版 Session metadata。
  *
  * 关键点（中文）
  * - 供归档 session 等需要脱离默认 `sessions/` 目录的场景复用。
  * - 路径本身不做校验，调用方需保证可访问。
  */
 export declare function read_session_metadata_from_path(input: {
-    /** meta.json 文件路径。 */
+    /** 旧版 metadata 文件路径。 */
     filePath: string;
     /** 当前 session_id。 */
     session_id: string;
@@ -31,9 +32,11 @@ export declare function read_session_metadata_from_path(input: {
     agent_id: string;
     /** 当前查询上下文的 workspace_id；存在时必须与 metadata 严格匹配。 */
     workspace_id?: string;
-    /** 当前 Workspace 的统一文件能力。 */
+    /** 当前读取目录对应的来源类型。 */
+    origin_type: string;
+    /** 当前 Agent 私有 Storage 的文件能力。 */
     files: FileSystem;
-}): Promise<SessionHistoryMetaV1>;
+}): Promise<SessionHistoryMeta>;
 /** 将未知 Metadata 内容规范化为当前 Session 的稳定结构。 */
-export declare function normalize_session_metadata(raw: Partial<SessionHistoryMetaV1>, session_id: string, agent_id: string, workspace_id?: string): SessionHistoryMetaV1;
+export declare function normalize_session_metadata(raw: Partial<SessionHistoryMeta>, session_id: string, agent_id: string, origin: SessionOrigin, workspace_id?: string): SessionHistoryMeta;
 //# sourceMappingURL=Metadata.d.ts.map

package/bin/session/storage/Metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Metadata.d.ts","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AActD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAmCD;;;;;;GAMG;AACH,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmBhC;AAED,2CAA2C;AAC3C,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,oBAAoB,CAqCtB"}
+{"version":3,"file":"Metadata.d.ts","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAejD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAkBD;;;;;;GAMG;AACH,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoB9B;AAED,2CAA2C;AAC3C,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,kBAAkB,CAgCpB"}

package/bin/session/storage/Metadata.js

@@ -2,9 +2,10 @@
  * SDK Session 元数据辅助。
  *
  * 关键点（中文）
- * - 统一负责 Workspace `sessions/<session_id>/meta.json` 的规范化读取。
- * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
+ * - 统一负责 Session SQLite 中轻量配置摘要与索引字段的规范化。
+ * - 不负责数据库连接、消息聚合或附件读写。
  */
+import { restore_session_origin } from "@downcity/type";
 function normalizeModelLabel(input) {
     const label = typeof input === "string" ? input.trim() : "";
     return label || undefined;
@@ -42,26 +43,8 @@ function normalize_preview_text(input) {
     const preview_text = typeof input === "string" ? input.trim() : "";
     return preview_text || undefined;
 }
-function normalize_history_bytes(input) {
-    return typeof input === "number" && Number.isInteger(input) && input >= 0
-        ? input
-        : undefined;
-}
-/** 归一化 Session 来源元数据。 */
-function normalize_session_origin(input) {
-    if (!input || typeof input !== "object")
-        return undefined;
-    const raw = input;
-    if (raw.type === "user")
-        return { type: "user" };
-    if (raw.type !== "group")
-        return undefined;
-    const group_id = typeof raw.group_id === "string" ? raw.group_id.trim() : "";
-    const group_session_id = typeof raw.group_session_id === "string" ? raw.group_session_id.trim() : "";
-    return group_id && group_session_id ? { type: "group", group_id, group_session_id } : undefined;
-}
 /**
- * 从指定路径读取 session meta.json。
+ * 从指定路径读取旧版 Session metadata。
  *
  * 关键点（中文）
  * - 供归档 session 等需要脱离默认 `sessions/` 目录的场景复用。
@@ -76,18 +59,16 @@ export async function read_session_metadata_from_path(input) {
     if (input.workspace_id && raw.workspace_id !== input.workspace_id) {
         throw new Error(`Invalid Session Workspace metadata: ${input.session_id}`);
     }
-    return normalize_session_metadata(raw, input.session_id, input.agent_id, raw.workspace_id);
+    return normalize_session_metadata(raw, input.session_id, input.agent_id, restore_session_origin(raw.origin, input.origin_type), raw.workspace_id);
 }
 /** 将未知 Metadata 内容规范化为当前 Session 的稳定结构。 */
-export function normalize_session_metadata(raw, session_id, agent_id, workspace_id) {
+export function normalize_session_metadata(raw, session_id, agent_id, origin, workspace_id) {
     return {
-        v: 1,
+        v: 2,
         session_id: session_id,
         agent_id: agent_id,
         ...(workspace_id ? { workspace_id: workspace_id } : {}),
-        ...(normalize_session_origin(raw.origin)
-            ? { origin: normalize_session_origin(raw.origin) }
-            : {}),
+        origin: restore_session_origin(raw.origin ?? origin, origin.type),
         created_at: typeof raw.created_at === "number" && Number.isFinite(raw.created_at)
             ? raw.created_at
             : Date.now(),
@@ -110,9 +91,6 @@ export function normalize_session_metadata(raw, session_id, agent_id, workspace_
         ...(normalize_preview_text(raw.preview_text)
             ? { preview_text: normalize_preview_text(raw.preview_text) }
             : {}),
-        ...(normalize_history_bytes(raw.historyBytes) !== undefined
-            ? { historyBytes: normalize_history_bytes(raw.historyBytes) }
-            : {}),
     };
 }
 //# sourceMappingURL=Metadata.js.map

package/bin/session/storage/Metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"Metadata.js","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Metadata.js","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"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"}

package/bin/session/storage/RuntimeSessionPort.d.ts

@@ -1,14 +1,14 @@
 /**
- * SDK Session plugin runtime 端口构造器。
+ * SDK Session 宿主运行时端口构造器。
  *
  * 关键点（中文）
- * - 把 SDK 本地 session 适配成 runtime / plugin runtime 依赖的 `SessionPort`。
+ * - 把 SDK 本地 Session 适配成宿主运行时依赖的 `SessionPort`。
  * - SDK 公开面只保留 `prompt()` / `subscribe()`；runtime/service 若要 one-shot 等待结果，也统一委托给 `prompt()`。
  */
 import type { SessionPort } from "../../types/session/SessionPort.js";
 import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "../../types/sdk/AgentSessionStop.js";
-import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "../../types/session/SessionMutation.js";
+import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "@downcity/type";
 import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
 /**
  * 构造 SDK SessionPort 的参数。
@@ -24,6 +24,8 @@ export interface CreateRuntimeSessionPortParams {
      * 读取当前 session 底层执行端口。
      */
     get_executor: SessionPort["get_executor"];
+    /** 读取全部 canonical Session Message。 */
+    messages: SessionPort["messages"];
     /**
      * 追加一条新的 session prompt。
      */
@@ -41,22 +43,20 @@ export interface CreateRuntimeSessionPortParams {
      */
     append_user_message: SessionPort["append_user_message"];
     /**
-     * 追加 assistant 消息到底层历史。
+     * 追加 Agent 消息到底层历史。
      */
-    append_assistant_message: SessionPort["append_assistant_message"];
+    append_agent_message: SessionPort["append_agent_message"];
     /**
      * 返回当前 session 是否正在执行。
      */
     is_executing: () => boolean;
-    /** 读取当前 Session 的只读上下文快照。 */
-    context: SessionPort["context"];
     /**
      * 在执行前确保当前 session 已完成初始化与宿主级配置。
      */
     ensure_ready_for_execution: () => Promise<void>;
 }
 /**
- * 创建供 plugin runtime 使用的 session 端口。
+ * 创建供宿主运行时使用的 Session 端口。
  */
 export declare function create_runtime_session_port(params: CreateRuntimeSessionPortParams): SessionPort;
 //# sourceMappingURL=RuntimeSessionPort.d.ts.map

package/bin/session/storage/RuntimeSessionPort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RuntimeSessionPort.d.ts","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC1C;;OAEG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5E;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C;;OAEG;IACH,SAAS,EAAE,CACT,UAAU,EAAE,yBAAyB,KAClC,0BAA0B,CAAC;IAChC;;OAEG;IACH,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IACxD;;OAEG;IACH,wBAAwB,EAAE,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAClE;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC;;OAEG;IACH,0BAA0B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,8BAA8B,GACrC,WAAW,CAyBb"}
+{"version":3,"file":"RuntimeSessionPort.d.ts","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC1C,sCAAsC;IACtC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAClC;;OAEG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5E;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C;;OAEG;IACH,SAAS,EAAE,CACT,UAAU,EAAE,yBAAyB,KAClC,0BAA0B,CAAC;IAChC;;OAEG;IACH,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IACxD;;OAEG;IACH,oBAAoB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAC1D;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B;;OAEG;IACH,0BAA0B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,8BAA8B,GACrC,WAAW,CAyBb"}

package/bin/session/storage/RuntimeSessionPort.js

@@ -1,19 +1,19 @@
 /**
- * SDK Session plugin runtime 端口构造器。
+ * SDK Session 宿主运行时端口构造器。
  *
  * 关键点（中文）
- * - 把 SDK 本地 session 适配成 runtime / plugin runtime 依赖的 `SessionPort`。
+ * - 把 SDK 本地 Session 适配成宿主运行时依赖的 `SessionPort`。
  * - SDK 公开面只保留 `prompt()` / `subscribe()`；runtime/service 若要 one-shot 等待结果，也统一委托给 `prompt()`。
  */
 /**
- * 创建供 plugin runtime 使用的 session 端口。
+ * 创建供宿主运行时使用的 Session 端口。
  */
 export function create_runtime_session_port(params) {
     return {
         session_id: params.session_id,
         get_model: () => params.get_model(),
         get_executor: () => params.get_executor(),
-        context: async () => await params.context(),
+        messages: async () => await params.messages(),
         prompt: async (input) => {
             await params.ensure_ready_for_execution();
             return await params.prompt(input);
@@ -28,8 +28,8 @@ export function create_runtime_session_port(params) {
         append_user_message: async (messageParams) => {
             await params.append_user_message(messageParams);
         },
-        append_assistant_message: async (messageParams) => {
-            await params.append_assistant_message(messageParams);
+        append_agent_message: async (message_params) => {
+            await params.append_agent_message(message_params);
         },
         is_executing: () => params.is_executing(),
     };

package/bin/session/storage/RuntimeSessionPort.js.map

@@ -1 +1 @@
-{"version":3,"file":"RuntimeSessionPort.js","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2DH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAsC;IAEtC,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QACnC,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;QACzC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE;QAC3C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,MAAM,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1C,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1C,OAAO,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,SAAS,EAAE,CAAC,UAAU,EAAE,EAAE;YACxB,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QACD,mBAAmB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAC3C,MAAM,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAClD,CAAC;QACD,wBAAwB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAChD,MAAM,MAAM,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;QACvD,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;KAC1C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"RuntimeSessionPort.js","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2DH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAsC;IAEtC,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QACnC,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;QACzC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE;QAC7C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,MAAM,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1C,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1C,OAAO,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,SAAS,EAAE,CAAC,UAAU,EAAE,EAAE;YACxB,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QACD,mBAAmB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAC3C,MAAM,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAClD,CAAC;QACD,oBAAoB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;YAC7C,MAAM,MAAM,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;KAC1C,CAAC;AACJ,CAAC"}

package/bin/session/storage/SessionStorageCodec.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Session Message 聚合与 SQLite rows 之间的唯一 codec。
+ *
+ * Message envelope 与 Part 分表保存；公开领域对象仍保持 Message 聚合拥有 parts[]。
+ */
+import type { SessionAgentMessagePart, SessionMessage, SessionUserMessagePart } from "@downcity/type";
+/** messages 表读取行。 */
+export interface SessionMessageRow {
+    /** Message 稳定标识。 */
+    message_id: string;
+    /** 所属 Turn；独立 Session Action 可以为空。 */
+    turn_id: string | null;
+    /** Session 内 Message 顺序。 */
+    sequence: number;
+    /** Message 聚合版本。 */
+    revision: number;
+    /** Message 主体角色。 */
+    role: "user" | "agent";
+    /** Agent Message 写入状态；User Message 固定为空。 */
+    state: "streaming" | "done" | null;
+    /** 默认展示范围。 */
+    visibility: "visible" | "internal";
+    /** Fork 来源 Session。 */
+    origin_session_id: string | null;
+    /** Fork 来源 Message。 */
+    origin_message_id: string | null;
+    /** Fork 来源 Turn。 */
+    origin_turn_id: string | null;
+    /** 创建时间戳。 */
+    created_at: number;
+    /** 更新时间戳。 */
+    updated_at: number;
+}
+/** message_parts 表读取行。 */
+export interface SessionMessagePartRow {
+    /** Part 稳定标识。 */
+    part_id: string;
+    /** 所属 Message。 */
+    message_id: string;
+    /** Message 内 Part 顺序。 */
+    sequence: number;
+    /** 来源模型 Step。 */
+    step_id: string | null;
+    /** Part 内容类型。 */
+    type: SessionUserMessagePart["type"] | SessionAgentMessagePart["type"];
+    /** 单个 Part 的类型专属 JSON 内容。 */
+    content: string;
+    /** 创建时间戳。 */
+    created_at: number;
+    /** 更新时间戳。 */
+    updated_at: number;
+}
+/** 把 Message 聚合拆为数据库 envelope row。 */
+export declare function encode_session_message_row(message: SessionMessage): SessionMessageRow;
+/** 把一个领域 Part 拆为独立数据库 row。 */
+export declare function encode_session_part_row(message: SessionMessage, part: SessionUserMessagePart | SessionAgentMessagePart): SessionMessagePartRow;
+/** 把 envelope 与按顺序读取的 Part rows 组装为公开 Message。 */
+export declare function decode_session_message(row: SessionMessageRow, part_rows: readonly SessionMessagePartRow[], session_id: string): SessionMessage;
+//# sourceMappingURL=SessionStorageCodec.d.ts.map

package/bin/session/storage/SessionStorageCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStorageCodec.d.ts","sourceRoot":"","sources":["../../../src/session/storage/SessionStorageCodec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAGV,uBAAuB,EAGvB,cAAc,EACd,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,4CAA4C;IAC5C,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc;IACd,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;IACnC,uBAAuB;IACvB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uBAAuB;IACvB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0BAA0B;AAC1B,MAAM,WAAW,qBAAqB;IACpC,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB;IACjB,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACvE,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,sCAAsC;AACtC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAerF;AAED,8BAA8B;AAC9B,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,sBAAsB,GAAG,uBAAuB,GACrD,qBAAqB,CAgBvB;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,UAAU,EAAE,MAAM,GACjB,cAAc,CA2ChB"}

package/bin/session/storage/SessionStorageCodec.js

@@ -0,0 +1,331 @@
+/**
+ * Session Message 聚合与 SQLite rows 之间的唯一 codec。
+ *
+ * Message envelope 与 Part 分表保存；公开领域对象仍保持 Message 聚合拥有 parts[]。
+ */
+/** 把 Message 聚合拆为数据库 envelope row。 */
+export function encode_session_message_row(message) {
+    return {
+        message_id: message.message_id,
+        turn_id: message.turn_id ?? null,
+        sequence: message.sequence,
+        revision: message.revision,
+        role: message.role,
+        state: message.role === "agent" ? message.state : null,
+        visibility: message.visibility,
+        origin_session_id: message.origin?.session_id ?? null,
+        origin_message_id: message.origin?.message_id ?? null,
+        origin_turn_id: message.origin?.turn_id ?? null,
+        created_at: message.created_at,
+        updated_at: message.updated_at,
+    };
+}
+/** 把一个领域 Part 拆为独立数据库 row。 */
+export function encode_session_part_row(message, part) {
+    const { part_id, sequence, type, ...content } = part;
+    const step_id = "step_id" in content && typeof content.step_id === "string"
+        ? content.step_id
+        : null;
+    if ("step_id" in content)
+        delete content.step_id;
+    return {
+        part_id,
+        message_id: message.message_id,
+        sequence,
+        step_id,
+        type,
+        content: JSON.stringify(content),
+        created_at: message.created_at,
+        updated_at: message.updated_at,
+    };
+}
+/** 把 envelope 与按顺序读取的 Part rows 组装为公开 Message。 */
+export function decode_session_message(row, part_rows, session_id) {
+    const origin = row.origin_session_id && row.origin_message_id
+        ? {
+            session_id: row.origin_session_id,
+            message_id: row.origin_message_id,
+            ...(row.origin_turn_id ? { turn_id: row.origin_turn_id } : {}),
+        }
+        : undefined;
+    const parts = part_rows
+        .map((part_row) => decode_session_part(part_row, row.role))
+        .sort((left, right) => left.sequence - right.sequence);
+    const base = {
+        message_id: row.message_id,
+        session_id,
+        ...(row.turn_id ? { turn_id: row.turn_id } : {}),
+        sequence: row.sequence,
+        revision: row.revision,
+        visibility: row.visibility,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+        ...(origin ? { origin } : {}),
+    };
+    if (row.role === "user") {
+        const user_parts = parts.filter(is_session_user_part);
+        if (row.state !== null || user_parts.length !== parts.length) {
+            throw new Error(`Invalid persisted User Message: ${row.message_id}`);
+        }
+        return {
+            ...base,
+            role: "user",
+            parts: user_parts,
+        };
+    }
+    const agent_parts = parts.filter(is_session_agent_part);
+    if (!row.state || agent_parts.length !== parts.length) {
+        throw new Error(`Invalid persisted Agent Message: ${row.message_id}`);
+    }
+    return {
+        ...base,
+        role: "agent",
+        state: row.state,
+        parts: agent_parts,
+    };
+}
+/** 解码单个 Part 的类型专属 content。 */
+function decode_session_part(row, role) {
+    const content = parse_part_content(row);
+    const identity = {
+        part_id: row.part_id,
+        sequence: row.sequence,
+        ...(row.step_id ? { step_id: row.step_id } : {}),
+    };
+    switch (row.type) {
+        case "text":
+            if (role === "user") {
+                if (row.step_id)
+                    throw invalid_part(row, "User text cannot have step_id");
+                if (content.state !== undefined) {
+                    throw invalid_part(row, "User text cannot have streaming state");
+                }
+                return {
+                    part_id: row.part_id,
+                    sequence: row.sequence,
+                    type: "text",
+                    text: read_string(content, "text", row),
+                };
+            }
+            return {
+                ...identity,
+                type: "text",
+                text: read_string(content, "text", row),
+                state: read_enum(content, "state", ["streaming", "done"], row),
+            };
+        case "context":
+            if (row.step_id)
+                throw invalid_part(row, "User context cannot have step_id");
+            return {
+                part_id: row.part_id,
+                sequence: row.sequence,
+                type: "context",
+                tag: read_string(content, "tag", row),
+                context: read_string(content, "context", row),
+            };
+        case "reasoning":
+            return {
+                ...identity,
+                type: "reasoning",
+                text: read_string(content, "text", row),
+                state: read_enum(content, "state", ["streaming", "done"], row),
+                ...optional_string(content, "reasoning_signature", row),
+            };
+        case "tool":
+            return {
+                ...identity,
+                type: "tool",
+                tool_call_id: read_string(content, "tool_call_id", row),
+                tool_name: read_string(content, "tool_name", row),
+                state: read_enum(content, "state", ["input-streaming", "ready", "waiting-user", "running", "completed", "failed"], row),
+                ...optional_string(content, "input_text", row),
+                ...optional_json(content, "input"),
+                ...optional_json(content, "output"),
+                ...optional_string(content, "error", row),
+                ...optional_string(content, "title", row),
+            };
+        case "interaction":
+            return {
+                ...identity,
+                type: "interaction",
+                interaction_id: read_string(content, "interaction_id", row),
+                interaction_type: read_string(content, "interaction_type", row),
+                status: read_enum(content, "status", ["pending", "resolved", "denied", "expired", "cancelled", "failed"], row),
+                request: decode_interaction_request(content.request, row),
+                ...(content.response === undefined
+                    ? {}
+                    : { response: decode_interaction_response(content.response, row) }),
+                ...optional_number(content, "resolved_at", row),
+                ...(content.cancel_reason === undefined
+                    ? {}
+                    : {
+                        cancel_reason: read_enum(content, "cancel_reason", ["turn_stopped", "session_disposed", "runtime_interrupted"], row),
+                    }),
+            };
+        case "file":
+            return {
+                ...identity,
+                type: "file",
+                media_type: read_string(content, "media_type", row),
+                url: read_string(content, "url", row),
+                ...optional_string(content, "filename", row),
+            };
+        case "data":
+            return {
+                ...identity,
+                type: "data",
+                data_type: read_string(content, "data_type", row),
+                data: read_json(content, "data", row),
+                ...optional_string(content, "data_id", row),
+            };
+        case "action":
+            return {
+                ...identity,
+                type: "action",
+                action_id: read_string(content, "action_id", row),
+                action_type: read_string(content, "action_type", row),
+                state: read_enum(content, "state", ["running", "completed", "failed"], row),
+                title: read_string(content, "title", row),
+                ...optional_string(content, "description", row),
+                ...(content.data === undefined
+                    ? {}
+                    : { data: read_json_object(content, "data", row) }),
+            };
+        case "error":
+            return {
+                ...identity,
+                type: "error",
+                scope: read_enum(content, "scope", ["session", "turn"], row),
+                code: read_string(content, "code", row),
+                message: read_string(content, "message", row),
+                recoverable: read_boolean(content, "recoverable", row),
+            };
+        default:
+            return assert_never(row.type);
+    }
+}
+/** 判断解码结果是否符合 User Message 的封闭 Part 集合。 */
+function is_session_user_part(part) {
+    if ("step_id" in part)
+        return false;
+    return part.type === "text" || part.type === "context" ||
+        part.type === "file" || part.type === "data";
+}
+/** 判断解码结果是否符合 Agent Message 的封闭 Part 集合。 */
+function is_session_agent_part(part) {
+    return part.type !== "context" &&
+        (part.type !== "text" || "state" in part);
+}
+/** 解析单个 Part 的 JSON 对象，并拒绝数组、null 与损坏内容。 */
+function parse_part_content(row) {
+    let value;
+    try {
+        value = JSON.parse(row.content);
+    }
+    catch (error) {
+        throw invalid_part(row, `content is not valid JSON: ${String(error)}`);
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw invalid_part(row, "content must be a JSON object");
+    }
+    return value;
+}
+/** 读取必需字符串字段。 */
+function read_string(content, key, row) {
+    const value = content[key];
+    if (typeof value !== "string")
+        throw invalid_part(row, `${key} must be a string`);
+    return value;
+}
+/** 读取可选字符串字段，并保留原字段名。 */
+function optional_string(content, key, row) {
+    if (content[key] === undefined)
+        return {};
+    return { [key]: read_string(content, key, row) };
+}
+/** 读取可选有限数字字段，并保留原字段名。 */
+function optional_number(content, key, row) {
+    if (content[key] === undefined)
+        return {};
+    const value = content[key];
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw invalid_part(row, `${key} must be a finite number`);
+    }
+    return { [key]: value };
+}
+/** 读取必需布尔字段。 */
+function read_boolean(content, key, row) {
+    const value = content[key];
+    if (typeof value !== "boolean")
+        throw invalid_part(row, `${key} must be a boolean`);
+    return value;
+}
+/** 读取封闭字符串枚举字段。 */
+function read_enum(content, key, values, row) {
+    const value = content[key];
+    if (typeof value !== "string" || !values.includes(value)) {
+        throw invalid_part(row, `${key} has an unsupported value`);
+    }
+    return value;
+}
+/** 读取必需 JSON 字段。 */
+function read_json(content, key, row) {
+    if (!Object.prototype.hasOwnProperty.call(content, key)) {
+        throw invalid_part(row, `${key} is required`);
+    }
+    return content[key];
+}
+/** 读取可选 JSON 字段，并保留原字段名。 */
+function optional_json(content, key) {
+    return Object.prototype.hasOwnProperty.call(content, key)
+        ? { [key]: content[key] }
+        : {};
+}
+/** 读取必需 JSON object 字段。 */
+function read_json_object(content, key, row) {
+    const value = content[key];
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw invalid_part(row, `${key} must be a JSON object`);
+    }
+    return value;
+}
+/** 校验并读取持久化 Interaction 请求。 */
+function decode_interaction_request(value, row) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw invalid_part(row, "request must be a JSON object");
+    }
+    const request = value;
+    read_string(request, "interaction_id", row);
+    read_string(request, "turn_id", row);
+    read_string(request, "type", row);
+    read_json(request, "payload", row);
+    const source = read_json_object(request, "source", row);
+    if (!["tool", "plugin", "shell", "execution"].includes(String(source.type))) {
+        throw invalid_part(row, "request.source.type has an unsupported value");
+    }
+    const created_at = request.created_at;
+    if (typeof created_at !== "number" || !Number.isFinite(created_at)) {
+        throw invalid_part(row, "request.created_at must be a finite number");
+    }
+    return value;
+}
+/** 校验并读取持久化 Interaction 响应。 */
+function decode_interaction_response(value, row) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw invalid_part(row, "response must be a JSON object");
+    }
+    const response = value;
+    read_string(response, "type", row);
+    read_enum(response, "outcome", ["resolved", "denied"], row);
+    read_json(response, "payload", row);
+    return value;
+}
+/** 构造带稳定 Part 身份的存储损坏错误。 */
+function invalid_part(row, reason) {
+    return new Error(`Invalid persisted Session Part ${row.part_id} (${row.type}): ${reason}`);
+}
+/** schema 联合类型增加成员时强制 codec 显式解码。 */
+function assert_never(value) {
+    throw new Error(`Unsupported persisted Session Part type: ${String(value)}`);
+}
+//# sourceMappingURL=SessionStorageCodec.js.map