@ai-sdk/google 3.0.38 → 3.0.40

package/dist/internal/index.d.mts

@@ -30,6 +30,7 @@ declare class GoogleGenerativeAILanguageModel implements LanguageModelV3 {
 }
 declare const getGroundingMetadataSchema: () => z.ZodObject<{
     webSearchQueries: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    imageSearchQueries: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     retrievalQueries: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     searchEntryPoint: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         renderedContent: z.ZodString;
@@ -39,6 +40,12 @@ declare const getGroundingMetadataSchema: () => z.ZodObject<{
             uri: z.ZodString;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
+        image: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            sourceUri: z.ZodString;
+            imageUri: z.ZodString;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
         retrievedContext: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             uri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -69,10 +76,10 @@ declare const getGroundingMetadataSchema: () => z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>>>;
 }, z.core.$strip>;
 declare const getUrlContextMetadataSchema: () => z.ZodObject<{
-    urlMetadata: z.ZodArray<z.ZodObject<{
+    urlMetadata: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         retrievedUrl: z.ZodString;
         urlRetrievalStatus: z.ZodString;
-    }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
     candidates: {
@@ -114,6 +121,7 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
         }[] | null | undefined;
         groundingMetadata?: {
             webSearchQueries?: string[] | null | undefined;
+            imageSearchQueries?: string[] | null | undefined;
             retrievalQueries?: string[] | null | undefined;
             searchEntryPoint?: {
                 renderedContent: string;
@@ -123,6 +131,12 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
                     uri: string;
                     title?: string | null | undefined;
                 } | null | undefined;
+                image?: {
+                    sourceUri: string;
+                    imageUri: string;
+                    title?: string | null | undefined;
+                    domain?: string | null | undefined;
+                } | null | undefined;
                 retrievedContext?: {
                     uri?: string | null | undefined;
                     title?: string | null | undefined;
@@ -153,10 +167,10 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
             } | null | undefined;
         } | null | undefined;
         urlContextMetadata?: {
-            urlMetadata: {
+            urlMetadata?: {
                 retrievedUrl: string;
                 urlRetrievalStatus: string;
-            }[];
+            }[] | null | undefined;
         } | null | undefined;
     }[];
     usageMetadata?: {
@@ -189,8 +203,15 @@ declare const googleTools: {
      * Must have name "google_search".
      */
     googleSearch: _ai_sdk_provider_utils.ProviderToolFactory<{}, {
-        mode?: "MODE_DYNAMIC" | "MODE_UNSPECIFIED";
-        dynamicThreshold?: number;
+        [x: string]: unknown;
+        searchTypes?: {
+            webSearch?: Record<string, never> | undefined;
+            imageSearch?: Record<string, never> | undefined;
+        } | undefined;
+        timeRangeFilter?: {
+            startTime: string;
+            endTime: string;
+        } | undefined;
     }>;
     /**
      * Creates an Enterprise Web Search tool for grounding responses using a compliance-focused web index.

package/dist/internal/index.d.ts

@@ -30,6 +30,7 @@ declare class GoogleGenerativeAILanguageModel implements LanguageModelV3 {
 }
 declare const getGroundingMetadataSchema: () => z.ZodObject<{
     webSearchQueries: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    imageSearchQueries: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     retrievalQueries: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     searchEntryPoint: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         renderedContent: z.ZodString;
@@ -39,6 +40,12 @@ declare const getGroundingMetadataSchema: () => z.ZodObject<{
             uri: z.ZodString;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
+        image: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            sourceUri: z.ZodString;
+            imageUri: z.ZodString;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
         retrievedContext: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             uri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -69,10 +76,10 @@ declare const getGroundingMetadataSchema: () => z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>>>;
 }, z.core.$strip>;
 declare const getUrlContextMetadataSchema: () => z.ZodObject<{
-    urlMetadata: z.ZodArray<z.ZodObject<{
+    urlMetadata: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         retrievedUrl: z.ZodString;
         urlRetrievalStatus: z.ZodString;
-    }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
     candidates: {
@@ -114,6 +121,7 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
         }[] | null | undefined;
         groundingMetadata?: {
             webSearchQueries?: string[] | null | undefined;
+            imageSearchQueries?: string[] | null | undefined;
             retrievalQueries?: string[] | null | undefined;
             searchEntryPoint?: {
                 renderedContent: string;
@@ -123,6 +131,12 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
                     uri: string;
                     title?: string | null | undefined;
                 } | null | undefined;
+                image?: {
+                    sourceUri: string;
+                    imageUri: string;
+                    title?: string | null | undefined;
+                    domain?: string | null | undefined;
+                } | null | undefined;
                 retrievedContext?: {
                     uri?: string | null | undefined;
                     title?: string | null | undefined;
@@ -153,10 +167,10 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
             } | null | undefined;
         } | null | undefined;
         urlContextMetadata?: {
-            urlMetadata: {
+            urlMetadata?: {
                 retrievedUrl: string;
                 urlRetrievalStatus: string;
-            }[];
+            }[] | null | undefined;
         } | null | undefined;
     }[];
     usageMetadata?: {
@@ -189,8 +203,15 @@ declare const googleTools: {
      * Must have name "google_search".
      */
     googleSearch: _ai_sdk_provider_utils.ProviderToolFactory<{}, {
-        mode?: "MODE_DYNAMIC" | "MODE_UNSPECIFIED";
-        dynamicThreshold?: number;
+        [x: string]: unknown;
+        searchTypes?: {
+            webSearch?: Record<string, never> | undefined;
+            imageSearch?: Record<string, never> | undefined;
+        } | undefined;
+        timeRangeFilter?: {
+            startTime: string;
+            endTime: string;
+        } | undefined;
     }>;
     /**
      * Creates an Enterprise Web Search tool for grounding responses using a compliance-focused web index.

package/dist/internal/index.js

@@ -519,8 +519,7 @@ function prepareTools({
     "gemini-flash-lite-latest",
     "gemini-pro-latest"
   ].some((id) => id === modelId);
-  const isGemini2orNewer = modelId.includes("gemini-2") || modelId.includes("gemini-3") || isLatest;
-  const supportsDynamicRetrieval = modelId.includes("gemini-1.5-flash") && !modelId.includes("-8b");
+  const isGemini2orNewer = modelId.includes("gemini-2") || modelId.includes("gemini-3") || modelId.includes("nano-banana") || isLatest;
   const supportsFileSearch = modelId.includes("gemini-2.5") || modelId.includes("gemini-3");
   if (tools == null) {
     return { tools: void 0, toolConfig: void 0, toolWarnings };
@@ -540,18 +539,13 @@ function prepareTools({
       switch (tool.id) {
         case "google.google_search":
           if (isGemini2orNewer) {
-            googleTools2.push({ googleSearch: {} });
-          } else if (supportsDynamicRetrieval) {
-            googleTools2.push({
-              googleSearchRetrieval: {
-                dynamicRetrievalConfig: {
-                  mode: tool.args.mode,
-                  dynamicThreshold: tool.args.dynamicThreshold
-                }
-              }
-            });
+            googleTools2.push({ googleSearch: { ...tool.args } });
           } else {
-            googleTools2.push({ googleSearchRetrieval: {} });
+            toolWarnings.push({
+              type: "unsupported",
+              feature: `provider-defined tool ${tool.id}`,
+              details: "Google Search requires Gemini 2.0 or newer."
+            });
           }
           break;
         case "google.enterprise_web_search":
@@ -1268,7 +1262,7 @@ function extractSources({
   groundingMetadata,
   generateId: generateId2
 }) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f;
   if (!(groundingMetadata == null ? void 0 : groundingMetadata.groundingChunks)) {
     return void 0;
   }
@@ -1282,6 +1276,16 @@ function extractSources({
         url: chunk.web.uri,
         title: (_a = chunk.web.title) != null ? _a : void 0
       });
+    } else if (chunk.image != null) {
+      sources.push({
+        type: "source",
+        sourceType: "url",
+        id: generateId2(),
+        // Google requires attribution to the source URI, not the actual image URI.
+        // TODO: add another type in v7 to allow both the image and source URL to be included separately
+        url: chunk.image.sourceUri,
+        title: (_b = chunk.image.title) != null ? _b : void 0
+      });
     } else if (chunk.retrievedContext != null) {
       const uri = chunk.retrievedContext.uri;
       const fileSearchStore = chunk.retrievedContext.fileSearchStore;
@@ -1291,10 +1295,10 @@ function extractSources({
           sourceType: "url",
           id: generateId2(),
           url: uri,
-          title: (_b = chunk.retrievedContext.title) != null ? _b : void 0
+          title: (_c = chunk.retrievedContext.title) != null ? _c : void 0
         });
       } else if (uri) {
-        const title = (_c = chunk.retrievedContext.title) != null ? _c : "Unknown Document";
+        const title = (_d = chunk.retrievedContext.title) != null ? _d : "Unknown Document";
         let mediaType = "application/octet-stream";
         let filename = void 0;
         if (uri.endsWith(".pdf")) {
@@ -1324,7 +1328,7 @@ function extractSources({
           filename
         });
       } else if (fileSearchStore) {
-        const title = (_d = chunk.retrievedContext.title) != null ? _d : "Unknown Document";
+        const title = (_e = chunk.retrievedContext.title) != null ? _e : "Unknown Document";
         sources.push({
           type: "source",
           sourceType: "document",
@@ -1341,7 +1345,7 @@ function extractSources({
           sourceType: "url",
           id: generateId2(),
           url: chunk.maps.uri,
-          title: (_e = chunk.maps.title) != null ? _e : void 0
+          title: (_f = chunk.maps.title) != null ? _f : void 0
         });
       }
     }
@@ -1350,11 +1354,18 @@ function extractSources({
 }
 var getGroundingMetadataSchema = () => import_v43.z.object({
   webSearchQueries: import_v43.z.array(import_v43.z.string()).nullish(),
+  imageSearchQueries: import_v43.z.array(import_v43.z.string()).nullish(),
   retrievalQueries: import_v43.z.array(import_v43.z.string()).nullish(),
   searchEntryPoint: import_v43.z.object({ renderedContent: import_v43.z.string() }).nullish(),
   groundingChunks: import_v43.z.array(
     import_v43.z.object({
       web: import_v43.z.object({ uri: import_v43.z.string(), title: import_v43.z.string().nullish() }).nullish(),
+      image: import_v43.z.object({
+        sourceUri: import_v43.z.string(),
+        imageUri: import_v43.z.string(),
+        title: import_v43.z.string().nullish(),
+        domain: import_v43.z.string().nullish()
+      }).nullish(),
       retrievedContext: import_v43.z.object({
         uri: import_v43.z.string().nullish(),
         title: import_v43.z.string().nullish(),
@@ -1447,7 +1458,7 @@ var getUrlContextMetadataSchema = () => import_v43.z.object({
       retrievedUrl: import_v43.z.string(),
       urlRetrievalStatus: import_v43.z.string()
     })
-  )
+  ).nullish()
 });
 var responseSchema = (0, import_provider_utils4.lazySchema)(
   () => (0, import_provider_utils4.zodSchema)(
@@ -1551,17 +1562,25 @@ var googleMaps = (0, import_provider_utils8.createProviderToolFactory)({
 // src/tool/google-search.ts
 var import_provider_utils9 = require("@ai-sdk/provider-utils");
 var import_v48 = require("zod/v4");
-var googleSearch = (0, import_provider_utils9.createProviderToolFactory)({
-  id: "google.google_search",
-  inputSchema: (0, import_provider_utils9.lazySchema)(
-    () => (0, import_provider_utils9.zodSchema)(
-      import_v48.z.object({
-        mode: import_v48.z.enum(["MODE_DYNAMIC", "MODE_UNSPECIFIED"]).default("MODE_UNSPECIFIED"),
-        dynamicThreshold: import_v48.z.number().default(1)
-      })
-    )
-  )
-});
+var googleSearchToolArgsBaseSchema = import_v48.z.object({
+  searchTypes: import_v48.z.object({
+    webSearch: import_v48.z.object({}).optional(),
+    imageSearch: import_v48.z.object({}).optional()
+  }).optional(),
+  timeRangeFilter: import_v48.z.object({
+    startTime: import_v48.z.string(),
+    endTime: import_v48.z.string()
+  }).optional()
+}).passthrough();
+var googleSearchToolArgsSchema = (0, import_provider_utils9.lazySchema)(
+  () => (0, import_provider_utils9.zodSchema)(googleSearchToolArgsBaseSchema)
+);
+var googleSearch = (0, import_provider_utils9.createProviderToolFactory)(
+  {
+    id: "google.google_search",
+    inputSchema: googleSearchToolArgsSchema
+  }
+);
 
 // src/tool/url-context.ts
 var import_provider_utils10 = require("@ai-sdk/provider-utils");