execbro 0.0.1-reserve → 1.10.13

package/build/core/debugGlobals.js

@@ -0,0 +1,370 @@
+import WebSocket from "ws";
+import { connectedApps, getNextMessageId } from "./state.js";
+import { getConnectedAppByDevice, connectToDevice, clearReconnectionSuppression, purgeStaleConnectionsForPorts } from "./connection.js";
+import { fetchDevices, filterDebuggableDevices, scanMetroPorts } from "./metro.js";
+import { DEFAULT_RECONNECTION_CONFIG, cancelReconnectionTimer } from "./connectionState.js";
+import { executeInApp, delay } from "./jsExecute.js";
+import { isSDKInstalled } from "./sdkBridge.js";
+// Build the IIFE expression used by listDebugGlobals. Exported so tests can
+// assert structural invariants (e.g. that we probe __rn__, that we emit the
+// expected hint) without needing to spin up a live CDP connection.
+export function buildListDebugGlobalsExpression() {
+    return `
+        (function() {
+            var names;
+            try {
+                var enumNames = Object.keys(globalThis);
+                var ownNames = Object.getOwnPropertyNames(globalThis);
+                var seen = {};
+                names = [];
+                for (var i = 0; i < ownNames.length; i++) { if (!seen[ownNames[i]]) { seen[ownNames[i]] = 1; names.push(ownNames[i]); } }
+                for (var j = 0; j < enumNames.length; j++) { if (!seen[enumNames[j]]) { seen[enumNames[j]] = 1; names.push(enumNames[j]); } }
+            } catch (e) {
+                names = Object.keys(globalThis);
+            }
+
+            var categories = {
+                'Apollo Client': [],
+                'Redux': [],
+                'React DevTools': [],
+                'Reanimated': [],
+                'Expo': [],
+                'Metro': [],
+                'Other Debug': []
+            };
+            for (var k = 0; k < names.length; k++) {
+                var key = names[k];
+                if (key.indexOf('APOLLO') >= 0) categories['Apollo Client'].push(key);
+                else if (key.indexOf('REDUX') >= 0) categories['Redux'].push(key);
+                else if (key.indexOf('REACT_DEVTOOLS') >= 0) categories['React DevTools'].push(key);
+                else if (key.indexOf('reanimated') >= 0 || key.indexOf('worklet') >= 0) categories['Reanimated'].push(key);
+                else if (key.indexOf('Expo') >= 0 || key.indexOf('expo') >= 0) categories['Expo'].push(key);
+                else if (key.indexOf('METRO') >= 0) categories['Metro'].push(key);
+                else if (key.indexOf('__') === 0) categories['Other Debug'].push(key);
+            }
+
+            // SDK probe: detect __RN_AI_DEVTOOLS__ even when not enumerable on
+            // globalThis, and flatten its registered objects into dotted paths
+            // the agent can hand straight to inspect_global / execute_in_app.
+            var sdk = null;
+            try {
+                var _sdkRoot = globalThis.__EXECBRO__ || globalThis.__RN_AI_DEVTOOLS__;
+                if (typeof _sdkRoot !== 'undefined' && _sdkRoot) {
+                    var rootName = typeof globalThis.__EXECBRO__ !== 'undefined' ? '__EXECBRO__' : '__RN_AI_DEVTOOLS__';
+                    var dt = _sdkRoot;
+                    var paths = [];
+                    // Map well-known store keys back into the legacy category
+                    // buckets so SDK-registered stores don't appear missing to
+                    // agents that scan categories.Redux / categories["Apollo Client"].
+                    var storeCategory = {
+                        redux: 'Redux',
+                        apollo: 'Apollo Client',
+                        apolloclient: 'Apollo Client',
+                        reactdevtools: 'React DevTools'
+                    };
+                    if (dt.stores && typeof dt.stores === 'object') {
+                        var sk = Object.keys(dt.stores);
+                        for (var a = 0; a < sk.length; a++) {
+                            var storeKey = sk[a];
+                            var path = rootName + '.stores.' + storeKey;
+                            paths.push(path);
+                            var bucket = storeCategory[storeKey.toLowerCase()];
+                            if (bucket && categories[bucket].indexOf(path) < 0) {
+                                categories[bucket].push(path);
+                            }
+                        }
+                    }
+                    if (dt.navigation) paths.push(rootName + '.navigation');
+                    if (dt.custom && typeof dt.custom === 'object') {
+                        var ck = Object.keys(dt.custom);
+                        for (var b = 0; b < ck.length; b++) paths.push(rootName + '.custom.' + ck[b]);
+                    }
+                    sdk = {
+                        version: dt.version || 'unknown',
+                        capabilities: dt.capabilities || null,
+                        paths: paths,
+                        hint: 'These paths are inspect_global / execute_in_app ready (dotted paths supported).'
+                    };
+                    // Make sure both root globals appear in the listing,
+                    // even if Hermes hid them from Object.keys.
+                    if (categories['Other Debug'].indexOf('__EXECBRO__') < 0) {
+                        categories['Other Debug'].push('__EXECBRO__');
+                    }
+                    if (categories['Other Debug'].indexOf('__RN_AI_DEVTOOLS__') < 0) {
+                        categories['Other Debug'].push('__RN_AI_DEVTOOLS__');
+                    }
+                }
+            } catch (e) { /* ignore */ }
+
+            // RN namespace probe: populated by the SDK's exposeRnGlobals() or
+            // the executor's fallback fiber-walk bootstrap. Reports keys when
+            // available so agents discover the namespace without reading docs.
+            //   undefined -> bootstrap not run yet
+            //   null      -> bootstrap attempted, no modules found
+            //   object    -> populated namespace
+            var rn = null;
+            try {
+                var rnRaw = globalThis.__rn__;
+                if (typeof rnRaw === 'undefined') {
+                    rn = null;
+                } else if (rnRaw === null) {
+                    rn = {
+                        keys: [],
+                        hint: 'Bootstrap attempted but no fiber had the curated RN modules in scope. Install react-native-ai-devtools-sdk or fall back to a fiber walk.'
+                    };
+                    if (categories['Other Debug'].indexOf('__rn__') < 0) {
+                        categories['Other Debug'].push('__rn__');
+                    }
+                } else if (typeof rnRaw === 'object') {
+                    var rnKeys = Object.keys(rnRaw);
+                    rn = {
+                        keys: rnKeys,
+                        hint: 'Use globalThis.__rn__.<Module> (e.g. globalThis.__rn__.I18nManager.isRTL) in execute_in_app, or pass dotted paths like __rn__.Platform to inspect_global.'
+                    };
+                    if (categories['Other Debug'].indexOf('__rn__') < 0) {
+                        categories['Other Debug'].push('__rn__');
+                    }
+                }
+            } catch (e) { /* ignore */ }
+
+            return { sdk: sdk, rn: rn, categories: categories };
+        })()
+    `;
+}
+// List globally available debugging objects in the app.
+// Uses Object.getOwnPropertyNames + Object.keys to catch non-enumerable globals
+// (Hermes does not always make `globalThis.x = ...` assignments enumerable),
+// and probes __RN_AI_DEVTOOLS__ directly so the SDK's registered stores/
+// navigation/custom objects surface as ready-to-use dotted paths.
+export async function listDebugGlobals(device) {
+    return executeInApp(buildListDebugGlobalsExpression(), false, { originatingToolName: "list_debug_globals" }, device);
+}
+// Inspect a global object (or a dotted path into one) to see its properties
+// and types. Accepts plain identifiers (`__APOLLO_CLIENT__`) and dotted paths
+// (`__RN_AI_DEVTOOLS__.stores.redux`) so the discovery output from
+// listDebugGlobals can be passed straight back in.
+export async function inspectGlobal(objectName, device) {
+    // Reject anything that isn't a safe dotted identifier path. This both
+    // prevents accidental code execution via objectName and produces a clear
+    // error instead of a confusing Hermes parse failure.
+    if (!/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*$/.test(objectName)) {
+        return {
+            success: false,
+            error: `Invalid objectName: '${objectName}'. Expected an identifier or dotted path like '__APOLLO_CLIENT__' or '__EXECBRO__.stores.redux'. For arbitrary expressions, use execute_in_app.`
+        };
+    }
+    const expression = `
+        (function() {
+            var obj;
+            try { obj = ${objectName}; } catch (e) { return { error: 'NotFound: ' + (e && e.message ? e.message : String(e)) }; }
+            if (obj === undefined) return { error: 'Object not found' };
+            if (obj === null) return { error: 'Value is null' };
+            var t = typeof obj;
+            if (t !== 'object' && t !== 'function') {
+                return { __value: obj, __type: t };
+            }
+            var result = {};
+            var keys;
+            try { keys = Object.keys(obj); } catch (e) { keys = []; }
+            for (var i = 0; i < keys.length; i++) {
+                var key = keys[i];
+                var val;
+                try { val = obj[key]; } catch (e) { result[key] = { type: 'unknown', callable: false, error: 'getter threw' }; continue; }
+                var type = typeof val;
+                if (type === 'function') {
+                    result[key] = { type: 'function', callable: true };
+                } else if (type === 'object' && val !== null) {
+                    var preview;
+                    try { preview = JSON.stringify(val); } catch (e) { preview = '[unserializable]'; }
+                    if (preview && preview.length > 100) preview = preview.slice(0, 100) + '...';
+                    result[key] = { type: Array.isArray(val) ? 'array' : 'object', callable: false, preview: preview };
+                } else {
+                    result[key] = { type: type, callable: false, value: val };
+                }
+            }
+            return result;
+        })()
+    `;
+    return executeInApp(expression, false, { originatingToolName: "inspect_global" }, device);
+}
+// Reload the React Native app using __ReactRefresh
+// Note: Page.reload CDP method may work on Bridgeless targets (via HostAgent) — not yet tested
+// Uses fire-and-forget: sends the reload command without waiting for a response,
+// since the JS context is destroyed during reload and would always timeout.
+export async function reloadApp(device) {
+    // Get current connection info before reload
+    let app = getConnectedAppByDevice(device);
+    // Auto-connect if no connection exists. Mirrors scan_metro's flow
+    // (clearReconnectionSuppression + filterDebuggableDevices + purge +
+    // connectToDevice per device) — earlier attempts that used ensureConnection
+    // here raced with WS close events on first connect and reported
+    // "Connection succeeded but app is not available". scan_metro's pattern
+    // is the empirically-stable path.
+    if (!app) {
+        console.error("[execbro] No connection for reload, attempting auto-connect...");
+        const ports = await scanMetroPorts();
+        if (ports.length === 0) {
+            return {
+                success: false,
+                error: "No apps connected and no Metro server found. Make sure Metro bundler is running (npm start or expo start), then try again."
+            };
+        }
+        clearReconnectionSuppression();
+        const portDevices = new Map();
+        for (const port of ports) {
+            const devices = await fetchDevices(port);
+            const debuggable = filterDebuggableDevices(devices);
+            if (debuggable.length > 0) {
+                portDevices.set(port, debuggable);
+            }
+        }
+        purgeStaleConnectionsForPorts(portDevices);
+        for (const [port, devices] of portDevices) {
+            for (const dev of devices) {
+                try {
+                    await connectToDevice(dev, port);
+                }
+                catch (error) {
+                    console.error(`[execbro] Auto-connect failed for ${dev.title} on port ${port}: ${error}`);
+                }
+            }
+        }
+        app = getConnectedAppByDevice(device);
+        if (!app) {
+            return {
+                success: false,
+                error: "No apps connected. Found Metro server but could not connect to any device. Make sure the React Native app is running."
+            };
+        }
+    }
+    const port = app.port;
+    // If the in-app SDK was the network/console source before the reload, the
+    // new JS context must re-run init() before get_network_requests can read
+    // the SDK buffer again. Remember this so we can wait for re-readiness below
+    // instead of returning into the window where the MCP falls back to the
+    // duplicate-prone CDP/interceptor buffer.
+    const sdkWasPresent = app.sdkPresent === true;
+    // Fire-and-forget: send reload command via CDP without waiting for response.
+    // The JS context is destroyed during reload, so Runtime.evaluate would always timeout.
+    const reloadExpression = `(function() {
+        try {
+            if (typeof __ReactRefresh !== 'undefined' && typeof __ReactRefresh.performFullRefresh === 'function') {
+                __ReactRefresh.performFullRefresh('mcp-reload');
+                return 'ok';
+            }
+            if (typeof global !== 'undefined' && global.DevSettings && typeof global.DevSettings.reload === 'function') {
+                global.DevSettings.reload();
+                return 'ok';
+            }
+            return 'no-method';
+        } catch (e) { return 'error:' + e.message; }
+    })()`;
+    try {
+        if (app.ws.readyState !== WebSocket.OPEN) {
+            const deviceName = app.deviceInfo.deviceName || app.deviceInfo.title || "unknown";
+            return {
+                success: false,
+                error: [
+                    `WebSocket connection is not open (device="${deviceName}", platform=${app.platform}).`,
+                    "The CDP page may be stale or the app has crashed.",
+                    "",
+                    "Recovery steps (try in order):",
+                    "1. Call scan_metro to re-establish a fresh CDP connection",
+                    "2. If scan_metro doesn't help, force-restart the app:",
+                    "   - iOS: ios_terminate_app then ios_launch_app",
+                    "   - Android: android_launch_app (restarts automatically)",
+                    "3. After restarting, call scan_metro again to reconnect",
+                ].join("\n")
+            };
+        }
+        // Send without registering a pending execution — fire and forget
+        const messageId = getNextMessageId();
+        app.ws.send(JSON.stringify({
+            id: messageId,
+            method: "Runtime.evaluate",
+            params: {
+                expression: reloadExpression,
+                returnByValue: true,
+                awaitPromise: false,
+                userGesture: true
+            }
+        }));
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to send reload command: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+    // Auto-reconnect after reload
+    try {
+        // Wait for app to reload (give it time to restart JS context)
+        await delay(2000);
+        // Find and close only the targeted device's connection (not all devices on this port)
+        const targetDeviceId = app.deviceInfo.id;
+        for (const [key, connectedApp] of connectedApps.entries()) {
+            if (connectedApp.deviceInfo.id === targetDeviceId) {
+                cancelReconnectionTimer(key);
+                try {
+                    connectedApp.ws.close();
+                }
+                catch {
+                    // Ignore close errors
+                }
+                connectedApps.delete(key);
+                break;
+            }
+        }
+        // Small delay to ensure cleanup
+        await delay(500);
+        // Reconnect only the reloaded device (not all devices on the port)
+        const devices = await fetchDevices(port);
+        const targetDevice = devices.find(d => d.id === targetDeviceId)
+            || devices.find(d => d.deviceName === app.deviceInfo.deviceName);
+        if (targetDevice) {
+            await connectToDevice(targetDevice, port, {
+                isReconnection: false,
+                reconnectionConfig: { ...DEFAULT_RECONNECTION_CONFIG, enabled: false }
+            });
+            // If the SDK was the source before reload, wait for the new context
+            // to re-run init() and re-expose __RN_AI_DEVTOOLS__ before returning,
+            // so the caller's next get_network_requests reads the SDK buffer
+            // rather than falling back to the duplicate-prone CDP/interceptor
+            // buffer. Bounded; non-SDK apps and slow inits just fall through.
+            let sdkReady = true;
+            if (sdkWasPresent) {
+                const SDK_READY_TIMEOUT_MS = 5000;
+                const SDK_READY_POLL_MS = 300;
+                const deadline = Date.now() + SDK_READY_TIMEOUT_MS;
+                sdkReady = false;
+                while (Date.now() < deadline) {
+                    if (await isSDKInstalled()) {
+                        sdkReady = true;
+                        break;
+                    }
+                    await delay(SDK_READY_POLL_MS);
+                }
+            }
+            return {
+                success: true,
+                result: `App reloaded and reconnected to ${targetDevice.deviceName || targetDevice.title}`
+                    + (sdkWasPresent && !sdkReady
+                        ? " (warning: in-app SDK did not re-initialize within 5s; network/console may briefly use the fallback buffer)"
+                        : "")
+            };
+        }
+        else {
+            return {
+                success: true,
+                result: "App reloaded but could not auto-reconnect. Run 'scan_metro' to reconnect."
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: true,
+            result: `App reloaded but auto-reconnect failed: ${error instanceof Error ? error.message : String(error)}. Run 'scan_metro' to reconnect.`
+        };
+    }
+}
+//# sourceMappingURL=debugGlobals.js.map

package/build/core/debugGlobals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugGlobals.js","sourceRoot":"","sources":["../../src/core/debugGlobals.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AACxI,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,4EAA4E;AAC5E,4EAA4E;AAC5E,mEAAmE;AACnE,MAAM,UAAU,+BAA+B;IAC3C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwHN,CAAC;AACN,CAAC;AAED,wDAAwD;AACxD,gFAAgF;AAChF,6EAA6E;AAC7E,yEAAyE;AACzE,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAe;IAClD,OAAO,YAAY,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,EAAE,MAAM,CAAC,CAAC;AACzH,CAAC;AAED,4EAA4E;AAC5E,8EAA8E;AAC9E,mEAAmE;AACnE,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,MAAe;IACnE,sEAAsE;IACtE,yEAAyE;IACzE,qDAAqD;IACrD,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,wBAAwB,UAAU,iJAAiJ;SAC7L,CAAC;IACN,CAAC;IAED,MAAM,UAAU,GAAG;;;0BAGG,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4B/B,CAAC;IAEF,OAAO,YAAY,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;AAC9F,CAAC;AAED,mDAAmD;AACnD,+FAA+F;AAC/F,iFAAiF;AACjF,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAe;IAC3C,4CAA4C;IAC5C,IAAI,GAAG,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAE1C,kEAAkE;IAClE,oEAAoE;IACpE,4EAA4E;IAC5E,gEAAgE;IAChE,wEAAwE;IACxE,kCAAkC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QAEhF,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4HAA4H;aACtI,CAAC;QACN,CAAC;QAED,4BAA4B,EAAE,CAAC;QAE/B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;QACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;QAED,6BAA6B,CAAC,WAAW,CAAC,CAAC;QAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;YACxC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACD,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,GAAG,CAAC,KAAK,YAAY,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;gBAC9F,CAAC;YACL,CAAC;QACL,CAAC;QAED,GAAG,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,uHAAuH;aACjI,CAAC;QACN,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,0EAA0E;IAC1E,yEAAyE;IACzE,4EAA4E;IAC5E,uEAAuE;IACvE,0CAA0C;IAC1C,MAAM,aAAa,GAAG,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC;IAE9C,6EAA6E;IAC7E,uFAAuF;IACvF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;SAYpB,CAAC;IAEN,IAAI,CAAC;QACD,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,SAAS,CAAC;YAClF,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACH,6CAA6C,UAAU,eAAe,GAAG,CAAC,QAAQ,IAAI;oBACtF,mDAAmD;oBACnD,EAAE;oBACF,gCAAgC;oBAChC,2DAA2D;oBAC3D,uDAAuD;oBACvD,iDAAiD;oBACjD,2DAA2D;oBAC3D,yDAAyD;iBAC5D,CAAC,IAAI,CAAC,IAAI,CAAC;aACf,CAAC;QACN,CAAC;QAED,iEAAiE;QACjE,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;QACrC,GAAG,CAAC,EAAE,CAAC,IAAI,CACP,IAAI,CAAC,SAAS,CAAC;YACX,EAAE,EAAE,SAAS;YACb,MAAM,EAAE,kBAAkB;YAC1B,MAAM,EAAE;gBACJ,UAAU,EAAE,gBAAgB;gBAC5B,aAAa,EAAE,IAAI;gBACnB,YAAY,EAAE,KAAK;gBACnB,WAAW,EAAE,IAAI;aACpB;SACJ,CAAC,CACL,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACpG,CAAC;IACN,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC;QACD,8DAA8D;QAC9D,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAElB,sFAAsF;QACtF,MAAM,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,cAAc,EAAE,CAAC;gBAChD,uBAAuB,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,CAAC;oBACD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACL,sBAAsB;gBAC1B,CAAC;gBACD,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,MAAM;YACV,CAAC;QACL,CAAC;QAED,gCAAgC;QAChC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,mEAAmE;QACnE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,cAAc,CAAC;eACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAErE,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,eAAe,CAAC,YAAY,EAAE,IAAI,EAAE;gBACtC,cAAc,EAAE,KAAK;gBACrB,kBAAkB,EAAE,EAAE,GAAG,2BAA2B,EAAE,OAAO,EAAE,KAAK,EAAE;aACzE,CAAC,CAAC;YAEH,oEAAoE;YACpE,sEAAsE;YACtE,iEAAiE;YACjE,kEAAkE;YAClE,kEAAkE;YAClE,IAAI,QAAQ,GAAG,IAAI,CAAC;YACpB,IAAI,aAAa,EAAE,CAAC;gBAChB,MAAM,oBAAoB,GAAG,IAAI,CAAC;gBAClC,MAAM,iBAAiB,GAAG,GAAG,CAAC;gBAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,oBAAoB,CAAC;gBACnD,QAAQ,GAAG,KAAK,CAAC;gBACjB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;oBAC3B,IAAI,MAAM,cAAc,EAAE,EAAE,CAAC;wBACzB,QAAQ,GAAG,IAAI,CAAC;wBAChB,MAAM;oBACV,CAAC;oBACD,MAAM,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBACnC,CAAC;YACL,CAAC;YAED,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,mCAAmC,YAAY,CAAC,UAAU,IAAI,YAAY,CAAC,KAAK,EAAE;sBACpF,CAAC,aAAa,IAAI,CAAC,QAAQ;wBACzB,CAAC,CAAC,6GAA6G;wBAC/G,CAAC,CAAC,EAAE,CAAC;aAChB,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,2EAA2E;aACtF,CAAC;QACN,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,2CAA2C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC;SAC9I,CAAC;IACN,CAAC;AACL,CAAC"}

package/build/core/deviceDiscovery.d.ts

@@ -0,0 +1,52 @@
+export interface IosSimulatorRow {
+    name: string;
+    udid: string;
+    state: "booted" | "shutdown";
+    runtime: string;
+    rnConnected?: {
+        deviceName: string;
+        port: number;
+    };
+}
+export interface AndroidEmulatorRow {
+    name: string;
+    serial: string | null;
+    state: "running" | "stopped";
+    rnConnected?: {
+        deviceName: string;
+        port: number;
+    };
+}
+export interface AndroidPhysicalRow {
+    model: string;
+    serial: string;
+    state: "device" | "unauthorized" | "offline";
+    rnConnected?: {
+        deviceName: string;
+        port: number;
+    };
+}
+export interface ListAllDevicesResult {
+    ios: {
+        available: boolean;
+        error?: string;
+        simulators: IosSimulatorRow[];
+    };
+    android: {
+        available: boolean;
+        error?: string;
+        emulators: AndroidEmulatorRow[];
+        physical: AndroidPhysicalRow[];
+    };
+    summary: {
+        booted: number;
+        total: number;
+    };
+}
+/** Test-only: clear the cache so the next call re-queries. */
+export declare function resetDeviceDiscoveryCache(): void;
+export interface ListAllDevicesOptions {
+    refresh?: boolean;
+}
+export declare function listAllDevices(options?: ListAllDevicesOptions): Promise<ListAllDevicesResult>;
+//# sourceMappingURL=deviceDiscovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deviceDiscovery.d.ts","sourceRoot":"","sources":["../../src/core/deviceDiscovery.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IAC7C,WAAW,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,oBAAoB;IACjC,GAAG,EAAE;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,eAAe,EAAE,CAAC;KACjC,CAAC;IACF,OAAO,EAAE;QACL,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAChC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;KAClC,CAAC;IACF,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAKD,8DAA8D;AAC9D,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AA+DD,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,cAAc,CAChC,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAa/B"}

package/build/core/deviceDiscovery.js

@@ -0,0 +1,74 @@
+import { listIOSSimulators } from "./ios.js";
+import { listAndroidDevices, getAndroidEmulatorAvds, getAdbIdForAvd } from "./android.js";
+const CACHE_TTL_MS = 5000;
+let cache = null;
+/** Test-only: clear the cache so the next call re-queries. */
+export function resetDeviceDiscoveryCache() {
+    cache = null;
+}
+async function discoverIos() {
+    const result = await listIOSSimulators(false);
+    if (!result.success) {
+        return { available: false, error: result.error, simulators: [] };
+    }
+    const simulators = (result.simulators ?? []).map((sim) => ({
+        name: sim.name,
+        udid: sim.udid,
+        state: sim.state === "Booted" ? "booted" : "shutdown",
+        runtime: sim.runtime
+    }));
+    return { available: true, simulators };
+}
+async function discoverAndroid() {
+    const devicesResult = await listAndroidDevices();
+    if (!devicesResult.success) {
+        return {
+            available: false,
+            error: devicesResult.error,
+            emulators: [],
+            physical: []
+        };
+    }
+    const rawDevices = devicesResult.devices ?? [];
+    const physical = rawDevices
+        .filter((d) => !/^emulator-\d+$/.test(d.id))
+        .map((d) => ({
+        model: d.model ?? d.id,
+        serial: d.id,
+        state: d.status ?? "offline"
+    }));
+    const avds = await getAndroidEmulatorAvds();
+    const emulators = await Promise.all(avds.map(async (name) => {
+        const serial = await getAdbIdForAvd(name);
+        return {
+            name,
+            serial,
+            state: serial ? "running" : "stopped"
+        };
+    }));
+    return { available: true, emulators, physical };
+}
+function computeSummary(result) {
+    const iosBooted = result.ios.simulators.filter((s) => s.state === "booted").length;
+    const androidRunning = result.android.emulators.filter((e) => e.state === "running").length;
+    const androidPhysicalOnline = result.android.physical.filter((p) => p.state === "device").length;
+    const booted = iosBooted + androidRunning + androidPhysicalOnline;
+    const total = result.ios.simulators.length +
+        result.android.emulators.length +
+        result.android.physical.length;
+    return { booted, total };
+}
+export async function listAllDevices(options = {}) {
+    if (!options.refresh && cache && Date.now() - cache.timestamp < CACHE_TTL_MS) {
+        return cache.result;
+    }
+    const [ios, android] = await Promise.all([discoverIos(), discoverAndroid()]);
+    const partial = { ios, android };
+    const result = {
+        ...partial,
+        summary: computeSummary(partial)
+    };
+    cache = { result, timestamp: Date.now() };
+    return result;
+}
+//# sourceMappingURL=deviceDiscovery.js.map

package/build/core/deviceDiscovery.js.map

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

package/build/core/deviceResolver.d.ts

@@ -0,0 +1,44 @@
+export type DeviceTargetSource = "registry" | "udid" | "adb-serial" | "name-match" | "default";
+export interface DeviceTarget {
+    platform: "ios" | "android";
+    iosUdid?: string;
+    androidSerial?: string;
+    deviceName: string;
+    source: DeviceTargetSource;
+}
+export type DeviceResolverErrorCode = "MULTIPLE_DEVICES_MATCH" | "NO_DEVICES_FOUND" | "DEVICE_NOT_FOUND" | "SIMULATOR_NOT_BOOTED" | "CONFLICTING_IDENTIFIERS";
+export interface DeviceResolverError {
+    code: DeviceResolverErrorCode;
+    message: string;
+    candidates?: Array<{
+        name: string;
+        platform: "ios" | "android";
+        identifier: string;
+    }>;
+}
+export type ResolveResult = {
+    ok: true;
+    target: DeviceTarget;
+} | {
+    ok: false;
+    error: DeviceResolverError;
+};
+/**
+ * Render a DeviceResolverError as a single string suitable for tool responses.
+ * Appends the candidates list when present so the agent can disambiguate
+ * without an extra list_devices call.
+ */
+export declare function formatResolverError(error: DeviceResolverError): string;
+/**
+ * Resolve a single `device` string (UDID, adb serial, RN-registry deviceName,
+ * sim/emu name, or undefined) into a structured DeviceTarget.
+ *
+ * Resolution order:
+ *   1. UDID format → iOS simulator lookup (errors if shutdown).
+ *   2. emulator-NNNN format → Android serial lookup.
+ *   3. Substring match against the RN-connected registry.
+ *   4. Substring match against booted iOS sims and online Android devices.
+ *   5. No `device` argument → pick the single running device, or error.
+ */
+export declare function resolveDeviceTarget(device?: string): Promise<ResolveResult>;
+//# sourceMappingURL=deviceResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deviceResolver.d.ts","sourceRoot":"","sources":["../../src/core/deviceResolver.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GACxB,UAAU,GACV,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEhB,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAC7B,wBAAwB,GACxB,kBAAkB,GAClB,kBAAkB,GAClB,sBAAsB,GACtB,yBAAyB,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzF;AAED,MAAM,MAAM,aAAa,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AA2BhD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAMtE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqOjF"}