sootsim 0.1.194 → 0.1.196

package/dist-cli/chunks/{what-happened-YY6QNNFX.js → what-happened-J6XI43BG.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.194 | (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-RM4Q4CME.js";import{g as A,i as _}from"./chunk-HSC4YJX7.js";import"./chunk-YFT6QNH3.js";import{b as k}from"./chunk-7CNBR64U.js";import"./chunk-QWZBLVT4.js";import"./chunk-HU4ZXOLS.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.196 | (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-6B5ZSUG4.js";import{g as A,i as _}from"./chunk-4FPIEYJQ.js";import"./chunk-DBFIJJQS.js";import{b as k}from"./chunk-U5K2QCYY.js";import"./chunk-DKELBKSC.js";import"./chunk-DSK5O7XJ.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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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;
@@ -1302,6 +1302,8 @@ function formatTimelinePayload(kind, d) {
       return `${d.phase ?? "?"}${d.heightPx ? ` h=${d.heightPx}` : ""}${d.mode ? ` ${d.mode}` : ""}`;
     case "screen":
       return `${d.phase ?? "?"} ${d.name ?? d.activeName ?? ""}`;
+    case "flow-step":
+      return `${d.status ?? "?"} ${d.stepName ?? "step"}${d.durationMs ? ` ${d.durationMs}ms` : ""}`;
     case "route":
       return `${d.phase ?? "?"} ${d.path ?? d.pathname ?? ""}`;
     case "alert":

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {
@@ -1212,6 +1212,8 @@ function formatTimelinePayload(kind, d) {
       return `${d.phase ?? "?"}${d.heightPx ? ` h=${d.heightPx}` : ""}${d.mode ? ` ${d.mode}` : ""}`;
     case "screen":
       return `${d.phase ?? "?"} ${d.name ?? d.activeName ?? ""}`;
+    case "flow-step":
+      return `${d.status ?? "?"} ${d.stepName ?? "step"}${d.durationMs ? ` ${d.durationMs}ms` : ""}`;
     case "route":
       return `${d.phase ?? "?"} ${d.path ?? d.pathname ?? ""}`;
     case "alert":

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.194 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.196 | (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;
@@ -16940,6 +16940,8 @@ var init_bridge_flow_runner = __esm({
       recordingStartedAtMs = null;
       lastRecordingStartedAtMs = null;
       lastRecordingDurationMs = null;
+      lastRecordingFrameStats = null;
+      flowTraceSteps = [];
       lastVisualSettledAtMs = 0;
       simRouteHint = null;
       // set by runStep when a step throws — lets the outer flow command
@@ -17075,10 +17077,12 @@ var init_bridge_flow_runner = __esm({
           throw new Error("recording output directory not configured");
         }
         if (!this.recordingAccessChecked) {
-          await ensureCliRecordingEntitlement("flow --video", {
-            originOverride: this.opts.billingOriginOverride,
-            allowGitHubAuth: this.opts.allowGitHubRecording
-          });
+          if (this.opts.requireRecordingEntitlement) {
+            await ensureCliRecordingEntitlement("flow --video", {
+              originOverride: this.opts.billingOriginOverride,
+              allowGitHubAuth: this.opts.allowGitHubRecording
+            });
+          }
           this.recordingAccessChecked = true;
         }
         const startedAt = Date.now();
@@ -17093,7 +17097,7 @@ var init_bridge_flow_runner = __esm({
           throw new Error(result?.error || "recording unavailable on this page");
         }
         if (!this.recordingStartedAtMs) {
-          this.recordingStartedAtMs = startedAt;
+          this.recordingStartedAtMs = typeof result.startedAtMs === "number" && Number.isFinite(result.startedAtMs) ? result.startedAtMs : startedAt;
         }
       }
       async startRecording() {
@@ -17109,6 +17113,45 @@ var init_bridge_flow_runner = __esm({
       getLastRecordingStartedAtMs() {
         return this.lastRecordingStartedAtMs;
       }
+      getLastRecordingFrameStats() {
+        return this.lastRecordingFrameStats;
+      }
+      getFlowTraceSteps() {
+        return [...this.flowTraceSteps];
+      }
+      flowStepTargetLabel(step, stepName) {
+        if (stepName === "inputText" || stepName === "runScript" || stepName === "evalScript") {
+          return void 0;
+        }
+        const value = step[stepName];
+        if (typeof value === "string") return value.slice(0, 80);
+        if (typeof value === "number" || typeof value === "boolean") return String(value);
+        if (!value || typeof value !== "object") return void 0;
+        const record = value;
+        const direct = record.id ?? record.text ?? record.name ?? record.path;
+        if (typeof direct === "string" && direct) return direct.slice(0, 80);
+        if (record.point && typeof record.point === "string") return record.point.slice(0, 80);
+        if (typeof record.x === "number" && typeof record.y === "number") {
+          return `${Math.round(record.x)}, ${Math.round(record.y)}`;
+        }
+        return void 0;
+      }
+      recordFlowTraceStep(args) {
+        const endedAtMs = Date.now();
+        const entry = {
+          stepIndex: args.stepIndex,
+          stepName: args.stepName,
+          ...args.targetLabel ? { targetLabel: args.targetLabel } : {},
+          startedAtMs: args.startedAtMs,
+          endedAtMs,
+          durationMs: Math.max(0, endedAtMs - args.startedAtMs),
+          status: args.status
+        };
+        if (args.error != null) {
+          entry.error = args.error instanceof Error ? args.error.message : String(args.error);
+        }
+        this.flowTraceSteps.push(entry);
+      }
       async stopRecording() {
         if (!this.recordingEnabled || !this.opts.recordingOutputDir) return null;
         this.recordingEnabled = false;
@@ -17116,10 +17159,12 @@ var init_bridge_flow_runner = __esm({
         const stopped = await this.evaluate(`window.__sootsimRecorder.stop()`);
         if (!stopped?.ok) {
           this.recordingStartedAtMs = null;
+          this.lastRecordingFrameStats = null;
           throw new Error(stopped?.error || "recording stop failed");
         }
         this.lastRecordingStartedAtMs = this.recordingStartedAtMs;
         this.lastRecordingDurationMs = this.recordingStartedAtMs ? Math.max(1, stoppedAt - this.recordingStartedAtMs) : null;
+        this.lastRecordingFrameStats = stopped.frameStats ?? null;
         this.recordingStartedAtMs = null;
         const chunks = [];
         let offset = 0;
@@ -18036,10 +18081,18 @@ var init_bridge_flow_runner = __esm({
         if (!this.firstLaunchDone && !wantsClear) {
           this.firstLaunchDone = true;
           if (wantsResetRuntime) {
-            if (this.recordingEnabled) await this.ensureRecordingStarted();
+            const startingShellState = await getShellState(this.bridge).catch(() => null);
+            const shouldReturnHome = startingShellState?.state === "home" && startingShellState.activeApp == null;
             await this.softReloadGuestApp(false);
-            await this.launchShellAppFromHomeIfNeeded(opts);
             await this.waitForTree(12e4);
+            if (shouldReturnHome) {
+              await callShellCommandWhenReady(this.bridge, "goHome", 1e3);
+              await this.waitForShellHome(1e3);
+            }
+            await this.launchShellAppFromHomeIfNeeded(
+              opts,
+              shouldReturnHome ? { ...startingShellState ?? {}, state: "home", activeApp: null } : null
+            );
           } else {
             await this.launchShellAppFromHomeIfNeeded(opts);
           }
@@ -18112,12 +18165,26 @@ var init_bridge_flow_runner = __esm({
           await sleep2(16);
         }
       }
-      async launchShellAppFromHomeIfNeeded(opts) {
+      async waitForShellHome(timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+          const state = await getShellState(this.bridge).catch(() => null);
+          if (state?.state === "home" && state.activeApp == null && state.showSwitcher === false) {
+            return;
+          }
+          await sleep2(16);
+        }
+      }
+      async launchShellAppFromHomeIfNeeded(opts, knownHomeState) {
         let state = null;
-        try {
-          state = await getShellState(this.bridge);
-        } catch {
-          return false;
+        if (knownHomeState) {
+          state = knownHomeState;
+        } else {
+          try {
+            state = await getShellState(this.bridge);
+          } catch {
+            return false;
+          }
         }
         if (state?.state !== "home" || state.activeApp != null) return false;
         const appId = this.resolveShellLaunchAppId(opts, state);
@@ -18264,14 +18331,25 @@ var init_bridge_flow_runner = __esm({
         const rawStep = typeof rawStepInput === "string" ? normalizeBareStringStep(rawStepInput) : rawStepInput;
         const stepName = Object.keys(rawStep).find((k) => k !== "when") || Object.keys(rawStep)[0];
         console.log(`[flow] step ${stepIndex + 1}: ${stepName}`);
+        const startedAtMs = Date.now();
+        let targetLabel = this.flowStepTargetLabel(rawStep, stepName);
         let step;
         try {
           step = this.js.interpolateStep(rawStep);
+          targetLabel = this.flowStepTargetLabel(step, stepName) ?? targetLabel;
         } catch (error) {
           if (this.isOptional(rawStep)) {
             console.log(
               `[flow]   (optional, skipped: ${error.message.slice(0, 80)})`
             );
+            this.recordFlowTraceStep({
+              stepIndex,
+              stepName,
+              targetLabel,
+              startedAtMs,
+              status: "skipped",
+              error
+            });
             return;
           }
           this.lastFailedStep = {
@@ -18279,12 +18357,27 @@ var init_bridge_flow_runner = __esm({
             kind: stepName,
             target: rawStep[stepName]
           };
+          this.recordFlowTraceStep({
+            stepIndex,
+            stepName,
+            targetLabel,
+            startedAtMs,
+            status: "failure",
+            error
+          });
           throw error;
         }
         if (step.when) {
           const shouldRun = await this.evaluateWhen(step.when);
           if (!shouldRun) {
             console.log(`[flow]   (when: predicate false, skipped)`);
+            this.recordFlowTraceStep({
+              stepIndex,
+              stepName,
+              targetLabel,
+              startedAtMs,
+              status: "skipped"
+            });
             return;
           }
         }
@@ -18317,11 +18410,26 @@ var init_bridge_flow_runner = __esm({
           if (this.stepDelay > 0 && !isAssertion) {
             await sleep2(this.stepDelay);
           }
+          this.recordFlowTraceStep({
+            stepIndex,
+            stepName,
+            targetLabel,
+            startedAtMs,
+            status: "success"
+          });
         } catch (error) {
           if (this.isOptional(step)) {
             console.log(
               `[flow]   (optional, skipped: ${error.message.slice(0, 80)})`
             );
+            this.recordFlowTraceStep({
+              stepIndex,
+              stepName,
+              targetLabel,
+              startedAtMs,
+              status: "skipped",
+              error
+            });
             return;
           }
           this.lastFailedStep = {
@@ -18329,6 +18437,14 @@ var init_bridge_flow_runner = __esm({
             kind: stepName,
             target: step[stepName]
           };
+          this.recordFlowTraceStep({
+            stepIndex,
+            stepName,
+            targetLabel,
+            startedAtMs,
+            status: "failure",
+            error
+          });
           throw error;
         }
       }

package/dist-lib/vite.cjs

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

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

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

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

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

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

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