@migor/agentia 0.4.2 → 0.6.0

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":"AAwDA;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAS;IACxB,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,UAAU,qBAAqB,CAAC,OAAO,GAA2B,EAAE;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC/D,MAAM,OAAO,GAAG,CACd,OAAO,CAAC,OAAO;QACf,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAC9B,2BAA2B,CAC5B,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtB,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpF,OAAO;QACL,QAAQ,EAAE;YACR,MAAM,CAAC,MAAM;gBACX,MAAM,aAAa,GAAmC,EAAE,CAAC;gBACzD,kDAAkD;gBAClD,gEAAgE;gBAChE,+CAA+C;gBAC/C,qCAAqC;gBACrC,MAAM,IAAI,GAAG,CAAC,KAAK,IAAsB,EAAE;oBACzC,iDAAiD;oBACjD,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;oBACvD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;oBACnE,IAAI,CAAC;wBACH,MAAM,GAAG,GAAG,MAAM,eAAe,CAC/B,GAAG,OAAO,cAAc,EACxB;4BACE,cAAc,EAAE,kBAAkB;4BAClC,mBAAmB,EAAE,YAAY;4BACjC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC3C,EACD,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAC/C,MAAM,EACN,UAAU,CACX,CAAC;wBAEF,wDAAwD;wBACxD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;wBACpD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;4BACpC,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;4BAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;4BAC7B,IAAI,IAAI;gCAAE,KAAK,MAAM,EAAE,IAAI,aAAa;oCAAE,EAAE,CAAC,IAAI,CAAC,CAAC;4BACnD,OAAO,OAAO,CAAC;wBACjB,CAAC;wBAED,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;4BACd,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;wBACpE,CAAC;wBACD,OAAO,MAAM,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;oBAC1E,CAAC;4BAAS,CAAC;wBACT,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC,EAAE,CAAC;gBACL,oEAAoE;gBACpE,0DAA0D;gBAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACrB,OAAO;oBACL,EAAE,CAAC,KAAa,EAAE,EAA2B;wBAC3C,IAAI,KAAK,KAAK,MAAM;4BAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC/C,CAAC;oBACD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;iBACzB,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,4BAA4B;AAE5B;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,MAAc;IACvC,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAC5B,GAAW,EACX,OAA+B,EAC/B,IAAY,EACZ,MAA+B,EAC/B,UAAkB;IAElB,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,0CAA0C;YAC1C,MAAM,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;YACjE,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBACrB,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oDAAoD;YACpD,IAAK,CAAwB,EAAE,IAAI,KAAK,YAAY,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,CAAC,CAAC;YACjF,kEAAkE;YAClE,IAAI,OAAO,IAAI,UAAU;gBAAE,MAAM,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,GAAG,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9D,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;YAC1D,sCAAsC;YACtC,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,OAAe,EAAE,UAAyB;IAC3D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;QACvE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7D,cAAc;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,EAAU,EAAE,MAAoB;IAC1D,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACtC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,UAAU,GAAG,GAAU,EAAE,CAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC7D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,SAAS,OAAO;YACd,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,YAAqC,EACrC,SAA6B;IAE7B,IAAI,SAAS,IAAI,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC1E,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,2CAA2C;QAC3C,6CAA6C;QAC7C,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,kBAAkB,SAAS,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IACtF,CAAC,EAAE,SAAS,CAAC,CAAC;IACd,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,sCAAsC;IACrD,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACnE,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,YAAY,CAAC,OAAO;YAAE,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;;YAC3D,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO,EAAE,GAAG,EAAE;YACZ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,YAAY,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAiED;;;;;;;;;;;;;;;;;;GAkBG;AACH,KAAK,UAAU,mBAAmB,CAChC,IAAgC,EAChC,aAAqB,EACrB,aAA6C;IAE7C,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,KAAK,GAAa,EAAE,CAAC;IAEzB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS,CAAC,sBAAsB;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,KAAkB,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,iCAAiC;QAC7C,CAAC;QACD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,eAAe,EAAE,CAAC;gBACrB,OAAO,GAAG,IAAI,CAAC;gBACf,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC;gBAC7B,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;gBACnC,KAAK,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;gBACpC,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,EAAE,CAAC;gBAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,MAAM,CAAC;gBAC/B,MAAM,GAAG,GAAa;oBACpB,IAAI;oBACJ,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;oBAChD,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;oBAC5D,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;oBAC/D,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;oBAC1C,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;oBAChD,WAAW,EAAE,EAAE;iBAChB,CAAC;gBACF,gDAAgD;gBAChD,oCAAoC;gBACpC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;oBAClE,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC;gBAC5B,CAAC;gBACD,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;gBAC3C,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;gBACtB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;oBAAE,MAAM;gBACpB,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1D,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;oBACjB,6BAA6B;oBAC7B,KAAK,MAAM,EAAE,IAAI,aAAa;wBAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC;qBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;oBAC/E,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,YAAY,CAAC;gBAClC,CAAC;qBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACzE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC;gBAC3B,CAAC;qBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAC3E,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,eAAe,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;gBACtB,IAAI,CAAC,EAAE,WAAW;oBAAE,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC;gBAC/C,IAAI,CAAC,EAAE,aAAa,KAAK,SAAS;oBAAE,YAAY,GAAG,CAAC,CAAC,aAAa,CAAC;gBACnE,+DAA+D;gBAC/D,IAAI,KAAK,CAAC,KAAK;oBAAE,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;gBACtD,MAAM;YACR,CAAC;YACD,KAAK,OAAO,EAAE,CAAC;gBACb,2CAA2C;gBAC3C,iCAAiC;gBACjC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC9B,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAC7B,kBAAkB,GAAG,CAAC,IAAI,IAAI,SAAS,KAAK,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACnF,CAAC;YACJ,CAAC;YACD;gBACE,MAAM,CAAC,oDAAoD;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC;YAAE,SAAS,CAAC,cAAc;QAChC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC;aACrB,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;aACI,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACjB,4DAA4D;YAC5D,6CAA6C;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAA8B,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAe,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,EAAE,IAAI,aAAa;QACvB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,KAAK,IAAI,aAAa;QAC7B,OAAO;QACP,WAAW,EAAE,UAAwB;QACrC,aAAa,EAAE,YAAY;QAC3B,KAAK,EAAE;YACL,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;YACrC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;YACvC,2BAA2B,EAAE,KAAK,CAAC,2BAA2B,IAAI,CAAC;YACnE,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,IAAI,CAAC;SAC5D;KACS,CAAC;AACf,CAAC;AAED,sDAAsD;AACtD,SAAS,mBAAmB,CAAC,IAAwB;IACnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,kBAAkB;YACrB,OAAO,GAAG,CAAC;QACb,KAAK,kBAAkB;YACrB,OAAO,GAAG,CAAC;QACb;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,KAAK,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAgC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,IAAI,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5B,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;gBAChB,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC3C,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACzB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,IAAI,GAAG;YAAE,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,kCAAkC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED,gCAAgC;AAChC,SAAS,MAAM,CAAC,OAAgB;IAC9B,OAAO,OAAO,CAAC,OAAO;SACnB,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/integrations/metrics.d.ts

@@ -12,6 +12,8 @@ import type { TraceSink } from '../core/trace.js';
  *   `skill` / `subagent` 来自 `capability` span（tracer 已把子孙 llm.turn 的 usage 聚合上去）；
  *   `@Prompt` 不建 span、无独立耗时，**不产出**能力指标（如实缺省，不硬凑）；
  * - **模型级**（E3）：来自 `llm.turn` span（其 `name` 即模型 id）。
+ * - **评分级**（R7 质量闭环）：来自 run 根 span 的 `score` 事件（`attachScore` 写入）——
+ *   gauge 记**最近一次**值（分数不是累加量），counter 记条数；label 为 `name` × `source`。
  *
  * 时长同时给两种口径（histogram 与分位 gauge 必须用**不同指标名**，见 `render()` 注释）：
  * - **histogram**（`*_bucket` / `*_sum` / `*_count`，累积语义）—— 抓取端可跨实例任意聚合；
@@ -46,6 +48,15 @@ export interface ModelMetrics {
     latencyP50: number;
     latencyP95: number;
 }
+/** 评分维度指标（`snapshot().scores[key]`，key 为 `name@source`，source 缺省时裸 name） */
+export interface ScoreMetrics {
+    /** 最近一次评分值（gauge 语义 —— 分数不是累加量） */
+    value: number;
+    /** 评分条数 */
+    count: number;
+    /** 评分值合计（平均 = sum / count） */
+    sum: number;
+}
 /** 进程内累计快照（`snapshot()` 返回） */
 export interface MetricsSnapshot {
     /** 投递过 trace 的 run 总数（= `export` 被调用次数） */
@@ -66,6 +77,8 @@ export interface MetricsSnapshot {
     capabilities: Record<string, CapabilityMetrics>;
     /** 模型维度 */
     models: Record<string, ModelMetrics>;
+    /** 评分维度（key 为 `name@source`，source 缺省时裸 name；无评分时为空对象） */
+    scores: Record<string, ScoreMetrics>;
     /** 因 `maxCapabilities` 上限被归入 `__other__` 的不同能力数（未开启上限时为 0） */
     droppedCapabilities: number;
 }

package/dist/integrations/metrics.js

@@ -134,6 +134,8 @@ export function metricsSink(opts = {}) {
     const runStat = new DurationStat(windowSize, buckets);
     const capabilities = new Map();
     const models = new Map();
+    /** 评分累加器：key = `${name}\t${source}`（source 缺省 ''；\t 不会出现在正常评分名里，做天然分隔符） */
+    const scores = new Map();
     /** 已分配独立标签的能力键（超 maxCapabilities 后新键归 __other__） */
     const assignedCapabilities = new Set();
     /** 被归入 __other__ 的不同能力键 */
@@ -175,6 +177,29 @@ export function metricsSink(opts = {}) {
         const d = runDurationMs(trace);
         if (d !== undefined)
             runStat.add(d);
+        // —— 评分（R7）：只认根 span 的 score 事件（attachScore 的写入位置）；
+        // body 宽容读取 —— name 不是 string / value 不是有限 number 就跳过，观测不击穿业务
+        const rootSpan = trace.spans.find((s) => s.spanId === trace.rootSpanId);
+        if (rootSpan) {
+            for (const e of rootSpan.events) {
+                if (e.name !== 'score')
+                    continue;
+                const body = e.body;
+                if (!body || typeof body !== 'object')
+                    continue;
+                if (typeof body.name !== 'string')
+                    continue;
+                if (typeof body.value !== 'number' || !Number.isFinite(body.value))
+                    continue;
+                const source = typeof body.source === 'string' ? body.source : '';
+                const key = `${body.name}\t${source}`;
+                const acc = scores.get(key) ?? { value: 0, count: 0, sum: 0 };
+                acc.value = body.value; // gauge 语义：覆盖为最近一次
+                acc.count++;
+                acc.sum += body.value;
+                scores.set(key, acc);
+            }
+        }
         for (const span of trace.spans) {
             if (span.kind === 'capability') {
                 const label = labelFor(capabilityKindOf(span), span.name);
@@ -269,6 +294,13 @@ export function metricsSink(opts = {}) {
                 latencyP95: acc.stat.percentile(0.95),
             };
         }
+        const scoreOut = {};
+        for (const [key, acc] of scores) {
+            const tab = key.indexOf('\t');
+            const name = key.slice(0, tab);
+            const source = key.slice(tab + 1);
+            scoreOut[source === '' ? name : `${name}@${source}`] = { ...acc };
+        }
         return {
             runs,
             failed,
@@ -278,6 +310,7 @@ export function metricsSink(opts = {}) {
             costUsd,
             capabilities: capabilityOut,
             models: modelOut,
+            scores: scoreOut,
             droppedCapabilities: dropped.size,
         };
     };
@@ -392,6 +425,20 @@ export function metricsSink(opts = {}) {
             out.push(family(`${p}model_duration_ms`, 'histogram', '模型往返耗时（毫秒）', durations));
             out.push(family(`${p}model_duration_ms_last`, 'gauge', '模型往返耗时分位（窗口内精确值）', durationQuantiles));
         }
+        // —— 评分维度（R7）：gauge 记最近一次值、counter 记条数，label 为 name × source ——
+        if (scores.size > 0) {
+            const gaugeSamples = [];
+            const counterSamples = [];
+            for (const key of [...scores.keys()].sort()) {
+                const acc = scores.get(key);
+                const tab = key.indexOf('\t');
+                const l = `{name="${escLabel(key.slice(0, tab))}",source="${escLabel(key.slice(tab + 1))}"}`;
+                gaugeSamples.push(`${p}score${l} ${acc.value}`);
+                counterSamples.push(`${p}score_total${l} ${acc.count}`);
+            }
+            out.push(family(`${p}score`, 'gauge', '最近一次评分（label 为评分维度与来源）', gaugeSamples));
+            out.push(family(`${p}score_total`, 'counter', '评分条数', counterSamples));
+        }
         return out.join('');
     };
     // —— OTLP/JSON 导出（E5）——
@@ -426,6 +473,16 @@ export function metricsSink(opts = {}) {
                 ],
             },
         });
+        // gauge 没有理由只收 int：评分值是浮点，统一走 asDouble
+        const gauge = (name, value, help, attrs) => ({
+            name,
+            description: help,
+            gauge: {
+                dataPoints: [
+                    { attributes: attrs, startTimeUnixNano: start, timeUnixNano: now, asDouble: value },
+                ],
+            },
+        });
         const hist = (name, stat, help, attrs) => ({
             name,
             description: help,
@@ -481,6 +538,13 @@ export function metricsSink(opts = {}) {
             }
             metrics.push(hist(`${p}model_duration_ms`, acc.stat, '模型往返耗时（毫秒）', attrs));
         }
+        for (const key of [...scores.keys()].sort()) {
+            const acc = scores.get(key);
+            const tab = key.indexOf('\t');
+            const attrs = [strAttr('name', key.slice(0, tab)), strAttr('source', key.slice(tab + 1))];
+            metrics.push(gauge(`${p}score`, acc.value, '最近一次评分', attrs));
+            metrics.push(sum(`${p}score_total`, acc.count, '评分条数', attrs));
+        }
         const resourceAttrs = [
             strAttr('service.name', serviceName),
             ...Object.entries(opts.resourceAttributes ?? {}).map(([k, v]) => strAttr(k, v)),
@@ -554,6 +618,7 @@ export function metricsSink(opts = {}) {
             runStat.reset();
             capabilities.clear();
             models.clear();
+            scores.clear();
             assignedCapabilities.clear();
             dropped.clear();
         },