@ai-sdk/google 4.0.22 → 4.0.24

package/docs/15-google.mdx

@@ -91,6 +91,16 @@ Google language models can also be used in the `streamText` function
 and support structured data generation with [`Output`](/docs/reference/ai-sdk-core/output)
 (see [AI SDK Core](/docs/ai-sdk-core)).
 
+<Note>
+  To remain forward-compatible, the provider treats unrecognized `gemini-*`
+  model IDs and `-latest` aliases like the newest supported Gemini generation.
+  Currently, this means Gemini 3 request behavior for provider-defined and mixed
+  tools, `thinkingLevel` reasoning, multimodal function responses, and thought
+  signatures. Known legacy Gemini model IDs keep their generation-specific
+  request behavior. This SDK default controls request serialization; the
+  selected model must still support each feature in the Google API.
+</Note>
+
 Google also supports some model specific settings that are not part of the [standard call settings](/docs/ai-sdk-core/settings).
 You can pass them as an options argument:
 
@@ -163,7 +173,7 @@ The following optional provider options are available for Google models:
   Optional. Configuration for the model's thinking process. Only supported by specific [Google models](https://ai.google.dev/gemini-api/docs/thinking).
   - **thinkingLevel** _'minimal' | 'low' | 'medium' | 'high'_
 
-    Optional. Controls the thinking depth for Gemini 3 models. Gemini 3.1 Pro supports 'low', 'medium', and 'high', Gemini 3 Pro supports 'low' and 'high', while Gemini 3 Flash supports all four levels: 'minimal', 'low', 'medium', and 'high'. Only supported by Gemini 3 models.
+    Optional. Controls the thinking depth for Gemini 3 and later models. Gemini 3.1 Pro supports 'low', 'medium', and 'high', Gemini 3 Pro supports 'low' and 'high', while Gemini 3 Flash supports all four levels: 'minimal', 'low', 'medium', and 'high'.
 
   - **thinkingBudget** _number_
 
@@ -171,7 +181,7 @@ The following optional provider options are available for Google models:
     For more information about the possible value ranges for each model see [Google thinking documentation](https://ai.google.dev/gemini-api/docs/thinking#set-budget).
 
     <Note>
-      This option is for Gemini 2.5 models. Gemini 3 models should use
+      This option is for Gemini 2.5 models. Gemini 3 and later models should use
       `thinkingLevel` instead.
     </Note>
 
@@ -242,11 +252,11 @@ The following optional provider options are available for Google models:
 
 ### Thinking
 
-The Gemini 2.5 and Gemini 3 series models use an internal "thinking process" that significantly improves their reasoning and multi-step planning abilities, making them highly effective for complex tasks such as coding, advanced mathematics, and data analysis. For more information see [Google thinking documentation](https://ai.google.dev/gemini-api/docs/thinking).
+The Gemini 2.5 and Gemini 3-and-later series models use an internal "thinking process" that significantly improves their reasoning and multi-step planning abilities, making them highly effective for complex tasks such as coding, advanced mathematics, and data analysis. For more information see [Google thinking documentation](https://ai.google.dev/gemini-api/docs/thinking).
 
-#### Gemini 3 Models
+#### Gemini 3 and Later Models
 
-For Gemini 3 models, use the `thinkingLevel` parameter to control the depth of reasoning:
+For Gemini 3 and later models, use the `thinkingLevel` parameter to control the depth of reasoning:
 
 ```ts
 import { google, GoogleLanguageModelOptions } from '@ai-sdk/google';
@@ -628,7 +638,7 @@ Enterprise Web Search provides the following benefits:
 
 ### File Search
 
-The [File Search tool](https://ai.google.dev/gemini-api/docs/file-search) lets Gemini retrieve context from your own documents that you have indexed in File Search stores. Only Gemini 2.5 and Gemini 3 models support this feature.
+The [File Search tool](https://ai.google.dev/gemini-api/docs/file-search) lets Gemini retrieve context from your own documents that you have indexed in File Search stores. The provider enables this tool for Gemini 2.5 and Gemini 3-and-later model IDs, including unrecognized future Gemini IDs.
 
 ```ts highlight="9-13"
 import { google } from '@ai-sdk/google';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "4.0.22",
+  "version": "4.0.24",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,

package/src/convert-to-google-messages.ts

@@ -76,6 +76,7 @@ function appendToolResultParts(
     { type: 'content' }
   >['value'],
   toolCallId?: string,
+  includeFunctionCallIds = true,
 ): void {
   const functionResponseParts: GoogleFunctionResponsePart[] = [];
   const responseTextParts: string[] = [];
@@ -118,7 +119,9 @@ function appendToolResultParts(
 
   parts.push({
     functionResponse: {
-      ...(toolCallId != null ? { id: toolCallId } : {}),
+      ...(includeFunctionCallIds && toolCallId != null
+        ? { id: toolCallId }
+        : {}),
       name: toolName,
       response: {
         name: toolName,
@@ -147,13 +150,16 @@ function appendLegacyToolResultParts(
     { type: 'content' }
   >['value'],
   toolCallId?: string,
+  includeFunctionCallIds = true,
 ): void {
   for (const contentPart of outputValue) {
     switch (contentPart.type) {
       case 'text':
         parts.push({
           functionResponse: {
-            ...(toolCallId != null ? { id: toolCallId } : {}),
+            ...(includeFunctionCallIds && toolCallId != null
+              ? { id: toolCallId }
+              : {}),
             name: toolName,
             response: {
               name: toolName,
@@ -206,6 +212,7 @@ export function convertToGoogleMessages(
      */
     providerOptionsNames?: readonly string[];
     supportsFunctionResponseParts?: boolean;
+    includeFunctionCallIds?: boolean;
   },
 ): GooglePrompt {
   const systemInstructionParts: Array<{ text: string }> = [];
@@ -218,6 +225,7 @@ export function convertToGoogleMessages(
   const isVertexLike = !providerOptionsNames.includes('google');
   const supportsFunctionResponseParts =
     options?.supportsFunctionResponseParts ?? true;
+  const includeFunctionCallIds = options?.includeFunctionCallIds ?? true;
 
   let sentinelInjected = false;
   const missingSignatureToolNames: string[] = [];
@@ -497,7 +505,7 @@ export function convertToGoogleMessages(
 
                   return {
                     functionCall: {
-                      ...(part.toolCallId != null
+                      ...(includeFunctionCallIds && part.toolCallId != null
                         ? { id: part.toolCallId }
                         : {}),
                       name: part.toolName,
@@ -591,6 +599,7 @@ export function convertToGoogleMessages(
                 part.toolName,
                 output.value,
                 part.toolCallId,
+                includeFunctionCallIds,
               );
             } else {
               appendLegacyToolResultParts(
@@ -598,12 +607,15 @@ export function convertToGoogleMessages(
                 part.toolName,
                 output.value,
                 part.toolCallId,
+                includeFunctionCallIds,
               );
             }
           } else {
             parts.push({
               functionResponse: {
-                ...(part.toolCallId != null ? { id: part.toolCallId } : {}),
+                ...(includeFunctionCallIds && part.toolCallId != null
+                  ? { id: part.toolCallId }
+                  : {}),
                 name: part.toolName,
                 response: {
                   name: part.toolName,

package/src/google-language-model.ts

@@ -46,6 +46,7 @@ import {
   type GoogleLanguageModelOptions,
   type GoogleModelId,
 } from './google-language-model-options';
+import { getGoogleModelCapabilities } from './google-model-capabilities';
 import type { GoogleProviderMetadata } from './google-prompt';
 import { prepareTools } from './google-prepare-tools';
 import {
@@ -257,15 +258,15 @@ export class GoogleLanguageModel implements LanguageModelV4 {
     }
 
     const isGemmaModel = this.modelId.toLowerCase().startsWith('gemma-');
-    const isGemini3Model = /^gemini-3[.-]/.test(this.modelId);
-    const supportsFunctionResponseParts = isGemini3Model;
+    const { usesGemini3Features } = getGoogleModelCapabilities(this.modelId);
 
     const { contents, systemInstruction } = convertToGoogleMessages(prompt, {
       isGemmaModel,
-      isGemini3Model,
+      isGemini3Model: usesGemini3Features,
       onWarning: warning => warnings.push(warning),
       providerOptionsNames,
-      supportsFunctionResponseParts,
+      supportsFunctionResponseParts: usesGemini3Features,
+      includeFunctionCallIds: !isVertexProvider,
     });
 
     const {
@@ -1136,10 +1137,6 @@ export class GoogleLanguageModel implements LanguageModelV4 {
   }
 }
 
-function isGemini3Model(modelId: string): boolean {
-  return /gemini-3[\.\-]/i.test(modelId) || /gemini-3$/i.test(modelId);
-}
-
 function getMaxOutputTokensForGemini25Model(): number {
   return 65536;
 }
@@ -1169,7 +1166,10 @@ function resolveThinkingConfig({
     return undefined;
   }
 
-  if (isGemini3Model(modelId) && !modelId.includes('gemini-3-pro-image')) {
+  if (
+    getGoogleModelCapabilities(modelId).usesGemini3Features &&
+    !modelId.includes('gemini-3-pro-image')
+  ) {
     return resolveGemini3ThinkingConfig({ reasoning, warnings });
   }
 

package/src/google-model-capabilities.ts

@@ -0,0 +1,44 @@
+type GoogleModelCapabilities = {
+  supportsGemini2Tools: boolean;
+  supportsFileSearch: boolean;
+  usesGemini3Features: boolean;
+};
+
+const gemini1ModelPattern = /(^|\/)gemini-1(?:[.-]|$)/i;
+const gemini2ModelPattern = /(^|\/)gemini-2(?:[.-]|$)/i;
+const gemini25ModelPattern = /(^|\/)gemini-2\.5(?:[.-]|$)/i;
+const geminiModelPattern = /(^|\/)gemini-/i;
+
+function isKnownPreGemini2Model(modelId: string): boolean {
+  return (
+    gemini1ModelPattern.test(modelId) ||
+    /(^|\/)gemini-pro(?:-vision)?$/i.test(modelId) ||
+    /(^|\/)gemini-robotics-er-1\.5(?:[.-]|$)/i.test(modelId)
+  );
+}
+
+/**
+ * Classifies Gemini capabilities by excluding known older generations.
+ *
+ * Google model IDs are open-ended, so unrecognized Gemini IDs and aliases
+ * intentionally inherit the newest supported behavior. Add exceptions here
+ * only when a model is known to require a legacy request shape.
+ */
+export function getGoogleModelCapabilities(
+  modelId: string,
+): GoogleModelCapabilities {
+  const isGeminiModel = geminiModelPattern.test(modelId);
+  const isGemini2Model = gemini2ModelPattern.test(modelId);
+  const isKnownPreGemini2 = isKnownPreGemini2Model(modelId);
+  const isKnownOlderModel = isKnownPreGemini2 || isGemini2Model;
+  const usesGemini3Features = isGeminiModel && !isKnownOlderModel;
+
+  return {
+    supportsGemini2Tools:
+      (isGeminiModel && !isKnownPreGemini2) ||
+      modelId.toLowerCase().includes('nano-banana'),
+    supportsFileSearch:
+      gemini25ModelPattern.test(modelId) || usesGemini3Features,
+    usesGemini3Features,
+  };
+}

package/src/google-prepare-tools.ts

@@ -5,6 +5,7 @@ import {
 } from '@ai-sdk/provider';
 import { convertJSONSchemaToOpenAPISchema } from './convert-json-schema-to-openapi-schema';
 import type { GoogleModelId } from './google-language-model-options';
+import { getGoogleModelCapabilities } from './google-model-capabilities';
 
 export function prepareTools({
   tools,
@@ -46,21 +47,8 @@ export function prepareTools({
 
   const toolWarnings: SharedV4Warning[] = [];
 
-  const isLatest = (
-    [
-      'gemini-flash-latest',
-      'gemini-flash-lite-latest',
-      'gemini-pro-latest',
-    ] as const satisfies GoogleModelId[]
-  ).some(id => id === modelId);
-  const isGemini2orNewer =
-    modelId.includes('gemini-2') ||
-    modelId.includes('gemini-3') ||
-    modelId.includes('nano-banana') ||
-    isLatest;
-  const isGemini3orNewer = modelId.includes('gemini-3');
-  const supportsFileSearch =
-    modelId.includes('gemini-2.5') || modelId.includes('gemini-3');
+  const { supportsGemini2Tools, supportsFileSearch, usesGemini3Features } =
+    getGoogleModelCapabilities(modelId);
 
   if (tools == null) {
     return { tools: undefined, toolConfig: undefined, toolWarnings };
@@ -70,7 +58,7 @@ export function prepareTools({
   const hasFunctionTools = tools.some(tool => tool.type === 'function');
   const hasProviderTools = tools.some(tool => tool.type === 'provider');
 
-  if (hasFunctionTools && hasProviderTools && !isGemini3orNewer) {
+  if (hasFunctionTools && hasProviderTools && !usesGemini3Features) {
     toolWarnings.push({
       type: 'unsupported',
       feature: `combination of function and provider-defined tools`,
@@ -84,7 +72,7 @@ export function prepareTools({
     ProviderTools.forEach(tool => {
       switch (tool.id) {
         case 'google.google_search':
-          if (isGemini2orNewer) {
+          if (supportsGemini2Tools) {
             googleTools.push({ googleSearch: { ...tool.args } });
           } else {
             toolWarnings.push({
@@ -95,7 +83,7 @@ export function prepareTools({
           }
           break;
         case 'google.enterprise_web_search':
-          if (isGemini2orNewer) {
+          if (supportsGemini2Tools) {
             googleTools.push({ enterpriseWebSearch: {} });
           } else {
             toolWarnings.push({
@@ -106,7 +94,7 @@ export function prepareTools({
           }
           break;
         case 'google.url_context':
-          if (isGemini2orNewer) {
+          if (supportsGemini2Tools) {
             googleTools.push({ urlContext: {} });
           } else {
             toolWarnings.push({
@@ -118,7 +106,7 @@ export function prepareTools({
           }
           break;
         case 'google.code_execution':
-          if (isGemini2orNewer) {
+          if (supportsGemini2Tools) {
             googleTools.push({ codeExecution: {} });
           } else {
             toolWarnings.push({
@@ -142,7 +130,7 @@ export function prepareTools({
           }
           break;
         case 'google.vertex_rag_store':
-          if (isGemini2orNewer) {
+          if (supportsGemini2Tools) {
             googleTools.push({
               retrieval: {
                 vertex_rag_store: {
@@ -163,7 +151,7 @@ export function prepareTools({
           }
           break;
         case 'google.google_maps':
-          if (isGemini2orNewer) {
+          if (supportsGemini2Tools) {
             googleTools.push({ googleMaps: {} });
           } else {
             toolWarnings.push({
@@ -183,7 +171,7 @@ export function prepareTools({
       }
     });
 
-    if (hasFunctionTools && isGemini3orNewer && googleTools.length > 0) {
+    if (hasFunctionTools && usesGemini3Features && googleTools.length > 0) {
       const functionDeclarations: Array<{
         name: string;
         description: string;