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

package/dist/conversation/writeMLBMessage.js

@@ -0,0 +1,214 @@
+// 一场会话往平台发的所有东西排在一条队列里按顺序发：「正在回复」开关与工具状态行、生成中的正文碎片（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;
+    }
+    /** 业务消息与 delta、模型写回共用同一队列。 */
+    enqueueMessage(message) { this.write(message); }
+    /** 回合开始 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 = item.target && 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 = message.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)
+                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

package/dist/conversation/writeMLBMessage.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,8 @@
 export { BuddyServer } from "./server.ts";
 export type { BuddyFactory, BuddyLogger, BuddyOptions, BuddyServerHandle, Conversation, DataAccessQuery, DataRequirement, DatasetAccessResult, MemoryEntry, StartOptions, } from "./types.ts";
+export { WidgetClient } from "./platform/widgets.ts";
+export { PlatformRequestError } from "./platform/mlbClient.ts";
+export type { PlatformClient } from "./platform/client.ts";
+export type { PlatformToolName } from "./tools/registry.ts";
+export type { Widget, WidgetSummary, WidgetRecord, WidgetWriteResult, WidgetClientOptions, WidgetCreateInput, WidgetWriteInput, WidgetPresentation, PlatformRequest, RequestOptions } from "./platform/widgets.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,YAAY,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,YAAY,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
 // 包出口：搭子开发者只从这里 import。
 export { BuddyServer } from "./server.js";
+export { WidgetClient } from "./platform/widgets.js";
+export { PlatformRequestError } from "./platform/mlbClient.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAc1C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/mlbClient.d.ts

@@ -1,127 +1,2 @@
-import type { BuddyEvent, BuddyLogger, DataRequirement, DatasetAccessResult, MemoryEntry, OutgoingMessage, PullResponse } from "./types.ts";
-export interface MLBClientOptions {
-    /** 网关地址，如 http://localhost:8788；末尾带不带斜杠都行 */
-    gatewayUrl: string;
-    /** 搭子令牌，放进每个请求的 Authorization: Bearer */
-    token: string;
-    log: BuddyLogger;
-}
-/** 写消息的结果：4xx 是平台明确拒绝（调用方丢弃不重发）；网络错误 / 5xx 直接 throw（调用方重发） */
-export type WriteResult = {
-    kind: "delivered";
-} | {
-    kind: "rejected";
-    status: number;
-    body: string;
-};
-/** widget 类型目录里一个模块的声明 */
-export interface WidgetModuleDecl {
-    description?: string;
-    record?: {
-        properties?: Record<string, {
-            type?: string;
-            description?: string;
-        }>;
-        required?: string[];
-    };
-}
-/** GET /internal/v1/widget-types 回的一个类型 */
-export interface WidgetType {
-    id: string;
-    description?: string;
-    modules?: Record<string, WidgetModuleDecl>;
-}
-/** widget 各接口的结果：ok 时 body 是响应体 JSON；不 ok 时 error 是平台错误体里的 error 字段或网络错误文案 */
-export type WidgetReply = {
-    ok: true;
-    body: any;
-} | {
-    ok: false;
-    error: string;
-};
-export declare const MAX_DATASETS_PER_QUERY = 8;
-export declare const MAX_DATA_ACCESS_RESPONSE_BYTES: number;
-export declare class MLBClient {
-    private readonly base;
-    private readonly token;
-    private readonly log;
-    constructor(options: MLBClientOptions);
-    /**
-     * GET /internal/v1/messages?convoKey=&after=&limit=。
-     * 网络错误与非 2xx 都 throw，交给调用方等下次通知再拉；2xx 原样回响应体。
-     */
-    pullMessages(convoKey: string, after: number, limit?: number): Promise<PullResponse>;
-    /**
-     * POST /internal/v1/messages { convoKey, messages }。
-     * 2xx → delivered；4xx → rejected（带 status 与响应体，调用方丢弃）；网络错误 / 5xx → throw（调用方带同一幂等键重发）。
-     */
-    writeMessages(convoKey: string, messages: OutgoingMessage[]): Promise<WriteResult>;
-    /** POST /internal/v1/push。只管发，失败（网络错误或非 2xx）只记 warn，不 throw */
-    push(convoKey: string, event: "replying", data: {
-        on: boolean;
-        status?: string;
-    }): Promise<void>;
-    push(convoKey: string, event: "delta", data: {
-        text: string;
-    }): Promise<void>;
-    /** GET /internal/v1/widget-types → types 数组。非 2xx、网络错误、响应体解析不了都回 [] 并记 warn */
-    widgetTypes(): Promise<WidgetType[]>;
-    /** POST /internal/v1/widgets { convoKey, type, title } → { id } */
-    widgetCreate(convoKey: string, type: string, title: string): Promise<WidgetReply>;
-    /** PUT /internal/v1/widgets/:widgetId/:module/:recordId { convoKey, data } → { ok, revision } */
-    widgetWrite(convoKey: string, widgetId: string, module: string, recordId: string, data: unknown): Promise<WidgetReply>;
-    /**
-     * 不带 module：GET /internal/v1/widgets/:widgetId?convoKey= → 整个 widget（含各模块记录）；
-     * 带 module：GET /internal/v1/widgets/:widgetId/:module?convoKey= → { records }
-     */
-    widgetRead(convoKey: string, widgetId: string, module?: string): Promise<WidgetReply>;
-    /** DELETE /internal/v1/widgets/:widgetId/:module/:recordId?convoKey= → { ok } */
-    widgetDelete(convoKey: string, widgetId: string, module: string, recordId: string): Promise<WidgetReply>;
-    /** widget 接口共用：2xx 回解析后的响应体；非 2xx 取错误体的 error 字段；网络错误取异常文案。都不 throw，让模型看到原因后改参数重试 */
-    private widgetCall;
-    /** GET /internal/v1/memory?convoKey= → entries（全量，按 key 字典序）。会话键作废时平台回空表 */
-    memoryList(convoKey: string): Promise<MemoryEntry[]>;
-    /** PUT /internal/v1/memory/:key { convoKey, text }：覆盖写一条（后写赢） */
-    memoryWrite(convoKey: string, key: string, text: string): Promise<void>;
-    /** DELETE /internal/v1/memory/:key?convoKey=：删一条，删不存在的也回 ok */
-    memoryDelete(convoKey: string, key: string): Promise<void>;
-    /**
-     * POST /internal/v1/data-access/query：按当前会话读取用户已授权的 Dataset。
-     * 私聊不传 memberId；群聊传消息前缀里的稳定 memberId。非 2xx、坏 JSON 或响应缺 datasets 都 throw。
-     */
-    queryDataAccess(convoKey: string, datasets: string[], memberId?: string): Promise<DatasetAccessResult[]>;
-    /** GET /internal/v1/data-access/requirements：当前搭子声明的 Dataset；失败由调用方决定是否降级。 */
-    dataRequirements(): Promise<DataRequirement[]>;
-    /** memory 接口共用：2xx 回解析后的响应体；非 2xx throw 平台错误体的 error 字段（超配额、key 不合法都在这）；网络错误、超时原样 throw */
-    private memoryCall;
-    /** 发一个请求并把响应体读完。网络错误、超时直接 throw；HTTP 状态不在这里判 */
-    private call;
-}
-export declare class EventStream {
-    private readonly base;
-    private readonly token;
-    private readonly log;
-    private readonly onEvent;
-    private run;
-    constructor(options: MLBClientOptions & {
-        onEvent: (event: BuddyEvent) => void;
-    });
-    /** 连上 GET /internal/v1/events 并一直保持；已经在跑就不重复起。不会 throw，连不上在后台退避重连 */
-    start(): void;
-    /** 断开当前连接、取消等待中的重连，之后不再连。再调 start() 会重新起一轮 */
-    stop(): void;
-    /**
-     * 连接循环：连上就一直读，读到服务端关流或出错就按退避等一会再连。
-     * 退避只针对「连不上」：这次连上过（流打开了）的，不论后来怎么断，下次都从 1 秒重新算——
-     * 健康连接被服务端掐掉（网关重启、顶号）不该被当成连不上而越等越久。
-     */
-    private loop;
-    /** 连一次并读到流结束。流一打开就把 attempt.opened 置真；非 2xx、网络错误、被 abort 都 throw */
-    private connectOnce;
-    /**
-     * 解一帧：取 event: 与 data: 行（多行 data 用 \n 拼），其余字段和 : 开头的注释行不管。
-     * 没有 data 的帧不算事件；ping / welcome / data-access 丢掉；只把 message / delete 分发出去，且 convoKey 必须合法。
-     */
-    private handleFrame;
-}
+export * from "./platform/mlbClient.ts";
 //# sourceMappingURL=mlbClient.d.ts.map

package/dist/mlbClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mlbClient.d.ts","sourceRoot":"","sources":["../src/mlbClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mlbClient.d.ts","sourceRoot":"","sources":["../src/mlbClient.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC"}