weixin-devtools-mcp 0.0.1 → 0.1.0

package/build/tools/assert.js

@@ -3,94 +3,10 @@
  * 提供各种元素状态和内容的断言验证功能
  */
 import { z } from 'zod';
-import { defineTool } from './ToolDefinition.js';
-import { assertElementExists, assertElementVisible, assertElementText, assertElementAttribute } from '../tools.js';
-/**
- * 断言元素存在
- */
-export const assertExistsTool = defineTool({
-    name: 'assert_exists',
-    description: '断言元素存在或不存在',
-    schema: z.object({
-        selector: z.string().optional().describe('CSS选择器'),
-        uid: z.string().optional().describe('元素UID'),
-        shouldExist: z.boolean().describe('期望存在状态，true为存在，false为不存在'),
-        timeout: z.number().optional().default(5000).describe('等待超时时间(毫秒)，默认5000ms'),
-    }),
-    annotations: {
-        audience: ['developers'],
-    },
-    handler: async (request, response, context) => {
-        const { selector, uid, shouldExist, timeout } = request.params;
-        if (!selector && !uid) {
-            throw new Error('必须提供selector或uid参数');
-        }
-        if (!context.currentPage) {
-            throw new Error('请先获取当前页面');
-        }
-        try {
-            const options = {
-                selector,
-                uid,
-                shouldExist,
-                timeout
-            };
-            const result = await assertElementExists(context.currentPage, options);
-            // 根据断言结果返回信息
-            response.appendResponseLine(`断言结果: ${result.passed ? '通过' : '失败'}`);
-            response.appendResponseLine(`消息: ${result.message}`);
-            response.appendResponseLine(`期望: ${result.expected}`);
-            response.appendResponseLine(`实际: ${result.actual}`);
-            response.appendResponseLine(`时间戳: ${new Date(result.timestamp).toISOString()}`);
-            if (!result.passed) {
-                throw new Error(`断言失败: ${result.message}`);
-            }
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            response.appendResponseLine(`断言执行失败: ${errorMessage}`);
-            throw error;
-        }
-    },
-});
-/**
- * 断言元素可见性
- */
-export const assertVisibleTool = defineTool({
-    name: 'assert_visible',
-    description: '断言元素可见或不可见',
-    schema: z.object({
-        uid: z.string().describe('元素UID'),
-        visible: z.boolean().describe('期望可见状态，true为可见，false为不可见'),
-    }),
-    annotations: {
-        audience: ['developers'],
-    },
-    handler: async (request, response, context) => {
-        const { uid, visible } = request.params;
-        if (!context.currentPage) {
-            throw new Error('请先获取当前页面');
-        }
-        try {
-            const options = { uid, visible };
-            const result = await assertElementVisible(context.currentPage, context.elementMap, options);
-            // 根据断言结果返回信息
-            response.appendResponseLine(`断言结果: ${result.passed ? '通过' : '失败'}`);
-            response.appendResponseLine(`消息: ${result.message}`);
-            response.appendResponseLine(`期望: ${result.expected ? '可见' : '不可见'}`);
-            response.appendResponseLine(`实际: ${result.actual ? '可见' : '不可见'}`);
-            response.appendResponseLine(`时间戳: ${new Date(result.timestamp).toISOString()}`);
-            if (!result.passed) {
-                throw new Error(`断言失败: ${result.message}`);
-            }
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            response.appendResponseLine(`断言执行失败: ${errorMessage}`);
-            throw error;
-        }
-    },
-});
+import { assertElementVisible, assertElementText, assertElementAttribute } from '../tools.js';
+import { defineTool, ToolCategory } from './ToolDefinition.js';
+// 注意: assert_exists 和 assert_visible 已合并到 assert_state
+// 使用 assert_state 工具即可验证元素的存在性和可见性
 /**
  * 断言元素文本内容
  */
@@ -104,6 +20,7 @@ export const assertTextTool = defineTool({
         textMatches: z.string().optional().describe('正则表达式匹配'),
     }),
     annotations: {
+        category: ToolCategory.CORE,
         audience: ['developers'],
     },
     handler: async (request, response, context) => {
@@ -151,6 +68,7 @@ export const assertAttributeTool = defineTool({
         attributeValue: z.string().describe('期望的属性值'),
     }),
     annotations: {
+        category: ToolCategory.CORE,
         audience: ['developers'],
     },
     handler: async (request, response, context) => {
@@ -198,6 +116,7 @@ export const assertStateTool = defineTool({
         focused: z.boolean().optional().describe('期望焦点状态'),
     }),
     annotations: {
+        category: ToolCategory.CORE,
         audience: ['developers'],
     },
     handler: async (request, response, context) => {
@@ -243,3 +162,4 @@ export const assertStateTool = defineTool({
         }
     },
 });
+//# sourceMappingURL=assert.js.map

package/build/tools/assert.js.map

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

package/build/tools/connection.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 连接管理工具
+ * 提供 connect / reconnect / disconnect / status 能力
+ */
+export declare const connectDevtoolsTool: import("./ToolDefinition.js").ToolDefinition;
+export declare const reconnectDevtoolsTool: import("./ToolDefinition.js").ToolDefinition;
+export declare const disconnectDevtoolsTool: import("./ToolDefinition.js").ToolDefinition;
+export declare const getConnectionStatusTool: import("./ToolDefinition.js").ToolDefinition;
+/**
+ * 获取当前页面信息
+ */
+export declare const getCurrentPageTool: import("./ToolDefinition.js").ToolDefinition;
+//# sourceMappingURL=connection.d.ts.map

package/build/tools/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/tools/connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsTH,eAAO,MAAM,mBAAmB,8CA4B9B,CAAC;AAEH,eAAO,MAAM,qBAAqB,8CAuBhC,CAAC;AAEH,eAAO,MAAM,sBAAsB,8CAajC,CAAC;AAEH,eAAO,MAAM,uBAAuB,8CAuBlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,8CAuB7B,CAAC"}