rnxsim 0.1.370 → 0.1.372

package/cli/commands/box/search-command.ts

@@ -0,0 +1,157 @@
+// `rg` inside a local box, run by git rather than by a JavaScript matcher.
+//
+// just-bash implements rg in JavaScript and reads every file body through the
+// plane, so one search of this repo is ~15,000 plane reads. MEASURED in the box
+// shell: 14,093ms and two lines of output, which are its abort message. It does
+// not return results at all, and searching is the most common thing an agent
+// does, so that is the box being unusable on a real project.
+//
+// WHY GIT GREP AND NOT RIPGREP. The first version of this shelled out to `rg`,
+// which turned CI red: the Linux runners have no ripgrep binary, and a box that
+// depends on whatever happens to be installed on the host is not a box. Git is
+// different in kind, not degree: `CheckoutFilePlane` already REFUSES to open a
+// project that is not a git repository and runs `git ls-files` before every
+// single command, so git is a hard, already-enforced requirement. Searching
+// with it adds no dependency and cannot be absent where the box already runs.
+//
+// It also makes the file set correct BY CONSTRUCTION rather than by agreement.
+// The box indexes `git ls-files -co --exclude-standard`, tracked AND
+// untracked-not-ignored, and `git grep --untracked` applies those same rules
+// from the same tool. RAN against a checkout built to expose the difference:
+// tracked, untracked-not-ignored, a dotfile and a dotdir file all match, and
+// gitignored trees do not. Ripgrep needed the plane's path list piped into it
+// to get there, because plain `rg .` silently misses dotfiles and `rg --hidden`
+// searches .git/**.
+//
+// MEASURED on this repo, 14,949 indexed files: 391ms p50 against ripgrep's
+// 260ms and just-bash's 14,093ms. Giving up 130ms to remove a host dependency
+// and an entire class of "works on my machine" is the right trade.
+//
+// It also removes the ARG_MAX chunking the ripgrep version needed. Git walks
+// its own index, so there is one process and one exit code rather than several
+// whose "no match here" had to be merged.
+
+import { spawn } from 'node:child_process'
+import { defineCommand, type CustomCommand } from '@contrast/harness/shell'
+import { PROJECT_MOUNT } from '@contrast/harness/shell'
+
+// generous next to a 414ms p95: this bounds a wedged child, it does not cut off
+// a large search.
+const SEARCH_DEADLINE_MS = 20_000
+
+/**
+ * THE DEADLINE SETTLES THIS PROMISE ITSELF rather than only killing the child.
+ * A spawned child's answer has been observed going missing while the process
+ * stayed alive, with no one able to say which event never arrived, so nothing
+ * that waits on a child event can be trusted to settle. A timer in this process
+ * cannot be missed, so it is the authority and the kill is a side effect.
+ * See docs/testing.md.
+ */
+function runGitGrep(args: string[], cwd: string) {
+  return new Promise<{ stdout: string; stderr: string; exitCode: number }>((resolve) => {
+    const child = spawn('git', args, {
+      cwd,
+      env: process.env,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+    let stdout = ''
+    let stderr = ''
+    let settled = false
+    const finish = (exitCode: number) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      resolve({ stdout, stderr, exitCode })
+    }
+    const timer = setTimeout(() => {
+      try {
+        child.kill('SIGKILL')
+      } catch {}
+      stderr += `rg: search timed out after ${SEARCH_DEADLINE_MS}ms\n`
+      finish(2)
+    }, SEARCH_DEADLINE_MS)
+
+    child.stdout.on('data', (chunk) => {
+      stdout += String(chunk)
+    })
+    child.stderr.on('data', (chunk) => {
+      stderr += String(chunk)
+    })
+    child.once('error', (error) => {
+      stderr += `rg: ${error.message}\n`
+      finish(2)
+    })
+    child.once('close', (code) => finish(code ?? 0))
+  })
+}
+
+// the rg flags worth honouring, mapped onto git grep's spelling. anything else
+// is REFUSED BY NAME rather than dropped, because a search that silently
+// ignores `-i` returns a confidently wrong answer.
+const FLAG_MAP: Record<string, string> = {
+  '-i': '-i',
+  '--ignore-case': '-i',
+  '-l': '-l',
+  '--files-with-matches': '-l',
+  '-w': '-w',
+  '--word-regexp': '-w',
+  '-c': '-c',
+  '--count': '-c',
+  '-v': '-v',
+  '--invert-match': '-v',
+  '-F': '-F',
+  '--fixed-strings': '-F',
+}
+
+export function createSearchCommand(options: { root: string }): CustomCommand {
+  return defineCommand('rg', async (args) => {
+    const flags: string[] = []
+    const bare: string[] = []
+    for (const arg of args) {
+      if (!arg.startsWith('-')) {
+        bare.push(arg)
+        continue
+      }
+      const mapped = FLAG_MAP[arg]
+      if (!mapped) {
+        return {
+          stdout: '',
+          stderr: `rg: this box does not support ${arg}\n`,
+          exitCode: 2,
+        }
+      }
+      flags.push(mapped)
+    }
+
+    const pattern = bare.shift()
+    if (pattern === undefined) {
+      return { stdout: '', stderr: 'rg: no pattern given\n', exitCode: 2 }
+    }
+
+    // paths are project-relative to git; strip the shell's mount prefix so
+    // `rg x /project/src` and `rg x src` mean the same thing.
+    const scopes = bare.map((p) =>
+      p.startsWith(`${PROJECT_MOUNT}/`) ? p.slice(PROJECT_MOUNT.length + 1) : p,
+    )
+
+    // --untracked is what makes this the plane's set rather than git's tracked
+    // set. -E for extended regex, the closest of git's grammars to ripgrep's.
+    // -e so a pattern beginning with a dash is a pattern, not a flag.
+    const result = await runGitGrep(
+      [
+        'grep',
+        '--no-color',
+        '-n',
+        '-I',
+        '--untracked',
+        '-E',
+        ...flags,
+        '-e',
+        pattern,
+        ...(scopes.length > 0 ? ['--', ...scopes] : []),
+      ],
+      options.root,
+    )
+    return result
+  })
+}

package/cli/commands/box.ts

@@ -8,19 +8,41 @@
 
 import path from 'node:path'
 import { createInterface } from 'node:readline'
-import { createHarnessShell, HarnessProjectFs, PROJECT_MOUNT } from '@contrast/harness'
+import {
+  createHarnessShell,
+  HarnessProjectFs,
+  PROJECT_MOUNT,
+} from '@contrast/harness/shell'
 import { rnxPublicBrand } from '../../src/public-brand'
+import { authHeaderOrExit } from '../auth'
 import { findRepositoryPackageRoot } from '../setup-repository'
 import { resolvePlacement } from '../ws-bridge'
 import { CheckoutFilePlane, CheckoutRequiresGitError } from './box/checkout-plane'
+import {
+  CloudBoxError,
+  connectCloudBox,
+  createCloudBox,
+  heartbeatSession,
+  listCloudBoxes,
+  stopCloudBox,
+} from './box/cloud-box'
+import { sharePlane } from './box/plane-share'
 import { createRnxCommand } from './box/rnx-command'
+import { createSearchCommand } from './box/search-command'
+import type { HarnessShellResult } from '@contrast/harness/shell'
 
 interface BoxCommandOptions {
   port?: number
   verbose?: boolean
 }
 
-const CLOUD_SUBCOMMANDS = new Set(['create', 'ls', 'connect', 'stop', 'delete'])
+const CLOUD_SUBCOMMANDS = new Set(['connect'])
+
+// no default. a cloud box service has to be deployed before one can exist, and
+// defaulting to an origin that answers nothing would advertise a capability
+// that always fails.
+const ENDPOINT_ENV = 'RNX_BOX_ENDPOINT'
+const API_ORIGIN_ENV = 'RNX_API_ORIGIN'
 
 function usage(): void {
   const rnx = rnxPublicBrand.commandName
@@ -31,6 +53,12 @@ function usage(): void {
     ${rnx} box                     start a local box over the current checkout
     ${rnx} box create              create a cloud box and enter its shell
     ${rnx} box create --name=<n>   create a named cloud box
+    ${rnx} box create --endpoint=<url>
+                                   the box service to create it in, or set
+                                   ${ENDPOINT_ENV}
+    ${rnx} box ls                  cloud boxes running on this account
+    ${rnx} box stop --name=<n>     stop a cloud box and its billing
+    ${rnx} box delete --name=<n>   stop it and wipe its files
 
   a local box mounts this checkout at ${PROJECT_MOUNT}, gives you a shell with
   ls, cat, find, rg, sed, pipes and redirects, and registers ${rnx} itself as a
@@ -60,6 +88,11 @@ export async function runBox(
   }
 
   const subcommand = args.find((arg) => !arg.startsWith('-'))
+  if (subcommand === 'create') return runCloudBoxCreate(args, opts)
+  if (subcommand === 'stop' || subcommand === 'delete') {
+    return runCloudBoxStop(args, subcommand === 'delete')
+  }
+  if (subcommand === 'ls') return runCloudBoxList(args)
   if (subcommand !== undefined) {
     if (CLOUD_SUBCOMMANDS.has(subcommand)) {
       console.error(
@@ -78,6 +111,177 @@ export async function runBox(
   return runLocalBox(opts)
 }
 
+function flag(args: string[], name: string): string | undefined {
+  const inline = args.find((arg) => arg.startsWith(`--${name}=`))
+  if (inline) return inline.slice(name.length + 3)
+  const index = args.indexOf(`--${name}`)
+  if (index >= 0 && args[index + 1] && !args[index + 1].startsWith('-')) {
+    return args[index + 1]
+  }
+  return undefined
+}
+
+function apiOrigin(args: string[]): string {
+  return (
+    flag(args, 'api-origin') ??
+    process.env[API_ORIGIN_ENV]?.trim() ??
+    rnxPublicBrand.origin
+  )
+}
+
+function requireEndpoint(args: string[], label: string): string | null {
+  const endpoint = flag(args, 'endpoint') ?? process.env[ENDPOINT_ENV]?.trim()
+  if (endpoint) return endpoint
+  const rnx = rnxPublicBrand.commandName
+  console.error(
+    `  ${rnx} box ${label}: no cloud box service to talk to.\n` +
+      `  set ${ENDPOINT_ENV} or pass --endpoint=<url>.`,
+  )
+  return null
+}
+
+async function runCloudBoxStop(args: string[], purge: boolean): Promise<number> {
+  const rnx = rnxPublicBrand.commandName
+  const label = purge ? 'delete' : 'stop'
+  const endpoint = requireEndpoint(args, label)
+  if (!endpoint) return 1
+  const name =
+    flag(args, 'name') ?? path.basename(findRepositoryPackageRoot(process.cwd()) ?? '')
+  if (!name) {
+    console.error(`  ${rnx} box ${label}: which box? pass --name=<n>.`)
+    return 1
+  }
+  const { header } = authHeaderOrExit(`box ${label}`)
+  try {
+    const result = await stopCloudBox({
+      endpoint,
+      name,
+      apiKey: header.replace(/^Bearer /, ''),
+      purge,
+    })
+    console.log(
+      purge
+        ? `  deleted ${name}, freeing ${Number(result.freedBytes ?? 0)} bytes`
+        : `  stopped ${name}`,
+    )
+    return 0
+  } catch (error) {
+    if (error instanceof CloudBoxError) {
+      console.error(`  ${rnx} box ${label}: ${error.message}`)
+      return 1
+    }
+    throw error
+  }
+}
+
+async function runCloudBoxList(args: string[]): Promise<number> {
+  const rnx = rnxPublicBrand.commandName
+  const { header } = authHeaderOrExit('box ls')
+  try {
+    const boxes = await listCloudBoxes({
+      apiOrigin: apiOrigin(args),
+      apiKey: header.replace(/^Bearer /, ''),
+    })
+    if (boxes.length === 0) {
+      console.log(`  no cloud boxes running on this account`)
+      return 0
+    }
+    for (const box of boxes) {
+      const minutes = Math.round(box.meteredMs / 60_000)
+      console.log(`  ${box.name ?? box.id}  running ${minutes}m  since ${box.startedAt}`)
+    }
+    return 0
+  } catch (error) {
+    if (error instanceof CloudBoxError) {
+      console.error(`  ${rnx} box ls: ${error.message}`)
+      return 1
+    }
+    throw error
+  }
+}
+
+async function runCloudBoxCreate(
+  args: string[],
+  opts: BoxCommandOptions,
+): Promise<number> {
+  const rnx = rnxPublicBrand.commandName
+  const endpoint = flag(args, 'endpoint') ?? process.env[ENDPOINT_ENV]?.trim()
+  if (!endpoint) {
+    console.error(
+      `  ${rnx} box create: no cloud box service to create a box in.\n` +
+        `  set ${ENDPOINT_ENV} or pass --endpoint=<url>. \`${rnx} box\` runs the\n` +
+        `  same shell locally over this checkout.`,
+    )
+    return 1
+  }
+
+  const root = findRepositoryPackageRoot(process.cwd())
+  if (!root) {
+    console.error(
+      `  ${rnx} box create: no project here. a box is created from a checkout,\n` +
+        `  so run this inside a git repository that has a package.json.`,
+    )
+    return 1
+  }
+
+  const plane = new CheckoutFilePlane(root)
+  try {
+    await plane.refresh()
+  } catch (error) {
+    if (error instanceof CheckoutRequiresGitError) {
+      console.error(`  ${rnx} box create: ${error.message}`)
+      return 1
+    }
+    throw error
+  }
+
+  const name = flag(args, 'name') ?? path.basename(root)
+  // the ACCOUNT's key. the box service forwards it to /v1/rnx/sessions, which
+  // is what authenticates this caller, names the account, and starts the
+  // session the box is billed against.
+  const { header } = authHeaderOrExit('box create')
+  const apiKey = header.replace(/^Bearer /, '')
+
+  console.log(`  ...creating cloud box ${name}`)
+  let session: Awaited<ReturnType<typeof connectCloudBox>> | null = null
+  let heartbeat: { stop: () => void } | null = null
+  try {
+    const created = await createCloudBox({
+      endpoint,
+      name,
+      apiKey,
+      plane,
+      onProgress: opts.verbose
+        ? (seeded, total) => console.log(`  ...seeded ${seeded}/${total} files`)
+        : undefined,
+    })
+    console.log(`  ...seeded ${created.files} project files`)
+    // shown once and never stored: this process does not own a credential
+    // store, and inventing one here would be a second place secrets live.
+    console.log(`  ...box token (shown once): ${created.token}`)
+    console.log(`  ...accessing shell\n`)
+    session = await connectCloudBox({ endpoint, name, token: created.token })
+    // bank the wall clock while the shell is open. the box holds no account
+    // credential, so the client that is using it is what keeps the session
+    // alive; when this process dies the sweep closes it at the last heartbeat.
+    heartbeat = heartbeatSession({
+      apiOrigin: apiOrigin(args),
+      apiKey,
+      sessionId: created.sessionId,
+    })
+    return await repl(session, '')
+  } catch (error) {
+    if (error instanceof CloudBoxError) {
+      console.error(`  ${rnx} box create: ${error.message}`)
+      return 1
+    }
+    throw error
+  } finally {
+    heartbeat?.stop()
+    session?.close()
+  }
+}
+
 async function runLocalBox(opts: BoxCommandOptions): Promise<number> {
   // findRepositoryPackageRoot answers both halves of what a box needs: the
   // nearest package.json, and only when it sits inside a git repository. git
@@ -109,35 +313,90 @@ async function runLocalBox(opts: BoxCommandOptions): Promise<number> {
 
   const shell = createHarnessShell({
     projectFs: new HarnessProjectFs(plane),
-    commands: [createRnxCommand({ root, shellCwd: () => shell.cwd })],
+    commands: [
+      createRnxCommand({ root, shellCwd: () => shell.cwd }),
+      // overrides just-bash's JavaScript rg, which reads every file body
+      // through the plane. see search-command.ts for the numbers.
+      createSearchCommand({ root }),
+    ],
   })
 
   const relative = path.relative(root, process.cwd())
   console.log(`  ...starting local box`)
   console.log(`  ...mounting ${root} at ${PROJECT_MOUNT}`)
+
+  // authorize this checkout for the bridge daemon so a browser tab can reach
+  // this box's plane. deliberately NOT awaited: a box must not pay for a
+  // bridge that may not be there, and an older daemon never answers at all.
+  const shared = sharePlane(root, { port: opts.port })
+  // two boxes over one checkout is worth SAYING, not refusing. a person with
+  // two terminals in one project is doing something reasonable, and the plane
+  // re-reads the file list before every command, so neither box works from a
+  // stale one. what it does break is an agent mid-run, whose file set changes
+  // underneath it because something else is writing the tree. that is the wave
+  // case, and the wave's own isolation check is where a refusal belongs; this
+  // reports the fact so that check has something to refuse on.
+  void shared.settled.then((outcome) => {
+    if ('declined' in outcome) {
+      if (opts.verbose) console.log(`  ...plane not shared: ${outcome.declined}`)
+      return
+    }
+    if (outcome.holders > 1) {
+      console.error(
+        `\n  ${rnxPublicBrand.commandName} box: ${outcome.holders - 1} other box${
+          outcome.holders > 2 ? 'es are' : ' is'
+        } already open on this checkout.\n` +
+          `  writes from either land on the same files. that is fine for a person\n` +
+          `  with two terminals, and not fine for an agent, whose file set will\n` +
+          `  change underneath it mid-run.\n`,
+      )
+      return
+    }
+    if (opts.verbose) {
+      console.log(`  ...plane shared on the bridge (port ${outcome.port})`)
+    }
+  })
+
   console.log(`  ...accessing shell\n`)
   if (opts.verbose) {
     console.log(`  ${plane.index().size} project files indexed\n`)
   }
 
-  return repl(shell, plane, relative)
+  try {
+    // the checkout is shared with editors, agents, and the user's own terminal,
+    // so re-read the file set before every command rather than trusting a
+    // snapshot taken when the box started. a cloud box has no equivalent: its
+    // store is the box, and the box refreshes on its own side.
+    return await repl(shell, relative, () => plane.refresh())
+  } finally {
+    shared?.close()
+  }
+}
+
+// the REPL drives whatever holds the shell. locally that is an in-process
+// HarnessShell over this checkout; for a cloud box it is a socket to the box,
+// which holds both the files and the shell. same loop, because the only
+// difference is where exec runs.
+interface BoxSession {
+  readonly cwd: string
+  exec(command: string): Promise<HarnessShellResult>
 }
 
 async function repl(
-  shell: ReturnType<typeof createHarnessShell>,
-  plane: CheckoutFilePlane,
+  session: BoxSession,
   startRelative: string,
+  beforeCommand?: () => Promise<void>,
 ): Promise<number> {
   const rl = createInterface({ input: process.stdin, output: process.stdout })
 
   // enter where the user was standing, so `rnx box` from a subdirectory does
   // not silently teleport them to the project root.
   if (startRelative && !startRelative.startsWith('..')) {
-    await shell.exec(`cd ${JSON.stringify(startRelative)}`)
+    await session.exec(`cd ${JSON.stringify(startRelative)}`)
   }
 
   const prompt = () => {
-    rl.setPrompt(`${shell.cwd} > `)
+    rl.setPrompt(`${session.cwd} > `)
     rl.prompt()
   }
 
@@ -155,11 +414,8 @@ async function repl(
   const run = async (command: string) => {
     if (stopped) return
     try {
-      // the checkout is shared with editors, agents, and the user's own
-      // terminal, so re-read the file set before every command rather than
-      // trusting a snapshot taken when the box started.
-      await plane.refresh()
-      const result = await shell.exec(command)
+      await beforeCommand?.()
+      const result = await session.exec(command)
       if (result.text && result.text !== '(no output)') console.log(result.text)
     } catch (error) {
       console.error(error instanceof Error ? error.message : String(error))

package/cli/commands/control.ts

@@ -388,7 +388,12 @@ async function resolveConnectionInputForCli(target: string): Promise<ResolvedDev
 
   if (registeredPort && registeredPort > 0) {
     const discovered = await probePort(registeredPort)
-    if (discovered) {
+    // a provisional bundle URL means the scanner's fast manifest probe got no
+    // answer and fell back to the generic `/index.bundle`. that is enough to
+    // LIST the server and not enough to open it, so hand the question to
+    // `resolveConnectionInput`, which asks the manifest again with a budget
+    // that fits a real dev server and returns the entry point the app names.
+    if (discovered && !discovered.bundleUrlProvisional) {
       return {
         bundleUrl: discovered.bundleUrl,
         port: discovered.port,

package/cli/outbound-endpoints.ts

@@ -82,6 +82,18 @@ export const OUTBOUND_ENDPOINTS: Record<string, OutboundEndpointDeclaration> = {
     preConsent: false,
     payload: 'preview objects selected by the user for upload',
   },
+  // its own entry, deliberately not folded into contrast_user_action. this is
+  // the only egress that sends the CONTENTS of the user's project somewhere,
+  // and to an operator-chosen host rather than a Contrast one, so it must not
+  // be readable as "the usual Contrast call".
+  rnx_cloud_box: {
+    category: 'explicit-user-action',
+    destination:
+      'the RNX cloud box service named by --endpoint or RNX_BOX_ENDPOINT; no default, so this call cannot happen unless the user names a host',
+    preConsent: false,
+    payload:
+      'every file git reports for the current checkout, then shell commands and file reads and writes for as long as the box shell is open',
+  },
 }
 
 export interface OutboundCallDeclaration {
@@ -93,6 +105,30 @@ export interface OutboundCallDeclaration {
 // a new fetch, websocket, node HTTP request, or TCP connection has no entry and
 // fails the package test until its destination and consent behavior are declared.
 export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> = {
+  // `rnx box create` uploads the checkout to the box service and then talks to
+  // it. the destination is whatever the user named; there is no default.
+  'packages/sootsim/cli/commands/box/cloud-box.ts :: fetch :: endpointOf(base, name, verb)':
+    { category: 'rnx_cloud_box', count: 1 },
+  'packages/sootsim/cli/commands/box/cloud-box.ts :: websocket :: url': {
+    category: 'rnx_cloud_box',
+    count: 1,
+  },
+  // the account's own session meter: starting, listing and heartbeating the
+  // session a cloud box is billed against. no project content.
+  "packages/sootsim/cli/commands/box/cloud-box.ts :: fetch :: `${options.apiOrigin.replace(/\\/+$/, '')}/v1/rnx/sessions`":
+    { category: 'contrast_user_action', count: 1 },
+  'packages/sootsim/cli/commands/box/cloud-box.ts :: fetch :: url': {
+    category: 'contrast_user_action',
+    count: 1,
+  },
+  // a LOCAL box authorizing its own checkout with the loopback bridge daemon.
+  // this one refuses to guess a port, so it cannot reach anything but a bridge
+  // the user's own session is running; see the note on ws-bridge.ts below
+  // about splitting these if bridgeWsUrl ever returns a remote endpoint.
+  'packages/sootsim/cli/commands/box/plane-share.ts :: websocket :: bridgeWsUrl(port)': {
+    category: 'local_development',
+    count: 2,
+  },
   'packages/contrast-runtime-delivery/src/index.ts :: fetch :: url': {
     category: 'runtime_delivery',
     count: 2,
@@ -101,7 +137,7 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     category: 'local_development',
     count: 1,
   },
-  'packages/sootsim/scripts/dev-server-scanner.ts :: http.request :: { hostname, port, path, method, timeout, headers }':
+  'packages/sootsim/scripts/dev-server-scanner.ts :: http.request :: { hostname, port, path, method, headers }':
     {
       category: 'local_development',
       count: 1,

package/dist-cli/bin.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-/*! rnx v0.1.370 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.372 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 import { createRequire as __sootsimCreateRequire } from 'node:module'
 var require = __sootsimCreateRequire(import.meta.url)
-import{a as g,b as f}from"./chunks/chunk-YIZGNT7A.js";import{a as h}from"./chunks/chunk-AVJBT5LF.js";import{a as m}from"./chunks/chunk-64JAEJ6N.js";import"./chunks/chunk-I52NT6VG.js";function k(a){let t=a instanceof Error?a.message:String(a);(/^command timed out after \d+s$/.test(t)||t.startsWith("sim disconnected:")||t.startsWith("bridge never reconnected")||t.startsWith("multiple sims are connected:")||t.startsWith("saved sim ")||t.startsWith("no sim connected with id ")||t.startsWith("could not connect to ws://")||t.startsWith("rnx bridge daemon is not running")||t.startsWith("rnx bridge lockfile is fresh")||t.startsWith("rnx bridge exited before becoming ready")||t.startsWith(`${m.commandName} open: requested bridge port`)||t.startsWith("background daemon setup is unavailable")||t.startsWith("rnx bridge did not start within"))&&!process.env.SOOTSIM_VERBOSE&&(process.stderr.write(`  ${t}
+import{a as g,b as f}from"./chunks/chunk-PKY76S57.js";import{a as h}from"./chunks/chunk-YWTBN7SD.js";import{a as m}from"./chunks/chunk-MSM2E74F.js";import"./chunks/chunk-WR7LRCYW.js";function k(a){let t=a instanceof Error?a.message:String(a);(/^command timed out after \d+s$/.test(t)||t.startsWith("sim disconnected:")||t.startsWith("bridge never reconnected")||t.startsWith("multiple sims are connected:")||t.startsWith("saved sim ")||t.startsWith("no sim connected with id ")||t.startsWith("could not connect to ws://")||t.startsWith("rnx bridge daemon is not running")||t.startsWith("rnx bridge lockfile is fresh")||t.startsWith("rnx bridge exited before becoming ready")||t.startsWith(`${m.commandName} open: requested bridge port`)||t.startsWith("background daemon setup is unavailable")||t.startsWith("rnx bridge did not start within"))&&!process.env.SOOTSIM_VERBOSE&&(process.stderr.write(`  ${t}
 `),process.exit(1)),a instanceof Error&&a.stack?process.stderr.write(`${a.stack}
 `):process.stderr.write(`${t}
 `),process.exit(1)}process.on("unhandledRejection",k);process.on("uncaughtException",k);var v=typeof __SOOTSIM_STANDALONE__<"u"&&__SOOTSIM_STANDALONE__,C=new Set(["desktop"]);function $(a){!v||!C.has(a)||(process.stderr.write(`  ${m.commandName} ${a} isn't available in the standalone binary \u2014
   it needs vite / electron / playwright from a project's node_modules.
   run the npm package instead:
     ${m.commandName} ${a}
-`),process.exit(1))}var e=f(process.argv);if(!e.command&&e.commandArgs.length>0){let{resolveHiddenRuntimeAlias:a}=await import("./chunks/hidden-runtime-alias-7S2TNZXG.js");e=a(e)}var _=e.command==="cleanup"&&e.commandArgs.length===1&&e.commandArgs[0]==="--automatic-worker",x=!e.command&&e.commandArgs.length===0;if(!_&&!x&&!e.help&&!e.version&&e.command!=="config"&&e.command!=="setup"&&e.command!=="telemetry"){let{ensurePrivacyChoice:a}=await import("./chunks/privacy-MIFE72CG.js");await a({prompt:!0})}if(e.command!=="serve"&&e.command!=="daemon"){let{consumeRuntimeUpgradeNotice:a}=await import("./chunks/home-paths-LMO5LB4F.js"),t=a();t&&process.stderr.write(`  ${m.name} engine upgraded to v${t.to}`+(t.from?` (from v${t.from})`:"")+` \xB7 what's new: ${m.origin}/changelog
-`)}var b=!1;async function S(){if(!b&&(b=!0,!(e.command==="cleanup"||e.command==="serve"||e.command==="agent-wrapper"||e.command==="daemon"&&e.commandArgs[0]==="uninstall")))try{let{isAutomaticSootsimCleanupComplete:a}=await import("./chunks/disk-cleanup-BDRHX5ZG.js");if(a())return;let{spawn:t}=await import("node:child_process"),r=["cleanup","--automatic-worker"],d=process.argv[1],p=v?t(process.execPath,r,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):d?t(process.execPath,[d,...r],{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):t(m.commandName,r,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env});p.once("error",w=>{process.stderr.write(`  ${m.name} automatic cleanup will retry on the next run: ${w.message}
+`),process.exit(1))}var e=f(process.argv);if(!e.command&&e.commandArgs.length>0){let{resolveHiddenRuntimeAlias:a}=await import("./chunks/hidden-runtime-alias-7Z6PYH53.js");e=a(e)}var _=e.command==="cleanup"&&e.commandArgs.length===1&&e.commandArgs[0]==="--automatic-worker",x=!e.command&&e.commandArgs.length===0;if(!_&&!x&&!e.help&&!e.version&&e.command!=="config"&&e.command!=="setup"&&e.command!=="telemetry"){let{ensurePrivacyChoice:a}=await import("./chunks/privacy-WXGGG4ZI.js");await a({prompt:!0})}if(e.command!=="serve"&&e.command!=="daemon"){let{consumeRuntimeUpgradeNotice:a}=await import("./chunks/home-paths-MEGVA6ET.js"),t=a();t&&process.stderr.write(`  ${m.name} engine upgraded to v${t.to}`+(t.from?` (from v${t.from})`:"")+` \xB7 what's new: ${m.origin}/changelog
+`)}var b=!1;async function S(){if(!b&&(b=!0,!(e.command==="cleanup"||e.command==="serve"||e.command==="agent-wrapper"||e.command==="daemon"&&e.commandArgs[0]==="uninstall")))try{let{shouldSkipAutomaticSootsimCleanup:a}=await import("./chunks/disk-cleanup-HZM7VM4S.js");if(a())return;let{spawn:t}=await import("node:child_process"),r=["cleanup","--automatic-worker"],d=process.argv[1],p=v?t(process.execPath,r,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):d?t(process.execPath,[d,...r],{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):t(m.commandName,r,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env});p.once("error",w=>{process.stderr.write(`  ${m.name} automatic cleanup will retry on the next run: ${w.message}
 `)}),p.unref()}catch(a){process.stderr.write(`  ${m.name} automatic cleanup will retry on the next run: ${a instanceof Error?a.message:String(a)}
-`)}}async function n(a){let{flushCliTelemetry:t}=await import("./chunks/telemetry-BV6OTYPF.js");await t(),await S(),process.exit(a)}if(e.version){let{getCliVersion:a}=await import("./chunks/cli-version-MLS55UTY.js"),{IS_BETA:t,BETA_LABEL:r}=await import("./chunks/beta-FKAF6YWJ.js"),d=t?` \xB7 ${r}`:"";console.log(`${m.commandName} v${a()}${d}`);let{readActiveRuntime:p}=await import("./chunks/home-paths-LMO5LB4F.js"),w=p();console.log(w?`runtime v${w}`:"runtime not installed"),await n(0)}if(e.help&&!e.command){let{printHelp:a}=await import("./chunks/help-BYYDUSXF.js");a(),await n(0)}var o=e.globalFlags.port,c=e.verbose,u=e.globalFlags.device,l=e.globalFlags.theme,E=e.globalFlags.driver,O=e.globalFlags.headless===!0,A=e.globalFlags.sim??e.globalFlags.session??e.globalFlags.tab,i=A?["--sim",A,...e.commandArgs]:e.commandArgs;if(u||l){let{settingsStore:a}=await import("./chunks/store-HOL45WCI.js"),t={};u&&(t.deviceModel=u),l&&(t.colorScheme=l),a.apply(t)}if(!e.command&&e.commandArgs.length===0){let{runWelcome:a}=await import("./chunks/welcome-FT2AMUWW.js");await n(await a())}var s=e.command??"";if(!s){if(e.commandArgs.length>0){let t=e.commandArgs.find(r=>!r.startsWith("-"))??e.commandArgs[0];console.error(`  unknown command: ${t}`),console.error(`  run \`${m.commandName} --help\` to see the full surface.`),await n(1)}let{printHelp:a}=await import("./chunks/help-BYYDUSXF.js");a(),await n(0)}if(e.help||e.commandArgs.includes("--help")||e.commandArgs.includes("-h")){if(s==="skill"){let{runSkill:r}=await import("./chunks/skills-N4D3POIS.js");await r(e.commandArgs),await n(0)}if(s==="state"){let{runState:r}=await import("./chunks/state-ES6TFQZF.js");await n(await r(i,{port:o}))}if(s==="reset"){let{runReset:r}=await import("./chunks/reset-RZ4O5AFJ.js");await n(await r(i,{port:o}))}let a=s==="do"||s==="get"||s==="debug"||s==="shell"||s==="perf"||s==="wait",t=e.commandArgs.find(r=>!r.startsWith("-"));if(!(s==="shell"||s==="perf"))if(a&&!t){let{printGroupHelp:r}=await import("./chunks/help-BYYDUSXF.js");r(s)&&await n(0)}else{let{printCommandHelp:r}=await import("./chunks/help-BYYDUSXF.js");r(a&&t?t:s,{prefer:a&&t?"verb":"command",group:a&&t?s:void 0}),await n(0)}}$(s);try{if(g.has(s)){if(s==="do"){let{hasDoChain:t,runDoChain:r}=await import("./chunks/do-chain-RUJNRPPF.js");t(i)&&await n(await r(i,{port:o}))}let{runInspect:a}=await import("./chunks/inspect-RQCTWDCC.js");await a([s,...i],{port:o,verbose:c})}else switch(s){case"assert":{let{runAssert:a}=await import("./chunks/assert-7EZOWGYQ.js");await a(e.commandArgs);break}case"detox":{let{runDetox:a}=await import("./chunks/detox-WJGQP5TM.js");await a(e.commandArgs,{port:o,verbose:c});break}case"maestro":{let{runMaestro:a}=await import("./chunks/maestro-TYBQYOGB.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"record":{let{runRecord:a}=await import("./chunks/record-EK3ETFHZ.js");await a(i,{port:o,verbose:c});break}case"film":{let{runFilm:a}=await import("./chunks/film-XC6UAQ3V.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"storage":{let{runStorage:a}=await import("./chunks/storage-52DR5V2C.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"state":{let{runState:a}=await import("./chunks/state-ES6TFQZF.js"),t=await a(i,{port:o});await n(t)}case"reset":{let{runReset:a}=await import("./chunks/reset-RZ4O5AFJ.js"),t=await a(i,{port:o});await n(t)}case"perf":{let{runPerf:a}=await import("./chunks/perf-LXXJ4EAX.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"screenshot":{let{runScreenshotCommand:a}=await import("./chunks/screenshot-command-TQSPTFT2.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"camera":{let{runCamera:a}=await import("./chunks/camera-XHF2RPFG.js"),t=await a(i,{port:o});await n(typeof t=="number"?t:0)}case"mode":{let{runMode:a}=await import("./chunks/mode-DV24ZRZ6.js");await a(i,{port:o,verbose:c});break}case"permissions":{let{runPermissions:a}=await import("./chunks/permissions-KAOVZUPW.js"),t=await a(i,{port:o,verbose:c});await n(t)}case"debug":{let{runDebug:a}=await import("./chunks/debug-5FG3MBJS.js");await a(i,{port:o,verbose:c});break}case"timeline":{let{runTimeline:a}=await import("./chunks/timeline-NRVNB5JR.js");await a(i,{port:o,verbose:c});break}case"what-happened":{let{runWhatHappened:a}=await import("./chunks/what-happened-FSIDWL32.js");await a(i,{port:o,verbose:c});break}case"open":{let{runOpenCommand:a}=await import("./chunks/control-XD5F6K5T.js");await a(i,{port:o});break}case"ios":case"android":{let{runPlatformCommand:a}=await import("./chunks/platform-KW35446W.js"),t=await a(s,i,{port:o});await n(typeof t=="number"?t:0)}case"box":{let{runBox:a}=await import("./chunks/box-5Y5VBMHV.js");await n(await a(i,{port:o,verbose:c}))}case"use":{let{runUseCommand:a}=await import("./chunks/control-XD5F6K5T.js");await a(i,{port:o});break}case"claim":{let{runClaimCommand:a}=await import("./chunks/control-XD5F6K5T.js");await a(i,{port:o});break}case"close":{let{runCloseCommand:a}=await import("./chunks/control-XD5F6K5T.js");await a(i,{port:o});break}case"device":{let{runDeviceCommand:a}=await import("./chunks/device-D7LKCAMS.js");await a(i,{port:o});break}case"compat":{let{runCompat:a}=await import("./chunks/compat-E6KE5KDI.js");await a(e.commandArgs);break}case"report-issue":{let{runReportIssue:a}=await import("./chunks/report-issue-NW5PCAZF.js"),t=await a(e.commandArgs);await n(t)}case"desktop":{let{runDesktop:a}=await import("./chunks/desktop-5EZX7NX5.js");await a(e.commandArgs,{port:o,device:u});break}case"login":{let{runLogin:a}=await import("./chunks/login-JIU42S4C.js");await a(e.commandArgs);break}case"logout":{let{runLogout:a}=await import("./chunks/logout-JTAWQXZO.js");await a();break}case"auth":{let{runAuth:a}=await import("./chunks/auth-L7M36H6C.js");await a(e.commandArgs);break}case"setup":{let{runSetup:a}=await import("./chunks/setup-YFP3KEQZ.js");await a(e.commandArgs);break}case"serve":{let{runServe:a}=await import("./chunks/serve-MMX4WXXG.js");await a(e.commandArgs,{port:o});break}case"daemon":{let{runDaemon:a}=await import("./chunks/daemon-UN5SE2JO.js");await a(e.commandArgs,{port:o});break}case"runtime":{let{runRuntime:a}=await import("./chunks/runtime-MZHLSRS6.js");await a(e.commandArgs);break}case"upgrade":{let{runUpgrade:a}=await import("./chunks/upgrade-LNED5YQ2.js");await a(e.commandArgs);break}case"version":{let{runVersion:a}=await import("./chunks/version-VEF2DYGG.js");await a(e.commandArgs);break}case"agent":{let{runAgentCommand:a}=await import("./chunks/agent-3R4424LW.js"),t=await a(e.commandArgs);await n(t)}case"agent-wrapper":{let{runAgentWrapper:a}=await import("./chunks/agent-wrapper-4PPWZWSY.js"),t=await a(e.commandArgs);await n(t)}case"skill":{let{runSkill:a}=await import("./chunks/skills-N4D3POIS.js");await a(e.commandArgs);break}case"app-fonts":{let{runAppFonts:a}=await import("./chunks/app-fonts-KYXB6CXQ.js");await a(e.commandArgs);break}case"config":{let{runConfig:a}=await import("./chunks/config-QSLLVZDS.js");await a(e.commandArgs);break}case"cleanup":{let{runCleanup:a}=await import("./chunks/cleanup-MXMMJ7JW.js"),t=await a(e.commandArgs);await n(t)}default:console.error(`  unknown command: ${s}`),console.error(`  run \`${m.commandName} --help\` to see the full surface.`),await n(1)}}catch(a){throw a instanceof h&&await n(a.code),a}await S();
+`)}}async function n(a){let{flushCliTelemetry:t}=await import("./chunks/telemetry-E3CBKJMD.js");await t(),await S(),process.exit(a)}if(e.version){let{getCliVersion:a}=await import("./chunks/cli-version-D2IDQO7X.js"),{IS_BETA:t,BETA_LABEL:r}=await import("./chunks/beta-KYS22QPY.js"),d=t?` \xB7 ${r}`:"";console.log(`${m.commandName} v${a()}${d}`);let{readActiveRuntime:p}=await import("./chunks/home-paths-MEGVA6ET.js"),w=p();console.log(w?`runtime v${w}`:"runtime not installed"),await n(0)}if(e.help&&!e.command){let{printHelp:a}=await import("./chunks/help-6MLROWYO.js");a(),await n(0)}var o=e.globalFlags.port,c=e.verbose,u=e.globalFlags.device,l=e.globalFlags.theme,E=e.globalFlags.driver,O=e.globalFlags.headless===!0,A=e.globalFlags.sim??e.globalFlags.session??e.globalFlags.tab,i=A?["--sim",A,...e.commandArgs]:e.commandArgs;if(u||l){let{settingsStore:a}=await import("./chunks/store-TKBLMYCV.js"),t={};u&&(t.deviceModel=u),l&&(t.colorScheme=l),a.apply(t)}if(!e.command&&e.commandArgs.length===0){let{runWelcome:a}=await import("./chunks/welcome-7ATM5EGX.js");await n(await a())}var s=e.command??"";if(!s){if(e.commandArgs.length>0){let t=e.commandArgs.find(r=>!r.startsWith("-"))??e.commandArgs[0];console.error(`  unknown command: ${t}`),console.error(`  run \`${m.commandName} --help\` to see the full surface.`),await n(1)}let{printHelp:a}=await import("./chunks/help-6MLROWYO.js");a(),await n(0)}if(e.help||e.commandArgs.includes("--help")||e.commandArgs.includes("-h")){if(s==="skill"){let{runSkill:r}=await import("./chunks/skills-TDFQAZ6A.js");await r(e.commandArgs),await n(0)}if(s==="state"){let{runState:r}=await import("./chunks/state-P2Z25OLQ.js");await n(await r(i,{port:o}))}if(s==="reset"){let{runReset:r}=await import("./chunks/reset-ZZYLPETS.js");await n(await r(i,{port:o}))}let a=s==="do"||s==="get"||s==="debug"||s==="shell"||s==="perf"||s==="wait",t=e.commandArgs.find(r=>!r.startsWith("-"));if(!(s==="shell"||s==="perf"))if(a&&!t){let{printGroupHelp:r}=await import("./chunks/help-6MLROWYO.js");r(s)&&await n(0)}else{let{printCommandHelp:r}=await import("./chunks/help-6MLROWYO.js");r(a&&t?t:s,{prefer:a&&t?"verb":"command",group:a&&t?s:void 0}),await n(0)}}$(s);try{if(g.has(s)){if(s==="do"){let{hasDoChain:t,runDoChain:r}=await import("./chunks/do-chain-MTT65YNX.js");t(i)&&await n(await r(i,{port:o}))}let{runInspect:a}=await import("./chunks/inspect-EWT5SXBD.js");await a([s,...i],{port:o,verbose:c})}else switch(s){case"assert":{let{runAssert:a}=await import("./chunks/assert-Y5LXPWC6.js");await a(e.commandArgs);break}case"detox":{let{runDetox:a}=await import("./chunks/detox-RZ37736M.js");await a(e.commandArgs,{port:o,verbose:c});break}case"maestro":{let{runMaestro:a}=await import("./chunks/maestro-4HVDLCTI.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"record":{let{runRecord:a}=await import("./chunks/record-OUXWCWUF.js");await a(i,{port:o,verbose:c});break}case"film":{let{runFilm:a}=await import("./chunks/film-GPHSJLIH.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"storage":{let{runStorage:a}=await import("./chunks/storage-DWEOFXEB.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"state":{let{runState:a}=await import("./chunks/state-P2Z25OLQ.js"),t=await a(i,{port:o});await n(t)}case"reset":{let{runReset:a}=await import("./chunks/reset-ZZYLPETS.js"),t=await a(i,{port:o});await n(t)}case"perf":{let{runPerf:a}=await import("./chunks/perf-47R3OEI7.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"screenshot":{let{runScreenshotCommand:a}=await import("./chunks/screenshot-command-CUHDOS5D.js"),t=await a(i,{port:o,verbose:c});await n(typeof t=="number"?t:0)}case"camera":{let{runCamera:a}=await import("./chunks/camera-RUL426MQ.js"),t=await a(i,{port:o});await n(typeof t=="number"?t:0)}case"mode":{let{runMode:a}=await import("./chunks/mode-MGTS4QTF.js");await a(i,{port:o,verbose:c});break}case"permissions":{let{runPermissions:a}=await import("./chunks/permissions-ZOLFZWR2.js"),t=await a(i,{port:o,verbose:c});await n(t)}case"debug":{let{runDebug:a}=await import("./chunks/debug-7Z325GNU.js");await a(i,{port:o,verbose:c});break}case"timeline":{let{runTimeline:a}=await import("./chunks/timeline-55XNA4GX.js");await a(i,{port:o,verbose:c});break}case"what-happened":{let{runWhatHappened:a}=await import("./chunks/what-happened-Q3IGIH4K.js");await a(i,{port:o,verbose:c});break}case"open":{let{runOpenCommand:a}=await import("./chunks/control-FKPKLOE2.js");await a(i,{port:o});break}case"ios":case"android":{let{runPlatformCommand:a}=await import("./chunks/platform-C4E26ZBZ.js"),t=await a(s,i,{port:o});await n(typeof t=="number"?t:0)}case"box":{let{runBox:a}=await import("./chunks/box-7CK72ZPF.js");await n(await a(i,{port:o,verbose:c}))}case"use":{let{runUseCommand:a}=await import("./chunks/control-FKPKLOE2.js");await a(i,{port:o});break}case"claim":{let{runClaimCommand:a}=await import("./chunks/control-FKPKLOE2.js");await a(i,{port:o});break}case"close":{let{runCloseCommand:a}=await import("./chunks/control-FKPKLOE2.js");await a(i,{port:o});break}case"device":{let{runDeviceCommand:a}=await import("./chunks/device-TA3SQP6K.js");await a(i,{port:o});break}case"compat":{let{runCompat:a}=await import("./chunks/compat-4ZC6ZMMA.js");await a(e.commandArgs);break}case"report-issue":{let{runReportIssue:a}=await import("./chunks/report-issue-LJJXONXQ.js"),t=await a(e.commandArgs);await n(t)}case"desktop":{let{runDesktop:a}=await import("./chunks/desktop-CR7ALX7H.js");await a(e.commandArgs,{port:o,device:u});break}case"login":{let{runLogin:a}=await import("./chunks/login-EHUZYRAM.js");await a(e.commandArgs);break}case"logout":{let{runLogout:a}=await import("./chunks/logout-WPGT62N6.js");await a();break}case"auth":{let{runAuth:a}=await import("./chunks/auth-4SPTRWTM.js");await a(e.commandArgs);break}case"setup":{let{runSetup:a}=await import("./chunks/setup-X7LLGW67.js");await a(e.commandArgs);break}case"serve":{let{runServe:a}=await import("./chunks/serve-TX5OKGJM.js");await a(e.commandArgs,{port:o});break}case"daemon":{let{runDaemon:a}=await import("./chunks/daemon-WFHWS3JU.js");await a(e.commandArgs,{port:o});break}case"runtime":{let{runRuntime:a}=await import("./chunks/runtime-DEC5AF3M.js");await a(e.commandArgs);break}case"upgrade":{let{runUpgrade:a}=await import("./chunks/upgrade-3XRCVDVC.js");await a(e.commandArgs);break}case"version":{let{runVersion:a}=await import("./chunks/version-WTYGLXBJ.js");await a(e.commandArgs);break}case"agent":{let{runAgentCommand:a}=await import("./chunks/agent-RTAKJ5UM.js"),t=await a(e.commandArgs);await n(t)}case"agent-wrapper":{let{runAgentWrapper:a}=await import("./chunks/agent-wrapper-JWRDI26D.js"),t=await a(e.commandArgs);await n(t)}case"skill":{let{runSkill:a}=await import("./chunks/skills-TDFQAZ6A.js");await a(e.commandArgs);break}case"app-fonts":{let{runAppFonts:a}=await import("./chunks/app-fonts-RKO3N4PB.js");await a(e.commandArgs);break}case"config":{let{runConfig:a}=await import("./chunks/config-EOBODQ32.js");await a(e.commandArgs);break}case"cleanup":{let{runCleanup:a}=await import("./chunks/cleanup-7ATBNZHC.js"),t=await a(e.commandArgs);await n(t)}default:console.error(`  unknown command: ${s}`),console.error(`  run \`${m.commandName} --help\` to see the full surface.`),await n(1)}}catch(a){throw a instanceof h&&await n(a.code),a}await S();