@elevenlabs/elevenlabs-js 2.5.0 → 2.7.0

package/dist/api/resources/audioIsolation/client/Client.js

@@ -44,17 +44,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AudioIsolation = void 0;
 const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
 const ElevenLabs = __importStar(require("../../../index"));
 const serializers = __importStar(require("../../../../serialization/index"));
-const headers_js_1 = require("../../../../core/headers.js");
-const url_join_1 = __importDefault(require("url-join"));
+const headers_1 = require("../../../../core/headers");
 const errors = __importStar(require("../../../../errors/index"));
 class AudioIsolation {
     constructor(_options = {}) {
@@ -79,9 +75,9 @@ class AudioIsolation {
             }
             const _maybeEncodedRequest = yield _request.getRequest();
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/audio-isolation"),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, "v1/audio-isolation"),
                 method: "POST",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,
@@ -146,9 +142,9 @@ class AudioIsolation {
             }
             const _maybeEncodedRequest = yield _request.getRequest();
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/audio-isolation/stream"),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, "v1/audio-isolation/stream"),
                 method: "POST",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,

package/dist/api/resources/audioNative/client/Client.d.ts

@@ -6,7 +6,7 @@ import * as core from "../../../../core";
 import * as ElevenLabs from "../../../index";
 export declare namespace AudioNative {
     interface Options {
-        environment?: core.Supplier<environments.ElevenLabsEnvironment | environments.ElevenLabsEnvironmentUrls>;
+        environment?: core.Supplier<environments.ElevenLabsEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
         /** Override the xi-api-key header */

package/dist/api/resources/audioNative/client/Client.js

@@ -44,16 +44,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AudioNative = void 0;
 const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
 const ElevenLabs = __importStar(require("../../../index"));
-const headers_js_1 = require("../../../../core/headers.js");
-const url_join_1 = __importDefault(require("url-join"));
+const headers_1 = require("../../../../core/headers");
 const serializers = __importStar(require("../../../../serialization/index"));
 const errors = __importStar(require("../../../../errors/index"));
 class AudioNative {
@@ -116,9 +112,9 @@ class AudioNative {
             }
             const _maybeEncodedRequest = yield _request.getRequest();
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/audio-native"),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, "v1/audio-native"),
                 method: "POST",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,
@@ -189,9 +185,9 @@ class AudioNative {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/audio-native/${encodeURIComponent(projectId)}/settings`),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, `v1/audio-native/${encodeURIComponent(projectId)}/settings`),
                 method: "GET",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 240000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -271,9 +267,9 @@ class AudioNative {
             }
             const _maybeEncodedRequest = yield _request.getRequest();
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/audio-native/${encodeURIComponent(projectId)}/content`),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, `v1/audio-native/${encodeURIComponent(projectId)}/content`),
                 method: "POST",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,

package/dist/api/resources/conversationalAi/client/Client.d.ts

@@ -19,7 +19,7 @@ import { McpServers } from "../resources/mcpServers/client/Client";
 import { Dashboard } from "../resources/dashboard/client/Client";
 export declare namespace ConversationalAi {
     interface Options {
-        environment?: core.Supplier<environments.ElevenLabsEnvironment | environments.ElevenLabsEnvironmentUrls>;
+        environment?: core.Supplier<environments.ElevenLabsEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
         /** Override the xi-api-key header */

package/dist/api/resources/conversationalAi/client/Client.js

@@ -44,16 +44,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConversationalAi = void 0;
 const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
 const ElevenLabs = __importStar(require("../../../index"));
-const headers_js_1 = require("../../../../core/headers.js");
-const url_join_1 = __importDefault(require("url-join"));
+const headers_1 = require("../../../../core/headers");
 const serializers = __importStar(require("../../../../serialization/index"));
 const errors = __importStar(require("../../../../errors/index"));
 const Client_1 = require("../resources/conversations/client/Client");
@@ -158,9 +154,9 @@ class ConversationalAi {
             }
             const _maybeEncodedRequest = yield _request.getRequest();
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/convai/knowledge-base"),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, "v1/convai/knowledge-base"),
                 method: "POST",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)(Object.assign({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 queryParameters: _queryParams,
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
@@ -232,9 +228,9 @@ class ConversationalAi {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/convai/knowledge-base/${encodeURIComponent(documentationId)}/rag-index`),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, `v1/convai/knowledge-base/${encodeURIComponent(documentationId)}/rag-index`),
                 method: "GET",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 240000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -303,9 +299,9 @@ class ConversationalAi {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/convai/knowledge-base/${encodeURIComponent(documentationId)}/rag-index/${encodeURIComponent(ragIndexId)}`),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, `v1/convai/knowledge-base/${encodeURIComponent(documentationId)}/rag-index/${encodeURIComponent(ragIndexId)}`),
                 method: "DELETE",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 240000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -372,9 +368,9 @@ class ConversationalAi {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/convai/knowledge-base/rag-index"),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, "v1/convai/knowledge-base/rag-index"),
                 method: "GET",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 240000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -446,9 +442,9 @@ class ConversationalAi {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const _response = yield core.fetcher({
-                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/convai/secrets/${encodeURIComponent(secretId)}`),
+                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production, `v1/convai/secrets/${encodeURIComponent(secretId)}`),
                 method: "PATCH",
-                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: Object.assign(Object.assign({}, serializers.PatchWorkspaceSecretRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" })), { type: "update" }),

package/dist/api/resources/conversationalAi/conversation/AudioInterface.d.ts

@@ -0,0 +1,44 @@
+/**
+ * AudioInterface provides an abstraction for handling audio input and output.
+ *
+ * This interface is designed to work with Node.js audio libraries and provides
+ * the necessary methods for real-time audio processing in conversational AI applications.
+ */
+export declare abstract class AudioInterface {
+    /**
+     * Starts the audio interface.
+     *
+     * Called one time before the conversation starts.
+     * The `inputCallback` should be called regularly with input audio chunks from
+     * the user. The audio should be in 16-bit PCM mono format at 16kHz. Recommended
+     * chunk size is 4000 samples (250 milliseconds).
+     *
+     * @param inputCallback Function to call with audio chunks from the microphone
+     */
+    abstract start(inputCallback: (audio: Buffer) => void): void;
+    /**
+     * Stops the audio interface.
+     *
+     * Called one time after the conversation ends. Should clean up any resources
+     * used by the audio interface and stop any audio streams. Do not call the
+     * `inputCallback` from `start` after this method is called.
+     */
+    abstract stop(): void;
+    /**
+     * Output audio to the user.
+     *
+     * The `audio` input is in 16-bit PCM mono format at 16kHz. Implementations can
+     * choose to do additional buffering. This method should return quickly and not
+     * block the calling thread.
+     *
+     * @param audio Audio data to output to the speaker
+     */
+    abstract output(audio: Buffer): void;
+    /**
+     * Interruption signal to stop any audio output.
+     *
+     * User has interrupted the agent and all previously buffered audio output should
+     * be stopped.
+     */
+    abstract interrupt(): void;
+}

package/dist/api/resources/conversationalAi/conversation/AudioInterface.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudioInterface = void 0;
+/**
+ * AudioInterface provides an abstraction for handling audio input and output.
+ *
+ * This interface is designed to work with Node.js audio libraries and provides
+ * the necessary methods for real-time audio processing in conversational AI applications.
+ */
+class AudioInterface {
+}
+exports.AudioInterface = AudioInterface;

package/dist/api/resources/conversationalAi/conversation/ClientTools.d.ts

@@ -0,0 +1,60 @@
+import { ClientToolResultEvent } from "./events";
+/**
+ * Handles registration and execution of client-side tools that can be called by the agent.
+ *
+ * Supports both synchronous and asynchronous tools running in a dedicated event loop,
+ * ensuring non-blocking operation of the main conversation thread.
+ */
+export declare class ClientTools {
+    private tools;
+    /**
+     * Register a new tool that can be called by the AI agent.
+     *
+     * @param toolName Unique identifier for the tool
+     * @param handler Function that implements the tool's logic
+     * @param isAsync Whether the handler is an async function (auto-detected if not specified)
+     */
+    register(toolName: string, handler: (parameters: Record<string, any>) => any | Promise<any>, isAsync?: boolean): void;
+    /**
+     * Execute a registered tool with the given parameters.
+     *
+     * @param toolName Name of the tool to execute
+     * @param parameters Parameters to pass to the tool
+     * @returns The result of the tool execution
+     */
+    handle(toolName: string, parameters: Record<string, any>): Promise<any>;
+    /**
+     * Execute a tool and send its result via the provided callback.
+     *
+     * This method is non-blocking and handles both sync and async tools.
+     *
+     * @param toolName Name of the tool to execute
+     * @param parameters Parameters to pass to the tool (should include tool_call_id)
+     * @param callback Function to call with the result
+     */
+    executeToolAsync(toolName: string, parameters: Record<string, any>, callback: (response: ClientToolResultEvent) => void): void;
+    /**
+     * Get a list of all registered tool names.
+     *
+     * @returns Array of tool names
+     */
+    getRegisteredTools(): string[];
+    /**
+     * Check if a tool is registered.
+     *
+     * @param toolName Name of the tool to check
+     * @returns True if the tool is registered
+     */
+    isToolRegistered(toolName: string): boolean;
+    /**
+     * Unregister a tool.
+     *
+     * @param toolName Name of the tool to unregister
+     * @returns True if the tool was found and removed
+     */
+    unregister(toolName: string): boolean;
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+}

package/dist/api/resources/conversationalAi/conversation/ClientTools.js

@@ -0,0 +1,132 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientTools = void 0;
+const events_1 = require("./events");
+/**
+ * Handles registration and execution of client-side tools that can be called by the agent.
+ *
+ * Supports both synchronous and asynchronous tools running in a dedicated event loop,
+ * ensuring non-blocking operation of the main conversation thread.
+ */
+class ClientTools {
+    constructor() {
+        this.tools = new Map();
+    }
+    /**
+     * Register a new tool that can be called by the AI agent.
+     *
+     * @param toolName Unique identifier for the tool
+     * @param handler Function that implements the tool's logic
+     * @param isAsync Whether the handler is an async function (auto-detected if not specified)
+     */
+    register(toolName, handler, isAsync) {
+        if (!handler || typeof handler !== "function") {
+            throw new Error("Handler must be a function");
+        }
+        if (this.tools.has(toolName)) {
+            throw new Error(`Tool '${toolName}' is already registered`);
+        }
+        // Auto-detect if the function is async if not specified
+        const isAsyncHandler = isAsync !== undefined ? isAsync : handler.constructor.name === "AsyncFunction";
+        this.tools.set(toolName, {
+            handler,
+            isAsync: isAsyncHandler,
+        });
+    }
+    /**
+     * Execute a registered tool with the given parameters.
+     *
+     * @param toolName Name of the tool to execute
+     * @param parameters Parameters to pass to the tool
+     * @returns The result of the tool execution
+     */
+    handle(toolName, parameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const tool = this.tools.get(toolName);
+            if (!tool) {
+                throw new Error(`Tool '${toolName}' is not registered`);
+            }
+            if (tool.isAsync) {
+                return yield tool.handler(parameters);
+            }
+            else {
+                return tool.handler(parameters);
+            }
+        });
+    }
+    /**
+     * Execute a tool and send its result via the provided callback.
+     *
+     * This method is non-blocking and handles both sync and async tools.
+     *
+     * @param toolName Name of the tool to execute
+     * @param parameters Parameters to pass to the tool (should include tool_call_id)
+     * @param callback Function to call with the result
+     */
+    executeToolAsync(toolName, parameters, callback) {
+        // Run the tool execution in the next tick to avoid blocking
+        setImmediate(() => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield this.handle(toolName, parameters);
+                const response = {
+                    type: events_1.ClientToOrchestratorEvent.CLIENT_TOOL_RESULT,
+                    tool_call_id: parameters.tool_call_id,
+                    result: result !== null && result !== void 0 ? result : `Client tool: ${toolName} called successfully.`,
+                    is_error: false,
+                };
+                callback(response);
+            }
+            catch (error) {
+                const response = {
+                    type: events_1.ClientToOrchestratorEvent.CLIENT_TOOL_RESULT,
+                    tool_call_id: parameters.tool_call_id,
+                    result: error.message || String(error),
+                    is_error: true,
+                };
+                callback(response);
+            }
+        }));
+    }
+    /**
+     * Get a list of all registered tool names.
+     *
+     * @returns Array of tool names
+     */
+    getRegisteredTools() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Check if a tool is registered.
+     *
+     * @param toolName Name of the tool to check
+     * @returns True if the tool is registered
+     */
+    isToolRegistered(toolName) {
+        return this.tools.has(toolName);
+    }
+    /**
+     * Unregister a tool.
+     *
+     * @param toolName Name of the tool to unregister
+     * @returns True if the tool was found and removed
+     */
+    unregister(toolName) {
+        return this.tools.delete(toolName);
+    }
+    /**
+     * Clear all registered tools.
+     */
+    clear() {
+        this.tools.clear();
+    }
+}
+exports.ClientTools = ClientTools;

package/dist/api/resources/conversationalAi/conversation/Conversation.d.ts

@@ -0,0 +1,94 @@
+import { EventEmitter } from "events";
+import { ElevenLabsClient } from "../../../../Client";
+import { AudioInterface } from "./AudioInterface";
+import { ClientTools } from "./ClientTools";
+import { ConversationInitiationData } from "./ConversationConfig";
+import { WebSocketFactory } from "./interfaces/WebSocketInterface";
+import { ConversationClient } from "./interfaces/ConversationClient";
+/**
+ * Conversational AI session for Node.js.
+ *
+ * BETA: This API is subject to change without regard to backwards compatibility.
+ */
+export declare class Conversation extends EventEmitter {
+    private client;
+    private agentId;
+    private requiresAuth;
+    private audioInterface;
+    private clientTools;
+    private config;
+    private webSocketFactory;
+    private conversationClient;
+    private callbackAgentResponse?;
+    private callbackAgentResponseCorrection?;
+    private callbackUserTranscript?;
+    private callbackLatencyMeasurement?;
+    private ws?;
+    private shouldStop;
+    private conversationId?;
+    private lastInterruptId;
+    private inputCallback?;
+    constructor(options: {
+        client?: ElevenLabsClient;
+        conversationClient?: ConversationClient;
+        webSocketFactory?: WebSocketFactory;
+        agentId: string;
+        requiresAuth: boolean;
+        audioInterface: AudioInterface;
+        config?: ConversationInitiationData;
+        clientTools?: ClientTools;
+        callbackAgentResponse?: (response: string) => void;
+        callbackAgentResponseCorrection?: (original: string, corrected: string) => void;
+        callbackUserTranscript?: (transcript: string) => void;
+        callbackLatencyMeasurement?: (latencyMs: number) => void;
+    });
+    /**
+     * Starts the conversation session.
+     *
+     * Will run until `endSession` is called.
+     */
+    startSession(): Promise<void>;
+    /**
+     * Ends the conversation session and cleans up resources.
+     */
+    endSession(): void;
+    /**
+     * Send a text message from the user to the agent.
+     *
+     * @param text The text message to send to the agent
+     */
+    sendUserMessage(text: string): void;
+    /**
+     * Register user activity to prevent session timeout.
+     *
+     * This sends a ping to the orchestrator to reset the timeout timer.
+     */
+    registerUserActivity(): void;
+    /**
+     * Send a contextual update to the conversation.
+     *
+     * Contextual updates are non-interrupting content that is sent to the server
+     * to update the conversation state without directly prompting the agent.
+     *
+     * @param text The contextual information to send to the conversation
+     */
+    sendContextualUpdate(text: string): void;
+    /**
+     * Get the conversation ID if available.
+     *
+     * @returns The conversation ID or undefined if not yet available
+     */
+    getConversationId(): string | undefined;
+    /**
+     * Check if the session is currently active.
+     *
+     * @returns True if the session is active
+     */
+    isSessionActive(): boolean;
+    private _onWebSocketOpen;
+    private _onWebSocketMessage;
+    private _onWebSocketClose;
+    private _handleMessage;
+    private _getWssUrl;
+    private _getSignedUrl;
+}