@ai-sdk/google 2.0.55 → 2.0.57

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-sdk/google
 
+## 2.0.57
+
+### Patch Changes
+
+- 4dda2a3: feat(google): add support for image search, replace obsolete google_search_retrieval implementation
+
+## 2.0.56
+
+### Patch Changes
+
+- a1c0208: feat(provider/google): add support for new Google image model aspect ratios and sizes
+
 ## 2.0.55
 
 ### Patch Changes

package/dist/index.d.mts

@@ -30,8 +30,8 @@ declare const googleGenerativeAIProviderOptions: _ai_sdk_provider_utils.LazySche
     labels?: Record<string, string> | undefined;
     mediaResolution?: "MEDIA_RESOLUTION_UNSPECIFIED" | "MEDIA_RESOLUTION_LOW" | "MEDIA_RESOLUTION_MEDIUM" | "MEDIA_RESOLUTION_HIGH" | undefined;
     imageConfig?: {
-        aspectRatio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | undefined;
-        imageSize?: "1K" | "2K" | "4K" | undefined;
+        aspectRatio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | "1:8" | "8:1" | "1:4" | "4:1" | undefined;
+        imageSize?: "1K" | "2K" | "4K" | "512" | undefined;
     } | undefined;
     retrievalConfig?: {
         latLng?: {
@@ -81,6 +81,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;
@@ -90,6 +91,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;
@@ -186,8 +193,15 @@ declare const googleTools: {
      * Must have name "google_search".
      */
     googleSearch: _ai_sdk_provider_utils.ProviderDefinedToolFactory<{}, {
-        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

@@ -30,8 +30,8 @@ declare const googleGenerativeAIProviderOptions: _ai_sdk_provider_utils.LazySche
     labels?: Record<string, string> | undefined;
     mediaResolution?: "MEDIA_RESOLUTION_UNSPECIFIED" | "MEDIA_RESOLUTION_LOW" | "MEDIA_RESOLUTION_MEDIUM" | "MEDIA_RESOLUTION_HIGH" | undefined;
     imageConfig?: {
-        aspectRatio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | undefined;
-        imageSize?: "1K" | "2K" | "4K" | undefined;
+        aspectRatio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | "1:8" | "8:1" | "1:4" | "4:1" | undefined;
+        imageSize?: "1K" | "2K" | "4K" | "512" | undefined;
     } | undefined;
     retrievalConfig?: {
         latLng?: {
@@ -81,6 +81,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;
@@ -90,6 +91,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;
@@ -186,8 +193,15 @@ declare const googleTools: {
      * Must have name "google_search".
      */
     googleSearch: _ai_sdk_provider_utils.ProviderDefinedToolFactory<{}, {
-        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_utils15 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "2.0.55" : "0.0.0-test";
+var VERSION = true ? "2.0.57" : "0.0.0-test";
 
 // src/google-generative-ai-embedding-model.ts
 var import_provider = require("@ai-sdk/provider");
@@ -595,9 +595,13 @@ var googleGenerativeAIProviderOptions = (0, import_provider_utils5.lazySchema)(
           "5:4",
           "9:16",
           "16:9",
-          "21:9"
+          "21:9",
+          "1:8",
+          "8:1",
+          "1:4",
+          "4:1"
         ]).optional(),
-        imageSize: import_v44.z.enum(["1K", "2K", "4K"]).optional()
+        imageSize: import_v44.z.enum(["1K", "2K", "4K", "512"]).optional()
       }).optional(),
       /**
        * Optional. Configuration for grounding retrieval.
@@ -630,9 +634,8 @@ 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 supportsFileSearch = modelId.includes("gemini-2.5");
+  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 };
   }
@@ -657,18 +660,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-tool",
+              tool,
+              details: "Google Search requires Gemini 2.0 or newer."
+            });
           }
           break;
         case "google.enterprise_web_search":
@@ -1341,7 +1339,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;
   }
@@ -1355,6 +1353,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;
@@ -1364,10 +1372,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")) {
@@ -1397,7 +1405,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",
@@ -1414,7 +1422,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
         });
       }
     }
@@ -1423,11 +1431,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(),
@@ -1627,17 +1642,23 @@ var googleMaps = (0, import_provider_utils10.createProviderDefinedToolFactory)({
 // src/tool/google-search.ts
 var import_provider_utils11 = require("@ai-sdk/provider-utils");
 var import_v410 = require("zod/v4");
+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.createProviderDefinedToolFactory)({
   id: "google.google_search",
   name: "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)
-      })
-    )
-  )
+  inputSchema: googleSearchToolArgsSchema
 });
 
 // src/tool/url-context.ts