sootsim 0.1.182 → 0.1.184

package/dist-cli/chunks/{what-happened-XNHLVLK2.js → what-happened-67DBMM4S.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.182 | (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-RYITW4MR.js";import{c as A,e as _}from"./chunk-TM22UZS6.js";import"./chunk-RCRWF4N5.js";import{b as k}from"./chunk-BI3LQWFJ.js";import"./chunk-NAZ6A4UL.js";import"./chunk-UNQ4TTPS.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.184 | (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-7DHLNDOA.js";import{c as A,e as _}from"./chunk-7C6RC3BU.js";import"./chunk-Q2S6VBXK.js";import{b as k}from"./chunk-V36X7TNR.js";import"./chunk-53KKDNCU.js";import"./chunk-IHH3JCV5.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-cli/chunks/{whoami-YSWN3MZU.js → whoami-PSQRCMUL.js}

@@ -1,2 +1,2 @@
-/*! sootsim v0.1.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{d as i}from"./chunk-PP7PACYK.js";import{d as n}from"./chunk-Q75UTFKH.js";import"./chunk-NAZ6A4UL.js";import"./chunk-UNQ4TTPS.js";async function u(){let o=i();if(o||(console.log("  not signed in"),console.log("  set SOOTSIM_API_KEY=sk_sootsim_\u2026 or run `sootsim login`"),process.exit(1)),o.kind==="api-key"){let r=`${o.secret.slice(0,14)}\u2026`,t=o.source==="env"?"SOOTSIM_API_KEY env var":"saved key (~/.config/sootsim/credentials.json)";console.log(`  api key ${r}`),console.log(`  source: ${t}`);return}if(o.kind==="github"){console.log(`  github token (${o.source})`),console.log(`  repo: ${o.repoId}`);return}let e=await n(),s=e?.user;console.log(`  ${s?.email||s?.name||s?.id||"signed in"}`),console.log(`  origin: ${e?.origin??o.origin}`),e?.updatedAt&&console.log(`  updated: ${e.updatedAt}`)}export{u as runWhoami};
+/*! sootsim v0.1.184 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{d as i}from"./chunk-6GC57KRY.js";import{d as n}from"./chunk-N5LA5G7V.js";import"./chunk-53KKDNCU.js";import"./chunk-IHH3JCV5.js";async function u(){let o=i();if(o||(console.log("  not signed in"),console.log("  set SOOTSIM_API_KEY=sk_sootsim_\u2026 or run `sootsim login`"),process.exit(1)),o.kind==="api-key"){let r=`${o.secret.slice(0,14)}\u2026`,t=o.source==="env"?"SOOTSIM_API_KEY env var":"saved key (~/.config/sootsim/credentials.json)";console.log(`  api key ${r}`),console.log(`  source: ${t}`);return}if(o.kind==="github"){console.log(`  github token (${o.source})`),console.log(`  repo: ${o.repoId}`);return}let e=await n(),s=e?.user;console.log(`  ${s?.email||s?.name||s?.id||"signed in"}`),console.log(`  origin: ${e?.origin??o.origin}`),e?.updatedAt&&console.log(`  updated: ${e.updatedAt}`)}export{u as runWhoami};

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

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

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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 @@
-/*! sootsim v0.1.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.184 | (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;
@@ -16786,6 +16786,7 @@ var init_bridge_flow_runner = __esm({
       recordingAccessChecked = false;
       recordingStartedAtMs = null;
       lastRecordingDurationMs = null;
+      lastVisualSettledAtMs = 0;
       simRouteHint = null;
       // set by runStep when a step throws — lets the outer flow command
       // dump a rich per-step failure bundle (screenshot + describe.json +
@@ -17382,11 +17383,13 @@ var init_bridge_flow_runner = __esm({
         );
       }
       async takeScreenshot(step) {
-        try {
-          await this.waitForVisualSettle();
-        } catch {
+        if (!this.hasFreshVisualSettle()) {
+          try {
+            await this.waitForVisualSettle();
+            await sleep(250);
+          } catch {
+          }
         }
-        await sleep(250);
         const spec = normalizeFlowScreenshotSpec(step);
         const outputPath = resolveFlowScreenshotPathWithMode(
           this.opts.screenshotDir,
@@ -17662,7 +17665,17 @@ var init_bridge_flow_runner = __esm({
         }
       }
       async waitForAnimationToEnd(timeoutMs = 2e3) {
-        await sleep(timeoutMs);
+        const maxMs = Math.max(0, Math.round(timeoutMs));
+        if (maxMs <= 0) return;
+        const result = await waitForSootsimIdle({
+          bridge: this.bridge,
+          simId: this.opts.simId,
+          maxMs,
+          pollMs: 32,
+          stablePolls: 2,
+          strict: true
+        });
+        if (result.settled) this.markVisualSettled();
       }
       async back() {
         try {
@@ -17787,10 +17800,18 @@ var init_bridge_flow_runner = __esm({
           })
         })
       })`);
+          this.markVisualSettled();
         } catch {
           await sleep(180);
+          this.markVisualSettled();
         }
       }
+      markVisualSettled() {
+        this.lastVisualSettledAtMs = Date.now();
+      }
+      hasFreshVisualSettle() {
+        return Date.now() - this.lastVisualSettledAtMs < 750;
+      }
       async startProfile() {
         await this.evaluate(`((sessionKey) => {
       const perf = window.__sootsimPerf
@@ -18099,8 +18120,9 @@ var init_bridge_flow_runner = __esm({
         } else if (step.pinch) {
           await this.pinch(step.pinch);
         } else if (step.waitForAnimationToEnd) {
+          const waitSpec = step.waitForAnimationToEnd;
           await this.waitForAnimationToEnd(
-            typeof step.waitForAnimationToEnd === "number" ? step.waitForAnimationToEnd : 2e3
+            typeof waitSpec === "number" ? waitSpec : typeof waitSpec === "object" && typeof waitSpec.timeout === "number" ? waitSpec.timeout : 2e3
           );
         } else if (step.back) {
           await this.back();

package/dist-lib/vite.cjs

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

package/scripts/postinstall.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// postinstall — best-effort runtime install after `npm i -g sootsim`.
+// postinstall — best-effort runtime install after npm/npx fetches sootsim.
 //
 // runs as a child of npm. failures here are non-fatal; setup/open/runtime
 // commands can install the runtime later.

package/skills/soot.md

@@ -53,13 +53,14 @@ automation, inspecting the render tree, and managing sims.
 | `sootsim diagnose` | composed read commands for "what just went wrong?" |
 | `sootsim timeline` | control the semantic event timeline (enable opt-in kinds, clear, dump) |
 | `sootsim open` | load a target into the current sim or open a new one |
+| `sootsim link` | dispatch a React Native deep link into the current app |
 | `sootsim list` | list connected sims or available launch drivers |
 | `sootsim use` | select a connected sim |
 | `sootsim skill` | install and inspect bundled SootSim agent skills |
 | `sootsim claim` | take an exclusive lease on a sim |
 | `sootsim agent` | attached projects + local agent sessions (codex/claude) |
 | `sootsim close` | close a connected sim |
-| `sootsim setup` | set up this machine and, optionally, this repo |
+| `sootsim setup` | bootstrap SootSim, then install the global CLI |
 | `sootsim compat` | check package compatibility (alias: scan) |
 | `sootsim electron` | launch the desktop companion |
 | `sootsim daemon` | manage the sootsim bridge as a login agent |
@@ -103,7 +104,7 @@ skills for working with the SootSim native preview engine:
 | skill | description |
 | --- | --- |
 | `/sootsim-debug` | Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under sootsim. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the sootsim CLI debug tooling first, not screenshots or ad-hoc logging. |
-| `/sootsim-setup` | Get sootsim connected to your React Native app — from `npm install sootsim` to a driveable sim |
+| `/sootsim-setup` | Get sootsim connected to your React Native app — from `sootsim setup` to a driveable sim |
 | `/sootsim-test` | Run automated tests against your React Native app under sootsim — native YAML flows, Maestro drop-in, or Detox drop-in |
 | `/sootsim-visual` | Pixel-level rendering comparison between sootsim and native iOS — fonts, gradients, shadows, image fidelity |
 

package/skills/sootsim-setup.md

@@ -1,13 +1,14 @@
 ---
 name: sootsim-setup
-description: Get sootsim connected to your React Native app — from `npm install sootsim` to a driveable sim
+description: Get sootsim connected to your React Native app — from `sootsim setup` to a driveable sim
 ---
 
 # sootsim setup
 
-you've installed sootsim into a React Native project and want to drive it
-from the CLI. this skill takes you from zero to a connected, pinned sim
-that every other sootsim skill assumes exists. if `sootsim describe` already
+you want to drive a React Native app with SootSim from the CLI. this skill
+takes you from `sootsim setup` to a connected, pinned sim that every other
+sootsim skill assumes exists. no per-app SootSim install is required. if
+`sootsim describe` already
 returns a tree, you're past this skill — load `/sootsim-debug` for
 debugging or `/sootsim-test` for writing tests.
 
@@ -26,7 +27,7 @@ debugging or `/sootsim-test` for writing tests.
 ## first move
 
 ```sh
-sootsim setup                    # one-time — installs daemon, optional repo setup
+sootsim setup                    # one-time guided setup; installs daemon
 sootsim open 8081                # load a metro/expo dev server
 sootsim list                     # confirm exactly one sim is reachable
 sootsim use <id>                 # pin it for the rest of the workflow
@@ -38,7 +39,7 @@ the detected dev servers. for hosted or unusual targets, pass the URL
 explicitly:
 
 ```sh
-sootsim open 8081                # load a metro dev server
+sootsim open 8081                  # load a metro dev server
 sootsim open https://my-app.local  # load a hosted bundle
 ```
 

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

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

package/dist-cli/chunks/chunk-5TEBVNSH.js

@@ -1,62 +0,0 @@
-/*! sootsim v0.1.182 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as C,b as _}from"./chunk-J4G763OR.js";import{c as R}from"./chunk-2CLPGOAC.js";import{g as T,j as E,r as N,s as b,t as B}from"./chunk-NAZ6A4UL.js";import{a as Y}from"./chunk-UNQ4TTPS.js";import{execFileSync as tt,spawnSync as s}from"child_process";import{existsSync as c,mkdirSync as x,readFileSync as et,rmSync as $,writeFileSync as M}from"fs";import{homedir as D}from"os";import{dirname as j,resolve as f}from"path";import{execFileSync as G}from"child_process";import{chmodSync as W,mkdirSync as P,rmSync as K,writeFileSync as L}from"fs";import{dirname as A}from"path";var X="dev.sootsim.daemon",U="SootSim Daemon",O="0.1.36";function F(t,e,r){let o=b(),n=B(),a=A(A(n)),l=A(n),u=`${a}/Resources`;K(o,{recursive:!0,force:!0}),P(N(),{recursive:!0}),P(l,{recursive:!0}),P(u,{recursive:!0}),L(`${a}/Info.plist`,Q()),L(`${a}/PkgInfo`,"APPL????"),L(n,z(t,e,r)),W(n,493);try{G("codesign",["--force","--sign","-","--deep",o],{stdio:"pipe"})}catch(i){let p=i instanceof Error?i.message:String(i);console.warn(`  warning: ad-hoc codesign of ${o} failed: ${p}
-  the daemon will still run, but Login Items may show a generic name.`)}return{bundlePath:o,launcherPath:n}}function Q(){return`<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>CFBundleDevelopmentRegion</key><string>en</string>
-  <key>CFBundleDisplayName</key><string>${U}</string>
-  <key>CFBundleExecutable</key><string>sootsim-daemon</string>
-  <key>CFBundleIdentifier</key><string>${X}</string>
-  <key>CFBundleInfoDictionaryVersion</key><string>6.0</string>
-  <key>CFBundleName</key><string>${U}</string>
-  <key>CFBundlePackageType</key><string>APPL</string>
-  <key>CFBundleShortVersionString</key><string>${O}</string>
-  <key>CFBundleSignature</key><string>????</string>
-  <key>CFBundleVersion</key><string>${O}</string>
-  <key>LSBackgroundOnly</key><true/>
-  <key>LSUIElement</key><true/>
-  <key>LSMinimumSystemVersion</key><string>13.0</string>
-  <key>NSHumanReadableCopyright</key><string>Tamagui LLC</string>
-</dict>
-</plist>
-`}function z(t,e,r){let n=[t.executable,...t.prefixArgs,"serve","--quiet","--port",String(e)].map(J).join(" ");return`#!/bin/sh
-# SootSim Daemon launcher \u2014 auto-generated by 'sootsim setup'.
-# launchd spawns this; we exec the real sootsim invocation in place so
-# launchd tracks the daemon process, not the shell wrapper.
-#
-# stdout: ${r.stdout}
-# stderr: ${r.stderr}
-exec ${n}
-`}function J(t){return`'${t.replace(/'/g,"'\\''")}'`}var q=60,y="dev.sootsim.daemon",m="sootsim-daemon",g=f(D(),"Library/Logs/sootsim"),v=f(D(),".local/state/sootsim");async function Tt(t,e={}){let[r,...o]=t,n=e.port??7668;if(!r||r==="--help"||r==="-h"){V();return}new Set(["uninstall","restart","start","stop","logs"]).has(r)&&C({event:`daemon_${r}`,properties:{platform:process.platform,subsource:"daemon"}});try{switch(r){case"uninstall":return await ut();case"status":return await pt();case"restart":return await dt();case"start":return await mt();case"stop":return await gt();case"logs":return await ft(o);default:console.error(`  unknown daemon subcommand: ${r}`),V(),process.exit(1)}}finally{await _()}}function V(){R("daemon")}function rt(){let t=ot();return{executable:process.execPath,prefixArgs:[t]}}function ot(){try{let e=tt("which",["sootsim"],{encoding:"utf8"}).trim();if(e&&c(e))return H(e)}catch{}let t=process.argv[1];if(t&&c(t))return H(t);throw new Error("could not locate the sootsim binary")}function H(t){try{return Y("fs").realpathSync(t)}catch{return t}}function nt(t,e){x(g,{recursive:!0});let r=f(g,"bridge.out.log"),o=f(g,"bridge.err.log"),{launcherPath:n}=F(t,e,{stdout:r,stderr:o}),a=`    <string>${it(n)}</string>`;return`<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key><string>${y}</string>
-  <key>ProgramArguments</key>
-  <array>
-${a}
-  </array>
-  <key>RunAtLoad</key><true/>
-  <key>KeepAlive</key><true/>
-  <key>ThrottleInterval</key><integer>${q}</integer>
-  <key>ProcessType</key><string>Background</string>
-  <key>StandardOutPath</key><string>${r}</string>
-  <key>StandardErrorPath</key><string>${o}</string>
-</dict>
-</plist>
-`}function st(t,e){return x(v,{recursive:!0}),`[Unit]
-Description=sootsim bridge daemon
-After=default.target
-
-[Service]
-Type=simple
-ExecStart=${[t.executable,...t.prefixArgs].map(at).join(" ")} serve --quiet --port ${e}
-Restart=always
-RestartSec=${q}
-
-[Install]
-WantedBy=default.target
-`}function it(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function at(t){return/[^\w@%+=:,./-]/.test(t)?`'${t.replace(/'/g,"'\\''")}'`:t}function S(){return f(D(),"Library/LaunchAgents",`${y}.plist`)}function w(){return f(D(),".config/systemd/user",`${m}.service`)}function Nt(){if(E())return{supported:!1,installed:!1};if(process.platform==="darwin"){let t=S();return{supported:!0,installed:c(t),path:t}}if(process.platform==="linux"){let t=w();return{supported:!0,installed:c(t),path:t}}return{supported:!1,installed:!1}}async function Bt({port:t,force:e}){if(E())throw new Error("background daemon setup is unavailable in this environment");let r=rt();if(console.log(`  binary: ${[r.executable,...r.prefixArgs].join(" ")}`),console.log(`  port:   ${t}`),process.platform==="darwin"){let o=S();if(c(o)&&!e){console.log(`  already installed at ${o}`),console.log("  pass --force to overwrite, or use 'sootsim daemon restart' to reload");return}x(j(o),{recursive:!0}),M(o,nt(r,t)),console.log(`  wrote ${o}`);let n=`gui/${process.getuid()}`,a=`${n}/${y}`,l=()=>{let d=s("launchctl",["bootstrap",n,o],{stdio:"pipe",encoding:"utf8"}),k=(d.stderr||d.stdout||"").trim();if(d.status!==0)return{ok:!1,reason:`bootstrap exit ${d.status}${k?`: ${k}`:""}`};let I=s("launchctl",["print",a],{encoding:"utf8"});return I.status!==0?{ok:!1,reason:`bootstrap returned 0 but service not registered (print exit ${I.status})`}:{ok:!0}},u=l();if(!u.ok){let d=u.reason;if(s("launchctl",["bootout",a],{stdio:"ignore"}),u=l(),!u.ok)throw new Error(`launchctl bootstrap failed: ${u.reason}`+(d!==u.reason?` (initial: ${d})`:"")+" \u2014 try `sootsim daemon uninstall` then retry, or reboot if launchd state is stuck.")}let i=Date.now()+4e3,p,h;for(;Date.now()<i;){let d=s("launchctl",["print",a],{encoding:"utf8"});if(d.status===0&&(p=d.stdout?.match(/state\s*=\s*(\w+)/)?.[1],h=d.stdout?.match(/pid\s*=\s*(\d+)/)?.[1],p==="running"||h))break;await new Promise(k=>setTimeout(k,150))}if(p!=="running"&&!h)throw new Error(`daemon registered but did not reach running state within 4s (last state: ${p||"unknown"}). check ${f(g,"bridge.err.log")} \u2014 typically a stale runtime or a port already bound by another process.`);console.log(`  registered (state: ${p||"unknown"}${h?`, pid ${h}`:""}, log: ${f(g,"bridge.err.log")})`);return}if(process.platform==="linux"){let o=w();if(c(o)&&!e){console.log(`  already installed at ${o}`),console.log("  pass --force to overwrite, or use 'sootsim daemon restart' to reload");return}x(j(o),{recursive:!0}),M(o,st(r,t)),console.log(`  wrote ${o}`);let n=s("systemctl",["--user","daemon-reload"],{stdio:"pipe",encoding:"utf8"});if(n.status!==0){let i=(n.stderr||n.stdout||"").trim();throw new Error(`systemctl daemon-reload failed${i?`: ${i}`:""}`)}let a=s("systemctl",["--user","enable","--now",m],{stdio:"pipe",encoding:"utf8"});if(a.status!==0){let i=(a.stderr||a.stdout||"").trim();throw new Error(`systemctl enable --now failed${i?`: ${i}`:""} \u2014 try \`sootsim daemon uninstall\` then retry.`)}let u=(s("systemctl",["--user","is-active",m],{encoding:"utf8"}).stdout||"").trim()||"unknown";console.log(`  registered (state: ${u}, journalctl --user -u ${m} to tail logs)`);try{let i=process.env.USER||process.env.LOGNAME||"";if(i){let p=s("loginctl",["show-user",i,"--property=Linger","--value"],{encoding:"utf8"});!((p.stdout||"").trim().toLowerCase()==="yes")&&p.status===0&&console.log(`  note: linger is not enabled for "${i}". the daemon will exit at logout.
-  enable persistence with: sudo loginctl enable-linger ${i}`)}}catch{}return}console.error(`  background daemon is not supported on ${process.platform}`),console.error("  run 'sootsim serve' in a persistent shell instead"),process.exit(1)}function ct(){let t=[];if(process.platform==="darwin"){let e=S();c(e)&&(s("launchctl",["bootout",`gui/${process.getuid()}/${y}`],{stdio:"ignore"}),$(e,{force:!0}),t.push(e));let r=b();return c(r)&&($(r,{recursive:!0,force:!0}),t.push(r)),c(g)&&($(g,{recursive:!0,force:!0}),t.push(g)),{removed:t,missing:t.length===0}}if(process.platform==="linux"){let e=w();return c(e)&&(s("systemctl",["--user","disable","--now",m],{stdio:"ignore"}),$(e,{force:!0}),s("systemctl",["--user","daemon-reload"],{stdio:"ignore"}),s("systemctl",["--user","reset-failed",m],{stdio:"ignore"}),t.push(e)),c(v)&&($(v,{recursive:!0,force:!0}),t.push(v)),{removed:t,missing:t.length===0}}return{removed:t,missing:!0}}function lt(){let t=[],e=T();return c(e)&&($(e,{recursive:!0,force:!0}),t.push(e)),{removed:t,missing:t.length===0}}async function ut(){let t=ct();for(let r of t.removed)console.log(`  removed ${r}`);let e=lt();for(let r of e.removed)console.log(`  removed ${r}`);t.missing&&e.missing&&console.log("  not installed")}async function pt(){if(process.platform==="darwin"){let t=S();if(!c(t)){console.log("  installed: no");return}console.log(`  installed: yes  (${t})`);let e=yt(t);e&&console.log(`  binary:    ${e}`);let r=s("launchctl",["print",`gui/${process.getuid()}/${y}`],{encoding:"utf8"});if(r.status===0){let o=r.stdout.match(/state\s*=\s*(\w+)/)?.[1],n=r.stdout.match(/pid\s*=\s*(\d+)/)?.[1];console.log(`  state:     ${o||"unknown"}${n?` (pid ${n})`:""}`)}else console.log("  state:     not running");return}if(process.platform==="linux"){let t=w();if(!c(t)){console.log("  installed: no");return}console.log(`  installed: yes  (${t})`);let e=s("systemctl",["--user","is-active",m],{encoding:"utf8"});console.log(`  state:     ${e.stdout.trim()||"unknown"}`);return}console.error(`  unsupported platform: ${process.platform}`),process.exit(1)}async function dt(){if(process.platform==="darwin"){let t=S();c(t)||(console.error("  daemon not registered \u2014 run `sootsim setup`"),process.exit(1));let e=s("launchctl",["kickstart","-k",`gui/${process.getuid()}/${y}`],{stdio:"pipe",encoding:"utf8"});e.status!==0&&(console.error(`  kickstart failed: ${e.stderr?.trim()}`),process.exit(1)),console.log("  restarted");return}if(process.platform==="linux"){let t=w();c(t)||(console.error("  daemon not registered \u2014 run `sootsim setup`"),process.exit(1));let e=s("systemctl",["--user","restart",m],{stdio:"pipe",encoding:"utf8"});e.status!==0&&(console.error(`  restart failed: ${e.stderr?.trim()}`),process.exit(1)),console.log("  restarted");return}console.error(`  unsupported platform: ${process.platform}`),process.exit(1)}async function mt(){if(process.platform==="darwin"){s("launchctl",["kickstart",`gui/${process.getuid()}/${y}`],{stdio:"inherit"});return}if(process.platform==="linux"){s("systemctl",["--user","start",m],{stdio:"inherit"});return}console.error(`  unsupported platform: ${process.platform}`),process.exit(1)}async function gt(){if(process.platform==="darwin"){s("launchctl",["bootout",`gui/${process.getuid()}/${y}`],{stdio:"inherit"});return}if(process.platform==="linux"){s("systemctl",["--user","stop",m],{stdio:"inherit"});return}console.error(`  unsupported platform: ${process.platform}`),process.exit(1)}async function ft(t){let e=t.find(n=>/^-n\d+$|^--lines=\d+$|^\d+$/.test(n)),r=e?Number(e.replace(/\D/g,"")):200,o=t.includes("-f")||t.includes("--follow");if(process.platform==="darwin"){let n=f(g,"bridge.out.log"),a=f(g,"bridge.err.log"),l=[n,a].filter(i=>c(i));l.length===0&&(console.error(`  no daemon logs yet at ${g} \u2014 run \`sootsim setup\` to install the daemon`),process.exit(1));let u=o?["-n",String(r),"-F",...l]:["-n",String(r),...l];s("tail",u,{stdio:"inherit"});return}if(process.platform==="linux"){let n=`${m}.service`,a=["--user","-u",n,"-n",String(r),"--no-pager"],l=s("journalctl",o?[...a,"-f"]:a,{encoding:"utf8",stdio:o?"inherit":"pipe"});if(o)return;let u=`${l.stdout||""}${l.stderr||""}`,i=/insufficient permissions|No journal files were opened/i.test(u);if(l.status===0&&!i){process.stdout.write(l.stdout||"");return}let p=s("journalctl",[`_SYSTEMD_USER_UNIT=${n}`,"-n",String(r),"--no-pager"],{encoding:"utf8"});if(p.status===0&&(p.stdout||"").trim()){process.stdout.write(p.stdout);return}console.error(`  could not read --user journal for ${n} (this user isn't in the systemd-journal group yet).
-  run:  sudo journalctl _SYSTEMD_USER_UNIT=${n} -n ${r} --no-pager`),process.exit(1)}console.error(`  unsupported platform: ${process.platform}`),process.exit(1)}function yt(t){try{return et(t,"utf8").match(/<array>\s*<string>([^<]+)<\/string>/)?.[1]||null}catch{return null}}export{Tt as a,Nt as b,Bt as c,ct as d,lt as e};