@google/genai 1.26.0 → 1.28.0

package/dist/genai.d.ts

@@ -32,7 +32,7 @@ export declare enum ActivityHandling {
 export declare interface ActivityStart {
 }
 
-/** Optional. Adapter size for tuning. */
+/** Adapter size for tuning. This enum is not supported in Gemini API. */
 export declare enum AdapterSize {
     /**
      * Adapter size is unspecified.
@@ -64,13 +64,13 @@ export declare enum AdapterSize {
     ADAPTER_SIZE_THIRTY_TWO = "ADAPTER_SIZE_THIRTY_TWO"
 }
 
-/** The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. */
+/** The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. This data type is not supported in Gemini API. */
 export declare interface ApiAuth {
     /** The API secret. */
     apiKeyConfig?: ApiAuthApiKeyConfig;
 }
 
-/** The API secret. */
+/** The API secret. This data type is not supported in Gemini API. */
 export declare interface ApiAuthApiKeyConfig {
     /** Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version} */
     apiKeySecretVersion?: string;
@@ -114,13 +114,13 @@ declare class ApiClient {
     setBaseUrl(url: string): void;
     private constructUrl;
     private shouldPrependVertexProjectPath;
-    request(request: HttpRequest): Promise<HttpResponse>;
+    request(request: HttpRequest): Promise<types.HttpResponse>;
     private patchHttpOptions;
-    requestStream(request: HttpRequest): Promise<AsyncGenerator<HttpResponse>>;
+    requestStream(request: HttpRequest): Promise<AsyncGenerator<types.HttpResponse>>;
     private includeExtraHttpOptionsToRequestInit;
     private unaryApiCall;
     private streamApiCall;
-    processStreamResponse(response: Response): AsyncGenerator<HttpResponse>;
+    processStreamResponse(response: Response): AsyncGenerator<types.HttpResponse>;
     private apiCall;
     getDefaultHeaders(): Record<string, string>;
     private getHeadersInternal;
@@ -130,19 +130,19 @@ declare class ApiClient {
      *
      * @param file The string path to the file to be uploaded or a Blob object.
      * @param config Optional parameters specified in the `UploadFileConfig`
-     *     interface. @see {@link UploadFileConfig}
+     *     interface. @see {@link types.UploadFileConfig}
      * @return A promise that resolves to a `File` object.
      * @throws An error if called on a Vertex AI client.
      * @throws An error if the `mimeType` is not provided and can not be inferred,
      */
-    uploadFile(file: string | Blob, config?: UploadFileConfig): Promise<File_2>;
+    uploadFile(file: string | Blob, config?: types.UploadFileConfig): Promise<types.File>;
     /**
      * Downloads a file asynchronously to the specified path.
      *
      * @params params - The parameters for the download request, see {@link
-     * DownloadFileParameters}
+     * types.DownloadFileParameters}
      */
-    downloadFile(params: DownloadFileParameters): Promise<void>;
+    downloadFile(params: types.DownloadFileParameters): Promise<void>;
     private fetchUploadUrl;
 }
 
@@ -195,7 +195,7 @@ declare interface ApiClientInitOptions {
     /**
      * Optional. A set of customizable configuration for HTTP requests.
      */
-    httpOptions?: HttpOptions;
+    httpOptions?: types.HttpOptions;
     /**
      * Optional. An extra string to append at the end of the User-Agent header.
      *
@@ -234,7 +234,7 @@ export declare interface ApiKeyConfig {
     apiKeyString?: string;
 }
 
-/** The API spec that the external API implements. */
+/** The API spec that the external API implements. This enum is not supported in Gemini API. */
 export declare enum ApiSpec {
     /**
      * Unspecified API spec. This value should not be used.
@@ -278,8 +278,9 @@ declare interface Auth {
      * Sets the headers needed to authenticate with the API service.
      *
      * @param headers - The Headers object that will be updated with the authentication headers.
+     * @param url - The URL of the request.
      */
-    addAuthHeaders(headers: Headers): Promise<void>;
+    addAuthHeaders(headers: Headers, url?: string): Promise<void>;
 }
 
 /** Auth configuration to run the extension. */
@@ -298,19 +299,19 @@ export declare interface AuthConfig {
     oidcConfig?: AuthConfigOidcConfig;
 }
 
-/** Config for Google Service Account Authentication. */
+/** Config for Google Service Account Authentication. This data type is not supported in Gemini API. */
 export declare interface AuthConfigGoogleServiceAccountConfig {
     /** Optional. The service account that the extension execution service runs as. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified service account. - If not specified, the Vertex AI Extension Service Agent will be used to execute the Extension. */
     serviceAccount?: string;
 }
 
-/** Config for HTTP Basic Authentication. */
+/** Config for HTTP Basic Authentication. This data type is not supported in Gemini API. */
 export declare interface AuthConfigHttpBasicAuthConfig {
     /** Required. The name of the SecretManager secret version resource storing the base64 encoded credentials. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. */
     credentialSecret?: string;
 }
 
-/** Config for user oauth. */
+/** Config for user oauth. This data type is not supported in Gemini API. */
 export declare interface AuthConfigOauthConfig {
     /** Access token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. */
     accessToken?: string;
@@ -318,7 +319,7 @@ export declare interface AuthConfigOauthConfig {
     serviceAccount?: string;
 }
 
-/** Config for user OIDC auth. */
+/** Config for user OIDC auth. This data type is not supported in Gemini API. */
 export declare interface AuthConfigOidcConfig {
     /** OpenID Connect formatted ID token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. */
     idToken?: string;
@@ -332,7 +333,7 @@ export declare interface AuthToken {
     name?: string;
 }
 
-/** Type of auth scheme. */
+/** Type of auth scheme. This enum is not supported in Gemini API. */
 export declare enum AuthType {
     AUTH_TYPE_UNSPECIFIED = "AUTH_TYPE_UNSPECIFIED",
     /**
@@ -634,11 +635,11 @@ export declare enum Behavior {
 
 /** Content blob. */
 declare interface Blob_2 {
-    /** Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is not currently used in the Gemini GenerateContent calls. */
-    displayName?: string;
     /** Required. Raw bytes.
      * @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. */
+    displayName?: string;
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
 }
@@ -673,11 +674,11 @@ export declare enum BlockedReason {
      */
     IMAGE_SAFETY = "IMAGE_SAFETY",
     /**
-     * The prompt was blocked by Model Armor.
+     * The prompt was blocked by Model Armor. This enum value is not supported in Gemini API.
      */
     MODEL_ARMOR = "MODEL_ARMOR",
     /**
-     * The prompt was blocked as a jailbreak attempt.
+     * The prompt was blocked as a jailbreak attempt. This enum value is not supported in Gemini API.
      */
     JAILBREAK = "JAILBREAK"
 }
@@ -702,15 +703,15 @@ export declare interface CachedContent {
 
 /** Metadata on the usage of the cached content. */
 export declare interface CachedContentUsageMetadata {
-    /** Duration of audio in seconds. */
+    /** Duration of audio in seconds. This field is not supported in Gemini API. */
     audioDurationSeconds?: number;
-    /** Number of images. */
+    /** Number of images. This field is not supported in Gemini API. */
     imageCount?: number;
-    /** Number of text characters. */
+    /** Number of text characters. This field is not supported in Gemini API. */
     textCount?: number;
     /** Total number of tokens that the cached content consumes. */
     totalTokenCount?: number;
-    /** Duration of video in seconds. */
+    /** Duration of video in seconds. This field is not supported in Gemini API. */
     videoDurationSeconds?: number;
 }
 
@@ -895,8 +896,6 @@ export declare interface Candidate {
      If empty, the model has not stopped generating the tokens.
      */
     finishReason?: FinishReason;
-    /** Metadata related to url context retrieval tool. */
-    urlContextMetadata?: UrlContextMetadata;
     /** Output only. Average log probability score of the candidate. */
     avgLogprobs?: number;
     /** Output only. Metadata specifies sources used to ground generated content. */
@@ -907,6 +906,8 @@ export declare interface Candidate {
     logprobsResult?: LogprobsResult;
     /** Output only. List of ratings for the safety of a response candidate. There is at most one rating per category. */
     safetyRatings?: SafetyRating[];
+    /** Output only. Metadata related to url context retrieval tool. */
+    urlContextMetadata?: UrlContextMetadata;
 }
 
 /**
@@ -1041,7 +1042,7 @@ export declare interface Checkpoint {
     step?: string;
 }
 
-/** Source attributions for content. */
+/** Source attributions for content. This data type is not supported in Gemini API. */
 export declare interface Citation {
     /** Output only. End index into the content. */
     endIndex?: number;
@@ -1124,9 +1125,7 @@ export 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
-     empty. If role is not specified, SDK will determine the role. */
+    /** 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. */
     role?: string;
 }
 
@@ -1527,7 +1526,7 @@ export declare function createPartFromText(text: string): Part;
  */
 export declare function createPartFromUri(uri: string, mimeType: string): Part;
 
-/** Supervised fine-tuning job creation request - optional fields. */
+/** Fine-tuning job creation request - optional fields. */
 export declare interface CreateTuningJobConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
@@ -1538,7 +1537,9 @@ export declare interface CreateTuningJobConfig {
      be charged usage for any applicable operations.
      */
     abortSignal?: AbortSignal;
-    /** Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
+    /** The method to use for tuning (SUPERVISED_FINE_TUNING or PREFERENCE_TUNING). If not set, the default method (SFT) will be used. */
+    method?: TuningMethod;
+    /** Validation dataset for tuning. The dataset must be formatted as a JSONL file. */
     validationDataset?: TuningValidationDataset;
     /** The display name of the tuned Model. The name can be up to 128 characters long and can consist of any UTF-8 characters. */
     tunedModelDisplayName?: string;
@@ -1548,7 +1549,7 @@ export declare interface CreateTuningJobConfig {
     epochCount?: number;
     /** Multiplier for adjusting the default learning rate. */
     learningRateMultiplier?: number;
-    /** If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. */
+    /** If set to true, disable intermediate checkpoints and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints. */
     exportLastCheckpointOnly?: boolean;
     /** The optional checkpoint id of the pre-tuned model to use for tuning, if applicable. */
     preTunedModelCheckpointId?: string;
@@ -1560,9 +1561,11 @@ export declare interface CreateTuningJobConfig {
     learningRate?: number;
     /** Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. */
     labels?: Record<string, string>;
+    /** Weight for KL Divergence regularization, Preference Optimization tuning only. */
+    beta?: number;
 }
 
-/** Supervised fine-tuning job creation parameters - optional fields. */
+/** Fine-tuning job creation parameters - optional fields. */
 export declare interface CreateTuningJobParameters {
     /** The base model that is being tuned, e.g., "gemini-2.5-flash". */
     baseModel: string;
@@ -1572,7 +1575,7 @@ export declare interface CreateTuningJobParameters {
     config?: CreateTuningJobConfig;
 }
 
-/** Supervised fine-tuning job creation parameters - optional fields. */
+/** Fine-tuning job creation parameters - optional fields. */
 export declare interface CreateTuningJobParametersPrivate {
     /** The base model that is being tuned, e.g., "gemini-2.5-flash". */
     baseModel?: string;
@@ -1589,7 +1592,7 @@ export declare interface CreateTuningJobParametersPrivate {
  */
 export declare function createUserContent(partOrString: PartListUnion | string): Content;
 
-/** Distribution computed over a tuning dataset. */
+/** Distribution computed over a tuning dataset. This data type is not supported in Gemini API. */
 export declare interface DatasetDistribution {
     /** Output only. Defines the histogram bucket. */
     buckets?: DatasetDistributionDistributionBucket[];
@@ -1609,7 +1612,7 @@ export declare interface DatasetDistribution {
     sum?: number;
 }
 
-/** Dataset bucket used to create a histogram for the distribution given a population of values. */
+/** Dataset bucket used to create a histogram for the distribution given a population of values. This data type is not supported in Gemini API. */
 export declare interface DatasetDistributionDistributionBucket {
     /** Output only. Number of values in the bucket. */
     count?: string;
@@ -1619,7 +1622,7 @@ export declare interface DatasetDistributionDistributionBucket {
     right?: number;
 }
 
-/** Statistics computed over a tuning dataset. */
+/** Statistics computed over a tuning dataset. This data type is not supported in Gemini API. */
 export declare interface DatasetStats {
     /** Output only. Number of billable characters in the tuning dataset. */
     totalBillableCharacterCount?: string;
@@ -1753,7 +1756,7 @@ export declare interface DeleteResourceJob {
     error?: JobError;
 }
 
-/** Statistics computed for datasets used for distillation. */
+/** Statistics computed for datasets used for distillation. This data type is not supported in Gemini API. */
 export declare interface DistillationDataStats {
     /** Output only. Statistics computed for the training dataset. */
     trainingDatasetStats?: DatasetStats;
@@ -1990,7 +1993,7 @@ export declare interface EmbeddingsBatchJobSource {
     inlinedRequests?: EmbedContentBatch;
 }
 
-/** Represents a customer-managed encryption key spec that can be applied to a top-level resource. */
+/** Represents a customer-managed encryption key spec that can be applied to a top-level resource. This data type is not supported in Gemini API. */
 export declare interface EncryptionSpec {
     /** Required. The Cloud KMS resource identifier of the customer managed encryption key used to protect a resource. Has the form: `projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key`. The key needs to be in the same region as where the compute resource is created. */
     kmsKeyName?: string;
@@ -2020,7 +2023,7 @@ export declare enum EndSensitivity {
     END_SENSITIVITY_LOW = "END_SENSITIVITY_LOW"
 }
 
-/** Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. */
+/** Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. This data type is not supported in Gemini API. */
 export declare interface EnterpriseWebSearch {
     /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. */
     excludeDomains?: string[];
@@ -2054,7 +2057,7 @@ export declare interface ExecutableCode {
     language?: Language;
 }
 
-/** 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. */
+/** 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. */
 export declare interface ExternalApi {
     /** The authentication config to access the API. Deprecated. Please use auth_config instead. */
     apiAuth?: ApiAuth;
@@ -2070,7 +2073,7 @@ export declare interface ExternalApi {
     simpleSearchParams?: ExternalApiSimpleSearchParams;
 }
 
-/** The search parameters to use for the ELASTIC_SEARCH spec. */
+/** The search parameters to use for the ELASTIC_SEARCH spec. This data type is not supported in Gemini API. */
 export declare interface ExternalApiElasticSearchParams {
     /** The ElasticSearch index to use. */
     index?: string;
@@ -2080,7 +2083,7 @@ export declare interface ExternalApiElasticSearchParams {
     searchTemplate?: string;
 }
 
-/** The search parameters to use for SIMPLE_SEARCH spec. */
+/** The search parameters to use for SIMPLE_SEARCH spec. This data type is not supported in Gemini API. */
 export declare interface ExternalApiSimpleSearchParams {
 }
 
@@ -2148,7 +2151,7 @@ export { File_2 as File }
 
 /** URI based data. */
 export declare interface FileData {
-    /** Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. It is not currently used in the Gemini GenerateContent calls. */
+    /** 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. */
     displayName?: string;
     /** Required. URI. */
     fileUri?: string;
@@ -2517,7 +2520,7 @@ export declare enum FunctionResponseScheduling {
     INTERRUPT = "INTERRUPT"
 }
 
-/** Input example for preference optimization. */
+/** Input example for preference optimization. This data type is not supported in Gemini API. */
 export declare interface GeminiPreferenceExample {
     /** List of completions for a given prompt. */
     completions?: GeminiPreferenceExampleCompletion[];
@@ -2525,7 +2528,7 @@ export declare interface GeminiPreferenceExample {
     contents?: Content[];
 }
 
-/** Completion and its preference score. */
+/** Completion and its preference score. This data type is not supported in Gemini API. */
 export declare interface GeminiPreferenceExampleCompletion {
     /** Single turn completion for the given prompt. */
     completion?: Content;
@@ -2851,13 +2854,13 @@ export declare class GenerateContentResponse {
 export declare class GenerateContentResponsePromptFeedback {
     /** Output only. The reason why the prompt was blocked. */
     blockReason?: BlockedReason;
-    /** Output only. A readable message that explains the reason why the prompt was blocked. */
+    /** Output only. A readable message that explains the reason why the prompt was blocked. This field is not supported in Gemini API. */
     blockReasonMessage?: string;
     /** Output only. A list of safety ratings for the prompt. There is one rating per category. */
     safetyRatings?: SafetyRating[];
 }
 
-/** Usage metadata about response(s). */
+/** Usage metadata about response(s). This data type is not supported in Gemini API. */
 export declare class GenerateContentResponseUsageMetadata {
     /** Output only. List of modalities of the cached content in the request input. */
     cacheTokensDetails?: ModalityTokenCount[];
@@ -3117,11 +3120,11 @@ export declare interface GenerateVideosSource {
 export declare interface GenerationConfig {
     /** Optional. Config for model selection. */
     modelSelectionConfig?: ModelSelectionConfig;
-    /** Optional. If enabled, audio timestamp will be included in the request to the model. */
+    /** Optional. If enabled, audio timestamp will be included in the request to the model. This field is not supported in Gemini API. */
     audioTimestamp?: boolean;
     /** Optional. Number of candidates to generate. */
     candidateCount?: number;
-    /** Optional. If enabled, the model will detect emotions and adapt its responses accordingly. */
+    /** Optional. If enabled, the model will detect emotions and adapt its responses accordingly. This field is not supported in Gemini API. */
     enableAffectiveDialog?: boolean;
     /** Optional. Frequency penalties. */
     frequencyPenalty?: number;
@@ -3143,7 +3146,7 @@ export declare interface GenerationConfig {
     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. */
     responseSchema?: Schema;
-    /** Optional. Routing configuration. */
+    /** Optional. Routing configuration. This field is not supported in Gemini API. */
     routingConfig?: GenerationConfigRoutingConfig;
     /** Optional. Seed. */
     seed?: number;
@@ -3159,11 +3162,11 @@ export declare interface GenerationConfig {
     topK?: number;
     /** Optional. If specified, nucleus sampling will be used. */
     topP?: number;
-    /** Optional. Enables enhanced civic answers. It may not be available for all models. */
+    /** 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. */
+/** The configuration for routing the request to a specific model. This data type is not supported in Gemini API. */
 export declare interface GenerationConfigRoutingConfig {
     /** Automated routing. */
     autoMode?: GenerationConfigRoutingConfigAutoRoutingMode;
@@ -3171,13 +3174,13 @@ export declare interface GenerationConfigRoutingConfig {
     manualMode?: GenerationConfigRoutingConfigManualRoutingMode;
 }
 
-/** When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference. */
+/** 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. */
 export 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. */
+/** When manual routing is set, the specified model will be used directly. This data type is not supported in Gemini API. */
 export 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). */
     modelName?: string;
@@ -3436,7 +3439,7 @@ export declare interface GoogleMaps {
     enableWidget?: boolean;
 }
 
-/** The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). */
+/** The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). This data type is not supported in Gemini API. */
 export declare interface GoogleRpcStatus {
     /** The status code, which should be an enum value of google.rpc.Code. */
     code?: number;
@@ -3446,14 +3449,12 @@ export declare interface GoogleRpcStatus {
     message?: string;
 }
 
-/** Tool to support Google Search in Model. Powered by Google. */
+/** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
 export declare interface GoogleSearch {
-    /** Optional. Filter search results to a specific time range.
-     If customers set a start time, they must set an end time (and vice versa).
-     */
-    timeRangeFilter?: Interval;
-    /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. */
+    /** 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;
 }
 
 /** Tool to retrieve public web data for grounding, powered by Google. */
@@ -3462,7 +3463,7 @@ export declare interface GoogleSearchRetrieval {
     dynamicRetrievalConfig?: DynamicRetrievalConfig;
 }
 
-/** Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp */
+/** Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp. This data type is not supported in Gemini API. */
 export declare interface GoogleTypeDate {
     /** Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. */
     day?: number;
@@ -3474,15 +3475,15 @@ export declare interface GoogleTypeDate {
 
 /** Grounding chunk. */
 export declare interface GroundingChunk {
-    /** Grounding chunk from Google Maps. */
+    /** Grounding chunk from Google Maps. This field is not supported in Gemini API. */
     maps?: GroundingChunkMaps;
-    /** Grounding chunk from context retrieved by the retrieval tools. */
+    /** Grounding chunk from context retrieved by the retrieval tools. This field is not supported in Gemini API. */
     retrievedContext?: GroundingChunkRetrievedContext;
     /** Grounding chunk from the web. */
     web?: GroundingChunkWeb;
 }
 
-/** Chunk from Google Maps. */
+/** Chunk from Google Maps. This data type is not supported in Gemini API. */
 export declare interface GroundingChunkMaps {
     /** Sources used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as uris to flag content. */
     placeAnswerSources?: GroundingChunkMapsPlaceAnswerSources;
@@ -3496,7 +3497,7 @@ export declare interface GroundingChunkMaps {
     uri?: string;
 }
 
-/** Sources used to generate the place answer. */
+/** Sources used to generate the place answer. This data type is not supported in Gemini API. */
 export declare interface GroundingChunkMapsPlaceAnswerSources {
     /** A link where users can flag a problem with the generated answer. */
     flagContentUri?: string;
@@ -3504,7 +3505,7 @@ export declare interface GroundingChunkMapsPlaceAnswerSources {
     reviewSnippets?: GroundingChunkMapsPlaceAnswerSourcesReviewSnippet[];
 }
 
-/** Author attribution for a photo or review. */
+/** Author attribution for a photo or review. This data type is not supported in Gemini API. */
 export declare interface GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution {
     /** Name of the author of the Photo or Review. */
     displayName?: string;
@@ -3514,7 +3515,7 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution {
     uri?: string;
 }
 
-/** Encapsulates a review snippet. */
+/** Encapsulates a review snippet. This data type is not supported in Gemini API. */
 export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
     /** This review's author. */
     authorAttribution?: GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution;
@@ -3532,7 +3533,7 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
     title?: string;
 }
 
-/** Chunk from context retrieved by the retrieval tools. */
+/** Chunk from context retrieved by the retrieval tools. This data type is not supported in Gemini API. */
 export declare interface GroundingChunkRetrievedContext {
     /** Output only. The full document name for the referenced Vertex AI Search document. */
     documentName?: string;
@@ -3548,7 +3549,7 @@ export declare interface GroundingChunkRetrievedContext {
 
 /** Chunk from the web. */
 export declare interface GroundingChunkWeb {
-    /** Domain of the (original) URI. */
+    /** Domain of the (original) URI. This field is not supported in Gemini API. */
     domain?: string;
     /** Title of the chunk. */
     title?: string;
@@ -3558,7 +3559,7 @@ export declare interface GroundingChunkWeb {
 
 /** Metadata returned to client when grounding is enabled. */
 export declare interface GroundingMetadata {
-    /** Optional. Output only. Resource name of the Google Maps widget context token to be used with the PlacesContextElement widget to render contextual data. This is populated only for Google Maps grounding. */
+    /** Optional. Output only. Resource name of the Google Maps widget context token to be used with the PlacesContextElement widget to render contextual data. This is populated only for Google Maps grounding. This field is not supported in Gemini API. */
     googleMapsWidgetContextToken?: string;
     /** List of supporting references retrieved from specified grounding source. */
     groundingChunks?: GroundingChunk[];
@@ -3566,17 +3567,17 @@ export declare interface GroundingMetadata {
     groundingSupports?: GroundingSupport[];
     /** Optional. Output only. Retrieval metadata. */
     retrievalMetadata?: RetrievalMetadata;
-    /** Optional. Queries executed by the retrieval tools. */
+    /** Optional. Queries executed by the retrieval tools. This field is not supported in Gemini API. */
     retrievalQueries?: string[];
     /** Optional. Google search entry for the following-up web searches. */
     searchEntryPoint?: SearchEntryPoint;
-    /** Optional. Output only. List of source flagging uris. This is currently populated only for Google Maps grounding. */
+    /** Optional. Output only. List of source flagging uris. This is currently populated only for Google Maps grounding. This field is not supported in Gemini API. */
     sourceFlaggingUris?: GroundingMetadataSourceFlaggingUri[];
     /** Optional. Web search queries for the following-up web search. */
     webSearchQueries?: string[];
 }
 
-/** Source content flagging uri for a place or review. This is currently populated only for Google Maps grounding. */
+/** Source content flagging uri for a place or review. This is currently populated only for Google Maps grounding. This data type is not supported in Gemini API. */
 export declare interface GroundingMetadataSourceFlaggingUri {
     /** A link where users can flag a problem with the source (place or review). */
     flagContentUri?: string;
@@ -3594,7 +3595,7 @@ export declare interface GroundingSupport {
     segment?: Segment;
 }
 
-/** Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. */
+/** Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. This enum is not supported in Gemini API. */
 export declare enum HarmBlockMethod {
     /**
      * The harm block method is unspecified.
@@ -3610,7 +3611,7 @@ export declare enum HarmBlockMethod {
     PROBABILITY = "PROBABILITY"
 }
 
-/** Required. The harm block threshold. */
+/** The harm block threshold. */
 export declare enum HarmBlockThreshold {
     /**
      * Unspecified harm block threshold.
@@ -3638,7 +3639,7 @@ export declare enum HarmBlockThreshold {
     OFF = "OFF"
 }
 
-/** Required. Harm category. */
+/** Harm category. */
 export declare enum HarmCategory {
     /**
      * The harm category is unspecified.
@@ -3665,23 +3666,23 @@ export declare enum HarmCategory {
      */
     HARM_CATEGORY_CIVIC_INTEGRITY = "HARM_CATEGORY_CIVIC_INTEGRITY",
     /**
-     * The harm category is image hate.
+     * The harm category is image hate. This enum value is not supported in Gemini API.
      */
     HARM_CATEGORY_IMAGE_HATE = "HARM_CATEGORY_IMAGE_HATE",
     /**
-     * The harm category is image dangerous content.
+     * The harm category is image dangerous content. This enum value is not supported in Gemini API.
      */
     HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT = "HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT",
     /**
-     * The harm category is image harassment.
+     * The harm category is image harassment. This enum value is not supported in Gemini API.
      */
     HARM_CATEGORY_IMAGE_HARASSMENT = "HARM_CATEGORY_IMAGE_HARASSMENT",
     /**
-     * The harm category is image sexually explicit content.
+     * The harm category is image sexually explicit content. This enum value is not supported in Gemini API.
      */
     HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT = "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT",
     /**
-     * The harm category is for jailbreak prompts.
+     * The harm category is for jailbreak prompts. This enum value is not supported in Gemini API.
      */
     HARM_CATEGORY_JAILBREAK = "HARM_CATEGORY_JAILBREAK"
 }
@@ -3710,7 +3711,7 @@ export declare enum HarmProbability {
     HIGH = "HIGH"
 }
 
-/** Output only. Harm severity levels in the content. */
+/** Output only. Harm severity levels in the content. This enum is not supported in Gemini API. */
 export declare enum HarmSeverity {
     /**
      * Harm severity unspecified.
@@ -3793,7 +3794,7 @@ declare interface HttpRequest {
     /**
      * Optional set of customizable configuration for HTTP requests.
      */
-    httpOptions?: HttpOptions;
+    httpOptions?: types.HttpOptions;
     /**
      * Optional abort signal which can be used to cancel the request.
      */
@@ -3904,17 +3905,12 @@ export declare class InlinedResponse {
     error?: JobError;
 }
 
-/** Represents a time interval, encoded as a start time (inclusive) and an end time (exclusive).
-
- The start time must be less than or equal to the end time.
- When the start equals the end time, the interval is an empty interval.
- (matches no time)
- When both start and end are unspecified, the interval matches any time. */
+/** Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. */
 export declare interface Interval {
-    /** The start time of the interval. */
-    startTime?: string;
-    /** The end time of the interval. */
+    /** Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end. */
     endTime?: string;
+    /** Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start. */
+    startTime?: string;
 }
 
 /** Job error. */
@@ -3979,7 +3975,7 @@ export declare enum JobState {
     JOB_STATE_PARTIALLY_SUCCEEDED = "JOB_STATE_PARTIALLY_SUCCEEDED"
 }
 
-/** Required. Programming language of the `code`. */
+/** Programming language of the `code`. */
 export declare enum Language {
     /**
      * Unspecified language. This value should not be used.
@@ -5488,9 +5484,9 @@ export declare interface ModelSelectionConfig {
     featureSelectionPreference?: FeatureSelectionPreference;
 }
 
-/** The configuration for the multi-speaker setup. */
+/** The configuration for the multi-speaker setup. This data type is not supported in Vertex AI. */
 export declare interface MultiSpeakerVoiceConfig {
-    /** The configuration for the speaker to use. */
+    /** Required. All the enabled speaker voices. */
     speakerVoiceConfigs?: SpeakerVoiceConfig[];
 }
 
@@ -5573,7 +5569,7 @@ export declare class Operations extends BaseModule {
     private fetchPredictVideosOperationInternal;
 }
 
-/** Required. Outcome of the code execution. */
+/** Outcome of the code execution. */
 export declare enum Outcome {
     /**
      * Unspecified status. This value should not be used.
@@ -5598,10 +5594,13 @@ export declare enum PagedItem {
     PAGED_ITEM_MODELS = "models",
     PAGED_ITEM_TUNING_JOBS = "tuningJobs",
     PAGED_ITEM_FILES = "files",
-    PAGED_ITEM_CACHED_CONTENTS = "cachedContents"
+    PAGED_ITEM_CACHED_CONTENTS = "cachedContents",
+    PAGED_ITEM_RAG_STORES = "ragStores",
+    PAGED_ITEM_DOCUMENTS = "documents"
 }
 
 declare interface PagedItemConfig {
+    parent?: string;
     config?: {
         pageToken?: string;
         pageSize?: number;
@@ -5616,6 +5615,8 @@ declare interface PagedItemResponse<T> {
     tuningJobs?: T[];
     files?: T[];
     cachedContents?: T[];
+    ragStores?: T[];
+    documents?: T[];
 }
 
 /**
@@ -5724,17 +5725,6 @@ export declare class Pager<T> implements AsyncIterable<T> {
  of content being conveyed. Using multiple fields within the same `Part`
  instance is considered invalid. */
 export declare interface Part {
-    /** Metadata for a given video. */
-    videoMetadata?: VideoMetadata;
-    /** Indicates if the part is thought from the model. */
-    thought?: boolean;
-    /** Optional. Inlined bytes data. */
-    inlineData?: Blob_2;
-    /** Optional. URI based data. */
-    fileData?: FileData;
-    /** An opaque signature for the thought so it can be reused in subsequent requests.
-     * @remarks Encoded as base64 string. */
-    thoughtSignature?: string;
     /** A predicted [FunctionCall] returned from the model that contains a string
      representing the [FunctionDeclaration.name] and a structured JSON object
      containing the parameters and their values. */
@@ -5743,15 +5733,26 @@ export declare interface Part {
     codeExecutionResult?: CodeExecutionResult;
     /** Optional. Code generated by the model that is meant to be executed. */
     executableCode?: ExecutableCode;
+    /** Optional. URI based data. */
+    fileData?: FileData;
     /** 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. */
     functionResponse?: FunctionResponse;
+    /** Optional. Inlined bytes data. */
+    inlineData?: Blob_2;
     /** Optional. Text part (can be code). */
     text?: string;
+    /** Optional. Indicates if the part is thought from the model. */
+    thought?: boolean;
+    /** Optional. An opaque signature for the thought so it can be reused in subsequent requests.
+     * @remarks Encoded as base64 string. */
+    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;
 }
 
 export declare type PartListUnion = PartUnion[] | PartUnion;
 
-/** Tuning spec for Partner models. */
+/** Tuning spec for Partner models. This data type is not supported in Gemini API. */
 export declare interface PartnerModelTuningSpec {
     /** Hyperparameters for tuning. The accepted hyper_parameters and their valid range of values will differ depending on the base model. */
     hyperParameters?: Record<string, unknown>;
@@ -5781,11 +5782,11 @@ export declare enum PersonGeneration {
 
 /** The configuration for the prebuilt speaker to use. */
 export declare interface PrebuiltVoiceConfig {
-    /** The name of the prebuilt voice to use. */
+    /** The name of the preset voice to use. */
     voiceName?: string;
 }
 
-/** Statistics computed for datasets used for preference optimization. */
+/** Statistics computed for datasets used for preference optimization. This data type is not supported in Gemini API. */
 export declare interface PreferenceOptimizationDataStats {
     /** Output only. Dataset distributions for scores variance per example. */
     scoreVariancePerExampleDistribution?: DatasetDistribution;
@@ -5805,7 +5806,29 @@ export declare interface PreferenceOptimizationDataStats {
     userOutputTokenDistribution?: DatasetDistribution;
 }
 
-/** A pre-tuned model for continuous tuning. */
+/** Hyperparameters for Preference Optimization. This data type is not supported in Gemini API. */
+export declare interface PreferenceOptimizationHyperParameters {
+    /** Optional. Adapter size for preference optimization. */
+    adapterSize?: AdapterSize;
+    /** Optional. Weight for KL Divergence regularization. */
+    beta?: number;
+    /** Optional. Number of complete passes the model makes over the entire training dataset during training. */
+    epochCount?: string;
+    /** Optional. Multiplier for adjusting the default learning rate. */
+    learningRateMultiplier?: number;
+}
+
+/** Preference optimization tuning spec for tuning. */
+export declare interface PreferenceOptimizationSpec {
+    /** Optional. Hyperparameters for Preference Optimization. */
+    hyperParameters?: PreferenceOptimizationHyperParameters;
+    /** Required. Cloud Storage path to file containing training dataset for preference optimization tuning. The dataset must be formatted as a JSONL file. */
+    trainingDatasetUri?: string;
+    /** Optional. Cloud Storage path to file containing validation dataset for preference optimization tuning. The dataset must be formatted as a JSONL file. */
+    validationDatasetUri?: string;
+}
+
+/** A pre-tuned model for continuous tuning. This data type is not supported in Gemini API. */
 export declare interface PreTunedModel {
     /** Output only. The name of the base model this PreTunedModel was tuned from. */
     baseModel?: string;
@@ -5829,7 +5852,7 @@ export declare interface ProductImage {
     productImage?: Image_2;
 }
 
-/** A RagChunk includes the content of a chunk of a RagFile, and associated metadata. */
+/** A RagChunk includes the content of a chunk of a RagFile, and associated metadata. This data type is not supported in Gemini API. */
 export declare interface RagChunk {
     /** If populated, represents where the chunk starts and ends in the document. */
     pageSpan?: RagChunkPageSpan;
@@ -5837,7 +5860,7 @@ export declare interface RagChunk {
     text?: string;
 }
 
-/** Represents where the chunk starts and ends in the document. */
+/** Represents where the chunk starts and ends in the document. This data type is not supported in Gemini API. */
 export declare interface RagChunkPageSpan {
     /** Page where chunk starts in the document. Inclusive. 1-indexed. */
     firstPage?: number;
@@ -5845,7 +5868,7 @@ export declare interface RagChunkPageSpan {
     lastPage?: number;
 }
 
-/** Specifies the context retrieval config. */
+/** Specifies the context retrieval config. This data type is not supported in Gemini API. */
 export declare interface RagRetrievalConfig {
     /** Optional. Config for filters. */
     filter?: RagRetrievalConfigFilter;
@@ -5857,7 +5880,7 @@ export declare interface RagRetrievalConfig {
     topK?: number;
 }
 
-/** Config for filters. */
+/** Config for filters. This data type is not supported in Gemini API. */
 export declare interface RagRetrievalConfigFilter {
     /** Optional. String for metadata filtering. */
     metadataFilter?: string;
@@ -5867,13 +5890,13 @@ export declare interface RagRetrievalConfigFilter {
     vectorSimilarityThreshold?: number;
 }
 
-/** Config for Hybrid Search. */
+/** Config for Hybrid Search. This data type is not supported in Gemini API. */
 export declare interface RagRetrievalConfigHybridSearch {
     /** Optional. Alpha value controls the weight between dense and sparse vector search results. The range is [0, 1], while 0 means sparse vector search only and 1 means dense vector search only. The default value is 0.5 which balances sparse and dense vector search equally. */
     alpha?: number;
 }
 
-/** Config for ranking and reranking. */
+/** Config for ranking and reranking. This data type is not supported in Gemini API. */
 export declare interface RagRetrievalConfigRanking {
     /** Optional. Config for LlmRanker. */
     llmRanker?: RagRetrievalConfigRankingLlmRanker;
@@ -5881,13 +5904,13 @@ export declare interface RagRetrievalConfigRanking {
     rankService?: RagRetrievalConfigRankingRankService;
 }
 
-/** Config for LlmRanker. */
+/** Config for LlmRanker. This data type is not supported in Gemini API. */
 export declare interface RagRetrievalConfigRankingLlmRanker {
     /** Optional. The model name used for ranking. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models). */
     modelName?: string;
 }
 
-/** Config for Rank Service. */
+/** Config for Rank Service. This data type is not supported in Gemini API. */
 export declare interface RagRetrievalConfigRankingRankService {
     /** Optional. The model name of the rank service. Format: `semantic-ranker-512@latest` */
     modelName?: string;
@@ -6037,7 +6060,7 @@ export declare class ReplayResponse {
     sdkResponseSegments?: Record<string, unknown>[];
 }
 
-/** Defines a retrieval tool that model can call to access external knowledge. */
+/** Defines a retrieval tool that model can call to access external knowledge. This data type is not supported in Gemini API. */
 export declare interface Retrieval {
     /** Optional. Deprecated. This option is no longer supported. */
     disableAttribution?: boolean;
@@ -6088,25 +6111,24 @@ export declare interface SafetyRating {
     blocked?: boolean;
     /** Output only. Harm category. */
     category?: HarmCategory;
-    /** Output only. The overwritten threshold for the safety category of Gemini 2.0 image out. If minors are detected in the output image, the threshold of each safety category will be overwritten if user sets a lower threshold. */
+    /** Output only. The overwritten threshold for the safety category of Gemini 2.0 image out. If minors are detected in the output image, the threshold of each safety category will be overwritten if user sets a lower threshold. This field is not supported in Gemini API. */
     overwrittenThreshold?: HarmBlockThreshold;
     /** Output only. Harm probability levels in the content. */
     probability?: HarmProbability;
-    /** Output only. Harm probability score. */
+    /** Output only. Harm probability score. This field is not supported in Gemini API. */
     probabilityScore?: number;
-    /** Output only. Harm severity levels in the content. */
+    /** Output only. Harm severity levels in the content. This field is not supported in Gemini API. */
     severity?: HarmSeverity;
-    /** Output only. Harm severity score. */
+    /** Output only. Harm severity score. This field is not supported in Gemini API. */
     severityScore?: number;
 }
 
 /** Safety settings. */
 export declare interface SafetySetting {
-    /** Determines if the harm block method uses probability or probability
-     and severity scores. */
-    method?: HarmBlockMethod;
     /** Required. Harm category. */
     category?: HarmCategory;
+    /** Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. This field is not supported in Gemini API. */
+    method?: HarmBlockMethod;
     /** Required. The harm block threshold. */
     threshold?: HarmBlockThreshold;
 }
@@ -6520,28 +6542,22 @@ export declare interface SlidingWindow {
     targetTokens?: string;
 }
 
-/** The configuration for the speaker to use. */
+/** The configuration for a single speaker in a multi speaker setup. This data type is not supported in Vertex AI. */
 export declare interface SpeakerVoiceConfig {
-    /** The name of the speaker to use. Should be the same as in the
-     prompt. */
+    /** Required. The name of the speaker to use. Should be the same as in the prompt. */
     speaker?: string;
-    /** The configuration for the voice to use. */
+    /** Required. The configuration for the voice to use. */
     voiceConfig?: VoiceConfig;
 }
 
-/** The speech generation configuration. */
+/** The speech generation config. */
 export declare interface SpeechConfig {
-    /** The configuration for the speaker to use.
-     */
+    /** Optional. Language code (ISO 639. e.g. en-US) for the speech synthesization. */
+    languageCode?: string;
+    /** The configuration for the speaker to use. */
     voiceConfig?: VoiceConfig;
-    /** The configuration for the multi-speaker setup.
-     It is mutually exclusive with the voice_config field.
-     */
+    /** Optional. The configuration for the multi-speaker setup. It is mutually exclusive with the voice_config field. This field is not supported in Vertex AI. */
     multiSpeakerVoiceConfig?: MultiSpeakerVoiceConfig;
-    /** Language code (ISO 639. e.g. en-US) for the speech synthesization.
-     Only available for Live API.
-     */
-    languageCode?: string;
 }
 
 export declare type SpeechConfigUnion = SpeechConfig | string;
@@ -6623,7 +6639,7 @@ export declare enum SubjectReferenceType {
     SUBJECT_TYPE_PRODUCT = "SUBJECT_TYPE_PRODUCT"
 }
 
-/** Hyperparameters for SFT. */
+/** Hyperparameters for SFT. This data type is not supported in Gemini API. */
 export declare interface SupervisedHyperParameters {
     /** Optional. Adapter size for tuning. */
     adapterSize?: AdapterSize;
@@ -6637,7 +6653,7 @@ export declare interface SupervisedHyperParameters {
     learningRateMultiplier?: number;
 }
 
-/** Dataset distribution for Supervised Tuning. */
+/** Dataset distribution for Supervised Tuning. This data type is not supported in Gemini API. */
 export declare interface SupervisedTuningDatasetDistribution {
     /** Output only. Sum of a given population of values that are billable. */
     billableSum?: string;
@@ -6659,7 +6675,7 @@ export declare interface SupervisedTuningDatasetDistribution {
     sum?: string;
 }
 
-/** Dataset bucket used to create a histogram for the distribution given a population of values. */
+/** Dataset bucket used to create a histogram for the distribution given a population of values. This data type is not supported in Gemini API. */
 export declare interface SupervisedTuningDatasetDistributionDatasetBucket {
     /** Output only. Number of values in the bucket. */
     count?: number;
@@ -6669,7 +6685,7 @@ export declare interface SupervisedTuningDatasetDistributionDatasetBucket {
     right?: number;
 }
 
-/** Tuning data statistics for Supervised Tuning. */
+/** Tuning data statistics for Supervised Tuning. This data type is not supported in Gemini API. */
 export declare interface SupervisedTuningDataStats {
     /** Output only. For each index in `truncated_example_indices`, the user-facing reason why the example was dropped. */
     droppedExampleReasons?: string[];
@@ -6697,7 +6713,7 @@ export declare interface SupervisedTuningDataStats {
     userOutputTokenDistribution?: SupervisedTuningDatasetDistribution;
 }
 
-/** Tuning Spec for Supervised Tuning for first party models. */
+/** Supervised tuning spec for tuning. */
 export declare interface SupervisedTuningSpec {
     /** Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false. */
     exportLastCheckpointOnly?: boolean;
@@ -6851,30 +6867,28 @@ export declare interface TokensInfo {
 export declare interface Tool {
     /** List of function declarations that the tool supports. */
     functionDeclarations?: FunctionDeclaration[];
-    /** Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. */
+    /** Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. This field is not supported in Gemini API. */
     retrieval?: Retrieval;
-    /** Optional. Google Search tool type. Specialized retrieval tool
-     that is powered by Google Search. */
-    googleSearch?: GoogleSearch;
     /** Optional. GoogleSearchRetrieval tool type. Specialized retrieval tool that is powered by Google search. */
     googleSearchRetrieval?: GoogleSearchRetrieval;
-    /** Optional. Enterprise web search tool type. Specialized retrieval
-     tool that is powered by Vertex AI Search and Sec4 compliance. */
-    enterpriseWebSearch?: EnterpriseWebSearch;
     /** Optional. Google Maps tool type. Specialized retrieval tool
      that is powered by Google Maps. */
     googleMaps?: GoogleMaps;
-    /** Optional. Tool to support URL context retrieval. */
-    urlContext?: UrlContext;
     /** Optional. Tool to support the model interacting directly with the
      computer. If enabled, it automatically populates computer-use specific
      Function Declarations. */
     computerUse?: ComputerUse;
     /** 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. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
+    googleSearch?: GoogleSearch;
+    /** Optional. Tool to support URL context retrieval. */
+    urlContext?: UrlContext;
 }
 
-/** 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. */
+/** 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. */
 export declare interface ToolCodeExecution {
 }
 
@@ -6892,7 +6906,7 @@ export declare type ToolListUnion = ToolUnion[];
 
 export declare type ToolUnion = Tool | CallableTool;
 
-/** Output only. Traffic type. This shows whether a request consumes Pay-As-You-Go or Provisioned Throughput quota. */
+/** Output only. Traffic type. This shows whether a request consumes Pay-As-You-Go or Provisioned Throughput quota. This enum is not supported in Gemini API. */
 export declare enum TrafficType {
     /**
      * Unspecified request traffic type.
@@ -6974,7 +6988,7 @@ export declare interface TuningDataset {
     examples?: TuningExample[];
 }
 
-/** The tuning data statistic values for TuningJob. */
+/** The tuning data statistic values for TuningJob. This data type is not supported in Gemini API. */
 export declare interface TuningDataStats {
     /** Output only. Statistics for distillation. */
     distillationDataStats?: DistillationDataStats;
@@ -6984,7 +6998,7 @@ export declare interface TuningDataStats {
     supervisedTuningDataStats?: SupervisedTuningDataStats;
 }
 
-/** A single example for tuning. */
+/** A single example for tuning. This data type is not supported in Vertex AI. */
 export declare interface TuningExample {
     /** Required. The expected model output. */
     output?: string;
@@ -7020,6 +7034,8 @@ export declare interface TuningJob {
     preTunedModel?: PreTunedModel;
     /** Tuning Spec for Supervised Fine Tuning. */
     supervisedTuningSpec?: SupervisedTuningSpec;
+    /** Tuning Spec for Preference Optimization. */
+    preferenceOptimizationSpec?: PreferenceOptimizationSpec;
     /** Output only. The tuning data statistics associated with this TuningJob. */
     tuningDataStats?: TuningDataStats;
     /** Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with the provided encryption key. */
@@ -7044,7 +7060,19 @@ export declare interface TuningJob {
     veoTuningSpec?: VeoTuningSpec;
 }
 
-/** Tuning mode. */
+/** Enum representing the tuning method. */
+export declare enum TuningMethod {
+    /**
+     * Supervised fine tuning.
+     */
+    SUPERVISED_FINE_TUNING = "SUPERVISED_FINE_TUNING",
+    /**
+     * Preference optimization tuning.
+     */
+    PREFERENCE_TUNING = "PREFERENCE_TUNING"
+}
+
+/** Tuning mode. This enum is not supported in Gemini API. */
 export declare enum TuningMode {
     /**
      * Tuning mode is unspecified.
@@ -7125,7 +7153,7 @@ declare class Tunings extends BaseModule {
     private tuneMldevInternal;
 }
 
-/** Optional. The tuning task. Either I2V or T2V. */
+/** The tuning task. Either I2V or T2V. This enum is not supported in Gemini API. */
 export declare enum TuningTask {
     /**
      * Default value. This value is unused.
@@ -7144,7 +7172,7 @@ export declare enum TuningTask {
 export declare interface TuningValidationDataset {
     /** GCS URI of the file containing validation dataset in JSONL format. */
     gcsUri?: string;
-    /** The resource name of the Vertex Multimodal Dataset that is used as training dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
+    /** The resource name of the Vertex Multimodal Dataset that is used as validation dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
     vertexDatasetResource?: string;
 }
 
@@ -7184,7 +7212,7 @@ export declare enum TurnCoverage {
     TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
 }
 
-/** Optional. The type of the data. */
+/** The type of the data. */
 export declare enum Type {
     /**
      * Not specified, should not be used.
@@ -7237,23 +7265,23 @@ declare namespace types {
         Language,
         FunctionResponseScheduling,
         Type,
-        HarmCategory,
-        HarmBlockMethod,
-        HarmBlockThreshold,
         Mode,
         AuthType,
         ApiSpec,
-        UrlRetrievalStatus,
+        HarmCategory,
+        HarmBlockMethod,
+        HarmBlockThreshold,
         FinishReason,
         HarmProbability,
         HarmSeverity,
+        UrlRetrievalStatus,
         BlockedReason,
         TrafficType,
         Modality,
         MediaResolution,
-        JobState,
         TuningMode,
         AdapterSize,
+        JobState,
         TuningTask,
         FeatureSelectionPreference,
         Behavior,
@@ -7271,6 +7299,7 @@ declare namespace types {
         VideoGenerationReferenceType,
         VideoGenerationMaskMode,
         VideoCompressionQuality,
+        TuningMethod,
         FileState,
         FileSource,
         TurnCompleteReason,
@@ -7282,28 +7311,24 @@ declare namespace types {
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
-        VideoMetadata,
-        Blob_2 as Blob,
-        FileData,
         FunctionCall,
         CodeExecutionResult,
         ExecutableCode,
+        FileData,
         FunctionResponseBlob,
         FunctionResponseFileData,
         FunctionResponsePart,
         FunctionResponse,
+        Blob_2 as Blob,
+        VideoMetadata,
         Part,
         Content,
         HttpOptions,
         Schema,
         ModelSelectionConfig,
-        SafetySetting,
         FunctionDeclaration,
-        Interval,
-        GoogleSearch,
         DynamicRetrievalConfig,
         GoogleSearchRetrieval,
-        EnterpriseWebSearch,
         ApiKeyConfig,
         AuthConfigGoogleServiceAccountConfig,
         AuthConfigHttpBasicAuthConfig,
@@ -7311,7 +7336,6 @@ declare namespace types {
         AuthConfigOidcConfig,
         AuthConfig,
         GoogleMaps,
-        UrlContext,
         ComputerUse,
         ApiAuthApiKeyConfig,
         ApiAuth,
@@ -7330,22 +7354,22 @@ declare namespace types {
         VertexRagStore,
         Retrieval,
         ToolCodeExecution,
+        EnterpriseWebSearch,
+        Interval,
+        GoogleSearch,
+        UrlContext,
         Tool,
         FunctionCallingConfig,
         LatLng,
         RetrievalConfig,
         ToolConfig,
-        PrebuiltVoiceConfig,
-        VoiceConfig,
-        SpeakerVoiceConfig,
-        MultiSpeakerVoiceConfig,
-        SpeechConfig,
         AutomaticFunctionCallingConfig,
         ThinkingConfig,
         ImageConfig,
         GenerationConfigRoutingConfigAutoRoutingMode,
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
+        SafetySetting,
         GenerateContentConfig,
         GenerateContentParameters,
         HttpResponse,
@@ -7353,8 +7377,6 @@ declare namespace types {
         GoogleTypeDate,
         Citation,
         CitationMetadata,
-        UrlMetadata,
-        UrlContextMetadata,
         GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
         GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
         GroundingChunkMapsPlaceAnswerSources,
@@ -7374,6 +7396,8 @@ declare namespace types {
         LogprobsResultTopCandidates,
         LogprobsResult,
         SafetyRating,
+        UrlMetadata,
+        UrlContextMetadata,
         Candidate,
         GenerateContentResponsePromptFeedback,
         ModalityTokenCount,
@@ -7426,6 +7450,11 @@ declare namespace types {
         DeleteModelConfig,
         DeleteModelParameters,
         DeleteModelResponse,
+        PrebuiltVoiceConfig,
+        VoiceConfig,
+        SpeakerVoiceConfig,
+        MultiSpeakerVoiceConfig,
+        SpeechConfig,
         GenerationConfig,
         CountTokensConfig,
         CountTokensParameters,
@@ -7448,10 +7477,12 @@ declare namespace types {
         GetTuningJobParameters,
         TunedModelCheckpoint,
         TunedModel,
-        GoogleRpcStatus,
-        PreTunedModel,
         SupervisedHyperParameters,
         SupervisedTuningSpec,
+        PreferenceOptimizationHyperParameters,
+        PreferenceOptimizationSpec,
+        GoogleRpcStatus,
+        PreTunedModel,
         DatasetDistributionDistributionBucket,
         DatasetDistribution,
         DatasetStats,
@@ -7737,6 +7768,10 @@ export declare interface UpscaleImageConfig {
     abortSignal?: AbortSignal;
     /** Cloud Storage URI used to store the generated images. */
     outputGcsUri?: string;
+    /** Filter level for safety filtering. */
+    safetyFilterLevel?: SafetyFilterLevel;
+    /** Allows generation of people by the model. */
+    personGeneration?: PersonGeneration;
     /** Whether to include a reason for filtered-out images in the
      response. */
     includeRaiReason?: boolean;
@@ -7777,19 +7812,19 @@ export declare class UpscaleImageResponse {
     generatedImages?: GeneratedImage[];
 }
 
-/** Tool to support URL context retrieval. */
+/** Tool to support URL context. */
 export declare interface UrlContext {
 }
 
 /** Metadata related to url context retrieval tool. */
 export declare interface UrlContextMetadata {
-    /** List of url context. */
+    /** Output only. List of url context. */
     urlMetadata?: UrlMetadata[];
 }
 
-/** Context for a single url retrieval. */
+/** Context of the a single url retrieval. */
 export declare interface UrlMetadata {
-    /** The URL retrieved by the tool. */
+    /** Retrieved url by the tool. */
     retrievedUrl?: string;
     /** Status of the url retrieval. */
     urlRetrievalStatus?: UrlRetrievalStatus;
@@ -7798,7 +7833,7 @@ export declare interface UrlMetadata {
 /** Status of the url retrieval. */
 export declare enum UrlRetrievalStatus {
     /**
-     * Default value. This value is unused
+     * Default value. This value is unused.
      */
     URL_RETRIEVAL_STATUS_UNSPECIFIED = "URL_RETRIEVAL_STATUS_UNSPECIFIED",
     /**
@@ -7810,11 +7845,11 @@ export declare enum UrlRetrievalStatus {
      */
     URL_RETRIEVAL_STATUS_ERROR = "URL_RETRIEVAL_STATUS_ERROR",
     /**
-     * Url retrieval is failed because the content is behind paywall.
+     * Url retrieval is failed because the content is behind paywall. This enum value is not supported in Vertex AI.
      */
     URL_RETRIEVAL_STATUS_PAYWALL = "URL_RETRIEVAL_STATUS_PAYWALL",
     /**
-     * Url retrieval is failed because the content is unsafe.
+     * Url retrieval is failed because the content is unsafe. This enum value is not supported in Vertex AI.
      */
     URL_RETRIEVAL_STATUS_UNSAFE = "URL_RETRIEVAL_STATUS_UNSAFE"
 }
@@ -7846,7 +7881,7 @@ export declare interface UsageMetadata {
     trafficType?: TrafficType;
 }
 
-/** Hyperparameters for Veo. */
+/** Hyperparameters for Veo. This data type is not supported in Gemini API. */
 export declare interface VeoHyperParameters {
     /** Optional. Number of complete passes the model makes over the entire training dataset during training. */
     epochCount?: string;
@@ -7856,7 +7891,7 @@ export declare interface VeoHyperParameters {
     tuningTask?: TuningTask;
 }
 
-/** Tuning Spec for Veo Model Tuning. */
+/** Tuning Spec for Veo Model Tuning. This data type is not supported in Gemini API. */
 export declare interface VeoTuningSpec {
     /** Optional. Hyperparameters for Veo. */
     hyperParameters?: VeoHyperParameters;
@@ -7866,7 +7901,7 @@ export declare interface VeoTuningSpec {
     validationDatasetUri?: string;
 }
 
-/** Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder */
+/** Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder. This data type is not supported in Gemini API. */
 export declare interface VertexAISearch {
     /** Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used. */
     dataStoreSpecs?: VertexAISearchDataStoreSpec[];
@@ -7880,7 +7915,7 @@ export declare interface VertexAISearch {
     maxResults?: number;
 }
 
-/** Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec */
+/** Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec. This data type is not supported in Gemini API. */
 export declare interface VertexAISearchDataStoreSpec {
     /** Full resource name of DataStore, such as Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` */
     dataStore?: string;
@@ -7888,7 +7923,7 @@ export declare interface VertexAISearchDataStoreSpec {
     filter?: string;
 }
 
-/** Retrieve from Vertex RAG Store for grounding. */
+/** Retrieve from Vertex RAG Store for grounding. This data type is not supported in Gemini API. */
 export declare interface VertexRagStore {
     /** Optional. Deprecated. Please use rag_resources instead. */
     ragCorpora?: string[];
@@ -7904,7 +7939,7 @@ export declare interface VertexRagStore {
     vectorDistanceThreshold?: number;
 }
 
-/** The definition of the Rag resource. */
+/** The definition of the Rag resource. This data type is not supported in Gemini API. */
 export declare interface VertexRagStoreRagResource {
     /** Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}` */
     ragCorpus?: string;
@@ -7998,21 +8033,19 @@ export declare enum VideoGenerationReferenceType {
     STYLE = "STYLE"
 }
 
-/** Describes how the video in the Part should be used by the model. */
+/** Metadata describes the input video content. */
 export declare interface VideoMetadata {
-    /** 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]. */
-    fps?: number;
     /** 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]. */
+    fps?: number;
     /** Optional. The start offset of the video. */
     startOffset?: string;
 }
 
 /** The configuration for the voice to use. */
 export declare interface VoiceConfig {
-    /** The configuration for the speaker to use.
-     */
+    /** The configuration for the prebuilt voice to use. */
     prebuiltVoiceConfig?: PrebuiltVoiceConfig;
 }