@ai-sdk/google 3.0.78 → 3.0.80

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @ai-sdk/google
 
+## 3.0.80
+
+### Patch Changes
+
+- f62ffe0: fix(google): auto-inject `skip_thought_signature_validator` for Gemini 3 tool-call replays without a signature
+
+  Gemini 3 models reject requests when an assistant `functionCall` part lacks a `thoughtSignature` with HTTP 400 `"Function call is missing a thought_signature in functionCall parts."` This is easy to hit when application code persists/serializes messages and drops `providerOptions.google.thoughtSignature` (custom DB schemas, `useChat` server routes that rebuild messages, synthetic tool-call injection).
+
+  The provider now detects this case (Gemini 3 model + missing signature under `google`, `googleVertex`, and `vertex` namespaces) and injects the documented `skip_thought_signature_validator` sentinel into the outbound `functionCall`, plus surfaces a one-shot warning per request listing the affected tool names so the developer can find and fix the upstream serialization. Non-Gemini-3 models are unaffected, and real signatures take precedence when present.
+
+## 3.0.79
+
+### Patch Changes
+
+- cfa0cb2: feat(provider/google): support Google search grounding when using `generateImage` with Gemini
+
 ## 3.0.78
 
 ### Patch Changes

package/dist/index.d.mts

@@ -225,6 +225,17 @@ interface GoogleGenerativeAIImageSettings {
 declare const googleImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
     personGeneration?: "dont_allow" | "allow_adult" | "allow_all" | null | undefined;
     aspectRatio?: "1:1" | "3:4" | "4:3" | "9:16" | "16:9" | null | undefined;
+    googleSearch?: {
+        [x: string]: unknown;
+        searchTypes?: {
+            webSearch?: Record<string, never> | undefined;
+            imageSearch?: Record<string, never> | undefined;
+        } | undefined;
+        timeRangeFilter?: {
+            startTime: string;
+            endTime: string;
+        } | undefined;
+    } | undefined;
 }>;
 type GoogleImageModelOptions = InferSchema<typeof googleImageModelOptionsSchema>;
 

package/dist/index.d.ts

@@ -225,6 +225,17 @@ interface GoogleGenerativeAIImageSettings {
 declare const googleImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
     personGeneration?: "dont_allow" | "allow_adult" | "allow_all" | null | undefined;
     aspectRatio?: "1:1" | "3:4" | "4:3" | "9:16" | "16:9" | null | undefined;
+    googleSearch?: {
+        [x: string]: unknown;
+        searchTypes?: {
+            webSearch?: Record<string, never> | undefined;
+            imageSearch?: Record<string, never> | undefined;
+        } | undefined;
+        timeRangeFilter?: {
+            startTime: string;
+            endTime: string;
+        } | undefined;
+    } | undefined;
 }>;
 type GoogleImageModelOptions = InferSchema<typeof googleImageModelOptionsSchema>;
 

package/dist/index.js

@@ -30,7 +30,7 @@ module.exports = __toCommonJS(index_exports);
 var import_provider_utils23 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "3.0.78" : "0.0.0-test";
+var VERSION = true ? "3.0.80" : "0.0.0-test";
 
 // src/google-generative-ai-embedding-model.ts
 var import_provider = require("@ai-sdk/provider");
@@ -406,6 +406,23 @@ function isEmptyObjectSchema(jsonSchema) {
 // src/convert-to-google-generative-ai-messages.ts
 var import_provider2 = require("@ai-sdk/provider");
 var import_provider_utils4 = require("@ai-sdk/provider-utils");
+var SKIP_THOUGHT_SIGNATURE_VALIDATOR = "skip_thought_signature_validator";
+function getGoogleProviderOptions(providerOptions, providerOptionsName) {
+  const namespaces = [
+    providerOptionsName,
+    "google",
+    "googleVertex",
+    "vertex"
+  ].filter((namespace, index, allNamespaces) => {
+    return allNamespaces.indexOf(namespace) === index;
+  });
+  for (const namespace of namespaces) {
+    const options = providerOptions == null ? void 0 : providerOptions[namespace];
+    if (options != null) {
+      return options;
+    }
+  }
+}
 var dataUrlRegex = /^data:([^;,]+);base64,(.+)$/s;
 function parseBase64DataUrl(value) {
   const match = dataUrlRegex.exec(value);
@@ -513,13 +530,22 @@ function appendLegacyToolResultParts(parts, toolName, outputValue, toolCallId) {
   }
 }
 function convertToGoogleGenerativeAIMessages(prompt, options) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e;
   const systemInstructionParts = [];
   const contents = [];
   let systemMessagesAllowed = true;
   const isGemmaModel = (_a = options == null ? void 0 : options.isGemmaModel) != null ? _a : false;
-  const providerOptionsName = (_b = options == null ? void 0 : options.providerOptionsName) != null ? _b : "google";
-  const supportsFunctionResponseParts = (_c = options == null ? void 0 : options.supportsFunctionResponseParts) != null ? _c : true;
+  const isGemini3Model = (_b = options == null ? void 0 : options.isGemini3Model) != null ? _b : false;
+  const providerOptionsName = (_c = options == null ? void 0 : options.providerOptionsName) != null ? _c : "google";
+  const supportsFunctionResponseParts = (_d = options == null ? void 0 : options.supportsFunctionResponseParts) != null ? _d : true;
+  const onWarning = options == null ? void 0 : options.onWarning;
+  let sentinelInjected = false;
+  const missingSignatureToolNames = [];
+  const injectSkipSignature = (toolName) => {
+    missingSignatureToolNames.push(toolName);
+    sentinelInjected = true;
+    return SKIP_THOUGHT_SIGNATURE_VALIDATOR;
+  };
   for (const { role, content } of prompt) {
     switch (role) {
       case "system": {
@@ -567,8 +593,10 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
         contents.push({
           role: "model",
           parts: content.map((part) => {
-            var _a2, _b2, _c2, _d2;
-            const providerOpts = (_d2 = (_a2 = part.providerOptions) == null ? void 0 : _a2[providerOptionsName]) != null ? _d2 : providerOptionsName !== "google" ? (_b2 = part.providerOptions) == null ? void 0 : _b2.google : (_c2 = part.providerOptions) == null ? void 0 : _c2.vertex;
+            const providerOpts = getGoogleProviderOptions(
+              part.providerOptions,
+              providerOptionsName
+            );
             const thoughtSignature = (providerOpts == null ? void 0 : providerOpts.thoughtSignature) != null ? String(providerOpts.thoughtSignature) : void 0;
             switch (part.type) {
               case "text": {
@@ -602,6 +630,7 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
               case "tool-call": {
                 const serverToolCallId = (providerOpts == null ? void 0 : providerOpts.serverToolCallId) != null ? String(providerOpts.serverToolCallId) : void 0;
                 const serverToolType = (providerOpts == null ? void 0 : providerOpts.serverToolType) != null ? String(providerOpts.serverToolType) : void 0;
+                const effectiveThoughtSignature = thoughtSignature != null ? thoughtSignature : isGemini3Model ? injectSkipSignature(part.toolName) : void 0;
                 if (serverToolCallId && serverToolType) {
                   return {
                     toolCall: {
@@ -609,7 +638,7 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
                       args: typeof part.input === "string" ? JSON.parse(part.input) : part.input,
                       id: serverToolCallId
                     },
-                    thoughtSignature
+                    thoughtSignature: effectiveThoughtSignature
                   };
                 }
                 return {
@@ -618,7 +647,7 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
                     name: part.toolName,
                     args: part.input
                   },
-                  thoughtSignature
+                  thoughtSignature: effectiveThoughtSignature
                 };
               }
               case "tool-result": {
@@ -648,7 +677,10 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
           if (part.type === "tool-approval-response") {
             continue;
           }
-          const partProviderOpts = (_g = (_d = part.providerOptions) == null ? void 0 : _d[providerOptionsName]) != null ? _g : providerOptionsName !== "google" ? (_e = part.providerOptions) == null ? void 0 : _e.google : (_f = part.providerOptions) == null ? void 0 : _f.vertex;
+          const partProviderOpts = getGoogleProviderOptions(
+            part.providerOptions,
+            providerOptionsName
+          );
           const serverToolCallId = (partProviderOpts == null ? void 0 : partProviderOpts.serverToolCallId) != null ? String(partProviderOpts.serverToolCallId) : void 0;
           const serverToolType = (partProviderOpts == null ? void 0 : partProviderOpts.serverToolType) != null ? String(partProviderOpts.serverToolType) : void 0;
           if (serverToolCallId && serverToolType) {
@@ -692,7 +724,7 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
                 name: part.toolName,
                 response: {
                   name: part.toolName,
-                  content: output.type === "execution-denied" ? (_h = output.reason) != null ? _h : "Tool execution denied." : output.value
+                  content: output.type === "execution-denied" ? (_e = output.reason) != null ? _e : "Tool execution denied." : output.value
                 }
               }
             });
@@ -710,6 +742,13 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
     const systemText = systemInstructionParts.map((part) => part.text).join("\n\n");
     contents[0].parts.unshift({ text: systemText + "\n\n" });
   }
+  if (sentinelInjected && onWarning != null) {
+    const uniqueToolNames = Array.from(new Set(missingSignatureToolNames));
+    onWarning({
+      type: "other",
+      message: `Replayed ${missingSignatureToolNames.length} \`functionCall\` part(s) for a Gemini 3 model without a \`thoughtSignature\` (tools: ${uniqueToolNames.map((name) => `\`${name}\``).join(", ")}). Injected the documented \`skip_thought_signature_validator\` sentinel to keep the request from failing with HTTP 400. The likely cause is application code that drops \`providerOptions.google.thoughtSignature\` when persisting or serializing assistant tool-call messages. See https://ai.google.dev/gemini-api/docs/thought-signatures.`
+    });
+  }
   return {
     systemInstruction: systemInstructionParts.length > 0 && !isGemmaModel ? { parts: systemInstructionParts } : void 0,
     contents
@@ -1463,13 +1502,16 @@ var GoogleGenerativeAILanguageModel = class {
     } : void 0;
     const bodyServiceTier = isVertexProvider ? void 0 : googleOptions == null ? void 0 : googleOptions.serviceTier;
     const isGemmaModel = this.modelId.toLowerCase().startsWith("gemma-");
-    const supportsFunctionResponseParts = this.modelId.startsWith("gemini-3");
+    const isGemini3Model = /^gemini-3[.-]/.test(this.modelId);
+    const supportsFunctionResponseParts = isGemini3Model;
     const { contents, systemInstruction } = convertToGoogleGenerativeAIMessages(
       prompt,
       {
         isGemmaModel,
+        isGemini3Model,
         providerOptionsName,
-        supportsFunctionResponseParts
+        supportsFunctionResponseParts,
+        onWarning: (warning) => warnings.push(warning)
       }
     );
     const {
@@ -2667,7 +2709,15 @@ var GoogleGenerativeAIImageModel = class {
       parameters.aspectRatio = aspectRatio;
     }
     if (googleOptions) {
-      Object.assign(parameters, googleOptions);
+      const { googleSearch: imagenGoogleSearch, ...imagenOptions } = googleOptions;
+      if (imagenGoogleSearch != null) {
+        warnings.push({
+          type: "unsupported",
+          feature: "googleSearch",
+          details: "Google Search grounding is only supported on Gemini image models."
+        });
+      }
+      Object.assign(parameters, imagenOptions);
     }
     const body = {
       instances: [{ prompt }],
@@ -2704,7 +2754,7 @@ var GoogleGenerativeAIImageModel = class {
     };
   }
   async doGenerateGemini(options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
     const {
       prompt,
       n,
@@ -2759,12 +2809,18 @@ var GoogleGenerativeAIImageModel = class {
     const languageModelPrompt = [
       { role: "user", content: userContent }
     ];
+    const googleImageOptions = await (0, import_provider_utils14.parseProviderOptions)({
+      provider: "google",
+      providerOptions,
+      schema: googleImageModelOptionsSchema
+    });
+    const { googleSearch: _strippedGoogleSearch, ...passthroughGoogleOptions } = (_a = providerOptions == null ? void 0 : providerOptions.google) != null ? _a : {};
     const languageModel = new GoogleGenerativeAILanguageModel(this.modelId, {
       provider: this.config.provider,
       baseURL: this.config.baseURL,
-      headers: (_a = this.config.headers) != null ? _a : {},
+      headers: (_b = this.config.headers) != null ? _b : {},
       fetch: this.config.fetch,
-      generateId: (_b = this.config.generateId) != null ? _b : import_provider_utils14.generateId
+      generateId: (_c = this.config.generateId) != null ? _c : import_provider_utils14.generateId
     });
     const result = await languageModel.doGenerate({
       prompt: languageModelPrompt,
@@ -2775,9 +2831,17 @@ var GoogleGenerativeAIImageModel = class {
           imageConfig: aspectRatio ? {
             aspectRatio
           } : void 0,
-          ...(_c = providerOptions == null ? void 0 : providerOptions.google) != null ? _c : {}
+          ...passthroughGoogleOptions
         }
       },
+      tools: (googleImageOptions == null ? void 0 : googleImageOptions.googleSearch) != null ? [
+        {
+          type: "provider",
+          id: "google.google_search",
+          name: "google_search",
+          args: googleImageOptions.googleSearch
+        }
+      ] : void 0,
       headers,
       abortSignal
     });
@@ -2788,23 +2852,25 @@ var GoogleGenerativeAIImageModel = class {
         images.push((0, import_provider_utils14.convertToBase64)(part.data));
       }
     }
+    const languageModelGoogleMetadata = (_h = (_g = result.providerMetadata) == null ? void 0 : _g.google) != null ? _h : {};
     return {
       images,
       warnings,
       providerMetadata: {
         google: {
+          ...languageModelGoogleMetadata,
           images: images.map(() => ({}))
         }
       },
       response: {
         timestamp: currentDate,
         modelId: this.modelId,
-        headers: (_g = result.response) == null ? void 0 : _g.headers
+        headers: (_i = result.response) == null ? void 0 : _i.headers
       },
       usage: result.usage ? {
         inputTokens: result.usage.inputTokens.total,
         outputTokens: result.usage.outputTokens.total,
-        totalTokens: ((_h = result.usage.inputTokens.total) != null ? _h : 0) + ((_i = result.usage.outputTokens.total) != null ? _i : 0)
+        totalTokens: ((_j = result.usage.inputTokens.total) != null ? _j : 0) + ((_k = result.usage.outputTokens.total) != null ? _k : 0)
       } : void 0
     };
   }
@@ -2823,7 +2889,17 @@ var googleImageModelOptionsSchema = (0, import_provider_utils14.lazySchema)(
   () => (0, import_provider_utils14.zodSchema)(
     import_v413.z.object({
       personGeneration: import_v413.z.enum(["dont_allow", "allow_adult", "allow_all"]).nullish(),
-      aspectRatio: import_v413.z.enum(["1:1", "3:4", "4:3", "9:16", "16:9"]).nullish()
+      aspectRatio: import_v413.z.enum(["1:1", "3:4", "4:3", "9:16", "16:9"]).nullish(),
+      /**
+       * Enable Google Search grounding for Gemini image models. The value is
+       * forwarded as the args of the `google.tools.googleSearch` provider
+       * tool on the underlying language-model call. Pass `{}` for defaults.
+       *
+       * `generateImage` does not accept a `tools` parameter, so this is the
+       * dedicated escape hatch for grounding image generation the same way
+       * `generateText` does.
+       */
+      googleSearch: googleSearchToolArgsBaseSchema.optional()
     })
   )
 );