modelrig 0.8.1 → 0.10.0

package/dist/status.js

@@ -33,57 +33,77 @@ function exportModeOf(config) {
     return config.export?.mode ?? "local-only";
 }
 /**
- * The artifact-namespace posture as a boolean + a reason, derivable from config
- * ALONE (so both the banner and `/status` agree). The four cases the §2 flip
- * creates, each named honestly:
- *   on  + control plane → the default is now on (a sink exists to ship to)
- *   on  + local-only    → an explicit MODELRIG_ARTIFACTS opt-in
- *   off + control plane → an explicit MODELRIG_ARTIFACTS=0 opt-out
- *   off + local-only    → nothing to ship to; off is the local-only default
+ * The artifact-namespace posture as a boolean + a reason (P15 CP-3). The on/off
+ * SOURCE is the ORG's account posture (`artifact_posture`), resolved from the
+ * control plane — never an env var. The cases, each named honestly:
+ *   control plane, posture off      → capture off — your account settings
+ *   control plane, posture managed/metadata → capture on — your account settings
+ *   control plane, posture resolving (null) → capture on — account settings (resolving)
+ *   local-only, dev force-on        → MODELRIG_ARTIFACTS=1 (dev-only, local rig)
+ *   local-only, off                 → nothing to ship to; off is the local default
+ * `posture` is the resolver's current value (null until the first run resolves
+ * it, or always null for local-only / hand-built configs).
  */
-function artifactsPosture(config) {
-    const enabled = config.artifacts?.enabled === true;
+function artifactsPosture(config, posture = null) {
     const localOnly = exportModeOf(config) === "local-only";
-    if (enabled) {
+    if (localOnly) {
+        const enabled = config.artifacts?.enabled === true;
         return {
             enabled,
-            reason: localOnly ? "MODELRIG_ARTIFACTS opt-in (local-only rig)" : "control plane configured",
+            reason: enabled
+                ? "MODELRIG_ARTIFACTS=1 (dev-only, local rig)"
+                : "local-only rig — no control plane to ship to",
         };
     }
-    return {
-        enabled,
-        reason: localOnly ? "local-only rig — no control plane to ship to" : "MODELRIG_ARTIFACTS=0 opt-out",
-    };
+    // Control plane configured: the org account posture (P15) governs on/off.
+    if (posture === "off") {
+        return { enabled: false, reason: "capture off — your account settings (posture: off)" };
+    }
+    const src = posture === null ? "your account settings (resolving)" : `your account settings (posture: ${posture})`;
+    return { enabled: true, reason: `capture on — ${src}` };
+}
+/** Whether content is EFFECTIVELY stored: content transport configured AND the
+ * org posture is not one that suppresses content (P15). posture `off`/`metadata`
+ * → the server stores no content, so report it off honestly; `managed`/resolving
+ * with content configured → on (attempted; the server is the gate). */
+function contentCustodyOn(config, posture) {
+    if (config.artifacts?.content === undefined)
+        return false;
+    return posture !== "off" && posture !== "metadata";
 }
-/** Build the full status snapshot from config + the resolver's per-task cache,
- * plus (GS-1) an optional runs-recorded summary read from the local buffer. */
-function buildRigStatus(config, tasks = new Map(), runs) {
+/** Build the full status snapshot from config + the resolver's per-task cache and
+ * org posture (P15), plus (GS-1) an optional runs-recorded summary from the buffer. */
+function buildRigStatus(config, tasks = new Map(), runs, posture = null) {
     return {
         exportMode: exportModeOf(config),
-        artifacts: artifactsPosture(config),
-        contentCustody: config.artifacts?.content !== undefined,
+        artifacts: artifactsPosture(config, posture),
+        contentCustody: contentCustodyOn(config, posture),
         otlp: config.otlp ? "configured" : "disabled",
+        managedServing: config.managedServing === true ? "enabled" : "disabled",
         cache: cachePosture(),
         tasks: [...tasks].map(([task, s]) => ({ task, ...s })),
         ...(runs != null ? { runs } : {}),
     };
 }
-/** The one-line boot banner (§2). Concise on purpose — mode, artifacts (+why),
- * content, otlp. */
-function formatBootBanner(config) {
-    const a = artifactsPosture(config);
-    const content = config.artifacts?.content !== undefined ? "on" : "off";
+/** The one-line boot banner (§2 + P15). Concise on purpose — mode, artifacts
+ * (+source), content, otlp. `posture` is null at boot (resolves on the first run),
+ * so the banner names the SOURCE (account settings) rather than a stale value. */
+function formatBootBanner(config, posture = null) {
+    const a = artifactsPosture(config, posture);
+    const content = contentCustodyOn(config, posture) ? "on" : "off";
     const otlp = config.otlp ? "on" : "off";
+    const managedServing = config.managedServing === true ? "on" : "off";
     return (`[modelrig] telemetry: ${exportModeOf(config)} · ` +
         `artifacts: ${a.enabled ? "on" : "off"} (${a.reason}) · ` +
-        `content: ${content} · otlp: ${otlp}`);
+        `content: ${content} · otlp: ${otlp} · managed-serving: ${managedServing}`);
 }
 /**
  * Emit the boot banner to stderr — ONCE at rig construction, and ONLY when a
- * control plane is configured (the case where the §2 default flip is in effect
- * and the posture is non-obvious). A pure local-only rig with artifacts off is
- * the boring, expected default and stays silent (no banner noise in tests or
- * embedders). Stderr, so it never pollutes a command's stdout.
+ * control plane is configured (the case where capture is on by default and the
+ * posture — resolved from account settings — is non-obvious). A pure local-only
+ * rig with artifacts off is the boring, expected default and stays silent (no
+ * banner noise in tests or embedders). Stderr, so it never pollutes stdout.
+ * Posture is null at boot; the banner names its source (account settings).
  */
 function emitBootBanner(config) {
     if (config.export === undefined)
@@ -98,6 +118,7 @@ function formatStatusReport(status) {
         `  artifacts        : ${status.artifacts.enabled ? "enabled" : "disabled"} (${status.artifacts.reason})`,
         `  content custody  : ${status.contentCustody ? "enabled" : "disabled"}`,
         `  otlp span export : ${status.otlp}`,
+        `  managed serving  : ${status.managedServing} (config: managedServing)`,
         `  cache accounting : on (policy ${status.cache.policyVersion}) — cache-eligible: ${status.cache.eligibleProviders.length > 0 ? status.cache.eligibleProviders.join(", ") : "none"}`,
         "                     (live hit rate + effective input rate: console route cache page)",
     ];

package/dist/telemetry/artifact-store.d.ts

@@ -9,11 +9,14 @@
  * a sha256 of bytes hashed-then-discarded. Rows are immutable facts: INSERT OR
  * IGNORE, read past a rowid watermark exactly like inferences.
  */
-import type { ArtifactEdgeRow, ArtifactEvaluationRow, ArtifactRow, EvalCaseRow } from "../types/telemetry";
+import type { ArtifactEdgeRow, ArtifactRow, EvalCaseRow, GradeRow } from "../types/telemetry";
 export interface ArtifactStore {
     recordArtifact(row: ArtifactRow): void;
     recordArtifactEdge(row: ArtifactEdgeRow): void;
-    recordArtifactEvaluation(row: ArtifactEvaluationRow): void;
+    /** Record a unified judgment (grade primitive, R1) — the canonical write path
+     * for a grade on an artifact/run subject, which transacts on THIS handle.
+     * Writes the shared local `grades` table (read/exported by the telemetry handle). */
+    recordGrade(row: GradeRow): void;
     /** Record a promoted eval case (E4 chunk A) — rides the `:eval_cases` export
      * stream to the control plane, exactly like the other artifact-graph rows. */
     recordEvalCase(row: EvalCaseRow): void;
@@ -25,10 +28,6 @@ export interface ArtifactStore {
         rowid: number;
         row: ArtifactEdgeRow;
     }>;
-    readEvaluationsAfter(afterRowid: number, limit: number): Array<{
-        rowid: number;
-        row: ArtifactEvaluationRow;
-    }>;
     readEvalCasesAfter(afterRowid: number, limit: number): Array<{
         rowid: number;
         row: EvalCaseRow;

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

@@ -1 +1 @@
-{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../src/telemetry/artifact-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/C,wBAAwB,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3D;kFAC8E;IAC9E,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAClG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IAClG,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;IACxD,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAClG,gFAAgF;IAChF,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IACjD;gEAC4D;IAC5D,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAChD;;oFAEgF;IAChF,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAwED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAwH/D"}
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../src/telemetry/artifact-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/C;;yFAEqF;IACrF,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC;kFAC8E;IAC9E,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAClG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IAClG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAClG,gFAAgF;IAChF,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IACjD;gEAC4D;IAC5D,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAChD;;oFAEgF;IAChF,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AA2DD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CA2H/D"}

package/dist/telemetry/artifact-store.js

@@ -18,6 +18,7 @@ exports.openArtifactStore = openArtifactStore;
 const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const grades_sql_1 = require("./grades-sql");
 const ARTIFACTS_SQL = `
 CREATE TABLE IF NOT EXISTS artifacts (
   id TEXT PRIMARY KEY, run_id TEXT, step_key TEXT, attempt_no INTEGER, task TEXT,
@@ -53,14 +54,6 @@ function toArtifact(r) {
 function toEdge(r) {
     return { fromArtifactId: r.from_artifact_id, toArtifactId: r.to_artifact_id, kind: r.kind };
 }
-function toEval(r) {
-    return {
-        id: r.id, artifactId: r.artifact_id, runId: r.run_id, evaluator: r.evaluator,
-        evaluatorKind: r.evaluator_kind,
-        score: r.score, passed: r.passed === null ? null : r.passed !== 0,
-        label: r.label, explanation: r.explanation, createdBy: r.created_by,
-    };
-}
 function toEvalCase(r) {
     return {
         id: r.id, task: r.task, sourceArtifactId: r.source_artifact_id,
@@ -78,6 +71,23 @@ function openArtifactStore(dbPath) {
     // telemetry guarantee; the cloud exporter is the durable copy.
     db.pragma("synchronous = NORMAL");
     db.exec(ARTIFACTS_SQL);
+    // Grade primitive (R1): the unified `grades` table is shared with the telemetry
+    // handle (same file). CREATE IF NOT EXISTS so whichever handle opens first wins;
+    // then backfill this store's evaluations into grades (idempotent, INSERT OR
+    // IGNORE) so pre-grade evaluations still export as grades. Additive.
+    db.exec(grades_sql_1.GRADES_TABLE_SQL);
+    (0, grades_sql_1.backfillGradesFromEvaluations)(db);
+    // F4: additive per-criterion `criteria` column on a dev DB that predates it
+    // and was created by THIS handle (so the telemetry store's v16 rung may not
+    // have run). CREATE IF NOT EXISTS above won't add it to an existing table;
+    // gradeBindParams now binds @criteria, so the column must exist before any
+    // insert. Same swallow-on-duplicate pattern as scrub/run_id.
+    try {
+        db.exec("ALTER TABLE grades ADD COLUMN criteria TEXT");
+    }
+    catch {
+        /* column already present — no-op */
+    }
     // Additive column for a dev DB that predates E4 (CREATE TABLE IF NOT EXISTS
     // won't add it to an existing table). SQLite has no ADD COLUMN IF NOT EXISTS;
     // a duplicate-column error on re-run is expected and swallowed.
@@ -110,14 +120,11 @@ function openArtifactStore(dbPath) {
       @data_classification, @expires_at, @scrub
     )`);
     const insEdge = db.prepare("INSERT OR IGNORE INTO artifact_edges (from_artifact_id, to_artifact_id, kind) VALUES (@from_artifact_id, @to_artifact_id, @kind)");
-    const insEval = db.prepare(`
-    INSERT OR IGNORE INTO artifact_evaluations (
-      id, artifact_id, run_id, evaluator, evaluator_kind, score, passed, label, explanation, created_by
-    ) VALUES (@id, @artifact_id, @run_id, @evaluator, @evaluator_kind, @score, @passed, @label, @explanation, @created_by)`);
     const insEvalCase = db.prepare(`
     INSERT OR IGNORE INTO eval_cases (
       id, task, source_artifact_id, corrected_artifact_id, origin, note, created_by
     ) VALUES (@id, @task, @source_artifact_id, @corrected_artifact_id, @origin, @note, @created_by)`);
+    const insGrade = (0, grades_sql_1.prepareGradeInsert)(db);
     return {
         recordArtifact(row) {
             insArtifact.run({
@@ -135,13 +142,8 @@ function openArtifactStore(dbPath) {
         recordArtifactEdge(row) {
             insEdge.run({ from_artifact_id: row.fromArtifactId, to_artifact_id: row.toArtifactId, kind: row.kind });
         },
-        recordArtifactEvaluation(row) {
-            insEval.run({
-                id: row.id, artifact_id: row.artifactId, run_id: row.runId, evaluator: row.evaluator,
-                evaluator_kind: row.evaluatorKind, score: row.score,
-                passed: row.passed === null ? null : row.passed ? 1 : 0,
-                label: row.label, explanation: row.explanation, created_by: row.createdBy,
-            });
+        recordGrade(row) {
+            insGrade.run((0, grades_sql_1.gradeBindParams)(row));
         },
         recordEvalCase(row) {
             insEvalCase.run({
@@ -160,11 +162,6 @@ function openArtifactStore(dbPath) {
                 .all(afterRowid, limit);
             return rows.map((r) => ({ rowid: r.__r, row: toEdge(r) }));
         },
-        readEvaluationsAfter(afterRowid, limit) {
-            const rows = db.prepare("SELECT rowid AS __r, * FROM artifact_evaluations WHERE rowid > ? ORDER BY rowid LIMIT ?")
-                .all(afterRowid, limit);
-            return rows.map((r) => ({ rowid: r.__r, row: toEval(r) }));
-        },
         readEvalCasesAfter(afterRowid, limit) {
             const rows = db.prepare("SELECT rowid AS __r, * FROM eval_cases WHERE rowid > ? ORDER BY rowid LIMIT ?")
                 .all(afterRowid, limit);

package/dist/telemetry/attempt-meta.d.ts

@@ -12,8 +12,33 @@
  * enum/identifier/hash (length > 128 or containing whitespace).
  */
 import type { AdapterUsage, ProviderId } from "../types/provider";
+import type { OutputKind } from "../types/route";
+import type { ScreenReceipt } from "../screen/types";
 export type FinishReason = "stop" | "length" | "tool_calls" | "content_filter" | "refusal" | "error" | "other";
 export type ContextBucket = "≤4k" | "≤16k" | "≤64k" | "≤200k" | ">200k";
+/**
+ * How the rendered prompt reached the model on ONE attempt (GitLab issue #5,
+ * R1) — the proof surface for the cache-handle rule, stamped on
+ * `inferences.meta.prompt_delivery` by the adapter that made the call:
+ *   • `system`     — the rendered system prompt went as the provider's system
+ *                    instruction; the user turn carried the trigger / `prompt.user`.
+ *   • `user`       — no system instruction was sent because the rendered system
+ *                    prompt was EMPTY; the user turn alone carried the prompt.
+ *   • `user+cache` — a cache HANDLE was sent (Gemini `cachedContent`), so the
+ *                    system instruction could not be: everything rendered — the
+ *                    system prompt (if any), then the user turn — was delivered
+ *                    AS the user turn. Nothing was dropped.
+ * Stamped today by the Gemini adapter (the one provider where a handle changes
+ * delivery); absent on other providers' rows (⇒ delivered as declared).
+ */
+export type PromptDelivery = "system" | "user" | "user+cache";
+export declare const PROMPT_DELIVERIES: ReadonlySet<string>;
+/** The output contract a ROUTE-lane attempt was held to (issue #1 / plan §7.3,
+ * QA-S7): `json` (parsed + schema-checked) or `text` (returned verbatim). Same
+ * producer/enum pattern as {@link PromptDelivery}; stamped on
+ * `inferences.meta.output_kind` for every dispatched route-lane row, absent on
+ * raw-lane rows (the raw lane has no route contract). */
+export declare const OUTPUT_KINDS: ReadonlySet<string>;
 /** D1 egress receipt — shape RESERVED here; populated by the D1 mission. */
 export interface EgressReceiptV1 {
     readonly endpoint?: string;
@@ -26,6 +51,7 @@ export interface EgressReceiptV1 {
     readonly search_provider?: string;
     readonly tool_calls?: number;
 }
+export type ServedTierSource = "provider" | "requested_fallback";
 export interface AttemptMetaV1 {
     readonly v: 1;
     readonly finish_reason?: FinishReason;
@@ -50,6 +76,13 @@ export interface AttemptMetaV1 {
         readonly search_provider?: string;
     };
     readonly model_snapshot?: string;
+    /** Issue #2 (L6 F5): where `servedTier` came from — `provider` (the response
+     * echoed a tier: openai `service_tier`, gemini `serviceTier` /
+     * `usageMetadata.trafficType`) or `requested_fallback` (no echo; the adapter
+     * assumed the requested tier). Pricing reads the served tier, so a
+     * fallback-priced row is identifiable here. Absent on adapters without the
+     * signal. */
+    readonly served_tier_source?: ServedTierSource;
     readonly provider_request_id?: string;
     readonly http_status?: number;
     readonly error_code?: string;
@@ -65,8 +98,32 @@ export interface AttemptMetaV1 {
     /** sha256 of the RENDERED request — a hash, never content. */
     readonly input_hash?: string;
     readonly output_hash?: string;
+    /** R2 (issue #6): `sha256:<hex>` of the CANONICAL (sorted-key) JSON of the
+     * schema this attempt was asked to conform to — the raw lane's declared
+     * `responseSchema` today. A hash, never content; lets declared-vs-served
+     * schema drift be queried on `inferences.meta`. Absent ⇒ no schema declared. */
+    readonly schema_sha?: string;
     readonly context_bucket?: ContextBucket;
     readonly egress?: EgressReceiptV1;
+    /** LRE-2: the live A/B experiment arm this call was drawn onto (an identifier —
+     * `provider/model` or a variant/arm name), or absent for a non-experiment call.
+     * The A/B readout groups `inferences` by `meta.arm`. Meta-safe by construction
+     * (an identifier, no whitespace); a non-conforming value is dropped like any. */
+    readonly arm?: string;
+    /** Screening SC-1a receipt (spec §5) — the counts-only screen summary rides
+     * HERE, on `inferences.meta.screen`, so SC-1 adds ZERO migration (§8). Every
+     * field is an enum / count / hash (findings are `{detector,type,source,count}`
+     * with no-whitespace labels), so the classification rule and the server ingest
+     * backstop (`sanitizeMetaForWire`) pass it through intact. Produced by the
+     * single producer `summarizeScreen`; NEVER carries a matched value. Reserved &
+     * additive. */
+    readonly screen?: ScreenReceipt;
+    /** Issue #5 (R1): how the rendered prompt reached the model — see
+     * {@link PromptDelivery}. Absent ⇒ the adapter did not report it. */
+    readonly prompt_delivery?: PromptDelivery;
+    /** QA-S7 (issue #1, plan §7.3): the route's output contract on this attempt —
+     * `json` | `text`. Route lane only; absent on raw rows. */
+    readonly output_kind?: OutputKind;
 }
 export interface RunMetaV1 {
     readonly v: 1;
@@ -89,6 +146,8 @@ export interface AttemptMetaSource {
     readonly renderedRequest?: string;
     readonly outputText?: string | null;
     readonly declaredToolNames?: readonly string[];
+    /** QA-S7: the route's output contract (route lane only). */
+    readonly outputKind?: OutputKind;
 }
 /** Canonicalize the RENDERED request for `input_hash` (spec §2) — system + user
  * + schema, joined the SAME way in both lanes so a routed and a raw call with
@@ -111,14 +170,30 @@ export interface AttemptMetaInputs {
     readonly outputText?: string | null;
     /** Declared tool ids; any tool_call name NOT in this set is hashed. */
     readonly declaredToolNames?: readonly string[];
+    /** R2: the canonical schema sha (`sha256:<hex>`) to stamp on `meta.schema_sha`.
+     * Already a hash — gated by the classification rule like any identifier.
+     * Absent ⇒ no key ⇒ byte-identical to a schema-free row. */
+    readonly schemaSha?: string;
+    /** QA-S7: the route-lane output contract to stamp on `meta.output_kind`.
+     * Absent (the raw lane) ⇒ no key ⇒ byte-identical. */
+    readonly outputKind?: OutputKind;
     /** For the cost components (via src/run/cost.ts). */
     readonly provider?: ProviderId;
     readonly model?: string;
-    readonly usage?: Pick<AdapterUsage, "tokensIn" | "tokensOut" | "tokensCached" | "tokensCacheWrite" | "tokensCacheWrite1h">;
+    readonly usage?: Pick<AdapterUsage, "tokensIn" | "tokensOut" | "tokensCached" | "tokensCacheWrite" | "tokensCacheWrite1h"> & 
+    /** issue #2: the served tier, so `meta.cost` components price like the row. */
+    Partial<Pick<AdapterUsage, "servedTier">>;
     /** Whether the caller streamed deltas (run loop stream() path). */
     readonly streaming?: boolean;
     /** Repair-rung count carried by the run loop, if any. */
     readonly repairCount?: number;
+    /** LRE-2: the drawn A/B arm name (RunOptions.arm), stamped onto `meta.arm` when
+     * meta-safe. Absent ⇒ no `arm` key ⇒ byte-identical to a non-experiment call. */
+    readonly arm?: string;
+    /** SC-1a: the counts-only screen receipt to ride on `meta.screen`. Passed
+     * through verbatim (already counts/enums/hashes — no free text). Absent ⇒ no
+     * `screen` key ⇒ byte-identical to a non-screened row. */
+    readonly screen?: ScreenReceipt;
 }
 /** The classification-rule string test (spec §2, §5 wire backstop): a value is
  * an ENUM / IDENTIFIER / HASH only if it is at most 128 chars AND contains no

package/dist/telemetry/attempt-meta.d.ts.map

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

package/dist/telemetry/attempt-meta.js

@@ -13,7 +13,7 @@
  * enum/identifier/hash (length > 128 or containing whitespace).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESERVED_TAG_KEYS = void 0;
+exports.RESERVED_TAG_KEYS = exports.OUTPUT_KINDS = exports.PROMPT_DELIVERIES = void 0;
 exports.renderRequestForHash = renderRequestForHash;
 exports.isMetaSafeString = isMetaSafeString;
 exports.sanitizeMetaForWire = sanitizeMetaForWire;
@@ -26,6 +26,13 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const cost_1 = require("../run/cost");
 const config_1 = require("../config");
+exports.PROMPT_DELIVERIES = new Set(["system", "user", "user+cache"]);
+/** The output contract a ROUTE-lane attempt was held to (issue #1 / plan §7.3,
+ * QA-S7): `json` (parsed + schema-checked) or `text` (returned verbatim). Same
+ * producer/enum pattern as {@link PromptDelivery}; stamped on
+ * `inferences.meta.output_kind` for every dispatched route-lane row, absent on
+ * raw-lane rows (the raw lane has no route contract). */
+exports.OUTPUT_KINDS = new Set(["json", "text"]);
 /** Canonicalize the RENDERED request for `input_hash` (spec §2) — system + user
  * + schema, joined the SAME way in both lanes so a routed and a raw call with
  * the identical prompt+schema hash identically (lane parity, spec §6.3). The
@@ -234,10 +241,35 @@ function summarizeAttemptMeta(inputs) {
             meta.finish_reason = a.finish_reason;
         if (typeof a.refusal === "boolean")
             meta.refusal = a.refusal;
+        if (a.served_tier_source === "provider" || a.served_tier_source === "requested_fallback") {
+            meta.served_tier_source = a.served_tier_source;
+        }
         if (typeof a.streaming === "boolean")
             meta.streaming = a.streaming;
         else if (typeof inputs.streaming === "boolean")
             meta.streaming = inputs.streaming;
+        // LRE-2 A/B arm — an identifier, gated by the classification rule (absent ⇒
+        // no key ⇒ byte-identical to a non-experiment row).
+        if (isMetaSafeString(inputs.arm))
+            meta.arm = inputs.arm;
+        // R2 declared-schema hash — a `sha256:` string (71 chars, no whitespace).
+        if (isMetaSafeString(inputs.schemaSha))
+            meta.schema_sha = inputs.schemaSha;
+        // SC-1a screen receipt (spec §5, §8) — the counts-only screen summary rides
+        // on meta.screen (ZERO migration). Already counts/enums/hashes; passed
+        // through verbatim (absent ⇒ no key ⇒ byte-identical to a non-screened row).
+        if (inputs.screen !== undefined)
+            meta.screen = inputs.screen;
+        // Issue #5 (R1): prompt delivery — an enum our adapters produce; anything
+        // outside the vocabulary is dropped (absent ⇒ no key ⇒ byte-identical).
+        if (typeof a.prompt_delivery === "string" && exports.PROMPT_DELIVERIES.has(a.prompt_delivery)) {
+            meta.prompt_delivery = a.prompt_delivery;
+        }
+        // QA-S7: route-lane output contract — the same enum discipline; anything
+        // outside `json` | `text` is dropped (absent ⇒ no key ⇒ byte-identical).
+        if (typeof inputs.outputKind === "string" && exports.OUTPUT_KINDS.has(inputs.outputKind)) {
+            meta.output_kind = inputs.outputKind;
+        }
         // Externally-sourced identifiers — gated by the classification rule.
         if (isMetaSafeString(a.model_snapshot))
             meta.model_snapshot = a.model_snapshot;

package/dist/telemetry/exporter-setup.d.ts

@@ -19,6 +19,8 @@ export interface ExporterSetupExtras {
     readonly artifactStore: ArtifactStore | null;
     /** E4 chunk 0: retry 404'd content after a confirmed artifacts flush. */
     readonly onArtifactsFlushed?: () => Promise<void>;
+    /** `createRig({ expectOrg })` (M5) — threaded to the api sink's org line. */
+    readonly expectOrg?: string;
 }
 /**
  * Construct the sink for the configured mode, wire the exporter, and start its

package/dist/telemetry/exporter-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exporter-setup.d.ts","sourceRoot":"","sources":["../../src/telemetry/exporter-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtD,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,yEAAyE;IACzE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,wBAAwB,EACnC,YAAY,EAAE,eAAe,GAAG,kBAAkB,EAClD,MAAM,EAAE,mBAAmB,GAC1B,QAAQ,CAiBV"}
+{"version":3,"file":"exporter-setup.d.ts","sourceRoot":"","sources":["../../src/telemetry/exporter-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtD,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,yEAAyE;IACzE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,wBAAwB,EACnC,YAAY,EAAE,eAAe,GAAG,kBAAkB,EAClD,MAAM,EAAE,mBAAmB,GAC1B,QAAQ,CAyBV"}

package/dist/telemetry/exporter-setup.js

@@ -10,13 +10,14 @@ exports.startTelemetryExporter = startTelemetryExporter;
 const node_os_1 = require("node:os");
 const exporter_1 = require("./exporter");
 const sinks_1 = require("./sinks");
+const route_registration_1 = require("./route-registration");
 /**
  * Construct the sink for the configured mode, wire the exporter, and start its
  * flush loop. Returns the running exporter (the caller stops it on close()).
  */
 function startTelemetryExporter(telemetry, exportConfig, extras) {
     const sourceId = exportConfig.sourceId ?? (0, node_os_1.hostname)();
-    const sink = (0, sinks_1.buildTelemetrySink)(exportConfig, sourceId);
+    const sink = (0, sinks_1.buildTelemetrySink)(exportConfig, sourceId, extras.expectOrg !== undefined ? { expectOrg: extras.expectOrg } : {});
     const exporter = (0, exporter_1.createTelemetryExporter)(telemetry, {
         sink,
         sourceId,
@@ -30,5 +31,9 @@ function startTelemetryExporter(telemetry, exportConfig, extras) {
         ...(extras.onArtifactsFlushed !== undefined ? { onArtifactsFlushed: extras.onArtifactsFlushed } : {}),
     });
     exporter.start();
+    // RV-1 declare-on-startup: the declared routes (metadata + bundle) go out now,
+    // fire-and-forget, so a route is visible before its first call / first flush.
+    // Never awaited, never throws — createRig cannot block or fail on it.
+    void (0, route_registration_1.registerRoutesOnStartup)(sink, sourceId, extras.routes);
     return exporter;
 }

package/dist/telemetry/exporter.d.ts

@@ -83,8 +83,8 @@ export interface ExporterConfig {
     readonly artifacts?: boolean;
     /** The local artifact-metadata buffer (chunk B). A SEPARATE handle from the
      * telemetry store; present only when the namespace is enabled. Its rows ride
-     * the `:artifacts`/`:edges`/`:evals` watermark streams (watermarks live in the
-     * main store's export_state, rows are read from here). */
+     * the `:artifacts`/`:edges`/`:eval_cases` watermark streams (watermarks live in
+     * the main store's export_state, rows are read from here). */
     readonly artifactStore?: ArtifactStore;
     /**
      * Post-flush hook fired AFTER a confirmed export of the artifacts stream (E4

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

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