@ai-sdk/google 4.0.88 → 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "4.0.88",
+  "version": "4.0.89",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,15 +35,15 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.22",
-    "@ai-sdk/provider-utils": "5.0.54"
+    "@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

@@ -1445,6 +1445,7 @@ function resolveGemini3ThinkingConfig({
       medium: 'medium',
       high: 'high',
       xhigh: 'high',
+      max: 'high',
     },
     warnings,
   });
@@ -1646,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

@@ -178,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`.
@@ -312,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.

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 & {});