@my-life-buddies/buddy-runtime 0.0.2 → 0.1.0

package/dist/conversation/mlbMessageAgentMessageConverter.js

@@ -0,0 +1,224 @@
+// MLBMessage 与 AgentMessage 之间的换算，正反两个方向。只管形状换算，不碰网络、不碰 Agent、不管游标和幂等键。
+// MLBMessage → AgentMessage：GET /internal/v1/messages 拉回来的记录换成 Agent 历史（重建历史、交给回合都用它）。
+// AgentMessage → MLBMessage：pi 跑出来的 assistant / toolResult / note 换成 POST /internal/v1/messages 的每条 body。
+// 每次请求模型前 AgentMessage → LLMMessage 那一步在 agentMessageLLMMessageConverter.ts。
+import { DATA_ACCESS_TOOL_NAME, SENSITIVE_RUN_TOOL_SUMMARY, dataAccessSummary, isDataAccessDetails } from "../tools/dataAccess.js";
+/** 工具结果没回来（回合被中断）时，写给模型和平台的占位文本 */
+const MISSING_TOOL_RESULT = "（工具结果未返回：回合被中断）";
+/** system 记录换成 user 消息时加在正文前的说明 */
+const SYSTEM_EVENT_PREFIX = "（群里发生了一件事）";
+/** 转发卡最多展开几层，再深的一层写成一句省略 */
+const CARD_MAX_DEPTH = 3;
+const CARD_TOO_DEEP = "（更深的转发略）";
+/** 重建出来的 thinking 块用的签名：pi 的 openai-completions 回放时按它把推理原文写回 reasoning_content 字段 */
+const THINKING_SIGNATURE = "reasoning_content";
+/** 重建的 assistant 消息没有真实用量，全零；形状照 pi-agent-core 的 EMPTY_USAGE */
+function emptyUsage() {
+    return {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        totalTokens: 0,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+    };
+}
+// —— MLBMessage → AgentMessage
+/**
+ * 把一批平台记录换成 pi 的历史。跳过的：interrupted 的半截话、question / widget、空正文又没工具调用的搭子记录。
+ * 对方的 message 变 user（群里带成员前缀）、system 变 user（带「群里发生了一件事」）、messagesCard 拍平成 user、
+ * 平台的场合交代 context 原样变 user（开头自带「平台交代给你的情况」那句用法，不套前缀）；
+ * 搭子的 message / checkin 变 assistant，tool 变 assistant + 每个调用一条 toolResult，note 变 note。
+ */
+export function mlbMessagesToAgentMessages(records, identity) {
+    const out = [];
+    for (const record of records) {
+        if (record.interrupted)
+            continue;
+        const text = record.text ?? "";
+        switch (record.type) {
+            case "system":
+                out.push(buildUserMessage(SYSTEM_EVENT_PREFIX + text, record.timestamp));
+                break;
+            case "context":
+                if (text)
+                    out.push(buildUserMessage(text, record.timestamp));
+                break;
+            case "messagesCard":
+                if (record.messagesCard)
+                    out.push(buildUserMessage(flattenCard(record.messagesCard, 1).join("\n"), record.timestamp));
+                break;
+            case "message":
+            case "checkin":
+                if (record.author === "buddy") {
+                    if (text)
+                        out.push(buildAssistantMessage(record, [...thinkingBlocks(record.thinking), { type: "text", text }], "stop", identity));
+                }
+                else if (record.type === "message" && text) {
+                    out.push(buildUserMessage(memberPrefix(record) + text, record.timestamp));
+                }
+                break;
+            case "tool":
+                if (record.author === "buddy")
+                    out.push(...toolMLBMessageToAgentMessages(record, text, identity));
+                break;
+            case "note":
+                if (record.author === "buddy" && text)
+                    out.push({ role: "note", text, timestamp: record.timestamp });
+                break;
+            default:
+                // question / widget 和别的类型：模型不需要
+                break;
+        }
+    }
+    return out;
+}
+/** 搭子的 tool 记录：一条带 toolCall 块的 assistant，后面每个调用跟一条 toolResult */
+function toolMLBMessageToAgentMessages(record, text, identity) {
+    const calls = record.toolCalls ?? [];
+    if (!text && calls.length === 0)
+        return [];
+    const content = [...thinkingBlocks(record.thinking)];
+    if (text)
+        content.push({ type: "text", text });
+    for (const call of calls)
+        content.push({ type: "toolCall", id: call.callId, name: call.name, arguments: argumentsOf(call) });
+    const assistant = buildAssistantMessage(record, content, calls.length > 0 ? "toolUse" : "stop", identity);
+    const results = calls.map((call) => ({
+        role: "toolResult",
+        toolCallId: call.callId,
+        toolName: call.name,
+        content: [{ type: "text", text: call.result ?? MISSING_TOOL_RESULT }],
+        isError: call.result === undefined,
+        timestamp: record.timestamp,
+    }));
+    return [assistant, ...results];
+}
+function buildAssistantMessage(record, content, stopReason, identity) {
+    return {
+        role: "assistant",
+        content,
+        api: identity.api,
+        provider: identity.provider,
+        model: identity.model,
+        usage: emptyUsage(),
+        stopReason,
+        timestamp: record.timestamp,
+    };
+}
+function buildUserMessage(text, timestamp) {
+    return { role: "user", content: [{ type: "text", text }], timestamp };
+}
+/** 有推理原文才放 thinking 块，没有就一个不放 */
+function thinkingBlocks(thinking) {
+    return thinking ? [{ type: "thinking", thinking, thinkingSignature: THINKING_SIGNATURE }] : [];
+}
+/** pi 的 toolCall 块要 arguments 是对象；平台存的不是对象就当空参数 */
+function argumentsOf(call) {
+    const value = call.arguments;
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+/** 群成员说的话前面标谁说的：有成员号写 `[名字 #m_…] `，没成员号只写 `[名字] `；私聊没名字不标 */
+function memberPrefix(record) {
+    const name = record.name;
+    const memberId = record.memberId;
+    if (name && memberId)
+        return `[${name} #${memberId}] `;
+    if (name)
+        return `[${name}] `;
+    if (memberId)
+        return `[#${memberId}] `;
+    return "";
+}
+/** 转发卡拍平成行：每条先一行 `【名字】`，正文原样跟一行；嵌套卡接着展开，超过层数上限写一句省略 */
+function flattenCard(card, depth) {
+    const lines = [];
+    for (const item of card.items ?? []) {
+        lines.push(`【${item.name ?? ""}】`);
+        if (item.text)
+            lines.push(item.text);
+        if (item.messagesCard) {
+            if (depth >= CARD_MAX_DEPTH)
+                lines.push(CARD_TOO_DEEP);
+            else
+                lines.push(...flattenCard(item.messagesCard, depth + 1));
+        }
+    }
+    return lines;
+}
+// —— AgentMessage → MLBMessage（POST /internal/v1/messages 的每条 body）
+/**
+ * 不带工具调用的 assistant 消息写成 message 记录。
+ * 正常收尾的照写（带 thinking）；error / aborted 收尾但已经说了半截的写成 interrupted；其余不写。
+ */
+export function assistantMessageToMLBMessage(m, omitThinking = false) {
+    if (m.content.some((block) => block.type === "toolCall"))
+        return null;
+    const text = textOf(m);
+    if (m.stopReason === "error" || m.stopReason === "aborted") {
+        return text ? { type: "message", text, interrupted: true } : null;
+    }
+    const thinking = omitThinking ? undefined : thinkingOf(m);
+    return thinking === undefined ? { type: "message", text } : { type: "message", text, thinking };
+}
+/**
+ * 带工具调用的 assistant 消息连同它的结果写成一条 tool 记录；每个调用的 summary 取工具的 label，没有 label 用名字。
+ * 没有工具调用的返回 null（那种走 assistantMessageToMLBMessage）。
+ */
+export function toolStepToMLBMessage(m, toolResults, tools, dataAccessDetailsOf, sensitiveRun = false) {
+    const calls = m.content.filter((block) => block.type === "toolCall");
+    if (calls.length === 0)
+        return null;
+    const toolCalls = calls.map((call) => {
+        const result = toolResults.find((r) => r.toolCallId === call.id);
+        const label = tools.find((t) => t.name === call.name)?.label;
+        return {
+            callId: call.id,
+            name: call.name,
+            summary: label || call.name,
+            arguments: sensitiveRun ? undefined : call.arguments,
+            result: result === undefined
+                ? MISSING_TOOL_RESULT
+                : toolResultTextToWrite(call.name, result, dataAccessDetailsOf?.(call.id), sensitiveRun),
+        };
+    });
+    const thinking = sensitiveRun ? undefined : thinkingOf(m);
+    const record = { type: "tool", text: sensitiveRun ? "" : textOf(m), toolCalls };
+    if (thinking !== undefined)
+        record.thinking = thinking;
+    return record;
+}
+/** DataAccess 的真实 Tool 结果只给当前模型回合看；写平台时只留 Dataset ID 与状态。 */
+function toolResultTextToWrite(toolName, result, trackedDetails, sensitiveRun) {
+    const details = trackedDetails ?? result.details;
+    if (toolName === DATA_ACCESS_TOOL_NAME || isDataAccessDetails(details))
+        return dataAccessSummary(details);
+    return sensitiveRun ? SENSITIVE_RUN_TOOL_SUMMARY : resultText(result);
+}
+/** note 消息写成 note 记录 */
+export function noteMessageToMLBMessage(n) {
+    return { type: "note", text: n.text };
+}
+/** assistant 消息里所有 thinking 块的推理原文拼起来；一个字都没有返回 undefined */
+export function thinkingOf(m) {
+    const thinking = m.content
+        .filter((block) => block.type === "thinking")
+        .map((block) => block.thinking)
+        .join("");
+    return thinking === "" ? undefined : thinking;
+}
+/** assistant 消息里所有 text 块的正文拼起来 */
+export function textOf(m) {
+    return m.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("");
+}
+/** 工具结果的文本：多个 text 块用换行接起来（跟 pi 的 openai-completions 回放时一样） */
+function resultText(result) {
+    return result.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("\n");
+}
+//# sourceMappingURL=mlbMessageAgentMessageConverter.js.map

package/dist/conversation/mlbMessageAgentMessageConverter.js.map

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

package/dist/conversation/readMLBMessages.d.ts

@@ -0,0 +1,29 @@
+import type { MLBClient } from "../mlbClient.ts";
+import type { BuddyLogger, MLBMessage } from "../types.ts";
+export interface ReadMLBMessagesDeps {
+    client: MLBClient;
+    key: string;
+    log: BuddyLogger;
+    /** 一次拉取拉到的消息，按消息时间升序：第一次是这场会话的全部，之后只有比上一批晚的，可能是空批 */
+    onMessages: (messages: MLBMessage[]) => Promise<void>;
+}
+export declare class ReadMLBMessages {
+    private readonly deps;
+    /** 拉取串行链：notify 只往链尾排，绝不并发拉 */
+    private chain;
+    private retry;
+    private retryDelay;
+    /** 读方向游标：已经拉到的最晚一条的消息时间。别人的消息按到达平台的时刻记、只会越来越晚，拿它往后拉不会漏 */
+    private pulledTimestamp;
+    private closed;
+    constructor(deps: ReadMLBMessagesDeps);
+    /** 有新消息了：把一次拉取排进串行链，取消正在等的重试。退役后忽略 */
+    notify(): void;
+    /** 退役：取消重试，之后不再拉，已经在拉的拉完也不交出去 */
+    close(): void;
+    /** 一次拉取：从游标往后翻到不满页，整批里比游标晚的交给 onMessages。网络错误排一次重试就返回，这批不交 */
+    private read;
+    private scheduleRetry;
+    private cancelRetry;
+}
+//# sourceMappingURL=readMLBMessages.d.ts.map

package/dist/conversation/readMLBMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readMLBMessages.d.ts","sourceRoot":"","sources":["../../src/conversation/readMLBMessages.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO3D,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,WAAW,CAAC;IACjB,qDAAqD;IACrD,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,UAAU,CAAqB;IACvC,0DAA0D;IAC1D,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,mBAAmB;IAIrC,sCAAsC;IACtC,MAAM,IAAI,IAAI;IAQd,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAKb,8DAA8D;YAChD,IAAI;IAyBlB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,WAAW;CAKnB"}

package/dist/conversation/readMLBMessages.js

@@ -0,0 +1,86 @@
+// 一场会话从平台拉消息：同会话串行地拉、从哪拉起、拉失败了怎么办。
+// 管：拉取串行链（notify 只往链尾排，绝不并发拉）；读方向游标（已经拉到的最晚一条的消息时间）；
+//     GET /internal/v1/messages 从游标往后翻页到不满页，整批里比游标晚的交给 onMessages，游标推到这批里最晚的消息时间；
+//     网络错误主动退避重试（1 秒起步、翻倍、封顶 30 秒），新的 notify 取消等待立即重拉；退役后不再拉。
+// 不管：拉到的消息怎么处理（index.ts：第一批重建历史，之后的交给回合）、HTTP 请求本身（mlbClient.ts）。
+import { errorText } from "../log.js";
+/** 每页拉多少条：平台钳在 1..200，翻页靠不满页 */
+const PULL_LIMIT = 200;
+const PULL_RETRY_MIN_MS = 1_000;
+const PULL_RETRY_MAX_MS = 30_000;
+export class ReadMLBMessages {
+    deps;
+    /** 拉取串行链：notify 只往链尾排，绝不并发拉 */
+    chain = Promise.resolve();
+    retry;
+    retryDelay = PULL_RETRY_MIN_MS;
+    /** 读方向游标：已经拉到的最晚一条的消息时间。别人的消息按到达平台的时刻记、只会越来越晚，拿它往后拉不会漏 */
+    pulledTimestamp = 0;
+    closed = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 有新消息了：把一次拉取排进串行链，取消正在等的重试。退役后忽略 */
+    notify() {
+        if (this.closed)
+            return;
+        this.cancelRetry();
+        this.chain = this.chain
+            .then(() => this.read())
+            .catch((e) => this.deps.log.warn("处理拉取结果出错", { convoKey: this.deps.key, error: errorText(e) }));
+    }
+    /** 退役：取消重试，之后不再拉，已经在拉的拉完也不交出去 */
+    close() {
+        this.closed = true;
+        this.cancelRetry();
+    }
+    /** 一次拉取：从游标往后翻到不满页，整批里比游标晚的交给 onMessages。网络错误排一次重试就返回，这批不交 */
+    async read() {
+        if (this.closed)
+            return;
+        const batch = [];
+        let after = this.pulledTimestamp;
+        for (;;) {
+            let page;
+            try {
+                page = await this.deps.client.pullMessages(this.deps.key, after, PULL_LIMIT);
+            }
+            catch (e) {
+                this.deps.log.warn("拉消息失败，稍后主动重试", { convoKey: this.deps.key, after, delayMs: this.retryDelay, error: errorText(e) });
+                this.scheduleRetry();
+                return;
+            }
+            this.cancelRetry();
+            if (this.closed)
+                return;
+            batch.push(...page.messages);
+            if (page.messages.length < PULL_LIMIT)
+                break;
+            after = page.messages[page.messages.length - 1].timestamp;
+        }
+        this.retryDelay = PULL_RETRY_MIN_MS;
+        const fresh = batch.filter((m) => m.timestamp > this.pulledTimestamp);
+        for (const m of fresh)
+            if (m.timestamp > this.pulledTimestamp)
+                this.pulledTimestamp = m.timestamp;
+        await this.deps.onMessages(fresh);
+    }
+    scheduleRetry() {
+        if (this.closed || this.retry !== undefined)
+            return;
+        const delay = this.retryDelay;
+        this.retryDelay = Math.min(delay * 2, PULL_RETRY_MAX_MS);
+        this.retry = setTimeout(() => {
+            this.retry = undefined;
+            this.notify();
+        }, delay);
+        this.retry.unref();
+    }
+    cancelRetry() {
+        if (this.retry === undefined)
+            return;
+        clearTimeout(this.retry);
+        this.retry = undefined;
+    }
+}
+//# sourceMappingURL=readMLBMessages.js.map

package/dist/conversation/readMLBMessages.js.map

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

package/dist/conversation/writeMLBMessage.d.ts

@@ -0,0 +1,62 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { AssistantMessage, ToolResultMessage } from "@earendil-works/pi-ai";
+import type { MLBClient } from "../mlbClient.ts";
+import type { BuddyLogger, NoteMessage } from "../types.ts";
+export interface WriteMLBMessageDeps {
+    client: MLBClient;
+    key: string;
+    buddyId: string;
+    /** 本进程里这场会话的一次生命周期标识，进幂等键；重启后换一个，旧键不会撞新键 */
+    runId: string;
+    log: BuddyLogger;
+}
+export declare class WriteMLBMessage {
+    private readonly deps;
+    private queue;
+    /** 串行链正在跑：它在跑时队头那项正在发 */
+    private sending;
+    /** 幂等键里的自增号 */
+    private sent;
+    private retryDelay;
+    /** close 时打断重发等待 */
+    private readonly abort;
+    /** 等队列清空的人 */
+    private waiters;
+    private deltaBuffer;
+    private deltaTimer;
+    private closed;
+    constructor(deps: WriteMLBMessageDeps);
+    /** 回合开始 on、收尾 off；工具跑起来时带 status 更新状态行。退役后照收 */
+    replying(data: {
+        on: boolean;
+        status?: string;
+    }): void;
+    /** 正文碎片先攒着，120 毫秒内攒到的一起发 */
+    delta(text: string): void;
+    /** 不带工具调用的 assistant 消息写成 message 记录（mlbMessageAgentMessageConverter.ts 判定不写的不写） */
+    assistant(m: AssistantMessage, omitThinking?: boolean): void;
+    /** 带工具调用的一步连同工具结果写成一条 tool 记录；平台回的时间写在这一步的 assistant 消息上，工具结果跟着它排 */
+    toolStep(m: AssistantMessage, toolResults: ToolResultMessage[], tools: {
+        name: string;
+        label: string;
+    }[], dataAccessDetailsOf: (toolCallId: string) => unknown, sensitiveRun?: boolean): void;
+    /** 运行时补给模型的 note 写成 note 记录 */
+    note(n: NoteMessage): void;
+    /** DataAccess 脱敏把这一轮的消息换成了副本（old → new）：还没写完的，平台回的时间改写到副本上 */
+    retarget(replaced: Map<AgentMessage, AgentMessage>): void;
+    /** 攒着的字发出去，等队列清空（退役后只剩开关要发） */
+    flush(): Promise<void>;
+    /** 退役：攒着的字扔掉，正在退避等重发的立刻醒来；队列里没发的字与写回在串行链上丢掉，开关照发 */
+    close(): void;
+    /** 入队即分配幂等键；先把攒着的字发掉，字排在写回前面。退役后不收 */
+    private write;
+    /** 攒下的碎片立刻排进队列；队尾正好是一帧还没发的 delta 就并进去（写回在重发时，后面的字攒成一帧） */
+    private flushDelta;
+    private enqueue;
+    /** 串行链：一次发队头一项，发完（或退役丢掉）才出队；写回遇到网络错误留在队头，退避后带同一个键重发 */
+    private drain;
+    /** 写一条：delivered → 平台回的时间写进内存那条消息；rejected（4xx）→ warn；都算发完回 true。throw（网络 / 5xx）→ 退避后回 false，留队重发 */
+    private send;
+    private clearTimer;
+}
+//# sourceMappingURL=writeMLBMessage.d.ts.map

package/dist/conversation/writeMLBMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeMLBMessage.d.ts","sourceRoot":"","sources":["../../src/conversation/writeMLBMessage.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAS/E,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,WAAW,CAAC;CACjB;AAQD,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,KAAK,CAAc;IAC3B,yBAAyB;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,eAAe;IACf,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,UAAU,CAAsB;IACxC,oBAAoB;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,cAAc;IACd,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,mBAAmB;IAIrC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKtD,4BAA4B;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWzB,oFAAoF;IACpF,SAAS,CAAC,CAAC,EAAE,gBAAgB,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI;IAK5D,qEAAqE;IACrE,QAAQ,CACP,CAAC,EAAE,gBAAgB,EACnB,WAAW,EAAE,iBAAiB,EAAE,EAChC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,EACxC,mBAAmB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,EACpD,YAAY,CAAC,EAAE,OAAO,GACpB,IAAI;IAKP,+BAA+B;IAC/B,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI;IAI1B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,GAAG,IAAI;IASzD,+BAA+B;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAOb,sCAAsC;IACtC,OAAO,CAAC,KAAK;IAQb,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,OAAO;IAKf,uDAAuD;YACzC,KAAK;IAyBnB,qGAAqG;YACvF,IAAI;IAiClB,OAAO,CAAC,UAAU;CAKlB"}

package/dist/conversation/writeMLBMessage.js

@@ -0,0 +1,212 @@
+// 一场会话往平台发的所有东西排在一条队列里按顺序发：「正在回复」开关与工具状态行、生成中的正文碎片（delta）、写回的消息。
+// 为什么一条队列（REDoc《【技术设计】搭子消息的时间与顺序》）：平台把搭子消息的时间记成它第一个字到达平台的时刻——
+// 上一次写回之后收到的第一段 delta，由下一条模型消息的写回领走。字和写回排在一条队列里，平台收到的先后就是模型出字的先后；
+// 一条写回在重发，后面的字跟着等，领不错。
+// 管：delta 每 120 毫秒攒一帧，写回与开关之前先把攒着的发掉；入参是 pi 消息，mlbMessageAgentMessageConverter.ts 换成写口 body；入队那一刻分配幂等键（之后重发一字不变）；
+//     POST /internal/v1/messages 成功后把平台回的时间写进内存里那条消息的 timestamp（回合收尾按它排）；4xx 丢弃并 warn（平台明确拒绝，重发没用）；
+//     网络错误 / 5xx 留队退避重发（1 秒起步、翻倍、封顶 10 秒）；等队列清空；退役时丢掉没发的字与写回、打断重发等待，开关照发（收尾要把三个圆点熄掉）。
+// 不管：什么时候开关、什么时候写（index.ts 按 Agent 事件调这里）、HTTP 请求本身（mlbClient.ts）。
+import { assistantMessageToMLBMessage, noteMessageToMLBMessage, toolStepToMLBMessage } from "./mlbMessageAgentMessageConverter.js";
+import { errorText } from "../log.js";
+/** 生成中的正文碎片攒多久发一帧 delta */
+const DELTA_THROTTLE_MS = 120;
+/** 写平台遇到网络错误 / 5xx 的重发间隔 */
+const WRITE_RETRY_MIN_MS = 1_000;
+const WRITE_RETRY_MAX_MS = 10_000;
+export class WriteMLBMessage {
+    deps;
+    queue = [];
+    /** 串行链正在跑：它在跑时队头那项正在发 */
+    sending = false;
+    /** 幂等键里的自增号 */
+    sent = 0;
+    retryDelay = WRITE_RETRY_MIN_MS;
+    /** close 时打断重发等待 */
+    abort = new AbortController();
+    /** 等队列清空的人 */
+    waiters = [];
+    deltaBuffer = "";
+    deltaTimer;
+    closed = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 回合开始 on、收尾 off；工具跑起来时带 status 更新状态行。退役后照收 */
+    replying(data) {
+        this.flushDelta();
+        this.enqueue({ kind: "replying", data });
+    }
+    /** 正文碎片先攒着，120 毫秒内攒到的一起发 */
+    delta(text) {
+        if (text === "" || this.closed)
+            return;
+        this.deltaBuffer += text;
+        if (this.deltaTimer === undefined) {
+            this.deltaTimer = setTimeout(() => {
+                this.deltaTimer = undefined;
+                this.flushDelta();
+            }, DELTA_THROTTLE_MS);
+        }
+    }
+    /** 不带工具调用的 assistant 消息写成 message 记录（mlbMessageAgentMessageConverter.ts 判定不写的不写） */
+    assistant(m, omitThinking) {
+        const out = assistantMessageToMLBMessage(m, omitThinking);
+        if (out !== null)
+            this.write(out, m);
+    }
+    /** 带工具调用的一步连同工具结果写成一条 tool 记录；平台回的时间写在这一步的 assistant 消息上，工具结果跟着它排 */
+    toolStep(m, toolResults, tools, dataAccessDetailsOf, sensitiveRun) {
+        const out = toolStepToMLBMessage(m, toolResults, tools, dataAccessDetailsOf, sensitiveRun);
+        if (out !== null)
+            this.write(out, m);
+    }
+    /** 运行时补给模型的 note 写成 note 记录 */
+    note(n) {
+        this.write(noteMessageToMLBMessage(n), n);
+    }
+    /** DataAccess 脱敏把这一轮的消息换成了副本（old → new）：还没写完的，平台回的时间改写到副本上 */
+    retarget(replaced) {
+        if (replaced.size === 0)
+            return;
+        for (const item of this.queue) {
+            if (item.kind !== "write")
+                continue;
+            const next = replaced.get(item.target);
+            if (next !== undefined)
+                item.target = next;
+        }
+    }
+    /** 攒着的字发出去，等队列清空（退役后只剩开关要发） */
+    flush() {
+        this.flushDelta();
+        if (!this.sending && this.queue.length === 0)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            this.waiters.push(resolve);
+        });
+    }
+    /** 退役：攒着的字扔掉，正在退避等重发的立刻醒来；队列里没发的字与写回在串行链上丢掉，开关照发 */
+    close() {
+        this.closed = true;
+        this.abort.abort();
+        this.clearTimer();
+        this.deltaBuffer = "";
+    }
+    /** 入队即分配幂等键；先把攒着的字发掉，字排在写回前面。退役后不收 */
+    write(message, target) {
+        if (this.closed)
+            return;
+        this.flushDelta();
+        this.sent += 1;
+        const idempotencyKey = `buddy:${this.deps.buddyId}:${this.deps.key}:${this.deps.runId}:${this.sent}`;
+        this.enqueue({ kind: "write", message: { ...message, idempotencyKey }, target });
+    }
+    /** 攒下的碎片立刻排进队列；队尾正好是一帧还没发的 delta 就并进去（写回在重发时，后面的字攒成一帧） */
+    flushDelta() {
+        this.clearTimer();
+        const text = this.deltaBuffer;
+        this.deltaBuffer = "";
+        if (text === "" || this.closed)
+            return;
+        const tail = this.queue[this.queue.length - 1];
+        const tailInFlight = this.sending && this.queue.length === 1;
+        if (tail !== undefined && tail.kind === "delta" && !tailInFlight)
+            tail.text += text;
+        else
+            this.enqueue({ kind: "delta", text });
+    }
+    enqueue(item) {
+        this.queue.push(item);
+        void this.drain();
+    }
+    /** 串行链：一次发队头一项，发完（或退役丢掉）才出队；写回遇到网络错误留在队头，退避后带同一个键重发 */
+    async drain() {
+        if (this.sending)
+            return;
+        this.sending = true;
+        try {
+            while (this.queue.length > 0) {
+                const head = this.queue[0];
+                if (head.kind === "replying") {
+                    await this.deps.client.push(this.deps.key, "replying", head.data);
+                }
+                else if (this.closed) {
+                    // 退役了：没发的字与写回丢掉
+                }
+                else if (head.kind === "delta") {
+                    await this.deps.client.push(this.deps.key, "delta", { text: head.text });
+                }
+                else if (!(await this.send(head))) {
+                    continue;
+                }
+                this.queue.shift();
+            }
+        }
+        finally {
+            this.sending = false;
+            const waiters = this.waiters;
+            this.waiters = [];
+            for (const resolve of waiters)
+                resolve();
+        }
+    }
+    /** 写一条：delivered → 平台回的时间写进内存那条消息；rejected（4xx）→ warn；都算发完回 true。throw（网络 / 5xx）→ 退避后回 false，留队重发 */
+    async send(item) {
+        const head = item.message;
+        let result;
+        try {
+            result = await this.deps.client.writeMessages(this.deps.key, [head]);
+        }
+        catch (e) {
+            this.deps.log.warn("写消息失败，稍后重发", {
+                convoKey: this.deps.key,
+                idempotencyKey: head.idempotencyKey,
+                delayMs: this.retryDelay,
+                error: errorText(e),
+            });
+            await waitMs(this.retryDelay, this.abort.signal);
+            this.retryDelay = Math.min(this.retryDelay * 2, WRITE_RETRY_MAX_MS);
+            return false;
+        }
+        this.retryDelay = WRITE_RETRY_MIN_MS;
+        if (result.kind === "delivered") {
+            const timestamp = result.timestamps[0];
+            if (typeof timestamp === "number")
+                item.target.timestamp = timestamp;
+            this.deps.log.info("写回一条", { convoKey: this.deps.key, type: head.type, chars: head.text?.length ?? 0, idempotencyKey: head.idempotencyKey, timestamp });
+        }
+        else {
+            this.deps.log.warn("写消息被平台拒绝，丢弃", {
+                convoKey: this.deps.key,
+                idempotencyKey: head.idempotencyKey,
+                type: head.type,
+                status: result.status,
+                body: result.body,
+            });
+        }
+        return true;
+    }
+    clearTimer() {
+        if (this.deltaTimer === undefined)
+            return;
+        clearTimeout(this.deltaTimer);
+        this.deltaTimer = undefined;
+    }
+}
+/** 等 ms 毫秒；signal 触发就提前返回（不 reject） */
+function waitMs(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const finish = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", finish);
+            resolve();
+        };
+        const timer = setTimeout(finish, ms);
+        signal.addEventListener("abort", finish, { once: true });
+    });
+}
+//# sourceMappingURL=writeMLBMessage.js.map