@ai-sdk/google 4.0.0-beta.47 → 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.47",
+  "version": "4.0.0-beta.49",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,15 +35,15 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.0-beta.13",
-    "@ai-sdk/provider-utils": "5.0.0-beta.28"
+    "@ai-sdk/provider": "4.0.0-beta.14",
+    "@ai-sdk/provider-utils": "5.0.0-beta.30"
   },
   "devDependencies": {
     "@types/node": "20.17.24",
     "tsup": "^8",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@ai-sdk/test-server": "2.0.0-beta.2",
+    "@ai-sdk/test-server": "2.0.0-beta.3",
     "@vercel/ai-tsconfig": "0.0.0"
   },
   "peerDependencies": {

package/src/convert-google-usage.ts

@@ -1,4 +1,4 @@
-import { LanguageModelV4Usage } from '@ai-sdk/provider';
+import type { LanguageModelV4Usage } from '@ai-sdk/provider';
 
 export type GoogleTokenDetail = {
   modality: string;

package/src/convert-json-schema-to-openapi-schema.ts

@@ -1,4 +1,4 @@
-import { JSONSchema7Definition } from '@ai-sdk/provider';
+import type { JSONSchema7Definition } from '@ai-sdk/provider';
 
 /**
  * Converts JSON Schema 7 to OpenAPI Schema 3.0

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

@@ -1,13 +1,14 @@
 import {
-  LanguageModelV4Prompt,
   UnsupportedFunctionalityError,
+  type LanguageModelV4Prompt,
 } from '@ai-sdk/provider';
 import {
   convertToBase64,
-  isProviderReference,
+  isFullMediaType,
+  resolveFullMediaType,
   resolveProviderReference,
 } from '@ai-sdk/provider-utils';
-import {
+import type {
   GoogleContent,
   GoogleContentPart,
   GoogleFunctionResponsePart,
@@ -170,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 {
@@ -178,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': {
@@ -209,39 +236,56 @@ export function convertToGoogleMessages(
             }
 
             case 'file': {
-              const mediaType =
-                part.mediaType === 'image/*' ? 'image/jpeg' : part.mediaType;
-
-              if (part.data instanceof URL) {
-                parts.push({
-                  fileData: {
-                    mimeType: mediaType,
-                    fileUri: part.data.toString(),
-                  },
-                });
-              } else if (isProviderReference(part.data)) {
-                if (providerOptionsName === 'vertex') {
-                  throw new UnsupportedFunctionalityError({
-                    functionality: 'file parts with provider references',
+              switch (part.data.type) {
+                case 'url': {
+                  parts.push({
+                    fileData: {
+                      mimeType: resolveFullMediaType({ part }),
+                      fileUri: part.data.url.toString(),
+                    },
                   });
+                  break;
                 }
+                case 'reference': {
+                  if (isVertexLike) {
+                    throw new UnsupportedFunctionalityError({
+                      functionality: 'file parts with provider references',
+                    });
+                  }
 
-                parts.push({
-                  fileData: {
-                    mimeType: mediaType,
-                    fileUri: resolveProviderReference({
-                      reference: part.data,
-                      provider: 'google',
-                    }),
-                  },
-                });
-              } else {
-                parts.push({
-                  inlineData: {
-                    mimeType: mediaType,
-                    data: convertToBase64(part.data),
-                  },
-                });
+                  parts.push({
+                    fileData: {
+                      mimeType: resolveFullMediaType({ part }),
+                      fileUri: resolveProviderReference({
+                        reference: part.data.reference,
+                        provider: 'google',
+                      }),
+                    },
+                  });
+                  break;
+                }
+                case 'text': {
+                  parts.push({
+                    inlineData: {
+                      mimeType: isFullMediaType(part.mediaType)
+                        ? part.mediaType
+                        : 'text/plain',
+                      data: convertToBase64(
+                        new TextEncoder().encode(part.data.text),
+                      ),
+                    },
+                  });
+                  break;
+                }
+                case 'data': {
+                  parts.push({
+                    inlineData: {
+                      mimeType: resolveFullMediaType({ part }),
+                      data: convertToBase64(part.data.data),
+                    },
+                  });
+                  break;
+                }
               }
 
               break;
@@ -260,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)
@@ -291,63 +331,86 @@ export function convertToGoogleMessages(
                 }
 
                 case 'reasoning-file': {
-                  if (part.data instanceof URL) {
-                    throw new UnsupportedFunctionalityError({
-                      functionality:
-                        'File data URLs in assistant messages are not supported',
-                    });
+                  switch (part.data.type) {
+                    case 'url': {
+                      throw new UnsupportedFunctionalityError({
+                        functionality:
+                          'File data URLs in assistant messages are not supported',
+                      });
+                    }
+                    case 'data': {
+                      return {
+                        inlineData: {
+                          mimeType: part.mediaType,
+                          data: convertToBase64(part.data.data),
+                        },
+                        thought: true,
+                        thoughtSignature,
+                      };
+                    }
                   }
-
-                  return {
-                    inlineData: {
-                      mimeType: part.mediaType,
-                      data: convertToBase64(part.data),
-                    },
-                    thought: true,
-                    thoughtSignature,
-                  };
+                  break;
                 }
 
                 case 'file': {
-                  if (part.data instanceof URL) {
-                    throw new UnsupportedFunctionalityError({
-                      functionality:
-                        'File data URLs in assistant messages are not supported',
-                    });
-                  }
-
-                  if (isProviderReference(part.data)) {
-                    if (providerOptionsName === 'vertex') {
+                  switch (part.data.type) {
+                    case 'url': {
                       throw new UnsupportedFunctionalityError({
-                        functionality: 'file parts with provider references',
+                        functionality:
+                          'File data URLs in assistant messages are not supported',
                       });
                     }
-
-                    return {
-                      fileData: {
-                        mimeType: part.mediaType,
-                        fileUri: resolveProviderReference({
-                          reference: part.data,
-                          provider: 'google',
-                        }),
-                      },
-                      ...(providerOpts?.thought === true
-                        ? { thought: true }
-                        : {}),
-                      thoughtSignature,
-                    };
+                    case 'reference': {
+                      if (isVertexLike) {
+                        throw new UnsupportedFunctionalityError({
+                          functionality: 'file parts with provider references',
+                        });
+                      }
+
+                      return {
+                        fileData: {
+                          mimeType: part.mediaType,
+                          fileUri: resolveProviderReference({
+                            reference: part.data.reference,
+                            provider: 'google',
+                          }),
+                        },
+                        ...(providerOpts?.thought === true
+                          ? { thought: true }
+                          : {}),
+                        thoughtSignature,
+                      };
+                    }
+                    case 'text': {
+                      return {
+                        inlineData: {
+                          mimeType: isFullMediaType(part.mediaType)
+                            ? part.mediaType
+                            : 'text/plain',
+                          data: convertToBase64(
+                            new TextEncoder().encode(part.data.text),
+                          ),
+                        },
+                        ...(providerOpts?.thought === true
+                          ? { thought: true }
+                          : {}),
+                        thoughtSignature,
+                      };
+                    }
+                    case 'data': {
+                      return {
+                        inlineData: {
+                          mimeType: part.mediaType,
+                          data: convertToBase64(part.data.data),
+                        },
+                        ...(providerOpts?.thought === true
+                          ? { thought: true }
+                          : {}),
+                        thoughtSignature,
+                      };
+                    }
                   }
-
-                  return {
-                    inlineData: {
-                      mimeType: part.mediaType,
-                      data: convertToBase64(part.data),
-                    },
-                    ...(providerOpts?.thought === true
-                      ? { thought: true }
-                      : {}),
-                    thoughtSignature,
-                  };
+                  break;
                 }
 
                 case 'tool-call': {
@@ -425,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

@@ -1,11 +1,10 @@
 import {
-  EmbeddingModelV4,
   TooManyEmbeddingValuesForCallError,
+  type EmbeddingModelV4,
 } from '@ai-sdk/provider';
 import {
   combineHeaders,
   createJsonResponseHandler,
-  FetchFunction,
   lazySchema,
   parseProviderOptions,
   postJsonToApi,
@@ -14,14 +13,14 @@ import {
   WORKFLOW_SERIALIZE,
   WORKFLOW_DESERIALIZE,
   zodSchema,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { googleFailedResponseHandler } from './google-error';
 import {
-  GoogleEmbeddingModelId,
   googleEmbeddingModelOptions,
-} from './google-embedding-options';
-
+  type GoogleEmbeddingModelId,
+} from './google-embedding-model-options';
 type GoogleEmbeddingConfig = {
   provider: string;
   baseURL: string;

package/src/google-error.ts

@@ -1,8 +1,8 @@
 import {
   createJsonErrorResponseHandler,
-  type InferSchema,
   lazySchema,
   zodSchema,
+  type InferSchema,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 

package/src/google-files.ts

@@ -7,13 +7,14 @@ import {
 } from '@ai-sdk/provider';
 import {
   combineHeaders,
+  convertInlineFileDataToUint8Array,
   createJsonResponseHandler,
   delay,
-  type FetchFunction,
   lazySchema,
   parseProviderOptions,
   zodSchema,
   getFromApi,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { googleFailedResponseHandler } from './google-error';
@@ -59,11 +60,7 @@ export class GoogleFiles implements FilesV4 {
       warnings.push({ type: 'unsupported', feature: 'filename' });
     }
 
-    const data = options.data;
-    const fileBytes =
-      data instanceof Uint8Array
-        ? data
-        : Uint8Array.from(atob(data), c => c.charCodeAt(0));
+    const fileBytes = convertInlineFileDataToUint8Array(options.data);
 
     const mediaType = options.mediaType;
     const displayName = googleOptions?.displayName;

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

@@ -1,4 +1,4 @@
-import {
+import type {
   ImageModelV4,
   LanguageModelV4Prompt,
   SharedV4Warning,
@@ -7,27 +7,27 @@ import {
   combineHeaders,
   convertToBase64,
   createJsonResponseHandler,
-  FetchFunction,
   generateId as defaultGenerateId,
-  type InferSchema,
   lazySchema,
   parseProviderOptions,
   postJsonToApi,
-  Resolvable,
   resolve,
   serializeModelOptions,
   WORKFLOW_SERIALIZE,
   WORKFLOW_DESERIALIZE,
   zodSchema,
+  type FetchFunction,
+  type Resolvable,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { googleFailedResponseHandler } from './google-error';
-import {
+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;
@@ -240,33 +240,39 @@ export class GoogleImageModel implements ImageModelV4 {
       });
     }
 
-    // Build user message content for language model
     const userContent: Array<
       | { type: 'text'; text: string }
-      | { type: 'file'; data: string | Uint8Array | URL; mediaType: string }
+      | {
+          type: 'file';
+          data:
+            | { type: 'data'; data: string | Uint8Array }
+            | { type: 'url'; url: URL };
+          mediaType: string;
+        }
     > = [];
 
-    // Add text prompt
     if (prompt != null) {
       userContent.push({ type: 'text', text: prompt });
     }
 
-    // Add input images for editing
     if (files != null && files.length > 0) {
       for (const file of files) {
         if (file.type === 'url') {
           userContent.push({
             type: 'file',
-            data: new URL(file.url),
+            data: { type: 'url', url: new URL(file.url) },
             mediaType: 'image/*',
           });
         } else {
           userContent.push({
             type: 'file',
-            data:
-              typeof file.data === 'string'
-                ? file.data
-                : new Uint8Array(file.data),
+            data: {
+              type: 'data',
+              data:
+                typeof file.data === 'string'
+                  ? file.data
+                  : new Uint8Array(file.data),
+            },
             mediaType: file.mediaType,
           });
         }
@@ -312,11 +318,14 @@ export class GoogleImageModel implements ImageModelV4 {
 
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
 
-    // Extract images from language model response
     const images: string[] = [];
     for (const part of result.content) {
-      if (part.type === 'file' && part.mediaType.startsWith('image/')) {
-        images.push(convertToBase64(part.data));
+      if (
+        part.type === 'file' &&
+        part.mediaType.startsWith('image/') &&
+        part.data.type === 'data'
+      ) {
+        images.push(convertToBase64(part.data.data));
       }
     }
 
@@ -360,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-options.ts → google-language-model-options.ts}

@@ -1,4 +1,8 @@
-import { InferSchema, lazySchema, zodSchema } from '@ai-sdk/provider-utils';
+import {
+  lazySchema,
+  zodSchema,
+  type InferSchema,
+} from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 export type GoogleModelId =