sootsim 0.1.156 → 0.1.158

package/dist-cli/chunks/{what-happened-RSHNHEZ3.js → what-happened-FNVFO74N.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{C as T,D as A,E as y,P as _,Q as b,R as S}from"./chunk-IDXOP3UM.js";import{c as N,e as F}from"./chunk-5JOGV2HQ.js";import{b as k}from"./chunk-MAZZU3SS.js";import"./chunk-XNK3USYL.js";import"./chunk-734YKCKK.js";import"./chunk-CGRV5ZGV.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=N(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.158 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{C as T,D as A,E as y,P as _,Q as b,R as S}from"./chunk-YPYRIHXA.js";import{c as N,e as F}from"./chunk-ZOEZZOX3.js";import{b as k}from"./chunk-MT3LPZSZ.js";import"./chunk-BHNAFAWK.js";import"./chunk-VVYV3B3C.js";import"./chunk-2GIVPUQI.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=N(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-LPQ5MGZQ.js → whoami-HL56TMFI.js}

@@ -1,2 +1,2 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{d as i}from"./chunk-OQ4PEGZM.js";import{d as n}from"./chunk-JT47D7AS.js";import"./chunk-734YKCKK.js";import"./chunk-CGRV5ZGV.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.158 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{d as i}from"./chunk-CSPX2YGP.js";import{d as n}from"./chunk-76VYCT6G.js";import"./chunk-VVYV3B3C.js";import"./chunk-2GIVPUQI.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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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/menu.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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;
@@ -328,7 +328,8 @@ function buildSootSimDeviceChoiceDefs(currentDevice, deviceChoices, options) {
   let lastPlatform = "";
   const isStateful = options.action === "switch-device";
   for (const choice of deviceChoices) {
-    if (lastPlatform && choice.platform !== lastPlatform) items.push({ type: "separator" });
+    if (lastPlatform && choice.platform !== lastPlatform)
+      items.push({ type: "separator" });
     lastPlatform = choice.platform;
     if (isStateful) {
       items.push({

package/dist-lib/menu.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/menu.ts
 var SOOTSIM_ENGINE_EVENT_NAME = "sootsim:engine-event";
@@ -295,7 +295,8 @@ function buildSootSimDeviceChoiceDefs(currentDevice, deviceChoices, options) {
   let lastPlatform = "";
   const isStateful = options.action === "switch-device";
   for (const choice of deviceChoices) {
-    if (lastPlatform && choice.platform !== lastPlatform) items.push({ type: "separator" });
+    if (lastPlatform && choice.platform !== lastPlatform)
+      items.push({ type: "separator" });
     lastPlatform = choice.platform;
     if (isStateful) {
       items.push({

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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;
@@ -1363,21 +1363,46 @@ async function waitForSootsimIdle({
         return { layout: nodes.join(';'), animating, pendingFetches, requestTotal, requestInFlight }
       }
 
+      // how long generic background network is allowed to keep us waiting AFTER
+      // the screen is otherwise visually settled. apps with continuous traffic
+      // (polling, realtime sockets, a tap that fires 20-50 fetches) never reach
+      // requestInFlight===0 / a stable requestTotal, so requiring full network
+      // quiet burns the ENTIRE budget on every command \u2014 the leading idle that
+      // failed PR-preview recordings for network-heavy apps (3pc fight-pulse).
+      // layout-stability + the image-loader already prove visible content
+      // loaded (a data load changes layout; an image load shows in the loader),
+      // so the generic request counters are a courtesy, not a gate: honor them
+      // only within this grace once the screen is visually still.
+      const networkQuietGraceMs = 1200
       let lastLayout = ''
       let lastRequestTotal = -1
       let stable = 0
+      let visuallyStillSince = 0
       while (Date.now() < deadline) {
         const snapshot = await readSnapshot()
         const strictOk = !strict || !snapshot.animating
-        const contentReady = snapshot.pendingFetches === 0 && snapshot.requestInFlight === 0
-        const requestsStable = snapshot.requestTotal === lastRequestTotal
-        if (strictOk && contentReady && requestsStable && snapshot.layout === lastLayout) {
+        // visually settled: no animations, no image content loading, layout
+        // unchanged since the last poll.
+        const visuallyStill =
+          strictOk && snapshot.pendingFetches === 0 && snapshot.layout === lastLayout
+        // generic network quiet: nothing in flight and no new requests issued.
+        const networkQuiet =
+          snapshot.requestInFlight === 0 && snapshot.requestTotal === lastRequestTotal
+        if (visuallyStill) {
           stable++
-          if (stable >= requiredStablePolls) {
+          if (visuallyStillSince === 0) visuallyStillSince = Date.now()
+          // settle once the screen has held still long enough AND either the
+          // network is genuinely quiet OR it has refused to quiet within the
+          // grace (continuous background traffic must not block forever).
+          if (
+            stable >= requiredStablePolls &&
+            (networkQuiet || Date.now() - visuallyStillSince >= networkQuietGraceMs)
+          ) {
             return { settled: true, elapsed: Date.now() - start }
           }
         } else {
           stable = 0
+          visuallyStillSince = 0
         }
         lastLayout = snapshot.layout
         lastRequestTotal = snapshot.requestTotal

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {
@@ -1274,21 +1274,46 @@ async function waitForSootsimIdle({
         return { layout: nodes.join(';'), animating, pendingFetches, requestTotal, requestInFlight }
       }
 
+      // how long generic background network is allowed to keep us waiting AFTER
+      // the screen is otherwise visually settled. apps with continuous traffic
+      // (polling, realtime sockets, a tap that fires 20-50 fetches) never reach
+      // requestInFlight===0 / a stable requestTotal, so requiring full network
+      // quiet burns the ENTIRE budget on every command \u2014 the leading idle that
+      // failed PR-preview recordings for network-heavy apps (3pc fight-pulse).
+      // layout-stability + the image-loader already prove visible content
+      // loaded (a data load changes layout; an image load shows in the loader),
+      // so the generic request counters are a courtesy, not a gate: honor them
+      // only within this grace once the screen is visually still.
+      const networkQuietGraceMs = 1200
       let lastLayout = ''
       let lastRequestTotal = -1
       let stable = 0
+      let visuallyStillSince = 0
       while (Date.now() < deadline) {
         const snapshot = await readSnapshot()
         const strictOk = !strict || !snapshot.animating
-        const contentReady = snapshot.pendingFetches === 0 && snapshot.requestInFlight === 0
-        const requestsStable = snapshot.requestTotal === lastRequestTotal
-        if (strictOk && contentReady && requestsStable && snapshot.layout === lastLayout) {
+        // visually settled: no animations, no image content loading, layout
+        // unchanged since the last poll.
+        const visuallyStill =
+          strictOk && snapshot.pendingFetches === 0 && snapshot.layout === lastLayout
+        // generic network quiet: nothing in flight and no new requests issued.
+        const networkQuiet =
+          snapshot.requestInFlight === 0 && snapshot.requestTotal === lastRequestTotal
+        if (visuallyStill) {
           stable++
-          if (stable >= requiredStablePolls) {
+          if (visuallyStillSince === 0) visuallyStillSince = Date.now()
+          // settle once the screen has held still long enough AND either the
+          // network is genuinely quiet OR it has refused to quiet within the
+          // grace (continuous background traffic must not block forever).
+          if (
+            stable >= requiredStablePolls &&
+            (networkQuiet || Date.now() - visuallyStillSince >= networkQuietGraceMs)
+          ) {
             return { settled: true, elapsed: Date.now() - start }
           }
         } else {
           stable = 0
+          visuallyStillSince = 0
         }
         lastLayout = snapshot.layout
         lastRequestTotal = snapshot.requestTotal

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.158 | (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;
@@ -359,10 +359,9 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=0.17.0",
-            coverage: 0.95,
-            note: "functional splash screen lifecycle with sootsim canvas integration. hide()/hideAsync() pair, preventAutoHideAsync, setOptions (fade/duration accepted), and the sootsim internal _notifyCanvasReady / _createHideSignal / _isAutoHidePrevented bridges. Splash actually hides + restores correctly across reloads. SplashScreenOptions type exported so consumer typing matches upstream.",
-            working: "preventAutoHideAsync, hideAsync, hide (sync alias), setOptions (fade/duration), _notifyCanvasReady, _createHideSignal, _isAutoHidePrevented, SplashScreenOptions interface, default-export bundle including hide",
-            missing: "native fade/animation on hide (sootsim hides instantly \u2014 visual difference vs iOS native fade), backgroundColor / image options not yet rendered in the canvas splash"
+            coverage: 1,
+            note: "full splash wired to the sootsim canvas boot splash, including the app's REAL configured artwork. the config plugin's image + backgroundColor (+ imageWidth, resizeMode, dark variant) and the legacy expo.splash / expo.ios.splash blocks are parsed and painted on boot exactly like the native splash window. setOptions({fade,duration}) is honored: hideAsync()/hide() cross-dissolve the splash over the configured duration (default 400ms, fade default off \u2014 mirroring ios/SplashScreenManager.swift hide()); preventAutoHideAsync holds the splash until the app hides it. matches upstream index.native.ts semantics.",
+            working: "preventAutoHideAsync (holds splash), hideAsync, hide (sync), setOptions (fade + duration drive the real canvas fade), configured splash image + backgroundColor + imageWidth + resizeMode + dark variant painted on boot (config plugin + legacy expo.splash), SplashScreenOptions type"
           }
         ]
       },
@@ -830,12 +829,14 @@ var init_registry = __esm({
       },
       "react-native-bootsplash": {
         category: "Device & Platform",
-        stubType: "works",
+        stubType: "native",
         versions: [
           {
             range: ">=4.0.0",
             coverage: 1,
-            note: "pure-JS turbo module; getConstants/hide/isVisible run without a stub needed"
+            note: "real package JS (index.ts hide/isVisible + the pure-JS useHideAnimation hook) runs unmodified from the bundle against the RNBootSplash native seam. the app's configured logo + background (+ logoWidth, dark variant) from the bootsplash config plugin are parsed and painted on the canvas boot splash. hide(fade) drives it: cross-dissolve over a fixed 250ms when fade is set, snap otherwise (mirrors ios/RNBootSplash.mm). isVisible() reflects real splash state; getConstants() returns { darkModeEnabled } exactly as the iOS constantsToExport (logoSizeRatio/navigationBarHeight/statusBarHeight are android-only, defaulted in the hook).",
+            working: "configured logo + background + logoWidth + dark variant painted on boot, hide(fade) (real canvas fade/snap), isVisible() (true while splash visible), getConstants() (darkModeEnabled), useHideAnimation hook (logo/brand layout from manifest, runs from bundle)",
+            missing: "the optional brand/darkBrand image (a secondary bottom-anchored logo) is not painted \u2014 only the primary logo + background"
           }
         ]
       },
@@ -2303,8 +2304,8 @@ var init_registry = __esm({
           {
             range: ">=3.0.0",
             coverage: 1,
-            note: "noop show/hide \u2014 correct, no splash screen concept in browser",
-            working: "show, hide"
+            note: "package JS is just `export default NativeModules.SplashScreen`; the real package runs from the bundle against the SplashScreen native seam. hide() snap-hides the sootsim canvas boot splash (mirrors ios/RNSplashScreen.m removeFromSuperview, no fade); show() returns immediately without re-showing, exactly as the booted-app native path where `waiting` is already false.",
+            working: "hide() (snap-hides the canvas splash), show() (no-op in a booted app, faithful)"
           }
         ]
       },
@@ -15699,21 +15700,46 @@ async function waitForSootsimIdle({
         return { layout: nodes.join(';'), animating, pendingFetches, requestTotal, requestInFlight }
       }
 
+      // how long generic background network is allowed to keep us waiting AFTER
+      // the screen is otherwise visually settled. apps with continuous traffic
+      // (polling, realtime sockets, a tap that fires 20-50 fetches) never reach
+      // requestInFlight===0 / a stable requestTotal, so requiring full network
+      // quiet burns the ENTIRE budget on every command \u2014 the leading idle that
+      // failed PR-preview recordings for network-heavy apps (3pc fight-pulse).
+      // layout-stability + the image-loader already prove visible content
+      // loaded (a data load changes layout; an image load shows in the loader),
+      // so the generic request counters are a courtesy, not a gate: honor them
+      // only within this grace once the screen is visually still.
+      const networkQuietGraceMs = 1200
       let lastLayout = ''
       let lastRequestTotal = -1
       let stable = 0
+      let visuallyStillSince = 0
       while (Date.now() < deadline) {
         const snapshot = await readSnapshot()
         const strictOk = !strict || !snapshot.animating
-        const contentReady = snapshot.pendingFetches === 0 && snapshot.requestInFlight === 0
-        const requestsStable = snapshot.requestTotal === lastRequestTotal
-        if (strictOk && contentReady && requestsStable && snapshot.layout === lastLayout) {
+        // visually settled: no animations, no image content loading, layout
+        // unchanged since the last poll.
+        const visuallyStill =
+          strictOk && snapshot.pendingFetches === 0 && snapshot.layout === lastLayout
+        // generic network quiet: nothing in flight and no new requests issued.
+        const networkQuiet =
+          snapshot.requestInFlight === 0 && snapshot.requestTotal === lastRequestTotal
+        if (visuallyStill) {
           stable++
-          if (stable >= requiredStablePolls) {
+          if (visuallyStillSince === 0) visuallyStillSince = Date.now()
+          // settle once the screen has held still long enough AND either the
+          // network is genuinely quiet OR it has refused to quiet within the
+          // grace (continuous background traffic must not block forever).
+          if (
+            stable >= requiredStablePolls &&
+            (networkQuiet || Date.now() - visuallyStillSince >= networkQuietGraceMs)
+          ) {
             return { settled: true, elapsed: Date.now() - start }
           }
         } else {
           stable = 0
+          visuallyStillSince = 0
         }
         lastLayout = snapshot.layout
         lastRequestTotal = snapshot.requestTotal
@@ -16147,6 +16173,17 @@ var init_app_fonts = __esm({
   }
 });
 
+// cli/app-splash.ts
+var import_node_module2, import_config_plugin_splash, require3;
+var init_app_splash = __esm({
+  "cli/app-splash.ts"() {
+    "use strict";
+    import_node_module2 = require("node:module");
+    import_config_plugin_splash = require("sootsim-engine/engine/config-plugin-splash");
+    require3 = (0, import_node_module2.createRequire)(__sootsim_import_meta_url);
+  }
+});
+
 // cli/open-url.ts
 var init_open_url2 = __esm({
   "cli/open-url.ts"() {
@@ -16189,6 +16226,7 @@ var init_upload = __esm({
     import_presigned_upload = require("sootsim-engine/preview/presigned-upload");
     init_shared_session();
     init_app_fonts();
+    init_app_splash();
     init_auth();
     init_open_url2();
     init_telemetry();

package/dist-lib/vite.cjs

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

package/src/menu.ts

@@ -388,7 +388,8 @@ export function buildSootSimDeviceChoiceDefs(
   const isStateful = options.action === 'switch-device'
 
   for (const choice of deviceChoices) {
-    if (lastPlatform && choice.platform !== lastPlatform) items.push({ type: 'separator' })
+    if (lastPlatform && choice.platform !== lastPlatform)
+      items.push({ type: 'separator' })
     lastPlatform = choice.platform
 
     if (isStateful) {

package/dist-cli/chunks/auto-bootstrap-DAU4P4W3.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d}from"./chunk-DSPYCLAV.js";import"./chunk-5JOGV2HQ.js";import"./chunk-MAZZU3SS.js";import"./chunk-XNK3USYL.js";import"./chunk-734YKCKK.js";import"./chunk-CGRV5ZGV.js";export{c as ensureDaemonRunning,a as ensureRuntimeInstalled,d as ensureSootsimReady,b as resolveBootstrapPort};

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

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

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

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

package/dist-cli/chunks/chunk-B6A7ZJMT.js

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

package/dist-cli/chunks/chunk-CAHWX2CJ.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.156 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-var t="http://localhost:5173/";export{t as a};