@google/genai 1.25.0 → 1.26.0

package/dist/genai.d.ts

@@ -646,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. */
@@ -2839,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[];
 }
 
@@ -3146,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. */
@@ -3173,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. */
@@ -3442,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[];
 }
 
@@ -3635,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.
      */
@@ -3670,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. */
@@ -4076,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[];
 }
 
@@ -6905,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
@@ -6963,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. */
@@ -7213,6 +7235,7 @@ declare namespace types {
         createModelContent,
         Outcome,
         Language,
+        FunctionResponseScheduling,
         Type,
         HarmCategory,
         HarmBlockMethod,
@@ -7256,7 +7279,6 @@ declare namespace types {
         EndSensitivity,
         ActivityHandling,
         TurnCoverage,
-        FunctionResponseScheduling,
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
@@ -7404,7 +7426,6 @@ declare namespace types {
         DeleteModelConfig,
         DeleteModelParameters,
         DeleteModelResponse,
-        GenerationConfigThinkingConfig,
         GenerationConfig,
         CountTokensConfig,
         CountTokensParameters,
@@ -7540,6 +7561,7 @@ declare namespace types {
         LiveServerSessionResumptionUpdate,
         LiveServerMessage,
         OperationFromAPIResponseParameters,
+        GenerationConfigThinkingConfig,
         AutomaticActivityDetection,
         RealtimeInputConfig,
         SessionResumptionConfig,

package/dist/index.cjs

@@ -504,6 +504,26 @@ exports.Language = void 0;
      */
     Language["PYTHON"] = "PYTHON";
 })(exports.Language || (exports.Language = {}));
+/** Specifies how the response should be scheduled in the conversation. */
+exports.FunctionResponseScheduling = void 0;
+(function (FunctionResponseScheduling) {
+    /**
+     * This value is unused.
+     */
+    FunctionResponseScheduling["SCHEDULING_UNSPECIFIED"] = "SCHEDULING_UNSPECIFIED";
+    /**
+     * Only add the result to the conversation context, do not interrupt or trigger generation.
+     */
+    FunctionResponseScheduling["SILENT"] = "SILENT";
+    /**
+     * Add the result to the conversation context, and prompt to generate output without interrupting ongoing generation.
+     */
+    FunctionResponseScheduling["WHEN_IDLE"] = "WHEN_IDLE";
+    /**
+     * Add the result to the conversation context, interrupt ongoing generation and prompt to generate output.
+     */
+    FunctionResponseScheduling["INTERRUPT"] = "INTERRUPT";
+})(exports.FunctionResponseScheduling || (exports.FunctionResponseScheduling = {}));
 /** Optional. The type of the data. */
 exports.Type = void 0;
 (function (Type) {
@@ -547,22 +567,22 @@ exports.HarmCategory = void 0;
      * The harm category is unspecified.
      */
     HarmCategory["HARM_CATEGORY_UNSPECIFIED"] = "HARM_CATEGORY_UNSPECIFIED";
-    /**
-     * The harm category is hate speech.
-     */
-    HarmCategory["HARM_CATEGORY_HATE_SPEECH"] = "HARM_CATEGORY_HATE_SPEECH";
-    /**
-     * The harm category is dangerous content.
-     */
-    HarmCategory["HARM_CATEGORY_DANGEROUS_CONTENT"] = "HARM_CATEGORY_DANGEROUS_CONTENT";
     /**
      * The harm category is harassment.
      */
     HarmCategory["HARM_CATEGORY_HARASSMENT"] = "HARM_CATEGORY_HARASSMENT";
+    /**
+     * The harm category is hate speech.
+     */
+    HarmCategory["HARM_CATEGORY_HATE_SPEECH"] = "HARM_CATEGORY_HATE_SPEECH";
     /**
      * The harm category is sexually explicit content.
      */
     HarmCategory["HARM_CATEGORY_SEXUALLY_EXPLICIT"] = "HARM_CATEGORY_SEXUALLY_EXPLICIT";
+    /**
+     * The harm category is dangerous content.
+     */
+    HarmCategory["HARM_CATEGORY_DANGEROUS_CONTENT"] = "HARM_CATEGORY_DANGEROUS_CONTENT";
     /**
      * Deprecated: Election filter is not longer supported. The harm category is civic integrity.
      */
@@ -583,6 +603,10 @@ exports.HarmCategory = void 0;
      * The harm category is image sexually explicit content.
      */
     HarmCategory["HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT"] = "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT";
+    /**
+     * The harm category is for jailbreak prompts.
+     */
+    HarmCategory["HARM_CATEGORY_JAILBREAK"] = "HARM_CATEGORY_JAILBREAK";
 })(exports.HarmCategory || (exports.HarmCategory = {}));
 /** Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. */
 exports.HarmBlockMethod = void 0;
@@ -823,33 +847,41 @@ exports.HarmSeverity = void 0;
      */
     HarmSeverity["HARM_SEVERITY_HIGH"] = "HARM_SEVERITY_HIGH";
 })(exports.HarmSeverity || (exports.HarmSeverity = {}));
-/** Output only. Blocked reason. */
+/** Output only. The reason why the prompt was blocked. */
 exports.BlockedReason = void 0;
 (function (BlockedReason) {
     /**
-     * Unspecified blocked reason.
+     * The blocked reason is unspecified.
      */
     BlockedReason["BLOCKED_REASON_UNSPECIFIED"] = "BLOCKED_REASON_UNSPECIFIED";
     /**
-     * Candidates blocked due to safety.
+     * The prompt was blocked for safety reasons.
      */
     BlockedReason["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.
      */
     BlockedReason["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.
      */
     BlockedReason["BLOCKLIST"] = "BLOCKLIST";
     /**
-     * Candidates blocked due to prohibited content.
+     * The prompt was blocked because it contains prohibited content.
      */
     BlockedReason["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.
      */
     BlockedReason["IMAGE_SAFETY"] = "IMAGE_SAFETY";
+    /**
+     * The prompt was blocked by Model Armor.
+     */
+    BlockedReason["MODEL_ARMOR"] = "MODEL_ARMOR";
+    /**
+     * The prompt was blocked as a jailbreak attempt.
+     */
+    BlockedReason["JAILBREAK"] = "JAILBREAK";
 })(exports.BlockedReason || (exports.BlockedReason = {}));
 /** Output only. Traffic type. This shows whether a request consumes Pay-As-You-Go or Provisioned Throughput quota. */
 exports.TrafficType = void 0;
@@ -1384,26 +1416,6 @@ exports.TurnCoverage = void 0;
      */
     TurnCoverage["TURN_INCLUDES_ALL_INPUT"] = "TURN_INCLUDES_ALL_INPUT";
 })(exports.TurnCoverage || (exports.TurnCoverage = {}));
-/** Specifies how the response should be scheduled in the conversation. */
-exports.FunctionResponseScheduling = void 0;
-(function (FunctionResponseScheduling) {
-    /**
-     * This value is unused.
-     */
-    FunctionResponseScheduling["SCHEDULING_UNSPECIFIED"] = "SCHEDULING_UNSPECIFIED";
-    /**
-     * Only add the result to the conversation context, do not interrupt or trigger generation.
-     */
-    FunctionResponseScheduling["SILENT"] = "SILENT";
-    /**
-     * Add the result to the conversation context, and prompt to generate output without interrupting ongoing generation.
-     */
-    FunctionResponseScheduling["WHEN_IDLE"] = "WHEN_IDLE";
-    /**
-     * Add the result to the conversation context, interrupt ongoing generation and prompt to generate output.
-     */
-    FunctionResponseScheduling["INTERRUPT"] = "INTERRUPT";
-})(exports.FunctionResponseScheduling || (exports.FunctionResponseScheduling = {}));
 /** Scale of the generated music. */
 exports.Scale = void 0;
 (function (Scale) {
@@ -1701,7 +1713,7 @@ class HttpResponse {
         return this.responseInternal.json();
     }
 }
-/** 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. */
 class GenerateContentResponsePromptFeedback {
 }
 /** Usage metadata about response(s). */
@@ -6181,7 +6193,7 @@ const CONTENT_TYPE_HEADER = 'Content-Type';
 const SERVER_TIMEOUT_HEADER = 'X-Server-Timeout';
 const USER_AGENT_HEADER = 'User-Agent';
 const GOOGLE_API_CLIENT_HEADER = 'x-goog-api-client';
-const SDK_VERSION = '1.25.0'; // x-release-please-version
+const SDK_VERSION = '1.26.0'; // x-release-please-version
 const LIBRARY_LABEL = `google-genai-sdk/${SDK_VERSION}`;
 const VERTEX_AI_API_DEFAULT_VERSION = 'v1beta1';
 const GOOGLE_AI_API_DEFAULT_VERSION = 'v1beta';
@@ -7453,6 +7465,10 @@ function generationConfigToVertex$1(fromObject) {
     if (fromTopP != null) {
         setValueByPath(toObject, ['topP'], fromTopP);
     }
+    if (getValueByPath(fromObject, ['enableEnhancedCivicAnswers']) !==
+        undefined) {
+        throw new Error('enableEnhancedCivicAnswers parameter is not supported in Vertex AI.');
+    }
     return toObject;
 }
 function googleMapsToMldev$2(fromObject) {
@@ -10112,6 +10128,10 @@ function generationConfigToVertex(fromObject) {
     if (fromTopP != null) {
         setValueByPath(toObject, ['topP'], fromTopP);
     }
+    if (getValueByPath(fromObject, ['enableEnhancedCivicAnswers']) !==
+        undefined) {
+        throw new Error('enableEnhancedCivicAnswers parameter is not supported in Vertex AI.');
+    }
     return toObject;
 }
 function getModelParametersToMldev(apiClient, fromObject) {
@@ -14800,46 +14820,6 @@ function tuningJobFromMldev(fromObject) {
     if (fromTunedModel != null) {
         setValueByPath(toObject, ['tunedModel'], tunedModelFromMldev(fromTunedModel));
     }
-    const fromCustomBaseModel = getValueByPath(fromObject, [
-        'customBaseModel',
-    ]);
-    if (fromCustomBaseModel != null) {
-        setValueByPath(toObject, ['customBaseModel'], fromCustomBaseModel);
-    }
-    const fromExperiment = getValueByPath(fromObject, ['experiment']);
-    if (fromExperiment != null) {
-        setValueByPath(toObject, ['experiment'], fromExperiment);
-    }
-    const fromLabels = getValueByPath(fromObject, ['labels']);
-    if (fromLabels != null) {
-        setValueByPath(toObject, ['labels'], fromLabels);
-    }
-    const fromOutputUri = getValueByPath(fromObject, ['outputUri']);
-    if (fromOutputUri != null) {
-        setValueByPath(toObject, ['outputUri'], fromOutputUri);
-    }
-    const fromPipelineJob = getValueByPath(fromObject, ['pipelineJob']);
-    if (fromPipelineJob != null) {
-        setValueByPath(toObject, ['pipelineJob'], fromPipelineJob);
-    }
-    const fromServiceAccount = getValueByPath(fromObject, [
-        'serviceAccount',
-    ]);
-    if (fromServiceAccount != null) {
-        setValueByPath(toObject, ['serviceAccount'], fromServiceAccount);
-    }
-    const fromTunedModelDisplayName = getValueByPath(fromObject, [
-        'tunedModelDisplayName',
-    ]);
-    if (fromTunedModelDisplayName != null) {
-        setValueByPath(toObject, ['tunedModelDisplayName'], fromTunedModelDisplayName);
-    }
-    const fromVeoTuningSpec = getValueByPath(fromObject, [
-        'veoTuningSpec',
-    ]);
-    if (fromVeoTuningSpec != null) {
-        setValueByPath(toObject, ['veoTuningSpec'], fromVeoTuningSpec);
-    }
     return toObject;
 }
 function tuningJobFromVertex(fromObject) {