@google/genai 2.3.0 → 2.5.0

package/dist/web/index.mjs

@@ -12793,7 +12793,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.3.0'; // x-release-please-version
+const SDK_VERSION = '2.5.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';
@@ -17579,7 +17579,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 {
@@ -17946,6 +17948,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
@@ -18607,87 +18729,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
@@ -18763,18 +18804,32 @@ class Interactions extends BaseInteractions {
 function addOutputProperties(interaction) {
     var _a, _b;
     const steps = (_a = interaction.steps) !== null && _a !== void 0 ? _a : [];
-    let firstTrailing = steps.length;
-    while (firstTrailing > 0 && steps[firstTrailing - 1].type === 'model_output') {
-        firstTrailing--;
-    }
-    const modelSteps = steps.slice(firstTrailing);
-    const output = modelSteps.flatMap((step) => { var _a; return (_a = step.content) !== 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 = [];
-    for (let i = output.length - 1; i >= 0; i--) {
-        const content = output[i];
-        if (content.type !== 'text')
+    let collecting = false;
+    outer: for (let i = steps.length - 1; i >= 0; i--) {
+        const step = steps[i];
+        if (step.type === 'user_input')
             break;
-        textParts.push((_b = content.text) !== null && _b !== void 0 ? _b : '');
+        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;
@@ -19517,6 +19572,7 @@ class GeminiNextGenAPIClient extends BaseGeminiNextGenAPIClient {
         super(...arguments);
         this.interactions = new Interactions(this);
         this.webhooks = new Webhooks(this);
+        this.agents = new Agents(this);
     }
 }
 _a = GeminiNextGenAPIClient;
@@ -19537,6 +19593,7 @@ GeminiNextGenAPIClient.UnprocessableEntityError = UnprocessableEntityError;
 GeminiNextGenAPIClient.toFile = toFile;
 GeminiNextGenAPIClient.Interactions = Interactions;
 GeminiNextGenAPIClient.Webhooks = Webhooks;
+GeminiNextGenAPIClient.Agents = Agents;
 
 /**
  * @license
@@ -20995,6 +21052,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;
         if (options.apiKey == null) {