@google/genai 1.24.0 → 1.26.0

package/dist/genai.d.ts

@@ -467,7 +467,6 @@ export declare class Batches extends BaseModule {
      */
     list: (params?: types.ListBatchJobsParameters) => Promise<Pager<types.BatchJob>>;
     private createInlinedGenerateContentRequest;
-    private createInlinedEmbedContentRequest;
     private getGcsUri;
     private getBigqueryUri;
     private formatDestination;
@@ -647,32 +646,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.
+     */
+    MODEL_ARMOR = "MODEL_ARMOR",
+    /**
+     * The prompt was blocked as a jailbreak attempt.
+     */
+    JAILBREAK = "JAILBREAK"
 }
 
 /** A resource used in LLM queries for users to explicitly specify what to cache. */
@@ -2840,13 +2847,13 @@ 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. */
     blockReasonMessage?: string;
-    /** Output only. Safety ratings. */
+    /** Output only. A list of safety ratings for the prompt. There is one rating per category. */
     safetyRatings?: SafetyRating[];
 }
 
@@ -3147,11 +3154,13 @@ 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. */
+    enableEnhancedCivicAnswers?: boolean;
 }
 
 /** The configuration for routing the request to a specific model. */
@@ -3174,12 +3183,12 @@ export declare interface GenerationConfigRoutingConfigManualRoutingMode {
     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. */
@@ -3443,8 +3452,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"]. */
     excludeDomains?: string[];
 }
 
@@ -3636,22 +3644,22 @@ 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.
      */
@@ -3671,7 +3679,11 @@ export declare enum HarmCategory {
     /**
      * The harm category is image sexually explicit content.
      */
-    HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT = "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT"
+    HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT = "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT",
+    /**
+     * The harm category is for jailbreak prompts.
+     */
+    HARM_CATEGORY_JAILBREAK = "HARM_CATEGORY_JAILBREAK"
 }
 
 /** Output only. Harm probability levels in the content. */
@@ -4077,9 +4089,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[];
 }
 
@@ -6906,10 +6918,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
@@ -6964,11 +6984,12 @@ export declare interface TuningDataStats {
     supervisedTuningDataStats?: SupervisedTuningDataStats;
 }
 
+/** A single example for tuning. */
 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. */
@@ -7214,6 +7235,7 @@ declare namespace types {
         createModelContent,
         Outcome,
         Language,
+        FunctionResponseScheduling,
         Type,
         HarmCategory,
         HarmBlockMethod,
@@ -7257,7 +7279,6 @@ declare namespace types {
         EndSensitivity,
         ActivityHandling,
         TurnCoverage,
-        FunctionResponseScheduling,
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
@@ -7405,7 +7426,6 @@ declare namespace types {
         DeleteModelConfig,
         DeleteModelParameters,
         DeleteModelResponse,
-        GenerationConfigThinkingConfig,
         GenerationConfig,
         CountTokensConfig,
         CountTokensParameters,
@@ -7541,6 +7561,7 @@ declare namespace types {
         LiveServerSessionResumptionUpdate,
         LiveServerMessage,
         OperationFromAPIResponseParameters,
+        GenerationConfigThinkingConfig,
         AutomaticActivityDetection,
         RealtimeInputConfig,
         SessionResumptionConfig,