react-native-ai-debugger 1.6.16 → 1.8.1

package/build/core/componentTree.js

@@ -0,0 +1,275 @@
+import { executeInApp } from "./jsExecute.js";
+function formatTreeToTonl(node, indent = 0) {
+    const prefix = "  ".repeat(indent);
+    let result = `${prefix}${node.component}`;
+    // Add props inline if present
+    if (node.props && Object.keys(node.props).length > 0) {
+        const propsStr = Object.entries(node.props)
+            .map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`)
+            .join(",");
+        result += ` (${propsStr})`;
+    }
+    // Add layout inline if present
+    if (node.layout && Object.keys(node.layout).length > 0) {
+        const layoutStr = Object.entries(node.layout)
+            .map(([k, v]) => `${k}:${v}`)
+            .join(",");
+        result += ` [${layoutStr}]`;
+    }
+    result += "\n";
+    // Recurse children
+    if (node.children && node.children.length > 0) {
+        for (const child of node.children) {
+            result += formatTreeToTonl(child, indent + 1);
+        }
+    }
+    return result;
+}
+// Ultra-compact structure-only tree format (just component names, indented)
+function formatTreeStructureOnly(node, indent = 0) {
+    const prefix = "  ".repeat(indent);
+    let result = `${prefix}${node.component}\n`;
+    if (node.children && node.children.length > 0) {
+        for (const child of node.children) {
+            result += formatTreeStructureOnly(child, indent + 1);
+        }
+    }
+    return result;
+}
+export async function getComponentTree(options = {}) {
+    const { includeProps = false, includeStyles = false, hideInternals = true, format = "tonl", structureOnly = false, focusedOnly = false, device } = options;
+    // Use lower default depth for structureOnly to keep output compact (~2-5KB)
+    // Full mode uses higher depth since TONL format handles it better
+    // focusedOnly mode uses moderate depth since we're already filtering to active screen
+    const maxDepth = options.maxDepth ?? 5000;
+    const expression = `
+        (function() {
+            const hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+            if (!hook) return { error: 'React DevTools hook not found. Make sure you are running a development build.' };
+
+            // Try to get fiber roots (renderer ID is usually 1)
+            let roots = [];
+            if (hook.getFiberRoots) {
+                roots = [...(hook.getFiberRoots(1) || [])];
+            }
+            if (roots.length === 0 && hook.renderers) {
+                // Try all renderers
+                for (const [id] of hook.renderers) {
+                    const r = hook.getFiberRoots ? [...(hook.getFiberRoots(id) || [])] : [];
+                    if (r.length > 0) {
+                        roots = r;
+                        break;
+                    }
+                }
+            }
+            if (roots.length === 0) return { error: 'No fiber roots found. The app may not have rendered yet.' };
+
+            const maxDepth = ${maxDepth};
+            const includeProps = ${includeProps};
+            const includeStyles = ${includeStyles};
+            const hideInternals = ${hideInternals};
+            const focusedOnly = ${focusedOnly};
+
+            // Internal RN components to hide
+            const internalPatterns = /^(RCT|RNS|Animated\\(|AnimatedComponent|VirtualizedList|CellRenderer|ScrollViewContext|PerformanceLoggerContext|RootTagContext|HeaderShownContext|HeaderHeightContext|HeaderBackContext|SafeAreaFrameContext|SafeAreaInsetsContext|VirtualizedListContext|VirtualizedListCellContextProvider|StaticContainer|DelayedFreeze|Freeze|Suspender|DebugContainer|MaybeNestedStack|SceneView|NavigationContent|PreventRemoveProvider|EnsureSingleNavigator)/;
+
+            // Screen component patterns - user's actual screens (strict matching)
+            // Only match *Screen and *Page to avoid false positives like BottomTabView
+            const screenPatterns = /^[A-Z][a-zA-Z0-9]*(Screen|Page)$/;
+
+            // Navigation/internal screen patterns to SKIP (these look like screens but are framework components)
+            const internalScreenPatterns = /^(MaybeScreen|Screen$|ScreenContainer|ScreenStack|SceneView|Background$)/;
+
+            // Provider/wrapper patterns to skip when finding focused screen
+            const wrapperPatterns = /^(App|AppContainer|Provider|Context|SafeArea|Gesture|Theme|Redux|Root|Navigator|Stack|Tab|Drawer|Navigation|Container|Wrapper|Layout|ErrorBoundary|Suspense|PersistGate|LinkingContext|AppState|View|Fragment|NativeStack|BottomTab|Screen$)/i;
+
+            // Global overlay patterns - stop traversing into these subtrees
+            // Be specific to avoid blocking BottomSheetDrawer, PortalProvider, etc.
+            const overlayPatterns = /^(BottomSheet$|BottomSheetGlobal|Modal$|Toast$|Snackbar$|Dialog$|Overlay$|Popup$|MyToast$|PaywallModal$|FullScreenBannerModal$)/i;
+
+            // Navigation container patterns - skip traversing into these (screens inside are nav screens, not focused content)
+            const navContainerPatterns = /^(RootNavigation|NativeStackNavigator|BottomTabNavigator|DrawerNavigator|TabNavigator|StackNavigator)/;
+
+            function getComponentName(fiber) {
+                if (!fiber || !fiber.type) return null;
+                if (typeof fiber.type === 'string') return fiber.type; // Host component (View, Text, etc.)
+                return fiber.type.displayName || fiber.type.name || null;
+            }
+
+            function shouldHide(name) {
+                if (!hideInternals || !name) return false;
+                return internalPatterns.test(name);
+            }
+
+            function extractLayoutStyles(style) {
+                try {
+                    if (!style) return null;
+                    const merged = Array.isArray(style)
+                        ? Object.assign({}, ...style.filter(Boolean).map(s => {
+                            try { return typeof s === 'object' ? s : {}; }
+                            catch { return {}; }
+                        }))
+                        : (typeof style === 'object' ? style : {});
+
+                    const layout = {};
+                    const layoutKeys = [
+                        'padding', 'paddingTop', 'paddingBottom', 'paddingLeft', 'paddingRight',
+                        'paddingHorizontal', 'paddingVertical',
+                        'margin', 'marginTop', 'marginBottom', 'marginLeft', 'marginRight',
+                        'marginHorizontal', 'marginVertical',
+                        'width', 'height', 'minWidth', 'minHeight', 'maxWidth', 'maxHeight',
+                        'flex', 'flexDirection', 'flexWrap', 'flexGrow', 'flexShrink',
+                        'justifyContent', 'alignItems', 'alignSelf', 'alignContent',
+                        'position', 'top', 'bottom', 'left', 'right',
+                        'gap', 'rowGap', 'columnGap',
+                        'borderWidth', 'borderTopWidth', 'borderBottomWidth', 'borderLeftWidth', 'borderRightWidth'
+                    ];
+
+                    for (const key of layoutKeys) {
+                        if (merged[key] !== undefined) layout[key] = merged[key];
+                    }
+                    return Object.keys(layout).length > 0 ? layout : null;
+                } catch { return null; }
+            }
+
+            function walkFiber(fiber, depth) {
+                if (!fiber || depth > maxDepth) return null;
+
+                const name = getComponentName(fiber);
+
+                // Skip anonymous/internal components unless they have meaningful children
+                if (!name || shouldHide(name)) {
+                    // Still traverse children
+                    let child = fiber.child;
+                    const children = [];
+                    while (child) {
+                        const childResult = walkFiber(child, depth);
+                        if (childResult) children.push(childResult);
+                        child = child.sibling;
+                    }
+                    // Return first meaningful child or null
+                    return children.length === 1 ? children[0] : (children.length > 1 ? { component: '(Fragment)', children } : null);
+                }
+
+                const node = { component: name };
+
+                // Include props if requested (excluding children and style for cleaner output)
+                if (includeProps && fiber.memoizedProps) {
+                    const props = {};
+                    for (const key of Object.keys(fiber.memoizedProps)) {
+                        if (key === 'children' || key === 'style') continue;
+                        try {
+                            const val = fiber.memoizedProps[key];
+                            if (typeof val === 'function') {
+                                props[key] = '[Function]';
+                            } else if (typeof val === 'object' && val !== null) {
+                                props[key] = Array.isArray(val) ? '[Array]' : '[Object]';
+                            } else {
+                                props[key] = val;
+                            }
+                        } catch {
+                            props[key] = '[Animated Value]';
+                        }
+                    }
+                    if (Object.keys(props).length > 0) node.props = props;
+                }
+
+                // Include layout styles if requested
+                try {
+                    if (includeStyles && fiber.memoizedProps?.style) {
+                        const layout = extractLayoutStyles(fiber.memoizedProps.style);
+                        if (layout) node.layout = layout;
+                    }
+                } catch { /* animated style — skip */ }
+
+                // Traverse children
+                let child = fiber.child;
+                const children = [];
+                while (child) {
+                    const childResult = walkFiber(child, depth + 1);
+                    if (childResult) children.push(childResult);
+                    child = child.sibling;
+                }
+                if (children.length > 0) node.children = children;
+
+                return node;
+            }
+
+            // Find focused screen if requested
+            function findFocusedScreen(fiber, depth = 0) {
+                if (!fiber || depth > 5000) return null;
+
+                const name = getComponentName(fiber);
+
+                // Skip overlays (BottomSheet, Modal, Toast, etc.) - don't traverse into them
+                if (name && overlayPatterns.test(name)) {
+                    return null;
+                }
+
+                // Skip navigation containers - screens inside are nav screens, not focused content
+                if (name && navContainerPatterns.test(name)) {
+                    return null;
+                }
+
+                // Check if this is a user's screen component (not framework internals)
+                if (name && screenPatterns.test(name) && !wrapperPatterns.test(name) && !internalScreenPatterns.test(name)) {
+                    return fiber;
+                }
+
+                // Search children
+                let child = fiber.child;
+                while (child) {
+                    const found = findFocusedScreen(child, depth + 1);
+                    if (found) return found;
+                    child = child.sibling;
+                }
+
+                return null;
+            }
+
+            let startFiber = roots[0].current;
+            let focusedScreenName = null;
+
+            if (focusedOnly) {
+                const focused = findFocusedScreen(roots[0].current);
+                if (focused) {
+                    startFiber = focused;
+                    focusedScreenName = getComponentName(focused);
+                }
+            }
+
+            const tree = walkFiber(startFiber, 0);
+
+            if (focusedOnly && focusedScreenName) {
+                return { focusedScreen: focusedScreenName, tree };
+            }
+            return { tree };
+        })()
+    `;
+    // Use a longer timeout for component tree traversal — large apps can exceed 10s
+    const result = await executeInApp(expression, false, { timeoutMs: 30000 }, device);
+    // Apply formatting if requested
+    if (result.success && result.result) {
+        try {
+            const parsed = JSON.parse(result.result);
+            if (parsed.tree) {
+                const prefix = parsed.focusedScreen ? `Focused: ${parsed.focusedScreen}\n\n` : "";
+                // Structure-only mode: ultra-compact format with just component names
+                if (structureOnly) {
+                    const structure = formatTreeStructureOnly(parsed.tree);
+                    return { success: true, result: prefix + structure };
+                }
+                // TONL format: compact with props/layout
+                if (format === "tonl") {
+                    const tonl = formatTreeToTonl(parsed.tree);
+                    return { success: true, result: prefix + tonl };
+                }
+            }
+        }
+        catch {
+            // If parsing fails, return original result
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=componentTree.js.map

package/build/core/componentTree.js.map

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

package/build/core/connection.d.ts

@@ -23,6 +23,7 @@ export declare function clearReconnectionSuppression(): void;
  * Tries with Origin first, falls back to without on quick failure.
  */
 export declare function createWebSocketWithOriginFallback(url: string, timeoutMs?: number): Promise<WebSocket>;
+export declare function getWebSocketStateName(state: number): string;
 /**
  * Purge stale connections for scanned ports.
  * When Metro restarts with a different app, /json returns new device IDs.

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

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

package/build/core/connection.js

@@ -5,6 +5,7 @@ import { injectNetworkInterceptor, sendNetworkEnable, isInterceptorEvent, applyI
 import { findSimulatorByName } from "./ios.js";
 import { fetchDevices, selectMainDevice, scanMetroPorts } from "./metro.js";
 import { probeCdpAlive } from "./probe.js";
+import { UserInputError } from "./errors.js";
 import { scheduleAppDetection } from "./appDetection.js";
 import { DEFAULT_RECONNECTION_CONFIG, MIN_STABLE_CONNECTION_MS, initConnectionState, updateConnectionState, getConnectionState, recordConnectionGap, closeConnectionGap, saveConnectionMetadata, clearConnectionMetadata, getConnectionMetadata, saveReconnectionTimer, cancelReconnectionTimer, calculateBackoffDelay, initContextHealth, markContextHealthy, markContextStale, getContextHealth, updateContextHealth, formatDuration, } from "./connectionState.js";
 // Connection locks to prevent concurrent connection attempts to the same device
@@ -166,7 +167,7 @@ function findAppKeyForDevice(device) {
     return null;
 }
 // Helper to convert WebSocket readyState to readable name
-function getWebSocketStateName(state) {
+export function getWebSocketStateName(state) {
     switch (state) {
         case WebSocket.CONNECTING: return "CONNECTING";
         case WebSocket.OPEN: return "OPEN";
@@ -1129,10 +1130,13 @@ export function getConnectedAppByDevice(device) {
     }
     if (matches.length > 1) {
         const names = matches.map(a => a.deviceInfo.deviceName || a.deviceInfo.title).join(", ");
-        throw new Error(`Multiple devices match "${device}": ${names}. Be more specific (use the full device name for an exact match).`);
+        throw new UserInputError(`Multiple devices match "${device}": ${names}. Be more specific (use the full device name for an exact match).`);
     }
-    const available = allOpenNames.length > 0 ? ` Available: ${allOpenNames.join(", ")}.` : "";
-    throw new Error(`No connected device matches "${device}".${available} Run get_apps to see available devices.`);
+    if (allOpenNames.length === 0) {
+        throw new UserInputError(`No connected device matches "${device}". No devices are currently connected — run scan_metro to discover and connect to Metro servers.`);
+    }
+    const quoted = allOpenNames.map(n => `"${n}"`).join(", ");
+    throw new UserInputError(`No connected device matches "${device}". Connected devices: ${quoted}. Retry with one of these names (substring match, case-insensitive).`);
 }
 // Check if any app is connected with an OPEN WebSocket
 export function hasConnectedApp() {
@@ -1308,30 +1312,32 @@ async function findFirstMetroPort() {
  */
 export async function ensureConnection(options = {}) {
     const { port, healthCheck = true, forceRefresh = false } = options;
-    let app = getFirstConnectedApp();
     let wasReconnected = false;
-    // Force refresh if requested - close existing connection
-    if (forceRefresh && app) {
-        const appKey = `${app.port}-${app.deviceInfo.id}`;
-        cancelReconnectionTimer(appKey);
-        try {
-            app.ws.close();
-        }
-        catch {
-            // Ignore close errors
+    // forceRefresh: close every currently-connected app, then fall through to
+    // single-device fresh connect. Full multi-device re-discovery is scan_metro's
+    // job — ensureConnection only fresh-connects one when nothing is open.
+    if (forceRefresh) {
+        for (const { key, app } of getConnectedApps()) {
+            cancelReconnectionTimer(key);
+            try {
+                app.ws.close();
+            }
+            catch { /* ignore */ }
+            connectedApps.delete(key);
         }
-        connectedApps.delete(appKey);
-        app = null;
     }
-    // Attempt connection if not connected
-    if (!app) {
+    let openApps = getConnectedApps()
+        .filter(a => a.isConnected)
+        .map(a => a.app);
+    // Nothing connected — establish a single-device connection from scratch.
+    if (openApps.length === 0) {
         const targetPort = port ?? await findFirstMetroPort();
         if (!targetPort) {
             return {
                 connected: false,
                 wasReconnected: false,
                 healthCheckPassed: false,
-                connectionInfo: null,
+                connectionInfos: [],
                 error: "No Metro server found. Make sure Metro bundler is running.",
             };
         }
@@ -1342,7 +1348,7 @@ export async function ensureConnection(options = {}) {
                 connected: false,
                 wasReconnected: false,
                 healthCheckPassed: false,
-                connectionInfo: null,
+                connectionInfos: [],
                 error: `No debuggable devices found on port ${targetPort}. Make sure the app is running.`,
             };
         }
@@ -1354,32 +1360,23 @@ export async function ensureConnection(options = {}) {
             clearReconnectionSuppression();
             const connectResult = await connectToDevice(mainDevice, targetPort);
             wasReconnected = true;
-            // connectToDevice resolves with a status string for non-throw
-            // outcomes including "Skipped X (stale CDP target …)". Surface
-            // that explicitly instead of falling through to the generic
-            // "Connection succeeded but app is not available" below.
             if (connectResult.includes("stale CDP target")) {
                 return {
                     connected: false,
                     wasReconnected: false,
                     healthCheckPassed: false,
-                    connectionInfo: null,
+                    connectionInfos: [],
                     error: `${connectResult}. The CDP page advertised by Metro is no longer responsive — restart the React Native app, then retry.`,
                 };
             }
-            // Race window: connectToDevice may resolve with the WS open and
-            // connectedApps populated, but Metro can immediately close the
-            // socket (single-connection limit, transient hiccup). The close
-            // handler then deletes the entry and getFirstConnectedApp returns
-            // null. Settle briefly and retry a few times before giving up.
-            app = getFirstConnectedApp();
-            for (let i = 0; !app && i < 5; i++) {
-                await new Promise(resolve => setTimeout(resolve, 100));
-                app = getFirstConnectedApp();
+            // Race window: settle briefly and retry getting the open app list.
+            for (let i = 0; i < 5 && openApps.length === 0; i++) {
+                if (i > 0)
+                    await new Promise(resolve => setTimeout(resolve, 100));
+                openApps = getConnectedApps().filter(a => a.isConnected).map(a => a.app);
             }
         }
         catch (error) {
-            // Ensure we always have a meaningful error message
             let errorMessage;
             if (error instanceof Error) {
                 errorMessage = error.message;
@@ -1394,82 +1391,95 @@ export async function ensureConnection(options = {}) {
                 connected: false,
                 wasReconnected: false,
                 healthCheckPassed: false,
-                connectionInfo: null,
+                connectionInfos: [],
                 error: `Connection failed: ${errorMessage}`,
             };
         }
     }
-    if (!app) {
+    if (openApps.length === 0) {
         return {
             connected: false,
             wasReconnected: false,
             healthCheckPassed: false,
-            connectionInfo: null,
+            connectionInfos: [],
             error: "Connection succeeded but app is not available",
         };
     }
-    // Run health check if requested
-    let healthCheckPassed = true;
-    if (healthCheck) {
-        healthCheckPassed = await runQuickHealthCheck(app);
-        // If health check failed and we haven't just reconnected, try reconnecting
-        if (!healthCheckPassed && !wasReconnected) {
-            console.error(`[execbro] Health check failed, attempting reconnection...`);
-            // Close and reconnect
-            const appKey = `${app.port}-${app.deviceInfo.id}`;
-            const targetPort = app.port;
-            cancelReconnectionTimer(appKey);
-            try {
-                app.ws.close();
-            }
-            catch {
-                // Ignore
-            }
-            connectedApps.delete(appKey);
-            // Re-fetch devices and reconnect
-            const devices = await fetchDevices(targetPort);
-            const mainDevice = selectMainDevice(devices);
-            if (mainDevice) {
+    // Per-device health-check; reconnect failed devices individually so a dead
+    // Android doesn't take down a healthy iOS report and vice versa.
+    const perApp = [];
+    for (const candidate of openApps) {
+        let app = candidate;
+        let healthy = true;
+        if (healthCheck) {
+            healthy = await runQuickHealthCheck(app);
+            if (!healthy && !wasReconnected) {
+                const failedTitle = app.deviceInfo.title;
+                console.error(`[execbro] Health check failed for ${failedTitle}, attempting reconnection...`);
+                const appKey = `${app.port}-${app.deviceInfo.id}`;
+                const appPort = app.port;
+                cancelReconnectionTimer(appKey);
                 try {
-                    await connectToDevice(mainDevice, targetPort);
-                    app = getFirstConnectedApp();
-                    wasReconnected = true;
-                    // Re-run health check after reconnection
-                    if (app) {
-                        healthCheckPassed = await runQuickHealthCheck(app);
+                    app.ws.close();
+                }
+                catch { /* ignore */ }
+                connectedApps.delete(appKey);
+                const devices = await fetchDevices(appPort);
+                const mainDevice = selectMainDevice(devices);
+                if (mainDevice) {
+                    try {
+                        await connectToDevice(mainDevice, appPort);
+                        wasReconnected = true;
+                        const fresh = getConnectedApps()
+                            .filter(a => a.isConnected)
+                            .map(a => a.app);
+                        const replacement = fresh.find(a => a.deviceInfo.id === mainDevice.id);
+                        if (replacement) {
+                            app = replacement;
+                            healthy = await runQuickHealthCheck(app);
+                        }
+                        else {
+                            healthy = false;
+                        }
+                    }
+                    catch {
+                        healthy = false;
                     }
                 }
-                catch {
-                    // Failed to reconnect
-                    healthCheckPassed = false;
+                else {
+                    healthy = false;
                 }
             }
         }
+        perApp.push({ app, healthy });
     }
-    // Build connection info
-    const appKey = app ? `${app.port}-${app.deviceInfo.id}` : null;
-    const connectionState = appKey ? getConnectionState(appKey) : null;
-    const contextHealth = appKey ? getContextHealth(appKey) : null;
-    let uptime = "unknown";
-    if (connectionState?.lastConnectedTime) {
-        const uptimeMs = Date.now() - connectionState.lastConnectedTime.getTime();
-        uptime = formatDuration(uptimeMs);
-    }
-    const isConnected = app !== null && app.ws.readyState === WebSocket.OPEN;
-    return {
-        connected: isConnected,
-        wasReconnected,
-        healthCheckPassed,
-        connectionInfo: app ? {
+    const connectionInfos = perApp.map(({ app, healthy }) => {
+        const appKey = `${app.port}-${app.deviceInfo.id}`;
+        const connectionState = getConnectionState(appKey);
+        const contextHealth = getContextHealth(appKey);
+        let uptime = "unknown";
+        if (connectionState?.lastConnectedTime) {
+            uptime = formatDuration(Date.now() - connectionState.lastConnectedTime.getTime());
+        }
+        return {
+            deviceName: app.deviceInfo.deviceName || app.deviceInfo.title,
             deviceTitle: app.deviceInfo.title,
+            platform: app.platform,
             port: app.port,
             uptime,
             contextId: contextHealth?.contextId ?? null,
-        } : null,
-        ...(!isConnected && {
-            error: app
-                ? `Connection lost: WebSocket is in ${["CONNECTING", "OPEN", "CLOSING", "CLOSED"][app.ws.readyState] || "unknown"} state (expected OPEN). Health check ${healthCheckPassed ? "passed" : "failed"}. Try ensure_connection with forceRefresh=true.`
-                : "App became unavailable after reconnection attempt. Try running scan_metro then ensure_connection."
+            healthCheckPassed: healthy,
+        };
+    });
+    const anyOpen = perApp.some(r => r.app.ws.readyState === WebSocket.OPEN);
+    const allHealthy = perApp.every(r => r.healthy);
+    return {
+        connected: anyOpen,
+        wasReconnected,
+        healthCheckPassed: allHealthy,
+        connectionInfos,
+        ...(!anyOpen && {
+            error: "App became unavailable after reconnection attempt. Try running scan_metro then ensure_connection."
         }),
     };
 }