rnxsim 0.1.312 → 0.1.314

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.312 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.314 | (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;
@@ -9436,9 +9436,9 @@ function safeChildPlistName(value) {
     name: file.toLowerCase().endsWith(".plist") ? file : `${file}.plist`
   };
 }
-async function readableSettingsBundle(path16) {
+async function readableSettingsBundle(path17) {
   try {
-    const root = await (0, import_promises.stat)((0, import_node_path.join)(path16, "Root.plist"));
+    const root = await (0, import_promises.stat)((0, import_node_path.join)(path17, "Root.plist"));
     return root.isFile() && root.size <= MAX_PLIST_BYTES;
   } catch {
     return false;
@@ -9483,11 +9483,11 @@ async function settingsBundleFingerprint(bundlePath) {
     return null;
   }
 }
-async function parsePlistRecord(path16) {
+async function parsePlistRecord(path17) {
   try {
-    const metadata = await (0, import_promises.stat)(path16);
+    const metadata = await (0, import_promises.stat)(path17);
     if (!metadata.isFile() || metadata.size > MAX_PLIST_BYTES) return null;
-    const source = await (0, import_promises.readFile)(path16, "utf8");
+    const source = await (0, import_promises.readFile)(path17, "utf8");
     const parsed = parsePlistSource(source);
     return isRecord2(parsed) ? parsed : null;
   } catch {
@@ -9766,10 +9766,10 @@ function tcpPing(port, timeout = TCP_GATE_MS) {
     sock.connect(port, "localhost");
   });
 }
-function httpGet(port, path16, method = "GET", timeout = TIMEOUT_MS, headers = {}) {
+function httpGet(port, path17, method = "GET", timeout = TIMEOUT_MS, headers = {}) {
   return new Promise((resolve7) => {
     const req = import_http.default.request(
-      { hostname: "localhost", port, path: path16, method, timeout, headers },
+      { hostname: "localhost", port, path: path17, method, timeout, headers },
       (res) => {
         let body = "";
         res.on("data", (c) => body += c.toString());
@@ -10330,11 +10330,12 @@ __export(home_paths_exports, {
   CONFIG_FILE: () => CONFIG_FILE,
   DAEMON_HEARTBEAT_STALE_MS: () => DAEMON_HEARTBEAT_STALE_MS,
   DAEMON_LOCKFILE: () => DAEMON_LOCKFILE,
-  DEV_BRIDGE_LOCKFILE: () => DEV_BRIDGE_LOCKFILE,
+  DEV_BRIDGES_DIR: () => DEV_BRIDGES_DIR,
   SOOTSIM_HOME_ENV: () => SOOTSIM_HOME_ENV,
   activeRuntimeDir: () => activeRuntimeDir,
   activeRuntimeFile: () => activeRuntimeFile,
   cacheDir: () => cacheDir,
+  cameraFixturesDir: () => cameraFixturesDir,
   claimDaemonLockfile: () => claimDaemonLockfile,
   configFilePath: () => configFilePath,
   consumeRuntimeUpgradeNotice: () => consumeRuntimeUpgradeNotice,
@@ -10343,6 +10344,7 @@ __export(home_paths_exports, {
   daemonAppLauncherPath: () => daemonAppLauncherPath,
   daemonLockfilePath: () => daemonLockfilePath,
   devBridgeLockfilePath: () => devBridgeLockfilePath,
+  devBridgesDir: () => devBridgesDir,
   electronDir: () => electronDir,
   electronUserDataDir: () => electronUserDataDir,
   electronVersionDir: () => electronVersionDir,
@@ -10354,7 +10356,7 @@ __export(home_paths_exports, {
   profilesDir: () => profilesDir,
   readActiveRuntime: () => readActiveRuntime,
   readDaemonLockfile: () => readDaemonLockfile,
-  readDevBridgeLockfile: () => readDevBridgeLockfile,
+  readDevBridgeLockfiles: () => readDevBridgeLockfiles,
   readLiveRuntimeVersions: () => readLiveRuntimeVersions,
   readOrCreateAnonymousId: () => readOrCreateAnonymousId,
   readPrivacyPreferences: () => readPrivacyPreferences,
@@ -10420,6 +10422,9 @@ function electronVersionDir(version) {
 function profilesDir() {
   return import_node_path4.default.join(sootsimHomeDir(), "profiles");
 }
+function cameraFixturesDir() {
+  return import_node_path4.default.join(sootsimHomeDir(), "camera-fixtures");
+}
 function daemonAppDir() {
   return import_node_path4.default.join(sootsimHomeDir(), "daemon-app");
 }
@@ -10435,8 +10440,14 @@ function cacheDir() {
 function daemonLockfilePath() {
   return import_node_path4.default.join(sootsimHomeDir(), DAEMON_LOCKFILE);
 }
-function devBridgeLockfilePath() {
-  return import_node_path4.default.join(sootsimHomeDir(), DEV_BRIDGE_LOCKFILE);
+function devBridgesDir() {
+  return import_node_path4.default.join(sootsimHomeDir(), DEV_BRIDGES_DIR);
+}
+function devBridgeLockfilePath(bridgePort) {
+  if (!Number.isInteger(bridgePort) || bridgePort <= 0) {
+    throw new Error(`invalid development bridge port: ${bridgePort}`);
+  }
+  return import_node_path4.default.join(devBridgesDir(), `${bridgePort}.json`);
 }
 function configFilePath() {
   return import_node_path4.default.join(sootsimHomeDir(), CONFIG_FILE);
@@ -10565,25 +10576,47 @@ function readDaemonLockfile() {
     return null;
   }
 }
-function readDevBridgeLockfile() {
+function parseDevBridgeLockfile(raw) {
   try {
-    const fd = import_node_fs3.default.openSync(devBridgeLockfilePath(), "r");
-    try {
-      const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES);
-      const bytesRead = import_node_fs3.default.readSync(fd, buf, 0, DAEMON_LOCKFILE_MAX_BYTES, 0);
-      const raw = buf.subarray(0, bytesRead).toString("utf8");
-      const parsed = JSON.parse(raw);
-      if (parsed && parsed.schema === 1 && parsed.source === "vite-dev" && typeof parsed.pid === "number" && typeof parsed.bridgePort === "number" && typeof parsed.runtimePort === "number" && typeof parsed.cwd === "string" && typeof parsed.startedAt === "number" && typeof parsed.heartbeatAt === "number" && (parsed.shellPort === void 0 || typeof parsed.shellPort === "number") && (parsed.servedRuntimes === void 0 || Array.isArray(parsed.servedRuntimes) && parsed.servedRuntimes.every((version) => typeof version === "string"))) {
-        return parsed;
-      }
-      return null;
-    } finally {
-      import_node_fs3.default.closeSync(fd);
+    const parsed = JSON.parse(raw);
+    if (parsed && parsed.schema === 1 && parsed.source === "vite-dev" && typeof parsed.pid === "number" && typeof parsed.bridgePort === "number" && typeof parsed.runtimePort === "number" && typeof parsed.cwd === "string" && typeof parsed.startedAt === "number" && typeof parsed.heartbeatAt === "number" && (parsed.shellPort === void 0 || typeof parsed.shellPort === "number") && (parsed.servedRuntimes === void 0 || Array.isArray(parsed.servedRuntimes) && parsed.servedRuntimes.every((version) => typeof version === "string"))) {
+      return parsed;
     }
+    return null;
   } catch {
     return null;
   }
 }
+function readDevBridgeLockfiles() {
+  let entries;
+  try {
+    entries = import_node_fs3.default.readdirSync(devBridgesDir(), { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const lockfiles = [];
+  for (const entry of entries) {
+    if (!entry.isFile() || !/^\d+\.json$/.test(entry.name)) continue;
+    try {
+      const filePath = import_node_path4.default.join(devBridgesDir(), entry.name);
+      const fd = import_node_fs3.default.openSync(filePath, "r");
+      try {
+        const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES);
+        const bytesRead = import_node_fs3.default.readSync(fd, buf, 0, DAEMON_LOCKFILE_MAX_BYTES, 0);
+        const lockfile = parseDevBridgeLockfile(
+          buf.subarray(0, bytesRead).toString("utf8")
+        );
+        if (lockfile && entry.name === `${lockfile.bridgePort}.json`) {
+          lockfiles.push(lockfile);
+        }
+      } finally {
+        import_node_fs3.default.closeSync(fd);
+      }
+    } catch {
+    }
+  }
+  return lockfiles.sort((left, right) => left.bridgePort - right.bridgePort);
+}
 function isDaemonLockfileFresh(lock, now = Date.now()) {
   if (!lock) return false;
   if (now - lock.heartbeatAt > DAEMON_HEARTBEAT_STALE_MS) return false;
@@ -10611,8 +10644,8 @@ function readLiveRuntimeVersions() {
     if (daemon.activeRuntime) versions.add(daemon.activeRuntime);
     for (const version of daemon.servedRuntimes ?? []) versions.add(version);
   }
-  const devBridge = readDevBridgeLockfile();
-  if (isDevBridgeLockfileFresh(devBridge)) {
+  for (const devBridge of readDevBridgeLockfiles()) {
+    if (!isDevBridgeLockfileFresh(devBridge)) continue;
     for (const version of devBridge.servedRuntimes ?? []) versions.add(version);
   }
   return [...versions].sort();
@@ -10625,11 +10658,12 @@ function writeDaemonLockfile(data) {
   import_node_fs3.default.renameSync(tmp, daemonLockfilePath());
 }
 function writeDevBridgeLockfile(data) {
-  ensureSootsimHome();
-  const tmp = `${devBridgeLockfilePath()}.tmp`;
+  import_node_fs3.default.mkdirSync(devBridgesDir(), { recursive: true });
+  const lockfilePath = devBridgeLockfilePath(data.bridgePort);
+  const tmp = `${lockfilePath}.${data.pid}.tmp`;
   import_node_fs3.default.writeFileSync(tmp, `${JSON.stringify(data, null, 2)}
 `, "utf8");
-  import_node_fs3.default.renameSync(tmp, devBridgeLockfilePath());
+  import_node_fs3.default.renameSync(tmp, lockfilePath);
 }
 function claimDaemonLockfile(data) {
   ensureSootsimHome();
@@ -10646,13 +10680,16 @@ function removeDaemonLockfile() {
   } catch {
   }
 }
-function removeDevBridgeLockfile() {
+function removeDevBridgeLockfile(owner) {
   try {
-    import_node_fs3.default.unlinkSync(devBridgeLockfilePath());
+    const lockfilePath = devBridgeLockfilePath(owner.bridgePort);
+    const lockfile = parseDevBridgeLockfile(import_node_fs3.default.readFileSync(lockfilePath, "utf8"));
+    if (lockfile?.pid !== owner.pid || lockfile.startedAt !== owner.startedAt) return;
+    import_node_fs3.default.unlinkSync(lockfilePath);
   } catch {
   }
 }
-var import_node_crypto, import_node_fs3, import_node_os, import_node_path4, SOOTSIM_HOME_ENV, ACTIVE_RUNTIME_FILE, DAEMON_LOCKFILE, DEV_BRIDGE_LOCKFILE, CONFIG_FILE, DAEMON_HEARTBEAT_STALE_MS, DAEMON_LOCKFILE_MAX_BYTES;
+var import_node_crypto, import_node_fs3, import_node_os, import_node_path4, SOOTSIM_HOME_ENV, ACTIVE_RUNTIME_FILE, DAEMON_LOCKFILE, DEV_BRIDGES_DIR, CONFIG_FILE, DAEMON_HEARTBEAT_STALE_MS, DAEMON_LOCKFILE_MAX_BYTES;
 var init_home_paths = __esm({
   "src/home-paths.ts"() {
     "use strict";
@@ -10663,7 +10700,7 @@ var init_home_paths = __esm({
     SOOTSIM_HOME_ENV = "SOOTSIM_HOME";
     ACTIVE_RUNTIME_FILE = "active";
     DAEMON_LOCKFILE = "daemon.json";
-    DEV_BRIDGE_LOCKFILE = "dev-bridge.json";
+    DEV_BRIDGES_DIR = "dev-bridges";
     CONFIG_FILE = "config.json";
     DAEMON_HEARTBEAT_STALE_MS = 3e4;
     DAEMON_LOCKFILE_MAX_BYTES = 16 * 1024;
@@ -13211,7 +13248,7 @@ function unrefTimer(timer) {
     timer.unref();
   }
 }
-var import_child_process3, import_fs2, import_http3, import_path2, import_ws2, SOOTSIM_CROSS_ORIGIN_EMBEDDER_POLICY, WRITE_COMMAND_TYPES, FORCE_CLOSE_GRACE_MS, FORCE_CLOSE_TERMINATE_MS, DAEMON_HEARTBEAT_INTERVAL_MS, DEFAULT_RUNTIME_UPDATE_INTERVAL_MS, RUNTIME_UPDATE_INTERVAL_ENV, HTTP_MIME_TYPES, SootSimBridgeHost;
+var import_child_process3, import_fs2, import_http3, import_path2, import_ws2, SOOTSIM_CROSS_ORIGIN_EMBEDDER_POLICY, WRITE_COMMAND_TYPES, FORCE_CLOSE_GRACE_MS, FORCE_CLOSE_TERMINATE_MS, DAEMON_HEARTBEAT_INTERVAL_MS, DEFAULT_RUNTIME_UPDATE_INTERVAL_MS, RUNTIME_UPDATE_INTERVAL_ENV, HTTP_MIME_TYPES, CAMERA_FIXTURE_ROUTE, CAMERA_FIXTURE_NAME_RE, SootSimBridgeHost;
 var init_bridge_host = __esm({
   "src/host/bridge-host.ts"() {
     "use strict";
@@ -13231,7 +13268,14 @@ var init_bridge_host = __esm({
     init_open_url();
     init_websocket_proxy();
     SOOTSIM_CROSS_ORIGIN_EMBEDDER_POLICY = "require-corp";
-    WRITE_COMMAND_TYPES = /* @__PURE__ */ new Set(["tap", "keyboard"]);
+    WRITE_COMMAND_TYPES = /* @__PURE__ */ new Set([
+      "tap",
+      "keyboard",
+      "longPress",
+      "perform",
+      "reset",
+      "camera"
+    ]);
     FORCE_CLOSE_GRACE_MS = 2e3;
     FORCE_CLOSE_TERMINATE_MS = 1e3;
     DAEMON_HEARTBEAT_INTERVAL_MS = 5e3;
@@ -13258,8 +13302,14 @@ var init_bridge_host = __esm({
       ".woff": "font/woff",
       ".woff2": "font/woff2",
       ".map": "application/json",
-      ".txt": "text/plain; charset=utf-8"
+      ".txt": "text/plain; charset=utf-8",
+      ".mp4": "video/mp4",
+      ".m4v": "video/mp4",
+      ".webm": "video/webm",
+      ".mov": "video/quicktime"
     };
+    CAMERA_FIXTURE_ROUTE = "/__camera-fixtures/";
+    CAMERA_FIXTURE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
     SootSimBridgeHost = class _SootSimBridgeHost {
       port;
       openUrlHandler;
@@ -14019,6 +14069,89 @@ var init_bridge_host = __esm({
         });
         return this.inflightScan;
       }
+      // serves one staged camera fixture. addressed by basename inside
+      // ~/.sootsim/camera-fixtures, never by a caller-supplied path, so there is
+      // no traversal surface to defend: a name that is not a plain basename is
+      // rejected outright. range support is not optional here — chrome asks for
+      // byte ranges on media and cannot seek or loop a fixture without it.
+      handleCameraFixture(name2, req, res) {
+        const method = (req.method || "GET").toUpperCase();
+        const cors = {
+          "Access-Control-Allow-Origin": "*",
+          "Cache-Control": "no-store"
+        };
+        if (method === "OPTIONS") {
+          res.writeHead(204, {
+            ...cors,
+            "Access-Control-Allow-Methods": "GET, HEAD, OPTIONS",
+            "Access-Control-Allow-Headers": "range"
+          });
+          res.end();
+          return;
+        }
+        if (method !== "GET" && method !== "HEAD") {
+          res.writeHead(405, cors);
+          res.end();
+          return;
+        }
+        if (!CAMERA_FIXTURE_NAME_RE.test(name2)) {
+          res.writeHead(400, { ...cors, "Content-Type": "text/plain; charset=utf-8" });
+          res.end("bad fixture name");
+          return;
+        }
+        const root = cameraFixturesDir();
+        const filePath = import_path2.default.join(root, name2);
+        let stats;
+        try {
+          stats = import_fs2.default.lstatSync(filePath);
+        } catch {
+          res.writeHead(404, { ...cors, "Content-Type": "text/plain; charset=utf-8" });
+          res.end("not found");
+          return;
+        }
+        if (!stats.isFile()) {
+          res.writeHead(403, { ...cors, "Content-Type": "text/plain; charset=utf-8" });
+          res.end("forbidden");
+          return;
+        }
+        const contentType = HTTP_MIME_TYPES[import_path2.default.extname(filePath).toLowerCase()] || "application/octet-stream";
+        const total = stats.size;
+        const range = /^bytes=(\d*)-(\d*)$/.exec(req.headers.range || "");
+        if (range) {
+          const [, startRaw, endRaw] = range;
+          const start = startRaw ? Number(startRaw) : 0;
+          const end = endRaw ? Math.min(Number(endRaw), total - 1) : total - 1;
+          if (!Number.isFinite(start) || start > end || start >= total) {
+            res.writeHead(416, { ...cors, "Content-Range": `bytes */${total}` });
+            res.end();
+            return;
+          }
+          res.writeHead(206, {
+            ...cors,
+            "Content-Type": contentType,
+            "Content-Range": `bytes ${start}-${end}/${total}`,
+            "Accept-Ranges": "bytes",
+            "Content-Length": String(end - start + 1)
+          });
+          if (method === "HEAD") {
+            res.end();
+            return;
+          }
+          import_fs2.default.createReadStream(filePath, { start, end }).pipe(res);
+          return;
+        }
+        res.writeHead(200, {
+          ...cors,
+          "Content-Type": contentType,
+          "Accept-Ranges": "bytes",
+          "Content-Length": String(total)
+        });
+        if (method === "HEAD") {
+          res.end();
+          return;
+        }
+        import_fs2.default.createReadStream(filePath).pipe(res);
+      }
       handleServerScan(res) {
         const sendJson = (body) => {
           res.writeHead(200, {
@@ -14242,6 +14375,10 @@ var init_bridge_host = __esm({
           res.end("method not allowed");
           return;
         }
+        if (url.pathname.startsWith(CAMERA_FIXTURE_ROUTE)) {
+          this.handleCameraFixture(url.pathname.slice(CAMERA_FIXTURE_ROUTE.length), req, res);
+          return;
+        }
         if (method !== "GET" && method !== "HEAD") {
           res.writeHead(405, { Allow: "GET, HEAD" });
           res.end("method not allowed");
@@ -14710,7 +14847,11 @@ var init_bridge_host = __esm({
         }
         if (this.shouldWriteDevLockfile) {
           try {
-            removeDevBridgeLockfile();
+            removeDevBridgeLockfile({
+              bridgePort: this.effectivePort,
+              pid: process.pid,
+              startedAt: this.startedAt
+            });
           } catch {
           }
         }
@@ -15465,6 +15606,53 @@ __export(ws_bridge_exports, {
   resolveDefaultBridgePort: () => resolveDefaultBridgePort,
   worldForBridgePort: () => worldForBridgePort
 });
+function liveDevBridgeLockfiles() {
+  return readDevBridgeLockfiles().filter((lockfile) => isDevBridgeLockfileFresh(lockfile));
+}
+function checkoutRoot(cwd) {
+  let current = import_node_path10.default.resolve(cwd);
+  while (true) {
+    if (import_node_fs9.default.existsSync(import_node_path10.default.join(current, ".git"))) return current;
+    const parent = import_node_path10.default.dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+function pathContains(parent, child) {
+  const relative = import_node_path10.default.relative(parent, child);
+  return relative === "" || relative !== ".." && !relative.startsWith(`..${import_node_path10.default.sep}`) && !import_node_path10.default.isAbsolute(relative);
+}
+function resolveDefaultDevBridgeLockfile() {
+  const lockfiles = liveDevBridgeLockfiles();
+  if (lockfiles.length === 0) return null;
+  if (process.env.SOOTSIM_BRIDGE_PORT !== void 0 || process.env.PORT_OFFSET !== void 0) {
+    const requestedPort = resolveSootsimBridgePort({
+      explicitPort: process.env.SOOTSIM_BRIDGE_PORT,
+      portOffset: process.env.PORT_OFFSET
+    });
+    const requested = lockfiles.find((lockfile) => lockfile.bridgePort === requestedPort);
+    if (requested) return requested;
+  }
+  let cwd = null;
+  try {
+    cwd = process.cwd();
+  } catch {
+  }
+  if (cwd) {
+    const currentCheckout = checkoutRoot(cwd);
+    const sameCheckout = lockfiles.filter((lockfile) => {
+      const bridgeCheckout = checkoutRoot(lockfile.cwd);
+      if (currentCheckout && bridgeCheckout) return currentCheckout === bridgeCheckout;
+      return pathContains(cwd, lockfile.cwd) || pathContains(lockfile.cwd, cwd);
+    });
+    if (sameCheckout.length > 0) {
+      return sameCheckout.find(
+        (lockfile) => lockfile.bridgePort === DEFAULT_SOOTSIM_BRIDGE_PORT
+      ) ?? sameCheckout[0];
+    }
+  }
+  return lockfiles.find((lockfile) => lockfile.bridgePort === DEFAULT_SOOTSIM_BRIDGE_PORT) ?? lockfiles[0];
+}
 function resolveBridgeWorld() {
   const homeDir = sootsimHomeDir();
   if (resolvedWorld?.homeDir === homeDir) return resolvedWorld.world;
@@ -15473,8 +15661,8 @@ function resolveBridgeWorld() {
   return world;
 }
 function resolveBridgeWorldFresh() {
-  const dev = readDevBridgeLockfile();
-  if (dev && isDevBridgeLockfileFresh(dev)) {
+  const dev = resolveDefaultDevBridgeLockfile();
+  if (dev) {
     return {
       source: "dev-bridge",
       bridgePort: dev.bridgePort,
@@ -15498,8 +15686,8 @@ function resolveBridgeWorldFresh() {
   };
 }
 function worldForBridgePort(port) {
-  const dev = readDevBridgeLockfile();
-  if (dev && isDevBridgeLockfileFresh(dev) && dev.bridgePort === port) {
+  const dev = liveDevBridgeLockfiles().find((lockfile) => lockfile.bridgePort === port);
+  if (dev) {
     return {
       source: "dev-bridge",
       shellBaseUrl: dev.shellPort ? `http://localhost:${dev.shellPort}/` : DEFAULT_SOOTSIM_SHELL_URL
@@ -15523,8 +15711,10 @@ function bridgePortForShellBaseUrl(baseUrl) {
     return null;
   }
   if (!Number.isFinite(port) || port <= 0) return null;
-  const dev = readDevBridgeLockfile();
-  if (dev && isDevBridgeLockfileFresh(dev) && (dev.shellPort === port || dev.runtimePort === port || dev.bridgePort === port)) {
+  const dev = liveDevBridgeLockfiles().find(
+    (lockfile) => lockfile.shellPort === port || lockfile.runtimePort === port || lockfile.bridgePort === port
+  );
+  if (dev) {
     return dev.bridgePort;
   }
   const lock = readDaemonLockfile();
@@ -15539,7 +15729,7 @@ function resolveDefaultBridgePort() {
 function printBridgeWorldNotice(bridgePort, shellBaseUrl) {
   const world = worldForBridgePort(bridgePort);
   const kind = world?.source === "dev-bridge" ? "dev bridge" : world?.source === "daemon" ? "daemon bridge" : "bridge";
-  const origin = world ? `${world.source}.json` : "no lockfile";
+  const origin = world?.source === "dev-bridge" ? `dev-bridges/${bridgePort}.json` : world?.source === "daemon" ? "daemon.json" : "no lockfile";
   const shell = shellBaseUrl ?? world?.shellBaseUrl;
   process.stderr.write(
     `  \u2192 ${kind} :${bridgePort} (${shell ? `shell ${shell}, ` : ""}${origin})
@@ -15659,6 +15849,8 @@ function createBridge(wsPort, opts = {}) {
       reject(new Error(`could not connect to ws://localhost:${wsPort}${cause}`));
     });
   });
+  ready.catch(() => {
+  });
   let warnedAboutContention = false;
   let noticedTarget = false;
   function maybeNoticeTarget(cmdType, simId) {
@@ -15851,16 +16043,18 @@ async function evalInBridge(bridge, code, opts = {}) {
   if (opts.acquireLock) payload.acquireLock = true;
   return bridge.send(payload);
 }
-async function callInBridge(bridge, path16, ...args) {
-  return bridge.send({ type: "call", path: path16, args });
+async function callInBridge(bridge, path17, ...args) {
+  return bridge.send({ type: "call", path: path17, args });
 }
-async function callInBridgeWrite(bridge, path16, ...args) {
-  return bridge.send({ type: "call", path: path16, args, acquireLock: true });
+async function callInBridgeWrite(bridge, path17, ...args) {
+  return bridge.send({ type: "call", path: path17, args, acquireLock: true });
 }
-var import_ws3, resolvedWorld, BridgeSimLockedError;
+var import_node_fs9, import_node_path10, import_ws3, resolvedWorld, BridgeSimLockedError;
 var init_ws_bridge = __esm({
   "cli/ws-bridge.ts"() {
     "use strict";
+    import_node_fs9 = __toESM(require("node:fs"), 1);
+    import_node_path10 = __toESM(require("node:path"), 1);
     import_ws3 = require("ws");
     init_bridge_constants();
     init_cli_constants();
@@ -15915,8 +16109,8 @@ function getDefaultPortForProtocol(protocol) {
   return protocol === "https:" ? 443 : 80;
 }
 function isBaseServerUrl(url) {
-  const path16 = url.pathname || "/";
-  return (path16 === "/" || path16 === "") && !url.search && !url.hash;
+  const path17 = url.pathname || "/";
+  return (path17 === "/" || path17 === "") && !url.search && !url.hash;
 }
 async function resolvePortViaServerScan(port) {
   try {
@@ -16136,9 +16330,9 @@ var init_profiles = __esm({
 // cli/app-project.ts
 function firstNamedFile(dir, names) {
   for (const name2 of names) {
-    const candidate = import_node_path10.default.join(dir, name2);
+    const candidate = import_node_path11.default.join(dir, name2);
     try {
-      if (import_node_fs9.default.statSync(candidate).isFile()) return candidate;
+      if (import_node_fs10.default.statSync(candidate).isFile()) return candidate;
     } catch {
     }
   }
@@ -16152,7 +16346,7 @@ function findSootSimAppConfig(dir) {
 }
 function readWorkspacePatterns(rootDir) {
   try {
-    const value = JSON.parse(import_node_fs9.default.readFileSync(import_node_path10.default.join(rootDir, "package.json"), "utf8"));
+    const value = JSON.parse(import_node_fs10.default.readFileSync(import_node_path11.default.join(rootDir, "package.json"), "utf8"));
     if (!value || typeof value !== "object") return [];
     const workspaces = Reflect.get(value, "workspaces");
     if (Array.isArray(workspaces)) {
@@ -16174,7 +16368,7 @@ function workspaceDirectories(rootDir) {
       complete = false;
       break;
     }
-    if (!pattern || import_node_path10.default.isAbsolute(pattern)) continue;
+    if (!pattern || import_node_path11.default.isAbsolute(pattern)) continue;
     const segments = pattern.split(/[\\/]+/).filter(Boolean);
     if (segments.length === 0 || segments.length > MAX_SCAN_DEPTH) continue;
     if (segments.some((segment) => segment === ".." || segment === "**")) continue;
@@ -16190,19 +16384,19 @@ function workspaceDirectories(rootDir) {
         if (segment === "*") {
           let entries;
           try {
-            entries = import_node_fs9.default.readdirSync(parent, { withFileTypes: true });
+            entries = import_node_fs10.default.readdirSync(parent, { withFileTypes: true });
           } catch {
             continue;
           }
           for (const entry of entries) {
             if (!entry.isDirectory() || entry.isSymbolicLink()) continue;
             if (entry.name.startsWith(".") || SKIP_DIR_NAMES.has(entry.name)) continue;
-            next.push(import_node_path10.default.join(parent, entry.name));
+            next.push(import_node_path11.default.join(parent, entry.name));
           }
         } else if (!segment.includes("*")) {
-          const candidate = import_node_path10.default.join(parent, segment);
+          const candidate = import_node_path11.default.join(parent, segment);
           try {
-            const stat2 = import_node_fs9.default.lstatSync(candidate);
+            const stat2 = import_node_fs10.default.lstatSync(candidate);
             if (stat2.isDirectory() && !stat2.isSymbolicLink()) next.push(candidate);
           } catch {
           }
@@ -16235,7 +16429,7 @@ function boundedConfigDirectories(rootDir) {
     if (current.depth >= MAX_SCAN_DEPTH) continue;
     let entries;
     try {
-      entries = import_node_fs9.default.readdirSync(current.dir, { withFileTypes: true });
+      entries = import_node_fs10.default.readdirSync(current.dir, { withFileTypes: true });
     } catch {
       continue;
     }
@@ -16246,22 +16440,22 @@ function boundedConfigDirectories(rootDir) {
         complete = false;
         break;
       }
-      queue.push({ dir: import_node_path10.default.join(current.dir, entry.name), depth: current.depth + 1 });
+      queue.push({ dir: import_node_path11.default.join(current.dir, entry.name), depth: current.depth + 1 });
     }
   }
   return { directories: matches, complete: complete && nextIndex === queue.length };
 }
 function resolveAppProject(startDir, opts = {}) {
-  const rootDir = import_node_path10.default.resolve(startDir);
+  const rootDir = import_node_path11.default.resolve(startDir);
   const rootConfigPath = findSootSimAppConfig(rootDir);
-  if (findExpoAppConfig(rootDir) || opts.trustStart && import_node_fs9.default.existsSync(rootDir)) {
+  if (findExpoAppConfig(rootDir) || opts.trustStart && import_node_fs10.default.existsSync(rootDir)) {
     let configPath = rootConfigPath;
     if (!configPath && opts.trustStart) {
-      let parent = import_node_path10.default.dirname(rootDir);
-      for (let depth = 0; depth < MAX_SCAN_DEPTH && parent !== import_node_path10.default.dirname(parent); depth++) {
+      let parent = import_node_path11.default.dirname(rootDir);
+      for (let depth = 0; depth < MAX_SCAN_DEPTH && parent !== import_node_path11.default.dirname(parent); depth++) {
         configPath = findSootSimAppConfig(parent);
         if (configPath) break;
-        parent = import_node_path10.default.dirname(parent);
+        parent = import_node_path11.default.dirname(parent);
       }
     }
     return { appDir: rootDir, configPath };
@@ -16293,12 +16487,12 @@ function resolveAppProject(startDir, opts = {}) {
   if (rootConfigPath) return { appDir: rootDir, configPath: rootConfigPath };
   return null;
 }
-var import_node_fs9, import_node_path10, EXPO_APP_CONFIG_NAMES, SOOTSIM_APP_CONFIG_NAMES, SKIP_DIR_NAMES, MAX_SCANNED_DIRECTORIES, MAX_SCAN_DEPTH;
+var import_node_fs10, import_node_path11, EXPO_APP_CONFIG_NAMES, SOOTSIM_APP_CONFIG_NAMES, SKIP_DIR_NAMES, MAX_SCANNED_DIRECTORIES, MAX_SCAN_DEPTH;
 var init_app_project = __esm({
   "cli/app-project.ts"() {
     "use strict";
-    import_node_fs9 = __toESM(require("node:fs"), 1);
-    import_node_path10 = __toESM(require("node:path"), 1);
+    import_node_fs10 = __toESM(require("node:fs"), 1);
+    import_node_path11 = __toESM(require("node:path"), 1);
     EXPO_APP_CONFIG_NAMES = [
       "app.config.js",
       "app.config.ts",
@@ -16399,7 +16593,7 @@ function localOriginOf(value) {
 }
 function hasPackageJson(dir) {
   try {
-    return import_node_fs10.default.statSync(import_node_path11.default.join(dir, "package.json")).isFile();
+    return import_node_fs11.default.statSync(import_node_path12.default.join(dir, "package.json")).isFile();
   } catch {
     return false;
   }
@@ -16408,7 +16602,7 @@ function discoverNativeLinkedAppFonts(opts) {
   const metroOrigin = localOriginOf(opts.bundleUrl);
   if (!metroOrigin) return [];
   const explicit = opts.repoDir || process.env.CONTRAST_REPO_DIR;
-  const startDir = explicit ? import_node_path11.default.resolve(explicit) : process.cwd();
+  const startDir = explicit ? import_node_path12.default.resolve(explicit) : process.cwd();
   if (!explicit && !hasPackageJson(startDir)) return [];
   const project = resolveAppProject(startDir, { trustStart: opts.exactProjectDir });
   const selectedAppDir = project?.appDir ?? null;
@@ -16454,13 +16648,13 @@ function discoverNativeLinkedAppFonts(opts) {
       scannedFontDirectories++;
       let entries;
       try {
-        entries = import_node_fs10.default.readdirSync(current.dir, { withFileTypes: true });
+        entries = import_node_fs11.default.readdirSync(current.dir, { withFileTypes: true });
       } catch {
         continue;
       }
       for (const entry of entries) {
         if (entry.isSymbolicLink()) continue;
-        const fullPath = import_node_path11.default.join(current.dir, entry.name);
+        const fullPath = import_node_path12.default.join(current.dir, entry.name);
         if (entry.isDirectory()) {
           if (current.depth < 4 && pending.length < 64 && !entry.name.startsWith(".")) {
             pending.push({ dir: fullPath, depth: current.depth + 1 });
@@ -16468,15 +16662,15 @@ function discoverNativeLinkedAppFonts(opts) {
           continue;
         }
         if (!entry.isFile() || !/\.(ttf|otf|woff|woff2)$/i.test(entry.name)) continue;
-        const relative = import_node_path11.default.relative(root, fullPath).split(import_node_path11.default.sep).join("/");
-        fontPaths.push(import_node_path11.default.posix.join(metroPathPrefix, relative));
+        const relative = import_node_path12.default.relative(root, fullPath).split(import_node_path12.default.sep).join("/");
+        fontPaths.push(import_node_path12.default.posix.join(metroPathPrefix, relative));
         if (fontPaths.length >= 256) break;
       }
     }
   };
   try {
     const packageJson = JSON.parse(
-      import_node_fs10.default.readFileSync(import_node_path11.default.join(selectedAppDir, "package.json"), "utf8")
+      import_node_fs11.default.readFileSync(import_node_path12.default.join(selectedAppDir, "package.json"), "utf8")
     );
     const dependencyNames = /* @__PURE__ */ new Set();
     for (const field of ["dependencies", "devDependencies", "optionalDependencies"]) {
@@ -16491,24 +16685,24 @@ function discoverNativeLinkedAppFonts(opts) {
       const config = Reflect.get(packageJson, "reactNativeVectorIcons");
       const configuredFontDir = config && typeof config === "object" ? Reflect.get(config, "fontDir") : null;
       const configuredDir = typeof configuredFontDir === "string" ? configuredFontDir : "rnvi-fonts";
-      const root = import_node_path11.default.resolve(selectedAppDir, configuredDir);
-      const relativeRoot = import_node_path11.default.relative(selectedAppDir, root);
-      if (!relativeRoot.startsWith("..") && !import_node_path11.default.isAbsolute(relativeRoot)) {
-        collectFontFiles(root, relativeRoot.split(import_node_path11.default.sep).join("/"));
+      const root = import_node_path12.default.resolve(selectedAppDir, configuredDir);
+      const relativeRoot = import_node_path12.default.relative(selectedAppDir, root);
+      if (!relativeRoot.startsWith("..") && !import_node_path12.default.isAbsolute(relativeRoot)) {
+        collectFontFiles(root, relativeRoot.split(import_node_path12.default.sep).join("/"));
       }
-      const vectorIconRequire = (0, import_node_module2.createRequire)(import_node_path11.default.join(selectedAppDir, "package.json"));
+      const vectorIconRequire = (0, import_node_module2.createRequire)(import_node_path12.default.join(selectedAppDir, "package.json"));
       for (const dependencyName of vectorIconDependencies) {
         try {
           const entryPath = vectorIconRequire.resolve(dependencyName);
-          const dependencyPath = dependencyName.split("/").join(import_node_path11.default.sep);
-          const marker = `${import_node_path11.default.sep}node_modules${import_node_path11.default.sep}${dependencyPath}${import_node_path11.default.sep}`;
+          const dependencyPath = dependencyName.split("/").join(import_node_path12.default.sep);
+          const marker = `${import_node_path12.default.sep}node_modules${import_node_path12.default.sep}${dependencyPath}${import_node_path12.default.sep}`;
           const markerIndex = entryPath.lastIndexOf(marker);
           if (markerIndex === -1) continue;
           const packageRoot = entryPath.slice(0, markerIndex + marker.length - 1);
           const fontsDir = dependencyName === "react-native-vector-icons" ? "Fonts" : "fonts";
           collectFontFiles(
-            import_node_path11.default.join(packageRoot, fontsDir),
-            import_node_path11.default.posix.join("node_modules", dependencyName, fontsDir)
+            import_node_path12.default.join(packageRoot, fontsDir),
+            import_node_path12.default.posix.join("node_modules", dependencyName, fontsDir)
           );
         } catch {
         }
@@ -16517,37 +16711,37 @@ function discoverNativeLinkedAppFonts(opts) {
   } catch {
   }
   try {
-    const configPath = import_node_path11.default.join(selectedAppDir, "react-native.config.js");
-    if (import_node_fs10.default.statSync(configPath).isFile()) {
-      const appConfigRequire = (0, import_node_module2.createRequire)(import_node_path11.default.join(selectedAppDir, "package.json"));
+    const configPath = import_node_path12.default.join(selectedAppDir, "react-native.config.js");
+    if (import_node_fs11.default.statSync(configPath).isFile()) {
+      const appConfigRequire = (0, import_node_module2.createRequire)(import_node_path12.default.join(selectedAppDir, "package.json"));
       const rnConfig = appConfigRequire(configPath);
       const assets = rnConfig && typeof rnConfig === "object" ? Reflect.get(rnConfig, "assets") : null;
       if (Array.isArray(assets)) {
         for (const assetDir of assets) {
           if (typeof assetDir !== "string") continue;
-          const root = import_node_path11.default.resolve(selectedAppDir, assetDir);
-          const relativeRoot = import_node_path11.default.relative(selectedAppDir, root);
-          if (relativeRoot.startsWith("..") || import_node_path11.default.isAbsolute(relativeRoot)) continue;
-          collectFontFiles(root, relativeRoot.split(import_node_path11.default.sep).join("/"));
+          const root = import_node_path12.default.resolve(selectedAppDir, assetDir);
+          const relativeRoot = import_node_path12.default.relative(selectedAppDir, root);
+          if (relativeRoot.startsWith("..") || import_node_path12.default.isAbsolute(relativeRoot)) continue;
+          collectFontFiles(root, relativeRoot.split(import_node_path12.default.sep).join("/"));
         }
       }
     }
   } catch {
   }
   if (platform === "ios") {
-    const iosDir = import_node_path11.default.join(selectedAppDir, "ios");
+    const iosDir = import_node_path12.default.join(selectedAppDir, "ios");
     try {
-      const targetDirs = import_node_fs10.default.readdirSync(iosDir, { withFileTypes: true }).filter(
+      const targetDirs = import_node_fs11.default.readdirSync(iosDir, { withFileTypes: true }).filter(
         (entry) => entry.isDirectory() && !entry.isSymbolicLink() && entry.name !== "Pods" && entry.name !== "build" && !entry.name.startsWith(".")
       ).slice(0, 64);
-      const plistPaths = [import_node_path11.default.join(iosDir, "Info.plist")];
+      const plistPaths = [import_node_path12.default.join(iosDir, "Info.plist")];
       for (const entry of targetDirs) {
-        plistPaths.push(import_node_path11.default.join(iosDir, entry.name, "Info.plist"));
+        plistPaths.push(import_node_path12.default.join(iosDir, entry.name, "Info.plist"));
       }
       for (const plistPath of plistPaths) {
         let parsed;
         try {
-          parsed = parsePlistSource(import_node_fs10.default.readFileSync(plistPath, "utf8"));
+          parsed = parsePlistSource(import_node_fs11.default.readFileSync(plistPath, "utf8"));
         } catch {
           continue;
         }
@@ -16557,21 +16751,21 @@ function discoverNativeLinkedAppFonts(opts) {
         for (const declaredFont of declaredFonts) {
           if (typeof declaredFont !== "string") continue;
           const candidates = [
-            import_node_path11.default.resolve(import_node_path11.default.dirname(plistPath), declaredFont),
-            import_node_path11.default.resolve(iosDir, declaredFont)
+            import_node_path12.default.resolve(import_node_path12.default.dirname(plistPath), declaredFont),
+            import_node_path12.default.resolve(iosDir, declaredFont)
           ];
           const fontPath = candidates.find((candidate) => {
-            const relative = import_node_path11.default.relative(selectedAppDir, candidate);
-            if (relative.startsWith("..") || import_node_path11.default.isAbsolute(relative)) return false;
+            const relative = import_node_path12.default.relative(selectedAppDir, candidate);
+            if (relative.startsWith("..") || import_node_path12.default.isAbsolute(relative)) return false;
             try {
-              return import_node_fs10.default.statSync(candidate).isFile();
+              return import_node_fs11.default.statSync(candidate).isFile();
             } catch {
               return false;
             }
           });
           if (!fontPath) continue;
           fontPaths.push(
-            import_node_path11.default.relative(selectedAppDir, fontPath).split(import_node_path11.default.sep).join("/")
+            import_node_path12.default.relative(selectedAppDir, fontPath).split(import_node_path12.default.sep).join("/")
           );
         }
       }
@@ -16610,13 +16804,13 @@ async function resolveMetroProjectRoot(bundleUrl, opts) {
 function encodeAppFontsWire(specs) {
   return specs.map((spec) => `${encodeURIComponent(spec.url)}::${encodeURIComponent(spec.family)}`).join(",");
 }
-var import_node_fs10, import_node_module2, import_node_path11, import_config_plugin_fonts, require3;
+var import_node_fs11, import_node_module2, import_node_path12, import_config_plugin_fonts, require3;
 var init_app_fonts = __esm({
   "cli/app-fonts.ts"() {
     "use strict";
-    import_node_fs10 = __toESM(require("node:fs"), 1);
+    import_node_fs11 = __toESM(require("node:fs"), 1);
     import_node_module2 = require("node:module");
-    import_node_path11 = __toESM(require("node:path"), 1);
+    import_node_path12 = __toESM(require("node:path"), 1);
     import_config_plugin_fonts = require("sootsim-engine/engine/config-plugin-fonts");
     init_dev_server_scanner();
     init_plist();
@@ -16639,7 +16833,7 @@ function localOriginOf2(value) {
 }
 function hasPackageJson2(dir) {
   try {
-    return import_node_fs11.default.statSync(import_node_path12.default.join(dir, "package.json")).isFile();
+    return import_node_fs12.default.statSync(import_node_path13.default.join(dir, "package.json")).isFile();
   } catch {
     return false;
   }
@@ -16648,7 +16842,7 @@ function discoverConfigPluginAppSplash(opts) {
   const metroOrigin = localOriginOf2(opts.bundleUrl);
   if (!metroOrigin) return null;
   const explicit = opts.repoDir || process.env.CONTRAST_REPO_DIR;
-  const startDir = explicit ? import_node_path12.default.resolve(explicit) : process.cwd();
+  const startDir = explicit ? import_node_path13.default.resolve(explicit) : process.cwd();
   if (!explicit && !hasPackageJson2(startDir)) return null;
   const project = resolveAppProject(startDir, { trustStart: opts.exactProjectDir });
   const selectedAppDir = project?.appDir ?? null;
@@ -16682,13 +16876,13 @@ function discoverConfigPluginAppSplash(opts) {
 function encodeAppSplashWire(spec) {
   return encodeURIComponent(JSON.stringify(spec));
 }
-var import_node_fs11, import_node_module3, import_node_path12, import_config_plugin_splash, require4;
+var import_node_fs12, import_node_module3, import_node_path13, import_config_plugin_splash, require4;
 var init_app_splash = __esm({
   "cli/app-splash.ts"() {
     "use strict";
-    import_node_fs11 = __toESM(require("node:fs"), 1);
+    import_node_fs12 = __toESM(require("node:fs"), 1);
     import_node_module3 = require("node:module");
-    import_node_path12 = __toESM(require("node:path"), 1);
+    import_node_path13 = __toESM(require("node:path"), 1);
     import_config_plugin_splash = require("sootsim-engine/engine/config-plugin-splash");
     init_app_project();
     require4 = (0, import_node_module3.createRequire)(__sootsim_import_meta_url);
@@ -17706,7 +17900,7 @@ function resolvePlaywright() {
         try {
           const modulePath = requireFromRoot.resolve(spec);
           const packageJsonPath = requireFromRoot.resolve(`${spec}/package.json`);
-          const parsed = JSON.parse((0, import_node_fs12.readFileSync)(packageJsonPath, "utf8"));
+          const parsed = JSON.parse((0, import_node_fs13.readFileSync)(packageJsonPath, "utf8"));
           if (!isRecord3(parsed) || typeof parsed.version !== "string") continue;
           const bin = parsed.bin;
           let binPath = null;
@@ -17718,8 +17912,8 @@ function resolvePlaywright() {
             binPath = typeof named === "string" ? named : typeof first === "string" ? first : null;
           }
           if (!binPath) continue;
-          const cliPath = (0, import_node_path13.join)((0, import_node_path13.dirname)(packageJsonPath), binPath);
-          if (!(0, import_node_fs12.existsSync)(cliPath)) continue;
+          const cliPath = (0, import_node_path14.join)((0, import_node_path14.dirname)(packageJsonPath), binPath);
+          if (!(0, import_node_fs13.existsSync)(cliPath)) continue;
           return {
             spec,
             modulePath,
@@ -17758,7 +17952,7 @@ function probeBrowser(resolved, env) {
     return {
       ok: true,
       executablePath: parsed.executablePath,
-      exists: parsed.exists && (0, import_node_fs12.existsSync)(parsed.executablePath)
+      exists: parsed.exists && (0, import_node_fs13.existsSync)(parsed.executablePath)
     };
   } catch (error) {
     return {
@@ -17797,14 +17991,14 @@ ${detail}` : ""}`
   }
   return { ok: true, executablePath: after.executablePath, installed: true };
 }
-var import_node_child_process5, import_node_fs12, import_node_module4, import_node_path13, PLAYWRIGHT_BROWSER_PROBE;
+var import_node_child_process5, import_node_fs13, import_node_module4, import_node_path14, PLAYWRIGHT_BROWSER_PROBE;
 var init_playwright_provisioning = __esm({
   "cli/drivers/playwright-provisioning.ts"() {
     "use strict";
     import_node_child_process5 = require("node:child_process");
-    import_node_fs12 = require("node:fs");
+    import_node_fs13 = require("node:fs");
     import_node_module4 = require("node:module");
-    import_node_path13 = require("node:path");
+    import_node_path14 = require("node:path");
     PLAYWRIGHT_BROWSER_PROBE = `
 const { existsSync } = require('node:fs');
 const modulePath = process.env.SOOTSIM_PW_MODULE;
@@ -17901,7 +18095,10 @@ async function launch2(opts) {
         SOOTSIM_PW_HEADLESS: opts.headless ?? true ? "1" : "0",
         SOOTSIM_PW_USERDATADIR: resolveUserDataDir(opts),
         SOOTSIM_PW_CDP_PORT: opts.cdpPort ? String(opts.cdpPort) : "",
-        SOOTSIM_PW_VIEWPORT: opts.viewport ? `${opts.viewport.width}x${opts.viewport.height}` : "",
+        // when the caller passed no viewport, leave the inherited
+        // SOOTSIM_PW_VIEWPORT (from playwrightEnv) alone instead of
+        // clobbering it with '' — the driver reads it as its own default.
+        ...opts.viewport ? { SOOTSIM_PW_VIEWPORT: `${opts.viewport.width}x${opts.viewport.height}` } : {},
         SOOTSIM_PW_CONNECTED_ACK_FILE: connectAckFile,
         SOOTSIM_PW_CONNECT_TIMEOUT_MS: String(opts.connectTimeoutMs ?? 12e4),
         SOOTSIM_PW_OWNER_PID: String(ownerPid)
@@ -18953,14 +19150,14 @@ function assertExplicitBridgeLock(preferredPort, explicitPort, lock) {
 }
 async function ensureRuntimeForOpen() {
   const active = readActiveRuntime();
-  if (active && import_node_fs13.default.existsSync(runtimeDir(active))) return;
+  if (active && import_node_fs14.default.existsSync(runtimeDir(active))) return;
   console.error("  installing rnx engine runtime...");
   const { runRuntime: runRuntime2 } = await Promise.resolve().then(() => (init_runtime(), runtime_exports));
   await runRuntime2(["install"], {});
 }
 function spawnSootsim(args) {
   const entry = process.argv[1];
-  if (entry && import_node_fs13.default.existsSync(entry)) {
+  if (entry && import_node_fs14.default.existsSync(entry)) {
     return (0, import_node_child_process6.spawn)(process.execPath, [entry, ...args], {
       detached: true,
       stdio: "ignore",
@@ -19107,10 +19304,10 @@ async function buildResolvedBundleOpenUrl(target, baseUrl, opts = {}) {
 }
 function normalizeReplacementPath(filePath) {
   if (filePath.startsWith("~/")) {
-    return import_node_path14.default.join(import_node_os3.default.homedir(), filePath.slice(2));
+    return import_node_path15.default.join(import_node_os3.default.homedir(), filePath.slice(2));
   }
-  if (import_node_path14.default.isAbsolute(filePath)) return filePath;
-  return import_node_path14.default.resolve(process.cwd(), filePath);
+  if (import_node_path15.default.isAbsolute(filePath)) return filePath;
+  return import_node_path15.default.resolve(process.cwd(), filePath);
 }
 function parseOpenRuntimeConfig(args) {
   const modules = {};
@@ -19129,7 +19326,7 @@ function parseOpenRuntimeConfig(args) {
       }
       const moduleName = raw.slice(0, eqIndex).trim();
       const filePath = normalizeReplacementPath(raw.slice(eqIndex + 1).trim());
-      if (!import_node_fs13.default.existsSync(filePath)) {
+      if (!import_node_fs14.default.existsSync(filePath)) {
         console.error(`  rnxsim open: replacement file not found: ${filePath}`);
         process.exit(1);
       }
@@ -19164,7 +19361,7 @@ async function resolveOpenAppProject(resolvedBundle) {
   return resolveAppProject(process.env.CONTRAST_REPO_DIR || process.cwd());
 }
 async function ensureConfiguredRuntime(version) {
-  if (import_node_fs13.default.existsSync(import_node_path14.default.join(runtimeDir(version), "index.html"))) return;
+  if (import_node_fs14.default.existsSync(import_node_path15.default.join(runtimeDir(version), "index.html"))) return;
   console.error(`  installing configured engine runtime ${version}...`);
   const result = await sootsimRuntime.install({
     version,
@@ -19528,7 +19725,7 @@ function playwrightHostPidForSim(sim) {
 function signalDriverLaunchConnected(result) {
   if (!result.connectAckFile) return false;
   try {
-    import_node_fs13.default.writeFileSync(
+    import_node_fs14.default.writeFileSync(
       result.connectAckFile,
       `${JSON.stringify({ connectedAt: Date.now(), pid: result.pid ?? null })}
 `,
@@ -19542,19 +19739,19 @@ function signalDriverLaunchConnected(result) {
 function printDriverDiagnosticLogTail(result) {
   if (!result.diagnosticLogPath) return;
   try {
-    const detail = import_node_fs13.default.readFileSync(result.diagnosticLogPath, "utf8").trim();
+    const detail = import_node_fs14.default.readFileSync(result.diagnosticLogPath, "utf8").trim();
     if (!detail) {
-      console.error(`  ${import_node_path14.default.basename(result.diagnosticLogPath)} was empty`);
+      console.error(`  ${import_node_path15.default.basename(result.diagnosticLogPath)} was empty`);
       return;
     }
     const shown = detail.length > 4e3 ? `\u2026
 ${detail.slice(-4e3)}` : detail;
-    console.error(`  ${import_node_path14.default.basename(result.diagnosticLogPath)}:`);
+    console.error(`  ${import_node_path15.default.basename(result.diagnosticLogPath)}:`);
     console.error(shown);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     console.error(
-      `  failed to read ${import_node_path14.default.basename(result.diagnosticLogPath)}: ${message}`
+      `  failed to read ${import_node_path15.default.basename(result.diagnosticLogPath)}: ${message}`
     );
   }
 }
@@ -19793,7 +19990,8 @@ async function runOpenCommand(args, opts = {}) {
       "--driver",
       "--profile",
       "--cdp-port",
-      "--device"
+      "--device",
+      "--viewport"
     ]
   });
   const requestedProfileId = args.find((_, i) => args[i - 1] === "--profile");
@@ -19900,6 +20098,15 @@ async function runOpenCommand(args, opts = {}) {
     process.exit(1);
   }
   const deviceSpec = deviceArg ? import_settings.devices[deviceArg] : void 0;
+  const viewportArg = args.find((_, i) => args[i - 1] === "--viewport");
+  const viewportMatch = viewportArg ? /^(\d+)x(\d+)$/.exec(viewportArg) : null;
+  if (viewportArg && !viewportMatch) {
+    console.error(
+      `  rnxsim open: --viewport must be <width>x<height>, got "${viewportArg}"`
+    );
+    process.exit(1);
+  }
+  const explicitViewport = viewportMatch ? { width: Number(viewportMatch[1]), height: Number(viewportMatch[2]) } : void 0;
   const buildShellUrlOpts = {
     hot: hotMode,
     device: deviceArg,
@@ -20048,7 +20255,7 @@ async function runOpenCommand(args, opts = {}) {
     cdpPort,
     device: deviceArg,
     ownerPid,
-    viewport: deviceSpec ? { width: deviceSpec.width + 120, height: deviceSpec.height + 60 } : void 0,
+    viewport: explicitViewport ?? (deviceSpec ? { width: deviceSpec.width + 120, height: deviceSpec.height + 60 } : void 0),
     connectTimeoutMs: connectWait.hostTimeoutMs
   });
   if (!result.launched) {
@@ -20350,14 +20557,14 @@ async function runCloseCommand(args, opts = {}) {
     bridge.close();
   }
 }
-var import_node_child_process6, import_node_fs13, import_node_os3, import_node_path14, import_settings, import_ws5, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS, DEEP_LINK_SCHEME_RE;
+var import_node_child_process6, import_node_fs14, import_node_os3, import_node_path15, import_settings, import_ws5, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS, DEEP_LINK_SCHEME_RE;
 var init_control = __esm({
   "cli/commands/control.ts"() {
     "use strict";
     import_node_child_process6 = require("node:child_process");
-    import_node_fs13 = __toESM(require("node:fs"), 1);
+    import_node_fs14 = __toESM(require("node:fs"), 1);
     import_node_os3 = __toESM(require("node:os"), 1);
-    import_node_path14 = __toESM(require("node:path"), 1);
+    import_node_path15 = __toESM(require("node:path"), 1);
     import_settings = require("sootsim-engine/settings");
     import_ws5 = require("ws");
     init_dev_server_scanner();
@@ -21139,14 +21346,14 @@ process.stdin.on('end', async () => {
 function getBaseDir() {
   const explicit = process.env[SESSION_FILE_ENV];
   if (explicit?.trim()) {
-    return (0, import_node_path15.dirname)((0, import_node_path15.resolve)(explicit));
+    return (0, import_node_path16.dirname)((0, import_node_path16.resolve)(explicit));
   }
   return electronUserDataDir();
 }
 function getSharedDesktopAuthFilePath() {
   const explicit = process.env[SESSION_FILE_ENV];
-  if (explicit?.trim()) return (0, import_node_path15.resolve)(explicit);
-  return (0, import_node_path15.join)(getBaseDir(), "desktop-auth.json");
+  if (explicit?.trim()) return (0, import_node_path16.resolve)(explicit);
+  return (0, import_node_path16.join)(getBaseDir(), "desktop-auth.json");
 }
 function normalizeUser(input) {
   if (!input || typeof input !== "object") return null;
@@ -21193,26 +21400,26 @@ function normalizeSession(input) {
 }
 function readSharedDesktopAuthSession() {
   const filepath = getSharedDesktopAuthFilePath();
-  if (!(0, import_node_fs14.existsSync)(filepath)) return null;
+  if (!(0, import_node_fs15.existsSync)(filepath)) return null;
   try {
-    const parsed = JSON.parse((0, import_node_fs14.readFileSync)(filepath, "utf8"));
+    const parsed = JSON.parse((0, import_node_fs15.readFileSync)(filepath, "utf8"));
     const normalized = normalizeSession(parsed);
     if (!normalized) {
-      (0, import_node_fs14.rmSync)(filepath, { force: true });
+      (0, import_node_fs15.rmSync)(filepath, { force: true });
       return null;
     }
     return normalized;
   } catch {
-    (0, import_node_fs14.rmSync)(filepath, { force: true });
+    (0, import_node_fs15.rmSync)(filepath, { force: true });
     return null;
   }
 }
-var import_node_fs14, import_node_path15, SESSION_VERSION, SESSION_FILE_ENV, DEFAULT_ORIGIN;
+var import_node_fs15, import_node_path16, SESSION_VERSION, SESSION_FILE_ENV, DEFAULT_ORIGIN;
 var init_shared_session = __esm({
   "src/auth/shared-session.ts"() {
     "use strict";
-    import_node_fs14 = require("node:fs");
-    import_node_path15 = require("node:path");
+    import_node_fs15 = require("node:fs");
+    import_node_path16 = require("node:path");
     init_home_paths();
     SESSION_VERSION = 1;
     SESSION_FILE_ENV = "SOOTSIM_SHARED_AUTH_FILE";
@@ -21475,16 +21682,16 @@ function resolveFlowScreenshotPath(screenshotDir, name2) {
 }
 function resolveProjectRelativeFlowBase(flowDir) {
   if (!flowDir) return process.cwd();
-  return path14.basename(flowDir) === ".maestro" ? path14.dirname(flowDir) : flowDir;
+  return path15.basename(flowDir) === ".maestro" ? path15.dirname(flowDir) : flowDir;
 }
 function resolveFlowScreenshotPathWithMode(screenshotDir, name2, opts) {
   const normalizedName = name2.endsWith(".png") ? name2 : `${name2}.png`;
-  if (path14.isAbsolute(normalizedName)) return normalizedName;
+  if (path15.isAbsolute(normalizedName)) return normalizedName;
   if (opts.mode === "flow" && /[\\/]/.test(normalizedName)) {
     const baseDir = normalizedName.startsWith("./") || normalizedName.startsWith("../") ? opts.flowDir ?? process.cwd() : resolveProjectRelativeFlowBase(opts.flowDir);
-    return path14.resolve(baseDir, normalizedName);
+    return path15.resolve(baseDir, normalizedName);
   }
-  return path14.join(screenshotDir, normalizedName);
+  return path15.join(screenshotDir, normalizedName);
 }
 function normalizeFlowScreenshotSpec(step) {
   if (typeof step === "string") {
@@ -21541,12 +21748,12 @@ function parseFlowSteps(content) {
   const parsed = import_yaml.default.parse(candidate);
   return Array.isArray(parsed) ? parsed : [];
 }
-var fs15, path14, import_settings3, import_yaml, DEFAULT_TIMEOUT, FLOW_TIMEOUT_SCALE, scaledTimeout, SCREEN_W, SCREEN_H, SootSimBridgeFlowRunner;
+var fs16, path15, import_settings3, import_yaml, DEFAULT_TIMEOUT, FLOW_TIMEOUT_SCALE, scaledTimeout, SCREEN_W, SCREEN_H, SootSimBridgeFlowRunner;
 var init_bridge_flow_runner = __esm({
   "cli/bridge-flow-runner.ts"() {
     "use strict";
-    fs15 = __toESM(require("fs"), 1);
-    path14 = __toESM(require("path"), 1);
+    fs16 = __toESM(require("fs"), 1);
+    path15 = __toESM(require("path"), 1);
     import_settings3 = require("sootsim-engine/settings");
     import_yaml = __toESM(require("yaml"), 1);
     init_frame_compose();
@@ -21657,6 +21864,15 @@ var init_bridge_flow_runner = __esm({
           args
         });
       }
+      // ordered input batch executed inside the page in one round-trip; the
+      // engine emits agent-cursor actions for every step natively.
+      async perform(steps) {
+        return this.bridge.send({
+          type: "perform",
+          simId: this.opts.simId,
+          steps
+        });
+      }
       async waitForTree(timeout = DEFAULT_TIMEOUT) {
         const deadline = Date.now() + scaledTimeout(timeout);
         const startedAt = Date.now();
@@ -21834,14 +22050,14 @@ var init_bridge_flow_runner = __esm({
         if (chunks.length === 0) {
           throw new Error("recording requested but no video buffer was produced");
         }
-        fs15.mkdirSync(this.opts.recordingOutputDir, { recursive: true });
+        fs16.mkdirSync(this.opts.recordingOutputDir, { recursive: true });
         const videoMime = stopped.mime || this.opts.recordingFormat || "video/webm";
         const extension = videoMime.includes("mp4") ? "mp4" : "webm";
-        const outputPath = path14.join(
+        const outputPath = path15.join(
           this.opts.recordingOutputDir,
           `sootsim-${Date.now()}.${extension}`
         );
-        fs15.writeFileSync(outputPath, Buffer.concat(chunks));
+        fs16.writeFileSync(outputPath, Buffer.concat(chunks));
         return outputPath;
       }
       async waitForRecordingTail(opts) {
@@ -22175,20 +22391,14 @@ var init_bridge_flow_runner = __esm({
         await sleep3(300);
       }
       async doubleTapAtCoords(x, y, gapMs = 80) {
-        const waitMs = Math.max(0, Math.round(gapMs));
-        const ok = await this.evaluate(`(async () => {
-      const interact = window.__sootsimInteract
-      if (interact?.doubleTap) {
-        return !!(await interact.doubleTap(${x}, ${y}, ${waitMs}))
-      }
-      if (!interact?.tap) return false
-      const first = await interact.tap(${x}, ${y})
-      if (!first || first.hit === false) return false
-      await new Promise((resolve) => setTimeout(resolve, ${waitMs}))
-      const second = await interact.tap(${x}, ${y})
-      return !!second && second.hit !== false
-    })()`);
-        if (!ok) throw new Error(`doubleTapAtCoords failed at (${x}, ${y})`);
+        const result = await this.perform([
+          { type: "doubleTap", x, y, gapMs: Math.max(0, Math.round(gapMs)) }
+        ]);
+        if (!result?.ok) {
+          throw new Error(
+            `doubleTapAtCoords failed at (${x}, ${y}): ${result?.error ?? "double tap missed"}`
+          );
+        }
         await sleep3(300);
       }
       async assertVisible(target) {
@@ -22350,7 +22560,7 @@ var init_bridge_flow_runner = __esm({
             flowDir: this.opts.flowDir
           }
         );
-        fs15.mkdirSync(path14.dirname(outputPath), { recursive: true });
+        fs16.mkdirSync(path15.dirname(outputPath), { recursive: true });
         const layers = spec.layers ?? this.opts.screenshotLayers;
         const screenshotRequest = {
           type: "screenshot",
@@ -22366,11 +22576,11 @@ var init_bridge_flow_runner = __esm({
             throw new Error("could not read current device model for framed screenshot");
           }
           const framed = await composeFramedScreenshot(rawBuffer, model);
-          fs15.writeFileSync(outputPath, framed);
+          fs16.writeFileSync(outputPath, framed);
           console.log(`[flow] screenshot: ${outputPath} (frame: ${model})`);
           return outputPath;
         }
-        fs15.writeFileSync(outputPath, rawBuffer);
+        fs16.writeFileSync(outputPath, rawBuffer);
         console.log(`[flow] screenshot: ${outputPath}`);
         return outputPath;
       }
@@ -22386,22 +22596,22 @@ var init_bridge_flow_runner = __esm({
         return model;
       }
       async captureScreenshot(outputPath) {
-        fs15.mkdirSync(path14.dirname(outputPath), { recursive: true });
+        fs16.mkdirSync(path15.dirname(outputPath), { recursive: true });
         const dataUrl = await this.bridge.send({
           type: "screenshot",
           simId: this.opts.simId
         });
         const base64 = dataUrl.replace(/^data:image\/png;base64,/, "");
-        fs15.writeFileSync(outputPath, Buffer.from(base64, "base64"));
+        fs16.writeFileSync(outputPath, Buffer.from(base64, "base64"));
       }
       // writes a per-failure debug bundle: screenshot + structured describe
       // + a11y tree + console errors/warnings + failed network requests +
       // shell state, all under one directory so post-mortem is one grep away.
       async captureFailureBundle(outputDir, context) {
-        fs15.mkdirSync(outputDir, { recursive: true });
+        fs16.mkdirSync(outputDir, { recursive: true });
         const write = (name2, content) => {
           try {
-            fs15.writeFileSync(path14.join(outputDir, name2), content);
+            fs16.writeFileSync(path15.join(outputDir, name2), content);
           } catch {
           }
         };
@@ -22529,14 +22739,19 @@ var init_bridge_flow_runner = __esm({
         await this.drag(fromX, fromY, toX, toY, steps, 16);
       }
       async drag(fromX, fromY, toX, toY, steps = 12, stepMs = 16) {
-        const result = await this.evaluate(`(async () => {
-      const interact = window.__sootsimInteract
-      if (!interact?.drag) return { ok: false }
-      const value = await interact.drag(${fromX}, ${fromY}, ${toX}, ${toY}, ${Math.max(1, Math.round(steps))}, ${Math.max(0, Math.round(stepMs))})
-      return { ok: !!value, value }
-    })()`);
+        const result = await this.perform([
+          {
+            type: "drag",
+            fromX,
+            fromY,
+            toX,
+            toY,
+            steps: Math.max(1, Math.round(steps)),
+            stepMs: Math.max(0, Math.round(stepMs))
+          }
+        ]);
         if (!result?.ok) {
-          throw new Error("drag failed");
+          throw new Error(`drag failed: ${result?.error ?? "drag missed"}`);
         }
         await sleep3(300);
       }
@@ -22585,18 +22800,23 @@ var init_bridge_flow_runner = __esm({
         await sleep3(250);
       }
       async pinch(opts) {
-        const result = await this.evaluate(`(async () => {
-      const interact = window.__sootsimInteract
-      if (!interact?.pinch) return { ok: false, reason: 'no interact.pinch' }
-      const ok = await interact.pinch(
-        ${opts.from[0]}, ${opts.from[1]}, ${opts.from[2]}, ${opts.from[3]},
-        ${opts.to[0]}, ${opts.to[1]}, ${opts.to[2]}, ${opts.to[3]},
-        ${opts.steps || 12}, ${opts.stepMs || 16}
-      )
-      return { ok: !!ok, reason: ok ? null : 'pinch returned false' }
-    })()`);
+        const result = await this.perform([
+          {
+            type: "pinch",
+            fromX1: opts.from[0],
+            fromY1: opts.from[1],
+            fromX2: opts.from[2],
+            fromY2: opts.from[3],
+            toX1: opts.to[0],
+            toY1: opts.to[1],
+            toX2: opts.to[2],
+            toY2: opts.to[3],
+            steps: opts.steps || 12,
+            stepMs: opts.stepMs || 16
+          }
+        ]);
         if (!result?.ok) {
-          throw new Error(`pinch failed: ${result?.reason || "unknown error"}`);
+          throw new Error(`pinch failed: ${result?.error || "unknown error"}`);
         }
         await sleep3(250);
       }
@@ -22673,43 +22893,31 @@ var init_bridge_flow_runner = __esm({
         }
         throw new Error("extendedWaitUntil timed out");
       }
-      // relaunch the guest app for a clearState/launchApp step. two phases:
-      //   1. clear tenant-scoped storage through the engine bridge (best-effort).
-      //   2. ALWAYS hard-reload the page to reset the tenant worker.
-      // phase 2 is the important one for a long suite: the engine soft reload alone
-      // keeps the same worker alive across every flow, so a saturated event loop /
-      // accumulated state from one flow's post-PDS-reset auth-failure storm carries
-      // into the next and degrades until the worker wedges or the tab crashes (the
-      // failures clustered in the tail of a 21-flow run). a full page reload starts
-      // each flow on a fresh worker — worker-independent, so it also recovers a
-      // worker the bridge clear couldn't even ack. storage persists across a page
-      // reload, so the clear in phase 1 is what actually logs the guest out.
-      async reloadGuestApp(resetStorage) {
-        if (resetStorage) {
-          const ATTEMPTS = 3;
-          const PER_ATTEMPT_MS = 2e4;
-          let cleared = false;
-          for (let attempt = 0; attempt < ATTEMPTS && !cleared; attempt++) {
-            try {
-              cleared = await this.evaluate(
-                resetGuestAppStateEval(true),
-                PER_ATTEMPT_MS
-              );
-            } catch {
-              await sleep3(1e3);
-            }
-          }
-          if (!cleared) {
-            console.warn(
-              "  warn: tenant storage clear did not ack \u2014 hard-reloading anyway (worker reset follows)"
-            );
-          }
-        }
+      async reloadGuestApp() {
         await this.evaluate("window.location.reload()").catch(() => {
         });
         await sleep3(500);
         await this.refreshSimId();
       }
+      async resetGuestAppData() {
+        const reset = await this.bridge.send(
+          {
+            type: "reset",
+            simId: this.opts.simId,
+            resetOptions: { strategy: "data" }
+          },
+          { timeoutMs: 12e4 }
+        );
+        if (!reset.ok) {
+          throw new Error(reset.error ?? "guest app data reset failed");
+        }
+        if (!reset.relaunched) {
+          throw new Error("guest app data reset did not relaunch the app");
+        }
+        if (reset.workerReloaded !== true) {
+          throw new Error("guest app data reset did not replace the tenant worker");
+        }
+      }
       async softReloadGuestApp(resetStorage) {
         const reloaded = await this.evaluate(
           resetGuestAppStateEval(resetStorage),
@@ -22758,7 +22966,11 @@ var init_bridge_flow_runner = __esm({
           await this.waitForTree(3e4);
         } else {
           this.firstLaunchDone = true;
-          await this.reloadGuestApp(wantsClear);
+          if (wantsClear) {
+            await this.resetGuestAppData();
+          } else {
+            await this.reloadGuestApp();
+          }
           await this.waitForTree(12e4);
           if (this.opts.onAfterLaunch) {
             try {
@@ -22871,13 +23083,12 @@ var init_bridge_flow_runner = __esm({
       // nearest equivalent to killing and later re-launching the tenant runtime.
       // State clearing belongs to clearState / launchApp({ clearState: true }).
       async stopApp() {
-        await this.reloadGuestApp(false);
+        await this.reloadGuestApp();
         await this.rearmCaptureAfterRuntimeReload();
       }
-      // maestro clearState: wipe app-owned storage and relaunch fresh. routes
-      // through the same engine soft-reload launchApp uses under `clearState: true`.
+      // maestro clearState: wipe app-owned storage and relaunch fresh.
       async clearState() {
-        await this.reloadGuestApp(true);
+        await this.resetGuestAppData();
         await this.rearmCaptureAfterRuntimeReload();
       }
       // maestro clearKeychain: there is no real keychain in sootsim's browser
@@ -22919,8 +23130,8 @@ var init_bridge_flow_runner = __esm({
       runScript(target) {
         const spec = typeof target === "string" ? { file: target } : target;
         if (!spec.file) throw new Error("runScript requires a file");
-        const scriptPath = path14.resolve(this.opts.flowDir, spec.file);
-        const source = fs15.readFileSync(scriptPath, "utf8");
+        const scriptPath = path15.resolve(this.opts.flowDir, spec.file);
+        const source = fs16.readFileSync(scriptPath, "utf8");
         this.js.evaluate(source, { env: spec.env });
         console.log(`[flow]   runScript: ${spec.file} done`);
       }
@@ -23214,10 +23425,10 @@ var init_bridge_flow_runner = __esm({
               for (const [k, v] of Object.entries(env)) this.js.putEnv(k, v);
             }
             if (file) {
-              const flowPath = path14.resolve(this.opts.flowDir, file);
-              const flowContent = fs15.readFileSync(flowPath, "utf8");
+              const flowPath = path15.resolve(this.opts.flowDir, file);
+              const flowContent = fs16.readFileSync(flowPath, "utf8");
               const previousDir = this.opts.flowDir;
-              this.opts.flowDir = path14.dirname(flowPath);
+              this.opts.flowDir = path15.dirname(flowPath);
               try {
                 await this.runFlow(parseFlowSteps(flowContent));
               } finally {
@@ -23372,8 +23583,8 @@ __export(registry_exports, {
   skillRegistry: () => skillRegistry
 });
 module.exports = __toCommonJS(registry_exports);
-var fs16 = __toESM(require("fs"), 1);
-var path15 = __toESM(require("path"), 1);
+var fs17 = __toESM(require("fs"), 1);
+var path16 = __toESM(require("path"), 1);
 
 // src/skills/builtin/a11y-review.ts
 init_reap_browser();
@@ -23392,8 +23603,8 @@ var skill = {
       },
       async execute(params, context) {
         const { chromium } = await import("playwright");
-        const path16 = await import("path");
-        const fs17 = await import("fs");
+        const path17 = await import("path");
+        const fs18 = await import("fs");
         const browser = await launchReapedChrome((options) => chromium.launch(options), {
           headless: true
         });
@@ -23448,9 +23659,9 @@ var skill = {
             warnings: issues.filter((i) => i.severity === "warning").length,
             tree: typeof tree === "string" ? tree : JSON.stringify(tree)
           };
-          const reportPath = path16.join(context.outputDir, "a11y-report.json");
-          fs17.mkdirSync(path16.dirname(reportPath), { recursive: true });
-          fs17.writeFileSync(reportPath, JSON.stringify(report, null, 2));
+          const reportPath = path17.join(context.outputDir, "a11y-report.json");
+          fs18.mkdirSync(path17.dirname(reportPath), { recursive: true });
+          fs18.writeFileSync(reportPath, JSON.stringify(report, null, 2));
           return {
             success: issues.filter((i) => i.severity === "error").length === 0,
             message: `${report.errors} errors, ${report.warnings} warnings across ${report.nodeCount} nodes`,
@@ -23483,14 +23694,14 @@ var skill2 = {
         }
       },
       async execute(params, context) {
-        const fs17 = await import("node:fs");
-        const path16 = await import("node:path");
+        const fs18 = await import("node:fs");
+        const path17 = await import("node:path");
         const { COMPAT_RESULT_CAVEAT: COMPAT_RESULT_CAVEAT2, formatPackageStatus: formatPackageStatus2, formatScanCounts: formatScanCounts2, scanDeps: scanDeps2 } = await Promise.resolve().then(() => (init_web(), web_exports));
-        const packagePath = path16.join(context.projectDir, "package.json");
-        if (!fs17.existsSync(packagePath)) {
+        const packagePath = path17.join(context.projectDir, "package.json");
+        if (!fs18.existsSync(packagePath)) {
           return { success: false, message: "No package.json found" };
         }
-        const parsed = JSON.parse(fs17.readFileSync(packagePath, "utf8"));
+        const parsed = JSON.parse(fs18.readFileSync(packagePath, "utf8"));
         if (!parsed || typeof parsed !== "object") {
           return { success: false, message: "package.json is not an object" };
         }
@@ -23502,9 +23713,9 @@ var skill2 = {
         }) : scanDeps2(parsed);
         const packageResult = params.packageName ? scan.packages[0] : void 0;
         const message = packageResult ? `${params.packageName}: ${formatPackageStatus2(packageResult)}. ${COMPAT_RESULT_CAVEAT2}` : `${formatScanCounts2(scan)}. ${COMPAT_RESULT_CAVEAT2}`;
-        const reportPath = path16.join(context.outputDir, "compat-report.json");
-        fs17.mkdirSync(path16.dirname(reportPath), { recursive: true });
-        fs17.writeFileSync(reportPath, `${JSON.stringify(scan, null, 2)}
+        const reportPath = path17.join(context.outputDir, "compat-report.json");
+        fs18.mkdirSync(path17.dirname(reportPath), { recursive: true });
+        fs18.writeFileSync(reportPath, `${JSON.stringify(scan, null, 2)}
 `);
         return {
           success: true,
@@ -23548,8 +23759,8 @@ var skill3 = {
         record: { type: "boolean", description: "Record video of the flow" }
       },
       async execute(params, context) {
-        const fs17 = await import("fs");
-        const path16 = await import("path");
+        const fs18 = await import("fs");
+        const path17 = await import("path");
         const yaml2 = await import("yaml");
         const { DEFAULT_SOOTSIM_BRIDGE_PORT: DEFAULT_SOOTSIM_BRIDGE_PORT2 } = await Promise.resolve().then(() => (init_bridge_constants(), bridge_constants_exports));
         const { SootSimBridgeHost: SootSimBridgeHost2 } = await Promise.resolve().then(() => (init_bridge_host(), bridge_host_exports));
@@ -23559,7 +23770,7 @@ var skill3 = {
         const host = new SootSimBridgeHost2({ port: DEFAULT_SOOTSIM_BRIDGE_PORT2 });
         host.start({ silent: true });
         try {
-          const flowContent = fs17.readFileSync(params.flowPath, "utf8");
+          const flowContent = fs18.readFileSync(params.flowPath, "utf8");
           const fmMatch = flowContent.match(/^---\n([\s\S]*?)\n---\n?/);
           const stepsBody = fmMatch ? flowContent.slice(fmMatch[0].length) : flowContent;
           const steps = yaml2.parse(stepsBody);
@@ -23586,7 +23797,7 @@ var skill3 = {
           });
           const driver = new SootSimBridgeFlowRunner2(bridge, {
             screenshotDir: context.outputDir,
-            flowDir: path16.dirname(path16.resolve(params.flowPath)),
+            flowDir: path17.dirname(path17.resolve(params.flowPath)),
             simId,
             recordingOutputDir: params.record ? context.outputDir : void 0
           });
@@ -23608,7 +23819,7 @@ var skill3 = {
                 simId,
                 videoPath: videoPath || void 0
               },
-              artifacts: videoPath ? [{ type: "video", name: path16.basename(videoPath), path: videoPath }] : void 0
+              artifacts: videoPath ? [{ type: "video", name: path17.basename(videoPath), path: videoPath }] : void 0
             };
           } finally {
             try {
@@ -23655,8 +23866,8 @@ var skill4 = {
       },
       async execute(params, context) {
         const { chromium } = await import("playwright");
-        const path16 = await import("path");
-        const fs17 = await import("fs");
+        const path17 = await import("path");
+        const fs18 = await import("fs");
         const browser = await launchReapedChrome((options) => chromium.launch(options), {
           headless: true
         });
@@ -23682,9 +23893,9 @@ var skill4 = {
             ...profile,
             fps: syncCount > 0 ? (syncCount / (duration / 1e3)).toFixed(1) : "0"
           };
-          const reportPath = path16.join(context.outputDir, "perf-report.json");
-          fs17.mkdirSync(path16.dirname(reportPath), { recursive: true });
-          fs17.writeFileSync(reportPath, JSON.stringify(report, null, 2));
+          const reportPath = path17.join(context.outputDir, "perf-report.json");
+          fs18.mkdirSync(path17.dirname(reportPath), { recursive: true });
+          fs18.writeFileSync(reportPath, JSON.stringify(report, null, 2));
           return {
             success: true,
             message: `${report.fps} fps, ${profile.avgSyncMs?.toFixed(1)}ms avg sync, ${nodeCount} nodes`,
@@ -23717,8 +23928,8 @@ var skill5 = {
       },
       async execute(params, context) {
         const { chromium } = await import("playwright");
-        const path16 = await import("path");
-        const fs17 = await import("fs");
+        const path17 = await import("path");
+        const fs18 = await import("fs");
         const browser = await launchReapedChrome((options) => chromium.launch(options), {
           headless: true
         });
@@ -23726,8 +23937,8 @@ var skill5 = {
         try {
           await page.goto(context.url, { waitUntil: "networkidle" });
           await page.waitForTimeout(2e3);
-          const outputPath = path16.join(context.outputDir, `${params.name}.png`);
-          fs17.mkdirSync(path16.dirname(outputPath), { recursive: true });
+          const outputPath = path17.join(context.outputDir, `${params.name}.png`);
+          fs18.mkdirSync(path17.dirname(outputPath), { recursive: true });
           await page.screenshot({ path: outputPath });
           return {
             success: true,
@@ -23768,8 +23979,8 @@ var skill6 = {
       },
       async execute(params, context) {
         const { chromium } = await import("playwright");
-        const path16 = await import("path");
-        const fs17 = await import("fs");
+        const path17 = await import("path");
+        const fs18 = await import("fs");
         const browser = await launchReapedChrome((options) => chromium.launch(options), {
           headless: true
         });
@@ -23777,14 +23988,14 @@ var skill6 = {
         try {
           await page.goto(context.url, { waitUntil: "networkidle" });
           await page.waitForTimeout(2e3);
-          const currentPath = path16.join(context.outputDir, `${params.name}-current.png`);
-          fs17.mkdirSync(path16.dirname(currentPath), { recursive: true });
+          const currentPath = path17.join(context.outputDir, `${params.name}-current.png`);
+          fs18.mkdirSync(path17.dirname(currentPath), { recursive: true });
           await page.screenshot({ path: currentPath });
           try {
             const { PNG } = await import("pngjs");
             const pixelmatch = (await import("pixelmatch")).default;
-            const baseline = PNG.sync.read(fs17.readFileSync(params.baseline));
-            const current = PNG.sync.read(fs17.readFileSync(currentPath));
+            const baseline = PNG.sync.read(fs18.readFileSync(params.baseline));
+            const current = PNG.sync.read(fs18.readFileSync(currentPath));
             const { width, height } = baseline;
             const diff = new PNG({ width, height });
             const numDiffPixels = pixelmatch(
@@ -23795,8 +24006,8 @@ var skill6 = {
               height,
               { threshold: params.threshold || 0.1 }
             );
-            const diffPath = path16.join(context.outputDir, `${params.name}-diff.png`);
-            fs17.writeFileSync(diffPath, PNG.sync.write(diff));
+            const diffPath = path17.join(context.outputDir, `${params.name}-diff.png`);
+            fs18.writeFileSync(diffPath, PNG.sync.write(diff));
             const totalPixels = width * height;
             const diffPercent = (numDiffPixels / totalPixels * 100).toFixed(2);
             return {
@@ -23860,10 +24071,10 @@ var skillRegistry = {
   },
   // load skills from a project manifest (sootsim-skills.json)
   async loadFromManifest(projectDir) {
-    const manifestPath = path15.join(projectDir, "sootsim-skills.json");
-    if (!fs16.existsSync(manifestPath)) return;
+    const manifestPath = path16.join(projectDir, "sootsim-skills.json");
+    if (!fs17.existsSync(manifestPath)) return;
     try {
-      const manifest = JSON.parse(fs16.readFileSync(manifestPath, "utf8"));
+      const manifest = JSON.parse(fs17.readFileSync(manifestPath, "utf8"));
       if (Array.isArray(manifest.skills)) {
         for (const entry of manifest.skills) {
           if (typeof entry === "string") {
@@ -23874,7 +24085,7 @@ var skillRegistry = {
             }
           } else if (entry.file) {
             try {
-              const mod = await import(path15.resolve(projectDir, entry.file));
+              const mod = await import(path16.resolve(projectDir, entry.file));
               if (mod.skill) this.register(mod.skill);
             } catch {
             }
@@ -23887,10 +24098,10 @@ var skillRegistry = {
   // auto-discover skills based on project dependencies
   suggestSkills(projectDir) {
     const suggestions = [];
-    const pkgPath = path15.join(projectDir, "package.json");
-    if (!fs16.existsSync(pkgPath)) return suggestions;
+    const pkgPath = path16.join(projectDir, "package.json");
+    if (!fs17.existsSync(pkgPath)) return suggestions;
     try {
-      const pkg = JSON.parse(fs16.readFileSync(pkgPath, "utf8"));
+      const pkg = JSON.parse(fs17.readFileSync(pkgPath, "utf8"));
       const deps = { ...pkg.dependencies, ...pkg.devDependencies };
       if (deps["detox"] || deps["maestro"]) {
         suggestions.push("maestro-test");