@google/genai 1.44.0 → 1.46.0

package/dist/genai.d.ts

@@ -157,23 +157,7 @@ declare interface AllowedTools {
 /**
  * Citation information for model-generated content.
  */
-declare interface Annotation {
-    /**
-     * End of the attributed segment, exclusive.
-     */
-    end_index?: number;
-    /**
-     * Source attributed for a portion of the text. Could be a URL, title, or
-     * other identifier.
-     */
-    source?: string;
-    /**
-     * Start of segment of the response that is attributed to this source.
-     *
-     * Index indicates the start of the segment, measured in bytes.
-     */
-    start_index?: number;
-}
+declare type Annotation = URLCitation | FileCitation | PlaceCitation;
 
 /** 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 {
@@ -497,6 +481,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 +637,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 | GoogleMapsCallContent | GoogleMapsResultContent;
     /**
-     * Body param: Configuration for the agent.
+     * Body param: Configuration parameters for the agent interaction.
      */
     agent_config?: DynamicAgentConfig | DeepResearchAgentConfig;
     /**
@@ -702,9 +689,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 | GoogleMapsCallContent | GoogleMapsResultContent;
     /**
      * Body param: The name of the `Model` used for generating the interaction.
      */
@@ -797,7 +784,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 +838,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',
      * });
      * ```
@@ -1706,12 +1693,16 @@ declare interface CodeExecutionCallContent {
     signature?: string;
 }
 
-/** Result of executing the [ExecutableCode]. Only generated when using the [CodeExecution] tool, and always follows a `part` containing the [ExecutableCode]. */
+/** Result of executing the `ExecutableCode`.
+
+ Generated only when the `CodeExecution` tool is used. */
 export declare interface CodeExecutionResult {
     /** Required. Outcome of the code execution. */
     outcome?: Outcome;
     /** Optional. Contains stdout when code execution is successful, stderr or other description otherwise. */
     output?: string;
+    /** The identifier of the `ExecutableCode` part this result is for. Only populated if the corresponding `ExecutableCode` has an id. */
+    id?: string;
 }
 
 /**
@@ -1819,10 +1810,10 @@ export declare interface Content {
 /**
  * The content of the response.
  */
-declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
+declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
 
 declare interface ContentDelta {
-    delta: ContentDelta.TextDelta | ContentDelta.ImageDelta | ContentDelta.AudioDelta | ContentDelta.DocumentDelta | ContentDelta.VideoDelta | ContentDelta.ThoughtSummaryDelta | ContentDelta.ThoughtSignatureDelta | ContentDelta.FunctionCallDelta | ContentDelta.FunctionResultDelta | ContentDelta.CodeExecutionCallDelta | ContentDelta.CodeExecutionResultDelta | ContentDelta.URLContextCallDelta | ContentDelta.URLContextResultDelta | ContentDelta.GoogleSearchCallDelta | ContentDelta.GoogleSearchResultDelta | ContentDelta.MCPServerToolCallDelta | ContentDelta.MCPServerToolResultDelta | ContentDelta.FileSearchCallDelta | ContentDelta.FileSearchResultDelta;
+    delta: ContentDelta.Text | ContentDelta.Image | ContentDelta.Audio | ContentDelta.Document | ContentDelta.Video | ContentDelta.ThoughtSummary | ContentDelta.ThoughtSignature | ContentDelta.FunctionCall | ContentDelta.FunctionResult | ContentDelta.CodeExecutionCall | ContentDelta.CodeExecutionResult | ContentDelta.URLContextCall | ContentDelta.URLContextResult | ContentDelta.GoogleSearchCall | ContentDelta.GoogleSearchResult | ContentDelta.MCPServerToolCall | ContentDelta.MCPServerToolResult | ContentDelta.FileSearchCall | ContentDelta.FileSearchResult | ContentDelta.GoogleMapsCall | ContentDelta.GoogleMapsResult;
     event_type: 'content.delta';
     index: number;
     /**
@@ -1832,7 +1823,7 @@ declare interface ContentDelta {
 }
 
 declare namespace ContentDelta {
-    interface TextDelta {
+    interface Text {
         text: string;
         type: 'text';
         /**
@@ -1840,7 +1831,7 @@ declare namespace ContentDelta {
          */
         annotations?: Array<InteractionsAPI.Annotation>;
     }
-    interface ImageDelta {
+    interface Image {
         type: 'image';
         data?: string;
         mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
@@ -1850,19 +1841,19 @@ declare namespace ContentDelta {
         resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
         uri?: string;
     }
-    interface AudioDelta {
+    interface Audio {
         type: 'audio';
         data?: string;
         mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac';
         uri?: string;
     }
-    interface DocumentDelta {
+    interface Document {
         type: 'document';
         data?: string;
         mime_type?: 'application/pdf';
         uri?: string;
     }
-    interface VideoDelta {
+    interface Video {
         type: 'video';
         data?: string;
         mime_type?: 'video/mp4' | 'video/mpeg' | 'video/mpg' | 'video/mov' | 'video/avi' | 'video/x-flv' | 'video/webm' | 'video/wmv' | 'video/3gpp';
@@ -1872,21 +1863,21 @@ declare namespace ContentDelta {
         resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
         uri?: string;
     }
-    interface ThoughtSummaryDelta {
+    interface ThoughtSummary {
         type: 'thought_summary';
         /**
-         * A text content block.
+         * A new summary item to be added to the thought.
          */
         content?: InteractionsAPI.TextContent | InteractionsAPI.ImageContent;
     }
-    interface ThoughtSignatureDelta {
+    interface ThoughtSignature {
         type: 'thought_signature';
         /**
          * Signature to match the backend source to be part of the generation.
          */
         signature?: string;
     }
-    interface FunctionCallDelta {
+    interface FunctionCall {
         /**
          * A unique ID for this specific tool call.
          */
@@ -1901,7 +1892,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface FunctionResultDelta {
+    interface FunctionResult {
         /**
          * ID to match the ID from the function call block.
          */
@@ -1909,7 +1900,7 @@ declare namespace ContentDelta {
         /**
          * Tool call result delta.
          */
-        result: FunctionResultDelta.Items | unknown | string;
+        result: FunctionResult.Items | unknown | string;
         type: 'function_result';
         is_error?: boolean;
         name?: string;
@@ -1918,12 +1909,12 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    namespace FunctionResultDelta {
+    namespace FunctionResult {
         interface Items {
             items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
         }
     }
-    interface CodeExecutionCallDelta {
+    interface CodeExecutionCall {
         /**
          * A unique ID for this specific tool call.
          */
@@ -1938,7 +1929,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface CodeExecutionResultDelta {
+    interface CodeExecutionResult {
         /**
          * ID to match the ID from the function call block.
          */
@@ -1951,7 +1942,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface URLContextCallDelta {
+    interface URLContextCall {
         /**
          * A unique ID for this specific tool call.
          */
@@ -1966,7 +1957,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface URLContextResultDelta {
+    interface URLContextResult {
         /**
          * ID to match the ID from the function call block.
          */
@@ -1979,7 +1970,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface GoogleSearchCallDelta {
+    interface GoogleSearchCall {
         /**
          * A unique ID for this specific tool call.
          */
@@ -1994,7 +1985,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface GoogleSearchResultDelta {
+    interface GoogleSearchResult {
         /**
          * ID to match the ID from the function call block.
          */
@@ -2007,7 +1998,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface MCPServerToolCallDelta {
+    interface MCPServerToolCall {
         /**
          * A unique ID for this specific tool call.
          */
@@ -2023,7 +2014,7 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface MCPServerToolResultDelta {
+    interface MCPServerToolResult {
         /**
          * ID to match the ID from the function call block.
          */
@@ -2031,7 +2022,7 @@ declare namespace ContentDelta {
         /**
          * Tool call result delta.
          */
-        result: MCPServerToolResultDelta.Items | unknown | string;
+        result: MCPServerToolResult.Items | unknown | string;
         type: 'mcp_server_tool_result';
         name?: string;
         server_name?: string;
@@ -2040,12 +2031,12 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    namespace MCPServerToolResultDelta {
+    namespace MCPServerToolResult {
         interface Items {
             items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
         }
     }
-    interface FileSearchCallDelta {
+    interface FileSearchCall {
         /**
          * A unique ID for this specific tool call.
          */
@@ -2056,28 +2047,47 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
-    interface FileSearchResultDelta {
+    interface FileSearchResult {
+        /**
+         * ID to match the ID from the function call block.
+         */
+        call_id: string;
         type: 'file_search_result';
-        result?: Array<FileSearchResultDelta.Result>;
+        result?: Array<unknown>;
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
     }
-    namespace FileSearchResultDelta {
+    interface GoogleMapsCall {
         /**
-         * The result of the File Search.
+         * A unique ID for this specific tool call.
          */
-        interface Result {
-            /**
-             * The name of the file search store.
-             */
-            file_search_store?: string;
-            /**
-             * The text of the search result.
-             */
-            text?: string;
-            /**
-             * The title of the search result.
-             */
-            title?: string;
-        }
+        id: string;
+        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 GoogleMapsResult {
+        /**
+         * ID to match the ID from the function call block.
+         */
+        call_id: string;
+        /**
+         * The results of the Google Maps.
+         */
+        result: Array<InteractionsAPI.GoogleMapsResult>;
+        type: 'google_maps_result';
+        /**
+         * A signature hash for backend validation.
+         */
+        signature?: string;
     }
 }
 
@@ -3424,12 +3434,18 @@ export declare interface ExactMatchMetricValue {
     score?: number;
 }
 
-/** Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the [CodeExecution] tool, in which the code will be automatically executed, and a corresponding [CodeExecutionResult] will also be generated. */
+/** Model-generated code executed server-side, results returned to the model.
+
+ Only generated when using the `CodeExecution` tool, in which the code will
+ be automatically executed, and a corresponding `CodeExecutionResult` will
+ also be generated. */
 export declare interface ExecutableCode {
     /** Required. The code to be executed. */
     code?: string;
     /** Required. Programming language of the `code`. */
     language?: Language;
+    /** Unique identifier of the `ExecutableCode` part. The server returns the `CodeExecutionResult` with the matching `id`. */
+    id?: string;
 }
 
 /** Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec. This data type is not supported in Gemini API. */
@@ -3534,6 +3550,33 @@ declare interface File_2 {
 }
 export { File_2 as File }
 
+/**
+ * A file citation annotation.
+ */
+declare interface FileCitation {
+    type: 'file_citation';
+    /**
+     * The URI of the file.
+     */
+    document_uri?: string;
+    /**
+     * End of the attributed segment, exclusive.
+     */
+    end_index?: number;
+    /**
+     * The name of the file.
+     */
+    file_name?: string;
+    /**
+     * Source attributed for a portion of the text.
+     */
+    source?: string;
+    /**
+     * Start of segment of the response that is attributed to this source.
+     */
+    start_index?: number;
+}
+
 /** 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. */
@@ -3702,33 +3745,13 @@ declare interface FileSearchResultContent {
     /**
      * The results of the File Search.
      */
-    result?: Array<FileSearchResultContent.Result>;
+    result?: Array<unknown>;
     /**
      * A signature hash for backend validation.
      */
     signature?: string;
 }
 
-declare namespace FileSearchResultContent {
-    /**
-     * The result of the File Search.
-     */
-    interface Result {
-        /**
-         * The name of the file search store.
-         */
-        file_search_store?: string;
-        /**
-         * The text of the search result.
-         */
-        text?: string;
-        /**
-         * The title of the search result.
-         */
-        title?: string;
-    }
-}
-
 /** A collection of Documents. */
 export declare interface FileSearchStore {
     /** The resource name of the FileSearchStore. Example: `fileSearchStores/my-file-search-store-123` */
@@ -4176,7 +4199,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 +4215,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 +4333,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.
@@ -5250,6 +5266,110 @@ export declare interface GoogleMaps {
     enableWidget?: boolean;
 }
 
+/**
+ * The arguments to pass to the Google Maps tool.
+ */
+declare interface GoogleMapsCallArguments {
+    /**
+     * The queries to be executed.
+     */
+    queries?: Array<string>;
+}
+
+/**
+ * Google Maps content.
+ */
+declare interface GoogleMapsCallContent {
+    /**
+     * A unique ID for this specific tool call.
+     */
+    id: string;
+    type: 'google_maps_call';
+    /**
+     * The arguments to pass to the Google Maps tool.
+     */
+    arguments?: GoogleMapsCallArguments;
+    /**
+     * A signature hash for backend validation.
+     */
+    signature?: string;
+}
+
+/**
+ * The result of the Google Maps.
+ */
+declare interface GoogleMapsResult {
+    /**
+     * The places that were found.
+     */
+    places?: Array<GoogleMapsResult.Place>;
+    /**
+     * Resource name of the Google Maps widget context token.
+     */
+    widget_context_token?: string;
+}
+
+declare namespace GoogleMapsResult {
+    interface Place {
+        /**
+         * Title of the place.
+         */
+        name?: string;
+        /**
+         * The ID of the place, in `places/{place_id}` format.
+         */
+        place_id?: string;
+        /**
+         * Snippets of reviews that are used to generate answers about the
+         * features of a given place in Google Maps.
+         */
+        review_snippets?: Array<Place.ReviewSnippet>;
+        /**
+         * URI reference of the place.
+         */
+        url?: string;
+    }
+    namespace Place {
+        /**
+         * Encapsulates a snippet of a user review that answers a question about
+         * the features of a specific place in Google Maps.
+         */
+        interface ReviewSnippet {
+            /**
+             * The ID of the review snippet.
+             */
+            review_id?: string;
+            /**
+             * Title of the review.
+             */
+            title?: string;
+            /**
+             * A link that corresponds to the user review on Google Maps.
+             */
+            url?: string;
+        }
+    }
+}
+
+/**
+ * Google Maps result content.
+ */
+declare interface GoogleMapsResultContent {
+    /**
+     * ID to match the ID from the google maps call block.
+     */
+    call_id: string;
+    /**
+     * The results of the Google Maps.
+     */
+    result: Array<GoogleMapsResult>;
+    type: 'google_maps_result';
+    /**
+     * A signature hash for backend validation.
+     */
+    signature?: string;
+}
+
 /** The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). This data type is not supported in Gemini API. */
 export declare interface GoogleRpcStatus {
     /** The status code, which should be an enum value of google.rpc.Code. */
@@ -5312,15 +5432,7 @@ declare interface GoogleSearchResult {
     /**
      * Web content snippet that can be embedded in a web page or an app webview.
      */
-    rendered_content?: string;
-    /**
-     * Title of the search result.
-     */
-    title?: string;
-    /**
-     * URI reference of the search result.
-     */
-    url?: string;
+    search_suggestions?: string;
 }
 
 /**
@@ -6048,13 +6160,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 | GoogleMapsCallContent | GoogleMapsResultContent;
     /**
      * The name of the `Model` used for generating the interaction.
      */
@@ -6173,7 +6285,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 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 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 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 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 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 {
@@ -6194,12 +6306,17 @@ declare namespace InteractionsAPI {
         DocumentContent,
         DynamicAgentConfig,
         ErrorEvent_2 as ErrorEvent,
+        FileCitation,
         FileSearchCallContent,
         FileSearchResultContent,
         Function_2 as Function,
         FunctionCallContent,
         FunctionResultContent,
         GenerationConfig_2 as GenerationConfig,
+        GoogleMapsCallArguments,
+        GoogleMapsCallContent,
+        GoogleMapsResult,
+        GoogleMapsResultContent,
         GoogleSearchCallArguments,
         GoogleSearchCallContent,
         GoogleSearchResult,
@@ -6214,6 +6331,7 @@ declare namespace InteractionsAPI {
         MCPServerToolCallContent,
         MCPServerToolResultContent,
         Model_2 as Model,
+        PlaceCitation,
         SpeechConfig_2 as SpeechConfig,
         TextContent,
         ThinkingLevel_2 as ThinkingLevel,
@@ -6222,6 +6340,7 @@ declare namespace InteractionsAPI {
         ToolChoiceConfig,
         ToolChoiceType,
         Turn,
+        URLCitation,
         URLContextCallArguments,
         URLContextCallContent,
         URLContextResult,
@@ -7482,9 +7601,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.
@@ -7500,12 +7619,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.
  *
@@ -8426,6 +8539,10 @@ export declare interface Part {
     thoughtSignature?: string;
     /** Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. */
     videoMetadata?: VideoMetadata;
+    /** Server-side tool call. This field is populated when the model predicts a tool invocation that should be executed on the server. The client is expected to echo this message back to the API. */
+    toolCall?: ToolCall;
+    /** The output from a server-side ToolCall execution. This field is populated by the client with the results of executing the corresponding ToolCall. */
+    toolResponse?: ToolResponse;
 }
 
 /** Partial argument value of the function call. This data type is not supported in Gemini API. */
@@ -8543,6 +8660,59 @@ export declare enum PhishBlockThreshold {
     BLOCK_ONLY_EXTREMELY_HIGH = "BLOCK_ONLY_EXTREMELY_HIGH"
 }
 
+/**
+ * A place citation annotation.
+ */
+declare interface PlaceCitation {
+    type: 'place_citation';
+    /**
+     * End of the attributed segment, exclusive.
+     */
+    end_index?: number;
+    /**
+     * Title of the place.
+     */
+    name?: string;
+    /**
+     * The ID of the place, in `places/{place_id}` format.
+     */
+    place_id?: string;
+    /**
+     * Snippets of reviews that are used to generate answers about the
+     * features of a given place in Google Maps.
+     */
+    review_snippets?: Array<PlaceCitation.ReviewSnippet>;
+    /**
+     * Start of segment of the response that is attributed to this source.
+     */
+    start_index?: number;
+    /**
+     * URI reference of the place.
+     */
+    url?: string;
+}
+
+declare namespace PlaceCitation {
+    /**
+     * Encapsulates a snippet of a user review that answers a question about
+     * the features of a specific place in Google Maps.
+     */
+    interface ReviewSnippet {
+        /**
+         * The ID of the review snippet.
+         */
+        review_id?: string;
+        /**
+         * Title of the review.
+         */
+        title?: string;
+        /**
+         * A link that corresponds to the user review on Google Maps.
+         */
+        url?: string;
+    }
+}
+
 /** Spec for pointwise metric result. This data type is not supported in Gemini API. */
 export declare interface PointwiseMetricResult {
     /** Output only. Spec for custom output. */
@@ -9991,7 +10161,7 @@ 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.GoogleSearch | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.FileSearch | Tool_2.GoogleMaps;
 
 declare namespace Tool_2 {
     /**
@@ -10073,6 +10243,40 @@ declare namespace Tool_2 {
          */
         top_k?: number;
     }
+    /**
+     * A tool that can be used by the model to call Google Maps.
+     */
+    interface GoogleMaps {
+        /**
+         * Whether to return a widget context token in the tool call result of the
+         * response.
+         */
+        enable_widget?: boolean;
+        /**
+         * The latitude of the user's location.
+         */
+        latitude?: number;
+        /**
+         * The longitude of the user's location.
+         */
+        longitude?: number;
+        type?: 'google_maps';
+    }
+}
+
+/** A predicted server-side `ToolCall` returned from the model.
+
+ This message contains information about a tool that the model wants to invoke.
+ The client is NOT expected to execute this `ToolCall`. Instead, the
+ client should pass this `ToolCall` back to the API in a subsequent turn
+ within a `Content` message, along with the corresponding `ToolResponse`. */
+export declare interface ToolCall {
+    /** Unique identifier of the tool call. The server returns the tool response with the matching `id`. */
+    id?: string;
+    /** The type of tool that was called. */
+    toolType?: ToolType;
+    /** The tool call arguments. Example: {"arg1": "value1", "arg2": "value2"}. */
+    args?: Record<string, unknown>;
 }
 
 /**
@@ -10099,6 +10303,8 @@ export declare interface ToolConfig {
     retrievalConfig?: RetrievalConfig;
     /** Optional. Function calling config. */
     functionCallingConfig?: FunctionCallingConfig;
+    /** If true, the API response will include the server-side tool calls and responses within the `Content` message. This allows clients to observe the server's tool invocations. */
+    includeServerSideToolInvocations?: boolean;
 }
 
 export declare type ToolListUnion = ToolUnion[];
@@ -10111,6 +10317,49 @@ export declare interface ToolParallelAiSearch {
     customConfigs?: Record<string, unknown>;
 }
 
+/** The output from a server-side `ToolCall` execution.
+
+ This message contains the results of a tool invocation that was initiated by a
+ `ToolCall` from the model. The client should pass this `ToolResponse` back to
+ the API in a subsequent turn within a `Content` message, along with the
+ corresponding `ToolCall`. */
+export declare class ToolResponse {
+    /** The identifier of the tool call this response is for. */
+    id?: string;
+    /** The type of tool that was called, matching the tool_type in the corresponding ToolCall. */
+    toolType?: ToolType;
+    /** The tool response. */
+    response?: Record<string, unknown>;
+}
+
+/** The type of tool in the function call. */
+export declare enum ToolType {
+    /**
+     * Unspecified tool type.
+     */
+    TOOL_TYPE_UNSPECIFIED = "TOOL_TYPE_UNSPECIFIED",
+    /**
+     * Google search tool, maps to Tool.google_search.search_types.web_search.
+     */
+    GOOGLE_SEARCH_WEB = "GOOGLE_SEARCH_WEB",
+    /**
+     * Image search tool, maps to Tool.google_search.search_types.image_search.
+     */
+    GOOGLE_SEARCH_IMAGE = "GOOGLE_SEARCH_IMAGE",
+    /**
+     * URL context tool, maps to Tool.url_context.
+     */
+    URL_CONTEXT = "URL_CONTEXT",
+    /**
+     * Google maps tool, maps to Tool.google_maps.
+     */
+    GOOGLE_MAPS = "GOOGLE_MAPS",
+    /**
+     * File search tool, maps to Tool.file_search.
+     */
+    FILE_SEARCH = "FILE_SEARCH"
+}
+
 export declare type ToolUnion = Tool | CallableTool;
 
 /** Output only. The traffic type for this request. This enum is not supported in Gemini API. */
@@ -10537,8 +10786,8 @@ declare namespace types {
         createPartFromExecutableCode,
         createUserContent,
         createModelContent,
-        Outcome,
         Language,
+        Outcome,
         FunctionResponseScheduling,
         Type,
         PhishBlockThreshold,
@@ -10569,6 +10818,7 @@ declare namespace types {
         PairwiseChoice,
         TuningTask,
         PartMediaResolutionLevel,
+        ToolType,
         ResourceScope,
         FeatureSelectionPreference,
         Environment,
@@ -10599,9 +10849,11 @@ declare namespace types {
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
-        PartMediaResolution,
-        CodeExecutionResult,
         ExecutableCode,
+        CodeExecutionResult,
+        PartMediaResolution,
+        ToolCall,
+        ToolResponse,
         FileData,
         PartialArg,
         FunctionCall,
@@ -11106,7 +11358,7 @@ declare interface Uploader {
      * @param apiClient The ApiClient to use for uploading.
      * @return A Promise that resolves to types.File.
      */
-    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<File_2>;
+    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<File_2>;
     /**
      * Uploads a file to file search store via the given upload url.
      *
@@ -11115,9 +11367,10 @@ declare interface Uploader {
      *     uploaded to. The uploadUrl must be a url that was returned by the
      * https://generativelanguage.googleapis.com/upload/v1beta/{file_search_store_name}:uploadToFileSearchStore endpoint
      * @param apiClient The ApiClient to use for uploading.
+     * @param httpOptions Optional HTTP options to merge.
      * @return A Promise that resolves to types.UploadToFileSearchStoreOperation.
      */
-    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<UploadToFileSearchStoreOperation>;
+    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<UploadToFileSearchStoreOperation>;
     /**
      * Returns the file's mimeType and the size of a given file. If the file is a
      * string path, the file type is determined by the file extension. If the
@@ -11293,6 +11546,29 @@ export declare class UpscaleImageResponse {
     generatedImages?: GeneratedImage[];
 }
 
+/**
+ * A URL citation annotation.
+ */
+declare interface URLCitation {
+    type: 'url_citation';
+    /**
+     * End of the attributed segment, exclusive.
+     */
+    end_index?: number;
+    /**
+     * Start of segment of the response that is attributed to this source.
+     */
+    start_index?: number;
+    /**
+     * The title of the URL.
+     */
+    title?: string;
+    /**
+     * The URL.
+     */
+    url?: string;
+}
+
 /** Tool to support URL context. */
 export declare interface UrlContext {
 }