@tangle-network/agent-eval 0.93.0 → 0.95.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-attributes.d.ts","sourceRoot":"","sources":["../../src/trace/otlp-attributes.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,eAAO,MAAM,uBAAuB,4BAA4B,CAAA;AAChE,eAAO,MAAM,cAAc,mBAAmB,CAAA;AAC9C,eAAO,MAAM,gBAAgB,2BAA2B,CAAA;AACxD,eAAO,MAAM,iBAAiB,+BAA+B,CAAA;AAC7D,eAAO,MAAM,iBAAiB,qCAAqC,CAAA;AACnE,eAAO,MAAM,YAAY,iBAAiB,CAAA;AAC1C,eAAO,MAAM,SAAS,cAAc,CAAA;AAEpC,eAAO,MAAM,mBAAmB,oEAAmE,CAAA;AAEnG,eAAO,MAAM,mBAAmB,uHAMtB,CAAA;AAEV,eAAO,MAAM,yBAAyB,kJAM5B,CAAA;AAEV,eAAO,MAAM,0BAA0B,6JAM7B,CAAA;AAEV,eAAO,MAAM,0BAA0B,iIAK7B,CAAA;AAEV,eAAO,MAAM,kBAAkB,8FAKrB,CAAA;AAEV,eAAO,MAAM,mBAAmB,+CAA8C,CAAA;AAE9E,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBrE"}

package/dist/trace/query.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Typed query helpers over TraceStore.
+ *
+ * Not a full SQL engine — a minimal, composable set of operators that
+ * cover the canned-pipeline use cases. For ad-hoc analytics, persist to
+ * NDJSON and point DuckDB at it; the schema is stable so external SQL
+ * tooling works out of the box.
+ */
+import type { FailureClass, JudgeSpan, LlmSpan, Run, ToolSpan } from './schema';
+import type { TraceStore } from './store';
+export declare function runsForScenario(store: TraceStore, scenarioId: string): Promise<Run[]>;
+export declare function llmSpans(store: TraceStore, runId?: string): Promise<LlmSpan[]>;
+export declare function toolSpans(store: TraceStore, runId?: string, toolName?: string): Promise<ToolSpan[]>;
+export declare function judgeSpans(store: TraceStore, runId?: string): Promise<JudgeSpan[]>;
+/** Group spans by any key selector. */
+export declare function groupBy<T, K extends string | number>(items: T[], key: (t: T) => K): Map<K, T[]>;
+/** Hash tool arguments to an orderless-key-stable string for de-duplication. */
+export declare function argHash(args: unknown): string;
+/** Sum an LLM-span array into aggregate token + cost. */
+export declare function aggregateLlm(spans: LlmSpan[]): {
+    inputTokens: number;
+    outputTokens: number;
+    cachedTokens: number;
+    reasoningTokens: number;
+    costUsd: number;
+};
+/** Pick the outcome's failure class when present, else derive 'success' from run status. */
+export declare function runFailureClass(run: Run): FailureClass;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/trace/query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAE3F;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGpF;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAGrB;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAGxF;AAED,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAY/F;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAE7C;AAoBD,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG;IAC9C,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB,CAaA;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY,CAKtD"}

package/dist/trace/query.test.d.ts

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

package/dist/trace/query.test.d.ts.map

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

package/dist/{raw-provider-sink-C46HDghv.d.ts → trace/raw-provider-sink.d.ts}

@@ -24,8 +24,8 @@
  * the per-call `redactor`. The `redactedFields` array on the persisted
  * event lets a reviewer see what was stripped without exposing the values.
  */
-type RawProviderDirection = 'request' | 'response' | 'error';
-interface RawProviderEvent {
+export type RawProviderDirection = 'request' | 'response' | 'error';
+export interface RawProviderEvent {
     /** Stable id. Generated by the sink if omitted. */
     eventId: string;
     /** Trace context populated by `LlmClient` when the call is wrapped in a span. */
@@ -59,30 +59,30 @@ interface RawProviderEvent {
     /** Field paths the redactor stripped from this event ('header:Authorization', 'body.apiKey', …). */
     redactedFields: string[];
 }
-interface RawProviderSinkFilter {
+export interface RawProviderSinkFilter {
     runId?: string;
     spanId?: string;
     direction?: RawProviderDirection;
     attemptIndex?: number;
 }
-interface RawProviderSink {
+export interface RawProviderSink {
     record(event: RawProviderEvent): Promise<void>;
     /** Optional listing — implementations that durably persist (file, db) should support this. */
     list?(filter?: RawProviderSinkFilter): Promise<RawProviderEvent[]>;
     /** Optional teardown for backed implementations. */
     close?(): Promise<void>;
 }
-type ProviderRedactor = (event: RawProviderEvent) => RawProviderEvent;
+export type ProviderRedactor = (event: RawProviderEvent) => RawProviderEvent;
 /**
  * Default redactor — strips well-known auth headers and any body field whose
  * key matches the credential pattern. Records every redacted path on
  * `event.redactedFields` so a downstream reviewer can see what was removed.
  */
-declare function defaultProviderRedactor(event: RawProviderEvent): RawProviderEvent;
-interface InMemoryRawProviderSinkOptions {
+export declare function defaultProviderRedactor(event: RawProviderEvent): RawProviderEvent;
+export interface InMemoryRawProviderSinkOptions {
     redactor?: ProviderRedactor;
 }
-declare class InMemoryRawProviderSink implements RawProviderSink {
+export declare class InMemoryRawProviderSink implements RawProviderSink {
     private events;
     private redactor;
     constructor(opts?: InMemoryRawProviderSinkOptions);
@@ -90,7 +90,7 @@ declare class InMemoryRawProviderSink implements RawProviderSink {
     list(filter?: RawProviderSinkFilter): Promise<RawProviderEvent[]>;
     size(): number;
 }
-declare class NoopRawProviderSink implements RawProviderSink {
+export declare class NoopRawProviderSink implements RawProviderSink {
     record(): Promise<void>;
     /**
      * Returns an empty array. Implemented so `assertRunCaptured` does not
@@ -100,7 +100,7 @@ declare class NoopRawProviderSink implements RawProviderSink {
      */
     list(): Promise<RawProviderEvent[]>;
 }
-interface FileSystemRawProviderSinkOptions {
+export interface FileSystemRawProviderSinkOptions {
     /** Directory the NDJSON file is written into. Created if missing. */
     dir: string;
     /** File name; default `'raw-provider-events.ndjson'`. */
@@ -109,7 +109,7 @@ interface FileSystemRawProviderSinkOptions {
     rollAtBytes?: number;
     redactor?: ProviderRedactor;
 }
-declare class FileSystemRawProviderSink implements RawProviderSink {
+export declare class FileSystemRawProviderSink implements RawProviderSink {
     private dir;
     private fileName;
     private rollAtBytes;
@@ -127,6 +127,5 @@ declare class FileSystemRawProviderSink implements RawProviderSink {
  * Best-effort provider id from a base URL. Falls back to the URL host when
  * none of the well-known patterns match.
  */
-declare function providerFromBaseUrl(baseUrl: string): string;
-
-export { FileSystemRawProviderSink as F, InMemoryRawProviderSink as I, NoopRawProviderSink as N, type ProviderRedactor as P, type RawProviderSink as R, type FileSystemRawProviderSinkOptions as a, type InMemoryRawProviderSinkOptions as b, type RawProviderDirection as c, type RawProviderEvent as d, type RawProviderSinkFilter as e, defaultProviderRedactor as f, providerFromBaseUrl as p };
+export declare function providerFromBaseUrl(baseUrl: string): string;
+//# sourceMappingURL=raw-provider-sink.d.ts.map

package/dist/trace/raw-provider-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-provider-sink.d.ts","sourceRoot":"","sources":["../../src/trace/raw-provider-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,oBAAoB,CAAA;IAC/B,eAAe;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oGAAoG;IACpG,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,oBAAoB,CAAA;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,8FAA8F;IAC9F,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAClE,oDAAoD;IACpD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,gBAAgB,CAAA;AAc5E;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAOjF;AAuCD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAED,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,IAAI,GAAE,8BAAmC;IAI/C,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,IAAI,CAAC,MAAM,GAAE,qBAA0B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAU3E,IAAI,IAAI,MAAM;CAGf;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACnD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAG7B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAG1C;AAID,MAAM,WAAW,gCAAgC;IAC/C,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAA;IACX,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAED,qBAAa,yBAA0B,YAAW,eAAe;IAC/D,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,WAAW,CAA6B;gBAEpC,IAAI,EAAE,gCAAgC;YAOpC,UAAU;IAOxB,OAAO,CAAC,WAAW;IAKb,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9C,IAAI,CAAC,MAAM,GAAE,qBAA0B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA0B5E;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc3D"}

package/dist/{redact-B40YG2M_.d.ts → trace/redact.d.ts}

@@ -11,24 +11,24 @@
  * eval framework can count how many redactions happened per run
  * (surfaced via `redaction_applied` events).
  */
-interface RedactionRule {
+export interface RedactionRule {
     id: string;
     pattern: RegExp;
     /** Replacement — e.g. '[PII:email]'. Defaults to `[redacted:{id}]`. */
     replacement?: string;
 }
-interface RedactionReport {
+export interface RedactionReport {
     redactionCount: number;
     byRule: Record<string, number>;
 }
 /** OWASP / common-sense defaults — extend per-domain. */
-declare const DEFAULT_REDACTION_RULES: RedactionRule[];
-declare const REDACTION_VERSION = "1.0.0";
+export declare const DEFAULT_REDACTION_RULES: RedactionRule[];
+export declare const REDACTION_VERSION = "1.0.0";
 /**
  * Redact a single string. Returns the new string and a per-rule count of
  * how many substitutions fired.
  */
-declare function redactString(input: string, rules?: RedactionRule[]): {
+export declare function redactString(input: string, rules?: RedactionRule[]): {
     output: string;
     report: RedactionReport;
 };
@@ -37,9 +37,8 @@ declare function redactString(input: string, rules?: RedactionRule[]): {
  * Arrays and plain objects are recursed; other types pass through
  * untouched. Circular references throw — traces should be tree-shaped.
  */
-declare function redactValue(value: unknown, rules?: RedactionRule[], report?: RedactionReport): {
+export declare function redactValue(value: unknown, rules?: RedactionRule[], report?: RedactionReport): {
     value: unknown;
     report: RedactionReport;
 };
-
-export { DEFAULT_REDACTION_RULES as D, type RedactionRule as R, type RedactionReport as a, REDACTION_VERSION as b, redactValue as c, redactString as r };
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/trace/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,EAAE,aAAa,EAalD,CAAA;AAED,eAAO,MAAM,iBAAiB,UAAU,CAAA;AAExC;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,aAAa,EAA4B,GAC/C;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAgB7C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,aAAa,EAA4B,EAChD,MAAM,GAAE,eAAmD,GAC1D;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAuB7C"}

package/dist/{schema-m0gsnbt3.d.ts → trace/schema.d.ts}

@@ -9,15 +9,15 @@
  * judge, sandbox) and first-class BudgetLedger / Artifact / JudgeVerdict
  * entities that OTEL leaves as free-form attributes.
  */
-declare const TRACE_SCHEMA_VERSION = "1.0.0";
-type RunStatus = 'running' | 'completed' | 'failed' | 'aborted';
-interface BudgetSpec {
+export declare const TRACE_SCHEMA_VERSION = "1.0.0";
+export type RunStatus = 'running' | 'completed' | 'failed' | 'aborted';
+export interface BudgetSpec {
     tokens?: number;
     wallMs?: number;
     calls?: number;
     usd?: number;
 }
-interface RunOutcome {
+export interface RunOutcome {
     score?: number;
     pass?: boolean;
     failureClass?: FailureClass;
@@ -30,8 +30,8 @@ interface RunOutcome {
  * `app-runtime`: a run of the generated agent against a domain scenario.
  * `meta`: any meta-eval (judge replay, correlation analysis).
  */
-type RunLayer = 'builder' | 'app-build' | 'app-runtime' | 'meta' | 'custom';
-interface Run {
+export type RunLayer = 'builder' | 'app-build' | 'app-runtime' | 'meta' | 'custom';
+export interface Run {
     runId: string;
     /**
      * Stable identifier of the scenario being executed.
@@ -74,9 +74,9 @@ interface Run {
     /** Free-form labels for downstream grouping. */
     tags?: Record<string, string>;
 }
-type SpanKind = 'agent' | 'llm' | 'tool' | 'retrieval' | 'judge' | 'sandbox' | 'custom';
-type SpanStatus = 'ok' | 'error';
-interface SpanBase {
+export type SpanKind = 'agent' | 'llm' | 'tool' | 'retrieval' | 'judge' | 'sandbox' | 'custom';
+export type SpanStatus = 'ok' | 'error';
+export interface SpanBase {
     spanId: string;
     parentSpanId?: string;
     runId: string;
@@ -89,7 +89,7 @@ interface SpanBase {
     /** Anything not covered by typed fields. Kept deliberately free-form. */
     attributes?: Record<string, unknown>;
 }
-interface Message {
+export interface Message {
     role: 'system' | 'user' | 'assistant' | 'tool';
     content: string;
     tokens?: number;
@@ -100,7 +100,7 @@ interface Message {
         mime?: string;
     }>;
 }
-interface LlmSpan extends SpanBase {
+export interface LlmSpan extends SpanBase {
     kind: 'llm';
     model: string;
     messages: Message[];
@@ -112,14 +112,14 @@ interface LlmSpan extends SpanBase {
     costUsd?: number;
     finishReason?: string;
 }
-interface ToolSpan extends SpanBase {
+export interface ToolSpan extends SpanBase {
     kind: 'tool';
     toolName: string;
     args: unknown;
     result?: unknown;
     latencyMs?: number;
 }
-interface RetrievalSpan extends SpanBase {
+export interface RetrievalSpan extends SpanBase {
     kind: 'retrieval';
     query: string;
     hits: Array<{
@@ -128,7 +128,7 @@ interface RetrievalSpan extends SpanBase {
         content?: string;
     }>;
 }
-interface JudgeSpan extends SpanBase {
+export interface JudgeSpan extends SpanBase {
     kind: 'judge';
     judgeId: string;
     /** Span this judgment applies to. */
@@ -139,7 +139,7 @@ interface JudgeSpan extends SpanBase {
     rationale?: string;
     evidence?: string;
 }
-interface SandboxSpan extends SpanBase {
+export interface SandboxSpan extends SpanBase {
     kind: 'sandbox';
     image?: string;
     command?: string;
@@ -151,12 +151,12 @@ interface SandboxSpan extends SpanBase {
     /** Duration in ms; the harness fills this explicitly (endedAt - startedAt may miss setup). */
     wallMs?: number;
 }
-interface GenericSpan extends SpanBase {
+export interface GenericSpan extends SpanBase {
     kind: 'agent' | 'custom';
 }
-type Span = LlmSpan | ToolSpan | RetrievalSpan | JudgeSpan | SandboxSpan | GenericSpan;
-type EventKind = 'log' | 'error' | 'budget_decrement' | 'budget_breach' | 'state_mutation' | 'policy_violation' | 'redaction_applied' | 'custom';
-interface TraceEvent {
+export type Span = LlmSpan | ToolSpan | RetrievalSpan | JudgeSpan | SandboxSpan | GenericSpan;
+export type EventKind = 'log' | 'error' | 'budget_decrement' | 'budget_breach' | 'state_mutation' | 'policy_violation' | 'redaction_applied' | 'custom';
+export interface TraceEvent {
     eventId: string;
     runId: string;
     spanId?: string;
@@ -164,7 +164,7 @@ interface TraceEvent {
     timestamp: number;
     payload: Record<string, unknown>;
 }
-interface BudgetLedgerEntry {
+export interface BudgetLedgerEntry {
     runId: string;
     dimension: keyof BudgetSpec;
     limit: number;
@@ -175,7 +175,7 @@ interface BudgetLedgerEntry {
     /** Span that triggered this entry, if any. */
     spanId?: string;
 }
-interface Artifact {
+export interface Artifact {
     artifactId: string;
     runId: string;
     spanId?: string;
@@ -188,12 +188,11 @@ interface Artifact {
     /** Inline content for small blobs — keep under ~64KB. */
     inlineContent?: string;
 }
-type FailureClass = 'success' | 'reasoning_error' | 'tool_selection_error' | 'tool_argument_error' | 'tool_recovery_failure' | 'hallucination' | 'instruction_following' | 'safety_refusal_miss' | 'policy_violation' | 'budget_exceeded' | 'format_drift' | 'permission_escalation' | 'pii_leak' | 'cost_overrun' | 'timeout' | 'sandbox_failure' | 'missing_user_data' | 'missing_domain_data' | 'missing_codebase_context' | 'missing_runtime_context' | 'missing_credentials' | 'missing_integration_connection' | 'missing_integration_scope' | 'integration_approval_required' | 'integration_auth_expired' | 'integration_provider_failure' | 'bad_integration_manifest' | 'unsafe_integration_write_denied' | 'stale_external_data' | 'bad_retrieval' | 'insufficient_evidence' | 'contradictory_evidence' | 'ambiguous_user_intent' | 'knowledge_readiness_blocked' | 'unknown';
-declare const FAILURE_CLASSES: readonly FailureClass[];
-declare function isLlmSpan(s: Span): s is LlmSpan;
-declare function isToolSpan(s: Span): s is ToolSpan;
-declare function isRetrievalSpan(s: Span): s is RetrievalSpan;
-declare function isJudgeSpan(s: Span): s is JudgeSpan;
-declare function isSandboxSpan(s: Span): s is SandboxSpan;
-
-export { type Artifact as A, type BudgetLedgerEntry as B, type EventKind as E, type FailureClass as F, type GenericSpan as G, type JudgeSpan as J, type LlmSpan as L, type Message as M, type Run as R, type Span as S, type ToolSpan as T, type TraceEvent as a, type RunOutcome as b, type SpanKind as c, type RetrievalSpan as d, type SandboxSpan as e, type RunStatus as f, type RunLayer as g, type BudgetSpec as h, FAILURE_CLASSES as i, type SpanBase as j, type SpanStatus as k, TRACE_SCHEMA_VERSION as l, isJudgeSpan as m, isLlmSpan as n, isRetrievalSpan as o, isSandboxSpan as p, isToolSpan as q };
+export type FailureClass = 'success' | 'reasoning_error' | 'tool_selection_error' | 'tool_argument_error' | 'tool_recovery_failure' | 'hallucination' | 'instruction_following' | 'safety_refusal_miss' | 'policy_violation' | 'budget_exceeded' | 'format_drift' | 'permission_escalation' | 'pii_leak' | 'cost_overrun' | 'timeout' | 'sandbox_failure' | 'missing_user_data' | 'missing_domain_data' | 'missing_codebase_context' | 'missing_runtime_context' | 'missing_credentials' | 'missing_integration_connection' | 'missing_integration_scope' | 'integration_approval_required' | 'integration_auth_expired' | 'integration_provider_failure' | 'bad_integration_manifest' | 'unsafe_integration_write_denied' | 'stale_external_data' | 'bad_retrieval' | 'insufficient_evidence' | 'contradictory_evidence' | 'ambiguous_user_intent' | 'knowledge_readiness_blocked' | 'unknown';
+export declare const FAILURE_CLASSES: readonly FailureClass[];
+export declare function isLlmSpan(s: Span): s is LlmSpan;
+export declare function isToolSpan(s: Span): s is ToolSpan;
+export declare function isRetrievalSpan(s: Span): s is RetrievalSpan;
+export declare function isJudgeSpan(s: Span): s is JudgeSpan;
+export declare function isSandboxSpan(s: Span): s is SandboxSpan;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/trace/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAI3C,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEtE,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAA;AAElF,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;OASG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;+DAC2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAID,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE9F,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,CAAA;AAEvC,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrE;AAED,MAAM,WAAW,OAAQ,SAAQ,QAAQ;IACvC,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChE;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;CACzB;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAA;AAI7F,MAAM,MAAM,SAAS,GACjB,KAAK,GACL,OAAO,GACP,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,CAAA;AAEZ,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAID,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,UAAU,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAID,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,iBAAiB,GACjB,sBAAsB,GACtB,qBAAqB,GACrB,uBAAuB,GACvB,eAAe,GACf,uBAAuB,GACvB,qBAAqB,GACrB,kBAAkB,GAClB,iBAAiB,GACjB,cAAc,GACd,uBAAuB,GACvB,UAAU,GACV,cAAc,GACd,SAAS,GACT,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,0BAA0B,GAC1B,yBAAyB,GACzB,qBAAqB,GACrB,gCAAgC,GAChC,2BAA2B,GAC3B,+BAA+B,GAC/B,0BAA0B,GAC1B,8BAA8B,GAC9B,0BAA0B,GAC1B,iCAAiC,GACjC,qBAAqB,GACrB,eAAe,GACf,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,6BAA6B,GAC7B,SAAS,CAAA;AAEb,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAoCzC,CAAA;AAIV,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,OAAO,CAE/C;AACD,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,QAAQ,CAEjD;AACD,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,aAAa,CAE3D;AACD,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,SAAS,CAEnD;AACD,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,WAAW,CAEvD"}

package/dist/trace/store-to-otlp.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Convert agent-eval's internal trace shape (`FileSystemTraceStore` → `Run`,
+ * `Span`, `TraceEvent`) into the OTLP-flat JSONL the trace analyst
+ * (`analyzeTraces` + `OtlpFileTraceStore`) reads.
+ *
+ * Eval harnesses shard a `FileSystemTraceStore` per cell (persona / variant)
+ * under a run directory. The analyst consumes a single OTLP-NDJSON file keyed
+ * on `trace_id` + `span_id` with `start_time`/`end_time` in ISO-8601 and
+ * resource + `attributes` rolled up per-span. This module walks every shard,
+ * projects each `Span` (plus events pinned to it) into the flat OTLP shape,
+ * and emits one NDJSON file.
+ *
+ * Generic OTLP/OpenInference fields are always emitted (`service.name`,
+ * `agent.name`, `run.id`/`run.status`, `openinference.span.kind`,
+ * `llm.model_name`, …). Domain attributes (`legal.*`, `tax.*`, …) are injected
+ * per-run via {@link TraceStoreToOtlpOptions.resourceAttributes} /
+ * {@link TraceStoreToOtlpOptions.runAttributes} so consumers don't re-roll the
+ * walker.
+ */
+import type { Run } from './schema';
+export interface TracesToOtlpResult {
+    /** Total spans emitted across every cell. */
+    spanCount: number;
+    /** Total run-anchor spans (one per Run) appended for analyst visibility. */
+    runCount: number;
+    /** Cells whose shards parsed cleanly. */
+    cellCount: number;
+    /** Cells that errored mid-conversion — surfaced so a partial conversion
+     *  isn't silently masked. */
+    cellErrorCount: number;
+}
+/**
+ * A trace source the analyst should ingest. Two layouts are supported:
+ *
+ *   - `celled` (default): the root holds one cell subdirectory per
+ *     persona/variant, each a `FileSystemTraceStore` (`runs.ndjson`,
+ *     `spans.ndjson`, `events.ndjson`).
+ *   - `flat`: the root is itself a single `FileSystemTraceStore` (e.g. a
+ *     production-ingestion sidecar that appends one ndjson set directly under
+ *     the chosen directory).
+ */
+export interface TraceStoreSource {
+    /** Absolute path to the trace store root. */
+    root: string;
+    /** Layout — `celled` (default) or `flat`. */
+    layout?: 'celled' | 'flat';
+    /** OTLP `service.name` for this source. Overrides the options default. */
+    serviceName?: string;
+}
+/** Domain hooks. The walker is generic; consumers inject the namespaced
+ *  attributes that ride along on every run + span for analyst discovery. */
+export interface TraceStoreToOtlpOptions {
+    /** Default OTLP `service.name` when a source doesn't set its own.
+     *  Default `agent-eval`. */
+    serviceName?: string;
+    /** Extra resource attributes per run, e.g.
+     *  `(run) => ({ 'legal.persona_id': run.tags?.personaId ?? '' })`. */
+    resourceAttributes?: (run: Run) => Record<string, unknown>;
+    /** Extra attributes on the per-run anchor span, e.g. domain outcome fields. */
+    runAttributes?: (run: Run) => Record<string, unknown>;
+}
+/**
+ * Read every per-cell shard under each source root and write a flat OTLP-JSONL
+ * view of the corpus to `outPath`. Each cell directory is a
+ * `FileSystemTraceStore` — NDJSON append-only with size-based rotation;
+ * `updateRun`/`updateSpan` append `{ id, ...patch, _update: true }` rows
+ * rather than rewriting, so readers must merge those patches in (done here).
+ *
+ * A `string` source is treated as a celled root.
+ */
+export declare function convertTraceStoresToOtlp(source: string | TraceStoreSource | readonly TraceStoreSource[], outPath: string, opts?: TraceStoreToOtlpOptions): TracesToOtlpResult;
+//# sourceMappingURL=store-to-otlp.d.ts.map

package/dist/trace/store-to-otlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-to-otlp.d.ts","sourceRoot":"","sources":["../../src/trace/store-to-otlp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH,OAAO,KAAK,EAAE,GAAG,EAAoB,MAAM,UAAU,CAAA;AAoBrD,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB;iCAC6B;IAC7B,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC1B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;4EAC4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC;gCAC4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;0EACsE;IACtE,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1D,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,gBAAgB,EAAE,EAC/D,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,uBAA4B,GACjC,kBAAkB,CA+CpB"}

package/dist/trace/store-to-otlp.test.d.ts

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

package/dist/trace/store-to-otlp.test.d.ts.map

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

package/dist/{store-CKUAgsJz.d.ts → trace/store.d.ts}

@@ -1,6 +1,16 @@
-import { R as Run, S as Span, a as TraceEvent, A as Artifact, B as BudgetLedgerEntry, f as RunStatus, g as RunLayer, c as SpanKind, E as EventKind } from './schema-m0gsnbt3.js';
-
-interface RunFilter {
+/**
+ * TraceStore — persistence + query over the TraceSchema v1 corpus.
+ *
+ * Two implementations ship in the core:
+ *   - InMemoryTraceStore: dev + tests, fully in-process
+ *   - FileSystemTraceStore: NDJSON append-only files per entity, suitable
+ *     for long-running CI jobs; rolled over at 32MB
+ *
+ * Downstream adapters (DuckDB, Langfuse, R2 parquet) implement this same
+ * interface — the rest of the framework is storage-agnostic.
+ */
+import type { Artifact, BudgetLedgerEntry, EventKind, Run, RunStatus, Span, SpanKind, TraceEvent } from './schema';
+export interface RunFilter {
     scenarioId?: string;
     variantId?: string;
     status?: RunStatus;
@@ -13,9 +23,9 @@ interface RunFilter {
     parentRunId?: string;
     projectId?: string;
     chatId?: string;
-    layer?: RunLayer;
+    layer?: import('./schema').RunLayer;
 }
-interface SpanFilter {
+export interface SpanFilter {
     runId?: string;
     parentSpanId?: string;
     kind?: SpanKind;
@@ -25,14 +35,14 @@ interface SpanFilter {
     since?: number;
     until?: number;
 }
-interface EventFilter {
+export interface EventFilter {
     runId?: string;
     spanId?: string;
     kind?: EventKind;
     since?: number;
     until?: number;
 }
-interface TraceStore {
+export interface TraceStore {
     appendRun(run: Run): Promise<void>;
     updateRun(runId: string, patch: Partial<Run>): Promise<void>;
     appendSpan(span: Span): Promise<void>;
@@ -47,7 +57,7 @@ interface TraceStore {
     budget(runId: string): Promise<BudgetLedgerEntry[]>;
     artifacts(runId: string): Promise<Artifact[]>;
 }
-declare class InMemoryTraceStore implements TraceStore {
+export declare class InMemoryTraceStore implements TraceStore {
     private runs;
     private allSpans;
     private allEvents;
@@ -67,22 +77,37 @@ declare class InMemoryTraceStore implements TraceStore {
     budget(runId: string): Promise<BudgetLedgerEntry[]>;
     artifacts(runId: string): Promise<Artifact[]>;
 }
-interface FileSystemTraceStoreOptions {
+export interface FileSystemTraceStoreOptions {
     dir: string;
     /** Roll over NDJSON files when they exceed this size in bytes. Default 32 MB. */
     maxBytes?: number;
 }
-declare class FileSystemTraceStore implements TraceStore {
+export declare class FileSystemTraceStore implements TraceStore {
     private dir;
     private maxBytes;
     /** Lazy in-memory index for queries — populated on first read. */
     private index?;
-    private loaded;
+    /** Memoized index build — concurrent first reads share one build, and an
+     *  append racing an in-flight load awaits this so its row isn't lost. */
+    private indexPromise?;
+    /** Strictly-increasing rollover stamp. Date.now() alone collides when two
+     *  rollovers land in the same millisecond, overwriting a rolled file. */
+    private lastRolloverStamp;
+    /**
+     * Per-file append serialization. stat → conditional-rename → appendFile is a
+     * read-modify-write on the active file; without a lock two concurrent appends
+     * to the same `name` can both pass the size check (exceeding maxBytes) or one
+     * can append to a file the other just renamed away. Each entry chains the
+     * next append behind the prior one for that file.
+     */
+    private appendLocks;
     constructor(options: FileSystemTraceStoreOptions);
     private ensureDir;
     private append;
+    private appendLocked;
     private insertInto;
     private load;
+    private buildIndex;
     appendRun(run: Run): Promise<void>;
     updateRun(runId: string, patch: Partial<Run>): Promise<void>;
     appendSpan(span: Span): Promise<void>;
@@ -97,5 +122,4 @@ declare class FileSystemTraceStore implements TraceStore {
     budget(runId: string): Promise<BudgetLedgerEntry[]>;
     artifacts(runId: string): Promise<Artifact[]>;
 }
-
-export { type EventFilter as E, FileSystemTraceStore as F, InMemoryTraceStore as I, type RunFilter as R, type SpanFilter as S, type TraceStore as T, type FileSystemTraceStoreOptions as a };
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/trace/store.test.d.ts

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

package/dist/trace/store.test.d.ts.map

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

package/dist/{analyst-C8HHvfJp.d.ts → trace-analyst/analyst.d.ts}

@@ -1,12 +1,11 @@
-import { AxAIService } from '@ax-llm/ax';
-import { T as TraceAnalysisStore } from './store-C1YxJDEK.js';
-
-interface AnalyzeTracesInput {
+import { type AxAIService } from '@ax-llm/ax';
+import type { TraceAnalysisStore } from './store';
+export interface AnalyzeTracesInput {
     /** The user-facing question. Domain framing belongs here, not in the
      *  actor description. */
     question: string;
 }
-interface AnalyzeTracesResult {
+export interface AnalyzeTracesResult {
     /** The responder's prose answer. */
     answer: string;
     /** Bulleted findings extracted from the responder's structured output. */
@@ -22,21 +21,21 @@ interface AnalyzeTracesResult {
     /** Prompt version that produced this run. */
     actorPromptVersion: string;
 }
-interface TraceAnalystUsage {
+export interface TraceAnalystUsage {
     actor: TraceAnalystUsageEntry[];
     responder: TraceAnalystUsageEntry[];
 }
-interface TraceAnalystUsageEntry {
+export interface TraceAnalystUsageEntry {
     [key: string]: unknown;
 }
-interface TraceAnalystChatLog {
+export interface TraceAnalystChatLog {
     actor: TraceAnalystChatMessage[];
     responder: TraceAnalystChatMessage[];
 }
-interface TraceAnalystChatMessage {
+export interface TraceAnalystChatMessage {
     [key: string]: unknown;
 }
-interface AnalyzeTracesTurnSnapshot {
+export interface AnalyzeTracesTurnSnapshot {
     turn: number;
     isError: boolean;
     /** The JS code the actor produced for this turn. */
@@ -47,7 +46,7 @@ interface AnalyzeTracesTurnSnapshot {
      *  provider returns it). */
     thought?: string;
 }
-interface AnalyzeTracesOptions {
+export interface AnalyzeTracesOptions {
     /** Trace data source. Pass either an OTLP-JSONL path or a custom store. */
     source: string | TraceAnalysisStore;
     /** Caller-provided AxAIService. */
@@ -83,6 +82,5 @@ interface AnalyzeTracesOptions {
  *   - `AxAgentClarificationError` if the analyst asks for clarification.
  *   - Provider errors (auth, rate limits) propagate from the AI service.
  */
-declare function analyzeTraces(input: AnalyzeTracesInput, options: AnalyzeTracesOptions): Promise<AnalyzeTracesResult>;
-
-export { type AnalyzeTracesOptions as A, type AnalyzeTracesInput as a, type AnalyzeTracesResult as b, type AnalyzeTracesTurnSnapshot as c, analyzeTraces as d };
+export declare function analyzeTraces(input: AnalyzeTracesInput, options: AnalyzeTracesOptions): Promise<AnalyzeTracesResult>;
+//# sourceMappingURL=analyst.d.ts.map

package/dist/trace-analyst/analyst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst.d.ts","sourceRoot":"","sources":["../../src/trace-analyst/analyst.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAuC,MAAM,YAAY,CAAA;AAMpG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAIjD,MAAM,WAAW,kBAAkB;IACjC;6BACyB;IACzB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,iEAAiE;IACjE,KAAK,EAAE,yBAAyB,EAAE,CAAA;IAClC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,KAAK,EAAE,iBAAiB,CAAA;IACxB,0DAA0D;IAC1D,OAAO,EAAE,mBAAmB,CAAA;IAC5B,6CAA6C;IAC7C,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,sBAAsB,EAAE,CAAA;IAC/B,SAAS,EAAE,sBAAsB,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,uBAAuB,EAAE,CAAA;IAChC,SAAS,EAAE,uBAAuB,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAA;IACd;gCAC4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAAA;IACnC,mCAAmC;IACnC,EAAE,EAAE,WAAW,CAAA;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,mCAAmC;IACnC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;oBAIgB;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwH9B"}

package/dist/trace-analyst/analyst.test.d.ts

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

package/dist/trace-analyst/analyst.test.d.ts.map

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