@ai-sdk/google 4.0.0-beta.3 → 4.0.0-beta.31

package/CHANGELOG.md

@@ -1,5 +1,210 @@
 # @ai-sdk/google
 
+## 4.0.0-beta.31
+
+### Patch Changes
+
+- Updated dependencies [176466a]
+  - @ai-sdk/provider@4.0.0-beta.10
+  - @ai-sdk/provider-utils@5.0.0-beta.16
+
+## 4.0.0-beta.30
+
+### Patch Changes
+
+- Updated dependencies [e311194]
+  - @ai-sdk/provider@4.0.0-beta.9
+  - @ai-sdk/provider-utils@5.0.0-beta.15
+
+## 4.0.0-beta.29
+
+### Patch Changes
+
+- Updated dependencies [34bd95d]
+- Updated dependencies [008271d]
+  - @ai-sdk/provider@4.0.0-beta.8
+  - @ai-sdk/provider-utils@5.0.0-beta.14
+
+## 4.0.0-beta.28
+
+### Patch Changes
+
+- Updated dependencies [b0c2869]
+- Updated dependencies [7e26e81]
+  - @ai-sdk/provider-utils@5.0.0-beta.13
+
+## 4.0.0-beta.27
+
+### Patch Changes
+
+- 46d1149: chore(provider-utils,google): fix grammar errors in error and warning messages
+- Updated dependencies [46d1149]
+  - @ai-sdk/provider-utils@5.0.0-beta.12
+
+## 4.0.0-beta.26
+
+### Patch Changes
+
+- a05109d: feat(provider/google): preserve per-modality token details in usage data
+
+## 4.0.0-beta.25
+
+### Patch Changes
+
+- Updated dependencies [6fd51c0]
+  - @ai-sdk/provider-utils@5.0.0-beta.11
+  - @ai-sdk/provider@4.0.0-beta.7
+
+## 4.0.0-beta.24
+
+### Patch Changes
+
+- 55db546: fix(provider/google): fix Gemini service tier enum after upstream update
+
+## 4.0.0-beta.23
+
+### Patch Changes
+
+- c29a26f: feat(provider): add support for provider references and uploading files as supported per provider
+- Updated dependencies [c29a26f]
+  - @ai-sdk/provider-utils@5.0.0-beta.10
+  - @ai-sdk/provider@4.0.0-beta.6
+
+## 4.0.0-beta.22
+
+### Patch Changes
+
+- 38fc777: Add AI Gateway hint to provider READMEs
+
+## 4.0.0-beta.21
+
+### Patch Changes
+
+- Updated dependencies [2e17091]
+  - @ai-sdk/provider-utils@5.0.0-beta.9
+
+## 4.0.0-beta.20
+
+### Patch Changes
+
+- Updated dependencies [986c6fd]
+- Updated dependencies [493295c]
+  - @ai-sdk/provider-utils@5.0.0-beta.8
+
+## 4.0.0-beta.19
+
+### Patch Changes
+
+- 01fa606: feat(provider/google): support combining built-in tools with function calling on Gemini 3
+
+## 4.0.0-beta.18
+
+### Patch Changes
+
+- 9715ec7: feat(provider/google): add support for service tier parameter
+
+## 4.0.0-beta.17
+
+### Patch Changes
+
+- Updated dependencies [1f509d4]
+  - @ai-sdk/provider-utils@5.0.0-beta.7
+  - @ai-sdk/provider@4.0.0-beta.5
+
+## 4.0.0-beta.16
+
+### Patch Changes
+
+- 6190649: chore(provider/google): remove obsolete Google image model
+
+## 4.0.0-beta.15
+
+### Patch Changes
+
+- 18c1970: feat(provider/google): Add multimodal tool-result support for Google function responses.
+
+  Tool results with `output.type = 'content'` now map media parts into
+  `functionResponse.parts` for Google models, including `image-data`,
+  `file-data`, and base64 `data:` URLs in URL-style content parts.
+  Remote HTTP(S) URLs in URL-style tool-result parts are not supported.
+
+## 4.0.0-beta.14
+
+### Patch Changes
+
+- 3887c70: feat(provider): add new top-level reasoning parameter to spec and support it in `generateText` and `streamText`
+- Updated dependencies [3887c70]
+  - @ai-sdk/provider-utils@5.0.0-beta.6
+  - @ai-sdk/provider@4.0.0-beta.4
+
+## 4.0.0-beta.13
+
+### Patch Changes
+
+- Updated dependencies [776b617]
+  - @ai-sdk/provider-utils@5.0.0-beta.5
+  - @ai-sdk/provider@4.0.0-beta.3
+
+## 4.0.0-beta.12
+
+### Patch Changes
+
+- Updated dependencies [61753c3]
+  - @ai-sdk/provider-utils@5.0.0-beta.4
+
+## 4.0.0-beta.11
+
+### Patch Changes
+
+- f7d4f01: feat(provider): add support for `reasoning-file` type for files that are part of reasoning
+- Updated dependencies [f7d4f01]
+  - @ai-sdk/provider-utils@5.0.0-beta.3
+  - @ai-sdk/provider@4.0.0-beta.2
+
+## 4.0.0-beta.10
+
+### Patch Changes
+
+- Updated dependencies [5c2a5a2]
+  - @ai-sdk/provider@4.0.0-beta.1
+  - @ai-sdk/provider-utils@5.0.0-beta.2
+
+## 4.0.0-beta.9
+
+### Patch Changes
+
+- e59176c: chore(google): update v3 specs to v4
+
+## 4.0.0-beta.8
+
+### Patch Changes
+
+- 4dac142: feat(google): add new finishMessage field in providerMetadata
+
+## 4.0.0-beta.7
+
+### Patch Changes
+
+- 82288b0: feat(provider/google): add `gemini-embedding-2-preview` and fix multimodal embedding support with `embedMany`
+
+## 4.0.0-beta.6
+
+### Patch Changes
+
+- add4326: fix(provider/google): correct JSDoc for multimodal embedding content option
+
+## 4.0.0-beta.5
+
+### Patch Changes
+
+- ab43029: feat(provider/google): support multimodal content parts in embedding provider options
+
+## 4.0.0-beta.4
+
+### Patch Changes
+
+- 2edd14e: fix(provider/google): correctly mark reasoning files as such and fix related multi-turn errors
+
 ## 4.0.0-beta.3
 
 ### Patch Changes
@@ -345,13 +550,13 @@
   Before
 
   ```ts
-  model.textEmbeddingModel('my-model-id');
+  model.textEmbeddingModel("my-model-id");
   ```
 
   After
 
   ```ts
-  model.embeddingModel('my-model-id');
+  model.embeddingModel("my-model-id");
   ```
 
 - 2625a04: feat(openai); update spec for mcp approval
@@ -660,13 +865,13 @@
   Before
 
   ```ts
-  model.textEmbeddingModel('my-model-id');
+  model.textEmbeddingModel("my-model-id");
   ```
 
   After
 
   ```ts
-  model.embeddingModel('my-model-id');
+  model.embeddingModel("my-model-id");
   ```
 
 - Updated dependencies [8d9e8ad]

package/README.md

@@ -2,6 +2,8 @@
 
 The **[Google Generative AI provider](https://ai-sdk.dev/providers/ai-sdk-providers/google-generative-ai)** for the [AI SDK](https://ai-sdk.dev/docs) contains language model support for the [Google Generative AI](https://ai.google/discover/generativeai/) APIs.
 
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access Google (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
+
 ## Setup
 
 The Google Generative AI provider is available in the `@ai-sdk/google` module. You can install it with

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema, FetchFunction } from '@ai-sdk/provider-utils';
-import { ProviderV3, LanguageModelV3, ImageModelV3, EmbeddingModelV3, Experimental_VideoModelV3 } from '@ai-sdk/provider';
+import { ProviderV4, LanguageModelV4, ImageModelV4, EmbeddingModelV4, Experimental_VideoModelV4, FilesV4 } from '@ai-sdk/provider';
 
 declare const googleErrorDataSchema: _ai_sdk_provider_utils.LazySchema<{
     error: {
@@ -11,7 +11,7 @@ declare const googleErrorDataSchema: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type GoogleErrorData = InferSchema<typeof googleErrorDataSchema>;
 
-type GoogleGenerativeAIModelId = 'gemini-2.0-flash' | 'gemini-2.0-flash-001' | 'gemini-2.0-flash-lite' | 'gemini-2.0-flash-exp-image-generation' | 'gemini-2.0-flash-lite-001' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro-preview-tts' | 'gemini-2.5-flash-native-audio-latest' | 'gemini-2.5-flash-native-audio-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-3-pro-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-flash-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-pro-preview-customtools' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'gemini-pro-latest' | 'gemini-flash-latest' | 'gemini-flash-lite-latest' | 'deep-research-pro-preview-12-2025' | 'nano-banana-pro-preview' | 'aqa' | 'gemini-robotics-er-1.5-preview' | 'gemma-3-1b-it' | 'gemma-3-4b-it' | 'gemma-3n-e4b-it' | 'gemma-3n-e2b-it' | 'gemma-3-12b-it' | 'gemma-3-27b-it' | (string & {});
+type GoogleGenerativeAIModelId = 'gemini-2.0-flash' | 'gemini-2.0-flash-001' | 'gemini-2.0-flash-lite' | 'gemini-2.0-flash-lite-001' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro-preview-tts' | 'gemini-2.5-flash-native-audio-latest' | 'gemini-2.5-flash-native-audio-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-3-pro-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-flash-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-pro-preview-customtools' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'gemini-pro-latest' | 'gemini-flash-latest' | 'gemini-flash-lite-latest' | 'deep-research-pro-preview-12-2025' | 'nano-banana-pro-preview' | 'aqa' | 'gemini-robotics-er-1.5-preview' | 'gemma-3-1b-it' | 'gemma-3-4b-it' | 'gemma-3n-e4b-it' | 'gemma-3n-e2b-it' | 'gemma-3-12b-it' | 'gemma-3-27b-it' | (string & {});
 declare const googleLanguageModelOptions: _ai_sdk_provider_utils.LazySchema<{
     responseModalities?: ("TEXT" | "IMAGE")[] | undefined;
     thinkingConfig?: {
@@ -39,6 +39,7 @@ declare const googleLanguageModelOptions: _ai_sdk_provider_utils.LazySchema<{
             longitude: number;
         } | undefined;
     } | undefined;
+    serviceTier?: "standard" | "flex" | "priority" | undefined;
 }>;
 type GoogleLanguageModelOptions = InferSchema<typeof googleLanguageModelOptions>;
 
@@ -56,6 +57,21 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
                     mimeType: string;
                     data: string;
                 };
+                thought?: boolean | null | undefined;
+                thoughtSignature?: string | null | undefined;
+            } | {
+                toolCall: {
+                    toolType: string;
+                    id: string;
+                    args?: unknown;
+                };
+                thoughtSignature?: string | null | undefined;
+            } | {
+                toolResponse: {
+                    toolType: string;
+                    id: string;
+                    response?: unknown;
+                };
                 thoughtSignature?: string | null | undefined;
             } | {
                 executableCode?: {
@@ -72,6 +88,7 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
             })[] | null | undefined;
         } | null | undefined;
         finishReason?: string | null | undefined;
+        finishMessage?: string | null | undefined;
         safetyRatings?: {
             category?: string | null | undefined;
             probability?: string | null | undefined;
@@ -141,6 +158,14 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
         candidatesTokenCount?: number | null | undefined;
         totalTokenCount?: number | null | undefined;
         trafficType?: string | null | undefined;
+        promptTokensDetails?: {
+            modality: string;
+            tokenCount: number;
+        }[] | null | undefined;
+        candidatesTokensDetails?: {
+            modality: string;
+            tokenCount: number;
+        }[] | null | undefined;
     } | null | undefined;
     promptFeedback?: {
         blockReason?: string | null | undefined;
@@ -153,18 +178,27 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
             blocked?: boolean | null | undefined;
         }[] | null | undefined;
     } | null | undefined;
+    serviceTier?: string | null | undefined;
 }>;
 type GroundingMetadataSchema = NonNullable<InferSchema<typeof responseSchema>['candidates'][number]['groundingMetadata']>;
 type UrlContextMetadataSchema = NonNullable<InferSchema<typeof responseSchema>['candidates'][number]['urlContextMetadata']>;
 type SafetyRatingSchema = NonNullable<InferSchema<typeof responseSchema>['candidates'][number]['safetyRatings']>[number];
+type PromptFeedbackSchema = NonNullable<InferSchema<typeof responseSchema>['promptFeedback']>;
+type UsageMetadataSchema = NonNullable<InferSchema<typeof responseSchema>['usageMetadata']>;
 
 type GoogleGenerativeAIGroundingMetadata = GroundingMetadataSchema;
 type GoogleGenerativeAIUrlContextMetadata = UrlContextMetadataSchema;
 type GoogleGenerativeAISafetyRating = SafetyRatingSchema;
+type GoogleGenerativeAIPromptFeedback = PromptFeedbackSchema;
+type GoogleGenerativeAIUsageMetadata = UsageMetadataSchema;
 interface GoogleGenerativeAIProviderMetadata {
+    promptFeedback: GoogleGenerativeAIPromptFeedback | null;
     groundingMetadata: GoogleGenerativeAIGroundingMetadata | null;
     urlContextMetadata: GoogleGenerativeAIUrlContextMetadata | null;
     safetyRatings: GoogleGenerativeAISafetyRating[] | null;
+    usageMetadata: GoogleGenerativeAIUsageMetadata | null;
+    finishMessage: string | null;
+    serviceTier: string | null;
 }
 
 type GoogleGenerativeAIImageModelId = 'imagen-4.0-generate-001' | 'imagen-4.0-ultra-generate-001' | 'imagen-4.0-fast-generate-001' | 'gemini-2.5-flash-image' | 'gemini-3-pro-image-preview' | 'gemini-3.1-flash-image-preview' | (string & {});
@@ -181,10 +215,18 @@ declare const googleImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type GoogleImageModelOptions = InferSchema<typeof googleImageModelOptionsSchema>;
 
-type GoogleGenerativeAIEmbeddingModelId = 'gemini-embedding-001' | (string & {});
+type GoogleGenerativeAIEmbeddingModelId = 'gemini-embedding-001' | 'gemini-embedding-2-preview' | (string & {});
 declare const googleEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
     outputDimensionality?: number | undefined;
     taskType?: "SEMANTIC_SIMILARITY" | "CLASSIFICATION" | "CLUSTERING" | "RETRIEVAL_DOCUMENT" | "RETRIEVAL_QUERY" | "QUESTION_ANSWERING" | "FACT_VERIFICATION" | "CODE_RETRIEVAL_QUERY" | undefined;
+    content?: (({
+        text: string;
+    } | {
+        inlineData: {
+            mimeType: string;
+            data: string;
+        };
+    })[] | null)[] | undefined;
 }>;
 type GoogleEmbeddingModelOptions = InferSchema<typeof googleEmbeddingModelOptions>;
 
@@ -202,6 +244,13 @@ type GoogleVideoModelOptions = {
     [key: string]: unknown;
 };
 
+type GoogleFilesUploadOptions = {
+    displayName?: string | null;
+    pollIntervalMs?: number | null;
+    pollTimeoutMs?: number | null;
+    [key: string]: unknown;
+};
+
 declare const googleTools: {
     /**
      * Creates a Google search tool that gives Google direct access to real-time web content.
@@ -217,7 +266,7 @@ declare const googleTools: {
             startTime: string;
             endTime: string;
         } | undefined;
-    }>;
+    }, {}>;
     /**
      * Creates an Enterprise Web Search tool for grounding responses using a compliance-focused web index.
      * Designed for highly-regulated industries (finance, healthcare, public sector).
@@ -228,7 +277,7 @@ declare const googleTools: {
      *
      * @see https://cloud.google.com/vertex-ai/generative-ai/docs/grounding/web-grounding-enterprise
      */
-    enterpriseWebSearch: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}>;
+    enterpriseWebSearch: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}, {}>;
     /**
      * Creates a Google Maps grounding tool that gives the model access to Google Maps data.
      * Must have name "google_maps".
@@ -236,12 +285,12 @@ declare const googleTools: {
      * @see https://ai.google.dev/gemini-api/docs/maps-grounding
      * @see https://cloud.google.com/vertex-ai/generative-ai/docs/grounding/grounding-with-google-maps
      */
-    googleMaps: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}>;
+    googleMaps: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}, {}>;
     /**
      * Creates a URL context tool that gives Google direct access to real-time web content.
      * Must have name "url_context".
      */
-    urlContext: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}>;
+    urlContext: _ai_sdk_provider_utils.ProviderToolFactory<{}, {}, {}>;
     /**
      * Enables Retrieval Augmented Generation (RAG) via the Gemini File Search tool.
      * Must have name "file_search".
@@ -257,7 +306,7 @@ declare const googleTools: {
         fileSearchStoreNames: string[];
         topK?: number | undefined;
         metadataFilter?: string | undefined;
-    }>;
+    }, {}>;
     /**
      * A tool that enables the model to generate and run Python code.
      * Must have name "code_execution".
@@ -274,7 +323,7 @@ declare const googleTools: {
     }, {
         outcome: string;
         output: string;
-    }, {}>;
+    }, {}, {}>;
     /**
      * Creates a Vertex RAG Store tool that enables the model to perform RAG searches against a Vertex RAG Store.
      * Must have name "vertex_rag_store".
@@ -282,45 +331,46 @@ declare const googleTools: {
     vertexRagStore: _ai_sdk_provider_utils.ProviderToolFactory<{}, {
         ragCorpus: string;
         topK?: number;
-    }>;
+    }, {}>;
 };
 
-interface GoogleGenerativeAIProvider extends ProviderV3 {
-    (modelId: GoogleGenerativeAIModelId): LanguageModelV3;
-    languageModel(modelId: GoogleGenerativeAIModelId): LanguageModelV3;
-    chat(modelId: GoogleGenerativeAIModelId): LanguageModelV3;
+interface GoogleGenerativeAIProvider extends ProviderV4 {
+    (modelId: GoogleGenerativeAIModelId): LanguageModelV4;
+    languageModel(modelId: GoogleGenerativeAIModelId): LanguageModelV4;
+    chat(modelId: GoogleGenerativeAIModelId): LanguageModelV4;
     /**
      * Creates a model for image generation.
      */
-    image(modelId: GoogleGenerativeAIImageModelId, settings?: GoogleGenerativeAIImageSettings): ImageModelV3;
+    image(modelId: GoogleGenerativeAIImageModelId, settings?: GoogleGenerativeAIImageSettings): ImageModelV4;
     /**
      * @deprecated Use `chat()` instead.
      */
-    generativeAI(modelId: GoogleGenerativeAIModelId): LanguageModelV3;
+    generativeAI(modelId: GoogleGenerativeAIModelId): LanguageModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embedding(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV3;
+    embedding(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embeddingModel(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV3;
+    embeddingModel(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embedding` instead.
      */
-    textEmbedding(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV3;
+    textEmbedding(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embeddingModel` instead.
      */
-    textEmbeddingModel(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV3;
+    textEmbeddingModel(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for video generation.
      */
-    video(modelId: GoogleGenerativeAIVideoModelId): Experimental_VideoModelV3;
+    video(modelId: GoogleGenerativeAIVideoModelId): Experimental_VideoModelV4;
     /**
      * Creates a model for video generation.
      */
-    videoModel(modelId: GoogleGenerativeAIVideoModelId): Experimental_VideoModelV3;
+    videoModel(modelId: GoogleGenerativeAIVideoModelId): Experimental_VideoModelV4;
+    files(): FilesV4;
     tools: typeof googleTools;
 }
 interface GoogleGenerativeAIProviderSettings {
@@ -364,4 +414,4 @@ declare const google: GoogleGenerativeAIProvider;
 
 declare const VERSION: string;
 
-export { type GoogleEmbeddingModelOptions, type GoogleErrorData, type GoogleEmbeddingModelOptions as GoogleGenerativeAIEmbeddingProviderOptions, type GoogleImageModelOptions as GoogleGenerativeAIImageProviderOptions, type GoogleGenerativeAIProvider, type GoogleGenerativeAIProviderMetadata, type GoogleLanguageModelOptions as GoogleGenerativeAIProviderOptions, type GoogleGenerativeAIProviderSettings, type GoogleGenerativeAIVideoModelId, type GoogleVideoModelOptions as GoogleGenerativeAIVideoProviderOptions, type GoogleImageModelOptions, type GoogleLanguageModelOptions, type GoogleVideoModelOptions, VERSION, createGoogleGenerativeAI, google };
+export { type GoogleEmbeddingModelOptions, type GoogleErrorData, type GoogleFilesUploadOptions, type GoogleEmbeddingModelOptions as GoogleGenerativeAIEmbeddingProviderOptions, type GoogleImageModelOptions as GoogleGenerativeAIImageProviderOptions, type GoogleGenerativeAIProvider, type GoogleGenerativeAIProviderMetadata, type GoogleLanguageModelOptions as GoogleGenerativeAIProviderOptions, type GoogleGenerativeAIProviderSettings, type GoogleGenerativeAIVideoModelId, type GoogleVideoModelOptions as GoogleGenerativeAIVideoProviderOptions, type GoogleImageModelOptions, type GoogleLanguageModelOptions, type GoogleVideoModelOptions, VERSION, createGoogleGenerativeAI, google };