sootsim 0.1.200 → 0.1.202

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.200 | (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)}
@@ -15542,18 +15591,18 @@ var init_ws_bridge = __esm({
 function getFramedScreenshotLayout(model) {
   const spec = (0, import_settings.getDevice)(model);
   const renderScale = spec.scale;
-  const isLegacyHardware = !spec.dynamicIsland && spec.homeIndicatorHeight === 0 && spec.cornerRadius === 0;
+  const isLegacyHardware = spec.statusBarHeight > 0 && !spec.dynamicIsland && spec.homeIndicatorHeight === 0 && spec.cornerRadius === 0;
   const logicalScreenWidth = spec.width;
   const logicalScreenHeight = spec.height;
-  const logicalFrameWidth = isLegacyHardware ? spec.width + LEGACY_SIDE_BEZEL * 2 : spec.width + import_chrome_metrics.BEZEL_PADDING * 2;
-  const logicalFrameHeight = isLegacyHardware ? spec.height + LEGACY_TOP_BEZEL + LEGACY_BOTTOM_BEZEL : spec.height + import_chrome_metrics.BEZEL_PADDING * 2;
+  const logicalFrameWidth = isLegacyHardware ? spec.width + import_chrome_metrics.LEGACY_SIDE_BEZEL * 2 : spec.width + spec.bezelWidth * 2;
+  const logicalFrameHeight = isLegacyHardware ? spec.height + import_chrome_metrics.LEGACY_TOP_BEZEL + import_chrome_metrics.LEGACY_BOTTOM_BEZEL : spec.height + spec.bezelWidth * 2;
   const logicalFrameLeft = import_chrome_metrics.SIDE_BUTTON_RESERVE;
   const logicalFrameTop = FRAME_OUTLINE_BLEED;
   const logicalOuterWidth = logicalFrameWidth + logicalFrameLeft * 2;
   const logicalOuterHeight = logicalFrameHeight + FRAME_OUTLINE_BLEED * 2;
-  const logicalScreenLeft = logicalFrameLeft + (isLegacyHardware ? LEGACY_SIDE_BEZEL : import_chrome_metrics.BEZEL_PADDING);
-  const logicalScreenTop = isLegacyHardware ? LEGACY_TOP_BEZEL : import_chrome_metrics.BEZEL_PADDING;
-  const logicalFrameRadius = isLegacyHardware ? LEGACY_FRAME_RADIUS : spec.cornerRadius + import_chrome_metrics.BEZEL_PADDING;
+  const logicalScreenLeft = logicalFrameLeft + (isLegacyHardware ? import_chrome_metrics.LEGACY_SIDE_BEZEL : spec.bezelWidth);
+  const logicalScreenTop = isLegacyHardware ? import_chrome_metrics.LEGACY_TOP_BEZEL : spec.bezelWidth;
+  const logicalFrameRadius = isLegacyHardware ? import_chrome_metrics.LEGACY_FRAME_RADIUS : spec.cornerRadius + spec.bezelWidth;
   const buttons = [
     {
       side: "right",
@@ -15602,10 +15651,10 @@ function getFramedScreenshotLayout(model) {
     metallicRingShadow: isLegacyHardware ? null : METALLIC_RING_SHADOW,
     buttons,
     legacyHomeButton: isLegacyHardware ? {
-      top: LEGACY_TOP_BEZEL + spec.height + (LEGACY_BOTTOM_BEZEL - LEGACY_HOME_BUTTON_SIZE) / 2,
-      left: spec.width / 2 - LEGACY_HOME_BUTTON_SIZE / 2 + LEGACY_SIDE_BEZEL,
-      size: LEGACY_HOME_BUTTON_SIZE,
-      ring: LEGACY_HOME_BUTTON_RING
+      top: import_chrome_metrics.LEGACY_TOP_BEZEL + spec.height + (import_chrome_metrics.LEGACY_BOTTOM_BEZEL - import_chrome_metrics.LEGACY_HOME_BUTTON_SIZE) / 2,
+      left: spec.width / 2 - import_chrome_metrics.LEGACY_HOME_BUTTON_SIZE / 2 + import_chrome_metrics.LEGACY_SIDE_BEZEL,
+      size: import_chrome_metrics.LEGACY_HOME_BUTTON_SIZE,
+      ring: import_chrome_metrics.LEGACY_HOME_BUTTON_RING
     } : null,
     showHomeIndicator: spec.homeIndicatorHeight > 0,
     logicalHomeIndicatorStripHeight: spec.homeIndicatorHeight
@@ -15857,18 +15906,12 @@ async function createFramedScreenshotComposer(browser) {
     }
   };
 }
-var import_chrome_metrics, import_settings, LEGACY_FRAME_RADIUS, LEGACY_SIDE_BEZEL, LEGACY_TOP_BEZEL, LEGACY_BOTTOM_BEZEL, LEGACY_HOME_BUTTON_SIZE, LEGACY_HOME_BUTTON_RING, METALLIC_RING_SHADOW, FRAME_OUTLINE_BLEED;
+var import_chrome_metrics, import_settings, METALLIC_RING_SHADOW, FRAME_OUTLINE_BLEED;
 var init_frame_compose = __esm({
   "src/screenshots/frame-compose.ts"() {
     "use strict";
     import_chrome_metrics = require("sootsim-engine/ios/chrome-metrics");
     import_settings = require("sootsim-engine/settings");
-    LEGACY_FRAME_RADIUS = 52;
-    LEGACY_SIDE_BEZEL = 18;
-    LEGACY_TOP_BEZEL = 42;
-    LEGACY_BOTTOM_BEZEL = 96;
-    LEGACY_HOME_BUTTON_SIZE = 54;
-    LEGACY_HOME_BUTTON_RING = 1.5;
     METALLIC_RING_SHADOW = "inset 0 0 0 0.5px #000, inset 0 0 0 2px #757575, inset 0 0 0 5px #212121";
     FRAME_OUTLINE_BLEED = 1;
   }
@@ -18665,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 = [];
@@ -18681,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++) {
@@ -18713,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.200 | (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.200",
+  "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",

package/src/home-paths.ts

@@ -15,7 +15,11 @@
 //   │   └── sootsim-runtime-<version>.tar.gz
 //   ├── daemon.json        lockfile: pid, ports, active runtime, heartbeat
 //   ├── dev-bridge.json    live Vite dev bridge pointer for local CLI commands
-//   └── config.json        user prefs: update channel, cdn origin override
+//   ├── runtime-upgraded.json  one-shot notice written by the daemon's
+//   │                      background updater, consumed (printed + deleted)
+//   │                      by the next interactive CLI run
+//   └── config.json        user prefs: runtime pin, update channel, cdn
+//                          origin override, telemetry, engine settings
 
 import { randomUUID } from 'node:crypto'
 import fs from 'node:fs'
@@ -232,6 +236,49 @@ export function writeTelemetryEnabled(enabled: boolean): void {
   writeSharedConfig({ telemetry: enabled })
 }
 
+// --- background-upgrade notice --------------------------------------------
+//
+// the daemon auto-updates the engine runtime in the background (hourly), so
+// the only place its "updated to vX" line lands is the daemon's own stderr,
+// which nobody reads. it also drops a one-shot notice file here; the next
+// interactive CLI invocation prints it once and deletes it, so users learn
+// their engine moved without having to run `sootsim version`.
+
+export interface RuntimeUpgradeNotice {
+  from: string | null
+  to: string
+  at: number
+}
+
+export function runtimeUpgradeNoticePath(): string {
+  return path.join(sootsimHomeDir(), 'runtime-upgraded.json')
+}
+
+export function writeRuntimeUpgradeNotice(notice: RuntimeUpgradeNotice): void {
+  ensureSootsimHome()
+  const tmp = `${runtimeUpgradeNoticePath()}.tmp`
+  fs.writeFileSync(tmp, `${JSON.stringify(notice)}\n`, 'utf8')
+  fs.renameSync(tmp, runtimeUpgradeNoticePath())
+}
+
+/** read + delete the pending upgrade notice, or null when none is pending.
+ *  deleting first-read keeps the banner one-shot even across racing CLIs. */
+export function consumeRuntimeUpgradeNotice(): RuntimeUpgradeNotice | null {
+  try {
+    const raw = fs.readFileSync(runtimeUpgradeNoticePath(), 'utf8')
+    fs.unlinkSync(runtimeUpgradeNoticePath())
+    const parsed = JSON.parse(raw) as Partial<RuntimeUpgradeNotice>
+    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
+  }
+}
+
 export function ensureSootsimHome(): void {
   fs.mkdirSync(sootsimHomeDir(), { recursive: true })
   fs.mkdirSync(runtimesDir(), { recursive: true })

package/src/host/bridge-host.ts

@@ -25,6 +25,7 @@ import {
   writeActiveRuntime,
   writeDaemonLockfile,
   writeDevBridgeLockfile,
+  writeRuntimeUpgradeNotice,
   writeSharedConfig,
   type DaemonLockfile,
   type DevBridgeLockfile,
@@ -1283,8 +1284,19 @@ export class SootSimBridgeHost {
           }
           return
         }
+        const previousVersion = this.activeRuntimeVersion
         const active = this.setActiveRuntime(result.latestVersion)
         process.stderr.write(`sootsim runtime updated to ${active.version} (${reason})\n`)
+        // the daemon's stderr goes to a log nobody watches — drop a one-shot
+        // notice so the next interactive CLI run tells the user their engine
+        // moved (consumed + deleted by bin.ts).
+        try {
+          writeRuntimeUpgradeNotice({
+            from: previousVersion,
+            to: active.version,
+            at: Date.now(),
+          })
+        } catch {}
       } catch (err) {
         process.stderr.write(
           `sootsim runtime update failed (${reason}): ${

package/src/runtime-delivery.ts

@@ -17,6 +17,7 @@ import {
 export const DEFAULT_RUNTIME_CDN_ORIGIN = 'https://sootbean.com'
 export const RUNTIME_CDN_ORIGIN_ENV = 'SOOTSIM_CDN_ORIGIN'
 export const RUNTIME_CHANNEL_ENV = 'SOOTSIM_RUNTIME_CHANNEL'
+export const RUNTIME_PIN_ENV = 'SOOTSIM_RUNTIME_VERSION'
 
 export interface RuntimeManifestChannel {
   latest: string
@@ -70,6 +71,7 @@ export interface RuntimeUpdateResult {
 
 interface SootsimConfig {
   runtimeChannel?: string
+  runtimeVersion?: string
   cdnOrigin?: string
 }
 
@@ -97,6 +99,18 @@ export function resolveRuntimeChannel(input?: string): string {
   return input || process.env[RUNTIME_CHANNEL_ENV] || config.runtimeChannel || 'stable'
 }
 
+/** pinned runtime version, or null when following the channel's latest.
+ *  env wins over config so CI can pin per-invocation; the persistent pin
+ *  lives in ~/.sootsim/config.json (`sootsim runtime pin <version>`). */
+export function resolveRuntimePin(): string | null {
+  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
+}
+
 export function runtimeManifestUrl(cdnOrigin?: string): string {
   const url = new URL(`${resolveRuntimeCdnOrigin(cdnOrigin)}/runtimes/manifest.json`)
   // cdn edges can keep the no-query manifest around longer than its
@@ -123,7 +137,7 @@ export function resolveRuntimeVersion(
   opts: Pick<RuntimeInstallOptions, 'version' | 'channel'> = {},
 ): { version: string; channel: string; entry: RuntimeManifestVersion } {
   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`,
@@ -211,6 +225,34 @@ export async function updateRuntimeToLatest(
   ensureSootsimHome()
   const cdnOrigin = resolveRuntimeCdnOrigin(opts.cdnOrigin)
   const channel = resolveRuntimeChannel(opts.channel)
+
+  // a pinned runtime never follows the channel. when the pin is already
+  // active + on disk this is a no-network no-op; otherwise install exactly
+  // the pinned version (it must still exist in the hosted manifest).
+  const pin = resolveRuntimePin()
+  if (pin) {
+    const activeVersion = readActiveRuntime()
+    const pinInstalled = fs.existsSync(path.join(runtimeDir(pin), 'index.html'))
+    if (activeVersion === pin && pinInstalled) {
+      return {
+        checked: true,
+        updated: false,
+        reason: `runtime is pinned to ${pin}`,
+        activeVersion,
+        latestVersion: pin,
+      }
+    }
+    const install = await installRuntime({ version: pin, channel, cdnOrigin, setActive: false })
+    return {
+      checked: true,
+      updated: true,
+      reason: `runtime is pinned to ${pin}`,
+      activeVersion: pin,
+      latestVersion: pin,
+      install,
+    }
+  }
+
   const manifest = await fetchRuntimeManifest(cdnOrigin)
   const latestVersion = manifest.channels[channel]?.latest
   if (!latestVersion) {
@@ -272,27 +314,35 @@ export async function updateRuntimeToLatest(
 export interface RuntimeUpToDateCheck {
   active: string | null
   latest: string | null
-  // true only when a latest version is known and it is newer than the
-  // active one (or nothing is active yet). network failures resolve to
-  // false so callers can treat this as a best-effort hint.
+  // pinned version when one is set — a pinned runtime is only "outdated"
+  // when the pin itself isn't active yet, never against channel latest.
+  pinned: string | null
+  // true only when a target version is known and it is newer than / not
+  // the active one (or nothing is active yet). network failures resolve
+  // to false so callers can treat this as a best-effort hint.
   outdated: boolean
 }
 
-/** read-only check: is the active runtime the latest on its channel?
- *  unlike updateRuntimeToLatest this never downloads or activates — it's
- *  for surfacing a "newer runtime available" hint at startup / in help. */
+/** read-only check: is the active runtime the latest on its channel (or,
+ *  when pinned, the pin)? unlike updateRuntimeToLatest this never downloads
+ *  or activates — it's for surfacing a "newer runtime available" hint at
+ *  startup / in help. */
 export async function checkRuntimeUpToDate(
   opts: Pick<RuntimeInstallOptions, 'channel' | 'cdnOrigin'> = {},
 ): Promise<RuntimeUpToDateCheck> {
   const active = readActiveRuntime()
+  const pinned = resolveRuntimePin()
+  if (pinned) {
+    return { active, latest: pinned, pinned, outdated: active !== pinned }
+  }
   try {
     const manifest = await fetchRuntimeManifest(resolveRuntimeCdnOrigin(opts.cdnOrigin))
     const channel = resolveRuntimeChannel(opts.channel)
     const latest = manifest.channels[channel]?.latest ?? null
     const outdated = !!(latest && (!active || compareSemver(latest, active) > 0))
-    return { active, latest, outdated }
+    return { active, latest, pinned: null, outdated }
   } catch {
-    return { active, latest: null, outdated: false }
+    return { active, latest: null, pinned: null, outdated: false }
   }
 }
 

package/src/screenshots/frame-compose.ts

@@ -1,12 +1,14 @@
-import { BEZEL_PADDING, SIDE_BUTTON_RESERVE } from 'sootsim-engine/ios/chrome-metrics'
+import {
+  LEGACY_BOTTOM_BEZEL,
+  LEGACY_FRAME_RADIUS,
+  LEGACY_HOME_BUTTON_RING,
+  LEGACY_HOME_BUTTON_SIZE,
+  LEGACY_SIDE_BEZEL,
+  LEGACY_TOP_BEZEL,
+  SIDE_BUTTON_RESERVE,
+} from 'sootsim-engine/ios/chrome-metrics'
 import { getDevice, type DeviceModel } from 'sootsim-engine/settings'
 
-const LEGACY_FRAME_RADIUS = 52
-const LEGACY_SIDE_BEZEL = 18
-const LEGACY_TOP_BEZEL = 42
-const LEGACY_BOTTOM_BEZEL = 96
-const LEGACY_HOME_BUTTON_SIZE = 54
-const LEGACY_HOME_BUTTON_RING = 1.5
 const METALLIC_RING_SHADOW =
   'inset 0 0 0 0.5px #000, inset 0 0 0 2px #757575, inset 0 0 0 5px #212121'
 const FRAME_OUTLINE_BLEED = 1
@@ -59,26 +61,32 @@ export interface FramedScreenshotLayout {
 export function getFramedScreenshotLayout(model: DeviceModel): FramedScreenshotLayout {
   const spec = getDevice(model)
   const renderScale = spec.scale
+  // legacy = home-button iPhone (SE). the canvas workspace also has no island /
+  // home indicator / corner radius, but no status bar, so gate on statusBar > 0
+  // to keep it out of the SE shell (mirrors DeviceFrame.isLegacyHardware).
   const isLegacyHardware =
-    !spec.dynamicIsland && spec.homeIndicatorHeight === 0 && spec.cornerRadius === 0
+    spec.statusBarHeight > 0 &&
+    !spec.dynamicIsland &&
+    spec.homeIndicatorHeight === 0 &&
+    spec.cornerRadius === 0
   const logicalScreenWidth = spec.width
   const logicalScreenHeight = spec.height
   const logicalFrameWidth = isLegacyHardware
     ? spec.width + LEGACY_SIDE_BEZEL * 2
-    : spec.width + BEZEL_PADDING * 2
+    : spec.width + spec.bezelWidth * 2
   const logicalFrameHeight = isLegacyHardware
     ? spec.height + LEGACY_TOP_BEZEL + LEGACY_BOTTOM_BEZEL
-    : spec.height + BEZEL_PADDING * 2
+    : spec.height + spec.bezelWidth * 2
   const logicalFrameLeft = SIDE_BUTTON_RESERVE
   const logicalFrameTop = FRAME_OUTLINE_BLEED
   const logicalOuterWidth = logicalFrameWidth + logicalFrameLeft * 2
   const logicalOuterHeight = logicalFrameHeight + FRAME_OUTLINE_BLEED * 2
   const logicalScreenLeft =
-    logicalFrameLeft + (isLegacyHardware ? LEGACY_SIDE_BEZEL : BEZEL_PADDING)
-  const logicalScreenTop = isLegacyHardware ? LEGACY_TOP_BEZEL : BEZEL_PADDING
+    logicalFrameLeft + (isLegacyHardware ? LEGACY_SIDE_BEZEL : spec.bezelWidth)
+  const logicalScreenTop = isLegacyHardware ? LEGACY_TOP_BEZEL : spec.bezelWidth
   const logicalFrameRadius = isLegacyHardware
     ? LEGACY_FRAME_RADIUS
-    : spec.cornerRadius + BEZEL_PADDING
+    : spec.cornerRadius + spec.bezelWidth
   const buttons: FrameButtonLayout[] = [
     {
       side: 'right',

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

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

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

@@ -1,6 +0,0 @@
-/*! sootsim v0.1.200 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{randomUUID as I}from"node:crypto";import t from"node:fs";import{homedir as E}from"node:os";import o from"node:path";var _="SOOTSIM_HOME",N="active",P="daemon.json",j="dev-bridge.json",F="config.json",k=3e4;function u(){let e=process.env[_];return e&&e.length>0?o.resolve(e):o.join(E(),".sootsim")}function w(){if(process.env.SOOTSIM_FORCE_DAEMON_INSTALL==="1")return!1;let e=process.env.SOOTSIM_DEV;if(e==="1"||e==="true")return!0;if(e==="0"||e==="false")return!1;let r=process.argv[1];if(!r)return!1;try{return t.realpathSync(r).includes(`${o.sep}packages${o.sep}sootsim${o.sep}`)}catch{return!1}}function T(){return process.env.SOOTSIM_FORCE_DAEMON_INSTALL==="1"?!1:process.env.IS_TAMAGUI_DEV==="1"}function q(){return w()||T()}function f(){return o.join(u(),"runtimes")}function B(e){return o.join(f(),e)}function L(){return o.join(f(),N)}function D(){return o.join(u(),"electron")}function z(){return o.join(D(),"userData")}function Q(e){return o.join(D(),e)}function C(){return o.join(u(),"profiles")}function M(){return o.join(u(),"daemon-app")}function R(){return o.join(M(),"SootSim Daemon.app")}function Z(){return o.join(R(),"Contents","MacOS","sootsim-daemon")}function $(){return o.join(u(),"cache")}function p(){return o.join(u(),P)}function m(){return o.join(u(),j)}function b(){return o.join(u(),F)}function h(){try{let e=t.readFileSync(b(),"utf8"),r=JSON.parse(e);return r&&typeof r=="object"?r:{}}catch{return{}}}function O(e){g();let r=h(),i={...r,...e};e.settings&&typeof e.settings=="object"&&(i.settings={...r.settings&&typeof r.settings=="object"?r.settings:{},...e.settings});let c=`${b()}.tmp`;return t.writeFileSync(c,`${JSON.stringify(i,null,2)}
-`,"utf8"),t.renameSync(c,b()),i}function ee(){return h().telemetry!==!1}function re(){let e=h().anonymousId;if(typeof e=="string"&&e.trim())return e;let r=`anon-cli-${I()}`;return O({anonymousId:r}),r}function te(e){O({telemetry:e})}function g(){t.mkdirSync(u(),{recursive:!0}),t.mkdirSync(f(),{recursive:!0}),t.mkdirSync(D(),{recursive:!0}),t.mkdirSync(C(),{recursive:!0}),t.mkdirSync($(),{recursive:!0})}function J(){try{let e=t.readFileSync(L(),"utf8").trim();return e.length>0?e:null}catch{return null}}function ne(e){t.mkdirSync(f(),{recursive:!0}),t.writeFileSync(L(),`${e}
-`,"utf8")}function oe(){try{return t.readdirSync(f(),{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).sort(V)}catch{return[]}}function V(e,r){let i=s=>{let a=s.indexOf("-"),l=a>=0?s.slice(0,a):s,A=a>=0?s.slice(a+1):"",x=l.split(".").map(S=>Number.parseInt(S,10));return x.some(S=>!Number.isFinite(S))?[[Number.POSITIVE_INFINITY],s]:[x,A]},[c,n]=i(e),[v,y]=i(r);for(let s=0;s<Math.max(c.length,v.length);s++){let a=c[s]??0,l=v[s]??0;if(a!==l)return a-l}return n===y?0:n?y?n<y?-1:1:-1:1}function ie(){let e=J();if(!e)return null;let r=B(e);try{if(t.statSync(r).isDirectory())return r}catch{}return null}var d=16*1024;function H(){try{let e=t.openSync(p(),"r");try{let r=Buffer.alloc(d),i=t.readSync(e,r,0,d,0),c=r.subarray(0,i).toString("utf8"),n=JSON.parse(c);return n&&n.schema===1&&typeof n.pid=="number"&&typeof n.bridgePort=="number"&&typeof n.runtimePort=="number"&&typeof n.startedAt=="number"&&typeof n.heartbeatAt=="number"?n:null}finally{t.closeSync(e)}}catch{return null}}function se(){try{let e=t.openSync(m(),"r");try{let r=Buffer.alloc(d),i=t.readSync(e,r,0,d,0),c=r.subarray(0,i).toString("utf8"),n=JSON.parse(c);return n&&n.schema===1&&n.source==="vite-dev"&&typeof n.pid=="number"&&typeof n.bridgePort=="number"&&typeof n.runtimePort=="number"&&typeof n.cwd=="string"&&typeof n.startedAt=="number"&&typeof n.heartbeatAt=="number"&&(n.shellPort===void 0||typeof n.shellPort=="number")?n:null}finally{t.closeSync(e)}}catch{return null}}function U(e,r=Date.now()){if(!e||r-e.heartbeatAt>k)return!1;try{return process.kill(e.pid,0),!0}catch{return!1}}function ce(e,r=Date.now()){if(!e||r-e.heartbeatAt>k)return!1;try{return process.kill(e.pid,0),!0}catch{return!1}}function G(e){g();let r=`${p()}.tmp`;t.writeFileSync(r,`${JSON.stringify(e,null,2)}
-`,"utf8"),t.renameSync(r,p())}function ue(e){g();let r=`${m()}.tmp`;t.writeFileSync(r,`${JSON.stringify(e,null,2)}
-`,"utf8"),t.renameSync(r,m())}function ae(e){g();let r=H();return r&&U(r)&&r.pid!==e.pid?!1:(G(e),!0)}function fe(){try{t.unlinkSync(p())}catch{}}function le(){try{t.unlinkSync(m())}catch{}}export{_ as a,N as b,P as c,j as d,F as e,k as f,u as g,w as h,T as i,q as j,f as k,B as l,L as m,D as n,z as o,Q as p,C as q,M as r,R as s,Z as t,$ as u,p as v,m as w,b as x,h as y,O as z,ee as A,re as B,te as C,g as D,J as E,ne as F,oe as G,V as H,ie as I,H as J,se as K,U as L,ce as M,G as N,ue as O,ae as P,fe as Q,le as R};

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

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

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

@@ -1,4 +0,0 @@
-/*! sootsim v0.1.200 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{D as v,E as f,F as R,H as w,l as p,u as S,x as O}from"./chunk-CB3I3VQT.js";import{spawn as I}from"child_process";import C from"crypto";import s from"fs";import l from"path";import{Readable as M}from"stream";import{pipeline as k}from"stream/promises";var N="https://sootbean.com",E="SOOTSIM_CDN_ORIGIN",T="SOOTSIM_RUNTIME_CHANNEL",q="https://sootsim.com/changelog";function $(){try{let t=JSON.parse(s.readFileSync(O(),"utf8"));return t&&typeof t=="object"?t:{}}catch{return{}}}function d(t){let e=$();return(t||process.env[E]||e.cdnOrigin||N).replace(/\/+$/,"")}function x(t){let e=$();return t||process.env[T]||e.runtimeChannel||"stable"}function D(t){let e=new URL(`${d(t)}/runtimes/manifest.json`);return e.searchParams.set("t",String(Date.now())),e.toString()}function U(t,e){return`${d(e)}/runtimes/sootsim-runtime-${t}.tar.gz`}async function y(t){let e=D(t),r=await fetch(e,{headers:{Accept:"application/json"}});if(!r.ok)throw new Error(`manifest fetch failed: ${r.status} ${r.statusText} (${e})`);return await r.json()}function P(t,e={}){let r=x(e.channel),n=e.version||t.channels[r]?.latest;if(!n)throw new Error(`no version specified and channel '${r}' has no latest entry in the manifest`);let i=t.versions[n];if(!i)throw new Error(`version ${n} not found in manifest; available: ${Object.keys(t.versions).slice(-10).join(", ")||"(none)"}`);return{version:n,channel:r,entry:i}}async function _(t={}){v();let e=d(t.cdnOrigin),r=await y(e),{version:n,channel:i,entry:a}=P(r,t),o=p(n),c=t.setActive!==!1;if(!t.force&&s.existsSync(l.join(o,"index.html")))return c&&R(n),{version:n,channel:i,cdnOrigin:e,runtimeDir:o,installed:!1,activated:c,manifest:r};let g=a.tarball||U(n,e),m=l.join(S(),`sootsim-runtime-${n}.tar.gz`);process.stderr.write(`sootsim: downloading runtime ${n}\u2026
-`),await V(g,m),process.stderr.write(`sootsim: extracting runtime ${n}\u2026
-`);let h=await A(m);if(h!==a.sha256)throw s.rmSync(m,{force:!0}),new Error(`sha256 mismatch for runtime ${n}: expected ${a.sha256}, actual ${h}`);let u=l.join(l.dirname(o),`.installing-${n}-${process.pid}`);s.rmSync(u,{recursive:!0,force:!0}),s.mkdirSync(u,{recursive:!0});try{if(await j(m,u),!s.existsSync(l.join(u,"index.html")))throw new Error(`extracted tarball for runtime ${n} is missing index.html`);s.rmSync(o,{recursive:!0,force:!0}),s.renameSync(u,o)}catch(b){throw s.rmSync(u,{recursive:!0,force:!0}),b}return c&&R(n),{version:n,channel:i,cdnOrigin:e,runtimeDir:o,installed:!0,activated:c,manifest:r}}async function B(t={}){v();let e=d(t.cdnOrigin),r=x(t.channel),n=await y(e),i=n.channels[r]?.latest;if(!i)return{checked:!0,updated:!1,reason:`channel '${r}' has no latest runtime`,activeVersion:f()};if(!n.versions[i])return{checked:!0,updated:!1,reason:`manifest is missing version ${i}`,activeVersion:f(),latestVersion:i};let o=f(),c=o?p(o):null,g=c?s.existsSync(l.join(c,"index.html")):!1;if(!(!o||!g||w(i,o)>0))return{checked:!0,updated:!1,reason:"active runtime is current",activeVersion:o,latestVersion:i};let h=await _({version:i,channel:r,cdnOrigin:e,setActive:!1});return{checked:!0,updated:!0,activeVersion:i,latestVersion:i,install:h}}async function K(t={}){let e=f();try{let r=await y(d(t.cdnOrigin)),n=x(t.channel),i=r.channels[n]?.latest??null,a=!!(i&&(!e||w(i,e)>0));return{active:e,latest:i,outdated:a}}catch{return{active:e,latest:null,outdated:!1}}}async function V(t,e){let r=await fetch(t);if(!r.ok||!r.body)throw new Error(`download failed: ${r.status} ${r.statusText} (${t})`);s.mkdirSync(l.dirname(e),{recursive:!0});let n=`${e}.partial`;try{await k(M.fromWeb(r.body),s.createWriteStream(n)),s.renameSync(n,e)}catch(i){try{s.unlinkSync(n)}catch{}throw i}}function A(t){return new Promise((e,r)=>{let n=C.createHash("sha256"),i=s.createReadStream(t);i.on("data",a=>n.update(a)),i.on("error",r),i.on("end",()=>e(n.digest("hex")))})}function j(t,e){return new Promise((r,n)=>{let i=I("tar",["-xzf",t,"-C",e],{stdio:["ignore","inherit","inherit"]});i.on("error",n),i.on("exit",a=>{a===0?r():n(new Error(`tar exited with code ${a}`))})})}export{N as a,q as b,d as c,x as d,y as e,_ as f,B as g,K as h};