sootsim 0.1.227 → 0.1.228

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.227 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.228 | (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.227",
+  "version": "0.1.228",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",
@@ -171,9 +171,9 @@
     }
   },
   "devDependencies": {
-    "@soot/compat": "workspace:*",
-    "@soot/sootsim-globals": "workspace:*",
-    "@soot/sootsim-skills": "workspace:*",
+    "@sootsim/compat": "workspace:*",
+    "@sootsim/globals": "workspace:*",
+    "@sootsim/skills": "workspace:*",
     "@types/ws": "^8.5.13",
     "esbuild": "^0.25.0",
     "sootsim-engine": "workspace:*",

package/scripts/dev-server-scanner.ts

@@ -644,14 +644,14 @@ export interface ScanOptions {
   buildIconProxyUrl?: (externalUrl: string) => string
 }
 
-function isSootSelfServer(server: DiscoveredServer): boolean {
+function isSootSimSelfServer(server: DiscoveredServer): boolean {
   const bundleId = server.bundleId?.trim().toLowerCase()
   if (bundleId?.startsWith('dev.sootsim.')) return true
 
   return false
 }
 
-export const __isSootSelfServerForTests = isSootSelfServer
+export const __isSootSimSelfServerForTests = isSootSimSelfServer
 
 // per-(port, pid) probe cache. as long as the same process still owns the
 // port, its signature endpoints can't have changed, so we return the cached
@@ -666,10 +666,10 @@ interface PortCacheEntry {
 }
 const portCache = new Map<number, PortCacheEntry>()
 
-// negative-cache holds a node/bun port that isn't a bundler (e.g. soot's own
+// negative-cache holds a node/bun port that isn't a bundler (e.g. Contrast's own
 // api server, zero, postgres, a dev tool). at scan interval 3s and a 1.5s ttl
 // we used to re-probe every scan, which hits `/` on the port every 3s — that
-// waking soot's SSR router ~20x/min was a real memory-leak driver. 30s gives
+// waking Contrast's SSR router ~20x/min was a real memory-leak driver. 30s gives
 // the scanner a much lighter touch on unrelated node processes while still
 // catching pid-change invalidation immediately when a process restarts.
 const NEGATIVE_CACHE_TTL_MS = 30_000
@@ -796,5 +796,5 @@ export async function scanDevServers(
     if (!livePids.has(pid)) cwdByPid.delete(pid)
   }
 
-  return results.filter((r) => !isSootSelfServer(r))
+  return results.filter((r) => !isSootSimSelfServer(r))
 }

package/scripts/postinstall.cjs

@@ -17,7 +17,7 @@ if (process.env.SOOTSIM_SKIP_POSTINSTALL === '1') {
   process.exit(0)
 }
 
-// in dev / workspace installs (i.e. running inside the soot monorepo, not
+// in dev / workspace installs (i.e. running inside the Contrast monorepo, not
 // installed as a dep), the package dir is `<repo>/packages/sootsim/` rather
 // than `.../node_modules/sootsim/`. skip the runtime fetch in that case —
 // the workspace already has the engine source.

package/scripts/preuninstall.cjs

@@ -29,7 +29,7 @@ if (process.env.SOOTSIM_SKIP_PREUNINSTALL === '1') {
   process.exit(0)
 }
 
-// dev / workspace installs (running inside the soot monorepo, not in a
+// dev / workspace installs (running inside the Contrast monorepo, not in a
 // node_modules tree) — don't tear anything down. the developer is rebuilding
 // the workspace, not actually uninstalling.
 const pkgDir = path.resolve(__dirname, '..')

package/skills/{soot → contrast}/SKILL.md

@@ -1,15 +1,15 @@
 ---
-name: soot
+name: contrast
 description: >-
-  index of all Soot and SootSim agent skills and CLI commands.
+  index of all Contrast and SootSim agent skills and CLI commands.
   auto-generated from the CLI info registry — do not edit by hand.
 ---
 
-# soot
+# contrast
 
 overview of all available skills and CLI commands in this repo.
 
-> this file is auto-generated by `bun scripts/generate-soot-skill.ts`.
+> this file is auto-generated by `bun scripts/generate-contrast-skill.ts`.
 > to update, edit the source registries and re-run the generator.
 
 ## sootsim CLI commands

package/skills/sootsim-perf/SKILL.md

@@ -23,7 +23,9 @@ indict, remeasure — and every wasted week came from skipping a step.
    browser matters just as much: playwright's bundled headless chromium has
    NO GPU — CanvasKit falls back to SwiftShader and every number lies high.
    use `--browser webkit` (real Apple GPU even headless, the iOS proxy) or
-   GPU-backed Chrome (`channel: 'chrome'`), never `chromium.launch()`.
+   GPU-backed Chrome via `launchReapedChrome` from `scripts/lib/reap-browser`,
+   never a bare `chromium.launch()`. never `channel: 'chrome'` — that is the
+   user's own browser, and automation launching it hijacks their Dock events.
 2. **machinery silently not engaging is the default failure mode.** the
    raster tier compiled, gated, and did *nothing* for months — zero
    promotions on its textbook case — until per-gate rejection counters

package/src/auth/shared-session.ts

@@ -37,7 +37,7 @@ export type SharedDesktopAuthSession = {
 
 const SESSION_VERSION = 1 as const
 const SESSION_FILE_ENV = 'SOOTSIM_SHARED_AUTH_FILE'
-const DEFAULT_ORIGIN = 'https://sootbean.com'
+const DEFAULT_ORIGIN = 'https://contrast.dev'
 
 function getBaseDir() {
   const explicit = process.env[SESSION_FILE_ENV]

package/src/backend-origin.ts

@@ -1,4 +1,4 @@
-const DEFAULT_SOOT_BACKEND_ORIGIN = 'https://sootbean.com'
+const DEFAULT_CONTRAST_BACKEND_ORIGIN = 'https://contrast.dev'
 
 function normalizeHostname(hostname: string): string {
   return hostname.replace(/^\[|\]$/g, '').toLowerCase()
@@ -15,35 +15,35 @@ export function isLoopbackHost(hostname: string): boolean {
   )
 }
 
-export function isSootBackendHost(hostname: string): boolean {
+export function isContrastBackendHost(hostname: string): boolean {
   const normalized = normalizeHostname(hostname)
   return (
     isLoopbackHost(normalized) ||
-    normalized === 'sootbean.com' ||
-    normalized.endsWith('.sootbean.com')
+    normalized === 'contrast.dev' ||
+    normalized.endsWith('.contrast.dev')
   )
 }
 
-export function isSootBackendOrigin(origin: string): boolean {
+export function isContrastBackendOrigin(origin: string): boolean {
   try {
-    return isSootBackendHost(new URL(origin).hostname)
+    return isContrastBackendHost(new URL(origin).hostname)
   } catch {
     return false
   }
 }
 
-export function resolveSootBackendOrigin(currentOrigin?: string | null): string {
+export function resolveContrastBackendOrigin(currentOrigin?: string | null): string {
   const origin = currentOrigin?.trim()
-  if (!origin) return DEFAULT_SOOT_BACKEND_ORIGIN
+  if (!origin) return DEFAULT_CONTRAST_BACKEND_ORIGIN
 
   try {
     const parsed = new URL(origin)
-    if (isLoopbackHost(parsed.hostname) || isSootBackendHost(parsed.hostname)) {
+    if (isLoopbackHost(parsed.hostname) || isContrastBackendHost(parsed.hostname)) {
       return parsed.origin
     }
   } catch {}
 
-  return DEFAULT_SOOT_BACKEND_ORIGIN
+  return DEFAULT_CONTRAST_BACKEND_ORIGIN
 }
 
-export { DEFAULT_SOOT_BACKEND_ORIGIN }
+export { DEFAULT_CONTRAST_BACKEND_ORIGIN }

package/src/bridge-constants.ts

@@ -42,11 +42,11 @@ export function resolveSootsimBridgePortForHttpPort(input: {
   return resolveSootsimBridgePort({ portOffset })
 }
 
-const SOOTBEAN_DEV_HTTP_BASE_PORT = 3000
+const CONTRAST_DEV_HTTP_BASE_PORT = 3000
 const SOOTSIM_SITE_DEV_HTTP_BASE_PORT = 3001
 const SOOTSIM_SHELL_DEV_HTTP_BASE_PORT = 5173
 const LOCAL_DEV_HTTP_BASE_PORTS = [
-  SOOTBEAN_DEV_HTTP_BASE_PORT,
+  CONTRAST_DEV_HTTP_BASE_PORT,
   SOOTSIM_SHELL_DEV_HTTP_BASE_PORT,
 ]
 const MAX_LOCAL_DEV_PORT_OFFSET = 2000
@@ -88,7 +88,7 @@ export function resolveSootsimBridgePortForRuntimeLocation(
   ) {
     return resolveSootsimBridgePortForHttpPort({
       httpPort,
-      baseHttpPort: SOOTBEAN_DEV_HTTP_BASE_PORT,
+      baseHttpPort: CONTRAST_DEV_HTTP_BASE_PORT,
     })
   }
   if (

package/src/home-paths.ts

@@ -39,7 +39,7 @@ export function sootsimHomeDir(): string {
   return path.join(homedir(), '.sootsim')
 }
 
-// detect when sootsim is running from a source checkout (the soot monorepo)
+// detect when sootsim is running from a source checkout (the Contrast monorepo)
 // rather than a published npm install. used to skip auto-install of the
 // persistent launchd / systemd agent: dev shells shouldn't register an agent
 // whose Program path points at workspace artifacts that change between

package/src/host/agent-host.ts

@@ -63,7 +63,7 @@ interface PendingPromptEcho {
 }
 
 export interface AgentHostOptions {
-  /** callback so hosts with a soot-env context (electron, dev middleware)
+  /** callback so hosts with a Contrast-env context (electron, dev middleware)
    *  can inject their own exclude list. defaults to the env-derived list
    *  the rest of the repo uses, so `sootsim serve` standalone does the
    *  right thing. */
@@ -79,7 +79,7 @@ export interface AgentCliLeaseSnapshot {
   expiresAt: number
 }
 
-/** default excludes keep the dev-server scanner from hitting soot's own
+/** default excludes keep the dev-server scanner from hitting Contrast's own
  *  web / zero / postgres / r2 ports. mirrored from
  *  sootsim-engine/src/dev-scan-excludes.ts — duplicated rather than
  *  imported because sootsim is a dependency of sootsim-engine, not the

package/src/host/bridge-host.ts

@@ -65,12 +65,12 @@ export interface BridgeSimInfo {
   visibilityState?: string
   documentFocused?: boolean
   /** registration "kind" — lets a single daemon host multiple surface
-   *  types. omitted / unknown defaults to 'sootsim'. the sootbean web
-   *  IDE registers with kind='sootbean'; CLI consumers filter by this
+   *  types. omitted / unknown defaults to 'sootsim'. the contrast web
+   *  IDE registers with kind='contrast'; CLI consumers filter by this
    *  rather than running a parallel bridge. */
   kind?: string
   /** opaque metadata supplied at register time (e.g. projectId, route,
-   *  attached iOS sim id for a sootbean tab). free-form by design — the
+   *  attached iOS sim id for a contrast tab). free-form by design — the
    *  daemon does not interpret it, only stores + reports it back. */
   meta?: Record<string, unknown>
 }
@@ -208,7 +208,7 @@ interface BridgeForwardedCommand {
 export interface BridgeHostOptions {
   port?: number
   openUrl?: (url: string, options?: OpenUrlOptions) => Promise<void> | void
-  /** soot-specific excludes for the agent host's dev-server scan. passed
+  /** Contrast-specific excludes for the agent host's dev-server scan. passed
    *  through to AgentHost; see packages/sootsim-engine/src/dev-scan-excludes.ts
    *  for the canonical list. when omitted, AgentHost reads env vars directly. */
   agentScanExcludes?: AgentHostOptions['getExcludePorts']
@@ -231,15 +231,15 @@ export interface BridgeHostOptions {
    *  fills in once the vite server is actually listening. only meaningful
    *  with writeDevLockfile. */
   getShellPort?: () => number | null
-  /** the sootbean origin this daemon's runtimes should talk to for auth,
+  /** the contrast origin this daemon's runtimes should talk to for auth,
    *  billing, and preview uploads — inlined into served runtime html as
-   *  `window.__sootsimSootbeanOrigin`. without it the engine's origin.ts
+   *  `window.__sootsimContrastOrigin`. without it the engine's origin.ts
    *  resolves the daemon's own loopback host (localhost:<runtimePort>) to
    *  the dev `localhost:3000` stack, so a *prod* CLI user's preview
    *  recording would upload to a localhost stack that doesn't exist. the
    *  `sootsim serve` command resolves this with the same probe the
    *  upload itself uses (`resolveDefaultUploadOrigin`). */
-  sootbeanOrigin?: string
+  contrastOrigin?: string
   /** override the abandoned-sim GC TTL (ms). defaults to
    *  SIM_IDLE_REAP_TTL_MS (30 min). exists so the reaper integration test
    *  can drive the real timer path deterministically instead of mocking
@@ -302,7 +302,7 @@ const HTTP_MIME_TYPES: Record<string, string> = {
  *     hardcode the 7668 default in `resolveBridgePort` and register on a
  *     *different* daemon (or none), so `sootsim open` times out waiting for
  *     a sim that connected to the wrong bridge.
- *   - `window.__sootsimSootbeanOrigin` — the sootbean origin for auth /
+ *   - `window.__sootsimContrastOrigin` — the contrast origin for auth /
  *     billing / preview uploads. the daemon serves runtimes from its own
  *     loopback host, and engine `origin.ts` otherwise resolves any
  *     loopback host to the dev `localhost:3000` stack — so without this a
@@ -311,7 +311,7 @@ const HTTP_MIME_TYPES: Record<string, string> = {
 export function injectSharedConfigIntoHtml(
   data: Buffer,
   bridgePort: number,
-  sootbeanOrigin: string | null,
+  contrastOrigin: string | null,
 ): string {
   let payload: string
   try {
@@ -321,13 +321,13 @@ export function injectSharedConfigIntoHtml(
     payload = '{}'
   }
   const bridgePortTag = bridgePort > 0 ? `window.__sootsimBridgePort=${bridgePort};` : ''
-  const sootbeanOriginTag = sootbeanOrigin
-    ? `window.__sootsimSootbeanOrigin=${JSON.stringify(sootbeanOrigin)};`
+  const contrastOriginTag = contrastOrigin
+    ? `window.__sootsimContrastOrigin=${JSON.stringify(contrastOrigin)};`
     : ''
   const tag =
     `<script>window.__sootsimSharedConfig=${payload};` +
     bridgePortTag +
-    sootbeanOriginTag +
+    contrastOriginTag +
     `window.__sootsimCliVersion=${JSON.stringify(getCliVersion())};</script>`
   const html = data.toString('utf8')
   if (html.includes('<head>')) return html.replace('<head>', `<head>${tag}`)
@@ -405,7 +405,7 @@ export class SootSimBridgeHost {
   private shouldWriteLockfile: boolean
   private shouldWriteDevLockfile: boolean
   private getShellPort: (() => number | null) | null
-  private sootbeanOrigin: string | null = null
+  private contrastOrigin: string | null = null
   private effectivePort = 0
   private startedAt = 0
   private heartbeatTimer: NodeJS.Timeout | null = null
@@ -462,7 +462,7 @@ export class SootSimBridgeHost {
           : null
       },
     })
-    this.sootbeanOrigin = opts.sootbeanOrigin?.replace(/\/$/, '') || null
+    this.contrastOrigin = opts.contrastOrigin?.replace(/\/$/, '') || null
     this.simIdleReapTtlMs =
       opts.simIdleReapTtlMs ?? SootSimBridgeHost.SIM_IDLE_REAP_TTL_MS
     this.automationSimIdleReapTtlMs =
@@ -708,9 +708,9 @@ export class SootSimBridgeHost {
 
         // Browsers always send an Origin header, but the IDE needs a second,
         // short-lived CLI-role socket to route typed app_* calls to an
-        // sb-dev-owned external runtime driver. `bridge:hello` is already the
-        // CLI handshake, so let it correct the provisional Origin-based role
-        // before this socket has registered a page. This reuses the existing
+        // Contrast-dev-owned external runtime driver. `bridge:hello` is
+        // already the CLI handshake, so let it correct the provisional
+        // Origin-based role before this socket has registered a page. This reuses the existing
         // daemon transport and call envelope; it does not add a second routing
         // surface or let a registered sim switch roles mid-connection.
         if (role === 'sim' && msg.type === 'bridge:hello' && sim && !sim.url) {
@@ -1219,7 +1219,7 @@ export class SootSimBridgeHost {
   private refreshActiveRuntime() {
     this.activeRuntimeVersion = readActiveRuntime()
     // mode boundary (see runtime-assets resolveDevCheckoutRuntimeRoot): inside
-    // the soot monorepo dev checkout serve the fresh dev-stack build so local
+    // the Contrast monorepo dev checkout serve the fresh dev-stack build so local
     // engine edits reach previews without a publish; otherwise the installed
     // runtime. the version above stays the installed version for display.
     this.activeRuntimeDirPath = resolveDevCheckoutRuntimeRoot() ?? getActiveRuntimeDir()
@@ -1399,7 +1399,7 @@ export class SootSimBridgeHost {
     // ("render worker crashed during boot" / "app:one surface registration
     // failed"). SAB powers the shell-scene fast channel and the worklet
     // runtime's SharedValues. mirrors sootsim-shell/vite.config.ts (dev) and
-    // sootbean.com app/_middleware.ts (prod) so the cli daemon serves the
+    // contrast.dev app/_middleware.ts (prod) so the cli daemon serves the
     // same surface those two already enforce. set via setHeader so subsequent
     // writeHead() calls preserve them (writeHead only overrides keys it
     // explicitly passes). Safari/iOS WebKit does not isolate documents for
@@ -1683,7 +1683,7 @@ export class SootSimBridgeHost {
               return
             }
             res.end(
-              injectSharedConfigIntoHtml(data, this.effectivePort, this.sootbeanOrigin),
+              injectSharedConfigIntoHtml(data, this.effectivePort, this.contrastOrigin),
             )
           })
           return
@@ -1714,7 +1714,7 @@ export class SootSimBridgeHost {
               return
             }
             res.end(
-              injectSharedConfigIntoHtml(data, this.effectivePort, this.sootbeanOrigin),
+              injectSharedConfigIntoHtml(data, this.effectivePort, this.contrastOrigin),
             )
           })
           return

package/src/native-dev-bundle-url.ts

@@ -13,7 +13,7 @@ function isNativeDevBundlePath(pathname: string): boolean {
   return pathname.endsWith('.bundle')
 }
 
-// opt-in (sootbot preview-recording context only): serve a production
+// opt-in (contrastbot preview-recording context only): serve a production
 // minified bundle instead of the default dev=true unminified one. a
 // preview run just records the app — it never needs fast-refresh or dev
 // warnings — and the ~28MB unminified dev bundle cold-(re)boots
@@ -33,7 +33,7 @@ function applyPreviewProdBundle(parsed: URL): void {
 export function normalizeNativeDevBundleUrl(bundleUrl: string): string {
   try {
     const isAbsolute = isAbsoluteHttpUrl(bundleUrl)
-    const parsed = new URL(bundleUrl, 'http://soot.local')
+    const parsed = new URL(bundleUrl, 'http://sootsim.local')
     parsed.pathname = parsed.pathname.replace(/\.\.bundle$/, '.bundle')
     if (!isNativeDevBundlePath(parsed.pathname)) return bundleUrl
     // do NOT force dev=true or minify=false — metro's dev server already
@@ -85,7 +85,7 @@ export function normalizeNativeDevBundleUrl(bundleUrl: string): string {
 export function applyHotMode(bundleUrl: string, hot: boolean): string {
   try {
     const isAbsolute = isAbsoluteHttpUrl(bundleUrl)
-    const parsed = new URL(bundleUrl, 'http://soot.local')
+    const parsed = new URL(bundleUrl, 'http://sootsim.local')
     if (!isNativeDevBundlePath(parsed.pathname)) return bundleUrl
     parsed.searchParams.set('hot', hot ? 'true' : 'false')
     if (isAbsolute) return parsed.toString()

package/src/runtime-assets.ts

@@ -12,7 +12,7 @@ export const SOOTSIM_RUNTIME_MISSING_MESSAGE =
 
 // --- dev-checkout mode boundary --------------------------------------------
 //
-// there is exactly one rule for which engine gets served: INSIDE the soot
+// there is exactly one rule for which engine gets served: INSIDE the Contrast
 // monorepo dev checkout the fresh dev-stack build (public/sootsim, kept current
 // by `bun dev`'s watch:sootsim) IS the engine; OUTSIDE it (a published CLI in a
 // user's project, or an isolated home) the installed runtime IS. this is a mode
@@ -33,7 +33,7 @@ let _monorepoRootCache: string | null | undefined
 function findMonorepoRoot(): string | null {
   if (_monorepoRootCache !== undefined) return _monorepoRootCache
   let dir = path.dirname(fileURLToPath(import.meta.url))
-  // walk up until we find the soot monorepo: it has packages/sootsim-engine and
+  // walk up until we find the Contrast monorepo: it has packages/sootsim-engine and
   // a public/sootsim dev-build output slot. bounded by the filesystem root.
   for (let i = 0; i < 12 && dir !== path.dirname(dir); i++) {
     if (
@@ -49,7 +49,7 @@ function findMonorepoRoot(): string | null {
   return null
 }
 
-/** the fresh dev-stack engine build to serve when running inside the soot
+/** the fresh dev-stack engine build to serve when running inside the Contrast
  *  monorepo dev checkout, or null when the installed runtime should serve
  *  (published CLI, packaged electron, or an isolated SOOTSIM_HOME). */
 export function resolveDevCheckoutRuntimeRoot(): string | null {

package/src/runtime-delivery.ts

@@ -14,7 +14,7 @@ import {
   writeActiveRuntime,
 } from './home-paths'
 
-export const DEFAULT_RUNTIME_CDN_ORIGIN = 'https://sootbean.com'
+export const DEFAULT_RUNTIME_CDN_ORIGIN = 'https://contrast.dev'
 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'
@@ -37,7 +37,7 @@ export interface RuntimeManifest {
 
 /** website URL where the sootsim changelog is rendered. the CLI used to drain
  *  a paginated /api/changelog/sootsim endpoint here; the changelog is now a
- *  static page checked into the soot repo (one MDX file per runtime release
+ *  static page checked into the Contrast repo (one MDX file per runtime release
  *  under src/features/site/changelog/sootsim-entries/), so `sootsim runtime
  *  notes` points users at the page. */
 export const SOOTSIM_CHANGELOG_URL = 'https://sootsim.com/changelog'
@@ -137,7 +137,8 @@ export function resolveRuntimeVersion(
   opts: Pick<RuntimeInstallOptions, 'version' | 'channel'> = {},
 ): { version: string; channel: string; entry: RuntimeManifestVersion } {
   const channel = resolveRuntimeChannel(opts.channel)
-  const version = opts.version || resolveRuntimePin() || 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`,
@@ -242,7 +243,12 @@ export async function updateRuntimeToLatest(
         latestVersion: pin,
       }
     }
-    const install = await installRuntime({ version: pin, channel, cdnOrigin, setActive: false })
+    const install = await installRuntime({
+      version: pin,
+      channel,
+      cdnOrigin,
+      setActive: false,
+    })
     return {
       checked: true,
       updated: true,

package/src/screenshots/compose.ts

@@ -1,5 +1,6 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'fs'
 import path from 'path'
+import { launchReapedChrome } from '../../../../scripts/lib/reap-browser'
 import {
   DEFAULT_FRAME_SHADOW,
   toAssetKey,
@@ -346,7 +347,9 @@ export async function composeMarketingScreenshots(
     browserOverride ??
     (await (async () => {
       const { chromium } = await import('playwright')
-      return chromium.launch({ headless: true })
+      return launchReapedChrome((options) => chromium.launch(options), {
+        headless: true,
+      })
     })())
   try {
     const context = await browser.newContext({ viewport: { width: 1280, height: 720 } })

package/src/screenshots/frame-compose.ts

@@ -8,6 +8,7 @@ import {
   SIDE_BUTTON_RESERVE,
 } from 'sootsim-engine/ios/chrome-metrics'
 import { getDevice, type DeviceModel } from 'sootsim-engine/settings'
+import { launchReapedChrome } from '../../../../scripts/lib/reap-browser'
 
 const METALLIC_RING_SHADOW =
   'inset 0 0 0 0.5px #000, inset 0 0 0 2px #757575, inset 0 0 0 5px #212121'
@@ -363,7 +364,9 @@ export async function composeFramedScreenshot(
   model: DeviceModel,
 ): Promise<Buffer> {
   const { chromium } = await import('playwright')
-  const browser = await chromium.launch({ headless: true })
+  const browser = await launchReapedChrome((options) => chromium.launch(options), {
+    headless: true,
+  })
   try {
     const composer = await createFramedScreenshotComposer(browser)
     try {

package/src/screenshots/orchestrate.ts

@@ -1,6 +1,7 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'fs'
 import { tmpdir } from 'os'
 import path from 'path'
+import { launchReapedChrome } from '../../../../scripts/lib/reap-browser'
 import { runFlowPlayback } from '../../cli/commands/flow'
 import {
   composeMarketingScreenshots,
@@ -103,7 +104,9 @@ async function buildFramedSources(
     browserOverride ??
     (await (async () => {
       const { chromium } = await import('playwright')
-      return chromium.launch({ headless: true })
+      return launchReapedChrome((options) => chromium.launch(options), {
+        headless: true,
+      })
     })())
   try {
     const composer = await createFramedScreenshotComposer(browser)
@@ -204,7 +207,9 @@ export async function runScreenshotsPlan(
   const sharedBrowser = needsSharedBrowser
     ? await (async () => {
         const { chromium } = await import('playwright')
-        return chromium.launch({ headless: true })
+        return launchReapedChrome((options) => chromium.launch(options), {
+          headless: true,
+        })
       })()
     : null
   try {

package/src/vite-plugin-one.ts

@@ -18,7 +18,7 @@ import {
 } from './runtime-assets'
 import type { Plugin } from 'vite'
 
-export interface SootPluginOptions {
+export interface SootSimPluginOptions {
   // custom bundle URL (default: auto-detect from One's metro)
   bundleUrl?: string
   // path prefix (default: '/__soot')
@@ -27,7 +27,7 @@ export interface SootPluginOptions {
   enabled?: boolean
 }
 
-export function sootsimPlugin(options: SootPluginOptions = {}): Plugin[] {
+export function sootsimPlugin(options: SootSimPluginOptions = {}): Plugin[] {
   if (options.enabled === false) return []
 
   const prefix = options.prefix || '/__soot'
@@ -45,7 +45,7 @@ export function sootsimPlugin(options: SootPluginOptions = {}): Plugin[] {
         // app's bundle) AND window.__sootsimBridgePort. the bridge-port injection
         // mirrors the dev-stack bridge-host: without it the engine's
         // resolveBridgePort() falls back to a location-derived guess that mis-maps
-        // a non-soot app port (the mobile template's :4400 -> 9068) and the sim
+        // a non-Contrast app port (the mobile template's :4400 -> 9068) and the sim
         // can't reach the bridge. resolved per-request from the daemon lockfile
         // (the CLI's `open` writes/uses it before the shell loads) so the engine
         // targets the SAME bridge the CLI does; default port otherwise.

package/src/vite-plugin.ts

@@ -25,7 +25,7 @@ import { shouldApplyWorkletsPlugin, transformWorkletsCode } from './worklets-bab
 
 const sootsimPluginRequire = createRequire(import.meta.url)
 
-export interface SootOptions {
+export interface SootSimOptions {
   // directory of an external RN app to load
   app?: string
   // additional source directories to treat as app sources (metro transforms apply)
@@ -39,7 +39,7 @@ const sootsimRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '
 const workspaceRoot = path.resolve(sootsimRoot, '..', '..')
 const workspaceNodeModules = path.resolve(workspaceRoot, 'node_modules')
 const workspaceTamaguiDir = path.resolve(workspaceNodeModules, '@tamagui')
-// stubs and the mutable React bridge live in @soot/compat.
+// stubs and the mutable React bridge live in @sootsim/compat.
 const compatRoot = path.resolve(sootsimRoot, '..', 'compat')
 
 // the rendering engine and its shims live in the private sootsim-engine
@@ -235,7 +235,7 @@ function moduleExistsIn(pkgName: string, dir: string): boolean {
   }
 }
 
-export function sootsim(options: SootOptions = {}): Plugin[] {
+export function sootsim(options: SootSimOptions = {}): Plugin[] {
   const appDir = options.app ? path.resolve(options.app) : ''
   const extraSources = (options.sources || []).map((s) => path.resolve(s))
   const ownedPackages = new Set([...coreOwnedPackages, ...(options.ownedPackages || [])])

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

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

package/dist-cli/chunks/chunk-35EAEAN4.js

@@ -1,24 +0,0 @@
-/*! sootsim v0.1.227 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{c as f}from"./chunk-J7IFVTWX.js";import{a as C,d as x,f as F}from"./chunk-E75EBS77.js";import{M as y,N as w,O as I,P as B}from"./chunk-NU755HCE.js";import{WebSocket as k}from"ws";var S=null;function E(){return S||(S=O(),S)}function O(){let i=w();if(i&&B(i))return{source:"dev-bridge",bridgePort:i.bridgePort,shellBaseUrl:i.shellPort?`http://localhost:${i.shellPort}/`:f};let r=y();return r&&I(r)?{source:"daemon",bridgePort:r.bridgePort,shellBaseUrl:r.runtimePort>0?`http://localhost:${r.runtimePort}/`:f}:{source:"default",bridgePort:7668,shellBaseUrl:f}}function M(i){let r=w();if(r&&B(r)&&r.bridgePort===i)return{source:"dev-bridge",shellBaseUrl:r.shellPort?`http://localhost:${r.shellPort}/`:f};let e=y();return e&&I(e)&&e.bridgePort===i?{source:"daemon",shellBaseUrl:e.runtimePort>0?`http://localhost:${e.runtimePort}/`:f}:null}function J(i){let r;try{let l=new URL(i);r=l.port?Number(l.port):l.protocol==="https:"?443:80}catch{return null}if(!Number.isFinite(r)||r<=0)return null;let e=w();if(e&&B(e)&&(e.shellPort===r||e.runtimePort===r||e.bridgePort===r))return e.bridgePort;let d=y();return d&&I(d)&&(d.runtimePort===r||d.bridgePort===r)?d.bridgePort:null}function U(){return E().bridgePort}function G(i,r){let e=M(i),d=e?.source==="dev-bridge"?"dev bridge":e?.source==="daemon"?"daemon bridge":"bridge",l=e?`${e.source}.json`:"no lockfile",t=r??e?.shellBaseUrl;process.stderr.write(`  \u2192 ${d} :${i} (${t?`shell ${t}, `:""}${l})
-`)}var T=class extends Error{lock;constructor(r,e){super(r),this.name="BridgeSimLockedError",this.lock=e}};function _(i){return i==="flag"?"via --sim":i==="saved"?"saved via `sootsim use`":"primary fallback \u2014 no sim pinned"}function K(i,r={}){let e=new Set,d=r.port??U(),l=r.commandTimeoutMs??15e3,t,m="none",P=new Set(r.stripBooleanFlags??[]),h=new Set(r.stripValueFlags??[]);for(let n=0;n<i.length;n++){let a=i[n];if(a==="--port"||a==="-p"){e.add(n),n+1<i.length&&(e.add(n+1),d=Number(i[n+1])),n++;continue}if(a.startsWith("--port=")){e.add(n),d=Number(a.slice(7));continue}if(a==="--timeout"){e.add(n),n+1<i.length&&(e.add(n+1),l=Number(i[n+1])),n++;continue}if(a==="--sim"||a==="--session"||a==="--tab"){e.add(n),n+1<i.length&&(e.add(n+1),t=i[n+1]?.trim()||void 0,m="flag"),n++;continue}let s=a.startsWith("--sim=")?a.slice(6):a.startsWith("--session=")?a.slice(10):a.startsWith("--tab=")?a.slice(6):void 0;if(s!==void 0){e.add(n),t=s.trim()||void 0,m="flag";continue}if(P.has(a)){e.add(n);continue}h.has(a)&&(e.add(n),n+1<i.length&&e.add(n+1),n++)}if(!t){let n=x();n&&(t=n.trim()||void 0,m="saved")}return{positional:i.filter((n,a)=>!e.has(a)),wsPort:d,simId:t,simIdSource:m,commandTimeoutMs:l}}function N(i,r={}){let e=1,d=r.commandTimeoutMs??15e3,l=new Map,t=new k(`ws://localhost:${i}`),m=C(),P=new Promise((s,o)=>{t.on("open",()=>{try{t.send(JSON.stringify({type:"bridge:hello",id:0,cliIdentityKey:m.key,cliIdentitySource:m.source,cliLabel:r.cliLabel}))}catch{}s()}),t.on("error",c=>{let g=c.message?`: ${c.message}`:"";o(new Error(`could not connect to ws://localhost:${i}${g}`))})}),h=!1,n=!1;function a(s,o){if(n||process.env.SOOTSIM_QUIET_TARGET_NOTICE==="1"||s.startsWith("bridge:")||s==="focus"||s==="close")return;n=!0;let c=o??"primary",g=_(o?r.simIdSource:"none");process.stderr.write(`  \u2192 ${c} (${g})
-`)}return t.on("message",s=>{let o;try{o=JSON.parse(s.toString())}catch{return}if(o.id===0)return;let c=l.get(o.id);c&&(l.delete(o.id),o._otherCliCount>0&&!h&&(h=!0,process.stderr.write(`
-  \u26A0 ${o._otherCliCount} other CLI identity/identities are driving this sim
-  taps, scrolls, and keyboard input from multiple agents will collide on
-  the same screen state (this is not a bridge throughput limit).
-  use \`sootsim open --new\` for an isolated sim per agent.
-
-`)),o.error?o._locked?c.reject(new T(o.error,o._locked)):c.reject(new Error(o.error)):c.resolve(o.result))}),t.on("close",(s,o)=>{let c=o?.toString()||"connection closed";for(let[g,u]of l)l.delete(g),u.reject(new Error(`sim disconnected: ${c} (code ${s})`))}),{async send(s,o){let c=o?.timeoutMs??d,g=async u=>{await P;let b=e++;return new Promise((A,W)=>{let $=setTimeout(()=>{l.delete(b),W(new Error(`command timed out after ${Math.round(c/1e3)}s`))},c);l.set(b,{resolve:v=>{clearTimeout($),A(v)},reject:v=>{clearTimeout($),W(v)}});let p={...s,id:b};p.simId===void 0&&u&&(p.simId=u),a(s.type??"",p.simId),t.send(JSON.stringify(p))})};try{return await g(r.simId)}catch(u){let b=u instanceof Error?u.message:String(u);throw r.simIdSource==="saved"&&r.simId&&s.simId===void 0&&b===`no sim connected with id ${r.simId}`?(F(),new Error(`saved sim ${r.simId} is gone; run \`sootsim list\` and \`sootsim use <sim>\`, or open a fresh sim`)):u}},async listSims(){let s=await this.send({type:"bridge:list-sims"});return Array.isArray(s)?s:[]},async openUrl(s,o={}){return this.send({type:"bridge:open",url:s,newWindow:o.newWindow===!0})},async focusSim(s){return this.send({type:"focus",simId:s})},async closeSim(s){return this.send({type:"close",simId:s})},async claim(s,o={}){return await this.send({type:"bridge:claim",simId:s,force:o.force===!0})},close(){try{t.readyState===k.OPEN&&t.send(JSON.stringify({type:"bridge:bye",id:0}))}catch{}t.close();let s=setTimeout(()=>{t.readyState!==k.CLOSED&&t.terminate()},250)}}}function Q(i){return N(i.wsPort,{commandTimeoutMs:i.commandTimeoutMs,simId:i.simId,simIdSource:i.simIdSource})}function R(i,r){let e=i.filter(t=>t.readyState==="open"&&t.id!==r),d=e.find(t=>t.userFocused)??e.find(t=>t.userVisible===!0&&t.isPrimary)??e.find(t=>t.userVisible===!0)??e.find(t=>t.isPrimary);if(!d)return null;let l=[d.isPrimary?"primary":null,d.userVisible===!1?"hidden":d.userVisible===!0?"visible":null,d.userFocused?"focused":null].filter(Boolean);return`${d.id}${l.length?` [${l.join(", ")}]`:""}`}async function z(i){try{let r=await i.send({type:"evaluate",code:`(() => ({
-        hidden: document.hidden,
-        visibilityState: document.visibilityState,
-        hasFocus: typeof document.hasFocus === 'function' ? document.hasFocus() : null,
-        simId: window.__sootsimBridge?.id ?? window.SootSim?.state?.simId ?? null,
-        url: location.href
-      }))()`}),e=typeof r=="object"&&r!==null?r:{hidden:r===!0};if(e.hidden===!0===!0){let l=null;try{l=R(await i.listSims(),e.simId)}catch{}return process.stderr.write(`
-  \u26A0 target sim${e.simId?` ${e.simId}`:""} is hidden (document.hidden = true)
-`+(e.visibilityState?`  visibility: ${e.visibilityState}
-`:"")+`  animations and rAF callbacks are throttled \u2014 coordinates may be wrong
-  and launch/transition animations will not complete.
-`+(l?`  another open sim looks usable: ${l}; target it with --sim.
-`:"  run `sootsim list` to find the visible sim and target it with --sim.\n")+`  page-level window.focus() cannot unhide a browser tab.
-
-`),{hidden:!0,warned:!0,simId:e.simId}}return{hidden:!1,warned:!1,simId:e.simId}}catch{return{hidden:!1,warned:!1}}}async function X(i,r,e={}){let d={type:"evaluate",code:r};return e.acquireLock&&(d.acquireLock=!0),i.send(d)}async function Y(i,r,...e){return i.send({type:"call",path:r,args:e})}async function Z(i,r,...e){return i.send({type:"call",path:r,args:e,acquireLock:!0})}export{E as a,M as b,J as c,U as d,G as e,T as f,K as g,N as h,Q as i,z as j,X as k,Y as l,Z as m};