peachsim 0.1.656 → 0.1.658

package/cli/commands/do-chain.ts

@@ -313,7 +313,7 @@ export async function runDoChain(
   const { SimPerformError } = simClientModule
   const { checkSimHealth, parseBridgeCliArgs } = bridgeModule
   const { isAgentEnv } = envModule
-  const { resolveTargetCoords } = targetModule
+  const { offscreenTargetRefusal, resolveTargetCoords } = targetModule
   const wantsJson = args.includes('--json')
   const skipSettle = args.includes('--no-wait') || process.env.PEACH_NO_AUTO_WAIT === '1'
   const parsed = parseBridgeCliArgs(args, {
@@ -355,6 +355,10 @@ export async function runDoChain(
           `do chain could not find testID ${JSON.stringify(action.id)}`,
         )
       }
+      const refusal = offscreenTargetRefusal(sim.plane, target)
+      if (refusal) {
+        throw new BridgeInputError(`do chain #${action.id}: ${refusal}`)
+      }
       steps.push(
         action.type === 'targetedDoubleTap'
           ? {

package/cli/commands/flow.ts

@@ -7,7 +7,7 @@ import { tmpdir } from 'os'
 import * as path from 'path'
 import { scanDevServers } from '../../scripts/dev-server-scanner'
 import { loadOptionalDemoApps } from '../../scripts/optional-demo-registry'
-import { applyRNXConfigToUrl, type RNXConfig } from '../../src/config'
+import { applyPeachConfigToUrl, type PeachConfig } from '../../src/config'
 import { printBridgeFailureDiagnostics } from '../bridge-diagnostics'
 import {
   SootSimBridgeFlowRunner,
@@ -176,7 +176,7 @@ export function getLastFlowTraceSteps(): SootSimFlowTraceStep[] {
 // port and runtime config into the open command.
 export async function resolveAppFrontmatterTarget(
   raw: string,
-): Promise<{ target: string; runtimeConfig?: RNXConfig }> {
+): Promise<{ target: string; runtimeConfig?: PeachConfig }> {
   if (!raw) return { target: '' }
   const trimmed = raw.trim()
   if (!trimmed) return { target: '' }
@@ -531,7 +531,7 @@ flow extension:
   }
 
   if (openTarget && targetDevice) {
-    const shellBaseUrl = applyRNXConfigToUrl(
+    const shellBaseUrl = applyPeachConfigToUrl(
       pinnedShellBaseUrl || resolveShellBaseUrlForBridgePort(parsedBridgeArgs.wsPort),
       targetAppResolution.runtimeConfig,
     )

package/cli/commands/inspect/actions.ts

@@ -1,5 +1,11 @@
 import { inspectTree, type InspectBridge } from './core'
-import { resolveTargetCoords, type ResolvedTargetCoords } from './resolve-target'
+import {
+  isOffscreen,
+  isScreenSize,
+  resolveTargetCoords,
+  UNREPORTED_SCREEN_ERROR,
+  type ResolvedTargetCoords,
+} from './resolve-target'
 import { waitForSootsimIdle } from './settling'
 import type { SimSemanticNode } from '../../../src/bridge-contract'
 import type {
@@ -39,54 +45,6 @@ export interface TapTimingOptions {
   retryWaitMs?: number
 }
 
-type ScreenSize = { width: number; height: number }
-
-function isScreenSize(value: unknown): value is ScreenSize {
-  if (value === null || typeof value !== 'object') return false
-  const width = Reflect.get(value, 'width')
-  const height = Reflect.get(value, 'height')
-  return (
-    typeof width === 'number' &&
-    Number.isFinite(width) &&
-    width > 0 &&
-    typeof height === 'number' &&
-    Number.isFinite(height) &&
-    height > 0
-  )
-}
-
-function viewportFromCapture(value: unknown): unknown {
-  if (value === null || typeof value !== 'object') return undefined
-  const tree = Reflect.get(value, 'tree')
-  return tree !== null && typeof tree === 'object'
-    ? Reflect.get(tree, 'viewport')
-    : undefined
-}
-
-// the semantic tree has no covering root, so its first node is often a 64x64
-// icon. capture.tree.viewport is the device layout size on local and cloud.
-//
-// a whole screen capture is the only way to ask for it today, and it is not
-// cheap: the headless runtime forces a full redraw of the tree before it walks
-// it, which measured 3.9-5.5s on a real app in a cloud box against 120-290ms
-// for every other command. that is why this runs on the failure path only.
-async function readScreen(bridge: InspectBridge): Promise<ScreenSize | null> {
-  try {
-    const viewport = viewportFromCapture(
-      await bridge.send({ type: 'capture', includeVisual: false }),
-    )
-    return isScreenSize(viewport)
-      ? { width: viewport.width, height: viewport.height }
-      : null
-  } catch {
-    return null
-  }
-}
-
-function isOffscreen(cx: number, cy: number, screen: ScreenSize): boolean {
-  return !(cx >= 0 && cy >= 0 && cx <= screen.width && cy <= screen.height)
-}
-
 const DEFAULT_AGENT_TIMING: Required<TapTimingOptions> = {
   initialWaitMs: 3000,
   deadlineMs: 5000,
@@ -185,19 +143,24 @@ export async function tapResolvedTarget(
 
   const deadline = Date.now() + timing.deadlineMs
   let lastOffscreenAt: string | null = null
-  // a cloud sim refuses a point outside its screen itself, and says so, so
-  // asking it for a capture first would buy nothing. every other plane still
-  // presses whatever the hit test finds at tree coordinates no finger can
-  // reach, so there the screen has to be read before dispatching.
-  const screen = bridge.plane === 'cloud' ? null : await readScreen(bridge)
   while (Date.now() <= deadline || attempts === 0) {
     attempts++
-    const resolved = await args.resolve()
+    const { screen, ...resolved } = (await args.resolve()) ?? {}
+    // a cloud sim refuses a point outside its screen itself, and says so. every
+    // other plane still presses whatever the hit test finds at tree
+    // coordinates no finger can reach, so the resolved target's screen decides
+    // before dispatching. a runtime too old to report it cannot be checked; a
+    // zero screen is one not laid out yet, so the attempt waits and retries.
+    const checksScreen = bridge.plane !== 'cloud' && typeof resolved.cx === 'number'
+    if (checksScreen && screen === undefined) {
+      throw new Error(UNREPORTED_SCREEN_ERROR)
+    }
+    const unsized = checksScreen && !isScreenSize(screen)
     const payload =
-      resolved &&
+      checksScreen &&
       typeof resolved.cx === 'number' &&
       typeof resolved.cy === 'number' &&
-      screen &&
+      isScreenSize(screen) &&
       isOffscreen(resolved.cx, resolved.cy, screen)
         ? { ...resolved, offscreen: true, screen }
         : resolved
@@ -215,7 +178,10 @@ export async function tapResolvedTarget(
       // don't dispatch a point outside the device screen: the press would do
       // nothing a user could reproduce. report the offscreen miss instead so
       // drivers scroll first rather than getting stuck trusting a phantom hit.
-      if (payload.offscreen) {
+      if (unsized) {
+        lastResult = { hit: false, reason: 'screen-not-laid-out' }
+        lastOffscreenAt = null
+      } else if (payload.offscreen) {
         lastResult = {
           hit: false,
           reason: 'offscreen',
@@ -310,6 +276,7 @@ function payloadFromResolved(
   return {
     cx: resolved.x,
     cy: resolved.y,
+    screen: resolved.viewport,
     match: {
       nodeId: match.nodeId ?? null,
       id: match.testID ?? null,
@@ -489,25 +456,14 @@ async function resolveTextTapTarget(
   if (!picked) return { matched: 0, total }
   const node = picked.node
   // keep the selected handle: re-searching its text or testID can pick a
-  // different control, including a covered tenant behind native UI.
-  const tap: unknown = await bridge.send({
-    type: 'call',
-    path: 'SootSim.bridges.test.resolveTapTarget',
-    args: [node.nodeId],
+  // different control, including a covered tenant behind native UI. resolve by
+  // node is a read, so a remote simulator's driving token can send it.
+  const resolved = await resolveTargetCoords(bridge, {
+    mode: 'node',
+    nodeId: node.nodeId,
   })
-  if (!isTapTargetInfo(tap)) return { matched: 0, total }
-  return payloadFromResolved(
-    {
-      x: tap.cx,
-      y: tap.cy,
-      nodeId: tap.target.nodeId,
-      testID: tap.target.testID,
-      text: tap.target.text ?? tap.target.accessibilityLabel,
-      type: tap.target.type,
-    },
-    node,
-    { total, idx },
-  )
+  if (!resolved) return { matched: 0, total }
+  return payloadFromResolved(resolved, node, { total, idx })
 }
 
 export type TapQuery =
@@ -567,6 +523,7 @@ export async function tapByQuery(
           testID: tap.target.testID,
           text: tap.target.text ?? tap.target.accessibilityLabel,
           type: tap.target.type,
+          viewport: tap.viewport,
         },
         {
           nodeId: node.nodeId,

package/cli/commands/inspect/resolve-target.ts

@@ -35,16 +35,69 @@ export interface ResolvedTargetCoords {
   testID?: string | null
   text?: string | null
   type?: string | null
+  // absent from runtimes older than the field; coordinate-only callers do not
+  // need it, and the tap boundary refuses to guess without it.
+  viewport?: { width: number; height: number }
+}
+
+export type ScreenSize = { width: number; height: number }
+
+// a reported screen with a zero or non-finite side has not been laid out yet.
+export function isScreenSize(value: unknown): value is ScreenSize {
+  if (value === null || typeof value !== 'object') return false
+  const width = Reflect.get(value, 'width')
+  const height = Reflect.get(value, 'height')
+  return (
+    typeof width === 'number' &&
+    Number.isFinite(width) &&
+    width > 0 &&
+    typeof height === 'number' &&
+    Number.isFinite(height) &&
+    height > 0
+  )
+}
+
+export function isOffscreen(
+  x: number,
+  y: number,
+  screen: { width: number; height: number },
+): boolean {
+  return !(x >= 0 && y >= 0 && x <= screen.width && y <= screen.height)
+}
+
+export const UNREPORTED_SCREEN_ERROR =
+  'this runtime does not report the screen size a targeted gesture needs; ' +
+  'update it with `peach runtime install`, or use coordinates'
+
+// a gesture at a resolved point outside the device screen presses whatever the
+// hit test finds where no finger can reach. a cloud sim refuses such a point
+// itself; every other plane checks here. returns the refusal, or null to send.
+export function offscreenTargetRefusal(
+  plane: InspectBridge['plane'],
+  target: ResolvedTargetCoords,
+): string | null {
+  if (plane === 'cloud') return null
+  const screen = target.viewport
+  if (!screen) return UNREPORTED_SCREEN_ERROR
+  if (!isScreenSize(screen)) {
+    return 'the screen is not laid out yet, so the target cannot be checked; run the command again'
+  }
+  if (!isOffscreen(target.x, target.y, screen)) return null
+  return `the target at (${Math.round(target.x)},${Math.round(target.y)}) is outside the ${screen.width}x${screen.height} screen; scroll it into view first`
 }
 
 export async function resolveTargetCoords(
   bridge: InspectBridge,
-  target: { mode: 'testid' | 'text'; value: string },
+  target: { mode: 'testid' | 'text'; value: string } | { mode: 'node'; nodeId: number },
 ): Promise<ResolvedTargetCoords | null> {
   const result: unknown = await bridge.send({
     type: 'resolve',
     selector:
-      target.mode === 'testid' ? { testID: target.value } : { text: target.value },
+      target.mode === 'node'
+        ? { nodeId: target.nodeId }
+        : target.mode === 'testid'
+          ? { testID: target.value }
+          : { text: target.value },
   })
   if (result === null) return null
   if (typeof result !== 'object') throw new Error('resolve returned an invalid result')
@@ -52,6 +105,15 @@ export async function resolveTargetCoords(
   const resolvedTarget = Reflect.get(result, 'target')
   const semanticNodes = [match, resolvedTarget]
   const point = Reflect.get(result, 'point')
+  const viewport = Reflect.get(result, 'viewport')
+  const width =
+    viewport !== null && typeof viewport === 'object'
+      ? Reflect.get(viewport, 'width')
+      : undefined
+  const height =
+    viewport !== null && typeof viewport === 'object'
+      ? Reflect.get(viewport, 'height')
+      : undefined
   const x =
     point !== null && typeof point === 'object' ? Reflect.get(point, 'x') : undefined
   const y =
@@ -75,5 +137,8 @@ export async function resolveTargetCoords(
     text:
       semanticMatch.text ?? (target.mode === 'text' ? target.value : semanticMatch.label),
     type: semanticMatch.type,
+    ...(typeof width === 'number' && typeof height === 'number'
+      ? { viewport: { width, height } }
+      : {}),
   }
 }

package/cli/commands/inspect.ts

@@ -75,7 +75,11 @@ import {
   redactKeyboardStateForOutput,
   redactTextForKeyboardState,
 } from './inspect/redaction'
-import { readTargetFlag, resolveTargetCoords } from './inspect/resolve-target'
+import {
+  offscreenTargetRefusal,
+  readTargetFlag,
+  resolveTargetCoords,
+} from './inspect/resolve-target'
 import { runScreensSubcommand } from './inspect/screens'
 import { runSettleSubcommand } from './inspect/settle'
 import { waitForSootsimIdle } from './inspect/settling'
@@ -2006,6 +2010,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
               return {
                 cx: resolved.x,
                 cy: resolved.y,
+                screen: resolved.viewport,
                 match: {
                   nodeId: resolved.nodeId,
                   testID:
@@ -2798,6 +2803,11 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             await reportMissingTarget(bridge, 'double-tap', target)
             rnxExit(1)
           }
+          const refusal = offscreenTargetRefusal(bridge.plane, resolved)
+          if (refusal) {
+            console.error(`  double-tap: ${refusal}`)
+            rnxExit(1)
+          }
           x = resolved.x
           y = resolved.y
         }
@@ -2838,6 +2848,11 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             await reportMissingTarget(bridge, 'long-press', target)
             rnxExit(1)
           }
+          const refusal = offscreenTargetRefusal(bridge.plane, resolved)
+          if (refusal) {
+            console.error(`  long-press: ${refusal}`)
+            rnxExit(1)
+          }
           x = resolved.x
           y = resolved.y
           resolvedTarget = {

package/cli/drivers/playwright-provisioning.ts

@@ -161,6 +161,8 @@ export function ensurePlaywrightBrowser(
   const before = probeBrowser(resolved, probeEnv)
   if (!before.ok) return before
   if (before.exists) {
+    const missing = missingLibrariesMessage(before.executablePath, browser)
+    if (missing) return { ok: false, message: missing }
     return { ok: true, executablePath: before.executablePath, installed: false }
   }
 
@@ -209,5 +211,98 @@ export function ensurePlaywrightBrowser(
         `${browser} executable is still missing at ${after.executablePath}`,
     }
   }
+  const missing = missingLibrariesMessage(after.executablePath, browser)
+  if (missing) return { ok: false, message: missing }
   return { ok: true, executablePath: after.executablePath, installed: true }
 }
+
+// the debian package providing each shared library chromium and its headless
+// shell link (readelf NEEDED, linux x64 and arm64), apart from glibc's own.
+const LIBRARY_PACKAGES: Record<string, string> = {
+  'libasound.so.2': 'libasound2',
+  'libatk-1.0.so.0': 'libatk1.0-0',
+  'libatk-bridge-2.0.so.0': 'libatk-bridge2.0-0',
+  'libatspi.so.0': 'libatspi2.0-0',
+  'libcairo.so.2': 'libcairo2',
+  'libcups.so.2': 'libcups2',
+  'libdbus-1.so.3': 'libdbus-1-3',
+  'libexpat.so.1': 'libexpat1',
+  'libgbm.so.1': 'libgbm1',
+  'libgio-2.0.so.0': 'libglib2.0-0',
+  'libglib-2.0.so.0': 'libglib2.0-0',
+  'libgobject-2.0.so.0': 'libglib2.0-0',
+  'libnspr4.so': 'libnspr4',
+  'libnss3.so': 'libnss3',
+  'libnssutil3.so': 'libnss3',
+  'libpango-1.0.so.0': 'libpango-1.0-0',
+  'libsmime3.so': 'libnss3',
+  'libudev.so.1': 'libudev1',
+  'libX11.so.6': 'libx11-6',
+  'libxcb.so.1': 'libxcb1',
+  'libXcomposite.so.1': 'libxcomposite1',
+  'libXdamage.so.1': 'libxdamage1',
+  'libXext.so.6': 'libxext6',
+  'libXfixes.so.3': 'libxfixes3',
+  'libxkbcommon.so.0': 'libxkbcommon0',
+  'libXrandr.so.2': 'libxrandr2',
+}
+
+// packages renamed by the 64-bit time_t transition in ubuntu 24.04 and debian 13.
+const TIME64_PACKAGES = new Set([
+  'libasound2',
+  'libatk1.0-0',
+  'libatk-bridge2.0-0',
+  'libatspi2.0-0',
+  'libcups2',
+  'libglib2.0-0',
+])
+
+function isTime64Distro(): boolean {
+  if (!existsSync('/etc/os-release')) return false
+  const fields = Object.fromEntries(
+    readFileSync('/etc/os-release', 'utf8')
+      .split('\n')
+      .map((line) => line.match(/^(\w+)="?([^"]*)"?$/))
+      .filter((match) => match !== null)
+      .map((match) => [match[1], match[2]]),
+  )
+  const version = Number.parseFloat(fields.VERSION_ID ?? '')
+  return (
+    (fields.ID === 'ubuntu' && version >= 24.04) ||
+    (fields.ID === 'debian' && version >= 13)
+  )
+}
+
+/** a linux browser whose shared libraries are missing exits 127 before
+ *  playwright can say why, so name them and their packages up front, as
+ *  playwright's own host validation does. */
+function missingLibrariesMessage(executablePath: string, browser: string): string | null {
+  if (process.platform !== 'linux') return null
+  const ldd = spawnSync('ldd', [executablePath], { encoding: 'utf8', timeout: 30_000 })
+  const libraries = [...(ldd.stdout ?? '').matchAll(/^\s*(\S+) => not found$/gm)].map(
+    (match) => match[1]!,
+  )
+  if (!libraries.length) return null
+  const time64 = isTime64Distro()
+  const packages = new Set<string>()
+  const unknown: string[] = []
+  for (const library of libraries) {
+    const name = LIBRARY_PACKAGES[library]
+    if (!name) unknown.push(library)
+    else packages.add(time64 && TIME64_PACKAGES.has(name) ? `${name}t64` : name)
+  }
+  const sudo = process.getuid?.() === 0 ? '' : 'sudo '
+  return [
+    `${browser} at ${executablePath} cannot start: this system is missing shared libraries it links (${libraries.join(', ')}).`,
+    ...(packages.size
+      ? [
+          'On Debian or Ubuntu, install them and run the command again:',
+          '',
+          `    ${sudo}apt-get update && ${sudo}apt-get install -y --no-install-recommends ${[...packages].join(' ')}`,
+        ]
+      : []),
+    ...(unknown.length
+      ? ['', `No known Debian package provides: ${unknown.join(', ')}`]
+      : []),
+  ].join('\n')
+}

package/cli/ws-bridge.ts

@@ -24,7 +24,6 @@ import {
 } from '../src/home-paths'
 import { createCloudBridgeForParsed } from './cloud-client'
 import {
-  clearCurrentSimId,
   getCliIdentity,
   readCurrentSim,
   readCurrentSimId,
@@ -825,13 +824,14 @@ export function createBridge(wsPort: number, opts: WsBridgeOptions = {}): WsBrid
             )
             return sendOnce(successor)
           }
-          clearCurrentSimId()
-          // the saved sim is gone and nothing proves what replaced it. fail
-          // closed instead of driving whichever sim is primary; that is how
-          // agents end up recording the wrong app.
+          // the saved sim is not connected and nothing proves what replaced
+          // it. fail closed instead of driving whichever sim is primary; that
+          // is how agents end up recording the wrong app. the pin stays: a
+          // page whose socket dropped reconnects under the same id, and
+          // clearing the pin then would hand every later command to primary.
           throw new Error(
-            `saved sim ${sentSimId} is gone${message.slice(missingSimMessage.length)}; ` +
-              'run `peach list` and ' +
+            `saved sim ${sentSimId} is not connected${message.slice(missingSimMessage.length)}; ` +
+              'commands resume when it reconnects, or run `peach list` and ' +
               `\`peach use <sim>\`, or open a fresh sim`,
           )
         }

package/detox/config-loader.ts

@@ -121,7 +121,7 @@ export function mapDetoxDevice(config: DetoxConfig | null): string {
 }
 
 // generate a sootsim-compatible config from detox config
-export function toRNXConfig(
+export function toPeachConfig(
   projectDir: string,
   config: DetoxConfig | null,
 ): SootSimDetoxConfig {

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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;
@@ -358,6 +358,14 @@ function semanticResolveSelector(value, path) {
   return validationFailure(path, "must select testID or text");
 }
 function parseSemanticResolveSelector(value) {
+  const selector = recordValue(value, "selector");
+  if (selector.nodeId !== void 0) {
+    const nodeId = numberValue(selector.nodeId, "selector.nodeId");
+    if (!Number.isSafeInteger(nodeId)) {
+      return validationFailure("selector.nodeId", "must be an integer");
+    }
+    return { nodeId };
+  }
   return semanticResolveSelector(value, "selector");
 }
 function parseSemanticWaitOptions(value) {

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_MAX_MS = 5e3;
@@ -322,6 +322,14 @@ function semanticResolveSelector(value, path) {
   return validationFailure(path, "must select testID or text");
 }
 function parseSemanticResolveSelector(value) {
+  const selector = recordValue(value, "selector");
+  if (selector.nodeId !== void 0) {
+    const nodeId = numberValue(selector.nodeId, "selector.nodeId");
+    if (!Number.isSafeInteger(nodeId)) {
+      return validationFailure("selector.nodeId", "must be an integer");
+    }
+    return { nodeId };
+  }
   return semanticResolveSelector(value, "selector");
 }
 function parseSemanticWaitOptions(value) {

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var REFUSED_PERFORM_STEP_TYPES = [

package/dist-lib/capture-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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.656 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (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;