@google/genai 1.45.0 → 1.47.0

package/dist/vertex_internal/index.d.ts

@@ -833,12 +833,16 @@ declare interface CitationMetadata {
     citations?: Citation[];
 }
 
-/** Result of executing the [ExecutableCode]. Only generated when using the [CodeExecution] tool, and always follows a `part` containing the [ExecutableCode]. */
+/** Result of executing the `ExecutableCode`.
+
+ Generated only when the `CodeExecution` tool is used. */
 declare interface CodeExecutionResult {
     /** Required. Outcome of the code execution. */
     outcome?: Outcome;
     /** Optional. Contains stdout when code execution is successful, stderr or other description otherwise. */
     output?: string;
+    /** The identifier of the `ExecutableCode` part this result is for. Only populated if the corresponding `ExecutableCode` has an id. */
+    id?: string;
 }
 
 /** Success and error statistics of processing multiple entities (for example, DataItems or structured data rows) in batch. This data type is not supported in Gemini API. */
@@ -1368,7 +1372,7 @@ 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;
@@ -1669,7 +1673,7 @@ declare interface DistillationDataStats {
     trainingDatasetStats?: DatasetStats;
 }
 
-/** Hyperparameters for Distillation. This data type is not supported in Gemini API. */
+/** Hyperparameters for distillation. */
 declare interface DistillationHyperParameters {
     /** Optional. Adapter size for distillation. */
     adapterSize?: AdapterSize;
@@ -1677,6 +1681,21 @@ 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. */
+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. */
@@ -1697,20 +1716,21 @@ 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/*/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;
@@ -1720,11 +1740,23 @@ declare interface Document_2 {
     updateTime?: string;
 }
 
-/** State for the lifecycle of a Document. */
+/** Output only. Current state of the `Document`. This enum is not supported in Vertex AI. */
 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"
 }
 
@@ -2066,7 +2098,7 @@ 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;
 }
 
@@ -2084,12 +2116,18 @@ declare interface ExactMatchMetricValue {
     score?: number;
 }
 
-/** Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the [CodeExecution] tool, in which the code will be automatically executed, and a corresponding [CodeExecutionResult] will also be generated. */
+/** Model-generated code executed server-side, results returned to the model.
+
+ Only generated when using the `CodeExecution` tool, in which the code will
+ be automatically executed, and a corresponding `CodeExecutionResult` will
+ also be generated. */
 declare interface ExecutableCode {
     /** Required. The code to be executed. */
     code?: string;
     /** Required. Programming language of the `code`. */
     language?: Language;
+    /** Unique identifier of the `ExecutableCode` part. The server returns the `CodeExecutionResult` with the matching `id`. */
+    id?: string;
 }
 
 /** Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec. This data type is not supported in Gemini API. */
@@ -2193,14 +2231,13 @@ declare interface FileData {
     mimeType?: string;
 }
 
-/** 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. */
 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;
 }
 
@@ -2693,6 +2730,8 @@ declare interface GenerateContentConfig {
      service. If supplied, safety_settings must not be supplied.
      */
     modelArmorConfig?: ModelArmorConfig;
+    /** The service tier to use for the request. For example, SERVICE_TIER_FLEX. */
+    serviceTier?: ServiceTier;
 }
 
 /** Config for models.generate_content parameters. */
@@ -2729,6 +2768,8 @@ 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.
      *
@@ -3058,6 +3099,8 @@ 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. */
@@ -3074,7 +3117,6 @@ declare class GenerateVideosOperation implements Operation<GenerateVideosRespons
     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. */
@@ -3394,9 +3436,9 @@ declare interface GoogleRpcStatus {
     message?: string;
 }
 
-/** Tool to support web search. */
+/** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
 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;
@@ -3428,9 +3470,7 @@ declare interface GoogleTypeDate {
  is enabled, the model returns a `GroundingChunk` that contains a reference to
  the source of the information. */
 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.
 
@@ -3438,17 +3478,25 @@ 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. */
+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. */
 declare interface GroundingChunkImage {
     /** The URI of the image search result page. */
     sourceUri?: string;
@@ -3480,6 +3528,8 @@ 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.
@@ -3523,11 +3573,21 @@ 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. */
+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. */
 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;
@@ -3535,6 +3595,16 @@ 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. */
+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. */
@@ -3549,10 +3619,7 @@ declare interface GroundingChunkWeb {
 
 /** Information for various kinds of grounding. */
 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
@@ -3568,7 +3635,7 @@ 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[];
@@ -3598,6 +3665,8 @@ 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. */
@@ -3879,11 +3948,7 @@ 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. */
@@ -3891,7 +3956,7 @@ 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;
 }
 
@@ -3974,7 +4039,6 @@ 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. */
@@ -4003,12 +4067,12 @@ declare class ImportFileResponse {
 
 /** Config for `inlined_embedding_responses` parameter. */
 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. */
@@ -4272,6 +4336,7 @@ declare interface ListFileSearchStoresParameters {
 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[];
@@ -4958,6 +5023,8 @@ 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. */
@@ -5173,6 +5240,52 @@ declare interface ModelSelectionConfig {
     featureSelectionPreference?: FeatureSelectionPreference;
 }
 
+/** The stage of the underlying model. This enum is not supported in Vertex AI. */
+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. */
+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;
+}
+
 /**
  * Moves values from source paths to destination paths.
  *
@@ -5243,8 +5356,8 @@ export declare class NodeDownloader implements Downloader {
 
 export declare class NodeUploader implements Uploader {
     stat(file: string | Blob): Promise<FileStat>;
-    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<File_2>;
-    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<UploadToFileSearchStoreOperation>;
+    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<File_2>;
+    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<UploadToFileSearchStoreOperation>;
     /**
      * Infers the MIME type of a file based on its extension.
      *
@@ -5271,7 +5384,6 @@ 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>;
 }
@@ -5378,6 +5490,12 @@ declare interface Part {
     thoughtSignature?: string;
     /** Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. */
     videoMetadata?: VideoMetadata;
+    /** Server-side tool call. This field is populated when the model predicts a tool invocation that should be executed on the server. The client is expected to echo this message back to the API. */
+    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. */
@@ -5580,7 +5698,7 @@ 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. */
 declare enum ProminentPeople {
     /**
      * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
@@ -5845,12 +5963,14 @@ declare class ReplayResponse {
     sdkResponseSegments?: Record<string, unknown>[];
 }
 
-/** ReplicatedVoiceConfig is used to configure replicated voice. */
+/** The configuration for the replicated voice to use. */
 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;
@@ -6018,7 +6138,7 @@ 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[];
@@ -6078,12 +6198,11 @@ declare interface SearchEntryPoint {
     sdkBlob?: string;
 }
 
-/** Tool to support computer use. */
+/** Different types of search that can be enabled on the GoogleSearch tool. */
 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;
 }
 
@@ -6196,6 +6315,26 @@ declare interface SendMessageParameters {
     config?: GenerateContentConfig;
 }
 
+/** Pricing and performance service tier. */
+declare enum ServiceTier {
+    /**
+     * Default service tier, which is standard.
+     */
+    SERVICE_TIER_UNSPECIFIED = "SERVICE_TIER_UNSPECIFIED",
+    /**
+     * Flex service tier.
+     */
+    SERVICE_TIER_FLEX = "SERVICE_TIER_FLEX",
+    /**
+     * Standard service tier.
+     */
+    SERVICE_TIER_STANDARD = "SERVICE_TIER_STANDARD",
+    /**
+     * Priority service tier.
+     */
+    SERVICE_TIER_PRIORITY = "SERVICE_TIER_PRIORITY"
+}
+
 /** Configuration of session resumption mechanism.
 
  Included in `LiveConnectConfig.session_resumption`. If included server
@@ -6240,8 +6379,9 @@ declare interface SpeakerVoiceConfig {
     voiceConfig?: VoiceConfig;
 }
 
+/** Config for speech generation and transcription. */
 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;
@@ -6480,6 +6620,10 @@ declare enum ThinkingLevel {
      * Unspecified thinking level.
      */
     THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
+    /**
+     * MINIMAL thinking level.
+     */
+    MINIMAL = "MINIMAL",
     /**
      * Low thinking level.
      */
@@ -6491,11 +6635,7 @@ declare enum ThinkingLevel {
     /**
      * High thinking level.
      */
-    HIGH = "HIGH",
-    /**
-     * MINIMAL thinking level.
-     */
-    MINIMAL = "MINIMAL"
+    HIGH = "HIGH"
 }
 
 /** Tokens info with a list of tokens and the corresponding list of token ids. */
@@ -6517,9 +6657,9 @@ 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. */
@@ -6540,6 +6680,21 @@ declare interface Tool {
     mcpServers?: McpServer[];
 }
 
+/** A predicted server-side `ToolCall` returned from the model.
+
+ This message contains information about a tool that the model wants to invoke.
+ The client is NOT expected to execute this `ToolCall`. Instead, the
+ client should pass this `ToolCall` back to the API in a subsequent turn
+ within a `Content` message, along with the corresponding `ToolResponse`. */
+declare interface ToolCall {
+    /** Unique identifier of the tool call. The server returns the tool response with the matching `id`. */
+    id?: string;
+    /** The type of tool that was called. */
+    toolType?: ToolType;
+    /** The tool call arguments. Example: {"arg1": "value1", "arg2": "value2"}. */
+    args?: Record<string, unknown>;
+}
+
 /** Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool. This data type is not supported in Gemini API. */
 declare interface ToolCodeExecution {
 }
@@ -6552,6 +6707,8 @@ declare interface ToolConfig {
     retrievalConfig?: RetrievalConfig;
     /** Optional. Function calling config. */
     functionCallingConfig?: FunctionCallingConfig;
+    /** If true, the API response will include the server-side tool calls and responses within the `Content` message. This allows clients to observe the server's tool invocations. */
+    includeServerSideToolInvocations?: boolean;
 }
 
 declare type ToolListUnion = ToolUnion[];
@@ -6564,6 +6721,49 @@ declare interface ToolParallelAiSearch {
     customConfigs?: Record<string, unknown>;
 }
 
+/** The output from a server-side `ToolCall` execution.
+
+ This message contains the results of a tool invocation that was initiated by a
+ `ToolCall` from the model. The client should pass this `ToolResponse` back to
+ the API in a subsequent turn within a `Content` message, along with the
+ corresponding `ToolCall`. */
+declare class ToolResponse {
+    /** The identifier of the tool call this response is for. */
+    id?: string;
+    /** The type of tool that was called, matching the tool_type in the corresponding ToolCall. */
+    toolType?: ToolType;
+    /** The tool response. */
+    response?: Record<string, unknown>;
+}
+
+/** The type of tool in the function call. */
+declare enum ToolType {
+    /**
+     * Unspecified tool type.
+     */
+    TOOL_TYPE_UNSPECIFIED = "TOOL_TYPE_UNSPECIFIED",
+    /**
+     * Google search tool, maps to Tool.google_search.search_types.web_search.
+     */
+    GOOGLE_SEARCH_WEB = "GOOGLE_SEARCH_WEB",
+    /**
+     * Image search tool, maps to Tool.google_search.search_types.image_search.
+     */
+    GOOGLE_SEARCH_IMAGE = "GOOGLE_SEARCH_IMAGE",
+    /**
+     * URL context tool, maps to Tool.url_context.
+     */
+    URL_CONTEXT = "URL_CONTEXT",
+    /**
+     * Google maps tool, maps to Tool.google_maps.
+     */
+    GOOGLE_MAPS = "GOOGLE_MAPS",
+    /**
+     * File search tool, maps to Tool.file_search.
+     */
+    FILE_SEARCH = "FILE_SEARCH"
+}
+
 declare type ToolUnion = Tool | CallableTool;
 
 /** Output only. The traffic type for this request. This enum is not supported in Gemini API. */
@@ -6592,11 +6792,9 @@ declare enum TrafficType {
 
 /** Audio transcription in Server Conent. */
 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;
 }
 
@@ -6734,6 +6932,18 @@ 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. */
+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. */
@@ -6870,7 +7080,11 @@ 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. */
@@ -6922,19 +7136,21 @@ declare namespace types {
         createPartFromExecutableCode,
         createUserContent,
         createModelContent,
-        Outcome,
         Language,
+        Outcome,
         FunctionResponseScheduling,
         Type,
-        PhishBlockThreshold,
+        Environment,
         AuthType,
         HttpElementLocation,
         ApiSpec,
+        PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
         FunctionCallingConfigMode,
         ThinkingLevel,
         PersonGeneration,
+        ProminentPeople,
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
@@ -6945,6 +7161,7 @@ declare namespace types {
         BlockedReason,
         TrafficType,
         Modality,
+        ModelStage,
         MediaResolution,
         TuningMode,
         AdapterSize,
@@ -6953,11 +7170,12 @@ declare namespace types {
         AggregationMetric,
         PairwiseChoice,
         TuningTask,
+        DocumentState,
         PartMediaResolutionLevel,
+        ToolType,
         ResourceScope,
+        ServiceTier,
         FeatureSelectionPreference,
-        Environment,
-        ProminentPeople,
         EmbeddingApiType,
         SafetyFilterLevel,
         ImagePromptLanguage,
@@ -6970,7 +7188,6 @@ declare namespace types {
         VideoGenerationMaskMode,
         VideoCompressionQuality,
         TuningMethod,
-        DocumentState,
         FileState,
         FileSource,
         TurnCompleteReason,
@@ -6984,9 +7201,11 @@ declare namespace types {
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
-        PartMediaResolution,
-        CodeExecutionResult,
         ExecutableCode,
+        CodeExecutionResult,
+        PartMediaResolution,
+        ToolCall,
+        ToolResponse,
         FileData,
         PartialArg,
         FunctionCall,
@@ -7003,12 +7222,6 @@ declare namespace types {
         Schema,
         ModelSelectionConfig,
         ComputerUse,
-        FileSearch,
-        WebSearch,
-        ImageSearch,
-        SearchTypes,
-        Interval,
-        GoogleSearch,
         ApiKeyConfig,
         AuthConfigGoogleServiceAccountConfig,
         AuthConfigHttpBasicAuthConfig,
@@ -7032,6 +7245,12 @@ declare namespace types {
         RagRetrievalConfig,
         VertexRagStore,
         Retrieval,
+        FileSearch,
+        WebSearch,
+        ImageSearch,
+        SearchTypes,
+        Interval,
+        GoogleSearch,
         ToolCodeExecution,
         EnterpriseWebSearch,
         FunctionDeclaration,
@@ -7068,13 +7287,16 @@ declare namespace types {
         GoogleTypeDate,
         Citation,
         CitationMetadata,
-        GroundingChunkImage,
         GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
         GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
         GroundingChunkMapsPlaceAnswerSources,
+        GroundingChunkMapsRoute,
         GroundingChunkMaps,
+        GroundingChunkImage,
         RagChunkPageSpan,
         RagChunk,
+        GroundingChunkStringList,
+        GroundingChunkCustomMetadata,
         GroundingChunkRetrievedContext,
         GroundingChunkWeb,
         GroundingChunk,
@@ -7094,6 +7316,7 @@ declare namespace types {
         GenerateContentResponsePromptFeedback,
         ModalityTokenCount,
         GenerateContentResponseUsageMetadata,
+        ModelStatus,
         GenerateContentResponse,
         ReferenceImage,
         EditImageParameters,
@@ -7204,6 +7427,8 @@ declare namespace types {
         FullFineTuningSpec,
         VeoHyperParameters,
         VeoTuningSpec,
+        DistillationSamplingSpec,
+        TuningJobMetadata,
         TuningJob,
         ListTuningJobsConfig,
         ListTuningJobsParameters,
@@ -7460,7 +7685,7 @@ export declare interface Uploader {
      * @param apiClient The ApiClient to use for uploading.
      * @return A Promise that resolves to types.File.
      */
-    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<File_2>;
+    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<File_2>;
     /**
      * Uploads a file to file search store via the given upload url.
      *
@@ -7469,9 +7694,10 @@ export declare interface Uploader {
      *     uploaded to. The uploadUrl must be a url that was returned by the
      * https://generativelanguage.googleapis.com/upload/v1beta/{file_search_store_name}:uploadToFileSearchStore endpoint
      * @param apiClient The ApiClient to use for uploading.
+     * @param httpOptions Optional HTTP options to merge.
      * @return A Promise that resolves to types.UploadToFileSearchStoreOperation.
      */
-    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<UploadToFileSearchStoreOperation>;
+    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<UploadToFileSearchStoreOperation>;
     /**
      * Returns the file's mimeType and the size of a given file. If the file is a
      * string path, the file type is determined by the file extension. If the
@@ -7545,7 +7771,6 @@ declare class UploadToFileSearchStoreOperation implements Operation<UploadToFile
     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. */
@@ -7923,16 +8148,17 @@ declare enum VoiceActivityType {
     ACTIVITY_END = "ACTIVITY_END"
 }
 
+/** The configuration for the voice to use. */
 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. */
 declare interface WebSearch {
 }