@agentproto/model-catalog 0.8.3 → 0.9.0

package/dist/catalog-Cg0AJJZ7.d.ts

@@ -0,0 +1,1608 @@
+import { b as CatalogProvider } from './base-B8IIoaqg.js';
+
+declare const OPENROUTER_ROUTES: Record<string, LLMPricing>;
+
+interface ContextWindowEntry {
+    contextWindow: number;
+    maxOutput?: number;
+    displayName?: string;
+    provider: "anthropic" | "groq" | "xai" | "moonshot" | "mistral" | "google";
+}
+declare const CONTEXT_WINDOWS: Record<string, ContextWindowEntry>;
+
+/**
+ * LLM Pricing Catalog — per-token costs for all LLM models.
+ *
+ * Migrated from `packages/core/src/config/llm-pricing.ts` (commit `eeb1acdc`
+ * era). The original location now re-exports from here so every existing
+ * consumer (orchestrator dynamic imports, agent-analytics) keeps working.
+ *
+ * Prices in USD per 1M tokens (input and output separated).
+ * Credit costs are what we charge users (includes margin).
+ */
+
+interface LLMPricing {
+    /** Provider cost: $ per 1M input tokens */
+    inputPer1M: number;
+    /** Provider cost: $ per 1M output tokens */
+    outputPer1M: number;
+    /**
+     * Strategic per-model centicredit override for input. Bypasses the
+     * default `inputPer1M × text-markup / CC_USD_RATE` formula. Use only
+     * for explicit loss-leader / promo models — formula path is
+     * cost-plus-margin by construction and self-heals when providers
+     * change rates.
+     *
+     * Unit: **centicredits per 1M input tokens** (1 displayed credit =
+     * 100 cc). Example: `overrideCreditInputPer1M: 1000` charges 10
+     * displayed credits per 1M input tokens.
+     */
+    overrideCreditInputPer1M?: number;
+    /** Same as `overrideCreditInputPer1M`, for output tokens. Unit: cc/1M. */
+    overrideCreditOutputPer1M?: number;
+    /**
+     * Provider-side discount for cache-read tokens (Anthropic prompt
+     * caching: ~10% of base input). Default 1.0 — no cache discount —
+     * for providers without prompt caching. Applies to BOTH the
+     * provider-cost calculation AND the derived credit cost so the
+     * margin holds for cached vs uncached tokens.
+     */
+    cacheReadMultiplier?: number;
+    /**
+     * Provider-side premium for cache-creation tokens (Anthropic prompt
+     * caching: ~125% of base input — slightly more than uncached, but
+     * the savings come from subsequent reads). Default 1.0. Applies to
+     * BOTH sides like `cacheReadMultiplier`.
+     */
+    cacheWriteMultiplier?: number;
+    /**
+     * Router / SDK used to call the model. Same model can be reachable via
+     * multiple providers — `claude-sonnet-4-5` is `provider: "anthropic"`
+     * when called through the Anthropic SDK and `provider: "openrouter"`
+     * when routed through OpenRouter. Distinct from `vendor`: this is HOW
+     * we reach the model, not WHO made it.
+     *   - bare ids (`claude-sonnet-4-5`, `gpt-4o`, `gemini-2.5-flash`)
+     *     → `"anthropic" | "openai" | "google"` (direct providers)
+     *   - slash ids (`anthropic/claude-sonnet-4-5`, `qwen/qwen3-coder`)
+     *     → `"openrouter"` (always — the slash is the OpenRouter route
+     *     convention and the OpenRouter SDK is what runs them)
+     *
+     * The runtime can still pass an explicit `connectorUsed` to
+     * `emitUsageEvent` — that wins over this default and covers the
+     * edge case where a guild has multiple connectors and the
+     * dispatcher routed to a non-default one.
+     */
+    provider?: CatalogProvider;
+    /**
+     * Who authored / built the model. Permanent attribute, independent of
+     * the router: `claude-sonnet-4-5` is always `vendor: "anthropic"`
+     * regardless of whether `provider` is `"anthropic"` (direct) or
+     * `"openrouter"` (proxied). Used for display labels, BYOK gating, and
+     * analytics grouping. Examples: `anthropic`, `openai`, `google`,
+     * `moonshot`, `mistralai`, `minimax`, `meta`, `qwen`, `deepseek`.
+     */
+    vendor?: string;
+    /**
+     * ISO date (`YYYY-MM-DD`) this id was first seen by a catalog-sync run.
+     * Generator-owned (currently emitted by `llm:openrouter` / `llm:requesty`;
+     * hand-maintained catalog rows below leave it unset) — backfilled from the
+     * provider's own creation timestamp when the source has one, else the
+     * sync run's date, and NEVER mutated once stamped. See
+     * `packages/catalog-sync/src/added-at.ts` and
+     * `packages/catalog-sync/README.md` for the full convention.
+     */
+    addedAt?: string;
+}
+
+declare const LLM_PRICING_CATALOG: {
+    "grok-4.20": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-0309": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-0309-non-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-0309-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-0309": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-0309-non-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-0309-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-latest-non-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-latest-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-non-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-beta-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-experimental-beta-0304": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-experimental-beta-0304-non-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-experimental-beta-0304-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-experimental-beta-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-experimental-beta-non-reasoning-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-experimental-beta-reasoning-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-multi-agent": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-multi-agent-0309": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-multi-agent-beta-0309": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-multi-agent-beta-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-multi-agent-experimental-beta-0304": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-multi-agent-experimental-beta-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-multi-agent-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-non-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-non-reasoning-gv2": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-non-reasoning-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-reasoning": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-reasoning-gv2": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.20-reasoning-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.3": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.3-latest": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 2.5;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2.5;
+            readonly outputPer1M: 5;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.5": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 6;
+        readonly cachedInputPer1M: 0.3;
+        readonly longContext: {
+            readonly inputPer1M: 4;
+            readonly outputPer1M: 12;
+            readonly cachedInputPer1M: 0.6;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.5-latest": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 6;
+        readonly cachedInputPer1M: 0.3;
+        readonly longContext: {
+            readonly inputPer1M: 4;
+            readonly outputPer1M: 12;
+            readonly cachedInputPer1M: 0.6;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-4.6": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 6;
+        readonly cachedInputPer1M: 0.5;
+        readonly longContext: {
+            readonly inputPer1M: 4;
+            readonly outputPer1M: 12;
+            readonly cachedInputPer1M: 1;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-build-0.1": {
+        readonly inputPer1M: 1;
+        readonly outputPer1M: 2;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2;
+            readonly outputPer1M: 4;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-build-latest": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 6;
+        readonly cachedInputPer1M: 0.3;
+        readonly longContext: {
+            readonly inputPer1M: 4;
+            readonly outputPer1M: 12;
+            readonly cachedInputPer1M: 0.6;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-code-fast": {
+        readonly inputPer1M: 1;
+        readonly outputPer1M: 2;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2;
+            readonly outputPer1M: 4;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-code-fast-1": {
+        readonly inputPer1M: 1;
+        readonly outputPer1M: 2;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2;
+            readonly outputPer1M: 4;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "grok-code-fast-1-0825": {
+        readonly inputPer1M: 1;
+        readonly outputPer1M: 2;
+        readonly cachedInputPer1M: 0.2;
+        readonly longContext: {
+            readonly inputPer1M: 2;
+            readonly outputPer1M: 4;
+            readonly cachedInputPer1M: 0.4;
+            readonly thresholdTokens: 200000;
+        };
+        readonly vendor: "xai";
+        readonly provider: "xai";
+    };
+    "M2-her": {
+        readonly inputPer1M: 0.3;
+        readonly outputPer1M: 1.2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "minimax";
+        readonly provider: "minimax";
+    };
+    "MiniMax-M2": {
+        readonly inputPer1M: 0.255;
+        readonly outputPer1M: 1.02;
+        readonly vendor: "minimax";
+        readonly provider: "minimax";
+    };
+    "MiniMax-M2.1": {
+        readonly inputPer1M: 0.3;
+        readonly outputPer1M: 1.2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "minimax";
+        readonly provider: "minimax";
+    };
+    "MiniMax-M2.5": {
+        readonly inputPer1M: 0.27;
+        readonly outputPer1M: 1.08;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "minimax";
+        readonly provider: "minimax";
+    };
+    "MiniMax-M2.7": {
+        readonly inputPer1M: 0.3;
+        readonly outputPer1M: 1.2;
+        readonly cacheReadMultiplier: 0.2;
+        readonly vendor: "minimax";
+        readonly provider: "minimax";
+    };
+    "gpt-3.5-turbo": {
+        readonly inputPer1M: 0.5;
+        readonly outputPer1M: 1.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-3.5-turbo-0613": {
+        readonly inputPer1M: 1;
+        readonly outputPer1M: 2;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-3.5-turbo-16k": {
+        readonly inputPer1M: 3;
+        readonly outputPer1M: 4;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-3.5-turbo-instruct": {
+        readonly inputPer1M: 1.5;
+        readonly outputPer1M: 2;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4": {
+        readonly inputPer1M: 30;
+        readonly outputPer1M: 60;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4-turbo": {
+        readonly inputPer1M: 10;
+        readonly outputPer1M: 30;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4-turbo-preview": {
+        readonly inputPer1M: 10;
+        readonly outputPer1M: 30;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4.1": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 8;
+        readonly cacheReadMultiplier: 0.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4.1-mini": {
+        readonly inputPer1M: 0.4;
+        readonly outputPer1M: 1.6;
+        readonly cacheReadMultiplier: 0.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4.1-nano": {
+        readonly inputPer1M: 0.1;
+        readonly outputPer1M: 0.4;
+        readonly cacheReadMultiplier: 0.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4o": {
+        readonly inputPer1M: 2.5;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4o-2024-05-13": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 15;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4o-2024-08-06": {
+        readonly inputPer1M: 2.5;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4o-2024-11-20": {
+        readonly inputPer1M: 2.5;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4o-mini": {
+        readonly inputPer1M: 0.15;
+        readonly outputPer1M: 0.6;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-4o-mini-2024-07-18": {
+        readonly inputPer1M: 0.15;
+        readonly outputPer1M: 0.6;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5-image": {
+        readonly inputPer1M: 10;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.125;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5-image-mini": {
+        readonly inputPer1M: 2.5;
+        readonly outputPer1M: 2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5-mini": {
+        readonly inputPer1M: 0.25;
+        readonly outputPer1M: 2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5-nano": {
+        readonly inputPer1M: 0.05;
+        readonly outputPer1M: 0.4;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5-pro": {
+        readonly inputPer1M: 15;
+        readonly outputPer1M: 120;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.1": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.1-codex": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.104;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.1-codex-max": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.1-codex-mini": {
+        readonly inputPer1M: 0.25;
+        readonly outputPer1M: 2;
+        readonly cacheReadMultiplier: 0.12;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.2": {
+        readonly inputPer1M: 1.75;
+        readonly outputPer1M: 14;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.2-chat": {
+        readonly inputPer1M: 1.75;
+        readonly outputPer1M: 14;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.2-codex": {
+        readonly inputPer1M: 1.75;
+        readonly outputPer1M: 14;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.2-pro": {
+        readonly inputPer1M: 21;
+        readonly outputPer1M: 168;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.3-codex": {
+        readonly inputPer1M: 1.75;
+        readonly outputPer1M: 14;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.4": {
+        readonly inputPer1M: 2.5;
+        readonly outputPer1M: 15;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.4-mini": {
+        readonly inputPer1M: 0.75;
+        readonly outputPer1M: 4.5;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.4-nano": {
+        readonly inputPer1M: 0.2;
+        readonly outputPer1M: 1.25;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.4-pro": {
+        readonly inputPer1M: 30;
+        readonly outputPer1M: 180;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.5": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 30;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.5-pro": {
+        readonly inputPer1M: 30;
+        readonly outputPer1M: 180;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.6-luna": {
+        readonly inputPer1M: 0.2;
+        readonly outputPer1M: 1.2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.6-luna-pro": {
+        readonly inputPer1M: 0.2;
+        readonly outputPer1M: 1.2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.6-sol": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.6-sol-pro": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.6-terra": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 12;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-5.6-terra-pro": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 12;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-audio": {
+        readonly inputPer1M: 2.5;
+        readonly outputPer1M: 10;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-audio-mini": {
+        readonly inputPer1M: 0.6;
+        readonly outputPer1M: 2.4;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-chat-latest": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 30;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-oss-120b": {
+        readonly inputPer1M: 0.037;
+        readonly outputPer1M: 0.17;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-oss-120b:batch": {
+        readonly inputPer1M: 0.15;
+        readonly outputPer1M: 0.6;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-oss-20b": {
+        readonly inputPer1M: 0.03;
+        readonly outputPer1M: 0.13;
+        readonly cacheReadMultiplier: 1;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-oss-20b:batch": {
+        readonly inputPer1M: 0.05;
+        readonly outputPer1M: 0.2;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gpt-oss-safeguard-20b": {
+        readonly inputPer1M: 0.075;
+        readonly outputPer1M: 0.3;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    o1: {
+        readonly inputPer1M: 15;
+        readonly outputPer1M: 60;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "o1-pro": {
+        readonly inputPer1M: 150;
+        readonly outputPer1M: 600;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    o3: {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 8;
+        readonly cacheReadMultiplier: 0.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "o3-mini": {
+        readonly inputPer1M: 1.1;
+        readonly outputPer1M: 4.4;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "o3-mini-high": {
+        readonly inputPer1M: 1.1;
+        readonly outputPer1M: 4.4;
+        readonly cacheReadMultiplier: 0.5;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "o3-pro": {
+        readonly inputPer1M: 20;
+        readonly outputPer1M: 80;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "o4-mini": {
+        readonly inputPer1M: 1.1;
+        readonly outputPer1M: 4.4;
+        readonly cacheReadMultiplier: 0.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "o4-mini-high": {
+        readonly inputPer1M: 1.1;
+        readonly outputPer1M: 4.4;
+        readonly cacheReadMultiplier: 0.25;
+        readonly vendor: "openai";
+        readonly provider: "openai";
+    };
+    "gemini-2.5-flash": {
+        readonly inputPer1M: 0.3;
+        readonly outputPer1M: 2.5;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "google";
+        readonly provider: "google";
+    };
+    "gemini-2.5-flash-lite": {
+        readonly inputPer1M: 0.1;
+        readonly outputPer1M: 0.4;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "google";
+        readonly provider: "google";
+    };
+    "gemini-2.5-pro": {
+        readonly inputPer1M: 1.25;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "google";
+        readonly provider: "google";
+    };
+    "gemini-3-flash-preview": {
+        readonly inputPer1M: 0.5;
+        readonly outputPer1M: 3;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "google";
+        readonly provider: "google";
+    };
+    "gemini-3.1-flash-lite": {
+        readonly inputPer1M: 0.25;
+        readonly outputPer1M: 1.5;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "google";
+        readonly provider: "google";
+    };
+    "gemini-3.1-pro-preview": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 12;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "google";
+        readonly provider: "google";
+    };
+    "gemini-3.5-flash": {
+        readonly inputPer1M: 1.5;
+        readonly outputPer1M: 9;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "google";
+        readonly provider: "google";
+    };
+    "claude-fable-5": {
+        readonly inputPer1M: 10;
+        readonly outputPer1M: 50;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-haiku-4-5": {
+        readonly inputPer1M: 1;
+        readonly outputPer1M: 5;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-haiku-4-5-20251001": {
+        readonly inputPer1M: 1;
+        readonly outputPer1M: 5;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-opus-4-5": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 25;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-opus-4-5-20251101": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 25;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-opus-4-6": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 25;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-opus-4-7": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 25;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-opus-4-8": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 25;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-opus-5": {
+        readonly inputPer1M: 5;
+        readonly outputPer1M: 25;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-sonnet-4-5": {
+        readonly inputPer1M: 3;
+        readonly outputPer1M: 15;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-sonnet-4-5-20250929": {
+        readonly inputPer1M: 3;
+        readonly outputPer1M: 15;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-sonnet-4-6": {
+        readonly inputPer1M: 3;
+        readonly outputPer1M: 15;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "claude-sonnet-5": {
+        readonly inputPer1M: 2;
+        readonly outputPer1M: 10;
+        readonly cacheReadMultiplier: 0.1;
+        readonly cacheWriteMultiplier: 1.25;
+        readonly vendor: "anthropic";
+        readonly provider: "anthropic";
+    };
+    "kimi-k2.6": {
+        readonly inputPer1M: 0.95;
+        readonly outputPer1M: 4;
+        readonly cacheReadMultiplier: 0.1684;
+        readonly vendor: "moonshot";
+        readonly provider: "moonshot";
+    };
+    "kimi-k2.7-code": {
+        readonly inputPer1M: 0.66;
+        readonly outputPer1M: 3.4;
+        readonly cacheReadMultiplier: 0.2727;
+        readonly vendor: "moonshot";
+        readonly provider: "moonshot";
+    };
+    "kimi-k3": {
+        readonly inputPer1M: 3;
+        readonly outputPer1M: 15;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "moonshot";
+        readonly provider: "moonshot";
+    };
+    "codestral-2508": {
+        readonly inputPer1M: 0.3;
+        readonly outputPer1M: 0.9;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "ministral-14b-2512": {
+        readonly inputPer1M: 0.2;
+        readonly outputPer1M: 0.2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "ministral-3b-2512": {
+        readonly inputPer1M: 0.1;
+        readonly outputPer1M: 0.1;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "ministral-8b-2512": {
+        readonly inputPer1M: 0.15;
+        readonly outputPer1M: 0.15;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "mistral-large-2512": {
+        readonly inputPer1M: 0.5;
+        readonly outputPer1M: 1.5;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "mistral-medium-3": {
+        readonly inputPer1M: 0.4;
+        readonly outputPer1M: 2;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "mistral-medium-3-5": {
+        readonly inputPer1M: 1.5;
+        readonly outputPer1M: 7.5;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "mistral-medium-3.5": {
+        readonly inputPer1M: 1.5;
+        readonly outputPer1M: 7.5;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+    "mistral-small-2603": {
+        readonly inputPer1M: 0.15;
+        readonly outputPer1M: 0.6;
+        readonly cacheReadMultiplier: 0.1;
+        readonly vendor: "mistral";
+        readonly provider: "mistral";
+    };
+};
+/**
+ * Every canonical catalog model id. Existence is NOT the same question as
+ * "does this id have a price" — `LLM_PRICING_CATALOG`'s keys alone used to
+ * answer both, which meant a real, live, provider-published model with no
+ * pricing row yet (the Anthropic `claude-opus-4-6` incident: synced by
+ * `catalog-sync`, present in `CONTEXT_WINDOWS`, absent here) simply ceased
+ * to exist anywhere downstream — invisible in `agentproto models`, unlisted
+ * in every adapter's native allow-list, silently resolved to a stale alias.
+ * `LlmModelId` now unions the pricing keys with `CONTEXT_WINDOWS` (each
+ * provider's own synced `/v1/models` id list — see
+ * `packages/catalog-sync/src/generators/llm-context-windows.ts` — carries
+ * ids independent of whether a price has synced yet) and `OPENROUTER_ROUTES`
+ * (thousands of ids, self-updating). A model can be a member of this type
+ * with `resolvePricing` returning `undefined` for it — callers MUST treat
+ * that as "price not yet known," never as "doesn't exist" (see
+ * `ResolvedModel`'s `pricing?` in `registry/index.ts`, and `isKnownLlmId`
+ * below for an existence-only check). Downstream curation/config should
+ * still constrain ids to this type so a typo is a build error.
+ */
+type LlmModelId = keyof typeof LLM_PRICING_CATALOG | keyof typeof CONTEXT_WINDOWS | keyof typeof OPENROUTER_ROUTES;
+/**
+ * True iff `modelId` is a real, known catalog id — regardless of whether it
+ * has a price yet. Use this (not `resolvePricing(id) !== undefined`) to
+ * answer "does this model exist"; use `resolvePricing`/`resolvePricingExact`
+ * to answer "what does it cost" — the two questions are independent by
+ * design, see `LlmModelId`'s doc comment.
+ */
+declare function isKnownLlmId(modelId: string): boolean;
+/**
+ * Every known LLM id that has NO pricing row (`CONTEXT_WINDOWS` ∪
+ * `OPENROUTER_ROUTES`, minus whatever `LLM_PRICING_CATALOG` already prices)
+ * — the enumeration `listModels`'s `llm` branch needs to surface a
+ * known-but-unpriced model instead of silently dropping it. Each entry
+ * carries its provider when derivable (see `getModelProvider`).
+ */
+declare function listUnpricedKnownLlmIds(): Array<{
+    id: string;
+    provider: CatalogProvider | undefined;
+}>;
+declare const MODEL_ALIASES: {
+    "claude-4-opus": string;
+    "claude-4-sonnet": string;
+    "claude-3-5-haiku": string;
+    "claude-haiku-4-5-20251001": string;
+    "claude-opus-4": string;
+    "claude-sonnet-4": string;
+    "claude-haiku-3.5": string;
+    "gemini-3.1-flash-lite-preview": string;
+    "google/gemini-3.1-pro-preview": string;
+    "google/gemini-3.5-flash": string;
+    "google/gemini-3-flash-preview": string;
+    "google/gemini-3.1-flash-lite": string;
+    "google/gemini-2.5-flash": string;
+    "google/gemini-2.5-flash-lite": string;
+    "google/gemini-2.5-pro": string;
+    "openai/gpt-4.1": string;
+    "openai/gpt-4.1-mini": string;
+    "openai/gpt-4.1-nano": string;
+    "openai/gpt-5": string;
+    "openai/gpt-5.1": string;
+    "openai/gpt-5.2": string;
+    "openai/gpt-5.4": string;
+    "openai/gpt-5.4-mini": string;
+    "openai/gpt-5.4-nano": string;
+    "openai/gpt-5.5": string;
+    "openai/o3": string;
+    "openai/o4-mini": string;
+    "openai/o3-mini": string;
+    "openai/o1": string;
+    "openai/o1-mini": string;
+    "minimax-m2": string;
+    "minimax-m2.1": string;
+    "minimax-m2.5": string;
+    "minimax-m2.7": string;
+    "kimi-k2": string;
+    "moonshotai/kimi-k2.5": string;
+    "moonshotai/kimi-k2.6": string;
+    "moonshotai/kimi-k2.7-code": string;
+    "moonshotai/kimi-k3": string;
+    "mistralai/mistral-large-latest": string;
+    "mistralai/mistral-small-latest": string;
+    "mistralai/mistral-medium-latest": string;
+    "mistralai/mistral-medium-3-5": string;
+    "mistralai/codestral-latest": string;
+    "mistralai/ministral-8b-latest": string;
+    "mistralai/devstral-latest": string;
+    "mistralai/magistral-small-latest": string;
+    "mistralai/devstral-medium-latest": string;
+    "grok-latest": string;
+};
+/** Every alias id that resolves to a canonical model — the alias keys. */
+type LlmModelAlias = keyof typeof MODEL_ALIASES;
+/** Any model id the catalog recognises — canonical key or alias. */
+type KnownLlmId = LlmModelId | LlmModelAlias;
+/**
+ * Resolves a model id to its pricing entry. Tries direct match → alias →
+ * partial-prefix match. Used both for cost computation and BYOK shadow
+ * accounting; semantics are load-bearing for migration.
+ */
+declare function resolvePricing(modelId: string): LLMPricing | undefined;
+/**
+ * Like {@link resolvePricing} but WITHOUT the substring/partial-prefix
+ * fallback — an id resolves ONLY on an exact catalog key or an exact alias.
+ * The substring scan in `resolvePricing` (intended for dated snapshots like
+ * `claude-sonnet-4-6-20260301` → `claude-sonnet-4`) also over-fires for
+ * unrelated cross-product siblings (`gemini-2.5-flash-image` substring-hits
+ * the `gemini-2.5-flash` row), so any caller that must PROVE a verbatim
+ * first-party identity — e.g. the direct-vendor route restore in
+ * `serviceableModelRoutes` — needs this exact form instead. Semantics of
+ * `resolvePricing`/`resolveAlias` are intentionally left unchanged for their
+ * existing callers.
+ */
+declare function resolvePricingExact(modelId: string): LLMPricing | undefined;
+/**
+ * Resolves a model id to its canonical catalog key (or the original id if no
+ * match). Public surface for consumers that need the canonical id without
+ * the pricing payload.
+ */
+declare function resolveAlias(modelId: string): string;
+/**
+ * Resolves a model id to its live context window (max input tokens) and max
+ * output tokens, sourced from `CONTEXT_WINDOWS`
+ * (`packages/catalog-sync/src/generators/llm-context-windows.ts` — re-synced
+ * from each provider's live `/v1/models` endpoint; never hand-maintain these
+ * numbers). Covers Anthropic, Groq, xAI, and Moonshot — the providers that
+ * publish this data live. Handles bare aliases the provider's own API doesn't
+ * use ("claude-haiku-4-5" vs. the dated live id "claude-haiku-4-5-20251001")
+ * via prefix match, then falls back through the pricing alias table for
+ * older aliases. Returns undefined for ids no synced provider carries.
+ */
+declare function resolveContextWindow(modelId: string): ContextWindowEntry | undefined;
+/**
+ * Every live model id `CONTEXT_WINDOWS` carries for one provider — sourced
+ * straight from that provider's own `/v1/models` sync (`llm-context-windows.ts`
+ * generator), independent of whether the id has landed a pricing row yet.
+ *
+ * The one legitimate consumer of this today: an adapter's `models.allowed`
+ * curation for its native (non-gateway) provider surface. Deriving that list
+ * from here instead of a hand-typed array means a newly-published id (e.g.
+ * Anthropic shipping `claude-opus-4-9`) becomes offerable the moment the next
+ * catalog-sync run picks it up — no code change, no PR. An adapter that wants
+ * to hide a specific id anyway (deprecated, not yet vetted) does so with its
+ * OWN small denylist filtering this list's output, never by omitting the id
+ * from a hand-typed allowlist that silently also hides every future id.
+ */
+declare function listNativeModelIds(provider: ContextWindowEntry["provider"]): string[];
+/**
+ * Resolve a model id to its DEFAULT provider — the single source of truth for
+ * "which SDK reaches this model when no per-model override is set". Reads the
+ * resolved catalog entry's `provider` field (direct id → alias → partial
+ * prefix, same resolution as `resolvePricing`). Returns undefined for unknown
+ * ids so callers can fall back to their own heuristic.
+ *
+ * This is the abstraction that decouples the provider from the model-id STRING:
+ * instead of inferring "claude-* → anthropic" at each call site, the provider
+ * is an explicit catalog attribute. A model reachable through more than one
+ * provider (e.g. Claude via the direct Anthropic SDK vs. OpenRouter) is held as
+ * distinct catalog entries — the bare id (`claude-haiku-4-5`, provider
+ * `anthropic`) and the slash route (`anthropic/claude-haiku-4.5`, provider
+ * `openrouter`) — each carrying its own `provider`.
+ */
+declare function getModelProvider(modelId: string): CatalogProvider | undefined;
+/**
+ * The unified registry view of a model: canonical id, default provider, vendor,
+ * and pricing — everything the routing + billing layers need from ONE lookup.
+ * Returns undefined for unknown ids.
+ */
+interface ModelRoute {
+    /** Canonical catalog key (post-alias). */
+    canonicalId: string;
+    /** Default provider — the SDK used when no per-model override is set. */
+    provider?: CatalogProvider;
+    /** Model author/vendor (permanent; independent of the routing provider). */
+    vendor?: string;
+    /** Billing pricing entry. */
+    pricing: LLMPricing;
+}
+declare function resolveModelRoute(modelId: string): ModelRoute | undefined;
+/**
+ * Default fallback: roughly gemini-flash pricing (cheapest). Unknown
+ * model ids resolve to this — the formula path then computes credit
+ * cost from `inputPer1M`/`outputPer1M`, so unknown models always price
+ * at default markup × cheap-model rates, never at zero.
+ */
+declare const DEFAULT_PRICING: LLMPricing;
+interface LLMCreditCostResult {
+    /**
+     * Total **centicredits** to charge — what `useAccountCredits` debits
+     * directly (ledger column is cc). Reflects any per-model override or
+     * per-app markup; never below `MIN_CREDITS_PER_TURN_CC`.
+     *
+     * Unit: cc (1 displayed credit = 100 cc). Format for display with
+     * `displayCredits(cc) → cr`.
+     */
+    credits: number;
+    /**
+     * What the *pure formula* would have charged (provider cost ×
+     * text-markup), independent of per-model overrides. Surfaced so
+     * `usage_events.calculated_credits` can record the formula-derived
+     * value next to the override-applied debit — easy reconciliation
+     * against Langfuse traces. Unit: cc.
+     */
+    calculatedCredits: number;
+    /** Breakdown of `credits` (each in cc). */
+    inputCredits: number;
+    outputCredits: number;
+    cacheReadCredits: number;
+    cacheWriteCredits: number;
+    /** Production cost in USD (true provider cost, with cache multipliers applied). */
+    productionCost: number;
+    /** Model pricing used */
+    pricing: LLMPricing;
+    /** Whether fallback pricing was used */
+    isFallback: boolean;
+    /** Markup actually applied. Same as `pricingRegistry.getMarkup("text", appId)` when no override. */
+    markup: number;
+    /** True when a per-model `overrideCredit*Per1M` field bypassed the formula. */
+    hasOverride: boolean;
+}
+interface LLMUsageBreakdown {
+    /**
+     * Input tokens that were NOT served from cache. With Anthropic prompt
+     * caching, providers often report `inputTokens` already EXCLUDING
+     * cached portions — pass the same number you'd pass to the legacy
+     * 3-arg signature; cache fields are ADDED on top.
+     */
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+}
+interface CalculateLLMCreditCostOptions {
+    /**
+     * App invoking the LLM. Routes per-app markup overrides registered
+     * via `pricingRegistry.registerApp(appId, ...)`. When omitted, core
+     * defaults apply.
+     */
+    appId?: string;
+    /**
+     * Direct markup override (escape hatch for tests / one-off
+     * reconciliation). When set, bypasses `pricingRegistry` for both
+     * formula and `calculatedCredits` math. Takes precedence over
+     * `appId`.
+     */
+    markupOverride?: number;
+}
+declare function calculateLLMCreditCost(modelId: string, inputTokens: number, outputTokens: number): LLMCreditCostResult;
+declare function calculateLLMCreditCost(modelId: string, usage: LLMUsageBreakdown, opts?: CalculateLLMCreditCostOptions): LLMCreditCostResult;
+interface CacheStats {
+    /**
+     * Cache hit rate as a 0..1 fraction of total input tokens (raw + cache
+     * read + cache create). 0 means no cache activity, 1 means everything
+     * read from cache, 0 for output-only calls. `null` when there were no
+     * input tokens at all.
+     */
+    cacheHitRate: number | null;
+    /**
+     * Provider USD we *saved* vs the same input billed at the uncached
+     * rate. Cache reads at 0.1× save 0.9× of the input cost; cache writes
+     * at 1.25× actually COST 0.25× more than uncached (negative savings).
+     * Sum across both. Negative means cache-write overhead exceeded
+     * cache-read savings (rare — usually means the prompt prefix was
+     * cached on the first turn but never re-used).
+     */
+    providerCostSavedUsd: number;
+    /**
+     * Centicredits the user *saved* vs the same input billed at the
+     * uncached rate. Same sign convention as `providerCostSavedUsd`.
+     * Unit: cc (format with `displayCredits(cc)` for UI).
+     */
+    creditsSaved: number;
+    /**
+     * True iff the model carries cache multipliers in its pricing.
+     * Useful for explaining "this model doesn't support caching" in UI.
+     */
+    cacheSupported: boolean;
+}
+/**
+ * Turn a credit-cost result into cache-utilisation stats. Pure compute.
+ *
+ * Use cases:
+ *   - "Cache saved 87% on this call" in a UI tooltip.
+ *   - Per-conversation dashboards: "across this conversation, prompt
+ *     caching saved you $0.42 / 12 credits."
+ *   - Regression alarms — if cacheHitRate drops below an expected
+ *     threshold on a known-cacheable workload, something broke in
+ *     prompt-prefix stability.
+ *
+ * Returns `cacheSupported: false` for models without cache multipliers
+ * (gpt-4o-mini, gemini, mistral) — all fields are zero in that case
+ * (no cache activity is possible).
+ */
+declare function getCacheStats(modelId: string, usage: LLMUsageBreakdown, opts?: CalculateLLMCreditCostOptions): CacheStats;
+
+export { type CacheStats as C, DEFAULT_PRICING as D, type KnownLlmId as K, type LLMPricing as L, MODEL_ALIASES as M, type LLMCreditCostResult as a, type LLMUsageBreakdown as b, LLM_PRICING_CATALOG as c, calculateLLMCreditCost as d, type CalculateLLMCreditCostOptions as e, type ContextWindowEntry as f, type LlmModelAlias as g, type LlmModelId as h, type ModelRoute as i, getCacheStats as j, getModelProvider as k, isKnownLlmId as l, listNativeModelIds as m, listUnpricedKnownLlmIds as n, resolveAlias as o, resolveContextWindow as p, resolveModelRoute as q, resolvePricing as r, resolvePricingExact as s };