react-native-ai-debugger 1.4.21 → 1.4.34

package/build/index.js

@@ -9,13 +9,13 @@ import { getGuideOverview, getGuideByTopic, getAvailableTopics } from "./core/gu
 import { getLicenseStatus, getDashboardUrl, getUsageInfo } from "./core/license.js";
 import { API_BASE_URL } from "./core/config.js";
 import { getPostHogClient, identifyIfDevMode, shutdownPostHog } from "./core/posthog.js";
-import { getInstallationId, getPackageName, getServerVersion, isDevMode, TELEMETRY_JSONL_PATH } from "./core/telemetry.js";
+import { getInstallationId, getServerVersion, getPackageName, isDevMode, TELEMETRY_JSONL_PATH, categorizeError } from "./core/telemetry.js";
 import { isSDKInstalled, querySDKNetwork, getSDKNetworkEntry, getSDKNetworkStats, clearSDKNetwork, querySDKConsole, getSDKConsoleStats, clearSDKConsole } from "./core/sdkBridge.js";
 import { tap } from "./pro/tap.js";
 import { getActivateLicenseConfig, handleActivateLicense, getDeleteAccountConfig, handleDeleteAccount, } from "./tools/accountTools.js";
 import { logBuffers, networkBuffers, getLogBuffer, getNetworkBuffer, getTotalLogCount, getConnectedAppByDevice, LogBuffer, NetworkBuffer, bundleErrorBuffer, imageBuffer, connectedApps, scanMetroPorts, fetchDevices, filterDebuggableDevices, connectToDevice, getConnectedApps, executeInApp, listDebugGlobals, inspectGlobal, reloadApp, 
 // React Component Inspection
-getComponentTree, getScreenLayout, inspectComponent, findComponents, inspectAtPoint, toggleElementInspector, isInspectorActive, getInspectorSelection, getFirstConnectedApp, getLogs, searchLogs, getLogSummary, getNetworkRequests, searchNetworkRequests, getNetworkStats, formatRequestDetails, 
+getComponentTree, getScreenLayout, getPressableElements, inspectComponent, findComponents, inspectAtPoint, toggleElementInspector, isInspectorActive, getInspectorSelection, getFirstConnectedApp, getLogs, searchLogs, getLogSummary, getNetworkRequests, searchNetworkRequests, getNetworkStats, formatRequestDetails, 
 // Connection state
 getAllConnectionStates, getAllConnectionMetadata, getRecentGaps, formatDuration, cancelAllReconnectionTimers, cancelReconnectionTimer, clearAllConnectionState, clearAllCDPMessageTimes, suppressReconnection, suppressReconnectionForKey, clearReconnectionSuppression, purgeStaleConnectionsForPorts, 
 // Context health tracking
@@ -38,8 +38,8 @@ androidDescribeAll, androidDescribePoint,
 androidFindElement, androidWaitForElement, 
 // iOS
 listIOSSimulators, iosScreenshot, iosInstallApp, iosLaunchApp, iosOpenUrl, iosTerminateApp, iosBootSimulator, 
-// iOS IDB-based UI tools
-iosTap, iosSwipe, iosInputText, iosButton, iosKeyEvent, iosKeySequence, iosDescribeAll, iosDescribePoint, IOS_BUTTON_TYPES, 
+// iOS UI driver tools
+isUiDriverAvailable, iosTap, iosSwipe, iosInputText, iosButton, iosKeyEvent, iosKeySequence, iosDescribeAll, iosDescribePoint, IOS_BUTTON_TYPES, 
 // iOS Element Finding (no screenshots)
 iosFindElement, iosWaitForElement, 
 // Telemetry
@@ -47,25 +47,7 @@ initTelemetry, trackToolInvocation, getTargetPlatform,
 // Format utilities (TONL)
 formatLogsAsTonl, formatNetworkAsTonl, 
 // LogBox detection & control
-detectLogBox, formatLogBoxWarning, dismissLogBox, formatDismissedEntries, pushLogBox, addLogBoxIgnorePatterns, verifyLogPipeline } from "./core/index.js";
-// Legacy package migration: notify once per session via LogBox
-const LEGACY_PACKAGE_NAME = "react-native-ai-debugger";
-let legacyMigrationNotified = false;
-async function notifyLegacyPackageMigration() {
-    if (legacyMigrationNotified)
-        return;
-    if (getPackageName() !== LEGACY_PACKAGE_NAME)
-        return;
-    legacyMigrationNotified = true;
-    try {
-        await pushLogBox("You are using the deprecated 'react-native-ai-debugger' package. " +
-            "Please update your MCP settings to use 'react-native-ai-devtools' instead. " +
-            "See: https://www.npmjs.com/package/react-native-ai-devtools", "warning", true);
-    }
-    catch {
-        // Best-effort — don't break the connection flow
-    }
-}
+detectLogBox, formatLogBoxWarning, dismissLogBox, formatDismissedEntries, pushLogBox, addLogBoxIgnorePatterns, verifyLogPipeline, formatIssueBody, buildGitHubUrl, shouldShowFeedbackHint, markFeedbackHintShown, } from "./core/index.js";
 // Helper: resolve log buffer for a device (or create a merged buffer from all devices)
 function resolveLogBuffer(device) {
     if (device) {
@@ -173,6 +155,27 @@ function estimateImageTokens(base64Data) {
         return Math.ceil(base64Data.length / 4); // fallback
     }
 }
+// Tools that do NOT require an active Metro connection — excluded from feedback hint trigger
+const NON_METRO_TOOLS = new Set([
+    "scan_metro",
+    "connect_metro",
+    "disconnect_metro",
+    "ensure_connection",
+    "get_connection_status",
+    "get_license_status",
+    "activate_license",
+    "delete_account",
+    "get_usage_guide",
+    "get_apps",
+    "list_ios_simulators",
+    "list_android_devices",
+    "ios_boot_simulator",
+    "ios_launch_app",
+    "android_launch_app",
+    "ios_install_app",
+    "android_install_app",
+    "send_feedback"
+]);
 // Registry for dev meta-tool — stores handlers and configs for dynamic dispatch
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const toolRegistry = new Map();
@@ -260,12 +263,20 @@ function registerToolWithTelemetry(toolName, config, handler, emptyResultDetecto
                     responsePreview = textParts.join("\n").substring(0, 2000);
                 }
             }
+            // First-install feedback hint — fires once on first successful Metro-connected tool
+            if (!NON_METRO_TOOLS.has(toolName) && shouldShowFeedbackHint()) {
+                markFeedbackHintShown();
+                // Fire-and-forget — don't block the tool response
+                pushLogBox("Congratulations on your first tool call! If you encounter any issues or have ideas for improvement, ask your AI assistant to call send_feedback. Your feedback helps me make this product better for everyone. Best regards, rn-ai-devtools developer.", "warning", true, "logbox").catch(() => {
+                    // Non-fatal — hint delivery failure should not affect tool execution
+                });
+            }
             return result;
         }
         catch (error) {
             success = false;
             errorMessage = error instanceof Error ? error.message : String(error);
-            getPostHogClient()?.captureException(error, getInstallationId(), { tool: toolName, server_version: getServerVersion() });
+            getPostHogClient()?.captureException(error, getInstallationId(), { tool: toolName, server_version: getServerVersion(), package_name: getPackageName() });
             throw error;
         }
         finally {
@@ -278,8 +289,16 @@ function registerToolWithTelemetry(toolName, config, handler, emptyResultDetecto
                     success,
                     duration,
                     server_version: getServerVersion(),
+                    package_name: getPackageName(),
                     ...(errorMessage && { error: errorMessage.substring(0, 200) }),
+                    ...(errorMessage && { error_category: categorizeError(errorMessage) }),
                     ...(getTargetPlatform() && { platform: getTargetPlatform() }),
+                    ...(tapStrategy && { tap_strategy: tapStrategy }),
+                    ...(meaningful !== undefined && { meaningful }),
+                    ...(changeRate !== undefined && { change_rate: changeRate }),
+                    ...(iosDriver && { ios_driver: iosDriver }),
+                    ...(emptyResult !== undefined && { empty_result: emptyResult }),
+                    ...(emptyReason && { empty_reason: emptyReason }),
                 },
             });
         }
@@ -424,6 +443,21 @@ registerToolWithTelemetry("scan_metro", {
             // Build events connection is optional
         }
     }
+    // Proactive check: warn if iOS UI driver is missing
+    const hasIosDevice = Array.from(allDeviceNames.values()).some(({ device }) => {
+        const title = (device.title || "").toLowerCase();
+        return title.includes("iphone") || title.includes("ipad") || title.includes("ios");
+    });
+    if (hasIosDevice) {
+        const uiDriverOk = await isUiDriverAvailable();
+        if (!uiDriverOk) {
+            results.push("");
+            results.push("⚠️  WARNING: iOS UI driver is NOT installed. Tools like tap, ios_swipe, ios_input_text, ios_describe_all, and ios_find_element will fail.");
+            results.push("   Install the recommended driver: brew install cameroncooke/axe/axe");
+            results.push("   Then set IOS_DRIVER=axe in your MCP server environment.");
+            results.push("   Alternative: brew install idb-companion (used by default)");
+        }
+    }
     return {
         content: [
             {
@@ -454,7 +488,14 @@ registerToolWithTelemetry("get_apps", {
         .map(({ app }, i) => {
         const name = app.deviceInfo.deviceName || app.deviceInfo.title;
         const appId = app.deviceInfo.appId || app.deviceInfo.title.split(" (")[0] || "unknown";
-        return `  ${i + 1}. ${name} — ${appId} (${app.platform}, port ${app.port})`;
+        const lines = [`  ${i + 1}. ${name} — ${appId} (${app.platform}, port ${app.port})`];
+        if (app.appDetection) {
+            const d = app.appDetection;
+            const version = d.reactNativeVersion !== "unknown" ? `RN ${d.reactNativeVersion}` : "RN unknown";
+            const expo = d.expoSdkVersion ? `, Expo SDK ${d.expoSdkVersion}` : "";
+            lines.push(`     Environment: ${version}, ${d.architecture} arch, ${d.jsEngine}, ${app.platform} ${d.osVersion}${expo}`);
+        }
+        return lines.join("\n");
     });
     const text = [
         `Connected devices:`,
@@ -595,6 +636,52 @@ registerToolWithTelemetry("get_license_status", {
         content: [{ type: "text", text: lines.join("\n") }],
     };
 });
+// Tool: Send feedback / bug report / feature request
+registerToolWithTelemetry("send_feedback", {
+    description: "Create a feedback report (bug, feature request, or general feedback) for the react-native-ai-devtools team. " +
+        "Auto-collects environment info. Returns a pre-filled GitHub issue URL and formatted issue body. " +
+        "Ask the user to open the URL and paste the body to submit.",
+    inputSchema: {
+        type: z.enum(["feedback", "feature_request", "bug"]).describe('Type of feedback: "feedback", "feature_request", or "bug"'),
+        title: z.string().describe("Short summary (becomes the GitHub issue title)"),
+        description: z.string().describe("Detailed description of the feedback, feature request, or bug"),
+        workflow_context: z.string().optional().describe("What the user was trying to accomplish when they decided to give feedback")
+    }
+}, async ({ type, title, description, workflow_context }) => {
+    // Collect environment info
+    const serverVersion = getServerVersion();
+    const platform = process.platform;
+    const deviceType = getTargetPlatform();
+    const licenseStatus = getLicenseStatus();
+    const env = {
+        serverVersion,
+        platform,
+        deviceType,
+        licenseTier: licenseStatus.tier
+    };
+    const input = { type, title, description, workflowContext: workflow_context };
+    const issueBody = formatIssueBody(input, env);
+    const githubUrl = buildGitHubUrl(title, type);
+    const output = [
+        "## Feedback Report Ready",
+        "",
+        `**GitHub Issue URL:** ${githubUrl}`,
+        "",
+        "**Issue body to paste:**",
+        "",
+        "```markdown",
+        issueBody,
+        "```",
+        "",
+        "Please ask the user to:",
+        "1. Open the GitHub URL above",
+        "2. Paste the issue body into the description field",
+        "3. Review and submit the issue"
+    ].join("\n");
+    return {
+        content: [{ type: "text", text: output }]
+    };
+});
 // Tool: Ensure connection health
 registerToolWithTelemetry("ensure_connection", {
     description: "Verify or establish a healthy connection to a React Native app. Use before running commands if connection may be stale, or after navigation/reload. This tool runs a health check and will auto-reconnect if needed.",
@@ -624,8 +711,6 @@ registerToolWithTelemetry("ensure_connection", {
             isError: true
         };
     }
-    // Notify legacy package users (fire-and-forget, once per session)
-    notifyLegacyPackageMigration();
     const lines = [];
     lines.push("=== Connection Ensured ===\n");
     if (result.connectionInfo) {
@@ -1372,6 +1457,34 @@ registerToolWithTelemetry("get_screen_layout", {
         ]
     };
 });
+// Tool: Get all pressable elements on screen
+registerToolWithTelemetry("get_pressable_elements", {
+    description: "Find all pressable (onPress) and input (TextInput) elements currently visible on screen. Returns component names, tap-ready center coordinates (in points/dp), text labels, testID, and accessibilityLabel. Useful when you need to tap an icon or button but can't identify it from a screenshot alone. Each element includes hasLabel (true if it contains text) and isInput (true for TextInput fields).",
+    inputSchema: {
+        device: z.string().optional().describe("Target device name (substring match). Omit for default device. Run get_apps to see connected devices.")
+    }
+}, async ({ device }) => {
+    const result = await getPressableElements({ device });
+    if (!result.success) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${result.error}`
+                }
+            ],
+            isError: true
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: result.result || "No pressable elements found."
+            }
+        ]
+    };
+});
 // Tool: Inspect a specific component by name
 registerToolWithTelemetry("inspect_component", {
     description: "Inspect a specific React component by name. **DRILL-DOWN TOOL**: Use after get_screen_layout or find_components to identify which component to inspect. Returns props, style, state (hooks), and optionally children tree. Use childrenDepth to control how deep nested children go.",
@@ -1485,12 +1598,13 @@ registerToolWithTelemetry("find_components", {
 registerToolWithTelemetry("tap", {
     description: "Tap a UI element. Automatically tries multiple strategies: fiber tree (React), accessibility tree (native), and OCR (visual). " +
         "Auto-detects platform (iOS/Android). For coordinates, pass raw pixel values from screenshot — tap handles all coordinate conversion internally (iOS pixel-to-point, scale factor adjustments).\n\n" +
+        "PREREQUISITE: For iOS, an iOS UI driver must be installed — AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion). Without it, accessibility and coordinate strategies will fail.\n\n" +
         "IMPORTANT: When both iOS and Android devices are connected, specify platform explicitly to avoid tapping on the wrong device.\n\n" +
         "Examples:\n" +
         "- tap(text=\"Submit\") — finds and taps element with matching text\n" +
         "- tap(testID=\"login-btn\") — finds by testID\n" +
         "- tap(component=\"HamburgerIcon\") — finds by React component name\n" +
-        "- tap(x=300, y=600) — taps at pixel coordinates (LAST RESORT — only use if text/testID/component strategies all fail)\n" +
+        "- tap(x=300, y=600) — taps at pixel coordinates; use coordinates from the pressable elements list returned by ios_screenshot/android_screenshot for reliable icon and ambiguous-element taps\n" +
         "- tap(text=\"Menu\", strategy=\"ocr\") — forces OCR strategy only\n" +
         "- tap(x=300, y=600, native=true, platform=\"android\") — taps directly via ADB/simctl without React Native connection\n\n" +
         "Returns a post-tap screenshot by default (set screenshot=false to disable). " +
@@ -2668,7 +2782,7 @@ registerToolWithTelemetry("list_android_devices", {
 });
 // Tool: Android screenshot
 registerToolWithTelemetry("android_screenshot", {
-    description: "Take a screenshot from an Android device/emulator. Returns the image and a screen layout overlay showing visible React components with names, text content, hierarchy, and tap-ready pixel coordinates. Use component names for inspect_component/find_components. Use tap(text=...) for interaction — only fall back to tap(x,y) coordinates from the layout if all tap strategies fail.",
+    description: "Take a screenshot from an Android device/emulator. Returns the image plus two lists: (1) pressable elements — the tappable components on screen with ready-to-use pixel tap coordinates, testIDs, and labels; (2) screen layout — all visible React components for context. Prefer tap(text=\"...\") when text is exact and unique; otherwise use tap(x, y) with coordinates from the pressables list — this is the most reliable way to tap icons or visually-identified elements. Use component names from the layout for inspect_component/find_components.",
     inputSchema: {
         outputPath: z
             .string()
@@ -2735,6 +2849,26 @@ registerToolWithTelemetry("android_screenshot", {
         catch {
             // Non-fatal: screenshot works without layout enrichment
         }
+        // Enrich with pressable elements (filtered list of tappable components, converted to screenshot pixel coords)
+        let pressablesText = null;
+        try {
+            const pressables = await getPressableElements({});
+            if (pressables.success && pressables.parsedElements && pressables.parsedElements.length > 0) {
+                const screenshotScale = result.scaleFactor || 1;
+                pressablesText = pressables.parsedElements.map((el) => {
+                    const px = Math.round((el.center.x * androidPixelRatio) / screenshotScale);
+                    const py = Math.round((el.center.y * androidPixelRatio) / screenshotScale);
+                    const label = el.accessibilityLabel || el.text || el.testID || el.component;
+                    const idPart = el.testID ? ` testID="${el.testID}"` : "";
+                    const kindPart = el.isInput ? " [input]" : "";
+                    const wrapPart = el.isWrapper ? " [wrapper — skip]" : "";
+                    return `  (${px}, ${py}) ${el.component}: "${label}"${idPart}${kindPart}${wrapPart}`;
+                }).join("\n");
+            }
+        }
+        catch {
+            // Non-fatal: screenshot works without pressables enrichment
+        }
         infoText += `\n📱 Android uses PIXELS for all coordinates`;
         if (result.scaleFactor && result.scaleFactor > 1) {
             infoText += `\n🖼️ Image was scaled down to fit API limits (scale: ${result.scaleFactor.toFixed(3)})`;
@@ -2745,14 +2879,20 @@ registerToolWithTelemetry("android_screenshot", {
         }
         infoText += `\n⚠️ Status bar: ${statusBarPixels}px (${statusBarDp}dp) from top - app content starts below this`;
         infoText += `\n📊 Display density: ${densityDpi}dpi`;
+        if (pressablesText) {
+            infoText += `\n\n🎯 Pressable elements (ready-to-tap, coordinates in screenshot pixels):`;
+            infoText += `\n${pressablesText}`;
+        }
         if (layoutText) {
-            infoText += `\n\n📋 Screen Layout (components with tap coordinates in pixels):`;
+            infoText += `\n\n📋 Screen Layout (all components, tap coordinates in pixels):`;
             infoText += `\n${layoutText}`;
+        }
+        if (pressablesText || layoutText) {
             infoText += `\n\n💡 Next steps:`;
-            infoText += `\n  • tap(text="Button Label") — tap element by visible text (preferred)`;
-            infoText += `\n  • tap(testID="id") or tap(component="Name") — tap by testID or component name`;
-            infoText += `\n  • tap(x=<px>, y=<px>) — use tap coordinates from layout above ONLY if text/testID/component tap fails`;
-            infoText += `\n  • inspect_component("ComponentName") — inspect a component from the layout above`;
+            infoText += `\n  • tap(text="Button Label") — when text is exact and unique`;
+            infoText += `\n  • tap(testID="id") or tap(component="Name") — when you know the identifier`;
+            infoText += `\n  • tap(x=<px>, y=<px>) — use coordinates from the pressable elements list above (reliable for icons and ambiguous elements)`;
+            infoText += `\n  • inspect_component("ComponentName") — inspect a component from the layout`;
         }
         else {
             infoText += `\n\n💡 Next steps:`;
@@ -3230,7 +3370,7 @@ registerToolWithTelemetry("list_ios_simulators", {
 });
 // Tool: iOS screenshot
 registerToolWithTelemetry("ios_screenshot", {
-    description: "Take a screenshot from an iOS simulator. Returns the image and a screen layout overlay showing visible React components with names, text content, hierarchy, and tap-ready pixel coordinates. Use component names for inspect_component/find_components. Use tap(text=...) for interaction — only fall back to tap(x,y) coordinates from the layout if all tap strategies fail.",
+    description: "Take a screenshot from an iOS simulator. Returns the image plus two lists: (1) pressable elements — the tappable components on screen with ready-to-use pixel tap coordinates, testIDs, and labels; (2) screen layout — all visible React components for context. Prefer tap(text=\"...\") when text is exact and unique; otherwise use tap(x, y) with coordinates from the pressables list — this is the most reliable way to tap icons or visually-identified elements. Use component names from the layout for inspect_component/find_components.",
     inputSchema: {
         outputPath: z
             .string()
@@ -3322,6 +3462,26 @@ registerToolWithTelemetry("ios_screenshot", {
         catch {
             // Non-fatal: screenshot works without layout enrichment
         }
+        // Enrich with pressable elements (filtered list of tappable components, converted to screenshot pixel coords)
+        let pressablesText = null;
+        try {
+            const pressables = await getPressableElements({});
+            if (pressables.success && pressables.parsedElements && pressables.parsedElements.length > 0) {
+                const screenshotScale = result.scaleFactor || 1;
+                pressablesText = pressables.parsedElements.map((el) => {
+                    const px = Math.round((el.center.x * scaleFactor) / screenshotScale);
+                    const py = Math.round((el.center.y * scaleFactor) / screenshotScale);
+                    const label = el.accessibilityLabel || el.text || el.testID || el.component;
+                    const idPart = el.testID ? ` testID="${el.testID}"` : "";
+                    const kindPart = el.isInput ? " [input]" : "";
+                    const wrapPart = el.isWrapper ? " [wrapper — skip]" : "";
+                    return `  (${px}, ${py}) ${el.component}: "${label}"${idPart}${kindPart}${wrapPart}`;
+                }).join("\n");
+            }
+        }
+        catch {
+            // Non-fatal: screenshot works without pressables enrichment
+        }
         let infoText = `Screenshot captured (${pixelWidth}x${pixelHeight} pixels)`;
         infoText += `\n📱 iOS screen: ${pointWidth}x${pointHeight} points (${scaleFactor}x scale)`;
         infoText += `\n📐 tap() handles pixel-to-point conversion automatically — pass pixel coords from this image directly`;
@@ -3329,14 +3489,20 @@ registerToolWithTelemetry("ios_screenshot", {
         if (result.scaleFactor && result.scaleFactor > 1) {
             infoText += `\n🖼️ Image was scaled down to fit API limits (scale: ${result.scaleFactor.toFixed(3)})`;
         }
+        if (pressablesText) {
+            infoText += `\n\n🎯 Pressable elements (ready-to-tap, coordinates in screenshot pixels):`;
+            infoText += `\n${pressablesText}`;
+        }
         if (layoutText) {
-            infoText += `\n\n📋 Screen Layout (components with tap coordinates in pixels):`;
+            infoText += `\n\n📋 Screen Layout (all components, tap coordinates in pixels):`;
             infoText += `\n${layoutText}`;
+        }
+        if (pressablesText || layoutText) {
             infoText += `\n\n💡 Next steps:`;
-            infoText += `\n  • tap(text="Button Label") — tap element by visible text (preferred)`;
-            infoText += `\n  • tap(testID="id") or tap(component="Name") — tap by testID or component name`;
-            infoText += `\n  • tap(x=<px>, y=<px>) — use tap coordinates from layout above ONLY if text/testID/component tap fails`;
-            infoText += `\n  • inspect_component("ComponentName") — inspect a component from the layout above`;
+            infoText += `\n  • tap(text="Button Label") — when text is exact and unique`;
+            infoText += `\n  • tap(testID="id") or tap(component="Name") — when you know the identifier`;
+            infoText += `\n  • tap(x=<px>, y=<px>) — use coordinates from the pressable elements list above (reliable for icons and ambiguous elements)`;
+            infoText += `\n  • inspect_component("ComponentName") — inspect a component from the layout`;
         }
         else {
             infoText += `\n\n💡 Next steps:`;
@@ -3604,12 +3770,13 @@ registerToolWithTelemetry("ios_boot_simulator", {
     };
 });
 // ============================================================================
-// iOS IDB-Based UI Tools (require Facebook IDB)
-// Install with: brew install idb-companion
+// iOS UI Interaction Tools (require an iOS UI driver)
+// Recommended: AXe — brew install cameroncooke/axe/axe (set IOS_DRIVER=axe)
+// Alternative: IDB — brew install idb-companion (default)
 // ============================================================================
 // Tool: iOS swipe
 server.registerTool("ios_swipe", {
-    description: "Swipe gesture on an iOS simulator screen. Requires IDB to be installed (brew install idb-companion).",
+    description: "Swipe gesture on an iOS simulator screen. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion).",
     inputSchema: {
         startX: z.coerce.number().describe("Starting X coordinate in pixels"),
         startY: z.coerce.number().describe("Starting Y coordinate in pixels"),
@@ -3633,7 +3800,7 @@ server.registerTool("ios_swipe", {
 });
 // Tool: iOS input text
 server.registerTool("ios_input_text", {
-    description: "Type text into the active input field on an iOS simulator. Requires IDB to be installed (brew install idb-companion).",
+    description: "Type text into the active input field on an iOS simulator. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion).",
     inputSchema: {
         text: z.string().describe("Text to type into the active input field"),
         udid: z.string().optional().describe("Optional simulator UDID. Uses booted simulator if not specified.")
@@ -3652,7 +3819,7 @@ server.registerTool("ios_input_text", {
 });
 // Tool: iOS button
 server.registerTool("ios_button", {
-    description: "Press a hardware button on an iOS simulator. Requires IDB to be installed (brew install idb-companion).",
+    description: "Press a hardware button on an iOS simulator. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion).",
     inputSchema: {
         button: z
             .enum(IOS_BUTTON_TYPES)
@@ -3674,7 +3841,7 @@ server.registerTool("ios_button", {
 });
 // Tool: iOS key event
 server.registerTool("ios_key_event", {
-    description: "Send a key event to an iOS simulator by keycode. Requires IDB to be installed (brew install idb-companion).",
+    description: "Send a key event to an iOS simulator by keycode. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion).",
     inputSchema: {
         keycode: z.coerce.number().describe("iOS keycode to send"),
         duration: z.coerce.number().optional().describe("Optional key press duration in seconds"),
@@ -3694,7 +3861,7 @@ server.registerTool("ios_key_event", {
 });
 // Tool: iOS key sequence
 server.registerTool("ios_key_sequence", {
-    description: "Send a sequence of key events to an iOS simulator. Requires IDB to be installed (brew install idb-companion).",
+    description: "Send a sequence of key events to an iOS simulator. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion).",
     inputSchema: {
         keycodes: z.array(z.coerce.number()).describe("Array of iOS keycodes to send in sequence"),
         udid: z.string().optional().describe("Optional simulator UDID. Uses booted simulator if not specified.")
@@ -3713,7 +3880,7 @@ server.registerTool("ios_key_sequence", {
 });
 // Tool: iOS describe all (accessibility tree)
 server.registerTool("ios_describe_all", {
-    description: "Get accessibility information for the entire iOS simulator screen. Returns a nested tree of UI elements with labels, values, and frames. Requires IDB to be installed (brew install idb-companion).",
+    description: "Get accessibility information for the entire iOS simulator screen. Returns a nested tree of UI elements with labels, values, and frames. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion).",
     inputSchema: {
         udid: z.string().optional().describe("Optional simulator UDID. Uses booted simulator if not specified.")
     }
@@ -3744,7 +3911,7 @@ server.registerTool("ios_describe_all", {
 });
 // Tool: iOS describe point
 server.registerTool("ios_describe_point", {
-    description: "Get accessibility information for the UI element at a specific point on the iOS simulator screen. Requires IDB to be installed (brew install idb-companion).",
+    description: "Get accessibility information for the UI element at a specific point on the iOS simulator screen. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion).",
     inputSchema: {
         x: z.coerce.number().describe("X coordinate in pixels"),
         y: z.coerce.number().describe("Y coordinate in pixels"),
@@ -3764,7 +3931,7 @@ server.registerTool("ios_describe_point", {
 });
 // Tool: iOS find element (no screenshot needed)
 server.registerTool("ios_find_element", {
-    description: "Find a UI element on iOS simulator by accessibility label or value. Returns element details including tap coordinates. Requires IDB (brew install idb-companion). Workflow: 1) wait_for_element, 2) find_element, 3) tap with returned coordinates. Prefer this over screenshots for button taps.",
+    description: "Find a UI element on iOS simulator by accessibility label or value. Returns element details including tap coordinates. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion). Workflow: 1) wait_for_element, 2) find_element, 3) tap with returned coordinates. Prefer this over screenshots for button taps.",
     inputSchema: {
         label: z.string().optional().describe("Exact accessibility label match"),
         labelContains: z.string().optional().describe("Partial label match (case-insensitive)"),
@@ -3811,7 +3978,7 @@ server.registerTool("ios_find_element", {
 });
 // Tool: iOS wait for element
 server.registerTool("ios_wait_for_element", {
-    description: "Wait for a UI element to appear on iOS simulator. Polls until found or timeout. Requires IDB (brew install idb-companion). Use this FIRST after navigation to ensure screen is ready, then use find_element + tap.",
+    description: "Wait for a UI element to appear on iOS simulator. Polls until found or timeout. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion). Use this FIRST after navigation to ensure screen is ready, then use find_element + tap.",
     inputSchema: {
         label: z.string().optional().describe("Exact accessibility label match"),
         labelContains: z.string().optional().describe("Partial label match (case-insensitive)"),
@@ -3966,18 +4133,18 @@ async function main() {
             res.end("Not found");
         });
         httpServer.listen(httpPort, () => {
-            console.error(`[rn-ai-devtools] MCP HTTP server listening on http://localhost:${httpPort}/mcp`);
+            console.error(`[rn-ai-debugger] MCP HTTP server listening on http://localhost:${httpPort}/mcp`);
         });
     }
     else {
         // Stdio transport mode — default for production
         const transport = new StdioServerTransport();
         await server.connect(transport);
-        console.error("[rn-ai-devtools] Server started on stdio");
+        console.error("[rn-ai-debugger] Server started on stdio");
     }
 }
 main().catch((error) => {
-    console.error("[rn-ai-devtools] Fatal error:", error);
+    console.error("[rn-ai-debugger] Fatal error:", error);
     process.exit(1);
 });
 // Graceful shutdown: close CDP connections so the slot is freed for other sessions