devlens-mcp 0.3.0

package/dist/src/tools/metro-tools.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metroToolSchemas = void 0;
+exports.createMetroToolHandlers = createMetroToolHandlers;
+const zod_1 = require("zod");
+const metro_bridge_js_1 = require("../metro/metro-bridge.js");
+const retry_js_1 = require("../utils/retry.js");
+exports.metroToolSchemas = {
+    devlens_metro_status: {
+        description: "Check if the Metro bundler is running and healthy. Reports connection state, port, and packager status. Use this proactively before Metro-dependent operations, or when the app seems stuck or unresponsive.",
+        parameters: zod_1.z.object({}),
+    },
+    devlens_metro_logs: {
+        description: "Get console log output from the React Native app via Metro bundler. Shows console.log, console.warn, console.error messages from your app code. Requires Metro bundler to be running.",
+        parameters: zod_1.z.object({
+            level: zod_1.z
+                .enum(["error", "warn", "info", "debug"])
+                .optional()
+                .describe("Minimum log level to include. 'error' shows only errors, 'warn' includes warnings, 'info' includes info+log, 'debug' includes everything."),
+            since: zod_1.z
+                .string()
+                .optional()
+                .describe("Only show logs after this ISO timestamp (e.g., from a previous call). Omit to get all buffered logs."),
+        }),
+    },
+    devlens_component_tree: {
+        description: "Get the React component hierarchy of the running app. Shows component names (like <HomeScreen>, <ProductCard>), their props, and nesting structure. Requires React DevTools hook to be available (__DEV__ mode).",
+        parameters: zod_1.z.object({
+            depth: zod_1.z
+                .number()
+                .default(10)
+                .describe("Maximum depth of the component tree to return (default: 10)"),
+        }),
+    },
+    devlens_hot_reload: {
+        description: "Trigger a hot reload / fast refresh of the React Native app. Call this after modifying source code to see changes on the device without a full rebuild.",
+        parameters: zod_1.z.object({}),
+    },
+    devlens_network_requests: {
+        description: "List network requests (fetch/XHR) made by the React Native app. Shows URLs, methods, status codes, and timing. Useful for debugging API calls.",
+        parameters: zod_1.z.object({
+            urlPattern: zod_1.z
+                .string()
+                .optional()
+                .describe("Filter requests by URL substring (e.g., '/api/' or 'graphql')"),
+        }),
+    },
+    devlens_dismiss_overlays: {
+        description: "Dismiss React Native debug overlays (LogBox warnings, dev menu banners) that interfere with screenshots and visual comparisons. Suppresses LogBox via CDP and optionally presses Back to close modal overlays.",
+        parameters: zod_1.z.object({
+            suppressLogBox: zod_1.z
+                .boolean()
+                .default(true)
+                .describe("Suppress LogBox warnings/errors via JavaScript injection (default: true)"),
+            pressBack: zod_1.z
+                .boolean()
+                .default(false)
+                .describe("Press the device Back button to dismiss modal overlays like the dev menu (default: false)"),
+        }),
+    },
+};
+function createMetroToolHandlers(metroPort, deviceManager) {
+    let bridge = null;
+    async function ensureConnected() {
+        if (bridge && bridge.connected)
+            return bridge;
+        bridge = new metro_bridge_js_1.MetroBridge(metroPort);
+        // Check if Metro is even running before attempting CDP connection
+        const status = await bridge.getStatus();
+        if (!status.running) {
+            throw new Error(`Metro bundler is not running on port ${metroPort}. ` +
+                `${status.error || ""}\n` +
+                `Start it with: npx react-native start\n` +
+                `Check status with: devlens_metro_status`);
+        }
+        try {
+            await (0, retry_js_1.retry)(() => bridge.connect(), {
+                maxAttempts: 2,
+                delayMs: 1000,
+                backoff: true,
+            });
+        }
+        catch (error) {
+            throw new Error(`Metro is running but CDP connection failed on port ${metroPort}. ` +
+                `This can happen if another debugger is already connected. Error: ${error.message}`);
+        }
+        return bridge;
+    }
+    return {
+        devlens_metro_status: async () => {
+            const probe = new metro_bridge_js_1.MetroBridge(metroPort);
+            const status = await probe.getStatus();
+            const lines = [
+                `Metro Port: ${status.port}`,
+                `Packager Running: ${status.running ? "YES" : "NO"}`,
+                `Packager Status: ${status.packagerStatus || "(no response)"}`,
+                `CDP Connected: ${bridge?.connected ? "YES" : "NO"}`,
+            ];
+            if (status.error) {
+                lines.push("", `Error: ${status.error}`);
+                lines.push("", "Suggestion: Run 'npx react-native start' to start Metro.");
+            }
+            else if (status.running) {
+                lines.push("", "Metro is healthy and ready.");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+                ...(status.running ? {} : { isError: true }),
+            };
+        },
+        devlens_metro_logs: async (params) => {
+            const b = await ensureConnected();
+            const logs = b.logCollector.getLogs({
+                level: params.level,
+                since: params.since ? new Date(params.since).getTime() : undefined,
+                limit: 100,
+            });
+            if (logs.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No console logs captured. Logs appear as the app runs and calls console.log/warn/error.",
+                        },
+                    ],
+                };
+            }
+            const lines = logs.map((log) => {
+                const time = new Date(log.timestamp).toISOString().slice(11, 23);
+                const prefix = log.level === "error"
+                    ? "ERROR"
+                    : log.level === "warn"
+                        ? "WARN "
+                        : log.level === "debug"
+                            ? "DEBUG"
+                            : "LOG  ";
+                return `[${time}] ${prefix} ${log.message}`;
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Metro logs (${logs.length} entries):\n\n${lines.join("\n")}`,
+                    },
+                ],
+            };
+        },
+        devlens_component_tree: async (params) => {
+            const b = await ensureConnected();
+            try {
+                const tree = await b.getComponentTree(params.depth);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `React Component Tree:\n\n${tree}`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Could not retrieve component tree: ${error.message}\n\nEnsure the app is running in __DEV__ mode and React DevTools hook is available.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+        devlens_hot_reload: async () => {
+            const b = await ensureConnected();
+            await b.hotReload();
+            // Wait a moment for the reload to take effect
+            await new Promise((resolve) => setTimeout(resolve, 1500));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Hot reload triggered. The app should reflect your latest code changes.",
+                    },
+                ],
+            };
+        },
+        devlens_network_requests: async (params) => {
+            const b = await ensureConnected();
+            const requests = b.networkInspector.getRequests(params.urlPattern);
+            if (requests.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: params.urlPattern
+                                ? `No network requests matching "${params.urlPattern}" found.`
+                                : "No network requests captured yet. Requests appear as the app makes fetch/XHR calls.",
+                        },
+                    ],
+                };
+            }
+            const lines = requests.slice(0, 50).map((req) => {
+                const status = req.error
+                    ? `FAIL (${req.error})`
+                    : req.status
+                        ? `${req.status}`
+                        : "pending";
+                const duration = req.duration ? `${req.duration}ms` : "...";
+                const size = req.size ? `${(req.size / 1024).toFixed(1)}KB` : "";
+                return `${req.method} ${status} ${duration} ${size} ${req.url}`;
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Network requests (${requests.length} total, showing up to 50):\n\n${lines.join("\n")}`,
+                    },
+                ],
+            };
+        },
+        devlens_dismiss_overlays: async (params) => {
+            const results = [];
+            if (params.suppressLogBox) {
+                try {
+                    const b = await ensureConnected();
+                    const jsCode = `(function() {
+            var r = [];
+            try { require('react-native').LogBox.ignoreAllLogs(true); r.push('LogBox suppressed'); } catch(e) {}
+            try { require('react-native/Libraries/LogBox/LogBox').uninstall(); r.push('LogBox uninstalled'); } catch(e) {}
+            try {
+              var DevSettings = require('react-native').DevSettings || require('react-native/Libraries/Utilities/DevSettings');
+              if (DevSettings && DevSettings.setHotLoadingEnabled) { DevSettings.setHotLoadingEnabled(false); }
+              r.push('DevSettings accessed');
+            } catch(e) {}
+            return r.join('; ') || 'No LogBox APIs found';
+          })()`;
+                    const evalResult = await b.evaluate(jsCode);
+                    results.push(typeof evalResult === "string" ? evalResult : "LogBox suppression attempted");
+                }
+                catch (error) {
+                    results.push(`LogBox suppression failed: ${error.message}`);
+                }
+            }
+            if (params.pressBack) {
+                try {
+                    const device = await deviceManager.getDevice();
+                    await device.pressButton("back");
+                    results.push("Back button pressed (dismiss modal overlay)");
+                }
+                catch (error) {
+                    results.push(`Back button failed: ${error.message}`);
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Overlay dismissal:\n${results.map((r) => `  - ${r}`).join("\n")}`,
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=metro-tools.js.map

package/dist/src/tools/metro-tools.js.map

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

package/dist/src/tools/navigation-tools.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { DeviceManager } from "../platform/device-manager.js";
+import type { RefRegistry } from "../snapshot/ref-registry.js";
+export declare const navigationToolSchemas: {
+    devlens_open_url: {
+        description: string;
+        parameters: z.ZodObject<{
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+        }, {
+            url: string;
+        }>;
+    };
+    devlens_go_back: {
+        description: string;
+        parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    };
+};
+export declare function createNavigationToolHandlers(deviceManager: DeviceManager, refRegistry: RefRegistry, onNavigate?: () => void): {
+    devlens_open_url: (params: {
+        url: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_go_back: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=navigation-tools.d.ts.map

package/dist/src/tools/navigation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAiBjC,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,MAAM,IAAI;+BAWY;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;EAgCnD"}

package/dist/src/tools/navigation-tools.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.navigationToolSchemas = void 0;
+exports.createNavigationToolHandlers = createNavigationToolHandlers;
+const zod_1 = require("zod");
+const formatter_js_1 = require("../snapshot/formatter.js");
+exports.navigationToolSchemas = {
+    devlens_open_url: {
+        description: "Open a URL on the device. Supports deep links (e.g., myapp://screen/home), web URLs, and universal links.",
+        parameters: zod_1.z.object({
+            url: zod_1.z
+                .string()
+                .describe("URL to open (e.g., 'https://example.com' or 'myapp://screen/profile')"),
+        }),
+    },
+    devlens_go_back: {
+        description: "Navigate back on the device. On Android, presses the system back button. On iOS, performs a back swipe gesture.",
+        parameters: zod_1.z.object({}),
+    },
+};
+function createNavigationToolHandlers(deviceManager, refRegistry, onNavigate) {
+    async function getUpdatedSnapshot() {
+        const device = await deviceManager.getDevice();
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        const snapshot = await device.getSnapshot();
+        const nodeToRef = refRegistry.assignRefs(snapshot);
+        return (0, formatter_js_1.formatSnapshot)(snapshot, nodeToRef);
+    }
+    return {
+        devlens_open_url: async (params) => {
+            const device = await deviceManager.getDevice();
+            await device.openUrl(params.url);
+            onNavigate?.();
+            const snapshot = await getUpdatedSnapshot();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Opened URL: ${params.url}\n\n${snapshot}`,
+                    },
+                ],
+            };
+        },
+        devlens_go_back: async () => {
+            const device = await deviceManager.getDevice();
+            await device.pressButton("back");
+            onNavigate?.();
+            const snapshot = await getUpdatedSnapshot();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Navigated back\n\n${snapshot}`,
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=navigation-tools.js.map

package/dist/src/tools/navigation-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-tools.js","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":";;;AAwBA,oEA8CC;AAtED,6BAAwB;AAGxB,2DAA0D;AAE7C,QAAA,qBAAqB,GAAG;IACnC,gBAAgB,EAAE;QAChB,WAAW,EACT,2GAA2G;QAC7G,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,OAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,CACP,uEAAuE,CACxE;SACJ,CAAC;KACH;IACD,eAAe,EAAE;QACf,WAAW,EACT,iHAAiH;QACnH,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB;CACF,CAAC;AAEF,SAAgB,4BAA4B,CAC1C,aAA4B,EAC5B,WAAwB,EACxB,UAAuB;IAEvB,KAAK,UAAU,kBAAkB;QAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;QAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,IAAA,6BAAc,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,gBAAgB,EAAE,KAAK,EAAE,MAAuB,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjC,UAAU,EAAE,EAAE,CAAC;YAEf,MAAM,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,eAAe,MAAM,CAAC,GAAG,OAAO,QAAQ,EAAE;qBACjD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,eAAe,EAAE,KAAK,IAAI,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,UAAU,EAAE,EAAE,CAAC;YAEf,MAAM,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qBAAqB,QAAQ,EAAE;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}