@coze/realtime-api 1.0.3 → 1.0.4

package/README.md

@@ -6,6 +6,8 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/coze-dev/coze-js/pulls)
 
+English | [简体中文](./README.zh-CN.md)
+
 A powerful real-time communication SDK for voice interactions with Coze AI bots.
 
 ## Features
@@ -58,6 +60,10 @@ const client = new RealtimeClient({
   audioMutedDefault: false,           // Optional: Initial audio state (default: false)
   suppressStationaryNoise: false,     // Optional: Enable stationary noise suppression(default: false)
   suppressNonStationaryNoise: false,  // Optional: Enable non-stationary noise suppression(default: false)
+  videoConfig: { // Optional: Video configuration
+    videoOnDefault: true, // Optional: Whether to turn on video by default, defaults to true
+    renderDom: 'local-player' // Optional: The DOM element to render the video stream to
+  },
 });
 
 // Essential Setup

package/README.zh-CN.md

@@ -0,0 +1,104 @@
+# Coze 实时语音 API
+
+[![npm version](https://img.shields.io/npm/v/@coze/realtime-api.svg)](https://www.npmjs.com/package/@coze/realtime-api)
+[![npm downloads](https://img.shields.io/npm/dm/@coze/realtime-api.svg)](https://www.npmjs.com/package/@coze/realtime-api)
+[![license](https://img.shields.io/npm/l/@coze/realtime-api.svg)](https://github.com/coze-dev/coze-js/blob/main/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/coze-dev/coze-js/pulls)
+
+[English](./README.md) | 简体中文
+
+一个强大的实时语音 SDK，用于与 Coze AI Bot 进行语音交互。
+
+## 特性
+1. 精准的语音识别：利用大语言模型进行 ASR（自动语音识别），我们的系统提供上下文理解能力。它可以参考之前提到的术语，理解说话风格和引用，并在噪音、专业术语和中英混合语音等挑战性场景下提供更高的识别准确率。
+
+2. 强大的 AI 代理能力：作为 AI 代理开发平台，Coze 提供全面的代理功能，包括：
+   - 记忆系统（文件存储、数据库、变量）
+   - 知识集成（文本、表格、图像）
+   - 技能（插件、触发器）
+   - 工作流编排（任务流、图像处理流程）
+
+3. 低延迟：使用 RTC（实时通信）技术实现，最大限度地减少通信管道中的延迟。
+
+4. 自然语音合成：使用由大语言模型驱动的高级 TTS（文本转语音）模型，我们的系统：
+   - 智能预测情感语境和语调
+   - 生成超自然、高保真、个性化的语音输出
+   - 在自然度、音质、韵律、呼吸模式和情感表达方面表现出色
+   - 无缝处理中英混合内容
+   - 提供类人的语气词和情感细微差别表达
+
+![api-overview](./assets/api-overview.png)
+
+## 安装
+
+```bash
+npm install @coze/realtime-api
+# 或
+yarn add @coze/realtime-api
+```
+
+## 快速开始
+
+```ts
+import { RealtimeClient, EventNames, RealtimeUtils } from "@coze/realtime-api";
+
+// 初始化客户端
+const client = new RealtimeClient({
+  baseURL: "https://api.coze.cn",
+  accessToken: "your_access_token",
+  // 或者
+  // accessToken: async () => {
+  //   // 如果令牌过期则刷新
+  //   return 'your_oauth_token';
+  // },
+  botId: "your_bot_id",
+  voiceId: "your_voice_id",           // 可选：指定音色 ID
+  conversationId: "conversation_id",   // 可选：用于对话连续性
+  debug: true,                        // 可选：启用调试日志
+  allowPersonalAccessTokenInBrowser: true,  // 可选：在浏览器中启用 PAT 令牌使用
+  audioMutedDefault: false,           // 可选：初始音频状态（默认：false）
+  suppressStationaryNoise: false,     // 可选：启用静态噪声抑制（默认：false）
+  suppressNonStationaryNoise: false,  // 可选：启用非静态噪声抑制（默认：false）
+});
+
+// 基本设置
+async function initializeVoiceChat() {
+  // 1. 验证设备权限
+  const result = await RealtimeUtils.checkDevicePermission();
+  if (!result.audio) {
+    throw new Error("需要麦克风访问权限");
+  }
+
+  // 2. 建立连接
+  await client.connect();
+}
+
+// 核心操作
+const operations = {
+  disconnect: () => client.disconnect(),
+  interrupt: () => client.interrupt(),
+  toggleMicrophone: (enabled: boolean) => client.setAudioEnable(enabled),
+  checkConnection: () => client.isConnected
+};
+
+// 事件处理
+function setupEventListeners() {
+  // 监听所有事件
+  client.on(EventNames.EventNames, console.log);
+
+  // 仅客户端事件
+  client.on(EventNames.ALL_CLIENT, console.log);
+
+  // 仅服务器端事件
+  client.on(EventNames.ALL_SERVER, console.log);
+
+  // 特定事件处理
+  client.on(EventNames.CONNECTED, (event) => {
+    console.log("连接已建立:", event);
+  });
+}
+```
+
+## 示例
+查看完整的示例，请参考我们的[实时语音控制台DEMO](../../examples/realtime-console)。

package/dist/cjs/index.cjs

@@ -1,11 +1,11 @@
 /*! For license information please see index.cjs.LICENSE.txt */
 "use strict";
 var __webpack_modules__ = {
-    "?c628": function() {
+    "?e272": function() {
     /* (ignored) */ },
-    "?9452": function() {
+    "?5742": function() {
     /* (ignored) */ },
-    "?e2b1": function() {
+    "?9caf": function() {
     /* (ignored) */ }
 };
 /************************************************************************/ // The module cache
@@ -80,7 +80,7 @@ __webpack_require__.d(common_utils_namespaceObject, {
     hasBrowserEnv: ()=>hasBrowserEnv,
     hasStandardBrowserEnv: ()=>hasStandardBrowserEnv,
     hasStandardBrowserWebWorkerEnv: ()=>hasStandardBrowserWebWorkerEnv,
-    navigator: ()=>_navigator,
+    navigator: ()=>utils_navigator,
     origin: ()=>origin
 });
 // NAMESPACE OBJECT: ./src/utils.ts
@@ -90,6 +90,8 @@ __webpack_require__.d(src_utils_namespaceObject, {
     checkDevicePermission: ()=>checkDevicePermission,
     checkPermission: ()=>checkPermission,
     getAudioDevices: ()=>getAudioDevices,
+    isScreenShareDevice: ()=>isScreenShareDevice,
+    isScreenShareSupported: ()=>isScreenShareSupported,
     sleep: ()=>utils_sleep
 });
 function bind(fn, thisArg) {
@@ -1052,7 +1054,7 @@ class InterceptorManager_InterceptorManager {
     ]
 };
 const hasBrowserEnv = 'undefined' != typeof window && 'undefined' != typeof document;
-const _navigator = 'object' == typeof navigator && navigator || void 0;
+const utils_navigator = 'object' == typeof navigator && navigator || void 0;
 /**
  * Determine if we're running in a standard browser environment
  *
@@ -1069,11 +1071,11 @@ const _navigator = 'object' == typeof navigator && navigator || void 0;
  *  navigator.product -> 'NativeScript' or 'NS'
  *
  * @returns {boolean}
- */ const hasStandardBrowserEnv = hasBrowserEnv && (!_navigator || [
+ */ const hasStandardBrowserEnv = hasBrowserEnv && (!utils_navigator || [
     'ReactNative',
     'NativeScript',
     'NS'
-].indexOf(_navigator.product) < 0);
+].indexOf(utils_navigator.product) < 0);
 /**
  * Determine if we're running in a standard browser webWorker environment
  *
@@ -2858,11 +2860,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__("?e2b1");
+var os_ignored_ = __webpack_require__("?9caf");
 // EXTERNAL MODULE: crypto (ignored)
-__webpack_require__("?c628");
+__webpack_require__("?e272");
 // EXTERNAL MODULE: jsonwebtoken (ignored)
-__webpack_require__("?9452");
+__webpack_require__("?5742");
 class APIResource {
     constructor(client){
         this._client = client;
@@ -3662,9 +3664,9 @@ class documents_Documents extends APIResource {
    * @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) {
+   */ async list(params, options) {
         const apiUrl = '/open_api/knowledge/document/list';
-        const response = this._client.get(apiUrl, params, false, esm_mergeConfig(options, {
+        const response = await this._client.get(apiUrl, params, false, esm_mergeConfig(options, {
             headers: documents_documents_headers
         }));
         return response;
@@ -3713,9 +3715,104 @@ class documents_Documents extends APIResource {
         }));
     }
 }
+class Images extends APIResource {
+    /**
+   * Update the description of an image in the knowledge base | 更新知识库中的图片描述
+   * @docs en: https://www.coze.com/docs/developer_guides/developer_guides/update_image_caption?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/developer_guides/update_image_caption?_lang=zh
+   * @param datasetId - The ID of the dataset | 必选 知识库 ID
+   * @param documentId - The ID of the document | 必选 知识库文件 ID
+   * @param params - The parameters for updating the image
+   * @param params.caption - Required. The description of the image | 必选 图片的描述信息
+   * @returns undefined
+   */ // eslint-disable-next-line max-params
+    async update(datasetId, documentId, params, options) {
+        const apiUrl = `/v1/datasets/${datasetId}/images/${documentId}`;
+        await this._client.put(apiUrl, params, false, options);
+    }
+    /**
+   * List images in the knowledge base | 列出知识库中的图片
+   * @docs en: https://www.coze.com/docs/developer_guides/developer_guides/get_images?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/developer_guides/get_images?_lang=zh
+   * @param datasetId - The ID of the dataset | 必选 知识库 ID
+   * @param params - The parameters for listing images
+   * @param params.page_num - Optional. Page number for pagination, minimum value is 1, defaults to 1 | 可选 分页查询时的页码。默认为 1。
+   * @param params.page_size - Optional. Number of items per page, range 1-299, defaults to 10 | 可选 分页大小。默认为 10。
+   * @param params.keyword - Optional. Search keyword for image descriptions | 可选 图片描述的搜索关键词。
+   * @param params.has_caption - Optional. Filter for images with/without captions | 可选 是否过滤有/无描述的图片。
+   */ async list(datasetId, params, options) {
+        const apiUrl = `/v1/datasets/${datasetId}/images`;
+        const response = await this._client.get(apiUrl, params, false, options);
+        return response.data;
+    }
+}
 class Datasets extends APIResource {
+    /**
+   * Creates a new dataset | 创建数据集
+   * @docs en: https://www.coze.com/docs/developer_guides/create_dataset?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/create_dataset?_lang=zh
+   * @param params - The parameters for creating a dataset
+   * @param {string} params.name - Required. Dataset name, maximum length of 100 characters | 必选 数据集名称，最大长度为 100 个字符
+   * @param {string} params.space_id - Required. Space ID where the dataset belongs | 必选 数据集所属的空间 ID
+   * @param {number} params.format_type - Required. Dataset type (0: Text type, 2: Image type) | 必选 数据集类型 (0: 文本类型, 2: 图片类型)
+   * @param {string} [params.description] - Optional. Dataset description | 可选 数据集描述
+   * @param {string} [params.file_id] - Optional. Dataset icon file ID from file upload
+   */ async create(params, options) {
+        const apiUrl = '/v1/datasets';
+        const response = await this._client.post(apiUrl, params, false, options);
+        return response.data;
+    }
+    /**
+   * Lists all datasets in a space | 列出空间中的所有数据集
+   * @docs en: https://www.coze.com/docs/developer_guides/list_dataset?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/list_dataset?_lang=zh
+   * @param params - The parameters for listing datasets | 列出数据集的参数
+   * @param {string} params.space_id - Required. Space ID where the datasets belong | 必选 数据集所属的空间 ID
+   * @param {string} [params.name] - Optional. Dataset name for fuzzy search | 可选 数据集名称用于模糊搜索
+   * @param {number} [params.format_type] - Optional. Dataset type (0: Text type, 2: Image type) | 可选 数据集类型 (0: 文本类型, 2: 图片类型)
+   * @param {number} [params.page_num] - Optional. Page number for pagination (default: 1) | 可选 分页查询时的页码。默认为 1。
+   * @param {number} [params.page_size] - Optional. Number of items per page (default: 10) | 可选 分页大小。默认为 10。
+   */ async list(params, options) {
+        const apiUrl = '/v1/datasets';
+        const response = await this._client.get(apiUrl, params, false, options);
+        return response.data;
+    }
+    /**
+   * Updates a dataset | 更新数据集
+   * @docs en: https://www.coze.com/docs/developer_guides/update_dataset?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/update_dataset?_lang=zh
+   * @param dataset_id - Required. The ID of the dataset to update | 必选 数据集 ID
+   * @param params - Required. The parameters for updating the dataset | 必选 更新数据集的参数
+   * @param params.name - Required. Dataset name, maximum length of 100 characters. | 必选 数据集名称，最大长度为 100 个字符。
+   * @param params.file_id - Optional. Dataset icon, should pass the file_id obtained from the file upload interface. | 可选 数据集图标，应传递从文件上传接口获取的 file_id。
+   * @param params.description - Optional. Dataset description. | 可选 数据集描述。
+   */ async update(dataset_id, params, options) {
+        const apiUrl = `/v1/datasets/${dataset_id}`;
+        await this._client.put(apiUrl, params, false, options);
+    }
+    /**
+   * Deletes a dataset | 删除数据集
+   * @docs en: https://www.coze.com/docs/developer_guides/delete_dataset?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/delete_dataset?_lang=zh
+   * @param dataset_id - Required. The ID of the dataset to delete | 必选 数据集 ID
+   */ async delete(dataset_id, options) {
+        const apiUrl = `/v1/datasets/${dataset_id}`;
+        await this._client.delete(apiUrl, false, options);
+    }
+    /**
+   * Views the progress of dataset upload | 查看数据集上传进度
+   * @docs en: https://www.coze.com/docs/developer_guides/get_dataset_progress?_lang=en
+   * @docs zh: https://www.coze.cn/docs/developer_guides/get_dataset_progress?_lang=zh
+   * @param dataset_id - Required. The ID of the dataset to process | 必选 数据集 ID
+   * @param params - Required. The parameters for processing the dataset | 必选 处理数据集的参数
+   * @param params.dataset_ids - Required. List of dataset IDs | 必选 数据集 ID 列表
+   */ async process(dataset_id, params, options) {
+        const apiUrl = `/v1/datasets/${dataset_id}/process`;
+        const response = await this._client.post(apiUrl, params, false, options);
+        return response.data;
+    }
     constructor(...args){
-        super(...args), this.documents = new documents_Documents(this._client);
+        super(...args), this.documents = new documents_Documents(this._client), this.images = new Images(this._client);
     }
 }
 class Voices extends APIResource {
@@ -3772,7 +3869,10 @@ class Speech extends APIResource {
    * @returns Speech synthesis data
    */ async create(params, options) {
         const apiUrl = '/v1/audio/speech';
-        const response = await this._client.post(apiUrl, params, false, esm_mergeConfig(options, {
+        const response = await this._client.post(apiUrl, {
+            ...params,
+            sample_rate: params.sample_rate || 24000
+        }, false, esm_mergeConfig(options, {
             responseType: 'arraybuffer'
         }));
         return response;
@@ -3790,7 +3890,21 @@ 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.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
+class Templates extends APIResource {
+    /**
+   * Duplicate a template. | 复制一个模板。
+   * @param templateId - Required. The ID of the template to duplicate. | 要复制的模板的 ID。
+   * @param params - Optional. The parameters for the duplicate operation. | 可选参数，用于复制操作。
+   * @param params.workspace_id - Required. The ID of the workspace to duplicate the template into. | 要复制到的目标工作空间的 ID。
+   * @param params.name - Optional. The name of the new template. | 新模板的名称。
+   * @returns TemplateDuplicateRes | 复制模板结果
+   */ async duplicate(templateId, params, options) {
+        const apiUrl = `/v1/templates/${templateId}/duplicate`;
+        const response = await this._client.post(apiUrl, params, false, options);
+        return response.data;
+    }
+}
+var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.0.16","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","README.zh-CN.md"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","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
@@ -3840,6 +3954,55 @@ const getNodeClientUserAgent = ()=>{
     };
     return JSON.stringify(ua);
 };
+const getBrowserClientUserAgent = ()=>{
+    const browserInfo = {
+        name: 'unknown',
+        version: 'unknown'
+    };
+    const osInfo = {
+        name: 'unknown',
+        version: 'unknown'
+    };
+    const { userAgent } = navigator;
+    // 检测操作系统及版本
+    if (userAgent.indexOf('Windows') > -1) {
+        var _userAgent_match;
+        osInfo.name = 'windows';
+        const windowsVersion = (null === (_userAgent_match = userAgent.match(/Windows NT ([0-9.]+)/)) || void 0 === _userAgent_match ? void 0 : _userAgent_match[1]) || 'unknown';
+        osInfo.version = windowsVersion;
+    } else if (userAgent.indexOf('Mac OS X') > -1) {
+        var _userAgent_match1;
+        osInfo.name = 'macos';
+        // 将 10_15_7 格式转换为 10.15.7
+        osInfo.version = ((null === (_userAgent_match1 = userAgent.match(/Mac OS X ([0-9_]+)/)) || void 0 === _userAgent_match1 ? void 0 : _userAgent_match1[1]) || 'unknown').replace(/_/g, '.');
+    } else if (userAgent.indexOf('Linux') > -1) {
+        var _userAgent_match2;
+        osInfo.name = 'linux';
+        osInfo.version = (null === (_userAgent_match2 = userAgent.match(/Linux ([0-9.]+)/)) || void 0 === _userAgent_match2 ? void 0 : _userAgent_match2[1]) || 'unknown';
+    }
+    // 检测浏览器及版本
+    if (userAgent.indexOf('Chrome') > -1) {
+        var _userAgent_match3;
+        browserInfo.name = 'chrome';
+        browserInfo.version = (null === (_userAgent_match3 = userAgent.match(/Chrome\/([0-9.]+)/)) || void 0 === _userAgent_match3 ? void 0 : _userAgent_match3[1]) || 'unknown';
+    } else if (userAgent.indexOf('Firefox') > -1) {
+        var _userAgent_match4;
+        browserInfo.name = 'firefox';
+        browserInfo.version = (null === (_userAgent_match4 = userAgent.match(/Firefox\/([0-9.]+)/)) || void 0 === _userAgent_match4 ? void 0 : _userAgent_match4[1]) || 'unknown';
+    } else if (userAgent.indexOf('Safari') > -1) {
+        var _userAgent_match5;
+        browserInfo.name = 'safari';
+        browserInfo.version = (null === (_userAgent_match5 = userAgent.match(/Version\/([0-9.]+)/)) || void 0 === _userAgent_match5 ? void 0 : _userAgent_match5[1]) || 'unknown';
+    }
+    const ua = {
+        version: esm_version,
+        browser: browserInfo.name,
+        browser_version: browserInfo.version,
+        os_name: osInfo.name,
+        os_version: osInfo.version
+    };
+    return JSON.stringify(ua);
+};
 /* eslint-disable @typescript-eslint/no-explicit-any */ const esm_handleError = (error)=>{
     if (!error.isAxiosError && (!error.code || !error.message)) return new CozeError(`Unexpected error: ${error.message}`);
     if ('ECONNABORTED' === error.code && error.message.includes('timeout') || 'ETIMEDOUT' === error.code) {
@@ -3937,7 +4100,8 @@ function isAxiosStatic(instance) {
         const headers = {
             authorization: `Bearer ${token}`
         };
-        if (!isBrowser()) {
+        if (isBrowser()) headers['X-Coze-Client-User-Agent'] = getBrowserClientUserAgent();
+        else {
             headers['User-Agent'] = getUserAgent();
             headers['X-Coze-Client-User-Agent'] = getNodeClientUserAgent();
         }
@@ -4029,7 +4193,7 @@ 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), /**
    * @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);
+   */ 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), this.templates = new Templates(this);
     }
 }
 /**
@@ -9261,7 +9425,7 @@ var setPrototypeOf = setPrototypeOf$2, _Object$setPrototypeOf = getDefaultExport
 }, stringPad = {
     start: createMethod(!1),
     end: createMethod(!0)
-}, userAgent = engineUserAgent, stringPadWebkitBug = /Version\/10(?:\.\d+){1,2}(?: [\w./]+)?(?: Mobile\/\w+)? Safari\//.test(userAgent), $$F = _export, $padEnd = stringPad.end, WEBKIT_BUG$1 = stringPadWebkitBug;
+}, index_esm_min_userAgent = engineUserAgent, stringPadWebkitBug = /Version\/10(?:\.\d+){1,2}(?: [\w./]+)?(?: Mobile\/\w+)? Safari\//.test(index_esm_min_userAgent), $$F = _export, $padEnd = stringPad.end, WEBKIT_BUG$1 = stringPadWebkitBug;
 $$F({
     target: "String",
     proto: !0,
@@ -38434,7 +38598,11 @@ var VERTC = _createClass(function e() {
         return false;
     }
 };
-const checkDevicePermission = async function() {
+/**
+ * Checks device permissions for audio and video
+ * @param checkVideo Whether to check video permissions (default: false)
+ * @returns Promise that resolves with the device permission status
+ */ const checkDevicePermission = async function() {
     let checkVideo = arguments.length > 0 && void 0 !== arguments[0] && arguments[0];
     return await index_esm_min_index.enableDevices({
         audio: true,
@@ -38447,7 +38615,16 @@ const checkDevicePermission = async function() {
  */ 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 [
+    if (video) {
+        devices = await index_esm_min_index.enumerateDevices();
+        if (isScreenShareSupported()) // @ts-expect-error - add screenShare device to devices
+        devices.push({
+            deviceId: 'screenShare',
+            kind: 'videoinput',
+            label: 'Screen Share',
+            groupId: 'screenShare'
+        });
+    } else devices = await [
         ...await index_esm_min_index.enumerateAudioCaptureDevices(),
         ...await index_esm_min_index.enumerateAudioPlaybackDevices()
     ];
@@ -38462,6 +38639,14 @@ const checkDevicePermission = async function() {
         videoInputs: devices.filter((i)=>i.deviceId && 'videoinput' === i.kind)
     };
 };
+const isScreenShareDevice = (deviceId)=>'screenShare' === deviceId;
+/**
+ * Check if browser supports screen sharing
+ * 检查浏览器是否支持屏幕共享
+ */ function isScreenShareSupported() {
+    var _navigator_mediaDevices, _navigator;
+    return !!(null === (_navigator = navigator) || void 0 === _navigator ? void 0 : null === (_navigator_mediaDevices = _navigator.mediaDevices) || void 0 === _navigator_mediaDevices ? void 0 : _navigator_mediaDevices.getDisplayMedia);
+}
 var error_RealtimeError = /*#__PURE__*/ function(RealtimeError) {
     RealtimeError["DEVICE_ACCESS_ERROR"] = "DEVICE_ACCESS_ERROR";
     RealtimeError["STREAM_CREATION_ERROR"] = "STREAM_CREATION_ERROR";
@@ -38555,6 +38740,10 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * zh: 音频输出设备改变
    */ EventNames["AUDIO_OUTPUT_DEVICE_CHANGED"] = "client.output.device.changed";
     /**
+   * en: Video input device changed
+   * zh: 视频输入设备改变
+   */ EventNames["VIDEO_INPUT_DEVICE_CHANGED"] = "client.video.input.device.changed";
+    /**
    * en: Bot joined
    * zh: Bot 加入
    */ EventNames["BOT_JOIN"] = "server.bot.join";
@@ -41972,23 +42161,47 @@ class EngineClient extends RealtimeEventHandler {
         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 setVideoInputDevice(deviceId) {
+        let isAutoCapture = !(arguments.length > 1) || void 0 === arguments[1] || arguments[1];
+        var _this__videoConfig;
+        const devices = await getAudioDevices({
+            video: true
+        });
+        if (-1 === devices.videoInputs.findIndex((i)=>i.deviceId === deviceId)) throw new RealtimeAPIError(error_RealtimeError.DEVICE_ACCESS_ERROR, `Video input device not found: ${deviceId}`);
+        await this.changeVideoState(false);
+        if (isScreenShareDevice(deviceId)) {
+            if (this._streamIndex === StreamIndex$1.STREAM_INDEX_MAIN) this.engine.setLocalVideoPlayer(StreamIndex$1.STREAM_INDEX_MAIN);
+            if (isAutoCapture) {
+                var _this__videoConfig1;
+                this.engine.setVideoSourceType(StreamIndex$1.STREAM_INDEX_SCREEN, VideoSourceType.VIDEO_SOURCE_TYPE_INTERNAL);
+                await this.engine.startScreenCapture(null === (_this__videoConfig1 = this._videoConfig) || void 0 === _this__videoConfig1 ? void 0 : _this__videoConfig1.screenConfig);
+                await this.engine.publishScreen(MediaType$1.VIDEO);
+            }
+            this._streamIndex = StreamIndex$1.STREAM_INDEX_SCREEN;
+        } else {
+            if (this._streamIndex === StreamIndex$1.STREAM_INDEX_SCREEN) this.engine.setLocalVideoPlayer(StreamIndex$1.STREAM_INDEX_SCREEN);
+            if (isAutoCapture) await this.engine.startVideoCapture(deviceId);
+            this._streamIndex = StreamIndex$1.STREAM_INDEX_MAIN;
+        }
+        this.engine.setLocalVideoPlayer(this._streamIndex, {
+            renderDom: (null === (_this__videoConfig = this._videoConfig) || void 0 === _this__videoConfig ? void 0 : _this__videoConfig.renderDom) || 'local-player',
+            userId: this._roomUserId
+        });
+    }
     async createLocalStream(userId, videoConfig) {
+        this._roomUserId = userId;
         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, {
-            renderDom: (null == videoConfig ? void 0 : videoConfig.renderDom) || 'local-player',
-            userId
-        });
+        if (this._isSupportVideo) this.setVideoInputDevice((null == videoConfig ? void 0 : videoConfig.videoInputDeviceId) || devices.videoInputs[0].deviceId, null == videoConfig ? void 0 : videoConfig.videoOnDefault);
     }
     async disconnect() {
         try {
-            if (this._isSupportVideo) await this.engine.stopVideoCapture();
-            await this.engine.stopAudioCapture();
+            if (this._isSupportVideo) await this.changeVideoState(false);
+            await this.changeAudioState(false);
             await this.engine.unpublishStream(MediaType$1.AUDIO);
             await this.engine.leaveRoom();
             this.removeEventListener();
@@ -42008,8 +42221,19 @@ class EngineClient extends RealtimeEventHandler {
     }
     async changeVideoState(isVideoOn) {
         try {
-            if (isVideoOn) await this.engine.startVideoCapture();
-            else await this.engine.stopVideoCapture();
+            if (isVideoOn) {
+                if (this._streamIndex === StreamIndex$1.STREAM_INDEX_MAIN) await this.engine.startVideoCapture();
+                else {
+                    var _this__videoConfig;
+                    this.engine.setVideoSourceType(StreamIndex$1.STREAM_INDEX_SCREEN, VideoSourceType.VIDEO_SOURCE_TYPE_INTERNAL);
+                    await this.engine.startScreenCapture(null === (_this__videoConfig = this._videoConfig) || void 0 === _this__videoConfig ? void 0 : _this__videoConfig.screenConfig);
+                    await this.engine.publishScreen(MediaType$1.VIDEO);
+                }
+            } else if (this._streamIndex === StreamIndex$1.STREAM_INDEX_MAIN) await this.engine.stopVideoCapture();
+            else {
+                await this.engine.stopScreenCapture();
+                await this.engine.unpublishScreen(MediaType$1.VIDEO);
+            }
         } catch (e) {
             this.dispatch(event_handler_EventNames.ERROR, e);
             throw e;
@@ -42087,7 +42311,7 @@ class EngineClient extends RealtimeEventHandler {
         }
     }
     // eslint-disable-next-line max-params
-    constructor(appId, debug = false, isTestEnv = false, isSupportVideo = false){
+    constructor(appId, debug = false, isTestEnv = false, isSupportVideo = false, videoConfig){
         super(debug), this.joinUserId = '', this._AIAnsExtension = null, this._isSupportVideo = false;
         if (isTestEnv) index_esm_min_index.setParameter('ICE_CONFIG_REQUEST_URLS', [
             'rtc-test.bytedance.com'
@@ -42102,6 +42326,7 @@ class EngineClient extends RealtimeEventHandler {
         this.handleLocalAudioPropertiesReport = this.handleLocalAudioPropertiesReport.bind(this);
         this.handleRemoteAudioPropertiesReport = this.handleRemoteAudioPropertiesReport.bind(this);
         this._isSupportVideo = isSupportVideo;
+        this._videoConfig = videoConfig;
     }
 }
 class RealtimeClient extends RealtimeEventHandler {
@@ -42126,7 +42351,7 @@ class RealtimeClient extends RealtimeEventHandler {
             throw new RealtimeAPIError(error_RealtimeError.CREATE_ROOM_ERROR, error instanceof Error ? error.message : 'Unknown error', error);
         }
         // Step2 create engine
-        this._client = new EngineClient(roomInfo.app_id, this._config.debug, this._isTestEnv, this._isSupportVideo);
+        this._client = new EngineClient(roomInfo.app_id, this._config.debug, this._isTestEnv, this._isSupportVideo, this._config.videoConfig);
         // Step3 bind engine events
         this._client.bindEngineEvents();
         this._client.on(event_handler_EventNames.ALL, (eventName, data)=>{
@@ -42262,6 +42487,13 @@ class RealtimeClient extends RealtimeEventHandler {
             deviceId
         });
     }
+    async setVideoInputDevice(deviceId) {
+        var _this__client;
+        await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.setVideoInputDevice(deviceId));
+        this.dispatch(event_handler_EventNames.VIDEO_INPUT_DEVICE_CHANGED, {
+            deviceId
+        });
+    }
     /**
    * Constructor for initializing a RealtimeClient instance.
    *
@@ -42292,6 +42524,16 @@ class RealtimeClient extends RealtimeEventHandler {
    * @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. |
+   * @param config.videoConfig - Optional, Video configuration. |
+   *                            可选，视频配置。
+   * @param config.videoConfig.videoOnDefault - Optional, Whether to turn on video by default, defaults to true. |
+   *                                            可选，默认是否开启视频，默认值为 true。
+   * @param config.videoConfig.renderDom - Optional, The DOM element to render the video stream to. |
+   *                                       可选，渲染视频流的 DOM 元素。
+   * @param config.videoConfig.videoInputDeviceId - Optional, The device ID of the video input device to use. |
+   *                                               可选，视频输入设备的设备 ID。
+   * @param config.videoConfig.screenConfig - Optional, Screen share configuration if videoInputDeviceId is 'screenShare' see https://www.volcengine.com/docs/6348/104481#screenconfig for more details. |
+   *                                         可选，屏幕共享配置，如果 videoInputDeviceId 是 'screenShare'，请参考 https://www.volcengine.com/docs/6348/104481#screenconfig 了解更多详情。
    */ constructor(config){
         super(config.debug), this._client = null, this.isConnected = false, this._isTestEnv = false, this._isSupportVideo = false;
         this._config = config;