@google/genai 1.23.0 → 1.25.0

package/dist/genai.d.ts

@@ -467,7 +467,6 @@ export declare class Batches extends BaseModule {
      */
     list: (params?: types.ListBatchJobsParameters) => Promise<Pager<types.BatchJob>>;
     private createInlinedGenerateContentRequest;
-    private createInlinedEmbedContentRequest;
     private getGcsUri;
     private getBigqueryUri;
     private formatDestination;
@@ -3423,6 +3422,8 @@ export declare interface GoogleGenAIOptions {
 export declare interface GoogleMaps {
     /** Optional. Auth config for the Google Maps tool. */
     authConfig?: AuthConfig;
+    /** Optional. If true, include the widget context token in the response. */
+    enableWidget?: boolean;
 }
 
 /** 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). */
@@ -3516,6 +3517,10 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
     relativePublishTimeDescription?: string;
     /** A reference representing this place review which may be used to look up this place review again. */
     review?: string;
+    /** Id of the review referencing the place. */
+    reviewId?: string;
+    /** Title of the review. */
+    title?: string;
 }
 
 /** Chunk from context retrieved by the retrieval tools. */
@@ -3556,10 +3561,20 @@ export declare interface GroundingMetadata {
     retrievalQueries?: string[];
     /** Optional. Google search entry for the following-up web searches. */
     searchEntryPoint?: SearchEntryPoint;
+    /** Optional. Output only. List of source flagging uris. This is currently populated only for Google Maps grounding. */
+    sourceFlaggingUris?: GroundingMetadataSourceFlaggingUri[];
     /** Optional. Web search queries for the following-up web search. */
     webSearchQueries?: string[];
 }
 
+/** Source content flagging uri for a place or review. This is currently populated only for Google Maps grounding. */
+export declare interface GroundingMetadataSourceFlaggingUri {
+    /** A link where users can flag a problem with the source (place or review). */
+    flagContentUri?: string;
+    /** Id of the place or review. */
+    sourceId?: string;
+}
+
 /** Grounding support. */
 export declare interface GroundingSupport {
     /** Confidence score of the support references. Ranges from 0 to 1. 1 is the most confident. For Gemini 2.0 and before, this list must have the same size as the grounding_chunk_indices. For Gemini 2.5 and after, this list will be empty and should be ignored. */
@@ -3859,6 +3874,8 @@ export declare interface InlinedRequest {
     /** Content of the request.
      */
     contents?: ContentListUnion;
+    /** The metadata to be associated with the request. */
+    metadata?: Record<string, string>;
     /** Configuration that contains optional model parameters.
      */
     config?: GenerateContentConfig;
@@ -7329,6 +7346,7 @@ declare namespace types {
         GroundingSupport,
         RetrievalMetadata,
         SearchEntryPoint,
+        GroundingMetadataSourceFlaggingUri,
         GroundingMetadata,
         LogprobsResultCandidate,
         LogprobsResultTopCandidates,

package/dist/index.cjs

@@ -165,6 +165,98 @@ function getValueByPath(data, keys, defaultValue = undefined) {
         throw error;
     }
 }
+/**
+ * Moves values from source paths to destination paths.
+ *
+ * Examples:
+ *   moveValueByPath(
+ *     {'requests': [{'content': v1}, {'content': v2}]},
+ *     {'requests[].*': 'requests[].request.*'}
+ *   )
+ *     -> {'requests': [{'request': {'content': v1}}, {'request': {'content': v2}}]}
+ */
+function moveValueByPath(data, paths) {
+    for (const [sourcePath, destPath] of Object.entries(paths)) {
+        const sourceKeys = sourcePath.split('.');
+        const destKeys = destPath.split('.');
+        // Determine keys to exclude from wildcard to avoid cyclic references
+        const excludeKeys = new Set();
+        let wildcardIdx = -1;
+        for (let i = 0; i < sourceKeys.length; i++) {
+            if (sourceKeys[i] === '*') {
+                wildcardIdx = i;
+                break;
+            }
+        }
+        if (wildcardIdx !== -1 && destKeys.length > wildcardIdx) {
+            // Extract the intermediate key between source and dest paths
+            // Example: source=['requests[]', '*'], dest=['requests[]', 'request', '*']
+            // We want to exclude 'request'
+            for (let i = wildcardIdx; i < destKeys.length; i++) {
+                const key = destKeys[i];
+                if (key !== '*' && !key.endsWith('[]') && !key.endsWith('[0]')) {
+                    excludeKeys.add(key);
+                }
+            }
+        }
+        _moveValueRecursive(data, sourceKeys, destKeys, 0, excludeKeys);
+    }
+}
+/**
+ * Recursively moves values from source path to destination path.
+ */
+function _moveValueRecursive(data, sourceKeys, destKeys, keyIdx, excludeKeys) {
+    if (keyIdx >= sourceKeys.length) {
+        return;
+    }
+    if (typeof data !== 'object' || data === null) {
+        return;
+    }
+    const key = sourceKeys[keyIdx];
+    if (key.endsWith('[]')) {
+        const keyName = key.slice(0, -2);
+        const dataRecord = data;
+        if (keyName in dataRecord && Array.isArray(dataRecord[keyName])) {
+            for (const item of dataRecord[keyName]) {
+                _moveValueRecursive(item, sourceKeys, destKeys, keyIdx + 1, excludeKeys);
+            }
+        }
+    }
+    else if (key === '*') {
+        // wildcard - move all fields
+        if (typeof data === 'object' && data !== null && !Array.isArray(data)) {
+            const dataRecord = data;
+            const keysToMove = Object.keys(dataRecord).filter((k) => !k.startsWith('_') && !excludeKeys.has(k));
+            const valuesToMove = {};
+            for (const k of keysToMove) {
+                valuesToMove[k] = dataRecord[k];
+            }
+            // Set values at destination
+            for (const [k, v] of Object.entries(valuesToMove)) {
+                const newDestKeys = [];
+                for (const dk of destKeys.slice(keyIdx)) {
+                    if (dk === '*') {
+                        newDestKeys.push(k);
+                    }
+                    else {
+                        newDestKeys.push(dk);
+                    }
+                }
+                setValueByPath(dataRecord, newDestKeys, v);
+            }
+            for (const k of keysToMove) {
+                delete dataRecord[k];
+            }
+        }
+    }
+    else {
+        // Navigate to next level
+        const dataRecord = data;
+        if (key in dataRecord) {
+            _moveValueRecursive(dataRecord[key], sourceKeys, destKeys, keyIdx + 1, excludeKeys);
+        }
+    }
+}
 
 /**
  * @license
@@ -306,7 +398,7 @@ function generateVideosResponseFromVertex$1(fromObject) {
 }
 function generatedVideoFromMldev$1(fromObject) {
     const toObject = {};
-    const fromVideo = getValueByPath(fromObject, ['_self']);
+    const fromVideo = getValueByPath(fromObject, ['video']);
     if (fromVideo != null) {
         setValueByPath(toObject, ['video'], videoFromMldev$1(fromVideo));
     }
@@ -342,14 +434,11 @@ function getOperationParametersToVertex(fromObject) {
 }
 function videoFromMldev$1(fromObject) {
     const toObject = {};
-    const fromUri = getValueByPath(fromObject, ['video', 'uri']);
+    const fromUri = getValueByPath(fromObject, ['uri']);
     if (fromUri != null) {
         setValueByPath(toObject, ['uri'], fromUri);
     }
-    const fromVideoBytes = getValueByPath(fromObject, [
-        'video',
-        'encodedVideo',
-    ]);
+    const fromVideoBytes = getValueByPath(fromObject, ['encodedVideo']);
     if (fromVideoBytes != null) {
         setValueByPath(toObject, ['videoBytes'], tBytes$1(fromVideoBytes));
     }
@@ -3482,6 +3571,7 @@ function embedContentBatchToMldev(apiClient, fromObject) {
     const fromConfig = getValueByPath(fromObject, ['config']);
     if (fromConfig != null) {
         setValueByPath(toObject, ['_self'], embedContentConfigToMldev$1(fromConfig, toObject));
+        moveValueByPath(toObject, { 'requests[].*': 'requests[].request.*' });
     }
     return toObject;
 }
@@ -3748,6 +3838,17 @@ function getBatchJobParametersToVertex(apiClient, fromObject) {
     }
     return toObject;
 }
+function googleMapsToMldev$4(fromObject) {
+    const toObject = {};
+    if (getValueByPath(fromObject, ['authConfig']) !== undefined) {
+        throw new Error('authConfig parameter is not supported in Gemini API.');
+    }
+    const fromEnableWidget = getValueByPath(fromObject, ['enableWidget']);
+    if (fromEnableWidget != null) {
+        setValueByPath(toObject, ['enableWidget'], fromEnableWidget);
+    }
+    return toObject;
+}
 function googleSearchToMldev$4(fromObject) {
     const toObject = {};
     const fromTimeRangeFilter = getValueByPath(fromObject, [
@@ -3777,6 +3878,10 @@ function inlinedRequestToMldev(apiClient, fromObject) {
         }
         setValueByPath(toObject, ['request', 'contents'], transformedList);
     }
+    const fromMetadata = getValueByPath(fromObject, ['metadata']);
+    if (fromMetadata != null) {
+        setValueByPath(toObject, ['metadata'], fromMetadata);
+    }
     const fromConfig = getValueByPath(fromObject, ['config']);
     if (fromConfig != null) {
         setValueByPath(toObject, ['request', 'generationConfig'], generateContentConfigToMldev$1(apiClient, fromConfig, getValueByPath(toObject, ['request'], {})));
@@ -3995,8 +4100,9 @@ function toolToMldev$4(fromObject) {
     if (getValueByPath(fromObject, ['enterpriseWebSearch']) !== undefined) {
         throw new Error('enterpriseWebSearch parameter is not supported in Gemini API.');
     }
-    if (getValueByPath(fromObject, ['googleMaps']) !== undefined) {
-        throw new Error('googleMaps parameter is not supported in Gemini API.');
+    const fromGoogleMaps = getValueByPath(fromObject, ['googleMaps']);
+    if (fromGoogleMaps != null) {
+        setValueByPath(toObject, ['googleMaps'], googleMapsToMldev$4(fromGoogleMaps));
     }
     const fromUrlContext = getValueByPath(fromObject, ['urlContext']);
     if (fromUrlContext != null) {
@@ -4247,38 +4353,11 @@ class Batches extends BaseModule {
          * ```
          */
         this.createEmbeddings = async (params) => {
-            var _a, _b;
             console.warn('batches.createEmbeddings() is experimental and may change without notice.');
             if (this.apiClient.isVertexAI()) {
                 throw new Error('Vertex AI does not support batches.createEmbeddings.');
             }
-            // MLDEV
-            const src = params.src;
-            const is_inlined = src.inlinedRequests !== undefined;
-            if (!is_inlined) {
-                return this.createEmbeddingsInternal(params); // Fixed typo here
-            }
-            // Inlined embed content requests handling
-            const result = this.createInlinedEmbedContentRequest(params);
-            const path = result.path;
-            const requestBody = result.body;
-            const queryParams = createEmbeddingsBatchJobParametersToMldev(this.apiClient, params)['_query'] || {};
-            const response = this.apiClient
-                .request({
-                path: path,
-                queryParams: queryParams,
-                body: JSON.stringify(requestBody),
-                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,
-            })
-                .then((httpResponse) => {
-                return httpResponse.json();
-            });
-            return response.then((apiResponse) => {
-                const resp = batchJobFromMldev(apiResponse);
-                return resp;
-            });
+            return this.createEmbeddingsInternal(params);
         };
         /**
          * Lists batch job configurations.
@@ -4326,35 +4405,6 @@ class Batches extends BaseModule {
         delete body['_query'];
         return { path, body };
     }
-    // Helper function to handle inlined embedding requests
-    createInlinedEmbedContentRequest(params) {
-        const body = createEmbeddingsBatchJobParametersToMldev(this.apiClient, // Use instance apiClient
-        params);
-        const urlParams = body['_url'];
-        const path = formatMap('{model}:asyncBatchEmbedContent', urlParams);
-        const batch = body['batch'];
-        const inputConfig = batch['inputConfig'];
-        const requestsWrapper = inputConfig['requests'];
-        const requests = requestsWrapper['requests'];
-        const newRequests = [];
-        delete requestsWrapper['config']; // Remove top-level config
-        for (const request of requests) {
-            const requestDict = Object.assign({}, request); // Clone
-            const innerRequest = requestDict['request'];
-            for (const key in requestDict) {
-                if (key !== 'request') {
-                    innerRequest[key] = requestDict[key];
-                    delete requestDict[key];
-                }
-            }
-            newRequests.push(requestDict);
-        }
-        requestsWrapper['requests'] = newRequests;
-        delete body['config'];
-        delete body['_url'];
-        delete body['_query'];
-        return { path, body };
-    }
     // Helper function to get the first GCS URI
     getGcsUri(src) {
         if (typeof src === 'string') {
@@ -5019,6 +5069,17 @@ function getCachedContentParametersToVertex(apiClient, fromObject) {
     }
     return toObject;
 }
+function googleMapsToMldev$3(fromObject) {
+    const toObject = {};
+    if (getValueByPath(fromObject, ['authConfig']) !== undefined) {
+        throw new Error('authConfig parameter is not supported in Gemini API.');
+    }
+    const fromEnableWidget = getValueByPath(fromObject, ['enableWidget']);
+    if (fromEnableWidget != null) {
+        setValueByPath(toObject, ['enableWidget'], fromEnableWidget);
+    }
+    return toObject;
+}
 function googleSearchToMldev$3(fromObject) {
     const toObject = {};
     const fromTimeRangeFilter = getValueByPath(fromObject, [
@@ -5212,8 +5273,9 @@ function toolToMldev$3(fromObject) {
     if (getValueByPath(fromObject, ['enterpriseWebSearch']) !== undefined) {
         throw new Error('enterpriseWebSearch parameter is not supported in Gemini API.');
     }
-    if (getValueByPath(fromObject, ['googleMaps']) !== undefined) {
-        throw new Error('googleMaps parameter is not supported in Gemini API.');
+    const fromGoogleMaps = getValueByPath(fromObject, ['googleMaps']);
+    if (fromGoogleMaps != null) {
+        setValueByPath(toObject, ['googleMaps'], googleMapsToMldev$3(fromGoogleMaps));
     }
     const fromUrlContext = getValueByPath(fromObject, ['urlContext']);
     if (fromUrlContext != null) {
@@ -6119,7 +6181,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.23.0'; // x-release-please-version
+const SDK_VERSION = '1.25.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';
@@ -7393,6 +7455,17 @@ function generationConfigToVertex$1(fromObject) {
     }
     return toObject;
 }
+function googleMapsToMldev$2(fromObject) {
+    const toObject = {};
+    if (getValueByPath(fromObject, ['authConfig']) !== undefined) {
+        throw new Error('authConfig parameter is not supported in Gemini API.');
+    }
+    const fromEnableWidget = getValueByPath(fromObject, ['enableWidget']);
+    if (fromEnableWidget != null) {
+        setValueByPath(toObject, ['enableWidget'], fromEnableWidget);
+    }
+    return toObject;
+}
 function googleSearchToMldev$2(fromObject) {
     const toObject = {};
     const fromTimeRangeFilter = getValueByPath(fromObject, [
@@ -7912,8 +7985,9 @@ function toolToMldev$2(fromObject) {
     if (getValueByPath(fromObject, ['enterpriseWebSearch']) !== undefined) {
         throw new Error('enterpriseWebSearch parameter is not supported in Gemini API.');
     }
-    if (getValueByPath(fromObject, ['googleMaps']) !== undefined) {
-        throw new Error('googleMaps parameter is not supported in Gemini API.');
+    const fromGoogleMaps = getValueByPath(fromObject, ['googleMaps']);
+    if (fromGoogleMaps != null) {
+        setValueByPath(toObject, ['googleMaps'], googleMapsToMldev$2(fromGoogleMaps));
     }
     const fromUrlContext = getValueByPath(fromObject, ['urlContext']);
     if (fromUrlContext != null) {
@@ -9902,7 +9976,7 @@ function generatedImageMaskFromVertex(fromObject) {
 }
 function generatedVideoFromMldev(fromObject) {
     const toObject = {};
-    const fromVideo = getValueByPath(fromObject, ['_self']);
+    const fromVideo = getValueByPath(fromObject, ['video']);
     if (fromVideo != null) {
         setValueByPath(toObject, ['video'], videoFromMldev(fromVideo));
     }
@@ -10056,6 +10130,17 @@ function getModelParametersToVertex(apiClient, fromObject) {
     }
     return toObject;
 }
+function googleMapsToMldev$1(fromObject) {
+    const toObject = {};
+    if (getValueByPath(fromObject, ['authConfig']) !== undefined) {
+        throw new Error('authConfig parameter is not supported in Gemini API.');
+    }
+    const fromEnableWidget = getValueByPath(fromObject, ['enableWidget']);
+    if (fromEnableWidget != null) {
+        setValueByPath(toObject, ['enableWidget'], fromEnableWidget);
+    }
+    return toObject;
+}
 function googleSearchToMldev$1(fromObject) {
     const toObject = {};
     const fromTimeRangeFilter = getValueByPath(fromObject, [
@@ -10770,8 +10855,9 @@ function toolToMldev$1(fromObject) {
     if (getValueByPath(fromObject, ['enterpriseWebSearch']) !== undefined) {
         throw new Error('enterpriseWebSearch parameter is not supported in Gemini API.');
     }
-    if (getValueByPath(fromObject, ['googleMaps']) !== undefined) {
-        throw new Error('googleMaps parameter is not supported in Gemini API.');
+    const fromGoogleMaps = getValueByPath(fromObject, ['googleMaps']);
+    if (fromGoogleMaps != null) {
+        setValueByPath(toObject, ['googleMaps'], googleMapsToMldev$1(fromGoogleMaps));
     }
     const fromUrlContext = getValueByPath(fromObject, ['urlContext']);
     if (fromUrlContext != null) {
@@ -11036,14 +11122,11 @@ function upscaleImageResponseFromVertex(fromObject) {
 }
 function videoFromMldev(fromObject) {
     const toObject = {};
-    const fromUri = getValueByPath(fromObject, ['video', 'uri']);
+    const fromUri = getValueByPath(fromObject, ['uri']);
     if (fromUri != null) {
         setValueByPath(toObject, ['uri'], fromUri);
     }
-    const fromVideoBytes = getValueByPath(fromObject, [
-        'video',
-        'encodedVideo',
-    ]);
+    const fromVideoBytes = getValueByPath(fromObject, ['encodedVideo']);
     if (fromVideoBytes != null) {
         setValueByPath(toObject, ['videoBytes'], tBytes(fromVideoBytes));
     }
@@ -11115,11 +11198,11 @@ function videoToMldev(fromObject) {
     const toObject = {};
     const fromUri = getValueByPath(fromObject, ['uri']);
     if (fromUri != null) {
-        setValueByPath(toObject, ['video', 'uri'], fromUri);
+        setValueByPath(toObject, ['uri'], fromUri);
     }
     const fromVideoBytes = getValueByPath(fromObject, ['videoBytes']);
     if (fromVideoBytes != null) {
-        setValueByPath(toObject, ['video', 'encodedVideo'], tBytes(fromVideoBytes));
+        setValueByPath(toObject, ['encodedVideo'], tBytes(fromVideoBytes));
     }
     const fromMimeType = getValueByPath(fromObject, ['mimeType']);
     if (fromMimeType != null) {
@@ -12357,9 +12440,26 @@ class Models extends BaseModule {
          * ```
          */
         this.generateVideos = async (params) => {
+            var _a, _b, _c, _d, _e, _f;
             if ((params.prompt || params.image || params.video) && params.source) {
                 throw new Error('Source and prompt/image/video are mutually exclusive. Please only use source.');
             }
+            // Gemini API does not support video bytes.
+            if (!this.apiClient.isVertexAI()) {
+                if (((_a = params.video) === null || _a === void 0 ? void 0 : _a.uri) && ((_b = params.video) === null || _b === void 0 ? void 0 : _b.videoBytes)) {
+                    params.video = {
+                        uri: params.video.uri,
+                        mimeType: params.video.mimeType,
+                    };
+                }
+                else if (((_d = (_c = params.source) === null || _c === void 0 ? void 0 : _c.video) === null || _d === void 0 ? void 0 : _d.uri) &&
+                    ((_f = (_e = params.source) === null || _e === void 0 ? void 0 : _e.video) === null || _f === void 0 ? void 0 : _f.videoBytes)) {
+                    params.source.video = {
+                        uri: params.source.video.uri,
+                        mimeType: params.source.video.mimeType,
+                    };
+                }
+            }
             return await this.generateVideosInternal(params);
         };
     }
@@ -13785,6 +13885,17 @@ function fileDataToMldev(fromObject) {
     }
     return toObject;
 }
+function googleMapsToMldev(fromObject) {
+    const toObject = {};
+    if (getValueByPath(fromObject, ['authConfig']) !== undefined) {
+        throw new Error('authConfig parameter is not supported in Gemini API.');
+    }
+    const fromEnableWidget = getValueByPath(fromObject, ['enableWidget']);
+    if (fromEnableWidget != null) {
+        setValueByPath(toObject, ['enableWidget'], fromEnableWidget);
+    }
+    return toObject;
+}
 function googleSearchToMldev(fromObject) {
     const toObject = {};
     const fromTimeRangeFilter = getValueByPath(fromObject, [
@@ -14015,8 +14126,9 @@ function toolToMldev(fromObject) {
     if (getValueByPath(fromObject, ['enterpriseWebSearch']) !== undefined) {
         throw new Error('enterpriseWebSearch parameter is not supported in Gemini API.');
     }
-    if (getValueByPath(fromObject, ['googleMaps']) !== undefined) {
-        throw new Error('googleMaps parameter is not supported in Gemini API.');
+    const fromGoogleMaps = getValueByPath(fromObject, ['googleMaps']);
+    if (fromGoogleMaps != null) {
+        setValueByPath(toObject, ['googleMaps'], googleMapsToMldev(fromGoogleMaps));
     }
     const fromUrlContext = getValueByPath(fromObject, ['urlContext']);
     if (fromUrlContext != null) {