@google/genai 1.24.0 → 1.26.0

package/dist/web/web.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. */
@@ -3448,8 +3457,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[];
 }
 
@@ -3641,22 +3649,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.
      */
@@ -3676,7 +3684,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. */
@@ -4082,9 +4094,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[];
 }
 
@@ -6911,10 +6923,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
@@ -6969,11 +6989,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. */
@@ -7219,6 +7240,7 @@ declare namespace types {
         createModelContent,
         Outcome,
         Language,
+        FunctionResponseScheduling,
         Type,
         HarmCategory,
         HarmBlockMethod,
@@ -7262,7 +7284,6 @@ declare namespace types {
         EndSensitivity,
         ActivityHandling,
         TurnCoverage,
-        FunctionResponseScheduling,
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
@@ -7410,7 +7431,6 @@ declare namespace types {
         DeleteModelConfig,
         DeleteModelParameters,
         DeleteModelResponse,
-        GenerationConfigThinkingConfig,
         GenerationConfig,
         CountTokensConfig,
         CountTokensParameters,
@@ -7546,6 +7566,7 @@ declare namespace types {
         LiveServerSessionResumptionUpdate,
         LiveServerMessage,
         OperationFromAPIResponseParameters,
+        GenerationConfigThinkingConfig,
         AutomaticActivityDetection,
         RealtimeInputConfig,
         SessionResumptionConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/genai",
-  "version": "1.24.0",
+  "version": "1.26.0",
   "description": "",
   "type": "module",
   "main": "dist/node/index.mjs",
@@ -82,9 +82,11 @@
   "devDependencies": {
     "@eslint/js": "9.20.0",
     "@microsoft/api-extractor": "^7.52.9",
+    "@modelcontextprotocol/sdk": "^1.20.1",
     "@rollup/plugin-json": "^6.1.0",
     "@types/jasmine": "^5.1.2",
     "@types/node": "^20.9.0",
+    "@types/node-fetch": "^2.6.13",
     "@types/unist": "^3.0.3",
     "@types/ws": "^8.5.14",
     "c8": "^10.1.3",
@@ -92,6 +94,7 @@
     "gts": "^5.2.0",
     "jasmine": "^5.5.0",
     "jasmine-reporters": "^2.4.0",
+    "node-fetch": "^3.3.2",
     "npm-run-all": "^4.1.5",
     "nyc": "^17.1.0",
     "prettier": "3.3.3",
@@ -104,15 +107,17 @@
     "typedoc": "^0.27.0",
     "typescript": "~5.2.0",
     "typescript-eslint": "8.24.1",
+    "undici": "^7.16.0",
+    "undici-types": "^7.16.0",
     "zod": "^3.22.4",
     "zod-to-json-schema": "^3.22.4"
   },
   "dependencies": {
-    "google-auth-library": "^9.14.2",
+    "google-auth-library": "^10.3.0",
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.11.4"
+    "@modelcontextprotocol/sdk": "^1.20.1"
   },
   "peerDependenciesMeta": {
     "@modelcontextprotocol/sdk": {