@google/genai 1.43.0 → 1.45.0

package/dist/tokenizer/node.d.ts

@@ -40,8 +40,10 @@ declare enum ApiSpec {
     ELASTIC_SEARCH = "ELASTIC_SEARCH"
 }
 
-/** Auth configuration to run the extension. This data type is not supported in Gemini API. */
+/** The authentication config to access the API. */
 declare interface AuthConfig {
+    /** The authentication config to access the API. Only API key is supported. This field is not supported in Gemini API. */
+    apiKey?: string;
     /** Config for API key auth. */
     apiKeyConfig?: ApiKeyConfig;
     /** Type of auth scheme. */
@@ -129,12 +131,12 @@ declare enum Behavior {
     NON_BLOCKING = "NON_BLOCKING"
 }
 
-/** Content blob. */
+/** A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. */
 declare interface Blob_2 {
-    /** Required. Raw bytes.
+    /** Required. The raw bytes of the data.
      * @remarks Encoded as base64 string. */
     data?: string;
-    /** Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. This field is not supported in Gemini API. */
+    /** Optional. The display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server-side tools (`code_execution`, `google_search`, and `url_context`) are enabled. This field is not supported in Gemini API. */
     displayName?: string;
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
@@ -171,7 +173,7 @@ declare interface Content {
     /** List of parts that constitute a single message. Each part may have
      a different IANA MIME type. */
     parts?: Part[];
-    /** Optional. The producer of the content. Must be either 'user' or 'model'. Useful to set for multi-turn conversations, otherwise can be left blank or unset. */
+    /** Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. */
     role?: string;
 }
 
@@ -231,10 +233,10 @@ declare enum DynamicRetrievalConfigMode {
 
 /** Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. This data type is not supported in Gemini API. */
 declare interface EnterpriseWebSearch {
-    /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. */
-    excludeDomains?: string[];
     /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. */
     blockingConfidence?: PhishBlockThreshold;
+    /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. */
+    excludeDomains?: string[];
 }
 
 /** The environment being operated. */
@@ -295,11 +297,11 @@ declare enum FeatureSelectionPreference {
     PRIORITIZE_COST = "PRIORITIZE_COST"
 }
 
-/** URI based data. */
+/** URI-based data. A FileData message contains a URI pointing to data of a specific media type. It is used to represent images, audio, and video stored in Google Cloud Storage. */
 declare interface FileData {
-    /** Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. This field is not supported in Gemini API. */
+    /** Optional. The display name of the file. Used to provide a label or filename to distinguish files. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server side tools (`code_execution`, `google_search`, and `url_context`) are enabled. This field is not supported in Gemini API. */
     displayName?: string;
-    /** Required. URI. */
+    /** Required. The URI of the file in Google Cloud Storage. */
     fileUri?: string;
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
@@ -335,7 +337,7 @@ declare interface FunctionCall {
 declare interface FunctionDeclaration {
     /** Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function. */
     description?: string;
-    /** Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots and dashes, with a maximum length of 64. */
+    /** Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots, colons and dashes, with a maximum length of 64. */
     name?: string;
     /** Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema Value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1 */
     parameters?: Schema;
@@ -436,75 +438,75 @@ declare interface GenerationConfig {
      `response_schema` that accepts [JSON Schema](https://json-schema.org/).
      */
     responseJsonSchema?: unknown;
-    /** Optional. If enabled, audio timestamp will be included in the request to the model. This field is not supported in Gemini API. */
+    /** Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. This field is not supported in Gemini API. */
     audioTimestamp?: boolean;
-    /** Optional. Number of candidates to generate. */
+    /** Optional. The number of candidate responses to generate. A higher `candidate_count` can provide more options to choose from, but it also consumes more resources. This can be useful for generating a variety of responses and selecting the best one. */
     candidateCount?: number;
-    /** Optional. If enabled, the model will detect emotions and adapt its responses accordingly. This field is not supported in Gemini API. */
+    /** Optional. If enabled, the model will detect emotions and adapt its responses accordingly. For example, if the model detects that the user is frustrated, it may provide a more empathetic response. This field is not supported in Gemini API. */
     enableAffectiveDialog?: boolean;
-    /** Optional. Frequency penalties. */
+    /** Optional. Penalizes tokens based on their frequency in the generated text. A positive value helps to reduce the repetition of words and phrases. Valid values can range from [-2.0, 2.0]. */
     frequencyPenalty?: number;
-    /** Optional. Logit probabilities. */
+    /** Optional. The number of top log probabilities to return for each token. This can be used to see which other tokens were considered likely candidates for a given position. A higher value will return more options, but it will also increase the size of the response. */
     logprobs?: number;
-    /** Optional. The maximum number of output tokens to generate per message. */
+    /** Optional. The maximum number of tokens to generate in the response. A token is approximately four characters. The default value varies by model. This parameter can be used to control the length of the generated text and prevent overly long responses. */
     maxOutputTokens?: number;
-    /** Optional. If specified, the media resolution specified will be used. */
+    /** Optional. The token resolution at which input media content is sampled. This is used to control the trade-off between the quality of the response and the number of tokens used to represent the media. A higher resolution allows the model to perceive more detail, which can lead to a more nuanced response, but it will also use more tokens. This does not affect the image dimensions sent to the model. */
     mediaResolution?: MediaResolution;
-    /** Optional. Positive penalties. */
+    /** Optional. Penalizes tokens that have already appeared in the generated text. A positive value encourages the model to generate more diverse and less repetitive text. Valid values can range from [-2.0, 2.0]. */
     presencePenalty?: number;
-    /** Optional. If true, export the logprobs results in response. */
+    /** Optional. If set to true, the log probabilities of the output tokens are returned. Log probabilities are the logarithm of the probability of a token appearing in the output. A higher log probability means the token is more likely to be generated. This can be useful for analyzing the model's confidence in its own output and for debugging. */
     responseLogprobs?: boolean;
-    /** Optional. Output response mimetype of the generated candidate text. Supported mimetype: - `text/plain`: (default) Text output. - `application/json`: JSON response in the candidates. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. This is a preview feature. */
+    /** Optional. The IANA standard MIME type of the response. The model will generate output that conforms to this MIME type. Supported values include 'text/plain' (default) and 'application/json'. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. This is a preview feature. */
     responseMimeType?: string;
-    /** Optional. The modalities of the response. */
+    /** Optional. The modalities of the response. The model will generate a response that includes all the specified modalities. For example, if this is set to `[TEXT, IMAGE]`, the response will include both text and an image. */
     responseModalities?: Modality[];
-    /** Optional. The `Schema` object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema). If set, a compatible response_mime_type must also be set. Compatible mimetypes: `application/json`: Schema for JSON response. */
+    /** Optional. Lets you to specify a schema for the model's response, ensuring that the output conforms to a particular structure. This is useful for generating structured data such as JSON. The schema is a subset of the [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema) object. When this field is set, you must also set the `response_mime_type` to `application/json`. */
     responseSchema?: Schema;
     /** Optional. Routing configuration. This field is not supported in Gemini API. */
     routingConfig?: GenerationConfigRoutingConfig;
-    /** Optional. Seed. */
+    /** Optional. A seed for the random number generator. By setting a seed, you can make the model's output mostly deterministic. For a given prompt and parameters (like temperature, top_p, etc.), the model will produce the same response every time. However, it's not a guaranteed absolute deterministic behavior. This is different from parameters like `temperature`, which control the *level* of randomness. `seed` ensures that the "random" choices the model makes are the same on every run, making it essential for testing and ensuring reproducible results. */
     seed?: number;
     /** Optional. The speech generation config. */
     speechConfig?: SpeechConfig;
-    /** Optional. Stop sequences. */
+    /** Optional. A list of character sequences that will stop the model from generating further tokens. If a stop sequence is generated, the output will end at that point. This is useful for controlling the length and structure of the output. For example, you can use ["\n", "###"] to stop generation at a new line or a specific marker. */
     stopSequences?: string[];
-    /** Optional. Controls the randomness of predictions. */
+    /** Optional. Controls the randomness of the output. A higher temperature results in more creative and diverse responses, while a lower temperature makes the output more predictable and focused. The valid range is (0.0, 2.0]. */
     temperature?: number;
-    /** Optional. Config for thinking features. An error will be returned if this field is set for models that don't support thinking. */
+    /** Optional. Configuration for thinking features. An error will be returned if this field is set for models that don't support thinking. */
     thinkingConfig?: ThinkingConfig;
-    /** Optional. If specified, top-k sampling will be used. */
+    /** Optional. Specifies the top-k sampling threshold. The model considers only the top k most probable tokens for the next token. This can be useful for generating more coherent and less random text. For example, a `top_k` of 40 means the model will choose the next word from the 40 most likely words. */
     topK?: number;
-    /** Optional. If specified, nucleus sampling will be used. */
+    /** Optional. Specifies the nucleus sampling threshold. The model considers only the smallest set of tokens whose cumulative probability is at least `top_p`. This helps generate more diverse and less repetitive responses. For example, a `top_p` of 0.9 means the model considers tokens until the cumulative probability of the tokens to select from reaches 0.9. It's recommended to adjust either temperature or `top_p`, but not both. */
     topP?: number;
     /** Optional. Enables enhanced civic answers. It may not be available for all models. This field is not supported in Vertex AI. */
     enableEnhancedCivicAnswers?: boolean;
 }
 
-/** The configuration for routing the request to a specific model. This data type is not supported in Gemini API. */
+/** The configuration for routing the request to a specific model. This can be used to control which model is used for the generation, either automatically or by specifying a model name. This data type is not supported in Gemini API. */
 declare interface GenerationConfigRoutingConfig {
-    /** Automated routing. */
+    /** In this mode, the model is selected automatically based on the content of the request. */
     autoMode?: GenerationConfigRoutingConfigAutoRoutingMode;
-    /** Manual routing. */
+    /** In this mode, the model is specified manually. */
     manualMode?: GenerationConfigRoutingConfigManualRoutingMode;
 }
 
-/** When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference. This data type is not supported in Gemini API. */
+/** The configuration for automated routing. When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference. This data type is not supported in Gemini API. */
 declare interface GenerationConfigRoutingConfigAutoRoutingMode {
     /** The model routing preference. */
     modelRoutingPreference?: 'UNKNOWN' | 'PRIORITIZE_QUALITY' | 'BALANCED' | 'PRIORITIZE_COST';
 }
 
-/** When manual routing is set, the specified model will be used directly. This data type is not supported in Gemini API. */
+/** The configuration for manual routing. When manual routing is specified, the model will be selected based on the model name provided. This data type is not supported in Gemini API. */
 declare interface GenerationConfigRoutingConfigManualRoutingMode {
-    /** The model name to use. Only the public LLM models are accepted. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models). */
+    /** The name of the model to use. Only public LLM models are accepted. */
     modelName?: string;
 }
 
-/** Tool to retrieve public maps data for grounding, powered by Google. */
+/** Tool to retrieve knowledge from Google Maps. */
 declare interface GoogleMaps {
     /** The authentication config to access the API. Only API key is supported. This field is not supported in Gemini API. */
     authConfig?: AuthConfig;
-    /** Optional. If true, include the widget context token in the response. */
+    /** Optional. Whether to return a widget context token in the GroundingMetadata of the response. Developers can use the widget context token to render a Google Maps widget with geospatial context related to the places that the model references in the response. */
     enableWidget?: boolean;
 }
 
@@ -512,10 +514,10 @@ declare interface GoogleMaps {
 declare interface GoogleSearch {
     /** Different types of search that can be enabled on the GoogleSearch tool. */
     searchTypes?: SearchTypes;
-    /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. This field is not supported in Gemini API. */
-    excludeDomains?: string[];
     /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
     blockingConfidence?: PhishBlockThreshold;
+    /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. This field is not supported in Gemini API. */
+    excludeDomains?: string[];
     /** Optional. Filter search results to a specific time range. If customers set a start time, they must set an end time (and vice versa). This field is not supported in Vertex AI. */
     timeRangeFilter?: Interval;
 }
@@ -734,21 +736,21 @@ declare interface Part {
     /** Media resolution for the input media.
      */
     mediaResolution?: PartMediaResolution;
-    /** Optional. Result of executing the [ExecutableCode]. */
+    /** Optional. The result of executing the ExecutableCode. */
     codeExecutionResult?: CodeExecutionResult;
-    /** Optional. Code generated by the model that is meant to be executed. */
+    /** Optional. Code generated by the model that is intended to be executed. */
     executableCode?: ExecutableCode;
-    /** Optional. URI based data. */
+    /** Optional. The URI-based data of the part. This can be used to include files from Google Cloud Storage. */
     fileData?: FileData;
-    /** Optional. A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] with the parameters and their values. */
+    /** Optional. A predicted function call returned from the model. This contains the name of the function to call and the arguments to pass to the function. */
     functionCall?: FunctionCall;
-    /** Optional. The result output of a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function call. It is used as context to the model. */
+    /** Optional. The result of a function call. This is used to provide the model with the result of a function call that it predicted. */
     functionResponse?: FunctionResponse;
-    /** Optional. Inlined bytes data. */
+    /** Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. */
     inlineData?: Blob_2;
-    /** Optional. Text part (can be code). */
+    /** Optional. The text content of the part. When sent from the VSCode Gemini Code Assist extension, references to @mentioned items will be converted to markdown boldface text. For example `@my-repo` will be converted to and sent as `**my-repo**` by the IDE agent. */
     text?: string;
-    /** Optional. Indicates if the part is thought from the model. */
+    /** Optional. Indicates whether the `part` represents the model's thought process or reasoning. */
     thought?: boolean;
     /** Optional. An opaque signature for the thought so it can be reused in subsequent requests.
      * @remarks Encoded as base64 string. */
@@ -759,16 +761,16 @@ declare interface Part {
 
 /** Partial argument value of the function call. This data type is not supported in Gemini API. */
 declare interface PartialArg {
+    /** Optional. Represents a boolean value. */
+    boolValue?: boolean;
+    /** Required. A JSON Path (RFC 9535) to the argument being streamed. https://datatracker.ietf.org/doc/html/rfc9535. e.g. "$.foo.bar[0].data". */
+    jsonPath?: string;
     /** Optional. Represents a null value. */
     nullValue?: 'NULL_VALUE';
     /** Optional. Represents a double value. */
     numberValue?: number;
     /** Optional. Represents a string value. */
     stringValue?: string;
-    /** Optional. Represents a boolean value. */
-    boolValue?: boolean;
-    /** Required. A JSON Path (RFC 9535) to the argument being streamed. https://datatracker.ietf.org/doc/html/rfc9535. e.g. "$.foo.bar[0].data". */
-    jsonPath?: string;
     /** Optional. Whether this is not the last part of the same json_path. If true, another PartialArg message for the current json_path is expected to follow. */
     willContinue?: boolean;
 }
@@ -841,9 +843,9 @@ declare enum PhishBlockThreshold {
     BLOCK_ONLY_EXTREMELY_HIGH = "BLOCK_ONLY_EXTREMELY_HIGH"
 }
 
-/** The configuration for the prebuilt speaker to use. */
+/** Configuration for a prebuilt voice. */
 declare interface PrebuiltVoiceConfig {
-    /** The name of the preset voice to use. */
+    /** The name of the prebuilt voice to use. */
     voiceName?: string;
 }
 
@@ -936,49 +938,49 @@ declare interface Retrieval {
  object](https://spec.openapis.org/oas/v3.0.3#schema-object). More fields may
  be added in the future as needed. */
 declare interface Schema {
-    /** Optional. The value should be validated against any (one or more) of the subschemas in the list. */
+    /** Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. */
     anyOf?: Schema[];
-    /** Optional. Default value of the data. */
+    /** Optional. Default value to use if the field is not specified. */
     default?: unknown;
-    /** Optional. The description of the data. */
+    /** Optional. Description of the schema. */
     description?: string;
-    /** Optional. Possible values of the element of primitive type with enum format. Examples: 1. We can define direction as : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. We can define apartment number as : {type:INTEGER, format:enum, enum:["101", "201", "301"]} */
+    /** 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[];
-    /** Optional. Example of the object. Will only populated when the object is the root. */
+    /** Optional. Example of an instance of this schema. */
     example?: unknown;
-    /** Optional. The format of the data. Supported formats: for NUMBER type: "float", "double" for INTEGER type: "int32", "int64" for STRING type: "email", "byte", etc */
+    /** Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. */
     format?: string;
-    /** Optional. SCHEMA FIELDS FOR TYPE ARRAY Schema of the elements of Type.ARRAY. */
+    /** Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. */
     items?: Schema;
-    /** Optional. Maximum number of the elements for Type.ARRAY. */
+    /** Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. */
     maxItems?: string;
-    /** Optional. Maximum length of the Type.STRING */
+    /** Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. */
     maxLength?: string;
-    /** Optional. Maximum number of the properties for Type.OBJECT. */
+    /** Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. */
     maxProperties?: string;
-    /** Optional. Maximum value of the Type.INTEGER and Type.NUMBER */
+    /** Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. */
     maximum?: number;
-    /** Optional. Minimum number of the elements for Type.ARRAY. */
+    /** Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. */
     minItems?: string;
-    /** Optional. SCHEMA FIELDS FOR TYPE STRING Minimum length of the Type.STRING */
+    /** Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. */
     minLength?: string;
-    /** Optional. Minimum number of the properties for Type.OBJECT. */
+    /** Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. */
     minProperties?: string;
-    /** Optional. SCHEMA FIELDS FOR TYPE INTEGER and NUMBER Minimum value of the Type.INTEGER and Type.NUMBER */
+    /** Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. */
     minimum?: number;
-    /** Optional. Indicates if the value may be null. */
+    /** Optional. Indicates if the value of this field can be null. */
     nullable?: boolean;
-    /** Optional. Pattern of the Type.STRING to restrict a string to a regular expression. */
+    /** Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. */
     pattern?: string;
-    /** Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT. */
+    /** Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. */
     properties?: Record<string, Schema>;
-    /** Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties. */
+    /** Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. */
     propertyOrdering?: string[];
-    /** Optional. Required properties of Type.OBJECT. */
+    /** Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. */
     required?: string[];
-    /** Optional. The title of the Schema. */
+    /** Optional. Title for the schema. */
     title?: string;
-    /** Optional. The type of the data. */
+    /** Optional. Data type of the schema field. */
     type?: Type;
 }
 
@@ -991,7 +993,7 @@ declare interface SearchTypes {
     imageSearch?: ImageSearch;
 }
 
-/** Configuration for a single speaker in a multi speaker setup. */
+/** Configuration for a single speaker in a multi-speaker setup. */
 declare interface SpeakerVoiceConfig {
     /** Required. The name of the speaker. This should be the same as the speaker name used in the prompt. */
     speaker?: string;
@@ -1002,7 +1004,7 @@ declare interface SpeakerVoiceConfig {
 declare interface SpeechConfig {
     /** Configuration for the voice of the response. */
     voiceConfig?: VoiceConfig;
-    /** Optional. Language code (ISO 639. e.g. en-US) for the speech synthesization. */
+    /** Optional. The language code (ISO 639-1) for the speech synthesis. */
     languageCode?: string;
     /** The configuration for a multi-speaker text-to-speech request. This field is mutually exclusive with `voice_config`. */
     multiSpeakerVoiceConfig?: MultiSpeakerVoiceConfig;
@@ -1081,16 +1083,19 @@ declare interface Tool {
     fileSearch?: FileSearch;
     /** Enables the model to execute Google Search as part of generation. */
     googleSearch?: GoogleSearch;
+    /** Optional. Tool that allows grounding the model's response with
+     geospatial context related to the user's query. */
+    googleMaps?: GoogleMaps;
     /** Optional. CodeExecution tool type. Enables the model to execute code as part of generation. */
     codeExecution?: ToolCodeExecution;
     /** Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. This field is not supported in Gemini API. */
     enterpriseWebSearch?: EnterpriseWebSearch;
     /** Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided. */
     functionDeclarations?: FunctionDeclaration[];
-    /** Optional. GoogleMaps tool type. Tool to support Google Maps in Model. */
-    googleMaps?: GoogleMaps;
     /** Optional. Specialized retrieval tool that is powered by Google Search. */
     googleSearchRetrieval?: GoogleSearchRetrieval;
+    /** Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation. This field is not supported in Gemini API. */
+    parallelAiSearch?: ToolParallelAiSearch;
     /** Optional. Tool to support URL context retrieval. */
     urlContext?: UrlContext;
     /** Optional. MCP Servers to connect to. This field is not supported in Vertex AI. */
@@ -1101,7 +1106,15 @@ declare interface Tool {
 declare interface ToolCodeExecution {
 }
 
-/** The type of the data. */
+/** ParallelAiSearch tool type. A tool that uses the Parallel.ai search engine for grounding. This data type is not supported in Gemini API. */
+declare interface ToolParallelAiSearch {
+    /** Optional. The API key for ParallelAiSearch. If an API key is not provided, the system will attempt to verify access by checking for an active Parallel.ai subscription through the Google Cloud Marketplace. See https://docs.parallel.ai/search/search-quickstart for more details. */
+    apiKey?: string;
+    /** Optional. Custom configs for ParallelAiSearch. This field can be used to pass any parameter from the Parallel.ai Search API. See the Parallel.ai documentation for the full list of available parameters and their usage: https://docs.parallel.ai/api-reference/search-beta/search Currently only `source_policy`, `excerpts`, `max_results`, `mode`, `fetch_policy` can be set via this field. For example: { "source_policy": { "include_domains": ["google.com", "wikipedia.org"], "exclude_domains": ["example.com"] }, "fetch_policy": { "max_age_seconds": 3600 } } */
+    customConfigs?: Record<string, unknown>;
+}
+
+/** Data type of the schema field. */
 declare enum Type {
     /**
      * Not specified, should not be used.
@@ -1187,11 +1200,11 @@ declare interface VertexRagStoreRagResource {
     ragFileIds?: string[];
 }
 
-/** Metadata describes the input video content. */
+/** Provides metadata for a video, including the start and end offsets for clipping and the frame rate. */
 declare interface VideoMetadata {
     /** Optional. The end offset of the video. */
     endOffset?: string;
-    /** Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0]. */
+    /** Optional. The frame rate of the video sent to the model. If not specified, the default value is 1.0. The valid range is (0.0, 24.0]. */
     fps?: number;
     /** Optional. The start offset of the video. */
     startOffset?: string;
@@ -1200,7 +1213,7 @@ declare interface VideoMetadata {
 declare interface VoiceConfig {
     /** If true, the model will use a replicated voice for the response. */
     replicatedVoiceConfig?: ReplicatedVoiceConfig;
-    /** The configuration for the prebuilt voice to use. */
+    /** The configuration for a prebuilt voice. */
     prebuiltVoiceConfig?: PrebuiltVoiceConfig;
 }