@ai-sdk/openai 4.0.104 → 4.0.106

package/dist/index.js

@@ -1,4 +1,4 @@
-import { EXPERIMENTAL_EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL, StreamingToolCallTracker, WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, combineHeaders, connectToWebSocket, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertInlineFileDataToUint8Array, convertToBase64, convertToFormData, convertUint8ArrayToBase64, createBinaryResponseHandler, createBinaryStreamResponseHandler, createEventSourceResponseHandler, createJsonErrorResponseHandler, createJsonLinesResponseHandler, createJsonResponseHandler, createLanguageModelResponseMetadata, createLanguageModelResponseMetadata as getResponseMetadata, createNullLanguageModelUsage, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createProviderExecutedToolFactory, createProviderStreamError, createToolNameMapping, deleteFromApi, detectMediaType, downloadBlob, encodePathSegment, experimental_toolCaller, generateId, getFromApi, getTopLevelMediaType, isCustomReasoning, isFullMediaType, isNonNullable, isRecord, lazySchema, loadApiKey, loadOptionalSetting, mediaTypeToExtension, normalizeBatchRequestCounts, parseJSON, parseProviderOptions, postFormDataToApi, postJsonToApi, postMultipartStreamToApi, postToApi, resolveFullMediaType, resolveProviderReference, safeParseJSON, safeValidateTypes, serializeModelOptions, toWebSocketUrl, validateBaseURL, validateTypes, waitForWebSocketBufferDrain, withUserAgentSuffix, withoutTrailingSlash, zodSchema } from "@ai-sdk/provider-utils";
+import { EXPERIMENTAL_EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL, StreamingToolCallTracker, WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, combineHeaders, connectToWebSocket, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertInlineFileDataToUint8Array, convertToBase64, convertToFormData, convertUint8ArrayToBase64, createBinaryResponseHandler, createBinaryStreamResponseHandler, createEventSourceResponseHandler, createJsonErrorResponseHandler, createJsonLinesResponseHandler, createJsonResponseHandler, createLanguageModelResponseMetadata, createLanguageModelResponseMetadata as getResponseMetadata, createNullLanguageModelUsage, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createProviderExecutedToolFactory, createProviderStreamError, createToolNameMapping, deleteFromApi, detectMediaType, downloadBlob, encodePathSegment, experimental_toolCaller, generateId, getFromApi, getTopLevelMediaType, isCustomReasoning, isFullMediaType, isNonNullable, isRecord, lazySchema, loadApiKey, loadOptionalSetting, mapReasoningToProviderEffort, mediaTypeToExtension, normalizeBatchRequestCounts, parseJSON, parseProviderOptions, postFormDataToApi, postJsonToApi, postMultipartStreamToApi, postToApi, resolve, resolveFullMediaType, resolveProviderReference, resolveWith, safeParseJSON, safeValidateTypes, serializeModelOptions, toWebSocketUrl, validateBaseURL, validateTypes, waitForWebSocketBufferDrain, withUserAgentSuffix, withoutTrailingSlash, zodSchema } from "@ai-sdk/provider-utils";
 import { APICallError, InvalidArgumentError, InvalidPromptError, InvalidResponseDataError, TooManyEmbeddingValuesForCallError, UnsupportedFunctionalityError, isJSONObject } from "@ai-sdk/provider";
 import { z } from "zod/v4";
 //#region src/openai-config.ts
@@ -29,9 +29,11 @@ const openaiFailedResponseHandler = createJsonErrorResponseHandler({
 });
 //#endregion
 //#region src/openai-decision-model-options.ts
-const openaiDecisionModelOptions = lazySchema(() => zodSchema(z.object({ 
-/** An opaque end-user identifier for safety monitoring, up to 128 characters. */
-safetyIdentifier: z.string().max(128).optional() })));
+const openaiDecisionModelOptions = lazySchema(() => zodSchema(z.object({
+	/** An opaque end-user identifier for safety monitoring, up to 128 characters. */
+	safetyIdentifier: z.string().max(128).optional(),
+	promptCacheKey: z.string().optional()
+})));
 //#endregion
 //#region src/openai-decision-model.ts
 const probability = () => z.number().min(0).max(1);
@@ -117,10 +119,11 @@ var DecisionOpenAIModel = class DecisionOpenAIModel {
 				path: "/decisions",
 				modelId: this.modelId
 			}),
-			headers: combineHeaders(this.config.headers?.(), headers),
+			headers: combineHeaders(await resolve(this.config.headers), headers),
 			body: {
 				model: this.modelId,
 				safety_identifier: openaiOptions?.safetyIdentifier,
+				prompt_cache_key: openaiOptions?.promptCacheKey,
 				input: [{
 					role: "user",
 					content: state.map((part) => {
@@ -128,7 +131,10 @@ var DecisionOpenAIModel = class DecisionOpenAIModel {
 							type: "input_text",
 							text: part.text
 						};
-						if (part.type === "json") return {
+						if (part.type === "json") return isInputJsonData(part.value) ? {
+							type: "input_json",
+							data: part.value
+						} : {
 							type: "input_text",
 							text: JSON.stringify(part.value)
 						};
@@ -240,7 +246,7 @@ var DecisionOpenAIModel = class DecisionOpenAIModel {
 					type: "unsupported",
 					feature: "reasoning"
 				}] : [],
-				...Object.keys(providerOptions?.openai ?? {}).filter((option) => option !== "safetyIdentifier").map((option) => ({
+				...Object.keys(providerOptions?.openai ?? {}).filter((option) => !SUPPORTED_PROVIDER_OPTIONS.has(option)).map((option) => ({
 					type: "unsupported",
 					feature: `providerOptions.openai.${option}`
 				}))
@@ -257,59 +263,554 @@ var DecisionOpenAIModel = class DecisionOpenAIModel {
 		};
 	}
 };
+const SUPPORTED_PROVIDER_OPTIONS = /* @__PURE__ */ new Set(["safetyIdentifier", "promptCacheKey"]);
 function toText(input) {
 	return typeof input === "string" ? input : JSON.stringify(input);
 }
+const INPUT_JSON_MAX_DEPTH = 32;
+const INPUT_JSON_MAX_VALUES = 1e4;
+const INPUT_JSON_MAX_BYTES = 262144;
+function isInputJsonData(value) {
+	return (Array.isArray(value) ? value.length > 0 && value.every(isJSONObject$1) : isJSONObject$1(value)) && fitsInputJsonLimits(value);
+}
+function fitsInputJsonLimits(value) {
+	let count = 0;
+	const visit = (node, depth) => {
+		count += 1;
+		if (count > INPUT_JSON_MAX_VALUES) return false;
+		if (node === null || typeof node !== "object") return true;
+		if (depth > INPUT_JSON_MAX_DEPTH) return false;
+		return (Array.isArray(node) ? node : Object.values(node)).every((child) => visit(child, depth + 1));
+	};
+	return visit(value, 1) && new TextEncoder().encode(JSON.stringify(value)).length <= INPUT_JSON_MAX_BYTES;
+}
+function isJSONObject$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 //#endregion
-//#region src/openai-language-model-capabilities.ts
-function getOpenAILanguageModelCapabilities(modelId) {
+//#region src/openai-model-catalog.ts
+/**
+* Options accepted under `providerOptions.openai`. Language options are the
+* Responses API options. The `satisfies` check keeps this list in sync with
+* the option schema.
+*/
+const openaiProviderOptions = { language: {
+	conversation: { description: "OpenAI Conversation ID to continue." },
+	include: { description: "Extra fields to include in the response." },
+	includeWebSearchSources: { description: "Include web search action sources." },
+	instructions: { description: "Instructions for the model." },
+	logprobs: { description: "Return token log probabilities." },
+	maxToolCalls: { description: "Maximum number of built-in tool calls." },
+	metadata: { description: "Metadata to store with the generation." },
+	parallelToolCalls: { description: "Whether to use parallel tool calls." },
+	previousResponseId: { description: "Previous response ID to continue." },
+	promptCacheKey: { description: "Cache key for prompt caching." },
+	promptCacheOptions: { description: "Prompt cache mode, TTL, and prewarm." },
+	promptCacheRetention: { description: "Prompt cache retention policy." },
+	reasoningEffort: { description: "Reasoning effort." },
+	reasoningEffortUpdate: { description: "Reasoning effort update from this response onward." },
+	reasoningMode: { description: "Standard or pro reasoning mode." },
+	reasoningContext: { description: "Which reasoning items can be used." },
+	reasoningSummary: { description: "Reasoning summary output." },
+	safetyIdentifier: { description: "Identifier for safety monitoring." },
+	serviceTier: { description: "Service tier for the request." },
+	store: { description: "Whether to store the generation." },
+	passThroughUnsupportedFiles: { description: "Send non-image file types as generic input files." },
+	strictJsonSchema: { description: "Use strict JSON schema validation." },
+	textVerbosity: { description: "Verbosity of text responses." },
+	truncation: { description: "Output truncation behavior." },
+	user: { description: "End-user identifier for abuse monitoring." },
+	systemMessageMode: { description: "System message role override." },
+	forceReasoning: { description: "Treat the model as a reasoning model." },
+	contextManagement: { description: "Server-side context compaction." },
+	compactionTrigger: { description: "Request explicit compaction." },
+	allowedTools: { description: "Restrict callable tools to a subset." }
+} };
+const configurableNonReasoning = { capabilities: { language: { reasoning: {
+	support: true,
+	efforts: [
+		"none",
+		"low",
+		"medium",
+		"high",
+		"xhigh",
+		"max"
+	],
+	sampling: "reasoning-effort-none"
+} } } };
+const openaiLanguageModelEntries = Object.fromEntries(Object.entries({
+	"gpt-6-astra": {},
+	"gpt-6.1-sol": {},
+	"gpt-6.1-terra": configurableNonReasoning,
+	"gpt-6-luna": configurableNonReasoning,
+	"gpt-6-sol": configurableNonReasoning,
+	"gpt-5.6": {},
+	"gpt-5.6-luna": {},
+	"gpt-5.6-sol": {},
+	"gpt-5.6-terra": {},
+	"gpt-5.5": {},
+	"gpt-5.4-pro": {},
+	"gpt-5.4": {},
+	"gpt-5.4-mini": {},
+	"gpt-5.4-nano": {},
+	"gpt-5.3-chat-latest": {},
+	"gpt-5.2-pro": {},
+	"gpt-5.2-chat-latest": {},
+	"gpt-5.2": {},
+	"gpt-5.1-codex-mini": {},
+	"gpt-5.1-codex": {},
+	"gpt-5.1-chat-latest": {},
+	"gpt-5.1": {},
+	"gpt-5-pro": {},
+	"gpt-5": {},
+	"gpt-5-mini": {},
+	"gpt-5-nano": {},
+	"gpt-5-codex": {},
+	"gpt-5-chat-latest": { capabilities: { language: {
+		objectGeneration: false,
+		tools: {
+			usage: false,
+			streaming: false,
+			async: false
+		}
+	} } },
+	"gpt-4.1": {},
+	"gpt-4.1-mini": {},
+	"gpt-4.1-nano": {},
+	"gpt-4o": {},
+	"gpt-4o-mini": {}
+}).map(([modelId, definition]) => [modelId, createOpenAILanguageModelEntry(modelId, definition)]));
+function createOpenAILanguageModelEntry(modelId, definition) {
 	const oSeriesVersion = getOSeriesVersion(modelId);
 	const gptVersion = getGptVersion(modelId);
+	const isRecognizedModelFamily = oSeriesVersion != null || gptVersion != null || /^gpt-4o(?:-|$)/.test(modelId);
 	const isGptChatModel = gptVersion?.minor == null && (gptVersion?.variant?.startsWith("chat") ?? false);
 	const isGptNanoModel = gptVersion?.variant?.startsWith("nano") ?? false;
 	const isGpt6OrLaterModel = gptVersion != null && gptVersion.major >= 6;
-	const isGpt6OrLaterModelWithNoneEffort = modelId === "gpt-6-sol" || modelId === "gpt-6-luna" || modelId === "gpt-6.1-terra";
+	const isGpt56OrLaterModel = isGpt6OrLaterModel || gptVersion?.major === 5 && (gptVersion.minor ?? 0) >= 6;
+	const isStandardGpt5Model = gptVersion?.major === 5 && (gptVersion.variant == null || /^(?:(?:mini|nano|sol|luna|terra)(?:-\d{4}-\d{2}-\d{2})?|\d{4}-\d{2}-\d{2})$/.test(gptVersion.variant));
 	const supportsFlexProcessing = oSeriesVersion != null && oSeriesVersion >= 3 || gptVersion != null && gptVersion.major >= 5 && !isGptChatModel;
 	const supportsPriorityProcessing = modelId.startsWith("gpt-4") || gptVersion != null && gptVersion.major >= 5 && !isGptNanoModel && !isGptChatModel || oSeriesVersion != null && oSeriesVersion >= 3;
 	const isReasoningModel = oSeriesVersion != null || gptVersion != null && gptVersion.major >= 5 && !isGptChatModel;
-	const supportsNonReasoningParameters = isGpt6OrLaterModelWithNoneEffort || !isGpt6OrLaterModel && gptVersion != null && (gptVersion.major > 5 || gptVersion.major === 5 && (gptVersion.minor ?? 0) >= 1);
+	const reasoningSampling = definition?.capabilities?.language?.reasoning?.sampling ?? (!isGpt6OrLaterModel && gptVersion != null && (gptVersion.major > 5 || gptVersion.major === 5 && (gptVersion.minor ?? 0) >= 1) ? "reasoning-effort-none" : "unsupported");
+	const sampling = !isRecognizedModelFamily ? "unknown" : !isReasoningModel ? true : reasoningSampling === "reasoning-effort-none" ? { condition: "Only when reasoning effort is none." } : false;
+	const chatTemperatureSupportedWithoutReasoning = !modelId.startsWith("gpt-4o-search-preview") && !modelId.startsWith("gpt-4o-mini-search-preview");
+	const entry = {
+		capabilities: { language: {
+			inputs: definition?.capabilities?.language?.inputs ?? {
+				image: definition != null ? true : "unknown",
+				audio: definition != null ? false : "unknown"
+			},
+			objectGeneration: definition?.capabilities?.language?.objectGeneration ?? (definition != null ? true : "unknown"),
+			tools: definition?.capabilities?.language?.tools ?? {
+				usage: definition != null ? true : "unknown",
+				streaming: definition != null ? true : "unknown",
+				async: isGpt6OrLaterModel
+			},
+			reasoning: {
+				support: isRecognizedModelFamily ? isReasoningModel : "unknown",
+				efforts: definition?.capabilities?.language?.reasoning?.efforts ?? (isGpt6OrLaterModel ? [
+					"low",
+					"medium",
+					"high",
+					"xhigh",
+					"max"
+				] : isStandardGpt5Model ? getGpt5ReasoningEfforts(gptVersion.minor ?? 0) : void 0),
+				sampling: reasoningSampling
+			},
+			sampling: {
+				temperature: chatTemperatureSupportedWithoutReasoning ? sampling : { condition: "Not supported by Chat Completions search preview models." },
+				topP: sampling,
+				logprobs: isReasoningModel && !isGpt6OrLaterModel ? { condition: reasoningSampling === "reasoning-effort-none" ? "Chat Completions requires reasoning effort none; Responses support is model-dependent." : "Not supported by Chat Completions while reasoning; Responses support is model-dependent." } : sampling
+			},
+			serviceTiers: {
+				flex: supportsFlexProcessing,
+				priority: supportsPriorityProcessing
+			},
+			configurationUpdates: isGpt6OrLaterModel,
+			promptCache: {
+				retention: !isGpt6OrLaterModel,
+				options: isRecognizedModelFamily ? isGpt56OrLaterModel : "unknown"
+			},
+			endpoints: {
+				chat: {
+					temperatureWithoutReasoning: chatTemperatureSupportedWithoutReasoning,
+					functionToolsWithReasoning: !(gptVersion?.major === 5 && (gptVersion.minor ?? 0) >= 6)
+				},
+				responses: { logprobsRequireNonReasoning: isGpt6OrLaterModel }
+			}
+		} },
+		requestConfig: { language: { systemMessageMode: definition?.requestConfig?.language?.systemMessageMode ?? (isReasoningModel ? "developer" : "system") } }
+	};
+	const { language } = entry.capabilities;
 	return {
-		supportsFlexProcessing,
-		supportsPriorityProcessing,
-		supportsConfigurationUpdate: isGpt6OrLaterModel,
-		supportsAsyncToolCalling: isGpt6OrLaterModel,
-		supportedReasoningEfforts: isGpt6OrLaterModelWithNoneEffort ? [
-			"none",
-			"low",
-			"medium",
-			"high",
-			"xhigh",
-			"max"
-		] : isGpt6OrLaterModel ? [
-			"low",
-			"medium",
-			"high",
-			"xhigh",
-			"max"
-		] : void 0,
-		isReasoningModel,
-		systemMessageMode: isReasoningModel ? "developer" : "system",
-		supportsNonReasoningParameters
+		...entry,
+		providerOptions: { language: declareProviderOptions(openaiProviderOptions.language, definition != null ? true : "unknown", {
+			logprobs: language.sampling.logprobs,
+			maxToolCalls: language.tools.usage,
+			parallelToolCalls: language.tools.usage,
+			allowedTools: language.tools.usage,
+			reasoningEffort: language.reasoning.support,
+			reasoningSummary: language.reasoning.support,
+			reasoningMode: language.reasoning.support,
+			reasoningContext: language.reasoning.support,
+			reasoningEffortUpdate: language.configurationUpdates,
+			promptCacheOptions: language.promptCache.options,
+			promptCacheRetention: language.promptCache.retention
+		}) }
 	};
 }
+/** Applies one default support value to every option, except the listed ones. */
+function declareProviderOptions(definitions, support, exceptions) {
+	return Object.fromEntries(Object.keys(definitions).map((option) => [option, exceptions[option] ?? support]));
+}
+function getGpt5ReasoningEfforts(minor) {
+	if (minor === 0) return [
+		"minimal",
+		"low",
+		"medium",
+		"high"
+	];
+	if (minor === 1) return [
+		"none",
+		"low",
+		"medium",
+		"high"
+	];
+	if (minor < 6) return [
+		"none",
+		"low",
+		"medium",
+		"high",
+		"xhigh"
+	];
+	return [
+		"none",
+		"low",
+		"medium",
+		"high",
+		"xhigh",
+		"max"
+	];
+}
 function getOSeriesVersion(modelId) {
 	const match = /^o(\d+)(?:-|$)/.exec(modelId);
 	return match == null ? void 0 : Number(match[1]);
 }
 function getGptVersion(modelId) {
 	const match = /^gpt-(\d+)(?:\.(\d+))?(?:-(.+))?$/.exec(modelId);
-	if (match == null) return;
-	return {
+	return match == null ? void 0 : {
 		major: Number(match[1]),
 		minor: match[2] == null ? void 0 : Number(match[2]),
 		variant: match[3]
 	};
 }
+const openaiEmbeddingModelEntries = {
+	"text-embedding-3-large": { capabilities: { embedding: {
+		defaultDimensions: 3072,
+		customDimensions: true
+	} } },
+	"text-embedding-3-small": { capabilities: { embedding: {
+		defaultDimensions: 1536,
+		customDimensions: true
+	} } },
+	"text-embedding-ada-002": { capabilities: { embedding: {
+		defaultDimensions: 1536,
+		customDimensions: false
+	} } }
+};
+const gptImageSizes = [
+	"1024x1024",
+	"1536x1024",
+	"1024x1536"
+];
+const customImageSizes = { description: "Standard presets and custom dimensions" };
+function createGptImageEntry(sizes) {
+	return {
+		capabilities: { image: {
+			sizes,
+			fileInput: true,
+			maskInput: true,
+			maxImagesPerCall: 10
+		} },
+		requestConfig: { image: { responseFormat: "provider-default" } }
+	};
+}
+const openaiImageModelEntries = {
+	"gpt-image-2.5-flare": createGptImageEntry(customImageSizes),
+	"gpt-image-2.5-sunburst": createGptImageEntry(customImageSizes),
+	"gpt-image-2": createGptImageEntry(gptImageSizes),
+	"gpt-image-1.5": createGptImageEntry(gptImageSizes),
+	"gpt-image-1-mini": createGptImageEntry(gptImageSizes),
+	"gpt-image-1": createGptImageEntry(gptImageSizes),
+	"dall-e-3": {
+		capabilities: { image: {
+			sizes: [
+				"1024x1024",
+				"1792x1024",
+				"1024x1792"
+			],
+			fileInput: false,
+			maskInput: false,
+			maxImagesPerCall: 1
+		} },
+		requestConfig: { image: { responseFormat: "b64_json" } }
+	},
+	"dall-e-2": {
+		capabilities: { image: {
+			sizes: [
+				"256x256",
+				"512x512",
+				"1024x1024"
+			],
+			fileInput: true,
+			maskInput: true,
+			maxImagesPerCall: 10
+		} },
+		requestConfig: { image: { responseFormat: "b64_json" } }
+	}
+};
+const imageModelAliases = {
+	"gpt-image-2.5-flare-2026-09-08": openaiImageModelEntries["gpt-image-2.5-flare"],
+	"gpt-image-2.5-sunburst-2026-09-08": openaiImageModelEntries["gpt-image-2.5-sunburst"],
+	"chatgpt-image-latest": createGptImageEntry({ description: "Unknown" })
+};
+function resolveOpenAIImageModelEntry(modelId) {
+	if (Object.prototype.hasOwnProperty.call(openaiImageModelEntries, modelId)) return openaiImageModelEntries[modelId];
+	if (Object.prototype.hasOwnProperty.call(imageModelAliases, modelId)) return imageModelAliases[modelId];
+	return {
+		capabilities: { image: {
+			sizes: { description: "Unknown" },
+			fileInput: "unknown",
+			maskInput: "unknown",
+			maxImagesPerCall: modelId.startsWith("gpt-image-") ? 10 : 1
+		} },
+		requestConfig: { image: { responseFormat: modelId.startsWith("chatgpt-image-") || modelId.startsWith("gpt-image-") ? "provider-default" : "b64_json" } }
+	};
+}
+Object.fromEntries(Object.entries({
+	...openaiImageModelEntries,
+	...imageModelAliases
+}).map(([modelId, entry]) => [modelId, entry.capabilities.image.maxImagesPerCall ?? 1]));
+const defaultTranscriptionRequestConfig = { languageField: "language" };
+const openaiTranscriptionModelEntries = {
+	"whisper-1": {
+		capabilities: { transcription: {
+			transcription: true,
+			streaming: false,
+			streamingDelay: false,
+			duration: true,
+			segments: true,
+			language: true
+		} },
+		requestConfig: { transcription: {
+			...defaultTranscriptionRequestConfig,
+			responseFormat: "verbose_json"
+		} }
+	},
+	"gpt-4o-mini-transcribe": {
+		capabilities: { transcription: {
+			transcription: true,
+			streaming: false,
+			streamingDelay: false,
+			duration: false,
+			segments: false,
+			language: false
+		} },
+		requestConfig: { transcription: defaultTranscriptionRequestConfig }
+	},
+	"gpt-4o-transcribe": {
+		capabilities: { transcription: {
+			transcription: true,
+			streaming: false,
+			streamingDelay: false,
+			duration: false,
+			segments: false,
+			language: false
+		} },
+		requestConfig: { transcription: defaultTranscriptionRequestConfig }
+	},
+	"gpt-4o-transcribe-diarize": {
+		capabilities: { transcription: {
+			transcription: true,
+			streaming: false,
+			streamingDelay: false,
+			duration: true,
+			segments: true,
+			language: false
+		} },
+		requestConfig: { transcription: {
+			...defaultTranscriptionRequestConfig,
+			responseFormat: "diarized_json",
+			chunkingStrategy: "auto"
+		} }
+	},
+	"gpt-transcribe": {
+		capabilities: { transcription: {
+			transcription: true,
+			streaming: true,
+			streamingDelay: false,
+			duration: false,
+			segments: false,
+			language: true
+		} },
+		requestConfig: { transcription: { languageField: "languages" } }
+	},
+	"gpt-live-transcribe": {
+		capabilities: { transcription: {
+			transcription: false,
+			streaming: true,
+			streamingDelay: true,
+			duration: false,
+			segments: false,
+			language: false
+		} },
+		requestConfig: { transcription: { languageField: "languages" } }
+	},
+	"gpt-realtime-whisper": {
+		capabilities: { transcription: {
+			transcription: false,
+			streaming: true,
+			streamingDelay: true,
+			duration: false,
+			segments: false,
+			language: false
+		} },
+		requestConfig: { transcription: defaultTranscriptionRequestConfig }
+	}
+};
+const transcriptionSnapshotModelIds = [
+	"gpt-transcribe",
+	"gpt-live-transcribe",
+	"gpt-realtime-whisper"
+];
+function resolveOpenAITranscriptionModelEntry(modelId) {
+	if (Object.prototype.hasOwnProperty.call(openaiTranscriptionModelEntries, modelId)) return openaiTranscriptionModelEntries[modelId];
+	for (const baseModelId of transcriptionSnapshotModelIds) if (modelId.startsWith(`${baseModelId}-`)) return openaiTranscriptionModelEntries[baseModelId];
+	return {
+		capabilities: { transcription: {
+			transcription: "unknown",
+			streaming: "unknown",
+			streamingDelay: "unknown",
+			duration: "unknown",
+			segments: "unknown",
+			language: "unknown"
+		} },
+		requestConfig: { transcription: defaultTranscriptionRequestConfig }
+	};
+}
+const openaiSpeechTranslationModelEntries = { "gpt-realtime-translate": { capabilities: { speechTranslation: {
+	translatedAudio: true,
+	translatedText: true,
+	sourceTranscript: true
+} } } };
+const openaiSpeechModelEntries = {
+	"tts-1": { capabilities: { speech: { instructions: false } } },
+	"tts-1-hd": { capabilities: { speech: { instructions: false } } },
+	"gpt-4o-mini-tts": { capabilities: { speech: { instructions: true } } }
+};
+const liveModelEntry = {
+	capabilities: { realtime: {
+		conversation: "continuous",
+		transports: ["websocket", "webrtc"],
+		connections: ["server-websocket", "webrtc"]
+	} },
+	requestConfig: { realtime: {
+		api: "live",
+		startup: "session-start",
+		finalization: "session-close"
+	} }
+};
+const realtimeModelEntry = {
+	capabilities: { realtime: {
+		conversation: "turn-based",
+		transports: ["websocket"],
+		connections: ["client-secret-websocket"]
+	} },
+	requestConfig: { realtime: {
+		api: "realtime",
+		startup: "session-update",
+		finalization: "transport-close"
+	} }
+};
+const realtimeModelEntries = {
+	"gpt-live-1": liveModelEntry,
+	"gpt-realtime": realtimeModelEntry
+};
+/** Keep the existing realtime interface's shape while deriving it from the catalog. */
+const openaiLiveRealtimeCapabilities = {
+	...liveModelEntry.capabilities.realtime,
+	startup: liveModelEntry.requestConfig.realtime.startup,
+	finalization: liveModelEntry.requestConfig.realtime.finalization
+};
+/**
+* The catalog consumed by request builders and documentation. Source declarations
+* are grouped by operation; entries for the same model combine their sections.
+* An absent section is undeclared, not an instruction to reject a request.
+*/
+const openaiModelCatalog = combineModelEntries([
+	openaiLanguageModelEntries,
+	openaiEmbeddingModelEntries,
+	openaiImageModelEntries,
+	openaiTranscriptionModelEntries,
+	openaiSpeechTranslationModelEntries,
+	openaiSpeechModelEntries,
+	realtimeModelEntries
+]);
+function combineModelEntries(catalogs) {
+	const entries = /* @__PURE__ */ new Map();
+	for (const catalog of catalogs) for (const [modelId, entry] of Object.entries(catalog)) {
+		const previous = entries.get(modelId);
+		entries.set(modelId, {
+			capabilities: {
+				...previous?.capabilities,
+				...entry.capabilities
+			},
+			...previous?.providerOptions != null || entry.providerOptions != null ? { providerOptions: {
+				...previous?.providerOptions,
+				...entry.providerOptions
+			} } : {},
+			...previous?.requestConfig != null || entry.requestConfig != null ? { requestConfig: {
+				...previous?.requestConfig,
+				...entry.requestConfig
+			} } : {}
+		});
+	}
+	return Object.fromEntries(entries);
+}
+function findModelEntry(modelId) {
+	return Object.prototype.hasOwnProperty.call(openaiModelCatalog, modelId) ? openaiModelCatalog[modelId] : void 0;
+}
+function getOpenAILanguageModelEntry(modelId) {
+	const entry = findModelEntry(modelId);
+	return entry?.capabilities.language != null && entry.providerOptions?.language != null && entry.requestConfig?.language != null ? {
+		capabilities: { language: entry.capabilities.language },
+		providerOptions: { language: entry.providerOptions.language },
+		requestConfig: { language: entry.requestConfig.language }
+	} : createOpenAILanguageModelEntry(modelId);
+}
+function getOpenAIImageModelEntry(modelId) {
+	const entry = findModelEntry(modelId);
+	return entry?.capabilities.image != null && entry.requestConfig?.image != null ? {
+		capabilities: { image: entry.capabilities.image },
+		requestConfig: { image: entry.requestConfig.image }
+	} : resolveOpenAIImageModelEntry(modelId);
+}
+function getOpenAITranscriptionModelEntry(modelId) {
+	const entry = findModelEntry(modelId);
+	return entry?.capabilities.transcription != null && entry.requestConfig?.transcription != null ? {
+		capabilities: { transcription: entry.capabilities.transcription },
+		requestConfig: { transcription: entry.requestConfig.transcription }
+	} : resolveOpenAITranscriptionModelEntry(modelId);
+}
+function getOpenAIRealtimeModelEntry(modelId, api) {
+	const entry = findModelEntry(modelId);
+	if (entry?.capabilities.realtime != null && entry.requestConfig?.realtime != null && (api == null || entry.requestConfig.realtime.api === api)) return {
+		capabilities: { realtime: entry.capabilities.realtime },
+		requestConfig: { realtime: entry.requestConfig.realtime }
+	};
+	return api === "live" ? liveModelEntry : realtimeModelEntry;
+}
 //#endregion
 //#region src/openai-stream-error.ts
 /**
@@ -459,6 +960,26 @@ function isRetryableStreamError(error, statusCode) {
 	return isRetryableStatusCode(statusCode);
 }
 //#endregion
+//#region src/resolve-openai-reasoning-effort.ts
+const allOpenAIReasoningEfforts = [
+	"none",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+/** Resolve portable reasoning against the efforts declared by the catalog. */
+function resolveOpenAIReasoningEffort({ providerReasoningEffort, reasoning, supportedReasoningEfforts, warnings }) {
+	return mapReasoningToProviderEffort({
+		reasoning,
+		providerOptionsEffort: providerReasoningEffort,
+		effortMap: Object.fromEntries((supportedReasoningEfforts ?? allOpenAIReasoningEfforts).map((effort) => [effort, effort])),
+		warnings
+	});
+}
+//#endregion
 //#region src/chat/convert-openai-chat-usage.ts
 function convertOpenAIChatUsage(usage) {
 	if (usage == null) return createNullLanguageModelUsage();
@@ -1181,17 +1702,20 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 			providerOptions,
 			schema: openaiLanguageModelChatOptions
 		}) ?? {};
-		const modelCapabilities = getOpenAILanguageModelCapabilities(this.modelId);
-		let resolvedReasoningEffort = openaiOptions.reasoningEffort ?? (isCustomReasoning(reasoning) ? reasoning : void 0);
-		if (resolvedReasoningEffort != null && modelCapabilities.supportedReasoningEfforts != null && !modelCapabilities.supportedReasoningEfforts.includes(resolvedReasoningEffort)) {
-			warnings.push({
-				type: "unsupported",
-				feature: "reasoningEffort",
-				details: `${this.modelId} only supports the following reasoning efforts: ${modelCapabilities.supportedReasoningEfforts.join(", ")}`
-			});
-			resolvedReasoningEffort = void 0;
-		}
-		const isReasoningModel = openaiOptions.forceReasoning ?? modelCapabilities.isReasoningModel;
+		const { capabilities: { language: modelCapabilities }, requestConfig: { language: modelRequestConfig } } = getOpenAILanguageModelEntry(this.modelId);
+		const requiresNoReasoningEffort = !modelCapabilities.endpoints.chat.functionToolsWithReasoning && openaiOptions.reasoningEffort == null && (tools?.some((tool) => tool.type === "function") ?? false);
+		if (requiresNoReasoningEffort && isCustomReasoning(reasoning) && reasoning !== "none") warnings.push({
+			type: "compatibility",
+			feature: "reasoning",
+			details: `${this.modelId} does not support function tools with reasoning in the Chat Completions API. reasoning effort set to "none". Use the Responses API to combine reasoning with function tools.`
+		});
+		const resolvedReasoningEffort = requiresNoReasoningEffort ? "none" : resolveOpenAIReasoningEffort({
+			providerReasoningEffort: openaiOptions.reasoningEffort,
+			reasoning,
+			supportedReasoningEfforts: modelCapabilities.reasoning.efforts?.filter((effort) => effort !== "max"),
+			warnings
+		});
+		const isReasoningModel = openaiOptions.forceReasoning ?? modelCapabilities.reasoning.support === true;
 		if (topK != null) warnings.push({
 			type: "unsupported",
 			feature: "topK"
@@ -1203,7 +1727,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 		});
 		const { messages, warnings: messageWarnings } = convertToOpenAIChatMessages({
 			prompt,
-			systemMessageMode: openaiOptions.systemMessageMode ?? (isReasoningModel ? "developer" : modelCapabilities.systemMessageMode)
+			systemMessageMode: openaiOptions.systemMessageMode ?? (isReasoningModel ? "developer" : modelRequestConfig.systemMessageMode)
 		});
 		warnings.push(...messageWarnings);
 		const strictJsonSchema = openaiOptions.strictJsonSchema ?? true;
@@ -1245,7 +1769,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 			safety_identifier: openaiOptions.safetyIdentifier,
 			messages
 		};
-		if (modelCapabilities.supportedReasoningEfforts != null && baseArgs.prompt_cache_retention != null) {
+		if (!modelCapabilities.promptCache.retention && baseArgs.prompt_cache_retention != null) {
 			baseArgs.prompt_cache_retention = void 0;
 			warnings.push({
 				type: "unsupported",
@@ -1254,7 +1778,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 			});
 		}
 		if (isReasoningModel) {
-			if (resolvedReasoningEffort !== "none" || !modelCapabilities.supportsNonReasoningParameters) {
+			if (resolvedReasoningEffort !== "none" || modelCapabilities.reasoning.sampling !== "reasoning-effort-none") {
 				if (baseArgs.temperature != null) {
 					baseArgs.temperature = void 0;
 					warnings.push({
@@ -1313,7 +1837,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 				if (baseArgs.max_completion_tokens == null) baseArgs.max_completion_tokens = baseArgs.max_tokens;
 				baseArgs.max_tokens = void 0;
 			}
-		} else if (this.modelId.startsWith("gpt-4o-search-preview") || this.modelId.startsWith("gpt-4o-mini-search-preview")) {
+		} else if (!modelCapabilities.endpoints.chat.temperatureWithoutReasoning) {
 			if (baseArgs.temperature != null) {
 				baseArgs.temperature = void 0;
 				warnings.push({
@@ -1323,7 +1847,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 				});
 			}
 		}
-		if (openaiOptions.serviceTier === "flex" && !modelCapabilities.supportsFlexProcessing) {
+		if (openaiOptions.serviceTier === "flex" && !modelCapabilities.serviceTiers.flex) {
 			warnings.push({
 				type: "unsupported",
 				feature: "serviceTier",
@@ -1331,7 +1855,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 			});
 			baseArgs.service_tier = void 0;
 		}
-		if ((openaiOptions.serviceTier === "priority" || openaiOptions.serviceTier === "fast") && !modelCapabilities.supportsPriorityProcessing) {
+		if ((openaiOptions.serviceTier === "priority" || openaiOptions.serviceTier === "fast") && !modelCapabilities.serviceTiers.priority) {
 			warnings.push({
 				type: "unsupported",
 				feature: "serviceTier",
@@ -1359,7 +1883,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 				path: "/chat/completions",
 				modelId: this.config.requestModelId ?? this.modelId
 			}),
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			body,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiChatResponseSchema),
@@ -1425,7 +1949,7 @@ var OpenAIChatLanguageModel = class OpenAIChatLanguageModel {
 		});
 		const { responseHeaders, value: response } = await postJsonToApi({
 			url,
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			body,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createEventSourceResponseHandler(openaiChatChunkSchema),
@@ -1802,7 +2326,7 @@ var OpenAICompletionLanguageModel = class OpenAICompletionLanguageModel {
 				path: "/completions",
 				modelId: this.config.requestModelId ?? this.modelId
 			}),
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			body: args,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiCompletionResponseSchema),
@@ -1845,7 +2369,7 @@ var OpenAICompletionLanguageModel = class OpenAICompletionLanguageModel {
 		});
 		const { responseHeaders, value: response } = await postJsonToApi({
 			url,
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			body,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createEventSourceResponseHandler(openaiCompletionChunkSchema),
@@ -2008,7 +2532,7 @@ var OpenAIEmbeddingModel = class OpenAIEmbeddingModel {
 				path: "/embeddings",
 				modelId: this.modelId
 			}),
-			headers: combineHeaders(this.config.headers?.(), headers),
+			headers: combineHeaders(await resolve(this.config.headers), headers),
 			body: {
 				model: this.modelId,
 				input: values,
@@ -2073,8 +2597,8 @@ var OpenAIFiles = class {
 		});
 		return fileId;
 	}
-	getHeaders(headers) {
-		return combineHeaders(this.config.headers(), headers);
+	async getHeaders(headers) {
+		return combineHeaders(await resolve(this.config.headers), headers);
 	}
 	async uploadFile({ data, mediaType, filename, abortSignal, headers, providerOptions }) {
 		let openaiOptions;
@@ -2089,7 +2613,7 @@ var OpenAIFiles = class {
 			throw error;
 		}
 		const purpose = openaiOptions?.purpose ?? "assistants";
-		const requestHeaders = this.getHeaders(headers);
+		const requestHeaders = await this.getHeaders(headers);
 		const url = `${this.config.baseURL}/files`;
 		let response;
 		if (data.type === "stream") {
@@ -2159,7 +2683,7 @@ var OpenAIFiles = class {
 		const fileId = this.getFileId(file);
 		const { value: response } = await getFromApi({
 			url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}`,
-			headers: this.getHeaders(headers),
+			headers: await this.getHeaders(headers),
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiFilesResponseSchema),
 			abortSignal,
@@ -2180,7 +2704,7 @@ var OpenAIFiles = class {
 		const fileId = this.getFileId(file);
 		const { value: content, responseHeaders } = await getFromApi({
 			url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}/content`,
-			headers: this.getHeaders(headers),
+			headers: await this.getHeaders(headers),
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createBinaryStreamResponseHandler(),
 			abortSignal,
@@ -2198,7 +2722,7 @@ var OpenAIFiles = class {
 		const fileId = this.getFileId(file);
 		const { value: response } = await deleteFromApi({
 			url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}`,
-			headers: this.getHeaders(headers),
+			headers: await this.getHeaders(headers),
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiFileDeleteResponseSchema),
 			abortSignal,
@@ -2245,25 +2769,11 @@ const openaiImageResponseSchema = lazySchema(() => zodSchema(z.object({
 })));
 //#endregion
 //#region src/image/openai-image-model-options.ts
-const modelMaxImagesPerCall = {
-	"dall-e-3": 1,
-	"dall-e-2": 10,
-	"gpt-image-1": 10,
-	"gpt-image-1-mini": 10,
-	"gpt-image-1.5": 10,
-	"gpt-image-2": 10,
-	"gpt-image-2.5-flare": 10,
-	"gpt-image-2.5-flare-2026-09-08": 10,
-	"gpt-image-2.5-sunburst": 10,
-	"gpt-image-2.5-sunburst-2026-09-08": 10,
-	"chatgpt-image-latest": 10
-};
-const defaultResponseFormatPrefixes = ["chatgpt-image-", "gpt-image-"];
 function hasDefaultResponseFormat(modelId) {
-	return defaultResponseFormatPrefixes.some((prefix) => modelId.startsWith(prefix));
+	return getOpenAIImageModelEntry(modelId).requestConfig.image.responseFormat === "provider-default";
 }
 function getMaxImagesPerCall(modelId) {
-	return modelMaxImagesPerCall[modelId] ?? (modelId.startsWith("gpt-image-") ? 10 : 1);
+	return getOpenAIImageModelEntry(modelId).capabilities.image.maxImagesPerCall ?? 1;
 }
 const baseImageModelOptionsObject = () => z.object({
 	/**
@@ -2348,23 +2858,13 @@ var OpenAIImageModel = class OpenAIImageModel {
 	}
 	get supportsFileInputs() {
 		if (this.config.imageInputCapabilities != null) return this.config.imageInputCapabilities.supportsFileInputs;
-		if ([
-			"dall-e-2",
-			"gpt-image-1",
-			"gpt-image-1-mini",
-			"gpt-image-1.5",
-			"gpt-image-2",
-			"gpt-image-2.5-flare",
-			"gpt-image-2.5-flare-2026-09-08",
-			"gpt-image-2.5-sunburst",
-			"gpt-image-2.5-sunburst-2026-09-08",
-			"chatgpt-image-latest"
-		].includes(this.modelId)) return true;
-		return this.modelId === "dall-e-3" ? false : void 0;
+		const support = getOpenAIImageModelEntry(this.modelId).capabilities.image.fileInput;
+		return typeof support === "boolean" ? support : void 0;
 	}
 	get supportsMaskInputs() {
 		if (this.config.imageInputCapabilities != null) return this.config.imageInputCapabilities.supportsMaskInputs;
-		return this.supportsFileInputs;
+		const support = getOpenAIImageModelEntry(this.modelId).capabilities.image.maskInput;
+		return typeof support === "boolean" ? support : void 0;
 	}
 	get provider() {
 		return this.config.provider;
@@ -2397,7 +2897,7 @@ var OpenAIImageModel = class OpenAIImageModel {
 					path: "/images/edits",
 					modelId: this.modelId
 				}),
-				headers: combineHeaders(this.config.headers?.(), headers),
+				headers: combineHeaders(await resolve(this.config.headers), headers),
 				formData: convertToFormData({
 					model: this.modelId,
 					prompt,
@@ -2451,7 +2951,7 @@ var OpenAIImageModel = class OpenAIImageModel {
 				path: "/images/generations",
 				modelId: this.modelId
 			}),
-			headers: combineHeaders(this.config.headers?.(), headers),
+			headers: combineHeaders(await resolve(this.config.headers), headers),
 			body: {
 				model: this.modelId,
 				prompt,
@@ -6225,7 +6725,7 @@ const openaiResponsesSupportedUrls = {
 * @see https://developers.openai.com/api/docs/guides/reasoning#change-reasoning-mid-conversation
 */
 function getConfigurationUpdateUnsupportedReason({ modelCapabilities, options }) {
-	if (!modelCapabilities.supportsConfigurationUpdate) return "reasoningEffortUpdate is only supported by GPT-6 and later models";
+	if (!modelCapabilities.configurationUpdates) return "reasoningEffortUpdate is only supported by GPT-6 and later models";
 	if (options?.reasoningMode === "pro" || options?.contextManagement != null || options?.truncation === "auto") return "reasoningEffortUpdate requires standard reasoning mode without automatic compaction or automatic truncation";
 }
 var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
@@ -6249,7 +6749,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 	}
 	static async prepareRequest({ modelId, config, options: { maxOutputTokens, temperature, stopSequences, topP, topK, presencePenalty, frequencyPenalty, seed, prompt, reasoning, providerOptions, tools, toolChoice, responseFormat } }) {
 		const warnings = [];
-		const modelCapabilities = getOpenAILanguageModelCapabilities(modelId);
+		const { capabilities: { language: modelCapabilities }, requestConfig: { language: modelRequestConfig } } = getOpenAILanguageModelEntry(modelId);
 		if (topK != null) warnings.push({
 			type: "unsupported",
 			feature: "topK"
@@ -6281,17 +6781,14 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 			providerOptions,
 			schema: openaiLanguageModelResponsesOptionsSchema
 		});
-		let resolvedReasoningEffort = openaiOptions?.reasoningEffort ?? (isCustomReasoning(reasoning) ? reasoning : void 0);
-		if (resolvedReasoningEffort != null && modelCapabilities.supportedReasoningEfforts != null && !modelCapabilities.supportedReasoningEfforts.includes(resolvedReasoningEffort)) {
-			warnings.push({
-				type: "unsupported",
-				feature: "reasoningEffort",
-				details: `${modelId} only supports the following reasoning efforts: ${modelCapabilities.supportedReasoningEfforts.join(", ")}`
-			});
-			resolvedReasoningEffort = void 0;
-		}
+		const resolvedReasoningEffort = resolveOpenAIReasoningEffort({
+			providerReasoningEffort: openaiOptions?.reasoningEffort,
+			reasoning,
+			supportedReasoningEfforts: modelCapabilities.reasoning.efforts,
+			warnings
+		});
 		const resolvedReasoningSummary = openaiOptions?.reasoningSummary !== void 0 ? openaiOptions.reasoningSummary : resolvedReasoningEffort != null && resolvedReasoningEffort !== "none" ? "detailed" : void 0;
-		const isReasoningModel = openaiOptions?.forceReasoning ?? modelCapabilities.isReasoningModel;
+		const isReasoningModel = openaiOptions?.forceReasoning ?? modelCapabilities.reasoning.support === true;
 		if (openaiOptions?.conversation && openaiOptions?.previousResponseId) warnings.push({
 			type: "unsupported",
 			feature: "conversation",
@@ -6323,7 +6820,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 			toolNameMapping,
 			customProviderToolNames,
 			outputSchemaToolNames,
-			supportsAsyncToolCalling: modelCapabilities.supportsAsyncToolCalling,
+			supportsAsyncToolCalling: modelCapabilities.tools.async,
 			providerOptionsName
 		});
 		const configurationUpdateUnsupportedReason = getConfigurationUpdateUnsupportedReason({
@@ -6333,7 +6830,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 		const { input, warnings: inputWarnings } = await convertToOpenAIResponsesInput({
 			prompt,
 			toolNameMapping,
-			systemMessageMode: openaiOptions?.systemMessageMode ?? (isReasoningModel ? "developer" : modelCapabilities.systemMessageMode),
+			systemMessageMode: openaiOptions?.systemMessageMode ?? (isReasoningModel ? "developer" : modelRequestConfig.systemMessageMode),
 			providerOptionsName,
 			configurationUpdateUnsupportedReason,
 			explicitMessageItemType: config.explicitMessageItemType,
@@ -6352,7 +6849,8 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 			outputSchemaToolNames: outputSchemaToolNames.size > 0 ? outputSchemaToolNames : void 0
 		});
 		warnings.push(...inputWarnings);
-		const getUpdateEffortUnsupportedReason = (effort) => effort != null && modelCapabilities.supportedReasoningEfforts?.includes(effort) === false ? `${modelId} only supports the following reasoning efforts: ${modelCapabilities.supportedReasoningEfforts.join(", ")}` : void 0;
+		const supportedReasoningEfforts = modelCapabilities.reasoning.efforts;
+		const getUpdateEffortUnsupportedReason = (effort) => effort != null && supportedReasoningEfforts?.includes(effort) === false ? `${modelId} only supports the following reasoning efforts: ${supportedReasoningEfforts.join(", ")}` : void 0;
 		for (const item of input) if (item.type === "configuration_update") {
 			const unsupportedReason = getUpdateEffortUnsupportedReason(item.reasoning.effort);
 			if (unsupportedReason != null) throw new UnsupportedFunctionalityError({
@@ -6440,7 +6938,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 				...openaiOptions?.reasoningContext != null && { context: openaiOptions.reasoningContext }
 			} }
 		};
-		if (modelCapabilities.supportsConfigurationUpdate && baseArgs.prompt_cache_retention != null) {
+		if (!modelCapabilities.promptCache.retention && baseArgs.prompt_cache_retention != null) {
 			baseArgs.prompt_cache_retention = void 0;
 			warnings.push({
 				type: "unsupported",
@@ -6451,7 +6949,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 		if (isReasoningModel) {
 			let effectiveReasoningEffort = resolvedReasoningEffort;
 			for (const item of input) if (item.type === "configuration_update") effectiveReasoningEffort = item.reasoning.effort;
-			if (!(effectiveReasoningEffort === "none" && modelCapabilities.supportsNonReasoningParameters)) {
+			if (!(effectiveReasoningEffort === "none" && modelCapabilities.reasoning.sampling === "reasoning-effort-none")) {
 				if (baseArgs.temperature != null) {
 					baseArgs.temperature = void 0;
 					warnings.push({
@@ -6468,7 +6966,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 						details: "topP is not supported for reasoning models"
 					});
 				}
-				if (modelCapabilities.supportedReasoningEfforts != null && (baseArgs.top_logprobs != null || baseArgs.include?.includes("message.output_text.logprobs"))) {
+				if (modelCapabilities.endpoints.responses.logprobsRequireNonReasoning && (baseArgs.top_logprobs != null || baseArgs.include?.includes("message.output_text.logprobs"))) {
 					baseArgs.top_logprobs = void 0;
 					const filteredInclude = baseArgs.include?.filter((value) => value !== "message.output_text.logprobs");
 					baseArgs.include = filteredInclude != null && filteredInclude.length > 0 ? filteredInclude : void 0;
@@ -6501,7 +6999,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 				details: "reasoningContext is not supported for non-reasoning models"
 			});
 		}
-		if (openaiOptions?.serviceTier === "flex" && !modelCapabilities.supportsFlexProcessing) {
+		if (openaiOptions?.serviceTier === "flex" && !modelCapabilities.serviceTiers.flex) {
 			warnings.push({
 				type: "unsupported",
 				feature: "serviceTier",
@@ -6509,7 +7007,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 			});
 			delete baseArgs.service_tier;
 		}
-		if ((openaiOptions?.serviceTier === "priority" || openaiOptions?.serviceTier === "fast") && !modelCapabilities.supportsPriorityProcessing) {
+		if ((openaiOptions?.serviceTier === "priority" || openaiOptions?.serviceTier === "fast") && !modelCapabilities.serviceTiers.priority) {
 			warnings.push({
 				type: "unsupported",
 				feature: "serviceTier",
@@ -6549,7 +7047,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 		const approvalRequestIdToDummyToolCallIdFromPrompt = extractApprovalRequestIdToToolCallIdMapping(options.prompt);
 		const { responseHeaders, value: response, rawValue: rawResponse } = await postJsonToApi({
 			url,
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			body,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiResponsesResponseSchema),
@@ -6999,7 +7497,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 		});
 		const { responseHeaders, value: response } = await postJsonToApi({
 			url,
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			body: {
 				...body,
 				stream: true
@@ -8152,7 +8650,7 @@ var OpenAIBatch = class {
 		formData.append("expires_after[seconds]", String(inputFileExpiresAfterSeconds));
 		const { value: uploadedFile } = await postToApi({
 			url: this.getUrl("/files"),
-			headers: combineHeaders(this.options.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.options.config.headers), options.headers),
 			body: {
 				content: formData,
 				values: {
@@ -8173,7 +8671,7 @@ var OpenAIBatch = class {
 		});
 		const { value: batch } = await postJsonToApi({
 			url: this.getUrl("/batches"),
-			headers: combineHeaders(this.options.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.options.config.headers), options.headers),
 			body: {
 				input_file_id: uploadedFile.id,
 				endpoint: openaiBatchEndpoint,
@@ -8215,7 +8713,7 @@ var OpenAIBatch = class {
 	async doCancelBatch(options) {
 		await postJsonToApi({
 			url: this.getUrl(`/batches/${encodeURIComponent(options.batchId)}/cancel`),
-			headers: combineHeaders(this.options.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.options.config.headers), options.headers),
 			body: {},
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiBatchResponseSchema),
@@ -8230,7 +8728,7 @@ var OpenAIBatch = class {
 		if (options.cursor != null) url.searchParams.set("after", options.cursor);
 		const { value: page } = await getFromApi({
 			url: url.toString(),
-			headers: combineHeaders(this.options.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.options.config.headers), options.headers),
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiBatchListResponseSchema),
 			abortSignal: options.abortSignal,
@@ -8266,7 +8764,7 @@ var OpenAIBatch = class {
 	async retrieveBatch(options) {
 		const { value: batch } = await getFromApi({
 			url: this.getUrl(`/batches/${encodeURIComponent(options.batchId)}`),
-			headers: combineHeaders(this.options.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.options.config.headers), options.headers),
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiBatchResponseSchema),
 			abortSignal: options.abortSignal,
@@ -8279,7 +8777,7 @@ var OpenAIBatch = class {
 		for (const fileId of fileIds) {
 			const { value: lines } = await getFromApi({
 				url: this.getUrl(`/files/${encodeURIComponent(fileId)}/content`),
-				headers: combineHeaders(this.options.config.headers?.(), options.headers),
+				headers: combineHeaders(await resolve(this.options.config.headers), options.headers),
 				failedResponseHandler: openaiFailedResponseHandler,
 				successfulResponseHandler: createJsonLinesResponseHandler(openaiBatchResultLineSchema, { maxLineBytes: this.options.maxLineBytes }),
 				abortSignal: options.abortSignal,
@@ -8952,13 +9450,7 @@ var OpenAIRealtimeModelLive = class {
 		this.modelId = modelId;
 		this.config = config;
 		this.specificationVersion = "v4";
-		this.capabilities = {
-			conversation: "continuous",
-			transports: ["websocket", "webrtc"],
-			connections: ["server-websocket", "webrtc"],
-			startup: "session-start",
-			finalization: "session-close"
-		};
+		this.capabilities = openaiLiveRealtimeCapabilities;
 	}
 	get provider() {
 		return this.config.provider;
@@ -8967,20 +9459,22 @@ var OpenAIRealtimeModelLive = class {
 		return { dataChannelLabel: "oai-events" };
 	}
 	getServerWebSocketConfig() {
-		const url = new URL(`${this.config.baseURL}/live/sessions`);
-		url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
-		const headers = {};
-		for (const [key, value] of Object.entries(this.config.headers())) if (value !== void 0) headers[key] = value;
-		return {
-			url: url.toString(),
-			headers
-		};
+		return resolveWith(this.config.headers, (configHeaders) => {
+			const url = new URL(`${this.config.baseURL}/live/sessions`);
+			url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
+			const headers = {};
+			for (const [key, value] of Object.entries(configHeaders)) if (value !== void 0) headers[key] = value;
+			return {
+				url: url.toString(),
+				headers
+			};
+		});
 	}
 	async doCreateWebRTCSession({ sdp, sessionConfig = {}, abortSignal }) {
 		const session = buildOpenAILiveSessionConfig(sessionConfig, this.modelId, "webrtc");
 		const { value } = await postJsonToApi({
 			url: `${this.config.baseURL}/live/sessions`,
-			headers: this.config.headers(),
+			headers: await resolve(this.config.headers),
 			body: {
 				session,
 				transport: {
@@ -9309,7 +9803,7 @@ var OpenAIRealtimeModel = class {
 		const response = await fetchFn(url, {
 			method: "POST",
 			headers: {
-				...this.config.headers(),
+				...await resolve(this.config.headers),
 				"Content-Type": "application/json"
 			},
 			body: JSON.stringify({
@@ -9349,7 +9843,6 @@ var OpenAIRealtimeModel = class {
 };
 //#endregion
 //#region src/realtime/openai-realtime-factory.ts
-const knownLiveModelIds = ["gpt-live-1"];
 function resolveRealtimeApi(modelId, { api } = {}) {
 	if (api !== void 0) {
 		if (api !== "live" && api !== "realtime") throw new InvalidArgumentError({
@@ -9358,7 +9851,7 @@ function resolveRealtimeApi(modelId, { api } = {}) {
 		});
 		return api;
 	}
-	return knownLiveModelIds.some((knownModelId) => knownModelId === modelId) ? "live" : "realtime";
+	return getOpenAIRealtimeModelEntry(modelId).requestConfig.realtime.api;
 }
 function createOpenAIRealtimeFactory(config) {
 	const createModel = (modelId, options) => {
@@ -9467,7 +9960,7 @@ var OpenAISpeechModel = class OpenAISpeechModel {
 				path: "/audio/speech",
 				modelId: this.modelId
 			}),
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			body: requestBody,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createBinaryResponseHandler(),
@@ -9584,34 +10077,6 @@ const openAITranscriptionModelOptions = lazySchema(() => zodSchema(z.object({
 })));
 //#endregion
 //#region src/transcription/openai-transcription-model.ts
-/**
-* Whether `modelId` is `base` or one of its dated snapshots
-* (e.g. `gpt-realtime-whisper-2026-01-01`).
-*/
-function isModelOrSnapshot(modelId, base) {
-	return modelId === base || modelId.startsWith(`${base}-`);
-}
-/**
-* Model IDs that stream over the realtime transcription WebSocket and do not
-* support the REST transcription endpoint.
-*/
-function isRealtimeTranscriptionModelId(modelId) {
-	return isModelOrSnapshot(modelId, "gpt-realtime-whisper") || isModelOrSnapshot(modelId, "gpt-live-transcribe");
-}
-/**
-* Model IDs that support streaming transcription. `gpt-transcribe` also
-* supports the REST transcription endpoint.
-*/
-function supportsStreamingTranscription(modelId) {
-	return isRealtimeTranscriptionModelId(modelId) || isModelOrSnapshot(modelId, "gpt-transcribe");
-}
-/**
-* Models whose realtime transcription session takes a `languages` list
-* instead of the singular `language` field.
-*/
-function usesLanguagesList(modelId) {
-	return isModelOrSnapshot(modelId, "gpt-live-transcribe") || isModelOrSnapshot(modelId, "gpt-transcribe");
-}
 const languageMap = {
 	afrikaans: "af",
 	arabic: "ar",
@@ -9704,10 +10169,10 @@ var OpenAITranscriptionModel = class OpenAITranscriptionModel {
 		formData.append("model", this.modelId);
 		const fileExtension = mediaTypeToExtension(mediaType);
 		formData.append("file", new File([blob], "audio", { type: mediaType }), `audio.${fileExtension}`);
-		const isDiarizationModel = this.modelId === "gpt-4o-transcribe-diarize";
-		const responseFormat = openAIOptions?.responseFormat ?? (isDiarizationModel ? "diarized_json" : this.modelId === "whisper-1" ? "verbose_json" : void 0);
+		const { transcription: requestConfig } = getOpenAITranscriptionModelEntry(this.modelId).requestConfig;
+		const responseFormat = openAIOptions?.responseFormat ?? requestConfig.responseFormat;
 		const timestampGranularities = openAIOptions?.timestampGranularities ?? (responseFormat === "verbose_json" ? ["segment"] : void 0);
-		const chunkingStrategy = openAIOptions?.chunkingStrategy ?? (isDiarizationModel ? "auto" : void 0);
+		const chunkingStrategy = openAIOptions?.chunkingStrategy ?? requestConfig.chunkingStrategy;
 		const transcriptionModelOptions = {
 			response_format: responseFormat,
 			include: openAIOptions?.include,
@@ -9732,7 +10197,7 @@ var OpenAITranscriptionModel = class OpenAITranscriptionModel {
 		};
 	}
 	async doGenerate(options) {
-		if (isRealtimeTranscriptionModelId(this.modelId)) throw new UnsupportedFunctionalityError({ functionality: `non-streaming transcription with ${this.modelId}` });
+		if (getOpenAITranscriptionModelEntry(this.modelId).capabilities.transcription.transcription === false) throw new UnsupportedFunctionalityError({ functionality: `non-streaming transcription with ${this.modelId}` });
 		const currentDate = this.config._internal?.currentDate?.() ?? /* @__PURE__ */ new Date();
 		const { formData, warnings } = await this.getArgs(options);
 		const { value: response, responseHeaders, rawValue: rawResponse } = await postFormDataToApi({
@@ -9740,7 +10205,7 @@ var OpenAITranscriptionModel = class OpenAITranscriptionModel {
 				path: "/audio/transcriptions",
 				modelId: this.modelId
 			}),
-			headers: combineHeaders(this.config.headers?.(), options.headers),
+			headers: combineHeaders(await resolve(this.config.headers), options.headers),
 			formData,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiTranscriptionResponseSchema),
@@ -9782,7 +10247,8 @@ var OpenAITranscriptionModel = class OpenAITranscriptionModel {
 		};
 	}
 	async doStream(options) {
-		if (!supportsStreamingTranscription(this.modelId)) throw new UnsupportedFunctionalityError({ functionality: `streaming transcription with ${this.modelId}` });
+		const entry = getOpenAITranscriptionModelEntry(this.modelId);
+		if (entry.capabilities.transcription.streaming !== true) throw new UnsupportedFunctionalityError({ functionality: `streaming transcription with ${this.modelId}` });
 		const currentDate = this.config._internal?.currentDate?.() ?? /* @__PURE__ */ new Date();
 		const openAIOptions = await parseProviderOptions({
 			provider: "openai",
@@ -9801,13 +10267,13 @@ var OpenAITranscriptionModel = class OpenAITranscriptionModel {
 			feature: `providerOptions.openai.${option}`,
 			details: `OpenAI streaming transcription does not support ${option}.`
 		});
-		const supportsDelay = !isModelOrSnapshot(this.modelId, "gpt-transcribe");
+		const supportsDelay = entry.capabilities.transcription.streamingDelay === true;
 		if (!supportsDelay && openAIOptions?.streaming?.delay != null) warnings.push({
 			type: "unsupported",
 			feature: "providerOptions.openai.streaming.delay",
 			details: `OpenAI streaming transcription with ${this.modelId} does not support delay.`
 		});
-		const headers = combineHeaders(this.config.headers?.(), options.headers);
+		const headers = combineHeaders(await resolve(this.config.headers), options.headers);
 		const sessionUpdate = buildOpenAIRealtimeTranscriptionSession({
 			modelId: this.modelId,
 			inputAudioFormat: options.inputAudioFormat,
@@ -9959,7 +10425,7 @@ function buildOpenAIRealtimeTranscriptionSession({ modelId, inputAudioFormat, pr
 				},
 				transcription: {
 					model: modelId,
-					...providerOptions?.language != null ? usesLanguagesList(modelId) ? { languages: [providerOptions.language] } : { language: providerOptions.language } : {},
+					...providerOptions?.language != null ? getOpenAITranscriptionModelEntry(modelId).requestConfig.transcription.languageField === "languages" ? { languages: [providerOptions.language] } : { language: providerOptions.language } : {},
 					...supportsDelay && providerOptions?.streaming?.delay != null ? { delay: providerOptions.streaming.delay } : {}
 				},
 				turn_detection: null
@@ -10027,7 +10493,7 @@ var OpenAISpeechTranslationModel = class OpenAISpeechTranslationModel {
 			feature: "outputAudioFormat",
 			details: "The OpenAI Realtime translation API always outputs 24kHz 16-bit PCM audio and does not accept an output audio format."
 		});
-		const headers = combineHeaders(this.config.headers?.(), options.headers);
+		const headers = combineHeaders(await resolve(this.config.headers), options.headers);
 		const sessionUpdate = buildOpenAIRealtimeSpeechTranslationSession({ targetLanguage: options.targetLanguage });
 		return {
 			request: { body: sessionUpdate },
@@ -10252,7 +10718,7 @@ var OpenAISkills = class {
 		}
 		const { value: response } = await postFormDataToApi({
 			url: this.config.url({ path: "/skills" }),
-			headers: combineHeaders(this.config.headers()),
+			headers: combineHeaders(await resolve(this.config.headers)),
 			formData,
 			failedResponseHandler: openaiFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(openaiSkillResponseSchema),
@@ -10274,7 +10740,7 @@ var OpenAISkills = class {
 };
 //#endregion
 //#region src/version.ts
-const VERSION = "4.0.104";
+const VERSION = "4.0.106";
 //#endregion
 //#region src/openai-provider.ts
 /**
@@ -10286,16 +10752,16 @@ function createOpenAI(options = {}) {
 		environmentVariableName: "OPENAI_BASE_URL"
 	}))) ?? "https://api.openai.com/v1";
 	const providerName = options.name ?? "openai";
-	const getHeaders = () => withUserAgentSuffix({
+	const getHeaders = () => resolveWith(options.apiKey, (apiKey) => withUserAgentSuffix({
 		Authorization: `Bearer ${loadApiKey({
-			apiKey: options.apiKey,
+			apiKey,
 			environmentVariableName: "OPENAI_API_KEY",
 			description: "OpenAI"
 		})}`,
 		"OpenAI-Organization": options.organization,
 		"OpenAI-Project": options.project,
 		...options.headers
-	}, `ai-sdk-openai/${VERSION}`);
+	}, `ai-sdk-openai/${VERSION}`));
 	const createChatModel = (modelId) => new OpenAIChatLanguageModel(modelId, {
 		provider: `${providerName}.chat`,
 		url: ({ path }) => `${baseURL}${path}`,