@ai-sdk/google 4.0.107 → 4.0.109

package/dist/index.js

@@ -1,9 +1,9 @@
-import { EXPERIMENTAL_EMBEDDING_MODEL_PROVIDER_OPTIONS_TRANSFORMER, WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, combineHeaders, connectToWebSocket, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertInlineFileDataToUint8Array, convertJsonResponseToolStream, convertToBase64, convertUint8ArrayToBase64, createEventSourceResponseHandler, createJsonErrorResponseHandler, createJsonLinesResponseHandler, createJsonResponseHandler, createNullLanguageModelUsage, createProviderExecutedToolFactory, createProviderStreamError, createToolNameMapping, delay, detectMediaType, downloadBlob, encodePathSegment, generateId, getFromApi, getRuntimeEnvironmentUserAgent, getTopLevelMediaType, isAbortError, isCustomReasoning, isFullMediaType, isRecord, isSameOrigin, isUrlSupported, lazySchema, loadApiKey, mapReasoningToProviderBudget, mapReasoningToProviderEffort, normalizeBatchRequestCounts, parseProviderOptions, postJsonToApi, postToApi, resolve, resolveFullMediaType, resolveProviderReference, safeParseJSON, safeValidateTypes, secureJsonParse, serializeModelOptions, waitForWebSocketBufferDrain, withUserAgentSuffix, withoutTrailingSlash, zodSchema } from "@ai-sdk/provider-utils";
+import { EXPERIMENTAL_EMBEDDING_MODEL_PROVIDER_OPTIONS_TRANSFORMER, WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, combineHeaders, connectToWebSocket, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertInlineFileDataToUint8Array, convertJsonResponseToolStream, convertToBase64, convertUint8ArrayToBase64, createEventSourceResponseHandler, createJsonErrorResponseHandler, createJsonLinesResponseHandler, createJsonResponseHandler, createNullLanguageModelUsage, createProviderExecutedToolFactory, createProviderStreamError, createToolNameMapping, delay, detectMediaType, downloadBlob, encodePathSegment, generateId, getFromApi, getRuntimeEnvironmentUserAgent, getTopLevelMediaType, isAbortError, isCustomReasoning, isFullMediaType, isRecord, isSameOrigin, isUrlSupported, lazySchema, loadApiKey, mapReasoningToProviderBudget, mapReasoningToProviderEffort, normalizeBatchRequestCounts, parseProviderOptions, postJsonToApi, postToApi, resolve, resolveFullMediaType, resolveProviderReference, resolveWith, safeParseJSON, safeValidateTypes, secureJsonParse, serializeModelOptions, waitForWebSocketBufferDrain, withUserAgentSuffix, withoutTrailingSlash, zodSchema } from "@ai-sdk/provider-utils";
 import { Experimental_DecisionLanguageModel } from "@ai-sdk/provider-utils/experimental-decision";
 import { AISDKError, InvalidArgumentError, InvalidResponseDataError, TooManyEmbeddingValuesForCallError, UnsupportedFunctionalityError } from "@ai-sdk/provider";
 import { z } from "zod/v4";
 //#region src/version.ts
-const VERSION = "4.0.107";
+const VERSION = "4.0.109";
 //#endregion
 //#region src/google-error.ts
 const getGoogleErrorSchema = () => z.object({
@@ -310,6 +310,16 @@ function addTokenDetails(a, b) {
 	}));
 }
 //#endregion
+//#region src/google-prompt.ts
+const googleVideoMetadataSchema = z.object({
+	/** Start offset as a duration in seconds, e.g. `'3.5s'`. */
+	startOffset: z.string().optional(),
+	/** End offset as a duration in seconds, e.g. `'10s'`. */
+	endOffset: z.string().optional(),
+	/** Frames per second in the range (0, 24]. Defaults to 1. */
+	fps: z.number().gt(0).max(24).optional()
+});
+//#endregion
 //#region src/tool/code-execution.ts
 const codeExecutionInputSchema = z.object({
 	language: z.string().describe("The programming language of the code."),
@@ -470,33 +480,50 @@ function convertToGoogleMessages(prompt, options) {
 				case "text":
 					parts.push({ text: part.text });
 					break;
-				case "file": switch (part.data.type) {
-					case "url":
-						parts.push({ fileData: {
-							mimeType: resolveFullMediaType({ part }),
-							fileUri: part.data.url.protocol === "gs:" && part.data.originalUrl != null ? part.data.originalUrl : part.data.url.toString()
-						} });
-						break;
-					case "reference":
-						if (isVertexLike) throw new UnsupportedFunctionalityError({ functionality: "file parts with provider references" });
-						parts.push({ fileData: {
-							mimeType: resolveFullMediaType({ part }),
-							fileUri: resolveProviderReference({
-								reference: part.data.reference,
-								provider: "google"
-							})
-						} });
-						break;
-					case "text":
-						parts.push({ inlineData: {
-							mimeType: isFullMediaType(part.mediaType) ? part.mediaType : "text/plain",
-							data: convertToBase64(new TextEncoder().encode(part.data.text))
-						} });
-						break;
-					case "data": parts.push({ inlineData: {
-						mimeType: resolveFullMediaType({ part }),
-						data: convertToBase64(part.data.data)
-					} });
+				case "file": {
+					const rawVideoMetadata = readProviderOpts(part)?.videoMetadata;
+					const videoMetadata = rawVideoMetadata == null ? void 0 : googleVideoMetadataSchema.parse(rawVideoMetadata);
+					switch (part.data.type) {
+						case "url":
+							parts.push({
+								fileData: {
+									mimeType: resolveFullMediaType({ part }),
+									fileUri: part.data.url.protocol === "gs:" && part.data.originalUrl != null ? part.data.originalUrl : part.data.url.toString()
+								},
+								...videoMetadata != null ? { videoMetadata } : {}
+							});
+							break;
+						case "reference":
+							if (isVertexLike) throw new UnsupportedFunctionalityError({ functionality: "file parts with provider references" });
+							parts.push({
+								fileData: {
+									mimeType: resolveFullMediaType({ part }),
+									fileUri: resolveProviderReference({
+										reference: part.data.reference,
+										provider: "google"
+									})
+								},
+								...videoMetadata != null ? { videoMetadata } : {}
+							});
+							break;
+						case "text":
+							parts.push({
+								inlineData: {
+									mimeType: isFullMediaType(part.mediaType) ? part.mediaType : "text/plain",
+									data: convertToBase64(new TextEncoder().encode(part.data.text))
+								},
+								...videoMetadata != null ? { videoMetadata } : {}
+							});
+							break;
+						case "data": parts.push({
+							inlineData: {
+								mimeType: resolveFullMediaType({ part }),
+								data: convertToBase64(part.data.data)
+							},
+							...videoMetadata != null ? { videoMetadata } : {}
+						});
+					}
+					break;
 				}
 			}
 			contents.push({
@@ -1003,11 +1030,129 @@ const googleLanguageModelOptions = lazySchema(() => zodSchema(z.object({
 	requestType: z.enum(["shared"]).optional()
 })));
 //#endregion
-//#region src/google-model-capabilities.ts
+//#region src/google-model-catalog.ts
 const gemini1ModelPattern = /(^|[/.])gemini-1(?:[.-]|$)/i;
 const gemini2ModelPattern = /(^|[/.])gemini-2(?:[.-]|$)/i;
-const gemini25ModelPattern$1 = /(^|[/.])gemini-2\.5(?:[.-]|$)/i;
+const gemini25ModelPattern = /(^|[/.])gemini-2\.5(?:[.-]|$)/i;
 const geminiModelPattern = /(^|[/.])gemini-/i;
+/** Options accepted under providerOptions.google (or googleVertex on Vertex). */
+const googleProviderOptions = { language: {
+	responseModalities: { description: "Response modalities to generate." },
+	thinkingConfig: { description: "Thinking budget, level, and thought output." },
+	cachedContent: { description: "Cached content to use as request context." },
+	structuredOutputs: { description: "Whether to send the JSON response schema." },
+	safetySettings: { description: "Safety settings for the request." },
+	threshold: { description: "Default threshold for configurable safety categories." },
+	audioTimestamp: { description: "Enable timestamp understanding for audio." },
+	labels: { description: "Billing labels. Vertex AI only." },
+	mediaResolution: { description: "Resolution used to process media inputs." },
+	imageConfig: { description: "Image generation configuration." },
+	retrievalConfig: { description: "Retrieval configuration for tools." },
+	streamFunctionCallArguments: { description: "Stream function arguments. Vertex AI only." },
+	serviceTier: { description: "Service tier. Gemini API only." },
+	continuationToken: { description: "Resume a response using its continuation token." },
+	sharedRequestType: { description: "Shared PayGo tier. Vertex AI only." },
+	requestType: { description: "Request routing type. Vertex AI only." }
+} };
+const standard = {
+	image: true,
+	objectGeneration: true,
+	tools: true,
+	streaming: true,
+	googleSearch: true,
+	urlContext: true
+};
+const googleModelCatalog = Object.fromEntries(Object.entries({
+	"gemini-nano-banana-2.1": {
+		image: true,
+		objectGeneration: false,
+		tools: false,
+		streaming: false,
+		googleSearch: true,
+		urlContext: false
+	},
+	"gemini-4-argon": standard,
+	"gemini-3.8-flash": standard,
+	"gemini-3.7-flash": standard,
+	"gemini-3.6-flash": standard,
+	"gemini-3.5-flash": standard,
+	"gemini-3.5-flash-lite": standard,
+	"gemini-3.1-pro-preview": standard,
+	"gemini-3.1-flash-image-preview": standard,
+	"gemini-3.1-flash-lite-preview": standard,
+	"gemini-3-pro-preview": standard,
+	"gemini-3-pro-image-preview": standard,
+	"gemini-3-flash-preview": standard,
+	"gemini-2.5-pro": standard,
+	"gemini-2.5-flash": standard,
+	"gemini-2.5-flash-lite": standard,
+	"gemini-2.5-flash-lite-preview-06-17": standard,
+	"gemini-2.0-flash": standard
+}).map(([modelId, documented]) => [modelId, createGoogleLanguageModelEntry(modelId, documented)]));
+function getGoogleLanguageModelEntry(modelId) {
+	return Object.prototype.hasOwnProperty.call(googleModelCatalog, modelId) ? googleModelCatalog[modelId] : createGoogleLanguageModelEntry(modelId);
+}
+function createGoogleLanguageModelEntry(modelId, documented) {
+	const runtime = resolveRuntimeDefinition(modelId);
+	const declared = documented != null;
+	const id = modelId.toLowerCase();
+	const thinkingFormat = runtime.usesGemini3Features && !modelId.includes("gemini-3-pro-image") ? "level" : "budget";
+	const minLevel = getMinimumThinkingLevelForGemini3Model(modelId);
+	return {
+		capabilities: { language: {
+			inputs: {
+				image: documented?.image ?? "unknown",
+				audio: "unknown"
+			},
+			objectGeneration: documented?.objectGeneration ?? "unknown",
+			tools: {
+				usage: documented?.tools ?? "unknown",
+				streaming: documented?.streaming ?? "unknown",
+				gemini2: runtime.supportsGemini2Tools,
+				googleSearch: documented?.googleSearch ?? "unknown",
+				urlContext: documented?.urlContext ?? "unknown",
+				fileSearch: runtime.supportsFileSearch,
+				mixed: runtime.usesGemini3Features,
+				functionResponseParts: runtime.usesGemini3Features
+			},
+			reasoning: {
+				support: "unknown",
+				efforts: thinkingFormat === "level" ? [
+					...minLevel === "minimal" ? ["minimal"] : [],
+					"low",
+					"medium",
+					"high"
+				] : void 0,
+				minBudget: id.includes("2.5-pro") ? 128 : 0,
+				maxBudget: id.includes("2.5-pro") || id.includes("gemini-3-pro-image") ? 32768 : 24576
+			},
+			sampling: {
+				temperature: "unknown",
+				topP: "unknown",
+				topK: "unknown",
+				logprobs: false,
+				penalties: gemini25ModelPattern.test(modelId) ? { condition: "Only supported on the Vertex AI API." } : true
+			},
+			structuredOutput: { withFunctionTools: runtime.usesGemini3Features }
+		} },
+		providerOptions: { language: declareProviderOptions(declared ? true : "unknown", {
+			labels: { condition: "Only supported on the Vertex AI API." },
+			sharedRequestType: { condition: "Only supported on the Vertex AI API." },
+			requestType: { condition: "Only supported on the Vertex AI API." },
+			serviceTier: { condition: "Only supported on the Gemini API." },
+			streamFunctionCallArguments: { condition: "Only supported for streaming requests on the Vertex AI API with Gemini 3 or newer." }
+		}) },
+		requestConfig: { language: {
+			systemInstruction: id.startsWith("gemma-") ? "user" : "system",
+			thinkingFormat,
+			reasoningMaxOutputTokens: 65536,
+			jsonResponseTool: /(^|\/)gemini-/i.test(modelId)
+		} }
+	};
+}
+function declareProviderOptions(support, exceptions) {
+	return Object.fromEntries(Object.keys(googleProviderOptions.language).map((option) => [option, exceptions[option] ?? support]));
+}
 function isKnownPreGemini2Model(modelId) {
 	return gemini1ModelPattern.test(modelId) || /(^|[/.])gemini-pro(?:-vision)?$/i.test(modelId) || /(^|[/.])gemini-robotics-er-1\.5(?:[.-]|$)/i.test(modelId);
 }
@@ -1018,17 +1163,39 @@ function isKnownPreGemini2Model(modelId) {
 * intentionally inherit the newest supported behavior. Add exceptions here
 * only when a model is known to require a legacy request shape.
 */
-function getGoogleModelCapabilities(modelId) {
+function resolveRuntimeDefinition(modelId) {
 	const isGeminiModel = geminiModelPattern.test(modelId);
 	const isGemini2Model = gemini2ModelPattern.test(modelId);
 	const isKnownPreGemini2 = isKnownPreGemini2Model(modelId);
 	const usesGemini3Features = isGeminiModel && !(isKnownPreGemini2 || isGemini2Model);
 	return {
 		supportsGemini2Tools: isGeminiModel && !isKnownPreGemini2 || modelId.toLowerCase().includes("nano-banana"),
-		supportsFileSearch: gemini25ModelPattern$1.test(modelId) || usesGemini3Features,
+		supportsFileSearch: gemini25ModelPattern.test(modelId) || usesGemini3Features,
 		usesGemini3Features
 	};
 }
+function getMinimumThinkingLevelForGemini3Model(modelId) {
+	const modelName = /(?:^|[/.])(gemini-[^/]*)$/i.exec(modelId)?.[1].toLowerCase();
+	if (modelName === "gemini-flash-latest") return "low";
+	const proVersionMatch = /^gemini-(\d+)(?:\.\d+)?-pro(?:$|-)/.exec(modelName ?? "");
+	if (Number(proVersionMatch?.[1]) >= 3) return "low";
+	const versionMatch = /^gemini-(\d+)\.(\d+)-flash(?:$|-(?!lite(?:-|$)))/.exec(modelName ?? "");
+	if (versionMatch == null) return "minimal";
+	const majorVersion = Number(versionMatch[1]);
+	const minorVersion = Number(versionMatch[2]);
+	return majorVersion > 3 || majorVersion === 3 && minorVersion >= 7 ? "low" : "minimal";
+}
+//#endregion
+//#region src/google-model-capabilities.ts
+/** Compatibility projection of the resolved catalog for existing request code. */
+function getGoogleModelCapabilities(modelId) {
+	const { tools } = getGoogleLanguageModelEntry(modelId).capabilities.language;
+	return {
+		supportsGemini2Tools: tools.gemini2,
+		supportsFileSearch: tools.fileSearch,
+		usesGemini3Features: tools.mixed
+	};
+}
 //#endregion
 //#region src/google-prepare-tools.ts
 function prepareTools({ tools, toolChoice, modelId, isVertexProvider = false }) {
@@ -1233,11 +1400,16 @@ var GoogleJSONAccumulator = class {
 				const escaped = JSON.stringify(arg.stringValue).slice(1, -1);
 				setNestedValue(this.accumulatedArgs, segments, existingValue + arg.stringValue);
 				delta += escaped;
+				if (arg.willContinue !== true) delta += this.closeOpenString();
 				continue;
 			}
 			const resolved = resolvePartialArgValue(arg);
 			if (resolved == null) {
-				if (existingValue !== void 0 || arg.willContinue === true) continue;
+				if (existingValue !== void 0) {
+					if (typeof existingValue === "string" && arg.willContinue !== true) delta += this.closeOpenString();
+					continue;
+				}
+				if (arg.willContinue === true) continue;
 				setNestedValue(this.accumulatedArgs, segments, isArrayTerminator ? [] : {});
 				delta += this.emitContainer(segments, isArrayTerminator);
 				continue;
@@ -1263,6 +1435,15 @@ var GoogleJSONAccumulator = class {
 		};
 	}
 	/**
+	* Input: stringOpen=true
+	* Output: '"' (and stringOpen=false), or '' when no string is open
+	*/
+	closeOpenString() {
+		if (!this.stringOpen) return "";
+		this.stringOpen = false;
+		return "\"";
+	}
+	/**
 	* Input: pathStack=[] (first call) or pathStack=[root,...] (subsequent calls)
 	* Output: '{' (first call) or '' (subsequent calls)
 	*/
@@ -1285,11 +1466,7 @@ var GoogleJSONAccumulator = class {
 	* Output: '{"recipe":{"name":"Lasagna"'
 	*/
 	emitNavigationTo(targetSegments, arg, valueJson) {
-		let fragment = "";
-		if (this.stringOpen) {
-			fragment += "\"";
-			this.stringOpen = false;
-		}
+		let fragment = this.closeOpenString();
 		fragment += this.ensureRoot();
 		const targetContainerSegments = targetSegments.slice(0, -1);
 		const leafSegment = targetSegments[targetSegments.length - 1];
@@ -1308,11 +1485,7 @@ var GoogleJSONAccumulator = class {
 	* Output: '{"nested":{"tags":['
 	*/
 	emitContainer(targetSegments, isArray) {
-		let fragment = "";
-		if (this.stringOpen) {
-			fragment += "\"";
-			this.stringOpen = false;
-		}
+		let fragment = this.closeOpenString();
 		fragment += this.ensureRoot();
 		const commonDepth = this.findCommonStackDepth(targetSegments);
 		fragment += this.closeDownTo(commonDepth);
@@ -1504,7 +1677,6 @@ const configurableSafetySettingCategories = [
 	"HARM_CATEGORY_HARASSMENT",
 	"HARM_CATEGORY_SEXUALLY_EXPLICIT"
 ];
-const gemini25ModelPattern = /(^|[/.])gemini-2\.5(?:[.-]|$)/i;
 const googleCloudStorageFunctionResponseUrls = {
 	"image/png": [/^gs:\/\/.*$/],
 	"image/jpeg": [/^gs:\/\/.*$/],
@@ -1589,8 +1761,9 @@ var GoogleLanguageModel = class GoogleLanguageModel {
 				imageConfig = geminiApiImageConfig;
 			}
 		}
-		const isGemmaModel = modelId.toLowerCase().startsWith("gemma-");
-		const isGemini25DeveloperApiModel = !isVertexProvider && gemini25ModelPattern.test(modelId);
+		const entry = getGoogleLanguageModelEntry(modelId);
+		const isGemmaModel = entry.requestConfig.language.systemInstruction === "user";
+		const isGemini25DeveloperApiModel = !isVertexProvider && entry.capabilities.language.sampling.penalties !== true;
 		if (isGemini25DeveloperApiModel && frequencyPenalty != null) warnings.push({
 			type: "unsupported",
 			feature: "frequencyPenalty"
@@ -1599,7 +1772,7 @@ var GoogleLanguageModel = class GoogleLanguageModel {
 			type: "unsupported",
 			feature: "presencePenalty"
 		});
-		const { usesGemini3Features } = getGoogleModelCapabilities(modelId);
+		const usesGemini3Features = entry.capabilities.language.tools.functionResponseParts;
 		const supportedFunctionResponseUrls = usesGemini3Features && config.downloadToolResultFiles?.supportsGoogleCloudStorageUrls ? googleCloudStorageFunctionResponseUrls : void 0;
 		const { contents, systemInstruction } = convertToGoogleMessages(config.downloadToolResultFiles ? await downloadToolResultFiles(prompt, {
 			abortSignal,
@@ -1684,8 +1857,10 @@ var GoogleLanguageModel = class GoogleLanguageModel {
 	}
 	async getArgs(options, { isStreaming = false } = {}) {
 		const { responseFormat, tools, toolChoice } = options;
+		const entry = getGoogleLanguageModelEntry(this.modelId);
+		const { structuredOutput } = entry.capabilities.language;
 		let jsonResponseTool;
-		if (responseFormat?.type === "json" && responseFormat.schema != null && tools?.some((tool) => tool.type === "function") && /(^|\/)gemini-/i.test(this.modelId) && (!getGoogleModelCapabilities(this.modelId).usesGemini3Features || toolChoice?.type === "required" || toolChoice?.type === "tool")) {
+		if (responseFormat?.type === "json" && responseFormat.schema != null && tools?.some((tool) => tool.type === "function") && entry.requestConfig.language.jsonResponseTool && (!structuredOutput.withFunctionTools || toolChoice?.type === "required" || toolChoice?.type === "tool")) {
 			let name = "json";
 			for (let suffix = 1; tools.some((tool) => tool.name === name); suffix++) name = `json_${suffix}`;
 			jsonResponseTool = {
@@ -1855,10 +2030,9 @@ var GoogleLanguageModel = class GoogleLanguageModel {
 	}
 	async doGenerate(options) {
 		const { args, warnings, providerOptionsNames, extraHeaders, toolNameMapping, jsonResponseToolName } = await this.getArgs(options);
-		const mergedHeaders = combineHeaders(this.config.headers ? await resolve(this.config.headers) : void 0, options.headers, extraHeaders);
-		const generateContent = (body) => postJsonToApi({
+		const generateContent = async (body) => postJsonToApi({
 			url: `${this.config.baseURL}/${getModelPath(this.modelId)}:generateContent`,
-			headers: mergedHeaders,
+			headers: combineHeaders(await resolve(this.config.headers), options.headers, extraHeaders),
 			body,
 			failedResponseHandler: googleFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(responseSchema),
@@ -1921,10 +2095,9 @@ var GoogleLanguageModel = class GoogleLanguageModel {
 	async doStream(options) {
 		const { args, warnings, providerOptionsNames, extraHeaders, toolNameMapping, jsonResponseToolName } = await this.getArgs(options, { isStreaming: true });
 		const wrapProviderMetadata = (payload) => Object.fromEntries(providerOptionsNames.map((name) => [name, payload]));
-		const headers = combineHeaders(this.config.headers ? await resolve(this.config.headers) : void 0, options.headers, extraHeaders);
-		const streamGenerateContent = (body) => postJsonToApi({
+		const streamGenerateContent = async (body) => postJsonToApi({
 			url: `${this.config.baseURL}/${getModelPath(this.modelId)}:streamGenerateContent?alt=sse`,
-			headers,
+			headers: combineHeaders(await resolve(this.config.headers), options.headers, extraHeaders),
 			body,
 			failedResponseHandler: googleFailedResponseHandler,
 			successfulResponseHandler: createEventSourceResponseHandler(chunkSchema),
@@ -2377,17 +2550,9 @@ var GoogleLanguageModel = class GoogleLanguageModel {
 		};
 	}
 };
-function getMaxOutputTokensForGemini25Model() {
-	return 65536;
-}
-function getMaxThinkingTokensForGemini25Model(modelId) {
-	const id = modelId.toLowerCase();
-	if (id.includes("2.5-pro") || id.includes("gemini-3-pro-image")) return 32768;
-	return 24576;
-}
 function resolveThinkingConfig({ reasoning, modelId, warnings }) {
 	if (!isCustomReasoning(reasoning)) return;
-	if (getGoogleModelCapabilities(modelId).usesGemini3Features && !modelId.includes("gemini-3-pro-image")) return resolveGemini3ThinkingConfig({
+	if (getGoogleLanguageModelEntry(modelId).requestConfig.language.thinkingFormat === "level") return resolveGemini3ThinkingConfig({
 		reasoning,
 		modelId,
 		warnings
@@ -2399,45 +2564,31 @@ function resolveThinkingConfig({ reasoning, modelId, warnings }) {
 	});
 }
 function resolveGemini3ThinkingConfig({ reasoning, modelId, warnings }) {
-	const minimumThinkingLevel = getMinimumThinkingLevelForGemini3Model(modelId);
-	if (reasoning === "none") return { thinkingLevel: minimumThinkingLevel };
+	const minimumThinkingLevel = getGoogleLanguageModelEntry(modelId).capabilities.language.reasoning.efforts?.[0];
 	const thinkingLevel = mapReasoningToProviderEffort({
 		reasoning,
 		effortMap: {
-			minimal: minimumThinkingLevel,
+			...minimumThinkingLevel === "minimal" && { minimal: "minimal" },
 			low: "low",
 			medium: "medium",
-			high: "high",
-			xhigh: "high",
-			max: "high"
+			high: "high"
 		},
 		warnings
 	});
 	if (thinkingLevel == null) return;
 	return { thinkingLevel };
 }
-function getMinimumThinkingLevelForGemini3Model(modelId) {
-	const modelName = /(?:^|[/.])(gemini-[^/]*)$/i.exec(modelId)?.[1].toLowerCase();
-	if (modelName === "gemini-flash-latest") return "low";
-	const proVersionMatch = /^gemini-(\d+)(?:\.\d+)?-pro(?:$|-)/.exec(modelName ?? "");
-	if (Number(proVersionMatch?.[1]) >= 3) return "low";
-	const versionMatch = /^gemini-(\d+)\.(\d+)-flash(?:$|-(?!lite(?:-|$)))/.exec(modelName ?? "");
-	if (versionMatch == null) return "minimal";
-	const majorVersion = Number(versionMatch[1]);
-	const minorVersion = Number(versionMatch[2]);
-	return majorVersion > 3 || majorVersion === 3 && minorVersion >= 7 ? "low" : "minimal";
-}
 function resolveGemini25ThinkingConfig({ reasoning, modelId, warnings }) {
-	if (reasoning === "none") return { thinkingBudget: 0 };
-	const thinkingBudget = mapReasoningToProviderBudget({
+	const entry = getGoogleLanguageModelEntry(modelId);
+	const minThinkingBudget = entry.capabilities.language.reasoning.minBudget;
+	if (reasoning === "none" && minThinkingBudget === 0) return { thinkingBudget: 0 };
+	return { thinkingBudget: mapReasoningToProviderBudget({
 		reasoning,
-		maxOutputTokens: getMaxOutputTokensForGemini25Model(),
-		maxReasoningBudget: getMaxThinkingTokensForGemini25Model(modelId),
-		minReasoningBudget: 0,
+		maxOutputTokens: entry.requestConfig.language.reasoningMaxOutputTokens,
+		maxReasoningBudget: entry.capabilities.language.reasoning.maxBudget,
+		minReasoningBudget: minThinkingBudget,
 		warnings
-	});
-	if (thinkingBudget == null) return;
-	return { thinkingBudget };
+	}) };
 }
 function extractSources({ groundingMetadata, generateId }) {
 	if (!groundingMetadata?.groundingChunks) return;
@@ -2850,12 +3001,11 @@ var GoogleBatch = class {
 				warning
 			});
 		}
-		const headers = await this.getHeaders(options.headers);
 		const createUrl = `${this.batchConfig.baseURL}/${getModelPath(modelId)}:batchGenerateContent`;
 		if (fileParts == null) {
 			const { value: operation } = await postJsonToApi({
 				url: createUrl,
-				headers,
+				headers: await this.getHeaders(options.headers),
 				body: inlineBatchBody,
 				failedResponseHandler: googleFailedResponseHandler,
 				successfulResponseHandler: createJsonResponseHandler(googleBatchOperationSchema),
@@ -2876,7 +3026,7 @@ var GoogleBatch = class {
 		});
 		const { value: uploadUrl } = await postJsonToApi({
 			url: `${this.getBaseOrigin()}/upload/v1beta/files`,
-			headers: combineHeaders(headers, {
+			headers: combineHeaders(await this.getHeaders(options.headers), {
 				"X-Goog-Upload-Protocol": "resumable",
 				"X-Goog-Upload-Command": "start",
 				"X-Goog-Upload-Header-Content-Length": String(inputFile.size),
@@ -2909,7 +3059,7 @@ var GoogleBatch = class {
 		});
 		const { value: operation } = await postJsonToApi({
 			url: createUrl,
-			headers,
+			headers: await this.getHeaders(options.headers),
 			body: { batch: {
 				displayName,
 				...options.webhookUrl != null && { webhookConfig: { uris: [options.webhookUrl] } },
@@ -3531,7 +3681,7 @@ var GoogleFiles = class {
 			providerOptions: options.providerOptions,
 			schema: googleFilesUploadOptionsSchema
 		});
-		const resolvedHeaders = combineHeaders(this.config.headers(), options.headers);
+		const getHeaders = async () => combineHeaders(await resolve(this.config.headers), options.headers);
 		const fetchFn = this.config.fetch ?? globalThis.fetch;
 		const warnings = [];
 		if (options.filename != null) warnings.push({
@@ -3544,7 +3694,7 @@ var GoogleFiles = class {
 		const initResponse = await fetchFn(`${this.config.baseURL.replace(/\/v1beta$/, "")}/upload/v1beta/files`, {
 			method: "POST",
 			headers: {
-				...resolvedHeaders,
+				...await getHeaders(),
 				"X-Goog-Upload-Protocol": "resumable",
 				"X-Goog-Upload-Command": "start",
 				"X-Goog-Upload-Header-Content-Length": String(fileBytes.length),
@@ -3597,7 +3747,7 @@ var GoogleFiles = class {
 			const { value: fileStatus } = await getFromApi({
 				url: `${this.config.baseURL}/${filePath}`,
 				validateUrl: false,
-				headers: combineHeaders(resolvedHeaders),
+				headers: await getHeaders(),
 				successfulResponseHandler: createJsonResponseHandler(googleFileResponseSchema),
 				failedResponseHandler: googleFailedResponseHandler,
 				abortSignal: options.abortSignal,
@@ -6111,7 +6261,7 @@ async function cancelGoogleInteraction({ baseURL, interactionId, headers, fetch
 	try {
 		const response = await fetch(url, {
 			method: "POST",
-			headers: withUserAgentSuffix(combineHeaders({ "Content-Type": "application/json" }, headers), getRuntimeEnvironmentUserAgent()),
+			headers: withUserAgentSuffix(combineHeaders({ "Content-Type": "application/json" }, await resolve(headers)), getRuntimeEnvironmentUserAgent()),
 			body: "{}"
 		});
 		try {
@@ -6161,7 +6311,7 @@ async function pollGoogleInteractionUntilTerminal({ baseURL, interactionId, head
 			const { value: response, rawValue: rawResponse, responseHeaders } = await getFromApi({
 				url,
 				validateUrl: false,
-				headers,
+				headers: await resolve(headers),
 				failedResponseHandler: googleFailedResponseHandler,
 				successfulResponseHandler: createJsonResponseHandler(googleInteractionsResponseSchema),
 				abortSignal,
@@ -6356,10 +6506,6 @@ const DEFAULT_RETRY_DELAY_MS = 500;
 */
 function streamGoogleInteractionEvents({ baseURL, interactionId, headers, fetch, abortSignal, maxRetries = DEFAULT_MAX_RETRIES, retryDelayMs = DEFAULT_RETRY_DELAY_MS }) {
 	if (interactionId.length === 0) throw new Error("google.interactions: cannot stream a background interaction without an id.");
-	const eventSourceHeaders = {
-		...headers,
-		accept: "text/event-stream"
-	};
 	let lastEventId;
 	let complete = false;
 	let attempt = 0;
@@ -6382,7 +6528,10 @@ function streamGoogleInteractionEvents({ baseURL, interactionId, headers, fetch,
 		const { value: stream } = await getFromApi({
 			url: buildUrl(),
 			validateUrl: false,
-			headers: eventSourceHeaders,
+			headers: {
+				...await resolve(headers),
+				accept: "text/event-stream"
+			},
 			failedResponseHandler: googleFailedResponseHandler,
 			successfulResponseHandler: createEventSourceResponseHandler(googleInteractionsEventSchema),
 			abortSignal: effectiveSignal,
@@ -6853,10 +7002,10 @@ var GoogleInteractionsLanguageModel = class GoogleInteractionsLanguageModel {
 	async doGenerate(options) {
 		const { args, warnings, isAgent, isBackground, pollingTimeoutMs } = await this.getArgs(options);
 		const url = `${this.config.baseURL}/interactions`;
-		const mergedHeaders = combineHeaders(this.config.headers ? await resolve(this.config.headers) : void 0, options.headers);
+		const mergedHeaders = async () => combineHeaders(await resolve(this.config.headers), options.headers);
 		let { responseHeaders, value: response, rawValue: rawResponse } = await postJsonToApi({
 			url,
-			headers: mergedHeaders,
+			headers: await resolve(mergedHeaders),
 			body: args,
 			failedResponseHandler: googleFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(googleInteractionsResponseSchema),
@@ -6920,7 +7069,7 @@ var GoogleInteractionsLanguageModel = class GoogleInteractionsLanguageModel {
 	async doStream(options) {
 		const { args, warnings, isBackground, pollingTimeoutMs } = await this.getArgs(options);
 		const url = `${this.config.baseURL}/interactions`;
-		const mergedHeaders = combineHeaders(this.config.headers ? await resolve(this.config.headers) : void 0, options.headers);
+		const mergedHeaders = async () => combineHeaders(await resolve(this.config.headers), options.headers);
 		if (isBackground) return this.doStreamBackground({
 			args,
 			warnings,
@@ -6935,7 +7084,7 @@ var GoogleInteractionsLanguageModel = class GoogleInteractionsLanguageModel {
 		};
 		const { responseHeaders, value: response } = await postJsonToApi({
 			url,
-			headers: mergedHeaders,
+			headers: await resolve(mergedHeaders),
 			body,
 			failedResponseHandler: googleFailedResponseHandler,
 			successfulResponseHandler: createEventSourceResponseHandler(googleInteractionsEventSchema),
@@ -6958,7 +7107,7 @@ var GoogleInteractionsLanguageModel = class GoogleInteractionsLanguageModel {
 	async doStreamBackground({ args, warnings, url, mergedHeaders, options, pollingTimeoutMs }) {
 		const { responseHeaders: postHeaders, value: postResponse } = await postJsonToApi({
 			url,
-			headers: mergedHeaders,
+			headers: await resolve(mergedHeaders),
 			body: args,
 			failedResponseHandler: googleFailedResponseHandler,
 			successfulResponseHandler: createJsonResponseHandler(googleInteractionsResponseSchema),
@@ -7392,7 +7541,7 @@ var GoogleRealtimeModel = class {
 	}
 	async doCreateClientSecret(options) {
 		const fetchFn = this.config.fetch ?? fetch;
-		const apiKey = this.config.headers()["x-goog-api-key"];
+		const apiKey = (await resolve(this.config.headers))["x-goog-api-key"];
 		if (!apiKey) throw new Error("Google Generative AI API key is required for realtime token creation.");
 		const now = Date.now();
 		const openWindowMs = (options.expiresAfterSeconds ?? 60) * 1e3;
@@ -7917,7 +8066,7 @@ var GoogleSpeechTranslationModel = class GoogleSpeechTranslationModel {
 			feature: "outputAudioFormat",
 			details: "The Gemini Live 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);
 		let apiKey;
 		for (const [key, value] of Object.entries(headers)) if (key.toLowerCase() === "x-goog-api-key" && value != null) apiKey = value;
 		if (apiKey == null) throw new Error("Google Generative AI API key is required for streaming translation.");
@@ -8233,14 +8382,14 @@ function supportsExternalFileUrls(modelId) {
 function createGoogle(options = {}) {
 	const baseURL = withoutTrailingSlash(options.baseURL) ?? DEFAULT_BASE_URL;
 	const providerName = options.name ?? "google.generative-ai";
-	const getHeaders = () => withUserAgentSuffix({
+	const getHeaders = () => resolveWith(options.apiKey, (apiKey) => withUserAgentSuffix({
 		"x-goog-api-key": loadApiKey({
-			apiKey: options.apiKey,
+			apiKey,
 			environmentVariableName: "GOOGLE_GENERATIVE_AI_API_KEY",
 			description: "Google Generative AI"
 		}),
 		...options.headers
-	}, `ai-sdk-google/${VERSION}`);
+	}, `ai-sdk-google/${VERSION}`));
 	const getSupportedUrls = (modelId, includeExternalUrls = modelId == null || supportsExternalFileUrls(modelId)) => ({
 		"*": [
 			googleFilesUrlPattern,