niceeval 0.15.1-canary.76 → 0.16.1

package/dist/adapter.d.ts

@@ -1,3 +1,8 @@
+import type { ResolvedModelSlots } from "./model-slots.js";
+import type { AttemptSignal } from "./shared/attempt-lifecycle.js";
+export type { AttemptCancellation, AttemptSignal } from "./shared/attempt-lifecycle.js";
+import type { MatchContext } from "./assertions/context-match.js";
+import type { EvalUsage } from "./o11y/eval-usage.js";
 import type { ExperimentFlags } from "./shared/types.js";
 import { type AdapterFlagsParser, type AdapterFlagsOutput, type AdapterFlagsParserValidation, type AdapterFlagsParserValidationArgs } from "./adapter-flags.js";
 import type { AssertionCheck, AssertionSubject, AssertionsRuntime, BooleanAssertionHandle, MeasurementAssertionHandle, PolymorphicBooleanAssertionHandle, PolymorphicMeasurementAssertionHandle } from "./assertions/api.js";
@@ -23,8 +28,8 @@ export type AdapterAssertionsFactory<Context extends object, Assertions extends
  * assembly, and `check` may only be called by a returned Assertion method.
  */
 export interface AdapterAssertionsFactoryContext<Context extends object> {
-    readonly app: Readonly<Context>;
-    readonly check: AssertionCheck<"polymorphic">;
+    readonly app: MatchContext<Context>;
+    readonly check: AssertionCheck<"polymorphic", Context>;
 }
 type BoundAdapterAssertionResult<Kind extends EvaluationKind, Result> = Result extends PolymorphicBooleanAssertionHandle<infer Refined, infer HasGate> ? BooleanAssertionHandle<Kind, Refined, HasGate> : Result extends PolymorphicMeasurementAssertionHandle<infer HasCondition> ? MeasurementAssertionHandle<Kind, HasCondition> : never;
 type BoundAdapterAssertionMethod<Kind extends EvaluationKind, Method> = Method extends (...args: infer Args) => infer Result ? ((...args: Args) => Result) extends Method ? (...args: Args) => BoundAdapterAssertionResult<Kind, Result> : never : never;
@@ -32,7 +37,7 @@ type AdapterAssertionsFor<Assertions extends object | undefined, Kind extends Ev
     readonly [Key in keyof Assertions]: BoundAdapterAssertionMethod<Kind, Assertions[Key]>;
 } : {};
 /** Keys owned by the neutral Eval runtime or unsafe on a merged object root. */
-declare const RESERVED_ADAPTER_CONTEXT_KEYS: readonly ["evaluationKind", "check", "judge", "factuality", "faithfulness", "instructionFollowing", "pairwisePreference", "closeQA", "score", "group", "skip", "signal", "model", "reasoningEffort", "flags", "progress", "diagnostic", "log", "then", "Object", "constructor", "__defineGetter__", "__defineSetter__", "hasOwnProperty", "__lookupGetter__", "__lookupSetter__", "isPrototypeOf", "propertyIsEnumerable", "toString", "valueOf", "__proto__", "toLocaleString"];
+declare const RESERVED_ADAPTER_CONTEXT_KEYS: readonly ["evaluationKind", "check", "judge", "factuality", "faithfulness", "instructionFollowing", "pairwisePreference", "closeQA", "usage", "elapsedMs", "maxTokens", "maxCost", "score", "group", "skip", "signal", "model", "reasoningEffort", "flags", "progress", "diagnostic", "log", "then", "Object", "constructor", "__defineGetter__", "__defineSetter__", "hasOwnProperty", "__lookupGetter__", "__lookupSetter__", "isPrototypeOf", "propertyIsEnumerable", "toString", "valueOf", "__proto__", "toLocaleString"];
 export type ReservedAdapterContextKey = typeof RESERVED_ADAPTER_CONTEXT_KEYS[number];
 type InvalidContextBranch<Context> = Context extends unknown ? Context extends object ? Context extends readonly unknown[] ? Context : Context extends (...args: readonly never[]) => unknown ? Context : string extends keyof Context ? Context : Extract<keyof Context, ReservedAdapterContextKey> extends never ? never : Context : Context : never;
 type AdapterContextValidation<Context> = unknown extends Context ? unknown : [InvalidContextBranch<Context>] extends [never] ? unknown : {
@@ -50,11 +55,19 @@ type AdapterAssertionsValidationArgs<Context extends object, Assertions extends
 }];
 type AdapterFactory<Context extends object, Flags extends AdapterFlagsParser = undefined> = (context: AdapterCreateContext<AdapterFlagsOutput<Flags>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;
 export interface AdapterCleanupContext {
-    /** 当前 Adapter cleanup 总窗口的取消信号。它独立于 Attempt signal，并在 30 秒总预算结束时取消。 */
+    /** 整个清理窗口的固定毫秒预算，不为每个回调续期。 */
+    readonly timeoutMs: number;
+    /** 清理窗口实际开始时确定的 Unix 毫秒截止时间。 */
+    readonly deadlineAt: number;
+    /** 独立于执行信号；整个 Adapter 清理窗口截止时中止。 */
     readonly signal: AbortSignal;
 }
 export interface AdapterCreateContext<Flags = ExperimentFlags> {
+    /** Frozen application model selections for this Attempt. */
+    readonly models: ResolvedModelSlots;
     recordUsage(input: import("./adapter-usage.js").AdapterUsageInput): void;
+    /** Close application usage admission and declare whether the recorded collection is complete. */
+    sealUsage(input: import("./adapter-usage.js").AdapterUsageSeal): void;
     attach(input: import("./adapter-attachments.js").AdapterAttachmentInput): Promise<import("./adapter-attachments.js").AdapterAttachmentReceipt>;
     recordTrace<Event extends import("./adapter-execution-trace.js").ExecutionTraceEvent>(input: import("./adapter-execution-trace.js").ExecutionTraceInput<Event>): Promise<import("./adapter-execution-trace.js").ExecutionTraceReceipt>;
     /** 当前 Eval 的公开 ID。 */
@@ -63,8 +76,8 @@ export interface AdapterCreateContext<Flags = ExperimentFlags> {
     readonly experimentId: string;
     /** 当前 Attempt 的零起始序号。 */
     readonly attempt: number;
-    /** Attempt 执行信号；取消或超时后会中止，不用于 cleanup 窗口。 */
-    readonly signal: AbortSignal;
+    /** Attempt 执行信号；reason 区分 timeout 与 cancelled，不用于 cleanup 窗口。 */
+    readonly signal: AttemptSignal;
     /** Experiment 选择的模型。 */
     readonly model?: string;
     /** Experiment 选择的推理强度。 */
@@ -83,7 +96,11 @@ export interface AdapterCreateContext<Flags = ExperimentFlags> {
      */
     onCleanup(cleanup: (context: AdapterCleanupContext) => void | Promise<void>): void;
 }
-type EvalContextBase<Kind extends EvaluationKind, Flags> = JudgePresetMethods<Kind> & {
+type EvalContextBase<Kind extends EvaluationKind, Flags, Context> = JudgePresetMethods<Kind, Context> & {
+    readonly usage: EvalUsage;
+    readonly elapsedMs: import("./assertions/match.js").NumericMaterial;
+    maxTokens(max: number): BooleanAssertionHandle<Kind, number>;
+    maxCost(usd: number | string): BooleanAssertionHandle<Kind, string>;
     readonly evaluationKind: Kind;
     readonly signal: AbortSignal;
     readonly model?: string;
@@ -94,11 +111,11 @@ type EvalContextBase<Kind extends EvaluationKind, Flags> = JudgePresetMethods<Ki
     log(message: string): void;
     skip(reason: string): never;
     group<Value>(title: string, body: () => Value | PromiseLike<Value>): Promise<Awaited<Value>>;
-    readonly check: AssertionsRuntime<Kind>["t"]["check"];
+    readonly check: AssertionCheck<Kind, Context>;
     readonly judge: <Value>(value: AssertionSubject<Value>, definition: ScoreMatch<NoInfer<Value>>) => MeasurementAssertionHandle<Kind>;
 };
 /** Agent-neutral author context shared by every Adapter Eval. */
-export type EvalContext<Kind extends EvaluationKind = "pass", Flags = ExperimentFlags> = EvalContextBase<Kind, Flags> & (Kind extends "score" ? {
+export type EvalContext<Kind extends EvaluationKind = "pass", Flags = ExperimentFlags, Context = unknown> = EvalContextBase<Kind, Flags, Context> & (Kind extends "score" ? {
     readonly score: AssertionsRuntime<"score">["t"]["score"];
 } : {});
 type AdapterEvalFields = Omit<EvalInput<undefined>, "test" | "sandbox" | "diff"> & {
@@ -110,10 +127,10 @@ type AdapterScoreEvalFields = Omit<ScoreEvalInput<undefined>, "test" | "sandbox"
     readonly diff?: never;
 };
 export type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterEvalFields & {
-    test(t: EvalContext<"pass", AdapterFlagsOutput<Flags>> & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
+    test(t: EvalContext<"pass", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
 };
 export type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterScoreEvalFields & {
-    test(t: EvalContext<"score", AdapterFlagsOutput<Flags>> & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): void | Promise<void>;
+    test(t: EvalContext<"score", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): void | Promise<void>;
 };
 interface AdapterContractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser = undefined> {
     readonly name: string;
@@ -124,7 +141,7 @@ interface AdapterContractToken<Context extends object, Assertions extends object
     /** Keeps the context parameter invariant without exposing a constructible brand. */
     readonly context: (value: Context) => Context;
 }
-export interface AdapterEvalDefinition<Kind extends EvaluationKind, Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends EvalDefinition<Kind, EvalContext<Kind, AdapterFlagsOutput<Flags>> & Readonly<Context> & AdapterAssertionsFor<Assertions, Kind>, undefined> {
+export interface AdapterEvalDefinition<Kind extends EvaluationKind, Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends EvalDefinition<Kind, EvalContext<Kind, AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, Kind>, undefined> {
     readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;
 }
 /** @internal Existential discovery view; concrete bound factories retain their exact Context. */
@@ -145,6 +162,7 @@ export interface AdapterRuntimeDefinition {
     readonly name: string;
     readonly contract: string;
     readonly behaviorRevision: string | null;
+    readonly cleanupTimeoutMs: number;
     readonly [ADAPTER_CONTRACT_TOKEN]: object;
     readonly defineEval: (...args: never[]) => unknown;
     readonly defineScoreEval: (...args: never[]) => unknown;
@@ -154,12 +172,15 @@ export interface AdapterImplementation<Context extends object, Assertions extend
     readonly kind: "custom";
     readonly contract: string;
     readonly behaviorRevision: string | null;
+    readonly cleanupTimeoutMs: number;
     readonly [ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;
     create(context: AdapterCreateContext<AdapterFlagsOutput<Flags>>): Context | Promise<Context>;
 }
 export type AdapterImplementationInput<Context extends object, ImplementationContext extends Context = Context, Flags extends AdapterFlagsParser = undefined> = {
     readonly name: string;
     readonly behaviorRevision?: string;
+    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */
+    readonly cleanupTimeoutMs?: number;
     readonly create: AdapterFactory<ImplementationContext, Flags>;
 } & AdapterContextValidation<NoInfer<ImplementationContext>>;
 export interface AdapterContract<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends AdapterDefinition<Context, Assertions, Flags> {
@@ -177,6 +198,8 @@ export type Adapter = import("./agents/types.js").Agent | AdapterRuntimeDefiniti
 export declare function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined>(input: {
     readonly name: string;
     readonly behaviorRevision?: string;
+    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */
+    readonly cleanupTimeoutMs?: number;
     readonly create: AdapterFactory<Context, Flags>;
     readonly parseFlags?: Flags;
     readonly assertions?: undefined;
@@ -184,6 +207,8 @@ export declare function defineAdapter<Context extends object, Flags extends Adap
 export declare function defineAdapter<Context extends object, Assertions extends object, Flags extends AdapterFlagsParser = undefined>(input: {
     readonly name: string;
     readonly behaviorRevision?: string;
+    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */
+    readonly cleanupTimeoutMs?: number;
     readonly create: AdapterFactory<Context, Flags>;
     readonly parseFlags?: Flags;
     /** Attempt-local Assertion sugar, assembled once after create() succeeds. */

package/dist/agents/ai-sdk.cjs

@@ -291,6 +291,9 @@ function num(value) {
  * });
  * ```
  */
+// @concord-code ne-adapter-ai-sdk-agent
+// @concord-implements docs/feature/adapters/README.md
+// @concord-implements docs/feature/adapters/sdk/ai-sdk/README.md
 function aiSdkAgent(options) {
     const sessions = new Map();
     return (0, define_ts_1.makeDirectAgent)({

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

@@ -1 +1 @@
-{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["ai-sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExperimentFlags } from \"../shared/types.ts\";\n// 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 { Effect } from \"effect\";\nimport { makeDirectAgent } 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: ExperimentFlags;\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，供 `t.check(turn.data, match)` 使用）。省略则 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 makeDirectAgent({\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        send: (input, ctx) => Effect.tryPromise({\n            try: async () => {\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            catch: (cause) => cause,\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"]}
+{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["ai-sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExperimentFlags } from \"../shared/types.ts\";\n// 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 { Effect } from \"effect\";\nimport { makeDirectAgent } 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: ExperimentFlags;\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，供 `t.check(turn.data, match)` 使用）。省略则 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 */\n// @concord-code ne-adapter-ai-sdk-agent\n// @concord-implements docs/feature/adapters/README.md\n// @concord-implements docs/feature/adapters/sdk/ai-sdk/README.md\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 makeDirectAgent({\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        send: (input, ctx) => Effect.tryPromise({\n            try: async () => {\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            catch: (cause) => cause,\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"]}

package/dist/agents/bub.cjs

@@ -50,6 +50,9 @@ function tapePath(workspace, sessionId, bubHome) {
     const s = (0, node_crypto_1.createHash)("md5").update(sessionId).digest("hex").slice(0, 16);
     return `${bubHome}/tapes/${w}__${s}.jsonl`;
 }
+// @concord-code ne-adapter-bub-agent
+// @concord-implements docs/feature/adapters/README.md
+// @concord-implements docs/feature/adapters/sdk/bub/README.md
 function bubAgent(config) {
     const getApiKey = () => config?.apiKey ?? (0, util_ts_1.requireEnv)("BUB_API_KEY");
     const getApiBase = () => config?.apiBase ?? (0, util_ts_1.requireEnv)("BUB_API_BASE");

package/dist/agents/bub.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bub.js","sourceRoot":"","sources":["bub.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { makeSandboxAgent } from \"../define.ts\";\nimport { requireEnv } from \"../util.ts\";\nimport { shared } from \"./shared.ts\";\nimport { appendProjectInstruction, installSkills, installedSkillNames, skillDiscoveryInstruction, } from \"./skills.ts\";\nimport { mapBubSpans } from \"../o11y/otlp/mappers/bub.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport { registerAgentLifecycleHookCommands, runPostSetupHooks, runPreTeardownHooks, } from \"./post-setup.ts\";\nimport type { Agent, AgentSetupManifest, SkillSpec, TurnEvidenceCoverage } from \"../types.ts\";\nimport type { SandboxCommand } from \"../sandbox/commands.ts\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { BUB_INSTALL_MARKER, DEFAULT_BUB_DEPENDENCY_OVERRIDES, DEFAULT_BUB_OTEL_PLUGIN, DEFAULT_BUB_REQUIREMENT, bubInstallHash, bubRequirement, normalizeBubPackages, } from \"./bub-install-spec.ts\";\nimport { makeSendFailure, sendAcceptanceFromEvents } from \"../context/send-failures.ts\";\nimport { defineSandboxCommand } from \"../sandbox/commands.ts\";\nimport { shellQuote } from \"../sandbox/shell.ts\";\nimport { DEFAULT_BUB_VERSION } from \"./coding-cli-versions.ts\";\n// ───────────────────────────────────────────────────────────────────────────\n// bub 的 agent adapter(沙箱型)。\n//\n// ⚠️ 现实校正:bub 是 PyPI 上的 `bub`(alpha,Python 3.12),不是 npm 包。\n//    · 安装:uv tool install bub(uv 自带 python 3.12,免 root)。\n//    · 调用:bub run \"<prompt>\" --session-id <id> --workspace <path>\n//    · 模型 + 代理:BUB_MODEL=openai:<model>、BUB_API_BASE、BUB_API_KEY。\n//    · 记忆:tape(总是开),落盘在 ~/.bub/tapes/<md5(ws)[:16]>__<md5(sess)[:16]>.jsonl。\n// ───────────────────────────────────────────────────────────────────────────\n/**\n * Bub 的扩展单元 —— **只属于 Bub**:Bub 的插件是运行环境里的 Python Package,\n * 与 Claude Code / Codex 的 native plugin 没有共同的安装协议,不共用类型。\n */\nexport interface PythonPluginSpec {\n    /** PyPI Package、Version Specifier 或 Git URL(如 `bub-plugin-memory==1.3.0`、`git+https://…@8f3c1a2`)。 */\n    package: string;\n}\nexport interface BubConfig {\n    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */\n    apiKey?: string;\n    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */\n    apiBase?: string;\n    /**\n     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。\n     * 落在 `.agents/skills/<name>/`,并写一段发现指引进 AGENTS.md(bub 没有原生 Skill 加载机制)。\n     */\n    skills?: SkillSpec[];\n    /**\n     * 装哪一版 Bub(PyPI 版本号,如 `\"0.4.0\"`)。省略时用 NiceEval 钉的默认版本;\n     * 永远是确定版本,不装 latest —— 被测对象的版本要能从实验配置读出来。\n     */\n    version?: string;\n    /**\n     * OTel tape store 插件的 git 依赖(时间轨的来源)。省略时用 NiceEval 钉的默认 pin。\n     *\n     * 插件与 Bub 的 tape 协议同代:默认 pin 从 `bub.tape` 取类型,要求 Bub ≥ 0.3.10;更早的\n     * 插件 commit 按 republic 的类型校验,配 Bub ≤ 0.3.9。配错代不会安装失败,而是 span 全被拒、\n     * 时间轨静默为空 —— 所以往回钉 `version` 时必须同批钉配套的插件 commit。\n     */\n    otelPlugin?: string;\n    /**\n     * 额外装进 bub tool 环境的 Python Package,每个 Sandbox setup 时进 `uv tool install … --with <pkg>`。\n     * 规范化后的 package 列表进安装 checkpoint key:plugin 集合不同的两个 agent 变体不会复用同一个\n     * 安装 checkpoint(否则第二个变体会静默拿到第一个变体的环境)。\n     */\n    pythonPlugins?: PythonPluginSpec[];\n    /**\n     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在装 bub、装 Skills /\n     * Python package、写 manifest 全部完成后执行。抛错按基础设施错误计(attempt errored)。\n     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。\n     */\n    postSetup?: SandboxCommand[];\n    /**\n     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤\n     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾\n     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段\n     * 按 teardown-failed 诊断收束。\n     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。\n     */\n    preTeardown?: SandboxCommand[];\n}\nconst UV = \"$HOME/.local/bin/uv\";\n/** bub 的 skill 目录(`skills` 生态的「通用」目录);bub 不原生扫描它,靠 AGENTS.md 的发现指引。 */\nconst SKILL_DIR = \".agents/skills\";\n// bub 与 OTel 插件的 pin 都从 config 来(缺省用源码里的默认 pin)——不设环境变量后门:\n// 装哪个包是配置,配置的家是代码(边界见 docs/architecture.md「配置从代码来,凭据从环境来」)。\n//\n// override 文件不是历史包袱:插件所在 workspace 把 `bub` 声明成 git 依赖,不覆盖的话每次\n// 安装都会去拉 Bub 主干,版本失控。所以安装前总是先把 `bub==<version>` 写进这个文件。\nconst BUB_OVERRIDE_FILE = \"/tmp/bub-override.txt\";\n/** 一个 agent 变体装的那套 bub:requirement + OTel 插件,两者都进安装指纹。 */\ninterface BubInstallPin {\n    requirement: string;\n    otelPlugin: string;\n    dependencyOverrides: readonly string[];\n}\nfunction resolvePin(config?: BubConfig): BubInstallPin {\n    const version = config?.version ?? DEFAULT_BUB_VERSION;\n    return {\n        requirement: config?.version ? bubRequirement(config.version) : DEFAULT_BUB_REQUIREMENT,\n        otelPlugin: config?.otelPlugin ?? DEFAULT_BUB_OTEL_PLUGIN,\n        // NiceEval can reproduce the default release's upstream lock exactly. A caller-selected\n        // historical Bub version owns a different closure, so do not silently apply 0.4.0's pins.\n        dependencyOverrides: version === DEFAULT_BUB_VERSION ? DEFAULT_BUB_DEPENDENCY_OVERRIDES : [],\n    };\n}\n// NiceEval 的预制配方与运行时安装都写到 $HOME/.local；显式使用该路径，避免 PATH 上\n// 另一个未知版本的 bub 抢先命中。\nconst BUB = \"$HOME/.local/bin/bub\";\n/** 规范化 python plugin:去空白、丢空串、去重 —— 安装命令与 checkpoint key 用同一份列表。 */\nfunction normalizePackages(plugins?: readonly PythonPluginSpec[]): string[] {\n    return normalizeBubPackages((plugins ?? []).map((plugin) => plugin.package));\n}\nfunction installHashOf(packages: readonly string[], pin: BubInstallPin): string {\n    return bubInstallHash(packages, pin.requirement, pin.otelPlugin, pin.dependencyOverrides);\n}\nfunction tapePath(workspace: string, sessionId: string, bubHome: string): string {\n    const w = createHash(\"md5\").update(workspace).digest(\"hex\").slice(0, 16);\n    const s = createHash(\"md5\").update(sessionId).digest(\"hex\").slice(0, 16);\n    return `${bubHome}/tapes/${w}__${s}.jsonl`;\n}\nexport function bubAgent(config?: BubConfig): Agent {\n    const getApiKey = () => config?.apiKey ?? requireEnv(\"BUB_API_KEY\");\n    const getApiBase = () => config?.apiBase ?? requireEnv(\"BUB_API_BASE\");\n    const packages = normalizePackages(config?.pythonPlugins);\n    const pin = resolvePin(config);\n    const identity = {\n        agent: \"bub\",\n        version: config?.version ?? DEFAULT_BUB_VERSION,\n        revision: installHashOf(packages, pin),\n    } as const;\n    const marker = `$HOME/${BUB_INSTALL_MARKER}`;\n    const probe = defineSandboxCommand({ id: \"niceeval.agent.probe.bub\", revision: identity.revision, inputs: identity }, async (sandbox) => {\n        await sandbox.runShellOrThrow(`test -x ${BUB} && test \"$(cat ${marker} 2>/dev/null)\" = ${shellQuote(identity.revision)}`);\n    });\n    // sandboxId → { home, workspace }; persists values detected in setup() so send() can use them.\n    const sessionInfo = new Map<string, {\n        home: string;\n        workspace: string;\n    }>();\n    return registerAgentLifecycleHookCommands(makeSandboxAgent({\n        name: \"bub\",\n        ensure: { identity, probe },\n        installers: [{\n                identity,\n                installMode: \"sandbox-network\",\n                install: async (sandbox) => {\n                    await sandbox.runShellOrThrow(`test -x ${UV} || (curl -LsSf https://astral.sh/uv/install.sh | sh)`);\n                    await sandbox.writeText(BUB_OVERRIDE_FILE, `${[pin.requirement, ...pin.dependencyOverrides].join(\"\\n\")}\\n`);\n                    const withPlugins = packages.map((pkg) => `--with ${shellQuote(pkg)}`).join(\" \");\n                    let last = \"\";\n                    for (let attempt = 1; attempt <= 3; attempt += 1) {\n                        const result = await sandbox.runShell(`${UV} tool install --reinstall --python 3.12 --prerelease allow 'bub' --overrides ${BUB_OVERRIDE_FILE} --with ${shellQuote(pin.otelPlugin)}${withPlugins ? ` ${withPlugins}` : \"\"}`);\n                        if (result.exitCode === 0) {\n                            await sandbox.runShellOrThrow(`mkdir -p \"$(dirname ${marker})\" && printf '%s' ${shellQuote(identity.revision)} > ${marker}`);\n                            return;\n                        }\n                        last = (result.stdout + result.stderr).split(\"\\n\").slice(-15).join(\"\\n\");\n                    }\n                    throw new Error(`bub install failed after ${3} attempts:\n${last}`);\n                },\n            }],\n        // 官方 adapter:transcript 经生命周期 fixture 验证,全通道 complete。\n        evidenceCoverage: completeEvidenceCoverage,\n        spanMapper: mapBubSpans,\n        tracing: {\n            protocol: \"http/protobuf\",\n            env: (endpoint) => ({\n                BUB_TAPESTORE_OTEL_ENABLED: \"true\",\n                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,\n                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: \"http/protobuf\",\n            }),\n        },\n        setup: (sb, ctx) => Effect.tryPromise({\n            try: async () => {\n                // home 必须来自运行时探测:各 sandbox provider 不同(/home/node、/home/vercel-sandbox…),\n                // 兜一个 provider 专属常量会静默走错路径(tape 读不到 → 空事件流 → 负断言假通过)。\n                const home = (await sb.runShell(\"printf '%s' $HOME\")).stdout.trim();\n                if (!home)\n                    throw new Error(`Failed to detect sandbox $HOME (empty output from \\`printf $HOME\\`). Refusing to fall back to a provider-specific path; check the sandbox provider.`);\n                const workspace = sb.workdir;\n                sessionInfo.set(sb.sandboxId, { home, workspace });\n                // Agent CLI 已由 runner 的 agent.ensure 循环完成安装与复检。\n                // adapter setup 只写本 Attempt 的 runtime config。\n                if (!(await sb.pathExists(`${workspace}/AGENTS.md`))) {\n                    await shared.writeFile(sb, `${workspace}/AGENTS.md`, [\n                        `You are a coding agent working in a Next.js project at ${workspace}.`,\n                        ``,\n                        `Implement the requested feature by writing files directly to disk with the available tools:`,\n                        `- fs_write(path, content): create or overwrite a file`,\n                        `- fs_edit(path, old, new): edit an existing file`,\n                        `- bash(cmd): run shell commands`,\n                        ``,\n                        `Do NOT respond with only a text explanation — write the actual code files.`,\n                        `After writing, verify with bash(\"cd ${workspace} && npm run build\").`,\n                    ].join(\"\\n\"));\n                }\n                const manifest: AgentSetupManifest = { skills: [] };\n                if (config?.skills?.length) {\n                    manifest.skills = await installSkills(sb, config.skills, { dir: SKILL_DIR });\n                    // bub 没有原生 Skill 加载机制:装进目录不等于会被读到,发现指引跟着一起写。\n                    await appendProjectInstruction(sb, skillDiscoveryInstruction(SKILL_DIR, installedSkillNames(manifest.skills)));\n                }\n                if (packages.length)\n                    manifest.pythonPlugins = packages.map((pkg) => ({ package: pkg }));\n                if (manifest.skills.length || manifest.pythonPlugins?.length) {\n                    ctx.reportSetup(manifest);\n                }\n                // 安装后钩子(postSetup):排在 manifest 之后——manifest 审计 Adapter 自身的安装事实,\n                // 钩子失败不该丢掉这份证据。\n                await runPostSetupHooks(sb, ctx, \"bub\", config?.postSetup);\n            },\n            catch: (cause) => cause,\n        }),\n        teardown: (sb, ctx) => Effect.tryPromise({\n            try: async () => {\n                // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。\n                // bub 目前没有其它收尾步骤,这段就是整个 teardown。\n                await runPreTeardownHooks(sb, ctx, \"bub\", config?.preTeardown);\n            },\n            catch: (cause) => cause,\n        }),\n        send: (input, ctx) => Effect.tryPromise({\n            try: async () => {\n                const sb = ctx.sandbox;\n                const info = sessionInfo.get(sb.sandboxId);\n                if (!info)\n                    throw new Error(`bub adapter setup() has not run in this sandbox (missing home/workspace info). The runner must call setup before send.`);\n                const { home, workspace } = info;\n                const bubHome = `${home}/.bub`;\n                // 会话契约:ctx.session.id 未记录时开新 tape(新 sessionId),否则 resume 传入的 id。\n                // tape 路径由 md5(workspace)+md5(sessionId) 决定,同沙箱多会话靠 sessionId 区分。\n                const sessionId = ctx.session.id ?? `fe-${sb.sandboxId}-${randomUUID().slice(0, 8)}`;\n                ctx.session.capture(sessionId);\n                const apiKey = getApiKey();\n                const env: globalThis.Record<string, string> = {\n                    BUB_API_KEY: apiKey,\n                    BUB_API_BASE: getApiBase(),\n                    BUB_HOME: bubHome,\n                    ...ctx.telemetry?.env,\n                };\n                // model 归属:实验决定(ctx.model),省略时交给 bub 原生默认 / 用户环境,不硬编码。\n                if (ctx.model)\n                    env.BUB_MODEL = `openai:${ctx.model}`;\n                const res = await sb.runShell(`${BUB} --workspace ${workspace} run ${shared.shellQuote(input.text)} --session-id ${sessionId}`, { env, sensitiveValues: [apiKey], stream: true });\n                const raw = await sb.readText(tapePath(workspace, sessionId, bubHome)).catch(() => undefined);\n                const parsed = shared.parseBub(raw);\n                const events = [...parsed.events];\n                let turnEvidenceCoverage: TurnEvidenceCoverage | undefined;\n                if (!raw?.trim()) {\n                    const reason = \"Bub tape was unavailable; tool trajectory was not observed.\";\n                    turnEvidenceCoverage = {\n                        events: { status: \"unavailable\", reason },\n                        actions: { status: \"unavailable\", reason },\n                        usage: { status: \"unavailable\", reason },\n                    };\n                }\n                else if (!parsed.parseSuccess) {\n                    const reason = \"Some Bub tape lines could not be parsed.\";\n                    turnEvidenceCoverage = {\n                        events: { status: \"partial\", reason },\n                        actions: { status: \"partial\", reason },\n                    };\n                }\n                else {\n                    turnEvidenceCoverage = unclassifiedToolActionsCoverage(events);\n                }\n                if (res.exitCode !== 0) {\n                    throw makeSendFailure({\n                        acceptance: sendAcceptanceFromEvents(events),\n                        message: shared.diagnoseFailure(res, parsed.events, raw),\n                        events,\n                        usage: parsed.usage,\n                        process: res,\n                    });\n                }\n                return {\n                    events,\n                    usage: parsed.usage,\n                    status: \"completed\",\n                    ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),\n                };\n            },\n            catch: (cause) => cause,\n        }),\n    }), config?.postSetup, config?.preTeardown);\n}\nexport default bubAgent();\n"]}
+{"version":3,"file":"bub.js","sourceRoot":"","sources":["bub.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { makeSandboxAgent } from \"../define.ts\";\nimport { requireEnv } from \"../util.ts\";\nimport { shared } from \"./shared.ts\";\nimport { appendProjectInstruction, installSkills, installedSkillNames, skillDiscoveryInstruction, } from \"./skills.ts\";\nimport { mapBubSpans } from \"../o11y/otlp/mappers/bub.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport { registerAgentLifecycleHookCommands, runPostSetupHooks, runPreTeardownHooks, } from \"./post-setup.ts\";\nimport type { Agent, AgentSetupManifest, SkillSpec, TurnEvidenceCoverage } from \"../types.ts\";\nimport type { SandboxCommand } from \"../sandbox/commands.ts\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { BUB_INSTALL_MARKER, DEFAULT_BUB_DEPENDENCY_OVERRIDES, DEFAULT_BUB_OTEL_PLUGIN, DEFAULT_BUB_REQUIREMENT, bubInstallHash, bubRequirement, normalizeBubPackages, } from \"./bub-install-spec.ts\";\nimport { makeSendFailure, sendAcceptanceFromEvents } from \"../context/send-failures.ts\";\nimport { defineSandboxCommand } from \"../sandbox/commands.ts\";\nimport { shellQuote } from \"../sandbox/shell.ts\";\nimport { DEFAULT_BUB_VERSION } from \"./coding-cli-versions.ts\";\n// ───────────────────────────────────────────────────────────────────────────\n// bub 的 agent adapter(沙箱型)。\n//\n// ⚠️ 现实校正:bub 是 PyPI 上的 `bub`(alpha,Python 3.12),不是 npm 包。\n//    · 安装:uv tool install bub(uv 自带 python 3.12,免 root)。\n//    · 调用:bub run \"<prompt>\" --session-id <id> --workspace <path>\n//    · 模型 + 代理:BUB_MODEL=openai:<model>、BUB_API_BASE、BUB_API_KEY。\n//    · 记忆:tape(总是开),落盘在 ~/.bub/tapes/<md5(ws)[:16]>__<md5(sess)[:16]>.jsonl。\n// ───────────────────────────────────────────────────────────────────────────\n/**\n * Bub 的扩展单元 —— **只属于 Bub**:Bub 的插件是运行环境里的 Python Package,\n * 与 Claude Code / Codex 的 native plugin 没有共同的安装协议,不共用类型。\n */\nexport interface PythonPluginSpec {\n    /** PyPI Package、Version Specifier 或 Git URL(如 `bub-plugin-memory==1.3.0`、`git+https://…@8f3c1a2`)。 */\n    package: string;\n}\nexport interface BubConfig {\n    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */\n    apiKey?: string;\n    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */\n    apiBase?: string;\n    /**\n     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。\n     * 落在 `.agents/skills/<name>/`,并写一段发现指引进 AGENTS.md(bub 没有原生 Skill 加载机制)。\n     */\n    skills?: SkillSpec[];\n    /**\n     * 装哪一版 Bub(PyPI 版本号,如 `\"0.4.0\"`)。省略时用 NiceEval 钉的默认版本;\n     * 永远是确定版本,不装 latest —— 被测对象的版本要能从实验配置读出来。\n     */\n    version?: string;\n    /**\n     * OTel tape store 插件的 git 依赖(时间轨的来源)。省略时用 NiceEval 钉的默认 pin。\n     *\n     * 插件与 Bub 的 tape 协议同代:默认 pin 从 `bub.tape` 取类型,要求 Bub ≥ 0.3.10;更早的\n     * 插件 commit 按 republic 的类型校验,配 Bub ≤ 0.3.9。配错代不会安装失败,而是 span 全被拒、\n     * 时间轨静默为空 —— 所以往回钉 `version` 时必须同批钉配套的插件 commit。\n     */\n    otelPlugin?: string;\n    /**\n     * 额外装进 bub tool 环境的 Python Package,每个 Sandbox setup 时进 `uv tool install … --with <pkg>`。\n     * 规范化后的 package 列表进安装 checkpoint key:plugin 集合不同的两个 agent 变体不会复用同一个\n     * 安装 checkpoint(否则第二个变体会静默拿到第一个变体的环境)。\n     */\n    pythonPlugins?: PythonPluginSpec[];\n    /**\n     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在装 bub、装 Skills /\n     * Python package、写 manifest 全部完成后执行。抛错按基础设施错误计(attempt errored)。\n     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。\n     */\n    postSetup?: SandboxCommand[];\n    /**\n     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤\n     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾\n     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段\n     * 按 teardown-failed 诊断收束。\n     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。\n     */\n    preTeardown?: SandboxCommand[];\n}\nconst UV = \"$HOME/.local/bin/uv\";\n/** bub 的 skill 目录(`skills` 生态的「通用」目录);bub 不原生扫描它,靠 AGENTS.md 的发现指引。 */\nconst SKILL_DIR = \".agents/skills\";\n// bub 与 OTel 插件的 pin 都从 config 来(缺省用源码里的默认 pin)——不设环境变量后门:\n// 装哪个包是配置,配置的家是代码(边界见 docs/architecture.md「配置从代码来,凭据从环境来」)。\n//\n// override 文件不是历史包袱:插件所在 workspace 把 `bub` 声明成 git 依赖,不覆盖的话每次\n// 安装都会去拉 Bub 主干,版本失控。所以安装前总是先把 `bub==<version>` 写进这个文件。\nconst BUB_OVERRIDE_FILE = \"/tmp/bub-override.txt\";\n/** 一个 agent 变体装的那套 bub:requirement + OTel 插件,两者都进安装指纹。 */\ninterface BubInstallPin {\n    requirement: string;\n    otelPlugin: string;\n    dependencyOverrides: readonly string[];\n}\nfunction resolvePin(config?: BubConfig): BubInstallPin {\n    const version = config?.version ?? DEFAULT_BUB_VERSION;\n    return {\n        requirement: config?.version ? bubRequirement(config.version) : DEFAULT_BUB_REQUIREMENT,\n        otelPlugin: config?.otelPlugin ?? DEFAULT_BUB_OTEL_PLUGIN,\n        // NiceEval can reproduce the default release's upstream lock exactly. A caller-selected\n        // historical Bub version owns a different closure, so do not silently apply 0.4.0's pins.\n        dependencyOverrides: version === DEFAULT_BUB_VERSION ? DEFAULT_BUB_DEPENDENCY_OVERRIDES : [],\n    };\n}\n// NiceEval 的预制配方与运行时安装都写到 $HOME/.local；显式使用该路径，避免 PATH 上\n// 另一个未知版本的 bub 抢先命中。\nconst BUB = \"$HOME/.local/bin/bub\";\n/** 规范化 python plugin:去空白、丢空串、去重 —— 安装命令与 checkpoint key 用同一份列表。 */\nfunction normalizePackages(plugins?: readonly PythonPluginSpec[]): string[] {\n    return normalizeBubPackages((plugins ?? []).map((plugin) => plugin.package));\n}\nfunction installHashOf(packages: readonly string[], pin: BubInstallPin): string {\n    return bubInstallHash(packages, pin.requirement, pin.otelPlugin, pin.dependencyOverrides);\n}\nfunction tapePath(workspace: string, sessionId: string, bubHome: string): string {\n    const w = createHash(\"md5\").update(workspace).digest(\"hex\").slice(0, 16);\n    const s = createHash(\"md5\").update(sessionId).digest(\"hex\").slice(0, 16);\n    return `${bubHome}/tapes/${w}__${s}.jsonl`;\n}\n// @concord-code ne-adapter-bub-agent\n// @concord-implements docs/feature/adapters/README.md\n// @concord-implements docs/feature/adapters/sdk/bub/README.md\nexport function bubAgent(config?: BubConfig): Agent {\n    const getApiKey = () => config?.apiKey ?? requireEnv(\"BUB_API_KEY\");\n    const getApiBase = () => config?.apiBase ?? requireEnv(\"BUB_API_BASE\");\n    const packages = normalizePackages(config?.pythonPlugins);\n    const pin = resolvePin(config);\n    const identity = {\n        agent: \"bub\",\n        version: config?.version ?? DEFAULT_BUB_VERSION,\n        revision: installHashOf(packages, pin),\n    } as const;\n    const marker = `$HOME/${BUB_INSTALL_MARKER}`;\n    const probe = defineSandboxCommand({ id: \"niceeval.agent.probe.bub\", revision: identity.revision, inputs: identity }, async (sandbox) => {\n        await sandbox.runShellOrThrow(`test -x ${BUB} && test \"$(cat ${marker} 2>/dev/null)\" = ${shellQuote(identity.revision)}`);\n    });\n    // sandboxId → { home, workspace }; persists values detected in setup() so send() can use them.\n    const sessionInfo = new Map<string, {\n        home: string;\n        workspace: string;\n    }>();\n    return registerAgentLifecycleHookCommands(makeSandboxAgent({\n        name: \"bub\",\n        ensure: { identity, probe },\n        installers: [{\n                identity,\n                installMode: \"sandbox-network\",\n                install: async (sandbox) => {\n                    await sandbox.runShellOrThrow(`test -x ${UV} || (curl -LsSf https://astral.sh/uv/install.sh | sh)`);\n                    await sandbox.writeText(BUB_OVERRIDE_FILE, `${[pin.requirement, ...pin.dependencyOverrides].join(\"\\n\")}\\n`);\n                    const withPlugins = packages.map((pkg) => `--with ${shellQuote(pkg)}`).join(\" \");\n                    let last = \"\";\n                    for (let attempt = 1; attempt <= 3; attempt += 1) {\n                        const result = await sandbox.runShell(`${UV} tool install --reinstall --python 3.12 --prerelease allow 'bub' --overrides ${BUB_OVERRIDE_FILE} --with ${shellQuote(pin.otelPlugin)}${withPlugins ? ` ${withPlugins}` : \"\"}`);\n                        if (result.exitCode === 0) {\n                            await sandbox.runShellOrThrow(`mkdir -p \"$(dirname ${marker})\" && printf '%s' ${shellQuote(identity.revision)} > ${marker}`);\n                            return;\n                        }\n                        last = (result.stdout + result.stderr).split(\"\\n\").slice(-15).join(\"\\n\");\n                    }\n                    throw new Error(`bub install failed after ${3} attempts:\n${last}`);\n                },\n            }],\n        // 官方 adapter:transcript 经生命周期 fixture 验证,全通道 complete。\n        evidenceCoverage: completeEvidenceCoverage,\n        spanMapper: mapBubSpans,\n        tracing: {\n            protocol: \"http/protobuf\",\n            env: (endpoint) => ({\n                BUB_TAPESTORE_OTEL_ENABLED: \"true\",\n                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,\n                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: \"http/protobuf\",\n            }),\n        },\n        setup: (sb, ctx) => Effect.tryPromise({\n            try: async () => {\n                // home 必须来自运行时探测:各 sandbox provider 不同(/home/node、/home/vercel-sandbox…),\n                // 兜一个 provider 专属常量会静默走错路径(tape 读不到 → 空事件流 → 负断言假通过)。\n                const home = (await sb.runShell(\"printf '%s' $HOME\")).stdout.trim();\n                if (!home)\n                    throw new Error(`Failed to detect sandbox $HOME (empty output from \\`printf $HOME\\`). Refusing to fall back to a provider-specific path; check the sandbox provider.`);\n                const workspace = sb.workdir;\n                sessionInfo.set(sb.sandboxId, { home, workspace });\n                // Agent CLI 已由 runner 的 agent.ensure 循环完成安装与复检。\n                // adapter setup 只写本 Attempt 的 runtime config。\n                if (!(await sb.pathExists(`${workspace}/AGENTS.md`))) {\n                    await shared.writeFile(sb, `${workspace}/AGENTS.md`, [\n                        `You are a coding agent working in a Next.js project at ${workspace}.`,\n                        ``,\n                        `Implement the requested feature by writing files directly to disk with the available tools:`,\n                        `- fs_write(path, content): create or overwrite a file`,\n                        `- fs_edit(path, old, new): edit an existing file`,\n                        `- bash(cmd): run shell commands`,\n                        ``,\n                        `Do NOT respond with only a text explanation — write the actual code files.`,\n                        `After writing, verify with bash(\"cd ${workspace} && npm run build\").`,\n                    ].join(\"\\n\"));\n                }\n                const manifest: AgentSetupManifest = { skills: [] };\n                if (config?.skills?.length) {\n                    manifest.skills = await installSkills(sb, config.skills, { dir: SKILL_DIR });\n                    // bub 没有原生 Skill 加载机制:装进目录不等于会被读到,发现指引跟着一起写。\n                    await appendProjectInstruction(sb, skillDiscoveryInstruction(SKILL_DIR, installedSkillNames(manifest.skills)));\n                }\n                if (packages.length)\n                    manifest.pythonPlugins = packages.map((pkg) => ({ package: pkg }));\n                if (manifest.skills.length || manifest.pythonPlugins?.length) {\n                    ctx.reportSetup(manifest);\n                }\n                // 安装后钩子(postSetup):排在 manifest 之后——manifest 审计 Adapter 自身的安装事实,\n                // 钩子失败不该丢掉这份证据。\n                await runPostSetupHooks(sb, ctx, \"bub\", config?.postSetup);\n            },\n            catch: (cause) => cause,\n        }),\n        teardown: (sb, ctx) => Effect.tryPromise({\n            try: async () => {\n                // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。\n                // bub 目前没有其它收尾步骤,这段就是整个 teardown。\n                await runPreTeardownHooks(sb, ctx, \"bub\", config?.preTeardown);\n            },\n            catch: (cause) => cause,\n        }),\n        send: (input, ctx) => Effect.tryPromise({\n            try: async () => {\n                const sb = ctx.sandbox;\n                const info = sessionInfo.get(sb.sandboxId);\n                if (!info)\n                    throw new Error(`bub adapter setup() has not run in this sandbox (missing home/workspace info). The runner must call setup before send.`);\n                const { home, workspace } = info;\n                const bubHome = `${home}/.bub`;\n                // 会话契约:ctx.session.id 未记录时开新 tape(新 sessionId),否则 resume 传入的 id。\n                // tape 路径由 md5(workspace)+md5(sessionId) 决定,同沙箱多会话靠 sessionId 区分。\n                const sessionId = ctx.session.id ?? `fe-${sb.sandboxId}-${randomUUID().slice(0, 8)}`;\n                ctx.session.capture(sessionId);\n                const apiKey = getApiKey();\n                const env: globalThis.Record<string, string> = {\n                    BUB_API_KEY: apiKey,\n                    BUB_API_BASE: getApiBase(),\n                    BUB_HOME: bubHome,\n                    ...ctx.telemetry?.env,\n                };\n                // model 归属:实验决定(ctx.model),省略时交给 bub 原生默认 / 用户环境,不硬编码。\n                if (ctx.model)\n                    env.BUB_MODEL = `openai:${ctx.model}`;\n                const res = await sb.runShell(`${BUB} --workspace ${workspace} run ${shared.shellQuote(input.text)} --session-id ${sessionId}`, { env, sensitiveValues: [apiKey], stream: true });\n                const raw = await sb.readText(tapePath(workspace, sessionId, bubHome)).catch(() => undefined);\n                const parsed = shared.parseBub(raw);\n                const events = [...parsed.events];\n                let turnEvidenceCoverage: TurnEvidenceCoverage | undefined;\n                if (!raw?.trim()) {\n                    const reason = \"Bub tape was unavailable; tool trajectory was not observed.\";\n                    turnEvidenceCoverage = {\n                        events: { status: \"unavailable\", reason },\n                        actions: { status: \"unavailable\", reason },\n                        usage: { status: \"unavailable\", reason },\n                    };\n                }\n                else if (!parsed.parseSuccess) {\n                    const reason = \"Some Bub tape lines could not be parsed.\";\n                    turnEvidenceCoverage = {\n                        events: { status: \"partial\", reason },\n                        actions: { status: \"partial\", reason },\n                    };\n                }\n                else {\n                    turnEvidenceCoverage = unclassifiedToolActionsCoverage(events);\n                }\n                if (res.exitCode !== 0) {\n                    throw makeSendFailure({\n                        acceptance: sendAcceptanceFromEvents(events),\n                        message: shared.diagnoseFailure(res, parsed.events, raw),\n                        events,\n                        usage: parsed.usage,\n                        process: res,\n                    });\n                }\n                return {\n                    events,\n                    usage: parsed.usage,\n                    status: \"completed\",\n                    ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),\n                };\n            },\n            catch: (cause) => cause,\n        }),\n    }), config?.postSetup, config?.preTeardown);\n}\nexport default bubAgent();\n"]}

package/dist/agents/claude-code-native.cjs

@@ -26,8 +26,24 @@ function eventKey(event) {
 }
 function parseFrames(frames, reported) {
     const parsed = shared_ts_1.shared.parseClaudeCode(frames.map((frame) => JSON.stringify(frame)).join("\n"));
+    // The terminal result owns aggregate usage for this send. Some native
+    // versions omit usage from assistant messages; adding both would double count.
+    const terminal = frames.map(record).findLast((frame) => frame?.type === "result");
+    const resultUsage = record(terminal?.usage);
+    const token = (name) => {
+        const value = resultUsage?.[name];
+        return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+    };
+    const usage = resultUsage === undefined ? parsed.usage : {
+        inputTokens: token("input_tokens"),
+        outputTokens: token("output_tokens"),
+        cacheReadTokens: token("cache_read_input_tokens"),
+        cacheCreationTokens: token("cache_creation_input_tokens"),
+        requests: typeof terminal?.num_turns === "number" && Number.isSafeInteger(terminal.num_turns) && terminal.num_turns >= 0
+            ? terminal.num_turns : parsed.usage.requests,
+    };
     return {
-        usage: parsed.usage,
+        usage,
         parseSuccess: parsed.parseSuccess,
         events: parsed.events.filter((event) => {
             const key = eventKey(event);
@@ -130,7 +146,17 @@ async function createState(ctx, args, env) {
         cwd: ctx.sandbox.workdir,
         env: { ...env, CLAUDE_CODE_ENTRYPOINT: "sdk-ts", CLAUDE_AGENT_SDK_VERSION: "0.3.226" },
     });
-    return { driver, cursor: 0, reported: new Set(), reportedToolProgress: new Set() };
+    const requestId = "niceeval-initialize";
+    await driver.write({ type: "control_request", request_id: requestId, request: { subtype: "initialize" } });
+    const initialized = await driver.waitFor(0, (value) => {
+        const frame = record(value);
+        return frame?.type === "control_response" && record(frame.response)?.request_id === requestId;
+    }, ctx.signal);
+    const response = record(record(initialized.frame)?.response);
+    if (response?.subtype !== "success") {
+        throw new Error(`Claude Code initialization failed: ${String(response?.error ?? "invalid control response")}`);
+    }
+    return { driver, cursor: initialized.cursor, reported: new Set(), reportedToolProgress: new Set() };
 }
 function pendingFrom(frame, sessionId) {
     if (frame.type !== "control_request" || typeof frame.request_id !== "string")