peachsim 0.1.657 → 0.1.658

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.657 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.658 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -4511,6 +4511,8 @@ var init_supported_native_packages = __esm({
       // seam+coverage
       "@react-native-firebase/app",
       // seam+coverage
+      "@react-native-firebase/app-check",
+      // seam
       "@react-native-firebase/auth",
       // seam
       "@react-native-firebase/crashlytics",
@@ -5265,6 +5267,8 @@ var init_supported_native_packages = __esm({
       // seam
       "react-native-worklets",
       // preset+coverage
+      "react-native-worklets-core",
+      // seam
       "react-native-xxhash",
       // seam+coverage
       "react-native-youtube",
@@ -7372,11 +7376,11 @@ var init_registry = __esm({
         stubType: "native",
         versions: [
           {
-            range: ">=18.0.0",
-            coverage: 0,
-            note: "the reference iOS simulator performs this package's behavior. Peach currently provides only this unsupported shape: development token noop : App Check API shape resolves with stub tokens. imports and API shape receive no behavior credit",
-            working: "default appCheck(), activate, setTokenAutoRefreshEnabled, getToken, onTokenChanged",
-            missing: "real attestation provider, token refresh, enforcement with Firebase services"
+            range: ">=23.0.0",
+            coverage: 0.8,
+            note: "native-seam only. the published app-check JS runs over NativeRNFBTurboAppCheck, which mirrors RNFBAppCheckModule and a port of AppCheckCore token caching. the debug provider exchanges its token at firebaseappcheck.googleapis.com, so a debug token registered in the Firebase console yields real tokens, and the firebase js sdk services behind the other RNFB seams attach them. DeviceCheck and App Attest report the unsupported-attestation-provider error a device without DCDevice support reports",
+            working: "initializeAppCheck and activate, configureProvider for debug, deviceCheck, appAttest and appAttestWithDeviceCheckFallback, getToken with caching and forced refresh, getLimitedUseToken, token auto-refresh setting, provider-not-ready and token-error rejections, debug token logging and persistence",
+            missing: "Apple-signed DeviceCheck and App Attest attestation"
           }
         ]
       },
@@ -9900,8 +9904,8 @@ var init_registry = __esm({
           {
             range: ">=125.0.0",
             coverage: 0.85,
-            note: "load-safe noop \u2014 registerGlobals/setupReactNativeWebRTC accept calls; on web the global navigator.mediaDevices / RTCPeerConnection are already present so no patching is required",
-            missing: "no native iOS/Android WebRTC bindings. apps that need raw camera capture should use the browser getUserMedia API directly"
+            note: "published JS runs over WebRTCModule backed by browser peers, capture, data channels, stats, RTCView frames and encryption. recording aliases share one pending capture; stop and disposal invalidate it. device playout controls existing and incoming audio receivers",
+            missing: "AVAudioSession categories and hardware audio routing have no browser equivalent"
           }
         ]
       },
@@ -10012,9 +10016,9 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=1.0.0",
-            coverage: 0.5,
-            note: "callbacks run, but every worklet stays on the main JavaScript thread while the reference iOS simulator executes worklets on their dedicated runtime",
-            missing: "no off-thread JS execution (matches our react-native-worklets-pkg stub story). complex worklet pipelines that actually need parallelism will see degraded performance, not crashes"
+            coverage: 0.85,
+            note: "published JS over the Worklets TurboModule: contexts run worklets on their own worker runtimes, createRunOnJS and cross-context calls settle promises on the calling thread, and shared values replicate writes and listeners across runtimes",
+            missing: "shared value writes replicate in order instead of under one mutex, so simultaneous writes from two threads can briefly disagree; a worklet a context received and passes to another context loses its captured closure"
           }
         ]
       },
@@ -10023,10 +10027,10 @@ var init_registry = __esm({
         stubType: "native",
         versions: [
           {
-            range: ">=125.0.0",
+            range: ">=124.0.0",
             coverage: 0.7,
-            note: "load-safe pass-through \u2014 RTCPeerConnection / RTCIceCandidate / RTCSessionDescription / MediaStream / MediaStreamTrack / mediaDevices forwarded from globalThis (browsers have these natively); registerGlobals is a noop; RTCView component renders null since we have no host-side video bridge yet",
-            missing: "RTCView visual rendering needs a host bridge that paints a video element into the device frame (deferred). raw audio/video peer connections work via the browser globals"
+            note: "published JS runs over WebRTCModule backed by browser peer connections, capture, native events, data channels, stats and live RTCView frames. audio receivers obey device playout state",
+            missing: "native hardware audio routing has no browser equivalent"
           }
         ]
       },
@@ -19241,7 +19245,7 @@ function hasOwnKeys(value) {
 }
 function hasPeachConfig(config) {
   if (!config) return false;
-  return typeof config.runtimeVersion === "string" && config.runtimeVersion.length > 0 || hasOwnKeys(config.modules) || hasOwnKeys(config.turboModules) || hasOwnKeys(config.nativeModules) || hasOwnKeys(config.env) || hasOwnKeys(config.network?.remap) || hasOwnKeys(config.settings) || hasOwnKeys(config.initialState);
+  return typeof config.runtimeVersion === "string" && config.runtimeVersion.length > 0 || hasOwnKeys(config.modules) || hasOwnKeys(config.turboModules) || hasOwnKeys(config.nativeModules) || hasOwnKeys(config.nativeViews) || hasOwnKeys(config.env) || hasOwnKeys(config.network?.remap) || hasOwnKeys(config.settings) || hasOwnKeys(config.initialState);
 }
 function mergePeachConfig(base, override) {
   if (!hasPeachConfig(base) && !hasPeachConfig(override)) return void 0;
@@ -19255,6 +19259,7 @@ function mergePeachConfig(base, override) {
       ...base.nativeModules || {},
       ...override.nativeModules || {}
     },
+    nativeViews: { ...base.nativeViews || {}, ...override.nativeViews || {} },
     env: { ...base.env || {}, ...override.env || {} },
     network: {
       remap: { ...base.network?.remap || {}, ...override.network?.remap || {} }
@@ -24083,12 +24088,15 @@ function transformsFor(filePath) {
       );
   }
 }
+function isLocalSpecifier(specifier) {
+  return specifier.startsWith("./") || specifier.startsWith("../");
+}
 function isContrastKitSpecifier(specifier) {
   return specifier === "contrast-kit" || specifier.startsWith("contrast-kit/");
 }
 function unsupportedSpecifier(specifier) {
   return new Error(
-    `replacement modules may only import react, react-native, contrast-kit, and the packages rnx stubs for this app; '${specifier}' is none of those. vendor the code into the replacement file, or add the package to peach.config so the simulator bridges it.`
+    `replacement modules may only import react, react-native, contrast-kit, the packages rnx stubs for this app, and other project files by relative path; '${specifier}' is none of those. vendor the code into a project file, or add the package to peach.config so the simulator bridges it.`
   );
 }
 function bridgeDeclaration(name2, specifier) {
@@ -24111,11 +24119,9 @@ function compileReplacementModule(input) {
   const transformed = (0, import_dist.transform)(input.source, {
     transforms: transformsFor(input.filePath),
     filePath: input.filePath,
-    // classic runtime, matching what the app's own Metro build does for a file
-    // that has no automatic-runtime pragma: the file imports React itself.
-    jsxRuntime: "classic",
-    jsxPragma: "React.createElement",
-    jsxFragmentPragma: "React.Fragment",
+    // the automatic runtime, as @react-native/babel-preset and babel-preset-expo
+    // compile the app's own files: jsx needs no React import.
+    jsxRuntime: "automatic",
     production: true,
     sourceMapOptions: { compiledFilename: input.filePath }
   });
@@ -24142,6 +24148,13 @@ function compileReplacementModule(input) {
     return name2;
   };
   const edits = [];
+  const pointAtLocalModule = (specifierToken, specifier) => {
+    edits.push({
+      start: specifierToken.start,
+      end: specifierToken.end,
+      text: JSON.stringify(input.localModuleUrl(specifier))
+    });
+  };
   for (let index = 0; index < tokens.length; index++) {
     const token = tokens[index];
     if (token.type === EXPORT_KEYWORD) {
@@ -24161,6 +24174,10 @@ function compileReplacementModule(input) {
       }
       if (fromAt > 0 && tokens[fromAt] && read(tokens[fromAt]) === "from" && tokens[fromAt + 1]?.type === import_types.TokenType.string) {
         const specifier2 = readSpecifier(tokens[fromAt + 1]);
+        if (isLocalSpecifier(specifier2)) {
+          pointAtLocalModule(tokens[fromAt + 1], specifier2);
+          continue;
+        }
         throw new Error(
           `a replacement module cannot re-export from another module, and this one re-exports from '${specifier2}'. import what you need and export the binding.`
         );
@@ -24213,6 +24230,10 @@ function compileReplacementModule(input) {
     const specifierToken = tokens[cursor];
     if (!specifierToken) throw new Error("replacement module import is unterminated");
     const specifier = readSpecifier(specifierToken);
+    if (isLocalSpecifier(specifier)) {
+      pointAtLocalModule(specifierToken, specifier);
+      continue;
+    }
     if (specifier !== "react" && specifier !== "react-native" && !JSX_RUNTIME_SPECIFIERS.has(specifier) && !isContrastKitSpecifier(specifier) && !input.runtimePackages.has(specifier)) {
       throw unsupportedSpecifier(specifier);
     }
@@ -24278,6 +24299,25 @@ function sendJavaScript(req, res, source) {
   });
   res.end(req.method === "HEAD" ? void 0 : source);
 }
+function resolveLocalImport(fromFile, specifier) {
+  const base = import_node_path14.default.resolve(import_node_path14.default.dirname(fromFile), specifier);
+  const candidates = [
+    ...REPLACEMENT_MODULE_EXTENSIONS.some(
+      (ext) => ext === import_node_path14.default.extname(base).toLowerCase()
+    ) ? [base] : [],
+    ...REPLACEMENT_MODULE_EXTENSIONS.map((ext) => base + ext),
+    ...REPLACEMENT_MODULE_EXTENSIONS.map((ext) => import_node_path14.default.join(base, `index${ext}`))
+  ];
+  const found = candidates.find(
+    (candidate) => (0, import_node_fs14.statSync)(candidate, { throwIfNoEntry: false })?.isFile()
+  );
+  if (!found) {
+    throw new Error(
+      `'${specifier}' imported by ${fromFile} matches no ${REPLACEMENT_MODULE_EXTENSIONS.join(", ")} file`
+    );
+  }
+  return found;
+}
 function isReplacementModuleRequestUrl(rawUrl) {
   if (!rawUrl) return false;
   try {
@@ -24368,7 +24408,14 @@ async function handleReplacementModuleRequest(req, res, options = {}) {
     const compiled = compileReplacementModule({
       filePath: resolvedTargetPath,
       source: await import_promises5.default.readFile(resolvedTargetPath, "utf8"),
-      runtimePackages
+      runtimePackages,
+      // the imported file's url is this request's with only its path changed,
+      // so the token, cache key and runtime packages carry over.
+      localModuleUrl: (specifier) => {
+        const local = new URL(url.href);
+        local.searchParams.set("path", resolveLocalImport(targetPath, specifier));
+        return `${local.pathname}${local.search}`;
+      }
     });
     const map = Buffer.from(JSON.stringify(compiled.sourceMap), "utf8").toString("base64");
     sendJavaScript(
@@ -24385,10 +24432,11 @@ async function handleReplacementModuleRequest(req, res, options = {}) {
   }
   return true;
 }
-var import_promises5, import_node_path14, REPLACEMENT_MODULE_ROUTE;
+var import_node_fs14, import_promises5, import_node_path14, REPLACEMENT_MODULE_ROUTE;
 var init_replacement_module_handler = __esm({
   "src/host/replacement-module-handler.ts"() {
     "use strict";
+    import_node_fs14 = require("node:fs");
     import_promises5 = __toESM(require("node:fs/promises"), 1);
     import_node_path14 = __toESM(require("node:path"), 1);
     init_replacementModule();
@@ -24733,25 +24781,25 @@ 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_path15, 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_fs15 = require("node:fs");
     import_node_path15 = require("node:path");
     init_home_paths();
     SESSION_VERSION = 1;
@@ -28222,7 +28270,7 @@ function detectFramework2(deps) {
 }
 function detectProject(dir) {
   const pkgPath = (0, import_node_path16.join)(dir, "package.json");
-  if (!(0, import_node_fs15.existsSync)(pkgPath)) return null;
+  if (!(0, import_node_fs16.existsSync)(pkgPath)) return null;
   const pkg = readProjectManifest(dir);
   if (!pkg) return null;
   const deps = { ...pkg.dependencies, ...pkg.devDependencies };
@@ -28240,19 +28288,19 @@ function detectProject(dir) {
     // apps write .cjs as often as .js, and missing one reads as "this project
     // has no bundler config" and sends the user to create a second one.
     hasViteConfig: CONFIG_EXTENSIONS.some(
-      (ext) => (0, import_node_fs15.existsSync)((0, import_node_path16.join)(dir, `vite.config.${ext}`))
+      (ext) => (0, import_node_fs16.existsSync)((0, import_node_path16.join)(dir, `vite.config.${ext}`))
     ),
     hasMetroConfig: CONFIG_EXTENSIONS.some(
-      (ext) => (0, import_node_fs15.existsSync)((0, import_node_path16.join)(dir, `metro.config.${ext}`))
+      (ext) => (0, import_node_fs16.existsSync)((0, import_node_path16.join)(dir, `metro.config.${ext}`))
     ),
     devCommand: typeof devCommand === "string" ? devCommand : null
   };
 }
 function readProjectMetadata(path23) {
   try {
-    const info = (0, import_node_fs15.lstatSync)(path23);
+    const info = (0, import_node_fs16.lstatSync)(path23);
     if (!info.isFile() || info.size > 4 * 1024 * 1024) return null;
-    return (0, import_node_fs15.readFileSync)(path23, "utf8");
+    return (0, import_node_fs16.readFileSync)(path23, "utf8");
   } catch {
     return null;
   }
@@ -28289,11 +28337,11 @@ function readProjectManifest(dir) {
     devDependencies: record(metadataValue(parsed, "devDependencies"))
   };
 }
-var import_node_fs15, import_node_path16, import_json5, import_yaml, CONFIG_EXTENSIONS;
+var import_node_fs16, import_node_path16, import_json5, import_yaml, CONFIG_EXTENSIONS;
 var init_detect = __esm({
   "cli/commands/detect.ts"() {
     "use strict";
-    import_node_fs15 = require("node:fs");
+    import_node_fs16 = require("node:fs");
     import_node_path16 = require("node:path");
     import_json5 = __toESM(require("json5"), 1);
     import_yaml = require("yaml");
@@ -28335,17 +28383,17 @@ function readImmutableBundleSource(bundlePath) {
   if ((0, import_node_path17.extname)(filepath) !== ".js") {
     throw new Error(`${REMOTE_COMMAND} requires one local Metro .js bundle`);
   }
-  const descriptor = (0, import_node_fs16.openSync)(filepath, "r");
+  const descriptor = (0, import_node_fs17.openSync)(filepath, "r");
   try {
-    const before = (0, import_node_fs16.fstatSync)(descriptor, { bigint: true });
+    const before = (0, import_node_fs17.fstatSync)(descriptor, { bigint: true });
     if (!before.isFile()) {
       throw new Error(`${REMOTE_COMMAND} bundle must be a regular local file`);
     }
     if (before.size <= 0n) {
       throw new Error(`${REMOTE_COMMAND} bundle is empty`);
     }
-    const bytes = (0, import_node_fs16.readFileSync)(descriptor);
-    const after = (0, import_node_fs16.fstatSync)(descriptor, { bigint: true });
+    const bytes = (0, import_node_fs17.readFileSync)(descriptor);
+    const after = (0, import_node_fs17.fstatSync)(descriptor, { bigint: true });
     if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size || before.mtimeNs !== after.mtimeNs || bytes.length !== Number(before.size)) {
       throw new Error(`${REMOTE_COMMAND} bundle changed while it was being read`);
     }
@@ -28360,7 +28408,7 @@ function readImmutableBundleSource(bundlePath) {
     }
     return source;
   } finally {
-    (0, import_node_fs16.closeSync)(descriptor);
+    (0, import_node_fs17.closeSync)(descriptor);
   }
 }
 async function fetchBundleSource(bundleUrl) {
@@ -28408,14 +28456,14 @@ async function loadBundleSource(bundleInput) {
 }
 function listMetroAssetDest(assetsPath) {
   const directory = (0, import_node_path17.resolve)(assetsPath);
-  if (!(0, import_node_fs16.existsSync)(directory)) return { directory, files: [], truncated: false };
-  const skipNested = (0, import_node_fs16.existsSync)((0, import_node_path17.join)(directory, "package.json"));
+  if (!(0, import_node_fs17.existsSync)(directory)) return { directory, files: [], truncated: false };
+  const skipNested = (0, import_node_fs17.existsSync)((0, import_node_path17.join)(directory, "package.json"));
   const files = [];
   let truncated = false;
   const walk = (dir, prefix) => {
     let entries;
     try {
-      entries = (0, import_node_fs16.readdirSync)(dir, { withFileTypes: true });
+      entries = (0, import_node_fs17.readdirSync)(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -28462,7 +28510,7 @@ function distinctByContent(directory, options) {
   for (const relative2 of options) {
     let bytes;
     try {
-      bytes = (0, import_node_fs16.readFileSync)((0, import_node_path17.join)(directory, relative2));
+      bytes = (0, import_node_fs17.readFileSync)((0, import_node_path17.join)(directory, relative2));
     } catch {
       continue;
     }
@@ -28494,7 +28542,7 @@ function placeMetroDescriptor(listing, descriptor) {
     let bytes;
     try {
       bytes = combination.map(
-        (relative2) => (0, import_node_fs16.readFileSync)((0, import_node_path17.join)(listing.directory, relative2))
+        (relative2) => (0, import_node_fs17.readFileSync)((0, import_node_path17.join)(listing.directory, relative2))
       );
     } catch {
       continue;
@@ -28665,7 +28713,7 @@ async function embedBundleAssets(bundlePath, command, assetPolicy) {
       );
     }
     const relative2 = placement?.files.get(variant.scale);
-    if (relative2 && dest) return (0, import_node_fs16.readFileSync)((0, import_node_path17.join)(dest.directory, relative2));
+    if (relative2 && dest) return (0, import_node_fs17.readFileSync)((0, import_node_path17.join)(dest.directory, relative2));
     if (placement && placement.files.size > 0) return null;
     if (placement && placement.ambiguous.length > 0 && dest) {
       throw new Error(
@@ -28880,12 +28928,12 @@ function createCloudBridgeForParsed(parsed) {
   if (!session) return null;
   return session.service === "box" ? new CloudBoxBridge(session) : new CloudBridge(session);
 }
-var import_node_crypto6, import_node_fs16, import_node_path17, DEFAULT_RNX_CLOUD_ORIGIN, MAX_RNX_CLOUD_BUNDLE_BYTES, REMOTE_COMMAND, MAX_ASSET_DEST_FILES, ACCOUNT_CHOICE_REFUSALS, PROJECT_ONLY_DIRECTORIES, MAX_PLACEMENT_COMBINATIONS, CloudBridge, CloudBoxBridge;
+var import_node_crypto6, import_node_fs17, import_node_path17, DEFAULT_RNX_CLOUD_ORIGIN, MAX_RNX_CLOUD_BUNDLE_BYTES, REMOTE_COMMAND, MAX_ASSET_DEST_FILES, ACCOUNT_CHOICE_REFUSALS, PROJECT_ONLY_DIRECTORIES, MAX_PLACEMENT_COMBINATIONS, CloudBridge, CloudBoxBridge;
 var init_cloud_client = __esm({
   "cli/cloud-client.ts"() {
     "use strict";
     import_node_crypto6 = require("node:crypto");
-    import_node_fs16 = require("node:fs");
+    import_node_fs17 = require("node:fs");
     import_node_path17 = require("node:path");
     init_metroAssetArtifact();
     init_metroCloudArtifact();
@@ -31298,30 +31346,30 @@ var init_parent_pid = __esm({
 
 // cli/secure-file.ts
 function writeSecureJsonAtomic(filepath, value) {
-  (0, import_node_fs17.mkdirSync)((0, import_node_path18.dirname)(filepath), { recursive: true });
+  (0, import_node_fs18.mkdirSync)((0, import_node_path18.dirname)(filepath), { recursive: true });
   const temporary = `${filepath}.tmp-${process.pid}-${(0, import_node_crypto7.randomUUID)()}`;
   let descriptor = null;
   try {
-    descriptor = (0, import_node_fs17.openSync)(temporary, "wx", 384);
-    (0, import_node_fs17.fchmodSync)(descriptor, 384);
-    (0, import_node_fs17.writeFileSync)(descriptor, `${JSON.stringify(value, null, 2)}
+    descriptor = (0, import_node_fs18.openSync)(temporary, "wx", 384);
+    (0, import_node_fs18.fchmodSync)(descriptor, 384);
+    (0, import_node_fs18.writeFileSync)(descriptor, `${JSON.stringify(value, null, 2)}
 `);
-    (0, import_node_fs17.fsyncSync)(descriptor);
-    (0, import_node_fs17.closeSync)(descriptor);
+    (0, import_node_fs18.fsyncSync)(descriptor);
+    (0, import_node_fs18.closeSync)(descriptor);
     descriptor = null;
-    (0, import_node_fs17.renameSync)(temporary, filepath);
+    (0, import_node_fs18.renameSync)(temporary, filepath);
   } catch (error) {
-    if (descriptor !== null) (0, import_node_fs17.closeSync)(descriptor);
-    (0, import_node_fs17.rmSync)(temporary, { force: true });
+    if (descriptor !== null) (0, import_node_fs18.closeSync)(descriptor);
+    (0, import_node_fs18.rmSync)(temporary, { force: true });
     throw error;
   }
 }
-var import_node_crypto7, import_node_fs17, import_node_path18;
+var import_node_crypto7, import_node_fs18, import_node_path18;
 var init_secure_file = __esm({
   "cli/secure-file.ts"() {
     "use strict";
     import_node_crypto7 = require("node:crypto");
-    import_node_fs17 = require("node:fs");
+    import_node_fs18 = require("node:fs");
     import_node_path18 = require("node:path");
   }
 });
@@ -31499,7 +31547,7 @@ function liveDevBridgeLockfiles() {
 function checkoutRoot(cwd) {
   let current = import_node_path19.default.resolve(cwd);
   while (true) {
-    if (import_node_fs18.default.existsSync(import_node_path19.default.join(current, ".git"))) return current;
+    if (import_node_fs19.default.existsSync(import_node_path19.default.join(current, ".git"))) return current;
     const parent = import_node_path19.default.dirname(current);
     if (parent === current) return null;
     current = parent;
@@ -31894,9 +31942,8 @@ function createBridge(wsPort, opts = {}) {
             );
             return sendOnce(successor);
           }
-          clearCurrentSimId();
           throw new Error(
-            `saved sim ${sentSimId} is gone${message.slice(missingSimMessage.length)}; run \`peach list\` and \`peach use <sim>\`, or open a fresh sim`
+            `saved sim ${sentSimId} is not connected${message.slice(missingSimMessage.length)}; commands resume when it reconnects, or run \`peach list\` and \`peach use <sim>\`, or open a fresh sim`
           );
         }
         throw error;
@@ -32010,11 +32057,11 @@ async function callInBridge(bridge, path23, ...args) {
 async function callInBridgeWrite(bridge, path23, ...args) {
   return bridge.send({ type: "call", path: path23, args, acquireLock: true });
 }
-var import_node_fs18, import_node_path19, import_ws2, PEACH_PLACEMENT_ENV, resolvedWorld, BridgeSimLockedError, BRIDGE_VALUE_FLAGS_TABLE, BRIDGE_VALUE_FLAGS;
+var import_node_fs19, import_node_path19, import_ws2, PEACH_PLACEMENT_ENV, resolvedWorld, BridgeSimLockedError, BRIDGE_VALUE_FLAGS_TABLE, BRIDGE_VALUE_FLAGS;
 var init_ws_bridge = __esm({
   "cli/ws-bridge.ts"() {
     "use strict";
-    import_node_fs18 = __toESM(require("node:fs"), 1);
+    import_node_fs19 = __toESM(require("node:fs"), 1);
     import_node_path19 = __toESM(require("node:path"), 1);
     import_ws2 = require("ws");
     init_bridge_constants();
@@ -32308,8 +32355,8 @@ var init_dev_bundle_resolution = __esm({
 
 // src/dot-env.ts
 function selectEnvFile(env, notices) {
-  if (import_node_fs19.default.existsSync("/tmp/envfile")) {
-    return { name: import_node_fs19.default.readFileSync("/tmp/envfile", "utf8").trim(), fromEnvfile: false };
+  if (import_node_fs20.default.existsSync("/tmp/envfile")) {
+    return { name: import_node_fs20.default.readFileSync("/tmp/envfile", "utf8").trim(), fromEnvfile: false };
   }
   const requested = env.ENVFILE;
   if (!requested) return { name: DEFAULT_ENV_FILE, fromEnvfile: false };
@@ -32379,9 +32426,9 @@ function readProjectDotEnv(envsRoot, env = process.env) {
     ...requestedPaths,
     import_node_path20.default.resolve(import_node_path20.default.join(envsRoot, DEFAULT_ENV_FILE))
   ];
-  if (!import_node_fs19.default.existsSync(candidates[2])) candidates.push(import_node_path20.default.resolve(DEFAULT_ENV_FILE));
+  if (!import_node_fs20.default.existsSync(candidates[2])) candidates.push(import_node_path20.default.resolve(DEFAULT_ENV_FILE));
   const tried = [...new Set(candidates)];
-  const resolved = tried.find((candidate) => import_node_fs19.default.existsSync(candidate));
+  const resolved = tried.find((candidate) => import_node_fs20.default.existsSync(candidate));
   if (!resolved) {
     notices.push(
       "*** Missing .env file ****",
@@ -32401,7 +32448,7 @@ function readProjectDotEnv(envsRoot, env = process.env) {
     );
   }
   const config = {};
-  for (const line of import_node_fs19.default.readFileSync(resolved, "utf8").split("\n")) {
+  for (const line of import_node_fs20.default.readFileSync(resolved, "utf8").split("\n")) {
     if (!line.trim()) continue;
     if (/^[ \t\n\v\f\r]*#/.test(line)) continue;
     const match = DOTENV_PATTERN.exec(line);
@@ -32411,11 +32458,11 @@ function readProjectDotEnv(envsRoot, env = process.env) {
   }
   return { config, notices };
 }
-var import_node_fs19, import_node_path20, DEFAULT_ENV_FILE, DOTENV_PATTERN, BUILD_SETTING_PATTERN, INVALID_ENTRY;
+var import_node_fs20, import_node_path20, DEFAULT_ENV_FILE, DOTENV_PATTERN, BUILD_SETTING_PATTERN, INVALID_ENTRY;
 var init_dot_env = __esm({
   "src/dot-env.ts"() {
     "use strict";
-    import_node_fs19 = __toESM(require("node:fs"), 1);
+    import_node_fs20 = __toESM(require("node:fs"), 1);
     import_node_path20 = __toESM(require("node:path"), 1);
     DEFAULT_ENV_FILE = ".env";
     DOTENV_PATTERN = /^(?:export[ \t\n\v\f\r]+|)(?<key>[\p{Alphabetic}\p{Nd}_]+)[ \t\n\v\f\r]*=[ \t\n\v\f\r]*((?<quote>["'])?(?<val>[^\n]*?[^\\\n])\k<quote>?|)$/u;
@@ -32445,7 +32492,7 @@ function readNativeFirebaseConfig(projectRoot) {
     "app.config.ts",
     "app.config.cjs",
     "app.config.mjs"
-  ].some((name2) => import_node_fs20.default.existsSync(import_node_path21.default.join(projectRoot, name2))))
+  ].some((name2) => import_node_fs21.default.existsSync(import_node_path21.default.join(projectRoot, name2))))
     return result;
   const require5 = (0, import_node_module.createRequire)(import_node_path21.default.join(projectRoot, "package.json"));
   const configModule = require5("@expo/config");
@@ -32461,7 +32508,7 @@ function readNativeFirebaseConfig(projectRoot) {
     const native = config[platform];
     if (!isRecord(native) || typeof native.googleServicesFile !== "string") continue;
     try {
-      const source = import_node_fs20.default.readFileSync(
+      const source = import_node_fs21.default.readFileSync(
         import_node_path21.default.resolve(projectRoot, native.googleServicesFile),
         "utf8"
       );
@@ -32514,11 +32561,11 @@ function readNativeFirebaseConfig(projectRoot) {
   }
   return result;
 }
-var import_node_fs20, import_node_module, import_node_path21;
+var import_node_fs21, import_node_module, import_node_path21;
 var init_native_firebase_config = __esm({
   "src/native-firebase-config.ts"() {
     "use strict";
-    import_node_fs20 = __toESM(require("node:fs"), 1);
+    import_node_fs21 = __toESM(require("node:fs"), 1);
     import_node_module = require("node:module");
     import_node_path21 = __toESM(require("node:path"), 1);
     init_is_record();
@@ -32732,14 +32779,14 @@ var init_bundleAssets = __esm({
 // cli/app-catalog.ts
 function listDir(dir) {
   try {
-    return import_node_fs21.default.readdirSync(dir, { withFileTypes: true });
+    return import_node_fs22.default.readdirSync(dir, { withFileTypes: true });
   } catch {
     return [];
   }
 }
 function readText(file) {
   try {
-    return import_node_fs21.default.readFileSync(file, "utf8");
+    return import_node_fs22.default.readFileSync(file, "utf8");
   } catch {
     return null;
   }
@@ -32779,11 +32826,11 @@ function discoverAppCatalog(appDir) {
   if (accentName === null && Object.keys(colors).length === 0) return null;
   return { colors, accentName };
 }
-var import_node_fs21, import_node_path22, ACCENT_BUILD_SETTING, PLIST_ACCENT;
+var import_node_fs22, import_node_path22, ACCENT_BUILD_SETTING, PLIST_ACCENT;
 var init_app_catalog = __esm({
   "cli/app-catalog.ts"() {
     "use strict";
-    import_node_fs21 = __toESM(require("node:fs"), 1);
+    import_node_fs22 = __toESM(require("node:fs"), 1);
     import_node_path22 = __toESM(require("node:path"), 1);
     init_bundleAssets();
     ACCENT_BUILD_SETTING = /ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = "?([^";]+)"?;/;
@@ -32796,7 +32843,7 @@ function firstNamedFile(dir, names) {
   for (const name2 of names) {
     const candidate = import_node_path23.default.join(dir, name2);
     try {
-      if (import_node_fs22.default.statSync(candidate).isFile()) return candidate;
+      if (import_node_fs23.default.statSync(candidate).isFile()) return candidate;
     } catch {
     }
   }
@@ -32811,21 +32858,21 @@ function findRNXAppConfig(dir) {
 function resolveAppProject(projectRoot) {
   const appDir = import_node_path23.default.resolve(projectRoot);
   try {
-    if (!import_node_fs22.default.statSync(appDir).isDirectory()) return null;
+    if (!import_node_fs23.default.statSync(appDir).isDirectory()) return null;
   } catch {
     return null;
   }
   const configPath = findRNXAppConfig(appDir);
-  if (!configPath && !findExpoAppConfig(appDir) && !import_node_fs22.default.existsSync(import_node_path23.default.join(appDir, "package.json"))) {
+  if (!configPath && !findExpoAppConfig(appDir) && !import_node_fs23.default.existsSync(import_node_path23.default.join(appDir, "package.json"))) {
     return null;
   }
   return { appDir, configPath };
 }
-var import_node_fs22, import_node_path23, EXPO_APP_CONFIG_NAMES, PEACH_APP_CONFIG_NAMES;
+var import_node_fs23, import_node_path23, EXPO_APP_CONFIG_NAMES, PEACH_APP_CONFIG_NAMES;
 var init_app_project = __esm({
   "cli/app-project.ts"() {
     "use strict";
-    import_node_fs22 = __toESM(require("node:fs"), 1);
+    import_node_fs23 = __toESM(require("node:fs"), 1);
     import_node_path23 = __toESM(require("node:path"), 1);
     EXPO_APP_CONFIG_NAMES = [
       "app.config.js",
@@ -32851,19 +32898,25 @@ function isPeachConfig(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   const runtimeVersion = Reflect.get(value, "runtimeVersion");
   const network = Reflect.get(value, "network");
-  return (runtimeVersion === void 0 || typeof runtimeVersion === "string" && runtimeVersion === runtimeVersion.trim() && isValidRuntimeVersion(runtimeVersion)) && isOptionalRecord(Reflect.get(value, "modules")) && isOptionalRecord(Reflect.get(value, "turboModules")) && isOptionalRecord(Reflect.get(value, "nativeModules")) && isOptionalRecord(Reflect.get(value, "env")) && isOptionalRecord(network) && isOptionalRecord(Reflect.get(value, "settings")) && isOptionalRecord(Reflect.get(value, "initialState"));
+  return (runtimeVersion === void 0 || typeof runtimeVersion === "string" && runtimeVersion === runtimeVersion.trim() && isValidRuntimeVersion(runtimeVersion)) && isOptionalRecord(Reflect.get(value, "modules")) && isOptionalRecord(Reflect.get(value, "turboModules")) && isOptionalRecord(Reflect.get(value, "nativeModules")) && isOptionalRecord(Reflect.get(value, "nativeViews")) && isOptionalRecord(Reflect.get(value, "env")) && isOptionalRecord(network) && isOptionalRecord(Reflect.get(value, "settings")) && isOptionalRecord(Reflect.get(value, "initialState"));
+}
+function resolveFileEntries(entries, configDir) {
+  if (!entries) return entries;
+  return Object.fromEntries(
+    Object.entries(entries).map(([name2, resolution]) => [
+      name2,
+      resolution && typeof resolution === "object" && "file" in resolution && typeof resolution.file === "string" ? { ...resolution, file: import_node_path24.default.resolve(configDir, resolution.file) } : resolution
+    ])
+  );
 }
 function resolveConfigReplacementFiles(config, configPath) {
-  if (!config.modules) return config;
   const configDir = import_node_path24.default.dirname(configPath);
   return {
     ...config,
-    modules: Object.fromEntries(
-      Object.entries(config.modules).map(([name2, resolution]) => [
-        name2,
-        resolution && typeof resolution === "object" && "file" in resolution ? { ...resolution, file: import_node_path24.default.resolve(configDir, resolution.file) } : resolution
-      ])
-    )
+    modules: resolveFileEntries(config.modules, configDir),
+    turboModules: resolveFileEntries(config.turboModules, configDir),
+    nativeModules: resolveFileEntries(config.nativeModules, configDir),
+    nativeViews: resolveFileEntries(config.nativeViews, configDir)
   };
 }
 async function loadRNXAppConfig(project) {
@@ -32953,7 +33006,7 @@ function discoverNativeLinkedAppFonts(opts) {
       scannedFontDirectories++;
       let entries;
       try {
-        entries = import_node_fs23.default.readdirSync(current.dir, { withFileTypes: true });
+        entries = import_node_fs24.default.readdirSync(current.dir, { withFileTypes: true });
       } catch {
         continue;
       }
@@ -32975,7 +33028,7 @@ function discoverNativeLinkedAppFonts(opts) {
   };
   try {
     const packageJson = JSON.parse(
-      import_node_fs23.default.readFileSync(import_node_path25.default.join(selectedAppDir, "package.json"), "utf8")
+      import_node_fs24.default.readFileSync(import_node_path25.default.join(selectedAppDir, "package.json"), "utf8")
     );
     const dependencyNames = /* @__PURE__ */ new Set();
     for (const field of ["dependencies", "devDependencies", "optionalDependencies"]) {
@@ -33026,7 +33079,7 @@ function discoverNativeLinkedAppFonts(opts) {
   }
   try {
     const configPath = import_node_path25.default.join(selectedAppDir, "react-native.config.js");
-    if (import_node_fs23.default.statSync(configPath).isFile()) {
+    if (import_node_fs24.default.statSync(configPath).isFile()) {
       const appConfigRequire = (0, import_node_module3.createRequire)(import_node_path25.default.join(selectedAppDir, "package.json"));
       const rnConfig = appConfigRequire(configPath);
       const assets = rnConfig && typeof rnConfig === "object" ? Reflect.get(rnConfig, "assets") : null;
@@ -33045,7 +33098,7 @@ function discoverNativeLinkedAppFonts(opts) {
   if (platform === "ios") {
     const iosDir = import_node_path25.default.join(selectedAppDir, "ios");
     try {
-      const targetDirs = import_node_fs23.default.readdirSync(iosDir, { withFileTypes: true }).filter(
+      const targetDirs = import_node_fs24.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_path25.default.join(iosDir, "Info.plist")];
@@ -33055,7 +33108,7 @@ function discoverNativeLinkedAppFonts(opts) {
       for (const plistPath of plistPaths) {
         let parsed;
         try {
-          parsed = parsePlistSource(import_node_fs23.default.readFileSync(plistPath, "utf8"));
+          parsed = parsePlistSource(import_node_fs24.default.readFileSync(plistPath, "utf8"));
         } catch {
           continue;
         }
@@ -33072,7 +33125,7 @@ function discoverNativeLinkedAppFonts(opts) {
             const relative2 = import_node_path25.default.relative(selectedAppDir, candidate);
             if (relative2.startsWith("..") || import_node_path25.default.isAbsolute(relative2)) return false;
             try {
-              return import_node_fs23.default.statSync(candidate).isFile();
+              return import_node_fs24.default.statSync(candidate).isFile();
             } catch {
               return false;
             }
@@ -33118,11 +33171,11 @@ async function resolveMetroProjectRoot(bundleUrl, opts) {
 function encodeAppFontsWire(specs) {
   return specs.map((spec) => `${encodeURIComponent(spec.url)}::${encodeURIComponent(spec.family)}`).join(",");
 }
-var import_node_fs23, import_node_module3, import_node_path25, import_config_plugin_fonts, require3;
+var import_node_fs24, import_node_module3, import_node_path25, import_config_plugin_fonts, require3;
 var init_app_fonts = __esm({
   "cli/app-fonts.ts"() {
     "use strict";
-    import_node_fs23 = __toESM(require("node:fs"), 1);
+    import_node_fs24 = __toESM(require("node:fs"), 1);
     import_node_module3 = require("node:module");
     import_node_path25 = __toESM(require("node:path"), 1);
     import_config_plugin_fonts = require("peach-engine/engine/config-plugin-fonts");
@@ -34392,13 +34445,13 @@ function resolvePlaywright() {
         try {
           const modulePath = requireFromRoot.resolve(spec);
           const packageJsonPath = requireFromRoot.resolve(`${spec}/package.json`);
-          const parsed = JSON.parse((0, import_node_fs24.readFileSync)(packageJsonPath, "utf8"));
+          const parsed = JSON.parse((0, import_node_fs25.readFileSync)(packageJsonPath, "utf8"));
           if (!isRecord(parsed) || typeof parsed.version !== "string") continue;
           const corePackagePath = (0, import_node_module5.createRequire)(modulePath).resolve(
             "playwright-core/package.json"
           );
           const cliPath = (0, import_node_path26.join)((0, import_node_path26.dirname)(corePackagePath), "cli.js");
-          if (!(0, import_node_fs24.existsSync)(cliPath)) continue;
+          if (!(0, import_node_fs25.existsSync)(cliPath)) continue;
           return {
             spec,
             modulePath,
@@ -34469,7 +34522,7 @@ function probeBrowser(resolved, env) {
     return {
       ok: true,
       executablePath: parsed.executablePath,
-      exists: parsed.exists && (0, import_node_fs24.existsSync)(parsed.executablePath)
+      exists: parsed.exists && (0, import_node_fs25.existsSync)(parsed.executablePath)
     };
   } catch (error) {
     return {
@@ -34485,6 +34538,8 @@ function ensurePlaywrightBrowser(resolved, headless, env = process.env) {
   const before = probeBrowser(resolved, probeEnv);
   if (!before.ok) return before;
   if (before.exists) {
+    const missing2 = missingLibrariesMessage(before.executablePath, browser);
+    if (missing2) return { ok: false, message: missing2 };
     return { ok: true, executablePath: before.executablePath, installed: false };
   }
   const installer = rnxSelfInvocation();
@@ -34521,14 +34576,50 @@ ${detail}` : ""}`
       message: `${resolved.spec}@${resolved.version} browser install completed, but its required ${browser} executable is still missing at ${after.executablePath}`
     };
   }
+  const missing = missingLibrariesMessage(after.executablePath, browser);
+  if (missing) return { ok: false, message: missing };
   return { ok: true, executablePath: after.executablePath, installed: true };
 }
-var import_node_child_process6, import_node_fs24, import_node_module5, import_node_path26;
+function isTime64Distro() {
+  if (!(0, import_node_fs25.existsSync)("/etc/os-release")) return false;
+  const fields = Object.fromEntries(
+    (0, import_node_fs25.readFileSync)("/etc/os-release", "utf8").split("\n").map((line) => line.match(/^(\w+)="?([^"]*)"?$/)).filter((match) => match !== null).map((match) => [match[1], match[2]])
+  );
+  const version = Number.parseFloat(fields.VERSION_ID ?? "");
+  return fields.ID === "ubuntu" && version >= 24.04 || fields.ID === "debian" && version >= 13;
+}
+function missingLibrariesMessage(executablePath, browser) {
+  if (process.platform !== "linux") return null;
+  const ldd = (0, import_node_child_process6.spawnSync)("ldd", [executablePath], { encoding: "utf8", timeout: 3e4 });
+  const libraries = [...(ldd.stdout ?? "").matchAll(/^\s*(\S+) => not found$/gm)].map(
+    (match) => match[1]
+  );
+  if (!libraries.length) return null;
+  const time64 = isTime64Distro();
+  const packages = /* @__PURE__ */ new Set();
+  const unknown = [];
+  for (const library of libraries) {
+    const name2 = LIBRARY_PACKAGES[library];
+    if (!name2) unknown.push(library);
+    else packages.add(time64 && TIME64_PACKAGES.has(name2) ? `${name2}t64` : name2);
+  }
+  const sudo = process.getuid?.() === 0 ? "" : "sudo ";
+  return [
+    `${browser} at ${executablePath} cannot start: this system is missing shared libraries it links (${libraries.join(", ")}).`,
+    ...packages.size ? [
+      "On Debian or Ubuntu, install them and run the command again:",
+      "",
+      `    ${sudo}apt-get update && ${sudo}apt-get install -y --no-install-recommends ${[...packages].join(" ")}`
+    ] : [],
+    ...unknown.length ? ["", `No known Debian package provides: ${unknown.join(", ")}`] : []
+  ].join("\n");
+}
+var import_node_child_process6, import_node_fs25, import_node_module5, import_node_path26, LIBRARY_PACKAGES, TIME64_PACKAGES;
 var init_playwright_provisioning = __esm({
   "cli/drivers/playwright-provisioning.ts"() {
     "use strict";
     import_node_child_process6 = require("node:child_process");
-    import_node_fs24 = require("node:fs");
+    import_node_fs25 = require("node:fs");
     import_node_module5 = require("node:module");
     import_node_path26 = require("node:path");
     init_src();
@@ -34537,6 +34628,42 @@ var init_playwright_provisioning = __esm({
     init_internal_child();
     init_self_invocation();
     init_playwright_core_pin();
+    LIBRARY_PACKAGES = {
+      "libasound.so.2": "libasound2",
+      "libatk-1.0.so.0": "libatk1.0-0",
+      "libatk-bridge-2.0.so.0": "libatk-bridge2.0-0",
+      "libatspi.so.0": "libatspi2.0-0",
+      "libcairo.so.2": "libcairo2",
+      "libcups.so.2": "libcups2",
+      "libdbus-1.so.3": "libdbus-1-3",
+      "libexpat.so.1": "libexpat1",
+      "libgbm.so.1": "libgbm1",
+      "libgio-2.0.so.0": "libglib2.0-0",
+      "libglib-2.0.so.0": "libglib2.0-0",
+      "libgobject-2.0.so.0": "libglib2.0-0",
+      "libnspr4.so": "libnspr4",
+      "libnss3.so": "libnss3",
+      "libnssutil3.so": "libnss3",
+      "libpango-1.0.so.0": "libpango-1.0-0",
+      "libsmime3.so": "libnss3",
+      "libudev.so.1": "libudev1",
+      "libX11.so.6": "libx11-6",
+      "libxcb.so.1": "libxcb1",
+      "libXcomposite.so.1": "libxcomposite1",
+      "libXdamage.so.1": "libxdamage1",
+      "libXext.so.6": "libxext6",
+      "libXfixes.so.3": "libxfixes3",
+      "libxkbcommon.so.0": "libxkbcommon0",
+      "libXrandr.so.2": "libxrandr2"
+    };
+    TIME64_PACKAGES = /* @__PURE__ */ new Set([
+      "libasound2",
+      "libatk1.0-0",
+      "libatk-bridge2.0-0",
+      "libatspi2.0-0",
+      "libcups2",
+      "libglib2.0-0"
+    ]);
   }
 });
 
@@ -35461,7 +35588,7 @@ function assertExplicitBridgeLock(preferredPort, explicitPort, lock) {
 async function ensureRuntimeForOpen() {
   if (resolveDevCheckoutRuntimeRoot()) return;
   const active = readActiveRuntime();
-  if (active && import_node_fs25.default.existsSync(runtimeDir(active))) return;
+  if (active && import_node_fs26.default.existsSync(runtimeDir(active))) return;
   console.error("  installing peach engine runtime...");
   const { runRuntime: runRuntime2 } = await Promise.resolve().then(() => (init_runtime(), runtime_exports));
   await runRuntime2(["install"], {});
@@ -35637,7 +35764,7 @@ function parseOpenRuntimeConfig(args) {
       }
       const moduleName = raw.slice(0, eqIndex).trim();
       const filePath = normalizeReplacementPath(raw.slice(eqIndex + 1).trim());
-      if (!import_node_fs25.default.existsSync(filePath)) {
+      if (!import_node_fs26.default.existsSync(filePath)) {
         console.error(`  peach open: replacement file not found: ${filePath}`);
         rnxExit(1);
       }
@@ -35668,7 +35795,7 @@ async function resolveAppProjectForBundleUrl(bundleUrl) {
   return advertisedRoot ? resolveAppProject(advertisedRoot) : null;
 }
 async function ensureConfiguredRuntime(version) {
-  if (import_node_fs25.default.existsSync(import_node_path27.default.join(runtimeDir(version), "index.html"))) return;
+  if (import_node_fs26.default.existsSync(import_node_path27.default.join(runtimeDir(version), "index.html"))) return;
   console.error(`  installing configured engine runtime ${version}...`);
   const result = await rnxRuntime.install({
     version,
@@ -35985,7 +36112,7 @@ function playwrightHostPidForSim(sim) {
 function signalDriverLaunchConnected(result) {
   if (!result.connectAckFile) return false;
   try {
-    import_node_fs25.default.writeFileSync(
+    import_node_fs26.default.writeFileSync(
       result.connectAckFile,
       `${JSON.stringify({ connectedAt: Date.now(), pid: result.pid ?? null })}
 `,
@@ -35999,7 +36126,7 @@ function signalDriverLaunchConnected(result) {
 function printDriverDiagnosticLogTail(result) {
   if (!result.diagnosticLogPath) return;
   try {
-    const detail = import_node_fs25.default.readFileSync(result.diagnosticLogPath, "utf8").trim();
+    const detail = import_node_fs26.default.readFileSync(result.diagnosticLogPath, "utf8").trim();
     if (!detail) {
       console.error(`  ${import_node_path27.default.basename(result.diagnosticLogPath)} was empty`);
       return;
@@ -36990,12 +37117,12 @@ async function runCloseCommand(args, opts = {}) {
     bridge.close();
   }
 }
-var import_node_child_process7, import_node_fs25, import_node_os4, import_node_path27, import_app_catalog_wire, import_devices2, import_ws4, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS, DEV_BUNDLE_RESOLVE_ATTEMPTS, DEV_BUNDLE_RESOLVE_INTERVAL_MS;
+var import_node_child_process7, import_node_fs26, import_node_os4, import_node_path27, import_app_catalog_wire, import_devices2, import_ws4, DEFAULT_DRIVER_CONNECT_TIMEOUT_MS, DRIVER_CONNECT_INTERVAL_MS, DRIVER_CONNECT_HOST_GRACE_MS, OPEN_BRIDGE_SPAWN_TIMEOUT_MS, SHELL_APPS, DEV_BUNDLE_RESOLVE_ATTEMPTS, DEV_BUNDLE_RESOLVE_INTERVAL_MS;
 var init_control = __esm({
   "cli/commands/control.ts"() {
     "use strict";
     import_node_child_process7 = require("node:child_process");
-    import_node_fs25 = __toESM(require("node:fs"), 1);
+    import_node_fs26 = __toESM(require("node:fs"), 1);
     import_node_os4 = __toESM(require("node:os"), 1);
     import_node_path27 = __toESM(require("node:path"), 1);
     import_app_catalog_wire = require("peach-engine/engine/app-catalog-wire");
@@ -38529,7 +38656,6 @@ var init_bridge_flow_runner = __esm({
       });
       firstLaunchDone = false;
       appStopped = false;
-      launchArgumentsActive = false;
       profilingEnabled = false;
       recordingEnabled = false;
       recordingAccessChecked = false;
@@ -39762,17 +39888,6 @@ var init_bridge_flow_runner = __esm({
         }
         throw new Error("extendedWaitUntil timed out");
       }
-      async reloadGuestApp() {
-        const reloaded = await this.bridge.send({
-          type: "call",
-          simId: this.opts.simId,
-          path: "SootSim.bridges.hotRemount.reloadExternalApp",
-          args: []
-        });
-        if (reloaded) return;
-        await this.evaluate("window.location.reload()").catch(() => {
-        });
-      }
       async resetGuestAppData(launchOptions) {
         const reset = await this.bridge.send(
           {
@@ -39833,6 +39948,7 @@ var init_bridge_flow_runner = __esm({
         }
         const wantsClear = !!(opts && typeof opts === "object" && opts.clearState);
         const wantsResetRuntime = readBooleanKey(opts, "resetRuntime");
+        const wantsForeground = isObjectRecord(opts) && opts.stopApp === false;
         await this.setLaunchPermissions(isObjectRecord(opts) ? opts.permissions : void 0);
         if (!this.firstLaunchDone) {
           this.firstLaunchDone = true;
@@ -39867,7 +39983,14 @@ var init_bridge_flow_runner = __esm({
             await this.waitForTree(12e4);
             await this.waitForTree(3e4);
           } else {
-            await this.launchShellAppFromHomeIfNeeded(opts);
+            const launched = await this.launchShellAppFromHomeIfNeeded(opts);
+            if (!launched && !wantsForeground) {
+              await this.waitForTree(12e4);
+              await this.reloadGuestAppRuntime({
+                launchArguments: null,
+                initialUrl: null
+              });
+            }
             await this.waitForTree(12e4);
             await this.waitForTree(3e4);
           }
@@ -39877,13 +40000,11 @@ var init_bridge_flow_runner = __esm({
               launchArguments: hasLaunchArguments ? launchArguments : null,
               initialUrl: null
             });
-          } else if (hasLaunchArguments || this.launchArgumentsActive || this.appStopped) {
+          } else if (hasLaunchArguments || this.appStopped || !wantsForeground) {
             await this.reloadGuestAppRuntime({
               launchArguments: hasLaunchArguments ? launchArguments : null,
               initialUrl: null
             });
-          } else {
-            await this.reloadGuestApp();
           }
           await this.waitForTree(12e4);
           if (this.opts.onAfterLaunch) {
@@ -39897,7 +40018,6 @@ var init_bridge_flow_runner = __esm({
           }
         }
         this.appStopped = false;
-        this.launchArgumentsActive = hasLaunchArguments;
         if (this.profilingEnabled) {
           await this.startProfile();
         }
@@ -40109,7 +40229,6 @@ var init_bridge_flow_runner = __esm({
           throw new Error(`openLink failed: ${result?.error || "no test bridge"}`);
         }
         this.appStopped = false;
-        this.launchArgumentsActive = false;
         this.firstLaunchDone = true;
       }
       // evaluate a `when:` predicate. returns true if the step should run.