@google/genai 1.45.0 → 1.46.0

package/dist/vertex_internal/index.d.ts

@@ -833,12 +833,16 @@ declare interface CitationMetadata {
     citations?: Citation[];
 }
 
-/** 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. */
 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;
 }
 
 /** 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. */
@@ -2084,12 +2088,18 @@ 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. */
 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. */
@@ -5243,8 +5253,8 @@ export declare class NodeDownloader implements Downloader {
 
 export declare class NodeUploader implements Uploader {
     stat(file: string | Blob): Promise<FileStat>;
-    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<File_2>;
-    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<UploadToFileSearchStoreOperation>;
+    upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<File_2>;
+    uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<UploadToFileSearchStoreOperation>;
     /**
      * Infers the MIME type of a file based on its extension.
      *
@@ -5378,6 +5388,10 @@ 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. */
@@ -6540,6 +6554,21 @@ declare interface Tool {
     mcpServers?: McpServer[];
 }
 
+/** 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`. */
+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>;
+}
+
 /** Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool. This data type is not supported in Gemini API. */
 declare interface ToolCodeExecution {
 }
@@ -6552,6 +6581,8 @@ 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;
 }
 
 declare type ToolListUnion = ToolUnion[];
@@ -6564,6 +6595,49 @@ 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`. */
+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. */
+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"
+}
+
 declare type ToolUnion = Tool | CallableTool;
 
 /** Output only. The traffic type for this request. This enum is not supported in Gemini API. */
@@ -6922,8 +6996,8 @@ declare namespace types {
         createPartFromExecutableCode,
         createUserContent,
         createModelContent,
-        Outcome,
         Language,
+        Outcome,
         FunctionResponseScheduling,
         Type,
         PhishBlockThreshold,
@@ -6954,6 +7028,7 @@ declare namespace types {
         PairwiseChoice,
         TuningTask,
         PartMediaResolutionLevel,
+        ToolType,
         ResourceScope,
         FeatureSelectionPreference,
         Environment,
@@ -6984,9 +7059,11 @@ declare namespace types {
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
-        PartMediaResolution,
-        CodeExecutionResult,
         ExecutableCode,
+        CodeExecutionResult,
+        PartMediaResolution,
+        ToolCall,
+        ToolResponse,
         FileData,
         PartialArg,
         FunctionCall,
@@ -7460,7 +7537,7 @@ export 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.
      *
@@ -7469,9 +7546,10 @@ export 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

package/dist/vertex_internal/index.js

@@ -382,6 +382,18 @@ function uploadToFileSearchStoreResponseFromMldev(fromObject) {
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/** Programming language of the `code`. */
+var Language;
+(function (Language) {
+    /**
+     * Unspecified language. This value should not be used.
+     */
+    Language["LANGUAGE_UNSPECIFIED"] = "LANGUAGE_UNSPECIFIED";
+    /**
+     * Python >= 3.10, with numpy and simpy available.
+     */
+    Language["PYTHON"] = "PYTHON";
+})(Language || (Language = {}));
 /** Outcome of the code execution. */
 var Outcome;
 (function (Outcome) {
@@ -402,18 +414,6 @@ var Outcome;
      */
     Outcome["OUTCOME_DEADLINE_EXCEEDED"] = "OUTCOME_DEADLINE_EXCEEDED";
 })(Outcome || (Outcome = {}));
-/** Programming language of the `code`. */
-var Language;
-(function (Language) {
-    /**
-     * Unspecified language. This value should not be used.
-     */
-    Language["LANGUAGE_UNSPECIFIED"] = "LANGUAGE_UNSPECIFIED";
-    /**
-     * Python >= 3.10, with numpy and simpy available.
-     */
-    Language["PYTHON"] = "PYTHON";
-})(Language || (Language = {}));
 /** Specifies how the response should be scheduled in the conversation. */
 var FunctionResponseScheduling;
 (function (FunctionResponseScheduling) {
@@ -1242,6 +1242,34 @@ var PartMediaResolutionLevel;
      */
     PartMediaResolutionLevel["MEDIA_RESOLUTION_ULTRA_HIGH"] = "MEDIA_RESOLUTION_ULTRA_HIGH";
 })(PartMediaResolutionLevel || (PartMediaResolutionLevel = {}));
+/** The type of tool in the function call. */
+var ToolType;
+(function (ToolType) {
+    /**
+     * Unspecified tool type.
+     */
+    ToolType["TOOL_TYPE_UNSPECIFIED"] = "TOOL_TYPE_UNSPECIFIED";
+    /**
+     * Google search tool, maps to Tool.google_search.search_types.web_search.
+     */
+    ToolType["GOOGLE_SEARCH_WEB"] = "GOOGLE_SEARCH_WEB";
+    /**
+     * Image search tool, maps to Tool.google_search.search_types.image_search.
+     */
+    ToolType["GOOGLE_SEARCH_IMAGE"] = "GOOGLE_SEARCH_IMAGE";
+    /**
+     * URL context tool, maps to Tool.url_context.
+     */
+    ToolType["URL_CONTEXT"] = "URL_CONTEXT";
+    /**
+     * Google maps tool, maps to Tool.google_maps.
+     */
+    ToolType["GOOGLE_MAPS"] = "GOOGLE_MAPS";
+    /**
+     * File search tool, maps to Tool.file_search.
+     */
+    ToolType["FILE_SEARCH"] = "FILE_SEARCH";
+})(ToolType || (ToolType = {}));
 /** Resource scope. */
 var ResourceScope;
 (function (ResourceScope) {
@@ -1777,7 +1805,7 @@ const CONTENT_TYPE_HEADER = 'Content-Type';
 const SERVER_TIMEOUT_HEADER = 'X-Server-Timeout';
 const USER_AGENT_HEADER = 'User-Agent';
 const GOOGLE_API_CLIENT_HEADER = 'x-goog-api-client';
-const SDK_VERSION = '1.45.0'; // x-release-please-version
+const SDK_VERSION = '1.46.0'; // x-release-please-version
 const LIBRARY_LABEL = `google-genai-sdk/${SDK_VERSION}`;
 const VERTEX_AI_API_DEFAULT_VERSION = 'v1beta1';
 const GOOGLE_AI_API_DEFAULT_VERSION = 'v1beta';
@@ -2651,18 +2679,18 @@ const MAX_RETRY_COUNT = 3;
 const INITIAL_RETRY_DELAY_MS = 1000;
 const DELAY_MULTIPLIER = 2;
 const X_GOOG_UPLOAD_STATUS_HEADER_FIELD = 'x-goog-upload-status';
-async function uploadBlob(file, uploadUrl, apiClient) {
+async function uploadBlob(file, uploadUrl, apiClient, httpOptions) {
     var _a;
-    const response = await uploadBlobInternal(file, uploadUrl, apiClient);
+    const response = await uploadBlobInternal(file, uploadUrl, apiClient, httpOptions);
     const responseJson = (await (response === null || response === void 0 ? void 0 : response.json()));
     if (((_a = response === null || response === void 0 ? void 0 : response.headers) === null || _a === void 0 ? void 0 : _a[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'final') {
         throw new Error('Failed to upload file: Upload status is not finalized.');
     }
     return responseJson['file'];
 }
-async function uploadBlobToFileSearchStore(file, uploadUrl, apiClient) {
+async function uploadBlobToFileSearchStore(file, uploadUrl, apiClient, httpOptions) {
     var _a;
-    const response = await uploadBlobInternal(file, uploadUrl, apiClient);
+    const response = await uploadBlobInternal(file, uploadUrl, apiClient, httpOptions);
     const responseJson = (await (response === null || response === void 0 ? void 0 : response.json()));
     if (((_a = response === null || response === void 0 ? void 0 : response.headers) === null || _a === void 0 ? void 0 : _a[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'final') {
         throw new Error('Failed to upload file: Upload status is not finalized.');
@@ -2672,8 +2700,18 @@ async function uploadBlobToFileSearchStore(file, uploadUrl, apiClient) {
     Object.assign(typedResp, resp);
     return typedResp;
 }
-async function uploadBlobInternal(file, uploadUrl, apiClient) {
-    var _a, _b;
+async function uploadBlobInternal(file, uploadUrl, apiClient, httpOptions) {
+    var _a, _b, _c;
+    let finalUrl = uploadUrl;
+    const effectiveBaseUrl = (httpOptions === null || httpOptions === void 0 ? void 0 : httpOptions.baseUrl) || ((_a = apiClient.clientOptions.httpOptions) === null || _a === void 0 ? void 0 : _a.baseUrl);
+    if (effectiveBaseUrl) {
+        const baseUri = new URL(effectiveBaseUrl);
+        const uploadUri = new URL(uploadUrl);
+        uploadUri.protocol = baseUri.protocol;
+        uploadUri.host = baseUri.host;
+        uploadUri.port = baseUri.port;
+        finalUrl = uploadUri.toString();
+    }
     let fileSize = 0;
     let offset = 0;
     let response = new HttpResponse(new Response());
@@ -2688,21 +2726,14 @@ async function uploadBlobInternal(file, uploadUrl, apiClient) {
         let retryCount = 0;
         let currentDelayMs = INITIAL_RETRY_DELAY_MS;
         while (retryCount < MAX_RETRY_COUNT) {
+            const mergedHeaders = Object.assign(Object.assign({}, ((httpOptions === null || httpOptions === void 0 ? void 0 : httpOptions.headers) || {})), { 'X-Goog-Upload-Command': uploadCommand, 'X-Goog-Upload-Offset': String(offset), 'Content-Length': String(chunkSize) });
             response = await apiClient.request({
                 path: '',
                 body: chunk,
                 httpMethod: 'POST',
-                httpOptions: {
-                    apiVersion: '',
-                    baseUrl: uploadUrl,
-                    headers: {
-                        'X-Goog-Upload-Command': uploadCommand,
-                        'X-Goog-Upload-Offset': String(offset),
-                        'Content-Length': String(chunkSize),
-                    },
-                },
+                httpOptions: Object.assign(Object.assign({}, httpOptions), { apiVersion: '', baseUrl: finalUrl, headers: mergedHeaders }),
             });
-            if ((_a = response === null || response === void 0 ? void 0 : response.headers) === null || _a === void 0 ? void 0 : _a[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) {
+            if ((_b = response === null || response === void 0 ? void 0 : response.headers) === null || _b === void 0 ? void 0 : _b[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) {
                 break;
             }
             retryCount++;
@@ -2712,7 +2743,7 @@ async function uploadBlobInternal(file, uploadUrl, apiClient) {
         offset += chunkSize;
         // The `x-goog-upload-status` header field can be `active`, `final` and
         //`cancelled` in resposne.
-        if (((_b = response === null || response === void 0 ? void 0 : response.headers) === null || _b === void 0 ? void 0 : _b[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'active') {
+        if (((_c = response === null || response === void 0 ? void 0 : response.headers) === null || _c === void 0 ? void 0 : _c[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'active') {
             break;
         }
         // TODO(b/401391430) Investigate why the upload status is not finalized
@@ -2749,20 +2780,20 @@ class NodeUploader {
             return await getBlobStat(file);
         }
     }
-    async upload(file, uploadUrl, apiClient) {
+    async upload(file, uploadUrl, apiClient, httpOptions) {
         if (typeof file === 'string') {
-            return await this.uploadFileFromPath(file, uploadUrl, apiClient);
+            return await this.uploadFileFromPath(file, uploadUrl, apiClient, httpOptions);
         }
         else {
-            return uploadBlob(file, uploadUrl, apiClient);
+            return uploadBlob(file, uploadUrl, apiClient, httpOptions);
         }
     }
-    async uploadToFileSearchStore(file, uploadUrl, apiClient) {
+    async uploadToFileSearchStore(file, uploadUrl, apiClient, httpOptions) {
         if (typeof file === 'string') {
-            return await this.uploadFileToFileSearchStoreFromPath(file, uploadUrl, apiClient);
+            return await this.uploadFileToFileSearchStoreFromPath(file, uploadUrl, apiClient, httpOptions);
         }
         else {
-            return uploadBlobToFileSearchStore(file, uploadUrl, apiClient);
+            return uploadBlobToFileSearchStore(file, uploadUrl, apiClient, httpOptions);
         }
     }
     /**
@@ -2855,18 +2886,18 @@ class NodeUploader {
         // Return the MIME type.
         return mimeType;
     }
-    async uploadFileFromPath(file, uploadUrl, apiClient) {
+    async uploadFileFromPath(file, uploadUrl, apiClient, httpOptions) {
         var _a;
-        const response = await this.uploadFileFromPathInternal(file, uploadUrl, apiClient);
+        const response = await this.uploadFileFromPathInternal(file, uploadUrl, apiClient, httpOptions);
         const responseJson = (await (response === null || response === void 0 ? void 0 : response.json()));
         if (((_a = response === null || response === void 0 ? void 0 : response.headers) === null || _a === void 0 ? void 0 : _a[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'final') {
             throw new Error('Failed to upload file: Upload status is not finalized.');
         }
         return responseJson['file'];
     }
-    async uploadFileToFileSearchStoreFromPath(file, uploadUrl, apiClient) {
+    async uploadFileToFileSearchStoreFromPath(file, uploadUrl, apiClient, httpOptions) {
         var _a;
-        const response = await this.uploadFileFromPathInternal(file, uploadUrl, apiClient);
+        const response = await this.uploadFileFromPathInternal(file, uploadUrl, apiClient, httpOptions);
         const responseJson = (await (response === null || response === void 0 ? void 0 : response.json()));
         if (((_a = response === null || response === void 0 ? void 0 : response.headers) === null || _a === void 0 ? void 0 : _a[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'final') {
             throw new Error('Failed to upload file: Upload status is not finalized.');
@@ -2876,8 +2907,18 @@ class NodeUploader {
         Object.assign(typedResp, resp);
         return typedResp;
     }
-    async uploadFileFromPathInternal(file, uploadUrl, apiClient) {
-        var _a, _b;
+    async uploadFileFromPathInternal(file, uploadUrl, apiClient, httpOptions) {
+        var _a, _b, _c;
+        let finalUrl = uploadUrl;
+        const effectiveBaseUrl = (httpOptions === null || httpOptions === void 0 ? void 0 : httpOptions.baseUrl) || ((_a = apiClient.clientOptions.httpOptions) === null || _a === void 0 ? void 0 : _a.baseUrl);
+        if (effectiveBaseUrl) {
+            const baseUri = new URL(effectiveBaseUrl);
+            const uploadUri = new URL(uploadUrl);
+            uploadUri.protocol = baseUri.protocol;
+            uploadUri.host = baseUri.host;
+            uploadUri.port = baseUri.port;
+            finalUrl = uploadUri.toString();
+        }
         let fileSize = 0;
         let offset = 0;
         let response = new HttpResponse(new Response());
@@ -2904,22 +2945,14 @@ class NodeUploader {
                 let retryCount = 0;
                 let currentDelayMs = INITIAL_RETRY_DELAY_MS;
                 while (retryCount < MAX_RETRY_COUNT) {
+                    const mergedHeaders = Object.assign(Object.assign({}, ((httpOptions === null || httpOptions === void 0 ? void 0 : httpOptions.headers) || {})), { 'X-Goog-Upload-Command': uploadCommand, 'X-Goog-Upload-Offset': String(offset), 'Content-Length': String(bytesRead), 'X-Goog-Upload-File-Name': fileName });
                     response = await apiClient.request({
                         path: '',
                         body: chunk,
                         httpMethod: 'POST',
-                        httpOptions: {
-                            apiVersion: '',
-                            baseUrl: uploadUrl,
-                            headers: {
-                                'X-Goog-Upload-Command': uploadCommand,
-                                'X-Goog-Upload-Offset': String(offset),
-                                'Content-Length': String(bytesRead),
-                                'X-Goog-Upload-File-Name': fileName,
-                            },
-                        },
+                        httpOptions: Object.assign(Object.assign({}, httpOptions), { apiVersion: '', baseUrl: finalUrl, headers: mergedHeaders }),
                     });
-                    if ((_a = response === null || response === void 0 ? void 0 : response.headers) === null || _a === void 0 ? void 0 : _a[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) {
+                    if ((_b = response === null || response === void 0 ? void 0 : response.headers) === null || _b === void 0 ? void 0 : _b[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) {
                         break;
                     }
                     retryCount++;
@@ -2929,7 +2962,7 @@ class NodeUploader {
                 offset += bytesRead;
                 // The `x-goog-upload-status` header field can be `active`, `final` and
                 //`cancelled` in resposne.
-                if (((_b = response === null || response === void 0 ? void 0 : response.headers) === null || _b === void 0 ? void 0 : _b[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'active') {
+                if (((_c = response === null || response === void 0 ? void 0 : response.headers) === null || _c === void 0 ? void 0 : _c[X_GOOG_UPLOAD_STATUS_HEADER_FIELD]) !== 'active') {
                     break;
                 }
                 if (fileSize <= offset) {