@qjp88995/agent-runtime 0.0.0-stage → 0.1.0

package/dist/turn/json-string-field.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 从一段**未必完整**的 JSON 文本里，线性扫描抽出某个顶层字符串字段的值。
+ *
+ * 用途：`tool-input-preview.ts` 拿模型正在吐的入参 JSON 原始文本片段
+ * （`tool-input-delta` 的累计），实时抽出白名单工具的字段，供对话页的稿栏
+ * 边写边显示——`Write` 抽 `path` 与 `content` 两个，`Edit` **只抽 `path`**
+ * （它的入参是替换对，没有可预览的正文，见 `TOOL_INPUT_PREVIEW_FIELDS` 里
+ * 那条 `text: null`）。AI SDK 的 `parsePartialJson` 是 `Promise`，而 onChunk
+ * 是同步回调，所以这里手写一个零依赖的同步版本。
+ *
+ * **两条判据，撑起「不必真解析 JSON」这条捷径**：
+ * 1. 合法 JSON 字符串值内部的裸 `"` 一定被转义成 `\"`——从头扫到的第一个
+ *    **裸** `"key"` 只可能是键本身，不会命中某个值里恰好等长的同名文本
+ *    （值里那份必然是 `\"key\"`，多两个反斜杠，字面不相等）。
+ * 2. 只服务白名单工具的**扁平**入参对象——要抽的字段都是顶层字符串字段
+ *    （`Write.path`/`Write.content`/`Edit.path`），不存在嵌套对象/数组里
+ *    同名键的歧义。`Edit` 另外那两个顶层字段（`old_string`/`new_string`）
+ *    这里根本不去抽，但它们同样是顶层字符串，不破坏这条前提。
+ *
+ * **加新白名单工具前，先核对它的入参 schema 仍满足这两条**：字段是顶层、
+ * 值是字符串、没有嵌套结构会带出同名键。不满足就不能简单套用这份线性扫描。
+ */
+export interface JsonStringFieldResult {
+    /** 已解析出的值（可能是尚未闭合的前缀）。 */
+    value: string;
+    /** 值的闭合引号是否已经到达——`false` 时 `value` 只是当前累计的前缀。 */
+    complete: boolean;
+}
+export declare function extractJsonStringField(raw: string, key: string): JsonStringFieldResult | null;
+//# sourceMappingURL=json-string-field.d.ts.map

package/dist/turn/json-string-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-string-field.d.ts","sourceRoot":"","sources":["../../src/turn/json-string-field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAWD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,qBAAqB,GAAG,IAAI,CA2F9B"}

package/dist/turn/json-string-field.js

@@ -0,0 +1,125 @@
+/**
+ * 从一段**未必完整**的 JSON 文本里，线性扫描抽出某个顶层字符串字段的值。
+ *
+ * 用途：`tool-input-preview.ts` 拿模型正在吐的入参 JSON 原始文本片段
+ * （`tool-input-delta` 的累计），实时抽出白名单工具的字段，供对话页的稿栏
+ * 边写边显示——`Write` 抽 `path` 与 `content` 两个，`Edit` **只抽 `path`**
+ * （它的入参是替换对，没有可预览的正文，见 `TOOL_INPUT_PREVIEW_FIELDS` 里
+ * 那条 `text: null`）。AI SDK 的 `parsePartialJson` 是 `Promise`，而 onChunk
+ * 是同步回调，所以这里手写一个零依赖的同步版本。
+ *
+ * **两条判据，撑起「不必真解析 JSON」这条捷径**：
+ * 1. 合法 JSON 字符串值内部的裸 `"` 一定被转义成 `\"`——从头扫到的第一个
+ *    **裸** `"key"` 只可能是键本身，不会命中某个值里恰好等长的同名文本
+ *    （值里那份必然是 `\"key\"`，多两个反斜杠，字面不相等）。
+ * 2. 只服务白名单工具的**扁平**入参对象——要抽的字段都是顶层字符串字段
+ *    （`Write.path`/`Write.content`/`Edit.path`），不存在嵌套对象/数组里
+ *    同名键的歧义。`Edit` 另外那两个顶层字段（`old_string`/`new_string`）
+ *    这里根本不去抽，但它们同样是顶层字符串，不破坏这条前提。
+ *
+ * **加新白名单工具前，先核对它的入参 schema 仍满足这两条**：字段是顶层、
+ * 值是字符串、没有嵌套结构会带出同名键。不满足就不能简单套用这份线性扫描。
+ */
+function isWhitespace(ch) {
+    return ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r';
+}
+/** 0xD800–0xDBFF：UTF-16 高代理，落单时是解码半个 emoji 留下的残片。 */
+function isHighSurrogate(code) {
+    return code >= 0xd800 && code <= 0xdbff;
+}
+export function extractJsonStringField(raw, key) {
+    const keyPattern = `"${key}"`;
+    const keyIdx = raw.indexOf(keyPattern);
+    if (keyIdx === -1)
+        return null;
+    let i = keyIdx + keyPattern.length;
+    while (i < raw.length && isWhitespace(raw[i]))
+        i++;
+    // 冒号还没到——「还没到」不是空串，是 null（调用方靠这个区分「值不存在」
+    // 与「值是空串」）。
+    if (i >= raw.length || raw[i] !== ':')
+        return null;
+    i++;
+    while (i < raw.length && isWhitespace(raw[i]))
+        i++;
+    // 值的开引号还没到（要么流还没吐到这，要么这个字段的值压根不是字符串，
+    // 比如数字/布尔/null）。两种情况调用方都只关心「拿不到」，统一 null。
+    if (i >= raw.length || raw[i] !== '"')
+        return null;
+    i++;
+    let value = '';
+    let complete = false;
+    scan: while (i < raw.length) {
+        const ch = raw[i];
+        if (ch === '"') {
+            complete = true;
+            break;
+        }
+        if (ch === '\\') {
+            const esc = raw[i + 1];
+            // 反斜杠是这一块的最后一个字符——转义序列还没收全，丢掉它等下一块，
+            // 不能当普通字符收进 value（那样会把半个转义原样吐给界面）。
+            if (esc === undefined)
+                break scan;
+            switch (esc) {
+                case '"':
+                    value += '"';
+                    i += 2;
+                    continue;
+                case '\\':
+                    value += '\\';
+                    i += 2;
+                    continue;
+                case '/':
+                    value += '/';
+                    i += 2;
+                    continue;
+                case 'b':
+                    value += '\b';
+                    i += 2;
+                    continue;
+                case 'f':
+                    value += '\f';
+                    i += 2;
+                    continue;
+                case 'n':
+                    value += '\n';
+                    i += 2;
+                    continue;
+                case 'r':
+                    value += '\r';
+                    i += 2;
+                    continue;
+                case 't':
+                    value += '\t';
+                    i += 2;
+                    continue;
+                case 'u': {
+                    const hex = raw.slice(i + 2, i + 6);
+                    // 4 位十六进制还没收全——同上，丢掉整个未完的 \u 序列。
+                    if (hex.length < 4)
+                        break scan;
+                    value += String.fromCharCode(parseInt(hex, 16));
+                    i += 6;
+                    continue;
+                }
+                default:
+                    // 非法转义：正常情况下不会出现（AI SDK 只吐合法 JSON 片段的前缀），
+                    // 稳妥起见按「未完成」处理，不猜测。
+                    break scan;
+            }
+        }
+        value += ch;
+        i++;
+    }
+    // 值还没闭合时，末尾可能停在一对 UTF-16 代理对中间（高代理已到、低代理
+    // 没到）——那半个字符单独渲染出来是一个替换符，等下一块到了又变回正常
+    // 字符，界面上会抖一下。裁掉它，等凑齐了再一起吐。
+    if (!complete && value.length > 0) {
+        const lastCode = value.charCodeAt(value.length - 1);
+        if (isHighSurrogate(lastCode))
+            value = value.slice(0, -1);
+    }
+    return { value, complete };
+}
+//# sourceMappingURL=json-string-field.js.map

package/dist/turn/json-string-field.js.map

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

package/dist/turn/loop-reminder.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 重复工具调用提醒的纯文本层：链怎么记、什么时候出声、说什么、以及注入模型时的
+ * 围栏。**不碰库、不调模型**——接线在 `agent-runtime.service.ts` 的自驱循环里，
+ * 落库在 `chat-turn.service.ts` 的宿主实现里。
+ *
+ * 盯的是**模型行为**：同一个 tick 内跨 step 反复拿一模一样的参数调同一个工具
+ * （Grep 同一个词三次、每次拿到同样的结果却没据此改变做法）。跟用户重复发消息
+ * 无关。
+ *
+ * **只提醒，不阻止。** 模型有时重复调用是对的（轮询一个还没就绪的东西），拦错了
+ * 它没有申辩余地；提醒错了它可以无视。这也是 `agent.maxSteps` 的柔性版本——现在
+ * 超过上限是直接 `break`，模型既不知道自己被截断了，也没得到任何改弦更张的提示。
+ * 真要加阻止是另一个机制（走工具层的拒绝、理由随 `role=tool` 的错误结果回去），
+ * 不在这里。
+ */
+/**
+ * 第几次连续重复才出声，以及出声的**递进**层级。
+ *
+ * 不是每次都喊：连着两次相同调用太常见（重试一个刚失败的写、等一个异步结果），
+ * 第三次才开始像是没在推进。此后间隔拉开，让模型有机会自己走出来——每一步都塞
+ * 一段劝告只会稀释它，还挤占上下文。
+ */
+export declare const LOOP_REMINDER_THRESHOLDS: readonly [3, 5, 8];
+/**
+ * 深度键排序后的入参串——**链的比较用它，完整不截断**。
+ *
+ * 键序不该影响判定：模型两次吐 `{"path":"a","limit":2}` 与
+ * `{"limit":2,"path":"a"}` 是同一次调用，按原始字节比会把一个死循环判成「换了
+ * 参数」。截断则是另一件事，只用于提醒**文案**里的预览（见 `previewJson`）——拿
+ * 截断串当链的键，两次只在第 200 个字符处不同的大 payload 会被判成同一次调用。
+ */
+export declare function stableToolInputKey(input: unknown): string;
+export interface RepeatCallChain {
+    /**
+     * 记一次工具调用，命中阈值时返回该说的那句话，否则 `null`。
+     *
+     * **在调用发起时记，与结果无关**：被拒绝的、报错的调用一样计数——模型反复撞
+     * 一个必失败的调用，正是最该提醒的循环。
+     */
+    note(toolName: string, input: unknown): string | null;
+}
+/**
+ * 建一条链。**一个 tick 一条**，就是 `turn-run.ts` 里 `TurnRun` 的一个字段
+ * ——那个对象一轮一个，链的生命周期因此跟着它走，不需要谁记得回收。
+ *
+ * 收窄到 tick 内的理由：那才是模型能连续犯错而没人打断的窗口。跨 tick 之间必然
+ * 夹着一条新消息（用户的，或子 Agent 回执），那本身就是链该重置的信号。收窄之后
+ * 也没有任何跨会话状态，不存在串味的可能。
+ */
+export declare function createRepeatCallChain(opts?: {
+    untracked?: ReadonlySet<string>;
+}): RepeatCallChain;
+/**
+ * 劝告文案。**说清三件事**：重复了几次、是哪次调用（工具名 + 参数预览，否则模型
+ * 在一步里调了好几个工具时根本对不上是哪个）、以及具体该怎么办。
+ *
+ * 措辞随次数**递进**，最后一档明确给出「停下来告诉用户」这条出路——一个已经绕了
+ * 八次的模型多半是缺一个体面的退出方式，而不是缺一次更严厉的批评。
+ */
+export declare function renderLoopAdvice(count: number, toolName: string, input: unknown): string;
+/**
+ * 落库的纯正文 → 注入模型的那份。**平台插进会话的 user 行共用这一副围栏**：
+ * 重复调用提醒的存量行（`LOOP_REMINDER_KIND`）与待办结账提醒
+ * （`TODO_REMINDER_KIND`，见 `extensions/todo-settle.hook.ts`）。
+ *
+ * 加围栏的理由与另外两处不完全相同：这段文字是**平台生成**的，不是不可信外部
+ * 输入。它要解决的是另一件事——这条行以 `role='user'` 进上下文（协议里没有别的
+ * 位置放得下它），不标注的话模型很可能把它当成用户在说话，转而向用户道歉、解释，
+ * 而不是改变自己的做法。围栏里来自模型的片段（参数预览、待办正文）照旧转义。
+ */
+export declare function wrapSystemReminder(text: string): string;
+/**
+ * 转义正文里的围栏标记，照 `escapeSubagentFence` 的既有做法在 `<` 后插反斜杠。
+ *
+ * 开闭标签**都要转**，且**替换串里绝不能再出现完整的标记**（`escapeFence` 第一版
+ * 写成「[已转义的 `</x>` 标记]」，等于把要防的东西原样放回去）。
+ */
+export declare function escapeLoopReminderFence(text: string): string;
+//# sourceMappingURL=loop-reminder.d.ts.map

package/dist/turn/loop-reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-reminder.d.ts","sourceRoot":"","sources":["../../src/turn/loop-reminder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,oBAAqB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASzD;AAYD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAO,GAC7C,eAAe,CA6BjB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,MAAM,CAqBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5D"}

package/dist/turn/loop-reminder.js.map

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

package/dist/turn/nul-safe.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 把文本里的 NUL（U+0000）换成 U+FFFD。
+ *
+ * **为什么要有它**：Postgres 的 jsonb 不收 `\u0000`（「\u0000 cannot be
+ * converted to text」），而 `chat_message.parts` 是 jsonb——一段带 NUL 的工具
+ * 输出（`Bash` 里 `cat` 一个二进制文件、沙箱按 UTF-8 解码的 stdout 原样带着
+ * NUL）会让这一轮的落库失败，`agent_run` 也跟着收不了尾，最后被孤儿清扫标成
+ * 「服务中断（进程重启）」——一个与真实原因毫不相干、会把排查带偏的结论。
+ *
+ * **换在哪里是这条的全部要点**：必须在「喂给模型」与「进事件账本（→ 落库、
+ * SSE）」分叉**之前**（`TurnRun.recordToolResult`）。在 `MessageHub` 落库前换
+ * 就晚了：本轮模型看到的是带 NUL 的原文，库里存的却是替换过的，下一轮重放
+ * 与本轮逐字不同——违反「模型看得见的一切都必须能从库里重建」，而且前缀缓存
+ * 从这一条起整段 miss。
+ *
+ * 换成 U+FFFD 而不是删掉：模型能看出「这里原本有东西、不是文本」，与 UTF-8
+ * 解码非法字节时的做法一致；删掉会把 `a\0b` 拼成 `ab`，造出一段文件里并不
+ * 存在的文本。
+ */
+export declare function replaceNul(text: string): string;
+//# sourceMappingURL=nul-safe.d.ts.map

package/dist/turn/nul-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nul-safe.d.ts","sourceRoot":"","sources":["../../src/turn/nul-safe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/turn/nul-safe.js

@@ -0,0 +1,23 @@
+/**
+ * 把文本里的 NUL（U+0000）换成 U+FFFD。
+ *
+ * **为什么要有它**：Postgres 的 jsonb 不收 `\u0000`（「\u0000 cannot be
+ * converted to text」），而 `chat_message.parts` 是 jsonb——一段带 NUL 的工具
+ * 输出（`Bash` 里 `cat` 一个二进制文件、沙箱按 UTF-8 解码的 stdout 原样带着
+ * NUL）会让这一轮的落库失败，`agent_run` 也跟着收不了尾，最后被孤儿清扫标成
+ * 「服务中断（进程重启）」——一个与真实原因毫不相干、会把排查带偏的结论。
+ *
+ * **换在哪里是这条的全部要点**：必须在「喂给模型」与「进事件账本（→ 落库、
+ * SSE）」分叉**之前**（`TurnRun.recordToolResult`）。在 `MessageHub` 落库前换
+ * 就晚了：本轮模型看到的是带 NUL 的原文，库里存的却是替换过的，下一轮重放
+ * 与本轮逐字不同——违反「模型看得见的一切都必须能从库里重建」，而且前缀缓存
+ * 从这一条起整段 miss。
+ *
+ * 换成 U+FFFD 而不是删掉：模型能看出「这里原本有东西、不是文本」，与 UTF-8
+ * 解码非法字节时的做法一致；删掉会把 `a\0b` 拼成 `ab`，造出一段文件里并不
+ * 存在的文本。
+ */
+export function replaceNul(text) {
+    return text.includes('\0') ? text.replaceAll('\0', '\uFFFD') : text;
+}
+//# sourceMappingURL=nul-safe.js.map

package/dist/turn/nul-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nul-safe.js","sourceRoot":"","sources":["../../src/turn/nul-safe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/turn/parts-from-events.d.ts

@@ -0,0 +1,71 @@
+import type { AgentEvent } from '../schema/agent-event.js';
+import { type MessagePart } from '../schema/index.js';
+/**
+ * 这次重建是不是这一轮的**最后一次**。
+ *
+ * - `'rescue'`（默认，兜底路径）：这一轮已经结束，buffer 里剩下的半截东西
+ *   （没等到 `text-end` 的文本、没等到 `tool-call` 的半截入参）再没有机会被
+ *   封口了，一并抢救出来——中断那一刻已经打出来的字不能丢。
+ * - `'hold'`（增量落库）：轮子还在跑，只交出**已被终止符封口**的 part，半截的
+ *   留在 buffer 里等下一次。这不是洁癖：一个 step 里模型可以并行发起多次调用，
+ *   而落库发生在**逐个**工具执行的间隙——第一次 flush 时第二个调用的入参才流到
+ *   一半，按 `'rescue'` 重建就会凭空落一条「模型从没发出过、参数还是半截 JSON」
+ *   的 tool-call part，等真正的 `tool-call` 事件到了再落一条真的，库里于是两条。
+ */
+export type PartsTail = 'rescue' | 'hold';
+/**
+ * 从事件账本重建 parts。**这是落库 parts 的唯一来源**：轮内由
+ * `turn-run.ts#flushStep` 带游标增量取（`tail: 'hold'`），**每一条终态路径**
+ * （正常收尾 / 中断 / 失败 / 门禁拒绝）在 `finish()` 里再取最后一次，那次用
+ * `tail: 'rescue'`。半截 tool call 也抢救出来 —— 先试 JSON.parse，失败就把
+ * 不完整的 JSON 字符串原样存下，便于排查。
+ *
+ * 曾经它只是兜底：主路径另有一套手工累积的 `acc.parts`，两者的等价性靠一句
+ * 注释担保（agent-x 的对应实现漏过 toolName，本仓漏过
+ * `isError`/`ref`/`systemNote`——事件 payload 里一直都有，是这里没读，而两边
+ * 都没有任何测试会红）。现在只剩这一条路，那族判据随之消失。
+ *
+ * **因此本函数的产出必须是「只增不改」的**：已经交出去的 part 不会因为后面又
+ * 来了事件而变形或改变位置——增量落库的游标正是建立在这条性质上（jsonb 追加
+ * 不幂等，落错了改不回来）。今天它成立是因为每种 part 都由一个明确的终止符
+ * 封口：文本靠 `text-end`、reasoning 靠「下一个非 reasoning-delta 事件」、
+ * 工具靠 `tool-call`/`tool-result` 事件本身。
+ *
+ * `reasoning-delta` 单独累积进 reasoningBuf（不与 textBuf 混）——deepseek 的
+ * reasoning 段可以很长，取消极易恰好落在纯 reasoning 阶段、后面再没有任何
+ * text-delta/tool-call 事件；若不认这个事件类型，这类中断会重建出**空** parts
+ * 数组（用户看到一条空白气泡）。`AGENT_EVENT_TYPES` 里没有 `reasoning-end`，
+ * 故 flush 时机改用"下一个非 reasoning-delta 事件到来即先 flush"这条通用规则
+ * （在 switch 之前统一处理），外加循环结束时的收尾 flush——这样即便流从头到
+ * 尾只有 reasoning-delta，也能落出一个 `{type:'reasoning'}` part。这不违反
+ * "reasoning 是回放给模型时唯一允许的有损项"：那条约束在 partsToModelMessages
+ * 里生效，落库层面留着 reasoning 是为了让用户看到取消前发生了什么。
+ *
+ * flushText() 的调用时机：`text-end` 与 `tool-call` 分支都会 flush，
+ * `tool-result` 分支不需要 ——一个 step 内 tool-result 前面必然已经有过
+ * 对应的 tool-call（tool-call 分支已经 flush 过一次），tool-result 本身
+ * 不携带新文本、也不会让 textBuf 重新累积。真正会在 tool-result 之后
+ * 又产生文本的情况，是模型在拿到结果后继续输出（"工具→结果→又有文本"），
+ * 这段新文本会走新的 text-delta 追加进 textBuf，直到下一次 text-end 或
+ * 循环结束时的收尾 flushText() 才落 part —— 顺序仍是
+ * text → tool-call → tool-result → text，与事件的时间顺序一致，未丢失。
+ */
+export declare function partsFromEventBuffer(events: readonly AgentEvent[], tail?: PartsTail): MessagePart[];
+/**
+ * 重建结果 + **退役边界**。
+ *
+ * `uptoSeq` = 被消费进已交出 part 的**最后一个事件**的 seq（没有交出任何 part
+ * 时为 null）：reasoning 段是它最后一条 `reasoning-delta`（封口它的那个事件
+ * 属于**下一段**，不算）、text 段是 `text-end`、工具是 `tool-call`/`tool-result`
+ * 事件本身。语义是「seq ≤ 它的事件，内容已经全部体现在这些 part 里」——落库成功
+ * 后会话流据此把这些事件退役（`StreamBus.retireUpTo`），刷新重建时它们由 DB 行
+ * 顶替、前端按 `metadata.flushedSeq` 把宽限期内重放的同一批事件丢掉。
+ *
+ * `'hold'` 模式下未封口的尾巴既不进 parts 也不推进边界——那正是「流里只剩未
+ * 落库的尾巴」这条不变量的另一半。
+ */
+export declare function partsFromEventBufferWithBoundary(events: readonly AgentEvent[], tail?: PartsTail): {
+    parts: MessagePart[];
+    uptoSeq: number | null;
+};
+//# sourceMappingURL=parts-from-events.d.ts.map

package/dist/turn/parts-from-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts-from-events.d.ts","sourceRoot":"","sources":["../../src/turn/parts-from-events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,oBAAoB,CAAC;AA6B5B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,IAAI,GAAE,SAAoB,GACzB,WAAW,EAAE,CAEf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,IAAI,GAAE,SAAoB,GACzB;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAyIlD"}

package/dist/turn/parts-from-events.js

@@ -0,0 +1,217 @@
+import { z } from 'zod';
+import { PartProviderMetadataSchema, ToolResultImageSchema, } from '../schema/index.js';
+/** `ref` 只接受对象形态（`MessagePart.ref` 是 `Record<string, unknown>`）。 */
+function isPlainRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+const ImagesSchema = z.array(ToolResultImageSchema).min(1);
+/**
+ * 工具调用上要回放的厂商 metadata（思考签名）。形状不对就不落——同 `images`：
+ * 进了库就是之后每一轮都发出去的东西。
+ */
+function providerMetadataFromPayload(v) {
+    if (v === undefined)
+        return {};
+    const parsed = PartProviderMetadataSchema.safeParse(v);
+    return parsed.success ? { providerMetadata: parsed.data } : {};
+}
+function imagesFromPayload(v) {
+    if (v === undefined)
+        return {};
+    const parsed = ImagesSchema.safeParse(v);
+    return parsed.success ? { images: parsed.data } : {};
+}
+/**
+ * 从事件账本重建 parts。**这是落库 parts 的唯一来源**：轮内由
+ * `turn-run.ts#flushStep` 带游标增量取（`tail: 'hold'`），**每一条终态路径**
+ * （正常收尾 / 中断 / 失败 / 门禁拒绝）在 `finish()` 里再取最后一次，那次用
+ * `tail: 'rescue'`。半截 tool call 也抢救出来 —— 先试 JSON.parse，失败就把
+ * 不完整的 JSON 字符串原样存下，便于排查。
+ *
+ * 曾经它只是兜底：主路径另有一套手工累积的 `acc.parts`，两者的等价性靠一句
+ * 注释担保（agent-x 的对应实现漏过 toolName，本仓漏过
+ * `isError`/`ref`/`systemNote`——事件 payload 里一直都有，是这里没读，而两边
+ * 都没有任何测试会红）。现在只剩这一条路，那族判据随之消失。
+ *
+ * **因此本函数的产出必须是「只增不改」的**：已经交出去的 part 不会因为后面又
+ * 来了事件而变形或改变位置——增量落库的游标正是建立在这条性质上（jsonb 追加
+ * 不幂等，落错了改不回来）。今天它成立是因为每种 part 都由一个明确的终止符
+ * 封口：文本靠 `text-end`、reasoning 靠「下一个非 reasoning-delta 事件」、
+ * 工具靠 `tool-call`/`tool-result` 事件本身。
+ *
+ * `reasoning-delta` 单独累积进 reasoningBuf（不与 textBuf 混）——deepseek 的
+ * reasoning 段可以很长，取消极易恰好落在纯 reasoning 阶段、后面再没有任何
+ * text-delta/tool-call 事件；若不认这个事件类型，这类中断会重建出**空** parts
+ * 数组（用户看到一条空白气泡）。`AGENT_EVENT_TYPES` 里没有 `reasoning-end`，
+ * 故 flush 时机改用"下一个非 reasoning-delta 事件到来即先 flush"这条通用规则
+ * （在 switch 之前统一处理），外加循环结束时的收尾 flush——这样即便流从头到
+ * 尾只有 reasoning-delta，也能落出一个 `{type:'reasoning'}` part。这不违反
+ * "reasoning 是回放给模型时唯一允许的有损项"：那条约束在 partsToModelMessages
+ * 里生效，落库层面留着 reasoning 是为了让用户看到取消前发生了什么。
+ *
+ * flushText() 的调用时机：`text-end` 与 `tool-call` 分支都会 flush，
+ * `tool-result` 分支不需要 ——一个 step 内 tool-result 前面必然已经有过
+ * 对应的 tool-call（tool-call 分支已经 flush 过一次），tool-result 本身
+ * 不携带新文本、也不会让 textBuf 重新累积。真正会在 tool-result 之后
+ * 又产生文本的情况，是模型在拿到结果后继续输出（"工具→结果→又有文本"），
+ * 这段新文本会走新的 text-delta 追加进 textBuf，直到下一次 text-end 或
+ * 循环结束时的收尾 flushText() 才落 part —— 顺序仍是
+ * text → tool-call → tool-result → text，与事件的时间顺序一致，未丢失。
+ */
+export function partsFromEventBuffer(events, tail = 'rescue') {
+    return partsFromEventBufferWithBoundary(events, tail).parts;
+}
+/**
+ * 重建结果 + **退役边界**。
+ *
+ * `uptoSeq` = 被消费进已交出 part 的**最后一个事件**的 seq（没有交出任何 part
+ * 时为 null）：reasoning 段是它最后一条 `reasoning-delta`（封口它的那个事件
+ * 属于**下一段**，不算）、text 段是 `text-end`、工具是 `tool-call`/`tool-result`
+ * 事件本身。语义是「seq ≤ 它的事件，内容已经全部体现在这些 part 里」——落库成功
+ * 后会话流据此把这些事件退役（`StreamBus.retireUpTo`），刷新重建时它们由 DB 行
+ * 顶替、前端按 `metadata.flushedSeq` 把宽限期内重放的同一批事件丢掉。
+ *
+ * `'hold'` 模式下未封口的尾巴既不进 parts 也不推进边界——那正是「流里只剩未
+ * 落库的尾巴」这条不变量的另一半。
+ */
+export function partsFromEventBufferWithBoundary(events, tail = 'rescue') {
+    const out = [];
+    let uptoSeq = null;
+    let textBuf = '';
+    let reasoningBuf = '';
+    // 这一段思考的时间窗，取自事件自带的 `ts`（主路径在 runtime 里现测，见
+    // turn-run.ts；这条兜底路径手里只有事件，正好够）。
+    let reasoningFirstTs = null;
+    let reasoningLastTs = 0;
+    let reasoningLastSeq = 0;
+    const pendingInput = new Map();
+    const emittedCalls = new Set();
+    const flushText = (seq) => {
+        if (textBuf) {
+            out.push({ type: 'text', text: textBuf });
+            uptoSeq = seq;
+            textBuf = '';
+        }
+    };
+    const flushReasoning = () => {
+        if (reasoningBuf) {
+            out.push({
+                type: 'reasoning',
+                text: reasoningBuf,
+                // 夹到非负——挂钟回拨会让差值变负（同 turn-run.ts）。
+                ...(reasoningFirstTs != null
+                    ? { durationMs: Math.max(0, reasoningLastTs - reasoningFirstTs) }
+                    : {}),
+            });
+            uptoSeq = reasoningLastSeq;
+            reasoningBuf = '';
+            reasoningFirstTs = null;
+        }
+    };
+    for (const e of events) {
+        const p = e.payload;
+        // reasoning 必然先于任何跟随其后的事件类型（无 reasoning-end 信号，
+        // 故一见到下一个非 reasoning-delta 事件就把它 flush 出去，保序）。
+        if (e.type !== 'reasoning-delta')
+            flushReasoning();
+        switch (e.type) {
+            case 'text-delta':
+                textBuf += typeof p.text === 'string' ? p.text : '';
+                break;
+            case 'reasoning-delta':
+                reasoningBuf += typeof p.text === 'string' ? p.text : '';
+                reasoningFirstTs ??= e.ts;
+                reasoningLastTs = e.ts;
+                reasoningLastSeq = e.seq;
+                break;
+            case 'text-end':
+                flushText(e.seq);
+                break;
+            case 'tool-input-start':
+                pendingInput.set(String(p.toolCallId), {
+                    toolName: String(p.toolName),
+                    raw: '',
+                });
+                break;
+            case 'tool-input-delta': {
+                const entry = pendingInput.get(String(p.toolCallId));
+                if (entry)
+                    entry.raw += typeof p.delta === 'string' ? p.delta : '';
+                break;
+            }
+            case 'tool-call':
+                flushText(e.seq);
+                pendingInput.delete(String(p.toolCallId));
+                emittedCalls.add(String(p.toolCallId));
+                out.push({
+                    type: 'tool-call',
+                    toolCallId: String(p.toolCallId),
+                    toolName: String(p.toolName),
+                    input: p.input,
+                    ...providerMetadataFromPayload(p.providerMetadata),
+                });
+                uptoSeq = e.seq;
+                break;
+            case 'tool-result':
+                uptoSeq = e.seq;
+                out.push({
+                    type: 'tool-result',
+                    toolCallId: String(p.toolCallId),
+                    toolName: String(p.toolName),
+                    output: p.output,
+                    // `isError` / `ref` / `systemNote` 三样事件 payload 里本来就有
+                    // （`recordToolResult` 一次 spread 同时喂事件与主路径 part），这条
+                    // 兜底路径以前只读 `output`，于是同一次调用走主路径落库带失败标记、
+                    // 走重建路径落库就是一条成功的结果。`isError` 尤其是红线级的：
+                    // 投影层按它选 `error-json` 变体（parts-to-model-messages.ts），
+                    // 丢了就等于下一轮把一次失败的工具调用当成功喂回模型。
+                    //
+                    // **逐个条件展开、不整体 spread**：主路径的 part 由
+                    // `{...outcome}` 得到，`ref`/`systemNote` 没有时是「键不存在」
+                    // （JSON 落库后同样不存在），照抄 undefined 会让两条路径的产物在
+                    // `toStrictEqual` 下分叉。
+                    ...(typeof p.isError === 'boolean' ? { isError: p.isError } : {}),
+                    ...(isPlainRecord(p.ref) ? { ref: p.ref } : {}),
+                    // `images` 同样来自事件 payload（`recordToolResult` 一次 spread）。
+                    // 过一遍 schema 而不是裸 cast：这条兜底路径重建的是要落库的行，一个
+                    // 形状不对的 src 进了库，下一轮投影就发出一个解析不了的引用。
+                    ...imagesFromPayload(p.images),
+                    // 钉住不许裁剪（`AgentTool.persistPinned`）。只认字面的 `true`。
+                    ...(p.pinned === true ? { pinned: true } : {}),
+                    ...(typeof p.systemNote === 'string'
+                        ? { systemNote: p.systemNote }
+                        : {}),
+                });
+                break;
+            default:
+                break;
+        }
+    }
+    // 轮子还在跑：半截的一律留在 buffer 里，等封口它的那个事件到了下一次再交
+    // （判据见 `PartsTail`）。
+    if (tail === 'hold')
+        return { parts: out, uptoSeq };
+    // 收尾：若流以纯 reasoning 结束（无后续事件触发过 flush），这里补上——
+    // 正是「取消恰好落在纯 reasoning 阶段」那个真实案例的落点。抢救出来的尾巴
+    // 把边界推到最后一个事件：这一轮已经结束，流里的一切都可以退役了。
+    const lastSeq = events.at(-1)?.seq ?? null;
+    flushReasoning();
+    flushText(lastSeq ?? 0);
+    // 抢救没等到 tool-call 的半截调用。
+    for (const [toolCallId, { toolName, raw }] of pendingInput) {
+        if (emittedCalls.has(toolCallId))
+            continue;
+        let input = raw;
+        try {
+            input = JSON.parse(raw);
+        }
+        catch {
+            // 保持原始字符串，便于排查截断点。
+        }
+        out.push({ type: 'tool-call', toolCallId, toolName, input });
+    }
+    if (out.length > 0 && lastSeq != null)
+        uptoSeq = lastSeq;
+    return { parts: out, uptoSeq };
+}
+//# sourceMappingURL=parts-from-events.js.map

package/dist/turn/parts-from-events.js.map

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