@google/genai 1.48.0 → 1.50.0

package/dist/node/node.d.ts

@@ -465,6 +465,10 @@ export declare interface AudioChunk {
  */
 declare interface AudioContent {
     type: 'audio';
+    /**
+     * The number of audio channels.
+     */
+    channels?: number;
     /**
      * The audio content.
      */
@@ -472,7 +476,11 @@ declare interface AudioContent {
     /**
      * The mime type of the audio.
      */
-    mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
+    mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a' | 'audio/l16' | 'audio/opus' | 'audio/alaw' | 'audio/mulaw';
+    /**
+     * The sample rate of the audio.
+     */
+    rate?: number;
     /**
      * The URI of the audio.
      */
@@ -624,6 +632,18 @@ export declare interface AutomaticFunctionCallingConfig {
     ignoreCallHistory?: boolean;
 }
 
+/** Configures the avatar to be used in the session. */
+export declare interface AvatarConfig {
+    /** Pre-built avatar id. */
+    avatarName?: string;
+    /** Customized avatar appearance with a reference image. */
+    customizedAvatar?: CustomizedAvatar;
+    /** The bitrate of compressed audio. */
+    audioBitrateBps?: number;
+    /** The bitrate of compressed video output. */
+    videoBitrateBps?: number;
+}
+
 declare class BadRequestError extends APIError<400, Headers> {
 }
 
@@ -653,24 +673,26 @@ declare interface BaseCreateAgentInteractionParams {
      */
     previous_interaction_id?: string;
     /**
-     * Body param: Enforces that the generated response is a JSON object that complies with
-     * the JSON schema specified in this field.
+     * Body param: Enforces that the generated response is a JSON object that complies
+     * with the JSON schema specified in this field.
      */
     response_format?: unknown;
     /**
-     * Body param: The mime type of the response. This is required if response_format is set.
+     * Body param: The mime type of the response. This is required if response_format
+     * is set.
      */
     response_mime_type?: string;
     /**
      * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
-    response_modalities?: Array<'text' | 'image' | 'audio'>;
+    response_modalities?: Array<'text' | 'image' | 'audio' | 'video' | 'document'>;
     /**
      * Body param: The service tier for the interaction.
      */
     service_tier?: 'flex' | 'standard' | 'priority';
     /**
-     * Body param: Input only. Whether to store the response and request for later retrieval.
+     * Body param: Input only. Whether to store the response and request for later
+     * retrieval.
      */
     store?: boolean;
     /**
@@ -685,6 +707,11 @@ declare interface BaseCreateAgentInteractionParams {
      * Body param: A list of tool declarations the model may call during interaction.
      */
     tools?: Array<Tool_2>;
+    /**
+     * Body param: Optional. Webhook configuration for receiving notifications when the
+     * interaction completes.
+     */
+    webhook_config?: WebhookConfig_2;
 }
 
 declare interface BaseCreateModelInteractionParams {
@@ -713,24 +740,26 @@ declare interface BaseCreateModelInteractionParams {
      */
     previous_interaction_id?: string;
     /**
-     * Body param: Enforces that the generated response is a JSON object that complies with
-     * the JSON schema specified in this field.
+     * Body param: Enforces that the generated response is a JSON object that complies
+     * with the JSON schema specified in this field.
      */
     response_format?: unknown;
     /**
-     * Body param: The mime type of the response. This is required if response_format is set.
+     * Body param: The mime type of the response. This is required if response_format
+     * is set.
      */
     response_mime_type?: string;
     /**
      * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
-    response_modalities?: Array<'text' | 'image' | 'audio'>;
+    response_modalities?: Array<'text' | 'image' | 'audio' | 'video' | 'document'>;
     /**
      * Body param: The service tier for the interaction.
      */
     service_tier?: 'flex' | 'standard' | 'priority';
     /**
-     * Body param: Input only. Whether to store the response and request for later retrieval.
+     * Body param: Input only. Whether to store the response and request for later
+     * retrieval.
      */
     store?: boolean;
     /**
@@ -745,6 +774,11 @@ declare interface BaseCreateModelInteractionParams {
      * Body param: A list of tool declarations the model may call during interaction.
      */
     tools?: Array<Tool_2>;
+    /**
+     * Body param: Optional. Webhook configuration for receiving notifications when the
+     * interaction completes.
+     */
+    webhook_config?: WebhookConfig_2;
 }
 
 /**
@@ -846,7 +880,7 @@ declare class BaseInteractions extends APIResource {
      * ```ts
      * const interaction = await client.interactions.create({
      *   api_version: 'api_version',
-     *   input: [{ text: 'text', type: 'text' }],
+     *   input: { text: 'text', type: 'text' },
      *   model: 'gemini-2.5-computer-use-preview-10-2025',
      * });
      * ```
@@ -868,7 +902,8 @@ declare class BaseInteractions extends APIResource {
      */
     delete(id: string, params?: InteractionDeleteParams | null | undefined, options?: RequestOptions): APIPromise<unknown>;
     /**
-     * Cancels an interaction by id. This only applies to background interactions that are still running.
+     * Cancels an interaction by id. This only applies to background interactions that
+     * are still running.
      *
      * @example
      * ```ts
@@ -879,7 +914,8 @@ declare class BaseInteractions extends APIResource {
      */
     cancel(id: string, params?: InteractionCancelParams | null | undefined, options?: RequestOptions): APIPromise<Interaction>;
     /**
-     * Retrieves the full details of a single interaction based on its `Interaction.id`.
+     * Retrieves the full details of a single interaction based on its
+     * `Interaction.id`.
      *
      * @example
      * ```ts
@@ -909,6 +945,38 @@ export declare interface BaseUrlParameters {
     vertexUrl?: string;
 }
 
+declare class BaseWebhooks extends APIResource {
+    static readonly _key: readonly ['webhooks'];
+    /**
+     * Creates a new Webhook.
+     */
+    create(params: WebhookCreateParams, options?: RequestOptions): APIPromise<WebhookCreateResponse>;
+    /**
+     * Gets a specific Webhook.
+     */
+    retrieve(id: string, params?: WebhookRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<WebhookRetrieveResponse>;
+    /**
+     * Updates an existing Webhook.
+     */
+    update(id: string, params: WebhookUpdateParams, options?: RequestOptions): APIPromise<WebhookUpdateResponse>;
+    /**
+     * Lists all Webhooks.
+     */
+    list(params?: WebhookListParams | null | undefined, options?: RequestOptions): APIPromise<WebhookListResponse>;
+    /**
+     * Deletes a Webhook.
+     */
+    delete(id: string, params?: WebhookDeleteParams | null | undefined, options?: RequestOptions): APIPromise<WebhookDeleteResponse>;
+    /**
+     * Sends a ping event to a Webhook.
+     */
+    ping(id: string, params?: WebhookPingParams | null | undefined, options?: RequestOptions): APIPromise<WebhookPingResponse>;
+    /**
+     * Generates a new signing secret for a Webhook.
+     */
+    rotateSigningSecret(id: string, params?: WebhookRotateSigningSecretParams | null | undefined, options?: RequestOptions): APIPromise<WebhookRotateSigningSecretResponse>;
+}
+
 export declare class Batches extends BaseModule {
     private readonly apiClient;
     constructor(apiClient: ApiClient);
@@ -1665,7 +1733,7 @@ declare interface ClientOptions {
     /**
      * The adapter to the parent API client instance (for accessing auth, project, location)
      */
-    clientAdapter: GeminiNextGenAPIClientAdapter;
+    clientAdapter?: GeminiNextGenAPIClientAdapter | undefined;
 }
 
 /**
@@ -1828,8 +1896,7 @@ declare interface ContentDelta {
     event_type: 'content.delta';
     index: number;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -1851,8 +1918,16 @@ declare namespace ContentDelta {
     }
     interface Audio {
         type: 'audio';
+        /**
+         * The number of audio channels.
+         */
+        channels?: number;
         data?: string;
-        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
+        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a' | 'audio/l16' | 'audio/opus' | 'audio/alaw' | 'audio/mulaw';
+        /**
+         * The sample rate of the audio.
+         */
+        rate?: number;
         uri?: string;
     }
     interface Document {
@@ -2149,8 +2224,7 @@ declare interface ContentStart {
     event_type: 'content.start';
     index: number;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -2159,8 +2233,7 @@ declare interface ContentStop {
     event_type: 'content.stop';
     index: number;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -2338,6 +2411,10 @@ export declare interface CreateBatchJobConfig {
      "gs://path/to/output/data" or "bq://projectId.bqDatasetId.bqTableId".
      */
     dest?: BatchJobDestinationUnion;
+    /** Webhook configuration for receiving notifications when the batch
+     operation completes.
+     */
+    webhookConfig?: WebhookConfig;
 }
 
 /** Config for batches.create parameters. */
@@ -2665,6 +2742,16 @@ export declare interface CustomCodeExecutionResult {
     score?: number;
 }
 
+/** Configures the customized avatar to be used in the session. */
+export declare interface CustomizedAvatar {
+    /** The mime type of the reference image, e.g., "image/jpeg". */
+    imageMimeType?: string;
+    /** The data of the reference image. The dimensions of the reference
+     image should be 9:16 (portrait) with a minimum resolution of 704x1280.
+     * @remarks Encoded as base64 string. */
+    imageData?: string;
+}
+
 /** User provided metadata stored as key-value pairs. This data type is not supported in Vertex AI. */
 export declare interface CustomMetadata {
     /** Required. The key of the metadata to store. */
@@ -2742,10 +2829,21 @@ export declare interface DatasetStats {
  */
 declare interface DeepResearchAgentConfig {
     type: 'deep-research';
+    /**
+     * Enables human-in-the-loop planning for the Deep Research agent. If set to true,
+     * the Deep Research agent will provide a research plan in its response. The agent
+     * will then proceed only if the user confirms the plan in the next turn. Relevant
+     * issue: b/482352502.
+     */
+    collaborative_planning?: boolean;
     /**
      * Whether to include thought summaries in the response.
      */
     thinking_summaries?: 'auto' | 'none';
+    /**
+     * Whether to include visualizations in the response.
+     */
+    visualization?: 'off' | 'auto';
 }
 
 /** Optional parameters for models.get method. */
@@ -3257,6 +3355,14 @@ export declare interface EmbedContentConfig {
      will lead to an INVALID_ARGUMENT error, similar to other text APIs.
      */
     autoTruncate?: boolean;
+    /** Vertex API only. Whether to enable OCR for document content.
+     Only applicable to Gemini Embedding 2 models.
+     */
+    documentOcr?: boolean;
+    /** Vertex API only. Whether to extract audio from video content.
+     Only applicable to Gemini Embedding 2 models.
+     */
+    audioTrackExtraction?: boolean;
 }
 
 /** Request-level metadata for the Vertex Embed Content API. */
@@ -3399,8 +3505,7 @@ declare interface ErrorEvent_2 {
      */
     error?: ErrorEvent_2.Error;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -4841,6 +4946,9 @@ export declare interface GenerateVideosConfig {
     compressionQuality?: VideoCompressionQuality;
     /** User specified labels to track billing usage. */
     labels?: Record<string, string>;
+    /** Webhook configuration for receiving notifications when the
+     video generation operation completes. */
+    webhookConfig?: WebhookConfig;
 }
 
 /** A video generation operation. */
@@ -5262,7 +5370,11 @@ export declare class GoogleGenAI {
     readonly tunings: Tunings;
     readonly fileSearchStores: FileSearchStores;
     private _interactions;
+    private _webhooks;
+    private _nextGenClient;
+    private getNextGenClient;
     get interactions(): Interactions;
+    get webhooks(): Webhooks;
     constructor(options: GoogleGenAIOptions);
 }
 
@@ -5391,8 +5503,8 @@ declare namespace GoogleMapsResult {
          */
         place_id?: string;
         /**
-         * Snippets of reviews that are used to generate answers about the
-         * features of a given place in Google Maps.
+         * Snippets of reviews that are used to generate answers about the features of a
+         * given place in Google Maps.
          */
         review_snippets?: Array<Place.ReviewSnippet>;
         /**
@@ -5402,8 +5514,8 @@ declare namespace GoogleMapsResult {
     }
     namespace Place {
         /**
-         * Encapsulates a snippet of a user review that answers a question about
-         * the features of a specific place in Google Maps.
+         * Encapsulates a snippet of a user review that answers a question about the
+         * features of a specific place in Google Maps.
          */
         interface ReviewSnippet {
             /**
@@ -5489,7 +5601,7 @@ declare interface GoogleSearchCallContent {
     /**
      * The type of search grounding enabled.
      */
-    search_type?: 'web_search' | 'image_search';
+    search_type?: 'web_search' | 'image_search' | 'enterprise_web_search';
     /**
      * A signature hash for backend validation.
      */
@@ -6235,8 +6347,8 @@ declare interface Interaction {
      */
     id: string;
     /**
-     * Required. Output only. The time at which the response was created in ISO 8601 format
-     * (YYYY-MM-DDThh:mm:ssZ).
+     * Required. Output only. The time at which the response was created in ISO 8601
+     * format (YYYY-MM-DDThh:mm:ssZ).
      */
     created: string;
     /**
@@ -6244,8 +6356,8 @@ declare interface Interaction {
      */
     status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
     /**
-     * Required. Output only. The time at which the response was last updated in ISO 8601 format
-     * (YYYY-MM-DDThh:mm:ssZ).
+     * Required. Output only. The time at which the response was last updated in ISO
+     * 8601 format (YYYY-MM-DDThh:mm:ssZ).
      */
     updated: string;
     /**
@@ -6273,8 +6385,8 @@ declare interface Interaction {
      */
     previous_interaction_id?: string;
     /**
-     * Enforces that the generated response is a JSON object that complies with
-     * the JSON schema specified in this field.
+     * Enforces that the generated response is a JSON object that complies with the
+     * JSON schema specified in this field.
      */
     response_format?: unknown;
     /**
@@ -6284,7 +6396,7 @@ declare interface Interaction {
     /**
      * The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
-    response_modalities?: Array<'text' | 'image' | 'audio'>;
+    response_modalities?: Array<'text' | 'image' | 'audio' | 'video' | 'document'>;
     /**
      * Output only. The role of the interaction.
      */
@@ -6305,6 +6417,11 @@ declare interface Interaction {
      * Output only. Statistics on the interaction request's token usage.
      */
     usage?: Usage;
+    /**
+     * Optional. Webhook configuration for receiving notifications when the interaction
+     * completes.
+     */
+    webhook_config?: WebhookConfig_2;
 }
 
 declare interface InteractionCancelParams {
@@ -6317,13 +6434,12 @@ declare interface InteractionCancelParams {
 declare interface InteractionCompleteEvent {
     event_type: 'interaction.complete';
     /**
-     * Required. The completed interaction with empty outputs to reduce the payload size.
-     * Use the preceding ContentDelta events for the actual output.
+     * Required. The completed interaction with empty outputs to reduce the payload
+     * size. Use the preceding ContentDelta events for the actual output.
      */
     interaction: Interaction;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -6356,25 +6472,30 @@ declare interface InteractionGetParamsBase {
      */
     include_input?: boolean;
     /**
-     * Query param: Optional. If set, resumes the interaction stream from the next chunk after the event marked by the event id. Can only be used if `stream` is true.
+     * Query param: Optional. If set, resumes the interaction stream from the next
+     * chunk after the event marked by the event id. Can only be used if `stream` is
+     * true.
      */
     last_event_id?: string;
     /**
-     * Query param: If set to true, the generated content will be streamed incrementally.
+     * Query param: If set to true, the generated content will be streamed
+     * incrementally.
      */
     stream?: boolean;
 }
 
 declare interface InteractionGetParamsNonStreaming extends InteractionGetParamsBase {
     /**
-     * Query param: If set to true, the generated content will be streamed incrementally.
+     * Query param: If set to true, the generated content will be streamed
+     * incrementally.
      */
     stream?: false;
 }
 
 declare interface InteractionGetParamsStreaming extends InteractionGetParamsBase {
     /**
-     * Query param: If set to true, the generated content will be streamed incrementally.
+     * Query param: If set to true, the generated content will be streamed
+     * incrementally.
      */
     stream: true;
 }
@@ -6383,7 +6504,7 @@ export declare class Interactions extends BaseInteractions {
 }
 
 export declare namespace Interactions {
-    export { type AllowedTools as AllowedTools, type Annotation as Annotation, type AudioContent as AudioContent, type CodeExecutionCallArguments as CodeExecutionCallArguments, type CodeExecutionCallContent as CodeExecutionCallContent, type CodeExecutionResultContent as CodeExecutionResultContent, type Content_2 as Content, type ContentDelta as ContentDelta, type ContentStart as ContentStart, type ContentStop as ContentStop, type DeepResearchAgentConfig as DeepResearchAgentConfig, type DocumentContent as DocumentContent, type DynamicAgentConfig as DynamicAgentConfig, type ErrorEvent_2 as ErrorEvent, type FileCitation as FileCitation, type FileSearchCallContent as FileSearchCallContent, type FileSearchResultContent as FileSearchResultContent, type Function_2 as Function, type FunctionCallContent as FunctionCallContent, type FunctionResultContent as FunctionResultContent, type GenerationConfig_2 as GenerationConfig, type GoogleMapsCallArguments as GoogleMapsCallArguments, type GoogleMapsCallContent as GoogleMapsCallContent, type GoogleMapsResult as GoogleMapsResult, type GoogleMapsResultContent as GoogleMapsResultContent, type GoogleSearchCallArguments as GoogleSearchCallArguments, type GoogleSearchCallContent as GoogleSearchCallContent, type GoogleSearchResult as GoogleSearchResult, type GoogleSearchResultContent as GoogleSearchResultContent, type ImageConfig_2 as ImageConfig, type ImageContent as ImageContent, type Interaction as Interaction, type InteractionCompleteEvent as InteractionCompleteEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStartEvent as InteractionStartEvent, type InteractionStatusUpdate as InteractionStatusUpdate, type MCPServerToolCallContent as MCPServerToolCallContent, type MCPServerToolResultContent as MCPServerToolResultContent, type Model_2 as Model, type PlaceCitation as PlaceCitation, type SpeechConfig_2 as SpeechConfig, type TextContent as TextContent, type ThinkingLevel_2 as ThinkingLevel, type ThoughtContent as ThoughtContent, type Tool_2 as Tool, type ToolChoiceConfig as ToolChoiceConfig, type ToolChoiceType as ToolChoiceType, type Turn as Turn, type URLCitation as URLCitation, type URLContextCallArguments as URLContextCallArguments, type URLContextCallContent as URLContextCallContent, type URLContextResult as URLContextResult, type URLContextResultContent as URLContextResultContent, type Usage as Usage, type VideoContent as VideoContent, type InteractionDeleteResponse as InteractionDeleteResponse, type InteractionCreateParams as InteractionCreateParams, type CreateModelInteractionParamsNonStreaming as CreateModelInteractionParamsNonStreaming, type CreateModelInteractionParamsStreaming as CreateModelInteractionParamsStreaming, type CreateAgentInteractionParamsNonStreaming as CreateAgentInteractionParamsNonStreaming, type CreateAgentInteractionParamsStreaming as CreateAgentInteractionParamsStreaming, type InteractionDeleteParams as InteractionDeleteParams, type InteractionCancelParams as InteractionCancelParams, type InteractionGetParams as InteractionGetParams, type InteractionGetParamsNonStreaming as InteractionGetParamsNonStreaming, type InteractionGetParamsStreaming as InteractionGetParamsStreaming, };
+    export { type AllowedTools as AllowedTools, type Annotation as Annotation, type AudioContent as AudioContent, type CodeExecutionCallArguments as CodeExecutionCallArguments, type CodeExecutionCallContent as CodeExecutionCallContent, type CodeExecutionResultContent as CodeExecutionResultContent, type Content_2 as Content, type ContentDelta as ContentDelta, type ContentStart as ContentStart, type ContentStop as ContentStop, type DeepResearchAgentConfig as DeepResearchAgentConfig, type DocumentContent as DocumentContent, type DynamicAgentConfig as DynamicAgentConfig, type ErrorEvent_2 as ErrorEvent, type FileCitation as FileCitation, type FileSearchCallContent as FileSearchCallContent, type FileSearchResultContent as FileSearchResultContent, type Function_2 as Function, type FunctionCallContent as FunctionCallContent, type FunctionResultContent as FunctionResultContent, type GenerationConfig_2 as GenerationConfig, type GoogleMapsCallArguments as GoogleMapsCallArguments, type GoogleMapsCallContent as GoogleMapsCallContent, type GoogleMapsResult as GoogleMapsResult, type GoogleMapsResultContent as GoogleMapsResultContent, type GoogleSearchCallArguments as GoogleSearchCallArguments, type GoogleSearchCallContent as GoogleSearchCallContent, type GoogleSearchResult as GoogleSearchResult, type GoogleSearchResultContent as GoogleSearchResultContent, type ImageConfig_2 as ImageConfig, type ImageContent as ImageContent, type Interaction as Interaction, type InteractionCompleteEvent as InteractionCompleteEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStartEvent as InteractionStartEvent, type InteractionStatusUpdate as InteractionStatusUpdate, type MCPServerToolCallContent as MCPServerToolCallContent, type MCPServerToolResultContent as MCPServerToolResultContent, type Model_2 as Model, type PlaceCitation as PlaceCitation, type SpeechConfig_2 as SpeechConfig, type TextContent as TextContent, type ThinkingLevel_2 as ThinkingLevel, type ThoughtContent as ThoughtContent, type Tool_2 as Tool, type ToolChoiceConfig as ToolChoiceConfig, type ToolChoiceType as ToolChoiceType, type Turn as Turn, type URLCitation as URLCitation, type URLContextCallArguments as URLContextCallArguments, type URLContextCallContent as URLContextCallContent, type URLContextResult as URLContextResult, type URLContextResultContent as URLContextResultContent, type Usage as Usage, type VideoContent as VideoContent, type WebhookConfig_2 as WebhookConfig, type InteractionDeleteResponse as InteractionDeleteResponse, type InteractionCreateParams as InteractionCreateParams, type CreateModelInteractionParamsNonStreaming as CreateModelInteractionParamsNonStreaming, type CreateModelInteractionParamsStreaming as CreateModelInteractionParamsStreaming, type CreateAgentInteractionParamsNonStreaming as CreateAgentInteractionParamsNonStreaming, type CreateAgentInteractionParamsStreaming as CreateAgentInteractionParamsStreaming, type InteractionDeleteParams as InteractionDeleteParams, type InteractionCancelParams as InteractionCancelParams, type InteractionGetParams as InteractionGetParams, type InteractionGetParamsNonStreaming as InteractionGetParamsNonStreaming, type InteractionGetParamsStreaming as InteractionGetParamsStreaming, };
 }
 
 declare namespace InteractionsAPI {
@@ -6445,6 +6566,7 @@ declare namespace InteractionsAPI {
         URLContextResultContent,
         Usage,
         VideoContent,
+        WebhookConfig_2 as WebhookConfig,
         InteractionDeleteResponse,
         InteractionCreateParams,
         BaseCreateModelInteractionParams,
@@ -6471,8 +6593,7 @@ declare interface InteractionStartEvent {
      */
     interaction: Interaction;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -6482,8 +6603,7 @@ declare interface InteractionStatusUpdate {
     interaction_id: string;
     status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -7000,6 +7120,12 @@ export declare interface LiveClientSetup {
      vad_signal to indicate the start and end of speech. This allows the server
      to process the audio more efficiently. */
     explicitVadSignal?: boolean;
+    /** Configures the avatar model behavior. */
+    avatarConfig?: AvatarConfig;
+    /** Safety settings in the request to block unsafe content in the
+     response.
+     */
+    safetySettings?: SafetySetting[];
 }
 
 /** Client generated response to a `ToolCall` received from the server.
@@ -7106,6 +7232,12 @@ export declare interface LiveConnectConfig {
      vad_signal to indicate the start and end of speech. This allows the server
      to process the audio more efficiently. */
     explicitVadSignal?: boolean;
+    /** Configures the avatar model behavior. */
+    avatarConfig?: AvatarConfig;
+    /** Safety settings in the request to block unsafe content in the
+     response.
+     */
+    safetySettings?: SafetySetting[];
 }
 
 /** Config for LiveConnectConstraints for Auth Token creation. */
@@ -7807,7 +7939,11 @@ export declare enum Modality {
     /**
      * Indicates the model should return audio.
      */
-    AUDIO = "AUDIO"
+    AUDIO = "AUDIO",
+    /**
+     * Indicates the model should return video.
+     */
+    VIDEO = "VIDEO"
 }
 
 /** Represents token counting info for a single modality. */
@@ -7874,7 +8010,8 @@ export declare interface Model {
 }
 
 /**
- * The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
+ * The model that will complete your prompt.\n\nSee
+ * [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
  */
 declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
 
@@ -8137,29 +8274,15 @@ export declare class Models extends BaseModule {
     /**
      * Recontextualizes an image.
      *
-     * There are two types of recontextualization currently supported:
-     * 1) Imagen Product Recontext - Generate images of products in new scenes
-     *    and contexts.
-     * 2) Virtual Try-On: Generate images of persons modeling fashion products.
+     * There is one type of recontextualization currently supported:
+     * 1) Virtual Try-On: Generate images of persons modeling fashion products.
      *
      * @param params - The parameters for recontextualizing an image.
      * @return The response from the API.
      *
      * @example
      * ```ts
-     * const response1 = await ai.models.recontextImage({
-     *  model: 'imagen-product-recontext-preview-06-30',
-     *  source: {
-     *    prompt: 'In a modern kitchen setting.',
-     *    productImages: [productImage],
-     *  },
-     *  config: {
-     *    numberOfImages: 1,
-     *  },
-     * });
-     * console.log(response1?.generatedImages?.[0]?.image?.imageBytes);
-     *
-     * const response2 = await ai.models.recontextImage({
+     * const response = await ai.models.recontextImage({
      *  model: 'virtual-try-on-001',
      *  source: {
      *    personImage: personImage,
@@ -8169,7 +8292,7 @@ export declare class Models extends BaseModule {
      *    numberOfImages: 1,
      *  },
      * });
-     * console.log(response2?.generatedImages?.[0]?.image?.imageBytes);
+     * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
      * ```
      */
     recontextImage(params: types.RecontextImageParameters): Promise<types.RecontextImageResponse>;
@@ -8828,8 +8951,8 @@ declare interface PlaceCitation {
      */
     place_id?: string;
     /**
-     * Snippets of reviews that are used to generate answers about the
-     * features of a given place in Google Maps.
+     * Snippets of reviews that are used to generate answers about the features of a
+     * given place in Google Maps.
      */
     review_snippets?: Array<PlaceCitation.ReviewSnippet>;
     /**
@@ -8846,8 +8969,8 @@ declare interface PlaceCitation {
 
 declare namespace PlaceCitation {
     /**
-     * Encapsulates a snippet of a user review that answers a question about
-     * the features of a specific place in Google Maps.
+     * Encapsulates a snippet of a user review that answers a question about the
+     * features of a specific place in Google Maps.
      */
     interface ReviewSnippet {
         /**
@@ -10335,7 +10458,7 @@ export declare interface Tool {
 /**
  * A tool that can be used by the model.
  */
-declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch | Tool_2.GoogleMaps;
+declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch | Tool_2.GoogleMaps | Tool_2.Retrieval;
 
 declare namespace Tool_2 {
     /**
@@ -10384,8 +10507,7 @@ declare namespace Tool_2 {
          */
         name?: string;
         /**
-         * The full URL for the MCPServer endpoint.
-         * Example: "https://api.example.com/mcp"
+         * The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
          */
         url?: string;
     }
@@ -10397,7 +10519,7 @@ declare namespace Tool_2 {
         /**
          * The types of search grounding to enable.
          */
-        search_types?: Array<'web_search' | 'image_search'>;
+        search_types?: Array<'web_search' | 'image_search' | 'enterprise_web_search'>;
     }
     /**
      * A tool that can be used by the model to search files.
@@ -10436,6 +10558,35 @@ declare namespace Tool_2 {
          */
         longitude?: number;
     }
+    /**
+     * A tool that can be used by the model to retrieve files.
+     */
+    interface Retrieval {
+        type: 'retrieval';
+        /**
+         * The types of file retrieval to enable.
+         */
+        retrieval_types?: Array<'vertex_ai_search'>;
+        /**
+         * Used to specify configuration for VertexAISearch.
+         */
+        vertex_ai_search_config?: Retrieval.VertexAISearchConfig;
+    }
+    namespace Retrieval {
+        /**
+         * Used to specify configuration for VertexAISearch.
+         */
+        interface VertexAISearchConfig {
+            /**
+             * Optional. Used to specify Vertex AI Search datastores.
+             */
+            datastores?: Array<string>;
+            /**
+             * Optional. Used to specify Vertex AI Search engine.
+             */
+            engine?: string;
+        }
+    }
 }
 
 /** A predicted server-side `ToolCall` returned from the model.
@@ -10876,8 +11027,7 @@ export declare interface TuningValidationDataset {
 declare interface Turn {
     content?: Array<Content_2> | string;
     /**
-     * The originator of this turn. Must be user for input or model for
-     * model output.
+     * The originator of this turn. Must be user for input or model for model output.
      */
     role?: string;
 }
@@ -10899,7 +11049,103 @@ export declare enum TurnCompleteReason {
     /**
      * Needs more input from the user.
      */
-    NEED_MORE_INPUT = "NEED_MORE_INPUT"
+    NEED_MORE_INPUT = "NEED_MORE_INPUT",
+    /**
+     * Input content is prohibited.
+     */
+    PROHIBITED_INPUT_CONTENT = "PROHIBITED_INPUT_CONTENT",
+    /**
+     * Input image contains prohibited content.
+     */
+    IMAGE_PROHIBITED_INPUT_CONTENT = "IMAGE_PROHIBITED_INPUT_CONTENT",
+    /**
+     * Input text contains prominent person reference.
+     */
+    INPUT_TEXT_CONTAIN_PROMINENT_PERSON_PROHIBITED = "INPUT_TEXT_CONTAIN_PROMINENT_PERSON_PROHIBITED",
+    /**
+     * Input image contains celebrity.
+     */
+    INPUT_IMAGE_CELEBRITY = "INPUT_IMAGE_CELEBRITY",
+    /**
+     * Input image contains photo realistic child.
+     */
+    INPUT_IMAGE_PHOTO_REALISTIC_CHILD_PROHIBITED = "INPUT_IMAGE_PHOTO_REALISTIC_CHILD_PROHIBITED",
+    /**
+     * Input text contains NCII content.
+     */
+    INPUT_TEXT_NCII_PROHIBITED = "INPUT_TEXT_NCII_PROHIBITED",
+    /**
+     * Other input safety issue.
+     */
+    INPUT_OTHER = "INPUT_OTHER",
+    /**
+     * Input contains IP violation.
+     */
+    INPUT_IP_PROHIBITED = "INPUT_IP_PROHIBITED",
+    /**
+     * Input matched blocklist.
+     */
+    BLOCKLIST = "BLOCKLIST",
+    /**
+     * Input is unsafe for image generation.
+     */
+    UNSAFE_PROMPT_FOR_IMAGE_GENERATION = "UNSAFE_PROMPT_FOR_IMAGE_GENERATION",
+    /**
+     * Generated image failed safety check.
+     */
+    GENERATED_IMAGE_SAFETY = "GENERATED_IMAGE_SAFETY",
+    /**
+     * Generated content failed safety check.
+     */
+    GENERATED_CONTENT_SAFETY = "GENERATED_CONTENT_SAFETY",
+    /**
+     * Generated audio failed safety check.
+     */
+    GENERATED_AUDIO_SAFETY = "GENERATED_AUDIO_SAFETY",
+    /**
+     * Generated video failed safety check.
+     */
+    GENERATED_VIDEO_SAFETY = "GENERATED_VIDEO_SAFETY",
+    /**
+     * Generated content is prohibited.
+     */
+    GENERATED_CONTENT_PROHIBITED = "GENERATED_CONTENT_PROHIBITED",
+    /**
+     * Generated content matched blocklist.
+     */
+    GENERATED_CONTENT_BLOCKLIST = "GENERATED_CONTENT_BLOCKLIST",
+    /**
+     * Generated image is prohibited.
+     */
+    GENERATED_IMAGE_PROHIBITED = "GENERATED_IMAGE_PROHIBITED",
+    /**
+     * Generated image contains celebrity.
+     */
+    GENERATED_IMAGE_CELEBRITY = "GENERATED_IMAGE_CELEBRITY",
+    /**
+     * Generated image contains prominent people detected by rewriter.
+     */
+    GENERATED_IMAGE_PROMINENT_PEOPLE_DETECTED_BY_REWRITER = "GENERATED_IMAGE_PROMINENT_PEOPLE_DETECTED_BY_REWRITER",
+    /**
+     * Generated image contains identifiable people.
+     */
+    GENERATED_IMAGE_IDENTIFIABLE_PEOPLE = "GENERATED_IMAGE_IDENTIFIABLE_PEOPLE",
+    /**
+     * Generated image contains minors.
+     */
+    GENERATED_IMAGE_MINORS = "GENERATED_IMAGE_MINORS",
+    /**
+     * Generated image contains IP violation.
+     */
+    OUTPUT_IMAGE_IP_PROHIBITED = "OUTPUT_IMAGE_IP_PROHIBITED",
+    /**
+     * Other generated content issue.
+     */
+    GENERATED_OTHER = "GENERATED_OTHER",
+    /**
+     * Max regeneration attempts reached.
+     */
+    MAX_REGENERATION_REACHED = "MAX_REGENERATION_REACHED"
 }
 
 /** Options about which input is included in the user's turn. */
@@ -11212,6 +11458,7 @@ declare namespace types {
         GenerateVideosSource,
         VideoGenerationReferenceImage,
         VideoGenerationMask,
+        WebhookConfig,
         GenerateVideosConfig,
         GenerateVideosParameters,
         GeneratedVideo,
@@ -11403,19 +11650,21 @@ declare namespace types {
         ContextWindowCompressionConfig,
         AudioTranscriptionConfig,
         ProactivityConfig,
+        CustomizedAvatar,
+        AvatarConfig,
         LiveClientSetup,
         LiveClientContent,
         ActivityStart,
         ActivityEnd,
         LiveClientRealtimeInput,
         LiveClientToolResponse,
-        LiveSendRealtimeInputParameters,
         LiveClientMessage,
         LiveConnectConfig,
         LiveConnectParameters,
         CreateChatParameters,
         SendMessageParameters,
         LiveSendClientContentParameters,
+        LiveSendRealtimeInputParameters,
         LiveSendToolResponseParameters,
         LiveMusicClientSetup,
         WeightedPrompt,
@@ -11926,7 +12175,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */
@@ -11939,7 +12188,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */
@@ -11952,7 +12201,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */
@@ -11965,7 +12214,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */
@@ -12240,6 +12489,484 @@ export declare interface VoiceConfig {
     prebuiltVoiceConfig?: PrebuiltVoiceConfig;
 }
 
+/** Configuration for webhook notifications.
+
+ Used to configure webhook endpoints that will receive notifications
+ when long-running operations (e.g., batch jobs, video generation) complete. */
+export declare interface WebhookConfig {
+    /** The webhook URIs to receive notifications. If set, these
+     webhook URIs will be used instead of the registered webhooks. */
+    uris?: string[];
+    /** User metadata that will be included in each webhook event
+     notification. Use this to attach custom key-value data to correlate
+     webhook events with your internal systems. */
+    userMetadata?: Record<string, unknown>;
+}
+
+/**
+ * Message for configuring webhook events for a request.
+ */
+declare interface WebhookConfig_2 {
+    /**
+     * Optional. If set, these webhook URIs will be used for webhook events instead of
+     * the registered webhooks.
+     */
+    uris?: Array<string>;
+    /**
+     * Optional. The user metadata that will be returned on each event emission to the
+     * webhooks.
+     */
+    user_metadata?: {
+        [key: string]: unknown;
+    };
+}
+
+declare interface WebhookCreateParams {
+    /**
+     * Path param: Which version of the API to use.
+     */
+    api_version?: string;
+    /**
+     * Body param: Required. The events that the webhook is subscribed to. Available
+     * events:
+     *
+     * - batch.succeeded
+     * - batch.cancelled
+     * - batch.expired
+     * - batch.failed
+     * - interaction.requires_action
+     * - interaction.completed
+     * - interaction.failed
+     * - interaction.cancelled
+     * - video.generated
+     */
+    subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
+    /**
+     * Body param: Required. The URI to which webhook events will be sent.
+     */
+    uri: string;
+    /**
+     * Query param: Optional. The webhook_id to use for the webhook. If not specified,
+     * the server will generate a unique ID.
+     */
+    webhook_id?: string;
+    /**
+     * Body param: Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
+     */
+    name?: string;
+    /**
+     * Body param: The state of the webhook.
+     */
+    state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
+}
+
+/**
+ * A Webhook resource.
+ */
+declare interface WebhookCreateResponse {
+    /**
+     * Required. The events that the webhook is subscribed to. Available events:
+     *
+     * - batch.succeeded
+     * - batch.cancelled
+     * - batch.expired
+     * - batch.failed
+     * - interaction.requires_action
+     * - interaction.completed
+     * - interaction.failed
+     * - interaction.cancelled
+     * - video.generated
+     */
+    subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
+    /**
+     * Required. The URI to which webhook events will be sent.
+     */
+    uri: string;
+    /**
+     * Output only. The timestamp when the webhook was created.
+     */
+    create_time?: string;
+    /**
+     * Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
+     */
+    name?: string;
+    /**
+     * Output only. The new signing secret for the webhook. Only populated on create.
+     */
+    new_signing_secret?: string;
+    /**
+     * Output only. The signing secrets associated with this webhook.
+     */
+    signing_secrets?: Array<WebhookCreateResponse.SigningSecret>;
+    /**
+     * The state of the webhook.
+     */
+    state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
+    /**
+     * Output only. The timestamp when the webhook was last updated.
+     */
+    update_time?: string;
+}
+
+declare namespace WebhookCreateResponse {
+    /**
+     * Represents a signing secret used to verify webhook payloads.
+     */
+    interface SigningSecret {
+        /**
+         * Output only. The expiration date of the signing secret.
+         */
+        expire_time?: string;
+        /**
+         * Output only. The truncated version of the signing secret.
+         */
+        truncated_secret?: string;
+    }
+}
+
+declare interface WebhookDeleteParams {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string;
+}
+
+/**
+ * A generic empty message that you can re-use to avoid defining duplicated empty
+ * messages in your APIs. A typical example is to use it as the request or the
+ * response type of an API method. For instance:
+ *
+ *     service Foo {
+ *       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+ *     }
+ */
+declare interface WebhookDeleteResponse {
+}
+
+declare interface WebhookListParams {
+    /**
+     * Path param: Which version of the API to use.
+     */
+    api_version?: string;
+    /**
+     * Query param: Optional. The maximum number of webhooks to return. The service may
+     * return fewer than this value. If unspecified, at most 50 webhooks will be
+     * returned. The maximum value is 1000.
+     */
+    page_size?: number;
+    /**
+     * Query param: Optional. A page token, received from a previous `ListWebhooks`
+     * call. Provide this to retrieve the subsequent page.
+     */
+    page_token?: string;
+}
+
+/**
+ * Response message for WebhookService.ListWebhooks.
+ */
+declare interface WebhookListResponse {
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page. If this
+     * field is omitted, there are no subsequent pages.
+     */
+    next_page_token?: string;
+    /**
+     * The webhooks.
+     */
+    webhooks?: Array<WebhookListResponse.Webhook>;
+}
+
+declare namespace WebhookListResponse {
+    /**
+     * A Webhook resource.
+     */
+    interface Webhook {
+        /**
+         * Required. The events that the webhook is subscribed to. Available events:
+         *
+         * - batch.succeeded
+         * - batch.cancelled
+         * - batch.expired
+         * - batch.failed
+         * - interaction.requires_action
+         * - interaction.completed
+         * - interaction.failed
+         * - interaction.cancelled
+         * - video.generated
+         */
+        subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
+        /**
+         * Required. The URI to which webhook events will be sent.
+         */
+        uri: string;
+        /**
+         * Output only. The timestamp when the webhook was created.
+         */
+        create_time?: string;
+        /**
+         * Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
+         */
+        name?: string;
+        /**
+         * Output only. The new signing secret for the webhook. Only populated on create.
+         */
+        new_signing_secret?: string;
+        /**
+         * Output only. The signing secrets associated with this webhook.
+         */
+        signing_secrets?: Array<Webhook.SigningSecret>;
+        /**
+         * The state of the webhook.
+         */
+        state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
+        /**
+         * Output only. The timestamp when the webhook was last updated.
+         */
+        update_time?: string;
+    }
+    namespace Webhook {
+        /**
+         * Represents a signing secret used to verify webhook payloads.
+         */
+        interface SigningSecret {
+            /**
+             * Output only. The expiration date of the signing secret.
+             */
+            expire_time?: string;
+            /**
+             * Output only. The truncated version of the signing secret.
+             */
+            truncated_secret?: string;
+        }
+    }
+}
+
+declare interface WebhookPingParams {
+    /**
+     * Path param: Which version of the API to use.
+     */
+    api_version?: string;
+    /**
+     * Body param: Request message for WebhookService.PingWebhook.
+     */
+    body?: WebhookPingParams.Body;
+}
+
+declare namespace WebhookPingParams {
+    /**
+     * Request message for WebhookService.PingWebhook.
+     */
+    interface Body {
+    }
+}
+
+/**
+ * Response message for WebhookService.PingWebhook.
+ */
+declare interface WebhookPingResponse {
+}
+
+declare interface WebhookRetrieveParams {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string;
+}
+
+/**
+ * A Webhook resource.
+ */
+declare interface WebhookRetrieveResponse {
+    /**
+     * Required. The events that the webhook is subscribed to. Available events:
+     *
+     * - batch.succeeded
+     * - batch.cancelled
+     * - batch.expired
+     * - batch.failed
+     * - interaction.requires_action
+     * - interaction.completed
+     * - interaction.failed
+     * - interaction.cancelled
+     * - video.generated
+     */
+    subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
+    /**
+     * Required. The URI to which webhook events will be sent.
+     */
+    uri: string;
+    /**
+     * Output only. The timestamp when the webhook was created.
+     */
+    create_time?: string;
+    /**
+     * Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
+     */
+    name?: string;
+    /**
+     * Output only. The new signing secret for the webhook. Only populated on create.
+     */
+    new_signing_secret?: string;
+    /**
+     * Output only. The signing secrets associated with this webhook.
+     */
+    signing_secrets?: Array<WebhookRetrieveResponse.SigningSecret>;
+    /**
+     * The state of the webhook.
+     */
+    state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
+    /**
+     * Output only. The timestamp when the webhook was last updated.
+     */
+    update_time?: string;
+}
+
+declare namespace WebhookRetrieveResponse {
+    /**
+     * Represents a signing secret used to verify webhook payloads.
+     */
+    interface SigningSecret {
+        /**
+         * Output only. The expiration date of the signing secret.
+         */
+        expire_time?: string;
+        /**
+         * Output only. The truncated version of the signing secret.
+         */
+        truncated_secret?: string;
+    }
+}
+
+declare interface WebhookRotateSigningSecretParams {
+    /**
+     * Path param: Which version of the API to use.
+     */
+    api_version?: string;
+    /**
+     * Body param: Optional. The revocation behavior for previous signing secrets.
+     */
+    revocation_behavior?: 'revoke_previous_secrets_after_h24' | 'revoke_previous_secrets_immediately';
+}
+
+/**
+ * Response message for WebhookService.RotateSigningSecret.
+ */
+declare interface WebhookRotateSigningSecretResponse {
+    /**
+     * Output only. The newly generated signing secret.
+     */
+    secret?: string;
+}
+
+export declare class Webhooks extends BaseWebhooks {
+}
+
+export declare namespace Webhooks {
+    export { type WebhookCreateResponse as WebhookCreateResponse, type WebhookRetrieveResponse as WebhookRetrieveResponse, type WebhookUpdateResponse as WebhookUpdateResponse, type WebhookListResponse as WebhookListResponse, type WebhookDeleteResponse as WebhookDeleteResponse, type WebhookPingResponse as WebhookPingResponse, type WebhookRotateSigningSecretResponse as WebhookRotateSigningSecretResponse, type WebhookCreateParams as WebhookCreateParams, type WebhookRetrieveParams as WebhookRetrieveParams, type WebhookUpdateParams as WebhookUpdateParams, type WebhookListParams as WebhookListParams, type WebhookDeleteParams as WebhookDeleteParams, type WebhookPingParams as WebhookPingParams, type WebhookRotateSigningSecretParams as WebhookRotateSigningSecretParams, };
+}
+
+declare interface WebhookUpdateParams {
+    /**
+     * Path param: Which version of the API to use.
+     */
+    api_version?: string;
+    /**
+     * Body param: Required. The events that the webhook is subscribed to. Available
+     * events:
+     *
+     * - batch.succeeded
+     * - batch.cancelled
+     * - batch.expired
+     * - batch.failed
+     * - interaction.requires_action
+     * - interaction.completed
+     * - interaction.failed
+     * - interaction.cancelled
+     * - video.generated
+     */
+    subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
+    /**
+     * Body param: Required. The URI to which webhook events will be sent.
+     */
+    uri: string;
+    /**
+     * Query param: Optional. The list of fields to update.
+     */
+    update_mask?: string;
+    /**
+     * Body param: Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
+     */
+    name?: string;
+    /**
+     * Body param: The state of the webhook.
+     */
+    state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
+}
+
+/**
+ * A Webhook resource.
+ */
+declare interface WebhookUpdateResponse {
+    /**
+     * Required. The events that the webhook is subscribed to. Available events:
+     *
+     * - batch.succeeded
+     * - batch.cancelled
+     * - batch.expired
+     * - batch.failed
+     * - interaction.requires_action
+     * - interaction.completed
+     * - interaction.failed
+     * - interaction.cancelled
+     * - video.generated
+     */
+    subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
+    /**
+     * Required. The URI to which webhook events will be sent.
+     */
+    uri: string;
+    /**
+     * Output only. The timestamp when the webhook was created.
+     */
+    create_time?: string;
+    /**
+     * Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
+     */
+    name?: string;
+    /**
+     * Output only. The new signing secret for the webhook. Only populated on create.
+     */
+    new_signing_secret?: string;
+    /**
+     * Output only. The signing secrets associated with this webhook.
+     */
+    signing_secrets?: Array<WebhookUpdateResponse.SigningSecret>;
+    /**
+     * The state of the webhook.
+     */
+    state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
+    /**
+     * Output only. The timestamp when the webhook was last updated.
+     */
+    update_time?: string;
+}
+
+declare namespace WebhookUpdateResponse {
+    /**
+     * Represents a signing secret used to verify webhook payloads.
+     */
+    interface SigningSecret {
+        /**
+         * Output only. The expiration date of the signing secret.
+         */
+        expire_time?: string;
+        /**
+         * Output only. The truncated version of the signing secret.
+         */
+        truncated_secret?: string;
+    }
+}
+
 /** Standard web search for grounding and related configurations. Only text results are returned. */
 export declare interface WebSearch {
 }