@tencent-rtc/mcp 1.0.7 → 1.1.6

package/resource/doc/roomkit/vue/states/room-participant-state.md

@@ -0,0 +1,388 @@
+# Room Participant State Documentation
+
+
+Room list State API document
+
+
+dependency installation
+
+
+You can choose any of the following methods for dependency installation:
+[npm]
+``` bash
+npm install tuikit-atomicx-vue3@latest --save
+```
+[pnpm]
+``` bash
+pnpm add tuikit-atomicx-vue3@latest
+```
+[yarn]
+``` bash
+yarn add tuikit-atomicx-vue3@latest
+```
+
+
+## Enums
+
+
+### DeviceType
+Device Type Enumeration
+
+
+```typescript
+export enum DeviceType {
+  Microphone
+  Camera = "Camera",            // Camera
+  ScreenShare = "ScreenShare",  // Screen sharing
+}
+```
+
+
+### DeviceStatus
+Device Status Enumeration
+
+
+```typescript
+export enum DeviceStatus {
+  On = "On",    // Enable
+  Off = "Off",  // Disable
+}
+```
+
+
+### NetworkQuality
+Network quality enumeration
+
+
+```typescript
+export enum NetworkQuality {
+  Unknown = 0,    // Unknown
+  Excellent = 1,  // Excellent
+  Good = 2,       // Good
+  3       // Poor
+  Bad = 4,        // Bad
+  VeryBad = 5,    // Poor
+  Down = 6,       // Disconnected
+}
+```
+
+
+### ParticipantRole
+Participant Role Enumeration
+
+
+```typescript
+export enum ParticipantRole {
+  Owner = 0,        // Room owner
+  Admin = 1,        // Admin
+  GeneralUser = 2,  // Regular user
+}
+```
+
+
+### KickedOutOfRoomReason
+Reasons for being kicked out of the room
+
+
+```typescript
+export enum KickedOutOfRoomReason {
+  KickedByAdmin = "KickedByAdmin",                          // Kicked out by admin
+  ReplacedByAnotherDevice = "ReplacedByAnotherDevice",      // Replaced by another device
+  KickedByServer = "KickedByServer",                        // Kicked out by server
+  ConnectionTimeout = "ConnectionTimeout",                   // Connection timeout
+  InvalidStatusOnReconnect = "InvalidStatusOnReconnect",    // Invalid status on reconnect
+  RoomLimitExceeded = "RoomLimitExceeded",                  // Room occupancy limit exceeded
+}
+```
+
+
+## Interfaces
+
+
+### NetworkInfo
+Network information interface
+
+
+```typescript
+export interface NetworkInfo {
+  quality: NetworkQuality;  // Network quality
+  upLoss: number;          // upstream packet loss rate
+  downLoss: number;        // downstream packet loss rate
+  delay: number;           // delay
+}
+```
+
+
+### RoomParticipant
+Participant Information (inherits from RoomUser)
+
+
+```typescript
+export interface RoomParticipant extends RoomUser {
+  nameCard: string;                        // Business card/Nickname
+  role: ParticipantRole;                   // Role
+  microphoneStatus: DeviceStatus;          // Mic status
+  cameraStatus: DeviceStatus;              // Camera status
+  screenShareStatus: DeviceStatus;         // Screen sharing status
+  isMessageDisabled: boolean;              // Whether to disable messages
+  metaData: Record<string, string>;        // Metadata
+}
+```
+
+
+### DeviceRequestInfo
+Device request info
+
+
+```typescript
+export interface DeviceRequestInfo {
+  timestamp: number;          // Timestamp
+  senderUserId: string;       // Sender UID
+  senderUserName: string;     // Sender username
+  senderNameCard: string;     // Sender business card
+  senderAvatarURL: string;    // Sender avatar URL
+  content: string;            // Request content
+  deviceType: DeviceType;     // Device type
+}
+```
+
+
+## IRoomParticipantState Interface
+
+
+Room participant status management API
+
+
+### Properties
+
+
+```typescript
+export interface IRoomParticipantState {
+  participantList: RoomParticipant[];                    // Participant list
+  participantListCursor: string;                         // Participant list cursor
+  participantListWithVideo: RoomParticipant[];           // List of participants with video enabled
+  participantWithScreen: RoomParticipant | null;         // Participant with ongoing screen sharing
+  pendingDeviceApplications: DeviceRequestInfo[];        // Pending equipment applications
+  pendingDeviceInvitations: DeviceRequestInfo[];         // Pending device invitations
+  speakingUsers: Map<string, number>;                    // Users currently speaking (uid -> volume)
+  networkQualities: Map<string, NetworkInfo>;            // Network quality information (uid -> network info)
+  
+  readonly localParticipant: RoomParticipant | null;     // Local participant information (read-only)
+}
+```
+
+
+### Methods
+
+
+#### Participant Management
+
+
+- **getParticipantList(options: { cursor?: string, count?: number }): Promise<RoomParticipant[]>**
+  -Get the participant list
+
+
+#### Role Management
+
+
+- **transferOwner(options: { userId: string }): Promise<void>**
+  -Transfer owner permission
+
+
+- **setAdmin(options: { userId: string }): Promise<void>**
+  -Set administrator
+
+
+- **revokeAdmin(options: { userId: string }): Promise<void>**
+  - Revoke admin permission
+
+
+- **kickParticipant(options: { userId: string }): Promise<void>**
+  - Kick out participant
+
+
+#### Participant Information Management
+
+
+- **updateParticipantNameCard(options: { userId: string, nameCard: string }): Promise<void>**
+  - Update participant business card
+
+
+- **updateParticipantMetaData(options: { userId: string, metaData: Record<string, string> }): Promise<void>**
+  - Update participant metadata
+
+
+Device control
+
+
+- **closeParticipantDevice(options: { userId: string, deviceType: DeviceType }): Promise<void>**
+  -Turn off participant device
+
+
+- **muteParticipantMessage(options: { userId: string, mute: boolean }): Promise<void>**
+  - Mute/Unblock participant
+
+
+- **disableAllDevices(options: { deviceType: DeviceType, disable: boolean }): Promise<void>**
+  - Disable/Enable all devices
+
+
+- **disableAllMessages(options: { disable: boolean }): Promise<void>**
+  -Disable/Enable all messages
+
+
+#### Device Request Management
+
+
+- **requestToOpenDevice(options: { device: DeviceType; timeout?: number }): Promise<void>**
+  -Request to turn on the device
+
+
+- **cancelOpenDeviceRequest(options: { device: DeviceType }): Promise<void>**
+  -Cancel device start request
+
+
+- **approveOpenDeviceRequest(options: { device: DeviceType; userId: string }): Promise<void>**
+  - Approve device start request
+
+
+- **rejectOpenDeviceRequest(options: { device: DeviceType; userId: string; }): Promise<void>**
+  - Deny device start request
+
+
+#### Device Invitation Management
+
+
+- **inviteToOpenDevice(options: { device: DeviceType; userId: string; timeout?: number }): Promise<void>**
+  - Device enabling invitation
+
+
+- **cancelOpenDeviceInvitation(options: { device: DeviceType; userId: string }): Promise<void>**
+  - Cancel device enabling invitation
+
+
+- **acceptOpenDeviceInvitation(options: {device: DeviceType; userId: string; }): Promise<void>**
+  -Accept device enabling invitation
+
+
+- **declineOpenDeviceInvitation(options: {device: DeviceType; userId: string; }): Promise<void>**
+  - Deny device enabling invitation
+
+
+### Event Handlers
+
+
+#### Participant status event
+
+
+- **onParticipantJoined: (options: { participant: RoomParticipant }) => void**
+  - Trigger when a participant joins
+
+
+- **onParticipantLeft: (options: { participant: RoomParticipant }) => void**
+  - Trigger when a participant leaves
+
+
+#### Role change event
+
+
+- **onOwnerChanged: (options: { newOwner: RoomParticipant }) => void**
+  - Trigger on host change
+
+
+- **onAdminSet: (options: { userInfo: RoomParticipant }) => void**
+  - Trigger when setting administrator
+
+
+- **onAdminRevoked: (options: { userInfo: RoomParticipant }) => void**
+  - Trigger when revoking admin
+
+
+#### Room management event
+
+
+- **onKickedFromRoom: (options: { reason: KickedOutOfRoomReason, message: string }) => void**
+  - Trigger when being kicked out of the room
+
+
+#### Device control event
+
+
+- **onParticipantDeviceClosed: (options: { userId: string, device: DeviceType, operator: RoomUser }) => void**
+  - Trigger when a participant's device is closed
+
+
+- **onParticipantMessageMuted: (options: { userId: string, muted: boolean, operator: RoomUser }) => void**
+  - Trigger when a participant is muted/unblocked
+
+
+- **onAllDevicesDisabled: (options: { device: DeviceType, disable: boolean, operator: RoomUser }) => void**
+  -Trigger when all devices are disabled/enabled
+
+
+- **onAllMessagesDisabled: (options: { disable: boolean, operator: RoomUser }) => void**
+  - Trigger when all messages are disabled/enabled
+
+
+#### Device Request Event
+
+
+- **onDeviceRequestReceived: (options: { request: DeviceRequestInfo }) => void**
+  - Trigger when a device request is received
+
+
+- **onDeviceRequestCancelled: (options: { request: DeviceRequestInfo }) => void**
+  - Trigger when a device request is canceled
+
+
+- **onDeviceRequestTimeout: (options: { request: DeviceRequestInfo }) => void**
+  - Trigger when a device request times out
+
+
+- **onDeviceRequestApproved: (options: { request: DeviceRequestInfo, operator: RoomUser }) => void**
+  - Trigger when a device request is approved
+
+
+- **onDeviceRequestRejected: (options: { request: DeviceRequestInfo, operator: RoomUser }) => void**
+  -Trigger when a device request is rejected
+
+
+- **onDeviceRequestProcessed: (options: { request: DeviceRequestInfo, operator: RoomUser }) => void**
+  - Trigger when a device request is processed
+
+
+#### Device Invitation Event
+
+
+- **onDeviceInvitationReceived: (options: { invitation: DeviceRequestInfo }) => void**
+  - Trigger when a device invitation is received
+
+
+- **onDeviceInvitationCancelled: (options: { invitation: DeviceRequestInfo }) => void**
+  - Trigger when a device invitation is cancelled
+
+
+- **onDeviceInvitationTimeout: (options: { invitation: DeviceRequestInfo }) => void**
+  - Trigger when a device invitation times out
+
+
+- **onDeviceInvitationAccepted: (options: { invitation: DeviceRequestInfo, operator: RoomUser }) => void**
+  - Trigger when a device invitation is accepted
+
+
+- **onDeviceInvitationDeclined: (options: { invitation: DeviceRequestInfo, operator: RoomUser }) => void**
+  - Trigger when a device invitation is rejected
+
+
+### Example
+
+
+API and event usage example
+```typescript
+import { useRoomParticipantState } from 'tuikit-atomicx-vue3';
+const {
+  getParticipantList,
+    subscribeEvent,
+  unsubscribeEvent
+} = useRoomParticipantState();
+```

package/server-config.js

@@ -0,0 +1,35 @@
+import { aegisClient } from './utils/aegis-client.js';
+class ServerConfig {
+    static instance;
+    config;
+    constructor() {
+        this.config = this.parseEnvConfig();
+    }
+    static getInstance() {
+        if (!ServerConfig.instance) {
+            ServerConfig.instance = new ServerConfig();
+        }
+        return ServerConfig.instance;
+    }
+    parseEnvConfig() {
+        const config = {};
+        const { SDKAPPID, SECRETKEY } = process.env || {};
+        if (SDKAPPID) {
+            config.SDKAppID = SDKAPPID;
+            aegisClient.report({
+                name: 'mcp_config',
+                ext1: SDKAPPID,
+                from: 'en',
+            });
+        }
+        if (SECRETKEY) {
+            config.secretKey = SECRETKEY;
+        }
+        return config;
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+}
+export { ServerConfig, };
+//# sourceMappingURL=server-config.js.map

package/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../src/server-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,YAAY;IAChB,MAAM,CAAC,QAAQ,CAAe;IACtB,MAAM,CAAsB;IACpC;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAEO,cAAc;QACpB,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC3B,WAAW,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;QACL,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,SAAS;QACd,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AAED,OAAO,EACL,YAAY,GACb,CAAC"}

package/tools/call/{get-native-call-integration-guide.js → get-native-call-integration.js}

@@ -2,7 +2,6 @@ import { z } from 'zod';
 import { getDocContent } from '../../utils/get-doc-content.js';
 import { aegisClient } from '../../utils/aegis-client.js';
 const description = `
-
 This is a tool specifically designed for creating native mobile audio and video call applications. With the tool, you can achieve the following functions: | 这是一个专门负责创建移动端 native 音视频通话应用的工具，通过工具您可以实现以下功能：\n
 1. Create a native audio and video calling app with functionality and UI similar to the audio and video calling capabilities in WeChat or WeChat for Business. | 1. 创建一个 native 音视频通话应用，功能和 UI 界面类似微信（WeChat）或者企业微信（企微）中音视频通话能力 \n
 2. The tool provides Call UIKit component integration solutions for multiple platforms or frameworks, including flutter (cross-platform), android (native), and ios (native). You can choose one of these platforms or frameworks to build a mobile native audio and video call project. | 2. 工具提供 flutter(跨平台)、android(原生)、ios(原生) 多种平台或框架的 Call UIKit 组件集成方案，您可以根据需要选择其中一个平台或框架搭建一个移动端 native 音视频通话项目 \n
@@ -11,15 +10,15 @@ This is a tool specifically designed for creating native mobile audio and video
 function getResultText(params) {
     const { sdkAppId = '', framework = '' } = params;
     aegisClient.report({
-        name: 'get_native_call_uikit_integration_guide',
+        name: 'get_native_call_uikit_integration',
         ext1: sdkAppId,
         ext2: framework,
         from: 'en',
     });
     return getDocContent(['tuicallkit', `${framework}`]);
 }
-const registryGetNativeCallIntegrationGuideTool = (mcpServer) => {
-    mcpServer.tool('get_native_call_uikit_integration_guide', description, {
+const registryGetNativeCallIntegrationTool = (mcpServer) => {
+    mcpServer.tool('get_native_call_uikit_integration', description, {
         framework: z.enum(['flutter', 'android', 'ios']).describe('The platform type of the native call UIKit component library. You first need to choose which platform to use to create your chat application. Currently supported frameworks are: Flutter, Android, and iOS. | native call uikit 组件库的平台类型，您首先需要选择使用哪一种来平台来创建您的聊天应用，目前支持的框架有：flutter, android, ios。'),
         sdkAppId: z.string().describe(`Your application's SDKAppID. | 您的应用的 SDKAppID。`),
         secretKey: z.string().describe(`The secretKey of your SDKAppID. ｜您的 SDKAppID 的 secretKey。`),
@@ -32,5 +31,5 @@ const registryGetNativeCallIntegrationGuideTool = (mcpServer) => {
         ]
     }));
 };
-export { registryGetNativeCallIntegrationGuideTool };
-//# sourceMappingURL=get-native-call-integration-guide.js.map
+export { registryGetNativeCallIntegrationTool };
+//# sourceMappingURL=get-native-call-integration.js.map

package/tools/call/get-native-call-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-native-call-integration.js","sourceRoot":"","sources":["../../../src/tools/call/get-native-call-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,GAAG;;;;;CAKnB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAG,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAClD,WAAW,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,mCAAmC;QACzC,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,YAAY,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,oCAAoC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACpE,SAAS,CAAC,IAAI,CACZ,mCAAmC,EACnC,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,oSAAoS,CAAC;QAC/V,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAC/E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;KAC5F,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,oCAAoC,EAAE,CAAC"}

package/tools/call/{get-web-call-integration-guide.js → get-web-call-integration.js}

@@ -10,18 +10,18 @@ This is a tool specifically designed for creating web audio and video call appli
 function getResultText(params) {
     const { sdkAppId = '', framework = '' } = params;
     aegisClient.report({
-        name: 'get_web_call_uikit_integration_guide',
+        name: 'get_web_call_uikit_integration',
         ext1: sdkAppId,
         ext2: framework,
         from: 'en',
     });
     return getDocContent(['tuicallkit', `${framework}`]);
 }
-const registryGetWebCallIntegrationGuideTool = (mcpServer) => {
-    mcpServer.tool('get_web_call_uikit_integration_guide', description, {
+const registryGetWebCallIntegrationTool = (mcpServer) => {
+    mcpServer.tool('get_web_call_uikit_integration', description, {
         framework: z.enum(['react', 'vue']).describe('The platform type of the web call UIKit component library. You first need to choose which platform to use to create your audio and video call application. Currently supported frameworks are: React and Vue. ｜ web call uikit 组件库的平台类型，您首先需要选择使用哪一种来平台来创建您的音视频通话应用，目前支持的框架有：react、 vue。'),
-        sdkAppId: z.string().describe(`Your application's SDKAppID. | 您的应用的 SDKAppID。`),
-        secretKey: z.string().describe(`The secretKey of your SDKAppID. ｜您的 SDKAppID 的 secretKey。`),
+        sdkAppId: z.string().optional().describe(`Your application's SDKAppID. | 您的应用的 SDKAppID。`),
+        // secretKey: z.string().describe(`The secretKey of your SDKAppID. ｜您的 SDKAppID 的 secretKey。`),
     }, (params) => ({
         content: [
             {
@@ -31,5 +31,5 @@ const registryGetWebCallIntegrationGuideTool = (mcpServer) => {
         ]
     }));
 };
-export { registryGetWebCallIntegrationGuideTool };
-//# sourceMappingURL=get-web-call-integration-guide.js.map
+export { registryGetWebCallIntegrationTool };
+//# sourceMappingURL=get-web-call-integration.js.map

package/tools/call/get-web-call-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-web-call-integration.js","sourceRoot":"","sources":["../../../src/tools/call/get-web-call-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,GAAG;;;;;CAKnB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAG,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAChD,WAAW,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,gCAAgC;QACtC,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,YAAY,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,iCAAiC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACjE,SAAS,CAAC,IAAI,CACZ,gCAAgC,EAChC,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,0RAA0R,CAAC;QACxU,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAC1F,+FAA+F;KAChG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,iCAAiC,EAAE,CAAC"}

package/tools/chat/create-group.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { getDocContent } from '../../utils/get-doc-content.js';
+import { aegisClient } from '../../utils/aegis-client.js';
+import { handleFramework } from '../../utils/handle-framework.js';
+const description = `
+This is a tool specifically responsible for helping users create group conversations. When the tool is called, an experience group is automatically created through the sample code in the document. | 这是一个专门负责帮用户创建群组会话的工具，调用工具时通过文档中的示例代码自动一个体验群组。\n
+`;
+function getResultText(params) {
+    const { framework = '' } = params;
+    aegisClient.report({
+        name: 'get_web_create_group_doc',
+        ext2: framework,
+        from: 'en',
+    });
+    return getDocContent(['chatuikit', `${handleFramework(framework)}`, 'create-group.md']);
+}
+const registryGetWebCreateGroupTool = (mcpServer) => {
+    mcpServer.tool('get_web_create_group_doc', description, {
+        framework: z.enum(['react', 'vue']).describe('Chat UIKit creates a group API. Frameworks supported are: React, Vue. | Chat UIKit 创建群组 API 支持的框架有：react、vue。'),
+    }, (params) => ({
+        content: [
+            {
+                type: 'text',
+                text: getResultText(params),
+            }
+        ]
+    }));
+};
+export { registryGetWebCreateGroupTool };
+//# sourceMappingURL=create-group.js.map

package/tools/chat/create-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-group.js","sourceRoot":"","sources":["../../../src/tools/chat/create-group.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,WAAW,GAAG;;CAEnB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAClC,WAAW,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,6BAA6B,GAAG,CAAC,SAAoB,EAAE,EAAE;IAC7D,SAAS,CAAC,IAAI,CACZ,0BAA0B,EAC1B,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,+GAA+G,CAAC;KAC9J,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,6BAA6B,EAAE,CAAC"}

package/tools/chat/get-chat-faq.js

@@ -2,8 +2,8 @@ import { z } from 'zod';
 import { getDocContent } from '../../utils/get-doc-content.js';
 import { aegisClient } from '../../utils/aegis-client.js';
 const description = `
-This is a tool specifically designed to solve common problems with Chat applications. Through the tool, you can get the following: | 这是一个专门负责解决 Chat 聊天应用常见问题的工具，通过工具您可以获取以下内容：\n
-1. Get answers to frequently asked questions about building chat apps on mobile (native), web, react, vue, and other related platforms or frameworks | 1. 可以获取到移动端(native)、web 端 react、vue 等相关平台或框架搭建聊天应用的常见问题解答 \n
+This is a tool specifically designed to provide solutions to common problems encountered in chat applications. Users can access this tool when they need a solution to a problem. | 这是一个专门负责提供 Chat 聊天应用中常见问题解决方案的工具，当用户查询某个问题解决方案时，可以调用这个工具：\n
+1. Get answers to frequently asked questions about building chat apps on mobile (native), web, react, vue, and other related platforms or frameworks. | 1. 可以获取到移动端(native)、web 端 react、vue 等相关平台或框架搭建聊天应用的常见问题解答 \n
 `;
 function getResultText(params) {
     const { sdkAppId = '', question = '' } = params;
@@ -18,7 +18,7 @@ function getResultText(params) {
 const registryGetChatFaqTool = (mcpServer) => {
     mcpServer.tool('get_chat_faq', description, {
         question: z.string().describe('Please describe your issue. | 请描述你的问题'),
-        sdkAppId: z.string().describe(`Your application's SDKAppID. | 您的应用的 SDKAppID`)
+        sdkAppId: z.string().optional().describe(`Your application's SDKAppID. | 您的应用的 SDKAppID`)
     }, (params) => ({
         content: [
             {

package/tools/chat/get-chat-faq.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-chat-faq.js","sourceRoot":"","sources":["../../../src/tools/chat/get-chat-faq.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,GAAG;;;CAGnB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAChD,WAAW,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,sBAAsB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACtD,SAAS,CAAC,IAAI,CACZ,cAAc,EACd,WAAW,EACX;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;KAC/E,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"get-chat-faq.js","sourceRoot":"","sources":["../../../src/tools/chat/get-chat-faq.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,GAAG;;;CAGnB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAChD,WAAW,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,sBAAsB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACtD,SAAS,CAAC,IAAI,CACZ,cAAc,EACd,WAAW,EACX;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;KAC1F,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/tools/chat/get-native-chat-integration.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { getDocContent } from '../../utils/get-doc-content.js';
+import { aegisClient } from '../../utils/aegis-client.js';
+const description = `
+This is a tool specifically designed for creating native mobile chat applications. Users can use this tool when they need to create a native chat application, and it provides the following functions: | 这是一个专门负责创建移动端 native 聊天应用的工具，当用户需要创建一个 native 聊天应用时可以调用这个工具，提供以下功能：\n
+1. Create a native chat app with functionality and UI similar to WeChat or WeCom. | 1. 创建一个 native 聊天应用，功能和 UI 界面类似微信（WeChat）或者企业微信（企微）。\n
+2. The tool provides Chat TUIKit component integration solutions for multiple platforms or frameworks, including Flutter (cross-platform), Android (native), and iOS (native). A mobile native chat project needs to be built based on the user's choice. | 2. 工具提供 flutter(跨平台)、android(原生)、ios(原生) 多种平台(platform)或框架(framework)的 Chat TUIKit 组件集成方案，需要根据用户的选择来搭实现一个移动端 native 聊天项目。\n
+3. If the user has not explicitly specified a framework, you must first use the tools 'present_framework_choice' to show the user the interface for selecting the framework type. ｜ 3. 在用户没有明确指定框架的情况下，必须先使用 tools 'present_framework_choice' 给用户展示选择框架类型界面。\n
+`;
+function getResultText(params) {
+    const { sdkAppId = '', framework = '' } = params;
+    aegisClient.report({
+        name: 'get_native_chat_uikit_integration',
+        ext1: sdkAppId,
+        ext2: framework,
+        from: 'en',
+    });
+    return getDocContent(['chatuikit', `${framework}`]);
+}
+const registryGetNativeChatIntegrationTool = (mcpServer) => {
+    mcpServer.tool('get_native_chat_uikit_integration', description, {
+        framework: z.enum(['flutter', 'android', 'ios']).describe('The platform type of the Native Chat UIKit component library. You first need to choose which platform to use to create your chat application. Currently supported frameworks or platforms are: Flutter, Android, and iOS. ｜ native chat uikit 组件库的平台类型，您首先需要选择使用哪一种来平台来创建您的聊天应用，目前支持的框架或平台有：flutter, android, ios。'),
+        sdkAppId: z.string().describe(`Your application's SDKAppID. | 您的应用的 SDKAppID`),
+    }, (params) => ({
+        content: [
+            {
+                type: 'text',
+                text: getResultText(params),
+            }
+        ]
+    }));
+};
+export { registryGetNativeChatIntegrationTool };
+//# sourceMappingURL=get-native-chat-integration.js.map

package/tools/chat/get-native-chat-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-native-chat-integration.js","sourceRoot":"","sources":["../../../src/tools/chat/get-native-chat-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,GAAG;;;;;CAKnB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IACjD,WAAW,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,mCAAmC;QACzC,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,oCAAoC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACpE,SAAS,CAAC,IAAI,CACZ,mCAAmC,EACnC,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,oTAAoT,CAAC;QAC/W,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;KAC/E,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,oCAAoC,EAAE,CAAC"}

package/tools/chat/get-web-chat-component-detail.js

@@ -1,10 +1,14 @@
 import { z } from 'zod';
 import { getDocContent } from '../../utils/get-doc-content.js';
 import { aegisClient } from '../../utils/aegis-client.js';
+import { handleFramework } from '../../utils/handle-framework.js';
+import { handleComponentName } from '../../utils/handle-component-name.js';
 const description = `
-This is a tool that provides detailed descriptions of UI components for web chat applications. You will get the following: ｜ 这是一个专门负责提供 web 聊天应用 UI 组件详情说明的工具，通过工具您获得以下内容：\n
-1. The tool provides detailed usage and examples of Chat UIKit components for react and vue3. You can choose one of the frameworks to learn more about the component details as needed. ｜ 1. 工具提供 react、vue3 两种框架的 Chat UIKit 组件详细用法和案例，您可以根据需要选择其中一个框架的组件详情进行了解 \n
-2. If no specific framework is specified, you must first use the tools tool present_framework_choice to display the framework type selection interface. | 2. 在没有指定特定框架(framework)的情况下，必须优先使用 tools 工具 present_framework_choice 展示选择框架类型界面。 \n
+
+This is a tool specifically designed to provide detailed descriptions of UIKit components for online chat applications. Through this tool, you will obtain the following: | 这是一个专门负责提供 web 聊天应用 UIKit 组件详情说明的工具，通过工具您获得以下内容：\n
+1. The tool provides detailed instructions and examples for components such as the TUIKit component list overview, conversation list component, chat component, chat header component, message list component, message input component, and avatar component. | 1. 工具提供了 TUIKit 组件列表概览、会话列表组件、聊天组件、聊天头部组件、消息列表组件、消息输入组件、头像组件等组件的详细使用说明和示例。 \n
+2. The tool provides detailed usage examples and case studies for Chat TUIKit components in both React and Vue frameworks. Users can choose the component details for one of the frameworks according to their needs. | 2. 工具提供 react、vue 两种框架的 Chat TUIKit 组件详细用法和案例，根据用户的需要选择其中一个框架的组件详情。\n
+3. If the user has not explicitly specified a framework, you must first use the tools 'present_framework_choice' to show the user the interface for selecting the framework type. ｜ 3. 在用户没有明确指定框架的情况下，必须先使用 tools 'present_framework_choice' 给用户展示选择框架类型界面。\n
 `;
 function getResultText(params) {
     const { framework, componentName = '' } = params;
@@ -14,11 +18,11 @@ function getResultText(params) {
         ext2: framework,
         from: 'en',
     });
-    return getDocContent(['chatuikit', `${framework}`, 'components', `${componentName.toLowerCase()}.md`]);
+    return getDocContent(['chatuikit', `${handleFramework(framework)}`, 'components', `${handleComponentName(componentName)}.md`]);
 }
 const registryGetWebChatComponentDetailTool = (mcpServer) => {
     mcpServer.tool('get_web_chat_uikit_component_detail', description, {
-        framework: z.enum(['react', 'vue3']).describe('Web Chat UIKit component details framework type, currently supported frameworks are: react, vue3 | web chat uikit 组件详情框架类型，目前支持的框架有： react、vue3'),
+        framework: z.enum(['react', 'vue']).describe('Web Chat UIKit component details framework type, currently supported frameworks are: react, vue | web chat uikit 组件详情框架类型，目前支持的框架有： react、vue'),
         componentName: z.string().describe('The specific component name of the web chat UIKit component, such as avatar | web chat uikit 组件的具体组件名称，比如 avatar'),
     }, (params) => ({
         content: [

package/tools/chat/get-web-chat-component-detail.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-web-chat-component-detail.js","sourceRoot":"","sources":["../../../src/tools/chat/get-web-chat-component-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,GAAG;;;;CAInB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IACjD,WAAW,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,EAAE,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,qCAAqC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACrE,SAAS,CAAC,IAAI,CACZ,qCAAqC,EACrC,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,iJAAiJ,CAAC;QAChM,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kHAAkH,CAAC;KACvJ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,qCAAqC,EAAE,CAAC"}
+{"version":3,"file":"get-web-chat-component-detail.js","sourceRoot":"","sources":["../../../src/tools/chat/get-web-chat-component-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,MAAM,WAAW,GAAG;;;;;;CAMnB,CAAC;AAEF,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IACjD,WAAW,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACjI,CAAC;AAED,MAAM,qCAAqC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACrE,SAAS,CAAC,IAAI,CACZ,qCAAqC,EACrC,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,+IAA+I,CAAC;QAC7L,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kHAAkH,CAAC;KACvJ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,qCAAqC,EAAE,CAAC"}