execbro 1.10.23 → 1.10.25

package/build/core/componentSource.js

@@ -0,0 +1,268 @@
+import { parseStackString, symbolicateFrames } from "./symbolicate.js";
+/** Shared fiber-root lookup. Hermes-safe: var + function only. */
+const ROOTS_SNIPPET = `
+    var hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+    var roots = [];
+    if (hook && hook.getFiberRoots) {
+        if (hook.renderers) {
+            for (var entry of hook.renderers) {
+                try { roots = roots.concat(Array.from(hook.getFiberRoots(entry[0]) || [])); } catch (e) {}
+            }
+        }
+        if (roots.length === 0) {
+            try { roots = Array.from(hook.getFiberRoots(1) || []); } catch (e) {}
+        }
+    }
+`;
+/**
+ * Cheap per-tick probe. Deliberately does NO measurement — it runs every
+ * 500-2000ms and must stay inexpensive. Reports whether RN's inspector is
+ * mounted and whether its selection changed since the previous tick.
+ */
+export function buildSelectionProbeExpression() {
+    return `
+        (function() {
+            ${ROOTS_SNIPPET}
+            if (roots.length === 0) return { active: false, selected: false, changed: false };
+
+            var panels = [];
+            function walk(fiber, depth) {
+                if (!fiber || depth > 3000) return;
+                if (fiber.type && typeof fiber.type !== 'string' &&
+                    (fiber.type.displayName || fiber.type.name) === 'InspectorPanel') {
+                    panels.push(fiber);
+                }
+                var child = fiber.child;
+                while (child) { walk(child, depth + 1); child = child.sibling; }
+            }
+            for (var r = 0; r < roots.length; r++) { walk(roots[r].current, 0); }
+
+            if (panels.length === 0) {
+                globalThis.__execbro_lastInspected = undefined;
+                return { active: false, selected: false, changed: false };
+            }
+
+            var panel = null;
+            for (var p = 0; p < panels.length; p++) {
+                var h = panels[p].memoizedProps && panels[p].memoizedProps.hierarchy;
+                if (h && h.length > 0) { panel = panels[p]; break; }
+            }
+            if (!panel) return { active: true, selected: false, changed: false };
+
+            var props = panel.memoizedProps;
+            var inspected = props.inspected;
+
+            // RN allocates a fresh object per tap, so identity - not value -
+            // distinguishes two consecutive taps on the same element.
+            if (inspected === globalThis.__execbro_lastInspected) {
+                return { active: true, selected: true, changed: false };
+            }
+            globalThis.__execbro_lastInspected = inspected;
+
+            var names = [];
+            for (var i = 0; i < props.hierarchy.length; i++) {
+                names.push(props.hierarchy[i].name);
+            }
+
+            var style = {};
+            if (inspected && inspected.style) {
+                var list = Array.isArray(inspected.style) ? inspected.style : [inspected.style];
+                for (var s = 0; s < list.length; s++) {
+                    if (list[s] && typeof list[s] === 'object') {
+                        for (var k in list[s]) { style[k] = list[s][k]; }
+                    }
+                }
+            }
+
+            return {
+                active: true,
+                selected: true,
+                changed: true,
+                element: names.length > 0 ? names[names.length - 1] : 'Unknown',
+                path: names.join(' > '),
+                hierarchy: names,
+                frame: inspected && inspected.frame ? inspected.frame : null,
+                style: Object.keys(style).length > 0 ? style : null
+            };
+        })()
+    `;
+}
+/**
+ * Hit-tests at (x, y) and harvests raw _debugStack strings up the return chain.
+ * Measures host fibers, so this runs only when the probe reports a change -
+ * once per tap, never per tick.
+ *
+ * Prefers _debugSource when present (React < 19, already source coordinates);
+ * otherwise emits the raw _debugStack string for host-side symbolication.
+ *
+ * The cap is deliberately generous. Real trees bury the nearest user component
+ * deep behind library wrappers - measured on a production app, a tapped SearchBar
+ * sat 12 ancestors above the hit fiber (SVG icon, Pressable and View wrappers in
+ * between) and HomeScreen sat at 22. Collapsed library frames are dropped
+ * host-side, so a larger walk improves recall without bloating the output; the
+ * extra frames cost nothing beyond one batched, cached symbolicate request.
+ */
+export function buildDebugStackHarvestExpression(x, y, maxAncestors = 30) {
+    return `
+        new Promise(function(resolve) {
+            var maxAncestors = ${maxAncestors};
+            ${ROOTS_SNIPPET}
+            if (roots.length === 0) return resolve({ stacks: [], error: 'no-fiber-roots' });
+
+            function getMeasurable(fiber) {
+                var sn = fiber.stateNode;
+                if (!sn) return null;
+                if (typeof sn.measureInWindow === 'function') return sn;
+                if (sn.canonical && sn.canonical.publicInstance &&
+                    typeof sn.canonical.publicInstance.measureInWindow === 'function') {
+                    return sn.canonical.publicInstance;
+                }
+                if (sn.node && globalThis.nativeFabricUIManager &&
+                    typeof globalThis.nativeFabricUIManager.measureInWindow === 'function') {
+                    var node = sn.node;
+                    return {
+                        measureInWindow: function(cb) {
+                            try { globalThis.nativeFabricUIManager.measureInWindow(node, cb); } catch (e) {}
+                        }
+                    };
+                }
+                return null;
+            }
+
+            var hostFibers = [];
+            function walkFibers(fiber, depth) {
+                var cur = fiber;
+                while (cur) {
+                    if (hostFibers.length >= 500) return;
+                    if (typeof cur.type === 'string' && getMeasurable(cur)) hostFibers.push(cur);
+                    if (cur.child && depth < 250) walkFibers(cur.child, depth + 1);
+                    cur = cur.sibling;
+                }
+            }
+            for (var r = 0; r < roots.length; r++) { walkFibers(roots[r].current, 0); }
+            if (hostFibers.length === 0) return resolve({ stacks: [], error: 'no-host-fibers' });
+
+            var measurements = new Array(hostFibers.length).fill(null);
+            var pending = hostFibers.length;
+            var settled = false;
+
+            function collect() {
+                if (settled) return;
+                settled = true;
+
+                var targetX = ${x};
+                var targetY = ${y};
+                var hits = [];
+                for (var i = 0; i < measurements.length; i++) {
+                    var m = measurements[i];
+                    if (m && m.width > 0 && m.height > 0 &&
+                        targetX >= m.x && targetX <= m.x + m.width &&
+                        targetY >= m.y && targetY <= m.y + m.height) {
+                        hits.push({ fiber: hostFibers[i], area: m.width * m.height });
+                    }
+                }
+                if (hits.length === 0) return resolve({ stacks: [], error: 'no-hit' });
+                hits.sort(function(a, b) { return a.area - b.area; });
+
+                var stacks = [];
+                var node = hits[0].fiber;
+                while (node && stacks.length < maxAncestors) {
+                    var name = null;
+                    if (node.type) {
+                        name = typeof node.type === 'string'
+                            ? node.type
+                            : (node.type.displayName || node.type.name);
+                    }
+                    if (name) {
+                        var src = node._debugSource;
+                        if (src && src.fileName) {
+                            stacks.push({
+                                component: name,
+                                stack: '',
+                                file: src.fileName,
+                                lineNumber: src.lineNumber,
+                                column: src.columnNumber
+                            });
+                        } else if (node._debugStack && node._debugStack.stack) {
+                            stacks.push({ component: name, stack: String(node._debugStack.stack) });
+                        }
+                    }
+                    node = node.return;
+                }
+                resolve({ stacks: stacks });
+            }
+
+            hostFibers.forEach(function(fiber, i) {
+                try {
+                    getMeasurable(fiber).measureInWindow(function(fx, fy, fw, fh) {
+                        measurements[i] = { x: fx, y: fy, width: fw, height: fh };
+                        if (--pending === 0) collect();
+                    });
+                } catch (e) {
+                    if (--pending === 0) collect();
+                }
+            });
+
+            setTimeout(collect, 300);
+        })
+    `;
+}
+/**
+ * Frame index 1 of a parsed _debugStack is the component's render site - the
+ * JSX call site in its parent, which is the line a developer edits. Index 0 is
+ * the Error construction inside React's jsx runtime.
+ */
+const RENDER_SITE_FRAME_INDEX = 1;
+export async function resolveStacksToSource(stacks) {
+    if (stacks.length === 0) {
+        return { source: null, ancestors: [], sourceUnavailable: "no-debug-stack" };
+    }
+    // React < 19 path: _debugSource already carries source coordinates.
+    const direct = [];
+    const needsSymbolication = [];
+    for (const entry of stacks) {
+        if (entry.file && entry.lineNumber !== undefined) {
+            direct.push({ component: entry.component, file: entry.file, line: entry.lineNumber });
+            continue;
+        }
+        const frames = parseStackString(entry.stack, RENDER_SITE_FRAME_INDEX + 1);
+        const renderSite = frames[RENDER_SITE_FRAME_INDEX];
+        if (renderSite) {
+            needsSymbolication.push({ component: entry.component, frame: renderSite });
+        }
+    }
+    if (needsSymbolication.length === 0) {
+        if (direct.length === 0) {
+            return { source: null, ancestors: [], sourceUnavailable: "no-debug-stack" };
+        }
+        const first = direct[0];
+        const firstEntry = stacks.find((s) => s.component === first.component);
+        return {
+            source: { file: first.file, line: first.line, column: firstEntry?.column ?? 0 },
+            ancestors: direct,
+        };
+    }
+    const resolved = await symbolicateFrames(needsSymbolication.map((n) => n.frame));
+    if (resolved === null) {
+        return { source: null, ancestors: [], sourceUnavailable: "symbolicate-unreachable" };
+    }
+    const ancestors = [...direct];
+    let best = null;
+    resolved.forEach((frame, i) => {
+        const component = needsSymbolication[i]?.component;
+        if (!component || frame.collapse)
+            return;
+        ancestors.push({ component, file: frame.file, line: frame.lineNumber });
+        if (!best) {
+            best = { file: frame.file, line: frame.lineNumber, column: frame.column };
+        }
+    });
+    if (!best && direct.length > 0) {
+        best = { file: direct[0].file, line: direct[0].line, column: 0 };
+    }
+    if (!best) {
+        return { source: null, ancestors: [], sourceUnavailable: "library-only" };
+    }
+    return { source: best, ancestors };
+}
+//# sourceMappingURL=componentSource.js.map

package/build/core/componentSource.js.map

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

package/build/core/connection.d.ts

@@ -55,6 +55,36 @@ export declare function getConnectedAppBySimulatorUdid(udid: string): ConnectedA
  * multiple Android apps are connected.
  */
 export declare function getConnectedAppByAndroidDeviceId(deviceId?: string): ConnectedApp | null;
+/**
+ * Outcome of matching a caller-supplied `device` string against the currently
+ * connected apps. Split out of getConnectedAppByDevice so callers that can
+ * *recover* from a miss (reload_app auto-connects, then re-resolves) can
+ * inspect the failure instead of catching a thrown UserInputError — a throw
+ * on the first resolve is what made reload_app skip its own auto-connect path
+ * whenever a device argument was supplied.
+ */
+export type DeviceResolution = {
+    kind: "ok";
+    app: ConnectedApp;
+} | {
+    kind: "ambiguous";
+    device: string;
+    matches: ConnectedApp[];
+} | {
+    kind: "none";
+    device?: string;
+    connected: ConnectedApp[];
+};
+/**
+ * Human-facing explanation for a `kind: "none"` / `kind: "ambiguous"` resolution.
+ * Kept next to the matcher so the message always reflects the matching rules.
+ */
+export declare function describeDeviceResolution(resolution: DeviceResolution): string;
+/**
+ * Non-throwing device matcher. Prefer this in call sites that can retry
+ * (auto-connect, rescan); use getConnectedAppByDevice when a miss is terminal.
+ */
+export declare function resolveConnectedAppByDevice(device?: string): DeviceResolution;
 export declare function getConnectedAppByDevice(device?: string): ConnectedApp | null;
 export declare function hasConnectedApp(): boolean;
 /**

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":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAoB,YAAY,EAAkB,cAAc,EAAsB,sBAAsB,EAAmB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAmH1M;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAYD;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CA6DnG;AAaD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CACzC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,GAC9C,MAAM,EAAE,CAoCV;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA4B/D;AA2RD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAoW3G;AAGD,wBAAsB,eAAe,CACjC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAiUjB;AA8FD,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,YAAY,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC,CAMD;AAGD,wBAAgB,oBAAoB,IAAI,YAAY,GAAG,IAAI,CAW1D;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAWhF;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAuBvF;AAYD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAgBnE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAkC7E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA0C7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAU5E;AAGD,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CA4C7E;AAqCD,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsErF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAUD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmLvC;AAED,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,eAAe,GAAG,eAAe,GAAG,aAAa,GAAG,gBAAgB,CAAC;CACvF;AAED,wBAAgB,0BAA0B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAmDzF;AAED,wBAAsB,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgD9F"}

package/build/core/connection.js

@@ -1,5 +1,5 @@
 import WebSocket from "ws";
-import { connectedApps, pendingExecutions, getNextMessageId, getLogBuffer, getNetworkBuffer, setActiveSimulatorUdid, clearActiveSimulatorIfSource, updateLastCDPMessageTime, getLastCDPMessageTime, clearLastCDPMessageTime } from "./state.js";
+import { connectedApps, pendingExecutions, failPendingExecutionsForSocket, getNextMessageId, getLogBuffer, getNetworkBuffer, setActiveSimulatorUdid, clearActiveSimulatorIfSource, updateLastCDPMessageTime, getLastCDPMessageTime, clearLastCDPMessageTime } from "./state.js";
 import { mapConsoleType } from "./logs.js";
 import { injectNetworkInterceptor, sendNetworkEnable, isInterceptorEvent, applyInterceptedEvent } from "./networkInterceptor.js";
 import { findSimulatorByName } from "./ios.js";
@@ -9,6 +9,7 @@ import { probeCdpAlive } from "./probe.js";
 import { UserInputError } from "./errors.js";
 import { scheduleAppDetection } from "./appDetection.js";
 import { markConnectionEstablished } from "./jsExecute.js";
+import { startSelectionPoller } from "./selectionPoller.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, recordConnectionEvent, } from "./connectionState.js";
 // Connection locks to prevent concurrent connection attempts to the same device
 const connectionLocks = new Set();
@@ -877,6 +878,14 @@ export async function connectToDevice(device, port, options = {}) {
                     clearInterval(pingInterval);
                     pingInterval = null;
                 }
+                // Fail anything still in flight on this socket. Otherwise each
+                // call parks until its own timeoutMs and then reports a generic
+                // "Expression took too long", which classifies as logical and
+                // never triggers auto-reconnect.
+                const failedCount = failPendingExecutionsForSocket(ws, "WebSocket connection is not open.");
+                if (failedCount > 0) {
+                    console.error(`[execbro] Failed ${failedCount} in-flight call(s) on closed socket for ${device.title}`);
+                }
                 // Release connection lock if still held
                 connectionLocks.delete(appKey);
                 connectedApps.delete(appKey);
@@ -954,6 +963,9 @@ export async function connectToDevice(device, port, options = {}) {
             connectionLocks.delete(appKey);
             connectedApps.set(appKey, { ws, deviceInfo: device, port, platform: "android" });
             markConnectionEstablished();
+            // Watch RN's Element Inspector for selections made outside an agent
+            // request. Idempotent, and a no-op when EXECBRO_DISABLE_SELECTION_POLL=1.
+            startSelectionPoller(device.deviceName);
             // Initialize or update connection state
             // Note: We do NOT reset reconnectionAttempts here - that happens
             // only when connection has been stable for MIN_STABLE_CONNECTION_MS
@@ -1227,27 +1239,85 @@ function normalizeDeviceId(value) {
         return "";
     return value.toLowerCase().replace(/[\s_\-]+/g, "");
 }
-export function getConnectedAppByDevice(device) {
-    if (!device) {
-        return getFirstConnectedApp();
+/** Guess which platform a caller-supplied device string refers to. */
+function guessRequestedPlatform(device) {
+    const lower = device.toLowerCase();
+    // Simulator UDIDs are uppercase UUIDs; adb serials are not.
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(lower))
+        return "ios";
+    if (/iphone|ipad|ipod|\bios\b|simulator/.test(lower))
+        return "ios";
+    if (/emulator-|sdk_gphone|pixel|galaxy|nexus|\bsm-|moto|xiaomi|redmi|oneplus|android|api \d+/.test(lower))
+        return "android";
+    return null;
+}
+function deviceLabel(app) {
+    return app.deviceInfo.deviceName || app.deviceInfo.title || "";
+}
+/**
+ * Human-facing explanation for a `kind: "none"` / `kind: "ambiguous"` resolution.
+ * Kept next to the matcher so the message always reflects the matching rules.
+ */
+export function describeDeviceResolution(resolution) {
+    if (resolution.kind === "ok")
+        return "";
+    if (resolution.kind === "ambiguous") {
+        const names = resolution.matches.map(deviceLabel).join(", ");
+        return `Multiple devices match "${resolution.device}": ${names}. Be more specific (use the full device name for an exact match).`;
     }
-    const lowerDevice = device.toLowerCase();
-    const normDevice = normalizeDeviceId(device);
-    const matches = [];
-    const allOpenNames = [];
+    const { device, connected } = resolution;
+    if (!device) {
+        return "No apps connected. Run scan_metro to discover and connect to Metro servers.";
+    }
+    if (connected.length === 0) {
+        return `No connected device matches "${device}". No devices are currently connected — run scan_metro to discover and connect to Metro servers.`;
+    }
+    const quoted = connected.map(a => `"${deviceLabel(a)}"`).join(", ");
+    // Cross-platform mismatch is the dominant shape of this failure: the agent
+    // passes a name from list_ios_simulators / adb devices while only the other
+    // platform is attached to Metro. Saying so beats "retry with one of these".
+    const requested = guessRequestedPlatform(device);
+    const attachedPlatforms = new Set(connected.map(a => a.platform));
+    if (requested && !attachedPlatforms.has(requested)) {
+        const other = requested === "ios" ? "Android" : "iOS";
+        const launchHint = requested === "ios"
+            ? "ios_launch_app (boot the simulator first if needed)"
+            : "android_launch_app";
+        return [
+            `No connected device matches "${device}". Only ${other} device(s) are attached to Metro: ${quoted}.`,
+            `The ${requested === "ios" ? "iOS" : "Android"} app is not connected — start it with ${launchHint}, then run scan_metro.`,
+            `Or omit the device argument / use get_apps to target an already-connected device.`
+        ].join(" ");
+    }
+    return `No connected device matches "${device}". Connected devices: ${quoted}. Retry with one of these names (substring match, case-insensitive), or run get_apps to list them.`;
+}
+/**
+ * Non-throwing device matcher. Prefer this in call sites that can retry
+ * (auto-connect, rescan); use getConnectedAppByDevice when a miss is terminal.
+ */
+export function resolveConnectedAppByDevice(device) {
+    const openApps = [];
     for (const [key, app] of connectedApps.entries()) {
         if (app.ws.readyState !== WebSocket.OPEN) {
             connectedApps.delete(key);
             continue;
         }
-        const deviceName = app.deviceInfo.deviceName || app.deviceInfo.title || "";
-        allOpenNames.push(deviceName);
+        openApps.push(app);
+    }
+    if (!device) {
+        const app = getFirstConnectedApp();
+        return app ? { kind: "ok", app } : { kind: "none", connected: openApps };
+    }
+    const lowerDevice = device.toLowerCase();
+    const normDevice = normalizeDeviceId(device);
+    const matches = [];
+    for (const app of openApps) {
         // Match against deviceName + the underlying hardware identifiers, with
         // separator-insensitive normalization so "SM_A356N" finds
         // "SM-A356N - 15 - API 35" and "emulator-5554" finds the Android app
         // attached to that serial.
         const haystacks = [
-            normalizeDeviceId(deviceName),
+            normalizeDeviceId(deviceLabel(app)),
             normalizeDeviceId(app.simulatorUdid),
             normalizeDeviceId(app.adbSerial)
         ].filter((s) => s.length > 0);
@@ -1257,24 +1327,27 @@ export function getConnectedAppByDevice(device) {
     }
     // Prefer exact (case-insensitive) match when present — disambiguates
     // "iPhone 17 Pro" from "iPhone 17 Pro Max" when both are connected.
-    const exact = matches.find(a => {
-        const name = a.deviceInfo.deviceName || a.deviceInfo.title || "";
-        return name.toLowerCase() === lowerDevice;
-    });
+    const exact = matches.find(a => deviceLabel(a).toLowerCase() === lowerDevice);
     if (exact)
-        return exact;
-    if (matches.length === 1) {
-        return matches[0];
-    }
-    if (matches.length > 1) {
-        const names = matches.map(a => a.deviceInfo.deviceName || a.deviceInfo.title).join(", ");
-        throw new UserInputError(`Multiple devices match "${device}": ${names}. Be more specific (use the full device name for an exact match).`);
-    }
-    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).`);
+        return { kind: "ok", app: exact };
+    if (matches.length === 1)
+        return { kind: "ok", app: matches[0] };
+    if (matches.length > 1)
+        return { kind: "ambiguous", device, matches };
+    return { kind: "none", device, connected: openApps };
+}
+export function getConnectedAppByDevice(device) {
+    const resolution = resolveConnectedAppByDevice(device);
+    if (resolution.kind === "ok")
+        return resolution.app;
+    // No device argument: a miss just means "nothing connected" — callers
+    // handle null themselves (historically getFirstConnectedApp's contract).
+    if (!device)
+        return null;
+    const context = resolution.kind === "ambiguous"
+        ? "ambiguous_device"
+        : resolution.connected.length > 0 ? "device_mismatch" : "no_devices_connected";
+    throw new UserInputError(describeDeviceResolution(resolution), context);
 }
 // Check if any app is connected with an OPEN WebSocket
 export function hasConnectedApp() {