modelrig 0.0.1 → 0.2.0

package/dist/types/failures-teaching.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Errors that teach — Phase 5 WS3.
+ *
+ * ONE table, not prose scattered across call sites. Every failure class here
+ * answers three questions in the order a stuck engineer asks them:
+ *
+ *   1. what happened?          → `what` (plain language, no jargon-first)
+ *   2. what do I do about it?  → `fixHint` (an action, not a diagnosis)
+ *   3. where do I read more?   → `docsUrl` (a deep link, not a homepage)
+ *
+ * And where the fix is MECHANICAL, a fourth: `suggestedChange` — a
+ * JSON-patch-shaped hint a coding agent can apply without inventing
+ * anything. Only classes whose remedy is genuinely a config edit carry one;
+ * inventing a patch for "the model refused" would be worse than silence.
+ *
+ * The completeness test in failures-teaching.test.ts fails the build if a
+ * new FailureClass is added without an entry here, so this table cannot
+ * silently fall behind the taxonomy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAILURE_TEACHING = void 0;
+exports.teach = teach;
+exports.renderFailureForTerminal = renderFailureForTerminal;
+const DOCS_BASE = "https://modelrig.dev/docs/failures";
+exports.FAILURE_TEACHING = {
+    content_invalid: {
+        class: "content_invalid",
+        what: "The model answered, but the answer did not match the schema your route requires — so it " +
+            "was rejected rather than passed downstream.",
+        fixHint: "Retry on this class is budgeted separately, so a flaky schema cannot eat your network " +
+            "retries. If it persists, the model likely cannot hold this shape: check the registry for " +
+            "a candidate with probed native structured output.",
+        docsUrl: `${DOCS_BASE}#content_invalid`,
+        // Mechanical: raise the content-retry budget. A repair rung is a bigger
+        // decision, so we suggest the small edit and name the bigger one in prose.
+        suggestedChange: () => ({
+            op: "replace",
+            path: "/policy/retries/content_invalid",
+            value: 3,
+            because: "A schema miss is usually transient at low retry counts; three attempts is the point " +
+                "past which the model is telling you it cannot hold this shape.",
+        }),
+    },
+    capacity_shed: {
+        class: "capacity_shed",
+        what: "The provider shed your request rather than serving it — a 429, a 503, or a flex-tier " +
+            "rejection. Nothing was wrong with the request.",
+        fixHint: "Capacity retries back off automatically. If it happens constantly, you are asking for " +
+            "discounted sheddable capacity during peak: move the route off the flex tier, or add a " +
+            "candidate on another provider so a shed on one does not stall the route.",
+        docsUrl: `${DOCS_BASE}#capacity_shed`,
+        suggestedChange: () => ({
+            op: "replace",
+            path: "/policy/tier",
+            value: "standard",
+            because: "Flex capacity is discounted because it is sheddable. If sheds are routine on this " +
+                "route, standard tier is the cheaper choice once retries are counted.",
+        }),
+    },
+    network: {
+        class: "network",
+        what: "The request never completed at the transport level — DNS, TLS, a dropped connection, or " +
+            "an error we could not classify any more precisely.",
+        fixHint: "These retry on their own budget. A persistent one is usually local: check egress, proxy " +
+            "settings, and whether the provider is up before changing anything in the route.",
+        docsUrl: `${DOCS_BASE}#network`,
+    },
+    refusal: {
+        class: "refusal",
+        what: "The model declined the task itself — this is an answer, not a fault.",
+        fixHint: "Retrying a refusal usually earns another refusal. Read the prompt as the model saw it: " +
+            "the input often contains something the model's policy will not touch. A different " +
+            "candidate may answer, but check the prompt first.",
+        docsUrl: `${DOCS_BASE}#refusal`,
+        // Deliberately no suggestedChange: no config edit fixes a refusal, and a
+        // patch that pretends otherwise would send someone down the wrong path.
+    },
+    cache_invalid: {
+        class: "cache_invalid",
+        what: "The provider-side cache or cached context this call relied on expired or was rejected, " +
+            "so the discount it was counting on is gone.",
+        fixHint: "Re-running usually repopulates the cache. If it recurs, your cached prefix is probably " +
+            "changing between calls — anything varying near the START of the prompt defeats prefix " +
+            "caching, so move volatile values to the end.",
+        docsUrl: `${DOCS_BASE}#cache_invalid`,
+    },
+    timeout: {
+        class: "timeout",
+        what: "The call passed the route's wall-clock deadline before the model finished.",
+        fixHint: "Either the deadline is too tight for this task or the model is slower than assumed. " +
+            "Check the latency column for this model before raising the timeout — a timeout raised to " +
+            "cover a slow model just makes a slow route.",
+        docsUrl: `${DOCS_BASE}#timeout`,
+        suggestedChange: () => ({
+            op: "replace",
+            path: "/policy/timeout_ms",
+            value: 300000,
+            because: "Long structured generations routinely exceed a 2-minute default. Five minutes is the " +
+                "ceiling used by the pipeline routes that produce full reports.",
+        }),
+    },
+    config_auth: {
+        class: "config_auth",
+        what: "The provider rejected the credentials, or there were none to send. This is never " +
+            "retried — retrying a dead key just spends time.",
+        fixHint: "Set the provider's API key in this environment. Until then the candidate is inert: the " +
+            "route still serves on its keyed candidates, and this one is skipped at dispatch.",
+        docsUrl: `${DOCS_BASE}#config_auth`,
+        // Mechanical only in the sense of naming the variable — the value is a
+        // secret and never appears in a suggested patch.
+        suggestedChange: (failure) => failure.provider === undefined
+            ? null
+            : {
+                op: "add",
+                path: `/env/${envVarNameFor(failure.provider)}`,
+                value: "<your API key>",
+                because: `Provider "${failure.provider}" has no usable credentials here. Set ` +
+                    `${envVarNameFor(failure.provider)} in the environment — never in the route file.`,
+            },
+    },
+    budget_exhausted: {
+        class: "budget_exhausted",
+        what: "The envelope this work was running under hit its cap, so spending stopped mid-run. " +
+            "This is the budget machinery working, not a bug.",
+        fixHint: "Decide whether the cap was wrong or the run was. Check the envelope's spend against what " +
+            "you expected before raising it — a runaway loop and an under-sized cap look identical " +
+            "from here, and only one of them is fixed by more money.",
+        docsUrl: `${DOCS_BASE}#budget_exhausted`,
+    },
+    invariant_violation: {
+        class: "invariant_violation",
+        what: "Something tried to serve a model your route never declared. The run was stopped rather " +
+            "than allowed to bill you for a model you did not choose.",
+        fixHint: "This is a bug in ModelRig, not in your configuration — the candidate set is meant to be " +
+            "an upper bound that nothing can escape. Please report it with the route name and the " +
+            "model that appeared.",
+        docsUrl: `${DOCS_BASE}#invariant_violation`,
+    },
+};
+/** Provider → the env var that keys it. Mirrors config.ts's PROVIDER_KEY_ENV;
+ * kept as a local lookup so this table has no import cycle with config. */
+function envVarNameFor(provider) {
+    const known = {
+        gemini: "GEMINI_API_KEY",
+        openai: "OPENAI_API_KEY",
+        deepseek: "DEEPSEEK_API_KEY",
+        anthropic: "ANTHROPIC_API_KEY",
+        grok: "XAI_API_KEY",
+        deepinfra: "MODELRIG_DEEPINFRA_API_KEY",
+        fireworks: "MODELRIG_FIREWORKS_API_KEY",
+    };
+    return known[provider] ?? `${provider.toUpperCase()}_API_KEY`;
+}
+function teach(failure) {
+    const entry = exports.FAILURE_TEACHING[failure.class];
+    return {
+        class: failure.class,
+        message: failure.message,
+        what: entry.what,
+        fixHint: failure.fixHint ?? entry.fixHint,
+        docsUrl: entry.docsUrl,
+        suggestedChange: entry.suggestedChange?.(failure) ?? null,
+    };
+}
+/** Terminal-friendly rendering — used by the CLI. Kept here so the CLI and
+ * the server cannot drift into two different-looking errors. */
+function renderFailureForTerminal(failure) {
+    const t = teach(failure);
+    const lines = [`[${t.class}] ${t.message}`, "", t.what, "", `Fix: ${t.fixHint}`, `Docs: ${t.docsUrl}`];
+    if (t.suggestedChange !== null) {
+        const change = t.suggestedChange;
+        lines.push("", `Suggested change: ${change.op} ${change.path}` +
+            (change.value === undefined ? "" : ` = ${JSON.stringify(change.value)}`), `  ${change.because}`);
+    }
+    return lines.join("\n");
+}

package/dist/types/failures.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Typed failure taxonomy — spec §2, §4.
+ * Adapters MUST map every provider error into a RigFailure; raw provider
+ * errors never cross the adapter boundary. Retry budgets are per-class and
+ * non-fungible (see run/retry.ts).
+ */
+export type FailureClass = "content_invalid" | "capacity_shed" | "network" | "refusal" | "cache_invalid" | "timeout" | "config_auth" | "budget_exhausted" | "invariant_violation";
+export interface RigFailure {
+    readonly class: FailureClass;
+    readonly message: string;
+    /** Provider/model that produced the failure, when applicable. */
+    readonly provider?: string;
+    readonly model?: string;
+    /** Raw underlying error for diagnostics; never used for control flow. */
+    readonly cause?: unknown;
+    /** Machine-readable remediation (errors-that-teach lands fully in Phase 5). */
+    readonly fixHint?: string;
+}
+export declare const TERMINAL_CLASSES: ReadonlySet<FailureClass>;
+/** Error subclass for the rare paths that must throw (config errors, terminal
+ * failures surfacing to the caller). The failure travels intact on `.failure`. */
+export declare class RigFailureError extends Error {
+    readonly failure: RigFailure;
+    constructor(failure: RigFailure);
+}
+export declare function isRigFailure(value: unknown): value is RigFailure;
+//# sourceMappingURL=failures.d.ts.map

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

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

package/dist/types/failures.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Typed failure taxonomy — spec §2, §4.
+ * Adapters MUST map every provider error into a RigFailure; raw provider
+ * errors never cross the adapter boundary. Retry budgets are per-class and
+ * non-fungible (see run/retry.ts).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RigFailureError = exports.TERMINAL_CLASSES = void 0;
+exports.isRigFailure = isRigFailure;
+exports.TERMINAL_CLASSES = new Set([
+    "budget_exhausted",
+    "invariant_violation",
+]);
+const FAILURE_CLASSES = new Set([
+    "content_invalid",
+    "capacity_shed",
+    "network",
+    "refusal",
+    "cache_invalid",
+    "timeout",
+    "config_auth",
+    "budget_exhausted",
+    "invariant_violation",
+]);
+/** Error subclass for the rare paths that must throw (config errors, terminal
+ * failures surfacing to the caller). The failure travels intact on `.failure`. */
+class RigFailureError extends Error {
+    constructor(failure) {
+        super(`[${failure.class}] ${failure.message}`);
+        this.name = "RigFailureError";
+        this.failure = failure;
+    }
+}
+exports.RigFailureError = RigFailureError;
+function isRigFailure(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return typeof v.class === "string" && FAILURE_CLASSES.has(v.class) && typeof v.message === "string";
+}

package/dist/types/provider.d.ts

@@ -0,0 +1,200 @@
+/**
+ * ProviderAdapter contract + the candidate-set invariant's type machinery.
+ * Spec §4. The invariant is structural: AdapterRequest carries a CandidateRef,
+ * and CandidateRef is a branded type constructible ONLY in run/resolve.ts.
+ */
+import type { RigFailure } from "./failures";
+export type ProviderId = "gemini" | "openai" | "deepseek" | "anthropic" | "grok" | "deepinfra" | "fireworks";
+/** Runtime enumeration of every ProviderId — the single list a raw-model lane
+ * (`provider/model`) validates against (http gateway spec §3.3). Kept in sync
+ * with the `ProviderId` union by the two compile-time assertions below: adding
+ * a provider to the union without adding it here (or vice-versa) fails the
+ * type-check. */
+export declare const PROVIDER_IDS: readonly ["gemini", "openai", "deepseek", "anthropic", "grok", "deepinfra", "fireworks"];
+export type CapabilityFlag = "structured_native" | "json_mode" | "grounded_native" | "context_cache_explicit" | "prompt_cache_key" | "prefix_cache_implicit" | "tier_flex" | "trace_visible" | "zero_retention";
+/** The canonical flag enumeration — the single list every static capability
+ * materialization iterates (index.ts, template validation, tests). */
+export declare const ALL_CAPABILITY_FLAGS: readonly CapabilityFlag[];
+declare const candidateBrand: unique symbol;
+/**
+ * A (provider, model) pair validated against a route's candidate list.
+ * DO NOT construct outside run/resolve.ts — no `as CandidateRef` anywhere
+ * (CI greps for it; see candidate-set-invariant.test.ts).
+ */
+export interface CandidateRef {
+    readonly provider: ProviderId;
+    readonly model: string;
+    readonly [candidateBrand]: true;
+}
+export type ServiceTier = "standard" | "flex" | "priority";
+/**
+ * Sampling parameters a route (RoutePolicy.sampling) or the raw lane may
+ * declare (CE-6, spec §2). Every field is optional and ADDITIVE:
+ *  - ABSENT block ⇒ byte-identical to pre-CE-6 — gemini keeps its ported
+ *    constants (temperature 1.0 / topP 0.95 / topK 40), and the other adapters
+ *    keep sending nothing (provider defaults win).
+ *  - PRESENT field ⇒ sent to the provider AS DECLARED, no silent clamp. The
+ *    provider is the authority on validity; a rejection surfaces through the
+ *    normal failure ladder (`invalid_request` → network). Loader ranges are a
+ *    permissive envelope (temperature 0–2, topP (0,1], maxOutputTokens ≥ 1);
+ *    per-model constraints are the provider's to enforce.
+ */
+export interface SamplingParams {
+    /** Overrides an adapter's default/constant when set. Loader checks 0–2. */
+    readonly temperature?: number;
+    /** Nucleus-sampling top_p. Loader checks (0,1] (exclusive-0, inclusive-1). */
+    readonly topP?: number;
+    /** Routed-lane exposure of the existing adapter max-output-tokens param —
+     * previously settable only on the raw lane. Loader checks integer ≥ 1. */
+    readonly maxOutputTokens?: number;
+}
+/** A single callable tool the model may invoke. `parameters` is a JSON Schema
+ * describing the arguments (OpenAI `function` shape). */
+export interface ToolDefinition {
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+        readonly description?: string;
+        /** JSON Schema for the arguments object. */
+        readonly parameters?: object;
+    };
+}
+/** How the model should choose among the supplied tools. String forms mirror
+ * OpenAI (`auto`/`none`/`required`); the object form pins a named function. */
+export type ToolChoice = "auto" | "none" | "required" | {
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+    };
+};
+/** A tool call emitted by the model, normalized to the OpenAI `tool_calls`
+ * shape. `arguments` is the raw JSON STRING the model produced (not parsed) —
+ * exactly what OpenAI returns, so callers and the HTTP gateway pass it through
+ * unchanged. */
+export interface ToolCall {
+    readonly id: string;
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+        readonly arguments: string;
+    };
+}
+export interface AdapterRequest {
+    readonly candidate: CandidateRef;
+    readonly systemPrompt: string;
+    readonly userPrompt: string;
+    /** JSON Schema for native structured output; null => prompt/json_mode path. */
+    readonly outputSchema: object | null;
+    readonly requestedTier: ServiceTier;
+    readonly timeoutMs: number;
+    /** Provider-neutral cache directive; adapters map to native mechanisms. */
+    readonly cache?: {
+        key: string;
+        ttlSeconds?: number;
+    };
+    /**
+     * Provider-native web-grounding directive (set by the run loop when the
+     * route requires "grounded"). BUILDER ADDITION pending architect sign-off:
+     * the scaffold's gemini adapter notes grounding is "driven by a
+     * cache/grounding directive on AdapterRequest", but the scaffolded type
+     * carried only `cache` — this optional field fills that gap additively.
+     */
+    readonly grounding?: boolean;
+    readonly maxOutputTokens?: number;
+    /**
+     * Declared sampling (CE-6, spec §2). Threaded from `RoutePolicy.sampling`
+     * (routed lane, run/dispatch.ts) or from the raw lane's temperature/topP
+     * (run/raw.ts). Adapters map each present field and keep their current
+     * constants/omissions when the block (or a field) is absent. `maxOutputTokens`
+     * here takes precedence over the top-level `maxOutputTokens` above — the two
+     * are never both set in practice (the routed lane uses this block, the raw
+     * lane the top-level field), but the precedence keeps resolution deterministic
+     * (adapters/sampling.ts). */
+    readonly sampling?: SamplingParams;
+    /** Unified tool-calling (spec §4.4) — tools the model may call. Adapters map
+     * to native tool shapes; absent => no tool surface (identical to today). */
+    readonly tools?: readonly ToolDefinition[];
+    /** Tool-selection directive; only meaningful alongside `tools`. */
+    readonly toolChoice?: ToolChoice;
+}
+export interface AdapterUsage {
+    /**
+     * Total input tokens for this attempt. NORMALIZATION INVARIANT (cache-aware
+     * accounting, WS-A / spec §2): `tokensIn` INCLUDES both `tokensCached` (cache
+     * reads) and `tokensCacheWrite` (cache creation) as SUBSETS — never a
+     * partition. Every adapter maps to this convention (the anthropic adapter
+     * adds cache_read + cache_creation back onto its `input_tokens`, which the
+     * provider reports EXCLUSIVE of them — research §4). Cost math
+     * (`estimateCostUsd`) relies on it: `uncached = tokensIn − cached − write`.
+     */
+    readonly tokensIn: number;
+    readonly tokensOut: number;
+    /** Cache-READ input tokens — a subset of `tokensIn`, billed at the read rate. */
+    readonly tokensCached: number;
+    /**
+     * Cache-CREATION (write) input tokens — a subset of `tokensIn`, billed at the
+     * write rate (a premium on some providers: Anthropic 1.25× 5m / 2× 1h, OpenAI
+     * 5.6+ 1.25×; free elsewhere). OPTIONAL and additive (WS-A): adapters that do
+     * not report cache writes (deepseek, gemini, older OpenAI) omit it and it is
+     * read as 0 downstream — so those adapters need NO change. Only anthropic and
+     * the openai-dialect adapters (GPT-5.6+ `cache_write_tokens`) set it.
+     */
+    readonly tokensCacheWrite?: number;
+    /** The 1h-TTL portion of `tokensCacheWrite` (Anthropic only; bills at the
+     * higher 2× multiplier). A subset of `tokensCacheWrite`. Optional/additive:
+     * absent ⇒ 0, i.e. all cache-write was the default (5m) tier. */
+    readonly tokensCacheWrite1h?: number;
+    readonly servedTier: ServiceTier;
+    /** Time to first body byte, ms (Phase 4 WS3 — headers lie on inference
+     * servers; TTFB is the honest slowness signal). Streaming adapters stamp
+     * first-chunk arrival; non-streaming calls equal total latency (the first
+     * byte genuinely arrives with the body). Optional: absent on failures
+     * where nothing arrived. */
+    readonly ttfbMs?: number;
+}
+export type AdapterResult = {
+    readonly ok: true;
+    readonly text: string;
+    readonly usage: AdapterUsage;
+    /** Normalized tool calls the model emitted (spec §4.4) — present only
+     * when the request supplied `tools` and the model chose to call one.
+     * A tool-call turn carries these instead of (or alongside) `text`; the
+     * run loop surfaces them and does NOT schema-validate the turn. */
+    readonly toolCalls?: readonly ToolCall[];
+}
+/** F1 (C1 finding, closed Phase 3 step 0): failures that still BILLED
+ * tokens (refusals, truncations, post-stream rejections) carry `usage` so
+ * envelopes, telemetry, and bake-off cost math see the spend. Absent when
+ * the provider billed nothing (transport errors, pre-dispatch rejections). */
+ | {
+    readonly ok: false;
+    readonly failure: RigFailure;
+    readonly usage?: AdapterUsage;
+};
+/** One event from an adapter's streaming variant (G-1/G-5 Phase A). A stream
+ * emits zero or more `delta` events (raw, pre-validation text) and closes with
+ * exactly one `final` carrying the same `AdapterResult` `call()` would return —
+ * so the run loop's cost/validation/telemetry logic is identical for streamed
+ * and buffered dispatch. */
+export type AdapterStreamEvent = {
+    readonly kind: "delta";
+    readonly text: string;
+} | {
+    readonly kind: "final";
+    readonly result: AdapterResult;
+};
+export interface ProviderAdapter {
+    readonly id: ProviderId;
+    supports(feature: CapabilityFlag, model: string): boolean;
+    /** Whether this model exposes native tool-calling (spec §4.4). Optional and
+     * additive: absent => unknown/unsupported. Separate from CapabilityFlag on
+     * purpose — tool support is a call-shaping fact, not a probed/registry
+     * capability, so it stays out of the flag machinery (ZDR, claims, templates). */
+    supportsTools?(model: string): boolean;
+    call(req: AdapterRequest): Promise<AdapterResult>;
+    /** Optional streaming variant (spec §4.3). Adapters that can stream deltas
+     * implement it; the run loop falls back to `call()` (buffered) when absent. */
+    stream?(req: AdapterRequest): AsyncIterable<AdapterStreamEvent>;
+}
+export {};
+//# sourceMappingURL=provider.d.ts.map

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

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

package/dist/types/provider.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * ProviderAdapter contract + the candidate-set invariant's type machinery.
+ * Spec §4. The invariant is structural: AdapterRequest carries a CandidateRef,
+ * and CandidateRef is a branded type constructible ONLY in run/resolve.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_CAPABILITY_FLAGS = exports.PROVIDER_IDS = void 0;
+/** Runtime enumeration of every ProviderId — the single list a raw-model lane
+ * (`provider/model`) validates against (http gateway spec §3.3). Kept in sync
+ * with the `ProviderId` union by the two compile-time assertions below: adding
+ * a provider to the union without adding it here (or vice-versa) fails the
+ * type-check. */
+exports.PROVIDER_IDS = [
+    "gemini",
+    "openai",
+    "deepseek",
+    "anthropic",
+    "grok",
+    "deepinfra",
+    "fireworks",
+];
+// Every entry is a valid ProviderId …
+const _providerIdsAreValid = exports.PROVIDER_IDS;
+const _noMissingProviderId = true;
+void _providerIdsAreValid;
+void _noMissingProviderId;
+/** The canonical flag enumeration — the single list every static capability
+ * materialization iterates (index.ts, template validation, tests). */
+exports.ALL_CAPABILITY_FLAGS = [
+    "structured_native",
+    "json_mode",
+    "grounded_native",
+    "context_cache_explicit",
+    "prompt_cache_key",
+    "prefix_cache_implicit",
+    "tier_flex",
+    "trace_visible",
+    "zero_retention",
+];