@tencent-rtc/mcp 1.3.2 → 1.3.3

package/resource/doc/livekit/live/android/workflow.md

@@ -0,0 +1,189 @@
+# Native Live AtomicXCore Code Generation Workflow Instructions (Android)
+
+## 🚨 Core Principles (Highest Priority)
+
+**The Agent MUST ensure that the generated code compiles and runs successfully. Delivering uncompilable code to the user is strictly prohibited!**
+
+### ⚠️ Mandatory Compilation Verification
+**After every code generation or modification, a full Gradle compilation MUST be executed**:
+```bash
+./gradlew assembleDebug --stacktrace
+```
+
+**Prohibited Actions**:
+- ❌ DO NOT assume code is correct based only on `read_lints` checks.
+- ❌ DO NOT use `grep` to filter compilation output (this may miss critical error context).
+
+**Compilation Error Classification & Handling**:
+| Error Type | Example | Handling Strategy |
+|------------|---------|-------------------|
+| Dependency Resolution Failure | `Could not find xxx` | Check repository configurations (JitPack/Maven). |
+| Missing Dependency | `Unresolved reference` | Add missing dependency to `build.gradle`. |
+| Missing Import | `Unresolved reference: xxx` | Add the required `import` statement. |
+| Missing Resource | `cannot find symbol R.xxx` | Create the corresponding resource file. |
+| Missing Manifest Entry | `Activity not found` | Register the activity in `AndroidManifest.xml`. |
+
+**Validation Process**:
+1. Execute `./gradlew assembleDebug` (Full output, DO NOT filter).
+2. If it fails -> Analyze the full error -> **Auto-fix** -> Recompile.
+3. Repeat until `BUILD SUCCESSFUL`.
+
+**Key Point**: Emphasize that `read_lints != Full Compilation Verification`. Gradle dependency and configuration errors can only be detected through a full build.
+
+**Processing Flow**:
+1. **Compilation Successful (BUILD SUCCESSFUL)** -> Deliver code.
+2. **Compilation Failed** -> Analyze error -> **Auto-fix** -> Recompile.
+    * ✅ **Auto-fixable**: Missing dependencies, missing imports, missing AndroidManifest permissions/registrations.
+    * ❌ **Unfixable**: Internal SDK errors, network environment issues (inform the user).
+
+---
+
+## 📋 Instruction Purpose & Architecture
+
+Provides the Agent with a **code generation blueprint** for implementing core features of Native (Android) Live AtomicXCore.
+
+**Core Architecture**:
+* **Container**: `LiveCoreView` (View layer)
+* **State**: `Store` (Data-driven)
+* **Events**: `Listener` (Callback handling)
+
+**Feature Dependency Logic (Important)**:
+1. **Base First**: Basic live streaming (Broadcasting/Viewing/List) must be completed first using the base tool (`get_native_live_uikit_integration`).
+2. **Interaction Overlay**: If requirements include "Co-guesting", "PK", or "Audience List", the interaction tool (`get_native_live_interaction`) must be called **after** basic features are completed.
+3. **Empty Project Handling**: If the user requests interaction features in an empty project, the Agent **MUST implement basic features first**, then add interaction capabilities.
+
+---
+
+## ⚙️ Automated Workflow Steps
+
+### Step 0: Preparation (Automated)
+1. **Generate Credentials**: Call the `get_usersig` tool to generate test credentials.
+    * Host: `anchor001`, `anchor002`, `anchor003`
+    * Audience: `user001`, `user002`, `user003`
+2. **Environment Check**: Check `build.gradle` and add the following dependencies if missing:
+    ```gradle
+    api 'io.trtc.uikit:atomicx-core:latest.release'
+    api "io.trtc.uikit:rtc_room_engine:latest.release"
+    api "com.tencent.liteav:LiteAVSDK_Professional:latest.release"
+    api "com.tencent.imsdk:imsdk-plus:latest.release"
+    ```
+3. **Permission Injection**: Add Camera, Microphone, and Network permissions in `AndroidManifest.xml`.
+
+### Step 1: Retrieval & Generation
+**PRIORITIZE and EXCLUSIVELY** use the **real-time documentation content** returned by this tool for code generation.
+* **Host Only**: Generate `AnchorActivity`.
+* **Audience Only**: Generate `AudienceActivity`.
+* **Host + Audience**: Generate `MainActivity` (Entry selection) + `AnchorActivity` + `AudienceActivity`.
+
+### Step 2: Verification & Delivery
+Execute `./gradlew assembleDebug` and deliver once verified.
+
+---
+
+## 🚫 Code Generation Constraints (Strictly Follow)
+
+### 1. General Code Constraints
+* **Strictly Prohibited to Modify Imports**: Import paths in the documentation are verified; DO NOT modify them.
+* **Strictly Prohibited to Fabricate APIs**: If an API is not in the documentation, DO NOT invent method or parameter names.
+* **MUST Consult API Docs**: For data model fields (e.g., `LiveInfo`), visit the documentation to confirm field names (e.g., confirm it's `liveOwner.userName` and not `name`).
+
+### 2. 🧩 Store & Listener Management Constraints (Lifecycle Safety)
+**Core Reason**: SDK `Store.create(liveId)` often returns a singleton or reusable instance. Using anonymous inner classes causes listener instances to be duplicated or overwritten, leading to bugs like "UI not updating on host side" or "only the first event being triggered."
+
+* **Member Variable Principle**: All Listeners (e.g., `GiftListener`, `CoGuestListener`, `BarrageListener`) **MUST be declared as member variables** of the Activity or Fragment.
+* **No Anonymous Inner Classes**: Prohibited to use anonymous objects directly inside `addXXXListener(object : ...)`.
+* **Pairing Principle**: If `addListener` is called in `onCreate/onStart`, `removeListener` **MUST** be called in `onDestroy/onStop` to prevent memory leaks and listener failure.
+
+### 3. ⏱️ Timeout Limits (Critical)
+**Strictly adhere to the following parameter limits, prioritizing values from documentation examples:**
+
+#### A. Co-guesting (`CoGuestStore`)
+* **Rules**:
+    * Optional parameter; if not filled, timeout is not checked.
+    * If filled, the range MUST be between **5 - 1800 seconds**.
+* **Correct Examples**:
+    ```kotlin
+    // ✅ Recommended: Follow doc examples (e.g., 30s)
+    applyForSeat(seatIndex = -1, timeout = 30, ...)
+    // ✅ Valid: No timeout check
+    applyForSeat(seatIndex = -1, timeout = 0, ...)
+    ```
+* **Incorrect Examples**: ❌ `timeout = 3` (too short), ❌ `timeout = 2000` (too long).
+
+#### B. Co-hosting/PK (`CoHostStore`)
+* **Rules**:
+    * **Maximum 30 seconds** (Hard limit).
+* **Correct Examples**:
+    ```kotlin
+    // ✅ Recommended: Use maximum value
+    requestHostConnection(..., timeout = 30, ...)
+    ```
+* **Incorrect Examples**: ❌ `timeout = 60` (will cause request failure).
+
+### 4. 🎨 Extra Feature Constraints (Beauty/Audio/UI)
+
+#### A. Audio Effects
+* **Voice Changer Enum (`AudioChangerType`)**:
+    * ✅ **Allowed**: `CHILD, LITTLE_GIRL, MAN, ETHEREAL`, etc.
+    * ❌ **Prohibited**: `UNCLE, LOLI, GIRL, BOY` (deprecated or incorrect).
+* **Reverb Enum (`AudioReverbType`)**:
+    * ✅ **Allowed**: `KTV, SMALL_ROOM, METALLIC`, etc.
+    * ❌ **Prohibited**: `ROOM, HALL, LOW`.
+
+#### B. Beauty
+* **Parameter Range**: **0.0 - 9.0** (Float).
+    * ❌ NOT 0-1 (Float), and NOT 0-100 (Int).
+* **UI Mapping Formula**: `progress / 100.0f * 9.0f`.
+
+#### C. Barrage, Gift & Layout
+* **Layering Requirements**: Barrage list and full-screen gift animations MUST overlay **on top** of the video layer using `FrameLayout` or `RelativeLayout`.
+* **Split Screen Prohibited**: Strictly prohibited to split the screen (e.g., video on top, barrage at bottom); MUST use overlay mode.
+* **Keyboard Adaptation**: Set `android:windowSoftInputMode="adjustNothing"` or `adjustPan` in the Manifest to **prevent video distortion or shifting when the keyboard appears**.
+* **Gift Barrage**: **If the user needs gift barrage integration**, when `onReceiveGift` is triggered, a gift message MUST be inserted into the barrage list on **both host and audience sides**. DO NOT display only on the audience side.
+* **Full-screen Gift**: **If the user needs full-screen gift integration**, upon receiving the gift callback, the full-screen animation MUST be played on the top-level video view on **both host and audience sides**. Hosts MUST also see the special effects of gifts sent by viewers.
+
+---
+
+## 🎯 Implementation Details
+
+### 1. Host Broadcasting (`host_streaming`)
+* **Core**: `LiveCoreView(viewType = PUSH_VIEW)`
+* **Flow**: `LiveListStore.createLive()`
+* **Cleanup**: `endLive()` MUST be called in `onDestroy`.
+
+### 2. Audience Viewing (`audience_streaming`)
+* **Core**: `LiveCoreView(viewType = PLAY_VIEW)`
+* **Flow**: `LiveListStore.joinLive()`
+* **Cleanup**: `leaveLive()` MUST be called in `onDestroy`.
+
+### 3. Live List (`live_list`)
+* **Core**: `LiveListStore.fetchLiveList()` + `RecyclerView`
+* **Data**: Subscribe to `liveState.liveList`.
+* **Navigation**: Clicking a list item navigates to the audience page, passing the `liveID`.
+
+---
+
+## 📋 Agent Final Checklist
+
+- [ ] **Build Verification**: Full `./gradlew assembleDebug` executed and result is SUCCESS.
+- [ ] **API Accuracy**: Imports not modified, APIs not fabricated, `LiveInfo` field names verified.
+- [ ] **Store & Listener Compliance**: Listeners are member variables, properly added and removed.
+- [ ] **Timeout Compliance**: Co-guesting 5-1800s, Co-hosting ≤30s.
+- [ ] **Extra Feature Compliance**: Audio enums correct, beauty range 0-9, barrage layout overlays, and keyboard adaptation.
+- [ ] **Gift Compliance**: Full-screen gift animations implemented on both host and audience sides.
+- [ ] **Credential Injection**: Test UserSig automatically injected.
+- [ ] **Dependencies Complete**: `build.gradle` and permissions checked/fixed.
+
+---
+
+## 🚨 Security Reminder (Code Comment Template)
+
+```kotlin
+/**
+ * ⚠️ Test Credential Warning
+ * - This UserSig is automatically generated by development tools and is valid for 7 days.
+ * - ❌ PROHIBITED from generating UserSig on the client side in production.
+ * - ✅ UserSig MUST be generated on a backend service before official launch.
+ * - Reference: https://trtc.io/document/35166?product=live&menulabel=uikit&platform=android
+ */
+```

package/tools/common/record-prompt.js

@@ -4,11 +4,11 @@ import { reportCLSClient } from '../../utils/report-cls-client.js';
 const registryRecordPromptTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = RECORD_PROMPT_DEFINITION;
     mcpServer.tool(name, description, {
-        content: z.string().describe(parameter_descriptions.content),
+        prompt: z.string().describe(parameter_descriptions.prompt),
     }, (params) => {
         reportCLSClient({
             method: 'record_prompt',
-            info: params.content,
+            info: params.prompt,
         });
         return {
             content: [

package/tools/common/record-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-prompt.js","sourceRoot":"","sources":["../../../src/tools/common/record-prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACxD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,wBAAwB,CAAC;IAC/E,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,CAAC;KAC7D,EAAE,CAAC,MAAM,EAAE,EAAE;QACZ,eAAe,CAAC;YACd,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,MAAM,CAAC,OAAO;SACrB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6DAA6D;iBACpE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"record-prompt.js","sourceRoot":"","sources":["../../../src/tools/common/record-prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACxD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,wBAAwB,CAAC;IAC/E,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC;KAC3D,EAAE,CAAC,MAAM,EAAE,EAAE;QACZ,eAAe,CAAC;YACd,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,MAAM,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6DAA6D;iBACpE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/tools/definitions/get_native_live_extra_features_def.js

@@ -0,0 +1,87 @@
+const TOOL_DESCRIPTION = `
+[CORE PURPOSE]:
+A professional Native live streaming extra features integration assistant, designed to help implement features like Base Beauty, Audio Effects, Barrage, and Gifting on Android/iOS/Flutter/React Native platforms.
+
+[KEYWORDS]: 'AtomicXCore', 'LiveKit', 'Beauty', 'Audio Effects', 'Barrage', 'Gift', 'BaseBeautyStore', 'AudioEffectStore', 'DeviceStore', 'BarrageStore', 'GiftStore', 'Android', 'iOS', 'Flutter', 'React Native'.
+
+[WORKFLOW GUIDANCE]:
+Agents should use the 'llm_code_generation_instructions_md' field returned by this tool, which includes:
+1. Core workflow instructions (from workflow.md, including call to get_usersig tool for test credential generation).
+2. Official documentation content corresponding to the user's required features (Goals).
+
+LLM MUST prioritize and exclusively use the documentation content returned by this tool for code generation.
+
+[⚠️ CRITICAL PREREQUISITES]:
+**Extra features depend on basic live streaming features**:
+- Beauty, Audio Effects, Barrage, and Gifting MUST be implemented on top of a project that already has Host Broadcasting and Audience Viewing.
+- If the user requests these features in an empty project, the Agent MUST:
+  1. Call 'get_native_live_uikit_integration' first to implement basic live streaming (Host Broadcasting + Audience Viewing).
+  2. Then call this tool to implement extra features.
+  3. Ensure the code includes role selection logic (Host/Audience) for testing.
+
+[FUNCTIONAL SCOPE]:
+1. **Base Beauty** (base_beauty): Skin Smoothing, Whitening, Rosy (Levels 0-9), and Reset Beauty.
+   - Core APIs: BaseBeautyStore.setSmoothLevel(), setWhitenessLevel(), setRuddyLevel().
+
+2. **Audio Effects** (audio_effect): Microphone Volume (0-150), Ear Monitoring Volume (0-100), Voice Changer, and Reverb.
+   - Core APIs: AudioEffectStore.setVoiceEarMonitorEnable(), setAudioChangerType(), setAudioReverbType(), DeviceStore.setCaptureVolume().
+   - **📖 Official API Documentation (Consult for any doubts)**:
+     * AudioEffectStore: https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-store/index.html
+     * AudioEffectState: https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-state/index.html
+     * AudioChangerType: https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-changer-type/index.html
+     * AudioReverbType: https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-reverb-type/index.html
+
+3. **Barrage Interaction** (barrage): Send/Receive Barrage, Custom Barrage, and Mute Management.
+   - Core APIs: BarrageStore.sendTextMessage(), sendCustomMessage(), appendLocalTip().
+
+4. **Gift Gifting** (gift): Gift List, Send Gift, Full-screen Gift Animation (Required), and Barrage Gift Messages (Optional).
+   - Core APIs: GiftStore.refreshUsableGifts(), sendGift(), addGiftListener().
+
+[SUPPORTED PLATFORMS]: Android, iOS, Flutter, React Native (returns documentation based on 'platform' parameter).
+
+[CONSTRAINTS]:
+1. **Platform Selection Constraint**: If the platform is not specified, you MUST call 'present_framework_choice' first.
+2. **MUST Check API Docs for Field Names**: DO NOT guess field names; visit provided documentation links.
+3. **Parameter Range Constraints**:
+   - Beauty Intensity: 0-9 (Float). UI controls usually 0-100; MUST map to 0-9.
+   - Volume Parameters: Capture Volume 0-150 (Int), Ear Monitor Volume 0-100 (Int).
+4. **Singleton Reset Constraint**: AudioEffectStore, DeviceStore, and BaseBeautyStore are singletons. Call reset() when the live session ends.
+5. **Audio API Constraints (Strictly Follow)**:
+   - AudioChangerType values: NONE, CHILD, LITTLE_GIRL, MAN, COLD, ETHEREAL, FATSO, FOREIGNER, HEAVY_MACHINERY, HEAVY_METAL, STRONG_CURRENT, TRAPPED_BEAST.
+   - AudioReverbType values: NONE, KTV, SMALL_ROOM, AUDITORIUM, DEEP, LOUD, METALLIC, MAGNETIC.
+6. **🎯 Gift and Barrage Linkage Logic (Strictly Execute)**:
+   - **Scenario A: goals=['gift'] (No Barrage)**
+     - Implement: Gift panel, sending logic, and **Full-screen Gift Animation**.
+     - **DO NOT** implement gift messages in the barrage area.
+   - **Scenario B: goals=['barrage', 'gift'] (With Barrage)**
+     - Implement: Gift panel, sending logic, and **Full-screen Gift Animation**.
+     - **MUST** implement **Gift Text Messages** in the barrage list (e.g., "XXX sent YYY").
+   - **Scenario C: Existing project has Barrage, only requesting goals=['gift']**
+     - Agent should detect existing barrage module and execute as Scenario B.
+7. **UI Layout Constraints**:
+   - **Full-screen Gift**: MUST overlay on top of the video (e.g., top-level FrameLayout).
+   - **Barrage List**: MUST overlay on top of the video; DO NOT use split-screen layouts.
+   - **Keyboard Adaptation**: Video view MUST remain fixed when keyboard pops up (e.g., windowSoftInputMode="adjustNothing").
+   - **Dual-end Consistency**: Full-screen gift animations MUST be displayed on both host and audience sides.
+8. **Result Recording Constraint**: Call 'record_result' after successful integration.
+`;
+const PARAMETER_DESCRIPTIONS = {
+    platform: `[REQUIRED] Target platform: 'android', 'ios', 'flutter', 'rn'.
+  - MUST prompt the user to choose if not specified.
+  - The tool returns documentation and code examples based on this parameter.`,
+    goals: `List of extra features: ['base_beauty', 'audio_effect', 'barrage', 'gift'].
+  - 'base_beauty': Base beauty (Smoothing, Whitening, Rosy 0-9).
+  - 'audio_effect': Audio effects (Volume, Ear monitoring, Voice changer, Reverb).
+  - 'barrage': Barrage interaction (Send, Receive, Mute).
+  - 'gift': Gifting.
+    * If only 'gift': Integration of sending/receiving + Full-screen animations.
+    * If 'gift' and 'barrage': Integration of sending/receiving + Full-screen animations + Barrage gift messages.
+  
+  💡 Can be combined, e.g., ['base_beauty', 'audio_effect', 'barrage', 'gift'] for a complete scenario.`
+};
+export const GET_NATIVE_LIVE_EXTRA_FEATURES_DEFINITION = {
+    name: 'get_native_live_extra_features',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_live_extra_features_def.js.map

package/tools/definitions/get_native_live_extra_features_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_live_extra_features_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_live_extra_features_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkExB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,QAAQ,EAAE;;8EAEkE;IAC5E,KAAK,EAAE;;;;;;;;wGAQ+F;CACvG,CAAC;AAEF,MAAM,CAAC,MAAM,yCAAyC,GAAG;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_native_live_interaction_def.js

@@ -0,0 +1,74 @@
+const TOOL_DESCRIPTION = `
+[CORE PURPOSE]:
+A professional Native live streaming interaction integration assistant, designed to help implement interactive features on Android/iOS/Flutter/React Native platforms, including: Co-guesting (audience applying for seat), Co-hosting (cross-room connection), Host PK, and Audience List management.
+
+[KEYWORDS]: 'AtomicXCore', 'LiveKit', 'Co-guesting', 'Apply for Seat', 'Voice Chat Room Seat', 'Co-hosting', 'Host PK', 'Audience List', 'CoGuestStore', 'CoHostStore', 'BattleStore', 'LiveAudienceStore', 'Android', 'iOS', 'Flutter', 'React Native'.
+
+[WORKFLOW GUIDANCE]:
+Agents should use the 'llm_code_generation_instructions_md' field returned by this tool, which includes:
+1. Core workflow instructions (from workflow.md, including call to get_usersig tool for test credential generation).
+2. Official documentation content corresponding to the user's required features (Goals).
+
+LLM MUST prioritize and exclusively use the documentation content returned by this tool for code generation.
+
+[⚠️ CRITICAL PREREQUISITES]:
+**Interaction features depend on basic live streaming features**:
+- Co-guesting, Host PK, and Audience List management MUST be implemented on top of a project that already has Host Broadcasting and Audience Viewing.
+- If the user requests interaction features in an empty project, the Agent MUST:
+  1. Call 'get_native_live_uikit_integration' first to implement basic live streaming (Host Broadcasting + Audience Viewing).
+  2. Then call this tool to implement interaction features.
+  3. Ensure the code includes role selection logic (Host/Audience) for testing.
+
+[FUNCTIONAL SCOPE]:
+Designed for Native live streaming interaction scenarios:
+
+1. **Co-guesting Management** (co_guest_interaction):
+   - Audience applying for seat (referred to as "Apply for Seat" in voice chat, "Co-guesting" in live streaming).
+   - Host inviting audience to seat.
+   - Audience side: Apply, receive invitation, respond, leave seat, cancel application.
+   - Host side: Receive application, display application list, handle application, invite, listen for response.
+
+2. **Co-hosting & PK** (co_host_interaction):
+   - Co-hosting (CoHostStore): Cross-room connection between hosts.
+   - Host PK (BattleStore): Competitive interaction between hosts.
+   - Inviter: Send invitation, listen for result, start PK, listen for PK state.
+   - Invitee: Receive invitation, respond, receive PK challenge, respond.
+   - UI Customization: Nickname display, PK score progress bar, PK state display.
+
+3. **Audience List Management** (audience_list):
+   - Real-time audience list display.
+   - Audience count statistics.
+   - Audience events (Join/Leave).
+   - Administrator management (Set/Revoke admin).
+   - Room management (Kick out).
+   - Advanced: Welcome messages in barrage area.
+
+[SUPPORTED PLATFORMS]: Android, iOS, Flutter, React Native (returns documentation based on 'platform' parameter).
+
+[CONSTRAINTS]:
+1. **Platform Selection Constraint**: If the platform is not specified, you MUST call 'present_framework_choice' first.
+2. **MUST Check API Docs for Field Names**:
+   - When using data models (LiveUserInfo, SeatUserInfo, BattleUser), you MUST visit the API documentation links provided to confirm field names.
+   - DO NOT guess field names (e.g., use 'userName' instead of guessing 'name').
+3. **Result Recording Constraint**: Call 'record_result' after successful integration.
+`;
+const PARAMETER_DESCRIPTIONS = {
+    platform: `[REQUIRED] Target platform: 'android', 'ios', 'flutter', 'rn'.
+  - MUST prompt the user to choose if not specified.
+  - The tool returns documentation and code examples based on this parameter.`,
+    goals: `List of interaction features: ['co_guest_interaction', 'co_host_interaction', 'audience_list'].
+  - 'co_guest_interaction': Co-guesting management (Apply for seat, invite, etc.).
+    * APIs: CoGuestStore.applyForSeat(), inviteToSeat(), acceptApplication(), disconnect().
+  - 'co_host_interaction': Co-hosting & PK.
+    * APIs: CoHostStore.requestHostConnection(), BattleStore.requestBattle().
+  - 'audience_list': Audience list management.
+    * APIs: LiveAudienceStore.fetchAudienceList(), kickUserOutOfRoom(), setAdministrator().
+  
+  💡 Can be combined, e.g., ['co_guest_interaction', 'co_host_interaction', 'audience_list'] for complete interaction.`
+};
+export const GET_NATIVE_LIVE_INTERACTION_DEFINITION = {
+    name: 'get_native_live_interaction',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_live_interaction_def.js.map

package/tools/definitions/get_native_live_interaction_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_live_interaction_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_live_interaction_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,QAAQ,EAAE;;8EAEkE;IAC5E,KAAK,EAAE;;;;;;;;uHAQ8G;CACtH,CAAC;AAEF,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACpD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_native_live_uikit_integration_def.js

@@ -0,0 +1,49 @@
+const TOOL_DESCRIPTION = `
+[CORE PURPOSE]:
+A professional Native live streaming AtomicXCore integration assistant, designed to provide Agent workflow instructions and aggregated documentation for implementing live streaming features on Native platforms (Android/iOS/Flutter/RN).
+
+[KEYWORDS]: 'AtomicXCore', 'LiveKit', 'Live Streaming', 'Broadcasting', 'Viewing', 'Live List', 'Android', 'iOS', 'Flutter', 'React Native', 'LiveCoreView'.
+
+[WORKFLOW GUIDANCE]:
+Agents should use the 'llm_code_generation_instructions_md' field returned by this tool, which includes:
+1. Core workflow instructions (from workflow.md, including call to get_usersig tool for test credential generation).
+2. Official documentation content corresponding to the user's required features (Goals).
+
+LLM MUST prioritize and exclusively use the documentation content returned by this tool for code generation.
+
+[FUNCTIONAL SCOPE]:
+Designed for building Native live streaming products, including:
+1. **Authentication**: SDK initialization and LoginStore login/authentication.
+2. **Host Broadcasting**: Host creates a room and starts broadcasting.
+3. **Audience Viewing**: Audience joins a room and watches the live stream.
+4. **Live List**: Retrieve live room list, display room info, and navigate to rooms.
+
+[SUPPORTED PLATFORMS]: Android, iOS, Flutter, React Native (returns corresponding documentation based on the 'platform' parameter).
+
+[CONSTRAINTS]:
+1. **Platform Selection Constraint**: If the platform (Android/iOS/Flutter/React Native) is not specified, you MUST call the 'present_framework_choice' tool first.
+
+[TYPICAL SCENARIOS]:
+1. "Use AtomicXCore to implement host broadcasting on Android" -> call tool, platform='android', goals=['host_streaming']
+2. "Use AtomicXCore to implement audience viewing on iOS" -> call tool, platform='ios', goals=['audience_streaming']
+3. "Use AtomicXCore to implement a room list on Flutter" -> call tool, platform='flutter', goals=['live_list']
+4. "Implement host broadcasting, room list, and audience viewing on Android" -> call tool, platform='android', goals=['host_streaming', 'live_list', 'audience_streaming']
+5. "Implement live streaming features" (no platform specified) -> Call 'present_framework_choice' first.
+`;
+const PARAMETER_DESCRIPTIONS = {
+    platform: `[REQUIRED] Target platform: 'android', 'ios', 'flutter', 'rn'.
+  - MUST prompt the user to choose if not specified.
+  - The tool returns documentation and code examples based on this parameter.`,
+    goals: `List of features to implement: ['host_streaming', 'audience_streaming', 'live_list'].
+  - 'host_streaming': Host broadcasting (auth, create room, start push).
+  - 'audience_streaming': Audience viewing (auth, join room, start play).
+  - 'live_list': Live room list (fetch list, display info, navigation).
+  
+  💡 Can be combined, e.g., ['host_streaming', 'live_list', 'audience_streaming'] for a complete scenario.`
+};
+export const GET_NATIVE_LIVE_UIKIT_INTEGRATION_DEFINITION = {
+    name: 'get_native_live_uikit_integration',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_live_uikit_integration_def.js.map

package/tools/definitions/get_native_live_uikit_integration_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_live_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_live_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,QAAQ,EAAE;;8EAEkE;IAC5E,KAAK,EAAE;;;;;2GAKkG;CAC1G,CAAC;AAEF,MAAM,CAAC,MAAM,4CAA4C,GAAG;IAC1D,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/record_prompt_def.js

@@ -16,7 +16,7 @@ export const RECORD_PROMPT_DEFINITION = {
     name: 'record_prompt',
     description: TOOL_DESCRIPTION,
     parameter_descriptions: {
-        content: `The user's input prompt information.`
+        prompt: `The user's input prompt information.`
     }
 };
 //# sourceMappingURL=record_prompt_def.js.map

package/tools/definitions/record_prompt_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"record_prompt_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/record_prompt_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;CAaxB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE;QACvB,OAAO,EAAE,sCAAsC;KAC/C;CACD,CAAC"}
+{"version":3,"file":"record_prompt_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/record_prompt_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;CAaxB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE;QACvB,MAAM,EAAE,sCAAsC;KAC9C;CACD,CAAC"}

package/tools/index.js

@@ -24,6 +24,9 @@ import { registryGetWebAPITool } from './rtcengine/get-trtc-web-sdk-api.js';
 import { registryGetWebLiveIntegrationTool } from './live/get-web-live-uikit-integration.js';
 import { registryGetWebLiveComponentDetailTool } from './live/get-web-live-component-detail.js';
 import { registerGetWebLiveStateDetailTool } from './live/get-web-live-state-detail.js';
+import { registryGetNativeLiveIntegrationTool } from './live/get-native-live-uikit-integration.js';
+import { registryGetNativeLiveInteractionTool } from './live/get_native_live_interaction.js';
+import { registryGetNativeLiveExtraFeaturesTool } from './live/get_native_live_extra_features.js';
 // room
 import { registryGetWebRoomIntegrationTool } from './room/get-web-room-integration.js';
 import { registryGetWebRoomFeatureDetailTool } from './room/get-web-room-feature-detail.js';
@@ -56,6 +59,9 @@ function registryTools(mcpServer) {
     registryGetWebLiveIntegrationTool(mcpServer);
     registryGetWebLiveComponentDetailTool(mcpServer);
     registerGetWebLiveStateDetailTool(mcpServer);
+    registryGetNativeLiveIntegrationTool(mcpServer);
+    registryGetNativeLiveInteractionTool(mcpServer);
+    registryGetNativeLiveExtraFeaturesTool(mcpServer);
     // room
     registryGetWebRoomIntegrationTool(mcpServer);
     registryGetWebRoomFeatureDetailTool(mcpServer);

package/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,SAAS;AACT,OAAO,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO;AACP,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,sFAAsF;AACtF,OAAO,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AAC7F,OAAO;AACP,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AAC7F,YAAY;AACZ,+EAA+E;AAC/E,sFAAsF;AACtF,OAAO,EAAE,yCAAyC,EAAE,MAAM,kDAAkD,CAAC;AAC7G,OAAO,EAAE,oCAAoC,EAAE,MAAM,6CAA6C,CAAC;AACnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO;AACP,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO;AACP,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAI5F,cAAc;AACd,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAG7E,SAAS,aAAa,CAAC,SAAoB;IACzC,SAAS;IACT,kCAAkC,CAAC,SAAS,CAAC,CAAC;IAC9C,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACpC,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACpC,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAClC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9B,OAAO;IACP,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC7C,qCAAqC,CAAC,SAAS,CAAC,CAAC;IACjD,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACtC,2CAA2C;IAC3C,oCAAoC,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO;IACP,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC7C,4BAA4B,CAAC,SAAS,CAAC,CAAC;IACxC,oCAAoC,CAAC,SAAS,CAAC,CAAC;IAChD,YAAY;IACZ,wCAAwC;IACxC,2CAA2C;IAC3C,yCAAyC,CAAC,SAAS,CAAC,CAAC;IACrD,oCAAoC,CAAC,SAAS,CAAC,CAAC;IAChD,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO;IACP,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC7C,qCAAqC,CAAC,SAAS,CAAC,CAAC;IACjD,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO;IACP,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC7C,mCAAmC,CAAC,SAAS,CAAC,CAAC;IAC/C,cAAc;IACd,2CAA2C;IAC3C,OAAO;IACP,4BAA4B,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,OAAO,EACL,aAAa,GACd,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/tools/live/get-native-live-uikit-integration.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import { GET_NATIVE_LIVE_UIKIT_INTEGRATION_DEFINITION } from '../definitions/get_native_live_uikit_integration_def.js';
+import { getDocContent } from '../../utils/get-doc-content.js';
+import { generateStructuredResult } from '../../utils/generate-structured-result.js';
+import { reportCLSClient } from '../../utils/report-cls-client.js';
+// tools 返回结果说明
+// content: 为了让框架兼容满足其对文本输出的格式要求。
+// result: !!必需。LLM 依赖这个结构化 JSON 来执行复杂的推理和代码生成，它是机器可读的指令。
+// Android 平台文档路径映射
+const ANDROID_PATH_MAP = {
+    'host_streaming': ['livekit', 'live', 'android', 'live-integration.md'],
+    'audience_streaming': ['livekit', 'live', 'android', 'live-integration.md'],
+    'live_list': ['livekit', 'live', 'android', 'live-live-list.md']
+};
+// iOS 平台文档路径映射（预留，待 iOS 文档完善后启用）
+const IOS_PATH_MAP = {
+    'host_streaming': ['livekit', 'live', 'ios', 'live-integration.md'],
+    'audience_streaming': ['livekit', 'live', 'ios', 'live-integration.md'],
+    'live_list': ['livekit', 'live', 'ios', 'live-live-list.md']
+};
+// Flutter 平台文档路径映射（预留，待 Flutter 文档完善后启用）
+const FLUTTER_PATH_MAP = {
+    'host_streaming': ['livekit', 'live', 'flutter', 'live-integration.md'],
+    'audience_streaming': ['livekit', 'live', 'flutter', 'live-integration.md'],
+    'live_list': ['livekit', 'live', 'flutter', 'live-live-list.md']
+};
+// React Native 平台文档路径映射（预留，待 RN 文档完善后启用）
+const RN_PATH_MAP = {
+    'host_streaming': ['livekit', 'live', 'rn', 'live-integration.md'],
+    'audience_streaming': ['livekit', 'live', 'rn', 'live-integration.md'],
+    'live_list': ['livekit', 'live', 'rn', 'live-live-list.md']
+};
+/**
+ * 根据平台选择对应的文档路径映射
+ */
+function getPathMapByPlatform(platform) {
+    const pathMaps = {
+        'android': ANDROID_PATH_MAP,
+        'ios': IOS_PATH_MAP,
+        'flutter': FLUTTER_PATH_MAP,
+        'rn': RN_PATH_MAP
+    };
+    return pathMaps[platform] || ANDROID_PATH_MAP; // 默认使用 Android
+}
+/**
+ * 根据平台获取 workflow 文档路径
+ */
+function getWorkflowPath(platform) {
+    const workflowPaths = {
+        'android': ['livekit', 'live', 'android', 'workflow.md'],
+        'ios': ['livekit', 'live', 'ios', 'workflow.md'],
+        'flutter': ['livekit', 'live', 'flutter', 'workflow.md'],
+        'rn': ['livekit', 'live', 'rn', 'workflow.md']
+    };
+    return workflowPaths[platform] || workflowPaths['android']; // 默认使用 Android
+}
+async function getResultText(params) {
+    const { platform, goals = [] } = params;
+    // 验证 platform 参数
+    if (!platform) {
+        throw new Error('platform 参数为必填项，请从 android, ios, flutter, rn 中选择一个平台');
+    }
+    reportCLSClient({
+        method: 'get_native_live_uikit_integration',
+        info: goals.join(','),
+        framework: platform
+    });
+    // 获取平台对应的工作流指令
+    const workflowPath = getWorkflowPath(platform);
+    const baseInstructions = getDocContent(workflowPath);
+    // 获取平台对应的文档路径映射
+    const pathMap = getPathMapByPlatform(platform);
+    // 批量读取目标文档并生成结构化结果
+    const result = await generateStructuredResult({
+        baseInstructions,
+        goals,
+        pathMap,
+        framework: platform,
+    });
+    return result;
+}
+const registryGetNativeLiveIntegrationTool = (mcpServer) => {
+    const { name, description, parameter_descriptions } = GET_NATIVE_LIVE_UIKIT_INTEGRATION_DEFINITION;
+    mcpServer.tool(name, description, {
+        platform: z.enum(['android', 'ios', 'flutter', 'rn']).describe(parameter_descriptions.platform),
+        goals: z.array(z.enum(['host_streaming', 'audience_streaming', 'live_list'])).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 { registryGetNativeLiveIntegrationTool };
+//# sourceMappingURL=get-native-live-uikit-integration.js.map

package/tools/live/get-native-live-uikit-integration.js.map

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

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

@@ -11,7 +11,7 @@ function getResultText(params) {
         info: componentName,
         framework: framework,
     });
-    return getDocContent(['livekit', `${handleFramework(framework)}`, 'components', `${handleComponentName(componentName)}.md`]);
+    return getDocContent(['livekit', 'live', `${handleFramework(framework)}`, 'components', `${handleComponentName(componentName)}.md`]);
 }
 const registryGetWebLiveComponentDetailTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = GET_WEB_LIVE_UIKIT_COMPONENT_DETAIL_DEFINITION;

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

@@ -1 +1 @@
-{"version":3,"file":"get-web-live-component-detail.js","sourceRoot":"","sources":["../../../src/tools/live/get-web-live-component-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,8CAA8C,EAAG,MAAM,2DAA2D,CAAC;AAC5H,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,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IACjD,eAAe,CAAC;QACd,MAAM,EAAE,qCAAqC;QAC7C,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,SAAS,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/H,CAAC;AAED,MAAM,qCAAqC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACrE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,8CAA8C,CAAC;IACrG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QACpF,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,qCAAqC,EAAE,CAAC"}
+{"version":3,"file":"get-web-live-component-detail.js","sourceRoot":"","sources":["../../../src/tools/live/get-web-live-component-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,8CAA8C,EAAG,MAAM,2DAA2D,CAAC;AAC5H,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,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IACjD,eAAe,CAAC;QACd,MAAM,EAAE,qCAAqC;QAC7C,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACvI,CAAC;AAED,MAAM,qCAAqC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACrE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,8CAA8C,CAAC;IACrG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QACpF,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,qCAAqC,EAAE,CAAC"}

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

@@ -11,7 +11,7 @@ function getResultText(params) {
         info: componentName,
         framework: framework,
     });
-    return getDocContent(['livekit', `${handleFramework(framework)}`, 'states', `${handleStateName(componentName)}.md`]);
+    return getDocContent(['livekit', 'live', `${handleFramework(framework)}`, 'states', `${handleStateName(componentName)}.md`]);
 }
 const registerGetWebLiveStateDetailTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = GET_WEB_LIVE_STATE_DETAIL_DEFINITION;