@coze/realtime-api 1.0.5 → 1.1.0-beta.2

package/README.md

@@ -56,6 +56,15 @@ const client = new RealtimeClient({
   voiceId: "your_voice_id",           // Optional: Specify voice ID
   conversationId: "conversation_id",   // Optional: For conversation continuity
   debug: true,                        // Optional: Enable debug logging
+  getRoomInfo: async () => {
+    // Customize get room info
+    return {
+      token: "your_token",
+      uid: "your_uid",
+      room_id: "your_room_id",
+      app_id: "your_app_id",
+    };
+  },
   allowPersonalAccessTokenInBrowser: true,  // Optional: Enable PAT token usage in browser
   audioMutedDefault: false,           // Optional: Initial audio state (default: false)
   suppressStationaryNoise: false,     // Optional: Enable stationary noise suppression(default: false)

package/README.zh-CN.md

@@ -56,6 +56,15 @@ const client = new RealtimeClient({
   voiceId: "your_voice_id",           // 可选：指定音色 ID
   conversationId: "conversation_id",   // 可选：用于对话连续性
   debug: true,                        // 可选：启用调试日志
+  getRoomInfo: async () => {
+    // 自定义获取房间信息
+    return {
+      token: "your_token",
+      uid: "your_uid",
+      room_id: "your_room_id",
+      app_id: "your_app_id",
+    };
+  },
   allowPersonalAccessTokenInBrowser: true,  // 可选：在浏览器中启用 PAT 令牌使用
   audioMutedDefault: false,           // 可选：初始音频状态（默认：false）
   suppressStationaryNoise: false,     // 可选：启用静态噪声抑制（默认：false）

package/dist/cjs/index.cjs

@@ -283,7 +283,7 @@ class error_APIError extends CozeError {
     }
 }
 class APIConnectionError extends error_APIError {
-    constructor({ message, cause }){
+    constructor({ message }){
         super(void 0, void 0, message || 'Connection error.', void 0), this.status = void 0;
     // if (cause) {
     //   this.cause = cause;
@@ -358,6 +358,12 @@ const handleAdditionalMessages = (additional_messages)=>null == additional_messa
             ...i,
             content: 'object' == typeof i.content ? JSON.stringify(i.content) : i.content
         }));
+const handleParameters = (parameters)=>{
+    if (parameters) {
+        for (const [key, value] of Object.entries(parameters))if ('object' == typeof value) parameters[key] = JSON.stringify(value);
+    }
+    return parameters;
+};
 class Chat extends APIResource {
     /**
    * Call the Chat API to send messages to a published Coze agent. | 调用此接口发起一次对话，支持添加上下文
@@ -380,6 +386,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -406,6 +416,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -444,6 +458,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: true
         };
         const result = await this._client.post(apiUrl, payload, true, options);
@@ -3518,6 +3536,17 @@ class Runs extends APIResource {
         const response = await this._client.post(apiUrl, params, false, options);
         return response;
     }
+    /**
+   * Get the workflow run history | 工作流异步运行后，查看执行结果
+   * @docs zh: https://www.coze.cn/open/docs/developer_guides/workflow_history
+   * @param workflowId - Required The ID of the workflow. | 必选 工作流 ID。
+   * @param executeId - Required The ID of the workflow execution. | 必选 工作流执行 ID。
+   * @returns WorkflowExecuteHistory[] | 工作流执行历史
+   */ async history(workflowId, executeId, options) {
+        const apiUrl = `/v1/workflows/${workflowId}/run_histories/${executeId}`;
+        const response = await this._client.get(apiUrl, void 0, false, options);
+        return response.data;
+    }
 }
 class WorkflowEvent {
     constructor(id, event, data){
@@ -3679,7 +3708,7 @@ class documents_Documents extends APIResource {
    * @returns ListDocumentData | 知识库文件列表
    */ async list(params, options) {
         const apiUrl = '/open_api/knowledge/document/list';
-        const response = await this._client.get(apiUrl, params, false, mergeConfig(options, {
+        const response = await this._client.post(apiUrl, params, false, mergeConfig(options, {
             headers: documents_documents_headers
         }));
         return response;
@@ -4596,6 +4625,8 @@ class WebSocketAPI {
         });
         this.rws.addEventListener('error', (event)=>{
             var _event_target__req_res, _event_target__req, _event_target, _event_target__req_res1, _event_target__req1, _event_target1, _this_onerror, _this;
+            const { readyState } = this.rws;
+            if (3 === readyState) return;
             const statusCode = null === (_event_target = event.target) || void 0 === _event_target ? void 0 : null === (_event_target__req = _event_target._req) || void 0 === _event_target__req ? void 0 : null === (_event_target__req_res = _event_target__req.res) || void 0 === _event_target__req_res ? void 0 : _event_target__req_res.statusCode;
             const rawHeaders = (null === (_event_target1 = event.target) || void 0 === _event_target1 ? void 0 : null === (_event_target__req1 = _event_target1._req) || void 0 === _event_target__req1 ? void 0 : null === (_event_target__req_res1 = _event_target__req1.res) || void 0 === _event_target__req_res1 ? void 0 : _event_target__req_res1.rawHeaders) || [];
             const logidIndex = rawHeaders.findIndex((header)=>'X-Tt-Logid' === header);
@@ -4619,7 +4650,8 @@ class WebSocketAPI {
                 error.data.msg = 'Forbidden';
             } else {
                 error.data.code = 500;
-                error.data.msg = String(null == event ? void 0 : event.error) || 'WebSocket error';
+                var _event_error;
+                error.data.msg = String(null !== (_event_error = null == event ? void 0 : event.error) && void 0 !== _event_error ? _event_error : '') || 'WebSocket error';
             }
             null === (_this_onerror = (_this = this).onerror) || void 0 === _this_onerror || _this_onerror.call(_this, error, event);
         });
@@ -4628,7 +4660,7 @@ class WebSocketAPI {
 // EXTERNAL MODULE: os (ignored)
 var os_ignored_ = __webpack_require__("?9050");
 var os_ignored_default = /*#__PURE__*/ __webpack_require__.n(os_ignored_);
-var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.20","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":{".":"./src/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","ws":"^8.11.0"},"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/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"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","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
+var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.1.0-beta.6","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>","exports":{".":"./src/index.ts","./ws-tools":"./src/ws-tools/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"typesVersions":{"*":{".":["dist/types/index.d.ts"],"ws-tools":["dist/types/ws-tools/ws-tools/index.d.ts"]}},"files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","uuid":"^10.0.0","ws":"^8.11.0"},"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/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"},"./ws-tools":{"require":"./dist/cjs/ws-tools/index.cjs","import":"./dist/esm/ws-tools/index.js","types":"./dist/types/ws-tools/ws-tools/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
 const { version: version_version } = package_namespaceObject;
 const getEnv = ()=>{
     const nodeVersion = process.version.slice(1); // Remove 'v' prefix
@@ -39477,6 +39509,10 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * zh: 客户端连接
    */ EventNames["CONNECTED"] = "client.connected";
     /**
+   * en: Client connecting
+   * zh: 客户端连接中
+   */ EventNames["CONNECTING"] = "client.connecting";
+    /**
    * en: Client interrupted
    * zh: 客户端中断
    */ EventNames["INTERRUPTED"] = "client.interrupted";
@@ -39529,6 +39565,10 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * zh: 视频输入设备改变
    */ EventNames["VIDEO_INPUT_DEVICE_CHANGED"] = "client.video.input.device.changed";
     /**
+   * en: Network quality changed
+   * zh: 网络质量改变
+   */ EventNames["NETWORK_QUALITY"] = "client.network.quality";
+    /**
    * en: Bot joined
    * zh: Bot 加入
    */ EventNames["BOT_JOIN"] = "server.bot.join";
@@ -39543,7 +39583,7 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
     /**
    * en: Audio speech stopped
    * zh: 停止说话
-   */ EventNames["AUDIO_SPEECH_STOPPED"] = "server.audio.speech_stopped";
+   */ EventNames["AUDIO_AGENT_SPEECH_STOPPED"] = "server.audio.agent.speech_stopped";
     /**
    * en: Server error
    * zh: 服务端错误
@@ -39581,7 +39621,10 @@ class RealtimeEventHandler {
         const handlers = this.eventHandlers[eventName] || [];
         if (callback) {
             const index = handlers.indexOf(callback);
-            if (-1 === index) throw new RealtimeAPIError(error_RealtimeError.EVENT_HANDLER_ERROR, `Could not turn off specified event listener for "${eventName}": not found as a listener`);
+            if (-1 === index) {
+                console.warn(`Could not turn off specified event listener for "${eventName}": not found as a listener`);
+                return;
+            }
             handlers.splice(index, 1);
         } else delete this.eventHandlers[eventName];
     }
@@ -39595,7 +39638,7 @@ class RealtimeEventHandler {
     }
     dispatch(eventName, event) {
         let consoleLog = !(arguments.length > 2) || void 0 === arguments[2] || arguments[2];
-        if (consoleLog) this._log(`dispatch ${eventName} event`);
+        if (consoleLog) this._log(`dispatch ${eventName} event`, event);
         const handlers = (this.eventHandlers[eventName] || []).slice();
         this._dispatchToHandlers(eventName, event, handlers);
         const allHandlers = (this.eventHandlers["realtime.event"] || []).slice();
@@ -39605,8 +39648,8 @@ class RealtimeEventHandler {
         const allServerHandlers = (this.eventHandlers["server.*"] || []).slice();
         this._dispatchToHandlers(eventName, event, allServerHandlers, 'server.');
     }
-    _log(message) {
-        if (this._debug) console.log(`[RealtimeClient] ${message}`);
+    _log(message, event) {
+        if (this._debug) console.log(`[RealtimeClient] ${message}`, event);
     }
     constructor(debug = false){
         this.eventHandlers = {};
@@ -42864,6 +42907,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.onNetworkQuality, this.handleNetworkQuality);
         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);
@@ -42875,6 +42919,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.onNetworkQuality, this.handleNetworkQuality);
         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);
@@ -42919,6 +42964,12 @@ class EngineClient extends RealtimeEventHandler {
     handlePlayerEvent(event) {
         this.dispatch(event_handler_EventNames.PLAYER_EVENT, event);
     }
+    handleNetworkQuality(uplinkNetworkQuality, downlinkNetworkQuality) {
+        this.dispatch(event_handler_EventNames.NETWORK_QUALITY, {
+            uplinkNetworkQuality,
+            downlinkNetworkQuality
+        });
+    }
     async joinRoom(options) {
         const { token, roomId, uid, audioMutedDefault, videoOnDefault, isAutoSubscribeAudio } = options;
         try {
@@ -42985,11 +43036,10 @@ class EngineClient extends RealtimeEventHandler {
     }
     async disconnect() {
         try {
-            if (this._isSupportVideo) await this.changeVideoState(false);
-            await this.changeAudioState(false);
-            await this.engine.unpublishStream(MediaType$1.AUDIO);
             await this.engine.leaveRoom();
             this.removeEventListener();
+            this.clearEventHandlers();
+            index_esm_min_index.destroyEngine(this.engine);
         } catch (e) {
             this.dispatch(event_handler_EventNames.ERROR, e);
             throw e;
@@ -43110,6 +43160,7 @@ class EngineClient extends RealtimeEventHandler {
         this.handleUserLeave = this.handleUserLeave.bind(this);
         this.handleEventError = this.handleEventError.bind(this);
         this.handlePlayerEvent = this.handlePlayerEvent.bind(this);
+        this.handleNetworkQuality = this.handleNetworkQuality.bind(this);
         // Debug only
         this.handleLocalAudioPropertiesReport = this.handleLocalAudioPropertiesReport.bind(this);
         this.handleRemoteAudioPropertiesReport = this.handleRemoteAudioPropertiesReport.bind(this);
@@ -43117,6 +43168,8 @@ class EngineClient extends RealtimeEventHandler {
         this._videoConfig = videoConfig;
     }
 }
+// Only use for test
+const TEST_APP_ID = '6705332c79516e015e3e5f0c';
 class RealtimeClient extends RealtimeEventHandler {
     /**
    * en: Establish a connection to the Coze API and join the room
@@ -43124,22 +43177,38 @@ class RealtimeClient extends RealtimeEventHandler {
    * zh: 建立与 Coze API 的连接并加入房间
    */ async connect() {
         var _this__config_videoConfig;
-        const { botId, conversationId, voiceId } = this._config;
+        const { botId, conversationId, voiceId, getRoomInfo } = this._config;
+        this.dispatch(event_handler_EventNames.CONNECTING, {});
         let roomInfo;
         try {
             // Step1 get token
-            roomInfo = await this._api.audio.rooms.create({
-                bot_id: botId,
-                conversation_id: conversationId || void 0,
-                voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
-                connector_id: this._config.connectorId,
-                uid: this._config.userId || void 0,
-                workflow_id: this._config.workflowId || void 0
-            });
+            if (getRoomInfo) roomInfo = await getRoomInfo();
+            else {
+                let config;
+                if (this._config.videoConfig) config = isScreenShareDevice(this._config.videoConfig.videoInputDeviceId) ? {
+                    video_config: {
+                        stream_video_type: 'screen'
+                    }
+                } : {
+                    video_config: {
+                        stream_video_type: 'main'
+                    }
+                };
+                roomInfo = await this._api.audio.rooms.create({
+                    bot_id: botId,
+                    conversation_id: conversationId || void 0,
+                    voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
+                    connector_id: this._config.connectorId,
+                    uid: this._config.userId || void 0,
+                    workflow_id: this._config.workflowId || void 0,
+                    config
+                });
+            }
         } catch (error) {
             this.dispatch(event_handler_EventNames.ERROR, error);
             throw new RealtimeAPIError(error_RealtimeError.CREATE_ROOM_ERROR, error instanceof Error ? error.message : 'Unknown error', error);
         }
+        this._isTestEnv = TEST_APP_ID === roomInfo.app_id;
         // Step2 create engine
         this._client = new EngineClient(roomInfo.app_id, this._config.debug, this._isTestEnv, this._isSupportVideo, this._config.videoConfig);
         // Step3 bind engine events
@@ -43194,6 +43263,7 @@ class RealtimeClient extends RealtimeEventHandler {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.disconnect());
         this.isConnected = false;
+        this._client = null;
         this.dispatch(event_handler_EventNames.DISCONNECTED, {});
     }
     /**
@@ -43346,7 +43416,6 @@ class RealtimeClient extends RealtimeEventHandler {
             baseURL: defaultBaseURL,
             allowPersonalAccessTokenInBrowser: this._config.allowPersonalAccessTokenInBrowser
         });
-        this._isTestEnv = 'https://api.coze.cn' !== defaultBaseURL;
         this._isSupportVideo = !!config.videoConfig;
     }
 }

package/dist/esm/index.js

@@ -271,7 +271,7 @@ class error_APIError extends CozeError {
     }
 }
 class APIConnectionError extends error_APIError {
-    constructor({ message, cause }){
+    constructor({ message }){
         super(void 0, void 0, message || 'Connection error.', void 0), this.status = void 0;
     // if (cause) {
     //   this.cause = cause;
@@ -346,6 +346,12 @@ const handleAdditionalMessages = (additional_messages)=>null == additional_messa
             ...i,
             content: 'object' == typeof i.content ? JSON.stringify(i.content) : i.content
         }));
+const handleParameters = (parameters)=>{
+    if (parameters) {
+        for (const [key, value] of Object.entries(parameters))if ('object' == typeof value) parameters[key] = JSON.stringify(value);
+    }
+    return parameters;
+};
 class Chat extends APIResource {
     /**
    * Call the Chat API to send messages to a published Coze agent. | 调用此接口发起一次对话，支持添加上下文
@@ -368,6 +374,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -394,6 +404,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -432,6 +446,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: true
         };
         const result = await this._client.post(apiUrl, payload, true, options);
@@ -3506,6 +3524,17 @@ class Runs extends APIResource {
         const response = await this._client.post(apiUrl, params, false, options);
         return response;
     }
+    /**
+   * Get the workflow run history | 工作流异步运行后，查看执行结果
+   * @docs zh: https://www.coze.cn/open/docs/developer_guides/workflow_history
+   * @param workflowId - Required The ID of the workflow. | 必选 工作流 ID。
+   * @param executeId - Required The ID of the workflow execution. | 必选 工作流执行 ID。
+   * @returns WorkflowExecuteHistory[] | 工作流执行历史
+   */ async history(workflowId, executeId, options) {
+        const apiUrl = `/v1/workflows/${workflowId}/run_histories/${executeId}`;
+        const response = await this._client.get(apiUrl, void 0, false, options);
+        return response.data;
+    }
 }
 class WorkflowEvent {
     constructor(id, event, data){
@@ -3667,7 +3696,7 @@ class documents_Documents extends APIResource {
    * @returns ListDocumentData | 知识库文件列表
    */ async list(params, options) {
         const apiUrl = '/open_api/knowledge/document/list';
-        const response = await this._client.get(apiUrl, params, false, mergeConfig(options, {
+        const response = await this._client.post(apiUrl, params, false, mergeConfig(options, {
             headers: documents_documents_headers
         }));
         return response;
@@ -4584,6 +4613,8 @@ class WebSocketAPI {
         });
         this.rws.addEventListener('error', (event)=>{
             var _event_target__req_res, _event_target__req, _event_target, _event_target__req_res1, _event_target__req1, _event_target1, _this_onerror, _this;
+            const { readyState } = this.rws;
+            if (3 === readyState) return;
             const statusCode = null === (_event_target = event.target) || void 0 === _event_target ? void 0 : null === (_event_target__req = _event_target._req) || void 0 === _event_target__req ? void 0 : null === (_event_target__req_res = _event_target__req.res) || void 0 === _event_target__req_res ? void 0 : _event_target__req_res.statusCode;
             const rawHeaders = (null === (_event_target1 = event.target) || void 0 === _event_target1 ? void 0 : null === (_event_target__req1 = _event_target1._req) || void 0 === _event_target__req1 ? void 0 : null === (_event_target__req_res1 = _event_target__req1.res) || void 0 === _event_target__req_res1 ? void 0 : _event_target__req_res1.rawHeaders) || [];
             const logidIndex = rawHeaders.findIndex((header)=>'X-Tt-Logid' === header);
@@ -4607,7 +4638,8 @@ class WebSocketAPI {
                 error.data.msg = 'Forbidden';
             } else {
                 error.data.code = 500;
-                error.data.msg = String(null == event ? void 0 : event.error) || 'WebSocket error';
+                var _event_error;
+                error.data.msg = String(null !== (_event_error = null == event ? void 0 : event.error) && void 0 !== _event_error ? _event_error : '') || 'WebSocket error';
             }
             null === (_this_onerror = (_this = this).onerror) || void 0 === _this_onerror || _this_onerror.call(_this, error, event);
         });
@@ -4616,7 +4648,7 @@ class WebSocketAPI {
 // EXTERNAL MODULE: os (ignored)
 var os_ignored_ = __webpack_require__("?9050");
 var os_ignored_default = /*#__PURE__*/ __webpack_require__.n(os_ignored_);
-var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.20","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":{".":"./src/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","ws":"^8.11.0"},"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/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"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","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
+var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.1.0-beta.6","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>","exports":{".":"./src/index.ts","./ws-tools":"./src/ws-tools/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"typesVersions":{"*":{".":["dist/types/index.d.ts"],"ws-tools":["dist/types/ws-tools/ws-tools/index.d.ts"]}},"files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","uuid":"^10.0.0","ws":"^8.11.0"},"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/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"},"./ws-tools":{"require":"./dist/cjs/ws-tools/index.cjs","import":"./dist/esm/ws-tools/index.js","types":"./dist/types/ws-tools/ws-tools/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
 const { version: version_version } = package_namespaceObject;
 const getEnv = ()=>{
     const nodeVersion = process.version.slice(1); // Remove 'v' prefix
@@ -39465,6 +39497,10 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * zh: 客户端连接
    */ EventNames["CONNECTED"] = "client.connected";
     /**
+   * en: Client connecting
+   * zh: 客户端连接中
+   */ EventNames["CONNECTING"] = "client.connecting";
+    /**
    * en: Client interrupted
    * zh: 客户端中断
    */ EventNames["INTERRUPTED"] = "client.interrupted";
@@ -39517,6 +39553,10 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * zh: 视频输入设备改变
    */ EventNames["VIDEO_INPUT_DEVICE_CHANGED"] = "client.video.input.device.changed";
     /**
+   * en: Network quality changed
+   * zh: 网络质量改变
+   */ EventNames["NETWORK_QUALITY"] = "client.network.quality";
+    /**
    * en: Bot joined
    * zh: Bot 加入
    */ EventNames["BOT_JOIN"] = "server.bot.join";
@@ -39531,7 +39571,7 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
     /**
    * en: Audio speech stopped
    * zh: 停止说话
-   */ EventNames["AUDIO_SPEECH_STOPPED"] = "server.audio.speech_stopped";
+   */ EventNames["AUDIO_AGENT_SPEECH_STOPPED"] = "server.audio.agent.speech_stopped";
     /**
    * en: Server error
    * zh: 服务端错误
@@ -39569,7 +39609,10 @@ class RealtimeEventHandler {
         const handlers = this.eventHandlers[eventName] || [];
         if (callback) {
             const index = handlers.indexOf(callback);
-            if (-1 === index) throw new RealtimeAPIError(error_RealtimeError.EVENT_HANDLER_ERROR, `Could not turn off specified event listener for "${eventName}": not found as a listener`);
+            if (-1 === index) {
+                console.warn(`Could not turn off specified event listener for "${eventName}": not found as a listener`);
+                return;
+            }
             handlers.splice(index, 1);
         } else delete this.eventHandlers[eventName];
     }
@@ -39583,7 +39626,7 @@ class RealtimeEventHandler {
     }
     dispatch(eventName, event) {
         let consoleLog = !(arguments.length > 2) || void 0 === arguments[2] || arguments[2];
-        if (consoleLog) this._log(`dispatch ${eventName} event`);
+        if (consoleLog) this._log(`dispatch ${eventName} event`, event);
         const handlers = (this.eventHandlers[eventName] || []).slice();
         this._dispatchToHandlers(eventName, event, handlers);
         const allHandlers = (this.eventHandlers["realtime.event"] || []).slice();
@@ -39593,8 +39636,8 @@ class RealtimeEventHandler {
         const allServerHandlers = (this.eventHandlers["server.*"] || []).slice();
         this._dispatchToHandlers(eventName, event, allServerHandlers, 'server.');
     }
-    _log(message) {
-        if (this._debug) console.log(`[RealtimeClient] ${message}`);
+    _log(message, event) {
+        if (this._debug) console.log(`[RealtimeClient] ${message}`, event);
     }
     constructor(debug = false){
         this.eventHandlers = {};
@@ -42852,6 +42895,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.onNetworkQuality, this.handleNetworkQuality);
         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);
@@ -42863,6 +42907,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.onNetworkQuality, this.handleNetworkQuality);
         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);
@@ -42907,6 +42952,12 @@ class EngineClient extends RealtimeEventHandler {
     handlePlayerEvent(event) {
         this.dispatch(event_handler_EventNames.PLAYER_EVENT, event);
     }
+    handleNetworkQuality(uplinkNetworkQuality, downlinkNetworkQuality) {
+        this.dispatch(event_handler_EventNames.NETWORK_QUALITY, {
+            uplinkNetworkQuality,
+            downlinkNetworkQuality
+        });
+    }
     async joinRoom(options) {
         const { token, roomId, uid, audioMutedDefault, videoOnDefault, isAutoSubscribeAudio } = options;
         try {
@@ -42973,11 +43024,10 @@ class EngineClient extends RealtimeEventHandler {
     }
     async disconnect() {
         try {
-            if (this._isSupportVideo) await this.changeVideoState(false);
-            await this.changeAudioState(false);
-            await this.engine.unpublishStream(MediaType$1.AUDIO);
             await this.engine.leaveRoom();
             this.removeEventListener();
+            this.clearEventHandlers();
+            index_esm_min_index.destroyEngine(this.engine);
         } catch (e) {
             this.dispatch(event_handler_EventNames.ERROR, e);
             throw e;
@@ -43098,6 +43148,7 @@ class EngineClient extends RealtimeEventHandler {
         this.handleUserLeave = this.handleUserLeave.bind(this);
         this.handleEventError = this.handleEventError.bind(this);
         this.handlePlayerEvent = this.handlePlayerEvent.bind(this);
+        this.handleNetworkQuality = this.handleNetworkQuality.bind(this);
         // Debug only
         this.handleLocalAudioPropertiesReport = this.handleLocalAudioPropertiesReport.bind(this);
         this.handleRemoteAudioPropertiesReport = this.handleRemoteAudioPropertiesReport.bind(this);
@@ -43105,6 +43156,8 @@ class EngineClient extends RealtimeEventHandler {
         this._videoConfig = videoConfig;
     }
 }
+// Only use for test
+const TEST_APP_ID = '6705332c79516e015e3e5f0c';
 class RealtimeClient extends RealtimeEventHandler {
     /**
    * en: Establish a connection to the Coze API and join the room
@@ -43112,22 +43165,38 @@ class RealtimeClient extends RealtimeEventHandler {
    * zh: 建立与 Coze API 的连接并加入房间
    */ async connect() {
         var _this__config_videoConfig;
-        const { botId, conversationId, voiceId } = this._config;
+        const { botId, conversationId, voiceId, getRoomInfo } = this._config;
+        this.dispatch(event_handler_EventNames.CONNECTING, {});
         let roomInfo;
         try {
             // Step1 get token
-            roomInfo = await this._api.audio.rooms.create({
-                bot_id: botId,
-                conversation_id: conversationId || void 0,
-                voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
-                connector_id: this._config.connectorId,
-                uid: this._config.userId || void 0,
-                workflow_id: this._config.workflowId || void 0
-            });
+            if (getRoomInfo) roomInfo = await getRoomInfo();
+            else {
+                let config;
+                if (this._config.videoConfig) config = isScreenShareDevice(this._config.videoConfig.videoInputDeviceId) ? {
+                    video_config: {
+                        stream_video_type: 'screen'
+                    }
+                } : {
+                    video_config: {
+                        stream_video_type: 'main'
+                    }
+                };
+                roomInfo = await this._api.audio.rooms.create({
+                    bot_id: botId,
+                    conversation_id: conversationId || void 0,
+                    voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
+                    connector_id: this._config.connectorId,
+                    uid: this._config.userId || void 0,
+                    workflow_id: this._config.workflowId || void 0,
+                    config
+                });
+            }
         } catch (error) {
             this.dispatch(event_handler_EventNames.ERROR, error);
             throw new RealtimeAPIError(error_RealtimeError.CREATE_ROOM_ERROR, error instanceof Error ? error.message : 'Unknown error', error);
         }
+        this._isTestEnv = TEST_APP_ID === roomInfo.app_id;
         // Step2 create engine
         this._client = new EngineClient(roomInfo.app_id, this._config.debug, this._isTestEnv, this._isSupportVideo, this._config.videoConfig);
         // Step3 bind engine events
@@ -43182,6 +43251,7 @@ class RealtimeClient extends RealtimeEventHandler {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.disconnect());
         this.isConnected = false;
+        this._client = null;
         this.dispatch(event_handler_EventNames.DISCONNECTED, {});
     }
     /**
@@ -43334,7 +43404,6 @@ class RealtimeClient extends RealtimeEventHandler {
             baseURL: defaultBaseURL,
             allowPersonalAccessTokenInBrowser: this._config.allowPersonalAccessTokenInBrowser
         });
-        this._isTestEnv = 'https://api.coze.cn' !== defaultBaseURL;
         this._isSupportVideo = !!config.videoConfig;
     }
 }

package/dist/types/client.d.ts

@@ -1,4 +1,4 @@
-import { type AudioPropertiesConfig, type IRTCEngine, type onUserJoinedEvent, type onUserLeaveEvent, type UserMessageEvent } from '@volcengine/rtc';
+import { type AudioPropertiesConfig, type IRTCEngine, type NetworkQuality, type onUserJoinedEvent, type onUserLeaveEvent, type UserMessageEvent } from '@volcengine/rtc';
 import { RealtimeEventHandler } from './event-handler';
 import { type VideoConfig } from '.';
 export declare class EngineClient extends RealtimeEventHandler {
@@ -18,6 +18,7 @@ export declare class EngineClient extends RealtimeEventHandler {
     handleUserJoin(event: onUserJoinedEvent): void;
     handleUserLeave(event: onUserLeaveEvent): void;
     handlePlayerEvent(event: unknown): void;
+    handleNetworkQuality(uplinkNetworkQuality: NetworkQuality, downlinkNetworkQuality: NetworkQuality): void;
     joinRoom(options: {
         token: string;
         roomId: string;

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

@@ -19,6 +19,11 @@ export declare enum EventNames {
      * zh: 客户端连接
      */
     CONNECTED = "client.connected",
+    /**
+     * en: Client connecting
+     * zh: 客户端连接中
+     */
+    CONNECTING = "client.connecting",
     /**
      * en: Client interrupted
      * zh: 客户端中断
@@ -84,6 +89,11 @@ export declare enum EventNames {
      * zh: 视频输入设备改变
      */
     VIDEO_INPUT_DEVICE_CHANGED = "client.video.input.device.changed",
+    /**
+     * en: Network quality changed
+     * zh: 网络质量改变
+     */
+    NETWORK_QUALITY = "client.network.quality",
     /**
      * en: Bot joined
      * zh: Bot 加入
@@ -103,7 +113,7 @@ export declare enum EventNames {
      * en: Audio speech stopped
      * zh: 停止说话
      */
-    AUDIO_SPEECH_STOPPED = "server.audio.speech_stopped",
+    AUDIO_AGENT_SPEECH_STOPPED = "server.audio.agent.speech_stopped",
     /**
      * en: Server error
      * zh: 服务端错误
@@ -140,5 +150,5 @@ export declare class RealtimeEventHandler {
     off(eventName: string, callback: EventCallback): void;
     private _dispatchToHandlers;
     dispatch(eventName: string, event: unknown, consoleLog?: boolean): void;
-    _log(message: string): void;
+    _log(message: string, event?: unknown): void;
 }

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 import { type ScreenConfig, type AudioPropertiesConfig, type IRTCEngine } from '@volcengine/rtc';
-import { type GetToken } from '@coze/api';
+import { type CreateRoomData, type GetToken } from '@coze/api';
 import * as RealtimeUtils from './utils';
 import { RealtimeEventHandler, EventNames } from './event-handler';
 import { RealtimeAPIError, RealtimeError } from './error';
@@ -18,6 +18,7 @@ export interface RealtimeClientConfig {
     workflowId?: string /** optional, Workflow Id */;
     baseURL?: string /** optional, defaults to "https://api.coze.cn" */;
     debug?: boolean /** optional, defaults to false */;
+    getRoomInfo?: () => Promise<CreateRoomData> /** optional, Customize get room info */;
     /** Whether Personal Access Tokens (PAT) are allowed in browser environments */
     allowPersonalAccessTokenInBrowser?: boolean;
     /** Whether to mute by default, defaults to false
@@ -30,7 +31,7 @@ export interface RealtimeClientConfig {
     isAutoSubscribeAudio?: boolean /** optional, Whether to automatically subscribe to bot reply audio streams, defaults to true */;
 }
 declare class RealtimeClient extends RealtimeEventHandler {
-    private _config;
+    _config: RealtimeClientConfig;
     private _client;
     isConnected: boolean;
     private _api;

package/dist/umd/index.js

@@ -289,7 +289,7 @@
             }
         }
         class APIConnectionError extends error_APIError {
-            constructor({ message, cause }){
+            constructor({ message }){
                 super(void 0, void 0, message || 'Connection error.', void 0), this.status = void 0;
             // if (cause) {
             //   this.cause = cause;
@@ -364,6 +364,12 @@
                     ...i,
                     content: 'object' == typeof i.content ? JSON.stringify(i.content) : i.content
                 }));
+        const handleParameters = (parameters)=>{
+            if (parameters) {
+                for (const [key, value] of Object.entries(parameters))if ('object' == typeof value) parameters[key] = JSON.stringify(value);
+            }
+            return parameters;
+        };
         class Chat extends APIResource {
             /**
    * Call the Chat API to send messages to a published Coze agent. | 调用此接口发起一次对话，支持添加上下文
@@ -386,6 +392,10 @@
                 const payload = {
                     ...rest,
                     additional_messages: handleAdditionalMessages(params.additional_messages),
+                    shortcut_command: params.shortcut_command ? {
+                        ...params.shortcut_command,
+                        parameters: handleParameters(params.shortcut_command.parameters)
+                    } : void 0,
                     stream: false
                 };
                 const result = await this._client.post(apiUrl, payload, false, options);
@@ -412,6 +422,10 @@
                 const payload = {
                     ...rest,
                     additional_messages: handleAdditionalMessages(params.additional_messages),
+                    shortcut_command: params.shortcut_command ? {
+                        ...params.shortcut_command,
+                        parameters: handleParameters(params.shortcut_command.parameters)
+                    } : void 0,
                     stream: false
                 };
                 const result = await this._client.post(apiUrl, payload, false, options);
@@ -450,6 +464,10 @@
                 const payload = {
                     ...rest,
                     additional_messages: handleAdditionalMessages(params.additional_messages),
+                    shortcut_command: params.shortcut_command ? {
+                        ...params.shortcut_command,
+                        parameters: handleParameters(params.shortcut_command.parameters)
+                    } : void 0,
                     stream: true
                 };
                 const result = await this._client.post(apiUrl, payload, true, options);
@@ -3524,6 +3542,17 @@
                 const response = await this._client.post(apiUrl, params, false, options);
                 return response;
             }
+            /**
+   * Get the workflow run history | 工作流异步运行后，查看执行结果
+   * @docs zh: https://www.coze.cn/open/docs/developer_guides/workflow_history
+   * @param workflowId - Required The ID of the workflow. | 必选 工作流 ID。
+   * @param executeId - Required The ID of the workflow execution. | 必选 工作流执行 ID。
+   * @returns WorkflowExecuteHistory[] | 工作流执行历史
+   */ async history(workflowId, executeId, options) {
+                const apiUrl = `/v1/workflows/${workflowId}/run_histories/${executeId}`;
+                const response = await this._client.get(apiUrl, void 0, false, options);
+                return response.data;
+            }
         }
         class WorkflowEvent {
             constructor(id, event, data){
@@ -3685,7 +3714,7 @@
    * @returns ListDocumentData | 知识库文件列表
    */ async list(params, options) {
                 const apiUrl = '/open_api/knowledge/document/list';
-                const response = await this._client.get(apiUrl, params, false, mergeConfig(options, {
+                const response = await this._client.post(apiUrl, params, false, mergeConfig(options, {
                     headers: documents_documents_headers
                 }));
                 return response;
@@ -4602,6 +4631,8 @@ and limitations under the License.
                 });
                 this.rws.addEventListener('error', (event)=>{
                     var _event_target__req_res, _event_target__req, _event_target, _event_target__req_res1, _event_target__req1, _event_target1, _this_onerror, _this;
+                    const { readyState } = this.rws;
+                    if (3 === readyState) return;
                     const statusCode = null === (_event_target = event.target) || void 0 === _event_target ? void 0 : null === (_event_target__req = _event_target._req) || void 0 === _event_target__req ? void 0 : null === (_event_target__req_res = _event_target__req.res) || void 0 === _event_target__req_res ? void 0 : _event_target__req_res.statusCode;
                     const rawHeaders = (null === (_event_target1 = event.target) || void 0 === _event_target1 ? void 0 : null === (_event_target__req1 = _event_target1._req) || void 0 === _event_target__req1 ? void 0 : null === (_event_target__req_res1 = _event_target__req1.res) || void 0 === _event_target__req_res1 ? void 0 : _event_target__req_res1.rawHeaders) || [];
                     const logidIndex = rawHeaders.findIndex((header)=>'X-Tt-Logid' === header);
@@ -4625,7 +4656,8 @@ and limitations under the License.
                         error.data.msg = 'Forbidden';
                     } else {
                         error.data.code = 500;
-                        error.data.msg = String(null == event ? void 0 : event.error) || 'WebSocket error';
+                        var _event_error;
+                        error.data.msg = String(null !== (_event_error = null == event ? void 0 : event.error) && void 0 !== _event_error ? _event_error : '') || 'WebSocket error';
                     }
                     null === (_this_onerror = (_this = this).onerror) || void 0 === _this_onerror || _this_onerror.call(_this, error, event);
                 });
@@ -4634,7 +4666,7 @@ and limitations under the License.
         // EXTERNAL MODULE: os (ignored)
         var os_ignored_ = __webpack_require__("?9050");
         var os_ignored_default = /*#__PURE__*/ __webpack_require__.n(os_ignored_);
-        var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.20","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":{".":"./src/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","ws":"^8.11.0"},"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/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"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","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
+        var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.1.0-beta.6","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>","exports":{".":"./src/index.ts","./ws-tools":"./src/ws-tools/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"typesVersions":{"*":{".":["dist/types/index.d.ts"],"ws-tools":["dist/types/ws-tools/ws-tools/index.d.ts"]}},"files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","uuid":"^10.0.0","ws":"^8.11.0"},"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/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"},"./ws-tools":{"require":"./dist/cjs/ws-tools/index.cjs","import":"./dist/esm/ws-tools/index.js","types":"./dist/types/ws-tools/ws-tools/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
         const { version: version_version } = package_namespaceObject;
         const getEnv = ()=>{
             const nodeVersion = process.version.slice(1); // Remove 'v' prefix
@@ -39483,6 +39515,10 @@ and limitations under the License.
    * zh: 客户端连接
    */ EventNames["CONNECTED"] = "client.connected";
             /**
+   * en: Client connecting
+   * zh: 客户端连接中
+   */ EventNames["CONNECTING"] = "client.connecting";
+            /**
    * en: Client interrupted
    * zh: 客户端中断
    */ EventNames["INTERRUPTED"] = "client.interrupted";
@@ -39535,6 +39571,10 @@ and limitations under the License.
    * zh: 视频输入设备改变
    */ EventNames["VIDEO_INPUT_DEVICE_CHANGED"] = "client.video.input.device.changed";
             /**
+   * en: Network quality changed
+   * zh: 网络质量改变
+   */ EventNames["NETWORK_QUALITY"] = "client.network.quality";
+            /**
    * en: Bot joined
    * zh: Bot 加入
    */ EventNames["BOT_JOIN"] = "server.bot.join";
@@ -39549,7 +39589,7 @@ and limitations under the License.
             /**
    * en: Audio speech stopped
    * zh: 停止说话
-   */ EventNames["AUDIO_SPEECH_STOPPED"] = "server.audio.speech_stopped";
+   */ EventNames["AUDIO_AGENT_SPEECH_STOPPED"] = "server.audio.agent.speech_stopped";
             /**
    * en: Server error
    * zh: 服务端错误
@@ -39587,7 +39627,10 @@ and limitations under the License.
                 const handlers = this.eventHandlers[eventName] || [];
                 if (callback) {
                     const index = handlers.indexOf(callback);
-                    if (-1 === index) throw new RealtimeAPIError(error_RealtimeError.EVENT_HANDLER_ERROR, `Could not turn off specified event listener for "${eventName}": not found as a listener`);
+                    if (-1 === index) {
+                        console.warn(`Could not turn off specified event listener for "${eventName}": not found as a listener`);
+                        return;
+                    }
                     handlers.splice(index, 1);
                 } else delete this.eventHandlers[eventName];
             }
@@ -39601,7 +39644,7 @@ and limitations under the License.
             }
             dispatch(eventName, event) {
                 let consoleLog = !(arguments.length > 2) || void 0 === arguments[2] || arguments[2];
-                if (consoleLog) this._log(`dispatch ${eventName} event`);
+                if (consoleLog) this._log(`dispatch ${eventName} event`, event);
                 const handlers = (this.eventHandlers[eventName] || []).slice();
                 this._dispatchToHandlers(eventName, event, handlers);
                 const allHandlers = (this.eventHandlers["realtime.event"] || []).slice();
@@ -39611,8 +39654,8 @@ and limitations under the License.
                 const allServerHandlers = (this.eventHandlers["server.*"] || []).slice();
                 this._dispatchToHandlers(eventName, event, allServerHandlers, 'server.');
             }
-            _log(message) {
-                if (this._debug) console.log(`[RealtimeClient] ${message}`);
+            _log(message, event) {
+                if (this._debug) console.log(`[RealtimeClient] ${message}`, event);
             }
             constructor(debug = false){
                 this.eventHandlers = {};
@@ -42870,6 +42913,7 @@ and limitations under the License.
                 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.onNetworkQuality, this.handleNetworkQuality);
                 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);
@@ -42881,6 +42925,7 @@ and limitations under the License.
                 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.onNetworkQuality, this.handleNetworkQuality);
                 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);
@@ -42925,6 +42970,12 @@ and limitations under the License.
             handlePlayerEvent(event) {
                 this.dispatch(event_handler_EventNames.PLAYER_EVENT, event);
             }
+            handleNetworkQuality(uplinkNetworkQuality, downlinkNetworkQuality) {
+                this.dispatch(event_handler_EventNames.NETWORK_QUALITY, {
+                    uplinkNetworkQuality,
+                    downlinkNetworkQuality
+                });
+            }
             async joinRoom(options) {
                 const { token, roomId, uid, audioMutedDefault, videoOnDefault, isAutoSubscribeAudio } = options;
                 try {
@@ -42991,11 +43042,10 @@ and limitations under the License.
             }
             async disconnect() {
                 try {
-                    if (this._isSupportVideo) await this.changeVideoState(false);
-                    await this.changeAudioState(false);
-                    await this.engine.unpublishStream(MediaType$1.AUDIO);
                     await this.engine.leaveRoom();
                     this.removeEventListener();
+                    this.clearEventHandlers();
+                    index_esm_min_index.destroyEngine(this.engine);
                 } catch (e) {
                     this.dispatch(event_handler_EventNames.ERROR, e);
                     throw e;
@@ -43116,6 +43166,7 @@ and limitations under the License.
                 this.handleUserLeave = this.handleUserLeave.bind(this);
                 this.handleEventError = this.handleEventError.bind(this);
                 this.handlePlayerEvent = this.handlePlayerEvent.bind(this);
+                this.handleNetworkQuality = this.handleNetworkQuality.bind(this);
                 // Debug only
                 this.handleLocalAudioPropertiesReport = this.handleLocalAudioPropertiesReport.bind(this);
                 this.handleRemoteAudioPropertiesReport = this.handleRemoteAudioPropertiesReport.bind(this);
@@ -43123,6 +43174,8 @@ and limitations under the License.
                 this._videoConfig = videoConfig;
             }
         }
+        // Only use for test
+        const TEST_APP_ID = '6705332c79516e015e3e5f0c';
         class RealtimeClient extends RealtimeEventHandler {
             /**
    * en: Establish a connection to the Coze API and join the room
@@ -43130,22 +43183,38 @@ and limitations under the License.
    * zh: 建立与 Coze API 的连接并加入房间
    */ async connect() {
                 var _this__config_videoConfig;
-                const { botId, conversationId, voiceId } = this._config;
+                const { botId, conversationId, voiceId, getRoomInfo } = this._config;
+                this.dispatch(event_handler_EventNames.CONNECTING, {});
                 let roomInfo;
                 try {
                     // Step1 get token
-                    roomInfo = await this._api.audio.rooms.create({
-                        bot_id: botId,
-                        conversation_id: conversationId || void 0,
-                        voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
-                        connector_id: this._config.connectorId,
-                        uid: this._config.userId || void 0,
-                        workflow_id: this._config.workflowId || void 0
-                    });
+                    if (getRoomInfo) roomInfo = await getRoomInfo();
+                    else {
+                        let config;
+                        if (this._config.videoConfig) config = isScreenShareDevice(this._config.videoConfig.videoInputDeviceId) ? {
+                            video_config: {
+                                stream_video_type: 'screen'
+                            }
+                        } : {
+                            video_config: {
+                                stream_video_type: 'main'
+                            }
+                        };
+                        roomInfo = await this._api.audio.rooms.create({
+                            bot_id: botId,
+                            conversation_id: conversationId || void 0,
+                            voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
+                            connector_id: this._config.connectorId,
+                            uid: this._config.userId || void 0,
+                            workflow_id: this._config.workflowId || void 0,
+                            config
+                        });
+                    }
                 } catch (error) {
                     this.dispatch(event_handler_EventNames.ERROR, error);
                     throw new RealtimeAPIError(error_RealtimeError.CREATE_ROOM_ERROR, error instanceof Error ? error.message : 'Unknown error', error);
                 }
+                this._isTestEnv = TEST_APP_ID === roomInfo.app_id;
                 // Step2 create engine
                 this._client = new EngineClient(roomInfo.app_id, this._config.debug, this._isTestEnv, this._isSupportVideo, this._config.videoConfig);
                 // Step3 bind engine events
@@ -43200,6 +43269,7 @@ and limitations under the License.
                 var _this__client;
                 await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.disconnect());
                 this.isConnected = false;
+                this._client = null;
                 this.dispatch(event_handler_EventNames.DISCONNECTED, {});
             }
             /**
@@ -43352,7 +43422,6 @@ and limitations under the License.
                     baseURL: defaultBaseURL,
                     allowPersonalAccessTokenInBrowser: this._config.allowPersonalAccessTokenInBrowser
                 });
-                this._isTestEnv = 'https://api.coze.cn' !== defaultBaseURL;
                 this._isSupportVideo = !!config.videoConfig;
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze/realtime-api",
-  "version": "1.0.5",
+  "version": "1.1.0-beta.2",
   "description": "A powerful real-time communication SDK for voice interactions with Coze AI bots | 扣子官方实时通信 SDK，用于与 Coze AI bots 进行语音交互",
   "keywords": [
     "coze",
@@ -49,7 +49,7 @@
     "test:cov": "vitest --coverage --run"
   },
   "dependencies": {
-    "@coze/api": "1.0.20",
+    "@coze/api": "1.1.0-beta.6",
     "@volcengine/rtc": "^4.62.1"
   },
   "devDependencies": {