sootsim 0.1.149 → 0.1.150

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

@@ -1,386 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as je}from"./chunk-PXDREKKK.js";import{a as Be}from"./chunk-QFNCCWKQ.js";import{a as Le}from"./chunk-BYL2ZXSO.js";import{a as U,b as Ee,c as ie,d as ne,e as Me,f as oe,h as se,i as Ie,j as Pe}from"./chunk-FCLKD5U3.js";import{g as Ce,n as Oe,p as De,t as Ne}from"./chunk-WKSDGVRG.js";import{e as _e}from"./chunk-NCTGR5CW.js";import{m as ke}from"./chunk-MQ4ES4QV.js";import{m as xe,n as Te,o as $e,p as Fe}from"./chunk-UKIYBW22.js";import{c as te,d as re,e as Se}from"./chunk-K6DR7C5H.js";import{a as Ae}from"./chunk-JDEZIU6A.js";import{a as Re}from"./chunk-WMMLJ7UY.js";import{d as ee,e as ve}from"./chunk-Q6KGWTG3.js";import{a as ye,b as Q}from"./chunk-KQW5FXIA.js";import{g as be}from"./chunk-YHLH2UZO.js";import*as _ from"fs";import{tmpdir as Ke}from"os";import*as y from"path";import*as b from"fs";import*as g from"path";import{spawnSync as rt}from"child_process";import*as A from"vm";var it=3e5,nt=`
-let input = '';
-process.stdin.on('data', (c) => { input += c });
-process.stdin.on('end', async () => {
-  try {
-    const req = JSON.parse(input);
-    const res = await fetch(req.url, {
-      method: req.method,
-      headers: req.headers,
-      body: req.body === undefined || req.body === null ? undefined : req.body,
-    });
-    const body = await res.text();
-    const headers = {};
-    for (const [k, v] of res.headers.entries()) {
-      headers[k] = headers[k] ? headers[k] + ',' + v : v;
-    }
-    process.stdout.write(JSON.stringify({ ok: res.ok, status: res.status, body, headers }));
-  } catch (err) {
-    process.stdout.write(JSON.stringify({ __error: (err && err.message) || String(err) }));
-    process.exitCode = 1;
-  }
-});
-`;function D(n,e,t){if(t?.multipartForm)throw new Error("http: multipartForm is not supported by sootsim yet");let r={...process.env};for(let a of Object.keys(r))(a.startsWith("BUN_INSPECT")||a==="NODE_OPTIONS")&&delete r[a];let i=rt(process.execPath,["-e",nt],{input:JSON.stringify({url:n,method:e,headers:t?.headers,body:t?.body}),encoding:"utf8",timeout:it,maxBuffer:64*1024*1024,env:r});if(i.error)throw new Error(`http ${e} ${n} failed: ${i.error.message}`);let o;try{o=JSON.parse(i.stdout||"")}catch{throw new Error(`http ${e} ${n} failed: no response (${(i.stderr||"").trim().slice(0,200)})`)}let s=o;if(s.__error)throw new Error(`http ${e} ${n} failed: ${s.__error}`);return s}var ot=/(?<!\\)\$\{([^$]*)\}/g,st=/\\(\$\{[^$]*\})/g,at=/^[A-Za-z_$][A-Za-z0-9_$]*$/,J=class{context;envBinding=new Map;envScopeStack=[];syncedEnvKeys=new Set;output={};maestro;constructor(e={}){this.maestro={copiedText:null,platform:e.platform??"ios"};let t=e.onLog??(i=>console.log(`[flow]   js: ${i}`)),r={output:this.output,maestro:this.maestro,http:{get:(i,o)=>D(i,"GET",o),post:(i,o)=>D(i,"POST",o),put:(i,o)=>D(i,"PUT",o),delete:(i,o)=>D(i,"DELETE",o),request:(i,o)=>D(i,(o?.method??"GET").toUpperCase(),o)},console:{log:(...i)=>t(i.map(o=>typeof o=="string"?o:Ve(o)).join(" "))}};this.context=A.createContext(r),A.runInContext(`
-      globalThis.__maestroScope = new Proxy(globalThis, {
-        has() { return true },
-        get(target, key) { return target[key] },
-      })
-      function json(text) { return JSON.parse(text) }
-      function relativePoint(x, y) {
-        var xPercent = Math.ceil(x * 100) + '%'
-        var yPercent = Math.ceil(y * 100) + '%'
-        return xPercent + ',' + yPercent
-      }
-      `,this.context);for(let[i,o]of Object.entries(process.env))o!==void 0&&this.envBinding.set(i,o)}putEnv(e,t){this.envBinding.set(e,t)}setCopiedText(e){this.maestro.copiedText=e}enterEnvScope(){this.envScopeStack.push(new Map(this.envBinding))}leaveEnvScope(){let e=this.envScopeStack.pop();if(e){this.envBinding.clear();for(let[t,r]of e)this.envBinding.set(t,r)}}evaluate(e,t={}){let r=t.env;if(r&&Object.keys(r).length>0){this.enterEnvScope();try{for(let[i,o]of Object.entries(r))this.envBinding.set(i,o);return this.evalRaw(e)}finally{this.leaveEnvScope()}}return this.evalRaw(e)}evalRaw(e){this.syncEnvToContext();let t=e.replace(/\\/g,"\\\\").replace(/`/g,"\\`").replace(/\$\{/g,"\\${");return A.runInContext(`(function(){ with(__maestroScope){ return eval(\`${t}\`) } })()`,this.context)}syncEnvToContext(){let e=A.runInContext("globalThis",this.context);for(let t of this.syncedEnvKeys)this.envBinding.has(t)||delete e[t];this.syncedEnvKeys=new Set;for(let[t,r]of this.envBinding)try{e[t]=r,this.syncedEnvKeys.add(t)}catch{}}evaluateStringTemplate(e){return e.replace(ot,(r,i)=>{if(i.trim().length===0)return"";let o=this.evaluate(i);if(o===void 0&&at.test(i.trim()))throw new Error(`missing variable for flow placeholder: ${i.trim()}`);return Ve(o)}).replace(st,(r,i)=>i)}interpolateStep(e){return this.interpolateValue(e,null)}interpolateValue(e,t){return typeof e=="string"?t==="evalScript"?e:this.evaluateStringTemplate(e):Array.isArray(e)?t==="commands"||t==="onFlowStart"||t==="onFlowComplete"?e:e.map(r=>this.interpolateValue(r,t)):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([r,i])=>[r,this.interpolateValue(i,r)])):e}};function Ve(n){if(n===void 0)return"undefined";if(n===null)return"null";if(typeof n=="object")try{return JSON.stringify(n)}catch{return String(n)}return String(n)}function We(n){if(n==null)return!1;if(typeof n=="boolean")return n;let e=String(n);if(e.trim().length===0||e.toLowerCase()==="false"||e==="undefined"||e==="null")return!1;let t=Number(e);return!(!Number.isNaN(t)&&t===0)}var K=1e4,H=393,N=852,Ue="__sootsimCliPerf";function f(n){return new Promise(e=>setTimeout(e,n))}function lt(n){return n?g.basename(n)===".maestro"?g.dirname(n):n:process.cwd()}function ct(n,e,t){let r=e.endsWith(".png")?e:`${e}.png`;if(g.isAbsolute(r))return r;if(t.mode==="flow"&&/[\\/]/.test(r)){let i=r.startsWith("./")||r.startsWith("../")?t.flowDir??process.cwd():lt(t.flowDir);return g.resolve(i,r)}return g.join(n,r)}function dt(n){if(typeof n=="string")return{path:n,withFrame:!1};let e=n.path?.trim()||n.name?.trim();if(!e)throw new Error("takeScreenshot object form requires path or name");return{path:e,withFrame:n.withFrame===!0,layers:n.layers}}function ae(n){let[e,t]=n.split(",").map(i=>i.trim()),r=(i,o)=>i.endsWith("%")?Number.parseFloat(i)/100*o:Number.parseFloat(i);return{x:r(e,H),y:r(t,N)}}function ut(n){switch(n){case"back":return{back:!0};case"hideKeyboard":return{hideKeyboard:!0};case"waitForAnimationToEnd":return{waitForAnimationToEnd:!0};case"stopApp":return{stopApp:!0};case"clearState":return{clearState:!0};case"clearKeychain":return{clearKeychain:!0};case"eraseText":return{eraseText:50};case"scroll":case"scrollDown":return{scroll:{direction:"DOWN"}};case"scrollUp":return{scroll:{direction:"UP"}};default:return{[n]:!0}}}function mt(n){let e=n.split(/^---$/m),t=e.length>1?e[e.length-1]:n,r=Ee.parse(t);return Array.isArray(r)?r:[]}var q=class{constructor(e,t){this.bridge=e;this.opts=t}stepDelay=0;js=new J({platform:"ios",onLog:e=>console.log(`[flow]   js: ${e}`)});firstLaunchDone=!1;profilingEnabled=!1;recordingEnabled=!1;recordingAccessChecked=!1;recordingStartedAtMs=null;lastRecordingDurationMs=null;simRouteHint=null;lastFailedStep=null;get simId(){return this.opts.simId}setSimRouteHint(e){this.simRouteHint=this.normalizeSimRoute(e)}normalizeSimRoute(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 refreshSimId(){if(this.opts.simId)try{let e=await this.bridge.listSims(),t=e.find(l=>l.id===this.opts.simId);if(t&&(this.simRouteHint=this.normalizeSimRoute(t.url||t.origin)),e.find(l=>l.id===this.opts.simId&&l.readyState==="open")||!this.simRouteHint)return;let i=this.simRouteHint&&e.find(l=>l.readyState==="open"&&this.normalizeSimRoute(l.url||l.origin)===this.simRouteHint);if(!i)return;let o=e.find(l=>l.isPrimary&&l.readyState==="open"),s=e.find(l=>l.readyState==="open"),a=i??o??s;a&&(this.opts.simId=a.id,console.log(`  [flow] sim rotated to ${a.id}`))}catch{}}async evaluate(e,t){return this.bridge.send({type:"evaluate",simId:this.opts.simId,code:e},t?{timeoutMs:t}:void 0)}async callTest(e,...t){return this.bridge.send({type:"call",simId:this.opts.simId,path:`__sootsimTest.${e}`,args:t})}async waitForTree(e=K){let t=Date.now()+e,r=Date.now(),i=null,o=0,s=0,a=-1,l=r;for(;Date.now()<t;){try{let c=await this.evaluate(xe,8e3);if(o=0,c?.externalError)throw new Error(`app failed to load: ${c.externalError}`);if(c){let h=Date.now();c.nodes!==a&&(a=c.nodes,l=h);let I=c.flag===!0&&$e(c),w=c.flag!==!0&&Fe(c);if((I||w)&&c.externalReady!==!1&&!c.externalError&&!c.loadingText&&h-l>=Te)return}}catch(c){if(i=c instanceof Error?c:new Error(String(c)),i.message.startsWith("app failed to load:"))throw i;if(o++,o>=4)throw new Error(`target sim is not responding to the bridge (${i.message}). it is likely a stale orphan \u2014 run \`sootsim list\`, then close it with \`sootsim close <id>\` or start a fresh one with \`sootsim open --new <port>\`.`);await this.refreshSimId()}let m=Date.now()-r;m-s>=5e3&&(s=m,console.log(`  [flow] waiting for app to be ready\u2026 (${Math.round(m/1e3)}s)`)),await f(500)}throw i?.message.startsWith("app failed to load:")?i: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,allowGitHubAuth:this.opts.allowGitHubRecording}),this.recordingAccessChecked=!0);let e=Date.now(),t=await this.evaluate(`(() => {
-      const rec = window.__sootsimRecorder
-      if (!rec) return { ok: false, error: 'recorder unavailable on this page' }
-      const format = ${JSON.stringify(this.opts.recordingFormat??"webm")}
-      if (rec.state() === 'recording') return { ok: true, format }
-      return rec.start({ format, fps: 24 })
-    })()`);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=[],i=0;for(;;){let l=await this.evaluate(`window.__sootsimRecorder.getBlobBase64({ offset: ${i}, chunk: 2097152 })`);if(!l||(r.push(Buffer.from(l.data,"base64")),i=l.offset,l.done))break}if(r.length===0)throw new Error("recording requested but no video buffer was produced");b.mkdirSync(this.opts.recordingOutputDir,{recursive:!0});let s=(t.mime||this.opts.recordingFormat||"video/webm").includes("mp4")?"mp4":"webm",a=g.join(this.opts.recordingOutputDir,`sootsim-${Date.now()}.${s}`);return b.writeFileSync(a,Buffer.concat(r)),a}async waitForRecordingTail(e){if(!this.recordingEnabled)return;let t=Math.max(0,Math.round(e.maxMs));if(t<=0)return;if(!e.smart){await f(t);return}let r=await Pe({bridge:this.bridge,simId:this.opts.simId,maxMs:t,pollMs:80,stablePolls:6,strict:!0});await this.waitForVisualSettle(),console.log(r.settled?`  [flow] recording tail settled in ${r.elapsed}ms`:`  [flow] recording tail reached ${r.elapsed}ms budget`)}async findElement(e){return this.evaluate(`(async () => {
-      const test = window.__sootsimTest
-      if (!test) return null
-      let node = null
-      if (${JSON.stringify(!!e.text)}) node = await test.findByText(${JSON.stringify(e.text||"")})
-      if (!node && ${JSON.stringify(!!e.id)}) {
-        node = (await test.findByTestId(${JSON.stringify(e.id||"")})) || (await test.findById(${JSON.stringify(e.id||"")}))
-      }
-      if (!node || !node.absolutePosition || !node.layout) return null
-      return {
-        nodeId: typeof node.nodeId === 'number' ? node.nodeId : null,
-        id: node.id || null,
-        testID: node.testID || null,
-        text: node.text || null,
-        absolutePosition: node.absolutePosition,
-        layout: node.layout,
-        isTextInput: !!node.isTextInput,
-      }
-    })()`)}async resolveTapTarget(e){return this.evaluate(`(async () => {
-      const test = window.__sootsimTest
-      if (!test?.resolveTapTarget) return null
-      return await test.resolveTapTarget(${e})
-    })()`)}async activatePressTarget(e){let t=e.id?{id:e.id,testID:e.id,text:null}:{id:null,testID:null,text:e.text??null};return this.evaluate(`(async () => {
-      const test = window.__sootsimTest
-      if (!test) return null
-      const node = ${e.id?`(await test.findByTestId?.(${JSON.stringify(e.id)})) || (await test.findById?.(${JSON.stringify(e.id)}))`:`await test.findByText?.(${JSON.stringify(e.text||"")})`}
-      let point = null
-      if (node?.absolutePosition && node?.layout) {
-        point = {
-          x: node.absolutePosition.x + node.layout.width / 2,
-          y: node.absolutePosition.y + node.layout.height / 2,
-        }
-        if (typeof node.nodeId === 'number' && test.resolveTapTarget) {
-          const resolved = await test.resolveTapTarget(node.nodeId)
-          if (
-            resolved &&
-            Number.isFinite(resolved.cx) &&
-            Number.isFinite(resolved.cy)
-          ) {
-            point = { x: resolved.cx, y: resolved.cy }
-          }
-        }
-      }
-      ${e.id?`const direct = await test.activatePressById?.(${JSON.stringify(e.id)})`:`const direct = await test.activatePressByText?.(${JSON.stringify(e.text||"")})`}
-      if (direct?.ok && point) {
-        window.dispatchEvent(
-          new CustomEvent('sootsim:agentAction', {
-            detail: { type: 'tap', x: point.x, y: point.y, target: ${JSON.stringify(t)} },
-          }),
-        )
-      }
-      return direct || null
-    })()`)}async activatePressAt(e,t){return this.evaluate(`(async () => {
-      const test = window.__sootsimTest
-      if (!test?.activatePressAt) return null
-      const direct = await test.activatePressAt(${e}, ${t})
-      if (direct?.ok) {
-        window.dispatchEvent(
-          new CustomEvent('sootsim:agentAction', {
-            detail: { type: 'tap', x: ${e}, y: ${t} },
-          }),
-        )
-      }
-      return direct
-    })()`)}async tap(e,t,r){return await this.bridge.send({type:"tap",simId:this.opts.simId,x:e,y:t,target:r})}async tapOn(e){let t=typeof e=="string"?{text:e}:e;if(t.point){let l=ae(t.point);(await this.activatePressAt(l.x,l.y))?.ok||await this.tap(l.x,l.y),await f(300);return}let r=5e3,i=150,o=Date.now()+r,s=await this.findElement({text:t.text,id:t.id});for(;!s&&Date.now()<o;)await f(i),s=await this.findElement({text:t.text,id:t.id});if(s){let l=s.isTextInput?4:1;for(let m=0;m<l;m++){let c=m===0?s:await this.findElement({text:t.text,id:t.id});if(!c)break;let h=typeof c.nodeId=="number"?await this.resolveTapTarget(c.nodeId):null,I=h?.cx??c.absolutePosition.x+c.layout.width/2,w=h?.cy??c.absolutePosition.y+c.layout.height/2;if((await this.tap(I,w,{id:t.id??h?.target?.id??c.id??null,testID:t.id??h?.target?.testID??c.testID??null,text:t.text??h?.target?.text??h?.target?.accessibilityLabel??c.text??c.accessibilityLabel??null,type:h?.target?.type??c.type??null}))?.hit===!0){if(await f(300),!c.isTextInput||await this.waitForFocusedTextInput(600))return;continue}break}}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 i=Math.max(0,Math.round(r));if(!await this.evaluate(`(async () => {
-      const interact = window.__sootsimInteract
-      if (interact?.doubleTap) {
-        return !!(await interact.doubleTap(${e}, ${t}, ${i}))
-      }
-      if (!interact?.tap) return false
-      const first = await interact.tap(${e}, ${t})
-      if (!first || first.hit === false) return false
-      await new Promise((resolve) => setTimeout(resolve, ${i}))
-      const second = await interact.tap(${e}, ${t})
-      return !!second && second.hit !== false
-    })()`))throw new Error(`doubleTapAtCoords failed at (${e}, ${t})`);await f(300)}async assertVisible(e){let t=typeof e=="string"?{text:e}:e;for(let o=0;o<15;o++){if(await this.isElementVisible(t))return;await f(200)}let r=await this.findElement(t),i=r?` (matched node at y=${Math.round(r.absolutePosition.y)} h=${Math.round(r.layout.height)} \u2014 off-screen)`:" (no matching node in tree)";throw new Error(`assertVisible: ${JSON.stringify(t)} not visible${i}`)}async assertNotVisible(e){let t=typeof e=="string"?{text:e}:e;if(await this.isElementVisible(t)){let r=await this.findElement(t),i=r?` at (${Math.round(r.absolutePosition.x)},${Math.round(r.absolutePosition.y)})`:"";throw new Error(`assertNotVisible: ${JSON.stringify(t)} IS visible${i}`)}}async isElementVisible(e){let t=await this.findElement(e);return!!(t&&t.absolutePosition.y+t.layout.height>0&&t.absolutePosition.y<N)}async inputText(e){await this.waitForFocusedTextInput(),await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"type",text:e}),await f(200)}async waitForFocusedTextInput(e=1500){let t=Date.now()+e;for(;Date.now()<t;){try{if(await this.callTest("getFocusedNode"))return!0}catch{}await f(50)}return!1}async pressKey(e){await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"press",text:e}),await f(120)}async dispatchKey(e){await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"dispatchKey",text:e}),await f(120)}async hideKeyboard(){try{await this.callTest("blurFocusedTextInput")}catch{}await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"dismiss"});let e=Date.now()+3e3;for(;Date.now()<e;){let t=await this.evaluate(`(() => {
-        const keyboard =
-          window.__sootsimKeyboard ??
-          window.SootSim?.bridges?.keyboard ??
-          null
-        const test = window.__sootsimTest
-        return {
-          visible: !!keyboard?.isVisible?.(),
-          focused: !!test?.isTextInputFocused?.(),
-        }
-      })()`);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||K);for(;Date.now()<t;){if(await this.findElement(e))return;await f(200)}let r=await this.findElement(e),i=r?` (matched node y=${Math.round(r.absolutePosition.y)} \u2014 still off-screen at deadline)`:"";throw new Error(`waitFor: ${JSON.stringify(e)} not found after ${e.timeout||K}ms${i}`)}async takeScreenshot(e){try{await this.waitForVisualSettle()}catch{}await f(250);let t=dt(e),r=ct(this.opts.screenshotDir,t.path,{mode:this.opts.screenshotPathMode??"dir",flowDir:this.opts.flowDir});b.mkdirSync(g.dirname(r),{recursive:!0});let i=t.layers??this.opts.screenshotLayers,o={type:"screenshot",simId:this.opts.simId};i&&i!=="full"&&(o.layers=i);let a=(await this.bridge.send(o)).replace(/^data:image\/png;base64,/,""),l=Buffer.from(a,"base64");if(t.withFrame){let m=await this.readCurrentDeviceModel();if(!m)throw new Error("could not read current device model for framed screenshot");let c=await je(l,m);b.writeFileSync(r,c),console.log(`[flow] screenshot: ${r} (frame: ${m})`);return}b.writeFileSync(r,l),console.log(`[flow] screenshot: ${r}`)}async readCurrentDeviceModel(){let e=await this.bridge.send({type:"call",simId:this.opts.simId,path:"SootSim.bridges.settings.get",args:[]}),t=e&&typeof e.deviceModel=="string"?e.deviceModel:null;return!t||!(t in be)?null:t}async captureFailureScreenshot(e){b.mkdirSync(g.dirname(e),{recursive:!0});let r=(await this.bridge.send({type:"screenshot",simId:this.opts.simId})).replace(/^data:image\/png;base64,/,"");b.writeFileSync(e,Buffer.from(r,"base64"))}async captureFailureBundle(e,t){b.mkdirSync(e,{recursive:!0});let r=(c,h)=>{try{b.writeFileSync(g.join(e,c),h)}catch{}},i=async c=>{try{return await this.bridge.send({type:"evaluate",simId:this.opts.simId,code:c})}catch{return null}},o=await i(`(async () => {
-      const out = {
-        simId: window.__sootsimBridge?.id ?? window.SootSim?.state?.simId ?? null,
-        url: location.href,
-        title: document.title,
-        hidden: document.hidden,
-      }
-      try {
-        const params = new URL(location.href).searchParams
-        const bundle = params.get('bundle')
-        if (bundle) {
-          const baseMatch = bundle.match(/^https?:\\/\\/[^/]+/)
-          if (baseMatch) {
-            const res = await fetch(baseMatch[0] + '/', {
-              headers: { 'expo-platform': 'ios' },
-              cache: 'no-store',
-            })
-            if (res.ok) {
-              out.manifest = await res.json().catch(() => null)
-            }
-          }
-        }
-      } catch {}
-      return out
-    })()`);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(),sim:o??null},null,2));try{let h=(await this.bridge.send({type:"screenshot",simId:this.opts.simId})).replace(/^data:image\/png;base64,/,"");r("screenshot.png",Buffer.from(h,"base64"))}catch{}let s=await i(`(async () => {
-      const t = window.__sootsimTest
-      const mainShell = window.SootSim?.bridges?.mainShell
-      if (!t) return { error: 'no test bridge' }
-      let shell = null
-      try {
-        shell = typeof mainShell?.getState === 'function' ? await mainShell.getState() : null
-      } catch {}
-      const all = await t.queryAll({ pruneHidden: true })
-      return { shell, nodes: all, url: location.href, title: document.title }
-    })()`);s&&r("describe.json",JSON.stringify(s,null,2));let a=await i("(async () => await window.__sootsimTest?.dumpAccessibilityTree?.(20))()");typeof a=="string"&&r("a11y.txt",a);let l=await i("(async () => await window.__sootsimTest?.dumpTree?.(15))()");typeof l=="string"&&r("tree.txt",l);let m=await i(`(() => {
-      const c = window.__sootsimConsole
-      return {
-        errors: c?.getErrors?.() ?? [],
-        warnings: c?.getWarnings?.() ?? [],
-        requests: (window.__sootsimGetFailedRequests?.() ?? []),
-      }
-    })()`);return m&&r("console.json",JSON.stringify(m,null,2)),e}async swipe(e="UP",t=300){let r=H/2,i=N/2,o=200,s=r,a=i,l=r,m=i;switch(e.toUpperCase()){case"UP":a+=o,m-=o;break;case"DOWN":a-=o,m+=o;break;case"LEFT":s+=o,l-=o;break;case"RIGHT":s-=o,l+=o;break}let c=Math.max(10,Math.round(t/16));await this.drag(s,a,l,m,c,16)}async drag(e,t,r,i,o=12,s=16){if(!(await this.evaluate(`(async () => {
-      const interact = window.__sootsimInteract
-      if (!interact?.drag) return { ok: false }
-      const value = await interact.drag(${e}, ${t}, ${r}, ${i}, ${Math.max(1,Math.round(o))}, ${Math.max(0,Math.round(s))})
-      return { ok: !!value, value }
-    })()`))?.ok)throw new Error("drag failed");await f(300)}async swipeCoords(e,t,r=300){let i=ae(e),o=ae(t),s=Math.max(10,Math.round(r/16));await this.drag(i.x,i.y,o.x,o.y,s,16)}async swipeFrom(e,t="UP",r=300){let i=await this.findElement(e);if(!i)throw new Error(`swipeFrom: element not found: ${JSON.stringify(e)}`);let o=i.absolutePosition.x+i.layout.width/2,s=i.absolutePosition.y+i.layout.height/2,a=180,l=o,m=s;switch(t.toUpperCase()){case"UP":m-=a;break;case"DOWN":m+=a;break;case"LEFT":l-=a;break;case"RIGHT":l+=a;break}let c=Math.max(10,Math.round(r/16));await this.drag(o,s,l,m,c,16)}async scrollTo(e,t,r){let i=await this.callTest("scrollTo",e,t,r,!1);if(!i?.ok)throw new Error(`scrollTo failed: ${i?.reason||"unknown error"}`);await f(250)}async pinch(e){let t=await this.evaluate(`(async () => {
-      const interact = window.__sootsimInteract
-      if (!interact?.pinch) return { ok: false, reason: 'no interact.pinch' }
-      const ok = await interact.pinch(
-        ${e.from[0]}, ${e.from[1]}, ${e.from[2]}, ${e.from[3]},
-        ${e.to[0]}, ${e.to[1]}, ${e.to[2]}, ${e.to[3]},
-        ${e.steps||12}, ${e.stepMs||16}
-      )
-      return { ok: !!ok, reason: ok ? null : 'pinch returned false' }
-    })()`);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",simId:this.opts.simId,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",i=r==="DOWN"?"UP":r==="UP"?"DOWN":r;for(;Date.now()<t;){let o=await this.findElement({text:e.element});if(o&&o.absolutePosition.y>=0&&o.absolutePosition.y+o.layout.height>0&&o.absolutePosition.y<N-50){if(e.centerElement){let s=N/2,a=o.absolutePosition.y-s;if(Math.abs(a)>100){let l=Math.min(150,Math.abs(a)*.5),m=a>0?s-l:s+l;await this.drag(H/2,s,H/2,m,10,16)}}return}await this.swipe(i,250),await f(500)}throw new Error(`scrollUntilVisible: "${e.element}" not found`)}async extendedWaitUntil(e){let t=Date.now()+(e.timeout||K);for(;Date.now()<t;){let r=e.visible?await this.isElementVisible(typeof e.visible=="string"?{text:e.visible}:e.visible):!0,i=e.notVisible?!await this.isElementVisible(typeof e.notVisible=="string"?{text:e.notVisible}:e.notVisible):!0;if(r&&i)return;await f(200)}throw new Error("extendedWaitUntil timed out")}async launchApp(e){await this.refreshSimId(),e&&typeof e=="object"&&e.arguments&&console.log("[flow]   launchApp.arguments ignored (sootsim has no native process)");let t=!!(e&&typeof e=="object"&&e.clearState);if(t&&await this.evaluate(U,6e4),!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.refreshSimId(),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) => {
-        requestAnimationFrame(() => {
-          requestAnimationFrame(() => {
-            requestAnimationFrame(() => {
-              setTimeout(resolve, 180)
-            })
-          })
-        })
-      })`)}catch{await f(180)}}async startProfile(){await this.evaluate(`((sessionKey) => {
-      const perf = window.__sootsimPerf
-      const a11y = window.__sootsimA11y
-      perf?.enableFrameStats?.(true)
-      perf?.resetFrameStats?.()
-      a11y?.resetProfile?.()
-      window[sessionKey] = {
-        active: true,
-        mode: window.__sootsimRenderHost ? 'render-worker' : 'main-thread',
-        lastSamples: [],
-        startedAt: performance.now(),
-      }
-    })(${JSON.stringify(Ue)})`),this.profilingEnabled=!0}async stopProfile(){let e=await this.evaluate(`(async (sessionKey) => {
-      const host = window.__sootsimRenderHost
-      if (host?.flushSamples) {
-        const perf = window.__sootsimPerf
-        const session = window[sessionKey] || {}
-        const priorSamples = session.active && Array.isArray(session.lastSamples)
-          ? session.lastSamples
-          : []
-        const flushedSamples = await host.flushSamples()
-        await perf?.disableFrameStats?.()
-        const samples = priorSamples.concat(flushedSamples)
-        window[sessionKey] = {
-          ...session,
-          active: false,
-          mode: 'render-worker',
-          lastSamples: samples,
-          stoppedAt: performance.now(),
-        }
-
-        const frameTimes = samples.map((sample) => Number(sample?.[1]) || 0)
-        const sorted = [...frameTimes].sort((a, b) => a - b)
-        const worstFrames = samples
-          .slice()
-          .sort((a, b) => (Number(b?.[1]) || 0) - (Number(a?.[1]) || 0))
-          .slice(0, 10)
-          .map((sample) => [
-            Number(sample?.[0]) || 0,
-            Number(sample?.[1]) || 0,
-            Number(sample?.[2]) || 0,
-            Number(sample?.[3]) || 0,
-            Number(sample?.[4]) || 0,
-          ])
-
-        return {
-          mode: 'render-worker',
-          frames: frameTimes.length,
-          totalMs: frameTimes.reduce((sum, value) => sum + value, 0),
-          avgMs: frameTimes.length ? frameTimes.reduce((sum, value) => sum + value, 0) / frameTimes.length : 0,
-          maxMs: sorted[sorted.length - 1] || 0,
-          layoutTotalMs: samples.reduce((sum, sample) => sum + (Number(sample?.[2]) || 0), 0),
-          renderTotalMs: samples.reduce((sum, sample) => sum + (Number(sample?.[3]) || 0), 0),
-          copyTotalMs: samples.reduce((sum, sample) => sum + (Number(sample?.[4]) || 0), 0),
-          layoutAvgMs: frameTimes.length ? samples.reduce((sum, sample) => sum + (Number(sample?.[2]) || 0), 0) / frameTimes.length : 0,
-          renderAvgMs: frameTimes.length ? samples.reduce((sum, sample) => sum + (Number(sample?.[3]) || 0), 0) / frameTimes.length : 0,
-          copyAvgMs: frameTimes.length ? samples.reduce((sum, sample) => sum + (Number(sample?.[4]) || 0), 0) / frameTimes.length : 0,
-          p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
-          p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
-          p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
-          jankFrames: frameTimes.filter((value) => value > 16.67).length,
-          sampleCount: frameTimes.length,
-          worstFrames,
-        }
-      }
-
-      const perf = window.__sootsimPerf
-      const a11y = window.__sootsimA11y
-      if (!perf && !a11y) return { error: 'no perf globals available' }
-
-      const stoppedStats = await perf?.disableFrameStats?.()
-      const frameStats = stoppedStats || await perf?.getFrameStats?.() || {}
-      const profile = a11y?.profile?.() || {}
-      const recent = Array.isArray(frameStats.recentFrames) ? frameStats.recentFrames : []
-      const sorted = [...recent].sort((a, b) => a - b)
-
-      return {
-        mode: 'main-thread',
-        frames: frameStats.frames || profile.syncCount || 0,
-        totalMs: frameStats.totalMs || 0,
-        avgMs: frameStats.totalMs && frameStats.frames ? frameStats.totalMs / frameStats.frames : profile.avgSyncMs || 0,
-        maxMs: frameStats.maxMs || profile.maxSyncMs || 0,
-        layoutTotalMs: frameStats.layoutTotalMs || 0,
-        p50: sorted[Math.floor(sorted.length * 0.5)] || 0,
-        p95: sorted[Math.floor(sorted.length * 0.95)] || 0,
-        p99: sorted[Math.floor(sorted.length * 0.99)] || 0,
-        jankFrames: recent.filter((value) => value > 16.67).length,
-        sampleCount: recent.length,
-        worstFrames: recent.slice().sort((a, b) => b - a).slice(0, 10),
-      }
-    })(${JSON.stringify(Ue)})`);if(this.profilingEnabled=!1,e?.error)throw new Error(e.error);return e}async stopApp(){await this.evaluate(`(async () => {
-      try { await (${U}) } catch {}
-      try {
-        const regs = await navigator.serviceWorker?.getRegistrations?.()
-        await Promise.all((regs || []).map((reg) => reg.unregister()))
-      } catch {}
-    })()`)}async clearState(){await this.evaluate(`(async () => {
-      await (${U})
-    })()`)}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 i=r.text??r.testID??"";this.js.setCopiedText(i),this.js.putEnv("maestroCopiedText",i),console.log(`[flow]   copied text: ${JSON.stringify(i)}`)}evalScript(e){let r=/(?<!\\)\$\{[^$]*\}/.test(e)?this.js.evaluateStringTemplate(e):this.js.evaluate(e);r!==void 0&&r!==""&&console.log("[flow]   evalScript ->",r)}runScript(e){let t=typeof e=="string"?{file:e}:e;if(!t.file)throw new Error("runScript requires a file");let r=g.resolve(this.opts.flowDir,t.file),i=b.readFileSync(r,"utf8");this.js.evaluate(i,{env:t.env}),console.log(`[flow]   runScript: ${t.file} done`)}async openLink(e){let t=typeof e=="string"?e:e.link;if(!t)throw new Error("openLink: missing link");let r=await this.callTest("openDeepLink",t);if(!r?.ok)throw new Error(`openLink failed: ${r?.error||"no test bridge"}`);await f(300)}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()===this.js.maestro.platform.toLowerCase():e.true!==void 0?We(e.true):!0}isOptional(e){if(e.optional===!0)return!0;let r=Object.entries(e).find(([o])=>o!=="when"&&o!=="optional"),i=r?r[1]:void 0;return!!(i&&typeof i=="object"&&"optional"in i&&i.optional)}async runStep(e,t){let r=typeof e=="string"?ut(e):e,i=Object.keys(r).find(s=>s!=="when")||Object.keys(r)[0];console.log(`[flow] step ${t+1}: ${i}`);let o;try{o=this.js.interpolateStep(r)}catch(s){if(this.isOptional(r)){console.log(`[flow]   (optional, skipped: ${s.message.slice(0,80)})`);return}throw this.lastFailedStep={index:t,kind:i,target:r[i]},s}if(o.when&&!await this.evaluateWhen(o.when)){console.log("[flow]   (when: predicate false, skipped)");return}try{let s=!!(o.extendedWaitUntil||o.waitFor||o.scrollUntilVisible||o.launchApp||o.runFlow||o.runScript),a=1e4,l=this.runStepInner(o);if(s)await l;else{let c=null,h=new Promise((I,w)=>{c=setTimeout(()=>{w(new Error(`step watchdog: ${i} made no progress in ${a}ms \u2014 bridge or bundle probably hung`))},a)});try{await Promise.race([l,h])}finally{c&&clearTimeout(c)}}let m=!!(o.assertVisible||o.assertNotVisible||o.extendedWaitUntil||o.waitFor);this.stepDelay>0&&!m&&await f(this.stepDelay)}catch(s){if(this.isOptional(o)){console.log(`[flow]   (optional, skipped: ${s.message.slice(0,80)})`);return}throw this.lastFailedStep={index:t,kind:i,target:o[i]},s}}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){let t=typeof e.scrollTo.nodeId=="number"?{nodeId:e.scrollTo.nodeId}:e.scrollTo.id;if(!t)throw new Error("scrollTo requires id or nodeId");await this.scrollTo(t,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&&Array.isArray(e.repeat.commands)){let t=e.repeat.times,r=t==null||t===""?Number.MAX_SAFE_INTEGER:Number(t);if(!Number.isFinite(r))throw new Error(`repeat.times is not a number: ${t}`);let i=e.repeat.when??e.repeat.condition,o=async()=>i?this.evaluateWhen(i):!0,s=i?r:Math.min(r,1e3),a=0;for(;a<s&&await o();){for(let l=0;l<e.repeat.commands.length;l++)await this.runStep(e.repeat.commands[l],l);a++}}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")this.evalScript(e.evalScript);else if(e.runScript){let t=e.runScript,r=typeof t=="string"?void 0:t.when;if(r&&!await this.evaluateWhen(r)){console.log("[flow]   runScript skipped (when predicate false)");return}this.runScript(t)}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,i=typeof t=="string"?void 0:t.commands,o=typeof t=="string"?void 0:t.env,s=typeof t=="string"?void 0:t.when;if(s&&!await this.evaluateWhen(s)){console.log(`[flow] runFlow skipped (when predicate false): ${r??"inline commands"}`);return}if(!r&&!i)throw new Error("runFlow requires either file or commands");this.js.enterEnvScope();try{if(o)for(let[a,l]of Object.entries(o))this.js.putEnv(a,l);if(r){let a=g.resolve(this.opts.flowDir,r),l=b.readFileSync(a,"utf8"),m=this.opts.flowDir;this.opts.flowDir=g.dirname(a);try{await this.runFlow(mt(l))}finally{this.opts.flowDir=m}}else if(i)for(let a=0;a<i.length;a++)await this.runStep(i[a],a)}finally{this.js.leaveEnvScope()}}else throw new Error(`unsupported flow step: ${JSON.stringify(e)}`)}async runFlow(e){let t=[],r=[],i=[];for(let s of e){let a=Object.keys(s);if(a.length===1&&a[0]==="onFlowStart"&&Array.isArray(s.onFlowStart)){t.push(...s.onFlowStart);continue}if(a.length===1&&a[0]==="onFlowComplete"&&Array.isArray(s.onFlowComplete)){r.push(...s.onFlowComplete);continue}i.push(s)}if(t.length>0){console.log(`[flow] onFlowStart (${t.length} steps)`);for(let s=0;s<t.length;s++)await this.runStep(t[s],s)}let o=null;try{await this.runFlowBody(i)}catch(s){o=s instanceof Error?s:new Error(String(s))}if(r.length>0){console.log(`[flow] onFlowComplete (${r.length} steps)`);for(let s=0;s<r.length;s++)try{await this.runStep(r[s],s)}catch(a){console.warn(`[flow]   onFlowComplete step ${s+1} failed: ${a instanceof Error?a.message:a}`)}}if(o)throw o}async runFlowBody(e){for(let t=0;t<e.length;t++){let r=e[t],i=typeof r.wait=="number"?r.wait:0,o=typeof r.waitFor?.timeout=="number"?r.waitFor.timeout:0,s=Math.max(6e4,i+15e3,o+15e3);if(r.runFlow||r.launchApp){await this.runStep(r,t);continue}await Promise.race([this.runStep(r,t),new Promise((a,l)=>setTimeout(()=>l(new Error(`step ${t+1} (${Object.keys(r)[0]}) exceeded ${s}ms deadline`)),s))])}}};async function pt(n){if(!n)return"";let e=n.trim();if(!e)return"";if(/^\d+$/.test(e)||e.startsWith("http://")||e.startsWith("https://"))return e;let r=(await Ae()).find(i=>i.name.toLowerCase()===e.toLowerCase());return r?String(r.preferredPort):e}async function ft(){let n=await _e(),e=n.find(r=>r.patched);if(e)return`http://localhost:${e.port}/__soot/`;let t=n[0];return t?`http://localhost:${t.port}/__soot/`:null}async function He(n){(n.length===0||n.includes("--help")||n.includes("-h"))&&(console.log(`
-sootsim flow \u2014 run flows or manage a draft
-
-usage:
-  sootsim flow <flow.yaml> [options]
-  sootsim flow start
-  sootsim flow keep
-  sootsim flow end [--output <path>] [--validate] [--video]
-  sootsim flow validate <path>
-
-options:
-  --record             record a webm artifact while the flow runs
-  --profile            capture perf stats while the flow runs
-  --out <dir>          output directory (default: /tmp/sootsim-recordings)
-  --device <model>     override the flow frontmatter device for this run
-  --slow <ms>          delay between steps for natural pacing
-  --tail-wait <ms>     hold the recording open after the last step so the
-                       final UI state is captured (default: smart idle up to
-                       6000ms for --preview, fixed 2000ms for --record, 0 otherwise)
-  --url <url>          load this target before running the flow
-  --screenshot-paths <mode>
-                       screenshot path mode: dir (default) or flow
-  --no-shell           capture every screenshot tenant-only (no status bar,
-                       keyboard, notification center, or other shell overlays).
-                       use for clean demo asset sets. per-step \`layers:\`
-                       still wins over this default.
-  --shell-only         inverse \u2014 capture shell chrome only
-  --replace <m>=<f>    replace a Metro module with a local file for this run
-  --new                open a fresh sim before running the flow
-  --driver <id>        when paired with --new, launch through a specific
-                       driver from the registry (e.g. playwright for
-                       hermetic CI runs); see 'sootsim list --drivers'
-  --headless           pass headless=true to the launch driver (useful
-                       with --driver playwright)
-  --headed             force a fresh, VISIBLE window for this run (implies
-                       --new; overrides --headless). use when you want to
-                       watch the flow run live even if the current sim is
-                       headless or stale
-  --electron           prefer opening the target in the desktop companion
-  --sim <id>           target a specific current sim
-  --validate           replay the drafted flow before clearing it
-  --video              replay and record the drafted flow before clearing it
-  --preview            record events+video, upload, and print /preview/<id>
-  --preview-open       open the uploaded preview link after a successful run
-  --preview-origin <url>
-                       upload target for --preview (default: auto)
-  --preview-public-origin <url>
-                       public link origin for --preview (default: sootsim.com
-                       for prod uploads)
-  --owner <org>        associate preview upload with a linked org repo
-  --repo <repo>        repo name for --owner; user must belong to the team
-
-frontmatter (top of flow.yaml between --- markers):
-  app: 8081            load this target before the flow starts
-  device: iphone-14    set the live device model for this flow run
-  electron: true       prefer the desktop companion sim for this flow
-
-default runtime:
-  bridge-backed flow playback against the current sim
-  if no current sim exists, flow opens the discovered target first
-  recording and profiling both run on the same bridge-backed path
-
-examples:
-  sootsim flow login.yaml
-  sootsim flow demo.yaml --url 8081 --record --slow 500 --out ./recordings
-  sootsim flow demo.yaml --sim a2
-  sootsim flow start
-  sootsim flow keep
-  sootsim flow end --output ./flows/draft.yaml
-  sootsim flow end --output ./flows/draft.yaml --validate
-  sootsim flow end --output ./flows/draft.yaml --video
-  sootsim flow validate ./flows/draft.yaml
-
-flow extension:
-  takeScreenshot: hero
-  takeScreenshot:
-    path: marketing/hero
-    withFrame: true
-`),process.exit(0));let e=n[0];_.existsSync(e)||(console.error(`  error: ${e} not found`),process.exit(1));let t=p=>n.find((u,v)=>n[v-1]===p),r=n.includes("--profile"),i=n.includes("--headed"),o=n.includes("--new")||i,s=t("--out")||"/tmp/sootsim-recordings",a=t("--screenshots")||(t("--out")?s:"/tmp/sootsim-flow"),l=t("--screenshot-paths")==="flow"?"flow":"dir",m=n.includes("--no-shell")?"tenant":n.includes("--shell-only")?"shell":void 0,c=t("--device")?.trim()||"",h=n.includes("--slow")?+(t("--slow")||"500"):0,I=n.includes("--electron"),w=n.includes("--preview"),R=await Le(t("--preview-origin")),le=t("--preview-public-origin"),qe=n.includes("--preview-open"),ce=t("--owner")?.trim()||"",de=t("--repo")?.trim()||"",ze=n.flatMap((p,u)=>n[u-1]==="--replace"?["--replace",p]:[]),Ge=n.flatMap((p,u)=>n[u-1]==="--remap"?["--remap",p]:[]),$=n.includes("--record")||w,Ye=n.includes("--tail-wait")?Math.max(0,+(t("--tail-wait")||"2000")):$?w?6e3:2e3:0,Xe=_.readFileSync(e,"utf8"),{frontmatter:x,steps:E}=ie(Xe);E.length===0&&(console.error("  error: flow file must contain a YAML array of steps"),process.exit(1));let C=c||x.device||"",j=I||x.electron===!0,Ze=x.app===void 0||x.app===null?"":typeof x.app=="number"?String(x.app):x.app,z=await pt(Ze),ue={stripBooleanFlags:["--record","--profile","--electron","--new","--preview","--preview-open","--headless","--headed"],stripValueFlags:["--out","--device","--slow","--tail-wait","--url","--replace","--remap","--screenshots","--screenshot-paths","--preview-origin","--preview-public-origin","--driver"]},S=te(n,ue),Qe=t("--url")||"";j&&!Re()&&(console.error("  error: desktop companion not found. install or build it first with `bun run build:electron`"),process.exit(1));let me=j?"desktop companion":"bridge",et=z?` | target: ${z}`:"";console.log(`
-  sootsim flow \u2014 ${y.basename(e)}
-  ${E.length} steps | ${me}${et}${$?" | recording":""}${r?" | profiling":""}${h?` | ${h}ms delay`:""}
-`),w&&ye({event:"preview_flow_started",properties:{flowName:y.basename(e),stepCount:E.length,mode:me,electron:j,record:$,profile:r,previewOrigin:R}});let F=Qe||z||"",G=o||j&&S.simIdSource!=="flag",pe=t("--driver")||"",Y=!1,X=new Set,fe=!1;if(!F&&!G&&S.simIdSource==="none"){let p=Se(S);try{let u=await p.listSims(),v=u.find(W=>W.isPrimary&&W.readyState==="open"),V=u.find(W=>W.readyState==="open"),ge=v??V;ge&&(fe=!0,console.log(`  reusing active sim: ${ge.id}`))}catch{}finally{p.close()}}if(!F&&!fe&&(G||S.simIdSource==="none")){let p=await ft();p||(console.error("  error: no current sim and no sootsim target found"),await Q(),process.exit(1)),F=p}if(F&&C){let p=new URL(await Ce(F));p.searchParams.set("device",C),F=p.toString()}if(F){let p=[F];if(p.push(...ze),p.push(...Ge),G&&p.push("--new"),S.simIdSource==="flag"&&S.simId&&p.push("--sim",S.simId),pe&&(p.push("--driver",pe),Y=!0),n.includes("--headless")&&!i&&p.push("--headless"),await De(p,{port:S.wsPort,timeoutMs:S.commandTimeoutMs}),Y){let u=ee();u&&X.add(u)}}let P=te(n,ue),L=P.simIdSource==="flag"?P.simId:ee()||P.simId,tt=P.simIdSource==="flag"?"flag":L?"saved":"none",k=re(P.wsPort,{commandTimeoutMs:P.commandTimeoutMs,simId:L,simIdSource:tt}),d,he=async()=>{if(!C)return!1;let p=await k.send({type:"evaluate",simId:d.simId,code:"window.location.href"});if(typeof p=="string"&&p.length>0){let u=new URL(p);u.searchParams.set("device",C),d.setSimRouteHint(u.toString())}return!!await k.send({type:"call",simId:d.simId,path:"SootSim.bridges.settings.set",args:["deviceModel",C]})};if(d=new q(k,{screenshotDir:a,flowDir:y.dirname(y.resolve(e)),screenshotPathMode:l,screenshotLayers:m,simId:L,recordingOutputDir:$?s:void 0,recordingFormat:w?"mp4":"webm",billingOriginOverride:w?R:void 0,allowGitHubRecording:$,onAfterLaunch:async()=>{await he()&&await d.waitForTree(12e4),w&&await k.send({type:"evaluate",simId:d.simId,code:`(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
-          return r?.start?.() ?? false
-        })()`})}}),h&&(d.stepDelay=h),d.js.putEnv("MAESTRO_FILENAME",y.basename(e,y.extname(e))),x.env&&typeof x.env=="object")for(let[p,u]of Object.entries(x.env))d.js.putEnv(p,u);let M=null,T=null,O=null,Z=null,B=0,we=!!E[0]?.launchApp;try{await d.waitForTree(12e4),await he()&&await d.waitForTree(12e4),w&&!we&&!process.env.SOOTSIM_PREVIEW_RESET_DONE&&await d.launchApp({clearState:!0}),$&&(we?d.prepareRecording():await d.startRecording()),r&&await d.startProfile(),w&&(await k.send({type:"evaluate",simId:d.simId,code:`(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
-          return r?.start?.() ?? false
-        })()`})||console.warn("  warn: eventRecorder.start() returned false \u2014 preview will upload bundle without replay events")),await d.runFlow(E),r&&(M=await d.stopProfile()),await d.waitForRecordingTail({maxMs:Ye,smart:w}),$&&(T=await d.stopRecording(),O=d.getLastRecordingDurationMs()),w&&(Z=await k.send({type:"evaluate",simId:d.simId,code:`(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
-          return r?.stop?.() ?? []
-        })()`}),console.log(`  captured ${Z.length} replay events`));let u=E.filter(v=>"takeScreenshot"in v).length;console.log(`
-  + completed (${E.length} steps)`),u>0&&console.log(`  screenshots: ${u} \u2192 ${a}`),M&&Je(M),T&&console.log(`  video: ${T}`),console.log()}catch(p){if(r&&!M)try{M=await d.stopProfile()}catch{}if($&&!T)try{T=await d.stopRecording(),O=d.getLastRecordingDurationMs()}catch(u){console.warn(`  recording stop failed: ${u?.message||String(u)}`)}console.error(`
-  x failed: ${p.message}
-`),M&&(console.log("  partial profile:"),Je(M)),T&&console.log(`  partial video: ${T}`);try{let u=d.lastFailedStep,v=u?`step-${String(u.index+1).padStart(2,"0")}-${u.kind}`:"unstaged",V=y.join(a,v);await d.captureFailureBundle(V,{error:p,stepIndex:u?.index,stepKind:u?.kind,stepTarget:u?.target}),console.log(`  failure bundle: ${V}`),console.log("    (contents: screenshot.png, describe.json, a11y.txt, tree.txt, console.json, error.json)")}catch(u){try{let v=y.join(a,"error.png");await d.captureFailureScreenshot(v),console.log(`  error screenshot: ${v}`)}catch{}console.log(`  (failure bundle capture failed: ${u instanceof Error?u.message:String(u)})`)}await ke(k,{errorsCommand:`sootsim get errors 5${d.simId?` --sim ${d.simId}`:""}`,warningsCommand:`sootsim get warnings 5${d.simId?` --sim ${d.simId}`:""}`,requestsCommand:`sootsim get requests 5${d.simId?` --sim ${d.simId}`:""}`}),B=1}finally{k.close()}if(B===0&&w)try{let p=await wt(Z??[]),u=["--origin",R,"--events",p];le&&u.push("--public-origin",le),T&&u.push("--video",T),T&&O&&Number.isFinite(O)&&u.push("--video-duration-ms",String(Math.round(O))),d.simId&&u.push("--sim",d.simId),qe&&u.push("--open"),ce&&u.push("--owner",ce),de&&u.push("--repo",de),console.log(`
-  preparing preview upload\u2026`);let{runUpload:v}=await import("./upload-ITKMHX55.js");await v(u,{})}catch(p){console.error(`  preview upload failed: ${p?.message||p}`),B=1}return Y?(d.simId&&X.add(d.simId),await ht(S.wsPort,S.commandTimeoutMs,[...X])):d.simId&&d.simId!==L&&ve(d.simId),await Q(),B}async function ht(n,e,t){let r=[...new Set(t.filter(Boolean))];if(r.length===0)return;let i=re(n,{commandTimeoutMs:e});try{let o=await i.listSims(),s=r.filter(l=>o.some(m=>m.id===l&&m.readyState==="open"));if(s.length===0)return;let a=await Ne(i,n,e,s);await Oe(o,s),a.closed.length>0&&console.log(`  closed flow sim(s): ${a.closed.join(", ")}`),a.remaining.length>0&&console.warn(`  warn: flow sim(s) still connected after close: ${a.remaining.join(", ")}`)}catch(o){console.warn(`  warn: failed to close flow sim(s): ${o instanceof Error?o.message:String(o)}`)}finally{i.close()}}async function wt(n){let{gzipSync:e}=await import("zlib"),t=n.map(o=>JSON.stringify(o)).join(`
-`)+(n.length?`
-`:""),r=e(Buffer.from(t,"utf8")),i=y.join(Ke(),`sootsim-events-${Date.now()}.jsonl.gz`);return _.writeFileSync(i,r),console.log(`  events: ${n.length} written to ${i} (${r.length} bytes gz)`),i}async function gt(n){let e=n[0],t=r=>n.find((i,o)=>n[o-1]===r);switch(e){case"start":{let{path:r,state:i}=Me();console.log("  flow draft started"),console.log(`  session: ${r}`),console.log(`  steps: ${i.steps.length}`);return}case"keep":case"good":{let r=se();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")||(n[1]&&!n[1].startsWith("-")?n[1]:void 0),i=n.includes("--validate")||n.includes("--video"),o=n.includes("--video"),s=se();s.active&&s.kept&&console.log(`  auto-kept trailing action: ${s.candidate.summary}`);let a=Ie(r||(i?bt():void 0));if(a.active||(console.error("  no active flow draft \u2014 run `sootsim flow start` first"),process.exit(1)),!a.valid){console.error("  flow draft is not valid:");for(let l of a.issues)console.error(`    - ${l}`);console.error("  draft preserved \u2014 keep at least one real interaction or run `sootsim flow start` to reset"),process.exit(1)}if(i){let l=vt(n,a.outputPath),m=await He(l);if(m!==0){console.error(`
-  validation failed \u2014 draft preserved so you can keep iterating`),process.exitCode=m;return}oe(),console.log(`  flow draft validated (${a.stepCount} step${a.stepCount===1?"":"s"})`),a.outputPath&&console.log(`  saved: ${a.outputPath}`),o&&console.log("  video: recorded during validation run");return}if(oe(),console.log(`  flow draft ended (${a.stepCount} step${a.stepCount===1?"":"s"})`),a.outputPath){console.log(`  saved: ${a.outputPath}`),console.log(`  next: sootsim flow ${a.outputPath} --record`);return}console.log(""),process.stdout.write(a.yaml);return}case"validate":{let r=n[1];(!r||r.startsWith("-"))&&(console.error("  usage: sootsim flow validate <path>"),process.exit(1));let i=ne(r);if(i.length>0){console.error(`  x ${r} failed validation:`);for(let o of i)console.error(`    - ${o}`);process.exit(1)}console.log(`  + ${r} looks valid`);return}}}function yt(n){return n[0]==="--sim"&&n.length>=2?[...n.slice(2),"--sim",n[1]]:n}async function Kt(n){let e=yt(n),t=e[0];if(t==="start"||t==="keep"||t==="good"||t==="end"||t==="validate")return await gt(e),0;let r=await He(e);return r!==0&&(process.exitCode=r),r}function Je(n){let e=n.avgMs>0?(1e3/n.avgMs).toFixed(1):"?",t=n.sampleCount>0?(n.jankFrames/n.sampleCount*100).toFixed(1):"0";console.log(`
-  profile:`),console.log(`    frames:     ${n.frames}`),console.log(`    total:      ${n.totalMs.toFixed(1)}ms`),console.log(`    avg:        ${n.avgMs.toFixed(2)}ms (${e} fps)`),console.log(`    max:        ${n.maxMs.toFixed(2)}ms`),n.layoutAvgMs!==void 0&&console.log(`    breakdown:  layout ${n.layoutAvgMs.toFixed(2)}ms | render ${n.renderAvgMs?.toFixed(2)||"0.00"}ms | copy ${n.copyAvgMs?.toFixed(2)||"0.00"}ms`),console.log(`    p95:        ${n.p95.toFixed(2)}ms`),console.log(`    p99:        ${n.p99.toFixed(2)}ms`),console.log(`    jank:       ${n.jankFrames}/${n.sampleCount} (${t}%) >16.67ms`);let r=Array.isArray(n.worstFrames)?n.worstFrames:[];if(r.length!==0){if(console.log(`
-  worst frames:`),n.mode==="render-worker"){console.log("    total    layout   render   copy     t+");for(let i of r){let[o,s,a,l,m]=i;console.log(`    ${s.toFixed(2).padStart(7)}  ${a.toFixed(2).padStart(7)}  ${l.toFixed(2).padStart(7)}  ${m.toFixed(2).padStart(7)}  ${String(o).padStart(5)}`)}return}console.log(`    ${r.map(i=>i.toFixed(2)).join(", ")}`)}}function bt(){return y.join(Ke(),`sootsim-flow-draft-${Date.now()}.yaml`)}function vt(n,e){if(!e)throw new Error("validated flow draft requires an output path");let t=[e];for(let r=1;r<n.length;r++){let i=n[r];if(!(i==="--validate"||i==="--video")){if(i==="--output"){r+=1;continue}r===1&&!i.startsWith("-")||t.push(i)}}return!t.includes("--record")&&n.includes("--video")&&t.push("--record"),t}export{ft as a,He as b,yt as c,Kt as d};

package/dist-cli/chunks/cli-version-XNIRTBJN.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-GBWFT53N.js";import"./chunk-DVANCABF.js";export{a as getCliVersion};

package/dist-cli/chunks/drivers-ISZDFEMB.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import"./chunk-FE4WZMPN.js";import{a,b,c,d,e,f,g,h,i}from"./chunk-JMLOSEXB.js";import"./chunk-WMMLJ7UY.js";import"./chunk-WKJ5NKXN.js";import"./chunk-6HSKGTN3.js";import"./chunk-DEOS6HMP.js";import"./chunk-Q6KGWTG3.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.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};

package/dist-cli/chunks/flow-5WJLI3KM.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as c,b as d,c as e,d as f}from"./chunk-YCZB7NKY.js";import"./chunk-PXDREKKK.js";import"./chunk-ODLM2KEX.js";import"./chunk-QFNCCWKQ.js";import"./chunk-BYL2ZXSO.js";import"./chunk-Q3MVIFGA.js";import{c as a,d as b}from"./chunk-FCLKD5U3.js";import"./chunk-WKSDGVRG.js";import"./chunk-NCTGR5CW.js";import"./chunk-MQ4ES4QV.js";import"./chunk-UKIYBW22.js";import"./chunk-LEUPCPVX.js";import"./chunk-K6DR7C5H.js";import"./chunk-JDEZIU6A.js";import"./chunk-JMLOSEXB.js";import"./chunk-WMMLJ7UY.js";import"./chunk-WKJ5NKXN.js";import"./chunk-6HSKGTN3.js";import"./chunk-DEOS6HMP.js";import"./chunk-Q6KGWTG3.js";import"./chunk-KQW5FXIA.js";import"./chunk-Y3BXVPQA.js";import"./chunk-MPJTH4SZ.js";import"./chunk-UM2U5JQE.js";import"./chunk-L4SMKJAF.js";import"./chunk-UO5XXQ53.js";import"./chunk-YHLH2UZO.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.js";export{c as discoverSootsimUrl,e as hoistLeadingSimFlag,a as parseFlowFile,f as runFlow,d as runFlowPlayback,b as validateFlowFile};

package/dist-cli/chunks/help-25RH7GSX.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-FFPNLA27.js";import"./chunk-MPJTH4SZ.js";import"./chunk-UGMBWU7M.js";import"./chunk-UM2U5JQE.js";import"./chunk-L4SMKJAF.js";import"./chunk-GBWFT53N.js";import"./chunk-ZU3Y3JSR.js";import"./chunk-YHLH2UZO.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.js";export{c as printCommandHelp,b as printGroupHelp,a as printHelp};

package/dist-cli/chunks/install-LBOWGAGG.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as o}from"./chunk-Q6QBFWIS.js";import"./chunk-SOGORN62.js";import"./chunk-DYSZWMKF.js";import"./chunk-K6DR7C5H.js";import"./chunk-Q6KGWTG3.js";import"./chunk-KQW5FXIA.js";import"./chunk-Y3BXVPQA.js";import"./chunk-L4SMKJAF.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.js";async function t(n){console.error("  note: `sootsim install` is now `sootsim setup-repo`. forwarding\u2026\n"),await o(n)}export{t as runInstall};

package/dist-cli/chunks/optional-demo-registry-RIDIENLK.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b}from"./chunk-JDEZIU6A.js";import"./chunk-DVANCABF.js";export{a as loadOptionalDemoApps,b as optionalDemoAppsSync};

package/dist-cli/chunks/runtime-TJT4YSOY.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b}from"./chunk-NHWVFX3R.js";import"./chunk-K6DR7C5H.js";import"./chunk-Q6KGWTG3.js";import"./chunk-L4SMKJAF.js";import"./chunk-AEKDLIFW.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.js";export{b as formatReleaseEntry,a as runRuntime};

package/dist-cli/chunks/setup-repo-UQXTC4PO.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-Q6QBFWIS.js";import"./chunk-SOGORN62.js";import"./chunk-DYSZWMKF.js";import"./chunk-K6DR7C5H.js";import"./chunk-Q6KGWTG3.js";import"./chunk-KQW5FXIA.js";import"./chunk-Y3BXVPQA.js";import"./chunk-L4SMKJAF.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.js";export{a as runSetupRepo};

package/dist-cli/chunks/store-BKCI7NRB.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-UO5XXQ53.js";import"./chunk-YHLH2UZO.js";import"./chunk-DVANCABF.js";export{a as settingsStore};

package/dist-cli/chunks/telemetry-H4J7ZTQF.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b}from"./chunk-KQW5FXIA.js";import"./chunk-Y3BXVPQA.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.js";export{b as flushCliTelemetry,a as trackCliEvent};

package/dist-cli/chunks/upload-ITKMHX55.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.149 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-BYL2ZXSO.js";import"./chunk-Q3MVIFGA.js";import"./chunk-LEUPCPVX.js";import"./chunk-K6DR7C5H.js";import"./chunk-6HSKGTN3.js";import"./chunk-DEOS6HMP.js";import"./chunk-Q6KGWTG3.js";import"./chunk-KQW5FXIA.js";import"./chunk-Y3BXVPQA.js";import"./chunk-L4SMKJAF.js";import"./chunk-CGBHDP72.js";import"./chunk-DVANCABF.js";export{a as resolveDefaultUploadOrigin,b as resolvePublicPreviewOrigin,c as runUpload};