sootsim 0.1.201 → 0.1.202

package/dist-cli/chunks/{what-happened-VW274SXG.js → what-happened-L6EEB6MB.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.201 | (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-ZSWQLDDQ.js";import{g as A,i as _}from"./chunk-HIWE4YYN.js";import"./chunk-AHJ2WJST.js";import{b as k}from"./chunk-CHVGDYQJ.js";import"./chunk-ORIISY22.js";import"./chunk-NIDV74L2.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.202 | (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-ROYBEBG2.js";import{g as A,i as _}from"./chunk-KRGHRSKY.js";import"./chunk-PL4GXELT.js";import{b as k}from"./chunk-RZQO4Q7E.js";import"./chunk-GZKT53SA.js";import"./chunk-4KT2BGQE.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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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;
@@ -44,6 +44,7 @@ __export(home_paths_exports, {
   claimDaemonLockfile: () => claimDaemonLockfile,
   compareSemver: () => compareSemver,
   configFilePath: () => configFilePath,
+  consumeRuntimeUpgradeNotice: () => consumeRuntimeUpgradeNotice,
   daemonAppBundlePath: () => daemonAppBundlePath,
   daemonAppDir: () => daemonAppDir,
   daemonAppLauncherPath: () => daemonAppLauncherPath,
@@ -68,12 +69,14 @@ __export(home_paths_exports, {
   removeDaemonLockfile: () => removeDaemonLockfile,
   removeDevBridgeLockfile: () => removeDevBridgeLockfile,
   runtimeDir: () => runtimeDir,
+  runtimeUpgradeNoticePath: () => runtimeUpgradeNoticePath,
   runtimesDir: () => runtimesDir,
   shouldSkipPersistentDaemon: () => shouldSkipPersistentDaemon,
   sootsimHomeDir: () => sootsimHomeDir,
   writeActiveRuntime: () => writeActiveRuntime,
   writeDaemonLockfile: () => writeDaemonLockfile,
   writeDevBridgeLockfile: () => writeDevBridgeLockfile,
+  writeRuntimeUpgradeNotice: () => writeRuntimeUpgradeNotice,
   writeSharedConfig: () => writeSharedConfig,
   writeTelemetryEnabled: () => writeTelemetryEnabled
 });
@@ -194,6 +197,31 @@ function readOrCreateAnonymousId() {
 function writeTelemetryEnabled(enabled) {
   writeSharedConfig({ telemetry: enabled });
 }
+function runtimeUpgradeNoticePath() {
+  return import_node_path.default.join(sootsimHomeDir(), "runtime-upgraded.json");
+}
+function writeRuntimeUpgradeNotice(notice) {
+  ensureSootsimHome();
+  const tmp = `${runtimeUpgradeNoticePath()}.tmp`;
+  import_node_fs.default.writeFileSync(tmp, `${JSON.stringify(notice)}
+`, "utf8");
+  import_node_fs.default.renameSync(tmp, runtimeUpgradeNoticePath());
+}
+function consumeRuntimeUpgradeNotice() {
+  try {
+    const raw = import_node_fs.default.readFileSync(runtimeUpgradeNoticePath(), "utf8");
+    import_node_fs.default.unlinkSync(runtimeUpgradeNoticePath());
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.to !== "string" || !parsed.to) return null;
+    return {
+      from: typeof parsed.from === "string" ? parsed.from : null,
+      to: parsed.to,
+      at: typeof parsed.at === "number" ? parsed.at : 0
+    };
+  } catch {
+    return null;
+  }
+}
 function ensureSootsimHome() {
   import_node_fs.default.mkdirSync(sootsimHomeDir(), { recursive: true });
   import_node_fs.default.mkdirSync(runtimesDir(), { recursive: true });
@@ -360,6 +388,7 @@ function removeDevBridgeLockfile() {
   claimDaemonLockfile,
   compareSemver,
   configFilePath,
+  consumeRuntimeUpgradeNotice,
   daemonAppBundlePath,
   daemonAppDir,
   daemonAppLauncherPath,
@@ -384,12 +413,14 @@ function removeDevBridgeLockfile() {
   removeDaemonLockfile,
   removeDevBridgeLockfile,
   runtimeDir,
+  runtimeUpgradeNoticePath,
   runtimesDir,
   shouldSkipPersistentDaemon,
   sootsimHomeDir,
   writeActiveRuntime,
   writeDaemonLockfile,
   writeDevBridgeLockfile,
+  writeRuntimeUpgradeNotice,
   writeSharedConfig,
   writeTelemetryEnabled
 });

package/dist-lib/host/bridge-host.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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;
@@ -662,6 +662,16 @@ function writeSharedConfig(patch) {
   import_node_fs2.default.renameSync(tmp, configFilePath());
   return next;
 }
+function runtimeUpgradeNoticePath() {
+  return import_node_path.default.join(sootsimHomeDir(), "runtime-upgraded.json");
+}
+function writeRuntimeUpgradeNotice(notice) {
+  ensureSootsimHome();
+  const tmp = `${runtimeUpgradeNoticePath()}.tmp`;
+  import_node_fs2.default.writeFileSync(tmp, `${JSON.stringify(notice)}
+`, "utf8");
+  import_node_fs2.default.renameSync(tmp, runtimeUpgradeNoticePath());
+}
 function ensureSootsimHome() {
   import_node_fs2.default.mkdirSync(sootsimHomeDir(), { recursive: true });
   import_node_fs2.default.mkdirSync(runtimesDir(), { recursive: true });
@@ -825,6 +835,7 @@ var import_promises = require("stream/promises");
 var DEFAULT_RUNTIME_CDN_ORIGIN = "https://sootbean.com";
 var RUNTIME_CDN_ORIGIN_ENV = "SOOTSIM_CDN_ORIGIN";
 var RUNTIME_CHANNEL_ENV = "SOOTSIM_RUNTIME_CHANNEL";
+var RUNTIME_PIN_ENV = "SOOTSIM_RUNTIME_VERSION";
 function readConfig() {
   try {
     const parsed = JSON.parse(import_fs2.default.readFileSync(configFilePath(), "utf8"));
@@ -842,6 +853,12 @@ function resolveRuntimeChannel(input) {
   const config = readConfig();
   return input || process.env[RUNTIME_CHANNEL_ENV] || config.runtimeChannel || "stable";
 }
+function resolveRuntimePin() {
+  const env = process.env[RUNTIME_PIN_ENV];
+  if (env && env.trim()) return env.trim();
+  const config = readConfig();
+  return typeof config.runtimeVersion === "string" && config.runtimeVersion.trim() ? config.runtimeVersion.trim() : null;
+}
 function runtimeManifestUrl(cdnOrigin) {
   const url = new URL(`${resolveRuntimeCdnOrigin(cdnOrigin)}/runtimes/manifest.json`);
   url.searchParams.set("t", String(Date.now()));
@@ -860,7 +877,7 @@ async function fetchRuntimeManifest(cdnOrigin) {
 }
 function resolveRuntimeVersion(manifest, opts = {}) {
   const channel = resolveRuntimeChannel(opts.channel);
-  const version = opts.version || manifest.channels[channel]?.latest;
+  const version = opts.version || resolveRuntimePin() || manifest.channels[channel]?.latest;
   if (!version) {
     throw new Error(
       `no version specified and channel '${channel}' has no latest entry in the manifest`
@@ -936,6 +953,29 @@ async function updateRuntimeToLatest(opts = {}) {
   ensureSootsimHome();
   const cdnOrigin = resolveRuntimeCdnOrigin(opts.cdnOrigin);
   const channel = resolveRuntimeChannel(opts.channel);
+  const pin = resolveRuntimePin();
+  if (pin) {
+    const activeVersion2 = readActiveRuntime();
+    const pinInstalled = import_fs2.default.existsSync(import_path2.default.join(runtimeDir(pin), "index.html"));
+    if (activeVersion2 === pin && pinInstalled) {
+      return {
+        checked: true,
+        updated: false,
+        reason: `runtime is pinned to ${pin}`,
+        activeVersion: activeVersion2,
+        latestVersion: pin
+      };
+    }
+    const install2 = await installRuntime({ version: pin, channel, cdnOrigin, setActive: false });
+    return {
+      checked: true,
+      updated: true,
+      reason: `runtime is pinned to ${pin}`,
+      activeVersion: pin,
+      latestVersion: pin,
+      install: install2
+    };
+  }
   const manifest = await fetchRuntimeManifest(cdnOrigin);
   const latestVersion = manifest.channels[channel]?.latest;
   if (!latestVersion) {
@@ -3745,9 +3785,18 @@ var SootSimBridgeHost = class _SootSimBridgeHost {
           }
           return;
         }
+        const previousVersion = this.activeRuntimeVersion;
         const active = this.setActiveRuntime(result.latestVersion);
         process.stderr.write(`sootsim runtime updated to ${active.version} (${reason})
 `);
+        try {
+          writeRuntimeUpgradeNotice({
+            from: previousVersion,
+            to: active.version,
+            at: Date.now()
+          });
+        } catch {
+        }
       } catch (err) {
         process.stderr.write(
           `sootsim runtime update failed (${reason}): ${err instanceof Error ? err.message : String(err)}

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

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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.201 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.202 | (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;
@@ -10635,6 +10635,16 @@ function writeSharedConfig(patch) {
   import_node_fs2.default.renameSync(tmp, configFilePath());
   return next;
 }
+function runtimeUpgradeNoticePath() {
+  return import_node_path.default.join(sootsimHomeDir(), "runtime-upgraded.json");
+}
+function writeRuntimeUpgradeNotice(notice) {
+  ensureSootsimHome();
+  const tmp = `${runtimeUpgradeNoticePath()}.tmp`;
+  import_node_fs2.default.writeFileSync(tmp, `${JSON.stringify(notice)}
+`, "utf8");
+  import_node_fs2.default.renameSync(tmp, runtimeUpgradeNoticePath());
+}
 function ensureSootsimHome() {
   import_node_fs2.default.mkdirSync(sootsimHomeDir(), { recursive: true });
   import_node_fs2.default.mkdirSync(runtimesDir(), { recursive: true });
@@ -10856,6 +10866,12 @@ function resolveRuntimeChannel(input) {
   const config = readConfig();
   return input || process.env[RUNTIME_CHANNEL_ENV] || config.runtimeChannel || "stable";
 }
+function resolveRuntimePin() {
+  const env = process.env[RUNTIME_PIN_ENV];
+  if (env && env.trim()) return env.trim();
+  const config = readConfig();
+  return typeof config.runtimeVersion === "string" && config.runtimeVersion.trim() ? config.runtimeVersion.trim() : null;
+}
 function runtimeManifestUrl(cdnOrigin) {
   const url = new URL(`${resolveRuntimeCdnOrigin(cdnOrigin)}/runtimes/manifest.json`);
   url.searchParams.set("t", String(Date.now()));
@@ -10874,7 +10890,7 @@ async function fetchRuntimeManifest(cdnOrigin) {
 }
 function resolveRuntimeVersion(manifest, opts = {}) {
   const channel = resolveRuntimeChannel(opts.channel);
-  const version = opts.version || manifest.channels[channel]?.latest;
+  const version = opts.version || resolveRuntimePin() || manifest.channels[channel]?.latest;
   if (!version) {
     throw new Error(
       `no version specified and channel '${channel}' has no latest entry in the manifest`
@@ -10950,6 +10966,29 @@ async function updateRuntimeToLatest(opts = {}) {
   ensureSootsimHome();
   const cdnOrigin = resolveRuntimeCdnOrigin(opts.cdnOrigin);
   const channel = resolveRuntimeChannel(opts.channel);
+  const pin = resolveRuntimePin();
+  if (pin) {
+    const activeVersion2 = readActiveRuntime();
+    const pinInstalled = import_fs2.default.existsSync(import_path2.default.join(runtimeDir(pin), "index.html"));
+    if (activeVersion2 === pin && pinInstalled) {
+      return {
+        checked: true,
+        updated: false,
+        reason: `runtime is pinned to ${pin}`,
+        activeVersion: activeVersion2,
+        latestVersion: pin
+      };
+    }
+    const install2 = await installRuntime({ version: pin, channel, cdnOrigin, setActive: false });
+    return {
+      checked: true,
+      updated: true,
+      reason: `runtime is pinned to ${pin}`,
+      activeVersion: pin,
+      latestVersion: pin,
+      install: install2
+    };
+  }
   const manifest = await fetchRuntimeManifest(cdnOrigin);
   const latestVersion = manifest.channels[channel]?.latest;
   if (!latestVersion) {
@@ -11039,7 +11078,7 @@ function extractTarball(tarPath, destDir) {
     });
   });
 }
-var import_child_process2, import_crypto, import_fs2, import_path2, import_stream, import_promises, DEFAULT_RUNTIME_CDN_ORIGIN, RUNTIME_CDN_ORIGIN_ENV, RUNTIME_CHANNEL_ENV;
+var import_child_process2, import_crypto, import_fs2, import_path2, import_stream, import_promises, DEFAULT_RUNTIME_CDN_ORIGIN, RUNTIME_CDN_ORIGIN_ENV, RUNTIME_CHANNEL_ENV, RUNTIME_PIN_ENV;
 var init_runtime_delivery = __esm({
   "src/runtime-delivery.ts"() {
     "use strict";
@@ -11053,6 +11092,7 @@ var init_runtime_delivery = __esm({
     DEFAULT_RUNTIME_CDN_ORIGIN = "https://sootbean.com";
     RUNTIME_CDN_ORIGIN_ENV = "SOOTSIM_CDN_ORIGIN";
     RUNTIME_CHANNEL_ENV = "SOOTSIM_RUNTIME_CHANNEL";
+    RUNTIME_PIN_ENV = "SOOTSIM_RUNTIME_VERSION";
   }
 });
 
@@ -13867,9 +13907,18 @@ var init_bridge_host = __esm({
               }
               return;
             }
+            const previousVersion = this.activeRuntimeVersion;
             const active = this.setActiveRuntime(result.latestVersion);
             process.stderr.write(`sootsim runtime updated to ${active.version} (${reason})
 `);
+            try {
+              writeRuntimeUpgradeNotice({
+                from: previousVersion,
+                to: active.version,
+                at: Date.now()
+              });
+            } catch {
+            }
           } catch (err) {
             process.stderr.write(
               `sootsim runtime update failed (${reason}): ${err instanceof Error ? err.message : String(err)}
@@ -18659,6 +18708,9 @@ var init_bridge_flow_runner = __esm({
           throw new Error(`unsupported flow step: ${JSON.stringify(step)}`);
         }
       }
+      // live progress reporter (shell devtools "test" tab). attached by
+      // runFlowPlayback; absent for programmatic callers.
+      liveStatus = null;
       async runFlow(steps) {
         const onStart = [];
         const onComplete = [];
@@ -18675,6 +18727,15 @@ var init_bridge_flow_runner = __esm({
           }
           body.push(step);
         }
+        if (this.liveStatus) {
+          await this.liveStatus.plan(
+            body.map((rawStep, index) => {
+              const step = typeof rawStep === "string" ? normalizeBareStringStep(rawStep) : rawStep;
+              const name = Object.keys(step).find((k) => k !== "when") ?? Object.keys(step)[0];
+              return { index, name, target: this.flowStepTargetLabel(step, name) };
+            })
+          );
+        }
         if (onStart.length > 0) {
           console.log(`[flow] onFlowStart (${onStart.length} steps)`);
           for (let i = 0; i < onStart.length; i++) {
@@ -18707,23 +18768,47 @@ var init_bridge_flow_runner = __esm({
           const explicitWait = typeof step.wait === "number" ? step.wait : 0;
           const waitForTimeout = typeof step.waitFor?.timeout === "number" ? step.waitFor.timeout : 0;
           const stepCeiling = Math.max(6e4, explicitWait + 15e3, waitForTimeout + 15e3);
-          if (step.runFlow || step.launchApp) {
-            await this.runStep(step, i);
-            continue;
-          }
-          await Promise.race([
-            this.runStep(step, i),
-            new Promise(
-              (_, reject) => setTimeout(
-                () => reject(
-                  new Error(
-                    `step ${i + 1} (${Object.keys(step)[0]}) exceeded ${stepCeiling}ms deadline`
+          if (this.liveStatus) {
+            await this.liveStatus.waitWhilePaused();
+            await this.liveStatus.step(i, "running");
+          }
+          const liveStartedAtMs = Date.now();
+          const reportOutcome = async (failed, error) => {
+            if (!this.liveStatus) return;
+            const last = this.flowTraceSteps[this.flowTraceSteps.length - 1];
+            const traced = last && last.stepIndex === i && last.startedAtMs >= liveStartedAtMs;
+            await this.liveStatus.step(
+              i,
+              failed ? "failure" : traced && last.status === "skipped" ? "skipped" : "success",
+              {
+                durationMs: Date.now() - liveStartedAtMs,
+                error: failed ? error instanceof Error ? error.message.slice(0, 300) : String(error).slice(0, 300) : traced && last.error || void 0
+              }
+            );
+          };
+          try {
+            if (step.runFlow || step.launchApp) {
+              await this.runStep(step, i);
+            } else {
+              await Promise.race([
+                this.runStep(step, i),
+                new Promise(
+                  (_, reject) => setTimeout(
+                    () => reject(
+                      new Error(
+                        `step ${i + 1} (${Object.keys(step)[0]}) exceeded ${stepCeiling}ms deadline`
+                      )
+                    ),
+                    stepCeiling
                   )
-                ),
-                stepCeiling
-              )
-            )
-          ]);
+                )
+              ]);
+            }
+          } catch (error) {
+            await reportOutcome(true, error);
+            throw error;
+          }
+          await reportOutcome(false);
         }
       }
     };

package/dist-lib/vite.cjs

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