@ai-sdk/google 3.0.99 → 3.0.101

package/docs/15-google-generative-ai.mdx

@@ -105,6 +105,16 @@ Google Generative AI language models can also be used in the `streamText` functi
 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 Generative AI 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:
 
@@ -181,7 +191,7 @@ The following optional provider options are available for Google Generative AI m
 
   - **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_
 
@@ -189,7 +199,7 @@ The following optional provider options are available for Google Generative AI m
     For more information about the possible value ranges for each model see [Google Generative AI 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>
 
@@ -264,11 +274,11 @@ The following optional provider options are available for Google Generative AI m
 
 ### 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 Generative AI 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 Generative AI 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';
@@ -656,7 +666,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": "3.0.99",
+  "version": "3.0.101",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

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

@@ -101,6 +101,7 @@ function appendToolResultParts(
     [key: string]: unknown;
   }>,
   toolCallId?: string,
+  includeFunctionCallIds = true,
 ): void {
   const functionResponseParts: GoogleGenerativeAIFunctionResponsePart[] = [];
   const responseTextParts: string[] = [];
@@ -143,7 +144,9 @@ function appendToolResultParts(
 
   parts.push({
     functionResponse: {
-      ...(toolCallId != null ? { id: toolCallId } : {}),
+      ...(includeFunctionCallIds && toolCallId != null
+        ? { id: toolCallId }
+        : {}),
       name: toolName,
       response: {
         name: toolName,
@@ -172,13 +175,16 @@ function appendLegacyToolResultParts(
     [key: string]: unknown;
   }>,
   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,
@@ -234,6 +240,7 @@ export function convertToGoogleGenerativeAIMessages(
      * injected.
      */
     onWarning?: (warning: SharedV3Warning) => void;
+    includeFunctionCallIds?: boolean;
   },
 ): GoogleGenerativeAIPrompt {
   const systemInstructionParts: Array<{ text: string }> = [];
@@ -245,6 +252,7 @@ export function convertToGoogleGenerativeAIMessages(
   const supportsFunctionResponseParts =
     options?.supportsFunctionResponseParts ?? true;
   const onWarning = options?.onWarning;
+  const includeFunctionCallIds = options?.includeFunctionCallIds ?? true;
 
   let sentinelInjected = false;
   const missingSignatureToolNames: string[] = [];
@@ -413,7 +421,7 @@ export function convertToGoogleGenerativeAIMessages(
 
                   return {
                     functionCall: {
-                      ...(part.toolCallId != null
+                      ...(includeFunctionCallIds && part.toolCallId != null
                         ? { id: part.toolCallId }
                         : {}),
                       name: part.toolName,
@@ -510,6 +518,7 @@ export function convertToGoogleGenerativeAIMessages(
                 part.toolName,
                 output.value,
                 part.toolCallId,
+                includeFunctionCallIds,
               );
             } else {
               appendLegacyToolResultParts(
@@ -517,12 +526,15 @@ export function convertToGoogleGenerativeAIMessages(
                 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-generative-ai-language-model.ts

@@ -39,6 +39,7 @@ import {
   googleLanguageModelOptions,
   type GoogleGenerativeAIModelId,
 } from './google-generative-ai-options';
+import { getGoogleModelCapabilities } from './google-model-capabilities';
 import type {
   GoogleGenerativeAIContentPart,
   GoogleGenerativeAIProviderMetadata,
@@ -229,17 +230,17 @@ export class GoogleGenerativeAILanguageModel implements LanguageModelV3 {
     }
 
     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 } = convertToGoogleGenerativeAIMessages(
       prompt,
       {
         isGemmaModel,
-        isGemini3Model,
+        isGemini3Model: usesGemini3Features,
         providerOptionsName,
-        supportsFunctionResponseParts,
+        supportsFunctionResponseParts: usesGemini3Features,
         onWarning: warning => warnings.push(warning),
+        includeFunctionCallIds: !isVertexProvider,
       },
     );
 

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 { GoogleGenerativeAIModelId } from './google-generative-ai-options';
+import { getGoogleModelCapabilities } from './google-model-capabilities';
 
 export function prepareTools({
   tools,
@@ -46,21 +47,8 @@ export function prepareTools({
 
   const toolWarnings: SharedV3Warning[] = [];
 
-  const isLatest = (
-    [
-      'gemini-flash-latest',
-      'gemini-flash-lite-latest',
-      'gemini-pro-latest',
-    ] as const satisfies GoogleGenerativeAIModelId[]
-  ).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;