niceeval 0.12.1 → 0.12.2-canary.31

package/dist/agents/ai-sdk.cjs

@@ -0,0 +1,412 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.turnFromAiSdk = turnFromAiSdk;
+exports.aiSdkAgent = aiSdkAgent;
+// AI SDK(Vercel `ai` 包)结果 → 标准事件流的共享转换器(采集通道 0:进程内直构)。
+//
+// 结构化 typing,不依赖 `ai` 包:niceeval 只认识 generateText / streamText 完整结果的
+// 【形状子集】。字段名跨 AI SDK 大版本漂移(v4 args/result/promptTokens、v5+ input/output/
+// inputTokens、v7 inputTokenDetails)在这里统一兜住,adapter 作者不必各自写防御代码,也不必
+// 像手工 recorder 那样包住每个工具的 execute —— AI SDK 的 steps 里本来就有带 toolCallId 的
+// 完整调用记录。
+//
+// v7 的 tool approval(工具带 `needsApproval`)也在这里兜:
+//   · `tool-approval-request` part → `input.requested` 事件 + 整轮 `status: "waiting"`,
+//     直接满足 HITL 契约的「waiting + input.requested」两条义务(resume 仍归 adapter 管);
+//   · 批准 / 拒绝后的 resume 结果里,执行结果只出现在 `responseMessages` 的 tool 消息中
+//     (不在 steps 里),这里挖出来补成 `operation.finished` —— 拒绝(execution-denied)映射成
+//     `status: "rejected"`,喂 `calledTool(..., { status: "rejected" })` 与 `noFailedActions()`。
+const coverage_ts_1 = require("../assertions/coverage.cjs");
+const node_crypto_1 = require("node:crypto");
+const define_ts_1 = require("../define.cjs");
+const send_failures_ts_1 = require("../context/send-failures.cjs");
+const external_cause_ts_1 = require("../shared/external-cause.cjs");
+const json_value_ts_1 = require("../shared/json-value.cjs");
+const tool_names_ts_1 = require("../o11y/tool-names.cjs");
+const command_projection_ts_1 = require("../o11y/command-projection.cjs");
+// ───────────────────────── 转换 ─────────────────────────
+/**
+ * AI SDK 结果 → `{ events, usage, status }`,直接铺进 `Turn` 返回:
+ *
+ * ```typescript
+ * const result = await generateText({ model, tools, prompt: input.text });
+ * return { ...turnFromAiSdk(result), data: result.text };
+ * ```
+ *
+ * `callId` 用 AI SDK 原生的 `toolCallId`(显式配对,不合成);工具名保留原名进 `name`,
+ * canonical 名进 `tool`(认不出的域内工具落 "unknown",`calledTool("get_weather")`
+ * 仍按原名匹配)。工具执行失败(v5+ 的 `tool-error` part)映射成 `status: "failed"` 的
+ * `operation.finished`,喂 `noFailedActions()`。
+ *
+ * v7 tool approval:`needsApproval` 工具被拦下时返回 `status: "waiting"` + 每个待批准
+ * 调用一条 `input.requested`(`id` = approvalId、`action` = 工具原名、`options` =
+ * approve / deny)。resume(把 `tool-approval-response` 塞回 messages 再跑一次)后的结果
+ * 再交给 turnFromAiSdk,会从 `responseMessages` 里补出执行 / 拒绝的 `operation.finished`。
+ */
+function turnFromAiSdk(result) {
+    const stepEvents = [];
+    const steps = result.steps && result.steps.length > 0
+        ? result.steps
+        : [{ text: result.text, toolCalls: result.toolCalls, toolResults: result.toolResults }];
+    const seen = { called: new Set(), resolved: new Set() };
+    for (const step of steps) {
+        if (Array.isArray(step.content) && step.content.length > 0) {
+            pushContentParts(stepEvents, step.content, seen);
+        }
+        else {
+            pushStepFields(stepEvents, step, seen);
+        }
+    }
+    // approval resume 时被拦工具的执行结果只在 responseMessages 里;补出的 operation.finished
+    // 排在本轮 step 事件之前 —— 时间上它确实先于模型看到结果后的新输出。
+    const minedEvents = mineResponseMessages(result.responseMessages, seen.resolved);
+    const events = [...minedEvents, ...stepEvents];
+    const waiting = events.some((e) => e.type === "input.requested");
+    const evidenceCoverage = (0, command_projection_ts_1.unclassifiedToolActionsCoverage)(events);
+    return {
+        events,
+        usage: readUsage(result, steps.length),
+        status: waiting ? "waiting" : "completed",
+        ...(evidenceCoverage === undefined ? {} : { evidenceCoverage }),
+    };
+}
+/** v5+ 路径:content parts 自带真实顺序,逐个翻译。 */
+function pushContentParts(events, parts, seen) {
+    for (const part of parts) {
+        switch (part.type) {
+            case "text": {
+                const text = str(part.text);
+                if (text)
+                    events.push({ type: "message", role: "assistant", text });
+                break;
+            }
+            case "reasoning": {
+                const text = str(part.text);
+                if (text)
+                    events.push({ type: "thinking", text });
+                break;
+            }
+            case "tool-call": {
+                pushCalled(events, seen, {
+                    toolCallId: str(part.toolCallId) ?? "unknown",
+                    toolName: str(part.toolName) ?? "unknown",
+                    input: part.input ?? part.args,
+                });
+                break;
+            }
+            case "tool-result": {
+                const callId = str(part.toolCallId) ?? "unknown";
+                seen.resolved.add(callId);
+                events.push({
+                    type: "operation.finished",
+                    operationId: callId,
+                    kind: "tool",
+                    output: asJson(part.output ?? part.result),
+                    status: "completed",
+                });
+                break;
+            }
+            case "tool-error": {
+                const callId = str(part.toolCallId) ?? "unknown";
+                seen.resolved.add(callId);
+                events.push({
+                    type: "operation.finished",
+                    operationId: callId,
+                    kind: "tool",
+                    output: { error: part.error instanceof Error ? part.error.message : String(part.error) },
+                    status: "failed",
+                });
+                break;
+            }
+            case "tool-approval-request": {
+                // 同一 step 里通常已有配对的 tool-call part(去重);没有时从 toolCall 字段补。
+                const call = part.toolCall;
+                if (call) {
+                    pushCalled(events, seen, {
+                        toolCallId: str(call.toolCallId) ?? "unknown",
+                        toolName: str(call.toolName) ?? "unknown",
+                        input: call.input ?? call.args,
+                    });
+                }
+                if (part.isAutomatic === true)
+                    break; // SDK 自动裁决,不用等人
+                const request = {
+                    id: str(part.approvalId),
+                    action: call ? str(call.toolName) : undefined,
+                    input: call ? asJson(call.input ?? call.args) : undefined,
+                    options: [{ id: "approve" }, { id: "deny" }],
+                };
+                events.push({ type: "input.requested", request });
+                break;
+            }
+            default:
+                break; // source / file 等其余 part 类型对断言无意义,丢弃
+        }
+    }
+}
+/** 退路(v4 / 无 content parts):toolCalls + toolResults + text,顺序按「调用 → 结果 → 文本」近似。 */
+function pushStepFields(events, step, seen) {
+    if (step.reasoningText)
+        events.push({ type: "thinking", text: step.reasoningText });
+    for (const call of step.toolCalls ?? []) {
+        pushCalled(events, seen, { toolCallId: call.toolCallId, toolName: call.toolName, input: call.input ?? call.args });
+    }
+    for (const res of step.toolResults ?? []) {
+        seen.resolved.add(res.toolCallId);
+        events.push({
+            type: "operation.finished",
+            operationId: res.toolCallId,
+            kind: "tool",
+            output: asJson(res.output ?? res.result),
+            status: "completed",
+        });
+    }
+    if (step.text?.trim())
+        events.push({ type: "message", role: "assistant", text: step.text });
+}
+/** 同一原生 tool call ID 只发一条 operation.started(tool-call part 与 approval-request 会重)。 */
+function pushCalled(events, seen, call) {
+    if (seen.called.has(call.toolCallId))
+        return;
+    seen.called.add(call.toolCallId);
+    events.push({
+        type: "operation.started",
+        operationId: call.toolCallId,
+        operation: {
+            kind: "tool",
+            name: call.toolName,
+            input: asJson(call.input),
+            tool: normalizeToolName(call.toolName),
+        },
+    });
+}
+/**
+ * 从 responseMessages 的 tool 消息里挖 steps 没有的 tool-result(v7 approval resume 的
+ * 执行结果只在这里)。output 是 ToolResultOutput 包装({ type: "json" | "text" |
+ * "execution-denied" | "error-text" | … }),按类型解包;`execution-denied` → "rejected"。
+ */
+function mineResponseMessages(messages, resolved) {
+    const events = [];
+    for (const msg of messages ?? []) {
+        if (msg.role !== "tool" || !Array.isArray(msg.content))
+            continue;
+        for (const part of msg.content) {
+            if (part.type !== "tool-result")
+                continue;
+            const callId = str(part.toolCallId);
+            if (!callId || resolved.has(callId))
+                continue;
+            events.push({ type: "operation.finished", operationId: callId, kind: "tool", ...unwrapToolOutput(part.output) });
+        }
+    }
+    return events;
+}
+function unwrapToolOutput(output) {
+    if (output && typeof output === "object" && !Array.isArray(output)) {
+        const wrapped = output;
+        switch (wrapped.type) {
+            case "json":
+            case "text":
+            case "content":
+                return { output: asJson(wrapped.value), status: "completed" };
+            case "execution-denied":
+                return {
+                    output: str(wrapped.reason) ? { reason: str(wrapped.reason) } : undefined,
+                    status: "rejected",
+                };
+            case "error-text":
+            case "error-json":
+                return { output: { error: asJson(wrapped.value) }, status: "failed" };
+            default:
+                break;
+        }
+    }
+    return { output: asJson(output), status: "completed" };
+}
+/** totalUsage(v5/v6 的全 steps 聚合)优先;v7 的 usage 本身就是聚合;requests = step 数。 */
+function readUsage(result, stepCount) {
+    const u = result.totalUsage ?? result.usage;
+    if (!u)
+        return undefined;
+    const rawInput = num(u.inputTokens) ?? num(u.promptTokens) ?? 0;
+    const outputTokens = num(u.outputTokens) ?? num(u.completionTokens) ?? 0;
+    if (rawInput === 0 && outputTokens === 0)
+        return undefined;
+    const cacheRead = num(u.cachedInputTokens) ?? num(u.inputTokenDetails?.cacheReadTokens) ?? 0;
+    const cacheCreation = num(u.inputTokenDetails?.cacheWriteTokens) ?? 0;
+    // AI SDK 的 inputTokens 是含缓存明细的输入总量,落互斥桶前扣掉在场的明细
+    // (docs/feature/adapters/sdk/ai-sdk/cost.md)
+    const inputTokens = Math.max(0, rawInput - cacheRead - cacheCreation);
+    const usage = { inputTokens, outputTokens, requests: Math.max(stepCount, 1) };
+    if (cacheRead)
+        usage.cacheReadTokens = cacheRead;
+    if (cacheCreation)
+        usage.cacheCreationTokens = cacheCreation;
+    const reasoning = num(u.reasoningTokens);
+    if (reasoning)
+        usage.reasoningTokens = reasoning;
+    return usage;
+}
+/** AI SDK 应用的工具多为域内自定义名(get_weather…),canonical 落 "unknown" 即可;仅认通用别名基表。 */
+function normalizeToolName(name) {
+    return (0, tool_names_ts_1.normalizeToolName)(name);
+}
+/** 工具入参 / 出参来自可替换的 AI SDK 版本；在边界立即清洗成领域 JsonValue。 */
+function asJson(value) {
+    return (0, json_value_ts_1.normalizeJsonValue)(value);
+}
+function str(value) {
+    return typeof value === "string" && value ? value : undefined;
+}
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * 内建的 AI SDK 进程内 agent 工厂:把「一个 generateText 调用」变成完整的 niceeval agent。
+ * 应用只写 `generate`(怎么召模型),协议侧的活全部由工厂承担:
+ *
+ *   · 多轮会话:ctx.session.id 未记录时开新会话线并 capture 回写,同一 id 续接同一份
+ *     messages 历史;
+ *   · 事件流:结果经 {@link turnFromAiSdk} 直构(toolCallId 配对、时序保真、usage);
+ *   · HITL:`needsApproval` 工具停轮 → `waiting` + `input.requested`;下一轮输入按行翻译成
+ *     tool-approval-response(以 approve / yes / 同意 / 批准 开头 = 批准,其余一律拒绝)塞回
+ *     messages 再召 `generate`,SDK 才会执行(或跳过)被拦的工具;
+ *   · 失败兜底:`generate` 抛错或结果完全为空 → `status: "failed"` + error 事件;
+ *   · tracing:传 `tracing: aiSdkOtel()`(来自 `niceeval/adapter/otel`)后,工厂替应用
+ *     做完 OTel 管线——为每轮建好绑定 niceeval 接收端点的 `@ai-sdk/otel` 集成(经
+ *     ctx.telemetry 交给 generate,原样透传给 generateText 的 `telemetry` 即可)并在轮末
+ *     flush;`aiSdkOtel({ backendUrl })` 可选双发到你自己的观测后端。应用侧零埋点代码。
+ *
+ * ```typescript
+ * import { aiSdkAgent } from "niceeval/adapter";
+ * import { generateText, isStepCount, type ModelMessage } from "ai";
+ *
+ * export const assistant = aiSdkAgent<ModelMessage>({
+ *   name: "my-assistant",
+ *   generate: ({ messages, model, signal }) =>
+ *     generateText({ model: resolveModel(model), system: SYSTEM_PROMPT,
+ *                    tools, stopWhen: isStepCount(5), messages, abortSignal: signal }),
+ *   data: (result) => ({ reply: result.text }),
+ * });
+ * ```
+ */
+function aiSdkAgent(options) {
+    const sessions = new Map();
+    return (0, define_ts_1.defineAgent)({
+        name: options.name ?? "ai-sdk",
+        // 官方 SDK 完整 steps/output:全通道 complete(见 adapters/architecture/evidence.md)。
+        evidenceCoverage: coverage_ts_1.completeEvidenceCoverage,
+        // tracing 开了才让运行器为这个 agent 起 OTLP 接收器(ctx.telemetry 才会出现);
+        // AgentTracing 的其余字段(env/configure/scope)这里都用不上,空对象即可。
+        tracing: options.tracing ? {} : undefined,
+        async send(input, ctx) {
+            // 会话续接:ctx.session.id 未记录时开新会话并 capture 回写;否则按 id 续接同一份历史。
+            const id = ctx.session.id ?? `ai-sdk-${(0, node_crypto_1.randomUUID)()}`;
+            ctx.session.capture(id);
+            let state = sessions.get(id);
+            if (!state) {
+                state = { messages: [], pendingApprovals: [] };
+                sessions.set(id, state);
+            }
+            if (state.pendingApprovals.length > 0) {
+                // HITL:t.respond 的回答到 adapter 就是一次普通的带 responses 的 send,按
+                // requestId(= approvalId)对位取裁决;没答到的请求直接报错,不从文本猜。
+                const content = state.pendingApprovals.map((approvalId) => ({
+                    type: "tool-approval-response",
+                    approvalId,
+                    approved: approvalDecision(input.responses, approvalId),
+                }));
+                state.pendingApprovals = [];
+                state.messages.push({ role: "tool", content });
+            }
+            else {
+                state.messages.push(userMessage(input.text, input.files));
+            }
+            // tracing 管线由调用方显式传入(niceeval/adapter/otel 的 aiSdkOtel()),工厂只管
+            // 每轮把 per-attempt 端点交给它、轮末 flush。
+            const otel = ctx.telemetry && options.tracing ? options.tracing.telemetryForEndpoint(ctx.telemetry.endpoint) : undefined;
+            let result;
+            try {
+                result = await options.generate({
+                    messages: state.messages,
+                    model: ctx.model,
+                    reasoningEffort: ctx.reasoningEffort,
+                    signal: ctx.signal,
+                    flags: ctx.flags,
+                    telemetry: otel?.settings,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw (0, send_failures_ts_1.makeSendFailure)({ acceptance: "unknown", message, cause: (0, external_cause_ts_1.normalizeExternalCause)(error) });
+            }
+            finally {
+                // 轮次归属靠时间窗口:本轮 span 必须在 send 返回前送到接收器,不能等 batch。
+                await otel?.flush();
+            }
+            // resume 的另一半义务:本次调用新产生的消息(含 approval 执行结果)进历史。
+            state.messages.push(...(result.responseMessages ?? []));
+            state.pendingApprovals = collectPendingApprovals(result);
+            const turn = turnFromAiSdk(result);
+            // 上游偶尔退化返回完全空的结果;当正常回复会把故障伪装成通过,按失败处理。
+            if (turn.events.length === 0) {
+                throw (0, send_failures_ts_1.makeSendFailure)({
+                    acceptance: "unknown",
+                    message: "AI SDK returned an empty result (no text, no tool calls)",
+                });
+            }
+            return { ...turn, data: options.data?.(result, turn) };
+        },
+    });
+}
+/** 裁决词法(t.respond 的自由文本回答):approve / yes / 同意 / 批准 开头 = 批准,其余一律拒绝。 */
+function isApproved(line) {
+    return /^(approve|yes|同意|批准)/i.test(line);
+}
+/** 按 requestId(= approvalId)从 input.responses 对位取裁决;optionId 优先,自由文本走 isApproved。 */
+function approvalDecision(responses, requestId) {
+    const matched = responses?.find((r) => r.requestId === requestId);
+    if (!matched) {
+        throw new Error(`No response for pending approval "${requestId}". Answer approval requests with t.respond(...).`);
+    }
+    if (matched.optionId !== undefined)
+        return matched.optionId === "approve";
+    return isApproved(matched.text?.trim() ?? "");
+}
+/** 待人批准的 approval 请求 id(非 automatic)。steps 优先,退回 v7 顶层聚合 content。 */
+function collectPendingApprovals(result) {
+    const parts = [];
+    if (result.steps?.length) {
+        for (const step of result.steps)
+            if (Array.isArray(step.content))
+                parts.push(...step.content);
+    }
+    else if (Array.isArray(result.content)) {
+        parts.push(...result.content);
+    }
+    const ids = [];
+    for (const part of parts) {
+        if (part.type !== "tool-approval-request" || part.isAutomatic === true)
+            continue;
+        const approvalId = str(part.approvalId);
+        if (approvalId)
+            ids.push(approvalId);
+    }
+    return ids;
+}
+/**
+ * t.sendFile 带来的文件(base64)转成 AI SDK 的多模态用户消息;纯文本就是纯文本。
+ * 用 `file` part(v7 推荐;`image` part 已废弃),mediaType 原样透传,图片之外的附件也能走。
+ */
+function userMessage(text, files) {
+    if (!files || files.length === 0)
+        return { role: "user", content: text };
+    return {
+        role: "user",
+        content: [
+            { type: "text", text: text || "请描述这个附件。" },
+            ...files.map((f) => ({ type: "file", mediaType: f.mimeType, data: f.dataBase64 })),
+        ],
+    };
+}
+//# sourceMappingURL=ai-sdk.cjs.map

package/dist/agents/ai-sdk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["ai-sdk.ts"],"names":[],"mappings":"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","sourcesContent":["// AI SDK(Vercel `ai` 包)结果 → 标准事件流的共享转换器(采集通道 0:进程内直构)。\n//\n// 结构化 typing,不依赖 `ai` 包:niceeval 只认识 generateText / streamText 完整结果的\n// 【形状子集】。字段名跨 AI SDK 大版本漂移(v4 args/result/promptTokens、v5+ input/output/\n// inputTokens、v7 inputTokenDetails)在这里统一兜住,adapter 作者不必各自写防御代码,也不必\n// 像手工 recorder 那样包住每个工具的 execute —— AI SDK 的 steps 里本来就有带 toolCallId 的\n// 完整调用记录。\n//\n// v7 的 tool approval(工具带 `needsApproval`)也在这里兜:\n//   · `tool-approval-request` part → `input.requested` 事件 + 整轮 `status: \"waiting\"`,\n//     直接满足 HITL 契约的「waiting + input.requested」两条义务(resume 仍归 adapter 管);\n//   · 批准 / 拒绝后的 resume 结果里,执行结果只出现在 `responseMessages` 的 tool 消息中\n//     (不在 steps 里),这里挖出来补成 `operation.finished` —— 拒绝(execution-denied)映射成\n//     `status: \"rejected\"`,喂 `calledTool(..., { status: \"rejected\" })` 与 `noFailedActions()`。\nimport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport { defineAgent } from \"../define.ts\";\nimport { makeSendFailure } from \"../context/send-failures.ts\";\nimport { normalizeExternalCause } from \"../shared/external-cause.ts\";\nimport { normalizeJsonValue } from \"../shared/json-value.ts\";\nimport { normalizeToolName as normalizeShared } from \"../o11y/tool-names.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport type { Agent, InputRequest, InputResponse, JsonValue, StreamEvent, ToolName, Usage } from \"../types.ts\";\n// ───────────────────────── AI SDK 结果的形状子集 ─────────────────────────\n/** 一次工具调用(v5+ 用 `input`,v4 用 `args`;两者都认)。 */\nexport interface AiSdkToolCallLike {\n    toolCallId: string;\n    toolName: string;\n    input?: unknown;\n    args?: unknown;\n}\n/** 一次工具结果(v5+ 用 `output`,v4 用 `result`)。 */\nexport interface AiSdkToolResultLike {\n    toolCallId: string;\n    toolName?: string;\n    output?: unknown;\n    result?: unknown;\n}\n/**\n * step.content 的一个 part(v5+)。带类型序:同一 step 里 reasoning / text / tool-call /\n * tool-result / tool-error / tool-approval-request 按真实发生顺序排 —— 有它就优先用它,时序保真。\n */\nexport interface AiSdkContentPartLike {\n    type: string;\n    text?: unknown;\n    toolCallId?: unknown;\n    toolName?: unknown;\n    input?: unknown;\n    args?: unknown;\n    output?: unknown;\n    result?: unknown;\n    error?: unknown;\n    /** v7 tool approval:`tool-approval-request` part 的请求 id 与被拦下的调用。 */\n    approvalId?: unknown;\n    isAutomatic?: unknown;\n    toolCall?: {\n        toolCallId?: unknown;\n        toolName?: unknown;\n        input?: unknown;\n        args?: unknown;\n    };\n}\n/** 一个 step = 一次模型调用(工具循环里的一圈)。 */\nexport interface AiSdkStepLike {\n    content?: readonly AiSdkContentPartLike[];\n    text?: string;\n    reasoningText?: string;\n    toolCalls?: readonly AiSdkToolCallLike[];\n    toolResults?: readonly AiSdkToolResultLike[];\n}\nexport interface AiSdkUsageLike {\n    inputTokens?: number;\n    outputTokens?: number;\n    promptTokens?: number;\n    completionTokens?: number;\n    cachedInputTokens?: number;\n    /** LanguageModelUsage(v5+)对推理模型(o-series 等)带回的思考 token,已计入 outputTokens。 */\n    reasoningTokens?: number;\n    /** v7:cache 细分挪进了 inputTokenDetails。 */\n    inputTokenDetails?: {\n        cacheReadTokens?: number;\n        cacheWriteTokens?: number;\n    };\n}\n/** result.responseMessages 的一条(只认 tool 消息里的 tool-result part,其余略过)。 */\nexport interface AiSdkResponseMessageLike {\n    role?: unknown;\n    content?: unknown;\n}\n/** generateText / streamText 完整结果的形状子集。没有 steps 的老结果退回顶层字段。 */\nexport interface AiSdkResultLike {\n    text?: string;\n    steps?: readonly AiSdkStepLike[];\n    /** v7:跨全部 step 聚合的 content parts(approval 请求也在里面)。 */\n    content?: readonly AiSdkContentPartLike[];\n    toolCalls?: readonly AiSdkToolCallLike[];\n    toolResults?: readonly AiSdkToolResultLike[];\n    /** v5/v6 聚合全部 step 的用量;优先于 usage(v6 的 usage 只是最后一个 step,v7 起也是聚合)。 */\n    totalUsage?: AiSdkUsageLike;\n    usage?: AiSdkUsageLike;\n    /**\n     * 本次调用新产生的消息(v7)。tool approval 批准 / 拒绝后,被拦工具的执行结果只出现在\n     * 这里的 tool 消息里(不进 steps),turnFromAiSdk 从中补齐 `operation.finished`。\n     */\n    responseMessages?: readonly AiSdkResponseMessageLike[];\n}\n/** turnFromAiSdk 的返回:铺进 `Turn` 即可(data 仍归调用方 —— 结构化输出是应用自己的语义)。 */\nexport interface AiSdkTurn {\n    events: StreamEvent[];\n    usage?: Usage;\n    /** 有待人批准的工具调用(非 automatic 的 tool-approval-request)→ \"waiting\",否则 \"completed\"。 */\n    status: \"completed\" | \"waiting\";\n    /** 通用 AI SDK tool call 没有原生 command 分类时，随有工具调用的 Turn 降级 actions。 */\n    evidenceCoverage?: {\n        readonly actions: {\n            readonly status: \"partial\";\n            readonly reason: string;\n        };\n    };\n}\n// ───────────────────────── 转换 ─────────────────────────\n/**\n * AI SDK 结果 → `{ events, usage, status }`,直接铺进 `Turn` 返回:\n *\n * ```typescript\n * const result = await generateText({ model, tools, prompt: input.text });\n * return { ...turnFromAiSdk(result), data: result.text };\n * ```\n *\n * `callId` 用 AI SDK 原生的 `toolCallId`(显式配对,不合成);工具名保留原名进 `name`,\n * canonical 名进 `tool`(认不出的域内工具落 \"unknown\",`calledTool(\"get_weather\")`\n * 仍按原名匹配)。工具执行失败(v5+ 的 `tool-error` part)映射成 `status: \"failed\"` 的\n * `operation.finished`,喂 `noFailedActions()`。\n *\n * v7 tool approval:`needsApproval` 工具被拦下时返回 `status: \"waiting\"` + 每个待批准\n * 调用一条 `input.requested`(`id` = approvalId、`action` = 工具原名、`options` =\n * approve / deny)。resume(把 `tool-approval-response` 塞回 messages 再跑一次)后的结果\n * 再交给 turnFromAiSdk,会从 `responseMessages` 里补出执行 / 拒绝的 `operation.finished`。\n */\nexport function turnFromAiSdk(result: AiSdkResultLike): AiSdkTurn {\n    const stepEvents: StreamEvent[] = [];\n    const steps: readonly AiSdkStepLike[] = result.steps && result.steps.length > 0\n        ? result.steps\n        : [{ text: result.text, toolCalls: result.toolCalls, toolResults: result.toolResults }];\n    const seen = { called: new Set<string>(), resolved: new Set<string>() };\n    for (const step of steps) {\n        if (Array.isArray(step.content) && step.content.length > 0) {\n            pushContentParts(stepEvents, step.content, seen);\n        }\n        else {\n            pushStepFields(stepEvents, step, seen);\n        }\n    }\n    // approval resume 时被拦工具的执行结果只在 responseMessages 里;补出的 operation.finished\n    // 排在本轮 step 事件之前 —— 时间上它确实先于模型看到结果后的新输出。\n    const minedEvents = mineResponseMessages(result.responseMessages, seen.resolved);\n    const events = [...minedEvents, ...stepEvents];\n    const waiting = events.some((e) => e.type === \"input.requested\");\n    const evidenceCoverage = unclassifiedToolActionsCoverage(events);\n    return {\n        events,\n        usage: readUsage(result, steps.length),\n        status: waiting ? \"waiting\" : \"completed\",\n        ...(evidenceCoverage === undefined ? {} : { evidenceCoverage }),\n    };\n}\ninterface SeenCallIds {\n    called: Set<string>;\n    resolved: Set<string>;\n}\n/** v5+ 路径:content parts 自带真实顺序,逐个翻译。 */\nfunction pushContentParts(events: StreamEvent[], parts: readonly AiSdkContentPartLike[], seen: SeenCallIds): void {\n    for (const part of parts) {\n        switch (part.type) {\n            case \"text\": {\n                const text = str(part.text);\n                if (text)\n                    events.push({ type: \"message\", role: \"assistant\", text });\n                break;\n            }\n            case \"reasoning\": {\n                const text = str(part.text);\n                if (text)\n                    events.push({ type: \"thinking\", text });\n                break;\n            }\n            case \"tool-call\": {\n                pushCalled(events, seen, {\n                    toolCallId: str(part.toolCallId) ?? \"unknown\",\n                    toolName: str(part.toolName) ?? \"unknown\",\n                    input: part.input ?? part.args,\n                });\n                break;\n            }\n            case \"tool-result\": {\n                const callId = str(part.toolCallId) ?? \"unknown\";\n                seen.resolved.add(callId);\n                events.push({\n                    type: \"operation.finished\",\n                    operationId: callId,\n                    kind: \"tool\",\n                    output: asJson(part.output ?? part.result),\n                    status: \"completed\",\n                });\n                break;\n            }\n            case \"tool-error\": {\n                const callId = str(part.toolCallId) ?? \"unknown\";\n                seen.resolved.add(callId);\n                events.push({\n                    type: \"operation.finished\",\n                    operationId: callId,\n                    kind: \"tool\",\n                    output: { error: part.error instanceof Error ? part.error.message : String(part.error) },\n                    status: \"failed\",\n                });\n                break;\n            }\n            case \"tool-approval-request\": {\n                // 同一 step 里通常已有配对的 tool-call part(去重);没有时从 toolCall 字段补。\n                const call = part.toolCall;\n                if (call) {\n                    pushCalled(events, seen, {\n                        toolCallId: str(call.toolCallId) ?? \"unknown\",\n                        toolName: str(call.toolName) ?? \"unknown\",\n                        input: call.input ?? call.args,\n                    });\n                }\n                if (part.isAutomatic === true)\n                    break; // SDK 自动裁决,不用等人\n                const request: InputRequest = {\n                    id: str(part.approvalId),\n                    action: call ? str(call.toolName) : undefined,\n                    input: call ? asJson(call.input ?? call.args) : undefined,\n                    options: [{ id: \"approve\" }, { id: \"deny\" }],\n                };\n                events.push({ type: \"input.requested\", request });\n                break;\n            }\n            default:\n                break; // source / file 等其余 part 类型对断言无意义,丢弃\n        }\n    }\n}\n/** 退路(v4 / 无 content parts):toolCalls + toolResults + text,顺序按「调用 → 结果 → 文本」近似。 */\nfunction pushStepFields(events: StreamEvent[], step: AiSdkStepLike, seen: SeenCallIds): void {\n    if (step.reasoningText)\n        events.push({ type: \"thinking\", text: step.reasoningText });\n    for (const call of step.toolCalls ?? []) {\n        pushCalled(events, seen, { toolCallId: call.toolCallId, toolName: call.toolName, input: call.input ?? call.args });\n    }\n    for (const res of step.toolResults ?? []) {\n        seen.resolved.add(res.toolCallId);\n        events.push({\n            type: \"operation.finished\",\n            operationId: res.toolCallId,\n            kind: \"tool\",\n            output: asJson(res.output ?? res.result),\n            status: \"completed\",\n        });\n    }\n    if (step.text?.trim())\n        events.push({ type: \"message\", role: \"assistant\", text: step.text });\n}\n/** 同一原生 tool call ID 只发一条 operation.started(tool-call part 与 approval-request 会重)。 */\nfunction pushCalled(events: StreamEvent[], seen: SeenCallIds, call: {\n    toolCallId: string;\n    toolName: string;\n    input: unknown;\n}): void {\n    if (seen.called.has(call.toolCallId))\n        return;\n    seen.called.add(call.toolCallId);\n    events.push({\n        type: \"operation.started\",\n        operationId: call.toolCallId,\n        operation: {\n            kind: \"tool\",\n            name: call.toolName,\n            input: asJson(call.input),\n            tool: normalizeToolName(call.toolName),\n        },\n    });\n}\n/**\n * 从 responseMessages 的 tool 消息里挖 steps 没有的 tool-result(v7 approval resume 的\n * 执行结果只在这里)。output 是 ToolResultOutput 包装({ type: \"json\" | \"text\" |\n * \"execution-denied\" | \"error-text\" | … }),按类型解包;`execution-denied` → \"rejected\"。\n */\nfunction mineResponseMessages(messages: readonly AiSdkResponseMessageLike[] | undefined, resolved: ReadonlySet<string>): StreamEvent[] {\n    const events: StreamEvent[] = [];\n    for (const msg of messages ?? []) {\n        if (msg.role !== \"tool\" || !Array.isArray(msg.content))\n            continue;\n        for (const part of msg.content as AiSdkContentPartLike[]) {\n            if (part.type !== \"tool-result\")\n                continue;\n            const callId = str(part.toolCallId);\n            if (!callId || resolved.has(callId))\n                continue;\n            events.push({ type: \"operation.finished\", operationId: callId, kind: \"tool\", ...unwrapToolOutput(part.output) });\n        }\n    }\n    return events;\n}\nfunction unwrapToolOutput(output: unknown): {\n    output?: JsonValue;\n    status: \"completed\" | \"failed\" | \"rejected\";\n} {\n    if (output && typeof output === \"object\" && !Array.isArray(output)) {\n        const wrapped = output as {\n            type?: unknown;\n            value?: unknown;\n            reason?: unknown;\n        };\n        switch (wrapped.type) {\n            case \"json\":\n            case \"text\":\n            case \"content\":\n                return { output: asJson(wrapped.value), status: \"completed\" };\n            case \"execution-denied\":\n                return {\n                    output: str(wrapped.reason) ? { reason: str(wrapped.reason)! } : undefined,\n                    status: \"rejected\",\n                };\n            case \"error-text\":\n            case \"error-json\":\n                return { output: { error: asJson(wrapped.value) }, status: \"failed\" };\n            default:\n                break;\n        }\n    }\n    return { output: asJson(output), status: \"completed\" };\n}\n/** totalUsage(v5/v6 的全 steps 聚合)优先;v7 的 usage 本身就是聚合;requests = step 数。 */\nfunction readUsage(result: AiSdkResultLike, stepCount: number): Usage | undefined {\n    const u = result.totalUsage ?? result.usage;\n    if (!u)\n        return undefined;\n    const rawInput = num(u.inputTokens) ?? num(u.promptTokens) ?? 0;\n    const outputTokens = num(u.outputTokens) ?? num(u.completionTokens) ?? 0;\n    if (rawInput === 0 && outputTokens === 0)\n        return undefined;\n    const cacheRead = num(u.cachedInputTokens) ?? num(u.inputTokenDetails?.cacheReadTokens) ?? 0;\n    const cacheCreation = num(u.inputTokenDetails?.cacheWriteTokens) ?? 0;\n    // AI SDK 的 inputTokens 是含缓存明细的输入总量,落互斥桶前扣掉在场的明细\n    // (docs/feature/adapters/sdk/ai-sdk/cost.md)\n    const inputTokens = Math.max(0, rawInput - cacheRead - cacheCreation);\n    const usage: Usage = { inputTokens, outputTokens, requests: Math.max(stepCount, 1) };\n    if (cacheRead)\n        usage.cacheReadTokens = cacheRead;\n    if (cacheCreation)\n        usage.cacheCreationTokens = cacheCreation;\n    const reasoning = num(u.reasoningTokens);\n    if (reasoning)\n        usage.reasoningTokens = reasoning;\n    return usage;\n}\n/** AI SDK 应用的工具多为域内自定义名(get_weather…),canonical 落 \"unknown\" 即可;仅认通用别名基表。 */\nfunction normalizeToolName(name: string): ToolName {\n    return normalizeShared(name);\n}\n/** 工具入参 / 出参来自可替换的 AI SDK 版本；在边界立即清洗成领域 JsonValue。 */\nfunction asJson(value: unknown): JsonValue {\n    return normalizeJsonValue(value);\n}\nfunction str(value: unknown): string | undefined {\n    return typeof value === \"string\" && value ? value : undefined;\n}\nfunction num(value: unknown): number | undefined {\n    return typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n// ───────────────────────── 内建 agent 工厂 ─────────────────────────\n/**\n * `generate` 收到的上下文。`messages` 是本会话的完整 ModelMessage 历史(含本轮的用户消息 /\n * approval 裁决),直接透传给 generateText / streamText 即可;泛型 `M` 由调用方钉成自己\n * AI SDK 版本的 `ModelMessage`,niceeval 不引 `ai` 包。\n */\nexport interface AiSdkGenerateContext<M = JsonValue, Integration extends object = object> {\n    readonly messages: M[];\n    /** 实验钉的 model(ctx.model);省略 → 用应用自己的默认。 */\n    readonly model?: string;\n    /** 实验钉的推理努力程度(ctx.reasoningEffort);省略 → 用应用自己的默认。应用自己决定怎么塞进 providerOptions(如 OpenAI 的 reasoningEffort)。 */\n    readonly reasoningEffort?: string;\n    readonly signal: AbortSignal;\n    readonly flags: Readonly<globalThis.Record<string, JsonValue>>;\n    /**\n     * 配了 `tracing`(如 `aiSdkOtel()`)才有:直接放进 generateText / streamText 的\n     * `telemetry` 选项。OTel provider、per-attempt 端点绑定和轮末 flush 都由工厂做,\n     * 应用侧原样透传即可。\n     */\n    readonly telemetry?: AiSdkTelemetrySettings<Integration>;\n}\n/**\n * generateText / streamText 的 `telemetry` 选项的形状子集。integrations 的元素是\n * `@ai-sdk/otel` 的集成实例。`Integration` 由 tracing 实现携带，niceeval 不引\n * 用户版本的 `ai` 包，也不在中间层抹成 `any`。\n */\nexport interface AiSdkTelemetrySettings<Integration extends object = object> {\n    readonly integrations: readonly Integration[];\n}\n/** tracing 管线为某一轮建好的遥测件(`AiSdkTracing.telemetryForEndpoint` 的返回值)。 */\nexport interface AiSdkTurnTelemetry<Integration extends object = object> {\n    /** 直接放进 generateText / streamText 的 `telemetry` 选项。 */\n    settings: AiSdkTelemetrySettings<Integration>;\n    /** 每轮结束后由工厂调用:轮次归属靠时间窗口,span 必须立刻送到,不能等 batch。 */\n    flush(): Promise<void>;\n}\n/**\n * `aiSdkAgent` 的 tracing 管线契约。内置实现是 `niceeval/adapter/otel` 的 `aiSdkOtel()`——\n * 独立子路径导出,OTel 三件套是可选 peer 依赖,只有 import 那个入口的项目才需要安装;\n * 这里只放形状,`niceeval/adapter` 本身零 OTel 依赖。\n */\nexport interface AiSdkTracing<Integration extends object = object> {\n    /** 为本轮的 OTLP 接收端点建(或复用)一条导出管线。每个 attempt 端点不同,按端点缓存。 */\n    telemetryForEndpoint(endpoint: string): AiSdkTurnTelemetry<Integration>;\n}\nexport interface AiSdkAgentOptions<M = JsonValue, Integration extends object = object> {\n    /** agent 名(报告 / 结果聚合的身份)。默认 \"ai-sdk\"。 */\n    name?: string;\n    /**\n     * 开 OTel 管线(拿 `niceeval view` 的瀑布图):传 `niceeval/adapter/otel` 的\n     * `aiSdkOtel()`。设了运行器就为这个 agent 开 per-attempt OTLP 接收器,工厂每轮用\n     * 管线建好绑定接收端点的集成,经 `generate` 的 ctx.telemetry 交给应用,原样透传给\n     * generateText / streamText 的 `telemetry` 选项即可。省略则整个 OTel 管线不开,\n     * `generate` 拿到的 `telemetry` 恒为 undefined,应用侧零开销。\n     *\n     * ```typescript\n     * import { aiSdkOtel } from \"niceeval/adapter/otel\";\n     * aiSdkAgent({ tracing: aiSdkOtel(), generate });\n     * ```\n     */\n    tracing?: AiSdkTracing<Integration>;\n    /**\n     * 每轮一召:拿会话历史跑一次 generateText / streamText(await 完整结果)并原样返回。\n     * model / tools / system prompt / stopWhen 都在这里配 —— 那是应用的事,工厂不掺和。\n     */\n    generate(ctx: AiSdkGenerateContext<M, Integration>): Promise<AiSdkResultLike>;\n    /** 本轮的结构化输出(Turn.data,喂 outputEquals / outputMatches)。省略则 data 为 undefined。 */\n    data?(result: AiSdkResultLike, turn: AiSdkTurn): JsonValue;\n}\n/**\n * 内建的 AI SDK 进程内 agent 工厂:把「一个 generateText 调用」变成完整的 niceeval agent。\n * 应用只写 `generate`(怎么召模型),协议侧的活全部由工厂承担:\n *\n *   · 多轮会话:ctx.session.id 未记录时开新会话线并 capture 回写,同一 id 续接同一份\n *     messages 历史;\n *   · 事件流:结果经 {@link turnFromAiSdk} 直构(toolCallId 配对、时序保真、usage);\n *   · HITL:`needsApproval` 工具停轮 → `waiting` + `input.requested`;下一轮输入按行翻译成\n *     tool-approval-response(以 approve / yes / 同意 / 批准 开头 = 批准,其余一律拒绝)塞回\n *     messages 再召 `generate`,SDK 才会执行(或跳过)被拦的工具;\n *   · 失败兜底:`generate` 抛错或结果完全为空 → `status: \"failed\"` + error 事件;\n *   · tracing:传 `tracing: aiSdkOtel()`(来自 `niceeval/adapter/otel`)后,工厂替应用\n *     做完 OTel 管线——为每轮建好绑定 niceeval 接收端点的 `@ai-sdk/otel` 集成(经\n *     ctx.telemetry 交给 generate,原样透传给 generateText 的 `telemetry` 即可)并在轮末\n *     flush;`aiSdkOtel({ backendUrl })` 可选双发到你自己的观测后端。应用侧零埋点代码。\n *\n * ```typescript\n * import { aiSdkAgent } from \"niceeval/adapter\";\n * import { generateText, isStepCount, type ModelMessage } from \"ai\";\n *\n * export const assistant = aiSdkAgent<ModelMessage>({\n *   name: \"my-assistant\",\n *   generate: ({ messages, model, signal }) =>\n *     generateText({ model: resolveModel(model), system: SYSTEM_PROMPT,\n *                    tools, stopWhen: isStepCount(5), messages, abortSignal: signal }),\n *   data: (result) => ({ reply: result.text }),\n * });\n * ```\n */\nexport function aiSdkAgent<M = JsonValue, Integration extends object = object>(options: AiSdkAgentOptions<M, Integration>): Agent {\n    interface SessionState {\n        messages: M[];\n        /** 上一轮停下的 tool approval:下一轮输入按行翻译成裁决。 */\n        pendingApprovals: string[];\n    }\n    const sessions = new Map<string, SessionState>();\n    return defineAgent({\n        name: options.name ?? \"ai-sdk\",\n        // 官方 SDK 完整 steps/output:全通道 complete(见 adapters/architecture/evidence.md)。\n        evidenceCoverage: completeEvidenceCoverage,\n        // tracing 开了才让运行器为这个 agent 起 OTLP 接收器(ctx.telemetry 才会出现);\n        // AgentTracing 的其余字段(env/configure/scope)这里都用不上,空对象即可。\n        tracing: options.tracing ? {} : undefined,\n        async send(input, ctx) {\n            // 会话续接:ctx.session.id 未记录时开新会话并 capture 回写;否则按 id 续接同一份历史。\n            const id = ctx.session.id ?? `ai-sdk-${randomUUID()}`;\n            ctx.session.capture(id);\n            let state = sessions.get(id);\n            if (!state) {\n                state = { messages: [], pendingApprovals: [] };\n                sessions.set(id, state);\n            }\n            if (state.pendingApprovals.length > 0) {\n                // HITL:t.respond 的回答到 adapter 就是一次普通的带 responses 的 send,按\n                // requestId(= approvalId)对位取裁决;没答到的请求直接报错,不从文本猜。\n                const content = state.pendingApprovals.map((approvalId) => ({\n                    type: \"tool-approval-response\" as const,\n                    approvalId,\n                    approved: approvalDecision(input.responses, approvalId),\n                }));\n                state.pendingApprovals = [];\n                state.messages.push({ role: \"tool\", content } as M);\n            }\n            else {\n                state.messages.push(userMessage(input.text, input.files) as M);\n            }\n            // tracing 管线由调用方显式传入(niceeval/adapter/otel 的 aiSdkOtel()),工厂只管\n            // 每轮把 per-attempt 端点交给它、轮末 flush。\n            const otel = ctx.telemetry && options.tracing ? options.tracing.telemetryForEndpoint(ctx.telemetry.endpoint) : undefined;\n            let result: AiSdkResultLike;\n            try {\n                result = await options.generate({\n                    messages: state.messages,\n                    model: ctx.model,\n                    reasoningEffort: ctx.reasoningEffort,\n                    signal: ctx.signal,\n                    flags: ctx.flags,\n                    telemetry: otel?.settings,\n                });\n            }\n            catch (error) {\n                const message = error instanceof Error ? error.message : String(error);\n                throw makeSendFailure({ acceptance: \"unknown\", message, cause: normalizeExternalCause(error) });\n            }\n            finally {\n                // 轮次归属靠时间窗口:本轮 span 必须在 send 返回前送到接收器,不能等 batch。\n                await otel?.flush();\n            }\n            // resume 的另一半义务:本次调用新产生的消息(含 approval 执行结果)进历史。\n            state.messages.push(...((result.responseMessages ?? []) as M[]));\n            state.pendingApprovals = collectPendingApprovals(result);\n            const turn = turnFromAiSdk(result);\n            // 上游偶尔退化返回完全空的结果;当正常回复会把故障伪装成通过,按失败处理。\n            if (turn.events.length === 0) {\n                throw makeSendFailure({\n                    acceptance: \"unknown\",\n                    message: \"AI SDK returned an empty result (no text, no tool calls)\",\n                });\n            }\n            return { ...turn, data: options.data?.(result, turn) };\n        },\n    });\n}\n/** 裁决词法(t.respond 的自由文本回答):approve / yes / 同意 / 批准 开头 = 批准,其余一律拒绝。 */\nfunction isApproved(line: string): boolean {\n    return /^(approve|yes|同意|批准)/i.test(line);\n}\n/** 按 requestId(= approvalId)从 input.responses 对位取裁决;optionId 优先,自由文本走 isApproved。 */\nfunction approvalDecision(responses: readonly InputResponse[] | undefined, requestId: string): boolean {\n    const matched = responses?.find((r) => r.requestId === requestId);\n    if (!matched) {\n        throw new Error(`No response for pending approval \"${requestId}\". Answer approval requests with t.respond(...).`);\n    }\n    if (matched.optionId !== undefined)\n        return matched.optionId === \"approve\";\n    return isApproved(matched.text?.trim() ?? \"\");\n}\n/** 待人批准的 approval 请求 id(非 automatic)。steps 优先,退回 v7 顶层聚合 content。 */\nfunction collectPendingApprovals(result: AiSdkResultLike): string[] {\n    const parts: AiSdkContentPartLike[] = [];\n    if (result.steps?.length) {\n        for (const step of result.steps)\n            if (Array.isArray(step.content))\n                parts.push(...step.content);\n    }\n    else if (Array.isArray(result.content)) {\n        parts.push(...result.content);\n    }\n    const ids: string[] = [];\n    for (const part of parts) {\n        if (part.type !== \"tool-approval-request\" || part.isAutomatic === true)\n            continue;\n        const approvalId = str(part.approvalId);\n        if (approvalId)\n            ids.push(approvalId);\n    }\n    return ids;\n}\n/**\n * t.sendFile 带来的文件(base64)转成 AI SDK 的多模态用户消息;纯文本就是纯文本。\n * 用 `file` part(v7 推荐;`image` part 已废弃),mediaType 原样透传,图片之外的附件也能走。\n */\nfunction userMessage(text: string, files: readonly {\n    mimeType: string;\n    dataBase64: string;\n}[] | undefined): unknown {\n    if (!files || files.length === 0)\n        return { role: \"user\", content: text };\n    return {\n        role: \"user\",\n        content: [\n            { type: \"text\", text: text || \"请描述这个附件。\" },\n            ...files.map((f) => ({ type: \"file\", mediaType: f.mimeType, data: f.dataBase64 })),\n        ],\n    };\n}\n"]}