@tangle-network/agent-eval 0.93.0 → 0.95.0

package/dist/traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../src/traces.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA"}

package/dist/traces.js

@@ -28,7 +28,13 @@ import {
   scoreTraceInsightReadiness,
   tokenizeDomainWords,
   traceAnalystOnRunComplete
-} from "./chunk-QG2OVF2D.js";
+} from "./chunk-77T4STFI.js";
+import {
+  TRACE_ANALYST_ACTOR_DESCRIPTION,
+  TRACE_ANALYST_ACTOR_DESCRIPTION_VERSION,
+  TRACE_ANALYST_SUBAGENT_DESCRIPTION,
+  analyzeTraces
+} from "./chunk-IZCEK2HR.js";
 import {
   DEFAULT_REDACTION_RULES,
   REDACTION_VERSION,
@@ -44,7 +50,7 @@ import {
   runFailureClass,
   runsForScenario,
   toolSpans
-} from "./chunk-47X6LRCE.js";
+} from "./chunk-UFSG7ACU.js";
 import {
   FAILURE_CLASSES,
   TRACE_SCHEMA_VERSION,
@@ -54,16 +60,24 @@ import {
   isSandboxSpan,
   isToolSpan
 } from "./chunk-5BKGXME7.js";
-import {
-  TRACE_ANALYST_ACTOR_DESCRIPTION,
-  TRACE_ANALYST_ACTOR_DESCRIPTION_VERSION,
-  TRACE_ANALYST_SUBAGENT_DESCRIPTION,
-  analyzeTraces
-} from "./chunk-UHMJT4T7.js";
 import {
   DEFAULT_TRACE_ANALYST_BUDGETS,
+  LLM_CACHED_TOKENS,
+  LLM_CACHED_TOKEN_ATTR_KEYS,
+  LLM_COST_ATTR_KEYS,
+  LLM_COST_USD,
+  LLM_INPUT_TOKENS,
+  LLM_INPUT_TOKEN_ATTR_KEYS,
+  LLM_MODEL_ATTR_KEYS,
+  LLM_MODEL_NAME,
+  LLM_OUTPUT_TOKENS,
+  LLM_OUTPUT_TOKEN_ATTR_KEYS,
+  OPENINFERENCE_SPAN_KIND,
   OtlpFileTraceStore,
+  SPAN_KIND_ATTR_KEYS,
   SpanNotFoundError,
+  TOOL_NAME,
+  TOOL_NAME_ATTR_KEYS,
   TRACE_ANALYST_TRUNCATION_MARKER_PREFIX,
   TraceFileMissingError,
   TraceNotFoundError,
@@ -77,8 +91,9 @@ import {
   projectOtlpFlatLine,
   readOtlpStatus,
   stringField,
-  traceAnalystFunctionGroup
-} from "./chunk-QAY5UIJO.js";
+  traceAnalystFunctionGroup,
+  traceSpanKindToOpenInferenceKind
+} from "./chunk-YBIGNSCZ.js";
 import {
   RunIntegrityError,
   assertRunCaptured,
@@ -91,7 +106,7 @@ import {
   defaultProviderRedactor,
   providerFromBaseUrl
 } from "./chunk-PC4UYEBM.js";
-import "./chunk-KWRRMR3J.js";
+import "./chunk-LO6IOIJ2.js";
 import {
   TraceEmitter,
   llmSpanFromProvider
@@ -107,14 +122,28 @@ export {
   FileSystemTraceStore,
   InMemoryRawProviderSink,
   InMemoryTraceStore,
+  LLM_CACHED_TOKENS,
+  LLM_CACHED_TOKEN_ATTR_KEYS,
+  LLM_COST_ATTR_KEYS,
+  LLM_COST_USD,
+  LLM_INPUT_TOKENS,
+  LLM_INPUT_TOKEN_ATTR_KEYS,
+  LLM_MODEL_ATTR_KEYS,
+  LLM_MODEL_NAME,
+  LLM_OUTPUT_TOKENS,
+  LLM_OUTPUT_TOKEN_ATTR_KEYS,
   NoopRawProviderSink,
+  OPENINFERENCE_SPAN_KIND,
   OTEL_AGENT_EVAL_SCOPE,
   OtlpFileTraceStore,
   REDACTION_VERSION,
   ReplayCache,
   ReplayCacheMissError,
   RunIntegrityError,
+  SPAN_KIND_ATTR_KEYS,
   SpanNotFoundError,
+  TOOL_NAME,
+  TOOL_NAME_ATTR_KEYS,
   TRACE_ANALYST_ACTOR_DESCRIPTION,
   TRACE_ANALYST_ACTOR_DESCRIPTION_VERSION,
   TRACE_ANALYST_SUBAGENT_DESCRIPTION,
@@ -178,6 +207,7 @@ export {
   tokenizeDomainWords,
   toolSpans,
   traceAnalystFunctionGroup,
-  traceAnalystOnRunComplete
+  traceAnalystOnRunComplete,
+  traceSpanKindToOpenInferenceKind
 };
 //# sourceMappingURL=traces.js.map

package/dist/{trajectory-GEdXJCL5.d.ts → trajectory.d.ts}

@@ -1,6 +1,3 @@
-import { S as Span, a as TraceEvent } from './schema-m0gsnbt3.js';
-import { T as TraceStore } from './store-CKUAgsJz.js';
-
 /**
  * Trajectory — ordered, structured view over a run's spans.
  *
@@ -10,8 +7,9 @@ import { T as TraceStore } from './store-CKUAgsJz.js';
  * analyzers (stuck-loop detection, waste ratio) live in
  * `pipelines/` and consume the trajectory.
  */
-
-interface TrajectoryStep {
+import type { Span, TraceEvent } from './trace/schema';
+import type { TraceStore } from './trace/store';
+export interface TrajectoryStep {
     index: number;
     span: Span;
     /** Depth in the span tree from the root. 0 = top-level. */
@@ -19,7 +17,7 @@ interface TrajectoryStep {
     /** Events attached to this span. */
     events: TraceEvent[];
 }
-interface Trajectory {
+export interface Trajectory {
     runId: string;
     steps: TrajectoryStep[];
     llmTurns: number;
@@ -28,6 +26,7 @@ interface Trajectory {
     retrievals: number;
     totalDurationMs: number;
 }
-declare function buildTrajectory(store: TraceStore, runId: string): Promise<Trajectory>;
-
-export { type Trajectory as T, type TrajectoryStep as a, buildTrajectory as b };
+export declare function buildTrajectory(store: TraceStore, runId: string): Promise<Trajectory>;
+export type { Span, TraceEvent } from './trace/schema';
+export type { TraceStore } from './trace/store';
+//# sourceMappingURL=trajectory.d.ts.map

package/dist/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../src/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,IAAI,CAAA;IACV,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgD3F;AAGD,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/dist/{types-Croy5h7V.d.ts → types.d.ts}

@@ -1,6 +1,4 @@
-import { TCloud } from '@tangle-network/tcloud';
-
-interface Scenario {
+export interface Scenario {
     id: string;
     persona: string;
     label: string;
@@ -10,37 +8,37 @@ interface Scenario {
     artifactChecks: ArtifactCheck[];
     systemPromptAppend?: string;
 }
-interface Turn {
+export interface Turn {
     user: string;
     expectedBehaviors: string[];
     adversarial?: boolean;
     feedbackType?: 'correction' | 'rejection' | 'vague' | 'contradictory' | 'escalation';
 }
-interface ArtifactCheck {
+export interface ArtifactCheck {
     type: 'vault_file_exists' | 'vault_file_contains' | 'block_extracted' | 'code_valid' | 'generation_produced' | 'tool_created' | string;
     target: string;
     contains?: string;
     minCount?: number;
     description: string;
 }
-interface JudgeConfig {
+export interface JudgeConfig {
     model: string;
     temperature: number;
     rubric: JudgeRubric;
 }
-interface JudgeRubric {
+export interface JudgeRubric {
     name: string;
     description: string;
     dimensions: RubricDimension[];
 }
-interface RubricDimension {
+export interface RubricDimension {
     name: string;
     description: string;
     anchor_low: string;
     anchor_high: string;
     weight: number;
 }
-interface ScenarioResult {
+export interface ScenarioResult {
     scenarioId: string;
     persona: string;
     turns: TurnResult[];
@@ -51,7 +49,7 @@ interface ScenarioResult {
     totalDurationMs: number;
     artifacts: CollectedArtifacts;
 }
-interface TurnResult {
+export interface TurnResult {
     turnIndex: number;
     userMessage: string;
     agentResponse: string;
@@ -63,19 +61,19 @@ interface TurnResult {
     containsCode: boolean;
     containsToolCall: boolean;
 }
-interface ArtifactResult {
+export interface ArtifactResult {
     check: ArtifactCheck;
     passed: boolean;
     detail?: string;
 }
-interface JudgeScore {
+export interface JudgeScore {
     judgeName: string;
     dimension: string;
     score: number;
     reasoning: string;
     evidence?: string;
 }
-interface CollectedArtifacts {
+export interface CollectedArtifacts {
     vaultFiles: {
         path: string;
         content: string;
@@ -90,7 +88,7 @@ interface CollectedArtifacts {
     }[];
     toolCalls: string[];
 }
-interface BenchmarkReport {
+export interface BenchmarkReport {
     timestamp: string;
     generation: number;
     promptVersion: string;
@@ -119,7 +117,7 @@ interface BenchmarkReport {
         }[];
     };
 }
-interface RouteMap {
+export interface RouteMap {
     signup?: string;
     login?: string;
     workspaces?: string;
@@ -132,11 +130,13 @@ interface RouteMap {
     generations?: string;
     [key: string]: string | undefined;
 }
-interface ProductClientConfig {
+export interface ProductClientConfig {
     baseUrl: string;
     routes: RouteMap;
+    /** Per-request timeout in ms before the request is aborted. Default 30s. */
+    timeoutMs?: number;
 }
-interface ScenarioFile {
+export interface ScenarioFile {
     id: string;
     category: string;
     persona: string;
@@ -153,12 +153,12 @@ interface ScenarioFile {
     turns: Turn[];
     artifactChecks: ArtifactCheck[];
 }
-interface CompletionCriterion {
+export interface CompletionCriterion {
     name: string;
     check: (state: DriverState) => boolean;
     progress?: (state: DriverState) => number;
 }
-interface FeedbackPattern {
+export interface FeedbackPattern {
     trigger: string;
     response: string;
 }
@@ -170,8 +170,8 @@ interface FeedbackPattern {
  *   relentless  — senior partner reviewing for a client who will litigate;
  *                 interrogates every claim, accepts nothing undefended.
  */
-type PersonaRigor = 'cooperative' | 'demanding' | 'relentless';
-interface PersonaConfig {
+export type PersonaRigor = 'cooperative' | 'demanding' | 'relentless';
+export interface PersonaConfig {
     id: string;
     role: string;
     goal: string;
@@ -202,7 +202,7 @@ interface PersonaConfig {
      */
     curveballs?: string[];
 }
-interface DriverState {
+export interface DriverState {
     tasks: number;
     events: number;
     proposals: {
@@ -214,7 +214,7 @@ interface DriverState {
     codeBlocks: number;
     generations: number;
 }
-interface TurnMetrics {
+export interface TurnMetrics {
     turn: number;
     timestamp: string;
     tasks: number;
@@ -236,7 +236,7 @@ interface TurnMetrics {
     totalCostUsd: number;
     completionPercent: number;
 }
-interface DriverResult {
+export interface DriverResult {
     personaId: string;
     /** True when the simulated user professionally signed off (driver said DONE). */
     completed: boolean;
@@ -255,7 +255,7 @@ interface DriverResult {
     totalCostUsd: number;
     finalQualityScore: number | null;
 }
-interface BenchmarkRunnerConfig {
+export interface BenchmarkRunnerConfig {
     scenarios: Scenario[];
     judges: JudgeFn[];
     systemPrompt: string;
@@ -265,32 +265,32 @@ interface BenchmarkRunnerConfig {
     generation?: number;
     promptVersion?: string;
 }
-interface JudgeInput {
+export interface JudgeInput {
     scenario: Scenario;
     turns: TurnResult[];
     artifacts: CollectedArtifacts;
 }
-type JudgeFn = (tc: TCloud, input: JudgeInput) => Promise<JudgeScore[]>;
-
-interface TestResult {
+export type JudgeFn = (tc: TCloud, input: JudgeInput) => Promise<JudgeScore[]>;
+import type { TCloud } from '@tangle-network/tcloud';
+export type { TCloud };
+export interface TestResult {
     name: string;
     passed: boolean;
     duration: number;
     detail?: string;
     checks: CheckResult[];
 }
-interface CheckResult {
+export interface CheckResult {
     name: string;
     passed: boolean;
     expected: string;
     actual: string;
 }
-interface EvalResult {
+export interface EvalResult {
     scenario: string;
     status: 'pass' | 'fail' | 'skip';
     duration: number;
     detail?: string;
     artifact?: string;
 }
-
-export type { ArtifactCheck as A, BenchmarkRunnerConfig as B, CheckResult as C, DriverResult as D, EvalResult as E, FeedbackPattern as F, JudgeScore as J, ProductClientConfig as P, RouteMap as R, Scenario as S, TestResult as T, JudgeInput as a, JudgeFn as b, BenchmarkReport as c, PersonaConfig as d, DriverState as e, CollectedArtifacts as f, ScenarioResult as g, TurnMetrics as h, ScenarioFile as i, CompletionCriterion as j, ArtifactResult as k, JudgeConfig as l, JudgeRubric as m, PersonaRigor as n, RubricDimension as o, Turn as p, TurnResult as q };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/ui-finding.d.ts

@@ -0,0 +1,104 @@
+/**
+ * UI audit finding — substrate primitive for "what is wrong with the UI?"
+ *
+ * Used by:
+ *   - `@tangle-network/agent-runtime` (ui-auditor profile + delegate) —
+ *     produced as the canonical output of an audit iteration, persisted to
+ *     disk as GitHub-issue Markdown, surfaced over MCP.
+ *   - Downstream ship gates / dashboards / analyst consumers — load and
+ *     transform findings without depending on the runtime.
+ *
+ * Repo layering: agent-eval is the substrate (no upward deps). Consumers
+ * read this type from here; the reverse is forbidden. See CLAUDE.md
+ * "Repo layering" for the rule. A UI finding makes sense WITHOUT a running
+ * agent loop (you can load a saved finding, ship-gate against a set of
+ * them, render them in a dashboard), which puts it firmly in substrate.
+ *
+ * The shape is intentionally minimal — runtime-shaped state (capture
+ * timestamps, OTel trace IDs, sandbox placement) lives on auxiliary
+ * runtime types in `agent-runtime`, not on the finding itself.
+ */
+/**
+ * Canonical audit lenses. Each lens scopes a finding to a single class of
+ * problem so a single audit pass can iterate them without pile-on findings
+ * under a generic label.
+ *
+ * Naming is fixed for cross-package wire compatibility. Treat additions as
+ * a substrate-level decision — analysts, gates, and writers all branch on
+ * the lens.
+ */
+export type UiLens = 'consistency' | 'hierarchy' | 'layout' | 'ux-flow' | 'duplication' | 'accessibility' | 'responsive' | 'states' | 'content' | 'interaction' | 'performance-perceived' | 'other';
+/** Frozen tuple of lenses for validation + iteration. */
+export declare const UI_LENSES: readonly UiLens[];
+/**
+ * Severity scale — intentionally narrow.
+ *
+ *   - `critical` — blocks a core task or is an accessibility blocker.
+ *   - `high`     — confusing, broken-looking, or noticeable friction.
+ *   - `med`      — visible polish issue, would be caught in code review.
+ *   - `low`      — nitpick worth fixing eventually.
+ */
+export type UiFindingSeverity = 'low' | 'med' | 'high' | 'critical';
+/** Frozen severity tuple, ordered worst → least bad for sort/report. */
+export declare const UI_FINDING_SEVERITIES: readonly UiFindingSeverity[];
+/**
+ * Pointer to a screenshot referenced by the finding. The path is
+ * intentionally a relative string (relative to the audit workspace root)
+ * so findings remain portable across machines and into GitHub issues.
+ */
+export interface UiFindingScreenshot {
+    /** Workspace-relative path to the screenshot file (e.g. `screenshots/home--1280x800--...png`). */
+    path: string;
+    /** Optional viewport the screenshot was taken at, e.g. `1280x800`. */
+    viewport?: string;
+    /** Optional short label that disambiguates multiple captures of the same surface (e.g. `t0`, `step-1`). */
+    label?: string;
+}
+/**
+ * A single UI audit finding — the unit of work a contributor can act on.
+ *
+ * Every field except the documented optionals is required. The shape is
+ * deliberately constraining: a finding without a screenshot, a lens, a
+ * concrete title, and a suggested fix is not actionable, and the auditor
+ * validator hard-fails on those gaps.
+ */
+export interface UiFinding {
+    /**
+     * Stable identifier within a single audit workspace. Monotonically
+     * increasing integer (1, 2, …) assigned by the writer when persisting.
+     * Optional in transit (before persistence) — undefined on freshly minted
+     * findings emitted from a loop iteration.
+     */
+    id?: number;
+    /** Concrete title — names the offending element AND what's wrong. */
+    title: string;
+    /** Lens this finding belongs to. */
+    lens: UiLens;
+    /** Severity. */
+    severity: UiFindingSeverity;
+    /** Logical route the finding was observed on (e.g. `home`, `checkout-step-2`). */
+    route: string;
+    /** Fully qualified URL the finding was observed at. */
+    url?: string;
+    /** Viewport string the offending capture was taken at (e.g. `1280x800`). */
+    viewport?: string;
+    /** CSS selector pinning the offending element, when one can be identified. */
+    selector?: string;
+    /** 1–3 sentences describing what the screenshot shows that is wrong. */
+    observation: string;
+    /** Who is affected and how. Concrete user impact. */
+    impact: string;
+    /** A specific change a contributor could apply without asking back. */
+    suggestedFix: string;
+    /** Optional explicit reproduction steps. Writer synthesizes from route/url/selector when omitted. */
+    reproSteps?: string;
+    /** Free-form tags. */
+    tags?: readonly string[];
+    /** Screenshot references — required to be non-empty for actionable findings. */
+    screenshots: readonly UiFindingScreenshot[];
+    /** Cross-references to similar findings already on file, by id. */
+    similarTo?: readonly number[];
+    /** ISO-8601 creation timestamp set by the writer when persisted. */
+    createdAt?: string;
+}
+//# sourceMappingURL=ui-finding.d.ts.map

package/dist/ui-finding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-finding.d.ts","sourceRoot":"","sources":["../src/ui-finding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,GACd,aAAa,GACb,WAAW,GACX,QAAQ,GACR,SAAS,GACT,aAAa,GACb,eAAe,GACf,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,aAAa,GACb,uBAAuB,GACvB,OAAO,CAAA;AAEX,yDAAyD;AACzD,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAa7B,CAAA;AAEV;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAA;AAEnE,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,EAAE,SAAS,iBAAiB,EAKpD,CAAA;AAEV;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2GAA2G;IAC3G,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB;IAChB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAA;IACpB,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sBAAsB;IACtB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,gFAAgF;IAChF,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC3C,mEAAmE;IACnE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/dist/verdict-cache.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Content-addressed judge-verdict caching.
+ *
+ * LAW: cache JUDGE VERDICTS only — judging the same artifact with the same
+ * judge+rubric is pure. NEVER cache agent rollouts. (A router that cached
+ * identical fanout prompts silently destroyed best-of-N diversity; rollout
+ * caching reintroduces that failure class. Judging has no diversity to
+ * destroy — same artifact + same rubric ⇒ same verdict is the desired
+ * property, not a bug.)
+ *
+ * The cache key is a sha-256 over the canonical JSON of everything that can
+ * change a verdict: the artifact content, the scenario id, the judge name,
+ * the full dimension list (key + description — the description IS the rubric
+ * text shown to the judge), and a caller-supplied `judgeVersion`.
+ * `judgeVersion` is REQUIRED: a judge whose prompt/model/ensemble changes
+ * without a version bump would otherwise silently serve stale verdicts.
+ *
+ * Strict canonicalization (`canonicalJson`) throws on undefined / function /
+ * symbol / non-finite numbers — an artifact that cannot be unambiguously
+ * serialized cannot be content-addressed, and coercing it would let two
+ * different artifacts collide on one key.
+ */
+import type { JudgeConfig, JudgeScore, Scenario } from './campaign/types';
+/**
+ * Stable JSON stringify: object keys sorted recursively, so two semantically
+ * equal values produce byte-identical output regardless of key insertion
+ * order. Throws on undefined / function / symbol / NaN / ±Infinity / bigint /
+ * Map / Set — anything JSON.stringify would coerce or drop silently.
+ *
+ * Distinct from `pre-registration.ts`'s `canonicalize`/`hashJson`, which are
+ * permissive (coercion allowed) and async (web-crypto). Use THIS pair when a
+ * hash collision or silent coercion would corrupt a cache key or attestation.
+ */
+export declare function canonicalJson(value: unknown): string;
+/** Hex sha-256 over `canonicalJson(value)`. The content address used by the
+ *  verdict cache and report attestation. */
+export declare function contentHash(value: unknown): string;
+/** Pluggable verdict store. Sync or async on both legs — `cachedJudge`
+ *  awaits the results either way. */
+export interface VerdictCacheStore {
+    get(key: string): Promise<JudgeScore | undefined> | JudgeScore | undefined;
+    set(key: string, score: JudgeScore): Promise<void> | void;
+}
+/** Process-local Map-backed store. */
+export declare function inMemoryVerdictCache(): VerdictCacheStore;
+/**
+ * JSONL-file-backed store: the full file is loaded into an in-memory index at
+ * construction; every `set` appends one line synchronously (durable before
+ * the verdict is returned). A corrupt or malformed line throws at load with
+ * file:line — a skipped line would silently re-judge (cost) or, worse, mask
+ * a half-written file that needs operator attention.
+ */
+export declare function fileVerdictCache(path: string): VerdictCacheStore;
+export interface VerdictCacheStats {
+    hits: number;
+    misses: number;
+}
+export interface CachedJudgeOptions {
+    /** REQUIRED — part of the cache key. Bump on any change to the judge's
+     *  prompt, model, ensemble, or scoring logic; silent judge upgrades must
+     *  never serve stale verdicts. */
+    judgeVersion: string;
+}
+/** The wrapped judge: same `JudgeConfig` seam, plus hit/miss observability. */
+export type CachedJudge<TArtifact, TScenario extends Scenario = Scenario> = JudgeConfig<TArtifact, TScenario> & {
+    stats(): VerdictCacheStats;
+};
+/**
+ * Wrap a `JudgeConfig` so repeat judgments of the same artifact are served
+ * from the store instead of re-invoking `score()`. The wrapper is generic
+ * over the judge's own type parameters and preserves `appliesTo` — it is a
+ * drop-in replacement anywhere a `JudgeConfig` is accepted.
+ *
+ * A judge that throws is NOT cached: the error propagates and the next
+ * attempt re-judges (caching a failure would pin a transient outage forever).
+ */
+export declare function cachedJudge<TArtifact, TScenario extends Scenario = Scenario>(judge: JudgeConfig<TArtifact, TScenario>, store: VerdictCacheStore, options: CachedJudgeOptions): CachedJudge<TArtifact, TScenario>;
+//# sourceMappingURL=verdict-cache.d.ts.map

package/dist/verdict-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict-cache.d.ts","sourceRoot":"","sources":["../src/verdict-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAgDzE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;4CAC4C;AAC5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD;AAID;qCACqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,UAAU,GAAG,SAAS,CAAA;IAC1E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC1D;AAED,sCAAsC;AACtC,wBAAgB,oBAAoB,IAAI,iBAAiB,CAQxD;AAiCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAkBhE;AAID,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC;;sCAEkC;IAClC,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,CAAC,SAAS,EAAE,SAAS,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CACrF,SAAS,EACT,SAAS,CACV,GAAG;IACF,KAAK,IAAI,iBAAiB,CAAA;CAC3B,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,SAAS,QAAQ,GAAG,QAAQ,EAC1E,KAAK,EAAE,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,EACxC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,kBAAkB,GAC1B,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CA8BnC"}

package/dist/verdict-cache.test.d.ts

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

package/dist/verdict-cache.test.d.ts.map

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

package/dist/{verdict-C9MlYujm.d.ts → verdict.d.ts}

@@ -21,7 +21,7 @@
  * Need structured extras? Extend DefaultVerdict with typed fields — never
  * serialize extras into `notes`.
  */
-interface DefaultVerdict {
+export interface DefaultVerdict {
     /** Whether the output meets the validator's pass criteria. */
     valid: boolean;
     /** Aggregate score in [0, 1]. Drivers use this for winner selection. */
@@ -31,5 +31,4 @@ interface DefaultVerdict {
     /** Human-readable rationale; surfaces in trace + final-result `winner.verdict`. */
     notes?: string;
 }
-
-export type { DefaultVerdict as D };
+//# sourceMappingURL=verdict.d.ts.map

package/dist/verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../src/verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAA;IACd,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/visual-diff.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Visual diff — pixel-delta scoring for UI / visual outputs.
+ *
+ * Minimal dependency-free implementation: accepts two PNGs as byte
+ * arrays + width/height and returns a Δ ratio + per-channel histogram.
+ * Consumers supply the decoded pixel arrays (we don't pull a PNG
+ * decoder into the core — use `sharp`, `@napi-rs/canvas`, or Playwright
+ * in the driving test and pass the result here).
+ */
+export interface ImageData {
+    width: number;
+    height: number;
+    /** Pixel data in RGBA order, 4 bytes per pixel. */
+    data: Uint8Array | Uint8ClampedArray;
+}
+export interface VisualDiffResult {
+    /** Ratio of pixels differing beyond `tolerance` (0..1). */
+    diffRatio: number;
+    differingPixels: number;
+    totalPixels: number;
+    maxChannelDelta: number;
+    /** Status for dashboards: unchanged (< 0.1%), changed, or severely-changed (> 5%). */
+    status: 'unchanged' | 'changed' | 'severely-changed';
+}
+export interface VisualDiffOptions {
+    /** Pixels whose max-channel delta is ≤ this are considered unchanged. Default 8/255. */
+    tolerance?: number;
+}
+export declare function visualDiff(a: ImageData, b: ImageData, options?: VisualDiffOptions): VisualDiffResult;
+/** Convenience: diffs two byte-identical-dim RGBA arrays, returns just the ratio. */
+export declare function pixelDeltaRatio(a: Uint8Array, b: Uint8Array, width: number, height: number, tolerance?: number): number;
+//# sourceMappingURL=visual-diff.d.ts.map

package/dist/visual-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-diff.d.ts","sourceRoot":"","sources":["../src/visual-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAA;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,sFAAsF;IACtF,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,kBAAkB,CAAA;CACrD;AAED,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,CACxB,CAAC,EAAE,SAAS,EACZ,CAAC,EAAE,SAAS,EACZ,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAyBlB;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAC7B,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,SAAI,GACZ,MAAM,CAER"}