rnxsim 0.1.366 → 0.1.367

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.366 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.367 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -1175,8 +1175,8 @@ var REACT_NATIVE_ROOT_EXPORT_WILL_IT_WORK_COVERAGE, REACT_NATIVE_ROOT_EXPORT_STR
 var init_react_native_root_export_coverage = __esm({
   "../compat/src/generated/react-native-root-export-coverage.ts"() {
     "use strict";
-    REACT_NATIVE_ROOT_EXPORT_WILL_IT_WORK_COVERAGE = 0.98;
-    REACT_NATIVE_ROOT_EXPORT_STRICT_COVERAGE = 0.653;
+    REACT_NATIVE_ROOT_EXPORT_WILL_IT_WORK_COVERAGE = 0.99;
+    REACT_NATIVE_ROOT_EXPORT_STRICT_COVERAGE = 0.765;
   }
 });
 
@@ -20256,6 +20256,10 @@ var init_bridge_host = __esm({
             return msg?.action === "type" ? "typed text" : "used keyboard";
           case "tree":
             return "dumped tree";
+          case "query":
+            return "queried semantic tree";
+          case "resolve":
+            return "resolved semantic selector";
           case "focus":
             return "focused sim";
           case "close":
@@ -20704,7 +20708,9 @@ var init_current_sim = __esm({
 var ws_bridge_exports = {};
 __export(ws_bridge_exports, {
   BridgeSimLockedError: () => BridgeSimLockedError,
+  RNX_PLACEMENT_ENV: () => RNX_PLACEMENT_ENV,
   bridgePortForShellBaseUrl: () => bridgePortForShellBaseUrl,
+  bridgeWsUrl: () => bridgeWsUrl,
   callInBridge: () => callInBridge,
   callInBridgeWrite: () => callInBridgeWrite,
   checkSimHealth: () => checkSimHealth,
@@ -20715,8 +20721,15 @@ __export(ws_bridge_exports, {
   printBridgeWorldNotice: () => printBridgeWorldNotice,
   resolveBridgeWorld: () => resolveBridgeWorld,
   resolveDefaultBridgePort: () => resolveDefaultBridgePort,
+  resolvePlacement: () => resolvePlacement,
   worldForBridgePort: () => worldForBridgePort
 });
+function resolvePlacement() {
+  return process.env[RNX_PLACEMENT_ENV] === "local-box" ? "local-box" : "host";
+}
+function bridgeWsUrl(wsPort) {
+  return `ws://localhost:${wsPort}`;
+}
 function liveDevBridgeLockfiles() {
   return readDevBridgeLockfiles().filter((lockfile) => isDevBridgeLockfileFresh(lockfile));
 }
@@ -20937,7 +20950,7 @@ function createBridge(wsPort, opts = {}) {
   let nextId = 1;
   const commandTimeoutMs = opts.commandTimeoutMs ?? 15e3;
   const pending = /* @__PURE__ */ new Map();
-  const ws = new import_ws3.WebSocket(`ws://localhost:${wsPort}`);
+  const ws = new import_ws3.WebSocket(bridgeWsUrl(wsPort));
   const identity = getCliIdentity();
   const ready = new Promise((resolve7, reject) => {
     ws.on("open", () => {
@@ -20957,7 +20970,7 @@ function createBridge(wsPort, opts = {}) {
     });
     ws.on("error", (err) => {
       const cause = err.message ? `: ${err.message}` : "";
-      reject(new Error(`could not connect to ws://localhost:${wsPort}${cause}`));
+      reject(new Error(`could not connect to ${bridgeWsUrl(wsPort)}${cause}`));
     });
   });
   ready.catch(() => {
@@ -21160,7 +21173,7 @@ async function callInBridge(bridge, path18, ...args) {
 async function callInBridgeWrite(bridge, path18, ...args) {
   return bridge.send({ type: "call", path: path18, args, acquireLock: true });
 }
-var import_node_fs9, import_node_path11, import_ws3, resolvedWorld, BridgeSimLockedError;
+var import_node_fs9, import_node_path11, import_ws3, RNX_PLACEMENT_ENV, resolvedWorld, BridgeSimLockedError;
 var init_ws_bridge = __esm({
   "cli/ws-bridge.ts"() {
     "use strict";
@@ -21171,6 +21184,7 @@ var init_ws_bridge = __esm({
     init_cli_constants();
     init_home_paths();
     init_current_sim();
+    RNX_PLACEMENT_ENV = "RNX_PLACEMENT";
     resolvedWorld = null;
     BridgeSimLockedError = class extends Error {
       lock;
@@ -21890,7 +21904,107 @@ var init_app_splash = __esm({
   }
 });
 
+// src/bridge-contract.ts
+var init_bridge_contract = __esm({
+  "src/bridge-contract.ts"() {
+    "use strict";
+  }
+});
+
 // cli/commands/inspect/core.ts
+function isSemanticGeometry(value) {
+  return value !== null && typeof value === "object" && [
+    Reflect.get(value, "x"),
+    Reflect.get(value, "y"),
+    Reflect.get(value, "width"),
+    Reflect.get(value, "height")
+  ].every(
+    (coordinate) => typeof coordinate === "number" ? Number.isFinite(coordinate) : false
+  );
+}
+function isSimSemanticTree(value) {
+  if (!Array.isArray(value)) return false;
+  return value.every((node) => {
+    if (node === null || typeof node !== "object" || !Number.isInteger(Reflect.get(node, "nodeId")) || typeof Reflect.get(node, "type") !== "string" || !isSemanticGeometry(Reflect.get(node, "geometry"))) {
+      return false;
+    }
+    for (const key of ["testID", "text", "role", "label"]) {
+      const value2 = Reflect.get(node, key);
+      if (value2 !== void 0 && typeof value2 !== "string") return false;
+    }
+    const pressable = Reflect.get(node, "pressable");
+    if (pressable !== void 0 && pressable !== true) return false;
+    const children = Reflect.get(node, "children");
+    return children === void 0 || isSimSemanticTree(children);
+  });
+}
+function isSemanticQueryResult(value) {
+  const total = value !== null && typeof value === "object" ? Reflect.get(value, "total") : void 0;
+  return value !== null && typeof value === "object" && typeof total === "number" && Number.isInteger(total) && total >= 0 && isSimSemanticTree(Reflect.get(value, "nodes"));
+}
+function globRegex(glob) {
+  const escaped = glob.replace(/[.+^$(){}|[\]\\]/g, "\\$&");
+  return new RegExp(`^${escaped.replace(/\*/g, ".*").replace(/\?/g, ".")}$`, "i");
+}
+function formatSemanticTree(nodes, opts = {}) {
+  const filter = opts.filter?.toLowerCase() ?? "";
+  const testIDRegex = opts.testIdLike ? globRegex(opts.testIdLike) : null;
+  const onlyRegex = opts.onlyGlob ? globRegex(opts.onlyGlob) : null;
+  const lines = [];
+  const visit = (node, indent) => {
+    const joined = [node.role, node.label, node.text, node.testID].filter((value) => typeof value === "string").join(" ");
+    const matches = (!filter || joined.toLowerCase().includes(filter)) && (!testIDRegex || testIDRegex.test(node.testID ?? "")) && (!onlyRegex || onlyRegex.test(joined));
+    if (matches) {
+      const parts = [
+        node.role ? `[${node.role}]` : node.pressable ? "[tap]" : `<${node.type}>`
+      ];
+      if (node.text) {
+        const text = opts.fullText || node.text.length <= 50 ? node.text : `${node.text.slice(0, 49).trimEnd()}\u2026`;
+        parts.push(JSON.stringify(text));
+      }
+      if (node.testID) parts.push(`#${node.testID}`);
+      if (node.label && node.label !== node.text) {
+        parts.push(`label=${JSON.stringify(node.label)}`);
+      }
+      if (!opts.hideXy) {
+        const geometry = node.geometry;
+        parts.push(
+          `@(${Math.round(geometry.x)},${Math.round(geometry.y)}) ${Math.round(geometry.width)}x${Math.round(geometry.height)}`
+        );
+      }
+      if (node.pressable) parts.push("(tap)");
+      lines.push(`${"  ".repeat(indent + 1)}${parts.join(" ")}`);
+    }
+    for (const child of node.children ?? []) visit(child, indent + 1);
+  };
+  let roots = nodes;
+  if (opts.subtreeRoot) {
+    const pending = [...nodes];
+    let found;
+    while (pending.length > 0 && !found) {
+      const candidate = pending.shift();
+      if (!candidate) continue;
+      if (candidate.testID === opts.subtreeRoot) found = candidate;
+      else pending.push(...candidate.children ?? []);
+    }
+    if (!found) return `__SUBTREE_NOT_FOUND__:${opts.subtreeRoot}`;
+    roots = [found];
+  }
+  for (const root of roots) visit(root, 0);
+  return lines.join("\n");
+}
+async function inspectDescribe(bridge, dumpOpts) {
+  const dumpDepth = dumpOpts.maxDepth ?? 12;
+  const result = await bridge.send({
+    type: "query",
+    query: { kind: "tree", depth: dumpDepth }
+  });
+  if (!isSemanticQueryResult(result)) return {};
+  return {
+    tree: formatSemanticTree(result.nodes, dumpOpts),
+    nodeCount: result.total
+  };
+}
 function scoreLayoutTextContrast(input) {
   const required = input.fontSize >= 18 || input.fontSize >= 14 && (input.fontWeight ?? 400) >= 700 ? 3 : 4.5;
   const { normal, background } = input;
@@ -22104,9 +22218,6 @@ function layoutGetNativeEval(opts = {}) {
           type: typeof n.type === 'string' ? n.type : 'node',
           text,
           box: { x: round(abs.x), y: round(abs.y), w: round(layout.width), h: round(layout.height) },
-          borderRadius: 0,
-          padding: { t: 0, r: 0, b: 0, l: 0 },
-          fontSize: 0,
         }
         if (!includeStyle) return base
         // computedStyle has the resolved values; style is the curated subset \u2014
@@ -22175,11 +22286,56 @@ function layoutGetNativeEval(opts = {}) {
       return elements
     })()`;
 }
-function readyProbeHasContent(probe3) {
-  return probe3.liveFrameActive || probe3.targets > 0 || probe3.nodes >= READY_CONTENT_NODE_FLOOR;
+function waitReadyReason(status) {
+  if (status.bridgeError) {
+    return `sim unreachable: ${status.bridgeError} \u2014 the target tab is closed or no sim is connected (check \`rnx list\`, reopen with \`rnx open\`)`;
+  }
+  const base = status.externalError ? `guest app errored: ${status.externalError}` : status.loadingText ? `still showing "${status.loadingText}"` : status.externalReady === false ? "guest app is still loading" : status.flag !== true && status.targets > 0 ? "native content is rendered but the ready signal has not settled" : status.flag !== true ? "guest app has not emitted sootsim:externalAppReady" : status.targets <= 0 ? "ready flag emitted but no visible app content is inspectable yet" : "node tree is still changing";
+  return !status.externalError && status.suppressedEntryError ? `${base} (suppressed entry error: ${status.suppressedEntryError})` : base;
 }
-function readyProbeHasTargetContent(probe3) {
-  return probe3.liveFrameActive || probe3.targets > 0;
+async function inspectWaitReady(bridge, timeoutMs = 2e4, options = {}) {
+  const start = Date.now();
+  let result;
+  try {
+    result = await bridge.send(
+      {
+        type: "waitFor",
+        waitForOptions: { condition: { type: "ready" }, timeoutMs }
+      },
+      { timeoutMs: timeoutMs + 1e3 }
+    );
+  } catch (error) {
+    const bridgeError = error instanceof Error ? error.message : String(error);
+    if (bridgeError.startsWith("multiple sims are connected:") || bridgeError.startsWith("saved sim ")) {
+      throw error;
+    }
+    result = {
+      matched: false,
+      elapsedMs: Date.now() - start,
+      polls: 0,
+      error: bridgeError
+    };
+  }
+  const probe3 = result.probe;
+  const status = {
+    ready: result.matched,
+    elapsedMs: result.elapsedMs,
+    nodes: probe3?.nodes ?? 0,
+    targets: probe3?.targets ?? 0,
+    liveFrameActive: probe3?.liveFrameActive ?? false,
+    liveFrameChannels: probe3?.liveFrameChannels ?? 0,
+    liveFramePublishes: probe3?.liveFramePublishes ?? 0,
+    flag: probe3?.flag,
+    loadingText: probe3?.loadingText ?? "",
+    externalReady: probe3?.externalReady ?? null,
+    externalStatus: probe3?.externalStatus ?? "",
+    externalError: probe3?.externalError ?? "",
+    suppressedEntryError: probe3?.suppressedEntryError ?? "",
+    errors: probe3?.errors ?? 0,
+    bridgeError: result.error ?? ""
+  };
+  if (!status.ready && options.onProgress) options.onProgress(status);
+  return status;
 }
 function consoleEntriesEval(level, limit) {
   const getter = level === "error" ? "getErrors" : "getWarnings";
@@ -22233,156 +22389,12 @@ async function getShellState(bridge, readyTimeoutMs = 0) {
     }
   }
 }
-var LAYOUT_GET_NATIVE_EVAL, WAIT_READY_PROBE, READY_CONTENT_NODE_FLOOR, READY_NODE_STABLE_MS, READY_PROBE_POLL_MS, MERGED_CONSOLE_COUNT_EVAL;
+var LAYOUT_GET_NATIVE_EVAL, MERGED_CONSOLE_COUNT_EVAL;
 var init_core = __esm({
   "cli/commands/inspect/core.ts"() {
     "use strict";
+    init_bridge_contract();
     LAYOUT_GET_NATIVE_EVAL = layoutGetNativeEval();
-    WAIT_READY_PROBE = `(async () => {
-    const t = window.__sootsimTest
-    let nodes = 0
-    try { nodes = (await t?.getNodeCount?.()) || 0 } catch {}
-    let targets = 0
-    let liveFrameActive = false
-    let liveFrameChannels = 0
-    let liveFramePublishes = 0
-    let loadingText = ''
-    const cleanText = (value) =>
-      typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim() : ''
-    const loadingSignal = (value) => {
-      const text = cleanText(value)
-      if (!text) return ''
-      return /^(opening app\\b|looking for your app\\b|building bundle\\b|preparing rnx runtime\\b|loading native bundle\\b|loading rnx stubs\\b|loading bundle loader\\b|loading native stubs\\b|loading compat bridge\\b|loading react-native shim\\b|loading react bridge\\b|loading reconciler\\b|loading replacement modules\\b|injecting rnx modules\\b|warming sqlite engine\\b|capturing root component\\b|reloading app\\b|loading(?:[.!\u2026]*)?$|connecting(?:[.!\u2026]*)?$)/i.test(text)
-        ? text
-        : ''
-    }
-    try {
-      const loading = window.__sootsimConnectRNLoading
-      if (loading && loading.active === true) {
-        loadingText = [loading.title, loading.detail].map(cleanText).filter(Boolean).join(' ')
-      }
-    } catch {}
-    try {
-      if (typeof t?.listInspectable === 'function') {
-        const list = await t.listInspectable({})
-        if (Array.isArray(list)) {
-          const screenW = window.innerWidth || 0
-          const screenH = window.innerHeight || 0
-          const isVisible = (n) => {
-            const layout = n?.layout
-            if (!layout || layout.width <= 0 || layout.height <= 0) return false
-            const abs = n?.absolutePosition || n?.absolute
-            if (!abs) return true
-            const device = n?.device || {}
-            const w = Number(device.width) || screenW
-            const h = Number(device.height) || screenH
-            return (
-              abs.x + layout.width > 0 &&
-              abs.y + layout.height > 0 &&
-              abs.x < w &&
-              abs.y < h
-            )
-          }
-          const hasContentSignal = (n) => {
-            const role = n?.accessibilityRole || n?.role
-            const label = cleanText(n?.accessibilityLabel || n?.label)
-            const handlers = Array.isArray(n?.handlers) ? n.handlers : []
-            const text = cleanText(n?.text)
-            const testID = cleanText(n?.testID || n?.testId)
-            const loading = loadingSignal(text) || loadingSignal(label) || loadingSignal(testID)
-            if (!loadingText && loading) {
-              loadingText = loading
-            }
-            if (handlers.length > 0) return true
-            if (role) return true
-            if (n?.isTextInput) return true
-            if (text) return true
-            if (label) return true
-            if (testID && !/^splash|loading/i.test(testID)) return true
-            return false
-          }
-          targets = list.filter(n => isVisible(n) && hasContentSignal(n)).length
-        }
-      }
-    } catch {}
-    try {
-      const stats = await t?.getImageLoaderStats?.()
-      const presentation = stats?.liveFramePresentation
-      liveFrameChannels = Number(presentation?.activeChannels) || 0
-      liveFramePublishes = Number(presentation?.publishes) || 0
-      const previous = window.__sootsimWaitReadyLiveFramePublishes
-      liveFrameActive =
-        liveFrameChannels > 0 &&
-        typeof previous === 'number' &&
-        liveFramePublishes > previous
-      window.__sootsimWaitReadyLiveFramePublishes = liveFramePublishes
-    } catch {}
-    let externalReady = null
-    let externalStatus = ''
-    let externalError = ''
-    let suppressedEntryError = ''
-    try {
-      const getExternalAppState = t?.getExternalAppState
-      const external = typeof getExternalAppState === 'function'
-        ? await Promise.race([
-            getExternalAppState(),
-            new Promise((resolve) => setTimeout(
-              () => resolve({
-                state: {
-                  ready: false,
-                  loading: true,
-                  status: 'waiting for tenant worker...',
-                },
-              }),
-              1000,
-            )),
-          ])
-        : null
-      const state = external?.state
-      if (state && typeof state === 'object') {
-        externalReady = state.ready === true
-        if (typeof state.status === 'string') externalStatus = state.status
-        if (typeof state.error === 'string') externalError = state.error
-      }
-      if (!externalError && Array.isArray(external?.entryErrors)) {
-        // suppressed-and-continued entry errors (bundle-loader's patched __r
-        // swallows entry throws and moves on) must NOT gate readiness \u2014 the
-        // app frequently runs fine after one (e.g. metro's "Unknown named
-        // module" probing noise). they surface separately as a diagnostic
-        // for the timeout path.
-        const isReal = (item) => item && typeof item.message === 'string' && item.message.trim()
-        const fatal = external.entryErrors.find((item) => isReal(item) && item.suppressed !== true)
-        if (fatal) externalError = fatal.message
-        const suppressed = external.entryErrors.find((item) => isReal(item) && item.suppressed === true)
-        if (suppressed) suppressedEntryError = suppressed.message
-      }
-      // once the app has errored its last status ("injecting sootsim
-      // modules...") is stale \u2014 reporting it makes a dead app read as one that
-      // is still booting.
-      if (externalError) loadingText = ''
-      else if (externalReady === false && externalStatus) loadingText = externalStatus
-    } catch {}
-    let errors = 0
-    try { errors = window.__sootsimConsole?.count?.()?.errors ?? 0 } catch {}
-    return {
-      flag: (window).__sootsimExternalAppReady,
-      at: (window).__sootsimExternalAppReadyAt || 0,
-      nodes,
-      targets,
-      liveFrameActive,
-      liveFrameChannels,
-      liveFramePublishes,
-      errors,
-      loadingText,
-      externalReady,
-      externalStatus,
-      externalError,
-      suppressedEntryError,
-    }
-  })()`;
-    READY_CONTENT_NODE_FLOOR = 100;
-    READY_NODE_STABLE_MS = 750;
-    READY_PROBE_POLL_MS = 150;
     MERGED_CONSOLE_COUNT_EVAL = `(() => {
     const norm = (s) => (typeof s === 'string' ? s : (() => { try { return JSON.stringify(s) } catch { return String(s) } })())
     const key = (lvl, ts, args) => lvl + '|' + Math.round((ts || 0) / 250) + '|' + (Array.isArray(args) ? args.map(norm).join(' ') : norm(args))
@@ -24873,15 +24885,11 @@ async function maybeDescribeAfterOpen(wsPort, simId, args) {
     try {
       let readyProbe = null;
       try {
-        readyProbe = await bridge.send({
-          type: "evaluate",
-          code: WAIT_READY_PROBE
-        });
+        readyProbe = await inspectWaitReady(bridge, 1);
       } catch {
       }
       if (readyProbe) {
-        const readyEnough = readyProbe.flag === true && !readyProbe.loadingText && readyProbeHasContent(readyProbe);
-        if (!readyEnough) {
+        if (!readyProbe.ready) {
           const reason = readyProbe.loadingText ? `still showing "${readyProbe.loadingText}"` : readyProbe.flag !== true ? "guest ready event has not fired" : readyProbe.targets <= 0 ? "no visible app content is inspectable yet" : "app tree is still stabilizing";
           console.log(
             `  app still loading: ${reason} (nodes: ${readyProbe.nodes}, targets: ${readyProbe.targets})`
@@ -24889,26 +24897,16 @@ async function maybeDescribeAfterOpen(wsPort, simId, args) {
           console.log("  before interacting, run: rnx wait ready --max-ms 120000");
         }
       }
-      const dumpOpts = { describe: true, verbose: false, filter: "" };
-      const code = `(async () => {
-        const t = window.__sootsimTest
-        const ms = window.SootSim?.bridges?.mainShell
-        if (!t) return null
-        let shell = null
-        try { shell = ms?.getState ? await ms.getState() : null } catch {}
-        const tree = await t.dumpTree(12, ${JSON.stringify(dumpOpts)})
-        return { tree, shell }
-      })()`;
-      const result = await bridge.send({ type: "evaluate", code });
+      const result = await inspectDescribe(bridge, {
+        describe: true,
+        verbose: false,
+        filter: "",
+        compact: true,
+        hideXy: false,
+        maxDepth: 12
+      });
       if (!result?.tree) return;
       console.log("");
-      if (result.shell?.state) {
-        const parts = [
-          `state=${result.shell.state}`,
-          result.shell.activeApp ? `app=${result.shell.activeApp}` : null
-        ].filter(Boolean);
-        console.log(`  shell: ${parts.join(" ")}`);
-      }
       console.log(result.tree);
     } finally {
       bridge.close();
@@ -26860,7 +26858,6 @@ var init_bridge_flow_runner = __esm({
       lastRecordingDurationMs = null;
       lastRecordingFrameStats = null;
       flowTraceSteps = [];
-      simRouteHint = null;
       // set by runStep when a step throws — lets the outer flow command
       // dump a rich per-step failure bundle (screenshot + describe.json +
       // console + network) keyed by the failing step.
@@ -26868,50 +26865,6 @@ var init_bridge_flow_runner = __esm({
       get simId() {
         return this.opts.simId;
       }
-      setSimRouteHint(urlLike) {
-        this.simRouteHint = this.normalizeSimRoute(urlLike);
-      }
-      normalizeSimRoute(urlLike) {
-        if (!urlLike) return null;
-        try {
-          const url = new URL(urlLike);
-          url.searchParams.delete("inspectOpen");
-          const search = url.searchParams.toString();
-          return `${url.origin}${url.pathname}${search ? `?${search}` : ""}`;
-        } catch {
-          return urlLike;
-        }
-      }
-      // sim ids rotate on `window.location.reload()` when the shell reconnects.
-      // after launchApp we re-resolve the primary sim so the rest of the flow
-      // doesn't send commands to a dead id.
-      async refreshSimId() {
-        if (!this.opts.simId) return;
-        try {
-          const sims = await this.bridge.listSims();
-          const current = sims.find((b) => b.id === this.opts.simId);
-          if (current) {
-            this.simRouteHint = this.normalizeSimRoute(current.url || current.origin);
-          }
-          const stillThere = sims.find(
-            (b) => b.id === this.opts.simId && b.readyState === "open"
-          );
-          if (stillThere) return;
-          if (!this.simRouteHint) return;
-          const hinted = this.simRouteHint && sims.find(
-            (b) => b.readyState === "open" && this.normalizeSimRoute(b.url || b.origin) === this.simRouteHint
-          );
-          if (!hinted) return;
-          const primary = sims.find((b) => b.isPrimary && b.readyState === "open");
-          const firstOpen = sims.find((b) => b.readyState === "open");
-          const next = hinted ?? primary ?? firstOpen;
-          if (next) {
-            this.opts.simId = next.id;
-            console.log(`  [flow] sim rotated to ${next.id}`);
-          }
-        } catch {
-        }
-      }
       async evaluate(code, timeoutMs) {
         return this.bridge.send(
           {
@@ -26940,63 +26893,17 @@ var init_bridge_flow_runner = __esm({
         });
       }
       async waitForTree(timeout = DEFAULT_TIMEOUT) {
-        const deadline = Date.now() + scaledTimeout(timeout);
-        const startedAt = Date.now();
-        let lastError = null;
-        let consecutiveBridgeFailures = 0;
-        let lastProgressAt = 0;
-        let lastNodes = -1;
-        let nodeStableSince = startedAt;
-        while (Date.now() < deadline) {
-          try {
-            const probe3 = await this.evaluate(
-              WAIT_READY_PROBE,
-              // the readiness probe is cheap — cap it well under the bridge-wide
-              // command timeout so a non-responsive sim is detected in seconds,
-              // not after a full 15s-per-poll stall.
-              8e3
-            );
-            consecutiveBridgeFailures = 0;
-            if (probe3?.externalError) {
-              throw new Error(`app failed to load: ${probe3.externalError}`);
-            }
-            if (probe3) {
-              const now = Date.now();
-              if (probe3.nodes !== lastNodes) {
-                lastNodes = probe3.nodes;
-                nodeStableSince = now;
-              }
-              const hasReadySignal = probe3.flag === true && readyProbeHasContent(probe3);
-              const hasRenderedContentWithoutReadySignal = probe3.flag !== true && readyProbeHasTargetContent(probe3);
-              const ready = (hasReadySignal || hasRenderedContentWithoutReadySignal) && probe3.externalReady !== false && !probe3.externalError && !probe3.loadingText && now - nodeStableSince >= READY_NODE_STABLE_MS;
-              if (ready) return;
-            }
-          } catch (err) {
-            lastError = err instanceof Error ? err : new Error(String(err));
-            if (lastError.message.startsWith("app failed to load:")) {
-              throw lastError;
-            }
-            consecutiveBridgeFailures++;
-            if (consecutiveBridgeFailures >= 4) {
-              throw new Error(
-                `target sim is not responding to the bridge (${lastError.message}). it is likely a stale orphan \u2014 run \`rnx list\`, then close it with \`rnx close <id>\` or start a fresh one with \`rnx open --new <port>\`.`
-              );
-            }
-            await this.refreshSimId();
-          }
-          const elapsed = Date.now() - startedAt;
-          if (elapsed - lastProgressAt >= 5e3) {
-            lastProgressAt = elapsed;
-            console.log(
-              `  [flow] waiting for app to be ready\u2026 (${Math.round(elapsed / 1e3)}s)`
-            );
-          }
-          await sleep3(READY_PROBE_POLL_MS);
+        const status = await inspectWaitReady(this.bridge, scaledTimeout(timeout));
+        if (status.ready) return;
+        if (status.externalError) {
+          throw new Error(`app failed to load: ${status.externalError}`);
         }
-        if (lastError?.message.startsWith("app failed to load:")) {
-          throw lastError;
+        if (status.bridgeError) {
+          throw new Error(
+            `target sim is not responding to the bridge (${status.bridgeError}). it is likely a stale orphan; run \`rnx list\`, then close it with \`rnx close <id>\` or start a fresh one with \`rnx open --new <port>\`.`
+          );
         }
-        throw new Error(`app not ready after ${timeout}ms`);
+        throw new Error(`app not ready after ${timeout}ms: ${waitReadyReason(status)}`);
       }
       async ensureRecordingStarted() {
         if (!this.opts.recordingOutputDir) {
@@ -27974,8 +27881,6 @@ var init_bridge_flow_runner = __esm({
       async reloadGuestApp() {
         await this.evaluate("window.location.reload()").catch(() => {
         });
-        await sleep3(500);
-        await this.refreshSimId();
       }
       async resetGuestAppData(launchOptions) {
         const reset = await this.bridge.send(
@@ -28012,7 +27917,6 @@ var init_bridge_flow_runner = __esm({
         const deadline = Date.now() + 1e4;
         let lastError = null;
         while (Date.now() < deadline) {
-          await this.refreshSimId();
           try {
             if (this.recordingEnabled) await this.ensureRecordingStarted();
             if (this.profilingEnabled) await this.startProfile();
@@ -28027,7 +27931,6 @@ var init_bridge_flow_runner = __esm({
         );
       }
       async launchApp(opts) {
-        await this.refreshSimId();
         let hasLaunchArguments = false;
         let launchArguments;
         if (isObjectRecord(opts) && Object.prototype.hasOwnProperty.call(opts, "arguments")) {

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.366 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.367 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.366",
+  "version": "0.1.367",
   "description": "rnx CLI, Vite and Metro plugins, and agent skills for driving React Native apps in the browser.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",
@@ -71,11 +71,11 @@
       "import": "./dist-lib/sdk.mjs",
       "default": "./dist-lib/sdk.cjs"
     },
-    "./mcp": {
-      "types": "./src/mcp.ts",
-      "source": "./src/mcp.ts",
-      "import": "./dist-lib/mcp.mjs",
-      "default": "./dist-lib/mcp.cjs"
+    "./bridge-contract-input": {
+      "types": "./src/bridge-contract-input.ts",
+      "source": "./src/bridge-contract-input.ts",
+      "import": "./dist-lib/bridge-contract-input.mjs",
+      "default": "./dist-lib/bridge-contract-input.cjs"
     },
     "./beta": {
       "source": "./src/beta.ts",
@@ -111,6 +111,8 @@
     "./bridge-contract": {
       "types": "./src/bridge-contract.ts",
       "source": "./src/bridge-contract.ts",
+      "bun": "./src/bridge-contract.ts",
+      "import": "./dist-lib/bridge-contract.mjs",
       "default": "./dist-lib/bridge-contract.cjs"
     },
     "./bridge-constants": {
@@ -219,6 +221,7 @@
     }
   },
   "devDependencies": {
+    "@contrast/harness": "workspace:*",
     "@contrast/runtime-delivery": "workspace:*",
     "@sootsim/compat": "workspace:*",
     "@sootsim/globals": "workspace:*",