hume 0.8.3 → 0.8.5

package/api/resources/empathicVoice/resources/tools/client/Client.js

@@ -64,50 +64,52 @@ class Tools {
             const { pageNumber, pageSize, restrictToMostRecent, name } = request;
             const _queryParams = {};
             if (pageNumber != null) {
-                _queryParams["page_number"] = pageNumber.toString();
+                _queryParams['page_number'] = pageNumber.toString();
             }
             if (pageSize != null) {
-                _queryParams["page_size"] = pageSize.toString();
+                _queryParams['page_size'] = pageSize.toString();
             }
             if (restrictToMostRecent != null) {
-                _queryParams["restrict_to_most_recent"] = restrictToMostRecent.toString();
+                _queryParams['restrict_to_most_recent'] = restrictToMostRecent.toString();
             }
             if (name != null) {
-                _queryParams["name"] = name;
+                _queryParams['name'] = name;
             }
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
-                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, "v0/evi/tools"),
-                method: "GET",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, 'v0/evi/tools'),
+                method: 'GET',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
                 queryParameters: _queryParams,
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return serializers.empathicVoice.ReturnPagedUserDefinedTools.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
+                    unrecognizedObjectKeys: 'passthrough',
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
+                    breadcrumbsPrefix: ['response'],
                 });
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -131,40 +133,42 @@ class Tools {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
-                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, "v0/evi/tools"),
-                method: "POST",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, 'v0/evi/tools'),
+                method: 'POST',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
                 body: serializers.empathicVoice.PostedUserDefinedTool.jsonOrThrow(request, {
-                    unrecognizedObjectKeys: "strip",
+                    unrecognizedObjectKeys: 'strip',
                 }),
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return serializers.empathicVoice.tools.createTool.Response.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
+                    unrecognizedObjectKeys: 'passthrough',
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
+                    breadcrumbsPrefix: ['response'],
                 });
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -172,7 +176,7 @@ class Tools {
         });
     }
     /**
-     * @param {string} id - Identifier for a tool. Formatted as a UUID.
+     * @param {string} id - Identifier for a Tool. Formatted as a UUID.
      * @param {Hume.empathicVoice.ToolsListToolVersionsRequest} request
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -185,47 +189,49 @@ class Tools {
             const { pageNumber, pageSize, restrictToMostRecent } = request;
             const _queryParams = {};
             if (pageNumber != null) {
-                _queryParams["page_number"] = pageNumber.toString();
+                _queryParams['page_number'] = pageNumber.toString();
             }
             if (pageSize != null) {
-                _queryParams["page_size"] = pageSize.toString();
+                _queryParams['page_size'] = pageSize.toString();
             }
             if (restrictToMostRecent != null) {
-                _queryParams["restrict_to_most_recent"] = restrictToMostRecent.toString();
+                _queryParams['restrict_to_most_recent'] = restrictToMostRecent.toString();
             }
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, `v0/evi/tools/${encodeURIComponent(id)}`),
-                method: "GET",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
+                method: 'GET',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
                 queryParameters: _queryParams,
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return serializers.empathicVoice.ReturnPagedUserDefinedTools.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
+                    unrecognizedObjectKeys: 'passthrough',
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
+                    breadcrumbsPrefix: ['response'],
                 });
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -233,7 +239,7 @@ class Tools {
         });
     }
     /**
-     * @param {string} id - Identifier for a tool. Formatted as a UUID.
+     * @param {string} id - Identifier for a Tool. Formatted as a UUID.
      * @param {Hume.empathicVoice.PostedUserDefinedToolVersion} request
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -250,39 +256,41 @@ class Tools {
         return __awaiter(this, void 0, void 0, function* () {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, `v0/evi/tools/${encodeURIComponent(id)}`),
-                method: "POST",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
+                method: 'POST',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
                 body: serializers.empathicVoice.PostedUserDefinedToolVersion.jsonOrThrow(request, {
-                    unrecognizedObjectKeys: "strip",
+                    unrecognizedObjectKeys: 'strip',
                 }),
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return serializers.empathicVoice.tools.createToolVersion.Response.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
+                    unrecognizedObjectKeys: 'passthrough',
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
+                    breadcrumbsPrefix: ['response'],
                 });
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -290,7 +298,7 @@ class Tools {
         });
     }
     /**
-     * @param {string} id - Identifier for a tool. Formatted as a UUID.
+     * @param {string} id - Identifier for a Tool. Formatted as a UUID.
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -301,31 +309,33 @@ class Tools {
         return __awaiter(this, void 0, void 0, function* () {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, `v0/evi/tools/${encodeURIComponent(id)}`),
-                method: "DELETE",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                method: 'DELETE',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return;
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -333,7 +343,7 @@ class Tools {
         });
     }
     /**
-     * @param {string} id - Identifier for a tool. Formatted as a UUID.
+     * @param {string} id - Identifier for a Tool. Formatted as a UUID.
      * @param {Hume.empathicVoice.PostedUserDefinedToolName} request
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -347,35 +357,37 @@ class Tools {
         return __awaiter(this, void 0, void 0, function* () {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, `v0/evi/tools/${encodeURIComponent(id)}`),
-                method: "PATCH",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
+                method: 'PATCH',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
                 body: serializers.empathicVoice.PostedUserDefinedToolName.jsonOrThrow(request, {
-                    unrecognizedObjectKeys: "strip",
+                    unrecognizedObjectKeys: 'strip',
                 }),
-                responseType: "text",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                responseType: 'text',
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return _response.body;
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -383,8 +395,12 @@ class Tools {
         });
     }
     /**
-     * @param {string} id - Identifier for a tool. Formatted as a UUID.
-     * @param {number} version - Version number for a tool. Version numbers should be integers.
+     * @param {string} id - Identifier for a Tool. Formatted as a UUID.
+     * @param {number} version - Version number for a Tool.
+     *
+     *                           Tools, as well as Configs and Prompts, are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed.
+     *
+     *                           Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number.
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -395,36 +411,38 @@ class Tools {
         return __awaiter(this, void 0, void 0, function* () {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, `v0/evi/tools/${encodeURIComponent(id)}/version/${encodeURIComponent(version)}`),
-                method: "GET",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                method: 'GET',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return serializers.empathicVoice.tools.getToolVersion.Response.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
+                    unrecognizedObjectKeys: 'passthrough',
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
+                    breadcrumbsPrefix: ['response'],
                 });
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -432,8 +450,12 @@ class Tools {
         });
     }
     /**
-     * @param {string} id - Identifier for a tool. Formatted as a UUID.
-     * @param {number} version - Version number for a tool. Version numbers should be integers.
+     * @param {string} id - Identifier for a Tool. Formatted as a UUID.
+     * @param {number} version - Version number for a Tool.
+     *
+     *                           Tools, as well as Configs and Prompts, are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed.
+     *
+     *                           Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number.
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -444,31 +466,33 @@ class Tools {
         return __awaiter(this, void 0, void 0, function* () {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, `v0/evi/tools/${encodeURIComponent(id)}/version/${encodeURIComponent(version)}`),
-                method: "DELETE",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                method: 'DELETE',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return;
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -476,8 +500,12 @@ class Tools {
         });
     }
     /**
-     * @param {string} id - Identifier for a tool. Formatted as a UUID.
-     * @param {number} version - Version number for a tool. Version numbers should be integers.
+     * @param {string} id - Identifier for a Tool. Formatted as a UUID.
+     * @param {number} version - Version number for a Tool.
+     *
+     *                           Tools, as well as Configs and Prompts, are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed.
+     *
+     *                           Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number.
      * @param {Hume.empathicVoice.PostedUserDefinedToolVersionDescription} request
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -491,39 +519,41 @@ class Tools {
         return __awaiter(this, void 0, void 0, function* () {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.HumeEnvironment.Production, `v0/evi/tools/${encodeURIComponent(id)}/version/${encodeURIComponent(version)}`),
-                method: "PATCH",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "hume", "X-Fern-SDK-Version": "0.8.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
+                method: 'PATCH',
+                headers: Object.assign({ 'X-Fern-Language': 'JavaScript', 'X-Fern-SDK-Name': 'hume', 'X-Fern-SDK-Version': '0.8.5', 'X-Fern-Runtime': core.RUNTIME.type, 'X-Fern-Runtime-Version': core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: 'application/json',
                 body: serializers.empathicVoice.PostedUserDefinedToolVersionDescription.jsonOrThrow(request, {
-                    unrecognizedObjectKeys: "strip",
+                    unrecognizedObjectKeys: 'strip',
                 }),
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null
+                    ? requestOptions.timeoutInSeconds * 1000
+                    : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return serializers.empathicVoice.tools.updateToolDescription.Response.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
+                    unrecognizedObjectKeys: 'passthrough',
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
+                    breadcrumbsPrefix: ['response'],
                 });
             }
-            if (_response.error.reason === "status-code") {
+            if (_response.error.reason === 'status-code') {
                 throw new errors.HumeError({
                     statusCode: _response.error.statusCode,
                     body: _response.error.body,
                 });
             }
             switch (_response.error.reason) {
-                case "non-json":
+                case 'non-json':
                     throw new errors.HumeError({
                         statusCode: _response.error.statusCode,
                         body: _response.error.rawBody,
                     });
-                case "timeout":
+                case 'timeout':
                     throw new errors.HumeTimeoutError();
-                case "unknown":
+                case 'unknown':
                     throw new errors.HumeError({
                         message: _response.error.errorMessage,
                     });
@@ -533,7 +563,7 @@ class Tools {
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             const apiKeyValue = yield core.Supplier.get(this._options.apiKey);
-            return { "X-Hume-Api-Key": apiKeyValue };
+            return { 'X-Hume-Api-Key': apiKeyValue };
         });
     }
 }

package/api/resources/empathicVoice/resources/tools/client/index.d.ts

@@ -1 +1 @@
-export * from "./requests";
+export * from './requests';

package/api/resources/empathicVoice/resources/tools/client/requests/PostedUserDefinedTool.d.ts

@@ -14,12 +14,16 @@
 export interface PostedUserDefinedTool {
     /** Name applied to all versions of a particular Tool. */
     name: string;
-    /** Description that is appended to a specific version of a Tool. */
+    /** An optional description of the Tool version. */
     versionDescription?: string;
-    /** Text describing what the tool does. */
+    /** An optional description of what the Tool does, used by the supplemental LLM to choose when and how to call the function. */
     description?: string;
-    /** Stringified JSON defining the parameters used by this version of the Tool. */
+    /**
+     * Stringified JSON defining the parameters used by this version of the Tool.
+     *
+     * These parameters define the inputs needed for the Tool’s execution, including the expected data type and description for each input field. Structured as a stringified JSON schema, this format ensures the Tool receives data in the expected format.
+     */
     parameters: string;
-    /** Text to use if the tool fails to generate content. */
+    /** Optional text passed to the supplemental LLM in place of the tool call result. The LLM then uses this text to generate a response back to the user, ensuring continuity in the conversation if the Tool errors. */
     fallbackContent?: string;
 }

package/api/resources/empathicVoice/resources/tools/client/requests/PostedUserDefinedToolVersion.d.ts

@@ -11,12 +11,16 @@
  *     }
  */
 export interface PostedUserDefinedToolVersion {
-    /** Description that is appended to a specific version of a Tool. */
+    /** An optional description of the Tool version. */
     versionDescription?: string;
-    /** Text describing what the tool does. */
+    /** An optional description of what the Tool does, used by the supplemental LLM to choose when and how to call the function. */
     description?: string;
-    /** Stringified JSON defining the parameters used by this version of the Tool. */
+    /**
+     * Stringified JSON defining the parameters used by this version of the Tool.
+     *
+     * These parameters define the inputs needed for the Tool’s execution, including the expected data type and description for each input field. Structured as a stringified JSON schema, this format ensures the Tool receives data in the expected format.
+     */
     parameters: string;
-    /** Text to use if the tool fails to generate content. */
+    /** Optional text passed to the supplemental LLM in place of the tool call result. The LLM then uses this text to generate a response back to the user, ensuring continuity in the conversation if the Tool errors. */
     fallbackContent?: string;
 }

package/api/resources/empathicVoice/resources/tools/client/requests/PostedUserDefinedToolVersionDescription.d.ts

@@ -8,6 +8,6 @@
  *     }
  */
 export interface PostedUserDefinedToolVersionDescription {
-    /** Description that is appended to a specific version of a Tool. */
+    /** An optional description of the Tool version. */
     versionDescription?: string;
 }