rnxsim 0.1.365 → 0.1.366

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.366 | (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.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.366 | (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.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.366 | (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.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.366 | (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;
@@ -2315,6 +2315,32 @@ async function resolveTargetCoords(bridge, target) {
   return result ?? null;
 }
 
+// src/app-url.ts
+var APP_URL_SCHEME_RE = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+function normalizeAppUrlTarget(target) {
+  const trimmed = target.trim();
+  if (!trimmed) {
+    throw new Error("expected <url-or-route>");
+  }
+  if (APP_URL_SCHEME_RE.test(trimmed) || trimmed.startsWith("/")) {
+    return trimmed;
+  }
+  return `/${trimmed}`;
+}
+async function openAppUrl(bridge, target) {
+  const normalized = normalizeAppUrlTarget(target);
+  const result = await bridge.send({
+    type: "call",
+    path: "SootSim.bridges.test.openDeepLink",
+    args: [normalized]
+  });
+  if (result !== null && typeof result === "object" && Reflect.get(result, "ok") === false) {
+    const error = Reflect.get(result, "error");
+    throw new Error(typeof error === "string" ? error : "deep-link dispatch failed");
+  }
+  return normalized;
+}
+
 // src/sim-client.ts
 var SimClientError = class extends Error {
   constructor(message) {
@@ -2475,6 +2501,10 @@ var SimClient = class {
       `timed out waiting for sim ${this.simId} to load ${nextUrl}`
     );
   }
+  /** dispatch a route or app URL through React Native Linking in this guest. */
+  openUrl(target) {
+    return openAppUrl(this, target);
+  }
   /**
    * block until the guest app has mounted and painted real content.
    * throws SimReadyTimeoutError (with the last probe status) on timeout.

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.366 | (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);
@@ -2217,6 +2217,32 @@ async function resolveTargetCoords(bridge, target) {
   return result ?? null;
 }
 
+// src/app-url.ts
+var APP_URL_SCHEME_RE = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+function normalizeAppUrlTarget(target) {
+  const trimmed = target.trim();
+  if (!trimmed) {
+    throw new Error("expected <url-or-route>");
+  }
+  if (APP_URL_SCHEME_RE.test(trimmed) || trimmed.startsWith("/")) {
+    return trimmed;
+  }
+  return `/${trimmed}`;
+}
+async function openAppUrl(bridge, target) {
+  const normalized = normalizeAppUrlTarget(target);
+  const result = await bridge.send({
+    type: "call",
+    path: "SootSim.bridges.test.openDeepLink",
+    args: [normalized]
+  });
+  if (result !== null && typeof result === "object" && Reflect.get(result, "ok") === false) {
+    const error = Reflect.get(result, "error");
+    throw new Error(typeof error === "string" ? error : "deep-link dispatch failed");
+  }
+  return normalized;
+}
+
 // src/sim-client.ts
 var SimClientError = class extends Error {
   constructor(message) {
@@ -2377,6 +2403,10 @@ var SimClient = class {
       `timed out waiting for sim ${this.simId} to load ${nextUrl}`
     );
   }
+  /** dispatch a route or app URL through React Native Linking in this guest. */
+  openUrl(target) {
+    return openAppUrl(this, target);
+  }
   /**
    * block until the guest app has mounted and painted real content.
    * throws SimReadyTimeoutError (with the last probe status) on timeout.

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.366 | (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;
@@ -1180,6 +1180,16 @@ var init_react_native_root_export_coverage = __esm({
   }
 });
 
+// ../compat/src/generated/react-native-webview-coverage.ts
+var REACT_NATIVE_WEBVIEW_WILL_IT_WORK_COVERAGE, REACT_NATIVE_WEBVIEW_STRICT_COVERAGE;
+var init_react_native_webview_coverage = __esm({
+  "../compat/src/generated/react-native-webview-coverage.ts"() {
+    "use strict";
+    REACT_NATIVE_WEBVIEW_WILL_IT_WORK_COVERAGE = 0.74;
+    REACT_NATIVE_WEBVIEW_STRICT_COVERAGE = 0.223;
+  }
+});
+
 // ../compat/src/unsupported-packages.ts
 function getUnsupportedNativePackage(name2) {
   const entry = UNSUPPORTED_NATIVE_PACKAGES[name2];
@@ -1220,6 +1230,7 @@ var init_registry = __esm({
     "use strict";
     init_capability_inventory_coverage();
     init_react_native_root_export_coverage();
+    init_react_native_webview_coverage();
     init_unsupported_packages();
     COMPAT_CATEGORIES = [
       "All",
@@ -1371,10 +1382,11 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=11.0.0",
-            coverage: 0.55,
-            note: "native-seam only: the published package runs unchanged and routes RNCWebView through the tenant-to-shell hosted iframe surface. chromium can load cross-origin source.uri pages under the shell COEP through a credentialless frame; same-origin URI and source.html keep normal cookie and persistent-storage semantics. the iframe keeps loading while parked behind a canvas placeholder and becomes interactive when promoted live. paired native and SootSim runtime conformance covers local-page onOpenWindow target delivery.",
-            working: "source.uri/source.html, Chromium cross-origin URI loading under the shell COEP, same-origin URI cookies, source.html persistent localStorage, document-start ReactNativeWebView bootstrap and injectedJavaScriptBeforeContentLoaded/injectedJavaScript on source.html and percent-encoded data: URI pages, strict ReactNativeWebView.postMessage bridge envelope, onMessage synthetic event with navigation fields, onOpenWindow target delivery for source.html and percent-encoded data: URI pages, onLoad/Start/End, onNavigationStateChange, ref.reload/stopLoading/injectJavaScript/postMessage, renderLoading, javaScriptEnabled sandbox, layout, inherited clipping and visibility, parked/live presentation",
-            missing: "Safari/WebKit cross-origin URI pages without COEP-compatible response headers remain permanently loading because WebKit ignores iframe credentialless; Chromium credentialless cross-origin URI frames send no credentials, including cookies set by their own origin, and use ephemeral storage; iframe pixels in canvas screenshots; script injection, ReactNativeWebView bootstrap, and onOpenWindow for remote pages, which get no bridge at all because a browser cannot script a cross-origin frame; the re-encoded data: URI a page reports as its own location.href, so onMessage carries the re-encoded url while onLoad and onNavigationStateChange carry the original where iOS reports one identical url for all three; cross-origin ref.goBack/goForward and truthful canGoBack/canGoForward values; failed HTTP/refused navigation callbacks (onError/onHttpError and renderError); onShouldStartLoadWithRequest, allowsBackForwardNavigationGestures, userAgent, dataDetectorTypes, cacheEnabled, incognito, scalesPageToFit, originWhitelist enforcement"
+            coverage: REACT_NATIVE_WEBVIEW_WILL_IT_WORK_COVERAGE,
+            strictCoverage: REACT_NATIVE_WEBVIEW_STRICT_COVERAGE,
+            note: "native-seam only: the published package runs unchanged and routes RNCWebView through the tenant-to-shell hosted iframe surface. coverage is generated from app-source use in six pinned applications; equal-surface strict coverage includes the shared, iOS, and Android public prop and ref surface. paired native and SootSim runtime conformance covers local HTML, base URL, URI loading, load and navigation callbacks, both injection phases, two-way messaging, imperative URI reload and injection, content scrolling, parent translation, and onOpenWindow target delivery.",
+            working: "source.uri/source.html/source.baseUrl, Chromium cross-origin URI loading under the shell COEP, same-origin URI cookies, source.html persistent localStorage, document-start ReactNativeWebView bootstrap and injectedJavaScriptBeforeContentLoaded/injectedJavaScript on source.html, strict ReactNativeWebView.postMessage bridge envelope in both directions, onMessage synthetic event with navigation fields, onOpenWindow target delivery for source.html, successful onLoad/Start/End and onNavigationStateChange, ref.reload on URI pages, ref.injectJavaScript/postMessage, internal content scrolling, renderLoading, javaScriptEnabled sandbox, layout, inherited clipping and visibility, parked/live presentation",
+            missing: "Safari/WebKit cross-origin URI pages without COEP-compatible response headers remain permanently loading because WebKit ignores iframe credentialless; Chromium credentialless cross-origin URI frames send no credentials, including cookies set by their own origin, and use ephemeral storage; iframe pixels in canvas screenshots; script injection, ReactNativeWebView bootstrap, and onOpenWindow for remote pages, which get no bridge at all because a browser cannot script a cross-origin frame; cross-origin ref.goBack/goForward/stopLoading and truthful canGoBack/canGoForward values; failed HTTP/refused navigation callbacks (onError/onHttpError and renderError); onShouldStartLoadWithRequest, allowsBackForwardNavigationGestures, userAgent, dataDetectorTypes, cacheEnabled, incognito, scalesPageToFit, originWhitelist enforcement"
           }
         ]
       },
@@ -21171,6 +21183,45 @@ var init_ws_bridge = __esm({
   }
 });
 
+// src/app-url.ts
+function normalizeAppUrlTarget(target) {
+  const trimmed = target.trim();
+  if (!trimmed) {
+    throw new Error("expected <url-or-route>");
+  }
+  if (APP_URL_SCHEME_RE.test(trimmed) || trimmed.startsWith("/")) {
+    return trimmed;
+  }
+  return `/${trimmed}`;
+}
+function isAppDeepLinkTarget(target) {
+  const trimmed = target.trim();
+  if (!trimmed) return false;
+  if (trimmed.startsWith("/")) return true;
+  if (!APP_URL_SCHEME_RE.test(trimmed)) return false;
+  return !/^https?:\/\//i.test(trimmed);
+}
+async function openAppUrl(bridge, target) {
+  const normalized = normalizeAppUrlTarget(target);
+  const result = await bridge.send({
+    type: "call",
+    path: "SootSim.bridges.test.openDeepLink",
+    args: [normalized]
+  });
+  if (result !== null && typeof result === "object" && Reflect.get(result, "ok") === false) {
+    const error = Reflect.get(result, "error");
+    throw new Error(typeof error === "string" ? error : "deep-link dispatch failed");
+  }
+  return normalized;
+}
+var APP_URL_SCHEME_RE;
+var init_app_url = __esm({
+  "src/app-url.ts"() {
+    "use strict";
+    APP_URL_SCHEME_RE = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+  }
+});
+
 // src/dev-bundle-resolution.ts
 function buildUnresolvedTargetError(targetLabel) {
   return new Error(
@@ -24002,7 +24053,6 @@ __export(control_exports, {
   buildShellUrl: () => buildShellUrl,
   closeSimsBulk: () => closeSimsBulk,
   ensureBridgeForOpen: () => ensureBridgeForOpen,
-  normalizeDeepLinkTarget: () => normalizeDeepLinkTarget,
   planBulkCloseTargets: () => planBulkCloseTargets,
   playwrightHostPidForSim: () => playwrightHostPidForSim,
   printConnectedSims: () => printConnectedSims,
@@ -24063,26 +24113,6 @@ function resolveDriverHeadless(args, driverId) {
 function normalizeKnownTarget(target) {
   return target.trim();
 }
-function normalizeDeepLinkTarget(target) {
-  const trimmed = target.trim();
-  if (!trimmed) {
-    throw new Error("expected <url-or-route>");
-  }
-  if (DEEP_LINK_SCHEME_RE.test(trimmed) || trimmed.startsWith("/")) {
-    return trimmed;
-  }
-  return `/${trimmed}`;
-}
-function isObjectRecord(value) {
-  return value !== null && typeof value === "object";
-}
-function shouldOpenAsDeepLink(target) {
-  const trimmed = target.trim();
-  if (!trimmed) return false;
-  if (trimmed.startsWith("/")) return true;
-  if (!DEEP_LINK_SCHEME_RE.test(trimmed)) return false;
-  return !/^https?:\/\//i.test(trimmed);
-}
 async function ensureBridgeForOpen(preferredPort, explicitPort = false) {
   const lock = readDaemonLockfile();
   assertExplicitBridgeLock(preferredPort, explicitPort, lock);
@@ -24932,26 +24962,10 @@ async function runLinkCommand(args, opts = {}) {
     console.error("  examples: rnx open /settings  |  rnx open myapp://settings");
     process.exit(1);
   }
-  let target;
-  try {
-    target = normalizeDeepLinkTarget(parsed.positional[0] ?? "");
-  } catch (err) {
-    console.error(`  rnx open: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
-  }
   const bridge = createBridgeFromParsed(parsed);
   const simHint = parsed.simId ? ` --sim ${parsed.simId}` : "";
   try {
-    const result = await bridge.send({
-      type: "call",
-      path: "SootSim.bridges.test.openDeepLink",
-      args: [target]
-    });
-    if (isObjectRecord(result) && result.ok === false) {
-      throw new Error(
-        typeof result.error === "string" ? result.error : "deep-link dispatch failed"
-      );
-    }
+    const target = await openAppUrl(bridge, parsed.positional[0] ?? "");
     console.log(`  opened deep link: ${target}`);
   } catch (err) {
     console.error(`  link failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -25014,7 +25028,7 @@ async function runOpenCommand(args, opts = {}) {
     process.exit(1);
   }
   const target = parsed.positional[0] || "";
-  if (shouldOpenAsDeepLink(target)) {
+  if (isAppDeepLinkTarget(target)) {
     if (openInNewSim) {
       console.error(
         "  rnx open: deep links target the current app; remove --new, --profile, or --ephemeral"
@@ -25551,7 +25565,7 @@ async function runCloseCommand(args, opts = {}) {
     bridge.close();
   }
 }
-var import_node_child_process6, import_node_fs13, import_node_os3, import_node_path16, 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_fs13, import_node_os3, import_node_path16, 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;
 var init_control = __esm({
   "cli/commands/control.ts"() {
     "use strict";
@@ -25562,6 +25576,7 @@ var init_control = __esm({
     import_settings = require("sootsim-engine/settings");
     import_ws5 = require("ws");
     init_dev_server_scanner();
+    init_app_url();
     init_backend_origin();
     init_bridge_constants();
     init_config();
@@ -25598,7 +25613,6 @@ var init_control = __esm({
       photos: "/app/photos",
       camera: "/app/camera"
     };
-    DEEP_LINK_SCHEME_RE = /^[A-Za-z][A-Za-z0-9+.-]*:/;
   }
 });
 
@@ -26702,16 +26716,16 @@ __export(bridge_flow_runner_exports, {
 function sleep3(ms) {
   return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
-function isObjectRecord2(value) {
+function isObjectRecord(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function readStringKey(value, key) {
-  if (!isObjectRecord2(value)) return null;
+  if (!isObjectRecord(value)) return null;
   const raw = value[key];
   return typeof raw === "string" && raw.length > 0 ? raw : null;
 }
 function readBooleanKey(value, key) {
-  if (!isObjectRecord2(value)) return false;
+  if (!isObjectRecord(value)) return false;
   return value[key] === true;
 }
 function readRecentShellAppId(state) {
@@ -28016,8 +28030,8 @@ var init_bridge_flow_runner = __esm({
         await this.refreshSimId();
         let hasLaunchArguments = false;
         let launchArguments;
-        if (isObjectRecord2(opts) && Object.prototype.hasOwnProperty.call(opts, "arguments")) {
-          if (!isObjectRecord2(opts.arguments)) {
+        if (isObjectRecord(opts) && Object.prototype.hasOwnProperty.call(opts, "arguments")) {
+          if (!isObjectRecord(opts.arguments)) {
             throw new Error("launchApp.arguments must be a JSON object");
           }
           hasLaunchArguments = true;
@@ -28069,7 +28083,7 @@ var init_bridge_flow_runner = __esm({
           await this.waitForTree(12e4);
           if (this.opts.onAfterLaunch) {
             try {
-              await this.opts.onAfterLaunch();
+              await this.opts.onAfterLaunch(this.opts.simId);
             } catch (err) {
               console.warn(
                 `  warn: onAfterLaunch hook threw: ${err instanceof Error ? err.message : err}`
@@ -28102,7 +28116,7 @@ var init_bridge_flow_runner = __esm({
       }
       resolveShellLaunchAppId(opts, state) {
         if (typeof opts === "string" && opts.length > 0) return opts;
-        if (isObjectRecord2(opts)) {
+        if (isObjectRecord(opts)) {
           const explicit = readStringKey(opts, "appId") || readStringKey(opts, "id");
           if (explicit) return explicit;
         }

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.365 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.366 | (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.365",
+  "version": "0.1.366",
   "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",
@@ -71,6 +71,12 @@
       "import": "./dist-lib/sdk.mjs",
       "default": "./dist-lib/sdk.cjs"
     },
+    "./mcp": {
+      "types": "./src/mcp.ts",
+      "source": "./src/mcp.ts",
+      "import": "./dist-lib/mcp.mjs",
+      "default": "./dist-lib/mcp.cjs"
+    },
     "./beta": {
       "source": "./src/beta.ts",
       "import": "./dist-lib/beta.mjs",

package/src/app-url.ts

@@ -0,0 +1,40 @@
+import type { InspectBridge } from '../cli/commands/inspect/core'
+
+const APP_URL_SCHEME_RE = /^[A-Za-z][A-Za-z0-9+.-]*:/
+
+export function normalizeAppUrlTarget(target: string): string {
+  const trimmed = target.trim()
+  if (!trimmed) {
+    throw new Error('expected <url-or-route>')
+  }
+  if (APP_URL_SCHEME_RE.test(trimmed) || trimmed.startsWith('/')) {
+    return trimmed
+  }
+  return `/${trimmed}`
+}
+
+export function isAppDeepLinkTarget(target: string): boolean {
+  const trimmed = target.trim()
+  if (!trimmed) return false
+  if (trimmed.startsWith('/')) return true
+  if (!APP_URL_SCHEME_RE.test(trimmed)) return false
+  return !/^https?:\/\//i.test(trimmed)
+}
+
+export async function openAppUrl(bridge: InspectBridge, target: string): Promise<string> {
+  const normalized = normalizeAppUrlTarget(target)
+  const result: unknown = await bridge.send({
+    type: 'call',
+    path: 'SootSim.bridges.test.openDeepLink',
+    args: [normalized],
+  })
+  if (
+    result !== null &&
+    typeof result === 'object' &&
+    Reflect.get(result, 'ok') === false
+  ) {
+    const error = Reflect.get(result, 'error')
+    throw new Error(typeof error === 'string' ? error : 'deep-link dispatch failed')
+  }
+  return normalized
+}