@coze/realtime-api 1.0.1 → 1.0.2

package/dist/esm/index.js

@@ -1,10 +1,10 @@
 /*! For license information please see index.js.LICENSE.txt */
 var __webpack_modules__ = {
-    "?de24": function() {
+    "?e272": function() {
     /* (ignored) */ },
-    "?2a9f": function() {
+    "?5742": function() {
     /* (ignored) */ },
-    "?d039": function() {
+    "?9caf": function() {
     /* (ignored) */ }
 };
 /************************************************************************/ // The module cache
@@ -61,7 +61,7 @@ function __webpack_require__(moduleId) {
         });
     };
 })();
-/************************************************************************/ // NAMESPACE OBJECT: ../../common/temp/default/node_modules/.pnpm/axios@1.7.7/node_modules/axios/lib/platform/common/utils.js
+/************************************************************************/ // NAMESPACE OBJECT: ../../common/temp/default/node_modules/.pnpm/axios@1.7.7_debug@4.3.7/node_modules/axios/lib/platform/common/utils.js
 var common_utils_namespaceObject = {};
 __webpack_require__.r(common_utils_namespaceObject);
 __webpack_require__.d(common_utils_namespaceObject, {
@@ -2123,7 +2123,7 @@ const trackStream = (stream, chunkSize, onProgress, onFinish)=>{
     }, {
         highWaterMark: 2
     });
-}; // CONCATENATED MODULE: ../../common/temp/default/node_modules/.pnpm/axios@1.7.7/node_modules/axios/lib/adapters/fetch.js
+}; // CONCATENATED MODULE: ../../common/temp/default/node_modules/.pnpm/axios@1.7.7_debug@4.3.7/node_modules/axios/lib/adapters/fetch.js
 const isFetchSupported = 'function' == typeof fetch && 'function' == typeof Request && 'function' == typeof Response;
 const isReadableStreamSupported = isFetchSupported && 'function' == typeof ReadableStream;
 // used only inside the fetch adapter
@@ -2845,11 +2845,11 @@ axios.default = axios;
 // so that it can keep same with es module or cjs
 const { Axios: axios_Axios, AxiosError: axios_AxiosError, CanceledError: axios_CanceledError, isCancel: axios_isCancel, CancelToken: axios_CancelToken, VERSION: axios_VERSION, all: axios_all, Cancel, isAxiosError: axios_isAxiosError, spread: axios_spread, toFormData: axios_toFormData, AxiosHeaders: axios_AxiosHeaders, HttpStatusCode: axios_HttpStatusCode, formToJSON, getAdapter, mergeConfig: axios_mergeConfig } = lib_axios;
 // EXTERNAL MODULE: os (ignored)
-var os_ignored_ = __webpack_require__("?d039");
+var os_ignored_ = __webpack_require__("?9caf");
 // EXTERNAL MODULE: crypto (ignored)
-__webpack_require__("?de24");
+__webpack_require__("?e272");
 // EXTERNAL MODULE: jsonwebtoken (ignored)
-__webpack_require__("?2a9f");
+__webpack_require__("?5742");
 class APIResource {
     constructor(client){
         this._client = client;
@@ -3091,6 +3091,10 @@ class Messages extends APIResource {
     }
 }
 const uuid = ()=>(Math.random() * new Date().getTime()).toString();
+const handleAdditionalMessages = (additional_messages)=>null == additional_messages ? void 0 : additional_messages.map((i)=>({
+            ...i,
+            content: 'object' == typeof i.content ? JSON.stringify(i.content) : i.content
+        }));
 class Chat extends APIResource {
     /**
    * Call the Chat API to send messages to a published Coze agent. | 调用此接口发起一次对话，支持添加上下文
@@ -3112,6 +3116,7 @@ class Chat extends APIResource {
         const apiUrl = `/v3/chat${conversation_id ? `?conversation_id=${conversation_id}` : ''}`;
         const payload = {
             ...rest,
+            additional_messages: handleAdditionalMessages(params.additional_messages),
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -3137,6 +3142,7 @@ class Chat extends APIResource {
         const apiUrl = `/v3/chat${conversation_id ? `?conversation_id=${conversation_id}` : ''}`;
         const payload = {
             ...rest,
+            additional_messages: handleAdditionalMessages(params.additional_messages),
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -3174,6 +3180,7 @@ class Chat extends APIResource {
         const apiUrl = `/v3/chat${conversation_id ? `?conversation_id=${conversation_id}` : ''}`;
         const payload = {
             ...rest,
+            additional_messages: handleAdditionalMessages(params.additional_messages),
             stream: true
         };
         const result = await this._client.post(apiUrl, payload, true, options);
@@ -3348,6 +3355,7 @@ class Conversations extends APIResource {
    * @param params - Required The parameters for creating a conversation | 创建会话所需的参数
    * @param params.messages - Optional Messages in the conversation. | 会话中的消息内容。
    * @param params.meta_data - Optional Additional information when creating a message. | 创建消息时的附加消息。
+   * @param params.bot_id - Optional Bind and isolate conversation on different bots. | 绑定和隔离不同Bot的会话。
    * @returns Information about the created conversation. | 会话的基础信息。
    */ async create(params, options) {
         const apiUrl = '/v1/conversation/create';
@@ -3365,6 +3373,27 @@ class Conversations extends APIResource {
         const response = await this._client.get(apiUrl, null, false, options);
         return response.data;
     }
+    /**
+   * List all conversations. | 列出 Bot 下所有会话。
+   * @param params
+   * @param params.bot_id - Required Bot ID. | Bot ID。
+   * @param params.page_num - Optional The page number. | 页码，默认值为 1。
+   * @param params.page_size - Optional The number of conversations per page. | 每页的会话数量，默认值为 50。
+   * @returns Information about the conversations. | 会话的信息。
+   */ async list(params, options) {
+        const apiUrl = '/v1/conversations';
+        const response = await this._client.get(apiUrl, params, false, options);
+        return response.data;
+    }
+    /**
+   * Clear a conversation. | 清空会话。
+   * @param conversation_id - Required The ID of the conversation. | Conversation ID，即会话的唯一标识。
+   * @returns Information about the conversation session. | 会话的会话 ID。
+   */ async clear(conversation_id, options) {
+        const apiUrl = `/v1/conversations/${conversation_id}/clear`;
+        const response = await this._client.post(apiUrl, null, false, options);
+        return response.data;
+    }
     constructor(...args){
         super(...args), this.messages = new messages_Messages(this._client);
     }
@@ -3403,6 +3432,9 @@ class Runs extends APIResource {
    * @param params.bot_id - Optional The ID of the bot associated with the workflow. | 可选 与工作流关联的机器人 ID。
    * @param params.parameters - Optional Parameters for the workflow execution. | 可选 工作流执行的参数。
    * @param params.ext - Optional Additional information for the workflow execution. | 可选 工作流执行的附加信息。
+   * @param params.execute_mode - Optional The mode in which to execute the workflow. | 可选 工作流执行的模式。
+   * @param params.connector_id - Optional The ID of the connector to use for the workflow. | 可选 用于工作流的连接器 ID。
+   * @param params.app_id - Optional The ID of the app.  | 可选 要进行会话聊天的 App ID
    * @returns RunWorkflowData | 工作流运行数据
    */ async create(params, options) {
         const apiUrl = '/v1/workflow/run';
@@ -3417,6 +3449,9 @@ class Runs extends APIResource {
    * @param params.bot_id - Optional The ID of the bot associated with the workflow. | 可选 与工作流关联的机器人 ID。
    * @param params.parameters - Optional Parameters for the workflow execution. | 可选 工作流执行的参数。
    * @param params.ext - Optional Additional information for the workflow execution. | 可选 工作流执行的附加信息。
+   * @param params.execute_mode - Optional The mode in which to execute the workflow. | 可选 工作流执行的模式。
+   * @param params.connector_id - Optional The ID of the connector to use for the workflow. | 可选 用于工作流的连接器 ID。
+   * @param params.app_id - Optional The ID of the app.  | 可选 要进行会话聊天的 App ID
    * @returns Stream<WorkflowEvent, { id: string; event: string; data: string }> | 工作流事件流
    */ async *stream(params, options) {
         const apiUrl = '/v1/workflow/stream_run';
@@ -3612,7 +3647,7 @@ class esm_Audio extends APIResource {
         super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client);
     }
 }
-var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.11","description":"Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中","keywords":["coze","ai","nodejs","sdk","chatbot","typescript"],"homepage":"https://github.com/coze-dev/coze-js/tree/main/packages/coze-js","bugs":{"url":"https://github.com/coze-dev/coze-js/issues"},"repository":{"type":"git","url":"https://github.com/coze-dev/coze-js.git","directory":"packages/coze-js"},"license":"MIT","author":"Leeight <leeight@gmail.com>","type":"module","exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"dist/types/index.d.ts","files":["dist","LICENSE","README.md","!**/*.tsbuildinfo"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","prepublishOnly":"npm run build","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"devDependencies":{"@coze-infra/eslint-config":"workspace:*","@coze-infra/ts-config":"workspace:*","@coze-infra/vitest-config":"workspace:*","@rslib/core":"0.0.18","@swc/core":"^1.3.14","@types/jsonwebtoken":"^9.0.0","@types/node":"^20","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"}}'); // CONCATENATED MODULE: ./src/version.ts
+var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.14","description":"Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中","keywords":["coze","ai","nodejs","sdk","chatbot","typescript"],"homepage":"https://github.com/coze-dev/coze-js/tree/main/packages/coze-js","bugs":{"url":"https://github.com/coze-dev/coze-js/issues"},"repository":{"type":"git","url":"https://github.com/coze-dev/coze-js.git","directory":"packages/coze-js"},"license":"MIT","author":"Leeight <leeight@gmail.com>","type":"module","exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"dist/types/index.d.ts","files":["dist","LICENSE","README.md","!**/*.tsbuildinfo"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","prepublishOnly":"npm run build","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"devDependencies":{"@coze-infra/eslint-config":"workspace:*","@coze-infra/ts-config":"workspace:*","@coze-infra/vitest-config":"workspace:*","@rslib/core":"0.0.18","@swc/core":"^1.3.14","@types/jsonwebtoken":"^9.0.0","@types/node":"^20","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"}}'); // CONCATENATED MODULE: ./src/version.ts
 const { version: esm_version } = package_namespaceObject;
 const getEnv = ()=>{
     const nodeVersion = process.version.slice(1); // Remove 'v' prefix
@@ -3675,6 +3710,11 @@ const getNodeClientUserAgent = ()=>{
 async function fetchAPI(url) {
     let options = arguments.length > 1 && void 0 !== arguments[1] ? arguments[1] : {};
     const axiosInstance = options.axiosInstance || lib_axios;
+    // Add version check for streaming requests
+    if (options.isStreaming && isAxiosStatic(axiosInstance)) {
+        const axiosVersion = axiosInstance.VERSION || lib_axios.VERSION;
+        if (!axiosVersion || compareVersions(axiosVersion, '1.7.1') < 0) throw new CozeError('Streaming requests require axios version 1.7.1 or higher. Please upgrade your axios version.');
+    }
     const response = await axiosInstance({
         url,
         responseType: options.isStreaming ? 'stream' : 'json',
@@ -3687,12 +3727,12 @@ async function fetchAPI(url) {
         async *stream () {
             try {
                 const stream = response.data;
-                const reader = stream[Symbol.asyncIterator]();
+                const reader = stream[Symbol.asyncIterator] ? stream[Symbol.asyncIterator]() : stream.getReader();
                 const decoder = new TextDecoder();
                 const fieldValues = {};
                 let buffer = '';
                 while(true){
-                    const { done, value } = await reader.next();
+                    const { done, value } = await (reader.next ? reader.next() : reader.read());
                     if (done) {
                         if (buffer) {
                             // If the stream ends without a newline, it means an error occurred
@@ -3726,6 +3766,21 @@ async function fetchAPI(url) {
         response
     };
 }
+// Add version comparison utility
+function compareVersions(v1, v2) {
+    const v1Parts = v1.split('.').map(Number);
+    const v2Parts = v2.split('.').map(Number);
+    for(let i = 0; i < 3; i++){
+        const part1 = v1Parts[i] || 0;
+        const part2 = v2Parts[i] || 0;
+        if (part1 > part2) return 1;
+        if (part1 < part2) return -1;
+    }
+    return 0;
+}
+function isAxiosStatic(instance) {
+    return !!(null == instance ? void 0 : instance.Axios);
+}
 /**
  * default coze  base URL is api.coze.com
  */ const COZE_COM_BASE_URL = 'https://api.coze.com';
@@ -3749,12 +3804,15 @@ async function fetchAPI(url) {
         const fullUrl = `${this.baseURL}${apiUrl}`;
         const fetchOptions = this.buildOptions(method, body, options);
         fetchOptions.isStreaming = isStream;
+        fetchOptions.axiosInstance = this.axiosInstance;
         this.debugLog(`--- request url: ${fullUrl}`);
         this.debugLog('--- request options:', fetchOptions);
         const { response, stream, json } = await fetchAPI(fullUrl, fetchOptions);
         this.debugLog(`--- response status: ${response.status}`);
         this.debugLog('--- response headers: ', response.headers);
-        const contentType = response.headers['content-type'];
+        var _response_headers;
+        // Taro use `header`
+        const contentType = (null !== (_response_headers = response.headers) && void 0 !== _response_headers ? _response_headers : response.header)['content-type'];
         if (isStream) {
             if (contentType && contentType.includes('application/json')) {
                 const result = await json();
@@ -3802,6 +3860,7 @@ async function fetchAPI(url) {
         this.baseURL = config.baseURL || COZE_COM_BASE_URL;
         this.token = config.token;
         this.axiosOptions = config.axiosOptions || {};
+        this.axiosInstance = config.axiosInstance;
         this.debug = config.debug || false;
         this.allowPersonalAccessTokenInBrowser = config.allowPersonalAccessTokenInBrowser || false;
         this.headers = config.headers;
@@ -12625,8 +12684,8 @@ function getBrowser() {
 }
 var _navigator$userAgent$, isFirefox = "mozilla" === getBrowser(), isSafari = "safari" === getBrowser(), isChrome = "chrome-stable" === getBrowser(), isCriOS = !isSSR2() && /CriOS/i.test(userAgentString), isEdgeForDesktop = !isSSR2() && /Edg\//i.test(userAgentString), isEdgeForAndroid = !isSSR2() && /EdgA/i.test(userAgentString), isEdgeForIOS = !isSSR2() && /EdgiOS/i.test(userAgentString), isEdge = isEdgeForDesktop || isEdgeForAndroid || isEdgeForIOS, isDingTalk = !isSSR2() && /DingTalk/i.test(navigator.userAgent), isOpera = !isSSR2() && /OPR\//.test(navigator.userAgent), isIPad = !isSSR2() && (!!/(iPad)/i.exec(userAgentString) || /Macintosh/i.test(userAgentString) && "ontouchend" in document), isMac = !isSSR2() && /Macintosh/i.test(userAgentString), isWeChat = !isSSR2() && /MicroMessenger/i.test(userAgentString), isMobile = !isSSR2() && _includesInstanceProperty(_context$3 = userAgentString.toLowerCase()).call(_context$3, "mobile"), isIOS = !isSSR2() && !!/(iPhone|iPad|iPod)/i.exec(userAgentString), isAndroid = !isSSR2() && /Android/i.test(userAgentString), isWindows = !isSSR2() && /Windows/i.test(userAgentString), isOpenHarmony = !isSSR2() && /OpenHarmony/i.test(userAgentString), sv = 0, sv2 = "0", index_esm_min_v = !isSSR2() && (null === (_userAgentString$matc = userAgentString.match(/version\/(\d+)/i)) || void 0 === _userAgentString$matc ? void 0 : _userAgentString$matc[1]);
 isSafari && index_esm_min_v && (sv = Number(index_esm_min_v), sv2 = null === (_navigator$userAgent$ = navigator.userAgent.match(/version\/(\d+\.\d+)/i)) || void 0 === _navigator$userAgent$ ? void 0 : _navigator$userAgent$[1]);
-var v2 = !isSSR2() && (null === (_userAgentString$matc2 = userAgentString.match(/Firefox\/(\d+)/i)) || void 0 === _userAgentString$matc2 ? void 0 : _userAgentString$matc2[1]);
-isFirefox && v2 && (sv = Number(v2));
+var index_esm_min_v2 = !isSSR2() && (null === (_userAgentString$matc2 = userAgentString.match(/Firefox\/(\d+)/i)) || void 0 === _userAgentString$matc2 ? void 0 : _userAgentString$matc2[1]);
+isFirefox && index_esm_min_v2 && (sv = Number(index_esm_min_v2));
 var safariVersion = sv, firefoxVersion = sv, safariMinorVersion = sv2, iOSVersion = null !== (_ref = !isSSR2() && (null === (_userAgentString$matc3 = userAgentString.match(/ ([\d_]+) like Mac OS X/i)) || void 0 === _userAgentString$matc3 || null === (_userAgentString$matc4 = _userAgentString$matc3[1]) || void 0 === _userAgentString$matc4 ? void 0 : _mapInstanceProperty(_context2 = _userAgentString$matc4.split("_")).call(_context2, function(e) {
     return _parseInt$7(e);
 }))) && void 0 !== _ref ? _ref : [], cv = 0, cvs = !isSSR2() && (null === (_userAgentString$matc5 = userAgentString.match(/Chrome\/(\d+)/i)) || void 0 === _userAgentString$matc5 ? void 0 : _userAgentString$matc5[1]);
@@ -38227,19 +38286,22 @@ var VERTC = _createClass(function e() {
 /**
  * Get audio devices
  * @returns Promise<AudioDevices> Object containing arrays of audio input and output devices
- */ const getAudioDevices = async ()=>{
-    const devices = await index_esm_min_index.enumerateDevices();
+ */ const getAudioDevices = async function() {
+    let { video = false } = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : {};
+    let devices = [];
+    devices = video ? await index_esm_min_index.enumerateDevices() : await [
+        ...await index_esm_min_index.enumerateAudioCaptureDevices(),
+        ...await index_esm_min_index.enumerateAudioPlaybackDevices()
+    ];
     if (!(null == devices ? void 0 : devices.length)) return {
         audioInputs: [],
         audioOutputs: [],
-        videoInputs: [],
-        videoOutputs: []
+        videoInputs: []
     };
     return {
         audioInputs: devices.filter((i)=>i.deviceId && 'audioinput' === i.kind),
         audioOutputs: devices.filter((i)=>i.deviceId && 'audiooutput' === i.kind),
-        videoInputs: devices.filter((i)=>i.deviceId && 'videoinput' === i.kind),
-        videoOutputs: devices.filter((i)=>i.deviceId && 'videooutput' === i.kind)
+        videoInputs: devices.filter((i)=>i.deviceId && 'videoinput' === i.kind)
     };
 };
 var error_RealtimeError = /*#__PURE__*/ function(RealtimeError) {
@@ -38342,6 +38404,34 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * en: Bot left
    * zh: Bot 离开
    */ EventNames["BOT_LEAVE"] = "server.bot.leave";
+    /**
+   * en: Audio speech started
+   * zh: 开始说话
+   */ EventNames["AUDIO_AGENT_SPEECH_STARTED"] = "server.audio.agent.speech_started";
+    /**
+   * en: Audio speech stopped
+   * zh: 停止说话
+   */ EventNames["AUDIO_SPEECH_STOPPED"] = "server.audio.speech_stopped";
+    /**
+   * en: Server error
+   * zh: 服务端错误
+   */ EventNames["SERVER_ERROR"] = "server.error";
+    /**
+   * en: User speech started
+   * zh: 用户开始说话
+   */ EventNames["AUDIO_USER_SPEECH_STARTED"] = "server.audio.user.speech_started";
+    /**
+   * en: User speech stopped
+   * zh: 用户停止说话
+   */ EventNames["AUDIO_USER_SPEECH_STOPPED"] = "server.audio.user.speech_stopped";
+    /**
+   * en: User successfully enters the room
+   * zh: 用户成功进入房间后，会收到该事件
+   */ EventNames["SESSION_CREATED"] = "server.session.created";
+    /**
+   * en: Session updated
+   * zh: 会话更新
+   */ EventNames["SESSION_UPDATE"] = "server.session.update";
     return EventNames;
 }({});
 class RealtimeEventHandler {
@@ -38372,7 +38462,8 @@ class RealtimeEventHandler {
         }
     }
     dispatch(eventName, event) {
-        this._log(`dispatch ${eventName} event`);
+        let consoleLog = !(arguments.length > 2) || void 0 === arguments[2] || arguments[2];
+        if (consoleLog) this._log(`dispatch ${eventName} event`);
         const handlers = (this.eventHandlers[eventName] || []).slice();
         this._dispatchToHandlers(eventName, event, handlers);
         const allHandlers = (this.eventHandlers["realtime.event"] || []).slice();
@@ -41641,7 +41732,7 @@ class EngineClient extends RealtimeEventHandler {
         this.engine.on(index_esm_min_index.events.onUserJoined, this.handleUserJoin);
         this.engine.on(index_esm_min_index.events.onUserLeave, this.handleUserLeave);
         this.engine.on(index_esm_min_index.events.onError, this.handleEventError);
-        this.engine.on(index_esm_min_index.events.onPlayerEvent, this.handlePlayerEvent);
+        if (this._isSupportVideo) this.engine.on(index_esm_min_index.events.onPlayerEvent, this.handlePlayerEvent);
         if (this._debug) {
             this.engine.on(index_esm_min_index.events.onLocalAudioPropertiesReport, this.handleLocalAudioPropertiesReport);
             this.engine.on(index_esm_min_index.events.onRemoteAudioPropertiesReport, this.handleRemoteAudioPropertiesReport);
@@ -41652,7 +41743,7 @@ class EngineClient extends RealtimeEventHandler {
         this.engine.off(index_esm_min_index.events.onUserJoined, this.handleUserJoin);
         this.engine.off(index_esm_min_index.events.onUserLeave, this.handleUserLeave);
         this.engine.off(index_esm_min_index.events.onError, this.handleEventError);
-        this.engine.off(index_esm_min_index.events.onPlayerEvent, this.handlePlayerEvent);
+        if (this._isSupportVideo) this.engine.off(index_esm_min_index.events.onPlayerEvent, this.handlePlayerEvent);
         if (this._debug) {
             this.engine.off(index_esm_min_index.events.onLocalAudioPropertiesReport, this.handleLocalAudioPropertiesReport);
             this.engine.off(index_esm_min_index.events.onRemoteAudioPropertiesReport, this.handleRemoteAudioPropertiesReport);
@@ -41697,13 +41788,13 @@ class EngineClient extends RealtimeEventHandler {
         this.dispatch(event_handler_EventNames.PLAYER_EVENT, event);
     }
     async joinRoom(options) {
-        const { token, roomId, uid, audioMutedDefault, videoOnDefault } = options;
+        const { token, roomId, uid, audioMutedDefault, videoOnDefault, isAutoSubscribeAudio } = options;
         try {
             await this.engine.joinRoom(token, roomId, {
                 userId: uid
             }, {
                 isAutoPublish: !audioMutedDefault,
-                isAutoSubscribeAudio: true,
+                isAutoSubscribeAudio,
                 isAutoSubscribeVideo: this._isSupportVideo && videoOnDefault
             });
         } catch (e) {
@@ -41717,14 +41808,18 @@ class EngineClient extends RealtimeEventHandler {
         await this.engine.startAudioCapture(deviceId);
     }
     async setAudioOutputDevice(deviceId) {
-        const devices = await getAudioDevices();
+        const devices = await getAudioDevices({
+            video: false
+        });
         if (-1 === devices.audioOutputs.findIndex((i)=>i.deviceId === deviceId)) throw new RealtimeAPIError(error_RealtimeError.DEVICE_ACCESS_ERROR, `Audio output device not found: ${deviceId}`);
         await this.engine.setAudioPlaybackDevice(deviceId);
     }
     async createLocalStream(userId, videoConfig) {
-        const devices = await getAudioDevices();
-        if (!devices.audioInputs.length) throw new RealtimeAPIError(error_RealtimeError.DEVICE_ACCESS_ERROR, 'Failed to get devices');
-        if (this._isSupportVideo && !devices.videoInputs.length) throw new RealtimeAPIError(error_RealtimeError.DEVICE_ACCESS_ERROR, 'Failed to get devices');
+        const devices = await getAudioDevices({
+            video: this._isSupportVideo
+        });
+        if (!devices.audioInputs.length) throw new RealtimeAPIError(error_RealtimeError.DEVICE_ACCESS_ERROR, 'Failed to get audio devices');
+        if (this._isSupportVideo && !devices.videoInputs.length) throw new RealtimeAPIError(error_RealtimeError.DEVICE_ACCESS_ERROR, 'Failed to get video devices');
         await this.engine.startAudioCapture(devices.audioInputs[0].deviceId);
         if (this._isSupportVideo && (null == videoConfig ? void 0 : videoConfig.videoOnDefault)) await this.engine.startVideoCapture(devices.videoInputs[0].deviceId);
         if (this._isSupportVideo) this.engine.setLocalVideoPlayer(StreamIndex$1.STREAM_INDEX_MAIN, {
@@ -41877,7 +41972,7 @@ class RealtimeClient extends RealtimeEventHandler {
         // Step3 bind engine events
         this._client.bindEngineEvents();
         this._client.on(event_handler_EventNames.ALL, (eventName, data)=>{
-            this.dispatch(eventName, data);
+            this.dispatch(eventName, data, false);
         });
         if (this._config.suppressStationaryNoise) {
             await this._client.enableAudioNoiseReduction();
@@ -41888,14 +41983,15 @@ class RealtimeClient extends RealtimeEventHandler {
             this._client.changeAIAnsExtension(true);
             this.dispatch(event_handler_EventNames.SUPPRESS_NON_STATIONARY_NOISE, {});
         }
-        var _this__config_audioMutedDefault, _this__config_videoConfig_videoOnDefault;
+        var _this__config_audioMutedDefault, _this__config_videoConfig_videoOnDefault, _this__config_isAutoSubscribeAudio;
         // Step4 join room
         await this._client.joinRoom({
             token: roomInfo.token,
             roomId: roomInfo.room_id,
             uid: roomInfo.uid,
             audioMutedDefault: null !== (_this__config_audioMutedDefault = this._config.audioMutedDefault) && void 0 !== _this__config_audioMutedDefault && _this__config_audioMutedDefault,
-            videoOnDefault: null === (_this__config_videoConfig_videoOnDefault = null === (_this__config_videoConfig = this._config.videoConfig) || void 0 === _this__config_videoConfig ? void 0 : _this__config_videoConfig.videoOnDefault) || void 0 === _this__config_videoConfig_videoOnDefault || _this__config_videoConfig_videoOnDefault
+            videoOnDefault: null === (_this__config_videoConfig_videoOnDefault = null === (_this__config_videoConfig = this._config.videoConfig) || void 0 === _this__config_videoConfig ? void 0 : _this__config_videoConfig.videoOnDefault) || void 0 === _this__config_videoConfig_videoOnDefault || _this__config_videoConfig_videoOnDefault,
+            isAutoSubscribeAudio: null === (_this__config_isAutoSubscribeAudio = this._config.isAutoSubscribeAudio) || void 0 === _this__config_isAutoSubscribeAudio || _this__config_isAutoSubscribeAudio
         });
         // Step5 create local stream
         await this._client.createLocalStream(roomInfo.uid, this._config.videoConfig);
@@ -41907,7 +42003,6 @@ class RealtimeClient extends RealtimeEventHandler {
             token: roomInfo.token,
             appId: roomInfo.app_id
         });
-        this._log('dispatch client.connected event');
     }
     /**
    * en: Interrupt the current conversation
@@ -41917,7 +42012,6 @@ class RealtimeClient extends RealtimeEventHandler {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.stop());
         this.dispatch(event_handler_EventNames.INTERRUPTED, {});
-        this._log('dispatch client.interrupted event');
     }
     /**
    * en: Disconnect from the current session
@@ -42039,6 +42133,7 @@ class RealtimeClient extends RealtimeEventHandler {
    *                                       可选，默认是否抑制静态噪声，默认值为 false。
    * @param config.suppressNonStationaryNoise - Optional, suppress non-stationary noise, defaults to false. |
    *                                         可选，默认是否抑制非静态噪声，默认值为 false。
+   * @param config.isAutoSubscribeAudio - Optional, whether to automatically subscribe to bot reply audio streams, defaults to true. |
    */ constructor(config){
         super(config.debug), this._client = null, this.isConnected = false, this._isTestEnv = false, this._isSupportVideo = false;
         this._config = config;

package/dist/types/client.d.ts

@@ -21,6 +21,7 @@ export declare class EngineClient extends RealtimeEventHandler {
         uid: string;
         audioMutedDefault?: boolean;
         videoOnDefault?: boolean;
+        isAutoSubscribeAudio?: boolean;
     }): Promise<void>;
     setAudioInputDevice(deviceId: string): Promise<void>;
     setAudioOutputDevice(deviceId: string): Promise<void>;

package/dist/types/event-handler.d.ts

@@ -88,9 +88,44 @@ export declare enum EventNames {
      * en: Bot left
      * zh: Bot 离开
      */
-    BOT_LEAVE = "server.bot.leave"
+    BOT_LEAVE = "server.bot.leave",
+    /**
+     * en: Audio speech started
+     * zh: 开始说话
+     */
+    AUDIO_AGENT_SPEECH_STARTED = "server.audio.agent.speech_started",
+    /**
+     * en: Audio speech stopped
+     * zh: 停止说话
+     */
+    AUDIO_SPEECH_STOPPED = "server.audio.speech_stopped",
+    /**
+     * en: Server error
+     * zh: 服务端错误
+     */
+    SERVER_ERROR = "server.error",
+    /**
+     * en: User speech started
+     * zh: 用户开始说话
+     */
+    AUDIO_USER_SPEECH_STARTED = "server.audio.user.speech_started",
+    /**
+     * en: User speech stopped
+     * zh: 用户停止说话
+     */
+    AUDIO_USER_SPEECH_STOPPED = "server.audio.user.speech_stopped",
+    /**
+     * en: User successfully enters the room
+     * zh: 用户成功进入房间后，会收到该事件
+     */
+    SESSION_CREATED = "server.session.created",
+    /**
+     * en: Session updated
+     * zh: 会话更新
+     */
+    SESSION_UPDATE = "server.session.update"
 }
-type EventCallback = (eventName: string, event: unknown) => void;
+export type EventCallback = (eventName: string, event: unknown) => void;
 export declare class RealtimeEventHandler {
     private eventHandlers;
     protected _debug: boolean;
@@ -99,7 +134,6 @@ export declare class RealtimeEventHandler {
     on(eventName: string, callback: EventCallback): EventCallback;
     off(eventName: string, callback: EventCallback): void;
     private _dispatchToHandlers;
-    dispatch(eventName: string, event: unknown): void;
+    dispatch(eventName: string, event: unknown, consoleLog?: boolean): void;
     _log(message: string): void;
 }
-export {};

package/dist/types/index.d.ts

@@ -22,6 +22,7 @@ export interface RealtimeClientConfig {
     suppressStationaryNoise?: boolean /** optional, Suppress stationary noise, defaults to false */;
     suppressNonStationaryNoise?: boolean /** optional, Suppress non-stationary noise, defaults to false */;
     videoConfig?: VideoConfig /** optional, Video configuration */;
+    isAutoSubscribeAudio?: boolean /** optional, Whether to automatically subscribe to bot reply audio streams, defaults to true */;
 }
 declare class RealtimeClient extends RealtimeEventHandler {
     private _config;
@@ -59,6 +60,7 @@ declare class RealtimeClient extends RealtimeEventHandler {
      *                                       可选，默认是否抑制静态噪声，默认值为 false。
      * @param config.suppressNonStationaryNoise - Optional, suppress non-stationary noise, defaults to false. |
      *                                         可选，默认是否抑制非静态噪声，默认值为 false。
+     * @param config.isAutoSubscribeAudio - Optional, whether to automatically subscribe to bot reply audio streams, defaults to true. |
      */
     constructor(config: RealtimeClientConfig);
     /**

package/dist/types/utils.d.ts

@@ -16,9 +16,10 @@ export declare const checkPermission: ({ audio, video, }?: {
  * Get audio devices
  * @returns Promise<AudioDevices> Object containing arrays of audio input and output devices
  */
-export declare const getAudioDevices: () => Promise<{
+export declare const getAudioDevices: ({ video, }?: {
+    video?: boolean;
+}) => Promise<{
     audioInputs: MediaDeviceInfo[];
     audioOutputs: MediaDeviceInfo[];
     videoInputs: MediaDeviceInfo[];
-    videoOutputs: MediaDeviceInfo[];
 }>;