@google/genai 2.9.0 → 2.10.0

package/dist/web/web.d.ts

@@ -1031,7 +1031,7 @@ export declare interface BatchJob {
     outputInfo?: BatchJobOutputInfo;
 }
 
-/** Config for `des` parameter. */
+/** Config for `dest` parameter. */
 export declare interface BatchJobDestination {
     /** Storage format of the output files. Must be one of:
      'jsonl', 'bigquery', 'vertex-dataset'.
@@ -1752,15 +1752,12 @@ declare type ComputerUse$ = ComputerUse_2;
 export declare interface ComputerUse {
     /** Required. The environment being operated. */
     environment?: Environment;
-    /** By default, predefined functions are included in the final model call.
-     Some of them can be explicitly excluded from being automatically included.
-     This can serve two purposes:
-     1. Using a more restricted / different action space.
-     2. Improving the definitions / instructions of predefined functions. */
+    /** Optional. By default, [predefined functions](https://cloud.google.com/vertex-ai/generative-ai/docs/computer-use#supported-actions) are included in the final model call. Some of them can be explicitly excluded from being automatically included. This can serve two purposes: 1. Using a more restricted / different action space. 2. Improving the definitions / instructions of predefined functions. */
     excludedPredefinedFunctions?: string[];
-    /** Optional. Whether enable the prompt injection detection check on computer-use request.
-     */
+    /** Optional. Enables the prompt injection detection check on computer-use request. */
     enablePromptInjectionDetection?: boolean;
+    /** Optional. Disabled safety policies for computer use. This field is not supported in Vertex AI. */
+    disabledSafetyPolicies?: SafetyPolicy[];
 }
 
 /**
@@ -1783,6 +1780,10 @@ declare type ComputerUse_2 = {
      * request.
      */
     enable_prompt_injection_detection?: boolean | undefined;
+    /**
+     * Optional. Disabled safety policies for computer use.
+     */
+    disabled_safety_policies?: Array<DisabledSafetyPolicy> | undefined;
 };
 
 /** Optional parameters for computing tokens. */
@@ -2935,6 +2936,8 @@ declare type DeleteWebhookRequest = {
  */
 declare type Disabled = "disabled";
 
+declare type DisabledSafetyPolicy = "financial_transactions" | "sensitive_data_modification" | "communication_tool" | "account_creation" | "data_modification" | "user_consent_management" | "legal_terms_and_agreements" | (string & {});
+
 /** Statistics for distillation prompt dataset. These statistics do not include the responses sampled from the teacher model. This data type is not supported in Gemini API. */
 export declare interface DistillationDataStats {
     /** Output only. Statistics computed for the training dataset. */
@@ -3550,6 +3553,8 @@ declare type EnvironmentNetworkEgressAllowlist = Allowlist | Disabled;
 
 declare type Error$ = ErrorT;
 
+declare type Error$2 = Status;
+
 declare type ErrorEvent$ = ErrorEvent_2;
 
 declare type ErrorEvent_2 = {
@@ -3845,7 +3850,7 @@ export declare class Files extends BaseModule {
      *     file extension.
      *  - For Blob object inputs, the `mimeType` will be set to the Blob's `type`
      *     property.
-     * Somex eamples for file extension to mimeType mapping:
+     * Some examples for file extension to mimeType mapping:
      * .txt -> text/plain
      * .json -> application/json
      * .jpg  -> image/jpeg
@@ -5344,6 +5349,10 @@ declare type GenerationConfig_2 = {
      * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     image_config?: ImageConfig_2 | undefined;
+    /**
+     * Configuration options for video generation.
+     */
+    video_config?: VideoConfig | undefined;
     /**
      * Penalizes tokens that have already appeared in the generated
      *
@@ -7221,7 +7230,8 @@ export declare namespace Interactions {
     export type MCPServerToolCallStep = MCPServerToolCallStep$;
     export type MCPServerToolResultStep = MCPServerToolResultStep$;
     export type Model = Model$;
-    export type ModelOutputStep = ModelOutputStep$;
+    export interface ModelOutputStep extends ModelOutputStep$ {
+    }
     export interface PlaceCitation extends PlaceCitation$ {
     }
     export type SpeechConfig = SpeechConfig$;
@@ -7249,7 +7259,9 @@ export declare namespace Interactions {
     export interface Usage extends Usage$ {
     }
     export type UserInputStep = UserInputStep$;
+    export type VideoConfig = VideoConfig$;
     export type VideoContent = VideoContent$;
+    export type VideoResponseFormat = VideoResponseFormat$;
     export type WebhookConfig = WebhookConfig$;
     export namespace CodeExecutionCallStep {
         export type Arguments = Arguments$;
@@ -7306,6 +7318,9 @@ export declare namespace Interactions {
     export namespace InteractionStatusUpdate {
         export type Metadata = Metadata$4;
     }
+    export namespace ModelOutputStep {
+        export type Error = Error$2;
+    }
     export namespace PlaceCitation {
         export type ReviewSnippet = ReviewSnippet$3;
     }
@@ -7391,6 +7406,7 @@ declare namespace interactions {
         CodeExecutionResultStep,
         CodeExecution,
         EnvironmentEnum,
+        DisabledSafetyPolicy,
         ComputerUse_2 as ComputerUse,
         Content_2 as Content,
         CreateAgentInteractionResponseFormat,
@@ -7510,6 +7526,7 @@ declare namespace interactions {
         SourceType,
         Source,
         SpeechConfig_2 as SpeechConfig,
+        Status,
         StepDeltaData,
         StepDeltaMetadata,
         StepDelta,
@@ -7546,10 +7563,15 @@ declare namespace interactions {
         Usage,
         UserInputStep,
         VertexAISearchConfig,
+        Task,
+        VideoConfig,
         VideoContentMimeType,
         VideoContent,
         VideoDeltaMimeType,
         VideoDelta,
+        VideoResponseFormatDelivery,
+        VideoResponseFormatAspectRatio,
+        VideoResponseFormat,
         WebhookConfig_2 as WebhookConfig
     }
 }
@@ -8776,9 +8798,9 @@ export declare interface LiveServerSessionResumptionUpdate {
     resumable?: boolean;
     /** Index of last message sent by client that is included in state represented by this SessionResumptionToken. Only sent when `SessionResumptionConfig.transparent` is set.
 
-     Presence of this index allows users to transparently reconnect and avoid issue of losing some part of realtime audio input/video. If client wishes to temporarily disconnect (for example as result of receiving GoAway) they can do it without losing state by buffering messages sent since last `SessionResmumptionTokenUpdate`. This field will enable them to limit buffering (avoid keeping all requests in RAM).
+     Presence of this index allows users to transparently reconnect and avoid issue of losing some part of realtime audio input/video. If client wishes to temporarily disconnect (for example as result of receiving GoAway) they can do it without losing state by buffering messages sent since last `SessionResumptionTokenUpdate`. This field will enable them to limit buffering (avoid keeping all requests in RAM).
 
-     Note: This should not be used for when resuming a session at some time later -- in those cases partial audio and video frames arelikely not needed. */
+     Note: This should not be used for when resuming a session at some time later -- in those cases partial audio and video frames are likely not needed. */
     lastConsumedClientMessageIndex?: string;
 }
 
@@ -9240,6 +9262,18 @@ declare type ModelOutputStep$ = ModelOutputStep;
 declare type ModelOutputStep = {
     type: "model_output";
     content?: Array<Content_2> | undefined;
+    /**
+     * The `Status` type defines a logical error model that is suitable for
+     *
+     * @remarks
+     * 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).
+     */
+    error?: Status | undefined;
 };
 
 export declare class Models extends BaseModule {
@@ -9313,7 +9347,7 @@ export declare class Models extends BaseModule {
      * To maintain backward compatibility, we move the data that was treated as
      * JSON schema from the responseSchema field to the responseJsonSchema field.
      */
-    private maybeMoveToResponseJsonSchem;
+    private maybeMoveToResponseJsonSchema;
     /**
      * Makes an API request to generate content with a given model and yields the
      * response in chunks.
@@ -10841,7 +10875,7 @@ export declare enum ResourceScope {
     COLLECTION = "COLLECTION"
 }
 
-declare type ResponseFormat = AudioResponseFormat | TextResponseFormat | ImageResponseFormat | {
+declare type ResponseFormat = AudioResponseFormat | TextResponseFormat | ImageResponseFormat | VideoResponseFormat | {
     [k: string]: any;
 };
 
@@ -11033,6 +11067,42 @@ export declare enum SafetyFilterLevel {
     BLOCK_NONE = "BLOCK_NONE"
 }
 
+/** SafetyPolicy */
+export declare enum SafetyPolicy {
+    /**
+     * Unspecified safety policy.
+     */
+    SAFETY_POLICY_UNSPECIFIED = "SAFETY_POLICY_UNSPECIFIED",
+    /**
+     * Safety policy for financial transactions.
+     */
+    FINANCIAL_TRANSACTIONS = "FINANCIAL_TRANSACTIONS",
+    /**
+     * Safety policy for sensitive data modification.
+     */
+    SENSITIVE_DATA_MODIFICATION = "SENSITIVE_DATA_MODIFICATION",
+    /**
+     * Safety policy for communication tools (e.g. Gmail, Chat, Meet).
+     */
+    COMMUNICATION_TOOL = "COMMUNICATION_TOOL",
+    /**
+     * Safety policy for account creation.
+     */
+    ACCOUNT_CREATION = "ACCOUNT_CREATION",
+    /**
+     * Safety policy for data modification.
+     */
+    DATA_MODIFICATION = "DATA_MODIFICATION",
+    /**
+     * Safety policy for user consent management.
+     */
+    USER_CONSENT_MANAGEMENT = "USER_CONSENT_MANAGEMENT",
+    /**
+     * Safety policy for legal terms and agreements.
+     */
+    LEGAL_TERMS_AND_AGREEMENTS = "LEGAL_TERMS_AND_AGREEMENTS"
+}
+
 /** A safety rating for a piece of content. The safety rating contains the harm category and the harm probability level. */
 export declare interface SafetyRating {
     /** Output only. Indicates whether the content was blocked because of this rating. */
@@ -11661,6 +11731,48 @@ export declare enum StartSensitivity {
     START_SENSITIVITY_LOW = "START_SENSITIVITY_LOW"
 }
 
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * The `Status` type defines a logical error model that is suitable for
+ *
+ * @remarks
+ * 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).
+ */
+declare type Status = {
+    /**
+     * The status code, which should be an enum value of google.rpc.Code.
+     */
+    code?: number | undefined;
+    /**
+     * A developer-facing error message, which should be in English. Any
+     *
+     * @remarks
+     * user-facing error message should be localized and sent in the
+     * google.rpc.Status.details field, or localized by the client.
+     */
+    message?: string | undefined;
+    /**
+     * A list of messages that carry the error details.  There is a common set of
+     *
+     * @remarks
+     * message types for APIs to use.
+     */
+    details?: Array<{
+        [k: string]: any;
+    }> | undefined;
+};
+
 declare type Step$ = Step;
 
 /**
@@ -11723,6 +11835,14 @@ declare type StepStop$ = StepStop;
 declare type StepStop = {
     event_type: "step.stop";
     index: number;
+    /**
+     * Statistics on the interaction request's token usage.
+     */
+    usage?: Usage | undefined;
+    /**
+     * Statistics on the interaction request's token usage.
+     */
+    step_usage?: Usage | undefined;
     /**
      * The event_id token to be used to resume the interaction stream, from
      *
@@ -11935,6 +12055,22 @@ export declare interface SupervisedTuningSpec {
     validationDatasetUri?: string;
 }
 
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * Optional task mode for video generation. If not specified, the model
+ *
+ * @remarks
+ * automatically determines the appropriate mode based on the provided text
+ * prompt and input media.
+ */
+declare type Task = "text_to_video" | "image_to_video" | "reference_to_video" | "edit" | (string & {});
+
 export declare interface TestTableFile {
     comment?: string;
     testMethod?: string;
@@ -12244,9 +12380,7 @@ declare type Tool$ = Tool_2;
 export declare interface Tool {
     /** 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. Tool to support the model interacting directly with the
-     computer. If enabled, it automatically populates computer-use specific
-     Function Declarations. */
+    /** Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations. */
     computerUse?: ComputerUse;
     /** Optional. FileSearch tool type. Tool to retrieve knowledge from Semantic Retrieval corpora. This field is not supported in Vertex AI. */
     fileSearch?: FileSearch;
@@ -12968,10 +13102,11 @@ declare namespace types {
         Language,
         FunctionResponseScheduling,
         Type,
-        Environment,
         AuthType,
         HttpElementLocation,
         ApiSpec,
+        Environment,
+        SafetyPolicy,
         PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
@@ -13055,7 +13190,6 @@ declare namespace types {
         HttpOptions,
         Schema,
         ModelSelectionConfig,
-        ComputerUse,
         ApiKeyConfig,
         AuthConfigGoogleServiceAccountConfig,
         AuthConfigHttpBasicAuthConfig,
@@ -13079,6 +13213,7 @@ declare namespace types {
         RagRetrievalConfig,
         VertexRagStore,
         Retrieval,
+        ComputerUse,
         FileSearch,
         WebSearch,
         ImageSearch,
@@ -14249,6 +14384,22 @@ export declare enum VideoCompressionQuality {
     LOSSLESS = "LOSSLESS"
 }
 
+declare type VideoConfig$ = VideoConfig;
+
+/**
+ * Configuration options for video generation.
+ */
+declare type VideoConfig = {
+    /**
+     * Optional task mode for video generation. If not specified, the model
+     *
+     * @remarks
+     * automatically determines the appropriate mode based on the provided text
+     * prompt and input media.
+     */
+    task?: Task | undefined;
+};
+
 declare type VideoContent$ = VideoContent;
 
 /**
@@ -14373,6 +14524,51 @@ export declare enum VideoOrientation {
     PORTRAIT = "PORTRAIT"
 }
 
+declare type VideoResponseFormat$ = VideoResponseFormat;
+
+/**
+ * Configuration for video output format.
+ */
+declare type VideoResponseFormat = {
+    type: "video";
+    /**
+     * The delivery mode for the video output.
+     */
+    delivery?: VideoResponseFormatDelivery | undefined;
+    /**
+     * The GCS URI to store the video output. Required for Vertex if delivery mode
+     *
+     * @remarks
+     * is URI.
+     */
+    gcs_uri?: string | undefined;
+    /**
+     * The aspect ratio for the video output.
+     */
+    aspect_ratio?: VideoResponseFormatAspectRatio | undefined;
+    /**
+     * The duration for the video output.
+     */
+    duration?: string | undefined;
+};
+
+/**
+ * The aspect ratio for the video output.
+ */
+declare type VideoResponseFormatAspectRatio = "16:9" | "9:16" | (string & {});
+
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * The delivery mode for the video output.
+ */
+declare type VideoResponseFormatDelivery = "inline" | "uri" | (string & {});
+
 /**
  * Whether to include visualizations in the response.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/genai",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "",
   "type": "module",
   "main": "dist/node/index.mjs",