@google/genai 1.49.0 → 1.50.0

package/dist/genai.d.ts

@@ -476,7 +476,7 @@ 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' | 'audio/l16';
+    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.
      */
@@ -632,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> {
 }
 
@@ -695,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 {
@@ -757,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;
 }
 
 /**
@@ -858,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',
      * });
      * ```
@@ -923,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);
@@ -1869,7 +1923,7 @@ declare namespace ContentDelta {
          */
         channels?: number;
         data?: string;
-        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a' | 'audio/l16';
+        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.
          */
@@ -2357,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. */
@@ -2684,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. */
@@ -2761,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. */
@@ -3276,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. */
@@ -4859,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. */
@@ -5268,7 +5358,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);
 }
 
@@ -6311,6 +6405,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 {
@@ -6393,7 +6492,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 {
@@ -6455,6 +6554,7 @@ declare namespace InteractionsAPI {
         URLContextResultContent,
         Usage,
         VideoContent,
+        WebhookConfig_2 as WebhookConfig,
         InteractionDeleteResponse,
         InteractionCreateParams,
         BaseCreateModelInteractionParams,
@@ -7008,6 +7108,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.
@@ -7114,6 +7220,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. */
@@ -7815,7 +7927,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. */
@@ -10921,7 +11037,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. */
@@ -11234,6 +11446,7 @@ declare namespace types {
         GenerateVideosSource,
         VideoGenerationReferenceImage,
         VideoGenerationMask,
+        WebhookConfig,
         GenerateVideosConfig,
         GenerateVideosParameters,
         GeneratedVideo,
@@ -11425,19 +11638,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,
@@ -12262,6 +12477,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 {
 }