@tencent-rtc/mcp 1.3.0 → 1.3.2

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

@@ -1,388 +0,0 @@
-# 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/tools/chat/get-web-chat-window-integration.js

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import { GET_WEB_CHAT_WINDOW_INTEGRATION_DEFINITION } from '../definitions/get_web_chat_window_integration_def.js';
-import { getDocContent } from '../../utils/get-doc-content.js';
-import { reportCLSClient } from '../../utils/report-cls-client.js';
-import { handleFramework } from '../../utils/handle-framework.js';
-function getResultText(params) {
-    const { framework = '' } = params;
-    reportCLSClient({
-        method: 'get_web_chat_window_integration',
-        framework: framework,
-    });
-    return getDocContent(['chatuikit', `${handleFramework(framework)}`, 'chat_window_integration.md']);
-}
-const registryGetWebChatWindowIntegrationTool = (mcpServer) => {
-    const { name, description, parameter_descriptions } = GET_WEB_CHAT_WINDOW_INTEGRATION_DEFINITION;
-    mcpServer.tool(name, description, {
-        framework: z.enum(['react', 'vue']).describe(parameter_descriptions.framework),
-    }, (params) => ({
-        content: [
-            {
-                type: 'text',
-                text: getResultText(params),
-            }
-        ]
-    }));
-};
-export { registryGetWebChatWindowIntegrationTool };
-//# sourceMappingURL=get-web-chat-window-integration.js.map

package/tools/chat/get-web-chat-window-integration.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-web-chat-window-integration.js","sourceRoot":"","sources":["../../../src/tools/chat/get-web-chat-window-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0CAA0C,EAAE,MAAM,uDAAuD,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAClC,eAAe,CAAC;QACd,MAAM,EAAE,iCAAiC;QACzC,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,uCAAuC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACvE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,0CAA0C,CAAC;IACjG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,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,uCAAuC,EAAE,CAAC"}

package/tools/definitions/get_web_chat_window_integration_def.js

@@ -1,26 +0,0 @@
-const TOOL_DESCRIPTION = `
-[CORE FUNCTION]: Specialized for Web Standalone Chat Window Integration, providing the solution for creating a single chat window component using TUIKit on Web or H5 platforms.\n
-
-[SCOPE]:\n
-1. Builds a standalone component interface with functionality and UI similar to a WeChat or WeChat Work chat window.\n
-2. Supports UI component libraries for both React and Vue mainstream frameworks.\n
-3. The window entry can be set on a TabBar as needed.\n
-
-[KEYWORDS]: 'Web', 'H5', 'Standalone Chat Window', 'TUIKit', 'React', 'Vue', 'Integration', 'TabBar'.\n
-
-[MANDATORY CONSTRAINTS]:\n
-1. Framework Selection Constraint: If the user has not explicitly specified the React or Vue framework in the prompt, the tool MUST prioritize calling 'present_framework_choice' to guide the user to make a selection.\n
-2. Result Recording Constraint: After the TUIKit component integration is complete and the project successfully starts, the tool MUST call 'record_result' to log the integration outcome.\n
-
-[NOTES]:\n
-- When integrating the Vue version, please install @tencentcloud/chat-uikit-vue3.
-`;
-const PARAMETER_DESCRIPTIONS = {
-    framework: 'The Web Chat TUIKit framework type. Options: react, vue. Used to determine which framework\'s standalone chat window integration solution to provide.',
-};
-export const GET_WEB_CHAT_WINDOW_INTEGRATION_DEFINITION = {
-    name: 'get_web_chat_window_integration',
-    description: TOOL_DESCRIPTION,
-    parameter_descriptions: PARAMETER_DESCRIPTIONS,
-};
-//# sourceMappingURL=get_web_chat_window_integration_def.js.map

package/tools/definitions/get_web_chat_window_integration_def.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get_web_chat_window_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_web_chat_window_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;CAgBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,uJAAuJ;CACnK,CAAC;AAEF,MAAM,CAAC,MAAM,0CAA0C,GAAG;IACxD,IAAI,EAAE,iCAAiC;IACvC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/room/get-web-room-state-detail.js

@@ -1,31 +0,0 @@
-import { z } from 'zod';
-import { GET_WEB_ROOM_STATE_DETAIL_DEFINITION } from '../definitions/get_web_room_state_detail_def.js';
-import { getDocContent } from '../../utils/get-doc-content.js';
-import { reportCLSClient } from '../../utils/report-cls-client.js';
-import { handleFramework } from '../../utils/handle-framework.js';
-import { handleStateName } from '../../utils/handle-state-name.js';
-function getResultText(params) {
-    const { framework, componentName = '' } = params;
-    reportCLSClient({
-        method: 'get_web_room_state_detail',
-        info: componentName,
-        framework: framework,
-    });
-    return getDocContent(['roomkit', `${handleFramework(framework)}`, 'states', `${handleStateName(componentName)}.md`]);
-}
-const registryGetWebRoomStateDetailTool = (mcpServer) => {
-    const { name, description, parameter_descriptions } = GET_WEB_ROOM_STATE_DETAIL_DEFINITION;
-    mcpServer.tool(name, description, {
-        framework: z.enum(['vue']).describe(parameter_descriptions.framework),
-        componentName: z.string().describe(parameter_descriptions.componentName),
-    }, (params) => ({
-        content: [
-            {
-                type: 'text',
-                text: getResultText(params),
-            }
-        ]
-    }));
-};
-export { registryGetWebRoomStateDetailTool };
-//# sourceMappingURL=get-web-room-state-detail.js.map

package/tools/room/get-web-room-state-detail.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-web-room-state-detail.js","sourceRoot":"","sources":["../../../src/tools/room/get-web-room-state-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oCAAoC,EAAE,MAAM,iDAAiD,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IACjD,eAAe,CAAC;QACd,MAAM,EAAE,2BAA2B;QACnC,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,SAAS,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACvH,CAAC;AAED,MAAM,iCAAiC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACjE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,oCAAoC,CAAC;IAC3F,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QACrE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,aAAa,CAAC;KACzE,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"}