@my-life-buddies/buddy-runtime 0.0.1

package/dist/conversation/history.d.ts

@@ -0,0 +1,18 @@
+import type { PlatformMessage } from "../types.ts";
+/** 首次拉取：末尾一条若是对方说的，不灌历史，留给回合按正常规矩处理（该开口就开口） */
+export declare function splitForRebuild(records: PlatformMessage[]): {
+    history: PlatformMessage[];
+    tail: PlatformMessage | undefined;
+};
+/** 一批记录里最大的 seq；空批回原游标 */
+export declare function maxSeq(records: PlatformMessage[], from: number): number;
+/**
+ * 一批增量：游标之后的、对方说的（author ≠ buddy）、有正文或是转发卡的，才是要处理的；
+ * 「该不该开口」只看平台下发的 shouldReply，运行时不判、不让模型猜。
+ */
+export declare function incoming(batch: PlatformMessage[], pulledSeq: number): {
+    fresh: PlatformMessage[];
+    theirs: PlatformMessage[];
+    shouldReply: boolean;
+};
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/conversation/history.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,IAAI,EAAE,eAAe,GAAG,SAAS,CAAA;CAAE,CAI7H;AAED,0BAA0B;AAC1B,wBAAgB,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAInJ"}

package/dist/conversation/history.js

@@ -0,0 +1,28 @@
+// 拉回来的平台记录怎么分拣：哪些灌进历史、哪条留给回合、哪些是对方说的、要不要开口。纯函数，不碰 Agent。
+// 管：首次拉取（重建）的切分；每批增量的过滤与判定。
+// 不管：记录换成 pi 消息的形状（convert.ts）、分拣之后怎么处理（index.ts）。
+/** 首次拉取：末尾一条若是对方说的，不灌历史，留给回合按正常规矩处理（该开口就开口） */
+export function splitForRebuild(records) {
+    const last = records[records.length - 1];
+    if (last === undefined || last.author === "buddy")
+        return { history: records, tail: undefined };
+    return { history: records.slice(0, -1), tail: last };
+}
+/** 一批记录里最大的 seq；空批回原游标 */
+export function maxSeq(records, from) {
+    let seq = from;
+    for (const m of records)
+        if (m.seq > seq)
+            seq = m.seq;
+    return seq;
+}
+/**
+ * 一批增量：游标之后的、对方说的（author ≠ buddy）、有正文或是转发卡的，才是要处理的；
+ * 「该不该开口」只看平台下发的 shouldReply，运行时不判、不让模型猜。
+ */
+export function incoming(batch, pulledSeq) {
+    const fresh = batch.filter((m) => m.seq > pulledSeq);
+    const theirs = fresh.filter((m) => m.author !== "buddy" && ((m.text ?? "") !== "" || m.messagesCard !== undefined));
+    return { fresh, theirs, shouldReply: theirs.some((m) => m.shouldReply === true) };
+}
+//# sourceMappingURL=history.js.map

package/dist/conversation/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/conversation/history.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,4BAA4B;AAC5B,mDAAmD;AAInD,+CAA+C;AAC/C,MAAM,UAAU,eAAe,CAAC,OAA0B;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAChG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,MAAM,CAAC,OAA0B,EAAE,IAAY;IAC9D,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG;YAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IACtD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAwB,EAAE,SAAiB;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC;IACpH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,EAAE,CAAC;AACnF,CAAC"}

package/dist/conversation/index.d.ts

@@ -0,0 +1,92 @@
+import type { AgentMessage, StreamFn } from "@earendil-works/pi-agent-core";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { MLBClient, WidgetType } from "../mlbClient.ts";
+import type { BuddyFactory, BuddyLogger } from "../types.ts";
+export interface ConversationHandleDeps {
+    /** 平台会话键：p_ 私聊、g_ 群 */
+    key: string;
+    buddyId: string;
+    client: MLBClient;
+    model: Model<Api>;
+    streamFn: StreamFn;
+    /** 搭子令牌：每回合经 Agent 的 getApiKey 交给模型通道，变成 Authorization: Bearer 头 */
+    token: string;
+    /** 小挂件类型目录，server 懒拉一次后一直给同一个 promise */
+    widgetTypes: () => Promise<WidgetType[]>;
+    factory: BuddyFactory;
+    log: BuddyLogger;
+    /** 拉取响应没有 context 字段（键已作废）时通知 server 把这场会话从表里删掉 */
+    onInvalid: () => void;
+}
+export declare class ConversationHandle {
+    private readonly deps;
+    private readonly identity;
+    private readonly presence;
+    private readonly writeBack;
+    /** 懒建：第一次拉到消息时跑 factory 再 new */
+    private agent;
+    /** 同会话的拉取串行链：notify 只往链尾排，绝不并发拉 */
+    private pullChain;
+    /** 读方向游标：已经拉到并处理过的最大 seq（含自己写的） */
+    private pulledSeq;
+    /** 首次拉取（after=0 全量灌历史）做过没有 */
+    private rebuilt;
+    /** 平台随拉取下发的 context 段，每回合由 transformContext 插进历史末尾 */
+    private lastContext;
+    /** 忙时听见的、不用开口的旁听消息，回合收尾再进历史 */
+    private heard;
+    /** 当前回合的 promise，close 要等它 */
+    private turn;
+    /** 本回合有没有一条 assistant 消息带非空正文且正常收尾 */
+    private spoke;
+    /** 本回合有没有一条 assistant 消息是出错 / 被掐断收尾的——这种不补 NUDGE（半截已定格、错误已记，再驱动一轮只会在错误后面多说一句） */
+    private failed;
+    private _busy;
+    private _closed;
+    private _lastActivity;
+    constructor(deps: ConversationHandleDeps);
+    /** 正在跑回合（含收尾：等出站队列清空） */
+    get busy(): boolean;
+    /** 最近一次有消息进来或回合收尾的时刻，server 按它做空闲淘汰 */
+    get lastActivity(): number;
+    /** 已退役：不再拉、不再写、事件全丢 */
+    get closed(): boolean;
+    /** 测试探针：Agent 当前的历史；还没建 Agent 时是空数组 */
+    get transcript(): readonly AgentMessage[];
+    /** SSE message 到了：把一次拉取排进串行链。已退役的直接忽略 */
+    notify(): void;
+    /**
+     * SSE delete 到了（或 server 空闲淘汰 / 键作废）：先标退役，再打断正在跑的回合，等回合收尾。可以重复调。
+     */
+    close(): Promise<void>;
+    /** 标退役：写回队列清空并打断重发等待（回合收尾才不会被它拖住）、攒着的 delta 扔掉 */
+    private retire;
+    /**
+     * 一次拉取：从 pulledSeq 往后翻到不满页。响应没有 context = 键已作废 → 退役、通知 server；
+     * 有 context 就存下来。第一次走重建，之后走 ingest。网络错误只记 warn，等下次通知再拉。
+     */
+    private pull;
+    /**
+     * 首次拉取：建 Agent，把全量历史灌进 state.messages（不经事件，天然不会被写回平台），不起回合。
+     * 末尾一条若是对方说的，不灌，留给 ingest 按正常规矩处理（该开口就开口）。
+     */
+    private rebuild;
+    /**
+     * 一批新记录：游标推到最大 seq（自己写的也算，下次不再拉到）；只留对方说的、有正文（或是转发卡）的，换成 user 消息；
+     * 空闲 + 不用开口 → 直接进历史；空闲 + 要开口 → 起回合；忙 + 不用开口 → 攒进 heard；忙 + 要开口 → steer 进当前回合。
+     */
+    private ingest;
+    /**
+     * 跑一个回合。messages 有值就 prompt 它们；没值（收尾时发现队列里还有消息）就直接 continue。
+     * prompt 完把回合中 steer 进来的消化完；一句话没说就 followUp 一条 note 提醒再跑一次。
+     * 收尾：heard 进历史、delta 发完、replying 关掉、等出站队列清空，才算不忙。
+     * 收尾期间又有人 steer（busy 还是 true，走不了 prompt），就接着再跑一个回合把它消化掉。
+     */
+    private runTurn;
+    /**
+     * Agent 事件 → 写回队列 / 在线态。pi 会等这个函数返回再往下走，所以只做同步入队，网络在队列自己的链上；
+     * 抛错会让 pi 把整个回合判失败，所以整体 try/catch。退役后的事件直接丢。
+     */
+    private onEvent;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAqB,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAgC,MAAM,aAAa,CAAC;AAM3F,MAAM,WAAW,sBAAsB;IACtC,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,WAAW,CAAC;IACjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,IAAI,CAAC;CACtB;AAQD,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,iCAAiC;IACjC,OAAO,CAAC,KAAK,CAAoB;IACjC,mCAAmC;IACnC,OAAO,CAAC,SAAS,CAAoC;IACrD,mCAAmC;IACnC,OAAO,CAAC,SAAS,CAAK;IACtB,8BAA8B;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAAqB;IACxC,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAsB;IACnC,8BAA8B;IAC9B,OAAO,CAAC,IAAI,CAA4B;IACxC,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAS;IACtB,iFAAiF;IACjF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAc;gBAEvB,IAAI,EAAE,sBAAsB;IAcxC,yBAAyB;IACzB,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,uCAAuC;IACvC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,uBAAuB;IACvB,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,uCAAuC;IACvC,IAAI,UAAU,IAAI,SAAS,YAAY,EAAE,CAExC;IAED,yCAAyC;IACzC,MAAM,IAAI,IAAI;IAQd;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,kDAAkD;IAClD,OAAO,CAAC,MAAM;IAQd;;;OAGG;YACW,IAAI;IAsClB;;;OAGG;YACW,OAAO;IAgBrB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAqBd;;;;;OAKG;YACW,OAAO;IA6CrB;;;OAGG;IACH,OAAO,CAAC,OAAO;CAuDf"}

package/dist/conversation/index.js

@@ -0,0 +1,322 @@
+// 一场会话的纪律：什么时候拉、拉到怎么办、什么时候起回合、Agent 事件往哪送、怎么退役。
+// 管：同会话拉取串行链与读方向游标；首次拉取把全量历史灌进 Agent（重建）；之后每批按空闲 / 忙碌 × 要不要开口四路分发；
+//     回合（prompt → 把回合中排进队列的消息消化完 → 一句话没说就补一句提醒再跑一次）；Agent 事件分给写回队列与在线态；
+//     close（先标退役、再打断回合、等它收尾）。
+// 不管：Agent 怎么建（agent.ts）、拉回来的记录怎么分拣（history.ts）、写回平台（writeBack.ts）、replying / delta 推送（presence.ts）、
+//     HTTP 请求本身（mlbClient.ts）、平台记录与 pi 消息的形状换算（convert.ts）、会话从哪来到哪去（server.ts 管 Map、空闲淘汰与 delete 事件）。
+import { randomUUID } from "node:crypto";
+import { outboundFromAssistant, outboundFromNote, outboundFromTurn, textOf, toAgentMessages } from "./convert.js";
+import { errorText } from "../log.js";
+import { modelIdentity } from "../model.js";
+import { createAgent } from "./agent.js";
+import { incoming, maxSeq, splitForRebuild } from "./history.js";
+import { Presence } from "./presence.js";
+import { WriteBack } from "./writeBack.js";
+/** 每页拉多少条：平台钳在 1..200，翻页靠不满页 */
+const PULL_LIMIT = 200;
+/** 回合跑完一句话都没说时，以 note 的身份补给模型的一句提醒 */
+const NUDGE = "你上一条回复正文是空的。把要说的话直接说出来。";
+export class ConversationHandle {
+    deps;
+    identity;
+    presence;
+    writeBack;
+    /** 懒建：第一次拉到消息时跑 factory 再 new */
+    agent;
+    /** 同会话的拉取串行链：notify 只往链尾排，绝不并发拉 */
+    pullChain = Promise.resolve();
+    /** 读方向游标：已经拉到并处理过的最大 seq（含自己写的） */
+    pulledSeq = 0;
+    /** 首次拉取（after=0 全量灌历史）做过没有 */
+    rebuilt = false;
+    /** 平台随拉取下发的 context 段，每回合由 transformContext 插进历史末尾 */
+    lastContext;
+    /** 忙时听见的、不用开口的旁听消息，回合收尾再进历史 */
+    heard = [];
+    /** 当前回合的 promise，close 要等它 */
+    turn;
+    /** 本回合有没有一条 assistant 消息带非空正文且正常收尾 */
+    spoke = false;
+    /** 本回合有没有一条 assistant 消息是出错 / 被掐断收尾的——这种不补 NUDGE（半截已定格、错误已记，再驱动一轮只会在错误后面多说一句） */
+    failed = false;
+    _busy = false;
+    _closed = false;
+    _lastActivity = Date.now();
+    constructor(deps) {
+        this.deps = deps;
+        this.identity = modelIdentity(deps.model);
+        this.presence = new Presence(deps.client, deps.key);
+        this.writeBack = new WriteBack({
+            client: deps.client,
+            key: deps.key,
+            buddyId: deps.buddyId,
+            runId: randomUUID().slice(0, 8),
+            log: deps.log,
+            beforeSend: () => this.presence.flushDelta(),
+        });
+    }
+    /** 正在跑回合（含收尾：等出站队列清空） */
+    get busy() {
+        return this._busy;
+    }
+    /** 最近一次有消息进来或回合收尾的时刻，server 按它做空闲淘汰 */
+    get lastActivity() {
+        return this._lastActivity;
+    }
+    /** 已退役：不再拉、不再写、事件全丢 */
+    get closed() {
+        return this._closed;
+    }
+    /** 测试探针：Agent 当前的历史；还没建 Agent 时是空数组 */
+    get transcript() {
+        return this.agent?.state.messages ?? [];
+    }
+    /** SSE message 到了：把一次拉取排进串行链。已退役的直接忽略 */
+    notify() {
+        if (this._closed)
+            return;
+        this._lastActivity = Date.now();
+        this.pullChain = this.pullChain
+            .then(() => this.pull())
+            .catch((e) => this.deps.log.warn("处理拉取结果出错", { convoKey: this.deps.key, error: errorText(e) }));
+    }
+    /**
+     * SSE delete 到了（或 server 空闲淘汰 / 键作废）：先标退役，再打断正在跑的回合，等回合收尾。可以重复调。
+     */
+    async close() {
+        this.retire();
+        if (this._busy)
+            this.agent?.abort();
+        await this.turn;
+    }
+    /** 标退役：写回队列清空并打断重发等待（回合收尾才不会被它拖住）、攒着的 delta 扔掉 */
+    retire() {
+        this._closed = true;
+        this.writeBack.close();
+        this.presence.close();
+    }
+    // —— 拉取
+    /**
+     * 一次拉取：从 pulledSeq 往后翻到不满页。响应没有 context = 键已作废 → 退役、通知 server；
+     * 有 context 就存下来。第一次走重建，之后走 ingest。网络错误只记 warn，等下次通知再拉。
+     */
+    async pull() {
+        if (this._closed)
+            return;
+        const batch = [];
+        let after = this.pulledSeq;
+        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, error: errorText(e) });
+                return;
+            }
+            if (this._closed)
+                return;
+            if (page.context === undefined) {
+                this.deps.log.info("会话键已作废，退役", { convoKey: this.deps.key });
+                this.retire();
+                this.deps.onInvalid();
+                return;
+            }
+            this.lastContext = page.context;
+            batch.push(...page.messages);
+            if (page.messages.length < PULL_LIMIT)
+                break;
+            after = page.messages[page.messages.length - 1].seq;
+        }
+        if (this.rebuilt) {
+            this.ingest(batch);
+            return;
+        }
+        try {
+            await this.rebuild(batch);
+        }
+        catch (e) {
+            // factory 抛错、工具重名之类：这场会话起不来。退役并让 server 删掉，下一条消息会重新起一场再试
+            this.deps.log.error("起会话失败", { convoKey: this.deps.key, error: errorText(e) });
+            this.retire();
+            this.deps.onInvalid();
+        }
+    }
+    /**
+     * 首次拉取：建 Agent，把全量历史灌进 state.messages（不经事件，天然不会被写回平台），不起回合。
+     * 末尾一条若是对方说的，不灌，留给 ingest 按正常规矩处理（该开口就开口）。
+     */
+    async rebuild(records) {
+        const agent = await createAgent({
+            ...this.deps,
+            contextOf: () => this.lastContext,
+            onEvent: (a, event) => this.onEvent(a, event),
+        });
+        if (this._closed)
+            return;
+        this.agent = agent;
+        const { history, tail } = splitForRebuild(records);
+        agent.state.messages = toAgentMessages(history, this.identity);
+        this.pulledSeq = maxSeq(history, this.pulledSeq);
+        this.rebuilt = true;
+        this.deps.log.info("历史已重建", { convoKey: this.deps.key, records: history.length, transcript: agent.state.messages.length });
+        if (tail !== undefined)
+            this.ingest([tail]);
+    }
+    /**
+     * 一批新记录：游标推到最大 seq（自己写的也算，下次不再拉到）；只留对方说的、有正文（或是转发卡）的，换成 user 消息；
+     * 空闲 + 不用开口 → 直接进历史；空闲 + 要开口 → 起回合；忙 + 不用开口 → 攒进 heard；忙 + 要开口 → steer 进当前回合。
+     */
+    ingest(batch) {
+        const agent = this.agent;
+        if (agent === undefined || this._closed)
+            return;
+        const { fresh, theirs, shouldReply } = incoming(batch, this.pulledSeq);
+        if (fresh.length === 0)
+            return;
+        this.pulledSeq = maxSeq(fresh, this.pulledSeq);
+        this._lastActivity = Date.now();
+        if (theirs.length === 0)
+            return;
+        const messages = toAgentMessages(theirs, this.identity);
+        if (messages.length === 0)
+            return;
+        if (!this._busy) {
+            if (shouldReply)
+                this.turn = this.runTurn(messages);
+            else
+                agent.state.messages.push(...messages);
+            return;
+        }
+        if (shouldReply)
+            for (const m of messages)
+                agent.steer(m);
+        else
+            this.heard.push(...messages);
+    }
+    // —— 回合
+    /**
+     * 跑一个回合。messages 有值就 prompt 它们；没值（收尾时发现队列里还有消息）就直接 continue。
+     * prompt 完把回合中 steer 进来的消化完；一句话没说就 followUp 一条 note 提醒再跑一次。
+     * 收尾：heard 进历史、delta 发完、replying 关掉、等出站队列清空，才算不忙。
+     * 收尾期间又有人 steer（busy 还是 true，走不了 prompt），就接着再跑一个回合把它消化掉。
+     */
+    async runTurn(messages) {
+        const agent = this.agent;
+        if (agent === undefined || this._closed)
+            return;
+        this._busy = true;
+        this.spoke = false;
+        this.failed = false;
+        this.presence.replying({ on: true });
+        const startedAt = Date.now();
+        this.deps.log.info("回合开始", { convoKey: this.deps.key, prompt: messages?.length ?? 0, transcript: agent.state.messages.length });
+        try {
+            if (messages !== undefined)
+                await agent.prompt(messages);
+            this.deps.log.info("prompt 返回", { convoKey: this.deps.key, queued: agent.hasQueuedMessages(), spoke: this.spoke, failed: this.failed });
+            while (!this._closed && agent.hasQueuedMessages())
+                await agent.continue();
+            // 正常收尾却一句正文没有才补；出错 / 被掐断的不补
+            if (!this._closed && !this.spoke && !this.failed) {
+                this.deps.log.info("空回复，补一句", { convoKey: this.deps.key });
+                const nudge = { role: "note", text: NUDGE, timestamp: Date.now() };
+                agent.followUp(nudge);
+                await agent.continue();
+            }
+        }
+        catch (e) {
+            this.deps.log.warn("回合出错", { convoKey: this.deps.key, error: errorText(e) });
+        }
+        finally {
+            if (this.heard.length > 0) {
+                agent.state.messages.push(...this.heard);
+                this.heard = [];
+            }
+            this.presence.flushDelta();
+            this.presence.replying({ on: false });
+            await this.writeBack.flush();
+            this._busy = false;
+            this._lastActivity = Date.now();
+            this.deps.log.info("回合收尾", {
+                convoKey: this.deps.key,
+                ms: Date.now() - startedAt,
+                spoke: this.spoke,
+                failed: this.failed,
+                error: agent.state.errorMessage,
+            });
+            if (!this._closed && agent.hasQueuedMessages())
+                this.turn = this.runTurn(undefined);
+        }
+    }
+    // —— Agent 事件
+    /**
+     * Agent 事件 → 写回队列 / 在线态。pi 会等这个函数返回再往下走，所以只做同步入队，网络在队列自己的链上；
+     * 抛错会让 pi 把整个回合判失败，所以整体 try/catch。退役后的事件直接丢。
+     */
+    onEvent(agent, event) {
+        if (this._closed)
+            return;
+        try {
+            switch (event.type) {
+                case "agent_start":
+                    this.deps.log.info("run 开始", { convoKey: this.deps.key });
+                    break;
+                case "agent_end":
+                    this.deps.log.info("run 结束", { convoKey: this.deps.key, newMessages: event.messages.length, queued: agent.hasQueuedMessages() });
+                    break;
+                case "message_end": {
+                    const m = event.message;
+                    if (m.role === "assistant") {
+                        this.deps.log.info("assistant 一段", {
+                            convoKey: this.deps.key,
+                            stopReason: m.stopReason,
+                            chars: textOf(m).length,
+                            toolCalls: m.content.filter((block) => block.type === "toolCall").length,
+                            error: m.errorMessage,
+                        });
+                        if (m.stopReason === "error" || m.stopReason === "aborted")
+                            this.failed = true;
+                        else if (textOf(m) !== "")
+                            this.spoke = true;
+                        // 带工具调用的等 turn_end 连结果一起写成 tool 记录
+                        if (!m.content.some((block) => block.type === "toolCall")) {
+                            const out = outboundFromAssistant(m);
+                            if (out !== null)
+                                this.writeBack.enqueue(out);
+                        }
+                    }
+                    else if (m.role === "note") {
+                        this.writeBack.enqueue(outboundFromNote(m));
+                    }
+                    break;
+                }
+                case "turn_end": {
+                    const m = event.message;
+                    if (m.role === "assistant" && m.content.some((block) => block.type === "toolCall")) {
+                        const out = outboundFromTurn(m, event.toolResults, agent.state.tools);
+                        if (out !== null)
+                            this.writeBack.enqueue(out);
+                    }
+                    break;
+                }
+                case "message_update":
+                    if (event.assistantMessageEvent.type === "text_delta")
+                        this.presence.delta(event.assistantMessageEvent.delta);
+                    break;
+                case "tool_execution_start": {
+                    const label = agent.state.tools.find((t) => t.name === event.toolName)?.label;
+                    if (label)
+                        this.presence.replying({ on: true, status: label });
+                    break;
+                }
+                default:
+                    break;
+            }
+        }
+        catch (e) {
+            this.deps.log.warn("处理 Agent 事件出错", { convoKey: this.deps.key, event: event.type, error: errorText(e) });
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/conversation/index.js.map

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

package/dist/conversation/presence.d.ts

@@ -0,0 +1,24 @@
+import type { MLBClient } from "../mlbClient.ts";
+export declare class Presence {
+    private readonly client;
+    private readonly key;
+    /** 推送串行链：只保证顺序，不等它 */
+    private chain;
+    private deltaBuffer;
+    private deltaTimer;
+    private closed;
+    constructor(client: MLBClient, key: string);
+    /** 回合开始 on、收尾 off；工具跑起来时带 status 更新状态行 */
+    replying(data: {
+        on: boolean;
+        status?: string;
+    }): void;
+    /** 正文碎片先攒着，120 毫秒内攒到的一起发 */
+    delta(text: string): void;
+    /** 把攒下的碎片立刻发出去；退役了就扔掉。写平台前、回合收尾前各叫一次，预览不落在正文后面 */
+    flushDelta(): void;
+    /** 退役：攒着的碎片扔掉，定时器清掉。replying off 仍然放行——收尾要把三个圆点熄掉 */
+    close(): void;
+    private clearTimer;
+}
+//# sourceMappingURL=presence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/conversation/presence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,sBAAsB;IACtB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM;IAK1C,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAItD,4BAA4B;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWzB,kDAAkD;IAClD,UAAU,IAAI,IAAI;IAQlB,qDAAqD;IACrD,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,UAAU;CAKlB"}

package/dist/conversation/presence.js

@@ -0,0 +1,56 @@
+// 一场会话的在线态：replying 开关与工具状态行、生成中的正文碎片（delta）。
+// 管：把 replying / delta 按顺序推给平台（POST /internal/v1/push），只保证顺序、不等结果；delta 每 120 毫秒攒一帧。
+// 不管：什么时候该开关 replying、碎片从哪来（index.ts 按 Agent 事件调这里）。
+/** 生成中的正文碎片攒多久发一帧 delta */
+const DELTA_THROTTLE_MS = 120;
+export class Presence {
+    client;
+    key;
+    /** 推送串行链：只保证顺序，不等它 */
+    chain = Promise.resolve();
+    deltaBuffer = "";
+    deltaTimer;
+    closed = false;
+    constructor(client, key) {
+        this.client = client;
+        this.key = key;
+    }
+    /** 回合开始 on、收尾 off；工具跑起来时带 status 更新状态行 */
+    replying(data) {
+        this.chain = this.chain.then(() => this.client.push(this.key, "replying", data)).catch(() => { });
+    }
+    /** 正文碎片先攒着，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);
+        }
+    }
+    /** 把攒下的碎片立刻发出去；退役了就扔掉。写平台前、回合收尾前各叫一次，预览不落在正文后面 */
+    flushDelta() {
+        this.clearTimer();
+        const text = this.deltaBuffer;
+        this.deltaBuffer = "";
+        if (text === "" || this.closed)
+            return;
+        this.chain = this.chain.then(() => this.client.push(this.key, "delta", { text })).catch(() => { });
+    }
+    /** 退役：攒着的碎片扔掉，定时器清掉。replying off 仍然放行——收尾要把三个圆点熄掉 */
+    close() {
+        this.closed = true;
+        this.clearTimer();
+        this.deltaBuffer = "";
+    }
+    clearTimer() {
+        if (this.deltaTimer === undefined)
+            return;
+        clearTimeout(this.deltaTimer);
+        this.deltaTimer = undefined;
+    }
+}
+//# sourceMappingURL=presence.js.map

package/dist/conversation/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../src/conversation/presence.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,qFAAqF;AACrF,qDAAqD;AAIrD,2BAA2B;AAC3B,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,OAAO,QAAQ;IACH,MAAM,CAAY;IAClB,GAAG,CAAS;IAC7B,sBAAsB;IACd,KAAK,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACzC,WAAW,GAAG,EAAE,CAAC;IACjB,UAAU,CAA4C;IACtD,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,MAAiB,EAAE,GAAW;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IAChB,CAAC;IAED,0CAA0C;IAC1C,QAAQ,CAAC,IAAsC;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,IAAY;QACjB,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACvC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBACjC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;YACnB,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IAED,kDAAkD;IAClD,UAAU;QACT,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACnG,CAAC;IAED,qDAAqD;IACrD,KAAK;QACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACvB,CAAC;IAEO,UAAU;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO;QAC1C,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC7B,CAAC;CACD"}

package/dist/conversation/writeBack.d.ts

@@ -0,0 +1,36 @@
+import type { MLBClient } from "../mlbClient.ts";
+import type { BuddyLogger, OutgoingMessage } from "../types.ts";
+export interface WriteBackDeps {
+    client: MLBClient;
+    key: string;
+    buddyId: string;
+    /** 本进程里这场会话的一次生命周期标识，进幂等键；重启后换一个，旧键不会撞新键 */
+    runId: string;
+    log: BuddyLogger;
+    /** 每次真正写平台之前先调一下（把攒着的 delta 发完，预览不落在正文后面） */
+    beforeSend: () => void;
+}
+export declare class WriteBack {
+    private readonly deps;
+    private queue;
+    /** 串行链正在跑 */
+    private sending;
+    /** 幂等键里的自增号 */
+    private sent;
+    private retryDelay;
+    /** close 时打断重发等待 */
+    private readonly abort;
+    /** 等队列清空的人 */
+    private waiters;
+    private closed;
+    constructor(deps: WriteBackDeps);
+    /** 入队即分配幂等键；退役后不收 */
+    enqueue(message: OutgoingMessage): void;
+    /** 等队列清空（或退役） */
+    flush(): Promise<void>;
+    /** 退役：正在退避等重发的立刻醒来并退出，队列清空 */
+    close(): void;
+    /** 一次发队头一条：delivered → 出队；rejected（4xx）→ warn 出队；throw（网络 / 5xx）→ 留队退避后带同一个键重发 */
+    private drain;
+}
+//# sourceMappingURL=writeBack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeBack.d.ts","sourceRoot":"","sources":["../../src/conversation/writeBack.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMhE,MAAM,WAAW,aAAa;IAC7B,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;IACjB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,KAAK,CAAyB;IACtC,aAAa;IACb,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,MAAM,CAAS;gBAEX,IAAI,EAAE,aAAa;IAI/B,qBAAqB;IACrB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAOvC,iBAAiB;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAMb,kFAAkF;YACpE,KAAK;CA2CnB"}