execbro 1.10.23 → 1.10.25

package/build/core/index.js.map

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

package/build/core/inspector.d.ts

@@ -1,4 +1,5 @@
 import type { ExecutionResult } from "./types.js";
+import type { RawComponentStack } from "./componentSource.js";
 /**
  * Toggle the Element Inspector via DevSettings native module.
  * This enables the inspector overlay programmatically.
@@ -52,4 +53,27 @@ export declare function inspectAtPoint(x: number, y: number, options?: {
     includeFrame?: boolean;
     device?: string;
 }): Promise<ExecutionResult>;
+/**
+ * Harvests raw _debugStack strings for whatever sits at (x, y). Returns an
+ * empty list rather than throwing, so callers can always fall back to the
+ * unenriched payload.
+ */
+export declare function harvestStacksAtPoint(x: number, y: number, device?: string): Promise<RawComponentStack[]>;
+/** Same, but derives the point from an inspected element's frame. */
+export declare function harvestStacksAtFrame(frame: {
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+} | null | undefined, device?: string): Promise<RawComponentStack[]>;
+/**
+ * Attaches source location to an inspector payload. Never throws and never
+ * removes existing fields - a failure adds only a `sourceUnavailable` reason.
+ */
+export declare function enrichWithSource(payload: Record<string, unknown>, stacks: RawComponentStack[]): Promise<Record<string, unknown>>;
+/** Buffered selections, newest first, each with source resolved lazily on read. */
+export declare function getSelectionHistory(options: {
+    device?: string;
+    limit?: number;
+}): Promise<Record<string, unknown>[]>;
 //# sourceMappingURL=inspector.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/core/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOlD;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBtF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCzE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA4ErF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAC9C,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAqN1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAChC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE;IACL,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACd,GACP,OAAO,CAAC,eAAe,CAAC,CAiN1B"}
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/core/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAO9D;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBtF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCzE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA4ErF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAC9C,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAqN1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAChC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE;IACL,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACd,GACP,OAAO,CAAC,eAAe,CAAC,CAiN1B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACtC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAc9B;AAED,qEAAqE;AACrE,wBAAsB,oBAAoB,CACtC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAC1F,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW9B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUlC;AAED,mFAAmF;AACnF,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAiBrC"}

package/build/core/inspector.js

@@ -1,4 +1,6 @@
 import { executeInApp } from "./jsExecute.js";
+import { resolveStacksToSource, buildDebugStackHarvestExpression } from "./componentSource.js";
+import { selectionBuffer } from "./selectionBuffer.js";
 // ============================================================================
 // Coordinate-Based Element Inspection (via DevTools Inspector API)
 // ============================================================================
@@ -600,4 +602,60 @@ export async function inspectAtPoint(x, y, options = {}) {
     // measure paths without letting a hung Hermes runtime stall the tool.
     return executeInApp(expression, true, { timeoutMs: 5000, originatingToolName: "inspect_at_point" }, device);
 }
+/**
+ * Harvests raw _debugStack strings for whatever sits at (x, y). Returns an
+ * empty list rather than throwing, so callers can always fall back to the
+ * unenriched payload.
+ */
+export async function harvestStacksAtPoint(x, y, device) {
+    try {
+        const res = await executeInApp(buildDebugStackHarvestExpression(x, y), true, { timeoutMs: 5000, originatingToolName: "get_inspector_selection" }, device);
+        if (!res.success || !res.result)
+            return [];
+        const parsed = JSON.parse(res.result);
+        return parsed.stacks ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Same, but derives the point from an inspected element's frame. */
+export async function harvestStacksAtFrame(frame, device) {
+    if (!frame ||
+        frame.left === undefined ||
+        frame.top === undefined ||
+        frame.width === undefined ||
+        frame.height === undefined) {
+        return [];
+    }
+    return harvestStacksAtPoint(frame.left + frame.width / 2, frame.top + frame.height / 2, device);
+}
+/**
+ * Attaches source location to an inspector payload. Never throws and never
+ * removes existing fields - a failure adds only a `sourceUnavailable` reason.
+ */
+export async function enrichWithSource(payload, stacks) {
+    try {
+        const resolved = await resolveStacksToSource(stacks);
+        if (resolved.source) {
+            return { ...payload, source: resolved.source, ancestors: resolved.ancestors };
+        }
+        return { ...payload, sourceUnavailable: resolved.sourceUnavailable ?? "unknown" };
+    }
+    catch {
+        return { ...payload, sourceUnavailable: "resolution-failed" };
+    }
+}
+/** Buffered selections, newest first, each with source resolved lazily on read. */
+export async function getSelectionHistory(options) {
+    const entries = selectionBuffer.list({ device: options.device, limit: options.limit ?? 10 });
+    return Promise.all(entries.map(async (entry) => enrichWithSource({
+        element: entry.element,
+        path: entry.path,
+        frame: entry.frame,
+        style: entry.style,
+        device: entry.device,
+        timestamp: entry.timestamp,
+    }, entry.stacks)));
+}
 //# sourceMappingURL=inspector.js.map

package/build/core/inspector.js.map

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

package/build/core/jsExecute.d.ts

@@ -1,8 +1,15 @@
+import WebSocket from "ws";
 import { ExecutionResult, ExecuteOptions } from "./types.js";
+import type { DeviceInfo } from "./types.js";
 export interface ExpressionValidation {
     valid: boolean;
     expression: string;
     error?: string;
+    /**
+     * Set when the pre-flight rewrote the caller's source rather than rejecting
+     * it. Surfaced to the caller so an agent can see its input was transformed.
+     */
+    rewritten?: "iife-wrap";
 }
 /**
  * Check if a string contains emoji or other problematic Unicode characters
@@ -20,13 +27,81 @@ export declare function stripLeadingComments(expression: string): string;
  * Returns cleaned expression or error with helpful message
  */
 export declare function validateAndPreprocessExpression(expression: string): ExpressionValidation;
+/**
+ * Rewrite a multi-statement source into the IIFE that Hermes can compile,
+ * returning `null` when the rewrite would not be safe.
+ *
+ * `stmt1; stmt2; value` becomes `(function(){ stmt1; stmt2; return value; })()`.
+ * Bails out when the final segment cannot yield a value, so those callers still
+ * get the explanatory error rather than a silently broken transform.
+ */
+export declare function wrapMultiStatementInIife(src: string): string | null;
+export declare function splitTopLevelStatements(src: string): string[];
 export declare const TIMEOUT_HARD_CAP_MS = 120000;
 export declare function markConnectionEstablished(): void;
 export declare function clampTimeoutMs(input: number): {
     value: number;
     clampedFrom?: number;
 };
-export type TransportPattern = "no_apps" | "ws_closed" | "target_closed" | "cdp_eval_too_long";
+export type TransportPattern = "no_apps" | "ws_closed" | "target_closed" | "stale_target";
+/**
+ * True for the one ambiguous failure shape: our own timer fired while the
+ * socket was still OPEN.
+ *
+ * Everything else is already decided. ws=CLOSED is transport (handled in
+ * classifyTransportError); a CDP-sourced error carries its own signal. This
+ * case alone can be either a genuinely slow expression or a stale CDP target
+ * that silently swallows evaluates while the device socket keeps ponging — and
+ * only a probe can tell them apart.
+ */
+export declare function isEvalTimeoutOnLiveSocket(message: string, source: "cdp" | "server-timer" | "logical"): boolean;
+export type ProbeTargetApp = {
+    ws: WebSocket;
+    port: number;
+    deviceInfo: {
+        id?: string;
+    };
+};
+/**
+ * Is our CDP page still listed by Metro?
+ *
+ * This is the signal that a JS-level probe cannot provide: it goes over Metro's
+ * HTTP /json, so a blocked JavaScript thread has no effect on the answer.
+ *
+ * Conservative on purpose — an empty list (Metro unreachable, momentary blip)
+ * or a missing id counts as "still there". A false "gone" costs a reconnect and
+ * a retry that RE-RUNS the caller's expression, which must never happen on a
+ * guess.
+ */
+export declare function isTargetStillAdvertised(app: {
+    port: number;
+    deviceInfo: {
+        id?: string;
+    };
+}, fetchTargets?: (port: number) => Promise<DeviceInfo[]>): Promise<boolean>;
+/**
+ * classifyTransportError plus disambiguation for the one ambiguous shape: our
+ * timer fired while the socket was still OPEN.
+ *
+ * The transport was alive (the 1s ping/pong keepalive would have killed a dead
+ * socket within ~2s), so this is one of three things:
+ *
+ *   1. a genuinely slow ASYNC expression  -> probe answers        -> logical
+ *   2. a genuinely slow SYNC expression   -> probe silent, but the
+ *      (busy loop, big serialize)            page is still listed -> logical
+ *   3. a stale CDP target (app reloaded   -> probe silent AND the
+ *      via shake / Metro 'r')                page is gone         -> transport
+ *
+ * Both signals are required for case 3. The probe alone cannot separate 2 from
+ * 3 — it is itself a Runtime.evaluate, so a blocked JS thread silences it
+ * exactly like a dead context. Verified on-device: a 15s busy loop silenced the
+ * probe and was misread as stale, triggering a reconnect that re-ran the
+ * expression. Metro's target list is independent of the JS thread and settles it.
+ *
+ * `probe` and `targetStillAdvertised` are injectable so the decision is
+ * testable without a socket or a Metro server.
+ */
+export declare function classifyWithLivenessProbe(message: string, source: "cdp" | "server-timer" | "logical", app: ProbeTargetApp | null, probe?: (ws: WebSocket, timeoutMs: number) => Promise<boolean>, targetStillAdvertised?: (app: ProbeTargetApp) => Promise<boolean>): Promise<TransportClassification>;
 export type TransportClassification = {
     kind: "transport";
     pattern: TransportPattern;

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

@@ -1 +1 @@
-{"version":3,"file":"jsExecute.d.ts","sourceRoot":"","sources":["../../src/core/jsExecute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiB7D,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA2B/D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAuExF;AA2HD,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAS3C,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAQrF;AAMD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAE/F,MAAM,MAAM,uBAAuB,GAC7B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,KAAK,GAAG,cAAc,GAAG,SAAS,GAC3C,uBAAuB,CAyBzB;AAuBD;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AA+UD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAC9B,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,OAAc,EAC5B,OAAO,GAAE,cAAmB,EAC5B,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CA8E1B"}
+{"version":3,"file":"jsExecute.d.ts","sourceRoot":"","sources":["../../src/core/jsExecute.ts"],"names":[],"mappings":"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"}

package/build/core/jsExecute.js

@@ -5,6 +5,7 @@ import { getFirstConnectedApp, getConnectedAppByDevice, connectToDevice } from "
 import { fetchDevices, selectMainDevice, scanMetroPorts } from "./metro.js";
 import { cancelReconnectionTimer } from "./connectionState.js";
 import { trackAutoReconnect } from "./telemetry.js";
+import { probeCdpAlive } from "./probe.js";
 // Hermes runtime compatibility: polyfill for 'global' which doesn't exist in Hermes
 // In Hermes, globalThis is the standard way to access global scope
 const GLOBAL_POLYFILL = `var global = typeof global !== 'undefined' ? global : globalThis;`;
@@ -91,21 +92,39 @@ export function validateAndPreprocessExpression(expression) {
             valid: false,
             expression: escaped,
             error: "require() is not available in Hermes Runtime.evaluate. " +
-                "Modules cannot be imported at runtime. Only pre-existing global variables are accessible. " +
-                "Use list_debug_globals to discover available globals, or add `globalThis.__MY_VAR__ = myModule;` in your app code."
+                "Modules cannot be imported at runtime. " +
+                "In a Metro dev build you can reach already-loaded modules through Metro's registry: " +
+                "`(function(){ var hit=null; __r.getModules().forEach(function(m,id){ " +
+                "if(!hit && m.verboseName && m.verboseName.indexOf('react-native/index.js') !== -1) hit=id; }); " +
+                "return __r(hit).Dimensions.get('window'); })()` " +
+                "(swap the verboseName match for the module you want). " +
+                "Otherwise use list_debug_globals to discover exposed globals, or add " +
+                "`globalThis.__MY_VAR__ = myModule;` in your app code."
         };
     }
     // Check for multi-statement expressions. Runtime.evaluate compiles input as
     // a single expression — `console.log('x'); 1+1` raises `')' expected at end
     // of parenthesized expression`. Internal callers wrap in (function(){...})()
     // so any `;` they use is at brace depth 1 and won't be flagged.
-    if (hasTopLevelStatementSeparator(trimmed)) {
+    // executeWithManualAwait emits `var __v=(<expr>);`, so a depth-0 `;` breaks
+    // compilation. Rewrite into the IIFE ourselves instead of making the caller
+    // do it — this was the single largest execute_in_app failure class
+    // (125 events / 42 installations over 30d).
+    const wrapped = wrapMultiStatementInIife(trimmed);
+    if (wrapped) {
+        return { valid: true, expression: wrapped, rewritten: "iife-wrap" };
+    }
+    // More than one statement, but the last one can't yield a value — we can't
+    // synthesize a sensible `return`, so explain rather than guess.
+    if (splitTopLevelStatements(trimmed).length > 1) {
         return {
             valid: false,
             expression: escaped,
             error: "Multi-statement expressions are not supported by Hermes Runtime.evaluate " +
-                "(compiles input as a single expression). " +
-                "Wrap the body in an IIFE: `(function(){ stmt1; stmt2; return result; })()`."
+                "(compiles input as a single expression), and the final statement does not " +
+                "produce a value to return. " +
+                "Wrap the body in an IIFE with an explicit result: " +
+                "`(function(){ stmt1; stmt2; return result; })()`."
         };
     }
     return {
@@ -116,21 +135,19 @@ export function validateAndPreprocessExpression(expression) {
 function isIdentChar(c) {
     return c !== undefined && /[A-Za-z0-9_$]/.test(c);
 }
-// Detect top-level `await`, `async function`, `async (...) => ...`, or
-// `(async ...)` IIFE forms in `src`. Walks char-by-char tracking string,
+// Detect a bare top-level `await` in `src`. Walks char-by-char tracking string,
 // template, comment, and bracket depth so we don't false-positive on
 // substrings inside strings, identifiers like `awaiting`, etc.
+//
+// NOTE: `async function`/`async () => {}`/`(async () => {})()` are deliberately
+// NOT flagged. Hermes compiles them (they are expressions), the manual-await
+// wrapper in executeWithManualAwait resolves the Promise they return, and
+// telemetry showed this pre-flight rejecting ~20 legitimate calls/30d across 10
+// installations. Verified on-device (iOS 26 sim, Hermes): an async arrow with an
+// internal `await` evaluates correctly. Only a bare top-level `await` is a real
+// syntax error, because the wrapper emits `var __v=(<expr>);` — a non-async
+// context.
 function looksLikeTopLevelAwait(src) {
-    // Cheap prefix checks for async-function / async-arrow / async-IIFE forms.
-    // Whitespace-tolerant on `async <keyword>` / `async (`.
-    const asyncPrefix = /^async\s*(?:function\b|\()/;
-    if (asyncPrefix.test(src))
-        return true;
-    // `(async () => ...)()` or `(async(...)...)` — match `(async` followed by
-    // a non-identifier char (so `(asyncFoo` doesn't trigger).
-    const parenAsync = /^\(\s*async(?:\s|\()/;
-    if (parenAsync.test(src))
-        return true;
     // Depth-tracked scan for a standalone `await` token at depth 0.
     let i = 0;
     let parens = 0;
@@ -210,10 +227,40 @@ function looksLikeTopLevelAwait(src) {
     }
     return false;
 }
-// Walk `src` tracking string/template/comment and bracket depth. Returns true
-// iff a `;` appears at depth 0 with non-whitespace following it (i.e. it
-// separates two top-level statements rather than terminating a single one).
-function hasTopLevelStatementSeparator(src) {
+// Statement forms that cannot be the final segment of an auto-wrapped IIFE,
+// because prefixing them with `return` is either a syntax error or drops the
+// value the caller wanted back. `return` itself is handled separately.
+const NON_VALUE_STATEMENT_START = /^(?:if|for|while|do|switch|try|catch|finally|throw|var|let|const|function|class|debugger|break|continue|with|else)\b|^\{/;
+/**
+ * Rewrite a multi-statement source into the IIFE that Hermes can compile,
+ * returning `null` when the rewrite would not be safe.
+ *
+ * `stmt1; stmt2; value` becomes `(function(){ stmt1; stmt2; return value; })()`.
+ * Bails out when the final segment cannot yield a value, so those callers still
+ * get the explanatory error rather than a silently broken transform.
+ */
+export function wrapMultiStatementInIife(src) {
+    const segments = splitTopLevelStatements(src);
+    if (segments.length <= 1)
+        return null;
+    const last = segments[segments.length - 1];
+    if (NON_VALUE_STATEMENT_START.test(last))
+        return null;
+    const head = segments.slice(0, -1);
+    const body = last.startsWith("return") && !isIdentChar(last[6]) ? last : `return ${last}`;
+    return `(function(){ ${[...head, body].join("; ")}; })()`;
+}
+// Walk `src` tracking string/template/comment and bracket depth, splitting on
+// `;` at depth 0. Returns the trimmed top-level statements; a trailing `;` that
+// merely terminates the final statement produces no extra segment.
+export function splitTopLevelStatements(src) {
+    const segments = [];
+    let segmentStart = 0;
+    const push = (end) => {
+        const seg = src.slice(segmentStart, end).trim();
+        if (seg.length > 0)
+            segments.push(seg);
+    };
     let i = 0;
     let parens = 0;
     let braces = 0;
@@ -224,14 +271,14 @@ function hasTopLevelStatementSeparator(src) {
         if (ch === "/" && next === "/") {
             const nl = src.indexOf("\n", i + 2);
             if (nl === -1)
-                return false;
+                break;
             i = nl + 1;
             continue;
         }
         if (ch === "/" && next === "*") {
             const end = src.indexOf("*/", i + 2);
             if (end === -1)
-                return false;
+                break;
             i = end + 2;
             continue;
         }
@@ -264,13 +311,13 @@ function hasTopLevelStatementSeparator(src) {
         else if (ch === "]")
             brackets--;
         else if (ch === ";" && parens === 0 && braces === 0 && brackets === 0) {
-            const rest = src.slice(i + 1).trim();
-            if (rest.length > 0)
-                return true;
+            push(i);
+            segmentStart = i + 1;
         }
         i++;
     }
-    return false;
+    push(src.length);
+    return segments;
 }
 // ============================================================================
 // Per-call timeoutMs: clamp + defaults
@@ -294,6 +341,84 @@ export function clampTimeoutMs(input) {
     }
     return { value: input };
 }
+// How long to wait for the disambiguating probe on a ws=OPEN timeout. Matches
+// PROBE_TIMEOUT_MS in connection.ts, which uses the same probe to reject stale
+// CDP targets at connect time.
+const STALE_TARGET_PROBE_TIMEOUT_MS = 1_500;
+/**
+ * True for the one ambiguous failure shape: our own timer fired while the
+ * socket was still OPEN.
+ *
+ * Everything else is already decided. ws=CLOSED is transport (handled in
+ * classifyTransportError); a CDP-sourced error carries its own signal. This
+ * case alone can be either a genuinely slow expression or a stale CDP target
+ * that silently swallows evaluates while the device socket keeps ponging — and
+ * only a probe can tell them apart.
+ */
+export function isEvalTimeoutOnLiveSocket(message, source) {
+    if (source !== "server-timer")
+        return false;
+    return /ws=OPEN/i.test(message);
+}
+/**
+ * Is our CDP page still listed by Metro?
+ *
+ * This is the signal that a JS-level probe cannot provide: it goes over Metro's
+ * HTTP /json, so a blocked JavaScript thread has no effect on the answer.
+ *
+ * Conservative on purpose — an empty list (Metro unreachable, momentary blip)
+ * or a missing id counts as "still there". A false "gone" costs a reconnect and
+ * a retry that RE-RUNS the caller's expression, which must never happen on a
+ * guess.
+ */
+export async function isTargetStillAdvertised(app, fetchTargets = fetchDevices) {
+    const id = app.deviceInfo?.id;
+    if (!id)
+        return true;
+    const targets = await fetchTargets(app.port);
+    if (targets.length === 0)
+        return true;
+    return targets.some((t) => t.id === id);
+}
+/**
+ * classifyTransportError plus disambiguation for the one ambiguous shape: our
+ * timer fired while the socket was still OPEN.
+ *
+ * The transport was alive (the 1s ping/pong keepalive would have killed a dead
+ * socket within ~2s), so this is one of three things:
+ *
+ *   1. a genuinely slow ASYNC expression  -> probe answers        -> logical
+ *   2. a genuinely slow SYNC expression   -> probe silent, but the
+ *      (busy loop, big serialize)            page is still listed -> logical
+ *   3. a stale CDP target (app reloaded   -> probe silent AND the
+ *      via shake / Metro 'r')                page is gone         -> transport
+ *
+ * Both signals are required for case 3. The probe alone cannot separate 2 from
+ * 3 — it is itself a Runtime.evaluate, so a blocked JS thread silences it
+ * exactly like a dead context. Verified on-device: a 15s busy loop silenced the
+ * probe and was misread as stale, triggering a reconnect that re-ran the
+ * expression. Metro's target list is independent of the JS thread and settles it.
+ *
+ * `probe` and `targetStillAdvertised` are injectable so the decision is
+ * testable without a socket or a Metro server.
+ */
+export async function classifyWithLivenessProbe(message, source, app, probe = probeCdpAlive, targetStillAdvertised = isTargetStillAdvertised) {
+    const base = classifyTransportError(message, source);
+    if (base.kind === "transport")
+        return base;
+    if (!isEvalTimeoutOnLiveSocket(message, source))
+        return base;
+    if (!app)
+        return base;
+    const alive = await probe(app.ws, STALE_TARGET_PROBE_TIMEOUT_MS);
+    if (alive)
+        return base;
+    // Probe silent. Only a target that Metro no longer lists is truly stale;
+    // otherwise the JS thread is just busy and retrying would re-run the call.
+    if (await targetStillAdvertised(app))
+        return base;
+    return { kind: "transport", pattern: "stale_target" };
+}
 /**
  * Classify an error message into transport-vs-logical for auto-reconnect routing.
  *
@@ -304,6 +429,17 @@ export function clampTimeoutMs(input) {
 export function classifyTransportError(message, source) {
     if (!message)
         return { kind: "logical" };
+    // A server-timer expiry is normally logical ("this expression is slow").
+    // But the timer snapshots ws state into the message, and a CLOSED socket
+    // means the call never had a live transport to answer it — that is a
+    // transport failure no matter which timer noticed. Checked before the
+    // server-timer bail-out, which otherwise swallowed it.
+    //
+    // Primarily a backstop: failPendingExecutionsForSocket now fails in-flight
+    // calls at close time, so most of these surface as "WebSocket connection is
+    // not open" instead. This covers the race where our timer fires first.
+    if (/ws=CLOSED/i.test(message))
+        return { kind: "transport", pattern: "ws_closed" };
     if (source === "server-timer")
         return { kind: "logical" };
     if (/No apps connected/i.test(message))
@@ -317,9 +453,14 @@ export function classifyTransportError(message, source) {
     if (/target closed/i.test(message) || /Inspector detached/i.test(message)) {
         return { kind: "transport", pattern: "target_closed" };
     }
-    if (source === "cdp" && /Expression took too long to evaluate/i.test(message)) {
-        return { kind: "transport", pattern: "cdp_eval_too_long" };
-    }
+    // NOTE: there used to be a `cdp_eval_too_long` branch here for a CDP-side
+    // "Expression took too long to evaluate". It was unreachable: the only
+    // producer of that phrase is our own timer in executeCDP, whose message
+    // always starts with "Timeout: Expression took too long" and is therefore
+    // tagged `server-timer` and handled above. Telemetry agrees — 367 such
+    // events over 90 days, none of them lacking our "Connection state:" block.
+    // Retrying is also wrong here: the 1s ping/pong keepalive terminates dead
+    // sockets within ~2s, so a still-OPEN socket had a live transport all along.
     return { kind: "logical" };
 }
 // Error patterns that indicate a stale/destroyed context
@@ -401,6 +542,14 @@ function executeCDP(app, cleanedExpression, awaitPromise, timeoutMs) {
     const TIMEOUT_MS = timeoutMs;
     const currentMessageId = getNextMessageId();
     const wrappedExpression = `${GLOBAL_POLYFILL} ${cleanedExpression}`;
+    // Every send funnels through here, including executeWithManualAwait's poll
+    // loop — which re-enters between sleeps and so can start on a socket that
+    // died since the previous send. ws.send() on a CLOSED socket does not
+    // throw; it simply never gets a reply, so without this the call burns its
+    // full timeout and then reports a misleading "took too long".
+    if (app.ws.readyState !== WebSocket.OPEN) {
+        return Promise.resolve({ success: false, error: "WebSocket connection is not open." });
+    }
     return new Promise((resolve) => {
         const timeoutId = setTimeout(() => {
             pendingExecutions.delete(currentMessageId);
@@ -430,7 +579,9 @@ function executeCDP(app, cleanedExpression, awaitPromise, timeoutMs) {
             ].join("\n");
             resolve({ success: false, error: errorMessage });
         }, TIMEOUT_MS);
-        pendingExecutions.set(currentMessageId, { resolve, timeoutId });
+        // Tag with the socket so a close event can fail this call immediately
+        // rather than letting it sit until TIMEOUT_MS.
+        pendingExecutions.set(currentMessageId, { resolve, timeoutId, ws: app.ws });
         try {
             app.ws.send(JSON.stringify({
                 id: currentMessageId,
@@ -654,7 +805,17 @@ export async function executeInApp(expression, awaitPromise = true, options = {}
     const source = first.error?.startsWith("Timeout: Expression took too long")
         ? "server-timer"
         : "cdp";
-    const classification = classifyTransportError(first.error ?? "", source);
+    // getConnectedAppByDevice throws when an explicit device name matches
+    // nothing; that failure is already reported via `first`, so fall back to
+    // "nothing to probe" rather than replacing the original error.
+    let probeApp = null;
+    try {
+        probeApp = getConnectedAppByDevice(device);
+    }
+    catch {
+        probeApp = null;
+    }
+    const classification = await classifyWithLivenessProbe(first.error ?? "", source, probeApp);
     if (classification.kind !== "transport") {
         trackAutoReconnect("not_needed", toolName);
         return withClampMeta(first);