@google/genai 2.11.0 → 2.12.0

package/dist/node/node.d.ts

@@ -286,6 +286,30 @@ declare type Annotation$ = Annotation;
  */
 declare type Annotation = URLCitation | FileCitation | PlaceCitation;
 
+declare type AntigravityAgentConfig$ = AntigravityAgentConfig;
+
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * Configuration for the Antigravity agent runtime.
+ *
+ * @remarks
+ * Provides server-side control over the agent's execution environment
+ * and tool configuration.
+ */
+declare type AntigravityAgentConfig = {
+    /**
+     * Max total tokens for the agent run.
+     */
+    max_total_tokens?: string | undefined;
+    type: "antigravity";
+};
+
 /** The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. This data type is not supported in Gemini API. */
 export declare interface ApiAuth {
     /** The API secret. */
@@ -1776,6 +1800,47 @@ declare type CodeExecutionResultStep = {
     type: "code_execution_result";
 };
 
+declare type CodeMenderAgentConfig$ = CodeMenderAgentConfig;
+
+/**
+ * Configuration for the CodeMender agent.
+ */
+declare type CodeMenderAgentConfig = {
+    /**
+     * Request parameters specific to FIND sessions, used for discovering
+     *
+     * @remarks
+     * vulnerabilities in a codebase.
+     */
+    find_request?: FindRequest | undefined;
+    /**
+     * Request parameters specific to FIX sessions, used for generating and
+     *
+     * @remarks
+     * validating security patches.
+     */
+    fix_request?: FixRequest | undefined;
+    /**
+     * The name of the model to use for the CodeMender agent. One
+     *
+     * @remarks
+     * CodeMender session will only use one model.
+     */
+    model?: string | undefined;
+    /**
+     * The configuration of CodeMender sessions.
+     */
+    session_config?: SessionConfig | undefined;
+    /**
+     * Parameter for grouping multiple interactions that belong to
+     *
+     * @remarks
+     * the same CodeMender session.
+     */
+    session_id?: string | undefined;
+    type: "code-mender";
+};
+
 /** Success and error statistics of processing multiple entities (for example, DataItems or structured data rows) in batch. This data type is not supported in Gemini API. */
 export declare interface CompletionStats {
     /** Output only. The number of entities for which any error was encountered. */
@@ -1917,6 +1982,9 @@ export declare interface ContentEmbeddingStatistics {
     /** Gemini Enterprise Agent Platform only. Number of tokens of the input text.
      */
     tokenCount?: number;
+    /** Gemini Enterprise Agent Platform only. List of modalities and their token count for the input content.
+     */
+    tokensDetails?: ModalityTokenCount[];
 }
 
 export declare type ContentListUnion = Content | Content[] | PartUnion | PartUnion[];
@@ -2096,7 +2164,7 @@ declare type CreateAgentInteraction = {
     /**
      * Configuration parameters for the agent interaction.
      */
-    agent_config?: DynamicAgentConfig | DeepResearchAgentConfig | undefined;
+    agent_config?: DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig | undefined;
     /**
      * Safety settings for the interaction.
      */
@@ -2116,7 +2184,7 @@ declare type CreateAgentInteraction = {
 /**
  * Configuration parameters for the agent interaction.
  */
-declare type CreateAgentInteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig;
+declare type CreateAgentInteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig;
 
 /**
  * The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.
@@ -2493,16 +2561,6 @@ declare type CreateModelInteraction = {
      * Configuration parameters for model interactions.
      */
     generation_config?: GenerationConfig_2 | undefined;
-    /**
-     * The name of the cached content used as context to serve the prediction.
-     *
-     * @remarks
-     * Note: only used in explicit caching, where users can have control over
-     * caching (e.g. what content to cache) and enjoy guaranteed cost savings.
-     * Format:
-     * `projects/{project}/locations/{location}/cachedContents/{cachedContent}`
-     */
-    cached_content?: string | undefined;
     /**
      * Safety settings for the interaction.
      */
@@ -2578,6 +2636,16 @@ export declare function createPartFromText(text: string): Part;
  */
 export declare function createPartFromUri(uri: string, mimeType: string, mediaResolution?: PartMediaResolutionLevel): Part;
 
+declare type CreateTriggerParams = Omit<CreateTriggerRequest, "body"> & CreateTriggerRequest["body"];
+
+declare type CreateTriggerRequest = {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string | undefined;
+    body: triggers.TriggerCreateParams;
+};
+
 /** Fine-tuning job creation request - optional fields. */
 export declare interface CreateTuningJobConfig {
     /** Used to override HTTP request options. */
@@ -2997,6 +3065,19 @@ export declare interface DeleteResourceJob {
     error?: JobError;
 }
 
+declare type DeleteTriggerParams = Omit<DeleteTriggerRequest, "id">;
+
+declare type DeleteTriggerRequest = {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string | undefined;
+    /**
+     * Resource name of the trigger.
+     */
+    id: string;
+};
+
 declare type DeleteWebhookParams = Omit<DeleteWebhookRequest, "id">;
 
 declare type DeleteWebhookRequest = {
@@ -3914,6 +3995,27 @@ declare type FileCitation = {
     type: "file_citation";
 };
 
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * Content of a single file in the codebase.
+ */
+declare type FileContent = {
+    /**
+     * The UTF-8 encoded text content of the file.
+     */
+    content?: string | undefined;
+    /**
+     * The relative path of the file from the project root.
+     */
+    path?: string | undefined;
+};
+
 /** URI-based data. A FileData message contains a URI pointing to data of a specific media type. It is used to represent images, audio, and video stored in Google Cloud Storage. */
 export declare interface FileData {
     /** Optional. The display name of the file. Used to provide a label or filename to distinguish files. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server side tools (`code_execution`, `google_search`, and `url_context`) are enabled. This field is not supported in Gemini API. */
@@ -4364,6 +4466,40 @@ declare type Filter = {
     vector_similarity_threshold?: number | undefined;
 };
 
+declare type FindRequest$ = FindRequest;
+
+/**
+ * Request parameters specific to FIND sessions, used for discovering
+ *
+ * @remarks
+ * vulnerabilities in a codebase.
+ */
+declare type FindRequest = {
+    /**
+     * Additional context or custom instructions provided by the user to guide
+     *
+     * @remarks
+     * the vulnerability analysis.
+     */
+    description?: string | undefined;
+    /**
+     * The identifier of a specific finding to verify. This is primarily used in
+     *
+     * @remarks
+     * VERIFY mode to focus the agent's execution-based validation on a single
+     * vulnerability.
+     */
+    finding_id?: string | undefined;
+    /**
+     * The mode of the find session.
+     */
+    mode?: Mode | undefined;
+    /**
+     * A list of source files to provide as context for the scan.
+     */
+    source_files?: Array<FileContent> | undefined;
+};
+
 /** Output only. The reason why the model stopped generating tokens.
 
  If empty, the model has not stopped generating the tokens. */
@@ -4438,6 +4574,38 @@ export declare enum FinishReason {
     IMAGE_OTHER = "IMAGE_OTHER"
 }
 
+declare type FixRequest$ = FixRequest;
+
+/**
+ * Request parameters specific to FIX sessions, used for generating and
+ *
+ * @remarks
+ * validating security patches.
+ */
+declare type FixRequest = {
+    /**
+     * Additional context or custom instructions provided by the user to guide
+     *
+     * @remarks
+     * the patch generation process.
+     */
+    description?: string | undefined;
+    /**
+     * The identifier of the specific security finding to be remediated. This ID
+     *
+     * @remarks
+     * maps to a previously discovered vulnerability.
+     */
+    finding_id?: string | undefined;
+    /**
+     * A list of source files providing context for the remediation. These files
+     *
+     * @remarks
+     * are typically the ones containing the identified vulnerability.
+     */
+    source_files?: Array<FileContent> | undefined;
+};
+
 /** Tuning Spec for Full Fine Tuning. This data type is not supported in Gemini API. */
 export declare interface FullFineTuningSpec {
     /** Optional. Hyperparameters for Full Fine Tuning. */
@@ -4728,6 +4896,20 @@ declare class GeminiNextGenInteractions {
     private getClient;
 }
 
+declare class GeminiNextGenTriggers {
+    private readonly parentClient;
+    private sdk;
+    constructor(parentClient: GoogleGenAIParentClient);
+    create(params: CreateTriggerParams, options?: GoogleGenAIRequestOptions): Promise<triggers.Trigger>;
+    list(params?: ListTriggersParams_2 | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.ListTriggersResponse>;
+    get(id: string, params?: GetTriggerParams | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.Trigger>;
+    update(id: string, params: UpdateTriggerParams, options?: GoogleGenAIRequestOptions): Promise<triggers.Trigger>;
+    delete(id: string, params?: DeleteTriggerParams | null | undefined, options?: GoogleGenAIRequestOptions): Promise<interactions.Empty>;
+    run(trigger_id: string, params?: RunTriggerParams | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.TriggerExecution>;
+    listExecutions(trigger_id: string, params?: ListTriggerExecutionsParams_2 | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.ListTriggerExecutionsResponse>;
+    private getClient;
+}
+
 declare class GeminiNextGenWebhooks {
     private readonly parentClient;
     private sdk;
@@ -5691,6 +5873,19 @@ export declare interface GetOperationParameters {
     config?: GetOperationConfig;
 }
 
+declare type GetTriggerParams = Omit<GetTriggerRequest, "id">;
+
+declare type GetTriggerRequest = {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string | undefined;
+    /**
+     * Resource name of the trigger.
+     */
+    id: string;
+};
+
 /** Optional parameters for tunings.get method. */
 export declare interface GetTuningJobConfig {
     /** Used to override HTTP request options. */
@@ -5787,10 +5982,12 @@ export declare class GoogleGenAI {
     private _webhooks;
     private _agents;
     private _nextGenClient;
+    private _triggers;
     private getNextGenClient;
     get interactions(): GeminiNextGenInteractions;
     get webhooks(): GeminiNextGenWebhooks;
     get agents(): GeminiNextGenAgents;
+    get triggers(): GeminiNextGenTriggers;
     constructor(options: GoogleGenAIOptions);
 }
 
@@ -5885,6 +6082,7 @@ declare interface GoogleGenAIParentClient {
     getBaseUrl(): string;
     getApiVersion(): string;
     getDefaultHeaders?(): Record<string, string>;
+    getHeaders?(): Record<string, string> | undefined;
     getAuthHeaders(url?: string): Headers | Promise<Headers>;
 }
 
@@ -6616,6 +6814,16 @@ export declare enum HarmSeverity {
     HARM_SEVERITY_HIGH = "HARM_SEVERITY_HIGH"
 }
 
+/** Configuration for history exchange between client and server. */
+export declare interface HistoryConfig {
+    /** If true, after sending `setup_complete`, the server will wait
+     and at first process `client_content` messages until `turn_complete` is
+     `true`. This initial history will not trigger a model call and
+     may end with model content. After `turn_complete` is `true`, the client
+     can start the realtime conversation via `realtime_input`. */
+    initialHistoryInClientContent?: boolean;
+}
+
 /** The location of the API key. This enum is not supported in Gemini API. */
 export declare enum HttpElementLocation {
     HTTP_IN_UNSPECIFIED = "HTTP_IN_UNSPECIFIED",
@@ -7186,20 +7394,10 @@ declare type Interaction = {
      * Configuration parameters for model interactions.
      */
     generation_config?: GenerationConfig_2 | undefined;
-    /**
-     * The name of the cached content used as context to serve the prediction.
-     *
-     * @remarks
-     * Note: only used in explicit caching, where users can have control over
-     * caching (e.g. what content to cache) and enjoy guaranteed cost savings.
-     * Format:
-     * `projects/{project}/locations/{location}/cachedContents/{cachedContent}`
-     */
-    cached_content?: string | undefined;
     /**
      * Configuration parameters for the agent interaction.
      */
-    agent_config?: DynamicAgentConfig | DeepResearchAgentConfig | undefined;
+    agent_config?: DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig | undefined;
     /**
      * Safety settings for the interaction.
      */
@@ -7236,10 +7434,15 @@ declare type Interaction = {
     output_video?: VideoContent | undefined;
 };
 
+/**
+ * Required. The interaction request template to be executed.
+ */
+declare type Interaction_2 = interactions.CreateAgentInteraction | interactions.CreateModelInteraction;
+
 /**
  * Configuration parameters for the agent interaction.
  */
-declare type InteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig;
+declare type InteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig;
 
 declare type InteractionCancelParams$ = CancelInteractionByIdParams;
 
@@ -7328,12 +7531,15 @@ declare type InteractionResponseFormat = Array<ResponseFormat_2> | ResponseForma
 export declare namespace Interactions {
     export type AllowedTools = AllowedTools$;
     export type Annotation = Annotation$;
+    export type AntigravityAgentConfig = AntigravityAgentConfig$;
     export type AudioContent = AudioContent$;
     export type AudioResponseFormat = AudioResponseFormat$;
     export type CodeExecutionCallArguments = CodeExecutionCallArguments$;
     export interface CodeExecutionCallStep extends CodeExecutionCallStep$ {
     }
     export type CodeExecutionResultStep = CodeExecutionResultStep$;
+    export interface CodeMenderAgentConfig extends CodeMenderAgentConfig$ {
+    }
     export type Content = Content$;
     export type CreateAgentInteractionParamsNonStreaming = CreateAgentInteractionParamsNonStreaming$;
     export type CreateAgentInteractionParamsStreaming = CreateAgentInteractionParamsStreaming$;
@@ -7429,6 +7635,19 @@ export declare namespace Interactions {
     export namespace CodeExecutionCallStep {
         export type Arguments = Arguments$;
     }
+    export namespace CodeMenderAgentConfig {
+        export interface FindRequest extends FindRequest$ {
+        }
+        export interface FixRequest extends FixRequest$ {
+        }
+        export type SessionConfig = SessionConfig$;
+        export namespace FindRequest {
+            export type SourceFile = SourceFile$;
+        }
+        export namespace FixRequest {
+            export type SourceFile = SourceFile$2;
+        }
+    }
     export namespace Environment {
         export type Allowlist = Allowlist$;
         export type Source = Source$;
@@ -7553,6 +7772,7 @@ declare namespace interactions {
         Transform,
         AllowlistEntry,
         Annotation,
+        AntigravityAgentConfig,
         ArgumentsDelta,
         AudioContentMimeType,
         AudioContent,
@@ -7568,6 +7788,7 @@ declare namespace interactions {
         CodeExecutionResultDelta,
         CodeExecutionResultStep,
         CodeExecution,
+        CodeMenderAgentConfig,
         DisabledSafetyPolicy,
         EnvironmentEnum,
         ComputerUse_2 as ComputerUse,
@@ -7597,6 +7818,7 @@ declare namespace interactions {
         ErrorT,
         ExaAISearchConfig,
         FileCitation,
+        FileContent,
         FileSearchCallDelta,
         FileSearchCallStep,
         FileSearchResultDelta,
@@ -7604,6 +7826,9 @@ declare namespace interactions {
         FileSearchResult,
         FileSearch_2 as FileSearch,
         Filter,
+        Mode,
+        FindRequest,
+        FixRequest,
         FunctionCallStep,
         FunctionResultDeltaResult,
         FunctionResultDeltaResultUnion,
@@ -7694,6 +7919,7 @@ declare namespace interactions {
         Threshold,
         SafetySetting_2 as SafetySetting,
         ServiceTier_2 as ServiceTier,
+        SessionConfig,
         SourceType,
         Source,
         SpeechConfig_2 as SpeechConfig,
@@ -8154,6 +8380,99 @@ export declare class ListModelsResponse {
     models?: Model[];
 }
 
+declare type ListTriggerExecutionsParams = Omit<ListTriggerExecutionsRequest, "trigger_id">;
+
+declare type ListTriggerExecutionsParams_2 = {
+    api_version?: string;
+    pageSize?: number;
+    pageToken?: string;
+};
+
+declare type ListTriggerExecutionsRequest = {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string | undefined;
+    /**
+     * Resource name of the trigger.
+     */
+    trigger_id: string;
+    /**
+     * Optional. The maximum number of executions to return per page.
+     */
+    page_size?: number | undefined;
+    /**
+     * Optional. A page token from a previous ListTriggerExecutions call.
+     */
+    page_token?: string | undefined;
+};
+
+declare type ListTriggerExecutionsResponse$ = ListTriggerExecutionsResponse;
+
+/**
+ * Response message for TriggerService.ListTriggerExecutions.
+ */
+declare type ListTriggerExecutionsResponse = {
+    /**
+     * A page token, received from a previous `ListTriggerExecutions` call.
+     *
+     * @remarks
+     * Provide this to retrieve the subsequent page.
+     */
+    next_page_token?: string | undefined;
+    /**
+     * The list of trigger executions.
+     */
+    trigger_executions?: Array<TriggerExecution> | undefined;
+};
+
+declare type ListTriggersParams = ListTriggersRequest;
+
+declare type ListTriggersParams_2 = {
+    api_version?: string;
+    filter?: string;
+    pageSize?: number;
+    pageToken?: string;
+};
+
+declare type ListTriggersRequest = {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string | undefined;
+    /**
+     * Optional. Filter expression (e.g., by state).
+     */
+    filter?: string | undefined;
+    /**
+     * Optional. The maximum number of triggers to return per page.
+     */
+    page_size?: number | undefined;
+    /**
+     * Optional. A page token from a previous ListTriggers call.
+     */
+    page_token?: string | undefined;
+};
+
+declare type ListTriggersResponse$ = ListTriggersResponse;
+
+/**
+ * Response message for TriggerService.ListTriggers.
+ */
+declare type ListTriggersResponse = {
+    /**
+     * A page token, received from a previous `ListTriggers` call.
+     *
+     * @remarks
+     * Provide this to retrieve the subsequent page.
+     */
+    next_page_token?: string | undefined;
+    /**
+     * The list of triggers.
+     */
+    triggers?: Array<Trigger> | undefined;
+};
+
 /** Configuration for the list tuning jobs method. */
 export declare interface ListTuningJobsConfig {
     /** Used to override HTTP request options. */
@@ -8409,6 +8728,8 @@ export declare interface LiveClientSetup {
      response.
      */
     safetySettings?: SafetySetting[];
+    /** Configures the exchange of history between the client and the server. */
+    historyConfig?: HistoryConfig;
 }
 
 /** Client generated response to a `ToolCall` received from the server.
@@ -9360,6 +9681,11 @@ declare type ModalityTokens = {
     tokens?: number | undefined;
 };
 
+/**
+ * The mode of the find session.
+ */
+declare type Mode = "scan" | "verify" | (string & {});
+
 declare type Model$ = Model_2;
 
 /** A trained machine learning model. */
@@ -9427,7 +9753,7 @@ 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.
  */
-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" | "gemini-3.1-flash-lite-preview" | "gemini-3.1-flash-tts-preview" | "gemini-3.5-flash" | "lyria-3-clip-preview" | "lyria-3-pro-preview" | (string & {});
+declare type Model_2 = "gemini-2.5-flash" | "gemini-2.5-pro" | "gemma-4-26b-a4b-it" | "gemma-4-31b-it" | "gemini-flash-latest" | "gemini-flash-lite-latest" | "gemini-pro-latest" | "gemini-2.5-flash-lite" | "gemini-2.5-flash-image" | "gemini-3-flash-preview" | "gemini-3.1-pro-preview" | "gemini-3.1-pro-preview-customtools" | "gemini-3.1-flash-lite" | "gemini-3-pro-image" | "nano-banana-pro-preview" | "gemini-3.1-flash-image" | "gemini-3.5-flash" | "lyria-3-clip-preview" | "lyria-3-pro-preview" | "gemini-robotics-er-1.6-preview" | (string & {});
 
 /** Configuration for Model Armor. Model Armor is a Google Cloud service that provides safety and security filtering for prompts and responses. It helps protect your AI applications from risks such as harmful content, sensitive data leakage, and prompt injection attacks. This data type is not supported in Gemini API. */
 export declare interface ModelArmorConfig {
@@ -11340,6 +11666,19 @@ export declare interface RougeMetricValue {
     score?: number;
 }
 
+declare type RunTriggerParams = Omit<RunTriggerRequest, "trigger_id">;
+
+declare type RunTriggerRequest = {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string | undefined;
+    /**
+     * Resource name of the trigger.
+     */
+    trigger_id: string;
+};
+
 /** Safety attributes of a GeneratedImage or the user-provided prompt. */
 export declare interface SafetyAttributes {
     /** List of RAI categories. */
@@ -11850,6 +12189,28 @@ export declare class Session {
     close(): void;
 }
 
+declare type SessionConfig$ = SessionConfig;
+
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * The configuration of CodeMender sessions.
+ */
+declare type SessionConfig = {
+    /**
+     * The maximum number of interaction rounds the agent is allowed to perform
+     *
+     * @remarks
+     * before reaching a timeout.
+     */
+    max_rounds?: number | undefined;
+};
+
 /** Configuration of session resumption mechanism.
 
  Included in `LiveConnectConfig.session_resumption`. If included server
@@ -11974,6 +12335,10 @@ declare type Source = {
     type?: SourceType | undefined;
 };
 
+declare type SourceFile$ = FileContent;
+
+declare type SourceFile$2 = FileContent;
+
 /**
  * @license
  * Copyright 2026 Google LLC
@@ -12930,6 +13295,267 @@ export declare interface TranslationConfig {
     targetLanguageCode?: string;
 }
 
+declare type Trigger$ = Trigger;
+
+/**
+ * A trigger configuration that is scheduled to run an agent.
+ */
+declare type Trigger = {
+    /**
+     * Output only. The number of consecutive failures that have occurred
+     *
+     * @remarks
+     * since the last successful execution.
+     */
+    consecutive_failure_count?: number | undefined;
+    /**
+     * Output only. The time when the trigger was created.
+     */
+    create_time?: string | undefined;
+    /**
+     * Optional. The display name of the trigger.
+     */
+    display_name?: string | undefined;
+    /**
+     * Optional. The environment ID for the trigger execution.
+     */
+    environment_id?: string | undefined;
+    /**
+     * Optional. The execution timeout for the triggered interaction.
+     */
+    execution_timeout_seconds?: number | undefined;
+    /**
+     * Required. Output only. Identifier. The ID of the trigger.
+     */
+    id: string;
+    /**
+     * The Interaction resource.
+     */
+    interaction: interactions.Interaction;
+    /**
+     * Output only. The time when the trigger was last paused.
+     */
+    last_pause_time?: string | undefined;
+    /**
+     * Output only. The time when the trigger was last resumed.
+     */
+    last_resume_time?: string | undefined;
+    /**
+     * Output only. The time when the trigger was last run.
+     */
+    last_run_time?: string | undefined;
+    /**
+     * Optional. The maximum number of consecutive failures allowed before
+     *
+     * @remarks
+     * the trigger is automatically paused (status becomes ERROR).
+     */
+    max_consecutive_failures?: number | undefined;
+    /**
+     * Output only. The time when the trigger is scheduled to run next.
+     */
+    next_run_time?: string | undefined;
+    /**
+     * Output only. The ID of the last interaction created by this trigger.
+     */
+    previous_interaction_id?: string | undefined;
+    /**
+     * Required. The cron schedule on which the trigger should run.
+     *
+     * @remarks
+     * Standard cron format.
+     */
+    schedule: string;
+    /**
+     * Output only. The current status of the trigger.
+     */
+    status?: TriggerStatus | undefined;
+    /**
+     * Required. Time zone in which the schedule should be interpreted.
+     */
+    time_zone: string;
+    /**
+     * Output only. The time when the trigger was last updated.
+     */
+    update_time?: string | undefined;
+};
+
+declare type TriggerCreateParams$ = TriggerCreateParams;
+
+/**
+ * Parameters for creating a trigger.
+ */
+declare type TriggerCreateParams = {
+    /**
+     * Required. The cron schedule on which the trigger should run. Standard cron format.
+     */
+    schedule: string;
+    /**
+     * Required. Time zone in which the schedule should be interpreted.
+     */
+    time_zone: string;
+    /**
+     * Optional. The display name of the trigger.
+     */
+    display_name?: string | undefined;
+    /**
+     * Optional. The environment ID for the trigger execution.
+     */
+    environment_id?: string | undefined;
+    /**
+     * Optional. The maximum number of consecutive failures allowed before the trigger is automatically paused (status becomes ERROR).
+     */
+    max_consecutive_failures?: number | undefined;
+    /**
+     * Optional. The execution timeout for the triggered interaction.
+     */
+    execution_timeout_seconds?: number | undefined;
+    /**
+     * Required. The interaction request template to be executed.
+     */
+    interaction: interactions.CreateAgentInteraction | interactions.CreateModelInteraction;
+};
+
+declare type TriggerDeleteParams$ = DeleteTriggerParams;
+
+declare type TriggerDeleteResponse$ = Empty;
+
+declare type TriggerExecution$ = TriggerExecution;
+
+/**
+ * An execution instance of a trigger.
+ */
+declare type TriggerExecution = {
+    /**
+     * Output only. The time when the execution finished.
+     */
+    end_time?: string | undefined;
+    /**
+     * Output only. The environment ID used for the execution.
+     */
+    environment_id?: string | undefined;
+    /**
+     * Output only. The error message if the execution failed.
+     */
+    error?: string | undefined;
+    /**
+     * Required. Output only. Identifier. The ID of the trigger execution.
+     */
+    id: string;
+    /**
+     * Output only. The ID of the interaction created by this execution, if any.
+     */
+    interaction_id?: string | undefined;
+    /**
+     * Output only. The time when the execution was scheduled to run.
+     */
+    scheduled_time?: string | undefined;
+    /**
+     * Output only. The time when the execution started.
+     */
+    start_time?: string | undefined;
+    /**
+     * Output only. The status of the execution.
+     */
+    status?: TriggerExecutionStatus | undefined;
+    /**
+     * Required. Output only. Identifier. The ID of the trigger that created this execution.
+     */
+    trigger_id: string;
+};
+
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * Output only. The status of the execution.
+ */
+declare type TriggerExecutionStatus = "in_progress" | "completed" | "failed" | "skipped" | "timed_out" | (string & {});
+
+declare type TriggerGetParams$ = GetTriggerParams;
+
+declare type TriggerListExecutionsParams$ = ListTriggerExecutionsParams;
+
+declare type TriggerListExecutionsResponse$ = ListTriggerExecutionsResponse;
+
+declare type TriggerListParams$ = ListTriggersParams;
+
+declare type TriggerListResponse$ = ListTriggersResponse;
+
+declare type TriggerRunParams$ = RunTriggerParams;
+
+export declare namespace Triggers {
+    export type ListTriggerExecutionsResponse = ListTriggerExecutionsResponse$;
+    export type ListTriggersResponse = ListTriggersResponse$;
+    export type Trigger = Trigger$;
+    export type TriggerCreateParams = TriggerCreateParams$;
+    export type TriggerDeleteParams = TriggerDeleteParams$;
+    export type TriggerDeleteResponse = TriggerDeleteResponse$;
+    export type TriggerExecution = TriggerExecution$;
+    export type TriggerGetParams = TriggerGetParams$;
+    export type TriggerListExecutionsParams = TriggerListExecutionsParams$;
+    export type TriggerListExecutionsResponse = TriggerListExecutionsResponse$;
+    export type TriggerListParams = TriggerListParams$;
+    export type TriggerListResponse = TriggerListResponse$;
+    export type TriggerRunParams = TriggerRunParams$;
+    export type TriggerUpdate = TriggerUpdate$;
+    export type TriggerUpdateParams = TriggerUpdateParams$;
+}
+
+declare namespace triggers {
+    export {
+        ListTriggerExecutionsResponse,
+        ListTriggersResponse,
+        Interaction_2 as Interaction,
+        TriggerCreateParams,
+        TriggerExecutionStatus,
+        TriggerExecution,
+        TriggerUpdateStatus,
+        TriggerUpdate,
+        TriggerStatus,
+        Trigger
+    }
+}
+
+/**
+ * Output only. The current status of the trigger.
+ */
+declare type TriggerStatus = "active" | "paused" | "error" | (string & {});
+
+declare type TriggerUpdate$ = TriggerUpdate;
+
+/**
+ * Represents the fields of a Trigger that can be updated.
+ */
+declare type TriggerUpdate = {
+    /**
+     * Optional. The display name of the trigger.
+     */
+    display_name?: string | undefined;
+    /**
+     * Optional. The status of the trigger.
+     */
+    status?: TriggerUpdateStatus | undefined;
+};
+
+declare type TriggerUpdateParams$ = UpdateTriggerParams;
+
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+/**
+ * Optional. The status of the trigger.
+ */
+declare type TriggerUpdateStatus = "active" | "paused" | "error";
+
 /** TunedModel for the Tuned Model of a Tuning Job. */
 export declare interface TunedModel {
     /** Output only. The resource name of the TunedModel.
@@ -13939,6 +14565,7 @@ declare namespace types {
         LanguageHints,
         AudioTranscriptionConfig,
         ProactivityConfig,
+        HistoryConfig,
         CustomizedAvatar,
         AvatarConfig,
         LiveClientSetup,
@@ -14048,6 +14675,20 @@ export declare interface UpdateModelParameters {
     config?: UpdateModelConfig;
 }
 
+declare type UpdateTriggerParams = Omit<UpdateTriggerRequest, "id" | "body"> & UpdateTriggerRequest["body"];
+
+declare type UpdateTriggerRequest = {
+    /**
+     * Which version of the API to use.
+     */
+    api_version?: string | undefined;
+    /**
+     * Resource name of the trigger.
+     */
+    id: string;
+    body: triggers.TriggerUpdate;
+};
+
 declare interface Uploader {
     /**
      * Uploads a file to the given upload url.