@coze/realtime-api 1.0.1 → 1.0.3

package/dist/umd/index.js

@@ -7,11 +7,11 @@
 })(self, ()=>(()=>{
         "use strict";
         var __webpack_modules__ = {
-            "?de24": function() {
+            "?c628": function() {
             /* (ignored) */ },
-            "?2a9f": function() {
+            "?9452": function() {
             /* (ignored) */ },
-            "?d039": function() {
+            "?e2b1": function() {
             /* (ignored) */ }
         };
         /************************************************************************/ // The module cache
@@ -79,7 +79,7 @@
             EventNames: ()=>/* reexport */ event_handler_EventNames,
             RealtimeClient: ()=>/* binding */ RealtimeClient
         });
-        // 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, {
@@ -93,6 +93,7 @@
         var src_utils_namespaceObject = {};
         __webpack_require__.r(src_utils_namespaceObject);
         __webpack_require__.d(src_utils_namespaceObject, {
+            checkDevicePermission: ()=>checkDevicePermission,
             checkPermission: ()=>checkPermission,
             getAudioDevices: ()=>getAudioDevices,
             sleep: ()=>utils_sleep
@@ -2141,7 +2142,7 @@
             }, {
                 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
@@ -2863,11 +2864,11 @@
         // 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__("?e2b1");
         // EXTERNAL MODULE: crypto (ignored)
-        __webpack_require__("?de24");
+        __webpack_require__("?c628");
         // EXTERNAL MODULE: jsonwebtoken (ignored)
-        __webpack_require__("?2a9f");
+        __webpack_require__("?9452");
         class APIResource {
             constructor(client){
                 this._client = client;
@@ -3109,6 +3110,10 @@
             }
         }
         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. | 调用此接口发起一次对话，支持添加上下文
@@ -3130,6 +3135,7 @@
                 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);
@@ -3155,6 +3161,7 @@
                 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);
@@ -3192,6 +3199,7 @@
                 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);
@@ -3282,6 +3290,19 @@
                 super(...args), this.messages = new Messages(this._client);
             }
         }
+        var chat_ChatEventType = /*#__PURE__*/ function(ChatEventType) {
+            ChatEventType["CONVERSATION_CHAT_CREATED"] = "conversation.chat.created";
+            ChatEventType["CONVERSATION_CHAT_IN_PROGRESS"] = "conversation.chat.in_progress";
+            ChatEventType["CONVERSATION_CHAT_COMPLETED"] = "conversation.chat.completed";
+            ChatEventType["CONVERSATION_CHAT_FAILED"] = "conversation.chat.failed";
+            ChatEventType["CONVERSATION_CHAT_REQUIRES_ACTION"] = "conversation.chat.requires_action";
+            ChatEventType["CONVERSATION_MESSAGE_DELTA"] = "conversation.message.delta";
+            ChatEventType["CONVERSATION_MESSAGE_COMPLETED"] = "conversation.message.completed";
+            ChatEventType["CONVERSATION_AUDIO_DELTA"] = "conversation.audio.delta";
+            ChatEventType["DONE"] = "done";
+            ChatEventType["ERROR"] = "error";
+            return ChatEventType;
+        }({});
         class messages_Messages extends APIResource {
             /**
    * Create a message and add it to the specified conversation. | 创建一条消息，并将其添加到指定的会话中。
@@ -3366,6 +3387,7 @@
    * @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';
@@ -3383,6 +3405,27 @@
                 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);
             }
@@ -3421,6 +3464,9 @@
    * @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';
@@ -3435,6 +3481,9 @@
    * @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';
@@ -3468,9 +3517,46 @@
                 this.data = data;
             }
         }
+        class WorkflowChat extends APIResource {
+            /**
+   * Execute a chat workflow. | 执行对话流
+   * @docs en: https://www.coze.cn/docs/developer_guides/workflow_chat?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/workflow_chat?_lang=zh
+   * @param params.workflow_id - Required The ID of the workflow to chat with. | 必选 要对话的工作流 ID。
+   * @param params.additional_messages - Required Array of messages for the chat. | 必选 对话的消息数组。
+   * @param params.parameters - Required Parameters for the workflow execution. | 必选 工作流执行的参数。
+   * @param params.app_id - Optional The ID of the app. | 可选 应用 ID。
+   * @param params.bot_id - Optional The ID of the bot. | 可选 Bot ID。
+   * @param params.conversation_id - Optional The ID of the conversation. | 可选 会话 ID。
+   * @param params.ext - Optional Additional information for the chat. | 可选 对话的附加信息。
+   * @returns AsyncGenerator<StreamChatData> | 对话数据流
+   */ async *stream(params, options) {
+                const apiUrl = '/v1/workflows/chat';
+                const payload = {
+                    ...params,
+                    additional_messages: handleAdditionalMessages(params.additional_messages)
+                };
+                const result = await this._client.post(apiUrl, payload, true, options);
+                for await (const message of result)if (message.event === chat_ChatEventType.DONE) {
+                    const ret = {
+                        event: message.event,
+                        data: '[DONE]'
+                    };
+                    yield ret;
+                } else try {
+                    const ret = {
+                        event: message.event,
+                        data: JSON.parse(message.data)
+                    };
+                    yield ret;
+                } catch (error) {
+                    throw new CozeError(`Could not parse message into JSON:${message.data}`);
+                }
+            }
+        }
         class Workflows extends APIResource {
             constructor(...args){
-                super(...args), this.runs = new Runs(this._client);
+                super(...args), this.runs = new Runs(this._client), this.chat = new WorkflowChat(this._client);
             }
         }
         class WorkSpaces extends APIResource {
@@ -3494,6 +3580,8 @@
         };
         class Documents extends APIResource {
             /**
+   * @deprecated  The method is deprecated and will be removed in a future version. Please use 'client.datasets.documents.list' instead.
+   *
    * View the file list of a specified knowledge base, which includes lists of documents, spreadsheets, or images.
    * | 调用接口查看指定知识库的内容列表，即文件、表格或图像列表。
    * @docs en: https://www.coze.com/docs/developer_guides/list_knowledge_files?_lang=en
@@ -3510,6 +3598,8 @@
                 return response;
             }
             /**
+   * @deprecated  The method is deprecated and will be removed in a future version. Please use 'client.datasets.documents.create' instead.
+   *
    * Upload files to the specific knowledge. | 调用此接口向指定知识库中上传文件。
    * @docs en: https://www.coze.com/docs/developer_guides/create_knowledge_files?_lang=en
    * @docs zh: https://www.coze.cn/docs/developer_guides/create_knowledge_files?_lang=zh
@@ -3526,6 +3616,8 @@
                 return response.document_infos;
             }
             /**
+   * @deprecated  The method is deprecated and will be removed in a future version. Please use 'client.datasets.documents.delete' instead.
+   *
    * Delete text, images, sheets, and other files in the knowledge base, supporting batch deletion.
    * | 删除知识库中的文本、图像、表格等文件，支持批量删除。
    * @docs en: https://www.coze.com/docs/developer_guides/delete_knowledge_files?_lang=en
@@ -3539,6 +3631,8 @@
                 }));
             }
             /**
+   * @deprecated  The method is deprecated and will be removed in a future version. Please use 'client.datasets.documents.update' instead.
+   *
    * Modify the knowledge base file name and update strategy. | 调用接口修改知识库文件名称和更新策略。
    * @docs en: https://www.coze.com/docs/developer_guides/modify_knowledge_files?_lang=en
    * @docs zh: https://www.coze.cn/docs/developer_guides/modify_knowledge_files?_lang=zh
@@ -3555,7 +3649,79 @@
         }
         class Knowledge extends APIResource {
             constructor(...args){
-                super(...args), this.documents = new Documents(this._client);
+                super(...args), /**
+   * @deprecated
+   */ this.documents = new Documents(this._client);
+            }
+        }
+        // Required header for knowledge APIs
+        const documents_documents_headers = {
+            'agw-js-conv': 'str'
+        };
+        class documents_Documents extends APIResource {
+            /**
+   * View the file list of a specified knowledge base, which includes lists of documents, spreadsheets, or images.
+   * | 调用接口查看指定知识库的内容列表，即文件、表格或图像列表。
+   * @docs en: https://www.coze.com/docs/developer_guides/list_knowledge_files?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/list_knowledge_files?_lang=zh
+   * @param params.dataset_id - Required The ID of the knowledge base. | 必选 待查看文件的知识库 ID。
+   * @param params.page - Optional The page number for paginated queries. Default is 1. | 可选 分页查询时的页码。默认为 1。
+   * @param params.page_size - Optional The size of pagination. Default is 10. | 可选 分页大小。默认为 10。
+   * @returns ListDocumentData | 知识库文件列表
+   */ list(params, options) {
+                const apiUrl = '/open_api/knowledge/document/list';
+                const response = this._client.get(apiUrl, params, false, esm_mergeConfig(options, {
+                    headers: documents_documents_headers
+                }));
+                return response;
+            }
+            /**
+   * Upload files to the specific knowledge. | 调用此接口向指定知识库中上传文件。
+   * @docs en: https://www.coze.com/docs/developer_guides/create_knowledge_files?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/create_knowledge_files?_lang=zh
+   * @param params.dataset_id - Required The ID of the knowledge. | 必选 知识库 ID。
+   * @param params.document_bases - Required The metadata information of the files awaiting upload. | 必选 待上传文件的元数据信息。
+   * @param params.chunk_strategy - Required when uploading files to a new knowledge for the first time. Chunk strategy.
+   * | 向新知识库首次上传文件时必选 分段规则。
+   * @returns DocumentInfo[] | 已上传文件的基本信息
+   */ async create(params, options) {
+                const apiUrl = '/open_api/knowledge/document/create';
+                const response = await this._client.post(apiUrl, params, false, esm_mergeConfig(options, {
+                    headers: documents_documents_headers
+                }));
+                return response.document_infos;
+            }
+            /**
+   * Delete text, images, sheets, and other files in the knowledge base, supporting batch deletion.
+   * | 删除知识库中的文本、图像、表格等文件，支持批量删除。
+   * @docs en: https://www.coze.com/docs/developer_guides/delete_knowledge_files?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/delete_knowledge_files?_lang=zh
+   * @param params.document_ids - Required The list of knowledge base files to be deleted. | 必选 待删除的文件 ID。
+   * @returns void | 无返回
+   */ async delete(params, options) {
+                const apiUrl = '/open_api/knowledge/document/delete';
+                await this._client.post(apiUrl, params, false, esm_mergeConfig(options, {
+                    headers: documents_documents_headers
+                }));
+            }
+            /**
+   * Modify the knowledge base file name and update strategy. | 调用接口修改知识库文件名称和更新策略。
+   * @docs en: https://www.coze.com/docs/developer_guides/modify_knowledge_files?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/modify_knowledge_files?_lang=zh
+   * @param params.document_id - Required The ID of the knowledge base file. | 必选 待修改的知识库文件 ID。
+   * @param params.document_name - Optional The new name of the knowledge base file. | 可选 知识库文件的新名称。
+   * @param params.update_rule - Optional The update strategy for online web pages. | 可选 在线网页更新策略。
+   * @returns void | 无返回
+   */ async update(params, options) {
+                const apiUrl = '/open_api/knowledge/document/update';
+                await this._client.post(apiUrl, params, false, esm_mergeConfig(options, {
+                    headers: documents_documents_headers
+                }));
+            }
+        }
+        class Datasets extends APIResource {
+            constructor(...args){
+                super(...args), this.documents = new documents_Documents(this._client);
             }
         }
         class Voices extends APIResource {
@@ -3630,7 +3796,7 @@
                 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.15","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
@@ -3693,6 +3859,11 @@
         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',
@@ -3705,12 +3876,12 @@
                 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
@@ -3744,13 +3915,33 @@
                 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';
         /* eslint-disable max-params */ class APIClient {
-            buildOptions(method, body, options) {
+            async getToken() {
+                if ('function' == typeof this.token) return await this.token();
+                return this.token;
+            }
+            async buildOptions(method, body, options) {
+                const token = await this.getToken();
                 const headers = {
-                    authorization: `Bearer ${this.token}`
+                    authorization: `Bearer ${token}`
                 };
                 if (!isBrowser()) {
                     headers['User-Agent'] = getUserAgent();
@@ -3765,14 +3956,17 @@
             }
             async makeRequest(apiUrl, method, body, isStream, options) {
                 const fullUrl = `${this.baseURL}${apiUrl}`;
-                const fetchOptions = this.buildOptions(method, body, options);
+                const fetchOptions = await 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();
@@ -3820,10 +4014,11 @@
                 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;
-                if (isBrowser() && isPersonalAccessToken(this.token) && !this.allowPersonalAccessTokenInBrowser) throw new CozeError('Browser environments do not support authentication using Personal Access Token (PAT) by default.\nas it may expose secret API keys. \n\nPlease use OAuth2.0 authentication mechanism. see:\nhttps://www.coze.com/docs/developer_guides/oauth_apps?_lang=en \n\nIf you need to force use, please set the `allowPersonalAccessTokenInBrowser` option to `true`. \n\ne.g new CozeAPI({ token, allowPersonalAccessTokenInBrowser: true });\n\n');
+                if (isBrowser() && 'function' != typeof this.token && isPersonalAccessToken(this.token) && !this.allowPersonalAccessTokenInBrowser) throw new CozeError('Browser environments do not support authentication using Personal Access Token (PAT) by default.\nas it may expose secret API keys. \n\nPlease use OAuth2.0 authentication mechanism. see:\nhttps://www.coze.com/docs/developer_guides/oauth_apps?_lang=en \n\nIf you need to force use, please set the `allowPersonalAccessTokenInBrowser` option to `true`. \n\ne.g new CozeAPI({ token, allowPersonalAccessTokenInBrowser: true });\n\n');
             }
         }
         APIClient.APIError = APIError;
@@ -3838,7 +4033,9 @@
         APIClient.UserAbortError = APIUserAbortError;
         class CozeAPI extends APIClient {
             constructor(...args){
-                super(...args), this.bots = new Bots(this), this.chat = new Chat(this), this.conversations = new Conversations(this), this.files = new Files(this), this.knowledge = new Knowledge(this), this.workflows = new Workflows(this), this.workspaces = new WorkSpaces(this), this.audio = new esm_Audio(this);
+                super(...args), this.bots = new Bots(this), this.chat = new Chat(this), this.conversations = new Conversations(this), this.files = new Files(this), /**
+   * @deprecated
+   */ this.knowledge = new Knowledge(this), this.datasets = new Datasets(this), this.workflows = new Workflows(this), this.workspaces = new WorkSpaces(this), this.audio = new esm_Audio(this);
             }
         }
         /**
@@ -12643,8 +12840,8 @@
         }
         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]);
@@ -38228,6 +38425,7 @@
             return new Promise((resolve)=>setTimeout(resolve, milliseconds));
         };
         /**
+ * @deprecated use checkDevicePermission instead
  * Check microphone permission，return boolean
  */ const checkPermission = async function() {
             let { audio = true, video = false } = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : {};
@@ -38242,22 +38440,32 @@
                 return false;
             }
         };
+        const checkDevicePermission = async function() {
+            let checkVideo = arguments.length > 0 && void 0 !== arguments[0] && arguments[0];
+            return await index_esm_min_index.enableDevices({
+                audio: true,
+                video: checkVideo
+            });
+        };
         /**
  * 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) {
@@ -38360,6 +38568,34 @@
    * 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 {
@@ -38390,7 +38626,8 @@
                 }
             }
             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();
@@ -41659,7 +41896,7 @@
                 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);
@@ -41670,7 +41907,7 @@
                 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);
@@ -41715,13 +41952,13 @@
                 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) {
@@ -41735,14 +41972,18 @@
                 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, {
@@ -41895,7 +42136,7 @@
                 // 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();
@@ -41906,14 +42147,15 @@
                     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);
@@ -41925,7 +42167,6 @@
                     token: roomInfo.token,
                     appId: roomInfo.app_id
                 });
-                this._log('dispatch client.connected event');
             }
             /**
    * en: Interrupt the current conversation
@@ -41935,7 +42176,6 @@
                 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
@@ -42057,6 +42297,7 @@
    *                                       可选，默认是否抑制静态噪声，默认值为 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;