@google/genai 1.46.0 → 1.48.0

package/dist/genai.d.ts

@@ -472,7 +472,7 @@ declare interface AudioContent {
     /**
      * The mime type of the audio.
      */
-    mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac';
+    mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
     /**
      * The URI of the audio.
      */
@@ -639,7 +639,7 @@ declare interface BaseCreateAgentInteractionParams {
     /**
      * Body param: The input for the interaction.
      */
-    input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
+    input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
     /**
      * Body param: Configuration parameters for the agent interaction.
      */
@@ -665,6 +665,10 @@ declare interface BaseCreateAgentInteractionParams {
      * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
     response_modalities?: Array<'text' | 'image' | 'audio'>;
+    /**
+     * Body param: The service tier for the interaction.
+     */
+    service_tier?: 'flex' | 'standard' | 'priority';
     /**
      * Body param: Input only. Whether to store the response and request for later retrieval.
      */
@@ -691,7 +695,7 @@ declare interface BaseCreateModelInteractionParams {
     /**
      * Body param: The input for the interaction.
      */
-    input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
+    input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
     /**
      * Body param: The name of the `Model` used for generating the interaction.
      */
@@ -721,6 +725,10 @@ declare interface BaseCreateModelInteractionParams {
      * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
     response_modalities?: Array<'text' | 'image' | 'audio'>;
+    /**
+     * Body param: The service tier for the interaction.
+     */
+    service_tier?: 'flex' | 'standard' | 'priority';
     /**
      * Body param: Input only. Whether to store the response and request for later retrieval.
      */
@@ -839,7 +847,7 @@ declare class BaseInteractions extends APIResource {
      * const interaction = await client.interactions.create({
      *   api_version: 'api_version',
      *   input: [{ text: 'text', type: 'text' }],
-     *   model: 'gemini-2.5-flash',
+     *   model: 'gemini-2.5-computer-use-preview-10-2025',
      * });
      * ```
      */
@@ -1679,11 +1687,11 @@ declare interface CodeExecutionCallArguments {
  */
 declare interface CodeExecutionCallContent {
     /**
-     * A unique ID for this specific tool call.
+     * Required. A unique ID for this specific tool call.
      */
     id: string;
     /**
-     * The arguments to pass to the code execution.
+     * Required. The arguments to pass to the code execution.
      */
     arguments: CodeExecutionCallArguments;
     type: 'code_execution_call';
@@ -1710,11 +1718,11 @@ export declare interface CodeExecutionResult {
  */
 declare interface CodeExecutionResultContent {
     /**
-     * ID to match the ID from the code execution call block.
+     * Required. ID to match the ID from the function call block.
      */
     call_id: string;
     /**
-     * The output of the code execution.
+     * Required. The output of the code execution.
      */
     result: string;
     type: 'code_execution_result';
@@ -1810,14 +1818,18 @@ export declare interface Content {
 /**
  * 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 | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
+declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
 
 declare interface ContentDelta {
-    delta: ContentDelta.Text | ContentDelta.Image | ContentDelta.Audio | ContentDelta.Document | ContentDelta.Video | ContentDelta.ThoughtSummary | ContentDelta.ThoughtSignature | ContentDelta.FunctionCall | ContentDelta.FunctionResult | ContentDelta.CodeExecutionCall | ContentDelta.CodeExecutionResult | ContentDelta.URLContextCall | ContentDelta.URLContextResult | ContentDelta.GoogleSearchCall | ContentDelta.GoogleSearchResult | ContentDelta.MCPServerToolCall | ContentDelta.MCPServerToolResult | ContentDelta.FileSearchCall | ContentDelta.FileSearchResult | ContentDelta.GoogleMapsCall | ContentDelta.GoogleMapsResult;
+    /**
+     * The delta content data for a content block.
+     */
+    delta: ContentDelta.Text | ContentDelta.Image | ContentDelta.Audio | ContentDelta.Document | ContentDelta.Video | ContentDelta.ThoughtSummary | ContentDelta.ThoughtSignature | ContentDelta.FunctionCall | ContentDelta.CodeExecutionCall | ContentDelta.URLContextCall | ContentDelta.GoogleSearchCall | ContentDelta.MCPServerToolCall | ContentDelta.FileSearchCall | ContentDelta.GoogleMapsCall | ContentDelta.FunctionResult | ContentDelta.CodeExecutionResult | ContentDelta.URLContextResult | ContentDelta.GoogleSearchResult | ContentDelta.MCPServerToolResult | ContentDelta.FileSearchResult | ContentDelta.GoogleMapsResult | ContentDelta.TextAnnotation;
     event_type: 'content.delta';
     index: number;
     /**
-     * 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;
 }
@@ -1826,15 +1838,11 @@ declare namespace ContentDelta {
     interface Text {
         text: string;
         type: 'text';
-        /**
-         * Citation information for model-generated content.
-         */
-        annotations?: Array<InteractionsAPI.Annotation>;
     }
     interface Image {
         type: 'image';
         data?: string;
-        mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
+        mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | 'image/gif' | 'image/bmp' | 'image/tiff';
         /**
          * The resolution of the media.
          */
@@ -1844,7 +1852,7 @@ declare namespace ContentDelta {
     interface Audio {
         type: 'audio';
         data?: string;
-        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac';
+        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
         uri?: string;
     }
     interface Document {
@@ -1879,7 +1887,7 @@ declare namespace ContentDelta {
     }
     interface FunctionCall {
         /**
-         * A unique ID for this specific tool call.
+         * Required. A unique ID for this specific tool call.
          */
         id: string;
         arguments: {
@@ -1892,203 +1900,205 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface FunctionResult {
+    interface CodeExecutionCall {
         /**
-         * ID to match the ID from the function call block.
+         * Required. A unique ID for this specific tool call.
          */
-        call_id: string;
+        id: string;
         /**
-         * Tool call result delta.
+         * The arguments to pass to the code execution.
          */
-        result: FunctionResult.Items | unknown | string;
-        type: 'function_result';
-        is_error?: boolean;
-        name?: string;
+        arguments: InteractionsAPI.CodeExecutionCallArguments;
+        type: 'code_execution_call';
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    namespace FunctionResult {
-        interface Items {
-            items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
-        }
-    }
-    interface CodeExecutionCall {
+    interface URLContextCall {
         /**
-         * A unique ID for this specific tool call.
+         * Required. A unique ID for this specific tool call.
          */
         id: string;
         /**
-         * The arguments to pass to the code execution.
+         * The arguments to pass to the URL context.
          */
-        arguments: InteractionsAPI.CodeExecutionCallArguments;
-        type: 'code_execution_call';
+        arguments: InteractionsAPI.URLContextCallArguments;
+        type: 'url_context_call';
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface CodeExecutionResult {
+    interface GoogleSearchCall {
         /**
-         * ID to match the ID from the function call block.
+         * Required. A unique ID for this specific tool call.
          */
-        call_id: string;
-        result: string;
-        type: 'code_execution_result';
-        is_error?: boolean;
+        id: string;
+        /**
+         * The arguments to pass to Google Search.
+         */
+        arguments: InteractionsAPI.GoogleSearchCallArguments;
+        type: 'google_search_call';
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface URLContextCall {
+    interface MCPServerToolCall {
         /**
-         * A unique ID for this specific tool call.
+         * Required. A unique ID for this specific tool call.
          */
         id: string;
-        /**
-         * The arguments to pass to the URL context.
-         */
-        arguments: InteractionsAPI.URLContextCallArguments;
-        type: 'url_context_call';
+        arguments: {
+            [key: string]: unknown;
+        };
+        name: string;
+        server_name: string;
+        type: 'mcp_server_tool_call';
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface URLContextResult {
+    interface FileSearchCall {
         /**
-         * ID to match the ID from the function call block.
+         * Required. A unique ID for this specific tool call.
          */
-        call_id: string;
-        result: Array<InteractionsAPI.URLContextResult>;
-        type: 'url_context_result';
-        is_error?: boolean;
+        id: string;
+        type: 'file_search_call';
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface GoogleSearchCall {
+    interface GoogleMapsCall {
         /**
-         * A unique ID for this specific tool call.
+         * Required. A unique ID for this specific tool call.
          */
         id: string;
+        type: 'google_maps_call';
         /**
-         * The arguments to pass to Google Search.
+         * The arguments to pass to the Google Maps tool.
          */
-        arguments: InteractionsAPI.GoogleSearchCallArguments;
-        type: 'google_search_call';
+        arguments?: InteractionsAPI.GoogleMapsCallArguments;
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface GoogleSearchResult {
+    interface FunctionResult {
         /**
-         * ID to match the ID from the function call block.
+         * Required. ID to match the ID from the function call block.
          */
         call_id: string;
-        result: Array<InteractionsAPI.GoogleSearchResult>;
-        type: 'google_search_result';
+        result: unknown | Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent> | string;
+        type: 'function_result';
         is_error?: boolean;
+        name?: string;
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface MCPServerToolCall {
+    interface CodeExecutionResult {
         /**
-         * A unique ID for this specific tool call.
+         * Required. ID to match the ID from the function call block.
          */
-        id: string;
-        arguments: {
-            [key: string]: unknown;
-        };
-        name: string;
-        server_name: string;
-        type: 'mcp_server_tool_call';
+        call_id: string;
+        result: string;
+        type: 'code_execution_result';
+        is_error?: boolean;
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface MCPServerToolResult {
+    interface URLContextResult {
         /**
-         * ID to match the ID from the function call block.
+         * Required. ID to match the ID from the function call block.
          */
         call_id: string;
-        /**
-         * Tool call result delta.
-         */
-        result: MCPServerToolResult.Items | unknown | string;
-        type: 'mcp_server_tool_result';
-        name?: string;
-        server_name?: string;
+        result: Array<InteractionsAPI.URLContextResult>;
+        type: 'url_context_result';
+        is_error?: boolean;
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    namespace MCPServerToolResult {
-        interface Items {
-            items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
-        }
-    }
-    interface FileSearchCall {
+    interface GoogleSearchResult {
         /**
-         * A unique ID for this specific tool call.
+         * Required. ID to match the ID from the function call block.
          */
-        id: string;
-        type: 'file_search_call';
+        call_id: string;
+        result: Array<InteractionsAPI.GoogleSearchResult>;
+        type: 'google_search_result';
+        is_error?: boolean;
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface FileSearchResult {
+    interface MCPServerToolResult {
         /**
-         * ID to match the ID from the function call block.
+         * Required. ID to match the ID from the function call block.
          */
         call_id: string;
-        type: 'file_search_result';
-        result?: Array<unknown>;
+        result: unknown | Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent> | string;
+        type: 'mcp_server_tool_result';
+        name?: string;
+        server_name?: string;
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
-    interface GoogleMapsCall {
-        /**
-         * A unique ID for this specific tool call.
-         */
-        id: string;
-        type: 'google_maps_call';
+    interface FileSearchResult {
         /**
-         * The arguments to pass to the Google Maps tool.
+         * Required. ID to match the ID from the function call block.
          */
-        arguments?: InteractionsAPI.GoogleMapsCallArguments;
+        call_id: string;
+        result: Array<FileSearchResult.Result>;
+        type: 'file_search_result';
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
+    namespace FileSearchResult {
+        /**
+         * The result of the File Search.
+         */
+        interface Result {
+            /**
+             * User provided metadata about the FileSearchResult.
+             */
+            custom_metadata?: Array<unknown>;
+        }
+    }
     interface GoogleMapsResult {
         /**
-         * ID to match the ID from the function call block.
+         * Required. ID to match the ID from the function call block.
          */
         call_id: string;
+        type: 'google_maps_result';
         /**
          * The results of the Google Maps.
          */
-        result: Array<InteractionsAPI.GoogleMapsResult>;
-        type: 'google_maps_result';
+        result?: Array<InteractionsAPI.GoogleMapsResult>;
         /**
          * A signature hash for backend validation.
          */
         signature?: string;
     }
+    interface TextAnnotation {
+        type: 'text_annotation';
+        /**
+         * Citation information for model-generated content.
+         */
+        annotations?: Array<InteractionsAPI.Annotation>;
+    }
 }
 
 /** The embedding generated from an input content. */
@@ -2139,7 +2149,8 @@ declare interface ContentStart {
     event_type: 'content.start';
     index: number;
     /**
-     * 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;
 }
@@ -2148,7 +2159,8 @@ declare interface ContentStop {
     event_type: 'content.stop';
     index: number;
     /**
-     * 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;
 }
@@ -2596,7 +2608,7 @@ export declare interface CreateTuningJobConfig {
     preTunedModelCheckpointId?: string;
     /** Adapter size for tuning. */
     adapterSize?: AdapterSize;
-    /** Tuning mode for SFT tuning. */
+    /** Tuning mode for tuning. */
     tuningMode?: TuningMode;
     /** Custom base model for tuning. This is only supported for OSS models in Vertex. */
     customBaseModel?: string;
@@ -2908,7 +2920,7 @@ export declare interface DistillationDataStats {
     trainingDatasetStats?: DatasetStats;
 }
 
-/** Hyperparameters for Distillation. This data type is not supported in Gemini API. */
+/** Hyperparameters for distillation. */
 export declare interface DistillationHyperParameters {
     /** Optional. Adapter size for distillation. */
     adapterSize?: AdapterSize;
@@ -2916,6 +2928,21 @@ export declare interface DistillationHyperParameters {
     epochCount?: string;
     /** Optional. Multiplier for adjusting the default learning rate. */
     learningRateMultiplier?: number;
+    /** The batch size hyperparameter for tuning.
+     This is only supported for OSS models in Vertex. */
+    batchSize?: number;
+    /** The learning rate for tuning. OSS models only. */
+    learningRate?: number;
+}
+
+/** Spec for creating a distilled dataset in Vertex Dataset. This data type is not supported in Gemini API. */
+export declare interface DistillationSamplingSpec {
+    /** Optional. The base teacher model that is being distilled. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/tuning#supported_models). */
+    baseTeacherModel?: string;
+    /** Optional. The resource name of the Tuned teacher model. Format: `projects/{project}/locations/{location}/models/{model}`. */
+    tunedTeacherModelSource?: string;
+    /** Optional. Cloud Storage path to file containing validation dataset for distillation. The dataset must be formatted as a JSONL file. */
+    validationDatasetUri?: string;
 }
 
 /** Distillation tuning spec for tuning. */
@@ -2936,20 +2963,21 @@ export declare interface DistillationSpec {
     tunedTeacherModelSource?: string;
     /** Optional. Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file. */
     validationDatasetUri?: string;
+    /** Tuning mode for tuning. */
+    tuningMode?: TuningMode;
 }
 
 /** A Document is a collection of Chunks. */
 declare interface Document_2 {
-    /** The resource name of the Document.
-     Example: fileSearchStores/file-search-store-foo/documents/documents-bar */
+    /** Immutable. Identifier. The `Document` resource name. The ID (name excluding the "fileSearchStores/&#42;/documents/" prefix) can contain up to 40 characters that are lowercase alphanumeric or dashes (-). The ID cannot start or end with a dash. If the name is empty on create, a unique name will be derived from `display_name` along with a 12 character random suffix. Example: `fileSearchStores/{file_search_store_id}/documents/my-awesome-doc-123a456b789c` */
     name?: string;
-    /** The human-readable display name for the Document. */
+    /** Optional. The human-readable display name for the `Document`. The display name must be no more than 512 characters in length, including spaces. Example: "Semantic Retriever Documentation". */
     displayName?: string;
-    /** The current state of the Document. */
+    /** Output only. Current state of the `Document`. */
     state?: DocumentState;
-    /** The size of the Document in bytes. */
+    /** Output only. The size of raw bytes ingested into the Document. */
     sizeBytes?: string;
-    /** The MIME type of the Document. */
+    /** Output only. The mime type of the Document. */
     mimeType?: string;
     /** Output only. The Timestamp of when the `Document` was created. */
     createTime?: string;
@@ -3013,11 +3041,23 @@ declare class Documents extends BaseModule {
     private listInternal;
 }
 
-/** State for the lifecycle of a Document. */
+/** Output only. Current state of the `Document`. This enum is not supported in Vertex AI. */
 export declare enum DocumentState {
+    /**
+     * The default value. This value is used if the state is omitted.
+     */
     STATE_UNSPECIFIED = "STATE_UNSPECIFIED",
+    /**
+     * Some `Chunks` of the `Document` are being processed (embedding and vector storage).
+     */
     STATE_PENDING = "STATE_PENDING",
+    /**
+     * All `Chunks` of the `Document` is processed and available for querying.
+     */
     STATE_ACTIVE = "STATE_ACTIVE",
+    /**
+     * Some `Chunks` of the `Document` failed processing.
+     */
     STATE_FAILED = "STATE_FAILED"
 }
 
@@ -3359,7 +3399,8 @@ 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;
 }
@@ -3416,7 +3457,7 @@ export declare interface EvaluateDatasetRun {
     evaluateDatasetResponse?: EvaluateDatasetResponse;
     /** Output only. The resource name of the evaluation run. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run_id}`. */
     evaluationRun?: string;
-    /** Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`. */
+    /** Output only. Deprecated: The updated architecture uses evaluation_run instead. */
     operationName?: string;
 }
 
@@ -3573,6 +3614,8 @@ declare interface FileCitation {
     source?: string;
     /**
      * Start of segment of the response that is attributed to this source.
+     *
+     * Index indicates the start of the segment, measured in bytes.
      */
     start_index?: number;
 }
@@ -3707,14 +3750,13 @@ export declare class Files extends BaseModule {
     private registerFilesInternal;
 }
 
-/** Tool to retrieve knowledge from the File Search Stores. */
+/** The FileSearch tool that retrieves knowledge from Semantic Retrieval corpora. Files are imported to Semantic Retrieval corpora using the ImportFile API. This data type is not supported in Vertex AI. */
 export declare interface FileSearch {
-    /** The names of the file_search_stores to retrieve from.
-     Example: `fileSearchStores/my-file-search-store-123` */
+    /** Required. The names of the file_search_stores to retrieve from. Example: `fileSearchStores/my-file-search-store-123` */
     fileSearchStoreNames?: string[];
-    /** The number of file search retrieval chunks to retrieve. */
+    /** Optional. The number of semantic retrieval chunks to retrieve. */
     topK?: number;
-    /** Metadata filter to apply to the file search retrieval documents. See https://google.aip.dev/160 for the syntax of the filter expression. */
+    /** Optional. Metadata filter to apply to the semantic retrieval documents and chunks. */
     metadataFilter?: string;
 }
 
@@ -3723,7 +3765,7 @@ export declare interface FileSearch {
  */
 declare interface FileSearchCallContent {
     /**
-     * A unique ID for this specific tool call.
+     * Required. A unique ID for this specific tool call.
      */
     id: string;
     type: 'file_search_call';
@@ -3738,20 +3780,32 @@ declare interface FileSearchCallContent {
  */
 declare interface FileSearchResultContent {
     /**
-     * ID to match the ID from the file search call block.
+     * Required. ID to match the ID from the function call block.
      */
     call_id: string;
-    type: 'file_search_result';
     /**
-     * The results of the File Search.
+     * Required. The results of the File Search.
      */
-    result?: Array<unknown>;
+    result: Array<FileSearchResultContent.Result>;
+    type: 'file_search_result';
     /**
      * A signature hash for backend validation.
      */
     signature?: string;
 }
 
+declare namespace FileSearchResultContent {
+    /**
+     * The result of the File Search.
+     */
+    interface Result {
+        /**
+         * User provided metadata about the FileSearchResult.
+         */
+        custom_metadata?: Array<unknown>;
+    }
+}
+
 /** A collection of Documents. */
 export declare interface FileSearchStore {
     /** The resource name of the FileSearchStore. Example: `fileSearchStores/my-file-search-store-123` */
@@ -4037,17 +4091,17 @@ export declare interface FunctionCall {
  */
 declare interface FunctionCallContent {
     /**
-     * A unique ID for this specific tool call.
+     * Required. A unique ID for this specific tool call.
      */
     id: string;
     /**
-     * The arguments to pass to the function.
+     * Required. The arguments to pass to the function.
      */
     arguments: {
         [key: string]: unknown;
     };
     /**
-     * The name of the tool to call.
+     * Required. The name of the tool to call.
      */
     name: string;
     type: 'function_call';
@@ -4193,7 +4247,7 @@ export declare enum FunctionResponseScheduling {
  */
 declare interface FunctionResultContent {
     /**
-     * ID to match the ID from the function call block.
+     * Required. ID to match the ID from the function call block.
      */
     call_id: string;
     /**
@@ -4416,6 +4470,8 @@ export declare interface GenerateContentConfig {
      service. If supplied, safety_settings must not be supplied.
      */
     modelArmorConfig?: ModelArmorConfig;
+    /** The service tier to use for the request. For example, ServiceTier.FLEX. */
+    serviceTier?: ServiceTier;
 }
 
 /** Config for models.generate_content parameters. */
@@ -4452,6 +4508,8 @@ export declare class GenerateContentResponse {
     responseId?: string;
     /** Usage metadata about the response(s). */
     usageMetadata?: GenerateContentResponseUsageMetadata;
+    /** Output only. The current model status of this model. This field is not supported in Vertex AI. */
+    modelStatus?: ModelStatus;
     /**
      * Returns the concatenation of all text parts from the first candidate in the response.
      *
@@ -4781,6 +4839,8 @@ export declare interface GenerateVideosConfig {
     mask?: VideoGenerationMask;
     /** Compression quality of the generated videos. */
     compressionQuality?: VideoCompressionQuality;
+    /** User specified labels to track billing usage. */
+    labels?: Record<string, string>;
 }
 
 /** A video generation operation. */
@@ -4797,7 +4857,6 @@ export declare class GenerateVideosOperation implements Operation<GenerateVideos
     response?: GenerateVideosResponse;
     /**
      * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
-     * @internal
      */
     _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<GenerateVideosResponse>;
     /** The full HTTP response. */
@@ -4936,7 +4995,7 @@ declare interface GenerationConfig_2 {
      */
     thinking_summaries?: 'auto' | 'none';
     /**
-     * The tool choice for the interaction.
+     * The tool choice configuration.
      */
     tool_choice?: ToolChoiceType | ToolChoiceConfig;
     /**
@@ -5281,7 +5340,7 @@ declare interface GoogleMapsCallArguments {
  */
 declare interface GoogleMapsCallContent {
     /**
-     * A unique ID for this specific tool call.
+     * Required. A unique ID for this specific tool call.
      */
     id: string;
     type: 'google_maps_call';
@@ -5356,11 +5415,11 @@ declare namespace GoogleMapsResult {
  */
 declare interface GoogleMapsResultContent {
     /**
-     * ID to match the ID from the google maps call block.
+     * Required. ID to match the ID from the function call block.
      */
     call_id: string;
     /**
-     * The results of the Google Maps.
+     * Required. The results of the Google Maps.
      */
     result: Array<GoogleMapsResult>;
     type: 'google_maps_result';
@@ -5380,9 +5439,9 @@ export declare interface GoogleRpcStatus {
     message?: string;
 }
 
-/** Tool to support web search. */
+/** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
 export declare interface GoogleSearch {
-    /** Different types of search that can be enabled on the GoogleSearch tool. */
+    /** Optional. The set of search types to enable. If not set, web search is enabled by default. */
     searchTypes?: SearchTypes;
     /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
     blockingConfidence?: PhishBlockThreshold;
@@ -5407,11 +5466,11 @@ declare interface GoogleSearchCallArguments {
  */
 declare interface GoogleSearchCallContent {
     /**
-     * A unique ID for this specific tool call.
+     * Required. A unique ID for this specific tool call.
      */
     id: string;
     /**
-     * The arguments to pass to Google Search.
+     * Required. The arguments to pass to Google Search.
      */
     arguments: GoogleSearchCallArguments;
     type: 'google_search_call';
@@ -5440,11 +5499,11 @@ declare interface GoogleSearchResult {
  */
 declare interface GoogleSearchResultContent {
     /**
-     * ID to match the ID from the google search call block.
+     * Required. ID to match the ID from the function call block.
      */
     call_id: string;
     /**
-     * The results of the Google Search.
+     * Required. The results of the Google Search.
      */
     result: Array<GoogleSearchResult>;
     type: 'google_search_result';
@@ -5480,9 +5539,7 @@ export declare interface GoogleTypeDate {
  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.
-     */
+    /** A grounding chunk from an image search result. See the `Image` message for details. */
     image?: GroundingChunkImage;
     /** A `Maps` chunk is a piece of evidence that comes from Google Maps.
 
@@ -5490,17 +5547,25 @@ export declare interface GroundingChunk {
      reviews. This is used to provide the user with rich, location-based
      information. */
     maps?: GroundingChunkMaps;
-    /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details. This field is not supported in Gemini API. */
+    /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details */
     retrievedContext?: GroundingChunkRetrievedContext;
     /** A grounding chunk from a web page, typically from Google Search. See the `Web` message for details. */
     web?: GroundingChunkWeb;
 }
 
-/** A piece of evidence that comes from an image search result.
+/** User provided metadata about the GroundingFact. This data type is not supported in Vertex AI. */
+export declare interface GroundingChunkCustomMetadata {
+    /** The key of the metadata. */
+    key?: string;
+    /** Optional. The numeric value of the metadata. The expected range for this value depends on the specific `key` used. */
+    numericValue?: number;
+    /** Optional. A list of string values for the metadata. */
+    stringListValue?: GroundingChunkStringList;
+    /** Optional. The string value of the metadata. */
+    stringValue?: string;
+}
 
- 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. */
+/** An `Image` chunk is 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;
@@ -5532,6 +5597,8 @@ export declare interface GroundingChunkMaps {
     title?: string;
     /** The URI of the place. */
     uri?: string;
+    /** Output only. Route information. */
+    route?: GroundingChunkMapsRoute;
 }
 
 /** The sources that were used to generate the place answer.
@@ -5575,11 +5642,21 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
     title?: string;
 }
 
-/** Context retrieved from a data source to ground the model's response. This is used when a retrieval tool fetches information from a user-provided corpus or a public dataset. This data type is not supported in Gemini API. */
+/** Route information from Google Maps. This data type is not supported in Gemini API. */
+export declare interface GroundingChunkMapsRoute {
+    /** The total distance of the route, in meters. */
+    distanceMeters?: number;
+    /** The total duration of the route. */
+    duration?: string;
+    /** An encoded polyline of the route. See https://developers.google.com/maps/documentation/utilities/polylinealgorithm */
+    encodedPolyline?: string;
+}
+
+/** Context retrieved from a data source to ground the model's response. This is used when a retrieval tool fetches information from a user-provided corpus or a public dataset. */
 export declare interface GroundingChunkRetrievedContext {
-    /** Output only. The full resource name of the referenced Vertex AI Search document. This is used to identify the specific document that was retrieved. The format is `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`. */
+    /** Output only. The full resource name of the referenced Vertex AI Search document. This is used to identify the specific document that was retrieved. The format is `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`. This field is not supported in Gemini API. */
     documentName?: string;
-    /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. */
+    /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. This field is not supported in Gemini API. */
     ragChunk?: RagChunk;
     /** The content of the retrieved data source. */
     text?: string;
@@ -5587,6 +5664,16 @@ export declare interface GroundingChunkRetrievedContext {
     title?: string;
     /** The URI of the retrieved data source. */
     uri?: string;
+    /** Optional. User-provided metadata about the retrieved context. This field is not supported in Vertex AI. */
+    customMetadata?: GroundingChunkCustomMetadata[];
+    /** Optional. Name of the `FileSearchStore` containing the document. Example: `fileSearchStores/123`. This field is not supported in Vertex AI. */
+    fileSearchStore?: string;
+}
+
+/** A list of string values. This data type is not supported in Vertex AI. */
+export declare interface GroundingChunkStringList {
+    /** The string values of the list. */
+    values?: string[];
 }
 
 /** A `Web` chunk is a piece of evidence that comes from a web page. It contains the URI of the web page, the title of the page, and the domain of the page. This is used to provide the user with a link to the source of the information. */
@@ -5601,10 +5688,7 @@ export declare interface GroundingChunkWeb {
 
 /** Information for various kinds of grounding. */
 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.
-     */
+    /** 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
@@ -5620,7 +5704,7 @@ export declare interface GroundingMetadata {
     searchEntryPoint?: SearchEntryPoint;
     /** Web search queries for the following-up web search. */
     webSearchQueries?: string[];
-    /** Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. This field is not supported in Gemini API. */
+    /** Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. */
     googleMapsWidgetContextToken?: string;
     /** Optional. The queries that were executed by the retrieval tools. This field is populated only when the grounding source is a retrieval tool, such as Vertex AI Search. This field is not supported in Gemini API. */
     retrievalQueries?: string[];
@@ -5650,6 +5734,8 @@ export declare interface GroundingSupport {
     groundingChunkIndices?: number[];
     /** Segment of the content this support belongs to. */
     segment?: Segment;
+    /** Indices into the `rendered_parts` field of the `GroundingMetadata` message. These indices specify which rendered parts are associated with this support message. */
+    renderedParts?: number[];
 }
 
 /** The method for blocking content. If not specified, the default behavior is to use the probability score. This enum is not supported in Gemini API. */
@@ -5943,11 +6029,7 @@ 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. */
+    /** Optional. 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. This field is not supported in Gemini API. */
     prominentPeople?: ProminentPeople;
     /** MIME type of the generated image. This field is not
      supported in Gemini API. */
@@ -5955,7 +6037,7 @@ export declare interface ImageConfig {
     /** Compression quality of the generated image (for
      ``image/jpeg`` only). This field is not supported in Gemini API. */
     outputCompressionQuality?: number;
-    /** Optional. The image output format for generated images. */
+    /** Optional. The image output format for generated images. This field is not supported in Gemini API. */
     imageOutputOptions?: ImageConfigImageOutputOptions;
 }
 
@@ -5987,7 +6069,7 @@ declare interface ImageContent {
     /**
      * The mime type of the image.
      */
-    mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
+    mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | 'image/gif' | 'image/bmp' | 'image/tiff';
     /**
      * The resolution of the media.
      */
@@ -6069,7 +6151,6 @@ export declare class ImportFileOperation implements Operation<ImportFileResponse
     response?: ImportFileResponse;
     /**
      * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
-     * @internal
      */
     _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<ImportFileResponse>;
     /** The full HTTP response. */
@@ -6098,12 +6179,12 @@ export declare class ImportFileResponse {
 
 /** Config for `inlined_embedding_responses` parameter. */
 export declare class InlinedEmbedContentResponse {
-    /** The response to the request.
-     */
+    /** Output only. The response to the request. */
     response?: SingleEmbedContentResponse;
-    /** The error encountered while processing the request.
-     */
+    /** Output only. The error encountered while processing the request. */
     error?: JobError;
+    /** Output only. The metadata associated with the request. */
+    metadata?: Record<string, unknown>;
 }
 
 /** Config for inlined request. */
@@ -6138,20 +6219,20 @@ export declare class InlinedResponse {
  */
 declare interface Interaction {
     /**
-     * Output only. A unique identifier for the interaction completion.
+     * Required. 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
+     * Required. 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.
+     * Required. 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
+     * Required. Output only. The time at which the response was last updated in ISO 8601 format
      * (YYYY-MM-DDThh:mm:ssZ).
      */
     updated: string;
@@ -6166,7 +6247,7 @@ declare interface Interaction {
     /**
      * The input for the interaction.
      */
-    input?: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
+    input?: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
     /**
      * The name of the `Model` used for generating the interaction.
      */
@@ -6196,6 +6277,10 @@ declare interface Interaction {
      * Output only. The role of the interaction.
      */
     role?: string;
+    /**
+     * The service tier for the interaction.
+     */
+    service_tier?: 'flex' | 'standard' | 'priority';
     /**
      * System instruction for the interaction.
      */
@@ -6220,12 +6305,13 @@ declare interface InteractionCancelParams {
 declare interface InteractionCompleteEvent {
     event_type: 'interaction.complete';
     /**
-     * The completed interaction with empty outputs to reduce the payload size.
+     * Required. The completed interaction with empty outputs to reduce the payload size.
      * Use the preceding ContentDelta events for the actual output.
      */
     interaction: Interaction;
     /**
-     * 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;
 }
@@ -6373,7 +6459,8 @@ declare interface InteractionStartEvent {
      */
     interaction: Interaction;
     /**
-     * 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;
 }
@@ -6383,7 +6470,8 @@ declare interface InteractionStatusUpdate {
     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.
+     * The event_id token to be used to resume the interaction stream, from
+     * this event.
      */
     event_id?: string;
 }
@@ -6625,6 +6713,7 @@ export declare interface ListFileSearchStoresParameters {
 export declare class ListFileSearchStoresResponse {
     /** Used to retain the full HTTP response. */
     sdkHttpResponse?: HttpResponse;
+    /** A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no more pages. */
     nextPageToken?: string;
     /** The returned file search stores. */
     fileSearchStores?: FileSearchStore[];
@@ -7493,6 +7582,8 @@ export declare interface LogprobsResult {
     chosenCandidates?: LogprobsResultCandidate[];
     /** A list of the top candidate tokens at each decoding step. The length of this list is equal to the total number of decoding steps. */
     topCandidates?: LogprobsResultTopCandidates[];
+    /** Sum of log probabilities for all tokens. This field is not supported in Vertex AI. */
+    logProbabilitySum?: number;
 }
 
 /** A single token and its associated log probability. */
@@ -7568,21 +7659,21 @@ export declare interface McpServer {
  */
 declare interface MCPServerToolCallContent {
     /**
-     * A unique ID for this specific tool call.
+     * Required. A unique ID for this specific tool call.
      */
     id: string;
     /**
-     * The JSON object of arguments for the function.
+     * Required. The JSON object of arguments for the function.
      */
     arguments: {
         [key: string]: unknown;
     };
     /**
-     * The name of the tool which was called.
+     * Required. The name of the tool which was called.
      */
     name: string;
     /**
-     * The name of the used MCP server.
+     * Required. The name of the used MCP server.
      */
     server_name: string;
     type: 'mcp_server_tool_call';
@@ -7597,7 +7688,7 @@ declare interface MCPServerToolCallContent {
  */
 declare interface MCPServerToolResultContent {
     /**
-     * ID to match the ID from the MCP server tool call block.
+     * Required. ID to match the ID from the function call block.
      */
     call_id: string;
     /**
@@ -7773,7 +7864,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' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | (string & {});
+declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | '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' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
 
 /** Configuration for Model Armor. Model Armor is a Google Cloud service that provides safety and security filtering for prompts and responses. It helps protect your AI applications from risks such as harmful content, sensitive data leakage, and prompt injection attacks. This data type is not supported in Gemini API. */
 export declare interface ModelArmorConfig {
@@ -8179,6 +8270,52 @@ export declare interface ModelSelectionConfig {
     featureSelectionPreference?: FeatureSelectionPreference;
 }
 
+/** The stage of the underlying model. This enum is not supported in Vertex AI. */
+export declare enum ModelStage {
+    /**
+     * Unspecified model stage.
+     */
+    MODEL_STAGE_UNSPECIFIED = "MODEL_STAGE_UNSPECIFIED",
+    /**
+     * The underlying model is subject to lots of tunings.
+     */
+    UNSTABLE_EXPERIMENTAL = "UNSTABLE_EXPERIMENTAL",
+    /**
+     * Models in this stage are for experimental purposes only.
+     */
+    EXPERIMENTAL = "EXPERIMENTAL",
+    /**
+     * Models in this stage are more mature than experimental models.
+     */
+    PREVIEW = "PREVIEW",
+    /**
+     * Models in this stage are considered stable and ready for production use.
+     */
+    STABLE = "STABLE",
+    /**
+     * If the model is on this stage, it means that this model is on the path to deprecation in near future. Only existing customers can use this model.
+     */
+    LEGACY = "LEGACY",
+    /**
+     * Models in this stage are deprecated. These models cannot be used.
+     */
+    DEPRECATED = "DEPRECATED",
+    /**
+     * Models in this stage are retired. These models cannot be used.
+     */
+    RETIRED = "RETIRED"
+}
+
+/** The status of the underlying model. This is used to indicate the stage of the underlying model and the retirement time if applicable. This data type is not supported in Vertex AI. */
+export declare interface ModelStatus {
+    /** A message explaining the model status. */
+    message?: string;
+    /** The stage of the underlying model. */
+    modelStage?: ModelStage;
+    /** The time at which the model will be retired. */
+    retirementTime?: string;
+}
+
 /** Configuration for a multi-speaker text-to-speech request. */
 export declare interface MultiSpeakerVoiceConfig {
     /** Required. A list of configurations for the voices of the speakers. Exactly two speaker voice configurations must be provided. */
@@ -8264,7 +8401,6 @@ export declare interface Operation<T> {
     response?: T;
     /**
      * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
-     * @internal
      */
     _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<T>;
 }
@@ -8543,6 +8679,8 @@ export declare interface Part {
     toolCall?: ToolCall;
     /** The output from a server-side ToolCall execution. This field is populated by the client with the results of executing the corresponding ToolCall. */
     toolResponse?: ToolResponse;
+    /** Custom metadata associated with the Part. Agents using genai.Part as content representation may need to keep track of the additional information. For example it can be name of a file/source from which the Part originates or a way to multiplex multiple Part streams. This field is not supported in Vertex AI. */
+    partMetadata?: Record<string, unknown>;
 }
 
 /** Partial argument value of the function call. This data type is not supported in Gemini API. */
@@ -8684,6 +8822,8 @@ declare interface PlaceCitation {
     review_snippets?: Array<PlaceCitation.ReviewSnippet>;
     /**
      * Start of segment of the response that is attributed to this source.
+     *
+     * Index indicates the start of the segment, measured in bytes.
      */
     start_index?: number;
     /**
@@ -8801,7 +8941,7 @@ export declare interface ProductImage {
     productImage?: Image_2;
 }
 
-/** Enum for controlling whether the model can generate images of prominent people (celebrities). */
+/** 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. This enum is not supported in Gemini API. */
 export declare enum ProminentPeople {
     /**
      * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
@@ -9078,12 +9218,14 @@ export declare class ReplayResponse {
     sdkResponseSegments?: Record<string, unknown>[];
 }
 
-/** ReplicatedVoiceConfig is used to configure replicated voice. */
+/** The configuration for the replicated voice to use. */
 export declare interface ReplicatedVoiceConfig {
-    /** The mime type of the replicated voice.
+    /** The mimetype of the voice sample. The only currently supported
+     value is `audio/wav`. This represents 16-bit signed little-endian wav
+     data, with a 24kHz sampling rate.
      */
     mimeType?: string;
-    /** The sample audio of the replicated voice.
+    /** The sample of the custom voice.
 
      * @remarks Encoded as base64 string. */
     voiceSampleAudio?: string;
@@ -9327,7 +9469,7 @@ export declare interface Schema {
     anyOf?: Schema[];
     /** Optional. Default value to use if the field is not specified. */
     default?: unknown;
-    /** Optional. Description of the schema. */
+    /** Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. */
     description?: string;
     /** Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` */
     enum?: string[];
@@ -9387,12 +9529,11 @@ export declare interface SearchEntryPoint {
     sdkBlob?: string;
 }
 
-/** Tool to support computer use. */
+/** Different types of search that can be enabled on the GoogleSearch tool. */
 export declare interface SearchTypes {
-    /** Setting this field enables web search. Only text results are
-     returned. */
+    /** Optional. Setting this field enables web search. Only text results are returned. */
     webSearch?: WebSearch;
-    /** Setting this field enables image search. Image bytes are returned. */
+    /** Optional. Setting this field enables image search. Image bytes are returned. */
     imageSearch?: ImageSearch;
 }
 
@@ -9505,6 +9646,26 @@ export declare interface SendMessageParameters {
     config?: GenerateContentConfig;
 }
 
+/** Pricing and performance service tier. */
+export declare enum ServiceTier {
+    /**
+     * Default service tier, which is standard.
+     */
+    UNSPECIFIED = "unspecified",
+    /**
+     * Flex service tier.
+     */
+    FLEX = "flex",
+    /**
+     * Standard service tier.
+     */
+    STANDARD = "standard",
+    /**
+     * Priority service tier.
+     */
+    PRIORITY = "priority"
+}
+
 /**
  Represents a connection to the API.
 
@@ -9694,8 +9855,9 @@ export declare interface SpeakerVoiceConfig {
     voiceConfig?: VoiceConfig;
 }
 
+/** Config for speech generation and transcription. */
 export declare interface SpeechConfig {
-    /** Configuration for the voice of the response. */
+    /** The configuration in case of single-voice output. */
     voiceConfig?: VoiceConfig;
     /** Optional. The language code (ISO 639-1) for the speech synthesis. */
     languageCode?: string;
@@ -9964,7 +10126,7 @@ export declare interface TestTableItem {
  */
 declare interface TextContent {
     /**
-     * The text content.
+     * Required. The text content.
      */
     text: string;
     type: 'text';
@@ -9992,6 +10154,10 @@ export declare enum ThinkingLevel {
      * Unspecified thinking level.
      */
     THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
+    /**
+     * MINIMAL thinking level.
+     */
+    MINIMAL = "MINIMAL",
     /**
      * Low thinking level.
      */
@@ -10003,11 +10169,7 @@ export declare enum ThinkingLevel {
     /**
      * High thinking level.
      */
-    HIGH = "HIGH",
-    /**
-     * MINIMAL thinking level.
-     */
-    MINIMAL = "MINIMAL"
+    HIGH = "HIGH"
 }
 
 declare type ThinkingLevel_2 = 'minimal' | 'low' | 'medium' | 'high';
@@ -10135,9 +10297,9 @@ export declare interface Tool {
      computer. If enabled, it automatically populates computer-use specific
      Function Declarations. */
     computerUse?: ComputerUse;
-    /** Optional. Tool to retrieve knowledge from the File Search Stores. */
+    /** Optional. FileSearch tool type. Tool to retrieve knowledge from Semantic Retrieval corpora. This field is not supported in Vertex AI. */
     fileSearch?: FileSearch;
-    /** Enables the model to execute Google Search as part of generation. */
+    /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
     googleSearch?: GoogleSearch;
     /** Optional. Tool that allows grounding the model's response with
      geospatial context related to the user's query. */
@@ -10161,19 +10323,9 @@ export declare interface Tool {
 /**
  * A tool that can be used by the model.
  */
-declare type Tool_2 = Function_2 | Tool_2.GoogleSearch | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.FileSearch | Tool_2.GoogleMaps;
+declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch | Tool_2.GoogleMaps;
 
 declare namespace Tool_2 {
-    /**
-     * A tool that can be used by the model to search Google.
-     */
-    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.
      */
@@ -10225,6 +10377,16 @@ declare namespace Tool_2 {
          */
         url?: string;
     }
+    /**
+     * A tool that can be used by the model to search Google.
+     */
+    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 search files.
      */
@@ -10247,6 +10409,7 @@ declare namespace Tool_2 {
      * A tool that can be used by the model to call Google Maps.
      */
     interface GoogleMaps {
+        type: 'google_maps';
         /**
          * Whether to return a widget context token in the tool call result of the
          * response.
@@ -10260,7 +10423,6 @@ declare namespace Tool_2 {
          * The longitude of the user's location.
          */
         longitude?: number;
-        type?: 'google_maps';
     }
 }
 
@@ -10388,11 +10550,9 @@ export declare enum TrafficType {
 
 /** Audio transcription in Server Conent. */
 export declare interface Transcription {
-    /** Transcription text.
-     */
+    /** Optional. Transcription text. */
     text?: string;
-    /** The bool indicates the end of the transcription.
-     */
+    /** Optional. The bool indicates the end of the transcription. */
     finished?: boolean;
 }
 
@@ -10530,6 +10690,18 @@ export declare interface TuningJob {
     tuningJobState?: TuningJobState;
     /** Tuning Spec for Veo Tuning. */
     veoTuningSpec?: VeoTuningSpec;
+    /** Optional. Spec for creating a distillation dataset. */
+    distillationSamplingSpec?: DistillationSamplingSpec;
+    /** Output only. Tuning Job metadata. */
+    tuningJobMetadata?: TuningJobMetadata;
+}
+
+/** Tuning job metadata. This data type is not supported in Gemini API. */
+export declare interface TuningJobMetadata {
+    /** Output only. The number of epochs that have been completed. */
+    completedEpochCount?: string;
+    /** Output only. The number of steps that have been completed. Set for Multi-Step RL. */
+    completedStepCount?: string;
 }
 
 /** Output only. The detail state of the tuning job (while the overall `JobState` is running). This enum is not supported in Gemini API. */
@@ -10690,10 +10862,7 @@ export declare interface TuningValidationDataset {
 }
 
 declare interface Turn {
-    /**
-     * The content of the turn.
-     */
-    content?: string | Array<Content_2>;
+    content?: Array<Content_2> | string;
     /**
      * The originator of this turn. Must be user for input or model for
      * model output.
@@ -10734,7 +10903,11 @@ export declare enum TurnCoverage {
     /**
      * The users turn includes all realtime input since the last turn, including inactivity (e.g. silence on the audio stream).
      */
-    TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
+    TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT",
+    /**
+     * Includes audio activity and all video since the last turn. With automatic activity detection, audio activity means speech and excludes silence.
+     */
+    TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO = "TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO"
 }
 
 /** Data type of the schema field. */
@@ -10790,15 +10963,17 @@ declare namespace types {
         Outcome,
         FunctionResponseScheduling,
         Type,
-        PhishBlockThreshold,
+        Environment,
         AuthType,
         HttpElementLocation,
         ApiSpec,
+        PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
         FunctionCallingConfigMode,
         ThinkingLevel,
         PersonGeneration,
+        ProminentPeople,
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
@@ -10809,6 +10984,7 @@ declare namespace types {
         BlockedReason,
         TrafficType,
         Modality,
+        ModelStage,
         MediaResolution,
         TuningMode,
         AdapterSize,
@@ -10817,12 +10993,12 @@ declare namespace types {
         AggregationMetric,
         PairwiseChoice,
         TuningTask,
+        DocumentState,
         PartMediaResolutionLevel,
         ToolType,
         ResourceScope,
+        ServiceTier,
         FeatureSelectionPreference,
-        Environment,
-        ProminentPeople,
         EmbeddingApiType,
         SafetyFilterLevel,
         ImagePromptLanguage,
@@ -10835,7 +11011,6 @@ declare namespace types {
         VideoGenerationMaskMode,
         VideoCompressionQuality,
         TuningMethod,
-        DocumentState,
         FileState,
         FileSource,
         TurnCompleteReason,
@@ -10870,12 +11045,6 @@ declare namespace types {
         Schema,
         ModelSelectionConfig,
         ComputerUse,
-        FileSearch,
-        WebSearch,
-        ImageSearch,
-        SearchTypes,
-        Interval,
-        GoogleSearch,
         ApiKeyConfig,
         AuthConfigGoogleServiceAccountConfig,
         AuthConfigHttpBasicAuthConfig,
@@ -10899,6 +11068,12 @@ declare namespace types {
         RagRetrievalConfig,
         VertexRagStore,
         Retrieval,
+        FileSearch,
+        WebSearch,
+        ImageSearch,
+        SearchTypes,
+        Interval,
+        GoogleSearch,
         ToolCodeExecution,
         EnterpriseWebSearch,
         FunctionDeclaration,
@@ -10935,13 +11110,16 @@ declare namespace types {
         GoogleTypeDate,
         Citation,
         CitationMetadata,
-        GroundingChunkImage,
         GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
         GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
         GroundingChunkMapsPlaceAnswerSources,
+        GroundingChunkMapsRoute,
         GroundingChunkMaps,
+        GroundingChunkImage,
         RagChunkPageSpan,
         RagChunk,
+        GroundingChunkStringList,
+        GroundingChunkCustomMetadata,
         GroundingChunkRetrievedContext,
         GroundingChunkWeb,
         GroundingChunk,
@@ -10961,6 +11139,7 @@ declare namespace types {
         GenerateContentResponsePromptFeedback,
         ModalityTokenCount,
         GenerateContentResponseUsageMetadata,
+        ModelStatus,
         GenerateContentResponse,
         ReferenceImage,
         EditImageParameters,
@@ -11071,6 +11250,8 @@ declare namespace types {
         FullFineTuningSpec,
         VeoHyperParameters,
         VeoTuningSpec,
+        DistillationSamplingSpec,
+        TuningJobMetadata,
         TuningJob,
         ListTuningJobsConfig,
         ListTuningJobsParameters,
@@ -11444,7 +11625,6 @@ export declare class UploadToFileSearchStoreOperation implements Operation<Uploa
     response?: UploadToFileSearchStoreResponse;
     /**
      * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
-     * @internal
      */
     _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<UploadToFileSearchStoreResponse>;
     /** The full HTTP response. */
@@ -11557,6 +11737,8 @@ declare interface URLCitation {
     end_index?: number;
     /**
      * Start of segment of the response that is attributed to this source.
+     *
+     * Index indicates the start of the segment, measured in bytes.
      */
     start_index?: number;
     /**
@@ -11588,11 +11770,11 @@ declare interface URLContextCallArguments {
  */
 declare interface URLContextCallContent {
     /**
-     * A unique ID for this specific tool call.
+     * Required. A unique ID for this specific tool call.
      */
     id: string;
     /**
-     * The arguments to pass to the URL context.
+     * Required. The arguments to pass to the URL context.
      */
     arguments: URLContextCallArguments;
     type: 'url_context_call';
@@ -11627,11 +11809,11 @@ declare interface URLContextResult {
  */
 declare interface URLContextResultContent {
     /**
-     * ID to match the ID from the url context call block.
+     * Required. ID to match the ID from the function call block.
      */
     call_id: string;
     /**
-     * The results of the URL context.
+     * Required. The results of the URL context.
      */
     result: Array<URLContextResult>;
     type: 'url_context_result';
@@ -12036,16 +12218,17 @@ export declare enum VoiceActivityType {
     ACTIVITY_END = "ACTIVITY_END"
 }
 
+/** The configuration for the voice to use. */
 export declare interface VoiceConfig {
-    /** If true, the model will use a replicated voice for the response. */
+    /** The configuration for a replicated voice, which is a clone of a
+     user's voice that can be used for speech synthesis. If this is unset, a
+     default voice is used. */
     replicatedVoiceConfig?: ReplicatedVoiceConfig;
     /** The configuration for a prebuilt voice. */
     prebuiltVoiceConfig?: PrebuiltVoiceConfig;
 }
 
-/** Standard web search for grounding and related configurations.
-
- Only text results are returned. */
+/** Standard web search for grounding and related configurations. Only text results are returned. */
 export declare interface WebSearch {
 }