@ai-sdk/google 4.0.87 → 4.0.89

package/docs/15-google.mdx

@@ -34,6 +34,15 @@ const google = createGoogle({
 
 You can use the following optional settings to customize the Google provider instance:
 
+- **batchResultDownloads** _object_
+
+  Settings for downloading file-based JSON Lines batch results.
+  - **maxLineBytes** _number_
+
+    Maximum UTF-8 bytes per row, excluding the LF delimiter. Defaults to 64 MiB
+    (67,108,864 bytes). Must be a positive safe integer. Oversized rows throw a
+    `DownloadError` and cancel the download.
+
 - **baseURL** _string_
 
   Use a different URL prefix for API calls, e.g. to use proxy servers.
@@ -643,7 +652,7 @@ The [File Search tool](https://ai.google.dev/gemini-api/docs/file-search) lets G
 import { google } from '@ai-sdk/google';
 import { generateText } from 'ai';
 
-const { text, sources } = await generateText({
+const { text, sources, providerMetadata } = await generateText({
   model: google('gemini-3.8-flash'),
   tools: {
     file_search: google.tools.fileSearch({
@@ -660,6 +669,9 @@ const { text, sources } = await generateText({
 
 File Search responses include citations via the normal `sources` field and expose raw [grounding metadata](#google-search) in `providerMetadata.google.groundingMetadata`.
 
+Custom metadata attached to the indexed documents is available in
+`groundingMetadata.groundingChunks[].retrievedContext.customMetadata`.
+
 ### URL Context
 
 Google provides a provider-defined URL context tool.
@@ -1046,6 +1058,7 @@ will still validate the response against the schema in `Output.object`.
 
 | Model                                 | Image Input | Object Generation | Tool Usage | Tool Streaming | Google Search | URL Context |
 | ------------------------------------- | ----------- | ----------------- | ---------- | -------------- | ------------- | ----------- |
+| `gemini-nano-banana-2.1`              | <Check />   | <Cross />         | <Cross />  | <Cross />      | <Check />     | <Cross />   |
 | `gemini-3.8-flash`                    | <Check />   | <Check />         | <Check />  | <Check />      | <Check />     | <Check />   |
 | `gemini-3.7-flash`                    | <Check />   | <Check />         | <Check />  | <Check />      | <Check />     | <Check />   |
 | `gemini-3.6-flash`                    | <Check />   | <Check />         | <Check />  | <Check />      | <Check />     | <Check />   |
@@ -2232,11 +2245,12 @@ console.log(result.providerMetadata?.google?.groundingMetadata);
 
 #### Gemini Image Model Capabilities
 
-| Model                            | Image Generation | Image Editing | Aspect Ratios                                       |
-| -------------------------------- | ---------------- | ------------- | --------------------------------------------------- |
-| `gemini-2.5-flash-image`         | <Check />        | <Check />     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
-| `gemini-3-pro-image-preview`     | <Check />        | <Check />     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
-| `gemini-3.1-flash-image-preview` | <Check />        | <Check />     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
+| Model                            | Image Generation | Image Editing | Aspect Ratios                                                           |
+| -------------------------------- | ---------------- | ------------- | ----------------------------------------------------------------------- |
+| `gemini-2.5-flash-image`         | <Check />        | <Check />     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                     |
+| `gemini-3-pro-image-preview`     | <Check />        | <Check />     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                     |
+| `gemini-3.1-flash-image-preview` | <Check />        | <Check />     | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9                     |
+| `gemini-nano-banana-2.1`         | <Check />        | <Check />     | 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 |
 
 <Note>
   `gemini-3-pro-image-preview` supports additional features including up to 14
@@ -2393,18 +2407,18 @@ Older models continue to use labelled transcripts, such as
 | `gemini-3.8-flash-tts`         | <Check />     | <Check />              |
 | `gemini-3.8-flash-lite-tts`    | <Check />     | <Check />              |
 
-## Evaluation Models
+## Decision Models
 
-Create an experimental evaluation model with `google.evaluationModel(modelId)`.
+Create an experimental decision model with `google.decisionModel(modelId)`.
 It uses Gemini structured output for Choice, Score, and Boolean questions. Choose a model
 that supports structured output, such as `gemini-3.5-flash-lite`.
 
 ```ts
 import { google } from '@ai-sdk/google';
-import { experimental_evaluate } from 'ai';
+import { experimental_decide } from 'ai';
 
-const { answers } = await experimental_evaluate({
-  model: google.evaluationModel('gemini-3.5-flash-lite'),
+const { answers } = await experimental_decide({
+  model: google.decisionModel('gemini-3.5-flash-lite'),
   state: 'I was charged twice.',
   questions: {
     requestsRefund: {
@@ -2436,10 +2450,10 @@ and rejects safety-blocked, truncated, or invalid output. It preserves usage
 Choice and Score answers do not include probability distributions. Boolean
 answers contain prompted estimates of P(true), validated to be finite and in
 `[0, 1]`. These estimates are not guaranteed to be calibrated. Apply thresholds
-in application code, for example `answers.requestsRefund.probability >= 0.5`. See [Evaluation](/docs/ai-sdk-core/evaluation).
+in application code, for example `answers.requestsRefund.probability >= 0.5`. See [Decisions](/docs/ai-sdk-core/decisions).
 
-Evaluation models can also be accessed through `customProvider` aliases or
-`createProviderRegistry().evaluationModel('provider:model')`. Direct string IDs
+Decision models can also be accessed through `customProvider` aliases or
+`createProviderRegistry().decisionModel('provider:model')`. Direct string IDs
 use Gateway by default, or an explicitly configured default provider with an
-`evaluationModel` method. See
-[model aliases and registries](/docs/ai-sdk-core/evaluation#model-aliases-and-registries).
+`decisionModel` method. See
+[model aliases and registries](/docs/ai-sdk-core/decisions#model-aliases-and-registries).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "4.0.87",
+  "version": "4.0.89",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,15 +35,15 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.21",
-    "@ai-sdk/provider-utils": "5.0.53"
+    "@ai-sdk/provider": "4.0.23",
+    "@ai-sdk/provider-utils": "5.0.55"
   },
   "devDependencies": {
-    "@ai-sdk/test-server": "2.0.3",
+    "@ai-sdk/test-server": "2.0.4",
     "@types/node": "22.19.19",
     "@vercel/ai-tsconfig": "0.0.0",
     "tsdown": "^0.23.0",
-    "typescript": "5.8.3",
+    "typescript": "6.0.3",
     "zod": "3.25.76"
   },
   "peerDependencies": {

package/src/google-batch.ts

@@ -185,16 +185,19 @@ export class GoogleBatch implements BatchV4<GoogleBatchModelIds> {
   readonly supportedUrls: Record<string, RegExp[]>;
   private readonly batchConfig: GoogleLanguageModelConfig;
   private readonly batchGenerateId: () => string;
+  private readonly maxLineBytes?: number;
 
   constructor(options: {
     provider: string;
     config: GoogleLanguageModelConfig;
     supportedUrls: Record<string, RegExp[]>;
+    maxLineBytes?: number;
   }) {
     this.provider = options.provider;
     this.batchConfig = options.config;
     this.supportedUrls = options.supportedUrls;
     this.batchGenerateId = options.config.generateId ?? generateId;
+    this.maxLineBytes = options.maxLineBytes;
   }
 
   async doStartBatch(
@@ -511,6 +514,7 @@ export class GoogleBatch implements BatchV4<GoogleBatchModelIds> {
       failedResponseHandler: googleFailedResponseHandler,
       successfulResponseHandler: createJsonLinesResponseHandler(
         googleBatchResultLineSchema,
+        { maxLineBytes: this.maxLineBytes },
       ),
       abortSignal: options.abortSignal,
       fetch: this.batchConfig.fetch,

package/src/google-image-model.ts

@@ -36,6 +36,7 @@ const googleImageModelsWithFileInputSupport = new Set<string>([
   'gemini-2.5-flash-image',
   'gemini-3-pro-image-preview',
   'gemini-3.1-flash-image-preview',
+  'gemini-nano-banana-2.1',
 ]);
 
 export class GoogleImageModel implements ImageModelV4 {

package/src/google-image-settings.ts

@@ -3,6 +3,7 @@ export type GoogleImageModelId =
   | 'gemini-2.5-flash-image'
   | 'gemini-3-pro-image-preview'
   | 'gemini-3.1-flash-image-preview'
+  | 'gemini-nano-banana-2.1'
   | (string & {});
 
 export interface GoogleImageSettings {

package/src/google-language-model-options.ts

@@ -35,6 +35,7 @@ export type GoogleModelId =
   | 'gemini-3.6-flash'
   | 'gemini-3.7-flash'
   | 'gemini-3.8-flash'
+  | 'gemini-nano-banana-2.1'
   // latest version
   // https://ai.google.dev/gemini-api/docs/models#latest
   | 'gemini-pro-latest'

package/src/google-language-model.ts

@@ -2,6 +2,7 @@ import type {
   LanguageModelV4,
   LanguageModelV4CallOptions,
   LanguageModelV4Content,
+  LanguageModelV4FunctionTool,
   LanguageModelV4FinishReason,
   LanguageModelV4GenerateResult,
   LanguageModelV4Source,
@@ -13,6 +14,7 @@ import type {
 } from '@ai-sdk/provider';
 import {
   combineHeaders,
+  convertJsonResponseToolStream,
   createToolNameMapping,
   createEventSourceResponseHandler,
   createJsonResponseHandler,
@@ -448,16 +450,57 @@ export class GoogleLanguageModel implements LanguageModelV4 {
     };
   }
 
-  private getArgs(
+  private async getArgs(
     options: LanguageModelV4CallOptions,
     { isStreaming = false }: { isStreaming?: boolean } = {},
   ) {
-    return GoogleLanguageModel.prepareRequest({
+    const { responseFormat, tools, toolChoice } = options;
+    let jsonResponseTool: LanguageModelV4FunctionTool | undefined;
+    // Gemini models before Gemini 3 reject JSON response formatting together
+    // with function tools. Gemini 3 supports the combination only with automatic
+    // tool choice (AUTO). Forced tool choice (ANY) requires a JSON response tool.
+    if (
+      responseFormat?.type === 'json' &&
+      responseFormat.schema != null &&
+      tools?.some(tool => tool.type === 'function') &&
+      /(^|\/)gemini-/i.test(this.modelId) &&
+      (!getGoogleModelCapabilities(this.modelId).usesGemini3Features ||
+        toolChoice?.type === 'required' ||
+        toolChoice?.type === 'tool')
+    ) {
+      let name = 'json';
+      for (let suffix = 1; tools.some(tool => tool.name === name); suffix++) {
+        name = `json_${suffix}`;
+      }
+      jsonResponseTool = {
+        type: 'function',
+        name,
+        description:
+          responseFormat.description ?? 'Respond with a JSON object.',
+        inputSchema: responseFormat.schema,
+      };
+    }
+
+    const prepared = await GoogleLanguageModel.prepareRequest({
       modelId: this.modelId,
       config: this.config,
-      options,
+      options:
+        jsonResponseTool == null
+          ? options
+          : {
+              ...options,
+              responseFormat: undefined,
+              tools: [...(tools ?? []), jsonResponseTool],
+              toolChoice:
+                toolChoice?.type === 'tool'
+                  ? toolChoice
+                  : toolChoice?.type === 'none'
+                    ? { type: 'tool', toolName: jsonResponseTool.name }
+                    : { type: 'required' },
+            },
       isStreaming,
     });
+    return { ...prepared, jsonResponseToolName: jsonResponseTool?.name };
   }
 
   static convertGenerateContentResponse({
@@ -466,12 +509,14 @@ export class GoogleLanguageModel implements LanguageModelV4 {
     warnings,
     providerOptionsNames,
     toolNameMapping,
+    jsonResponseToolName,
   }: {
     config: GoogleLanguageModelConfig;
     response: InferSchema<typeof responseSchema>;
     warnings: SharedV4Warning[];
     providerOptionsNames: readonly string[];
     toolNameMapping?: ReturnType<typeof createToolNameMapping>;
+    jsonResponseToolName?: string;
   }): LanguageModelV4GenerateResult {
     const wrapProviderMetadata = (payload: Record<string, unknown>) =>
       Object.fromEntries(
@@ -529,6 +574,7 @@ export class GoogleLanguageModel implements LanguageModelV4 {
           },
         });
       } else if ('text' in part && part.text != null) {
+        if (jsonResponseToolName != null && part.thought !== true) continue;
         const thoughtSignatureMetadata = part.thoughtSignature
           ? wrapProviderMetadata({
               thoughtSignature: part.thoughtSignature,
@@ -548,6 +594,23 @@ export class GoogleLanguageModel implements LanguageModelV4 {
           });
         }
       } else if ('functionCall' in part && part.functionCall.name != null) {
+        if (part.functionCall.name === jsonResponseToolName) {
+          content.push({
+            type: 'text',
+            text:
+              typeof part.functionCall.args === 'string'
+                ? part.functionCall.args
+                : JSON.stringify(part.functionCall.args ?? {}),
+            ...(part.thoughtSignature
+              ? {
+                  providerMetadata: wrapProviderMetadata({
+                    thoughtSignature: part.thoughtSignature,
+                  }),
+                }
+              : {}),
+          });
+          continue;
+        }
         content.push({
           type: 'tool-call' as const,
           toolCallId: part.functionCall.id || config.generateId(),
@@ -666,6 +729,7 @@ export class GoogleLanguageModel implements LanguageModelV4 {
       providerOptionsNames,
       extraHeaders,
       toolNameMapping,
+      jsonResponseToolName,
     } = await this.getArgs(options);
 
     const mergedHeaders = combineHeaders(
@@ -696,6 +760,7 @@ export class GoogleLanguageModel implements LanguageModelV4 {
       warnings,
       providerOptionsNames,
       toolNameMapping,
+      jsonResponseToolName,
     });
 
     return {
@@ -718,6 +783,7 @@ export class GoogleLanguageModel implements LanguageModelV4 {
       providerOptionsNames,
       extraHeaders,
       toolNameMapping,
+      jsonResponseToolName,
     } = await this.getArgs(options, { isStreaming: true });
     const wrapProviderMetadata = (payload: Record<string, unknown>) =>
       Object.fromEntries(
@@ -813,7 +879,7 @@ export class GoogleLanguageModel implements LanguageModelV4 {
       hasToolCalls = true;
     };
 
-    return {
+    const result = {
       stream: response.pipeThrough(
         new TransformStream<
           ParseResult<ChunkSchema>,
@@ -1301,6 +1367,15 @@ export class GoogleLanguageModel implements LanguageModelV4 {
       response: { headers: responseHeaders },
       request: { body: args },
     };
+    return {
+      ...result,
+      stream:
+        jsonResponseToolName == null
+          ? result.stream
+          : result.stream.pipeThrough(
+              convertJsonResponseToolStream(jsonResponseToolName),
+            ),
+    };
   }
 }
 
@@ -1370,6 +1445,7 @@ function resolveGemini3ThinkingConfig({
       medium: 'medium',
       high: 'high',
       xhigh: 'high',
+      max: 'high',
     },
     warnings,
   });
@@ -1571,6 +1647,18 @@ export const getGroundingMetadataSchema = () =>
               title: z.string().nullish(),
               text: z.string().nullish(),
               fileSearchStore: z.string().nullish(),
+              customMetadata: z
+                .array(
+                  z.object({
+                    key: z.string(),
+                    stringValue: z.string().nullish(),
+                    numericValue: z.number().nullish(),
+                    stringListValue: z
+                      .object({ values: z.array(z.string()).nullish() })
+                      .nullish(),
+                  }),
+                )
+                .nullish(),
             })
             .nullish(),
           maps: z

package/src/google-provider.ts

@@ -1,7 +1,7 @@
 import type {
   EmbeddingModelV4,
   Experimental_BatchV4 as BatchV4,
-  Experimental_EvaluationModelV4 as EvaluationModelV4,
+  Experimental_DecisionModelV4 as DecisionModelV4,
   Experimental_VideoModelV4,
   FilesV4,
   ImageModelV4,
@@ -21,7 +21,7 @@ import {
   type FetchFunction,
   type WebSocketConstructor,
 } from '@ai-sdk/provider-utils';
-import { Experimental_EvaluationLanguageModel as EvaluationLanguageModel } from '@ai-sdk/provider-utils/experimental-evaluation';
+import { Experimental_DecisionLanguageModel as DecisionLanguageModel } from '@ai-sdk/provider-utils/experimental-decision';
 import { VERSION } from './version';
 import { GoogleEmbeddingModel } from './google-embedding-model';
 import type { GoogleEmbeddingModelId } from './google-embedding-model-options';
@@ -63,8 +63,12 @@ export interface GoogleProvider extends ProviderV4 {
 
   chat(modelId: GoogleModelId): LanguageModelV4;
 
-  /** Creates an experimental Choice/Score/Boolean evaluation model using Gemini. */
-  evaluationModel(modelId: GoogleModelId): EvaluationModelV4;
+  /** Creates an experimental Choice/Score/Boolean decision model using Gemini. */
+  decisionModel(modelId: GoogleModelId): DecisionModelV4;
+  /** @deprecated Use `decisionModel` instead. */
+  evaluationModel(modelId: GoogleModelId): DecisionModelV4 & {
+    doEvaluate: DecisionModelV4['doDecide'];
+  };
 
   experimental_batch(): BatchV4<{
     text: GoogleModelId;
@@ -174,6 +178,12 @@ export interface GoogleProvider extends ProviderV4 {
 }
 
 export interface GoogleProviderSettings {
+  /** Settings for downloading JSON Lines batch results. */
+  batchResultDownloads?: {
+    /** Maximum UTF-8 bytes per row, excluding LF. Defaults to 64 MiB. */
+    maxLineBytes?: number;
+  };
+
   /**
    * Use a different URL prefix for API calls, e.g. to use proxy servers.
    * The default prefix is `https://generativelanguage.googleapis.com/v1beta`.
@@ -308,6 +318,7 @@ export function createGoogle(
   const createBatch = () =>
     new GoogleBatch({
       provider: `${providerName.replace(/\.generative-ai$/, '')}.batch`,
+      maxLineBytes: options.batchResultDownloads?.maxLineBytes,
       config: languageModelConfig,
       // Batch prompt conversion happens before the model is available to the
       // provider. Only advertise URL support shared by every batch model.
@@ -435,11 +446,13 @@ export function createGoogle(
   provider.languageModel = createChatModel;
   provider.chat = createChatModel;
   provider.generativeAI = createChatModel;
-  provider.evaluationModel = (modelId: GoogleModelId) =>
-    new EvaluationLanguageModel({
+  provider.decisionModel = (modelId: GoogleModelId) =>
+    new DecisionLanguageModel({
       model: createChatModel(modelId),
-      provider: `${providerName.replace(/\.generative-ai$/, '')}.evaluation`,
+      provider: `${providerName.replace(/\.generative-ai$/, '')}.decision`,
     });
+  provider.evaluationModel =
+    provider.decisionModel as GoogleProvider['evaluationModel'];
   provider.experimental_batch = createBatch;
   provider.embedding = createEmbeddingModel;
   provider.embeddingModel = createEmbeddingModel;

package/src/interactions/google-interactions-language-model-options.ts

@@ -37,6 +37,7 @@ export type GoogleInteractionsModelId =
   | 'gemini-3.6-flash'
   | 'gemini-3.7-flash'
   | 'gemini-3.8-flash'
+  | 'gemini-nano-banana-2.1'
   | 'lyria-3-clip-preview'
   | 'lyria-3-pro-preview'
   | (string & {});