rnxsim 0.0.0 → 0.1.313

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

@@ -0,0 +1,568 @@
+/*! rnx v0.1.313 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import { createRequire as __sootsimCreateRequire } from 'node:module'
+var require = __sootsimCreateRequire(import.meta.url)
+import{a as lt}from"./chunk-OZSSI4WN.js";import{a as st}from"./chunk-D4FFVGI5.js";import{a as pe,b as ge,c as we,d as ze,e as ye,f as be,g as Ye,h as Se,i as ot}from"./chunk-VZXWHRUZ.js";import{a as qe}from"./chunk-GGRX24GF.js";import{e as at}from"./chunk-OVFJFXUD.js";import{g as et,h as tt,p as rt,r as nt,v as it}from"./chunk-NMF2ZMZQ.js";import{h as Ge,m as Ke}from"./chunk-MJRLLB4R.js";import{J as he,m as He,n as Ue,o as We,p as je,q as Ve}from"./chunk-XEVZYVIW.js";import{a as Qe}from"./chunk-5DHC6KHQ.js";import{g as Xe}from"./chunk-WF3T4SVI.js";import{b as Ze}from"./chunk-DZS6WPUI.js";import{h as fe,i as me,j as Je}from"./chunk-KTHV3RUS.js";import{c as De,d as ce}from"./chunk-IJO63TDP.js";import{a as Be,b as Le,c as Ne}from"./chunk-2YR5BGA5.js";import{h as ue,i as Ce}from"./chunk-4NPPOV2N.js";import*as $ from"fs";import{createHash as zt,randomUUID as Yt}from"node:crypto";import{tmpdir as z}from"os";import*as w from"path";import*as x from"fs";import*as S from"path";var At="inset 0 0 0 0.5px #000, inset 0 0 0 2px #757575, inset 0 0 0 5px #212121",ct=1;function Mt(i){let e=Ne(i),t=e.scale,r=e.statusBarHeight>0&&!e.dynamicIsland&&e.homeIndicatorHeight===0&&e.cornerRadius===0,n=e.width,o=e.height,a=Be(e),s=r?e.width+58:a.frameWidth,l=r?e.height+111+111:a.frameHeight,p=9.5,u=ct,g=s+p*2,b=l+ct*2,m=p+(r?29:a.screenLeft),P=r?111:a.screenTop,k=r?52:a.frameRadius,H=[{side:e.hardwareButtons.lock.side,top:e.hardwareButtons.lock.top,height:e.hardwareButtons.lock.height,width:e.hardwareButtons.width},{side:e.hardwareButtons.ringToggle.side,top:e.hardwareButtons.ringToggle.top,height:e.hardwareButtons.ringToggle.height,width:e.hardwareButtons.width},{side:e.hardwareButtons.volumeUp.side,top:e.hardwareButtons.volumeUp.top,height:e.hardwareButtons.volumeUp.height,width:e.hardwareButtons.width},{side:e.hardwareButtons.volumeDown.side,top:e.hardwareButtons.volumeDown.top,height:e.hardwareButtons.volumeDown.height,width:e.hardwareButtons.width}];return{model:i,renderScale:t,outerWidth:Math.round(g*t),outerHeight:Math.round(b*t),logicalOuterWidth:g,logicalOuterHeight:b,logicalFrameWidth:s,logicalFrameHeight:l,logicalFrameLeft:p,logicalFrameTop:u,logicalScreenWidth:n,logicalScreenHeight:o,logicalScreenLeft:m,logicalScreenTop:P,logicalScreenRadius:r?0:a.screenRadius,logicalFrameRadius:k,frameBackground:r?"linear-gradient(180deg, #1b1c20 0%, #0f1012 42%, #050608 100%)":"#000000",frameOutline:r?"0 0 0 1px #1f2125":"0 0 0 1px #333",metallicRingShadow:r?null:At,buttons:H,legacyHomeButton:r?{top:111+e.height+47/2,left:e.width/2-64/2+29,size:64,ring:1.5}:null,showHomeIndicator:e.homeIndicatorHeight>0,logicalHomeIndicatorStripHeight:e.homeIndicatorHeight}}function Rt(i){let e=i.side==="right",t=e?"inset(-3px -3px -3px 0)":"inset(-3px 0 -3px -3px)";return`
+      <div
+        aria-hidden="true"
+        style="
+          position:absolute;
+          ${e?`right:-${i.width}px;`:`left:-${i.width}px;`}
+          top:${i.top}px;
+          width:${i.width}px;
+          height:${i.height}px;
+          background-color:#212121;
+          border-top-left-radius:${e?0:1.5}px;
+          border-bottom-left-radius:${e?0:1.5}px;
+          border-top-right-radius:${e?1.5:0}px;
+          border-bottom-right-radius:${e?1.5:0}px;
+          box-shadow:
+            inset 0 0.5px 0 #616161,
+            inset 0 -0.5px 0 #3F3F3F,
+            ${e?"inset -0.5px 0 0 #3F3F3F,":"inset 0.5px 0 0 #3F3F3F,"}
+            0 0 0 0.5px #676767,
+            0 0 0 1.5px #000;
+          clip-path:${t};
+          pointer-events:none;
+          z-index:2;
+        "
+      ></div>
+    `}function _t(i,e){let t=i.buttons.map(Rt).join(""),r=i.metallicRingShadow?`
+      <div
+        aria-hidden="true"
+        style="
+          position:absolute;
+          inset:0;
+          border-radius:${i.logicalFrameRadius}px;
+          box-shadow:${i.metallicRingShadow};
+          pointer-events:none;
+          z-index:10;
+        "
+      ></div>
+    `:"",n=i.legacyHomeButton?`
+      <div
+        aria-hidden="true"
+        style="
+          position:absolute;
+          top:${i.legacyHomeButton.top}px;
+          left:${i.legacyHomeButton.left}px;
+          width:${i.legacyHomeButton.size}px;
+          height:${i.legacyHomeButton.size}px;
+          border-radius:50%;
+          background:
+            radial-gradient(circle at 35% 32%, rgba(62,64,68,0.35) 0%, rgba(17,18,20,0.98) 72%, rgba(8,9,11,1) 100%);
+          box-shadow:
+            inset 0 0 0 1px rgba(255,255,255,0.06),
+            inset 0 0 0 ${i.legacyHomeButton.ring}px rgba(184,192,204,0.45),
+            0 0 0 1px rgba(0,0,0,0.5);
+          z-index:3;
+          pointer-events:none;
+          display:flex;
+          align-items:center;
+          justify-content:center;
+        "
+      >
+        <div
+          style="
+            width:16px;
+            height:16px;
+            border-radius:4px;
+            box-shadow:inset 0 0 0 1.5px rgba(188,194,202,0.5);
+          "
+        ></div>
+      </div>
+    `:"",o=i.showHomeIndicator?`
+      <div
+        aria-hidden="true"
+        style="
+          position:absolute;
+          left:0;
+          right:0;
+          bottom:4px;
+          height:${i.logicalHomeIndicatorStripHeight}px;
+          display:flex;
+          align-items:center;
+          justify-content:center;
+          pointer-events:none;
+          z-index:10;
+        "
+      >
+        <div
+          style="
+            width:134px;
+            height:5px;
+            border-radius:2.5px;
+            background-color:rgb(150, 150, 150);
+            opacity:0.5;
+          "
+        ></div>
+      </div>
+    `:"";return`<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <style>
+      html, body {
+        margin: 0;
+        width: ${i.outerWidth}px;
+        height: ${i.outerHeight}px;
+        background: transparent;
+      }
+      body {
+        overflow: hidden;
+      }
+      img {
+        display: block;
+        width: 100%;
+        height: 100%;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="frame-export-root"
+      style="
+        position:relative;
+        width:${i.outerWidth}px;
+        height:${i.outerHeight}px;
+        overflow:hidden;
+        background:transparent;
+      "
+    >
+      <div
+        id="frame-scale-layer"
+        style="
+          position:absolute;
+          top:0;
+          left:0;
+          width:${i.logicalOuterWidth}px;
+          height:${i.logicalOuterHeight}px;
+          transform:scale(${i.renderScale});
+          transform-origin:top left;
+          overflow:visible;
+        "
+      >
+        <div
+          id="frame"
+          style="
+          position:absolute;
+          top:${i.logicalFrameTop}px;
+          left:${i.logicalFrameLeft}px;
+          width:${i.logicalFrameWidth}px;
+          height:${i.logicalFrameHeight}px;
+            border-radius:${i.logicalFrameRadius}px;
+            box-sizing:border-box;
+            overflow:visible;
+            background:${i.frameBackground};
+            box-shadow:${i.frameOutline};
+          "
+        >
+          ${t}
+          ${r}
+          ${n}
+          <div
+            id="screen"
+            style="
+              position:absolute;
+              top:${i.logicalScreenTop}px;
+              left:${i.logicalScreenLeft-i.logicalFrameLeft}px;
+              width:${i.logicalScreenWidth}px;
+              height:${i.logicalScreenHeight}px;
+              border-radius:${i.logicalScreenRadius}px;
+              overflow:hidden;
+              background:#000;
+            "
+          >
+            <img src="${e}" alt="" />
+            ${o}
+          </div>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>`}async function ut(i,e){let{chromium:t}=await import("playwright"),r=await st(n=>t.launch(n),{headless:!0});try{let n=await Ot(r);try{return await n.compose(i,e)}finally{await n.close()}}finally{await r.close()}}async function Ot(i){let e=new Map;async function t(r){let n=e.get(r);if(n)return n;let o=Mt(r),a=await i.newContext({viewport:{width:o.outerWidth,height:o.outerHeight},deviceScaleFactor:1}),s=await a.newPage(),l={layout:o,context:a,page:s};return e.set(r,l),l}return{async compose(r,n){let o=await t(n),a=`data:image/png;base64,${r.toString("base64")}`;return await o.page.setContent(_t(o.layout,a),{waitUntil:"load"}),await o.page.waitForTimeout(20),await o.page.screenshot({type:"png",clip:{x:0,y:0,width:o.layout.outerWidth,height:o.layout.outerHeight},omitBackground:!0})},async close(){for(let r of e.values())await r.context.close();e.clear()}}}import{spawnSync as Dt}from"child_process";import*as N from"vm";var Bt=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 G(i,e,t){if(t?.multipartForm)throw new Error("http: multipartForm is not supported by rnx yet");let r={...process.env};for(let s of Object.keys(r))(s.startsWith("BUN_INSPECT")||s==="NODE_OPTIONS")&&delete r[s];let n=Dt(process.execPath,["-e",Lt],{input:JSON.stringify({url:i,method:e,headers:t?.headers,body:t?.body}),encoding:"utf8",timeout:Bt,maxBuffer:64*1024*1024,env:r});if(n.error)throw new Error(`http ${e} ${i} failed: ${n.error.message}`);let o;try{o=JSON.parse(n.stdout||"")}catch{throw new Error(`http ${e} ${i} failed: no response (${(n.stderr||"").trim().slice(0,200)})`)}let a=o;if(a.__error)throw new Error(`http ${e} ${i} failed: ${a.__error}`);return a}var Nt=/(?<!\\)\$\{([^$]*)\}/g,Ct=/\\(\$\{[^$]*\})/g,Ht=/^[A-Za-z_$][A-Za-z0-9_$]*$/,Q=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??(n=>console.log(`[flow]   js: ${n}`)),r={output:this.output,maestro:this.maestro,http:{get:(n,o)=>G(n,"GET",o),post:(n,o)=>G(n,"POST",o),put:(n,o)=>G(n,"PUT",o),delete:(n,o)=>G(n,"DELETE",o),request:(n,o)=>G(n,(o?.method??"GET").toUpperCase(),o)},console:{log:(...n)=>t(n.map(o=>typeof o=="string"?o:pt(o)).join(" "))}};this.context=N.createContext(r),N.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[n,o]of Object.entries(process.env))o!==void 0&&this.envBinding.set(n,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[n,o]of Object.entries(r))this.envBinding.set(n,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 N.runInContext(`(function(){ with(__maestroScope){ return eval(\`${t}\`) } })()`,this.context)}syncEnvToContext(){let e=N.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(Nt,(r,n)=>{if(n.trim().length===0)return"";let o=this.evaluate(n);if(o===void 0&&Ht.test(n.trim()))throw new Error(`missing variable for flow placeholder: ${n.trim()}`);return pt(o)}).replace(Ct,(r,n)=>n)}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,n])=>[r,this.interpolateValue(n,r)])):e}};function pt(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 ht(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 ee=1e4,Ut=Math.min(10,Math.max(1,Number(process.env.SOOTSIM_FLOW_TIMEOUT_SCALE)||1)),K=i=>Math.round(i*Ut),re=393,C=852;function f(i){return new Promise(e=>setTimeout(e,i))}function Ee(i){return!!(i&&typeof i=="object"&&!Array.isArray(i))}function q(i,e){if(!Ee(i))return null;let t=i[e];return typeof t=="string"&&t.length>0?t:null}function Wt(i,e){return Ee(i)?i[e]===!0:!1}function jt(i){if(!i)return null;let e=i.recentApps;if(Array.isArray(e))for(let r of e){let n=q(r,"id");if(n)return n}let t=i.surfaceBindings;return q(t,"app:one")||q(t,"app:two")||null}function Vt(i){return i?S.basename(i)===".maestro"?S.dirname(i):i:process.cwd()}function Jt(i,e,t){let r=e.endsWith(".png")?e:`${e}.png`;if(S.isAbsolute(r))return r;if(t.mode==="flow"&&/[\\/]/.test(r)){let n=r.startsWith("./")||r.startsWith("../")?t.flowDir??process.cwd():Vt(t.flowDir);return S.resolve(n,r)}return S.join(i,r)}function Gt(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 te(i,e){let[t,r]=i.split(",").map(s=>s.trim()),n=(s,l)=>s.endsWith("%")?Number.parseFloat(s)/100*l:Number.parseFloat(s),o=e?.x??0,a=e?.y??0;return{x:o+n(t,e?.width??re),y:a+n(r,e?.height??C)}}function ft(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 Kt(i){let e=i.split(/^---$/m),t=e.length>1?e[e.length-1]:i,r=qe.parse(t);return Array.isArray(r)?r:[]}var ne=class{constructor(e,t){this.bridge=e;this.opts=t}stepDelay=0;js=new Q({platform:"ios",onLog:e=>console.log(`[flow]   js: ${e}`)});firstLaunchDone=!1;profilingEnabled=!1;recordingEnabled=!1;recordingAccessChecked=!1;recordingStartedAtMs=null;lastRecordingStartedAtMs=null;lastRecordingDurationMs=null;lastRecordingFrameStats=null;flowTraceSteps=[];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 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 n=this.simRouteHint&&e.find(l=>l.readyState==="open"&&this.normalizeSimRoute(l.url||l.origin)===this.simRouteHint);if(!n)return;let o=e.find(l=>l.isPrimary&&l.readyState==="open"),a=e.find(l=>l.readyState==="open"),s=n??o??a;s&&(this.opts.simId=s.id,console.log(`  [flow] sim rotated to ${s.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=ee){let t=Date.now()+K(e),r=Date.now(),n=null,o=0,a=0,s=-1,l=r;for(;Date.now()<t;){try{let u=await this.evaluate(He,8e3);if(o=0,u?.externalError)throw new Error(`app failed to load: ${u.externalError}`);if(u){let g=Date.now();u.nodes!==s&&(s=u.nodes,l=g);let b=u.flag===!0&&je(u),m=u.flag!==!0&&Ve(u);if((b||m)&&u.externalReady!==!1&&!u.externalError&&!u.loadingText&&g-l>=Ue)return}}catch(u){if(n=u instanceof Error?u:new Error(String(u)),n.message.startsWith("app failed to load:"))throw n;if(o++,o>=4)throw new Error(`target sim is not responding to the bridge (${n.message}). it is likely a stale orphan \u2014 run \`rnxsim list\`, then close it with \`rnxsim close <id>\` or start a fresh one with \`rnxsim open --new <port>\`.`);await this.refreshSimId()}let p=Date.now()-r;p-a>=5e3&&(a=p,console.log(`  [flow] waiting for app to be ready\u2026 (${Math.round(p/1e3)}s)`)),await f(We)}throw n?.message.startsWith("app failed to load:")?n:new Error(`app not ready after ${e}ms`)}async ensureRecordingStarted(){if(!this.opts.recordingOutputDir)throw new Error("recording output directory not configured");this.recordingAccessChecked||(this.opts.requireRecordingEntitlement&&await lt("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=typeof t.startedAtMs=="number"&&Number.isFinite(t.startedAtMs)?t.startedAtMs:e)}async startRecording(){this.recordingEnabled=!0,await this.ensureRecordingStarted()}prepareRecording(){this.recordingEnabled=!0}getLastRecordingDurationMs(){return this.lastRecordingDurationMs}getLastRecordingStartedAtMs(){return this.lastRecordingStartedAtMs}getLastRecordingFrameStats(){return this.lastRecordingFrameStats}getFlowTraceSteps(){return[...this.flowTraceSteps]}flowStepTargetLabel(e,t){if(t==="inputText"||t==="runScript"||t==="evalScript")return;let r=e[t];if(typeof r=="string")return r.slice(0,80);if(typeof r=="number"||typeof r=="boolean")return String(r);if(!r||typeof r!="object")return;let n=r,o=n.id??n.text??n.name??n.path;if(typeof o=="string"&&o)return o.slice(0,80);let a=n.visible??n.notVisible;if(typeof a=="string"&&a)return a.slice(0,80);if(a&&typeof a=="object"){let s=a,l=s.id??s.text;if(typeof l=="string"&&l)return l.slice(0,80)}if(n.point&&typeof n.point=="string")return n.point.slice(0,80);if(typeof n.x=="number"&&typeof n.y=="number")return`${Math.round(n.x)}, ${Math.round(n.y)}`}recordFlowTraceStep(e){let t=Date.now(),r={stepIndex:e.stepIndex,stepName:e.stepName,...e.targetLabel?{targetLabel:e.targetLabel}:{},startedAtMs:e.startedAtMs,endedAtMs:t,durationMs:Math.max(0,t-e.startedAtMs),status:e.status};e.error!=null&&(r.error=e.error instanceof Error?e.error.message:String(e.error)),e.screenshotPath&&(r.screenshotPath=e.screenshotPath),this.flowTraceSteps.push(r)}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,this.lastRecordingFrameStats=null,new Error(t?.error||"recording stop failed");this.lastRecordingStartedAtMs=this.recordingStartedAtMs,this.lastRecordingDurationMs=this.recordingStartedAtMs?Math.max(1,e-this.recordingStartedAtMs):null,this.lastRecordingFrameStats=t.frameStats??null,this.recordingStartedAtMs=null;let r=[],n=0;for(;;){let l=await this.evaluate(`window.__sootsimRecorder.getBlobBase64({ offset: ${n}, chunk: 2097152 })`);if(!l||(r.push(Buffer.from(l.data,"base64")),n=l.offset,l.done))break}if(r.length===0)throw new Error("recording requested but no video buffer was produced");x.mkdirSync(this.opts.recordingOutputDir,{recursive:!0});let a=(t.mime||this.opts.recordingFormat||"video/webm").includes("mp4")?"mp4":"webm",s=S.join(this.opts.recordingOutputDir,`sootsim-${Date.now()}.${a}`);return x.writeFileSync(s,Buffer.concat(r)),s}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 Se({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){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 < ${C}
+      })
+      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,r){return await this.bridge.send({type:"tap",simId:this.opts.simId,x:e,y:t,target:r})}async longPress(e,t,r,n){return await this.bridge.send({type:"longPress",simId:this.opts.simId,x:e,y:t,durationMs:r,target:n})}async waitForElement(e,t=5e3){let r=Date.now()+t,n=await this.findElement(e);for(;!n&&Date.now()<r;)await f(150),n=await this.findElement(e);if(!n)return n;let o=Date.now()+1200,a=n;for(;Date.now()<o;){await f(120);let s=await this.findElement(e);if(!s)break;let l=Math.abs(s.absolutePosition.x-a.absolutePosition.x)>.5||Math.abs(s.absolutePosition.y-a.absolutePosition.y)>.5||Math.abs(s.layout.width-a.layout.width)>.5||Math.abs(s.layout.height-a.layout.height)>.5;if(n=s,!l)return n;a=s}return n}replayTargetForElement(e,t,r){return{id:e.id??r?.target?.id??t.id??null,testID:e.id??r?.target?.testID??t.testID??null,text:e.text??r?.target?.text??r?.target?.accessibilityLabel??t.text??t.accessibilityLabel??null,type:r?.target?.type??t.type??null}}async resolveInteractionPoint(e){if(e.point&&!e.id&&!e.text&&e.index===void 0&&!e.childOf)return{...te(e.point),element:null,target:void 0};let t=await this.waitForElement(e);if(!t)return null;let r=typeof t.nodeId=="number"?await this.resolveTapTarget(t.nodeId):null,n=this.replayTargetForElement(e,t,r);return e.point?{...te(e.point,{x:t.absolutePosition.x,y:t.absolutePosition.y,width:t.layout.width,height:t.layout.height}),element:t,target:n}:{x:r?.cx??t.absolutePosition.x+t.layout.width/2,y:r?.cy??t.absolutePosition.y+t.layout.height/2,element:t,target:n}}async tapOn(e){let t=typeof e=="string"?{text:e}:e;if(t.point){let o=await this.resolveInteractionPoint(t);if(!o)throw new Error(`tapOn: element not found: ${JSON.stringify(t)}`);(await this.activatePressAt(o.x,o.y))?.ok||await this.tap(o.x,o.y,o.target),await f(300);return}let r=await this.waitForElement(t);if(r){let o=r.isTextInput?4:1;for(let a=0;a<o;a++){let s=a===0?r:await this.findElement({text:t.text,id:t.id});if(!s)break;let l=typeof s.nodeId=="number"?await this.resolveTapTarget(s.nodeId):null,p=l?.cx??s.absolutePosition.x+s.layout.width/2,u=l?.cy??s.absolutePosition.y+s.layout.height/2;if((await this.tap(p,u,this.replayTargetForElement(t,s,l)))?.hit===!0){if(await f(300),!s.isTextInput||await this.waitForFocusedTextInput(600,s))return;continue}break}}if((await this.activatePressTarget(t))?.ok){await f(300);return}throw new Error(`tapOn: element not found: ${JSON.stringify(t)}`)}async longPressOn(e){let t=typeof e=="string"?{text:e}:e,r=await this.resolveInteractionPoint(t);if(!r)throw new Error(`longPressOn: element not found: ${JSON.stringify(t)}`);let n=await this.longPress(r.x,r.y,3e3,r.target);if(n?.ok===!1||n?.value===!1)throw new Error(`longPressOn: long press missed: ${JSON.stringify(t)}`);await f(300)}async tapAtCoords(e,t){await this.tap(e,t),await f(300)}async doubleTapAtCoords(e,t,r=80){let n=Math.max(0,Math.round(r));if(!await this.evaluate(`(async () => {
+      const interact = window.__sootsimInteract
+      if (interact?.doubleTap) {
+        return !!(await interact.doubleTap(${e}, ${t}, ${n}))
+      }
+      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, ${n}))
+      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),n=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${n}`)}async assertNotVisible(e){let t=typeof e=="string"?{text:e}:e;if(await this.isElementVisible(t)){let r=await this.findElement(t),n=r?` at (${Math.round(r.absolutePosition.x)},${Math.round(r.absolutePosition.y)})`:"";throw new Error(`assertNotVisible: ${JSON.stringify(t)} IS visible${n}`)}}async isElementVisible(e){let t=await this.findElement(e);return!!(t&&t.absolutePosition.y+t.layout.height>0&&t.absolutePosition.y<C)}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 f(200)}focusedTextInputMatches(e,t){if(!t||typeof t.nodeId=="number"&&typeof e.nodeId=="number"&&t.nodeId===e.nodeId)return!0;let r=t.testID??null,n=e.testID??null;if(r&&n&&r===n)return!0;let o=t.id??null,a=e.id??null;return!!(o&&a&&o===a)}async waitForFocusedTextInput(e=1500,t){let r=Date.now()+e;for(;Date.now()<r;){try{let n=await this.callTest("getFocusedNode");if(n&&this.focusedTextInputMatches(n,t))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.bridge.send({type:"keyboard",simId:this.opts.simId,action:"dispatchKey",text:"Backspace"});await f(100)}async waitFor(e){let t=Date.now()+K(e.timeout||ee);for(;Date.now()<t;){if(await this.findElement(e))return;await f(200)}let r=await this.findElement(e),n=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||ee}ms${n}`)}async takeScreenshot(e){if(!this.hasFreshVisualSettle())try{await this.waitForVisualSettle(),await f(250)}catch{}let t=Gt(e),r=Jt(this.opts.screenshotDir,t.path,{mode:this.opts.screenshotPathMode??"dir",flowDir:this.opts.flowDir});x.mkdirSync(S.dirname(r),{recursive:!0});let n=t.layers??this.opts.screenshotLayers,o={type:"screenshot",simId:this.opts.simId};n&&n!=="full"&&(o.layers=n);let s=(await this.bridge.send(o)).replace(/^data:image\/png;base64,/,""),l=Buffer.from(s,"base64");if(t.withFrame){let p=await this.readCurrentDeviceModel();if(!p)throw new Error("could not read current device model for framed screenshot");let u=await ut(l,p);return x.writeFileSync(r,u),console.log(`[flow] screenshot: ${r} (frame: ${p})`),r}return x.writeFileSync(r,l),console.log(`[flow] screenshot: ${r}`),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 Le)?null:t}async captureScreenshot(e){x.mkdirSync(S.dirname(e),{recursive:!0});let r=(await this.bridge.send({type:"screenshot",simId:this.opts.simId})).replace(/^data:image\/png;base64,/,"");x.writeFileSync(e,Buffer.from(r,"base64"))}async captureFailureBundle(e,t){x.mkdirSync(e,{recursive:!0});let r=(u,g)=>{try{x.writeFileSync(S.join(e,u),g)}catch{}},n=async u=>{try{return await this.bridge.send({type:"evaluate",simId:this.opts.simId,code:u})}catch{return null}},o=await n(`(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 g=(await this.bridge.send({type:"screenshot",simId:this.opts.simId})).replace(/^data:image\/png;base64,/,"");r("screenshot.png",Buffer.from(g,"base64"))}catch{}let a=await n(`(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 }
+    })()`);a&&r("describe.json",JSON.stringify(a,null,2));let s=await n("(async () => await window.__sootsimTest?.dumpAccessibilityTree?.(20))()");typeof s=="string"&&r("a11y.txt",s);let l=await n("(async () => await window.__sootsimTest?.dumpTree?.(15))()");typeof l=="string"&&r("tree.txt",l);let p=await n(`(() => {
+      const c = window.__sootsimConsole
+      return {
+        errors: c?.getErrors?.() ?? [],
+        warnings: c?.getWarnings?.() ?? [],
+        requests: (window.__sootsimGetFailedRequests?.() ?? []),
+      }
+    })()`);return p&&r("console.json",JSON.stringify(p,null,2)),e}async swipe(e="UP",t=300){let r=re/2,n=C/2,o=200,a=r,s=n,l=r,p=n;switch(e.toUpperCase()){case"UP":s+=o,p-=o;break;case"DOWN":s-=o,p+=o;break;case"LEFT":a+=o,l-=o;break;case"RIGHT":a-=o,l+=o;break}let u=Math.max(10,Math.round(t/16));await this.drag(a,s,l,p,u,16)}async drag(e,t,r,n,o=12,a=16){if(!(await this.evaluate(`(async () => {
+      const interact = window.__sootsimInteract
+      if (!interact?.drag) return { ok: false }
+      const value = await interact.drag(${e}, ${t}, ${r}, ${n}, ${Math.max(1,Math.round(o))}, ${Math.max(0,Math.round(a))})
+      return { ok: !!value, value }
+    })()`))?.ok)throw new Error("drag failed");await f(300)}async swipeCoords(e,t,r=300){let n=te(e),o=te(t),a=Math.max(10,Math.round(r/16));await this.drag(n.x,n.y,o.x,o.y,a,16)}async swipeFrom(e,t="UP",r=300){let n=await this.findElement(e);if(!n)throw new Error(`swipeFrom: element not found: ${JSON.stringify(e)}`);let o=n.absolutePosition.x+n.layout.width/2,a=n.absolutePosition.y+n.layout.height/2,s=180,l=o,p=a;switch(t.toUpperCase()){case"UP":p-=s;break;case"DOWN":p+=s;break;case"LEFT":l-=s;break;case"RIGHT":l+=s;break}let u=Math.max(10,Math.round(r/16));await this.drag(o,a,l,p,u,16)}async scrollTo(e,t,r){let n=await this.callTest("scrollTo",e,t,r,!1);if(!n?.ok)throw new Error(`scrollTo failed: ${n?.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){let t=Math.max(0,Math.round(e));if(t<=0)return;(await Se({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),r=e.direction?.toUpperCase()||"DOWN",n=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<C-50){if(e.centerElement){let a=C/2,s=o.absolutePosition.y-a;if(Math.abs(s)>100){let l=Math.min(150,Math.abs(s)*.5),p=s>0?a-l:a+l;await this.drag(re/2,a,re/2,p,10,16)}}return}await this.swipe(n,250),await f(500)}throw new Error(`scrollUntilVisible: "${e.element}" not found`)}async extendedWaitUntil(e){let t=Date.now()+K(e.timeout||ee);for(;Date.now()<t;){let r=e.visible?await this.isElementVisible(typeof e.visible=="string"?{text:e.visible}:e.visible):!0,n=e.notVisible?!await this.isElementVisible(typeof e.notVisible=="string"?{text:e.notVisible}:e.notVisible):!0;if(r&&n)return;await f(200)}throw new Error("extendedWaitUntil timed out")}async reloadGuestApp(e){if(e){let n=!1;for(let o=0;o<3&&!n;o++)try{n=await this.evaluate(pe(!0),2e4)}catch{await f(1e3)}n||console.warn("  warn: tenant storage clear did not ack \u2014 hard-reloading anyway (worker reset follows)")}await this.evaluate("window.location.reload()").catch(()=>{}),await f(500),await this.refreshSimId()}async softReloadGuestApp(e){if(!await this.evaluate(pe(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(r){t=r,await f(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 (rnx has no native process)");let t=!!(e&&typeof e=="object"&&e.clearState),r=Wt(e,"resetRuntime");if(!this.firstLaunchDone&&!t)this.firstLaunchDone=!0,r?(await this.launchShellAppFromHomeIfNeeded(e)&&await this.waitForTree(12e4),await this.softReloadGuestApp(!1),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(n){console.warn(`  warn: onAfterLaunch hook threw: ${n instanceof Error?n.message:n}`)}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 f(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(Ee(e)){let r=q(e,"appId")||q(e,"id");if(r)return r}return jt(t)||"connect"}async waitForShellAppLaunched(e,t){let r=Date.now()+t,n=null;for(;Date.now()<r;){try{n=await he(this.bridge)}catch{n=null}if(n?.state==="app"&&n.activeApp===e&&n.showSwitcher===!1&&typeof n.launchProgress=="number"&&n.launchProgress>=.98)return;await f(16)}}async launchShellAppFromHomeIfNeeded(e){let t=null;try{t=await he(this.bridge)}catch{return!1}if(t?.state!=="home"||t.activeApp!=null)return!1;let r=this.resolveShellLaunchAppId(e,t);return this.recordingEnabled&&await this.ensureRecordingStarted(),await Ge(this.bridge,"launchApp",1e3,r),await this.waitForShellAppLaunched(r,1e3),!0}async startProfile(){let e=await this.evaluate(`(() => {
+      if (!window.__sootsimShellPerf) {
+        return { error: "shell frame profile unavailable (__sootsimShellPerf missing on the page)" }
+      }
+      window.__sootsimShellPerf.start()
+      return { started: true }
+    })()`);if(e?.error)throw new Error(e.error);this.profilingEnabled=!0}async stopProfile(){let e=await this.evaluate(`(async () => {
+      if (!window.__sootsimShellPerf) {
+        return { error: "shell frame profile unavailable (__sootsimShellPerf missing on the page)" }
+      }
+      return await window.__sootsimShellPerf.stop()
+    })()`);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: rnx 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 n=r.text??r.testID??"";this.js.setCopiedText(n),this.js.putEnv("maestroCopiedText",n),console.log(`[flow]   copied text: ${JSON.stringify(n)}`)}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=S.resolve(this.opts.flowDir,t.file),n=x.readFileSync(r,"utf8");this.js.evaluate(n,{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?ht(e.true):!0}isOptional(e){if(e.optional===!0)return!0;let r=Object.entries(e).find(([o])=>o!=="when"&&o!=="optional"),n=r?r[1]:void 0;return!!(n&&typeof n=="object"&&"optional"in n&&n.optional)}async runStep(e,t){let r=typeof e=="string"?ft(e):e,n=Object.keys(r).find(l=>l!=="when")||Object.keys(r)[0];console.log(`[flow] step ${t+1}: ${n}`);let o=Date.now(),a=this.flowStepTargetLabel(r,n),s;try{s=this.js.interpolateStep(r),a=this.flowStepTargetLabel(s,n)??a}catch(l){if(this.isOptional(r)){console.log(`[flow]   (optional, skipped: ${l.message.slice(0,80)})`),this.recordFlowTraceStep({stepIndex:t,stepName:n,targetLabel:a,startedAtMs:o,status:"skipped",error:l});return}throw this.lastFailedStep={index:t,kind:n,target:r[n]},this.recordFlowTraceStep({stepIndex:t,stepName:n,targetLabel:a,startedAtMs:o,status:"failure",error:l}),l}if(s.when&&!await this.evaluateWhen(s.when)){console.log("[flow]   (when: predicate false, skipped)"),this.recordFlowTraceStep({stepIndex:t,stepName:n,targetLabel:a,startedAtMs:o,status:"skipped"});return}try{let l=!!(s.extendedWaitUntil||s.waitFor||s.scrollUntilVisible||s.launchApp||s.runFlow||s.runScript),p=1e4,u=this.runStepInner(s),g;if(l){let m=await u;typeof m=="string"&&(g=m)}else{let m=null,P=new Promise((k,H)=>{m=setTimeout(()=>{H(new Error(`step watchdog: ${n} made no progress in ${p}ms \u2014 bridge or bundle probably hung`))},p)});try{let k=await Promise.race([u,P]);typeof k=="string"&&(g=k)}finally{m&&clearTimeout(m)}}let b=!!(s.assertVisible||s.assertNotVisible||s.extendedWaitUntil||s.waitFor);this.stepDelay>0&&!b&&await f(this.stepDelay),this.recordFlowTraceStep({stepIndex:t,stepName:n,targetLabel:a,startedAtMs:o,status:"success",screenshotPath:g})}catch(l){if(this.isOptional(s)){console.log(`[flow]   (optional, skipped: ${l.message.slice(0,80)})`),this.recordFlowTraceStep({stepIndex:t,stepName:n,targetLabel:a,startedAtMs:o,status:"skipped",error:l});return}throw this.lastFailedStep={index:t,kind:n,target:s[n]},this.recordFlowTraceStep({stepIndex:t,stepName:n,targetLabel:a,startedAtMs:o,status:"failure",error:l}),l}}async runStepInner(e){if(e.tapOn)await this.tapOn(e.tapOn);else if(e.longPressOn)await this.longPressOn(e.longPressOn);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)return this.takeScreenshot(e.takeScreenshot);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 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 n=e.repeat.when??e.repeat.condition,o=async()=>n?this.evaluateWhen(n):!0,a=n?r:Math.min(r,1e3),s=0;for(;s<a&&await o();){for(let l=0;l<e.repeat.commands.length;l++)await this.runStep(e.repeat.commands[l],l);s++}}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,n=typeof t=="string"?void 0:t.commands,o=typeof t=="string"?void 0:t.env,a=typeof t=="string"?void 0:t.when;if(a&&!await this.evaluateWhen(a)){console.log(`[flow] runFlow skipped (when predicate false): ${r??"inline commands"}`);return}if(!r&&!n)throw new Error("runFlow requires either file or commands");this.js.enterEnvScope();try{if(o)for(let[s,l]of Object.entries(o))this.js.putEnv(s,l);if(r){let s=S.resolve(this.opts.flowDir,r),l=x.readFileSync(s,"utf8"),p=this.opts.flowDir;this.opts.flowDir=S.dirname(s);try{await this.runFlow(Kt(l))}finally{this.opts.flowDir=p}}else if(n)for(let s=0;s<n.length;s++)await this.runStep(n[s],s)}finally{this.js.leaveEnvScope()}}else throw new Error(`unsupported flow step: ${JSON.stringify(e)}`)}}liveStatus=null;async runFlow(e){let t=[],r=[],n=[];for(let a of e){let s=Object.keys(a);if(s.length===1&&s[0]==="onFlowStart"&&Array.isArray(a.onFlowStart)){t.push(...a.onFlowStart);continue}if(s.length===1&&s[0]==="onFlowComplete"&&Array.isArray(a.onFlowComplete)){r.push(...a.onFlowComplete);continue}n.push(a)}if(this.liveStatus&&await this.liveStatus.plan(n.map((a,s)=>{let l=typeof a=="string"?ft(a):a,p=Object.keys(l).find(u=>u!=="when")??Object.keys(l)[0];return{index:s,name:p,target:this.flowStepTargetLabel(l,p)}})),t.length>0){console.log(`[flow] onFlowStart (${t.length} steps)`);for(let a=0;a<t.length;a++)await this.runStep(t[a],a)}let o=null;try{await this.runFlowBody(n)}catch(a){o=a instanceof Error?a:new Error(String(a))}if(r.length>0){console.log(`[flow] onFlowComplete (${r.length} steps)`);for(let a=0;a<r.length;a++)try{await this.runStep(r[a],a)}catch(s){console.warn(`[flow]   onFlowComplete step ${a+1} failed: ${s instanceof Error?s.message:s}`)}}if(o)throw o}async runFlowBody(e){for(let t=0;t<e.length;t++){let r=e[t],n=typeof r.wait=="number"?r.wait:0,o=typeof r.waitFor?.timeout=="number"?r.waitFor.timeout:0,a=typeof r.extendedWaitUntil?.timeout=="number"?r.extendedWaitUntil.timeout:0,s=Math.max(6e4,n+15e3,K(o)+15e3,K(a)+15e3);this.liveStatus&&(await this.liveStatus.waitWhilePaused(),await this.liveStatus.step(t,"running"));let l=Date.now(),p=async(u,g)=>{if(!this.liveStatus)return;let b=this.flowTraceSteps[this.flowTraceSteps.length-1],m=b&&b.stepIndex===t&&b.startedAtMs>=l;await this.liveStatus.step(t,u?"failure":m&&b.status==="skipped"?"skipped":"success",{durationMs:Date.now()-l,error:u?g instanceof Error?g.message.slice(0,300):String(g).slice(0,300):m&&b.error||void 0})};try{r.runFlow||r.launchApp?await this.runStep(r,t):await Promise.race([this.runStep(r,t),new Promise((u,g)=>setTimeout(()=>g(new Error(`step ${t+1} (${Object.keys(r)[0]}) exceeded ${s}ms deadline`)),s))])}catch(u){let g=this.flowTraceSteps[this.flowTraceSteps.length-1];if(!(g&&g.stepIndex===t&&g.startedAtMs>=l)){let b=Object.keys(r)[0];this.lastFailedStep={index:t,kind:b,target:r[b]},this.recordFlowTraceStep({stepIndex:t,stepName:b,targetLabel:this.flowStepTargetLabel(r,b),startedAtMs:l,status:"failure",error:u})}throw await p(!0,u),u}await p(!1)}}};function qt(i){if(typeof i!="object"||i==null||!("control"in i))return!1;let e=i.control;return typeof e=="object"&&e!=null&&"paused"in e&&e.paused===!0}var ie=class{constructor(e,t,r){this.bridge=e;this.flowName=t;this.getSimId=r}disabled=!1;paused=!1;lastSimId;plannedSteps=null;completedSteps=new Map;runId=`flr_${Date.now().toString(36)}_${Math.random().toString(36).slice(2,8)}`;async send(e,t){let r=await this.bridge.send({type:"flowStatus",simId:t,status:{runId:this.runId,flowName:this.flowName,...e}});this.paused=qt(r)}async push(e){if(!this.disabled)try{let t=this.getSimId?.();if(t!==this.lastSimId&&this.lastSimId!=null&&this.plannedSteps&&e.phase!=="plan"){await this.send({phase:"plan",state:"running",steps:this.plannedSteps},t);for(let r of this.completedSteps.values())await this.send({phase:"step",state:"running",step:r},t)}this.lastSimId=t,await this.send(e,t)}catch(t){this.disabled=!0,console.log(`[flow]   live status unavailable (${t instanceof Error?t.message.slice(0,120):t}) \u2014 continuing without the devtools rail`)}}async plan(e){this.plannedSteps=e.map(t=>({...t})),this.completedSteps.clear(),await this.push({phase:"plan",state:"running",steps:e})}async step(e,t,r){let n={index:e,status:t,...r};await this.push({phase:"step",state:"running",step:n}),this.completedSteps.set(e,n)}async end(e){await this.push({phase:"end",state:e})}async waitWhilePaused(){if(!this.disabled)for(;this.paused;){for(console.log("[flow]   paused from devtools \u2014 waiting\u2026");this.paused&&!this.disabled;)await new Promise(e=>setTimeout(e,400)),await this.push({phase:"heartbeat",state:"paused"});this.disabled||console.log("[flow]   resumed")}}};var Fe=null;function Wr(){return Fe}var Ie=[];function jr(){return Ie}async function Zt(i){if(!i)return"";let e=i.trim();if(!e)return"";if(/^\d+$/.test(e)||e.startsWith("http://")||e.startsWith("https://"))return e;let r=(await Ze()).find(n=>n.name.toLowerCase()===e.toLowerCase());return r?String(r.preferredPort):e}async function Xt(){let i=await Xe(),e=i.find(r=>r.patched);if(e)return`http://localhost:${e.port}/__soot/`;let t=i[0];return t?`http://localhost:${t.port}/__soot/`:null}async function gt(i){Fe=null,Ie=[],(i.length===0||i.includes("--help")||i.includes("-h"))&&(console.log(`
+sootsim maestro \u2014 author and run Maestro YAML flows
+
+usage:
+  sootsim maestro test <flow.yaml> [options]
+  sootsim maestro start
+  sootsim maestro keep
+  sootsim maestro end [--output <path>] [--validate] [--video]
+  sootsim maestro 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, use playwright or electron;
+                       browser sims default to isolated playwright
+  --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)
+  --billing-kind test_run
+                       meter the chained preview upload as a test run
+  --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 maestro test login.yaml
+  sootsim maestro test demo.yaml --url 8081 --record --slow 500 --out ./recordings
+  sootsim maestro test demo.yaml --sim a2
+  sootsim maestro start
+  sootsim maestro keep
+  sootsim maestro end --output ./.maestro/draft.yaml
+  sootsim maestro end --output ./.maestro/draft.yaml --validate
+  sootsim maestro end --output ./.maestro/draft.yaml --video
+  sootsim maestro validate ./.maestro/draft.yaml
+
+flow extension:
+  takeScreenshot: hero
+  takeScreenshot:
+    path: marketing/hero
+    withFrame: true
+`),process.exit(0));let e=i[0];$.existsSync(e)||(console.error(`  error: ${e} not found`),process.exit(1));let t=h=>i.find((d,y)=>i[y-1]===h),r=i.includes("--profile"),n=i.includes("--headed"),o=i.includes("--new")||n,a=t("--out")||"/tmp/sootsim-recordings",s=t("--screenshots")||(t("--out")?a:"/tmp/sootsim-flow"),l=t("--screenshot-paths")==="flow"?"flow":"dir",p=i.includes("--no-shell")?"tenant":i.includes("--shell-only")?"shell":void 0,u=t("--device")?.trim()||"",g=i.includes("--slow")?+(t("--slow")||"500"):0,b=i.includes("--electron"),m=i.includes("--preview"),P=m?await at(t("--preview-origin")):"",k=t("--preview-public-origin"),H=i.includes("--preview-open"),$e=t("--owner")?.trim()||"",Pe=t("--repo")?.trim()||"",U=t("--billing-kind")?.trim()||"",wt=m?`maestro:${process.env.GITHUB_RUN_ID?`github:${process.env.GITHUB_RUN_ID}:attempt:${process.env.GITHUB_RUN_ATTEMPT||"1"}:job:${process.env.GITHUB_JOB||"preview"}`:`local:${Yt()}`}:flow:${zt("sha256").update(w.relative(process.cwd(),w.resolve(e))).digest("hex").slice(0,16)}`:"";U&&U!=="test_run"&&(console.error(`  error: invalid --billing-kind: ${U}`),process.exit(1));let yt=i.flatMap((h,d)=>i[d-1]==="--replace"?["--replace",h]:[]),bt=i.flatMap((h,d)=>i[d-1]==="--remap"?["--remap",h]:[]),M=i.includes("--record")||m,St=i.includes("--tail-wait")?Math.max(0,+(t("--tail-wait")||"2000")):M?m?6e3:2e3:0,vt=$.readFileSync(e,"utf8"),{frontmatter:T,steps:R}=ge(vt);R.length===0&&(console.error("  error: flow file must contain a YAML array of steps"),process.exit(1));let W=u||T.device||"",ke=T.theme||"",Y=b||T.electron===!0,xt=T.app===void 0||T.app===null?"":typeof T.app=="number"?String(T.app):T.app,oe=await Zt(xt),Ae={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","--billing-kind","--owner","--repo"]},v=fe(i,Ae),Tt=t("--url")||"";Y&&!Qe()&&(console.error("  error: desktop companion not found. install or build it first with `bun run build:electron`"),process.exit(1));let Me=Y?"desktop companion":"bridge",Et=oe?` | target: ${oe}`:"";console.log(`
+  sootsim maestro \u2014 ${w.basename(e)}
+  ${R.length} steps | ${Me}${Et}${M?" | recording":""}${r?" | profiling":""}${g?` | ${g}ms delay`:""}
+`),m&&De({event:"preview_flow_started",properties:{flowName:w.basename(e),stepCount:R.length,mode:Me,electron:Y,record:M,profile:r,previewOrigin:P}});let A=Tt||oe||"",se=o||Y&&v.simIdSource!=="flag",Re=t("--driver")||"",ae=!1,le=new Set,_e=!1;if(!A&&!se&&v.simIdSource==="none"){let h=Je(v);try{let d=await h.listSims(),y=d.find(D=>D.isPrimary&&D.readyState==="open"),I=d.find(D=>D.readyState==="open"),J=y??I;J&&(_e=!0,console.log(`  reusing active sim: ${J.id}`))}catch{}finally{h.close()}}if(!A&&!_e&&(se||v.simIdSource==="none")){let h=await Xt();h||(console.error("  error: no current sim and no sootsim target found"),await ce(),process.exit(1)),A=h}if(A&&W){let h=new URL(await tt(A,et(v.wsPort)));h.searchParams.set("device",W),A=h.toString()}if(A){let h=[A];if(h.push(...yt),h.push(...bt),se&&h.push("--new"),h.push("--no-describe"),v.simIdSource==="flag"&&v.simId&&h.push("--sim",v.simId),Re&&(h.push("--driver",Re),ae=!0),i.includes("--headless")&&!n&&h.push("--headless"),await nt(h,{port:v.wsPort,timeoutMs:v.commandTimeoutMs}),ae){let d=ue();d&&le.add(d)}}let B=fe(i,Ae),Z=B.simIdSource==="flag"?B.simId:ue()||B.simId,Ft=B.simIdSource==="flag"?"flag":Z?"saved":"none",E=me(B.wsPort,{commandTimeoutMs:B.commandTimeoutMs,simId:Z,simIdSource:Ft}),c,Oe=async()=>{let h=T.env?.SOOTSIM_STATUS_BAR_TIME;if(h){if(!/^(?:[1-9]|1[0-2]):[0-5][0-9]$/.test(h))throw new Error("SOOTSIM_STATUS_BAR_TIME must be a 12-hour time such as 9:41");await E.send({type:"evaluate",simId:c.simId,code:`window.dispatchEvent(new CustomEvent('sootsim:statusBarOverride', { detail: { time: ${JSON.stringify(h)} } }))`})}if(ke&&await E.send({type:"call",simId:c.simId,path:"SootSim.bridges.settings.set",args:["colorScheme",ke]}),!W)return!1;let d=await E.send({type:"evaluate",simId:c.simId,code:"window.location.href"});if(typeof d=="string"&&d.length>0){let y=new URL(d);y.searchParams.set("device",W),c.setSimRouteHint(y.toString())}return!!await E.send({type:"call",simId:c.simId,path:"SootSim.bridges.settings.set",args:["deviceModel",W]})};if(c=new ne(E,{screenshotDir:s,flowDir:w.dirname(w.resolve(e)),screenshotPathMode:l,screenshotLayers:p,simId:Z,recordingOutputDir:M?a:void 0,recordingFormat:m?"mp4":"webm",billingOriginOverride:m?P:void 0,allowGitHubRecording:m,requireRecordingEntitlement:m,onAfterLaunch:async()=>{await Oe()&&await c.waitForTree(12e4),m&&await E.send({type:"evaluate",simId:c.simId,code:`(() => {
+          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+          return r?.start?.() ?? false
+        })()`})}}),g&&(c.stepDelay=g),c.liveStatus=new ie(E,w.basename(e),()=>c.simId),c.js.putEnv("MAESTRO_FILENAME",w.basename(e,w.extname(e))),T.env&&typeof T.env=="object")for(let[h,d]of Object.entries(T.env))c.js.putEnv(h,d);let _=null,F=null,L=null,O=null,j=null,de=null,V=0,X=!!R[0]?.launchApp;try{X||await c.waitForTree(12e4),await Oe()&&!X&&await c.waitForTree(12e4),m&&!X&&!process.env.SOOTSIM_PREVIEW_RESET_DONE&&await c.launchApp({clearState:!0}),M&&(X?c.prepareRecording():await c.startRecording()),r&&await c.startProfile(),m&&(await E.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(R),r&&(_=await c.stopProfile()),await c.waitForRecordingTail({maxMs:St,smart:m}),M&&(F=await c.stopRecording(),L=c.getLastRecordingDurationMs()),m&&(O=await E.send({type:"evaluate",simId:c.simId,code:`(() => {
+          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+          return r?.stop?.() ?? []
+        })()`}),console.log(`  captured ${O.length} replay events`),j=w.join(s,"preview-final.png"),await c.captureScreenshot(j),console.log(`  final screenshot: ${j}`));let d=R.filter(y=>y&&typeof y=="object"&&"takeScreenshot"in y).length;console.log(`
+  + completed (${R.length} steps)`),d>0&&console.log(`  screenshots: ${d} \u2192 ${s}`),_&&mt(_),F&&console.log(`  video: ${F}`),console.log()}catch(h){if(r&&!_)try{_=await c.stopProfile()}catch{}if(M&&!F)try{F=await c.stopRecording(),L=c.getLastRecordingDurationMs()}catch(d){console.warn(`  recording stop failed: ${d?.message||String(d)}`)}if(m&&!O)try{O=await E.send({type:"evaluate",simId:c.simId,code:`(() => {
+            const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+            return r?.stop?.() ?? []
+          })()`}),console.log(`  captured ${O.length} partial replay events`)}catch(d){console.warn(`  event recorder stop failed: ${d?.message||String(d)}`)}console.error(`
+  x failed: ${h.message}
+`),_&&(console.log("  partial profile:"),mt(_)),F&&console.log(`  partial video: ${F}`);try{let d=c.lastFailedStep,y=d?`step-${String(d.index+1).padStart(2,"0")}-${d.kind}`:"unstaged",I=w.join(s,y);await c.captureFailureBundle(I,{error:h,stepIndex:d?.index,stepKind:d?.kind,stepTarget:d?.target}),de=I,console.log(`  failure bundle: ${I}`),console.log("    (contents: screenshot.png, describe.json, a11y.txt, tree.txt, console.json, error.json)")}catch(d){try{let y=w.join(s,"error.png");await c.captureScreenshot(y),console.log(`  error screenshot: ${y}`)}catch{}console.log(`  (failure bundle capture failed: ${d instanceof Error?d.message:String(d)})`)}await Ke(E,{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}if(await c.liveStatus?.end(V===0?"passed":"failed"),m&&(V===0||F||O))try{let h=await er(O??[]),d=["--origin",P,"--events",h];k&&d.push("--public-origin",k),F&&d.push("--video",F),j&&d.push("--screenshot",j),F&&L&&Number.isFinite(L)&&(d.push("--video-duration-ms",String(Math.round(L))),d.push("--recorded-duration-ms",String(Math.round(L))));let y=c.getLastRecordingStartedAtMs();y&&Number.isFinite(y)&&d.push("--recording-started-at-ms",String(Math.round(y))),v.wsPort&&d.push("--port",String(v.wsPort)),c.simId&&d.push("--sim",c.simId),H&&d.push("--open"),$e&&d.push("--owner",$e),Pe&&d.push("--repo",Pe),d.push("--run-scope",wt),U&&d.push("--billing-kind",U),console.log(`
+  preparing preview upload\u2026`);let I=c.getFlowTraceSteps();I.length>0&&d.push("--timeline-events",await tr(I));let J=await rr(I,y);J&&d.push("--snapshot-manifest",J),de&&d.push("--failure-bundle",de);let D=c.getLastRecordingFrameStats();D&&d.push("--trace-frame-stats",await nr(D));let{runUpload:It}=await import("./upload-GMSZPWM6.js");Fe=await It(d,{})}catch(h){console.error(`  preview upload failed: ${h?.message||h}`),V=1}return Ie=c.getFlowTraceSteps(),E.close(),ae?(c.simId&&le.add(c.simId),await Qt(v.wsPort,v.commandTimeoutMs,[...le])):c.simId&&c.simId!==Z&&Ce(c.simId),await ce(),V}async function Qt(i,e,t){let r=[...new Set(t.filter(Boolean))];if(r.length===0)return;let n=me(i,{commandTimeoutMs:e});try{let o=await n.listSims(),a=r.filter(l=>o.some(p=>p.id===l&&p.readyState==="open"));if(a.length===0)return;let s=await it(n,i,e,a);await rt(o,a),s.closed.length>0&&console.log(`  closed flow sim(s): ${s.closed.join(", ")}`),s.remaining.length>0&&console.warn(`  warn: flow sim(s) still connected after close: ${s.remaining.join(", ")}`)}catch(o){console.warn(`  warn: failed to close flow sim(s): ${o instanceof Error?o.message:String(o)}`)}finally{n.close()}}async function er(i){let{gzipSync:e}=await import("zlib"),t=i.map(o=>JSON.stringify(o)).join(`
+`)+(i.length?`
+`:""),r=e(Buffer.from(t,"utf8")),n=w.join(z(),`sootsim-events-${Date.now()}.jsonl.gz`);return $.writeFileSync(n,r),console.log(`  events: ${i.length} written to ${n} (${r.length} bytes gz)`),n}async function tr(i){let{gzipSync:e}=await import("zlib"),t=i.map((a,s)=>({schemaVersion:1,t:a.endedAtMs,seq:1e6+s,context:"host",kind:"flow-step",id:`flow-step-${a.stepIndex}`,data:{stepIndex:a.stepIndex,stepNumber:a.stepIndex+1,stepName:a.stepName,...a.targetLabel?{targetLabel:a.targetLabel}:{},status:a.status,durationMs:a.durationMs,startedAtMs:a.startedAtMs,endedAtMs:a.endedAtMs,...a.error?{error:a.error}:{}}})),r=t.map(a=>JSON.stringify(a)).join(`
+`)+`
+`,n=e(Buffer.from(r,"utf8")),o=w.join(z(),`sootsim-flow-steps-${Date.now()}.jsonl.gz`);return $.writeFileSync(o,n),console.log(`  flow trace: ${t.length} step events written to ${o} (${n.length} bytes gz)`),o}async function rr(i,e){if(!e)return null;let t=i.flatMap(n=>n.screenshotPath?[{id:`flow-step-${n.stepIndex}`,label:n.targetLabel??`Step ${n.stepIndex+1}`,kind:"interaction",t:Math.max(0,n.endedAtMs-e),path:n.screenshotPath}]:[]);if(t.length===0)return null;let r=w.join(z(),`sootsim-flow-snapshots-${Date.now()}.json`);return $.writeFileSync(r,JSON.stringify(t)),console.log(`  flow snapshots: ${t.length} written to ${r}`),r}async function nr(i){let e=w.join(z(),`sootsim-frame-stats-${Date.now()}.json`);return $.writeFileSync(e,JSON.stringify(i)),console.log(`  frame stats: written to ${e}`),e}async function ir(i){let e=i[0],t=r=>i.find((n,o)=>i[o-1]===r);switch(e){case"start":{let{path:r,state:n}=ze();console.log("  flow draft started"),console.log(`  session: ${r}`),console.log(`  steps: ${n.steps.length}`);return}case"keep":case"good":{let r=be();if(r.active||(console.error("  no active flow draft \u2014 run `sootsim maestro 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")||(i[1]&&!i[1].startsWith("-")?i[1]:void 0),n=i.includes("--validate")||i.includes("--video"),o=i.includes("--video"),a=be();a.active&&a.kept&&console.log(`  auto-kept trailing action: ${a.candidate.summary}`);let s=Ye(r||(n?sr():void 0));if(s.active||(console.error("  no active flow draft \u2014 run `sootsim maestro start` first"),process.exit(1)),!s.valid){console.error("  flow draft is not valid:");for(let l of s.issues)console.error(`    - ${l}`);console.error("  draft preserved \u2014 keep at least one real interaction or run `sootsim maestro start` to reset"),process.exit(1)}if(n){let l=ar(i,s.outputPath),p=await gt(l);if(p!==0){console.error(`
+  validation failed \u2014 draft preserved so you can keep iterating`),process.exitCode=p;return}ye(),console.log(`  flow draft validated (${s.stepCount} step${s.stepCount===1?"":"s"})`),s.outputPath&&console.log(`  saved: ${s.outputPath}`),o&&console.log("  video: recorded during validation run");return}if(ye(),console.log(`  flow draft ended (${s.stepCount} step${s.stepCount===1?"":"s"})`),s.outputPath){console.log(`  saved: ${s.outputPath}`),console.log(`  next: sootsim maestro test ${s.outputPath} --record`);return}console.log(""),process.stdout.write(s.yaml);return}case"validate":{let r=i[1];(!r||r.startsWith("-"))&&(console.error("  usage: sootsim maestro validate <path>"),process.exit(1));let n=we(r);if(n.length>0){console.error(`  x ${r} failed validation:`);for(let o of n)console.error(`    - ${o}`);process.exit(1)}console.log(`  + ${r} looks valid`);return}}}function or(i){return i[0]==="--sim"&&i.length>=2?[...i.slice(2),"--sim",i[1]]:i}async function Vr(i){let e=or(i),t=e[0];if(t==="start"||t==="keep"||t==="good"||t==="end"||t==="validate")return await ir(e),0;let r=await gt(e);return r!==0&&(process.exitCode=r),r}function mt(i){console.log(""),ot(i)}function sr(){return w.join(z(),`sootsim-flow-draft-${Date.now()}.yaml`)}function ar(i,e){if(!e)throw new Error("validated flow draft requires an output path");let t=[e];for(let r=1;r<i.length;r++){let n=i[r];if(!(n==="--validate"||n==="--video")){if(n==="--output"){r+=1;continue}r===1&&!n.startsWith("-")||t.push(n)}}return!t.includes("--record")&&i.includes("--video")&&t.push("--record"),t}export{ut as a,Ot as b,Wr as c,jr as d,Xt as e,gt as f,or as g,Vr as h};