@downcity/agent 1.1.216 → 1.1.222

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

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

@@ -0,0 +1,177 @@
+/**
+ * SessionRecorder：Session Message 的唯一持久化与发布入口。
+ *
+ * Mutation 先写入单一 messages.jsonl，成功后更新内存 snapshot，最后发布同一个对象。
+ */
+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 { ListSessionMessageChangesInput, SessionMessageMutation, SessionMessageMutationPage, SessionMessageMutationSubscriber, SessionMessageMutationUnsubscribe } from "../../types/session/SessionMessageMutation.js";
+/** SessionRecorder 构造参数。 */
+export interface SessionRecorderOptions {
+    /** 当前 Session 标识。 */
+    session_id: string;
+    /** 单一 JSONL Mutation store。 */
+    store: JsonlSessionMessageStore;
+    /** Mutation 成功提交后的发布函数。 */
+    publish: (mutation: SessionMessageMutation) => 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 subscribers;
+    private readonly messages_by_id;
+    private initialized;
+    constructor(options: SessionRecorderOptions);
+    /** 重放已有 Mutation，并收口进程中断遗留的运行状态。 */
+    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>;
+    /** 从指定 commit_sequence 增量读取 Mutation。 */
+    list_message_changes(input: ListSessionMessageChangesInput): Promise<SessionMessageMutationPage>;
+    /** 订阅已成功持久化的未来 Mutation。 */
+    subscribe(subscriber: SessionMessageMutationSubscriber): SessionMessageMutationUnsubscribe;
+    /** 向当前 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>;
+    private create_message;
+    private build_message_mutation;
+    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 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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"}