@stll/ai-catalog 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -1,1102 +1,1194 @@
 import * as v from "valibot";
-//#region src/capabilities-overrides.d.ts
-/**
- * Hand-declared capabilities for offered models that models.dev does
- * not cover. The capability generator
- * (`packages/scripts/src/model-catalog-capabilities-gen.ts`) refuses
- * an override for any model the upstream source covers, so manual
- * data cannot shadow sourced data — this file can only ever fill
- * genuine gaps, each with a dated justification.
- */
-type CapabilityOverride = {
-  documentInput: boolean;
-  documentInputReason: string;
-  reasoningEfforts: readonly ReasoningEffort[] | null;
-  temperatureSupported: boolean;
-  /** Why the upstream source cannot answer for this model. Dated. */
-  reason: string;
-};
-declare const CAPABILITY_OVERRIDES: Partial<Record<OfferedBYOKModelId, CapabilityOverride>>;
-//#endregion
-//#region src/document-input-overrides.d.ts
-type DocumentInputOverride = {
-  /** Whether the model accepts a PDF/file content part. */
-  supported: boolean;
-  /** Why the live catalogue cannot answer correctly. Dated. */
-  reason: string;
-};
-/**
- * Reviewed document-input corrections for models.dev records that exist but
- * under-report the provider API's file-input support. The generator rejects an
- * override once upstream agrees, so sourced data takes ownership automatically.
- */
-declare const DOCUMENT_INPUT_OVERRIDES: Partial<Record<OfferedBYOKModelId, DocumentInputOverride>>;
-//#endregion
-//#region src/capabilities.gen.d.ts
-/**
- * Reasoning-effort values each offered model accepts, `null` when the
- * model exposes no effort-style reasoning control. A missing `"none"`
- * means the model's reasoning cannot be disabled; consumers must go
- * through `resolveReasoningEffort`.
- */
-declare const MODEL_REASONING_EFFORTS: {
-  readonly "gemini-3.7-flash": readonly ["low", "medium", "high"];
-  readonly "gemini-3.6-flash": readonly ["minimal", "low", "medium", "high"];
-  readonly "gemini-3.5-flash-lite": readonly ["minimal", "low", "medium", "high"];
-  readonly "gemini-3.1-pro-preview": readonly ["low", "medium", "high"];
-  readonly "gemini-3.5-flash": readonly ["minimal", "low", "medium", "high"];
-  readonly "gemini-3.1-flash-lite": readonly ["minimal", "low", "medium", "high"];
-  readonly "openai/gpt-5.6-luna": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "openai/gpt-5.6-terra": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "google/gemini-3.7-flash": readonly ["low", "medium", "high"];
-  readonly "google/gemini-3.6-flash": readonly ["minimal", "low", "medium", "high"];
-  readonly "google/gemini-3.5-flash-lite": readonly ["minimal", "low", "medium", "high"];
-  readonly "google/gemini-3.1-pro-preview": readonly ["low", "medium", "high"];
-  readonly "google/gemini-3.5-flash": readonly ["minimal", "low", "medium", "high"];
-  readonly "google/gemini-3.1-flash-lite": readonly ["none", "minimal", "low", "medium", "high"];
-  readonly "anthropic/claude-sonnet-5": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "anthropic/claude-opus-5": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "anthropic/claude-opus-4.8": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "anthropic/claude-sonnet-4.6": readonly ["none", "low", "medium", "high", "max"];
-  readonly "openai/gpt-5.5": readonly ["none", "low", "medium", "high", "xhigh"];
-  readonly "openai/gpt-5.4-mini": readonly ["none", "low", "medium", "high", "xhigh"];
-  readonly "gpt-5.6": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "gpt-5.6-terra": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "gpt-5.6-luna": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "gpt-5.5": readonly ["none", "low", "medium", "high", "xhigh"];
-  readonly "gpt-5.4": readonly ["none", "low", "medium", "high", "xhigh"];
-  readonly "gpt-5.4-mini": readonly ["none", "low", "medium", "high", "xhigh"];
-  readonly "gpt-5.4-nano": readonly ["none", "low", "medium", "high", "xhigh"];
-  readonly "gpt-5.2": readonly ["none", "low", "medium", "high", "xhigh"];
-  readonly "claude-sonnet-5": readonly ["none", "low", "medium", "high", "xhigh", "max"];
-  readonly "claude-fable-5-1": readonly ["low", "medium", "high", "xhigh", "max"];
-  readonly "claude-fable-5": readonly ["low", "medium", "high", "xhigh", "max"];
-  readonly "claude-opus-5": readonly ["low", "medium", "high", "xhigh", "max"];
-  readonly "claude-opus-4-8": readonly ["low", "medium", "high", "xhigh", "max"];
-  readonly "claude-opus-4-7": readonly ["low", "medium", "high", "xhigh", "max"];
-  readonly "claude-sonnet-4-6": readonly ["low", "medium", "high", "max"];
-  readonly "claude-opus-4-6": readonly ["low", "medium", "high", "max"];
-  readonly "claude-haiku-4-5-20251001": null;
-  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": null;
-  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": null;
-  readonly "us.amazon.nova-pro-v1:0": null;
-  readonly "us.amazon.nova-lite-v1:0": null;
-  readonly "us.amazon.nova-micro-v1:0": null;
-  readonly "openai.gpt-oss-120b-1:0": readonly ["low", "medium", "high"];
-  readonly "openai.gpt-oss-20b-1:0": readonly ["low", "medium", "high"];
-  readonly "us.deepseek.r1-v1:0": null;
-  readonly "mistral-large-latest": null;
-  readonly "mistral-medium-latest": readonly ["none", "high"];
-  readonly "mistral-small-latest": readonly ["none", "high"];
-  readonly "magistral-medium-latest": null;
-  readonly "magistral-small": null;
-  readonly "pixtral-large-latest": null;
-};
-/**
- * Concrete provider-default effort where the upstream catalogue publishes
- * one. OpenRouter is the source today; null means the provider does not expose
- * a truthful named default, so clients must retain a separate Default choice.
- */
-declare const MODEL_DEFAULT_REASONING_EFFORTS: {
-  readonly "gemini-3.7-flash": null;
-  readonly "gemini-3.6-flash": null;
-  readonly "gemini-3.5-flash-lite": null;
-  readonly "gemini-3.1-pro-preview": null;
-  readonly "gemini-3.5-flash": null;
-  readonly "gemini-3.1-flash-lite": null;
-  readonly "openai/gpt-5.6-luna": "medium";
-  readonly "openai/gpt-5.6-terra": "medium";
-  readonly "google/gemini-3.7-flash": "medium";
-  readonly "google/gemini-3.6-flash": "medium";
-  readonly "google/gemini-3.5-flash-lite": "minimal";
-  readonly "google/gemini-3.1-pro-preview": "medium";
-  readonly "google/gemini-3.5-flash": "medium";
-  readonly "google/gemini-3.1-flash-lite": "minimal";
-  readonly "anthropic/claude-sonnet-5": "high";
-  readonly "anthropic/claude-opus-5": "high";
-  readonly "anthropic/claude-opus-4.8": "high";
-  readonly "anthropic/claude-sonnet-4.6": "medium";
-  readonly "openai/gpt-5.5": "medium";
-  readonly "openai/gpt-5.4-mini": "medium";
-  readonly "gpt-5.6": null;
-  readonly "gpt-5.6-terra": null;
-  readonly "gpt-5.6-luna": null;
-  readonly "gpt-5.5": null;
-  readonly "gpt-5.4": null;
-  readonly "gpt-5.4-mini": null;
-  readonly "gpt-5.4-nano": null;
-  readonly "gpt-5.2": null;
-  readonly "claude-sonnet-5": null;
-  readonly "claude-fable-5-1": null;
-  readonly "claude-fable-5": null;
-  readonly "claude-opus-5": null;
-  readonly "claude-opus-4-8": null;
-  readonly "claude-opus-4-7": null;
-  readonly "claude-sonnet-4-6": null;
-  readonly "claude-opus-4-6": null;
-  readonly "claude-haiku-4-5-20251001": null;
-  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": null;
-  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": null;
-  readonly "us.amazon.nova-pro-v1:0": null;
-  readonly "us.amazon.nova-lite-v1:0": null;
-  readonly "us.amazon.nova-micro-v1:0": null;
-  readonly "openai.gpt-oss-120b-1:0": null;
-  readonly "openai.gpt-oss-20b-1:0": null;
-  readonly "us.deepseek.r1-v1:0": null;
-  readonly "mistral-large-latest": null;
-  readonly "mistral-medium-latest": null;
-  readonly "mistral-small-latest": null;
-  readonly "magistral-medium-latest": null;
-  readonly "magistral-small": null;
-  readonly "pixtral-large-latest": null;
-};
-/**
- * Whether stella should emit a `temperature` sampling override.
- * `"omit"` covers rejected, deprecated, and accepted-but-ignored
- * parameters. Consumers must go through `shouldEmitTemperature`.
- */
-declare const MODEL_TEMPERATURE_POLICIES: {
-  readonly "gemini-3.7-flash": "omit";
-  readonly "gemini-3.6-flash": "omit";
-  readonly "gemini-3.5-flash-lite": "omit";
-  readonly "gemini-3.1-pro-preview": "emit";
-  readonly "gemini-3.5-flash": "emit";
-  readonly "gemini-3.1-flash-lite": "emit";
-  readonly "openai/gpt-5.6-luna": "omit";
-  readonly "openai/gpt-5.6-terra": "omit";
-  readonly "google/gemini-3.7-flash": "omit";
-  readonly "google/gemini-3.6-flash": "omit";
-  readonly "google/gemini-3.5-flash-lite": "omit";
-  readonly "google/gemini-3.1-pro-preview": "emit";
-  readonly "google/gemini-3.5-flash": "emit";
-  readonly "google/gemini-3.1-flash-lite": "emit";
-  readonly "anthropic/claude-sonnet-5": "omit";
-  readonly "anthropic/claude-opus-5": "emit";
-  readonly "anthropic/claude-opus-4.8": "emit";
-  readonly "anthropic/claude-sonnet-4.6": "emit";
-  readonly "openai/gpt-5.5": "omit";
-  readonly "openai/gpt-5.4-mini": "omit";
-  readonly "gpt-5.6": "omit";
-  readonly "gpt-5.6-terra": "omit";
-  readonly "gpt-5.6-luna": "omit";
-  readonly "gpt-5.5": "omit";
-  readonly "gpt-5.4": "emit";
-  readonly "gpt-5.4-mini": "emit";
-  readonly "gpt-5.4-nano": "emit";
-  readonly "gpt-5.2": "emit";
-  readonly "claude-sonnet-5": "omit";
-  readonly "claude-fable-5-1": "omit";
-  readonly "claude-fable-5": "omit";
-  readonly "claude-opus-5": "omit";
-  readonly "claude-opus-4-8": "omit";
-  readonly "claude-opus-4-7": "omit";
-  readonly "claude-sonnet-4-6": "emit";
-  readonly "claude-opus-4-6": "emit";
-  readonly "claude-haiku-4-5-20251001": "emit";
-  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": "emit";
-  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": "emit";
-  readonly "us.amazon.nova-pro-v1:0": "emit";
-  readonly "us.amazon.nova-lite-v1:0": "emit";
-  readonly "us.amazon.nova-micro-v1:0": "emit";
-  readonly "openai.gpt-oss-120b-1:0": "emit";
-  readonly "openai.gpt-oss-20b-1:0": "emit";
-  readonly "us.deepseek.r1-v1:0": "emit";
-  readonly "mistral-large-latest": "emit";
-  readonly "mistral-medium-latest": "emit";
-  readonly "mistral-small-latest": "emit";
-  readonly "magistral-medium-latest": "emit";
-  readonly "magistral-small": "emit";
-  readonly "pixtral-large-latest": "emit";
-};
-//#endregion
-//#region src/index.d.ts
-/**
- * Logical model roles. Call sites declare *what* they need, not
- * *which* model to use.
- *
- * - fast: classification, extraction, short generation
- * - chat: conversational with tool use and streaming
- * - reasoning: complex multi-step legal analysis
- * - pdf: native PDF/image understanding
- */
-declare const MODEL_ROLES: readonly ["fast", "chat", "reasoning", "pdf"];
-type ModelRole = (typeof MODEL_ROLES)[number];
-declare const TEMPERATURE_POLICIES: readonly ["emit", "omit"];
-type TemperaturePolicy = (typeof TEMPERATURE_POLICIES)[number];
-declare const AI_PROVIDERS: readonly ["google", "openrouter", "openai", "azure_foundry", "anthropic", "bedrock", "mistral", "openai_compatible", "huggingface"];
-type AIProvider = (typeof AI_PROVIDERS)[number];
-declare const AI_PROVIDER_ADAPTER_KIND: {
-  readonly google: "tanstack";
-  readonly openrouter: "tanstack";
-  readonly openai: "tanstack";
-  readonly azure_foundry: "custom";
-  readonly anthropic: "tanstack";
-  readonly bedrock: "tanstack";
-  readonly mistral: "tanstack";
-  readonly openai_compatible: "custom";
-  readonly huggingface: "custom";
-};
-type TanStackAIProvider = { [TProvider in AIProvider]: (typeof AI_PROVIDER_ADAPTER_KIND)[TProvider] extends "tanstack" ? TProvider : never; }[AIProvider];
-declare const TANSTACK_AI_PROVIDERS: readonly ["google", "openrouter", "openai", "anthropic", "bedrock", "mistral"];
-declare const MODEL_CATALOG_PROVIDER_KIND: {
-  readonly google: "first-party";
-  readonly openrouter: "aggregator";
-  readonly openai: "first-party";
-  readonly anthropic: "first-party";
-  readonly bedrock: "platform";
-  readonly mistral: "first-party";
-};
-/** Providers whose picker IDs map directly to public first-party catalogs. */
-type FirstPartyModelProvider = { [TProvider in TanStackAIProvider]: (typeof MODEL_CATALOG_PROVIDER_KIND)[TProvider] extends "first-party" ? TProvider : never; }[TanStackAIProvider];
-declare const FIRST_PARTY_MODEL_PROVIDER_VALUES: readonly ["google", "openai", "anthropic", "mistral"];
-/**
- * Runtime form of the first-party provider union. The conditional annotation
- * makes adding a first-party policy without adding its discovery implementation
- * a compile error.
- */
-declare const FIRST_PARTY_MODEL_PROVIDERS: Exclude<FirstPartyModelProvider, (typeof FIRST_PARTY_MODEL_PROVIDER_VALUES)[number]> extends never ? typeof FIRST_PARTY_MODEL_PROVIDER_VALUES : never;
-/**
- * Per-role default model IDs for the BYOK-capable cloud providers.
- * Shared between the instance default table (`DEFAULT_MODELS`) and the
- * settings-UI default selection, so a default is defined exactly once.
- */
-declare const BYOK_DEFAULT_MODELS: {
-  readonly google: {
-    readonly fast: "gemini-3.7-flash";
-    readonly chat: "gemini-3.7-flash";
-    readonly reasoning: "gemini-3.7-flash";
-    readonly pdf: "gemini-3.7-flash";
-  };
-  readonly openrouter: {
-    readonly fast: "openai/gpt-5.6-luna";
-    readonly chat: "openai/gpt-5.6-terra";
-    readonly reasoning: "openai/gpt-5.6-terra";
-    readonly pdf: "openai/gpt-5.6-terra";
-  };
-  readonly openai: {
-    readonly fast: "gpt-5.4-nano";
-    readonly chat: "gpt-5.4-mini";
-    readonly reasoning: "gpt-5.4";
-    readonly pdf: "gpt-5.4";
-  };
-  readonly anthropic: {
-    readonly fast: "claude-opus-5";
-    readonly chat: "claude-opus-5";
-    readonly reasoning: "claude-opus-5";
-    readonly pdf: "claude-opus-5";
-  };
-  readonly bedrock: {
-    readonly fast: "us.amazon.nova-micro-v1:0";
-    readonly chat: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
-    readonly reasoning: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
-    readonly pdf: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
-  };
-  readonly mistral: {
-    readonly fast: "mistral-small-latest";
-    readonly chat: "mistral-medium-latest";
-    readonly reasoning: "magistral-medium-latest";
-    readonly pdf: "mistral-large-latest";
-  };
-};
-/**
- * Instance-level default model IDs per provider. Extends the BYOK
- * defaults with the providers that only the instance path uses
- * (custom deployments and OpenAI-compatible endpoints).
- */
-declare const DEFAULT_MODELS: {
-  readonly azure_foundry: {
-    readonly fast: "gpt-5.4-nano";
-    readonly chat: "gpt-5.4-mini";
-    readonly reasoning: "gpt-5.4";
-    readonly pdf: "gpt-5.4";
-  };
-  readonly openai_compatible: {
-    readonly fast: "default";
-    readonly chat: "default";
-    readonly reasoning: "default";
-    readonly pdf: "default";
-  };
-  readonly huggingface: {
-    readonly fast: "speakleash/Bielik-1.5B-v3.0-Instruct";
-    readonly chat: "speakleash/Bielik-11B-v2.3-Instruct";
-    readonly reasoning: "speakleash/Bielik-11B-v2.3-Instruct";
-    readonly pdf: "speakleash/Bielik-11B-v2.3-Instruct";
-  };
-  readonly google: {
-    readonly fast: "gemini-3.7-flash";
-    readonly chat: "gemini-3.7-flash";
-    readonly reasoning: "gemini-3.7-flash";
-    readonly pdf: "gemini-3.7-flash";
-  };
-  readonly openrouter: {
-    readonly fast: "openai/gpt-5.6-luna";
-    readonly chat: "openai/gpt-5.6-terra";
-    readonly reasoning: "openai/gpt-5.6-terra";
-    readonly pdf: "openai/gpt-5.6-terra";
-  };
-  readonly openai: {
-    readonly fast: "gpt-5.4-nano";
-    readonly chat: "gpt-5.4-mini";
-    readonly reasoning: "gpt-5.4";
-    readonly pdf: "gpt-5.4";
-  };
-  readonly anthropic: {
-    readonly fast: "claude-opus-5";
-    readonly chat: "claude-opus-5";
-    readonly reasoning: "claude-opus-5";
-    readonly pdf: "claude-opus-5";
-  };
-  readonly bedrock: {
-    readonly fast: "us.amazon.nova-micro-v1:0";
-    readonly chat: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
-    readonly reasoning: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
-    readonly pdf: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
-  };
-  readonly mistral: {
-    readonly fast: "mistral-small-latest";
-    readonly chat: "mistral-medium-latest";
-    readonly reasoning: "magistral-medium-latest";
-    readonly pdf: "mistral-large-latest";
-  };
-};
+//#region src/model-rate.d.ts
 /**
- * BYOK-offered model IDs per provider — the curated catalog users pick
- * from in org settings, and the server-side allowlist the API enforces.
- * The frontend list is not a security boundary; this is what the API
- * accepts.
- *
- * Limited to providers the TanStack AI integration supports for BYOK.
- * Providers without a first-class TanStack adapter path are intentionally
- * not accepted at this boundary.
+ * models.dev publishes USD prices per one million tokens. Stella stores the
+ * same rates as integer ledger units so usage arithmetic never depends on
+ * floating point values.
  */
-declare const BYOK_MODEL_OPTIONS: {
-  readonly google: readonly ["gemini-3.7-flash", "gemini-3.6-flash", "gemini-3.5-flash-lite", "gemini-3.1-pro-preview", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
-  readonly anthropic: readonly ["claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-opus-4-7", "claude-sonnet-4-6", "claude-opus-4-6", "claude-haiku-4-5-20251001"];
-  readonly openai: readonly ["gpt-5.6", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.2"];
-  readonly openrouter: readonly ["openai/gpt-5.6-luna", "openai/gpt-5.6-terra", "google/gemini-3.7-flash", "google/gemini-3.6-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.1-pro-preview", "google/gemini-3.5-flash", "google/gemini-3.1-flash-lite", "anthropic/claude-sonnet-5", "anthropic/claude-opus-5", "anthropic/claude-opus-4.8", "anthropic/claude-sonnet-4.6", "openai/gpt-5.5", "openai/gpt-5.4-mini"];
-  readonly bedrock: readonly ["us.anthropic.claude-sonnet-4-5-20250929-v1:0", "us.anthropic.claude-haiku-4-5-20251001-v1:0", "us.amazon.nova-pro-v1:0", "us.amazon.nova-lite-v1:0", "us.amazon.nova-micro-v1:0", "openai.gpt-oss-120b-1:0", "openai.gpt-oss-20b-1:0", "us.deepseek.r1-v1:0"];
-  readonly mistral: readonly ["mistral-large-latest", "mistral-medium-latest", "mistral-small-latest", "magistral-medium-latest", "magistral-small", "pixtral-large-latest"];
-};
-type BYOKProvider = keyof typeof BYOK_MODEL_OPTIONS;
-type BYOKModelIdByProvider = { [TProvider in BYOKProvider]: (typeof BYOK_MODEL_OPTIONS)[TProvider][number]; };
-type OfferedBYOKModelId = BYOKModelIdByProvider[BYOKProvider];
-type ModelDisplayMetadata = {
-  /** Human-readable product name; model names are trademarks and stay untranslated. */
-  displayName: string;
-  /** Brand mark to show. This may differ from the routing provider. */
-  iconProvider: BYOKProvider;
+declare const MODEL_RATE_UNITS_PER_USD = 100000;
+type ModelRateAmounts = {
+  /** Normalized ledger units per 1M input tokens. */
+  inputPerMTok: number;
+  /** Normalized ledger units per 1M output tokens. */
+  outputPerMTok: number;
+  /**
+   * Normalized ledger units per 1M cached input tokens, when the provider
+   * offers a cache-read adjustment. Falls back to `inputPerMTok` when absent.
+   */
+  cachedInputPerMTok?: number;
+  /**
+   * Normalized ledger units per 1M tokens written to a prompt cache. Falls
+   * back to `inputPerMTok` when absent.
+   */
+  cachedWriteInputPerMTok?: number;
 };
 /**
- * Presentation metadata for every offered model. Keeping this exhaustive beside
- * the allowlist prevents a newly offered model from leaking a raw provider ID
- * into user-facing pickers. OpenRouter entries deliberately carry their model
- * creator's icon while their routing provider remains available separately.
+ * A discriminated rate schedule. Consumers resolve the schedule from the
+ * request's total input tokens before reading any prices, so a model with a
+ * long-context premium cannot accidentally be metered at its base rate.
  */
-declare const MODEL_DISPLAY_METADATA: {
+type ModelRate = ({
+  kind: "flat";
+} & ModelRateAmounts) | {
+  kind: "input-token-tiered";
+  /** The base tier applies at or below this total input-token count. */
+  inputTokenThreshold: number;
+  standard: ModelRateAmounts;
+  /** Applies to the entire request once input exceeds the threshold. */
+  aboveThreshold: ModelRateAmounts;
+};
+declare const getStandardModelRate: (rate: ModelRate) => ModelRateAmounts;
+declare const resolveModelRate: (rate: ModelRate, inputTokens: number) => ModelRateAmounts;
+//#endregion
+//#region src/model-rates.gen.d.ts
+declare const MODEL_RATES: {
+  readonly "gemini-3.8-flash": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 75000;
+    readonly outputPerMTok: 375000;
+    readonly cachedInputPerMTok: 7500;
+  };
   readonly "gemini-3.7-flash": {
-    readonly displayName: "Gemini 3.7 Flash";
-    readonly iconProvider: "google";
+    readonly kind: "flat";
+    readonly inputPerMTok: 75000;
+    readonly outputPerMTok: 375000;
+    readonly cachedInputPerMTok: 7500;
   };
   readonly "gemini-3.6-flash": {
-    readonly displayName: "Gemini 3.6 Flash";
-    readonly iconProvider: "google";
+    readonly kind: "flat";
+    readonly inputPerMTok: 75000;
+    readonly outputPerMTok: 375000;
+    readonly cachedInputPerMTok: 7500;
   };
   readonly "gemini-3.5-flash-lite": {
-    readonly displayName: "Gemini 3.5 Flash Lite";
-    readonly iconProvider: "google";
+    readonly kind: "flat";
+    readonly inputPerMTok: 30000;
+    readonly outputPerMTok: 250000;
+    readonly cachedInputPerMTok: 3000;
   };
   readonly "gemini-3.1-pro-preview": {
-    readonly displayName: "Gemini 3.1 Pro Preview";
-    readonly iconProvider: "google";
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 200000;
+    readonly standard: {
+      readonly inputPerMTok: 200000;
+      readonly outputPerMTok: 1200000;
+      readonly cachedInputPerMTok: 20000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 400000;
+      readonly outputPerMTok: 1800000;
+      readonly cachedInputPerMTok: 40000;
+    };
   };
   readonly "gemini-3.5-flash": {
-    readonly displayName: "Gemini 3.5 Flash";
-    readonly iconProvider: "google";
+    readonly kind: "flat";
+    readonly inputPerMTok: 150000;
+    readonly outputPerMTok: 900000;
+    readonly cachedInputPerMTok: 15000;
   };
   readonly "gemini-3.1-flash-lite": {
-    readonly displayName: "Gemini 3.1 Flash Lite";
-    readonly iconProvider: "google";
-  };
-  readonly "claude-sonnet-5": {
-    readonly displayName: "Claude Sonnet 5";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-fable-5-1": {
-    readonly displayName: "Claude Fable 5.1";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-fable-5": {
-    readonly displayName: "Claude Fable 5";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-opus-5": {
-    readonly displayName: "Claude Opus 5";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-opus-4-8": {
-    readonly displayName: "Claude Opus 4.8";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-opus-4-7": {
-    readonly displayName: "Claude Opus 4.7";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-sonnet-4-6": {
-    readonly displayName: "Claude Sonnet 4.6";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-opus-4-6": {
-    readonly displayName: "Claude Opus 4.6";
-    readonly iconProvider: "anthropic";
-  };
-  readonly "claude-haiku-4-5-20251001": {
-    readonly displayName: "Claude Haiku 4.5";
-    readonly iconProvider: "anthropic";
+    readonly kind: "flat";
+    readonly inputPerMTok: 25000;
+    readonly outputPerMTok: 150000;
+    readonly cachedInputPerMTok: 2500;
   };
   readonly "gpt-5.6": {
-    readonly displayName: "GPT-5.6 Sol";
-    readonly iconProvider: "openai";
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 400000;
+      readonly outputPerMTok: 2000000;
+      readonly cachedInputPerMTok: 40000;
+      readonly cachedWriteInputPerMTok: 500000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 800000;
+      readonly outputPerMTok: 3000000;
+      readonly cachedInputPerMTok: 80000;
+      readonly cachedWriteInputPerMTok: 1000000;
+    };
   };
   readonly "gpt-5.6-terra": {
-    readonly displayName: "GPT-5.6 Terra";
-    readonly iconProvider: "openai";
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 200000;
+      readonly outputPerMTok: 1200000;
+      readonly cachedInputPerMTok: 20000;
+      readonly cachedWriteInputPerMTok: 250000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 400000;
+      readonly outputPerMTok: 1800000;
+      readonly cachedInputPerMTok: 40000;
+      readonly cachedWriteInputPerMTok: 500000;
+    };
   };
   readonly "gpt-5.6-luna": {
-    readonly displayName: "GPT-5.6 Luna";
-    readonly iconProvider: "openai";
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 20000;
+      readonly outputPerMTok: 120000;
+      readonly cachedInputPerMTok: 2000;
+      readonly cachedWriteInputPerMTok: 25000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 40000;
+      readonly outputPerMTok: 180000;
+      readonly cachedInputPerMTok: 4000;
+      readonly cachedWriteInputPerMTok: 50000;
+    };
   };
   readonly "gpt-5.5": {
-    readonly displayName: "GPT-5.5";
-    readonly iconProvider: "openai";
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 500000;
+      readonly outputPerMTok: 3000000;
+      readonly cachedInputPerMTok: 50000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 1000000;
+      readonly outputPerMTok: 4500000;
+      readonly cachedInputPerMTok: 100000;
+    };
   };
   readonly "gpt-5.4": {
-    readonly displayName: "GPT-5.4";
-    readonly iconProvider: "openai";
-  };
-  readonly "gpt-5.4-mini": {
-    readonly displayName: "GPT-5.4 Mini";
-    readonly iconProvider: "openai";
-  };
-  readonly "gpt-5.4-nano": {
-    readonly displayName: "GPT-5.4 Nano";
-    readonly iconProvider: "openai";
-  };
-  readonly "gpt-5.2": {
-    readonly displayName: "GPT-5.2";
-    readonly iconProvider: "openai";
-  };
-  readonly "openai/gpt-5.6-luna": {
-    readonly displayName: "GPT-5.6 Luna";
-    readonly iconProvider: "openai";
-  };
-  readonly "openai/gpt-5.6-terra": {
-    readonly displayName: "GPT-5.6 Terra";
-    readonly iconProvider: "openai";
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 250000;
+      readonly outputPerMTok: 1500000;
+      readonly cachedInputPerMTok: 25000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 500000;
+      readonly outputPerMTok: 2250000;
+      readonly cachedInputPerMTok: 50000;
+    };
   };
-  readonly "google/gemini-3.7-flash": {
-    readonly displayName: "Gemini 3.7 Flash";
-    readonly iconProvider: "google";
+  readonly "gpt-5.4-mini": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 75000;
+    readonly outputPerMTok: 450000;
+    readonly cachedInputPerMTok: 7500;
   };
-  readonly "google/gemini-3.6-flash": {
-    readonly displayName: "Gemini 3.6 Flash";
-    readonly iconProvider: "google";
+  readonly "gpt-5.4-nano": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 20000;
+    readonly outputPerMTok: 125000;
+    readonly cachedInputPerMTok: 2000;
   };
-  readonly "google/gemini-3.5-flash-lite": {
-    readonly displayName: "Gemini 3.5 Flash Lite";
-    readonly iconProvider: "google";
+  readonly "gpt-5.2": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 175000;
+    readonly outputPerMTok: 1400000;
+    readonly cachedInputPerMTok: 17500;
   };
-  readonly "google/gemini-3.1-pro-preview": {
-    readonly displayName: "Gemini 3.1 Pro Preview";
-    readonly iconProvider: "google";
+  readonly "claude-sonnet-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 200000;
+    readonly outputPerMTok: 1000000;
+    readonly cachedInputPerMTok: 20000;
+    readonly cachedWriteInputPerMTok: 250000;
   };
-  readonly "google/gemini-3.5-flash": {
-    readonly displayName: "Gemini 3.5 Flash";
-    readonly iconProvider: "google";
+  readonly "claude-fable-5-1": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 1000000;
+    readonly outputPerMTok: 5000000;
+    readonly cachedInputPerMTok: 25000;
+    readonly cachedWriteInputPerMTok: 1250000;
   };
-  readonly "google/gemini-3.1-flash-lite": {
-    readonly displayName: "Gemini 3.1 Flash Lite";
-    readonly iconProvider: "google";
+  readonly "claude-fable-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 1000000;
+    readonly outputPerMTok: 5000000;
+    readonly cachedInputPerMTok: 100000;
+    readonly cachedWriteInputPerMTok: 1250000;
   };
-  readonly "anthropic/claude-sonnet-5": {
-    readonly displayName: "Claude Sonnet 5";
-    readonly iconProvider: "anthropic";
+  readonly "claude-opus-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
   };
-  readonly "anthropic/claude-opus-5": {
-    readonly displayName: "Claude Opus 5";
-    readonly iconProvider: "anthropic";
+  readonly "claude-opus-4-8": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
   };
-  readonly "anthropic/claude-opus-4.8": {
-    readonly displayName: "Claude Opus 4.8";
-    readonly iconProvider: "anthropic";
+  readonly "claude-opus-4-7": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
   };
-  readonly "anthropic/claude-sonnet-4.6": {
-    readonly displayName: "Claude Sonnet 4.6";
-    readonly iconProvider: "anthropic";
+  readonly "claude-sonnet-4-6": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 300000;
+    readonly outputPerMTok: 1500000;
+    readonly cachedInputPerMTok: 30000;
+    readonly cachedWriteInputPerMTok: 375000;
   };
-  readonly "openai/gpt-5.5": {
-    readonly displayName: "GPT-5.5";
-    readonly iconProvider: "openai";
+  readonly "claude-opus-4-6": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
   };
-  readonly "openai/gpt-5.4-mini": {
-    readonly displayName: "GPT-5.4 Mini";
-    readonly iconProvider: "openai";
+  readonly "claude-haiku-4-5-20251001": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 100000;
+    readonly outputPerMTok: 500000;
+    readonly cachedInputPerMTok: 10000;
+    readonly cachedWriteInputPerMTok: 125000;
   };
   readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": {
-    readonly displayName: "Claude Sonnet 4.5";
-    readonly iconProvider: "anthropic";
+    readonly kind: "flat";
+    readonly inputPerMTok: 300000;
+    readonly outputPerMTok: 1500000;
+    readonly cachedInputPerMTok: 30000;
+    readonly cachedWriteInputPerMTok: 375000;
   };
   readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": {
-    readonly displayName: "Claude Haiku 4.5";
-    readonly iconProvider: "anthropic";
+    readonly kind: "flat";
+    readonly inputPerMTok: 100000;
+    readonly outputPerMTok: 500000;
+    readonly cachedInputPerMTok: 10000;
+    readonly cachedWriteInputPerMTok: 125000;
   };
   readonly "us.amazon.nova-pro-v1:0": {
-    readonly displayName: "Amazon Nova Pro";
-    readonly iconProvider: "bedrock";
+    readonly kind: "flat";
+    readonly inputPerMTok: 80000;
+    readonly outputPerMTok: 320000;
+    readonly cachedInputPerMTok: 20000;
   };
   readonly "us.amazon.nova-lite-v1:0": {
-    readonly displayName: "Amazon Nova Lite";
-    readonly iconProvider: "bedrock";
+    readonly kind: "flat";
+    readonly inputPerMTok: 6000;
+    readonly outputPerMTok: 24000;
+    readonly cachedInputPerMTok: 1500;
   };
   readonly "us.amazon.nova-micro-v1:0": {
-    readonly displayName: "Amazon Nova Micro";
-    readonly iconProvider: "bedrock";
+    readonly kind: "flat";
+    readonly inputPerMTok: 3500;
+    readonly outputPerMTok: 14000;
+    readonly cachedInputPerMTok: 875;
   };
   readonly "openai.gpt-oss-120b-1:0": {
-    readonly displayName: "GPT OSS 120B";
-    readonly iconProvider: "openai";
+    readonly kind: "flat";
+    readonly inputPerMTok: 15000;
+    readonly outputPerMTok: 60000;
   };
   readonly "openai.gpt-oss-20b-1:0": {
-    readonly displayName: "GPT OSS 20B";
-    readonly iconProvider: "openai";
+    readonly kind: "flat";
+    readonly inputPerMTok: 7000;
+    readonly outputPerMTok: 30000;
   };
   readonly "us.deepseek.r1-v1:0": {
-    readonly displayName: "DeepSeek R1";
-    readonly iconProvider: "bedrock";
+    readonly kind: "flat";
+    readonly inputPerMTok: 135000;
+    readonly outputPerMTok: 540000;
   };
   readonly "mistral-large-latest": {
-    readonly displayName: "Mistral Large";
-    readonly iconProvider: "mistral";
+    readonly kind: "flat";
+    readonly inputPerMTok: 50000;
+    readonly outputPerMTok: 150000;
   };
   readonly "mistral-medium-latest": {
-    readonly displayName: "Mistral Medium";
-    readonly iconProvider: "mistral";
+    readonly kind: "flat";
+    readonly inputPerMTok: 150000;
+    readonly outputPerMTok: 750000;
   };
   readonly "mistral-small-latest": {
-    readonly displayName: "Mistral Small";
-    readonly iconProvider: "mistral";
+    readonly kind: "flat";
+    readonly inputPerMTok: 15000;
+    readonly outputPerMTok: 60000;
   };
   readonly "magistral-medium-latest": {
-    readonly displayName: "Magistral Medium";
-    readonly iconProvider: "mistral";
+    readonly kind: "flat";
+    readonly inputPerMTok: 200000;
+    readonly outputPerMTok: 500000;
   };
   readonly "magistral-small": {
-    readonly displayName: "Magistral Small";
-    readonly iconProvider: "mistral";
+    readonly kind: "flat";
+    readonly inputPerMTok: 50000;
+    readonly outputPerMTok: 150000;
   };
   readonly "pixtral-large-latest": {
-    readonly displayName: "Pixtral Large";
-    readonly iconProvider: "mistral";
+    readonly kind: "flat";
+    readonly inputPerMTok: 200000;
+    readonly outputPerMTok: 600000;
+  };
+  readonly "gemini-2.5-flash": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 30000;
+    readonly outputPerMTok: 250000;
+    readonly cachedInputPerMTok: 3000;
+  };
+  readonly "gemini-2.5-pro": {
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 200000;
+    readonly standard: {
+      readonly inputPerMTok: 125000;
+      readonly outputPerMTok: 1000000;
+      readonly cachedInputPerMTok: 12500;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 250000;
+      readonly outputPerMTok: 1500000;
+      readonly cachedInputPerMTok: 25000;
+    };
+  };
+  readonly "gpt-4o-mini": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 15000;
+    readonly outputPerMTok: 60000;
+    readonly cachedInputPerMTok: 7500;
+  };
+  readonly "gpt-4o": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 250000;
+    readonly outputPerMTok: 1000000;
+    readonly cachedInputPerMTok: 125000;
   };
 };
-declare const getModelDisplayMetadata: (modelId: string) => ModelDisplayMetadata | null;
-/**
- * Offered models whose provider API accepts PDF/file content. Generated from
- * live models.dev input modalities plus dated, reviewed source corrections;
- * the nightly upstream check rejects drift.
- */
-declare const BYOK_DOCUMENT_INPUT_MODEL_OPTIONS: {
-  readonly google: readonly ["gemini-3.7-flash", "gemini-3.6-flash", "gemini-3.5-flash-lite", "gemini-3.1-pro-preview", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
-  readonly openrouter: readonly ["openai/gpt-5.6-luna", "openai/gpt-5.6-terra", "google/gemini-3.7-flash", "google/gemini-3.6-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.1-pro-preview", "google/gemini-3.5-flash", "google/gemini-3.1-flash-lite", "anthropic/claude-sonnet-5", "anthropic/claude-opus-5", "anthropic/claude-opus-4.8", "anthropic/claude-sonnet-4.6", "openai/gpt-5.5", "openai/gpt-5.4-mini"];
-  readonly openai: readonly ["gpt-5.6", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.2"];
-  readonly anthropic: readonly ["claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-opus-4-7", "claude-sonnet-4-6", "claude-opus-4-6", "claude-haiku-4-5-20251001"];
-  readonly bedrock: readonly ["us.anthropic.claude-sonnet-4-5-20250929-v1:0", "us.anthropic.claude-haiku-4-5-20251001-v1:0", "us.amazon.nova-pro-v1:0", "us.amazon.nova-lite-v1:0"];
-  readonly mistral: readonly [];
-};
-declare const isBYOKProviderRoleSupported: ({ provider, role }: {
-  provider: BYOKProvider;
-  role: ModelRole;
-}) => boolean;
-declare const isBYOKModelRoleSupported: ({ provider, modelId, role }: {
-  provider: BYOKProvider;
-  modelId: string;
-  role: ModelRole;
-}) => boolean;
-/**
- * Models whose provider adapter can receive a PDF `document` content part in a
- * chat turn without throwing. This is a narrower, runtime question than the
- * pdf ROLE (`BYOK_DOCUMENT_INPUT_MODEL_OPTIONS`, which curates model selection
- * for PDF-processing flows): it only asks "will the chat stream survive this
- * attachment." The Mistral text adapter maps PDF `document` parts to
- * `document_url`, so its
- * vision models accept PDF attachments even though Mistral is deliberately not
- * offered as a pdf-role provider. Mistral's `document_url` takes PDF but NOT
- * textual documents (docx/txt/csv/md), so those still gate on
- * `BYOK_DOCUMENT_INPUT_MODEL_OPTIONS` (which excludes Mistral). Superset
- * invariant: every pdf-role document model also accepts a PDF chat attachment.
- */
-declare const CHAT_PDF_ATTACHMENT_MODEL_OPTIONS: {
-  readonly mistral: readonly ["mistral-medium-latest", "mistral-small-latest", "pixtral-large-latest"];
-  readonly google: readonly ["gemini-3.7-flash", "gemini-3.6-flash", "gemini-3.5-flash-lite", "gemini-3.1-pro-preview", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
-  readonly openrouter: readonly ["openai/gpt-5.6-luna", "openai/gpt-5.6-terra", "google/gemini-3.7-flash", "google/gemini-3.6-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.1-pro-preview", "google/gemini-3.5-flash", "google/gemini-3.1-flash-lite", "anthropic/claude-sonnet-5", "anthropic/claude-opus-5", "anthropic/claude-opus-4.8", "anthropic/claude-sonnet-4.6", "openai/gpt-5.5", "openai/gpt-5.4-mini"];
-  readonly openai: readonly ["gpt-5.6", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.2"];
-  readonly anthropic: readonly ["claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-opus-4-7", "claude-sonnet-4-6", "claude-opus-4-6", "claude-haiku-4-5-20251001"];
-  readonly bedrock: readonly ["us.anthropic.claude-sonnet-4-5-20250929-v1:0", "us.anthropic.claude-haiku-4-5-20251001-v1:0", "us.amazon.nova-pro-v1:0", "us.amazon.nova-lite-v1:0"];
+//#endregion
+//#region src/model-rate-policy.d.ts
+declare const MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER: {
+  readonly google: "google";
+  readonly openai: "openai";
+  readonly anthropic: "anthropic";
+  readonly bedrock: "amazon-bedrock";
+  readonly mistral: "mistral";
 };
-declare const isChatPdfAttachmentModelSupported: ({ provider, modelId }: {
-  provider: BYOKProvider;
-  modelId: string;
-}) => boolean;
+type ModelsDevRateProvider = (typeof MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER)[keyof typeof MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER];
 /**
- * Resolve a model id that will actually work for this provider+role,
- * keeping the SAME provider. Returns the caller's model unchanged when
- * it is still offered; otherwise falls back to the provider's per-role
- * default (`BYOK_DEFAULT_MODELS`). Returns `null` only when the
- * provider has no valid model for the role at all — the sole case
- * today is `mistral` + `pdf`, because the TanStack Mistral adapter
- * exposes no `document` input modality, so no Mistral model (not even
- * the default) can serve the PDF role.
- *
- * Used to auto-heal org AI configs whose pinned model was removed by a
- * catalog bump, so generation resolves to a supported model instead of
- * 400-ing (or forwarding a retired id to the provider).
+ * Explicit source coordinates for non-offered model IDs that remain valid in
+ * deployment overrides and usage attribution. Their numeric rates still come
+ * exclusively from models.dev.
  */
-declare const resolveWorkingBYOKModelForRole: ({ provider, modelId, role }: {
-  provider: BYOKProvider;
-  modelId: string;
-  role: ModelRole;
-}) => string | null;
+declare const RETAINED_MODELS_DEV_RATE_ENTRIES: {
+  readonly "gemini-2.5-flash": {
+    readonly modelId: "gemini-2.5-flash";
+    readonly provider: "google";
+  };
+  readonly "gemini-2.5-pro": {
+    readonly modelId: "gemini-2.5-pro";
+    readonly provider: "google";
+  };
+  readonly "gpt-4o-mini": {
+    readonly modelId: "gpt-4o-mini";
+    readonly provider: "openai";
+  };
+  readonly "gpt-4o": {
+    readonly modelId: "gpt-4o";
+    readonly provider: "openai";
+  };
+};
 /**
- * Anthropic models that use the adaptive-thinking request shape
- * (`thinking: { type: "adaptive" }`). Newer Claude models reject the
- * legacy budget-based form, so every Opus 4.6+/Sonnet 4.6/Fable entry
- * offered above must appear here or it will 400 on the reasoning role.
+ * Exact mappings where Stella uses a provider routing ID while models.dev
+ * publishes pricing under the corresponding base model ID. Generation rejects
+ * a mapping once models.dev begins publishing the Stella ID directly.
  */
-declare const ANTHROPIC_ADAPTIVE_THINKING_MODELS: readonly ["claude-sonnet-5", "claude-opus-5", "claude-sonnet-4-6", "claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8", "claude-fable-5", "claude-fable-5-1"];
+declare const MODELS_DEV_RATE_SOURCE_ALIASES: {
+  readonly "us.amazon.nova-pro-v1:0": {
+    readonly modelId: "amazon.nova-pro-v1:0";
+    readonly provider: "amazon-bedrock";
+    readonly reason: string;
+    readonly sourceUrl: "https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html";
+  };
+  readonly "us.amazon.nova-lite-v1:0": {
+    readonly modelId: "amazon.nova-lite-v1:0";
+    readonly provider: "amazon-bedrock";
+    readonly reason: string;
+    readonly sourceUrl: "https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html";
+  };
+  readonly "us.amazon.nova-micro-v1:0": {
+    readonly modelId: "amazon.nova-micro-v1:0";
+    readonly provider: "amazon-bedrock";
+    readonly reason: string;
+    readonly sourceUrl: "https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html";
+  };
+};
+//#endregion
+//#region src/capabilities-overrides.d.ts
 /**
- * Canonical reasoning-effort ladder, ordered weakest to strongest.
- * Union of every effort keyword the offered providers accept; no
- * single model accepts all of them, which is exactly why the
- * generated per-model `MODEL_REASONING_EFFORTS` exists.
+ * Hand-declared capabilities for offered models that models.dev does
+ * not cover. The capability generator
+ * (`packages/scripts/src/model-catalog-capabilities-gen.ts`) refuses
+ * an override for any model the upstream source covers, so manual
+ * data cannot shadow sourced data — this file can only ever fill
+ * genuine gaps, each with a dated justification.
  */
-declare const REASONING_EFFORTS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
-type ReasoningEffort = (typeof REASONING_EFFORTS)[number];
-declare const resolvedReasoningEffortSchema: v.SchemaWithPipe<readonly [v.PicklistSchema<readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"], undefined>, v.BrandAction<"none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "ResolvedReasoningEffort">]>;
+type CapabilityOverride = {
+  documentInput: boolean;
+  documentInputReason: string;
+  reasoningEfforts: readonly ReasoningEffort[] | null;
+  temperatureSupported: boolean;
+  /** Why the upstream source cannot answer for this model. Dated. */
+  reason: string;
+};
+declare const CAPABILITY_OVERRIDES: Partial<Record<OfferedBYOKModelId, CapabilityOverride>>;
+//#endregion
+//#region src/document-input-overrides.d.ts
+type DocumentInputOverride = {
+  /** Whether the model accepts a PDF/file content part. */
+  supported: boolean;
+  /** Why the live catalogue cannot answer correctly. Dated. */
+  reason: string;
+};
 /**
- * A reasoning effort proven to be accepted by the model it targets.
- * Only `resolveReasoningEffort` can produce this type, so option
- * builders cannot hand a provider a literal effort the model rejects
- * (e.g. `"none"` to a model whose reasoning cannot be disabled) —
- * that mistake now fails typecheck instead of 502-ing at runtime.
+ * Reviewed document-input corrections for models.dev records that exist but
+ * under-report the provider API's file-input support. The generator rejects an
+ * override once upstream agrees, so sourced data takes ownership automatically.
  */
-type ResolvedReasoningEffort = v.InferOutput<typeof resolvedReasoningEffortSchema>;
+declare const DOCUMENT_INPUT_OVERRIDES: Partial<Record<OfferedBYOKModelId, DocumentInputOverride>>;
+//#endregion
+//#region src/capabilities.gen.d.ts
 /**
- * Provider-native IDs that are exact aliases of an offered catalog ID.
- * Every metadata lookup normalizes here, so instance/dev overrides cannot
- * bypass rates or capabilities and duplicated alias rows cannot drift apart.
+ * Reasoning-effort values each offered model accepts, `null` when the
+ * model exposes no effort-style reasoning control. A missing `"none"`
+ * means the model's reasoning cannot be disabled; consumers must go
+ * through `resolveReasoningEffort`.
  */
+declare const MODEL_REASONING_EFFORTS: {
+  readonly "gemini-3.8-flash": readonly ["low", "medium", "high"];
+  readonly "gemini-3.7-flash": readonly ["low", "medium", "high"];
+  readonly "gemini-3.6-flash": readonly ["minimal", "low", "medium", "high"];
+  readonly "gemini-3.5-flash-lite": readonly ["minimal", "low", "medium", "high"];
+  readonly "gemini-3.1-pro-preview": readonly ["low", "medium", "high"];
+  readonly "gemini-3.5-flash": readonly ["minimal", "low", "medium", "high"];
+  readonly "gemini-3.1-flash-lite": readonly ["minimal", "low", "medium", "high"];
+  readonly "openai/gpt-5.6-luna": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "openai/gpt-5.6-terra": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "google/gemini-3.8-flash": readonly ["low", "medium", "high"];
+  readonly "google/gemini-3.7-flash": readonly ["low", "medium", "high"];
+  readonly "google/gemini-3.6-flash": readonly ["minimal", "low", "medium", "high"];
+  readonly "google/gemini-3.5-flash-lite": readonly ["minimal", "low", "medium", "high"];
+  readonly "google/gemini-3.1-pro-preview": readonly ["low", "medium", "high"];
+  readonly "google/gemini-3.5-flash": readonly ["minimal", "low", "medium", "high"];
+  readonly "google/gemini-3.1-flash-lite": readonly ["none", "minimal", "low", "medium", "high"];
+  readonly "anthropic/claude-sonnet-5": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "anthropic/claude-opus-5": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "anthropic/claude-opus-4.8": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "anthropic/claude-sonnet-4.6": readonly ["none", "low", "medium", "high", "max"];
+  readonly "openai/gpt-5.5": readonly ["none", "low", "medium", "high", "xhigh"];
+  readonly "openai/gpt-5.4-mini": readonly ["none", "low", "medium", "high", "xhigh"];
+  readonly "gpt-5.6": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "gpt-5.6-terra": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "gpt-5.6-luna": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "gpt-5.5": readonly ["none", "low", "medium", "high", "xhigh"];
+  readonly "gpt-5.4": readonly ["none", "low", "medium", "high", "xhigh"];
+  readonly "gpt-5.4-mini": readonly ["none", "low", "medium", "high", "xhigh"];
+  readonly "gpt-5.4-nano": readonly ["none", "low", "medium", "high", "xhigh"];
+  readonly "gpt-5.2": readonly ["none", "low", "medium", "high", "xhigh"];
+  readonly "claude-sonnet-5": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "claude-fable-5-1": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "claude-fable-5": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "claude-opus-5": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "claude-opus-4-8": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "claude-opus-4-7": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "claude-sonnet-4-6": readonly ["low", "medium", "high", "max"];
+  readonly "claude-opus-4-6": readonly ["low", "medium", "high", "max"];
+  readonly "claude-haiku-4-5-20251001": null;
+  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": null;
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": null;
+  readonly "us.amazon.nova-pro-v1:0": null;
+  readonly "us.amazon.nova-lite-v1:0": null;
+  readonly "us.amazon.nova-micro-v1:0": null;
+  readonly "openai.gpt-oss-120b-1:0": readonly ["low", "medium", "high"];
+  readonly "openai.gpt-oss-20b-1:0": readonly ["low", "medium", "high"];
+  readonly "us.deepseek.r1-v1:0": null;
+  readonly "mistral-large-latest": null;
+  readonly "mistral-medium-latest": readonly ["none", "high"];
+  readonly "mistral-small-latest": readonly ["none", "high"];
+  readonly "magistral-medium-latest": null;
+  readonly "magistral-small": null;
+  readonly "pixtral-large-latest": null;
+};
 /**
- * Per-provider model served when a user's included budget is exhausted
- * and no explicit selection overrides it. Falls back to each
- * provider's fast-role default; providers without a first-class
- * adapter path cannot serve the lane. Total over providers so a new
- * provider lands with an explicit decision.
+ * Concrete provider-default effort where the upstream catalogue publishes
+ * one. OpenRouter is the source today; null means the provider does not expose
+ * a truthful named default, so clients must retain a separate Default choice.
  */
-declare const FALLBACK_CHAT_MODEL_BY_PROVIDER: {
-  readonly google: "gemini-3.7-flash";
-  readonly openrouter: "openai/gpt-5.6-luna";
-  readonly openai: "gpt-5.6-luna";
-  readonly anthropic: "claude-opus-5";
-  readonly bedrock: "us.amazon.nova-micro-v1:0";
-  readonly mistral: "mistral-small-latest";
-  readonly azure_foundry: null;
-  readonly openai_compatible: null;
-  readonly huggingface: null;
+declare const MODEL_DEFAULT_REASONING_EFFORTS: {
+  readonly "gemini-3.8-flash": null;
+  readonly "gemini-3.7-flash": null;
+  readonly "gemini-3.6-flash": null;
+  readonly "gemini-3.5-flash-lite": null;
+  readonly "gemini-3.1-pro-preview": null;
+  readonly "gemini-3.5-flash": null;
+  readonly "gemini-3.1-flash-lite": null;
+  readonly "openai/gpt-5.6-luna": "medium";
+  readonly "openai/gpt-5.6-terra": "medium";
+  readonly "google/gemini-3.8-flash": "medium";
+  readonly "google/gemini-3.7-flash": "medium";
+  readonly "google/gemini-3.6-flash": "medium";
+  readonly "google/gemini-3.5-flash-lite": "minimal";
+  readonly "google/gemini-3.1-pro-preview": "medium";
+  readonly "google/gemini-3.5-flash": "medium";
+  readonly "google/gemini-3.1-flash-lite": "minimal";
+  readonly "anthropic/claude-sonnet-5": "high";
+  readonly "anthropic/claude-opus-5": "high";
+  readonly "anthropic/claude-opus-4.8": "high";
+  readonly "anthropic/claude-sonnet-4.6": "medium";
+  readonly "openai/gpt-5.5": "medium";
+  readonly "openai/gpt-5.4-mini": "medium";
+  readonly "gpt-5.6": null;
+  readonly "gpt-5.6-terra": null;
+  readonly "gpt-5.6-luna": null;
+  readonly "gpt-5.5": null;
+  readonly "gpt-5.4": null;
+  readonly "gpt-5.4-mini": null;
+  readonly "gpt-5.4-nano": null;
+  readonly "gpt-5.2": null;
+  readonly "claude-sonnet-5": null;
+  readonly "claude-fable-5-1": null;
+  readonly "claude-fable-5": null;
+  readonly "claude-opus-5": null;
+  readonly "claude-opus-4-8": null;
+  readonly "claude-opus-4-7": null;
+  readonly "claude-sonnet-4-6": null;
+  readonly "claude-opus-4-6": null;
+  readonly "claude-haiku-4-5-20251001": null;
+  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": null;
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": null;
+  readonly "us.amazon.nova-pro-v1:0": null;
+  readonly "us.amazon.nova-lite-v1:0": null;
+  readonly "us.amazon.nova-micro-v1:0": null;
+  readonly "openai.gpt-oss-120b-1:0": null;
+  readonly "openai.gpt-oss-20b-1:0": null;
+  readonly "us.deepseek.r1-v1:0": null;
+  readonly "mistral-large-latest": null;
+  readonly "mistral-medium-latest": null;
+  readonly "mistral-small-latest": null;
+  readonly "magistral-medium-latest": null;
+  readonly "magistral-small": null;
+  readonly "pixtral-large-latest": null;
 };
-declare const MODEL_CATALOG_ID_ALIASES: {
-  readonly "gpt-5.6-sol": "gpt-5.6";
-  readonly "claude-opus-4.8": "claude-opus-4-8";
-  readonly "claude-sonnet-4.6": "claude-sonnet-4-6";
+/**
+ * Whether stella should emit a `temperature` sampling override.
+ * `"omit"` covers rejected, deprecated, and accepted-but-ignored
+ * parameters. Consumers must go through `shouldEmitTemperature`.
+ */
+declare const MODEL_TEMPERATURE_POLICIES: {
+  readonly "gemini-3.8-flash": "omit";
+  readonly "gemini-3.7-flash": "omit";
+  readonly "gemini-3.6-flash": "omit";
+  readonly "gemini-3.5-flash-lite": "omit";
+  readonly "gemini-3.1-pro-preview": "emit";
+  readonly "gemini-3.5-flash": "emit";
+  readonly "gemini-3.1-flash-lite": "emit";
+  readonly "openai/gpt-5.6-luna": "omit";
+  readonly "openai/gpt-5.6-terra": "omit";
+  readonly "google/gemini-3.8-flash": "omit";
+  readonly "google/gemini-3.7-flash": "omit";
+  readonly "google/gemini-3.6-flash": "omit";
+  readonly "google/gemini-3.5-flash-lite": "omit";
+  readonly "google/gemini-3.1-pro-preview": "emit";
+  readonly "google/gemini-3.5-flash": "emit";
+  readonly "google/gemini-3.1-flash-lite": "emit";
+  readonly "anthropic/claude-sonnet-5": "omit";
+  readonly "anthropic/claude-opus-5": "emit";
+  readonly "anthropic/claude-opus-4.8": "emit";
+  readonly "anthropic/claude-sonnet-4.6": "emit";
+  readonly "openai/gpt-5.5": "omit";
+  readonly "openai/gpt-5.4-mini": "omit";
+  readonly "gpt-5.6": "omit";
+  readonly "gpt-5.6-terra": "omit";
+  readonly "gpt-5.6-luna": "omit";
+  readonly "gpt-5.5": "omit";
+  readonly "gpt-5.4": "emit";
+  readonly "gpt-5.4-mini": "emit";
+  readonly "gpt-5.4-nano": "emit";
+  readonly "gpt-5.2": "emit";
+  readonly "claude-sonnet-5": "omit";
+  readonly "claude-fable-5-1": "omit";
+  readonly "claude-fable-5": "omit";
+  readonly "claude-opus-5": "omit";
+  readonly "claude-opus-4-8": "omit";
+  readonly "claude-opus-4-7": "omit";
+  readonly "claude-sonnet-4-6": "emit";
+  readonly "claude-opus-4-6": "emit";
+  readonly "claude-haiku-4-5-20251001": "emit";
+  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": "emit";
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": "emit";
+  readonly "us.amazon.nova-pro-v1:0": "emit";
+  readonly "us.amazon.nova-lite-v1:0": "emit";
+  readonly "us.amazon.nova-micro-v1:0": "emit";
+  readonly "openai.gpt-oss-120b-1:0": "emit";
+  readonly "openai.gpt-oss-20b-1:0": "emit";
+  readonly "us.deepseek.r1-v1:0": "emit";
+  readonly "mistral-large-latest": "emit";
+  readonly "mistral-medium-latest": "emit";
+  readonly "mistral-small-latest": "emit";
+  readonly "magistral-medium-latest": "emit";
+  readonly "magistral-small": "emit";
+  readonly "pixtral-large-latest": "emit";
 };
-declare const normalizeModelCatalogId: (modelId: string) => string;
+//#endregion
+//#region src/index.d.ts
 /**
- * Whether stella should emit a `temperature` override for this model.
- * This is deliberately stricter than provider acceptance: deprecated
- * parameters that are accepted but ignored resolve to `false`. Unknown ids
- * also resolve to `false` (send nothing; provider default). Callers must
- * never index `MODEL_TEMPERATURE_POLICIES` directly with
- * a runtime string.
+ * Logical model roles. Call sites declare *what* they need, not
+ * *which* model to use.
+ *
+ * - fast: classification, extraction, short generation
+ * - chat: conversational with tool use and streaming
+ * - reasoning: complex multi-step legal analysis
+ * - pdf: native PDF/image understanding
  */
-declare const shouldEmitTemperature: (modelId: string) => boolean;
+declare const MODEL_ROLES: readonly ["fast", "chat", "reasoning", "pdf"];
+type ModelRole = (typeof MODEL_ROLES)[number];
+declare const TEMPERATURE_POLICIES: readonly ["emit", "omit"];
+type TemperaturePolicy = (typeof TEMPERATURE_POLICIES)[number];
+declare const AI_PROVIDERS: readonly ["google", "openrouter", "openai", "azure_foundry", "anthropic", "bedrock", "mistral", "openai_compatible", "huggingface"];
+type AIProvider = (typeof AI_PROVIDERS)[number];
+declare const AI_PROVIDER_ADAPTER_KIND: {
+  readonly google: "tanstack";
+  readonly openrouter: "tanstack";
+  readonly openai: "tanstack";
+  readonly azure_foundry: "custom";
+  readonly anthropic: "tanstack";
+  readonly bedrock: "tanstack";
+  readonly mistral: "tanstack";
+  readonly openai_compatible: "custom";
+  readonly huggingface: "custom";
+};
+type TanStackAIProvider = { [TProvider in AIProvider]: (typeof AI_PROVIDER_ADAPTER_KIND)[TProvider] extends "tanstack" ? TProvider : never; }[AIProvider];
+declare const TANSTACK_AI_PROVIDERS: readonly ["google", "openrouter", "openai", "anthropic", "bedrock", "mistral"];
+declare const MODEL_CATALOG_PROVIDER_KIND: {
+  readonly google: "first-party";
+  readonly openrouter: "aggregator";
+  readonly openai: "first-party";
+  readonly anthropic: "first-party";
+  readonly bedrock: "platform";
+  readonly mistral: "first-party";
+};
+/** Providers whose picker IDs map directly to public first-party catalogs. */
+type FirstPartyModelProvider = { [TProvider in TanStackAIProvider]: (typeof MODEL_CATALOG_PROVIDER_KIND)[TProvider] extends "first-party" ? TProvider : never; }[TanStackAIProvider];
+declare const FIRST_PARTY_MODEL_PROVIDER_VALUES: readonly ["google", "openai", "anthropic", "mistral"];
 /**
- * Declared reasoning-effort values for a model ID, or `null` when the
- * model has no effort control or is not catalogued (custom deployments,
- * env overrides). Callers must never index `MODEL_REASONING_EFFORTS`
- * directly with a runtime string.
+ * Runtime form of the first-party provider union. The conditional annotation
+ * makes adding a first-party policy without adding its discovery implementation
+ * a compile error.
  */
-declare const getModelReasoningEfforts: (modelId: string) => readonly ReasoningEffort[] | null;
+declare const FIRST_PARTY_MODEL_PROVIDERS: Exclude<FirstPartyModelProvider, (typeof FIRST_PARTY_MODEL_PROVIDER_VALUES)[number]> extends never ? typeof FIRST_PARTY_MODEL_PROVIDER_VALUES : never;
 /**
- * Concrete provider-default effort published for a model, or null when the
- * provider exposes no named default. Unknown ids also resolve to null.
+ * Per-role default model IDs for the BYOK-capable cloud providers.
+ * Shared between the instance default table (`DEFAULT_MODELS`) and the
+ * settings-UI default selection, so a default is defined exactly once.
  */
-declare const getModelDefaultReasoningEffort: (modelId: string) => ReasoningEffort | null;
-type ResolveReasoningEffortOptions = {
-  modelId: string;
-  requested: ReasoningEffort;
+declare const BYOK_DEFAULT_MODELS: {
+  readonly google: {
+    readonly fast: "gemini-3.7-flash";
+    readonly chat: "gemini-3.7-flash";
+    readonly reasoning: "gemini-3.7-flash";
+    readonly pdf: "gemini-3.7-flash";
+  };
+  readonly openrouter: {
+    readonly fast: "openai/gpt-5.6-luna";
+    readonly chat: "openai/gpt-5.6-terra";
+    readonly reasoning: "openai/gpt-5.6-terra";
+    readonly pdf: "openai/gpt-5.6-terra";
+  };
+  readonly openai: {
+    readonly fast: "gpt-5.4-nano";
+    readonly chat: "gpt-5.4-mini";
+    readonly reasoning: "gpt-5.4";
+    readonly pdf: "gpt-5.4";
+  };
+  readonly anthropic: {
+    readonly fast: "claude-opus-5";
+    readonly chat: "claude-opus-5";
+    readonly reasoning: "claude-opus-5";
+    readonly pdf: "claude-opus-5";
+  };
+  readonly bedrock: {
+    readonly fast: "us.amazon.nova-micro-v1:0";
+    readonly chat: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
+    readonly reasoning: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
+    readonly pdf: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
+  };
+  readonly mistral: {
+    readonly fast: "mistral-small-latest";
+    readonly chat: "mistral-medium-latest";
+    readonly reasoning: "magistral-medium-latest";
+    readonly pdf: "mistral-large-latest";
+  };
 };
 /**
- * Clamp a requested reasoning effort into the target model's declared
- * capability.
- *
- * - Unknown model or no effort control → `null` (send no effort at
- *   all; the provider default is the only universally safe choice).
- * - Requested value supported → returned unchanged.
- * - Otherwise → the supported value nearest on `REASONING_EFFORTS`,
- *   preferring the weaker side on ties, so a "none" request against a
- *   reasoning-mandatory model degrades to its weakest tier instead of
- *   erroring, and requests above the model's ceiling clamp down to it.
+ * Instance-level default model IDs per provider. Extends the BYOK
+ * defaults with the providers that only the instance path uses
+ * (custom deployments and OpenAI-compatible endpoints).
  */
-declare const resolveReasoningEffort: ({ modelId, requested }: ResolveReasoningEffortOptions) => ResolvedReasoningEffort | null;
+declare const DEFAULT_MODELS: {
+  readonly azure_foundry: {
+    readonly fast: "gpt-5.4-nano";
+    readonly chat: "gpt-5.4-mini";
+    readonly reasoning: "gpt-5.4";
+    readonly pdf: "gpt-5.4";
+  };
+  readonly openai_compatible: {
+    readonly fast: "default";
+    readonly chat: "default";
+    readonly reasoning: "default";
+    readonly pdf: "default";
+  };
+  readonly huggingface: {
+    readonly fast: "speakleash/Bielik-1.5B-v3.0-Instruct";
+    readonly chat: "speakleash/Bielik-11B-v2.3-Instruct";
+    readonly reasoning: "speakleash/Bielik-11B-v2.3-Instruct";
+    readonly pdf: "speakleash/Bielik-11B-v2.3-Instruct";
+  };
+  readonly google: {
+    readonly fast: "gemini-3.7-flash";
+    readonly chat: "gemini-3.7-flash";
+    readonly reasoning: "gemini-3.7-flash";
+    readonly pdf: "gemini-3.7-flash";
+  };
+  readonly openrouter: {
+    readonly fast: "openai/gpt-5.6-luna";
+    readonly chat: "openai/gpt-5.6-terra";
+    readonly reasoning: "openai/gpt-5.6-terra";
+    readonly pdf: "openai/gpt-5.6-terra";
+  };
+  readonly openai: {
+    readonly fast: "gpt-5.4-nano";
+    readonly chat: "gpt-5.4-mini";
+    readonly reasoning: "gpt-5.4";
+    readonly pdf: "gpt-5.4";
+  };
+  readonly anthropic: {
+    readonly fast: "claude-opus-5";
+    readonly chat: "claude-opus-5";
+    readonly reasoning: "claude-opus-5";
+    readonly pdf: "claude-opus-5";
+  };
+  readonly bedrock: {
+    readonly fast: "us.amazon.nova-micro-v1:0";
+    readonly chat: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
+    readonly reasoning: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
+    readonly pdf: "us.anthropic.claude-sonnet-4-5-20250929-v1:0";
+  };
+  readonly mistral: {
+    readonly fast: "mistral-small-latest";
+    readonly chat: "mistral-medium-latest";
+    readonly reasoning: "magistral-medium-latest";
+    readonly pdf: "mistral-large-latest";
+  };
+};
 /**
- * Per-model ledger rates, normalized micro-units per 1M tokens.
+ * BYOK-offered model IDs per provider — the curated catalog users pick
+ * from in org settings, and the server-side allowlist the API enforces.
+ * The frontend list is not a security boundary; this is what the API
+ * accepts.
  *
- * Keys are the canonical model IDs stella passes to provider adapters.
- * Consumers (`apps/api/src/lib/usage/unit-model.ts`) fall back to a
- * defensive default for unknown IDs. The nightly
- * `model-catalog-upstream` check validates that every offered
- * first-party model has an entry and that entries stay mutually
- * consistent with upstream catalog cost metadata, so a stale entry
- * fails CI instead of silently mis-attributing usage.
+ * Limited to providers the TanStack AI integration supports for BYOK.
+ * Providers without a first-class TanStack adapter path are intentionally
+ * not accepted at this boundary.
  */
-type ModelRateAmounts = {
-  /** Normalized micro-units per 1M input tokens. */
-  inputPerMTok: number;
-  /** Normalized micro-units per 1M output tokens. */
-  outputPerMTok: number;
-  /**
-   * Normalized micro-units per 1M cached input tokens, when the
-   * provider offers a cache-read adjustment. Falls back to
-   * `inputPerMTok` when undefined.
-   */
-  cachedInputPerMTok?: number;
+declare const BYOK_MODEL_OPTIONS: {
+  readonly google: readonly ["gemini-3.8-flash", "gemini-3.7-flash", "gemini-3.6-flash", "gemini-3.5-flash-lite", "gemini-3.1-pro-preview", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
+  readonly anthropic: readonly ["claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-opus-4-7", "claude-sonnet-4-6", "claude-opus-4-6", "claude-haiku-4-5-20251001"];
+  readonly openai: readonly ["gpt-5.6", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.2"];
+  readonly openrouter: readonly ["openai/gpt-5.6-luna", "openai/gpt-5.6-terra", "google/gemini-3.8-flash", "google/gemini-3.7-flash", "google/gemini-3.6-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.1-pro-preview", "google/gemini-3.5-flash", "google/gemini-3.1-flash-lite", "anthropic/claude-sonnet-5", "anthropic/claude-opus-5", "anthropic/claude-opus-4.8", "anthropic/claude-sonnet-4.6", "openai/gpt-5.5", "openai/gpt-5.4-mini"];
+  readonly bedrock: readonly ["us.anthropic.claude-sonnet-4-5-20250929-v1:0", "us.anthropic.claude-haiku-4-5-20251001-v1:0", "us.amazon.nova-pro-v1:0", "us.amazon.nova-lite-v1:0", "us.amazon.nova-micro-v1:0", "openai.gpt-oss-120b-1:0", "openai.gpt-oss-20b-1:0", "us.deepseek.r1-v1:0"];
+  readonly mistral: readonly ["mistral-large-latest", "mistral-medium-latest", "mistral-small-latest", "magistral-medium-latest", "magistral-small", "pixtral-large-latest"];
 };
-/**
- * A discriminated rate schedule. Consumers must resolve the schedule from the
- * request's total input tokens before reading any prices, so a model with a
- * long-context premium cannot accidentally be metered at its base rate.
- */
-type ModelRate = ({
-  kind: "flat";
-} & ModelRateAmounts) | {
-  kind: "input-token-tiered";
-  /** The base tier applies at or below this total input-token count. */
-  inputTokenThreshold: number;
-  standard: ModelRateAmounts;
-  /** Applies to the entire request once input exceeds the threshold. */
-  aboveThreshold: ModelRateAmounts;
+type BYOKProvider = keyof typeof BYOK_MODEL_OPTIONS;
+type BYOKModelIdByProvider = { [TProvider in BYOKProvider]: (typeof BYOK_MODEL_OPTIONS)[TProvider][number]; };
+type OfferedBYOKModelId = BYOKModelIdByProvider[BYOKProvider];
+type ModelDisplayMetadata = {
+  /** Human-readable product name; model names are trademarks and stay untranslated. */
+  displayName: string;
+  /** Brand mark to show. This may differ from the routing provider. */
+  iconProvider: BYOKProvider;
 };
-declare const getStandardModelRate: (rate: ModelRate) => ModelRateAmounts;
-declare const resolveModelRate: (rate: ModelRate, inputTokens: number) => ModelRateAmounts;
 /**
- * Providers whose catalog entries are first-party API model IDs and so
- * must carry an explicit rate. Mirrors `MODELS_DEV_PROVIDER` in the
- * nightly check; `openrouter` (provider-prefixed slugs) and the
- * legacy/custom-deployment providers are metered by their underlying
- * model IDs or the fallback rate.
+ * Presentation metadata for every offered model. Keeping this exhaustive beside
+ * the allowlist prevents a newly offered model from leaking a raw provider ID
+ * into user-facing pickers. OpenRouter entries deliberately carry their model
+ * creator's icon while their routing provider remains available separately.
  */
-declare const MODEL_RATES: {
-  readonly "gemini-2.5-flash": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 30000;
-    readonly outputPerMTok: 250000;
-    readonly cachedInputPerMTok: 7500;
+declare const MODEL_DISPLAY_METADATA: {
+  readonly "gemini-3.8-flash": {
+    readonly displayName: "Gemini 3.8 Flash";
+    readonly iconProvider: "google";
   };
-  readonly "gemini-2.5-pro": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 125000;
-    readonly outputPerMTok: 1000000;
-    readonly cachedInputPerMTok: 31250;
+  readonly "gemini-3.7-flash": {
+    readonly displayName: "Gemini 3.7 Flash";
+    readonly iconProvider: "google";
   };
-  readonly "gemini-3.1-flash-lite": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 25000;
-    readonly outputPerMTok: 150000;
-    readonly cachedInputPerMTok: 2500;
+  readonly "gemini-3.6-flash": {
+    readonly displayName: "Gemini 3.6 Flash";
+    readonly iconProvider: "google";
   };
-  readonly "gemini-3.5-flash": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 150000;
-    readonly outputPerMTok: 900000;
-    readonly cachedInputPerMTok: 15000;
+  readonly "gemini-3.5-flash-lite": {
+    readonly displayName: "Gemini 3.5 Flash Lite";
+    readonly iconProvider: "google";
+  };
+  readonly "gemini-3.1-pro-preview": {
+    readonly displayName: "Gemini 3.1 Pro Preview";
+    readonly iconProvider: "google";
   };
-  readonly "gemini-3.5-flash-lite": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 30000;
-    readonly outputPerMTok: 250000;
-    readonly cachedInputPerMTok: 3000;
+  readonly "gemini-3.5-flash": {
+    readonly displayName: "Gemini 3.5 Flash";
+    readonly iconProvider: "google";
   };
-  readonly "gemini-3.6-flash": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 75000;
-    readonly outputPerMTok: 375000;
-    readonly cachedInputPerMTok: 7500;
+  readonly "gemini-3.1-flash-lite": {
+    readonly displayName: "Gemini 3.1 Flash Lite";
+    readonly iconProvider: "google";
   };
-  readonly "gemini-3.7-flash": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 75000;
-    readonly outputPerMTok: 375000;
-    readonly cachedInputPerMTok: 7500;
+  readonly "claude-sonnet-5": {
+    readonly displayName: "Claude Sonnet 5";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gemini-3.1-pro-preview": {
-    readonly kind: "input-token-tiered";
-    readonly inputTokenThreshold: 200000;
-    readonly standard: {
-      readonly inputPerMTok: 200000;
-      readonly outputPerMTok: 1200000;
-      readonly cachedInputPerMTok: 20000;
-    };
-    readonly aboveThreshold: {
-      readonly inputPerMTok: 400000;
-      readonly outputPerMTok: 1800000;
-      readonly cachedInputPerMTok: 40000;
-    };
+  readonly "claude-fable-5-1": {
+    readonly displayName: "Claude Fable 5.1";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gpt-4o-mini": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 15000;
-    readonly outputPerMTok: 60000;
-    readonly cachedInputPerMTok: 7500;
+  readonly "claude-fable-5": {
+    readonly displayName: "Claude Fable 5";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gpt-4o": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 250000;
-    readonly outputPerMTok: 1000000;
-    readonly cachedInputPerMTok: 125000;
+  readonly "claude-opus-5": {
+    readonly displayName: "Claude Opus 5";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gpt-5.2": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 175000;
-    readonly outputPerMTok: 1400000;
-    readonly cachedInputPerMTok: 17500;
+  readonly "claude-opus-4-8": {
+    readonly displayName: "Claude Opus 4.8";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gpt-5.4-nano": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 20000;
-    readonly outputPerMTok: 125000;
-    readonly cachedInputPerMTok: 2000;
+  readonly "claude-opus-4-7": {
+    readonly displayName: "Claude Opus 4.7";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gpt-5.4-mini": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 75000;
-    readonly outputPerMTok: 450000;
-    readonly cachedInputPerMTok: 7500;
+  readonly "claude-sonnet-4-6": {
+    readonly displayName: "Claude Sonnet 4.6";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gpt-5.4": {
-    readonly kind: "input-token-tiered";
-    readonly inputTokenThreshold: 272000;
-    readonly standard: {
-      readonly inputPerMTok: 250000;
-      readonly outputPerMTok: 1500000;
-      readonly cachedInputPerMTok: 25000;
-    };
-    readonly aboveThreshold: {
-      readonly inputPerMTok: 500000;
-      readonly outputPerMTok: 2250000;
-      readonly cachedInputPerMTok: 50000;
-    };
+  readonly "claude-opus-4-6": {
+    readonly displayName: "Claude Opus 4.6";
+    readonly iconProvider: "anthropic";
   };
-  readonly "gpt-5.5": {
-    readonly kind: "input-token-tiered";
-    readonly inputTokenThreshold: 272000;
-    readonly standard: {
-      readonly inputPerMTok: 500000;
-      readonly outputPerMTok: 3000000;
-      readonly cachedInputPerMTok: 50000;
-    };
-    readonly aboveThreshold: {
-      readonly inputPerMTok: 1000000;
-      readonly outputPerMTok: 4500000;
-      readonly cachedInputPerMTok: 100000;
-    };
+  readonly "claude-haiku-4-5-20251001": {
+    readonly displayName: "Claude Haiku 4.5";
+    readonly iconProvider: "anthropic";
   };
   readonly "gpt-5.6": {
-    readonly kind: "input-token-tiered";
-    readonly inputTokenThreshold: 272000;
-    readonly standard: {
-      readonly inputPerMTok: 400000;
-      readonly outputPerMTok: 2000000;
-      readonly cachedInputPerMTok: 40000;
-    };
-    readonly aboveThreshold: {
-      readonly inputPerMTok: 800000;
-      readonly outputPerMTok: 3000000;
-      readonly cachedInputPerMTok: 80000;
-    };
+    readonly displayName: "GPT-5.6 Sol";
+    readonly iconProvider: "openai";
+  };
+  readonly "gpt-5.6-terra": {
+    readonly displayName: "GPT-5.6 Terra";
+    readonly iconProvider: "openai";
   };
   readonly "gpt-5.6-luna": {
-    readonly kind: "input-token-tiered";
-    readonly inputTokenThreshold: 272000;
-    readonly standard: {
-      readonly inputPerMTok: 20000;
-      readonly outputPerMTok: 120000;
-      readonly cachedInputPerMTok: 2000;
-    };
-    readonly aboveThreshold: {
-      readonly inputPerMTok: 40000;
-      readonly outputPerMTok: 180000;
-      readonly cachedInputPerMTok: 4000;
-    };
+    readonly displayName: "GPT-5.6 Luna";
+    readonly iconProvider: "openai";
   };
-  readonly "gpt-5.6-terra": {
-    readonly kind: "input-token-tiered";
-    readonly inputTokenThreshold: 272000;
-    readonly standard: {
-      readonly inputPerMTok: 200000;
-      readonly outputPerMTok: 1200000;
-      readonly cachedInputPerMTok: 20000;
-    };
-    readonly aboveThreshold: {
-      readonly inputPerMTok: 400000;
-      readonly outputPerMTok: 1800000;
-      readonly cachedInputPerMTok: 40000;
-    };
+  readonly "gpt-5.5": {
+    readonly displayName: "GPT-5.5";
+    readonly iconProvider: "openai";
   };
-  readonly "claude-haiku-4-5-20251001": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 100000;
-    readonly outputPerMTok: 500000;
-    readonly cachedInputPerMTok: 10000;
+  readonly "gpt-5.4": {
+    readonly displayName: "GPT-5.4";
+    readonly iconProvider: "openai";
   };
-  readonly "claude-sonnet-4-6": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 300000;
-    readonly outputPerMTok: 1500000;
-    readonly cachedInputPerMTok: 30000;
+  readonly "gpt-5.4-mini": {
+    readonly displayName: "GPT-5.4 Mini";
+    readonly iconProvider: "openai";
   };
-  readonly "claude-sonnet-5": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 200000;
-    readonly outputPerMTok: 1000000;
-    readonly cachedInputPerMTok: 20000;
+  readonly "gpt-5.4-nano": {
+    readonly displayName: "GPT-5.4 Nano";
+    readonly iconProvider: "openai";
   };
-  readonly "claude-opus-4-6": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 500000;
-    readonly outputPerMTok: 2500000;
-    readonly cachedInputPerMTok: 50000;
+  readonly "gpt-5.2": {
+    readonly displayName: "GPT-5.2";
+    readonly iconProvider: "openai";
   };
-  readonly "claude-opus-4-7": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 500000;
-    readonly outputPerMTok: 2500000;
-    readonly cachedInputPerMTok: 50000;
+  readonly "openai/gpt-5.6-luna": {
+    readonly displayName: "GPT-5.6 Luna";
+    readonly iconProvider: "openai";
   };
-  readonly "claude-opus-4-8": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 500000;
-    readonly outputPerMTok: 2500000;
-    readonly cachedInputPerMTok: 50000;
+  readonly "openai/gpt-5.6-terra": {
+    readonly displayName: "GPT-5.6 Terra";
+    readonly iconProvider: "openai";
   };
-  readonly "claude-opus-5": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 500000;
-    readonly outputPerMTok: 2500000;
-    readonly cachedInputPerMTok: 50000;
+  readonly "google/gemini-3.8-flash": {
+    readonly displayName: "Gemini 3.8 Flash";
+    readonly iconProvider: "google";
   };
-  readonly "claude-fable-5": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 1000000;
-    readonly outputPerMTok: 5000000;
-    readonly cachedInputPerMTok: 100000;
+  readonly "google/gemini-3.7-flash": {
+    readonly displayName: "Gemini 3.7 Flash";
+    readonly iconProvider: "google";
   };
-  readonly "claude-fable-5-1": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 1000000;
-    readonly outputPerMTok: 5000000;
-    readonly cachedInputPerMTok: 25000;
+  readonly "google/gemini-3.6-flash": {
+    readonly displayName: "Gemini 3.6 Flash";
+    readonly iconProvider: "google";
   };
-  readonly "mistral-small-latest": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 15000;
-    readonly outputPerMTok: 60000;
+  readonly "google/gemini-3.5-flash-lite": {
+    readonly displayName: "Gemini 3.5 Flash Lite";
+    readonly iconProvider: "google";
   };
-  readonly "mistral-large-latest": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 50000;
-    readonly outputPerMTok: 150000;
+  readonly "google/gemini-3.1-pro-preview": {
+    readonly displayName: "Gemini 3.1 Pro Preview";
+    readonly iconProvider: "google";
   };
-  readonly "mistral-medium-latest": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 150000;
-    readonly outputPerMTok: 750000;
+  readonly "google/gemini-3.5-flash": {
+    readonly displayName: "Gemini 3.5 Flash";
+    readonly iconProvider: "google";
+  };
+  readonly "google/gemini-3.1-flash-lite": {
+    readonly displayName: "Gemini 3.1 Flash Lite";
+    readonly iconProvider: "google";
+  };
+  readonly "anthropic/claude-sonnet-5": {
+    readonly displayName: "Claude Sonnet 5";
+    readonly iconProvider: "anthropic";
   };
-  readonly "mistral-medium-3-5": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 150000;
-    readonly outputPerMTok: 750000;
+  readonly "anthropic/claude-opus-5": {
+    readonly displayName: "Claude Opus 5";
+    readonly iconProvider: "anthropic";
   };
-  readonly "magistral-medium-latest": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 200000;
-    readonly outputPerMTok: 500000;
+  readonly "anthropic/claude-opus-4.8": {
+    readonly displayName: "Claude Opus 4.8";
+    readonly iconProvider: "anthropic";
   };
-  readonly "magistral-small": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 50000;
-    readonly outputPerMTok: 150000;
+  readonly "anthropic/claude-sonnet-4.6": {
+    readonly displayName: "Claude Sonnet 4.6";
+    readonly iconProvider: "anthropic";
   };
-  readonly "magistral-small-latest": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 50000;
-    readonly outputPerMTok: 150000;
+  readonly "openai/gpt-5.5": {
+    readonly displayName: "GPT-5.5";
+    readonly iconProvider: "openai";
   };
-  readonly "pixtral-large-latest": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 200000;
-    readonly outputPerMTok: 600000;
+  readonly "openai/gpt-5.4-mini": {
+    readonly displayName: "GPT-5.4 Mini";
+    readonly iconProvider: "openai";
   };
   readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 300000;
-    readonly outputPerMTok: 1500000;
-    readonly cachedInputPerMTok: 30000;
+    readonly displayName: "Claude Sonnet 4.5";
+    readonly iconProvider: "anthropic";
   };
   readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 100000;
-    readonly outputPerMTok: 500000;
-    readonly cachedInputPerMTok: 10000;
+    readonly displayName: "Claude Haiku 4.5";
+    readonly iconProvider: "anthropic";
   };
   readonly "us.amazon.nova-pro-v1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 80000;
-    readonly outputPerMTok: 320000;
+    readonly displayName: "Amazon Nova Pro";
+    readonly iconProvider: "bedrock";
   };
   readonly "us.amazon.nova-lite-v1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 6000;
-    readonly outputPerMTok: 24000;
+    readonly displayName: "Amazon Nova Lite";
+    readonly iconProvider: "bedrock";
   };
   readonly "us.amazon.nova-micro-v1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 3500;
-    readonly outputPerMTok: 14000;
+    readonly displayName: "Amazon Nova Micro";
+    readonly iconProvider: "bedrock";
   };
   readonly "openai.gpt-oss-120b-1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 15000;
-    readonly outputPerMTok: 60000;
+    readonly displayName: "GPT OSS 120B";
+    readonly iconProvider: "openai";
   };
   readonly "openai.gpt-oss-20b-1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 7000;
-    readonly outputPerMTok: 30000;
+    readonly displayName: "GPT OSS 20B";
+    readonly iconProvider: "openai";
   };
   readonly "us.deepseek.r1-v1:0": {
-    readonly kind: "flat";
-    readonly inputPerMTok: 135000;
-    readonly outputPerMTok: 540000;
+    readonly displayName: "DeepSeek R1";
+    readonly iconProvider: "bedrock";
+  };
+  readonly "mistral-large-latest": {
+    readonly displayName: "Mistral Large";
+    readonly iconProvider: "mistral";
+  };
+  readonly "mistral-medium-latest": {
+    readonly displayName: "Mistral Medium";
+    readonly iconProvider: "mistral";
+  };
+  readonly "mistral-small-latest": {
+    readonly displayName: "Mistral Small";
+    readonly iconProvider: "mistral";
+  };
+  readonly "magistral-medium-latest": {
+    readonly displayName: "Magistral Medium";
+    readonly iconProvider: "mistral";
+  };
+  readonly "magistral-small": {
+    readonly displayName: "Magistral Small";
+    readonly iconProvider: "mistral";
+  };
+  readonly "pixtral-large-latest": {
+    readonly displayName: "Pixtral Large";
+    readonly iconProvider: "mistral";
   };
 };
+declare const getModelDisplayMetadata: (modelId: string) => ModelDisplayMetadata | null;
+/**
+ * Offered models whose provider API accepts PDF/file content. Generated from
+ * live models.dev input modalities plus dated, reviewed source corrections;
+ * the nightly upstream check rejects drift.
+ */
+declare const BYOK_DOCUMENT_INPUT_MODEL_OPTIONS: {
+  readonly google: readonly ["gemini-3.8-flash", "gemini-3.7-flash", "gemini-3.6-flash", "gemini-3.5-flash-lite", "gemini-3.1-pro-preview", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
+  readonly openrouter: readonly ["openai/gpt-5.6-luna", "openai/gpt-5.6-terra", "google/gemini-3.8-flash", "google/gemini-3.7-flash", "google/gemini-3.6-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.1-pro-preview", "google/gemini-3.5-flash", "google/gemini-3.1-flash-lite", "anthropic/claude-sonnet-5", "anthropic/claude-opus-5", "anthropic/claude-opus-4.8", "anthropic/claude-sonnet-4.6", "openai/gpt-5.5", "openai/gpt-5.4-mini"];
+  readonly openai: readonly ["gpt-5.6", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.2"];
+  readonly anthropic: readonly ["claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-opus-4-7", "claude-sonnet-4-6", "claude-opus-4-6", "claude-haiku-4-5-20251001"];
+  readonly bedrock: readonly ["us.anthropic.claude-sonnet-4-5-20250929-v1:0", "us.anthropic.claude-haiku-4-5-20251001-v1:0", "us.amazon.nova-pro-v1:0", "us.amazon.nova-lite-v1:0"];
+  readonly mistral: readonly [];
+};
+declare const isBYOKProviderRoleSupported: ({ provider, role }: {
+  provider: BYOKProvider;
+  role: ModelRole;
+}) => boolean;
+declare const isBYOKModelRoleSupported: ({ provider, modelId, role }: {
+  provider: BYOKProvider;
+  modelId: string;
+  role: ModelRole;
+}) => boolean;
+/**
+ * Models whose provider adapter can receive a PDF `document` content part in a
+ * chat turn without throwing. This is a narrower, runtime question than the
+ * pdf ROLE (`BYOK_DOCUMENT_INPUT_MODEL_OPTIONS`, which curates model selection
+ * for PDF-processing flows): it only asks "will the chat stream survive this
+ * attachment." The Mistral text adapter maps PDF `document` parts to
+ * `document_url`, so its
+ * vision models accept PDF attachments even though Mistral is deliberately not
+ * offered as a pdf-role provider. Mistral's `document_url` takes PDF but NOT
+ * textual documents (docx/txt/csv/md), so those still gate on
+ * `BYOK_DOCUMENT_INPUT_MODEL_OPTIONS` (which excludes Mistral). Superset
+ * invariant: every pdf-role document model also accepts a PDF chat attachment.
+ */
+declare const CHAT_PDF_ATTACHMENT_MODEL_OPTIONS: {
+  readonly mistral: readonly ["mistral-medium-latest", "mistral-small-latest", "pixtral-large-latest"];
+  readonly google: readonly ["gemini-3.8-flash", "gemini-3.7-flash", "gemini-3.6-flash", "gemini-3.5-flash-lite", "gemini-3.1-pro-preview", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
+  readonly openrouter: readonly ["openai/gpt-5.6-luna", "openai/gpt-5.6-terra", "google/gemini-3.8-flash", "google/gemini-3.7-flash", "google/gemini-3.6-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.1-pro-preview", "google/gemini-3.5-flash", "google/gemini-3.1-flash-lite", "anthropic/claude-sonnet-5", "anthropic/claude-opus-5", "anthropic/claude-opus-4.8", "anthropic/claude-sonnet-4.6", "openai/gpt-5.5", "openai/gpt-5.4-mini"];
+  readonly openai: readonly ["gpt-5.6", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.2"];
+  readonly anthropic: readonly ["claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-opus-4-7", "claude-sonnet-4-6", "claude-opus-4-6", "claude-haiku-4-5-20251001"];
+  readonly bedrock: readonly ["us.anthropic.claude-sonnet-4-5-20250929-v1:0", "us.anthropic.claude-haiku-4-5-20251001-v1:0", "us.amazon.nova-pro-v1:0", "us.amazon.nova-lite-v1:0"];
+};
+declare const isChatPdfAttachmentModelSupported: ({ provider, modelId }: {
+  provider: BYOKProvider;
+  modelId: string;
+}) => boolean;
+/**
+ * Resolve a model id that will actually work for this provider+role,
+ * keeping the SAME provider. Returns the caller's model unchanged when
+ * it is still offered; otherwise falls back to the provider's per-role
+ * default (`BYOK_DEFAULT_MODELS`). Returns `null` only when the
+ * provider has no valid model for the role at all — the sole case
+ * today is `mistral` + `pdf`, because the TanStack Mistral adapter
+ * exposes no `document` input modality, so no Mistral model (not even
+ * the default) can serve the PDF role.
+ *
+ * Used to auto-heal org AI configs whose pinned model was removed by a
+ * catalog bump, so generation resolves to a supported model instead of
+ * 400-ing (or forwarding a retired id to the provider).
+ */
+declare const resolveWorkingBYOKModelForRole: ({ provider, modelId, role }: {
+  provider: BYOKProvider;
+  modelId: string;
+  role: ModelRole;
+}) => string | null;
+/**
+ * Anthropic models that use the adaptive-thinking request shape
+ * (`thinking: { type: "adaptive" }`). Newer Claude models reject the
+ * legacy budget-based form, so every Opus 4.6+/Sonnet 4.6/Fable entry
+ * offered above must appear here or it will 400 on the reasoning role.
+ */
+declare const ANTHROPIC_ADAPTIVE_THINKING_MODELS: readonly ["claude-sonnet-5", "claude-opus-5", "claude-sonnet-4-6", "claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8", "claude-fable-5", "claude-fable-5-1"];
+/**
+ * Canonical reasoning-effort ladder, ordered weakest to strongest.
+ * Union of every effort keyword the offered providers accept; no
+ * single model accepts all of them, which is exactly why the
+ * generated per-model `MODEL_REASONING_EFFORTS` exists.
+ */
+declare const REASONING_EFFORTS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
+type ReasoningEffort = (typeof REASONING_EFFORTS)[number];
+declare const resolvedReasoningEffortSchema: v.SchemaWithPipe<readonly [v.PicklistSchema<readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"], undefined>, v.BrandAction<"none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", "ResolvedReasoningEffort">]>;
+/**
+ * A reasoning effort proven to be accepted by the model it targets.
+ * Only `resolveReasoningEffort` can produce this type, so option
+ * builders cannot hand a provider a literal effort the model rejects
+ * (e.g. `"none"` to a model whose reasoning cannot be disabled) —
+ * that mistake now fails typecheck instead of 502-ing at runtime.
+ */
+type ResolvedReasoningEffort = v.InferOutput<typeof resolvedReasoningEffortSchema>;
+/**
+ * Per-provider model served when a user's included budget is exhausted
+ * and no explicit selection overrides it. Falls back to each
+ * provider's fast-role default; providers without a first-class
+ * adapter path cannot serve the lane. Total over providers so a new
+ * provider lands with an explicit decision.
+ */
+declare const FALLBACK_CHAT_MODEL_BY_PROVIDER: {
+  readonly google: "gemini-3.7-flash";
+  readonly openrouter: "openai/gpt-5.6-luna";
+  readonly openai: "gpt-5.6-luna";
+  readonly anthropic: "claude-opus-5";
+  readonly bedrock: "us.amazon.nova-micro-v1:0";
+  readonly mistral: "mistral-small-latest";
+  readonly azure_foundry: null;
+  readonly openai_compatible: null;
+  readonly huggingface: null;
+};
+/**
+ * Provider-native IDs that are exact aliases of an offered catalog ID.
+ * Every metadata lookup normalizes here, so instance/dev overrides cannot
+ * bypass rates or capabilities and duplicated alias rows cannot drift apart.
+ */
+declare const MODEL_CATALOG_ID_ALIASES: {
+  readonly "gpt-5.6-sol": "gpt-5.6";
+  readonly "claude-opus-4.8": "claude-opus-4-8";
+  readonly "claude-sonnet-4.6": "claude-sonnet-4-6";
+};
+declare const normalizeModelCatalogId: (modelId: string) => string;
+/**
+ * Whether stella should emit a `temperature` override for this model.
+ * This is deliberately stricter than provider acceptance: deprecated
+ * parameters that are accepted but ignored resolve to `false`. Unknown ids
+ * also resolve to `false` (send nothing; provider default). Callers must
+ * never index `MODEL_TEMPERATURE_POLICIES` directly with
+ * a runtime string.
+ */
+declare const shouldEmitTemperature: (modelId: string) => boolean;
+/**
+ * Declared reasoning-effort values for a model ID, or `null` when the
+ * model has no effort control or is not catalogued (custom deployments,
+ * env overrides). Callers must never index `MODEL_REASONING_EFFORTS`
+ * directly with a runtime string.
+ */
+declare const getModelReasoningEfforts: (modelId: string) => readonly ReasoningEffort[] | null;
+/**
+ * Concrete provider-default effort published for a model, or null when the
+ * provider exposes no named default. Unknown ids also resolve to null.
+ */
+declare const getModelDefaultReasoningEffort: (modelId: string) => ReasoningEffort | null;
+type ResolveReasoningEffortOptions = {
+  modelId: string;
+  requested: ReasoningEffort;
+};
+/**
+ * Clamp a requested reasoning effort into the target model's declared
+ * capability.
+ *
+ * - Unknown model or no effort control → `null` (send no effort at
+ *   all; the provider default is the only universally safe choice).
+ * - Requested value supported → returned unchanged.
+ * - Otherwise → the supported value nearest on `REASONING_EFFORTS`,
+ *   preferring the weaker side on ties, so a "none" request against a
+ *   reasoning-mandatory model degrades to its weakest tier instead of
+ *   erroring, and requests above the model's ceiling clamp down to it.
+ */
+declare const resolveReasoningEffort: ({ modelId, requested }: ResolveReasoningEffortOptions) => ResolvedReasoningEffort | null;
 declare const getModelRate: (modelId: string) => ModelRate | undefined;
 /**
  * Documented input context-window sizes (in tokens) per model ID.
@@ -1123,6 +1215,7 @@ declare const CONTEXT_WINDOW_TOKENS: {
   readonly "gemini-3.5-flash-lite": 1048576;
   readonly "gemini-3.6-flash": 1048576;
   readonly "gemini-3.7-flash": 1048576;
+  readonly "gemini-3.8-flash": 1048576;
   readonly "gemini-3.1-pro-preview": 1048576;
   readonly "gpt-4o-mini": 128000;
   readonly "gpt-4o": 128000;
@@ -1151,6 +1244,7 @@ declare const CONTEXT_WINDOW_TOKENS: {
   readonly "magistral-small-latest": 128000;
   readonly "magistral-small": 128000;
   readonly "pixtral-large-latest": 128000;
+  readonly "google/gemini-3.8-flash": 1048576;
   readonly "google/gemini-3.7-flash": 1048576;
   readonly "google/gemini-3.6-flash": 1048576;
   readonly "google/gemini-3.5-flash-lite": 1048576;
@@ -1187,4 +1281,4 @@ declare const DEFAULT_CONTEXT_WINDOW_TOKENS = 128000;
  */
 declare const getContextWindowTokens: (modelId: string) => number;
 //#endregion
-export { AIProvider, AI_PROVIDERS, ANTHROPIC_ADAPTIVE_THINKING_MODELS, BYOKModelIdByProvider, BYOKProvider, BYOK_DEFAULT_MODELS, BYOK_DOCUMENT_INPUT_MODEL_OPTIONS, BYOK_MODEL_OPTIONS, CAPABILITY_OVERRIDES, CHAT_PDF_ATTACHMENT_MODEL_OPTIONS, CONTEXT_WINDOW_TOKENS, type CapabilityOverride, DEFAULT_CONTEXT_WINDOW_TOKENS, DEFAULT_MODELS, DOCUMENT_INPUT_OVERRIDES, type DocumentInputOverride, FALLBACK_CHAT_MODEL_BY_PROVIDER, FIRST_PARTY_MODEL_PROVIDERS, FirstPartyModelProvider, MODEL_CATALOG_ID_ALIASES, MODEL_CATALOG_PROVIDER_KIND, MODEL_DEFAULT_REASONING_EFFORTS, MODEL_DISPLAY_METADATA, MODEL_RATES, MODEL_REASONING_EFFORTS, MODEL_ROLES, MODEL_TEMPERATURE_POLICIES, ModelDisplayMetadata, ModelRate, ModelRateAmounts, ModelRole, OfferedBYOKModelId, REASONING_EFFORTS, ReasoningEffort, ResolveReasoningEffortOptions, ResolvedReasoningEffort, TANSTACK_AI_PROVIDERS, TEMPERATURE_POLICIES, TanStackAIProvider, TemperaturePolicy, getContextWindowTokens, getModelDefaultReasoningEffort, getModelDisplayMetadata, getModelRate, getModelReasoningEfforts, getStandardModelRate, isBYOKModelRoleSupported, isBYOKProviderRoleSupported, isChatPdfAttachmentModelSupported, normalizeModelCatalogId, resolveModelRate, resolveReasoningEffort, resolveWorkingBYOKModelForRole, shouldEmitTemperature };
+export { AIProvider, AI_PROVIDERS, ANTHROPIC_ADAPTIVE_THINKING_MODELS, BYOKModelIdByProvider, BYOKProvider, BYOK_DEFAULT_MODELS, BYOK_DOCUMENT_INPUT_MODEL_OPTIONS, BYOK_MODEL_OPTIONS, CAPABILITY_OVERRIDES, CHAT_PDF_ATTACHMENT_MODEL_OPTIONS, CONTEXT_WINDOW_TOKENS, type CapabilityOverride, DEFAULT_CONTEXT_WINDOW_TOKENS, DEFAULT_MODELS, DOCUMENT_INPUT_OVERRIDES, type DocumentInputOverride, FALLBACK_CHAT_MODEL_BY_PROVIDER, FIRST_PARTY_MODEL_PROVIDERS, FirstPartyModelProvider, MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER, MODELS_DEV_RATE_SOURCE_ALIASES, MODEL_CATALOG_ID_ALIASES, MODEL_CATALOG_PROVIDER_KIND, MODEL_DEFAULT_REASONING_EFFORTS, MODEL_DISPLAY_METADATA, MODEL_RATES, MODEL_RATE_UNITS_PER_USD, MODEL_REASONING_EFFORTS, MODEL_ROLES, MODEL_TEMPERATURE_POLICIES, ModelDisplayMetadata, type ModelRate, type ModelRateAmounts, ModelRole, type ModelsDevRateProvider, OfferedBYOKModelId, REASONING_EFFORTS, RETAINED_MODELS_DEV_RATE_ENTRIES, ReasoningEffort, ResolveReasoningEffortOptions, ResolvedReasoningEffort, TANSTACK_AI_PROVIDERS, TEMPERATURE_POLICIES, TanStackAIProvider, TemperaturePolicy, getContextWindowTokens, getModelDefaultReasoningEffort, getModelDisplayMetadata, getModelRate, getModelReasoningEfforts, getStandardModelRate, isBYOKModelRoleSupported, isBYOKProviderRoleSupported, isChatPdfAttachmentModelSupported, normalizeModelCatalogId, resolveModelRate, resolveReasoningEffort, resolveWorkingBYOKModelForRole, shouldEmitTemperature };