sootsim 0.1.112 → 0.1.113

package/dist-cli/chunks/inspect-FVGSOR3L.js

@@ -1,980 +0,0 @@
-/*! sootsim v0.1.112 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as V}from"./chunk-3EE7UVER.js";import{a as gt,b as yt}from"./chunk-YEG6THC2.js";import{a as Ue,h as he,k as oe}from"./chunk-ERD5IQRP.js";import{b as ht,c as bt,j as wt}from"./chunk-UFHLNGFE.js";import"./chunk-QTVNFT2F.js";import{a as Q,b as E,c as C,d as _e,e as re,f as X,g as ye,h as ue,i as mt,j as pt,k as Ae,l as ft}from"./chunk-5DW7CLVT.js";import{B as ct,D as le,E as dt,K as ut,a as ge,b as Ke,c as ze,d as Ye,e as Ge,f as Xe,g as Ve,h as Qe,i as Ie,j as Ne,n as Fe,o as Ze,p as et,q as tt,r as ot,s as st,t as nt,u as rt,v as it,w as at,x as lt}from"./chunk-DKZKYTOM.js";import"./chunk-QJL6QTAW.js";import{c as Le,e as qe,f as We,g as He,h as Me}from"./chunk-P37J53P3.js";import{b as Je}from"./chunk-RY25ZLAP.js";import"./chunk-FTRDTDJF.js";import"./chunk-ZTBVBNY2.js";import"./chunk-ILDC36C5.js";import"./chunk-UQ4WCJOG.js";import"./chunk-TOETDEFL.js";import{a as Be}from"./chunk-KSQTJY3Z.js";import{a as ke,c as Te}from"./chunk-FKL3NMR5.js";import{a as je}from"./chunk-2ZZUG4LB.js";import"./chunk-MACTWR2J.js";import"./chunk-DY7HYEEP.js";import"./chunk-MSZWCIEH.js";import{existsSync as so,mkdirSync as no,readFileSync as ro,rmSync as xt,writeFileSync as io}from"fs";import{tmpdir as ao}from"os";import{dirname as lo,join as co,resolve as uo}from"path";var me=1,mo="SOOTSIM_INSPECT_NOTICE_PATH",po=300*1e3,fo=15e3;function $t(){return uo(process.env[mo]||co(ao(),"sootsim-inspect-notice-state.json"))}function go(o,c){return Object.fromEntries(Object.entries(o).filter(([,i])=>typeof i?.signature=="string"&&Number.isFinite(i?.updatedAt)&&c-i.updatedAt<=po))}function yo(o){let c=$t();if(!so(c))return{version:me,entries:{}};try{let i=JSON.parse(ro(c,"utf8"));return i.version!==me||!i.entries||typeof i.entries!="object"?(xt(c,{force:!0}),{version:me,entries:{}}):{version:me,entries:go(i.entries,o)}}catch{return xt(c,{force:!0}),{version:me,entries:{}}}}function ho(o){let c=$t();no(lo(c),{recursive:!0}),io(c,JSON.stringify(o,null,2)+`
-`)}function bo(o,c){let i=c.trim()||"default";return`${o}:${i}`}function Pe(o,c,i,l={}){let f=l.nowMs??Date.now(),a=l.cooldownMs??fo,g=yo(f),b=bo(o,c),k=g.entries[b];return k&&k.signature===i&&f-k.updatedAt<a?!1:(g.entries[b]={signature:i,updatedAt:f},ho(g),!0)}async function vt(o,c={args:[]}){let i=await ze(o);if(E(c.args)){C(i);return}console.log(`  nodes: ${i.nodes}`)}function Oe(o,c){let i=o.indexOf(c);return i>=0&&i+1<o.length?o[i+1]:null}async function St(o){let{bridge:c,args:i,positional:l}=o,f=i.includes("--verbose")||i.includes("-v"),a=E(i),g=f&&!a,b=i.includes("--watch")||i.includes("-w"),k=1e3,M=i.includes("--compact"),h=i.includes("--no-xy"),S=i.includes("--no-clipped"),_=i.includes("--include-occluded"),T=Oe(i,"--testid-like"),R=Oe(i,"--only"),J=Oe(i,"--subtree"),u=l[1]&&!l[1].startsWith("-")?l[1]:void 0,Y=u?/[*?]/.test(u):!1,j=!Y&&!R?u:void 0,D=R??(Y?u:void 0),Z=async()=>{await ye(c,{verbose:g});let $=await Xe(c,{describe:!0,verbose:f,filter:j||"",testIdLike:T||void 0,onlyGlob:D||void 0,subtreeRoot:J||void 0,compact:M,hideXy:h,includeOccluded:_}),I=$?.tree,W=$?.shell,L=$?.keyboard;if(a){C({shell:W,tree:I??"",keyboard:L});return}if(W&&typeof W=="object"){let B=[W.state?`state=${W.state}`:null,W.activeApp?`app=${W.activeApp}`:null,W.showSwitcher?"switcher":null,W.switcherPhase&&W.switcherPhase!=="idle"?`phase=${W.switcherPhase}`:null].filter(Boolean);B.length>0&&console.log(`  shell: ${B.join(" ")}`)}if(typeof I=="string"&&I.startsWith("__SUBTREE_NOT_FOUND__:")){let B=I.slice(22);console.log(`  subtree root not found: ${B}`),V("subtree-root-not-found",B);return}if(!I){let B=$?.nodeCount??0;console.log("  no matching nodes found"),!(j||T||D||J)&&B<10&&V("app-still-loading",B);return}let z=I,te=0;if(S&&typeof z=="string"){let B=z.split(`
-`),ae=[];for(let ce of B){if(ce.includes("(clipped:")){te+=1;continue}ae.push(ce)}z=ae.join(`
-`)}console.log(z),te>0&&console.log(`  ${te} clipped row(s) hidden (omit --no-clipped to see)`);let ne=j||T||D||J;if((j||T||D)&&!b&&V("describe-filter-context"),!ne&&!b&&I.split(`
-`).length>=80&&V("describe-use-filters"),L&&L.visible){let B=L.spec,ae=[B?.keyboardType?`type=${B.keyboardType}`:null,B?.returnKeyType&&B.returnKeyType!=="default"?`return=${B.returnKeyType}`:null,L.mode!=="letters"?`mode=${L.mode}`:null,L.shifted?"shift":null,L.capsLock?"caps":null,B?.autoCapitalize&&B.autoCapitalize!=="sentences"?`autoCap=${B.autoCapitalize}`:null,L.accessoryBarId?`accessory=${L.accessoryBarId}`:null].filter(Boolean);console.log(`
-  keyboard: ${ae.join(" ")||"visible"}`)}};if(b)for(console.log(`  watching... (Ctrl+C to stop)
-`);;)console.clear(),await Z(),await Q(k);else await Z()}var wo=["SOOTSIM_AGENT","CLAUDECODE","CLAUDE_CODE_ENTRYPOINT","CLAUDE_CODE_SESSION_ID","CODEX_THREAD_ID","CURSOR_TRACE_ID","AIDER_MODEL"];function be(){if(process.env.SOOTSIM_AGENT==="0")return!1;for(let o of wo){let c=process.env[o];if(c&&c.trim()&&c!=="0")return!0}return!1}async function kt(o){let{bridge:c,args:i,effectiveArgs:l,positional:f,inspectUsage:a}=o,g=$=>{let I=l.indexOf($);return I>=0&&I+1<l.length?l[I+1]:null},b=$=>l.includes($),k=g("--testid")||g("--test-id"),M=g("--role"),h=g("--type"),S=g("--text"),_=b("--pressable"),T=b("--visible"),R=b("--interactive-targets")||b("--actions"),J=!k&&!M&&!h&&!S&&!_&&!T&&!R?f[1]:null,u=S??J,Y=await Qe(c,{testId:k,role:M,type:h,text:u,pressable:_,visible:T,interactive:R});Y||(console.error(a("find","<text> | --text <t> | --testid <id> | --role <r> | --type <t> | --pressable | --visible | --interactive-targets")),process.exit(1));let{mode:j,result:D}=Y,Z=E(i),ee=i.includes("--verbose")||i.includes("--dump");if(Z)j==="interactive-targets"&&Array.isArray(D)?C(Ie(D).map($=>({...$,tap:Ne($)}))):C(D??null);else if(Array.isArray(D))if(D.length===0){console.log(`  no ${j} nodes found`);let $=await c.send({type:"evaluate",code:"(async () => (await window.__sootsimTest?.getNodeCount?.()) || 0)()"});typeof $=="number"&&$<10&&V("app-still-loading",$)}else if(j==="interactive-targets"){let $=Ie(D);console.log(`  found ${$.length} interactive target${$.length===1?"":"s"} (sorted by score):`);for(let I of $.slice(0,20)){let W=I.absolutePosition?`@(${Math.round(I.absolutePosition.x)},${Math.round(I.absolutePosition.y)})`:"",L=I.layout?`${Math.round(I.layout.width)}x${Math.round(I.layout.height)}`:"?x?",z=I.text?` "${I.text.slice(0,30)}"`:"",te=I.testID?` #${I.testID}`:"",ne=I.accessibilityLabel?` \u24D8"${String(I.accessibilityLabel).slice(0,24)}"`:"",fe=I.accessibilityRole?`[${I.accessibilityRole}]`:I.type,B=Ne(I);console.log(`    ${fe}${z}${ne}${te} ${L} ${W}`),console.log(`      \u2192 ${B}`),ee&&console.log(Re(JSON.stringify(I,null,2),"      "))}$.length>20&&console.log(`    ... and ${$.length-20} more`)}else{console.log(`  found ${D.length} node${D.length===1?"":"s"} (${j}):`);for(let $ of D.slice(0,20)){let I=$.absolutePosition?`@(${Math.round($.absolutePosition.x)},${Math.round($.absolutePosition.y)})`:"",W=$.layout?`${Math.round($.layout.width)}x${Math.round($.layout.height)}`:"?x?",L=$.text?` "${$.text.slice(0,30)}"`:"",z=$.testID?` #${$.testID}`:"",te=$.pressable?" (tap)":"",ne=$.accessibilityRole?`[${$.accessibilityRole}]`:$.type;console.log(`    ${ne}${L}${z} ${W} ${I}${te}`),ee&&console.log(Re(JSON.stringify($,null,2),"      "))}D.length>20&&console.log(`    ... and ${D.length-20} more`)}else if(D==null)console.log(`  not found: ${u||k||M||h||""||j}`),k&&V("wait-selector-for-missing-testid",k);else{let $=D;if($.type&&$.absolutePosition){let I=`@(${Math.round($.absolutePosition.x)},${Math.round($.absolutePosition.y)})`,W=$.layout?`${Math.round($.layout.width)}x${Math.round($.layout.height)}`:"?x?",L=$.text?` "${$.text.slice(0,40)}"`:"",z=$.testID?` #${$.testID}`:"",te=$.pressable?" (tap)":"",ne=$.accessibilityRole?`[${$.accessibilityRole}]`:$.type;console.log(`  ${ne}${L}${z} ${W} ${I}${te}`),ee&&console.log(Re(JSON.stringify($,null,2),"    "))}else console.log(JSON.stringify(D,null,2))}}function Re(o,c){return o.split(`
-`).map(i=>c+i).join(`
-`)}async function Tt(o,c={}){let i=await ct(o);if("error"in i&&(console.error(i.error),process.exit(1)),c.json){console.log(JSON.stringify(i,null,2));return}let{visible:l,spec:f,mode:a,shifted:g,capsLock:b,accessoryBarId:k}=i,M=[];M.push(`keyboard: ${l?"visible":"hidden"}`),f?(M.push(`  type:          ${f.keyboardType}`),M.push(`  returnKey:     ${f.returnKeyType}`),M.push(`  autoCap:       ${f.autoCapitalize}`),M.push(`  autoCorrect:   ${f.autoCorrect?"on":"off"}`),M.push(`  appearance:    ${f.keyboardAppearance}`),f.secureTextEntry&&M.push("  secureTextEntry: true"),f.enablesReturnKeyAutomatically&&M.push(`  return:        ${f.currentTextIsEmpty?"disabled (empty)":"enabled"}`)):M.push("  spec:          <none> (shown via dev-tools with no TextInput)"),M.push(`  mode:          ${a}${g?" (shifted)":""}${b?" (caps)":""}`),k&&M.push(`  accessoryBar:  ${k}`),console.log(M.join(`
-`))}async function Mt(o){let c=await o.bridge.listSims(),i=o.args.includes("--all"),l=o.args.find((b,k)=>o.args[k-1]==="--bundle"),f=o.args.find((b,k)=>o.args[k-1]==="--app-port"),a=o.args.includes("--primary"),g=c.filter(b=>!(a&&!b.isPrimary||l&&!(b.url??"").includes(l)||f&&!(b.url??"").includes(`/rn/${f}`)||!i&&!l&&!f&&!a&&!(b.url&&(b.url.includes("bundle=")||b.url.includes("/index.bundle")))&&b.id!==o.simId));if(E(o.args)){C(g.map(b=>({...b,active:b.id===o.simId})));return}wt(g,o.simId),g.length<c.length&&!E(o.args)&&console.log(`  (${c.length-g.length} more hidden \u2014 pass --all to show)`)}function ie(o){return o<1024?`${o}B`:o<1024*1024?`${(o/1024).toFixed(1)}KB`:`${(o/1024/1024).toFixed(1)}MB`}function we(o,c){return c<=0?"?":`${(o/c*100).toFixed(0)}%`}async function It(o,c={args:[]}){let i=await ut(o);if(E(c.args)){C(i);return}if(console.log("  memory:"),i.imageLoader){let l=i.imageLoader;console.log("    image-loader cache"),console.log(`      entries:        ${l.cacheEntries} / ${l.cacheMaxEntries} (${we(l.cacheEntries,l.cacheMaxEntries)})`),console.log(`      pixel bytes:    ${ie(l.cachePixelBytes)} / ${ie(l.cachePixelBudget)} (${we(l.cachePixelBytes,l.cachePixelBudget)})`),console.log(`      pending:        ${l.pendingFetches} fetches, ${l.pendingBytes} bytes`),console.log(`      failed uris:    ${l.failedUris}`),console.log(`      snapshots:      ${l.snapshots}`),console.log(`      camera frames:  ${l.cameraFrames}`)}else console.log("    image-loader cache: not available (engine pre-rebuild?)");if(i.workerHeap){let l=i.workerHeap;console.log("    worker heap (chrome only)"),console.log(`      used:   ${ie(l.usedJSHeapSize)} / ${ie(l.jsHeapSizeLimit)} (${we(l.usedJSHeapSize,l.jsHeapSizeLimit)})`),console.log(`      total:  ${ie(l.totalJSHeapSize)}`)}if(i.hostHeap){let l=i.hostHeap;console.log("    host heap (chrome only)"),console.log(`      used:   ${ie(l.usedJSHeapSize)} / ${ie(l.jsHeapSizeLimit)} (${we(l.usedJSHeapSize,l.jsHeapSizeLimit)})`),console.log(`      total:  ${ie(l.totalJSHeapSize)}`)}}function pe(o){let c=o.indexOf("--testid");if(c>=0&&o[c+1])return{mode:"testid",value:o[c+1]};let i=o.indexOf("--test-id");if(i>=0&&o[i+1])return{mode:"testid",value:o[i+1]};let l=o.indexOf("--text");return l>=0&&o[l+1]?{mode:"text",value:o[l+1]}:null}async function xe(o,c){let i=JSON.stringify(c.value),l=c.mode==="testid"?`(await t.findByTestId(${i})) || (await t.findById(${i}))`:`await t.findByText(${i})`;return await o.send({type:"evaluate",code:`(async () => {
-      const t = window.__sootsimTest
-      if (!t) return null
-      const n = ${l}
-      if (!n || !n.absolutePosition || !n.layout) return null
-      const resolved =
-        typeof n.nodeId === 'number' && typeof t.resolveTapTarget === 'function'
-          ? await t.resolveTapTarget(n.nodeId)
-          : null
-      const cx =
-        typeof resolved?.cx === 'number'
-          ? resolved.cx
-          : n.absolutePosition.x + (n.layout.width || 0) / 2
-      const cy =
-        typeof resolved?.cy === 'number'
-          ? resolved.cy
-          : n.absolutePosition.y + (n.layout.height || 0) / 2
-      return {
-        x: cx,
-        y: cy,
-        id: n.id ?? null,
-        testID: n.testID ?? null,
-        text: ${JSON.stringify(c.mode==="text")} ? ${i} : (n.text ?? n.accessibilityLabel ?? null),
-        type: n.type ?? null,
-      }
-    })()`})??null}async function Nt(o,c={}){let{nav:i,keyboard:l,shell:f}=await dt(o);if(c.json){console.log(JSON.stringify({shell:f??null,nav:i,keyboard:l},null,2));return}let a=[];if(f){let g=f.activeApp??f.state??"<none>",b=f.showSwitcher?" (app switcher open)":"",k=typeof f.launchProgress=="number"&&f.launchProgress<.98?` launching (${Math.round(f.launchProgress*100)}%)`:"";a.push(`shell:    ${g}${b}${k}`)}else a.push("shell:    <unavailable>");if(i){let g=i.transitionPhase!=="idle"?` (${i.transitionPhase}, ${i.activeTransitionCount} active)`:"";if(a.push(`nav:      phase=${i.transitionPhase}${g}`),i.screens.length===0)a.push("  <no registered screens \u2014 app may not use react-native-screens>");else for(let b of i.screens){let k=b.isActive?"\u25B6":" ",M=b.routeName?` ${b.routeName}`:"",h=b.headerHeight>0?` header=${b.headerHeight}`:"",S=b.largeTitleState&&b.largeTitleState!=="expanded"?` large-title=${b.largeTitleState}`:"";a.push(`  ${k} #${b.id}${M}${h}${S}`)}}else a.push("nav:      <runtime not available>");if(l&&l.visible){let g=l.spec?.keyboardType??"default",b=l.spec?.returnKeyType??"default";a.push(`keyboard: visible (${g}, return=${b}, mode=${l.mode??"?"})`)}else a.push("keyboard: hidden");console.log(a.join(`
-`))}async function Ft(o){let{bridge:c,args:i,positional:l}=o,f=l[1]?Number(l[1])*1e3:3e3,a=i.includes("--strict"),{elapsed:g,settled:b}=await oe({bridge:c,maxMs:f,strict:a});console.log(b?`  settled in ${g}ms`:`  timed out after ${g}ms (may still be animating)`)}async function _t(o){let c=o.positional[1]?Number(o.positional[1]):.5;(!Number.isFinite(c)||c<0)&&(console.error(o.inspectUsage("sleep","[seconds]")),process.exit(1)),await Q(c*1e3),console.log(`  slept ${c}s`)}async function At(o){let{bridge:c,args:i,positional:l}=o,f=l[1]?Number(l[1]):5,{tree:a}=await Ye(c,f);if(E(i)){C({depth:f,tree:a??null});return}console.log(typeof a=="string"?a:JSON.stringify(a,null,2))}async function Pt(o,c={args:[]}){let i=await Ge(o);if(E(c.args)){C(i);return}console.log(i.url)}async function Ot(o){let{wsPort:c,commandTimeoutMs:i,simId:l,simIdSource:f,positional:a}=o,g=a[1]?Number(a[1]):30,b=Math.max(1e3,(Number.isFinite(g)?g:30)*1e3),k=Math.max(1,Math.ceil(b/500));console.log("  waiting for sim reconnect...");let M=await mt(c,i,l,{attempts:k,simIdSource:f});M||(console.error("  timed out waiting for sim reconnect"),process.exit(1)),M.bridge.close(),he({source:"inspect wait",step:{wait:b},summary:`wait ${Math.round(b/1e3)}s`}),console.log(`  ready: ${M.count} nodes`)}var Rt=new Set(["app-launch","toast","keyboard","screen","route","alert","actionsheet","picker","notification","fetch","console","shell","scroll","gesture","text-input","react-commit","animation","reanimated"]);function $e(o,c){let i=o.indexOf(c);if(i>=0&&i+1<o.length)return o[i+1]}function xo(o,c){if(!c.filter&&!c.equals)return!0;let i=o.data,l=[];if(i&&typeof i=="object")for(let a of["url","displayUrl","message","name","activeName","path","pathname","title","phase","event","type","kind"]){let g=i[a];typeof g=="string"&&g.length>0&&l.push(g)}let f=l.join(" ");return c.equals?l.some(a=>a===c.equals):c.filter?f.toLowerCase().includes(c.filter.toLowerCase()):!0}async function Et(o){let{bridge:c,args:i,positional:l,inspectUsage:f}=o,a=l[1];a||(console.error(f("wait event","<kind> [--max-ms 5000] [--filter <substring>] [--equals <exact>] [--since now|cursor]")),process.exit(1)),Rt.has(a)||console.error(`  warning: '${a}' is not a known timeline kind \u2014 waiting anyway. known: ${[...Rt].sort().join(", ")}`);let g=$e(i,"--max-ms"),b=g&&Number.isFinite(Number(g))?Math.max(100,Number(g)):5e3,k=$e(i,"--filter"),M=$e(i,"--equals"),h=$e(i,"--since")??"now",S=i.includes("--json"),_=Date.now(),T=_+b,R=200,J=_;for(;Date.now()<T;){let Y={kinds:[a],since:h==="cursor"?void 0:J,limit:50},j=await c.send({type:"evaluate",code:`(async () => {
-        const t = window.SootSim?.bridges?.timeline
-        if (!t) return { ok: false, error: 'timeline bridge missing' }
-        return { ok: true, result: await t.recent(${JSON.stringify(Y)}) }
-      })()`});(!j||!j.ok)&&(console.error(`  could not query timeline: ${j&&"error"in j?j.error:"unknown"}`),process.exit(1));let D=j.result.events??[];for(let Z of D)if(xo(Z,{filter:k,equals:M})){let ee=Date.now()-_;console.log(S?JSON.stringify({found:!0,elapsedMs:ee,event:Z}):`  ${a} event after ${ee}ms${k?` (filter: ${k})`:""}${M?` (equals: ${M})`:""}`);return}j.result.watermark&&j.result.watermark>J&&(J=j.result.watermark),await new Promise(Z=>setTimeout(Z,R))}let u=Date.now()-_;S?console.log(JSON.stringify({found:!1,elapsedMs:u,kind:a,filter:k,equals:M})):console.error(`  \u26A0 wait event ${a} timed out after ${u}ms${k?` (filter: ${k})`:""}${M?` (equals: ${M})`:""}`),process.exit(1)}async function Ct(o){let{bridge:c,args:i}=o,l=i.includes("--strict"),f=ge(i,3e3),{elapsed:a,settled:g}=await oe({bridge:c,maxMs:f,strict:l});g?console.log(`  idle in ${a}ms`):(console.error(`  \u26A0 wait idle timed out after ${a}ms (may still be animating)`),process.exit(1))}async function Dt(o){let{bridge:c,args:i}=o,l=ge(i,2e4),{ready:f,elapsedMs:a,nodes:g,targets:b,flag:k,loadingText:M,externalReady:h,externalError:S,errors:_}=await Ze(c,l,{onProgress(R){console.error(`  still waiting after ${R.elapsedMs}ms \u2014 ${Fe(R)} (nodes: ${R.nodes}, targets: ${R.targets}, errors: ${R.errors})`)}});if(f){let R=l-a,J=Math.max(100,Math.min(1e4,R)),u=await oe({bridge:c,maxMs:J,pollMs:32,stablePolls:2});u.settled||(console.error(`  \u26A0 wait ready timed out after ${a+u.elapsed}ms \u2014 app mounted but did not settle (nodes: ${g}, targets: ${b})`),process.exit(1)),console.log(`  ready in ${a+u.elapsed}ms: ${g} nodes, ${b} targets`);return}let T=Fe({externalError:S,loadingText:M,externalReady:h,flag:k,targets:b});console.error(`  \u26A0 wait ready timed out after ${a}ms \u2014 ${T} (nodes: ${g}, targets: ${b}, errors: ${_})`),process.exit(1)}async function Bt(o){let{bridge:c,args:i,positional:l,inspectUsage:f}=o,a=l[1];a||(console.error(f("wait selector","<testid> [--max-ms 5000] [--gone]")),process.exit(1));let g=i.indexOf("--max-ms"),b=g>=0&&i[g+1]?Math.max(100,Number(i[g+1])):5e3,k=i.includes("--gone"),{found:M,node:h,elapsed:S}=await et(c,a,b,{gone:k});if(k){M?console.log(`  #${a} gone after ${S}ms`):(console.error(`  \u26A0 wait selector #${a} --gone timed out after ${S??b}ms (still present)`),process.exit(1));return}if(M&&h){let _=h.absolutePosition?`@(${Math.round(h.absolutePosition.x)},${Math.round(h.absolutePosition.y)})`:"",T=h.layout?`${Math.round(h.layout.width)}x${Math.round(h.layout.height)}`:"?x?";console.log(`  found #${a} in ${S}ms ${T} ${_}`)}else console.error(`  \u26A0 wait selector #${a} timed out after ${S??b}ms`),process.exit(1)}function Kt(o){return o==null?"\u2014":o<1024?`${o}B`:o<1024*1024?`${(o/1024).toFixed(1)}K`:`${(o/1024/1024).toFixed(1)}M`}function zt(o){return o==null?"   \u2026":o<1e3?`${o}ms`.padStart(5):`${(o/1e3).toFixed(2)}s`.padStart(5)}function jt(){process.stderr.write(`  the sim is not responding. recover it with:
-    sootsim close --sim <id>   # force-close the wedged sim
-    sootsim list               # confirm it's gone
-`)}async function vo(o){try{return await o.send({type:"evaluate",code:"1"},{timeoutMs:3e3}),!0}catch{return!1}}async function So(o,c){try{let i=await o.send({type:"evaluate",code:`(async () => {
-        const t = window.__sootsimTest
-        if (!t || typeof t.queryAll !== 'function') return []
-        try {
-          // queryAll is async in render-worker mode (the canonical mode now)
-          // because the call has to round-trip the worker \u2014 must await it.
-          // a sync result is still handled fine since await on a non-Promise
-          // is a no-op.
-          const nodes = await t.queryAll({})
-          if (!Array.isArray(nodes)) return []
-          const out = new Set()
-          for (const n of nodes) {
-            const id = n && (n.testID || n.id)
-            if (typeof id === 'string' && id) out.add(id)
-          }
-          return Array.from(out)
-        } catch {
-          return []
-        }
-      })()`});if(!Array.isArray(i)||i.length===0)return;let l=c.toLowerCase(),f=i.map(a=>({id:a,score:ko(l,a.toLowerCase())})).filter(a=>a.score<l.length+4).sort((a,g)=>a.score-g.score).slice(0,5);if(f.length===0)return;console.error("  similar testIDs:");for(let a of f)console.error(`    ${a.id}`)}catch{}}function ko(o,c){if(c===o)return 0;if(c.includes(o))return 1;if(o.includes(c))return 2;let i=0;for(;i<o.length&&i<c.length&&o[i]===c[i];)i+=1;return To(o,c)-i}function To(o,c){if(o===c)return 0;if(!o.length)return c.length;if(!c.length)return o.length;let i=new Array(c.length+1),l=new Array(c.length+1);for(let f=0;f<=c.length;f++)i[f]=f;for(let f=1;f<=o.length;f++){l[0]=f;for(let g=1;g<=c.length;g++)l[g]=Math.min(i[g]+1,l[g-1]+1,i[g-1]+(o[f-1]===c[g-1]?0:1));let a=i;i=l,l=a}return i[c.length]}function Mo(o){return o.error?"err":o.status==null?" \u2026 ":String(o.status)}function Io(o){return o.externalError?`guest app errored: ${o.externalError}`:o.loadingText?`still showing "${o.loadingText}"`:o.externalReady===!1?"guest app is still loading":o.flag!==!0?"guest app has not emitted sootsim:externalAppReady":o.targets<=0?"ready flag emitted but no visible app content is inspectable yet":"node tree is still changing"}function Jt(o){let c=re(o.startTs),i=Mo(o).padEnd(3),l=o.method.padEnd(5),f=Kt(o.size).padStart(6),a=zt(o.durationMs);console.log(`  [${c}] ${i} ${l} ${f} ${a}  ${o.displayUrl}`),o.error&&console.log(`           error: ${o.error}`)}function No(o){let c=[["id",o.id],["source",o.source],["kind",o.kind],["method",o.method],["status",o.error?`error: ${o.error}`:`${o.status??"\u2014"} ${o.statusText??""}`.trim()],["url",o.url],["started",re(o.startTs)],["duration",zt(o.durationMs).trim()],["size",Kt(o.size)],["content-type",o.type??"\u2014"]];for(let[i,l]of c)console.log(`  ${i.padEnd(13)} ${l}`)}var Fo={error:"\x1B[31m",warn:"\x1B[33m",info:"\x1B[36m",debug:"\x1B[35m",log:"\x1B[37m"},Lt="\x1B[0m",_o="\x1B[2m";function qt(o,c){let i=re(o.ts),l=o.level.toUpperCase().padEnd(5),f=o.args.join(" ");if(c){let a=Fo[o.level];console.log(`  ${_o}[${i}]${Lt} ${a}${l}${Lt}  ${f}`)}else console.log(`  [${i}] ${l}  ${f}`);if(o.stack&&o.level==="error"){let a=o.stack.split(`
-`).slice(0,5);for(let g of a)console.log(`    ${g.trim()}`)}}var se="__sootsimCliPerf",Ao=120;async function Wt(o,c){let i=o.find((_,T)=>o[T-1]==="--id"),l=o.find((_,T)=>o[T-1]==="--text");if(i||l){let _=await c.send({type:"evaluate",code:gt({id:i,text:l})});if(!_)throw new Error(i?`no node with id "${i}"`:`no node matching text "${l}"`);let{x:T,y:R,w:J,h:u}=_;return{x:T,y:R,w:J,h:u}}let f=o.find((_,T)=>o[T-1]==="--area");if(f){let _=f.split(",").map(Y=>Number(Y.trim()));if(_.length!==4||_.some(Y=>!Number.isFinite(Y)))throw new Error(`--area expects x,y,w,h (got "${f}")`);let[T,R,J,u]=_;return{x:T,y:R,w:J,h:u}}let a=_=>{let T=o.find((J,u)=>o[u-1]===_);if(T==null)return null;let R=Number(T);return Number.isFinite(R)?R:null},g=a("--x"),b=a("--y"),k=a("--w"),M=a("--h");if(g!=null||b!=null||k!=null||M!=null)return{x:g??0,y:b??0,w:k??1,h:M??1};let S=o.filter((_,T)=>T>0&&!_.startsWith("-")&&o[T-1]!=="--output"&&o[T-1]!=="--area"&&o[T-1]!=="--id"&&o[T-1]!=="--text"&&o[T-1]!=="--x"&&o[T-1]!=="--y"&&o[T-1]!=="--w"&&o[T-1]!=="--h").map(Number).filter(_=>Number.isFinite(_));if(S.length>=2){let[_,T,R=1,J=1]=S;return{x:_,y:T,w:R,h:J}}return null}function Ee(o){let c={"<8":0,"8-12":0,"12-16":0,"16-20":0,"20-33":0,">33":0};for(let i of o)i<8?c["<8"]++:i<12?c["8-12"]++:i<16?c["12-16"]++:i<20?c["16-20"]++:i<33?c["20-33"]++:c[">33"]++;console.log("  histogram:");for(let[i,l]of Object.entries(c)){let f="\u2588".repeat(Math.ceil(l/o.length*40));console.log(`    ${i.padEnd(6)} ${f} ${l}`)}}async function ve(o,c,i){let l=Date.now()+c,f=await le(o,c);for(;;){if(i(f))return{settled:!0,state:f};if(Date.now()>=l)return{settled:!1,state:f};await Q(16),f=await le(o)}}async function De(o){return o.send({type:"evaluate",code:`(async () => {
-      const kb = window.__sootsimKeyboard
-      const test = window.__sootsimTest
-      if (!kb) return { error: 'keyboard bridge not available' }
-      const visible = kb.isVisible()
-      const mode = kb.getMode()
-      let focused = null
-      if (test && typeof test.getFocusedNode === 'function') {
-        try {
-          focused = await test.getFocusedNode()
-        } catch {}
-      }
-      let runtimeSnapshot = null
-      if (test && typeof test.getFocusKeyboardSnapshot === 'function') {
-        try {
-          runtimeSnapshot = await test.getFocusKeyboardSnapshot()
-        } catch {}
-      }
-      return {
-        visible,
-        mode,
-        focusedInput: focused ? {
-          nodeId: focused.nodeId ?? null,
-          testID: focused.testID || null,
-          id: focused.id || null,
-          placeholder: focused.placeholder || null,
-          text: focused.text || null,
-        } : null,
-        phase: runtimeSnapshot?.keyboard?.phase ?? null,
-        frame: runtimeSnapshot?.keyboard?.frame ?? null,
-        focusedRect: runtimeSnapshot?.focused?.rect ?? null,
-      }
-    })()`})}async function Po(o,c=600){let i=Date.now()+c;for(;Date.now()<=i;){let l=await De(o);if(l.visible)return l;await Q(30)}return De(o)}async function Se(o,c){let i=await De(o);if(i.visible)return i;console.error(`  ${c} requires the iOS keyboard to be visible. focus an input first with sootsim do tap-id/tap-text or sootsim do type-into.`),process.exit(1)}async function Ht(o,c,i){return c==="appearance"?o.send({type:"evaluate",code:`(async () => {
-        const requested = ${JSON.stringify(i??"toggle")}
-        const rootBg = (document.documentElement?.style?.background || '').toLowerCase()
-        const inferredCurrent = rootBg.includes('33') ? 'dark' : 'light'
-        let next = requested
-        if (requested === 'toggle') {
-          next = inferredCurrent === 'dark' ? 'light' : 'dark'
-        }
-        // engine accepts 'auto' since the schema picker landed; pass through.
-        window.postMessage({ type: 'soot-action', action: 'set-appearance', value: next }, '*')
-        const applied = next === 'auto'
-          ? (window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ? 'dark' : 'light')
-          : next
-        return { ok: true, requested, value: next, applied }
-      })()`}):o.send({type:"evaluate",code:`(async () => {
-      window.dispatchEvent(new CustomEvent(${JSON.stringify(c==="lock"?"sootsim:toggleLock":"sootsim:shake")}))
-      return { ok: true, action: ${JSON.stringify(c)} }
-    })()`})}function Oo(o){let c={Enter:"return",NumpadEnter:"return",Backspace:"delete",Delete:"delete",Space:"space",ShiftLeft:"shift",ShiftRight:"shift"};if(c[o])return c[o];let i=o.match(/^Digit([0-9])$/);if(i)return i[1];let l=o.match(/^Key([A-Z])$/);return l?l[1].toLowerCase():null}function Ro(o){if(typeof o!="string")return null;let c=o.replace(/\s+/g," ").trim();return c?c.slice(0,80):null}function Yt(...o){for(let c of o){if(typeof c!="string")continue;let i=c.trim();if(i)return i}return null}function Eo(o){let c=o.indexOf("--node-id");if(c<0)return null;let i=o[c+1];if(!i)return null;let l=Number(i);return Number.isInteger(l)&&l>0?l:null}async function q(o,c,i){let l=he({source:o,step:c,summary:i});l.active&&(l.replaced?console.error(`  draft: replaced unkept action "${l.replaced.summary}" \u2014 \`flow keep\` commits one action at a time`):console.error("  draft: action pending \u2014 `sootsim flow keep` to commit"))}function Ut(o,c,i){if(!i||i.hit===!1)return null;let l=Yt(i.responderTestID,i.testID);if(l)return{step:{tapOn:{id:l}},summary:`tap #${l}`};let f=Ro(i.text);return f?{step:{tapOn:f},summary:`tap "${f}"`}:{step:{tapAtCoords:{x:o,y:c}},summary:`tap @${Math.round(o)},${Math.round(c)}`}}function Ce(o,c,i){let l=Yt(c?.testID,c?.id);return l?{step:{tapOn:{id:l}},summary:`tap #${l}`}:i==="id"?{step:{tapOn:{id:o}},summary:`tap #${o}`}:{step:{tapOn:o},summary:`tap "${o}"`}}async function hn(o,c){let i=o[0]==="get"||o[0]==="do"||o[0]==="debug"||o[0]==="wait"?o[0]:null,l=i?o.slice(1):o,f=Le(l,{port:c.port,commandTimeoutMs:c.timeoutMs,stripBooleanFlags:["--verbose","-v","--help","-h","--clear-state","--json","--all","--watch","-w","--strict","--no-wait","--dump","--failed","--slow","--tail","-f","--interactive-targets","--actions","--internal","--compact","--no-xy","--no-clipped","--include-occluded"],stripValueFlags:["--output","--nth","--index","--testid","--test-id","--text","--node-id","--max-ms","--filter","--limit","--level","--threshold","--equals","--since","--testid-like","--only","--subtree"]}),a=f.positional,g=a[0],b=i==="get"||i==="do"||i==="debug"||i==="wait"?i:"inspect",k=typeof l[0]=="string"&&Be.has(l[0]),M=k?l[0]:null,h=e=>k&&e===l[0]?`sootsim ${e}`:`sootsim ${b} ${e}`,S=(e,t)=>`  usage: ${h(e)}${t?` ${t}`:""}`;if(!g||o.includes("--help")||o.includes("-h")){let e={bridgePort:7668,defaultShellUrl:je};if(b==="do"||b==="get"||b==="debug"||b==="wait"){let r=ke(b,e);r&&(console.log(`${r}
-`),process.exit(0))}if(M==="shell"){let r=Te("shell",e);r&&(console.log(`${r}
-`),process.exit(0))}let t=Te("inspect",e),n=["do","get","debug","wait"].map(r=>ke(r,e)).filter(r=>r!=null).join(`
-
-`);console.log(`${t??""}
-
-${n}
-`),process.exit(0)}let _=f.wsPort,T=f.simId,R=f.simIdSource,J=f.commandTimeoutMs;if(g==="list"&&l.some(e=>e==="--drivers"||e==="-D")){let{buildDriverListRows:e}=await import("./drivers-KJ55BQZI.js"),t=e();console.log(`  available drivers (${t.length}):
-`);let n=Math.max(...t.map(s=>s.id.length),6),r=Math.max(...t.map(s=>s.kind.length),4);for(let s of t){let d=s.available?"\u2713":"\u2717",m=s.id.padEnd(n),y=s.kind.padEnd(r);console.log(`  ${d} ${m}  ${y}  ${s.description}`),s.available&&s.detail?console.log(`    ${s.detail}`):!s.available&&s.reason&&console.log(`    unavailable: ${s.reason}`)}return}let u=qe(f),Y=T||"default",j=new Set(["errors","warnings","requests","js","eval","reload","globals","perf","list","wait","sleep"]),D=200;function Z(e){let t=e.replace(/\s+/g," ").trim();if(!t)return"";if(/^<(!doctype html|html|\?xml)|<body[\s>]/i.test(t)){let r=/<title[^>]*>([^<]+)<\/title>/i.exec(e)?.[1]?.trim(),s=/<body[^>]*>([\s\S]*?)<\//i.exec(e)?.[1]?.replace(/<[^>]+>/g," ").replace(/\s+/g," ").trim().slice(0,80),d=r||s||"html error page";return`<html ${e.length}B> "${d}" (body elided \u2014 add --json for the full payload)`}return t.length<=D?t:`${t.slice(0,D)}\u2026 (+${t.length-D} more bytes)`}function ee(e){let t=e.displayUrl||e.url;return e.status!=null?`${e.method} ${t} -> ${e.status}${e.statusText?` ${e.statusText}`:""}`:e.error?`${e.method} ${t} -> ${e.error}`:`${e.method} ${t}`}async function $(e){let t=be()?5e3:1500;try{let{settled:n,elapsed:r}=await oe({bridge:e,maxMs:t,pollMs:32,stablePolls:2});n||process.stderr.write(`  \u26A0 auto-wait timed out after ${r??t}ms \u2014 next command may see mid-animation state. use \`sootsim do settle\` for a longer wait.
-`)}catch{}}function I(e){return!(!e||e.hit===!1||e.ok===!1||e.pointerTapHandled===!1&&!e.keyboardOpened&&!e.isTextInput)}function W(e,t){return{id:e.target?.id??e.match?.id??e.node?.id??null,testID:e.target?.testID??e.match?.testID??e.node?.testID??null,text:e.target?.text??e.target?.accessibilityLabel??e.match?.text??e.match?.accessibilityLabel??e.node?.text??t??null,type:e.target?.type??e.match?.type??e.node?.type??null}}async function L(e){let t=0,n=null,r=null;try{await oe({bridge:u,maxMs:be()?3e3:1200,pollMs:32,stablePolls:2})}catch{}let s=Date.now()+(be()?5e3:2500);for(;Date.now()<=s||t===0;){t++;let d=await e.resolve();if(n=d,d?.error==="bridge-not-ready"||d?.ambiguous||d?.nthOutOfRange)return{payload:d,result:null,attempts:t,failure:"special"};if(d&&typeof d.cx=="number"&&typeof d.cy=="number"){let y=await u.send({type:"tap",x:d.cx,y:d.cy,target:W(d,e.textFallback)});if(r=y,I(y))return{payload:d,result:y,attempts:t}}let m=s-Date.now();if(m<=0)break;try{await oe({bridge:u,maxMs:Math.min(m,700),pollMs:32,stablePolls:2})}catch{await Q(Math.min(120,m))}}return{payload:n,result:r,attempts:t,failure:n&&typeof n.cx=="number"?"missed":"not-found"}}function z(e,t){console.error(`  tap failed: ${e} stayed visible but did not receive a hittable press after ${t.attempts} attempt${t.attempts===1?"":"s"}`),t.result&&console.error(`  last result: ${JSON.stringify(t.result)}`)}async function te(){try{return await u.send({type:"evaluate",code:`(() => ({
-          console: window.__sootsimConsole?.count?.() || null,
-          requests: window.__sootsimTest?.getRequestCounts?.() || null,
-        }))()`})||{console:null,requests:null}}catch{return{console:null,requests:null}}}async function ne(e={}){let t=e.counts!==void 0?e.counts:await X(u,"getRequestCounts");if(!t||typeof t!="object")return;let n=Math.max(0,Number(t.failed)||0);if(n===0||!e.includeTail&&!Pe("requests",Y,String(n))||(console.log(`
-  network: ${n} failed request${n===1?"":"s"}`),console.log(`  inspect: ${h("requests")} 5`),!e.includeTail))return;let r=await X(u,"getFailedRequests",5);if(!(!Array.isArray(r)||r.length===0)){console.log(`
-  recent failed requests:
-`);for(let s of r){let d=re(s.timestamp);console.log(`  [${d}] ${ee(s)}`),s.responseBody?console.log(`    ${Z(s.responseBody)}`):s.error&&console.log(`    ${s.error}`)}}}async function fe(e={}){let t=e.counts!==void 0?e.counts:await u.send({type:"evaluate",code:"window.__sootsimConsole?.count?.() || { errors: 0, warnings: 0, total: 0 }"});if(!t||typeof t!="object")return;let n=t,r=Math.max(0,Number(n.errors)||0),s=Math.max(0,Number(n.warnings)||0);if(r===0&&s===0||!e.includeTail&&!Pe("console",Y,`${r}:${s}`))return;let d=[];if(r>0&&d.push(`${r} console error${r===1?"":"s"}`),s>0&&d.push(`${s} console warning${s===1?"":"s"}`),console.log(`
-  console: ${d.join(", ")}`),console.log(`  inspect: ${h("errors")} 5`),s>0&&console.log(`  inspect: ${h("warnings")} 5`),!e.includeTail||r===0)return;let m=await u.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors?.(5) || []"});if(!(!Array.isArray(m)||m.length===0)){console.log(`
-  recent console errors:
-`);for(let y of m){let p=re(y.timestamp),x=Array.isArray(y.args)?y.args.map(A=>typeof A=="object"?JSON.stringify(A):String(A)).join(" "):String(y);console.log(`  [${p}] ${x}`)}}}let B=["console","fetch","toast","alert","notification","screen","app-launch","keyboard","route","actionsheet","picker","shell","scroll","gesture","text-input","animation","reanimated"];async function ae(e){let t=Je(),n=null;try{n=await He(e,`(() => {
-          const tl = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.timeline
-          if (!tl || typeof tl.summary !== 'function') return null
-          const cursorKey = ${JSON.stringify(t)}
-          const summary = tl.summary({ sinceCursor: cursorKey })
-          let consoleSplit = null
-          if (summary && summary.byKind && summary.byKind.console) {
-            const events = tl.recent({ sinceCursor: cursorKey, kinds: 'console', limit: 100000 }).events
-            consoleSplit = { error: 0, warn: 0 }
-            for (const ev of events) {
-              const lvl = ev && ev.data && ev.data.level
-              if (lvl === 'error') consoleSplit.error++
-              else if (lvl === 'warn') consoleSplit.warn++
-            }
-          }
-          return summary ? { summary, consoleSplit } : null
-        })()`)}catch{return}if(!n||!n.summary||!n.summary.total)return;let r=n.summary.byKind??{},s=[],d=new Set;for(let m of B){let y=r[m];if(y)if(d.add(m),m==="console"&&n.consoleSplit){let{error:p,warn:x}=n.consoleSplit;p>0&&s.push(`${p} error${p===1?"":"s"}`),x>0&&s.push(`${x} warning${x===1?"":"s"}`)}else s.push(`${y} ${m}${y===1?"":"s"}`)}for(let[m,y]of Object.entries(r))!d.has(m)&&y&&s.push(`${y} ${m}${y===1?"":"s"}`);if(s.length!==0&&(console.log(`
-  since last: ${s.join(" \xB7 ")} \u2014 sootsim what-happened`),n.summary.lastAt))try{await Me(e,"SootSim.bridges.timeline.cursorAdvance",t,n.summary.lastAt)}catch{}}let ce=new Set(["tap","double-tap","tap-text","tap-id","type","type-into","key","key-sequence","keycode","drag","swipe","long-press","touch","gesture","pinch","scroll","shell"]),Gt=new Set(["a11y","capture","count","double-tap","drag","find","gesture","layout","long-press","node","pinch","sample-color","scroll","screenshot","swipe","tap","tap-id","tap-text","touch","tree","type-into"]),Xt=(o.includes("--verbose")||o.includes("-v"))&&!o.includes("--json");b==="do"&&g==="shell"&&(console.error("  `sootsim do shell` was removed. use `sootsim shell ...` instead."),process.exit(1)),ce.has(g)&&await We(u),Gt.has(g)&&await ye(u,{verbose:Xt});try{switch(g){case"list":{await Mt({bridge:u,simId:T,args:l});break}case"tree":{await At({bridge:u,args:l,positional:a});break}case"a11y":{let e=await Ve(u);if(!Array.isArray(e)||e.length===0){console.log("  no accessible nodes found");break}if(o.includes("--json"))console.log(JSON.stringify(e,null,2));else{console.log(`  accessibility tree (${e.length} nodes):
-`);for(let t of e){let n=[];if(n.push(`[${t.role}]`),t.label){let r=t.label.length>50?t.label.slice(0,47)+"...":t.label;n.push(`"${r}"`)}if(t.hint&&n.push(`(hint: "${t.hint}")`),t.testID&&n.push(`#${t.testID}`),t.state){let r=[];t.state.disabled&&r.push("disabled"),t.state.selected&&r.push("selected"),t.state.checked===!0&&r.push("checked"),t.state.checked==="mixed"&&r.push("mixed"),t.state.busy&&r.push("busy"),t.state.expanded===!0&&r.push("expanded"),t.state.expanded===!1&&r.push("collapsed"),r.length&&n.push(`{${r.join(", ")}}`)}t.position&&n.push(`@(${t.position.x},${t.position.y})`),t.size&&n.push(`${t.size.w}x${t.size.h}`),console.log("  "+n.join(" "))}}break}case"find":{await kt({bridge:u,args:o,effectiveArgs:l,positional:a,inspectUsage:S});break}case"count":{await vt(u,{args:l});break}case"keyboard":{await Tt(u,{json:o.includes("--json")});break}case"screens":{await Nt(u,{json:o.includes("--json")});break}case"memory":{await It(u,{args:l});break}case"wait":{await Ot({wsPort:_,commandTimeoutMs:J,simId:T,simIdSource:R,positional:a});break}case"sleep":{await _t({positional:a,inspectUsage:S});break}case"settle":{await Ft({bridge:u,args:o,positional:a});break}case"ready":{await Dt({bridge:u,args:o});break}case"idle":{await Ct({bridge:u,args:o,positional:a});break}case"selector":{await Bt({bridge:u,args:o,positional:a,inspectUsage:S});break}case"event":{await Et({bridge:u,args:o,positional:a,inspectUsage:S});break}case"layout":{let e=a[1];e||(console.error(S("layout","<id>")),process.exit(1));let t=await u.send({type:"evaluate",code:`(async () => await window.__sootsimTest.getLayout(${JSON.stringify(e)}))()`});console.log(JSON.stringify(t,null,2));break}case"capture":case"screenshot":{let t=o.find((y,p)=>o[p-1]==="--output")||"/tmp/sootsim-inspect.png",n=await Wt(o,u),r={type:"screenshot"};n&&(r.crop=n);let d=(await u.send(r)).replace(/^data:image\/png;base64,/,"");n&&console.log(`  area:  x=${n.x} y=${n.y} w=${n.w} h=${n.h}`),(await import("fs")).writeFileSync(t,Buffer.from(d,"base64")),console.log(`  saved: ${t}`);break}case"sample-color":{let e=await Wt(o,u);e||(console.error(S("sample-color","<x> <y> [w] [h] | --id <testID> | --text <text>")),console.error("  samples an averaged color from the canvas. coords are logical sootsim units."),process.exit(1));let t=await u.send({type:"evaluate",code:yt(e)});if(o.includes("--json"))console.log(JSON.stringify(t,null,2));else{let{r:n,g:r,b:s,a:d,hex:m,samples:y}=t,p=e.w===1&&e.h===1?`@(${e.x},${e.y})`:`@(${e.x},${e.y}) ${e.w}x${e.h}`;console.log(`  ${m}  rgba(${n}, ${r}, ${s}, ${d})  ${p}  ${y} samples`)}break}case"node":{let e=a[1];e||(console.error(S("node","<matcher>")),console.error("  resolves testID, id, then text \u2014 dumps full node info as JSON"),process.exit(1));let t=await u.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            const q = ${JSON.stringify(e)}
-            let node = null
-            let via = null
-            if (t.findByTestId) { node = await t.findByTestId(q); if (node) via = 'testID' }
-            if (!node && t.findById) { node = await t.findById(q); if (node) via = 'id' }
-            if (!node && t.findByText) { node = await t.findByText(q); if (node) via = 'text' }
-            if (!node) return { matcher: q, found: false }
-
-            // read the resolved transform (if any) off the style \u2014 useful
-            // because canvas nodes often animate via transform and describe
-            // output strips that.
-            const transform =
-              node.style && Array.isArray(node.style.transform)
-                ? node.style.transform
-                : node.style && node.style.transform
-                  ? node.style.transform
-                  : null
-
-            // parent chain \u2014 walk up from the node so the JSON dump is
-            // self-describing.
-            const parentChain = []
-            const root = window.__sootsimRoot
-            if (root && node.id != null) {
-              const findPath = (n, targetId, path) => {
-                if (!n) return null
-                if (n.id === targetId) return path
-                if (n.children) {
-                  for (const child of n.children) {
-                    const nextPath = [
-                      ...path,
-                      {
-                        type: n.type || 'view',
-                        testID: n.props?.testID || null,
-                        text: n.text || null,
-                      },
-                    ]
-                    const found = findPath(child, targetId, nextPath)
-                    if (found) return found
-                  }
-                }
-                return null
-              }
-              const chain = findPath(root, node.id, [])
-              if (chain) parentChain.push(...chain)
-            }
-
-            return {
-              matcher: q,
-              found: true,
-              resolvedVia: via,
-              node,
-              transform,
-              parentChain,
-            }
-          })()`});console.log(JSON.stringify(t,null,2));break}case"tap":{let e=Number(a[1]),t=Number(a[2]),n=pe(o);if(n){let d=await L({textFallback:n.mode==="text"?n.value:void 0,resolve:async()=>{let p=await xe(u,n);return p?{cx:p.x,cy:p.y,match:{id:n.mode==="testid"?n.value:p.id??null,testID:n.mode==="testid"?n.value:p.testID??null,text:n.mode==="text"?n.value:p.text??null,type:p.type??null},target:{id:p.id??null,testID:p.testID??null,text:p.text??null,type:p.type??null}}:null}}),m=d.payload;(!m||typeof m.cx!="number")&&(console.error(`  not found: ${n.value}`),n.mode==="testid"&&V("wait-selector-for-missing-testid",n.value),process.exit(1)),I(d.result)||(z(`${n.mode} "${n.value}"`,d),process.exit(1));let y=Ut(m.cx,m.cy,d.result);y&&await q("inspect tap",y.step,y.summary),console.log(JSON.stringify({...d.attempts>1?{attempts:d.attempts}:{},...d.result},null,2));break}(!Number.isFinite(e)||!Number.isFinite(t))&&(console.error(S("tap","<x> <y> | --testid <id> | --text <t>")),process.exit(1));let r=await u.send({type:"tap",x:e,y:t}),s=Ut(e,t,r);s&&await q("inspect tap",s.step,s.summary),console.log(JSON.stringify(r,null,2));break}case"drag":case"swipe":{let e=Number(a[1]),t=Number(a[2]),n=Number(a[3]),r=Number(a[4]),s=g==="swipe"?10:12,d=g==="swipe"?8:16,m=a[5]?Number(a[5]):s,y=a[6]?Number(a[6]):d;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(n)||!Number.isFinite(r)||!Number.isFinite(m)||!Number.isFinite(y))&&(console.error(S(g,"<x1> <y1> <x2> <y2> [steps] [stepMs]")),process.exit(1));let p=await u.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.drag) return { ok: false, reason: 'no interact.drag' }
-            const value = await interact.drag(${e}, ${t}, ${n}, ${r}, ${Math.max(1,Math.round(m))}, ${Math.max(0,Math.round(y))})
-            return { ok: !!value, value }
-          })()`});if(p?.ok){let x=Math.max(1,Math.round(Math.max(1,m)*Math.max(0,y)));await q(`inspect ${g}`,{swipe:{start:`${e}, ${t}`,end:`${n}, ${r}`,duration:x}},`${g} ${e},${t} -> ${n},${r}`)}console.log(JSON.stringify(p,null,2));break}case"pinch":{let e=Number(a[1]),t=Number(a[2]),n=Number(a[3]),r=Number(a[4]),s=Number(a[5]),d=Number(a[6]),m=Number(a[7]),y=Number(a[8]),p=a[9]?Number(a[9]):12,x=a[10]?Number(a[10]):16;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(n)||!Number.isFinite(r)||!Number.isFinite(s)||!Number.isFinite(d)||!Number.isFinite(m)||!Number.isFinite(y)||!Number.isFinite(p)||!Number.isFinite(x))&&(console.error(S("pinch","<x1> <y1> <x2> <y2> <x1'> <y1'> <x2'> <y2'> [steps] [stepMs]")),process.exit(1));let A=await u.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.pinch) return { ok: false, reason: 'no interact.pinch' }
-            const value = await interact.pinch(${e}, ${t}, ${n}, ${r}, ${s}, ${d}, ${m}, ${y}, ${Math.max(1,Math.round(p))}, ${Math.max(0,Math.round(x))})
-            return { ok: !!value, value }
-          })()`});A?.ok&&await q("inspect pinch",{pinch:{from:[e,t,n,r],to:[s,d,m,y],steps:Math.max(1,Math.round(p)),stepMs:Math.max(0,Math.round(x))}},`pinch (${e},${t}) (${n},${r}) -> (${s},${d}) (${m},${y})`),console.log(JSON.stringify(A,null,2));break}case"tap-text":{let e=a[1];e||(console.error(S("tap-text","<text>")),process.exit(1));let t=G=>{let O=o.indexOf(G);return O>=0&&O+1<o.length?o[O+1]:null},n=G=>o.includes(G),r=t("--nth")??t("--index"),s=r!==null?Number(r):null;s!==null&&!Number.isFinite(s)&&(console.error(`  --nth/--index requires an integer, got: ${r}`),process.exit(1));let d=t("--within"),m=t("--role"),y=n("--exact"),p=n("--first"),x=t("--min-y"),A=t("--max-y"),H=t("--min-x"),U=t("--max-x");for(let[G,O]of[["--min-y",x],["--max-y",A],["--min-x",H],["--max-x",U]])O!==null&&!Number.isFinite(Number(O))&&(console.error(`  ${G} requires a number, got: ${O}`),process.exit(1));let K=o.indexOf("--near"),N=null;if(K>=0){let G=Number(o[K+1]),O=Number(o[K+2]);(!Number.isFinite(G)||!Number.isFinite(O))&&(console.error("  --near requires two numbers: --near <x> <y>"),process.exit(1)),N={x:G,y:O}}let w=JSON.stringify({query:e,exact:y,role:m,within:d,minX:H!==null?Number(H):null,maxX:U!==null?Number(U):null,minY:x!==null?Number(x):null,maxY:A!==null?Number(A):null,near:N,nth:s,first:p}),P=await L({textFallback:e,resolve:()=>u.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return { error: 'bridge-not-ready' }
-            const F = ${w}
-
-            const res = await t.queryTextCandidates({
-              query: F.query,
-              exact: !!F.exact,
-              ...(F.role ? { role: F.role } : {}),
-            })
-
-            let candidates = res.candidates || []
-
-            candidates = candidates.filter((c) => {
-              const ax = c.info.absolutePosition && c.info.absolutePosition.x
-              const ay = c.info.absolutePosition && c.info.absolutePosition.y
-              if (F.minX !== null && !(ax >= F.minX)) return false
-              if (F.maxX !== null && !(ax <= F.maxX)) return false
-              if (F.minY !== null && !(ay >= F.minY)) return false
-              if (F.maxY !== null && !(ay <= F.maxY)) return false
-              if (F.within && !c.ancestorTestIDs.includes(F.within)) return false
-              return true
-            })
-
-            if (F.near) {
-              candidates.sort((a, b) => {
-                const ax = (a.info.absolutePosition && a.info.absolutePosition.x) || 0
-                const ay = (a.info.absolutePosition && a.info.absolutePosition.y) || 0
-                const bx = (b.info.absolutePosition && b.info.absolutePosition.x) || 0
-                const by = (b.info.absolutePosition && b.info.absolutePosition.y) || 0
-                return (
-                  Math.hypot(ax - F.near.x, ay - F.near.y) -
-                  Math.hypot(bx - F.near.x, by - F.near.y)
-                )
-              })
-            } else {
-              candidates.sort((a, b) => {
-                const ay = (a.info.absolutePosition && a.info.absolutePosition.y) || 0
-                const by = (b.info.absolutePosition && b.info.absolutePosition.y) || 0
-                if (Math.abs(ay - by) > 2) return ay - by
-                const ax = (a.info.absolutePosition && a.info.absolutePosition.x) || 0
-                const bx = (b.info.absolutePosition && b.info.absolutePosition.x) || 0
-                return ax - bx
-              })
-            }
-
-            const total = candidates.length
-            if (total === 0) return { matched: 0, total: 0 }
-
-            let idx = 0
-            if (F.nth !== null) {
-              idx = F.nth < 0 ? total + F.nth : F.nth
-              if (idx < 0 || idx >= total) {
-                return { matched: 0, total, nthOutOfRange: true, nth: F.nth }
-              }
-            } else if (total > 1 && !F.first && !F.near) {
-              return {
-                ambiguous: true,
-                total,
-                candidates: candidates.slice(0, 10).map((c, i) => ({
-                  idx: i,
-                  nodeId: c.info.nodeId,
-                  type: c.info.type,
-                  testID: c.info.testID,
-                  text: (c.info.text || '').slice(0, 60),
-                  abs: c.info.absolutePosition,
-                  layout: c.info.layout
-                    ? {
-                        width: Math.round(c.info.layout.width || 0),
-                        height: Math.round(c.info.layout.height || 0),
-                      }
-                    : null,
-                  ancestorTestIDs: (c.ancestorTestIDs || []).slice(0, 5),
-                })),
-              }
-            }
-
-            const picked = candidates[idx]
-            const n = picked.info
-            if (!n.absolutePosition || !n.layout) return { matched: 0, total }
-
-            const resolved =
-              typeof n.nodeId === 'number' &&
-              typeof t.resolveTapTarget === 'function'
-                ? await t.resolveTapTarget(n.nodeId)
-                : null
-            const target = (resolved && resolved.target) || n
-            const cx =
-              resolved && typeof resolved.cx === 'number'
-                ? resolved.cx
-                : n.absolutePosition.x + (n.layout.width || 0) / 2
-            const cy =
-              resolved && typeof resolved.cy === 'number'
-                ? resolved.cy
-                : n.absolutePosition.y + (n.layout.height || 0) / 2
-            return {
-              cx,
-              cy,
-              match: {
-                nodeId: n.nodeId ?? null,
-                id: n.id,
-                testID: n.testID,
-                type: n.type,
-              },
-              target: {
-                nodeId: target.nodeId ?? null,
-                id: target.id,
-                testID: target.testID,
-                text:
-                  target.text ??
-                  target.accessibilityLabel ??
-                  n.text ??
-                  n.accessibilityLabel ??
-                  null,
-                type: target.type,
-              },
-              strategy: (resolved && resolved.strategy) || 'matched-node',
-              total,
-              idx,
-            }
-          })()`})}),F=P.payload;if(F?.error==="bridge-not-ready"&&(console.error("  sootsim test bridge not ready"),process.exit(1)),F?.ambiguous){let G=F.candidates;console.error(`  ambiguous: ${F.total} matches for "${e}"`);for(let O of G){let Vt=O.abs?`@(${Math.round(O.abs.x)},${Math.round(O.abs.y)})`:"",Qt=O.layout?` ${O.layout.width}x${O.layout.height}`:"",Zt=O.testID?` #${O.testID}`:"",eo=O.text?` "${O.text}"`:"",to=O.ancestorTestIDs.length>0?` within ${O.ancestorTestIDs.slice(0,3).map(oo=>`#${oo}`).join(" > ")}`:"";console.error(`    [${O.idx}] <${O.type}>${eo}${Zt} ${Vt}${Qt}${to}`)}F.total>G.length&&console.error(`    ... and ${F.total-G.length} more`),console.error("  pick one:"),console.error("    --nth <index>           pick the nth match (top-to-bottom, left-to-right; negatives from end)"),console.error("    --within <testID>       narrow to descendants of a node"),console.error("    --min-y / --max-y       geometric filter (pixels, absolute)"),console.error("    --min-x / --max-x       geometric filter (pixels, absolute)"),console.error("    --near <x> <y>          pick the closest match to a point"),console.error("    --exact                 exact text match (default is substring)"),console.error("    --role <role>           narrow to accessibilityRole"),console.error("    --first                 keep the old pick-first-silently behavior"),process.exit(2)}F?.nthOutOfRange&&(console.error(`  not found: nth ${F.nth} of ${F.total} match${F.total===1?"":"es"} for "${e}"`),process.exit(1)),(!F||typeof F.cx!="number")&&(console.error(`  not found: ${e}`),process.exit(1)),I(P.result)||(z(`text "${e}"`,P),process.exit(1));let de=Ce(e,{id:F.target?.id??null,testID:F.target?.testID??null,type:F.target?.type??null,cx:F.cx,cy:F.cy},"text");await q("inspect tap-text",de.step,de.summary),console.log(JSON.stringify({matched:F.match,tapped:{nodeId:F.target?.nodeId??null,id:F.target?.id??null,testID:F.target?.testID??null,type:F.target?.type??null,cx:F.cx,cy:F.cy},...F.strategy&&F.strategy!=="matched-node"?{strategy:F.strategy}:{},...F.total>1||s!==null?{nth:{index:F.idx,total:F.total}}:{},...P.attempts>1?{attempts:P.attempts}:{},result:P.result},null,2));break}case"tap-best":{let e=a[1];e||(console.error(S("tap-best","<query>")),process.exit(1));let t=JSON.stringify(e),r=await L({textFallback:e,resolve:async()=>{let y=await u.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return { error: 'bridge-not-ready' }
-            // try testID first \u2014 strongest signal of "this is the
-            // intended tap target".
-            const byTestId =
-              (await t.findByTestId(${t})) || (await t.findById(${t}))
-            if (byTestId && byTestId.absolutePosition && byTestId.layout) {
-              return {
-                strategy: 'testid',
-                node: {
-                  nodeId: byTestId.nodeId ?? null,
-                  id: byTestId.id,
-                  testID: byTestId.testID,
-                  type: byTestId.type,
-                  text: byTestId.text,
-                  absolutePosition: byTestId.absolutePosition,
-                  layout: byTestId.layout,
-                },
-              }
-            }
-            // text fallback. findByText returns null when there are
-            // 0 or 2+ matches \u2014 to disambiguate we'd send the user
-            // back to tap-text with --nth, which is the right
-            // failure mode.
-            const byText = await t.findByText(${t})
-            if (byText && byText.absolutePosition && byText.layout) {
-              return {
-                strategy: 'text',
-                node: {
-                  nodeId: byText.nodeId ?? null,
-                  id: byText.id,
-                  testID: byText.testID,
-                  type: byText.type,
-                  text: byText.text,
-                  absolutePosition: byText.absolutePosition,
-                  layout: byText.layout,
-                },
-              }
-            }
-            return { strategy: 'none' }
-          })()`});if(!("node"in y))return y;let p=y.node,x=p.absolutePosition.x+p.layout.width/2,A=p.absolutePosition.y+p.layout.height/2;return{...y,cx:x,cy:A,target:{id:p.id,testID:p.testID,text:y.strategy==="text"?e:p.text,type:p.type}}}}),s=r.payload;s||(console.error(`  tap-best: no testID or visible text matched "${e}". try \`sootsim find --interactive-targets\` to list candidates.`),process.exit(1)),"error"in s&&(console.error(`  ${s.error}`),process.exit(1)),s.strategy==="none"&&(console.error(`  tap-best: no testID or visible text matched "${e}". try \`sootsim find --interactive-targets\` to list candidates.`),process.exit(1));let d=s.node;I(r.result)||(z(`best "${e}"`,r),process.exit(1));let m=Ce(e,{id:d.id,testID:d.testID,type:d.type,cx:s.cx,cy:s.cy},s.strategy==="testid"?"id":"text");await q("inspect tap-best",m.step,m.summary),console.log(JSON.stringify({matched:{strategy:s.strategy,nodeId:d.nodeId,id:d.id,testID:d.testID,type:d.type,text:d.text},tapped:{cx:s.cx,cy:s.cy},...r.attempts>1?{attempts:r.attempts}:{},result:r.result},null,2));break}case"tap-id":{let e=a[1];e||(console.error(S("tap-id","<id>")),process.exit(1));let t=JSON.stringify(e),r=await L({resolve:()=>u.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return null
-            const n = (await t.findByTestId(${t})) || (await t.findById(${t}))
-            if (!n || !n.absolutePosition || !n.layout) return { cx: null }
-            const resolved =
-              typeof n.nodeId === 'number' && typeof t.resolveTapTarget === 'function'
-                ? await t.resolveTapTarget(n.nodeId)
-                : null
-            const target = (resolved && resolved.target) || n
-            const cx =
-              resolved && typeof resolved.cx === 'number'
-                ? resolved.cx
-                : n.absolutePosition.x + (n.layout.width || 0) / 2
-            const cy =
-              resolved && typeof resolved.cy === 'number'
-                ? resolved.cy
-                : n.absolutePosition.y + (n.layout.height || 0) / 2
-            return {
-              cx,
-              cy,
-              match: {
-                nodeId: n.nodeId ?? null,
-                id: n.id,
-                testID: n.testID,
-                text: n.text ?? n.accessibilityLabel ?? null,
-                type: n.type,
-              },
-              target: {
-                nodeId: target.nodeId ?? null,
-                id: target.id,
-                testID: target.testID,
-                text:
-                  target.text ??
-                  target.accessibilityLabel ??
-                  n.text ??
-                  n.accessibilityLabel ??
-                  null,
-                type: target.type,
-              },
-              strategy: (resolved && resolved.strategy) || 'matched-node',
-            }
-          })()`})}),s=r.payload;(!s||typeof s.cx!="number")&&(console.error(`  not found: ${e}`),await So(u,e),process.exit(1)),I(r.result)||(z(`id "${e}"`,r),process.exit(1));let d=Ce(e,{id:s.target?.id??null,testID:s.target?.testID??null,type:s.target?.type??null,cx:s.cx,cy:s.cy},"id");await q("inspect tap-id",d.step,d.summary),console.log(JSON.stringify({matched:s.match,tapped:{nodeId:s.target?.nodeId??null,id:s.target?.id??null,testID:s.target?.testID??null,type:s.target?.type??null,cx:s.cx,cy:s.cy},...s.strategy&&s.strategy!=="matched-node"?{strategy:s.strategy}:{},...r.attempts>1?{attempts:r.attempts}:{},result:r.result},null,2));break}case"type-into":{let e=a[1],t=a.slice(2).join(" ");(!e||!t)&&(console.error(S("type-into","<id> <text>")),process.exit(1));let n=JSON.stringify(e),r=await u.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return null
-            const n = await (t.findByTestId(${n}) || t.findById(${n}))
-            if (!n || !n.absolutePosition || !n.layout) return null
-            return {
-              cx: n.absolutePosition.x + (n.layout.width || 0) / 2,
-              cy: n.absolutePosition.y + (n.layout.height || 0) / 2,
-              id: n.id,
-              testID: n.testID,
-              type: n.type,
-              isTextInput: !!n.isTextInput,
-              placeholder: n.placeholder || null,
-            }
-          })()`});(!r||typeof r.cx!="number")&&(console.error(`  not found: ${e}`),process.exit(1)),r.isTextInput||console.error(`  warning: ${e} is not a text input (isTextInput: false)`);let s=await u.send({type:"tap",x:r.cx,y:r.cy,target:{id:r.id??e,testID:r.testID??e,text:null,type:r.type??null}}),d=await Po(u);d.visible||(console.error(`  keyboard did not open after tapping ${e}`),process.exit(1));let m=d.focusedInput;m&&(m.testID===e||m.id===e||(console.error(`  focus routing mismatch after tap: requested ${JSON.stringify(e)} but focus is on ${JSON.stringify(m.testID??m.id??null)}. did the tap land on an outer Pressable wrapper?`),process.exit(1))),await u.send({type:"keyboard",action:"type",text:t}),await q("inspect type-into",{tapOn:{id:e},inputText:t},`type-into #${e} ${JSON.stringify(t)}`),console.log(JSON.stringify({target:e,isTextInput:r.isTextInput,keyboardOpened:d.visible??s?.keyboardOpened??!1,focusedInput:d.focusedInput??null,typed:t},null,2));break}case"type":{let e=a.slice(1).join(" ");e||(console.error(S("type","<text>")),process.exit(1)),await Se(u,"type"),await u.send({type:"keyboard",action:"type",text:e}),await q("inspect type",{inputText:e},`type ${JSON.stringify(e)}`),console.log(`  typed: ${JSON.stringify(e)}`);break}case"key":{let e=a[1];e||(console.error(S("key","<name>")),process.exit(1)),await Se(u,"key"),await u.send({type:"keyboard",action:"press",text:e}),await q("inspect key",{pressKey:e},`key ${e}`),console.log(`  pressed: ${e}`);break}case"key-sequence":{let e=a.slice(1);e.length===0&&(console.error(S("key-sequence","<key> [<key> ...]")),process.exit(1)),await Se(u,"key-sequence");for(let t of e)await u.send({type:"keyboard",action:"press",text:t});await q("inspect key-sequence",{pressKey:e.join(" ")},`key-sequence ${e.join(" ")}`),console.log(`  pressed: ${e.join(", ")}`);break}case"keycode":{let e=a.slice(1);e.length===0&&(console.error(S("keycode","<code> [<code> ...]")),process.exit(1));let t=e.map(r=>({code:r,key:Oo(r)})),n=t.filter(r=>!r.key);n.length>0&&(console.error(`  unsupported keycode(s): ${n.map(r=>r.code).join(", ")}`),process.exit(1)),await Se(u,"keycode");for(let r of t)await u.send({type:"keyboard",action:"press",text:r.key});await q("inspect keycode",{pressKey:t.map(r=>r.key).join(" ")},`keycode ${e.join(" ")}`),console.log(`  pressed: ${e.join(", ")}`);break}case"dispatch":{let e=a[1];e||(console.error(S("dispatch","<char>")),process.exit(1)),await u.send({type:"keyboard",action:"dispatchKey",text:e}),await q("inspect dispatch",{dispatchKey:e},`dispatch ${JSON.stringify(e)}`),console.log(`  dispatched: ${e}`);break}case"dismiss":{await u.send({type:"keyboard",action:"dismiss"}),await q("inspect dismiss",{hideKeyboard:!0},"dismiss keyboard"),console.log("  keyboard dismissed");break}case"double-tap":{let e=Number(a[1]),t=Number(a[2]),n=pe(o);if(n){let m=await xe(u,n);m||(console.error(`  not found: ${n.value}`),n.mode==="testid"&&V("wait-selector-for-missing-testid",n.value),process.exit(1)),e=m.x,t=m.y}let r=a[3]?Number(a[3]):80;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(r))&&(console.error(S("double-tap","<x> <y> [gapMs] | --testid <id>")),process.exit(1));let s=Math.max(0,Math.round(r)),d=await u.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (interact?.doubleTap) {
-              return {
-                ok: !!(await interact.doubleTap(${e}, ${t}, ${s})),
-                gapMs: ${s},
-              }
-            }
-            if (!interact?.tap) {
-              return { ok: false, reason: 'no interact.tap', gapMs: ${s} }
-            }
-            const first = await interact.tap(${e}, ${t})
-            if (!first || first.hit === false) {
-              return { ok: false, reason: 'first tap missed', gapMs: ${s}, first }
-            }
-            await new Promise((resolve) => setTimeout(resolve, ${s}))
-            const second = await interact.tap(${e}, ${t})
-            return {
-              ok: !!second && second.hit !== false,
-              gapMs: ${s},
-              first,
-              second,
-            }
-          })()`});d?.ok&&await q("inspect double-tap",{doubleTapAtCoords:{x:e,y:t,gapMs:s}},`double-tap @${e},${t}`),console.log(JSON.stringify(d,null,2));break}case"long-press":{let e=Number(a[1]),t=Number(a[2]),n=pe(o);if(n){let d=await xe(u,n);d||(console.error(`  not found: ${n.value}`),n.mode==="testid"&&V("wait-selector-for-missing-testid",n.value),process.exit(1)),e=d.x,t=d.y}let r=a[3]?Number(a[3]):600;(!Number.isFinite(e)||!Number.isFinite(t)||!Number.isFinite(r))&&(console.error(S("long-press","<x> <y> [durationMs] | --testid <id>")),process.exit(1));let s=await u.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.longPress) return { ok: false, reason: 'no interact.longPress' }
-            const value = await interact.longPress(${e}, ${t}, ${Math.max(0,Math.round(r))})
-            return { ok: !!value, value }
-          })()`});s?.ok&&await q("inspect long-press",{tapAtCoords:{x:e,y:t}},`long-press @${e},${t}`),console.log(JSON.stringify(s,null,2));break}case"touch":{let e=a[1],t=Number(a[2]),n=Number(a[3]),r=a[4]?Number(a[4]):999,s=e==="down"?"touchDown":e==="move"?"touchMove":e==="up"?"touchUp":e==="cancel"?"touchCancel":null;s||(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1)),e!=="cancel"&&(!Number.isFinite(t)||!Number.isFinite(n))&&(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1));let d=e==="down"?"tap":e==="move"?"move":null,m=d&&Number.isFinite(t)&&Number.isFinite(n)?`window.dispatchEvent(new CustomEvent('sootsim:agentAction', { detail: { type: '${d}', x: ${t}, y: ${n} } }));`:"",y=await u.send({type:"evaluate",code:`(async () => {
-            ${m}
-            const interact = window.__sootsimInteract
-            if (!interact?.${s}) return { ok: false, reason: 'no interact.${s}' }
-            const value = ${e==="cancel"?`await interact.${s}(${Math.max(1,Math.round(r))})`:`await interact.${s}(${t}, ${n}, ${Math.max(1,Math.round(r))})`}
-            return { ok: !!value, value }
-          })()`});y?.ok&&e!=="cancel"&&await q("inspect touch",{tapAtCoords:{x:t,y:n}},`touch ${e} @${t},${n}`),console.log(JSON.stringify(y,null,2));break}case"gesture":{let e=["scroll-up","scroll-down","scroll-left","scroll-right","swipe-from-left-edge","swipe-from-right-edge","swipe-from-top-edge","swipe-from-bottom-edge"],t=a[1],n=a[2]?Number(a[2]):220;(!t||!Number.isFinite(n))&&(console.error(S("gesture","<preset> [durationMs]")),console.error(`  presets: ${e.join(", ")}`),process.exit(1)),e.includes(t)||(console.error(`  unknown gesture preset: ${t}`),console.error(`  presets: ${e.join(", ")}`),process.exit(1));let r=await u.send({type:"evaluate",code:`(async () => {
-            const spec = globalThis.__sootsimDeviceSpec || {}
-            return {
-              width: spec.width || window.innerWidth || 393,
-              height: spec.height || window.innerHeight || 852,
-              statusBarHeight: spec.statusBarHeight || 0,
-              homeIndicatorHeight: spec.homeIndicatorHeight || 0,
-            }
-          })()`}),s=Number(r?.width)||393,d=Number(r?.height)||852,m=Number(r?.statusBarHeight)||0,y=Number(r?.homeIndicatorHeight)||0,p=Math.round(s/2),x=Math.round(d/2),A=Math.max(24,m+18),H=Math.max(24,y+18),U=18,K=Math.min(220,Math.round(d*.24)),N=Math.min(180,Math.round(s*.32)),w=p,v=x,P=p,F=x;switch(t){case"scroll-up":v=x+Math.round(K/2),F=x-Math.round(K/2);break;case"scroll-down":v=x-Math.round(K/2),F=x+Math.round(K/2);break;case"scroll-left":w=p+Math.round(N/2),P=p-Math.round(N/2);break;case"scroll-right":w=p-Math.round(N/2),P=p+Math.round(N/2);break;case"swipe-from-left-edge":w=U,v=x,P=Math.min(s-U,U+N);break;case"swipe-from-right-edge":w=s-U,v=x,P=Math.max(U,s-U-N);break;case"swipe-from-top-edge":w=p,v=A,F=Math.min(d-H,A+K);break;case"swipe-from-bottom-edge":w=p,v=d-H,F=Math.max(A,d-H-K);break}let de=Math.max(8,Math.round(n/16)),G=Math.max(1,Math.round(n/de)),O=await u.send({type:"evaluate",code:`(async () => {
-            const interact = window.__sootsimInteract
-            if (!interact?.drag) return { ok: false, reason: 'no interact.drag' }
-            const value = await interact.drag(${w}, ${v}, ${P}, ${F}, ${de}, ${G})
-            return { ok: !!value, value }
-          })()`});O?.ok&&await q("inspect gesture",{swipe:{start:`${w}, ${v}`,end:`${P}, ${F}`,duration:Math.max(1,Math.round(n))}},`gesture ${t}`),console.log(JSON.stringify({preset:t,from:{x:w,y:v},to:{x:P,y:F},result:O},null,2));break}case"scroll":{let e=pe(o),t=Eo(o),n=e?.mode==="testid"?e.value:t==null?a[1]:null,r=e||t!=null?1:2,s=Number(a[r]),d=Number(a[r+1]);(!n&&t==null||!Number.isFinite(s)||!Number.isFinite(d))&&(console.error(S("scroll","<id> <x> <y> | --testid <id> <x> <y> | --node-id <nodeId> <x> <y>")),process.exit(1));let m=await u.send({type:"evaluate",code:`(async () => {
-            const t = window.__sootsimTest
-            if (!t) return null
-            const n = ${t!=null?`await t.inspectByNodeId(${JSON.stringify(t)})`:`await t.findByTestId(${JSON.stringify(n)})
-              || await t.findById(${JSON.stringify(n)})`}
-            if (!n || !n.absolutePosition || !n.layout) return null
-            return {
-              cx: n.absolutePosition.x + (n.layout.width || 0) / 2,
-              cy: n.absolutePosition.y + (n.layout.height || 0) / 2,
-            }
-          })()`}),y=await X(u,"scrollTo",t!=null?{nodeId:t}:n,s,d,!1);if(y?.ok){let p=t!=null?`node ${t}`:`#${n}`;await q("inspect scroll",{scrollTo:{...t!=null?{nodeId:t}:{id:n},x:s,y:d}},`scroll ${p} -> ${s},${d}`)}console.log(JSON.stringify({...y,...m?{at:{x:m.cx,y:m.cy}}:{}},null,2));break}case"state":{let e=a[1];if(i==="get"&&!e){let n=await X(u,"getRuntimeState"),r=await u.send({type:"evaluate",code:`({
-              errors: window.__sootsimConsole?.getErrors?.()?.length ?? 0,
-              warnings: window.__sootsimConsole?.getWarnings?.()?.length ?? 0,
-            })`});if(n&&typeof n=="object"&&n.diagnostics&&(n.diagnostics.errors=r?.errors??0,n.diagnostics.warnings=r?.warnings??0),n&&typeof n=="object"&&n.shell==null)try{let s=await le(u);s&&(n.shell=s)}catch{}console.log(JSON.stringify(n,null,2));break}if(!e||e==="--help"||e==="-h"){console.log(`
-  ${h("state")} \u2014 dump raw runtime state
-
-  subcommands:
-    shell               dump shell transition/layout state
-    worker              dump render-worker host/animation state
-    keyboard            dump keyboard visibility, mode, and focused input
-    ownership           dump surface ownership + pointerOnSurface delivery stats
-    node <id>           dump raw node info by id or testID
-    scroll <id>         dump scroll metrics and runtime state
-    scroll-hit <x> <y>  dump the nearest scroll ancestor at coordinates
-    hit <x> <y>         dump the hit-test ancestry at coordinates
-    gesture <x> <y>     dump gesture routing/debug info at coordinates
-
-  examples:
-    ${h("state")} shell
-    ${h("state")} worker
-    ${h("state")} keyboard
-    ${h("state")} ownership
-    ${h("state")} node photos
-    ${h("state")} scroll feed
-    ${h("state")} scroll-hit 360 420
-    ${h("state")} hit 200 720
-`);break}let t;switch(e){case"shell":t=await le(u,500);break;case"worker":t=await Me(u,"__sootsimRenderHost.queryStats");break;case"ownership":t=await u.send({type:"evaluate",code:`(() => {
-                const h = window.__sootsimRenderHost
-                if (!h || typeof h.getOwnershipSnapshot !== 'function') {
-                  return { error: 'getOwnershipSnapshot not available' }
-                }
-                return h.getOwnershipSnapshot()
-              })()`});break;case"keyboard":t=await u.send({type:"evaluate",code:`(async () => {
-                const kb = window.__sootsimKeyboard
-                const test = window.__sootsimTest
-                if (!kb) return { error: 'keyboard bridge not available' }
-                const layout = typeof kb.getLayout === 'function' ? kb.getLayout() : null
-                const visible = kb.isVisible()
-                const mode = kb.getMode()
-                let focused = null
-                if (test && typeof test.getFocusedNode === 'function') {
-                  try {
-                    focused = await test.getFocusedNode()
-                  } catch {}
-                }
-                return {
-                  visible,
-                  mode,
-                  layout,
-                  focusedInput: focused ? {
-                    nodeId: focused.nodeId ?? null,
-                    testID: focused.testID || null,
-                    id: focused.id || null,
-                    placeholder: focused.placeholder || null,
-                    text: focused.text || null,
-                  } : null,
-                }
-              })()`});break;case"node":{let n=a[2];n||(console.error(`  usage: ${h("state")} node <id>`),process.exit(1)),t=await X(u,"findByTestId",n)||await X(u,"findById",n);break}case"scroll":{let n=a[2];n||(console.error(`  usage: ${h("state")} scroll <id>`),process.exit(1)),t=await X(u,"getScrollState",n);break}case"scroll-hit":{let n=Number(a[2]),r=Number(a[3]);(!Number.isFinite(n)||!Number.isFinite(r))&&(console.error(`  usage: ${h("state")} scroll-hit <x> <y>`),process.exit(1)),t=await X(u,"getScrollStateAt",n,r);break}case"hit":{let n=Number(a[2]),r=Number(a[3]);(!Number.isFinite(n)||!Number.isFinite(r))&&(console.error(`  usage: ${h("state")} hit <x> <y>`),process.exit(1)),t=await X(u,"debugHitAt",n,r);break}case"gesture":{let n=Number(a[2]),r=Number(a[3]);(!Number.isFinite(n)||!Number.isFinite(r))&&(console.error(`  usage: ${h("state")} gesture <x> <y>`),process.exit(1)),t=await X(u,"debugGestureAt",n,r);break}default:console.error(`  unknown state subcommand: ${e}`),process.exit(1)}console.log(JSON.stringify(t,null,2));break}case"shell":{let e=a[1];if(!e||e==="--help"||e==="-h"){console.log(`
-  ${h("shell")} \u2014 run built-in shell commands
-
-  subcommands:
-    launch <appId> [waitMs] [--clear-state]
-                               launch app and wait for settled shell state
-    home [waitMs]              go home and wait for settled shell state
-    switcher [waitMs]          open switcher and wait for settled shell state
-    open-card <appId> [waitMs]
-                               open a specific switcher card and wait for app settle
-    appearance <light|dark|auto|toggle>
-                               update simulator appearance
-    lock                       toggle device lock state
-    shake                      trigger the simulator shake gesture
-
-  examples:
-    ${h("shell")} launch photos
-    ${h("shell")} launch rn --clear-state
-    ${h("shell")} launch photos 1500
-    ${h("shell")} home 500
-    ${h("shell")} switcher 800
-    ${h("shell")} open-card clock 800
-    ${h("shell")} appearance dark
-    ${h("shell")} lock
-`);break}let t=e==="launch"||e==="open-card"||e==="home"||e==="switcher",n=e==="launch"||e==="open-card"?a[3]:a[2],r=n?Number(n):350;t&&(!Number.isFinite(r)||r<0)&&(console.error(S("shell",e==="launch"||e==="open-card"?"<launch|open-card> <appId> [settleMs]":"<home|switcher> [settleMs]")),process.exit(1));let s=!1,d=!1,m=null,y=o.includes("--clear-state");if(e==="launch"){let p=a[2];p||(console.error(S("shell","launch <appId> [settleMs] [--clear-state]")),process.exit(1)),y&&await u.send({type:"evaluate",code:Ue}),s=!!await ue(u,"launchApp",r,p),{settled:d,state:m}=await ve(u,Math.round(r),x=>!!x&&x.state==="app"&&x.activeApp===p&&x.showSwitcher===!1&&x.switcherPhase==="idle"&&typeof x.launchProgress=="number"&&x.launchProgress>=.98),s&&await q("inspect shell launch",y?{launchApp:{clearState:!0}}:{launchApp:{}},y?"launch app (clear state)":"launch app")}else if(e==="home")s=!!await ue(u,"goHome",r),{settled:d,state:m}=await ve(u,Math.round(r),p=>!!p&&p.state==="home"&&p.activeApp==null&&p.showSwitcher===!1&&p.switcherPhase==="idle"&&typeof p.launchProgress=="number"&&p.launchProgress>=.98);else if(e==="switcher")s=!!await ue(u,"openSwitcher",r),{settled:d,state:m}=await ve(u,Math.round(r),p=>!!p&&p.state==="app"&&p.showSwitcher===!0&&p.switcherPhase==="idle"&&typeof p.zoomLevel=="number"&&Math.abs(p.zoomLevel)<=.02&&typeof p.horizontalZoom=="number"&&Math.abs(p.horizontalZoom)<=.02),d&&(await Q(Ao),m=await le(u));else if(e==="open-card"){let p=a[2];p||(console.error(S("shell","open-card <appId> [settleMs]")),process.exit(1)),s=!!await ue(u,"openSwitcherCard",r,p),{settled:d,state:m}=await ve(u,Math.round(r),x=>!!x&&x.state==="app"&&x.activeApp===p&&x.showSwitcher===!1&&x.switcherPhase==="idle"&&typeof x.zoomLevel=="number"&&x.zoomLevel>=.98&&typeof x.horizontalZoom=="number"&&x.horizontalZoom>=.98),s&&await q("inspect shell open-card",{openSwitcherCard:{appId:p}},`open switcher card ${p}`)}else if(e==="appearance"){let p=a[2];(!p||!["light","dark","auto","toggle"].includes(p))&&(console.error(S("shell","appearance <light|dark|auto|toggle>")),process.exit(1));let x=await Ht(u,"appearance",p);if(s=!!x?.ok,m={appearance:x},s){let A=x?.applied??p;console.log(`  appearance: ${A}`)}}else if(e==="lock"||e==="shake"){let p=await Ht(u,e);s=!!p?.ok,m={[e]:p}}else console.error(`  unknown shell subcommand: ${e}`),process.exit(1);console.log(JSON.stringify({ok:s,settled:d,state:m},null,2));break}case"url":{await Pt(u,{args:l});break}case"reload":{let n=!1,r=!1;try{await u.send({type:"evaluate",code:"window.__sootsimConsole?.clear()"});let m=await u.send({type:"evaluate",code:`;(() => {
-              const reloadExternalApp = window.SootSim?.bridges?.hotRemount?.reloadExternalApp
-              if (typeof reloadExternalApp === 'function') {
-                reloadExternalApp()
-                return { kind: 'external-app' }
-              }
-              window.location.reload()
-              return { kind: 'page' }
-            })()`});r=!!m&&m.kind==="external-app",n=!0}catch{}console.log("  reloading...");let s=u,d=null;if(r)d=await Ae(u,{timeoutMs:1e4,errorGraceMs:3e3});else{n&&await Q(300);let m=await pt(_,J,T,{timeoutMs:1e4,simIdSource:R});m?(s=m,d=await Ae(m,{timeoutMs:1e4,errorGraceMs:3e3})):(console.log("  \u26A0 reload: bridge never reconnected within 10000ms"),s=null)}if(d)if(d.ready){let m=d.source==="nodes-fallback"?" (no ready signal, node-count fallback)":"";console.log(`  ready in ${d.elapsedMs}ms: ${d.nodes} nodes${m}`)}else if(d.source==="error-bail")console.log(`  \u26A0 reload bailed after ${d.elapsedMs}ms: ${d.errors} console error(s), ready signal never fired`);else{let m=Io(d);console.log(`  \u26A0 reload timed out after ${d.elapsedMs}ms \u2014 ${m} (nodes: ${d.nodes}, targets: ${d.targets}, errors: ${d.errors})`)}if(s)try{let m=await s.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors(10) || []"});if(s!==u&&s.close(),Array.isArray(m)&&m.length>0){console.log(`
-  \u26A0 ${m.length} error(s) during mount:
-`);for(let y of m){let p=y.args.map(x=>typeof x=="object"?JSON.stringify(x):x).join(" ");if(console.log(`    ${p}`),y.stack){let x=y.stack.split(`
-`).slice(0,2);for(let A of x)console.log(`      ${A.trim()}`)}}}}catch{}d&&!d.ready&&(process.exitCode=1);break}case"eval":case"js":{let e=a.slice(1).join(" ");e||(console.error(S("js","<javascript>")),console.error(""),console.error("  runs the snippet in the engine realm. SootSim is the"),console.error("  canonical state surface \u2014 reach into it directly."),console.error(""),console.error("  examples:"),console.error(`    ${h("js")} SootSim.bridges.test.findByText("Sign in")`),console.error(`    ${h("js")} SootSim.bridges.debug.snapshot("before")`),console.error(`    ${h("js")} SootSim.bridges.keyboard.type("hello")`),console.error(`    ${h("js")} SootSim.state.root.children.length`),process.exit(1));let t=e;t.startsWith("(async")||(t=`(async () => ${t})()`);let n=await u.send({type:"evaluate",code:t});console.log(JSON.stringify(n,null,2));let r=e.toLowerCase(),s=[];(r.includes("sootsim:gohome")||r.includes("gohome"))&&s.push("sootsim shell home"),(r.includes("sootsim:appswitcher")||r.includes("appswitcher"))&&s.push("sootsim shell switcher"),(r.includes("keyboard.isvisible")||r.includes("keyboard.getmode"))&&s.push("sootsim debug state keyboard"),r.includes("interact.tap")&&s.push("sootsim do tap <x> <y>"),r.includes("keyboard.type")&&s.push("sootsim do type <text>"),(r.includes("keyboard.press")||r.includes("keyboard.dispatchkey"))&&s.push("sootsim do key <name>"),r.includes("keyboard.dismiss")&&s.push("sootsim do dismiss"),r.includes("dumptree")&&s.push("sootsim get tree"),r.includes("dumpaccessibilitytree")&&s.push("sootsim get a11y"),r.includes("getnodecount")&&s.push("sootsim get count"),r.includes("findbytext")&&s.push("sootsim find <text>"),(r.includes("findbytestid")||r.includes("findbyid"))&&s.push("sootsim find --testid <id>"),r.includes("document.hidden")&&s.push("sootsim debug state keyboard  (includes tab health)"),s.length>0&&V("prefer-cli-over-eval",s);break}case"globals":{let e=await u.send({type:"evaluate",code:`(async () => {
-            const globals = {}
-
-            // test bridge (proxy in worker mode)
-            const testMethods = [
-              'findById', 'findByTestId', 'findByText', 'findByLabel', 'findByRole',
-              'findAllByRole', 'findByA11yState', 'findAllByA11yState', 'findByHint',
-              'findPressable', 'getStyle', 'getLayout', 'getAbsolutePosition', 'isVisible',
-              'queryAll', 'dumpTree', 'dumpAccessibilityTree', 'getNodeCount', 'getShellState',
-              'getScrollState', 'getScrollStateAt', 'scrollTo', 'waitForTree',
-              'waitForScreenTransitions', 'debugByText', 'debugByTestId', 'debugHitAt',
-              'debugGestureAt'
-            ]
-            globals['test (\u2192 __sootsimTest)'] = testMethods
-
-            // debug
-            if (window.__sootsimDebug) {
-              globals['debug (\u2192 __sootsimDebug)'] = Object.keys(window.__sootsimDebug)
-            }
-
-            // interact
-            if (window.__sootsimInteract) {
-              globals['interact (\u2192 __sootsimInteract)'] = Object.keys(window.__sootsimInteract)
-            }
-
-            // keyboard
-            if (window.__sootsimKeyboard) {
-              globals['keyboard (\u2192 __sootsimKeyboard)'] = Object.keys(window.__sootsimKeyboard)
-            }
-
-            // other globals
-            globals['other'] = [
-              'root (\u2192 __sootsimRoot) - live node tree',
-              'render() (\u2192 __sootsimForceRender) - force re-render'
-            ]
-
-            return globals
-          })()`});console.log(`  sootsim JS API:
-`);for(let[t,n]of Object.entries(e)){console.log(`  ${t}:`);for(let r of n)console.log(`    .${r}`);console.log("")}console.log(`  use: ${h("js")} <expression>`),console.log(`  example: ${h("js")} test.findByText("Sign in")`);break}case"describe":{await St({bridge:u,args:o,positional:a});break}case"perf":{let e=a[1];if(!e||e==="--help"||e==="-h"){console.log(`
-  ${h("perf")} \u2014 performance profiling
-
-  subcommands:
-    stats           one-shot stats (zero overhead query)
-    start           begin recording frame times (also clears prior frames)
-    stop            stop recording and report results
-    frames [n]      get last N frame times (default: 50)
-    worst [n]       get the N slowest frames (default: 20)
-    transition <e>  profile a shell transition (goHome, appSwitcher, lockScreen)
-
-  the read subcommands (stats, stop, frames, worst, transition) accept
-  --json for a machine-readable payload on stdout.
-
-  examples:
-    ${h("perf")} stats
-    ${h("perf")} start
-    # ... interact with the app ...
-    ${h("perf")} stop
-    ${h("perf")} stop --json
-    ${h("perf")} transition goHome
-`);break}switch(e){case"stats":{let t=await u.send({type:"evaluate",code:`(async () => {
-                // worker mode (host exposes these)
-                if (window.__sootsimPerfStats) {
-                  return await window.__sootsimPerfStats()
-                }
-                // main-thread mode
-                const perf = window.__sootsimPerf
-                const a11y = window.__sootsimA11y
-                if (!perf && !a11y) return { error: 'no perf globals available' }
-
-                const frameStats = perf?.getFrameStats?.() || {}
-                const profile = a11y?.profile?.() || {}
-                const nodeCount = await window.__sootsimTest?.getNodeCount?.() || 0
-
-                return {
-                  frames: frameStats.frames || profile.syncCount || 0,
-                  avgMs: frameStats.totalMs && frameStats.frames
-                    ? (frameStats.totalMs / frameStats.frames).toFixed(2)
-                    : profile.avgSyncMs?.toFixed(2) || '?',
-                  maxMs: frameStats.maxMs?.toFixed(2) || profile.maxSyncMs?.toFixed(2) || '?',
-                  layoutMs: frameStats.layoutTotalMs?.toFixed(2) || '?',
-                  nodeCount,
-                  jankFrames: frameStats.recentFrames?.filter(f => f > 16.67).length || 0,
-                  recentCount: frameStats.recentFrames?.length || 0,
-                }
-              })()`});if(t.error&&(console.error(`  error: ${t.error}`),process.exit(1)),E(l)){C(t);break}let n=t.avgMs==="?"&&t.maxMs==="?",r=t.avgMs!=="?"?(1e3/parseFloat(t.avgMs)).toFixed(1):"?";console.log("  perf stats:"),console.log(`    frames:     ${t.frames}`),console.log(`    avg:        ${t.avgMs}ms (${r} fps)`),console.log(`    max:        ${t.maxMs}ms`),console.log(`    layout:     ${t.layoutMs}ms total`),console.log(`    nodes:      ${t.nodeCount}`),t.recentCount>0&&console.log(`    jank:       ${t.jankFrames}/${t.recentCount} frames >16.67ms`),n&&process.stderr.write(`
-  \u26A0 frame timings are zero \u2014 enable them first:
-    sootsim debug perf start    # begin recording
-    # \u2026 interact / run a flow / wait for the transition \u2026
-    sootsim debug perf stop     # full report
-    sootsim debug perf stats    # one-shot snapshot
-`);break}case"start":{await u.send({type:"evaluate",code:`(async () => {
-                // worker mode
-                if (window.__sootsimPerfStart && window.__sootsimRenderHost) {
-                  const result = window.__sootsimPerfStart()
-                  window.${se} = {
-                    active: true,
-                    mode: 'render-worker',
-                    lastSamples: [],
-                    startedAt: performance.now(),
-                  }
-                  return result
-                }
-                // main-thread mode
-                window.__sootsimPerf?.enableFrameStats?.(true)
-                window.__sootsimA11y?.resetProfile?.()
-                window.${se} = {
-                  active: true,
-                  mode: 'main-thread',
-                  lastSamples: [],
-                  startedAt: performance.now(),
-                }
-                return { started: true }
-              })()`}),console.log(`  profiling started \u2014 interact with the app, then run '${h("perf")} stop'`);break}case"stop":{let t=await u.send({type:"evaluate",code:`(async () => {
-                // worker mode
-                if (window.__sootsimRenderHost) {
-                  const session = window.${se} || {}
-                  const priorSamples = session.active && Array.isArray(session.lastSamples)
-                    ? session.lastSamples
-                    : []
-                  const flushedSamples = await window.__sootsimRenderHost.flushSamples()
-                  const samples = priorSamples.concat(flushedSamples)
-                  window.${se} = {
-                    ...session,
-                    active: false,
-                    mode: 'render-worker',
-                    lastSamples: samples,
-                    stoppedAt: performance.now(),
-                  }
-
-                  const frameTimes = samples.map(sample => sample[1])
-                  const layoutTimes = samples.map(sample => sample[2])
-                  const renderTimes = samples.map(sample => sample[3])
-                  const copyTimes = samples.map(sample => sample[4])
-                  const auxTimes = samples.map(sample => sample[5] || 0)
-                  const otherTimes = samples.map(sample => sample[6] || 0)
-                  const sorted = [...frameTimes].sort((a, b) => a - b)
-                  const total = frameTimes.reduce((a, b) => a + b, 0)
-                  const avg = frameTimes.length > 0 ? total / frameTimes.length : 0
-                  const max = Math.max(...frameTimes, 0)
-                  const layoutTotal = layoutTimes.reduce((a, b) => a + b, 0)
-                  const renderTotal = renderTimes.reduce((a, b) => a + b, 0)
-                  const copyTotal = copyTimes.reduce((a, b) => a + b, 0)
-                  const auxTotal = auxTimes.reduce((a, b) => a + b, 0)
-                  const otherTotal = otherTimes.reduce((a, b) => a + b, 0)
-
-                  return {
-                    mode: 'render-worker',
-                    frames: frameTimes.length,
-                    totalMs: total,
-                    avgMs: avg,
-                    maxMs: max,
-                    layoutTotalMs: layoutTotal,
-                    renderTotalMs: renderTotal,
-                    copyTotalMs: copyTotal,
-                    auxTotalMs: auxTotal,
-                    otherTotalMs: otherTotal,
-                    layoutAvgMs: frameTimes.length > 0 ? layoutTotal / frameTimes.length : 0,
-                    renderAvgMs: frameTimes.length > 0 ? renderTotal / frameTimes.length : 0,
-                    copyAvgMs: frameTimes.length > 0 ? copyTotal / frameTimes.length : 0,
-                    auxAvgMs: frameTimes.length > 0 ? auxTotal / frameTimes.length : 0,
-                    otherAvgMs: frameTimes.length > 0 ? otherTotal / 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((f) => f > 16.67).length,
-                    sampleCount: frameTimes.length,
-                  }
-                }
-                // main-thread mode
-                const perf = window.__sootsimPerf
-                const a11y = window.__sootsimA11y
-                if (!perf && !a11y) return { error: 'no perf globals' }
-
-                const frameStats = perf?.getFrameStats?.() || {}
-                const profile = a11y?.profile?.() || {}
-
-                // calculate distribution
-                const recent = frameStats.recentFrames || []
-                const sorted = [...recent].sort((a, b) => a - b)
-                const p50 = sorted[Math.floor(sorted.length * 0.5)] || 0
-                const p95 = sorted[Math.floor(sorted.length * 0.95)] || 0
-                const p99 = sorted[Math.floor(sorted.length * 0.99)] || 0
-
-                // disable collection
-                perf?.disableFrameStats?.()
-                window.${se} = {
-                  ...(window.${se} || {}),
-                  active: false,
-                  mode: 'main-thread',
-                  lastSamples: recent.map((ms, index) => [index, ms, 0, 0, 0, 0, 0]),
-                  stoppedAt: performance.now(),
-                }
-
-                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, p95, p99,
-                  jankFrames: recent.filter(f => f > 16.67).length,
-                  sampleCount: recent.length,
-                }
-              })()`});if(t.error&&(console.error(`  error: ${t.error}`),process.exit(1)),E(l)){C(t);break}let n=t.avgMs>0?(1e3/t.avgMs).toFixed(1):"?",r=t.sampleCount>0?(t.jankFrames/t.sampleCount*100).toFixed(1):"0";console.log(`  profiling stopped:
-`),console.log(`    frames:     ${t.frames}`),console.log(`    total:      ${t.totalMs.toFixed(1)}ms`),console.log(`    avg:        ${t.avgMs.toFixed(2)}ms (${n} fps)`),console.log(`    max:        ${t.maxMs.toFixed(2)}ms`),console.log(""),t.layoutAvgMs!==void 0&&(console.log("    breakdown (avg per frame):"),console.log(`      layout:   ${t.layoutAvgMs.toFixed(2)}ms`),console.log(`      render:   ${t.renderAvgMs.toFixed(2)}ms`),console.log(`      copy:     ${t.copyAvgMs.toFixed(2)}ms`),t.auxAvgMs!==void 0&&console.log(`      aux:      ${t.auxAvgMs.toFixed(2)}ms`),t.otherAvgMs!==void 0&&console.log(`      other:    ${t.otherAvgMs.toFixed(2)}ms`),console.log("")),console.log(`    distribution (${t.sampleCount} samples):`),console.log(`      p50:      ${t.p50.toFixed(2)}ms`),console.log(`      p95:      ${t.p95.toFixed(2)}ms`),console.log(`      p99:      ${t.p99.toFixed(2)}ms`),console.log(`      jank:     ${t.jankFrames} frames (${r}%) >16.67ms`);break}case"frames":{let t=a[2]?Number(a[2]):50;(!Number.isFinite(t)||t<=0)&&(console.error(`  error: expected a positive frame count, got "${a[2]}"`),process.exit(1));let n=await u.send({type:"evaluate",code:`(async () => {
-                if (window.__sootsimRenderHost) {
-                  const session = window.${se} || {}
-                  if (session.active) {
-                    const priorSamples = Array.isArray(session.lastSamples) ? session.lastSamples : []
-                    const flushedSamples = await window.__sootsimRenderHost.flushSamples()
-                    const samples = priorSamples.concat(flushedSamples)
-                    window.__sootsimRenderHost.startSampling()
-                    window.${se} = {
-                      ...session,
-                      active: true,
-                      mode: 'render-worker',
-                      lastSamples: samples,
-                      lastFlushAt: performance.now(),
-                    }
-                    return {
-                      mode: 'render-worker',
-                      live: true,
-                      samples: samples.slice(-${t}),
-                    }
-                  }
-                  return {
-                    mode: 'render-worker',
-                    live: false,
-                    samples: (session.lastSamples || []).slice(-${t}),
-                  }
-                }
-                // main-thread mode
-                const perf = window.__sootsimPerf
-                if (!perf) return { error: 'no __sootsimPerf (try "perf start" first)' }
-                const stats = perf.getFrameStats?.() || {}
-                return {
-                  mode: 'main-thread',
-                  frames: (stats.recentFrames || []).slice(-${t}),
-                }
-              })()`});if(n.error&&(console.error(`  error: ${n.error}`),process.exit(1)),E(l)){C(n);break}if(n.mode==="render-worker"){let s=Array.isArray(n.samples)?n.samples:[];if(s.length===0){console.log(`  no frame data \u2014 run '${h("perf")} start' first`);break}console.log(`  last ${s.length} sampled frames (ms):`),console.log("    total    layout   render   copy     aux    other     t+");for(let[d,m,y,p,x,A,H]of s)console.log(`    ${m.toFixed(2).padStart(7)}  ${y.toFixed(2).padStart(7)}  ${p.toFixed(2).padStart(7)}  ${x.toFixed(2).padStart(7)}  ${A.toFixed(2).padStart(6)}  ${H.toFixed(2).padStart(7)}  ${String(d).padStart(5)}`);console.log(""),Ee(s.map(d=>d[1])),n.live&&console.log("  sampling continues");break}let r=Array.isArray(n.frames)?n.frames:Array.isArray(n)?n:[];if(r.length===0){console.log(`  no frame data \u2014 run '${h("perf")} start' first`);break}console.log(`  last ${r.length} frame times (ms):`),console.log(`    ${r.map(s=>s.toFixed(2)).join(", ")}`),Ee(r);break}case"worst":{let t=a[2]?Number(a[2]):20;(!Number.isFinite(t)||t<=0)&&(console.error(`  error: expected a positive frame count, got "${a[2]}"`),process.exit(1));let n=await u.send({type:"evaluate",code:`(async () => {
-                if (window.__sootsimRenderHost) {
-                  const session = window.${se} || {}
-                  if (session.active) {
-                    const priorSamples = Array.isArray(session.lastSamples) ? session.lastSamples : []
-                    const flushedSamples = await window.__sootsimRenderHost.flushSamples()
-                    const samples = priorSamples.concat(flushedSamples)
-                    window.__sootsimRenderHost.startSampling()
-                    window.${se} = {
-                      ...session,
-                      active: true,
-                      mode: 'render-worker',
-                      lastSamples: samples,
-                      lastFlushAt: performance.now(),
-                    }
-                    return {
-                      mode: 'render-worker',
-                      live: true,
-                      samples: samples
-                        .slice()
-                        .sort((a, b) => b[1] - a[1])
-                        .slice(0, ${t}),
-                    }
-                  }
-                  const samples = Array.isArray(session.lastSamples) ? session.lastSamples : []
-                  return {
-                    mode: 'render-worker',
-                    live: false,
-                    samples: samples
-                      .slice()
-                      .sort((a, b) => b[1] - a[1])
-                      .slice(0, ${t}),
-                  }
-                }
-                const perf = window.__sootsimPerf
-                if (!perf) return { error: 'no __sootsimPerf (try "perf start" first)' }
-                const stats = perf.getFrameStats?.() || {}
-                const recent = Array.isArray(stats.recentFrames) ? stats.recentFrames : []
-                return {
-                  mode: 'main-thread',
-                  frames: recent.slice().sort((a, b) => b - a).slice(0, ${t}),
-                }
-              })()`});if(n.error&&(console.error(`  error: ${n.error}`),process.exit(1)),E(l)){C(n);break}if(n.mode==="render-worker"){let s=Array.isArray(n.samples)?n.samples:[];if(s.length===0){console.log(`  no frame data \u2014 run '${h("perf")} start' first`);break}console.log(`  worst ${s.length} sampled frames (ms):`),console.log("    total    layout   render   copy     aux    other     t+");for(let[d,m,y,p,x,A,H]of s)console.log(`    ${m.toFixed(2).padStart(7)}  ${y.toFixed(2).padStart(7)}  ${p.toFixed(2).padStart(7)}  ${x.toFixed(2).padStart(7)}  ${A.toFixed(2).padStart(6)}  ${H.toFixed(2).padStart(7)}  ${String(d).padStart(5)}`);n.live&&(console.log(""),console.log("  sampling continues"));break}let r=Array.isArray(n.frames)?n.frames:Array.isArray(n)?n:[];if(r.length===0){console.log(`  no frame data \u2014 run '${h("perf")} start' first`);break}console.log(`  worst ${r.length} frame times (ms):`),console.log(`    ${r.map(s=>s.toFixed(2)).join(", ")}`);break}case"transition":{let t=a[2];if(!t||!["goHome","appSwitcher","lockScreen"].includes(t)){console.log(`
-  ${h("perf")} transition <event> \u2014 profile a shell transition
-
-  events:
-    goHome          swipe-to-home animation
-    appSwitcher     app switcher card animation
-    lockScreen      lock screen transition
-
-  note: uses 600ms capture window \u2014 may need --timeout 10000 flag
-
-  examples:
-    ${h("perf")} transition goHome --timeout 10000
-    ${h("perf")} transition appSwitcher
-`);break}let r=`sootsim:${t}`;_e(`  profiling ${t} transition...`),_e("  (use --timeout 10000 if this times out)");let s=await u.send({type:"evaluate",code:`(async () => {
-                // only supported in render-worker mode
-                if (!window.__sootsimRenderHost) {
-                  return { error: 'transition profiling requires render-worker mode' }
-                }
-
-                // start sampling
-                window.__sootsimRenderHost.startSampling()
-
-                // give a frame for sampling to start
-                await new Promise(r => requestAnimationFrame(() => r(undefined)))
-
-                // dispatch the shell event
-                window.dispatchEvent(new Event('${r}'))
-
-                // wait 600ms for transition to complete (shell animations are ~300-500ms)
-                // using fixed timing avoids complex animation-end detection
-                await new Promise(r => setTimeout(r, 600))
-
-                // flush samples and compute stats
-                const samples = await window.__sootsimRenderHost.flushSamples()
-                const frameTimes = samples.map(s => s[1])
-                const layoutTimes = samples.map(s => s[2])
-                const renderTimes = samples.map(s => s[3])
-                const copyTimes = samples.map(s => s[4])
-                const auxTimes = samples.map(s => s[5] || 0)
-                const otherTimes = samples.map(s => s[6] || 0)
-                const sorted = [...frameTimes].sort((a, b) => a - b)
-                const total = frameTimes.reduce((a, b) => a + b, 0)
-                const avg = frameTimes.length > 0 ? total / frameTimes.length : 0
-                const max = Math.max(...frameTimes, 0)
-                const layoutTotal = layoutTimes.reduce((a, b) => a + b, 0)
-                const renderTotal = renderTimes.reduce((a, b) => a + b, 0)
-                const copyTotal = copyTimes.reduce((a, b) => a + b, 0)
-                const auxTotal = auxTimes.reduce((a, b) => a + b, 0)
-                const otherTotal = otherTimes.reduce((a, b) => a + b, 0)
-
-                return {
-                  event: '${t}',
-                  frames: frameTimes.length,
-                  totalMs: total,
-                  avgMs: avg,
-                  maxMs: max,
-                  layoutTotalMs: layoutTotal,
-                  renderTotalMs: renderTotal,
-                  copyTotalMs: copyTotal,
-                  auxTotalMs: auxTotal,
-                  otherTotalMs: otherTotal,
-                  layoutAvgMs: frameTimes.length > 0 ? layoutTotal / frameTimes.length : 0,
-                  renderAvgMs: frameTimes.length > 0 ? renderTotal / frameTimes.length : 0,
-                  copyAvgMs: frameTimes.length > 0 ? copyTotal / frameTimes.length : 0,
-                  auxAvgMs: frameTimes.length > 0 ? auxTotal / frameTimes.length : 0,
-                  otherAvgMs: frameTimes.length > 0 ? otherTotal / 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(f => f > 16.67).length,
-                  samples,
-                }
-              })()`});if(s.error&&(console.error(`  error: ${s.error}`),process.exit(1)),E(l)){C(s);break}if(s.warning&&console.log(`  warning: ${s.warning}`),s.frames===0){console.log("  no frames captured");break}let d=s.avgMs>0?(1e3/s.avgMs).toFixed(1):"?",m=s.frames>0?(s.jankFrames/s.frames*100).toFixed(1):"0";console.log(`  ${t} transition profiled:
-
-    frames:     ${s.frames}
-    total:      ${s.totalMs.toFixed(1)}ms
-    avg:        ${s.avgMs.toFixed(2)}ms (${d} fps)
-    max:        ${s.maxMs.toFixed(2)}ms
-
-    breakdown (avg per frame):
-      layout:   ${s.layoutAvgMs?.toFixed(2)||"?"}ms
-      render:   ${s.renderAvgMs?.toFixed(2)||"?"}ms
-      copy:     ${s.copyAvgMs?.toFixed(2)||"?"}ms
-      aux:      ${s.auxAvgMs?.toFixed(2)||"?"}ms
-      other:    ${s.otherAvgMs?.toFixed(2)||"?"}ms
-
-    distribution (${s.frames} samples):
-      p50:      ${s.p50.toFixed(2)}ms
-      p95:      ${s.p95.toFixed(2)}ms
-      p99:      ${s.p99.toFixed(2)}ms
-      jank:     ${s.jankFrames} frames (${m}%) >16.67ms`),Array.isArray(s.samples)&&s.samples.length>0&&(console.log(""),Ee(s.samples.map(y=>y[1])));break}default:console.error(`  unknown perf subcommand: ${e}`),console.error("  valid: stats, start, stop, frames, worst, transition"),/^--?reset$/.test(e)&&console.error("  note: 'perf start' already clears prior frames \u2014 no reset needed"),process.exit(1)}break}case"errors":{let e=a[1];if(e==="clear"){await st(u),E(l)?C({cleared:!0}):console.log("  error buffer cleared");break}let t=e?Number(e):20,n=await tt(u,t);if(E(l)){C(n);break}if(n.length===0){console.log("  no errors captured");break}console.log(`  ${n.length} error(s):
-`);for(let r of n){let s=re(r.timestamp),d=r.args.map(m=>typeof m=="object"?JSON.stringify(m):m).join(" ");if(console.log(`  [${s}] ${d}`),r.stack){let m=r.stack.split(`
-`).slice(0,3);for(let y of m)console.log(`    ${y.trim()}`)}}break}case"warnings":{let e=a[1]?Number(a[1]):20,t=await ot(u,e);if(E(l)){C(t);break}if(t.length===0){console.log("  no warnings captured");break}console.log(`  ${t.length} warning(s):
-`);for(let n of t){let r=re(n.timestamp),s=n.args.map(d=>typeof d=="object"?JSON.stringify(d):d).join(" ");console.log(`  [${r}] ${s}`)}break}case"animations":{let e=await X(u,"listAnimations")??[];if(o.includes("--json")){console.log(JSON.stringify(e,null,2));break}if(e.length===0){console.log("  no active animations");break}console.log(`  ${e.length} active animation(s):
-`);for(let t of e){let n=String(t.kind).padEnd(6),r=`${Number(t.from).toFixed(2)}\u2192${Number(t.to).toFixed(2)}`,s=Number(t.current??0).toFixed(2),d=`${Math.round((t.progress??0)*100)}%`,m=`${Math.round(t.elapsedMs??0)}ms`,y=t.loop?" loop":"",p=t.layoutBound?" layout":"";console.log(`  #${t.id}  ${n} ${r.padEnd(14)} cur=${s.padEnd(7)} ${d.padStart(4)}  ${m}${y}${p}`)}break}case"animation":{let e=a[1];(!e||e==="--help"||e==="-h")&&(console.error(`  usage: ${h("animation")} <id>`),process.exit(1));let t=Number(e);Number.isFinite(t)||(console.error(`  invalid id: ${e}`),process.exit(1));let n=await X(u,"getAnimation",t);console.log(JSON.stringify(n,null,2));break}case"stop-animation":{let e=a[1];(!e||e==="--help"||e==="-h")&&(console.error(`  usage: ${h("stop-animation")} <id|all>`),process.exit(1));let t=e==="all"?"all":Number(e);t!=="all"&&!Number.isFinite(t)&&(console.error(`  invalid id: ${e}`),process.exit(1));let n=await X(u,"stopAnimation",t);console.log(`  stopped ${n??0} animation(s)`);break}case"requests":{let e=a[1];if(e==="clear"){await rt(u),E(l)?C({cleared:!0}):console.log("  request buffer cleared");break}let t=e==="all",n=t?a[2]:e,r=n?Number(n):20,s=await nt(u,{failed:!t,limit:r});if(E(l)){C(s);break}if(s.length===0){console.log(t?"  no requests captured":"  no failed requests captured");break}console.log(`  ${s.length} ${t?"request(s)":"failed request(s)"}:
-`);for(let d of s){let m=re(d.timestamp);console.log(`  [${m}] ${ee(d)}`),d.responseBody?console.log(`    ${d.responseBody}`):d.error&&console.log(`    ${d.error}`)}break}case"network":{let e=a[1],t=null,n=null,r=!1,s=!1,d=1e3,m=!1,y=!1;for(let N=0;N<l.length;N++){let w=l[N];if(w==="--filter")t=l[N+1]??null,N++;else if(w==="--limit"){let v=Number(l[N+1]);Number.isFinite(v)&&(n=v),N++}else if(w==="--threshold"){let v=Number(l[N+1]);Number.isFinite(v)&&v>0&&(d=v),N++}else w==="--failed"?r=!0:w==="--slow"?s=!0:w==="--tail"||w==="-f"?m=!0:w==="--json"&&(y=!0)}if(e==="clear"){await u.send({type:"evaluate",code:'window.__sootsimObservability?.network.clear(); "cleared"'}),console.log("  network buffer cleared");break}if(e==="get"){let N=a[2];N||(console.error("  usage: sootsim network get <id>"),process.exit(1));let w=await u.send({type:"evaluate",code:`(() => {
-              const obs = window.__sootsimObservability;
-              if (!obs) return null;
-              return obs.network.getSnapshot().find(e => e.id === ${JSON.stringify(N)}) || null;
-            })()`});w||(console.error(`  no entry with id ${N}`),process.exit(1)),y?console.log(JSON.stringify(w,null,2)):No(w);break}let p=n??(m?200:e?Number(e):20);Number.isFinite(p)||(console.error(`  invalid limit: ${e} \u2014 \`network\` takes a numeric count (e.g. ${h("network")} 100).
-  to target a specific sim, use \`--sim ${e}\` instead.`),process.exit(1));let x=async()=>{let N=await u.send({type:"evaluate",code:`(() => {
-              const obs = window.__sootsimObservability;
-              if (!obs) return { ok: false };
-              return { ok: true, entries: obs.network.getSnapshot() };
-            })()`});if(!N||!N.ok)throw new Error("observability bridge not installed \u2014 is the engine running?");return N.entries??[]},A=N=>{let w=N;if(r&&(w=w.filter(v=>!!v.error||v.status!=null&&v.status>=400)),s&&(w=w.filter(v=>v.durationMs!=null&&v.durationMs>=d)),t){let v=t.toLowerCase();w=w.filter(P=>(P.displayUrl||P.url).toLowerCase().includes(v))}return s&&!m&&(w=[...w].sort((v,P)=>(P.durationMs??0)-(v.durationMs??0))),w};if(!m){let N=await x(),w=A(N).slice(-p);if(y){console.log(JSON.stringify(w,null,2));break}if(w.length===0){N.length===0?console.log("  no network requests captured"):console.log(s?`  no requests slower than ${d}ms (${N.length} total \u2014 try --threshold <ms>)`:"  no matching requests");break}console.log(s?`  ${w.length} request(s) slower than ${d}ms (sorted by duration desc):
-`:`  ${w.length} request(s):
-`);for(let v of w)Jt(v);break}console.log(`  tailing network (ctrl-c to stop)...
-`);let H=new Set,U=!0,K=()=>{U=!1};process.on("SIGINT",K);try{for(;U;){let N=await x(),w=A(N);for(let v of w)v.durationMs!=null&&(H.has(v.id)||(H.add(v.id),y?console.log(JSON.stringify(v)):Jt(v)));await Q(250)}}finally{process.off("SIGINT",K)}break}case"logs":{let e=a[1],t=null,n=null,r=null,s=!1,d=!1,m=!1;for(let w=0;w<l.length;w++){let v=l[w];if(v==="--filter")t=l[w+1]??null,w++;else if(v==="--limit"){let P=Number(l[w+1]);Number.isFinite(P)&&(n=P),w++}else v==="--level"?(r=l[w+1]??null,w++):v==="--tail"||v==="-f"?s=!0:v==="--json"?d=!0:(v==="--internal"||v==="--all")&&(m=!0)}let y=r?new Set(r.split(",").map(w=>w.trim()).filter(w=>w==="log"||w==="info"||w==="warn"||w==="error"||w==="debug")):null;if(e==="clear"){await at(u),console.log("  log buffer cleared");break}let p=!d&&process.stdout.isTTY===!0,x=n??(s?500:e?Number(e):50);Number.isFinite(x)||(console.error(`  invalid limit: ${e} \u2014 \`logs\` takes a numeric count (e.g. ${h("logs")} 100).
-  to target a specific sim, use \`--sim ${e}\` instead.`),process.exit(1));let A=()=>it(u),H=w=>lt(w,{level:y,filter:t,showInternal:m});if(!s){let w=await A(),v=H(w).slice(-x);if(d){console.log(JSON.stringify(v,null,2));break}if(v.length===0){console.log(w.length===0?"  no logs captured":"  no matching logs");break}console.log(`  ${v.length} log(s):
-`);for(let P of v)qt(P,p);break}console.log(`  tailing logs (ctrl-c to stop)...
-`);let U=new Set,K=!0,N=()=>{K=!1};process.on("SIGINT",N);try{for(;K;){let w=await A(),v=H(w);for(let P of v)U.has(P.id)||(U.add(P.id),d?console.log(JSON.stringify(P)):qt(P,p));await Q(250)}}finally{process.off("SIGINT",N)}break}default:console.error(`  unknown subcommand: ${g}`),process.exit(1)}if(ce.has(g)&&!o.includes("--no-wait")&&process.env.SOOTSIM_NO_AUTO_WAIT!=="1"&&!await Ke(u,g)&&await $(u),!j.has(g)&&!E(l))try{await ae(u)}catch{}}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`  ${g??"inspect"} failed: ${t}`);let n=/^no sim connected with id (.+)$/.exec(t),r=/^command timed out after (\d+)s$/.exec(t),s=t.startsWith("sim disconnected:")||t.startsWith("bridge never reconnected")||t.startsWith("could not connect to ws://");if(n)await bt(u,_,n[1]);else if(/^no sim connected$/.test(t))ht(_);else if(r)if(await vo(u)){let m=g??"describe";process.stderr.write(`  the sim is still responsive \u2014 '${m}' just exceeded the ${r[1]}s command budget.
-  the screen's node tree is large; narrow the query or raise the budget:
-    sootsim ${m} --testid <id>     # scope to one subtree
-    sootsim find --testid <id>       # targeted single-node lookup
-    sootsim ${m} --timeout 60000   # raise per-command budget (ms)
-`)}else jt();else if(s)jt();else{try{await ft(u)}catch{}try{await fe({includeTail:!0})}catch{}try{await ne({includeTail:!0})}catch{}}process.exit(1)}finally{u.close()}}export{hn as runInspect};