@ai-sdk/google 4.0.0-beta.9 → 4.0.0-canary.51

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema, FetchFunction } from '@ai-sdk/provider-utils';
-import { ProviderV4, LanguageModelV4, ImageModelV4, EmbeddingModelV4, Experimental_VideoModelV4 } 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 GoogleModelId = '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-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-3.1-flash-tts-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,8 @@ declare const googleLanguageModelOptions: _ai_sdk_provider_utils.LazySchema<{
             longitude: number;
         } | undefined;
     } | undefined;
+    streamFunctionCallArguments?: boolean | undefined;
+    serviceTier?: "standard" | "flex" | "priority" | undefined;
 }>;
 type GoogleLanguageModelOptions = InferSchema<typeof googleLanguageModelOptions>;
 
@@ -47,8 +49,17 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
         content?: Record<string, never> | {
             parts?: ({
                 functionCall: {
-                    name: string;
-                    args: unknown;
+                    name?: string | null | undefined;
+                    args?: unknown;
+                    partialArgs?: {
+                        jsonPath: string;
+                        stringValue?: string | null | undefined;
+                        numberValue?: number | null | undefined;
+                        boolValue?: boolean | null | undefined;
+                        nullValue?: unknown;
+                        willContinue?: boolean | null | undefined;
+                    }[] | null | undefined;
+                    willContinue?: boolean | null | undefined;
                 };
                 thoughtSignature?: string | null | undefined;
             } | {
@@ -58,6 +69,20 @@ declare const responseSchema: _ai_sdk_provider_utils.LazySchema<{
                 };
                 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?: {
                     language: string;
@@ -143,6 +168,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;
@@ -155,6 +188,7 @@ 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']>;
@@ -162,26 +196,19 @@ type SafetyRatingSchema = NonNullable<InferSchema<typeof responseSchema>['candid
 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;
+type GoogleGroundingMetadata = GroundingMetadataSchema;
+type GoogleUrlContextMetadata = UrlContextMetadataSchema;
+type GoogleSafetyRating = SafetyRatingSchema;
+type GooglePromptFeedback = PromptFeedbackSchema;
+type GoogleUsageMetadata = UsageMetadataSchema;
+interface GoogleProviderMetadata {
+    promptFeedback: GooglePromptFeedback | null;
+    groundingMetadata: GoogleGroundingMetadata | null;
+    urlContextMetadata: GoogleUrlContextMetadata | null;
+    safetyRatings: GoogleSafetyRating[] | null;
+    usageMetadata: GoogleUsageMetadata | null;
     finishMessage: 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 & {});
-interface GoogleGenerativeAIImageSettings {
-    /**
-     * Override the maximum number of images per call (default 4)
-     */
-    maxImagesPerCall?: number;
+    serviceTier: string | null;
 }
 
 declare const googleImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
@@ -190,7 +217,7 @@ declare const googleImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type GoogleImageModelOptions = InferSchema<typeof googleImageModelOptionsSchema>;
 
-type GoogleGenerativeAIEmbeddingModelId = 'gemini-embedding-001' | 'gemini-embedding-2-preview' | (string & {});
+type GoogleEmbeddingModelId = '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;
@@ -205,8 +232,6 @@ declare const googleEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type GoogleEmbeddingModelOptions = InferSchema<typeof googleEmbeddingModelOptions>;
 
-type GoogleGenerativeAIVideoModelId = 'veo-3.1-fast-generate-preview' | 'veo-3.1-generate-preview' | 'veo-3.1-generate' | 'veo-3.0-generate-001' | 'veo-3.0-fast-generate-001' | 'veo-2.0-generate-001' | (string & {});
-
 type GoogleVideoModelOptions = {
     pollIntervalMs?: number | null;
     pollTimeoutMs?: number | null;
@@ -219,12 +244,21 @@ type GoogleVideoModelOptions = {
     [key: string]: unknown;
 };
 
+type GoogleVideoModelId = 'veo-3.1-fast-generate-preview' | 'veo-3.1-generate-preview' | 'veo-3.1-generate' | 'veo-3.1-lite-generate-preview' | 'veo-3.0-generate-001' | 'veo-3.0-fast-generate-001' | 'veo-2.0-generate-001' | (string & {});
+
+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.
      * Must have name "google_search".
      */
-    googleSearch: _ai_sdk_provider_utils.ProviderToolFactory<{}, {
+    googleSearch: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{}, {}, {
         [x: string]: unknown;
         searchTypes?: {
             webSearch?: Record<string, never> | undefined;
@@ -234,7 +268,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).
@@ -245,7 +279,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.ProviderExecutedToolFactory<{}, {}, {}, {}>;
     /**
      * Creates a Google Maps grounding tool that gives the model access to Google Maps data.
      * Must have name "google_maps".
@@ -253,12 +287,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.ProviderExecutedToolFactory<{}, {}, {}, {}>;
     /**
      * 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.ProviderExecutedToolFactory<{}, {}, {}, {}>;
     /**
      * Enables Retrieval Augmented Generation (RAG) via the Gemini File Search tool.
      * Must have name "file_search".
@@ -269,12 +303,12 @@ declare const googleTools: {
      *
      * @see https://ai.google.dev/gemini-api/docs/file-search
      */
-    fileSearch: _ai_sdk_provider_utils.ProviderToolFactory<{}, {
+    fileSearch: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{}, {}, {
         [x: string]: unknown;
         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".
@@ -285,62 +319,71 @@ declare const googleTools: {
      * @see https://ai.google.dev/gemini-api/docs/code-execution (Google AI)
      * @see https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/code-execution-api (Vertex AI)
      */
-    codeExecution: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+    codeExecution: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{
         language: string;
         code: string;
     }, {
         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".
      */
-    vertexRagStore: _ai_sdk_provider_utils.ProviderToolFactory<{}, {
+    vertexRagStore: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{}, {}, {
         ragCorpus: string;
         topK?: number;
-    }>;
+    }, {}>;
 };
 
-interface GoogleGenerativeAIProvider extends ProviderV4 {
-    (modelId: GoogleGenerativeAIModelId): LanguageModelV4;
-    languageModel(modelId: GoogleGenerativeAIModelId): LanguageModelV4;
-    chat(modelId: GoogleGenerativeAIModelId): LanguageModelV4;
+type GoogleImageModelId = '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 & {});
+interface GoogleImageSettings {
+    /**
+     * Override the maximum number of images per call (default 4)
+     */
+    maxImagesPerCall?: number;
+}
+
+interface GoogleProvider extends ProviderV4 {
+    (modelId: GoogleModelId): LanguageModelV4;
+    languageModel(modelId: GoogleModelId): LanguageModelV4;
+    chat(modelId: GoogleModelId): LanguageModelV4;
     /**
      * Creates a model for image generation.
      */
-    image(modelId: GoogleGenerativeAIImageModelId, settings?: GoogleGenerativeAIImageSettings): ImageModelV4;
+    image(modelId: GoogleImageModelId, settings?: GoogleImageSettings): ImageModelV4;
     /**
      * @deprecated Use `chat()` instead.
      */
-    generativeAI(modelId: GoogleGenerativeAIModelId): LanguageModelV4;
+    generativeAI(modelId: GoogleModelId): LanguageModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embedding(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
+    embedding(modelId: GoogleEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embeddingModel(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
+    embeddingModel(modelId: GoogleEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embedding` instead.
      */
-    textEmbedding(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
+    textEmbedding(modelId: GoogleEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embeddingModel` instead.
      */
-    textEmbeddingModel(modelId: GoogleGenerativeAIEmbeddingModelId): EmbeddingModelV4;
+    textEmbeddingModel(modelId: GoogleEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for video generation.
      */
-    video(modelId: GoogleGenerativeAIVideoModelId): Experimental_VideoModelV4;
+    video(modelId: GoogleVideoModelId): Experimental_VideoModelV4;
     /**
      * Creates a model for video generation.
      */
-    videoModel(modelId: GoogleGenerativeAIVideoModelId): Experimental_VideoModelV4;
+    videoModel(modelId: GoogleVideoModelId): Experimental_VideoModelV4;
+    files(): FilesV4;
     tools: typeof googleTools;
 }
-interface GoogleGenerativeAIProviderSettings {
+interface GoogleProviderSettings {
     /**
      * Use a different URL prefix for API calls, e.g. to use proxy servers.
      * The default prefix is `https://generativelanguage.googleapis.com/v1beta`.
@@ -371,14 +414,14 @@ interface GoogleGenerativeAIProviderSettings {
     name?: string;
 }
 /**
- * Create a Google Generative AI provider instance.
+ * Create a Google provider instance.
  */
-declare function createGoogleGenerativeAI(options?: GoogleGenerativeAIProviderSettings): GoogleGenerativeAIProvider;
+declare function createGoogle(options?: GoogleProviderSettings): GoogleProvider;
 /**
  * Default Google Generative AI provider instance.
  */
-declare const google: GoogleGenerativeAIProvider;
+declare const google: GoogleProvider;
 
 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 GoogleProvider as GoogleGenerativeAIProvider, type GoogleProviderMetadata as GoogleGenerativeAIProviderMetadata, type GoogleLanguageModelOptions as GoogleGenerativeAIProviderOptions, type GoogleProviderSettings as GoogleGenerativeAIProviderSettings, type GoogleVideoModelId as GoogleGenerativeAIVideoModelId, type GoogleVideoModelOptions as GoogleGenerativeAIVideoProviderOptions, type GoogleImageModelOptions, type GoogleLanguageModelOptions, type GoogleProvider, type GoogleProviderMetadata, type GoogleProviderSettings, type GoogleVideoModelId, type GoogleVideoModelOptions, VERSION, createGoogle, createGoogle as createGoogleGenerativeAI, google };