@google/genai 1.33.0 → 1.35.0

package/dist/web/web.d.ts

@@ -119,7 +119,7 @@ export declare interface ApiAuthApiKeyConfig {
  * The ApiClient class is used to send requests to the Gemini API or Vertex AI
  * endpoints.
  */
-declare class ApiClient {
+declare class ApiClient implements GeminiNextGenAPIClientAdapter {
     readonly clientOptions: ApiClientInitOptions;
     constructor(opts: ApiClientInitOptions);
     /**
@@ -140,6 +140,7 @@ declare class ApiClient {
     isVertexAI(): boolean;
     getProject(): string | undefined;
     getLocation(): string | undefined;
+    getAuthHeaders(): Promise<Headers>;
     getApiVersion(): string;
     getBaseUrl(): string;
     getRequestUrl(): string;
@@ -415,9 +416,6 @@ export declare interface AudioChunk {
  * An audio content block.
  */
 declare interface AudioContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'audio';
     data?: string;
     /**
@@ -583,7 +581,7 @@ declare interface BaseCreateAgentInteractionParams {
     /**
      * Body param: The inputs for the interaction.
      */
-    input: string | Array<TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent;
+    input: string | Array<Content_2> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent;
     /**
      * Path param: Which version of the API to use.
      */
@@ -635,7 +633,7 @@ declare interface BaseCreateModelInteractionParams {
     /**
      * Body param: The inputs for the interaction.
      */
-    input: string | Array<TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent;
+    input: string | Array<Content_2> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent;
     /**
      * Body param: The name of the `Model` used for generating the interaction.
      */
@@ -703,6 +701,7 @@ declare class BaseGeminiNextGenAPIClient {
     private encoder;
     protected idempotencyHeader?: string;
     private _options;
+    private clientAdapter;
     /**
      * API Client for interfacing with the Gemini Next Gen API API.
      *
@@ -716,7 +715,7 @@ declare class BaseGeminiNextGenAPIClient {
      * @param {HeadersLike} opts.defaultHeaders - Default headers to include with every request to the API.
      * @param {Record<string, string | undefined>} opts.defaultQuery - Default query parameters to include with every request to the API.
      */
-    constructor({ baseURL, apiKey, apiVersion, ...opts }?: ClientOptions);
+    constructor({ baseURL, apiKey, apiVersion, ...opts }: ClientOptions);
     /**
      * Create a new client instance re-using the same options given to the current client with optional overriding.
      */
@@ -738,6 +737,7 @@ declare class BaseGeminiNextGenAPIClient {
     buildURL(path: string, query: Record<string, unknown> | null | undefined, defaultBaseURL?: string | undefined): string;
     /**
      * Used as a callback for mutating the given `FinalRequestOptions` object.
+
      */
     protected prepareOptions(options: FinalRequestOptions): Promise<void>;
     /**
@@ -1045,7 +1045,7 @@ export declare interface BatchJobSource {
 
 export declare type BatchJobSourceUnion = BatchJobSource | InlinedRequest[] | string;
 
-/** Defines the function behavior. Defaults to `BLOCKING`. */
+/** Specifies the function Behavior. Currently only supported by the BidiGenerateContent method. This enum is not supported in Vertex AI. */
 export declare enum Behavior {
     /**
      * This value is unused.
@@ -1578,6 +1578,10 @@ declare interface ClientOptions {
      * Defaults to globalThis.console.
      */
     logger?: Logger | undefined;
+    /**
+     * The adapter to the parent API client instance (for accessing auth, project, location)
+     */
+    clientAdapter: GeminiNextGenAPIClientAdapter;
 }
 
 /**
@@ -1598,9 +1602,6 @@ declare interface CodeExecutionCallArguments {
  * Code execution content.
  */
 declare interface CodeExecutionCallContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'code_execution_call';
     /**
      * A unique ID for this specific tool call.
@@ -1624,9 +1625,6 @@ export declare interface CodeExecutionResult {
  * Code execution result content.
  */
 declare interface CodeExecutionResultContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'code_execution_result';
     /**
      * ID to match the ID from the code execution call block.
@@ -1719,11 +1717,15 @@ export declare interface Content {
     role?: string;
 }
 
+/**
+ * The content of the response.
+ */
+declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent;
+
 declare interface ContentDelta {
     delta?: ContentDelta.TextDelta | ContentDelta.ImageDelta | ContentDelta.AudioDelta | ContentDelta.DocumentDelta | ContentDelta.VideoDelta | ContentDelta.ThoughtSummaryDelta | ContentDelta.ThoughtSignatureDelta | ContentDelta.FunctionCallDelta | ContentDelta.FunctionResultDelta | ContentDelta.CodeExecutionCallDelta | ContentDelta.CodeExecutionResultDelta | ContentDelta.URLContextCallDelta | ContentDelta.URLContextResultDelta | ContentDelta.GoogleSearchCallDelta | ContentDelta.GoogleSearchResultDelta | ContentDelta.MCPServerToolCallDelta | ContentDelta.MCPServerToolResultDelta | ContentDelta.FileSearchResultDelta;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
     event_type?: 'content.delta';
@@ -1732,9 +1734,6 @@ declare interface ContentDelta {
 
 declare namespace ContentDelta {
     interface TextDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'text';
         /**
          * Citation information for model-generated content.
@@ -1743,9 +1742,6 @@ declare namespace ContentDelta {
         text?: string;
     }
     interface ImageDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'image';
         data?: string;
         /**
@@ -1755,13 +1751,10 @@ declare namespace ContentDelta {
         /**
          * The resolution of the media.
          */
-        resolution?: 'low' | 'medium' | 'high';
+        resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
         uri?: string;
     }
     interface AudioDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'audio';
         data?: string;
         /**
@@ -1771,18 +1764,15 @@ declare namespace ContentDelta {
         uri?: string;
     }
     interface DocumentDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'document';
         data?: string;
-        mime_type?: string;
+        /**
+         * The mime type of the document.
+         */
+        mime_type?: InteractionsAPI.DocumentMimeType;
         uri?: string;
     }
     interface VideoDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'video';
         data?: string;
         /**
@@ -1792,13 +1782,10 @@ declare namespace ContentDelta {
         /**
          * The resolution of the media.
          */
-        resolution?: 'low' | 'medium' | 'high';
+        resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
         uri?: string;
     }
     interface ThoughtSummaryDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'thought_summary';
         /**
          * A text content block.
@@ -1806,9 +1793,6 @@ declare namespace ContentDelta {
         content?: InteractionsAPI.TextContent | InteractionsAPI.ImageContent;
     }
     interface ThoughtSignatureDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'thought_signature';
         /**
          * Signature to match the backend source to be part of the generation.
@@ -1816,9 +1800,6 @@ declare namespace ContentDelta {
         signature?: string;
     }
     interface FunctionCallDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'function_call';
         /**
          * A unique ID for this specific tool call.
@@ -1830,9 +1811,6 @@ declare namespace ContentDelta {
         name?: string;
     }
     interface FunctionResultDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'function_result';
         /**
          * ID to match the ID from the function call block.
@@ -1847,13 +1825,10 @@ declare namespace ContentDelta {
     }
     namespace FunctionResultDelta {
         interface Items {
-            items?: Array<string | InteractionsAPI.ImageContent>;
+            items?: Array<string | InteractionsAPI.ImageContent | unknown>;
         }
     }
     interface CodeExecutionCallDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'code_execution_call';
         /**
          * A unique ID for this specific tool call.
@@ -1865,9 +1840,6 @@ declare namespace ContentDelta {
         arguments?: InteractionsAPI.CodeExecutionCallArguments;
     }
     interface CodeExecutionResultDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'code_execution_result';
         /**
          * ID to match the ID from the function call block.
@@ -1878,9 +1850,6 @@ declare namespace ContentDelta {
         signature?: string;
     }
     interface URLContextCallDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'url_context_call';
         /**
          * A unique ID for this specific tool call.
@@ -1892,9 +1861,6 @@ declare namespace ContentDelta {
         arguments?: InteractionsAPI.URLContextCallArguments;
     }
     interface URLContextResultDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'url_context_result';
         /**
          * ID to match the ID from the function call block.
@@ -1905,9 +1871,6 @@ declare namespace ContentDelta {
         signature?: string;
     }
     interface GoogleSearchCallDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'google_search_call';
         /**
          * A unique ID for this specific tool call.
@@ -1919,9 +1882,6 @@ declare namespace ContentDelta {
         arguments?: InteractionsAPI.GoogleSearchCallArguments;
     }
     interface GoogleSearchResultDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'google_search_result';
         /**
          * ID to match the ID from the function call block.
@@ -1932,9 +1892,6 @@ declare namespace ContentDelta {
         signature?: string;
     }
     interface MCPServerToolCallDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'mcp_server_tool_call';
         /**
          * A unique ID for this specific tool call.
@@ -1947,9 +1904,6 @@ declare namespace ContentDelta {
         server_name?: string;
     }
     interface MCPServerToolResultDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'mcp_server_tool_result';
         /**
          * ID to match the ID from the function call block.
@@ -1964,13 +1918,10 @@ declare namespace ContentDelta {
     }
     namespace MCPServerToolResultDelta {
         interface Items {
-            items?: Array<string | InteractionsAPI.ImageContent>;
+            items?: Array<string | InteractionsAPI.ImageContent | unknown>;
         }
     }
     interface FileSearchResultDelta {
-        /**
-         * Used as the OpenAPI type discriminator for the content oneof.
-         */
         type: 'file_search_result';
         result?: Array<FileSearchResultDelta.Result>;
     }
@@ -2039,10 +1990,9 @@ declare interface ContentStart {
     /**
      * The content of the response.
      */
-    content?: TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent;
+    content?: Content_2;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
     event_type?: 'content.start';
@@ -2051,8 +2001,7 @@ declare interface ContentStart {
 
 declare interface ContentStop {
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
     event_type?: 'content.stop';
@@ -2603,9 +2552,6 @@ declare interface DeepResearchAgentConfig {
      * Whether to include thought summaries in the response.
      */
     thinking_summaries?: 'auto' | 'none';
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type?: 'deep-research';
 }
 
@@ -2807,15 +2753,20 @@ export { Document_2 as Document }
  * A document content block.
  */
 declare interface DocumentContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'document';
     data?: string;
-    mime_type?: string;
+    /**
+     * The mime type of the document.
+     */
+    mime_type?: DocumentMimeType;
     uri?: string;
 }
 
+/**
+ * The mime type of the document.
+ */
+declare type DocumentMimeType = (string & {}) | 'application/pdf';
+
 declare class Documents extends BaseModule {
     private readonly apiClient;
     constructor(apiClient: ApiClient);
@@ -2901,22 +2852,19 @@ export declare interface DownloadFileParameters {
  * Configuration for dynamic agents.
  */
 declare interface DynamicAgentConfig {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type?: 'dynamic';
     [k: string]: unknown;
 }
 
 /** Describes the options to customize dynamic retrieval. */
 export declare interface DynamicRetrievalConfig {
-    /** The mode of the predictor to be used in dynamic retrieval. */
-    mode?: DynamicRetrievalConfigMode;
     /** Optional. The threshold to be used in dynamic retrieval. If not set, a system default value is used. */
     dynamicThreshold?: number;
+    /** The mode of the predictor to be used in dynamic retrieval. */
+    mode?: DynamicRetrievalConfigMode;
 }
 
-/** Config for the dynamic retrieval config mode. */
+/** The mode of the predictor to be used in dynamic retrieval. */
 export declare enum DynamicRetrievalConfigMode {
     /**
      * Always trigger retrieval.
@@ -3167,8 +3115,7 @@ declare interface ErrorEvent_2 {
      */
     error?: ErrorEvent_2.Error;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
     event_type?: 'error';
@@ -3456,9 +3403,6 @@ export declare interface FileSearch {
  * File Search result content.
  */
 declare interface FileSearchResultContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'file_search_result';
     /**
      * The results of the File Search.
@@ -3600,7 +3544,8 @@ declare class FileSearchStores extends BaseModule {
 export declare enum FileSource {
     SOURCE_UNSPECIFIED = "SOURCE_UNSPECIFIED",
     UPLOADED = "UPLOADED",
-    GENERATED = "GENERATED"
+    GENERATED = "GENERATED",
+    REGISTERED = "REGISTERED"
 }
 
 /**
@@ -3773,26 +3718,23 @@ declare interface FunctionCallContent {
      * The name of the tool to call.
      */
     name: string;
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'function_call';
 }
 
 /** Function calling config. */
 export declare interface FunctionCallingConfig {
-    /** Optional. Function calling mode. */
-    mode?: FunctionCallingConfigMode;
     /** Optional. Function names to call. Only set when the Mode is ANY. Function names should match [FunctionDeclaration.name]. With mode set to ANY, model will predict a function call from the set of function names provided. */
     allowedFunctionNames?: string[];
+    /** Optional. Function calling mode. */
+    mode?: FunctionCallingConfigMode;
     /** Optional. When set to true, arguments of a single function call will be streamed out in multiple parts/contents/responses. Partial parameter results will be returned in the [FunctionCall.partial_args] field. This field is not supported in Gemini API. */
     streamFunctionCallArguments?: boolean;
 }
 
-/** Config for the function calling config mode. */
+/** Function calling mode. */
 export declare enum FunctionCallingConfigMode {
     /**
-     * The function calling config mode is unspecified. Should not be used.
+     * Unspecified function calling mode. This value should not be used.
      */
     MODE_UNSPECIFIED = "MODE_UNSPECIFIED",
     /**
@@ -3808,18 +3750,13 @@ export declare enum FunctionCallingConfigMode {
      */
     NONE = "NONE",
     /**
-     * Model decides to predict either a function call or a natural language response, but will validate function calls with constrained decoding. If "allowed_function_names" are set, the predicted function call will be limited to any one of "allowed_function_names", else the predicted function call will be any one of the provided "function_declarations".
+     * Model is constrained to predict either function calls or natural language response. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
      */
     VALIDATED = "VALIDATED"
 }
 
-/** Defines a function that the model can generate JSON inputs for.
-
- The inputs are based on `OpenAPI 3.0 specifications
- <https://spec.openapis.org/oas/v3.0.3>`_. */
+/** Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client. */
 export declare interface FunctionDeclaration {
-    /** Defines the function behavior. */
-    behavior?: Behavior;
     /** Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function. */
     description?: string;
     /** Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots and dashes, with a maximum length of 64. */
@@ -3832,6 +3769,8 @@ export declare interface FunctionDeclaration {
     response?: Schema;
     /** Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. */
     responseJsonSchema?: unknown;
+    /** Optional. Specifies the function Behavior. Currently only supported by the BidiGenerateContent method. This field is not supported in Vertex AI. */
+    behavior?: Behavior;
 }
 
 /** A function response. */
@@ -3925,9 +3864,6 @@ declare interface FunctionResultContent {
      * The result of the tool call.
      */
     result: FunctionResultContent.Items | unknown | string;
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'function_result';
     /**
      * Whether the tool call resulted in an error.
@@ -3941,10 +3877,22 @@ declare interface FunctionResultContent {
 
 declare namespace FunctionResultContent {
     interface Items {
-        items?: Array<string | InteractionsAPI.ImageContent>;
+        items?: Array<string | InteractionsAPI.ImageContent | unknown>;
     }
 }
 
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+declare interface GeminiNextGenAPIClientAdapter {
+    isVertexAI: () => boolean;
+    getProject: () => string | undefined;
+    getLocation: () => string | undefined;
+    getAuthHeaders: () => Headers | Promise<Headers>;
+}
+
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -5010,9 +4958,6 @@ declare interface GoogleSearchCallArguments {
  * Google Search content.
  */
 declare interface GoogleSearchCallContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'google_search_call';
     /**
      * A unique ID for this specific tool call.
@@ -5046,9 +4991,6 @@ declare interface GoogleSearchResult {
  * Google Search result content.
  */
 declare interface GoogleSearchResultContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'google_search_result';
     /**
      * ID to match the ID from the google search call block.
@@ -5483,6 +5425,9 @@ export declare interface ImageConfig {
      values are `1K`, `2K`, `4K`. If not specified, the model will use default
      value `1K`. */
     imageSize?: string;
+    /** Controls the generation of people. Supported values are:
+     ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE. */
+    personGeneration?: string;
     /** MIME type of the generated image. This field is not
      supported in Gemini API. */
     outputMimeType?: string;
@@ -5495,9 +5440,6 @@ export declare interface ImageConfig {
  * An image content block.
  */
 declare interface ImageContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'image';
     data?: string;
     /**
@@ -5507,7 +5449,7 @@ declare interface ImageContent {
     /**
      * The resolution of the media.
      */
-    resolution?: 'low' | 'medium' | 'high';
+    resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
     uri?: string;
 }
 
@@ -5670,14 +5612,10 @@ declare interface Interaction {
      * The name of the `Model` used for generating the interaction.
      */
     model?: Model_2;
-    /**
-     * Output only. The object type of the interaction. Always set to `interaction`.
-     */
-    object?: 'interaction';
     /**
      * Output only. Responses from the model.
      */
-    outputs?: Array<TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent>;
+    outputs?: Array<Content_2>;
     /**
      * The ID of the previous interaction, if any.
      */
@@ -5717,8 +5655,7 @@ declare type InteractionDeleteResponse = unknown;
 
 declare interface InteractionEvent {
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
     event_type?: 'interaction.start' | 'interaction.complete';
@@ -5768,7 +5705,7 @@ export declare class Interactions extends BaseInteractions {
 }
 
 export declare namespace Interactions {
-    export { type AllowedTools as AllowedTools, type Annotation as Annotation, type AudioContent as AudioContent, type AudioMimeType as AudioMimeType, type CodeExecutionCallArguments as CodeExecutionCallArguments, type CodeExecutionCallContent as CodeExecutionCallContent, type CodeExecutionResultContent as CodeExecutionResultContent, type ContentDelta as ContentDelta, type ContentStart as ContentStart, type ContentStop as ContentStop, type DeepResearchAgentConfig as DeepResearchAgentConfig, type DocumentContent as DocumentContent, type DynamicAgentConfig as DynamicAgentConfig, type ErrorEvent_2 as ErrorEvent, type FileSearchResultContent as FileSearchResultContent, type Function_2 as Function, type FunctionCallContent as FunctionCallContent, type FunctionResultContent as FunctionResultContent, type GenerationConfig_2 as GenerationConfig, type GoogleSearchCallArguments as GoogleSearchCallArguments, type GoogleSearchCallContent as GoogleSearchCallContent, type GoogleSearchResult as GoogleSearchResult, type GoogleSearchResultContent as GoogleSearchResultContent, type ImageContent as ImageContent, type ImageMimeType as ImageMimeType, type Interaction as Interaction, type InteractionEvent as InteractionEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStatusUpdate as InteractionStatusUpdate, type MCPServerToolCallContent as MCPServerToolCallContent, type MCPServerToolResultContent as MCPServerToolResultContent, type Model_2 as Model, type SpeechConfig_2 as SpeechConfig, type TextContent as TextContent, type ThinkingLevel_2 as ThinkingLevel, type ThoughtContent as ThoughtContent, type Tool_2 as Tool, type ToolChoice as ToolChoice, type ToolChoiceConfig as ToolChoiceConfig, type ToolChoiceType as ToolChoiceType, type Turn as Turn, type URLContextCallArguments as URLContextCallArguments, type URLContextCallContent as URLContextCallContent, type URLContextResult as URLContextResult, type URLContextResultContent as URLContextResultContent, type Usage as Usage, type VideoContent as VideoContent, type VideoMimeType as VideoMimeType, type InteractionDeleteResponse as InteractionDeleteResponse, type InteractionCreateParams as InteractionCreateParams, type CreateModelInteractionParamsNonStreaming as CreateModelInteractionParamsNonStreaming, type CreateModelInteractionParamsStreaming as CreateModelInteractionParamsStreaming, type CreateAgentInteractionParamsNonStreaming as CreateAgentInteractionParamsNonStreaming, type CreateAgentInteractionParamsStreaming as CreateAgentInteractionParamsStreaming, type InteractionDeleteParams as InteractionDeleteParams, type InteractionCancelParams as InteractionCancelParams, type InteractionGetParams as InteractionGetParams, type InteractionGetParamsNonStreaming as InteractionGetParamsNonStreaming, type InteractionGetParamsStreaming as InteractionGetParamsStreaming, };
+    export { type AllowedTools as AllowedTools, type Annotation as Annotation, type AudioContent as AudioContent, type AudioMimeType as AudioMimeType, type CodeExecutionCallArguments as CodeExecutionCallArguments, type CodeExecutionCallContent as CodeExecutionCallContent, type CodeExecutionResultContent as CodeExecutionResultContent, type Content_2 as Content, type ContentDelta as ContentDelta, type ContentStart as ContentStart, type ContentStop as ContentStop, type DeepResearchAgentConfig as DeepResearchAgentConfig, type DocumentContent as DocumentContent, type DocumentMimeType as DocumentMimeType, type DynamicAgentConfig as DynamicAgentConfig, type ErrorEvent_2 as ErrorEvent, type FileSearchResultContent as FileSearchResultContent, type Function_2 as Function, type FunctionCallContent as FunctionCallContent, type FunctionResultContent as FunctionResultContent, type GenerationConfig_2 as GenerationConfig, type GoogleSearchCallArguments as GoogleSearchCallArguments, type GoogleSearchCallContent as GoogleSearchCallContent, type GoogleSearchResult as GoogleSearchResult, type GoogleSearchResultContent as GoogleSearchResultContent, type ImageContent as ImageContent, type ImageMimeType as ImageMimeType, type Interaction as Interaction, type InteractionEvent as InteractionEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStatusUpdate as InteractionStatusUpdate, type MCPServerToolCallContent as MCPServerToolCallContent, type MCPServerToolResultContent as MCPServerToolResultContent, type Model_2 as Model, type SpeechConfig_2 as SpeechConfig, type TextContent as TextContent, type ThinkingLevel_2 as ThinkingLevel, type ThoughtContent as ThoughtContent, type Tool_2 as Tool, type ToolChoice as ToolChoice, type ToolChoiceConfig as ToolChoiceConfig, type ToolChoiceType as ToolChoiceType, type Turn as Turn, type URLContextCallArguments as URLContextCallArguments, type URLContextCallContent as URLContextCallContent, type URLContextResult as URLContextResult, type URLContextResultContent as URLContextResultContent, type Usage as Usage, type VideoContent as VideoContent, type VideoMimeType as VideoMimeType, type InteractionDeleteResponse as InteractionDeleteResponse, type InteractionCreateParams as InteractionCreateParams, type CreateModelInteractionParamsNonStreaming as CreateModelInteractionParamsNonStreaming, type CreateModelInteractionParamsStreaming as CreateModelInteractionParamsStreaming, type CreateAgentInteractionParamsNonStreaming as CreateAgentInteractionParamsNonStreaming, type CreateAgentInteractionParamsStreaming as CreateAgentInteractionParamsStreaming, type InteractionDeleteParams as InteractionDeleteParams, type InteractionCancelParams as InteractionCancelParams, type InteractionGetParams as InteractionGetParams, type InteractionGetParamsNonStreaming as InteractionGetParamsNonStreaming, type InteractionGetParamsStreaming as InteractionGetParamsStreaming, };
 }
 
 declare namespace InteractionsAPI {
@@ -5782,11 +5719,13 @@ declare namespace InteractionsAPI {
         CodeExecutionCallArguments,
         CodeExecutionCallContent,
         CodeExecutionResultContent,
+        Content_2 as Content,
         ContentDelta,
         ContentStart,
         ContentStop,
         DeepResearchAgentConfig,
         DocumentContent,
+        DocumentMimeType,
         DynamicAgentConfig,
         ErrorEvent_2 as ErrorEvent,
         FileSearchResultContent,
@@ -5844,8 +5783,7 @@ declare type InteractionSSEEvent = InteractionEvent | InteractionStatusUpdate |
 
 declare interface InteractionStatusUpdate {
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
     event_type?: 'interaction.status_update';
@@ -7032,9 +6970,6 @@ declare interface MCPServerToolCallContent {
      * The name of the used MCP server.
      */
     server_name: string;
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'mcp_server_tool_call';
 }
 
@@ -7050,9 +6985,6 @@ declare interface MCPServerToolResultContent {
      * The result of the tool call.
      */
     result: MCPServerToolResultContent.Items | unknown | string;
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'mcp_server_tool_result';
     /**
      * Name of the tool which is called for this specific tool call.
@@ -7066,7 +6998,7 @@ declare interface MCPServerToolResultContent {
 
 declare namespace MCPServerToolResultContent {
     interface Items {
-        items?: Array<string | InteractionsAPI.ImageContent>;
+        items?: Array<string | InteractionsAPI.ImageContent | unknown>;
     }
 }
 
@@ -7166,18 +7098,6 @@ export declare interface ModalityTokenCount {
     tokenCount?: number;
 }
 
-/** The mode of the predictor to be used in dynamic retrieval. */
-export declare enum Mode {
-    /**
-     * Always trigger retrieval.
-     */
-    MODE_UNSPECIFIED = "MODE_UNSPECIFIED",
-    /**
-     * Run retrieval only when system decides it is necessary.
-     */
-    MODE_DYNAMIC = "MODE_DYNAMIC"
-}
-
 /** A trained machine learning model. */
 export declare interface Model {
     /** Resource name of the model. */
@@ -7236,7 +7156,7 @@ export declare interface Model {
 /**
  * The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
  */
-declare type Model_2 = 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-preview-native-audio-dialog' | 'gemini-2.5-flash-image-preview' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-pro-preview' | (string & {});
+declare type Model_2 = 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-preview-native-audio-dialog' | 'gemini-2.5-flash-image-preview' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-pro-preview' | 'gemini-3-flash-preview' | (string & {});
 
 export declare class Models extends BaseModule {
     private readonly apiClient;
@@ -7348,7 +7268,7 @@ export declare class Models extends BaseModule {
      * @example
      * ```ts
      * const response = await client.models.generateImages({
-     *  model: 'imagen-3.0-generate-002',
+     *  model: 'imagen-4.0-generate-001',
      *  prompt: 'Robot holding a red skateboard',
      *  config: {
      *    numberOfImages: 1,
@@ -7391,7 +7311,7 @@ export declare class Models extends BaseModule {
      * @example
      * ```ts
      * const response = await client.models.upscaleImage({
-     *  model: 'imagen-3.0-generate-002',
+     *  model: 'imagen-4.0-upscale-preview',
      *  image: image,
      *  upscaleFactor: 'x2',
      *  config: {
@@ -7490,7 +7410,7 @@ export declare class Models extends BaseModule {
      * console.log(response1?.generatedImages?.[0]?.image?.imageBytes);
      *
      * const response2 = await ai.models.recontextImage({
-     *  model: 'virtual-try-on-preview-08-04',
+     *  model: 'virtual-try-on-001',
      *  source: {
      *    personImage: personImage,
      *    productImages: [productImage],
@@ -7612,9 +7532,9 @@ export declare interface ModelSelectionConfig {
     featureSelectionPreference?: FeatureSelectionPreference;
 }
 
-/** The configuration for the multi-speaker setup. This data type is not supported in Vertex AI. */
+/** Configuration for a multi-speaker text-to-speech request. */
 export declare interface MultiSpeakerVoiceConfig {
-    /** Required. All the enabled speaker voices. */
+    /** Required. A list of configurations for the voices of the speakers. Exactly two speaker voice configurations must be provided. */
     speakerVoiceConfigs?: SpeakerVoiceConfig[];
 }
 
@@ -7983,7 +7903,11 @@ export declare enum PartMediaResolutionLevel {
     /**
      * Media resolution set to high.
      */
-    MEDIA_RESOLUTION_HIGH = "MEDIA_RESOLUTION_HIGH"
+    MEDIA_RESOLUTION_HIGH = "MEDIA_RESOLUTION_HIGH",
+    /**
+     * Media resolution set to ultra high.
+     */
+    MEDIA_RESOLUTION_ULTRA_HIGH = "MEDIA_RESOLUTION_ULTRA_HIGH"
 }
 
 /** Tuning spec for Partner models. This data type is not supported in Gemini API. */
@@ -8925,7 +8849,7 @@ export declare interface SpeechConfig {
     voiceConfig?: VoiceConfig;
     /** Optional. Language code (ISO 639. e.g. en-US) for the speech synthesization. */
     languageCode?: string;
-    /** Optional. The configuration for the multi-speaker setup. It is mutually exclusive with the voice_config field. This field is not supported in Vertex AI. */
+    /** The configuration for a multi-speaker text-to-speech request. This field is mutually exclusive with `voice_config`. */
     multiSpeakerVoiceConfig?: MultiSpeakerVoiceConfig;
 }
 
@@ -9175,9 +9099,6 @@ export declare interface TestTableItem {
  * A text content block.
  */
 declare interface TextContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'text';
     /**
      * Citation information for model-generated content.
@@ -9197,35 +9118,40 @@ export declare interface ThinkingConfig {
     /** Indicates the thinking budget in tokens. 0 is DISABLED. -1 is AUTOMATIC. The default values and allowed ranges are model dependent.
      */
     thinkingBudget?: number;
-    /** Optional. The level of thoughts tokens that the model should generate. */
+    /** Optional. The number of thoughts tokens that the model should generate. */
     thinkingLevel?: ThinkingLevel;
 }
 
-/** The level of thoughts tokens that the model should generate. */
+/** The number of thoughts tokens that the model should generate. */
 export declare enum ThinkingLevel {
     /**
-     * Default value.
+     * Unspecified thinking level.
      */
     THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
     /**
      * Low thinking level.
      */
     LOW = "LOW",
+    /**
+     * Medium thinking level.
+     */
+    MEDIUM = "MEDIUM",
     /**
      * High thinking level.
      */
-    HIGH = "HIGH"
+    HIGH = "HIGH",
+    /**
+     * MINIMAL thinking level.
+     */
+    MINIMAL = "MINIMAL"
 }
 
-declare type ThinkingLevel_2 = 'low' | 'high';
+declare type ThinkingLevel_2 = 'minimal' | 'low' | 'medium' | 'high';
 
 /**
  * A thought content block.
  */
 declare interface ThoughtContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'thought';
     /**
      * Signature to match the backend source to be part of the generation.
@@ -9339,12 +9265,8 @@ export declare interface TokensInfo {
 
 /** Tool details of a tool that the model may use to generate a response. */
 export declare interface Tool {
-    /** List of function declarations that the tool supports. */
-    functionDeclarations?: FunctionDeclaration[];
     /** Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. This field is not supported in Gemini API. */
     retrieval?: Retrieval;
-    /** Optional. Specialized retrieval tool that is powered by Google Search. */
-    googleSearchRetrieval?: GoogleSearchRetrieval;
     /** Optional. Tool to support the model interacting directly with the
      computer. If enabled, it automatically populates computer-use specific
      Function Declarations. */
@@ -9355,10 +9277,14 @@ export declare interface Tool {
     codeExecution?: ToolCodeExecution;
     /** Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. This field is not supported in Gemini API. */
     enterpriseWebSearch?: EnterpriseWebSearch;
+    /** Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided. */
+    functionDeclarations?: FunctionDeclaration[];
     /** Optional. GoogleMaps tool type. Tool to support Google Maps in Model. */
     googleMaps?: GoogleMaps;
     /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
     googleSearch?: GoogleSearch;
+    /** Optional. Specialized retrieval tool that is powered by Google Search. */
+    googleSearchRetrieval?: GoogleSearchRetrieval;
     /** Optional. Tool to support URL context retrieval. */
     urlContext?: UrlContext;
 }
@@ -9468,10 +9394,10 @@ export declare interface ToolCodeExecution {
 
  This config is shared for all tools provided in the request. */
 export declare interface ToolConfig {
-    /** Optional. Function calling config. */
-    functionCallingConfig?: FunctionCallingConfig;
     /** Optional. Retrieval config. */
     retrievalConfig?: RetrievalConfig;
+    /** Optional. Function calling config. */
+    functionCallingConfig?: FunctionCallingConfig;
 }
 
 export declare type ToolListUnion = ToolUnion[];
@@ -9761,7 +9687,7 @@ declare interface Turn {
     /**
      * The content of the turn.
      */
-    content?: string | Array<TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchResultContent>;
+    content?: string | Array<Content_2>;
     /**
      * The originator of this turn. Must be user for input or model for
      * model output.
@@ -9858,11 +9784,13 @@ declare namespace types {
         Language,
         FunctionResponseScheduling,
         Type,
-        Mode,
         ApiSpec,
         AuthType,
         HttpElementLocation,
         PhishBlockThreshold,
+        Behavior,
+        DynamicRetrievalConfigMode,
+        FunctionCallingConfigMode,
         ThinkingLevel,
         HarmCategory,
         HarmBlockMethod,
@@ -9881,10 +9809,7 @@ declare namespace types {
         TuningTask,
         PartMediaResolutionLevel,
         FeatureSelectionPreference,
-        Behavior,
-        DynamicRetrievalConfigMode,
         Environment,
-        FunctionCallingConfigMode,
         SafetyFilterLevel,
         PersonGeneration,
         ImagePromptLanguage,
@@ -9927,9 +9852,6 @@ declare namespace types {
         HttpOptions,
         Schema,
         ModelSelectionConfig,
-        FunctionDeclaration,
-        DynamicRetrievalConfig,
-        GoogleSearchRetrieval,
         ComputerUse,
         FileSearch,
         ApiAuthApiKeyConfig,
@@ -9956,14 +9878,17 @@ declare namespace types {
         Retrieval,
         ToolCodeExecution,
         EnterpriseWebSearch,
+        FunctionDeclaration,
         GoogleMaps,
         Interval,
         GoogleSearch,
+        DynamicRetrievalConfig,
+        GoogleSearchRetrieval,
         UrlContext,
         Tool,
-        FunctionCallingConfig,
         LatLng,
         RetrievalConfig,
+        FunctionCallingConfig,
         ToolConfig,
         ReplicatedVoiceConfig,
         PrebuiltVoiceConfig,
@@ -10585,9 +10510,6 @@ declare interface URLContextCallArguments {
  * URL context content.
  */
 declare interface URLContextCallContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'url_context_call';
     /**
      * A unique ID for this specific tool call.
@@ -10623,9 +10545,6 @@ declare interface URLContextResult {
  * URL context result content.
  */
 declare interface URLContextResultContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'url_context_result';
     /**
      * ID to match the ID from the url context call block.
@@ -10712,7 +10631,7 @@ declare interface Usage {
     /**
      * Number of tokens of thoughts for thinking models.
      */
-    total_reasoning_tokens?: number;
+    total_thought_tokens?: number;
     /**
      * Total token count for the interaction request (prompt + responses + other
      * internal tokens).
@@ -10917,9 +10836,6 @@ export declare enum VideoCompressionQuality {
  * A video content block.
  */
 declare interface VideoContent {
-    /**
-     * Used as the OpenAPI type discriminator for the content oneof.
-     */
     type: 'video';
     data?: string;
     /**
@@ -10929,7 +10845,7 @@ declare interface VideoContent {
     /**
      * The resolution of the media.
      */
-    resolution?: 'low' | 'medium' | 'high';
+    resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
     uri?: string;
 }