sootsim 0.0.1 → 0.0.3

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.
Files changed (122) hide show
  1. package/README.md +12 -0
  2. package/dist-cli/bin.js +16 -10
  3. package/dist-cli/chunks/agent-D5NBV32O.js +61 -0
  4. package/dist-cli/chunks/agent-wrapper-Y7I5QGHM.js +15 -0
  5. package/dist-cli/chunks/assert-EJ7DQS2H.js +47 -0
  6. package/dist-cli/chunks/auto-bootstrap-Q7GNLISM.js +2 -0
  7. package/dist-cli/chunks/{chunk-7X6OPSRD.js → chunk-2FPPPJE5.js} +2 -2
  8. package/dist-cli/chunks/{chunk-G5MR66EB.js → chunk-3K6VDPVD.js} +2 -2
  9. package/dist-cli/chunks/{chunk-PWXPA745.js → chunk-3SLEIN6B.js} +1 -1
  10. package/dist-cli/chunks/chunk-3WPAEUOO.js +1 -0
  11. package/dist-cli/chunks/chunk-44CBTM22.js +2 -0
  12. package/dist-cli/chunks/chunk-46LRF7PH.js +5 -0
  13. package/dist-cli/chunks/chunk-4RYT6AQV.js +16 -0
  14. package/dist-cli/chunks/chunk-5AG24UFX.js +119 -0
  15. package/dist-cli/chunks/chunk-5IPP4HAW.js +5 -0
  16. package/dist-cli/chunks/{chunk-J2S3OCWA.js → chunk-AFTHIY3L.js} +1 -1
  17. package/dist-cli/chunks/chunk-BU3TZP4Y.js +11 -0
  18. package/dist-cli/chunks/chunk-BYLX2DO4.js +27 -0
  19. package/dist-cli/chunks/chunk-CPMW2QLM.js +1 -0
  20. package/dist-cli/chunks/{chunk-YCETS3B3.js → chunk-CQ6PX2EU.js} +2 -2
  21. package/dist-cli/chunks/chunk-D4JFMCXD.js +2 -0
  22. package/dist-cli/chunks/chunk-EEBR5YP5.js +62 -0
  23. package/dist-cli/chunks/chunk-EQ7G3UHS.js +4 -0
  24. package/dist-cli/chunks/{chunk-64TOMNZX.js → chunk-FTRI7SVV.js} +2 -2
  25. package/dist-cli/chunks/{chunk-GPVPHE2B.js → chunk-H3JVJXOC.js} +2 -2
  26. package/dist-cli/chunks/chunk-LV5U7TI4.js +1 -0
  27. package/dist-cli/chunks/chunk-NKJLTISU.js +4 -0
  28. package/dist-cli/chunks/chunk-O2HBPZW5.js +22 -0
  29. package/dist-cli/chunks/{chunk-KSACMDXK.js → chunk-OG5CKIPC.js} +2 -2
  30. package/dist-cli/chunks/{chunk-E522F5JW.js → chunk-P5C3UASK.js} +1 -1
  31. package/dist-cli/chunks/chunk-REYWQVAH.js +2 -0
  32. package/dist-cli/chunks/chunk-RLS6PHBW.js +4 -0
  33. package/dist-cli/chunks/chunk-SUZR2SZZ.js +34 -0
  34. package/dist-cli/chunks/{chunk-OROM7DZI.js → chunk-USRNDVQ3.js} +1 -1
  35. package/dist-cli/chunks/{chunk-JSF5LPNT.js → chunk-UZL5ZZ4E.js} +5 -5
  36. package/dist-cli/chunks/{chunk-QOBRRY5X.js → chunk-VI3VW5BL.js} +1 -1
  37. package/dist-cli/chunks/chunk-WUYJFYOW.js +2 -0
  38. package/dist-cli/chunks/chunk-X2W4IRXK.js +3 -0
  39. package/dist-cli/chunks/chunk-XJBPH4JR.js +308 -0
  40. package/dist-cli/chunks/chunk-ZSRMXBGK.js +2 -0
  41. package/dist-cli/chunks/{compat-MRN2ORY5.js → compat-5KSMOWLB.js} +4 -4
  42. package/dist-cli/chunks/{config-CO5IYWUY.js → config-NJB6PQHU.js} +5 -5
  43. package/dist-cli/chunks/control-2F3AGZAO.js +2 -0
  44. package/dist-cli/chunks/{daemon-G4XVRFHM.js → daemon-MLG65V4S.js} +2 -2
  45. package/dist-cli/chunks/{debug-ZNSZTWT6.js → debug-QVOBTTLP.js} +4 -4
  46. package/dist-cli/chunks/demo-app-registry-XRYNJ4GC.js +2 -0
  47. package/dist-cli/chunks/{detox-JEGYNTYV.js → detox-ZZSNZL4T.js} +2 -2
  48. package/dist-cli/chunks/{device-BS34FAFM.js → device-PQB3YGHN.js} +2 -2
  49. package/dist-cli/chunks/drivers-GWDQEGWD.js +2 -0
  50. package/dist-cli/chunks/electron-JB26VHOO.js +15 -0
  51. package/dist-cli/chunks/flow-7JRQXMFV.js +2 -0
  52. package/dist-cli/chunks/{hints-7Z656W4H.js → hints-IGYDXXDS.js} +2 -2
  53. package/dist-cli/chunks/home-paths-CEGSGQTD.js +2 -0
  54. package/dist-cli/chunks/{inspect-NAHXP2M5.js → inspect-DSU6ELRM.js} +153 -165
  55. package/dist-cli/chunks/install-K6IJKADG.js +65 -0
  56. package/dist-cli/chunks/{install-desktop-PYIZIH67.js → install-desktop-SC3LNFFF.js} +8 -4
  57. package/dist-cli/chunks/install-dev-desktop-4DP3UY2X.js +100 -0
  58. package/dist-cli/chunks/keys-R5LAPAAL.js +19 -0
  59. package/dist-cli/chunks/launch-K3WJV4QA.js +16 -0
  60. package/dist-cli/chunks/{login-Z5Z54HUJ.js → login-A23PYJAW.js} +5 -5
  61. package/dist-cli/chunks/{logout-T2QDYGCB.js → logout-AJ24PH5O.js} +2 -2
  62. package/dist-cli/chunks/{maestro-4AXTS7OE.js → maestro-YALWKKGU.js} +2 -2
  63. package/dist-cli/chunks/{preview-NMGWHWMX.js → preview-D35EEONY.js} +2 -2
  64. package/dist-cli/chunks/{profile-6RGJA4FR.js → profile-MAF7NM5Q.js} +3 -3
  65. package/dist-cli/chunks/record-ZCPQNGFW.js +37 -0
  66. package/dist-cli/chunks/runtime-Z2WIXYUN.js +25 -0
  67. package/dist-cli/chunks/{screenshot-R3GCCSCI.js → screenshot-NQVZYC3C.js} +3 -3
  68. package/dist-cli/chunks/screenshot-mode-E45D2ZFH.js +17 -0
  69. package/dist-cli/chunks/{screenshots-4UQJE4NC.js → screenshots-I4SQI4DA.js} +2 -2
  70. package/dist-cli/chunks/server-ZUXKJRR5.js +29 -0
  71. package/dist-cli/chunks/{skills-2PPKPL4B.js → skills-N4U63E5W.js} +2 -2
  72. package/dist-cli/chunks/store-4A6X4GBJ.js +2 -0
  73. package/dist-cli/chunks/{test-5LFKOQ4M.js → test-VBD6N3AR.js} +3 -3
  74. package/dist-cli/chunks/upload-Y6FZ5XF2.js +2 -0
  75. package/dist-cli/chunks/{whoami-H6FW34JS.js → whoami-4K6JGMWH.js} +2 -2
  76. package/dist-lib/agent-daemon-client.cjs +414 -0
  77. package/dist-lib/agent-events.cjs +48 -0
  78. package/dist-lib/agent-sessions.cjs +692 -0
  79. package/dist-lib/attached-projects.cjs +448 -0
  80. package/dist-lib/auth/shared-session.cjs +174 -0
  81. package/dist-lib/backend-origin.cjs +70 -0
  82. package/dist-lib/bridge-constants.cjs +32 -0
  83. package/dist-lib/cli-constants.cjs +32 -0
  84. package/dist-lib/config.cjs +88 -0
  85. package/dist-lib/dev-bundle-resolution.cjs +236 -0
  86. package/dist-lib/home-paths.cjs +234 -0
  87. package/dist-lib/host/bridge-host.cjs +3458 -0
  88. package/dist-lib/index.cjs +361 -0
  89. package/dist-lib/metro.cjs +215 -0
  90. package/dist-lib/render-mode.cjs +54 -0
  91. package/dist-lib/vite-base.cjs +4217 -0
  92. package/dist-lib/vite.cjs +178 -0
  93. package/package.json +80 -13
  94. package/scripts/postinstall.cjs +70 -0
  95. package/dist-cli/chunks/bridge-host-2EY7Z4AO.js +0 -2
  96. package/dist-cli/chunks/chunk-3C3ZH7PP.js +0 -4
  97. package/dist-cli/chunks/chunk-3R4ZZESY.js +0 -119
  98. package/dist-cli/chunks/chunk-74XPLOV4.js +0 -2
  99. package/dist-cli/chunks/chunk-7LMDCMSI.js +0 -8
  100. package/dist-cli/chunks/chunk-A2CZQIWO.js +0 -1
  101. package/dist-cli/chunks/chunk-CKZ376AY.js +0 -322
  102. package/dist-cli/chunks/chunk-E5UBZEYR.js +0 -2
  103. package/dist-cli/chunks/chunk-HOIHCO7S.js +0 -3
  104. package/dist-cli/chunks/chunk-KQWZZ56P.js +0 -2
  105. package/dist-cli/chunks/chunk-KSB6MSZ4.js +0 -34
  106. package/dist-cli/chunks/chunk-KXYKAYYB.js +0 -51
  107. package/dist-cli/chunks/chunk-MBFP2LVH.js +0 -3
  108. package/dist-cli/chunks/chunk-MPSZ5EWF.js +0 -16
  109. package/dist-cli/chunks/chunk-X2U72K7X.js +0 -1
  110. package/dist-cli/chunks/control-Y7TKKB6D.js +0 -2
  111. package/dist-cli/chunks/dev-ZUKCZQEX.js +0 -25
  112. package/dist-cli/chunks/dev-checkout-IEZVVTCN.js +0 -2
  113. package/dist-cli/chunks/drivers-46PFFIDF.js +0 -2
  114. package/dist-cli/chunks/electron-P2KOPX2S.js +0 -15
  115. package/dist-cli/chunks/flow-VVOF6UNC.js +0 -2
  116. package/dist-cli/chunks/install-EPUJX4AT.js +0 -67
  117. package/dist-cli/chunks/record-IE27Z2GA.js +0 -37
  118. package/dist-cli/chunks/screenshot-mode-SZQDNGYE.js +0 -17
  119. package/dist-cli/chunks/server-AN2G5KO4.js +0 -21
  120. package/dist-cli/chunks/store-PU5ES4YQ.js +0 -2
  121. package/dist-cli/chunks/upload-BYNPC54C.js +0 -2
  122. package/dist-cli/chunks/vite-plugin-5AEUUBKP.js +0 -9
@@ -0,0 +1,308 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{a as he}from"./chunk-5IPP4HAW.js";import{a as be}from"./chunk-BYLX2DO4.js";import{a as ge}from"./chunk-3K6VDPVD.js";import{a as ye,b as q,c as ve}from"./chunk-EEBR5YP5.js";import{f as ne}from"./chunk-CQ6PX2EU.js";import{a as B,b as A,c as de,d as H,f as ue,g as fe}from"./chunk-UZL5ZZ4E.js";import{d as we,j as me}from"./chunk-BU3TZP4Y.js";import{b as ce}from"./chunk-SUZR2SZZ.js";import{c as z,d as ae,e as le}from"./chunk-4RYT6AQV.js";import{d as ie}from"./chunk-RLS6PHBW.js";import{a as pe}from"./chunk-46LRF7PH.js";import*as $ from"fs";import{tmpdir as Te}from"os";import*as g from"path";import*as m from"fs";import*as w from"path";var V=1e4,U=393,E=852,Se="__sootsimCliPerf",Ce="maestroCopiedText",X=new Map;function f(s){return new Promise(e=>setTimeout(e,s))}function Oe(s){return s?w.basename(s)===".maestro"?w.dirname(s):s:process.cwd()}function De(s,e,t){let r=e.endsWith(".png")?e:`${e}.png`;if(w.isAbsolute(r))return r;if(t.mode==="flow"&&/[\\/]/.test(r)){let o=r.startsWith("./")||r.startsWith("../")?t.flowDir??process.cwd():Oe(t.flowDir);return w.resolve(o,r)}return w.join(s,r)}function Ne(s){if(typeof s=="string")return{path:s,withFrame:!1};let e=s.path?.trim()||s.name?.trim();if(!e)throw new Error("takeScreenshot object form requires path or name");return{path:e,withFrame:s.withFrame===!0}}function Y(s){let[e,t]=s.split(",").map(o=>o.trim()),r=(o,i)=>o.endsWith("%")?Number.parseFloat(o)/100*i:Number.parseFloat(o);return{x:r(e,U),y:r(t,E)}}function G(s){return typeof s=="string"?s.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g,(e,t)=>{if(X.has(t))return X.get(t);let r=process.env[t];if(r===void 0)throw new Error(`missing environment variable for flow placeholder: ${t}`);return r}):Array.isArray(s)?s.map(e=>G(e)):s&&typeof s=="object"?Object.fromEntries(Object.entries(s).map(([e,t])=>[e,G(t)])):s}function Re(s){let e=s.split(/^---$/m),t=e.length>1?e[e.length-1]:s,r=G(A.parse(t));return Array.isArray(r)?r:[]}var W=class{constructor(e,t){this.bridge=e;this.opts=t}stepDelay=0;firstLaunchDone=!1;profilingEnabled=!1;recordingEnabled=!1;recordingAccessChecked=!1;recordingStartedAtMs=null;lastRecordingDurationMs=null;browserRouteHint=null;lastFailedStep=null;get browserId(){return this.opts.browserId}setBrowserRouteHint(e){this.browserRouteHint=this.normalizeBrowserRoute(e)}normalizeBrowserRoute(e){if(!e)return null;try{let t=new URL(e);t.searchParams.delete("inspectOpen");let r=t.searchParams.toString();return`${t.origin}${t.pathname}${r?`?${r}`:""}`}catch{return e}}async refreshBrowserId(){if(this.opts.browserId)try{let e=await this.bridge.listBrowsers(),t=e.find(a=>a.id===this.opts.browserId);if(t&&(this.browserRouteHint=this.normalizeBrowserRoute(t.url||t.origin)),e.find(a=>a.id===this.opts.browserId&&a.readyState==="open")||!this.browserRouteHint)return;let o=this.browserRouteHint&&e.find(a=>a.readyState==="open"&&this.normalizeBrowserRoute(a.url||a.origin)===this.browserRouteHint);if(!o)return;let i=e.find(a=>a.isPrimary&&a.readyState==="open"),n=e.find(a=>a.readyState==="open"),l=o??i??n;l&&(this.opts.browserId=l.id,console.log(` [flow] session rotated to ${l.id}`))}catch{}}async evaluate(e){return this.bridge.send({type:"evaluate",browserId:this.opts.browserId,code:e})}async callTest(e,...t){return this.bridge.send({type:"call",browserId:this.opts.browserId,path:`__sootsimTest.${e}`,args:t})}async waitForTree(e=V){let t=Date.now()+e,r=null;for(;Date.now()<t;){try{let o=await this.evaluate(`(async () => {
3
+ const test = window.__sootsimTest
4
+ if (!test) return { count: 0, loading: true }
5
+ const count = (await test.getNodeCount?.()) || 0
6
+ const external = globalThis.__sootsimExternalAppState
7
+ if (external?.error) {
8
+ return { count, loading: false, error: String(external.error) }
9
+ }
10
+ if (external) {
11
+ return {
12
+ count,
13
+ loading: !external.ready,
14
+ error: null,
15
+ }
16
+ }
17
+ const loadingNode = await test.findByText?.('loading')
18
+ const capturingNode = await test.findByText?.('capturing')
19
+ const openingAppNode = await test.findByText?.('opening app')
20
+ const isLoading = !!loadingNode || !!capturingNode || !!openingAppNode || count < 5
21
+ return { count, loading: isLoading, error: null }
22
+ })()`);if(o?.error)throw new Error(`app failed to load: ${o.error}`);if(o&&o.count>10&&!o.loading)return}catch(o){r=o instanceof Error?o:new Error(String(o)),await this.refreshBrowserId()}await f(500)}throw r?.message.startsWith("app failed to load:")?r:new Error(`app not ready after ${e}ms`)}async ensureRecordingStarted(){if(!this.opts.recordingOutputDir)throw new Error("recording output directory not configured");this.recordingAccessChecked||(await be("flow --video",{originOverride:this.opts.billingOriginOverride}),this.recordingAccessChecked=!0);let e=Date.now(),t=await this.evaluate(`(() => {
23
+ const rec = window.__sootsimRecorder
24
+ if (!rec) return { ok: false, error: 'recorder unavailable on this page' }
25
+ if (rec.state() === 'recording') return { ok: true, format: 'webm' }
26
+ return rec.start({ format: 'webm', fps: 24 })
27
+ })()`);if(!t?.ok)throw new Error(t?.error||"recording unavailable on this page");this.recordingStartedAtMs||(this.recordingStartedAtMs=e)}async startRecording(){this.recordingEnabled=!0,await this.ensureRecordingStarted()}prepareRecording(){this.recordingEnabled=!0}getLastRecordingDurationMs(){return this.lastRecordingDurationMs}async stopRecording(){if(!this.recordingEnabled||!this.opts.recordingOutputDir)return null;this.recordingEnabled=!1;let e=Date.now(),t=await this.evaluate("window.__sootsimRecorder.stop()");if(!t?.ok)throw this.recordingStartedAtMs=null,new Error(t?.error||"recording stop failed");this.lastRecordingDurationMs=this.recordingStartedAtMs?Math.max(1,e-this.recordingStartedAtMs):null,this.recordingStartedAtMs=null;let r=[],o=0;for(;;){let n=await this.evaluate(`window.__sootsimRecorder.getBlobBase64({ offset: ${o}, chunk: 2097152 })`);if(!n||(r.push(Buffer.from(n.data,"base64")),o=n.offset,n.done))break}if(r.length===0)throw new Error("recording requested but no video buffer was produced");m.mkdirSync(this.opts.recordingOutputDir,{recursive:!0});let i=w.join(this.opts.recordingOutputDir,`sootsim-${Date.now()}.webm`);return m.writeFileSync(i,Buffer.concat(r)),i}async findElement(e){return this.evaluate(`(async () => {
28
+ const test = window.__sootsimTest
29
+ if (!test) return null
30
+ let node = null
31
+ if (${JSON.stringify(!!e.text)}) node = await test.findByText(${JSON.stringify(e.text||"")})
32
+ if (!node && ${JSON.stringify(!!e.id)}) {
33
+ node = (await test.findByTestId(${JSON.stringify(e.id||"")})) || (await test.findById(${JSON.stringify(e.id||"")}))
34
+ }
35
+ if (!node || !node.absolutePosition || !node.layout) return null
36
+ return {
37
+ nodeId: typeof node.nodeId === 'number' ? node.nodeId : null,
38
+ id: node.id || null,
39
+ testID: node.testID || null,
40
+ text: node.text || null,
41
+ absolutePosition: node.absolutePosition,
42
+ layout: node.layout,
43
+ isTextInput: !!node.isTextInput,
44
+ }
45
+ })()`)}async resolveTapTarget(e){return this.evaluate(`(async () => {
46
+ const test = window.__sootsimTest
47
+ if (!test?.resolveTapTarget) return null
48
+ return await test.resolveTapTarget(${e})
49
+ })()`)}async activatePressTarget(e){return this.evaluate(`(async () => {
50
+ const test = window.__sootsimTest
51
+ if (!test) return null
52
+ ${e.id?`const direct = await test.activatePressById?.(${JSON.stringify(e.id)})`:`const direct = await test.activatePressByText?.(${JSON.stringify(e.text||"")})`}
53
+ return direct || null
54
+ })()`)}async activatePressAt(e,t){return this.evaluate(`(async () => {
55
+ const test = window.__sootsimTest
56
+ if (!test?.activatePressAt) return null
57
+ return await test.activatePressAt(${e}, ${t})
58
+ })()`)}async tap(e,t){return await this.bridge.send({type:"tap",browserId:this.opts.browserId,x:e,y:t})}async tapOn(e){let t=typeof e=="string"?{text:e}:e;if(t.point){let a=Y(t.point);(await this.activatePressAt(a.x,a.y))?.ok||await this.tap(a.x,a.y),await f(300);return}let r=5e3,o=150,i=Date.now()+r,n=await this.findElement({text:t.text,id:t.id});for(;!n&&Date.now()<i;)await f(o),n=await this.findElement({text:t.text,id:t.id});if(n&&!n.isTextInput&&(await this.activatePressTarget(t))?.ok){await f(300);return}if(n){let a=typeof n.nodeId=="number"?await this.resolveTapTarget(n.nodeId):null,p=a?.cx??n.absolutePosition.x+n.layout.width/2,h=a?.cy??n.absolutePosition.y+n.layout.height/2;if((await this.tap(p,h))?.hit!==!1){await f(300);return}}if((await this.activatePressTarget(t))?.ok){await f(300);return}throw new Error(`tapOn: element not found: ${JSON.stringify(t)}`)}async tapAtCoords(e,t){await this.tap(e,t),await f(300)}async doubleTapAtCoords(e,t,r=80){let o=Math.max(0,Math.round(r));if(!await this.evaluate(`(async () => {
59
+ const interact = window.__sootsimInteract
60
+ if (interact?.doubleTap) {
61
+ return !!(await interact.doubleTap(${e}, ${t}, ${o}))
62
+ }
63
+ if (!interact?.tap) return false
64
+ const first = await interact.tap(${e}, ${t})
65
+ if (!first || first.hit === false) return false
66
+ await new Promise((resolve) => setTimeout(resolve, ${o}))
67
+ const second = await interact.tap(${e}, ${t})
68
+ return !!second && second.hit !== false
69
+ })()`))throw new Error(`doubleTapAtCoords failed at (${e}, ${t})`);await f(300)}async assertVisible(e){let t=typeof e=="string"?{text:e}:e;for(let r=0;r<15;r++){let o=await this.findElement(t);if(o&&o.absolutePosition.y+o.layout.height>0&&o.absolutePosition.y<E)return;await f(200)}throw new Error(`assertVisible: ${JSON.stringify(t)} not found or off-screen`)}async assertNotVisible(e){let t=typeof e=="string"?{text:e}:e,r=await this.findElement(t);if(r&&r.absolutePosition.y+r.layout.height>0&&r.absolutePosition.y<E)throw new Error(`assertNotVisible: ${JSON.stringify(t)} IS visible`)}async inputText(e){await this.bridge.send({type:"keyboard",browserId:this.opts.browserId,action:"type",text:e}),await f(200)}async pressKey(e){await this.bridge.send({type:"keyboard",browserId:this.opts.browserId,action:"press",text:e}),await f(120)}async dispatchKey(e){await this.bridge.send({type:"keyboard",browserId:this.opts.browserId,action:"dispatchKey",text:e}),await f(120)}async hideKeyboard(){try{await this.callTest("blurFocusedTextInput")}catch{}await this.bridge.send({type:"keyboard",browserId:this.opts.browserId,action:"dismiss"});let e=Date.now()+3e3;for(;Date.now()<e;){let t=await this.evaluate(`(() => {
70
+ const keyboard =
71
+ window.__sootsimKeyboard ??
72
+ window.SootSim?.bridges?.keyboard ??
73
+ null
74
+ const test = window.__sootsimTest
75
+ return {
76
+ visible: !!keyboard?.isVisible?.(),
77
+ focused: !!test?.isTextInputFocused?.(),
78
+ }
79
+ })()`);if(!t?.visible&&!t?.focused){await f(80);return}await f(80)}}async eraseText(e){for(let t=0;t<e;t++)await this.pressKey("Backspace");await f(100)}async waitFor(e){let t=Date.now()+(e.timeout||V);for(;Date.now()<t;){if(await this.findElement(e))return;await f(200)}throw new Error(`waitFor: ${JSON.stringify(e)} not found after ${e.timeout||V}ms`)}async takeScreenshot(e){await f(250);let t=Ne(e),r=De(this.opts.screenshotDir,t.path,{mode:this.opts.screenshotPathMode??"dir",flowDir:this.opts.flowDir});m.mkdirSync(w.dirname(r),{recursive:!0});let i=(await this.bridge.send({type:"screenshot",browserId:this.opts.browserId})).replace(/^data:image\/png;base64,/,""),n=Buffer.from(i,"base64");if(t.withFrame){let l=await this.readCurrentDeviceModel();if(!l)throw new Error("could not read current device model for framed screenshot");let a=await ge(n,l);m.writeFileSync(r,a),console.log(`[flow] screenshot: ${r} (frame: ${l})`);return}m.writeFileSync(r,n),console.log(`[flow] screenshot: ${r}`)}async readCurrentDeviceModel(){let e=await this.bridge.send({type:"call",browserId:this.opts.browserId,path:"SootSim.bridges.settings.get",args:[]}),t=e&&typeof e.deviceModel=="string"?e.deviceModel:null;return!t||!(t in ne)?null:t}async captureFailureScreenshot(e){m.mkdirSync(w.dirname(e),{recursive:!0});let r=(await this.bridge.send({type:"screenshot",browserId:this.opts.browserId})).replace(/^data:image\/png;base64,/,"");m.writeFileSync(e,Buffer.from(r,"base64"))}async captureFailureBundle(e,t){m.mkdirSync(e,{recursive:!0});let r=(p,h)=>{try{m.writeFileSync(w.join(e,p),h)}catch{}},o=async p=>{try{return await this.bridge.send({type:"evaluate",browserId:this.opts.browserId,code:p})}catch{return null}};r("error.json",JSON.stringify({message:t.error.message,stack:t.error.stack,stepIndex:t.stepIndex,stepKind:t.stepKind,stepTarget:t.stepTarget,capturedAt:new Date().toISOString()},null,2));try{let h=(await this.bridge.send({type:"screenshot",browserId:this.opts.browserId})).replace(/^data:image\/png;base64,/,"");r("screenshot.png",Buffer.from(h,"base64"))}catch{}let i=await o(`(async () => {
80
+ const t = window.__sootsimTest
81
+ const mainShell = window.SootSim?.bridges?.mainShell
82
+ if (!t) return { error: 'no test bridge' }
83
+ let shell = null
84
+ try {
85
+ shell = typeof mainShell?.getState === 'function' ? await mainShell.getState() : null
86
+ } catch {}
87
+ const all = await t.queryAll({ pruneHidden: true })
88
+ return { shell, nodes: all, url: location.href, title: document.title }
89
+ })()`);i&&r("describe.json",JSON.stringify(i,null,2));let n=await o("(async () => await window.__sootsimTest?.dumpAccessibilityTree?.(20))()");typeof n=="string"&&r("a11y.txt",n);let l=await o("(async () => await window.__sootsimTest?.dumpTree?.(15))()");typeof l=="string"&&r("tree.txt",l);let a=await o(`(() => {
90
+ const c = window.__sootsimConsole
91
+ return {
92
+ errors: c?.getErrors?.() ?? [],
93
+ warnings: c?.getWarnings?.() ?? [],
94
+ requests: (window.__sootsimGetFailedRequests?.() ?? []),
95
+ }
96
+ })()`);return a&&r("console.json",JSON.stringify(a,null,2)),e}async swipe(e="UP",t=300){let r=U/2,o=E/2,i=200,n=r,l=o,a=r,p=o;switch(e.toUpperCase()){case"UP":l+=i,p-=i;break;case"DOWN":l-=i,p+=i;break;case"LEFT":n+=i,a-=i;break;case"RIGHT":n-=i,a+=i;break}let h=Math.max(10,Math.round(t/16));await this.drag(n,l,a,p,h,16)}async drag(e,t,r,o,i=12,n=16){if(!(await this.evaluate(`(async () => {
97
+ const interact = window.__sootsimInteract
98
+ if (!interact?.drag) return { ok: false }
99
+ const value = await interact.drag(${e}, ${t}, ${r}, ${o}, ${Math.max(1,Math.round(i))}, ${Math.max(0,Math.round(n))})
100
+ return { ok: !!value, value }
101
+ })()`))?.ok)throw new Error("drag failed");await f(300)}async swipeCoords(e,t,r=300){let o=Y(e),i=Y(t),n=Math.max(10,Math.round(r/16));await this.drag(o.x,o.y,i.x,i.y,n,16)}async swipeFrom(e,t="UP",r=300){let o=await this.findElement(e);if(!o)throw new Error(`swipeFrom: element not found: ${JSON.stringify(e)}`);let i=o.absolutePosition.x+o.layout.width/2,n=o.absolutePosition.y+o.layout.height/2,l=180,a=i,p=n;switch(t.toUpperCase()){case"UP":p-=l;break;case"DOWN":p+=l;break;case"LEFT":a-=l;break;case"RIGHT":a+=l;break}let h=Math.max(10,Math.round(r/16));await this.drag(i,n,a,p,h,16)}async scrollTo(e,t,r){let o=await this.callTest("scrollTo",e,t,r,!1);if(!o?.ok)throw new Error(`scrollTo failed: ${o?.reason||"unknown error"}`);await f(250)}async pinch(e){let t=await this.evaluate(`(async () => {
102
+ const interact = window.__sootsimInteract
103
+ if (!interact?.pinch) return { ok: false, reason: 'no interact.pinch' }
104
+ const ok = await interact.pinch(
105
+ ${e.from[0]}, ${e.from[1]}, ${e.from[2]}, ${e.from[3]},
106
+ ${e.to[0]}, ${e.to[1]}, ${e.to[2]}, ${e.to[3]},
107
+ ${e.steps||12}, ${e.stepMs||16}
108
+ )
109
+ return { ok: !!ok, reason: ok ? null : 'pinch returned false' }
110
+ })()`);if(!t?.ok)throw new Error(`pinch failed: ${t?.reason||"unknown error"}`);await f(250)}async dumpTree(e=6){let t=await this.bridge.send({type:"tree",browserId:this.opts.browserId,depth:e});return console.log("[flow] tree:"),console.log(typeof t=="string"?t:JSON.stringify(t,null,2)),typeof t=="string"?t:JSON.stringify(t)}async assertTreeContains(e){if(!(await this.dumpTree(8)).includes(e))throw new Error(`assertTreeContains: "${e}" not in tree`)}async waitForAnimationToEnd(e=2e3){await f(e)}async back(){try{await this.tapOn("\u2039")}catch{await this.tapOn("<")}}async scrollUntilVisible(e){let t=Date.now()+(e.timeout||15e3),r=e.direction?.toUpperCase()||"DOWN",o=r==="DOWN"?"UP":r==="UP"?"DOWN":r;for(;Date.now()<t;){let i=await this.findElement({text:e.element});if(i&&i.absolutePosition.y>=0&&i.absolutePosition.y+i.layout.height>0&&i.absolutePosition.y<E-50){if(e.centerElement){let n=E/2,l=i.absolutePosition.y-n;if(Math.abs(l)>100){let a=Math.min(150,Math.abs(l)*.5),p=l>0?n-a:n+a;await this.drag(U/2,n,U/2,p,10,16)}}return}await this.swipe(o,250),await f(500)}throw new Error(`scrollUntilVisible: "${e.element}" not found`)}async extendedWaitUntil(e){let t=Date.now()+(e.timeout||V);for(;Date.now()<t;){let r=e.visible?!!await this.findElement(typeof e.visible=="string"?{text:e.visible}:e.visible):!0,o=e.notVisible?!await this.findElement(typeof e.notVisible=="string"?{text:e.notVisible}:e.notVisible):!0;if(r&&o)return;await f(200)}throw new Error("extendedWaitUntil timed out")}async launchApp(e){await this.refreshBrowserId();let t=!!(e&&typeof e=="object"&&e.clearState);if(t&&await this.evaluate(`(async () => {
111
+ await (${B})
112
+ try {
113
+ const regs = await navigator.serviceWorker?.getRegistrations?.()
114
+ await Promise.all((regs || []).map((reg) => reg.unregister()))
115
+ } catch {}
116
+ })()`),!this.firstLaunchDone&&!t)this.firstLaunchDone=!0,await this.waitForTree(3e4);else if(this.firstLaunchDone=!0,await this.evaluate("window.location.reload()").catch(()=>{}),await f(500),await this.refreshBrowserId(),await this.waitForTree(12e4),this.opts.onAfterLaunch)try{await this.opts.onAfterLaunch()}catch(r){console.warn(` warn: onAfterLaunch hook threw: ${r instanceof Error?r.message:r}`)}this.profilingEnabled&&await this.startProfile(),this.recordingEnabled&&(await this.waitForVisualSettle(),await this.ensureRecordingStarted())}async waitForVisualSettle(){try{await this.evaluate(`new Promise((resolve) => {
117
+ requestAnimationFrame(() => {
118
+ requestAnimationFrame(() => {
119
+ requestAnimationFrame(() => {
120
+ setTimeout(resolve, 180)
121
+ })
122
+ })
123
+ })
124
+ })`)}catch{await f(180)}}async startProfile(){await this.evaluate(`((sessionKey) => {
125
+ const host = window.__sootsimRenderHost
126
+ if (host?.startPerfSession) {
127
+ host.startPerfSession(sessionKey)
128
+ window[sessionKey] = {
129
+ active: true,
130
+ mode: 'render-worker',
131
+ startedAt: performance.now(),
132
+ }
133
+ return
134
+ }
135
+
136
+ const perf = window.__sootsimPerf
137
+ const a11y = window.__sootsimA11y
138
+ perf?.enableFrameStats?.()
139
+ perf?.resetFrameStats?.()
140
+ a11y?.resetProfile?.()
141
+ window[sessionKey] = {
142
+ active: true,
143
+ mode: 'main-thread',
144
+ startedAt: performance.now(),
145
+ }
146
+ })(${JSON.stringify(Se)})`),this.profilingEnabled=!0}async stopProfile(){let e=await this.evaluate(`(async (sessionKey) => {
147
+ const host = window.__sootsimRenderHost
148
+ if (host?.stopPerfSession) {
149
+ const stopped = await host.stopPerfSession(sessionKey)
150
+ if (!stopped || !Array.isArray(stopped.samples)) {
151
+ return { error: 'no render-worker perf samples available' }
152
+ }
153
+ const samples = stopped.samples
154
+ const frameTimes = samples.map((sample) => Number(sample?.[1]) || 0).filter((value) => value > 0)
155
+ const sorted = [...frameTimes].sort((a, b) => a - b)
156
+ const worstFrames = samples
157
+ .slice()
158
+ .sort((a, b) => (Number(b?.[1]) || 0) - (Number(a?.[1]) || 0))
159
+ .slice(0, 10)
160
+ .map((sample) => [
161
+ Number(sample?.[0]) || 0,
162
+ Number(sample?.[1]) || 0,
163
+ Number(sample?.[2]) || 0,
164
+ Number(sample?.[3]) || 0,
165
+ Number(sample?.[4]) || 0,
166
+ ])
167
+
168
+ return {
169
+ mode: 'render-worker',
170
+ frames: Number(stopped.frameCount) || frameTimes.length,
171
+ totalMs: Number(stopped.totalMs) || frameTimes.reduce((sum, value) => sum + value, 0),
172
+ avgMs: Number(stopped.avgMs) || (frameTimes.length ? frameTimes.reduce((sum, value) => sum + value, 0) / frameTimes.length : 0),
173
+ maxMs: Number(stopped.maxMs) || (sorted[sorted.length - 1] || 0),
174
+ layoutTotalMs: Number(stopped.layoutTotalMs) || samples.reduce((sum, sample) => sum + (Number(sample?.[2]) || 0), 0),
175
+ renderTotalMs: Number(stopped.renderTotalMs) || samples.reduce((sum, sample) => sum + (Number(sample?.[3]) || 0), 0),
176
+ copyTotalMs: Number(stopped.copyTotalMs) || samples.reduce((sum, sample) => sum + (Number(sample?.[4]) || 0), 0),
177
+ layoutAvgMs: Number(stopped.layoutAvgMs) || 0,
178
+ renderAvgMs: Number(stopped.renderAvgMs) || 0,
179
+ copyAvgMs: Number(stopped.copyAvgMs) || 0,
180
+ p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
181
+ p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
182
+ p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
183
+ jankFrames: frameTimes.filter((value) => value > 16.67).length,
184
+ sampleCount: frameTimes.length,
185
+ worstFrames,
186
+ }
187
+ }
188
+
189
+ const perf = window.__sootsimPerf
190
+ const a11y = window.__sootsimA11y
191
+ if (!perf && !a11y) return { error: 'no perf globals available' }
192
+
193
+ const frameStats = perf?.getFrameStats?.() || {}
194
+ const profile = a11y?.profile?.() || {}
195
+ const recent = Array.isArray(frameStats.recentFrames) ? frameStats.recentFrames : []
196
+ const sorted = [...recent].sort((a, b) => a - b)
197
+ perf?.disableFrameStats?.()
198
+
199
+ return {
200
+ mode: 'main-thread',
201
+ frames: frameStats.frames || profile.syncCount || 0,
202
+ totalMs: frameStats.totalMs || 0,
203
+ avgMs: frameStats.totalMs && frameStats.frames ? frameStats.totalMs / frameStats.frames : profile.avgSyncMs || 0,
204
+ maxMs: frameStats.maxMs || profile.maxSyncMs || 0,
205
+ layoutTotalMs: frameStats.layoutTotalMs || 0,
206
+ p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
207
+ p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
208
+ p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
209
+ jankFrames: recent.filter((value) => value > 16.67).length,
210
+ sampleCount: recent.length,
211
+ worstFrames: recent.slice().sort((a, b) => b - a).slice(0, 10),
212
+ }
213
+ })(${JSON.stringify(Se)})`);if(this.profilingEnabled=!1,e?.error)throw new Error(e.error);return e}async stopApp(){await this.evaluate(`(async () => {
214
+ try { await (${B}) } catch {}
215
+ try {
216
+ const regs = await navigator.serviceWorker?.getRegistrations?.()
217
+ await Promise.all((regs || []).map((reg) => reg.unregister()))
218
+ } catch {}
219
+ })()`)}async clearState(){await this.evaluate(`(async () => {
220
+ await (${B})
221
+ })()`)}clearKeychain(){console.warn("[flow] clearKeychain: sootsim has no keychain surface \u2014 no-op (warning)")}async copyTextFrom(e){let t=typeof e=="string"?{id:e}:e,r=await this.findElement(t);if(!r)throw new Error(`copyTextFrom: element not found: ${JSON.stringify(t)}`);let o=r.text??r.testID??"";X.set(Ce,o),console.log(`[flow] copied text: ${JSON.stringify(o)}`)}async evalScript(e){let r=await this.evaluate(`(async () => {
222
+ try {
223
+ return { ok: true, value: await (async () => { ${e} })() }
224
+ } catch (err) {
225
+ return { ok: false, error: err && err.message ? err.message : String(err) }
226
+ }
227
+ })()`);if(!r.ok)throw new Error(`evalScript failed: ${r.error}`);r.value!==void 0&&console.log("[flow] evalScript ->",r.value)}async openLink(e){let t=typeof e=="string"?e:e.link;if(!t)throw new Error("openLink: missing link");await this.evaluate(`window.location.href = ${JSON.stringify(t)}`),await f(300),await this.refreshBrowserId(),await this.waitForTree(3e4)}async evaluateWhen(e){if(e.visible!==void 0){let t=typeof e.visible=="string"?{text:e.visible}:e.visible;return!!await this.findElement(t)}if(e.notVisible!==void 0){let t=typeof e.notVisible=="string"?{text:e.notVisible}:e.notVisible;return!await this.findElement(t)}return e.platform!==void 0?e.platform.toLowerCase()==="ios":e.true!==void 0?e.true.toLowerCase()!=="false":!0}isOptional(e){if(e.optional===!0)return!0;let r=Object.entries(e).find(([i])=>i!=="when"&&i!=="optional"),o=r?r[1]:void 0;return!!(o&&typeof o=="object"&&"optional"in o&&o.optional)}async runStep(e,t){let r=Object.keys(e).find(o=>o!=="when")||Object.keys(e)[0];if(console.log(`[flow] step ${t+1}: ${r}`),e.when&&!await this.evaluateWhen(e.when)){console.log("[flow] (when: predicate false, skipped)");return}try{let o=!!(e.extendedWaitUntil||e.waitFor||e.launchApp||e.runFlow),i=1e4,n=this.runStepInner(e);if(o)await n;else{let a=null,p=new Promise((h,b)=>{a=setTimeout(()=>{b(new Error(`step watchdog: ${r} made no progress in ${i}ms \u2014 bridge or bundle probably hung`))},i)});try{await Promise.race([n,p])}finally{a&&clearTimeout(a)}}let l=!!(e.assertVisible||e.assertNotVisible||e.extendedWaitUntil||e.waitFor);this.stepDelay>0&&!l&&await f(this.stepDelay)}catch(o){if(this.isOptional(e)){console.log(`[flow] (optional, skipped: ${o.message.slice(0,80)})`);return}throw this.lastFailedStep={index:t,kind:r,target:e[r]},o}}async runStepInner(e){if(e.tapOn)await this.tapOn(e.tapOn);else if(e.scrollUntilVisible)await this.scrollUntilVisible(e.scrollUntilVisible);else if(e.extendedWaitUntil)await this.extendedWaitUntil(e.extendedWaitUntil);else if(e.assertVisible)await this.assertVisible(e.assertVisible);else if(e.assertNotVisible)await this.assertNotVisible(e.assertNotVisible);else if(e.inputText)await this.inputText(e.inputText);else if(e.pressKey)await this.pressKey(e.pressKey);else if(e.dispatchKey)await this.dispatchKey(e.dispatchKey);else if(e.waitFor)await this.waitFor(e.waitFor);else if(e.takeScreenshot)await this.takeScreenshot(e.takeScreenshot);else if(e.swipe)e.swipe.start&&e.swipe.end?await this.swipeCoords(e.swipe.start,e.swipe.end,e.swipe.duration):e.swipe.from?await this.swipeFrom(e.swipe.from,e.swipe.direction,e.swipe.duration):await this.swipe(e.swipe.direction,e.swipe.duration);else if(e.scroll)await this.swipe(e.scroll.direction==="DOWN"?"UP":"DOWN");else if(e.scrollTo)await this.scrollTo(e.scrollTo.id,e.scrollTo.x,e.scrollTo.y);else if(e.pinch)await this.pinch(e.pinch);else if(e.waitForAnimationToEnd)await this.waitForAnimationToEnd(typeof e.waitForAnimationToEnd=="number"?e.waitForAnimationToEnd:2e3);else if(e.back)await this.back();else if(e.hideKeyboard)await this.hideKeyboard();else if(e.launchApp)await this.launchApp(e.launchApp);else if(typeof e.wait=="number")await f(e.wait);else if(e.dumpTree)await this.dumpTree(e.dumpTree);else if(e.tapAtCoords)await this.tapAtCoords(e.tapAtCoords.x,e.tapAtCoords.y);else if(e.doubleTapAtCoords)await this.doubleTapAtCoords(e.doubleTapAtCoords.x,e.doubleTapAtCoords.y,e.doubleTapAtCoords.gapMs);else if(e.assertTreeContains)await this.assertTreeContains(e.assertTreeContains);else if(typeof e.eraseText=="number")await this.eraseText(e.eraseText);else if(e.repeat)for(let t=0;t<e.repeat.times;t++)for(let r=0;r<e.repeat.commands.length;r++)await this.runStep(e.repeat.commands[r],r);else if(e.stopApp!==void 0)await this.stopApp();else if(e.clearState!==void 0)await this.clearState();else if(e.clearKeychain!==void 0)this.clearKeychain();else if(e.copyTextFrom!==void 0)await this.copyTextFrom(e.copyTextFrom);else if(typeof e.evalScript=="string")await this.evalScript(e.evalScript);else if(e.openLink!==void 0)await this.openLink(e.openLink);else if(e.runFlow){let t=e.runFlow,r=typeof t=="string"?t:t.file,o=typeof t=="string"?void 0:t.when;if(o&&!await this.evaluateWhen(o)){console.log(`[flow] runFlow skipped (when predicate false): ${r}`);return}let i=w.resolve(this.opts.flowDir,r),n=m.readFileSync(i,"utf8"),l=this.opts.flowDir;this.opts.flowDir=w.dirname(i),await this.runFlow(Re(n)),this.opts.flowDir=l}else throw new Error(`unsupported flow step: ${JSON.stringify(e)}`)}async runFlow(e){let t=[],r=[],o=[];for(let n of e){let l=Object.keys(n);if(l.length===1&&l[0]==="onFlowStart"&&Array.isArray(n.onFlowStart)){t.push(...n.onFlowStart);continue}if(l.length===1&&l[0]==="onFlowComplete"&&Array.isArray(n.onFlowComplete)){r.push(...n.onFlowComplete);continue}o.push(n)}if(t.length>0){console.log(`[flow] onFlowStart (${t.length} steps)`);for(let n=0;n<t.length;n++)await this.runStep(t[n],n)}let i=null;try{await this.runFlowBody(o)}catch(n){i=n instanceof Error?n:new Error(String(n))}if(r.length>0){console.log(`[flow] onFlowComplete (${r.length} steps)`);for(let n=0;n<r.length;n++)try{await this.runStep(r[n],n)}catch(l){console.warn(`[flow] onFlowComplete step ${n+1} failed: ${l instanceof Error?l.message:l}`)}}if(i)throw i}async runFlowBody(e){for(let t=0;t<e.length;t++){let r=e[t],o=typeof r.wait=="number"?r.wait:0,i=typeof r.waitFor?.timeout=="number"?r.waitFor.timeout:0,n=Math.max(6e4,o+15e3,i+15e3);if(r.runFlow){await this.runStep(r,t);continue}await Promise.race([this.runStep(r,t),new Promise((l,a)=>setTimeout(()=>a(new Error(`step ${t+1} (${Object.keys(r)[0]}) exceeded ${n}ms deadline`)),n))])}}};function $e(s){let e={},t=s,r=s.match(/^---\n([\s\S]*?)\n---\n?/);if(r){try{e=A.parse(r[1])??{}}catch(n){console.warn(` warn: could not parse frontmatter: ${n.message}`)}t=s.slice(r[0].length);let i=A.parse(t);return{frontmatter:e,steps:Array.isArray(i)?i:[]}}if(/\n---\s*\n/.test(s))try{let i=A.parseAllDocuments(s);if(i.length>=2){let n=i[0].toJS(),l=i[i.length-1].toJS();return{frontmatter:n&&typeof n=="object"?n:{},steps:Array.isArray(l)?l:[]}}}catch(i){console.warn(` warn: could not parse multi-doc flow: ${i.message}`)}let o=A.parse(t);return{frontmatter:e,steps:Array.isArray(o)?o:[]}}async function Be(){let s=await he(),e=s.find(r=>r.patched);if(e)return`http://localhost:${e.port}/__soot/`;let t=s[0];return t?`http://localhost:${t.port}/__soot/`:null}async function ke(s){(s.length===0||s.includes("--help")||s.includes("-h"))&&(console.log(`
228
+ sootsim flow \u2014 run flows or manage a draft session
229
+
230
+ usage:
231
+ sootsim flow <flow.yaml> [options]
232
+ sootsim flow start
233
+ sootsim flow keep
234
+ sootsim flow end [--output <path>] [--validate] [--video]
235
+ sootsim flow validate <path>
236
+
237
+ options:
238
+ --record record a webm artifact while the flow runs
239
+ --profile capture perf stats while the flow runs
240
+ --out <dir> output directory (default: /tmp/sootsim-recordings)
241
+ --device <model> override the flow frontmatter device for this run
242
+ --slow <ms> delay between steps for natural pacing
243
+ --tail-wait <ms> hold the recording open after the last step so the
244
+ final UI state is captured (default 2000ms when --record
245
+ is on, 0 otherwise)
246
+ --url <url> load this target before running the flow
247
+ --screenshot-paths <mode>
248
+ screenshot path mode: dir (default) or flow
249
+ --replace <m>=<f> replace a Metro module with a local file for this run
250
+ --new open a fresh session before running the flow
251
+ --driver <id> when paired with --new, launch through a specific
252
+ driver from the registry (e.g. playwright for
253
+ hermetic CI runs); see 'sootsim list --drivers'
254
+ --headless pass headless=true to the launch driver (useful
255
+ with --driver playwright)
256
+ --electron prefer opening the target in the desktop companion
257
+ --session <id> target a specific current session
258
+ --validate replay the drafted flow before clearing it
259
+ --video replay and record the drafted flow before clearing it
260
+
261
+ frontmatter (top of flow.yaml between --- markers):
262
+ app: 8081 load this target before the flow starts
263
+ device: iphone-14 set the live device model for this flow run
264
+ electron: true prefer the desktop companion session for this flow
265
+
266
+ default runtime:
267
+ bridge-backed flow playback against the current sootsim session
268
+ if no current session exists, flow opens the discovered target first
269
+ recording and profiling both run on the same bridge-backed path
270
+
271
+ examples:
272
+ sootsim flow login.yaml
273
+ sootsim flow demo.yaml --url 8081 --record --slow 500 --out ./recordings
274
+ sootsim flow demo.yaml --session tab-2
275
+ sootsim flow start
276
+ sootsim flow keep
277
+ sootsim flow end --output ./flows/draft.yaml
278
+ sootsim flow end --output ./flows/draft.yaml --validate
279
+ sootsim flow end --output ./flows/draft.yaml --video
280
+ sootsim flow validate ./flows/draft.yaml
281
+
282
+ flow extension:
283
+ takeScreenshot: hero
284
+ takeScreenshot:
285
+ path: marketing/hero
286
+ withFrame: true
287
+ `),process.exit(0));let e=s[0];$.existsSync(e)||(console.error(` error: ${e} not found`),process.exit(1));let t=d=>s.find((c,v)=>s[v-1]===d),r=s.includes("--profile"),o=s.includes("--new"),i=t("--out")||"/tmp/sootsim-recordings",n=t("--screenshots")||"/tmp/sootsim-flow",l=t("--screenshot-paths")==="flow"?"flow":"dir",a=t("--device")?.trim()||"",p=s.includes("--slow")?+(t("--slow")||"500"):0,h=s.includes("--electron"),b=s.includes("--preview"),j=await ve(t("--preview-origin")),Me=s.includes("--preview-open"),Ae=s.flatMap((d,c)=>s[c-1]==="--replace"?["--replace",d]:[]),F=s.includes("--record")||b,Z=s.includes("--tail-wait")?Math.max(0,+(t("--tail-wait")||"2000")):F?2e3:0,Pe=$.readFileSync(e,"utf8"),{frontmatter:k,steps:P}=$e(Pe);P.length===0&&(console.error(" error: flow file must contain a YAML array of steps"),process.exit(1));let I=a||k.device||"",O=h||k.electron===!0,L=k.app===void 0||k.app===null?"":typeof k.app=="number"?String(k.app):k.app,Q={stripBooleanFlags:["--record","--profile","--electron","--new","--preview","--preview-open","--headless"],stripValueFlags:["--out","--device","--slow","--tail-wait","--url","--replace","--screenshots","--screenshot-paths","--preview-origin","--driver"]},S=z(s,Q),Ee=t("--url")||"";O&&!pe()&&(console.error(" error: desktop companion not found. install or build it first with `bun run build:electron`"),process.exit(1));let ee=O?"desktop companion":"bridge",Ie=L?` | target: ${L}`:"";console.log(`
288
+ sootsim flow \u2014 ${g.basename(e)}
289
+ ${P.length} steps | ${ee}${Ie}${F?" | recording":""}${r?" | profiling":""}${p?` | ${p}ms delay`:""}
290
+ `),b&&ye({event:"preview_flow_started",properties:{flowName:g.basename(e),stepCount:P.length,mode:ee,electron:O,record:F,profile:r,previewOrigin:j}});let x=Ee||L||"",K=o||O&&S.browserIdSource!=="flag",te=!1;if(!x&&!K&&S.browserIdSource==="none"){let d=le(S);try{let c=await d.listBrowsers(),v=c.find(R=>R.isPrimary&&R.readyState==="open"),N=c.find(R=>R.readyState==="open"),se=v??N;se&&(te=!0,console.log(` reusing active session: ${se.id}`))}catch{}finally{d.close()}}if(!x&&!te&&(K||S.browserIdSource==="none")){let d=await Be();d||(console.error(" error: no current session and no sootsim target found"),await q(),process.exit(1)),x=d}if(x&&I){let d=new URL(await we(x));d.searchParams.set("device",I),x=d.toString()}if(x){let d=[x];d.push(...Ae),K&&d.push("--new"),S.browserIdSource==="flag"&&S.browserId&&d.push("--session",S.browserId);let c=t("--driver");c&&d.push("--driver",c),s.includes("--headless")&&d.push("--headless"),await me(d,{port:S.wsPort,timeoutMs:S.commandTimeoutMs})}let _=z(s,Q),re=_.browserIdSource==="flag"?_.browserId:ie()||_.browserId,T=ae(_.wsPort,{commandTimeoutMs:_.commandTimeoutMs,browserId:re,fallbackOnMissingBrowserId:!1}),u,oe=async()=>{if(!I)return!1;let d=await T.send({type:"evaluate",browserId:u.browserId,code:"window.location.href"});if(typeof d=="string"&&d.length>0){let c=new URL(d);c.searchParams.set("device",I),u.setBrowserRouteHint(c.toString())}return!!await T.send({type:"call",browserId:u.browserId,path:"SootSim.bridges.settings.set",args:["deviceModel",I]})};u=new W(T,{screenshotDir:n,flowDir:g.dirname(g.resolve(e)),screenshotPathMode:l,browserId:re,recordingOutputDir:F?i:void 0,billingOriginOverride:b?j:void 0,onAfterLaunch:async()=>{await oe()&&await u.waitForTree(12e4),b&&await T.send({type:"evaluate",browserId:u.browserId,code:`(() => {
291
+ const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
292
+ return r?.start?.() ?? false
293
+ })()`})}}),p&&(u.stepDelay=p);let M=null,y=null,C=null,J=null,D=0,_e=!!P[0]?.launchApp;try{await u.waitForTree(12e4),await oe()&&await u.waitForTree(12e4),F&&(_e?u.prepareRecording():await u.startRecording()),r&&await u.startProfile(),b&&(await T.send({type:"evaluate",browserId:u.browserId,code:`(() => {
294
+ const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
295
+ return r?.start?.() ?? false
296
+ })()`})||console.warn(" warn: eventRecorder.start() returned false \u2014 preview will upload bundle without replay events")),await u.runFlow(P),r&&(M=await u.stopProfile()),F&&Z>0&&await new Promise(c=>setTimeout(c,Z)),F&&(y=await u.stopRecording(),C=u.getLastRecordingDurationMs()),b&&(J=await T.send({type:"evaluate",browserId:u.browserId,code:`(() => {
297
+ const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
298
+ return r?.stop?.() ?? []
299
+ })()`}),console.log(` captured ${J.length} replay events`)),console.log(`
300
+ + completed (${P.length} steps)`),M&&xe(M),y&&console.log(` video: ${y}`),console.log()}catch(d){if(r&&!M)try{M=await u.stopProfile()}catch{}if(F&&!y)try{y=await u.stopRecording(),C=u.getLastRecordingDurationMs()}catch(c){console.warn(` recording stop failed: ${c?.message||String(c)}`)}console.error(`
301
+ x failed: ${d.message}
302
+ `),M&&(console.log(" partial profile:"),xe(M)),y&&console.log(` partial video: ${y}`);try{let c=u.lastFailedStep,v=c?`step-${String(c.index+1).padStart(2,"0")}-${c.kind}`:"unstaged",N=g.join(n,v);await u.captureFailureBundle(N,{error:d,stepIndex:c?.index,stepKind:c?.kind,stepTarget:c?.target}),console.log(` failure bundle: ${N}`),console.log(" (contents: screenshot.png, describe.json, a11y.txt, tree.txt, console.json, error.json)")}catch(c){try{let v=g.join(n,"error.png");await u.captureFailureScreenshot(v),console.log(` error screenshot: ${v}`)}catch{}console.log(` (failure bundle capture failed: ${c instanceof Error?c.message:String(c)})`)}await ce(T,{errorsCommand:`sootsim get errors 5${u.browserId?` --session ${u.browserId}`:""}`,warningsCommand:`sootsim get warnings 5${u.browserId?` --session ${u.browserId}`:""}`,requestsCommand:`sootsim get requests 5${u.browserId?` --session ${u.browserId}`:""}`}),D=1}finally{T.close()}if(D===0&&b)try{let d=await Ve(J??[]),c=["--origin",j,"--events",d];y&&c.push("--video",y),y&&C&&Number.isFinite(C)&&c.push("--video-duration-ms",String(Math.round(C))),u.browserId&&c.push("--session",u.browserId),Me&&c.push("--open"),console.log(`
303
+ preparing preview upload\u2026`);let{runUpload:v}=await import("./upload-Y6FZ5XF2.js");await v(c,{})}catch(d){console.error(` preview upload failed: ${d?.message||d}`),D=1}return await q(),D}async function Ve(s){let{gzipSync:e}=await import("zlib"),t=s.map(i=>JSON.stringify(i)).join(`
304
+ `)+(s.length?`
305
+ `:""),r=e(Buffer.from(t,"utf8")),o=g.join(Te(),`sootsim-events-${Date.now()}.jsonl.gz`);return $.writeFileSync(o,r),console.log(` events: ${s.length} written to ${o} (${r.length} bytes gz)`),o}async function Ue(s){let e=s[0],t=r=>s.find((o,i)=>s[i-1]===r);switch(e){case"start":{let{path:r,state:o}=de();console.log(" flow draft started"),console.log(` session: ${r}`),console.log(` steps: ${o.steps.length}`);return}case"keep":case"good":{let r=ue();if(r.active||(console.error(" no active flow draft \u2014 run `sootsim flow start` first"),process.exit(1)),!r.kept){console.log(" no pending action to keep");return}console.log(` kept: ${r.candidate.summary}`),console.log(` steps: ${r.stepCount}`);return}case"end":{let r=t("--output")||(s[1]&&!s[1].startsWith("-")?s[1]:void 0),o=s.includes("--validate")||s.includes("--video"),i=s.includes("--video"),n=fe(r||(o?je():void 0));if(n.active||(console.error(" no active flow draft \u2014 run `sootsim flow start` first"),process.exit(1)),o){let l=Le(s,n.outputPath),a=await ke(l);if(a!==0){console.error(`
306
+ validation failed \u2014 draft preserved so you can keep iterating`),process.exitCode=a;return}H(),console.log(` flow draft validated (${n.stepCount} step${n.stepCount===1?"":"s"})`),n.outputPath&&console.log(` saved: ${n.outputPath}`),i&&console.log(" video: recorded during validation run");return}if(H(),console.log(` flow draft ended (${n.stepCount} step${n.stepCount===1?"":"s"})`),n.outputPath){console.log(` saved: ${n.outputPath}`),console.log(` next: sootsim flow ${n.outputPath} --record`);return}console.log(""),process.stdout.write(n.yaml);return}case"validate":{let r=s[1];(!r||r.startsWith("-"))&&(console.error(" usage: sootsim flow validate <path>"),process.exit(1));let o=We(r);if(o.length>0){console.error(` x ${r} failed validation:`);for(let i of o)console.error(` - ${i}`);process.exit(1)}console.log(` + ${r} looks valid`);return}}}var Fe=new Set(["tapOn","inputText","pressKey","dispatchKey","hideKeyboard","swipe","pinch","scroll","scrollUntilVisible"]);function We(s){let e=[];if(!$.existsSync(s))return[`file not found: ${s}`];let t;try{t=$.readFileSync(s,"utf8")}catch(i){return[`cannot read file: ${i.message}`]}if(t.trim().length===0)return["file is empty"];let r;try{r=$e(t)}catch(i){return[`yaml parse error: ${i.message}`]}if(!Array.isArray(r.steps)||r.steps.length===0)return e.push("flow body must be a non-empty YAML array of steps"),e;let o=0;for(let i=0;i<r.steps.length;i++){let n=r.steps[i];n&&typeof n=="object"?Object.keys(n).some(a=>Fe.has(a))&&(o+=1):typeof n=="string"&&Fe.has(n)&&(o+=1)}return o===0&&e.push("no interaction steps found (expected at least one tapOn / inputText / pressKey / swipe / scroll)"),e}async function lt(s){let e=s[0];if(e==="start"||e==="keep"||e==="good"||e==="end"||e==="validate")return await Ue(s),0;let t=await ke(s);return t!==0&&(process.exitCode=t),t}function xe(s){let e=s.avgMs>0?(1e3/s.avgMs).toFixed(1):"?",t=s.sampleCount>0?(s.jankFrames/s.sampleCount*100).toFixed(1):"0";console.log(`
307
+ profile:`),console.log(` frames: ${s.frames}`),console.log(` total: ${s.totalMs.toFixed(1)}ms`),console.log(` avg: ${s.avgMs.toFixed(2)}ms (${e} fps)`),console.log(` max: ${s.maxMs.toFixed(2)}ms`),s.layoutAvgMs!==void 0&&console.log(` breakdown: layout ${s.layoutAvgMs.toFixed(2)}ms | render ${s.renderAvgMs?.toFixed(2)||"0.00"}ms | copy ${s.copyAvgMs?.toFixed(2)||"0.00"}ms`),console.log(` p95: ${s.p95.toFixed(2)}ms`),console.log(` p99: ${s.p99.toFixed(2)}ms`),console.log(` jank: ${s.jankFrames}/${s.sampleCount} (${t}%) >16.67ms`);let r=Array.isArray(s.worstFrames)?s.worstFrames:[];if(r.length!==0){if(console.log(`
308
+ worst frames:`),s.mode==="render-worker"){console.log(" total layout render copy t+");for(let o of r){let[i,n,l,a,p]=o;console.log(` ${n.toFixed(2).padStart(7)} ${l.toFixed(2).padStart(7)} ${a.toFixed(2).padStart(7)} ${p.toFixed(2).padStart(7)} ${String(i).padStart(5)}`)}return}console.log(` ${r.map(o=>o.toFixed(2)).join(", ")}`)}}function je(){return g.join(Te(),`sootsim-flow-draft-${Date.now()}.yaml`)}function Le(s,e){if(!e)throw new Error("validated flow draft requires an output path");let t=[e];for(let r=1;r<s.length;r++){let o=s[r];if(!(o==="--validate"||o==="--video")){if(o==="--output"){r+=1;continue}r===1&&!o.startsWith("-")||t.push(o)}}return!t.includes("--record")&&s.includes("--video")&&t.push("--record"),t}export{$e as a,Be as b,ke as c,lt as d};
@@ -0,0 +1,2 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{h as s,p as a}from"./chunk-EQ7G3UHS.js";import{spawn as l}from"child_process";import{existsSync as f}from"fs";import{WebSocket as d}from"ws";async function w(){let e=a();if(e&&f(s(e)))return;console.log(" first run \u2014 installing sootsim engine runtime (~6 MB)...");let{runRuntime:o}=await import("./runtime-Z2WIXYUN.js");await o(["install"],{})}async function p(e=7668,o=5e3){if(await m(e,250))return;console.log(" starting sootsim bridge..."),l(process.execPath,[process.argv[1],"server","--quiet"],{detached:!0,stdio:"ignore"}).unref();let n=Date.now()+o;for(;Date.now()<n;){if(await m(e,200))return;await new Promise(t=>setTimeout(t,100))}throw new Error(`sootsim bridge failed to come up within ${o}ms \u2014 try \`sootsim server\` to debug`)}async function y(e=7668){await w(),await p(e)}function m(e,o){return new Promise(i=>{let n=new d(`ws://127.0.0.1:${e}`,{handshakeTimeout:o}),t=!1,r=u=>{if(!t){t=!0;try{n.close()}catch{}i(u)}};n.once("open",()=>r(!0)),n.once("error",()=>r(!1)),setTimeout(()=>r(!1),o)})}export{w as a,p as b,y as c};
@@ -1,5 +1,5 @@
1
- /*! sootsim v0.0.1 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import"./chunk-E522F5JW.js";import{existsSync as x,readFileSync as j}from"fs";import{resolve as g}from"path";async function P(s){(s.includes("--help")||s.includes("-h"))&&(console.log(`
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import"./chunk-P5C3UASK.js";import{existsSync as x,readFileSync as j}from"fs";import{resolve as g}from"path";async function P(s){(s.includes("--help")||s.includes("-h"))&&(console.log(`
3
3
  sootsim compat \u2014 check package compatibility
4
4
 
5
5
  usage:
@@ -20,7 +20,7 @@ examples:
20
20
  sootsim compat react-native-reanimated
21
21
  sootsim compat --json
22
22
  sootsim compat --brief
23
- `),process.exit(0));let u=s.includes("--json"),e=s.includes("--brief"),l=s.indexOf("--app"),a=l!==-1&&s[l+1]?g(s[l+1]):process.cwd(),k=s.filter((o,n)=>!o.startsWith("-")&&(l===-1||n!==l+1))[0];if(u||e){let{scanDeps:o}=await import("@soot/compat"),n=g(a,"package.json");x(n)||(console.error(" no package.json found in",a),process.exit(1));let r=JSON.parse(j(n,"utf8")),c=o(r);if(u){console.log(JSON.stringify(c,null,2));return}if(c.packages.length===0){console.log(" no RN ecosystem packages detected");return}let T=Math.round(c.overallScore*100),$=c.packages.filter(i=>i.status==="full").length,v=c.packages.filter(i=>i.status==="partial"||i.status==="auto-stub").length,w=c.packages.filter(i=>i.status==="unsupported").length,p=[];$&&p.push(`${$} fully supported`),v&&p.push(`${v} partial`),w&&p.push(`${w} unsupported`),console.log(` ${p.join(", ")} \u2014 ${T}% compatible`);return}let{POLYFILL_REGISTRY:d}=await import("@soot/compat/web");if(k){W(k,d);return}let b=g(a,"package.json");x(b)||(console.error(" no package.json found in",a),process.exit(1));let m=JSON.parse(j(b,"utf8")),S={...m.dependencies,...m.devDependencies},t={full:[],partial:[],autoStub:[],unsupported:[],justWorks:[],unknown:[]};for(let o of Object.keys(S)){let n=d[o];if(n){let r=n.status;if(!r&&n.stubType&&(r=n.stubType==="native"?"full":n.stubType==="just-works"?"not-relevant":n.stubType),!r&&n.versions?.length){let c=Math.max(...n.versions.map(y=>y.coverage||0));r=c>=.8?"full":c>=.3?"partial":"auto-stub"}switch(r){case"full":t.full.push(o);break;case"partial":t.partial.push(o);break;case"auto-stub":t.autoStub.push(o);break;case"unsupported":t.unsupported.push(o);break;case"not-relevant":t.justWorks.push(o);break;default:f(o)&&t.unknown.push(o)}}else f(o)&&t.unknown.push(o)}console.log(`
23
+ `),process.exit(0));let i=s.includes("--json"),e=s.includes("--brief"),l=s.indexOf("--app"),n=l!==-1&&s[l+1]?g(s[l+1]):process.cwd(),k=s.filter((o,a)=>!o.startsWith("-")&&(l===-1||a!==l+1))[0];if(i||e){let{scanDeps:o}=await import("@soot/compat"),a=g(n,"package.json");x(a)||(console.error(" no package.json found in",n),process.exit(1));let p=JSON.parse(j(a,"utf8")),r=o(p);if(i){console.log(JSON.stringify(r,null,2));return}if(r.packages.length===0){console.log(" no RN ecosystem packages detected");return}let T=Math.round(r.overallScore*100),$=r.packages.filter(c=>c.status==="full").length,v=r.packages.filter(c=>c.status==="partial"||c.status==="auto-stub").length,w=r.packages.filter(c=>c.status==="unsupported").length,u=[];$&&u.push(`${$} fully supported`),v&&u.push(`${v} partial`),w&&u.push(`${w} unsupported`),console.log(` ${u.join(", ")} \u2014 ${T}% compatible`);return}let{POLYFILL_REGISTRY:d}=await import("@soot/compat/web");if(k){W(k,d);return}let b=g(n,"package.json");x(b)||(console.error(" no package.json found in",n),process.exit(1));let m=JSON.parse(j(b,"utf8")),S={...m.dependencies,...m.devDependencies},t={full:[],partial:[],autoStub:[],unsupported:[],justWorks:[],unknown:[]};for(let o of Object.keys(S)){let a=d[o];if(a){let p=a.stubType==="native"?"full":a.stubType==="works"?"not-relevant":a.stubType;if(a.stubType!=="native"&&a.versions?.length){let r=Math.max(...a.versions.map(y=>y.coverage||0));p=r>=.8?"full":r>=.3?"partial":"auto-stub"}switch(p){case"full":t.full.push(o);break;case"partial":t.partial.push(o);break;case"auto-stub":t.autoStub.push(o);break;case"unsupported":t.unsupported.push(o);break;case"not-relevant":t.justWorks.push(o);break;default:f(o)&&t.unknown.push(o)}}else f(o)&&t.unknown.push(o)}console.log(`
24
24
  sootsim compatibility report
25
25
  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
26
26
 
@@ -30,4 +30,4 @@ examples:
30
30
  unsupported (${t.unsupported.length}):`);for(let o of t.unsupported)console.log(` x ${o}`)}if(t.unknown.length){console.log(`
31
31
  unknown native packages (${t.unknown.length}):`);for(let o of t.unknown)console.log(` ? ${o}`)}console.log(`
32
32
  total: ${t.full.length} full, ${t.partial.length} partial, ${t.autoStub.length} auto-stub, ${t.unsupported.length} unsupported, ${t.unknown.length} unknown
33
- `)}function W(s,u){let e=u[s];if(!e){f(s)?console.log(` ${s}: unknown native package (may be auto-stubbed)`):console.log(` ${s}: not a native package (should work as-is)`);return}let l=e.status;if(!l&&e.stubType&&(l=e.stubType==="native"?"full":e.stubType),!l&&e.versions?.length){let a=Math.max(...e.versions.map(h=>h.coverage||0));l=a>=.8?"full":a>=.3?"partial":"auto-stub"}if(console.log(` ${s}:`),console.log(` status: ${l||"unknown"}`),e.stubType&&console.log(` stub type: ${e.stubType}`),e.category&&console.log(` category: ${e.category}`),e.versions?.length)for(let a of e.versions)console.log(` ${a.range}: ${Math.round((a.coverage||0)*100)}% coverage${a.note?` \u2014 ${a.note}`:""}`)}function f(s){return s.startsWith("expo-")||s.startsWith("react-native-")||s.startsWith("@react-native/")||s.startsWith("@react-native-community/")||s.startsWith("@expo/")||s==="expo"}export{P as runCompat};
33
+ `)}function W(s,i){let e=i[s];if(!e){f(s)?console.log(` ${s}: unknown native package (may be auto-stubbed)`):console.log(` ${s}: not a native package (should work as-is)`);return}let l=e.status;if(!l&&e.stubType&&(l=e.stubType==="native"?"full":e.stubType),!l&&e.versions?.length){let n=Math.max(...e.versions.map(h=>h.coverage||0));l=n>=.8?"full":n>=.3?"partial":"auto-stub"}if(console.log(` ${s}:`),console.log(` status: ${l||"unknown"}`),e.stubType&&console.log(` stub type: ${e.stubType}`),e.category&&console.log(` category: ${e.category}`),e.versions?.length)for(let n of e.versions)console.log(` ${n.range}: ${Math.round((n.coverage||0)*100)}% coverage${n.note?` \u2014 ${n.note}`:""}`)}function f(s){return s.startsWith("expo-")||s.startsWith("react-native-")||s.startsWith("@react-native/")||s.startsWith("@react-native-community/")||s.startsWith("@expo/")||s==="expo"}export{P as runCompat};
@@ -1,5 +1,5 @@
1
- /*! sootsim v0.0.1 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import"./chunk-E522F5JW.js";import{existsSync as s,writeFileSync as n}from"fs";import{resolve as t}from"path";async function r(e){let i=e[0];switch((!i||e.includes("--help")||e.includes("-h"))&&(console.log(`
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import"./chunk-P5C3UASK.js";import{existsSync as i,writeFileSync as n,readFileSync as c}from"fs";import{resolve as t}from"path";async function a(s){let e=s[0];switch((!e||s.includes("--help")||s.includes("-h"))&&(console.log(`
3
3
  sootsim config \u2014 manage sootsim configuration
4
4
 
5
5
  usage:
@@ -8,13 +8,13 @@ usage:
8
8
  subcommands:
9
9
  init create a sootsim.config.ts in the current directory
10
10
  validate check the current config for errors
11
- show display the resolved configuration
11
+ show print the current sootsim.config.ts
12
12
 
13
13
  examples:
14
14
  sootsim config init
15
15
  sootsim config validate
16
16
  sootsim config show
17
- `),process.exit(0)),i){case"init":{let o=t(process.cwd(),"sootsim.config.ts");s(o)&&(console.log(" sootsim.config.ts already exists"),process.exit(1)),n(o,`import { defineConfig } from 'sootsim-engine/config'
17
+ `),process.exit(0)),e){case"init":{let o=t(process.cwd(),"sootsim.config.ts");i(o)&&(console.log(" sootsim.config.ts already exists"),process.exit(1)),n(o,`import { defineConfig } from 'sootsim/config'
18
18
 
19
19
  export default defineConfig({
20
20
  // module resolution overrides
@@ -42,4 +42,4 @@ export default defineConfig({
42
42
  // colorScheme: 'light',
43
43
  },
44
44
  })
45
- `),console.log(" created sootsim.config.ts");break}case"validate":{let o=t(process.cwd(),"sootsim.config.ts");s(o)||(console.log(" no sootsim.config.ts found"),console.log(" run 'sootsim config init' to create one"),process.exit(1)),console.log(` config exists at: ${o}`),console.log(" (full validation not yet implemented)");break}case"show":{let{settingsStore:o}=await import("./store-PU5ES4YQ.js");console.log(JSON.stringify(o.getAll(),null,2));break}default:console.error(` unknown subcommand: ${i}`),process.exit(1)}}export{r as runConfig};
45
+ `),console.log(" created sootsim.config.ts");break}case"validate":{let o=t(process.cwd(),"sootsim.config.ts");i(o)||(console.log(" no sootsim.config.ts found"),console.log(" run 'sootsim config init' to create one"),process.exit(1)),console.log(` config exists at: ${o}`),console.log(" (full validation not yet implemented)");break}case"show":{let o=t(process.cwd(),"sootsim.config.ts");i(o)||(console.log(" no sootsim.config.ts found"),console.log(" run 'sootsim config init' to create one"),process.exit(1)),console.log(c(o,"utf8"));break}default:console.error(` unknown subcommand: ${e}`),process.exit(1)}}export{a as runConfig};
@@ -0,0 +1,2 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{b as a,c as b,d as c,e as d,f as e,g as f,h as g,i as h,j as i,k as j,l as k,m as l,n as m}from"./chunk-BU3TZP4Y.js";import"./chunk-REYWQVAH.js";import"./chunk-SUZR2SZZ.js";import"./chunk-USRNDVQ3.js";import"./chunk-WUYJFYOW.js";import"./chunk-4RYT6AQV.js";import"./chunk-RLS6PHBW.js";import"./chunk-LV5U7TI4.js";import"./chunk-EQ7G3UHS.js";import"./chunk-2FPPPJE5.js";import"./chunk-46LRF7PH.js";import"./chunk-P5C3UASK.js";export{d as buildOpenUrl,c as buildShellUrl,f as printConnectedBrowsers,a as resolveBundleTarget,b as resolveDefaultShellBaseUrl,l as runClaimCommand,m as runCloseCommand,k as runFocusCommand,h as runListCommand,i as runOpenCommand,j as runUseCommand,e as summarizeBrowserUrl,g as waitForBrowserMatch};
@@ -1,5 +1,5 @@
1
- /*! sootsim v0.0.1 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import"./chunk-X2U72K7X.js";import"./chunk-E522F5JW.js";import{execFileSync as k,spawnSync as o}from"child_process";import{existsSync as i,mkdirSync as d,readFileSync as v,rmSync as f,writeFileSync as y}from"fs";import{homedir as p}from"os";import{dirname as $,resolve as c}from"path";var l="dev.sootsim.server",a="sootsim-server",u=c(p(),"Library/Logs/sootsim"),b=c(p(),".local/state/sootsim");async function F(t,s={}){let[r,...e]=t,n=s.port??7668;if(!r||r==="--help"||r==="-h"){h();return}switch(r){case"install":return P({port:n,force:e.includes("--force")});case"uninstall":return D();case"status":return E();case"restart":return I();case"start":return A();case"stop":return R();default:console.error(` unknown daemon subcommand: ${r}`),h(),process.exit(1)}}function h(){console.log(`
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import"./chunk-LV5U7TI4.js";import"./chunk-P5C3UASK.js";import{execFileSync as k,spawnSync as o}from"child_process";import{existsSync as i,mkdirSync as d,readFileSync as v,rmSync as f,writeFileSync as y}from"fs";import{homedir as p}from"os";import{dirname as $,resolve as c}from"path";var l="dev.sootsim.server",a="sootsim-server",u=c(p(),"Library/Logs/sootsim"),b=c(p(),".local/state/sootsim");async function F(t,s={}){let[r,...e]=t,n=s.port??7668;if(!r||r==="--help"||r==="-h"){h();return}switch(r){case"install":return P({port:n,force:e.includes("--force")});case"uninstall":return D();case"status":return E();case"restart":return I();case"start":return A();case"stop":return R();default:console.error(` unknown daemon subcommand: ${r}`),h(),process.exit(1)}}function h(){console.log(`
3
3
  sootsim daemon \u2014 manage the sootsim bridge as a login agent
4
4
 
5
5
  usage:
@@ -1,5 +1,5 @@
1
- /*! sootsim v0.0.1 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import{d as f}from"./chunk-64TOMNZX.js";import{b as v}from"./chunk-KSB6MSZ4.js";import{b as $,d as S,f as N}from"./chunk-MPSZ5EWF.js";import"./chunk-3C3ZH7PP.js";import"./chunk-X2U72K7X.js";import"./chunk-E522F5JW.js";var A=["portals","sheets","layout","onlayout","animated","render","touch","yoga","all"],x="__sootsimShellAnimationTrace",R="__sootsimDebugAnimation";function D(){console.log(`
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{d as f}from"./chunk-FTRI7SVV.js";import{b as N}from"./chunk-SUZR2SZZ.js";import{c as v,e as $,g as S}from"./chunk-4RYT6AQV.js";import"./chunk-RLS6PHBW.js";import"./chunk-LV5U7TI4.js";import"./chunk-EQ7G3UHS.js";import"./chunk-P5C3UASK.js";var A=["portals","sheets","layout","onlayout","animated","render","touch","yoga","all"],x="__sootsimShellAnimationTrace",R="__sootsimDebugAnimation";function D(){console.log(`
3
3
  sootsim debug \u2014 drive __sootsimDebug from the terminal
4
4
 
5
5
  usage:
@@ -167,7 +167,7 @@ examples:
167
167
  } : null,
168
168
  samples,
169
169
  }
170
- })()`}async function l(i,c){return N(i,c)}async function z(i,c){let g=$(i,{port:c.port,stripBooleanFlags:["--pretty","--json","--help","-h"]}),m=g.positional;(!m[0]||i.includes("--help")||i.includes("-h"))&&(D(),process.exit(0));let C=g.wsPort,k=g.browserId,n=!i.includes("--json"),y=k?` --session ${k}`:"",_=m[0],a=m.slice(1);if(new Set(["state","js","eval","perf","sample-color"]).has(_)){let{runInspect:e}=await import("./inspect-NAHXP2M5.js");await e(["debug",...i],{port:c.port,verbose:c.verbose});return}let o=S(g);try{switch(_){case"enable":{let e=O(a[0]);e.length===0&&(console.error(` usage: sootsim debug enable <channel[,channel,...]>
170
+ })()`}async function l(i,c){return S(i,c)}async function z(i,c){let g=v(i,{port:c.port,stripBooleanFlags:["--pretty","--json","--help","-h"]}),m=g.positional;(!m[0]||i.includes("--help")||i.includes("-h"))&&(D(),process.exit(0));let C=g.wsPort,k=g.browserId,n=!i.includes("--json"),y=k?` --session ${k}`:"",_=m[0],a=m.slice(1);if(new Set(["state","js","eval","perf","sample-color"]).has(_)){let{runInspect:e}=await import("./inspect-DSU6ELRM.js");await e(["debug",...i],{port:c.port,verbose:c.verbose});return}let o=$(g);try{switch(_){case"enable":{let e=O(a[0]);e.length===0&&(console.error(` usage: sootsim debug enable <channel[,channel,...]>
171
171
  known: ${A.join(", ")}`),process.exit(1));let t=e.map(u=>JSON.stringify(u)).join(", "),s=await l(o,`window.__sootsimDebug.enable(${t})`);console.log(r({active:s},n));break}case"disable":{let e=O(a[0]),t=e.length>0?e.map(u=>JSON.stringify(u)).join(", "):"'all'",s=await l(o,`window.__sootsimDebug.disable(${t})`);console.log(r({active:s},n));break}case"toggle":{let e=a[0];e||(console.error(" usage: sootsim debug toggle <channel>"),process.exit(1));let t=await l(o,`window.__sootsimDebug.toggle(${JSON.stringify(e)})`);console.log(r({[e]:t},n));break}case"status":{let e=await l(o,"window.__sootsimDebug.status()");console.log(r(e,n));break}case"channels":{let e=await l(o,"window.__sootsimDebug.channels()");console.log(r(e,n));break}case"flags":{let e=await l(o,"window.__sootsimDebug.flags()");console.log(r(e,n));break}case"snapshot":{let e=a[0],t=e?`window.__sootsimDebug.snapshot(${JSON.stringify(e)})`:"window.__sootsimDebug.snapshot()",s=await l(o,`(() => { const s = ${t}; if (!s) return null; return { label: s.label, at: s.at, size: s.nodes.size }; })()`);console.log(r(s,n));break}case"snapshots":{let e=await l(o,"window.__sootsimDebug.snapshots()");console.log(r(e,n));break}case"diff":{let e=a[0],t=a[1];(!e||!t)&&(console.error(" usage: sootsim debug diff <labelA> <labelB>"),process.exit(1));let s=`(() => {
172
172
  const d = window.__sootsimDebug.diff(${JSON.stringify(e)}, ${JSON.stringify(t)});
173
173
  if (!d) return null;
@@ -179,4 +179,4 @@ examples:
179
179
  removed: d.removed,
180
180
  changed: d.changed,
181
181
  };
182
- })()`,u=await l(o,s);console.log(r(u,n));break}case"clear-snapshots":{let e=a[0],t=e?`window.__sootsimDebug.clearSnapshots(${JSON.stringify(e)})`:"window.__sootsimDebug.clearSnapshots()";await l(o,t),console.log(r({cleared:e||"all"},n));break}case"find":{let e=a[0];if(e==="sheets"){let t=await l(o,"window.__sootsimDebug.findSheets()");console.log(r(t,n))}else if(e==="portals"){let t=await l(o,"window.__sootsimDebug.findPortals()");console.log(r(t,n))}else console.error(" usage: sootsim debug find <sheets|portals>"),process.exit(1);break}case"trace":{let e=a[0],t=a[1];if(e==="anim"){let s=a[1];if((!s||s==="--help"||s==="-h")&&(console.error(" usage: sootsim debug trace anim <on|off|status|clear|<id>> [id|limit]"),process.exit(1)),s==="on"){let d=a[2]??"all",b=a[3]?Number(a[3]):void 0,h=d==="all"?"all":Number(d);h!=="all"&&!Number.isFinite(h)&&(console.error(` invalid target: ${d}`),process.exit(1)),await f(o,"enableAnimationTrace",h,b);let B=await f(o,"listAnimationTraces");console.log(r({enabled:h,traces:B},n));break}if(s==="off"){let d=a[2]??"all",b=d==="all"?"all":Number(d);b!=="all"&&!Number.isFinite(b)&&(console.error(` invalid target: ${d}`),process.exit(1)),await f(o,"disableAnimationTrace",b),console.log(r({disabled:b},n));break}if(s==="status"||s==="clear"){s==="clear"&&await f(o,"disableAnimationTrace","all");let d=await f(o,"listAnimationTraces");console.log(r({traces:d},n));break}let u=Number(s);Number.isFinite(u)||(console.error(` invalid id: ${s}`),process.exit(1));let T=a[2]?Number(a[2]):void 0,L=await f(o,"getAnimationTrace",u,T);console.log(r({id:u,samples:L},n));break}if(e!=="shell"&&(console.error(" usage: sootsim debug trace <shell|anim> [args]"),process.exit(1)),!t||/^[0-9]+$/.test(t)){let s=t?Number(t):50,u=await l(o,j(s));console.log(r(u,n));break}if(t==="on"){let s=a[2]?Number(a[2]):240,u=await l(o,w("on",s));console.log(r(u,n));break}if(t==="off"){let s=await l(o,w("off"));console.log(r(s,n));break}if(t==="clear"){let s=await l(o,w("clear"));console.log(r(s,n));break}if(t==="status"){let s=await l(o,w("status"));console.log(r(s,n));break}console.error(" usage: sootsim debug trace shell [on [limit]|off|status|clear|recentLimit]"),process.exit(1)}case"record":{let e=a[0],s=await l(o,`window.__sootsimDebug.record(${e==="on"?"true":e==="off"?"false":"undefined"})`);console.log(r({recording:s},n));break}case"recent":{let e=a[0],t=a[1]?Number(a[1]):50,s=e&&e!=="all"?`window.__sootsimDebug.recent(${JSON.stringify(e)}, ${t})`:`window.__sootsimDebug.recent(undefined, ${t})`,u=await l(o,s);console.log(r(u,n));break}case"clear-events":{await l(o,"window.__sootsimDebug.clearEvents()"),console.log(r({cleared:!0},n));break}default:console.error(` unknown subcommand: ${_}`),D(),process.exit(1)}}catch(e){console.error(` debug failed: ${e.message}`),await v(o,{errorsCommand:`sootsim get errors 5${y}`,warningsCommand:`sootsim get warnings 5${y}`,requestsCommand:`sootsim get requests 5${y}`}),process.exit(1)}finally{o.close()}}export{z as runDebug};
182
+ })()`,u=await l(o,s);console.log(r(u,n));break}case"clear-snapshots":{let e=a[0],t=e?`window.__sootsimDebug.clearSnapshots(${JSON.stringify(e)})`:"window.__sootsimDebug.clearSnapshots()";await l(o,t),console.log(r({cleared:e||"all"},n));break}case"find":{let e=a[0];if(e==="sheets"){let t=await l(o,"window.__sootsimDebug.findSheets()");console.log(r(t,n))}else if(e==="portals"){let t=await l(o,"window.__sootsimDebug.findPortals()");console.log(r(t,n))}else console.error(" usage: sootsim debug find <sheets|portals>"),process.exit(1);break}case"trace":{let e=a[0],t=a[1];if(e==="anim"){let s=a[1];if((!s||s==="--help"||s==="-h")&&(console.error(" usage: sootsim debug trace anim <on|off|status|clear|<id>> [id|limit]"),process.exit(1)),s==="on"){let d=a[2]??"all",b=a[3]?Number(a[3]):void 0,h=d==="all"?"all":Number(d);h!=="all"&&!Number.isFinite(h)&&(console.error(` invalid target: ${d}`),process.exit(1)),await f(o,"enableAnimationTrace",h,b);let B=await f(o,"listAnimationTraces");console.log(r({enabled:h,traces:B},n));break}if(s==="off"){let d=a[2]??"all",b=d==="all"?"all":Number(d);b!=="all"&&!Number.isFinite(b)&&(console.error(` invalid target: ${d}`),process.exit(1)),await f(o,"disableAnimationTrace",b),console.log(r({disabled:b},n));break}if(s==="status"||s==="clear"){s==="clear"&&await f(o,"disableAnimationTrace","all");let d=await f(o,"listAnimationTraces");console.log(r({traces:d},n));break}let u=Number(s);Number.isFinite(u)||(console.error(` invalid id: ${s}`),process.exit(1));let T=a[2]?Number(a[2]):void 0,L=await f(o,"getAnimationTrace",u,T);console.log(r({id:u,samples:L},n));break}if(e!=="shell"&&(console.error(" usage: sootsim debug trace <shell|anim> [args]"),process.exit(1)),!t||/^[0-9]+$/.test(t)){let s=t?Number(t):50,u=await l(o,j(s));console.log(r(u,n));break}if(t==="on"){let s=a[2]?Number(a[2]):240,u=await l(o,w("on",s));console.log(r(u,n));break}if(t==="off"){let s=await l(o,w("off"));console.log(r(s,n));break}if(t==="clear"){let s=await l(o,w("clear"));console.log(r(s,n));break}if(t==="status"){let s=await l(o,w("status"));console.log(r(s,n));break}console.error(" usage: sootsim debug trace shell [on [limit]|off|status|clear|recentLimit]"),process.exit(1)}case"record":{let e=a[0],s=await l(o,`window.__sootsimDebug.record(${e==="on"?"true":e==="off"?"false":"undefined"})`);console.log(r({recording:s},n));break}case"recent":{let e=a[0],t=a[1]?Number(a[1]):50,s=e&&e!=="all"?`window.__sootsimDebug.recent(${JSON.stringify(e)}, ${t})`:`window.__sootsimDebug.recent(undefined, ${t})`,u=await l(o,s);console.log(r(u,n));break}case"clear-events":{await l(o,"window.__sootsimDebug.clearEvents()"),console.log(r({cleared:!0},n));break}default:console.error(` unknown subcommand: ${_}`),D(),process.exit(1)}}catch(e){console.error(` debug failed: ${e.message}`),await N(o,{errorsCommand:`sootsim get errors 5${y}`,warningsCommand:`sootsim get warnings 5${y}`,requestsCommand:`sootsim get requests 5${y}`}),process.exit(1)}finally{o.close()}}export{z as runDebug};
@@ -0,0 +1,2 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{a}from"./chunk-O2HBPZW5.js";import"./chunk-P5C3UASK.js";export{a as APPS};
@@ -1,5 +1,5 @@
1
- /*! sootsim v0.0.1 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import{b as S}from"./chunk-CKZ376AY.js";import"./chunk-G5MR66EB.js";import"./chunk-A2CZQIWO.js";import"./chunk-KXYKAYYB.js";import"./chunk-PWXPA745.js";import"./chunk-KSACMDXK.js";import"./chunk-KQWZZ56P.js";import"./chunk-YCETS3B3.js";import"./chunk-JSF5LPNT.js";import"./chunk-HOIHCO7S.js";import"./chunk-KSB6MSZ4.js";import"./chunk-OROM7DZI.js";import"./chunk-MPSZ5EWF.js";import"./chunk-3C3ZH7PP.js";import"./chunk-E5UBZEYR.js";import"./chunk-X2U72K7X.js";import"./chunk-74XPLOV4.js";import"./chunk-MBFP2LVH.js";import"./chunk-E522F5JW.js";import{spawn as b}from"child_process";import{existsSync as u,mkdirSync as D,writeFileSync as f,unlinkSync as _}from"fs";import{tmpdir as I}from"os";import{dirname as P,resolve as i,join as $}from"path";function M(){try{let e=import.meta.resolve("sootsim/detox");return P(e.startsWith("file://")?e.slice(7):e)}catch{return i(import.meta.dirname,"..","..","detox")}}var E=`
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{b as S}from"./chunk-XJBPH4JR.js";import"./chunk-5IPP4HAW.js";import"./chunk-BYLX2DO4.js";import"./chunk-3K6VDPVD.js";import"./chunk-3WPAEUOO.js";import"./chunk-O2HBPZW5.js";import"./chunk-EEBR5YP5.js";import"./chunk-X2W4IRXK.js";import"./chunk-3SLEIN6B.js";import"./chunk-OG5CKIPC.js";import"./chunk-D4JFMCXD.js";import"./chunk-CQ6PX2EU.js";import"./chunk-UZL5ZZ4E.js";import"./chunk-BU3TZP4Y.js";import"./chunk-REYWQVAH.js";import"./chunk-SUZR2SZZ.js";import"./chunk-USRNDVQ3.js";import"./chunk-WUYJFYOW.js";import"./chunk-4RYT6AQV.js";import"./chunk-RLS6PHBW.js";import"./chunk-LV5U7TI4.js";import"./chunk-EQ7G3UHS.js";import"./chunk-2FPPPJE5.js";import"./chunk-46LRF7PH.js";import"./chunk-P5C3UASK.js";import{spawn as b}from"child_process";import{existsSync as u,mkdirSync as D,writeFileSync as f,unlinkSync as _}from"fs";import{tmpdir as I}from"os";import{dirname as P,resolve as i,join as $}from"path";function M(){try{let e=import.meta.resolve("sootsim/detox");return P(e.startsWith("file://")?e.slice(7):e)}catch{return i(import.meta.dirname,"..","..","detox")}}var E=`
3
3
  sootsim detox \u2014 run detox-style tests against a sootsim shell
4
4
 
5
5
  usage:
@@ -1,5 +1,5 @@
1
- /*! sootsim v0.0.1 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import"./chunk-A2CZQIWO.js";import"./chunk-KSACMDXK.js";import"./chunk-KQWZZ56P.js";import{f as c,g as r,h as g}from"./chunk-YCETS3B3.js";import{b as d,d as l,g as a}from"./chunk-MPSZ5EWF.js";import"./chunk-3C3ZH7PP.js";import"./chunk-X2U72K7X.js";import"./chunk-E522F5JW.js";function h(){console.log(`
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import"./chunk-3WPAEUOO.js";import"./chunk-OG5CKIPC.js";import"./chunk-D4JFMCXD.js";import{f as c,g as r,h as g}from"./chunk-CQ6PX2EU.js";import{c as d,e as l,h as a}from"./chunk-4RYT6AQV.js";import"./chunk-RLS6PHBW.js";import"./chunk-LV5U7TI4.js";import"./chunk-EQ7G3UHS.js";import"./chunk-P5C3UASK.js";function h(){console.log(`
3
3
  sootsim device \u2014 inspect or change the live device preset for a session
4
4
 
5
5
  usage:
@@ -0,0 +1,2 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import"./chunk-CPMW2QLM.js";import{a,b,c,d,e,f,g,h,i}from"./chunk-2FPPPJE5.js";import"./chunk-46LRF7PH.js";import"./chunk-P5C3UASK.js";export{e as ALL_DRIVERS,i as buildDriverListRows,a as chromiumDriver,b as electronDriver,f as getAllDrivers,g as getDriver,c as playwrightDriver,h as resolveDriver,d as systemDriver};
@@ -0,0 +1,15 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{a as m}from"./chunk-VI3VW5BL.js";import"./chunk-CPMW2QLM.js";import{a as u,d as a}from"./chunk-BU3TZP4Y.js";import"./chunk-REYWQVAH.js";import"./chunk-SUZR2SZZ.js";import"./chunk-USRNDVQ3.js";import"./chunk-WUYJFYOW.js";import"./chunk-4RYT6AQV.js";import"./chunk-RLS6PHBW.js";import"./chunk-LV5U7TI4.js";import"./chunk-EQ7G3UHS.js";import{b as d,g as p}from"./chunk-2FPPPJE5.js";import{a as l}from"./chunk-46LRF7PH.js";import"./chunk-P5C3UASK.js";function g(e){let n=e.indexOf("--port");if(n<0)return;let r=e[n+1],i=r?Number(r):Number.NaN;return(!Number.isInteger(i)||i<=0)&&(console.error(` invalid --port value: ${r||"(missing)"}`),process.exit(1)),i}async function h(e,n){let r=g(e)??n.port;return r?a(String(r)):void 0}async function P(e,n){(e.includes("--help")||e.includes("-h"))&&(console.log(`
3
+ sootsim electron \u2014 launch the desktop companion
4
+
5
+ usage:
6
+ sootsim electron [options]
7
+
8
+ options:
9
+ --port <number> connect to running dev server on this port
10
+ --driver <id> override the launch driver (default: electron)
11
+
12
+ examples:
13
+ sootsim electron
14
+ sootsim electron --port 5173
15
+ `),process.exit(0));let r=e.indexOf("--driver"),t=(r>=0?e[r+1]:void 0)||n.driver,s=d;if(t){let o=p(t);o||(console.error(` unknown driver "${t}" \u2014 run \`sootsim list --drivers\``),process.exit(1)),s=o}if(s.id==="electron"){let o=l();if(!o){if(u(),process.stdin.isTTY&&process.env.CI!=="1"&&process.env.SOOTSIM_NO_PROMPT!=="1"&&await m("run sootsim install-desktop now?",!0)){console.log();let{runInstallDesktop:v}=await import("./install-desktop-SC3LNFFF.js");await v(["--yes"]),o=l()}o||process.exit(1)}console.log(` launching ${o.path}`)}let f=await h(e,n),c=await s.launch({url:f,device:n.device});c.launched||(console.error(` ${c.message}`),process.exit(1)),console.log(` ${c.message}`)}export{h as resolveElectronLaunchUrl,P as runElectron};
@@ -0,0 +1,2 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{a,b,c,d}from"./chunk-XJBPH4JR.js";import"./chunk-5IPP4HAW.js";import"./chunk-BYLX2DO4.js";import"./chunk-3K6VDPVD.js";import"./chunk-3WPAEUOO.js";import"./chunk-O2HBPZW5.js";import"./chunk-EEBR5YP5.js";import"./chunk-X2W4IRXK.js";import"./chunk-3SLEIN6B.js";import"./chunk-OG5CKIPC.js";import"./chunk-D4JFMCXD.js";import"./chunk-CQ6PX2EU.js";import"./chunk-UZL5ZZ4E.js";import"./chunk-BU3TZP4Y.js";import"./chunk-REYWQVAH.js";import"./chunk-SUZR2SZZ.js";import"./chunk-USRNDVQ3.js";import"./chunk-WUYJFYOW.js";import"./chunk-4RYT6AQV.js";import"./chunk-RLS6PHBW.js";import"./chunk-LV5U7TI4.js";import"./chunk-EQ7G3UHS.js";import"./chunk-2FPPPJE5.js";import"./chunk-46LRF7PH.js";import"./chunk-P5C3UASK.js";export{b as discoverSootsimUrl,a as parseFlowFile,d as runFlow,c as runFlowPlayback};
@@ -1,2 +1,2 @@
1
- /*! sootsim v0.0.1 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
- import{b as t,c as r,d as l}from"./chunk-GPVPHE2B.js";import"./chunk-3C3ZH7PP.js";import"./chunk-E522F5JW.js";function a(n){let s=n[0]??"list";if(s==="reset"){n[1]==="global"?(r(),console.log(" cleared global hint state")):(t(),console.log(" cleared hint state for this session"));return}if(s==="list"){let e=l();if(!e.length){console.log(" no hints registered");return}let i=Math.max(...e.map(o=>o.id.length));console.log(" registered hints:");for(let o of e){let c=typeof o.frequency=="string"?o.frequency:`cooldown ${o.frequency.cooldownMs}ms`;console.log(` ${o.id.padEnd(i)} ${c}`)}console.log(""),console.log(" env overrides:"),console.log(" SOOTSIM_HINTS=off suppress all hints"),console.log(" SOOTSIM_HINTS=always show every hint every time");return}console.error(` unknown subcommand: ${s}`),console.error(" usage:"),console.error(" sootsim hints list show registered hints"),console.error(" sootsim hints reset [global] clear shown-state"),process.exit(1)}export{a as runHints};
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{b as t,c as r,d as l}from"./chunk-H3JVJXOC.js";import"./chunk-RLS6PHBW.js";import"./chunk-P5C3UASK.js";function a(n){let s=n[0]??"list";if(s==="reset"){n[1]==="global"?(r(),console.log(" cleared global hint state")):(t(),console.log(" cleared hint state for this session"));return}if(s==="list"){let e=l();if(!e.length){console.log(" no hints registered");return}let i=Math.max(...e.map(o=>o.id.length));console.log(" registered hints:");for(let o of e){let c=typeof o.frequency=="string"?o.frequency:`cooldown ${o.frequency.cooldownMs}ms`;console.log(` ${o.id.padEnd(i)} ${c}`)}console.log(""),console.log(" env overrides:"),console.log(" SOOTSIM_HINTS=off suppress all hints"),console.log(" SOOTSIM_HINTS=always show every hint every time");return}console.error(` unknown subcommand: ${s}`),console.error(" usage:"),console.error(" sootsim hints list show registered hints"),console.error(" sootsim hints reset [global] clear shown-state"),process.exit(1)}export{a as runHints};
@@ -0,0 +1,2 @@
1
+ /*! sootsim v0.0.3 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
2
+ import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y}from"./chunk-EQ7G3UHS.js";import"./chunk-P5C3UASK.js";export{b as ACTIVE_RUNTIME_FILE,d as CONFIG_FILE,e as DAEMON_HEARTBEAT_STALE_MS,c as DAEMON_LOCKFILE,a as SOOTSIM_HOME_ENV,t as activeRuntimeDir,i as activeRuntimeFile,l as cacheDir,x as claimDaemonLockfile,s as compareSemver,n as configFilePath,m as daemonLockfilePath,j as electronDir,k as electronVersionDir,o as ensureSootsimHome,v as isDaemonLockfileFresh,r as listInstalledRuntimes,p as readActiveRuntime,u as readDaemonLockfile,y as removeDaemonLockfile,h as runtimeDir,g as runtimesDir,f as sootsimHomeDir,q as writeActiveRuntime,w as writeDaemonLockfile};