@google/genai 2.0.0 → 2.1.0

package/dist/genai.d.ts

@@ -496,19 +496,19 @@ declare interface AudioResponseFormat {
      * Bit rate in bits per second (bps). Only applicable for compressed formats (MP3,
      * Opus).
      */
-    bitRate?: number;
+    bit_rate?: number;
     /**
      * The delivery mode for the audio output.
      */
-    delivery?: 'inline' | 'url';
+    delivery?: 'inline' | 'uri';
     /**
      * The MIME type of the audio output.
      */
-    mimeType?: 'audio/mp3' | 'audio/ogg_opus' | 'audio/l16' | 'audio/wav' | 'audio/alaw' | 'audio/mulaw';
+    mime_type?: 'audio/mp3' | 'audio/ogg_opus' | 'audio/l16' | 'audio/wav' | 'audio/alaw' | 'audio/mulaw';
     /**
      * Sample rate in Hz.
      */
-    sampleRate?: number;
+    sample_rate?: number;
 }
 
 /** The audio transcription configuration in Setup. */
@@ -1226,10 +1226,10 @@ export declare interface BatchJobSource {
 
 export declare type BatchJobSourceUnion = BatchJobSource | InlinedRequest[] | string;
 
-/** Specifies the function Behavior. Currently only supported by the BidiGenerateContent method. This enum is not supported in Vertex AI. */
+/** Specifies the function Behavior. Currently only non-blocking functions are supported. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. */
 export declare enum Behavior {
     /**
-     * This value is unused.
+     * This value is unspecified.
      */
     UNSPECIFIED = "UNSPECIFIED",
     /**
@@ -2585,8 +2585,7 @@ declare interface DeepResearchAgentConfig {
     /**
      * 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.
+     * will then proceed only if the user confirms the plan in the next turn.
      */
     collaborative_planning?: boolean;
     /**
@@ -4040,7 +4039,7 @@ export declare interface FunctionDeclaration {
     response?: Schema;
     /** Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. */
     responseJsonSchema?: unknown;
-    /** Optional. Specifies the function Behavior. Currently only supported by the BidiGenerateContent method. This field is not supported in Vertex AI. */
+    /** Optional. Specifies the function Behavior. Currently only non-blocking functions are supported. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. */
     behavior?: Behavior;
 }
 
@@ -6118,19 +6117,19 @@ declare interface ImageResponseFormat {
     /**
      * The aspect ratio for the image output.
      */
-    aspectRatio?: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9' | '1:8' | '8:1' | '1:4' | '4:1';
+    aspect_ratio?: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9' | '1:8' | '8:1' | '1:4' | '4:1';
     /**
      * The delivery mode for the image output.
      */
-    delivery?: 'inline' | 'url';
+    delivery?: 'inline' | 'uri';
     /**
      * The size of the image output.
      */
-    imageSize?: '512' | '1K' | '2K' | '4K';
+    image_size?: '512' | '1K' | '2K' | '4K';
     /**
      * The MIME type of the image output.
      */
-    mimeType?: 'image/jpeg';
+    mime_type?: 'image/jpeg';
 }
 
 /** Image search for grounding and related configurations. */
@@ -6248,6 +6247,10 @@ declare interface Interaction {
      * Required. Output only. The status of the interaction.
      */
     status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
+    /**
+     * Required. Output only. The steps that make up the interaction.
+     */
+    steps: Array<Step>;
     /**
      * Required. Output only. The time at which the response was last updated in ISO
      * 8601 format (YYYY-MM-DDThh:mm:ssZ).
@@ -6294,10 +6297,6 @@ declare interface Interaction {
      * The service tier for the interaction.
      */
     service_tier?: 'flex' | 'standard' | 'priority';
-    /**
-     * Output only. The steps that make up the interaction.
-     */
-    steps?: Array<Step>;
     /**
      * System instruction for the interaction.
      */
@@ -7912,7 +7911,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-preview' | 'gemini-3.1-flash-tts-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
+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' | 'lyria-3-clip-preview' | 'lyria-3-pro-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 {
@@ -9963,7 +9962,7 @@ export declare enum StartSensitivity {
 declare type Step = UserInputStep | ModelOutputStep | ThoughtStep | FunctionCallStep | CodeExecutionCallStep | URLContextCallStep | MCPServerToolCallStep | GoogleSearchCallStep | FileSearchCallStep | GoogleMapsCallStep | FunctionResultStep | CodeExecutionResultStep | URLContextResultStep | GoogleSearchResultStep | MCPServerToolResultStep | FileSearchResultStep | GoogleMapsResultStep;
 
 declare interface StepDelta {
-    delta: StepDelta.Text | StepDelta.Image | StepDelta.Audio | StepDelta.Document | StepDelta.Video | StepDelta.ThoughtSummary | StepDelta.ThoughtSignature | StepDelta.TextAnnotationDelta | StepDelta.ArgumentsDelta;
+    delta: StepDelta.Text | StepDelta.Image | StepDelta.Audio | StepDelta.Document | StepDelta.Video | StepDelta.ThoughtSummary | StepDelta.ThoughtSignature | StepDelta.TextAnnotationDelta | StepDelta.ArgumentsDelta | StepDelta.CodeExecutionCall | StepDelta.URLContextCall | StepDelta.GoogleSearchCall | StepDelta.MCPServerToolCall | StepDelta.FileSearchCall | StepDelta.GoogleMapsCall | StepDelta.CodeExecutionResult | StepDelta.URLContextResult | StepDelta.GoogleSearchResult | StepDelta.MCPServerToolResult | StepDelta.FileSearchResult | StepDelta.GoogleMapsResult;
     event_type: 'step.delta';
     index: number;
     /**
@@ -10044,7 +10043,125 @@ declare namespace StepDelta {
     }
     interface ArgumentsDelta {
         type: 'arguments_delta';
-        partial_arguments?: string;
+    }
+    interface CodeExecutionCall {
+        /**
+         * The arguments to pass to the code execution.
+         */
+        arguments: InteractionsAPI.CodeExecutionCallArguments;
+        type: 'code_execution_call';
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface URLContextCall {
+        /**
+         * The arguments to pass to the URL context.
+         */
+        arguments: InteractionsAPI.URLContextCallArguments;
+        type: 'url_context_call';
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface GoogleSearchCall {
+        /**
+         * The arguments to pass to Google Search.
+         */
+        arguments: InteractionsAPI.GoogleSearchCallArguments;
+        type: 'google_search_call';
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface MCPServerToolCall {
+        arguments: {
+            [key: string]: unknown;
+        };
+        name: string;
+        server_name: string;
+        type: 'mcp_server_tool_call';
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface FileSearchCall {
+        type: 'file_search_call';
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface GoogleMapsCall {
+        type: 'google_maps_call';
+        /**
+         * The arguments to pass to the Google Maps tool.
+         */
+        arguments?: InteractionsAPI.GoogleMapsCallArguments;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface CodeExecutionResult {
+        result: string;
+        type: 'code_execution_result';
+        is_error?: boolean;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface URLContextResult {
+        result: Array<InteractionsAPI.URLContextResult>;
+        type: 'url_context_result';
+        is_error?: boolean;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface GoogleSearchResult {
+        result: Array<InteractionsAPI.GoogleSearchResult>;
+        type: 'google_search_result';
+        is_error?: boolean;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface MCPServerToolResult {
+        result: unknown | Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent> | string;
+        type: 'mcp_server_tool_result';
+        name?: string;
+        server_name?: string;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface FileSearchResult {
+        result: Array<unknown>;
+        type: 'file_search_result';
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
+    }
+    interface GoogleMapsResult {
+        type: 'google_maps_result';
+        /**
+         * The results of the Google Maps.
+         */
+        result?: Array<InteractionsAPI.GoogleMapsResult>;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
     }
 }
 
@@ -10313,7 +10430,7 @@ declare interface TextResponseFormat {
     /**
      * The MIME type of the text output.
      */
-    mimeType?: 'application/json' | 'text/plain';
+    mime_type?: 'application/json' | 'text/plain';
     /**
      * The JSON schema that the output should conform to. Only applicable when
      * mime_type is application/json.
@@ -10537,7 +10654,7 @@ declare namespace Tool_2 {
         /**
          * The list of predefined functions that are excluded from the model call.
          */
-        excludedPredefinedFunctions?: Array<string>;
+        excluded_predefined_functions?: Array<string>;
     }
     /**
      * A MCPServer is a server that can be called by the model to perform actions.
@@ -12568,6 +12685,23 @@ export declare interface VideoMetadata {
  */
 declare interface VideoResponseFormat {
     type: 'video';
+    /**
+     * The aspect ratio for the video output.
+     */
+    aspectRatio?: '16:9' | '9:16';
+    /**
+     * The delivery mode for the video output.
+     */
+    delivery?: 'inline' | 'uri';
+    /**
+     * The duration for the video output.
+     */
+    duration?: string;
+    /**
+     * The GCS URI to store the video output. Required for Vertex if delivery mode is
+     * URI.
+     */
+    gcsUri?: string;
 }
 
 /** Voice activity signal. */