@google/genai 1.26.0 → 1.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/genai.d.ts CHANGED
@@ -64,13 +64,13 @@ export declare enum AdapterSize {
64
64
  ADAPTER_SIZE_THIRTY_TWO = "ADAPTER_SIZE_THIRTY_TWO"
65
65
  }
66
66
 
67
- /** The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. */
67
+ /** 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. */
68
68
  export declare interface ApiAuth {
69
69
  /** The API secret. */
70
70
  apiKeyConfig?: ApiAuthApiKeyConfig;
71
71
  }
72
72
 
73
- /** The API secret. */
73
+ /** The API secret. This data type is not supported in Gemini API. */
74
74
  export declare interface ApiAuthApiKeyConfig {
75
75
  /** Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version} */
76
76
  apiKeySecretVersion?: string;
@@ -278,8 +278,9 @@ declare interface Auth {
278
278
  * Sets the headers needed to authenticate with the API service.
279
279
  *
280
280
  * @param headers - The Headers object that will be updated with the authentication headers.
281
+ * @param url - The URL of the request.
281
282
  */
282
- addAuthHeaders(headers: Headers): Promise<void>;
283
+ addAuthHeaders(headers: Headers, url?: string): Promise<void>;
283
284
  }
284
285
 
285
286
  /** Auth configuration to run the extension. */
@@ -298,19 +299,19 @@ export declare interface AuthConfig {
298
299
  oidcConfig?: AuthConfigOidcConfig;
299
300
  }
300
301
 
301
- /** Config for Google Service Account Authentication. */
302
+ /** Config for Google Service Account Authentication. This data type is not supported in Gemini API. */
302
303
  export declare interface AuthConfigGoogleServiceAccountConfig {
303
304
  /** 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. */
304
305
  serviceAccount?: string;
305
306
  }
306
307
 
307
- /** Config for HTTP Basic Authentication. */
308
+ /** Config for HTTP Basic Authentication. This data type is not supported in Gemini API. */
308
309
  export declare interface AuthConfigHttpBasicAuthConfig {
309
310
  /** 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. */
310
311
  credentialSecret?: string;
311
312
  }
312
313
 
313
- /** Config for user oauth. */
314
+ /** Config for user oauth. This data type is not supported in Gemini API. */
314
315
  export declare interface AuthConfigOauthConfig {
315
316
  /** Access token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. */
316
317
  accessToken?: string;
@@ -318,7 +319,7 @@ export declare interface AuthConfigOauthConfig {
318
319
  serviceAccount?: string;
319
320
  }
320
321
 
321
- /** Config for user OIDC auth. */
322
+ /** Config for user OIDC auth. This data type is not supported in Gemini API. */
322
323
  export declare interface AuthConfigOidcConfig {
323
324
  /** OpenID Connect formatted ID token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. */
324
325
  idToken?: string;
@@ -673,11 +674,11 @@ export declare enum BlockedReason {
673
674
  */
674
675
  IMAGE_SAFETY = "IMAGE_SAFETY",
675
676
  /**
676
- * The prompt was blocked by Model Armor.
677
+ * The prompt was blocked by Model Armor. This enum value is not supported in Gemini API.
677
678
  */
678
679
  MODEL_ARMOR = "MODEL_ARMOR",
679
680
  /**
680
- * The prompt was blocked as a jailbreak attempt.
681
+ * The prompt was blocked as a jailbreak attempt. This enum value is not supported in Gemini API.
681
682
  */
682
683
  JAILBREAK = "JAILBREAK"
683
684
  }
@@ -702,15 +703,15 @@ export declare interface CachedContent {
702
703
 
703
704
  /** Metadata on the usage of the cached content. */
704
705
  export declare interface CachedContentUsageMetadata {
705
- /** Duration of audio in seconds. */
706
+ /** Duration of audio in seconds. This field is not supported in Gemini API. */
706
707
  audioDurationSeconds?: number;
707
- /** Number of images. */
708
+ /** Number of images. This field is not supported in Gemini API. */
708
709
  imageCount?: number;
709
- /** Number of text characters. */
710
+ /** Number of text characters. This field is not supported in Gemini API. */
710
711
  textCount?: number;
711
712
  /** Total number of tokens that the cached content consumes. */
712
713
  totalTokenCount?: number;
713
- /** Duration of video in seconds. */
714
+ /** Duration of video in seconds. This field is not supported in Gemini API. */
714
715
  videoDurationSeconds?: number;
715
716
  }
716
717
 
@@ -1041,7 +1042,7 @@ export declare interface Checkpoint {
1041
1042
  step?: string;
1042
1043
  }
1043
1044
 
1044
- /** Source attributions for content. */
1045
+ /** Source attributions for content. This data type is not supported in Gemini API. */
1045
1046
  export declare interface Citation {
1046
1047
  /** Output only. End index into the content. */
1047
1048
  endIndex?: number;
@@ -1538,7 +1539,7 @@ export declare interface CreateTuningJobConfig {
1538
1539
  be charged usage for any applicable operations.
1539
1540
  */
1540
1541
  abortSignal?: AbortSignal;
1541
- /** Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
1542
+ /** Validation dataset for tuning. The dataset must be formatted as a JSONL file. */
1542
1543
  validationDataset?: TuningValidationDataset;
1543
1544
  /** The display name of the tuned Model. The name can be up to 128 characters long and can consist of any UTF-8 characters. */
1544
1545
  tunedModelDisplayName?: string;
@@ -1589,7 +1590,7 @@ export declare interface CreateTuningJobParametersPrivate {
1589
1590
  */
1590
1591
  export declare function createUserContent(partOrString: PartListUnion | string): Content;
1591
1592
 
1592
- /** Distribution computed over a tuning dataset. */
1593
+ /** Distribution computed over a tuning dataset. This data type is not supported in Gemini API. */
1593
1594
  export declare interface DatasetDistribution {
1594
1595
  /** Output only. Defines the histogram bucket. */
1595
1596
  buckets?: DatasetDistributionDistributionBucket[];
@@ -1609,7 +1610,7 @@ export declare interface DatasetDistribution {
1609
1610
  sum?: number;
1610
1611
  }
1611
1612
 
1612
- /** Dataset bucket used to create a histogram for the distribution given a population of values. */
1613
+ /** Dataset bucket used to create a histogram for the distribution given a population of values. This data type is not supported in Gemini API. */
1613
1614
  export declare interface DatasetDistributionDistributionBucket {
1614
1615
  /** Output only. Number of values in the bucket. */
1615
1616
  count?: string;
@@ -1619,7 +1620,7 @@ export declare interface DatasetDistributionDistributionBucket {
1619
1620
  right?: number;
1620
1621
  }
1621
1622
 
1622
- /** Statistics computed over a tuning dataset. */
1623
+ /** Statistics computed over a tuning dataset. This data type is not supported in Gemini API. */
1623
1624
  export declare interface DatasetStats {
1624
1625
  /** Output only. Number of billable characters in the tuning dataset. */
1625
1626
  totalBillableCharacterCount?: string;
@@ -1753,7 +1754,7 @@ export declare interface DeleteResourceJob {
1753
1754
  error?: JobError;
1754
1755
  }
1755
1756
 
1756
- /** Statistics computed for datasets used for distillation. */
1757
+ /** Statistics computed for datasets used for distillation. This data type is not supported in Gemini API. */
1757
1758
  export declare interface DistillationDataStats {
1758
1759
  /** Output only. Statistics computed for the training dataset. */
1759
1760
  trainingDatasetStats?: DatasetStats;
@@ -1990,7 +1991,7 @@ export declare interface EmbeddingsBatchJobSource {
1990
1991
  inlinedRequests?: EmbedContentBatch;
1991
1992
  }
1992
1993
 
1993
- /** Represents a customer-managed encryption key spec that can be applied to a top-level resource. */
1994
+ /** 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. */
1994
1995
  export declare interface EncryptionSpec {
1995
1996
  /** 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. */
1996
1997
  kmsKeyName?: string;
@@ -2054,7 +2055,7 @@ export declare interface ExecutableCode {
2054
2055
  language?: Language;
2055
2056
  }
2056
2057
 
2057
- /** 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. */
2058
+ /** 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. */
2058
2059
  export declare interface ExternalApi {
2059
2060
  /** The authentication config to access the API. Deprecated. Please use auth_config instead. */
2060
2061
  apiAuth?: ApiAuth;
@@ -2070,7 +2071,7 @@ export declare interface ExternalApi {
2070
2071
  simpleSearchParams?: ExternalApiSimpleSearchParams;
2071
2072
  }
2072
2073
 
2073
- /** The search parameters to use for the ELASTIC_SEARCH spec. */
2074
+ /** The search parameters to use for the ELASTIC_SEARCH spec. This data type is not supported in Gemini API. */
2074
2075
  export declare interface ExternalApiElasticSearchParams {
2075
2076
  /** The ElasticSearch index to use. */
2076
2077
  index?: string;
@@ -2080,7 +2081,7 @@ export declare interface ExternalApiElasticSearchParams {
2080
2081
  searchTemplate?: string;
2081
2082
  }
2082
2083
 
2083
- /** The search parameters to use for SIMPLE_SEARCH spec. */
2084
+ /** The search parameters to use for SIMPLE_SEARCH spec. This data type is not supported in Gemini API. */
2084
2085
  export declare interface ExternalApiSimpleSearchParams {
2085
2086
  }
2086
2087
 
@@ -2517,7 +2518,7 @@ export declare enum FunctionResponseScheduling {
2517
2518
  INTERRUPT = "INTERRUPT"
2518
2519
  }
2519
2520
 
2520
- /** Input example for preference optimization. */
2521
+ /** Input example for preference optimization. This data type is not supported in Gemini API. */
2521
2522
  export declare interface GeminiPreferenceExample {
2522
2523
  /** List of completions for a given prompt. */
2523
2524
  completions?: GeminiPreferenceExampleCompletion[];
@@ -2525,7 +2526,7 @@ export declare interface GeminiPreferenceExample {
2525
2526
  contents?: Content[];
2526
2527
  }
2527
2528
 
2528
- /** Completion and its preference score. */
2529
+ /** Completion and its preference score. This data type is not supported in Gemini API. */
2529
2530
  export declare interface GeminiPreferenceExampleCompletion {
2530
2531
  /** Single turn completion for the given prompt. */
2531
2532
  completion?: Content;
@@ -2851,13 +2852,13 @@ export declare class GenerateContentResponse {
2851
2852
  export declare class GenerateContentResponsePromptFeedback {
2852
2853
  /** Output only. The reason why the prompt was blocked. */
2853
2854
  blockReason?: BlockedReason;
2854
- /** Output only. A readable message that explains the reason why the prompt was blocked. */
2855
+ /** Output only. A readable message that explains the reason why the prompt was blocked. This field is not supported in Gemini API. */
2855
2856
  blockReasonMessage?: string;
2856
2857
  /** Output only. A list of safety ratings for the prompt. There is one rating per category. */
2857
2858
  safetyRatings?: SafetyRating[];
2858
2859
  }
2859
2860
 
2860
- /** Usage metadata about response(s). */
2861
+ /** Usage metadata about response(s). This data type is not supported in Gemini API. */
2861
2862
  export declare class GenerateContentResponseUsageMetadata {
2862
2863
  /** Output only. List of modalities of the cached content in the request input. */
2863
2864
  cacheTokensDetails?: ModalityTokenCount[];
@@ -3117,11 +3118,11 @@ export declare interface GenerateVideosSource {
3117
3118
  export declare interface GenerationConfig {
3118
3119
  /** Optional. Config for model selection. */
3119
3120
  modelSelectionConfig?: ModelSelectionConfig;
3120
- /** Optional. If enabled, audio timestamp will be included in the request to the model. */
3121
+ /** Optional. If enabled, audio timestamp will be included in the request to the model. This field is not supported in Gemini API. */
3121
3122
  audioTimestamp?: boolean;
3122
3123
  /** Optional. Number of candidates to generate. */
3123
3124
  candidateCount?: number;
3124
- /** Optional. If enabled, the model will detect emotions and adapt its responses accordingly. */
3125
+ /** Optional. If enabled, the model will detect emotions and adapt its responses accordingly. This field is not supported in Gemini API. */
3125
3126
  enableAffectiveDialog?: boolean;
3126
3127
  /** Optional. Frequency penalties. */
3127
3128
  frequencyPenalty?: number;
@@ -3143,7 +3144,7 @@ export declare interface GenerationConfig {
3143
3144
  responseModalities?: Modality[];
3144
3145
  /** 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. */
3145
3146
  responseSchema?: Schema;
3146
- /** Optional. Routing configuration. */
3147
+ /** Optional. Routing configuration. This field is not supported in Gemini API. */
3147
3148
  routingConfig?: GenerationConfigRoutingConfig;
3148
3149
  /** Optional. Seed. */
3149
3150
  seed?: number;
@@ -3159,11 +3160,11 @@ export declare interface GenerationConfig {
3159
3160
  topK?: number;
3160
3161
  /** Optional. If specified, nucleus sampling will be used. */
3161
3162
  topP?: number;
3162
- /** Optional. Enables enhanced civic answers. It may not be available for all models. */
3163
+ /** Optional. Enables enhanced civic answers. It may not be available for all models. This field is not supported in Vertex AI. */
3163
3164
  enableEnhancedCivicAnswers?: boolean;
3164
3165
  }
3165
3166
 
3166
- /** The configuration for routing the request to a specific model. */
3167
+ /** The configuration for routing the request to a specific model. This data type is not supported in Gemini API. */
3167
3168
  export declare interface GenerationConfigRoutingConfig {
3168
3169
  /** Automated routing. */
3169
3170
  autoMode?: GenerationConfigRoutingConfigAutoRoutingMode;
@@ -3171,13 +3172,13 @@ export declare interface GenerationConfigRoutingConfig {
3171
3172
  manualMode?: GenerationConfigRoutingConfigManualRoutingMode;
3172
3173
  }
3173
3174
 
3174
- /** When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference. */
3175
+ /** 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. */
3175
3176
  export declare interface GenerationConfigRoutingConfigAutoRoutingMode {
3176
3177
  /** The model routing preference. */
3177
3178
  modelRoutingPreference?: 'UNKNOWN' | 'PRIORITIZE_QUALITY' | 'BALANCED' | 'PRIORITIZE_COST';
3178
3179
  }
3179
3180
 
3180
- /** When manual routing is set, the specified model will be used directly. */
3181
+ /** When manual routing is set, the specified model will be used directly. This data type is not supported in Gemini API. */
3181
3182
  export declare interface GenerationConfigRoutingConfigManualRoutingMode {
3182
3183
  /** 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). */
3183
3184
  modelName?: string;
@@ -3436,7 +3437,7 @@ export declare interface GoogleMaps {
3436
3437
  enableWidget?: boolean;
3437
3438
  }
3438
3439
 
3439
- /** 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). */
3440
+ /** 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. */
3440
3441
  export declare interface GoogleRpcStatus {
3441
3442
  /** The status code, which should be an enum value of google.rpc.Code. */
3442
3443
  code?: number;
@@ -3452,7 +3453,7 @@ export declare interface GoogleSearch {
3452
3453
  If customers set a start time, they must set an end time (and vice versa).
3453
3454
  */
3454
3455
  timeRangeFilter?: Interval;
3455
- /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. */
3456
+ /** 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. */
3456
3457
  excludeDomains?: string[];
3457
3458
  }
3458
3459
 
@@ -3462,7 +3463,7 @@ export declare interface GoogleSearchRetrieval {
3462
3463
  dynamicRetrievalConfig?: DynamicRetrievalConfig;
3463
3464
  }
3464
3465
 
3465
- /** 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 */
3466
+ /** 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. */
3466
3467
  export declare interface GoogleTypeDate {
3467
3468
  /** 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. */
3468
3469
  day?: number;
@@ -3474,15 +3475,15 @@ export declare interface GoogleTypeDate {
3474
3475
 
3475
3476
  /** Grounding chunk. */
3476
3477
  export declare interface GroundingChunk {
3477
- /** Grounding chunk from Google Maps. */
3478
+ /** Grounding chunk from Google Maps. This field is not supported in Gemini API. */
3478
3479
  maps?: GroundingChunkMaps;
3479
- /** Grounding chunk from context retrieved by the retrieval tools. */
3480
+ /** Grounding chunk from context retrieved by the retrieval tools. This field is not supported in Gemini API. */
3480
3481
  retrievedContext?: GroundingChunkRetrievedContext;
3481
3482
  /** Grounding chunk from the web. */
3482
3483
  web?: GroundingChunkWeb;
3483
3484
  }
3484
3485
 
3485
- /** Chunk from Google Maps. */
3486
+ /** Chunk from Google Maps. This data type is not supported in Gemini API. */
3486
3487
  export declare interface GroundingChunkMaps {
3487
3488
  /** 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. */
3488
3489
  placeAnswerSources?: GroundingChunkMapsPlaceAnswerSources;
@@ -3496,7 +3497,7 @@ export declare interface GroundingChunkMaps {
3496
3497
  uri?: string;
3497
3498
  }
3498
3499
 
3499
- /** Sources used to generate the place answer. */
3500
+ /** Sources used to generate the place answer. This data type is not supported in Gemini API. */
3500
3501
  export declare interface GroundingChunkMapsPlaceAnswerSources {
3501
3502
  /** A link where users can flag a problem with the generated answer. */
3502
3503
  flagContentUri?: string;
@@ -3504,7 +3505,7 @@ export declare interface GroundingChunkMapsPlaceAnswerSources {
3504
3505
  reviewSnippets?: GroundingChunkMapsPlaceAnswerSourcesReviewSnippet[];
3505
3506
  }
3506
3507
 
3507
- /** Author attribution for a photo or review. */
3508
+ /** Author attribution for a photo or review. This data type is not supported in Gemini API. */
3508
3509
  export declare interface GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution {
3509
3510
  /** Name of the author of the Photo or Review. */
3510
3511
  displayName?: string;
@@ -3514,7 +3515,7 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution {
3514
3515
  uri?: string;
3515
3516
  }
3516
3517
 
3517
- /** Encapsulates a review snippet. */
3518
+ /** Encapsulates a review snippet. This data type is not supported in Gemini API. */
3518
3519
  export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
3519
3520
  /** This review's author. */
3520
3521
  authorAttribution?: GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution;
@@ -3532,7 +3533,7 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
3532
3533
  title?: string;
3533
3534
  }
3534
3535
 
3535
- /** Chunk from context retrieved by the retrieval tools. */
3536
+ /** Chunk from context retrieved by the retrieval tools. This data type is not supported in Gemini API. */
3536
3537
  export declare interface GroundingChunkRetrievedContext {
3537
3538
  /** Output only. The full document name for the referenced Vertex AI Search document. */
3538
3539
  documentName?: string;
@@ -3548,7 +3549,7 @@ export declare interface GroundingChunkRetrievedContext {
3548
3549
 
3549
3550
  /** Chunk from the web. */
3550
3551
  export declare interface GroundingChunkWeb {
3551
- /** Domain of the (original) URI. */
3552
+ /** Domain of the (original) URI. This field is not supported in Gemini API. */
3552
3553
  domain?: string;
3553
3554
  /** Title of the chunk. */
3554
3555
  title?: string;
@@ -3558,7 +3559,7 @@ export declare interface GroundingChunkWeb {
3558
3559
 
3559
3560
  /** Metadata returned to client when grounding is enabled. */
3560
3561
  export declare interface GroundingMetadata {
3561
- /** 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. */
3562
+ /** 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. */
3562
3563
  googleMapsWidgetContextToken?: string;
3563
3564
  /** List of supporting references retrieved from specified grounding source. */
3564
3565
  groundingChunks?: GroundingChunk[];
@@ -3566,17 +3567,17 @@ export declare interface GroundingMetadata {
3566
3567
  groundingSupports?: GroundingSupport[];
3567
3568
  /** Optional. Output only. Retrieval metadata. */
3568
3569
  retrievalMetadata?: RetrievalMetadata;
3569
- /** Optional. Queries executed by the retrieval tools. */
3570
+ /** Optional. Queries executed by the retrieval tools. This field is not supported in Gemini API. */
3570
3571
  retrievalQueries?: string[];
3571
3572
  /** Optional. Google search entry for the following-up web searches. */
3572
3573
  searchEntryPoint?: SearchEntryPoint;
3573
- /** Optional. Output only. List of source flagging uris. This is currently populated only for Google Maps grounding. */
3574
+ /** 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. */
3574
3575
  sourceFlaggingUris?: GroundingMetadataSourceFlaggingUri[];
3575
3576
  /** Optional. Web search queries for the following-up web search. */
3576
3577
  webSearchQueries?: string[];
3577
3578
  }
3578
3579
 
3579
- /** Source content flagging uri for a place or review. This is currently populated only for Google Maps grounding. */
3580
+ /** 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. */
3580
3581
  export declare interface GroundingMetadataSourceFlaggingUri {
3581
3582
  /** A link where users can flag a problem with the source (place or review). */
3582
3583
  flagContentUri?: string;
@@ -3665,23 +3666,23 @@ export declare enum HarmCategory {
3665
3666
  */
3666
3667
  HARM_CATEGORY_CIVIC_INTEGRITY = "HARM_CATEGORY_CIVIC_INTEGRITY",
3667
3668
  /**
3668
- * The harm category is image hate.
3669
+ * The harm category is image hate. This enum value is not supported in Gemini API.
3669
3670
  */
3670
3671
  HARM_CATEGORY_IMAGE_HATE = "HARM_CATEGORY_IMAGE_HATE",
3671
3672
  /**
3672
- * The harm category is image dangerous content.
3673
+ * The harm category is image dangerous content. This enum value is not supported in Gemini API.
3673
3674
  */
3674
3675
  HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT = "HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT",
3675
3676
  /**
3676
- * The harm category is image harassment.
3677
+ * The harm category is image harassment. This enum value is not supported in Gemini API.
3677
3678
  */
3678
3679
  HARM_CATEGORY_IMAGE_HARASSMENT = "HARM_CATEGORY_IMAGE_HARASSMENT",
3679
3680
  /**
3680
- * The harm category is image sexually explicit content.
3681
+ * The harm category is image sexually explicit content. This enum value is not supported in Gemini API.
3681
3682
  */
3682
3683
  HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT = "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT",
3683
3684
  /**
3684
- * The harm category is for jailbreak prompts.
3685
+ * The harm category is for jailbreak prompts. This enum value is not supported in Gemini API.
3685
3686
  */
3686
3687
  HARM_CATEGORY_JAILBREAK = "HARM_CATEGORY_JAILBREAK"
3687
3688
  }
@@ -5751,7 +5752,7 @@ export declare interface Part {
5751
5752
 
5752
5753
  export declare type PartListUnion = PartUnion[] | PartUnion;
5753
5754
 
5754
- /** Tuning spec for Partner models. */
5755
+ /** Tuning spec for Partner models. This data type is not supported in Gemini API. */
5755
5756
  export declare interface PartnerModelTuningSpec {
5756
5757
  /** Hyperparameters for tuning. The accepted hyper_parameters and their valid range of values will differ depending on the base model. */
5757
5758
  hyperParameters?: Record<string, unknown>;
@@ -5785,7 +5786,7 @@ export declare interface PrebuiltVoiceConfig {
5785
5786
  voiceName?: string;
5786
5787
  }
5787
5788
 
5788
- /** Statistics computed for datasets used for preference optimization. */
5789
+ /** Statistics computed for datasets used for preference optimization. This data type is not supported in Gemini API. */
5789
5790
  export declare interface PreferenceOptimizationDataStats {
5790
5791
  /** Output only. Dataset distributions for scores variance per example. */
5791
5792
  scoreVariancePerExampleDistribution?: DatasetDistribution;
@@ -5805,7 +5806,7 @@ export declare interface PreferenceOptimizationDataStats {
5805
5806
  userOutputTokenDistribution?: DatasetDistribution;
5806
5807
  }
5807
5808
 
5808
- /** A pre-tuned model for continuous tuning. */
5809
+ /** A pre-tuned model for continuous tuning. This data type is not supported in Gemini API. */
5809
5810
  export declare interface PreTunedModel {
5810
5811
  /** Output only. The name of the base model this PreTunedModel was tuned from. */
5811
5812
  baseModel?: string;
@@ -5829,7 +5830,7 @@ export declare interface ProductImage {
5829
5830
  productImage?: Image_2;
5830
5831
  }
5831
5832
 
5832
- /** A RagChunk includes the content of a chunk of a RagFile, and associated metadata. */
5833
+ /** A RagChunk includes the content of a chunk of a RagFile, and associated metadata. This data type is not supported in Gemini API. */
5833
5834
  export declare interface RagChunk {
5834
5835
  /** If populated, represents where the chunk starts and ends in the document. */
5835
5836
  pageSpan?: RagChunkPageSpan;
@@ -5837,7 +5838,7 @@ export declare interface RagChunk {
5837
5838
  text?: string;
5838
5839
  }
5839
5840
 
5840
- /** Represents where the chunk starts and ends in the document. */
5841
+ /** Represents where the chunk starts and ends in the document. This data type is not supported in Gemini API. */
5841
5842
  export declare interface RagChunkPageSpan {
5842
5843
  /** Page where chunk starts in the document. Inclusive. 1-indexed. */
5843
5844
  firstPage?: number;
@@ -5845,7 +5846,7 @@ export declare interface RagChunkPageSpan {
5845
5846
  lastPage?: number;
5846
5847
  }
5847
5848
 
5848
- /** Specifies the context retrieval config. */
5849
+ /** Specifies the context retrieval config. This data type is not supported in Gemini API. */
5849
5850
  export declare interface RagRetrievalConfig {
5850
5851
  /** Optional. Config for filters. */
5851
5852
  filter?: RagRetrievalConfigFilter;
@@ -5857,7 +5858,7 @@ export declare interface RagRetrievalConfig {
5857
5858
  topK?: number;
5858
5859
  }
5859
5860
 
5860
- /** Config for filters. */
5861
+ /** Config for filters. This data type is not supported in Gemini API. */
5861
5862
  export declare interface RagRetrievalConfigFilter {
5862
5863
  /** Optional. String for metadata filtering. */
5863
5864
  metadataFilter?: string;
@@ -5867,13 +5868,13 @@ export declare interface RagRetrievalConfigFilter {
5867
5868
  vectorSimilarityThreshold?: number;
5868
5869
  }
5869
5870
 
5870
- /** Config for Hybrid Search. */
5871
+ /** Config for Hybrid Search. This data type is not supported in Gemini API. */
5871
5872
  export declare interface RagRetrievalConfigHybridSearch {
5872
5873
  /** 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. */
5873
5874
  alpha?: number;
5874
5875
  }
5875
5876
 
5876
- /** Config for ranking and reranking. */
5877
+ /** Config for ranking and reranking. This data type is not supported in Gemini API. */
5877
5878
  export declare interface RagRetrievalConfigRanking {
5878
5879
  /** Optional. Config for LlmRanker. */
5879
5880
  llmRanker?: RagRetrievalConfigRankingLlmRanker;
@@ -5881,13 +5882,13 @@ export declare interface RagRetrievalConfigRanking {
5881
5882
  rankService?: RagRetrievalConfigRankingRankService;
5882
5883
  }
5883
5884
 
5884
- /** Config for LlmRanker. */
5885
+ /** Config for LlmRanker. This data type is not supported in Gemini API. */
5885
5886
  export declare interface RagRetrievalConfigRankingLlmRanker {
5886
5887
  /** Optional. The model name used for ranking. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models). */
5887
5888
  modelName?: string;
5888
5889
  }
5889
5890
 
5890
- /** Config for Rank Service. */
5891
+ /** Config for Rank Service. This data type is not supported in Gemini API. */
5891
5892
  export declare interface RagRetrievalConfigRankingRankService {
5892
5893
  /** Optional. The model name of the rank service. Format: `semantic-ranker-512@latest` */
5893
5894
  modelName?: string;
@@ -6037,7 +6038,7 @@ export declare class ReplayResponse {
6037
6038
  sdkResponseSegments?: Record<string, unknown>[];
6038
6039
  }
6039
6040
 
6040
- /** Defines a retrieval tool that model can call to access external knowledge. */
6041
+ /** Defines a retrieval tool that model can call to access external knowledge. This data type is not supported in Gemini API. */
6041
6042
  export declare interface Retrieval {
6042
6043
  /** Optional. Deprecated. This option is no longer supported. */
6043
6044
  disableAttribution?: boolean;
@@ -6092,11 +6093,11 @@ export declare interface SafetyRating {
6092
6093
  overwrittenThreshold?: HarmBlockThreshold;
6093
6094
  /** Output only. Harm probability levels in the content. */
6094
6095
  probability?: HarmProbability;
6095
- /** Output only. Harm probability score. */
6096
+ /** Output only. Harm probability score. This field is not supported in Gemini API. */
6096
6097
  probabilityScore?: number;
6097
6098
  /** Output only. Harm severity levels in the content. */
6098
6099
  severity?: HarmSeverity;
6099
- /** Output only. Harm severity score. */
6100
+ /** Output only. Harm severity score. This field is not supported in Gemini API. */
6100
6101
  severityScore?: number;
6101
6102
  }
6102
6103
 
@@ -6623,7 +6624,7 @@ export declare enum SubjectReferenceType {
6623
6624
  SUBJECT_TYPE_PRODUCT = "SUBJECT_TYPE_PRODUCT"
6624
6625
  }
6625
6626
 
6626
- /** Hyperparameters for SFT. */
6627
+ /** Hyperparameters for SFT. This data type is not supported in Gemini API. */
6627
6628
  export declare interface SupervisedHyperParameters {
6628
6629
  /** Optional. Adapter size for tuning. */
6629
6630
  adapterSize?: AdapterSize;
@@ -6637,7 +6638,7 @@ export declare interface SupervisedHyperParameters {
6637
6638
  learningRateMultiplier?: number;
6638
6639
  }
6639
6640
 
6640
- /** Dataset distribution for Supervised Tuning. */
6641
+ /** Dataset distribution for Supervised Tuning. This data type is not supported in Gemini API. */
6641
6642
  export declare interface SupervisedTuningDatasetDistribution {
6642
6643
  /** Output only. Sum of a given population of values that are billable. */
6643
6644
  billableSum?: string;
@@ -6659,7 +6660,7 @@ export declare interface SupervisedTuningDatasetDistribution {
6659
6660
  sum?: string;
6660
6661
  }
6661
6662
 
6662
- /** Dataset bucket used to create a histogram for the distribution given a population of values. */
6663
+ /** Dataset bucket used to create a histogram for the distribution given a population of values. This data type is not supported in Gemini API. */
6663
6664
  export declare interface SupervisedTuningDatasetDistributionDatasetBucket {
6664
6665
  /** Output only. Number of values in the bucket. */
6665
6666
  count?: number;
@@ -6669,7 +6670,7 @@ export declare interface SupervisedTuningDatasetDistributionDatasetBucket {
6669
6670
  right?: number;
6670
6671
  }
6671
6672
 
6672
- /** Tuning data statistics for Supervised Tuning. */
6673
+ /** Tuning data statistics for Supervised Tuning. This data type is not supported in Gemini API. */
6673
6674
  export declare interface SupervisedTuningDataStats {
6674
6675
  /** Output only. For each index in `truncated_example_indices`, the user-facing reason why the example was dropped. */
6675
6676
  droppedExampleReasons?: string[];
@@ -6697,7 +6698,7 @@ export declare interface SupervisedTuningDataStats {
6697
6698
  userOutputTokenDistribution?: SupervisedTuningDatasetDistribution;
6698
6699
  }
6699
6700
 
6700
- /** Tuning Spec for Supervised Tuning for first party models. */
6701
+ /** Tuning Spec for Supervised Tuning for first party models. This data type is not supported in Gemini API. */
6701
6702
  export declare interface SupervisedTuningSpec {
6702
6703
  /** 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. */
6703
6704
  exportLastCheckpointOnly?: boolean;
@@ -6851,7 +6852,7 @@ export declare interface TokensInfo {
6851
6852
  export declare interface Tool {
6852
6853
  /** List of function declarations that the tool supports. */
6853
6854
  functionDeclarations?: FunctionDeclaration[];
6854
- /** 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. */
6855
+ /** 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. */
6855
6856
  retrieval?: Retrieval;
6856
6857
  /** Optional. Google Search tool type. Specialized retrieval tool
6857
6858
  that is powered by Google Search. */
@@ -6874,7 +6875,7 @@ export declare interface Tool {
6874
6875
  codeExecution?: ToolCodeExecution;
6875
6876
  }
6876
6877
 
6877
- /** 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. */
6878
+ /** 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. */
6878
6879
  export declare interface ToolCodeExecution {
6879
6880
  }
6880
6881
 
@@ -6974,7 +6975,7 @@ export declare interface TuningDataset {
6974
6975
  examples?: TuningExample[];
6975
6976
  }
6976
6977
 
6977
- /** The tuning data statistic values for TuningJob. */
6978
+ /** The tuning data statistic values for TuningJob. This data type is not supported in Gemini API. */
6978
6979
  export declare interface TuningDataStats {
6979
6980
  /** Output only. Statistics for distillation. */
6980
6981
  distillationDataStats?: DistillationDataStats;
@@ -6984,7 +6985,7 @@ export declare interface TuningDataStats {
6984
6985
  supervisedTuningDataStats?: SupervisedTuningDataStats;
6985
6986
  }
6986
6987
 
6987
- /** A single example for tuning. */
6988
+ /** A single example for tuning. This data type is not supported in Vertex AI. */
6988
6989
  export declare interface TuningExample {
6989
6990
  /** Required. The expected model output. */
6990
6991
  output?: string;
@@ -7144,7 +7145,7 @@ export declare enum TuningTask {
7144
7145
  export declare interface TuningValidationDataset {
7145
7146
  /** GCS URI of the file containing validation dataset in JSONL format. */
7146
7147
  gcsUri?: string;
7147
- /** 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'. */
7148
+ /** 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'. */
7148
7149
  vertexDatasetResource?: string;
7149
7150
  }
7150
7151
 
@@ -7846,7 +7847,7 @@ export declare interface UsageMetadata {
7846
7847
  trafficType?: TrafficType;
7847
7848
  }
7848
7849
 
7849
- /** Hyperparameters for Veo. */
7850
+ /** Hyperparameters for Veo. This data type is not supported in Gemini API. */
7850
7851
  export declare interface VeoHyperParameters {
7851
7852
  /** Optional. Number of complete passes the model makes over the entire training dataset during training. */
7852
7853
  epochCount?: string;
@@ -7856,7 +7857,7 @@ export declare interface VeoHyperParameters {
7856
7857
  tuningTask?: TuningTask;
7857
7858
  }
7858
7859
 
7859
- /** Tuning Spec for Veo Model Tuning. */
7860
+ /** Tuning Spec for Veo Model Tuning. This data type is not supported in Gemini API. */
7860
7861
  export declare interface VeoTuningSpec {
7861
7862
  /** Optional. Hyperparameters for Veo. */
7862
7863
  hyperParameters?: VeoHyperParameters;
@@ -7866,7 +7867,7 @@ export declare interface VeoTuningSpec {
7866
7867
  validationDatasetUri?: string;
7867
7868
  }
7868
7869
 
7869
- /** Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder */
7870
+ /** 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. */
7870
7871
  export declare interface VertexAISearch {
7871
7872
  /** 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. */
7872
7873
  dataStoreSpecs?: VertexAISearchDataStoreSpec[];
@@ -7880,7 +7881,7 @@ export declare interface VertexAISearch {
7880
7881
  maxResults?: number;
7881
7882
  }
7882
7883
 
7883
- /** 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 */
7884
+ /** 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. */
7884
7885
  export declare interface VertexAISearchDataStoreSpec {
7885
7886
  /** Full resource name of DataStore, such as Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` */
7886
7887
  dataStore?: string;
@@ -7888,7 +7889,7 @@ export declare interface VertexAISearchDataStoreSpec {
7888
7889
  filter?: string;
7889
7890
  }
7890
7891
 
7891
- /** Retrieve from Vertex RAG Store for grounding. */
7892
+ /** Retrieve from Vertex RAG Store for grounding. This data type is not supported in Gemini API. */
7892
7893
  export declare interface VertexRagStore {
7893
7894
  /** Optional. Deprecated. Please use rag_resources instead. */
7894
7895
  ragCorpora?: string[];
@@ -7904,7 +7905,7 @@ export declare interface VertexRagStore {
7904
7905
  vectorDistanceThreshold?: number;
7905
7906
  }
7906
7907
 
7907
- /** The definition of the Rag resource. */
7908
+ /** The definition of the Rag resource. This data type is not supported in Gemini API. */
7908
7909
  export declare interface VertexRagStoreRagResource {
7909
7910
  /** Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}` */
7910
7911
  ragCorpus?: string;