@qjp88995/agent-runtime 0.0.0-stage → 0.1.0

package/dist/turn/parts-to-model-messages.d.ts

@@ -0,0 +1,158 @@
+import type { JSONValue, ModelMessage, ToolResultPart } from 'ai';
+import { type MessagePart, type ToolResultImage } from '../schema/index.js';
+export interface StoredMessage {
+    role: string;
+    parts: MessagePart[];
+    /**
+     * 该行的 `chat_message.seq`。**只有裁剪/压缩投影用得上**（见
+     * `ProjectionOptions`），两个指针都不传时可以不给。
+     */
+    seq?: number;
+    /**
+     * 该行的 `chat_message.metadata.kind`。两个取值，都表示「这条 role='user' 的
+     * 行不是用户说的话」，投影时各自包上自己的围栏（见 `wrapStoredUserText`）：
+     * `COMPACTION_CHECKPOINT_KIND`（压缩产生的交接说明，另外还要提到最前面）与
+     * `LOOP_REMINDER_KIND`（重复调用提醒的存量行）与 `TODO_REMINDER_KIND`（待办
+     * 结账提醒），以及宿主自己登记的 `ProjectionOptions.reminderKinds`。其余行不带这个字段。
+     */
+    kind?: string | null;
+}
+export interface ProjectionOptions {
+    /**
+     * 裁剪指针（`chat_session.pruned_upto_seq`）：`seq ≤ 它`的行，tool-result
+     * 的正文换成存根。null/undefined = 不裁剪，逐字回到裁剪之前的行为。
+     */
+    prunedUptoSeq?: number | null;
+    /**
+     * 压缩指针（`chat_session.compacted_upto_seq`）：`seq ≤ 它`的行**整行不进
+     * 上下文**，由 checkpoint 行代表。null/undefined = 未压缩过。
+     *
+     * 比裁剪更靠后的一级：裁剪只丢工具结果正文，压缩连「调过什么工具」这条事实
+     * 一起换成一段自然语言。两个指针同时给时，压缩先生效（被压掉的行根本不会走到
+     * 裁剪那一步）。
+     */
+    compactedUptoSeq?: number | null;
+    /**
+     * 宿主自己往会话里塞的 user 行标记（`StoredMessage.kind`），投影时一律包 `<system-reminder>`
+     * 围栏（agent-base 分身线的开工消息与通知）。**当轮注入时怎么包，这里就得登记**，
+     * 否则重放时它以裸用户文字喂给模型、与当轮不再逐字相同。
+     */
+    reminderKinds?: readonly string[];
+    /**
+     * 旧工具名 → 现名（`ToolRegistry.toolNameAliases()`）。历史里 tool-call / tool-result 的
+     * `toolName` 命中旧名时换成现名：工具改过名之后，模型在同一段上下文里只该看到一个名字。
+     * 库里一个字节不动。
+     */
+    toolNameAliases?: ReadonlyMap<string, string>;
+}
+/**
+ * 被裁掉的工具结果在模型眼里长什么样。
+ *
+ * **保留工具名与调用参数、只丢正文**：正文才是体积（Read/Grep/Bash 那一族动辄
+ * 几万字符），而「我调过 Read('/workspace/x.md')」这件事只要几十个字符，却是模型
+ * 判断「要不要再跑一次」的全部依据。只留一句「结果已移除」而不说是哪次调用，
+ * 模型既想不起自己看过什么，也无从重跑。
+ *
+ * 文案明说是**为了腾空间**：这既不是工具失败，也不是结果过期。把预算行为写成
+ * 别的措辞，模型会据此下错结论（比如以为那个文件读不到了）。
+ */
+export declare function renderPrunedToolOutput(toolName: string, input: unknown): string;
+/**
+ * 一次工具结果在模型眼里长什么样：正文 + 平台针对这次调用追加的那句提示
+ * （`MessagePart.systemNote`，当前唯一来源是重复调用提醒）。
+ *
+ * **拼接只在这里发生**，落库存的是纯正文与独立字段（同 checkpoint /
+ * subagent-result 那条分工）。**内核本轮喂给模型的那份也走这个函数**——两条路
+ * 各拼一次的话，同一次调用在本轮与下一轮重放时会长得不一样，而「投影是纯函数」
+ * 正是要防这个。
+ *
+ * **不包 `<system-reminder>` 围栏**：那层围栏唯一的作用是解释「这不是用户在
+ * 说话」，而 tool-result 天然就是系统反馈，模型不会把它读成用户发言。前缀标记
+ * 只为把平台的话与工具正文分开，**它不是安全边界**（工具正文来自文件/网页，
+ * 完全可以伪造同样的字样）——可接受，因为这句话本身只是劝告，不拦任何东西。
+ *
+ * `output` 声明成 `unknown`：落库的正文历史上就是 `z.unknown()`（几乎总是
+ * string）。**非字符串时原样返回、绝不 `String()` 强转**——那会把一个对象变成
+ * `[object Object]` 喂给模型。
+ */
+export declare function withSystemNote(output: unknown, note: string | undefined): JSONValue;
+/**
+ * 投影层给图片打的引用命名空间。`FilePart.data = {type:'reference', reference:
+ * {[IMAGE_REFERENCE_KEY]: src}}` 会被 `ai` 核心原样透传到 provider prompt
+ * （已核 `ai@7.0.77` 的 `convertToLanguageModelV4FilePart`），由图片递送
+ * （`images/`，`resolveTurnModel` 包的模型）在请求前解析成 Files API 引用 / 公网 URL /
+ * base64。**没包递送时不会静默**：provider 包解析引用找不到自己的 key 会响亮地抛。
+ * （agent-base 里叫 `agentBase`；它只在投影时现生成、不落库，改名不影响历史。）
+ *
+ * 同一个 key 也用作 file part 的 `providerOptions` 命名空间，带上 `path`——那是
+ * 合成 user 消息里那句「这是哪张图」的材料，provider 包只读自己的命名空间、
+ * 对它视而不见。
+ */
+export declare const IMAGE_REFERENCE_KEY = "agentRuntime";
+/** `MessagePart.images[]` 的一张 → 投影层的 file part。 */
+export declare function imageFilePart(img: ToolResultImage): {
+    type: "file";
+    mediaType: string;
+    data: {
+        type: "reference";
+        reference: {
+            agentRuntime: string;
+        };
+    };
+    providerOptions: {
+        agentRuntime: {
+            path?: string | undefined;
+            src: string;
+        };
+    };
+};
+/**
+ * 一次工具结果 → 喂模型的 `ToolResultPart.output`。**轮内（`turn-run.ts`）
+ * 与重放（下面的投影）共用**，两条路各拼一次的话同一次调用在本轮与下一轮会长得
+ * 不一样，而「投影是纯函数」正是要防这个。
+ *
+ * 三个变体的判据：`isError` → `error-json`（裁剪不改它，那是「这次调用成功过
+ * 没有」的事实）；有图 → `content`（正文 + file 引用；正文非字符串时不进这支，
+ * `content` 的 text item 只收字符串）；其余 → `json`，与裁剪之前的行为逐字一致。
+ */
+export declare function toolResultOutput(args: {
+    output: unknown;
+    isError?: boolean;
+    systemNote?: string;
+    images?: ToolResultImage[];
+}): ToolResultPart['output'];
+/**
+ * 落库消息 → 喂模型的 ModelMessage[]。**必须无损**：工具调用与结果完整带回，
+ * 否则模型看不到自己上一轮调了什么工具、拿到什么结果（agent-x 的
+ * getMessagesForAI 正是栽在这里）。
+ *
+ * reasoning part **默认**丢弃 —— 各 provider 对 reasoning 的回放要求不同，
+ * 且当它只是补充材料时不是模型行为的必要输入。**但**若一条 assistant 消息
+ * 一个 text part 都没有（deepseek-v4-flash 偶发把整轮回复整段塞进
+ * reasoning_content、content 一个 token 都不产——真实数据取证：
+ * tokenUsage.outputTokenDetails 为 {textTokens:0, reasoningTokens:91}），
+ * 那么 reasoning 就是这一轮的全部回复，照旧丢弃会让下一轮模型看不到自己
+ * 说过什么（静默的对话记忆损坏，比"丢一点思考过程"严重得多，也违反本函数
+ * 头一句"必须无损"的硬约束）。故只在这唯一情形下把 reasoning 文本当正文
+ * 写进 content——写回的是普通 `{type:'text'}` content part，不是 provider
+ * 专属的 `reasoning_content` 字段，回放给任何 provider 都不会被拒收。
+ * 只要该条消息里有任意一个 text part，行为完全不变（reasoning 仍旧丢弃，
+ * 见下方测试 "keeps dropping reasoning when text is also present" 的护栏）。
+ * reasoning 规则**按段**套用（一轮一行后一条消息含多段）。
+ *
+ * **裁剪（`opts.prunedUptoSeq`）只换 tool-result 的正文，绝不删 part。**
+ * 删掉整个 tool-result 是这里最容易写出的错解：它编译通过、单测不看协议也照绿，
+ * 而结果是留下一个没有 result 的 tool_use —— 各家协议一律 400，且此后这个会话
+ * **每一次**发言都失败（历史只会越读越长），错误信息与真实原因毫无关系。下面
+ * `flushSegment` 里补齐无主 tool-call 的那段注释讲的是同一个坑的另一半。
+ *
+ * **压缩（`opts.compactedUptoSeq`）则是整行不进**，那是它与裁剪的分界：被压掉的
+ * 那段历史已经由 checkpoint 行整体代表了，留着半条只会让同一件事说两遍。切点只
+ * 落在行边界，故不会切出「有 tool_use 没 tool_result」——那是上一段那个 400 的
+ * 同一条约束。
+ *
+ * **本函数是纯函数**，这条是整套上下文预算的地基：给定 (rows, 指针)，喂给模型
+ * 的历史唯一确定，模型看到的一切都能从库里重建。
+ */
+export declare function partsToModelMessages(msgs: StoredMessage[], opts?: ProjectionOptions): ModelMessage[];
+//# sourceMappingURL=parts-to-model-messages.d.ts.map

package/dist/turn/parts-to-model-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts-to-model-messages.d.ts","sourceRoot":"","sources":["../../src/turn/parts-to-model-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAGZ,cAAc,EACf,MAAM,IAAI,CAAC;AAEZ,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAK5B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC;;;;OAIG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,SAAS,CAGX;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe;;;;;;;;;;;;;;;EAejD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B,GAAG,cAAc,CAAC,QAAQ,CAAC,CAa3B;AA6DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EAAE,EACrB,IAAI,GAAE,iBAAsB,GAC3B,YAAY,EAAE,CAiKhB"}

package/dist/turn/parts-to-model-messages.js

@@ -0,0 +1,334 @@
+import { COMPACTION_CHECKPOINT_KIND, LOOP_REMINDER_KIND, TODO_REMINDER_KIND, } from '../schema/index.js';
+import { wrapCompactionSummary } from './compaction.js';
+import { previewJson } from './json-preview.js';
+import { wrapSystemReminder } from './loop-reminder.js';
+/**
+ * 被裁掉的工具结果在模型眼里长什么样。
+ *
+ * **保留工具名与调用参数、只丢正文**：正文才是体积（Read/Grep/Bash 那一族动辄
+ * 几万字符），而「我调过 Read('/workspace/x.md')」这件事只要几十个字符，却是模型
+ * 判断「要不要再跑一次」的全部依据。只留一句「结果已移除」而不说是哪次调用，
+ * 模型既想不起自己看过什么，也无从重跑。
+ *
+ * 文案明说是**为了腾空间**：这既不是工具失败，也不是结果过期。把预算行为写成
+ * 别的措辞，模型会据此下错结论（比如以为那个文件读不到了）。
+ */
+export function renderPrunedToolOutput(toolName, input) {
+    return `[结果已从上下文中移出以腾出空间。工具：${toolName}，参数：${previewJson(input)}]`;
+}
+/**
+ * 一次工具结果在模型眼里长什么样：正文 + 平台针对这次调用追加的那句提示
+ * （`MessagePart.systemNote`，当前唯一来源是重复调用提醒）。
+ *
+ * **拼接只在这里发生**，落库存的是纯正文与独立字段（同 checkpoint /
+ * subagent-result 那条分工）。**内核本轮喂给模型的那份也走这个函数**——两条路
+ * 各拼一次的话，同一次调用在本轮与下一轮重放时会长得不一样，而「投影是纯函数」
+ * 正是要防这个。
+ *
+ * **不包 `<system-reminder>` 围栏**：那层围栏唯一的作用是解释「这不是用户在
+ * 说话」，而 tool-result 天然就是系统反馈，模型不会把它读成用户发言。前缀标记
+ * 只为把平台的话与工具正文分开，**它不是安全边界**（工具正文来自文件/网页，
+ * 完全可以伪造同样的字样）——可接受，因为这句话本身只是劝告，不拦任何东西。
+ *
+ * `output` 声明成 `unknown`：落库的正文历史上就是 `z.unknown()`（几乎总是
+ * string）。**非字符串时原样返回、绝不 `String()` 强转**——那会把一个对象变成
+ * `[object Object]` 喂给模型。
+ */
+export function withSystemNote(output, note) {
+    if (!note || typeof output !== 'string')
+        return output;
+    return `${output}\n\n[系统提醒] ${note}`;
+}
+/**
+ * 投影层给图片打的引用命名空间。`FilePart.data = {type:'reference', reference:
+ * {[IMAGE_REFERENCE_KEY]: src}}` 会被 `ai` 核心原样透传到 provider prompt
+ * （已核 `ai@7.0.77` 的 `convertToLanguageModelV4FilePart`），由图片递送
+ * （`images/`，`resolveTurnModel` 包的模型）在请求前解析成 Files API 引用 / 公网 URL /
+ * base64。**没包递送时不会静默**：provider 包解析引用找不到自己的 key 会响亮地抛。
+ * （agent-base 里叫 `agentBase`；它只在投影时现生成、不落库，改名不影响历史。）
+ *
+ * 同一个 key 也用作 file part 的 `providerOptions` 命名空间，带上 `path`——那是
+ * 合成 user 消息里那句「这是哪张图」的材料，provider 包只读自己的命名空间、
+ * 对它视而不见。
+ */
+export const IMAGE_REFERENCE_KEY = 'agentRuntime';
+/** `MessagePart.images[]` 的一张 → 投影层的 file part。 */
+export function imageFilePart(img) {
+    return {
+        type: 'file',
+        mediaType: img.mediaType,
+        data: {
+            type: 'reference',
+            reference: { [IMAGE_REFERENCE_KEY]: img.src },
+        },
+        providerOptions: {
+            [IMAGE_REFERENCE_KEY]: {
+                src: img.src,
+                ...(img.path !== undefined ? { path: img.path } : {}),
+            },
+        },
+    };
+}
+/**
+ * 一次工具结果 → 喂模型的 `ToolResultPart.output`。**轮内（`turn-run.ts`）
+ * 与重放（下面的投影）共用**，两条路各拼一次的话同一次调用在本轮与下一轮会长得
+ * 不一样，而「投影是纯函数」正是要防这个。
+ *
+ * 三个变体的判据：`isError` → `error-json`（裁剪不改它，那是「这次调用成功过
+ * 没有」的事实）；有图 → `content`（正文 + file 引用；正文非字符串时不进这支，
+ * `content` 的 text item 只收字符串）；其余 → `json`，与裁剪之前的行为逐字一致。
+ */
+export function toolResultOutput(args) {
+    const value = withSystemNote(args.output, args.systemNote);
+    if (args.isError)
+        return { type: 'error-json', value };
+    if (args.images && args.images.length > 0 && typeof value === 'string') {
+        // 文本项先单独建：直接写在数组字面量里时，ai 7.0.169 起 typescript-eslint 的
+        // no-deprecated 会把它的 `type` 按上下文联合解析到已废弃的变体上（误报）。
+        const text = { type: 'text', text: value };
+        return {
+            type: 'content',
+            value: [text, ...args.images.map(imageFilePart)],
+        };
+    }
+    return { type: 'json', value };
+}
+/**
+ * 一条落库的 user 行在模型眼里长什么样。
+ *
+ * **围栏按 `kind` 拼，不按「调用方传了什么选项」**：这两类行只要出现在历史里就
+ * 必须带围栏——checkpoint 是模型自己写的自由文本，提醒里夹着模型自己写的参数，
+ * 裸拼的话它们与平台的话在字节层面无从区分。落库存的都是纯正文（见各自 kind
+ * 常量的说明：落库的是数据，围栏是给模型看的呈现层，否则前端还得把标签剥回去）。
+ */
+function wrapStoredUserText(kind, text, reminderKinds) {
+    if (kind === COMPACTION_CHECKPOINT_KIND)
+        return wrapCompactionSummary(text);
+    if (kind === LOOP_REMINDER_KIND || kind === TODO_REMINDER_KIND) {
+        return wrapSystemReminder(text);
+    }
+    // 宿主登记的提醒行：当轮按 `system_reminder` 一律包围栏，重放必须同样包。
+    if (kind != null && reminderKinds.includes(kind)) {
+        return wrapSystemReminder(text);
+    }
+    return text;
+}
+/**
+ * 压缩投影：丢掉阴影区里的整行，并把 checkpoint 提到最前面。
+ *
+ * **提头不是排版偏好，是因果顺序。** checkpoint 行是压缩完才插进去的，拿的是
+ * 当时最大的 seq，按序号排它会落在**保留下来的那段历史之后** —— 模型读到的就是
+ * 「最近几轮对话… 然后是一段更早的摘要」。倒过来的因果最直接的后果是它把摘要
+ * 里那些已经被后续对话推翻的结论当成最新决定，而这件事不会报错，只会让它答得
+ * 越来越不对。
+ *
+ * 至多一条 checkpoint 能活下来，这由切点规则保证（新的压缩切点必须覆盖上一条
+ * checkpoint，见 `ContextBudgetTracker.compact`）。真出现第二条时这里只提最早
+ * 的那条、后一条留在原位——降级而不是抛错：那毕竟只是历史顺序不理想，不值得
+ * 让整个会话从此发不出话。
+ */
+function applyCompaction(msgs, compactedUpto) {
+    if (compactedUpto === null)
+        return msgs;
+    const surviving = [];
+    for (const msg of msgs) {
+        if (msg.seq == null) {
+            // 同下面裁剪那条：**不静默跳过**。静默的症状只有「账单变贵」。
+            throw new Error('partsToModelMessages: compactedUptoSeq given but a message has no seq');
+        }
+        if (msg.seq <= compactedUpto)
+            continue;
+        surviving.push(msg);
+    }
+    const at = surviving.findIndex(m => m.kind === COMPACTION_CHECKPOINT_KIND);
+    if (at <= 0)
+        return surviving;
+    return [surviving[at], ...surviving.slice(0, at), ...surviving.slice(at + 1)];
+}
+/**
+ * 落库消息 → 喂模型的 ModelMessage[]。**必须无损**：工具调用与结果完整带回，
+ * 否则模型看不到自己上一轮调了什么工具、拿到什么结果（agent-x 的
+ * getMessagesForAI 正是栽在这里）。
+ *
+ * reasoning part **默认**丢弃 —— 各 provider 对 reasoning 的回放要求不同，
+ * 且当它只是补充材料时不是模型行为的必要输入。**但**若一条 assistant 消息
+ * 一个 text part 都没有（deepseek-v4-flash 偶发把整轮回复整段塞进
+ * reasoning_content、content 一个 token 都不产——真实数据取证：
+ * tokenUsage.outputTokenDetails 为 {textTokens:0, reasoningTokens:91}），
+ * 那么 reasoning 就是这一轮的全部回复，照旧丢弃会让下一轮模型看不到自己
+ * 说过什么（静默的对话记忆损坏，比"丢一点思考过程"严重得多，也违反本函数
+ * 头一句"必须无损"的硬约束）。故只在这唯一情形下把 reasoning 文本当正文
+ * 写进 content——写回的是普通 `{type:'text'}` content part，不是 provider
+ * 专属的 `reasoning_content` 字段，回放给任何 provider 都不会被拒收。
+ * 只要该条消息里有任意一个 text part，行为完全不变（reasoning 仍旧丢弃，
+ * 见下方测试 "keeps dropping reasoning when text is also present" 的护栏）。
+ * reasoning 规则**按段**套用（一轮一行后一条消息含多段）。
+ *
+ * **裁剪（`opts.prunedUptoSeq`）只换 tool-result 的正文，绝不删 part。**
+ * 删掉整个 tool-result 是这里最容易写出的错解：它编译通过、单测不看协议也照绿，
+ * 而结果是留下一个没有 result 的 tool_use —— 各家协议一律 400，且此后这个会话
+ * **每一次**发言都失败（历史只会越读越长），错误信息与真实原因毫无关系。下面
+ * `flushSegment` 里补齐无主 tool-call 的那段注释讲的是同一个坑的另一半。
+ *
+ * **压缩（`opts.compactedUptoSeq`）则是整行不进**，那是它与裁剪的分界：被压掉的
+ * 那段历史已经由 checkpoint 行整体代表了，留着半条只会让同一件事说两遍。切点只
+ * 落在行边界，故不会切出「有 tool_use 没 tool_result」——那是上一段那个 400 的
+ * 同一条约束。
+ *
+ * **本函数是纯函数**，这条是整套上下文预算的地基：给定 (rows, 指针)，喂给模型
+ * 的历史唯一确定，模型看到的一切都能从库里重建。
+ */
+export function partsToModelMessages(msgs, opts = {}) {
+    const out = [];
+    const prunedUpto = opts.prunedUptoSeq ?? null;
+    const aliases = opts.toolNameAliases;
+    const nameOf = (toolName) => aliases?.get(toolName) ?? toolName;
+    for (const msg of applyCompaction(msgs, opts.compactedUptoSeq ?? null)) {
+        if (prunedUpto !== null && msg.seq == null) {
+            // **不静默跳过裁剪**：那样机制会在「看起来一切正常」的情况下整个失效，
+            // 唯一的症状是账单变贵。调用方要么给全 seq，要么根本别传指针。
+            throw new Error('partsToModelMessages: prunedUptoSeq given but a message has no seq');
+        }
+        const shadowed = prunedUpto !== null && msg.seq <= prunedUpto;
+        if (msg.role === 'user') {
+            // 用户文本原样喂给模型。`@` 引用的文件在**写入时**就已经改写成内联的
+            // `<file …>` 标签留在这段文字里（`session-file-ref.service.ts`），所以
+            // 这里不需要、也不该再做一次渲染——落库的文本就是模型看到的文本。
+            const text = msg.parts
+                .filter((p) => p.type === 'text')
+                .map(p => p.text)
+                .join('');
+            out.push({
+                role: 'user',
+                content: wrapStoredUserText(msg.kind, text, opts.reminderKinds ?? []),
+            });
+            continue;
+        }
+        if (msg.role !== 'assistant')
+            continue;
+        // 一条 assistant 消息可能跨多个 step（一轮一行）。以「已收集过
+        // tool-result 后再遇到 text/reasoning/tool-call」为 step 边界，逐段
+        // flush 出 (assistant, tool) 对，重建原来的行边界、保住因果顺序。
+        let assistantContent = [];
+        let toolOutputs = [];
+        let hasText = false;
+        let reasoningChunks = [];
+        let sawToolResult = false;
+        // 存根要带上「这次调用的参数」，而参数在同一行的 tool-call part 上。整行先
+        // 扫一遍建索引，不去依赖「tool-result 与它的 tool-call 必在同一段」——那条
+        // 性质当前成立，但让这里与 flushSegment 的切段规则耦合，改切段就会静默
+        // 丢掉参数。
+        const callInputs = new Map();
+        if (shadowed) {
+            for (const p of msg.parts) {
+                if (p.type === 'tool-call')
+                    callInputs.set(p.toolCallId, p.input);
+            }
+        }
+        const flushSegment = () => {
+            if (!hasText && reasoningChunks.length > 0) {
+                assistantContent.unshift({
+                    type: 'text',
+                    text: reasoningChunks.join(''),
+                });
+            }
+            // **补齐无主的 tool-call**。落库是增量的（`turn-run.ts` 的
+            // `flushStep`：发出 tool-call 就写一次，工具可能再跑几分钟），所以进程在
+            // 工具执行途中被杀，库里就留下一条有调用、没结果的记录。各家协议都要求
+            // 每个 tool_use 配一个 tool_result，缺一个就是整条请求 400 ——而历史只会
+            // 越读越长，这个会话从此**每一次**发言都失败，且错误信息与真实原因毫无
+            // 关系。
+            //
+            // 合成一条错误结果而不是把 tool-call 删掉：删掉等于告诉模型它从没调过这个
+            // 工具，它多半会原样再调一次（若那是个有副作用的写操作，就是重复执行）；
+            // 合成的这条如实说明"没跑完"，模型自己决定重试还是换路。
+            const answered = new Set(toolOutputs.map(o => o.toolCallId));
+            for (const c of assistantContent) {
+                if (c.type !== 'tool-call' || answered.has(c.toolCallId))
+                    continue;
+                toolOutputs.push({
+                    type: 'tool-result',
+                    toolCallId: c.toolCallId,
+                    toolName: c.toolName,
+                    output: {
+                        type: 'error-json',
+                        value: '该工具调用没有留下结果（服务中断），执行是否生效未知。',
+                    },
+                });
+            }
+            if (assistantContent.length > 0) {
+                out.push({ role: 'assistant', content: assistantContent });
+            }
+            if (toolOutputs.length > 0) {
+                out.push({ role: 'tool', content: toolOutputs });
+            }
+            assistantContent = [];
+            toolOutputs = [];
+            hasText = false;
+            reasoningChunks = [];
+            sawToolResult = false;
+        };
+        for (const part of msg.parts) {
+            if (part.type === 'text' ||
+                part.type === 'reasoning' ||
+                part.type === 'tool-call') {
+                if (sawToolResult)
+                    flushSegment(); // 新 step 开始
+            }
+            if (part.type === 'text') {
+                assistantContent.push({ type: 'text', text: part.text });
+                hasText = true;
+            }
+            else if (part.type === 'reasoning') {
+                reasoningChunks.push(part.text);
+            }
+            else if (part.type === 'tool-call') {
+                assistantContent.push({
+                    type: 'tool-call',
+                    toolCallId: part.toolCallId,
+                    toolName: nameOf(part.toolName),
+                    input: part.input,
+                    // 思考签名这类厂商要求原样带回的数据（只有适配器声明过的命名空间才会
+                    // 落库，见 `MessagePart.providerMetadata`）。轮内回喂的那份是同一个值。
+                    ...(part.providerMetadata && {
+                        providerOptions: part.providerMetadata,
+                    }),
+                });
+            }
+            else if (part.type === 'tool-result') {
+                // `pinned` 的结果不换存根（当前唯一来源：`Ask` 回写的结局）：
+                // 裁剪的前提是「正文是体积、丢了可以重跑」，而那是一两句话的**用户决定**，
+                // 裁掉之后模型无从重新得知。判据与置位方见 `MessagePart.pinned`。
+                const pruned = shadowed && part.pinned !== true;
+                // **`systemNote` 不跟着正文换存根**：裁剪的目的是省体积，而它极短，
+                // 且是「当时确实提醒过」这件事的记录——换掉它等于让模型在被裁剪过的
+                // 历史里读到一次没人提醒过的死循环。
+                //
+                // **图跟着正文一起卸**：裁剪指针推过去，`images` 就不进投影——这正是
+                // 图挂在 tool-result 上的收益（零新机制就有了一级卸载）。投影仍是同一条
+                // tool-result、条数不变，`ContextBudgetTracker.prune` 那道条数守卫因此
+                // 不会触发；合成的 user 消息在 provider prompt 层才出现，不在这里。
+                toolOutputs.push({
+                    type: 'tool-result',
+                    toolCallId: part.toolCallId,
+                    toolName: nameOf(part.toolName),
+                    // **裁剪不改 `isError`**：那是「这次调用成功过没有」的事实，与正文
+                    // 还在不在无关。把裁掉的失败调用投影成成功，模型会把一个从没生效的
+                    // 写操作当成已完成。
+                    output: toolResultOutput({
+                        output: pruned
+                            ? renderPrunedToolOutput(nameOf(part.toolName), callInputs.get(part.toolCallId))
+                            : part.output,
+                        isError: part.isError,
+                        systemNote: part.systemNote,
+                        images: pruned ? undefined : part.images,
+                    }),
+                });
+                sawToolResult = true;
+            }
+        }
+        flushSegment(); // 收尾最后一段
+    }
+    return out;
+}
+//# sourceMappingURL=parts-to-model-messages.js.map

package/dist/turn/parts-to-model-messages.js.map

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

package/dist/turn/pending-work.d.ts

@@ -0,0 +1,10 @@
+import type { ModelMessage } from 'ai';
+/**
+ * 会话是否还有「待模型响应」的输入。纯从 messages 推导（无状态），
+ * 使 loop 的终止判定在 crash/重启后仍正确：
+ * - 结尾 'user'：用户消息未答 → 待响应。
+ * - 结尾 'tool'：工具结果待模型跟进 → 待响应。
+ * - 结尾 'assistant'：已给最终答复（无待办工具）→ 不待响应。
+ */
+export declare function hasPendingWork(messages: ModelMessage[]): boolean;
+//# sourceMappingURL=pending-work.d.ts.map

package/dist/turn/pending-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-work.d.ts","sourceRoot":"","sources":["../../src/turn/pending-work.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAIhE"}

package/dist/turn/pending-work.js

@@ -0,0 +1,14 @@
+/**
+ * 会话是否还有「待模型响应」的输入。纯从 messages 推导（无状态），
+ * 使 loop 的终止判定在 crash/重启后仍正确：
+ * - 结尾 'user'：用户消息未答 → 待响应。
+ * - 结尾 'tool'：工具结果待模型跟进 → 待响应。
+ * - 结尾 'assistant'：已给最终答复（无待办工具）→ 不待响应。
+ */
+export function hasPendingWork(messages) {
+    const last = messages[messages.length - 1];
+    if (!last)
+        return false;
+    return last.role === 'user' || last.role === 'tool';
+}
+//# sourceMappingURL=pending-work.js.map

package/dist/turn/pending-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-work.js","sourceRoot":"","sources":["../../src/turn/pending-work.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAwB;IACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;AACtD,CAAC"}

package/dist/turn/provider-error.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 拿到这一步**真正**的失败原因。
+ *
+ * `streamError` 是调用方从 `streamText` 的 `onError` 里接住的那个错误。判据
+ * 刻意窄——**只有** `err` 是那个无信息的 `NoOutputGeneratedError` 壳、且这一步
+ * 确实记到过流内错误时才替换。abort 走的是另一条（SDK 用 `abortSignal.reason`
+ * reject），不会被这里误伤。
+ */
+export declare function unwrapInferenceError(err: unknown, streamError: unknown): unknown;
+/**
+ * 把错误说成一句用户能看懂、运维能定位的中文。
+ *
+ * 落进 `TurnResult.error`（→ `chat_message.metadata.error` 与零产出时的占位
+ * 气泡）。**始终带上服务商原话**：归一化只是给前面加一句「该干什么」，把原文
+ * 抹掉就等于让运维去猜。
+ */
+export declare function describeProviderError(err: unknown): string;
+/**
+ * 传输层断连的判据：**响应流读到一半，连接没了**。
+ *
+ * 这一类错误不是 HTTP 错误——没有状态码，AI SDK 的请求级重试（只认
+ * `APICallError.isRetryable`，且只包着「发起请求」那一步）罩不到它；流式响应
+ * 里它经 `onError` 冒出来，原始形状是 Node 内置 HTTP 客户端 undici 的
+ * `TypeError: terminated`（对端关闭）或 `ECONNRESET`（连接被重置），真正的
+ * 原因挂在 `cause` 链上。2026-09-09 线上 deepseek 一次 555 秒的轮次就是这么
+ * 死的：前 5 步正常，第 6 次调模型读流中途 `terminated`，整轮 failed。
+ *
+ * **判据刻意窄**：只认「已经建立的连接中途断开」这一族（code 表 + undici 的几句
+ * 原话），不认连接建立阶段的失败（`fetch failed` / `ECONNREFUSED` / DNS）——
+ * 那些发生在请求阶段，SDK 自己已经退避重试过了，到这里的是它放弃之后的
+ * `RetryError`，再重试一轮只是把同一个死结多绕三圈。也**不认 abort**：用户按
+ * 停止走的是 `AbortError`，那是有人要它停，不是链路坏了。
+ *
+ * 顺着 `cause` 链看（最多 8 层）：undici 把 `SocketError` 包在 `TypeError`
+ * 里，只看最外层的 message 会漏掉 `ECONNRESET` 这种只在里层出现的 code。
+ */
+export declare function isTransportError(err: unknown): boolean;
+/**
+ * 把 `cause` 链摊平成一行给日志：`TypeError: terminated ← SocketError: other
+ * side closed [UND_ERR_SOCKET]`。`String(err)` 只有最外层那句，而对传输层错误
+ * 来说最外层恰恰是信息量最低的一层——线上那次日志里只剩一个 `terminated`，
+ * 连是对端正常关闭还是被重置都分不出来。
+ */
+export declare function describeErrorChain(err: unknown): string;
+//# sourceMappingURL=provider-error.d.ts.map

package/dist/turn/provider-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-error.d.ts","sourceRoot":"","sources":["../../src/turn/provider-error.ts"],"names":[],"mappings":"AAsCA;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,OAAO,GACnB,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAe1D;AASD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAYtD;AAkBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAkBvD"}