rnxsim 0.1.487 → 0.1.488

package/cli/outbound-endpoints.ts

@@ -485,7 +485,7 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     count: 1,
   },
   // the inventory records the call expression, not the URL, so this entry can
-  // no longer show its own destination. bridgeWsUrl() is localhost-only today;
+  // no longer show its own destination. bridgeWsUrl() is loopback-only today;
   // when a cloud box makes it return a remote wss:// endpoint, that egress
   // would land under this same local_development entry and go unnoticed. split
   // the declaration then, rather than letting one line cover both.
@@ -497,7 +497,7 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     category: 'local_development',
     count: 1,
   },
-  'packages/sootsim/src/agent-daemon-client.ts :: websocket :: `ws://localhost:${this.port}`':
+  'packages/sootsim/src/agent-daemon-client.ts :: websocket :: `ws://127.0.0.1:${this.port}`':
     { category: 'local_development', count: 1 },
   "packages/sootsim/src/auth/shared-session.ts :: fetch :: `${origin.replace(/\\/$/, '')}/api/auth/me`":
     { category: 'contrast_user_action', count: 1 },

package/cli/ws-bridge.ts

@@ -75,7 +75,7 @@ export function resolvePlacement(): RnxPlacement {
  *  this function. a cloud endpoint added here must get its own declaration in
  *  `outbound-endpoints.ts` instead of inheriting the local_development one. */
 export function bridgeWsUrl(wsPort: number): string {
-  return `ws://localhost:${wsPort}`
+  return `ws://127.0.0.1:${wsPort}`
 }
 
 // resolved once per CLI process so a multi-step command keeps one world for

package/detox/index.ts

@@ -801,6 +801,102 @@ async function dispatchStatusBarOverride(config: StatusBarConfig) {
   await page.waitForTimeout(50)
 }
 
+const MAX_SETTLED_SPEED_PT_PER_SEC = 2.0
+
+async function waitForFrameClock(page: Page, minMs = 25): Promise<void> {
+  const start = performance.now()
+  await page.evaluate(
+    () =>
+      new Promise<void>((resolve) => {
+        const timeoutId = setTimeout(() => resolve(), 50)
+        requestAnimationFrame(() => {
+          clearTimeout(timeoutId)
+          resolve()
+        })
+      }),
+  )
+  const elapsed = performance.now() - start
+  if (elapsed < minMs) {
+    await page.waitForTimeout(minMs - elapsed)
+  }
+}
+
+async function findStableNodeByMatcher(
+  matcher: Matcher,
+  action = 'tap',
+  maxWaitMs = 1500,
+): Promise<any> {
+  const page = getPage()
+  const start = performance.now()
+  let lastPos: { x: number; y: number } | null = null
+  let lastTime: number | null = null
+  let lastRate: { vx: number; vy: number; speed: number } | null = null
+  let sampleCount = 0
+  let stablePolls = 0
+  const requiredStable = 2
+  let hadNumericLayout = false
+  let disappearedMidWait = false
+
+  while (performance.now() - start < maxWaitMs) {
+    const node = await findNodeByMatcher(matcher)
+    if (!node) {
+      if (hadNumericLayout) {
+        disappearedMidWait = true
+      } else {
+        return null
+      }
+    } else {
+      disappearedMidWait = false
+      const pos = node.absolutePosition ?? node.layout
+      if (pos && typeof pos.x === 'number' && typeof pos.y === 'number') {
+        hadNumericLayout = true
+        sampleCount++
+        const now = performance.now()
+        if (lastPos && lastTime !== null) {
+          const dtSec = (now - lastTime) / 1000
+          if (dtSec > 0.005) {
+            const vx = Math.abs(pos.x - lastPos.x) / dtSec
+            const vy = Math.abs(pos.y - lastPos.y) / dtSec
+            const speed = Math.sqrt(vx * vx + vy * vy)
+            lastRate = { vx, vy, speed }
+            if (speed < MAX_SETTLED_SPEED_PT_PER_SEC) {
+              stablePolls++
+              if (stablePolls >= requiredStable) {
+                return node
+              }
+            } else {
+              stablePolls = 0
+            }
+          }
+        }
+        lastPos = { x: pos.x, y: pos.y }
+        lastTime = now
+      }
+    }
+    await waitForFrameClock(page, 25)
+  }
+
+  const elapsed = Math.round(performance.now() - start)
+  if (disappearedMidWait) {
+    throw new Error(
+      `element disappeared while waiting to come to rest for ${action}: ${JSON.stringify(matcher)} after ${elapsed}ms`,
+    )
+  }
+  if (!hadNumericLayout) {
+    throw new Error(
+      `element layout is not available for ${action}: ${JSON.stringify(matcher)} after ${elapsed}ms`,
+    )
+  }
+  if (sampleCount < 2 || lastRate === null) {
+    throw new Error(
+      `element did not come to rest for ${action}: ${JSON.stringify(matcher)}; only one sample obtained after ${elapsed}ms`,
+    )
+  }
+  throw new Error(
+    `element did not come to rest for ${action}: ${JSON.stringify(matcher)}; still moving ${lastRate.vx.toFixed(1)} points/sec x / ${lastRate.vy.toFixed(1)} points/sec y after ${elapsed}ms`,
+  )
+}
+
 function createSootSimElement(matcher: Matcher): SootSimElement {
   const el: SootSimElement = {
     _matcher: matcher,
@@ -808,7 +904,7 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
     async tap(point) {
       const page = getPage()
       await waitForSootsimWorkletsIdle(page, 3000)
-      const node = await findNodeByMatcher(matcher)
+      const node = await findStableNodeByMatcher(matcher, 'tap')
       if (!node) throw new Error(`element not found for tap: ${JSON.stringify(matcher)}`)
       if (!isNodeVisible(node)) {
         throw new Error(
@@ -837,7 +933,7 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       // center with a small inter-tap pause that stays inside RNGH's
       // default maxDelay window of 200ms.
       const page = getPage()
-      const node = await findNodeByMatcher(matcher)
+      const node = await findStableNodeByMatcher(matcher, 'multiTap')
       if (!node)
         throw new Error(`element not found for multiTap: ${JSON.stringify(matcher)}`)
       if (!isNodeVisible(node)) {
@@ -867,7 +963,7 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       durationArg = 1000,
     ) {
       const page = getPage()
-      const node = await findNodeByMatcher(matcher)
+      const node = await findStableNodeByMatcher(matcher, 'longPress')
       if (!node)
         throw new Error(`element not found for longPress: ${JSON.stringify(matcher)}`)
       if (!isNodeVisible(node)) {
@@ -911,12 +1007,15 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
     ) {
       const page = getPage()
       // resolve source element
-      const srcNode = await findNodeByMatcher(matcher)
+      const srcNode = await findStableNodeByMatcher(matcher, 'longPressAndDrag')
       if (!srcNode)
         throw new Error(`source element not found: ${JSON.stringify(matcher)}`)
 
       // resolve target element
-      const tgtNode = await findNodeByMatcher(targetElement._matcher)
+      const tgtNode = await findStableNodeByMatcher(
+        targetElement._matcher,
+        'longPressAndDrag',
+      )
       if (!tgtNode)
         throw new Error(
           `target element not found: ${JSON.stringify(targetElement._matcher)}`,
@@ -1098,7 +1197,7 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       normalizedStartingPointX = 0.5,
       normalizedStartingPointY = 0.5,
     ) {
-      const node = await findNodeByMatcher(matcher)
+      const node = await findStableNodeByMatcher(matcher, 'swipe')
       if (!node)
         throw new Error(`element not found for swipe: ${JSON.stringify(matcher)}`)
 
@@ -1172,7 +1271,7 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
         throw new Error(`picker value must be a string, got ${typeof value}`)
       }
 
-      const picker = await findNodeByMatcher(matcher)
+      const picker = await findStableNodeByMatcher(matcher, 'setColumnToValue')
       if (!picker) {
         throw new Error(
           `element not found for setColumnToValue: ${JSON.stringify(matcher)}`,
@@ -1249,7 +1348,7 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       // velocity tracking sees a realistic delta. angle (radians) tilts the
       // pinch axis off horizontal — matches Detox's third arg.
       const page = getPage()
-      const node = await findNodeByMatcher(matcher)
+      const node = await findStableNodeByMatcher(matcher, 'pinch')
       if (!node)
         throw new Error(`element not found for pinch: ${JSON.stringify(matcher)}`)
       if (!node.nativePinchEnabled) {
@@ -1284,7 +1383,7 @@ function createSootSimElement(matcher: Matcher): SootSimElement {
       // sign (its 'rotation' delta is positive for a counter-clockwise
       // motion of the rear finger relative to the front finger).
       const page = getPage()
-      const node = await findNodeByMatcher(matcher)
+      const node = await findStableNodeByMatcher(matcher, 'rotate')
       if (!node)
         throw new Error(`element not found for rotate: ${JSON.stringify(matcher)}`)
       await waitForSootsimGestureHandler(page, node.nodeId, 'RotationGestureHandler')

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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;
@@ -241,7 +241,7 @@ var AgentDaemonClient = class {
   constructor(opts = {}) {
     this.port = opts.port ?? DEFAULT_SOOTSIM_BRIDGE_PORT;
     this.commandTimeoutMs = opts.commandTimeoutMs ?? 15e3;
-    this.ws = new import_ws.WebSocket(`ws://localhost:${this.port}`);
+    this.ws = new import_ws.WebSocket(`ws://127.0.0.1:${this.port}`);
     this.ready = new Promise((resolve, reject) => {
       const onOpen = () => {
         this.ws.off("error", onError);

package/dist-lib/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/agent-identity.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/beta.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/beta.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;
@@ -136,7 +136,7 @@ function resolveSootsimWebSocketProxyUrl(input) {
 }
 function resolveSootsimBridgeWebSocketUrl(input) {
   return resolveSootsimWebSocketProxyUrl({
-    targetUrl: `ws://localhost:${input.bridgePort}`,
+    targetUrl: `ws://127.0.0.1:${input.bridgePort}`,
     href: input.href
   });
 }

package/dist-lib/bridge-contract-input.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/bridge-contract-input.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_MAX_MS = 5e3;

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/bridge-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_DEFAULT_MS = 500;

package/dist-lib/capture-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/capture-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/capture-contract.ts
 var RNX_SCREEN_CAPTURE_VERSION = 1;

package/dist-lib/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/cloud-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/cloud-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/cloud-contract.ts
 var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;

package/dist-lib/cloud.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/cloud.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist-lib/config.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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;
@@ -2448,13 +2448,99 @@ async function dispatchStatusBarOverride(config) {
   );
   await page.waitForTimeout(50);
 }
+var MAX_SETTLED_SPEED_PT_PER_SEC = 2;
+async function waitForFrameClock(page, minMs = 25) {
+  const start = performance.now();
+  await page.evaluate(
+    () => new Promise((resolve) => {
+      const timeoutId = setTimeout(() => resolve(), 50);
+      requestAnimationFrame(() => {
+        clearTimeout(timeoutId);
+        resolve();
+      });
+    })
+  );
+  const elapsed = performance.now() - start;
+  if (elapsed < minMs) {
+    await page.waitForTimeout(minMs - elapsed);
+  }
+}
+async function findStableNodeByMatcher(matcher, action = "tap", maxWaitMs = 1500) {
+  const page = getPage();
+  const start = performance.now();
+  let lastPos = null;
+  let lastTime = null;
+  let lastRate = null;
+  let sampleCount = 0;
+  let stablePolls = 0;
+  const requiredStable = 2;
+  let hadNumericLayout = false;
+  let disappearedMidWait = false;
+  while (performance.now() - start < maxWaitMs) {
+    const node = await findNodeByMatcher(matcher);
+    if (!node) {
+      if (hadNumericLayout) {
+        disappearedMidWait = true;
+      } else {
+        return null;
+      }
+    } else {
+      disappearedMidWait = false;
+      const pos = node.absolutePosition ?? node.layout;
+      if (pos && typeof pos.x === "number" && typeof pos.y === "number") {
+        hadNumericLayout = true;
+        sampleCount++;
+        const now = performance.now();
+        if (lastPos && lastTime !== null) {
+          const dtSec = (now - lastTime) / 1e3;
+          if (dtSec > 5e-3) {
+            const vx = Math.abs(pos.x - lastPos.x) / dtSec;
+            const vy = Math.abs(pos.y - lastPos.y) / dtSec;
+            const speed = Math.sqrt(vx * vx + vy * vy);
+            lastRate = { vx, vy, speed };
+            if (speed < MAX_SETTLED_SPEED_PT_PER_SEC) {
+              stablePolls++;
+              if (stablePolls >= requiredStable) {
+                return node;
+              }
+            } else {
+              stablePolls = 0;
+            }
+          }
+        }
+        lastPos = { x: pos.x, y: pos.y };
+        lastTime = now;
+      }
+    }
+    await waitForFrameClock(page, 25);
+  }
+  const elapsed = Math.round(performance.now() - start);
+  if (disappearedMidWait) {
+    throw new Error(
+      `element disappeared while waiting to come to rest for ${action}: ${JSON.stringify(matcher)} after ${elapsed}ms`
+    );
+  }
+  if (!hadNumericLayout) {
+    throw new Error(
+      `element layout is not available for ${action}: ${JSON.stringify(matcher)} after ${elapsed}ms`
+    );
+  }
+  if (sampleCount < 2 || lastRate === null) {
+    throw new Error(
+      `element did not come to rest for ${action}: ${JSON.stringify(matcher)}; only one sample obtained after ${elapsed}ms`
+    );
+  }
+  throw new Error(
+    `element did not come to rest for ${action}: ${JSON.stringify(matcher)}; still moving ${lastRate.vx.toFixed(1)} points/sec x / ${lastRate.vy.toFixed(1)} points/sec y after ${elapsed}ms`
+  );
+}
 function createSootSimElement(matcher) {
   const el = {
     _matcher: matcher,
     async tap(point) {
       const page = getPage();
       await waitForSootsimWorkletsIdle(page, 3e3);
-      const node = await findNodeByMatcher(matcher);
+      const node = await findStableNodeByMatcher(matcher, "tap");
       if (!node) throw new Error(`element not found for tap: ${JSON.stringify(matcher)}`);
       if (!isNodeVisible(node)) {
         throw new Error(
@@ -2471,7 +2557,7 @@ function createSootSimElement(matcher) {
     },
     async multiTap(times) {
       const page = getPage();
-      const node = await findNodeByMatcher(matcher);
+      const node = await findStableNodeByMatcher(matcher, "multiTap");
       if (!node)
         throw new Error(`element not found for multiTap: ${JSON.stringify(matcher)}`);
       if (!isNodeVisible(node)) {
@@ -2496,7 +2582,7 @@ function createSootSimElement(matcher) {
     // where the point is relative to the element's origin
     async longPress(pointOrDuration, durationArg = 1e3) {
       const page = getPage();
-      const node = await findNodeByMatcher(matcher);
+      const node = await findStableNodeByMatcher(matcher, "longPress");
       if (!node)
         throw new Error(`element not found for longPress: ${JSON.stringify(matcher)}`);
       if (!isNodeVisible(node)) {
@@ -2526,10 +2612,13 @@ function createSootSimElement(matcher) {
     },
     async longPressAndDrag(duration, normalizedStartX, normalizedStartY, targetElement, normalizedEndX, normalizedEndY, speed = "fast", holdDuration = 0) {
       const page = getPage();
-      const srcNode = await findNodeByMatcher(matcher);
+      const srcNode = await findStableNodeByMatcher(matcher, "longPressAndDrag");
       if (!srcNode)
         throw new Error(`source element not found: ${JSON.stringify(matcher)}`);
-      const tgtNode = await findNodeByMatcher(targetElement._matcher);
+      const tgtNode = await findStableNodeByMatcher(
+        targetElement._matcher,
+        "longPressAndDrag"
+      );
       if (!tgtNode)
         throw new Error(
           `target element not found: ${JSON.stringify(targetElement._matcher)}`
@@ -2651,7 +2740,7 @@ function createSootSimElement(matcher) {
       }
     },
     async swipe(direction, speed = "fast", percentage = 0.75, normalizedStartingPointX = 0.5, normalizedStartingPointY = 0.5) {
-      const node = await findNodeByMatcher(matcher);
+      const node = await findStableNodeByMatcher(matcher, "swipe");
       if (!node)
         throw new Error(`element not found for swipe: ${JSON.stringify(matcher)}`);
       const page = getPage();
@@ -2704,7 +2793,7 @@ function createSootSimElement(matcher) {
       if (typeof value !== "string") {
         throw new Error(`picker value must be a string, got ${typeof value}`);
       }
-      const picker = await findNodeByMatcher(matcher);
+      const picker = await findStableNodeByMatcher(matcher, "setColumnToValue");
       if (!picker) {
         throw new Error(
           `element not found for setColumnToValue: ${JSON.stringify(matcher)}`
@@ -2760,7 +2849,7 @@ function createSootSimElement(matcher) {
     },
     async pinch(scale, speed = "fast", angle = 0) {
       const page = getPage();
-      const node = await findNodeByMatcher(matcher);
+      const node = await findStableNodeByMatcher(matcher, "pinch");
       if (!node)
         throw new Error(`element not found for pinch: ${JSON.stringify(matcher)}`);
       if (!node.nativePinchEnabled) {
@@ -2789,7 +2878,7 @@ function createSootSimElement(matcher) {
     },
     async rotate(radians, speed = "fast") {
       const page = getPage();
-      const node = await findNodeByMatcher(matcher);
+      const node = await findStableNodeByMatcher(matcher, "rotate");
       if (!node)
         throw new Error(`element not found for rotate: ${JSON.stringify(matcher)}`);
       await waitForSootsimGestureHandler(page, node.nodeId, "RotationGestureHandler");

package/dist-lib/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/home-paths.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/host/bridge-host.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/host/fetch-proxy-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/host/fetch-proxy-overrides.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/host/fetch-proxy-overrides.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/host/fetch-proxy-overrides.ts
 var FETCH_PROXY_BROWSER_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36";

package/dist-lib/host/replacement-module-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/host/websocket-proxy.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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;
@@ -904,7 +904,7 @@ var DEFAULT_SOOTSIM_SHELL_URL = "http://localhost:5173/";
 
 // cli/ws-bridge.ts
 function bridgeWsUrl(wsPort) {
-  return `ws://localhost:${wsPort}`;
+  return `ws://127.0.0.1:${wsPort}`;
 }
 var resolvedWorld = null;
 function liveDevBridgeLockfiles() {

package/dist-lib/jump-to-source-babel.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/jump-to-source-native.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/menu.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/menu.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/public-brand.ts
 var name = "rnx";

package/dist-lib/metro-fingerprint-registry.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/metro-fingerprint-registry.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-fingerprint-registry.ts
 var RNX_METRO_FINGERPRINT_SCHEMA_VERSION = 2;

package/dist-lib/metro-production-bundle.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/metro-production-bundle.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-production-bundle.ts
 var RNXSIM_METRO_MODULE_PATHS_PREFIX = "globalThis.__sootsimModulePaths=";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/public-brand.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/react-native-host-modules.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/react-native-host-modules.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/react-native-host-modules.ts
 var REACT_NATIVE_PASSTHROUGH_SPECIFIERS = [

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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 __defProp = Object.defineProperty;

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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;
@@ -19233,7 +19233,7 @@ function resolveSootsimWebSocketProxyUrl(input) {
 }
 function resolveSootsimBridgeWebSocketUrl(input) {
   return resolveSootsimWebSocketProxyUrl({
-    targetUrl: `ws://localhost:${input.bridgePort}`,
+    targetUrl: `ws://127.0.0.1:${input.bridgePort}`,
     href: input.href
   });
 }
@@ -30949,7 +30949,7 @@ function resolvePlacement() {
   return process.env[RNX_PLACEMENT_ENV] === "local-box" ? "local-box" : "host";
 }
 function bridgeWsUrl(wsPort) {
-  return `ws://localhost:${wsPort}`;
+  return `ws://127.0.0.1:${wsPort}`;
 }
 function liveDevBridgeLockfiles() {
   return readDevBridgeLockfiles().filter((lockfile) => isDevBridgeLockfileFresh(lockfile));

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.487 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.488 | (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.487",
+  "version": "0.1.488",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for rnx.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/src/agent-daemon-client.ts

@@ -95,7 +95,7 @@ export class AgentDaemonClient {
   constructor(opts: AgentDaemonClientOptions = {}) {
     this.port = opts.port ?? DEFAULT_SOOTSIM_BRIDGE_PORT
     this.commandTimeoutMs = opts.commandTimeoutMs ?? 15_000
-    this.ws = new WebSocket(`ws://localhost:${this.port}`)
+    this.ws = new WebSocket(`ws://127.0.0.1:${this.port}`)
     this.ready = new Promise<void>((resolve, reject) => {
       const onOpen = () => {
         this.ws.off('error', onError)

package/src/bridge-constants.ts

@@ -148,8 +148,13 @@ export function resolveSootsimBridgeWebSocketUrl(input: {
   bridgePort: number
   href: string
 }): string {
+  // 127.0.0.1, not localhost. the daemon binds ipv4 only (bridge-host bindOnce)
+  // so that localhost's ::1/127.0.0.1 coinflip cannot hide it; the health probe
+  // already talks to 127.0.0.1. targeting localhost here undoes that: when node
+  // tries ::1 first and does not fall back, vite's proxy answers 502 and the
+  // browser logs a console error that fails e2e.
   return resolveSootsimWebSocketProxyUrl({
-    targetUrl: `ws://localhost:${input.bridgePort}`,
+    targetUrl: `ws://127.0.0.1:${input.bridgePort}`,
     href: input.href,
   })
 }