@google/genai 1.41.0 → 1.43.0

package/dist/genai.d.ts

@@ -411,18 +411,13 @@ declare interface AudioContent {
     /**
      * The mime type of the audio.
      */
-    mime_type?: AudioMimeType;
+    mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac';
     /**
      * The URI of the audio.
      */
     uri?: string;
 }
 
-/**
- * The mime type of the audio.
- */
-declare type AudioMimeType = 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | (string & {});
-
 /** The audio transcription configuration in Setup. */
 export declare interface AudioTranscriptionConfig {
 }
@@ -1336,10 +1331,12 @@ export declare interface Candidate {
      If empty, the model has not stopped generating the tokens.
      */
     finishReason?: FinishReason;
+    /** Output only. Metadata returned when grounding is enabled. It
+     contains the sources used to ground the generated content.
+     */
+    groundingMetadata?: GroundingMetadata;
     /** Output only. Average log probability score of the candidate. */
     avgLogprobs?: number;
-    /** Output only. Metadata specifies sources used to ground generated content. */
-    groundingMetadata?: GroundingMetadata;
     /** Output only. Index of the candidate. */
     index?: number;
     /** Output only. Log-likelihood scores for the response tokens and top tokens */
@@ -1603,15 +1600,15 @@ declare interface CodeExecutionCallArguments {
  * Code execution content.
  */
 declare interface CodeExecutionCallContent {
-    type: 'code_execution_call';
     /**
      * A unique ID for this specific tool call.
      */
-    id?: string;
+    id: string;
     /**
      * The arguments to pass to the code execution.
      */
-    arguments?: CodeExecutionCallArguments;
+    arguments: CodeExecutionCallArguments;
+    type: 'code_execution_call';
 }
 
 /** Result of executing the [ExecutableCode]. Only generated when using the [CodeExecution] tool, and always follows a `part` containing the [ExecutableCode]. */
@@ -1626,19 +1623,19 @@ export declare interface CodeExecutionResult {
  * Code execution result content.
  */
 declare interface CodeExecutionResultContent {
-    type: 'code_execution_result';
     /**
      * ID to match the ID from the code execution call block.
      */
-    call_id?: string;
+    call_id: string;
     /**
-     * Whether the code execution resulted in an error.
+     * The output of the code execution.
      */
-    is_error?: boolean;
+    result: string;
+    type: 'code_execution_result';
     /**
-     * The output of the code execution.
+     * Whether the code execution resulted in an error.
      */
-    result?: string;
+    is_error?: boolean;
     /**
      * A signature hash for backend validation.
      */
@@ -1730,31 +1727,28 @@ export declare interface Content {
 declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | 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.FileSearchCallDelta | ContentDelta.FileSearchResultDelta;
+    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.FileSearchCallDelta | ContentDelta.FileSearchResultDelta;
+    event_type: 'content.delta';
+    index: number;
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'content.delta';
-    index?: number;
 }
 
 declare namespace ContentDelta {
     interface TextDelta {
+        text: string;
         type: 'text';
         /**
          * Citation information for model-generated content.
          */
         annotations?: Array<InteractionsAPI.Annotation>;
-        text?: string;
     }
     interface ImageDelta {
         type: 'image';
         data?: string;
-        /**
-         * The mime type of the image.
-         */
-        mime_type?: InteractionsAPI.ImageMimeType;
+        mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
         /**
          * The resolution of the media.
          */
@@ -1764,28 +1758,19 @@ declare namespace ContentDelta {
     interface AudioDelta {
         type: 'audio';
         data?: string;
-        /**
-         * The mime type of the audio.
-         */
-        mime_type?: InteractionsAPI.AudioMimeType;
+        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac';
         uri?: string;
     }
     interface DocumentDelta {
         type: 'document';
         data?: string;
-        /**
-         * The mime type of the document.
-         */
-        mime_type?: InteractionsAPI.DocumentMimeType;
+        mime_type?: 'application/pdf';
         uri?: string;
     }
     interface VideoDelta {
         type: 'video';
         data?: string;
-        /**
-         * The mime type of the video.
-         */
-        mime_type?: InteractionsAPI.VideoMimeType;
+        mime_type?: 'video/mp4' | 'video/mpeg' | 'video/mpg' | 'video/mov' | 'video/avi' | 'video/x-flv' | 'video/webm' | 'video/wmv' | 'video/3gpp';
         /**
          * The resolution of the media.
          */
@@ -1807,28 +1792,28 @@ declare namespace ContentDelta {
         signature?: string;
     }
     interface FunctionCallDelta {
-        type: 'function_call';
         /**
          * A unique ID for this specific tool call.
          */
-        id?: string;
-        arguments?: {
+        id: string;
+        arguments: {
             [key: string]: unknown;
         };
-        name?: string;
+        name: string;
+        type: 'function_call';
     }
     interface FunctionResultDelta {
-        type: 'function_result';
         /**
          * ID to match the ID from the function call block.
          */
-        call_id?: string;
-        is_error?: boolean;
-        name?: string;
+        call_id: string;
         /**
          * Tool call result delta.
          */
-        result?: FunctionResultDelta.Items | unknown | string;
+        result: FunctionResultDelta.Items | unknown | string;
+        type: 'function_result';
+        is_error?: boolean;
+        name?: string;
     }
     namespace FunctionResultDelta {
         interface Items {
@@ -1836,91 +1821,91 @@ declare namespace ContentDelta {
         }
     }
     interface CodeExecutionCallDelta {
-        type: 'code_execution_call';
         /**
          * A unique ID for this specific tool call.
          */
-        id?: string;
+        id: string;
         /**
          * The arguments to pass to the code execution.
          */
-        arguments?: InteractionsAPI.CodeExecutionCallArguments;
+        arguments: InteractionsAPI.CodeExecutionCallArguments;
+        type: 'code_execution_call';
     }
     interface CodeExecutionResultDelta {
-        type: 'code_execution_result';
         /**
          * ID to match the ID from the function call block.
          */
-        call_id?: string;
+        call_id: string;
+        result: string;
+        type: 'code_execution_result';
         is_error?: boolean;
-        result?: string;
         signature?: string;
     }
     interface URLContextCallDelta {
-        type: 'url_context_call';
         /**
          * A unique ID for this specific tool call.
          */
-        id?: string;
+        id: string;
         /**
          * The arguments to pass to the URL context.
          */
-        arguments?: InteractionsAPI.URLContextCallArguments;
+        arguments: InteractionsAPI.URLContextCallArguments;
+        type: 'url_context_call';
     }
     interface URLContextResultDelta {
-        type: 'url_context_result';
         /**
          * ID to match the ID from the function call block.
          */
-        call_id?: string;
+        call_id: string;
+        result: Array<InteractionsAPI.URLContextResult>;
+        type: 'url_context_result';
         is_error?: boolean;
-        result?: Array<InteractionsAPI.URLContextResult>;
         signature?: string;
     }
     interface GoogleSearchCallDelta {
-        type: 'google_search_call';
         /**
          * A unique ID for this specific tool call.
          */
-        id?: string;
+        id: string;
         /**
          * The arguments to pass to Google Search.
          */
-        arguments?: InteractionsAPI.GoogleSearchCallArguments;
+        arguments: InteractionsAPI.GoogleSearchCallArguments;
+        type: 'google_search_call';
     }
     interface GoogleSearchResultDelta {
-        type: 'google_search_result';
         /**
          * ID to match the ID from the function call block.
          */
-        call_id?: string;
+        call_id: string;
+        result: Array<InteractionsAPI.GoogleSearchResult>;
+        type: 'google_search_result';
         is_error?: boolean;
-        result?: Array<InteractionsAPI.GoogleSearchResult>;
         signature?: string;
     }
     interface MCPServerToolCallDelta {
-        type: 'mcp_server_tool_call';
         /**
          * A unique ID for this specific tool call.
          */
-        id?: string;
-        arguments?: {
+        id: string;
+        arguments: {
             [key: string]: unknown;
         };
-        name?: string;
-        server_name?: string;
+        name: string;
+        server_name: string;
+        type: 'mcp_server_tool_call';
     }
     interface MCPServerToolResultDelta {
-        type: 'mcp_server_tool_result';
         /**
          * ID to match the ID from the function call block.
          */
-        call_id?: string;
-        name?: string;
+        call_id: string;
         /**
          * Tool call result delta.
          */
-        result?: MCPServerToolResultDelta.Items | unknown | string;
+        result: MCPServerToolResultDelta.Items | unknown | string;
+        type: 'mcp_server_tool_result';
+        name?: string;
         server_name?: string;
     }
     namespace MCPServerToolResultDelta {
@@ -1929,11 +1914,11 @@ declare namespace ContentDelta {
         }
     }
     interface FileSearchCallDelta {
-        type: 'file_search_call';
         /**
          * A unique ID for this specific tool call.
          */
-        id?: string;
+        id: string;
+        type: 'file_search_call';
     }
     interface FileSearchResultDelta {
         type: 'file_search_result';
@@ -2004,22 +1989,22 @@ declare interface ContentStart {
     /**
      * The content of the response.
      */
-    content?: Content_2;
+    content: Content_2;
+    event_type: 'content.start';
+    index: number;
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'content.start';
-    index?: number;
 }
 
 declare interface ContentStop {
+    event_type: 'content.stop';
+    index: number;
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'content.stop';
-    index?: number;
 }
 
 export declare type ContentUnion = Content | PartUnion[] | PartUnion;
@@ -2582,11 +2567,11 @@ export declare interface DatasetStats {
  * Configuration for the Deep Research agent.
  */
 declare interface DeepResearchAgentConfig {
+    type: 'deep-research';
     /**
      * Whether to include thought summaries in the response.
      */
     thinking_summaries?: 'auto' | 'none';
-    type?: 'deep-research';
 }
 
 /** Optional parameters for models.get method. */
@@ -2825,18 +2810,13 @@ declare interface DocumentContent {
     /**
      * The mime type of the document.
      */
-    mime_type?: DocumentMimeType;
+    mime_type?: 'application/pdf';
     /**
      * The URI of the document.
      */
     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);
@@ -2922,7 +2902,7 @@ export declare interface DownloadFileParameters {
  * Configuration for dynamic agents.
  */
 declare interface DynamicAgentConfig {
-    type?: 'dynamic';
+    type: 'dynamic';
     [k: string]: unknown;
 }
 
@@ -3098,6 +3078,25 @@ export declare interface EmbedContentParameters {
     config?: EmbedContentConfig;
 }
 
+/** Parameters for the _embed_content method. */
+export declare interface EmbedContentParametersPrivate {
+    /** ID of the model to use. For a list of models, see `Google models
+     <https://cloud.google.com/vertex-ai/generative-ai/docs/learn/models>`_. */
+    model: string;
+    /** The content to embed. Only the `parts.text` fields will be counted.
+     */
+    contents?: ContentListUnion;
+    /** The single content to embed. Only the `parts.text` fields will be counted.
+     */
+    content?: ContentUnion;
+    /** The Vertex embedding API to use.
+     */
+    embeddingApiType?: EmbeddingApiType;
+    /** Configuration that contains optional parameters.
+     */
+    config?: EmbedContentConfig;
+}
+
 /** Response for the embed_content method. */
 export declare class EmbedContentResponse {
     /** Used to retain the full HTTP response. */
@@ -3111,6 +3110,18 @@ export declare class EmbedContentResponse {
     metadata?: EmbedContentMetadata;
 }
 
+/** Enum representing the Vertex embedding API to use. */
+export declare enum EmbeddingApiType {
+    /**
+     * predict API endpoint (default)
+     */
+    PREDICT = "PREDICT",
+    /**
+     * embedContent API Endpoint
+     */
+    EMBED_CONTENT = "EMBED_CONTENT"
+}
+
 export declare interface EmbeddingsBatchJobSource {
     /** The Gemini Developer API's file resource name of the input data
      (e.g. "files/12345").
@@ -3180,6 +3191,7 @@ export declare enum Environment {
 }
 
 declare interface ErrorEvent_2 {
+    event_type: 'error';
     /**
      * Error message from an interaction.
      */
@@ -3188,7 +3200,6 @@ declare interface ErrorEvent_2 {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'error';
 }
 
 declare namespace ErrorEvent_2 {
@@ -3480,17 +3491,21 @@ export declare interface FileSearch {
  * File Search content.
  */
 declare interface FileSearchCallContent {
-    type: 'file_search_call';
     /**
      * A unique ID for this specific tool call.
      */
-    id?: string;
+    id: string;
+    type: 'file_search_call';
 }
 
 /**
  * File Search result content.
  */
 declare interface FileSearchResultContent {
+    /**
+     * ID to match the ID from the file search call block.
+     */
+    call_id: string;
     type: 'file_search_result';
     /**
      * The results of the File Search.
@@ -4687,7 +4702,7 @@ declare interface GenerationConfig_2 {
     /**
      * The tool choice for the interaction.
      */
-    tool_choice?: ToolChoice;
+    tool_choice?: ToolChoiceType | ToolChoiceConfig;
     /**
      * The maximum cumulative probability of tokens to consider when sampling.
      */
@@ -5025,8 +5040,10 @@ export declare interface GoogleRpcStatus {
     message?: string;
 }
 
-/** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
+/** Tool to support web search. */
 export declare interface GoogleSearch {
+    /** Different types of search that can be enabled on the GoogleSearch tool. */
+    searchTypes?: SearchTypes;
     /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. This field is not supported in Gemini API. */
     excludeDomains?: string[];
     /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
@@ -5049,15 +5066,19 @@ declare interface GoogleSearchCallArguments {
  * Google Search content.
  */
 declare interface GoogleSearchCallContent {
-    type: 'google_search_call';
     /**
      * A unique ID for this specific tool call.
      */
-    id?: string;
+    id: string;
     /**
      * The arguments to pass to Google Search.
      */
-    arguments?: GoogleSearchCallArguments;
+    arguments: GoogleSearchCallArguments;
+    type: 'google_search_call';
+    /**
+     * The type of search grounding enabled.
+     */
+    search_type?: 'web_search' | 'image_search';
 }
 
 /**
@@ -5082,19 +5103,19 @@ declare interface GoogleSearchResult {
  * Google Search result content.
  */
 declare interface GoogleSearchResultContent {
-    type: 'google_search_result';
     /**
      * ID to match the ID from the google search call block.
      */
-    call_id?: string;
+    call_id: string;
     /**
-     * Whether the Google Search resulted in an error.
+     * The results of the Google Search.
      */
-    is_error?: boolean;
+    result: Array<GoogleSearchResult>;
+    type: 'google_search_result';
     /**
-     * The results of the Google Search.
+     * Whether the Google Search resulted in an error.
      */
-    result?: Array<GoogleSearchResult>;
+    is_error?: boolean;
     /**
      * The signature of the Google Search result.
      */
@@ -5117,8 +5138,16 @@ export declare interface GoogleTypeDate {
     year?: number;
 }
 
-/** Grounding chunk. */
+/** A piece of evidence that supports a claim made by the model.
+
+ This is used to show a citation for a claim made by the model. When grounding
+ is enabled, the model returns a `GroundingChunk` that contains a reference to
+ the source of the information. */
 export declare interface GroundingChunk {
+    /** A grounding chunk from an image search result. See the `Image`
+     message for details.
+     */
+    image?: GroundingChunkImage;
     /** Grounding chunk from Google Maps. This field is not supported in Gemini API. */
     maps?: GroundingChunkMaps;
     /** Grounding chunk from context retrieved by the retrieval tools. This field is not supported in Gemini API. */
@@ -5127,6 +5156,22 @@ export declare interface GroundingChunk {
     web?: GroundingChunkWeb;
 }
 
+/** A piece of evidence that comes from an image search result.
+
+ It contains the URI of the image search result and the URI of the image.
+ This is used to provide the user with a link to the source of the
+ information. */
+export declare interface GroundingChunkImage {
+    /** The URI of the image search result page. */
+    sourceUri?: string;
+    /** The URI of the image. */
+    imageUri?: string;
+    /** The title of the image search result page. */
+    title?: string;
+    /** The domain of the image search result page. */
+    domain?: string;
+}
+
 /** Chunk from Google Maps. This data type is not supported in Gemini API. */
 export declare interface GroundingChunkMaps {
     /** Sources used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as uris to flag content. */
@@ -5201,12 +5246,19 @@ export declare interface GroundingChunkWeb {
     uri?: string;
 }
 
-/** Metadata returned to client when grounding is enabled. */
 export declare interface GroundingMetadata {
+    /** Optional. The image search queries that were used to generate the
+     content. This field is populated only when the grounding source is Google
+     Search with the Image Search search_type enabled.
+     */
+    imageSearchQueries?: string[];
+    /** A list of supporting references retrieved from the grounding
+     source. This field is populated when the grounding source is Google
+     Search, Vertex AI Search, or Google Maps.
+     */
+    groundingChunks?: GroundingChunk[];
     /** Optional. Output only. Resource name of the Google Maps widget context token to be used with the PlacesContextElement widget to render contextual data. This is populated only for Google Maps grounding. This field is not supported in Gemini API. */
     googleMapsWidgetContextToken?: string;
-    /** List of supporting references retrieved from specified grounding source. */
-    groundingChunks?: GroundingChunk[];
     /** Optional. List of grounding support. */
     groundingSupports?: GroundingSupport[];
     /** Optional. Output only. Retrieval metadata. */
@@ -5530,6 +5582,12 @@ export declare interface ImageConfig {
     /** Controls the generation of people. Supported values are:
      ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE. */
     personGeneration?: string;
+    /** Controls whether prominent people (celebrities)
+     generation is allowed. If used with personGeneration, personGeneration
+     enum would take precedence. For instance, if ALLOW_NONE is set, all person
+     generation would be blocked. If this field is unspecified, the default
+     behavior is to allow prominent people. */
+    prominentPeople?: ProminentPeople;
     /** MIME type of the generated image. This field is not
      supported in Gemini API. */
     outputMimeType?: string;
@@ -5542,8 +5600,8 @@ export declare interface ImageConfig {
  * The configuration for image interaction.
  */
 declare interface ImageConfig_2 {
-    aspect_ratio?: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9';
-    image_size?: '1K' | '2K' | '4K';
+    aspect_ratio?: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9' | '1:8' | '8:1' | '1:4' | '4:1';
+    image_size?: '1K' | '2K' | '4K' | '512';
 }
 
 /**
@@ -5558,7 +5616,7 @@ declare interface ImageContent {
     /**
      * The mime type of the image.
      */
-    mime_type?: ImageMimeType;
+    mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
     /**
      * The resolution of the media.
      */
@@ -5569,11 +5627,6 @@ declare interface ImageContent {
     uri?: string;
 }
 
-/**
- * The mime type of the image.
- */
-declare type ImageMimeType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | (string & {});
-
 /** Enum that specifies the language of the text in the prompt. */
 export declare enum ImagePromptLanguage {
     /**
@@ -5610,6 +5663,10 @@ export declare enum ImagePromptLanguage {
     es = "es"
 }
 
+/** Image search for grounding and related configurations. */
+export declare interface ImageSearch {
+}
+
 /** Optional parameters for importing a file. */
 export declare interface ImportFileConfig {
     /** Used to override HTTP request options. */
@@ -5713,19 +5770,32 @@ declare interface Interaction {
      * Output only. A unique identifier for the interaction completion.
      */
     id: string;
+    /**
+     * Output only. The time at which the response was created in ISO 8601 format
+     * (YYYY-MM-DDThh:mm:ssZ).
+     */
+    created: string;
     /**
      * Output only. The status of the interaction.
      */
     status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
+    /**
+     * Output only. The time at which the response was last updated in ISO 8601 format
+     * (YYYY-MM-DDThh:mm:ssZ).
+     */
+    updated: string;
     /**
      * The name of the `Agent` used for generating the interaction.
      */
     agent?: (string & {}) | 'deep-research-pro-preview-12-2025';
     /**
-     * Output only. The time at which the response was created in ISO 8601 format
-     * (YYYY-MM-DDThh:mm:ssZ).
+     * Configuration for the agent.
+     */
+    agent_config?: DynamicAgentConfig | DeepResearchAgentConfig;
+    /**
+     * The inputs for the interaction.
      */
-    created?: string;
+    input?: string | Array<Content_2> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
     /**
      * The name of the `Model` used for generating the interaction.
      */
@@ -5738,15 +5808,31 @@ declare interface Interaction {
      * The ID of the previous interaction, if any.
      */
     previous_interaction_id?: string;
+    /**
+     * Enforces that the generated response is a JSON object that complies with
+     * the JSON schema specified in this field.
+     */
+    response_format?: unknown;
+    /**
+     * The mime type of the response. This is required if response_format is set.
+     */
+    response_mime_type?: string;
+    /**
+     * The requested modalities of the response (TEXT, IMAGE, AUDIO).
+     */
+    response_modalities?: Array<'text' | 'image' | 'audio'>;
     /**
      * Output only. The role of the interaction.
      */
     role?: string;
     /**
-     * Output only. The time at which the response was last updated in ISO 8601 format
-     * (YYYY-MM-DDThh:mm:ssZ).
+     * System instruction for the interaction.
+     */
+    system_instruction?: string;
+    /**
+     * A list of tool declarations the model may call during interaction.
      */
-    updated?: string;
+    tools?: Array<Tool_2>;
     /**
      * Output only. Statistics on the interaction request's token usage.
      */
@@ -5761,15 +5847,16 @@ declare interface InteractionCancelParams {
 }
 
 declare interface InteractionCompleteEvent {
+    event_type: 'interaction.complete';
     /**
-     * The event_id token to be used to resume the interaction stream, from this event.
+     * The completed interaction with empty outputs to reduce the payload size.
+     * Use the preceding ContentDelta events for the actual output.
      */
-    event_id?: string;
-    event_type?: 'interaction.complete';
+    interaction: Interaction;
     /**
-     * The Interaction resource.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
-    interaction?: Interaction;
+    event_id?: string;
 }
 
 declare type InteractionCreateParams = CreateModelInteractionParamsNonStreaming | CreateModelInteractionParamsStreaming | CreateAgentInteractionParamsNonStreaming | CreateAgentInteractionParamsStreaming;
@@ -5827,7 +5914,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 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 FileSearchCallContent as FileSearchCallContent, 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 ImageConfig_2 as ImageConfig, type ImageContent as ImageContent, type ImageMimeType as ImageMimeType, type Interaction as Interaction, type InteractionCompleteEvent as InteractionCompleteEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStartEvent as InteractionStartEvent, 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 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 DynamicAgentConfig as DynamicAgentConfig, type ErrorEvent_2 as ErrorEvent, type FileSearchCallContent as FileSearchCallContent, 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 ImageConfig_2 as ImageConfig, type ImageContent as ImageContent, type Interaction as Interaction, type InteractionCompleteEvent as InteractionCompleteEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStartEvent as InteractionStartEvent, 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 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 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 {
@@ -5837,7 +5924,6 @@ declare namespace InteractionsAPI {
         AllowedTools,
         Annotation,
         AudioContent,
-        AudioMimeType,
         CodeExecutionCallArguments,
         CodeExecutionCallContent,
         CodeExecutionResultContent,
@@ -5847,7 +5933,6 @@ declare namespace InteractionsAPI {
         ContentStop,
         DeepResearchAgentConfig,
         DocumentContent,
-        DocumentMimeType,
         DynamicAgentConfig,
         ErrorEvent_2 as ErrorEvent,
         FileSearchCallContent,
@@ -5862,7 +5947,6 @@ declare namespace InteractionsAPI {
         GoogleSearchResultContent,
         ImageConfig_2 as ImageConfig,
         ImageContent,
-        ImageMimeType,
         Interaction,
         InteractionCompleteEvent,
         InteractionSSEEvent,
@@ -5876,7 +5960,6 @@ declare namespace InteractionsAPI {
         ThinkingLevel_2 as ThinkingLevel,
         ThoughtContent,
         Tool_2 as Tool,
-        ToolChoice,
         ToolChoiceConfig,
         ToolChoiceType,
         Turn,
@@ -5886,7 +5969,6 @@ declare namespace InteractionsAPI {
         URLContextResultContent,
         Usage,
         VideoContent,
-        VideoMimeType,
         InteractionDeleteResponse,
         InteractionCreateParams,
         BaseCreateModelInteractionParams,
@@ -5907,25 +5989,25 @@ declare namespace InteractionsAPI {
 declare type InteractionSSEEvent = InteractionStartEvent | InteractionCompleteEvent | InteractionStatusUpdate | ContentStart | ContentDelta | ContentStop | ErrorEvent_2;
 
 declare interface InteractionStartEvent {
+    event_type: 'interaction.start';
     /**
-     * The event_id token to be used to resume the interaction stream, from this event.
+     * The Interaction resource.
      */
-    event_id?: string;
-    event_type?: 'interaction.start';
+    interaction: Interaction;
     /**
-     * The Interaction resource.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
-    interaction?: Interaction;
+    event_id?: string;
 }
 
 declare interface InteractionStatusUpdate {
+    event_type: 'interaction.status_update';
+    interaction_id: string;
+    status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'interaction.status_update';
-    interaction_id?: string;
-    status?: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
 }
 
 /** Parameters for the private _Register method. */
@@ -7095,6 +7177,14 @@ export declare enum MaskReferenceMode {
     MASK_MODE_SEMANTIC = "MASK_MODE_SEMANTIC"
 }
 
+/** A MCPServer is a server that can be called by the model to perform actions. It is a server that implements the MCP protocol. Next ID: 5. This data type is not supported in Vertex AI. */
+export declare interface McpServer {
+    /** The name of the MCPServer. */
+    name?: string;
+    /** A transport that can stream HTTP requests and responses. */
+    streamableHttpTransport?: StreamableHttpTransport;
+}
+
 /**
  * MCPServer tool call content.
  */
@@ -7303,7 +7393,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-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | (string & {});
+declare type Model_2 = '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-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | (string & {});
 
 /** Configuration for Model Armor integrations of prompt and responses. This data type is not supported in Gemini API. */
 export declare interface ModelArmorConfig {
@@ -7316,6 +7406,28 @@ export declare interface ModelArmorConfig {
 export declare class Models extends BaseModule {
     private readonly apiClient;
     constructor(apiClient: ApiClient);
+    /**
+     * Calculates embeddings for the given contents.
+     *
+     * @param params - The parameters for embedding contents.
+     * @return The response from the API.
+     *
+     * @example
+     * ```ts
+     * const response = await ai.models.embedContent({
+     *  model: 'text-embedding-004',
+     *  contents: [
+     *    'What is your name?',
+     *    'What is your favorite color?',
+     *  ],
+     *  config: {
+     *    outputDimensionality: 64,
+     *  },
+     * });
+     * console.log(response);
+     * ```
+     */
+    embedContent: (params: types.EmbedContentParameters) => Promise<types.EmbedContentResponse>;
     /**
      * Makes an API request to generate content with a given model.
      *
@@ -7526,7 +7638,7 @@ export declare class Models extends BaseModule {
      * console.log(response);
      * ```
      */
-    embedContent(params: types.EmbedContentParameters): Promise<types.EmbedContentResponse>;
+    private embedContentInternal;
     /**
      * Private method for generating images.
      */
@@ -8202,6 +8314,22 @@ export declare interface ProductImage {
     productImage?: Image_2;
 }
 
+/** Enum for controlling whether the model can generate images of prominent people (celebrities). */
+export declare enum ProminentPeople {
+    /**
+     * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
+     */
+    PROMINENT_PEOPLE_UNSPECIFIED = "PROMINENT_PEOPLE_UNSPECIFIED",
+    /**
+     * Allows the model to generate images of prominent people.
+     */
+    ALLOW_PROMINENT_PEOPLE = "ALLOW_PROMINENT_PEOPLE",
+    /**
+     * Prevents the model from generating images of prominent people.
+     */
+    BLOCK_PROMINENT_PEOPLE = "BLOCK_PROMINENT_PEOPLE"
+}
+
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -8754,6 +8882,15 @@ export declare interface SearchEntryPoint {
     sdkBlob?: string;
 }
 
+/** Tool to support computer use. */
+export declare interface SearchTypes {
+    /** Setting this field enables web search. Only text results are
+     returned. */
+    webSearch?: WebSearch;
+    /** Setting this field enables image search. Image bytes are returned. */
+    imageSearch?: ImageSearch;
+}
+
 /** Segment of the content. */
 export declare interface Segment {
     /** Output only. End index in the given Part, measured in bytes. Offset from the start of the Part, exclusive, starting at zero. */
@@ -9116,6 +9253,20 @@ declare class Stream<Item> implements AsyncIterable<Item> {
     toReadableStream(): _ReadableStream_2;
 }
 
+/** A transport that can stream HTTP requests and responses. Next ID: 6. This data type is not supported in Vertex AI. */
+export declare interface StreamableHttpTransport {
+    /** Optional: Fields for authentication headers, timeouts, etc., if needed. */
+    headers?: Record<string, string>;
+    /** Timeout for SSE read operations. */
+    sseReadTimeout?: string;
+    /** Whether to close the client session when the transport closes. */
+    terminateOnClose?: boolean;
+    /** HTTP timeout for regular operations. */
+    timeout?: string;
+    /** The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp". */
+    url?: string;
+}
+
 /** User provided string values assigned to a single metadata key. This data type is not supported in Vertex AI. */
 export declare interface StringList {
     /** The string values of the metadata to store. */
@@ -9301,15 +9452,15 @@ export declare interface TestTableItem {
  * A text content block.
  */
 declare interface TextContent {
+    /**
+     * The text content.
+     */
+    text: string;
     type: 'text';
     /**
      * Citation information for model-generated content.
      */
     annotations?: Array<Annotation>;
-    /**
-     * The text content.
-     */
-    text?: string;
 }
 
 /** The thinking features configuration. */
@@ -9475,6 +9626,8 @@ export declare interface Tool {
     computerUse?: ComputerUse;
     /** Optional. Tool to retrieve knowledge from the File Search Stores. */
     fileSearch?: FileSearch;
+    /** Enables the model to execute Google Search as part of generation. */
+    googleSearch?: GoogleSearch;
     /** Optional. CodeExecution tool type. Enables the model to execute code as part of generation. */
     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. */
@@ -9483,12 +9636,12 @@ export declare interface Tool {
     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;
+    /** Optional. MCP Servers to connect to. This field is not supported in Vertex AI. */
+    mcpServers?: McpServer[];
 }
 
 /**
@@ -9502,6 +9655,10 @@ declare namespace Tool_2 {
      */
     interface GoogleSearch {
         type: 'google_search';
+        /**
+         * The types of search grounding to enable.
+         */
+        search_types?: Array<'web_search' | 'image_search'>;
     }
     /**
      * A tool that can be used by the model to execute code.
@@ -9575,13 +9732,11 @@ declare namespace Tool_2 {
 }
 
 /**
- * The configuration for tool choice.
+ * The tool choice configuration containing allowed tools.
  */
-declare type ToolChoice = ToolChoiceType | ToolChoiceConfig;
-
 declare interface ToolChoiceConfig {
     /**
-     * The configuration for allowed tools.
+     * The allowed tools.
      */
     allowed_tools?: AllowedTools;
 }
@@ -9992,10 +10147,10 @@ declare namespace types {
         Language,
         FunctionResponseScheduling,
         Type,
+        PhishBlockThreshold,
         ApiSpec,
         AuthType,
         HttpElementLocation,
-        PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
         FunctionCallingConfigMode,
@@ -10019,6 +10174,8 @@ declare namespace types {
         ResourceScope,
         FeatureSelectionPreference,
         Environment,
+        ProminentPeople,
+        EmbeddingApiType,
         SafetyFilterLevel,
         PersonGeneration,
         ImagePromptLanguage,
@@ -10065,6 +10222,11 @@ declare namespace types {
         ModelSelectionConfig,
         ComputerUse,
         FileSearch,
+        WebSearch,
+        ImageSearch,
+        SearchTypes,
+        Interval,
+        GoogleSearch,
         ApiAuthApiKeyConfig,
         ApiAuth,
         ApiKeyConfig,
@@ -10091,11 +10253,11 @@ declare namespace types {
         EnterpriseWebSearch,
         FunctionDeclaration,
         GoogleMaps,
-        Interval,
-        GoogleSearch,
         DynamicRetrievalConfig,
         GoogleSearchRetrieval,
         UrlContext,
+        StreamableHttpTransport,
+        McpServer,
         Tool,
         LatLng,
         RetrievalConfig,
@@ -10122,6 +10284,7 @@ declare namespace types {
         GoogleTypeDate,
         Citation,
         CitationMetadata,
+        GroundingChunkImage,
         GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
         GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
         GroundingChunkMapsPlaceAnswerSources,
@@ -10151,7 +10314,7 @@ declare namespace types {
         ReferenceImage,
         EditImageParameters,
         EmbedContentConfig,
-        EmbedContentParameters,
+        EmbedContentParametersPrivate,
         ContentEmbeddingStatistics,
         ContentEmbedding,
         EmbedContentMetadata,
@@ -10419,6 +10582,7 @@ declare namespace types {
         CountTokensResult,
         ComputeTokensResult,
         CreateTuningJobParameters,
+        EmbedContentParameters,
         UploadToFileSearchStoreResponse,
         UploadToFileSearchStoreOperation,
         BlobImageUnion,
@@ -10731,15 +10895,15 @@ declare interface URLContextCallArguments {
  * URL context content.
  */
 declare interface URLContextCallContent {
-    type: 'url_context_call';
     /**
      * A unique ID for this specific tool call.
      */
-    id?: string;
+    id: string;
     /**
      * The arguments to pass to the URL context.
      */
-    arguments?: URLContextCallArguments;
+    arguments: URLContextCallArguments;
+    type: 'url_context_call';
 }
 
 /** Metadata related to url context retrieval tool. */
@@ -10766,19 +10930,19 @@ declare interface URLContextResult {
  * URL context result content.
  */
 declare interface URLContextResultContent {
-    type: 'url_context_result';
     /**
      * ID to match the ID from the url context call block.
      */
-    call_id?: string;
+    call_id: string;
     /**
-     * Whether the URL context resulted in an error.
+     * The results of the URL context.
      */
-    is_error?: boolean;
+    result: Array<URLContextResult>;
+    type: 'url_context_result';
     /**
-     * The results of the URL context.
+     * Whether the URL context resulted in an error.
      */
-    result?: Array<URLContextResult>;
+    is_error?: boolean;
     /**
      * The signature of the URL context result.
      */
@@ -11065,7 +11229,7 @@ declare interface VideoContent {
     /**
      * The mime type of the video.
      */
-    mime_type?: VideoMimeType;
+    mime_type?: 'video/mp4' | 'video/mpeg' | 'video/mpg' | 'video/mov' | 'video/avi' | 'video/x-flv' | 'video/webm' | 'video/wmv' | 'video/3gpp';
     /**
      * The resolution of the media.
      */
@@ -11147,11 +11311,6 @@ export declare interface VideoMetadata {
     startOffset?: string;
 }
 
-/**
- * The mime type of the video.
- */
-declare type VideoMimeType = 'video/mp4' | 'video/mpeg' | 'video/mov' | 'video/avi' | 'video/x-flv' | 'video/mpg' | 'video/webm' | 'video/wmv' | 'video/3gpp' | (string & {});
-
 /** Voice activity signal. */
 export declare interface VoiceActivity {
     /** The type of the voice activity signal. */
@@ -11186,6 +11345,12 @@ export declare interface VoiceConfig {
     prebuiltVoiceConfig?: PrebuiltVoiceConfig;
 }
 
+/** Standard web search for grounding and related configurations.
+
+ Only text results are returned. */
+export declare interface WebSearch {
+}
+
 declare interface WebSocket_2 {
     /**
      * Connects the socket to the server.