@stll/ai-catalog 0.4.0 → 0.6.0

package/dist/index-pC8aWAxm.d.ts

@@ -0,0 +1,1721 @@
+import * as v from "valibot";
+//#region src/model-rate.d.ts
+/**
+ * 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 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;
+};
+/**
+ * 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.
+ */
+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 kind: "flat";
+    readonly inputPerMTok: 75000;
+    readonly outputPerMTok: 375000;
+    readonly cachedInputPerMTok: 7500;
+  };
+  readonly "gemini-3.6-flash": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 75000;
+    readonly outputPerMTok: 375000;
+    readonly cachedInputPerMTok: 7500;
+  };
+  readonly "gemini-3.5-flash-lite": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 30000;
+    readonly outputPerMTok: 250000;
+    readonly cachedInputPerMTok: 3000;
+  };
+  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 "gemini-3.5-flash": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 150000;
+    readonly outputPerMTok: 900000;
+    readonly cachedInputPerMTok: 15000;
+  };
+  readonly "gemini-3.1-flash-lite": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 25000;
+    readonly outputPerMTok: 150000;
+    readonly cachedInputPerMTok: 2500;
+  };
+  readonly "gpt-6.1-sol": {
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 200000;
+      readonly outputPerMTok: 1000000;
+      readonly cachedInputPerMTok: 10000;
+      readonly cachedWriteInputPerMTok: 250000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 400000;
+      readonly outputPerMTok: 1500000;
+      readonly cachedInputPerMTok: 20000;
+      readonly cachedWriteInputPerMTok: 500000;
+    };
+  };
+  readonly "gpt-6-astra": {
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 1000000;
+      readonly outputPerMTok: 5000000;
+      readonly cachedInputPerMTok: 100000;
+      readonly cachedWriteInputPerMTok: 1250000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 2000000;
+      readonly outputPerMTok: 7500000;
+      readonly cachedInputPerMTok: 200000;
+      readonly cachedWriteInputPerMTok: 2500000;
+    };
+  };
+  readonly "gpt-6-sol": {
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 200000;
+      readonly outputPerMTok: 1000000;
+      readonly cachedInputPerMTok: 20000;
+      readonly cachedWriteInputPerMTok: 250000;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 400000;
+      readonly outputPerMTok: 1500000;
+      readonly cachedInputPerMTok: 40000;
+      readonly cachedWriteInputPerMTok: 500000;
+    };
+  };
+  readonly "gpt-6-luna": {
+    readonly kind: "input-token-tiered";
+    readonly inputTokenThreshold: 272000;
+    readonly standard: {
+      readonly inputPerMTok: 10000;
+      readonly outputPerMTok: 50000;
+      readonly cachedInputPerMTok: 1000;
+      readonly cachedWriteInputPerMTok: 12500;
+    };
+    readonly aboveThreshold: {
+      readonly inputPerMTok: 20000;
+      readonly outputPerMTok: 75000;
+      readonly cachedInputPerMTok: 2000;
+      readonly cachedWriteInputPerMTok: 25000;
+    };
+  };
+  readonly "gpt-5.6": {
+    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 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 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 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 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 "gpt-5.4-mini": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 75000;
+    readonly outputPerMTok: 450000;
+    readonly cachedInputPerMTok: 7500;
+  };
+  readonly "gpt-5.4-nano": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 20000;
+    readonly outputPerMTok: 125000;
+    readonly cachedInputPerMTok: 2000;
+  };
+  readonly "gpt-5.2": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 175000;
+    readonly outputPerMTok: 1400000;
+    readonly cachedInputPerMTok: 17500;
+  };
+  readonly "claude-sonnet-5-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 200000;
+    readonly outputPerMTok: 1000000;
+    readonly cachedInputPerMTok: 20000;
+    readonly cachedWriteInputPerMTok: 250000;
+  };
+  readonly "claude-sonnet-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 200000;
+    readonly outputPerMTok: 1000000;
+    readonly cachedInputPerMTok: 20000;
+    readonly cachedWriteInputPerMTok: 250000;
+  };
+  readonly "claude-fable-5-1": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 1000000;
+    readonly outputPerMTok: 5000000;
+    readonly cachedInputPerMTok: 25000;
+    readonly cachedWriteInputPerMTok: 1250000;
+  };
+  readonly "claude-fable-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 1000000;
+    readonly outputPerMTok: 5000000;
+    readonly cachedInputPerMTok: 100000;
+    readonly cachedWriteInputPerMTok: 1250000;
+  };
+  readonly "claude-opus-5-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 400000;
+    readonly outputPerMTok: 2000000;
+    readonly cachedInputPerMTok: 20000;
+    readonly cachedWriteInputPerMTok: 500000;
+  };
+  readonly "claude-opus-5": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
+  };
+  readonly "claude-opus-4-8": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
+  };
+  readonly "claude-opus-4-7": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
+  };
+  readonly "claude-sonnet-4-6": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 300000;
+    readonly outputPerMTok: 1500000;
+    readonly cachedInputPerMTok: 30000;
+    readonly cachedWriteInputPerMTok: 375000;
+  };
+  readonly "claude-opus-4-6": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 500000;
+    readonly outputPerMTok: 2500000;
+    readonly cachedInputPerMTok: 50000;
+    readonly cachedWriteInputPerMTok: 625000;
+  };
+  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 kind: "flat";
+    readonly inputPerMTok: 330000;
+    readonly outputPerMTok: 1650000;
+    readonly cachedInputPerMTok: 33000;
+    readonly cachedWriteInputPerMTok: 412500;
+  };
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 110000;
+    readonly outputPerMTok: 550000;
+    readonly cachedInputPerMTok: 11000;
+    readonly cachedWriteInputPerMTok: 137500;
+  };
+  readonly "us.amazon.nova-pro-v1:0": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 80000;
+    readonly outputPerMTok: 320000;
+    readonly cachedInputPerMTok: 20000;
+    readonly cachedWriteInputPerMTok: 80000;
+  };
+  readonly "us.amazon.nova-lite-v1:0": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 6000;
+    readonly outputPerMTok: 24000;
+    readonly cachedInputPerMTok: 1500;
+    readonly cachedWriteInputPerMTok: 6000;
+  };
+  readonly "us.amazon.nova-micro-v1:0": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 3500;
+    readonly outputPerMTok: 14000;
+    readonly cachedInputPerMTok: 875;
+    readonly cachedWriteInputPerMTok: 3500;
+  };
+  readonly "openai.gpt-oss-120b-1:0": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 15000;
+    readonly outputPerMTok: 60000;
+  };
+  readonly "openai.gpt-oss-20b-1:0": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 7000;
+    readonly outputPerMTok: 30000;
+  };
+  readonly "mistral-large-4": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 68000;
+    readonly outputPerMTok: 209000;
+    readonly cachedInputPerMTok: 7000;
+  };
+  readonly "mistral-large-latest": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 50000;
+    readonly outputPerMTok: 150000;
+    readonly cachedInputPerMTok: 5000;
+  };
+  readonly "mistral-medium-latest": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 150000;
+    readonly outputPerMTok: 750000;
+    readonly cachedInputPerMTok: 15000;
+  };
+  readonly "mistral-small-latest": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 15000;
+    readonly outputPerMTok: 60000;
+    readonly cachedInputPerMTok: 1500;
+  };
+  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;
+  };
+  readonly "us.deepseek.r1-v1:0": {
+    readonly kind: "flat";
+    readonly inputPerMTok: 135000;
+    readonly outputPerMTok: 540000;
+  };
+};
+//#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";
+};
+type ModelsDevRateProvider = (typeof MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER)[keyof typeof MODELS_DEV_RATE_PROVIDER_BY_CATALOG_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 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";
+  };
+  readonly "us.deepseek.r1-v1:0": {
+    readonly modelId: "us.deepseek.r1-v1:0";
+    readonly provider: "amazon-bedrock";
+  };
+};
+/**
+ * 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, so the
+ * map is empty whenever upstream covers every offered ID.
+ */
+declare const MODELS_DEV_RATE_SOURCE_ALIASES: {};
+//#endregion
+//#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;
+  /** The most output tokens one response may carry, from the provider docs. */
+  outputTokens: number;
+  temperatureSupported: boolean;
+  /**
+   * Every role sends tool definitions or structured output, so an
+   * offered model must accept tools.
+   */
+  toolCalling: true;
+  /** Why the upstream source cannot answer for this model. Dated. */
+  reason: string;
+};
+declare const CAPABILITY_OVERRIDES: Partial<Record<OfferedBYOKModelId, CapabilityOverride>>;
+type ImageInputOverride = {
+  supported: boolean;
+  /** Dated correction with an official provider documentation URL. */
+  reason: string;
+};
+type ImageInputOverrides = { [TProvider in BYOKProvider]?: Partial<Record<BYOKModelIdByProvider[TProvider], ImageInputOverride>>; };
+/** Only official provider documentation may override input-modality evidence. */
+declare const IMAGE_INPUT_OVERRIDES: ImageInputOverrides;
+//#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
+/** Every offered provider/model pair has explicit image-input evidence. */
+declare const MODEL_IMAGE_INPUT_CAPABILITIES: {
+  readonly google: {
+    readonly "gemini-3.8-flash": "supported";
+    readonly "gemini-3.7-flash": "supported";
+    readonly "gemini-3.6-flash": "supported";
+    readonly "gemini-3.5-flash-lite": "supported";
+    readonly "gemini-3.1-pro-preview": "supported";
+    readonly "gemini-3.5-flash": "supported";
+    readonly "gemini-3.1-flash-lite": "supported";
+  };
+  readonly openrouter: {
+    readonly "openai/gpt-6.1-sol": "supported";
+    readonly "openai/gpt-6-astra": "supported";
+    readonly "openai/gpt-6-sol": "supported";
+    readonly "openai/gpt-6-luna": "supported";
+    readonly "openai/gpt-5.6-sol": "supported";
+    readonly "openai/gpt-5.6-terra": "supported";
+    readonly "openai/gpt-5.6-luna": "supported";
+    readonly "google/gemini-3.8-flash": "supported";
+    readonly "google/gemini-3.7-flash": "supported";
+    readonly "google/gemini-3.6-flash": "supported";
+    readonly "google/gemini-3.5-flash-lite": "supported";
+    readonly "google/gemini-3.1-pro-preview": "supported";
+    readonly "google/gemini-3.5-flash": "supported";
+    readonly "google/gemini-3.1-flash-lite": "supported";
+    readonly "anthropic/claude-sonnet-5.5": "supported";
+    readonly "anthropic/claude-sonnet-5": "supported";
+    readonly "anthropic/claude-opus-5": "supported";
+    readonly "anthropic/claude-opus-4.8": "supported";
+    readonly "anthropic/claude-sonnet-4.6": "supported";
+    readonly "openai/gpt-5.5": "supported";
+    readonly "openai/gpt-5.4-mini": "supported";
+  };
+  readonly openai: {
+    readonly "gpt-6.1-sol": "supported";
+    readonly "gpt-6-astra": "supported";
+    readonly "gpt-6-sol": "supported";
+    readonly "gpt-6-luna": "supported";
+    readonly "gpt-5.6": "supported";
+    readonly "gpt-5.6-terra": "supported";
+    readonly "gpt-5.6-luna": "supported";
+    readonly "gpt-5.5": "supported";
+    readonly "gpt-5.4": "supported";
+    readonly "gpt-5.4-mini": "supported";
+    readonly "gpt-5.4-nano": "supported";
+    readonly "gpt-5.2": "supported";
+  };
+  readonly anthropic: {
+    readonly "claude-sonnet-5-5": "supported";
+    readonly "claude-sonnet-5": "supported";
+    readonly "claude-fable-5-1": "supported";
+    readonly "claude-fable-5": "supported";
+    readonly "claude-opus-5-5": "supported";
+    readonly "claude-opus-5": "supported";
+    readonly "claude-opus-4-8": "supported";
+    readonly "claude-opus-4-7": "supported";
+    readonly "claude-sonnet-4-6": "supported";
+    readonly "claude-opus-4-6": "supported";
+    readonly "claude-haiku-4-5-20251001": "supported";
+  };
+  readonly bedrock: {
+    readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": "supported";
+    readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": "supported";
+    readonly "us.amazon.nova-pro-v1:0": "supported";
+    readonly "us.amazon.nova-lite-v1:0": "supported";
+    readonly "us.amazon.nova-micro-v1:0": "unsupported";
+    readonly "openai.gpt-oss-120b-1:0": "unsupported";
+    readonly "openai.gpt-oss-20b-1:0": "unsupported";
+  };
+  readonly mistral: {
+    readonly "mistral-large-4": "supported";
+    readonly "mistral-large-latest": "supported";
+    readonly "mistral-medium-latest": "supported";
+    readonly "mistral-small-latest": "supported";
+  };
+};
+/**
+ * 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-6.1-sol": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "openai/gpt-6-astra": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "openai/gpt-6-sol": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "openai/gpt-6-luna": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "openai/gpt-5.6-sol": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "openai/gpt-5.6-terra": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "openai/gpt-5.6-luna": 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.5": readonly ["low", "medium", "high", "xhigh", "max"];
+  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-6.1-sol": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "gpt-6-astra": readonly ["low", "medium", "high", "xhigh", "max"];
+  readonly "gpt-6-sol": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  readonly "gpt-6-luna": readonly ["none", "low", "medium", "high", "xhigh", "max"];
+  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-5": readonly ["low", "medium", "high", "xhigh", "max"];
+  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-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 "mistral-large-4": readonly ["none", "high"];
+  readonly "mistral-large-latest": null;
+  readonly "mistral-medium-latest": readonly ["none", "high"];
+  readonly "mistral-small-latest": readonly ["none", "high"];
+};
+/**
+ * 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.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-6.1-sol": "medium";
+  readonly "openai/gpt-6-astra": "medium";
+  readonly "openai/gpt-6-sol": "medium";
+  readonly "openai/gpt-6-luna": "medium";
+  readonly "openai/gpt-5.6-sol": "medium";
+  readonly "openai/gpt-5.6-terra": "medium";
+  readonly "openai/gpt-5.6-luna": "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.5": "high";
+  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-6.1-sol": null;
+  readonly "gpt-6-astra": null;
+  readonly "gpt-6-sol": null;
+  readonly "gpt-6-luna": null;
+  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-5": null;
+  readonly "claude-sonnet-5": null;
+  readonly "claude-fable-5-1": null;
+  readonly "claude-fable-5": null;
+  readonly "claude-opus-5-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 "mistral-large-4": null;
+  readonly "mistral-large-latest": null;
+  readonly "mistral-medium-latest": null;
+  readonly "mistral-small-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.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-6.1-sol": "omit";
+  readonly "openai/gpt-6-astra": "omit";
+  readonly "openai/gpt-6-sol": "omit";
+  readonly "openai/gpt-6-luna": "omit";
+  readonly "openai/gpt-5.6-sol": "omit";
+  readonly "openai/gpt-5.6-terra": "omit";
+  readonly "openai/gpt-5.6-luna": "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.5": "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-6.1-sol": "omit";
+  readonly "gpt-6-astra": "omit";
+  readonly "gpt-6-sol": "omit";
+  readonly "gpt-6-luna": "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-5": "omit";
+  readonly "claude-sonnet-5": "omit";
+  readonly "claude-fable-5-1": "omit";
+  readonly "claude-fable-5": "omit";
+  readonly "claude-opus-5-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 "mistral-large-4": "emit";
+  readonly "mistral-large-latest": "emit";
+  readonly "mistral-medium-latest": "emit";
+  readonly "mistral-small-latest": "emit";
+};
+/**
+ * The most output tokens one response of each offered model may carry
+ * (models.dev `limit.output`). Consumers must go through
+ * `getOutputTokenLimit`.
+ */
+declare const MODEL_OUTPUT_TOKEN_LIMITS: {
+  readonly "gemini-3.8-flash": 65536;
+  readonly "gemini-3.7-flash": 65536;
+  readonly "gemini-3.6-flash": 65536;
+  readonly "gemini-3.5-flash-lite": 65536;
+  readonly "gemini-3.1-pro-preview": 65536;
+  readonly "gemini-3.5-flash": 65536;
+  readonly "gemini-3.1-flash-lite": 65536;
+  readonly "openai/gpt-6.1-sol": 128000;
+  readonly "openai/gpt-6-astra": 128000;
+  readonly "openai/gpt-6-sol": 128000;
+  readonly "openai/gpt-6-luna": 128000;
+  readonly "openai/gpt-5.6-sol": 128000;
+  readonly "openai/gpt-5.6-terra": 128000;
+  readonly "openai/gpt-5.6-luna": 128000;
+  readonly "google/gemini-3.8-flash": 65536;
+  readonly "google/gemini-3.7-flash": 65536;
+  readonly "google/gemini-3.6-flash": 65536;
+  readonly "google/gemini-3.5-flash-lite": 65536;
+  readonly "google/gemini-3.1-pro-preview": 65536;
+  readonly "google/gemini-3.5-flash": 65536;
+  readonly "google/gemini-3.1-flash-lite": 65536;
+  readonly "anthropic/claude-sonnet-5.5": 128000;
+  readonly "anthropic/claude-sonnet-5": 128000;
+  readonly "anthropic/claude-opus-5": 128000;
+  readonly "anthropic/claude-opus-4.8": 128000;
+  readonly "anthropic/claude-sonnet-4.6": 128000;
+  readonly "openai/gpt-5.5": 128000;
+  readonly "openai/gpt-5.4-mini": 128000;
+  readonly "gpt-6.1-sol": 128000;
+  readonly "gpt-6-astra": 128000;
+  readonly "gpt-6-sol": 128000;
+  readonly "gpt-6-luna": 128000;
+  readonly "gpt-5.6": 128000;
+  readonly "gpt-5.6-terra": 128000;
+  readonly "gpt-5.6-luna": 128000;
+  readonly "gpt-5.5": 128000;
+  readonly "gpt-5.4": 128000;
+  readonly "gpt-5.4-mini": 128000;
+  readonly "gpt-5.4-nano": 128000;
+  readonly "gpt-5.2": 128000;
+  readonly "claude-sonnet-5-5": 128000;
+  readonly "claude-sonnet-5": 128000;
+  readonly "claude-fable-5-1": 128000;
+  readonly "claude-fable-5": 128000;
+  readonly "claude-opus-5-5": 128000;
+  readonly "claude-opus-5": 128000;
+  readonly "claude-opus-4-8": 128000;
+  readonly "claude-opus-4-7": 128000;
+  readonly "claude-sonnet-4-6": 128000;
+  readonly "claude-opus-4-6": 128000;
+  readonly "claude-haiku-4-5-20251001": 64000;
+  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": 64000;
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": 64000;
+  readonly "us.amazon.nova-pro-v1:0": 10000;
+  readonly "us.amazon.nova-lite-v1:0": 10000;
+  readonly "us.amazon.nova-micro-v1:0": 10000;
+  readonly "openai.gpt-oss-120b-1:0": 128000;
+  readonly "openai.gpt-oss-20b-1:0": 128000;
+  readonly "mistral-large-4": 262144;
+  readonly "mistral-large-latest": 262144;
+  readonly "mistral-medium-latest": 262144;
+  readonly "mistral-small-latest": 256000;
+};
+//#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 IMAGE_INPUT_CAPABILITIES: readonly ["supported", "unsupported", "unknown"];
+type ImageInputCapability = (typeof IMAGE_INPUT_CAPABILITIES)[number];
+declare const STREAMING_TOOL_USE_SUPPORTS: readonly ["supported", "unsupported"];
+type StreamingToolUseSupport = (typeof STREAMING_TOOL_USE_SUPPORTS)[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.8-flash";
+    readonly chat: "gemini-3.8-flash";
+    readonly reasoning: "gemini-3.8-flash";
+    readonly pdf: "gemini-3.8-flash";
+  };
+  readonly openrouter: {
+    readonly fast: "openai/gpt-6-luna";
+    readonly chat: "openai/gpt-6-sol";
+    readonly reasoning: "openai/gpt-6-sol";
+    readonly pdf: "openai/gpt-6-sol";
+  };
+  readonly openai: {
+    readonly fast: "gpt-6-luna";
+    readonly chat: "gpt-6-sol";
+    readonly reasoning: "gpt-6-sol";
+    readonly pdf: "gpt-6-sol";
+  };
+  readonly anthropic: {
+    readonly fast: "claude-opus-5-5";
+    readonly chat: "claude-opus-5-5";
+    readonly reasoning: "claude-opus-5-5";
+    readonly pdf: "claude-opus-5-5";
+  };
+  readonly bedrock: {
+    readonly fast: "us.anthropic.claude-sonnet-4-5-20250929-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: "mistral-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.6-luna";
+    readonly chat: "gpt-5.6-terra";
+    readonly reasoning: "gpt-5.6-terra";
+    readonly pdf: "gpt-5.6-terra";
+  };
+  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.8-flash";
+    readonly chat: "gemini-3.8-flash";
+    readonly reasoning: "gemini-3.8-flash";
+    readonly pdf: "gemini-3.8-flash";
+  };
+  readonly openrouter: {
+    readonly fast: "openai/gpt-6-luna";
+    readonly chat: "openai/gpt-6-sol";
+    readonly reasoning: "openai/gpt-6-sol";
+    readonly pdf: "openai/gpt-6-sol";
+  };
+  readonly openai: {
+    readonly fast: "gpt-6-luna";
+    readonly chat: "gpt-6-sol";
+    readonly reasoning: "gpt-6-sol";
+    readonly pdf: "gpt-6-sol";
+  };
+  readonly anthropic: {
+    readonly fast: "claude-opus-5-5";
+    readonly chat: "claude-opus-5-5";
+    readonly reasoning: "claude-opus-5-5";
+    readonly pdf: "claude-opus-5-5";
+  };
+  readonly bedrock: {
+    readonly fast: "us.anthropic.claude-sonnet-4-5-20250929-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: "mistral-medium-latest";
+    readonly pdf: "mistral-large-latest";
+  };
+};
+/**
+ * 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.
+ */
+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-5", "claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5-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-6.1-sol" | "gpt-6-astra" | "gpt-6-sol" | "gpt-6-luna" | "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-6.1-sol" | "openai/gpt-6-astra" | "openai/gpt-6-sol" | "openai/gpt-6-luna" | "openai/gpt-5.6-sol" | "openai/gpt-5.6-terra" | "openai/gpt-5.6-luna")[], "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.5", "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"];
+  readonly mistral: readonly ["mistral-large-4", "mistral-large-latest", "mistral-medium-latest", "mistral-small-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;
+  /**
+   * A newer model of the same line, preferably on the same route. A superseded
+   * model stays selectable but is never recommended.
+   */
+  supersededBy?: string;
+};
+/**
+ * The chat model picker's Recommended section: a reviewed, curated list of
+ * the latest generation per maker. Benchmarks inform ordering and hints but
+ * never pick these. Every route to a listed model qualifies; a listed model
+ * must not be superseded (model-lineage.test.ts).
+ */
+declare const RECOMMENDED_CHAT_MODELS: readonly ["claude-opus-5-5", "gpt-6.1-sol", "gpt-6-luna", "gemini-3.8-flash"];
+/**
+ * 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_DISPLAY_METADATA: {
+  readonly "gemini-3.8-flash": {
+    readonly displayName: "Gemini 3.8 Flash";
+    readonly iconProvider: "google";
+  };
+  readonly "gemini-3.7-flash": {
+    readonly displayName: "Gemini 3.7 Flash";
+    readonly iconProvider: "google";
+    readonly supersededBy: "gemini-3.8-flash";
+  };
+  readonly "gemini-3.6-flash": {
+    readonly displayName: "Gemini 3.6 Flash";
+    readonly iconProvider: "google";
+    readonly supersededBy: "gemini-3.8-flash";
+  };
+  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": {
+    readonly displayName: "Gemini 3.5 Flash";
+    readonly iconProvider: "google";
+    readonly supersededBy: "gemini-3.8-flash";
+  };
+  readonly "gemini-3.1-flash-lite": {
+    readonly displayName: "Gemini 3.1 Flash Lite";
+    readonly iconProvider: "google";
+    readonly supersededBy: "gemini-3.5-flash-lite";
+  };
+  readonly "claude-sonnet-5-5": {
+    readonly displayName: "Claude Sonnet 5.5";
+    readonly iconProvider: "anthropic";
+  };
+  readonly "claude-sonnet-5": {
+    readonly displayName: "Claude Sonnet 5";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-sonnet-5-5";
+  };
+  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 supersededBy: "claude-fable-5-1";
+  };
+  readonly "claude-opus-5-5": {
+    readonly displayName: "Claude Opus 5.5";
+    readonly iconProvider: "anthropic";
+  };
+  readonly "claude-opus-5": {
+    readonly displayName: "Claude Opus 5";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-opus-5-5";
+  };
+  readonly "claude-opus-4-8": {
+    readonly displayName: "Claude Opus 4.8";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-opus-5-5";
+  };
+  readonly "claude-opus-4-7": {
+    readonly displayName: "Claude Opus 4.7";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-opus-5-5";
+  };
+  readonly "claude-sonnet-4-6": {
+    readonly displayName: "Claude Sonnet 4.6";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-sonnet-5-5";
+  };
+  readonly "claude-opus-4-6": {
+    readonly displayName: "Claude Opus 4.6";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-opus-5-5";
+  };
+  readonly "claude-haiku-4-5-20251001": {
+    readonly displayName: "Claude Haiku 4.5";
+    readonly iconProvider: "anthropic";
+  };
+  readonly "gpt-6.1-sol": {
+    readonly displayName: "GPT-6.1 Sol";
+    readonly iconProvider: "openai";
+  };
+  readonly "gpt-6-astra": {
+    readonly displayName: "GPT-6 Astra";
+    readonly iconProvider: "openai";
+  };
+  readonly "gpt-6-sol": {
+    readonly displayName: "GPT-6 Sol";
+    readonly iconProvider: "openai";
+    readonly supersededBy: "gpt-6.1-sol";
+  };
+  readonly "gpt-6-luna": {
+    readonly displayName: "GPT-6 Luna";
+    readonly iconProvider: "openai";
+  };
+  readonly "gpt-5.6": {
+    readonly displayName: "GPT-5.6 Sol";
+    readonly iconProvider: "openai";
+    readonly supersededBy: "gpt-6.1-sol";
+  };
+  readonly "gpt-5.6-terra": {
+    readonly displayName: "GPT-5.6 Terra";
+    readonly iconProvider: "openai";
+  };
+  readonly "gpt-5.6-luna": {
+    readonly displayName: "GPT-5.6 Luna";
+    readonly iconProvider: "openai";
+    readonly supersededBy: "gpt-6-luna";
+  };
+  readonly "gpt-5.5": {
+    readonly displayName: "GPT-5.5";
+    readonly iconProvider: "openai";
+  };
+  readonly "gpt-5.4": {
+    readonly displayName: "GPT-5.4";
+    readonly iconProvider: "openai";
+    readonly supersededBy: "gpt-5.5";
+  };
+  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 supersededBy: "gpt-5.5";
+  };
+  readonly "openai/gpt-6.1-sol": {
+    readonly displayName: "GPT-6.1 Sol";
+    readonly iconProvider: "openai";
+  };
+  readonly "openai/gpt-6-astra": {
+    readonly displayName: "GPT-6 Astra";
+    readonly iconProvider: "openai";
+  };
+  readonly "openai/gpt-6-sol": {
+    readonly displayName: "GPT-6 Sol";
+    readonly iconProvider: "openai";
+    readonly supersededBy: "openai/gpt-6.1-sol";
+  };
+  readonly "openai/gpt-6-luna": {
+    readonly displayName: "GPT-6 Luna";
+    readonly iconProvider: "openai";
+  };
+  readonly "openai/gpt-5.6-sol": {
+    readonly displayName: "GPT-5.6 Sol";
+    readonly iconProvider: "openai";
+    readonly supersededBy: "openai/gpt-6.1-sol";
+  };
+  readonly "openai/gpt-5.6-luna": {
+    readonly displayName: "GPT-5.6 Luna";
+    readonly iconProvider: "openai";
+    readonly supersededBy: "openai/gpt-6-luna";
+  };
+  readonly "openai/gpt-5.6-terra": {
+    readonly displayName: "GPT-5.6 Terra";
+    readonly iconProvider: "openai";
+  };
+  readonly "google/gemini-3.8-flash": {
+    readonly displayName: "Gemini 3.8 Flash";
+    readonly iconProvider: "google";
+  };
+  readonly "google/gemini-3.7-flash": {
+    readonly displayName: "Gemini 3.7 Flash";
+    readonly iconProvider: "google";
+    readonly supersededBy: "google/gemini-3.8-flash";
+  };
+  readonly "google/gemini-3.6-flash": {
+    readonly displayName: "Gemini 3.6 Flash";
+    readonly iconProvider: "google";
+    readonly supersededBy: "google/gemini-3.8-flash";
+  };
+  readonly "google/gemini-3.5-flash-lite": {
+    readonly displayName: "Gemini 3.5 Flash Lite";
+    readonly iconProvider: "google";
+  };
+  readonly "google/gemini-3.1-pro-preview": {
+    readonly displayName: "Gemini 3.1 Pro Preview";
+    readonly iconProvider: "google";
+  };
+  readonly "google/gemini-3.5-flash": {
+    readonly displayName: "Gemini 3.5 Flash";
+    readonly iconProvider: "google";
+    readonly supersededBy: "google/gemini-3.8-flash";
+  };
+  readonly "google/gemini-3.1-flash-lite": {
+    readonly displayName: "Gemini 3.1 Flash Lite";
+    readonly iconProvider: "google";
+    readonly supersededBy: "google/gemini-3.5-flash-lite";
+  };
+  readonly "anthropic/claude-sonnet-5.5": {
+    readonly displayName: "Claude Sonnet 5.5";
+    readonly iconProvider: "anthropic";
+  };
+  readonly "anthropic/claude-sonnet-5": {
+    readonly displayName: "Claude Sonnet 5";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "anthropic/claude-sonnet-5.5";
+  };
+  readonly "anthropic/claude-opus-5": {
+    readonly displayName: "Claude Opus 5";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-opus-5-5";
+  };
+  readonly "anthropic/claude-opus-4.8": {
+    readonly displayName: "Claude Opus 4.8";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-opus-5-5";
+  };
+  readonly "anthropic/claude-sonnet-4.6": {
+    readonly displayName: "Claude Sonnet 4.6";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "anthropic/claude-sonnet-5.5";
+  };
+  readonly "openai/gpt-5.5": {
+    readonly displayName: "GPT-5.5";
+    readonly iconProvider: "openai";
+  };
+  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 displayName: "Claude Sonnet 4.5";
+    readonly iconProvider: "anthropic";
+    readonly supersededBy: "claude-sonnet-5-5";
+  };
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": {
+    readonly displayName: "Claude Haiku 4.5";
+    readonly iconProvider: "anthropic";
+  };
+  readonly "us.amazon.nova-pro-v1:0": {
+    readonly displayName: "Amazon Nova Pro";
+    readonly iconProvider: "bedrock";
+  };
+  readonly "us.amazon.nova-lite-v1:0": {
+    readonly displayName: "Amazon Nova Lite";
+    readonly iconProvider: "bedrock";
+  };
+  readonly "us.amazon.nova-micro-v1:0": {
+    readonly displayName: "Amazon Nova Micro";
+    readonly iconProvider: "bedrock";
+  };
+  readonly "openai.gpt-oss-120b-1:0": {
+    readonly displayName: "GPT OSS 120B";
+    readonly iconProvider: "openai";
+  };
+  readonly "openai.gpt-oss-20b-1:0": {
+    readonly displayName: "GPT OSS 20B";
+    readonly iconProvider: "openai";
+  };
+  readonly "mistral-large-4": {
+    readonly displayName: "Mistral Large 4";
+    readonly iconProvider: "mistral";
+  };
+  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";
+  };
+};
+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-6.1-sol", "openai/gpt-6-astra", "openai/gpt-6-sol", "openai/gpt-6-luna", "openai/gpt-5.6-sol", "openai/gpt-5.6-terra", "openai/gpt-5.6-luna", "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.5", "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-6.1-sol", "gpt-6-astra", "gpt-6-sol", "gpt-6-luna", "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-5", "claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5-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 [];
+};
+/** Unoffered IDs have no entry; offered IDs explicitly include unknown. */
+declare const getModelImageInputCapability: ({ provider, modelId }: {
+  provider: BYOKProvider;
+  modelId: string;
+}) => ImageInputCapability | undefined;
+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"];
+  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-6.1-sol", "openai/gpt-6-astra", "openai/gpt-6-sol", "openai/gpt-6-luna", "openai/gpt-5.6-sol", "openai/gpt-5.6-terra", "openai/gpt-5.6-luna", "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.5", "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-6.1-sol", "gpt-6-astra", "gpt-6-sol", "gpt-6-luna", "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-5", "claude-sonnet-5", "claude-fable-5-1", "claude-fable-5", "claude-opus-5-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-5", "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", "claude-opus-5-5"];
+/**
+ * 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.8-flash";
+  readonly openrouter: "openai/gpt-6-luna";
+  readonly openai: "gpt-6-luna";
+  readonly anthropic: "claude-opus-5-5";
+  readonly bedrock: "us.anthropic.claude-sonnet-4-5-20250929-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-5.5": "claude-sonnet-5-5";
+  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;
+/**
+ * The most output tokens one response of `modelId` may carry, from the
+ * catalog. `undefined` for an id the catalog does not list (a deployment
+ * override, a dev model): the catalog knows nothing about it, so callers leave
+ * the allowance to the provider rather than guess one. Callers must never
+ * index `MODEL_OUTPUT_TOKEN_LIMITS` directly with a runtime string.
+ */
+declare const getOutputTokenLimit: (modelId: string) => number | undefined;
+/**
+ * Whether a model accepts tool use on a streaming request.
+ *
+ * Every tool-carrying request stella sends is a stream, and structured
+ * output is a forced tool call, so `"unsupported"` withdraws both: the
+ * provider answers such a request with a fatal stream error rather than a
+ * degraded result. models.dev does not publish this, so the map is
+ * hand-declared here rather than in the generated `capabilities.gen.ts`,
+ * and it is total over the offered catalog: a new model forces a decision.
+ *
+ * Consumers must go through `supportsStreamingToolUse`.
+ */
+declare const MODEL_STREAMING_TOOL_USE: {
+  readonly "gemini-3.8-flash": "supported";
+  readonly "gemini-3.7-flash": "supported";
+  readonly "gemini-3.6-flash": "supported";
+  readonly "gemini-3.5-flash-lite": "supported";
+  readonly "gemini-3.1-pro-preview": "supported";
+  readonly "gemini-3.5-flash": "supported";
+  readonly "gemini-3.1-flash-lite": "supported";
+  readonly "openai/gpt-6.1-sol": "supported";
+  readonly "openai/gpt-6-astra": "supported";
+  readonly "openai/gpt-6-sol": "supported";
+  readonly "openai/gpt-6-luna": "supported";
+  readonly "openai/gpt-5.6-sol": "supported";
+  readonly "openai/gpt-5.6-terra": "supported";
+  readonly "openai/gpt-5.6-luna": "supported";
+  readonly "google/gemini-3.8-flash": "supported";
+  readonly "google/gemini-3.7-flash": "supported";
+  readonly "google/gemini-3.6-flash": "supported";
+  readonly "google/gemini-3.5-flash-lite": "supported";
+  readonly "google/gemini-3.1-pro-preview": "supported";
+  readonly "google/gemini-3.5-flash": "supported";
+  readonly "google/gemini-3.1-flash-lite": "supported";
+  readonly "anthropic/claude-sonnet-5.5": "supported";
+  readonly "anthropic/claude-sonnet-5": "supported";
+  readonly "anthropic/claude-opus-5": "supported";
+  readonly "anthropic/claude-opus-4.8": "supported";
+  readonly "anthropic/claude-sonnet-4.6": "supported";
+  readonly "openai/gpt-5.5": "supported";
+  readonly "openai/gpt-5.4-mini": "supported";
+  readonly "gpt-6.1-sol": "supported";
+  readonly "gpt-6-astra": "supported";
+  readonly "gpt-6-sol": "supported";
+  readonly "gpt-6-luna": "supported";
+  readonly "gpt-5.6": "supported";
+  readonly "gpt-5.6-terra": "supported";
+  readonly "gpt-5.6-luna": "supported";
+  readonly "gpt-5.5": "supported";
+  readonly "gpt-5.4": "supported";
+  readonly "gpt-5.4-mini": "supported";
+  readonly "gpt-5.4-nano": "supported";
+  readonly "gpt-5.2": "supported";
+  readonly "claude-sonnet-5-5": "supported";
+  readonly "claude-sonnet-5": "supported";
+  readonly "claude-fable-5-1": "supported";
+  readonly "claude-fable-5": "supported";
+  readonly "claude-opus-5-5": "supported";
+  readonly "claude-opus-5": "supported";
+  readonly "claude-opus-4-8": "supported";
+  readonly "claude-opus-4-7": "supported";
+  readonly "claude-sonnet-4-6": "supported";
+  readonly "claude-opus-4-6": "supported";
+  readonly "claude-haiku-4-5-20251001": "supported";
+  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": "supported";
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": "supported";
+  readonly "us.amazon.nova-pro-v1:0": "supported";
+  readonly "us.amazon.nova-lite-v1:0": "supported";
+  readonly "us.amazon.nova-micro-v1:0": "supported";
+  readonly "openai.gpt-oss-120b-1:0": "supported";
+  readonly "openai.gpt-oss-20b-1:0": "supported";
+  readonly "mistral-large-4": "supported";
+  readonly "mistral-large-latest": "supported";
+  readonly "mistral-medium-latest": "supported";
+  readonly "mistral-small-latest": "supported";
+};
+/**
+ * Whether stella may send tools (or a structured-output schema) to this
+ * model on a streaming request. Unlisted ids resolve to `true`: custom
+ * deployments and env overrides are overwhelmingly tool-capable, and
+ * withdrawing tools from an uncatalogued model would silently strip the
+ * agent loop rather than fail where it can be seen.
+ */
+declare const supportsStreamingToolUse: (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.
+ *
+ * Keys are the canonical model IDs stella resolves for the provider
+ * adapters (the same forms used in `MODEL_RATES`, `BYOK_MODEL_OPTIONS`,
+ * and `DEFAULT_MODELS`, including OpenRouter provider-prefixed slugs and
+ * AWS Bedrock IDs). Values are the providers' publicly documented input
+ * windows; where a provider offers a larger beta window we intentionally
+ * take the conservative default (e.g. Claude's standard 200K rather than
+ * the 1M beta) so context budgeting never overpromises.
+ *
+ * Consumers must go through `getContextWindowTokens`, which falls back to
+ * `DEFAULT_CONTEXT_WINDOW_TOKENS` for any unlisted ID. Unlike
+ * `MODEL_RATES`, the nightly `model-catalog-upstream` check does not
+ * validate this map, so an unknown model degrades to the conservative
+ * default rather than failing CI.
+ */
+declare const CONTEXT_WINDOW_TOKENS: {
+  readonly "gemini-2.5-flash": 1048576;
+  readonly "gemini-2.5-pro": 1048576;
+  readonly "gemini-3.1-flash-lite": 1048576;
+  readonly "gemini-3.5-flash": 1048576;
+  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;
+  readonly "gpt-5.2": 400000;
+  readonly "gpt-5.4-nano": 400000;
+  readonly "gpt-5.4-mini": 400000;
+  readonly "gpt-5.4": 400000;
+  readonly "gpt-5.5": 400000;
+  readonly "gpt-6.1-sol": 922000;
+  readonly "gpt-6-astra": 922000;
+  readonly "gpt-6-sol": 922000;
+  readonly "gpt-6-luna": 922000;
+  readonly "gpt-5.6": 922000;
+  readonly "gpt-5.6-luna": 922000;
+  readonly "gpt-5.6-terra": 922000;
+  readonly "claude-haiku-4-5-20251001": 200000;
+  readonly "claude-sonnet-4-6": 200000;
+  readonly "claude-sonnet-5": 1000000;
+  readonly "claude-sonnet-5-5": 1000000;
+  readonly "claude-opus-4-6": 200000;
+  readonly "claude-opus-4-7": 200000;
+  readonly "claude-opus-4-8": 200000;
+  readonly "claude-opus-5": 1000000;
+  readonly "claude-opus-5-5": 1000000;
+  readonly "claude-fable-5": 200000;
+  readonly "claude-fable-5-1": 1000000;
+  readonly "mistral-small-latest": 128000;
+  readonly "mistral-large-4": 524288;
+  readonly "mistral-large-latest": 128000;
+  readonly "mistral-medium-latest": 128000;
+  readonly "mistral-medium-3-5": 128000;
+  readonly "magistral-small-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;
+  readonly "google/gemini-3.1-pro-preview": 1048576;
+  readonly "google/gemini-3.5-flash": 1048576;
+  readonly "google/gemini-3.1-flash-lite": 1048576;
+  readonly "anthropic/claude-sonnet-5.5": 1000000;
+  readonly "anthropic/claude-sonnet-5": 1000000;
+  readonly "anthropic/claude-opus-5": 1000000;
+  readonly "anthropic/claude-opus-4.8": 200000;
+  readonly "anthropic/claude-sonnet-4.6": 200000;
+  readonly "openai/gpt-6.1-sol": 922000;
+  readonly "openai/gpt-6-astra": 922000;
+  readonly "openai/gpt-6-sol": 922000;
+  readonly "openai/gpt-6-luna": 922000;
+  readonly "openai/gpt-5.6-sol": 922000;
+  readonly "openai/gpt-5.6-luna": 922000;
+  readonly "openai/gpt-5.6-terra": 922000;
+  readonly "openai/gpt-5.5": 400000;
+  readonly "openai/gpt-5.4-mini": 400000;
+  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": 200000;
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": 200000;
+  readonly "us.amazon.nova-pro-v1:0": 300000;
+  readonly "us.amazon.nova-lite-v1:0": 300000;
+  readonly "us.amazon.nova-micro-v1:0": 128000;
+  readonly "openai.gpt-oss-120b-1:0": 128000;
+  readonly "openai.gpt-oss-20b-1:0": 128000;
+  readonly "us.deepseek.r1-v1:0": 128000;
+};
+/**
+ * Conservative window assumed for any model ID absent from
+ * `CONTEXT_WINDOW_TOKENS` (custom deployments, OpenAI-compatible
+ * endpoints, brand-new IDs not yet catalogued).
+ */
+declare const DEFAULT_CONTEXT_WINDOW_TOKENS = 128000;
+/**
+ * Documented input context window for a model ID, or the conservative
+ * default for unlisted IDs. Callers must never index
+ * `CONTEXT_WINDOW_TOKENS` directly.
+ */
+declare const getContextWindowTokens: (modelId: string) => number;
+//#endregion
+export { MODEL_IMAGE_INPUT_CAPABILITIES as $, ResolvedReasoningEffort as A, getModelImageInputCapability as B, ModelDisplayMetadata as C, RECOMMENDED_CHAT_MODELS as D, REASONING_EFFORTS as E, TanStackAIProvider as F, isBYOKProviderRoleSupported as G, getModelReasoningEfforts as H, TemperaturePolicy as I, resolveReasoningEffort as J, isChatPdfAttachmentModelSupported as K, getContextWindowTokens as L, StreamingToolUseSupport as M, TANSTACK_AI_PROVIDERS as N, ReasoningEffort as O, TEMPERATURE_POLICIES as P, MODEL_DEFAULT_REASONING_EFFORTS as Q, getModelDefaultReasoningEffort as R, MODEL_STREAMING_TOOL_USE as S, OfferedBYOKModelId as T, getOutputTokenLimit as U, getModelRate as V, isBYOKModelRoleSupported as W, shouldEmitTemperature as X, resolveWorkingBYOKModelForRole as Y, supportsStreamingToolUse as Z, ImageInputCapability as _, ModelRateAmounts as _t, BYOKProvider as a, CAPABILITY_OVERRIDES as at, MODEL_DISPLAY_METADATA as b, BYOK_MODEL_OPTIONS as c, ImageInputOverride as ct, DEFAULT_CONTEXT_WINDOW_TOKENS as d, MODELS_DEV_RATE_SOURCE_ALIASES as dt, MODEL_OUTPUT_TOKEN_LIMITS as et, DEFAULT_MODELS as f, ModelsDevRateProvider as ft, IMAGE_INPUT_CAPABILITIES as g, ModelRate as gt, FirstPartyModelProvider as h, MODEL_RATE_UNITS_PER_USD as ht, BYOKModelIdByProvider as i, DocumentInputOverride as it, STREAMING_TOOL_USE_SUPPORTS as j, ResolveReasoningEffortOptions as k, CHAT_PDF_ATTACHMENT_MODEL_OPTIONS as l, ImageInputOverrides as lt, FIRST_PARTY_MODEL_PROVIDERS as m, MODEL_RATES as mt, AI_PROVIDERS as n, MODEL_TEMPERATURE_POLICIES as nt, BYOK_DEFAULT_MODELS as o, CapabilityOverride as ot, FALLBACK_CHAT_MODEL_BY_PROVIDER as p, RETAINED_MODELS_DEV_RATE_ENTRIES as pt, normalizeModelCatalogId as q, ANTHROPIC_ADAPTIVE_THINKING_MODELS as r, DOCUMENT_INPUT_OVERRIDES as rt, BYOK_DOCUMENT_INPUT_MODEL_OPTIONS as s, IMAGE_INPUT_OVERRIDES as st, AIProvider as t, MODEL_REASONING_EFFORTS as tt, CONTEXT_WINDOW_TOKENS as u, MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER as ut, MODEL_CATALOG_ID_ALIASES as v, getStandardModelRate as vt, ModelRole as w, MODEL_ROLES as x, MODEL_CATALOG_PROVIDER_KIND as y, resolveModelRate as yt, getModelDisplayMetadata as z };