rnxsim 0.1.355 → 0.1.356

package/dist-lib/host/websocket-proxy.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.mjs

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

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-production-bundle.ts
 var RNXSIM_METRO_PRODUCTION_BUNDLE_OPTION = "rnxsim";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/public-brand.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

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

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

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/sdk.mjs

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

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (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;
@@ -475,36 +475,36 @@ var init_capability_inventory_coverage = __esm({
           raw: {
             covered: 0,
             ratio: 0,
-            total: 1873
+            total: 1576
           },
           weighted: {
             covered: 0,
             ratio: 0,
-            total: 13317
+            total: 11841
           }
         },
         semantic: {
           raw: {
             covered: 0,
             ratio: 0,
-            total: 1414
+            total: 1123
           },
           weighted: {
             covered: 0,
             ratio: 0,
-            total: 9296
+            total: 7842
           }
         },
         visual: {
           raw: {
             covered: 0,
             ratio: 0,
-            total: 459
+            total: 453
           },
           weighted: {
             covered: 0,
             ratio: 0,
-            total: 4021
+            total: 3999
           }
         },
         byPlatform: {
@@ -513,36 +513,36 @@ var init_capability_inventory_coverage = __esm({
               raw: {
                 covered: 0,
                 ratio: 0,
-                total: 1663
+                total: 1374
               },
               weighted: {
                 covered: 0,
                 ratio: 0,
-                total: 12183
+                total: 10747
               }
             },
             semantic: {
               raw: {
                 covered: 0,
                 ratio: 0,
-                total: 1252
+                total: 969
               },
               weighted: {
                 covered: 0,
                 ratio: 0,
-                total: 8412
+                total: 6998
               }
             },
             visual: {
               raw: {
                 covered: 0,
                 ratio: 0,
-                total: 411
+                total: 405
               },
               weighted: {
                 covered: 0,
                 ratio: 0,
-                total: 3771
+                total: 3749
               }
             }
           },
@@ -551,36 +551,36 @@ var init_capability_inventory_coverage = __esm({
               raw: {
                 covered: 0,
                 ratio: 0,
-                total: 1666
+                total: 1391
               },
               weighted: {
                 covered: 0,
                 ratio: 0,
-                total: 12153
+                total: 10787
               }
             },
             semantic: {
               raw: {
                 covered: 0,
                 ratio: 0,
-                total: 1265
+                total: 996
               },
               weighted: {
                 covered: 0,
                 ratio: 0,
-                total: 8421
+                total: 7077
               }
             },
             visual: {
               raw: {
                 covered: 0,
                 ratio: 0,
-                total: 401
+                total: 395
               },
               weighted: {
                 covered: 0,
                 ratio: 0,
-                total: 3732
+                total: 3710
               }
             }
           }
@@ -26078,21 +26078,6 @@ var init_frame_compose = __esm({
   }
 });
 
-// cli/app-state-reset.ts
-function resetGuestAppStateEval(resetStorage) {
-  return `(async () => {
-    const bridge = globalThis.SootSim && globalThis.SootSim.bridges && globalThis.SootSim.bridges.hotRemount
-    if (!bridge || typeof bridge.reloadExternalApp !== 'function') return false
-    await bridge.reloadExternalApp({ resetStorage: ${resetStorage ? "true" : "false"} })
-    return true
-  })()`;
-}
-var init_app_state_reset = __esm({
-  "cli/app-state-reset.ts"() {
-    "use strict";
-  }
-});
-
 // cli/commands/inspect/settling.ts
 async function waitForSootsimIdle({
   bridge,
@@ -26878,7 +26863,6 @@ var init_bridge_flow_runner = __esm({
     import_yaml = __toESM(require("yaml"), 1);
     import_proof_frame = __toESM(require_proof_frame(), 1);
     init_frame_compose();
-    init_app_state_reset();
     init_core();
     init_settling();
     init_shared();
@@ -26906,6 +26890,8 @@ var init_bridge_flow_runner = __esm({
         onLog: (msg) => console.log(`[flow]   js: ${msg}`)
       });
       firstLaunchDone = false;
+      appStopped = false;
+      launchArgumentsActive = false;
       profilingEnabled = false;
       recordingEnabled = false;
       recordingAccessChecked = false;
@@ -28031,12 +28017,12 @@ var init_bridge_flow_runner = __esm({
         await sleep3(500);
         await this.refreshSimId();
       }
-      async resetGuestAppData() {
+      async resetGuestAppData(launchOptions) {
         const reset = await this.bridge.send(
           {
             type: "reset",
             simId: this.opts.simId,
-            resetOptions: { strategy: "data" }
+            resetOptions: { strategy: "data", ...launchOptions }
           },
           { timeoutMs: 12e4 }
         );
@@ -28050,14 +28036,16 @@ var init_bridge_flow_runner = __esm({
           throw new Error("guest app data reset did not replace the tenant worker");
         }
       }
-      async softReloadGuestApp(resetStorage) {
-        const reloaded = await this.evaluate(
-          resetGuestAppStateEval(resetStorage),
-          12e4
+      async reloadGuestAppRuntime(options) {
+        await this.bridge.send(
+          {
+            type: "call",
+            simId: this.opts.simId,
+            path: "SootSim.bridges.hotRemount.reloadExternalApp",
+            args: [options]
+          },
+          { timeoutMs: 12e4 }
         );
-        if (!reloaded) {
-          throw new Error("guest app soft reload bridge unavailable");
-        }
       }
       async rearmCaptureAfterRuntimeReload() {
         if (!this.recordingEnabled && !this.profilingEnabled) return;
@@ -28080,17 +28068,38 @@ var init_bridge_flow_runner = __esm({
       }
       async launchApp(opts) {
         await this.refreshSimId();
-        if (opts && typeof opts === "object" && opts.arguments) {
-          console.log("[flow]   launchApp.arguments ignored (rnx has no native process)");
+        let hasLaunchArguments = false;
+        let launchArguments;
+        if (isObjectRecord2(opts) && Object.prototype.hasOwnProperty.call(opts, "arguments")) {
+          if (!isObjectRecord2(opts.arguments)) {
+            throw new Error("launchApp.arguments must be a JSON object");
+          }
+          hasLaunchArguments = true;
+          launchArguments = opts.arguments;
         }
         const wantsClear = !!(opts && typeof opts === "object" && opts.clearState);
         const wantsResetRuntime = readBooleanKey(opts, "resetRuntime");
         if (!this.firstLaunchDone && !wantsClear) {
           this.firstLaunchDone = true;
-          if (wantsResetRuntime) {
+          if (hasLaunchArguments) {
+            const launched = await this.launchShellAppFromHomeIfNeeded(opts);
+            if (launched) await this.waitForTree(12e4);
+            await this.reloadGuestAppRuntime({
+              launchArguments,
+              initialUrl: null
+            });
+            await this.waitForTree(12e4);
+          } else if (wantsResetRuntime) {
             const launched = await this.launchShellAppFromHomeIfNeeded(opts);
             if (launched) await this.waitForTree(12e4);
-            await this.softReloadGuestApp(false);
+            await this.reloadGuestAppRuntime({});
+            await this.waitForTree(12e4);
+          } else if (this.appStopped) {
+            await this.launchShellAppFromHomeIfNeeded(opts);
+            await this.reloadGuestAppRuntime({
+              launchArguments: null,
+              initialUrl: null
+            });
             await this.waitForTree(12e4);
           } else {
             await this.launchShellAppFromHomeIfNeeded(opts);
@@ -28099,7 +28108,15 @@ var init_bridge_flow_runner = __esm({
         } else {
           this.firstLaunchDone = true;
           if (wantsClear) {
-            await this.resetGuestAppData();
+            await this.resetGuestAppData({
+              launchArguments: hasLaunchArguments ? launchArguments : null,
+              initialUrl: null
+            });
+          } else if (hasLaunchArguments || this.launchArgumentsActive || this.appStopped) {
+            await this.reloadGuestAppRuntime({
+              launchArguments: hasLaunchArguments ? launchArguments : null,
+              initialUrl: null
+            });
           } else {
             await this.reloadGuestApp();
           }
@@ -28114,6 +28131,8 @@ var init_bridge_flow_runner = __esm({
             }
           }
         }
+        this.appStopped = false;
+        this.launchArgumentsActive = hasLaunchArguments;
         if (this.profilingEnabled) {
           await this.startProfile();
         }
@@ -28201,12 +28220,10 @@ var init_bridge_flow_runner = __esm({
         return result;
       }
       // maestro stopApp: tear down the current app runtime without clearing app
-      // data. sootsim has no separate native process, so a hard page reload is the
-      // nearest equivalent to killing and later re-launching the tenant runtime.
-      // State clearing belongs to clearState / launchApp({ clearState: true }).
+      // data. the next launchApp or openLink creates its replacement worker.
       async stopApp() {
-        await this.reloadGuestApp();
-        await this.rearmCaptureAfterRuntimeReload();
+        await this.reloadGuestAppRuntime({ relaunch: false });
+        this.appStopped = true;
       }
       // maestro clearState: wipe app-owned storage and relaunch fresh.
       async clearState() {
@@ -28267,6 +28284,17 @@ var init_bridge_flow_runner = __esm({
       async openLink(target) {
         const link = typeof target === "string" ? target : target.link;
         if (!link) throw new Error("openLink: missing link");
+        if (this.appStopped) {
+          await this.reloadGuestAppRuntime({
+            initialUrl: link,
+            launchArguments: null
+          });
+          await this.waitForTree(12e4);
+          this.appStopped = false;
+          this.launchArgumentsActive = false;
+          this.firstLaunchDone = true;
+          return;
+        }
         const result = await this.callTest(
           "openDeepLink",
           link

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.355 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.356 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.355",
+  "version": "0.1.356",
   "description": "rnx CLI, Vite and Metro plugins, and agent skills for driving React Native apps in the browser.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/skills/rnx-test/SKILL.md

@@ -157,7 +157,7 @@ rnx maestro --env USERNAME=alice test .maestro/login.yaml
 
 ### supported verbs
 
-`launchApp`, `stopApp`, `clearState`, `tapOn`, `tapAtCoords`, `longPressOn`, `inputText`,
+`launchApp` (including JSON `arguments`), `stopApp`, `clearState`, `tapOn`, `tapAtCoords`, `longPressOn`, `inputText`,
 `pressKey`, `dispatchKey`, `hideKeyboard`, `eraseText`, `assertVisible`,
 `assertNotVisible`, `assertTreeContains`, `waitFor`, `extendedWaitUntil`,
 `waitForAnimationToEnd`, `scroll`, `scrollUntilVisible`, `scrollTo`,
@@ -173,7 +173,11 @@ interpolation.
   if a test depends on keychain state being reset, add an explicit
   in-app "sign out" step instead.
 - `when.platform` — rnx emulates iOS; android branches are skipped.
-- `openLink` — navigates `window.location`; no OS-level app routing.
+- `openLink`: app routing works; there is no OS-level browser fallback.
+
+`stopApp` keeps the guest runtime stopped. The next `launchApp` starts a fresh
+guest with its replacement arguments, while `openLink` starts it with the URL
+available to React Native Linking during app entry.
 
 ### not yet implemented
 

package/src/bridge-contract.ts

@@ -8,7 +8,10 @@
 // (see its `rnxsim` dependency and its `rnxsim/bridge-constants` import), so
 // this is the direction that ships.
 
-import type { SootSimAgentActionDetail } from '@sootsim/globals'
+import type {
+  SootSimAgentActionDetail,
+  SootSimExternalAppLifecycleOptions,
+} from '@sootsim/globals'
 
 export type BridgeCommandType =
   | 'evaluate'
@@ -196,7 +199,10 @@ export interface SimStateResult {
 // claiming the fast path.
 export type ResetStrategy = 'data' | 'full'
 
-export interface ResetOptions {
+export interface ResetOptions extends Pick<
+  SootSimExternalAppLifecycleOptions,
+  'initialUrl' | 'launchArguments'
+> {
   strategy?: ResetStrategy
   // relaunch the app after wiping. default true.
   relaunch?: boolean