@downcity/agent 1.1.217 → 1.1.224

package/bin/session/recorder/SessionMessageCodec.js

@@ -0,0 +1,257 @@
+/**
+ * SessionMessage 与 AI SDK UIMessage 的内部投影转换。
+ *
+ * 关键点（中文）
+ * - SessionMessage 是唯一持久化事实；UIMessage 只在 Executor/Composer 边界临时构造。
+ * - action/error 不转换为模型消息。
+ * - part_id 只服务 Session Message identity，不传入模型协议。
+ */
+/** 把 Session Message 投影成 Executor 可消费的 UIMessage。 */
+export function to_executor_ui_message(message) {
+    if (message.type !== "user" && message.type !== "assistant")
+        return null;
+    const metadata = {
+        v: 1,
+        ts: message.updated_at,
+        sessionId: message.session_id,
+        turnId: message.turn_id,
+        source: message.type === "user"
+            ? "ingress"
+            : message.kind === "summary"
+                ? "compact"
+                : "egress",
+        kind: message.type === "assistant" && message.kind === "summary"
+            ? "summary"
+            : "normal",
+        extra: {
+            sequence: message.sequence,
+            revision: message.revision,
+            visibility: message.visibility,
+            ...(message.type === "user"
+                ? { inputType: message.input_type }
+                : { segmentIndex: message.segment_index, status: message.status }),
+        },
+    };
+    return {
+        id: message.message_id,
+        role: message.type,
+        metadata,
+        parts: message.type === "user"
+            ? to_ui_user_parts(message.parts)
+            : to_ui_assistant_parts(message.parts),
+    };
+}
+/** 把 AI SDK user parts 转换成可持久化 Session parts。 */
+export function from_ui_user_parts(parts) {
+    if (!Array.isArray(parts))
+        return [];
+    return parts.flatMap((part, index) => {
+        if (!part || typeof part !== "object")
+            return [];
+        const candidate = part;
+        if (candidate.type === "text") {
+            return [{
+                    part_id: `user-text:${index + 1}`,
+                    type: "text",
+                    text: String(candidate.text || ""),
+                    state: "done",
+                }];
+        }
+        if (candidate.type === "file") {
+            return [{
+                    part_id: `user-file:${index + 1}`,
+                    type: "file",
+                    url: String(candidate.url || ""),
+                    media_type: String(candidate.mediaType || "application/octet-stream"),
+                    ...(candidate.filename ? { filename: String(candidate.filename) } : {}),
+                }];
+        }
+        if (String(candidate.type || "").startsWith("data-")) {
+            return [{
+                    part_id: `user-data:${index + 1}`,
+                    type: "data",
+                    data_type: String(candidate.type),
+                    data: to_json_value(candidate.data),
+                }];
+        }
+        return [];
+    });
+}
+/** 把最终 AI SDK assistant parts 转换成 Session parts。 */
+export function from_ui_assistant_parts(parts) {
+    if (!Array.isArray(parts))
+        return [];
+    return parts.flatMap((part, index) => {
+        if (!part || typeof part !== "object")
+            return [];
+        const candidate = part;
+        const type = String(candidate.type || "");
+        if (type === "text" || type === "reasoning") {
+            return [{
+                    part_id: `${type}:${index + 1}`,
+                    sequence: index + 1,
+                    type: type,
+                    text: String(candidate.text || ""),
+                    state: "done",
+                }];
+        }
+        if (type === "file") {
+            return [{
+                    part_id: `file:${index + 1}`,
+                    sequence: index + 1,
+                    type: "file",
+                    url: String(candidate.url || ""),
+                    media_type: String(candidate.mediaType || "application/octet-stream"),
+                    ...(candidate.filename ? { filename: String(candidate.filename) } : {}),
+                }];
+        }
+        if (type === "dynamic-tool" || type.startsWith("tool-")) {
+            const state = String(candidate.state || "");
+            return [{
+                    part_id: String(candidate.toolCallId || `tool:${index + 1}`),
+                    sequence: index + 1,
+                    type: "tool",
+                    tool_call_id: String(candidate.toolCallId || `tool:${index + 1}`),
+                    tool_name: String(candidate.toolName || "").trim() ||
+                        type.replace(/^tool-/, "") ||
+                        "unknown",
+                    state: state === "output-available"
+                        ? "completed"
+                        : state === "output-error" || state === "output-denied"
+                            ? "failed"
+                            : state === "approval-requested"
+                                ? "approval-required"
+                                : state === "input-streaming"
+                                    ? "input-streaming"
+                                    : state === "input-available"
+                                        ? "ready"
+                                        : "running",
+                    ...(candidate.input !== undefined
+                        ? { input: to_json_value(candidate.input) }
+                        : {}),
+                    ...(candidate.output !== undefined
+                        ? { output: to_json_value(candidate.output) }
+                        : {}),
+                    ...(candidate.errorText ? { error: String(candidate.errorText) } : {}),
+                }];
+        }
+        return [];
+    });
+}
+/** 提取 Assistant Message 的最终可见文本。 */
+export function extract_session_assistant_text(message) {
+    if (!message)
+        return "";
+    return message.parts
+        .flatMap((part) => part.type === "text" ? [part.text] : [])
+        .join("")
+        .trim();
+}
+function to_ui_user_parts(parts) {
+    return parts.map((part) => {
+        if (part.type === "text") {
+            return { type: "text", text: part.text, state: part.state };
+        }
+        if (part.type === "file") {
+            return {
+                type: "file",
+                url: part.url,
+                mediaType: part.media_type,
+                ...(part.filename ? { filename: part.filename } : {}),
+            };
+        }
+        return {
+            type: part.data_type,
+            data: part.data,
+        };
+    });
+}
+function to_ui_assistant_parts(parts) {
+    return parts.map((part) => {
+        if (part.type === "text" || part.type === "reasoning") {
+            return { type: part.type, text: part.text, state: part.state };
+        }
+        if (part.type === "file") {
+            return {
+                type: "file",
+                url: part.url,
+                mediaType: part.media_type,
+                ...(part.filename ? { filename: part.filename } : {}),
+            };
+        }
+        if (part.type === "data") {
+            return {
+                type: part.data_type,
+                data: part.data,
+            };
+        }
+        if (!("tool_call_id" in part)) {
+            throw new Error(`Unsupported Assistant part: ${part.type}`);
+        }
+        const input = part.input ?? parse_json(part.input_text);
+        if (part.state === "completed") {
+            return {
+                type: "dynamic-tool",
+                toolName: part.tool_name,
+                toolCallId: part.tool_call_id,
+                state: "output-available",
+                input,
+                output: part.output,
+            };
+        }
+        if (part.state === "failed") {
+            return {
+                type: "dynamic-tool",
+                toolName: part.tool_name,
+                toolCallId: part.tool_call_id,
+                state: "output-error",
+                input,
+                errorText: part.error || "Tool failed",
+            };
+        }
+        if (part.state === "approval-required") {
+            return {
+                type: "dynamic-tool",
+                toolName: part.tool_name,
+                toolCallId: part.tool_call_id,
+                state: "approval-requested",
+                input,
+                approval: { id: part.approval_id || `approval:${part.tool_call_id}` },
+            };
+        }
+        return {
+            type: "dynamic-tool",
+            toolName: part.tool_name,
+            toolCallId: part.tool_call_id,
+            state: part.state === "input-streaming" ? "input-streaming" : "input-available",
+            input,
+        };
+    });
+}
+function parse_json(input) {
+    const value = String(input || "").trim();
+    if (!value)
+        return {};
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+function to_json_value(input) {
+    if (input === undefined || input === null)
+        return null;
+    if (typeof input === "string" ||
+        typeof input === "number" ||
+        typeof input === "boolean") {
+        return input;
+    }
+    try {
+        return JSON.parse(JSON.stringify(input));
+    }
+    catch {
+        return String(input);
+    }
+}
+//# sourceMappingURL=SessionMessageCodec.js.map

package/bin/session/recorder/SessionMessageCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMessageCodec.js","sourceRoot":"","sources":["../../../src/session/recorder/SessionMessageCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,qDAAqD;AACrD,MAAM,UAAU,sBAAsB,CACpC,OAAuB;IAEvB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,QAAQ,GAAsB;QAClC,CAAC,EAAE,CAAC;QACJ,EAAE,EAAE,OAAO,CAAC,UAAU;QACtB,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,MAAM,EAAE,OAAO,CAAC,OAAO;QACvB,MAAM,EACJ,OAAO,CAAC,IAAI,KAAK,MAAM;YACrB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;gBAC1B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,QAAQ;QAChB,IAAI,EACF,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YACxD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,QAAQ;QACd,KAAK,EAAE;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;gBACzB,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE;gBACnC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACrE;KACF,CAAC;IACF,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,UAAU;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ;QACR,KAAK,EACH,OAAO,CAAC,IAAI,KAAK,MAAM;YACrB,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC;YACjC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC;KACjB,CAAC;AAC9B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,kBAAkB,CAChC,KAA4C;IAE5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,OAAO,CAAyB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC3D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,IAA+B,CAAC;QAClD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,CAAC;oBACN,OAAO,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE;oBACjC,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;oBAClC,KAAK,EAAE,MAAe;iBACvB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,CAAC;oBACN,OAAO,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE;oBACjC,IAAI,EAAE,MAAe;oBACrB,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC;oBAChC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,IAAI,0BAA0B,CAAC;oBACrE,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC;oBACN,OAAO,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE;oBACjC,IAAI,EAAE,MAAe;oBACrB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;oBACjC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC;iBACpC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,uBAAuB,CACrC,KAA4C;IAE5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,OAAO,CAA8B,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAChE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,IAA+B,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC5C,OAAO,CAAC;oBACN,OAAO,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE;oBAC/B,QAAQ,EAAE,KAAK,GAAG,CAAC;oBACnB,IAAI,EAAE,IAA4B;oBAClC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;oBAClC,KAAK,EAAE,MAAe;iBACvB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC;oBACN,OAAO,EAAE,QAAQ,KAAK,GAAG,CAAC,EAAE;oBAC5B,QAAQ,EAAE,KAAK,GAAG,CAAC;oBACnB,IAAI,EAAE,MAAe;oBACrB,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC;oBAChC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,IAAI,0BAA0B,CAAC;oBACrE,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC;oBACN,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,QAAQ,KAAK,GAAG,CAAC,EAAE,CAAC;oBAC5D,QAAQ,EAAE,KAAK,GAAG,CAAC;oBACnB,IAAI,EAAE,MAAe;oBACrB,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,QAAQ,KAAK,GAAG,CAAC,EAAE,CAAC;oBACjE,SAAS,EACP,MAAM,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;wBACvC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;wBAC1B,SAAS;oBACX,KAAK,EACH,KAAK,KAAK,kBAAkB;wBAC1B,CAAC,CAAC,WAAoB;wBACtB,CAAC,CAAC,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,eAAe;4BACrD,CAAC,CAAC,QAAiB;4BACnB,CAAC,CAAC,KAAK,KAAK,oBAAoB;gCAC9B,CAAC,CAAC,mBAA4B;gCAC9B,CAAC,CAAC,KAAK,KAAK,iBAAiB;oCAC3B,CAAC,CAAC,iBAA0B;oCAC5B,CAAC,CAAC,KAAK,KAAK,iBAAiB;wCAC3B,CAAC,CAAC,OAAgB;wCAClB,CAAC,CAAC,SAAkB;oBAChC,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS;wBAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;wBAC3C,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS;wBAChC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;wBAC7C,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvE,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,8BAA8B,CAC5C,OAAmD;IAEnD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,KAAK;SACjB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1D,IAAI,CAAC,EAAE,CAAC;SACR,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA+B;IACvD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,IAAI,CAAC,UAAU;gBAC1B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,SAAS;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;SACc,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAoC;IAEpC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACtD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,IAAI,CAAC,UAAU;gBAC1B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,SAAS;gBACpB,IAAI,EAAE,IAAI,CAAC,IAAI;aACc,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,UAAU,EAAE,IAAI,CAAC,YAAY;gBAC7B,KAAK,EAAE,kBAAkB;gBACzB,KAAK;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,UAAU,EAAE,IAAI,CAAC,YAAY;gBAC7B,KAAK,EAAE,cAAc;gBACrB,KAAK;gBACL,SAAS,EAAE,IAAI,CAAC,KAAK,IAAI,aAAa;aACvC,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,UAAU,EAAE,IAAI,CAAC,YAAY;gBAC7B,KAAK,EAAE,oBAAoB;gBAC3B,KAAK;gBACL,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY,IAAI,CAAC,YAAY,EAAE,EAAE;aACtE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,UAAU,EAAE,IAAI,CAAC,YAAY;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB;YAC/E,KAAK;SACN,CAAC;IACJ,CAAC,CAAuB,CAAC;AAC3B,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/bin/session/recorder/SessionRecorder.d.ts

@@ -0,0 +1,186 @@
+/**
+ * SessionRecorder：Session Message 的唯一持久化与发布入口。
+ *
+ * 完整 Message 与 Assistant 草稿先持久化，成功后再发布实时 Mutation。
+ */
+import type { UIMessage, UIMessageChunk } from "ai";
+import { JsonlSessionMessageStore } from "../../session/recorder/JsonlSessionMessageStore.js";
+import type { JsonObject } from "../../types/common/Json.js";
+import type { ListSessionMessagesInput, SessionActionMessage, SessionAssistantMessage, SessionAssistantMessagePart, SessionErrorMessage, SessionMessage, SessionMessagePage, SessionUserMessage, SessionUserMessagePart } from "../../types/session/SessionMessage.js";
+import type { SessionMutation } from "../../types/session/SessionMutation.js";
+/** SessionRecorder 构造参数。 */
+export interface SessionRecorderOptions {
+    /** 当前 Session 标识。 */
+    session_id: string;
+    /** Message 快照 store。 */
+    store: JsonlSessionMessageStore;
+    /** 持久化成功后的实时 Mutation 发布函数。 */
+    publish: (mutation: SessionMutation) => void;
+}
+/** User Message 创建参数。 */
+export interface AppendSessionUserMessageInput {
+    /** 当前输入所属 turn。 */
+    turn_id: string;
+    /** 普通 prompt 或 steering 输入。 */
+    input_type: "prompt" | "steer";
+    /** User 结构化 parts。 */
+    parts: SessionUserMessagePart[];
+    /** 可选指定 Message ID，通常由 Recorder 生成。 */
+    message_id?: string;
+    /** 默认展示范围。 */
+    visibility?: "visible" | "internal";
+}
+/** Assistant Message 创建参数。 */
+export interface OpenSessionAssistantMessageInput {
+    /** 当前 assistant 所属 turn。 */
+    turn_id: string;
+    /** 当前 assistant 在 turn 内的 segment 序号。 */
+    segment_index: number;
+    /** 普通 assistant 或 compact summary。 */
+    kind?: "normal" | "summary";
+    /** 默认展示范围。 */
+    visibility?: "visible" | "internal";
+    /** 可选指定 Message ID。 */
+    message_id?: string;
+    /** Summary 已覆盖到的来源 Message。 */
+    summary_through_message_id?: string;
+}
+/** 已完成 Assistant Message 直接写入参数。 */
+export interface AppendCompletedAssistantMessageInput {
+    /** Assistant 所属 turn。 */
+    turn_id?: string;
+    /** Assistant 完整 parts。 */
+    parts: SessionAssistantMessagePart[];
+    /** 普通 assistant 或 compact summary。 */
+    kind?: "normal" | "summary";
+    /** 默认展示范围。 */
+    visibility?: "visible" | "internal";
+    /** Summary 已覆盖到的来源 Message。 */
+    summary_through_message_id?: string;
+}
+/** Action Message 创建参数。 */
+export interface OpenSessionActionMessageInput {
+    /** 可选稳定 Message ID；业务 action 生命周期使用该值定位。 */
+    message_id?: string;
+    /** Action 所属 turn。 */
+    turn_id?: string;
+    /** Action 业务类型。 */
+    action_type: string;
+    /** Action 标题。 */
+    title: string;
+    /** Action 描述。 */
+    description?: string;
+    /** Action 附加数据。 */
+    data?: JsonObject;
+}
+/** Error Message 创建参数。 */
+export interface AppendSessionErrorMessageInput {
+    /** 错误影响范围。 */
+    scope: "session" | "turn";
+    /** 错误所属 turn。 */
+    turn_id?: string;
+    /** 稳定错误码。 */
+    code: string;
+    /** 用户可见错误文本。 */
+    message: string;
+    /** 是否允许恢复。 */
+    recoverable: boolean;
+}
+/** 唯一 Session Message 写入服务。 */
+export declare class SessionRecorder {
+    readonly session_id: string;
+    private readonly store;
+    private readonly publish;
+    private readonly messages_by_id;
+    private initialized;
+    constructor(options: SessionRecorderOptions);
+    /** 恢复已有 Message，并收口进程中断遗留的运行状态。 */
+    initialize(): Promise<void>;
+    /** 同步读取当前内存 Message。 */
+    get_message(message_id: string): SessionMessage | undefined;
+    /** 追加普通 prompt 或 steering User Message。 */
+    append_user_message(input: AppendSessionUserMessageInput): Promise<SessionUserMessage>;
+    /** 创建可持续接收 chunk 的 Assistant segment。 */
+    open_assistant_message(input: OpenSessionAssistantMessageInput): Promise<SessionAssistantMessageWriter>;
+    /** 直接写入一条已完成 Assistant Message。 */
+    append_completed_assistant_message(input: AppendCompletedAssistantMessageInput): Promise<SessionAssistantMessage>;
+    /** 创建 running Action Message。 */
+    open_action_message(input: OpenSessionActionMessageInput): Promise<SessionActionMessageWriter>;
+    /** 更新 Action 状态，同时保持 message_id 与 sequence 不变。 */
+    update_action_message(message_id: string, status: "running" | "completed" | "failed", changes?: {
+        title?: string;
+        description?: string;
+        data?: JsonObject;
+    }): Promise<SessionActionMessage>;
+    /** 创建用户可见 Error Message。 */
+    append_error_message(input: AppendSessionErrorMessageInput): Promise<SessionErrorMessage>;
+    /** 读取折叠后的 Message snapshot。 */
+    list_messages(input?: ListSessionMessagesInput): Promise<SessionMessagePage>;
+    /** 向当前 Session 导入 fork 来源 Message，并重新分配全部身份和顺序。 */
+    import_messages(messages: SessionMessage[]): Promise<void>;
+    /** @internal 写入 Assistant 原始文本 delta。 */
+    append_assistant_delta(message_id: string, part_id: string, type: "text" | "reasoning", delta: string): Promise<void>;
+    /** @internal 写入 Assistant 完整 part。 */
+    update_assistant_part(message_id: string, part: SessionAssistantMessagePart): Promise<void>;
+    /** @internal 收口 Assistant Message。 */
+    complete_assistant_message(message_id: string, status: "completed" | "stopped" | "failed"): Promise<void>;
+    /** @internal 将 Shell Runtime 审批请求更新到当前 Tool Part。 */
+    require_tool_approval(input: {
+        tool_call_id: string;
+        approval_id: string;
+    }): Promise<void>;
+    /** @internal 将审批结果更新到当前 Tool Part。 */
+    resolve_tool_approval(input: {
+        tool_call_id: string;
+        approval_id: string;
+        decision: "approved" | "denied" | "expired";
+    }): Promise<void>;
+    private create_message;
+    private find_streaming_tool;
+    private build_message_mutation;
+    private accept_message;
+    private accept_mutation;
+    private ensure_initialized;
+}
+/** 单个 Assistant segment 的流式 writer。 */
+export declare class SessionAssistantMessageWriter {
+    readonly message_id: string;
+    private readonly recorder;
+    private closed;
+    constructor(recorder: SessionRecorder, message_id: string);
+    /** 应用一个原始 AI SDK UI chunk。 */
+    apply_chunk(chunk: UIMessageChunk): Promise<void>;
+    /** 写入一个完整 Assistant part。 */
+    upsert_part(part: SessionAssistantMessagePart): Promise<void>;
+    /** 当前实现逐 chunk 等待落盘，因此 flush 在返回时天然完成。 */
+    flush(): Promise<void>;
+    /** 正常完成当前 assistant segment。 */
+    complete(): Promise<void>;
+    /** 停止当前 assistant segment，并保留已有 parts。 */
+    stop(): Promise<void>;
+    /** 以失败状态关闭当前 assistant segment。 */
+    fail(_error: unknown): Promise<void>;
+    private current_message;
+    private find_tool;
+    private next_part_sequence;
+    private upsert_tool;
+    private close;
+}
+/** 单个 Action Message 的生命周期 writer。 */
+export declare class SessionActionMessageWriter {
+    readonly message_id: string;
+    private readonly recorder;
+    private closed;
+    constructor(recorder: SessionRecorder, message_id: string);
+    /** 把 Action 更新为 completed。 */
+    complete(input?: {
+        title?: string;
+        description?: string;
+        data?: JsonObject;
+    }): Promise<void>;
+    /** 把 Action 更新为 failed。 */
+    fail(error: unknown): Promise<void>;
+}
+/** 把 AI SDK User parts 归一为 canonical User parts。 */
+export declare function normalize_session_user_parts(parts: UIMessage["parts"] | null | undefined): SessionUserMessagePart[];
+//# sourceMappingURL=SessionRecorder.d.ts.map

package/bin/session/recorder/SessionRecorder.d.ts.map

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