@dcdr/contracts 1.9.6

package/dist/provider.contract.js

@@ -0,0 +1,3310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderModelRegistry = exports.PROVIDER_MODEL_E2E_OVERRIDES = exports.ProviderModelE2EStatus = exports.PROVIDER_MODEL_IDS_BY_PROVIDER_AND_TYPE = exports.PROVIDER_MODEL_CATALOG = exports.PROVIDER_MODEL_DEFINITIONS_BY_PROVIDER = exports.DcdrPublicModelCategory = exports.ProviderModelParameterSupportStatus = exports.PromptParameterKey = exports.ProviderModelPreferredApi = exports.ProviderModelRuntimeSupportStatus = exports.IntentProvider = void 0;
+exports.formatDcdrVirtualModelId = formatDcdrVirtualModelId;
+exports.parseDcdrVirtualModelId = parseDcdrVirtualModelId;
+const intent_contract_1 = require("./intent.contract");
+/**
+ * Supported provider backends capable of executing an intent.
+ *
+ * These represent the underlying execution engines used by the runtime.
+ * A provider may represent:
+ *
+ * - A hosted LLM service (OpenAI, Gemini, Grok, etc.)
+ * - A local inference runtime (OFFICE, OLLAMA, VLLM)
+ * - A specialized processing engine (OCR, CLIP)
+ * - An internal execution system (RULES, HTTP_TOOL)
+ */
+var IntentProvider;
+(function (IntentProvider) {
+    /**
+     * Virtual provider managed by DCDR.
+     *
+     * Notes
+     * - Cloud-only concept: the registry/runtime can resolve the underlying real provider (OpenAI/Anthropic/Gemini/Office).
+     * - Model IDs are namespaced as `provider/model` (e.g. `openai/gpt-4o-mini`) for deterministic resolution.
+     */
+    IntentProvider["DCDR"] = "DCDR";
+    /** OpenAI hosted models (GPT family, embeddings, etc.) */
+    IntentProvider["OPEN_AI"] = "OPEN_AI";
+    /** Google Gemini models */
+    IntentProvider["GEMINI"] = "GEMINI";
+    /** xAI Grok models */
+    IntentProvider["GROK"] = "GROK";
+    /** Anthropic Claude models */
+    IntentProvider["ANTHROPIC"] = "ANTHROPIC";
+    /** Mistral hosted models */
+    IntentProvider["MISTRAL"] = "MISTRAL";
+    /** Cohere models (chat + embeddings) */
+    IntentProvider["COHERE"] = "COHERE";
+    /**
+     * Local inference runtime hosted internally (runtime-managed).
+     *
+     * Notes
+     * - Use this when the runtime/operator controls the endpoint (e.g. office GPU cluster running vLLM).
+     * - If a customer wants to plug in their own OpenAI-compatible endpoint, use OPEN_AI_COMPATIBLE.
+     */
+    IntentProvider["OFFICE"] = "OFFICE";
+    /**
+     * Ollama local inference runtime.
+     * Useful for developer setups and local deployments.
+     */
+    IntentProvider["OLLAMA"] = "OLLAMA";
+    /**
+     * Generic OpenAI-compatible endpoint (bring-your-own).
+     *
+     * Goal
+     * - Allow customers to plug in internal systems that expose an OpenAI-style API.
+     *
+     * Examples
+     * - vLLM, TGI, LM Studio, or custom gateways that mimic the OpenAI schema.
+     */
+    IntentProvider["OPEN_AI_COMPATIBLE"] = "OPEN_AI_COMPATIBLE";
+    /**
+     * Optical character recognition engine.
+     */
+    IntentProvider["OCR"] = "OCR";
+    /**
+     * CLIP-like models for multimodal embedding.
+     */
+    IntentProvider["CLIP"] = "CLIP";
+    /**
+     * Generic HTTP tool provider.
+     * Used to call external APIs or services.
+     */
+    IntentProvider["HTTP_TOOL"] = "HTTP_TOOL";
+    /**
+     * Internal rule-based execution engine.
+     * Used for deterministic logic instead of LLMs.
+     */
+    IntentProvider["RULES"] = "RULES";
+})(IntentProvider || (exports.IntentProvider = IntentProvider = {}));
+/** Runtime-level support status for a (provider, modelId) pair. */
+var ProviderModelRuntimeSupportStatus;
+(function (ProviderModelRuntimeSupportStatus) {
+    /** Supported by this runtime (intended to work). */
+    ProviderModelRuntimeSupportStatus["SUPPORTED"] = "SUPPORTED";
+    /** Explicitly not supported by this runtime (do not attempt provider calls). */
+    ProviderModelRuntimeSupportStatus["NOT_SUPPORTED"] = "NOT_SUPPORTED";
+    /** Known failing in current runtime; keep visible but treat as unstable. */
+    ProviderModelRuntimeSupportStatus["FAILING"] = "FAILING";
+    /** Under active work; may be partially implemented. */
+    ProviderModelRuntimeSupportStatus["IN_PROGRESS"] = "IN_PROGRESS";
+})(ProviderModelRuntimeSupportStatus || (exports.ProviderModelRuntimeSupportStatus = ProviderModelRuntimeSupportStatus = {}));
+/** Preferred upstream API surface for this model (when provider offers multiple). */
+var ProviderModelPreferredApi;
+(function (ProviderModelPreferredApi) {
+    ProviderModelPreferredApi["CHAT_COMPLETIONS"] = "CHAT_COMPLETIONS";
+    ProviderModelPreferredApi["RESPONSES"] = "RESPONSES";
+})(ProviderModelPreferredApi || (exports.ProviderModelPreferredApi = ProviderModelPreferredApi = {}));
+/** Generic prompt/runtime parameter keys that can be exposed to users (UI) and adapters. */
+var PromptParameterKey;
+(function (PromptParameterKey) {
+    PromptParameterKey["TEMPERATURE"] = "temperature";
+    PromptParameterKey["TOP_P"] = "top_p";
+    PromptParameterKey["TOP_K"] = "top_k";
+    PromptParameterKey["MAX_TOKENS"] = "max_tokens";
+    PromptParameterKey["SEED"] = "seed";
+    PromptParameterKey["ENABLE_THINKING"] = "enable_thinking";
+    PromptParameterKey["RESPONSE_FORMAT"] = "response_format";
+    PromptParameterKey["PRESENCE_PENALTY"] = "presence_penalty";
+    PromptParameterKey["FREQUENCY_PENALTY"] = "frequency_penalty";
+})(PromptParameterKey || (exports.PromptParameterKey = PromptParameterKey = {}));
+/** Runtime-level parameter support status for a specific model. */
+var ProviderModelParameterSupportStatus;
+(function (ProviderModelParameterSupportStatus) {
+    /** Parameter is supported and may be used. */
+    ProviderModelParameterSupportStatus["SUPPORTED"] = "SUPPORTED";
+    /** Parameter is not supported and should not be sent. */
+    ProviderModelParameterSupportStatus["NOT_SUPPORTED"] = "NOT_SUPPORTED";
+    /** Only provider default is supported; runtime should avoid sending custom values. */
+    ProviderModelParameterSupportStatus["DEFAULT_ONLY"] = "DEFAULT_ONLY";
+})(ProviderModelParameterSupportStatus || (exports.ProviderModelParameterSupportStatus = ProviderModelParameterSupportStatus = {}));
+/**
+ * Product-level managed categories for public customer models.
+ *
+ * Purpose
+ * - Provide a stable grouping/filtering abstraction for customer-facing UIs.
+ * - Avoid exposing a flat provider/model list by default.
+ */
+var DcdrPublicModelCategory;
+(function (DcdrPublicModelCategory) {
+    /** Maximum quality / strongest reasoning; typically expensive. */
+    DcdrPublicModelCategory["BEST"] = "BEST";
+    /** Best balance between quality and cost; recommended default for production chat. */
+    DcdrPublicModelCategory["SMART"] = "SMART";
+    /** Low latency; good for interactive chat/support. */
+    DcdrPublicModelCategory["FAST"] = "FAST";
+    /** Lowest cost; good for high-volume simple tasks. */
+    DcdrPublicModelCategory["ECONOMY"] = "ECONOMY";
+    /** Internal/local/company-managed models (self-hosted, Office, etc.). */
+    DcdrPublicModelCategory["PRIVATE"] = "PRIVATE";
+})(DcdrPublicModelCategory || (exports.DcdrPublicModelCategory = DcdrPublicModelCategory = {}));
+const PRICING_UPDATED_AT_20260327 = Date.UTC(2026, 2, 27);
+const PRICING_UPDATED_AT_20260326 = Date.UTC(2026, 2, 26);
+const PRICING_UPDATED_AT_20260430 = Date.UTC(2026, 3, 30);
+const PRICING_UPDATED_AT_20260519 = Date.UTC(2026, 4, 19);
+const PRICING_UPDATED_AT_20260522 = Date.UTC(2026, 4, 22);
+const OPENAI_PRICING_URL = "https://developers.openai.com/api/docs/pricing";
+const XAI_PRICING_URL = "https://docs.x.ai/developers/models";
+const ANTHROPIC_MODELS_URL = "https://platform.claude.com/docs/en/docs/about-claude/models";
+const MISTRAL_MODELS_URL = "https://docs.mistral.ai/getting-started/models/";
+const GEMINI_PRICING_URL = "https://ai.google.dev/gemini-api/docs/pricing";
+const OPENAI_GPT5_PARAMETER_SUPPORT = {
+    parameters: {
+        [PromptParameterKey.TEMPERATURE]: ProviderModelParameterSupportStatus.DEFAULT_ONLY,
+        [PromptParameterKey.TOP_P]: ProviderModelParameterSupportStatus.DEFAULT_ONLY,
+        [PromptParameterKey.TOP_K]: ProviderModelParameterSupportStatus.NOT_SUPPORTED,
+    },
+    recommended: {
+        // E2E and probes showed that very low budgets (e.g. 16) can yield reasoning-only outputs.
+        minMaxTokens: 64,
+    },
+    notes: "GPT-5 family: avoid custom sampling params; ensure sufficient max_tokens budget.",
+    updatedAt: "2026-04-28",
+};
+const PRICING_FALLBACK_RULES_BY_PROVIDER = {
+    [IntentProvider.DCDR]: [],
+    [IntentProvider.OPEN_AI]: [
+        // Not officially published separately; assume same token pricing as base GPT-5.
+        { match: /^gpt-5-search-api/, baseModelId: "gpt-5" },
+    ],
+    [IntentProvider.ANTHROPIC]: [
+        // Opus/Sonnet/Haiku family pricing is expected to be consistent across close variants.
+        { match: /^claude-opus-4-/, baseModelId: "claude-opus-4-7" },
+        { match: /^claude-sonnet-4-/, baseModelId: "claude-sonnet-4-6" },
+        { match: /^claude-haiku-4-/, baseModelId: "claude-haiku-4-5" },
+    ],
+    [IntentProvider.GEMINI]: [],
+    [IntentProvider.GROK]: [],
+    [IntentProvider.MISTRAL]: [],
+    [IntentProvider.COHERE]: [],
+    [IntentProvider.OFFICE]: [],
+    [IntentProvider.OLLAMA]: [],
+    [IntentProvider.OPEN_AI_COMPATIBLE]: [],
+    [IntentProvider.OCR]: [],
+    [IntentProvider.CLIP]: [],
+    [IntentProvider.HTTP_TOOL]: [],
+    [IntentProvider.RULES]: [],
+};
+const DCDR_VIRTUAL_PROVIDER_PREFIX_BY_PROVIDER = {
+    [IntentProvider.OPEN_AI]: "openai",
+    [IntentProvider.ANTHROPIC]: "anthropic",
+    [IntentProvider.GEMINI]: "gemini",
+    [IntentProvider.OFFICE]: "office",
+};
+const DCDR_VIRTUAL_PROVIDER_BY_PREFIX = {
+    openai: IntentProvider.OPEN_AI,
+    anthropic: IntentProvider.ANTHROPIC,
+    gemini: IntentProvider.GEMINI,
+    office: IntentProvider.OFFICE,
+};
+/**
+ * Formats a DCDR virtual provider model id as `provider/model`.
+ *
+ * Returns an empty string for unsupported provider prefixes.
+ */
+function formatDcdrVirtualModelId(provider, modelId) {
+    const prefix = DCDR_VIRTUAL_PROVIDER_PREFIX_BY_PROVIDER[provider];
+    if (!prefix)
+        return "";
+    const id = String(modelId ?? "").trim();
+    if (!id)
+        return "";
+    return `${prefix}/${id}`;
+}
+/**
+ * Parses a DCDR virtual provider model id of the form `provider/model`.
+ *
+ * Returns null when the id is not a valid DCDR virtual model id.
+ */
+function parseDcdrVirtualModelId(prefixedModelId) {
+    const raw = String(prefixedModelId ?? "").trim();
+    if (!raw)
+        return null;
+    const idx = raw.indexOf("/");
+    if (idx <= 0 || idx >= raw.length - 1)
+        return null;
+    const prefix = raw.slice(0, idx).trim().toLowerCase();
+    const modelId = raw.slice(idx + 1).trim();
+    if (!prefix || !modelId)
+        return null;
+    const provider = DCDR_VIRTUAL_PROVIDER_BY_PREFIX[prefix];
+    if (!provider)
+        return null;
+    return { provider, modelId, prefixedModelId: raw };
+}
+/**
+ * Builds a virtual provider model list for `IntentProvider.DCDR`.
+ *
+ * Goal
+ * - Allow DCDR to reference any model that DCDR runtime explicitly supports.
+ *
+ * Rules
+ * - For hosted providers (OpenAI/Anthropic/Gemini): include only models marked `runtimeSupport.status=SUPPORTED`.
+ * - For `OFFICE`: include all declared models (local/runtime-managed; support is deployment-dependent).
+ * - Stable deterministic ordering: provider order then model declaration order.
+ */
+function buildDcdrVirtualProviderModelDefinitions(modelsByProvider) {
+    const providers = [
+        IntentProvider.OPEN_AI,
+        IntentProvider.ANTHROPIC,
+        IntentProvider.GEMINI,
+        IntentProvider.OFFICE,
+    ];
+    const out = [];
+    for (const provider of providers) {
+        const defs = modelsByProvider[provider] ?? [];
+        for (const def of defs) {
+            const isOffice = provider === IntentProvider.OFFICE;
+            const isSupported = def.runtimeSupport?.status ===
+                ProviderModelRuntimeSupportStatus.SUPPORTED;
+            if (!isOffice && !isSupported)
+                continue;
+            const prefixedId = formatDcdrVirtualModelId(provider, def.id);
+            if (!prefixedId)
+                continue;
+            out.push({
+                ...def,
+                id: prefixedId,
+                publicForCustomers: false,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Canonical provider model catalog (single source of truth).
+ *
+ * Note: This is a curated snapshot of commonly used official model IDs (updated March 2026).
+ * Providers may add/deprecate models frequently; keep this list in sync with vendor docs.
+ */
+const PROVIDER_MODEL_DEFINITIONS_BY_PROVIDER_RAW = {
+    [IntentProvider.DCDR]: [],
+    [IntentProvider.OPEN_AI]: [
+        // Pricing snapshot: OpenAI pricing page, updatedAt=2026-03-27
+        // Model IDs below are kept in roughly "newest first" order.
+        // Discovered aliases are sourced from OpenAI `GET /v1/models` (snapshot 2026-04-27).
+        // --- gpt-5.5 (discovered; priced) ---
+        {
+            id: "gpt-5.5",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Best",
+            badge: "OpenAI",
+            primaryCategory: DcdrPublicModelCategory.BEST,
+            categories: [DcdrPublicModelCategory.BEST],
+            qualityTier: 5,
+            speedTier: 3,
+            costTier: 1,
+            recommendedUseCases: ["reasoning", "agentic_coding"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: true,
+            pricing: pricingPerMillionTokens({
+                input: 5.0,
+                cachedInput: 0.5,
+                output: 30.0,
+                tiers: [
+                    {
+                        name: "long_context",
+                        condition: "Long context",
+                        input: 10.0,
+                        cachedInput: 1.0,
+                        output: 45.0,
+                    },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.5-2026-04-23",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.5-pro",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 30.0,
+                output: 180.0,
+                tiers: [
+                    {
+                        name: "long_context",
+                        condition: "Long context",
+                        input: 60.0,
+                        output: 270.0,
+                    },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.5-pro-2026-04-23",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        // --- gpt-5.4 (discovered; priced) ---
+        {
+            id: "gpt-5.4",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Smart",
+            badge: "Recommended",
+            primaryCategory: DcdrPublicModelCategory.SMART,
+            categories: [DcdrPublicModelCategory.SMART, DcdrPublicModelCategory.BEST],
+            qualityTier: 4,
+            speedTier: 4,
+            costTier: 3,
+            recommendedUseCases: ["production_chat", "coding", "reasoning"],
+            isRecommended: true,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingPerMillionTokens({
+                input: 2.5,
+                cachedInput: 0.25,
+                output: 15.0,
+                tiers: [
+                    {
+                        name: "long_context",
+                        condition: "Long context",
+                        input: 5.0,
+                        cachedInput: 0.5,
+                        output: 22.5,
+                    },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.4-2026-03-05",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.4-mini",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Fast",
+            badge: "OpenAI",
+            primaryCategory: DcdrPublicModelCategory.FAST,
+            categories: [
+                DcdrPublicModelCategory.FAST,
+                DcdrPublicModelCategory.ECONOMY,
+            ],
+            qualityTier: 3,
+            speedTier: 5,
+            costTier: 4,
+            recommendedUseCases: ["interactive_chat", "support", "rewriting"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: true,
+            pricing: pricingPerMillionTokens({
+                input: 0.75,
+                cachedInput: 0.075,
+                output: 4.5,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.4-mini-2026-03-17",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.4-nano",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Economy",
+            badge: "OpenAI",
+            primaryCategory: DcdrPublicModelCategory.ECONOMY,
+            categories: [DcdrPublicModelCategory.ECONOMY],
+            qualityTier: 2,
+            speedTier: 5,
+            costTier: 5,
+            recommendedUseCases: [
+                "high_volume_extraction",
+                "classification",
+                "rewriting",
+            ],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingPerMillionTokens({
+                input: 0.2,
+                cachedInput: 0.02,
+                output: 1.25,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.4-nano-2026-03-17",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.4-pro",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 30.0,
+                output: 180.0,
+                tiers: [
+                    {
+                        name: "long_context",
+                        condition: "Long context",
+                        input: 60.0,
+                        output: 270.0,
+                    },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.4-pro-2026-03-05",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        // --- gpt-5.3 (discovered; priced) ---
+        {
+            id: "gpt-5.3-chat-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 1.75,
+                cachedInput: 0.175,
+                output: 14.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.3-codex",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 1.75,
+                cachedInput: 0.175,
+                output: 14.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        // --- gpt-5.2 (base IDs are priced; aliases discovered) ---
+        {
+            id: "gpt-5.2",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 1.75,
+                cachedInput: 0.175,
+                output: 14.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.2-2025-12-11",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.2-chat-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.2-codex",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.2-pro",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 21.0,
+                output: 168.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.2-pro-2025-12-11",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        // --- gpt-5.1 (base ID is priced; aliases discovered) ---
+        {
+            id: "gpt-5.1",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 1.25,
+                cachedInput: 0.125,
+                output: 10.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.1-2025-11-13",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.1-chat-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.1-codex",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.1-codex-max",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5.1-codex-mini",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        // --- gpt-5.0 (base IDs are priced; aliases discovered) ---
+        {
+            id: "gpt-5",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 1.25,
+                cachedInput: 0.125,
+                output: 10.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-2025-08-07",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-chat-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-codex",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-mini",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 0.25,
+                cachedInput: 0.025,
+                output: 2.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-mini-2025-08-07",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-nano",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 0.05,
+                cachedInput: 0.005,
+                output: 0.4,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-nano-2025-08-07",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-pro",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 15.0,
+                output: 120.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-pro-2025-10-06",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "OpenAI responses-only model (not supported on /v1/chat/completions)",
+                updatedAt: "2026-04-27",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-search-api",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Not supported by runtime: upstream 5xx on basic calls; structured json_schema not supported",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-5-search-api-2025-10-14",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Not supported by runtime: upstream 5xx on basic calls; structured json_schema not supported",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: OPENAI_GPT5_PARAMETER_SUPPORT,
+        },
+        {
+            id: "gpt-4.1",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 2.0,
+                cachedInput: 0.5,
+                output: 8.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4.1-2025-04-14",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4.1-mini",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 0.4,
+                cachedInput: 0.1,
+                output: 1.6,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4.1-mini-2025-04-14",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4.1-nano",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 0.1,
+                cachedInput: 0.025,
+                output: 0.4,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4.1-nano-2025-04-14",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4o",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 2.5,
+                cachedInput: 1.25,
+                output: 10.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4o-2024-08-06",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4o-2024-11-20",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4o-search-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Search-preview family is not supported by runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-4o-search-preview-2025-03-11",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Search-preview family is not supported by runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-4o-mini",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 0.15,
+                cachedInput: 0.075,
+                output: 0.6,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4o-mini-2024-07-18",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4o-mini-search-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Search-preview family is not supported by runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-4o-mini-search-preview-2025-03-11",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Search-preview family is not supported by runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-4o-2024-05-13",
+            types: [
+                intent_contract_1.IntentType.CHAT,
+                intent_contract_1.IntentType.MULTIMODAL,
+                intent_contract_1.IntentType.IMAGE_ANALYSIS,
+            ],
+            pricing: pricingPerMillionTokens({
+                input: 5.0,
+                output: 15.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E (structured uses prompt-only JSON)",
+                updatedAt: "2026-04-28",
+            },
+            parameterSupport: {
+                parameters: {
+                    [PromptParameterKey.RESPONSE_FORMAT]: ProviderModelParameterSupportStatus.NOT_SUPPORTED,
+                },
+                notes: "This model version rejects response_format=json_schema; use prompt-only JSON + local parse.",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4-turbo",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4-turbo-2024-04-09",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 10.0,
+                output: 30.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-4-0613",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 30.0,
+                output: 60.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-3.5-turbo",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 0.5,
+                output: 1.5,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-3.5-turbo-0125",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 0.5,
+                output: 1.5,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-3.5-turbo-1106",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 1.0,
+                output: 2.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "gpt-3.5-turbo-16k",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 3.0,
+                output: 4.0,
+                sourceUrl: OPENAI_PRICING_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.CHAT_COMPLETIONS,
+                reason: "Validated via provider E2E",
+                updatedAt: "2026-04-28",
+            },
+        },
+        // --- o-series (reasoning; exposed in /v1/models as o*) ---
+        {
+            id: "o4-mini",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 1.1,
+                cachedInput: 0.275,
+                output: 4.4,
+                sourceUrl: OPENAI_PRICING_URL,
+                notes: "Reasoning-family model",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o4-mini-2025-04-16",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o4-mini-deep-research",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Deep-research family requires specialized tool wiring (not supported in runtime v1)",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "o4-mini-deep-research-2025-06-26",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Deep-research family requires specialized tool wiring (not supported in runtime v1)",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "o3-pro",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 20.0,
+                output: 80.0,
+                sourceUrl: OPENAI_PRICING_URL,
+                notes: "Reasoning-family model",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o3-pro-2025-06-10",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o3",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 2.0,
+                cachedInput: 0.5,
+                output: 8.0,
+                sourceUrl: OPENAI_PRICING_URL,
+                notes: "Reasoning-family model",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o3-2025-04-16",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o3-deep-research",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Deep-research family requires specialized tool wiring (not supported in runtime v1)",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "o3-deep-research-2025-06-26",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Deep-research family requires specialized tool wiring (not supported in runtime v1)",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "o3-mini",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 1.1,
+                cachedInput: 0.55,
+                output: 4.4,
+                sourceUrl: OPENAI_PRICING_URL,
+                notes: "Reasoning-family model",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o3-mini-2025-01-31",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o1-pro",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 150.0,
+                output: 600.0,
+                sourceUrl: OPENAI_PRICING_URL,
+                notes: "Reasoning-family model",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o1-pro-2025-03-19",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o1",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 15.0,
+                cachedInput: 7.5,
+                output: 60.0,
+                sourceUrl: OPENAI_PRICING_URL,
+                notes: "Reasoning-family model",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        {
+            id: "o1-mini",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 1.1,
+                cachedInput: 0.55,
+                output: 4.4,
+                sourceUrl: OPENAI_PRICING_URL,
+                notes: "Reasoning-family model",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Provider E2E: OpenAI returned model_not_found (account/region gated or retired for this key)",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "o1-2024-12-17",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                preferredApi: ProviderModelPreferredApi.RESPONSES,
+                reason: "Validated via provider E2E; routed via OpenAI Responses API",
+                updatedAt: "2026-04-28",
+            },
+        },
+        // Other OpenAI models (pricing varies by endpoint/unit; fill as needed)
+        { id: "text-embedding-3-small", types: [intent_contract_1.IntentType.EMBEDDING] },
+        { id: "text-embedding-3-large", types: [intent_contract_1.IntentType.EMBEDDING] },
+        { id: "text-embedding-ada-002", types: [intent_contract_1.IntentType.EMBEDDING] },
+        {
+            id: "gpt-image-1",
+            types: [intent_contract_1.IntentType.IMAGE_GENERATION],
+            pricing: pricingPerMillionTokens({
+                // OpenAI pricing table (standard) exposes per-modality rows; this entry captures the Image modality.
+                input: 10,
+                cachedInput: 2.5,
+                output: 40,
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "Image modality pricing from OpenAI table; text-row output is '-'",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement image generation adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-image-1.5",
+            types: [intent_contract_1.IntentType.IMAGE_GENERATION],
+            pricing: pricingPerMillionTokens({
+                input: 8,
+                cachedInput: 2,
+                output: 32,
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "Image modality pricing from OpenAI table",
+            }),
+        },
+        {
+            id: "gpt-image-1-mini",
+            types: [intent_contract_1.IntentType.IMAGE_GENERATION],
+            pricing: pricingPerMillionTokens({
+                input: 2.5,
+                cachedInput: 0.25,
+                output: 8,
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "Image modality pricing from OpenAI table; text-row output is '-'",
+            }),
+        },
+        {
+            id: "gpt-image-2",
+            types: [intent_contract_1.IntentType.IMAGE_GENERATION],
+            pricing: pricingPerMillionTokens({
+                input: 8,
+                cachedInput: 2,
+                output: 30,
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "Image modality pricing from OpenAI table; text-row output is '-'",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement image generation adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-image-2-2026-04-21",
+            types: [intent_contract_1.IntentType.IMAGE_GENERATION],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement image generation adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        { id: "dall-e-3", types: [intent_contract_1.IntentType.IMAGE_GENERATION] },
+        { id: "dall-e-2", types: [intent_contract_1.IntentType.IMAGE_GENERATION] },
+        { id: "gpt-4o-transcribe", types: [intent_contract_1.IntentType.SPEECH_TO_TEXT] },
+        { id: "gpt-4o-mini-transcribe", types: [intent_contract_1.IntentType.SPEECH_TO_TEXT] },
+        {
+            id: "gpt-4o-mini-transcribe-2025-03-20",
+            types: [intent_contract_1.IntentType.SPEECH_TO_TEXT],
+        },
+        {
+            id: "gpt-4o-mini-transcribe-2025-12-15",
+            types: [intent_contract_1.IntentType.SPEECH_TO_TEXT],
+        },
+        { id: "gpt-4o-transcribe-diarize", types: [intent_contract_1.IntentType.SPEECH_TO_TEXT] },
+        { id: "whisper-1", types: [intent_contract_1.IntentType.SPEECH_TO_TEXT] },
+        { id: "gpt-4o-mini-tts", types: [intent_contract_1.IntentType.TEXT_TO_SPEECH] },
+        { id: "gpt-4o-mini-tts-2025-03-20", types: [intent_contract_1.IntentType.TEXT_TO_SPEECH] },
+        { id: "gpt-4o-mini-tts-2025-12-15", types: [intent_contract_1.IntentType.TEXT_TO_SPEECH] },
+        { id: "tts-1", types: [intent_contract_1.IntentType.TEXT_TO_SPEECH] },
+        { id: "tts-1-hd", types: [intent_contract_1.IntentType.TEXT_TO_SPEECH] },
+        {
+            id: "gpt-audio",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingPerMillionTokens({
+                // Base = Text modality; audio modality captured as a tier.
+                input: 2.5,
+                output: 10,
+                tiers: [
+                    { name: "audio", condition: "Audio modality", input: 32, output: 64 },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table provides separate Text/Audio modality rows; cached input is '-'",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement audio/multimodal adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-audio-1.5",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingPerMillionTokens({
+                input: 2.5,
+                output: 10,
+                tiers: [
+                    { name: "audio", condition: "Audio modality", input: 32, output: 64 },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table provides separate Text/Audio modality rows; cached input is '-'",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement audio/multimodal adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-audio-2025-08-28",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement audio/multimodal adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-audio-mini",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingPerMillionTokens({
+                input: 0.6,
+                output: 2.4,
+                tiers: [
+                    { name: "audio", condition: "Audio modality", input: 10, output: 20 },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table provides separate Text/Audio modality rows; cached input is '-'",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement audio/multimodal adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-audio-mini-2025-10-06",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement audio/multimodal adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-audio-mini-2025-12-15",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; runtime v1 does not yet implement audio/multimodal adapters",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-realtime",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingPerMillionTokens({
+                // Base = Text modality; audio modality captured as a tier.
+                input: 4,
+                cachedInput: 0.4,
+                output: 16,
+                tiers: [
+                    {
+                        name: "audio",
+                        condition: "Audio modality",
+                        input: 32,
+                        cachedInput: 0.4,
+                        output: 64,
+                    },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table provides separate Text/Audio modality rows",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; realtime adapters not implemented in runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-realtime-2",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingPerMillionTokens({
+                input: 4,
+                cachedInput: 0.4,
+                output: 24,
+                tiers: [
+                    {
+                        name: "audio",
+                        condition: "Audio modality",
+                        input: 32,
+                        cachedInput: 0.4,
+                        output: 64,
+                    },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table provides separate Text/Audio modality rows",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; realtime adapters not implemented in runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-realtime-2025-08-28",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; realtime adapters not implemented in runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-realtime-1.5",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingPerMillionTokens({
+                input: 4,
+                cachedInput: 0.4,
+                output: 16,
+                tiers: [
+                    {
+                        name: "audio",
+                        condition: "Audio modality",
+                        input: 32,
+                        cachedInput: 0.4,
+                        output: 64,
+                    },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table provides separate Text/Audio modality rows",
+            }),
+        },
+        {
+            id: "gpt-realtime-mini",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingPerMillionTokens({
+                input: 0.6,
+                cachedInput: 0.3,
+                output: 2.4,
+                tiers: [
+                    { name: "audio", condition: "Audio modality", input: 10, output: 20 },
+                ],
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table provides separate Text/Audio modality rows; audio row has no cached input",
+            }),
+        },
+        {
+            id: "gpt-realtime-mini-2025-10-06",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; realtime adapters not implemented in runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-realtime-mini-2025-12-15",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; realtime adapters not implemented in runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-realtime-translate",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingAudioMinutesPerMinute({
+                input: 0.034,
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table: $0.034 / minute",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; realtime adapters not implemented in runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gpt-realtime-whisper",
+            types: [intent_contract_1.IntentType.MULTIMODAL],
+            pricing: pricingAudioMinutesPerMinute({
+                input: 0.017,
+                sourceUrl: OPENAI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260522,
+                notes: "OpenAI pricing table: $0.017 / minute",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.IN_PROGRESS,
+                reason: "Discovered via /v1/models; realtime adapters not implemented in runtime v1",
+                updatedAt: "2026-05-22",
+            },
+        },
+    ],
+    [IntentProvider.GEMINI]: [
+        // Source: Gemini Models API (`npm run gemini-models:sync`), updated 2026-05-04
+        // Notes:
+        // - DCDR runtime v1 implements Gemini for CHAT only (via generateContent / generateContentStream).
+        // - Embedding models are cataloged as EMBEDDING, but the runtime does not yet implement a Gemini embedding adapter.
+        // --- Validated starter model ---
+        {
+            id: "gemini-2.5-flash",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Economy",
+            badge: "Fast",
+            primaryCategory: DcdrPublicModelCategory.ECONOMY,
+            categories: [
+                DcdrPublicModelCategory.ECONOMY,
+                DcdrPublicModelCategory.FAST,
+            ],
+            qualityTier: 3,
+            speedTier: 4,
+            costTier: 5,
+            recommendedUseCases: ["high_volume_chat", "extraction", "classification"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: true,
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.3,
+                output: 2.5,
+                tiers: [{ name: "audio", condition: "audio", input: 1.0, output: 2.5 }],
+                notes: "Prices may differ by modality; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // --- Newer preview families (pending E2E curation) ---
+        // Discovered via Gemini Models API (2026-05-22).
+        {
+            id: "gemini-3.5-flash",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Smart",
+            badge: "Fast",
+            primaryCategory: DcdrPublicModelCategory.SMART,
+            categories: [DcdrPublicModelCategory.SMART, DcdrPublicModelCategory.FAST],
+            qualityTier: 4,
+            speedTier: 5,
+            costTier: 4,
+            recommendedUseCases: ["production_chat", "interactive_chat", "support"],
+            isRecommended: true,
+            isGlobalDefault: true,
+            isCategoryDefault: true,
+            pricing: pricingGeminiPerMillionTokens({
+                input: 1.5,
+                output: 9.0,
+                notes: "Output price includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured); requires default thinking disable under small token budgets",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gemini-3.1-pro-preview-customtools",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 2.0,
+                output: 12.0,
+                tiers: [
+                    {
+                        name: "prompts <= 200k",
+                        condition: "prompts <= 200k tokens",
+                        input: 2.0,
+                        output: 12.0,
+                    },
+                    {
+                        name: "prompts > 200k",
+                        condition: "prompts > 200k tokens",
+                        input: 4.0,
+                        output: 18.0,
+                    },
+                ],
+                notes: "Output price includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE) with larger token budgets; model uses thinking",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-3.1-pro-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Best",
+            badge: "Gemini",
+            primaryCategory: DcdrPublicModelCategory.BEST,
+            categories: [DcdrPublicModelCategory.BEST],
+            qualityTier: 5,
+            speedTier: 3,
+            costTier: 3,
+            recommendedUseCases: ["reasoning", "agentic_coding", "long_context"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingGeminiPerMillionTokens({
+                input: 2.0,
+                output: 12.0,
+                tiers: [
+                    {
+                        name: "prompts <= 200k",
+                        condition: "prompts <= 200k tokens",
+                        input: 2.0,
+                        output: 12.0,
+                    },
+                    {
+                        name: "prompts > 200k",
+                        condition: "prompts > 200k tokens",
+                        input: 4.0,
+                        output: 18.0,
+                    },
+                ],
+                notes: "Output price includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE) with larger token budgets; model uses thinking",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-3.1-flash-tts-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 1.0,
+                output: 20.0,
+                notes: "TTS preview: output billed as audio tokens (docs: ~25 tokens/sec).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Rejects developer/system instruction in runtime prompt shape (400 INVALID_ARGUMENT)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-3.1-flash-live-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.75,
+                output: 4.5,
+                tiers: [
+                    { name: "audio", condition: "audio", input: 3.0, output: 12.0 },
+                    {
+                        name: "image/video",
+                        condition: "image/video",
+                        input: 1.0,
+                        output: 4.5,
+                    },
+                ],
+                notes: "Live preview pricing varies by modality; docs also list per-minute rates for audio/video.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Model/endpoint not found (404) in provider E2E for this account",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-3.1-flash-lite-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.25,
+                output: 1.5,
+                tiers: [{ name: "audio", condition: "audio", input: 0.5, output: 1.5 }],
+                notes: "Prices may differ by modality; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // Discovered via Gemini Models API (2026-05-22).
+        {
+            id: "gemini-3.1-flash-lite",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured)",
+                updatedAt: "2026-05-22",
+            },
+        },
+        {
+            id: "gemini-3.1-flash-image-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.5,
+                output: 3.0,
+                notes: "Image-preview model; docs list separate image output pricing (not modeled here).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-3-pro-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: {
+                ...pricingGeminiPerMillionTokens({
+                    input: 2.0,
+                    output: 12.0,
+                    tiers: [
+                        {
+                            name: "prompts <= 200k",
+                            condition: "prompts <= 200k tokens",
+                            input: 2.0,
+                            output: 12.0,
+                        },
+                        {
+                            name: "prompts > 200k",
+                            condition: "prompts > 200k tokens",
+                            input: 4.0,
+                            output: 18.0,
+                        },
+                    ],
+                    notes: "Output price includes thinking tokens.",
+                }),
+                confidence: "approx",
+                notes: "Not explicitly listed on pricing page; approximated from Gemini 3.1 Pro Preview.",
+            },
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-3-pro-image-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 2.0,
+                output: 12.0,
+                tiers: [
+                    {
+                        name: "prompts <= 200k",
+                        condition: "prompts <= 200k tokens",
+                        input: 2.0,
+                        output: 12.0,
+                    },
+                    {
+                        name: "prompts > 200k",
+                        condition: "prompts > 200k tokens",
+                        input: 4.0,
+                        output: 18.0,
+                    },
+                ],
+                notes: "Image generation model; text pricing is the same as Gemini 3.1 Pro (image output priced separately).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Structured mode returned empty text in provider E2E (streaming SSE OK)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-3-flash-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Fast",
+            badge: "Gemini",
+            primaryCategory: DcdrPublicModelCategory.FAST,
+            categories: [
+                DcdrPublicModelCategory.FAST,
+                DcdrPublicModelCategory.ECONOMY,
+            ],
+            qualityTier: 3,
+            speedTier: 5,
+            costTier: 4,
+            recommendedUseCases: ["interactive_chat", "support", "rewriting"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.5,
+                output: 3.0,
+                tiers: [{ name: "audio", condition: "audio", input: 1.0, output: 3.0 }],
+                notes: "Prices may differ by modality; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // --- 2.5 family variants (pending E2E curation) ---
+        {
+            id: "gemini-2.5-pro",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 1.25,
+                output: 10.0,
+                tiers: [
+                    {
+                        name: "prompts <= 200k",
+                        condition: "prompts <= 200k tokens",
+                        input: 1.25,
+                        output: 10.0,
+                    },
+                    {
+                        name: "prompts > 200k",
+                        condition: "prompts > 200k tokens",
+                        input: 2.5,
+                        output: 15.0,
+                    },
+                ],
+                notes: "Output price includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Provider E2E: empty output in text + structured (streaming SSE OK)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-pro-preview-tts",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 1.0,
+                output: 20.0,
+                notes: "TTS preview: output billed as audio tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Audio-only response modality (TEXT unsupported) in provider E2E; runtime v1 is text-only",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-flash-lite",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Economy",
+            badge: "Lowest cost",
+            primaryCategory: DcdrPublicModelCategory.ECONOMY,
+            categories: [DcdrPublicModelCategory.ECONOMY],
+            qualityTier: 2,
+            speedTier: 5,
+            costTier: 5,
+            recommendedUseCases: [
+                "high_volume_extraction",
+                "classification",
+                "rewriting",
+            ],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.1,
+                output: 0.4,
+                tiers: [{ name: "audio", condition: "audio", input: 0.3, output: 0.4 }],
+                notes: "Prices may differ by modality; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-flash-image",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.3,
+                output: 2.5,
+                notes: "Image generation model; docs list separate per-image output pricing (not modeled here).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-flash-native-audio-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.5,
+                output: 2.0,
+                tiers: [
+                    {
+                        name: "audio/video",
+                        condition: "audio/video",
+                        input: 3.0,
+                        output: 12.0,
+                    },
+                ],
+                notes: "Native audio (Live API): docs also list per-minute rates for audio; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Native-audio model (text-only runtime v1); also 404 in provider E2E for this account",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-flash-native-audio-preview-09-2025",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.5,
+                output: 2.0,
+                tiers: [
+                    {
+                        name: "audio/video",
+                        condition: "audio/video",
+                        input: 3.0,
+                        output: 12.0,
+                    },
+                ],
+                notes: "Native audio (Live API): docs also list per-minute rates for audio; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Native-audio model (text-only runtime v1); also 404 in provider E2E for this account",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-flash-native-audio-preview-12-2025",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.5,
+                output: 2.0,
+                tiers: [
+                    {
+                        name: "audio/video",
+                        condition: "audio/video",
+                        input: 3.0,
+                        output: 12.0,
+                    },
+                ],
+                notes: "Native audio (Live API): docs also list per-minute rates for audio; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Native-audio model (text-only runtime v1); also 404 in provider E2E for this account",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-flash-preview-tts",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.5,
+                output: 10.0,
+                notes: "TTS preview: output billed as audio tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Audio-only response modality (TEXT unsupported) in provider E2E; runtime v1 is text-only",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.5-computer-use-preview-10-2025",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 1.25,
+                output: 10.0,
+                tiers: [
+                    {
+                        name: "prompts <= 200k",
+                        condition: "prompts <= 200k tokens",
+                        input: 1.25,
+                        output: 10.0,
+                    },
+                    {
+                        name: "prompts > 200k",
+                        condition: "prompts > 200k tokens",
+                        input: 2.5,
+                        output: 15.0,
+                    },
+                ],
+                notes: "Computer Use model token pricing (tools may have separate charges).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Requires Computer Use tool wiring (not supported in runtime v1)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // --- Older 2.0 family IDs (may appear but can be unavailable to new users) ---
+        {
+            id: "gemini-2.0-flash",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.1,
+                output: 0.4,
+                tiers: [{ name: "audio", condition: "audio", input: 0.7, output: 0.4 }],
+                notes: "Deprecated model family (shutdown noted in docs).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Visible via Models API but may be unavailable to new users (404)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.0-flash-001",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.1,
+                output: 0.4,
+                tiers: [{ name: "audio", condition: "audio", input: 0.7, output: 0.4 }],
+                notes: "Deprecated model family (shutdown noted in docs).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Visible via Models API but may be unavailable to new users (404)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.0-flash-lite",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.075,
+                output: 0.3,
+                notes: "Deprecated model family (shutdown noted in docs).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Visible via Models API but may be unavailable to new users (404)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-2.0-flash-lite-001",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 0.075,
+                output: 0.3,
+                notes: "Deprecated model family (shutdown noted in docs).",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Visible via Models API but may be unavailable to new users (404)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // --- Rolling aliases ---
+        {
+            id: "gemini-flash-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: {
+                ...pricingGeminiPerMillionTokens({
+                    input: 0.3,
+                    output: 2.5,
+                    tiers: [
+                        { name: "audio", condition: "audio", input: 1.0, output: 2.5 },
+                    ],
+                    notes: "Prices may differ by modality; output includes thinking tokens.",
+                }),
+                confidence: "approx",
+                notes: "Rolling alias; priced as Gemini 2.5 Flash (approx).",
+            },
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE) (alias)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-flash-lite-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: {
+                ...pricingGeminiPerMillionTokens({
+                    input: 0.1,
+                    output: 0.4,
+                    tiers: [
+                        { name: "audio", condition: "audio", input: 0.3, output: 0.4 },
+                    ],
+                    notes: "Prices may differ by modality; output includes thinking tokens.",
+                }),
+                confidence: "approx",
+                notes: "Rolling alias; priced as Gemini 2.5 Flash-Lite (approx).",
+            },
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE) (alias)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-pro-latest",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: {
+                ...pricingGeminiPerMillionTokens({
+                    input: 1.25,
+                    output: 10.0,
+                    tiers: [
+                        {
+                            name: "prompts <= 200k",
+                            condition: "prompts <= 200k tokens",
+                            input: 1.25,
+                            output: 10.0,
+                        },
+                        {
+                            name: "prompts > 200k",
+                            condition: "prompts > 200k tokens",
+                            input: 2.5,
+                            output: 15.0,
+                        },
+                    ],
+                    notes: "Output price includes thinking tokens.",
+                }),
+                confidence: "approx",
+                notes: "Rolling alias; priced as Gemini 2.5 Pro (approx).",
+            },
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (text + structured + streaming SSE) (alias)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // --- Robotics models (listed by API; may require special modalities) ---
+        {
+            id: "gemini-robotics-er-1.6-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingGeminiPerMillionTokens({
+                input: 1.0,
+                output: 5.0,
+                tiers: [{ name: "audio", condition: "audio", input: 2.0, output: 5.0 }],
+                notes: "Prices may differ by modality; output includes thinking tokens.",
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Provider E2E: empty output in text + structured + streaming",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-robotics-er-1.5-preview",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.FAILING,
+                reason: "Model/endpoint not found (404) in provider E2E for this account",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // --- Embeddings (cataloged, but runtime adapter not implemented yet) ---
+        {
+            id: "gemini-embedding-2-preview",
+            types: [intent_contract_1.IntentType.EMBEDDING],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Gemini embedding adapter not implemented in runtime v1",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-embedding-2",
+            types: [intent_contract_1.IntentType.EMBEDDING],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Gemini embedding adapter not implemented in runtime v1",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "gemini-embedding-001",
+            types: [intent_contract_1.IntentType.EMBEDDING],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.NOT_SUPPORTED,
+                reason: "Gemini embedding adapter not implemented in runtime v1",
+                updatedAt: "2026-05-04",
+            },
+        },
+    ],
+    [IntentProvider.GROK]: [],
+    [IntentProvider.ANTHROPIC]: [
+        // Source: Anthropic Models overview (latest models comparison), updated 2026-05-04
+        // Note: DCDR runtime v1 treats Anthropic as CHAT-only; multimodal/vision intent types are intentionally not listed yet.
+        {
+            id: "claude-opus-4-7",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Best",
+            badge: "Anthropic",
+            primaryCategory: DcdrPublicModelCategory.BEST,
+            categories: [DcdrPublicModelCategory.BEST],
+            qualityTier: 5,
+            speedTier: 3,
+            costTier: 1,
+            recommendedUseCases: ["reasoning", "agentic_coding"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingPerMillionTokens({
+                input: 5.0,
+                output: 25.0,
+                sourceUrl: ANTHROPIC_MODELS_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // Legacy/stable IDs still visible via Models API for some accounts.
+        {
+            id: "claude-opus-4-6",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "claude-opus-4-5-20251101",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "claude-opus-4-1-20250805",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "claude-sonnet-4-6",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Smart",
+            badge: "Anthropic",
+            primaryCategory: DcdrPublicModelCategory.SMART,
+            categories: [DcdrPublicModelCategory.SMART, DcdrPublicModelCategory.FAST],
+            qualityTier: 4,
+            speedTier: 4,
+            costTier: 3,
+            recommendedUseCases: ["production_chat", "coding", "reasoning"],
+            isRecommended: true,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingPerMillionTokens({
+                input: 3.0,
+                output: 15.0,
+                sourceUrl: ANTHROPIC_MODELS_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "claude-sonnet-4-5-20250929",
+            types: [intent_contract_1.IntentType.CHAT],
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + structured + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        // Haiku is the cheapest/default smoke-test model.
+        {
+            id: "claude-haiku-4-5",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Fast",
+            badge: "Anthropic",
+            primaryCategory: DcdrPublicModelCategory.FAST,
+            categories: [
+                DcdrPublicModelCategory.FAST,
+                DcdrPublicModelCategory.ECONOMY,
+            ],
+            qualityTier: 3,
+            speedTier: 5,
+            costTier: 4,
+            recommendedUseCases: ["interactive_chat", "support", "classification"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: false,
+            pricing: pricingPerMillionTokens({
+                input: 1.0,
+                output: 5.0,
+                sourceUrl: ANTHROPIC_MODELS_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+        {
+            id: "claude-haiku-4-5-20251001",
+            types: [intent_contract_1.IntentType.CHAT],
+            pricing: pricingPerMillionTokens({
+                input: 1.0,
+                output: 5.0,
+                sourceUrl: ANTHROPIC_MODELS_URL,
+            }),
+            runtimeSupport: {
+                status: ProviderModelRuntimeSupportStatus.SUPPORTED,
+                reason: "Validated via provider E2E (run + streaming SSE)",
+                updatedAt: "2026-05-04",
+            },
+        },
+    ],
+    [IntentProvider.MISTRAL]: [],
+    [IntentProvider.COHERE]: [],
+    [IntentProvider.OFFICE]: [
+        // Office = internal/local OpenAI-compatible runtime (vLLM etc.)
+        // Keep IDs aligned with the common local model naming used in registries.
+        {
+            id: "Qwen3-4B-Instruct-2507",
+            types: [intent_contract_1.IntentType.CHAT],
+            publicForCustomers: true,
+            tokenUsageCovered: true,
+            publicName: "DCDR Private",
+            badge: "Local",
+            primaryCategory: DcdrPublicModelCategory.PRIVATE,
+            categories: [
+                DcdrPublicModelCategory.PRIVATE,
+                DcdrPublicModelCategory.ECONOMY,
+                DcdrPublicModelCategory.FAST,
+            ],
+            qualityTier: 2,
+            speedTier: 5,
+            costTier: 5,
+            recommendedUseCases: ["private_data", "on_prem", "high_volume"],
+            isRecommended: false,
+            isGlobalDefault: false,
+            isCategoryDefault: true,
+            pricing: pricingPerMillionTokens({
+                // Synthetic estimate for local models: keep Office cheaper than hosted providers.
+                // Pick round numbers for UI cost guidance.
+                input: 0.05,
+                output: 0.15,
+                sourceUrl: GEMINI_PRICING_URL,
+                updatedAt: PRICING_UPDATED_AT_20260519,
+                confidence: "approx",
+                notes: "Synthetic pricing for local OFFICE provider. For UI cost guidance only.",
+            }),
+        },
+    ],
+    [IntentProvider.OLLAMA]: [],
+    [IntentProvider.OPEN_AI_COMPATIBLE]: [],
+    [IntentProvider.OCR]: [],
+    [IntentProvider.CLIP]: [],
+    [IntentProvider.HTTP_TOOL]: [],
+    [IntentProvider.RULES]: [],
+};
+/**
+ * Token usage coverage overrides derived from provider E2E curation runs.
+ *
+ * Notes
+ * - This is intended to be filled iteratively (in batches) as we validate token usage reporting
+ *   for all `runtimeSupport.status=SUPPORTED` chat models.
+ * - These overrides only apply when a model definition omits `tokenUsageCovered`.
+ *   (Public customer models still require `tokenUsageCovered=true` on the definition itself.)
+ */
+const TOKEN_USAGE_COVERAGE_BY_PROVIDER_AND_ID = {
+    [IntentProvider.OPEN_AI]: {
+        "gpt-5.5-2026-04-23": true,
+        "gpt-5.5-pro": true,
+        "gpt-5.5-pro-2026-04-23": true,
+        "gpt-5.4-2026-03-05": true,
+        "gpt-5.4-mini-2026-03-17": true,
+        "gpt-5.4-nano-2026-03-17": true,
+        "gpt-5.4-pro": true,
+        "gpt-5.4-pro-2026-03-05": true,
+        "gpt-5.3-chat-latest": true,
+        "gpt-5.3-codex": true,
+        "gpt-5.2": true,
+        "gpt-5.2-2025-12-11": true,
+        "gpt-5.2-chat-latest": true,
+        "gpt-5.2-codex": true,
+        "gpt-5.2-pro": true,
+        "gpt-5.2-pro-2025-12-11": true,
+        "gpt-5.1": true,
+        "gpt-5.1-2025-11-13": true,
+        "gpt-5.1-chat-latest": true,
+        "gpt-5.1-codex": true,
+        "gpt-5.1-codex-max": true,
+        "gpt-5.1-codex-mini": true,
+        "gpt-5": true,
+        "gpt-5-2025-08-07": true,
+        "gpt-5-chat-latest": true,
+        "gpt-5-codex": true,
+        "gpt-5-mini": true,
+        "gpt-5-mini-2025-08-07": true,
+        "gpt-5-nano": true,
+        "gpt-5-nano-2025-08-07": true,
+        "gpt-5-pro": true,
+        "gpt-5-pro-2025-10-06": true,
+        "gpt-4.1": true,
+        "gpt-4.1-2025-04-14": true,
+        "gpt-4.1-mini": true,
+        "gpt-4.1-mini-2025-04-14": true,
+        "gpt-4.1-nano": true,
+        "gpt-4.1-nano-2025-04-14": true,
+        "gpt-4o": true,
+        "gpt-4o-2024-08-06": true,
+        "gpt-4o-2024-11-20": true,
+        "gpt-4o-mini": true,
+        "gpt-4o-mini-2024-07-18": true,
+        "gpt-4o-2024-05-13": true,
+        "gpt-4-turbo": true,
+        "gpt-4-turbo-2024-04-09": true,
+        "gpt-4": true,
+        "gpt-4-0613": true,
+        "gpt-3.5-turbo": true,
+        "gpt-3.5-turbo-0125": true,
+        "gpt-3.5-turbo-1106": true,
+        "gpt-3.5-turbo-16k": true,
+        "o4-mini": true,
+        "o4-mini-2025-04-16": true,
+        "o3-pro": true,
+        "o3-pro-2025-06-10": true,
+        o3: true,
+        "o3-2025-04-16": true,
+        "o3-mini": true,
+        "o3-mini-2025-01-31": true,
+        "o1-pro": true,
+        "o1-pro-2025-03-19": true,
+        o1: true,
+        "o1-2024-12-17": true,
+    },
+    [IntentProvider.GEMINI]: {
+        "gemini-3.1-pro-preview-customtools": true,
+        "gemini-3.1-flash-lite-preview": true,
+        "gemini-3.1-flash-lite": true,
+        "gemini-3.1-flash-image-preview": true,
+        "gemini-3-pro-preview": false,
+        "gemini-2.5-flash-image": true,
+        "gemini-flash-latest": true,
+        "gemini-flash-lite-latest": true,
+        "gemini-pro-latest": true,
+    },
+    [IntentProvider.ANTHROPIC]: {
+        "claude-opus-4-6": true,
+        "claude-opus-4-5-20251101": true,
+        "claude-opus-4-1-20250805": true,
+        "claude-sonnet-4-5-20250929": true,
+        "claude-haiku-4-5-20251001": true,
+    },
+    [IntentProvider.OFFICE]: {},
+};
+function getTokenUsageCoveredOverride(provider, modelId) {
+    return TOKEN_USAGE_COVERAGE_BY_PROVIDER_AND_ID[provider]?.[modelId];
+}
+/** Normalizes catalog entries so optional flags become required (fail-closed). */
+function normalizeProviderModelDefinitions(modelsByProvider) {
+    const out = {};
+    let globalDefaultCount = 0;
+    const categoryDefaultCounts = new Map();
+    const categoriesWithPublicModels = new Set();
+    const assertTier = (provider, modelId, field, value) => {
+        if (!Number.isFinite(value)) {
+            throw new Error(`Provider model catalog: ${provider}/${modelId} ${field} must be a finite number (1..5).`);
+        }
+        const n = Math.trunc(value);
+        if (n !== value || n < 1 || n > 5) {
+            throw new Error(`Provider model catalog: ${provider}/${modelId} ${field} must be an integer in range 1..5.`);
+        }
+    };
+    const assertNoLegacyManagedFields = (provider, modelId, def) => {
+        const d = def;
+        const legacyFields = [
+            "publicDisplayName",
+            "isRecommendedDefault",
+            "default",
+        ];
+        for (const f of legacyFields) {
+            if (Object.prototype.hasOwnProperty.call(d, f)) {
+                throw new Error(`Provider model catalog: ${provider}/${modelId} must not include legacy field '${f}'.`);
+            }
+        }
+    };
+    const assertNonEmptyStringArray = (provider, modelId, field, value) => {
+        if (!Array.isArray(value) || value.length === 0) {
+            throw new Error(`Provider model catalog: ${provider}/${modelId} ${field} must be a non-empty string array.`);
+        }
+        for (const v of value) {
+            if (typeof v !== "string" || !v.trim()) {
+                throw new Error(`Provider model catalog: ${provider}/${modelId} ${field} must contain only non-empty strings.`);
+            }
+        }
+    };
+    for (const provider of Object.values(IntentProvider)) {
+        const defs = modelsByProvider[provider] ?? [];
+        const ids = new Set();
+        out[provider] = defs.map((def) => {
+            assertNoLegacyManagedFields(provider, def.id, def);
+            if (ids.has(def.id)) {
+                throw new Error(`Provider model catalog: duplicate modelId '${def.id}' for provider ${provider}.`);
+            }
+            ids.add(def.id);
+            const tokenUsageCoveredOverride = getTokenUsageCoveredOverride(provider, def.id);
+            const normalized = {
+                ...def,
+                publicForCustomers: def.publicForCustomers === true,
+                tokenUsageCovered: def.tokenUsageCovered ?? tokenUsageCoveredOverride,
+            };
+            if (normalized.publicForCustomers) {
+                if (normalized.tokenUsageCovered !== true) {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} tokenUsageCovered=true is required for publicForCustomers models.`);
+                }
+                if (!normalized.publicName?.trim()) {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} publicName is required for publicForCustomers models.`);
+                }
+                if (!normalized.primaryCategory) {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} primaryCategory is required for publicForCustomers models.`);
+                }
+                if (!Array.isArray(normalized.categories) ||
+                    normalized.categories.length === 0) {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} categories is required for publicForCustomers models.`);
+                }
+                if (!normalized.categories.includes(normalized.primaryCategory)) {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} categories must include primaryCategory (${normalized.primaryCategory}).`);
+                }
+                categoriesWithPublicModels.add(normalized.primaryCategory);
+                if (typeof normalized.isRecommended !== "boolean") {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} isRecommended is required for publicForCustomers models.`);
+                }
+                if (typeof normalized.isGlobalDefault !== "boolean") {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} isGlobalDefault is required for publicForCustomers models.`);
+                }
+                if (typeof normalized.isCategoryDefault !== "boolean") {
+                    throw new Error(`Provider model catalog: ${provider}/${normalized.id} isCategoryDefault is required for publicForCustomers models.`);
+                }
+                if (normalized.isGlobalDefault)
+                    globalDefaultCount += 1;
+                if (normalized.isCategoryDefault) {
+                    const c = normalized.primaryCategory;
+                    const prev = categoryDefaultCounts.get(c) ?? 0;
+                    categoryDefaultCounts.set(c, prev + 1);
+                }
+                assertTier(provider, normalized.id, "qualityTier", normalized.qualityTier ?? Number.NaN);
+                assertTier(provider, normalized.id, "speedTier", normalized.speedTier ?? Number.NaN);
+                assertTier(provider, normalized.id, "costTier", normalized.costTier ?? Number.NaN);
+                assertNonEmptyStringArray(provider, normalized.id, "recommendedUseCases", normalized.recommendedUseCases ?? []);
+            }
+            return normalized;
+        });
+    }
+    if (globalDefaultCount !== 1) {
+        throw new Error(`Provider model catalog: expected exactly one public model with isGlobalDefault=true, found ${globalDefaultCount}.`);
+    }
+    for (const c of categoriesWithPublicModels) {
+        const count = categoryDefaultCounts.get(c) ?? 0;
+        if (count <= 0) {
+            throw new Error(`Provider model catalog: expected at least one public model with isCategoryDefault=true for primaryCategory ${c}.`);
+        }
+    }
+    return out;
+}
+/**
+ * Canonical provider model catalog (after enrichment passes).
+ */
+exports.PROVIDER_MODEL_DEFINITIONS_BY_PROVIDER = (() => {
+    const base = fillMissingPricingFromBaseModels(PROVIDER_MODEL_DEFINITIONS_BY_PROVIDER_RAW);
+    const normalized = normalizeProviderModelDefinitions(base);
+    return {
+        ...normalized,
+        [IntentProvider.DCDR]: buildDcdrVirtualProviderModelDefinitions(normalized),
+    };
+})();
+const _PROVIDER_MODEL_INDEXES = buildProviderModelCatalogAndTypeIndex(exports.PROVIDER_MODEL_DEFINITIONS_BY_PROVIDER);
+/**
+ * Canonical lookup: provider -> modelId -> model definition.
+ */
+exports.PROVIDER_MODEL_CATALOG = _PROVIDER_MODEL_INDEXES.catalog;
+/**
+ * Primary listing structure (no duplicated metadata): provider -> intent type -> model IDs.
+ */
+exports.PROVIDER_MODEL_IDS_BY_PROVIDER_AND_TYPE = _PROVIDER_MODEL_INDEXES.idsByType;
+/**
+ * E2E model status used by provider test suites.
+ *
+ * Notes
+ * - This is an opt-in testing mechanism; it does not affect runtime behavior.
+ * - Use `LEGACY` to explicitly skip obsolete/retired model IDs while still keeping them
+ *   discoverable in the catalog for historical compatibility.
+ */
+var ProviderModelE2EStatus;
+(function (ProviderModelE2EStatus) {
+    /** Model should be exercised by E2E suites (when provider is implemented and credentials exist). */
+    ProviderModelE2EStatus["ACTIVE"] = "ACTIVE";
+    /** Model is considered legacy/obsolete and may be skipped by E2E suites. */
+    ProviderModelE2EStatus["LEGACY"] = "LEGACY";
+})(ProviderModelE2EStatus || (exports.ProviderModelE2EStatus = ProviderModelE2EStatus = {}));
+/**
+ * Optional provider-model overrides consumed by the provider E2E matrix tests.
+ *
+ * How to use
+ * - When a model ID becomes obsolete/retired, mark it as `LEGACY` with a reason.
+ * - The E2E suite will still enumerate it (catalog stays complete) but will skip execution.
+ */
+exports.PROVIDER_MODEL_E2E_OVERRIDES = {
+    [IntentProvider.DCDR]: {},
+    [IntentProvider.OPEN_AI]: {
+        // Not chat-completions models (will 404 on /v1/chat/completions)
+        "babbage-002": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Not a chat-completions model",
+        },
+        "davinci-002": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Not a chat-completions model",
+        },
+        "gpt-3.5-turbo-instruct": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Not a chat-completions model",
+        },
+        "gpt-3.5-turbo-instruct-0914": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Not a chat-completions model",
+        },
+        // Listed in some OpenAI pricing/docs snapshots but not visible/callable for many accounts (model_not_found).
+        "o1-mini": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Listed but not callable for many accounts (model_not_found)",
+        },
+        // OpenAI lists moderation-only models under /v1/models; runtime does not expose a moderation intent type.
+        "omni-moderation-latest": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Moderation-only model (no IntentType mapping in runtime)",
+        },
+        "omni-moderation-2024-09-26": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Moderation-only model (no IntentType mapping in runtime)",
+        },
+    },
+    [IntentProvider.GEMINI]: {
+        // Listed by the Models API but not callable for many accounts (404).
+        "gemini-2.0-flash": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Listed but not callable for many accounts (404)",
+        },
+        "gemini-2.0-flash-001": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Listed but not callable for many accounts (404)",
+        },
+        "gemini-2.0-flash-lite": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Listed but not callable for many accounts (404)",
+        },
+        "gemini-2.0-flash-lite-001": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Listed but not callable for many accounts (404)",
+        },
+        // Preview/live endpoint variants can be account-gated or missing.
+        "gemini-3.1-flash-live-preview": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Model/endpoint not found (404) in provider E2E",
+        },
+        // Requires explicit Computer Use tooling.
+        "gemini-2.5-computer-use-preview-10-2025": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Requires Computer Use tool wiring (not supported in runtime v1)",
+        },
+        // Audio-only response modalities (runtime v1 is text-only).
+        "gemini-2.5-pro-preview-tts": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Audio-only response modality (TEXT unsupported)",
+        },
+        "gemini-2.5-flash-preview-tts": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Audio-only response modality (TEXT unsupported)",
+        },
+        "gemini-2.5-flash-native-audio-latest": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Native-audio model (text-only runtime)",
+        },
+        "gemini-2.5-flash-native-audio-preview-09-2025": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Native-audio model (text-only runtime)",
+        },
+        "gemini-2.5-flash-native-audio-preview-12-2025": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Native-audio model (text-only runtime)",
+        },
+        // Some robotics preview IDs appear/disappear across accounts.
+        "gemini-robotics-er-1.5-preview": {
+            status: ProviderModelE2EStatus.LEGACY,
+            reason: "Model/endpoint not found (404) in provider E2E",
+        },
+    },
+    [IntentProvider.GROK]: {},
+    [IntentProvider.ANTHROPIC]: {},
+    [IntentProvider.MISTRAL]: {},
+    [IntentProvider.COHERE]: {},
+    [IntentProvider.OFFICE]: {},
+    [IntentProvider.OLLAMA]: {},
+    [IntentProvider.OPEN_AI_COMPATIBLE]: {},
+    [IntentProvider.OCR]: {},
+    [IntentProvider.CLIP]: {},
+    [IntentProvider.HTTP_TOOL]: {},
+    [IntentProvider.RULES]: {},
+};
+function pricingPerMillionTokens(args) {
+    return {
+        currency: "USD",
+        sourceUrl: args.sourceUrl,
+        updatedAt: args.updatedAt ?? PRICING_UPDATED_AT_20260327,
+        confidence: args.confidence ?? "official",
+        notes: args.notes,
+        components: [
+            {
+                kind: "tokens",
+                unit: "per_million_tokens",
+                input: args.input,
+                outputUsd: args.output,
+                cachedInput: args.cachedInput,
+                cachedOutput: args.cachedOutput,
+                tiers: args.tiers,
+            },
+        ],
+    };
+}
+/**
+ * Gemini token pricing helper.
+ *
+ * Notes
+ * - Uses the Gemini Developer API pricing page as the canonical source.
+ * - Pricing tables sometimes vary by modality (text vs audio) and/or prompt size (<=200k vs >200k tokens).
+ *   We represent those as `tiers` with a human-readable condition.
+ */
+function pricingGeminiPerMillionTokens(args) {
+    return pricingPerMillionTokens({
+        input: args.input,
+        output: args.output,
+        tiers: args.tiers,
+        sourceUrl: GEMINI_PRICING_URL,
+        // Gemini pricing page last updated 2026-05-19 UTC.
+        updatedAt: PRICING_UPDATED_AT_20260519,
+        confidence: "official",
+        notes: args.notes,
+    });
+}
+function pricingAudioMinutesPerMinute(args) {
+    return {
+        currency: "USD",
+        sourceUrl: args.sourceUrl,
+        updatedAt: args.updatedAt ?? PRICING_UPDATED_AT_20260522,
+        confidence: args.confidence ?? "official",
+        notes: args.notes,
+        components: [
+            {
+                kind: "audio_minutes",
+                unit: "per_minute",
+                input: args.input,
+                notes: args.notes,
+            },
+        ],
+    };
+}
+function clonePricingAsApproxFromBase(args) {
+    const base = args.basePricing;
+    const relation = args.relation ?? "base";
+    const extraNote = relation === "fallback"
+        ? `Inherited pricing from fallback model: ${args.baseId}`
+        : `Inherited pricing from base model: ${args.baseId}`;
+    const notes = base.notes ? `${base.notes} | ${extraNote}` : extraNote;
+    return {
+        currency: base.currency,
+        sourceUrl: base.sourceUrl,
+        updatedAt: base.updatedAt,
+        confidence: "approx",
+        notes,
+        components: base.components.map((c) => ({ ...c })),
+    };
+}
+function tryGetBaseModelIdFromVersionedId(modelId) {
+    const id = String(modelId || "").trim();
+    if (!id)
+        return null;
+    // Common vendor patterns:
+    // - OpenAI: gpt-4o-2024-11-20
+    // - OpenAI: gpt-5.4-mini-2026-03-17
+    // - Anthropic: claude-haiku-4-5-20251001
+    const m1 = id.match(/^(.*)-\d{4}-\d{2}-\d{2}$/);
+    if (m1?.[1])
+        return m1[1];
+    const m2 = id.match(/^(.*)-\d{8}$/);
+    if (m2?.[1])
+        return m2[1];
+    return null;
+}
+/**
+ * Fills pricing gaps by inheriting pricing from the base model when a vendor exposes
+ * versioned/dated aliases that share the same pricing.
+ *
+ * Notes
+ * - Inherited pricing is marked as `confidence: "approx"`.
+ * - Only applies when a base model is present in the same provider list.
+ */
+function fillMissingPricingFromBaseModels(modelsByProvider) {
+    const out = {};
+    for (const provider of Object.values(IntentProvider)) {
+        const defs = modelsByProvider[provider] ?? [];
+        const pricingById = {};
+        for (const def of defs) {
+            if (def.pricing)
+                pricingById[def.id] = def.pricing;
+        }
+        const fallbacks = PRICING_FALLBACK_RULES_BY_PROVIDER[provider] ?? [];
+        out[provider] = defs.map((def) => {
+            if (def.pricing)
+                return def;
+            const baseId = tryGetBaseModelIdFromVersionedId(def.id);
+            if (baseId) {
+                const basePricing = pricingById[baseId];
+                if (basePricing) {
+                    return {
+                        ...def,
+                        pricing: clonePricingAsApproxFromBase({
+                            modelId: def.id,
+                            baseId,
+                            basePricing,
+                            relation: "base",
+                        }),
+                    };
+                }
+            }
+            for (const rule of fallbacks) {
+                if (!rule.match.test(def.id))
+                    continue;
+                const fallbackPricing = pricingById[rule.baseModelId];
+                if (!fallbackPricing)
+                    continue;
+                return {
+                    ...def,
+                    pricing: clonePricingAsApproxFromBase({
+                        modelId: def.id,
+                        baseId: rule.baseModelId,
+                        basePricing: fallbackPricing,
+                        relation: "fallback",
+                    }),
+                };
+            }
+            return def;
+        });
+    }
+    return out;
+}
+function buildProviderModelCatalogAndTypeIndex(modelsByProvider) {
+    const intentTypes = Object.values(intent_contract_1.IntentType);
+    const catalog = {};
+    const idsByType = {};
+    for (const provider of Object.values(IntentProvider)) {
+        catalog[provider] = {};
+        const perType = {};
+        for (const t of intentTypes)
+            perType[t] = [];
+        idsByType[provider] = perType;
+        const defs = modelsByProvider[provider] ?? [];
+        for (const def of defs) {
+            catalog[provider][def.id] = def;
+            for (const t of def.types) {
+                idsByType[provider][t].push(def.id);
+            }
+        }
+    }
+    return { catalog, idsByType };
+}
+/**
+ * Static utility class for querying the provider model catalog.
+ *
+ * Designed for client consumption: `ProviderModelRegistry.listProvidersSupportingType(...)`.
+ */
+class ProviderModelRegistry {
+    /** Canonical catalog view: provider -> modelId -> definition. */
+    static catalog = exports.PROVIDER_MODEL_CATALOG;
+    /** Primary listing view: provider -> intent type -> model IDs. */
+    static idsByProviderAndType = exports.PROVIDER_MODEL_IDS_BY_PROVIDER_AND_TYPE;
+    /** Source-of-truth definitions in declared order (useful for UI display). */
+    static definitionsByProvider = exports.PROVIDER_MODEL_DEFINITIONS_BY_PROVIDER;
+    /** Returns the model definition if present; otherwise null. */
+    static getModelDefinition(provider, modelId) {
+        return ProviderModelRegistry.catalog[provider]?.[modelId] ?? null;
+    }
+    /** Lists all model IDs for a provider (stable order as declared in the catalog). */
+    static listProviderModelIds(provider) {
+        return (ProviderModelRegistry.definitionsByProvider[provider] ?? []).map((m) => m.id);
+    }
+    /** Lists all model definitions for a provider (stable order as declared in the catalog). */
+    static listProviderModels(provider, options) {
+        const defs = ProviderModelRegistry.definitionsByProvider[provider] ?? [];
+        if (!options?.onlyPublicForCustomers)
+            return defs;
+        return defs.filter((m) => m.publicForCustomers === true);
+    }
+    /**
+     * Lists all public customer models across all providers.
+     *
+     * Notes
+     * - Uses the catalog declared order (provider order, then per-provider declaration order).
+     * - This is a UI/helper surface only; execution still uses provider+modelId.
+     */
+    static listPublicCustomerModels(options) {
+        const out = [];
+        for (const provider of Object.values(IntentProvider)) {
+            const defs = ProviderModelRegistry.listProviderModels(provider, {
+                onlyPublicForCustomers: true,
+            });
+            for (const def of defs) {
+                const model = def;
+                if (options?.primaryCategory &&
+                    model.primaryCategory !== options.primaryCategory) {
+                    continue;
+                }
+                if (options?.includeCategories?.length) {
+                    const include = options.includeCategories;
+                    const hasAny = include.some((c) => model.categories.includes(c));
+                    if (!hasAny)
+                        continue;
+                }
+                out.push({ provider, modelId: model.id, model });
+            }
+        }
+        return out;
+    }
+    /**
+     * Groups all public customer models by their primaryCategory.
+     *
+     * Intended for the "simple UI" mode where the UI shows high-level DCDR groups.
+     */
+    static listPublicCustomerModelsByPrimaryCategory() {
+        const out = {};
+        for (const c of Object.values(DcdrPublicModelCategory)) {
+            out[c] = [];
+        }
+        for (const item of ProviderModelRegistry.listPublicCustomerModels()) {
+            out[item.model.primaryCategory].push(item);
+        }
+        return out;
+    }
+    /** Lists model IDs for a provider that support a given IntentType. */
+    static listProviderModelIdsForType(provider, type) {
+        return ProviderModelRegistry.idsByProviderAndType[provider]?.[type] ?? [];
+    }
+    /** Lists model definitions for a provider that support a given IntentType. */
+    static listProviderModelsForType(provider, type) {
+        const ids = ProviderModelRegistry.listProviderModelIdsForType(provider, type);
+        return ids
+            .map((id) => ProviderModelRegistry.getModelDefinition(provider, id))
+            .filter((m) => m !== null);
+    }
+    /** Returns true if the provider has at least one model for the given IntentType. */
+    static providerSupportsType(provider, type) {
+        return (ProviderModelRegistry.listProviderModelIdsForType(provider, type).length >
+            0);
+    }
+    /** Returns true if the model supports the given IntentType (based on the catalog). */
+    static modelSupportsType(provider, modelId, type) {
+        const def = ProviderModelRegistry.getModelDefinition(provider, modelId);
+        if (!def)
+            return false;
+        return def.types.includes(type);
+    }
+    /** Lists all providers that have at least one model supporting the given IntentType. */
+    static listProvidersSupportingType(type) {
+        return Object.values(IntentProvider).filter((p) => ProviderModelRegistry.providerSupportsType(p, type));
+    }
+    /** Returns all model IDs across all providers for a given type. */
+    static listAllModelIdsForType(type) {
+        const out = [];
+        for (const provider of Object.values(IntentProvider)) {
+            for (const modelId of ProviderModelRegistry.listProviderModelIdsForType(provider, type)) {
+                out.push({ provider, modelId });
+            }
+        }
+        return out;
+    }
+    /** Convenience: get unified pricing if present (or null if not set/unknown). */
+    static getModelPricing(provider, modelId) {
+        return (ProviderModelRegistry.getModelDefinition(provider, modelId)?.pricing ??
+            null);
+    }
+    /** Get a specific pricing component from a model by kind (or null if absent). */
+    static getPricingComponent(provider, modelId, kind) {
+        const pricing = ProviderModelRegistry.getModelPricing(provider, modelId);
+        if (!pricing)
+            return null;
+        const found = pricing.components.find((c) => c.kind === kind);
+        return found ?? null;
+    }
+    /** Convenience: token pricing (per MTok) if present. */
+    static getTokenPricing(provider, modelId) {
+        return ProviderModelRegistry.getPricingComponent(provider, modelId, "tokens");
+    }
+}
+exports.ProviderModelRegistry = ProviderModelRegistry;