@downcity/agent 1.1.217 → 1.1.222

package/bin/session/recorder/JsonlSessionMessageStore.js

@@ -0,0 +1,127 @@
+/**
+ * 基于单一 messages.jsonl 的 SessionMessage mutation store。
+ *
+ * 文件中每行是一条完整 mutation。消息快照通过 reducer 重放得到，不维护第二份文件。
+ */
+import fs from "fs-extra";
+import { open, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { generateId } from "../../utils/Id.js";
+import { reduce_session_messages } from "../../session/recorder/SessionMessageReducer.js";
+/** 单一 JSONL mutation store。 */
+export class JsonlSessionMessageStore {
+    session_id;
+    messages_file_path;
+    lock_file_path;
+    constructor(options) {
+        this.session_id = String(options.session_id || "").trim();
+        this.messages_file_path = path.resolve(options.file_path);
+        this.lock_file_path = `${this.messages_file_path}.lock`;
+        if (!this.session_id) {
+            throw new Error("JsonlSessionMessageStore requires session_id");
+        }
+    }
+    /** 创建空文件并校验已有 Mutation 可重放。 */
+    async initialize() {
+        await this.ensure_layout();
+        reduce_session_messages(await this.read_mutations_unsafe());
+    }
+    /** 读取全部合法 mutation；损坏行会带行号抛错，避免静默产生错误历史。 */
+    async list_mutations() {
+        await this.ensure_layout();
+        return await this.read_mutations_unsafe();
+    }
+    /** 重放全部 mutation，得到当前 canonical 消息列表。 */
+    async list_messages() {
+        return reduce_session_messages(await this.list_mutations());
+    }
+    /**
+     * 在跨进程文件锁内计算并追加 mutation。
+     * 发布动作必须由调用方在此 Promise 成功后执行。
+     */
+    async commit(build_mutation) {
+        return await this.with_write_lock(async () => {
+            const mutations = await this.read_mutations_unsafe();
+            const messages = reduce_session_messages(mutations);
+            const mutation = build_mutation({
+                commit_sequence: (mutations[mutations.length - 1]?.commit_sequence || 0) + 1,
+                message_sequence: messages.reduce((value, message) => Math.max(value, message.sequence + 1), 1),
+                messages,
+            });
+            await fs.appendFile(this.messages_file_path, `${JSON.stringify(mutation)}\n`, "utf8");
+            return mutation;
+        });
+    }
+    async ensure_layout() {
+        await fs.ensureDir(path.dirname(this.messages_file_path));
+        await fs.ensureFile(this.messages_file_path);
+    }
+    async read_mutations_unsafe() {
+        const raw = await fs.readFile(this.messages_file_path, "utf8").catch(() => "");
+        const mutations = [];
+        const lines = raw.split("\n");
+        for (let index = 0; index < lines.length; index += 1) {
+            const line = lines[index]?.trim();
+            if (!line)
+                continue;
+            try {
+                const mutation = JSON.parse(line);
+                if (mutation.session_id !== this.session_id) {
+                    throw new Error("session_id mismatch");
+                }
+                mutations.push(mutation);
+            }
+            catch (error) {
+                throw new Error(`Invalid session mutation at line ${String(index + 1)}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return mutations;
+    }
+    async with_write_lock(callback) {
+        await this.ensure_layout();
+        const token = `${process.pid}:${Date.now()}:${generateId()}`;
+        const stale_ms = 30_000;
+        const started_at = Date.now();
+        while (true) {
+            try {
+                const file = await open(this.lock_file_path, "wx");
+                await file.writeFile(token, "utf8");
+                await file.close();
+                break;
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== "EEXIST")
+                    throw error;
+                try {
+                    const lock_stat = await stat(this.lock_file_path);
+                    if (Date.now() - lock_stat.mtimeMs > stale_ms) {
+                        await fs.remove(this.lock_file_path);
+                        continue;
+                    }
+                }
+                catch {
+                    continue;
+                }
+                if (Date.now() - started_at > stale_ms * 2) {
+                    throw new Error(`Session message lock timeout: ${this.lock_file_path}`);
+                }
+                await new Promise((resolve) => setTimeout(resolve, 40));
+            }
+        }
+        try {
+            return await callback();
+        }
+        finally {
+            try {
+                if ((await readFile(this.lock_file_path, "utf8")).trim() === token) {
+                    await fs.remove(this.lock_file_path);
+                }
+            }
+            catch {
+                // 锁文件已被清理时无需额外处理。
+            }
+        }
+    }
+}
+//# sourceMappingURL=JsonlSessionMessageStore.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * SessionMessage 与 AI SDK UIMessage 的内部投影转换。
+ *
+ * 关键点（中文）
+ * - SessionMessage 是唯一持久化事实；UIMessage 只在 Executor/Composer 边界临时构造。
+ * - action/error 不转换为模型消息。
+ * - part_id 只服务 Session Message identity，不传入模型协议。
+ */
+import type { UIMessage } from "ai";
+import type { SessionAssistantMessage, SessionAssistantMessagePart, SessionMessage, SessionUserMessagePart } from "../../types/session/SessionMessage.js";
+import type { SessionMessageRecordV1 } from "../../executor/types/SessionRecords.js";
+/** 把 Session Message 投影成 Executor 可消费的 UIMessage。 */
+export declare function to_executor_ui_message(message: SessionMessage): SessionMessageRecordV1 | null;
+/** 把 AI SDK user parts 转换成可持久化 Session parts。 */
+export declare function from_ui_user_parts(parts: UIMessage["parts"] | null | undefined): SessionUserMessagePart[];
+/** 把最终 AI SDK assistant parts 转换成 Session parts。 */
+export declare function from_ui_assistant_parts(parts: UIMessage["parts"] | null | undefined): SessionAssistantMessagePart[];
+/** 提取 Assistant Message 的最终可见文本。 */
+export declare function extract_session_assistant_text(message: SessionAssistantMessage | null | undefined): string;
+//# sourceMappingURL=SessionMessageCodec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMessageCodec.d.ts","sourceRoot":"","sources":["../../../src/session/recorder/SessionMessageCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,cAAc,EAEd,sBAAsB,EACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,oCAAoC,CAAC;AAE5C,qDAAqD;AACrD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,GACtB,sBAAsB,GAAG,IAAI,CAmC/B;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC3C,sBAAsB,EAAE,CAgC1B;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC3C,2BAA2B,EAAE,CAsD/B;AAED,oCAAoC;AACpC,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAClD,MAAM,CAMR"}

package/bin/session/recorder/SessionMessageCodec.js

@@ -0,0 +1,252 @@
+/**
+ * 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}`,
+                    type: type,
+                    text: String(candidate.text || ""),
+                    state: "done",
+                }];
+        }
+        if (type === "file") {
+            return [{
+                    part_id: `file:${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}`),
+                    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"
+                                    : "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":"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"}

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

@@ -0,0 +1,12 @@
+/**
+ * Session Message Mutation reducer。
+ *
+ * 历史重放与实时消费者共享 message、part、delta 三种归并语义。
+ */
+import type { SessionMessage } from "../../types/session/SessionMessage.js";
+import type { SessionMessageMutation } from "../../types/session/SessionMessageMutation.js";
+/** 将单条 Mutation 应用到已有 Message。 */
+export declare function reduce_session_message(current_message: SessionMessage | undefined, mutation: SessionMessageMutation): SessionMessage;
+/** 按 commit_sequence 重放 Mutation，恢复线性 Message snapshot。 */
+export declare function reduce_session_messages(mutations: SessionMessageMutation[]): SessionMessage[];
+//# sourceMappingURL=SessionMessageReducer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMessageReducer.d.ts","sourceRoot":"","sources":["../../../src/session/recorder/SessionMessageReducer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA2B,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACjG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAExF,kCAAkC;AAClC,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,cAAc,GAAG,SAAS,EAC3C,QAAQ,EAAE,sBAAsB,GAC/B,cAAc,CAkDhB;AAED,2DAA2D;AAC3D,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,sBAAsB,EAAE,GAClC,cAAc,EAAE,CAmBlB"}

package/bin/session/recorder/SessionMessageReducer.js

@@ -0,0 +1,109 @@
+/**
+ * Session Message Mutation reducer。
+ *
+ * 历史重放与实时消费者共享 message、part、delta 三种归并语义。
+ */
+/** 将单条 Mutation 应用到已有 Message。 */
+export function reduce_session_message(current_message, mutation) {
+    if (mutation.variant === "message") {
+        validate_message_snapshot(current_message, mutation);
+        return structuredClone(mutation.message);
+    }
+    if (!current_message) {
+        throw new Error(`Session Message does not exist: ${mutation.message_id}`);
+    }
+    validate_next_revision(current_message, mutation);
+    const assistant = require_streaming_assistant(current_message);
+    if (mutation.variant === "part") {
+        if (mutation.part.part_id !== mutation.part_id) {
+            throw new Error(`Part Mutation identity mismatch: ${mutation.part_id}`);
+        }
+        if (mutation.part.type !== mutation.type) {
+            throw new Error(`Part Mutation type mismatch: ${mutation.part_id}`);
+        }
+        const exists = assistant.parts.some((part) => part.part_id === mutation.part_id);
+        const parts = exists
+            ? assistant.parts.map((part) => part.part_id === mutation.part_id
+                ? structuredClone(mutation.part)
+                : part)
+            : [...assistant.parts, structuredClone(mutation.part)];
+        return with_revision(assistant, mutation, { parts });
+    }
+    const existing_part = assistant.parts.find((part) => part.part_id === mutation.part_id);
+    if (!existing_part ||
+        (existing_part.type !== "text" && existing_part.type !== "reasoning")) {
+        throw new Error(`Delta target Part does not exist: ${mutation.part_id}`);
+    }
+    if (existing_part.type !== mutation.type) {
+        throw new Error(`Delta type changed for Part: ${mutation.part_id}`);
+    }
+    const parts = assistant.parts.map((part) => part.part_id === mutation.part_id &&
+        (part.type === "text" || part.type === "reasoning")
+        ? { ...part, text: part.text + mutation.delta }
+        : part);
+    return with_revision(assistant, mutation, { parts });
+}
+/** 按 commit_sequence 重放 Mutation，恢复线性 Message snapshot。 */
+export function reduce_session_messages(mutations) {
+    const messages = new Map();
+    const ordered = [...mutations].sort((left, right) => left.commit_sequence - right.commit_sequence);
+    let previous_commit_sequence = 0;
+    for (const mutation of ordered) {
+        if (mutation.commit_sequence <= previous_commit_sequence) {
+            throw new Error(`Duplicate commit_sequence: ${String(mutation.commit_sequence)}`);
+        }
+        messages.set(mutation.message_id, reduce_session_message(messages.get(mutation.message_id), mutation));
+        previous_commit_sequence = mutation.commit_sequence;
+    }
+    return [...messages.values()].sort((left, right) => left.sequence - right.sequence);
+}
+function validate_message_snapshot(current_message, mutation) {
+    if (mutation.message.message_id !== mutation.message_id) {
+        throw new Error(`Message Mutation identity mismatch: ${mutation.message_id}`);
+    }
+    if (mutation.message.type !== mutation.type) {
+        throw new Error(`Message Mutation type mismatch: ${mutation.message_id}`);
+    }
+    if (mutation.message.sequence !== mutation.sequence) {
+        throw new Error(`Message Mutation sequence mismatch: ${mutation.message_id}`);
+    }
+    if (mutation.message.revision !== mutation.revision) {
+        throw new Error(`Message Mutation revision mismatch: ${mutation.message_id}`);
+    }
+    if (!current_message) {
+        if (mutation.revision !== 1) {
+            throw new Error(`New Message revision must be 1: ${mutation.message_id}`);
+        }
+        return;
+    }
+    validate_next_revision(current_message, mutation);
+    if (current_message.type !== mutation.type) {
+        throw new Error(`Message type changed: ${mutation.message_id}`);
+    }
+    if (current_message.sequence !== mutation.sequence) {
+        throw new Error(`Message sequence changed: ${mutation.message_id}`);
+    }
+}
+function validate_next_revision(current_message, mutation) {
+    if (mutation.revision !== current_message.revision + 1) {
+        throw new Error(`Invalid Message revision for ${mutation.message_id}: expected ${String(current_message.revision + 1)}, received ${String(mutation.revision)}`);
+    }
+}
+function require_streaming_assistant(message) {
+    if (message.type !== "assistant") {
+        throw new Error(`Session Message is not assistant: ${message.message_id}`);
+    }
+    if (message.status !== "streaming") {
+        throw new Error(`Assistant Message is already closed: ${message.message_id}`);
+    }
+    return message;
+}
+function with_revision(message, mutation, changes) {
+    return {
+        ...message,
+        ...changes,
+        revision: mutation.revision,
+        updated_at: mutation.created_at,
+    };
+}
+//# sourceMappingURL=SessionMessageReducer.js.map

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

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