@ai-sdk/google 4.0.0-beta.48 → 4.0.0-beta.49

package/docs/15-google.mdx

@@ -625,10 +625,10 @@ the model has access to a compliance-focused web index designed for highly-regul
 </Note>
 
 ```ts
-import { createVertex } from '@ai-sdk/google-vertex';
+import { createGoogleVertex } from '@ai-sdk/google-vertex';
 import { generateText } from 'ai';
 
-const vertex = createVertex({
+const vertex = createGoogleVertex({
   project: 'my-project',
   location: 'us-central1',
 });
@@ -848,11 +848,11 @@ This enables the model to provide answers based on your specific data sources an
 </Note>
 
 ```ts highlight="8,17-20"
-import { createVertex } from '@ai-sdk/google-vertex';
+import { createGoogleVertex } from '@ai-sdk/google-vertex';
 import { GoogleProviderMetadata } from '@ai-sdk/google';
 import { generateText } from 'ai';
 
-const vertex = createVertex({
+const vertex = createGoogleVertex({
   project: 'my-project',
   location: 'us-central1',
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "4.0.0-beta.48",
+  "version": "4.0.0-beta.49",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "4.0.0-beta.14",
-    "@ai-sdk/provider-utils": "5.0.0-beta.29"
+    "@ai-sdk/provider-utils": "5.0.0-beta.30"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/convert-to-google-messages.ts

@@ -171,7 +171,13 @@ export function convertToGoogleMessages(
   prompt: LanguageModelV4Prompt,
   options?: {
     isGemmaModel?: boolean;
-    providerOptionsName?: string;
+    /**
+     * Names to look up under `providerOptions` when reading per-part metadata
+     * (e.g. thought signatures). Tried in order; first match wins. For the
+     * Vertex provider this is `['googleVertex', 'vertex']` (new key first,
+     * legacy key as fallback) and for the Google provider it is `['google']`.
+     */
+    providerOptionsNames?: readonly string[];
     supportsFunctionResponseParts?: boolean;
   },
 ): GooglePrompt {
@@ -179,10 +185,30 @@ export function convertToGoogleMessages(
   const contents: Array<GoogleContent> = [];
   let systemMessagesAllowed = true;
   const isGemmaModel = options?.isGemmaModel ?? false;
-  const providerOptionsName = options?.providerOptionsName ?? 'google';
+  const providerOptionsNames = options?.providerOptionsNames ?? ['google'];
+  const isVertexLike = !providerOptionsNames.includes('google');
   const supportsFunctionResponseParts =
     options?.supportsFunctionResponseParts ?? true;
 
+  const readProviderOpts = (part: {
+    providerOptions?: Record<string, unknown> | undefined;
+  }): Record<string, unknown> | undefined => {
+    for (const name of providerOptionsNames) {
+      const v = part.providerOptions?.[name];
+      if (v != null) return v as Record<string, unknown>;
+    }
+    // Cross-namespace fallback (gateway interop): Vertex providers may receive
+    // metadata under `google`, and the Google provider may receive metadata
+    // under `googleVertex`/`vertex`.
+    if (isVertexLike) {
+      return part.providerOptions?.google as
+        | Record<string, unknown>
+        | undefined;
+    }
+    return (part.providerOptions?.googleVertex ??
+      part.providerOptions?.vertex) as Record<string, unknown> | undefined;
+  };
+
   for (const { role, content } of prompt) {
     switch (role) {
       case 'system': {
@@ -221,7 +247,7 @@ export function convertToGoogleMessages(
                   break;
                 }
                 case 'reference': {
-                  if (providerOptionsName === 'vertex') {
+                  if (isVertexLike) {
                     throw new UnsupportedFunctionalityError({
                       functionality: 'file parts with provider references',
                     });
@@ -278,11 +304,7 @@ export function convertToGoogleMessages(
           role: 'model',
           parts: content
             .map(part => {
-              const providerOpts =
-                part.providerOptions?.[providerOptionsName] ??
-                (providerOptionsName !== 'google'
-                  ? part.providerOptions?.google
-                  : part.providerOptions?.vertex);
+              const providerOpts = readProviderOpts(part);
               const thoughtSignature =
                 providerOpts?.thoughtSignature != null
                   ? String(providerOpts.thoughtSignature)
@@ -339,7 +361,7 @@ export function convertToGoogleMessages(
                       });
                     }
                     case 'reference': {
-                      if (providerOptionsName === 'vertex') {
+                      if (isVertexLike) {
                         throw new UnsupportedFunctionalityError({
                           functionality: 'file parts with provider references',
                         });
@@ -466,11 +488,7 @@ export function convertToGoogleMessages(
             continue;
           }
 
-          const partProviderOpts =
-            part.providerOptions?.[providerOptionsName] ??
-            (providerOptionsName !== 'google'
-              ? part.providerOptions?.google
-              : part.providerOptions?.vertex);
+          const partProviderOpts = readProviderOpts(part);
           const serverToolCallId =
             partProviderOpts?.serverToolCallId != null
               ? String(partProviderOpts.serverToolCallId)

package/src/google-embedding-model.ts

@@ -20,7 +20,7 @@ import { googleFailedResponseHandler } from './google-error';
 import {
   googleEmbeddingModelOptions,
   type GoogleEmbeddingModelId,
-} from './google-embedding-options';
+} from './google-embedding-model-options';
 type GoogleEmbeddingConfig = {
   provider: string;
   baseURL: string;

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

@@ -0,0 +1,23 @@
+import {
+  lazySchema,
+  zodSchema,
+  type InferSchema,
+} from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+// Note: For the initial GA launch of Imagen 3, safety filters are not configurable.
+// https://ai.google.dev/gemini-api/docs/imagen#imagen-model
+export const googleImageModelOptionsSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      personGeneration: z
+        .enum(['dont_allow', 'allow_adult', 'allow_all'])
+        .nullish(),
+      aspectRatio: z.enum(['1:1', '3:4', '4:3', '9:16', '16:9']).nullish(),
+    }),
+  ),
+);
+
+export type GoogleImageModelOptions = InferSchema<
+  typeof googleImageModelOptionsSchema
+>;

package/src/google-image-model.ts

@@ -16,18 +16,18 @@ import {
   WORKFLOW_SERIALIZE,
   WORKFLOW_DESERIALIZE,
   zodSchema,
-  type InferSchema,
   type FetchFunction,
   type Resolvable,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { googleFailedResponseHandler } from './google-error';
+import { googleImageModelOptionsSchema } from './google-image-model-options';
 import type {
   GoogleImageModelId,
   GoogleImageSettings,
 } from './google-image-settings';
 import { GoogleLanguageModel } from './google-language-model';
-import type { GoogleLanguageModelOptions } from './google-options';
+import type { GoogleLanguageModelOptions } from './google-language-model-options';
 
 interface GoogleImageModelConfig {
   provider: string;
@@ -369,20 +369,3 @@ const googleImageResponseSchema = lazySchema(() =>
     }),
   ),
 );
-
-// Note: For the initial GA launch of Imagen 3, safety filters are not configurable.
-// https://ai.google.dev/gemini-api/docs/imagen#imagen-model
-const googleImageModelOptionsSchema = lazySchema(() =>
-  zodSchema(
-    z.object({
-      personGeneration: z
-        .enum(['dont_allow', 'allow_adult', 'allow_all'])
-        .nullish(),
-      aspectRatio: z.enum(['1:1', '3:4', '4:3', '9:16', '16:9']).nullish(),
-    }),
-  ),
-);
-
-export type GoogleImageModelOptions = InferSchema<
-  typeof googleImageModelOptionsSchema
->;

package/src/google-language-model.ts

@@ -44,8 +44,9 @@ import { googleFailedResponseHandler } from './google-error';
 import {
   googleLanguageModelOptions,
   VertexServiceTierMap,
+  type GoogleLanguageModelOptions,
   type GoogleModelId,
-} from './google-options';
+} from './google-language-model-options';
 import type { GoogleProviderMetadata } from './google-prompt';
 import { prepareTools } from './google-prepare-tools';
 import {
@@ -124,16 +125,28 @@ export class GoogleLanguageModel implements LanguageModelV4 {
   ) {
     const warnings: SharedV4Warning[] = [];
 
-    const providerOptionsName = this.config.provider.includes('vertex')
-      ? 'vertex'
-      : 'google';
-    let googleOptions = await parseProviderOptions({
-      provider: providerOptionsName,
-      providerOptions,
-      schema: googleLanguageModelOptions,
-    });
+    // Names to look up in providerOptions and to write into providerMetadata.
+    // For the Vertex provider we read both the new `googleVertex` key and the
+    // legacy `vertex` key (new takes precedence) and write under both for
+    // backward compatibility. For other Google providers we use just `google`.
+    const providerOptionsNames: readonly string[] =
+      this.config.provider.includes('vertex')
+        ? (['googleVertex', 'vertex'] as const)
+        : (['google'] as const);
+
+    let googleOptions: GoogleLanguageModelOptions | undefined;
+    for (const name of providerOptionsNames) {
+      googleOptions = await parseProviderOptions({
+        provider: name,
+        providerOptions,
+        schema: googleLanguageModelOptions,
+      });
+      if (googleOptions != null) break;
+    }
 
-    if (googleOptions == null && providerOptionsName !== 'google') {
+    // Cross-namespace fallback: a Vertex provider may receive options under
+    // the `google` key (e.g. via the AI Gateway).
+    if (googleOptions == null && !providerOptionsNames.includes('google')) {
       googleOptions = await parseProviderOptions({
         provider: 'google',
         providerOptions,
@@ -181,7 +194,7 @@ export class GoogleLanguageModel implements LanguageModelV4 {
 
     const { contents, systemInstruction } = convertToGoogleMessages(prompt, {
       isGemmaModel,
-      providerOptionsName,
+      providerOptionsNames,
       supportsFunctionResponseParts,
     });
 
@@ -278,14 +291,19 @@ export class GoogleLanguageModel implements LanguageModelV4 {
         serviceTier: sanitizedServiceTier,
       },
       warnings: [...warnings, ...toolWarnings],
-      providerOptionsName,
+      providerOptionsNames,
     };
   }
 
   async doGenerate(
     options: LanguageModelV4CallOptions,
   ): Promise<LanguageModelV4GenerateResult> {
-    const { args, warnings, providerOptionsName } = await this.getArgs(options);
+    const { args, warnings, providerOptionsNames } =
+      await this.getArgs(options);
+    const wrapProviderMetadata = (payload: Record<string, unknown>) =>
+      Object.fromEntries(
+        providerOptionsNames.map(name => [name, payload]),
+      ) as SharedV4ProviderMetadata;
 
     const mergedHeaders = combineHeaders(
       this.config.headers ? await resolve(this.config.headers) : undefined,
@@ -349,11 +367,9 @@ export class GoogleLanguageModel implements LanguageModelV4 {
         lastCodeExecutionToolCallId = undefined;
       } else if ('text' in part && part.text != null) {
         const thoughtSignatureMetadata = part.thoughtSignature
-          ? {
-              [providerOptionsName]: {
-                thoughtSignature: part.thoughtSignature,
-              },
-            }
+          ? wrapProviderMetadata({
+              thoughtSignature: part.thoughtSignature,
+            })
           : undefined;
 
         if (part.text.length === 0) {
@@ -379,11 +395,9 @@ export class GoogleLanguageModel implements LanguageModelV4 {
           toolName: part.functionCall.name,
           input: JSON.stringify(part.functionCall.args),
           providerMetadata: part.thoughtSignature
-            ? {
-                [providerOptionsName]: {
-                  thoughtSignature: part.thoughtSignature,
-                },
-              }
+            ? wrapProviderMetadata({
+                thoughtSignature: part.thoughtSignature,
+              })
             : undefined,
         });
       } else if ('inlineData' in part) {
@@ -394,11 +408,9 @@ export class GoogleLanguageModel implements LanguageModelV4 {
           data: { type: 'data', data: part.inlineData.data },
           mediaType: part.inlineData.mimeType,
           providerMetadata: hasThoughtSignature
-            ? {
-                [providerOptionsName]: {
-                  thoughtSignature: part.thoughtSignature,
-                },
-              }
+            ? wrapProviderMetadata({
+                thoughtSignature: part.thoughtSignature,
+              })
             : undefined,
         });
       } else if ('toolCall' in part && part.toolCall) {
@@ -412,19 +424,15 @@ export class GoogleLanguageModel implements LanguageModelV4 {
           providerExecuted: true,
           dynamic: true,
           providerMetadata: part.thoughtSignature
-            ? {
-                [providerOptionsName]: {
-                  thoughtSignature: part.thoughtSignature,
-                  serverToolCallId: toolCallId,
-                  serverToolType: part.toolCall.toolType,
-                },
-              }
-            : {
-                [providerOptionsName]: {
-                  serverToolCallId: toolCallId,
-                  serverToolType: part.toolCall.toolType,
-                },
-              },
+            ? wrapProviderMetadata({
+                thoughtSignature: part.thoughtSignature,
+                serverToolCallId: toolCallId,
+                serverToolType: part.toolCall.toolType,
+              })
+            : wrapProviderMetadata({
+                serverToolCallId: toolCallId,
+                serverToolType: part.toolCall.toolType,
+              }),
         });
       } else if ('toolResponse' in part && part.toolResponse) {
         const responseToolCallId =
@@ -437,19 +445,15 @@ export class GoogleLanguageModel implements LanguageModelV4 {
           toolName: `server:${part.toolResponse.toolType}`,
           result: (part.toolResponse.response ?? {}) as JSONObject,
           providerMetadata: part.thoughtSignature
-            ? {
-                [providerOptionsName]: {
-                  thoughtSignature: part.thoughtSignature,
-                  serverToolCallId: responseToolCallId,
-                  serverToolType: part.toolResponse.toolType,
-                },
-              }
-            : {
-                [providerOptionsName]: {
-                  serverToolCallId: responseToolCallId,
-                  serverToolType: part.toolResponse.toolType,
-                },
-              },
+            ? wrapProviderMetadata({
+                thoughtSignature: part.thoughtSignature,
+                serverToolCallId: responseToolCallId,
+                serverToolType: part.toolResponse.toolType,
+              })
+            : wrapProviderMetadata({
+                serverToolCallId: responseToolCallId,
+                serverToolType: part.toolResponse.toolType,
+              }),
         });
         lastServerToolCallId = undefined;
       }
@@ -478,17 +482,15 @@ export class GoogleLanguageModel implements LanguageModelV4 {
       },
       usage: convertGoogleUsage(usageMetadata),
       warnings,
-      providerMetadata: {
-        [providerOptionsName]: {
-          promptFeedback: response.promptFeedback ?? null,
-          groundingMetadata: candidate.groundingMetadata ?? null,
-          urlContextMetadata: candidate.urlContextMetadata ?? null,
-          safetyRatings: candidate.safetyRatings ?? null,
-          usageMetadata: usageMetadata ?? null,
-          finishMessage: candidate.finishMessage ?? null,
-          serviceTier: response.serviceTier ?? null,
-        } satisfies GoogleProviderMetadata,
-      },
+      providerMetadata: wrapProviderMetadata({
+        promptFeedback: response.promptFeedback ?? null,
+        groundingMetadata: candidate.groundingMetadata ?? null,
+        urlContextMetadata: candidate.urlContextMetadata ?? null,
+        safetyRatings: candidate.safetyRatings ?? null,
+        usageMetadata: usageMetadata ?? null,
+        finishMessage: candidate.finishMessage ?? null,
+        serviceTier: response.serviceTier ?? null,
+      } satisfies GoogleProviderMetadata),
       request: { body: args },
       response: {
         // TODO timestamp, model id, id
@@ -501,10 +503,14 @@ export class GoogleLanguageModel implements LanguageModelV4 {
   async doStream(
     options: LanguageModelV4CallOptions,
   ): Promise<LanguageModelV4StreamResult> {
-    const { args, warnings, providerOptionsName } = await this.getArgs(
+    const { args, warnings, providerOptionsNames } = await this.getArgs(
       options,
       { isStreaming: true },
     );
+    const wrapProviderMetadata = (payload: Record<string, unknown>) =>
+      Object.fromEntries(
+        providerOptionsNames.map(name => [name, payload]),
+      ) as SharedV4ProviderMetadata;
 
     const headers = combineHeaders(
       this.config.headers ? await resolve(this.config.headers) : undefined,
@@ -657,11 +663,9 @@ export class GoogleLanguageModel implements LanguageModelV4 {
                   }
                 } else if ('text' in part && part.text != null) {
                   const thoughtSignatureMetadata = part.thoughtSignature
-                    ? {
-                        [providerOptionsName]: {
-                          thoughtSignature: part.thoughtSignature,
-                        },
-                      }
+                    ? wrapProviderMetadata({
+                        thoughtSignature: part.thoughtSignature,
+                      })
                     : undefined;
 
                   if (part.text.length === 0) {
@@ -748,11 +752,9 @@ export class GoogleLanguageModel implements LanguageModelV4 {
                   const hasThought = part.thought === true;
                   const hasThoughtSignature = !!part.thoughtSignature;
                   const fileMeta = hasThoughtSignature
-                    ? {
-                        [providerOptionsName]: {
-                          thoughtSignature: part.thoughtSignature,
-                        },
-                      }
+                    ? wrapProviderMetadata({
+                        thoughtSignature: part.thoughtSignature,
+                      })
                     : undefined;
                   controller.enqueue({
                     type: hasThought ? 'reasoning-file' : 'file',
@@ -763,15 +765,13 @@ export class GoogleLanguageModel implements LanguageModelV4 {
                 } else if ('toolCall' in part && part.toolCall) {
                   const toolCallId = part.toolCall.id ?? generateId();
                   lastServerToolCallId = toolCallId;
-                  const serverMeta = {
-                    [providerOptionsName]: {
-                      ...(part.thoughtSignature
-                        ? { thoughtSignature: part.thoughtSignature }
-                        : {}),
-                      serverToolCallId: toolCallId,
-                      serverToolType: part.toolCall.toolType,
-                    },
-                  };
+                  const serverMeta = wrapProviderMetadata({
+                    ...(part.thoughtSignature
+                      ? { thoughtSignature: part.thoughtSignature }
+                      : {}),
+                    serverToolCallId: toolCallId,
+                    serverToolType: part.toolCall.toolType,
+                  });
 
                   controller.enqueue({
                     type: 'tool-call',
@@ -787,15 +787,13 @@ export class GoogleLanguageModel implements LanguageModelV4 {
                     lastServerToolCallId ??
                     part.toolResponse.id ??
                     generateId();
-                  const serverMeta = {
-                    [providerOptionsName]: {
-                      ...(part.thoughtSignature
-                        ? { thoughtSignature: part.thoughtSignature }
-                        : {}),
-                      serverToolCallId: responseToolCallId,
-                      serverToolType: part.toolResponse.toolType,
-                    },
-                  };
+                  const serverMeta = wrapProviderMetadata({
+                    ...(part.thoughtSignature
+                      ? { thoughtSignature: part.thoughtSignature }
+                      : {}),
+                    serverToolCallId: responseToolCallId,
+                    serverToolType: part.toolResponse.toolType,
+                  });
 
                   controller.enqueue({
                     type: 'tool-result',
@@ -813,11 +811,9 @@ export class GoogleLanguageModel implements LanguageModelV4 {
                 if (!('functionCall' in part)) continue;
 
                 const providerMeta = part.thoughtSignature
-                  ? {
-                      [providerOptionsName]: {
-                        thoughtSignature: part.thoughtSignature,
-                      },
-                    }
+                  ? wrapProviderMetadata({
+                      thoughtSignature: part.thoughtSignature,
+                    })
                   : undefined;
 
                 const isStreamingChunk =
@@ -970,17 +966,15 @@ export class GoogleLanguageModel implements LanguageModelV4 {
                 raw: candidate.finishReason,
               };
 
-              providerMetadata = {
-                [providerOptionsName]: {
-                  promptFeedback: value.promptFeedback ?? null,
-                  groundingMetadata: lastGroundingMetadata,
-                  urlContextMetadata: lastUrlContextMetadata,
-                  safetyRatings: candidate.safetyRatings ?? null,
-                  usageMetadata: usageMetadata ?? null,
-                  finishMessage: candidate.finishMessage ?? null,
-                  serviceTier,
-                } satisfies GoogleProviderMetadata,
-              };
+              providerMetadata = wrapProviderMetadata({
+                promptFeedback: value.promptFeedback ?? null,
+                groundingMetadata: lastGroundingMetadata,
+                urlContextMetadata: lastUrlContextMetadata,
+                safetyRatings: candidate.safetyRatings ?? null,
+                usageMetadata: usageMetadata ?? null,
+                finishMessage: candidate.finishMessage ?? null,
+                serviceTier,
+              } satisfies GoogleProviderMetadata);
             }
           },
 

package/src/google-prepare-tools.ts

@@ -4,7 +4,7 @@ import {
   type SharedV4Warning,
 } from '@ai-sdk/provider';
 import { convertJSONSchemaToOpenAPISchema } from './convert-json-schema-to-openapi-schema';
-import type { GoogleModelId } from './google-options';
+import type { GoogleModelId } from './google-language-model-options';
 
 export function prepareTools({
   tools,

package/src/google-provider.ts

@@ -15,9 +15,9 @@ import {
 } from '@ai-sdk/provider-utils';
 import { VERSION } from './version';
 import { GoogleEmbeddingModel } from './google-embedding-model';
-import type { GoogleEmbeddingModelId } from './google-embedding-options';
+import type { GoogleEmbeddingModelId } from './google-embedding-model-options';
 import { GoogleLanguageModel } from './google-language-model';
-import type { GoogleModelId } from './google-options';
+import type { GoogleModelId } from './google-language-model-options';
 import { googleTools } from './google-tools';
 
 import type {

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

@@ -0,0 +1,43 @@
+import { lazySchema, zodSchema } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+export type GoogleVideoModelOptions = {
+  // Polling configuration
+  pollIntervalMs?: number | null;
+  pollTimeoutMs?: number | null;
+
+  // Video generation options
+  personGeneration?: 'dont_allow' | 'allow_adult' | 'allow_all' | null;
+  negativePrompt?: string | null;
+
+  // Reference images (for style/asset reference)
+  referenceImages?: Array<{
+    bytesBase64Encoded?: string;
+    gcsUri?: string;
+  }> | null;
+
+  [key: string]: unknown; // For passthrough
+};
+
+export const googleVideoModelOptionsSchema = lazySchema(() =>
+  zodSchema(
+    z
+      .object({
+        pollIntervalMs: z.number().positive().nullish(),
+        pollTimeoutMs: z.number().positive().nullish(),
+        personGeneration: z
+          .enum(['dont_allow', 'allow_adult', 'allow_all'])
+          .nullish(),
+        negativePrompt: z.string().nullish(),
+        referenceImages: z
+          .array(
+            z.object({
+              bytesBase64Encoded: z.string().nullish(),
+              gcsUri: z.string().nullish(),
+            }),
+          )
+          .nullish(),
+      })
+      .passthrough(),
+  ),
+);