sootsim 0.1.135 → 0.1.137

package/README.md

@@ -1,32 +1,192 @@
-# SootSim
-
-CLI + framework plugins for SootBean's browser-native simulator.
-
-this package is the public, publishable face of SootSim. it contains:
-
-- `sootsim` CLI (bridge client — drives a running SootSim instance over
-  WebSocket for describing UI, tapping elements, recording flows, etc.)
-- `sootsim/vite` — vite plugin for wrapping an app bundler with SootSim
-- `sootsim/metro` — metro plugin for wrapping a react native bundler
-- `sootsim/skills` — registry for SootBean-flavored automation skills
-
-the rendering engine itself (canvas renderer, yoga layout, iOS/Android shell
-chrome, wasm, electron shell) lives in the private `sootsim-engine` workspace
-package and is not published.
-
-Platform status: iOS is the parity baseline. Android is bootstrapped and
-usable for focused conformance slices, with Android bundle/runtime identity,
-device profiles, initial shell chrome, gesture and three-button nav proof,
-Android system UI/window metrics with cutout-safe insets, and Android
-SootSim-only matrix runs.
-Android `react-native-screens`, `react-native-safe-area-context`,
-RefreshControl, keyboard/IME resize, EdgeEffect, scroll deceleration/fading
-edges/scrollbars, and basic system-bar API support are improving but still need
-the Android launch gates before this can be called full parity.
-It is not full Android parity until the Android launch gates in the SootBean repo
-plan pass.
+# sootsim
+
+The public, publishable face of SootSim: a CLI, two pairs of bundler plugins, a
+Detox/Maestro test surface, and a skills registry for driving a browser-native
+React Native simulator.
+
+## Overview
+
+`sootsim` is everything you install to *talk to* a SootSim instance — it
+contains **no rendering code**. The canvas engine (CanvasKit renderer, Yoga
+layout, iOS/Android shell chrome, Electron shell) lives in the private
+`sootsim-engine` workspace package and is shipped at runtime as a versioned
+tarball, fetched from the sootbean.com CDN and unpacked into `~/.sootsim`.
+
+What this package gives you:
+
+- the `sootsim` CLI — the primary debugging and automation surface (inspect the
+  UI tree, tap elements, capture flows, screenshot, record, run agents)
+- `sootsim/vite` and `sootsim/metro` — bundler plugins that serve the installed
+  engine runtime from your own dev server
+- `sootsim/detox` — a drop-in Detox driver + jest preset
+- `sootsim/sdk` — the inspect/interact verbs as a programmatic API
+- `sootsim/skills` — a registry of SootBean-flavored automation skills
+
+Platform status: iOS is the parity baseline. Android is bootstrapped and usable
+for focused conformance slices (bundle/runtime identity, device profiles, shell
+chrome, gesture + three-button nav, system UI/window metrics with cutout-safe
+insets) but is not full parity until the Android launch gates in the SootBean
+repo plan pass.
+
+## What's in this package (and what's not)
+
+| in `sootsim` | in `sootsim-engine` (private, not published) |
+| --- | --- |
+| CLI, bridge client, drivers | CanvasKit renderer, Yoga layout |
+| bridge daemon host (`SootSimBridgeHost`) | iOS/Android shell chrome, home grid, app switcher |
+| vite/metro plugins, RN resolver, native stubs | Electron shell, wasm |
+| Detox/Maestro runners, screenshots, skills | the actual pixels |
+
+The engine is delivered at runtime, never bundled into this package. A
+committed-but-unbuilt engine fix has no effect on a running sim until the
+runtime tarball is rebuilt and re-fetched.
+
+## Architecture
+
+The architecture is a **three-tier relay**: a short-lived CLI process, a single
+persistent bridge daemon, and the sim itself — a browser/Electron *page* that
+internally splits into a **shell worker** and a **tenant worker**.
+
+```mermaid
+graph TD
+  subgraph cli["sootsim CLI process (short-lived, cli/)"]
+    BIN["bin.ts (dispatcher + telemetry)"]
+    BOOT["auto-bootstrap.ts (ensure runtime + daemon)"]
+    INSPECT["commands/inspect/* (describe/find/do/get/wait)"]
+    FLOW["bridge-flow-runner.ts (maestro + flow)"]
+    DETOXCMD["commands/detox.ts + detox/ driver"]
+    SHOTS["commands/screenshot + record"]
+    AGENTCMD["commands/agent.ts"]
+    WSB["ws-bridge.ts (WsBridge client)"]
+    DRIVERS["drivers/* (chromium/electron/playwright/system)"]
+  end
+  subgraph daemon["bridge daemon process (persistent :7668)"]
+    HOST["SootSimBridgeHost (host/bridge-host.ts, HTTP+WS)"]
+    AGENTHOST["AgentHost (host/agent-host.ts, FIFO fan-out)"]
+    AGENTSESS["agent-sessions.ts + attached-projects.ts"]
+    SCAN["/__server-scan (dev-server-scanner.ts)"]
+    PROXY["fetch-proxy-handler + websocket-proxy"]
+    RTHTTP["runtime HTTP + self-update (runtime-delivery.ts)"]
+  end
+  subgraph sim["sim page (browser / Electron, launched by a driver)"]
+    SHELLW["shell worker (iOS chrome, home grid, app switcher)"]
+    TENANTW["tenant worker (guest RN app tree)"]
+  end
+  subgraph build["build-time plugins (src/)"]
+    VITEONE["sootsim/vite = vite-plugin-one.ts (serve runtime at /__soot/)"]
+    VITERN["sootsim() = vite-plugin.ts (RN resolver + native stubs)"]
+    METRO["sootsim/metro = metro-plugin.ts"]
+    COMPAT["@soot/compat stub-manifest (native seams)"]
+    ENGINESHIM["sootsim-engine react-native shim"]
+  end
+  SKILLS["sootsim/skills registry.ts (builtin skills)"]
+  subgraph fs["~/.sootsim (home-paths.ts)"]
+    RTDIR["runtimes/<version>/ (engine assets)"]
+    LOCK["daemon.json lockfile"]
+    CFG["config.json"]
+  end
+  CDN["sootbean.com CDN (runtimes/manifest.json + tarballs)"]
+  BIN --> BOOT
+  BIN --> INSPECT
+  BIN --> FLOW
+  BIN --> DETOXCMD
+  BIN --> SHOTS
+  BIN --> AGENTCMD
+  BOOT --> RTDIR
+  BOOT --> LOCK
+  BOOT -->|"fetch runtime"| CDN
+  BOOT -->|"register launchd/systemd"| HOST
+  INSPECT --> WSB
+  FLOW --> WSB
+  SHOTS --> WSB
+  AGENTCMD --> WSB
+  DETOXCMD --> DRIVERS
+  DETOXCMD --> WSB
+  WSB -->|"JSON WS cmds"| HOST
+  HOST -->|"forward to registered sim"| SHELLW
+  SHELLW -->|"replies + pushes"| HOST
+  HOST -->|"relayed results"| WSB
+  HOST --> AGENTHOST
+  AGENTHOST --> AGENTSESS
+  AGENTCMD --> AGENTHOST
+  HOST --> SCAN
+  HOST --> PROXY
+  HOST --> RTHTTP
+  RTHTTP --> RTDIR
+  RTHTTP -->|"manifest + tarball"| CDN
+  DRIVERS -->|"open sim page URL"| SHELLW
+  SHELLW -->|"NativeUIRequest"| TENANTW
+  VITEONE -->|"serve /__soot/ from"| RTDIR
+  METRO -->|"serve /__soot/ from"| RTDIR
+  VITEONE -.->|"launch electron app"| SHELLW
+  VITERN -->|"alias react-native"| ENGINESHIM
+  VITERN -->|"alias native pkgs"| COMPAT
+  VITERN -->|"dev server hosts"| HOST
+  SKILLS --> INSPECT
+```
 
-## getting started
+**The CLI process** (`cli/bin.ts`) parses argv, emits invocation telemetry, and
+lazy-imports exactly one command module per run. Runtime commands first call
+`auto-bootstrap.ts`, which guarantees the engine runtime is unpacked under
+`~/.sootsim/runtimes/<version>` (fetching from the sootbean.com CDN via
+`runtime-delivery.ts` when missing) and that the bridge daemon is registered
+with launchd/systemd and reachable. Interactive verbs then open a `WsBridge`
+(`cli/ws-bridge.ts`) to the daemon on **port 7668** and send JSON commands.
+Inspection/interaction verbs live in `cli/commands/inspect/*` and are
+re-exported as the programmatic `sootsim/sdk`; the Maestro/flow runner is
+`cli/bridge-flow-runner.ts`; the Detox compat driver is in `detox/`. Test and
+screenshot paths additionally use `cli/drivers/*` (chromium, electron,
+playwright, system) to actually launch or attach the sim page before driving it.
+
+**The daemon is one process** — `SootSimBridgeHost` (`src/host/bridge-host.ts`).
+`sootsim server` runs it in the foreground; `sootsim daemon` is the *same
+process* wrapped with autostart and the `~/.sootsim/daemon.json` lockfile. It is
+an HTTP+WS hub: sims register over WS, CLI clients connect to drive them, and
+the host forwards each command to the targeted sim and relays the reply back. It
+also serves the engine runtime over HTTP (with a self-update route), exposes
+`/__server-scan` to discover local metro/expo/vxrn/one dev servers, and proxies
+guest-app fetch/WebSocket traffic so the cross-origin tenant worker can reach
+localhost. The `AgentHost` extension owns one FIFO reader per agent session and
+fans agent events out to every subscriber.
+
+**The sim** is a browser/Electron *page* launched by a CLI driver. Inside that
+page run two workers: the **shell worker** renders iOS chrome (home grid, app
+switcher) and the **tenant worker** runs the guest RN tree, sending native-UI
+requests up to the shell over `NativeUIRequest`. The bridge always addresses the
+**shell worker**, never an undifferentiated sim. (Never say "main" unqualified —
+distinguish the host page thread, the shell worker, and the tenant worker.)
+
+**Two distinct plugin families** round it out, and they must not be conflated:
+
+- The published **`sootsim/vite`** (`src/vite-plugin-one.ts`, `sootsimPlugin`)
+  and **`sootsim/metro`** plugins do one thing: serve the installed runtime at
+  `/__soot/` so an app's own dev server can host the sim shell (the vite plugin
+  can also launch the Electron app).
+- The internal **`sootsim()`** plugin (`src/vite-plugin.ts`) is a separate, much
+  larger RN-resolution / native-stub plugin: it aliases `react-native` to the
+  engine shim and native packages to `@soot/compat` stubs, applies worklets
+  transforms, and is the one that instantiates `SootSimBridgeHost` inside its
+  own dev server. It is used to build the engine/shell and to load external RN
+  apps — it is **not** the published `sootsim/vite` export.
+
+## Key components
+
+| component | role | key files |
+| --- | --- | --- |
+| sootsim CLI (bin + dispatcher) | Short-lived terminal entry point. Parses argv, emits telemetry, lazy-imports one command per run, and on runtime commands first runs auto-bootstrap to ensure the runtime + daemon exist before connecting. | `cli/bin.ts`, `cli/parse-args.ts`, `cli/auto-bootstrap.ts`, `cli/help.ts` |
+| WsBridge client | Client side of the CLI→daemon link. Resolves the daemon port from the lockfile, opens a WS to `:7668`, sends JSON commands and awaits `{id,result}`/`{id,error}`. Used by every interactive command. | `cli/ws-bridge.ts`, `src/bridge-constants.ts`, `cli/current-sim.ts` |
+| inspect / SDK command surface | Runtime inspection + interaction verbs (describe, find, do tap, get errors, wait, layout, settle). Re-exported as `sootsim/sdk` so programmatic callers drive a sim the same way the CLI does. | `cli/commands/inspect/core.ts`, `cli/commands/inspect/actions.ts`, `cli/commands/inspect.ts`, `src/sdk.ts` |
+| flow / maestro / detox runners | Drop-in test compatibility. `bridge-flow-runner.ts` runs maestro-format YAML and recorded flows over the bridge; `detox/` provides a `by`/`element`/`expect`/`device` driver + jest preset so existing Detox suites run unchanged. | `cli/bridge-flow-runner.ts`, `cli/commands/maestro.ts`, `cli/commands/detox.ts`, `detox/index.ts`, `detox/jest-preset.cjs` |
+| sim drivers | Launch/attach the actual sim page. The registry resolves a driver (chromium, electron, playwright, system browser) which opens the shell URL; used by detox/preview/screenshot paths to bring a sim online for the bridge. | `cli/drivers/index.ts`, `cli/drivers/registry.ts`, `cli/drivers/chromium.ts`, `cli/drivers/electron.ts`, `cli/drivers/playwright.ts` |
+| SootSimBridgeHost (server/daemon) | The single persistent process (`sootsim server`, autostarted as the daemon via launchd/systemd). HTTP+WS hub on `:7668`: relays commands between CLI clients and registered sims; also serves runtime HTTP, `/__server-scan`, and fetch/WS proxies. | `src/host/bridge-host.ts`, `cli/commands/server.ts`, `cli/commands/daemon.ts`, `src/home-paths.ts` |
+| AgentHost + sessions | Agent-routing extension of the host: owns the single FIFO reader per agent session and fans `agent:event`/`session-status` pushes to every WS subscriber. Backed by agent-sessions + attached-projects stores. | `src/host/agent-host.ts`, `src/agent-sessions.ts`, `src/attached-projects.ts`, `src/agent-daemon-client.ts` |
+| host proxies + dev-server scan | Host-side helpers so a cross-origin tenant worker can reach local dev servers and same-origin APIs: `/__server-scan` discovers running metro/expo/vxrn/one servers; fetch + websocket proxies relay guest-app network through the daemon. | `src/host/fetch-proxy-handler.ts`, `src/host/websocket-proxy.ts`, `scripts/dev-server-scanner.ts`, `src/dev-bundle-resolution.ts` |
+| runtime delivery + sootsim home | Versioned engine runtime management. Resolves the CDN origin (`https://sootbean.com`), fetches `runtimes/manifest.json` + the runtime tarball, verifies sha256, unpacks to `~/.sootsim/runtimes/<version>`, and tracks active version/config/daemon lockfile under the sootsim home. | `src/runtime-delivery.ts`, `src/home-paths.ts`, `src/runtime-assets.ts`, `scripts/postinstall.cjs` |
+| `sootsim/vite` + `sootsim/metro` (runtime serving) | Published bundler plugins. Both serve the installed engine runtime at `/__soot/` from `~/.sootsim/runtimes/<version>` so an app's own dev server can host the sim shell; the vite plugin can also launch the Electron app. | `src/vite-plugin-one.ts`, `src/metro-plugin.ts`, `src/runtime-assets.ts` |
+| `sootsim()` vite resolver plugin (internal) | The large RN-resolution / native-stub vite plugin: aliases `react-native` to the engine shim, native packages to `@soot/compat` stubs, applies worklets/babel transforms, and instantiates `SootSimBridgeHost` in its dev server. Distinct from the published `sootsim/vite` export. | `src/vite-plugin.ts`, `src/worklets-babel.ts`, `packages/compat/src/stub-manifest.ts` |
+| skills registry | SootBean-flavored automation skills (a11y-review, compat-check, perf-profile, screenshot-all, test-flow, visual-diff) discoverable by trigger; published as `sootsim/skills` and loadable from a project manifest. | `src/skills/registry.ts`, `src/skills/types.ts`, `skills/soot.md` |
+
+## Getting started
 
 ```sh
 npm i -g sootsim
@@ -34,18 +194,17 @@ cd my-app && sootsim setup-repo
 sootsim open 8081          # load a running metro/expo dev server
 ```
 
-that's the canonical path — CLI first. the bridge daemon registers itself on
-first use; you don't need to run anything to install it. a desktop GUI
-(Electron) is optional on top of that, see `sootsim install-desktop`.
-In Electron, `File > New Window` duplicates the focused simulator, while
-`File > New Simulator >` opens a new simulator window for a selected device
-using the same device list as `Window >`.
+CLI-first is the canonical path. The bridge daemon registers itself on first use
+— you don't need to start anything to install it. A desktop GUI (Electron) is
+optional on top, via `sootsim install-desktop`. In Electron, `File > New Window`
+duplicates the focused simulator, while `File > New Simulator >` opens a new
+window for a selected device (same device list as the `Window >` menu).
 
 ## CLI
 
-the CLI is the primary debugging surface for SootSim. use it first for runtime
+The CLI is the primary debugging surface for SootSim — use it first for runtime
 inspection, interaction, animation debugging, shell tracing, screenshots, and
-flow capture instead of treating it as a test-only tool.
+flow capture, not just as a test runner.
 
 ```sh
 bun sootsim list              # connected tabs
@@ -65,33 +224,55 @@ bun sootsim flow end --output flows/login.yaml
 bun sootsim test --detox      # shared Detox-style parity suite against sootsim
 ```
 
-see the full command reference via `bun sootsim --help` or at
+See the full command reference via `bun sootsim --help` or at
 `src/features/site/docs/sootsim/cli/` in the SootBean repo.
 
-## coming from detox
+## Bundler plugins (`sootsim/vite` and `sootsim/metro`)
+
+These serve the installed engine runtime from your own dev server. They do
+**not** resolve React Native or stub native modules — that is the internal
+`sootsim()` plugin's job (see Architecture).
+
+```ts
+// vite.config.ts
+import { sootsimPlugin } from 'sootsim/vite'
+
+export default {
+  plugins: [sootsimPlugin()],
+}
+```
+
+```js
+// metro.config.js
+const { withSootsim } = require('sootsim/metro')
+
+module.exports = withSootsim({ /* your metro config */ })
+```
 
-SootSim ships a drop-in detox driver. your existing detox test files
-(`import { by, element, expect, device } from 'detox'`) run against SootSim
-with no code changes — just add one line to your jest config:
+## Coming from Detox
+
+SootSim ships a drop-in Detox driver. Existing Detox test files
+(`import { by, element, expect, device } from 'detox'`) run against SootSim with
+no code changes — just add one line to your jest config:
 
 ```js
 // jest config
 { preset: 'sootsim/detox/jest-preset' }
 ```
 
-or use the CLI directly:
+Or use the CLI directly:
 
 ```sh
 bun sootsim detox            # auto-discovers e2e/ tests and launches a shell
 bun sootsim detox init       # scaffold a config + sample test
 ```
 
-see `docs/migrating-from-detox.md` for details.
+See `../../docs/migrating-from-detox.md` for details.
 
-## coming from maestro
+## Coming from Maestro
 
-SootSim's flow runner natively speaks maestro's YAML format. point it at your
-existing `.maestro/` directory:
+SootSim's flow runner natively speaks Maestro's YAML. Point it at your existing
+`.maestro/` directory:
 
 ```sh
 bun sootsim maestro                      # discover .maestro/ and run all flows
@@ -99,13 +280,14 @@ bun sootsim maestro test .maestro/       # explicit
 bun sootsim maestro --list-compat        # see the verb support matrix
 ```
 
-most maestro verbs work out of the box (`tapOn`, `assertVisible`, `inputText`,
-`scrollUntilVisible`, `launchApp`, `when:`, `repeat`, `runFlow`, …). verbs that
-need real device hardware (GPS, radio, photo library) throw a clear error.
+Most Maestro verbs work out of the box (`tapOn`, `assertVisible`, `inputText`,
+`scrollUntilVisible`, `launchApp`, `when:`, `repeat`, `runFlow`, …). Verbs that
+need real device hardware (GPS, radio, photo library) throw a clear error. See
+`../../docs/migrating-from-maestro.md` for the full compat matrix.
 
-see `docs/migrating-from-maestro.md` for the full compat matrix.
+## Screenshots and recordings
 
-for animation-heavy debugging, the useful path is usually:
+For animation-heavy debugging, the useful path is usually:
 
 ```sh
 bun sootsim debug enable animated
@@ -119,11 +301,9 @@ bun sootsim record --duration 5 --output /tmp/sootsim-anim.mp4
 ```
 
 `sootsim screenshot --with-frame` composes the real SootSim shell device chrome
-around the raw screen bitmap. it reuses the shell bezel/button geometry and
-still excludes the electron top bar, rail gutter, and other window chrome.
-
-flows can use the same framed export path without changing normal maestro
-syntax:
+around the raw screen bitmap (reusing the shell bezel/button geometry, excluding
+the Electron top bar, rail gutter, and other window chrome). Flows can request
+the framed export inline without changing Maestro syntax:
 
 ```yaml
 - takeScreenshot: hero
@@ -132,7 +312,7 @@ syntax:
     withFrame: true
 ```
 
-for plan-driven app-store exports, use `sootsim screenshots`:
+For plan-driven app-store exports, use `sootsim screenshots`:
 
 ```yaml
 app: 8081
@@ -158,11 +338,12 @@ compose:
 bun sootsim screenshots --plan .sootsim/app-store.yaml
 ```
 
-the plan runner can reuse a visible sim for capture (`--sim a9`),
-stop after raw/framed intermediates (`--capture-only`), or rerender final
-marketing canvases from an existing raw directory (`--compose-only`).
-
-if your flow already writes screenshots to explicit project paths, set:
+The plan runner can reuse a visible sim for capture (`--sim a9`), stop after
+raw/framed intermediates (`--capture-only`), or rerender final marketing
+canvases from an existing raw directory (`--compose-only`). If your flow already
+writes screenshots to explicit project paths, set `from:` + `pathMode: flow` so
+`sootsim screenshots` respects the flow's own `takeScreenshot` paths instead of
+prepending `--screenshots <rawDir>`:
 
 ```yaml
 capture:
@@ -171,53 +352,56 @@ capture:
   pathMode: flow
 ```
 
-that tells `sootsim screenshots` to respect the flow's own `takeScreenshot`
-paths instead of prepending `--screenshots <rawDir>`.
-
-in the browser shell, `Screenshot Mode` now turns the live shell into a simple
-DOM composition surface: the rail + mac menu bar disappear, the device shifts
-down with a short transition, and editable title/subtitle fields appear above
-the frame for quick art-direction passes.
+In the browser shell, `Screenshot Mode` turns the live shell into a simple DOM
+composition surface: the rail + mac menu bar disappear, the device shifts down
+with a short transition, and editable title/subtitle fields appear above the
+frame for quick art-direction passes.
 
-## registry and docs source of truth
+## Skills registry
 
-the published CLI registry and the generated website docs both come from
-`packages/sootsim-skills/`.
+`sootsim/skills` is a registry of SootBean-flavored automation skills
+(a11y-review, compat-check, perf-profile, screenshot-all, test-flow,
+visual-diff) discoverable/matchable by trigger and loadable from a project
+manifest. The published CLI registry and the generated website docs both come
+from `packages/sootsim-skills/`:
 
 - `packages/sootsim/skills/soot.md` is generated from that registry
-- `src/features/site/docs/sootsim/cli/*` is generated output, not hand-edited source
+- `src/features/site/docs/sootsim/cli/*` is generated output, not hand-edited
 
-when command docs or examples drift, update `packages/sootsim-skills/` and run:
+When command docs or examples drift, update `packages/sootsim-skills/` and run:
 
 ```sh
 bun run generate:sootsim-docs
 ```
 
-## usage in a framework
+## Runtime delivery (the sootsim home and CDN)
 
-```ts
-// vite.config.ts
-import { sootsimPlugin } from 'sootsim/vite'
+The engine never ships inside this package. `auto-bootstrap.ts` →
+`runtime-delivery.ts` resolves the CDN origin (default `https://sootbean.com`,
+overridable in `config.json`), fetches `runtimes/manifest.json` + the runtime
+tarball, verifies its sha256, and unpacks it under `~/.sootsim`:
 
-export default {
-  plugins: [sootsimPlugin()],
-}
 ```
-
-```js
-// metro.config.js
-const { withSootsim } = require('sootsim/metro')
-
-module.exports = withSootsim({ /* your metro config */ })
+~/.sootsim/
+├── runtimes/
+│   └── <version>/        unpacked engine assets (served at /__soot/)
+├── daemon.json           lockfile: pid, ports, active runtime, heartbeat
+└── config.json           user prefs: update channel, cdn origin override
 ```
 
-## development
+The bridge daemon serves these assets over HTTP and exposes a self-update route;
+`sootsim upgrade` / `sootsim runtime` drive explicit version changes from the
+CLI side.
+
+## Development and building
 
-this package is part of the SootBean monorepo. to build the CLI bundle:
+This package is part of the SootBean monorepo. To build the published CLI bundle:
 
 ```sh
 bun run build:cli
 ```
 
-the output is `dist-cli/bin.js`, a single esbuild output that gets published
-as the `sootsim` npm bin.
+The output is `dist-cli/bin.js` — a single esbuild output published as the
+`sootsim` npm bin. Library exports build to `dist-lib/` (consumed via the
+`exports` map: `.`, `./vite`, `./metro`, `./sdk`, `./skills`, `./detox`, and the
+host/agent helpers). `bun run pack:smoke` validates the publishable tarball.

package/dist-cli/bin.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-/*! sootsim v0.1.135 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as u,b as d,c as g}from"./chunks/chunk-5HFMOWG3.js";import"./chunks/chunk-45Z6VTEC.js";function f(a){let e=a instanceof Error?a.message:String(a);(/^command timed out after \d+s$/.test(e)||e.startsWith("sim disconnected:")||e.startsWith("bridge never reconnected")||e.startsWith("no sim connected with id ")||e.startsWith("could not connect to ws://")||e.startsWith("sootsim bridge daemon is not running")||e.startsWith("refusing to install the persistent sootsim daemon"))&&!process.env.SOOTSIM_VERBOSE&&(process.stderr.write(`  ${e}
+/*! sootsim v0.1.137 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{a as u,b as d,c as g}from"./chunks/chunk-VPS5IHVH.js";import"./chunks/chunk-VTZMWNB5.js";function f(a){let e=a instanceof Error?a.message:String(a);(/^command timed out after \d+s$/.test(e)||e.startsWith("sim disconnected:")||e.startsWith("bridge never reconnected")||e.startsWith("no sim connected with id ")||e.startsWith("could not connect to ws://")||e.startsWith("sootsim bridge daemon is not running")||e.startsWith("refusing to install the persistent sootsim daemon"))&&!process.env.SOOTSIM_VERBOSE&&(process.stderr.write(`  ${e}
 `),process.exit(1)),a instanceof Error&&a.stack?process.stderr.write(`${a.stack}
 `):process.stderr.write(`${e}
 `),process.exit(1)}process.on("unhandledRejection",f);process.on("uncaughtException",f);var A=typeof __SOOTSIM_STANDALONE__<"u"&&__SOOTSIM_STANDALONE__,k=new Set(["preview","electron","install-desktop"]);function v(a){!A||!k.has(a)||(process.stderr.write(`  sootsim ${a} isn't available in the standalone binary \u2014
   it needs vite / electron / playwright from a project's node_modules.
   install the npm package and run via bun or node instead:
     npm i -g sootsim && sootsim ${a}
-`),process.exit(1))}var t=g(process.argv);{let{trackCliEvent:a}=await import("./chunks/telemetry-2XPV6PVU.js");a({event:"cli_command_invoked",properties:{command:t.command||(t.version?"version":t.help?"help":"none"),arg_count:t.commandArgs.length,platform:process.platform,arch:process.arch,node_version:process.versions.node}})}async function c(a){let{flushCliTelemetry:e}=await import("./chunks/telemetry-2XPV6PVU.js");await e(),process.exit(a)}if(t.version){let{getCliVersion:a}=await import("./chunks/cli-version-EOI7UVCS.js"),{IS_BETA:e,BETA_LABEL:i}=await import("./chunks/beta-HNHNY7GJ.js"),m=e?` \xB7 ${i}`:"";console.log(`sootsim v${a()}${m}`);let{readActiveRuntime:h}=await import("./chunks/home-paths-KYTBCLPQ.js"),w=h();console.log(w?`runtime v${w}`:"runtime not installed"),await c(0)}if(t.help&&!t.command){let{printHelp:a}=await import("./chunks/help-RZ2M7P7U.js");a(),await c(0)}var o=t.globalFlags.port,n=t.verbose,p=t.globalFlags.device,l=t.globalFlags.theme,S=t.globalFlags.driver,E=t.globalFlags.headless===!0,b=t.globalFlags.sim??t.globalFlags.session??t.globalFlags.tab,s=b?["--sim",b,...t.commandArgs]:t.commandArgs;if(p||l){let{settingsStore:a}=await import("./chunks/store-WIQ4ZE4Z.js"),e={};p&&(e.deviceModel=p),l&&(e.colorScheme=l),a.apply(e)}if(!t.command&&t.commandArgs.length===0){let{runStart:a}=await import("./chunks/start-2T5QRVL2.js");await a([],{port:o}),await c(0)}var r=t.command??"";if(!r){if(t.commandArgs.length>0){let e=t.commandArgs.find(i=>!i.startsWith("-"))??t.commandArgs[0];console.error(`  unknown command: ${e}`),console.error("  run `sootsim --help` to see the full surface."),await c(1)}let{printHelp:a}=await import("./chunks/help-RZ2M7P7U.js");a(),await c(0)}if(r in d){let a=d[r],e=t.commandArgs.length>0?` ${t.commandArgs.join(" ")}`:"";console.error(`  \`sootsim ${r}\` was removed. use \`${a}\` instead.`),e&&console.error(`  \u2192 ${a}${e}`),console.error("  run `sootsim --help` to see the new verb groups."),await c(1)}if(t.help||t.commandArgs.includes("--help")||t.commandArgs.includes("-h")){let a=r==="do"||r==="get"||r==="debug"||r==="shell"||r==="wait",e=t.commandArgs.find(i=>!i.startsWith("-"));if(r!=="shell")if(a&&!e){let{printGroupHelp:i}=await import("./chunks/help-RZ2M7P7U.js");i(r)&&await c(0)}else{let{printCommandHelp:i}=await import("./chunks/help-RZ2M7P7U.js");i(a&&e?e:r,{prefer:a&&e?"verb":"command",group:a&&e?r:void 0}),await c(0)}}v(r);if(u.has(r)){let{ensureSootsimReady:a,resolveBootstrapPort:e}=await import("./chunks/auto-bootstrap-PRFJ44RD.js"),i=e(s,o);await a(i);let{runInspect:m}=await import("./chunks/inspect-ZUYLUCRJ.js");await m([r,...s],{port:i,verbose:n})}else switch(r){case"assert":{let{runAssert:a}=await import("./chunks/assert-CZPAVBXB.js");await a(t.commandArgs);break}case"flow":{let{runFlow:a}=await import("./chunks/flow-PV4WV3DZ.js"),e=await a(s);process.exit(typeof e=="number"?e:0)}case"test":{let{runTest:a}=await import("./chunks/test-ZGUHV3XE.js");await a(t.commandArgs,{port:o,verbose:n});break}case"detox":{let{runDetox:a}=await import("./chunks/detox-TX4AUV2W.js");await a(t.commandArgs,{port:o,verbose:n});break}case"maestro":{let{runMaestro:a}=await import("./chunks/maestro-DUIODHYF.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"preview":{let{runPreview:a}=await import("./chunks/preview-LSVZXF7S.js");await a(t.commandArgs,{port:o,verbose:n});break}case"record":{let{runRecord:a}=await import("./chunks/record-LLNZNJSY.js");await a(s,{port:o,verbose:n});break}case"profile":{let{runProfile:a}=await import("./chunks/profile-2LUO56EX.js"),e=await a(t.commandArgs,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"cpu-profile":{let{runCpuProfile:a}=await import("./chunks/cpu-profile-2VSK3E45.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"react":{let{runReact:a}=await import("./chunks/react-KPNHGOQ3.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"screenshot":{let{runScreenshot:a}=await import("./chunks/screenshot-OEIH2ETO.js");await a(s,{port:o,verbose:n});break}case"screenshots":{let{runScreenshots:a}=await import("./chunks/screenshots-GCJW22B5.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"screenshot-mode":{let{runScreenshotMode:a}=await import("./chunks/screenshot-mode-3TDLGZPT.js");await a(t.commandArgs,{port:o,verbose:n});break}case"three-mode":case"3d-mode":{let{runThreeMode:a}=await import("./chunks/three-mode-3BUTKBTR.js");await a(t.commandArgs,{port:o,verbose:n});break}case"inspect":{let{runInspect:a}=await import("./chunks/inspect-ZUYLUCRJ.js");await a(s,{port:o,verbose:n});break}case"debug":{let{runDebug:a}=await import("./chunks/debug-Q3K4TXLC.js");await a(s,{port:o,verbose:n});break}case"timeline":{let{runTimeline:a}=await import("./chunks/timeline-WS2FXPG2.js");await a(s,{port:o,verbose:n});break}case"what-happened":{let{runWhatHappened:a}=await import("./chunks/what-happened-5A2RUC6V.js");await a(s,{port:o,verbose:n});break}case"diagnose":{let{runDiagnose:a}=await import("./chunks/diagnose-CGHRCXKF.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"open":{let{ensureSootsimReady:a,resolveBootstrapPort:e}=await import("./chunks/auto-bootstrap-PRFJ44RD.js"),i=e(s,o);await a(i);let{runOpenCommand:m}=await import("./chunks/control-GWQ44GVR.js");await m(s,{port:i});break}case"use":case"focus":{let{runUseCommand:a}=await import("./chunks/control-GWQ44GVR.js");await a(s,{port:o});break}case"claim":{let{runClaimCommand:a}=await import("./chunks/control-GWQ44GVR.js");await a(s,{port:o});break}case"close":{let{runCloseCommand:a}=await import("./chunks/control-GWQ44GVR.js");await a(s,{port:o});break}case"config":{let{runConfig:a}=await import("./chunks/config-JNO26BKX.js");await a(t.commandArgs);break}case"device":{let{runDeviceCommand:a}=await import("./chunks/device-E5RRT67Y.js");await a(s,{port:o});break}case"scan":case"compat":{let{runCompat:a}=await import("./chunks/compat-DZRWNMC2.js");await a(t.commandArgs);break}case"electron":{let{runElectron:a}=await import("./chunks/electron-YSY7HZBI.js");await a(t.commandArgs,{port:o,device:p,driver:S});break}case"login":{let{runLogin:a}=await import("./chunks/login-II2EWFHY.js");await a(t.commandArgs);break}case"logout":{let{runLogout:a}=await import("./chunks/logout-E52753SB.js");await a();break}case"whoami":{let{runWhoami:a}=await import("./chunks/whoami-ZVM5A34Z.js");await a();break}case"keys":{let{runKeys:a}=await import("./chunks/keys-QJDWORM5.js");await a(t.commandArgs);break}case"setup-repo":{let{runSetupRepo:a}=await import("./chunks/setup-repo-U7XMVCQA.js");await a(t.commandArgs);break}case"install":{let{runInstall:a}=await import("./chunks/install-XLJ4CJUN.js");await a(t.commandArgs);break}case"install-desktop":{let{runInstallDesktop:a}=await import("./chunks/install-desktop-HKLVDL7Q.js");await a(t.commandArgs);break}case"server":{let{runServer:a}=await import("./chunks/server-CBH2UYLT.js");await a(t.commandArgs,{port:o});break}case"daemon":{let{runDaemon:a}=await import("./chunks/daemon-QMFDDXFF.js");await a(t.commandArgs,{port:o});break}case"runtime":{let{runRuntime:a}=await import("./chunks/runtime-B3RQF5NL.js");await a(t.commandArgs);break}case"upgrade":{let{runUpgrade:a}=await import("./chunks/upgrade-FFTCNLCI.js");await a(t.commandArgs);break}case"version":{let{runVersion:a}=await import("./chunks/version-OQOFXNMZ.js");await a(t.commandArgs);break}case"launch":{let{runLaunch:a}=await import("./chunks/launch-CBIYGOV7.js");await a(t.commandArgs);break}case"start":{let{runStart:a}=await import("./chunks/start-2T5QRVL2.js");await a(t.commandArgs,{port:o});break}case"agent":{let{runAgentCommand:a}=await import("./chunks/agent-EV3LMTI2.js"),e=await a(t.commandArgs);process.exit(e)}case"agent-wrapper":{let{runAgentWrapper:a}=await import("./chunks/agent-wrapper-GOUAYJWS.js"),e=await a(t.commandArgs);process.exit(e)}case"skills":{let{runSkills:a}=await import("./chunks/skills-DVPCRUUO.js");await a(t.commandArgs);break}case"upload":{let{runUpload:a}=await import("./chunks/upload-JQMTDQMQ.js");await a(t.commandArgs,{port:o,verbose:n});break}case"app-fonts":{let{runAppFonts:a}=await import("./chunks/app-fonts-7ZGCVBWL.js");await a(t.commandArgs);break}case"hints":{let{runHints:a}=await import("./chunks/hints-V7M7GKXL.js");a(t.commandArgs);break}default:console.error(`  unknown command: ${r}`),console.error("  run `sootsim --help` to see the full surface."),process.exit(1)}
+`),process.exit(1))}var t=g(process.argv);{let{trackCliEvent:a}=await import("./chunks/telemetry-T3OM5YCG.js");a({event:"cli_command_invoked",properties:{command:t.command||(t.version?"version":t.help?"help":"none"),arg_count:t.commandArgs.length,platform:process.platform,arch:process.arch,node_version:process.versions.node}})}async function c(a){let{flushCliTelemetry:e}=await import("./chunks/telemetry-T3OM5YCG.js");await e(),process.exit(a)}if(t.version){let{getCliVersion:a}=await import("./chunks/cli-version-YLSCTD4T.js"),{IS_BETA:e,BETA_LABEL:i}=await import("./chunks/beta-7T5LPWKT.js"),m=e?` \xB7 ${i}`:"";console.log(`sootsim v${a()}${m}`);let{readActiveRuntime:h}=await import("./chunks/home-paths-O7V4JW2V.js"),w=h();console.log(w?`runtime v${w}`:"runtime not installed"),await c(0)}if(t.help&&!t.command){let{printHelp:a}=await import("./chunks/help-JQEAOFW4.js");a(),await c(0)}var o=t.globalFlags.port,n=t.verbose,p=t.globalFlags.device,l=t.globalFlags.theme,S=t.globalFlags.driver,E=t.globalFlags.headless===!0,b=t.globalFlags.sim??t.globalFlags.session??t.globalFlags.tab,s=b?["--sim",b,...t.commandArgs]:t.commandArgs;if(p||l){let{settingsStore:a}=await import("./chunks/store-5RD45SIG.js"),e={};p&&(e.deviceModel=p),l&&(e.colorScheme=l),a.apply(e)}if(!t.command&&t.commandArgs.length===0){let{runStart:a}=await import("./chunks/start-4I2VFTT7.js");await a([],{port:o}),await c(0)}var r=t.command??"";if(!r){if(t.commandArgs.length>0){let e=t.commandArgs.find(i=>!i.startsWith("-"))??t.commandArgs[0];console.error(`  unknown command: ${e}`),console.error("  run `sootsim --help` to see the full surface."),await c(1)}let{printHelp:a}=await import("./chunks/help-JQEAOFW4.js");a(),await c(0)}if(r in d){let a=d[r],e=t.commandArgs.length>0?` ${t.commandArgs.join(" ")}`:"";console.error(`  \`sootsim ${r}\` was removed. use \`${a}\` instead.`),e&&console.error(`  \u2192 ${a}${e}`),console.error("  run `sootsim --help` to see the new verb groups."),await c(1)}if(t.help||t.commandArgs.includes("--help")||t.commandArgs.includes("-h")){let a=r==="do"||r==="get"||r==="debug"||r==="shell"||r==="wait",e=t.commandArgs.find(i=>!i.startsWith("-"));if(r!=="shell")if(a&&!e){let{printGroupHelp:i}=await import("./chunks/help-JQEAOFW4.js");i(r)&&await c(0)}else{let{printCommandHelp:i}=await import("./chunks/help-JQEAOFW4.js");i(a&&e?e:r,{prefer:a&&e?"verb":"command",group:a&&e?r:void 0}),await c(0)}}v(r);if(u.has(r)){let{ensureSootsimReady:a,resolveBootstrapPort:e}=await import("./chunks/auto-bootstrap-HJ6L7Y4E.js"),i=e(s,o);await a(i);let{runInspect:m}=await import("./chunks/inspect-T36ODJAN.js");await m([r,...s],{port:i,verbose:n})}else switch(r){case"assert":{let{runAssert:a}=await import("./chunks/assert-C7VKSGRY.js");await a(t.commandArgs);break}case"flow":{let{runFlow:a}=await import("./chunks/flow-N75N77WK.js"),e=await a(s);process.exit(typeof e=="number"?e:0)}case"test":{let{runTest:a}=await import("./chunks/test-NQ5O2ND4.js");await a(t.commandArgs,{port:o,verbose:n});break}case"detox":{let{runDetox:a}=await import("./chunks/detox-5KNUYOUK.js");await a(t.commandArgs,{port:o,verbose:n});break}case"maestro":{let{runMaestro:a}=await import("./chunks/maestro-7EWZQE7C.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"preview":{let{runPreview:a}=await import("./chunks/preview-6ADUV4HS.js");await a(t.commandArgs,{port:o,verbose:n});break}case"record":{let{runRecord:a}=await import("./chunks/record-6PYC73J5.js");await a(s,{port:o,verbose:n});break}case"profile":{let{runProfile:a}=await import("./chunks/profile-D634RPOU.js"),e=await a(t.commandArgs,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"cpu-profile":{let{runCpuProfile:a}=await import("./chunks/cpu-profile-7TARS6YI.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"react":{let{runReact:a}=await import("./chunks/react-CI2XOOKG.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"screenshot":{let{runScreenshot:a}=await import("./chunks/screenshot-DYLZI2UB.js");await a(s,{port:o,verbose:n});break}case"screenshots":{let{runScreenshots:a}=await import("./chunks/screenshots-UBYQLSGU.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"screenshot-mode":{let{runScreenshotMode:a}=await import("./chunks/screenshot-mode-WCJJZJ4I.js");await a(t.commandArgs,{port:o,verbose:n});break}case"three-mode":case"3d-mode":{let{runThreeMode:a}=await import("./chunks/three-mode-QKX5ZD3T.js");await a(t.commandArgs,{port:o,verbose:n});break}case"inspect":{let{runInspect:a}=await import("./chunks/inspect-T36ODJAN.js");await a(s,{port:o,verbose:n});break}case"debug":{let{runDebug:a}=await import("./chunks/debug-2IZSN6F3.js");await a(s,{port:o,verbose:n});break}case"timeline":{let{runTimeline:a}=await import("./chunks/timeline-HQGP3BWQ.js");await a(s,{port:o,verbose:n});break}case"what-happened":{let{runWhatHappened:a}=await import("./chunks/what-happened-YGHZIXUQ.js");await a(s,{port:o,verbose:n});break}case"diagnose":{let{runDiagnose:a}=await import("./chunks/diagnose-KQW7BDVO.js"),e=await a(s,{port:o,verbose:n});process.exit(typeof e=="number"?e:0)}case"open":{let{ensureSootsimReady:a,resolveBootstrapPort:e}=await import("./chunks/auto-bootstrap-HJ6L7Y4E.js"),i=e(s,o);await a(i);let{runOpenCommand:m}=await import("./chunks/control-V3LESW4B.js");await m(s,{port:i});break}case"use":case"focus":{let{runUseCommand:a}=await import("./chunks/control-V3LESW4B.js");await a(s,{port:o});break}case"claim":{let{runClaimCommand:a}=await import("./chunks/control-V3LESW4B.js");await a(s,{port:o});break}case"close":{let{runCloseCommand:a}=await import("./chunks/control-V3LESW4B.js");await a(s,{port:o});break}case"config":{let{runConfig:a}=await import("./chunks/config-3WQGW5NO.js");await a(t.commandArgs);break}case"device":{let{runDeviceCommand:a}=await import("./chunks/device-232QOTCZ.js");await a(s,{port:o});break}case"scan":case"compat":{let{runCompat:a}=await import("./chunks/compat-QI454ESE.js");await a(t.commandArgs);break}case"electron":{let{runElectron:a}=await import("./chunks/electron-O6ELQRHJ.js");await a(t.commandArgs,{port:o,device:p,driver:S});break}case"login":{let{runLogin:a}=await import("./chunks/login-VDH2M4OQ.js");await a(t.commandArgs);break}case"logout":{let{runLogout:a}=await import("./chunks/logout-H6NCIG4O.js");await a();break}case"whoami":{let{runWhoami:a}=await import("./chunks/whoami-6WPS2PJB.js");await a();break}case"keys":{let{runKeys:a}=await import("./chunks/keys-PRTEPMIU.js");await a(t.commandArgs);break}case"setup-repo":{let{runSetupRepo:a}=await import("./chunks/setup-repo-4BMV6H4N.js");await a(t.commandArgs);break}case"install":{let{runInstall:a}=await import("./chunks/install-LSIVGKDQ.js");await a(t.commandArgs);break}case"install-desktop":{let{runInstallDesktop:a}=await import("./chunks/install-desktop-O3QC6B7F.js");await a(t.commandArgs);break}case"server":{let{runServer:a}=await import("./chunks/server-INUPMADW.js");await a(t.commandArgs,{port:o});break}case"daemon":{let{runDaemon:a}=await import("./chunks/daemon-Y32JYZ4J.js");await a(t.commandArgs,{port:o});break}case"runtime":{let{runRuntime:a}=await import("./chunks/runtime-P32F4A7T.js");await a(t.commandArgs);break}case"upgrade":{let{runUpgrade:a}=await import("./chunks/upgrade-NJCLU3PX.js");await a(t.commandArgs);break}case"version":{let{runVersion:a}=await import("./chunks/version-R6C63OCK.js");await a(t.commandArgs);break}case"launch":{let{runLaunch:a}=await import("./chunks/launch-K4LIL5HE.js");await a(t.commandArgs);break}case"start":{let{runStart:a}=await import("./chunks/start-4I2VFTT7.js");await a(t.commandArgs,{port:o});break}case"agent":{let{runAgentCommand:a}=await import("./chunks/agent-BKFAIL4L.js"),e=await a(t.commandArgs);process.exit(e)}case"agent-wrapper":{let{runAgentWrapper:a}=await import("./chunks/agent-wrapper-3JFHSCJV.js"),e=await a(t.commandArgs);process.exit(e)}case"skills":{let{runSkills:a}=await import("./chunks/skills-FLIZVEDL.js");await a(t.commandArgs);break}case"upload":{let{runUpload:a}=await import("./chunks/upload-WQNOKGN6.js");await a(t.commandArgs,{port:o,verbose:n});break}case"app-fonts":{let{runAppFonts:a}=await import("./chunks/app-fonts-TTXUEYKI.js");await a(t.commandArgs);break}case"hints":{let{runHints:a}=await import("./chunks/hints-ZJSHULYA.js");a(t.commandArgs);break}default:console.error(`  unknown command: ${r}`),console.error("  run `sootsim --help` to see the full surface."),process.exit(1)}

package/dist-cli/chunks/{agent-EV3LMTI2.js → agent-BKFAIL4L.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.135 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as E,b as A,c as S,d as l,e as j,g as T,h as I,j as D,m as k,n as x,o as O,p as g,q as R,r as C}from"./chunk-UOBTAOWL.js";import"./chunk-U6TZCGUB.js";import{c as b}from"./chunk-ASXKBNRL.js";import"./chunk-CYELNMX7.js";import"./chunk-PWRO2WPW.js";import"./chunk-TVCTN2EF.js";import"./chunk-XOK53FNY.js";import"./chunk-GBBGAIOO.js";import"./chunk-IJU5JVF2.js";import"./chunk-4PJFJ77U.js";import{h as y,i as $}from"./chunk-UM7EEN26.js";import"./chunk-45Z6VTEC.js";import w from"node:fs";import d from"node:path";import{spawn as F}from"node:child_process";import B from"node:net";import{WebSocket as M}from"ws";var c=class extends Error{code;constructor(e,t){super(e),this.name="AgentDaemonError",this.code=t}},f=class{ws;port;commandTimeoutMs;ready;closed=!1;nextId=1;pending=new Map;eventListeners=new Set;statusListeners=new Set;disconnectListeners=new Set;constructor(e={}){this.port=e.port??7668,this.commandTimeoutMs=e.commandTimeoutMs??15e3,this.ws=new M(`ws://localhost:${this.port}`),this.ready=new Promise((t,r)=>{let s=()=>{this.ws.off("error",o),t()},o=i=>{this.ws.off("open",s),r(new c(`could not connect to sootsim daemon on port ${this.port}: ${i.message}`,"NO_DAEMON"))};this.ws.once("open",s),this.ws.once("error",o)}),this.ws.on("message",t=>this.handleMessage(t)),this.ws.on("close",()=>this.handleClose()),this.ws.on("error",()=>{})}async waitReady(){return this.ready}async listProjects(){return this.send("agent:list-projects")}async upsertProject(e){return this.send("agent:upsert-project",{input:e})}async deleteProject(e){return this.send("agent:delete-project",{projectId:e})}async autoAttachForUrl(e){return this.send("agent:auto-attach-for-url",{input:e})}async listSessions(e){return this.send("agent:list-sessions",{projectId:e})}async startSession(e){return this.send("agent:start-session",{input:e})}async sendPrompt(e,t){return this.send("agent:send-prompt",{sessionId:e,prompt:t})}async endSession(e){return this.send("agent:end-session",{sessionId:e})}async getTranscript(e){return this.send("agent:get-transcript",{sessionId:e})}async getPaths(){return this.send("agent:get-paths")}async subscribeEvents(e){return this.send("agent:subscribe-events",{sessionId:e})}async unsubscribeEvents(e){return this.send("agent:unsubscribe-events",{sessionId:e})}onAgentEvent(e){return this.eventListeners.add(e),()=>this.eventListeners.delete(e)}onSessionStatusChange(e){return this.statusListeners.add(e),()=>this.statusListeners.delete(e)}onDisconnect(e){return this.disconnectListeners.add(e),()=>this.disconnectListeners.delete(e)}close(){if(!this.closed){this.closed=!0;try{this.ws.close()}catch{}}}async send(e,t={}){if(await this.ready,this.closed||this.ws.readyState!==M.OPEN)throw new c("daemon connection is closed","NO_DAEMON");let r=this.nextId++;return new Promise((s,o)=>{let i=setTimeout(()=>{this.pending.delete(r),o(new c(`${e} timed out after ${Math.round(this.commandTimeoutMs/1e3)}s`,"TIMEOUT"))},this.commandTimeoutMs);this.pending.set(r,{resolve:s,reject:o,timer:i});try{this.ws.send(JSON.stringify({id:r,type:e,...t}))}catch(a){clearTimeout(i),this.pending.delete(r),o(a instanceof Error?a:new Error(String(a)))}})}handleMessage(e){let t;try{t=JSON.parse(String(e))}catch{return}if(!t||typeof t!="object")return;if(t.type==="agent:event"){for(let s of this.eventListeners)try{s({sessionId:t.sessionId,event:t.event})}catch{}return}if(t.type==="agent:session-status"){for(let s of this.statusListeners)try{s(t.session)}catch{}return}if(typeof t.id!="number")return;let r=this.pending.get(t.id);r&&(this.pending.delete(t.id),clearTimeout(r.timer),t.error?r.reject(new c(t.error,t.code)):r.resolve(t.result))}handleClose(){if(!this.closed){this.closed=!0;for(let[,e]of this.pending)clearTimeout(e.timer),e.reject(new c("daemon disconnected","DISCONNECT"));this.pending.clear();for(let e of this.disconnectListeners)try{e()}catch{}}}};function L(n=7668,e=400){return new Promise(t=>{let r=new B.Socket,s=!1,o=i=>{s||(s=!0,r.destroy(),t(i))};r.setTimeout(e),r.once("connect",()=>o(!0)),r.once("timeout",()=>o(!1)),r.once("error",()=>o(!1)),r.connect(n,"127.0.0.1")})}async function W(n={}){let e=n.port??7668;if(await L(e))return{alreadyRunning:!0};if($()){let a=y()?"this is a dev workstation (IS_TAMAGUI_DEV=1)":"this is a dev checkout";throw new c(`no sootsim bridge on port ${e} and refusing to spawn a standalone daemon \u2014 ${a}. start the live \`bun dev\` stack so the bridge is up, or set SOOTSIM_FORCE_DAEMON_INSTALL=1 to spawn one here on purpose.`,"DEV_HOST_REFUSED")}let{cmd:t,prefixArgs:r}=C(),s=[...r,"server","--quiet"];e!==7668&&s.push("--port",String(e));let o=F(t,s,{detached:!0,stdio:"ignore",env:process.env,cwd:process.cwd()});o.unref();let i=Date.now()+(n.startupTimeoutMs??5e3);for(;Date.now()<i;){if(await L(e))return{alreadyRunning:!1,pid:o.pid};await new Promise(a=>setTimeout(a,100))}throw new c(`spawned sootsim daemon on port ${e} but it did not come up in time. run \`sootsim server\` manually to diagnose.`,"SPAWN_TIMEOUT")}async function h(n={}){await W({port:n.port,startupTimeoutMs:n.startupTimeoutMs});let e=new f(n);try{await e.waitReady()}catch(t){throw e.close(),t}return e}async function fe(n){let[e,...t]=n;try{switch(e){case void 0:case"--help":case"-h":case"help":return _(),0;case"attach":return await V(t);case"projects":return await J();case"project":return await G(t);case"sessions":return await H(t);case"start":return await q(t);case"prompt":return await K(t);case"watch":return await X(t);case"transcript":return await Q(t);case"end":return await Y(t);case"paths":return await Z();default:return process.stderr.write(`unknown agent subcommand: ${e}
+/*! sootsim v0.1.137 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{a as E,b as A,c as S,d as l,e as j,g as T,h as I,j as D,m as k,n as x,o as O,p as g,q as R,r as C}from"./chunk-ANGFHMMH.js";import"./chunk-S743VRVC.js";import{c as b}from"./chunk-IBFKK5VG.js";import"./chunk-RRJJOP5X.js";import"./chunk-ZV2GNDOE.js";import"./chunk-QOFYAH6W.js";import"./chunk-XZI43TP4.js";import"./chunk-U3UNJQLS.js";import"./chunk-RSKKY2YX.js";import"./chunk-Q4G7RPYT.js";import{h as y,i as $}from"./chunk-WYDF3HWY.js";import"./chunk-VTZMWNB5.js";import w from"node:fs";import d from"node:path";import{spawn as F}from"node:child_process";import B from"node:net";import{WebSocket as M}from"ws";var c=class extends Error{code;constructor(e,t){super(e),this.name="AgentDaemonError",this.code=t}},f=class{ws;port;commandTimeoutMs;ready;closed=!1;nextId=1;pending=new Map;eventListeners=new Set;statusListeners=new Set;disconnectListeners=new Set;constructor(e={}){this.port=e.port??7668,this.commandTimeoutMs=e.commandTimeoutMs??15e3,this.ws=new M(`ws://localhost:${this.port}`),this.ready=new Promise((t,r)=>{let s=()=>{this.ws.off("error",o),t()},o=i=>{this.ws.off("open",s),r(new c(`could not connect to sootsim daemon on port ${this.port}: ${i.message}`,"NO_DAEMON"))};this.ws.once("open",s),this.ws.once("error",o)}),this.ws.on("message",t=>this.handleMessage(t)),this.ws.on("close",()=>this.handleClose()),this.ws.on("error",()=>{})}async waitReady(){return this.ready}async listProjects(){return this.send("agent:list-projects")}async upsertProject(e){return this.send("agent:upsert-project",{input:e})}async deleteProject(e){return this.send("agent:delete-project",{projectId:e})}async autoAttachForUrl(e){return this.send("agent:auto-attach-for-url",{input:e})}async listSessions(e){return this.send("agent:list-sessions",{projectId:e})}async startSession(e){return this.send("agent:start-session",{input:e})}async sendPrompt(e,t){return this.send("agent:send-prompt",{sessionId:e,prompt:t})}async endSession(e){return this.send("agent:end-session",{sessionId:e})}async getTranscript(e){return this.send("agent:get-transcript",{sessionId:e})}async getPaths(){return this.send("agent:get-paths")}async subscribeEvents(e){return this.send("agent:subscribe-events",{sessionId:e})}async unsubscribeEvents(e){return this.send("agent:unsubscribe-events",{sessionId:e})}onAgentEvent(e){return this.eventListeners.add(e),()=>this.eventListeners.delete(e)}onSessionStatusChange(e){return this.statusListeners.add(e),()=>this.statusListeners.delete(e)}onDisconnect(e){return this.disconnectListeners.add(e),()=>this.disconnectListeners.delete(e)}close(){if(!this.closed){this.closed=!0;try{this.ws.close()}catch{}}}async send(e,t={}){if(await this.ready,this.closed||this.ws.readyState!==M.OPEN)throw new c("daemon connection is closed","NO_DAEMON");let r=this.nextId++;return new Promise((s,o)=>{let i=setTimeout(()=>{this.pending.delete(r),o(new c(`${e} timed out after ${Math.round(this.commandTimeoutMs/1e3)}s`,"TIMEOUT"))},this.commandTimeoutMs);this.pending.set(r,{resolve:s,reject:o,timer:i});try{this.ws.send(JSON.stringify({id:r,type:e,...t}))}catch(a){clearTimeout(i),this.pending.delete(r),o(a instanceof Error?a:new Error(String(a)))}})}handleMessage(e){let t;try{t=JSON.parse(String(e))}catch{return}if(!t||typeof t!="object")return;if(t.type==="agent:event"){for(let s of this.eventListeners)try{s({sessionId:t.sessionId,event:t.event})}catch{}return}if(t.type==="agent:session-status"){for(let s of this.statusListeners)try{s(t.session)}catch{}return}if(typeof t.id!="number")return;let r=this.pending.get(t.id);r&&(this.pending.delete(t.id),clearTimeout(r.timer),t.error?r.reject(new c(t.error,t.code)):r.resolve(t.result))}handleClose(){if(!this.closed){this.closed=!0;for(let[,e]of this.pending)clearTimeout(e.timer),e.reject(new c("daemon disconnected","DISCONNECT"));this.pending.clear();for(let e of this.disconnectListeners)try{e()}catch{}}}};function L(n=7668,e=400){return new Promise(t=>{let r=new B.Socket,s=!1,o=i=>{s||(s=!0,r.destroy(),t(i))};r.setTimeout(e),r.once("connect",()=>o(!0)),r.once("timeout",()=>o(!1)),r.once("error",()=>o(!1)),r.connect(n,"127.0.0.1")})}async function W(n={}){let e=n.port??7668;if(await L(e))return{alreadyRunning:!0};if($()){let a=y()?"this is a dev workstation (IS_TAMAGUI_DEV=1)":"this is a dev checkout";throw new c(`no sootsim bridge on port ${e} and refusing to spawn a standalone daemon \u2014 ${a}. start the live \`bun dev\` stack so the bridge is up, or set SOOTSIM_FORCE_DAEMON_INSTALL=1 to spawn one here on purpose.`,"DEV_HOST_REFUSED")}let{cmd:t,prefixArgs:r}=C(),s=[...r,"server","--quiet"];e!==7668&&s.push("--port",String(e));let o=F(t,s,{detached:!0,stdio:"ignore",env:process.env,cwd:process.cwd()});o.unref();let i=Date.now()+(n.startupTimeoutMs??5e3);for(;Date.now()<i;){if(await L(e))return{alreadyRunning:!1,pid:o.pid};await new Promise(a=>setTimeout(a,100))}throw new c(`spawned sootsim daemon on port ${e} but it did not come up in time. run \`sootsim server\` manually to diagnose.`,"SPAWN_TIMEOUT")}async function h(n={}){await W({port:n.port,startupTimeoutMs:n.startupTimeoutMs});let e=new f(n);try{await e.waitReady()}catch(t){throw e.close(),t}return e}async function fe(n){let[e,...t]=n;try{switch(e){case void 0:case"--help":case"-h":case"help":return _(),0;case"attach":return await V(t);case"projects":return await J();case"project":return await G(t);case"sessions":return await H(t);case"start":return await q(t);case"prompt":return await K(t);case"watch":return await X(t);case"transcript":return await Q(t);case"end":return await Y(t);case"paths":return await Z();default:return process.stderr.write(`unknown agent subcommand: ${e}
 `),_(),2}}catch(r){if(r instanceof c)return process.stderr.write(`${r.message}
 `),1;throw r}}async function v(n){let e=await h({clientLabel:"sootsim-agent-cli"});try{return await n(e)}finally{e.close()}}function _(){b("agent")}function P(n,e){let t={},r=[];for(let s=0;s<n.length;s++){let o=n[s],i=e[o];i==="value"?(t[o]=n[s+1]??"",s++):i==="bool"?t[o]=!0:r.push(o)}return{flags:t,positional:r}}function U(n,e="codex"){return n==="codex"||n==="claude"?n:e}async function V(n){let{flags:e,positional:t}=P(n,{"--name":"value","--provider":"value"}),r=t[0];if(!r)return process.stderr.write(`usage: sootsim agent attach <dir> [--name X] [--provider codex|claude]
 `),2;let s=d.resolve(r);if(!w.existsSync(s))return process.stderr.write(`directory does not exist: ${s}

package/dist-cli/chunks/{agent-wrapper-GOUAYJWS.js → agent-wrapper-3JFHSCJV.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.135 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{b as M}from"./chunk-U6TZCGUB.js";import"./chunk-45Z6VTEC.js";import{execFile as G,spawn as q}from"node:child_process";import{randomUUID as X}from"node:crypto";import{constants as R,createReadStream as Y,createWriteStream as j,existsSync as I,openSync as J}from"node:fs";import V from"node:fs/promises";import z from"node:path";import K from"node:readline";import{promisify as Q}from"node:util";import{spawn as H}from"node:child_process";import L from"node:readline";var b=class extends Error{code;data;constructor(t,r,m){super(t),this.name="CodexRpcError",this.code=r,this.data=m}};function W(d){let t=H(d.bin,["app-server"],{cwd:d.cwd,env:{...process.env,...d.env},stdio:["pipe","pipe","pipe"]}),r=new Map,m=new Map,u=1,g=!1,a=new Promise(s=>{t.on("exit",(i,e)=>{g=!0;let p=new Error(`codex app-server exited (code=${i}, signal=${e??""})`);for(let{reject:f}of r.values())f(p);r.clear(),s({code:i,signal:e})})});L.createInterface({input:t.stdout,crlfDelay:1/0}).on("line",s=>{let i=s.trim();if(!i)return;let e;try{e=JSON.parse(i)}catch{return}if(e.id!=null&&(e.result!==void 0||e.error!==void 0)){let p=typeof e.id=="string"?Number(e.id):e.id,f=p!=null?r.get(p):void 0;if(!f)return;r.delete(p),e.error?f.reject(new b(e.error.message,e.error.code,e.error.data)):f.resolve(e.result);return}if(e.method){let p=m.get(e.method);if(!p)return;for(let f of p)try{f(e.params)}catch(l){console.error(`[codex-client] handler for "${e.method}" threw:`,l instanceof Error?l.stack??l.message:l)}}}),t.stderr.setEncoding("utf8"),t.stderr.on("data",s=>{let i=m.get("__stderr__");if(i)for(let e of i)try{e({text:s})}catch{}});function n(s){if(!g)try{t.stdin.write(JSON.stringify(s)+`
+/*! sootsim v0.1.137 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{b as M}from"./chunk-S743VRVC.js";import"./chunk-VTZMWNB5.js";import{execFile as G,spawn as q}from"node:child_process";import{randomUUID as X}from"node:crypto";import{constants as R,createReadStream as Y,createWriteStream as j,existsSync as I,openSync as J}from"node:fs";import V from"node:fs/promises";import z from"node:path";import K from"node:readline";import{promisify as Q}from"node:util";import{spawn as H}from"node:child_process";import L from"node:readline";var b=class extends Error{code;data;constructor(t,r,m){super(t),this.name="CodexRpcError",this.code=r,this.data=m}};function W(d){let t=H(d.bin,["app-server"],{cwd:d.cwd,env:{...process.env,...d.env},stdio:["pipe","pipe","pipe"]}),r=new Map,m=new Map,u=1,g=!1,a=new Promise(s=>{t.on("exit",(i,e)=>{g=!0;let p=new Error(`codex app-server exited (code=${i}, signal=${e??""})`);for(let{reject:f}of r.values())f(p);r.clear(),s({code:i,signal:e})})});L.createInterface({input:t.stdout,crlfDelay:1/0}).on("line",s=>{let i=s.trim();if(!i)return;let e;try{e=JSON.parse(i)}catch{return}if(e.id!=null&&(e.result!==void 0||e.error!==void 0)){let p=typeof e.id=="string"?Number(e.id):e.id,f=p!=null?r.get(p):void 0;if(!f)return;r.delete(p),e.error?f.reject(new b(e.error.message,e.error.code,e.error.data)):f.resolve(e.result);return}if(e.method){let p=m.get(e.method);if(!p)return;for(let f of p)try{f(e.params)}catch(l){console.error(`[codex-client] handler for "${e.method}" threw:`,l instanceof Error?l.stack??l.message:l)}}}),t.stderr.setEncoding("utf8"),t.stderr.on("data",s=>{let i=m.get("__stderr__");if(i)for(let e of i)try{e({text:s})}catch{}});function n(s){if(!g)try{t.stdin.write(JSON.stringify(s)+`
 `)}catch{}}return{exited:a,on(s,i){let e=m.get(s);return e||(e=new Set,m.set(s,e)),e.add(i),()=>{e?.delete(i)}},request(s,i){if(g)return Promise.reject(new Error(`codex app-server closed; cannot call ${s}`));let e=u++;return new Promise((p,f)=>{r.set(e,{resolve:l=>p(l),reject:f,method:s}),n({jsonrpc:"2.0",id:e,method:s,params:i})})},notify(s,i){n({jsonrpc:"2.0",method:s,params:i})},async shutdown(s=1500){if(g)return;try{t.stdin.end()}catch{}let i=setTimeout(()=>{if(!g)try{t.kill("SIGTERM")}catch{}},s);try{await a}finally{clearTimeout(i)}},kill(s="SIGTERM"){if(!g)try{t.kill(s)}catch{}}}}var O="never",F="danger-full-access",Z={type:"dangerFullAccess"},D="fast",ee="medium",te=Q(G);async function ne(d,t){let r=t||d;if(r.includes("/")||r.includes("\\"))return I(r)?{ok:!0,path:r}:{ok:!1,message:`agent binary not found at path: ${r}`};try{let{stdout:m}=await te("which",[r],{timeout:1500}),u=m.trim();return u?{ok:!0,path:u}:{ok:!1,message:`${r} not found on PATH`}}catch{return{ok:!1,message:`${r} not found on PATH. install the ${d} CLI and retry, or pass --${d}-bin /path/to/${d} to agent start.`}}}function re(d){let t={"--session-id":"sessionId","--project-id":"projectId","--provider":"provider","--cwd":"cwd","--prompt-in":"promptIn","--events-out":"eventsOut","--transcript":"transcript","--codex-bin":"codexBin","--claude-bin":"claudeBin","--claude-session-uuid":"claudeSessionUuid"},r={};for(let m=0;m<d.length;m++){let u=d[m];if(u==="--fresh-thread"){r.freshThread=!0;continue}let g=t[u];g&&(r[g]=d[m+1],m++)}return r}async function Ie(d){let t=re(d);if(!t.sessionId||!t.projectId||!t.provider||!t.cwd||!t.promptIn||!t.eventsOut)return process.stderr.write(`usage: sootsim agent-wrapper --session-id <id> --project-id <id>
                             --provider codex|claude --cwd <path>
                             --prompt-in <fifo> --events-out <fifo>

package/dist-cli/chunks/{app-fonts-7ZGCVBWL.js → app-fonts-TTXUEYKI.js}

@@ -1,2 +1,2 @@
-/*! sootsim v0.1.135 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{d as p}from"./chunk-OC5UQFLJ.js";import"./chunk-45Z6VTEC.js";import{existsSync as h,mkdirSync as d,readFileSync as y,writeFileSync as g}from"node:fs";import{join as m}from"node:path";import{gzipSync as w}from"node:zlib";function f(t,e){let o=t.indexOf(`--${e}`);if(o!==-1&&o+1<t.length)return t[o+1];let i=t.find(r=>r.startsWith(`--${e}=`));return i?i.slice(e.length+3):void 0}async function S(t){let e=f(t,"wire")||"",o=f(t,"out-dir"),i=f(t,"manifest");if((!o||!i)&&(console.error("  usage: sootsim app-fonts stage --wire <wire> --out-dir <dir> --manifest <path>"),process.exit(1)),!e.trim()){console.log("no app fonts declared \u2014 nothing to stage");return}d(o,{recursive:!0});let r=await p(e,{onStaged:({url:n,byteLength:s})=>console.log(`  staged app font: ${n} (${(s/1024).toFixed(1)} KiB)`),onError:(n,s)=>console.error(`  warning: failed to fetch app font ${n}: ${s instanceof Error?s.message:s}`)}),a=[];for(let n of r){let s=w(n.bytes);g(m(o,n.urlhash),s),a.push({url:n.url,urlhash:n.urlhash,contentType:n.contentType,encoding:"gzip",sizeBytes:s.length,rawBytes:n.bytes.byteLength})}let c=[];if(h(i))try{let n=JSON.parse(y(i,"utf8"));Array.isArray(n)&&(c=n)}catch{}let u=new Set(c.map(n=>n.urlhash)),l=[...c,...a.filter(n=>!u.has(n.urlhash))];g(i,JSON.stringify(l)),console.log(`staged ${a.length} app font(s); manifest now has ${l.length} file(s)`)}async function E(t){let e=t[0];if(e==="stage"){await S(t.slice(1));return}console.error(`  unknown app-fonts subcommand: ${e??"(none)"}`),console.error("  available: stage"),process.exit(1)}export{E as runAppFonts};
+/*! sootsim v0.1.137 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{d as p}from"./chunk-JZLPETG5.js";import"./chunk-VTZMWNB5.js";import{existsSync as h,mkdirSync as d,readFileSync as y,writeFileSync as g}from"node:fs";import{join as m}from"node:path";import{gzipSync as w}from"node:zlib";function f(t,e){let o=t.indexOf(`--${e}`);if(o!==-1&&o+1<t.length)return t[o+1];let i=t.find(r=>r.startsWith(`--${e}=`));return i?i.slice(e.length+3):void 0}async function S(t){let e=f(t,"wire")||"",o=f(t,"out-dir"),i=f(t,"manifest");if((!o||!i)&&(console.error("  usage: sootsim app-fonts stage --wire <wire> --out-dir <dir> --manifest <path>"),process.exit(1)),!e.trim()){console.log("no app fonts declared \u2014 nothing to stage");return}d(o,{recursive:!0});let r=await p(e,{onStaged:({url:n,byteLength:s})=>console.log(`  staged app font: ${n} (${(s/1024).toFixed(1)} KiB)`),onError:(n,s)=>console.error(`  warning: failed to fetch app font ${n}: ${s instanceof Error?s.message:s}`)}),a=[];for(let n of r){let s=w(n.bytes);g(m(o,n.urlhash),s),a.push({url:n.url,urlhash:n.urlhash,contentType:n.contentType,encoding:"gzip",sizeBytes:s.length,rawBytes:n.bytes.byteLength})}let c=[];if(h(i))try{let n=JSON.parse(y(i,"utf8"));Array.isArray(n)&&(c=n)}catch{}let u=new Set(c.map(n=>n.urlhash)),l=[...c,...a.filter(n=>!u.has(n.urlhash))];g(i,JSON.stringify(l)),console.log(`staged ${a.length} app font(s); manifest now has ${l.length} file(s)`)}async function E(t){let e=t[0];if(e==="stage"){await S(t.slice(1));return}console.error(`  unknown app-fonts subcommand: ${e??"(none)"}`),console.error("  available: stage"),process.exit(1)}export{E as runAppFonts};