modelrig 0.11.0 → 0.12.0

package/dist/init/starter.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * The starter route's companion files (SURF-1, audit #2). Every on-ramp shows
+ * the same starter route, `example.support_summarize` (console
+ * STARTER_ROUTE_YAML, www /get-started, quickstart §3), and that YAML references
+ * `./schemas/support_summarize.schema.json` and
+ * `./prompts/support_summarize.system.md`. Neither shipped in the npm tarball,
+ * so a customer who pasted the route got "schema file not found" from
+ * `modelrig validate`. `modelrig init` now writes both next to the routes dir
+ * (never clobbering), and `surf1-setup.test.ts` asserts these constants equal the
+ * package's own committed example files and that the starter validates.
+ *
+ * They are support files, not routes: the loader reads only top-level *.yaml,
+ * so writing them can never change what a rig serves.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STARTER_PROMPT_MD = exports.STARTER_SCHEMA_JSON = exports.STARTER_PROMPT_PATH = exports.STARTER_SCHEMA_PATH = void 0;
+exports.writeStarterFiles = writeStarterFiles;
+/** Path of each companion file, relative to the routes directory. */
+exports.STARTER_SCHEMA_PATH = "schemas/support_summarize.schema.json";
+exports.STARTER_PROMPT_PATH = "prompts/support_summarize.system.md";
+exports.STARTER_SCHEMA_JSON = `{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "support_summarize",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["summary", "handoff"],
+  "properties": {
+    "summary": {
+      "type": "string",
+      "minLength": 40,
+      "description": "One paragraph a human agent can act on without reading the thread."
+    },
+    "severity": { "type": "string", "enum": ["low", "normal", "high", "urgent"] },
+    "handoff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["team", "reason"],
+      "properties": {
+        "team": { "type": "string", "enum": ["billing", "technical", "account", "none"] },
+        "reason": { "type": "string", "minLength": 10 }
+      }
+    }
+  }
+}
+`;
+exports.STARTER_PROMPT_MD = `You summarise a customer support ticket for the agent who picks it up next.
+
+Product: {{product}}
+
+Earlier context on this customer (may be "none"):
+{{priorContext}}
+
+Ticket:
+{{ticket}}
+
+Write one actionable paragraph, judge severity, and name the team it should go
+to (or \`none\` if the summary closes it).
+
+{{#unless capability.structured_native}}
+Return ONLY a JSON object matching this shape — no prose, no code fence:
+{"summary": string, "severity": "low"|"normal"|"high"|"urgent",
+ "handoff": {"team": "billing"|"technical"|"account"|"none", "reason": string}}
+{{/unless}}
+`;
+/** Write the starter's schema and prompt under `routesDir`, leaving any file that
+ * already exists alone (it is the customer's). Returns what was written/skipped. */
+function writeStarterFiles(routesDir, fs, path) {
+    const written = [];
+    const skipped = [];
+    for (const [rel, body] of [
+        [exports.STARTER_SCHEMA_PATH, exports.STARTER_SCHEMA_JSON],
+        [exports.STARTER_PROMPT_PATH, exports.STARTER_PROMPT_MD],
+    ]) {
+        const file = path.join(routesDir, rel);
+        if (fs.existsSync(file)) {
+            skipped.push(file);
+            continue;
+        }
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.writeFileSync(file, body, "utf8");
+        written.push(file);
+    }
+    return { written, skipped };
+}

package/dist/registry/build.d.ts

@@ -9,6 +9,7 @@
  */
 import type { ModelFacts } from "./claims";
 import type { ModelPricingV2 } from "./pricing-shape";
+import type { ModelKind } from "./model-kind";
 export interface DeclaredLayer {
     readonly as_of: string;
     readonly source: string;
@@ -168,6 +169,9 @@ export interface Discrepancy {
 }
 export interface RegistryEntry {
     readonly model_key: string;
+    /** ARC-4 (ARC-D5): absent ⇒ `llm`. Any other kind is a DECLARED-ONLY
+     * generation model — unprobed and never ranked (model-kind.ts). */
+    readonly kind?: ModelKind;
     readonly declared: DeclaredLayer | null;
     readonly probed: ProbedLayer | null;
     readonly observed: ObservedLayer | null;

package/dist/registry/build.d.ts.map

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

package/dist/registry/generation-models.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ARC-4 (ARC-D5) — DECLARED-ONLY generation models in the registry.
+ *
+ * A short, reviewed list of widely used image / video / text-to-speech /
+ * speech-to-text models whose UNIT price we can source. Every price is READ
+ * from the vendored LiteLLM snapshot (data/pricing-map.json at the pinned SHA)
+ * by {@link buildGenerationLayer} — never typed in by hand — and carries its
+ * provenance: the snapshot key, the field, and the upstream pricing page when
+ * the snapshot names one. A model whose snapshot entry has no usable unit rate
+ * gets NO price (honest absence), not a guess (L5).
+ *
+ * These entries are:
+ *  - declared-only and UNPROBED (no probe suite measures generation quality);
+ *  - NEVER ranked: `kind` ≠ `llm` keeps them out of RigIndex, the leaderboard,
+ *    capability selection and the console mirror (model-kind.ts `isRankable`,
+ *    pinned by rank-wall-kind.test.ts);
+ *  - observed only through `rig.recordCall({ units })` — no adapter exists.
+ *
+ * Output: registry/layers/generation.json (build-generation.ts writes it;
+ * build-registry.ts merges it). Pure — the snapshot is passed in.
+ */
+import type { DeclaredLayer, RegistryEntry } from "./build";
+import type { GenerationKind } from "./model-kind";
+import type { GenerationPricingV2 } from "./pricing-shape";
+/** The pinned snapshot this layer reads (upstream/litellm.pin.json). */
+export declare const GENERATION_SNAPSHOT: {
+    readonly sha: "de706a35a6";
+    readonly pinnedDate: "2026-07-30";
+};
+/** The reviewed list: registry model_key → the snapshot key its price is read
+ * from. Adding a model is a reviewed edit HERE; the price follows the source. */
+export declare const GENERATION_SOURCES: ReadonlyArray<{
+    readonly modelKey: string;
+    readonly mapKey: string;
+}>;
+/** One layer row: the kind + the declared block. */
+export interface GenerationLayerEntry {
+    readonly kind: GenerationKind;
+    readonly declared: Omit<DeclaredLayer, "pricing_v2"> & {
+        readonly pricing_v2: GenerationPricingV2 | null;
+    };
+}
+export type GenerationLayer = Readonly<Record<string, GenerationLayerEntry>>;
+/** A registry entry for a generation model (RegistryEntry with a kind and the
+ * generation price block). */
+export type GenerationRegistryEntry = Omit<RegistryEntry, "declared"> & {
+    readonly kind: GenerationKind;
+    readonly declared: GenerationLayerEntry["declared"];
+};
+interface SnapshotEntry {
+    readonly mode?: string;
+    readonly source?: string;
+    readonly [key: string]: unknown;
+}
+/** Build the generation layer from the snapshot. Throws on a source key the
+ * snapshot does not carry or whose mode is not a generation mode — a reviewed
+ * list entry that no longer resolves must fail the build, not vanish. */
+export declare function buildGenerationLayer(snapshot: Readonly<Record<string, SnapshotEntry>>): GenerationLayer;
+/** The layer as registry entries (no probed/observed layer, no notes/facts). */
+export declare function generationRegistryEntries(layer: GenerationLayer): GenerationRegistryEntry[];
+/** Merge the generation entries into a registry's model list: any existing
+ * entry with the same key is REPLACED (the layer is the source of truth for
+ * these keys), and the list stays sorted by model_key like buildRegistry. */
+export declare function mergeGenerationEntries<T extends {
+    readonly model_key: string;
+}>(models: readonly T[], layer: GenerationLayer): Array<T | GenerationRegistryEntry>;
+export {};
+//# sourceMappingURL=generation-models.d.ts.map

package/dist/registry/generation-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-models.d.ts","sourceRoot":"","sources":["../../src/registry/generation-models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,iBAAiB,CAAC;AAE1E,wEAAwE;AACxE,eAAO,MAAM,mBAAmB;;;CAA2D,CAAC;AAE5F;iFACiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAapG,CAAC;AAEF,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,GAAG;QAAE,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAA;KAAE,CAAC;CAC5G;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAE7E;8BAC8B;AAC9B,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG;IACtE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;CACrD,CAAC;AAEF,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAiED;;yEAEyE;AACzE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAAG,eAAe,CAqCvG;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,GAAG,uBAAuB,EAAE,CAW3F;AAED;;6EAE6E;AAC7E,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7E,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,KAAK,EAAE,eAAe,GACrB,KAAK,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAKpC"}

package/dist/registry/generation-models.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * ARC-4 (ARC-D5) — DECLARED-ONLY generation models in the registry.
+ *
+ * A short, reviewed list of widely used image / video / text-to-speech /
+ * speech-to-text models whose UNIT price we can source. Every price is READ
+ * from the vendored LiteLLM snapshot (data/pricing-map.json at the pinned SHA)
+ * by {@link buildGenerationLayer} — never typed in by hand — and carries its
+ * provenance: the snapshot key, the field, and the upstream pricing page when
+ * the snapshot names one. A model whose snapshot entry has no usable unit rate
+ * gets NO price (honest absence), not a guess (L5).
+ *
+ * These entries are:
+ *  - declared-only and UNPROBED (no probe suite measures generation quality);
+ *  - NEVER ranked: `kind` ≠ `llm` keeps them out of RigIndex, the leaderboard,
+ *    capability selection and the console mirror (model-kind.ts `isRankable`,
+ *    pinned by rank-wall-kind.test.ts);
+ *  - observed only through `rig.recordCall({ units })` — no adapter exists.
+ *
+ * Output: registry/layers/generation.json (build-generation.ts writes it;
+ * build-registry.ts merges it). Pure — the snapshot is passed in.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GENERATION_SOURCES = exports.GENERATION_SNAPSHOT = void 0;
+exports.buildGenerationLayer = buildGenerationLayer;
+exports.generationRegistryEntries = generationRegistryEntries;
+exports.mergeGenerationEntries = mergeGenerationEntries;
+/** The pinned snapshot this layer reads (upstream/litellm.pin.json). */
+exports.GENERATION_SNAPSHOT = { sha: "de706a35a6", pinnedDate: "2026-07-30" };
+/** The reviewed list: registry model_key → the snapshot key its price is read
+ * from. Adding a model is a reviewed edit HERE; the price follows the source. */
+exports.GENERATION_SOURCES = [
+    { modelKey: "openai/dall-e-3", mapKey: "dall-e-3" },
+    { modelKey: "gemini/imagen-4.0-generate-001", mapKey: "gemini/imagen-4.0-generate-001" },
+    { modelKey: "gemini/imagen-4.0-fast-generate-001", mapKey: "gemini/imagen-4.0-fast-generate-001" },
+    { modelKey: "black_forest_labs/flux-pro-1.1", mapKey: "black_forest_labs/flux-pro-1.1" },
+    { modelKey: "stability/sd3.5-large", mapKey: "stability/sd3.5-large" },
+    { modelKey: "gemini/veo-3.1-generate-preview", mapKey: "gemini/veo-3.1-generate-preview" },
+    { modelKey: "gemini/veo-3.1-fast-generate-preview", mapKey: "gemini/veo-3.1-fast-generate-preview" },
+    { modelKey: "openai/sora-2", mapKey: "sora-2" },
+    { modelKey: "openai/tts-1", mapKey: "tts-1" },
+    { modelKey: "elevenlabs/eleven_multilingual_v2", mapKey: "elevenlabs/eleven_multilingual_v2" },
+    { modelKey: "openai/whisper-1", mapKey: "whisper-1" },
+    { modelKey: "deepgram/nova-3", mapKey: "deepgram/nova-3" },
+];
+const MODE_KIND = {
+    image_generation: "image_gen",
+    video_generation: "video_gen",
+    audio_speech: "tts",
+    audio_transcription: "stt",
+};
+function rate(v) {
+    return typeof v === "number" && Number.isFinite(v) && v > 0 ? v : null;
+}
+/** Strip binary float noise (0.000015 × 1e6 = 15.000000000000002). */
+function clean(n) {
+    return Number(n.toPrecision(12));
+}
+/** The billed unit rate the snapshot publishes for this mode, as
+ * {modality field, value, snapshot field}. Mirrors pricing.ts getMapUnitRates. */
+function unitRateOf(e) {
+    switch (e.mode) {
+        case "image_generation": {
+            const out = rate(e.output_cost_per_image);
+            if (out !== null)
+                return { field: "image_per_unit", value: out, from: "output_cost_per_image" };
+            const inp = rate(e.input_cost_per_image);
+            return inp !== null ? { field: "image_per_unit", value: inp, from: "input_cost_per_image" } : null;
+        }
+        case "video_generation": {
+            const pv = rate(e.output_cost_per_video_per_second);
+            if (pv !== null)
+                return { field: "video_per_second", value: pv, from: "output_cost_per_video_per_second" };
+            const ps = rate(e.output_cost_per_second);
+            return ps !== null ? { field: "video_per_second", value: ps, from: "output_cost_per_second" } : null;
+        }
+        case "audio_speech": {
+            const pc = rate(e.input_cost_per_character);
+            if (pc !== null)
+                return { field: "characters_per_million", value: clean(pc * 1000000), from: "input_cost_per_character" };
+            const ps = rate(e.output_cost_per_second);
+            return ps !== null ? { field: "audio_per_second", value: ps, from: "output_cost_per_second" } : null;
+        }
+        case "audio_transcription": {
+            const ps = rate(e.input_cost_per_second);
+            return ps !== null ? { field: "audio_per_second", value: ps, from: "input_cost_per_second" } : null;
+        }
+        default:
+            return null;
+    }
+}
+const BASIS = {
+    image_gen: "per generated image · as filed under the snapshot key · declared-only (unprobed)",
+    video_gen: "per second of generated video · as filed under the snapshot key · declared-only (unprobed)",
+    tts: "per input character (shown per 1M) · as filed under the snapshot key · declared-only (unprobed)",
+    stt: "per second of input audio · as filed under the snapshot key · declared-only (unprobed)",
+};
+const NULL_FLAGS = {
+    supports_response_schema: null,
+    supports_web_search: null,
+    supports_prompt_caching: null,
+    adapter_structured_native: null,
+    adapter_grounded_native: null,
+    supports_image_input: null,
+};
+/** Build the generation layer from the snapshot. Throws on a source key the
+ * snapshot does not carry or whose mode is not a generation mode — a reviewed
+ * list entry that no longer resolves must fail the build, not vanish. */
+function buildGenerationLayer(snapshot) {
+    const out = {};
+    const asOf = exports.GENERATION_SNAPSHOT.pinnedDate;
+    for (const { modelKey, mapKey } of exports.GENERATION_SOURCES) {
+        const e = snapshot[mapKey];
+        if (e === undefined)
+            throw new Error(`generation source ${modelKey}: snapshot key "${mapKey}" not found`);
+        const kind = typeof e.mode === "string" ? MODE_KIND[e.mode] : undefined;
+        if (kind === undefined)
+            throw new Error(`generation source ${modelKey}: snapshot mode "${String(e.mode)}" is not a generation mode`);
+        const upstream = typeof e.source === "string" && /^https?:\/\//.test(e.source) ? ` (upstream: ${e.source})` : "";
+        const unit = unitRateOf(e);
+        const source = unit !== null
+            ? `litellm-pricing-map@${exports.GENERATION_SNAPSHOT.sha} key "${mapKey}" mode ${e.mode} field ${unit.from}${upstream}`
+            : `litellm-pricing-map@${exports.GENERATION_SNAPSHOT.sha} key "${mapKey}" — no unit rate published (unpriced)`;
+        const pricingV2 = unit === null
+            ? null
+            : {
+                base: null,
+                tiers: null,
+                context_bands: null,
+                batch_discount: null,
+                modality: { [unit.field]: unit.value, provenance: { source, as_of: asOf } },
+                source,
+                as_of: asOf,
+                basis: BASIS[kind],
+            };
+        out[modelKey] = {
+            kind,
+            declared: {
+                as_of: asOf,
+                source: `declared-only generation model (unprobed, never ranked) · ${source}`,
+                pricing: null,
+                pricing_v2: pricingV2,
+                flags: NULL_FLAGS,
+            },
+        };
+    }
+    return out;
+}
+/** The layer as registry entries (no probed/observed layer, no notes/facts). */
+function generationRegistryEntries(layer) {
+    return Object.entries(layer).map(([modelKey, row]) => ({
+        model_key: modelKey,
+        kind: row.kind,
+        declared: row.declared,
+        probed: null,
+        observed: null,
+        discrepancies: [],
+        callNotes: [],
+        facts: null,
+    }));
+}
+/** Merge the generation entries into a registry's model list: any existing
+ * entry with the same key is REPLACED (the layer is the source of truth for
+ * these keys), and the list stays sorted by model_key like buildRegistry. */
+function mergeGenerationEntries(models, layer) {
+    const keys = new Set(Object.keys(layer));
+    return [...models.filter((m) => !keys.has(m.model_key)), ...generationRegistryEntries(layer)].sort((a, b) => a.model_key < b.model_key ? -1 : 1);
+}

package/dist/registry/model-kind.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ARC-4 (ARC-D5) — the registry `kind` vocabulary. An entry without `kind` is an
+ * `llm` (the implicit default — every entry before ARC-γ). The other kinds are
+ * DECLARED-ONLY generation models: unprobed, never ranked, priced per unit
+ * (images, seconds, characters) rather than per token, and observed only through
+ * `rig.recordCall({ units })` — ModelRig ships no adapter for them.
+ *
+ * PURE and import-free on purpose: the RigIndex / leaderboard builders import it
+ * to keep non-`llm` kinds out of rank, and their import closure is walled
+ * (rigindex-wall.test.ts).
+ */
+export declare const MODEL_KINDS: readonly ["llm", "image_gen", "video_gen", "tts", "stt"];
+export type ModelKind = (typeof MODEL_KINDS)[number];
+/** The generation kinds (everything but `llm`). */
+export type GenerationKind = Exclude<ModelKind, "llm">;
+export declare function isModelKind(v: unknown): v is ModelKind;
+/** An entry's kind: its declared `kind`, else `llm`. An unrecognized value is
+ * treated as NOT `llm` (fail-closed: it can never sneak into rank). */
+export declare function kindOf(entry: {
+    readonly kind?: unknown;
+}): ModelKind | "unknown";
+/** THE rank wall predicate: only an `llm` entry may enter RigIndex, the
+ * leaderboard, or capability selection. */
+export declare function isRankable(entry: {
+    readonly kind?: unknown;
+}): boolean;
+/** The model keys of every non-rankable entry in a registry model list — the
+ * set the RigIndex builder refuses (its inputs are probe files, not registry
+ * entries, so it is handed the keys). */
+export declare function nonRankableKeys(models: ReadonlyArray<{
+    readonly model_key: string;
+    readonly kind?: unknown;
+}>): Set<string>;
+//# sourceMappingURL=model-kind.d.ts.map

package/dist/registry/model-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-kind.d.ts","sourceRoot":"","sources":["../../src/registry/model-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,WAAW,0DAA2D,CAAC;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAEvD,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAEtD;AAED;uEACuE;AACvE,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,SAAS,CAGhF;AAED;2CAC2C;AAC3C,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEtE;AAED;;yCAEyC;AACzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3H"}

package/dist/registry/model-kind.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * ARC-4 (ARC-D5) — the registry `kind` vocabulary. An entry without `kind` is an
+ * `llm` (the implicit default — every entry before ARC-γ). The other kinds are
+ * DECLARED-ONLY generation models: unprobed, never ranked, priced per unit
+ * (images, seconds, characters) rather than per token, and observed only through
+ * `rig.recordCall({ units })` — ModelRig ships no adapter for them.
+ *
+ * PURE and import-free on purpose: the RigIndex / leaderboard builders import it
+ * to keep non-`llm` kinds out of rank, and their import closure is walled
+ * (rigindex-wall.test.ts).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_KINDS = void 0;
+exports.isModelKind = isModelKind;
+exports.kindOf = kindOf;
+exports.isRankable = isRankable;
+exports.nonRankableKeys = nonRankableKeys;
+exports.MODEL_KINDS = ["llm", "image_gen", "video_gen", "tts", "stt"];
+function isModelKind(v) {
+    return typeof v === "string" && exports.MODEL_KINDS.includes(v);
+}
+/** An entry's kind: its declared `kind`, else `llm`. An unrecognized value is
+ * treated as NOT `llm` (fail-closed: it can never sneak into rank). */
+function kindOf(entry) {
+    if (entry.kind === undefined || entry.kind === null)
+        return "llm";
+    return isModelKind(entry.kind) ? entry.kind : "unknown";
+}
+/** THE rank wall predicate: only an `llm` entry may enter RigIndex, the
+ * leaderboard, or capability selection. */
+function isRankable(entry) {
+    return kindOf(entry) === "llm";
+}
+/** The model keys of every non-rankable entry in a registry model list — the
+ * set the RigIndex builder refuses (its inputs are probe files, not registry
+ * entries, so it is handed the keys). */
+function nonRankableKeys(models) {
+    return new Set(models.filter((m) => !isRankable(m)).map((m) => m.model_key));
+}

package/dist/registry/pricing-shape.d.ts

@@ -84,10 +84,28 @@ export type ImageInputPrice = {
     readonly source: string;
     readonly as_of: string;
 };
-/** Non-text input units, USD per unit. */
+/** Where a modality block's UNIT rates came from (ARC-4). REQUIRED for any of
+ * `image_per_unit` / `audio_per_second` / `video_per_second` /
+ * `characters_per_million` to be priced: a unit rate with no provenance is
+ * never used (L5 — absent beats guessed). */
+export interface UnitRateProvenance {
+    readonly source: string;
+    readonly as_of: string;
+}
+/** Non-token units, USD per unit. For an `llm` entry these are INPUT units (an
+ * image or a second of audio sent in); for a declared generation model
+ * (registry `kind` image_gen | video_gen | tts | stt — ARC-4) they are what the
+ * call is billed in: images generated, seconds produced (video/tts) or
+ * transcribed (stt), characters synthesized. */
 export interface ModalityRates {
     readonly image_per_unit?: number | null;
     readonly audio_per_second?: number | null;
+    /** ARC-4: USD per second of generated video. */
+    readonly video_per_second?: number | null;
+    /** ARC-4: USD per MILLION characters (TTS input text). */
+    readonly characters_per_million?: number | null;
+    /** ARC-4: provenance for the unit rates above (see {@link UnitRateProvenance}). */
+    readonly provenance?: UnitRateProvenance | null;
     /** Typed, provenance-bearing image-input price (UC-3 M0). Additive and
      * optional; absent when the vendor's image price could not be sourced —
      * absence is honest, never a zero or a guess. Supersedes the bare
@@ -169,4 +187,14 @@ export interface PricingV2Display {
  * guarantee lives here, in code, so no consumer can bypass it.
  */
 export declare function describePricingV2(pricing: ModelPricingV2): PricingV2Display;
+/**
+ * ARC-4: the price block of a DECLARED-ONLY generation model (registry `kind`
+ * other than `llm`). Same shape as {@link ModelPricingV2} except `base` is
+ * null: these models publish no per-token rate, and a placeholder `0` would be
+ * read as "$0 per token" by anything that reads the registry (L5). The price is
+ * the `modality` unit rates, with their provenance.
+ */
+export interface GenerationPricingV2 extends Omit<ModelPricingV2, "base"> {
+    readonly base: null;
+}
 //# sourceMappingURL=pricing-shape.d.ts.map

package/dist/registry/pricing-shape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing-shape.d.ts","sourceRoot":"","sources":["../../src/registry/pricing-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;kFAC8E;IAC9E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED;2EAC2E;AAC3E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,wBAAwB,CAAC;AAE/D,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3C,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE;iDAC6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEN,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C;;;;4DAIwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACzC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;iFACiF;AACjF,eAAO,MAAM,cAAc,0CAAgC,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAqB,GAC1B,cAAc,CAWhB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAMzE;;gFAEgF;AAChF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,QAAQ,CAAC;KACtE,CAAC,IAAI,MAAM,wBAAwB,GAAG,MAAM;CAC9C,CAAC,CAWD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,IAAI,CAW3F;AAED;gFACgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrF,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAqBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAwD3E"}
+{"version":3,"file":"pricing-shape.d.ts","sourceRoot":"","sources":["../../src/registry/pricing-shape.ts"],"names":[],"mappings":"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"}

package/dist/registry/pricing-shape.js

@@ -142,6 +142,7 @@ function describePricingV2(pricing) {
     if (pricing.modality?.audio_per_second != null) {
         modality.push(`audio: $${pricing.modality.audio_per_second.toFixed(4)} per second`);
     }
+    pushGenerationRates(modality, pricing.modality ?? null);
     const urlMatch = URL_RE.exec(pricing.source);
     return {
         basis: pricing.basis,
@@ -158,3 +159,11 @@ function describePricingV2(pricing) {
         vendorUrl: urlMatch ? urlMatch[0] : null,
     };
 }
+/** ARC-4: the generation unit rates (video seconds, TTS characters), rendered
+ * only when present — honest absence otherwise. */
+function pushGenerationRates(out, m) {
+    if (m?.video_per_second != null)
+        out.push(`video: $${m.video_per_second.toFixed(4)} per second`);
+    if (m?.characters_per_million != null)
+        out.push(`text-to-speech: $${m.characters_per_million.toFixed(2)} per 1M characters`);
+}

package/dist/registry/pricing.d.ts

@@ -41,4 +41,30 @@ export declare function estimateCostUsd(pricing: ModelPricing, tokensIn: number,
 tokensCacheWrite?: number, 
 /** 1h-TTL portion of the write (bills at the higher multiplier when known). */
 tokensCacheWrite1h?: number): number;
+/**
+ * ARC-4: the per-unit rates the vendored LiteLLM snapshot publishes for a
+ * GENERATION model, read by mode (LiteLLM spells the same unit differently per
+ * mode, so the mode decides which key is the billed unit — nothing is summed or
+ * inferred across keys):
+ *  - `image_generation`: USD per generated image = `output_cost_per_image`,
+ *    else `input_cost_per_image` (LiteLLM files OpenAI's per-image price there).
+ *  - `video_generation`: USD per second = `output_cost_per_video_per_second`,
+ *    else `output_cost_per_second`.
+ *  - `audio_speech` (TTS): USD per character = `input_cost_per_character`;
+ *    USD per second of produced audio = `output_cost_per_second` (billed only
+ *    when the entry has no per-character rate — one billed unit per model).
+ *  - `audio_transcription` (STT): USD per second of input audio =
+ *    `input_cost_per_second` (the snapshot's `output_cost_per_second` on some STT
+ *    entries is not a billed unit and is ignored).
+ * Any other mode (chat, embedding, …) has NO unit price here. Key resolution:
+ * a known provider's own prefixes, then `<provider>/<model>`.
+ */
+export interface MapUnitRates {
+    readonly key: string;
+    readonly mode: string;
+    readonly perImage: number | null;
+    readonly perSecond: number | null;
+    readonly perCharacter: number | null;
+}
+export declare function getMapUnitRates(provider: string, model: string): MapUnitRates | null;
 //# sourceMappingURL=pricing.d.ts.map

package/dist/registry/pricing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/registry/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C;;uEAEmE;IACnE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C;;sEAEkE;IAClE,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AA+DD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA6BnF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAYvF;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;AACpB;;;0CAG0C;AAC1C,gBAAgB,SAAI;AACpB,+EAA+E;AAC/E,kBAAkB,SAAI,GACrB,MAAM,CAsBR"}
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/registry/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C;;uEAEmE;IACnE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C;;sEAEkE;IAClE,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AA0ED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA6BnF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAYvF;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;AACpB;;;0CAG0C;AAC1C,gBAAgB,SAAI;AACpB,+EAA+E;AAC/E,kBAAkB,SAAI,GACrB,MAAM,CAsBR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAMD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAsBpF"}

package/dist/registry/pricing.js

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPricing = getPricing;
 exports.getPricingV2 = getPricingV2;
 exports.estimateCostUsd = estimateCostUsd;
+exports.getMapUnitRates = getMapUnitRates;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 /** LiteLLM key prefixes per provider, most-specific first. Verified against
@@ -129,3 +130,31 @@ tokensCacheWrite1h = 0) {
         write1h * write1hRate +
         Math.max(tokensOut, 0) * pricing.outputUsdPerTok);
 }
+function finiteRate(v) {
+    return typeof v === "number" && Number.isFinite(v) && v >= 0 ? v : null;
+}
+function getMapUnitRates(provider, model) {
+    if (provider === "" || model === "")
+        return null;
+    const map = loadMap();
+    const prefixes = KEY_PREFIXES[provider] ?? [];
+    const candidates = [...prefixes.map((p) => `${p}${model}`), `${provider}/${model}`];
+    for (const key of candidates) {
+        const e = map[key];
+        if (e === undefined || typeof e.mode !== "string")
+            continue;
+        switch (e.mode) {
+            case "image_generation":
+                return { key, mode: e.mode, perImage: finiteRate(e.output_cost_per_image) ?? finiteRate(e.input_cost_per_image), perSecond: null, perCharacter: null };
+            case "video_generation":
+                return { key, mode: e.mode, perImage: null, perSecond: finiteRate(e.output_cost_per_video_per_second) ?? finiteRate(e.output_cost_per_second), perCharacter: null };
+            case "audio_speech":
+                return { key, mode: e.mode, perImage: null, perSecond: finiteRate(e.output_cost_per_second), perCharacter: finiteRate(e.input_cost_per_character) };
+            case "audio_transcription":
+                return { key, mode: e.mode, perImage: null, perSecond: finiteRate(e.input_cost_per_second), perCharacter: null };
+            default:
+                return null;
+        }
+    }
+    return null;
+}

package/dist/registry/rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/registry/rows.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA0C/C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CA4BxE"}
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/registry/rows.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA4C/C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CA6BxE"}