@ai-sdk/google 3.0.38 → 3.0.40

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-sdk/google
 
+## 3.0.40
+
+### Patch Changes
+
+- 89d8b45: fix(google): make urlMetadata optional in urlContextMetadata schema
+
+## 3.0.39
+
+### Patch Changes
+
+- 2565e70: feat(google): add support for image search, replace obsolete google_search_retrieval implementation
+
 ## 3.0.38
 
 ### Patch Changes

package/dist/index.d.mts

@@ -82,6 +82,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;
@@ -91,6 +92,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;
@@ -121,10 +128,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?: {
@@ -201,8 +208,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/index.d.ts

@@ -82,6 +82,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;
@@ -91,6 +92,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;
@@ -121,10 +128,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?: {
@@ -201,8 +208,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/index.js

@@ -30,7 +30,7 @@ module.exports = __toCommonJS(src_exports);
 var import_provider_utils16 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "3.0.38" : "0.0.0-test";
+var VERSION = true ? "3.0.40" : "0.0.0-test";
 
 // src/google-generative-ai-embedding-model.ts
 var import_provider = require("@ai-sdk/provider");
@@ -676,8 +676,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 };
@@ -697,18 +696,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":
@@ -1425,7 +1419,7 @@ function extractSources({
   groundingMetadata,
   generateId: generateId3
 }) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f;
   if (!(groundingMetadata == null ? void 0 : groundingMetadata.groundingChunks)) {
     return void 0;
   }
@@ -1439,6 +1433,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: generateId3(),
+        // 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;
@@ -1448,10 +1452,10 @@ function extractSources({
           sourceType: "url",
           id: generateId3(),
           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")) {
@@ -1481,7 +1485,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",
@@ -1498,7 +1502,7 @@ function extractSources({
           sourceType: "url",
           id: generateId3(),
           url: chunk.maps.uri,
-          title: (_e = chunk.maps.title) != null ? _e : void 0
+          title: (_f = chunk.maps.title) != null ? _f : void 0
         });
       }
     }
@@ -1507,11 +1511,18 @@ function extractSources({
 }
 var getGroundingMetadataSchema = () => import_v45.z.object({
   webSearchQueries: import_v45.z.array(import_v45.z.string()).nullish(),
+  imageSearchQueries: import_v45.z.array(import_v45.z.string()).nullish(),
   retrievalQueries: import_v45.z.array(import_v45.z.string()).nullish(),
   searchEntryPoint: import_v45.z.object({ renderedContent: import_v45.z.string() }).nullish(),
   groundingChunks: import_v45.z.array(
     import_v45.z.object({
       web: import_v45.z.object({ uri: import_v45.z.string(), title: import_v45.z.string().nullish() }).nullish(),
+      image: import_v45.z.object({
+        sourceUri: import_v45.z.string(),
+        imageUri: import_v45.z.string(),
+        title: import_v45.z.string().nullish(),
+        domain: import_v45.z.string().nullish()
+      }).nullish(),
       retrievedContext: import_v45.z.object({
         uri: import_v45.z.string().nullish(),
         title: import_v45.z.string().nullish(),
@@ -1604,7 +1615,7 @@ var getUrlContextMetadataSchema = () => import_v45.z.object({
       retrievedUrl: import_v45.z.string(),
       urlRetrievalStatus: import_v45.z.string()
     })
-  )
+  ).nullish()
 });
 var responseSchema = (0, import_provider_utils6.lazySchema)(
   () => (0, import_provider_utils6.zodSchema)(
@@ -1708,17 +1719,25 @@ var googleMaps = (0, import_provider_utils10.createProviderToolFactory)({
 // src/tool/google-search.ts
 var import_provider_utils11 = require("@ai-sdk/provider-utils");
 var import_v410 = require("zod/v4");
-var googleSearch = (0, import_provider_utils11.createProviderToolFactory)({
-  id: "google.google_search",
-  inputSchema: (0, import_provider_utils11.lazySchema)(
-    () => (0, import_provider_utils11.zodSchema)(
-      import_v410.z.object({
-        mode: import_v410.z.enum(["MODE_DYNAMIC", "MODE_UNSPECIFIED"]).default("MODE_UNSPECIFIED"),
-        dynamicThreshold: import_v410.z.number().default(1)
-      })
-    )
-  )
-});
+var googleSearchToolArgsBaseSchema = import_v410.z.object({
+  searchTypes: import_v410.z.object({
+    webSearch: import_v410.z.object({}).optional(),
+    imageSearch: import_v410.z.object({}).optional()
+  }).optional(),
+  timeRangeFilter: import_v410.z.object({
+    startTime: import_v410.z.string(),
+    endTime: import_v410.z.string()
+  }).optional()
+}).passthrough();
+var googleSearchToolArgsSchema = (0, import_provider_utils11.lazySchema)(
+  () => (0, import_provider_utils11.zodSchema)(googleSearchToolArgsBaseSchema)
+);
+var googleSearch = (0, import_provider_utils11.createProviderToolFactory)(
+  {
+    id: "google.google_search",
+    inputSchema: googleSearchToolArgsSchema
+  }
+);
 
 // src/tool/url-context.ts
 var import_provider_utils12 = require("@ai-sdk/provider-utils");