rnxsim 0.1.365 → 0.1.367

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.365 | (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,18 @@ 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;
+  }
+});
+
+// ../compat/src/generated/react-native-webview-coverage.ts
+var REACT_NATIVE_WEBVIEW_WILL_IT_WORK_COVERAGE, REACT_NATIVE_WEBVIEW_STRICT_COVERAGE;
+var init_react_native_webview_coverage = __esm({
+  "../compat/src/generated/react-native-webview-coverage.ts"() {
+    "use strict";
+    REACT_NATIVE_WEBVIEW_WILL_IT_WORK_COVERAGE = 0.74;
+    REACT_NATIVE_WEBVIEW_STRICT_COVERAGE = 0.223;
   }
 });
 
@@ -1220,6 +1230,7 @@ var init_registry = __esm({
     "use strict";
     init_capability_inventory_coverage();
     init_react_native_root_export_coverage();
+    init_react_native_webview_coverage();
     init_unsupported_packages();
     COMPAT_CATEGORIES = [
       "All",
@@ -1371,10 +1382,11 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=11.0.0",
-            coverage: 0.55,
-            note: "native-seam only: the published package runs unchanged and routes RNCWebView through the tenant-to-shell hosted iframe surface. chromium can load cross-origin source.uri pages under the shell COEP through a credentialless frame; same-origin URI and source.html keep normal cookie and persistent-storage semantics. the iframe keeps loading while parked behind a canvas placeholder and becomes interactive when promoted live. paired native and SootSim runtime conformance covers local-page onOpenWindow target delivery.",
-            working: "source.uri/source.html, Chromium cross-origin URI loading under the shell COEP, same-origin URI cookies, source.html persistent localStorage, document-start ReactNativeWebView bootstrap and injectedJavaScriptBeforeContentLoaded/injectedJavaScript on source.html and percent-encoded data: URI pages, strict ReactNativeWebView.postMessage bridge envelope, onMessage synthetic event with navigation fields, onOpenWindow target delivery for source.html and percent-encoded data: URI pages, onLoad/Start/End, onNavigationStateChange, ref.reload/stopLoading/injectJavaScript/postMessage, renderLoading, javaScriptEnabled sandbox, layout, inherited clipping and visibility, parked/live presentation",
-            missing: "Safari/WebKit cross-origin URI pages without COEP-compatible response headers remain permanently loading because WebKit ignores iframe credentialless; Chromium credentialless cross-origin URI frames send no credentials, including cookies set by their own origin, and use ephemeral storage; iframe pixels in canvas screenshots; script injection, ReactNativeWebView bootstrap, and onOpenWindow for remote pages, which get no bridge at all because a browser cannot script a cross-origin frame; the re-encoded data: URI a page reports as its own location.href, so onMessage carries the re-encoded url while onLoad and onNavigationStateChange carry the original where iOS reports one identical url for all three; cross-origin ref.goBack/goForward and truthful canGoBack/canGoForward values; failed HTTP/refused navigation callbacks (onError/onHttpError and renderError); onShouldStartLoadWithRequest, allowsBackForwardNavigationGestures, userAgent, dataDetectorTypes, cacheEnabled, incognito, scalesPageToFit, originWhitelist enforcement"
+            coverage: REACT_NATIVE_WEBVIEW_WILL_IT_WORK_COVERAGE,
+            strictCoverage: REACT_NATIVE_WEBVIEW_STRICT_COVERAGE,
+            note: "native-seam only: the published package runs unchanged and routes RNCWebView through the tenant-to-shell hosted iframe surface. coverage is generated from app-source use in six pinned applications; equal-surface strict coverage includes the shared, iOS, and Android public prop and ref surface. paired native and SootSim runtime conformance covers local HTML, base URL, URI loading, load and navigation callbacks, both injection phases, two-way messaging, imperative URI reload and injection, content scrolling, parent translation, and onOpenWindow target delivery.",
+            working: "source.uri/source.html/source.baseUrl, Chromium cross-origin URI loading under the shell COEP, same-origin URI cookies, source.html persistent localStorage, document-start ReactNativeWebView bootstrap and injectedJavaScriptBeforeContentLoaded/injectedJavaScript on source.html, strict ReactNativeWebView.postMessage bridge envelope in both directions, onMessage synthetic event with navigation fields, onOpenWindow target delivery for source.html, successful onLoad/Start/End and onNavigationStateChange, ref.reload on URI pages, ref.injectJavaScript/postMessage, internal content scrolling, renderLoading, javaScriptEnabled sandbox, layout, inherited clipping and visibility, parked/live presentation",
+            missing: "Safari/WebKit cross-origin URI pages without COEP-compatible response headers remain permanently loading because WebKit ignores iframe credentialless; Chromium credentialless cross-origin URI frames send no credentials, including cookies set by their own origin, and use ephemeral storage; iframe pixels in canvas screenshots; script injection, ReactNativeWebView bootstrap, and onOpenWindow for remote pages, which get no bridge at all because a browser cannot script a cross-origin frame; cross-origin ref.goBack/goForward/stopLoading and truthful canGoBack/canGoForward values; failed HTTP/refused navigation callbacks (onError/onHttpError and renderError); onShouldStartLoadWithRequest, allowsBackForwardNavigationGestures, userAgent, dataDetectorTypes, cacheEnabled, incognito, scalesPageToFit, originWhitelist enforcement"
           }
         ]
       },
@@ -20244,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":
@@ -20692,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,
@@ -20703,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));
 }
@@ -20925,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", () => {
@@ -20945,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(() => {
@@ -21148,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";
@@ -21159,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;
@@ -21171,6 +21197,45 @@ var init_ws_bridge = __esm({
   }
 });
 
+// src/app-url.ts
+function normalizeAppUrlTarget(target) {
+  const trimmed = target.trim();
+  if (!trimmed) {
+    throw new Error("expected <url-or-route>");
+  }
+  if (APP_URL_SCHEME_RE.test(trimmed) || trimmed.startsWith("/")) {
+    return trimmed;
+  }
+  return `/${trimmed}`;
+}
+function isAppDeepLinkTarget(target) {
+  const trimmed = target.trim();
+  if (!trimmed) return false;
+  if (trimmed.startsWith("/")) return true;
+  if (!APP_URL_SCHEME_RE.test(trimmed)) return false;
+  return !/^https?:\/\//i.test(trimmed);
+}
+async function openAppUrl(bridge, target) {
+  const normalized = normalizeAppUrlTarget(target);
+  const result = await bridge.send({
+    type: "call",
+    path: "SootSim.bridges.test.openDeepLink",
+    args: [normalized]
+  });
+  if (result !== null && typeof result === "object" && Reflect.get(result, "ok") === false) {
+    const error = Reflect.get(result, "error");
+    throw new Error(typeof error === "string" ? error : "deep-link dispatch failed");
+  }
+  return normalized;
+}
+var APP_URL_SCHEME_RE;
+var init_app_url = __esm({
+  "src/app-url.ts"() {
+    "use strict";
+    APP_URL_SCHEME_RE = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+  }
+});
+
 // src/dev-bundle-resolution.ts
 function buildUnresolvedTargetError(targetLabel) {
   return new Error(
@@ -21839,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;
@@ -22053,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
@@ -22124,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";
@@ -22182,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))
@@ -24002,7 +24065,6 @@ __export(control_exports, {
   buildShellUrl: () => buildShellUrl,
   closeSimsBulk: () => closeSimsBulk,
   ensureBridgeForOpen: () => ensureBridgeForOpen,
-  normalizeDeepLinkTarget: () => normalizeDeepLinkTarget,
   planBulkCloseTargets: () => planBulkCloseTargets,
   playwrightHostPidForSim: () => playwrightHostPidForSim,
   printConnectedSims: () => printConnectedSims,
@@ -24063,26 +24125,6 @@ function resolveDriverHeadless(args, driverId) {
 function normalizeKnownTarget(target) {
   return target.trim();
 }
-function normalizeDeepLinkTarget(target) {
-  const trimmed = target.trim();
-  if (!trimmed) {
-    throw new Error("expected <url-or-route>");
-  }
-  if (DEEP_LINK_SCHEME_RE.test(trimmed) || trimmed.startsWith("/")) {
-    return trimmed;
-  }
-  return `/${trimmed}`;
-}
-function isObjectRecord(value) {
-  return value !== null && typeof value === "object";
-}
-function shouldOpenAsDeepLink(target) {
-  const trimmed = target.trim();
-  if (!trimmed) return false;
-  if (trimmed.startsWith("/")) return true;
-  if (!DEEP_LINK_SCHEME_RE.test(trimmed)) return false;
-  return !/^https?:\/\//i.test(trimmed);
-}
 async function ensureBridgeForOpen(preferredPort, explicitPort = false) {
   const lock = readDaemonLockfile();
   assertExplicitBridgeLock(preferredPort, explicitPort, lock);
@@ -24843,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})`
@@ -24859,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();
@@ -24932,26 +24960,10 @@ async function runLinkCommand(args, opts = {}) {
     console.error("  examples: rnx open /settings  |  rnx open myapp://settings");
     process.exit(1);
   }
-  let target;
-  try {
-    target = normalizeDeepLinkTarget(parsed.positional[0] ?? "");
-  } catch (err) {
-    console.error(`  rnx open: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
-  }
   const bridge = createBridgeFromParsed(parsed);
   const simHint = parsed.simId ? ` --sim ${parsed.simId}` : "";
   try {
-    const result = await bridge.send({
-      type: "call",
-      path: "SootSim.bridges.test.openDeepLink",
-      args: [target]
-    });
-    if (isObjectRecord(result) && result.ok === false) {
-      throw new Error(
-        typeof result.error === "string" ? result.error : "deep-link dispatch failed"
-      );
-    }
+    const target = await openAppUrl(bridge, parsed.positional[0] ?? "");
     console.log(`  opened deep link: ${target}`);
   } catch (err) {
     console.error(`  link failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -25014,7 +25026,7 @@ async function runOpenCommand(args, opts = {}) {
     process.exit(1);
   }
   const target = parsed.positional[0] || "";
-  if (shouldOpenAsDeepLink(target)) {
+  if (isAppDeepLinkTarget(target)) {
     if (openInNewSim) {
       console.error(
         "  rnx open: deep links target the current app; remove --new, --profile, or --ephemeral"
@@ -25551,7 +25563,7 @@ async function runCloseCommand(args, opts = {}) {
     bridge.close();
   }
 }
-var import_node_child_process6, import_node_fs13, import_node_os3, import_node_path16, import_settings, import_ws5, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS, DEEP_LINK_SCHEME_RE;
+var import_node_child_process6, import_node_fs13, import_node_os3, import_node_path16, import_settings, import_ws5, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS;
 var init_control = __esm({
   "cli/commands/control.ts"() {
     "use strict";
@@ -25562,6 +25574,7 @@ var init_control = __esm({
     import_settings = require("sootsim-engine/settings");
     import_ws5 = require("ws");
     init_dev_server_scanner();
+    init_app_url();
     init_backend_origin();
     init_bridge_constants();
     init_config();
@@ -25598,7 +25611,6 @@ var init_control = __esm({
       photos: "/app/photos",
       camera: "/app/camera"
     };
-    DEEP_LINK_SCHEME_RE = /^[A-Za-z][A-Za-z0-9+.-]*:/;
   }
 });
 
@@ -26702,16 +26714,16 @@ __export(bridge_flow_runner_exports, {
 function sleep3(ms) {
   return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
-function isObjectRecord2(value) {
+function isObjectRecord(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function readStringKey(value, key) {
-  if (!isObjectRecord2(value)) return null;
+  if (!isObjectRecord(value)) return null;
   const raw = value[key];
   return typeof raw === "string" && raw.length > 0 ? raw : null;
 }
 function readBooleanKey(value, key) {
-  if (!isObjectRecord2(value)) return false;
+  if (!isObjectRecord(value)) return false;
   return value[key] === true;
 }
 function readRecentShellAppId(state) {
@@ -26846,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.
@@ -26854,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(
           {
@@ -26926,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) {
@@ -27960,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(
@@ -27998,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();
@@ -28013,11 +27931,10 @@ var init_bridge_flow_runner = __esm({
         );
       }
       async launchApp(opts) {
-        await this.refreshSimId();
         let hasLaunchArguments = false;
         let launchArguments;
-        if (isObjectRecord2(opts) && Object.prototype.hasOwnProperty.call(opts, "arguments")) {
-          if (!isObjectRecord2(opts.arguments)) {
+        if (isObjectRecord(opts) && Object.prototype.hasOwnProperty.call(opts, "arguments")) {
+          if (!isObjectRecord(opts.arguments)) {
             throw new Error("launchApp.arguments must be a JSON object");
           }
           hasLaunchArguments = true;
@@ -28069,7 +27986,7 @@ var init_bridge_flow_runner = __esm({
           await this.waitForTree(12e4);
           if (this.opts.onAfterLaunch) {
             try {
-              await this.opts.onAfterLaunch();
+              await this.opts.onAfterLaunch(this.opts.simId);
             } catch (err) {
               console.warn(
                 `  warn: onAfterLaunch hook threw: ${err instanceof Error ? err.message : err}`
@@ -28102,7 +28019,7 @@ var init_bridge_flow_runner = __esm({
       }
       resolveShellLaunchAppId(opts, state) {
         if (typeof opts === "string" && opts.length > 0) return opts;
-        if (isObjectRecord2(opts)) {
+        if (isObjectRecord(opts)) {
           const explicit = readStringKey(opts, "appId") || readStringKey(opts, "id");
           if (explicit) return explicit;
         }