@stll/ai-catalog 0.1.5 → 0.1.7

package/dist/index.js

@@ -6,6 +6,7 @@ import * as v from "valibot";
 */
 const MODEL_DOCUMENT_INPUT_OPTIONS = {
 	google: [
+		"gemini-3.8-flash",
 		"gemini-3.7-flash",
 		"gemini-3.6-flash",
 		"gemini-3.5-flash-lite",
@@ -16,6 +17,7 @@ const MODEL_DOCUMENT_INPUT_OPTIONS = {
 	openrouter: [
 		"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",
@@ -65,6 +67,11 @@ const MODEL_DOCUMENT_INPUT_OPTIONS = {
 * through `resolveReasoningEffort`.
 */
 const MODEL_REASONING_EFFORTS = {
+	"gemini-3.8-flash": [
+		"low",
+		"medium",
+		"high"
+	],
 	"gemini-3.7-flash": [
 		"low",
 		"medium",
@@ -115,6 +122,11 @@ const MODEL_REASONING_EFFORTS = {
 		"xhigh",
 		"max"
 	],
+	"google/gemini-3.8-flash": [
+		"low",
+		"medium",
+		"high"
+	],
 	"google/gemini-3.7-flash": [
 		"low",
 		"medium",
@@ -339,6 +351,7 @@ const MODEL_REASONING_EFFORTS = {
 * a truthful named default, so clients must retain a separate Default choice.
 */
 const MODEL_DEFAULT_REASONING_EFFORTS = {
+	"gemini-3.8-flash": null,
 	"gemini-3.7-flash": null,
 	"gemini-3.6-flash": null,
 	"gemini-3.5-flash-lite": null,
@@ -347,6 +360,7 @@ const MODEL_DEFAULT_REASONING_EFFORTS = {
 	"gemini-3.1-flash-lite": null,
 	"openai/gpt-5.6-luna": "medium",
 	"openai/gpt-5.6-terra": "medium",
+	"google/gemini-3.8-flash": "medium",
 	"google/gemini-3.7-flash": "medium",
 	"google/gemini-3.6-flash": "medium",
 	"google/gemini-3.5-flash-lite": "minimal",
@@ -397,6 +411,7 @@ const MODEL_DEFAULT_REASONING_EFFORTS = {
 * parameters. Consumers must go through `shouldEmitTemperature`.
 */
 const MODEL_TEMPERATURE_POLICIES = {
+	"gemini-3.8-flash": "omit",
 	"gemini-3.7-flash": "omit",
 	"gemini-3.6-flash": "omit",
 	"gemini-3.5-flash-lite": "omit",
@@ -405,6 +420,7 @@ const MODEL_TEMPERATURE_POLICIES = {
 	"gemini-3.1-flash-lite": "emit",
 	"openai/gpt-5.6-luna": "omit",
 	"openai/gpt-5.6-terra": "omit",
+	"google/gemini-3.8-flash": "omit",
 	"google/gemini-3.7-flash": "omit",
 	"google/gemini-3.6-flash": "omit",
 	"google/gemini-3.5-flash-lite": "omit",
@@ -450,981 +466,1076 @@ const MODEL_TEMPERATURE_POLICIES = {
 	"pixtral-large-latest": "emit"
 };
 //#endregion
-//#region src/capabilities-overrides.ts
-const CAPABILITY_OVERRIDES = {
-	"us.amazon.nova-pro-v1:0": {
-		documentInput: true,
-		documentInputReason: "2026-08-20: AWS documents PDF input for Nova Pro through Bedrock Converse",
-		reasoningEfforts: null,
-		temperatureSupported: true,
-		reason: "2026-07-20: absent from the models.dev amazon-bedrock catalog; Bedrock Converse accepts temperature and Nova has no reasoning dial"
+//#region src/model-rates.gen.ts
+const MODEL_RATES = {
+	"gemini-3.8-flash": {
+		kind: "flat",
+		inputPerMTok: 75e3,
+		outputPerMTok: 375e3,
+		cachedInputPerMTok: 7500
 	},
-	"us.amazon.nova-lite-v1:0": {
-		documentInput: true,
-		documentInputReason: "2026-08-20: AWS documents PDF input for Nova Lite through Bedrock Converse",
-		reasoningEfforts: null,
-		temperatureSupported: true,
-		reason: "2026-07-20: absent from the models.dev amazon-bedrock catalog; Bedrock Converse accepts temperature and Nova has no reasoning dial"
+	"gemini-3.7-flash": {
+		kind: "flat",
+		inputPerMTok: 75e3,
+		outputPerMTok: 375e3,
+		cachedInputPerMTok: 7500
 	},
-	"us.amazon.nova-micro-v1:0": {
-		documentInput: false,
-		documentInputReason: "2026-08-20: AWS documents Nova Micro as text-only",
-		reasoningEfforts: null,
-		temperatureSupported: true,
-		reason: "2026-07-20: absent from the models.dev amazon-bedrock catalog; Bedrock Converse accepts temperature and Nova has no reasoning dial"
-	}
-};
-//#endregion
-//#region src/document-input-overrides.ts
-/**
-* 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.
-*/
-const DOCUMENT_INPUT_OVERRIDES = {
-	"gpt-5.4-mini": {
-		supported: true,
-		reason: "2026-08-20: OpenAI Responses accepts input_file PDF content for this vision-capable model; models.dev currently omits the pdf modality"
+	"gemini-3.6-flash": {
+		kind: "flat",
+		inputPerMTok: 75e3,
+		outputPerMTok: 375e3,
+		cachedInputPerMTok: 7500
 	},
-	"gpt-5.4-nano": {
-		supported: true,
-		reason: "2026-08-20: OpenAI Responses accepts input_file PDF content for this vision-capable model; models.dev currently omits the pdf modality"
+	"gemini-3.5-flash-lite": {
+		kind: "flat",
+		inputPerMTok: 3e4,
+		outputPerMTok: 25e4,
+		cachedInputPerMTok: 3e3
 	},
-	"gpt-5.2": {
-		supported: true,
-		reason: "2026-08-20: OpenAI Responses accepts input_file PDF content for this vision-capable model; models.dev currently omits the pdf modality"
-	}
-};
-//#endregion
-//#region src/index.ts
-/**
-* Canonical AI provider and model catalog.
-*
-* Single source of truth for every provider/model identifier stella
-* offers. Imported by the API runtime
-* (`apps/api/src/lib/tanstack-ai-models.ts`)
-* and the BYOK settings UI (`apps/web`), so the picker can never offer
-* a model the backend rejects, and vice versa.
-*
-* Pure data: no provider SDKs, no env access, no side effects. This is
-* deliberate so scripts (the nightly upstream-validation check) and
-* both apps can import it cheaply. Keep it that way. The only runtime
-* dependency is valibot, used solely to construct branded types the
-* same way the rest of the repo does.
-*
-* Model IDs go stale when providers rename or retire models. The
-* nightly `model-catalog-upstream` check
-* (`packages/scripts/src/model-catalog-upstream.ts`) validates every
-* ID here against live provider/aggregator listings so a retired model
-* fails CI instead of 400-ing a user at runtime.
-*/
-/**
-* 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
-*/
-const MODEL_ROLES = [
-	"fast",
-	"chat",
-	"reasoning",
-	"pdf"
-];
-const TEMPERATURE_POLICIES = ["emit", "omit"];
-const AI_PROVIDERS = [
-	"google",
-	"openrouter",
-	"openai",
-	"azure_foundry",
-	"anthropic",
-	"bedrock",
-	"mistral",
-	"openai_compatible",
-	"huggingface"
-];
-const TANSTACK_AI_PROVIDERS = [
-	"google",
-	"openrouter",
-	"openai",
-	"anthropic",
-	"bedrock",
-	"mistral"
-];
-const MODEL_CATALOG_PROVIDER_KIND = {
-	google: "first-party",
-	openrouter: "aggregator",
-	openai: "first-party",
-	anthropic: "first-party",
-	bedrock: "platform",
-	mistral: "first-party"
-};
-/**
-* 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.
-*/
-const FIRST_PARTY_MODEL_PROVIDERS = [
-	"google",
-	"openai",
-	"anthropic",
-	"mistral"
-];
-/**
-* 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.
-*/
-const BYOK_DEFAULT_MODELS = {
-	google: {
-		fast: "gemini-3.7-flash",
-		chat: "gemini-3.7-flash",
-		reasoning: "gemini-3.7-flash",
-		pdf: "gemini-3.7-flash"
+	"gemini-3.1-pro-preview": {
+		kind: "input-token-tiered",
+		inputTokenThreshold: 2e5,
+		standard: {
+			inputPerMTok: 2e5,
+			outputPerMTok: 12e5,
+			cachedInputPerMTok: 2e4
+		},
+		aboveThreshold: {
+			inputPerMTok: 4e5,
+			outputPerMTok: 18e5,
+			cachedInputPerMTok: 4e4
+		}
 	},
-	openrouter: {
-		fast: "openai/gpt-5.6-luna",
-		chat: "openai/gpt-5.6-terra",
-		reasoning: "openai/gpt-5.6-terra",
-		pdf: "openai/gpt-5.6-terra"
+	"gemini-3.5-flash": {
+		kind: "flat",
+		inputPerMTok: 15e4,
+		outputPerMTok: 9e5,
+		cachedInputPerMTok: 15e3
 	},
-	openai: {
-		fast: "gpt-5.4-nano",
-		chat: "gpt-5.4-mini",
-		reasoning: "gpt-5.4",
-		pdf: "gpt-5.4"
+	"gemini-3.1-flash-lite": {
+		kind: "flat",
+		inputPerMTok: 25e3,
+		outputPerMTok: 15e4,
+		cachedInputPerMTok: 2500
 	},
-	anthropic: {
-		fast: "claude-opus-5",
-		chat: "claude-opus-5",
-		reasoning: "claude-opus-5",
-		pdf: "claude-opus-5"
+	"gpt-5.6": {
+		kind: "input-token-tiered",
+		inputTokenThreshold: 272e3,
+		standard: {
+			inputPerMTok: 4e5,
+			outputPerMTok: 2e6,
+			cachedInputPerMTok: 4e4,
+			cachedWriteInputPerMTok: 5e5
+		},
+		aboveThreshold: {
+			inputPerMTok: 8e5,
+			outputPerMTok: 3e6,
+			cachedInputPerMTok: 8e4,
+			cachedWriteInputPerMTok: 1e6
+		}
 	},
-	bedrock: {
-		fast: "us.amazon.nova-micro-v1:0",
-		chat: "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
-		reasoning: "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
-		pdf: "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+	"gpt-5.6-terra": {
+		kind: "input-token-tiered",
+		inputTokenThreshold: 272e3,
+		standard: {
+			inputPerMTok: 2e5,
+			outputPerMTok: 12e5,
+			cachedInputPerMTok: 2e4,
+			cachedWriteInputPerMTok: 25e4
+		},
+		aboveThreshold: {
+			inputPerMTok: 4e5,
+			outputPerMTok: 18e5,
+			cachedInputPerMTok: 4e4,
+			cachedWriteInputPerMTok: 5e5
+		}
 	},
-	mistral: {
-		fast: "mistral-small-latest",
-		chat: "mistral-medium-latest",
-		reasoning: "magistral-medium-latest",
-		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).
-*/
-const DEFAULT_MODELS = {
-	...BYOK_DEFAULT_MODELS,
-	azure_foundry: {
-		fast: "gpt-5.4-nano",
-		chat: "gpt-5.4-mini",
-		reasoning: "gpt-5.4",
-		pdf: "gpt-5.4"
+	"gpt-5.6-luna": {
+		kind: "input-token-tiered",
+		inputTokenThreshold: 272e3,
+		standard: {
+			inputPerMTok: 2e4,
+			outputPerMTok: 12e4,
+			cachedInputPerMTok: 2e3,
+			cachedWriteInputPerMTok: 25e3
+		},
+		aboveThreshold: {
+			inputPerMTok: 4e4,
+			outputPerMTok: 18e4,
+			cachedInputPerMTok: 4e3,
+			cachedWriteInputPerMTok: 5e4
+		}
 	},
-	openai_compatible: {
-		fast: "default",
-		chat: "default",
-		reasoning: "default",
-		pdf: "default"
-	},
-	huggingface: {
-		fast: "speakleash/Bielik-1.5B-v3.0-Instruct",
-		chat: "speakleash/Bielik-11B-v2.3-Instruct",
-		reasoning: "speakleash/Bielik-11B-v2.3-Instruct",
-		pdf: "speakleash/Bielik-11B-v2.3-Instruct"
-	}
-};
-/**
-* 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.
-*/
-const BYOK_MODEL_OPTIONS = {
-	google: [
-		"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"
-	],
-	anthropic: [
-		"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"
-	],
-	openai: [
-		"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"
-	],
-	openrouter: [
-		"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"
-	],
-	bedrock: [
-		"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"
-	],
-	mistral: [
-		"mistral-large-latest",
-		"mistral-medium-latest",
-		"mistral-small-latest",
-		"magistral-medium-latest",
-		"magistral-small",
-		"pixtral-large-latest"
-	]
-};
-/**
-* 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.
-*/
-const MODEL_DISPLAY_METADATA = {
-	"gemini-3.7-flash": {
-		displayName: "Gemini 3.7 Flash",
-		iconProvider: "google"
-	},
-	"gemini-3.6-flash": {
-		displayName: "Gemini 3.6 Flash",
-		iconProvider: "google"
+	"gpt-5.5": {
+		kind: "input-token-tiered",
+		inputTokenThreshold: 272e3,
+		standard: {
+			inputPerMTok: 5e5,
+			outputPerMTok: 3e6,
+			cachedInputPerMTok: 5e4
+		},
+		aboveThreshold: {
+			inputPerMTok: 1e6,
+			outputPerMTok: 45e5,
+			cachedInputPerMTok: 1e5
+		}
 	},
-	"gemini-3.5-flash-lite": {
-		displayName: "Gemini 3.5 Flash Lite",
-		iconProvider: "google"
+	"gpt-5.4": {
+		kind: "input-token-tiered",
+		inputTokenThreshold: 272e3,
+		standard: {
+			inputPerMTok: 25e4,
+			outputPerMTok: 15e5,
+			cachedInputPerMTok: 25e3
+		},
+		aboveThreshold: {
+			inputPerMTok: 5e5,
+			outputPerMTok: 225e4,
+			cachedInputPerMTok: 5e4
+		}
 	},
-	"gemini-3.1-pro-preview": {
-		displayName: "Gemini 3.1 Pro Preview",
-		iconProvider: "google"
+	"gpt-5.4-mini": {
+		kind: "flat",
+		inputPerMTok: 75e3,
+		outputPerMTok: 45e4,
+		cachedInputPerMTok: 7500
 	},
-	"gemini-3.5-flash": {
-		displayName: "Gemini 3.5 Flash",
-		iconProvider: "google"
+	"gpt-5.4-nano": {
+		kind: "flat",
+		inputPerMTok: 2e4,
+		outputPerMTok: 125e3,
+		cachedInputPerMTok: 2e3
 	},
-	"gemini-3.1-flash-lite": {
-		displayName: "Gemini 3.1 Flash Lite",
-		iconProvider: "google"
+	"gpt-5.2": {
+		kind: "flat",
+		inputPerMTok: 175e3,
+		outputPerMTok: 14e5,
+		cachedInputPerMTok: 17500
 	},
 	"claude-sonnet-5": {
-		displayName: "Claude Sonnet 5",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 2e5,
+		outputPerMTok: 1e6,
+		cachedInputPerMTok: 2e4,
+		cachedWriteInputPerMTok: 25e4
 	},
 	"claude-fable-5-1": {
-		displayName: "Claude Fable 5.1",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 1e6,
+		outputPerMTok: 5e6,
+		cachedInputPerMTok: 25e3,
+		cachedWriteInputPerMTok: 125e4
 	},
 	"claude-fable-5": {
-		displayName: "Claude Fable 5",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 1e6,
+		outputPerMTok: 5e6,
+		cachedInputPerMTok: 1e5,
+		cachedWriteInputPerMTok: 125e4
 	},
 	"claude-opus-5": {
-		displayName: "Claude Opus 5",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 5e5,
+		outputPerMTok: 25e5,
+		cachedInputPerMTok: 5e4,
+		cachedWriteInputPerMTok: 625e3
 	},
 	"claude-opus-4-8": {
-		displayName: "Claude Opus 4.8",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 5e5,
+		outputPerMTok: 25e5,
+		cachedInputPerMTok: 5e4,
+		cachedWriteInputPerMTok: 625e3
 	},
 	"claude-opus-4-7": {
-		displayName: "Claude Opus 4.7",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 5e5,
+		outputPerMTok: 25e5,
+		cachedInputPerMTok: 5e4,
+		cachedWriteInputPerMTok: 625e3
 	},
 	"claude-sonnet-4-6": {
-		displayName: "Claude Sonnet 4.6",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 3e5,
+		outputPerMTok: 15e5,
+		cachedInputPerMTok: 3e4,
+		cachedWriteInputPerMTok: 375e3
 	},
 	"claude-opus-4-6": {
-		displayName: "Claude Opus 4.6",
-		iconProvider: "anthropic"
+		kind: "flat",
+		inputPerMTok: 5e5,
+		outputPerMTok: 25e5,
+		cachedInputPerMTok: 5e4,
+		cachedWriteInputPerMTok: 625e3
 	},
 	"claude-haiku-4-5-20251001": {
-		displayName: "Claude Haiku 4.5",
-		iconProvider: "anthropic"
-	},
-	"gpt-5.6": {
-		displayName: "GPT-5.6 Sol",
-		iconProvider: "openai"
+		kind: "flat",
+		inputPerMTok: 1e5,
+		outputPerMTok: 5e5,
+		cachedInputPerMTok: 1e4,
+		cachedWriteInputPerMTok: 125e3
 	},
-	"gpt-5.6-terra": {
-		displayName: "GPT-5.6 Terra",
-		iconProvider: "openai"
+	"us.anthropic.claude-sonnet-4-5-20250929-v1:0": {
+		kind: "flat",
+		inputPerMTok: 3e5,
+		outputPerMTok: 15e5,
+		cachedInputPerMTok: 3e4,
+		cachedWriteInputPerMTok: 375e3
 	},
-	"gpt-5.6-luna": {
-		displayName: "GPT-5.6 Luna",
-		iconProvider: "openai"
+	"us.anthropic.claude-haiku-4-5-20251001-v1:0": {
+		kind: "flat",
+		inputPerMTok: 1e5,
+		outputPerMTok: 5e5,
+		cachedInputPerMTok: 1e4,
+		cachedWriteInputPerMTok: 125e3
 	},
-	"gpt-5.5": {
-		displayName: "GPT-5.5",
-		iconProvider: "openai"
+	"us.amazon.nova-pro-v1:0": {
+		kind: "flat",
+		inputPerMTok: 8e4,
+		outputPerMTok: 32e4,
+		cachedInputPerMTok: 2e4
 	},
-	"gpt-5.4": {
-		displayName: "GPT-5.4",
-		iconProvider: "openai"
+	"us.amazon.nova-lite-v1:0": {
+		kind: "flat",
+		inputPerMTok: 6e3,
+		outputPerMTok: 24e3,
+		cachedInputPerMTok: 1500
 	},
-	"gpt-5.4-mini": {
-		displayName: "GPT-5.4 Mini",
-		iconProvider: "openai"
+	"us.amazon.nova-micro-v1:0": {
+		kind: "flat",
+		inputPerMTok: 3500,
+		outputPerMTok: 14e3,
+		cachedInputPerMTok: 875
 	},
-	"gpt-5.4-nano": {
-		displayName: "GPT-5.4 Nano",
-		iconProvider: "openai"
+	"openai.gpt-oss-120b-1:0": {
+		kind: "flat",
+		inputPerMTok: 15e3,
+		outputPerMTok: 6e4
 	},
-	"gpt-5.2": {
-		displayName: "GPT-5.2",
-		iconProvider: "openai"
+	"openai.gpt-oss-20b-1:0": {
+		kind: "flat",
+		inputPerMTok: 7e3,
+		outputPerMTok: 3e4
 	},
-	"openai/gpt-5.6-luna": {
-		displayName: "GPT-5.6 Luna",
-		iconProvider: "openai"
+	"us.deepseek.r1-v1:0": {
+		kind: "flat",
+		inputPerMTok: 135e3,
+		outputPerMTok: 54e4
 	},
-	"openai/gpt-5.6-terra": {
-		displayName: "GPT-5.6 Terra",
-		iconProvider: "openai"
-	},
-	"google/gemini-3.7-flash": {
-		displayName: "Gemini 3.7 Flash",
-		iconProvider: "google"
-	},
-	"google/gemini-3.6-flash": {
-		displayName: "Gemini 3.6 Flash",
-		iconProvider: "google"
-	},
-	"google/gemini-3.5-flash-lite": {
-		displayName: "Gemini 3.5 Flash Lite",
-		iconProvider: "google"
+	"mistral-large-latest": {
+		kind: "flat",
+		inputPerMTok: 5e4,
+		outputPerMTok: 15e4
 	},
-	"google/gemini-3.1-pro-preview": {
-		displayName: "Gemini 3.1 Pro Preview",
-		iconProvider: "google"
+	"mistral-medium-latest": {
+		kind: "flat",
+		inputPerMTok: 15e4,
+		outputPerMTok: 75e4
 	},
-	"google/gemini-3.5-flash": {
-		displayName: "Gemini 3.5 Flash",
-		iconProvider: "google"
+	"mistral-small-latest": {
+		kind: "flat",
+		inputPerMTok: 15e3,
+		outputPerMTok: 6e4
 	},
-	"google/gemini-3.1-flash-lite": {
-		displayName: "Gemini 3.1 Flash Lite",
-		iconProvider: "google"
+	"magistral-medium-latest": {
+		kind: "flat",
+		inputPerMTok: 2e5,
+		outputPerMTok: 5e5
 	},
-	"anthropic/claude-sonnet-5": {
-		displayName: "Claude Sonnet 5",
-		iconProvider: "anthropic"
+	"magistral-small": {
+		kind: "flat",
+		inputPerMTok: 5e4,
+		outputPerMTok: 15e4
 	},
-	"anthropic/claude-opus-5": {
-		displayName: "Claude Opus 5",
-		iconProvider: "anthropic"
+	"pixtral-large-latest": {
+		kind: "flat",
+		inputPerMTok: 2e5,
+		outputPerMTok: 6e5
 	},
-	"anthropic/claude-opus-4.8": {
-		displayName: "Claude Opus 4.8",
-		iconProvider: "anthropic"
+	"gemini-2.5-flash": {
+		kind: "flat",
+		inputPerMTok: 3e4,
+		outputPerMTok: 25e4,
+		cachedInputPerMTok: 3e3
 	},
-	"anthropic/claude-sonnet-4.6": {
-		displayName: "Claude Sonnet 4.6",
-		iconProvider: "anthropic"
+	"gemini-2.5-pro": {
+		kind: "input-token-tiered",
+		inputTokenThreshold: 2e5,
+		standard: {
+			inputPerMTok: 125e3,
+			outputPerMTok: 1e6,
+			cachedInputPerMTok: 12500
+		},
+		aboveThreshold: {
+			inputPerMTok: 25e4,
+			outputPerMTok: 15e5,
+			cachedInputPerMTok: 25e3
+		}
 	},
-	"openai/gpt-5.5": {
-		displayName: "GPT-5.5",
-		iconProvider: "openai"
+	"gpt-4o-mini": {
+		kind: "flat",
+		inputPerMTok: 15e3,
+		outputPerMTok: 6e4,
+		cachedInputPerMTok: 7500
 	},
-	"openai/gpt-5.4-mini": {
-		displayName: "GPT-5.4 Mini",
-		iconProvider: "openai"
+	"gpt-4o": {
+		kind: "flat",
+		inputPerMTok: 25e4,
+		outputPerMTok: 1e6,
+		cachedInputPerMTok: 125e3
+	}
+};
+//#endregion
+//#region src/model-rate.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.
+*/
+const MODEL_RATE_UNITS_PER_USD = 1e5;
+const getStandardModelRate = (rate) => rate.kind === "flat" ? rate : rate.standard;
+const resolveModelRate = (rate, inputTokens) => rate.kind === "input-token-tiered" && inputTokens > rate.inputTokenThreshold ? rate.aboveThreshold : getStandardModelRate(rate);
+//#endregion
+//#region src/model-rate-policy.ts
+const MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER = {
+	google: "google",
+	openai: "openai",
+	anthropic: "anthropic",
+	bedrock: "amazon-bedrock",
+	mistral: "mistral"
+};
+const defineRateSourceAliases = (aliases) => aliases;
+/**
+* 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.
+*/
+const RETAINED_MODELS_DEV_RATE_ENTRIES = {
+	"gemini-2.5-flash": {
+		modelId: "gemini-2.5-flash",
+		provider: "google"
 	},
-	"us.anthropic.claude-sonnet-4-5-20250929-v1:0": {
-		displayName: "Claude Sonnet 4.5",
-		iconProvider: "anthropic"
+	"gemini-2.5-pro": {
+		modelId: "gemini-2.5-pro",
+		provider: "google"
 	},
-	"us.anthropic.claude-haiku-4-5-20251001-v1:0": {
-		displayName: "Claude Haiku 4.5",
-		iconProvider: "anthropic"
+	"gpt-4o-mini": {
+		modelId: "gpt-4o-mini",
+		provider: "openai"
 	},
+	"gpt-4o": {
+		modelId: "gpt-4o",
+		provider: "openai"
+	}
+};
+/**
+* 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.
+*/
+const MODELS_DEV_RATE_SOURCE_ALIASES = defineRateSourceAliases({
 	"us.amazon.nova-pro-v1:0": {
-		displayName: "Amazon Nova Pro",
-		iconProvider: "bedrock"
+		modelId: "amazon.nova-pro-v1:0",
+		provider: "amazon-bedrock",
+		reason: "2026-09-03: stella uses the Bedrock US inference-profile ID; models.dev prices its corresponding base model ID",
+		sourceUrl: "https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html"
 	},
 	"us.amazon.nova-lite-v1:0": {
-		displayName: "Amazon Nova Lite",
-		iconProvider: "bedrock"
+		modelId: "amazon.nova-lite-v1:0",
+		provider: "amazon-bedrock",
+		reason: "2026-09-03: stella uses the Bedrock US inference-profile ID; models.dev prices its corresponding base model ID",
+		sourceUrl: "https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html"
 	},
 	"us.amazon.nova-micro-v1:0": {
-		displayName: "Amazon Nova Micro",
-		iconProvider: "bedrock"
-	},
-	"openai.gpt-oss-120b-1:0": {
-		displayName: "GPT OSS 120B",
-		iconProvider: "openai"
-	},
-	"openai.gpt-oss-20b-1:0": {
-		displayName: "GPT OSS 20B",
-		iconProvider: "openai"
-	},
-	"us.deepseek.r1-v1:0": {
-		displayName: "DeepSeek R1",
-		iconProvider: "bedrock"
-	},
-	"mistral-large-latest": {
-		displayName: "Mistral Large",
-		iconProvider: "mistral"
-	},
-	"mistral-medium-latest": {
-		displayName: "Mistral Medium",
-		iconProvider: "mistral"
-	},
-	"mistral-small-latest": {
-		displayName: "Mistral Small",
-		iconProvider: "mistral"
-	},
-	"magistral-medium-latest": {
-		displayName: "Magistral Medium",
-		iconProvider: "mistral"
+		modelId: "amazon.nova-micro-v1:0",
+		provider: "amazon-bedrock",
+		reason: "2026-09-03: stella uses the Bedrock US inference-profile ID; models.dev prices its corresponding base model ID",
+		sourceUrl: "https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html"
+	}
+});
+//#endregion
+//#region src/capabilities-overrides.ts
+const CAPABILITY_OVERRIDES = {
+	"us.amazon.nova-pro-v1:0": {
+		documentInput: true,
+		documentInputReason: "2026-08-20: AWS documents PDF input for Nova Pro through Bedrock Converse",
+		reasoningEfforts: null,
+		temperatureSupported: true,
+		reason: "2026-07-20: absent from the models.dev amazon-bedrock catalog; Bedrock Converse accepts temperature and Nova has no reasoning dial"
 	},
-	"magistral-small": {
-		displayName: "Magistral Small",
-		iconProvider: "mistral"
+	"us.amazon.nova-lite-v1:0": {
+		documentInput: true,
+		documentInputReason: "2026-08-20: AWS documents PDF input for Nova Lite through Bedrock Converse",
+		reasoningEfforts: null,
+		temperatureSupported: true,
+		reason: "2026-07-20: absent from the models.dev amazon-bedrock catalog; Bedrock Converse accepts temperature and Nova has no reasoning dial"
 	},
-	"pixtral-large-latest": {
-		displayName: "Pixtral Large",
-		iconProvider: "mistral"
+	"us.amazon.nova-micro-v1:0": {
+		documentInput: false,
+		documentInputReason: "2026-08-20: AWS documents Nova Micro as text-only",
+		reasoningEfforts: null,
+		temperatureSupported: true,
+		reason: "2026-07-20: absent from the models.dev amazon-bedrock catalog; Bedrock Converse accepts temperature and Nova has no reasoning dial"
 	}
 };
-const MODEL_DISPLAY_METADATA_BY_ID = MODEL_DISPLAY_METADATA;
-const getModelDisplayMetadata = (modelId) => MODEL_DISPLAY_METADATA_BY_ID[normalizeModelCatalogId(modelId)] ?? null;
+//#endregion
+//#region src/document-input-overrides.ts
 /**
-* 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.
+* 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.
 */
-const BYOK_DOCUMENT_INPUT_MODEL_OPTIONS = MODEL_DOCUMENT_INPUT_OPTIONS;
-const isBYOKProviderRoleSupported = ({ provider, role }) => role !== "pdf" || BYOK_DOCUMENT_INPUT_MODEL_OPTIONS[provider].length > 0;
-const isBYOKModelRoleSupported = ({ provider, modelId, role }) => {
-	if (role !== "pdf") return true;
-	return BYOK_DOCUMENT_INPUT_MODEL_OPTIONS[provider].includes(modelId);
+const DOCUMENT_INPUT_OVERRIDES = {
+	"gpt-5.4-mini": {
+		supported: true,
+		reason: "2026-08-20: OpenAI Responses accepts input_file PDF content for this vision-capable model; models.dev currently omits the pdf modality"
+	},
+	"gpt-5.4-nano": {
+		supported: true,
+		reason: "2026-08-20: OpenAI Responses accepts input_file PDF content for this vision-capable model; models.dev currently omits the pdf modality"
+	},
+	"gpt-5.2": {
+		supported: true,
+		reason: "2026-08-20: OpenAI Responses accepts input_file PDF content for this vision-capable model; models.dev currently omits the pdf modality"
+	}
 };
+//#endregion
+//#region src/index.ts
 /**
-* 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.
+* Canonical AI provider and model catalog.
+*
+* Single source of truth for every provider/model identifier stella
+* offers. Imported by the API runtime
+* (`apps/api/src/lib/tanstack-ai-models.ts`)
+* and the BYOK settings UI (`apps/web`), so the picker can never offer
+* a model the backend rejects, and vice versa.
+*
+* Pure data: no provider SDKs, no env access, no side effects. This is
+* deliberate so scripts (the nightly upstream-validation check) and
+* both apps can import it cheaply. Keep it that way. The only runtime
+* dependency is valibot, used solely to construct branded types the
+* same way the rest of the repo does.
+*
+* Model IDs go stale when providers rename or retire models. The
+* nightly `model-catalog-upstream` check
+* (`packages/scripts/src/model-catalog-upstream.ts`) validates every
+* ID here against live provider/aggregator listings so a retired model
+* fails CI instead of 400-ing a user at runtime.
 */
-const CHAT_PDF_ATTACHMENT_MODEL_OPTIONS = {
-	...BYOK_DOCUMENT_INPUT_MODEL_OPTIONS,
-	mistral: [
-		"mistral-medium-latest",
-		"mistral-small-latest",
-		"pixtral-large-latest"
-	]
-};
-const isChatPdfAttachmentModelSupported = ({ provider, modelId }) => {
-	return CHAT_PDF_ATTACHMENT_MODEL_OPTIONS[provider].includes(modelId);
-};
 /**
-* Whether a model id is currently offered for this provider+role: it
-* must be in the curated catalog for the provider AND satisfy the
-* role's input-modality constraint (PDF needs a document-capable
-* model). This is the runtime allowlist, so a model dropped by a
-* catalog bump stops being valid here even though it is still a
-* non-empty string in a stored org config.
-*/
-const isOfferedBYOKModelForRole = ({ provider, modelId, role }) => {
-	return BYOK_MODEL_OPTIONS[provider].includes(modelId) && isBYOKModelRoleSupported({
-		provider,
-		modelId,
-		role
-	});
-};
-/**
-* 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.
+* Logical model roles. Call sites declare *what* they need, not
+* *which* model to use.
 *
-* 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).
-*/
-const resolveWorkingBYOKModelForRole = ({ provider, modelId, role }) => {
-	if (isOfferedBYOKModelForRole({
-		provider,
-		modelId,
-		role
-	})) return modelId;
-	const fallback = BYOK_DEFAULT_MODELS[provider][role];
-	return isOfferedBYOKModelForRole({
-		provider,
-		modelId: fallback,
-		role
-	}) ? fallback : 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.
+* - fast: classification, extraction, short generation
+* - chat: conversational with tool use and streaming
+* - reasoning: complex multi-step legal analysis
+* - pdf: native PDF/image understanding
 */
-const ANTHROPIC_ADAPTIVE_THINKING_MODELS = [
-	"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"
+const MODEL_ROLES = [
+	"fast",
+	"chat",
+	"reasoning",
+	"pdf"
 ];
-/**
-* 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.
-*/
-const REASONING_EFFORTS = [
-	"none",
-	"minimal",
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max"
+const TEMPERATURE_POLICIES = ["emit", "omit"];
+const AI_PROVIDERS = [
+	"google",
+	"openrouter",
+	"openai",
+	"azure_foundry",
+	"anthropic",
+	"bedrock",
+	"mistral",
+	"openai_compatible",
+	"huggingface"
 ];
-const resolvedReasoningEffortSchema = v.pipe(v.picklist(REASONING_EFFORTS), v.brand("ResolvedReasoningEffort"));
-/**
-* 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.
-*/
-/**
-* 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.
-*/
-const FALLBACK_CHAT_MODEL_BY_PROVIDER = {
-	google: DEFAULT_MODELS.google.fast,
-	openrouter: "openai/gpt-5.6-luna",
-	openai: "gpt-5.6-luna",
-	anthropic: DEFAULT_MODELS.anthropic.fast,
-	bedrock: DEFAULT_MODELS.bedrock.fast,
-	mistral: DEFAULT_MODELS.mistral.fast,
-	azure_foundry: null,
-	openai_compatible: null,
-	huggingface: null
-};
-const MODEL_CATALOG_ID_ALIASES = {
-	"gpt-5.6-sol": "gpt-5.6",
-	"claude-opus-4.8": "claude-opus-4-8",
-	"claude-sonnet-4.6": "claude-sonnet-4-6"
+const TANSTACK_AI_PROVIDERS = [
+	"google",
+	"openrouter",
+	"openai",
+	"anthropic",
+	"bedrock",
+	"mistral"
+];
+const MODEL_CATALOG_PROVIDER_KIND = {
+	google: "first-party",
+	openrouter: "aggregator",
+	openai: "first-party",
+	anthropic: "first-party",
+	bedrock: "platform",
+	mistral: "first-party"
 };
-const MODEL_CATALOG_ID_ALIAS_TARGET_BY_ID = MODEL_CATALOG_ID_ALIASES;
-const normalizeModelCatalogId = (modelId) => MODEL_CATALOG_ID_ALIAS_TARGET_BY_ID[modelId] ?? modelId;
-const MODEL_TEMPERATURE_POLICY_BY_ID = MODEL_TEMPERATURE_POLICIES;
 /**
-* 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.
+* 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.
 */
-const shouldEmitTemperature = (modelId) => MODEL_TEMPERATURE_POLICY_BY_ID[normalizeModelCatalogId(modelId)] === "emit";
-const MODEL_REASONING_EFFORTS_BY_ID = MODEL_REASONING_EFFORTS;
+const FIRST_PARTY_MODEL_PROVIDERS = [
+	"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.
+* 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.
 */
-const getModelReasoningEfforts = (modelId) => MODEL_REASONING_EFFORTS_BY_ID[normalizeModelCatalogId(modelId)] ?? null;
-const MODEL_DEFAULT_REASONING_EFFORTS_BY_ID = MODEL_DEFAULT_REASONING_EFFORTS;
+const BYOK_DEFAULT_MODELS = {
+	google: {
+		fast: "gemini-3.7-flash",
+		chat: "gemini-3.7-flash",
+		reasoning: "gemini-3.7-flash",
+		pdf: "gemini-3.7-flash"
+	},
+	openrouter: {
+		fast: "openai/gpt-5.6-luna",
+		chat: "openai/gpt-5.6-terra",
+		reasoning: "openai/gpt-5.6-terra",
+		pdf: "openai/gpt-5.6-terra"
+	},
+	openai: {
+		fast: "gpt-5.4-nano",
+		chat: "gpt-5.4-mini",
+		reasoning: "gpt-5.4",
+		pdf: "gpt-5.4"
+	},
+	anthropic: {
+		fast: "claude-opus-5",
+		chat: "claude-opus-5",
+		reasoning: "claude-opus-5",
+		pdf: "claude-opus-5"
+	},
+	bedrock: {
+		fast: "us.amazon.nova-micro-v1:0",
+		chat: "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
+		reasoning: "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
+		pdf: "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
+	},
+	mistral: {
+		fast: "mistral-small-latest",
+		chat: "mistral-medium-latest",
+		reasoning: "magistral-medium-latest",
+		pdf: "mistral-large-latest"
+	}
+};
 /**
-* Concrete provider-default effort published for a model, or null when the
-* provider exposes no named default. Unknown ids also resolve to null.
+* 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).
 */
-const getModelDefaultReasoningEffort = (modelId) => MODEL_DEFAULT_REASONING_EFFORTS_BY_ID[normalizeModelCatalogId(modelId)] ?? null;
-const asResolvedReasoningEffort = (effort) => v.parse(resolvedReasoningEffortSchema, effort);
+const DEFAULT_MODELS = {
+	...BYOK_DEFAULT_MODELS,
+	azure_foundry: {
+		fast: "gpt-5.4-nano",
+		chat: "gpt-5.4-mini",
+		reasoning: "gpt-5.4",
+		pdf: "gpt-5.4"
+	},
+	openai_compatible: {
+		fast: "default",
+		chat: "default",
+		reasoning: "default",
+		pdf: "default"
+	},
+	huggingface: {
+		fast: "speakleash/Bielik-1.5B-v3.0-Instruct",
+		chat: "speakleash/Bielik-11B-v2.3-Instruct",
+		reasoning: "speakleash/Bielik-11B-v2.3-Instruct",
+		pdf: "speakleash/Bielik-11B-v2.3-Instruct"
+	}
+};
 /**
-* Clamp a requested reasoning effort into the target model's declared
-* capability.
+* 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.
 *
-* - 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.
+* 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.
 */
-const resolveReasoningEffort = ({ modelId, requested }) => {
-	const efforts = getModelReasoningEfforts(modelId);
-	const weakest = efforts?.at(0);
-	if (efforts === null || weakest === void 0) return null;
-	if (efforts.includes(requested)) return asResolvedReasoningEffort(requested);
-	const requestedRank = REASONING_EFFORTS.indexOf(requested);
-	let nearest = weakest;
-	let nearestDistance = Number.POSITIVE_INFINITY;
-	for (const effort of efforts) {
-		const distance = Math.abs(REASONING_EFFORTS.indexOf(effort) - requestedRank);
-		if (distance < nearestDistance || distance === nearestDistance && REASONING_EFFORTS.indexOf(effort) < REASONING_EFFORTS.indexOf(nearest)) {
-			nearest = effort;
-			nearestDistance = distance;
-		}
-	}
-	return asResolvedReasoningEffort(nearest);
+const BYOK_MODEL_OPTIONS = {
+	google: [
+		"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"
+	],
+	anthropic: [
+		"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"
+	],
+	openai: [
+		"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"
+	],
+	openrouter: [
+		"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"
+	],
+	bedrock: [
+		"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"
+	],
+	mistral: [
+		"mistral-large-latest",
+		"mistral-medium-latest",
+		"mistral-small-latest",
+		"magistral-medium-latest",
+		"magistral-small",
+		"pixtral-large-latest"
+	]
 };
-const getStandardModelRate = (rate) => rate.kind === "flat" ? rate : rate.standard;
-const resolveModelRate = (rate, inputTokens) => rate.kind === "input-token-tiered" && inputTokens > rate.inputTokenThreshold ? rate.aboveThreshold : getStandardModelRate(rate);
 /**
-* 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.
 */
-const MODEL_RATES = {
-	"gemini-2.5-flash": {
-		kind: "flat",
-		inputPerMTok: 3e4,
-		outputPerMTok: 25e4,
-		cachedInputPerMTok: 7500
-	},
-	"gemini-2.5-pro": {
-		kind: "flat",
-		inputPerMTok: 125e3,
-		outputPerMTok: 1e6,
-		cachedInputPerMTok: 31250
-	},
-	"gemini-3.1-flash-lite": {
-		kind: "flat",
-		inputPerMTok: 25e3,
-		outputPerMTok: 15e4,
-		cachedInputPerMTok: 2500
-	},
-	"gemini-3.5-flash": {
-		kind: "flat",
-		inputPerMTok: 15e4,
-		outputPerMTok: 9e5,
-		cachedInputPerMTok: 15e3
+const MODEL_DISPLAY_METADATA = {
+	"gemini-3.8-flash": {
+		displayName: "Gemini 3.8 Flash",
+		iconProvider: "google"
 	},
-	"gemini-3.5-flash-lite": {
-		kind: "flat",
-		inputPerMTok: 3e4,
-		outputPerMTok: 25e4,
-		cachedInputPerMTok: 3e3
+	"gemini-3.7-flash": {
+		displayName: "Gemini 3.7 Flash",
+		iconProvider: "google"
 	},
 	"gemini-3.6-flash": {
-		kind: "flat",
-		inputPerMTok: 75e3,
-		outputPerMTok: 375e3,
-		cachedInputPerMTok: 7500
+		displayName: "Gemini 3.6 Flash",
+		iconProvider: "google"
 	},
-	"gemini-3.7-flash": {
-		kind: "flat",
-		inputPerMTok: 75e3,
-		outputPerMTok: 375e3,
-		cachedInputPerMTok: 7500
+	"gemini-3.5-flash-lite": {
+		displayName: "Gemini 3.5 Flash Lite",
+		iconProvider: "google"
 	},
 	"gemini-3.1-pro-preview": {
-		kind: "input-token-tiered",
-		inputTokenThreshold: 2e5,
-		standard: {
-			inputPerMTok: 2e5,
-			outputPerMTok: 12e5,
-			cachedInputPerMTok: 2e4
-		},
-		aboveThreshold: {
-			inputPerMTok: 4e5,
-			outputPerMTok: 18e5,
-			cachedInputPerMTok: 4e4
-		}
+		displayName: "Gemini 3.1 Pro Preview",
+		iconProvider: "google"
+	},
+	"gemini-3.5-flash": {
+		displayName: "Gemini 3.5 Flash",
+		iconProvider: "google"
 	},
-	"gpt-4o-mini": {
-		kind: "flat",
-		inputPerMTok: 15e3,
-		outputPerMTok: 6e4,
-		cachedInputPerMTok: 7500
+	"gemini-3.1-flash-lite": {
+		displayName: "Gemini 3.1 Flash Lite",
+		iconProvider: "google"
 	},
-	"gpt-4o": {
-		kind: "flat",
-		inputPerMTok: 25e4,
-		outputPerMTok: 1e6,
-		cachedInputPerMTok: 125e3
+	"claude-sonnet-5": {
+		displayName: "Claude Sonnet 5",
+		iconProvider: "anthropic"
 	},
-	"gpt-5.2": {
-		kind: "flat",
-		inputPerMTok: 175e3,
-		outputPerMTok: 14e5,
-		cachedInputPerMTok: 17500
+	"claude-fable-5-1": {
+		displayName: "Claude Fable 5.1",
+		iconProvider: "anthropic"
 	},
-	"gpt-5.4-nano": {
-		kind: "flat",
-		inputPerMTok: 2e4,
-		outputPerMTok: 125e3,
-		cachedInputPerMTok: 2e3
+	"claude-fable-5": {
+		displayName: "Claude Fable 5",
+		iconProvider: "anthropic"
 	},
-	"gpt-5.4-mini": {
-		kind: "flat",
-		inputPerMTok: 75e3,
-		outputPerMTok: 45e4,
-		cachedInputPerMTok: 7500
+	"claude-opus-5": {
+		displayName: "Claude Opus 5",
+		iconProvider: "anthropic"
 	},
-	"gpt-5.4": {
-		kind: "input-token-tiered",
-		inputTokenThreshold: 272e3,
-		standard: {
-			inputPerMTok: 25e4,
-			outputPerMTok: 15e5,
-			cachedInputPerMTok: 25e3
-		},
-		aboveThreshold: {
-			inputPerMTok: 5e5,
-			outputPerMTok: 225e4,
-			cachedInputPerMTok: 5e4
-		}
+	"claude-opus-4-8": {
+		displayName: "Claude Opus 4.8",
+		iconProvider: "anthropic"
 	},
-	"gpt-5.5": {
-		kind: "input-token-tiered",
-		inputTokenThreshold: 272e3,
-		standard: {
-			inputPerMTok: 5e5,
-			outputPerMTok: 3e6,
-			cachedInputPerMTok: 5e4
-		},
-		aboveThreshold: {
-			inputPerMTok: 1e6,
-			outputPerMTok: 45e5,
-			cachedInputPerMTok: 1e5
-		}
+	"claude-opus-4-7": {
+		displayName: "Claude Opus 4.7",
+		iconProvider: "anthropic"
+	},
+	"claude-sonnet-4-6": {
+		displayName: "Claude Sonnet 4.6",
+		iconProvider: "anthropic"
+	},
+	"claude-opus-4-6": {
+		displayName: "Claude Opus 4.6",
+		iconProvider: "anthropic"
+	},
+	"claude-haiku-4-5-20251001": {
+		displayName: "Claude Haiku 4.5",
+		iconProvider: "anthropic"
 	},
 	"gpt-5.6": {
-		kind: "input-token-tiered",
-		inputTokenThreshold: 272e3,
-		standard: {
-			inputPerMTok: 4e5,
-			outputPerMTok: 2e6,
-			cachedInputPerMTok: 4e4
-		},
-		aboveThreshold: {
-			inputPerMTok: 8e5,
-			outputPerMTok: 3e6,
-			cachedInputPerMTok: 8e4
-		}
+		displayName: "GPT-5.6 Sol",
+		iconProvider: "openai"
+	},
+	"gpt-5.6-terra": {
+		displayName: "GPT-5.6 Terra",
+		iconProvider: "openai"
 	},
 	"gpt-5.6-luna": {
-		kind: "input-token-tiered",
-		inputTokenThreshold: 272e3,
-		standard: {
-			inputPerMTok: 2e4,
-			outputPerMTok: 12e4,
-			cachedInputPerMTok: 2e3
-		},
-		aboveThreshold: {
-			inputPerMTok: 4e4,
-			outputPerMTok: 18e4,
-			cachedInputPerMTok: 4e3
-		}
+		displayName: "GPT-5.6 Luna",
+		iconProvider: "openai"
 	},
-	"gpt-5.6-terra": {
-		kind: "input-token-tiered",
-		inputTokenThreshold: 272e3,
-		standard: {
-			inputPerMTok: 2e5,
-			outputPerMTok: 12e5,
-			cachedInputPerMTok: 2e4
-		},
-		aboveThreshold: {
-			inputPerMTok: 4e5,
-			outputPerMTok: 18e5,
-			cachedInputPerMTok: 4e4
-		}
+	"gpt-5.5": {
+		displayName: "GPT-5.5",
+		iconProvider: "openai"
 	},
-	"claude-haiku-4-5-20251001": {
-		kind: "flat",
-		inputPerMTok: 1e5,
-		outputPerMTok: 5e5,
-		cachedInputPerMTok: 1e4
+	"gpt-5.4": {
+		displayName: "GPT-5.4",
+		iconProvider: "openai"
 	},
-	"claude-sonnet-4-6": {
-		kind: "flat",
-		inputPerMTok: 3e5,
-		outputPerMTok: 15e5,
-		cachedInputPerMTok: 3e4
+	"gpt-5.4-mini": {
+		displayName: "GPT-5.4 Mini",
+		iconProvider: "openai"
 	},
-	"claude-sonnet-5": {
-		kind: "flat",
-		inputPerMTok: 2e5,
-		outputPerMTok: 1e6,
-		cachedInputPerMTok: 2e4
+	"gpt-5.4-nano": {
+		displayName: "GPT-5.4 Nano",
+		iconProvider: "openai"
 	},
-	"claude-opus-4-6": {
-		kind: "flat",
-		inputPerMTok: 5e5,
-		outputPerMTok: 25e5,
-		cachedInputPerMTok: 5e4
+	"gpt-5.2": {
+		displayName: "GPT-5.2",
+		iconProvider: "openai"
 	},
-	"claude-opus-4-7": {
-		kind: "flat",
-		inputPerMTok: 5e5,
-		outputPerMTok: 25e5,
-		cachedInputPerMTok: 5e4
+	"openai/gpt-5.6-luna": {
+		displayName: "GPT-5.6 Luna",
+		iconProvider: "openai"
 	},
-	"claude-opus-4-8": {
-		kind: "flat",
-		inputPerMTok: 5e5,
-		outputPerMTok: 25e5,
-		cachedInputPerMTok: 5e4
+	"openai/gpt-5.6-terra": {
+		displayName: "GPT-5.6 Terra",
+		iconProvider: "openai"
 	},
-	"claude-opus-5": {
-		kind: "flat",
-		inputPerMTok: 5e5,
-		outputPerMTok: 25e5,
-		cachedInputPerMTok: 5e4
+	"google/gemini-3.8-flash": {
+		displayName: "Gemini 3.8 Flash",
+		iconProvider: "google"
 	},
-	"claude-fable-5": {
-		kind: "flat",
-		inputPerMTok: 1e6,
-		outputPerMTok: 5e6,
-		cachedInputPerMTok: 1e5
+	"google/gemini-3.7-flash": {
+		displayName: "Gemini 3.7 Flash",
+		iconProvider: "google"
 	},
-	"claude-fable-5-1": {
-		kind: "flat",
-		inputPerMTok: 1e6,
-		outputPerMTok: 5e6,
-		cachedInputPerMTok: 25e3
+	"google/gemini-3.6-flash": {
+		displayName: "Gemini 3.6 Flash",
+		iconProvider: "google"
 	},
-	"mistral-small-latest": {
-		kind: "flat",
-		inputPerMTok: 15e3,
-		outputPerMTok: 6e4
+	"google/gemini-3.5-flash-lite": {
+		displayName: "Gemini 3.5 Flash Lite",
+		iconProvider: "google"
 	},
-	"mistral-large-latest": {
-		kind: "flat",
-		inputPerMTok: 5e4,
-		outputPerMTok: 15e4
+	"google/gemini-3.1-pro-preview": {
+		displayName: "Gemini 3.1 Pro Preview",
+		iconProvider: "google"
 	},
-	"mistral-medium-latest": {
-		kind: "flat",
-		inputPerMTok: 15e4,
-		outputPerMTok: 75e4
+	"google/gemini-3.5-flash": {
+		displayName: "Gemini 3.5 Flash",
+		iconProvider: "google"
 	},
-	"mistral-medium-3-5": {
-		kind: "flat",
-		inputPerMTok: 15e4,
-		outputPerMTok: 75e4
+	"google/gemini-3.1-flash-lite": {
+		displayName: "Gemini 3.1 Flash Lite",
+		iconProvider: "google"
 	},
-	"magistral-medium-latest": {
-		kind: "flat",
-		inputPerMTok: 2e5,
-		outputPerMTok: 5e5
+	"anthropic/claude-sonnet-5": {
+		displayName: "Claude Sonnet 5",
+		iconProvider: "anthropic"
 	},
-	"magistral-small": {
-		kind: "flat",
-		inputPerMTok: 5e4,
-		outputPerMTok: 15e4
+	"anthropic/claude-opus-5": {
+		displayName: "Claude Opus 5",
+		iconProvider: "anthropic"
 	},
-	"magistral-small-latest": {
-		kind: "flat",
-		inputPerMTok: 5e4,
-		outputPerMTok: 15e4
+	"anthropic/claude-opus-4.8": {
+		displayName: "Claude Opus 4.8",
+		iconProvider: "anthropic"
 	},
-	"pixtral-large-latest": {
-		kind: "flat",
-		inputPerMTok: 2e5,
-		outputPerMTok: 6e5
+	"anthropic/claude-sonnet-4.6": {
+		displayName: "Claude Sonnet 4.6",
+		iconProvider: "anthropic"
+	},
+	"openai/gpt-5.5": {
+		displayName: "GPT-5.5",
+		iconProvider: "openai"
+	},
+	"openai/gpt-5.4-mini": {
+		displayName: "GPT-5.4 Mini",
+		iconProvider: "openai"
 	},
 	"us.anthropic.claude-sonnet-4-5-20250929-v1:0": {
-		kind: "flat",
-		inputPerMTok: 3e5,
-		outputPerMTok: 15e5,
-		cachedInputPerMTok: 3e4
+		displayName: "Claude Sonnet 4.5",
+		iconProvider: "anthropic"
 	},
 	"us.anthropic.claude-haiku-4-5-20251001-v1:0": {
-		kind: "flat",
-		inputPerMTok: 1e5,
-		outputPerMTok: 5e5,
-		cachedInputPerMTok: 1e4
+		displayName: "Claude Haiku 4.5",
+		iconProvider: "anthropic"
 	},
 	"us.amazon.nova-pro-v1:0": {
-		kind: "flat",
-		inputPerMTok: 8e4,
-		outputPerMTok: 32e4
+		displayName: "Amazon Nova Pro",
+		iconProvider: "bedrock"
 	},
 	"us.amazon.nova-lite-v1:0": {
-		kind: "flat",
-		inputPerMTok: 6e3,
-		outputPerMTok: 24e3
+		displayName: "Amazon Nova Lite",
+		iconProvider: "bedrock"
 	},
 	"us.amazon.nova-micro-v1:0": {
-		kind: "flat",
-		inputPerMTok: 3500,
-		outputPerMTok: 14e3
+		displayName: "Amazon Nova Micro",
+		iconProvider: "bedrock"
 	},
 	"openai.gpt-oss-120b-1:0": {
-		kind: "flat",
-		inputPerMTok: 15e3,
-		outputPerMTok: 6e4
+		displayName: "GPT OSS 120B",
+		iconProvider: "openai"
 	},
 	"openai.gpt-oss-20b-1:0": {
-		kind: "flat",
-		inputPerMTok: 7e3,
-		outputPerMTok: 3e4
+		displayName: "GPT OSS 20B",
+		iconProvider: "openai"
 	},
 	"us.deepseek.r1-v1:0": {
-		kind: "flat",
-		inputPerMTok: 135e3,
-		outputPerMTok: 54e4
+		displayName: "DeepSeek R1",
+		iconProvider: "bedrock"
+	},
+	"mistral-large-latest": {
+		displayName: "Mistral Large",
+		iconProvider: "mistral"
+	},
+	"mistral-medium-latest": {
+		displayName: "Mistral Medium",
+		iconProvider: "mistral"
+	},
+	"mistral-small-latest": {
+		displayName: "Mistral Small",
+		iconProvider: "mistral"
+	},
+	"magistral-medium-latest": {
+		displayName: "Magistral Medium",
+		iconProvider: "mistral"
+	},
+	"magistral-small": {
+		displayName: "Magistral Small",
+		iconProvider: "mistral"
+	},
+	"pixtral-large-latest": {
+		displayName: "Pixtral Large",
+		iconProvider: "mistral"
+	}
+};
+const MODEL_DISPLAY_METADATA_BY_ID = MODEL_DISPLAY_METADATA;
+const getModelDisplayMetadata = (modelId) => MODEL_DISPLAY_METADATA_BY_ID[normalizeModelCatalogId(modelId)] ?? 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.
+*/
+const BYOK_DOCUMENT_INPUT_MODEL_OPTIONS = MODEL_DOCUMENT_INPUT_OPTIONS;
+const isBYOKProviderRoleSupported = ({ provider, role }) => role !== "pdf" || BYOK_DOCUMENT_INPUT_MODEL_OPTIONS[provider].length > 0;
+const isBYOKModelRoleSupported = ({ provider, modelId, role }) => {
+	if (role !== "pdf") return true;
+	return BYOK_DOCUMENT_INPUT_MODEL_OPTIONS[provider].includes(modelId);
+};
+/**
+* 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.
+*/
+const CHAT_PDF_ATTACHMENT_MODEL_OPTIONS = {
+	...BYOK_DOCUMENT_INPUT_MODEL_OPTIONS,
+	mistral: [
+		"mistral-medium-latest",
+		"mistral-small-latest",
+		"pixtral-large-latest"
+	]
+};
+const isChatPdfAttachmentModelSupported = ({ provider, modelId }) => {
+	return CHAT_PDF_ATTACHMENT_MODEL_OPTIONS[provider].includes(modelId);
+};
+/**
+* Whether a model id is currently offered for this provider+role: it
+* must be in the curated catalog for the provider AND satisfy the
+* role's input-modality constraint (PDF needs a document-capable
+* model). This is the runtime allowlist, so a model dropped by a
+* catalog bump stops being valid here even though it is still a
+* non-empty string in a stored org config.
+*/
+const isOfferedBYOKModelForRole = ({ provider, modelId, role }) => {
+	return BYOK_MODEL_OPTIONS[provider].includes(modelId) && isBYOKModelRoleSupported({
+		provider,
+		modelId,
+		role
+	});
+};
+/**
+* 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).
+*/
+const resolveWorkingBYOKModelForRole = ({ provider, modelId, role }) => {
+	if (isOfferedBYOKModelForRole({
+		provider,
+		modelId,
+		role
+	})) return modelId;
+	const fallback = BYOK_DEFAULT_MODELS[provider][role];
+	return isOfferedBYOKModelForRole({
+		provider,
+		modelId: fallback,
+		role
+	}) ? fallback : 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.
+*/
+const ANTHROPIC_ADAPTIVE_THINKING_MODELS = [
+	"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.
+*/
+const REASONING_EFFORTS = [
+	"none",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+const resolvedReasoningEffortSchema = v.pipe(v.picklist(REASONING_EFFORTS), v.brand("ResolvedReasoningEffort"));
+/**
+* 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.
+*/
+const FALLBACK_CHAT_MODEL_BY_PROVIDER = {
+	google: DEFAULT_MODELS.google.fast,
+	openrouter: "openai/gpt-5.6-luna",
+	openai: "gpt-5.6-luna",
+	anthropic: DEFAULT_MODELS.anthropic.fast,
+	bedrock: DEFAULT_MODELS.bedrock.fast,
+	mistral: DEFAULT_MODELS.mistral.fast,
+	azure_foundry: null,
+	openai_compatible: null,
+	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.
+*/
+const MODEL_CATALOG_ID_ALIASES = {
+	"gpt-5.6-sol": "gpt-5.6",
+	"claude-opus-4.8": "claude-opus-4-8",
+	"claude-sonnet-4.6": "claude-sonnet-4-6"
+};
+const MODEL_CATALOG_ID_ALIAS_TARGET_BY_ID = MODEL_CATALOG_ID_ALIASES;
+const normalizeModelCatalogId = (modelId) => MODEL_CATALOG_ID_ALIAS_TARGET_BY_ID[modelId] ?? modelId;
+const MODEL_TEMPERATURE_POLICY_BY_ID = MODEL_TEMPERATURE_POLICIES;
+/**
+* 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.
+*/
+const shouldEmitTemperature = (modelId) => MODEL_TEMPERATURE_POLICY_BY_ID[normalizeModelCatalogId(modelId)] === "emit";
+const MODEL_REASONING_EFFORTS_BY_ID = MODEL_REASONING_EFFORTS;
+/**
+* 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.
+*/
+const getModelReasoningEfforts = (modelId) => MODEL_REASONING_EFFORTS_BY_ID[normalizeModelCatalogId(modelId)] ?? null;
+const MODEL_DEFAULT_REASONING_EFFORTS_BY_ID = MODEL_DEFAULT_REASONING_EFFORTS;
+/**
+* Concrete provider-default effort published for a model, or null when the
+* provider exposes no named default. Unknown ids also resolve to null.
+*/
+const getModelDefaultReasoningEffort = (modelId) => MODEL_DEFAULT_REASONING_EFFORTS_BY_ID[normalizeModelCatalogId(modelId)] ?? null;
+const asResolvedReasoningEffort = (effort) => v.parse(resolvedReasoningEffortSchema, effort);
+/**
+* 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.
+*/
+const resolveReasoningEffort = ({ modelId, requested }) => {
+	const efforts = getModelReasoningEfforts(modelId);
+	const weakest = efforts?.at(0);
+	if (efforts === null || weakest === void 0) return null;
+	if (efforts.includes(requested)) return asResolvedReasoningEffort(requested);
+	const requestedRank = REASONING_EFFORTS.indexOf(requested);
+	let nearest = weakest;
+	let nearestDistance = Number.POSITIVE_INFINITY;
+	for (const effort of efforts) {
+		const distance = Math.abs(REASONING_EFFORTS.indexOf(effort) - requestedRank);
+		if (distance < nearestDistance || distance === nearestDistance && REASONING_EFFORTS.indexOf(effort) < REASONING_EFFORTS.indexOf(nearest)) {
+			nearest = effort;
+			nearestDistance = distance;
+		}
 	}
+	return asResolvedReasoningEffort(nearest);
 };
 const MODEL_RATES_BY_ID = MODEL_RATES;
 const OPENROUTER_UNDERLYING_MODEL_ID_BY_ID = Object.fromEntries(BYOK_MODEL_OPTIONS.openrouter.map((modelId) => [modelId, modelId.slice(modelId.indexOf("/") + 1)]));
@@ -1460,6 +1571,7 @@ const CONTEXT_WINDOW_TOKENS = {
 	"gemini-3.5-flash-lite": 1048576,
 	"gemini-3.6-flash": 1048576,
 	"gemini-3.7-flash": 1048576,
+	"gemini-3.8-flash": 1048576,
 	"gemini-3.1-pro-preview": 1048576,
 	"gpt-4o-mini": 128e3,
 	"gpt-4o": 128e3,
@@ -1488,6 +1600,7 @@ const CONTEXT_WINDOW_TOKENS = {
 	"magistral-small-latest": 128e3,
 	"magistral-small": 128e3,
 	"pixtral-large-latest": 128e3,
+	"google/gemini-3.8-flash": 1048576,
 	"google/gemini-3.7-flash": 1048576,
 	"google/gemini-3.6-flash": 1048576,
 	"google/gemini-3.5-flash-lite": 1048576,
@@ -1525,4 +1638,4 @@ const DEFAULT_CONTEXT_WINDOW_TOKENS = 128e3;
 */
 const getContextWindowTokens = (modelId) => CONTEXT_WINDOW_TOKENS_BY_ID[normalizeModelCatalogId(modelId)] ?? 128e3;
 //#endregion
-export { AI_PROVIDERS, ANTHROPIC_ADAPTIVE_THINKING_MODELS, BYOK_DEFAULT_MODELS, BYOK_DOCUMENT_INPUT_MODEL_OPTIONS, BYOK_MODEL_OPTIONS, CAPABILITY_OVERRIDES, CHAT_PDF_ATTACHMENT_MODEL_OPTIONS, CONTEXT_WINDOW_TOKENS, DEFAULT_CONTEXT_WINDOW_TOKENS, DEFAULT_MODELS, DOCUMENT_INPUT_OVERRIDES, FALLBACK_CHAT_MODEL_BY_PROVIDER, FIRST_PARTY_MODEL_PROVIDERS, 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, REASONING_EFFORTS, TANSTACK_AI_PROVIDERS, TEMPERATURE_POLICIES, getContextWindowTokens, getModelDefaultReasoningEffort, getModelDisplayMetadata, getModelRate, getModelReasoningEfforts, getStandardModelRate, isBYOKModelRoleSupported, isBYOKProviderRoleSupported, isChatPdfAttachmentModelSupported, normalizeModelCatalogId, resolveModelRate, resolveReasoningEffort, resolveWorkingBYOKModelForRole, shouldEmitTemperature };
+export { AI_PROVIDERS, ANTHROPIC_ADAPTIVE_THINKING_MODELS, BYOK_DEFAULT_MODELS, BYOK_DOCUMENT_INPUT_MODEL_OPTIONS, BYOK_MODEL_OPTIONS, CAPABILITY_OVERRIDES, CHAT_PDF_ATTACHMENT_MODEL_OPTIONS, CONTEXT_WINDOW_TOKENS, DEFAULT_CONTEXT_WINDOW_TOKENS, DEFAULT_MODELS, DOCUMENT_INPUT_OVERRIDES, FALLBACK_CHAT_MODEL_BY_PROVIDER, FIRST_PARTY_MODEL_PROVIDERS, 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, REASONING_EFFORTS, RETAINED_MODELS_DEV_RATE_ENTRIES, TANSTACK_AI_PROVIDERS, TEMPERATURE_POLICIES, getContextWindowTokens, getModelDefaultReasoningEffort, getModelDisplayMetadata, getModelRate, getModelReasoningEfforts, getStandardModelRate, isBYOKModelRoleSupported, isBYOKProviderRoleSupported, isChatPdfAttachmentModelSupported, normalizeModelCatalogId, resolveModelRate, resolveReasoningEffort, resolveWorkingBYOKModelForRole, shouldEmitTemperature };