@ai-sdk/google 3.0.99 → 3.0.100

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.100",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

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,16 +230,15 @@ 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),
       },
     );

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;