@tangle-network/agent-eval 0.94.0 → 0.95.0

package/dist/telemetry/sink-fetch.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Workers-safe telemetry sinks — only `fetch` and pure JS. No `fs`, no
+ * `child_process`. Safe to import from a Cloudflare Worker, Lambda, edge
+ * function, or browser extension.
+ *
+ * For Node-only file persistence, import from '@tangle-network/agent-eval/telemetry/file'.
+ */
+import type { TelemetryEnvelope } from './schema';
+export interface TelemetrySink {
+    emit(envelope: TelemetryEnvelope): Promise<void> | void;
+    close?(): Promise<void> | void;
+}
+/** Best-effort POST to a remote collector. Fire-and-forget; never throws. */
+export declare class HttpTelemetrySink implements TelemetrySink {
+    private readonly endpoint;
+    private readonly bearer?;
+    private inflight;
+    constructor(endpoint: string, bearer?: string | undefined);
+    emit(envelope: TelemetryEnvelope): void;
+    close(): Promise<void>;
+}
+/** Fanout to multiple sinks — failures in one do not affect others. */
+export declare class FanoutTelemetrySink implements TelemetrySink {
+    private readonly sinks;
+    constructor(sinks: TelemetrySink[]);
+    emit(envelope: TelemetryEnvelope): void;
+    close(): Promise<void>;
+}
+/** No-op sink — used when telemetry is explicitly disabled. */
+export declare class NullTelemetrySink implements TelemetrySink {
+    emit(): void;
+}
+/** In-memory sink — useful for tests + downstream adapters. */
+export declare class InMemoryTelemetrySink implements TelemetrySink {
+    readonly envelopes: TelemetryEnvelope[];
+    emit(envelope: TelemetryEnvelope): void;
+    clear(): void;
+}
+//# sourceMappingURL=sink-fetch.d.ts.map

package/dist/telemetry/sink-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink-fetch.d.ts","sourceRoot":"","sources":["../../src/telemetry/sink-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC/B;AAED,6EAA6E;AAC7E,qBAAa,iBAAkB,YAAW,aAAa;IAInD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAJ1B,OAAO,CAAC,QAAQ,CAA2B;gBAGxB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,YAAA;IAGlC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAWjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,uEAAuE;AACvE,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,aAAa,EAAE;IAEnD,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAajC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,+DAA+D;AAC/D,qBAAa,iBAAkB,YAAW,aAAa;IACrD,IAAI,IAAI,IAAI;CACb;AAED,+DAA+D;AAC/D,qBAAa,qBAAsB,YAAW,aAAa;IACzD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,EAAE,CAAK;IAC5C,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAGvC,KAAK,IAAI,IAAI;CAGd"}

package/dist/telemetry/{file.d.ts → sink-file.d.ts}

@@ -1,12 +1,11 @@
-import { c as TelemetrySink, e as TelemetryEnvelope } from '../sink-fetch-B1Yg4Til.js';
-
 /**
  * Node-only file sink. Imports `node:fs` — DO NOT import this from a Worker
  * or edge runtime; use `./sink-fetch` instead.
  */
-
+import type { TelemetryEnvelope } from './schema';
+import type { TelemetrySink } from './sink-fetch';
 /** Append envelopes to a JSONL file, partitioned by repo + date. */
-declare class FileTelemetrySink implements TelemetrySink {
+export declare class FileTelemetrySink implements TelemetrySink {
     private readonly baseDir;
     private streams;
     constructor(baseDir: string);
@@ -14,6 +13,5 @@ declare class FileTelemetrySink implements TelemetrySink {
     close(): Promise<void>;
 }
 /** Default location for local telemetry, mirroring bad CLI's convention. */
-declare function defaultTelemetryDir(homeDir: string, override?: string): string;
-
-export { FileTelemetrySink, defaultTelemetryDir };
+export declare function defaultTelemetryDir(homeDir: string, override?: string): string;
+//# sourceMappingURL=sink-file.d.ts.map

package/dist/telemetry/sink-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink-file.d.ts","sourceRoot":"","sources":["../../src/telemetry/sink-file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,oEAAoE;AACpE,qBAAa,iBAAkB,YAAW,aAAa;IAGzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAoC;gBAEtB,OAAO,EAAE,MAAM;IAI5C,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAiBjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E"}

package/dist/test-graded-scenario.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TestGradedScenario — a scenario whose score comes from a test suite.
+ *
+ * This is the SWE-bench pattern generalized. The scenario ships:
+ *   - fixture data (setup instructions)
+ *   - a test command the harness runs
+ *   - optional assertion overrides
+ *
+ * The runner emits a run, delegates to SandboxHarness, records the
+ * outcome, and returns a structured verdict. Consumers bind their own
+ * agent execution to this contract.
+ */
+import type { HarnessConfig, SandboxDriver, SandboxHarnessResult } from './sandbox-harness';
+import type { FailureClass, Run } from './trace/schema';
+import type { TraceStore } from './trace/store';
+export interface TestGradedScenario {
+    id: string;
+    description?: string;
+    harness: HarnessConfig;
+    /** Optional pass threshold in 0..1 (default 1.0 = all tests must pass). */
+    passThreshold?: number;
+    /** Provenance for dataset tracking. */
+    datasetVersion?: string;
+    /** Free-form tags (difficulty, category, etc.). */
+    tags?: Record<string, string>;
+}
+export interface TestGradedRunOptions {
+    variantId?: string;
+    driver?: SandboxDriver;
+    /** Metadata recorded on the Run (codeSha, promptSha, modelFingerprint, seed). */
+    provenance?: Pick<Run, 'codeSha' | 'promptSha' | 'modelFingerprint' | 'seed' | 'envFingerprint'>;
+}
+export interface TestGradedRunResult {
+    runId: string;
+    scenario: TestGradedScenario;
+    harness: SandboxHarnessResult;
+    pass: boolean;
+    score: number;
+    failureClass?: FailureClass;
+}
+export declare function runTestGradedScenario(scenario: TestGradedScenario, store: TraceStore, options?: TestGradedRunOptions): Promise<TestGradedRunResult>;
+//# sourceMappingURL=test-graded-scenario.d.ts.map

package/dist/test-graded-scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-graded-scenario.d.ts","sourceRoot":"","sources":["../src/test-graded-scenario.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAG3F,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,aAAa,CAAA;IACtB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,iFAAiF;IACjF,UAAU,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,WAAW,GAAG,kBAAkB,GAAG,MAAM,GAAG,gBAAgB,CAAC,CAAA;CACjG;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAqC9B"}

package/dist/testing.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Testing-only helpers. Do not import this subpath from production code.
+ */
+export { resetLockedAppendersForTesting } from './locked-jsonl-appender';
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/testing.js

@@ -0,0 +1,8 @@
+import {
+  resetLockedAppendersForTesting
+} from "./chunk-DJWX3GVS.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  resetLockedAppendersForTesting
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/tool-use-metrics.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tool-use metrics — derived purely from trace data.
+ *
+ * No scoring assumptions: consumers supply optional ground-truth tool
+ * selections per turn + optional "information used downstream" signals.
+ * Without those, we still compute descriptive metrics (error rate,
+ * retry rate, duplicate-call rate) that are useful on their own.
+ */
+import type { Span } from './trace/schema';
+import type { TraceStore } from './trace/store';
+export interface ToolUseMetrics {
+    runId: string;
+    totalCalls: number;
+    byTool: Record<string, ToolStats>;
+    errorRate: number;
+    /** Ratio of calls with identical (toolName, argHash) already seen earlier in the same run. */
+    duplicateRate: number;
+    /** Ratio of error calls followed by ≥1 retry on same tool. */
+    retryRate: number;
+    /** Optional: of the calls agent made, fraction the evaluator marked as "correct selection". */
+    selectionAccuracy?: number;
+}
+export interface ToolStats {
+    calls: number;
+    errors: number;
+    avgLatencyMs: number;
+    duplicates: number;
+}
+export interface ToolUseOptions {
+    /** Map of spanId → whether the evaluator judged the tool selection correct. Optional. */
+    selectionLabels?: Record<string, boolean>;
+}
+export declare function computeToolUseMetrics(store: TraceStore, runId: string, options?: ToolUseOptions): Promise<ToolUseMetrics>;
+export type { Span };
+//# sourceMappingURL=tool-use-metrics.d.ts.map

package/dist/tool-use-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-use-metrics.d.ts","sourceRoot":"","sources":["../src/tool-use-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAA;IACjB,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAgEzB;AAED,YAAY,EAAE,IAAI,EAAE,CAAA"}

package/dist/trace/capture-fetch.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `captureFetchToRawSink` — wrap a `fetch` so every request / response / error
+ * against a provider is recorded into a `RawProviderSink` as the canonical
+ * `RawProviderEvent` triple. The one substrate copy of the fetch-capture
+ * pattern four consumers hand-roll (legal ships two copies).
+ *
+ * The returned value is a plain `typeof fetch` — pass it as the `fetchImpl` to
+ * any OpenAI-compatible backend factory. Capture is best-effort by default: a
+ * sink write that throws does NOT take down the underlying LLM call (set
+ * `failClosed` to change that). Uses the existing `defaultProviderRedactor` +
+ * `providerFromBaseUrl` — no new redaction policy.
+ */
+import { type ExtractedUsage } from './extract-usage';
+import { type ProviderRedactor, type RawProviderSink } from './raw-provider-sink';
+export interface CaptureFetchContext {
+    /** Logical run id stamped on every captured event. Required — without it
+     *  the raw events can't be paired with their parent `Run`. */
+    runId: string;
+    /** Optional logical span id (enables span-level sink filtering). */
+    spanId?: string;
+    /** Resolved base URL (normalised, no trailing slash). Used for the event's
+     *  `baseUrl` and for endpoint-path extraction. */
+    baseUrl: string;
+    /** Model id the caller intends to invoke. Stamped on every event. */
+    model: string;
+    /** Provider override. When omitted, `providerFromBaseUrl(baseUrl)`. */
+    provider?: string;
+}
+export interface CaptureFetchOptions {
+    /** Override the capture-time redactor. Default `defaultProviderRedactor`. */
+    redactor?: ProviderRedactor;
+    /** Cap on captured response-body bytes; beyond it the body is truncated and
+     *  `body_truncated` is added to `redactedFields`. Default 2 MiB. */
+    responseBodyByteCap?: number;
+    /** When true, a sink-write failure propagates to the caller. Default false
+     *  — capture is best-effort so a sink failure never kills the LLM call. */
+    failClosed?: boolean;
+    /**
+     * Invoked with the token usage parsed off each successful response (JSON or
+     * SSE), keyed by the captured context. Lets a caller fold usage → cost without
+     * re-cloning the response themselves. Not called when the response carries no
+     * usage. Best-effort: a throw here is swallowed (it never kills the LLM call)
+     * unless `failClosed` is set.
+     */
+    onUsage?: (usage: ExtractedUsage, ctx: CaptureFetchContext) => void;
+}
+export declare function captureFetchToRawSink(fetch: typeof globalThis.fetch, sink: RawProviderSink, ctx: CaptureFetchContext, opts?: CaptureFetchOptions): typeof globalThis.fetch;
+//# sourceMappingURL=capture-fetch.d.ts.map

package/dist/trace/capture-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-fetch.d.ts","sourceRoot":"","sources":["../../src/trace/capture-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAqC,MAAM,iBAAiB,CAAA;AACxF,OAAO,EAEL,KAAK,gBAAgB,EAIrB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAA;AAE5B,MAAM,WAAW,mBAAmB;IAClC;kEAC8D;IAC9D,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;sDACkD;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B;wEACoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;+EAC2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACpE;AAiDD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,EAC9B,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,mBAAmB,EACxB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,UAAU,CAAC,KAAK,CA0GzB"}

package/dist/trace/capture-fetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capture-fetch.test.d.ts.map

package/dist/trace/capture-fetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-fetch.test.d.ts","sourceRoot":"","sources":["../../src/trace/capture-fetch.test.ts"],"names":[],"mappings":""}

package/dist/{emitter-C2rqGH_l.d.ts → trace/emitter.d.ts}

@@ -1,6 +1,3 @@
-import { b as RunOutcome, R as Run, S as Span, c as SpanKind, L as LlmSpan, T as ToolSpan, d as RetrievalSpan, J as JudgeSpan, e as SandboxSpan, E as EventKind, a as TraceEvent, B as BudgetLedgerEntry, A as Artifact, M as Message } from './schema-m0gsnbt3.js';
-import { T as TraceStore } from './store-BcFXE6LG.js';
-
 /**
  * TraceEmitter — hierarchical span builder that auto-parents using an
  * internal stack. One emitter per Run; emitters do NOT share state.
@@ -11,13 +8,14 @@ import { T as TraceStore } from './store-BcFXE6LG.js';
  * the stack (e.g. fan-out parallel calls), pass `parentSpanId`
  * explicitly.
  */
-
-interface SpanHandle<S extends Span = Span> {
+import type { Artifact, BudgetLedgerEntry, EventKind, JudgeSpan, LlmSpan, Message, RetrievalSpan, Run, RunOutcome, SandboxSpan, Span, SpanKind, ToolSpan, TraceEvent } from './schema';
+import type { TraceStore } from './store';
+export interface SpanHandle<S extends Span = Span> {
     span: S;
     end(patch?: Partial<S>): Promise<void>;
     fail(error: string | Error, patch?: Partial<S>): Promise<void>;
 }
-interface RunCompleteHookContext {
+export interface RunCompleteHookContext {
     runId: string;
     emitter: TraceEmitter;
     store: TraceStore;
@@ -26,8 +24,8 @@ interface RunCompleteHookContext {
     /** Final run status. */
     status: 'completed' | 'failed' | 'aborted';
 }
-type RunCompleteHook = (ctx: RunCompleteHookContext) => Promise<void> | void;
-interface TraceEmitterOptions {
+export type RunCompleteHook = (ctx: RunCompleteHookContext) => Promise<void> | void;
+export interface TraceEmitterOptions {
     runId?: string;
     /** Inject a clock for deterministic tests. */
     now?: () => number;
@@ -46,7 +44,7 @@ interface TraceEmitterOptions {
     /** `'swallow'` (default) | `'throw'`. */
     hookErrors?: 'swallow' | 'throw';
 }
-declare class TraceEmitter {
+export declare class TraceEmitter {
     private store;
     private stack;
     private _runId;
@@ -104,7 +102,7 @@ declare class TraceEmitter {
     within<T>(init: Parameters<TraceEmitter['span']>[0], fn: (handle: SpanHandle) => Promise<T>): Promise<T>;
 }
 /** Helper to build an LLM span handle args object from a provider-shaped response. */
-declare function llmSpanFromProvider(args: {
+export declare function llmSpanFromProvider(args: {
     name?: string;
     model: string;
     messages: Message[];
@@ -118,5 +116,4 @@ declare function llmSpanFromProvider(args: {
     costUsd?: number;
     finishReason?: string;
 }): Omit<LlmSpan, 'spanId' | 'runId' | 'kind' | 'startedAt'>;
-
-export { type RunCompleteHook as R, type SpanHandle as S, TraceEmitter as T, type RunCompleteHookContext as a, type TraceEmitterOptions as b, llmSpanFromProvider as l };
+//# sourceMappingURL=emitter.d.ts.map

package/dist/trace/emitter.d.ts.map

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

package/dist/trace/extract-usage.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Token-usage extraction from chat-completions responses and SSE streams.
+ *
+ * `captureFetchToRawSink` records the raw provider triple but deliberately does
+ * not interpret token usage — cost is a per-consumer axis. Three consumers each
+ * re-implement the same `usage` parser on top of the captured response (the
+ * OpenAI `prompt_tokens`/`completion_tokens` shape, the Anthropic
+ * `input_tokens`/`output_tokens` shape, and the camelCase variants), plus an
+ * SSE accumulator that sums the per-chunk `usage` deltas. This is the one
+ * canonical version.
+ *
+ * Both functions return `null` (not a silent `{ input: 0, output: 0 }`) when no
+ * usage is present, so a caller can tell "no usage reported" from "zero tokens".
+ */
+export interface ExtractedUsage {
+    input: number;
+    output: number;
+    /** Cached prompt tokens, when the provider reports them. */
+    cached?: number;
+}
+/**
+ * Pull `{ input, output, cached? }` from a parsed chat-completions response
+ * body. Accepts a top-level `usage` object (the common case) or a body that IS
+ * the usage object. Returns null when neither an input nor an output count is
+ * present — callers must inspect for null rather than treat it as zero cost.
+ */
+export declare function extractUsage(body: unknown): ExtractedUsage | null;
+/**
+ * Sum token usage across an SSE response body. Each `data:` line is parsed and
+ * fed to `extractUsage`; the per-chunk counts are accumulated. The `[DONE]`
+ * sentinel and non-JSON lines are skipped. Returns null when no chunk carried
+ * usage — distinguishing a usage-less stream from a genuine zero.
+ *
+ * Providers report SSE usage in two ways: a single terminal chunk with the full
+ * totals, or incremental per-chunk deltas. Summing is correct for the delta
+ * case and harmless for the terminal case (one non-null chunk ⇒ the total).
+ */
+export declare function extractUsageFromSse(text: string): ExtractedUsage | null;
+/**
+ * Extract usage from an HTTP `Response` without consuming the caller's body:
+ * clones, reads the text, and tries the JSON parser first, then the SSE
+ * accumulator. Best-effort — returns null on any read/parse miss so a usage tee
+ * never takes down the underlying call.
+ */
+export declare function extractUsageFromResponse(response: Response): Promise<ExtractedUsage | null>;
+//# sourceMappingURL=extract-usage.d.ts.map

package/dist/trace/extract-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-usage.d.ts","sourceRoot":"","sources":["../../src/trace/extract-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAwBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAYjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA6BvE;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAcjG"}

package/dist/trace/extract-usage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extract-usage.test.d.ts.map

package/dist/trace/extract-usage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-usage.test.d.ts","sourceRoot":"","sources":["../../src/trace/extract-usage.test.ts"],"names":[],"mappings":""}

package/dist/trace/index.d.ts

@@ -0,0 +1,15 @@
+export * from './capture-fetch';
+export * from './emitter';
+export * from './extract-usage';
+export * from './integrity';
+export * from './otel';
+export * from './otel-bridge';
+export * from './otel-export';
+export * from './otlp-attributes';
+export * from './query';
+export * from './raw-provider-sink';
+export * from './redact';
+export * from './schema';
+export * from './store';
+export * from './store-to-otlp';
+//# sourceMappingURL=index.d.ts.map

package/dist/trace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA"}

package/dist/{integrity-D2t12mMw.d.ts → trace/integrity.d.ts}

@@ -1,7 +1,3 @@
-import { C as CaptureIntegrityError } from './errors-CzMUYo7b.js';
-import { R as RawProviderSink } from './raw-provider-sink-C46HDghv.js';
-import { T as TraceStore } from './store-BcFXE6LG.js';
-
 /**
  * Run-completion integrity check — at end of run, verify the expected event
  * types were actually captured. The point is the launch-review failure mode:
@@ -22,8 +18,10 @@ import { T as TraceStore } from './store-BcFXE6LG.js';
  * the caller chooses the failure mode (throw, mark run failed, log warning).
  * `throwIfRunIncomplete` is the convenient strict mode.
  */
-
-interface RunIntegrityExpectations {
+import { CaptureIntegrityError } from '../errors';
+import type { RawProviderSink } from './raw-provider-sink';
+import type { TraceStore } from './store';
+export interface RunIntegrityExpectations {
     /** Minimum LLM span count. Default 0 (no requirement). */
     llmSpansMin?: number;
     /** Minimum judge span count. Default 0. */
@@ -46,13 +44,13 @@ interface RunIntegrityExpectations {
     /** Run outcome must be set (not null/undefined). Default false. */
     requireOutcome?: boolean;
 }
-type RunIntegrityIssueCode = 'no_run' | 'missing_llm_spans' | 'missing_judge_spans' | 'missing_tool_spans' | 'missing_raw_events' | 'no_raw_sink' | 'orphan_llm_span' | 'missing_outcome';
-interface RunIntegrityIssue {
+export type RunIntegrityIssueCode = 'no_run' | 'missing_llm_spans' | 'missing_judge_spans' | 'missing_tool_spans' | 'missing_raw_events' | 'no_raw_sink' | 'orphan_llm_span' | 'missing_outcome';
+export interface RunIntegrityIssue {
     code: RunIntegrityIssueCode;
     message: string;
     detail?: Record<string, unknown>;
 }
-interface RunIntegrityReport {
+export interface RunIntegrityReport {
     ok: boolean;
     runId: string;
     llmSpanCount: number;
@@ -70,12 +68,11 @@ interface RunIntegrityReport {
     };
     issues: RunIntegrityIssue[];
 }
-declare class RunIntegrityError extends CaptureIntegrityError {
+export declare class RunIntegrityError extends CaptureIntegrityError {
     readonly report: RunIntegrityReport;
     constructor(report: RunIntegrityReport);
 }
-declare function assertRunCaptured(store: TraceStore, runId: string, expectations?: RunIntegrityExpectations): Promise<RunIntegrityReport>;
+export declare function assertRunCaptured(store: TraceStore, runId: string, expectations?: RunIntegrityExpectations): Promise<RunIntegrityReport>;
 /** Strict mode: throws `RunIntegrityError` when the report isn't ok. */
-declare function throwIfRunIncomplete(report: RunIntegrityReport): void;
-
-export { type RunIntegrityExpectations as R, type RunIntegrityReport as a, RunIntegrityError as b, type RunIntegrityIssue as c, type RunIntegrityIssueCode as d, assertRunCaptured as e, throwIfRunIncomplete as t };
+export declare function throwIfRunIncomplete(report: RunIntegrityReport): void;
+//# sourceMappingURL=integrity.d.ts.map

package/dist/trace/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../src/trace/integrity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,aAAa,GACb,iBAAiB,GACjB,iBAAiB,CAAA;AAErB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAED,qBAAa,iBAAkB,SAAQ,qBAAqB;aAC9B,MAAM,EAAE,kBAAkB;gBAA1B,MAAM,EAAE,kBAAkB;CAKvD;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,kBAAkB,CAAC,CA0G7B;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAErE"}

package/dist/trace/otel-bridge.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OTEL bridge — connects TraceEmitter span lifecycle to the OtelExporter.
+ *
+ * When an OtelExporter is active, every span that closes through the
+ * TraceEmitter is also pushed to the exporter for real-time streaming to
+ * the user's OTEL collector.
+ *
+ * The bridge is opt-in: attach via `otelRunCompleteHook(exporter)` as a
+ * RunCompleteHook, or wrap the store with `createOtelTracingStore` for
+ * real-time per-span export.
+ */
+import type { RunCompleteHook } from './emitter';
+import type { OtelExporter } from './otel-export';
+import type { TraceStore } from './store';
+/**
+ * Create a RunCompleteHook that exports all spans from the completed run
+ * to the OTEL exporter, then flushes.
+ */
+export declare function otelRunCompleteHook(exporter: OtelExporter): RunCompleteHook;
+/**
+ * Create an auto-exporting TraceStore wrapper that intercepts updateSpan
+ * calls. When a span gets an endedAt, it's exported immediately. This
+ * gives real-time streaming instead of batch-at-end.
+ *
+ * This is the preferred integration path: wrap the store before
+ * constructing the TraceEmitter.
+ */
+export declare function createOtelTracingStore(inner: TraceStore, exporter: OtelExporter, traceId: string): TraceStore;
+//# sourceMappingURL=otel-bridge.d.ts.map

package/dist/trace/otel-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-bridge.d.ts","sourceRoot":"","sources":["../../src/trace/otel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,CAU3E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,UAAU,CAwCZ"}

package/dist/trace/otel-export.d.ts

@@ -0,0 +1,52 @@
+/**
+ * OTEL span exporter — streams spans to an OTLP/HTTP collector.
+ *
+ * Reads OTEL_EXPORTER_OTLP_ENDPOINT + OTEL_EXPORTER_OTLP_HEADERS from env
+ * when no explicit config is given. Batches spans and flushes periodically
+ * or when the batch fills. No @opentelemetry SDK dependency — minimal
+ * OTLP/JSON serializer (~120 LOC) using the existing otel.ts helpers.
+ */
+export interface OtelExportConfig {
+    /** OTLP endpoint. Reads OTEL_EXPORTER_OTLP_ENDPOINT env by default. */
+    endpoint?: string;
+    /** OTLP headers. Reads OTEL_EXPORTER_OTLP_HEADERS env by default. */
+    headers?: Record<string, string>;
+    /** Batch size before flush. Default 64. */
+    batchSize?: number;
+    /** Flush interval ms. Default 5000. */
+    flushIntervalMs?: number;
+    /** Resource attributes stamped on every export. */
+    resourceAttributes?: Record<string, string | number | boolean>;
+    /** Service name. Default 'agent-eval'. */
+    serviceName?: string;
+}
+export interface OtelExporter {
+    /** Called by the TraceEmitter on every span close. */
+    exportSpan(span: ExportableSpan): void;
+    /** Force flush pending spans. */
+    flush(): Promise<void>;
+    /** Shutdown cleanly — flushes remaining spans and stops the timer. */
+    shutdown(): Promise<void>;
+}
+export interface ExportableSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: string;
+    startedAt: number;
+    endedAt?: number;
+    status?: string;
+    error?: string;
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Create an OTEL exporter. Returns undefined when no endpoint is configured
+ * (neither via config nor env) — callers should check before attaching.
+ */
+export declare function createOtelExporter(config?: OtelExportConfig): OtelExporter | undefined;
+//# sourceMappingURL=otel-export.d.ts.map

package/dist/trace/otel-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-export.d.ts","sourceRoot":"","sources":["../../src/trace/otel-export.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IAC9D,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IACtC,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,sEAAsE;IACtE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY,GAAG,SAAS,CAgFtF"}

package/dist/trace/otel.d.ts

@@ -0,0 +1,57 @@
+/**
+ * OpenTelemetry JSON export — maps TraceSchema v1 to OTLP/JSON so
+ * traces render natively in Jaeger / Honeycomb / Langfuse / Grafana.
+ *
+ * Wire format only. We do NOT depend on the @opentelemetry SDK — that
+ * would drag in polyfills incompatible with Workers/Edge. Consumers
+ * push the JSON to their collector of choice via HTTP.
+ *
+ * Reference: OTLP 1.3.2 (ResourceSpans / ScopeSpans / Span).
+ */
+import type { TraceStore } from './store';
+export declare const OTEL_AGENT_EVAL_SCOPE: {
+    name: string;
+    version: string;
+};
+export interface OtlpSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: Array<{
+        key: string;
+        value: {
+            stringValue?: string;
+            intValue?: string;
+            doubleValue?: number;
+            boolValue?: boolean;
+        };
+    }>;
+    events?: Array<{
+        timeUnixNano: string;
+        name: string;
+        attributes?: OtlpSpan['attributes'];
+    }>;
+    status?: {
+        code: number;
+        message?: string;
+    };
+}
+export interface OtlpResourceSpans {
+    resource: {
+        attributes: OtlpSpan['attributes'];
+    };
+    scopeSpans: Array<{
+        scope: typeof OTEL_AGENT_EVAL_SCOPE;
+        spans: OtlpSpan[];
+    }>;
+}
+export interface OtlpExport {
+    resourceSpans: OtlpResourceSpans[];
+}
+/** Export a single run's spans + events in OTLP/JSON. */
+export declare function exportRunAsOtlp(store: TraceStore, runId: string, resourceAttrs?: Record<string, string | number | boolean>): Promise<OtlpExport>;
+//# sourceMappingURL=otel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../src/trace/otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,eAAO,MAAM,qBAAqB;;;CAA2D,CAAA;AAE7F,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,KAAK,CAAC;QAChB,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAC9F,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC,CAAA;IAC3F,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE;QAAE,UAAU,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;KAAE,CAAA;IAChD,UAAU,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,OAAO,qBAAqB,CAAC;QAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC,CAAA;CAC9E;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,iBAAiB,EAAE,CAAA;CACnC;AAED,yDAAyD;AACzD,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAM,GAC5D,OAAO,CAAC,UAAU,CAAC,CAmCrB"}

package/dist/trace/otlp-attributes.d.ts

@@ -0,0 +1,17 @@
+/** Canonical OpenInference-over-OTLP attribute vocabulary used at the trace boundary. */
+export declare const OPENINFERENCE_SPAN_KIND = "openinference.span.kind";
+export declare const LLM_MODEL_NAME = "llm.model_name";
+export declare const LLM_INPUT_TOKENS = "llm.token_count.prompt";
+export declare const LLM_OUTPUT_TOKENS = "llm.token_count.completion";
+export declare const LLM_CACHED_TOKENS = "llm.token_count.prompt_cache_hit";
+export declare const LLM_COST_USD = "llm.cost_usd";
+export declare const TOOL_NAME = "tool.name";
+export declare const SPAN_KIND_ATTR_KEYS: readonly ["openinference.span.kind", "inference.observation_kind"];
+export declare const LLM_MODEL_ATTR_KEYS: readonly ["llm.model_name", "inference.llm.model_name", "llm.model", "gen_ai.request.model", "gen_ai.response.model"];
+export declare const LLM_INPUT_TOKEN_ATTR_KEYS: readonly ["llm.token_count.prompt", "inference.llm.input_tokens", "llm.input_tokens", "gen_ai.usage.input_tokens", "gen_ai.usage.prompt_tokens"];
+export declare const LLM_OUTPUT_TOKEN_ATTR_KEYS: readonly ["llm.token_count.completion", "inference.llm.output_tokens", "llm.output_tokens", "gen_ai.usage.output_tokens", "gen_ai.usage.completion_tokens"];
+export declare const LLM_CACHED_TOKEN_ATTR_KEYS: readonly ["llm.token_count.prompt_cache_hit", "inference.llm.cached_tokens", "llm.cached_tokens", "gen_ai.usage.cached_tokens"];
+export declare const LLM_COST_ATTR_KEYS: readonly ["llm.cost_usd", "inference.llm.cost.total", "llm.cost.total", "gen_ai.usage.cost"];
+export declare const TOOL_NAME_ATTR_KEYS: readonly ["tool.name", "inference.tool.name"];
+export declare function traceSpanKindToOpenInferenceKind(kind: string): string;
+//# sourceMappingURL=otlp-attributes.d.ts.map