sootsim 0.1.185 → 0.1.186

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

@@ -1,463 +0,0 @@
-/*! sootsim v0.1.185 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as We}from"./chunk-2T73IGB2.js";import{a as Ue}from"./chunk-QQ4NSPAD.js";import{a as Je}from"./chunk-ARNLQPMQ.js";import{a as oe,b as je,c as se,d as ae,e as Le,f as le,h as de,i as Ve,j as ce}from"./chunk-XU5EMZ4B.js";import{h as De,p as Ne,s as Ce,w as Be}from"./chunk-OAHGYDJR.js";import{f as ke}from"./chunk-V5JEPE3P.js";import{h as Oe,m as Re}from"./chunk-FHJTTB3W.js";import{I as ne,m as Fe,n as Ee,o as Ae,p as Me}from"./chunk-FY6DJGOS.js";import{a as $e}from"./chunk-K2THZIVC.js";import{c as re,d as ie,e as Pe}from"./chunk-7OAUPGLN.js";import{a as _e}from"./chunk-BMCBPMTC.js";import{a as xe,b as ee}from"./chunk-C63EVPDN.js";import{d as te,e as Ie}from"./chunk-E5DE33BU.js";import{g as Te}from"./chunk-FUHXL6BW.js";import*as R from"fs";import{tmpdir as ze}from"os";import*as b from"path";import*as v from"fs";import*as g from"path";import{spawnSync as st}from"child_process";import*as P from"vm";var at=3e5,lt=`
-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 C(i,e,t){if(t?.multipartForm)throw new Error("http: multipartForm is not supported by sootsim yet");let n={...process.env};for(let a of Object.keys(n))(a.startsWith("BUN_INSPECT")||a==="NODE_OPTIONS")&&delete n[a];let r=st(process.execPath,["-e",lt],{input:JSON.stringify({url:i,method:e,headers:t?.headers,body:t?.body}),encoding:"utf8",timeout:at,maxBuffer:64*1024*1024,env:n});if(r.error)throw new Error(`http ${e} ${i} failed: ${r.error.message}`);let o;try{o=JSON.parse(r.stdout||"")}catch{throw new Error(`http ${e} ${i} failed: no response (${(r.stderr||"").trim().slice(0,200)})`)}let s=o;if(s.__error)throw new Error(`http ${e} ${i} failed: ${s.__error}`);return s}var dt=/(?<!\\)\$\{([^$]*)\}/g,ct=/\\(\$\{[^$]*\})/g,ut=/^[A-Za-z_$][A-Za-z0-9_$]*$/,H=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??(r=>console.log(`[flow]   js: ${r}`)),n={output:this.output,maestro:this.maestro,http:{get:(r,o)=>C(r,"GET",o),post:(r,o)=>C(r,"POST",o),put:(r,o)=>C(r,"PUT",o),delete:(r,o)=>C(r,"DELETE",o),request:(r,o)=>C(r,(o?.method??"GET").toUpperCase(),o)},console:{log:(...r)=>t(r.map(o=>typeof o=="string"?o:He(o)).join(" "))}};this.context=P.createContext(n),P.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[r,o]of Object.entries(process.env))o!==void 0&&this.envBinding.set(r,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,n]of e)this.envBinding.set(t,n)}}evaluate(e,t={}){let n=t.env;if(n&&Object.keys(n).length>0){this.enterEnvScope();try{for(let[r,o]of Object.entries(n))this.envBinding.set(r,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 P.runInContext(`(function(){ with(__maestroScope){ return eval(\`${t}\`) } })()`,this.context)}syncEnvToContext(){let e=P.runInContext("globalThis",this.context);for(let t of this.syncedEnvKeys)this.envBinding.has(t)||delete e[t];this.syncedEnvKeys=new Set;for(let[t,n]of this.envBinding)try{e[t]=n,this.syncedEnvKeys.add(t)}catch{}}evaluateStringTemplate(e){return e.replace(dt,(n,r)=>{if(r.trim().length===0)return"";let o=this.evaluate(r);if(o===void 0&&ut.test(r.trim()))throw new Error(`missing variable for flow placeholder: ${r.trim()}`);return He(o)}).replace(ct,(n,r)=>r)}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(n=>this.interpolateValue(n,t)):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([n,r])=>[n,this.interpolateValue(r,n)])):e}};function He(i){if(i===void 0)return"undefined";if(i===null)return"null";if(typeof i=="object")try{return JSON.stringify(i)}catch{return String(i)}return String(i)}function Ke(i){if(i==null)return!1;if(typeof i=="boolean")return i;let e=String(i);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,q=393,O=852,qe="__sootsimCliPerf";function m(i){return new Promise(e=>setTimeout(e,i))}function fe(i){return!!(i&&typeof i=="object"&&!Array.isArray(i))}function B(i,e){if(!fe(i))return null;let t=i[e];return typeof t=="string"&&t.length>0?t:null}function ft(i,e){return fe(i)?i[e]===!0:!1}function pt(i){if(!i)return null;let e=i.recentApps;if(Array.isArray(e))for(let n of e){let r=B(n,"id");if(r)return r}let t=i.surfaceBindings;return B(t,"app:one")||B(t,"app:two")||null}function mt(i){return i?g.basename(i)===".maestro"?g.dirname(i):i:process.cwd()}function ht(i,e,t){let n=e.endsWith(".png")?e:`${e}.png`;if(g.isAbsolute(n))return n;if(t.mode==="flow"&&/[\\/]/.test(n)){let r=n.startsWith("./")||n.startsWith("../")?t.flowDir??process.cwd():mt(t.flowDir);return g.resolve(r,n)}return g.join(i,n)}function wt(i){if(typeof i=="string")return{path:i,withFrame:!1};let e=i.path?.trim()||i.name?.trim();if(!e)throw new Error("takeScreenshot object form requires path or name");return{path:e,withFrame:i.withFrame===!0,layers:i.layers}}function ue(i){let[e,t]=i.split(",").map(r=>r.trim()),n=(r,o)=>r.endsWith("%")?Number.parseFloat(r)/100*o:Number.parseFloat(r);return{x:n(e,q),y:n(t,O)}}function gt(i){switch(i){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{[i]:!0}}}function yt(i){let e=i.split(/^---$/m),t=e.length>1?e[e.length-1]:i,n=je.parse(t);return Array.isArray(n)?n:[]}var G=class{constructor(e,t){this.bridge=e;this.opts=t}stepDelay=0;js=new H({platform:"ios",onLog:e=>console.log(`[flow]   js: ${e}`)});firstLaunchDone=!1;profilingEnabled=!1;recordingEnabled=!1;recordingAccessChecked=!1;recordingStartedAtMs=null;lastRecordingDurationMs=null;lastVisualSettledAtMs=0;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 n=t.searchParams.toString();return`${t.origin}${t.pathname}${n?`?${n}`:""}`}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 r=this.simRouteHint&&e.find(l=>l.readyState==="open"&&this.normalizeSimRoute(l.url||l.origin)===this.simRouteHint);if(!r)return;let o=e.find(l=>l.isPrimary&&l.readyState==="open"),s=e.find(l=>l.readyState==="open"),a=r??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,n=Date.now(),r=null,o=0,s=0,a=-1,l=n;for(;Date.now()<t;){try{let d=await this.evaluate(Fe,8e3);if(o=0,d?.externalError)throw new Error(`app failed to load: ${d.externalError}`);if(d){let h=Date.now();d.nodes!==a&&(a=d.nodes,l=h);let A=d.flag===!0&&Ae(d),w=d.flag!==!0&&Me(d);if((A||w)&&d.externalReady!==!1&&!d.externalError&&!d.loadingText&&h-l>=Ee)return}}catch(d){if(r=d instanceof Error?d:new Error(String(d)),r.message.startsWith("app failed to load:"))throw r;if(o++,o>=4)throw new Error(`target sim is not responding to the bridge (${r.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 f=Date.now()-n;f-s>=5e3&&(s=f,console.log(`  [flow] waiting for app to be ready\u2026 (${Math.round(f/1e3)}s)`)),await m(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 Ue("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 n=[],r=0;for(;;){let l=await this.evaluate(`window.__sootsimRecorder.getBlobBase64({ offset: ${r}, chunk: 2097152 })`);if(!l||(n.push(Buffer.from(l.data,"base64")),r=l.offset,l.done))break}if(n.length===0)throw new Error("recording requested but no video buffer was produced");v.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 v.writeFileSync(a,Buffer.concat(n)),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 m(t);return}let n=await ce({bridge:this.bridge,simId:this.opts.simId,maxMs:t,pollMs:80,stablePolls:6,strict:!0});await this.waitForVisualSettle(),console.log(n.settled?`  [flow] recording tail settled in ${n.elapsed}ms`:`  [flow] recording tail reached ${n.elapsed}ms budget`)}async findElement(e){if(e.childOf!=null||typeof e.index=="number")return this.findElementScoped(e);let t=!!e.text&&/[.*+?^$()[\]{}|\\]/.test(e.text);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||"")})
-        // maestro matches a text selector against the element's ACCESSIBILITY
-        // text too, not just rendered glyphs \u2014 icon-only buttons (e.g. bluesky's
-        // "Pin to Home" / "Mute accounts" pin/menu controls) carry the label on
-        // accessibilityLabel with no visible text node, so findByText misses
-        // them. fall back to an exact a11y-label match, mirroring the real
-        // driver. findByLabel resolves a node, but its info shape omits nodeId/
-        // isTextInput; re-resolve through findByTestId/findById when it exposes
-        // an id so tapOn still gets a resolveTapTarget-able nodeId.
-        if (!node) {
-          const labelled = await test.findByLabel?.(${JSON.stringify(e.text||"")})
-          if (labelled) {
-            const reId = labelled.testID || labelled.id
-            node =
-              (reId &&
-                ((await test.findByTestId?.(reId)) || (await test.findById?.(reId)))) ||
-              labelled
-          }
-        }
-        if (!node && ${JSON.stringify(t)} && test.queryAll) {
-          // regex selector fallback: match the pattern against each visible
-          // node's text; prefer the narrowest matching node so a tight <text>
-          // wins over a wide container that merely contains it.
-          let re = null
-          try { re = new RegExp(${JSON.stringify(e.text||"")}) } catch (e) { re = null }
-          if (re) {
-            const all = (await test.queryAll({ pruneHidden: true })) || []
-            const hits = all.filter(
-              (n) =>
-                n && n.absolutePosition && n.layout &&
-                typeof n.text === 'string' && re.test(n.text),
-            )
-            hits.sort((a, b) => (a.text || '').length - (b.text || '').length)
-            if (hits[0]) node = hits[0]
-          }
-        }
-      }
-      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 findElementScoped(e){let t=typeof e.index=="number"?e.index:0;return this.evaluate(`(async () => {
-      const test = window.__sootsimTest
-      if (!test || !test.queryAll) return null
-      // NOT pruneHidden: that over-filters (it dropped every postDropdownBtn in a
-      // feed and made index:0 resolve to nothing \u2014 worse than findByTestId). reach
-      // for the same set findByTestId sees, then PREFER on-screen ones below.
-      const filter = {}
-      if (${JSON.stringify(!!e.id)}) filter.hasId = ${JSON.stringify(e.id||"")}
-      if (${JSON.stringify(!!e.text)}) filter.hasText = ${JSON.stringify(e.text||"")}
-      let candidates = (await test.queryAll(filter)) || []
-      // a11y-label fallback (icon-only buttons) for text matchers, mirroring
-      // findElement's simple path.
-      if (${JSON.stringify(!!e.text)} && candidates.length === 0) {
-        const all = (await test.queryAll({})) || []
-        candidates = all.filter((n) => (n.accessibilityLabel || '') === ${JSON.stringify(e.text||"")})
-      }
-      candidates = candidates.filter((n) => n && n.absolutePosition && n.layout)
-      // prefer on-screen matches (findByTestId's visible-first behavior); only
-      // fall back to off-screen ones when nothing is on-screen, so index: still
-      // resolves a target that needs scrolling into view.
-      const onScreen = candidates.filter((n) => {
-        const cy = n.absolutePosition.y + n.layout.height / 2
-        return cy > 0 && cy < ${O}
-      })
-      if (onScreen.length > 0) candidates = onScreen
-      ${e.childOf?`
-      const container = ${e.childOf.id?`(await test.findByTestId(${JSON.stringify(e.childOf.id)})) || (await test.findById(${JSON.stringify(e.childOf.id)}))`:`await test.findByText(${JSON.stringify(e.childOf.text||"")})`}
-      if (!container || !container.absolutePosition || !container.layout) return null
-      const x0 = container.absolutePosition.x
-      const y0 = container.absolutePosition.y
-      const x1 = x0 + container.layout.width
-      const y1 = y0 + container.layout.height
-      candidates = candidates.filter((n) => {
-        const cx = n.absolutePosition.x + n.layout.width / 2
-        const cy = n.absolutePosition.y + n.layout.height / 2
-        return cx >= x0 && cx <= x1 && cy >= y0 && cy <= y1
-      })`:""}
-      const node = candidates[${t}]
-      if (!node) 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,n){return await this.bridge.send({type:"tap",simId:this.opts.simId,x:e,y:t,target:n})}async tapOn(e){let t=typeof e=="string"?{text:e}:e;if(t.point){let l=ue(t.point);(await this.activatePressAt(l.x,l.y))?.ok||await this.tap(l.x,l.y),await m(300);return}let n=5e3,r=150,o=Date.now()+n,s=await this.findElement({text:t.text,id:t.id});for(;!s&&Date.now()<o;)await m(r),s=await this.findElement({text:t.text,id:t.id});if(s){let l=s.isTextInput?4:1;for(let f=0;f<l;f++){let d=f===0?s:await this.findElement({text:t.text,id:t.id});if(!d)break;let h=typeof d.nodeId=="number"?await this.resolveTapTarget(d.nodeId):null,A=h?.cx??d.absolutePosition.x+d.layout.width/2,w=h?.cy??d.absolutePosition.y+d.layout.height/2;if((await this.tap(A,w,{id:t.id??h?.target?.id??d.id??null,testID:t.id??h?.target?.testID??d.testID??null,text:t.text??h?.target?.text??h?.target?.accessibilityLabel??d.text??d.accessibilityLabel??null,type:h?.target?.type??d.type??null}))?.hit===!0){if(await m(300),!d.isTextInput||await this.waitForFocusedTextInput(600,d))return;continue}break}}if((await this.activatePressTarget(t))?.ok){await m(300);return}throw new Error(`tapOn: element not found: ${JSON.stringify(t)}`)}async tapAtCoords(e,t){await this.tap(e,t),await m(300)}async doubleTapAtCoords(e,t,n=80){let r=Math.max(0,Math.round(n));if(!await this.evaluate(`(async () => {
-      const interact = window.__sootsimInteract
-      if (interact?.doubleTap) {
-        return !!(await interact.doubleTap(${e}, ${t}, ${r}))
-      }
-      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, ${r}))
-      const second = await interact.tap(${e}, ${t})
-      return !!second && second.hit !== false
-    })()`))throw new Error(`doubleTapAtCoords failed at (${e}, ${t})`);await m(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 m(200)}let n=await this.findElement(t),r=n?` (matched node at y=${Math.round(n.absolutePosition.y)} h=${Math.round(n.layout.height)} \u2014 off-screen)`:" (no matching node in tree)";throw new Error(`assertVisible: ${JSON.stringify(t)} not visible${r}`)}async assertNotVisible(e){let t=typeof e=="string"?{text:e}:e;if(await this.isElementVisible(t)){let n=await this.findElement(t),r=n?` at (${Math.round(n.absolutePosition.x)},${Math.round(n.absolutePosition.y)})`:"";throw new Error(`assertNotVisible: ${JSON.stringify(t)} IS visible${r}`)}}async isElementVisible(e){let t=await this.findElement(e);return!!(t&&t.absolutePosition.y+t.layout.height>0&&t.absolutePosition.y<O)}async inputText(e){if(!await this.waitForFocusedTextInput())throw new Error("inputText: no focused TextInput; tap the input and wait for focus before typing");await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"type",text:e}),await m(200)}focusedTextInputMatches(e,t){if(!t||typeof t.nodeId=="number"&&typeof e.nodeId=="number"&&t.nodeId===e.nodeId)return!0;let n=t.testID??null,r=e.testID??null;if(n&&r&&n===r)return!0;let o=t.id??null,s=e.id??null;return!!(o&&s&&o===s)}async waitForFocusedTextInput(e=1500,t){let n=Date.now()+e;for(;Date.now()<n;){try{let r=await this.callTest("getFocusedNode");if(r&&this.focusedTextInputMatches(r,t))return!0}catch{}await m(50)}return!1}async pressKey(e){await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"press",text:e}),await m(120)}async dispatchKey(e){await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"dispatchKey",text:e}),await m(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 m(80);return}await m(80)}}async eraseText(e){for(let t=0;t<e;t++)await this.bridge.send({type:"keyboard",simId:this.opts.simId,action:"dispatchKey",text:"Backspace"});await m(100)}async waitFor(e){let t=Date.now()+(e.timeout||K);for(;Date.now()<t;){if(await this.findElement(e))return;await m(200)}let n=await this.findElement(e),r=n?` (matched node y=${Math.round(n.absolutePosition.y)} \u2014 still off-screen at deadline)`:"";throw new Error(`waitFor: ${JSON.stringify(e)} not found after ${e.timeout||K}ms${r}`)}async takeScreenshot(e){if(!this.hasFreshVisualSettle())try{await this.waitForVisualSettle(),await m(250)}catch{}let t=wt(e),n=ht(this.opts.screenshotDir,t.path,{mode:this.opts.screenshotPathMode??"dir",flowDir:this.opts.flowDir});v.mkdirSync(g.dirname(n),{recursive:!0});let r=t.layers??this.opts.screenshotLayers,o={type:"screenshot",simId:this.opts.simId};r&&r!=="full"&&(o.layers=r);let a=(await this.bridge.send(o)).replace(/^data:image\/png;base64,/,""),l=Buffer.from(a,"base64");if(t.withFrame){let f=await this.readCurrentDeviceModel();if(!f)throw new Error("could not read current device model for framed screenshot");let d=await We(l,f);v.writeFileSync(n,d),console.log(`[flow] screenshot: ${n} (frame: ${f})`);return}v.writeFileSync(n,l),console.log(`[flow] screenshot: ${n}`)}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 Te)?null:t}async captureFailureScreenshot(e){v.mkdirSync(g.dirname(e),{recursive:!0});let n=(await this.bridge.send({type:"screenshot",simId:this.opts.simId})).replace(/^data:image\/png;base64,/,"");v.writeFileSync(e,Buffer.from(n,"base64"))}async captureFailureBundle(e,t){v.mkdirSync(e,{recursive:!0});let n=(d,h)=>{try{v.writeFileSync(g.join(e,d),h)}catch{}},r=async d=>{try{return await this.bridge.send({type:"evaluate",simId:this.opts.simId,code:d})}catch{return null}},o=await r(`(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
-    })()`);n("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,/,"");n("screenshot.png",Buffer.from(h,"base64"))}catch{}let s=await r(`(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&&n("describe.json",JSON.stringify(s,null,2));let a=await r("(async () => await window.__sootsimTest?.dumpAccessibilityTree?.(20))()");typeof a=="string"&&n("a11y.txt",a);let l=await r("(async () => await window.__sootsimTest?.dumpTree?.(15))()");typeof l=="string"&&n("tree.txt",l);let f=await r(`(() => {
-      const c = window.__sootsimConsole
-      return {
-        errors: c?.getErrors?.() ?? [],
-        warnings: c?.getWarnings?.() ?? [],
-        requests: (window.__sootsimGetFailedRequests?.() ?? []),
-      }
-    })()`);return f&&n("console.json",JSON.stringify(f,null,2)),e}async swipe(e="UP",t=300){let n=q/2,r=O/2,o=200,s=n,a=r,l=n,f=r;switch(e.toUpperCase()){case"UP":a+=o,f-=o;break;case"DOWN":a-=o,f+=o;break;case"LEFT":s+=o,l-=o;break;case"RIGHT":s-=o,l+=o;break}let d=Math.max(10,Math.round(t/16));await this.drag(s,a,l,f,d,16)}async drag(e,t,n,r,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}, ${n}, ${r}, ${Math.max(1,Math.round(o))}, ${Math.max(0,Math.round(s))})
-      return { ok: !!value, value }
-    })()`))?.ok)throw new Error("drag failed");await m(300)}async swipeCoords(e,t,n=300){let r=ue(e),o=ue(t),s=Math.max(10,Math.round(n/16));await this.drag(r.x,r.y,o.x,o.y,s,16)}async swipeFrom(e,t="UP",n=300){let r=await this.findElement(e);if(!r)throw new Error(`swipeFrom: element not found: ${JSON.stringify(e)}`);let o=r.absolutePosition.x+r.layout.width/2,s=r.absolutePosition.y+r.layout.height/2,a=180,l=o,f=s;switch(t.toUpperCase()){case"UP":f-=a;break;case"DOWN":f+=a;break;case"LEFT":l-=a;break;case"RIGHT":l+=a;break}let d=Math.max(10,Math.round(n/16));await this.drag(o,s,l,f,d,16)}async scrollTo(e,t,n){let r=await this.callTest("scrollTo",e,t,n,!1);if(!r?.ok)throw new Error(`scrollTo failed: ${r?.reason||"unknown error"}`);await m(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 m(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){let t=Math.max(0,Math.round(e));if(t<=0)return;(await ce({bridge:this.bridge,simId:this.opts.simId,maxMs:t,pollMs:32,stablePolls:2,strict:!0})).settled&&this.markVisualSettled()}async back(){try{await this.tapOn("\u2039")}catch{await this.tapOn("<")}}async scrollUntilVisible(e){let t=Date.now()+(e.timeout||15e3),n=e.direction?.toUpperCase()||"DOWN",r=n==="DOWN"?"UP":n==="UP"?"DOWN":n;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<O-50){if(e.centerElement){let s=O/2,a=o.absolutePosition.y-s;if(Math.abs(a)>100){let l=Math.min(150,Math.abs(a)*.5),f=a>0?s-l:s+l;await this.drag(q/2,s,q/2,f,10,16)}}return}await this.swipe(r,250),await m(500)}throw new Error(`scrollUntilVisible: "${e.element}" not found`)}async extendedWaitUntil(e){let t=Date.now()+(e.timeout||K);for(;Date.now()<t;){let n=e.visible?await this.isElementVisible(typeof e.visible=="string"?{text:e.visible}:e.visible):!0,r=e.notVisible?!await this.isElementVisible(typeof e.notVisible=="string"?{text:e.notVisible}:e.notVisible):!0;if(n&&r)return;await m(200)}throw new Error("extendedWaitUntil timed out")}async reloadGuestApp(e){if(e){let r=!1;for(let o=0;o<3&&!r;o++)try{r=await this.evaluate(oe(!0),2e4)}catch{await m(1e3)}r||console.warn("  warn: tenant storage clear did not ack \u2014 hard-reloading anyway (worker reset follows)")}await this.evaluate("window.location.reload()").catch(()=>{}),await m(500),await this.refreshSimId()}async softReloadGuestApp(e){if(!await this.evaluate(oe(e),12e4))throw new Error("guest app soft reload bridge unavailable")}async rearmCaptureAfterRuntimeReload(){if(!this.recordingEnabled&&!this.profilingEnabled)return;let e=Date.now()+1e4,t=null;for(;Date.now()<e;){await this.refreshSimId();try{this.recordingEnabled&&await this.ensureRecordingStarted(),this.profilingEnabled&&await this.startProfile();return}catch(n){t=n,await m(250)}}throw new Error(`capture re-arm failed after app reload: ${t instanceof Error?t.message:String(t)}`)}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),n=ft(e,"resetRuntime");if(!this.firstLaunchDone&&!t)this.firstLaunchDone=!0,n?(this.recordingEnabled&&await this.ensureRecordingStarted(),await this.softReloadGuestApp(!1),await this.launchShellAppFromHomeIfNeeded(e),await this.waitForTree(12e4)):await this.launchShellAppFromHomeIfNeeded(e),await this.waitForTree(3e4);else if(this.firstLaunchDone=!0,await this.reloadGuestApp(t),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)
-            })
-          })
-        })
-      })`),this.markVisualSettled()}catch{await m(180),this.markVisualSettled()}}markVisualSettled(){this.lastVisualSettledAtMs=Date.now()}hasFreshVisualSettle(){return Date.now()-this.lastVisualSettledAtMs<750}resolveShellLaunchAppId(e,t){if(typeof e=="string"&&e.length>0)return e;if(fe(e)){let n=B(e,"appId")||B(e,"id");if(n)return n}return pt(t)||"connect"}async waitForShellAppLaunched(e,t){let n=Date.now()+t,r=null;for(;Date.now()<n;){try{r=await ne(this.bridge)}catch{r=null}if(r?.state==="app"&&r.activeApp===e&&r.showSwitcher===!1&&typeof r.launchProgress=="number"&&r.launchProgress>=.98)return;await m(16)}}async launchShellAppFromHomeIfNeeded(e){let t=null;try{t=await ne(this.bridge)}catch{return!1}if(t?.state!=="home"||t.activeApp!=null)return!1;let n=this.resolveShellLaunchAppId(e,t);return this.recordingEnabled&&await this.ensureRecordingStarted(),await Oe(this.bridge,"launchApp",1e3,n),await this.waitForShellAppLaunched(n,1e3),!0}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(qe)})`),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(qe)})`);if(this.profilingEnabled=!1,e?.error)throw new Error(e.error);return e}async stopApp(){await this.reloadGuestApp(!1),await this.rearmCaptureAfterRuntimeReload()}async clearState(){await this.reloadGuestApp(!0),await this.rearmCaptureAfterRuntimeReload()}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,n=await this.findElement(t);if(!n)throw new Error(`copyTextFrom: element not found: ${JSON.stringify(t)}`);let r=n.text??n.testID??"";this.js.setCopiedText(r),this.js.putEnv("maestroCopiedText",r),console.log(`[flow]   copied text: ${JSON.stringify(r)}`)}evalScript(e){let n=/(?<!\\)\$\{[^$]*\}/.test(e)?this.js.evaluateStringTemplate(e):this.js.evaluate(e);n!==void 0&&n!==""&&console.log("[flow]   evalScript ->",n)}runScript(e){let t=typeof e=="string"?{file:e}:e;if(!t.file)throw new Error("runScript requires a file");let n=g.resolve(this.opts.flowDir,t.file),r=v.readFileSync(n,"utf8");this.js.evaluate(r,{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 n=await this.callTest("openDeepLink",t);if(!n?.ok)throw new Error(`openLink failed: ${n?.error||"no test bridge"}`);await m(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?Ke(e.true):!0}isOptional(e){if(e.optional===!0)return!0;let n=Object.entries(e).find(([o])=>o!=="when"&&o!=="optional"),r=n?n[1]:void 0;return!!(r&&typeof r=="object"&&"optional"in r&&r.optional)}async runStep(e,t){let n=typeof e=="string"?gt(e):e,r=Object.keys(n).find(s=>s!=="when")||Object.keys(n)[0];console.log(`[flow] step ${t+1}: ${r}`);let o;try{o=this.js.interpolateStep(n)}catch(s){if(this.isOptional(n)){console.log(`[flow]   (optional, skipped: ${s.message.slice(0,80)})`);return}throw this.lastFailedStep={index:t,kind:r,target:n[r]},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 d=null,h=new Promise((A,w)=>{d=setTimeout(()=>{w(new Error(`step watchdog: ${r} made no progress in ${a}ms \u2014 bridge or bundle probably hung`))},a)});try{await Promise.race([l,h])}finally{d&&clearTimeout(d)}}let f=!!(o.assertVisible||o.assertNotVisible||o.extendedWaitUntil||o.waitFor);this.stepDelay>0&&!f&&await m(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:r,target:o[r]},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){let t=e.waitForAnimationToEnd;await this.waitForAnimationToEnd(typeof t=="number"?t:typeof t=="object"&&typeof t.timeout=="number"?t.timeout: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 m(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,n=t==null||t===""?Number.MAX_SAFE_INTEGER:Number(t);if(!Number.isFinite(n))throw new Error(`repeat.times is not a number: ${t}`);let r=e.repeat.when??e.repeat.condition,o=async()=>r?this.evaluateWhen(r):!0,s=r?n:Math.min(n,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,n=typeof t=="string"?void 0:t.when;if(n&&!await this.evaluateWhen(n)){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,n=typeof t=="string"?t:t.file,r=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): ${n??"inline commands"}`);return}if(!n&&!r)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(n){let a=g.resolve(this.opts.flowDir,n),l=v.readFileSync(a,"utf8"),f=this.opts.flowDir;this.opts.flowDir=g.dirname(a);try{await this.runFlow(yt(l))}finally{this.opts.flowDir=f}}else if(r)for(let a=0;a<r.length;a++)await this.runStep(r[a],a)}finally{this.js.leaveEnvScope()}}else throw new Error(`unsupported flow step: ${JSON.stringify(e)}`)}async runFlow(e){let t=[],n=[],r=[];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)){n.push(...s.onFlowComplete);continue}r.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(r)}catch(s){o=s instanceof Error?s:new Error(String(s))}if(n.length>0){console.log(`[flow] onFlowComplete (${n.length} steps)`);for(let s=0;s<n.length;s++)try{await this.runStep(n[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 n=e[t],r=typeof n.wait=="number"?n.wait:0,o=typeof n.waitFor?.timeout=="number"?n.waitFor.timeout:0,s=Math.max(6e4,r+15e3,o+15e3);if(n.runFlow||n.launchApp){await this.runStep(n,t);continue}await Promise.race([this.runStep(n,t),new Promise((a,l)=>setTimeout(()=>l(new Error(`step ${t+1} (${Object.keys(n)[0]}) exceeded ${s}ms deadline`)),s))])}}};async function bt(i){if(!i)return"";let e=i.trim();if(!e)return"";if(/^\d+$/.test(e)||e.startsWith("http://")||e.startsWith("https://"))return e;let n=(await $e()).find(r=>r.name.toLowerCase()===e.toLowerCase());return n?String(n.preferredPort):e}async function vt(){let i=await ke(),e=i.find(n=>n.patched);if(e)return`http://localhost:${e.port}/__soot/`;let t=i[0];return t?`http://localhost:${t.port}/__soot/`:null}async function Ye(i){(i.length===0||i.includes("--help")||i.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=i[0];R.existsSync(e)||(console.error(`  error: ${e} not found`),process.exit(1));let t=p=>i.find((u,y)=>i[y-1]===p),n=i.includes("--profile"),r=i.includes("--headed"),o=i.includes("--new")||r,s=t("--out")||"/tmp/sootsim-recordings",a=t("--screenshots")||(t("--out")?s:"/tmp/sootsim-flow"),l=t("--screenshot-paths")==="flow"?"flow":"dir",f=i.includes("--no-shell")?"tenant":i.includes("--shell-only")?"shell":void 0,d=t("--device")?.trim()||"",h=i.includes("--slow")?+(t("--slow")||"500"):0,A=i.includes("--electron"),w=i.includes("--preview"),_=await Je(t("--preview-origin")),pe=t("--preview-public-origin"),Xe=i.includes("--preview-open"),me=t("--owner")?.trim()||"",he=t("--repo")?.trim()||"",Ze=i.flatMap((p,u)=>i[u-1]==="--replace"?["--replace",p]:[]),Qe=i.flatMap((p,u)=>i[u-1]==="--remap"?["--remap",p]:[]),I=i.includes("--record")||w,et=i.includes("--tail-wait")?Math.max(0,+(t("--tail-wait")||"2000")):I?w?6e3:2e3:0,tt=R.readFileSync(e,"utf8"),{frontmatter:x,steps:F}=se(tt);F.length===0&&(console.error("  error: flow file must contain a YAML array of steps"),process.exit(1));let D=d||x.device||"",j=A||x.electron===!0,nt=x.app===void 0||x.app===null?"":typeof x.app=="number"?String(x.app):x.app,z=await bt(nt),we={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=re(i,we),rt=t("--url")||"";j&&!_e()&&(console.error("  error: desktop companion not found. install or build it first with `bun run build:electron`"),process.exit(1));let ge=j?"desktop companion":"bridge",it=z?` | target: ${z}`:"";console.log(`
-  sootsim flow \u2014 ${b.basename(e)}
-  ${F.length} steps | ${ge}${it}${I?" | recording":""}${n?" | profiling":""}${h?` | ${h}ms delay`:""}
-`),w&&xe({event:"preview_flow_started",properties:{flowName:b.basename(e),stepCount:F.length,mode:ge,electron:j,record:I,profile:n,previewOrigin:_}});let $=rt||z||"",Y=o||j&&S.simIdSource!=="flag",ye=t("--driver")||"",X=!1,Z=new Set,be=!1;if(!$&&!Y&&S.simIdSource==="none"){let p=Pe(S);try{let u=await p.listSims(),y=u.find(U=>U.isPrimary&&U.readyState==="open"),J=u.find(U=>U.readyState==="open"),Se=y??J;Se&&(be=!0,console.log(`  reusing active sim: ${Se.id}`))}catch{}finally{p.close()}}if(!$&&!be&&(Y||S.simIdSource==="none")){let p=await vt();p||(console.error("  error: no current sim and no sootsim target found"),await ee(),process.exit(1)),$=p}if($&&D){let p=new URL(await De($));p.searchParams.set("device",D),$=p.toString()}if($){let p=[$];if(p.push(...Ze),p.push(...Qe),Y&&p.push("--new"),p.push("--no-describe"),S.simIdSource==="flag"&&S.simId&&p.push("--sim",S.simId),ye&&(p.push("--driver",ye),X=!0),i.includes("--headless")&&!r&&p.push("--headless"),await Ce(p,{port:S.wsPort,timeoutMs:S.commandTimeoutMs}),X){let u=te();u&&Z.add(u)}}let M=re(i,we),L=M.simIdSource==="flag"?M.simId:te()||M.simId,ot=M.simIdSource==="flag"?"flag":L?"saved":"none",k=ie(M.wsPort,{commandTimeoutMs:M.commandTimeoutMs,simId:L,simIdSource:ot}),c,ve=async()=>{if(!D)return!1;let p=await k.send({type:"evaluate",simId:c.simId,code:"window.location.href"});if(typeof p=="string"&&p.length>0){let u=new URL(p);u.searchParams.set("device",D),c.setSimRouteHint(u.toString())}return!!await k.send({type:"call",simId:c.simId,path:"SootSim.bridges.settings.set",args:["deviceModel",D]})};if(c=new G(k,{screenshotDir:a,flowDir:b.dirname(b.resolve(e)),screenshotPathMode:l,screenshotLayers:f,simId:L,recordingOutputDir:I?s:void 0,recordingFormat:w?"mp4":"webm",billingOriginOverride:w?_:void 0,allowGitHubRecording:I,onAfterLaunch:async()=>{await ve()&&await c.waitForTree(12e4),w&&await k.send({type:"evaluate",simId:c.simId,code:`(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
-          return r?.start?.() ?? false
-        })()`})}}),h&&(c.stepDelay=h),c.js.putEnv("MAESTRO_FILENAME",b.basename(e,b.extname(e))),x.env&&typeof x.env=="object")for(let[p,u]of Object.entries(x.env))c.js.putEnv(p,u);let E=null,T=null,N=null,Q=null,V=0,W=!!F[0]?.launchApp;try{W||await c.waitForTree(12e4),await ve()&&!W&&await c.waitForTree(12e4),w&&!W&&!process.env.SOOTSIM_PREVIEW_RESET_DONE&&await c.launchApp({clearState:!0}),I&&(W?c.prepareRecording():await c.startRecording()),n&&await c.startProfile(),w&&(await k.send({type:"evaluate",simId:c.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 c.runFlow(F),n&&(E=await c.stopProfile()),await c.waitForRecordingTail({maxMs:et,smart:w}),I&&(T=await c.stopRecording(),N=c.getLastRecordingDurationMs()),w&&(Q=await k.send({type:"evaluate",simId:c.simId,code:`(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
-          return r?.stop?.() ?? []
-        })()`}),console.log(`  captured ${Q.length} replay events`));let u=F.filter(y=>y&&typeof y=="object"&&"takeScreenshot"in y).length;console.log(`
-  + completed (${F.length} steps)`),u>0&&console.log(`  screenshots: ${u} \u2192 ${a}`),E&&Ge(E),T&&console.log(`  video: ${T}`),console.log()}catch(p){if(n&&!E)try{E=await c.stopProfile()}catch{}if(I&&!T)try{T=await c.stopRecording(),N=c.getLastRecordingDurationMs()}catch(u){console.warn(`  recording stop failed: ${u?.message||String(u)}`)}console.error(`
-  x failed: ${p.message}
-`),E&&(console.log("  partial profile:"),Ge(E)),T&&console.log(`  partial video: ${T}`);try{let u=c.lastFailedStep,y=u?`step-${String(u.index+1).padStart(2,"0")}-${u.kind}`:"unstaged",J=b.join(a,y);await c.captureFailureBundle(J,{error:p,stepIndex:u?.index,stepKind:u?.kind,stepTarget:u?.target}),console.log(`  failure bundle: ${J}`),console.log("    (contents: screenshot.png, describe.json, a11y.txt, tree.txt, console.json, error.json)")}catch(u){try{let y=b.join(a,"error.png");await c.captureFailureScreenshot(y),console.log(`  error screenshot: ${y}`)}catch{}console.log(`  (failure bundle capture failed: ${u instanceof Error?u.message:String(u)})`)}await Re(k,{errorsCommand:`sootsim get errors 5${c.simId?` --sim ${c.simId}`:""}`,warningsCommand:`sootsim get warnings 5${c.simId?` --sim ${c.simId}`:""}`,requestsCommand:`sootsim get requests 5${c.simId?` --sim ${c.simId}`:""}`}),V=1}finally{k.close()}if(V===0&&w)try{let p=await xt(Q??[]),u=["--origin",_,"--events",p];pe&&u.push("--public-origin",pe),T&&u.push("--video",T),T&&N&&Number.isFinite(N)&&u.push("--video-duration-ms",String(Math.round(N))),c.simId&&u.push("--sim",c.simId),Xe&&u.push("--open"),me&&u.push("--owner",me),he&&u.push("--repo",he),console.log(`
-  preparing preview upload\u2026`);let{runUpload:y}=await import("./upload-QVDVJ6ZK.js");await y(u,{})}catch(p){console.error(`  preview upload failed: ${p?.message||p}`),V=1}return X?(c.simId&&Z.add(c.simId),await St(S.wsPort,S.commandTimeoutMs,[...Z])):c.simId&&c.simId!==L&&Ie(c.simId),await ee(),V}async function St(i,e,t){let n=[...new Set(t.filter(Boolean))];if(n.length===0)return;let r=ie(i,{commandTimeoutMs:e});try{let o=await r.listSims(),s=n.filter(l=>o.some(f=>f.id===l&&f.readyState==="open"));if(s.length===0)return;let a=await Be(r,i,e,s);await Ne(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{r.close()}}async function xt(i){let{gzipSync:e}=await import("zlib"),t=i.map(o=>JSON.stringify(o)).join(`
-`)+(i.length?`
-`:""),n=e(Buffer.from(t,"utf8")),r=b.join(ze(),`sootsim-events-${Date.now()}.jsonl.gz`);return R.writeFileSync(r,n),console.log(`  events: ${i.length} written to ${r} (${n.length} bytes gz)`),r}async function Tt(i){let e=i[0],t=n=>i.find((r,o)=>i[o-1]===n);switch(e){case"start":{let{path:n,state:r}=Le();console.log("  flow draft started"),console.log(`  session: ${n}`),console.log(`  steps: ${r.steps.length}`);return}case"keep":case"good":{let n=de();if(n.active||(console.error("  no active flow draft \u2014 run `sootsim flow start` first"),process.exit(1)),!n.kept){console.log("  no pending action to keep");return}console.log(`  kept: ${n.candidate.summary}`),console.log(`  steps: ${n.stepCount}`);return}case"end":{let n=t("--output")||(i[1]&&!i[1].startsWith("-")?i[1]:void 0),r=i.includes("--validate")||i.includes("--video"),o=i.includes("--video"),s=de();s.active&&s.kept&&console.log(`  auto-kept trailing action: ${s.candidate.summary}`);let a=Ve(n||(r?$t():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(r){let l=kt(i,a.outputPath),f=await Ye(l);if(f!==0){console.error(`
-  validation failed \u2014 draft preserved so you can keep iterating`),process.exitCode=f;return}le(),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(le(),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 n=i[1];(!n||n.startsWith("-"))&&(console.error("  usage: sootsim flow validate <path>"),process.exit(1));let r=ae(n);if(r.length>0){console.error(`  x ${n} failed validation:`);for(let o of r)console.error(`    - ${o}`);process.exit(1)}console.log(`  + ${n} looks valid`);return}}}function It(i){return i[0]==="--sim"&&i.length>=2?[...i.slice(2),"--sim",i[1]]:i}async function Zt(i){let e=It(i),t=e[0];if(t==="start"||t==="keep"||t==="good"||t==="end"||t==="validate")return await Tt(e),0;let n=await Ye(e);return n!==0&&(process.exitCode=n),n}function Ge(i){let e=i.avgMs>0?(1e3/i.avgMs).toFixed(1):"?",t=i.sampleCount>0?(i.jankFrames/i.sampleCount*100).toFixed(1):"0";console.log(`
-  profile:`),console.log(`    frames:     ${i.frames}`),console.log(`    total:      ${i.totalMs.toFixed(1)}ms`),console.log(`    avg:        ${i.avgMs.toFixed(2)}ms (${e} fps)`),console.log(`    max:        ${i.maxMs.toFixed(2)}ms`),i.layoutAvgMs!==void 0&&console.log(`    breakdown:  layout ${i.layoutAvgMs.toFixed(2)}ms | render ${i.renderAvgMs?.toFixed(2)||"0.00"}ms | copy ${i.copyAvgMs?.toFixed(2)||"0.00"}ms`),console.log(`    p95:        ${i.p95.toFixed(2)}ms`),console.log(`    p99:        ${i.p99.toFixed(2)}ms`),console.log(`    jank:       ${i.jankFrames}/${i.sampleCount} (${t}%) >16.67ms`);let n=Array.isArray(i.worstFrames)?i.worstFrames:[];if(n.length!==0){if(console.log(`
-  worst frames:`),i.mode==="render-worker"){console.log("    total    layout   render   copy     t+");for(let r of n){let[o,s,a,l,f]=r;console.log(`    ${s.toFixed(2).padStart(7)}  ${a.toFixed(2).padStart(7)}  ${l.toFixed(2).padStart(7)}  ${f.toFixed(2).padStart(7)}  ${String(o).padStart(5)}`)}return}console.log(`    ${n.map(r=>r.toFixed(2)).join(", ")}`)}}function $t(){return b.join(ze(),`sootsim-flow-draft-${Date.now()}.yaml`)}function kt(i,e){if(!e)throw new Error("validated flow draft requires an output path");let t=[e];for(let n=1;n<i.length;n++){let r=i[n];if(!(r==="--validate"||r==="--video")){if(r==="--output"){n+=1;continue}n===1&&!r.startsWith("-")||t.push(r)}}return!t.includes("--record")&&i.includes("--video")&&t.push("--record"),t}export{vt as a,Ye as b,It as c,Zt as d};