@migor/agentia 0.9.4 → 0.9.5

package/dist/eval/export.d.ts

@@ -0,0 +1,48 @@
+import type { MessageParam } from '../core/message.js';
+import type { Trace } from '../core/trace.js';
+/**
+ * Agentia —— trace → 训练数据导出（R8-P3b，质量闭环的另一半）。
+ *
+ * `exportRun` 把一条完成的 trace 翻成一份**训练数据记录**（`{ messages, meta }`），
+ * CLI `agentia export` 在它的外面包文件读写与过滤（--min-score / --ok-only / --out）。
+ * 纯函数：不写文件、不联网。
+ *
+ * ⚠️ module 级 export，刻意不进 src/index.ts 公共面（与 harvestEvalCase 同款纪律，
+ * 见 AGENTS.md「内部工具不进公共面」；CLI 侧是去类型移植副本，逐字对拍守护）。
+ *
+ * 诚实边界（缺席一律进 `meta.incomplete`，不静默）：
+ * - trace 不记 run 的**原始输入** ⇒ messages 首条 user 是占位，标 `incomplete: ['input']`；
+ * - assistant 文本只在 run 开了 `traceContent: 'full'`（R8-P3a）时有真值
+ *   （llm.turn 的 `output.text` 属性）；缺了**不造占位文本**（占位文本进训练数据是
+ *   投毒）—— 该回合的 assistant 消息只剩 tool_use 块，并标 `incomplete`；
+ * - 只重建**直属 run 根**的主循环回合（子 agent 嵌套回合不进主线 —— 它们的能力出参
+ *   已在主线里；数量记在 `meta.nestedTurns`，与 harvest 同口径）；
+ * - tool_use ↔ tool_result 按 `tool_use_id` 配对；缺输出的补 is_error 占位（协议要求
+ *   配对合法），有输出没配对的跳过并计数（`meta.droppedOutputs`）—— 都不静默。
+ */
+export interface ExportRecordMeta {
+    traceId: string;
+    /** run 根的 model / stop_reason（attributes；没有则 undefined） */
+    model: string | undefined;
+    stopReason: string | undefined;
+    /** trace.status（'ok' / 'error'） */
+    status: string;
+    /** run 根的 score 事件（attachScore；可能多条 —— 不同维度各记各的） */
+    scores: Array<{
+        name: string;
+        value: number;
+    }>;
+    /** 略去的子 agent 嵌套回合数（它们不进主线） */
+    nestedTurns: number;
+    /** 有 tool.output 事件但没配上本回合 tool_use 的条数（被跳过，见文件头） */
+    droppedOutputs: number;
+    /** 完整性缺口清单（空数组 = 无已知缺口）；值是机器可 grep 的固定词 */
+    incomplete: string[];
+}
+export interface ExportRecord {
+    /** Anthropic Messages 形状（MessageParam[]）：首条 user 是占位（见 incomplete） */
+    messages: MessageParam[];
+    meta: ExportRecordMeta;
+}
+/** 导出一条 trace 为训练数据记录（形状与纪律见文件头）。 */
+export declare function exportRun(trace: Trace): ExportRecord;

package/dist/eval/export.js

@@ -0,0 +1,146 @@
+import { TOOL_INPUT_EVENT, TOOL_OUTPUT_EVENT } from '../core/trace.js';
+import { stringifySafe } from '../core/json.js';
+/** 原始输入占位（trace 不记 run 的原始输入 —— 与 harvest 的占位同一性质，但词不同便于区分来源） */
+const INPUT_PLACEHOLDER = '[export] 原始输入未入 trace —— 训练前请补写真实用户输入';
+function toolEvents(turn, name) {
+    const out = [];
+    for (const e of turn.events) {
+        if (e.name !== name)
+            continue;
+        const b = (e.body ?? {});
+        // 缺 `tool` 的事件跳过、不回填占位名（伪造的 'unknown' 会变成一个断言必然通过 /
+        // 训练必然「学会」的假工具调用 —— 与 harvest 同一条纪律）
+        if (typeof b.tool !== 'string')
+            continue;
+        out.push({
+            tool: b.tool,
+            toolUseId: typeof b.tool_use_id === 'string' ? b.tool_use_id : undefined,
+            input: b.input === undefined ? undefined : stringifySafe(b.input),
+            ok: typeof b.ok === 'boolean' ? b.ok : undefined,
+            content: b.content === undefined ? undefined : stringifySafe(b.content),
+        });
+    }
+    return out;
+}
+/** 入参还原：尝试 JSON.parse 回对象，失败（或非 object）包 {_raw}（tool_use.input 必须是 object） */
+function parseToolInput(raw) {
+    const s = raw ?? '';
+    try {
+        const parsed = JSON.parse(s);
+        return typeof parsed === 'object' && parsed !== null
+            ? parsed
+            : { _raw: s };
+    }
+    catch {
+        return { _raw: s };
+    }
+}
+/** 导出一条 trace 为训练数据记录（形状与纪律见文件头）。 */
+export function exportRun(trace) {
+    const root = trace.spans.find((s) => s.spanId === trace.rootSpanId);
+    const mainTurns = trace.spans
+        .filter((s) => s.kind === 'llm.turn' && s.parentSpanId === trace.rootSpanId)
+        .sort((a, b) => a.startedAt - b.startedAt);
+    const nestedTurns = trace.spans.filter((s) => s.kind === 'llm.turn' && s.parentSpanId !== trace.rootSpanId).length;
+    const incomplete = ['input']; // 首条 user 恒为占位（trace 不记原始输入）
+    let droppedOutputs = 0;
+    let tuSeq = 0;
+    // 「本 run 压根没开 traceContent」是 run 根上的 ground truth（loop.ts 写入）。它不能直接
+    // 用来标缺口（合成 / 老 trace 可能没有这个属性，却真的有正文），只在**收尾**时与
+    // 「整棵 trace 一行正文都没有」合取使用，见下面那段。
+    const textRecorded = root?.attributes['config.traceContent'] === 'full';
+    let anyTextRecorded = false;
+    const messages = [{ role: 'user', content: INPUT_PLACEHOLDER }];
+    for (const turn of mainTurns) {
+        const content = [];
+        // assistant 文本：只记真值（output.text，R8-P3a）；缺了不造占位（占位文本进训练数据是投毒）。
+        // 缺口判定：纯 tool_use 回合**本来就没文本**（引擎只在文本非空时记 output.text），
+        // 不算缺口；没有 tool_use 又没有文本的回合（终端回合）缺文本才是真缺口。
+        const inputs = toolEvents(turn, TOOL_INPUT_EVENT);
+        // ⚠️ 宽容读取（`?.`）：trace 经 JSONL / 手搓对象回来时可能没有 `attributes`
+        // 字段（类型上说必填、运行时不是）—— CLI 那份移植副本一直这么读，两侧产物必须一致。
+        const text = turn.attributes?.['output.text'];
+        if (typeof text === 'string' && text !== '') {
+            anyTextRecorded = true;
+            content.push({ type: 'text', text });
+        }
+        else if (inputs.length === 0 && !incomplete.includes('assistant-text')) {
+            incomplete.push('assistant-text');
+        }
+        const usedIds = [];
+        for (const e of inputs) {
+            const id = e.toolUseId ?? `export_tu_${++tuSeq}`; // 老 trace 无 id 时合成（replay 同款）
+            usedIds.push(id);
+            content.push({ type: 'tool_use', id, name: e.tool, input: parseToolInput(e.input) });
+        }
+        if (content.length > 0)
+            messages.push({ role: 'assistant', content: content });
+        // tool_result 配对：按 tool_use_id 配本回合的 tool.output；缺输出的补 is_error 占位
+        // （协议要求每个 tool_use 都有配对 tool_result —— 残缺历史喂训练是静音投毒）
+        if (usedIds.length > 0) {
+            const outputs = toolEvents(turn, TOOL_OUTPUT_EVENT);
+            const byId = new Map(outputs.map((o) => [o.toolUseId, o]));
+            const results = [];
+            for (const [i, id] of usedIds.entries()) {
+                const out = byId.get(id) ?? (outputs[i]?.toolUseId === undefined ? outputs[i] : undefined);
+                if (out === undefined) {
+                    results.push({
+                        type: 'tool_result',
+                        tool_use_id: id,
+                        is_error: true,
+                        content: '[export] 该 tool_use 的输出未入 trace（失败/截断的 run 段）',
+                    });
+                    continue;
+                }
+                results.push({
+                    type: 'tool_result',
+                    tool_use_id: id,
+                    ...(out.ok === false ? { is_error: true } : {}),
+                    content: out.content ?? '',
+                });
+            }
+            // 有输出却没配上本回合任何 tool_use（id 对不上）：跳过并计数，不静默丢
+            droppedOutputs += outputs.filter((o) => o.toolUseId !== undefined && !usedIds.includes(o.toolUseId)).length;
+            messages.push({ role: 'user', content: results });
+        }
+    }
+    // 收尾判定（2026-09-27 ⑪）：整棵 trace 一行正文都没有、且本 run 没开 traceContent
+    // ⇒ 缺的不只是「终端回合那句话」：**混合回合**（模型先说一句再调工具）的真实正文同样
+    // 不在 trace 里，而只看「本回合有没有 tool_use」是判不出来的（那种回合按定义就是
+    // 「本来没文本」）。两条合取才成立：有正文就不标（合成 / 老 trace 也照顾到），
+    // 开了 traceContent 而没正文也不标（那是模型确实没说话，不是记录缺口）。
+    if (!anyTextRecorded && !textRecorded && !incomplete.includes('assistant-text')) {
+        incomplete.push('assistant-text');
+    }
+    // SFT 形状（2026-09-27 ⑫）：末条是 user ⇒ 这条样本**没有 loss 目标**（训练器会静默
+    // 丢掉它），而它恰恰是「run 没有终答」的形状（半截 run / 只剩工具往返）。标注出来，
+    // 别让下游以为每条都能直接用：`--ok-only` 挡不住它 —— status ok ≠ 有终答。
+    if (messages[messages.length - 1]?.role === 'user' &&
+        !incomplete.includes('no-final-assistant')) {
+        incomplete.push('no-final-assistant');
+    }
+    const scores = [];
+    for (const e of root?.events ?? []) {
+        if (e.name !== 'score')
+            continue;
+        const b = (e.body ?? {});
+        if (typeof b.name === 'string' && typeof b.value === 'number') {
+            scores.push({ name: b.name, value: b.value });
+        }
+    }
+    return {
+        messages,
+        meta: {
+            traceId: trace.traceId,
+            model: typeof root?.attributes.model === 'string' ? root.attributes.model : undefined,
+            stopReason: typeof root?.attributes.stop_reason === 'string' ? root.attributes.stop_reason : undefined,
+            // `?? ''` 与 CLI 副本同款：trace 缺 status 时两侧产物必须逐字一致（对拍守着）
+            status: trace.status ?? '',
+            scores,
+            nestedTurns,
+            droppedOutputs,
+            incomplete,
+        },
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/eval/export.js.map

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

package/dist/eval/harvest.js

@@ -1,3 +1,4 @@
+import { TOOL_INPUT_EVENT } from '../core/trace.js';
 import { stringifySafe } from '../core/json.js';
 /** trace 不记 assistant 文本 —— 脚本 text 块的统一占位（测试与 CLI 都对齐这个词） */
 const ASSISTANT_TEXT_PLACEHOLDER = '[harvest] assistant 文本未入 trace';
@@ -5,7 +6,7 @@ const ASSISTANT_TEXT_PLACEHOLDER = '[harvest] assistant 文本未入 trace';
 function toolInputsOf(turn) {
     const out = [];
     for (const e of turn.events) {
-        if (e.name !== 'tool.input')
+        if (e.name !== TOOL_INPUT_EVENT)
             continue;
         const b = (e.body ?? {});
         // 缺 `tool` 的事件**跳过**，不回填占位名：伪造的 'unknown' 会在生成的脚本里变成一个
@@ -137,7 +138,11 @@ export function harvestEvalCase(input) {
             .join(',\n'));
         body.push('  ]),');
     }
-    body.push('  expect: (result, { trace }) => {', '    // 主循环实际调用过的工具名序列（直属 run 根的 llm.turn 上的 tool.input 事件）', '    const tools = trace.spans', "      .filter((s) => s.kind === 'llm.turn' && s.parentSpanId === trace.rootSpanId)", '      .sort((a, b) => a.startedAt - b.startedAt)', '      .flatMap((s) =>', "        s.events.filter((e) => e.name === 'tool.input').map((e) => (e.body || {}).tool),", '      );', `    assert.deepEqual(tools, ${JSON.stringify(toolSeq)});`, '  },', '}');
+    body.push('  expect: (result, { trace }) => {', '    // 主循环实际调用过的工具名序列（直属 run 根的 llm.turn 上的 tool.input 事件）', '    const tools = trace.spans', "      .filter((s) => s.kind === 'llm.turn' && s.parentSpanId === trace.rootSpanId)", '      .sort((a, b) => a.startedAt - b.startedAt)', '      .flatMap((s) =>', 
+    // ⚠️ 这一行是**生成出去的代码文本**（写进 harvested 用例的源码），不是本仓的取值 ——
+    // 所以它保留字面量：生成的脚本不 import 本仓常量，改成 `TOOL_INPUT_EVENT` 会得到一个
+    // 引用了不存在标识符的脚本（跑起来才炸）。源码级守卫正是按这个理由给它白名单。
+    "        s.events.filter((e) => e.name === 'tool.input').map((e) => (e.body || {}).tool),", '      );', `    assert.deepEqual(tools, ${JSON.stringify(toolSeq)});`, '  },', '}');
     return `${head.join('\n')}\n${body.join('\n')}\n`;
 }
 //# sourceMappingURL=harvest.js.map

package/dist/eval/harvest.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const AGENTIA_VERSION = "0.9.4";
+export declare const AGENTIA_VERSION = "0.9.5";
 export type { Trace, Span, SpanEvent, SpanError, SpanId, SpanKind, SpanLink, SpanStatus, TraceId, TraceContext, TraceSink, TraceRecordEvent, CapabilityType, Usage, Score, } from './core/trace.js';
 export { attachScore, parseTraceparent } from './core/trace.js';
 export type { AgentTool, ApprovalDecision, JsonSchema, ModelClient, RecorderBackend, SchemaInput, SchemaType, ToolRunContext, TypedSchema, } from './core/tool.js';
@@ -12,7 +12,7 @@ export type { TraceLimits, TraceRecorderOptions } from './engine/tracer.js';
 export { currentTraceparent } from './engine/span-scope.js';
 export { classifyError, isAbortError } from './engine/errors.js';
 export { isSuccessStopReason } from './engine/types.js';
-export type { AgentRunResult, AgentStopReason, ContextPolicy, RunAgentOptions, SystemParam, SystemTextBlock, } from './engine/types.js';
+export type { AgentRunResult, AgentStopReason, ContextPolicy, ModelFallbackLink, RunAgentOptions, SystemParam, SystemTextBlock, } from './engine/types.js';
 export { defaultEstimateTokens, estimateMessages, renderMessages, trimToolPairs, compactMessages, } from './engine/trimming.js';
 export type { CompactOptions, TrimOptions } from './engine/trimming.js';
 export { createBudgetPolicy } from './engine/policy.js';
@@ -30,7 +30,7 @@ export type { Blackboard, BlackboardKey, BlackboardSeed, BlackboardValue, } from
 export { SystemPrompt } from './runtime/systemPrompt.js';
 export type { SystemPromptOptions, SystemSection } from './runtime/systemPrompt.js';
 export type { ExecuteRunOptions } from './runtime/run.js';
-export type { RunMeta, RunStatus } from './core/run.js';
+export type { RunMeta, RunStatus, SuspendedReason, TaskEvent } from './core/run.js';
 export { Container } from './container/container.js';
 export type { Provider, ClassProvider, ValueProvider, FactoryProvider, Token, } from './container/container.js';
 export { asset } from './toolkit/asset.js';
@@ -66,11 +66,12 @@ export { createHttpHandler, HttpException } from './transport/http.js';
 export type { HttpHandlerOptions, HttpHandler, HealthResponse, RunHttpResponse, TaskSubmitBody, } from './transport/http.js';
 export { SqliteTaskStore } from './store/sqliteStore.js';
 export { createOtlpExporter } from './integrations/otlp.js';
+export { jsonlTraceSink } from './integrations/file-sink.js';
 export { createOpenAIClient } from './integrations/openai.js';
 export { createAnthropicClient } from './integrations/anthropic.js';
 export type { AnthropicClientOptions } from './integrations/anthropic.js';
 export { InMemoryMemoryStore } from './runtime/memory.js';
-export type { MemoryStore } from './runtime/memory.js';
+export type { MemorySnapshot, MemoryStore, MemoryWriteResult } from './runtime/memory.js';
 export { InMemorySessionStore } from './runtime/session.js';
 export type { SessionStore } from './runtime/session.js';
 export { RedisTaskStore } from './store/redisStore.js';
@@ -84,8 +85,10 @@ export { diffTraces } from './engine/trace-diff.js';
 export type { DiffEntry, SpanDiff, TraceDiff, TraceDiffOptions } from './engine/trace-diff.js';
 export { mcpTools, MCP_DEFAULT_TIMEOUT_MS, MCP_CLOSE_GRACE_MS, createStdioMcpConnector, createStreamableHttpMcpConnector, } from './integrations/mcp.js';
 export type { McpClientLike, McpConnector, McpToolInfo, McpToolsOptions, StdioMcpConnectorOptions, StreamableHttpMcpConnectorOptions, } from './integrations/mcp.js';
+export { createMcpServer } from './engine/mcp-server.js';
+export type { McpServer, McpServerApp, McpServerOptions } from './engine/mcp-server.js';
 export { metricsSink, DEFAULT_BUCKETS } from './integrations/metrics.js';
-export type { MetricsSink, MetricsSinkOptions, MetricsSnapshot, ModelMetrics, CapabilityMetrics, } from './integrations/metrics.js';
+export type { MetricsSink, MetricsSinkOptions, MetricsSnapshot, ModelMetrics, CapabilityMetrics, RunLabelMetrics, ExemplarSnapshot, } from './integrations/metrics.js';
 export { buildRunReport, mergeRunReports, renderRunReport } from './integrations/report.js';
 export type { DurationReport, ModelReport, RunReport, CapabilityReport, } from './integrations/report.js';
 export { scriptedClient } from './eval/scripted.js';

package/dist/index.js

@@ -1,4 +1,4 @@
-export const AGENTIA_VERSION = '0.9.4';
+export const AGENTIA_VERSION = '0.9.5';
 export { attachScore, parseTraceparent } from './core/trace.js';
 export { validateJsonSchema } from './core/schema.js';
 export { combineSignals } from './core/abort.js';
@@ -48,6 +48,8 @@ export { runSync, createSyncHandler } from './transport/transport.js';
 export { createHttpHandler, HttpException } from './transport/http.js';
 export { SqliteTaskStore } from './store/sqliteStore.js';
 export { createOtlpExporter } from './integrations/otlp.js';
+// JSONL 文件 sink：`agentia report` / `diff` / `harvest` 的输入格式（一行一条裸 Trace）
+export { jsonlTraceSink } from './integrations/file-sink.js';
 export { createOpenAIClient } from './integrations/openai.js';
 export { createAnthropicClient } from './integrations/anthropic.js';
 export { InMemoryMemoryStore } from './runtime/memory.js';
@@ -59,6 +61,9 @@ export { diffTraces } from './engine/trace-diff.js';
 // integrations：MCP 桥（D1）+ 两个内置连接器（stdio / StreamableHTTP）—— 桥是 duck-typed，
 // 连接器只用标准库（`node:child_process` + 全局 `fetch`），**不新增第三方依赖**（spec §10 2026-09-18）
 export { mcpTools, MCP_DEFAULT_TIMEOUT_MS, MCP_CLOSE_GRACE_MS, createStdioMcpConnector, createStreamableHttpMcpConnector, } from './integrations/mcp.js';
+// engine：MCP 反向桥（R8-P5）—— 把 app 的能力菜单暴露成 MCP server（stdio / StreamableHTTP，
+// 只用标准库）。落 engine 层的理由见该文件头注（integrations 只允许依赖 core，装不下它）
+export { createMcpServer } from './engine/mcp-server.js';
 // integrations：指标（D3 → E2/E3/E4/E5）—— 满足 TraceSink 即可接入，能力零新出口
 export { metricsSink, DEFAULT_BUCKETS } from './integrations/metrics.js';
 // integrations：调优报告（G1）—— 纯函数，从 trace 派生「哪个能力慢/贵/爱失败」

package/dist/index.js.map

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

package/dist/integrations/adapter-options.d.ts

@@ -1,3 +1,25 @@
+/**
+ * 流内 error 分片的 type/code → HTTP status。
+ *
+ * **为什么必须共用一份**（2026-09-28 外部深评 S3）：`anthropic.ts` 与 `openai.ts` 是同一
+ * 契约（`ModelClient`）的两条实现，同一判定原本**各写一份**，一致性只靠两边注释里
+ * 「与那边同口径」互相喊话 —— 而注释不会在被改的那一刻失败（本仓已有前科：同一个 429
+ * 两侧尝试次数不同，见 `tests/integrations/adapter-parity.test.ts` 的文件头）。
+ * 现在判定只写一处，两条适配器都调它：改口径只能改这里，漂不了。
+ *
+ * 目的：兼容端点（DeepSeek 等）常把限流 / 内部故障塞进 **HTTP 200** 的流里，不给非 2xx。
+ * 不反推成 status，引擎就无法识别这是可重试的限流，重试层照样不生效。
+ *
+ * 为什么不细分 401/403/404：`engine/errors.ts` 的鸭子分类只看「4xx = 改配置才有救、
+ * 别白重试」，401 与 403 在引擎侧是同一处置；细分只会多三个没人读的分支。
+ *
+ * 值域：**只回 429 / 529 / 400 / 500 四个**（均为「引擎侧已有处置」的档位）——
+ * 别在这里返回 4xx 里没人处理的状态码。
+ */
+export declare function statusOfStreamError(err: {
+    type?: string | null | undefined;
+    code?: string | null | undefined;
+}): number;
 /** 适配器缺省内层重试次数（与 Anthropic SDK 的缺省对齐：2） */
 export declare const DEFAULT_MAX_RETRIES = 2;
 /**

package/dist/integrations/adapter-options.js

@@ -6,6 +6,57 @@
  * `tests/integrations/adapter-parity.test.ts`）。所以判定只写一次，两条适配器都调它。
  */
 import { zeroClauseOf } from '../core/limits.js';
+/**
+ * 流内 error 分片的 type/code → HTTP status。
+ *
+ * **为什么必须共用一份**（2026-09-28 外部深评 S3）：`anthropic.ts` 与 `openai.ts` 是同一
+ * 契约（`ModelClient`）的两条实现，同一判定原本**各写一份**，一致性只靠两边注释里
+ * 「与那边同口径」互相喊话 —— 而注释不会在被改的那一刻失败（本仓已有前科：同一个 429
+ * 两侧尝试次数不同，见 `tests/integrations/adapter-parity.test.ts` 的文件头）。
+ * 现在判定只写一处，两条适配器都调它：改口径只能改这里，漂不了。
+ *
+ * 目的：兼容端点（DeepSeek 等）常把限流 / 内部故障塞进 **HTTP 200** 的流里，不给非 2xx。
+ * 不反推成 status，引擎就无法识别这是可重试的限流，重试层照样不生效。
+ *
+ * 为什么不细分 401/403/404：`engine/errors.ts` 的鸭子分类只看「4xx = 改配置才有救、
+ * 别白重试」，401 与 403 在引擎侧是同一处置；细分只会多三个没人读的分支。
+ *
+ * 值域：**只回 429 / 529 / 400 / 500 四个**（均为「引擎侧已有处置」的档位）——
+ * 别在这里返回 4xx 里没人处理的状态码。
+ */
+export function statusOfStreamError(err) {
+    const key = `${err.type ?? ''} ${err.code ?? ''}`.toLowerCase();
+    // 限流档：可重试短路
+    if (key.includes('rate_limit') ||
+        key.includes('insufficient_quota') ||
+        key.includes('too_many')) {
+        return 429;
+    }
+    // 过载档（Anthropic 的 overloaded_error = 529，语义就是「稍后重试」）；
+    // OpenAI 侧的兼容端点也用同一个词，两侧同判 —— 它同样是 5xx 可重试，但保留 529 让
+    // trace / 指标能把它与「真故障」分开数
+    if (key.includes('overloaded'))
+        return 529;
+    // 4xx 档：这些是**改配置才有救**的病因（上下文超限 / 模型名错 / 鉴权 / 内容策略），
+    // 一律 500 + retryable 会让引擎白重试 3 次（3 次网络请求 + 3 倍等待），
+    // 且 trace 记成 `server` 而非 `api` —— 排障方向被带偏。
+    //
+    // 用 `includes` 而不是枚举：OpenAI 兼容生态的类型/错误码多得多（下面全部来自真实
+    // 兼容端点的读数），枚举会把没列到的私下归 500。两侧原本各自枚举得**不完全一致**
+    // （anthropic 列 `not_found_error`、openai 列 `model_not_found`/`does_not_exist`），
+    // 合并时取**并集**：这是本函数存在的意义 —— 同一病因在两条适配器上必须同一档。
+    if (key.includes('invalid_request') ||
+        key.includes('context_length') ||
+        key.includes('model_not_found') ||
+        key.includes('does_not_exist') ||
+        key.includes('not_found') ||
+        key.includes('content_filter') ||
+        key.includes('authentication') ||
+        key.includes('permission')) {
+        return 400;
+    }
+    return 500;
+}
 /** 适配器缺省内层重试次数（与 Anthropic SDK 的缺省对齐：2） */
 export const DEFAULT_MAX_RETRIES = 2;
 /**

package/dist/integrations/adapter-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-options.js","sourceRoot":"","sources":["../../src/integrations/adapter-options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY,EAAE,KAAa;IAC3D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC;IAClD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CACjB,GAAG,KAAK,yBAAyB,YAAY,CAAC,YAAY,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,MAAM;YAClF,gEAAgE;YAChE,kCAAkC,CACrC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"adapter-options.js","sourceRoot":"","sources":["../../src/integrations/adapter-options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAKnC;IACC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,YAAY;IACZ,IACE,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAClC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,sDAAsD;IACtD,qDAAqD;IACrD,yBAAyB;IACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3C,oDAAoD;IACpD,mDAAmD;IACnD,2CAA2C;IAC3C,EAAE;IACF,oDAAoD;IACpD,8CAA8C;IAC9C,+EAA+E;IAC/E,6CAA6C;IAC7C,IACE,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;QACzB,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC1B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY,EAAE,KAAa;IAC3D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC;IAClD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CACjB,GAAG,KAAK,yBAAyB,YAAY,CAAC,YAAY,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,MAAM;YAClF,gEAAgE;YAChE,kCAAkC,CACrC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/integrations/anthropic.d.ts

@@ -33,8 +33,10 @@ export interface AnthropicClientOptions {
      * 单次请求超时（毫秒）。缺省不给（中止由引擎的 signal 管，见 `ModelClient` 契约）；
      * 给了就用超时信号与 params.signal 合成（任一触发即中止）。超时按连接错误处理（可重试）。
      *
-     * 必须为**正的有限数**（构造期校验，与 AsyncRunner 对 `runTimeoutMs` 的校验同款）：
-     * NaN / Infinity 会被 `setTimeout` 钳到 1ms —— 每个请求立即「超时」，静默全挂。
+     * 必须为**正的有限数、且不超过 Node 定时器上限**（构造期校验，与 AsyncRunner 对
+     * `runTimeoutMs` 的校验同款）：NaN / Infinity / 超过 `2^31-1`ms 的延迟都会被 `setTimeout`
+     * 钳到 1ms（Node 只在 stderr 留一行 `TimeoutOverflowWarning`，没人会看到）——
+     * 于是每个请求立即「超时」，看起来像上游全挂。
      * ⚠️ 校验只挡非法配置，**不改超时的既有行为**：client 层超时经合成信号中止请求、
      * 自身不再重试，抛出的 `TimeoutError`（DOMException）由引擎归 `timeout` 一类账。
      */

package/dist/integrations/anthropic.js

@@ -1,7 +1,8 @@
 import { textOf } from '../core/text.js';
-import { resolveMaxRetries } from './adapter-options.js';
+import { resolveMaxRetries, statusOfStreamError } from './adapter-options.js';
 import { sseLines } from '../core/sse.js';
-import { backoffMs, interruptibleSleep } from '../core/timeout.js';
+import { assertTimerDelay, backoffMs, interruptibleSleep } from '../core/timeout.js';
+import { zeroClauseOf } from '../core/limits.js';
 /**
  * Anthropic API 错误：非 2xx 响应（读响应体截断进 message）或 200 流内嵌 error 事件。
  * 带数值 `status` —— `engine/errors.ts` 的鸭子类型分类靠它（429 → rate_limit、
@@ -28,8 +29,13 @@ export function createAnthropicClient(options = {}) {
     if (timeoutMs !== undefined && (!Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
         // NaN / Infinity 会被 setTimeout 钳到 1ms（每个请求立即「超时」），0 / 负数同理无意义 ——
         // 响亮抛错，不静默生效（与 AsyncRunner 对 runTimeoutMs 的构造期校验同款）。
-        throw new Error(`createAnthropicClient：timeout 必须为正的有限毫秒数（不设 = 不限），收到 ${String(options.timeout)}`);
+        throw new Error(`createAnthropicClient：timeout 必须为正的有限毫秒数（${zeroClauseOf('createAnthropicClient.timeout')}），收到 ${String(options.timeout)}`);
     }
+    // 上界（2026-09-28）：「正的有限数」还不够 —— 超过 2^31-1ms（约 24.86 天）的延迟
+    // Node 不会遵守（stderr 一行警告 + 钳到 1ms）⇒「30 天超时」变成「每个请求立即超时」。
+    // 上限单源在 core/timeout.ts（composeSignal 直喂 setTimeout 的正是这个值）。
+    if (timeoutMs !== undefined)
+        assertTimerDelay(timeoutMs, 'createAnthropicClient 的 timeout');
     return {
         messages: {
             stream(params) {
@@ -58,7 +64,7 @@ export function createAnthropicClient(options = {}) {
                             // textOf 的 .filter() 抛裸 TypeError → classifyError 判 unknown/不可重试
                             // —— 同一事件走流式路径却是带 status 的可重试错误，两本账。
                             if (body.error) {
-                                throw new AnthropicApiError(statusOfStreamError(body.error.type), `Anthropic 非流式响应携带错误（${body.error.type ?? 'unknown'}）：` +
+                                throw new AnthropicApiError(statusOfStreamError({ type: body.error.type }), `Anthropic 非流式响应携带错误（${body.error.type ?? 'unknown'}）：` +
                                     (body.error.message ?? JSON.stringify(body).slice(0, 300)));
                             }
                             // content 不是数组 = 200 但没给可用补全（网关截断 / 兼容端点 bug）：
@@ -67,7 +73,10 @@ export function createAnthropicClient(options = {}) {
                             if (!Array.isArray(body.content)) {
                                 throw new AnthropicApiError(500, 'Anthropic 非流式响应缺 content 数组；响应无可用补全，按上游故障处理');
                             }
-                            const message = body;
+                            // usage 缺失（端点没回计量）也要如实标出来 —— 别让 0 冒充读数（S2）
+                            const message = body.usage
+                                ? body
+                                : { ...body, usage: { input_tokens: 0, output_tokens: 0, unreported: true } };
                             // 分隔符 `''`：回落的原文本来就是一整段，拼回去要与流式累积的文本逐字一致
                             const full = textOf(message, '');
                             if (full)
@@ -239,6 +248,9 @@ async function readAnthropicStream(body, fallbackModel, textCallbacks) {
     let stopReason = null;
     let stopSequence = null;
     let usage = {};
+    // 上游**到底报没报** usage：空对象（没报）与「报了全 0」是两回事 ——
+    // 前者要如实标 `unreported`，别让 0 冒充读数（2026-09-28 外部深评 S2）
+    let sawUsage = false;
     for await (const line of sseLines(body)) {
         if (!line.startsWith('data:'))
             continue; // 忽略 event: / 注释 / 空行
@@ -257,6 +269,8 @@ async function readAnthropicStream(body, fallbackModel, textCallbacks) {
                 started = true;
                 id = event.message?.id ?? '';
                 model = event.message?.model ?? '';
+                if (event.message?.usage)
+                    sawUsage = true;
                 usage = { ...event.message?.usage };
                 break;
             }
@@ -325,15 +339,17 @@ async function readAnthropicStream(body, fallbackModel, textCallbacks) {
                     stopSequence = d.stop_sequence;
                 // message_delta 的 usage 是累计口径（output_tokens 为累计值，cache 计量在此回报）。
                 // 走 mergeUsage 而非浅合并：显式 null 不得清掉 message_start 已拿到的真实值。
-                if (event.usage)
+                if (event.usage) {
+                    sawUsage = true;
                     usage = mergeUsage(usage, event.usage);
+                }
                 break;
             }
             case 'error': {
                 // 上游故障以错误事件下发（HTTP 仍是 200）—— 不抛出就会被组装成假成功，
                 // run 结论与真实相反（openai.ts 处理过同款形态）
                 const err = event.error ?? {};
-                throw new AnthropicApiError(statusOfStreamError(err.type), `Anthropic 流内错误（${err.type ?? 'unknown'}）：${err.message ?? payload.slice(0, 300)}`);
+                throw new AnthropicApiError(statusOfStreamError({ type: err.type }), `Anthropic 流内错误（${err.type ?? 'unknown'}）：${err.message ?? payload.slice(0, 300)}`);
             }
             case 'message_stop': {
                 sawStop = true;
@@ -402,29 +418,13 @@ async function readAnthropicStream(body, fallbackModel, textCallbacks) {
             output_tokens: usage.output_tokens ?? 0,
             cache_creation_input_tokens: usage.cache_creation_input_tokens ?? 0,
             cache_read_input_tokens: usage.cache_read_input_tokens ?? 0,
+            // 上游全程没给 usage ⇒ 上面四个 0 是**替身值**，如实标出来（S2）
+            ...(sawUsage ? {} : { unreported: true }),
         },
     };
 }
-/** 流内 error 事件的类型 → HTTP status（让引擎的错误分类与重试语义照常工作） */
-function statusOfStreamError(type) {
-    switch (type) {
-        case 'rate_limit_error':
-            return 429;
-        case 'overloaded_error':
-            return 529;
-        // 4xx 档（与 openai.ts 的 statusOfStreamError 同口径 —— 那边把
-        // invalid_request / authentication / permission / model_not_found 一律归 400，
-        // 不细分 401/403/404）：这些是**改配置才有救**的病因，归 500 + retryable 会让
-        // 引擎白重试三轮，且 trace 记成 server —— 排障方向被带偏。
-        case 'invalid_request_error':
-        case 'authentication_error':
-        case 'permission_error':
-        case 'not_found_error':
-            return 400;
-        default:
-            return 500;
-    }
-}
+// 「流内 error → HTTP status」的判定在 `adapter-options.ts`（与 openai.ts **共用一份**，
+// 2026-09-28 外部深评 S3：此前两份实现靠注释互相喊话对齐）—— 别在这里再写一份。
 /** tool_use 的 input 是分片拼出的 JSON 字符串；非法时原样交给下游 schema 校验（同 openai.ts） */
 function parseToolInput(raw) {
     if (!raw)