sootsim 0.0.4 → 0.1.37

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

@@ -0,0 +1,1101 @@
+/*! sootsim v0.1.37 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{a as G}from"./chunk-JMGDVXAV.js";import{a as Re,b as Ee}from"./chunk-T5L73GJB.js";import{a as X,b as D,c as B,d as K,e as ce,f as oe,g as ne,h as Ce,i as De,j as he}from"./chunk-X6BP5JFC.js";import{a as Ae,e as le}from"./chunk-DSTV2VJT.js";import{b as Be,h as Le}from"./chunk-2ZPJHSIJ.js";import"./chunk-QWKO62QM.js";import{a as Oe}from"./chunk-Z5X3PITK.js";import"./chunk-HYYMBXIX.js";import"./chunk-YFXTO4QX.js";import"./chunk-WLIVBPPY.js";import"./chunk-JMU5IGIU.js";import{a as ge,c as ye,d as Me}from"./chunk-FCQLQ7NA.js";import{a as Te}from"./chunk-4OHVCGMF.js";import"./chunk-4IO3D5XG.js";import{c as Ne,e as _e,f as Fe,g as Pe,h as be}from"./chunk-ZERYEI3L.js";import{b as Ie}from"./chunk-PERKPZ7T.js";import"./chunk-ERLA3F77.js";import"./chunk-PN6FWLD4.js";import"./chunk-B3RAGRK6.js";import{existsSync as vt,mkdirSync as kt,readFileSync as Tt,rmSync as je,writeFileSync as Mt}from"fs";import{tmpdir as It}from"os";import{dirname as Nt,join as _t,resolve as Ft}from"path";var re=1,Pt="SOOTSIM_INSPECT_NOTICE_PATH",At=300*1e3,Ot=15e3;function Je(){return Ft(process.env[Pt]||_t(It(),"sootsim-inspect-notice-state.json"))}function Rt(t,l){return Object.fromEntries(Object.entries(t).filter(([,a])=>typeof a?.signature=="string"&&Number.isFinite(a?.updatedAt)&&l-a.updatedAt<=At))}function Et(t){let l=Je();if(!vt(l))return{version:re,entries:{}};try{let a=JSON.parse(Tt(l,"utf8"));return a.version!==re||!a.entries||typeof a.entries!="object"?(je(l,{force:!0}),{version:re,entries:{}}):{version:re,entries:Rt(a.entries,t)}}catch{return je(l,{force:!0}),{version:re,entries:{}}}}function Ct(t){let l=Je();kt(Nt(l),{recursive:!0}),Mt(l,JSON.stringify(t,null,2)+`
+`)}function Dt(t,l){let a=l.trim()||"default";return`${t}:${a}`}function we(t,l,a,d={}){let u=d.nowMs??Date.now(),i=d.cooldownMs??Ot,b=Et(u),k=Dt(t,l),$=b.entries[k];return $&&$.signature===a&&u-$.updatedAt<i?!1:(b.entries[k]={signature:a,updatedAt:u},Ct(b),!0)}async function He(t,l={args:[]}){let a=await t.send({type:"evaluate",code:"(async () => await window.__sootsimTest.getNodeCount())()"}),d=typeof a=="number"?a:0;if(D(l.args)){B({nodes:d});return}console.log(`  nodes: ${d}`)}function xe(t,l){let a=t.indexOf(l);return a>=0&&a+1<t.length?t[a+1]:null}async function qe(t){let{bridge:l,args:a,positional:d}=t,u=a.includes("--verbose")||a.includes("-v"),i=D(a),b=u&&!i,k=a.includes("--watch")||a.includes("-w"),$=1e3,N=a.includes("--compact"),h=a.includes("--no-xy"),S=xe(a,"--testid-like"),F=xe(a,"--only"),I=xe(a,"--subtree"),C=d[1],c=C?/[*?]/.test(C):!1,J=!c&&!F?C:void 0,L=F??(c?C:void 0),O=async()=>{await ce(l,{verbose:b});let Z=`(async () => {
+      const t = window.__sootsimTest
+      const mainShell = window.SootSim?.bridges?.mainShell
+      const kb = window.__sootsimKeyboard
+      if (!t) return { error: 'no test bridge' }
+
+      let shell = null
+      try {
+        shell = typeof mainShell?.getState === 'function' ? await mainShell.getState() : null
+      } catch {}
+
+      const tree = await t.dumpTree(12, ${JSON.stringify({describe:!0,verbose:u,filter:J||"",testIdLike:S||void 0,onlyGlob:L||void 0,subtreeRoot:I||void 0,compact:N,hideXy:h})})
+      const nodeCount = (await t.getNodeCount?.()) || 0
+      const keyboard = kb && typeof kb.getLayout === 'function' ? kb.getLayout() : null
+      return { tree, shell, nodeCount, keyboard }
+    })()`,Y=await l.send({type:"evaluate",code:Z}),w=Y?.tree,_=Y?.shell,W=Y?.keyboard;if(i){B({shell:_,tree:w??"",keyboard:W});return}if(_&&typeof _=="object"){let E=[_.state?`state=${_.state}`:null,_.activeApp?`app=${_.activeApp}`:null,_.showSwitcher?"switcher":null,_.switcherPhase&&_.switcherPhase!=="idle"?`phase=${_.switcherPhase}`:null].filter(Boolean);E.length>0&&console.log(`  shell: ${E.join(" ")}`)}if(typeof w=="string"&&w.startsWith("__SUBTREE_NOT_FOUND__:")){let E=w.slice(22);console.log(`  subtree root not found: ${E}`),G("subtree-root-not-found",E);return}if(!w){let E=Y?.nodeCount??0;console.log("  no matching nodes found"),!(J||S||L||I)&&E<10&&G("app-still-loading",E);return}if(console.log(w),!(J||S||L||I)&&!k&&w.split(`
+`).length>=80&&G("describe-use-filters"),W&&W.visible){let E=W.spec,V=[E?.keyboardType?`type=${E.keyboardType}`:null,E?.returnKeyType&&E.returnKeyType!=="default"?`return=${E.returnKeyType}`:null,W.mode!=="letters"?`mode=${W.mode}`:null,W.shifted?"shift":null,W.capsLock?"caps":null,E?.autoCapitalize&&E.autoCapitalize!=="sentences"?`autoCap=${E.autoCapitalize}`:null,W.accessoryBarId?`accessory=${W.accessoryBarId}`:null].filter(Boolean);console.log(`
+  keyboard: ${V.join(" ")||"visible"}`)}};if(k)for(console.log(`  watching... (Ctrl+C to stop)
+`);;)console.clear(),await O(),await X($);else await O()}var Bt=["SOOTSIM_AGENT","CLAUDECODE","CLAUDE_CODE_ENTRYPOINT","CLAUDE_CODE_SESSION_ID","CODEX_THREAD_ID","CURSOR_TRACE_ID","AIDER_MODEL"];function We(){if(process.env.SOOTSIM_AGENT==="0")return!1;for(let t of Bt){let l=process.env[t];if(l&&l.trim()&&l!=="0")return!0}return!1}async function Ge(t){let{bridge:l,args:a,effectiveArgs:d,positional:u,inspectUsage:i}=t,b=w=>{let _=d.indexOf(w);return _>=0&&_+1<d.length?d[_+1]:null},k=w=>d.includes(w),$=b("--testid")||b("--test-id"),N=b("--role"),h=b("--type"),S=b("--text"),F=k("--pressable"),I=k("--visible"),C=k("--interactive-targets")||k("--actions"),c=!$&&!N&&!h&&!S&&!F&&!I&&!C?u[1]:null,J=S??c,L,O;$?(O="testid",L=`(async () => {
+      const t = window.__sootsimTest
+      return (await t.findByTestId(${JSON.stringify($)})) || (await t.findById(${JSON.stringify($)}))
+    })()`):N?(O="role",L=`(async () => await window.__sootsimTest.queryAll({ hasRole: ${JSON.stringify(N)}, pruneHidden: true }))()`):h?(O="type",L=`(async () => await window.__sootsimTest.queryAll({ type: ${JSON.stringify(h)}, pruneHidden: true }))()`):F?(O="pressable",L=`(async () => {
+      const t = window.__sootsimTest
+      const all = await t.queryAll({ pruneHidden: true })
+      return all.filter(n => n.pressable)
+    })()`):C?(O="interactive-targets",L=`(async () => {
+      const t = window.__sootsimTest
+      const all = await t.queryAll({ pruneHidden: true })
+      return all.filter(n => n.pressable && n.layout && n.layout.width > 0 && n.layout.height > 0)
+    })()`):I?(O="visible",L=`(async () => {
+      const all = await window.__sootsimTest.queryAll({ pruneHidden: true })
+      return all.filter(n => n.layout && n.layout.width > 0 && n.layout.height > 0)
+    })()`):J?(O="text",L=`(async () => await window.__sootsimTest.findByText(${JSON.stringify(J)}))()`):(console.error(i("find","<text> | --text <t> | --testid <id> | --role <r> | --type <t> | --pressable | --visible | --interactive-targets")),process.exit(1));let H=await l.send({type:"evaluate",code:L}),Z=D(a),Y=a.includes("--verbose")||a.includes("--dump");if(Z)O==="interactive-targets"&&Array.isArray(H)?B(Ke(H).map(w=>({...w,tap:Ue(w)}))):B(H??null);else if(Array.isArray(H))if(H.length===0){console.log(`  no ${O} nodes found`);let w=await l.send({type:"evaluate",code:"(async () => (await window.__sootsimTest?.getNodeCount?.()) || 0)()"});typeof w=="number"&&w<10&&G("app-still-loading",w)}else if(O==="interactive-targets"){let w=Ke(H);console.log(`  found ${w.length} interactive target${w.length===1?"":"s"} (sorted by score):`);for(let _ of w.slice(0,20)){let W=_.absolutePosition?`@(${Math.round(_.absolutePosition.x)},${Math.round(_.absolutePosition.y)})`:"",ee=_.layout?`${Math.round(_.layout.width)}x${Math.round(_.layout.height)}`:"?x?",E=_.text?` "${_.text.slice(0,30)}"`:"",V=_.testID?` #${_.testID}`:"",e=_.accessibilityLabel?` \u24D8"${String(_.accessibilityLabel).slice(0,24)}"`:"",o=_.accessibilityRole?`[${_.accessibilityRole}]`:_.type,s=Ue(_);console.log(`    ${o}${E}${e}${V} ${ee} ${W}`),console.log(`      \u2192 ${s}`),Y&&console.log($e(JSON.stringify(_,null,2),"      "))}w.length>20&&console.log(`    ... and ${w.length-20} more`)}else{console.log(`  found ${H.length} node${H.length===1?"":"s"} (${O}):`);for(let w of H.slice(0,20)){let _=w.absolutePosition?`@(${Math.round(w.absolutePosition.x)},${Math.round(w.absolutePosition.y)})`:"",W=w.layout?`${Math.round(w.layout.width)}x${Math.round(w.layout.height)}`:"?x?",ee=w.text?` "${w.text.slice(0,30)}"`:"",E=w.testID?` #${w.testID}`:"",V=w.pressable?" (tap)":"",e=w.accessibilityRole?`[${w.accessibilityRole}]`:w.type;console.log(`    ${e}${ee}${E} ${W} ${_}${V}`),Y&&console.log($e(JSON.stringify(w,null,2),"      "))}H.length>20&&console.log(`    ... and ${H.length-20} more`)}else if(H==null)console.log(`  not found: ${J||$||N||h||""||O}`),$&&G("wait-selector-for-missing-testid",$);else{let w=H;if(w.type&&w.absolutePosition){let _=`@(${Math.round(w.absolutePosition.x)},${Math.round(w.absolutePosition.y)})`,W=w.layout?`${Math.round(w.layout.width)}x${Math.round(w.layout.height)}`:"?x?",ee=w.text?` "${w.text.slice(0,40)}"`:"",E=w.testID?` #${w.testID}`:"",V=w.pressable?" (tap)":"",e=w.accessibilityRole?`[${w.accessibilityRole}]`:w.type;console.log(`  ${e}${ee}${E} ${W} ${_}${V}`),Y&&console.log($e(JSON.stringify(w,null,2),"    "))}else console.log(JSON.stringify(H,null,2))}}function $e(t,l){return t.split(`
+`).map(a=>l+a).join(`
+`)}function Ke(t){return[...t].sort((l,a)=>ze(a)-ze(l))}function ze(t){let l=0;t.testID&&(l+=100),typeof t.text=="string"&&t.text.trim().length>0&&(l+=60),typeof t.accessibilityLabel=="string"&&t.accessibilityLabel.trim().length>0&&(l+=30),t.accessibilityRole&&(l+=15);let a=t.layout?.width??0,d=t.layout?.height??0,u=a*d;return u>=400&&u<=6e4?l+=25:u>6e4&&(l-=20),(t.absolutePosition?.y??0)<0&&(l-=30),l}function Ue(t){if(t.testID)return`sootsim do tap-id ${Ye(t.testID)}`;let l=typeof t.text=="string"?t.text.trim():"";if(l.length>0&&l.length<=80)return`sootsim do tap-text ${Ye(l)}`;let a=Math.round(((t.absolutePosition?.x??0)+(t.layout?.width??0)/2)*10)/10,d=Math.round(((t.absolutePosition?.y??0)+(t.layout?.height??0)/2)*10)/10;return`sootsim do tap ${a} ${d}`}function Ye(t){return/^[A-Za-z0-9_./@:-]+$/.test(t)?t:`'${t.replace(/'/g,"'\\''")}'`}async function Xe(t,l={}){let a=await t.send({type:"evaluate",code:`(() => {
+      const kb = window.__sootsimKeyboard
+      if (!kb || typeof kb.getLayout !== 'function') {
+        return { error: 'keyboard bridge getLayout() not available' }
+      }
+      return kb.getLayout()
+    })()`});if("error"in a&&(console.error(a.error),process.exit(1)),l.json){console.log(JSON.stringify(a,null,2));return}let{visible:d,spec:u,mode:i,shifted:b,capsLock:k,accessoryBarId:$}=a,N=[];N.push(`keyboard: ${d?"visible":"hidden"}`),u?(N.push(`  type:          ${u.keyboardType}`),N.push(`  returnKey:     ${u.returnKeyType}`),N.push(`  autoCap:       ${u.autoCapitalize}`),N.push(`  autoCorrect:   ${u.autoCorrect?"on":"off"}`),N.push(`  appearance:    ${u.keyboardAppearance}`),u.secureTextEntry&&N.push("  secureTextEntry: true"),u.enablesReturnKeyAutomatically&&N.push(`  return:        ${u.currentTextIsEmpty?"disabled (empty)":"enabled"}`)):N.push("  spec:          <none> (shown via dev-tools with no TextInput)"),N.push(`  mode:          ${i}${b?" (shifted)":""}${k?" (caps)":""}`),$&&N.push(`  accessoryBar:  ${$}`),console.log(N.join(`
+`))}async function Ve(t){let l=await t.bridge.listSims();if(D(t.args)){B(l.map(a=>({...a,active:a.id===t.simId})));return}Le(l,t.simId)}function te(t){return t<1024?`${t}B`:t<1024*1024?`${(t/1024).toFixed(1)}KB`:`${(t/1024/1024).toFixed(1)}MB`}function de(t,l){return l<=0?"?":`${(t/l*100).toFixed(0)}%`}async function Qe(t,l={args:[]}){let d=await t.send({type:"evaluate",code:`(async () => {
+      const host = window.__sootsimRenderHost
+      const stats = host?.queryStats ? await host.queryStats() : null
+      const hostMem = performance.memory
+        ? {
+            usedJSHeapSize: performance.memory.usedJSHeapSize,
+            totalJSHeapSize: performance.memory.totalJSHeapSize,
+            jsHeapSizeLimit: performance.memory.jsHeapSizeLimit,
+          }
+        : null
+      return {
+        imageLoader: stats?.memory?.imageLoader ?? null,
+        workerHeap: stats?.memory?.workerHeap ?? null,
+        hostHeap: hostMem,
+      }
+    })()`})??{};if(D(l.args)){B(d);return}if(console.log("  memory:"),d.imageLoader){let u=d.imageLoader;console.log("    image-loader cache"),console.log(`      entries:        ${u.cacheEntries} / ${u.cacheMaxEntries} (${de(u.cacheEntries,u.cacheMaxEntries)})`),console.log(`      pixel bytes:    ${te(u.cachePixelBytes)} / ${te(u.cachePixelBudget)} (${de(u.cachePixelBytes,u.cachePixelBudget)})`),console.log(`      pending:        ${u.pendingFetches} fetches, ${u.pendingBytes} bytes`),console.log(`      failed uris:    ${u.failedUris}`),console.log(`      snapshots:      ${u.snapshots}`),console.log(`      camera frames:  ${u.cameraFrames}`)}else console.log("    image-loader cache: not available (engine pre-rebuild?)");if(d.workerHeap){let u=d.workerHeap;console.log("    worker heap (chrome only)"),console.log(`      used:   ${te(u.usedJSHeapSize)} / ${te(u.jsHeapSizeLimit)} (${de(u.usedJSHeapSize,u.jsHeapSizeLimit)})`),console.log(`      total:  ${te(u.totalJSHeapSize)}`)}if(d.hostHeap){let u=d.hostHeap;console.log("    host heap (chrome only)"),console.log(`      used:   ${te(u.usedJSHeapSize)} / ${te(u.jsHeapSizeLimit)} (${de(u.usedJSHeapSize,u.jsHeapSizeLimit)})`),console.log(`      total:  ${te(u.totalJSHeapSize)}`)}}function ie(t){let l=t.indexOf("--testid");if(l>=0&&t[l+1])return{mode:"testid",value:t[l+1]};let a=t.indexOf("--test-id");if(a>=0&&t[a+1])return{mode:"testid",value:t[a+1]};let d=t.indexOf("--text");return d>=0&&t[d+1]?{mode:"text",value:t[d+1]}:null}async function ue(t,l){let a=JSON.stringify(l.value),d=l.mode==="testid"?`(await t.findByTestId(${a})) || (await t.findById(${a}))`:`await t.findByText(${a})`;return await t.send({type:"evaluate",code:`(async () => {
+      const t = window.__sootsimTest
+      if (!t) return null
+      const n = ${d}
+      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, testID: n.testID, text: n.text }
+    })()`})??null}async function Ze(t,l={}){let a=await t.send({type:"evaluate",code:`(async () => {
+      const test = window.__sootsimTest
+      const kb = window.__sootsimKeyboard
+      // host-side __sootsimTest is a Proxy that forwards every call to the
+      // tenant worker \u2014 every method returns a Promise, so we must await.
+      const navSnap =
+        test && typeof test.getNavigationSnapshot === 'function'
+          ? await test.getNavigationSnapshot()
+          : null
+      const keyboard =
+        kb && typeof kb.getLayout === 'function'
+          ? (() => {
+              const layout = kb.getLayout()
+              return layout ? {
+                visible: layout.visible,
+                mode: layout.mode,
+                spec: layout.spec
+                  ? {
+                      keyboardType: layout.spec.keyboardType,
+                      returnKeyType: layout.spec.returnKeyType,
+                    }
+                  : null,
+              } : null
+            })()
+          : null
+      return { nav: navSnap, keyboard }
+    })()`}),d=a?.nav??null,u=a?.keyboard??null,i=await oe(t,500).catch(()=>null);if(l.json){console.log(JSON.stringify({shell:i??null,nav:d,keyboard:u},null,2));return}let b=[];if(i){let k=i.activeApp??i.state??"<none>",$=i.showSwitcher?" (app switcher open)":"",N=typeof i.launchProgress=="number"&&i.launchProgress<.98?` launching (${Math.round(i.launchProgress*100)}%)`:"";b.push(`shell:    ${k}${$}${N}`)}else b.push("shell:    <unavailable>");if(d){let k=d.transitionPhase!=="idle"?` (${d.transitionPhase}, ${d.activeTransitionCount} active)`:"";if(b.push(`nav:      phase=${d.transitionPhase}${k}`),d.screens.length===0)b.push("  <no registered screens \u2014 app may not use react-native-screens>");else for(let $ of d.screens){let N=$.isActive?"\u25B6":" ",h=$.routeName?` ${$.routeName}`:"",S=$.headerHeight>0?` header=${$.headerHeight}`:"",F=$.largeTitleState&&$.largeTitleState!=="expanded"?` large-title=${$.largeTitleState}`:"";b.push(`  ${N} #${$.id}${h}${S}${F}`)}}else b.push("nav:      <runtime not available>");if(u&&u.visible){let k=u.spec?.keyboardType??"default",$=u.spec?.returnKeyType??"default";b.push(`keyboard: visible (${k}, return=${$}, mode=${u.mode??"?"})`)}else b.push("keyboard: hidden");console.log(b.join(`
+`))}async function se({bridge:t,maxMs:l,pollMs:a=50,stablePolls:d=3,strict:u=!1}){let i=await t.send({type:"evaluate",code:`(async () => {
+      const start = Date.now()
+      const deadline = start + ${Math.max(0,Math.round(l))}
+      const pollMs = ${Math.max(1,Math.round(a))}
+      const requiredStablePolls = ${Math.max(1,Math.round(d))}
+      const strict = ${u?"true":"false"}
+      const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+      const readSnapshot = async () => {
+        let animating = false
+        try {
+          const stats = await window.__sootsimRenderHost?.queryStats?.()
+          if (stats) {
+            animating =
+              stats.hasActiveAnims === true ||
+              stats.hasActiveNativeAnimations === true ||
+              stats.hasPendingAnimationFrames === true
+          }
+        } catch {}
+        const root = window.__sootsimRoot
+        const nodes = []
+        if (root) {
+          const walk = (n) => {
+            if (n.layout && n.layout.width > 0) {
+              nodes.push(Math.round(n.layout.x) + ',' + Math.round(n.layout.y) + ',' + Math.round(n.layout.width))
+            }
+            for (const c of n.children || []) walk(c)
+          }
+          walk(root)
+        }
+        return { layout: nodes.join(';'), animating }
+      }
+
+      let lastLayout = ''
+      let stable = 0
+      while (Date.now() < deadline) {
+        const snapshot = await readSnapshot()
+        const strictOk = !strict || !snapshot.animating
+        if (strictOk && snapshot.layout === lastLayout) {
+          stable++
+          if (stable >= requiredStablePolls) {
+            return { settled: true, elapsed: Date.now() - start }
+          }
+        } else {
+          stable = 0
+        }
+        lastLayout = snapshot.layout
+        await sleep(pollMs)
+      }
+      return { settled: false, elapsed: Date.now() - start }
+    })()`}),{elapsed:b,settled:k}=i??{};return{elapsed:typeof b=="number"?b:l,settled:k===!0}}async function et(t){let{bridge:l,args:a,positional:d}=t,u=d[1]?Number(d[1])*1e3:3e3,i=a.includes("--strict"),{elapsed:b,settled:k}=await se({bridge:l,maxMs:u,strict:i});console.log(k?`  settled in ${b}ms`:`  timed out after ${b}ms (may still be animating)`)}async function tt(t){let l=t.positional[1]?Number(t.positional[1]):.5;(!Number.isFinite(l)||l<0)&&(console.error(t.inspectUsage("sleep","[seconds]")),process.exit(1)),await X(l*1e3),console.log(`  slept ${l}s`)}async function ot(t){let{bridge:l,args:a,positional:d}=t,u=d[1]?Number(d[1]):5,i=await l.send({type:"evaluate",code:`(async () => await window.__sootsimTest.dumpTree(${u}))()`});if(D(a)){B({depth:u,tree:i??null});return}console.log(typeof i=="string"?i:JSON.stringify(i,null,2))}async function st(t,l={args:[]}){let a=await t.send({type:"evaluate",code:"window.location.href"}),d=typeof a=="string"?a:"";if(D(l.args)){B({url:d});return}console.log(d)}async function nt(t){let{wsPort:l,commandTimeoutMs:a,simId:d,positional:u}=t,i=u[1]?Number(u[1]):30,b=Math.max(1e3,(Number.isFinite(i)?i:30)*1e3),k=Math.max(1,Math.ceil(b/500));console.log("  waiting for sim reconnect...");let $=await Ce(l,a,d,{attempts:k});$||(console.error("  timed out waiting for sim reconnect"),process.exit(1)),$.bridge.close(),le({source:"inspect wait",step:{wait:b},summary:`wait ${Math.round(b/1e3)}s`}),console.log(`  ready: ${$.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 me(t,l){let a=t.indexOf(l);if(a>=0&&a+1<t.length)return t[a+1]}function Lt(t,l){if(!l.filter&&!l.equals)return!0;let a=t.data,d=[];if(a&&typeof a=="object")for(let i of["url","displayUrl","message","name","activeName","path","pathname","title","phase","event","type","kind"]){let b=a[i];typeof b=="string"&&b.length>0&&d.push(b)}let u=d.join(" ");return l.equals?d.some(i=>i===l.equals):l.filter?u.toLowerCase().includes(l.filter.toLowerCase()):!0}async function it(t){let{bridge:l,args:a,positional:d,inspectUsage:u}=t,i=d[1];i||(console.error(u("wait event","<kind> [--max-ms 5000] [--filter <substring>] [--equals <exact>] [--since now|cursor]")),process.exit(1)),rt.has(i)||console.error(`  warning: '${i}' is not a known timeline kind \u2014 waiting anyway. known: ${[...rt].sort().join(", ")}`);let b=me(a,"--max-ms"),k=b&&Number.isFinite(Number(b))?Math.max(100,Number(b)):5e3,$=me(a,"--filter"),N=me(a,"--equals"),h=me(a,"--since")??"now",S=a.includes("--json"),F=Date.now(),I=F+k,C=200,c=F;for(;Date.now()<I;){let L={kinds:[i],since:h==="cursor"?void 0:c,limit:50},O=await l.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(L)}) }
+      })()`});(!O||!O.ok)&&(console.error(`  could not query timeline: ${O&&"error"in O?O.error:"unknown"}`),process.exit(1));let H=O.result.events??[];for(let Z of H)if(Lt(Z,{filter:$,equals:N})){let Y=Date.now()-F;console.log(S?JSON.stringify({found:!0,elapsedMs:Y,event:Z}):`  ${i} event after ${Y}ms${$?` (filter: ${$})`:""}${N?` (equals: ${N})`:""}`);return}O.result.watermark&&O.result.watermark>c&&(c=O.result.watermark),await new Promise(Z=>setTimeout(Z,C))}let J=Date.now()-F;S?console.log(JSON.stringify({found:!1,elapsedMs:J,kind:i,filter:$,equals:N})):console.error(`  \u26A0 wait event ${i} timed out after ${J}ms${$?` (filter: ${$})`:""}${N?` (equals: ${N})`:""}`),process.exit(1)}async function at(t){let{bridge:l,args:a}=t,d=a.includes("--strict"),u=a.indexOf("--max-ms"),i=u>=0&&a[u+1]?Math.max(100,Number(a[u+1])):3e3,{elapsed:b,settled:k}=await se({bridge:l,maxMs:i,strict:d});k?console.log(`  idle in ${b}ms`):(console.error(`  \u26A0 wait idle timed out after ${b}ms (may still be animating)`),process.exit(1))}async function lt(t){let{bridge:l,args:a}=t,d=2e4,u=a.indexOf("--max-ms");u>=0&&a[u+1]&&(d=Math.max(100,Number(a[u+1])));let i=Date.now(),b=i+d,k=`(async () => {
+    const t = window.__sootsimTest
+    let nodes = 0
+    try { nodes = (await t?.getNodeCount?.()) || 0 } catch {}
+    return {
+      flag: (window).__sootsimExternalAppReady,
+      at: (window).__sootsimExternalAppReadyAt || 0,
+      nodes,
+    }
+  })()`,$={flag:void 0,at:0,nodes:0};for(;Date.now()<b;){try{$=await l.send({type:"evaluate",code:k})??$}catch{}if($.flag===!0){console.log(`  ready in ${Date.now()-i}ms: ${$.nodes} nodes (flag)`);return}await new Promise(N=>setTimeout(N,150))}console.error(`  \u26A0 wait ready timed out after ${Date.now()-i}ms \u2014 guest app did not emit sootsim:externalAppReady (nodes: ${$.nodes})`),process.exit(1)}async function ct(t){let{bridge:l,args:a,positional:d,inspectUsage:u}=t,i=d[1];i||(console.error(u("wait selector","<testid> [--max-ms 5000]")),process.exit(1));let b=a.indexOf("--max-ms"),k=b>=0&&a[b+1]?Math.max(100,Number(a[b+1])):5e3,$=await l.send({type:"evaluate",code:`(async () => {
+      const start = Date.now()
+      const deadline = start + ${k}
+      const t = window.__sootsimTest
+      const find = async () => {
+        try {
+          return (await t?.findByTestId?.(${JSON.stringify(i)})) ||
+            (await t?.findById?.(${JSON.stringify(i)})) || null
+        } catch {}
+        return null
+      }
+      while (Date.now() < deadline) {
+        const node = await find()
+        if (node && node.layout && node.layout.width > 0 && node.layout.height > 0) {
+          return { found: true, node, elapsed: Date.now() - start }
+        }
+        await new Promise((r) => setTimeout(r, 80))
+      }
+      return { found: false, elapsed: Date.now() - start }
+    })()`}),{found:N,node:h,elapsed:S}=$??{};if(N&&h){let F=h.absolutePosition?`@(${Math.round(h.absolutePosition.x)},${Math.round(h.absolutePosition.y)})`:"",I=h.layout?`${Math.round(h.layout.width)}x${Math.round(h.layout.height)}`:"?x?";console.log(`  found #${i} in ${S}ms ${I} ${F}`)}else console.error(`  \u26A0 wait selector #${i} timed out after ${S??k}ms`),process.exit(1)}function gt(t){return t==null?"\u2014":t<1024?`${t}B`:t<1024*1024?`${(t/1024).toFixed(1)}K`:`${(t/1024/1024).toFixed(1)}M`}function yt(t){return t==null?"   \u2026":t<1e3?`${t}ms`.padStart(5):`${(t/1e3).toFixed(2)}s`.padStart(5)}function Jt(t){return t.error?"err":t.status==null?" \u2026 ":String(t.status)}function dt(t){let l=new Date(t.startTs).toLocaleTimeString(),a=Jt(t).padEnd(3),d=t.method.padEnd(5),u=gt(t.size).padStart(6),i=yt(t.durationMs);console.log(`  [${l}] ${a} ${d} ${u} ${i}  ${t.displayUrl}`),t.error&&console.log(`           error: ${t.error}`)}function Ht(t){let l=[["id",t.id],["source",t.source],["kind",t.kind],["method",t.method],["status",t.error?`error: ${t.error}`:`${t.status??"\u2014"} ${t.statusText??""}`.trim()],["url",t.url],["started",new Date(t.startTs).toLocaleTimeString()],["duration",yt(t.durationMs).trim()],["size",gt(t.size)],["content-type",t.type??"\u2014"]];for(let[a,d]of l)console.log(`  ${a.padEnd(13)} ${d}`)}var qt={error:"\x1B[31m",warn:"\x1B[33m",info:"\x1B[36m",debug:"\x1B[35m",log:"\x1B[37m"},ut="\x1B[0m",Wt="\x1B[2m";function mt(t,l){let a=new Date(t.ts).toLocaleTimeString(),d=t.level.toUpperCase().padEnd(5),u=t.args.join(" ");if(l){let i=qt[t.level];console.log(`  ${Wt}[${a}]${ut} ${i}${d}${ut}  ${u}`)}else console.log(`  [${a}] ${d}  ${u}`);if(t.stack&&t.level==="error"){let i=t.stack.split(`
+`).slice(0,5);for(let b of i)console.log(`    ${b.trim()}`)}}var Q="__sootsimCliPerf",Kt=120;async function pt(t,l){let a=t.find((F,I)=>t[I-1]==="--id"),d=t.find((F,I)=>t[I-1]==="--text");if(a||d){let F=await l.send({type:"evaluate",code:Re({id:a,text:d})});if(!F)throw new Error(a?`no node with id "${a}"`:`no node matching text "${d}"`);let{x:I,y:C,w:c,h:J}=F;return{x:I,y:C,w:c,h:J}}let u=t.find((F,I)=>t[I-1]==="--area");if(u){let F=u.split(",").map(L=>Number(L.trim()));if(F.length!==4||F.some(L=>!Number.isFinite(L)))throw new Error(`--area expects x,y,w,h (got "${u}")`);let[I,C,c,J]=F;return{x:I,y:C,w:c,h:J}}let i=F=>{let I=t.find((c,J)=>t[J-1]===F);if(I==null)return null;let C=Number(I);return Number.isFinite(C)?C:null},b=i("--x"),k=i("--y"),$=i("--w"),N=i("--h");if(b!=null||k!=null||$!=null||N!=null)return{x:b??0,y:k??0,w:$??1,h:N??1};let S=t.filter((F,I)=>I>0&&!F.startsWith("-")&&t[I-1]!=="--output"&&t[I-1]!=="--area"&&t[I-1]!=="--id"&&t[I-1]!=="--text"&&t[I-1]!=="--x"&&t[I-1]!=="--y"&&t[I-1]!=="--w"&&t[I-1]!=="--h").map(Number).filter(F=>Number.isFinite(F));if(S.length>=2){let[F,I,C=1,c=1]=S;return{x:F,y:I,w:C,h:c}}return null}function Se(t){let l={"<8":0,"8-12":0,"12-16":0,"16-20":0,"20-33":0,">33":0};for(let a of t)a<8?l["<8"]++:a<12?l["8-12"]++:a<16?l["12-16"]++:a<20?l["16-20"]++:a<33?l["20-33"]++:l[">33"]++;console.log("  histogram:");for(let[a,d]of Object.entries(l)){let u="\u2588".repeat(Math.ceil(d/t.length*40));console.log(`    ${a.padEnd(6)} ${u} ${d}`)}}async function pe(t,l,a){let d=Date.now()+l,u=await oe(t,l);for(;;){if(a(u))return{settled:!0,state:u};if(Date.now()>=d)return{settled:!1,state:u};await X(16),u=await oe(t)}}async function ke(t){return t.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 zt(t,l=600){let a=Date.now()+l;for(;Date.now()<=a;){let d=await ke(t);if(d.visible)return d;await X(30)}return ke(t)}async function fe(t,l){let a=await ke(t);if(a.visible)return a;console.error(`  ${l} 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 ft(t,l,a){return l==="appearance"?t.send({type:"evaluate",code:`(async () => {
+        const requested = ${JSON.stringify(a??"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 }
+      })()`}):t.send({type:"evaluate",code:`(async () => {
+      window.dispatchEvent(new CustomEvent(${JSON.stringify(l==="lock"?"sootsim:toggleLock":"sootsim:shake")}))
+      return { ok: true, action: ${JSON.stringify(l)} }
+    })()`})}function Ut(t){let l={Enter:"return",NumpadEnter:"return",Backspace:"delete",Delete:"delete",Space:"space",ShiftLeft:"shift",ShiftRight:"shift"};if(l[t])return l[t];let a=t.match(/^Digit([0-9])$/);if(a)return a[1];let d=t.match(/^Key([A-Z])$/);return d?d[1].toLowerCase():null}function Yt(t){if(typeof t!="string")return null;let l=t.replace(/\s+/g," ").trim();return l?l.slice(0,80):null}function bt(...t){for(let l of t){if(typeof l!="string")continue;let a=l.trim();if(a)return a}return null}async function j(t,l,a){le({source:t,step:l,summary:a})}function Gt(t,l,a){if(!a||a.hit===!1)return null;let d=bt(a.responderTestID,a.testID);if(d)return{step:{tapOn:{id:d}},summary:`tap #${d}`};let u=Yt(a.text);return u?{step:{tapOn:u},summary:`tap "${u}"`}:{step:{tapAtCoords:{x:t,y:l}},summary:`tap @${Math.round(t)},${Math.round(l)}`}}function ve(t,l,a){let d=bt(l?.testID,l?.id);return d?{step:{tapOn:{id:d}},summary:`tap #${d}`}:a==="id"?{step:{tapOn:{id:t}},summary:`tap #${t}`}:{step:{tapOn:t},summary:`tap "${t}"`}}async function xs(t,l){let a=t[0]==="get"||t[0]==="do"||t[0]==="debug"||t[0]==="wait"?t[0]:null,d=a?t.slice(1):t,u=Ne(d,{port:l.port,commandTimeoutMs:l.timeoutMs,stripBooleanFlags:["--verbose","-v","--help","-h","--clear-state","--json","--all","--watch","-w","--strict","--no-wait","--dump","--failed","--slow","--tail","-f","--interactive-targets","--actions","--internal"],stripValueFlags:["--output","--nth","--index","--testid","--test-id","--text","--max-ms","--filter","--limit","--level","--threshold","--equals","--since"]}),i=u.positional,b=i[0],k=a==="get"||a==="do"||a==="debug"||a==="wait"?a:"inspect",$=typeof d[0]=="string"&&Me.has(d[0]),N=$?d[0]:null,h=e=>$&&e===d[0]?`sootsim ${e}`:`sootsim ${k} ${e}`,S=(e,o)=>`  usage: ${h(e)}${o?` ${o}`:""}`;if(!b||t.includes("--help")||t.includes("-h")){let e={bridgePort:7668,defaultShellUrl:Te};if(k==="do"||k==="get"||k==="debug"||k==="wait"){let r=ge(k,e);r&&(console.log(`${r}
+`),process.exit(0))}if(N==="shell"){let r=ye("shell",e);r&&(console.log(`${r}
+`),process.exit(0))}let o=ye("inspect",e),s=["do","get","debug","wait"].map(r=>ge(r,e)).filter(r=>r!=null).join(`
+
+`);console.log(`${o??""}
+
+${s}
+`),process.exit(0)}let F=u.wsPort,I=u.simId,C=u.commandTimeoutMs;if(b==="list"&&d.some(e=>e==="--drivers"||e==="-D")){let{buildDriverListRows:e}=await import("./drivers-PSQUUAYC.js"),o=e();console.log(`  available drivers (${o.length}):
+`);let s=Math.max(...o.map(n=>n.id.length),6),r=Math.max(...o.map(n=>n.kind.length),4);for(let n of o){let m=n.available?"\u2713":"\u2717",p=n.id.padEnd(s),y=n.kind.padEnd(r);console.log(`  ${m} ${p}  ${y}  ${n.description}`),n.available&&n.detail?console.log(`    ${n.detail}`):!n.available&&n.reason&&console.log(`    unavailable: ${n.reason}`)}return}let c=_e(u),J=I||"default",L=new Set(["errors","warnings","requests","js","eval","reload","globals","perf","list","wait","sleep"]);function O(e){let o=e.displayUrl||e.url;return e.status!=null?`${e.method} ${o} -> ${e.status}${e.statusText?` ${e.statusText}`:""}`:e.error?`${e.method} ${o} -> ${e.error}`:`${e.method} ${o}`}async function H(e){let o=We()?1200:350;try{let{settled:s,elapsed:r}=await se({bridge:e,maxMs:o,pollMs:32,stablePolls:2});s||process.stderr.write(`  \u26A0 auto-wait timed out after ${r??o}ms \u2014 next command may see mid-animation state. use \`sootsim do settle\` for a longer wait.
+`)}catch{}}async function Z(){try{return await c.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 Y(e={}){let o=e.counts!==void 0?e.counts:await K(c,"getRequestCounts");if(!o||typeof o!="object")return;let s=Math.max(0,Number(o.failed)||0);if(s===0||!e.includeTail&&!we("requests",J,String(s))||(console.log(`
+  network: ${s} failed request${s===1?"":"s"}`),console.log(`  inspect: ${h("requests")} 5`),!e.includeTail))return;let r=await K(c,"getFailedRequests",5);if(!(!Array.isArray(r)||r.length===0)){console.log(`
+  recent failed requests:
+`);for(let n of r){let m=new Date(n.timestamp).toLocaleTimeString();console.log(`  [${m}] ${O(n)}`),n.responseBody?console.log(`    ${n.responseBody}`):n.error&&console.log(`    ${n.error}`)}}}async function w(e={}){let o=e.counts!==void 0?e.counts:await c.send({type:"evaluate",code:"window.__sootsimConsole?.count?.() || { errors: 0, warnings: 0, total: 0 }"});if(!o||typeof o!="object")return;let s=o,r=Math.max(0,Number(s.errors)||0),n=Math.max(0,Number(s.warnings)||0);if(r===0&&n===0||!e.includeTail&&!we("console",J,`${r}:${n}`))return;let m=[];if(r>0&&m.push(`${r} console error${r===1?"":"s"}`),n>0&&m.push(`${n} console warning${n===1?"":"s"}`),console.log(`
+  console: ${m.join(", ")}`),console.log(`  inspect: ${h("errors")} 5`),n>0&&console.log(`  inspect: ${h("warnings")} 5`),!e.includeTail||r===0)return;let p=await c.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors?.(5) || []"});if(!(!Array.isArray(p)||p.length===0)){console.log(`
+  recent console errors:
+`);for(let y of p){let g=new Date(y.timestamp).toLocaleTimeString(),x=Array.isArray(y.args)?y.args.map(R=>typeof R=="object"?JSON.stringify(R):String(R)).join(" "):String(y);console.log(`  [${g}] ${x}`)}}}let _=["console","fetch","toast","alert","notification","screen","app-launch","keyboard","route","actionsheet","picker","shell","scroll","gesture","text-input","animation","reanimated"];async function W(e){let o=Ie(),s=null;try{s=await Pe(e,`(() => {
+          const tl = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.timeline
+          if (!tl || typeof tl.summary !== 'function') return null
+          const cursorKey = ${JSON.stringify(o)}
+          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(!s||!s.summary||!s.summary.total)return;let r=s.summary.byKind??{},n=[],m=new Set;for(let p of _){let y=r[p];if(y)if(m.add(p),p==="console"&&s.consoleSplit){let{error:g,warn:x}=s.consoleSplit;g>0&&n.push(`${g} error${g===1?"":"s"}`),x>0&&n.push(`${x} warning${x===1?"":"s"}`)}else n.push(`${y} ${p}${y===1?"":"s"}`)}for(let[p,y]of Object.entries(r))!m.has(p)&&y&&n.push(`${y} ${p}${y===1?"":"s"}`);if(n.length!==0&&(console.log(`
+  since last: ${n.join(" \xB7 ")} \u2014 sootsim what-happened`),s.summary.lastAt))try{await be(e,"SootSim.bridges.timeline.cursorAdvance",o,s.summary.lastAt)}catch{}}let ee=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"]),E=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"]),V=(t.includes("--verbose")||t.includes("-v"))&&!t.includes("--json");k==="do"&&b==="shell"&&(console.error("  `sootsim do shell` was removed. use `sootsim shell ...` instead."),process.exit(1)),ee.has(b)&&await Fe(c),E.has(b)&&await ce(c,{verbose:V});try{switch(b){case"list":{await Ve({bridge:c,simId:I,args:d});break}case"tree":{await ot({bridge:c,args:d,positional:i});break}case"a11y":{let e=i[1]?Number(i[1]):5,o=await c.send({type:"evaluate",code:`(async () => {
+            const t = window.__sootsimTest
+            if (!t) return []
+            const all = await t.queryAll({ pruneHidden: true })
+            return all.filter(n => {
+              // skip zero-size nodes
+              if (!n.layout || n.layout.width <= 0 || n.layout.height <= 0) return false
+              // keep nodes with explicit accessibility roles or labels
+              if (n.accessibilityRole) return true
+              if (n.accessibilityHint) return true
+              if (n.isTextInput) return true
+              if (n.pressable) return true
+              // keep text leaf nodes
+              if (n.type === 'text' && n.text) return true
+              // keep views with intentional labels (not auto-derived)
+              if (n.accessibilityLabel && n.accessibilityLabel.length <= 30
+                  && n.accessibilityLabel !== n.text) return true
+              // skip container views without role (just concatenated child text)
+              return false
+            }).map(n => ({
+              role: n.accessibilityRole || (n.pressable ? 'button' : n.isTextInput ? 'textfield' : n.type === 'text' ? 'statictext' : 'none'),
+              label: n.accessibilityLabel || n.text || null,
+              hint: n.accessibilityHint || null,
+              state: n.accessibilityState || null,
+              testID: n.testID || null,
+              position: n.absolutePosition ? { x: Math.round(n.absolutePosition.x), y: Math.round(n.absolutePosition.y) } : null,
+              size: n.layout ? { w: Math.round(n.layout.width), h: Math.round(n.layout.height) } : null,
+            }))
+          })()`});if(!Array.isArray(o)||o.length===0){console.log("  no accessible nodes found");break}if(t.includes("--json"))console.log(JSON.stringify(o,null,2));else{console.log(`  accessibility tree (${o.length} nodes):
+`);for(let s of o){let r=[];if(r.push(`[${s.role}]`),s.label){let n=s.label.length>50?s.label.slice(0,47)+"...":s.label;r.push(`"${n}"`)}if(s.hint&&r.push(`(hint: "${s.hint}")`),s.testID&&r.push(`#${s.testID}`),s.state){let n=[];s.state.disabled&&n.push("disabled"),s.state.selected&&n.push("selected"),s.state.checked===!0&&n.push("checked"),s.state.checked==="mixed"&&n.push("mixed"),s.state.busy&&n.push("busy"),s.state.expanded===!0&&n.push("expanded"),s.state.expanded===!1&&n.push("collapsed"),n.length&&r.push(`{${n.join(", ")}}`)}s.position&&r.push(`@(${s.position.x},${s.position.y})`),s.size&&r.push(`${s.size.w}x${s.size.h}`),console.log("  "+r.join(" "))}}break}case"find":{await Ge({bridge:c,args:t,effectiveArgs:d,positional:i,inspectUsage:S});break}case"count":{await He(c,{args:d});break}case"keyboard":{await Xe(c,{json:t.includes("--json")});break}case"screens":{await Ze(c,{json:t.includes("--json")});break}case"memory":{await Qe(c,{args:d});break}case"wait":{await nt({wsPort:F,commandTimeoutMs:C,simId:I,positional:i});break}case"sleep":{await tt({positional:i,inspectUsage:S});break}case"settle":{await et({bridge:c,args:t,positional:i});break}case"ready":{await lt({bridge:c,args:t});break}case"idle":{await at({bridge:c,args:t,positional:i});break}case"selector":{await ct({bridge:c,args:t,positional:i,inspectUsage:S});break}case"event":{await it({bridge:c,args:t,positional:i,inspectUsage:S});break}case"layout":{let e=i[1];e||(console.error(S("layout","<id>")),process.exit(1));let o=await c.send({type:"evaluate",code:`(async () => await window.__sootsimTest.getLayout(${JSON.stringify(e)}))()`});console.log(JSON.stringify(o,null,2));break}case"capture":case"screenshot":{let o=t.find((y,g)=>t[g-1]==="--output")||"/tmp/sootsim-inspect.png",s=await pt(t,c),r={type:"screenshot"};s&&(r.crop=s);let m=(await c.send(r)).replace(/^data:image\/png;base64,/,"");s&&console.log(`  area:  x=${s.x} y=${s.y} w=${s.w} h=${s.h}`),(await import("fs")).writeFileSync(o,Buffer.from(m,"base64")),console.log(`  saved: ${o}`);break}case"sample-color":{let e=await pt(t,c);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 o=await c.send({type:"evaluate",code:Ee(e)});if(t.includes("--json"))console.log(JSON.stringify(o,null,2));else{let{r:s,g:r,b:n,a:m,hex:p,samples:y}=o,g=e.w===1&&e.h===1?`@(${e.x},${e.y})`:`@(${e.x},${e.y}) ${e.w}x${e.h}`;console.log(`  ${p}  rgba(${s}, ${r}, ${n}, ${m})  ${g}  ${y} samples`)}break}case"node":{let e=i[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 o=await c.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(o,null,2));break}case"tap":{let e=Number(i[1]),o=Number(i[2]),s=ie(t);if(s){let m=await ue(c,s);m||(console.error(`  not found: ${s.value}`),s.mode==="testid"&&G("wait-selector-for-missing-testid",s.value),process.exit(1)),e=m.x,o=m.y}(!Number.isFinite(e)||!Number.isFinite(o))&&(console.error(S("tap","<x> <y> | --testid <id> | --text <t>")),process.exit(1));let r=await c.send({type:"tap",x:e,y:o}),n=Gt(e,o,r);n&&await j("inspect tap",n.step,n.summary),console.log(JSON.stringify(r,null,2));break}case"drag":case"swipe":{let e=Number(i[1]),o=Number(i[2]),s=Number(i[3]),r=Number(i[4]),n=b==="swipe"?10:12,m=b==="swipe"?8:16,p=i[5]?Number(i[5]):n,y=i[6]?Number(i[6]):m;(!Number.isFinite(e)||!Number.isFinite(o)||!Number.isFinite(s)||!Number.isFinite(r)||!Number.isFinite(p)||!Number.isFinite(y))&&(console.error(S(b,"<x1> <y1> <x2> <y2> [steps] [stepMs]")),process.exit(1));let g=await c.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}, ${o}, ${s}, ${r}, ${Math.max(1,Math.round(p))}, ${Math.max(0,Math.round(y))})
+            return { ok: !!value, value }
+          })()`});if(g?.ok){let x=Math.max(1,Math.round(Math.max(1,p)*Math.max(0,y)));await j(`inspect ${b}`,{swipe:{start:`${e}, ${o}`,end:`${s}, ${r}`,duration:x}},`${b} ${e},${o} -> ${s},${r}`)}console.log(JSON.stringify(g,null,2));break}case"pinch":{let e=Number(i[1]),o=Number(i[2]),s=Number(i[3]),r=Number(i[4]),n=Number(i[5]),m=Number(i[6]),p=Number(i[7]),y=Number(i[8]),g=i[9]?Number(i[9]):12,x=i[10]?Number(i[10]):16;(!Number.isFinite(e)||!Number.isFinite(o)||!Number.isFinite(s)||!Number.isFinite(r)||!Number.isFinite(n)||!Number.isFinite(m)||!Number.isFinite(p)||!Number.isFinite(y)||!Number.isFinite(g)||!Number.isFinite(x))&&(console.error(S("pinch","<x1> <y1> <x2> <y2> <x1'> <y1'> <x2'> <y2'> [steps] [stepMs]")),process.exit(1));let R=await c.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}, ${o}, ${s}, ${r}, ${n}, ${m}, ${p}, ${y}, ${Math.max(1,Math.round(g))}, ${Math.max(0,Math.round(x))})
+            return { ok: !!value, value }
+          })()`});R?.ok&&await j("inspect pinch",{pinch:{from:[e,o,s,r],to:[n,m,p,y],steps:Math.max(1,Math.round(g)),stepMs:Math.max(0,Math.round(x))}},`pinch (${e},${o}) (${s},${r}) -> (${n},${m}) (${p},${y})`),console.log(JSON.stringify(R,null,2));break}case"tap-text":{let e=i[1];e||(console.error(S("tap-text","<text>")),process.exit(1));let o=P=>{let A=t.indexOf(P);return A>=0&&A+1<t.length?t[A+1]:null},s=P=>t.includes(P),r=o("--nth")??o("--index"),n=r!==null?Number(r):null;n!==null&&!Number.isFinite(n)&&(console.error(`  --nth/--index requires an integer, got: ${r}`),process.exit(1));let m=o("--within"),p=o("--role"),y=s("--exact"),g=s("--first"),x=o("--min-y"),R=o("--max-y"),q=o("--min-x"),z=o("--max-x");for(let[P,A]of[["--min-y",x],["--max-y",R],["--min-x",q],["--max-x",z]])A!==null&&!Number.isFinite(Number(A))&&(console.error(`  ${P} requires a number, got: ${A}`),process.exit(1));let U=t.indexOf("--near"),M=null;if(U>=0){let P=Number(t[U+1]),A=Number(t[U+2]);(!Number.isFinite(P)||!Number.isFinite(A))&&(console.error("  --near requires two numbers: --near <x> <y>"),process.exit(1)),M={x:P,y:A}}let v=JSON.stringify({query:e,exact:y,role:p,within:m,minX:q!==null?Number(q):null,maxX:z!==null?Number(z):null,minY:x!==null?Number(x):null,maxY:R!==null?Number(R):null,near:M,nth:n,first:g}),f=await c.send({type:"evaluate",code:`(async () => {
+            const t = window.__sootsimTest
+            if (!t) return { error: 'bridge-not-ready' }
+            const F = ${v}
+
+            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,
+                type: target.type,
+              },
+              strategy: (resolved && resolved.strategy) || 'matched-node',
+              total,
+              idx,
+            }
+          })()`});if(f?.error==="bridge-not-ready"&&(console.error("  sootsim test bridge not ready"),process.exit(1)),f?.ambiguous){let P=f.candidates;console.error(`  ambiguous: ${f.total} matches for "${e}"`);for(let A of P){let ae=A.abs?`@(${Math.round(A.abs.x)},${Math.round(A.abs.y)})`:"",ht=A.layout?` ${A.layout.width}x${A.layout.height}`:"",wt=A.testID?` #${A.testID}`:"",xt=A.text?` "${A.text}"`:"",$t=A.ancestorTestIDs.length>0?` within ${A.ancestorTestIDs.slice(0,3).map(St=>`#${St}`).join(" > ")}`:"";console.error(`    [${A.idx}] <${A.type}>${xt}${wt} ${ae}${ht}${$t}`)}f.total>P.length&&console.error(`    ... and ${f.total-P.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));let T=await c.send({type:"tap",x:f.cx,y:f.cy});if(T?.hit!==!1&&T?.ok!==!1){let P=ve(e,{id:f.target?.id??null,testID:f.target?.testID??null,type:f.target?.type??null,cx:f.cx,cy:f.cy},"text");await j("inspect tap-text",P.step,P.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||n!==null?{nth:{index:f.idx,total:f.total}}:{},result:T},null,2));break}case"tap-best":{let e=i[1];e||(console.error(S("tap-best","<query>")),process.exit(1));let o=JSON.stringify(e),s=await c.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(${o})) || (await t.findById(${o}))
+            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(${o})
+            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' }
+          })()`});"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 r=s.node,n=r.absolutePosition.x+r.layout.width/2,m=r.absolutePosition.y+r.layout.height/2,p=await c.send({type:"tap",x:n,y:m});if(p?.hit!==!1&&p?.ok!==!1){let y=ve(e,{id:r.id,testID:r.testID,type:r.type,cx:n,cy:m},s.strategy==="testid"?"id":"text");await j("inspect tap-best",y.step,y.summary)}console.log(JSON.stringify({matched:{strategy:s.strategy,nodeId:r.nodeId,id:r.id,testID:r.testID,type:r.type,text:r.text},tapped:{cx:n,cy:m},result:p},null,2));break}case"tap-id":{let e=i[1];e||(console.error(S("tap-id","<id>")),process.exit(1));let o=JSON.stringify(e),s=await c.send({type:"evaluate",code:`(async () => {
+            const t = window.__sootsimTest
+            if (!t) return null
+            const n = (await t.findByTestId(${o})) || (await t.findById(${o}))
+            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,
+                type: n.type,
+              },
+              target: {
+                nodeId: target.nodeId ?? null,
+                id: target.id,
+                testID: target.testID,
+                type: target.type,
+              },
+              strategy: (resolved && resolved.strategy) || 'matched-node',
+            }
+          })()`});(!s||typeof s.cx!="number")&&(console.error(`  not found: ${e}`),process.exit(1));let r=await c.send({type:"tap",x:s.cx,y:s.cy});if(r?.hit!==!1&&r?.ok!==!1){let n=ve(e,{id:s.target?.id??null,testID:s.target?.testID??null,type:s.target?.type??null,cx:s.cx,cy:s.cy},"id");await j("inspect tap-id",n.step,n.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}:{},result:r},null,2));break}case"type-into":{let e=i[1],o=i.slice(2).join(" ");(!e||!o)&&(console.error(S("type-into","<id> <text>")),process.exit(1));let s=JSON.stringify(e),r=await c.send({type:"evaluate",code:`(async () => {
+            const t = window.__sootsimTest
+            if (!t) return null
+            const n = await (t.findByTestId(${s}) || t.findById(${s}))
+            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,
+              testID: n.testID,
+              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 n=await c.send({type:"tap",x:r.cx,y:r.cy}),m=await zt(c);m.visible||(console.error(`  keyboard did not open after tapping ${e}`),process.exit(1));let p=m.focusedInput;p&&(p.testID===e||p.id===e||(console.error(`  focus routing mismatch after tap: requested ${JSON.stringify(e)} but focus is on ${JSON.stringify(p.testID??p.id??null)}. did the tap land on an outer Pressable wrapper?`),process.exit(1))),await c.send({type:"keyboard",action:"type",text:o}),await j("inspect type-into",{tapOn:{id:e},inputText:o},`type-into #${e} ${JSON.stringify(o)}`),console.log(JSON.stringify({target:e,isTextInput:r.isTextInput,keyboardOpened:m.visible??n?.keyboardOpened??!1,focusedInput:m.focusedInput??null,typed:o},null,2));break}case"type":{let e=i.slice(1).join(" ");e||(console.error(S("type","<text>")),process.exit(1)),await fe(c,"type"),await c.send({type:"keyboard",action:"type",text:e}),await j("inspect type",{inputText:e},`type ${JSON.stringify(e)}`),console.log(`  typed: ${JSON.stringify(e)}`);break}case"key":{let e=i[1];e||(console.error(S("key","<name>")),process.exit(1)),await fe(c,"key"),await c.send({type:"keyboard",action:"press",text:e}),await j("inspect key",{pressKey:e},`key ${e}`),console.log(`  pressed: ${e}`);break}case"key-sequence":{let e=i.slice(1);e.length===0&&(console.error(S("key-sequence","<key> [<key> ...]")),process.exit(1)),await fe(c,"key-sequence");for(let o of e)await c.send({type:"keyboard",action:"press",text:o});await j("inspect key-sequence",{pressKey:e.join(" ")},`key-sequence ${e.join(" ")}`),console.log(`  pressed: ${e.join(", ")}`);break}case"keycode":{let e=i.slice(1);e.length===0&&(console.error(S("keycode","<code> [<code> ...]")),process.exit(1));let o=e.map(r=>({code:r,key:Ut(r)})),s=o.filter(r=>!r.key);s.length>0&&(console.error(`  unsupported keycode(s): ${s.map(r=>r.code).join(", ")}`),process.exit(1)),await fe(c,"keycode");for(let r of o)await c.send({type:"keyboard",action:"press",text:r.key});await j("inspect keycode",{pressKey:o.map(r=>r.key).join(" ")},`keycode ${e.join(" ")}`),console.log(`  pressed: ${e.join(", ")}`);break}case"dispatch":{let e=i[1];e||(console.error(S("dispatch","<char>")),process.exit(1)),await c.send({type:"keyboard",action:"dispatchKey",text:e}),await j("inspect dispatch",{dispatchKey:e},`dispatch ${JSON.stringify(e)}`),console.log(`  dispatched: ${e}`);break}case"dismiss":{await c.send({type:"keyboard",action:"dismiss"}),await j("inspect dismiss",{hideKeyboard:!0},"dismiss keyboard"),console.log("  keyboard dismissed");break}case"double-tap":{let e=Number(i[1]),o=Number(i[2]),s=ie(t);if(s){let p=await ue(c,s);p||(console.error(`  not found: ${s.value}`),s.mode==="testid"&&G("wait-selector-for-missing-testid",s.value),process.exit(1)),e=p.x,o=p.y}let r=i[3]?Number(i[3]):80;(!Number.isFinite(e)||!Number.isFinite(o)||!Number.isFinite(r))&&(console.error(S("double-tap","<x> <y> [gapMs] | --testid <id>")),process.exit(1));let n=Math.max(0,Math.round(r)),m=await c.send({type:"evaluate",code:`(async () => {
+            const interact = window.__sootsimInteract
+            if (interact?.doubleTap) {
+              return {
+                ok: !!(await interact.doubleTap(${e}, ${o}, ${n})),
+                gapMs: ${n},
+              }
+            }
+            if (!interact?.tap) {
+              return { ok: false, reason: 'no interact.tap', gapMs: ${n} }
+            }
+            const first = await interact.tap(${e}, ${o})
+            if (!first || first.hit === false) {
+              return { ok: false, reason: 'first tap missed', gapMs: ${n}, first }
+            }
+            await new Promise((resolve) => setTimeout(resolve, ${n}))
+            const second = await interact.tap(${e}, ${o})
+            return {
+              ok: !!second && second.hit !== false,
+              gapMs: ${n},
+              first,
+              second,
+            }
+          })()`});m?.ok&&await j("inspect double-tap",{doubleTapAtCoords:{x:e,y:o,gapMs:n}},`double-tap @${e},${o}`),console.log(JSON.stringify(m,null,2));break}case"long-press":{let e=Number(i[1]),o=Number(i[2]),s=ie(t);if(s){let m=await ue(c,s);m||(console.error(`  not found: ${s.value}`),s.mode==="testid"&&G("wait-selector-for-missing-testid",s.value),process.exit(1)),e=m.x,o=m.y}let r=i[3]?Number(i[3]):600;(!Number.isFinite(e)||!Number.isFinite(o)||!Number.isFinite(r))&&(console.error(S("long-press","<x> <y> [durationMs] | --testid <id>")),process.exit(1));let n=await c.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}, ${o}, ${Math.max(0,Math.round(r))})
+            return { ok: !!value, value }
+          })()`});n?.ok&&await j("inspect long-press",{tapAtCoords:{x:e,y:o}},`long-press @${e},${o}`),console.log(JSON.stringify(n,null,2));break}case"touch":{let e=i[1],o=Number(i[2]),s=Number(i[3]),r=i[4]?Number(i[4]):999,n=e==="down"?"touchDown":e==="move"?"touchMove":e==="up"?"touchUp":e==="cancel"?"touchCancel":null;n||(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1)),e!=="cancel"&&(!Number.isFinite(o)||!Number.isFinite(s))&&(console.error(S("touch","<down|move|up|cancel> <x> <y> [pointerId]")),process.exit(1));let m=e==="down"?"tap":e==="move"?"move":null,p=m&&Number.isFinite(o)&&Number.isFinite(s)?`window.dispatchEvent(new CustomEvent('sootsim:agentAction', { detail: { type: '${m}', x: ${o}, y: ${s} } }));`:"",y=await c.send({type:"evaluate",code:`(async () => {
+            ${p}
+            const interact = window.__sootsimInteract
+            if (!interact?.${n}) return { ok: false, reason: 'no interact.${n}' }
+            const value = ${e==="cancel"?`await interact.${n}(${Math.max(1,Math.round(r))})`:`await interact.${n}(${o}, ${s}, ${Math.max(1,Math.round(r))})`}
+            return { ok: !!value, value }
+          })()`});y?.ok&&e!=="cancel"&&await j("inspect touch",{tapAtCoords:{x:o,y:s}},`touch ${e} @${o},${s}`),console.log(JSON.stringify(y,null,2));break}case"gesture":{let e=i[1],o=i[2]?Number(i[2]):220;(!e||!Number.isFinite(o))&&(console.error(S("gesture","<preset> [durationMs]")),process.exit(1));let s=await c.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,
+            }
+          })()`}),r=Number(s?.width)||393,n=Number(s?.height)||852,m=Number(s?.statusBarHeight)||0,p=Number(s?.homeIndicatorHeight)||0,y=Math.round(r/2),g=Math.round(n/2),x=Math.max(24,m+18),R=Math.max(24,p+18),q=18,z=Math.min(220,Math.round(n*.24)),U=Math.min(180,Math.round(r*.32)),M=y,v=g,f=y,T=g;switch(e){case"scroll-up":v=g+Math.round(z/2),T=g-Math.round(z/2);break;case"scroll-down":v=g-Math.round(z/2),T=g+Math.round(z/2);break;case"scroll-left":M=y+Math.round(U/2),f=y-Math.round(U/2);break;case"scroll-right":M=y-Math.round(U/2),f=y+Math.round(U/2);break;case"swipe-from-left-edge":M=q,v=g,f=Math.min(r-q,q+U);break;case"swipe-from-right-edge":M=r-q,v=g,f=Math.max(q,r-q-U);break;case"swipe-from-top-edge":M=y,v=x,T=Math.min(n-R,x+z);break;case"swipe-from-bottom-edge":M=y,v=n-R,T=Math.max(x,n-R-z);break;default:console.error(`  unknown gesture preset: ${e}`),process.exit(1)}let P=Math.max(8,Math.round(o/16)),A=Math.max(1,Math.round(o/P)),ae=await c.send({type:"evaluate",code:`(async () => {
+            const interact = window.__sootsimInteract
+            if (!interact?.drag) return { ok: false, reason: 'no interact.drag' }
+            const value = await interact.drag(${M}, ${v}, ${f}, ${T}, ${P}, ${A})
+            return { ok: !!value, value }
+          })()`});ae?.ok&&await j("inspect gesture",{swipe:{start:`${M}, ${v}`,end:`${f}, ${T}`,duration:Math.max(1,Math.round(o))}},`gesture ${e}`),console.log(JSON.stringify({preset:e,from:{x:M,y:v},to:{x:f,y:T},result:ae},null,2));break}case"scroll":{let e=ie(t),o=e?.mode==="testid"?e.value:i[1],s=Number(i[e?1:2]),r=Number(i[e?2:3]);(!o||!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(S("scroll","<id> <dx> <dy> | --testid <id> <dx> <dy>")),process.exit(1));let n=await c.send({type:"evaluate",code:`(async () => {
+            const t = window.__sootsimTest
+            if (!t) return null
+            const n = await t.findByTestId(${JSON.stringify(o)})
+              || await t.findById(${JSON.stringify(o)})
+            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,
+            }
+          })()`}),m=await K(c,"scrollTo",o,s,r,!1);m?.ok&&await j("inspect scroll",{scrollTo:{id:o,x:s,y:r}},`scroll ${o} -> ${s},${r}`),console.log(JSON.stringify({...m,...n?{at:{x:n.cx,y:n.cy}}:{}},null,2));break}case"state":{let e=i[1];if(a==="get"&&!e){let s=await K(c,"getRuntimeState"),r=await c.send({type:"evaluate",code:`({
+              errors: window.__sootsimConsole?.getErrors?.()?.length ?? 0,
+              warnings: window.__sootsimConsole?.getWarnings?.()?.length ?? 0,
+            })`});s&&typeof s=="object"&&s.diagnostics&&(s.diagnostics.errors=r?.errors??0,s.diagnostics.warnings=r?.warnings??0),console.log(JSON.stringify(s,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 o;switch(e){case"shell":o=await oe(c,500);break;case"worker":o=await be(c,"__sootsimRenderHost.queryStats");break;case"ownership":o=await c.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":o=await c.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 s=i[2];s||(console.error(`  usage: ${h("state")} node <id>`),process.exit(1)),o=await K(c,"findByTestId",s)||await K(c,"findById",s);break}case"scroll":{let s=i[2];s||(console.error(`  usage: ${h("state")} scroll <id>`),process.exit(1)),o=await K(c,"getScrollState",s);break}case"scroll-hit":{let s=Number(i[2]),r=Number(i[3]);(!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(`  usage: ${h("state")} scroll-hit <x> <y>`),process.exit(1)),o=await K(c,"getScrollStateAt",s,r);break}case"hit":{let s=Number(i[2]),r=Number(i[3]);(!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(`  usage: ${h("state")} hit <x> <y>`),process.exit(1)),o=await K(c,"debugHitAt",s,r);break}case"gesture":{let s=Number(i[2]),r=Number(i[3]);(!Number.isFinite(s)||!Number.isFinite(r))&&(console.error(`  usage: ${h("state")} gesture <x> <y>`),process.exit(1)),o=await K(c,"debugGestureAt",s,r);break}default:console.error(`  unknown state subcommand: ${e}`),process.exit(1)}console.log(JSON.stringify(o,null,2));break}case"shell":{let e=i[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 o=e==="launch"||e==="open-card"||e==="home"||e==="switcher",s=e==="launch"||e==="open-card"?i[3]:i[2],r=s?Number(s):350;o&&(!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 n=!1,m=!1,p=null,y=t.includes("--clear-state");if(e==="launch"){let g=i[2];g||(console.error(S("shell","launch <appId> [settleMs] [--clear-state]")),process.exit(1)),y&&await c.send({type:"evaluate",code:Ae}),n=!!await ne(c,"launchApp",r,g),{settled:m,state:p}=await pe(c,Math.round(r),x=>!!x&&x.state==="app"&&x.activeApp===g&&x.showSwitcher===!1&&x.switcherPhase==="idle"&&typeof x.launchProgress=="number"&&x.launchProgress>=.98),n&&await j("inspect shell launch",y?{launchApp:{clearState:!0}}:{launchApp:{}},y?"launch app (clear state)":"launch app")}else if(e==="home")n=!!await ne(c,"goHome",r),{settled:m,state:p}=await pe(c,Math.round(r),g=>!!g&&g.state==="home"&&g.activeApp==null&&g.showSwitcher===!1&&g.switcherPhase==="idle"&&typeof g.launchProgress=="number"&&g.launchProgress>=.98);else if(e==="switcher")n=!!await ne(c,"openSwitcher",r),{settled:m,state:p}=await pe(c,Math.round(r),g=>!!g&&g.state==="app"&&g.showSwitcher===!0&&g.switcherPhase==="idle"&&typeof g.zoomLevel=="number"&&Math.abs(g.zoomLevel)<=.02&&typeof g.horizontalZoom=="number"&&Math.abs(g.horizontalZoom)<=.02),m&&(await X(Kt),p=await oe(c));else if(e==="open-card"){let g=i[2];g||(console.error(S("shell","open-card <appId> [settleMs]")),process.exit(1)),n=!!await ne(c,"openSwitcherCard",r,g),{settled:m,state:p}=await pe(c,Math.round(r),x=>!!x&&x.state==="app"&&x.activeApp===g&&x.showSwitcher===!1&&x.switcherPhase==="idle"&&typeof x.zoomLevel=="number"&&x.zoomLevel>=.98&&typeof x.horizontalZoom=="number"&&x.horizontalZoom>=.98),n&&await j("inspect shell open-card",{openSwitcherCard:{appId:g}},`open switcher card ${g}`)}else if(e==="appearance"){let g=i[2];(!g||!["light","dark","auto","toggle"].includes(g))&&(console.error(S("shell","appearance <light|dark|auto|toggle>")),process.exit(1));let x=await ft(c,"appearance",g);n=!!x?.ok,p={appearance:x}}else if(e==="lock"||e==="shake"){let g=await ft(c,e);n=!!g?.ok,p={[e]:g}}else console.error(`  unknown shell subcommand: ${e}`),process.exit(1);console.log(JSON.stringify({ok:n,settled:m,state:p},null,2));break}case"url":{await st(c,{args:d});break}case"reload":{let s=!1,r=!1;try{await c.send({type:"evaluate",code:"window.__sootsimConsole?.clear()"});let p=await c.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=!!p&&p.kind==="external-app",s=!0}catch{}console.log("  reloading...");let n=c,m=null;if(r)m=await he(c,{timeoutMs:1e4,errorGraceMs:3e3});else{s&&await X(300);let p=await De(F,C,I,{timeoutMs:1e4});p?(n=p,m=await he(p,{timeoutMs:1e4,errorGraceMs:3e3})):(console.log("  \u26A0 reload: bridge never reconnected within 10000ms"),n=null)}if(m)if(m.ready){let p=m.source==="nodes-fallback"?" (no ready signal, node-count fallback)":"";console.log(`  ready in ${m.elapsedMs}ms: ${m.nodes} nodes${p}`)}else m.source==="error-bail"?console.log(`  \u26A0 reload bailed after ${m.elapsedMs}ms: ${m.errors} console error(s), ready signal never fired`):console.log(`  \u26A0 reload timed out after ${m.elapsedMs}ms (${m.nodes} nodes, ${m.errors} errors)`);if(n)try{let p=await n.send({type:"evaluate",code:"window.__sootsimConsole?.getErrors(10) || []"});if(n!==c&&n.close(),Array.isArray(p)&&p.length>0){console.log(`
+  \u26A0 ${p.length} error(s) during mount:
+`);for(let y of p){let g=y.args.map(x=>typeof x=="object"?JSON.stringify(x):x).join(" ");if(console.log(`    ${g}`),y.stack){let x=y.stack.split(`
+`).slice(0,2);for(let R of x)console.log(`      ${R.trim()}`)}}}}catch{}m&&!m.ready&&(process.exitCode=1);break}case"eval":case"js":{let e=i.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 o=e;o.startsWith("(async")||(o=`(async () => ${o})()`);let s=await c.send({type:"evaluate",code:o});console.log(JSON.stringify(s,null,2));let r=e.toLowerCase(),n=[];(r.includes("sootsim:gohome")||r.includes("gohome"))&&n.push("sootsim shell home"),(r.includes("sootsim:appswitcher")||r.includes("appswitcher"))&&n.push("sootsim shell switcher"),(r.includes("keyboard.isvisible")||r.includes("keyboard.getmode"))&&n.push("sootsim debug state keyboard"),r.includes("interact.tap")&&n.push("sootsim do tap <x> <y>"),r.includes("keyboard.type")&&n.push("sootsim do type <text>"),(r.includes("keyboard.press")||r.includes("keyboard.dispatchkey"))&&n.push("sootsim do key <name>"),r.includes("keyboard.dismiss")&&n.push("sootsim do dismiss"),r.includes("dumptree")&&n.push("sootsim get tree"),r.includes("dumpaccessibilitytree")&&n.push("sootsim get a11y"),r.includes("getnodecount")&&n.push("sootsim get count"),r.includes("findbytext")&&n.push("sootsim find <text>"),(r.includes("findbytestid")||r.includes("findbyid"))&&n.push("sootsim find --testid <id>"),r.includes("document.hidden")&&n.push("sootsim debug state keyboard  (includes tab health)"),n.length>0&&G("prefer-cli-over-eval",n);break}case"globals":{let e=await c.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[o,s]of Object.entries(e)){console.log(`  ${o}:`);for(let r of s)console.log(`    .${r}`);console.log("")}console.log(`  use: ${h("js")} <expression>`),console.log(`  example: ${h("js")} test.findByText("Sign in")`);break}case"describe":{await qe({bridge:c,args:t,positional:i});break}case"perf":{let e=i[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
+    stop            stop recording and report results
+    frames [n]      get last N frame times (default: 50)
+    transition <e>  profile a shell transition (goHome, appSwitcher, lockScreen)
+
+  examples:
+    ${h("perf")} stats
+    ${h("perf")} start
+    # ... interact with the app ...
+    ${h("perf")} stop
+    ${h("perf")} transition goHome
+`);break}switch(e){case"stats":{let o=await c.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,
+                }
+              })()`});o.error&&(console.error(`  error: ${o.error}`),process.exit(1));let s=o.avgMs!=="?"?(1e3/parseFloat(o.avgMs)).toFixed(1):"?";console.log("  perf stats:"),console.log(`    frames:     ${o.frames}`),console.log(`    avg:        ${o.avgMs}ms (${s} fps)`),console.log(`    max:        ${o.maxMs}ms`),console.log(`    layout:     ${o.layoutMs}ms total`),console.log(`    nodes:      ${o.nodeCount}`),o.recentCount>0&&console.log(`    jank:       ${o.jankFrames}/${o.recentCount} frames >16.67ms`);break}case"start":{await c.send({type:"evaluate",code:`(async () => {
+                // worker mode
+                if (window.__sootsimPerfStart && window.__sootsimRenderHost) {
+                  const result = window.__sootsimPerfStart()
+                  window.${Q} = {
+                    active: true,
+                    mode: 'render-worker',
+                    lastSamples: [],
+                    startedAt: performance.now(),
+                  }
+                  return result
+                }
+                // main-thread mode
+                window.__sootsimPerf?.enableFrameStats?.(true)
+                window.__sootsimA11y?.resetProfile?.()
+                window.${Q} = {
+                  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 o=await c.send({type:"evaluate",code:`(async () => {
+                // worker mode
+                if (window.__sootsimRenderHost) {
+                  const session = window.${Q} || {}
+                  const priorSamples = session.active && Array.isArray(session.lastSamples)
+                    ? session.lastSamples
+                    : []
+                  const flushedSamples = await window.__sootsimRenderHost.flushSamples()
+                  const samples = priorSamples.concat(flushedSamples)
+                  window.${Q} = {
+                    ...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.${Q} = {
+                  ...(window.${Q} || {}),
+                  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,
+                }
+              })()`});o.error&&(console.error(`  error: ${o.error}`),process.exit(1));let s=o.avgMs>0?(1e3/o.avgMs).toFixed(1):"?",r=o.sampleCount>0?(o.jankFrames/o.sampleCount*100).toFixed(1):"0";console.log(`  profiling stopped:
+`),console.log(`    frames:     ${o.frames}`),console.log(`    total:      ${o.totalMs.toFixed(1)}ms`),console.log(`    avg:        ${o.avgMs.toFixed(2)}ms (${s} fps)`),console.log(`    max:        ${o.maxMs.toFixed(2)}ms`),console.log(""),o.layoutAvgMs!==void 0&&(console.log("    breakdown (avg per frame):"),console.log(`      layout:   ${o.layoutAvgMs.toFixed(2)}ms`),console.log(`      render:   ${o.renderAvgMs.toFixed(2)}ms`),console.log(`      copy:     ${o.copyAvgMs.toFixed(2)}ms`),o.auxAvgMs!==void 0&&console.log(`      aux:      ${o.auxAvgMs.toFixed(2)}ms`),o.otherAvgMs!==void 0&&console.log(`      other:    ${o.otherAvgMs.toFixed(2)}ms`),console.log("")),console.log(`    distribution (${o.sampleCount} samples):`),console.log(`      p50:      ${o.p50.toFixed(2)}ms`),console.log(`      p95:      ${o.p95.toFixed(2)}ms`),console.log(`      p99:      ${o.p99.toFixed(2)}ms`),console.log(`      jank:     ${o.jankFrames} frames (${r}%) >16.67ms`);break}case"frames":{let o=i[2]?Number(i[2]):50;(!Number.isFinite(o)||o<=0)&&(console.error(`  error: expected a positive frame count, got "${i[2]}"`),process.exit(1));let s=await c.send({type:"evaluate",code:`(async () => {
+                if (window.__sootsimRenderHost) {
+                  const session = window.${Q} || {}
+                  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.${Q} = {
+                      ...session,
+                      active: true,
+                      mode: 'render-worker',
+                      lastSamples: samples,
+                      lastFlushAt: performance.now(),
+                    }
+                    return {
+                      mode: 'render-worker',
+                      live: true,
+                      samples: samples.slice(-${o}),
+                    }
+                  }
+                  return {
+                    mode: 'render-worker',
+                    live: false,
+                    samples: (session.lastSamples || []).slice(-${o}),
+                  }
+                }
+                // 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(-${o}),
+                }
+              })()`});if(s.error&&(console.error(`  error: ${s.error}`),process.exit(1)),s.mode==="render-worker"){let n=Array.isArray(s.samples)?s.samples:[];if(n.length===0){console.log(`  no frame data \u2014 run '${h("perf")} start' first`);break}console.log(`  last ${n.length} sampled frames (ms):`),console.log("    total    layout   render   copy     aux    other     t+");for(let[m,p,y,g,x,R,q]of n)console.log(`    ${p.toFixed(2).padStart(7)}  ${y.toFixed(2).padStart(7)}  ${g.toFixed(2).padStart(7)}  ${x.toFixed(2).padStart(7)}  ${R.toFixed(2).padStart(6)}  ${q.toFixed(2).padStart(7)}  ${String(m).padStart(5)}`);console.log(""),Se(n.map(m=>m[1])),s.live&&console.log("  sampling continues");break}let r=Array.isArray(s.frames)?s.frames:Array.isArray(s)?s:[];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(n=>n.toFixed(2)).join(", ")}`),Se(r);break}case"worst":{let o=i[2]?Number(i[2]):20;(!Number.isFinite(o)||o<=0)&&(console.error(`  error: expected a positive frame count, got "${i[2]}"`),process.exit(1));let s=await c.send({type:"evaluate",code:`(async () => {
+                if (window.__sootsimRenderHost) {
+                  const session = window.${Q} || {}
+                  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.${Q} = {
+                      ...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, ${o}),
+                    }
+                  }
+                  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, ${o}),
+                  }
+                }
+                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, ${o}),
+                }
+              })()`});if(s.error&&(console.error(`  error: ${s.error}`),process.exit(1)),s.mode==="render-worker"){let n=Array.isArray(s.samples)?s.samples:[];if(n.length===0){console.log(`  no frame data \u2014 run '${h("perf")} start' first`);break}console.log(`  worst ${n.length} sampled frames (ms):`),console.log("    total    layout   render   copy     aux    other     t+");for(let[m,p,y,g,x,R,q]of n)console.log(`    ${p.toFixed(2).padStart(7)}  ${y.toFixed(2).padStart(7)}  ${g.toFixed(2).padStart(7)}  ${x.toFixed(2).padStart(7)}  ${R.toFixed(2).padStart(6)}  ${q.toFixed(2).padStart(7)}  ${String(m).padStart(5)}`);s.live&&(console.log(""),console.log("  sampling continues"));break}let r=Array.isArray(s.frames)?s.frames:Array.isArray(s)?s:[];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(n=>n.toFixed(2)).join(", ")}`);break}case"transition":{let o=i[2];if(!o||!["goHome","appSwitcher","lockScreen"].includes(o)){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:${o}`;console.log(`  profiling ${o} transition...`),console.log("  (use --timeout 10000 if this times out)");let n=await c.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: '${o}',
+                  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(n.error&&(console.error(`  error: ${n.error}`),process.exit(1)),n.warning&&console.log(`  warning: ${n.warning}`),n.frames===0){console.log("  no frames captured");break}let m=n.avgMs>0?(1e3/n.avgMs).toFixed(1):"?",p=n.frames>0?(n.jankFrames/n.frames*100).toFixed(1):"0";console.log(`  ${o} transition profiled:
+
+    frames:     ${n.frames}
+    total:      ${n.totalMs.toFixed(1)}ms
+    avg:        ${n.avgMs.toFixed(2)}ms (${m} fps)
+    max:        ${n.maxMs.toFixed(2)}ms
+
+    breakdown (avg per frame):
+      layout:   ${n.layoutAvgMs?.toFixed(2)||"?"}ms
+      render:   ${n.renderAvgMs?.toFixed(2)||"?"}ms
+      copy:     ${n.copyAvgMs?.toFixed(2)||"?"}ms
+      aux:      ${n.auxAvgMs?.toFixed(2)||"?"}ms
+      other:    ${n.otherAvgMs?.toFixed(2)||"?"}ms
+
+    distribution (${n.frames} samples):
+      p50:      ${n.p50.toFixed(2)}ms
+      p95:      ${n.p95.toFixed(2)}ms
+      p99:      ${n.p99.toFixed(2)}ms
+      jank:     ${n.jankFrames} frames (${p}%) >16.67ms`),Array.isArray(n.samples)&&n.samples.length>0&&(console.log(""),Se(n.samples.map(y=>y[1])));break}default:console.error(`  unknown perf subcommand: ${e}`),process.exit(1)}break}case"errors":{let e=i[1];if(e==="clear"){await c.send({type:"evaluate",code:'window.__sootsimConsole?.clear(); "cleared"'}),D(d)?B({cleared:!0}):console.log("  error buffer cleared");break}let o=e?Number(e):20,s=await c.send({type:"evaluate",code:`window.__sootsimConsole?.getErrors(${o}) || []`}),r=Array.isArray(s)?s:[];if(D(d)){B(r);break}if(r.length===0){console.log("  no errors captured");break}console.log(`  ${r.length} error(s):
+`);for(let n of r){let m=new Date(n.timestamp).toLocaleTimeString(),p=n.args.map(y=>typeof y=="object"?JSON.stringify(y):y).join(" ");if(console.log(`  [${m}] ${p}`),n.stack){let y=n.stack.split(`
+`).slice(0,3);for(let g of y)console.log(`    ${g.trim()}`)}}break}case"warnings":{let e=i[1]?Number(i[1]):20,o=await c.send({type:"evaluate",code:`window.__sootsimConsole?.getWarnings(${e}) || []`}),s=Array.isArray(o)?o:[];if(D(d)){B(s);break}if(s.length===0){console.log("  no warnings captured");break}console.log(`  ${s.length} warning(s):
+`);for(let r of s){let n=new Date(r.timestamp).toLocaleTimeString(),m=r.args.map(p=>typeof p=="object"?JSON.stringify(p):p).join(" ");console.log(`  [${n}] ${m}`)}break}case"animations":{let e=await K(c,"listAnimations")??[];if(t.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 o of e){let s=String(o.kind).padEnd(6),r=`${Number(o.from).toFixed(2)}\u2192${Number(o.to).toFixed(2)}`,n=Number(o.current??0).toFixed(2),m=`${Math.round((o.progress??0)*100)}%`,p=`${Math.round(o.elapsedMs??0)}ms`,y=o.loop?" loop":"",g=o.layoutBound?" layout":"";console.log(`  #${o.id}  ${s} ${r.padEnd(14)} cur=${n.padEnd(7)} ${m.padStart(4)}  ${p}${y}${g}`)}break}case"animation":{let e=i[1];(!e||e==="--help"||e==="-h")&&(console.error(`  usage: ${h("animation")} <id>`),process.exit(1));let o=Number(e);Number.isFinite(o)||(console.error(`  invalid id: ${e}`),process.exit(1));let s=await K(c,"getAnimation",o);console.log(JSON.stringify(s,null,2));break}case"stop-animation":{let e=i[1];(!e||e==="--help"||e==="-h")&&(console.error(`  usage: ${h("stop-animation")} <id|all>`),process.exit(1));let o=e==="all"?"all":Number(e);o!=="all"&&!Number.isFinite(o)&&(console.error(`  invalid id: ${e}`),process.exit(1));let s=await K(c,"stopAnimation",o);console.log(`  stopped ${s??0} animation(s)`);break}case"requests":{let e=i[1];if(e==="clear"){await K(c,"clearRequests"),D(d)?B({cleared:!0}):console.log("  request buffer cleared");break}let o=e==="all",s=o?i[2]:e,r=s?Number(s):20,n=o?await K(c,"getRequests",r):await K(c,"getFailedRequests",r),m=Array.isArray(n)?n:[];if(D(d)){B(m);break}if(m.length===0){console.log(o?"  no requests captured":"  no failed requests captured");break}console.log(`  ${m.length} ${o?"request(s)":"failed request(s)"}:
+`);for(let p of m){let y=new Date(p.timestamp).toLocaleTimeString();console.log(`  [${y}] ${O(p)}`),p.responseBody?console.log(`    ${p.responseBody}`):p.error&&console.log(`    ${p.error}`)}break}case"network":{let e=i[1],o=null,s=null,r=!1,n=!1,m=1e3,p=!1,y=!1;for(let M=0;M<d.length;M++){let v=d[M];if(v==="--filter")o=d[M+1]??null,M++;else if(v==="--limit"){let f=Number(d[M+1]);Number.isFinite(f)&&(s=f),M++}else if(v==="--threshold"){let f=Number(d[M+1]);Number.isFinite(f)&&f>0&&(m=f),M++}else v==="--failed"?r=!0:v==="--slow"?n=!0:v==="--tail"||v==="-f"?p=!0:v==="--json"&&(y=!0)}if(e==="clear"){await c.send({type:"evaluate",code:'window.__sootsimObservability?.network.clear(); "cleared"'}),console.log("  network buffer cleared");break}if(e==="get"){let M=i[2];M||(console.error("  usage: sootsim network get <id>"),process.exit(1));let v=await c.send({type:"evaluate",code:`(() => {
+              const obs = window.__sootsimObservability;
+              if (!obs) return null;
+              return obs.network.getSnapshot().find(e => e.id === ${JSON.stringify(M)}) || null;
+            })()`});v||(console.error(`  no entry with id ${M}`),process.exit(1)),y?console.log(JSON.stringify(v,null,2)):Ht(v);break}let g=s??(p?200:e?Number(e):20);Number.isFinite(g)||(console.error(`  invalid limit: ${e}`),process.exit(1));let x=async()=>{let M=await c.send({type:"evaluate",code:`(() => {
+              const obs = window.__sootsimObservability;
+              if (!obs) return { ok: false };
+              return { ok: true, entries: obs.network.getSnapshot() };
+            })()`});if(!M||!M.ok)throw new Error("observability bridge not installed \u2014 is the engine running?");return M.entries??[]},R=M=>{let v=M;if(r&&(v=v.filter(f=>!!f.error||f.status!=null&&f.status>=400)),n&&(v=v.filter(f=>f.durationMs!=null&&f.durationMs>=m)),o){let f=o.toLowerCase();v=v.filter(T=>(T.displayUrl||T.url).toLowerCase().includes(f))}return n&&!p&&(v=[...v].sort((f,T)=>(T.durationMs??0)-(f.durationMs??0))),v};if(!p){let M=await x(),v=R(M).slice(-g);if(y){console.log(JSON.stringify(v,null,2));break}if(v.length===0){M.length===0?console.log("  no network requests captured"):console.log(n?`  no requests slower than ${m}ms (${M.length} total \u2014 try --threshold <ms>)`:"  no matching requests");break}console.log(n?`  ${v.length} request(s) slower than ${m}ms (sorted by duration desc):
+`:`  ${v.length} request(s):
+`);for(let f of v)dt(f);break}console.log(`  tailing network (ctrl-c to stop)...
+`);let q=new Set,z=!0,U=()=>{z=!1};process.on("SIGINT",U);try{for(;z;){let M=await x(),v=R(M);for(let f of v)f.durationMs!=null&&(q.has(f.id)||(q.add(f.id),y?console.log(JSON.stringify(f)):dt(f)));await X(250)}}finally{process.off("SIGINT",U)}break}case"logs":{let e=i[1],o=null,s=null,r=null,n=!1,m=!1,p=!1;for(let f=0;f<d.length;f++){let T=d[f];if(T==="--filter")o=d[f+1]??null,f++;else if(T==="--limit"){let P=Number(d[f+1]);Number.isFinite(P)&&(s=P),f++}else T==="--level"?(r=d[f+1]??null,f++):T==="--tail"||T==="-f"?n=!0:T==="--json"?m=!0:(T==="--internal"||T==="--all")&&(p=!0)}let y=r?new Set(r.split(",").map(f=>f.trim()).filter(f=>f==="log"||f==="info"||f==="warn"||f==="error"||f==="debug")):null;if(e==="clear"){await c.send({type:"evaluate",code:'window.__sootsimObservability?.logs.clear(); "cleared"'}),console.log("  log buffer cleared");break}let g=!m&&process.stdout.isTTY===!0,x=s??(n?500:e?Number(e):50);Number.isFinite(x)||(console.error(`  invalid limit: ${e}`),process.exit(1));let R=async()=>{let f=await c.send({type:"evaluate",code:`(() => {
+              const obs = window.__sootsimObservability;
+              if (!obs) return { ok: false };
+              return { ok: true, entries: obs.logs.getSnapshot() };
+            })()`});if(!f||!f.ok)throw new Error("observability bridge not installed \u2014 is the engine running?");return f.entries??[]},q=f=>{let T=f.args[0];return typeof T!="string"?!1:T.startsWith("[sootsim]")},z=f=>{let T=f;if(p||(T=T.filter(P=>!q(P))),y&&(T=T.filter(P=>y.has(P.level))),o){let P=o.toLowerCase();T=T.filter(A=>A.args.join(" ").toLowerCase().includes(P))}return T};if(!n){let f=await R(),T=z(f).slice(-x);if(m){console.log(JSON.stringify(T,null,2));break}if(T.length===0){console.log(f.length===0?"  no logs captured":"  no matching logs");break}console.log(`  ${T.length} log(s):
+`);for(let P of T)mt(P,g);break}console.log(`  tailing logs (ctrl-c to stop)...
+`);let U=new Set,M=!0,v=()=>{M=!1};process.on("SIGINT",v);try{for(;M;){let f=await R(),T=z(f);for(let P of T)U.has(P.id)||(U.add(P.id),m?console.log(JSON.stringify(P)):mt(P,g));await X(250)}}finally{process.off("SIGINT",v)}break}default:console.error(`  unknown subcommand: ${b}`),process.exit(1)}if(ee.has(b)&&!t.includes("--no-wait")&&process.env.SOOTSIM_NO_AUTO_WAIT!=="1"&&await H(c),!L.has(b)&&!D(d))try{await W(c)}catch{}}catch(e){let o=e instanceof Error?e.message:String(e);if(console.error(`  ${b??"inspect"} failed: ${o}`),/^no sim connected( with id .+)?$/.test(o))Be(F);else{try{await Oe(c)}catch{}try{await w({includeTail:!0})}catch{}try{await Y({includeTail:!0})}catch{}}process.exit(1)}finally{c.close()}}export{xs as runInspect};