@my-life-buddies/buddy-runtime 0.0.3 → 0.2.0

package/dist/conversation/{convert.js → mlbMessageAgentMessageConverter.js}

@@ -1,7 +1,9 @@
-// 平台记录与 pi 消息之间的换算。只管形状换算，不碰网络、不碰 Agent、不管游标和幂等键。
-// 入站：把 GET /internal/v1/messages 拉回来的记录换成 pi 的 AgentMessage（重建历史、灌对方的话都用它）。
-// 出站：把 pi 跑出来的 assistant / toolResult / note 换成 POST /internal/v1/messages 的每条 body。
-// 另外给 Agent 用的 convertToLlm 也在这：note 变 user、相邻 user 合并。
+// MLBMessage 与 AgentMessage 之间的换算，正反两个方向。只管形状换算，不碰网络、不碰 Agent、不管游标和幂等键。
+// MLBMessage → AgentMessage：GET /internal/v1/messages 拉回来的记录换成 Agent 历史（重建历史、交给回合都用它）。
+//   图片在这一步定下来：平台拉取时带着图片内容，换成图片块留在历史里，之后每次请求模型原样带上
+//   （REDoc《【技术设计】搭子消息流里的图片》）。
+// 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 = "（工具结果未返回：回合被中断）";
@@ -10,6 +12,12 @@ const SYSTEM_EVENT_PREFIX = "（群里发生了一件事）";
 /** 转发卡最多展开几层，再深的一层写成一句省略 */
 const CARD_MAX_DEPTH = 3;
 const CARD_TOO_DEEP = "（更深的转发略）";
+/** 图片消息没配文字时，平台写的正文 */
+const IMAGE_TEXT = "[图片]";
+/** 平台没给图片内容（图片已经不存在）时，图片块换成的固定文字 */
+const IMAGE_UNREADABLE = "[图片无法读取]";
+/** 模型不收图片时，图片块换成的固定文字 */
+const IMAGE_UNSUPPORTED = "[图片：当前模型不支持看图]";
 /** 重建出来的 thinking 块用的签名：pi 的 openai-completions 回放时按它把推理原文写回 reasoning_content 字段 */
 const THINKING_SIGNATURE = "reasoning_content";
 /** 重建的 assistant 消息没有真实用量，全零；形状照 pi-agent-core 的 EMPTY_USAGE */
@@ -23,44 +31,53 @@ function emptyUsage() {
         cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
     };
 }
-// —— 入站：平台记录 → pi AgentMessage
+// —— MLBMessage → AgentMessage
 /**
  * 把一批平台记录换成 pi 的历史。跳过的：interrupted 的半截话、question / widget、空正文又没工具调用的搭子记录。
- * 对方的 message 变 user（群里带成员前缀）、system 变 user（带「群里发生了一件事」）、messagesCard 拍平成 user、
+ * 对方的 message 变 user（群里带成员前缀）；image 变 user，正文前标「[图片 #消息 id]」，后面跟图片块；
+ * 带引用的，正文开头加一行「[引用 发言人：原话]」，引用的是图片写「[引用 发言人的图片 #被引消息 id]」；
+ * system 变 user（带「群里发生了一件事」）、messagesCard 按条目顺序展开成 user（卡里的图跟在那条正文后面）、
  * 平台的场合交代 context 原样变 user（开头自带「平台交代给你的情况」那句用法，不套前缀）；
  * 搭子的 message / checkin 变 assistant，tool 变 assistant + 每个调用一条 toolResult，note 变 note。
+ * imageInput：模型收不收图片。不收时图片块换成固定文字；平台没给图片内容的也换成固定文字。
  */
-export function toAgentMessages(records, identity) {
+export function mlbMessagesToAgentMessages(records, identity, imageInput) {
     const out = [];
     for (const record of records) {
         if (record.interrupted)
             continue;
         const text = record.text ?? "";
         switch (record.type) {
+            case "image":
+                if (record.author === "user") {
+                    const head = memberPrefix(record) + quoteLine(record) + imageLabel(record.id, text);
+                    out.push(buildUserMessage(withImage([head], record.image, imageInput), record.timestamp));
+                }
+                break;
             case "system":
-                out.push(userMessage(SYSTEM_EVENT_PREFIX + text, record.timestamp));
+                out.push(buildUserMessage([{ type: "text", text: SYSTEM_EVENT_PREFIX + text }], record.timestamp));
                 break;
             case "context":
                 if (text)
-                    out.push(userMessage(text, record.timestamp));
+                    out.push(buildUserMessage([{ type: "text", text }], record.timestamp));
                 break;
             case "messagesCard":
                 if (record.messagesCard)
-                    out.push(userMessage(flattenCard(record.messagesCard, 1).join("\n"), record.timestamp));
+                    out.push(buildUserMessage(cardContent(record.messagesCard, imageInput), record.timestamp));
                 break;
             case "message":
             case "checkin":
                 if (record.author === "buddy") {
                     if (text)
-                        out.push(assistantMessage(record, [...thinkingBlocks(record.thinking), { type: "text", text }], "stop", identity));
+                        out.push(buildAssistantMessage(record, [...thinkingBlocks(record.thinking), { type: "text", text }], "stop", identity));
                 }
                 else if (record.type === "message" && text) {
-                    out.push(userMessage(memberPrefix(record) + text, record.timestamp));
+                    out.push(buildUserMessage([{ type: "text", text: memberPrefix(record) + quoteLine(record) + text }], record.timestamp));
                 }
                 break;
             case "tool":
                 if (record.author === "buddy")
-                    out.push(...toolTurn(record, text, identity));
+                    out.push(...toolMLBMessageToAgentMessages(record, text, identity));
                 break;
             case "note":
                 if (record.author === "buddy" && text)
@@ -74,7 +91,7 @@ export function toAgentMessages(records, identity) {
     return out;
 }
 /** 搭子的 tool 记录：一条带 toolCall 块的 assistant，后面每个调用跟一条 toolResult */
-function toolTurn(record, text, identity) {
+function toolMLBMessageToAgentMessages(record, text, identity) {
     const calls = record.toolCalls ?? [];
     if (!text && calls.length === 0)
         return [];
@@ -83,7 +100,7 @@ function toolTurn(record, text, identity) {
         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 = assistantMessage(record, content, calls.length > 0 ? "toolUse" : "stop", identity);
+    const assistant = buildAssistantMessage(record, content, calls.length > 0 ? "toolUse" : "stop", identity);
     const results = calls.map((call) => ({
         role: "toolResult",
         toolCallId: call.callId,
@@ -94,7 +111,7 @@ function toolTurn(record, text, identity) {
     }));
     return [assistant, ...results];
 }
-function assistantMessage(record, content, stopReason, identity) {
+function buildAssistantMessage(record, content, stopReason, identity) {
     return {
         role: "assistant",
         content,
@@ -106,8 +123,8 @@ function assistantMessage(record, content, stopReason, identity) {
         timestamp: record.timestamp,
     };
 }
-function userMessage(text, timestamp) {
-    return { role: "user", content: [{ type: "text", text }], timestamp };
+function buildUserMessage(content, timestamp) {
+    return { role: "user", content, timestamp };
 }
 /** 有推理原文才放 thinking 块，没有就一个不放 */
 function thinkingBlocks(thinking) {
@@ -130,28 +147,66 @@ function memberPrefix(record) {
         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));
-        }
+/** 图片的标记：「[图片 #消息 id]」，配了文字接在后面。引用图片时写的是同一个 id，模型靠它对上是哪一张 */
+function imageLabel(messageId, text) {
+    return `[图片 #${messageId}]${text && text !== IMAGE_TEXT ? ` ${text}` : ""}`;
+}
+/** 带引用的消息开头加的那一行（含换行）：引用文字写「[引用 发言人：原话]」，引用图片写「[引用 发言人的图片 #被引消息 id]」，配了文字时接「：配的文字」 */
+function quoteLine(record) {
+    const quote = record.quote;
+    if (!quote)
+        return "";
+    const name = quote.name ?? "";
+    const text = quote.text ?? "";
+    if (quote.image)
+        return `[引用 ${name}的图片${quote.id ? ` #${quote.id}` : ""}${text && text !== IMAGE_TEXT ? `：${text}` : ""}]\n`;
+    return `[引用 ${name}：${text}]\n`;
+}
+/** 文字行后面跟一张图：拿得到图片内容且模型收图片时是图片块；否则换成固定文字，接在文字行里 */
+function withImage(lines, image, imageInput) {
+    if (imageInput && image?.data) {
+        return [{ type: "text", text: lines.join("\n") }, { type: "image", data: image.data, mimeType: image.mimeType ?? "image/jpeg" }];
     }
-    return lines;
+    return [{ type: "text", text: [...lines, imageInput ? IMAGE_UNREADABLE : IMAGE_UNSUPPORTED].join("\n") }];
+}
+/** 聊天记录卡按条目顺序展开：每条先一行 `【名字】`，正文原样跟一行，图片条目在正文后面跟图片；嵌套卡接着展开，超过层数上限写一句省略 */
+function cardContent(card, imageInput) {
+    const content = [];
+    let lines = [];
+    const walk = (current, depth) => {
+        for (const item of current.items ?? []) {
+            lines.push(`【${item.name ?? ""}】`);
+            if (item.text)
+                lines.push(item.text);
+            if (item.image) {
+                const [first, ...rest] = withImage(lines, item.image, imageInput);
+                if (rest.length === 0 && first.type === "text") {
+                    lines = [first.text];
+                }
+                else {
+                    content.push(first, ...rest);
+                    lines = [];
+                }
+            }
+            if (item.messagesCard) {
+                if (depth >= CARD_MAX_DEPTH)
+                    lines.push(CARD_TOO_DEEP);
+                else
+                    walk(item.messagesCard, depth + 1);
+            }
+        }
+    };
+    walk(card, 1);
+    if (lines.length > 0)
+        content.push({ type: "text", text: lines.join("\n") });
+    return content;
 }
-// —— 出站：pi 消息 → 平台写口的每条 body
+// —— AgentMessage → MLBMessage（POST /internal/v1/messages 的每条 body）
 /**
  * 不带工具调用的 assistant 消息写成 message 记录。
  * 正常收尾的照写（带 thinking）；error / aborted 收尾但已经说了半截的写成 interrupted；其余不写。
  */
-export function outboundFromAssistant(m, omitThinking = false) {
+export function assistantMessageToMLBMessage(m, omitThinking = false) {
     if (m.content.some((block) => block.type === "toolCall"))
         return null;
     const text = textOf(m);
@@ -163,9 +218,9 @@ export function outboundFromAssistant(m, omitThinking = false) {
 }
 /**
  * 带工具调用的 assistant 消息连同它的结果写成一条 tool 记录；每个调用的 summary 取工具的 label，没有 label 用名字。
- * 没有工具调用的返回 null（那种走 outboundFromAssistant）。
+ * 没有工具调用的返回 null（那种走 assistantMessageToMLBMessage）。
  */
-export function outboundFromTurn(m, toolResults, tools, dataAccessDetailsOf, sensitiveRun = false) {
+export function toolStepToMLBMessage(m, toolResults, tools, dataAccessDetailsOf, sensitiveRun = false) {
     const calls = m.content.filter((block) => block.type === "toolCall");
     if (calls.length === 0)
         return null;
@@ -179,7 +234,7 @@ export function outboundFromTurn(m, toolResults, tools, dataAccessDetailsOf, sen
             arguments: sensitiveRun ? undefined : call.arguments,
             result: result === undefined
                 ? MISSING_TOOL_RESULT
-                : persistedToolResult(call.name, result, dataAccessDetailsOf?.(call.id), sensitiveRun),
+                : toolResultTextToWrite(call.name, result, dataAccessDetailsOf?.(call.id), sensitiveRun),
         };
     });
     const thinking = sensitiveRun ? undefined : thinkingOf(m);
@@ -189,41 +244,14 @@ export function outboundFromTurn(m, toolResults, tools, dataAccessDetailsOf, sen
     return record;
 }
 /** DataAccess 的真实 Tool 结果只给当前模型回合看；写平台时只留 Dataset ID 与状态。 */
-function persistedToolResult(toolName, result, trackedDetails, sensitiveRun) {
+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);
 }
-/**
- * Agent run 完成后，把内存 transcript 里的 DataAccess 原始结果换成状态摘要。
- * run 内不能提前替换：模型在 Tool 后续一轮还需要读取真实数据。
- */
-export function redactSensitiveRun(messages, runMessages, dataAccessDetailsOf) {
-    const currentRun = new Set(runMessages);
-    return messages.map((message) => {
-        if (message.role === "assistant" && currentRun.has(message)) {
-            const hasToolCall = message.content.some((block) => block.type === "toolCall");
-            return {
-                ...message,
-                content: message.content
-                    .filter((block) => block.type !== "thinking" && (!hasToolCall || block.type === "toolCall"))
-                    .map((block) => (block.type === "toolCall" ? { ...block, arguments: {} } : block)),
-            };
-        }
-        if (message.role !== "toolResult" || !currentRun.has(message))
-            return message;
-        const trackedDetails = dataAccessDetailsOf?.(message.toolCallId);
-        const details = isDataAccessDetails(trackedDetails) ? trackedDetails : isDataAccessDetails(message.details) ? message.details : undefined;
-        return {
-            ...message,
-            content: [{ type: "text", text: details === undefined ? SENSITIVE_RUN_TOOL_SUMMARY : dataAccessSummary(details) }],
-            details,
-        };
-    });
-}
 /** note 消息写成 note 记录 */
-export function outboundFromNote(n) {
+export function noteMessageToMLBMessage(n) {
     return { type: "note", text: n.text };
 }
 /** assistant 消息里所有 thinking 块的推理原文拼起来；一个字都没有返回 undefined */
@@ -248,50 +276,4 @@ function resultText(result) {
         .map((block) => block.text)
         .join("\n");
 }
-// —— 给 Agent 用的两个钩子
-/**
- * 交给 pi 的 convertToLlm：note 变 user；相邻两条 user 合并成一条（正文中间隔一个换行）；user / assistant / toolResult 原样。
- * 返回的是新数组，合并出来的也是新对象，不改传进来的消息。
- */
-export const convertToLlm = (messages) => {
-    const out = [];
-    for (const m of messages) {
-        const next = toLlmMessage(m);
-        if (next === undefined)
-            continue;
-        const prev = out[out.length - 1];
-        if (next.role === "user" && prev !== undefined && prev.role === "user") {
-            out[out.length - 1] = mergeUsers(prev, next);
-        }
-        else {
-            out.push(next);
-        }
-    }
-    return out;
-};
-/** 一条 AgentMessage 到模型那边是什么：note 变 user；pi harness 自己并进来的那几种 role（bashExecution / custom / …）这个运行时不产生，照 pi 默认 convertToLlm 的做法不给模型 */
-function toLlmMessage(m) {
-    switch (m.role) {
-        case "note":
-            return userMessage(m.text, m.timestamp);
-        case "user":
-        case "assistant":
-        case "toolResult":
-            return m;
-        default:
-            return undefined;
-    }
-}
-function mergeUsers(a, b) {
-    const blocks = [...userBlocks(a), ...userBlocks(b)];
-    const text = blocks
-        .filter((block) => block.type === "text")
-        .map((block) => block.text)
-        .join("\n");
-    const images = blocks.filter((block) => block.type === "image");
-    return { role: "user", content: [{ type: "text", text }, ...images], timestamp: a.timestamp };
-}
-function userBlocks(m) {
-    return typeof m.content === "string" ? [{ type: "text", text: m.content }] : m.content;
-}
-//# sourceMappingURL=convert.js.map
+//# 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,31 @@
+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;
+    /** Rebuild after replay, without mixing old and new cursor semantics. */
+    resetCursor(): void;
+    /** 退役：取消重试，之后不再拉，已经在拉的拉完也不交出去 */
+    close(): void;
+    /** 一次拉取：从游标往后一页页拉到 hasMore 为 false，整批里比游标晚的交给 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":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAgB,MAAM,aAAa,CAAC;AAOzE,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,yEAAyE;IACzE,WAAW,IAAI,IAAI;IAEnB,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAKb,8EAA8E;YAChE,IAAI;IA0BlB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,WAAW;CAKnB"}

package/dist/conversation/readMLBMessages.js

@@ -0,0 +1,90 @@
+// 一场会话从平台拉消息：同会话串行地拉、从哪拉起、拉失败了怎么办。
+// 管：拉取串行链（notify 只往链尾排，绝不并发拉）；读方向游标（已经拉到的最晚一条的消息时间）；
+//     GET /internal/v1/messages 从游标往后一页页拉，响应的 hasMore 为 true 就从这页最后一条的时间接着拉，
+//     整批里比游标晚的交给 onMessages，游标推到这批里最晚的消息时间；
+//     网络错误主动退避重试（1 秒起步、翻倍、封顶 30 秒），新的 notify 取消等待立即重拉；退役后不再拉。
+// 不管：拉到的消息怎么处理（index.ts：第一批重建历史，之后的交给回合）、HTTP 请求本身（mlbClient.ts）。
+import { errorText } from "../log.js";
+/** 每页最多拉多少条：平台钳在 1..200。一页还受图片内容总字节的限制，可能不满就结束，拉没拉完看响应的 hasMore */
+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) }));
+    }
+    /** Rebuild after replay, without mixing old and new cursor semantics. */
+    resetCursor() { this.pulledTimestamp = 0; }
+    /** 退役：取消重试，之后不再拉，已经在拉的拉完也不交出去 */
+    close() {
+        this.closed = true;
+        this.cancelRetry();
+    }
+    /** 一次拉取：从游标往后一页页拉到 hasMore 为 false，整批里比游标晚的交给 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);
+            const last = page.messages.at(-1);
+            if (!page.hasMore || last === undefined)
+                break;
+            after = last.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,64 @@
+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, MLBMessageToWrite, 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);
+    /** 业务消息与 delta、模型写回共用同一队列。 */
+    enqueueMessage(message: MLBMessageToWrite): void;
+    /** 回合开始 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,EAAE,iBAAiB,EAAE,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,8BAA8B;IAC9B,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAEhD,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"}