@coze/realtime-api 1.0.2 → 1.0.3

package/README.md

@@ -45,6 +45,11 @@ import { RealtimeClient, EventNames, RealtimeUtils } from "@coze/realtime-api";
 const client = new RealtimeClient({
   baseURL: "https://api.coze.cn",
   accessToken: "your_access_token",
+  // or
+  // accessToken: async () => {
+  //   // refresh token if expired
+  //   return 'your_oauth_token';
+  // },
   botId: "your_bot_id",
   voiceId: "your_voice_id",           // Optional: Specify voice ID
   conversationId: "conversation_id",   // Optional: For conversation continuity
@@ -58,8 +63,8 @@ const client = new RealtimeClient({
 // Essential Setup
 async function initializeVoiceChat() {
   // 1. Verify device permissions
-  const hasPermission = await RealtimeUtils.checkPermission();
-  if (!hasPermission) {
+  const result = await RealtimeUtils.checkDevicePermission();
+  if (!result.audio) {
     throw new Error("Microphone access required");
   }
 

package/dist/cjs/index.cjs

@@ -1,11 +1,11 @@
 /*! For license information please see index.cjs.LICENSE.txt */
 "use strict";
 var __webpack_modules__ = {
-    "?e272": function() {
+    "?c628": function() {
     /* (ignored) */ },
-    "?5742": function() {
+    "?9452": function() {
     /* (ignored) */ },
-    "?9caf": function() {
+    "?e2b1": function() {
     /* (ignored) */ }
 };
 /************************************************************************/ // The module cache
@@ -87,6 +87,7 @@ __webpack_require__.d(common_utils_namespaceObject, {
 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
@@ -2857,11 +2858,11 @@ axios.default = axios;
 // so that it can keep same with es module or cjs
 const { Axios: axios_Axios, AxiosError: axios_AxiosError, CanceledError: axios_CanceledError, isCancel: axios_isCancel, CancelToken: axios_CancelToken, VERSION: axios_VERSION, all: axios_all, Cancel, isAxiosError: axios_isAxiosError, spread: axios_spread, toFormData: axios_toFormData, AxiosHeaders: axios_AxiosHeaders, HttpStatusCode: axios_HttpStatusCode, formToJSON, getAdapter, mergeConfig: axios_mergeConfig } = lib_axios;
 // EXTERNAL MODULE: os (ignored)
-var os_ignored_ = __webpack_require__("?9caf");
+var os_ignored_ = __webpack_require__("?e2b1");
 // EXTERNAL MODULE: crypto (ignored)
-__webpack_require__("?e272");
+__webpack_require__("?c628");
 // EXTERNAL MODULE: jsonwebtoken (ignored)
-__webpack_require__("?5742");
+__webpack_require__("?9452");
 class APIResource {
     constructor(client){
         this._client = client;
@@ -3283,6 +3284,19 @@ class Chat extends APIResource {
         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. | 创建一条消息，并将其添加到指定的会话中。
@@ -3497,9 +3511,46 @@ class WorkflowEvent {
         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 {
@@ -3523,6 +3574,8 @@ const documents_headers = {
 };
 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
@@ -3539,6 +3592,8 @@ class Documents extends APIResource {
         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
@@ -3555,6 +3610,8 @@ class Documents extends APIResource {
         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
@@ -3568,6 +3625,8 @@ class Documents extends APIResource {
         }));
     }
     /**
+   * @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
@@ -3584,7 +3643,79 @@ class Documents extends APIResource {
 }
 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 {
@@ -3659,7 +3790,7 @@ class esm_Audio extends APIResource {
         super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client);
     }
 }
-var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.14","description":"Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中","keywords":["coze","ai","nodejs","sdk","chatbot","typescript"],"homepage":"https://github.com/coze-dev/coze-js/tree/main/packages/coze-js","bugs":{"url":"https://github.com/coze-dev/coze-js/issues"},"repository":{"type":"git","url":"https://github.com/coze-dev/coze-js.git","directory":"packages/coze-js"},"license":"MIT","author":"Leeight <leeight@gmail.com>","type":"module","exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"dist/types/index.d.ts","files":["dist","LICENSE","README.md","!**/*.tsbuildinfo"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","prepublishOnly":"npm run build","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"devDependencies":{"@coze-infra/eslint-config":"workspace:*","@coze-infra/ts-config":"workspace:*","@coze-infra/vitest-config":"workspace:*","@rslib/core":"0.0.18","@swc/core":"^1.3.14","@types/jsonwebtoken":"^9.0.0","@types/node":"^20","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"}}'); // CONCATENATED MODULE: ./src/version.ts
+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
@@ -3797,9 +3928,14 @@ function isAxiosStatic(instance) {
  * 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();
@@ -3814,7 +3950,7 @@ function isAxiosStatic(instance) {
     }
     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}`);
@@ -3876,7 +4012,7 @@ function isAxiosStatic(instance) {
         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;
@@ -3891,7 +4027,9 @@ APIClient.TimeoutError = TimeoutError;
 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);
     }
 }
 /**
@@ -38281,6 +38419,7 @@ var VERTC = _createClass(function e() {
     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] : {};
@@ -38295,6 +38434,13 @@ var VERTC = _createClass(function e() {
         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

package/dist/esm/index.js

@@ -1,10 +1,10 @@
 /*! For license information please see index.js.LICENSE.txt */
 var __webpack_modules__ = {
-    "?e272": function() {
+    "?c628": function() {
     /* (ignored) */ },
-    "?5742": function() {
+    "?9452": function() {
     /* (ignored) */ },
-    "?9caf": function() {
+    "?e2b1": function() {
     /* (ignored) */ }
 };
 /************************************************************************/ // The module cache
@@ -75,6 +75,7 @@ __webpack_require__.d(common_utils_namespaceObject, {
 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
@@ -2845,11 +2846,11 @@ axios.default = axios;
 // so that it can keep same with es module or cjs
 const { Axios: axios_Axios, AxiosError: axios_AxiosError, CanceledError: axios_CanceledError, isCancel: axios_isCancel, CancelToken: axios_CancelToken, VERSION: axios_VERSION, all: axios_all, Cancel, isAxiosError: axios_isAxiosError, spread: axios_spread, toFormData: axios_toFormData, AxiosHeaders: axios_AxiosHeaders, HttpStatusCode: axios_HttpStatusCode, formToJSON, getAdapter, mergeConfig: axios_mergeConfig } = lib_axios;
 // EXTERNAL MODULE: os (ignored)
-var os_ignored_ = __webpack_require__("?9caf");
+var os_ignored_ = __webpack_require__("?e2b1");
 // EXTERNAL MODULE: crypto (ignored)
-__webpack_require__("?e272");
+__webpack_require__("?c628");
 // EXTERNAL MODULE: jsonwebtoken (ignored)
-__webpack_require__("?5742");
+__webpack_require__("?9452");
 class APIResource {
     constructor(client){
         this._client = client;
@@ -3271,6 +3272,19 @@ class Chat extends APIResource {
         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. | 创建一条消息，并将其添加到指定的会话中。
@@ -3485,9 +3499,46 @@ class WorkflowEvent {
         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 {
@@ -3511,6 +3562,8 @@ const documents_headers = {
 };
 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
@@ -3527,6 +3580,8 @@ class Documents extends APIResource {
         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
@@ -3543,6 +3598,8 @@ class Documents extends APIResource {
         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
@@ -3556,6 +3613,8 @@ class Documents extends APIResource {
         }));
     }
     /**
+   * @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
@@ -3572,7 +3631,79 @@ class Documents extends APIResource {
 }
 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 {
@@ -3647,7 +3778,7 @@ class esm_Audio extends APIResource {
         super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client);
     }
 }
-var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.14","description":"Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中","keywords":["coze","ai","nodejs","sdk","chatbot","typescript"],"homepage":"https://github.com/coze-dev/coze-js/tree/main/packages/coze-js","bugs":{"url":"https://github.com/coze-dev/coze-js/issues"},"repository":{"type":"git","url":"https://github.com/coze-dev/coze-js.git","directory":"packages/coze-js"},"license":"MIT","author":"Leeight <leeight@gmail.com>","type":"module","exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"dist/types/index.d.ts","files":["dist","LICENSE","README.md","!**/*.tsbuildinfo"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","prepublishOnly":"npm run build","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"devDependencies":{"@coze-infra/eslint-config":"workspace:*","@coze-infra/ts-config":"workspace:*","@coze-infra/vitest-config":"workspace:*","@rslib/core":"0.0.18","@swc/core":"^1.3.14","@types/jsonwebtoken":"^9.0.0","@types/node":"^20","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"}}'); // CONCATENATED MODULE: ./src/version.ts
+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
@@ -3785,9 +3916,14 @@ function isAxiosStatic(instance) {
  * 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();
@@ -3802,7 +3938,7 @@ function isAxiosStatic(instance) {
     }
     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}`);
@@ -3864,7 +4000,7 @@ function isAxiosStatic(instance) {
         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;
@@ -3879,7 +4015,9 @@ APIClient.TimeoutError = TimeoutError;
 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);
     }
 }
 /**
@@ -38269,6 +38407,7 @@ var VERTC = _createClass(function e() {
     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] : {};
@@ -38283,6 +38422,13 @@ var VERTC = _createClass(function e() {
         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

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 import { type AudioPropertiesConfig } from '@volcengine/rtc';
+import { type GetToken } from '@coze/api';
 import * as RealtimeUtils from './utils';
 import { RealtimeEventHandler, EventNames } from './event-handler';
 import { RealtimeAPIError, RealtimeError } from './error';
@@ -7,7 +8,7 @@ export interface VideoConfig {
     renderDom?: string /** optional, The DOM element to render the video stream to */;
 }
 export interface RealtimeClientConfig {
-    accessToken: string /** required, Access Token */;
+    accessToken: GetToken /** required, Access Token */;
     botId: string /** required, Bot Id */;
     voiceId?: string /** optional, Voice Id */;
     conversationId?: string /** optional, Conversation Id */;

package/dist/types/utils.d.ts

@@ -6,12 +6,19 @@
 + */
 export declare const sleep: (milliseconds: number) => Promise<void>;
 /**
+ * @deprecated use checkDevicePermission instead
  * Check microphone permission，return boolean
  */
 export declare const checkPermission: ({ audio, video, }?: {
     audio?: boolean;
     video?: boolean;
 }) => Promise<boolean>;
+export declare const checkDevicePermission: (checkVideo?: boolean) => Promise<{
+    video: boolean;
+    audio: boolean;
+    videoExceptionError?: DOMException | undefined;
+    audioExceptionError?: DOMException | undefined;
+}>;
 /**
  * Get audio devices
  * @returns Promise<AudioDevices> Object containing arrays of audio input and output devices

package/dist/umd/index.js

@@ -7,11 +7,11 @@
 })(self, ()=>(()=>{
         "use strict";
         var __webpack_modules__ = {
-            "?e272": function() {
+            "?c628": function() {
             /* (ignored) */ },
-            "?5742": function() {
+            "?9452": function() {
             /* (ignored) */ },
-            "?9caf": function() {
+            "?e2b1": function() {
             /* (ignored) */ }
         };
         /************************************************************************/ // The module cache
@@ -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
@@ -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__("?9caf");
+        var os_ignored_ = __webpack_require__("?e2b1");
         // EXTERNAL MODULE: crypto (ignored)
-        __webpack_require__("?e272");
+        __webpack_require__("?c628");
         // EXTERNAL MODULE: jsonwebtoken (ignored)
-        __webpack_require__("?5742");
+        __webpack_require__("?9452");
         class APIResource {
             constructor(client){
                 this._client = client;
@@ -3289,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. | 创建一条消息，并将其添加到指定的会话中。
@@ -3503,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 {
@@ -3529,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
@@ -3545,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
@@ -3561,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
@@ -3574,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
@@ -3590,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 {
@@ -3665,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.14","description":"Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中","keywords":["coze","ai","nodejs","sdk","chatbot","typescript"],"homepage":"https://github.com/coze-dev/coze-js/tree/main/packages/coze-js","bugs":{"url":"https://github.com/coze-dev/coze-js/issues"},"repository":{"type":"git","url":"https://github.com/coze-dev/coze-js.git","directory":"packages/coze-js"},"license":"MIT","author":"Leeight <leeight@gmail.com>","type":"module","exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"dist/types/index.d.ts","files":["dist","LICENSE","README.md","!**/*.tsbuildinfo"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","prepublishOnly":"npm run build","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"devDependencies":{"@coze-infra/eslint-config":"workspace:*","@coze-infra/ts-config":"workspace:*","@coze-infra/vitest-config":"workspace:*","@rslib/core":"0.0.18","@swc/core":"^1.3.14","@types/jsonwebtoken":"^9.0.0","@types/node":"^20","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"}}'); // CONCATENATED MODULE: ./src/version.ts
+        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
@@ -3803,9 +3934,14 @@
  * 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();
@@ -3820,7 +3956,7 @@
             }
             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}`);
@@ -3882,7 +4018,7 @@
                 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;
@@ -3897,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);
             }
         }
         /**
@@ -38287,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] : {};
@@ -38301,6 +38440,13 @@
                 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

package/package.json

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