modelrig 0.4.0 → 0.6.0

package/dist/telemetry/otel-map.js

@@ -23,6 +23,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TRACEPARENT_TAG = exports.SEMCONV_VERSION = void 0;
 exports.parseTraceparent = parseTraceparent;
+exports.metaSpanAttributes = metaSpanAttributes;
 exports.inferenceToSpan = inferenceToSpan;
 exports.cacheDecisionSpanAttributes = cacheDecisionSpanAttributes;
 exports.buildExportTraceRequest = buildExportTraceRequest;
@@ -92,6 +93,65 @@ function toUnixNano(iso, plusMs = 0) {
 function isSearchRow(row) {
     return row.provider === "search";
 }
+/** The classification-rule guard, inlined here to keep otel-map dependency-light
+ * (WI-1b): a string attribute is emitted only if it is an enum/identifier/hash
+ * (≤128 chars, no whitespace). The envelope is already sanitized at production +
+ * ingest; this is belt-and-braces so the OTLP wire can never carry content. */
+function isMetaSafeStr(v) {
+    return typeof v === "string" && v.length > 0 && v.length <= 128 && !/\s/.test(v);
+}
+const finite = (v) => typeof v === "number" && Number.isFinite(v);
+/**
+ * The attempt-envelope span attributes (WI-1b spec §5) — `modelrig.meta.*`,
+ * enums/numbers/booleans/hashes/identifiers ONLY. Mirrors the query grammar's
+ * metadata-safe columns; a value that is not an enum/identifier/hash is dropped
+ * by {@link isMetaSafeStr}, so the metadata-safe property test extends cleanly to
+ * the emitted span. Absent fields emit no attribute (byte-identical to a pre-WI-1
+ * row's span).
+ */
+function metaSpanAttributes(meta) {
+    if (meta === null || meta === undefined)
+        return [];
+    const attrs = [];
+    if (isMetaSafeStr(meta.finish_reason))
+        attrs.push(strAttr("modelrig.meta.finish_reason", meta.finish_reason));
+    if (typeof meta.refusal === "boolean")
+        attrs.push(boolAttr("modelrig.meta.refusal", meta.refusal));
+    if (typeof meta.streaming === "boolean")
+        attrs.push(boolAttr("modelrig.meta.streaming", meta.streaming));
+    if (isMetaSafeStr(meta.context_bucket))
+        attrs.push(strAttr("modelrig.meta.context_bucket", meta.context_bucket));
+    if (isMetaSafeStr(meta.model_snapshot))
+        attrs.push(strAttr("modelrig.meta.model_snapshot", meta.model_snapshot));
+    if (isMetaSafeStr(meta.error_code))
+        attrs.push(strAttr("modelrig.meta.error_code", meta.error_code));
+    if (isMetaSafeStr(meta.region))
+        attrs.push(strAttr("modelrig.meta.region", meta.region));
+    if (isMetaSafeStr(meta.input_hash))
+        attrs.push(strAttr("modelrig.meta.input_hash", meta.input_hash));
+    if (isMetaSafeStr(meta.output_hash))
+        attrs.push(strAttr("modelrig.meta.output_hash", meta.output_hash));
+    if (finite(meta.http_status))
+        attrs.push(intAttr("modelrig.meta.http_status", meta.http_status));
+    if (finite(meta.reasoning_tokens))
+        attrs.push(intAttr("modelrig.meta.reasoning_tokens", meta.reasoning_tokens));
+    if (finite(meta.response_chars))
+        attrs.push(intAttr("modelrig.meta.response_chars", meta.response_chars));
+    const cost = meta.cost;
+    if (cost !== undefined && cost !== null) {
+        if (finite(cost.in))
+            attrs.push(dblAttr("modelrig.meta.cost.in", cost.in));
+        if (finite(cost.out))
+            attrs.push(dblAttr("modelrig.meta.cost.out", cost.out));
+        if (finite(cost.cache_read))
+            attrs.push(dblAttr("modelrig.meta.cost.cache_read", cost.cache_read));
+        if (finite(cost.cache_write))
+            attrs.push(dblAttr("modelrig.meta.cost.cache_write", cost.cache_write));
+        if (finite(cost.other))
+            attrs.push(dblAttr("modelrig.meta.cost.other", cost.other));
+    }
+    return attrs;
+}
 function readTraceparentTag(row) {
     let tags;
     try {
@@ -160,6 +220,10 @@ function inferenceToSpan(row) {
     }
     if (row.failureClass !== null)
         attrs.push(strAttr("modelrig.failure_class", row.failureClass));
+    // WI-1b: the attempt envelope's metadata-safe fields as `modelrig.meta.*`
+    // (enums/numbers/booleans/hashes/identifiers only — never content).
+    for (const a of metaSpanAttributes(row.meta))
+        attrs.push(a);
     const parent = readTraceparentTag(row);
     const traceId = parent !== null ? parent.traceId : traceIdFor(row.id);
     const span = {

package/dist/telemetry/store-migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-migrations.d.ts","sourceRoot":"","sources":["../../src/telemetry/store-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;sCACsC;AACtC,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAuG9D"}
+{"version":3,"file":"store-migrations.d.ts","sourceRoot":"","sources":["../../src/telemetry/store-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;sCACsC;AACtC,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAsH9D"}

package/dist/telemetry/store-migrations.js

@@ -116,4 +116,19 @@ function runStoreMigrations(db) {
         add("candidate_index", "candidate_index INTEGER");
         db.pragma("user_version = 11");
     }
+    // v12 (WI-1a): the attempt/run metadata envelope columns. Additive, nullable;
+    // old rows read null ("recorded before WI-1a"). meta_json goes on BOTH
+    // inferences (AttemptMeta@v1) and runs (RunMeta@v1) — the local mirror of the
+    // Postgres 00056/00057 columns. Same ALTER-if-absent pattern as v10/v11.
+    if (db.pragma("user_version", { simple: true }) < 12) {
+        const infCols = db.prepare("PRAGMA table_info(inferences)").all();
+        if (!infCols.some((c) => c.name === "meta_json")) {
+            db.exec("ALTER TABLE inferences ADD COLUMN meta_json TEXT");
+        }
+        const runCols = db.prepare("PRAGMA table_info(runs)").all();
+        if (!runCols.some((c) => c.name === "meta_json")) {
+            db.exec("ALTER TABLE runs ADD COLUMN meta_json TEXT");
+        }
+        db.pragma("user_version = 12");
+    }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/telemetry/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAA2B,KAAK,cAAc,EAAuB,MAAM,UAAU,CAAC;AAG7F;;;;;GAKG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC9D,qEAAqE;IACrE,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IACpG,uEAAuE;IACvE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IACjG;mEAC+D;IAC/D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iFAAiF;IACjF,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,mEAAmE;IACnE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1F;;iFAE6E;IAC7E,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClE,iEAAiE;IACjE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC3C,aAAa,IAAI,WAAW,EAAE,CAAC;IAC/B,oEAAoE;IACpE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D;;;;;OAKG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CAC3E;AA0SD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,CA+Q3E"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/telemetry/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAA2B,KAAK,cAAc,EAAuB,MAAM,UAAU,CAAC;AAG7F;;;;;GAKG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC9D,qEAAqE;IACrE,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IACpG,uEAAuE;IACvE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IACjG;mEAC+D;IAC/D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iFAAiF;IACjF,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,mEAAmE;IACnE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1F;;iFAE6E;IAC7E,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClE,iEAAiE;IACjE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC3C,aAAa,IAAI,WAAW,EAAE,CAAC;IAC/B,oEAAoE;IACpE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D;;;;;OAKG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CAC3E;AAyTD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,CAoR3E"}

package/dist/telemetry/store.js

@@ -53,7 +53,11 @@ CREATE TABLE IF NOT EXISTS inferences (
   -- databases gain them via the ALTER ladder. Null = recorded pre-0.4.0.
   call_id               TEXT,
   attempt_seq           INTEGER,
-  candidate_index       INTEGER
+  candidate_index       INTEGER,
+  -- v12 (WI-1a): the attempt metadata envelope (AttemptMeta@v1), serialized
+  -- JSON. Fresh here; older databases gain it via the ALTER ladder. Null =
+  -- the producer could not build it / recorded before WI-1a.
+  meta_json             TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_inferences_route_ts ON inferences (route, ts);
 -- v8 (G-4 observed-health): per-endpoint windowed aggregation filters by
@@ -121,7 +125,10 @@ CREATE TABLE IF NOT EXISTS runs (
   started_at       TEXT NOT NULL,
   ended_at         TEXT,
   status           TEXT NOT NULL CHECK (status IN ('running','succeeded','failed','abandoned')),
-  export_seq       INTEGER NOT NULL
+  export_seq       INTEGER NOT NULL,
+  -- v12 (WI-1a): the run metadata envelope (RunMeta@v1), serialized JSON. Null
+  -- when unset (run.start without a meta) or recorded before WI-1a.
+  meta_json        TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_runs_export_seq ON runs (export_seq);
 
@@ -154,6 +161,9 @@ function toRunRow(r) {
         startedAt: r.started_at,
         endedAt: r.ended_at,
         status: r.status,
+        // v12 (WI-1a): `?? null` — a pre-WI-1a database returns undefined for the
+        // meta_json ALTER column, and those rows genuinely predate RunMeta.
+        meta: r.meta_json != null ? JSON.parse(r.meta_json) : null,
     };
 }
 function toStepRow(r) {
@@ -224,6 +234,9 @@ function toTelemetryRow(r) {
         callId: r.call_id ?? null,
         attemptSeq: r.attempt_seq ?? null,
         candidateIndex: r.candidate_index ?? null,
+        // Attempt envelope (WI-1a) — `?? null`: a pre-v12 database returns undefined
+        // for the meta_json ALTER column, and those rows predate the envelope.
+        meta: r.meta_json != null ? JSON.parse(r.meta_json) : null,
     };
 }
 function toEnvelopeRow(r) {
@@ -249,13 +262,13 @@ function openTelemetryStore(dbPath) {
       tokens_in, tokens_out, tokens_cached, cost_estimate_usd, latency_ms, ttfb_ms,
       failure_class, attempts_json, tags_json, fingerprint_cell, served_variant, repaired_by, pricing_missing,
       tokens_cache_write, tokens_cache_write_1h, cache_key, prefix_fingerprint,
-      call_id, attempt_seq, candidate_index
+      call_id, attempt_seq, candidate_index, meta_json
     ) VALUES (
       @id, @ts, @route, @route_version, @provider, @model, @requested_tier, @served_tier,
       @tokens_in, @tokens_out, @tokens_cached, @cost_estimate_usd, @latency_ms, @ttfb_ms,
       @failure_class, @attempts_json, @tags_json, @fingerprint_cell, @served_variant, @repaired_by, @pricing_missing,
       @tokens_cache_write, @tokens_cache_write_1h, @cache_key, @prefix_fingerprint,
-      @call_id, @attempt_seq, @candidate_index
+      @call_id, @attempt_seq, @candidate_index, @meta_json
     )
   `);
     const selectByTag = db.prepare(`
@@ -288,8 +301,8 @@ function openTelemetryStore(dbPath) {
     // synchronous, so the MAX(export_seq)+1 read is race-free.
     const nextRunSeq = db.prepare("SELECT COALESCE(MAX(export_seq), 0) + 1 AS n FROM runs");
     const upsertRun = db.prepare(`
-    INSERT INTO runs (id, pipeline, pipeline_version, environment, episode_key, started_at, ended_at, status, export_seq)
-    VALUES (@id, @pipeline, @pipeline_version, @environment, @episode_key, @started_at, @ended_at, @status, @export_seq)
+    INSERT INTO runs (id, pipeline, pipeline_version, environment, episode_key, started_at, ended_at, status, export_seq, meta_json)
+    VALUES (@id, @pipeline, @pipeline_version, @environment, @episode_key, @started_at, @ended_at, @status, @export_seq, @meta_json)
     ON CONFLICT (id) DO UPDATE SET
       pipeline = excluded.pipeline,
       pipeline_version = excluded.pipeline_version,
@@ -298,7 +311,8 @@ function openTelemetryStore(dbPath) {
       started_at = excluded.started_at,
       ended_at = excluded.ended_at,
       status = excluded.status,
-      export_seq = excluded.export_seq
+      export_seq = excluded.export_seq,
+      meta_json = excluded.meta_json
   `);
     const insertStep = db.prepare(`
     INSERT OR IGNORE INTO steps (
@@ -346,6 +360,9 @@ function openTelemetryStore(dbPath) {
                 call_id: row.callId ?? null,
                 attempt_seq: row.attemptSeq ?? null,
                 candidate_index: row.candidateIndex ?? null,
+                // WI-1a: serialize the envelope, or null — better-sqlite3 rejects an
+                // `undefined` bound param, and a row that omits it has no envelope.
+                meta_json: row.meta != null ? JSON.stringify(row.meta) : null,
             });
         },
         recordFeedback(row) {
@@ -380,6 +397,7 @@ function openTelemetryStore(dbPath) {
                 ended_at: row.endedAt,
                 status: row.status,
                 export_seq: seq,
+                meta_json: row.meta != null ? JSON.stringify(row.meta) : null,
             });
         },
         recordStep(row) {

package/dist/types/failures-teaching.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"failures-teaching.d.ts","sourceRoot":"","sources":["../../src/types/failures-teaching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;4EACwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,eAAe,GAAG,IAAI,CAAC;CAC5E;AAID,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CA+I5E,CAAC;AAiBF;6EAC6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,CAU3D;AAED;gEACgE;AAChE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAapE"}
+{"version":3,"file":"failures-teaching.d.ts","sourceRoot":"","sources":["../../src/types/failures-teaching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;4EACwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,eAAe,GAAG,IAAI,CAAC;CAC5E;AAID,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAuK5E,CAAC;AAiBF;6EAC6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,CAU3D;AAED;gEACgE;AAChE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAapE"}

package/dist/types/failures-teaching.js

@@ -137,6 +137,26 @@ exports.FAILURE_TEACHING = {
             "model that appeared.",
         docsUrl: `${DOCS_BASE}#invariant_violation`,
     },
+    quality_rejected: {
+        class: "quality_rejected",
+        what: "The output met the schema your route requires, but the quality gate you supplied " +
+            "(`rig.run(route, { qualityGate })`) judged it below your bar and rejected it — so the " +
+            "ladder fell through rather than passing it downstream.",
+        fixHint: "This is your own predicate talking, not the model failing a shape check. If good outputs " +
+            "are being rejected, the bar is too tight — loosen the gate. If you want the same candidate " +
+            "re-sampled before falling through, give this class a budget under `policy.retries`; it " +
+            "defaults to 0 (immediate fall-through) and never enters the repair rung.",
+        docsUrl: `${DOCS_BASE}#quality_rejected`,
+        // Mechanical: give the class a small retry budget so sampling variance gets
+        // a second draw on the SAME candidate before the ladder falls through.
+        suggestedChange: () => ({
+            op: "replace",
+            path: "/policy/retries/quality_rejected",
+            value: 1,
+            because: "A quality miss is often sampling variance; one retry re-draws the same candidate before " +
+                "falling through, at the cost of one extra call.",
+        }),
+    },
 };
 /** Provider → the env var that keys it. Mirrors config.ts's PROVIDER_KEY_ENV;
  * kept as a local lookup so this table has no import cycle with config. */

package/dist/types/failures.d.ts

@@ -4,7 +4,7 @@
  * errors never cross the adapter boundary. Retry budgets are per-class and
  * non-fungible (see run/retry.ts).
  */
-export type FailureClass = "content_invalid" | "capacity_shed" | "network" | "refusal" | "cache_invalid" | "timeout" | "config_auth" | "budget_exhausted" | "invariant_violation";
+export type FailureClass = "content_invalid" | "capacity_shed" | "network" | "refusal" | "cache_invalid" | "timeout" | "config_auth" | "budget_exhausted" | "invariant_violation" | "quality_rejected";
 export interface RigFailure {
     readonly class: FailureClass;
     readonly message: string;

package/dist/types/failures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../src/types/failures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,eAAe,GACf,SAAS,GACT,SAAS,GACT,eAAe,GACf,SAAS,GACT,aAAa,GACb,kBAAkB,GAClB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,YAAY,CAGrD,CAAC;AAcH;kFACkF;AAClF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;gBAEjB,OAAO,EAAE,UAAU;CAKhC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAIhE"}
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../src/types/failures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,eAAe,GACf,SAAS,GACT,SAAS,GACT,eAAe,GACf,SAAS,GACT,aAAa,GACb,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,YAAY,CAGrD,CAAC;AAeH;kFACkF;AAClF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;gBAEjB,OAAO,EAAE,UAAU;CAKhC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAIhE"}

package/dist/types/failures.js

@@ -22,6 +22,7 @@ const FAILURE_CLASSES = new Set([
     "config_auth",
     "budget_exhausted",
     "invariant_violation",
+    "quality_rejected",
 ]);
 /** Error subclass for the rare paths that must throw (config errors, terminal
  * failures surfacing to the caller). The failure travels intact on `.failure`. */

package/dist/types/provider.d.ts

@@ -4,6 +4,7 @@
  * and CandidateRef is a branded type constructible ONLY in run/resolve.ts.
  */
 import type { RigFailure } from "./failures";
+import type { AttemptMetaV1 } from "../telemetry/attempt-meta";
 export type ProviderId = "gemini" | "openai" | "deepseek" | "anthropic" | "grok" | "deepinfra" | "fireworks";
 /** Runtime enumeration of every ProviderId — the single list a raw-model lane
  * (`provider/model`) validates against (http gateway spec §3.3). Kept in sync
@@ -199,6 +200,13 @@ export type AdapterResult = {
      * A tool-call turn carries these instead of (or alongside) `text`; the
      * run loop surfaces them and does NOT schema-validate the turn. */
     readonly toolCalls?: readonly ToolCall[];
+    /** NATIVE attempt metadata (WI-1, spec §2) — finish reason, refusal,
+     * reasoning tokens, model snapshot, provider request id, sampling echo,
+     * tool-call names/counts. ADDITIVE: an adapter that reports nothing omits
+     * it and changes nothing. The single producer (`summarizeAttemptMeta`)
+     * adds hashes/sizes/cost and enforces the classification rule; adapters
+     * NEVER build the full envelope. */
+    readonly meta?: Partial<AttemptMetaV1>;
 }
 /** F1 (C1 finding, closed Phase 3 step 0): failures that still BILLED
  * tokens (refusals, truncations, post-stream rejections) carry `usage` so
@@ -208,6 +216,7 @@ export type AdapterResult = {
     readonly ok: false;
     readonly failure: RigFailure;
     readonly usage?: AdapterUsage;
+    readonly meta?: Partial<AttemptMetaV1>;
 };
 /** One event from an adapter's streaming variant (G-1/G-5 Phase A). A stream
  * emits zero or more `delta` events (raw, pre-validation text) and closes with

package/dist/types/provider.d.ts.map

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

package/dist/types/quality.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Quality gate (Q1, quality-gate spec §3) — an SDK-lane predicate that rejects a
+ * schema-VALID output the builder judges too low, so the candidate ladder falls
+ * through on *quality*, not just shape.
+ *
+ * This is the SDK lane only, by construction: a `QualityGate` is a JavaScript
+ * function, and a function cannot cross the hosted (jsonb bundle) boundary — the
+ * hosted lane's route-declared judge is Q2 (spec §3, boundary B1). See the
+ * doc-comment on `RunOptions.qualityGate` in ./route.ts.
+ */
+import type { ProviderId } from "./provider";
+/** The predicate's answer for one candidate output.
+ * `ok:false` rejects the output and falls the ladder through (recorded
+ * `quality_rejected`); `score`/`reason` are optional and ride telemetry + meta. */
+export interface QualityVerdict {
+    /** True accepts the output; false rejects it and falls through. */
+    readonly ok: boolean;
+    /** Optional 0..1-ish quality score — stamped on `tags.quality_score`, averaged
+     * into a bake-off's `valueAccuracy`, and surfaced on `RunMeta.quality.score`. */
+    readonly score?: number;
+    /** Optional one-line reason — carried in the `quality_rejected` failure
+     * message so a stuck engineer sees WHY the output was rejected. */
+    readonly reason?: string;
+}
+/** What the gate is told about the candidate whose output it is judging. */
+export interface QualityGateMeta {
+    readonly route: string;
+    readonly provider: ProviderId;
+    readonly model: string;
+    /** Position of the serving candidate in the run's effective candidate list. */
+    readonly candidateIndex: number;
+    /** The attempt_seq the judged output's telemetry row will carry (1-based). */
+    readonly attemptSeq: number;
+    /** Variant that served this run — null = the route's base config. */
+    readonly servedVariant: string | null;
+}
+/** A builder-supplied quality predicate. Sync or async; a throwing gate rejects
+ * fail-closed (spec §4.1 step 4). Evaluated ONLY on a schema-valid, non-tool-call
+ * output (spec §4.1 steps 6–7). */
+export type QualityGate = (output: unknown, meta: QualityGateMeta) => QualityVerdict | Promise<QualityVerdict>;
+//# sourceMappingURL=quality.d.ts.map

package/dist/types/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/types/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;mFAEmF;AACnF,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB;qFACiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;uEACmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED;;mCAEmC;AACnC,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,eAAe,KAClB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC"}

package/dist/types/quality.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Quality gate (Q1, quality-gate spec §3) — an SDK-lane predicate that rejects a
+ * schema-VALID output the builder judges too low, so the candidate ladder falls
+ * through on *quality*, not just shape.
+ *
+ * This is the SDK lane only, by construction: a `QualityGate` is a JavaScript
+ * function, and a function cannot cross the hosted (jsonb bundle) boundary — the
+ * hosted lane's route-declared judge is Q2 (spec §3, boundary B1). See the
+ * doc-comment on `RunOptions.qualityGate` in ./route.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/route.d.ts

@@ -4,9 +4,27 @@
  */
 import type { FailureClass } from "./failures";
 import type { ProviderId, SamplingParams, ServiceTier, ToolCall, ToolChoice, ToolDefinition } from "./provider";
+import type { QualityGate } from "./quality";
 export interface CandidateSpec {
     readonly provider: ProviderId;
     readonly model: string;
+    /**
+     * Declare-first experiment flag (routing-console spec §4.4, R3). A `trial`
+     * candidate is DECLARED — it is in the list the brand type, the loader and the
+     * runtime candidate-set guard all derive from, so the candidate-set invariant
+     * is untouched — but `resolveCandidates` drops it on EVERY live path
+     * (`rig.run`, `runStream`, `runBundle`, the hosted gateway slug lane) exactly
+     * as it drops a `providers.ignore` entry. Only the bake-off replay path
+     * (`replayVariant`, run `mode: "trial"`) keeps it, so a customer can measure a
+     * new model on real captured traffic before promoting it to a live candidate.
+     * Optional & additive (S3): absent ⇒ false ⇒ an ordinary live candidate.
+     *
+     * OLDER-SDK CAVEAT (spec §7): the pre-0.4.0 loader is TOLERANT of unknown
+     * candidate keys — it would ignore `trial` and serve the candidate LIVE. A
+     * bundle using `trial: true` therefore REQUIRES the SDK release that
+     * understands it; the console's declare-YAML says so.
+     */
+    readonly trial?: boolean;
 }
 export type Requirement = "schema_conformant" | "grounded" | "zero_retention" | "trace_visible";
 export type Preference = "cost" | "latency";
@@ -57,6 +75,71 @@ export interface RouteVariant {
     /** JSON rung override for this variant. */
     readonly json?: "native" | "json_mode";
     readonly repair?: RepairPolicy;
+    /**
+     * COMPUTED at load (not authored): true when every candidate this variant
+     * narrows to is a declared `trial` candidate (routing-console spec §4.4). A
+     * trial variant is valid for `rig.bakeoff` but a `RouteConfigError` if a live
+     * caller selects it — trial candidates are declared, never live-served. The
+     * declare-first flow's `trial-<provider>-<model>` variant is exactly this.
+     */
+    readonly trialOnly?: boolean;
+}
+/** Bake-off objective (RB-1, near-optimal spec §3) — replaces the implicit
+ * cost-first gate with a declared one. Additive & optional (S3): an absent
+ * `objective:` block ⇒ `quality-first` with no bound ⇒ regret is REPORTED but
+ * nothing is proposed until a `max_regret` or `price_ceiling` is declared, so
+ * the default flip never actuates silently. */
+export type ObjectiveMode = "quality-first" | "balanced" | "cost-first";
+/** The per-unit-of-work budget a customer considers reasonable. Exactly one of
+ * the two units is set (loader-enforced). `usd_per_1k` = max effective cost per
+ * 1k quality-passing outputs (the existing effective-$/1k axis); `usd_per_run` =
+ * a flat per-run envelope. */
+export interface PriceCeiling {
+    readonly usdPer1k?: number;
+    readonly usdPerRun?: number;
+}
+export interface RouteObjective {
+    readonly mode: ObjectiveMode;
+    /** Quality-regret bound ε, on the arm's named quality metric (points, 0..1). */
+    readonly maxRegret?: number;
+    readonly priceCeiling?: PriceCeiling;
+    /** `balanced` only — weight on normalized cost in `regret + lambda·cost_norm`. */
+    readonly lambda?: number;
+}
+/** A deterministic value assertion on a bake-off sample's output (RB-1 spec §3).
+ * `path` is a JSON pointer (RFC 6901) into the parsed output; `expect` is either
+ * a literal to equal (normalized) or a regex the stringified value must match. A
+ * route's value_checks give value-accuracy WITHOUT an eval case or a judge. */
+export interface ValueCheck {
+    readonly path: string;
+    readonly expect: {
+        readonly literal: unknown;
+    } | {
+        readonly regex: string;
+    };
+}
+/** Bake-off configuration (RB-1 spec §3) — the reference (ceiling) arm and an
+ * optional SDK-side capped judge. Additive & optional. */
+export interface BakeoffConfig {
+    /** The ceiling arm. `auto` = the strongest declared candidate for the route's
+     * task (registry probed conformance; see bakeoff/reference.ts). An explicit
+     * `provider/model` MUST be a declared candidate unless `referenceAllowExternal`. */
+    readonly reference?: "auto" | {
+        readonly provider: ProviderId;
+        readonly model: string;
+    };
+    /** Records that an out-of-candidate reference was deliberately allowed. */
+    readonly referenceAllowExternal?: boolean;
+    /** The reference is dear by definition — its own replay envelope. */
+    readonly referenceEnvelopeUsd?: number;
+    /** Opt-in judge for value accuracy where no eval case / value check applies
+     * (metric precedence tier 3). The judge model MUST be a declared candidate
+     * (#223 F3); every judge call is a metered inference tagged `judge`; capped at
+     * `maxSamples` per arm. */
+    readonly judge?: {
+        readonly model: CandidateSpec;
+        readonly maxSamples: number;
+    };
 }
 export interface RouteBundle {
     readonly route: string;
@@ -91,6 +174,13 @@ export interface RouteBundle {
     /** Schema-fingerprint cell key, computed at load from outputSchema
      * (registry/fingerprint.ts); null for unstructured routes. */
     readonly fingerprintCell: string | null;
+    /** Bake-off objective (RB-1) — absent ⇒ quality-first, no bound (regret shown,
+     * nothing proposed). */
+    readonly objective?: RouteObjective;
+    /** Bake-off reference arm + optional judge (RB-1). */
+    readonly bakeoff?: BakeoffConfig;
+    /** Deterministic value assertions for bake-off quality (RB-1). */
+    readonly valueChecks?: readonly ValueCheck[];
 }
 export interface RunTags {
     readonly run_id?: string;
@@ -100,6 +190,12 @@ export interface RunTags {
 export interface RunOptions {
     readonly input: Record<string, unknown>;
     readonly tags: RunTags;
+    /** Names the ground-truth step this run records (G1 spec §3) — the same field
+     * the raw lane exposes, so a routed and a raw call, plus an `artifact.save`,
+     * can be composed into ONE step group. Resolution: `stepKey ?? tags.step ??`
+     * an auto-minted `route#n`. Validated `[A-Za-z0-9_.:#-]{1,128}`; an invalid
+     * value is warned and dropped to the auto key. Absent ⇒ unchanged behavior. */
+    readonly stepKey?: string;
     readonly budget?: {
         readonly envelope: string;
         /** Budget for this envelope when it is FIRST opened (open-or-get: the first
@@ -163,6 +259,20 @@ export interface RunOptions {
          * the customer's own heartbeat governs the actual resource TTL. */
         readonly ttlSeconds?: number;
     };
+    /**
+     * Quality gate (Q1, quality-gate spec §3/§4.1) — a builder-supplied predicate
+     * evaluated on a schema-VALID output before it is accepted. `ok:false` rejects
+     * the output, records a `quality_rejected` attempt (its OWN retry budget under
+     * `policy.retries`, default 0), and falls the ladder through — WITHOUT ever
+     * entering the repair rung. A throwing gate rejects fail-closed. Tool-call
+     * turns and unstructured (`schema: null`) routes are handled per spec §4.1.
+     *
+     * SDK LANE ONLY: this is a JavaScript function, and a function cannot cross the
+     * hosted (jsonb bundle) boundary — the hosted gateway builds `RunOptions` from
+     * parsed JSON (`mapToRunOptions`), which can NEVER populate this field. The
+     * hosted equivalent is the route-declared judge (Q2). See boundary B1.
+     */
+    readonly qualityGate?: QualityGate;
 }
 export interface RunMeta {
     /** Telemetry row id of the serving attempt — the handle rig.feedback()
@@ -202,6 +312,16 @@ export interface RunMeta {
      * present only on a tool-call turn, where `validated` is false and
      * `RunResult.output` is null. The caller runs the tool(s) and continues. */
     readonly toolCalls?: readonly ToolCall[];
+    /** Quality-gate verdict on the accepted output (Q1, spec §2/§4.1) — present
+     * only when a gate ran on this run. `score` is the predicate's score (null when
+     * it returned none); `verdict` is always `"pass"` on a returned run (a `"fail"`
+     * fell the ladder through and never reached here); `judgedBy` is null for an
+     * SDK predicate (a route-declared model judge, Q2, would name the judge). */
+    readonly quality?: {
+        readonly score: number | null;
+        readonly verdict: "pass" | "fail";
+        readonly judgedBy: string | null;
+    };
 }
 export interface RunResult {
     readonly output: unknown;

package/dist/types/route.d.ts.map

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

package/dist/types/telemetry.d.ts

@@ -4,6 +4,7 @@
  */
 import type { FailureClass } from "./failures";
 import type { RunTags } from "./route";
+import type { AttemptMetaV1, RunMetaV1 } from "../telemetry/attempt-meta";
 /**
  * The rung a telemetry row occupied on the candidate ladder (routing-console R1
  * review ruling F1). SDK-stamped into `tags.rung` on EVERY row so the dashboard
@@ -91,6 +92,13 @@ export interface TelemetryRow {
      * row carries the index of the candidate being repaired; the raw lane is 0.
      * Optional/additive; null for a pre-0.4.0 row. */
     readonly candidateIndex?: number | null;
+    /** The attempt metadata envelope (WI-1, spec §2) — `AttemptMeta@v1`, a
+     * metadata-safe rollup of finish reason / refusal / hashes / cost components /
+     * context bucket etc. Built by the single producer (`summarizeAttemptMeta`)
+     * and persisted to `inferences.meta` (migration 00056). Optional/additive:
+     * null when the producer could not build it (byte-identical run result) and
+     * for rows recorded before the WI-1a migration. */
+    readonly meta?: AttemptMetaV1 | null;
 }
 export interface EnvelopeRow {
     readonly envelopeKey: string;
@@ -145,6 +153,11 @@ export interface RunRow {
     readonly startedAt: string;
     readonly endedAt: string | null;
     readonly status: "running" | "succeeded" | "failed" | "abandoned";
+    /** The run metadata envelope (WI-1, spec §3) — `RunMeta@v1`: pipeline sha,
+     * config hash, trigger, actor, input hash. Set via `run.start({ meta })`;
+     * `pipeline_sha` auto-fills from git when available. Persisted to `runs.meta`
+     * (migration 00057). Optional/additive; null when unset or pre-WI-1a. */
+    readonly meta?: RunMetaV1 | null;
 }
 /** One ATTEMPT of one operation within a run (Expansion E2 chunk A, ruling c).
  * A fact — one row per attempt, PK (run_id, step_key, attempt_no). Provenance is