devlens-mcp 0.3.0 → 0.3.1

package/src/tools/metro-tools.ts

@@ -1,320 +0,0 @@
-import { z } from "zod";
-import { MetroBridge } from "../metro/metro-bridge.js";
-import type { DeviceManager } from "../platform/device-manager.js";
-import { retry } from "../utils/retry.js";
-
-export const 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: 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: z.object({
-      level: 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: 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: z.object({
-      depth: 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: 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: z.object({
-      urlPattern: 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: z.object({
-      suppressLogBox: z
-        .boolean()
-        .default(true)
-        .describe(
-          "Suppress LogBox warnings/errors via JavaScript injection (default: true)"
-        ),
-      pressBack: z
-        .boolean()
-        .default(false)
-        .describe(
-          "Press the device Back button to dismiss modal overlays like the dev menu (default: false)"
-        ),
-    }),
-  },
-};
-
-export function createMetroToolHandlers(
-  metroPort: number,
-  deviceManager: DeviceManager
-) {
-  let bridge: MetroBridge | null = null;
-
-  async function ensureConnected(): Promise<MetroBridge> {
-    if (bridge && bridge.connected) return bridge;
-
-    bridge = new 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 retry(() => bridge!.connect(), {
-        maxAttempts: 2,
-        delayMs: 1000,
-        backoff: true,
-      });
-    } catch (error: any) {
-      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 MetroBridge(metroPort);
-      const status = await probe.getStatus();
-
-      const lines: string[] = [
-        `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" as const,
-            text: lines.join("\n"),
-          },
-        ],
-        ...(status.running ? {} : { isError: true }),
-      };
-    },
-
-    devlens_metro_logs: async (params: {
-      level?: "error" | "warn" | "info" | "debug";
-      since?: string;
-    }) => {
-      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" as const,
-              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" as const,
-            text: `Metro logs (${logs.length} entries):\n\n${lines.join("\n")}`,
-          },
-        ],
-      };
-    },
-
-    devlens_component_tree: async (params: { depth: number }) => {
-      const b = await ensureConnected();
-
-      try {
-        const tree = await b.getComponentTree(params.depth);
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: `React Component Tree:\n\n${tree}`,
-            },
-          ],
-        };
-      } catch (error: any) {
-        return {
-          content: [
-            {
-              type: "text" as const,
-              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" as const,
-            text: "Hot reload triggered. The app should reflect your latest code changes.",
-          },
-        ],
-      };
-    },
-
-    devlens_network_requests: async (params: { urlPattern?: string }) => {
-      const b = await ensureConnected();
-      const requests = b.networkInspector.getRequests(params.urlPattern);
-
-      if (requests.length === 0) {
-        return {
-          content: [
-            {
-              type: "text" as const,
-              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" as const,
-            text: `Network requests (${requests.length} total, showing up to 50):\n\n${lines.join("\n")}`,
-          },
-        ],
-      };
-    },
-
-    devlens_dismiss_overlays: async (params: {
-      suppressLogBox: boolean;
-      pressBack: boolean;
-    }) => {
-      const results: string[] = [];
-
-      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: any) {
-          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: any) {
-          results.push(`Back button failed: ${error.message}`);
-        }
-      }
-
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `Overlay dismissal:\n${results.map((r) => `  - ${r}`).join("\n")}`,
-          },
-        ],
-      };
-    },
-  };
-}

package/src/tools/navigation-tools.ts

@@ -1,71 +0,0 @@
-import { z } from "zod";
-import type { DeviceManager } from "../platform/device-manager.js";
-import type { RefRegistry } from "../snapshot/ref-registry.js";
-import { formatSnapshot } from "../snapshot/formatter.js";
-
-export const 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: z.object({
-      url: 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: z.object({}),
-  },
-};
-
-export function createNavigationToolHandlers(
-  deviceManager: DeviceManager,
-  refRegistry: RefRegistry,
-  onNavigate?: () => void
-) {
-  async function getUpdatedSnapshot(): Promise<string> {
-    const device = await deviceManager.getDevice();
-    await new Promise((resolve) => setTimeout(resolve, 500));
-    const snapshot = await device.getSnapshot();
-    const nodeToRef = refRegistry.assignRefs(snapshot);
-    return formatSnapshot(snapshot, nodeToRef);
-  }
-
-  return {
-    devlens_open_url: async (params: { url: string }) => {
-      const device = await deviceManager.getDevice();
-      await device.openUrl(params.url);
-      onNavigate?.();
-
-      const snapshot = await getUpdatedSnapshot();
-      return {
-        content: [
-          {
-            type: "text" as const,
-            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" as const,
-            text: `Navigated back\n\n${snapshot}`,
-          },
-        ],
-      };
-    },
-  };
-}