modelrig 0.11.1 → 0.12.0

package/dist/run/record-attempt.js

@@ -75,12 +75,16 @@ function createRecordAttempt(deps) {
         const isPrimary = attempt.repairedBy === undefined;
         const cacheStamp = isPrimary ? (0, cache_stamp_1.cacheStampForCandidate)(route, attempt.candidate) : null;
         // The customer key marks rows whose REQUEST carried the handle. A terminal
-        // failure (budget_exhausted / invariant_violation) is recorded by failRun
-        // BEFORE any dispatch — the wire never carried the handle — so those rows
-        // must not claim a customer key. Terminal classes come only from failRun;
-        // adapters never return them. (A grounding-search failure is the one
-        // non-terminal pre-dispatch path, but a customer cachedContents handle and
-        // the inject rung are mutually exclusive, so it is unreachable in practice.)
+        // failure (budget_exhausted / invariant_violation) is always a PRE-DISPATCH
+        // outcome — the wire never carried the handle — so those rows must not claim
+        // a customer key. Terminal classes come from failRun, and from adapter guards
+        // that refuse BEFORE building a provider client (gemini's non-thinking-model
+        // `reasoning` guard; the ARC-β messages-lane history guards in anthropic.ts /
+        // gemini.ts, which the run loop normally pre-empts by skipping incompatible
+        // candidates — run/messages.ts). No adapter returns a terminal class after a
+        // provider call. (A grounding-search failure is the one non-terminal
+        // pre-dispatch path, but a customer cachedContents handle and the inject rung
+        // are mutually exclusive, so it is unreachable in practice.)
         const preDispatch = attempt.failure !== null && failures_1.TERMINAL_CLASSES.has(attempt.failure.class);
         const dropped = droppedCacheHandle.has(`${attempt.candidate.provider} ${attempt.candidate.model}`);
         const customer = isPrimary && !preDispatch ? (0, cache_handle_1.customerCacheHandle)(cache, attempt.candidate, dropped) : null;
@@ -183,6 +187,12 @@ function createRecordAttempt(deps) {
                 startedAt: row.ts,
                 endedAt: new Date().toISOString(),
                 failureClass: row.failureClass,
+                // ARC-5: cost + requested tool calls feed the run-limit tally (a success
+                // with no tool call breaks a repeat streak; a failure leaves it as is).
+                costUsd: row.costEstimateUsd,
+                ...(attempt.toolCalls !== undefined
+                    ? { toolCalls: attempt.toolCalls.map((t) => ({ name: t.function.name, arguments: t.function.arguments })) }
+                    : attempt.failure === null ? { toolCalls: [] } : {}),
             });
         }
         return row.id;

package/dist/run/record-call.d.ts

@@ -25,6 +25,7 @@
  * No route/registry/capability-gate dependency beyond the raw lane's own (cost
  * + telemetry + run context) — the raw lane's no-hard-hot-path invariant holds.
  */
+import { type RecordedUnits } from "../telemetry/attempt-meta";
 import type { FailureClass } from "../types/failures";
 import type { ProviderId, ServiceTier } from "../types/provider";
 import type { RunTags } from "../types/route";
@@ -50,7 +51,16 @@ export interface RecordCallInput {
      * recorded at $0 with `pricingMissing: true`. */
     readonly provider: ProviderId | (string & {});
     readonly model: string;
+    /** Token usage. A generation call billed per image/second/character reports
+     * `{ tokensIn: 0, tokensOut: 0 }` and its `units`. */
     readonly usage: RecordCallUsage;
+    /** ARC-4: the call's non-token units — images generated, seconds of audio or
+     * video, characters synthesized, diffusion steps. Non-negative finite
+     * numbers; at least one must be > 0 when the token counts are all zero.
+     * Recorded on `meta.units` and priced from the registry, then the vendored
+     * pricing map, else `pricingMissing` (never from token rates). `steps` is
+     * recorded, never priced. */
+    readonly units?: RecordedUnits;
     /** The tier that SERVED the call — the row is priced at it (flex is cheaper),
      * exactly as the raw lane prices. Default `"standard"`. */
     readonly servedTier?: ServiceTier;
@@ -76,8 +86,9 @@ export interface RecordCallResult {
      * was rejected and nothing was recorded. */
     readonly inferenceId: string | null;
     readonly callId: string | null;
-    /** The token row's list-price cost (a `webSearchCalls` surcharge rides its own
-     * row, as on the raw lane). 0 when unpriced or rejected. */
+    /** The row's list-price cost — tokens plus any priced `units` (a
+     * `webSearchCalls` surcharge rides its own row, as on the raw lane). 0 when
+     * unpriced or rejected. */
     readonly costEstimateUsd: number;
     readonly pricingMissing: boolean;
 }

package/dist/run/record-call.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-call.d.ts","sourceRoot":"","sources":["../../src/run/record-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAgB,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,2FAA2F;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,2CAA2C,CAAC;AAE7E;;;;gFAIgF;AAChF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B;qDACiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC;+DAC2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C;8EAC0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;sDACkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B;gDAC4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;gEAC4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAQD,kGAAkG;AAClG,eAAO,MAAM,eAAe,MAAM,CAAC;AAcnC,wDAAwD;AACxD,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAMD,+EAA+E;AAC/E,eAAO,MAAM,MAAM,aAAgB,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AA6GD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAarF"}
+{"version":3,"file":"record-call.d.ts","sourceRoot":"","sources":["../../src/run/record-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AASH,OAAO,EAAsF,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGnJ,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAgB,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,2FAA2F;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,2CAA2C,CAAC;AAE7E;;;;gFAIgF;AAChF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B;qDACiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;0DACsD;IACtD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC;;;;;iCAK6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B;+DAC2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C;8EAC0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;sDACkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B;gDAC4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;+BAE2B;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAQD,kGAAkG;AAClG,eAAO,MAAM,eAAe,MAAM,CAAC;AAcnC,wDAAwD;AACxD,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAMD,+EAA+E;AAC/E,eAAO,MAAM,MAAM,aAAgB,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AA4ID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAarF"}

package/dist/run/record-call.js

@@ -117,6 +117,9 @@ function validateShape(input) {
             fix: `shorten the provider or model id so "provider/model" is at most ${exports.MAX_ROUTE_CHARS} characters`,
         };
     }
+    const unitsProblem = validateUnits(i.units, i.usage);
+    if (unitsProblem !== null)
+        return unitsProblem;
     const u = i.usage;
     if (typeof u !== "object" || u === null || !isCount(u.tokensIn) || !isCount(u.tokensOut)) {
         return {
@@ -174,6 +177,34 @@ function validateShape(input) {
     }
     return null;
 }
+const UNIT_KEY_SET = new Set(attempt_meta_1.UNIT_KEYS);
+/** ARC-4 `units` rules. Every fix string is built from SDK constants only (it
+ * doubles as the warning-latch rule id). */
+function validateUnits(units, usage) {
+    if (units === undefined)
+        return null;
+    if (typeof units !== "object" || units === null || Array.isArray(units)) {
+        return { problem: "units is not an object", fix: `pass units as { ${attempt_meta_1.UNIT_KEYS.join("?, ")}? } numbers, or omit it` };
+    }
+    for (const [k, v] of Object.entries(units)) {
+        if (!UNIT_KEY_SET.has(k)) {
+            return { problem: "units carries an unknown key", fix: `units keys are ${attempt_meta_1.UNIT_KEYS.join(", ")}` };
+        }
+        if (v !== undefined && !isCount(v)) {
+            return { problem: `units.${k} is not a non-negative number`, fix: `omit units.${k} or pass a finite number ≥ 0` };
+        }
+    }
+    const u = (typeof usage === "object" && usage !== null ? usage : {});
+    const tokensZero = tok(u.tokensIn) === 0 && tok(u.tokensOut) === 0;
+    const anyUnit = Object.values(units).some((v) => typeof v === "number" && v > 0);
+    if (tokensZero && !anyUnit) {
+        return {
+            problem: "units are all zero and the call reports no tokens",
+            fix: "report what the call produced — e.g. units: { images: 1 } for one generated image, { seconds: 8 } for an 8 s clip, { characters: 1200 } for a TTS request",
+        };
+    }
+    return null;
+}
 /** Normalize a caller finish reason: an enum value passes; a provider-native one
  * maps through the adapters' own table; empty ⇒ absent. */
 function finishReasonOf(provider, raw) {
@@ -212,21 +243,31 @@ function record(deps, input) {
     const servedTier = input.servedTier ?? "standard";
     const requestedTier = input.requestedTier ?? servedTier;
     // MUST-3: integers only on the row (rounded + clamped — see toCount).
+    const reported = input.usage;
     const usage = {
-        tokensIn: tok(input.usage.tokensIn),
-        tokensOut: tok(input.usage.tokensOut),
-        tokensCached: tok(input.usage.tokensCached),
-        ...(input.usage.tokensCacheWrite !== undefined ? { tokensCacheWrite: tok(input.usage.tokensCacheWrite) } : {}),
+        tokensIn: tok(reported.tokensIn),
+        tokensOut: tok(reported.tokensOut),
+        tokensCached: tok(reported.tokensCached),
+        ...(reported.tokensCacheWrite !== undefined ? { tokensCacheWrite: tok(reported.tokensCacheWrite) } : {}),
         servedTier,
         ...(input.ttfbMs !== undefined ? { ttfbMs: toCount(input.ttfbMs, exports.MAX_MS) } : {}),
     };
     const latencyMs = toCount(input.latencyMs, exports.MAX_MS);
+    const units = (0, attempt_meta_1.cleanUnits)(input.units);
     // Priced exactly like the raw lane: list price at the SERVED tier. A provider
     // ModelRig has no price table for is recorded honestly at $0, flagged.
     const unpricedRatePerTok = (deps.unpricedRateUsdPerMTok ?? cost_1.DEFAULT_UNPRICED_RATE_USD_PER_MTOK) / 1000000;
-    const { costUsd, pricingMissing } = known
+    const tokenCost = known
         ? (0, cost_1.attemptCost)(provider, input.model, usage, unpricedRatePerTok)
         : { costUsd: 0, pricingMissing: true };
+    // ARC-4: units price separately (registry → pricing map → missing; never from
+    // token rates) and ADD to the token cost. With units present, a zero-token
+    // call's token price is moot, so only nonzero tokens can flag it missing.
+    // No units ⇒ exactly the token path (byte-identical).
+    const unitCost = units !== undefined ? (0, cost_1.estimateUnitCostUsd)(provider, input.model, units) : null;
+    const tokensReported = usage.tokensIn > 0 || usage.tokensOut > 0;
+    const costUsd = tokenCost.costUsd + (unitCost?.costUsd ?? 0);
+    const pricingMissing = unitCost === null ? tokenCost.pricingMissing : unitCost.pricingMissing || (tokensReported && tokenCost.pricingMissing);
     // Tags: caller tags + the ambient step/run_id (same order as finalizeRaw), then
     // the SDK-owned markers LAST so a caller value cannot override them.
     const stepTag = step !== null ? { step: step.stepKey } : {};
@@ -240,7 +281,7 @@ function record(deps, input) {
     const adapterMeta = {
         ...(finishReason !== undefined ? { finish_reason: finishReason } : {}),
         ...(input.providerRequestId !== undefined ? { provider_request_id: input.providerRequestId } : {}),
-        ...(input.usage.reasoningTokens !== undefined ? { reasoning_tokens: tok(input.usage.reasoningTokens) } : {}),
+        ...(reported.reasoningTokens !== undefined ? { reasoning_tokens: tok(reported.reasoningTokens) } : {}),
     };
     // No rendered request and no output text: ModelRig never saw the content, so
     // there is no input/output hash. Cost components only for a priced provider.
@@ -249,6 +290,8 @@ function record(deps, input) {
         provenance: "caller-reported",
         ...(known ? { provider: provider, model: input.model } : {}),
         usage,
+        ...(units !== undefined ? { units } : {}),
+        ...(unitCost !== null && unitCost.costUsd > 0 ? { unitCostUsd: unitCost.costUsd } : {}),
     });
     const id = (0, node_crypto_1.randomUUID)();
     const callId = (0, node_crypto_1.randomUUID)();
@@ -268,7 +311,7 @@ function record(deps, input) {
         callId,
         meta,
     });
-    (0, raw_finalize_1.emitRawStep)(step, input.tags?.step ?? rawModelId, id, failureClass);
+    (0, raw_finalize_1.emitRawStep)(step, input.tags?.step ?? rawModelId, id, failureClass, { costUsd }); // ARC-5: accumulates toward run limits (cannot prevent — the next dispatch throws)
     const searchCalls = input.webSearchCalls ?? 0;
     if (searchCalls >= 1) {
         (0, raw_search_cost_1.recordRawSearchCostRow)(deps.telemetry, { provider, rawModelId, tags, callId, searchCalls });

package/dist/run/run.d.ts.map

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

package/dist/run/run.js

@@ -36,6 +36,7 @@ const quality_gate_1 = require("./quality-gate");
 const accept_1 = require("./accept");
 const run_context_1 = require("../artifacts/run-context");
 const capture_write_1 = require("./capture-write");
+const messages_1 = require("./messages");
 /** Phase 1 prompt convention: the bundle's system template carries the whole
  * task (constitution, data, step instructions); the user turn is a terse
  * trigger. Providers treat long system prompts + short user turns well, and
@@ -65,12 +66,14 @@ async function run(deps, routeName, opts) {
     const baseRoute = deps.routes.get(routeName);
     const variant = (0, variant_1.resolveVariant)(baseRoute, opts.variant, mode);
     const servedVariant = variant?.name ?? null;
-    const route = (0, resolve_1.applyRunRequirements)((0, variant_1.effectiveRoute)(baseRoute, variant), opts.zeroRetention === true);
+    const requiredRoute = (0, resolve_1.applyRunRequirements)((0, variant_1.effectiveRoute)(baseRoute, variant), opts.zeroRetention === true);
+    const { history, route, skipTag } = (0, messages_1.routedHistory)(requiredRoute, opts); // ARC-β messages lane (run/messages.ts): no history ⇒ same route, byte-identical; R2-2 skips incompatible candidates
     const destination = (0, resolve_destination_1.resolveDestination)(route.destination, opts.destination); // U2 (D-2): RunOptions > route > `direct`. Guard runs below, once the serving provider is resolved (U3).
     // RC-1: inside a run context the SDK stamps `run_id` (episodeKey, else run id)
     // when the caller passed none — the bridge between tags and the run graph.
     const runCtx = (0, run_context_1.getActiveRunContext)();
-    const runTags = (0, run_context_1.withRunIdTag)(opts.tags, runCtx);
+    (0, run_context_1.enforceRunLimits)(); // ARC-5: pre-dispatch run-limit check (throws RunLimitExceeded; no-op without limits)
+    const runTags = (0, messages_1.withSkipTag)((0, run_context_1.withRunIdTag)(opts.tags, runCtx), skipTag);
     const effectiveTags = route.require.includes("zero_retention") ? { ...runTags, zdr_enforced: "true" } : runTags;
     // Data-hygiene warning (spec WS5): once per process per dimension.
     (0, manifest_1.warnMissingRequiredDimensions)(deps.manifest ?? null, effectiveTags);
@@ -96,7 +99,7 @@ async function run(deps, routeName, opts) {
     // Capture-WRITE gate (settings-plane §1.5, closes gate 5): the control-plane
     // capture flag wins over the YAML flag, the task's scrub setting is honored,
     // and capture OFF is a no-op writer (byte-identical). See ./capture-write.ts.
-    const captureAttempt = (0, capture_write_1.buildCaptureWriter)(deps.settings ?? null, deps.captures, route, opts.input);
+    const captureAttempt = (0, capture_write_1.buildCaptureWriter)(deps.settings ?? null, deps.captures, route, (0, messages_1.captureInputFor)(opts.input, history, opts));
     const droppedCacheHandle = new Set(); // CE-1 retry-drop (spec §2.2)
     // Per-attempt telemetry recorder (extracted to ./record-attempt.ts — WS-A,
     // to keep run.ts under the LOC cap and shrink the run-loop conflict surface).
@@ -210,7 +213,8 @@ async function run(deps, routeName, opts) {
         // Issue #5 (R1): the user turn — the route's `prompt.user` when declared
         // (rendered with the SAME context, so an untrusted variable is removed from
         // it too and arrives via the spotlight block), else the fixed trigger.
-        const userPrompt = userTurnFor(route, renderCtx);
+        const userPrompt = history !== undefined ? (0, messages_1.messagesUserTurn)(route, renderCtx) : userTurnFor(route, renderCtx);
+        const metaUser = (0, messages_1.userSideForHash)(userPrompt, history); // ARC-β: the envelope hash covers the history
         // Variant augmentation (WS1): appended after capability-conditionals,
         // before json coaching — promptAppend first, then the reasoning scaffold.
         if (variant?.promptAppend !== undefined) {
@@ -274,7 +278,7 @@ async function run(deps, routeName, opts) {
         // pricing snapshot (prompt-length input + full output budget).
         if (guard !== null) {
             // A1: an unpriced model must never precheck at $0 (fail closed).
-            const breach = guard.precheck((0, cost_1.dispatchEstimateUsd)(candidate.provider, candidate.model, systemPrompt.length + userPrompt.length, unpricedRatePerTok));
+            const breach = guard.precheck((0, cost_1.dispatchEstimateUsd)(candidate.provider, candidate.model, systemPrompt.length + userPrompt.length + (0, messages_1.historyChars)(history), unpricedRatePerTok));
             if (breach !== null) {
                 failRun(candidate, breach, 0);
             }
@@ -308,11 +312,11 @@ async function run(deps, routeName, opts) {
                     servedVariant,
                     pricingMissing,
                     callId: ladder.callId, destination,
-                    metaInputs: (0, dispatch_1.attemptMetaInputs)({ systemPrompt, userDirective: userPrompt, outputSchema: route.outputSchema, outputKind: route.outputKind, result, tools: opts.tools }),
+                    metaInputs: (0, dispatch_1.attemptMetaInputs)({ systemPrompt, userDirective: metaUser, outputSchema: route.outputSchema, outputKind: route.outputKind, result, tools: opts.tools }),
                 });
             }
             const outcome = (0, validate_1.validateOutput)(route, result.text);
-            const metaInputs = (0, dispatch_1.attemptMetaInputs)({ systemPrompt, userDirective: userPrompt, outputSchema: route.outputSchema, outputKind: route.outputKind, result, tools: opts.tools });
+            const metaInputs = (0, dispatch_1.attemptMetaInputs)({ systemPrompt, userDirective: metaUser, outputSchema: route.outputSchema, outputKind: route.outputKind, result, tools: opts.tools });
             if (outcome.valid) {
                 // Q1 quality gate (spec §4.1): a schema-valid output must still clear the
                 // builder's bar before it is accepted. Tool-call turns never reach here;
@@ -432,7 +436,7 @@ async function run(deps, routeName, opts) {
             ...(result.usage?.ttfbMs !== undefined ? { ttfbMs: result.usage.ttfbMs } : {}),
             failure,
             pricingMissing: failurePricingMissing,
-            metaInputs: (0, dispatch_1.attemptMetaInputs)({ systemPrompt, userDirective: userPrompt, outputSchema: route.outputSchema, outputKind: route.outputKind, result, tools: opts.tools }),
+            metaInputs: (0, dispatch_1.attemptMetaInputs)({ systemPrompt, userDirective: metaUser, outputSchema: route.outputSchema, outputKind: route.outputKind, result, tools: opts.tools }),
         });
         if (failures_1.TERMINAL_CLASSES.has(failure.class)) {
             throw new failures_1.RigFailureError(failure);

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

@@ -130,16 +130,58 @@ export interface AttemptMetaV1 {
      * ModelRig dispatched the attempt and measured it (every other row). Additive
      * — no version bump. */
     readonly provenance?: AttemptProvenance;
+    /** ARC-4 (ARC-γ): the call's non-token units (`rig.recordCall({ units })`) —
+     * numbers only, keys from {@link UNIT_KEYS}. Additive, no column (zero DDL):
+     * rides `inferences.meta.units`. Absent ⇒ a token-only call. */
+    readonly units?: RecordedUnits;
 }
 /** OBS-1: the one non-default provenance value (see {@link AttemptMetaV1.provenance}). */
 export type AttemptProvenance = "caller-reported";
+/** ARC-4 (ARC-γ): the non-token units a generation call is billed in — the ONE
+ * list. `rig.recordCall({ units })` validates against it, `meta.units` carries
+ * exactly these keys, and unit pricing (run/cost.ts) prices from it (the drift
+ * test pins all three). `steps` is recorded but never priced: no source we
+ * vendor publishes a per-step rate (L5). */
+export declare const UNIT_KEYS: readonly ["images", "seconds", "characters", "steps"];
+export type UnitKey = (typeof UNIT_KEYS)[number];
+/** Non-negative finite counts of a call's non-token units (ARC-4). */
+export type RecordedUnits = {
+    readonly [K in UnitKey]?: number;
+};
+/** The units envelope, cleaned: only {@link UNIT_KEYS}, only finite numbers
+ * ≥ 0. Returns undefined when nothing survives (absent ⇒ no `units` key). */
+export declare function cleanUnits(raw: unknown): RecordedUnits | undefined;
+/** The `RunMeta.trigger` vocabulary (WI-1 + ARC-1 `conversation`, set by
+ * `rig.conversation`). The ONE list — the type and its drift test read it. */
+export declare const RUN_TRIGGERS: readonly ["cron", "api", "manual", "replay", "other", "conversation"];
+export type RunTrigger = (typeof RUN_TRIGGERS)[number];
+/** ARC-5: the `RunMeta.failure_reason` values a run-limit breach writes —
+ * `limit:<which>`, one per `RunLimits` field (run/limits.ts). Other reasons are
+ * caller-supplied identifiers (R9). */
+export declare const LIMIT_FAILURE_REASONS: readonly ["limit:max_usd", "limit:max_calls", "limit:max_wall_ms", "limit:max_repeat_tool_call"];
+export type LimitFailureReason = (typeof LIMIT_FAILURE_REASONS)[number];
 export interface RunMetaV1 {
     readonly v: 1;
     readonly pipeline_sha?: string;
     readonly config_hash?: string;
-    readonly trigger?: "cron" | "api" | "manual" | "replay" | "other";
+    readonly trigger?: RunTrigger;
     readonly actor?: string;
     readonly input_hash?: string;
+    /**
+     * R9 (InferWealth report integrity, 2026-10-22): the run's failure reason —
+     * an identifier (e.g. a gate code `eps_integrity_failure`), set only when the
+     * run ends `failed` via `run.end("failed", { failureReason })` or
+     * `run.setFailureReason()`. `run-outcome@v1` labels a failed run with it.
+     */
+    readonly failure_reason?: string;
+    /** ARC-5: the run's limits as set on run.start / rig.conversation (snake_case
+     * numbers). Additive; absent when no limits were set. */
+    readonly limits?: {
+        readonly max_usd?: number;
+        readonly max_calls?: number;
+        readonly max_wall_ms?: number;
+        readonly max_repeat_tool_call?: number;
+    };
 }
 /**
  * The per-attempt content the RECORDER carries from the run/raw loop to the
@@ -205,6 +247,12 @@ export interface AttemptMetaInputs {
     /** OBS-1: stamp `meta.provenance` (`rig.recordCall` rows only). Absent ⇒ no
      * key ⇒ byte-identical to every dispatched row. */
     readonly provenance?: AttemptProvenance;
+    /** ARC-4: the call's non-token units, stamped on `meta.units` after
+     * {@link cleanUnits}. Absent ⇒ no key ⇒ byte-identical. */
+    readonly units?: RecordedUnits;
+    /** ARC-4: the unit cost (USD) already priced for this call — added to
+     * `meta.cost.other` so the components still sum to the row. Absent ⇒ 0. */
+    readonly unitCostUsd?: number;
 }
 /** 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,8 @@
  * enum/identifier/hash (length > 128 or containing whitespace).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESERVED_TAG_KEYS = exports.OUTPUT_KINDS = exports.PROMPT_DELIVERIES = void 0;
+exports.RESERVED_TAG_KEYS = exports.LIMIT_FAILURE_REASONS = exports.RUN_TRIGGERS = exports.UNIT_KEYS = exports.OUTPUT_KINDS = exports.PROMPT_DELIVERIES = void 0;
+exports.cleanUnits = cleanUnits;
 exports.renderRequestForHash = renderRequestForHash;
 exports.isMetaSafeString = isMetaSafeString;
 exports.sanitizeMetaForWire = sanitizeMetaForWire;
@@ -33,6 +34,37 @@ exports.PROMPT_DELIVERIES = new Set(["system", "user", "user+cache"]);
  * `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"]);
+/** ARC-4 (ARC-γ): the non-token units a generation call is billed in — the ONE
+ * list. `rig.recordCall({ units })` validates against it, `meta.units` carries
+ * exactly these keys, and unit pricing (run/cost.ts) prices from it (the drift
+ * test pins all three). `steps` is recorded but never priced: no source we
+ * vendor publishes a per-step rate (L5). */
+exports.UNIT_KEYS = ["images", "seconds", "characters", "steps"];
+/** The units envelope, cleaned: only {@link UNIT_KEYS}, only finite numbers
+ * ≥ 0. Returns undefined when nothing survives (absent ⇒ no `units` key). */
+function cleanUnits(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return undefined;
+    const out = {};
+    for (const key of exports.UNIT_KEYS) {
+        const v = raw[key];
+        if (typeof v === "number" && Number.isFinite(v) && v >= 0)
+            out[key] = v;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/** The `RunMeta.trigger` vocabulary (WI-1 + ARC-1 `conversation`, set by
+ * `rig.conversation`). The ONE list — the type and its drift test read it. */
+exports.RUN_TRIGGERS = ["cron", "api", "manual", "replay", "other", "conversation"];
+/** ARC-5: the `RunMeta.failure_reason` values a run-limit breach writes —
+ * `limit:<which>`, one per `RunLimits` field (run/limits.ts). Other reasons are
+ * caller-supplied identifiers (R9). */
+exports.LIMIT_FAILURE_REASONS = [
+    "limit:max_usd",
+    "limit:max_calls",
+    "limit:max_wall_ms",
+    "limit:max_repeat_tool_call",
+];
 /** 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
@@ -273,6 +305,10 @@ function summarizeAttemptMeta(inputs) {
         // OBS-1: caller-reported provenance — an enum; anything else is dropped.
         if (inputs.provenance === "caller-reported")
             meta.provenance = inputs.provenance;
+        // ARC-4: non-token units — numbers only, known keys only.
+        const units = cleanUnits(inputs.units);
+        if (units !== undefined)
+            meta.units = units;
         // Externally-sourced identifiers — gated by the classification rule.
         if (isMetaSafeString(a.model_snapshot))
             meta.model_snapshot = a.model_snapshot;
@@ -346,6 +382,14 @@ function summarizeAttemptMeta(inputs) {
             if (cost !== null)
                 meta.cost = cost;
         }
+        // ARC-4: a priced unit cost rides `other` (reserved for it), so the
+        // components sum to the recorded row. A unit-only call (no token price)
+        // gets an all-zero token block plus `other`.
+        const unitCost = num(inputs.unitCostUsd);
+        if (unitCost !== undefined && unitCost > 0) {
+            const base = meta.cost ?? { in: 0, out: 0, cache_read: 0, cache_write: 0, other: 0 };
+            meta.cost = { ...base, other: (base.other ?? 0) + unitCost };
+        }
         return meta;
     }
     catch {

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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"}

package/dist/telemetry/exporter.js

@@ -301,8 +301,9 @@ function createTelemetryExporter(store, config) {
             poisonState.delete(stream);
             poisonSkipped[stream] = (poisonSkipped[stream] ?? 0) + rowCount;
             const status = err instanceof sinks_1.SinkSendError ? err.status : undefined;
+            const reason = err instanceof sinks_1.SinkSendError && err.reasonCode !== null ? `, reason ${err.reasonCode}` : "";
             console.warn(`[modelrig exporter] POISON-SKIP: stream "${stream}" batch at watermark ${watermark} ` +
-                `(${rowCount} row(s), status ${status ?? "network"}) was rejected deterministically ` +
+                `(${rowCount} row(s), status ${status ?? "network"}${reason}) was rejected deterministically ` +
                 `${POISON_SKIP_THRESHOLD}× running — advancing the watermark PAST it WITHOUT writing. ` +
                 `These rows are dropped and will NOT be retried; investigate the rejection and backfill.`);
             return "skip";

package/dist/telemetry/grade-mappers.d.ts

@@ -15,7 +15,7 @@ export declare function toWireGrade(row: GradeRow): WireGrade;
  * (F4) is deliberately destructured OUT here: `public.grades` has no criteria
  * column — the per-criterion breakdown fans out to `grade_criteria` in a
  * separate best-effort write at the ingest boundary, keyed to this grade's id. */
-export declare function gradeToRow({ org_id, criteria: _criteria, ...g }: WireGrade, tenancy: Tenancy): Record<string, unknown>;
+export declare function gradeToRow({ org_id, criteria: _criteria, idempotency_key: _idem, ...g }: WireGrade, tenancy: Tenancy): Record<string, unknown>;
 /**
  * Grades naming an org other than the presented key's. The ingest endpoint drops
  * and COUNTS these so a caller cannot file a judgment into another tenant's corpus

package/dist/telemetry/grade-mappers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grade-mappers.d.ts","sourceRoot":"","sources":["../../src/telemetry/grade-mappers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;2EAC2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,CAmBpD;AAED;;;kFAGkF;AAClF,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBtH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAEhG"}
+{"version":3,"file":"grade-mappers.d.ts","sourceRoot":"","sources":["../../src/telemetry/grade-mappers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;2EAC2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,CAsBpD;AAED;;;kFAGkF;AAClF,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB9I;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAEhG"}

package/dist/telemetry/grade-mappers.js

@@ -30,13 +30,16 @@ function toWireGrade(row) {
         // F4: mirror the per-criterion breakdown iff present (spread-iff — a
         // single-score grade's wire shape is byte-identical to pre-F4).
         ...(row.criteria !== undefined ? { criteria: row.criteria } : {}),
+        // ARC-3: the outcome's raw value rides iff set (non-outcome wire unchanged).
+        ...(row.value !== undefined && row.value !== null ? { value: row.value } : {}),
+        ...(row.idempotencyKey !== undefined ? { idempotency_key: row.idempotencyKey } : {}),
     };
 }
 /** WireGrade → a grades row (the SDK's sole judgment write path). `criteria`
  * (F4) is deliberately destructured OUT here: `public.grades` has no criteria
  * column — the per-criterion breakdown fans out to `grade_criteria` in a
  * separate best-effort write at the ingest boundary, keyed to this grade's id. */
-function gradeToRow({ org_id, criteria: _criteria, ...g }, tenancy) {
+function gradeToRow({ org_id, criteria: _criteria, idempotency_key: _idem, ...g }, tenancy) {
     return {
         org_id: org_id ?? tenancy.org_id,
         project_id: tenancy.project_id,
@@ -52,6 +55,9 @@ function gradeToRow({ org_id, criteria: _criteria, ...g }, tenancy) {
         source: g.source,
         created_by: g.created_by,
         ts: g.ts,
+        // ARC-3 (00089): `value` is written ONLY when present, so a non-outcome row
+        // never names the column (it would 42703 on a pre-00089 plane).
+        ...(g.value !== undefined && g.value !== null ? { value: g.value } : {}),
     };
 }
 /**

package/dist/telemetry/grade-task.d.ts

@@ -0,0 +1,49 @@
+/**
+ * THE grade-task key (GRADE-RAW, grade-ux-plan.md §1 item 2) — which TASK a
+ * telemetry row is graded under. ONE helper; every grading surface (teaching
+ * feed, auto-grade enqueue, calibration subject attribution, the /grades
+ * rollup, the grader's subject loader and the ingest-side task registration)
+ * keys through it, so they can never disagree about where a call belongs.
+ *
+ *   • A ROUTED call is graded under its route (`inferences.route`).
+ *   • A raw-lane (`rig.runRaw`) or recorded (`rig.recordCall`) call stores
+ *     `provider/model` in `inferences.route` — not a task anyone would write a
+ *     grading guide for. Its task is the customer's step name, `tags.step`,
+ *     when present and a valid task name. Otherwise it falls back to the route
+ *     (honest: an unnamed raw call has no task of its own).
+ *
+ * The SDK's auto step key inside a run (`<provider>/<model>#<n>`) contains a
+ * `/`, so it is never a valid task name and never becomes a task — a grader is
+ * for a step the customer named.
+ *
+ * Pure, dependency-free (the server, the console and stampBatch import it).
+ */
+/** A task name is one URL path segment (`/v1/tasks/<task>/settings`): starts
+ * with a letter or digit, then letters, digits, `.`, `_`, `:` or `-`; at most
+ * 128 characters. No `/`, no spaces. */
+export declare const TASK_NAME_PATTERN: RegExp;
+/** The teaching copy every bad-name refusal uses (one wording, everywhere). */
+export declare const TASK_NAME_RULE = "a task name starts with a letter or digit and then uses only letters, digits, '.', '_', ':' or '-' (max 128 chars, no '/' or spaces)";
+/** At most this many NEW step tasks are registered per ingest batch (abuse
+ * cap: a batch cannot mint an unbounded number of task rows). Excess steps are
+ * not lost — they register on a later batch that carries them. */
+export declare const MAX_REGISTERED_STEPS_PER_BATCH = 50;
+export declare function isValidTaskName(value: unknown): value is string;
+/** The minimal row shape the helper needs. `tags` may be the parsed object (wire
+ * rows, PostgREST reads) or the JSON text the local store keeps (`tagsJson`). */
+export interface GradeTaskRow {
+    readonly route: string;
+    readonly tags?: unknown;
+    readonly tagsJson?: string;
+}
+/** The step a raw/recorded row names, or null (routed row, no step, or a step
+ * that is not a valid task name). */
+export declare function stepTaskOf(row: GradeTaskRow): string | null;
+/** The task a row is graded under: `tags.step` for a raw/recorded row that names
+ * a valid step, else `route`. */
+export declare function gradeTaskOf(row: GradeTaskRow): string;
+/** The distinct step tasks a batch of rows names, first-seen order, capped at
+ * {@link MAX_REGISTERED_STEPS_PER_BATCH}. Routed rows contribute nothing (route
+ * sync owns their task rows). */
+export declare function registrableStepTasks(rows: readonly GradeTaskRow[], cap?: number): string[];
+//# sourceMappingURL=grade-task.d.ts.map

package/dist/telemetry/grade-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-task.d.ts","sourceRoot":"","sources":["../../src/telemetry/grade-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;wCAEwC;AACxC,eAAO,MAAM,iBAAiB,QAAwC,CAAC;AAEvE,+EAA+E;AAC/E,eAAO,MAAM,cAAc,yIAC6G,CAAC;AAEzI;;kEAEkE;AAClE,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D;AAED;iFACiF;AACjF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAeD;qCACqC;AACrC,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAI3D;AAED;iCACiC;AACjC,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAErD;AAED;;iCAEiC;AACjC,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,GAAG,GAAE,MAAuC,GAC3C,MAAM,EAAE,CAWV"}