@tencentcloud/sdk-mcp 1.3.9 → 1.4.0

package/tools/common/present_framework_choice.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { PRESENT_FRAMEWORK_CHOICE_DEFINITION } from '../definitions/present_framework_choice_def.js';
+const PRODUCT_OPTIONS_MAP = {
+    chat: {
+        title: 'Chat 聊天支持的平台或框架',
+        options: ['react', 'vue', 'flutter', 'android', 'ios'],
+    },
+    call: {
+        title: 'Call 音视频通话支持的平台或框架',
+        options: ['react', 'vue', 'flutter', 'android', 'ios'],
+    },
+    live: {
+        title: 'Live 直播互动支持的平台或框架',
+        options: ['vue', 'flutter', 'android', 'ios', 'uni-app'],
+    },
+    room: {
+        title: 'Room 视频会议支持的平台或框架',
+        options: ['vue'],
+    },
+    rtcengine: {
+        title: 'WebRTC / rtcEngine 支持的平台或框架',
+        options: ['web'],
+    },
+    native_trtc_sdk: {
+        title: 'Native TRTC SDK 支持的平台或框架',
+        options: ['android', 'ios', 'c++'],
+    },
+};
+function buildSelectionText(product, selectionText) {
+    const config = PRODUCT_OPTIONS_MAP[product];
+    if (!config) {
+        return selectionText;
+    }
+    const options = config.options.map((option) => `- '${option}'`).join('\n');
+    return `${selectionText}
+
+请先让用户选择以下平台或框架：
+
+${config.title}：
+${options}
+
+请等待用户回复具体平台后，再调用对应的集成工具或查询工具。`;
+}
+const registryPresentFrameworkChoiceTool = (mcpServer) => {
+    const { name, description, selectionText, parameter_descriptions } = PRESENT_FRAMEWORK_CHOICE_DEFINITION;
+    mcpServer.registerTool(name, {
+        description,
+        inputSchema: {
+            product: z.enum(['chat', 'call', 'live', 'room', 'rtcengine', 'native_trtc_sdk']).describe(parameter_descriptions.product),
+        },
+    }, ({ product }) => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: buildSelectionText(product, selectionText),
+                }
+            ]
+        };
+    });
+};
+export { registryPresentFrameworkChoiceTool };
+//# sourceMappingURL=present_framework_choice.js.map

package/tools/common/present_framework_choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"present_framework_choice.js","sourceRoot":"","sources":["../../../src/tools/common/present_framework_choice.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mCAAmC,EAAE,MAAM,gDAAgD,CAAC;AAErG,MAAM,mBAAmB,GAAyD;IAChF,IAAI,EAAE;QACJ,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;KACvD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;KACvD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC;KACzD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,CAAC,KAAK,CAAC;KACjB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,6BAA6B;QACpC,OAAO,EAAE,CAAC,KAAK,CAAC;KACjB;IACD,eAAe,EAAE;QACf,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC;KACnC;CACF,CAAC;AAEF,SAAS,kBAAkB,CAAC,OAAe,EAAE,aAAqB;IAChE,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3E,OAAO,GAAG,aAAa;;;;EAIvB,MAAM,CAAC,KAAK;EACZ,OAAO;;8BAEqB,CAAC;AAC/B,CAAC;AAED,MAAM,kCAAkC,GAAG,CAAC,SAAoB,EAAE,EAAE;IAClE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,sBAAsB,EAAE,GAAG,mCAAmC,CAAC;IACzG,SAAS,CAAC,YAAY,CACpB,IAAI,EACJ;QACC,WAAW;QACV,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,CAAC;SAC3H;KACF,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC;iBACjD;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,kCAAkC,EAAE,CAAC"}

package/tools/definitions/get_callkit_api_def.js

@@ -0,0 +1,28 @@
+const TOOL_DESCRIPTION = `
+用途：
+返回跨平台 CallKit 含 UI API 文档，适合在已明确平台后查询单功能能力对应的 API、方法、参数、回调和配置方式。
+
+典型适用问题：
+CallKit API, TUICallKit API, React, Vue, Android, iOS, Flutter, 含 UI API, 单功能查询, 某个能力用哪个 API, 方法名是什么, 最新接口是什么, 参数怎么传, 回调怎么监听, 某个功能怎么设置, 某个功能怎么配置, 自定义 UI, 方法用法, 事件回调, calls, join, setSelfInfo
+
+输入：
+- framework: react | vue | android | ios | flutter
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
+
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 面向 CallKit preset 线路下的已明确平台的单功能/API 查询，不负责整体集成主路径或交互式平台选择
+`;
+const PARAMETER_DESCRIPTIONS = {
+    framework: '目标平台或框架。参数名固定为 framework。可选值：react | vue | android | ios | flutter。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+};
+export const GET_CALLKIT_API_DEFINITION = {
+    name: 'get_callkit_api',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_callkit_api_def.js.map

package/tools/definitions/get_callkit_api_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_callkit_api_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_callkit_api_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,qEAAqE;IAChF,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_faq_def.js

@@ -1,32 +1,31 @@
 const TOOL_DESCRIPTION = `
-【核心用途】：这是一个统一的知识检索工具（FAQ/文档查询），专门用于从多业务线的知识库中，根据用户输入的查询和指定参数，检索并返回相关的 Markdown 文档内容。
+用途：
+返回 Tencent RTC FAQ 检索结果，适合查询常见问题、错误定位、鉴权说明、控制台配置和排障信息。
 
-【功能范围】：本工具能够解决以下三大类业务应用的常见问题和集成指南：
-1. 聊天应用 (Chat)：涵盖移动端 (Native)、Web 端 (React/Vue) 等平台搭建的聊天应用解决方案。
-2. 音视频通话应用 (Call)：涵盖移动端 (Native)、Web 端 (React/Vue) 等平台搭建的音视频通话应用解决方案。
-3. 实时音视频 (TRTC)：涵盖 rtc/webrtc 相关平台的常见问题解答、如何部署用户鉴权服务、以及获取 userSig 的算法细节等。
+典型适用问题：
+FAQ, 常见问题, 错误码, 排障, 鉴权失败, userSig 怎么生成, userSig 原理, userSig 签发流程, 服务端鉴权, 控制台配置, 计费, chat faq, call faq, live faq, room faq, rtcengine faq, native trtc sdk faq, react faq, vue faq, web faq, android faq, ios faq, flutter faq, c++ faq
 
-【检索能力】：本工具支持通过以下关键参数进行精确过滤和检索：
-- query (用户输入的查询或问题)
-- 产品线 (product)：LLM 推理出的产品名称，用于路由，区分 chat, call, live, room, rtcengine 等。
-- 平台/框架 (framework)：LLM 推理出的平台或框架，用于路由，区分 react, vue, web, flutter, android, ios 等。
+输入：
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- product: chat | call | live | room | rtcengine | native_trtc_sdk
+- framework: react | vue | web | flutter | android | ios | c++
 
-【关键词】：FAQ, 知识库, 文档检索, 常见问题, Chat, Call, TRTC, 实时音视频, 用户鉴权, userSig, SDK。
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
 
-【强制约束】：\n
-1. 产品线选择约束：如果 LLM 无法从用户提示词中明确推理出目标产品线（product），必须优引导用户选择以下产品产品中的一个（chat, call, live, room, rtcengine）。
-2. 框架选择约束：如果 LLM 无法从用户提示词中明确推理出目标平台或框架（framework），必须优先调用 'present_framework_choice' 工具，引导用户选择平台/框架。
-
-【返回格式】: 返回包含原始 Markdown 内容、结构化 JSON 对象。
+边界：
+- 面向 FAQ、错误码、控制台、鉴权说明和排障信息，不返回主集成文档或组件/API 专题文档
+- 当前定义已覆盖：chat | call | live | room | rtcengine | native_trtc_sdk
+- 当前 framework 定义已覆盖：react | vue | web | flutter | android | ios | c++
 `;
 const PARAMETER_DESCRIPTIONS = {
-    query: '用户输入的查询或问题文本',
-    product: 'LLM 推理出的目标产品名称（如：chat, call, live, room, rtcengine）',
-    framework: 'LLM 推理出的平台或框架（如：react, vue, web, flutter, android, ios）',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    product: '目标产品。可选值：chat | call | live | room | rtcengine | native_trtc_sdk。',
+    framework: '目标平台或框架。参数名固定为 framework。可选值：react | vue | web | flutter | android | ios | c++。',
 };
 export const GET_FAQ_DEFINITION = {
     name: 'get_faq',
     description: TOOL_DESCRIPTION,
-    parameter_descriptions: PARAMETER_DESCRIPTIONS
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
 };
 //# sourceMappingURL=get_faq_def.js.map

package/tools/definitions/get_faq_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_faq_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_faq_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,qDAAqD;IAC9D,SAAS,EAAE,yDAAyD;CACrE,CAAC;AAGF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}
+{"version":3,"file":"get_faq_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_faq_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,mEAAmE;IAC5E,SAAS,EAAE,iFAAiF;CAC7F,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_native_call_uikit_integration_def.js

@@ -1,45 +1,26 @@
 const TOOL_DESCRIPTION = `
-【核心用途】：作为一个专业的 Native 音视频通话 TUICallKit 集成助手，本工具专用于为 Agent 提供工作流行动指令和实时聚合的最新文档内容，以指导 LLM 帮用户实现移动端音视频通话功能。
+用途：
+返回 Native TUICallKit preset 集成文档，供 AI 完成移动端音视频通话接入与代码生成。
 
-【⚠️ 重要参数提醒】：
-本工具的平台参数名是 "framework"，不是 "platform"！
-- ✅ 正确调用：{"framework": "android"}
-- ❌ 错误调用：{"platform": "android"}
+典型适用问题：
+Native Call UIKit, Native TUICallKit, TUICallKit, preset 集成, 音视频通话, 视频通话, 语音通话, Flutter, Android, iOS, 呼叫, 接听, 单人通话, 多人通话, 集成
 
-【功能目标 (Goals)】：
-集成完整的音视频通话功能。包含单人通话、多人通话、呼叫接听、通话界面等。**适用于构建类似微信/企微风格的音视频通话应用，支持一对一和多人通话场景。**
+输入：
+- framework: flutter | android | ios
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
 
-【关键词】：
-'Native', '移动端', 'Call', 'TUICallKit', '音视频通话', '视频通话', '语音通话', '微信', '企微', 'Flutter', 'Android', 'iOS', '集成', '单人通话', '多人通话', '呼叫', '接听'。
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
 
-【行动指令与工作流引导】：
-Agent 在处理用户需求时，应使用本工具返回的 llm_code_generation_instructions_md 字段。这个字段包含了：
-1. 核心工作流指令：包含环境准备、依赖安装、初始化 SDK、鉴权 UserSig 以及组件的版本说明。
-2. 实时文档内容：提供官方集成指南的最新内容。
-
-LLM 必须优先且唯一使用本工具返回的实时内容生成代码，避免自行访问外部 URL。
-
-【参数说明】：
-- **framework** (必需): 目标开发平台。注意参数名是 "framework" 不是 "platform"
-  - "flutter": Flutter 跨平台开发
-  - "android": Android 原生开发  
-  - "ios": iOS 原生开发
-
-【调用示例】：
-- Android 集成：{"framework": "android"}
-- iOS 集成：{"framework": "ios"}
-- Flutter 集成：{"framework": "flutter"}
-
-【强制约束】：
-1. 平台选择约束：参数名必须使用 "framework"（不是 platform）。如果用户未明确指定平台，或意图不清晰，必须优先调用 'present_framework_choice' 工具，引导用户在 flutter, android, ios 中进行选择。
-2. 结果记录约束：在 TUICallKit 组件集成完成且项目启动成功后，必须调用 'record_result' 工具记录集成结果。
-
-【支持平台】：flutter, android, ios。
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 面向 Native CallKit preset 整体集成，不负责平台选择，也不负责铃声、虚拟背景、头像昵称、悬浮窗等单功能/API 设置问题
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '【重要】Native 音视频通话 TUICallKit 平台类型。注意：参数名是 "framework" 不是 "platform"！可选值：flutter (Flutter 跨平台), android (Android 原生), ios (iOS 原生)。',
+    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：flutter | android | ios。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
 };
-export const GET_NATIVE_CALL_UIKIT_DEFINITION = {
+export const GET_NATIVE_CALL_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_native_call_uikit_integration',
     description: TOOL_DESCRIPTION,
     parameter_descriptions: PARAMETER_DESCRIPTIONS,

package/tools/definitions/get_native_call_uikit_integration_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_native_call_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_call_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,mIAAmI;CAC/I,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}
+{"version":3,"file":"get_native_call_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_call_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,iEAAiE;IAC5E,MAAM,EAAE,+BAA+B;CACxC,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/get_native_chat_uikit_feature_detail_def.js

@@ -0,0 +1,31 @@
+const TOOL_DESCRIPTION = `
+用途：
+返回 Native Chat UIKit 功能详情文档，适合查询单个功能的 API、用法和示例代码。
+
+典型适用问题：
+Native Chat UIKit, 功能详情, Android, iOS, Flutter, theme, 主题定制, 深色模式, UI 定制, TUITheme
+
+输入：
+- framework: android | ios | flutter
+- featureName: theme
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
+
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 面向单个聊天功能与专题能力，不负责 Chat UIKit 完整集成主路径
+- featureName 需要使用受支持的功能名
+`;
+const PARAMETER_DESCRIPTIONS = {
+    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios | flutter。',
+    featureName: '功能名。当前支持：theme（主题定制）。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+};
+export const GET_NATIVE_CHAT_UIKIT_FEATURE_DETAIL_DEFINITION = {
+    name: 'get_native_chat_uikit_feature_detail',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_chat_uikit_feature_detail_def.js.map

package/tools/definitions/get_native_chat_uikit_feature_detail_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_chat_uikit_feature_detail_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_chat_uikit_feature_detail_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,iEAAiE;IAC5E,WAAW,EAAE,uBAAuB;IACpC,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,+CAA+C,GAAG;IAC7D,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_native_chat_uikit_integration_def.js

@@ -1,51 +1,26 @@
 const TOOL_DESCRIPTION = `
-【核心用途】：作为一个专业的 Native 聊天 TUIKit 集成助手，本工具专用于为 Agent 提供工作流行动指令和实时聚合的最新文档内容，以指导 LLM 帮用户实现移动端即时通信（IM）功能。
+用途：
+返回 Native Chat UIKit 集成文档，供 AI 完成移动端 IM 应用接入或聊天窗口接入。
 
-【⚠️ 重要参数提醒】：
-本工具的平台参数名是 "framework"，不是 "platform"！
-- ✅ 正确调用：{"framework": "android", "goals": ["full-featured"]}
-- ❌ 错误调用：{"platform": "android", "goals": ["full-featured"]}
-\n
+典型适用问题：
+Native Chat UIKit, TUIKit, IM, 聊天, 会话列表, 聊天窗口, Flutter, Android, iOS, full-featured, chat-only, 客服, 问诊
 
-【功能目标 (Goals)】：
-1. full-featured: 集成全量功能。包含会话列表、聊天窗口、群组管理、个人中心等。**适用于构建微信/企微风格的完整移动应用，或作为 App 的核心 Tab 模块。**
-2. chat-only: 仅集成聊天窗口。**适用于客服咨询、医疗在线问诊、订单详情页私聊等轻量级对话场景。**
+输入：
+- framework: flutter | android | ios
+- goals: [full-featured] | [chat-only]
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
 
-【参数说明】：
-- **framework** (必需): 目标开发平台。注意参数名是 "framework" 不是 "platform"
-  - "flutter": Flutter 跨平台开发
-  - "android": Android 原生开发  
-  - "ios": iOS 原生开发
-- **goals** (必需): 功能目标列表
-  - ["full-featured"]: 完整应用功能
-  - ["chat-only"]: 仅聊天窗口
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
 
-【调用示例】：
-- Android 全功能集成：{"framework": "android", "goals": ["full-featured"]}
-- iOS 聊天窗口：{"framework": "ios", "goals": ["chat-only"]}
-- Flutter 全功能：{"framework": "flutter", "goals": ["full-featured"]}
-
-【关键词】：
-'Native', '移动端', 'Chat', 'TUIKit', '聊天', '即时通信', '微信', '企微', 
-'framework=flutter', 'framework=android', 'framework=ios', 
-'集成', '客服', '医疗问诊', 'TabBar', '消息入口', '会话列表', '对话框'。
-
-【行动指令与工作流引导】：\n
-Agent 在处理用户需求时，应使用本工具返回的 llm_code_generation_instructions_md 字段。这个字段包含了：
-1. 核心工作流指令：包含环境准备、依赖安装、初始化 SDK、鉴权 UserSig 以及组件的版本说明。
-2. 实时文档内容：根据选择的 goals 动态返回对应的官方集成指南。
-
-LLM 必须优先且唯一使用本工具返回的实时内容生成代码，避免自行访问外部 URL。\n
-
-【强制约束】：
-1. 平台选择约束：参数名必须使用 "framework"（不是 platform）。如果用户未明确指定平台，或意图不清晰，必须优先调用 'present_framework_choice' 工具，引导用户在 flutter, android, ios 中进行选择。
-2. 结果记录约束：在 TUIKit 组件集成完成且项目启动成功后，必须调用 'record_result' 工具记录集成结果。
-
-【支持平台】：flutter, android, ios。
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 面向 Native Chat UIKit 整体集成，不负责平台选择或单功能深挖
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '⚠️ 注意参数名是 "framework" 不是 "platform"！Native 聊天 TUIKit 平台类型。可选值：flutter (Flutter 跨平台), android (Android 原生), ios (iOS 原生)。',
-    goals: "用户请求实现的功能目标列表。可选值：['full-featured'] (标准应用), ['chat-only'] (客服/问诊/弹窗)。",
+    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：flutter | android | ios。',
+    goals: '功能目标数组。仅允许传一个值，可选值：full-featured（完整应用）| chat-only（单聊天窗口）。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
 };
 export const GET_NATIVE_CHAT_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_native_chat_uikit_integration',

package/tools/definitions/get_native_chat_uikit_integration_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_native_chat_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_chat_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,0HAA0H;IACrI,KAAK,EAAE,uEAAuE;CAC/E,CAAC;AAEF,MAAM,CAAC,MAAM,4CAA4C,GAAG;IAC1D,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}
+{"version":3,"file":"get_native_chat_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_chat_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;CAkBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,iEAAiE;IAC5E,KAAK,EAAE,2DAA2D;IAClE,MAAM,EAAE,+BAA+B;CACxC,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/get_native_livekit_core_features_def.js

@@ -0,0 +1,33 @@
+const TOOL_DESCRIPTION = `
+用途：
+返回基于 AtomicXCore SDK 的 Native LiveKit Core 功能扩展文档，适合在已有视频直播或语聊房基础上继续实现互动与特效能力。视频直播场景重点覆盖连麦、PK、观众管理、美颜、音效、弹幕、礼物；语聊房场景重点覆盖上麦、PK、成员列表。
+
+典型适用问题：
+Native LiveKit Core, AtomicXCore, 无 UI SDK, Core SDK, co_guest, co_host, 连麦, PK, 观众管理, 上麦, 麦位管理, 成员列表, 视频直播, 语聊房, 美颜, 音效, 弹幕, 礼物, BaseBeautyStore, AudioEffectStore, BarrageStore, GiftStore, Android, iOS, Flutter, uni-app
+
+输入：
+- scenario: live | voice
+- framework: android | ios | flutter | uni-app
+- goals: 功能模块列表
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
+
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 面向基于 AtomicXCore SDK 的已有视频直播或语聊房项目功能扩展，不负责基础开播、观看或房间列表集成
+- 'base_beauty'、'audio_effect'、'barrage'、'gift' 当前仅适用于 'scenario=live'
+`;
+const PARAMETER_DESCRIPTIONS = {
+    scenario: '场景类型。可选值：live（视频直播）| voice（语聊房）。当需求是开播、观看、房间列表时应使用 integration；当需求是连麦、PK、成员列表、美颜、音效、弹幕、礼物时使用 features。',
+    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios | flutter | uni-app。',
+    goals: '功能列表。可选值：co_guest_interaction（观众连麦/听众上麦）| co_host_interaction（主播连线/PK）| audience_list（成员/观众列表）| base_beauty（美颜）| audio_effect（音效）| barrage（弹幕）| gift（礼物）。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+};
+export const GET_NATIVE_LIVEKIT_CORE_FEATURES_DEFINITION = {
+    name: 'get_native_livekit_core_features',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_livekit_core_features_def.js.map

package/tools/definitions/get_native_livekit_core_features_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_livekit_core_features_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_livekit_core_features_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,wGAAwG;IAClH,SAAS,EAAE,2EAA2E;IACtF,KAAK,EAAE,2JAA2J;IAClK,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,2CAA2C,GAAG;IACzD,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_native_livekit_core_integration_def.js

@@ -0,0 +1,33 @@
+const TOOL_DESCRIPTION = `
+用途：
+返回基于 AtomicXCore SDK 的 Native LiveKit Core 基础集成文档，适合实现视频直播或语聊房的开播、观看和房间列表。视频直播场景重点覆盖主播开播、观众观看、直播列表；语聊房场景重点覆盖房主开房、听众进房、语聊房列表。
+
+典型适用问题：
+Native LiveKit Core, AtomicXCore, 无 UI SDK, Core SDK, 视频直播, 语聊房, 开播, 观看, 房间列表, Android, iOS, Flutter, uni-app, live, voice
+
+输入：
+- scenario: live | voice
+- framework: android | ios | flutter | uni-app
+- goals: 功能模块列表
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
+
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 面向基于 AtomicXCore SDK 的视频直播或语聊房基础集成主路径，不负责连麦、PK、成员列表、美颜、音效、弹幕、礼物等功能扩展
+- 返回的是 Core/Store 级基础集成文档，不是完整预制 UIKit 页面模板
+`;
+const PARAMETER_DESCRIPTIONS = {
+    scenario: '场景类型。可选值：live（视频直播）| voice（语聊房）。当需求是开播、观看、房间列表时使用 integration；当需求是连麦、PK、成员列表、美颜、音效、弹幕、礼物时应使用 features。',
+    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios | flutter | uni-app。',
+    goals: '功能列表。可选值：host_streaming（主播/房主开播）| audience_streaming（观众/听众观看）| live_list（房间列表）。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+};
+export const GET_NATIVE_LIVEKIT_CORE_INTEGRATION_DEFINITION = {
+    name: 'get_native_livekit_core_integration',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_livekit_core_integration_def.js.map

package/tools/definitions/get_native_livekit_core_integration_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_livekit_core_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_livekit_core_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,wGAAwG;IAClH,SAAS,EAAE,2EAA2E;IACtF,KAAK,EAAE,iFAAiF;IACxF,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,8CAA8C,GAAG;IAC5D,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_native_trtc_sdk_docs_def.js

@@ -0,0 +1,32 @@
+const TOOL_DESCRIPTION = `
+用途：
+按平台返回 Native TRTC SDK 对应文档域，适合查询核心 API、类型定义、回调、统计、音效、美颜、设备和错误码。
+
+典型适用问题：
+TRTC SDK, 实时音视频, 互动直播, 多人音视频, 屏幕分享, 录制, 连麦, PK, Android, iOS, C++, 进房, 退房, 本地预览, 远端渲染, 回调, 事件监听, 参数结构, 编码参数, 统计信息, 音效, 美颜, 设备管理, 错误码, 具体错误码, error code, -4009, -13xx, TXLiteAVCode, 某个错误码含义, 某个错误码怎么处理
+
+输入：
+- framework: android | ios | c++
+- intent: core_api | type_def | callback | statistics | audio_effect | beauty | device | error_code
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
+
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 仅返回 Native TRTC SDK 文档内容，不负责 UIKit 集成或平台选择
+- 每次只返回一个平台下的一个文档域，不会合并整个平台全部文档
+- 已知具体错误码时，应优先使用 error_code 文档域
+`;
+const PARAMETER_DESCRIPTIONS = {
+    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios | c++。',
+    intent: '文档域。可选值：core_api（核心 API）| type_def（类型定义）| callback（回调事件）| statistics（统计信息）| audio_effect（音效）| beauty（美颜）| device（设备管理）| error_code（错误码）。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+};
+export const GET_NATIVE_TRTC_SDK_DOCS_DEFINITION = {
+    name: 'get_native_trtc_sdk_docs',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_trtc_sdk_docs_def.js.map

package/tools/definitions/get_native_trtc_sdk_docs_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_trtc_sdk_docs_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_trtc_sdk_docs_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,6DAA6D;IACxE,MAAM,EAAE,0IAA0I;IAClJ,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_usersig_def.js

@@ -1,28 +1,21 @@
 const TOOL_DESCRIPTION = `
-  【核心用途】:\n
-  使用用户通过 MCP 环境变量配置的 SDKAppID 和 secretKey，安全地生成用于登录腾讯云应用的 UserSig (用户签名)凭证。\n
-  适用于所有需要 SDKAppID、userID 和 userSig 进行身份验证的腾讯云应用场景，包括：即时通信 IM (IM) 和 实时音视频 TRTC (TRTC)。\n
-  
-  【必填参数】:\n
-  - userID\n
-  
-  【关键词】:\n
-  userSig, IM, TRTC, SDKAppID, secretKey, userID, 用户签名, 登录凭证, 账号信息, 腾讯云登录 \n
-  
-  【重要安全与约束】:\n
-  1. 配置引导:\n
-    - 如果 SDKAppID 和 secretKey 未配置，工具将无法执行。\n
-    - 必须引导用户通过MCP 环境变量配置 SDKAppID 和 secretKey，然后再次尝试调用本工具。\n
-  2. 密钥来源:\n
-    - 即时通信 IM 应用：请从 IM 控制台 (https://console.cloud.tencent.com/im) 获取 SDKAppID 和 secretKey。\n
-    - 实时音视频 TRTC 应用：请从 **TRTC 控制台** (https://console.cloud.tencent.com/trtc) 获取 SDKAppID 和 secretKey。\n
-  3. 安全提醒:\n
-    - 前端生成 userSig 是不安全的。请务必提醒用户：在应用正式上线前，UserSig 必须在后端服务生成。\n
-  4. 禁止行为:\n
-    - 禁止引导用户在控制台手动生成 userSig 后粘贴到代码中。\n
-    - 禁止给用户输出使用示例，输出 SDKAppID、userID、userSig 结果即可。\n
-  5. 有效期:\n
-    - userSig 有效期默认为 7 天，该参数当前不可通过工具调整。\n
+用途：
+使用 MCP 环境变量中的 SDKAppID 和 secretKey 生成测试用 userSig，供 IM 或 TRTC 本地联调使用。
+
+典型适用问题：
+为指定 userID 生成 userSig, 生成测试凭证, 本地联调凭证, userID 对应的 userSig, SDKAppID, secretKey, IM, TRTC, 登录凭证
+
+输入：
+- userID
+
+返回：
+- content: [{ type: 'text', text: userSig 结果或错误说明 }]
+
+边界：
+- 面向已明确 userID 的测试凭证生成，不负责解释 userSig 原理、签发流程或生产鉴权方案
+- 仅用于开发测试
+- 生产环境应改为服务端签发
+- 如果环境变量缺失，需先补齐配置
 `;
 export const GET_USERSIG_DEFINITION = {
     name: 'get_usersig',

package/tools/definitions/get_usersig_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_usersig_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_usersig_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBxB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE;QACtB,MAAM,EAAE,iBAAiB;KAC1B;CACF,CAAC"}
+{"version":3,"file":"get_usersig_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_usersig_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;CAkBxB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE;QACtB,MAAM,EAAE,iBAAiB;KAC1B;CACF,CAAC"}

package/tools/definitions/get_web_call_uikit_integration_def.js

@@ -1,16 +1,24 @@
 const TOOL_DESCRIPTION = `
-【核心用途】：用于提供 Web PC/H5 音视频通话应用集成指南，提供 React/Vue 框架下的 TUICallKit 组件集成指南。\n
+用途：
+返回 Web TUICallKit preset 集成文档，适合实现 PC/H5 音视频通话应用。
 
-【功能】：实现类似微信/企微的音视频通话功能和 UI。\n
+典型适用问题：
+Web Call UIKit, Web TUICallKit, TUICallKit, preset 集成, React, Vue, PC, H5, 音视频通话, 视频通话, 语音通话, 集成, 呼叫, 接听
 
-【关键词】：Web PC, H5, TUICallKit, 音视频通话, React, Vue, 集成指南, 'CallKit', '集成'。\n
+输入：
+- framework: react | vue
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
 
-【强制约束与流程】：\n
-1. 框架选择约束：如果用户未明确指定 React 或 Vue，必须优先调用 'present_framework_choice'。\n
-2. 结果记录约束：在集成完成且项目启动成功后，必须调用 'record_result' 工具记录集成结果。\n
+返回：
+- content: [{ type: 'text', text: 文档正文或说明文本 }]
+
+边界：
+- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
+- 面向 Web CallKit preset 整体集成，不负责 API 细节或交互式框架选择
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: 'Web Call TUIKit 框架类型。可选值：react, vue。用于确定提供哪个框架下的组件集成方案。',
+    framework: '目标框架。参数名固定为 framework，禁止传 platform。可选值：react | vue。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
 };
 export const GET_WEB_CALL_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_web_call_uikit_integration',

package/tools/definitions/get_web_call_uikit_integration_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_web_call_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_web_call_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;CAUxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,yDAAyD;CACrE,CAAC;AAGF,MAAM,CAAC,MAAM,yCAAyC,GAAG;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}
+{"version":3,"file":"get_web_call_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_web_call_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,qDAAqD;IAChE,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,yCAAyC,GAAG;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}