@tangle-network/agent-eval 0.95.0 → 0.96.0

package/dist/contract/self-improve.d.ts

@@ -1,284 +0,0 @@
-/**
- * # `selfImprove()` - the one-call improvement loop.
- *
- * The cheapest possible call site to run a real closed-loop self-
- * improvement over your agent. Wraps `runImprovementLoop` with smart
- * defaults and a budget-shaped options API; every escape hatch the
- * substrate exposes is reachable from here without losing the
- * one-function feel.
- *
- * Defaults:
- *   - In-memory storage (no filesystem touch).
- *   - `gepaProposer` reflective mutation with copywriting-flavored primitives
- *     (override `proposer` or `mutationPrimitives` for any domain).
- *   - `defaultProductionGate` with `deltaThreshold: 0.05`.
- *   - Held-out split = 25% of scenarios, deterministic by id hash.
- *   - 3 generations × population 2 (raise via `budget` for more search).
- *   - `autoOnPromote: 'none'` (we don't open PRs unless you ask).
- *
- * Want one-click? Provide `agent` + `scenarios` + `judge`. Done.
- * Want distributed? Pass `cellPlacement` + an `httpDispatch`-backed
- * agent. Want a code-tier surface? Pass a `MutableSurface` + your own
- * `proposer`. Same function.
- */
-import { type RunImprovementLoopResult } from '../campaign/presets/run-improvement-loop';
-import type { RunOptimizationOptions } from '../campaign/presets/run-optimization';
-import { type LoopProvenanceRecord } from '../campaign/provenance';
-import { type CampaignStorage } from '../campaign/storage';
-import type { DispatchContext, Gate, JudgeConfig, LabeledScenarioStore, MutableSurface, Scenario, SurfaceProposer } from '../campaign/types';
-import { type HostedTenant } from '../hosted/client';
-import type { RunRecord } from '../run-record';
-import type { InsightReport } from './insight-report';
-export interface SelfImproveBudget {
-    /** Hard $ ceiling across all cells in baseline + every generation. Cells
-     *  beyond the ceiling are skipped (cost-aware, not aborted). */
-    dollars?: number;
-    /** How many improvement generations to explore. Default 3. Set 0 to
-     *  skip improvement entirely (selfImprove becomes a baseline-only run). */
-    generations?: number;
-    /** Candidates the proposer emits per generation. Default 2. */
-    populationSize?: number;
-    /** Max concurrent cells across the loop. Default 2. */
-    maxConcurrency?: number;
-    /** Fraction of `scenarios` held out from training, used for the gate.
-     *  Default 0.25. Ignored when `holdoutScenarios` is set explicitly. */
-    holdoutFraction?: number;
-    /** Explicit held-out scenarios; overrides `holdoutFraction`. */
-    holdoutScenarios?: Scenario[];
-    /** Per-scenario replicates per cell — raises bootstrap-CI tightness. Default 1. */
-    reps?: number;
-    /** Top-scoring candidates carried into the next generation. Default 2. */
-    promoteTopK?: number;
-}
-export interface SelfImproveLlm {
-    /** Endpoint base URL. Default Tangle Router. */
-    baseUrl?: string;
-    /** Bearer token. Default `process.env.OPENAI_API_KEY`. */
-    apiKey?: string;
-    /** Model id used by `gepaProposer` reflection. Default
-     *  `anthropic/claude-sonnet-4.6`. */
-    model?: string;
-}
-export type SelfImproveProgressEvent = {
-    kind: 'baseline.started';
-    scenarios: number;
-} | {
-    kind: 'baseline.completed';
-    compositeMean: number;
-    durationMs: number;
-} | {
-    kind: 'generation.started';
-    index: number;
-    populationSize: number;
-} | {
-    kind: 'generation.completed';
-    index: number;
-    bestComposite: number;
-    durationMs: number;
-} | {
-    kind: 'gate.decided';
-    decision: string;
-    lift: number;
-};
-export interface SelfImproveOptions<TScenario extends Scenario, TArtifact> {
-    /**
-     * Your agent — a function that takes the current `MutableSurface`
-     * (typically a system prompt the loop is optimizing) plus the
-     * scenario + cell ctx, and returns the artifact your judge scores.
-     *
-     * Same shape as `RunOptimizationOptions.dispatchWithSurface`. Wrap a
-     * plain `Dispatch` if you don't have a surface seam:
-     *
-     *   agent: (_surface, scenario, ctx) => yourPlainDispatch(scenario, ctx)
-     *
-     * That mode evaluates without mutating any surface — useful as a
-     * baseline-only run (set `budget.generations = 0`).
-     */
-    agent: (surface: MutableSurface, scenario: TScenario, ctx: DispatchContext) => Promise<TArtifact>;
-    /** Scenarios to evaluate against. Train/holdout split is computed from
-     *  these unless `budget.holdoutScenarios` is set explicitly. */
-    scenarios: TScenario[];
-    /** Judge that scores artifacts. Bring your own; use `langchainJudge`
-     *  from `/adapters/langchain` for a Runnable-shaped one. */
-    judge: JudgeConfig<TArtifact, TScenario>;
-    /** Starting surface — system prompt, JSON config, anything `MutableSurface`
-     *  accepts. The proposer mutates this each generation. */
-    baselineSurface: MutableSurface;
-    /** Budget + loop shape. All fields optional. */
-    budget?: SelfImproveBudget;
-    /** Custom surface proposer. Default is `gepaProposer` configured from `llm` +
-     *  `mutationPrimitives`. */
-    proposer?: SurfaceProposer;
-    /** Default-proposer overrides — used when `proposer` is unset. */
-    mutationPrimitives?: string[];
-    proposerTarget?: string;
-    /** Custom gate. Default is `defaultProductionGate` with
-     *  `deltaThreshold: 0.05` on the held-out split. */
-    gate?: Gate<TArtifact, TScenario>;
-    /** LLM config consumed by the default `gepaProposer`. Ignored if you pass
-     *  your own `proposer`. */
-    llm?: SelfImproveLlm;
-    /** Storage backend. Default is DURABLE: when a real (non-`mem://`) `runDir`
-     *  is available, the substrate defaults to `fsCampaignStorage()` so the
-     *  provenance record + OTel spans survive the call. Pass
-     *  `inMemoryCampaignStorage()` explicitly to opt OUT (tests, edge runtimes).
-     *  Default when `runDir` is `mem://...` (or unset): in-memory. */
-    storage?: CampaignStorage;
-    /** Run directory (logical for in-memory storage, real path for fs).
-     *  Default `mem://selfImprove-<timestamp>` (in-memory, non-durable). Pass a
-     *  real path to persist the provenance record + spans. */
-    runDir?: string;
-    /**
-     * Worker call records for backend provenance. The agent is opaque to the
-     * substrate (it returns an artifact, not token usage), so to capture an
-     * `assertRealBackend`-grade verdict + worker call count + model in the
-     * provenance record, the agent reports its per-call `RunRecord`s here.
-     * Called once after the loop; return the records the agent accumulated.
-     * When unset, backend provenance is derived from campaign cells (cost only;
-     * verdict will read `stub` without token usage — the honest signal that no
-     * token channel was wired).
-     */
-    collectWorkerRecords?: () => RunRecord[];
-    /** Fires once the durable provenance record + OTel spans are emitted.
-     *  Receives the structured record for inline assertions / custom routing. */
-    onProvenance?: (record: LoopProvenanceRecord) => void;
-    /** Distributed execution seam — same as `RunCampaignOptions.cellPlacement`.
-     *  Returns an opaque placement key the substrate forwards to your agent
-     *  as `ctx.placement`. Combined with `httpDispatch` from
-     *  `/adapters/http`, fans cells across regions. */
-    cellPlacement?: (input: {
-        scenario: TScenario;
-        rep: number;
-        generation?: number;
-    }) => string | undefined;
-    /** Streaming hook — fires on baseline + each generation + gate decision.
-     *  Consumer routes events wherever (UI, dashboard, logs). */
-    onProgress?: (event: SelfImproveProgressEvent) => void;
-    /** Auto-promotion behavior on a ship decision. Default `'none'` — we
-     *  return the winner; you ship it however you ship. `'pr'` opens a
-     *  GitHub PR via `openAutoPr`; requires `ghOwner` + `ghRepo`. */
-    autoOnPromote?: 'pr' | 'none';
-    ghOwner?: string;
-    ghRepo?: string;
-    /**
-     * Opt-in: ship eval-run events to a hosted orchestrator (ours, your
-     * self-hosted one, or any compatible implementation of the
-     * `docs/hosted-ingest-spec.md` wire format). When set, the substrate
-     * POSTs the final `EvalRunEvent` to `${endpoint}/v1/ingest/eval-runs`
-     * after the loop completes. Failures are logged but do not fail the
-     * loop — local result is always returned.
-     *
-     * For our orchestrator: `{ endpoint: 'https://orchestrator.tangle.tools/v1', apiKey, tenantId }`.
-     *
-     * For your self-hosted: any URL serving the wire format. See
-     * `examples/hosted-ingest-server/` for the reference receiver.
-     */
-    hostedTenant?: HostedTenant;
-    /** Free-form labels attached to the hosted event (env, branch, model id,
-     *  etc.). Ignored when `hostedTenant` is unset. */
-    hostedLabels?: Record<string, string>;
-    /** Capture every artifact + judge score to this store (labeled-example
-     *  corpus the proposer may read for few-shot, and the dataset you ship). Pass
-     *  `'off'` to disable. Default: off. */
-    labeledStore?: LabeledScenarioStore | 'off';
-    /** Capture-source tag for `labeledStore`. Default `'eval-run'`. */
-    captureSource?: 'production-trace' | 'eval-run' | 'manual' | 'red-team' | 'synthetic';
-    /**
-     * Per-cell backend-integrity expectation — the fail-loud guard. A cell that
-     * produced an artifact but reported `costUsd === 0` AND zero tokens is a
-     * stub. Modes: `'assert'` throws on the first such cell, `'warn'` logs it,
-     * `'off'` skips the check (offline/replay). Default `'assert'` — `selfImprove`
-     * is the real-run path, so a stub fails loud rather than scoring a clean 0.
-     */
-    expectUsage?: 'assert' | 'warn' | 'off';
-    /**
-     * Per-generation findings producer. After each
-     * generation is scored, this is called; whatever it returns REPLACES the
-     * proposer's `findings` for the next generation's `propose()`. Plug a
-     * trace-analyst registry / HALO here. When absent, findings stay
-     * `opts.findings`.
-     */
-    analyzeGeneration?: RunOptimizationOptions<TScenario, TArtifact>['analyzeGeneration'];
-    /** Static findings forwarded to the proposer's `propose()` as `ctx.findings`
-     *  (a findings-grounded proposer consumes them). Default: none. */
-    findings?: unknown[];
-}
-export interface SelfImproveResult<TScenario extends Scenario, TArtifact> {
-    /** Composite mean across all scenarios, baseline run. */
-    baseline: {
-        compositeMean: number;
-        perScenario: Record<string, number>;
-    };
-    /** Composite mean on the held-out set, winner run. */
-    winner: {
-        compositeMean: number;
-        perScenario: Record<string, number>;
-        surface: MutableSurface;
-        /** Proposer label for the promoted change. Absent ⇒ winner == baseline or
-         *  a bare-surface mutator. */
-        label?: string;
-        /** Proposer rationale — the "because Z" that motivated the promoted change.
-         *  Threaded from the proposer's `ProposedCandidate` through the loop.
-         *  Absent ⇒ winner == baseline. */
-        rationale?: string;
-    };
-    /** `winner.compositeMean - baselineOnHoldout.compositeMean`. Positive
-     *  means the gate observed improvement. */
-    lift: number;
-    /** The explicit baseline→winner unified diff. Always present (empty string
-     *  when winner == baseline). */
-    diff: string;
-    /** Durable, queryable provenance record: candidate→cell→gate→promote chain +
-     *  rationale + diff + backend provenance. The artifact the hosted ingest
-     *  path stores; the +lift RECOMPUTES from `record.heldOutLift`. */
-    provenance: LoopProvenanceRecord;
-    /** `defaultProductionGate.decide()` result. */
-    gateDecision: 'ship' | 'hold' | 'need_more_work' | 'model_ceiling' | 'arch_ceiling';
-    /** Number of generations actually explored (may be less than the
-     *  budget if the proposer gave up early). */
-    generationsExplored: number;
-    /** Wall-clock total. */
-    durationMs: number;
-    /** Total cost across baseline + every generation. */
-    totalCostUsd: number;
-    /**
-     * Rigor packet: distributional summary, paired-bootstrap lift CI,
-     * judge stats, contamination check, recommendations. Wired through
-     * `analyzeRuns()` on the baseline + winner cells of the campaign.
-     * Hosted-tier dashboards render this as the v3-vs-v4 decision view.
-     */
-    insight: InsightReport;
-    /**
-     * Raw substrate result for advanced inspection — full per-generation
-     * candidates, full campaign artifacts, all judge scores. Useful for
-     * debugging or reporting beyond the summary.
-     */
-    raw: RunImprovementLoopResult<TArtifact, TScenario>;
-}
-/**
- * One-shot self-improvement loop. See module docstring for defaults +
- * extension points.
- *
- * @example Minimum:
- *
- *   const result = await selfImprove({
- *     agent: (surface, scenario, ctx) => myAgent(surface, scenario, ctx.signal),
- *     scenarios,
- *     judge,
- *     baselineSurface: DEFAULT_PROMPT,
- *   })
- *   console.log(`lift: ${result.lift.toFixed(3)} (${result.gateDecision})`)
- *
- * @example Distributed (workers in three regions):
- *
- *   await selfImprove({
- *     agent: httpDispatch({ resolveUrl: ({ placement }) => REGION_URLS[placement!] }),
- *     scenarios,
- *     judge,
- *     baselineSurface: DEFAULT_PROMPT,
- *     cellPlacement: ({ scenario }) => scenario.region,
- *     budget: { maxConcurrency: 12 },
- *   })
- */
-export declare function selfImprove<TScenario extends Scenario, TArtifact>(opts: SelfImproveOptions<TScenario, TArtifact>): Promise<SelfImproveResult<TScenario, TArtifact>>;
-//# sourceMappingURL=self-improve.d.ts.map

package/dist/contract/self-improve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"self-improve.d.ts","sourceRoot":"","sources":["../../src/contract/self-improve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,0CAA0C,CAAA;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAA;AAElF,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAEV,eAAe,EACf,IAAI,EACJ,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAExE,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,eAAe,CAAA;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAChC;oEACgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;+EAC2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;2EACuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAA;IAC7B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;yCACqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5D,MAAM,WAAW,kBAAkB,CAAC,SAAS,SAAS,QAAQ,EAAE,SAAS;IACvE;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IAEjG;oEACgE;IAChE,SAAS,EAAE,SAAS,EAAE,CAAA;IAEtB;gEAC4D;IAC5D,KAAK,EAAE,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAExC;8DAC0D;IAC1D,eAAe,EAAE,cAAc,CAAA;IAE/B,gDAAgD;IAChD,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAE1B;gCAC4B;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAA;IAE1B,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;wDACoD;IACpD,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAEjC;+BAC2B;IAC3B,GAAG,CAAC,EAAE,cAAc,CAAA;IAEpB;;;;sEAIkE;IAClE,OAAO,CAAC,EAAE,eAAe,CAAA;IAEzB;;8DAE0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;OASG;IACH,oBAAoB,CAAC,EAAE,MAAM,SAAS,EAAE,CAAA;IAExC;iFAC6E;IAC7E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAErD;;;uDAGmD;IACnD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,QAAQ,EAAE,SAAS,CAAA;QACnB,GAAG,EAAE,MAAM,CAAA;QACX,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,KAAK,MAAM,GAAG,SAAS,CAAA;IAExB;iEAC6D;IAC7D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAA;IAEtD;;qEAEiE;IACjE,aAAa,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAE3B;uDACmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAErC;;4CAEwC;IACxC,YAAY,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAA;IAE3C,mEAAmE;IACnE,aAAa,CAAC,EAAE,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAA;IAErF;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAA;IAEvC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAA;IAErF;uEACmE;IACnE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,iBAAiB,CAAC,SAAS,SAAS,QAAQ,EAAE,SAAS;IACtE,yDAAyD;IACzD,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACpC,CAAA;IACD,sDAAsD;IACtD,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACnC,OAAO,EAAE,cAAc,CAAA;QACvB;sCAC8B;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd;;2CAEmC;QACnC,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;IACD;+CAC2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ;;uEAEmE;IACnE,UAAU,EAAE,oBAAoB,CAAA;IAChC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,eAAe,GAAG,cAAc,CAAA;IACnF;iDAC6C;IAC7C,mBAAmB,EAAE,MAAM,CAAA;IAC3B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,OAAO,EAAE,aAAa,CAAA;IACtB;;;;OAIG;IACH,GAAG,EAAE,wBAAwB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;CACpD;AAkDD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAAC,SAAS,SAAS,QAAQ,EAAE,SAAS,EACrE,IAAI,EAAE,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,GAC7C,OAAO,CAAC,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CA6LlD"}

package/dist/control-runtime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"control-runtime.d.ts","sourceRoot":"","sources":["../src/control-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAmB,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;AACvE,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,MAAM,CAAA;AAE1D,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAA;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB,CAAC,MAAM,EAAE,OAAO;IAClD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5C,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAA;CAChD;AAED,MAAM,WAAW,cAAc,CAC7B,MAAM,EACN,OAAO,EACP,aAAa,EACb,KAAK,SAAS,iBAAiB,GAAG,iBAAiB;IAEnD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,EAAE,CAAA;IACd,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,CAAA;IAC7D,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,MAAM,MAAM,eAAe,CAAC,OAAO,IAC/B;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GACD;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAEL,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED,MAAM,WAAW,oBAAoB,CAAC,aAAa;IACjD,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,CAAA;IACtF,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW,CAC1B,MAAM,EACN,OAAO,EACP,aAAa,EACb,KAAK,SAAS,iBAAiB,GAAG,iBAAiB;IAEnD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,KAAK,EAAE,CAAA;IACpB,UAAU,EAAE,KAAK,EAAE,CAAA;IACnB,aAAa,CAAC,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAA;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB,CAC/B,MAAM,EACN,OAAO,EACP,aAAa,EACb,KAAK,SAAS,iBAAiB,GAAG,iBAAiB;IAEnD,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,CAAA;IAC3D,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,UAAU,EAAE,KAAK,EAAE,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,aAAa,EAAE,mBAAmB,EAAE,CAAA;IACpC,SAAS,EAAE,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,eAAe,CAAA;CAC3E;AAED,MAAM,WAAW,oBAAoB,CACnC,MAAM,EACN,OAAO,EACP,aAAa,EACb,KAAK,SAAS,iBAAiB,GAAG,iBAAiB;IAEnD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,iGAAiG;IACjG,aAAa,CAAC,EAAE,wBAAwB,CAAA;IACxC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE;QACvB,MAAM,EAAE,OAAO,CAAA;QACf,MAAM,EAAE,aAAa,CAAA;QACrB,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,KAAK,EAAE,CAAA;QACd,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,CAAA;KAC9D,KAAK,MAAM,GAAG,SAAS,CAAA;IAExB,2FAA2F;IAC3F,OAAO,EAAE,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,CAAA;QAC7D,WAAW,EAAE,WAAW,CAAA;KACzB,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;IAE9B,gGAAgG;IAChG,QAAQ,EAAE,CAAC,GAAG,EAAE;QACd,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,CAAA;QAC7D,WAAW,EAAE,WAAW,CAAA;KACzB,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,CAAA;IAEhC,uGAAuG;IACvG,MAAM,EAAE,CACN,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,KACvD,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IAEjE,iDAAiD;IACjD,GAAG,EAAE,CACH,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,KACvD,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAA;IAE3C,yEAAyE;IACzE,UAAU,CAAC,EAAE,CACX,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,KACvD,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAA;IAEzC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAE3F,kFAAkF;IAClF,YAAY,CAAC,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEnD,yEAAyE;IACzE,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAOD,wBAAsB,mBAAmB,CACvC,MAAM,EACN,OAAO,EACP,aAAa,EACb,KAAK,SAAS,iBAAiB,GAAG,iBAAiB,EAEnD,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,GAClE,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAgmBlE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAC9C,kBAAkB,EAAE,MAAM,EAC1B,OAAO,GAAE,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,CAAM,GAC7E,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAClD,kBAAkB,EAAE,MAAM,EAC1B,OAAO,GAAE,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,CAAM,GAC7E,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG,iBAAiB,CAE5F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG,iBAAiB,CAE7F;AAoDD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAIrE"}

package/dist/control-runtime.test.d.ts

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

package/dist/control-runtime.test.d.ts.map

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

package/dist/control.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtD,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAA;AACxE,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAA"}

package/dist/convergence.d.ts

@@ -1,29 +0,0 @@
-import type { CompletionCriterion, DriverState } from './types';
-/**
- * ConvergenceTracker — tracks completion percentage over turns.
- *
- * Produces convergence curves showing how quickly the agent reaches
- * completion criteria.
- */
-export declare class ConvergenceTracker {
-    private criteria;
-    private history;
-    constructor(criteria: CompletionCriterion[]);
-    /** Evaluate criteria against current state, record result */
-    record(turn: number, state: DriverState): {
-        completionPercent: number;
-        complete: boolean;
-        criteriaStatus: Record<string, boolean | number>;
-    };
-    /** Get convergence curve */
-    getCurve(): number[];
-    /** Get full history with per-criterion status */
-    getHistory(): {
-        turn: number;
-        completionPercent: number;
-        criteriaStatus: Record<string, boolean | number>;
-    }[];
-    /** Find the turn where completion first reached 100% (or null) */
-    getTurnToCompletion(): number | null;
-}
-//# sourceMappingURL=convergence.d.ts.map

package/dist/convergence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"convergence.d.ts","sourceRoot":"","sources":["../src/convergence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE/D;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,OAAO,CAIP;gBAEI,QAAQ,EAAE,mBAAmB,EAAE;IAI3C,6DAA6D;IAC7D,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GACjB;QACD,iBAAiB,EAAE,MAAM,CAAA;QACzB,QAAQ,EAAE,OAAO,CAAA;QACjB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAA;KACjD;IA4BD,4BAA4B;IAC5B,QAAQ,IAAI,MAAM,EAAE;IAIpB,iDAAiD;IACjD,UAAU;cAnDF,MAAM;2BACO,MAAM;wBACT,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;;IAqDlD,kEAAkE;IAClE,mBAAmB,IAAI,MAAM,GAAG,IAAI;CAIrC"}

package/dist/cost-ledger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cost-ledger.d.ts","sourceRoot":"","sources":["../src/cost-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH;gEACgE;AAChE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE/F,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAQxE;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;IACpB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B;2DACuD;IACvD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,cAAc,CAAI;IAE1B;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,WAAW,CAAA;QACpB,KAAK,EAAE,SAAS,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GAAG,eAAe;IAqBnB,+EAA+E;IAC/E,aAAa,CAAC,KAAK,SAAI,GAAG,IAAI;IAS9B,IAAI,IAAI,eAAe,EAAE;IAIzB,OAAO,IAAI,iBAAiB;IA0C5B,2EAA2E;IAC3E,oBAAoB,IAAI,MAAM,GAAG,IAAI;CAItC"}

package/dist/cost-ledger.test.d.ts

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

package/dist/cost-ledger.test.d.ts.map

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

package/dist/cost-report.d.ts

@@ -1,43 +0,0 @@
-/**
- * Program cost report — a thin projection over `CostLedger.summary()` that
- * adds the per-model rollup the summary lacks, plus `attachCostToReport`, the
- * one way every artifact (capsules, campaign results, diagnose reports) gets
- * its cost stamp.
- *
- * Honesty contract carried through from the ledger: `total.unknownEntries`
- * and `perModel[].unpriced` surface the costUnknown axis — a $0 from an
- * unpriced model is a lower bound, never a measured zero.
- */
-import type { ChannelRollup, CostLedger } from './cost-ledger';
-export interface ModelCostRollup {
-    model: string;
-    usd: number;
-    entries: number;
-    /** ≥1 entry for this model was costUnknown — `usd` is a lower bound. An
-     *  `actualCostUsd` override clears the flag for that entry (the dollars are
-     *  observed, even when the model has no pricing). */
-    unpriced: boolean;
-}
-export interface CostReport {
-    /** Per-channel breakdown — `CostLedgerSummary.byChannel` verbatim. */
-    perChannel: ChannelRollup[];
-    total: {
-        usd: number;
-        /** Entries whose cost was unknown — non-zero means `usd` is a lower bound. */
-        unknownEntries: number;
-    };
-    /** Per-model spend, sorted by model id. */
-    perModel: ModelCostRollup[];
-}
-/** Project a ledger into the program cost report. Pure — no I/O, no clock. */
-export declare function costReport(ledger: CostLedger): CostReport;
-/**
- * Stamp a report-shaped object with its cost projection under the `cost` key.
- * Generic so capsules, campaign results, and diagnose reports all stamp the
- * same way. Throws when the report already carries a `cost` key — silently
- * overwriting an existing stamp would corrupt the artifact's provenance.
- */
-export declare function attachCostToReport<R extends object>(report: R, ledger: CostLedger): R & {
-    cost: CostReport;
-};
-//# sourceMappingURL=cost-report.d.ts.map

package/dist/cost-report.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cost-report.d.ts","sourceRoot":"","sources":["../src/cost-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG9D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf;;yDAEqD;IACrD,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,UAAU,EAAE,aAAa,EAAE,CAAA;IAC3B,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAA;QACX,8EAA8E;QAC9E,cAAc,EAAE,MAAM,CAAA;KACvB,CAAA;IACD,2CAA2C;IAC3C,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAuBzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,UAAU,GACjB,CAAC,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAO1B"}

package/dist/cost-report.test.d.ts

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

package/dist/cost-report.test.d.ts.map

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

package/dist/cost-tracker.d.ts

@@ -1,76 +0,0 @@
-/**
- * Cost tracker — token + USD accounting per scenario and per run.
- *
- * Adapted from generic usage-event accounting. Every
- * optimizer needs to know "is the quality gain worth the cost delta?",
- * and every dashboard needs dollars-per-completed-task. MODEL_PRICING
- * from metrics.ts stays authoritative for estimate math; this module
- * adds the aggregation + per-scenario roll-up that was duplicated
- * across 4 verticals.
- */
-export interface TokenSpec {
-    inputTokens: number;
-    outputTokens: number;
-    cachedTokens?: number;
-    reasoningTokens?: number;
-}
-export interface CostEntry extends TokenSpec {
-    scenarioId: string;
-    model: string;
-    /** Override estimate with an observed cost (e.g. from provider response). */
-    actualCostUsd?: number;
-    timestamp: number;
-    /** Free-form tags (variant id, round #, etc.). */
-    tags?: Record<string, string>;
-}
-export interface ScenarioCost {
-    scenarioId: string;
-    entries: CostEntry[];
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    totalCachedTokens: number;
-    totalCostUsd: number;
-    /** Pass flag — set by consumer via markOutcome; used for cost-per-completed-task. */
-    completed?: boolean;
-}
-export declare class CostTracker {
-    private byScenario;
-    record(entry: Omit<CostEntry, 'timestamp'> & {
-        timestamp?: number;
-    }): CostEntry;
-    markOutcome(scenarioId: string, completed: boolean): void;
-    /**
-     * Convenience: record + markOutcome in one call from a
-     * `{ usage, verdict }`-shaped response (starter-foundry's
-     * `invokeMetaJudge` returns this shape; consumers that wrap any
-     * judge/critic can follow the same convention).
-     *
-     * `usage.model` must be present in `MODEL_PRICING` for cost math to
-     * populate; otherwise totalCostUsd stays at 0 for the entry but
-     * tokens still aggregate.
-     */
-    recordVerdict(verdict: {
-        usage?: {
-            inputTokens: number;
-            outputTokens: number;
-            model: string;
-            cachedTokens?: number;
-            reasoningTokens?: number;
-        };
-        verdict?: 'pass' | 'fail' | 'borderline' | string;
-    }, scenarioId: string, tags?: Record<string, string>): CostEntry | null;
-    get(scenarioId: string): ScenarioCost | undefined;
-    list(): ScenarioCost[];
-    summary(): CostSummary;
-}
-export interface CostSummary {
-    scenarioCount: number;
-    completedCount: number;
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    totalCostUsd: number;
-    avgCostPerScenarioUsd: number;
-    /** Total USD / completed scenarios — null when nothing completed. */
-    costPerCompletedTaskUsd: number | null;
-}
-//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/cost-tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../src/cost-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAkC;IAEpD,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAwB/E,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAMzD;;;;;;;;;OASG;IACH,aAAa,CACX,OAAO,EAAE;QACP,KAAK,CAAC,EAAE;YACN,WAAW,EAAE,MAAM,CAAA;YACnB,YAAY,EAAE,MAAM,CAAA;YACpB,KAAK,EAAE,MAAM,CAAA;YACb,YAAY,CAAC,EAAE,MAAM,CAAA;YACrB,eAAe,CAAC,EAAE,MAAM,CAAA;SACzB,CAAA;QACD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAA;KAClD,EACD,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,SAAS,GAAG,IAAI;IAenB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD,IAAI,IAAI,YAAY,EAAE;IAItB,OAAO,IAAI,WAAW;CAiBvB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,qEAAqE;IACrE,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAA;CACvC"}

package/dist/counterfactual.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"counterfactual.d.ts","sourceRoot":"","sources":["../src/counterfactual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAW,IAAI,EAAY,MAAM,gBAAgB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAmB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAEpF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9D;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAA;CAChD,CAAA;AAEL,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,UAAU,CAAA;IAC9B;0EACsE;IACtE,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,QAAQ,EAAE,sBAAsB,CAAA;IAChC;;8CAE0C;IAC1C,WAAW,EAAE,cAAc,CAAA;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,sBAAsB,CAAA;IAChC,gEAAgE;IAChE,KAAK,EAAE;QACL,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;QACnC,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAA;QACzC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAC1B,CAAA;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAClF;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA6C/B;AA0BD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,KAAK,CAAC;IAC/E,YAAY,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC,EAAE,MAAM,CAAA;IACT,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB,CAAC,CA4BD;AAGD,YAAY,EAAE,IAAI,EAAE,CAAA"}

package/dist/cross-trace-diff.d.ts

@@ -1,56 +0,0 @@
-/**
- * Full cross-trace diff — align two trajectories step-by-step, report
- * per-step score deltas, attribute a variant's total outcome lead to
- * specific turns.
- *
- * 0.5 shipped `firstDivergenceView` (finds the first differing step).
- * This does the heavier work: full alignment via LCS, per-step
- * contribution to score delta using PRM verdicts when available,
- * fallback to structural heuristics (latency, token count, tool
- * outcome) otherwise.
- */
-import type { TraceStore } from './trace/store';
-import { type TrajectoryStep } from './trajectory';
-export type AlignmentOp = {
-    op: 'match';
-    a: TrajectoryStep;
-    b: TrajectoryStep;
-} | {
-    op: 'insert';
-    b: TrajectoryStep;
-} | {
-    op: 'delete';
-    a: TrajectoryStep;
-} | {
-    op: 'replace';
-    a: TrajectoryStep;
-    b: TrajectoryStep;
-};
-export interface StepAttribution {
-    op: AlignmentOp;
-    /** Difference in PRM score (or null when not scored by a matching judge). */
-    prmDelta: number | null;
-    /** Difference in latency (endedAt - startedAt). */
-    latencyDeltaMs: number | null;
-    /** Difference in token count (LLM spans). */
-    tokenDelta: number | null;
-    /** Reason this step is / isn't considered a contributor to the outcome delta. */
-    note: string;
-}
-export interface CrossTraceDiff {
-    runA: string;
-    runB: string;
-    alignment: AlignmentOp[];
-    attributions: StepAttribution[];
-    /** Total score delta (B - A). */
-    totalScoreDelta: number | null;
-    /** Sum of PRM deltas across matched/replaced steps. Close to
-     *  `totalScoreDelta` when PRM covers the trajectory; gap indicates
-     *  unmodeled variance. */
-    prmDeltaSum: number;
-}
-export interface CrossTraceDiffOptions {
-    stepEquals?: (a: TrajectoryStep, b: TrajectoryStep) => boolean;
-}
-export declare function crossTraceDiff(store: TraceStore, runA: string, runB: string, options?: CrossTraceDiffOptions): Promise<CrossTraceDiff>;
-//# sourceMappingURL=cross-trace-diff.d.ts.map

package/dist/cross-trace-diff.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cross-trace-diff.d.ts","sourceRoot":"","sources":["../src/cross-trace-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAEnE,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,CAAC,EAAE,cAAc,CAAC;IAAC,CAAC,EAAE,cAAc,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,CAAC,EAAE,cAAc,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,CAAC,EAAE,cAAc,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,CAAC,EAAE,cAAc,CAAC;IAAC,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAE3D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,WAAW,CAAA;IACf,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,mDAAmD;IACnD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,YAAY,EAAE,eAAe,EAAE,CAAA;IAC/B,iCAAiC;IACjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B;;8BAE0B;IAC1B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,KAAK,OAAO,CAAA;CAC/D;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CAwBzB"}

package/dist/dataset.d.ts.map

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