@google/genai 2.2.0 → 2.4.0

package/dist/index.cjs

@@ -7596,7 +7596,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 = '2.2.0'; // x-release-please-version
+const SDK_VERSION = '2.4.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';
@@ -9563,7 +9563,9 @@ class APIConnectionError extends APIError {
 }
 class APIConnectionTimeoutError extends APIConnectionError {
     constructor({ message } = {}) {
-        super({ message: message !== null && message !== void 0 ? message : 'Request timed out.' });
+        super({
+            message: message !== null && message !== void 0 ? message : 'Request timed out. This is a client-side timeout. You can increase the timeout by setting the `timeout` argument in your request or client http options.',
+        });
     }
 }
 class BadRequestError extends APIError {
@@ -9930,6 +9932,126 @@ class APIResource {
  */
 APIResource._key = [];
 
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Percent-encode everything that isn't safe to have in a path without encoding safe chars.
+ *
+ * Taken from https://datatracker.ietf.org/doc/html/rfc3986#section-3.3:
+ * > unreserved  = ALPHA / DIGIT / "-" / "." / "_" / "~"
+ * > sub-delims  = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "="
+ * > pchar       = unreserved / pct-encoded / sub-delims / ":" / "@"
+ */
+function encodeURIPath(str) {
+    return str.replace(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/g, encodeURIComponent);
+}
+const EMPTY = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.create(null));
+const createPathTagFunction = (pathEncoder = encodeURIPath) => (function path(statics, ...params) {
+    // If there are no params, no processing is needed.
+    if (statics.length === 1)
+        return statics[0];
+    let postPath = false;
+    const invalidSegments = [];
+    const path = statics.reduce((previousValue, currentValue, index) => {
+        var _a, _b, _c;
+        if (/[?#]/.test(currentValue)) {
+            postPath = true;
+        }
+        const value = params[index];
+        let encoded = (postPath ? encodeURIComponent : pathEncoder)('' + value);
+        if (index !== params.length &&
+            (value == null ||
+                (typeof value === 'object' &&
+                    // handle values from other realms
+                    value.toString ===
+                        ((_c = Object.getPrototypeOf((_b = Object.getPrototypeOf((_a = value.hasOwnProperty) !== null && _a !== void 0 ? _a : EMPTY)) !== null && _b !== void 0 ? _b : EMPTY)) === null || _c === void 0 ? void 0 : _c.toString)))) {
+            encoded = value + '';
+            invalidSegments.push({
+                start: previousValue.length + currentValue.length,
+                length: encoded.length,
+                error: `Value of type ${Object.prototype.toString
+                    .call(value)
+                    .slice(8, -1)} is not a valid path parameter`,
+            });
+        }
+        return previousValue + currentValue + (index === params.length ? '' : encoded);
+    }, '');
+    const pathOnly = path.split(/[?#]/, 1)[0];
+    const invalidSegmentPattern = /(^|\/)(?:\.|%2e){1,2}(?=\/|$)/gi;
+    let match;
+    // Find all invalid segments
+    while ((match = invalidSegmentPattern.exec(pathOnly)) !== null) {
+        const hasLeadingSlash = match[0].startsWith('/');
+        const offset = hasLeadingSlash ? 1 : 0;
+        const cleanMatch = hasLeadingSlash ? match[0].slice(1) : match[0];
+        invalidSegments.push({
+            start: match.index + offset,
+            length: cleanMatch.length,
+            error: `Value "${cleanMatch}" can\'t be safely passed as a path parameter`,
+        });
+    }
+    invalidSegments.sort((a, b) => a.start - b.start);
+    if (invalidSegments.length > 0) {
+        let lastEnd = 0;
+        const underline = invalidSegments.reduce((acc, segment) => {
+            const spaces = ' '.repeat(segment.start - lastEnd);
+            const arrows = '^'.repeat(segment.length);
+            lastEnd = segment.start + segment.length;
+            return acc + spaces + arrows;
+        }, '');
+        throw new GeminiNextGenAPIClientError(`Path parameters result in path with invalid segments:\n${invalidSegments
+            .map((e) => e.error)
+            .join('\n')}\n${path}\n${underline}`);
+    }
+    return path;
+});
+/**
+ * URI-encodes path params and ensures no unsafe /./ or /../ path segments are introduced.
+ */
+const path = /* @__PURE__ */ createPathTagFunction(encodeURIPath);
+
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class BaseAgents extends APIResource {
+    /**
+     * Creates a new Agent (Typed version for SDK).
+     */
+    create(params = {}, options) {
+        const _a = params !== null && params !== void 0 ? params : {}, { api_version = this._client.apiVersion } = _a, body = __rest(_a, ["api_version"]);
+        return this._client.post(path `/${api_version}/agents`, Object.assign({ body }, options));
+    }
+    /**
+     * Lists all Agents.
+     */
+    list(params = {}, options) {
+        const _a = params !== null && params !== void 0 ? params : {}, { api_version = this._client.apiVersion } = _a, query = __rest(_a, ["api_version"]);
+        return this._client.get(path `/${api_version}/agents`, Object.assign({ query }, options));
+    }
+    /**
+     * Deletes an Agent.
+     */
+    delete(id, params = {}, options) {
+        const { api_version = this._client.apiVersion } = params !== null && params !== void 0 ? params : {};
+        return this._client.delete(path `/${api_version}/agents/${id}`, options);
+    }
+    /**
+     * Gets a specific Agent.
+     */
+    get(id, params = {}, options) {
+        const { api_version = this._client.apiVersion } = params !== null && params !== void 0 ? params : {};
+        return this._client.get(path `/${api_version}/agents/${id}`, options);
+    }
+}
+BaseAgents._key = Object.freeze(['agents']);
+class Agents extends BaseAgents {
+}
+
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -10591,87 +10713,6 @@ class LegacyLyriaStream extends Stream {
     }
 }
 
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Percent-encode everything that isn't safe to have in a path without encoding safe chars.
- *
- * Taken from https://datatracker.ietf.org/doc/html/rfc3986#section-3.3:
- * > unreserved  = ALPHA / DIGIT / "-" / "." / "_" / "~"
- * > sub-delims  = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "="
- * > pchar       = unreserved / pct-encoded / sub-delims / ":" / "@"
- */
-function encodeURIPath(str) {
-    return str.replace(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/g, encodeURIComponent);
-}
-const EMPTY = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.create(null));
-const createPathTagFunction = (pathEncoder = encodeURIPath) => (function path(statics, ...params) {
-    // If there are no params, no processing is needed.
-    if (statics.length === 1)
-        return statics[0];
-    let postPath = false;
-    const invalidSegments = [];
-    const path = statics.reduce((previousValue, currentValue, index) => {
-        var _a, _b, _c;
-        if (/[?#]/.test(currentValue)) {
-            postPath = true;
-        }
-        const value = params[index];
-        let encoded = (postPath ? encodeURIComponent : pathEncoder)('' + value);
-        if (index !== params.length &&
-            (value == null ||
-                (typeof value === 'object' &&
-                    // handle values from other realms
-                    value.toString ===
-                        ((_c = Object.getPrototypeOf((_b = Object.getPrototypeOf((_a = value.hasOwnProperty) !== null && _a !== void 0 ? _a : EMPTY)) !== null && _b !== void 0 ? _b : EMPTY)) === null || _c === void 0 ? void 0 : _c.toString)))) {
-            encoded = value + '';
-            invalidSegments.push({
-                start: previousValue.length + currentValue.length,
-                length: encoded.length,
-                error: `Value of type ${Object.prototype.toString
-                    .call(value)
-                    .slice(8, -1)} is not a valid path parameter`,
-            });
-        }
-        return previousValue + currentValue + (index === params.length ? '' : encoded);
-    }, '');
-    const pathOnly = path.split(/[?#]/, 1)[0];
-    const invalidSegmentPattern = /(^|\/)(?:\.|%2e){1,2}(?=\/|$)/gi;
-    let match;
-    // Find all invalid segments
-    while ((match = invalidSegmentPattern.exec(pathOnly)) !== null) {
-        const hasLeadingSlash = match[0].startsWith('/');
-        const offset = hasLeadingSlash ? 1 : 0;
-        const cleanMatch = hasLeadingSlash ? match[0].slice(1) : match[0];
-        invalidSegments.push({
-            start: match.index + offset,
-            length: cleanMatch.length,
-            error: `Value "${cleanMatch}" can\'t be safely passed as a path parameter`,
-        });
-    }
-    invalidSegments.sort((a, b) => a.start - b.start);
-    if (invalidSegments.length > 0) {
-        let lastEnd = 0;
-        const underline = invalidSegments.reduce((acc, segment) => {
-            const spaces = ' '.repeat(segment.start - lastEnd);
-            const arrows = '^'.repeat(segment.length);
-            lastEnd = segment.start + segment.length;
-            return acc + spaces + arrows;
-        }, '');
-        throw new GeminiNextGenAPIClientError(`Path parameters result in path with invalid segments:\n${invalidSegments
-            .map((e) => e.error)
-            .join('\n')}\n${path}\n${underline}`);
-    }
-    return path;
-});
-/**
- * URI-encodes path params and ensures no unsafe /./ or /../ path segments are introduced.
- */
-const path = /* @__PURE__ */ createPathTagFunction(encodeURIPath);
-
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -10693,10 +10734,14 @@ class BaseInteractions extends APIResource {
         });
         const isStreaming = (_a = params.stream) !== null && _a !== void 0 ? _a : false;
         const promise = this._client.post(path `/${api_version}/interactions`, Object.assign(Object.assign(Object.assign({ body }, options), { stream: isStreaming }), (needsLegacyLyriaShim && isStreaming ? { __streamClass: LegacyLyriaStream } : {})));
-        if (needsLegacyLyriaShim && !isStreaming) {
-            return promise._thenUnwrap((data) => coerceLegacyInteractionResponse(data));
+        if (isStreaming) {
+            return promise;
         }
-        return promise;
+        let nonStreaming = promise;
+        if (needsLegacyLyriaShim) {
+            nonStreaming = nonStreaming._thenUnwrap((data) => coerceLegacyInteractionResponse(data));
+        }
+        return nonStreaming._thenUnwrap(addOutputProperties);
     }
     /**
      * Deletes the interaction by id.
@@ -10725,17 +10770,78 @@ class BaseInteractions extends APIResource {
      */
     cancel(id, params = {}, options) {
         const { api_version = this._client.apiVersion } = params !== null && params !== void 0 ? params : {};
-        return this._client.post(path `/${api_version}/interactions/${id}/cancel`, options);
+        return this._client.post(path `/${api_version}/interactions/${id}/cancel`, options)._thenUnwrap(addOutputProperties);
     }
     get(id, params = {}, options) {
         var _a;
         const _b = params !== null && params !== void 0 ? params : {}, { api_version = this._client.apiVersion } = _b, query = __rest(_b, ["api_version"]);
-        return this._client.get(path `/${api_version}/interactions/${id}`, Object.assign(Object.assign({ query }, options), { stream: (_a = params === null || params === void 0 ? void 0 : params.stream) !== null && _a !== void 0 ? _a : false }));
+        const response = this._client.get(path `/${api_version}/interactions/${id}`, Object.assign(Object.assign({ query }, options), { stream: (_a = params === null || params === void 0 ? void 0 : params.stream) !== null && _a !== void 0 ? _a : false }));
+        if (params === null || params === void 0 ? void 0 : params.stream) {
+            return response;
+        }
+        return response._thenUnwrap(addOutputProperties);
     }
 }
 BaseInteractions._key = Object.freeze(['interactions']);
 class Interactions extends BaseInteractions {
 }
+function addOutputProperties(interaction) {
+    var _a, _b;
+    const steps = (_a = interaction.steps) !== null && _a !== void 0 ? _a : [];
+    // output_text: scan backwards across all steps (stopping at user_input),
+    // skip non-text content until the first text item is found, then collect
+    // text until a non-text barrier is hit.
+    const textParts = [];
+    let collecting = false;
+    outer: for (let i = steps.length - 1; i >= 0; i--) {
+        const step = steps[i];
+        if (step.type === 'user_input')
+            break;
+        if (step.type !== 'model_output' || !step.content) {
+            if (collecting)
+                break outer;
+            continue;
+        }
+        const content = step.content;
+        for (let j = content.length - 1; j >= 0; j--) {
+            const item = content[j];
+            if (item.type === 'text') {
+                collecting = true;
+                textParts.push((_b = item.text) !== null && _b !== void 0 ? _b : '');
+            }
+            else if (collecting) {
+                // Hit a non-text barrier after we started collecting.
+                break outer;
+            }
+        }
+    }
+    const output_text = textParts.reverse().join('');
+    let output_image;
+    let output_audio;
+    let output_video;
+    for (let i = steps.length - 1; i >= 0; i--) {
+        const step = steps[i];
+        const anyStep = step;
+        if (anyStep.type === 'user_input') {
+            break;
+        }
+        if (anyStep.type === 'model_output' && anyStep.content) {
+            for (let j = anyStep.content.length - 1; j >= 0; j--) {
+                const content = anyStep.content[j];
+                if (content.type === 'image' && !output_image) {
+                    output_image = content;
+                }
+                if (content.type === 'audio' && !output_audio) {
+                    output_audio = content;
+                }
+                if (content.type === 'video' && !output_video) {
+                    output_video = content;
+                }
+            }
+        }
+    }
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, interaction), (output_text && { output_text })), (output_image && { output_image })), (output_audio && { output_audio })), (output_video && { output_video }));
+}
 
 /**
  * @license
@@ -11450,6 +11556,7 @@ class GeminiNextGenAPIClient extends BaseGeminiNextGenAPIClient {
         super(...arguments);
         this.interactions = new Interactions(this);
         this.webhooks = new Webhooks(this);
+        this.agents = new Agents(this);
     }
 }
 _a = GeminiNextGenAPIClient;
@@ -11470,6 +11577,7 @@ GeminiNextGenAPIClient.UnprocessableEntityError = UnprocessableEntityError;
 GeminiNextGenAPIClient.toFile = toFile;
 GeminiNextGenAPIClient.Interactions = Interactions;
 GeminiNextGenAPIClient.Webhooks = Webhooks;
+GeminiNextGenAPIClient.Agents = Agents;
 
 /**
  * @license
@@ -11885,6 +11993,12 @@ function liveConnectConfigToMldev$1(fromObject, parentObject) {
         }
         setValueByPath(parentObject, ['setup', 'safetySettings'], transformedList);
     }
+    const fromStreamTranslationConfig = getValueByPath(fromObject, [
+        'streamTranslationConfig',
+    ]);
+    if (parentObject !== undefined && fromStreamTranslationConfig != null) {
+        setValueByPath(parentObject, ['setup', 'generationConfig', 'streamTranslationConfig'], fromStreamTranslationConfig);
+    }
     return toObject;
 }
 function liveConnectConfigToVertex(fromObject, parentObject) {
@@ -12017,6 +12131,9 @@ function liveConnectConfigToVertex(fromObject, parentObject) {
         }
         setValueByPath(parentObject, ['setup', 'safetySettings'], transformedList);
     }
+    if (getValueByPath(fromObject, ['streamTranslationConfig']) !== undefined) {
+        throw new Error('streamTranslationConfig parameter is only supported in Gemini Developer API mode, not in Gemini Enterprise Agent Platform mode.');
+    }
     return toObject;
 }
 function liveConnectParametersToMldev(apiClient, fromObject) {
@@ -19145,6 +19262,12 @@ function liveConnectConfigToMldev(fromObject, parentObject) {
         }
         setValueByPath(parentObject, ['setup', 'safetySettings'], transformedList);
     }
+    const fromStreamTranslationConfig = getValueByPath(fromObject, [
+        'streamTranslationConfig',
+    ]);
+    if (parentObject !== undefined && fromStreamTranslationConfig != null) {
+        setValueByPath(parentObject, ['setup', 'generationConfig', 'streamTranslationConfig'], fromStreamTranslationConfig);
+    }
     return toObject;
 }
 function liveConnectConstraintsToMldev(apiClient, fromObject) {
@@ -20876,6 +20999,7 @@ class GoogleGenAI {
         if (this._interactions !== undefined) {
             return this._interactions;
         }
+        console.warn('GoogleGenAI.interactions: Interactions usage is experimental and may change in future versions.');
         this._interactions = this.getNextGenClient().interactions;
         return this._interactions;
     }
@@ -20886,6 +21010,14 @@ class GoogleGenAI {
         this._webhooks = this.getNextGenClient().webhooks;
         return this._webhooks;
     }
+    get agents() {
+        if (this._agents !== undefined) {
+            return this._agents;
+        }
+        console.warn('GoogleGenAI.agents: Agents usage is experimental and may change in future versions.');
+        this._agents = this.getNextGenClient().agents;
+        return this._agents;
+    }
     constructor(options) {
         var _a, _b;
         if (options.apiKey == null) {