@vercel/agent-runs 0.0.0-stage → 0.0.1

package/dist/src/operations.js

@@ -0,0 +1,185 @@
+function report(onError, error, phase) {
+    try {
+        onError?.(error, { phase });
+    }
+    catch { }
+}
+export function wrappedOperation(start, fallback = { outcome: "completed" }, onError) {
+    async function invoke(input, execute) {
+        if (execute === undefined)
+            return start(input);
+        const handle = await start(input);
+        let completion = fallback;
+        try {
+            const value = await handle.run(() => execute(handle));
+            try {
+                completion =
+                    input.describe?.(value) ?? fallback;
+            }
+            catch (error) {
+                report(onError, error, "complete");
+            }
+            return value;
+        }
+        catch (error) {
+            completion = {
+                outcome: "failed",
+                errorType: error instanceof Error ? error.name : "_OTHER",
+                error,
+            };
+            throw error;
+        }
+        finally {
+            try {
+                await handle.complete(completion);
+            }
+            catch (error) {
+                report(onError, error, "complete");
+            }
+        }
+    }
+    return invoke;
+}
+export function operationHandle(runtime, data, onError) {
+    const live = (handle) => Object.defineProperties(handle, {
+        finished: { get: () => runtime.finished },
+        capture: { get: () => runtime.capture },
+        parent: { get: () => runtime.parent },
+    });
+    const common = {
+        type: runtime.type,
+        reference: runtime.reference,
+        get startTimeMs() {
+            return runtime.startTimeMs;
+        },
+        get parent() {
+            return runtime.parent;
+        },
+        get finished() {
+            return runtime.finished;
+        },
+        get capture() {
+            return runtime.capture;
+        },
+        run: (execute, ceiling) => runtime.run(execute, ceiling),
+        attributes: (attributes) => runtime.attributes(attributes),
+        complete: (result) => runtime.complete(result),
+        fail: (error) => runtime.fail(error),
+        recordError: (error, errorType) => runtime.error(error, errorType),
+    };
+    const child = async (data, key, options) => operationHandle(await runtime.child(data, key, options), data, onError);
+    const tool = wrappedOperation(async ({ startTimeMs, ...options }) => child({ type: "tool", options }, undefined, { startTimeMs }), undefined, onError);
+    const found = (operation) => operation === undefined
+        ? undefined
+        : operationHandle(operation, operation.record().data, onError);
+    const memory = wrappedOperation(async (options) => child({ type: "memory", options }), undefined, onError);
+    if (data.type === "activation")
+        return live({
+            ...common,
+            memory,
+            links: (links) => runtime.update({ links }),
+            findAttempt: (input) => found(runtime.find({
+                type: "step",
+                options: { index: input.stepIndex, attempt: input.attempt },
+            })),
+            findTool: (callId) => found(findTool(runtime, callId)),
+            attempt: wrappedOperation(async (input) => child({
+                type: "step",
+                options: {
+                    index: input.stepIndex,
+                    attempt: input.attempt,
+                    runtimeContext: input.runtimeContext,
+                    channel: input.channel,
+                },
+            }, undefined, { links: input.links }), undefined, onError),
+        });
+    if (data.type === "step") {
+        const delegation = (kind) => wrappedOperation(async (input) => child({
+            type: "tool",
+            options: { callId: input.callId, name: input.agentName, kind },
+        }), undefined, onError);
+        const startModel = (options, key) => child({ type: "model", options }, key);
+        async function modelCall(input, execute) {
+            if (typeof execute !== "function")
+                return startModel(input, execute);
+            const handle = await startModel(input);
+            let result;
+            try {
+                result = await handle.run(execute);
+            }
+            catch (error) {
+                try {
+                    await handle.fail(error);
+                }
+                catch (tracingError) {
+                    report(onError, tracingError, "complete");
+                }
+                throw error;
+            }
+            try {
+                await handle.complete({ outcome: "completed", result });
+            }
+            catch (error) {
+                report(onError, error, "complete");
+            }
+            return result.result;
+        }
+        return live({
+            ...common,
+            memory,
+            tool,
+            callSubAgent: delegation("subagent-call"),
+            callRemoteAgent: delegation("remote-agent-call"),
+            modelCall,
+            async modelStream(input, execute) {
+                const handle = await startModel(input);
+                try {
+                    const value = await handle.run(execute);
+                    const completion = Promise.resolve(value.completion)
+                        .then((result) => handle.complete({ outcome: "completed", result }), (error) => handle.fail(error))
+                        .catch((error) => report(onError, error, "complete"));
+                    runtime.waitUntil(completion);
+                    return value.result;
+                }
+                catch (error) {
+                    try {
+                        await handle.fail(error);
+                    }
+                    catch (tracingError) {
+                        report(onError, tracingError, "complete");
+                    }
+                    throw error;
+                }
+            },
+        });
+    }
+    if (data.type === "tool")
+        return live({
+            ...common,
+            memory,
+            tool,
+            findApproval: (requestId) => found(runtime.find({
+                type: "approval",
+                options: { requestId, callId: data.options.callId, toolName: data.options.name },
+            })),
+            approval: wrappedOperation(async (input) => child({
+                type: "approval",
+                options: { ...input, callId: data.options.callId, toolName: data.options.name },
+            }), { outcome: "ignored" }, onError),
+        });
+    return common;
+}
+/** Tool calls can nest, so a call ID is searched through every open call of the turn. */
+function findTool(parent, callId) {
+    for (const next of parent.children) {
+        if (next.type === "tool" && next.callId === callId)
+            return next;
+        if (next.type === "step" || next.type === "tool") {
+            const found = findTool(next, callId);
+            if (found !== undefined)
+                return found;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=operations.js.map

package/dist/src/operations.js.map

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

package/dist/src/otel.d.ts

@@ -0,0 +1,13 @@
+/**
+ * OpenTelemetry plumbing for hosts that run their own spans beside agent
+ * tracing: active-operation lookup, capture context, content bounds, and MCP
+ * enrichment. Agent tracing itself needs only the package root.
+ */
+export { activeTraceOperation, withErrorContent } from "./adapters/otel.js";
+export { withCapture } from "./capture.js";
+export { boundedPrincipalId, contentAttribute, telemetryByteLength, truncateTelemetryText, CONTENT_ATTRIBUTE_LIMIT, } from "./adapters/serialization.js";
+export { withoutDeclinedContent, type ResolvedContentOptions } from "./core/content-policy.js";
+export { mcpLifecycle, type McpLifecycle, type McpUpdate } from "./core/mcp.js";
+export { invocationName } from "./core/span-kinds.js";
+export { USAGE_FIELDS } from "./core/attributes.js";
+//# sourceMappingURL=otel.d.ts.map

package/dist/src/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../src/otel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/otel.js

@@ -0,0 +1,13 @@
+/**
+ * OpenTelemetry plumbing for hosts that run their own spans beside agent
+ * tracing: active-operation lookup, capture context, content bounds, and MCP
+ * enrichment. Agent tracing itself needs only the package root.
+ */
+export { activeTraceOperation, withErrorContent } from "./adapters/otel.js";
+export { withCapture } from "./capture.js";
+export { boundedPrincipalId, contentAttribute, telemetryByteLength, truncateTelemetryText, CONTENT_ATTRIBUTE_LIMIT, } from "./adapters/serialization.js";
+export { withoutDeclinedContent } from "./core/content-policy.js";
+export { mcpLifecycle } from "./core/mcp.js";
+export { invocationName } from "./core/span-kinds.js";
+export { USAGE_FIELDS } from "./core/attributes.js";
+//# sourceMappingURL=otel.js.map

package/dist/src/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../src/otel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAA+B,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAqC,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@vercel/agent-runs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "private": false,
+  "description": "Framework-neutral agent run tracing with OpenTelemetry and durable checkpoints.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vercel/eve.git",
+    "directory": "packages/tracing"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "NOTICE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "eve-source": "./src/index.ts",
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./delegation": {
+      "eve-source": "./src/delegation.ts",
+      "types": "./dist/src/delegation.d.ts",
+      "default": "./dist/src/delegation.js"
+    },
+    "./otel": {
+      "eve-source": "./src/otel.ts",
+      "types": "./dist/src/otel.d.ts",
+      "default": "./dist/src/otel.js"
+    },
+    "./ai-sdk": {
+      "eve-source": "./src/ai-sdk.ts",
+      "types": "./dist/src/ai-sdk.d.ts",
+      "default": "./dist/src/ai-sdk.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@ai-sdk/harness": "1.0.148",
+    "@ai-sdk/provider-utils": "^5.0.58",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/context-async-hooks": "2.6.1",
+    "@opentelemetry/sdk-trace-base": "2.6.1",
+    "@types/node": "24.13.3",
+    "ai": "^7.0.137",
+    "typescript": "7.0.2",
+    "vitest": "5.0.2",
+    "zod": "4.5.4"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "ai": "^7.0.137"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "test:unit": "vitest run --config vitest.unit.config.ts",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }

package/src/adapters/agent-transport.ts

@@ -0,0 +1,113 @@
+import { currentAgentHandoff, withAgentHandoff, type AgentHandoff } from "../core/delegation.js";
+const HANDOFF_BYTES = 8192;
+
+const HEADER = "x-agent-tracing";
+const encoder = new TextEncoder();
+function isHexId(value: unknown, length: number): boolean {
+  return (
+    typeof value === "string" &&
+    value.length === length &&
+    /^[a-f0-9]+$/u.test(value) &&
+    !/^0+$/u.test(value)
+  );
+}
+
+/** Bind only to a client whose destinations the application has approved. */
+function agentTraceFetch(fetcher: typeof fetch, maxBytes: number): typeof fetch {
+  return (request, init) => {
+    const handoff = currentAgentHandoff();
+    if (handoff === undefined) return fetcher(request, init);
+    const encoded = JSON.stringify(handoff);
+    if (encoder.encode(encoded).length > maxBytes) return fetcher(request, init);
+    const headers = new Headers(
+      init?.headers ?? (request instanceof Request ? request.headers : undefined),
+    );
+    headers.set(HEADER, encoded);
+    return fetcher(request, { ...init, headers, redirect: "error" });
+  };
+}
+
+/** The host validates provenance; well-formed trace metadata is not authorization. */
+function receiveAgentTrace<T>(
+  headers: Headers,
+  trusted: (handoff: AgentHandoff) => boolean,
+  execute: (handoff?: AgentHandoff) => T,
+  maxBytes: number,
+): T {
+  const encoded = headers.get(HEADER);
+  if (encoded === null || encoded.length > maxBytes || encoder.encode(encoded).length > maxBytes)
+    return execute();
+  let handoff: AgentHandoff;
+  const decode = (): AgentHandoff | undefined => {
+    try {
+      handoff = JSON.parse(encoded) as AgentHandoff;
+      if (
+        handoff === null ||
+        typeof handoff !== "object" ||
+        ![
+          handoff.conversationId,
+          handoff.parentRunId,
+          handoff.parentCallId,
+          handoff.agentName,
+        ].every((value) => typeof value === "string" && value.length > 0 && value.length <= 1024)
+      )
+        return undefined;
+      if (
+        !isHexId(handoff.caller.traceId, 32) ||
+        !isHexId(handoff.caller.spanId, 16) ||
+        ![0, 1].includes(handoff.caller.traceFlags)
+      )
+        return undefined;
+      if (
+        handoff.caller.tracestate !== undefined &&
+        (typeof handoff.caller.tracestate !== "string" || handoff.caller.tracestate.length > 512)
+      )
+        return undefined;
+      if (
+        ![handoff.capture.emit, handoff.capture.recordInputs, handoff.capture.recordOutputs].every(
+          (value) => typeof value === "boolean",
+        ) ||
+        !trusted(handoff)
+      )
+        return undefined;
+      return handoff;
+    } catch {
+      return undefined;
+    }
+  };
+  const decoded = decode();
+  if (decoded === undefined) return execute();
+  const accepted = {
+    ...decoded,
+    remote: true,
+    capture: {
+      emit: decoded.capture.emit && decoded.caller.traceFlags === 1,
+      recordInputs:
+        decoded.capture.emit && decoded.caller.traceFlags === 1 && decoded.capture.recordInputs,
+      recordOutputs:
+        decoded.capture.emit && decoded.caller.traceFlags === 1 && decoded.capture.recordOutputs,
+    },
+  };
+  return withAgentHandoff(accepted, () => execute(accepted));
+}
+
+/** Host boundary for durable dispatch and authenticated remote transport. */
+export function createAgentDelegationTransport(
+  fetcher: typeof fetch = (request, init) => globalThis.fetch(request, init),
+) {
+  const maxBytes = HANDOFF_BYTES;
+  return {
+    fetch: agentTraceFetch(fetcher, maxBytes),
+    transport: (fetcher: typeof fetch) => agentTraceFetch(fetcher, maxBytes),
+    receive<T>(
+      headers: Headers,
+      trusted: (handoff: AgentHandoff) => boolean,
+      execute: (handoff?: AgentHandoff) => T,
+    ) {
+      return receiveAgentTrace(headers, trusted, execute, maxBytes);
+    },
+    resume<T>(stored: AgentHandoff, execute: (handoff: AgentHandoff) => T): T {
+      return withAgentHandoff(stored, () => execute(stored));
+    },
+  };
+}

package/src/adapters/ai-sdk-payload.ts

@@ -0,0 +1,44 @@
+import type { ContentPart, Usage } from "../core/types.js";
+
+interface Result {
+  usage: {
+    inputTokens?: number;
+    outputTokens?: number;
+    inputTokenDetails?: { cacheReadTokens?: number; cacheWriteTokens?: number };
+  };
+  content: readonly unknown[];
+}
+
+export function modelUsage(usage: Result["usage"]): Usage {
+  return Object.freeze({
+    inputTokens: usage.inputTokens,
+    outputTokens: usage.outputTokens,
+    inputTokenDetails: Object.freeze({
+      cacheReadTokens: usage.inputTokenDetails?.cacheReadTokens,
+      cacheWriteTokens: usage.inputTokenDetails?.cacheWriteTokens,
+    }),
+  });
+}
+
+export function modelContent(content: Result["content"]): readonly ContentPart[] {
+  return content.flatMap((part): ContentPart[] => {
+    if (part === null || typeof part !== "object" || !("type" in part)) return [];
+    const value = part as {
+      type: string;
+      text?: string;
+      toolCallId?: string;
+      toolName?: string;
+      input?: unknown;
+      output?: unknown;
+      error?: unknown;
+    };
+    if ((value.type === "text" || value.type === "reasoning") && typeof value.text === "string")
+      return [{ type: value.type, text: value.text }];
+    if (typeof value.toolCallId !== "string" || typeof value.toolName !== "string") return [];
+    const tool = { callId: value.toolCallId, toolName: value.toolName, input: value.input };
+    if (value.type === "tool-call") return [{ type: value.type, ...tool }];
+    if (value.type === "tool-result") return [{ type: value.type, ...tool, output: value.output }];
+    if (value.type === "tool-error") return [{ type: value.type, ...tool, error: value.error }];
+    return [];
+  });
+}

package/src/adapters/ai-sdk-telemetry.ts

@@ -0,0 +1,179 @@
+import type { Telemetry } from "ai";
+import type { AgentRun, TurnInput } from "../agent-run.js";
+import type {
+  AttemptOperation,
+  ModelOperation,
+  ToolOperation,
+  TurnOperation,
+} from "../operations.js";
+import { modelContent, modelUsage } from "./ai-sdk-payload.js";
+
+type Event<K extends keyof Telemetry> = Parameters<NonNullable<Telemetry[K]>>[0];
+
+export interface AiSdkTelemetryOptions {
+  /** The turn a generation records. Called once per AI SDK call. */
+  readonly turn: TurnInput | ((call: { readonly callId: string }) => TurnInput);
+}
+
+interface Generation {
+  readonly startTimeMs: number;
+  turn?: Promise<TurnOperation>;
+  attempt?: Promise<AttemptOperation>;
+  model?: Promise<ModelOperation>;
+  readonly tools: Map<string, Promise<ToolOperation>>;
+}
+
+const ABANDONED = { outcome: "abandoned" } as const;
+
+/**
+ * An AI SDK telemetry integration that records each generation as a turn.
+ * Pass it to `telemetry.integrations` of `generateText`, `streamText`, or an
+ * agent such as `HarnessAgent`.
+ */
+export function aiSdkTelemetry(run: AgentRun, options: AiSdkTelemetryOptions): Telemetry {
+  const generations = new Map<string, Generation>();
+
+  function generation(callId: string): Generation {
+    let state = generations.get(callId);
+    if (state === undefined) {
+      state = { startTimeMs: Date.now(), tools: new Map() };
+      generations.set(callId, state);
+    }
+    return state;
+  }
+
+  async function closeStep(state: Generation, failure?: unknown) {
+    const result =
+      failure === undefined ? ABANDONED : { outcome: "abandoned", failed: true, error: failure };
+    await (await state.model)?.complete(result);
+    for (const tool of state.tools.values()) await (await tool).complete(result);
+    state.model = undefined;
+    state.tools.clear();
+    const attempt = await state.attempt;
+    state.attempt = undefined;
+    if (failure === undefined) await attempt?.complete();
+    else await attempt?.fail(failure);
+  }
+
+  async function finish(
+    callId: string,
+    end: (turn: TurnOperation) => Promise<void>,
+    failure?: unknown,
+  ) {
+    const state = generations.get(callId);
+    generations.delete(callId);
+    if (state === undefined) return;
+    await closeStep(state, failure);
+    const turn = await state.turn;
+    if (turn !== undefined) await end(turn);
+  }
+
+  return {
+    onStart(event: Event<"onStart">) {
+      generation(event.callId);
+    },
+    async onStepStart(event: Event<"onStepStart">) {
+      const state = generation(event.callId);
+      await closeStep(state);
+      state.turn ??= run.turn({
+        startTimeMs: state.startTimeMs,
+        ...(typeof options.turn === "function"
+          ? options.turn({ callId: event.callId })
+          : options.turn),
+      });
+      const turn = await state.turn;
+      state.attempt = turn.attempt({ stepIndex: event.stepNumber, attempt: 0 });
+    },
+    async onLanguageModelCallStart(event: Event<"onLanguageModelCallStart">) {
+      const attempt = await generations.get(event.callId)?.attempt;
+      if (attempt === undefined) return;
+      generations.get(event.callId)!.model = attempt.modelCall({
+        provider: event.provider,
+        modelId: event.modelId,
+        messages: event.messages,
+        instructions: event.instructions,
+        tools: event.tools,
+      });
+    },
+    async executeLanguageModelCall({ callId, execute }) {
+      const model = await generations.get(callId)?.model;
+      if (model === undefined || model.finished) return execute();
+      try {
+        return await model.run(execute);
+      } catch (error) {
+        await model.fail(error);
+        throw error;
+      }
+    },
+    async onLanguageModelCallEnd(event: Event<"onLanguageModelCallEnd">) {
+      const state = generations.get(event.callId);
+      const model = await state?.model;
+      if (state === undefined || model === undefined) return;
+      state.model = undefined;
+      await model.complete({
+        outcome: "completed",
+        result: {
+          finishReason: event.finishReason,
+          usage: modelUsage(event.usage),
+          responseId: event.responseId,
+          responseModelId: event.modelId,
+          content: modelContent(event.content),
+        },
+      });
+    },
+    async onToolExecutionStart(event: Event<"onToolExecutionStart">) {
+      const state = generations.get(event.callId);
+      const attempt = await state?.attempt;
+      if (state === undefined || attempt === undefined) return;
+      const call = event.toolCall;
+      state.tools.set(
+        call.toolCallId,
+        attempt.tool({ callId: call.toolCallId, name: call.toolName, arguments: call.input }),
+      );
+    },
+    async executeTool({ callId, toolCallId, execute }) {
+      const tool = await generations.get(callId)?.tools.get(toolCallId);
+      return tool === undefined || tool.finished ? execute() : tool.run(execute);
+    },
+    async onToolExecutionEnd(event: Event<"onToolExecutionEnd">) {
+      const state = generations.get(event.callId);
+      const tool = await state?.tools.get(event.toolCall.toolCallId);
+      if (state === undefined || tool === undefined) return;
+      state.tools.delete(event.toolCall.toolCallId);
+      const output = event.toolOutput;
+      const completion =
+        output.type === "tool-error"
+          ? {
+              outcome: "failed",
+              errorType: output.error instanceof Error ? output.error.name : "tool_error",
+              error: output.error,
+            }
+          : { outcome: "completed", output: "output" in output ? output.output : undefined };
+      await tool.complete(completion);
+    },
+    async onStepEnd(event: Event<"onStepEnd">) {
+      const state = generations.get(event.callId);
+      if (state !== undefined) await closeStep(state);
+    },
+    async onEnd(event: Event<"onEnd">) {
+      await finish(event.callId, (turn) =>
+        turn.complete({
+          outcome: "completed",
+          usage: "totalUsage" in event ? modelUsage(event.totalUsage) : undefined,
+        }),
+      );
+    },
+    async onAbort(event: Event<"onAbort">) {
+      await finish(event.callId, (turn) => turn.complete({ outcome: "cancelled" }));
+    },
+    async onError(value: unknown) {
+      // Some agents report the bare error; it then belongs to every open call.
+      const { callId, error } =
+        value !== null && typeof value === "object" && "callId" in value && "error" in value
+          ? (value as { callId: string; error: unknown })
+          : { callId: undefined, error: value };
+      for (const id of callId === undefined ? [...generations.keys()] : [callId])
+        await finish(id, (turn) => turn.fail(error), error);
+    },
+  };
+}