@migor/agentia 0.5.0 → 0.6.1

package/dist/integrations/anthropic.js

@@ -1,24 +1,415 @@
-import Anthropic from '@anthropic-ai/sdk';
 /**
- * 把 `ModelClient` 契约里的 `signal`（在 params 内部）拆到 SDK 的 `RequestOptions` 上。
- *
- * 单独导出只为**可测**：这是「默认 client 到底能不能中止在飞请求」的唯一分界点，
- * 白盒探查 SDK 内部不现实，但这一步的输入/输出可以钉死（见 `tests/integrations/anthropic.test.ts`）。
+ * Anthropic API 错误：非 2xx 响应（读响应体截断进 message）或 200 流内嵌 error 事件。
+ * 带数值 `status` —— `engine/errors.ts` 的鸭子类型分类靠它（429 → rate_limit、
+ * 5xx → server、其余 4xx → api）。
  */
-export function splitSignal(params) {
-    const { signal, ...body } = params;
-    return { body, options: signal ? { signal } : {} };
+export class AnthropicApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.name = 'AnthropicApiError';
+        this.status = status;
+    }
 }
-/** 创建默认 ModelClient（Anthropic）。不传则完全走 SDK 的默认凭据解析。 */
+/** 创建默认 ModelClient（Anthropic）。不传则完全走环境变量 + 官方端点。 */
 export function createAnthropicClient(options = {}) {
-    const client = new Anthropic(options);
-    const messages = client.messages;
-    const nativeStream = messages.stream.bind(messages);
-    // 包一层：把契约里的 signal 搬到 RequestOptions（详见文件头注释里的实测对照表）。
-    messages.stream = ((body, requestOptions) => {
-        const { body: cleanBody, options: signalOptions } = splitSignal(body);
-        return nativeStream(cleanBody, { ...requestOptions, ...signalOptions });
+    const apiKey = options.apiKey ?? process.env.ANTHROPIC_API_KEY;
+    const baseURL = (options.baseURL ??
+        process.env.ANTHROPIC_BASE_URL ??
+        'https://api.anthropic.com').replace(/\/+$/, '');
+    const maxRetries = typeof options.maxRetries === 'number' ? options.maxRetries : 2;
+    const timeoutMs = typeof options.timeout === 'number' ? options.timeout : undefined;
+    return {
+        messages: {
+            stream(params) {
+                const textCallbacks = [];
+                // **立即发起请求**（eager，与 SDK 的 stream() 语义一致）：调用方可以先等
+                // on('text') 分片、后 await finalMessage()（scripts/e2e-live.ts 步骤 ⑤
+                // 就是这个形态）—— 若惰性到 finalMessage() 才发请求，那种形态永远等不到
+                // 第一个分片。同步注册的回调不会漏分片：网络 I/O 不可能同步完成。
+                const work = (async () => {
+                    // signal 是契约字段，不是 API 字段：摘出后 body 才序列化（残留会污染请求体）
+                    const { signal: paramsSignal, ...bodyParams } = params;
+                    const { signal, cleanup } = composeSignal(paramsSignal, timeoutMs);
+                    try {
+                        const res = await postWithRetries(`${baseURL}/v1/messages`, {
+                            'content-type': 'application/json',
+                            'anthropic-version': '2023-06-01',
+                            ...(apiKey ? { 'x-api-key': apiKey } : {}),
+                        }, JSON.stringify({ ...bodyParams, stream: true }), signal, maxRetries);
+                        // 内容协商（与 openai.ts 同款）：个别兼容端点会忽略 stream:true 直接回整份 JSON
+                        const ctype = res.headers.get('content-type') ?? '';
+                        if (!ctype.includes('event-stream')) {
+                            const message = (await res.json());
+                            const full = textOf(message);
+                            if (full)
+                                for (const cb of textCallbacks)
+                                    cb(full);
+                            return message;
+                        }
+                        if (!res.body) {
+                            throw new Error('Anthropic 流式响应没有 body（端点声明了 event-stream 却没给流）');
+                        }
+                        return await readAnthropicStream(res.body, params.model, textCallbacks);
+                    }
+                    finally {
+                        cleanup();
+                    }
+                })();
+                // 调用方可能只收分片、从不 await finalMessage()：挂个空 catch 防 unhandled rejection
+                // （finalMessage 返回的仍是原 promise，await 它的调用方照常拿到 rejection）
+                work.catch(() => { });
+                return {
+                    on(event, cb) {
+                        if (event === 'text')
+                            textCallbacks.push(cb);
+                    },
+                    finalMessage: () => work,
+                };
+            },
+        },
+    };
+}
+// —— 请求与重试（SDK 缺省语义的手写等价）——
+/**
+ * 可重试的 HTTP 状态：408 / 409 / 429 / 5xx —— 与 SDK 缺省一致。
+ * 注意这是 **client 内重试**这一层；重试耗尽（或本就不重试）后抛出的
+ * `AnthropicApiError` 由 `engine/errors.ts` 的鸭子分类另行归类（408/409 落
+ * api/不可重试、429 落 rate_limit、5xx 落 server）—— 那是「这次失败怎么记账、
+ * 引擎外层要不要再来一轮」的语义，两层各司其职，不互相替代。
+ */
+function isRetryableStatus(status) {
+    return status === 408 || status === 409 || status === 429 || status >= 500;
+}
+/**
+ * 带重试的 POST。返回首个 2xx 响应；不可重试错误与重试耗尽都抛
+ * `AnthropicApiError`（HTTP 错误）或原始网络错误（fetch reject）。
+ * abort（外部 signal 或 timeout 合成信号）原样向上 —— 引擎靠 `name === 'AbortError'` 判。
+ */
+async function postWithRetries(url, headers, body, signal, maxRetries) {
+    let retryAfter = null;
+    for (let attempt = 0;; attempt++) {
+        if (attempt > 0) {
+            // 退避期间被中止：以 AbortError 收场（与引擎的 sleep 同语义）
+            await interruptibleSleep(backoffMs(attempt, retryAfter), signal);
+            retryAfter = null;
+        }
+        let res;
+        try {
+            res = await fetch(url, {
+                method: 'POST',
+                headers,
+                body,
+                ...(signal ? { signal } : {}),
+            });
+        }
+        catch (e) {
+            // abort 原样向上；signal 已中止时 fetch 的 reject 必为 abort 语义
+            if (e?.name === 'AbortError' || signal?.aborted)
+                throw e;
+            // 其余 reject 是网络失败（undici 的 TypeError: fetch failed，cause 带 errno）
+            if (attempt >= maxRetries)
+                throw e;
+            continue;
+        }
+        if (res.ok)
+            return res;
+        const text = (await res.text().catch(() => '')).slice(0, 300);
+        if (isRetryableStatus(res.status) && attempt < maxRetries) {
+            // 429 的 retry-after 尤其要尊重（限流窗口是上游说了算）
+            retryAfter = res.headers.get('retry-after');
+            continue;
+        }
+        throw new AnthropicApiError(res.status, `Anthropic 请求失败（HTTP ${res.status}）：${text}`);
+    }
+}
+/**
+ * 退避毫秒：`retry-after`（秒数或 HTTP-date）优先；否则指数退避
+ * `min(500 × 2^(attempt-1), 8000)` ±25% 抖动（attempt 从 1 起 = 第一次重试）。
+ */
+function backoffMs(attempt, retryAfter) {
+    if (retryAfter) {
+        const secs = Number(retryAfter);
+        if (Number.isFinite(secs))
+            return Math.max(0, Math.round(secs * 1000));
+        const at = Date.parse(retryAfter);
+        if (Number.isFinite(at))
+            return Math.max(0, at - Date.now());
+        // 解析不了就回落指数退避
+    }
+    const base = Math.min(500 * 2 ** Math.max(0, attempt - 1), 8000);
+    return Math.round(base * (0.75 + Math.random() * 0.5));
+}
+/**
+ * 可被 signal 中断的 sleep。
+ * 与 `engine/retry.ts` 的 sleep 同语义但不复用它 —— 分层约束：integrations 只能依赖 core。
+ */
+function interruptibleSleep(ms, signal) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        const abortError = () => Object.assign(new Error('请求已被取消'), { name: 'AbortError' });
+        if (signal?.aborted) {
+            reject(abortError());
+            return;
+        }
+        function onAbort() {
+            clearTimeout(timer);
+            reject(abortError());
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
     });
-    return client;
+}
+/**
+ * 合成 params.signal 与 timeout（任一触发即中止）。
+ * 不用 `AbortSignal.any`：它 Node 20+ 才有，本包 `engines` 承诺 >=18。
+ * cleanup 由调用方在请求结束后调用（清计时器与监听器，防泄漏）。
+ */
+function composeSignal(paramsSignal, timeoutMs) {
+    if (timeoutMs == null)
+        return { signal: paramsSignal, cleanup: () => { } };
+    const controller = new AbortController();
+    const timer = setTimeout(() => {
+        // 超时以 TimeoutError 收场：分类按连接错误（可重试），与 SDK 的
+        // APIConnectionTimeoutError → connection 同语义
+        controller.abort(new DOMException(`Anthropic 请求超过 ${timeoutMs}ms`, 'TimeoutError'));
+    }, timeoutMs);
+    timer.unref(); // 兜底计时器不得拽住进程（spec 2026-09-14 ④ 同条教训）
+    const onAbort = () => controller.abort(paramsSignal?.reason);
+    if (paramsSignal) {
+        if (paramsSignal.aborted)
+            controller.abort(paramsSignal.reason);
+        else
+            paramsSignal.addEventListener('abort', onAbort, { once: true });
+    }
+    return {
+        signal: controller.signal,
+        cleanup: () => {
+            clearTimeout(timer);
+            paramsSignal?.removeEventListener('abort', onAbort);
+        },
+    };
+}
+/**
+ * 消费 `text/event-stream` 并组装成 Message。事件处理：
+ *
+ * | 事件 | 动作 |
+ * |---|---|
+ * | message_start | 拿 id / model / 初始 usage |
+ * | content_block_start | 按 index 建块累积器：text / tool_use / thinking 收拼；redacted_thinking 与未知块型原样携带（透出时不丢） |
+ * | content_block_delta | text_delta → 拼文本并触发 on('text')；input_json_delta → 拼 partialJson；thinking_delta → 拼 thinking；signature_delta → 累积进 thinking 块的 signature |
+ * | content_block_stop | 无动作（块按 index 累积，无需收尾） |
+ * | message_delta | stop_reason / stop_sequence + 累计 usage 合并（后者覆盖前者出现的字段） |
+ * | message_stop / ping | 结束 / 忽略 |
+ * | error | 抛 AnthropicApiError（类型映射 status：rate_limit→429、overloaded→529、其余→500） |
+ *
+ * thinking 块只做「收拼 + signature 累积 + redacted/未知块原样透传」——
+ * 框架**从不主动请求 extended thinking**，这些是端点自己开了之后的兜底不丢。
+ * 与非流式 `toAnthropicMessage`（openai.ts）的空 choices 守卫同款：
+ * 整条流走完都没见 message_start = 上游故障，**抛出**而不是组装成
+ * 「stop_reason=null、content=[]、usage 全 0」的假成功。
+ */
+async function readAnthropicStream(body, fallbackModel, textCallbacks) {
+    const blocks = [];
+    let started = false;
+    let id = '';
+    let model = '';
+    let stopReason = null;
+    let stopSequence = null;
+    let usage = {};
+    for await (const line of sseLines(body)) {
+        if (!line.startsWith('data:'))
+            continue; // 忽略 event: / 注释 / 空行
+        const payload = line.slice('data:'.length).trim();
+        if (!payload)
+            continue;
+        let event;
+        try {
+            event = JSON.parse(payload);
+        }
+        catch {
+            continue; // 半截/畸形分片不该毁掉整个流（与 openai.ts 同款）
+        }
+        switch (event.type) {
+            case 'message_start': {
+                started = true;
+                id = event.message?.id ?? '';
+                model = event.message?.model ?? '';
+                usage = { ...event.message?.usage };
+                break;
+            }
+            case 'content_block_start': {
+                const cb = event.content_block ?? {};
+                const type = cb.type ?? 'text';
+                const acc = {
+                    type,
+                    text: typeof cb.text === 'string' ? cb.text : '',
+                    thinking: typeof cb.thinking === 'string' ? cb.thinking : '',
+                    signature: typeof cb.signature === 'string' ? cb.signature : '',
+                    id: typeof cb.id === 'string' ? cb.id : '',
+                    name: typeof cb.name === 'string' ? cb.name : '',
+                    partialJson: '',
+                };
+                // redacted_thinking（数据在 `data` 字段）与一切未知块型：原始块对象
+                // 原样携带 —— 不丢成空文本块，finalMessage 原样透出
+                if (type !== 'text' && type !== 'tool_use' && type !== 'thinking') {
+                    acc.raw = { ...cb, type };
+                }
+                blocks[event.index ?? blocks.length] = acc;
+                break;
+            }
+            case 'content_block_delta': {
+                const b = blocks[event.index ?? -1];
+                const d = event.delta;
+                if (!b || !d)
+                    break;
+                if (d.type === 'text_delta' && typeof d.text === 'string') {
+                    b.text += d.text;
+                    // 逐 token 下发 —— 「打字机」效果的全部来源
+                    for (const cb of textCallbacks)
+                        cb(d.text);
+                }
+                else if (d.type === 'input_json_delta' && typeof d.partial_json === 'string') {
+                    b.partialJson += d.partial_json;
+                }
+                else if (d.type === 'thinking_delta' && typeof d.thinking === 'string') {
+                    b.thinking += d.thinking;
+                }
+                else if (d.type === 'signature_delta' && typeof d.signature === 'string') {
+                    b.signature += d.signature;
+                }
+                break;
+            }
+            case 'message_delta': {
+                const d = event.delta;
+                if (d?.stop_reason)
+                    stopReason = d.stop_reason;
+                if (d?.stop_sequence !== undefined)
+                    stopSequence = d.stop_sequence;
+                // message_delta 的 usage 是累计口径（output_tokens 为累计值，cache 计量在此回报）
+                if (event.usage)
+                    usage = { ...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)}`);
+            }
+            default:
+                break; // content_block_stop / message_stop / ping 及未知事件：忽略
+        }
+    }
+    if (!started) {
+        throw new Error('Anthropic 流式响应为空（未见 message_start）；响应无可用补全，按上游故障处理');
+    }
+    const content = [];
+    for (const b of blocks) {
+        if (!b)
+            continue; // index 跳号留的洞
+        if (b.type === 'tool_use') {
+            content.push({
+                type: 'tool_use',
+                id: b.id,
+                name: b.name,
+                input: parseToolInput(b.partialJson),
+            });
+        }
+        else if (b.type === 'thinking') {
+            content.push({
+                type: 'thinking',
+                thinking: b.thinking,
+                signature: b.signature,
+            });
+        }
+        else if (b.raw) {
+            // redacted_thinking / 未知块型：原样透出（UnknownContentBlock 兜底成员承载，
+            // 无需为它新增具体类型 —— `data` 等字段跟着原始对象走，消费方自行收窄读取）
+            content.push(b.raw);
+        }
+        else {
+            content.push({ type: 'text', text: b.text });
+        }
+    }
+    return {
+        id: id || 'msg-unknown',
+        type: 'message',
+        role: 'assistant',
+        model: model || fallbackModel,
+        content,
+        stop_reason: stopReason,
+        stop_sequence: stopSequence,
+        usage: {
+            input_tokens: usage.input_tokens ?? 0,
+            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,
+        },
+    };
+}
+/** 流内 error 事件的类型 → HTTP status（让引擎的错误分类与重试语义照常工作） */
+function statusOfStreamError(type) {
+    switch (type) {
+        case 'rate_limit_error':
+            return 429;
+        case 'overloaded_error':
+            return 529;
+        default:
+            return 500;
+    }
+}
+/** tool_use 的 input 是分片拼出的 JSON 字符串；非法时原样交给下游 schema 校验（同 openai.ts） */
+function parseToolInput(raw) {
+    if (!raw)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+/** 逐行读 SSE（每条事件都是一行 `data:`，不需要处理多行 payload；与 openai.ts 同款） */
+async function* sseLines(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buf = '';
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let idx = buf.indexOf('\n');
+            while (idx >= 0) {
+                yield buf.slice(0, idx).replace(/\r$/, '');
+                buf = buf.slice(idx + 1);
+                idx = buf.indexOf('\n');
+            }
+        }
+        if (buf)
+            yield buf.replace(/\r$/, '');
+    }
+    finally {
+        // 提前 break（abort 等）时释放读锁，否则流不会被回收
+        try {
+            await reader.cancel();
+        }
+        catch {
+            /* 已结束/已取消 */
+        }
+    }
+}
+/** 取消息里的全部文本块（非流式回落路径一次性回调用） */
+function textOf(message) {
+    return message.content
+        .filter((b) => b.type === 'text')
+        .map((b) => b.text)
+        .join('');
 }
 //# sourceMappingURL=anthropic.js.map

package/dist/integrations/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/integrations/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAuC1C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAA+D;IAIzF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACrD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,qBAAqB,CAAC,OAAO,GAA2B,EAAE;IACxE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,OAAqD,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,sDAAsD;IACtD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAA6B,EAAE,cAAwC,EAAE,EAAE;QAC7F,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,YAAY,CAAC,SAAkB,EAAE,EAAE,GAAG,cAAc,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;IACnF,CAAC,CAA2B,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/integrations/anthropic.ts"],"names":[],"mappings":"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"}

package/dist/integrations/mcp.d.ts

@@ -48,18 +48,27 @@ export interface McpToolsOptions {
     /** server 标识，只用于拼缺省前缀（不会发给 server） */
     server?: string;
     /**
-     * 单次 `callTool` 超时（毫秒），缺省 60000；非正数 = 不限。
-     * 超时**不杀 run**：该条 tool_result 记 `is_error` 回模型（与 engine 的
-     * `toolTimeoutMs` 同语义，只是这里由桥自己兜 —— 双保险，谁短谁生效）。
+     * **兜底**单次 `callTool` 超时（毫秒），缺省 60000；非正数 = 不限。
+     *
+     * ⚠️ 语义（见 spec §10 2026-09-17 ①）：**引擎设了 `toolTimeoutMs` 时本项不参与判定** ——
+     * 一次调用只有一个裁判，否则同一件事会有两个计时器、两种账。它只在两种情况生效：
+     * ① 桥脱离引擎单用（直接 `tool.run(...)`，没有 ctx）；② 引擎没设 `toolTimeoutMs`。
+     *
+     * 超时**不杀 run**：该条 tool_result 记 `is_error`、`errorKind='timeout'` 回模型。
+     * 与 engine 的 `toolTimeoutMs` **同判定、同账目**（共用 `core/timeout.ts` 的实测耗时兜底）。
      */
     timeoutMs?: number;
 }
 /** 缺省超时：MCP server 可能去连外部系统，60s 是「明显卡死」与「慢但正常」的分界 */
 export declare const MCP_DEFAULT_TIMEOUT_MS = 60000;
 /**
- * 给一次 MCP 调用套超时。⚠️ 与 engine 的 `withTimeout` 同样是**放弃等待**而非取消 ——
+ * 给一次 MCP 调用套超时。⚠️ 与引擎的工具超时同样是**放弃等待**而非取消 ——
  * MCP 的 `notifications/cancelled` 属于连接器职责，桥这一层拿不到取消句柄。
  *
+ * 实现是 `core/timeout.ts` 共享原语的**薄封装**（2026-09-17 单源化，见 spec §10 2026-09-17 ①）：
+ * 「一次调用只有一个预算判定」在引擎与桥之间只允许有一份实现。此前桥自带一份**纯竞速**
+ * 版本，于是 2026-09-14 的「超时是硬的」收紧只落进引擎，桥继续把**超预算**的调用记成成功。
+ *
  * 转导导出（module 级，**不进公共面**）只为可测：`tests/timeoutLiveness.test.ts` 拿它验
  * 「截止计时器不得 unref」—— 那是「被 await 的超时到底会不会触发」的唯一分界点。
  */

package/dist/integrations/mcp.js

@@ -1,3 +1,4 @@
+import { TIMED_OUT, TimeoutError, withTimeout } from '../core/timeout.js';
 /** 缺省超时：MCP server 可能去连外部系统，60s 是「明显卡死」与「慢但正常」的分界 */
 export const MCP_DEFAULT_TIMEOUT_MS = 60_000;
 /**
@@ -13,37 +14,24 @@ function normalizeToolName(raw) {
         .replace(/^_+|_+$/g, '');
     return cleaned;
 }
-/** 超时哨兵：区分「超时」与「工具恰好返回了 undefined」（同 engine 的 TIMED_OUT） */
-const TIMED_OUT = Symbol('agentia.mcp.timed-out');
 /**
- * 给一次 MCP 调用套超时。⚠️ 与 engine 的 `withTimeout` 同样是**放弃等待**而非取消 ——
+ * 给一次 MCP 调用套超时。⚠️ 与引擎的工具超时同样是**放弃等待**而非取消 ——
  * MCP 的 `notifications/cancelled` 属于连接器职责，桥这一层拿不到取消句柄。
  *
+ * 实现是 `core/timeout.ts` 共享原语的**薄封装**（2026-09-17 单源化，见 spec §10 2026-09-17 ①）：
+ * 「一次调用只有一个预算判定」在引擎与桥之间只允许有一份实现。此前桥自带一份**纯竞速**
+ * 版本，于是 2026-09-14 的「超时是硬的」收紧只落进引擎，桥继续把**超预算**的调用记成成功。
+ *
  * 转导导出（module 级，**不进公共面**）只为可测：`tests/timeoutLiveness.test.ts` 拿它验
  * 「截止计时器不得 unref」—— 那是「被 await 的超时到底会不会触发」的唯一分界点。
  */
 export async function withDeadline(p, timeoutMs, label) {
-    if (!(timeoutMs > 0))
-        return p;
-    let timer;
-    try {
-        const raced = await Promise.race([
-            p,
-            new Promise((resolve) => {
-                timer = setTimeout(() => resolve(TIMED_OUT), timeoutMs);
-                // ⚠️ 不 unref：同 engine 的 `withTimeout` —— 它的触发是「这个 await 得以结束」的条件。
-                // unref 过它 ⇒ 空事件循环下进程先退出，挂起的 MCP 调用让整段代码静默消失。
-            }),
-        ]);
-        if (raced === TIMED_OUT) {
-            throw new Error(`MCP 工具 "${label}" 调用超时（超过 ${timeoutMs}ms）`);
-        }
-        return raced;
-    }
-    finally {
-        if (timer)
-            clearTimeout(timer);
+    const out = await withTimeout(p, timeoutMs);
+    if (out === TIMED_OUT) {
+        // 类型化超时（code='timeout'）⇒ 引擎记 errorKind='timeout'，与它自己判的超时同一类账。
+        throw new TimeoutError(`MCP 工具 "${label}" 调用超时（超过 ${timeoutMs}ms）`);
     }
+    return out;
 }
 /**
  * 把一个 MCP server 的工具映射成框架的 `AgentTool[]`（可直接进 `tools` / providers）。
@@ -90,15 +78,22 @@ export async function mcpTools(client, opts = {}) {
         const schema = info.inputSchema && typeof info.inputSchema === 'object' && !Array.isArray(info.inputSchema)
             ? info.inputSchema
             : { type: 'object' };
+        // 外部 server 的 tools/list 是**外部输入**：description 不是 string（数字/对象）时
+        // 直接 `.trim()` 会让整个装配期崩 —— 与上面 name / inputSchema 的类型防御保持一致。
+        const description = typeof info.description === 'string' ? info.description.trim() : '';
         tools.push({
             name,
-            description: info.description?.trim() || `MCP 工具 ${original}`,
+            description: description || `MCP 工具 ${original}`,
             inputSchema: schema,
             run: async (input, ctx) => {
                 // 原名先落账再调用：连接器抛错/超时时，trace 里仍留得下「本想调谁」
                 if (ctx) {
                     try {
+                        // 两条键：`mcp.tool` 是「本次 turn 最近一次」的兼容键（既有看板/查询照旧）；
+                        // `mcp.tool.<菜单名>` 每次调用各写一条 —— 同回合并行调多个 MCP 工具时单值键会被
+                        // 后者覆盖，审计/回放就拿不回被覆盖那个（按菜单名分键即无此问题）。
                         ctx.recorder.setAttribute(ctx.parentSpanId, 'mcp.tool', original);
+                        ctx.recorder.setAttribute(ctx.parentSpanId, `mcp.tool.${name}`, original);
                     }
                     catch {
                         /* 观测是辅助动作：记账失败不得把一次正常调用变成失败 */
@@ -107,6 +102,14 @@ export async function mcpTools(client, opts = {}) {
                 const args = input && typeof input === 'object' && !Array.isArray(input)
                     ? input
                     : {};
+                // 裁判权（2026-09-17，见 spec §10 2026-09-17 ①）：引擎设了工具预算时，桥**不启动自己的计时器** ——
+                // 两个计时器判同一件事，只会得到两种账（桥那份曾被记成 error(unknown)/errorKind=threw），
+                // 而且桥的纯竞速还会把超了预算的调用记成成功。`timeoutMs` 退化为兜底（脱离引擎单用 /
+                // 引擎没设 toolTimeoutMs 时生效）。
+                const engineBudget = ctx?.toolTimeoutMs;
+                if (engineBudget != null && engineBudget > 0) {
+                    return client.callTool(original, args);
+                }
                 return withDeadline(client.callTool(original, args), timeoutMs, original);
             },
         });

package/dist/integrations/mcp.js.map

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

package/dist/integrations/openai.d.ts

@@ -3,7 +3,7 @@ import type { ModelClient } from '../core/tool.js';
  * OpenAI 兼容端点适配器（R4 多模型）。
  *
  * 把 engine 的 Anthropic 形态请求翻译成 OpenAI chat.completions 请求，
- * 响应再翻译回 Anthropic.Message —— 产出的 ModelClient 可直接喂给
+ * 响应再翻译回 Message —— 产出的 ModelClient 可直接喂给
  * executeRun / runAgent 的 client 选项。兼容端点（DeepSeek 等）换 baseURL 即可。
  *
  * 剩余边界（**协议层面无法对齐**，不是没做）：

package/dist/integrations/openai.js

@@ -174,7 +174,7 @@ function imageUrlOf(b) {
     return null;
 }
 /**
- * 消费 `text/event-stream` 并组装成 Anthropic.Message。
+ * 消费 `text/event-stream` 并组装成 Message。
  *
  * 关键点（每条都有对应单测）：
  * - **`id` / `name` 取首次出现的值**（OpenAI 在第一个分片给全），
@@ -250,7 +250,7 @@ function applyChunk(acc, chunk, textCallbacks) {
     if (choice.finish_reason)
         acc.finish = choice.finish_reason;
 }
-/** 累积器 → Anthropic.Message */
+/** 累积器 → Message */
 function accumulatorToMessage(acc, fallbackModel) {
     const content = [];
     if (acc.text)
@@ -328,7 +328,7 @@ async function* sseLines(body) {
         }
     }
 }
-/** OpenAI chat.completions 响应 → Anthropic.Message */
+/** OpenAI chat.completions 响应 → Message */
 function toAnthropicMessage(data, model) {
     const choice = data.choices?.[0];
     if (!choice) {