@qjp88995/agent-runtime 0.0.0-stage → 0.1.1

package/dist/turn/chunk-projection.js

@@ -0,0 +1,62 @@
+/**
+ * AI SDK chunk → 内层领域事件。只投影**流式增量**事件（文本/推理/工具入参
+ * 的实时构建），供 SSE 边打字边显示。
+ *
+ * **零内核状态、零时序约束**：它是 SDK chunk 的机械翻译，进度记账那半边也只
+ * 认自己手里的 tracker。故它住在 loop 外面。
+ *
+ * **不投影 `tool-call` / `tool-result`**：自驱 loop 喂 streamText 的是无
+ * execute 的 schema 工具集，SDK 因此永不产 `tool-result` chunk（无执行→无
+ * 结果），而 `tool-call` 由 loop 在拿到确定的 `step.toolCalls` 后**权威地**
+ * 发出（连同真实执行结果的 `tool-result`）。若这里也投影 `tool-call`，会与
+ * loop 那条重复投递；tool-result 又必须发在 step-finish 之前（见 `TurnRun`
+ * 里的说明），onChunk 里做不到这个时序。故这两类统一归 loop 掌管。
+ *
+ * `progress`/`preview` 两个 tracker 各管一条事件（`tool-input-progress`
+ * 答「写了多少」、`tool-input-preview` 答「写了什么」），互不知道对方，
+ * 这里各喂一遍。
+ */
+export function projectChunk(chunk, journal, progress, preview) {
+    switch (chunk.type) {
+        case 'text-delta':
+            journal.append('text-delta', { text: chunk.text });
+            break;
+        case 'reasoning-delta':
+            journal.append('reasoning-delta', { text: chunk.text });
+            break;
+        case 'tool-input-start':
+            progress.start(chunk.id, chunk.toolName);
+            preview.start(chunk.id, chunk.toolName);
+            journal.append('tool-input-start', {
+                toolCallId: chunk.id,
+                toolName: chunk.toolName,
+            });
+            break;
+        case 'tool-input-delta': {
+            // 原始增量**逐块原样发**，一个字节不省：`parts-from-events.ts` 的 abort
+            // 兜底靠累积它来重建中断处那个半截的 tool-call。
+            journal.append('tool-input-delta', {
+                toolCallId: chunk.id,
+                delta: chunk.delta,
+            });
+            // 另发一条节流后的进度供界面用，见 tool-input-progress.ts。
+            const p = progress.delta(chunk.id, chunk.delta);
+            if (p)
+                journal.append('tool-input-progress', p);
+            // 白名单工具（Write 带正文、Edit 只带路径）再发一条内容预览，
+            // 见 tool-input-preview.ts。
+            const pv = preview.delta(chunk.id, chunk.delta);
+            if (pv)
+                journal.append('tool-input-preview', pv);
+            break;
+        }
+        default:
+            // 其余判别联合成员（'text-end'/'source'/'raw'/'start'/'start-step'/
+            // 'finish-step'/'finish'/'tool-call'/'tool-result'/... —— 数量随 SDK
+            // 版本变）一律不投影。'tool-call'/'tool-result' 见函数头：它们改由
+            // loop 权威发出，不在这里投影。刻意跳过；以 'ai' 包当前版本的
+            // TextStreamPart 类型定义为准，不要在这里维护清单。
+            break;
+    }
+}
+//# sourceMappingURL=chunk-projection.js.map

package/dist/turn/chunk-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-projection.js","sourceRoot":"","sources":["../../src/turn/chunk-projection.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAkB,EAClB,OAAoB,EACpB,QAAkC,EAClC,OAAgC;IAEhC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM;QACR,KAAK,iBAAiB;YACpB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM;QACR,KAAK,kBAAkB;YACrB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE;gBACjC,UAAU,EAAE,KAAK,CAAC,EAAE;gBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;YACH,MAAM;QACR,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,sDAAsD;YACtD,+BAA+B;YAC/B,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE;gBACjC,UAAU,EAAE,KAAK,CAAC,EAAE;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YACH,2CAA2C;YAC3C,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;YAChD,sCAAsC;YACtC,2BAA2B;YAC3B,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,EAAE;gBAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM;QACR,CAAC;QACD;YACE,2DAA2D;YAC3D,kEAAkE;YAClE,gDAAgD;YAChD,sCAAsC;YACtC,mCAAmC;YACnC,MAAM;IACV,CAAC;AACH,CAAC"}

package/dist/turn/compaction.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 上下文压缩的纯文本层：给模型的压缩指令、checkpoint 的围栏、以及「这份摘要
+ * 值不值得用」的判据。**不碰库、不调模型**——那两样在 `agent-chat` 那边
+ * （`ContextBudgetTracker.compact`）。
+ *
+ * 与 `context-budget.ts` 的分工：那边算「切点切在哪」，这边管「切下来那段
+ * 变成什么」。
+ */
+/**
+ * 落库的纯摘要正文 → 注入模型的那份。
+ *
+ * 落库不带围栏（见 `COMPACTION_CHECKPOINT_KIND` 的说明）：围栏是给模型看的呈现
+ * 层，落进 `chat_message` 的话前端渲染这张卡时还得把标签剥回去。
+ */
+export declare function wrapCompactionSummary(summary: string): string;
+/**
+ * 发给模型的压缩指令。**追加在会话前缀的末尾**，前面逐字重放同一份 system
+ * prompt、同一份工具定义、同样的历史 —— 这样这次调用能命中 provider 的 warm
+ * prefix，只有这一条指令是新的。反过来（另起一个精简 prompt 去摘要）看着省
+ * token，实际是整个前缀重新计费。
+ *
+ * 八个小节照抄 dsh 那份（它跑过真实负载）改中文，另加两条我们自己必须有的：
+ * 「逐字保留用户的原话与纠正」和「已有 checkpoint 要合并而不是抄下来」——后者
+ * 不写死的话，每压缩一次 checkpoint 就长一截，最后它自己变成体积来源。
+ */
+export declare const COMPACTION_INSTRUCTION = "\u8BF7\u505C\u4E0B\u5F53\u524D\u4EFB\u52A1\uFF0C\u4E0D\u8981\u56DE\u5E94\u4E0A\u9762\u7684\u5BF9\u8BDD\uFF0C\u4E5F\u4E0D\u8981\u8C03\u7528\u4EFB\u4F55\u5DE5\u5177\u3002\n\n\u628A\u5230\u76EE\u524D\u4E3A\u6B62\u7684\u6574\u6BB5\u5BF9\u8BDD\u538B\u7F29\u6210\u4E00\u4EFD**\u4EA4\u63A5\u8BF4\u660E**\uFF0C\u8BA9\u4E00\u4E2A\u770B\u4E0D\u5230\u539F\u59CB\u5BF9\u8BDD\u7684\u4EBA\u80FD\u63A5\u624B\u5E76\u65E0\u7F1D\u7EE7\u7EED\u8FD9\u9879\u5DE5\u4F5C\u3002\n\n\u6309\u4E0B\u5217\u5C0F\u8282\u8F93\u51FA\uFF0C\u6BCF\u4E00\u8282\u90FD\u7528\u5BF9\u8BDD\u91CC\u51FA\u73B0\u8FC7\u7684\u5177\u4F53\u540D\u79F0\u3001\u8DEF\u5F84\u3001\u6807\u8BC6\u7B26\uFF0C\u4E0D\u8981\u5199\u300C\u67D0\u4E2A\u6587\u4EF6\u300D\u300C\u76F8\u5173\u914D\u7F6E\u300D\u8FD9\u7C7B\u5360\u4F4D\u8BF4\u6CD5\uFF1B\u67D0\u4E00\u8282\u786E\u5B9E\u6CA1\u6709\u5185\u5BB9\u5C31\u5199\u300C\u65E0\u300D\u3002\n\n1. **\u7528\u6237\u7684\u76EE\u6807**\uFF1A\u7528\u6237\u60F3\u8FBE\u6210\u4EC0\u4E48\uFF0C\u5305\u62EC\u4E2D\u9014\u6539\u53D8\u8FC7\u7684\u76EE\u6807\u3002\n2. **\u7528\u6237\u7684\u539F\u8BDD\u4E0E\u7EA0\u6B63**\uFF1A\u9010\u5B57\u4FDD\u7559\u7528\u6237\u63D0\u51FA\u7684\u5173\u952E\u8981\u6C42\u3001\u504F\u597D\u4E0E\u7EA0\u6B63\u610F\u89C1\u3002\u7EA0\u6B63\u5C24\u5176\u91CD\u8981\u2014\u2014\u90A3\u662F\u6700\u5BB9\u6613\u5728\u538B\u7F29\u91CC\u4E22\u6389\u3001\u4E22\u6389\u4E4B\u540E\u4EE3\u4EF7\u6700\u5927\u7684\u4E1C\u897F\uFF08\u63A5\u624B\u7684\u4EBA\u4F1A\u628A\u5DF2\u7ECF\u88AB\u5426\u6389\u7684\u505A\u6CD5\u518D\u505A\u4E00\u904D\uFF09\u3002\n3. **\u5DF2\u7ECF\u5B8C\u6210\u7684\u5DE5\u4F5C**\uFF1A\u505A\u4E86\u4EC0\u4E48\uFF0C\u7ED3\u679C\u662F\u4EC0\u4E48\u3002\n4. **\u5F53\u524D\u8FDB\u884C\u5230\u54EA\u4E00\u6B65**\uFF1A\u6B63\u5728\u505A\u7684\u4E8B\uFF0C\u4EE5\u53CA\u505A\u5230\u4EC0\u4E48\u7A0B\u5EA6\u3002\n5. **\u6D89\u53CA\u7684\u6587\u4EF6\u4E0E\u8D44\u6E90**\uFF1A\u8DEF\u5F84\u3001id\u3001\u540D\u79F0\uFF0C\u4EE5\u53CA\u5404\u81EA\u5728\u8FD9\u4EF6\u4E8B\u91CC\u7684\u4F5C\u7528\u3002\n6. **\u5173\u952E\u51B3\u5B9A\u4E0E\u7406\u7531**\uFF1A\u4E3A\u4EC0\u4E48\u8FD9\u4E48\u9009\uFF0C\u4EE5\u53CA\u54EA\u4E9B\u65B9\u6848\u88AB\u5426\u51B3\u3001\u56E0\u4E3A\u4EC0\u4E48\u3002\n7. **\u9047\u5230\u7684\u95EE\u9898**\uFF1A\u51FA\u8FC7\u4EC0\u4E48\u9519\u3001\u600E\u4E48\u5904\u7406\u7684\u3001\u54EA\u4E9B\u8FD8\u6CA1\u89E3\u51B3\u3002\n8. **\u4E0B\u4E00\u6B65**\uFF1A\u63A5\u624B\u7684\u4EBA\u5E94\u8BE5\u7ACB\u523B\u505A\u4EC0\u4E48\u3002\n\n\u786C\u6027\u8981\u6C42\uFF1A\n\n- \u53EA\u8F93\u51FA\u8FD9\u4EFD\u8BF4\u660E\u672C\u8EAB\u3002\u4E0D\u8981\u5F00\u573A\u767D\u3001\u4E0D\u8981\u7ED3\u675F\u8BED\uFF0C\u4E5F\u4E0D\u8981\u63D0\u5230\u300C\u538B\u7F29\u300D\u300C\u6458\u8981\u300D\u8FD9\u4EF6\u4E8B\u672C\u8EAB\u3002\n- \u5982\u679C\u4E0A\u9762\u7684\u5BF9\u8BDD\u91CC\u5DF2\u7ECF\u6709\u4E00\u6BB5 <compacted-summary>\uFF0C\u90A3\u662F\u66F4\u65E9\u4E00\u6B21\u7684\u540C\u7C7B\u8BF4\u660E\uFF1A\u628A\u5B83\u548C\u5B83\u4E4B\u540E\u53D1\u751F\u7684\u4E8B**\u5408\u5E76**\u6210\u4E00\u4EFD\uFF0C\u4FDD\u7559\u4ECD\u7136\u6210\u7ACB\u7684\u5185\u5BB9\u3001\u5220\u6389\u5DF2\u7ECF\u8FC7\u671F\u6216\u88AB\u63A8\u7FFB\u7684\u5185\u5BB9\u3002\u4E0D\u8981\u539F\u6837\u6284\u4E0B\u6765\uFF0C\u4E5F\u4E0D\u8981\u4E3A\u5B83\u53E6\u8D77\u4E00\u8282\u3002\n- \u4E0D\u8981\u81C6\u9020\u5BF9\u8BDD\u91CC\u6CA1\u6709\u7684\u4FE1\u606F\u3002\u4E0D\u786E\u5B9A\u7684\u5C31\u5199\u300C\u4E0D\u786E\u5B9A\u300D\u3002";
+export interface SummaryVerdict {
+    ok: boolean;
+    /** 不接受时给出理由，供日志——静默丢弃一次模型调用是最贵的那种沉默。 */
+    reason?: string;
+}
+/**
+ * 这份摘要能不能用。
+ *
+ * 两条，都不是形式检查：
+ *
+ * - **空的不能用**。模型可能压根没写文本（把工具定义当成了要调的东西、或者
+ *   整段产出都进了 reasoning）。拿空串当 checkpoint 落库，等于把那段历史直接
+ *   删了，而且删得悄无声息。
+ * - **不比源短就不能用**。压缩的全部意义是腾空间；一份和原文一样长的「摘要」
+ *   换进去，下一步照样超线，而我们已经为它付了一次全量请求的钱，还断了前缀
+ *   缓存。这种情况多半是模型把对话原样复述了一遍。
+ *
+ * 比的是字符数而不是 token：两边同一口径、只求相对大小（同
+ * `measureModelMessageChars`）。
+ */
+export declare function judgeSummary(summary: string, sourceChars: number): SummaryVerdict;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/turn/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/turn/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,q2GAmBP,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,cAAc,CAYhB"}

package/dist/turn/compaction.js

@@ -0,0 +1,89 @@
+/**
+ * 上下文压缩的纯文本层：给模型的压缩指令、checkpoint 的围栏、以及「这份摘要
+ * 值不值得用」的判据。**不碰库、不调模型**——那两样在 `agent-chat` 那边
+ * （`ContextBudgetTracker.compact`）。
+ *
+ * 与 `context-budget.ts` 的分工：那边算「切点切在哪」，这边管「切下来那段
+ * 变成什么」。
+ */
+/**
+ * 围栏标签名。**必须是固定字符串**——同 `<subagent-result>` 那条判据：这段正文
+ * 是模型自己写的自由文本，只有一个字节层面可判定的边界，才谈得上「摘要在哪里
+ * 结束、平台的话从哪里开始」。
+ */
+const FENCE_TAG = 'compacted-summary';
+/**
+ * 围栏里那句解释。**必须说明原始消息去哪了**：只丢一段摘要进去，模型会把它当成
+ * 「有人转述了一件事」，而不是「这就是你自己那段对话的全部」——两者对「要不要
+ * 重新去读一遍那个文件」的判断完全不同。
+ */
+const FENCE_NOTE = '以下是本次对话更早部分的交接说明。原始消息已从上下文中移出以腾出空间，' +
+    '它们不会再回来；请把这份说明当作已经发生过的事实继续工作。';
+/**
+ * 落库的纯摘要正文 → 注入模型的那份。
+ *
+ * 落库不带围栏（见 `COMPACTION_CHECKPOINT_KIND` 的说明）：围栏是给模型看的呈现
+ * 层，落进 `chat_message` 的话前端渲染这张卡时还得把标签剥回去。
+ */
+export function wrapCompactionSummary(summary) {
+    return `<${FENCE_TAG}>\n${FENCE_NOTE}\n\n${summary}\n</${FENCE_TAG}>`;
+}
+/**
+ * 发给模型的压缩指令。**追加在会话前缀的末尾**，前面逐字重放同一份 system
+ * prompt、同一份工具定义、同样的历史 —— 这样这次调用能命中 provider 的 warm
+ * prefix，只有这一条指令是新的。反过来（另起一个精简 prompt 去摘要）看着省
+ * token，实际是整个前缀重新计费。
+ *
+ * 八个小节照抄 dsh 那份（它跑过真实负载）改中文，另加两条我们自己必须有的：
+ * 「逐字保留用户的原话与纠正」和「已有 checkpoint 要合并而不是抄下来」——后者
+ * 不写死的话，每压缩一次 checkpoint 就长一截，最后它自己变成体积来源。
+ */
+export const COMPACTION_INSTRUCTION = `请停下当前任务，不要回应上面的对话，也不要调用任何工具。
+
+把到目前为止的整段对话压缩成一份**交接说明**，让一个看不到原始对话的人能接手并无缝继续这项工作。
+
+按下列小节输出，每一节都用对话里出现过的具体名称、路径、标识符，不要写「某个文件」「相关配置」这类占位说法；某一节确实没有内容就写「无」。
+
+1. **用户的目标**：用户想达成什么，包括中途改变过的目标。
+2. **用户的原话与纠正**：逐字保留用户提出的关键要求、偏好与纠正意见。纠正尤其重要——那是最容易在压缩里丢掉、丢掉之后代价最大的东西（接手的人会把已经被否掉的做法再做一遍）。
+3. **已经完成的工作**：做了什么，结果是什么。
+4. **当前进行到哪一步**：正在做的事，以及做到什么程度。
+5. **涉及的文件与资源**：路径、id、名称，以及各自在这件事里的作用。
+6. **关键决定与理由**：为什么这么选，以及哪些方案被否决、因为什么。
+7. **遇到的问题**：出过什么错、怎么处理的、哪些还没解决。
+8. **下一步**：接手的人应该立刻做什么。
+
+硬性要求：
+
+- 只输出这份说明本身。不要开场白、不要结束语，也不要提到「压缩」「摘要」这件事本身。
+- 如果上面的对话里已经有一段 <${FENCE_TAG}>，那是更早一次的同类说明：把它和它之后发生的事**合并**成一份，保留仍然成立的内容、删掉已经过期或被推翻的内容。不要原样抄下来，也不要为它另起一节。
+- 不要臆造对话里没有的信息。不确定的就写「不确定」。`;
+/**
+ * 这份摘要能不能用。
+ *
+ * 两条，都不是形式检查：
+ *
+ * - **空的不能用**。模型可能压根没写文本（把工具定义当成了要调的东西、或者
+ *   整段产出都进了 reasoning）。拿空串当 checkpoint 落库，等于把那段历史直接
+ *   删了，而且删得悄无声息。
+ * - **不比源短就不能用**。压缩的全部意义是腾空间；一份和原文一样长的「摘要」
+ *   换进去，下一步照样超线，而我们已经为它付了一次全量请求的钱，还断了前缀
+ *   缓存。这种情况多半是模型把对话原样复述了一遍。
+ *
+ * 比的是字符数而不是 token：两边同一口径、只求相对大小（同
+ * `measureModelMessageChars`）。
+ */
+export function judgeSummary(summary, sourceChars) {
+    const text = summary.trim();
+    if (text.length === 0) {
+        return { ok: false, reason: '模型没有产出任何文本' };
+    }
+    if (text.length >= sourceChars) {
+        return {
+            ok: false,
+            reason: `摘要不比源短（${text.length} ≥ ${sourceChars} 字符）`,
+        };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=compaction.js.map

package/dist/turn/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/turn/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,GACd,qCAAqC;IACrC,+BAA+B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,IAAI,SAAS,MAAM,UAAU,OAAO,OAAO,OAAO,SAAS,GAAG,CAAC;AACxE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;mBAkBnB,SAAS;4BACA,CAAC;AAQ7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,WAAmB;IAEnB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;QAC/B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,UAAU,IAAI,CAAC,MAAM,MAAM,WAAW,MAAM;SACrD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/turn/context-overflow.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 这个错误是不是「上下文超限」。
+ *
+ * 只认 `APICallError`：那是「请求真的发出去了、服务端明确拒绝了」。网络中断、
+ * JSON 解析失败之类的错误哪怕文案里恰好带这些词，也与上下文大小无关。
+ *
+ * 状态码不作为判据的必要条件——各家在 400 / 413 之间并不一致，而措辞本身已经
+ * 足够窄了。
+ */
+export declare function isContextOverflowError(err: unknown): boolean;
+//# sourceMappingURL=context-overflow.d.ts.map

package/dist/turn/context-overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-overflow.d.ts","sourceRoot":"","sources":["../../src/turn/context-overflow.ts"],"names":[],"mappings":"AAwCA;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI5D"}

package/dist/turn/context-overflow.js

@@ -0,0 +1,53 @@
+import { APICallError } from 'ai';
+/**
+ * 「provider 说上下文装不下了」的归一化判据。
+ *
+ * 各家的措辞完全不同，而且都埋在一个 400 的 `responseBody` 里，没有任何一家给出
+ * 可判定的错误码。不认出它的后果不是「这一轮失败」那么轻——历史只会越读越长，
+ * 这个会话从此**每一次**发言都以同一条错误结束，而错误信息与真实原因毫无关系。
+ *
+ * **住在 agent-core 而不是 `modules/llm`**：判据的输入是 AI SDK 的 `APICallError`，
+ * 内核本来就依赖 `ai` 包；反过来依赖我们自己的 llm 领域模块才是内核该避开的
+ * （见 `LlmProviderOptions` 的注释）。
+ */
+/**
+ * 各家的原话（都是 HTTP 400 的 body）。**逐条都对应一家真实的措辞**，别为了
+ * 「更保险」往里加宽泛的词：
+ *
+ * - `too many tokens` 会命中限流错误（"Rate limit reached … tokens per min"），
+ *   那是等一会儿就好的事，拿它去压缩历史等于为一次限流永久丢掉一段对话。
+ * - 只写 `token limit` 会命中 `max_tokens` 参数非法之类的配置错误。
+ *
+ * 漏判的代价是「这一轮失败」（用户重发一次即可，且下一轮的阈值检查多半会自己
+ * 腾出空间）；误判的代价是**无缘无故压掉一段历史**且不可逆。两边不对称，故宁可
+ * 窄。
+ */
+const OVERFLOW_PATTERNS = [
+    // OpenAI 系（含大量兼容实现）：错误码本身，以及那句 message。
+    /context_length_exceeded/i,
+    /maximum context length/i,
+    // Anthropic：`prompt is too long: 213000 tokens > 200000 maximum`
+    /prompt is too long/i,
+    // Moonshot / Kimi
+    /exceeded model token limit/i,
+    // 通义千问：`Range of input length should be [1, 129024]`
+    /range of input length/i,
+    // 部分兼容实现给的建议句
+    /reduce the length of the messages/i,
+];
+/**
+ * 这个错误是不是「上下文超限」。
+ *
+ * 只认 `APICallError`：那是「请求真的发出去了、服务端明确拒绝了」。网络中断、
+ * JSON 解析失败之类的错误哪怕文案里恰好带这些词，也与上下文大小无关。
+ *
+ * 状态码不作为判据的必要条件——各家在 400 / 413 之间并不一致，而措辞本身已经
+ * 足够窄了。
+ */
+export function isContextOverflowError(err) {
+    if (!APICallError.isInstance(err))
+        return false;
+    const haystack = `${err.message}\n${err.responseBody ?? ''}`;
+    return OVERFLOW_PATTERNS.some(p => p.test(haystack));
+}
+//# sourceMappingURL=context-overflow.js.map

package/dist/turn/context-overflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-overflow.js","sourceRoot":"","sources":["../../src/turn/context-overflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,iBAAiB,GAAa;IAClC,wCAAwC;IACxC,0BAA0B;IAC1B,yBAAyB;IACzB,iEAAiE;IACjE,qBAAqB;IACrB,kBAAkB;IAClB,6BAA6B;IAC7B,qDAAqD;IACrD,wBAAwB;IACxB,cAAc;IACd,oCAAoC;CACrC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;IAC7D,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/turn/context-pressure.d.ts

@@ -0,0 +1,100 @@
+import type { ModelMessage, ToolSet } from 'ai';
+/**
+ * 一次「真要调模型」那一刻的上下文压力观测值，由内核测、交给宿主判断。
+ *
+ * **内核不认识阈值、模型容量、也不认识库**：它只知道 provider 上一步报了多少
+ * input token、以及那之后又往 `messages` 里追加了多少字符。要不要腾空间、腾到
+ * 哪儿，全是宿主（`agent-chat`）的事。
+ */
+export interface ContextPressure {
+    /**
+     * 上一步 provider 报的**真实** `inputTokens` —— 我们不需要像别家那样用启发式
+     * 估上下文大小，provider 每一步都把准确数字告诉了我们。
+     *
+     * `null` = 本轮还没调过模型（宿主此时该退回跨轮基线，见
+     * `ContextBudgetTracker`）。**跨轮基线是另一个数**（`TurnResult.contextTokens`
+     * = 末步 input + 末步 output）：那条回复已经在轮初的历史快照里了，而这里的
+     * `charsSinceLastStep` 是从 `loadContext` 之后才开始数的，补不到它。轮内则相反
+     * ——本步的产出会被 `charsSinceLastStep` 数进去，所以这里必须是**纯 input**，
+     * 加上 output 就是重复计。
+     *
+     * **不能拿落库的 `chat_message.tokenUsage.inputTokens` 当这个值**：`addUsage`
+     * 逐键求和，那一列是整轮各 step 的 input **之和**（增量落库那条路上
+     * `onAssistantStep` 压根没接 usage 参数，落库的只有 `usageAcc`）。
+     *
+     * 单步轮次两者相等，**多步轮次按步数放大**——真库取证，同一会话相邻两轮：
+     * 单步那轮 18,488，紧接着 6 个 tool-call 的那轮 91,104（4.9×，按同会话单步值
+     * 反推是 4–5 步 × 每步 18–23k）。危险的正是这种轮次：一个工具密集的 tick 之后，
+     * 下一轮开头会拿着一个放大数倍的基线，在远未接近容量时就开始裁剪。
+     */
+    lastStepInputTokens: number | null;
+    /**
+     * 上一次测量之后追加进 `messages` 的字符数（工具结果、drain 进来的消息、本步
+     * 产出的文本）。宿主按 `chars / 4` 折成 token 补在基线上。
+     *
+     * 这个折算对中文是**低估**的（一个汉字往往就是一个 token），方向是「晚一点
+     * 触发」而不是「早触发」：下一步 provider 报回真实值时会立刻纠正，阈值本身又
+     * 留了 20% 余量，真撞爆还有溢出补救兜底。反过来高估会让长会话无谓地反复裁剪，
+     * 每裁一次断一次前缀缓存。
+     */
+    charsSinceLastStep: number;
+    /**
+     * **此刻正要发出去的那份请求**。宿主腾不出空间、要改走压缩时，摘要那一次调用
+     * 就逐字重放它——同一份 instructions、同一份工具定义、同样的历史，**只在末尾
+     * 追加一条压缩指令**。
+     *
+     * 这样摘要请求能命中 provider 的 warm prefix，未命中的只有最后那条指令。反过来
+     * （另起一个精简 prompt 去摘要）看着省 token，实际是把整个前缀重新计费一遍，
+     * 而压缩恰恰发生在前缀最长的时候。
+     *
+     * 内核把这三样原样递出去，**不解释也不重组**：它不知道宿主会不会用、用来干
+     * 什么。`tools` 一并给是因为工具定义也在序列化后的前缀里，少给一样就不是同一个
+     * 前缀了。
+     */
+    request: {
+        system: string;
+        messages: readonly ModelMessage[];
+        tools: ToolSet;
+        /** 本轮的中断信号——压缩是一次完整的模型调用，用户按停止时它也该停。 */
+        abortSignal?: AbortSignal;
+    };
+    /**
+     * **provider 刚刚已经拒了这个请求**（上下文装不下）。
+     *
+     * 为真时宿主要跳过一切阈值判断直接腾空间：阈值是我们对「快满了」的猜测，而这
+     * 一刻已经不是猜测了 —— 它替我们判定了必要性，也顺带覆盖了「模型没填
+     * `max_context_tokens`、平时压根不主动裁」的那一类会话。
+     *
+     * 腾不出来时宿主返回 null，内核随即把 provider 的原始错误原样抛出。**不允许
+     * 「没推进也重试」**：那是一个原地打转的重试环，每转一圈都是一次全量请求。
+     */
+    overflowed?: boolean;
+}
+/**
+ * 宿主腾出空间的结果：用 `head` 替换掉 `messages` 开头的 `replaces` 条。
+ *
+ * **两级腾法共用这一个返回形状**：裁剪时 `head.length === replaces`（只换
+ * tool-result 的正文，条数不变），压缩时 `head` 只有一条 checkpoint、`replaces`
+ * 是它顶掉的那一整段。内核对这个差别一无所知，splice 一句话通吃。
+ *
+ * **只替换头部、绝不重新投影整个数组**：`messages` 的尾部有 drain 进来的消息，
+ * 那些在内存里用的是 `modelParts`（子 Agent 回执的围栏形态），与落库的 `parts`
+ * 不同 —— 重新查库投影一遍会把围栏静默抹掉。
+ *
+ * 对齐成立的理由：`messages` 一开始就是「轮初那批行的投影」，之后所有追加都在
+ * 尾部，所以头部前缀与那批行的投影逐字对应。
+ */
+export interface ContextRelief {
+    head: ModelMessage[];
+    /** 被 `head` 替换掉的原头部条数。 */
+    replaces: number;
+}
+/**
+ * `messages` 的字符规模。只用于取**差值**（见 `charsSinceLastStep`），所以
+ * 逐 part 序列化带来的那点结构开销是常量、会在相减时抵消掉，不必精确。
+ *
+ * 刻意不 `JSON.stringify(messages)` 一把梭：长会话的历史是 MB 级，每步造一个
+ * 那么大的临时字符串没必要。
+ */
+export declare function measureModelMessageChars(messages: ModelMessage[]): number;
+//# sourceMappingURL=context-pressure.d.ts.map

package/dist/turn/context-pressure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pressure.d.ts","sourceRoot":"","sources":["../../src/turn/context-pressure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;;;;OAQG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;;;;OAYG;IACH,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC;QACf,wCAAwC;QACxC,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,CAAC;IACF;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAYzE"}

package/dist/turn/context-pressure.js

@@ -0,0 +1,21 @@
+/**
+ * `messages` 的字符规模。只用于取**差值**（见 `charsSinceLastStep`），所以
+ * 逐 part 序列化带来的那点结构开销是常量、会在相减时抵消掉，不必精确。
+ *
+ * 刻意不 `JSON.stringify(messages)` 一把梭：长会话的历史是 MB 级，每步造一个
+ * 那么大的临时字符串没必要。
+ */
+export function measureModelMessageChars(messages) {
+    let total = 0;
+    for (const m of messages) {
+        if (typeof m.content === 'string') {
+            total += m.content.length;
+            continue;
+        }
+        for (const part of m.content) {
+            total += JSON.stringify(part)?.length ?? 0;
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=context-pressure.js.map

package/dist/turn/context-pressure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pressure.js","sourceRoot":"","sources":["../../src/turn/context-pressure.ts"],"names":[],"mappings":"AA8FA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAwB;IAC/D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAClC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7B,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/turn/events-to-steps.d.ts

@@ -0,0 +1,8 @@
+import type { AgentEvent } from '../schema/agent-event.js';
+import type { AgentRunStepEntry } from '../schema/index.js';
+/**
+ * 事件流 → 步级明细。**只取属于该 runId 的事件** ——
+ * 子 agent 与父同流，必须按 runId 切分。
+ */
+export declare function eventsToSteps(events: readonly AgentEvent[], runId: string): AgentRunStepEntry[];
+//# sourceMappingURL=events-to-steps.d.ts.map

package/dist/turn/events-to-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-to-steps.d.ts","sourceRoot":"","sources":["../../src/turn/events-to-steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,KAAK,EAAE,MAAM,GACZ,iBAAiB,EAAE,CA6DrB"}

package/dist/turn/events-to-steps.js

@@ -0,0 +1,64 @@
+import { flattenUsage } from './usage.js';
+/**
+ * 事件流 → 步级明细。**只取属于该 runId 的事件** ——
+ * 子 agent 与父同流，必须按 runId 切分。
+ */
+export function eventsToSteps(events, runId) {
+    const mine = events.filter(e => e.runId === runId);
+    const steps = [];
+    let text = '';
+    let calls = [];
+    const byCallId = new Map();
+    const flush = (usage) => {
+        if (!text && calls.length === 0 && !usage)
+            return;
+        steps.push({
+            index: steps.length,
+            text: text || undefined,
+            toolCalls: calls,
+            usage,
+        });
+        text = '';
+        calls = [];
+        byCallId.clear();
+    };
+    for (const e of mine) {
+        const p = e.payload;
+        switch (e.type) {
+            case 'text-delta':
+                text += typeof p.text === 'string' ? p.text : '';
+                break;
+            case 'tool-call': {
+                const entry = {
+                    toolCallId: String(p.toolCallId),
+                    toolName: String(p.toolName),
+                    input: p.input,
+                };
+                calls.push(entry);
+                byCallId.set(entry.toolCallId, entry);
+                break;
+            }
+            case 'tool-result': {
+                const entry = byCallId.get(String(p.toolCallId));
+                if (entry) {
+                    entry.output = p.output;
+                    const out = p.output;
+                    entry.ok = !(out !== null &&
+                        typeof out === 'object' &&
+                        out.ok === false);
+                }
+                break;
+            }
+            case 'step-finish':
+                // 与累加路径同一套拍平：步级明细里也该看得见缓存命中，见 usage.ts。
+                flush(flattenUsage(p.usage));
+                break;
+            default:
+                break;
+        }
+    }
+    // 尾部未收到 step-finish 的残步也要落（中断场景）。
+    flush();
+    return steps;
+}
+//# sourceMappingURL=events-to-steps.js.map

package/dist/turn/events-to-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-to-steps.js","sourceRoot":"","sources":["../../src/turn/events-to-steps.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA6B,EAC7B,KAAa;IAEb,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACnD,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,GAAmC,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkD,CAAC;IAE3E,MAAM,KAAK,GAAG,CAAC,KAA8B,EAAE,EAAE;QAC/C,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAClD,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,SAAS,EAAE,KAAK;YAChB,KAAK;SACN,CAAC,CAAC;QACH,IAAI,GAAG,EAAE,CAAC;QACV,KAAK,GAAG,EAAE,CAAC;QACX,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAkC,CAAC;QAC/C,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,YAAY;gBACf,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,MAAM;YACR,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,KAAK,GAAG;oBACZ,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;oBAChC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;iBACf,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBACtC,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;gBACjD,IAAI,KAAK,EAAE,CAAC;oBACV,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;oBACxB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAiC,CAAC;oBAChD,KAAK,CAAC,EAAE,GAAG,CAAC,CACV,GAAG,KAAK,IAAI;wBACZ,OAAO,GAAG,KAAK,QAAQ;wBACvB,GAAG,CAAC,EAAE,KAAK,KAAK,CACjB,CAAC;gBACJ,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,aAAa;gBAChB,wCAAwC;gBACxC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7B,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IACD,kCAAkC;IAClC,KAAK,EAAE,CAAC;IACR,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/turn/index.d.ts

@@ -0,0 +1,17 @@
+export { AgentRuntime, type AgentRuntimeDeps } from './agent-runtime.js';
+export { COMPACTION_INSTRUCTION, judgeSummary, type SummaryVerdict, wrapCompactionSummary, } from './compaction.js';
+export { isContextOverflowError } from './context-overflow.js';
+export { type ContextPressure, type ContextRelief, measureModelMessageChars, } from './context-pressure.js';
+export { eventsToSteps } from './events-to-steps.js';
+export { previewJson, TOOL_INPUT_PREVIEW_LIMIT } from './json-preview.js';
+export { createRepeatCallChain, escapeLoopReminderFence, LOOP_REMINDER_THRESHOLDS, renderLoopAdvice, type RepeatCallChain, stableToolInputKey, wrapSystemReminder, } from './loop-reminder.js';
+export { replaceNul } from './nul-safe.js';
+export { partsFromEventBuffer, partsFromEventBufferWithBoundary, type PartsTail, } from './parts-from-events.js';
+export { IMAGE_REFERENCE_KEY, imageFilePart, partsToModelMessages, type ProjectionOptions, renderPrunedToolOutput, type StoredMessage, toolResultOutput, withSystemNote, } from './parts-to-model-messages.js';
+export { hasPendingWork } from './pending-work.js';
+export { describeErrorChain, describeProviderError, isTransportError, unwrapInferenceError, } from './provider-error.js';
+export type { DrainedTurnMessage, TurnEnvelope, TurnHost, TurnResult, TurnStatus, } from './turn-envelope.js';
+export { createTurnJournal, type TurnJournal, type TurnJournalDeps, } from './turn-journal.js';
+export { abortableSleep, type AgentDefinition, type LlmHandles, type LlmProviderOptions, MAX_TRANSPORT_RETRIES, type RunTurnArgs, transportRetryBackoffMs, TurnRun, type TurnRunDeps, } from './turn-run.js';
+export { addUsage, flattenUsage } from './usage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/turn/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,KAAK,cAAc,EACnB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,KAAK,eAAe,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,KAAK,SAAS,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,KAAK,aAAa,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,KAAK,WAAW,EAChB,uBAAuB,EACvB,OAAO,EACP,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/turn/index.js

@@ -0,0 +1,16 @@
+export { AgentRuntime } from './agent-runtime.js';
+export { COMPACTION_INSTRUCTION, judgeSummary, wrapCompactionSummary, } from './compaction.js';
+export { isContextOverflowError } from './context-overflow.js';
+export { measureModelMessageChars, } from './context-pressure.js';
+export { eventsToSteps } from './events-to-steps.js';
+export { previewJson, TOOL_INPUT_PREVIEW_LIMIT } from './json-preview.js';
+export { createRepeatCallChain, escapeLoopReminderFence, LOOP_REMINDER_THRESHOLDS, renderLoopAdvice, stableToolInputKey, wrapSystemReminder, } from './loop-reminder.js';
+export { replaceNul } from './nul-safe.js';
+export { partsFromEventBuffer, partsFromEventBufferWithBoundary, } from './parts-from-events.js';
+export { IMAGE_REFERENCE_KEY, imageFilePart, partsToModelMessages, renderPrunedToolOutput, toolResultOutput, withSystemNote, } from './parts-to-model-messages.js';
+export { hasPendingWork } from './pending-work.js';
+export { describeErrorChain, describeProviderError, isTransportError, unwrapInferenceError, } from './provider-error.js';
+export { createTurnJournal, } from './turn-journal.js';
+export { abortableSleep, MAX_TRANSPORT_RETRIES, transportRetryBackoffMs, TurnRun, } from './turn-run.js';
+export { addUsage, flattenUsage } from './usage.js';
+//# sourceMappingURL=index.js.map

package/dist/turn/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/turn/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,YAAY,EAEZ,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAGL,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAEhB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,gCAAgC,GAEjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EAEpB,sBAAsB,EAEtB,gBAAgB,EAChB,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EACL,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EAId,qBAAqB,EAErB,uBAAuB,EACvB,OAAO,GAER,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/turn/json-preview.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 工具入参的短预览：「这次调用长什么样」给模型看一眼就够，正文体积不能跟着来。
+ *
+ * **两个消费方**：裁剪存根（`renderPrunedToolOutput`——结果被移出上下文后，参数
+ * 是模型判断「要不要重跑」的全部依据）与重复调用提醒（`loop-reminder.ts`——劝告
+ * 里得说清是哪次调用在重复）。两处要的是同一件事，措辞也该一样：模型会在同一段
+ * 历史里同时读到它们，同一个调用长成两副样子只会让它多猜一轮。
+ */
+/** 预览上限（**码点**，不是 UTF-16 长度）。 */
+export declare const TOOL_INPUT_PREVIEW_LIMIT = 160;
+/**
+ * 任意值 → 一行短 JSON 预览。
+ *
+ * 三条都不是形式主义：
+ * - `JSON.stringify(undefined)` 返回的是 `undefined` 而**不是**抛错，直接拼进
+ *   模板就成了字面量 `"undefined"`，读起来像模型真传了这么个参数。
+ * - 序列化失败（循环引用等）绝不能炸掉整轮对话——这里产出的只是一段给模型看的
+ *   提示文字。
+ * - 按**码点**切，别用 `.slice()` 劈开代理对（同技能索引那条判据）。
+ */
+export declare function previewJson(value: unknown, limit?: number): string;
+//# sourceMappingURL=json-preview.d.ts.map

package/dist/turn/json-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-preview.d.ts","sourceRoot":"","sources":["../../src/turn/json-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iCAAiC;AACjC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,MAAiC,GACvC,MAAM,CAUR"}

package/dist/turn/json-preview.js

@@ -0,0 +1,34 @@
+/**
+ * 工具入参的短预览：「这次调用长什么样」给模型看一眼就够，正文体积不能跟着来。
+ *
+ * **两个消费方**：裁剪存根（`renderPrunedToolOutput`——结果被移出上下文后，参数
+ * 是模型判断「要不要重跑」的全部依据）与重复调用提醒（`loop-reminder.ts`——劝告
+ * 里得说清是哪次调用在重复）。两处要的是同一件事，措辞也该一样：模型会在同一段
+ * 历史里同时读到它们，同一个调用长成两副样子只会让它多猜一轮。
+ */
+/** 预览上限（**码点**，不是 UTF-16 长度）。 */
+export const TOOL_INPUT_PREVIEW_LIMIT = 160;
+/**
+ * 任意值 → 一行短 JSON 预览。
+ *
+ * 三条都不是形式主义：
+ * - `JSON.stringify(undefined)` 返回的是 `undefined` 而**不是**抛错，直接拼进
+ *   模板就成了字面量 `"undefined"`，读起来像模型真传了这么个参数。
+ * - 序列化失败（循环引用等）绝不能炸掉整轮对话——这里产出的只是一段给模型看的
+ *   提示文字。
+ * - 按**码点**切，别用 `.slice()` 劈开代理对（同技能索引那条判据）。
+ */
+export function previewJson(value, limit = TOOL_INPUT_PREVIEW_LIMIT) {
+    let json;
+    try {
+        json = JSON.stringify(value) ?? '(无)';
+    }
+    catch {
+        json = '(无法序列化)';
+    }
+    const points = Array.from(json);
+    if (points.length <= limit)
+        return json;
+    return `${points.slice(0, limit).join('')}…`;
+}
+//# sourceMappingURL=json-preview.js.map

package/dist/turn/json-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-preview.js","sourceRoot":"","sources":["../../src/turn/json-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,QAAgB,wBAAwB;IAExC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;AAC/C,CAAC"}