@google/genai 1.25.0 → 1.27.0

package/dist/genai.d.ts

@@ -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;
@@ -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;
@@ -646,32 +647,40 @@ export { Blob_2 as Blob }
 
 export declare type BlobImageUnion = Blob_2;
 
-/** Output only. Blocked reason. */
+/** Output only. The reason why the prompt was blocked. */
 export declare enum BlockedReason {
     /**
-     * Unspecified blocked reason.
+     * The blocked reason is unspecified.
      */
     BLOCKED_REASON_UNSPECIFIED = "BLOCKED_REASON_UNSPECIFIED",
     /**
-     * Candidates blocked due to safety.
+     * The prompt was blocked for safety reasons.
      */
     SAFETY = "SAFETY",
     /**
-     * Candidates blocked due to other reason.
+     * The prompt was blocked for other reasons. For example, it may be due to the prompt's language, or because it contains other harmful content.
      */
     OTHER = "OTHER",
     /**
-     * Candidates blocked due to the terms which are included from the terminology blocklist.
+     * The prompt was blocked because it contains a term from the terminology blocklist.
      */
     BLOCKLIST = "BLOCKLIST",
     /**
-     * Candidates blocked due to prohibited content.
+     * The prompt was blocked because it contains prohibited content.
      */
     PROHIBITED_CONTENT = "PROHIBITED_CONTENT",
     /**
-     * Candidates blocked due to unsafe image generation content.
+     * The prompt was blocked because it contains content that is unsafe for image generation.
      */
-    IMAGE_SAFETY = "IMAGE_SAFETY"
+    IMAGE_SAFETY = "IMAGE_SAFETY",
+    /**
+     * 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. This enum value is not supported in Gemini API.
+     */
+    JAILBREAK = "JAILBREAK"
 }
 
 /** A resource used in LLM queries for users to explicitly specify what to cache. */
@@ -694,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;
 }
 
@@ -1033,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;
@@ -1530,7 +1539,7 @@ 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. */
+    /** 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;
@@ -1581,7 +1590,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[];
@@ -1601,7 +1610,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;
@@ -1611,7 +1620,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;
@@ -1745,7 +1754,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;
@@ -1982,7 +1991,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;
@@ -2046,7 +2055,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;
@@ -2062,7 +2071,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;
@@ -2072,7 +2081,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 {
 }
 
@@ -2509,7 +2518,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[];
@@ -2517,7 +2526,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;
@@ -2839,17 +2848,17 @@ export declare class GenerateContentResponse {
     get codeExecutionResult(): string | undefined;
 }
 
-/** Content filter results for a prompt sent in the request. */
+/** Content filter results for a prompt sent in the request. Note: This is sent only in the first stream chunk and only if no candidates were generated due to content violations. */
 export declare class GenerateContentResponsePromptFeedback {
-    /** Output only. Blocked reason. */
+    /** Output only. The reason why the prompt was blocked. */
     blockReason?: BlockedReason;
-    /** Output only. A readable block reason message. */
+    /** 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. Safety ratings. */
+    /** 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[];
@@ -3109,11 +3118,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;
@@ -3135,7 +3144,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;
@@ -3146,14 +3155,16 @@ export declare interface GenerationConfig {
     /** Optional. Controls the randomness of predictions. */
     temperature?: number;
     /** Optional. Config for thinking features. An error will be returned if this field is set for models that don't support thinking. */
-    thinkingConfig?: GenerationConfigThinkingConfig;
+    thinkingConfig?: ThinkingConfig;
     /** Optional. If specified, top-k sampling will be used. */
     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. 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;
@@ -3161,24 +3172,24 @@ 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;
 }
 
-/** Config for thinking features. */
-export declare interface GenerationConfigThinkingConfig {
-    /** Optional. Indicates whether to include thoughts in the response. If true, thoughts are returned only when available. */
-    includeThoughts?: boolean;
-    /** Optional. Indicates the thinking budget in tokens. */
-    thinkingBudget?: number;
+/**
+ * Config for thinking feature.
+ *
+ * @deprecated This interface will be deprecated. Please use `ThinkingConfig` instead.
+ */
+export declare interface GenerationConfigThinkingConfig extends ThinkingConfig {
 }
 
 /** Optional parameters. */
@@ -3426,7 +3437,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;
@@ -3442,8 +3453,7 @@ export declare interface GoogleSearch {
      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. */
+    /** 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[];
 }
 
@@ -3453,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;
@@ -3465,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;
@@ -3487,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;
@@ -3495,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;
@@ -3505,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;
@@ -3523,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;
@@ -3539,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;
@@ -3549,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[];
@@ -3557,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;
@@ -3635,42 +3645,46 @@ export declare enum HarmCategory {
      * The harm category is unspecified.
      */
     HARM_CATEGORY_UNSPECIFIED = "HARM_CATEGORY_UNSPECIFIED",
-    /**
-     * The harm category is hate speech.
-     */
-    HARM_CATEGORY_HATE_SPEECH = "HARM_CATEGORY_HATE_SPEECH",
-    /**
-     * The harm category is dangerous content.
-     */
-    HARM_CATEGORY_DANGEROUS_CONTENT = "HARM_CATEGORY_DANGEROUS_CONTENT",
     /**
      * The harm category is harassment.
      */
     HARM_CATEGORY_HARASSMENT = "HARM_CATEGORY_HARASSMENT",
+    /**
+     * The harm category is hate speech.
+     */
+    HARM_CATEGORY_HATE_SPEECH = "HARM_CATEGORY_HATE_SPEECH",
     /**
      * The harm category is sexually explicit content.
      */
     HARM_CATEGORY_SEXUALLY_EXPLICIT = "HARM_CATEGORY_SEXUALLY_EXPLICIT",
+    /**
+     * The harm category is dangerous content.
+     */
+    HARM_CATEGORY_DANGEROUS_CONTENT = "HARM_CATEGORY_DANGEROUS_CONTENT",
     /**
      * Deprecated: Election filter is not longer supported. The harm category is civic integrity.
      */
     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. This enum value is not supported in Gemini API.
      */
-    HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT = "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT"
+    HARM_CATEGORY_JAILBREAK = "HARM_CATEGORY_JAILBREAK"
 }
 
 /** Output only. Harm probability levels in the content. */
@@ -4076,9 +4090,9 @@ export declare interface ListFilesParameters {
 export declare class ListFilesResponse {
     /** Used to retain the full HTTP response. */
     sdkHttpResponse?: HttpResponse;
-    /** A token to retrieve next page of results. */
+    /** A token that can be sent as a `page_token` into a subsequent `ListFiles` call. */
     nextPageToken?: string;
-    /** The list of files. */
+    /** The list of `File`s. */
     files?: File_2[];
 }
 
@@ -5738,7 +5752,7 @@ export declare interface Part {
 
 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>;
@@ -5772,7 +5786,7 @@ export declare interface PrebuiltVoiceConfig {
     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;
@@ -5792,7 +5806,7 @@ export declare interface PreferenceOptimizationDataStats {
     userOutputTokenDistribution?: DatasetDistribution;
 }
 
-/** A pre-tuned model for continuous tuning. */
+/** 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;
@@ -5816,7 +5830,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;
@@ -5824,7 +5838,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;
@@ -5832,7 +5846,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;
@@ -5844,7 +5858,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;
@@ -5854,13 +5868,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;
@@ -5868,13 +5882,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;
@@ -6024,7 +6038,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;
@@ -6079,11 +6093,11 @@ export declare interface SafetyRating {
     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. */
     severity?: HarmSeverity;
-    /** Output only. Harm severity score. */
+    /** Output only. Harm severity score. This field is not supported in Gemini API. */
     severityScore?: number;
 }
 
@@ -6610,7 +6624,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;
@@ -6624,7 +6638,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;
@@ -6646,7 +6660,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;
@@ -6656,7 +6670,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[];
@@ -6684,7 +6698,7 @@ export declare interface SupervisedTuningDataStats {
     userOutputTokenDistribution?: SupervisedTuningDatasetDistribution;
 }
 
-/** Tuning Spec for Supervised Tuning for first party models. */
+/** Tuning Spec for Supervised Tuning for first party models. This data type is not supported in Gemini API. */
 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;
@@ -6838,7 +6852,7 @@ 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. */
@@ -6861,7 +6875,7 @@ export declare interface Tool {
     codeExecution?: ToolCodeExecution;
 }
 
-/** 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 {
 }
 
@@ -6905,10 +6919,18 @@ export declare interface Transcription {
     finished?: boolean;
 }
 
+/** TunedModel for the Tuned Model of a Tuning Job. */
 export declare interface TunedModel {
-    /** Output only. The resource name of the TunedModel. Format: `projects/{project}/locations/{location}/models/{model}@{version_id}` When tuning from a base model, the version_id will be 1. For continuous tuning, the version id will be incremented by 1 from the last version id in the parent model. E.g., `projects/{project}/locations/{location}/models/{model}@{last_version_id + 1}` */
+    /** Output only. The resource name of the TunedModel.
+     Format: `projects/{project}/locations/{location}/models/{model}@{version_id}`
+     When tuning from a base model, the version_id will be 1.
+     For continuous tuning, the version id will be incremented by 1 from the
+     last version id in the parent model. E.g., `projects/{project}/locations/{location}/models/{model}@{last_version_id + 1}`
+     */
     model?: string;
-    /** Output only. A resource name of an Endpoint. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`. */
+    /** Output only. A resource name of an Endpoint.
+     Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`.
+     */
     endpoint?: string;
     /** The checkpoints associated with this TunedModel.
      This field is only populated for tuning jobs that enable intermediate
@@ -6953,7 +6975,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;
@@ -6963,11 +6985,12 @@ export declare interface TuningDataStats {
     supervisedTuningDataStats?: SupervisedTuningDataStats;
 }
 
+/** A single example for tuning. This data type is not supported in Vertex AI. */
 export declare interface TuningExample {
-    /** Text model input. */
-    textInput?: string;
-    /** The expected model output. */
+    /** Required. The expected model output. */
     output?: string;
+    /** Optional. Text model input. */
+    textInput?: string;
 }
 
 /** A tuning job. */
@@ -7122,7 +7145,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;
 }
 
@@ -7213,6 +7236,7 @@ declare namespace types {
         createModelContent,
         Outcome,
         Language,
+        FunctionResponseScheduling,
         Type,
         HarmCategory,
         HarmBlockMethod,
@@ -7256,7 +7280,6 @@ declare namespace types {
         EndSensitivity,
         ActivityHandling,
         TurnCoverage,
-        FunctionResponseScheduling,
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
@@ -7404,7 +7427,6 @@ declare namespace types {
         DeleteModelConfig,
         DeleteModelParameters,
         DeleteModelResponse,
-        GenerationConfigThinkingConfig,
         GenerationConfig,
         CountTokensConfig,
         CountTokensParameters,
@@ -7540,6 +7562,7 @@ declare namespace types {
         LiveServerSessionResumptionUpdate,
         LiveServerMessage,
         OperationFromAPIResponseParameters,
+        GenerationConfigThinkingConfig,
         AutomaticActivityDetection,
         RealtimeInputConfig,
         SessionResumptionConfig,
@@ -7824,7 +7847,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;
@@ -7834,7 +7857,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;
@@ -7844,7 +7867,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[];
@@ -7858,7 +7881,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;
@@ -7866,7 +7889,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[];
@@ -7882,7 +7905,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;