sootsim 0.1.278 → 0.1.280

package/dist-cli/chunks/{what-happened-ZRUTW7UX.js → what-happened-PX2UYSNH.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{C as N,D as F,F as y,Q as T,R as b,S}from"./chunk-G6BXG7VY.js";import{g as A,i as _}from"./chunk-SEHYHPX6.js";import"./chunk-S3W6UTLA.js";import{c as k}from"./chunk-P7HEGSYC.js";import"./chunk-PDW6B3N2.js";import"./chunk-ZM3E3WYD.js";function O(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--since"&&e+1<n.length){t.push(e,e+1);let s=n[e+1].trim(),l=/^(\d+(?:\.\d+)?)(ms|s|m)?$/.exec(s);if(l){let r=Number(l[1]),u=l[2]??"ms",v=u==="s"?r*1e3:u==="m"?r*6e4:r;return{since:Date.now()-v,consumed:t}}let i=Number(s);if(Number.isFinite(i)&&i>1e12)return{since:i,consumed:t}}return{consumed:t}}function B(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--kinds"&&e+1<n.length)return t.push(e,e+1),{kinds:n[e+1].split(",").map(s=>s.trim()).filter(Boolean),consumed:t};return{consumed:t}}function D(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--limit"&&e+1<n.length){t.push(e,e+1);let s=Number(n[e+1]);if(Number.isFinite(s)&&s>0)return{limit:s,consumed:t}}return{consumed:t}}function x(n){let t=[],e={label:"initial state",events:[],startedAt:n[0]?.t??null};t.push(e);for(let s of n)if(e.events.push(s),s.kind==="screen"||s.kind==="route"){let l=s.data,i=l?.phase;if(!i||i==="enter"||i==="appear"||i==="active"){let r=l?.name||l?.activeName||l?.path||l?.pathname||s.kind;t.length===1&&e.events.length===1?e.label=`${s.kind}: ${r}`:(e={label:`${s.kind}: ${r}`,events:[],startedAt:s.t},t.push(e))}}return t}async function J(n,t){let e=A(n,{port:t.port,stripBooleanFlags:["--summary","--all","--json","--no-advance","--help","-h","--flow","--noisy"],stripValueFlags:["--since","--kinds","--limit"]});(n.includes("--help")||n.includes("-h"))&&(console.log(`
+/*! sootsim v0.1.280 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{C as N,D as F,F as y,Q as T,R as b,S}from"./chunk-JNI6O5ID.js";import{g as A,i as _}from"./chunk-YATEKNXL.js";import"./chunk-OUHXKX62.js";import{c as k}from"./chunk-HVOLXPNB.js";import"./chunk-UEDGP46Q.js";import"./chunk-TGARSKJS.js";function O(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--since"&&e+1<n.length){t.push(e,e+1);let s=n[e+1].trim(),l=/^(\d+(?:\.\d+)?)(ms|s|m)?$/.exec(s);if(l){let r=Number(l[1]),u=l[2]??"ms",v=u==="s"?r*1e3:u==="m"?r*6e4:r;return{since:Date.now()-v,consumed:t}}let i=Number(s);if(Number.isFinite(i)&&i>1e12)return{since:i,consumed:t}}return{consumed:t}}function B(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--kinds"&&e+1<n.length)return t.push(e,e+1),{kinds:n[e+1].split(",").map(s=>s.trim()).filter(Boolean),consumed:t};return{consumed:t}}function D(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--limit"&&e+1<n.length){t.push(e,e+1);let s=Number(n[e+1]);if(Number.isFinite(s)&&s>0)return{limit:s,consumed:t}}return{consumed:t}}function x(n){let t=[],e={label:"initial state",events:[],startedAt:n[0]?.t??null};t.push(e);for(let s of n)if(e.events.push(s),s.kind==="screen"||s.kind==="route"){let l=s.data,i=l?.phase;if(!i||i==="enter"||i==="appear"||i==="active"){let r=l?.name||l?.activeName||l?.path||l?.pathname||s.kind;t.length===1&&e.events.length===1?e.label=`${s.kind}: ${r}`:(e={label:`${s.kind}: ${r}`,events:[],startedAt:s.t},t.push(e))}}return t}async function J(n,t){let e=A(n,{port:t.port,stripBooleanFlags:["--summary","--all","--json","--no-advance","--help","-h","--flow","--noisy"],stripValueFlags:["--since","--kinds","--limit"]});(n.includes("--help")||n.includes("-h"))&&(console.log(`
 sootsim what-happened \u2014 show recent events from the semantic timeline
 
 usage:

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/agent-identity.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/beta.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/beta.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/config.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/home-paths.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/host/bridge-host.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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;
@@ -4780,26 +4780,40 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
       if (sim?.ws.readyState === import_ws2.WebSocket.OPEN) return sim;
       return null;
     }
-    const primary = this.primarySimId != null ? this.sims.get(this.primarySimId) : null;
-    if (primary?.ws.readyState === import_ws2.WebSocket.OPEN && primary.url) return primary;
-    let pagelessFallback = null;
-    for (const sim of this.sims.values()) {
-      if (sim.ws.readyState !== import_ws2.WebSocket.OPEN) continue;
-      if (sim.url) return sim;
-      pagelessFallback ??= sim;
-    }
-    if (primary?.ws.readyState === import_ws2.WebSocket.OPEN) return primary;
-    return pagelessFallback;
+    const candidates = this.getDefaultSimCandidates();
+    return candidates.find((sim) => sim.id === this.primarySimId) ?? candidates[0] ?? null;
+  }
+  getDefaultSimCandidates() {
+    const open = Array.from(this.sims.values()).filter(
+      (sim) => sim.ws.readyState === import_ws2.WebSocket.OPEN
+    );
+    const registered = open.filter((sim) => sim.url);
+    return registered.length > 0 ? registered : open;
   }
   async waitForSim(simId, options = {}) {
     const attempts = options.attempts ?? 10;
     const intervalMs = options.intervalMs ?? 200;
     for (let attempt = 0; attempt < attempts; attempt++) {
-      const sim = this.getOpenSim(simId);
-      if (sim) return sim;
+      if (!simId) {
+        const candidates = this.getDefaultSimCandidates();
+        if (candidates.length > 1) {
+          throw new Error(
+            `multiple sims are connected: ${candidates.map((sim) => sim.id).join(", ")}; run \`sootsim use <sim>\` or pass \`--sim <sim>\``
+          );
+        }
+        const candidate = candidates[0];
+        if (candidate) return candidate;
+      } else {
+        const sim = this.getOpenSim(simId);
+        if (sim) return sim;
+      }
       await new Promise((resolve) => setTimeout(resolve, intervalMs));
     }
-    throw new Error(simId ? `no sim connected with id ${simId}` : "no sim connected");
+    if (!simId) throw new Error("no sim connected");
+    const openSimIds = this.getDefaultSimCandidates().map((sim) => sim.id);
+    throw new Error(
+      `no sim connected with id ${simId}` + (openSimIds.length > 0 ? `; connected sims: ${openSimIds.join(", ")}` : "")
+    );
   }
   shouldPromoteSim(sim) {
     const current = this.primarySimId ? this.sims.get(this.primarySimId) : null;

package/dist-lib/host/fetch-proxy-handler.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/host/fetch-proxy-overrides.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/host/fetch-proxy-overrides.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/host/fetch-proxy-overrides.ts
 var FETCH_PROXY_BROWSER_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36";

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

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/menu.ts
 var SOOTSIM_ENGINE_EVENT_NAME = "sootsim:engine-event";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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;
@@ -1003,6 +1003,9 @@ async function inspectWaitReady(bridge, timeoutMs = 2e4, options = {}) {
       bridgeError = "";
     } catch (error) {
       bridgeError = error instanceof Error ? error.message : String(error);
+      if (bridgeError.startsWith("multiple sims are connected:") || bridgeError.startsWith("saved sim ")) {
+        throw error;
+      }
     }
     const now = Date.now();
     const status = {

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {
@@ -912,6 +912,9 @@ async function inspectWaitReady(bridge, timeoutMs = 2e4, options = {}) {
       bridgeError = "";
     } catch (error) {
       bridgeError = error instanceof Error ? error.message : String(error);
+      if (bridgeError.startsWith("multiple sims are connected:") || bridgeError.startsWith("saved sim ")) {
+        throw error;
+      }
     }
     const now = Date.now();
     const status = {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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;
@@ -5801,9 +5801,49 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=15.0.0",
-            coverage: 1,
-            note: 'load-safe noop \u2014 GLView component renders null; createContextAsync rejects with "host bridge required" so apps with optional WebGL paths take their fallback',
-            missing: "no WebGL canvas in tenant worker. browsers have WebGL but sootsim renders through CanvasKit on the host \u2014 bridging requires a future host-side GL surface"
+            coverage: 0.9,
+            note: "native-seam only. upstream GLView and context APIs run from the guest bundle over the browser WebGL2 implementation in the tenant worker",
+            working: "GLView context creation, WebGL2 commands, endFrameEXP presentation, view resizing, headless createContextAsync and destroyContextAsync, full-canvas snapshots, and @react-three/fiber native Canvas rendering",
+            missing: "camera textures, native object destruction, experimental worklet contexts, asset-object texture uploads, and exact native MSAA sample counts"
+          }
+        ]
+      },
+      three: {
+        category: "UI Components",
+        stubType: "works",
+        versions: [
+          {
+            range: ">=0.156.0",
+            coverage: 0.96,
+            note: "real pure-JavaScript package runs from the guest bundle; WebGLRenderer uses the browser WebGL2 context supplied by expo-gl",
+            working: "scenes, cameras, geometry, lights, standard materials, shaders, animation, and WebGLRenderer",
+            missing: "browser DOM integrations and loaders that require unsupported expo-gl asset-object texture uploads"
+          }
+        ]
+      },
+      "@react-three/fiber": {
+        category: "UI Components",
+        stubType: "works",
+        versions: [
+          {
+            range: ">=9.0.0",
+            coverage: 0.93,
+            note: "real native entry and reconciler run from the guest bundle; Canvas mounts upstream expo-gl and presents each useFrame render through endFrameEXP",
+            working: "native Canvas, declarative Three elements, useFrame, useThree, lights, materials, cameras, events, and continuous animation",
+            missing: "asset-backed texture loading and browser-only DOM event integrations"
+          }
+        ]
+      },
+      "expo-three": {
+        category: "UI Components",
+        stubType: "works",
+        versions: [
+          {
+            range: ">=8.0.0",
+            coverage: 0.75,
+            note: "real pure-JavaScript package runs from the guest bundle on the expo-gl WebGL2 context",
+            working: "Three renderer construction and helpers that use plain WebGL resources",
+            missing: "asset and texture helpers that depend on expo-gl asset-object uploads, camera textures, or browser DOM image elements"
           }
         ]
       },
@@ -15439,26 +15479,40 @@ var init_bridge_host = __esm({
           if (sim?.ws.readyState === import_ws2.WebSocket.OPEN) return sim;
           return null;
         }
-        const primary = this.primarySimId != null ? this.sims.get(this.primarySimId) : null;
-        if (primary?.ws.readyState === import_ws2.WebSocket.OPEN && primary.url) return primary;
-        let pagelessFallback = null;
-        for (const sim of this.sims.values()) {
-          if (sim.ws.readyState !== import_ws2.WebSocket.OPEN) continue;
-          if (sim.url) return sim;
-          pagelessFallback ??= sim;
-        }
-        if (primary?.ws.readyState === import_ws2.WebSocket.OPEN) return primary;
-        return pagelessFallback;
+        const candidates = this.getDefaultSimCandidates();
+        return candidates.find((sim) => sim.id === this.primarySimId) ?? candidates[0] ?? null;
+      }
+      getDefaultSimCandidates() {
+        const open = Array.from(this.sims.values()).filter(
+          (sim) => sim.ws.readyState === import_ws2.WebSocket.OPEN
+        );
+        const registered = open.filter((sim) => sim.url);
+        return registered.length > 0 ? registered : open;
       }
       async waitForSim(simId, options = {}) {
         const attempts = options.attempts ?? 10;
         const intervalMs = options.intervalMs ?? 200;
         for (let attempt = 0; attempt < attempts; attempt++) {
-          const sim = this.getOpenSim(simId);
-          if (sim) return sim;
+          if (!simId) {
+            const candidates = this.getDefaultSimCandidates();
+            if (candidates.length > 1) {
+              throw new Error(
+                `multiple sims are connected: ${candidates.map((sim) => sim.id).join(", ")}; run \`sootsim use <sim>\` or pass \`--sim <sim>\``
+              );
+            }
+            const candidate = candidates[0];
+            if (candidate) return candidate;
+          } else {
+            const sim = this.getOpenSim(simId);
+            if (sim) return sim;
+          }
           await new Promise((resolve5) => setTimeout(resolve5, intervalMs));
         }
-        throw new Error(simId ? `no sim connected with id ${simId}` : "no sim connected");
+        if (!simId) throw new Error("no sim connected");
+        const openSimIds = this.getDefaultSimCandidates().map((sim) => sim.id);
+        throw new Error(
+          `no sim connected with id ${simId}` + (openSimIds.length > 0 ? `; connected sims: ${openSimIds.join(", ")}` : "")
+        );
       }
       shouldPromoteSim(sim) {
         const current = this.primarySimId ? this.sims.get(this.primarySimId) : null;
@@ -16254,10 +16308,11 @@ function createBridge(wsPort, opts = {}) {
         return await sendOnce(sentSimId);
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        if (opts.simIdSource !== "flag" && sentSimId && cmd.simId === void 0 && message === `no sim connected with id ${sentSimId}`) {
+        const missingSimMessage = `no sim connected with id ${sentSimId}`;
+        if (opts.simIdSource !== "flag" && sentSimId && cmd.simId === void 0 && (message === missingSimMessage || message.startsWith(`${missingSimMessage};`))) {
           clearCurrentSimId();
           throw new Error(
-            `saved sim ${sentSimId} is gone; run \`sootsim list\` and \`sootsim use <sim>\`, or open a fresh sim`
+            `saved sim ${sentSimId} is gone${message.slice(missingSimMessage.length)}; run \`sootsim list\` and \`sootsim use <sim>\`, or open a fresh sim`
           );
         }
         throw error;

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.280 | (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": "sootsim",
-  "version": "0.1.278",
+  "version": "0.1.280",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",

package/skills/sootsim-debug/SKILL.md

@@ -62,8 +62,7 @@ regression test. a pile of ad-hoc logs helps no one and gets deleted.
   changes, and duplicate strings. add `testID` during implementation and
   query against it.
 - **pin a sim once.** if more than one is live, an unpinned command
-  hits the first and produces results from the wrong app. `sootsim use
-  <id>` at the start of the workflow.
+  refuses to choose. run `sootsim use <id>` at the start of the workflow.
 - **`debug eval` is an escape hatch.** if a top-level command feels
   broken or missing, file an issue — every agent after you benefits from
   a better CLI, not a pile of ad-hoc scripts.

package/skills/sootsim-setup/SKILL.md

@@ -18,8 +18,8 @@ debugging or `/sootsim-test` for writing tests.
   exists for a reason — forcing strands the other agent and corrupts the
   bridge state. use `sootsim open --new` to start a fresh sim instead.
 - **don't switch sims mid-investigation.** pin once with `sootsim use
-  <id>` and keep it pinned. an unpinned command hits the first sim,
-  which produces baffling results when more than one is live.
+  <id>` and keep it pinned. an unpinned command refuses to choose when more
+  than one driveable sim is live.
 - **an empty `sootsim list` is not "broken sootsim"** — it usually means the
   daemon is down, the dev server port is wrong, or the runtime is missing.
   walk the recovery checklist before reinstalling.

package/src/host/bridge-host.ts

@@ -2253,21 +2253,19 @@ export class SootSimBridgeHost {
       if (sim?.ws.readyState === WebSocket.OPEN) return sim
       return null
     }
-    const primary = this.primarySimId != null ? this.sims.get(this.primarySimId) : null
-    if (primary?.ws.readyState === WebSocket.OPEN && primary.url) return primary
-    // prefer a sim that has actually reported a page over a bare-connected
-    // zombie — falling back to a url-less socket hands every default-target
-    // command to something that can't render or be driven (QA F19-2).
-    let pagelessFallback: BridgeSimConnection | null = null
-    for (const sim of this.sims.values()) {
-      if (sim.ws.readyState !== WebSocket.OPEN) continue
-      if (sim.url) return sim
-      pagelessFallback ??= sim
-    }
-    // a live primary with no url still beats nothing, and so does any other
-    // page-less open socket — only as the last resort.
-    if (primary?.ws.readyState === WebSocket.OPEN) return primary
-    return pagelessFallback
+    const candidates = this.getDefaultSimCandidates()
+    return candidates.find((sim) => sim.id === this.primarySimId) ?? candidates[0] ?? null
+  }
+
+  private getDefaultSimCandidates(): BridgeSimConnection[] {
+    const open = Array.from(this.sims.values()).filter(
+      (sim) => sim.ws.readyState === WebSocket.OPEN,
+    )
+    // a registered page is driveable; a bare host-shell socket is not. use
+    // page-less sockets only when no registered page exists, matching the
+    // default-routing behavior above.
+    const registered = open.filter((sim) => sim.url)
+    return registered.length > 0 ? registered : open
   }
 
   private async waitForSim(
@@ -2277,11 +2275,28 @@ export class SootSimBridgeHost {
     const attempts = options.attempts ?? 10
     const intervalMs = options.intervalMs ?? 200
     for (let attempt = 0; attempt < attempts; attempt++) {
-      const sim = this.getOpenSim(simId)
-      if (sim) return sim
+      if (!simId) {
+        const candidates = this.getDefaultSimCandidates()
+        if (candidates.length > 1) {
+          throw new Error(
+            `multiple sims are connected: ${candidates.map((sim) => sim.id).join(', ')}; ` +
+              'run `sootsim use <sim>` or pass `--sim <sim>`',
+          )
+        }
+        const candidate = candidates[0]
+        if (candidate) return candidate
+      } else {
+        const sim = this.getOpenSim(simId)
+        if (sim) return sim
+      }
       await new Promise((resolve) => setTimeout(resolve, intervalMs))
     }
-    throw new Error(simId ? `no sim connected with id ${simId}` : 'no sim connected')
+    if (!simId) throw new Error('no sim connected')
+    const openSimIds = this.getDefaultSimCandidates().map((sim) => sim.id)
+    throw new Error(
+      `no sim connected with id ${simId}` +
+        (openSimIds.length > 0 ? `; connected sims: ${openSimIds.join(', ')}` : ''),
+    )
   }
 
   private shouldPromoteSim(sim: BridgeSimConnection): boolean {

package/dist-cli/chunks/beta-KZ3ONL3P.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d}from"./chunk-ARKDZWF6.js";import"./chunk-ZM3E3WYD.js";export{d as BETA_ASK_HEADLINE,b as BETA_LABEL,c as BETA_TAGLINE,a as IS_BETA};

package/dist-cli/chunks/chunk-26LYIC2U.js

@@ -1 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */

package/dist-cli/chunks/cli-version-4OTVDRSR.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-F37BG6K2.js";import"./chunk-ZM3E3WYD.js";export{a as getCliVersion};

package/dist-cli/chunks/daemon-4TRUUJSU.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d,e}from"./chunk-QLDOJRZW.js";import"./chunk-IPJCQYVZ.js";import"./chunk-4E5WFXKO.js";import"./chunk-7WL6EUXR.js";import"./chunk-BBHVSEKE.js";import"./chunk-FVJSE6Y2.js";import"./chunk-MEYBUDD7.js";import"./chunk-S3W6UTLA.js";import"./chunk-P7HEGSYC.js";import"./chunk-ECIZ5WCX.js";import"./chunk-PDW6B3N2.js";import"./chunk-F37BG6K2.js";import"./chunk-ARKDZWF6.js";import"./chunk-ZVG74GYW.js";import"./chunk-ZM3E3WYD.js";export{c as daemonInstall,b as getDaemonServiceStatus,a as runDaemon,d as teardownDaemonService,e as teardownSootsimHome};

package/dist-cli/chunks/drivers-GCYZRW6W.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import"./chunk-26LYIC2U.js";import{f as a,g as b,h as c,i as d,j as e,k as f,l as g,m as h,n as i}from"./chunk-NDEEFUJ6.js";import"./chunk-JX7MP2NT.js";import"./chunk-MUUN57VH.js";import"./chunk-P7HEGSYC.js";import"./chunk-PDW6B3N2.js";import"./chunk-ZM3E3WYD.js";export{e as ALL_DRIVERS,i as buildDriverListRows,a as chromiumDriver,b as electronDriver,f as getAllDrivers,g as getDriver,c as playwrightDriver,h as resolveDriver,d as systemDriver};

package/dist-cli/chunks/flow-P3EAPWSK.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{c,d,e,f,g,h}from"./chunk-5QHDYNQI.js";import"./chunk-YHZKEENM.js";import"./chunk-UTQRTNQ4.js";import{c as a,d as b}from"./chunk-WNV2DVC3.js";import"./chunk-EVJMR3LZ.js";import"./chunk-5PZJV6XA.js";import"./chunk-GR5BX5TR.js";import"./chunk-HWHU5RFR.js";import"./chunk-2PSJER4C.js";import"./chunk-TZN3SE6S.js";import"./chunk-NDEEFUJ6.js";import"./chunk-JX7MP2NT.js";import"./chunk-XHUCJ2KM.js";import"./chunk-TWKJ3ATX.js";import"./chunk-MUUN57VH.js";import"./chunk-DE5TUBCV.js";import"./chunk-ZNJMLHBI.js";import"./chunk-G6BXG7VY.js";import"./chunk-SEHYHPX6.js";import"./chunk-DKG4EC2K.js";import"./chunk-IPJCQYVZ.js";import"./chunk-4E5WFXKO.js";import"./chunk-FVJSE6Y2.js";import"./chunk-MEYBUDD7.js";import"./chunk-S3W6UTLA.js";import"./chunk-P7HEGSYC.js";import"./chunk-ECIZ5WCX.js";import"./chunk-PDW6B3N2.js";import"./chunk-RPWKLHC2.js";import"./chunk-ZVG74GYW.js";import"./chunk-ZM3E3WYD.js";export{e as discoverSootsimUrl,c as getLastFlowPreviewUploadResult,d as getLastFlowTraceSteps,g as hoistLeadingSimFlag,a as parseFlowFile,f as runFlowPlayback,h as runMaestroAuthoring,b as validateFlowFile};

package/dist-cli/chunks/help-AJOB3QUG.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-7WL6EUXR.js";import"./chunk-BBHVSEKE.js";import"./chunk-FVJSE6Y2.js";import"./chunk-MEYBUDD7.js";import"./chunk-S3W6UTLA.js";import"./chunk-P7HEGSYC.js";import"./chunk-ECIZ5WCX.js";import"./chunk-PDW6B3N2.js";import"./chunk-F37BG6K2.js";import"./chunk-ARKDZWF6.js";import"./chunk-ZVG74GYW.js";import"./chunk-ZM3E3WYD.js";export{c as printCommandHelp,b as printGroupHelp,a as printHelp};

package/dist-cli/chunks/inspect-CEH5GHXF.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{j as a,k as b}from"./chunk-WNV2DVC3.js";import"./chunk-EVJMR3LZ.js";import"./chunk-HWHU5RFR.js";import"./chunk-2PSJER4C.js";import"./chunk-TZN3SE6S.js";import"./chunk-NDEEFUJ6.js";import"./chunk-JX7MP2NT.js";import"./chunk-XHUCJ2KM.js";import"./chunk-TWKJ3ATX.js";import"./chunk-MUUN57VH.js";import"./chunk-DE5TUBCV.js";import"./chunk-ZNJMLHBI.js";import"./chunk-G6BXG7VY.js";import"./chunk-SEHYHPX6.js";import"./chunk-DKG4EC2K.js";import"./chunk-FVJSE6Y2.js";import"./chunk-MEYBUDD7.js";import"./chunk-S3W6UTLA.js";import"./chunk-P7HEGSYC.js";import"./chunk-ECIZ5WCX.js";import"./chunk-PDW6B3N2.js";import"./chunk-RPWKLHC2.js";import"./chunk-ZVG74GYW.js";import"./chunk-ZM3E3WYD.js";export{a as printShellPerfReport,b as runInspect};

package/dist-cli/chunks/install-desktop-GPGYMR4M.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-QSC5VVWF.js";import"./chunk-JX7MP2NT.js";import"./chunk-TG4UX6X4.js";import"./chunk-ZM3E3WYD.js";export{a as runInstallDesktop};

package/dist-cli/chunks/optional-demo-registry-432VIZ2M.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-DE5TUBCV.js";import"./chunk-ZM3E3WYD.js";export{c as __withOptionalDemoAppsForTests,a as loadOptionalDemoApps,b as optionalDemoAppsSync};

package/dist-cli/chunks/runtime-T26WFIMO.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-NJRMZW73.js";import"./chunk-X7F3RBC5.js";import"./chunk-SEHYHPX6.js";import"./chunk-S3W6UTLA.js";import"./chunk-P7HEGSYC.js";import"./chunk-PDW6B3N2.js";import"./chunk-ZM3E3WYD.js";export{a as runRuntime};

package/dist-cli/chunks/store-2TRIGABQ.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.278 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-RPWKLHC2.js";import"./chunk-ZVG74GYW.js";import"./chunk-ZM3E3WYD.js";export{a as settingsStore};