@google/genai 1.15.0 → 1.17.0

package/dist/node/index.cjs

@@ -827,6 +827,10 @@ exports.FunctionCallingConfigMode = void 0;
      * Model will not predict any function calls. Model behavior is same as when not passing any function declarations.
      */
     FunctionCallingConfigMode["NONE"] = "NONE";
+    /**
+     * Model decides to predict either a function call or a natural language response, but will validate function calls with constrained decoding. If "allowed_function_names" are set, the predicted function call will be limited to any one of "allowed_function_names", else the predicted function call will be any one of the provided "function_declarations".
+     */
+    FunctionCallingConfigMode["VALIDATED"] = "VALIDATED";
 })(exports.FunctionCallingConfigMode || (exports.FunctionCallingConfigMode = {}));
 /** Enum that controls the safety filter level for objectionable content. */
 exports.SafetyFilterLevel = void 0;
@@ -913,7 +917,7 @@ exports.SubjectReferenceType = void 0;
     SubjectReferenceType["SUBJECT_TYPE_ANIMAL"] = "SUBJECT_TYPE_ANIMAL";
     SubjectReferenceType["SUBJECT_TYPE_PRODUCT"] = "SUBJECT_TYPE_PRODUCT";
 })(exports.SubjectReferenceType || (exports.SubjectReferenceType = {}));
-/** Enum representing the Imagen 3 Edit mode. */
+/** Enum representing the editing mode. */
 exports.EditMode = void 0;
 (function (EditMode) {
     EditMode["EDIT_MODE_DEFAULT"] = "EDIT_MODE_DEFAULT";
@@ -934,6 +938,21 @@ exports.SegmentMode = void 0;
     SegmentMode["SEMANTIC"] = "SEMANTIC";
     SegmentMode["INTERACTIVE"] = "INTERACTIVE";
 })(exports.SegmentMode || (exports.SegmentMode = {}));
+/** Enum for the reference type of a video generation reference image. */
+exports.VideoGenerationReferenceType = void 0;
+(function (VideoGenerationReferenceType) {
+    /**
+     * A reference image that provides assets to the generated video,
+        such as the scene, an object, a character, etc.
+     */
+    VideoGenerationReferenceType["ASSET"] = "ASSET";
+    /**
+     * A reference image that provides aesthetics including colors,
+        lighting, texture, etc., to be used as the style of the generated video,
+        such as 'anime', 'photography', 'origami', etc.
+     */
+    VideoGenerationReferenceType["STYLE"] = "STYLE";
+})(exports.VideoGenerationReferenceType || (exports.VideoGenerationReferenceType = {}));
 /** Enum that controls the compression quality of the generated videos. */
 exports.VideoCompressionQuality = void 0;
 (function (VideoCompressionQuality) {
@@ -1596,6 +1615,65 @@ class ComputeTokensResponse {
 /** Response with generated videos. */
 class GenerateVideosResponse {
 }
+/** A video generation operation. */
+class GenerateVideosOperation {
+    /**
+     * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
+     * @internal
+     */
+    _fromAPIResponse({ apiResponse, isVertexAI, }) {
+        const operation = new GenerateVideosOperation();
+        operation.name = apiResponse['name'];
+        operation.metadata = apiResponse['metadata'];
+        operation.done = apiResponse['done'];
+        operation.error = apiResponse['error'];
+        if (isVertexAI) {
+            const response = apiResponse['response'];
+            if (response) {
+                const operationResponse = new GenerateVideosResponse();
+                const responseVideos = response['videos'];
+                operationResponse.generatedVideos = responseVideos === null || responseVideos === void 0 ? void 0 : responseVideos.map((generatedVideo) => {
+                    return {
+                        video: {
+                            uri: generatedVideo['gcsUri'],
+                            videoBytes: generatedVideo['bytesBase64Encoded']
+                                ? tBytes$1(generatedVideo['bytesBase64Encoded'])
+                                : undefined,
+                            mimeType: generatedVideo['mimeType'],
+                        },
+                    };
+                });
+                operationResponse.raiMediaFilteredCount = response['raiMediaFilteredCount'];
+                operationResponse.raiMediaFilteredReasons = response['raiMediaFilteredReasons'];
+                operation.response = operationResponse;
+            }
+        }
+        else {
+            const response = apiResponse['response'];
+            if (response) {
+                const operationResponse = new GenerateVideosResponse();
+                const generatedVideoResponse = response['generateVideoResponse'];
+                const responseVideos = generatedVideoResponse === null || generatedVideoResponse === void 0 ? void 0 : generatedVideoResponse['generatedSamples'];
+                operationResponse.generatedVideos = responseVideos === null || responseVideos === void 0 ? void 0 : responseVideos.map((generatedVideo) => {
+                    const video = generatedVideo['video'];
+                    return {
+                        video: {
+                            uri: video === null || video === void 0 ? void 0 : video['uri'],
+                            videoBytes: (video === null || video === void 0 ? void 0 : video['encodedVideo'])
+                                ? tBytes$1(video === null || video === void 0 ? void 0 : video['encodedVideo'])
+                                : undefined,
+                            mimeType: generatedVideo['encoding'],
+                        },
+                    };
+                });
+                operationResponse.raiMediaFilteredCount = generatedVideoResponse === null || generatedVideoResponse === void 0 ? void 0 : generatedVideoResponse['raiMediaFilteredCount'];
+                operationResponse.raiMediaFilteredReasons = generatedVideoResponse === null || generatedVideoResponse === void 0 ? void 0 : generatedVideoResponse['raiMediaFilteredReasons'];
+                operation.response = operationResponse;
+            }
+        }
+        return operation;
+    }
+}
 /** Response for the list tuning jobs method. */
 class ListTuningJobsResponse {
 }
@@ -1787,65 +1865,6 @@ class LiveServerMessage {
         return data.length > 0 ? btoa(data) : undefined;
     }
 }
-/** A video generation long-running operation. */
-class GenerateVideosOperation {
-    /**
-     * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
-     * @internal
-     */
-    _fromAPIResponse({ apiResponse, isVertexAI, }) {
-        const operation = new GenerateVideosOperation();
-        operation.name = apiResponse['name'];
-        operation.metadata = apiResponse['metadata'];
-        operation.done = apiResponse['done'];
-        operation.error = apiResponse['error'];
-        if (isVertexAI) {
-            const response = apiResponse['response'];
-            if (response) {
-                const operationResponse = new GenerateVideosResponse();
-                const responseVideos = response['videos'];
-                operationResponse.generatedVideos = responseVideos === null || responseVideos === void 0 ? void 0 : responseVideos.map((generatedVideo) => {
-                    return {
-                        video: {
-                            uri: generatedVideo['gcsUri'],
-                            videoBytes: generatedVideo['bytesBase64Encoded']
-                                ? tBytes$1(generatedVideo['bytesBase64Encoded'])
-                                : undefined,
-                            mimeType: generatedVideo['mimeType'],
-                        },
-                    };
-                });
-                operationResponse.raiMediaFilteredCount = response['raiMediaFilteredCount'];
-                operationResponse.raiMediaFilteredReasons = response['raiMediaFilteredReasons'];
-                operation.response = operationResponse;
-            }
-        }
-        else {
-            const response = apiResponse['response'];
-            if (response) {
-                const operationResponse = new GenerateVideosResponse();
-                const generatedVideoResponse = response['generateVideoResponse'];
-                const responseVideos = generatedVideoResponse === null || generatedVideoResponse === void 0 ? void 0 : generatedVideoResponse['generatedSamples'];
-                operationResponse.generatedVideos = responseVideos === null || responseVideos === void 0 ? void 0 : responseVideos.map((generatedVideo) => {
-                    const video = generatedVideo['video'];
-                    return {
-                        video: {
-                            uri: video === null || video === void 0 ? void 0 : video['uri'],
-                            videoBytes: (video === null || video === void 0 ? void 0 : video['encodedVideo'])
-                                ? tBytes$1(video === null || video === void 0 ? void 0 : video['encodedVideo'])
-                                : undefined,
-                            mimeType: generatedVideo['encoding'],
-                        },
-                    };
-                });
-                operationResponse.raiMediaFilteredCount = generatedVideoResponse === null || generatedVideoResponse === void 0 ? void 0 : generatedVideoResponse['raiMediaFilteredCount'];
-                operationResponse.raiMediaFilteredReasons = generatedVideoResponse === null || generatedVideoResponse === void 0 ? void 0 : generatedVideoResponse['raiMediaFilteredReasons'];
-                operation.response = operationResponse;
-            }
-        }
-        return operation;
-    }
-}
 /** Client generated response to a `ToolCall` received from the server.
 
   Individual `FunctionResponse` objects are matched to the respective
@@ -2492,6 +2511,9 @@ function mcpToGeminiTool(mcpTool, config = {}) {
         description: mcpToolSchema['description'],
         parametersJsonSchema: mcpToolSchema['inputSchema'],
     };
+    if (mcpToolSchema['outputSchema']) {
+        functionDeclaration['responseJsonSchema'] = mcpToolSchema['outputSchema'];
+    }
     if (config.behavior) {
         functionDeclaration['behavior'] = config.behavior;
     }
@@ -5739,8 +5761,14 @@ function cachedContentFromMldev(fromObject) {
     }
     return toObject;
 }
-function deleteCachedContentResponseFromMldev() {
+function deleteCachedContentResponseFromMldev(fromObject) {
     const toObject = {};
+    const fromSdkHttpResponse = getValueByPath(fromObject, [
+        'sdkHttpResponse',
+    ]);
+    if (fromSdkHttpResponse != null) {
+        setValueByPath(toObject, ['sdkHttpResponse'], fromSdkHttpResponse);
+    }
     return toObject;
 }
 function listCachedContentsResponseFromMldev(fromObject) {
@@ -5805,8 +5833,14 @@ function cachedContentFromVertex(fromObject) {
     }
     return toObject;
 }
-function deleteCachedContentResponseFromVertex() {
+function deleteCachedContentResponseFromVertex(fromObject) {
     const toObject = {};
+    const fromSdkHttpResponse = getValueByPath(fromObject, [
+        'sdkHttpResponse',
+    ]);
+    if (fromSdkHttpResponse != null) {
+        setValueByPath(toObject, ['sdkHttpResponse'], fromSdkHttpResponse);
+    }
     return toObject;
 }
 function listCachedContentsResponseFromVertex(fromObject) {
@@ -6043,10 +6077,16 @@ class Caches extends BaseModule {
                 abortSignal: (_b = params.config) === null || _b === void 0 ? void 0 : _b.abortSignal,
             })
                 .then((httpResponse) => {
-                return httpResponse.json();
+                return httpResponse.json().then((jsonResponse) => {
+                    const response = jsonResponse;
+                    response.sdkHttpResponse = {
+                        headers: httpResponse.headers,
+                    };
+                    return response;
+                });
             });
-            return response.then(() => {
-                const resp = deleteCachedContentResponseFromVertex();
+            return response.then((apiResponse) => {
+                const resp = deleteCachedContentResponseFromVertex(apiResponse);
                 const typedResp = new DeleteCachedContentResponse();
                 Object.assign(typedResp, resp);
                 return typedResp;
@@ -6069,10 +6109,16 @@ class Caches extends BaseModule {
                 abortSignal: (_d = params.config) === null || _d === void 0 ? void 0 : _d.abortSignal,
             })
                 .then((httpResponse) => {
-                return httpResponse.json();
+                return httpResponse.json().then((jsonResponse) => {
+                    const response = jsonResponse;
+                    response.sdkHttpResponse = {
+                        headers: httpResponse.headers,
+                    };
+                    return response;
+                });
             });
-            return response.then(() => {
-                const resp = deleteCachedContentResponseFromMldev();
+            return response.then((apiResponse) => {
+                const resp = deleteCachedContentResponseFromMldev(apiResponse);
                 const typedResp = new DeleteCachedContentResponse();
                 Object.assign(typedResp, resp);
                 return typedResp;
@@ -6876,8 +6922,14 @@ function createFileResponseFromMldev(fromObject) {
     }
     return toObject;
 }
-function deleteFileResponseFromMldev() {
+function deleteFileResponseFromMldev(fromObject) {
     const toObject = {};
+    const fromSdkHttpResponse = getValueByPath(fromObject, [
+        'sdkHttpResponse',
+    ]);
+    if (fromSdkHttpResponse != null) {
+        setValueByPath(toObject, ['sdkHttpResponse'], fromSdkHttpResponse);
+    }
     return toObject;
 }
 
@@ -7146,10 +7198,16 @@ class Files extends BaseModule {
                 abortSignal: (_b = params.config) === null || _b === void 0 ? void 0 : _b.abortSignal,
             })
                 .then((httpResponse) => {
-                return httpResponse.json();
+                return httpResponse.json().then((jsonResponse) => {
+                    const response = jsonResponse;
+                    response.sdkHttpResponse = {
+                        headers: httpResponse.headers,
+                    };
+                    return response;
+                });
             });
-            return response.then(() => {
-                const resp = deleteFileResponseFromMldev();
+            return response.then((apiResponse) => {
+                const resp = deleteFileResponseFromMldev(apiResponse);
                 const typedResp = new DeleteFileResponse();
                 Object.assign(typedResp, resp);
                 return typedResp;
@@ -10452,6 +10510,21 @@ function imageToMldev(fromObject) {
     }
     return toObject;
 }
+function generateVideosSourceToMldev(fromObject, parentObject) {
+    const toObject = {};
+    const fromPrompt = getValueByPath(fromObject, ['prompt']);
+    if (parentObject !== undefined && fromPrompt != null) {
+        setValueByPath(parentObject, ['instances[0]', 'prompt'], fromPrompt);
+    }
+    const fromImage = getValueByPath(fromObject, ['image']);
+    if (parentObject !== undefined && fromImage != null) {
+        setValueByPath(parentObject, ['instances[0]', 'image'], imageToMldev(fromImage));
+    }
+    if (getValueByPath(fromObject, ['video']) !== undefined) {
+        throw new Error('video parameter is not supported in Gemini API.');
+    }
+    return toObject;
+}
 function generateVideosConfigToMldev(fromObject, parentObject) {
     const toObject = {};
     const fromNumberOfVideos = getValueByPath(fromObject, [
@@ -10479,8 +10552,9 @@ function generateVideosConfigToMldev(fromObject, parentObject) {
     if (parentObject !== undefined && fromAspectRatio != null) {
         setValueByPath(parentObject, ['parameters', 'aspectRatio'], fromAspectRatio);
     }
-    if (getValueByPath(fromObject, ['resolution']) !== undefined) {
-        throw new Error('resolution parameter is not supported in Gemini API.');
+    const fromResolution = getValueByPath(fromObject, ['resolution']);
+    if (parentObject !== undefined && fromResolution != null) {
+        setValueByPath(parentObject, ['parameters', 'resolution'], fromResolution);
     }
     const fromPersonGeneration = getValueByPath(fromObject, [
         'personGeneration',
@@ -10534,6 +10608,10 @@ function generateVideosParametersToMldev(apiClient, fromObject) {
     if (getValueByPath(fromObject, ['video']) !== undefined) {
         throw new Error('video parameter is not supported in Gemini API.');
     }
+    const fromSource = getValueByPath(fromObject, ['source']);
+    if (fromSource != null) {
+        setValueByPath(toObject, ['config'], generateVideosSourceToMldev(fromSource, toObject));
+    }
     const fromConfig = getValueByPath(fromObject, ['config']);
     if (fromConfig != null) {
         setValueByPath(toObject, ['config'], generateVideosConfigToMldev(fromConfig, toObject));
@@ -11658,6 +11736,10 @@ function editImageParametersInternalToVertex(apiClient, fromObject) {
 }
 function upscaleImageAPIConfigInternalToVertex(fromObject, parentObject) {
     const toObject = {};
+    const fromOutputGcsUri = getValueByPath(fromObject, ['outputGcsUri']);
+    if (parentObject !== undefined && fromOutputGcsUri != null) {
+        setValueByPath(parentObject, ['parameters', 'storageUri'], fromOutputGcsUri);
+    }
     const fromIncludeRaiReason = getValueByPath(fromObject, [
         'includeRaiReason',
     ]);
@@ -11786,6 +11868,10 @@ function recontextImageConfigToVertex(fromObject, parentObject) {
     if (parentObject !== undefined && fromPersonGeneration != null) {
         setValueByPath(parentObject, ['parameters', 'personGeneration'], fromPersonGeneration);
     }
+    const fromAddWatermark = getValueByPath(fromObject, ['addWatermark']);
+    if (parentObject !== undefined && fromAddWatermark != null) {
+        setValueByPath(parentObject, ['parameters', 'addWatermark'], fromAddWatermark);
+    }
     const fromOutputMimeType = getValueByPath(fromObject, [
         'outputMimeType',
     ]);
@@ -12062,6 +12148,22 @@ function videoToVertex(fromObject) {
     }
     return toObject;
 }
+function generateVideosSourceToVertex(fromObject, parentObject) {
+    const toObject = {};
+    const fromPrompt = getValueByPath(fromObject, ['prompt']);
+    if (parentObject !== undefined && fromPrompt != null) {
+        setValueByPath(parentObject, ['instances[0]', 'prompt'], fromPrompt);
+    }
+    const fromImage = getValueByPath(fromObject, ['image']);
+    if (parentObject !== undefined && fromImage != null) {
+        setValueByPath(parentObject, ['instances[0]', 'image'], imageToVertex(fromImage));
+    }
+    const fromVideo = getValueByPath(fromObject, ['video']);
+    if (parentObject !== undefined && fromVideo != null) {
+        setValueByPath(parentObject, ['instances[0]', 'video'], videoToVertex(fromVideo));
+    }
+    return toObject;
+}
 function videoGenerationReferenceImageToVertex(fromObject) {
     const toObject = {};
     const fromImage = getValueByPath(fromObject, ['image']);
@@ -12180,6 +12282,10 @@ function generateVideosParametersToVertex(apiClient, fromObject) {
     if (fromVideo != null) {
         setValueByPath(toObject, ['instances[0]', 'video'], videoToVertex(fromVideo));
     }
+    const fromSource = getValueByPath(fromObject, ['source']);
+    if (fromSource != null) {
+        setValueByPath(toObject, ['config'], generateVideosSourceToVertex(fromSource, toObject));
+    }
     const fromConfig = getValueByPath(fromObject, ['config']);
     if (fromConfig != null) {
         setValueByPath(toObject, ['config'], generateVideosConfigToVertex(fromConfig, toObject));
@@ -12630,8 +12736,14 @@ function listModelsResponseFromMldev(fromObject) {
     }
     return toObject;
 }
-function deleteModelResponseFromMldev() {
+function deleteModelResponseFromMldev(fromObject) {
     const toObject = {};
+    const fromSdkHttpResponse = getValueByPath(fromObject, [
+        'sdkHttpResponse',
+    ]);
+    if (fromSdkHttpResponse != null) {
+        setValueByPath(toObject, ['sdkHttpResponse'], fromSdkHttpResponse);
+    }
     return toObject;
 }
 function countTokensResponseFromMldev(fromObject) {
@@ -13376,8 +13488,14 @@ function listModelsResponseFromVertex(fromObject) {
     }
     return toObject;
 }
-function deleteModelResponseFromVertex() {
+function deleteModelResponseFromVertex(fromObject) {
     const toObject = {};
+    const fromSdkHttpResponse = getValueByPath(fromObject, [
+        'sdkHttpResponse',
+    ]);
+    if (fromSdkHttpResponse != null) {
+        setValueByPath(toObject, ['sdkHttpResponse'], fromSdkHttpResponse);
+    }
     return toObject;
 }
 function countTokensResponseFromVertex(fromObject) {
@@ -13494,7 +13612,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.15.0'; // x-release-please-version
+const SDK_VERSION = '1.17.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';
@@ -15266,7 +15384,9 @@ class Models extends BaseModule {
          * ```ts
          * const operation = await ai.models.generateVideos({
          *  model: 'veo-2.0-generate-001',
-         *  prompt: 'A neon hologram of a cat driving at top speed',
+         *  source: {
+         *    prompt: 'A neon hologram of a cat driving at top speed',
+         *  },
          *  config: {
          *    numberOfVideos: 1
          * });
@@ -15280,6 +15400,9 @@ class Models extends BaseModule {
          * ```
          */
         this.generateVideos = async (params) => {
+            if ((params.prompt || params.image || params.video) && params.source) {
+                throw new Error('Source and prompt/image/video are mutually exclusive. Please only use source.');
+            }
             return await this.generateVideosInternal(params);
         };
     }
@@ -15694,23 +15817,7 @@ class Models extends BaseModule {
         }
     }
     /**
-     * Generates an image based on a text description and configuration.
-     *
-     * @param params - The parameters for generating images.
-     * @return The response from the API.
-     *
-     * @example
-     * ```ts
-     * const response = await ai.models.generateImages({
-     *  model: 'imagen-3.0-generate-002',
-     *  prompt: 'Robot holding a red skateboard',
-     *  config: {
-     *    numberOfImages: 1,
-     *    includeRaiReason: true,
-     *  },
-     * });
-     * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
-     * ```
+     * Private method for generating images.
      */
     async generateImagesInternal(params) {
         var _a, _b, _c, _d;
@@ -15782,6 +15889,9 @@ class Models extends BaseModule {
             });
         }
     }
+    /**
+     * Private method for editing an image.
+     */
     async editImageInternal(params) {
         var _a, _b;
         let response;
@@ -15823,6 +15933,9 @@ class Models extends BaseModule {
             throw new Error('This method is only supported by the Vertex AI.');
         }
     }
+    /**
+     * Private method for upscaling an image.
+     */
     async upscaleImageInternal(params) {
         var _a, _b;
         let response;
@@ -16228,10 +16341,16 @@ class Models extends BaseModule {
                 abortSignal: (_b = params.config) === null || _b === void 0 ? void 0 : _b.abortSignal,
             })
                 .then((httpResponse) => {
-                return httpResponse.json();
+                return httpResponse.json().then((jsonResponse) => {
+                    const response = jsonResponse;
+                    response.sdkHttpResponse = {
+                        headers: httpResponse.headers,
+                    };
+                    return response;
+                });
             });
-            return response.then(() => {
-                const resp = deleteModelResponseFromVertex();
+            return response.then((apiResponse) => {
+                const resp = deleteModelResponseFromVertex(apiResponse);
                 const typedResp = new DeleteModelResponse();
                 Object.assign(typedResp, resp);
                 return typedResp;
@@ -16254,10 +16373,16 @@ class Models extends BaseModule {
                 abortSignal: (_d = params.config) === null || _d === void 0 ? void 0 : _d.abortSignal,
             })
                 .then((httpResponse) => {
-                return httpResponse.json();
+                return httpResponse.json().then((jsonResponse) => {
+                    const response = jsonResponse;
+                    response.sdkHttpResponse = {
+                        headers: httpResponse.headers,
+                    };
+                    return response;
+                });
             });
-            return response.then(() => {
-                const resp = deleteModelResponseFromMldev();
+            return response.then((apiResponse) => {
+                const resp = deleteModelResponseFromMldev(apiResponse);
                 const typedResp = new DeleteModelResponse();
                 Object.assign(typedResp, resp);
                 return typedResp;
@@ -16410,27 +16535,7 @@ class Models extends BaseModule {
         }
     }
     /**
-     *  Generates videos based on a text description and configuration.
-     *
-     * @param params - The parameters for generating videos.
-     * @return A Promise<GenerateVideosOperation> which allows you to track the progress and eventually retrieve the generated videos using the operations.get method.
-     *
-     * @example
-     * ```ts
-     * const operation = await ai.models.generateVideos({
-     *  model: 'veo-2.0-generate-001',
-     *  prompt: 'A neon hologram of a cat driving at top speed',
-     *  config: {
-     *    numberOfVideos: 1
-     * });
-     *
-     * while (!operation.done) {
-     *   await new Promise(resolve => setTimeout(resolve, 10000));
-     *   operation = await ai.operations.getVideosOperation({operation: operation});
-     * }
-     *
-     * console.log(operation.response?.generatedVideos?.[0]?.video?.uri);
-     * ```
+     * Private method for generating videos.
      */
     async generateVideosInternal(params) {
         var _a, _b, _c, _d;
@@ -16512,13 +16617,17 @@ function getOperationParametersToMldev(fromObject) {
     }
     return toObject;
 }
-function getOperationParametersToVertex(fromObject) {
+function fetchPredictOperationParametersToVertex(fromObject) {
     const toObject = {};
     const fromOperationName = getValueByPath(fromObject, [
         'operationName',
     ]);
     if (fromOperationName != null) {
-        setValueByPath(toObject, ['_url', 'operationName'], fromOperationName);
+        setValueByPath(toObject, ['operationName'], fromOperationName);
+    }
+    const fromResourceName = getValueByPath(fromObject, ['resourceName']);
+    if (fromResourceName != null) {
+        setValueByPath(toObject, ['_url', 'resourceName'], fromResourceName);
     }
     const fromConfig = getValueByPath(fromObject, ['config']);
     if (fromConfig != null) {
@@ -16526,17 +16635,13 @@ function getOperationParametersToVertex(fromObject) {
     }
     return toObject;
 }
-function fetchPredictOperationParametersToVertex(fromObject) {
+function getOperationParametersToVertex(fromObject) {
     const toObject = {};
     const fromOperationName = getValueByPath(fromObject, [
         'operationName',
     ]);
     if (fromOperationName != null) {
-        setValueByPath(toObject, ['operationName'], fromOperationName);
-    }
-    const fromResourceName = getValueByPath(fromObject, ['resourceName']);
-    if (fromResourceName != null) {
-        setValueByPath(toObject, ['_url', 'resourceName'], fromResourceName);
+        setValueByPath(toObject, ['_url', 'operationName'], fromOperationName);
     }
     const fromConfig = getValueByPath(fromObject, ['config']);
     if (fromConfig != null) {
@@ -17797,6 +17902,18 @@ function listTuningJobsParametersToMldev(fromObject) {
     }
     return toObject;
 }
+function cancelTuningJobParametersToMldev(fromObject) {
+    const toObject = {};
+    const fromName = getValueByPath(fromObject, ['name']);
+    if (fromName != null) {
+        setValueByPath(toObject, ['_url', 'name'], fromName);
+    }
+    const fromConfig = getValueByPath(fromObject, ['config']);
+    if (fromConfig != null) {
+        setValueByPath(toObject, ['config'], fromConfig);
+    }
+    return toObject;
+}
 function tuningExampleToMldev(fromObject) {
     const toObject = {};
     const fromTextInput = getValueByPath(fromObject, ['textInput']);
@@ -17934,6 +18051,18 @@ function listTuningJobsParametersToVertex(fromObject) {
     }
     return toObject;
 }
+function cancelTuningJobParametersToVertex(fromObject) {
+    const toObject = {};
+    const fromName = getValueByPath(fromObject, ['name']);
+    if (fromName != null) {
+        setValueByPath(toObject, ['_url', 'name'], fromName);
+    }
+    const fromConfig = getValueByPath(fromObject, ['config']);
+    if (fromConfig != null) {
+        setValueByPath(toObject, ['config'], fromConfig);
+    }
+    return toObject;
+}
 function tuningDatasetToVertex(fromObject, parentObject) {
     const toObject = {};
     const fromGcsUri = getValueByPath(fromObject, ['gcsUri']);
@@ -18587,6 +18716,54 @@ class Tunings extends BaseModule {
             });
         }
     }
+    /**
+     * Cancels a tuning job.
+     *
+     * @param params - The parameters for the cancel request.
+     * @return The empty response returned by the API.
+     *
+     * @example
+     * ```ts
+     * await ai.tunings.cancel({name: '...'}); // The server-generated resource name.
+     * ```
+     */
+    async cancel(params) {
+        var _a, _b, _c, _d;
+        let path = '';
+        let queryParams = {};
+        if (this.apiClient.isVertexAI()) {
+            const body = cancelTuningJobParametersToVertex(params);
+            path = formatMap('{name}:cancel', body['_url']);
+            queryParams = body['_query'];
+            delete body['config'];
+            delete body['_url'];
+            delete body['_query'];
+            await this.apiClient.request({
+                path: path,
+                queryParams: queryParams,
+                body: JSON.stringify(body),
+                httpMethod: 'POST',
+                httpOptions: (_a = params.config) === null || _a === void 0 ? void 0 : _a.httpOptions,
+                abortSignal: (_b = params.config) === null || _b === void 0 ? void 0 : _b.abortSignal,
+            });
+        }
+        else {
+            const body = cancelTuningJobParametersToMldev(params);
+            path = formatMap('{name}:cancel', body['_url']);
+            queryParams = body['_query'];
+            delete body['config'];
+            delete body['_url'];
+            delete body['_query'];
+            await this.apiClient.request({
+                path: path,
+                queryParams: queryParams,
+                body: JSON.stringify(body),
+                httpMethod: 'POST',
+                httpOptions: (_c = params.config) === null || _c === void 0 ? void 0 : _c.httpOptions,
+                abortSignal: (_d = params.config) === null || _d === void 0 ? void 0 : _d.abortSignal,
+            });
+        }
+    }
     async tuneInternal(params) {
         var _a, _b;
         let response;
@@ -19070,7 +19247,7 @@ function getApiKeyFromEnv() {
     if (envGoogleApiKey && envGeminiApiKey) {
         console.warn('Both GOOGLE_API_KEY and GEMINI_API_KEY are set. Using GOOGLE_API_KEY.');
     }
-    return envGoogleApiKey || envGeminiApiKey;
+    return envGoogleApiKey || envGeminiApiKey || undefined;
 }
 
 exports.ApiError = ApiError;