@google/genai 1.44.0 → 1.45.0

package/dist/node/node.d.ts

@@ -497,6 +497,9 @@ declare interface AudioContent {
 
 /** The audio transcription configuration in Setup. */
 export declare interface AudioTranscriptionConfig {
+    /** The language codes of the audio. BCP-47 language code. If not set, the transcription will be in the language detected by the model. If set, the server will use the language code specified in the model config as a hint for the language of the audio
+     */
+    languageCodes?: string[];
 }
 
 /**
@@ -650,11 +653,11 @@ declare interface BaseCreateAgentInteractionParams {
      */
     agent: (string & {}) | 'deep-research-pro-preview-12-2025';
     /**
-     * Body param: The inputs for the interaction.
+     * Body param: The input for the interaction.
      */
-    input: string | Array<Content_2> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
+    input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
     /**
-     * Body param: Configuration for the agent.
+     * Body param: Configuration parameters for the agent interaction.
      */
     agent_config?: DynamicAgentConfig | DeepResearchAgentConfig;
     /**
@@ -702,9 +705,9 @@ declare interface BaseCreateModelInteractionParams {
      */
     api_version?: string;
     /**
-     * Body param: The inputs for the interaction.
+     * Body param: The input for the interaction.
      */
-    input: string | Array<Content_2> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
+    input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
     /**
      * Body param: The name of the `Model` used for generating the interaction.
      */
@@ -797,7 +800,7 @@ declare class BaseGeminiNextGenAPIClient {
     /**
      * Basic re-implementation of `qs.stringify` for primitive types.
      */
-    protected stringifyQuery(query: Record<string, unknown>): string;
+    protected stringifyQuery(query: object | Record<string, unknown>): string;
     private getUserAgent;
     protected defaultIdempotencyKey(): string;
     protected makeStatusError(status: number, error: Object, message: string | undefined, headers: Headers): Errors.APIError;
@@ -851,7 +854,7 @@ declare class BaseInteractions extends APIResource {
      * ```ts
      * const interaction = await client.interactions.create({
      *   api_version: 'api_version',
-     *   input: 'string',
+     *   input: [{ text: 'text', type: 'text' }],
      *   model: 'gemini-2.5-flash',
      * });
      * ```
@@ -1700,10 +1703,6 @@ declare interface CodeExecutionCallContent {
      */
     arguments: CodeExecutionCallArguments;
     type: 'code_execution_call';
-    /**
-     * A signature hash for backend validation.
-     */
-    signature?: string;
 }
 
 /** Result of executing the [ExecutableCode]. Only generated when using the [CodeExecution] tool, and always follows a `part` containing the [ExecutableCode]. */
@@ -1875,7 +1874,7 @@ declare namespace ContentDelta {
     interface ThoughtSummaryDelta {
         type: 'thought_summary';
         /**
-         * A text content block.
+         * A new summary item to be added to the thought.
          */
         content?: InteractionsAPI.TextContent | InteractionsAPI.ImageContent;
     }
@@ -1896,10 +1895,6 @@ declare namespace ContentDelta {
         };
         name: string;
         type: 'function_call';
-        /**
-         * A signature hash for backend validation.
-         */
-        signature?: string;
     }
     interface FunctionResultDelta {
         /**
@@ -1933,10 +1928,6 @@ declare namespace ContentDelta {
          */
         arguments: InteractionsAPI.CodeExecutionCallArguments;
         type: 'code_execution_call';
-        /**
-         * A signature hash for backend validation.
-         */
-        signature?: string;
     }
     interface CodeExecutionResultDelta {
         /**
@@ -1961,10 +1952,6 @@ declare namespace ContentDelta {
          */
         arguments: InteractionsAPI.URLContextCallArguments;
         type: 'url_context_call';
-        /**
-         * A signature hash for backend validation.
-         */
-        signature?: string;
     }
     interface URLContextResultDelta {
         /**
@@ -1989,10 +1976,6 @@ declare namespace ContentDelta {
          */
         arguments: InteractionsAPI.GoogleSearchCallArguments;
         type: 'google_search_call';
-        /**
-         * A signature hash for backend validation.
-         */
-        signature?: string;
     }
     interface GoogleSearchResultDelta {
         /**
@@ -2018,10 +2001,6 @@ declare namespace ContentDelta {
         name: string;
         server_name: string;
         type: 'mcp_server_tool_call';
-        /**
-         * A signature hash for backend validation.
-         */
-        signature?: string;
     }
     interface MCPServerToolResultDelta {
         /**
@@ -2051,14 +2030,18 @@ declare namespace ContentDelta {
          */
         id: string;
         type: 'file_search_call';
-        /**
-         * A signature hash for backend validation.
-         */
-        signature?: string;
     }
     interface FileSearchResultDelta {
+        /**
+         * ID to match the ID from the function call block.
+         */
+        call_id: string;
         type: 'file_search_result';
         result?: Array<FileSearchResultDelta.Result>;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
     }
     namespace FileSearchResultDelta {
         /**
@@ -3684,10 +3667,6 @@ declare interface FileSearchCallContent {
      */
     id: string;
     type: 'file_search_call';
-    /**
-     * A signature hash for backend validation.
-     */
-    signature?: string;
 }
 
 /**
@@ -4028,10 +4007,6 @@ declare interface FunctionCallContent {
      */
     name: string;
     type: 'function_call';
-    /**
-     * A signature hash for backend validation.
-     */
-    signature?: string;
 }
 
 /** Function calling config. */
@@ -4176,7 +4151,7 @@ declare interface FunctionResultContent {
     /**
      * The result of the tool call.
      */
-    result: FunctionResultContent.Items | unknown | string;
+    result: unknown | Array<TextContent | ImageContent> | string;
     type: 'function_result';
     /**
      * Whether the tool call resulted in an error.
@@ -4192,12 +4167,6 @@ declare interface FunctionResultContent {
     signature?: string;
 }
 
-declare namespace FunctionResultContent {
-    interface Items {
-        items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
-    }
-}
-
 /** The Google Cloud Storage location for the input content. This data type is not supported in Gemini API. */
 export declare interface GcsSource {
     /** Required. Google Cloud Storage URI(-s) to the input file(s). May contain wildcards. For more information on wildcards, see https://cloud.google.com/storage/docs/wildcards. */
@@ -4316,7 +4285,6 @@ export declare interface GenerateContentConfig {
      - `application/json`: JSON response in the candidates.
      The model needs to be prompted to output the appropriate response type,
      otherwise the behavior is undefined.
-     This is a preview feature.
      */
     responseMimeType?: string;
     /** The `Schema` object allows the definition of input and output data types.
@@ -5311,10 +5279,6 @@ declare interface GoogleSearchCallContent {
      * The type of search grounding enabled.
      */
     search_type?: 'web_search' | 'image_search';
-    /**
-     * A signature hash for backend validation.
-     */
-    signature?: string;
 }
 
 /**
@@ -6060,13 +6024,13 @@ declare interface Interaction {
      */
     agent?: (string & {}) | 'deep-research-pro-preview-12-2025';
     /**
-     * Configuration for the agent.
+     * Configuration parameters for the agent interaction.
      */
     agent_config?: DynamicAgentConfig | DeepResearchAgentConfig;
     /**
-     * The inputs for the interaction.
+     * The input for the interaction.
      */
-    input?: string | Array<Content_2> | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
+    input?: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
     /**
      * The name of the `Model` used for generating the interaction.
      */
@@ -7479,10 +7443,6 @@ declare interface MCPServerToolCallContent {
      */
     server_name: string;
     type: 'mcp_server_tool_call';
-    /**
-     * A signature hash for backend validation.
-     */
-    signature?: string;
 }
 
 /**
@@ -7494,9 +7454,9 @@ declare interface MCPServerToolResultContent {
      */
     call_id: string;
     /**
-     * The result of the tool call.
+     * The output from the MCP server call. Can be simple text or rich content.
      */
-    result: MCPServerToolResultContent.Items | unknown | string;
+    result: unknown | Array<TextContent | ImageContent> | string;
     type: 'mcp_server_tool_result';
     /**
      * Name of the tool which is called for this specific tool call.
@@ -7512,12 +7472,6 @@ declare interface MCPServerToolResultContent {
     signature?: string;
 }
 
-declare namespace MCPServerToolResultContent {
-    interface Items {
-        items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
-    }
-}
-
 /**
  * Creates a McpCallableTool from MCP clients and an optional config.
  *
@@ -10003,19 +9957,9 @@ export declare interface Tool {
 /**
  * A tool that can be used by the model.
  */
-declare type Tool_2 = Function_2 | Tool_2.GoogleSearch | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.FileSearch;
+declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch;
 
 declare namespace Tool_2 {
-    /**
-     * A tool that can be used by the model to search Google.
-     */
-    interface GoogleSearch {
-        type: 'google_search';
-        /**
-         * The types of search grounding to enable.
-         */
-        search_types?: Array<'web_search' | 'image_search'>;
-    }
     /**
      * A tool that can be used by the model to execute code.
      */
@@ -10067,6 +10011,16 @@ declare namespace Tool_2 {
          */
         url?: string;
     }
+    /**
+     * A tool that can be used by the model to search Google.
+     */
+    interface GoogleSearch {
+        type: 'google_search';
+        /**
+         * The types of search grounding to enable.
+         */
+        search_types?: Array<'web_search' | 'image_search'>;
+    }
     /**
      * A tool that can be used by the model to search files.
      */
@@ -11332,10 +11286,6 @@ declare interface URLContextCallContent {
      */
     arguments: URLContextCallArguments;
     type: 'url_context_call';
-    /**
-     * A signature hash for backend validation.
-     */
-    signature?: string;
 }
 
 /** Metadata returned when the model uses the `url_context` tool to get information from a user-provided URL. */