@ai-sdk/google 3.0.0-beta.76 → 3.0.0-beta.77

package/dist/internal/index.d.mts

@@ -45,6 +45,12 @@ declare const getGroundingMetadataSchema: () => z.ZodObject<{
             text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             fileSearchStore: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
+        maps: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            uri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            placeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>>;
     groundingSupports: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         segment: z.ZodObject<{
@@ -123,6 +129,12 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
                     text?: string | null | undefined;
                     fileSearchStore?: string | null | undefined;
                 } | null | undefined;
+                maps?: {
+                    uri?: string | null | undefined;
+                    title?: string | null | undefined;
+                    text?: string | null | undefined;
+                    placeId?: string | null | undefined;
+                } | null | undefined;
             }[] | null | undefined;
             groundingSupports?: {
                 segment: {
@@ -180,6 +192,14 @@ declare const googleTools: {
         mode?: "MODE_DYNAMIC" | "MODE_UNSPECIFIED";
         dynamicThreshold?: number;
     }>;
+    /**
+     * Creates a Google Maps grounding tool that gives the model access to Google Maps data.
+     * Must have name "google_maps".
+     *
+     * @see https://ai.google.dev/gemini-api/docs/maps-grounding
+     * @see https://cloud.google.com/vertex-ai/generative-ai/docs/grounding/grounding-with-google-maps
+     */
+    googleMaps: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}>;
     /**
      * Creates a URL context tool that gives Google direct access to real-time web content.
      * Must have name "url_context".

package/dist/internal/index.d.ts

@@ -45,6 +45,12 @@ declare const getGroundingMetadataSchema: () => z.ZodObject<{
             text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             fileSearchStore: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
+        maps: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            uri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            placeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>>;
     groundingSupports: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         segment: z.ZodObject<{
@@ -123,6 +129,12 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
                     text?: string | null | undefined;
                     fileSearchStore?: string | null | undefined;
                 } | null | undefined;
+                maps?: {
+                    uri?: string | null | undefined;
+                    title?: string | null | undefined;
+                    text?: string | null | undefined;
+                    placeId?: string | null | undefined;
+                } | null | undefined;
             }[] | null | undefined;
             groundingSupports?: {
                 segment: {
@@ -180,6 +192,14 @@ declare const googleTools: {
         mode?: "MODE_DYNAMIC" | "MODE_UNSPECIFIED";
         dynamicThreshold?: number;
     }>;
+    /**
+     * Creates a Google Maps grounding tool that gives the model access to Google Maps data.
+     * Must have name "google_maps".
+     *
+     * @see https://ai.google.dev/gemini-api/docs/maps-grounding
+     * @see https://cloud.google.com/vertex-ai/generative-ai/docs/grounding/grounding-with-google-maps
+     */
+    googleMaps: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}>;
     /**
      * Creates a URL context tool that gives Google direct access to real-time web content.
      * Must have name "url_context".

package/dist/internal/index.js

@@ -458,6 +458,18 @@ var googleGenerativeAIProviderOptions = (0, import_provider_utils3.lazySchema)(
           "21:9"
         ]).optional(),
         imageSize: import_v42.z.enum(["1K", "2K", "4K"]).optional()
+      }).optional(),
+      /**
+       * Optional. Configuration for grounding retrieval.
+       * Used to provide location context for Google Maps and Google Search grounding.
+       *
+       * https://cloud.google.com/vertex-ai/generative-ai/docs/grounding/grounding-with-google-maps
+       */
+      retrievalConfig: import_v42.z.object({
+        latLng: import_v42.z.object({
+          latitude: import_v42.z.number(),
+          longitude: import_v42.z.number()
+        }).optional()
       }).optional()
     })
   )
@@ -566,6 +578,17 @@ function prepareTools({
             });
           }
           break;
+        case "google.google_maps":
+          if (isGemini2orNewer) {
+            googleTools2.push({ googleMaps: {} });
+          } else {
+            toolWarnings.push({
+              type: "unsupported",
+              feature: `provider-defined tool ${tool.id}`,
+              details: "The Google Maps grounding tool is not supported with Gemini models other than Gemini 2 or newer."
+            });
+          }
+          break;
         default:
           toolWarnings.push({
             type: "unsupported",
@@ -775,7 +798,10 @@ var GoogleGenerativeAILanguageModel = class {
         systemInstruction: isGemmaModel ? void 0 : systemInstruction,
         safetySettings: googleOptions == null ? void 0 : googleOptions.safetySettings,
         tools: googleTools2,
-        toolConfig: googleToolConfig,
+        toolConfig: (googleOptions == null ? void 0 : googleOptions.retrievalConfig) ? {
+          ...googleToolConfig,
+          retrievalConfig: googleOptions.retrievalConfig
+        } : googleToolConfig,
         cachedContent: googleOptions == null ? void 0 : googleOptions.cachedContent,
         labels: googleOptions == null ? void 0 : googleOptions.labels
       },
@@ -1166,7 +1192,7 @@ function extractSources({
   groundingMetadata,
   generateId: generateId2
 }) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e;
   if (!(groundingMetadata == null ? void 0 : groundingMetadata.groundingChunks)) {
     return void 0;
   }
@@ -1232,6 +1258,16 @@ function extractSources({
           filename: fileSearchStore.split("/").pop()
         });
       }
+    } else if (chunk.maps != null) {
+      if (chunk.maps.uri) {
+        sources.push({
+          type: "source",
+          sourceType: "url",
+          id: generateId2(),
+          url: chunk.maps.uri,
+          title: (_e = chunk.maps.title) != null ? _e : void 0
+        });
+      }
     }
   }
   return sources.length > 0 ? sources : void 0;
@@ -1248,6 +1284,12 @@ var getGroundingMetadataSchema = () => import_v43.z.object({
         title: import_v43.z.string().nullish(),
         text: import_v43.z.string().nullish(),
         fileSearchStore: import_v43.z.string().nullish()
+      }).nullish(),
+      maps: import_v43.z.object({
+        uri: import_v43.z.string().nullish(),
+        title: import_v43.z.string().nullish(),
+        text: import_v43.z.string().nullish(),
+        placeId: import_v43.z.string().nullish()
       }).nullish()
     })
   ).nullish(),
@@ -1414,37 +1456,45 @@ var fileSearch = (0, import_provider_utils6.createProviderToolFactory)({
   inputSchema: fileSearchArgsSchema
 });
 
-// src/tool/google-search.ts
+// src/tool/google-maps.ts
 var import_provider_utils7 = require("@ai-sdk/provider-utils");
 var import_v46 = require("zod/v4");
-var googleSearch = (0, import_provider_utils7.createProviderToolFactory)({
+var googleMaps = (0, import_provider_utils7.createProviderToolFactory)({
+  id: "google.google_maps",
+  inputSchema: (0, import_provider_utils7.lazySchema)(() => (0, import_provider_utils7.zodSchema)(import_v46.z.object({})))
+});
+
+// src/tool/google-search.ts
+var import_provider_utils8 = require("@ai-sdk/provider-utils");
+var import_v47 = require("zod/v4");
+var googleSearch = (0, import_provider_utils8.createProviderToolFactory)({
   id: "google.google_search",
-  inputSchema: (0, import_provider_utils7.lazySchema)(
-    () => (0, import_provider_utils7.zodSchema)(
-      import_v46.z.object({
-        mode: import_v46.z.enum(["MODE_DYNAMIC", "MODE_UNSPECIFIED"]).default("MODE_UNSPECIFIED"),
-        dynamicThreshold: import_v46.z.number().default(1)
+  inputSchema: (0, import_provider_utils8.lazySchema)(
+    () => (0, import_provider_utils8.zodSchema)(
+      import_v47.z.object({
+        mode: import_v47.z.enum(["MODE_DYNAMIC", "MODE_UNSPECIFIED"]).default("MODE_UNSPECIFIED"),
+        dynamicThreshold: import_v47.z.number().default(1)
       })
     )
   )
 });
 
 // src/tool/url-context.ts
-var import_provider_utils8 = require("@ai-sdk/provider-utils");
-var import_v47 = require("zod/v4");
-var urlContext = (0, import_provider_utils8.createProviderToolFactory)({
+var import_provider_utils9 = require("@ai-sdk/provider-utils");
+var import_v48 = require("zod/v4");
+var urlContext = (0, import_provider_utils9.createProviderToolFactory)({
   id: "google.url_context",
-  inputSchema: (0, import_provider_utils8.lazySchema)(() => (0, import_provider_utils8.zodSchema)(import_v47.z.object({})))
+  inputSchema: (0, import_provider_utils9.lazySchema)(() => (0, import_provider_utils9.zodSchema)(import_v48.z.object({})))
 });
 
 // src/tool/vertex-rag-store.ts
-var import_provider_utils9 = require("@ai-sdk/provider-utils");
-var import_v48 = require("zod/v4");
-var vertexRagStore = (0, import_provider_utils9.createProviderToolFactory)({
+var import_provider_utils10 = require("@ai-sdk/provider-utils");
+var import_v49 = require("zod/v4");
+var vertexRagStore = (0, import_provider_utils10.createProviderToolFactory)({
   id: "google.vertex_rag_store",
-  inputSchema: import_v48.z.object({
-    ragCorpus: import_v48.z.string(),
-    topK: import_v48.z.number().optional()
+  inputSchema: import_v49.z.object({
+    ragCorpus: import_v49.z.string(),
+    topK: import_v49.z.number().optional()
   })
 });
 
@@ -1455,6 +1505,14 @@ var googleTools = {
    * Must have name "google_search".
    */
   googleSearch,
+  /**
+   * Creates a Google Maps grounding tool that gives the model access to Google Maps data.
+   * Must have name "google_maps".
+   *
+   * @see https://ai.google.dev/gemini-api/docs/maps-grounding
+   * @see https://cloud.google.com/vertex-ai/generative-ai/docs/grounding/grounding-with-google-maps
+   */
+  googleMaps,
   /**
    * Creates a URL context tool that gives Google direct access to real-time web content.
    * Must have name "url_context".