sootsim 0.1.169 → 0.1.171
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -63
- package/detox/index.ts +3 -3
- package/dist-cli/bin.js +3 -3
- package/dist-cli/chunks/agent-J4NTKR6V.js +46 -0
- package/dist-cli/chunks/{agent-wrapper-Y5FQA3RL.js → agent-wrapper-V2TD3UZR.js} +2 -2
- package/dist-cli/chunks/{app-fonts-FYVA4XV6.js → app-fonts-ROVXMKLG.js} +2 -2
- package/dist-cli/chunks/{assert-U64QBDM2.js → assert-CXQAEBLS.js} +2 -2
- package/dist-cli/chunks/beta-BLY4YCCD.js +2 -0
- package/dist-cli/chunks/{camera-3GXBVIAM.js → camera-XPZFAU3B.js} +2 -2
- package/dist-cli/chunks/chunk-2UEHUM6Q.js +13 -0
- package/dist-cli/chunks/chunk-3OFDUWRM.js +2 -0
- package/dist-cli/chunks/chunk-547XSOJL.js +62 -0
- package/dist-cli/chunks/{chunk-3L4NRJ6C.js → chunk-AHOHHXWK.js} +1 -1
- package/dist-cli/chunks/{chunk-JDGLBW64.js → chunk-AOPGVSJW.js} +1 -1
- package/dist-cli/chunks/chunk-B77QXVTZ.js +118 -0
- package/dist-cli/chunks/chunk-CJTJX3H7.js +23 -0
- package/dist-cli/chunks/{chunk-2TYEWVS4.js → chunk-CVLJ4RMA.js} +1 -1
- package/dist-cli/chunks/chunk-DGVQPBNL.js +1 -0
- package/dist-cli/chunks/{chunk-MVOHANJG.js → chunk-DR3E2NVD.js} +4 -4
- package/dist-cli/chunks/{chunk-FIDPRJYH.js → chunk-E7P6ILZK.js} +2 -2
- package/dist-cli/chunks/{chunk-CR6DOLUD.js → chunk-EXN7SSF3.js} +1 -1
- package/dist-cli/chunks/{chunk-IODOTOOP.js → chunk-FJ2WDOTA.js} +2 -2
- package/dist-cli/chunks/{chunk-LZEL2RU3.js → chunk-HBR56XPR.js} +1 -1
- package/dist-cli/chunks/chunk-HQ3WABUY.js +1 -0
- package/dist-cli/chunks/{chunk-5Q7IHJ7K.js → chunk-I5OLONCL.js} +2 -2
- package/dist-cli/chunks/{chunk-XEH4QGWB.js → chunk-I5XY2BFR.js} +2 -2
- package/dist-cli/chunks/{chunk-GC4THE6K.js → chunk-ICA7K635.js} +2 -2
- package/dist-cli/chunks/{chunk-WZG3YVJR.js → chunk-J7DI5B4Y.js} +1 -1
- package/dist-cli/chunks/{chunk-YADWU7OZ.js → chunk-JQSGI66Q.js} +2 -2
- package/dist-cli/chunks/chunk-JQW2OOL5.js +2 -0
- package/dist-cli/chunks/{chunk-B7BMSU7H.js → chunk-KT55MHRH.js} +1 -1
- package/dist-cli/chunks/{chunk-PV6MBKKE.js → chunk-LSZRVSXO.js} +2 -2
- package/dist-cli/chunks/{chunk-IACEJQIO.js → chunk-MBVNBHRK.js} +2 -2
- package/dist-cli/chunks/{chunk-VMYMPL6H.js → chunk-N64WUTJB.js} +5 -5
- package/dist-cli/chunks/{chunk-KUUFY6FC.js → chunk-O54LARIO.js} +1 -1
- package/dist-cli/chunks/{chunk-Y6IDAARY.js → chunk-OIIPFIZL.js} +1 -1
- package/dist-cli/chunks/chunk-OSS2T3WP.js +2 -0
- package/dist-cli/chunks/{chunk-KZIXAYN5.js → chunk-OTN33CWO.js} +4 -4
- package/dist-cli/chunks/{chunk-4F3BBP7B.js → chunk-OYQVSV4I.js} +2 -2
- package/dist-cli/chunks/{chunk-G2ZFDIPK.js → chunk-QBCJDPG3.js} +4 -4
- package/dist-cli/chunks/chunk-QIMO6SQX.js +2 -0
- package/dist-cli/chunks/{chunk-SNX3M4XD.js → chunk-RISDCDO2.js} +3 -3
- package/dist-cli/chunks/chunk-RJZRI3P3.js +2 -0
- package/dist-cli/chunks/{chunk-OGLWXPVG.js → chunk-RNWTVHIS.js} +3 -3
- package/dist-cli/chunks/chunk-RULKWLIO.js +6 -0
- package/dist-cli/chunks/{chunk-IBEMMV5E.js → chunk-RXBB4S3Q.js} +8 -8
- package/dist-cli/chunks/{chunk-SIB6I72P.js → chunk-U7NWELJ3.js} +2 -2
- package/dist-cli/chunks/{chunk-HC72ILJK.js → chunk-WPEXAZSS.js} +2 -2
- package/dist-cli/chunks/{chunk-DQZEN256.js → chunk-WXPG6OS6.js} +1 -1
- package/dist-cli/chunks/{chunk-DNA6VS6M.js → chunk-X4VXITOI.js} +1 -1
- package/dist-cli/chunks/{chunk-BIWJE7CB.js → chunk-XD66TGXU.js} +1 -1
- package/dist-cli/chunks/{chunk-X2HNVXNM.js → chunk-XFSQORQ5.js} +2 -2
- package/dist-cli/chunks/{chunk-5C6BR24W.js → chunk-YBPF6OGE.js} +6 -6
- package/dist-cli/chunks/{chunk-GLRFKYDV.js → chunk-YPHT4BSL.js} +2 -2
- package/dist-cli/chunks/cli-version-EQIZQ5NI.js +2 -0
- package/dist-cli/chunks/{compat-ORRWNXVT.js → compat-32AVWHB7.js} +3 -3
- package/dist-cli/chunks/control-LF34QRMZ.js +2 -0
- package/dist-cli/chunks/{cpu-profile-6PRSBZ2F.js → cpu-profile-EEAXEDDO.js} +2 -2
- package/dist-cli/chunks/daemon-MUQQZ64R.js +2 -0
- package/dist-cli/chunks/{debug-Q3J2X4WW.js → debug-MW62345L.js} +5 -5
- package/dist-cli/chunks/{detox-DN57GMMJ.js → detox-UAPUROWZ.js} +2 -2
- package/dist-cli/chunks/{device-IL5TPYGU.js → device-IWWFCELP.js} +2 -2
- package/dist-cli/chunks/{diagnose-BW6QWP4F.js → diagnose-DL22YIRH.js} +2 -2
- package/dist-cli/chunks/drivers-3LBGADWJ.js +2 -0
- package/dist-cli/chunks/{electron-DGMSXQWG.js → electron-KDVB42AG.js} +3 -3
- package/dist-cli/chunks/flow-OE7GVTNZ.js +2 -0
- package/dist-cli/chunks/help-G7XRDP3G.js +2 -0
- package/dist-cli/chunks/{hints-TK3EHB4U.js → hints-GNVLVDPN.js} +2 -2
- package/dist-cli/chunks/home-paths-4JHJTIX5.js +2 -0
- package/dist-cli/chunks/{inspect-NFWFGU4B.js → inspect-RT36PPFH.js} +24 -24
- package/dist-cli/chunks/{install-desktop-GB3JKSNX.js → install-desktop-MXUBQ6NJ.js} +3 -3
- package/dist-cli/chunks/{keys-RAAHRIFH.js → keys-PS5IUZ2M.js} +2 -2
- package/dist-cli/chunks/{login-KQ37GHDE.js → login-PLPGPVOR.js} +4 -4
- package/dist-cli/chunks/{logout-63SH2Y25.js → logout-3NCVFTBB.js} +2 -2
- package/dist-cli/chunks/{maestro-24BT3MML.js → maestro-OTPRMCZ3.js} +2 -2
- package/dist-cli/chunks/optional-demo-registry-RMRKVBDN.js +2 -0
- package/dist-cli/chunks/{preview-KQAOVN6R.js → preview-JM3GALNL.js} +2 -2
- package/dist-cli/chunks/{profile-AN2B4NJT.js → profile-T2BO5XLW.js} +2 -2
- package/dist-cli/chunks/{react-ATGV35B4.js → react-U3FQRLFA.js} +2 -2
- package/dist-cli/chunks/{record-36662T3R.js → record-C6FA3WXN.js} +4 -4
- package/dist-cli/chunks/runtime-IGGC2EEX.js +2 -0
- package/dist-cli/chunks/{screenshot-K4N5MPAT.js → screenshot-XPDBDFIK.js} +4 -4
- package/dist-cli/chunks/{screenshot-mode-4QOJDLSH.js → screenshot-mode-4FED7FGF.js} +2 -2
- package/dist-cli/chunks/{screenshots-TB35YMSR.js → screenshots-GVEUZFXL.js} +2 -2
- package/dist-cli/chunks/{screenshots-capture-W6X33BZ4.js → screenshots-capture-TPGPJZ3J.js} +2 -2
- package/dist-cli/chunks/{server-L2PKDJZ2.js → serve-5G4JU44V.js} +18 -17
- package/dist-cli/chunks/setup-BGRJTFGF.js +77 -0
- package/dist-cli/chunks/skills-AGVA7E6K.js +40 -0
- package/dist-cli/chunks/{slides-TORKO36P.js → slides-Z7LW64IW.js} +2 -2
- package/dist-cli/chunks/store-KKALNEVX.js +2 -0
- package/dist-cli/chunks/telemetry-WHOFSYSH.js +2 -0
- package/dist-cli/chunks/{test-5VCENVW3.js → test-PFT2C45X.js} +3 -3
- package/dist-cli/chunks/{three-mode-ZVS2DSX6.js → three-mode-HOCUD4BU.js} +2 -2
- package/dist-cli/chunks/{timeline-TNC5OWLF.js → timeline-STMBOMTT.js} +2 -2
- package/dist-cli/chunks/{upgrade-E7IO6A7Z.js → upgrade-UXMJ73RU.js} +2 -2
- package/dist-cli/chunks/upload-NJTGOKHA.js +2 -0
- package/dist-cli/chunks/version-FNSM3CIG.js +4 -0
- package/dist-cli/chunks/web-TMIGK6QS.js +2 -0
- package/dist-cli/chunks/{what-happened-RMHZ7DGX.js → what-happened-R5KC4F7B.js} +3 -3
- package/dist-cli/chunks/{whoami-D53ANHR5.js → whoami-DWRGFQKR.js} +2 -2
- package/dist-lib/agent-daemon-client.cjs +4 -5
- package/dist-lib/agent-events.cjs +1 -1
- package/dist-lib/agent-sessions.cjs +1 -1
- package/dist-lib/attached-projects.cjs +1 -1
- package/dist-lib/auth/shared-session.cjs +1 -1
- package/dist-lib/backend-origin.cjs +1 -1
- package/dist-lib/beta.cjs +3 -6
- package/dist-lib/beta.mjs +3 -5
- package/dist-lib/bridge-constants.cjs +1 -1
- package/dist-lib/cli-constants.cjs +1 -1
- package/dist-lib/config.cjs +1 -1
- package/dist-lib/detox/index.cjs +4 -4
- package/dist-lib/dev-bundle-resolution.cjs +2 -9
- package/dist-lib/home-paths.cjs +59 -1
- package/dist-lib/host/bridge-host.cjs +67 -5
- package/dist-lib/host/fetch-proxy-handler.cjs +1 -1
- package/dist-lib/host/fetch-proxy-overrides.cjs +1 -1
- package/dist-lib/host/fetch-proxy-overrides.mjs +1 -1
- package/dist-lib/host/websocket-proxy.cjs +1 -1
- package/dist-lib/index.cjs +2 -2
- package/dist-lib/menu.cjs +1 -1
- package/dist-lib/menu.mjs +1 -1
- package/dist-lib/metro.cjs +2 -2
- package/dist-lib/profiles.cjs +1 -1
- package/dist-lib/render-mode.cjs +1 -1
- package/dist-lib/scripts/dev-server-scanner.cjs +5 -4
- package/dist-lib/sdk.cjs +1 -1
- package/dist-lib/sdk.mjs +1 -1
- package/dist-lib/skills.cjs +127 -11
- package/dist-lib/vite.cjs +2 -2
- package/package.json +2 -1
- package/scripts/dev-server-scanner.ts +3 -4
- package/scripts/postinstall.cjs +2 -2
- package/scripts/preuninstall.cjs +5 -7
- package/skills/soot.md +178 -0
- package/skills/sootsim-debug.md +384 -0
- package/skills/sootsim-setup.md +96 -0
- package/skills/sootsim-test.md +292 -0
- package/skills/sootsim-visual.md +122 -0
- package/src/agent-daemon-client.ts +4 -14
- package/src/beta.ts +3 -5
- package/src/dev-bundle-resolution.ts +1 -14
- package/src/home-paths.ts +77 -2
- package/src/host/agent-host.ts +1 -1
- package/src/host/bridge-host.ts +65 -6
- package/src/metro-plugin.ts +1 -1
- package/src/runtime-assets.ts +1 -1
- package/src/vite-plugin.ts +1 -0
- package/dist-cli/chunks/agent-V3GVCRPL.js +0 -46
- package/dist-cli/chunks/auto-bootstrap-YXDP3WKH.js +0 -2
- package/dist-cli/chunks/beta-FGSMZWLP.js +0 -2
- package/dist-cli/chunks/chunk-2IFWVIKM.js +0 -2
- package/dist-cli/chunks/chunk-3T36XLP3.js +0 -119
- package/dist-cli/chunks/chunk-5KY7TQ42.js +0 -5
- package/dist-cli/chunks/chunk-BQOMDL4K.js +0 -1
- package/dist-cli/chunks/chunk-FHMPJZKM.js +0 -7
- package/dist-cli/chunks/chunk-GQAWFQNN.js +0 -23
- package/dist-cli/chunks/chunk-HJTKKF7M.js +0 -13
- package/dist-cli/chunks/chunk-K4JAWKOY.js +0 -1
- package/dist-cli/chunks/chunk-M2TMFGZH.js +0 -2
- package/dist-cli/chunks/chunk-NXGQS7IR.js +0 -2
- package/dist-cli/chunks/chunk-R2INPDGW.js +0 -1
- package/dist-cli/chunks/chunk-SLL5SZN4.js +0 -2
- package/dist-cli/chunks/chunk-XM66K64H.js +0 -79
- package/dist-cli/chunks/cli-version-3L6FFDIX.js +0 -2
- package/dist-cli/chunks/config-5IB6ONJ2.js +0 -45
- package/dist-cli/chunks/control-BM4V27OB.js +0 -2
- package/dist-cli/chunks/daemon-62MZT4G4.js +0 -67
- package/dist-cli/chunks/drivers-V6QDFZQD.js +0 -2
- package/dist-cli/chunks/flow-VBM6TU32.js +0 -2
- package/dist-cli/chunks/help-XWKNL743.js +0 -2
- package/dist-cli/chunks/home-paths-G23H3RO6.js +0 -2
- package/dist-cli/chunks/install-5YL7FITA.js +0 -2
- package/dist-cli/chunks/launch-DYFE4CAD.js +0 -16
- package/dist-cli/chunks/optional-demo-registry-JJXPB3UD.js +0 -2
- package/dist-cli/chunks/runtime-NRMC3U3D.js +0 -2
- package/dist-cli/chunks/runtime-delivery-RO6CTYPQ.js +0 -2
- package/dist-cli/chunks/setup-repo-AK6QOUE7.js +0 -2
- package/dist-cli/chunks/skills-KDSOWUOE.js +0 -10
- package/dist-cli/chunks/start-GH2AOUX6.js +0 -23
- package/dist-cli/chunks/store-JHW65VGQ.js +0 -2
- package/dist-cli/chunks/telemetry-SZLRXJXW.js +0 -2
- package/dist-cli/chunks/upload-KKEWETA5.js +0 -2
- package/dist-cli/chunks/version-37OD33SE.js +0 -4
- package/dist-cli/chunks/web-4JVMIBTB.js +0 -2
package/README.md
CHANGED
|
@@ -51,7 +51,8 @@ internally splits into a **shell worker** and a **tenant worker**.
|
|
|
51
51
|
graph TD
|
|
52
52
|
subgraph cli["sootsim CLI process (short-lived, cli/)"]
|
|
53
53
|
BIN["bin.ts (dispatcher + telemetry)"]
|
|
54
|
-
|
|
54
|
+
SETUP["commands/setup.ts (daemon + optional repo setup)"]
|
|
55
|
+
RUNTIMECMD["commands/runtime.ts (runtime install/use)"]
|
|
55
56
|
INSPECT["commands/inspect/* (describe/find/do/get/wait)"]
|
|
56
57
|
FLOW["bridge-flow-runner.ts (maestro + flow)"]
|
|
57
58
|
DETOXCMD["commands/detox.ts + detox/ driver"]
|
|
@@ -86,16 +87,17 @@ graph TD
|
|
|
86
87
|
CFG["config.json"]
|
|
87
88
|
end
|
|
88
89
|
CDN["sootbean.com CDN (runtimes/manifest.json + tarballs)"]
|
|
89
|
-
BIN -->
|
|
90
|
+
BIN --> SETUP
|
|
91
|
+
BIN --> RUNTIMECMD
|
|
90
92
|
BIN --> INSPECT
|
|
91
93
|
BIN --> FLOW
|
|
92
94
|
BIN --> DETOXCMD
|
|
93
95
|
BIN --> SHOTS
|
|
94
96
|
BIN --> AGENTCMD
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
97
|
+
SETUP --> LOCK
|
|
98
|
+
SETUP -->|"register launchd/systemd"| HOST
|
|
99
|
+
RUNTIMECMD --> RTDIR
|
|
100
|
+
RUNTIMECMD -->|"fetch runtime"| CDN
|
|
99
101
|
INSPECT --> WSB
|
|
100
102
|
FLOW --> WSB
|
|
101
103
|
SHOTS --> WSB
|
|
@@ -126,20 +128,20 @@ graph TD
|
|
|
126
128
|
```
|
|
127
129
|
|
|
128
130
|
**The CLI process** (`cli/bin.ts`) parses argv, emits invocation telemetry, and
|
|
129
|
-
lazy-imports exactly one command module per run.
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
131
|
+
lazy-imports exactly one command module per run. `sootsim setup` owns guided
|
|
132
|
+
one-time work: install the background daemon, optionally add the Metro/One
|
|
133
|
+
repo plugin, and optionally create the advanced config file. `sootsim open`
|
|
134
|
+
ensures the engine runtime exists and starts a local foreground bridge when no
|
|
135
|
+
daemon is reachable, then opens a `WsBridge` (`cli/ws-bridge.ts`) on **port
|
|
136
|
+
7668** and sends JSON commands. Inspection/interaction verbs live in
|
|
137
|
+
`cli/commands/inspect/*` and are re-exported as the programmatic `sootsim/sdk`;
|
|
138
|
+
the Maestro/flow runner is `cli/bridge-flow-runner.ts`; the Detox compat driver
|
|
139
|
+
is in `detox/`. Test and screenshot paths additionally use `cli/drivers/*`
|
|
140
|
+
(chromium, electron, playwright, system) to launch or attach the sim page before
|
|
141
|
+
driving it.
|
|
140
142
|
|
|
141
143
|
**The daemon is one process** — `SootSimBridgeHost` (`src/host/bridge-host.ts`).
|
|
142
|
-
`sootsim
|
|
144
|
+
`sootsim serve` runs it in the foreground; the background daemon is the *same
|
|
143
145
|
process* wrapped with autostart and the `~/.sootsim/daemon.json` lockfile. It is
|
|
144
146
|
an HTTP+WS hub: sims register over WS, CLI clients connect to drive them, and
|
|
145
147
|
the host forwards each command to the targeted sim and relays the reply back. It
|
|
@@ -173,30 +175,31 @@ distinguish the host page thread, the shell worker, and the tenant worker.)
|
|
|
173
175
|
|
|
174
176
|
| component | role | key files |
|
|
175
177
|
| --- | --- | --- |
|
|
176
|
-
| sootsim CLI (bin + dispatcher) | Short-lived terminal entry point. Parses argv, emits telemetry, lazy-imports one command per run, and
|
|
178
|
+
| sootsim CLI (bin + dispatcher) | Short-lived terminal entry point. Parses argv, emits telemetry, lazy-imports one command per run, and routes setup/open/runtime/inspection flows without a hidden bootstrap path. | `cli/bin.ts`, `cli/parse-args.ts`, `cli/help.ts`, `cli/commands/setup.ts`, `cli/commands/control.ts` |
|
|
177
179
|
| 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` |
|
|
178
180
|
| 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` |
|
|
179
181
|
| 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` |
|
|
180
182
|
| 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` |
|
|
181
|
-
| SootSimBridgeHost (
|
|
183
|
+
| SootSimBridgeHost (serve/daemon) | The bridge process (`sootsim serve`, or 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/serve.ts`, `cli/commands/daemon.ts`, `src/home-paths.ts` |
|
|
182
184
|
| 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` |
|
|
183
185
|
| 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` |
|
|
184
186
|
| 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` |
|
|
185
187
|
| `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` |
|
|
186
188
|
| `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` |
|
|
187
|
-
| skills registry |
|
|
189
|
+
| skills registry | SootSim agent skills (`sootsim-setup`, `sootsim-debug`, `sootsim-test`, `sootsim-visual`, and the generated `soot` index) installable with `sootsim skill`. | `skills/*.md`, `src/skills/registry.ts`, `src/skills/types.ts` |
|
|
188
190
|
|
|
189
191
|
## Getting started
|
|
190
192
|
|
|
191
193
|
```sh
|
|
192
194
|
npm i -g sootsim
|
|
193
|
-
|
|
195
|
+
sootsim setup # optional but recommended: installs the background daemon
|
|
194
196
|
sootsim open 8081 # load a running metro/expo dev server
|
|
195
197
|
```
|
|
196
198
|
|
|
197
|
-
CLI-first is the canonical path.
|
|
198
|
-
|
|
199
|
-
optional
|
|
199
|
+
CLI-first is the canonical path. `sootsim open` starts a local bridge when no
|
|
200
|
+
daemon is reachable; `sootsim setup` installs the faster background daemon and
|
|
201
|
+
offers optional repo integration. A desktop GUI (Electron) is optional on top,
|
|
202
|
+
via `sootsim install-desktop`. In Electron, `File > New Window`
|
|
200
203
|
duplicates the focused simulator, while `File > New Simulator >` opens a new
|
|
201
204
|
window for a selected device (same device list as the `Window >` menu).
|
|
202
205
|
|
|
@@ -214,24 +217,24 @@ inspection, interaction, animation debugging, shell tracing, screenshots, and
|
|
|
214
217
|
flow capture, not just as a test runner.
|
|
215
218
|
|
|
216
219
|
```sh
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
220
|
+
sootsim list # connected tabs
|
|
221
|
+
sootsim open 8081 # load a running metro/expo dev server
|
|
222
|
+
sootsim describe # dump UI tree
|
|
223
|
+
sootsim get errors 5 # recent runtime failures
|
|
224
|
+
sootsim find --testid cta # inspect one node deeply
|
|
225
|
+
sootsim debug enable animated,layout
|
|
226
|
+
sootsim debug trace shell on 240
|
|
227
|
+
sootsim do tap-text "..." # interact
|
|
228
|
+
sootsim debug snapshot before
|
|
229
|
+
sootsim debug snapshot after
|
|
230
|
+
sootsim debug diff before after
|
|
231
|
+
sootsim flow start # begin a draft
|
|
232
|
+
sootsim flow keep # persist the last action
|
|
233
|
+
sootsim flow end --output flows/login.yaml
|
|
234
|
+
sootsim test --detox # shared Detox-style parity suite against sootsim
|
|
232
235
|
```
|
|
233
236
|
|
|
234
|
-
See the full command reference via `
|
|
237
|
+
See the full command reference via `sootsim --help` or at
|
|
235
238
|
`src/features/site/docs/sootsim/cli/` in the SootBean repo.
|
|
236
239
|
|
|
237
240
|
## Bundler plugins (`sootsim/vite` and `sootsim/metro`)
|
|
@@ -270,8 +273,8 @@ no code changes — just add one line to your jest config:
|
|
|
270
273
|
Or use the CLI directly:
|
|
271
274
|
|
|
272
275
|
```sh
|
|
273
|
-
|
|
274
|
-
|
|
276
|
+
sootsim detox # auto-discovers e2e/ tests and launches a shell
|
|
277
|
+
sootsim detox init # scaffold a config + sample test
|
|
275
278
|
```
|
|
276
279
|
|
|
277
280
|
See `../../docs/migrating-from-detox.md` for details.
|
|
@@ -282,9 +285,9 @@ SootSim's flow runner natively speaks Maestro's YAML. Point it at your existing
|
|
|
282
285
|
`.maestro/` directory:
|
|
283
286
|
|
|
284
287
|
```sh
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
+
sootsim maestro # discover .maestro/ and run all flows
|
|
289
|
+
sootsim maestro test .maestro/ # explicit
|
|
290
|
+
sootsim maestro --list-compat # see the verb support matrix
|
|
288
291
|
```
|
|
289
292
|
|
|
290
293
|
Most Maestro verbs work out of the box (`tapOn`, `assertVisible`, `inputText`,
|
|
@@ -297,14 +300,14 @@ need real device hardware (GPS, radio, photo library) throw a clear error. See
|
|
|
297
300
|
For animation-heavy debugging, the useful path is usually:
|
|
298
301
|
|
|
299
302
|
```sh
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
+
sootsim debug enable animated
|
|
304
|
+
sootsim debug trace shell on 240
|
|
305
|
+
sootsim debug snapshot before
|
|
303
306
|
# reproduce the transition
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
307
|
+
sootsim debug snapshot after
|
|
308
|
+
sootsim debug diff before after
|
|
309
|
+
sootsim screenshot --with-frame --output /tmp/sootsim-framed.png
|
|
310
|
+
sootsim record --duration 5 --output /tmp/sootsim-anim.mp4
|
|
308
311
|
```
|
|
309
312
|
|
|
310
313
|
`sootsim screenshot --with-frame` composes the real SootSim shell device chrome
|
|
@@ -342,7 +345,7 @@ compose:
|
|
|
342
345
|
```
|
|
343
346
|
|
|
344
347
|
```sh
|
|
345
|
-
|
|
348
|
+
sootsim screenshots --plan .sootsim/app-store.yaml
|
|
346
349
|
```
|
|
347
350
|
|
|
348
351
|
The plan runner can reuse a visible sim for capture (`--sim a9`), stop after
|
|
@@ -366,11 +369,11 @@ frame for quick art-direction passes.
|
|
|
366
369
|
|
|
367
370
|
## Skills registry
|
|
368
371
|
|
|
369
|
-
`sootsim
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
from `packages/sootsim-skills/`:
|
|
372
|
+
`sootsim skill install` installs SootSim agent skills in the standard
|
|
373
|
+
`<skill-name>/SKILL.md` layout used by Codex and Claude Code. The bundled
|
|
374
|
+
skills cover setup, debugging/perf/accessibility, testing, visual review, and
|
|
375
|
+
the generated `soot` command index. The published CLI registry and generated
|
|
376
|
+
website docs both come from `packages/sootsim-skills/`:
|
|
374
377
|
|
|
375
378
|
- `packages/sootsim/skills/soot.md` is generated from that registry
|
|
376
379
|
- `src/features/site/docs/sootsim/cli/*` is generated output, not hand-edited
|
|
@@ -383,10 +386,10 @@ bun run generate:sootsim-docs
|
|
|
383
386
|
|
|
384
387
|
## Runtime delivery (the sootsim home and CDN)
|
|
385
388
|
|
|
386
|
-
The engine never ships inside this package. `
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
389
|
+
The engine never ships inside this package. `runtime-delivery.ts` resolves the
|
|
390
|
+
CDN origin (default `https://sootbean.com`, overridable in `config.json`),
|
|
391
|
+
fetches `runtimes/manifest.json` + the runtime tarball, verifies its sha256,
|
|
392
|
+
and unpacks it under `~/.sootsim`:
|
|
390
393
|
|
|
391
394
|
```
|
|
392
395
|
~/.sootsim/
|
package/detox/index.ts
CHANGED
|
@@ -237,7 +237,7 @@ async function waitForSootsimShellReady(page: Page, timeout = 30000): Promise<vo
|
|
|
237
237
|
})
|
|
238
238
|
if (transitionResult?.timedOut === true) {
|
|
239
239
|
throw new Error(
|
|
240
|
-
`sootsim launch transitions timed out: ${JSON.stringify(transitionResult)}`,
|
|
240
|
+
`sootsim app launch transitions timed out: ${JSON.stringify(transitionResult)}`,
|
|
241
241
|
)
|
|
242
242
|
}
|
|
243
243
|
}
|
|
@@ -1183,7 +1183,7 @@ export const device = {
|
|
|
1183
1183
|
|
|
1184
1184
|
// record the SootSim canvas via the engine's headless recorder
|
|
1185
1185
|
// (window.__sootsimRecorder — @sootsim/plugin-recording). this is the
|
|
1186
|
-
// SAME code path `
|
|
1186
|
+
// SAME code path `sootsim record video` drives, NOT the rail-button
|
|
1187
1187
|
// path (SootSim.bridges.startRecording wires the dialog state machine
|
|
1188
1188
|
// and never stashes the resulting blob into __sootsimRecorder.lastBlob,
|
|
1189
1189
|
// which is what getBlobBase64 streams from).
|
|
@@ -1226,7 +1226,7 @@ export const device = {
|
|
|
1226
1226
|
},
|
|
1227
1227
|
|
|
1228
1228
|
// stop the headless recorder, stream the resulting blob in chunks (same
|
|
1229
|
-
// protocol as `
|
|
1229
|
+
// protocol as `sootsim record`), and write the webm to outPath.
|
|
1230
1230
|
async stopAndSaveBridgeRecording(outPath: string): Promise<string> {
|
|
1231
1231
|
const page = getPage()
|
|
1232
1232
|
const stopResult = await page.evaluate(async () => {
|
package/dist-cli/bin.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
/*! sootsim v0.1.
|
|
3
|
-
import{a as u,b as d,c as g}from"./chunks/chunk-
|
|
2
|
+
/*! sootsim v0.1.171 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
|
|
3
|
+
import{a as u,b as d,c as g}from"./chunks/chunk-OSS2T3WP.js";import"./chunks/chunk-AOPGVSJW.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("sootsim bridge lockfile is fresh")||e.startsWith("sootsim bridge exited before becoming ready")||e.startsWith("background daemon setup is unavailable")||e.startsWith("sootsim bridge did not start within"))&&!process.env.SOOTSIM_VERBOSE&&(process.stderr.write(` ${e}
|
|
4
4
|
`),process.exit(1)),a instanceof Error&&a.stack?process.stderr.write(`${a.stack}
|
|
5
5
|
`):process.stderr.write(`${e}
|
|
6
6
|
`),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
|
|
7
7
|
it needs vite / electron / playwright from a project's node_modules.
|
|
8
8
|
install the npm package and run via bun or node instead:
|
|
9
9
|
npm i -g sootsim && sootsim ${a}
|
|
10
|
-
`),process.exit(1))}var t=g(process.argv);{let{trackCliEvent:a}=await import("./chunks/telemetry-
|
|
10
|
+
`),process.exit(1))}var t=g(process.argv);{let{trackCliEvent:a}=await import("./chunks/telemetry-WHOFSYSH.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-WHOFSYSH.js");await e(),process.exit(a)}if(t.version){let{getCliVersion:a}=await import("./chunks/cli-version-EQIZQ5NI.js"),{IS_BETA:e,BETA_LABEL:i}=await import("./chunks/beta-BLY4YCCD.js"),m=e?` \xB7 ${i}`:"";console.log(`sootsim v${a()}${m}`);let{readActiveRuntime:h}=await import("./chunks/home-paths-4JHJTIX5.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-G7XRDP3G.js");a(),await c(0)}var o=t.globalFlags.port,s=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,n=b?["--sim",b,...t.commandArgs]:t.commandArgs;if(p||l){let{settingsStore:a}=await import("./chunks/store-KKALNEVX.js"),e={};p&&(e.deviceModel=p),l&&(e.colorScheme=l),a.apply(e)}if(!t.command&&t.commandArgs.length===0){let{printHelp:a}=await import("./chunks/help-G7XRDP3G.js");a(),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-G7XRDP3G.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")){if(r==="skill"){let{runSkill:i}=await import("./chunks/skills-AGVA7E6K.js");await i(t.commandArgs),await c(0)}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-G7XRDP3G.js");i(r)&&await c(0)}else{let{printCommandHelp:i}=await import("./chunks/help-G7XRDP3G.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{runInspect:a}=await import("./chunks/inspect-RT36PPFH.js");await a([r,...n],{port:o,verbose:s})}else switch(r){case"assert":{let{runAssert:a}=await import("./chunks/assert-CXQAEBLS.js");await a(t.commandArgs);break}case"flow":{let{runFlow:a}=await import("./chunks/flow-OE7GVTNZ.js"),e=await a(n);process.exit(typeof e=="number"?e:0)}case"test":{let{runTest:a}=await import("./chunks/test-PFT2C45X.js");await a(t.commandArgs,{port:o,verbose:s});break}case"detox":{let{runDetox:a}=await import("./chunks/detox-UAPUROWZ.js");await a(t.commandArgs,{port:o,verbose:s});break}case"maestro":{let{runMaestro:a}=await import("./chunks/maestro-OTPRMCZ3.js"),e=await a(n,{port:o,verbose:s});process.exit(typeof e=="number"?e:0)}case"preview":{let{runPreview:a}=await import("./chunks/preview-JM3GALNL.js");await a(t.commandArgs,{port:o,verbose:s});break}case"record":{let{runRecord:a}=await import("./chunks/record-C6FA3WXN.js");await a(n,{port:o,verbose:s});break}case"profile":{let{runProfile:a}=await import("./chunks/profile-T2BO5XLW.js"),e=await a(t.commandArgs,{port:o,verbose:s});process.exit(typeof e=="number"?e:0)}case"cpu-profile":{let{runCpuProfile:a}=await import("./chunks/cpu-profile-EEAXEDDO.js"),e=await a(n,{port:o,verbose:s});process.exit(typeof e=="number"?e:0)}case"react":{let{runReact:a}=await import("./chunks/react-U3FQRLFA.js"),e=await a(n,{port:o,verbose:s});process.exit(typeof e=="number"?e:0)}case"screenshot":{let{runScreenshot:a}=await import("./chunks/screenshot-XPDBDFIK.js");await a(n,{port:o,verbose:s});break}case"screenshots":{if(t.commandArgs[0]==="capture"){let{runScreenshotsCapture:i}=await import("./chunks/screenshots-capture-TPGPJZ3J.js"),m=await i(t.commandArgs.slice(1));process.exit(typeof m=="number"?m:0)}let{runScreenshots:a}=await import("./chunks/screenshots-GVEUZFXL.js"),e=await a(n,{port:o,verbose:s});process.exit(typeof e=="number"?e:0)}case"screenshot-mode":{let{runScreenshotMode:a}=await import("./chunks/screenshot-mode-4FED7FGF.js");await a(t.commandArgs,{port:o,verbose:s});break}case"slides":{let{runSlides:a}=await import("./chunks/slides-Z7LW64IW.js");await a(n,{port:o,verbose:s});break}case"three-mode":case"3d-mode":{let{runThreeMode:a}=await import("./chunks/three-mode-HOCUD4BU.js");await a(t.commandArgs,{port:o,verbose:s});break}case"inspect":{let{runInspect:a}=await import("./chunks/inspect-RT36PPFH.js");await a(n,{port:o,verbose:s});break}case"debug":{let{runDebug:a}=await import("./chunks/debug-MW62345L.js");await a(n,{port:o,verbose:s});break}case"camera":{let{runCamera:a}=await import("./chunks/camera-XPZFAU3B.js");await a(n,{port:o});break}case"timeline":{let{runTimeline:a}=await import("./chunks/timeline-STMBOMTT.js");await a(n,{port:o,verbose:s});break}case"what-happened":{let{runWhatHappened:a}=await import("./chunks/what-happened-R5KC4F7B.js");await a(n,{port:o,verbose:s});break}case"diagnose":{let{runDiagnose:a}=await import("./chunks/diagnose-DL22YIRH.js"),e=await a(n,{port:o,verbose:s});process.exit(typeof e=="number"?e:0)}case"open":{let{runOpenCommand:a}=await import("./chunks/control-LF34QRMZ.js");await a(n,{port:o});break}case"use":case"focus":{let{runUseCommand:a}=await import("./chunks/control-LF34QRMZ.js");await a(n,{port:o});break}case"claim":{let{runClaimCommand:a}=await import("./chunks/control-LF34QRMZ.js");await a(n,{port:o});break}case"close":{let{runCloseCommand:a}=await import("./chunks/control-LF34QRMZ.js");await a(n,{port:o});break}case"device":{let{runDeviceCommand:a}=await import("./chunks/device-IWWFCELP.js");await a(n,{port:o});break}case"scan":case"compat":{let{runCompat:a}=await import("./chunks/compat-32AVWHB7.js");await a(t.commandArgs);break}case"electron":{let{runElectron:a}=await import("./chunks/electron-KDVB42AG.js");await a(t.commandArgs,{port:o,device:p,driver:S});break}case"login":{let{runLogin:a}=await import("./chunks/login-PLPGPVOR.js");await a(t.commandArgs);break}case"logout":{let{runLogout:a}=await import("./chunks/logout-3NCVFTBB.js");await a();break}case"whoami":{let{runWhoami:a}=await import("./chunks/whoami-DWRGFQKR.js");await a();break}case"keys":{let{runKeys:a}=await import("./chunks/keys-PS5IUZ2M.js");await a(t.commandArgs);break}case"setup":{let{runSetup:a}=await import("./chunks/setup-BGRJTFGF.js");await a(t.commandArgs);break}case"install-desktop":{let{runInstallDesktop:a}=await import("./chunks/install-desktop-MXUBQ6NJ.js");await a(t.commandArgs);break}case"serve":{let{runServe:a}=await import("./chunks/serve-5G4JU44V.js");await a(t.commandArgs,{port:o});break}case"daemon":{let{runDaemon:a}=await import("./chunks/daemon-MUQQZ64R.js");await a(t.commandArgs,{port:o});break}case"runtime":{let{runRuntime:a}=await import("./chunks/runtime-IGGC2EEX.js");await a(t.commandArgs);break}case"upgrade":{let{runUpgrade:a}=await import("./chunks/upgrade-UXMJ73RU.js");await a(t.commandArgs);break}case"version":{let{runVersion:a}=await import("./chunks/version-FNSM3CIG.js");await a(t.commandArgs);break}case"agent":{let{runAgentCommand:a}=await import("./chunks/agent-J4NTKR6V.js"),e=await a(t.commandArgs);process.exit(e)}case"agent-wrapper":{let{runAgentWrapper:a}=await import("./chunks/agent-wrapper-V2TD3UZR.js"),e=await a(t.commandArgs);process.exit(e)}case"skill":{let{runSkill:a}=await import("./chunks/skills-AGVA7E6K.js");await a(t.commandArgs);break}case"upload":{let{runUpload:a}=await import("./chunks/upload-NJTGOKHA.js");await a(t.commandArgs,{port:o,verbose:s});break}case"app-fonts":{let{runAppFonts:a}=await import("./chunks/app-fonts-ROVXMKLG.js");await a(t.commandArgs);break}case"hints":{let{runHints:a}=await import("./chunks/hints-GNVLVDPN.js");a(t.commandArgs);break}default:console.error(` unknown command: ${r}`),console.error(" run `sootsim --help` to see the full surface."),process.exit(1)}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/*! sootsim v0.1.171 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
|
|
2
|
+
import{a as b,b as E,c as A,d as l,e as S,g as j,h as T,j as I,m as D,n as k,o as x,p as g,q as O,r as R}from"./chunk-WPEXAZSS.js";import"./chunk-HBR56XPR.js";import{c as $}from"./chunk-RXBB4S3Q.js";import"./chunk-QIMO6SQX.js";import"./chunk-B77QXVTZ.js";import"./chunk-YPHT4BSL.js";import"./chunk-MBVNBHRK.js";import"./chunk-3OFDUWRM.js";import"./chunk-WXPG6OS6.js";import"./chunk-O54LARIO.js";import{j as y}from"./chunk-RULKWLIO.js";import"./chunk-AHOHHXWK.js";import"./chunk-RJZRI3P3.js";import"./chunk-CVLJ4RMA.js";import"./chunk-AOPGVSJW.js";import w from"node:fs";import d from"node:path";import{spawn as _}from"node:child_process";import F from"node:net";import{WebSocket as C}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 C(`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!==C.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 M(n=7668,e=400){return new Promise(t=>{let r=new F.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 B(n={}){let e=n.port??7668;if(await M(e))return{alreadyRunning:!0};if(y())throw new c(`no sootsim bridge on port ${e}. run \`sootsim setup\` to install the background daemon, or \`sootsim serve\` in another shell.`,"DEV_HOST_REFUSED");let{cmd:t,prefixArgs:r}=R(),s=[...r,"serve","--quiet"];e!==7668&&s.push("--port",String(e));let o=_(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 M(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 serve\` manually to diagnose.`,"SPAWN_TIMEOUT")}async function h(n={}){await B({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 ge(n){let[e,...t]=n;try{switch(e){case void 0:case"--help":case"-h":case"help":return L(),0;case"attach":return await W(t);case"projects":return await J();case"project":return await V(t);case"sessions":return await H(t);case"start":return await G(t);case"prompt":return await q(t);case"watch":return await K(t);case"transcript":return await z(t);case"end":return await Q(t);case"paths":return await Y();default:return process.stderr.write(`unknown agent subcommand: ${e}
|
|
3
|
+
`),L(),2}}catch(r){if(r instanceof c)return process.stderr.write(`${r.message}
|
|
4
|
+
`),1;throw r}}async function v(n){let e=await h({clientLabel:"sootsim-agent-cli"});try{return await n(e)}finally{e.close()}}function L(){$("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 W(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]
|
|
5
|
+
`),2;let s=d.resolve(r);if(!w.existsSync(s))return process.stderr.write(`directory does not exist: ${s}
|
|
6
|
+
`),1;let o=A({cwd:s,name:e["--name"]||d.basename(s),preferredProvider:U(e["--provider"]),sourceRoots:[s]});return process.stdout.write(`\u2713 attached "${o.name}" (id: ${o.id})
|
|
7
|
+
cwd: ${o.cwd}
|
|
8
|
+
framework: ${o.framework}
|
|
9
|
+
preferred provider: ${o.preferredProvider}
|
|
10
|
+
`),0}async function J(){let n=[...S()].sort((t,r)=>r.updatedAt-t.updatedAt);if(n.length===0)return process.stdout.write("no attached projects yet. try `sootsim agent attach <dir>`.\n"),0;let e=`${"ID".padEnd(18)} ${"NAME".padEnd(20)} ${"FRAMEWORK".padEnd(10)} ${"PROVIDER".padEnd(8)} ${"7D COST".padEnd(10)} CWD
|
|
11
|
+
`;process.stdout.write(e);for(let t of n){let r=j(t),s=r>0?`$${r.toFixed(2)}`:"\u2014";process.stdout.write(`${t.id.padEnd(18)} ${p(t.name,20).padEnd(20)} ${t.framework.padEnd(10)} ${t.preferredProvider.padEnd(8)} ${s.padEnd(10)} ${t.cwd}
|
|
12
|
+
`)}return 0}async function V(n){let[e,t]=n;if(e==="show"){if(!t)return process.stderr.write(`usage: sootsim agent project show <id>
|
|
13
|
+
`),2;let r=l(t);return r?(process.stdout.write(JSON.stringify(r,null,2)+`
|
|
14
|
+
`),0):(process.stderr.write(`no project with id=${t}
|
|
15
|
+
`),1)}return e==="remove"?t?(T(t),process.stdout.write(`\u2713 removed project ${t}
|
|
16
|
+
`),0):(process.stderr.write(`usage: sootsim agent project remove <id>
|
|
17
|
+
`),2):(process.stderr.write(`usage: sootsim agent project [show|remove] <id>
|
|
18
|
+
`),2)}async function H(n){let{flags:e}=P(n,{"--project":"value","--all":"bool"}),t=e["--project"]||void 0,r=e["--all"]===!0,s=I(t);if(r||(s=s.filter(i=>i.status!=="ended")),s=s.sort((i,a)=>a.lastSeenAt-i.lastSeenAt),s.length===0)return process.stdout.write(r?`no sessions.
|
|
19
|
+
`:`no active sessions. pass --all to include ended.
|
|
20
|
+
`),0;let o=`${"SESSION".padEnd(26)} ${"PROJECT".padEnd(18)} ${"PROVIDER".padEnd(8)} ${"STATUS".padEnd(16)} ${"ALIVE".padEnd(5)} LAST PROMPT
|
|
21
|
+
`;process.stdout.write(o);for(let i of s){let a=O(i.wrapperPid,i.id)?"yes":"no",m=i.lastPrompt?p(i.lastPrompt,40):"";process.stdout.write(`${N(i.id).padEnd(26)} ${N(i.projectId).padEnd(18)} ${i.provider.padEnd(8)} ${i.status.padEnd(16)} ${a.padEnd(5)} ${m}
|
|
22
|
+
`)}return 0}async function G(n){let{flags:e,positional:t}=P(n,{"--provider":"value","--codex-bin":"value","--claude-bin":"value","--fresh-thread":"bool"}),r=t[0];if(!r)return process.stderr.write(`usage: sootsim agent start <projectId> [--provider codex|claude] [--fresh-thread]
|
|
23
|
+
`),2;let s=await v(i=>i.startSession({projectId:r,provider:U(e["--provider"],void 0)||void 0,codexBin:e["--codex-bin"]||void 0,claudeBin:e["--claude-bin"]||void 0,freshThread:e["--fresh-thread"]===!0})),o=l(s.session.projectId);return process.stdout.write(`\u2713 session ${s.session.id} started
|
|
24
|
+
project: ${o.name} (${o.id})
|
|
25
|
+
provider: ${s.session.provider}
|
|
26
|
+
pid: ${s.wrapperPid}
|
|
27
|
+
prompt with: sootsim agent prompt ${s.session.id} "<text>"
|
|
28
|
+
watch events: sootsim agent watch ${s.session.id}
|
|
29
|
+
`),0}async function q(n){let[e,...t]=n,r=t.join(" ");return!e||!r?(process.stderr.write(`usage: sootsim agent prompt <sessionId> "<text>"
|
|
30
|
+
`),2):(await v(s=>s.sendPrompt(e,{text:r})),process.stdout.write(`\u2713 prompt sent to ${e}
|
|
31
|
+
`),0)}async function K(n){let e=n[0];if(!e)return process.stderr.write(`usage: sootsim agent watch <sessionId>
|
|
32
|
+
`),2;process.stdout.write(`watching ${e}
|
|
33
|
+
---
|
|
34
|
+
`);let t=await h({clientLabel:"sootsim-agent-watch"}),r,s=new Promise(a=>{r=a}),o=t.onAgentEvent(({sessionId:a,event:m})=>{a===e&&process.stdout.write(X(m)+`
|
|
35
|
+
`)}),i=t.onDisconnect(()=>{process.stderr.write(`
|
|
36
|
+
[sootsim] daemon disconnected; exiting watch.
|
|
37
|
+
`),r(1)});try{await t.subscribeEvents(e)}catch(a){throw o(),i(),t.close(),a}return process.on("SIGINT",()=>{o(),i(),t.unsubscribeEvents(e).catch(()=>{}),t.close(),r(130)}),s}function X(n){let e=Z(n.ts);switch(n.type){case"ready":return`[${e}] ready ${n.provider} @ ${n.cwd}`;case"prompt-received":return`[${e}] prompt "${p(n.text,120)}"`;case"turn-started":return`[${e}] turn-started ${n.turnId??""}`;case"turn-message":return`[${e}] turn-message ${n.delta.replace(/\s+$/,"")}`;case"turn-reasoning":return`[${e}] turn-reasoning ${p(n.delta,200)}`;case"tool-call":return`[${e}] tool-call ${n.name}`;case"file-edited":return`[${e}] file-edited ${n.kind.padEnd(6)} ${n.path}`;case"turn-completed":return`[${e}] turn-completed ${n.durationMs}ms files=${n.filesTouched.length}`;case"approval-needed":return`[${e}] approval ${n.kind}`;case"error":return`[${e}] error ${n.message}`;case"exited":return`[${e}] exited code=${n.code}`;case"file-diff-delta":return`[${e}] file-diff-delta ${n.path}`;case"turn-plan":return`[${e}] turn-plan steps=${n.steps.length}`;default:return`[${e}] ${n.type}`}}async function z(n){let e=n[0];if(!e)return process.stderr.write(`usage: sootsim agent transcript <sessionId>
|
|
38
|
+
`),2;let t=g(e);return w.existsSync(t)?(process.stdout.write(w.readFileSync(t,"utf8")),0):(process.stderr.write(`transcript not found: ${t}
|
|
39
|
+
`),1)}async function Q(n){let e=n[0];return e?(await v(t=>t.endSession(e)),process.stdout.write(`\u2713 ended session ${e}
|
|
40
|
+
`),0):(process.stderr.write(`usage: sootsim agent end <sessionId>
|
|
41
|
+
`),2)}async function Y(){let n=E();return process.stdout.write(`userData: ${n}
|
|
42
|
+
state: ${d.join(n,"attached-projects.json")}
|
|
43
|
+
sessions: ${d.join(n,"sessions")}
|
|
44
|
+
transcripts: ${d.join(n,"transcripts")}
|
|
45
|
+
locks: ${d.join(n,"locks")}
|
|
46
|
+
`),0}function p(n,e){return n.length<=e?n:n.slice(0,e-1)+"\u2026"}function N(n){return n.length>14?`${n.slice(0,14)}\u2026`:n}function Z(n){return new Date(n).toISOString().replace("T"," ").slice(0,19)}var fe={sessionDir:D,promptFifoPath:k,eventsFifoPath:x,transcriptPath:g,parseAgentEventLine:b};export{fe as __internals,ge as runAgentCommand};
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
/*! sootsim v0.1.
|
|
2
|
-
import{b as M}from"./chunk-
|
|
1
|
+
/*! sootsim v0.1.171 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
|
|
2
|
+
import{b as M}from"./chunk-HBR56XPR.js";import"./chunk-AOPGVSJW.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)+`
|
|
3
3
|
`)}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>
|
|
4
4
|
--provider codex|claude --cwd <path>
|
|
5
5
|
--prompt-in <fifo> --events-out <fifo>
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
/*! sootsim v0.1.
|
|
2
|
-
import{d as p}from"./chunk-
|
|
1
|
+
/*! sootsim v0.1.171 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
|
|
2
|
+
import{d as p}from"./chunk-KT55MHRH.js";import"./chunk-AOPGVSJW.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};
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
/*! sootsim v0.1.
|
|
2
|
-
import"./chunk-
|
|
1
|
+
/*! sootsim v0.1.171 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
|
|
2
|
+
import"./chunk-AOPGVSJW.js";import{spawn as x}from"child_process";var w=new Set(["describe","find","list","network","logs","count","tree","url","a11y","node","layout","keyboard","errors","warnings","requests","animations","animation","state","sample-color"]),S=new Set(["--exists","--empty","--negate","--quiet","--allow-timeout","!"]),q=new Set(["--count","--count-at-least","--count-at-most","--contains","--not-contains","--matches","--not-matches","--equals","--jq","--has-path","--within"]),P=new Set(["--path-equals"]);function j(s){let r=[],u=[],n=0,e=!1,t=!1,i=!1;for(let o=0;o<s.length;o++){let a=s[o];if(a==="--within"){let c=Number(s[o+1]);if(!Number.isFinite(c)||c<0)return{error:`--within requires a non-negative number, got: ${s[o+1]}`};n=c,o++;continue}if(a==="--negate"||a==="!"){e=!0;continue}if(a==="--quiet"){t=!0;continue}if(a==="--allow-timeout"){i=!0;continue}if(S.has(a)){u.push({kind:a,args:[]});continue}if(q.has(a)){let c=s[o+1];if(c==null)return{error:`${a} requires a value`};u.push({kind:a,args:[c]}),o++;continue}if(P.has(a)){let c=s[o+1],f=s[o+2];if(c==null||f==null)return{error:`${a} requires <path> <value>`};u.push({kind:a,args:[c,f]}),o+=2;continue}r.push(a)}return r.length===0?{error:"assert requires a verb (e.g. find, describe, get errors)"}:{verbArgs:r,predicates:u,withinMs:n,negate:e,quiet:t,allowTimeout:i}}function N(s){return s[0]==="get"||s[0]==="debug"?w.has(s[1])?s[1]:null:s[0]==="do"||s[0]==="wait"?null:w.has(s[0])?s[0]:null}async function R(s){let u=[process.argv[1],...s,"--json"];return new Promise(n=>{let e=x(process.execPath,u,{stdio:["ignore","pipe","pipe"],env:process.env}),t="",i="";e.stdout.on("data",o=>t+=o.toString()),e.stderr.on("data",o=>i+=o.toString()),e.on("error",o=>{n({ok:!1,payload:null,reason:`spawn failed: ${o.message}`})}),e.on("close",o=>{if(o!==0){let a=i.trim().split(`
|
|
3
3
|
`).slice(-2).join(" | ").slice(0,200);n({ok:!1,payload:null,reason:`verb exited ${o}${a?`: ${a}`:""}`});return}if(!t.trim()){n({ok:!1,payload:null,reason:"verb produced no output"});return}try{let a=JSON.parse(t);n({ok:!0,payload:a})}catch{n({ok:!1,payload:null,reason:`verb output was not valid json: ${t.slice(0,120)}`})}})})}function y(s,r){let u=r.split(".").filter(e=>e.length>0),n=s;for(let e of u){if(n==null)return{found:!1};if(Array.isArray(n)){let t=Number(e);if(!Number.isInteger(t)||t<0||t>=n.length)return{found:!1};n=n[t];continue}if(typeof n=="object"){let t=n;if(!(e in t))return{found:!1};n=t[e];continue}return{found:!1}}return{found:!0,value:n}}function d(s){return Array.isArray(s)?s.length:s&&typeof s=="object"?Object.keys(s).length:null}async function A(s,r){let{kind:u,args:n}=s;switch(u){case"--exists":return r==null?{ok:!1,reason:"payload is null"}:d(r)===0?{ok:!1,reason:"payload is empty"}:{ok:!0,reason:"exists"};case"--empty":{if(r==null)return{ok:!0,reason:"payload is null"};let e=d(r);return e===0?{ok:!0,reason:"payload is empty"}:{ok:!1,reason:`payload has ${e} item(s)`}}case"--count":{let e=Number(n[0]),t=d(r);return t==null?{ok:!1,reason:`payload not countable (${typeof r})`}:{ok:t===e,reason:`count=${t}, want=${e}`}}case"--count-at-least":{let e=Number(n[0]),t=d(r);return t==null?{ok:!1,reason:"payload not countable"}:{ok:t>=e,reason:`count=${t}, want>=${e}`}}case"--count-at-most":{let e=Number(n[0]),t=d(r);return t==null?{ok:!1,reason:"payload not countable"}:{ok:t<=e,reason:`count=${t}, want<=${e}`}}case"--contains":{let e=n[0],t=JSON.stringify(r);return{ok:t.includes(e),reason:t.includes(e)?`contains "${e}"`:`missing "${e}"`}}case"--not-contains":{let e=n[0],t=JSON.stringify(r);return{ok:!t.includes(e),reason:t.includes(e)?`unexpected "${e}"`:`not contains "${e}"`}}case"--matches":{let e=new RegExp(n[0]),t=JSON.stringify(r),i=e.test(t);return{ok:i,reason:i?`matches /${n[0]}/`:`no match for /${n[0]}/`}}case"--not-matches":{let e=new RegExp(n[0]),t=JSON.stringify(r),i=!e.test(t);return{ok:i,reason:i?`not matches /${n[0]}/`:`unexpected /${n[0]}/`}}case"--equals":{let e=n[0],t=typeof r=="string"?r:typeof r=="number"||typeof r=="boolean"?String(r):JSON.stringify(r);return{ok:t===e,reason:`got=${JSON.stringify(t)}, want=${JSON.stringify(e)}`}}case"--has-path":{let e=y(r,n[0]);return{ok:e.found,reason:e.found?`path ${n[0]} present`:`path ${n[0]} missing`}}case"--path-equals":{let[e,t]=n,i=y(r,e);if(!i.found)return{ok:!1,reason:`path ${e} missing`};let o=typeof i.value=="string"||typeof i.value=="number"||typeof i.value=="boolean"?String(i.value):JSON.stringify(i.value);return{ok:o===t,reason:`${e}=${o}, want=${t}`}}case"--jq":{let e=n[0];try{let i=(await O(e,r)).trim();return{ok:i.length>0&&i!=="null"&&i!=="false"&&i!=='""',reason:`jq: ${i.slice(0,120)}`}}catch(t){throw new Error(`jq evaluation failed: ${t.message}`)}}default:return{ok:!1,reason:`unknown predicate ${u}`}}}function O(s,r){return new Promise((u,n)=>{let e=x("jq",[s],{stdio:["pipe","pipe","pipe"]}),t="",i="";e.stdout.on("data",o=>t+=o.toString()),e.stderr.on("data",o=>i+=o.toString()),e.on("error",n),e.on("close",o=>{if(o!==0){n(new Error(i.trim()||`jq exited ${o}`));return}u(t)}),e.stdin.end(JSON.stringify(r))})}async function T(s){(s[0]==="--help"||s[0]==="-h"||s.length===0)&&(J(),process.exit(s.length===0?2:0));let r=j(s);"error"in r&&(process.stderr.write(` assert: ${r.error}
|
|
4
4
|
`),process.exit(2));let{verbArgs:u,predicates:n,withinMs:e,negate:t,quiet:i,allowTimeout:o}=r;N(u)||(process.stderr.write(` assert: unknown or non-read verb: ${u.join(" ")}
|
|
5
5
|
supported: ${Array.from(w).sort().join(", ")}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
/*! sootsim v0.1.
|
|
2
|
-
import{m as f}from"./chunk-
|
|
1
|
+
/*! sootsim v0.1.171 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
|
|
2
|
+
import{m as f}from"./chunk-OTN33CWO.js";import"./chunk-X4VXITOI.js";import{c as m,e as l,g as p}from"./chunk-CJTJX3H7.js";import"./chunk-WXPG6OS6.js";import"./chunk-O54LARIO.js";import"./chunk-RULKWLIO.js";import"./chunk-AOPGVSJW.js";function d(){console.log(`
|
|
3
3
|
sootsim camera \u2014 drive the sim camera
|
|
4
4
|
|
|
5
5
|
usage:
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/*! sootsim v0.1.171 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
|
|
2
|
+
import{a as F,b as Q,c as Y,d as ye,e as Se}from"./chunk-QBCJDPG3.js";import{m as N}from"./chunk-OTN33CWO.js";import{m as ge,o as we}from"./chunk-X4VXITOI.js";import{g as te}from"./chunk-DR3E2NVD.js";import{a as U,b as Z}from"./chunk-J7DI5B4Y.js";import{c as ve}from"./chunk-I5XY2BFR.js";import{a as xe,b as ke}from"./chunk-JQW2OOL5.js";import{a as $e,b as X,c as Ie}from"./chunk-KT55MHRH.js";import{b as be,c as I,d as y,e as x}from"./chunk-CJTJX3H7.js";import{d as ee}from"./chunk-ICA7K635.js";import{a as he}from"./chunk-3OFDUWRM.js";import{d as M,e as b,f as T}from"./chunk-O54LARIO.js";import{D as fe,I as A,K as C,l as pe}from"./chunk-RULKWLIO.js";import{spawn as Oe}from"node:child_process";import R from"node:fs";import Ye from"node:os";import k from"node:path";import{WebSocket as Xe}from"ws";function We(e){return e.replace(/^\[|\]$/g,"").toLowerCase()}function H(e){let t=We(e);return t==="localhost"||t.endsWith(".localhost")||t==="0.0.0.0"||t==="::1"||/^127(?:\.\d{1,3}){3}$/.test(t)}function Pe(e){return new Error(`could not resolve a native bundle for ${e}. pass an explicit bundle URL or open Connect and choose the app there.`)}function je(e,t){return e?.includes("/one/metro-entry.bundle")?"one":typeof t=="string"&&t?"expo":"unknown"}function Me(e,t,o){return`${e}//${t}:${o}`}function ze(e){if(typeof window>"u")return!1;try{let t=new URL(e);return H(t.hostname)&&H(window.location.hostname)&&t.origin!==window.location.origin}catch{return!1}}async function Ce(e,t){let o={...t,cache:t?.cache??"no-store"};return ze(e)?fetch(`/__fetch-proxy?url=${encodeURIComponent(e)}`,o):fetch(e,o)}function qe(e){return e==="https:"?443:80}function Ve(e){let t=e.pathname||"/";return(t==="/"||t==="")&&!e.search&&!e.hash}async function Ge(e){try{let t=await fetch("/__server-scan",{cache:"no-store"});if(!t.ok||!(t.headers.get("content-type")||"").toLowerCase().includes("json"))return null;let o=await t.json();if(!Array.isArray(o))return null;let n=o.find(r=>!!r&&typeof r=="object"&&r.port===e&&typeof r.bundleUrl=="string");return n?{bundleUrl:Y(n.bundleUrl),port:e,framework:typeof n.framework=="string"?n.framework:"unknown",projectName:typeof n.projectName=="string"?n.projectName:void 0}:null}catch{return null}}async function Te(e,t){let o=e.replace(/\/+$/,"");try{if(H(new URL(o).hostname)){let n=await Ge(t);if(n)return n}}catch{}try{let n=await Ce(`${o}/`,{headers:{"expo-platform":"ios"}});if(n.ok){let r=await n.json(),s=r?.extra?.expoClient||r?.extra||{},i=typeof r?.launchAsset?.url=="string"?r.launchAsset.url:void 0;if(i||s.name)return{bundleUrl:Y(i||`${o}${Q}`),port:t,framework:je(i,s.sdkVersion),projectName:s.name}}}catch{}try{let n=await Ce(`${o}/status`);if(n.ok&&(await n.text()).includes("packager-status:running"))return{bundleUrl:`${o}${Q}`,port:t,framework:"metro"}}catch{}return null}async function Je(e){return Te(Me("http:","localhost",e),e)}async function Ue(e){let t=e.trim();if(/^\d+$/.test(t)){let a=parseInt(t,10),l=await Je(a);if(l)return l;throw Pe(`localhost:${a}`)}let o=t.startsWith("http")?t:`http://${t}`,n;try{n=new URL(o)}catch{throw new Error(`could not parse "${e}". pass a dev-server port, a dev-server base URL, or a full bundle URL.`)}let r=n.protocol||"http:",s=n.port?parseInt(n.port,10):qe(r),i=Me(r,n.hostname,s);if(Ve(n)){let a=await Te(i,s);if(a)return a;throw Pe(i)}return{bundleUrl:n.toString(),port:s,framework:"unknown"}}function Ht(){console.error(" no sootsim desktop companion found."),console.error(""),console.error(" install the desktop app:"),console.error(" sootsim install-desktop"),console.error(""),console.error(" or run setup to install the background daemon:"),console.error(" sootsim setup"),console.error("")}function Ee(e){let t=U();if(console.log(` note: no sootsim bridge detected on port ${e}`),t){console.log(" launch the installed companion with:"),console.log(" sootsim electron");return}console.log(""),console.log(" run `sootsim setup` to install the background daemon,"),console.log(" or run `sootsim serve` in another shell for a foreground bridge.")}function Qe(e){console.error(""),console.error(` no sim is connected to the sootsim bridge on port ${e}.`),console.error(""),console.error(" start your app dev server, then open it in sootsim:"),console.error(" npx expo start --localhost --port 8081"),console.error(" sootsim open 8081"),console.error(""),console.error(" then inspect the live app:"),console.error(" sootsim describe")}async function Kt(e,t,o){let n=[];try{n=await e.listSims()}catch{}if(console.error(""),n.length===0){Qe(t);return}console.error(` no sim with id "${o}" is connected to the bridge on port ${t}.`),console.error(""),console.error(" connected sims:");for(let r of n){let s=[r.isPrimary?"primary":null,r.readyState,r.userVisible===!1?"hidden":r.userVisible===!0?"visible":null,r.userFocused?"focused":null].filter(Boolean).join(", ");console.error(` ${r.id} (${s})`)}console.error(""),console.error(" pass a valid --sim id, or run `sootsim list` to see all sessions.")}var Ze=12e4,Re=500,et=5e3,_e=1e4,tt={rn:"/rn",connectrn:"/rn","connect-rn":"/rn",clock:"/app/clock","native-ui":"/app/native-ui",tamagui:"/app/tamagui",settings:"/app/settings",photos:"/app/photos",camera:"/app/camera"};function v(e){return new Promise(t=>setTimeout(t,e))}function Be(e){let t=process.env[e]?.trim();if(!t)return null;let o=Number(t);return Number.isInteger(o)&&o>0?o:null}function ot(){let e=Be("SOOTSIM_DRIVER_CONNECT_TIMEOUT_MS")??Be("SOOTSIM_PW_CONNECT_TIMEOUT_MS")??Ze;return{timeoutMs:e,hostTimeoutMs:e+et,intervalMs:Re,attempts:Math.max(1,Math.ceil(e/Re))}}function nt(e){return e==="chromium"||e==="electron"||e==="playwright"||e==="system"}function rt(e,t){return e.includes("--headless")?!0:e.includes("--headed")?!1:t==="playwright"&&process.platform==="linux"&&!process.env.DISPLAY&&!process.env.WAYLAND_DISPLAY?(console.error(" no display detected \u2192 running playwright headless (override with --headed)"),!0):!1}function j(e){return e.trim()}async function st(e){if(await K(e,250))return e;let t=A();if(t&&C(t)&&await K(t.bridgePort,500))return t.bridgePort;if(t&&C(t))throw new Error(`sootsim bridge lockfile is fresh (port ${t.bridgePort}) but the bridge is not reachable. run \`sootsim daemon restart\` or \`sootsim daemon uninstall\`.`);await it();let o=at(["serve","--quiet","--port",String(e)]),n=null;o.once("exit",(s,i)=>{n=String(s??i??"unknown")}),o.unref();let r=Date.now()+_e;for(;Date.now()<r;){let s=A();if(s&&C(s)&&await K(s.bridgePort,250))return console.error(` started local bridge on port ${s.bridgePort}; run \`sootsim setup\` to install the background daemon`),s.bridgePort;if(await K(e,250))return console.error(` started local bridge on port ${e}; run \`sootsim setup\` to install the background daemon`),e;if(n)throw new Error(`sootsim bridge exited before becoming ready (exit ${n})`);await v(150)}throw new Error(`sootsim bridge did not start within ${Math.round(_e/1e3)}s`)}async function it(){let e=fe();if(e&&R.existsSync(pe(e)))return;console.error(" installing sootsim engine runtime...");let{runRuntime:t}=await import("./runtime-IGGC2EEX.js");await t(["install"],{})}function at(e){let t=process.argv[1];return t&&R.existsSync(t)?Oe(process.execPath,[t,...e],{detached:!0,stdio:"ignore",env:process.env}):Oe("sootsim",e,{detached:!0,stdio:"ignore",env:process.env})}function K(e,t){return new Promise(o=>{let n=new Xe(`ws://127.0.0.1:${e}`,{handshakeTimeout:t}),r=!1,s=i=>{if(!r){r=!0;try{n.close()}catch{}o(i)}};n.once("open",()=>s(!0)),n.once("error",()=>s(!1)),setTimeout(()=>s(!1),t)})}function re(e){try{let t=new URL(e),o=t.pathname.replace(/\/+$/,"")||"/";return t.searchParams.has("open")||t.searchParams.has("port")||t.searchParams.has("bundle")||t.searchParams.has("demo")||t.pathname.includes("/sootsim/index.html")||o==="/sootsim"||t.pathname==="/__soot"||t.pathname==="/__soot/"||o==="/rn"||/^\/rn\/[^/]+$/i.test(o)||/^\/app\/[^/]+$/i.test(o)||o==="/__soot/rn"||/^\/__soot\/rn\/[^/]+$/i.test(o)||/^\/__soot\/app\/[^/]+$/i.test(o)}catch{return!1}}function lt(e){try{let t=new URL(e).pathname.replace(/\/+$/,"")||"/";return/^\/preview\/[^/]+$/.test(t)||/^\/build\/.+/.test(t)}catch{return!1}}async function po(e){let t=j(e);return(await Ne(t)).bundleUrl}function ct(e){try{let t=new URL(e.startsWith("http")?e:`http://${e}`),o=t.pathname||"/";if(o!=="/"&&o!==""||t.search||t.hash||!/^(localhost|127\.0\.0\.1|\[::1\]|::1)$/i.test(t.hostname))return null;let n=t.port?Number(t.port):t.protocol==="https:"?443:80;return Number.isFinite(n)&&n>0?n:null}catch{return null}}async function Ne(e){let t=j(e),o=/^\d+$/.test(t)?Number(t):ct(t);if(o&&o>0){let n=await Se(o);if(n)return{bundleUrl:n.bundleUrl,port:n.port,framework:n.framework,projectName:n.projectName}}return Ue(t)}function ie(e){let t=e.replace(/\/+$/,"")||"/";return t==="/__soot"||t.startsWith("/__soot/")?"/__soot":""}function dt(e,t){let o=j(e),n=new URL(t),r=ie(n.pathname);return n.pathname=`${r}/rn`,n.searchParams.delete("bundle"),n.searchParams.delete("demo"),n.searchParams.delete("app"),n.searchParams.delete("open"),n.searchParams.delete("port"),/^\d+$/.test(o)?n.pathname=`${r}/rn/${o}`:(n.pathname=`${r}/rn`,n.searchParams.set("open",o)),n.toString()}function mt(e){let t=j(e);return/^\d+$/.test(t)||/^https?:\/\//i.test(t)?!0:/^(localhost|127\.0\.0\.1|\[::1\]|[^/]+\.localhost):\d+(?:\/.*)?$/i.test(t)}async function ut(e,t,o={}){let n=await Ne(e),r=new URL(t),s=ie(r.pathname);r.pathname=`${s}/rn`,r.searchParams.delete("open"),r.searchParams.delete("port"),r.searchParams.delete("demo"),r.searchParams.delete("app");let i=o.hot===void 0?n.bundleUrl:ye(n.bundleUrl,o.hot);return r.searchParams.set("bundle",i),r.toString()}function pt(e){return e.startsWith("~/")?k.join(Ye.homedir(),e.slice(2)):k.isAbsolute(e)?e:k.resolve(process.cwd(),e)}function ft(e){let t={},o={};for(let r=0;r<e.length;r++){if(e[r]==="--replace"){let s=e[r+1];s||(console.error(" sootsim open: --replace expects <module>=<file>"),process.exit(1));let i=s.indexOf("=");(i<=0||i===s.length-1)&&(console.error(" sootsim open: --replace expects <module>=<file>"),process.exit(1));let a=s.slice(0,i).trim(),l=pt(s.slice(i+1).trim());R.existsSync(l)||(console.error(` sootsim open: replacement file not found: ${l}`),process.exit(1)),t[a]={file:l},r++;continue}if(e[r]==="--remap"){let s=e[r+1],i=s?s.indexOf("="):-1;(!s||i<=0||i===s.length-1)&&(console.error(" sootsim open: --remap expects <host:port>=<host:port>"),process.exit(1)),o[s.slice(0,i).trim()]=s.slice(i+1).trim(),r++;continue}}let n={};return Object.keys(t).length>0&&(n.modules=t),Object.keys(o).length>0&&(n.network={remap:o}),n.modules||n.network?n:void 0}function Fe(){let e=A();return C(e)&&e.runtimePort>0?`http://localhost:${e.runtimePort}/`:he}async function ht(e){try{let t=new URL(e),o=t.searchParams.get("bundle")||"";if(!o)return e;let n=process.env.SOOT_REPO_DIR||await X(o)||void 0,r=$e({bundleUrl:o,repoDir:n});if(r.length===0)return e;let s=await gt(r);return s.length===0?e:(t.searchParams.set("appFonts",Ie(s)),t.toString())}catch{return e}}async function gt(e){let t=await Promise.all(e.map(async n=>{let r=new AbortController,s=setTimeout(()=>r.abort(),1500);try{let i=await fetch(n.url,{method:"HEAD",signal:r.signal});return i.status>=200&&i.status<400?n:null}catch{return null}finally{clearTimeout(s)}})),o=[];for(let n of t)n!==null&&o.push(n);return o}async function wt(e,t,o={}){if(!e)return new URL(t).toString();if(re(e))return new URL(e).toString();let n=tt[e.toLowerCase()];if(n){let r=new URL(t),s=ie(r.pathname);return r.pathname=`${s}${n}`,r.toString()}return mt(e)?ut(e,t,o):dt(e,t)}async function bt(e){try{let t=new URL(e),o=t.searchParams.get("bundle")||"";if(!o)return e;let n=process.env.SOOT_REPO_DIR||await X(o)||void 0,r=xe({bundleUrl:o,repoDir:n});return!r||r.imageUrl&&!await yt(r.imageUrl)?e:(t.searchParams.set("appSplash",ke(r)),t.toString())}catch{return e}}async function yt(e){let t=new AbortController,o=setTimeout(()=>t.abort(),1500);try{let n=await fetch(e,{method:"HEAD",signal:t.signal});return n.status>=200&&n.status<400}catch{return!1}finally{clearTimeout(o)}}async function W(e,t=Fe(),o={}){let n=await wt(e,t,o);return bt(await ht(n))}function De(e,t){let o=e?.url||e?.origin||t;try{let n=new URL(o);return n.searchParams.delete("bundle"),n.searchParams.delete("demo"),n.searchParams.delete("app"),n.searchParams.delete("open"),n.searchParams.delete("port"),n.searchParams.delete("inspectOpen"),n.searchParams.delete("appFonts"),n.searchParams.delete("appSplash"),n.toString()}catch{return t}}async function St(e,t,o,n={}){let r=new URL(await W(e,t,n));return r.searchParams.set("inspectOpen",o),r.toString()}async function vt(e,t,o,n={}){let r=n.attempts??30,s=n.intervalMs??500,i=n.minNodeCount??10;for(let a=0;a<r;a++){let l=y(e,{commandTimeoutMs:t,simId:o,simIdSource:"flag"});try{let c=await l.send({type:"evaluate",code:"(async () => (await window.__sootsimTest?.getNodeCount()) || 0)()"});if(typeof c=="number"&&c>i)return{bridge:l,count:c}}catch{}l.close(),await v(s)}return null}function $t(e){if(!e)return null;try{let t=new URL(e);if(t.searchParams.has("bundle")){let o=t.searchParams.get("bundle")||"";try{let n=new URL(o),r=n.pathname.length>36?`...${n.pathname.slice(-36)}`:n.pathname;return`bundle ${n.host}${r}`}catch{return"bundle"}}return t.searchParams.has("port")?`connect :${t.searchParams.get("port")||""}`:t.searchParams.has("open")?`connect ${t.searchParams.get("open")||""}`:t.searchParams.has("demo")?`demo ${t.searchParams.get("demo")||"default"}`:t.pathname.includes("/sootsim/index.html")||t.pathname==="/sootsim/"||t.pathname==="/sootsim"?"embedded sootsim":null}catch{return null}}function It(e){let t=e.indexOf(":");if(t<=0)return e.length>24?`${e.slice(0,21)}\u2026`:e;let o=e.slice(0,t),n=e.slice(t+1),r=n.length>12?`${n.slice(0,8)}\u2026`:n;return o==="CLAUDE_CODE_SESSION_ID"||o==="CODEX_THREAD_ID"?`agent ${r}`:`${o} ${r}`}function xt(e,t){if(e.length===0){console.log(" no sims connected");return}console.log(` connected sims (${e.length}):
|
|
3
|
+
`);for(let o of e){let n=o.lockedBy&&o.lockExpiresAt?`locked by ${It(o.lockedBy)} (${Math.max(0,Math.round((o.lockExpiresAt-Date.now())/1e3))}s)`:"",r=[o.isPrimary?"primary":"",o.id===t?"selected":"",o.readyState,o.userVisible===!1?"hidden":o.userVisible===!0?"visible":"",o.attachedCliCount&&o.attachedCliCount>0?"in use":"",o.userFocused?"focused":"",n].filter(Boolean);console.log(` ${o.id}${r.length?` [${r.join(", ")}]`:""}`);let s=$t(o.url);if(s)console.log(` loaded: ${s}`);else if(o.url){let a=o.url.length>96?`${o.url.slice(0,93)}\u2026`:o.url;console.log(` url: ${a}`)}else o.origin&&console.log(` origin: ${o.origin}`);let i=kt(o);i&&console.log(` engine: ${i}`),o.title&&console.log(` title: ${o.title}`),o.visibilityState&&o.visibilityState!=="visible"&&console.log(` visibility: ${o.visibilityState}`),console.log(` connected: ${Le(Date.now()-o.connectedAt)}`),o.lastActiveAt&&o.lastActiveAt>0&&console.log(` last active: ${Le(Date.now()-o.lastActiveAt)}`)}}function kt(e){let t=e.url||e.origin||"";if(!t)return null;try{let o=new URL(t).port;return o==="5173"?"dev \u2014 local source (:5173)":o==="3000"?"soot app embedded (:3000)":`runtime \u2014 published engine (:${o||"?"})`}catch{return null}}function Le(e){let t=Math.max(0,Math.round(e/1e3));return t<60?`${t}s ago`:t<3600?`${Math.round(t/60)}m ago`:t<86400?`${Math.round(t/3600)}h ago`:`${Math.round(t/86400)}d ago`}async function oe(e,t,o,n={}){let r=n.attempts??30,s=n.intervalMs??500;for(let i=0;i<r;i++){let a=y(e,{commandTimeoutMs:t});try{let c=(await a.listSims()).find(o);if(c)return c}catch{}finally{a.close()}await v(s)}return null}async function Pt(e,t,o,n,r={}){let s=r.attempts??30,i=r.intervalMs??500,a=!!n&&Number.isInteger(n)&&n>1,l=()=>a&&n!==void 0&&!se(n);for(let c=0;c<s;c++){if(l())return{kind:"host-exit"};let d=y(e,{commandTimeoutMs:t});try{let h=(await d.listSims()).find(o);if(h)return l()?{kind:"host-exit"}:{kind:"match",sim:h}}catch{}finally{d.close()}if(l())return{kind:"host-exit"};await v(i)}return{kind:"timeout"}}async function Ct(e,t,o,n={}){let r=n.attempts??20,s=n.intervalMs??250;for(let i=0;i<r;i++){let a=y(e,{commandTimeoutMs:t});try{let c=(await a.listSims()).find(d=>d.id===o);if(!c||c.readyState!=="open")return!0}catch{return!0}finally{a.close()}await v(s)}return!1}function Mt(e){let t=e.meta;if(!t||t.sootsimHostDriver!=="playwright")return null;let o=Number(t.sootsimHostPid);return!Number.isInteger(o)||o<=1||o===process.pid?null:o}function Tt(e){if(!e.connectAckFile)return!1;try{return R.writeFileSync(e.connectAckFile,`${JSON.stringify({connectedAt:Date.now(),pid:e.pid??null})}
|
|
4
|
+
`,{flag:"w"}),!0}catch{return!1}}function Ae(e){if(e.diagnosticLogPath)try{let t=R.readFileSync(e.diagnosticLogPath,"utf8").trim();if(!t){console.error(` ${k.basename(e.diagnosticLogPath)} was empty`);return}let o=t.length>4e3?`\u2026
|
|
5
|
+
${t.slice(-4e3)}`:t;console.error(` ${k.basename(e.diagnosticLogPath)}:`),console.error(o)}catch(t){let o=t instanceof Error?t.message:String(t);console.error(` failed to read ${k.basename(e.diagnosticLogPath)}: ${o}`)}}function se(e){try{return process.kill(e,0),!0}catch(t){return t?.code==="EPERM"}}async function Ut(e,t=2500){let o=Date.now()+t;for(;Date.now()<o;){if(!se(e))return!0;await v(100)}return!se(e)}async function ne(e,t){let o=new Set(t),n=new Set;for(let r of e){if(!o.has(r.id))continue;let s=Mt(r);s&&n.add(s)}for(let r of n){try{process.kill(r,"SIGTERM")}catch{}if(await Ut(r)){console.log(` closed playwright host process ${r}`);continue}try{process.kill(r,"SIGKILL"),console.log(` force-closed playwright host process ${r}`)}catch{}}}function z(e,t){if(t){let r=t.trim(),s=e.find(i=>i.id===r);if(!s)throw new Error(`no sim connected with id ${r}`);return s}let o=e.find(r=>r.isPrimary&&r.readyState==="open");if(o)return o;let n=e.find(r=>r.readyState==="open");if(n)return n;throw new Error("no sim connected")}function E(e,t,o){console.log(` ${o==="current sim"?"loaded":"opened"}: ${e} [${o}]`),console.log(` current sim: ${t.id}`),console.log(JSON.stringify({simId:t.id,url:t.url},null,2))}async function O(e,t,o){if(o.includes("--no-describe"))return;let n=process.env.SOOTSIM_QUIET_TARGET_NOTICE;process.env.SOOTSIM_QUIET_TARGET_NOTICE="1";try{await Et(e,t,{stableMs:150,maxMs:400});let r=y(e,{commandTimeoutMs:3e3,simId:t,cliLabel:"open --describe",simIdSource:"flag"});try{let s=null;try{s=await r.send({type:"evaluate",code:ge})}catch{}if(s&&!(s.flag===!0&&!s.loadingText&&we(s))){let d=s.loadingText?`still showing "${s.loadingText}"`:s.flag!==!0?"guest ready event has not fired":s.targets<=0?"no visible app content is inspectable yet":"app tree is still stabilizing";console.log(` app still loading: ${d} (nodes: ${s.nodes}, targets: ${s.targets})`),console.log(" before interacting, run: sootsim wait ready --max-ms 120000")}let a=`(async () => {
|
|
6
|
+
const t = window.__sootsimTest
|
|
7
|
+
const ms = window.SootSim?.bridges?.mainShell
|
|
8
|
+
if (!t) return null
|
|
9
|
+
let shell = null
|
|
10
|
+
try { shell = ms?.getState ? await ms.getState() : null } catch {}
|
|
11
|
+
const tree = await t.dumpTree(12, ${JSON.stringify({describe:!0,verbose:!1,filter:""})})
|
|
12
|
+
return { tree, shell }
|
|
13
|
+
})()`,l=await r.send({type:"evaluate",code:a});if(!l?.tree)return;if(console.log(""),l.shell?.state){let c=[`state=${l.shell.state}`,l.shell.activeApp?`app=${l.shell.activeApp}`:null].filter(Boolean);console.log(` shell: ${c.join(" ")}`)}console.log(l.tree)}finally{r.close()}}catch{}finally{n===void 0?delete process.env.SOOTSIM_QUIET_TARGET_NOTICE:process.env.SOOTSIM_QUIET_TARGET_NOTICE=n}}async function Et(e,t,o){let n=Date.now()+o.maxMs,r="(async () => (await window.__sootsimTest?.getNodeCount?.()) || 0)()",s=y(e,{commandTimeoutMs:2e3,simId:t,simIdSource:"flag"});try{let i=-1,a=0;for(;Date.now()<n;){let l=-1;try{let c=await s.send({type:"evaluate",code:r});typeof c=="number"&&(l=c)}catch{}if(l>=0&&l===i){if(Date.now()-a>=o.stableMs)return}else i=l,a=Date.now();await v(50)}}finally{s.close()}}async function fo(e,t={}){let o=I(e,{port:t.port,commandTimeoutMs:t.timeoutMs}),n=x(o);try{let r=await n.listSims();xt(r,o.simId)}finally{n.close()}}async function ho(e,t={}){let o=I(e,{port:t.port,commandTimeoutMs:t.timeoutMs,stripBooleanFlags:["--new","--headless","--headed","--ephemeral","--hot","--no-hmr"],stripValueFlags:["--base-url","--replace","--driver","--profile","--cdp-port"]}),n=e.find((u,p)=>e[p-1]==="--profile"),r=e.includes("--ephemeral"),s=e.find((u,p)=>e[p-1]==="--cdp-port"),i=s?Number(s):void 0;s&&(!Number.isFinite(i)||i<=0)&&(console.error(` sootsim open: --cdp-port must be a positive port number, got "${s}"`),process.exit(1)),n&&r&&(console.error(" sootsim open: --profile cannot be combined with --ephemeral"),process.exit(1));let a=n?ve(n).id:void 0,l=!!a||r,c=e.includes("--new")||l,d=ft(e);c&&o.simIdSource==="flag"&&(console.error(" sootsim open: --new, --profile, and --ephemeral cannot be combined with --sim"),process.exit(1));let m=o.positional[0]||"";if(lt(m)){let u=(()=>{try{return/^(localhost|127\.0\.0\.1|\[::1\]|::1)$/i.test(new URL(m).hostname)}catch{return!1}})();console.log(" that\u2019s a SootSim preview/build link \u2014 a full player page, not a driveable sim."),console.log(" opening it in your browser for viewing\u2026");try{await ee(m,{background:!1})}catch(p){console.error(` could not launch a browser: ${p instanceof Error?p.message:String(p)}`),console.error(` open it yourself: ${m}`),process.exit(1)}console.log(u?" to drive it under the CLI, point `sootsim open` at the app\u2019s dev port instead (e.g. `sootsim open 8081`).":" the CLI can\u2019t drive a remote preview (the engine only attaches to the local bridge from localhost). to drive the app, run it locally and `sootsim open <port>`.");return}o.wsPort=await st(o.wsPort);let h=e.find((u,p)=>e[p-1]==="--driver")||"",q=rt(e,h);i&&h!=="playwright"&&(console.error(" sootsim open: --cdp-port is only honored by the playwright driver \u2014 add `--driver playwright`"),process.exit(1));let ae=e.includes("--hot"),le=e.includes("--no-hmr");ae&&le&&(console.error(" sootsim open: --hot and --no-hmr cannot be combined"),process.exit(1));let _={hot:ae?!0:le?!1:h!=="playwright"},P=e.find((u,p)=>e[p-1]==="--base-url")||Fe(),ce=e.includes("--base-url"),de=M();if(!h&&!c&&(o.simIdSource==="flag"||o.simIdSource==="saved"&&!!de)){let u=x(o),p=o.simId?` --sim ${o.simId}`:"",f=!1;try{let g=null;try{let w=await u.listSims();if(o.simIdSource==="saved"?(g=w.find($=>$.id===de&&$.readyState==="open")??null,g||T()):g=z(w,o.simId),!g)if(o.simIdSource==="saved")f=!0;else throw new Error("no sim connected");if(!f&&g){let $=ce||re(m)?P:De(g,P),L=await W(m,F($,d),_);u.send({type:"evaluate",simId:g.id,code:`window.location.href = ${JSON.stringify(L)}`}).catch(()=>{})}}catch(w){console.error(` open failed: ${w instanceof Error?w.message:String(w)}`),await N(u,{errorsCommand:`sootsim get errors 5${p}`,warningsCommand:`sootsim get warnings 5${p}`,requestsCommand:`sootsim get requests 5${p}`}),process.exit(1)}if(!f&&g){await v(1500);let w=await vt(o.wsPort,o.commandTimeoutMs,g.id);w||(console.error(" timed out waiting for current sim to load target"),process.exit(1)),w.bridge.close(),b(g.id);let $=ce||re(m)?P:De(g,P),L=await W(m,F($,d),_);E(L,{...g,url:L},"current sim"),await O(o.wsPort,g.id,e);return}}finally{u.close()}}let me=F(P,d),Ke=await W(m,me,_),ue=`cli-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`,S=await St(m,me,ue,_),V={newWindow:!0},B=u=>u.url?.includes(`inspectOpen=${ue}`)??!1;if(h){nt(h)||(console.error(` unknown driver "${h}" \u2014 run \`sootsim list --drivers\``),process.exit(1));let u=te(h);u||(console.error(` unknown driver "${h}" \u2014 run \`sootsim list --drivers\``),process.exit(1));let p=ot(),f=await u.launch({url:S,headless:q,newWindow:V.newWindow,profileId:a,ephemeralProfile:r,cdpPort:i,connectTimeoutMs:p.hostTimeoutMs});f.launched||(console.error(` ${u.name} driver: ${f.message}`),process.exit(1));let g=await Pt(o.wsPort,o.commandTimeoutMs,B,f.pid,{attempts:p.attempts,intervalMs:p.intervalMs});if(g.kind==="host-exit"&&(Ae(f),console.error(` ${u.name} host crashed \u2014 sim is no longer attached`),process.exit(1)),g.kind==="timeout"){if(f.pid)try{process.kill(f.pid,"SIGTERM"),console.error(` closed ${u.name} host process ${f.pid}`)}catch{}Ae(f),console.error(` timed out after ${p.timeoutMs}ms waiting for opened sim to connect`),process.exit(1)}let w=g.sim;b(w.id),Tt(f),E(S,w,`${u.name} driver`),await O(o.wsPort,w.id,e);return}if(l){let u=U();u||(console.error(" profiles require electron or playwright; install the desktop companion or use `--driver playwright`"),process.exit(1));try{(await Z(S,u,{profileId:a,ephemeralProfile:r})).launched||(console.error(" desktop companion failed to start"),process.exit(1))}catch(f){console.error(` desktop companion failed: ${f instanceof Error?f.message:String(f)}`),process.exit(1)}let p=await oe(o.wsPort,o.commandTimeoutMs,B,{attempts:40,intervalMs:500});p||(console.error(" timed out waiting for profiled sim to connect"),process.exit(1)),b(p.id),E(S,p,"desktop companion"),await O(o.wsPort,p.id,e);return}let G=!1,J=!1;try{let u=y(o.wsPort,{commandTimeoutMs:2e3});try{await u.listSims(),G=!0}finally{u.close()}}catch{}if(G)try{let u=y(o.wsPort,{commandTimeoutMs:3e3});try{await u.openUrl(S,V),J=!0}finally{u.close()}}catch{}if(!J){let u=U();if(u)try{if((await Z(S,u)).launched){let f=await oe(o.wsPort,o.commandTimeoutMs,B,{attempts:20,intervalMs:500});if(f){b(f.id),E(S,f,"desktop companion"),await O(o.wsPort,f.id,e);return}}}catch{}try{await ee(S,V)}catch(p){console.error(` open failed: ${p instanceof Error?p.message:String(p)}`),te("playwright")?.availability().available?console.error(" no system browser found \u2014 retry with `sootsim open \u2026 --driver playwright` for a headless sim."):console.error(" run `sootsim list --drivers` to see available drivers."),process.exit(1)}if(!G){console.log(` opened: ${Ke}`),Ee(o.wsPort);return}}let D=await oe(o.wsPort,o.commandTimeoutMs,B,{attempts:30,intervalMs:500});D||(console.error(" timed out waiting for opened sim to connect"),process.exit(1)),b(D.id),E(S,D,J?"bridge":"direct shell open"),await O(o.wsPort,D.id,e)}async function He(e,t={}){let o=I(e,{port:t.port,commandTimeoutMs:t.timeoutMs,stripBooleanFlags:["--force"]}),n=e.includes("--force"),r=x(o),s=o.simId?` --sim ${o.simId}`:"";try{try{let i=await r.listSims(),a=z(i,o.positional[0]||o.simId);if(a.lockedBy&&a.lockExpiresAt&&a.lockExpiresAt>Date.now()){let l=Math.max(0,Math.round((a.lockExpiresAt-Date.now())/1e3));a.lockedByKind==="user-active"&&(console.error(` refused: ${a.id} is locked by the active user (${l}s) \u2014 that's a live human tab`),console.error(" run `sootsim open --new` for a fresh investigation sim"),process.exit(1)),n||(console.error(` refused: ${a.id} is leased by ${a.lockedBy} (${l}s)`),console.error(` \`sootsim use ${a.id} --force\` to take it, or \`sootsim open --new\` for a fresh sim`),process.exit(1))}await r.focusSim(a.id),b(a.id),console.log(` using: ${a.id}`)}catch(i){console.error(` use failed: ${i instanceof Error?i.message:String(i)}`),await N(r,{errorsCommand:`sootsim get errors 5${s}`,warningsCommand:`sootsim get warnings 5${s}`,requestsCommand:`sootsim get requests 5${s}`}),process.exit(1)}}finally{r.close()}}async function go(e,t={}){await He(e,t)}async function wo(e,t={}){await He(e,t)}async function bo(e,t={}){let o=I(e,{port:t.port,commandTimeoutMs:t.timeoutMs,stripBooleanFlags:["--force"]}),n=e.includes("--force"),r=x(o);try{try{let s=await r.listSims(),i=z(s,o.positional[0]||o.simId),a=n&&i.lockedBy&&i.lockedByKind!=="user-active"?i.lockedBy:null,l=await r.claim(i.id,{force:n});b(i.id);let c=Math.max(0,Math.round((l.lockExpiresAt-Date.now())/1e3)),d=l.bootedCount>0?` (booted ${l.bootedCount})`:"";console.log(` claimed: ${l.simId} [${c}s]${d}`),a&&console.log(` took over from: ${a}`)}catch(s){if(s instanceof be){let i=Math.max(0,Math.round(s.lock.expiresInMs/1e3));console.error(` claim failed: locked by ${s.lock.by} for ${i}s more`),console.error(" use --force to take it, or `sootsim open --new` for a fresh sim"),process.exit(1)}console.error(` claim failed: ${s instanceof Error?s.message:String(s)}`),process.exit(1)}}finally{r.close()}}async function Ot(e,t,o,n){if(n.length===0)return{closed:[],remaining:[]};await Promise.all(n.map(s=>e.closeSim(s).catch(()=>{})));let r=new Set(n);for(let s=0;s<40;s++){let i=[];try{let a=y(t,{commandTimeoutMs:o});try{i=(await a.listSims()).filter(c=>r.has(c.id)&&c.readyState==="open").map(c=>c.id)}finally{a.close()}}catch{i=[]}if(i.length===0)return{closed:[...r],remaining:[]};if(s===39)return{closed:[...r].filter(a=>!i.includes(a)),remaining:i};await v(250)}return{closed:[...r],remaining:[]}}function Rt(e,t){let o=e.filter(m=>m.readyState==="open"),n=o.map(m=>m.id),r=t.explicitKeepId?.trim()||"",s=t.savedKeepId?.trim()||"",i=s?o.some(m=>m.id===s):!1,a=s&&!i?s:null,l=null,c=null,d=null;if(t.closeOthers)if(r){let m=o.find(h=>h.id===r);m?l=m.id:c=r}else if(s&&i)l=s;else{let m=o.find(h=>h.isPrimary)??o[0]??null;m&&(l=m.id,s&&!i&&(d=m.id))}return{openIds:n,keepId:l,targets:c?[]:n.filter(m=>m!==l),staleSavedId:a,missingExplicitKeepId:c,fallbackKeepId:d}}async function yo(e,t={}){let o=I(e,{port:t.port,commandTimeoutMs:t.timeoutMs,stripBooleanFlags:["--all","--others"]}),n=x(o),r=o.simId?` --sim ${o.simId}`:"",s=e.includes("--all"),i=e.includes("--others");if(s||i){try{let a=await n.listSims(),l=M(),c=o.positional[0]||(o.simIdSource==="flag"?o.simId:void 0),d=Rt(a,{closeOthers:i,explicitKeepId:c,savedKeepId:l});if(d.staleSavedId&&T(),d.fallbackKeepId&&(b(d.fallbackKeepId),console.log(` saved sim ${d.staleSavedId} is gone \u2014 keeping primary ${d.fallbackKeepId}`)),d.missingExplicitKeepId&&(console.error(` close failed: keep sim ${d.missingExplicitKeepId} is not connected; not closing other sims`),process.exit(1)),d.targets.length===0){console.log(d.keepId?` nothing to close \u2014 only the kept sim ${d.keepId} is connected`:d.staleSavedId?` nothing to close \u2014 no sims connected (cleared stale current sim ${d.staleSavedId})`:" nothing to close \u2014 no sims connected");return}let m=await Ot(n,o.wsPort,o.commandTimeoutMs,d.targets);await ne(a,d.targets);let h=M();h&&m.closed.includes(h)&&(d.keepId?b(d.keepId):T());let q=` closed ${m.closed.length} sim(s)${d.keepId?` (kept ${d.keepId})`:""}`;console.log(q),m.remaining.length>0&&(console.error(` close failed: still connected: ${m.remaining.join(", ")}`),process.exit(1))}catch(a){console.error(` close failed: ${a instanceof Error?a.message:String(a)}`),process.exit(1)}finally{n.close()}return}try{try{let a=await n.listSims(),l=z(a,o.positional[0]||o.simId),c=a.find(m=>m.id!==l.id&&m.readyState==="open");await n.closeSim(l.id),await Ct(o.wsPort,o.commandTimeoutMs,l.id)||(await ne(a,[l.id]),console.error(` close failed: ${l.id} is still connected`),process.exit(1)),await ne(a,[l.id]),M()===l.id&&(c?b(c.id):T()),console.log(` closed: ${l.id}`)}catch(a){console.error(` close failed: ${a instanceof Error?a.message:String(a)}`),await N(n,{errorsCommand:`sootsim get errors 5${r}`,warningsCommand:`sootsim get warnings 5${r}`,requestsCommand:`sootsim get requests 5${r}`}),process.exit(1)}}finally{n.close()}}export{Ht as a,Qe as b,Kt as c,ot as d,po as e,Fe as f,W as g,St as h,$t as i,xt as j,oe as k,Pt as l,Mt as m,Tt as n,ne as o,fo as p,ho as q,go as r,wo as s,bo as t,Ot as u,Rt as v,yo as w};
|