@tencent-rtc/mcp 1.3.4 → 1.3.5

package/resource/doc/rtcengine/web/plugin/42-advanced-realtime-transcriber.md

@@ -0,0 +1,315 @@
+## Overview
+
+This document describes how to use the Realtime Transcriber plugin to enable real-time speech-to-text (ASR) and translation capabilities. This plugin can convert users' speech in a room to text in real-time and supports translation into multiple languages.
+
+## Prerequisites
+
+- TRTC Web SDK version >= 5.15.0
+
+## Implementation
+
+### Import and Register Plugin
+
+```javascript
+import TRTC from 'trtc-sdk-v5';
+import RealtimeTranscriber from 'trtc-sdk-v5/plugins/realtime-transcriber';
+
+const trtc = TRTC.create({ plugins: [RealtimeTranscriber] });
+```
+
+### Start Plugin
+
+Starting the plugin returns a `transcriberRobotId`, which is used to stop the transcription task later.
+
+```javascript
+const transcriberRobotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh',
+  translationLanguages: ['en', 'ja'],
+  userIdsToTranscribe: 'all',
+});
+```
+
+### Listen for Transcription Messages
+
+Listen to the `REALTIME_TRANSCRIBER_MESSAGE` event to receive transcription results.
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  console.log(`${event.speakerUserId}: ${event.sourceText}`);
+  if (event.translationTexts) {
+    Object.entries(event.translationTexts).forEach(([lang, text]) => {
+      console.log(`  ${lang}: ${text}`);
+    });
+  }
+});
+```
+
+### Listen for State Changes
+
+Listen to the `REALTIME_TRANSCRIBER_STATE_CHANGED` event to receive transcription task state changes.
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
+  console.log(`Transcription state: ${event.state}, robotId: ${event.transcriberRobotId}`);
+});
+```
+
+### Stop Plugin
+
+```javascript
+await trtc.stopPlugin('RealtimeTranscriber', { transcriberRobotId });
+```
+
+## Usage Examples
+
+### ASR Scenario: Transcribe Audio to Text
+
+```javascript
+// Start transcription task
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh'
+});
+
+// Listen for transcription messages
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (data) => {
+  console.log(data.speakerUserId + ' says: ' + data.sourceText);
+});
+```
+
+### Translation Scenario: Translate Specific User's Speech into Multiple Languages
+
+```javascript
+// Start transcription task, transcribe userA's speech and translate to French and English
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh',
+  translationLanguages: ['fr', 'en'],
+  userIdsToTranscribe: 'userA'
+});
+
+// Listen for transcription messages
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (data) => {
+  console.log(`👤 ${data.speakerUserId}:`);
+  console.log(`  Original: ${data.sourceText}`);
+  
+  if (data.translationTexts) {
+    Object.entries(data.translationTexts).forEach(([lang, text]) => {
+      console.log(`  ${lang.toUpperCase()}: ${text}`);
+    });
+  }
+});
+```
+
+### Transcribe Multiple Specific Users
+
+```javascript
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'en',
+  translationLanguages: ['zh', 'ja'],
+  userIdsToTranscribe: ['userA', 'userB', 'userC']
+});
+```
+
+## API Reference
+
+### trtc.startPlugin('RealtimeTranscriber', options)
+
+Starts a real-time transcription task.
+
+**options: RealtimeTranscriberStartOptions**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| sourceLanguage | `string` | Required | Source language code, currently supports only `'zh'` and `'en'` |
+| translationLanguages | `string` \| `string[]` | Optional | Target translation language(s), supports single language or array, e.g., `'en'` or `['en', 'ja']` |
+| userIdsToTranscribe | `string` \| `string[]` | Optional | User ID(s) to transcribe, defaults to `'all'` for all users, can also specify single or multiple user IDs |
+| transcriberRobotId | `string` | Optional | Custom transcriber robot ID, auto-generated if not provided |
+
+**Returns: Promise\<string\>**
+
+Returns the `transcriberRobotId` for the transcription task, used to stop the task later.
+
+**Example:**
+
+```javascript
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh',
+  translationLanguages: ['en', 'ja'],
+  userIdsToTranscribe: 'all',
+});
+```
+
+### trtc.stopPlugin('RealtimeTranscriber', options)
+
+Stops a real-time transcription task.
+
+**options**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| transcriberRobotId | `string` | Required | The transcriber robot ID returned when starting |
+
+**Example:**
+
+```javascript
+await trtc.stopPlugin('RealtimeTranscriber', { transcriberRobotId: robotId });
+```
+
+## Event Reference
+
+### TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED
+
+Transcription task state change event.
+
+**RealtimeTranscriberStateEvent**
+
+| Name | Type | Description |
+|------|------|-------------|
+| state | `'started'` \| `'stopped'` | Transcription task state |
+| roomId | `string` \| `number` | Room ID |
+| transcriberRobotId | `string` | Transcriber robot ID |
+| sourceLanguage | `string` | Source language (optional) |
+| error | `number` | Error code (optional) |
+| errorMessage | `string` | Error message (optional) |
+
+**Example:**
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
+  if (event.state === 'started') {
+    console.log('Transcription task started');
+  } else if (event.state === 'stopped') {
+    console.log('Transcription task stopped');
+  }
+});
+```
+
+### TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE
+
+Transcription message event, triggered when new transcription results are available.
+
+**RealtimeTranscriberMessageEvent**
+
+| Name | Type | Description |
+|------|------|-------------|
+| segmentId | `string` | Speech segment ID, used to identify a continuous speech segment |
+| speakerUserId | `string` | Speaker's user ID |
+| sourceText | `string` | Transcribed source text |
+| translationTexts | `Array<{ language: string, text: string }>` | Translation texts array, e.g., `[{ language: 'en', text: 'hello' }, { language: 'ja', text: 'こんにちは' }]` |
+| timestamp | `number` | Timestamp |
+| isCompleted | `boolean` | Whether the speech segment is completed. `false` indicates intermediate result (real-time update), `true` indicates final result |
+| robotId | `string` | Transcriber robot ID |
+
+**Example:**
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  const { speakerUserId, sourceText, translationTexts, isCompleted } = event;
+  
+  // Display real-time transcription result
+  console.log(`[${isCompleted ? 'Completed' : 'In Progress'}] ${speakerUserId}: ${sourceText}`);
+  
+  // Display translation results
+  if (translationTexts) {
+    translationTexts.forEach(({ language, text }) => {
+      console.log(`  ${language}: ${text}`);
+    });
+  }
+});
+
+// Remove listener
+trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
+```
+
+## Supported Languages
+
+### ASR Source Languages
+
+| Language | Code |
+|----------|------|
+| Chinese | `zh` |
+| English | `en` |
+
+<!--
+| Traditional Chinese | `zh-tw` |
+| Chinese Dialects | `zh-dialect` |
+| Cantonese | `zh-yue` |
+| Vietnamese | `vi` |
+| Japanese | `ja` |
+| Korean | `ko` |
+| Indonesian | `id` |
+| Thai | `th` |
+| Portuguese | `pt` |
+| Turkish | `tr` |
+| Arabic | `ar` |
+| Spanish | `es` |
+| Hindi | `hi` |
+| French | `fr` |
+| Malay | `ms` |
+| Filipino | `fil` |
+| German | `de` |
+| Italian | `it` |
+| Russian | `ru` |
+| Swedish | `sv` |
+| Danish | `da` |
+| Norwegian | `no` |
+-->
+
+### Translation Target Languages
+
+| Language | Code |
+|----------|------|
+| Chinese | `zh` |
+| English | `en` |
+| Vietnamese | `vi` |
+| Japanese | `ja` |
+| Korean | `ko` |
+| Indonesian | `id` |
+| Thai | `th` |
+| Portuguese | `pt` |
+| Arabic | `ar` |
+| Spanish | `es` |
+| French | `fr` |
+| Malay | `ms` |
+| German | `de` |
+| Italian | `it` |
+| Russian | `ru` |
+
+## FAQ
+
+**1. How to distinguish between intermediate and final results?**
+
+Use the `isCompleted` field in the `REALTIME_TRANSCRIBER_MESSAGE` event. When `isCompleted` is `false`, it indicates an intermediate result (real-time update); when `isCompleted` is `true`, it indicates the speech segment is completed with the final result.
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  if (event.isCompleted) {
+    // Final result, can be stored or displayed
+    saveSubtitle(event);
+  } else {
+    // Intermediate result, can update UI in real-time
+    updateLiveCaption(event);
+  }
+});
+```
+
+**2. How to merge subtitles by segmentId?**
+
+Each continuous speech segment has the same `segmentId`, which can be used to update and merge subtitles:
+
+```javascript
+const subtitleMap = new Map();
+
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  subtitleMap.set(event.segmentId, event);
+  
+  if (event.isCompleted) {
+    // Speech segment completed, can be archived
+    archiveSubtitle(subtitleMap.get(event.segmentId));
+  }
+});
+```
+
+**3. How to save bandwidth?**
+
+When you don't need to receive transcription messages, remove all listeners for the `REALTIME_TRANSCRIBER_MESSAGE` event, and the plugin will automatically pause receiving messages to save bandwidth. When listeners are added again, message receiving will automatically resume.
+

package/resource/doc/rtcengine/web/plugin/43-advanced-face-detection.md

@@ -0,0 +1,180 @@
+## Function Description
+
+This document details how to use the TRTC Web SDK's Face Detection plugin to monitor real-time face presence changes in camera video streams. The plugin employs intelligent debounce logic, triggering callbacks only when face appearance/disappearance states genuinely change, preventing false positives caused by lighting variations or brief obstructions.
+
+## Prerequisites
+
+- TRTC Web SDK version >= 5.15.0
+- Camera video stream must be enabled first.
+
+### Platform Compatibility
+
+| Platform | Operating System | Browser Version | Notes |
+| :--- | :--- | :--- | :--- |
+| Web | Windows | Chrome 90+, Firefox 90+, Edge 97+ | Recommended: Latest Chrome browser (with hardware acceleration enabled) |
+| Web | Mac | Chrome 98+, Firefox 96+, Safari 15+ | 2019 or newer MacBook recommended |
+| Web | Android | Chrome、Firefox| Use of Chrome or Firefox is recommended |
+| Web | iOS | Chrome、Safari、Firefox | Use of Chrome or Safari is recommended |
+
+## Implementation Steps
+
+### Deploying Static Resources
+
+The plugin relies on static resource files. To ensure the browser can load and run these files correctly, you need to complete the following steps:
+
+1.  Publish the `node_modules/trtc-sdk-v5/assets` directory to your CDN or static resource server.
+2.  Pass your CDN address to the `assetsPath` parameter when creating the TRTC instance, e.g., `TRTC.create({ assetsPath: 'https://xxxx/assets' })`. The SDK will load the necessary resource files on demand.
+
+> - If your SDK version is lower than `v5.10.0`, you need to download and extract https://web.sdk.qcloud.com/trtc/webrtc/v5/assets/assets.zip, then publish it to your CDN or static resource server.
+> - If the Host URL of the files differs from your web application's Host URL, you need to enable CORS policy for the file domain.
+> - Do not host the directory files under an HTTP service, as loading HTTP resources under an HTTPS domain will be blocked by the browser's security policy.
+
+### Registering the Plugin
+
+```javascript
+import { FaceDetection } from 'trtc-sdk-v5/plugins/video-effect/face-detection';
+
+const trtc = TRTC.create({ 
+  plugins: [FaceDetection], 
+  assetsPath: 'https://xxxx/assets'  // Replace with your static resource address
+});
+```
+
+### Starting the Local Camera
+
+```javascript
+await trtc.startLocalVideo();
+```
+
+### Enabling the Face Detection Plugin
+
+```javascript
+await trtc.startPlugin('FaceDetection', {
+  onFaceDetectionStateChanged: (hasFace) => {
+    if (hasFace) {
+      console.log('Face detected');
+      // Execute business logic for face appearance
+    } else {
+      console.log('Face disappeared');
+      // Execute business logic for face disappearance
+    }
+  },
+  detectionInterval: 300,    // Detection interval in ms (Optional, default: 300)
+  minConfidence: 0.8,        // Minimum confidence threshold (Optional, default: 0.8)
+  missingTimeout: 1000       // Disappearance confirmation time in ms (Optional, default: 1000)
+});
+```
+
+### Updating Parameters as Needed
+
+```javascript
+// Update detection parameters - increase sensitivity
+await trtc.updatePlugin('FaceDetection', {
+  onFaceDetectionStateChanged: (hasFace) => {
+    console.log('Updated detection state:', hasFace);
+  },
+  detectionInterval: 200,    // Shorter interval for higher real-time performance
+  minConfidence: 0.7,        // Lower threshold for higher sensitivity
+  missingTimeout: 1500       // Longer timeout to reduce false negatives
+});
+```
+
+### Disabling Face Detection
+
+```javascript
+await trtc.stopPlugin('FaceDetection');
+```
+
+## Core Features
+
+### Intelligent Debounce Logic
+
+The plugin uses an **asymmetric debounce mechanism** to ensure state change accuracy:
+
+- **Face appears (true)**: Triggered immediately for real-time response.
+- **Face disappears (false)**: Triggered after a delay, requiring the `missingTimeout` condition to be met for confirmation.
+
+This design effectively prevents false positives caused by:
+- Brief head turns or looking down
+- Sudden lighting changes
+- Temporary obstructions
+
+### Video Stream State Synchronization
+
+The plugin automatically handles local video stream state changes:
+
+| Scenario | Plugin Behavior | Callback Trigger |
+| :--- | :--- | :--- |
+| Video muted (Mute) | Pauses detection | Triggers once with `hasFace: false` |
+| Video resumed (Unmute) | Resumes detection | Triggers callback based on actual state |
+
+## API Documentation
+
+### trtc.startPlugin('FaceDetection', options)
+
+Used to start the Face Detection plugin.
+
+#### options
+
+| Name | Type | Attributes | Description |
+| :--- | :--- | :--- | :--- |
+| `onFaceDetectionStateChanged` | `(hasFace: boolean) => void` | **Required** | Callback function for face state changes (triggered only on genuine state change) |
+| `detectionInterval` | number | Optional | Detection interval time (ms), range: 100-5000, default: 300 |
+| `minConfidence` | number | Optional | Minimum face confidence threshold, range: 0-1, default: 0.8 |
+| `missingTimeout` | number | Optional | Face disappearance confirmation time (ms), range: 0-5000, default: 1000 |
+
+**Example:**
+
+```javascript
+await trtc.startPlugin('FaceDetection', {
+  onFaceDetectionStateChanged: (hasFace) => {
+    if (hasFace) {
+      console.log('Face appeared');
+    } else {
+      console.log('Face disappeared');
+    }
+  },
+  detectionInterval: 300,
+  minConfidence: 0.8,
+  missingTimeout: 1000
+});
+```
+
+### trtc.updatePlugin('FaceDetection', options)
+
+Used to modify face detection parameters.
+
+#### options
+
+| Name | Type | Attributes | Description |
+| :--- | :--- | :--- | :--- |
+| `onFaceDetectionStateChanged` | `(hasFace: boolean) => void` | Optional | Callback function for face state changes |
+| `detectionInterval` | number | Optional | Detection interval time (ms), range: 100-5000 |
+| `minConfidence` | number | Optional | Minimum face confidence threshold, range: 0-1 |
+| `missingTimeout` | number | Optional | Face disappearance confirmation time (ms), range: 0-5000 |
+
+**Example:**
+
+```javascript
+await trtc.updatePlugin('FaceDetection', {
+  detectionInterval: 200,
+  minConfidence: 0.7,
+  missingTimeout: 1500
+});
+```
+
+### trtc.stopPlugin('FaceDetection')
+
+Stops the Face Detection plugin.
+
+## FAQs
+
+**1. How to adjust detection sensitivity?**
+
+Adjust sensitivity by combining these parameters:
+- **Increase sensitivity**: Lower `minConfidence`, shorten `detectionInterval`
+- **Decrease sensitivity**: Raise `minConfidence`, lengthen `missingTimeout`
+
+**2. Do I need to restart detection after the video stream recovers?**
+
+No. The plugin automatically handles video stream state changes and resumes detection upon recovery.

package/tools/chat/get-native-chat-feature-detail.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { GET_NATIVE_CHAT_FEATURE_DETAIL_DEFINITION } from '../definitions/get_native_chat_feature_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';
+function getResultText(params) {
+    const { framework, featureName = '' } = params;
+    reportCLSClient({
+        method: 'get_native_chat_feature_detail',
+        info: featureName,
+        framework: framework,
+    });
+    return getDocContent(['chatuikit', `${handleFramework(framework)}`, 'features', `${featureName}.md`]);
+}
+const registryGetNativeChatFeatureDetailTool = (mcpServer) => {
+    const { name, description, parameter_descriptions } = GET_NATIVE_CHAT_FEATURE_DETAIL_DEFINITION;
+    mcpServer.tool(name, description, {
+        framework: z.enum(['andriod', 'ios', 'flutter']).describe(parameter_descriptions.framework),
+        featureName: z.string().describe(parameter_descriptions.featureName),
+    }, (params) => ({
+        content: [
+            {
+                type: 'text',
+                text: getResultText(params),
+            }
+        ]
+    }));
+};
+export { registryGetNativeChatFeatureDetailTool };
+//# sourceMappingURL=get-native-chat-feature-detail.js.map

package/tools/chat/get-native-chat-feature-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-native-chat-feature-detail.js","sourceRoot":"","sources":["../../../src/tools/chat/get-native-chat-feature-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yCAAyC,EAAE,MAAM,sDAAsD,CAAC;AACjH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAC/C,eAAe,CAAC;QACd,MAAM,EAAE,gCAAgC;QACxC,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,sCAAsC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACtE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,yCAAyC,CAAC;IAChG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QAC3F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,WAAW,CAAC;KACrE,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,sCAAsC,EAAE,CAAC"}

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

@@ -2,26 +2,44 @@ import { z } from 'zod';
 import { GET_NATIVE_CHAT_UIKIT_INTEGRATION_DEFINITION } from '../definitions/get_native_chat_uikit_integration_def.js';
 import { getDocContent } from '../../utils/get-doc-content.js';
 import { reportCLSClient } from '../../utils/report-cls-client.js';
-function getResultText(params) {
-    const { framework = '' } = params;
+import { generateStructuredResult } from '../../utils/generate-structured-result.js';
+async function getResultText(params) {
+    const { framework = '', goals = [] } = params;
     reportCLSClient({
         method: 'get_native_chat_uikit_integration',
-        framework: framework,
+        info: goals.join(','),
+        framework,
     });
-    return getDocContent(['chatuikit', `${framework}`]);
+    // 获取工作流指令
+    const baseInstructions = getDocContent(['chatuikit', framework, 'workflow.md']);
+    // 批量读取目标文档并生成结构化结果
+    const result = await generateStructuredResult({
+        baseInstructions,
+        goals,
+        framework,
+        pathMap: {
+            [goals[0]]: ['chatuikit', framework, 'integration.md'],
+        },
+    });
+    return result;
 }
 const registryGetNativeChatIntegrationTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = GET_NATIVE_CHAT_UIKIT_INTEGRATION_DEFINITION;
     mcpServer.tool(name, description, {
         framework: z.enum(['flutter', 'android', 'ios']).describe(parameter_descriptions.framework),
-    }, (params) => ({
-        content: [
-            {
-                type: 'text',
-                text: getResultText(params),
-            }
-        ]
-    }));
+        goals: z.array(z.enum(['full-featured', 'chat-only'])).describe(parameter_descriptions.goals)
+    }, async (params) => {
+        const result = await getResultText(params);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.llm_code_generation_instructions_md,
+                }
+            ],
+            result: result,
+        };
+    });
 };
 export { registryGetNativeChatIntegrationTool };
 //# sourceMappingURL=get-native-chat-integration.js.map

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

@@ -1 +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,4CAA4C,EAAE,MAAM,yDAAyD,CAAC;AACvH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAClC,eAAe,CAAC;QACd,MAAM,EAAE,mCAAmC;QAC3C,SAAS,EAAE,SAAS;KACrB,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,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,4CAA4C,CAAC;IACnG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,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"}
+{"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,4CAA4C,EAAE,MAAM,yDAAyD,CAAC;AACvH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF,KAAK,UAAU,aAAa,CAAC,MAA2B;IACtD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAC9C,eAAe,CAAC;QACd,MAAM,EAAE,mCAAmC;QAC3C,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACrB,SAAS;KACV,CAAC,CAAC;IACH,UAAU;IACV,MAAM,gBAAgB,GAAG,aAAa,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAChF,mBAAmB;IACnB,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC;QAC5C,gBAAgB;QAChB,KAAK;QACL,SAAS;QACT,OAAO,EAAE;YACP,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC;SACvD;KACF,CAAC,CAAA;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,oCAAoC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACpE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,4CAA4C,CAAC;IACnG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QAC3F,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC;KAC9F,EACD,KAAK,EAAE,MAAW,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;QAC1C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,CAAC,mCAAmC;iBACjD;aACF;YACD,MAAM,EAAE,MAAM;SACf,CAAA;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,oCAAoC,EAAE,CAAC"}

package/tools/common/get-faq.js

@@ -11,8 +11,6 @@ const PRODUCT_DOC_MAP = {
 };
 const WEB_FRAMEWORKS = ['react', 'vue', 'web'];
 const NATIVE_FRAMEWORKS = ['android', 'ios', 'flutter'];
-const WEB_SDK_DIR = 'web_sdk';
-const NATIVE_SDK_DIR = 'native_sdk';
 function getResultText(params) {
     const { query = '', product = '', framework = '' } = params;
     const basePath = PRODUCT_DOC_MAP[product];
@@ -32,10 +30,10 @@ function getResultText(params) {
     // Step 2: SDK FAQ Search (SDK Path)
     let sdkDir = '';
     if (WEB_FRAMEWORKS.includes(framework)) {
-        sdkDir = WEB_SDK_DIR;
+        sdkDir = 'web_sdk';
     }
     else if (NATIVE_FRAMEWORKS.includes(framework)) {
-        sdkDir = NATIVE_SDK_DIR;
+        sdkDir = `${framework}_sdk`;
     }
     const sdkSearchContent = getDocContent([basePath, 'faq', sdkDir]);
     // Step 3: General Knowledge Search (Server Error Codes, Billing, Console, REST API, etc.) (Common Path)

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

@@ -1 +1 @@
-{"version":3,"file":"get-faq.js","sourceRoot":"","sources":["../../../src/tools/common/get-faq.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-faq.js","sourceRoot":"","sources":["../../../src/tools/common/get-faq.ts"],"names":[],"mappings":"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"}

package/tools/definitions/get_native_chat_feature_detail_def.js

@@ -0,0 +1,32 @@
+const TOOL_DESCRIPTION = `
+【Core Purpose】: This is a Native Chat Application UIKit Feature Detail Tool, specifically designed to provide detailed descriptions, usage instructions, and sample code for various features in Native Chat TUIKit.
+
+【Functional Scope】:
+Retrieves detailed documentation for any feature, including feature implementation methods, API calls, code examples, etc.
+
+【Core Feature Modules】: This tool covers all core features of Native Chat TUIKit, including:
+
+**📋 Core Feature List:**
+1. **Theme Customization** (theme): Theme styling customization feature, supporting custom colors, fonts, border radius, spacing and other visual styles, suitable for implementing branded UI, dark mode, personalized appearance and other scenarios
+
+【Keywords】: 'feature details', 'TUIKit', 'Native', 'Android', 'iOS', 'Flutter', 'theme', 'theme', 'TUITheme', 'theme customization', 'style customization', 'dark mode', 'dark mode', 'branding', 'colors', 'fonts', 'UI customization'.
+
+【Supported Platforms】: Android, iOS and Flutter.
+
+【Mandatory Constraints】:
+1. Platform Selection Constraint: If the user does **not explicitly specify** Android, iOS or Flutter platform in the prompt, must prioritize calling the 'present_framework_choice' tool to guide the user to make a selection.
+
+2. **Feature Name Must Match Exactly**: featureName parameter must be selected from the following list, fuzzy matching is not supported:
+   - 'theme': Theme customization (colors, fonts, border radius, spacing and other visual style customization)
+`;
+const PARAMETER_DESCRIPTIONS = {
+    framework: 'Platform/framework type supported by Native Chat UIKit feature details. Available values: android, ios, flutter.',
+    featureName: `Specific name of Native Chat UIKit feature, available values:
+- 'theme': Theme customization (colors, fonts, border radius, spacing and other visual style customization)`
+};
+export const GET_NATIVE_CHAT_FEATURE_DETAIL_DEFINITION = {
+    name: 'get_native_chat_feature_detail',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_chat_feature_detail_def.js.map

package/tools/definitions/get_native_chat_feature_detail_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_chat_feature_detail_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_chat_feature_detail_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,kHAAkH;IAC7H,WAAW,EAAE;4GAC6F;CAC3G,CAAC;AAGF,MAAM,CAAC,MAAM,yCAAyC,GAAG;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}