agent-device 0.20.0 → 0.20.1

package/dist/src/runtime.js

@@ -1,3 +1,3 @@
-import{t as e}from"./rolldown-runtime.js";import{_ as t,d as n,g as r,l as i,p as a,u as o,v as s,w as c}from"./sdk-contracts.js";import{j as l,v as u,w as d}from"./sdk-android-adb.js";import{C as f,D as p,M as m}from"./sdk-batch.js";import{$ as h,A as ee,B as te,Bt as ne,C as re,D as ie,E as ae,F as oe,G as se,H as ce,Ht as le,I as ue,J as de,M as g,N as fe,O as pe,P as me,Q as _,R as he,T as ge,U as _e,V as ve,W as ye,X as be,Y as xe,Z as Se,_t as Ce,ct as v,d as we,et as Te,it as y,j as Ee,k as De,nt as b,qn as x,r as Oe,rt as ke,tt as S,vt as Ae,z as je}from"./tv-remote.js";import{A as Me,B as Ne,I as Pe,M as Fe,P as Ie,R as Le,b as Re,d as ze,f as Be,h as Ve,m as He,t as Ue,v as We,x as Ge}from"./sdk-selectors.js";import{r as Ke,t as qe}from"./snapshot-quality.js";import{n as Je,r as Ye}from"./sdk-app-inventory.js";import{a as C,i as Xe,n as Ze,r as Qe,t as $e}from"./png-worker-contract.js";import et,{promises as w}from"node:fs";import T from"node:path";import{fileURLToPath as tt}from"node:url";import{Worker as nt}from"node:worker_threads";const rt=/\b(logbox|redbox|reload js|copy stack|component stack|call stack|runtime error|open debugger to view warnings)\b/,it=[/\b[\w.$<>/-]+\.(?:tsx?|jsx?):\d+(?::\d+)?\b/,/\b[\w.$<>/-]+\.(?:tsx?|jsx?)\s+\(\d+:\d+\)/],at=[/^!,\s+/,/^(warn|warning|error):\s+/,/\b(?:possible\s+)?unhandled (?:promise )?rejection\b/],ot=[`open debugger to view warnings`,`getsnapshot should be cached to avoid an infinite loop`,`unique "key" prop`,`unique 'key' prop`,`virtualizedlists should never be nested`,`failed prop type`],st=new Set([`x`,`×`,`✕`,`✖`,`⨯`]);function ct(e){if(lt(e).detected)return[`Hint: React Native warning/error overlay detected. It overlays part of the app and should be handled before interacting.`,`Run: agent-device react-native dismiss-overlay`,`The command verifies the overlay is gone. Run agent-device snapshot -i afterward only when you need fresh refs for the next action.`].join(`
-`)}function lt(e){let t=ft(e),n=t.detected?pt(t):null;return{detected:t.detected,dismissNodes:t.dismissNodes,minimizeNodes:t.minimizeNodes,collapsedNodes:t.collapsedNodes,primaryAction:n}}function ut(e){return bt(e.label?.trim())&&At(e.rect)}function dt(e,t){let n=e.label?.trim();return!n||!ut(e)?!1:t.some(e=>e.label?.trim()===n&&jt(e))}function ft(e){let t=e.map(mt).join(`
-`).toLowerCase(),n=Mt(e,St),r=Mt(e,Et),i=Mt(e,bt,Ot),a=Mt(e,xt),o=gt(t),s=_t(t);return{dismissNodes:n,minimizeNodes:r,collapsedNodes:i,detected:yt({text:t,hasReactNativeStackFrame:o,hasOverlayControl:vt(t,n,r),hasControllessRedBoxText:s,collapsedNodes:i,openDebuggerWarningNodes:a})}}function pt(e){let t=Nt(e.dismissNodes);if(t)return It(t,Lt(t));let n=Rt(e.collapsedNodes.filter(kt));return n?.rect?{action:`close-collapsed-banner`,point:Ut(n),rect:n.rect,ref:n.ref,label:Gt(n)}:null}function mt(e){return[e.label,e.value,e.identifier,e.type,e.role].filter(Boolean).join(` `)}function ht(e){return rt.test(e)}function gt(e){return it.some(t=>t.test(e))}function _t(e){return/\buncaught\b/.test(e)&&/unable to download asset/.test(e)}function vt(e,t,n){return t.length>0||n.length>0||/\b(reload js|copy stack)\b/.test(e)}function yt(e){return e.collapsedNodes.length>0||e.openDebuggerWarningNodes.length>0||e.hasControllessRedBoxText||e.hasOverlayControl&&(ht(e.text)||e.hasReactNativeStackFrame)}function bt(e){let t=e?.trim().toLowerCase();return t?ot.some(e=>t.includes(e))||at.some(e=>e.test(t)):!1}function xt(e){return e.includes(`open debugger to view warnings`)||/^!,\s+open debugger\b/.test(e)}function St(e){return Ct(e)||wt(e)||Tt(e)}function Ct(e){return/^dismiss(?:\s*\([^)]*\))?$/i.test(e)}function wt(e){return/^close(?:\s*\([^)]*\))?$/i.test(e)}function Tt(e){return st.has(e)}function Et(e){return/^minimi[sz]e(?:\b|\s|\()/i.test(e)}function Dt(e){return/^!,\s+/.test(e)}function Ot(e){return!e.rect||e.rect.height<=180}function kt(e){let t=Gt(e)?.trim().toLowerCase()??``;return(xt(t)||Dt(t))&&jt(e)}function At(e){return e?e.x<=1&&e.y<=1&&e.width>=300&&e.height>=600:!1}function jt(e){return e.rect?e.rect.width>=120&&e.rect.height>=36&&e.rect.height<=180:!1}function Mt(e,t,n=()=>!0){let r=[];for(let i of e)i.ref&&n(i)&&[i.label,i.value,i.identifier].map(e=>e?.trim().toLowerCase()).filter(e=>!!e).some(e=>t(e))&&r.push(i);return r}function Nt(e){return zt(e,Ft)}function Pt(e){let t=[e.type,e.role,e.subrole].join(` `).toLowerCase();return/\b(button|menuitem|link)\b/.test(t)}function Ft(e){return[Vt(Pt(e)),Vt(e.hittable),-(e.rect?Pe(e.rect):1/0)]}function It(e,t){if(!e.rect)throw Error(`React Native overlay target node must have rect`);return{action:t,point:o(e.rect),rect:e.rect,ref:e.ref,label:Gt(e)}}function Lt(e){let t=Gt(e)?.trim().toLowerCase();return t&&Ct(t)?`dismiss`:`close`}function Rt(e){return zt(e,Bt)}function zt(e,t){let n=e.filter(e=>e.rect);return n.length===0?null:n.sort((e,n)=>Ht(t(n),t(e)))[0]??null}function Bt(e){return[Vt(e.hittable),e.rect?.width??0,e.rect?.y??0]}function Vt(e){return+(e===!0)}function Ht(e,t){for(let n=0;n<e.length;n+=1){let r=e[n]-t[n];if(r!==0)return r}return 0}function Ut(e){if(!e.rect)throw Error(`Collapsed React Native warning node must have rect`);let t=Math.min(e.rect.height,52),n=Math.min(36,Math.max(18,t*.45));return{x:Math.round(Wt(e.rect.x+e.rect.width-n,e.rect.x+1,e.rect.x+e.rect.width-1)),y:Math.round(e.rect.y+t/2)}}function Wt(e,t,n){return Math.min(n,Math.max(t,e))}function Gt(e){return e.label??e.value??e.identifier}const Kt=[`status`,`get`,`dismiss`,`enter`,`return`];function qt(e){return Kt.includes(e)}function Jt(e){let t=e?.trim().split(/\s+/,1)[0];if(!t||!t.startsWith(`@`)||t.length<3)return null;let n=t.slice(1);return/^[A-Za-z_-]*\d[\w-]*$/i.test(n)||/^(?:ref|node|element|el)[\w-]*$/i.test(n)?t:null}function Yt(e,t){try{let n=tt(e),r=T.extname(n)||`.js`;return[T.join(T.dirname(n),`${t}${r}`),T.join(T.dirname(n),`internal`,`${t}${r}`)].find(e=>et.existsSync(e))??null}catch{return null}}var E=class extends Error{};let D=null,Xt=!1,Zt=!1,Qt=0;const O=new Map;function $t(e){Xt=!0,!Zt&&(Zt=!0,l({level:`warn`,phase:`png_worker_unavailable`,data:{reason:e}}),process.emitWarning(`PNG worker unavailable, falling back to in-process PNG processing: ${e}`))}function en(e){let n=O.get(e.id);n&&(O.delete(e.id),rn(),e.ok?n.resolve(e.result):n.reject(new t(c(e.error.code),e.error.message,e.error.details)))}function tn(e,t){D===e&&($t(t.message),D=null,e.terminate().catch(()=>{}),nn(new E(`PNG worker failed: ${t.message}`)))}function nn(e){let t=[...O.values()];O.clear();for(let n of t)n.reject(e)}function rn(){D&&(O.size>0?D.ref():D.unref())}function an(){if(Xt)return null;if(D)return D;let e=Yt(import.meta.url,`png-worker`);if(!e)return $t(`worker entry module not found next to the current module`),null;try{let t=new nt(e,{execArgv:e.endsWith(`.ts`)?[`--experimental-strip-types`]:[]});return t.on(`message`,en),t.on(`error`,e=>{tn(t,e)}),t.on(`exit`,e=>{tn(t,Error(`PNG worker exited with code ${e}`))}),t.unref(),D=t,t}catch(e){return $t(`failed to spawn worker: ${e instanceof Error?e.message:String(e)}`),null}}function on(e){let t=an();if(!t)return Promise.reject(new E(`PNG worker is unavailable`));Qt+=1;let n=Qt;return new Promise((r,i)=>{O.set(n,{resolve:r,reject:i}),rn();try{t.postMessage({...e,id:n})}catch(e){O.delete(n),rn(),i(new E(`failed to post job to PNG worker: ${e instanceof Error?e.message:String(e)}`))}})}async function sn(e,t){try{return await on(e)}catch(e){if(e instanceof E)return t();throw e}}function cn(){an()}async function ln(){let e=D;D=null,nn(new E(`PNG worker terminated`)),e&&await e.terminate()}async function k(e,t){let n=await sn({kind:`decode`,png:e,label:t},()=>{let n=Xe(e,t);return{kind:`decode`,width:n.width,height:n.height,data:n.data}});return new C({width:n.width,height:n.height,data:$e(n.data)})}async function un(e){return $e((await sn({kind:`encode`,width:e.width,height:e.height,data:e.data},()=>({kind:`encode`,png:C.sync.write(e)}))).png)}async function dn(e,t,n){let{kind:r,...i}=await sn({kind:`rgb-difference`,firstPng:e,secondPng:t,label:n},()=>({kind:`rgb-difference`,...Ze(Xe(e,n),Xe(t,n))}));return i}async function fn(e){let{kind:t,...n}=await sn({kind:`diff-pixels`,...e},()=>({kind:`diff-pixels`,...Qe(e)}));return{...n,diffData:$e(n.diffData)}}const pn=[0,187,255,255];function mn(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||hn(e,n.rect)}function hn(e,t){let n=gn(t);if(n==null)return;let r=vn(n.x,0,e.width-1),i=vn(n.y,0,e.height-1),a=vn(n.right,0,e.width-1),o=vn(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)_n(e,n,i+t,pn),_n(e,n,o-t,pn);for(let n=i;n<=o;n+=1)_n(e,r+t,n,pn),_n(e,a-t,n,pn)}}function gn(e){let t=e.x+e.width-1,n=e.y+e.height-1;return[e.x,e.y,e.width,e.height,t,n].every(Number.isFinite)?{x:e.x,y:e.y,right:t,bottom:n}:null}function _n(e,t,n,r){if(t<0||t>=e.width||n<0||n>=e.height)return;let i=(n*e.width+t)*4;e.data[i]=r[0],e.data[i+1]=r[1],e.data[i+2]=r[2],e.data[i+3]=r[3]}function vn(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}const yn=[{x:-1,y:-1},{x:0,y:-1},{x:1,y:-1},{x:-1,y:0},{x:1,y:0},{x:-1,y:1},{x:0,y:1},{x:1,y:1}];function bn(e){let{mask:t,width:n,height:r,hooks:i}=e,a=new Uint8Array(t.length),o=new Int32Array(t.length),s=[];for(let e=0;e<t.length;e+=1){if(!Cn(t,a,e))continue;let c=0,l=Sn(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=xn({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function xn(e){let{mask:t,visited:n,queue:r,width:i,height:a,pixelIndex:o}=e,s=o%i,c=Math.floor(o/i),l=e.queueEnd;for(let e of yn){let o=s+e.x,u=c+e.y;if(!wn(o,u,i,a))continue;let d=u*i+o;Cn(t,n,d)&&(l=Sn(r,n,l,d))}return l}function Sn(e,t,n,r){return t[r]=1,e[n]=r,n+1}function Cn(e,t,n){return e[n]===1&&t[n]!==1}function wn(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}const Tn=.4,En={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},Dn={leading:20,trailing:20,separator:10,unknown:0,background:-30};function On(e){let t=Nn(An(kn(e.diffMask,e.width,e.height,e.ocr),e.width,e.height),10),n=Wn(e.ocr?.currentBlocksRaw??[]),r=Wn(e.ocr?.baselineBlocksRaw??[]);return t.filter(Jn).map(t=>Pn(t,e,n,r)).filter(t=>t.rect.y>=e.height*.08).filter(Rn).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,e.maxDeltas??12)).map((e,t)=>Fn(e,t+1))}function kn(e,t,n,r){let i=new Uint8Array(e);if(!r)return i;for(let e of[...r.baselineBlocksRaw,...r.currentBlocksRaw])Xn(i,t,n,xe(e.rect,8));return i}function An(e,t,n){return bn({mask:e,width:t,height:n,hooks:{create:e=>jn(e,t),visit:(e,n)=>Mn(e,n,t)}})}function jn(e,t){let n=e%t,r=Math.floor(e/t);return{minX:n,minY:r,maxX:n,maxY:r,differentPixels:0}}function Mn(e,t,n){let r=t%n,i=Math.floor(t/n);e.minX=Math.min(e.minX,r),e.minY=Math.min(e.minY,i),e.maxX=Math.max(e.maxX,r),e.maxY=Math.max(e.maxY,i),e.differentPixels+=1}function Nn(e,t){let n=[];for(let r of e.sort((e,t)=>e.minY-t.minY||e.minX-t.minX)){let e=n.find(e=>Zn(e,r,t));if(!e){n.push({...r});continue}e.minX=Math.min(e.minX,r.minX),e.minY=Math.min(e.minY,r.minY),e.maxX=Math.max(e.maxX,r.maxX),e.maxY=Math.max(e.maxY,r.maxY),e.differentPixels+=r.differentPixels}return n}function Pn(e,t,n,r){let i=Yn(e),a=Vn(i,t.regions),o=Hn(i,n,r),s=In(i,o?.block.rect,t.width),c=Ln(i,s,e.differentPixels,t),l={...a?{regionIndex:a}:{},slot:s,likelyKind:c,rect:i};return{...a?{regionIndex:a}:{},slot:s,likelyKind:c,rect:i,...o?{nearestText:qn(o.block.text)}:{},score:zn(l,e.differentPixels,t)}}function Fn(e,t){return{index:t,...e.regionIndex?{regionIndex:e.regionIndex}:{},slot:e.slot,likelyKind:e.likelyKind,rect:e.rect,...e.nearestText?{nearestText:e.nearestText}:{}}}function In(e,t,n){if(e.height<=3&&e.width>=n*.12)return`separator`;if(!t)return e.width>=n*Tn?`background`:`unknown`;if(e.width>=n*Tn)return`background`;let r=e.x+e.width/2,i=t.x+t.width/2;return r<i-t.width/2?`leading`:r>i+t.width/2?`trailing`:e.width>=n*.35?`background`:`unknown`}function Ln(e,t,n,r){let i=e.width/e.height,a=n/(e.width*e.height);return t===`separator`?`separator`:t===`background`?`background`:t===`trailing`&&i>=1.5&&i<=3.8&&a>=.35?`toggle`:t===`trailing`&&e.width<=r.width*.06&&e.height<=r.height*.04?`chevron`:t===`leading`&&i>=.55&&i<=1.8?`icon`:Bn(e,r)?`background`:`visual`}function Rn(e){return e.likelyKind!==`background`}function zn(e,t,n){let r=Bn(e.rect,n)?-35:0,i=e.regionIndex?20:0;return En[e.likelyKind]+Dn[e.slot]+i+r+Math.min(20,t/200)}function Bn(e,t){return e.width>=t.width*.25||e.height>=t.height*.06}function Vn(e,t){let n,r=0;for(let i of t){let t=be(e,i.rect);t<=r||(r=t,n=i)}return n?.index}function Hn(e,t,n){let r=Un(e,t);if(r)return Kn(e,r.blocks);let i=Un(e,n);return i?Kn(e,i.blocks):void 0}function Un(e,t){let n,r=0;for(let i of t){let t=Qn(e,i.rect);t<=r||(r=t,n=i)}return n}function Wn(e){let t=[];for(let n of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>Gn(e.rect,n.rect));if(!e){t.push({rect:n.rect,blocks:[n]});continue}e.blocks.push(n),e.blocks.sort((e,t)=>e.rect.x-t.rect.x),e.rect=Te([e.rect,n.rect])}return t}function Gn(e,t){return Qn(e,t)>0?!0:Math.abs(_(e).y-_(t).y)<=Math.max(e.height,t.height)*.5}function Kn(e,t){let n,r=_(e);for(let e of t){let t=Math.sqrt(h(r,_(e.rect)));n&&t>=n.distance||(n={block:e,distance:t})}return n}function qn(e){return e.trim().replace(/^[^\p{L}\p{N}]+/u,``).replace(/^\p{L}\s+/u,``)}function Jn(e){let t=Yn(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function Yn(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function Xn(e,t,n,r){let i=de(Math.floor(r.x),0,t-1),a=de(Math.floor(r.y),0,n-1),o=de(Math.ceil(r.x+r.width),0,t),s=de(Math.ceil(r.y+r.height),0,n);for(let n=a;n<s;n+=1)for(let r=i;r<o;r+=1)e[n*t+r]=0}function Zn(e,t,n){return e.minX-n<=t.maxX&&t.minX-n<=e.maxX&&e.minY-n<=t.maxY&&t.minY-n<=e.maxY}function Qn(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}async function $n(e){if(await d(`tesseract`))try{let[t,n]=await Promise.all([nr(e.baselinePath),nr(e.currentPath)]);if(t.exitCode!==0||n.exitCode!==0)return;let r=er(t.stdout,e.width,e.height),i=er(n.stdout,e.width,e.height),a=tr(r,i),o=lr(a);return r.length===0&&i.length===0?void 0:{provider:`tesseract`,baselineBlocks:r.length,currentBlocks:i.length,baselineBlocksRaw:r,currentBlocksRaw:i,matches:a,...o.length>0?{movementClusters:o}:{}}}catch{return}}function er(e,t,n){let[r,...i]=e.split(/\r?\n/);if(!r)return[];let a=r.split(`	`),o=new Map(a.map((e,t)=>[e,t])),s=[];for(let e of i){if(!e.trim())continue;let t=e.split(`	`),n=j(t,o,`level`),r=A(t,o,`text`).trim(),i=j(t,o,`conf`);if(n!==5||!fr(r)||i<0)continue;let a=j(t,o,`left`),c=j(t,o,`top`),l=j(t,o,`width`),u=j(t,o,`height`);l<=0||u<=0||s.push({key:[A(t,o,`page_num`),A(t,o,`block_num`),A(t,o,`par_num`),A(t,o,`line_num`)].join(`:`),text:r,confidence:i,rect:{x:a,y:c,width:l,height:u}})}let c=new Map;for(let e of s){let t=c.get(e.key);t?t.push(e):c.set(e.key,[e])}return Array.from(c.values()).flatMap(e=>ir(e)).map(e=>rr(e,t,n)).filter(e=>e!==null)}function tr(e,t){let n=new Set,r=[];for(let i of e){let e=ar(i,pr(i.text),t,n);if(e===null)continue;n.add(e);let a=t[e],o=or(i,a);sr(o)&&r.push(o)}return r.sort((e,t)=>cr(t)-cr(e)).slice(0,12)}function nr(e){return u(`tesseract`,[e,`stdout`,`-l`,`eng`,`tsv`],{allowFailure:!0,timeoutMs:1e4})}function rr(e,t,n){if(e.length===0)return null;let r=[...e].sort((e,t)=>e.rect.x-t.rect.x),i=Te(r.map(e=>e.rect)),a=Math.round(mr(r.map(e=>e.confidence))*100)/100;return{text:r.map(e=>e.text).join(` `),confidence:a,rect:i,normalizedRect:Se({x:M(i.x/t),y:M(i.y/n),width:M(i.width/t),height:M(i.height/n)})}}function ir(e){let t=[...e].sort((e,t)=>e.rect.x-t.rect.x),n=[],r=[];for(let e of t){let t=r.at(-1);if(!t){r.push(e);continue}let i=e.rect.x-(t.rect.x+t.rect.width),a=Math.max(t.rect.height,e.rect.height);if(i>Math.max(48,a*2.5)){n.push(r),r=[e];continue}r.push(e)}return r.length>0&&n.push(r),n}function ar(e,t,n,r){let i=null,a=1/0;for(let o=0;o<n.length;o+=1){if(r.has(o))continue;let s=n[o];if(pr(s.text)!==t)continue;let c=h(_(e.normalizedRect),_(s.normalizedRect));c>=a||(i=o,a=c)}return i}function or(e,t){let n={x:t.rect.x-e.rect.x,y:t.rect.y-e.rect.y,width:t.rect.width-e.rect.width,height:t.rect.height-e.rect.height},r=hr(t.rect.width/e.rect.width),i=hr(t.rect.height/e.rect.height),a=Math.abs(r-1)>=.08||Math.abs(i-1)>=.12;return{text:e.text,baselineRect:e.rect,currentRect:t.rect,delta:n,confidence:Math.round(Math.min(e.confidence,t.confidence)*100)/100,possibleTextMetricMismatch:a}}function sr(e){return Math.abs(e.delta.x)>=2||Math.abs(e.delta.y)>=2||Math.abs(e.delta.width)>=2||Math.abs(e.delta.height)>=2||e.possibleTextMetricMismatch}function cr(e){return Math.abs(e.delta.x)+Math.abs(e.delta.y)+Math.abs(e.delta.width)+Math.abs(e.delta.height)+(e.possibleTextMetricMismatch?25:0)}function lr(e){let t=[];for(let n of[...e].sort((e,t)=>e.currentRect.y-t.currentRect.y)){let e=t.find(e=>Math.abs(n.delta.x-mr(e.map(e=>e.delta.x)))<=32);e?e.push(n):t.push([n])}return t.filter(e=>e.length>=2).map(ur).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>dr(t)-dr(e)).slice(0,4)}function ur(e){let t=e.map(e=>e.delta.x),n=e.map(e=>e.delta.y);return{texts:e.map(e=>e.text),xRange:{min:Math.min(...t),max:Math.max(...t)},yRange:{min:Math.min(...n),max:Math.max(...n)}}}function dr(e){let t=(e.xRange.min+e.xRange.max)/2,n=(e.yRange.min+e.yRange.max)/2;return Math.abs(t)*2+Math.abs(n)}function A(e,t,n){let r=t.get(n);return r===void 0?``:e[r]??``}function j(e,t,n){let r=Number(A(e,t,n));return Number.isFinite(r)?r:0}function fr(e){return/[\p{L}\p{N}]/u.test(e)}function pr(e){return e.trim().replace(/\s+/g,` `).toLowerCase()}function mr(e){return e.reduce((e,t)=>e+t,0)/e.length}function M(e){return Math.round(e*100*100)/100}function hr(e){return Math.round(e*1e3)/1e3}function gr(e,t){return e.flatMap(e=>_r(e,t.baseline.width,t.baseline.height)?vr(e,t,wr(t.baseline.height)):[e])}function _r(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=Cr(n)&&r>=t*.35}function vr(e,t,n){let r=Sr(e,xr(br(yr(e,t.diffMask,t.baseline.width)),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),n);if(r.length<=1)return[e];let i=r.map(([n,r])=>Tr(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function yr(e,t,n){let r=[];for(let i=e.minY;i<=e.maxY;i+=1){let a=0;for(let r=e.minX;r<=e.maxX;r+=1)t[i*n+r]===1&&(a+=1);r.push(a)}return r}function br(e){return e.map((t,n)=>{let r=0,i=0,a=Math.max(0,n-3),o=Math.min(e.length-1,n+3);for(let t=a;t<=o;t+=1)r+=e[t],i+=1;return Math.round(r/i)})}function xr(e,t){let n=[],r=null;for(let i=0;i<e.length;i+=1){if(e[i]<=t){r??=i;continue}r!==null&&(i-r>=6&&n.push([r,i-1]),r=null)}return r!==null&&e.length-r>=6&&n.push([r,e.length-1]),n}function Sr(e,t,n){let r=[],i=e.minY;for(let[a,o]of t){let t=e.minY+Math.round((a+o)/2);t-i+1<n||e.maxY-t<n||(r.push([i,t]),i=t+1)}return r.push([i,e.maxY]),r}function Cr(e){return Math.max(48,Math.round(e*.07))}function wr(e){return Math.max(24,Math.round(e*.03))}function Tr(e,t,n,r){let i=null;for(let a=t;a<=n;a+=1)for(let t=e.minX;t<=e.maxX;t+=1){let e=a*r.baseline.width+t;r.diffMask[e]===1&&(i??=Er(t,a),Dr(i,e,t,a,r.baseline,r.current))}return i}function Er(e,t){return{minX:e,minY:t,maxX:e,maxY:t,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function Dr(e,t,n,r,i,a){let o=t*4;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,r),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,r),e.differentPixels+=1,e.baselineRed+=i.data[o],e.baselineGreen+=i.data[o+1],e.baselineBlue+=i.data[o+2],e.currentRed+=a.data[o],e.currentGreen+=a.data[o+1],e.currentBlue+=a.data[o+2]}const Or=2.5;function kr(e){let t=Ar(e);return gr(t.length<=2e3?Nr(t,12):t,e).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(n!==0)return n;let r=e.minY-t.minY;return r===0?e.minX-t.minX:r}).slice(0,Math.max(0,e.maxRegions??8)).map((t,n)=>Ir(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function Ar(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return bn({mask:t,width:i,height:a,hooks:{create:e=>jr(e,i),visit:(e,t)=>Mr(e,t,i,n,r)}})}function jr(e,t){let n=e%t,r=Math.floor(e/t);return{minX:n,minY:r,maxX:n,maxY:r,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function Mr(e,t,n,r,i){let a=t%n,o=Math.floor(t/n),s=t*4;e.minX=Math.min(e.minX,a),e.minY=Math.min(e.minY,o),e.maxX=Math.max(e.maxX,a),e.maxY=Math.max(e.maxY,o),e.differentPixels+=1,e.baselineRed+=r.data[s],e.baselineGreen+=r.data[s+1],e.baselineBlue+=r.data[s+2],e.currentRed+=i.data[s],e.currentGreen+=i.data[s+1],e.currentBlue+=i.data[s+2]}function Nr(e,t){let n=[];for(let r of e.sort((e,t)=>{let n=e.minY-t.minY;return n===0?e.minX-t.minX:n})){let e=n.find(e=>Pr(e,r,t));if(!e){n.push({...r});continue}Fr(e,r)}return n}function Pr(e,t,n){return e.minX-n<=t.maxX&&t.minX-n<=e.maxX&&e.minY-n<=t.maxY&&t.minY-n<=e.maxY}function Fr(e,t){e.minX=Math.min(e.minX,t.minX),e.minY=Math.min(e.minY,t.minY),e.maxX=Math.max(e.maxX,t.maxX),e.maxY=Math.max(e.maxY,t.maxY),e.differentPixels+=t.differentPixels,e.baselineRed+=t.baselineRed,e.baselineGreen+=t.baselineGreen,e.baselineBlue+=t.baselineBlue,e.currentRed+=t.currentRed,e.currentGreen+=t.currentGreen,e.currentBlue+=t.currentBlue}function Ir(e,t,n){let r={x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1},i={x:Math.round(e.minX+r.width/2),y:Math.round(e.minY+r.height/2)},a=Lr(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=Lr(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height,c=P(e.differentPixels/s),l=Math.round(N(a)),u=Math.round(N(o)),d=Br(r,n.width,n.height),f=Vr(s,n.totalPixels),p=zr(a,o),m=Rr(i,n.width,n.height);return{index:t,rect:r,normalizedRect:Se({x:P(r.x/n.width),y:P(r.y/n.height),width:P(r.width/n.width),height:P(r.height/n.height)}),differentPixels:e.differentPixels,shareOfDiffPercentage:P(e.differentPixels/n.differentPixels),densityPercentage:c,shape:d,size:f,location:m,averageBaselineColorHex:Hr(a),averageCurrentColorHex:Hr(o),baselineLuminance:l,currentLuminance:u,dominantChange:p}}function Lr(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function Rr(e,t,n){let r=e.x<t/3?`left`:e.x>t*2/3?`right`:`center`,i=e.y<n/3?`top`:e.y>n*2/3?`bottom`:`middle`;return r===`center`&&i===`middle`?`center`:`${i}-${r}`}function zr(e,t){let n=N(e),r=N(t)-n;return Math.abs(r)>=12?r>0?`brighter`:`darker`:Math.max(Math.abs(t.r-e.r),Math.abs(t.g-e.g),Math.abs(t.b-e.b))>=12?`color-shift`:`mixed`}function Br(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*Or?`horizontal-band`:e.height>=e.width*Or?`vertical-band`:`compact`}function Vr(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function N(e){return e.r*.2126+e.g*.7152+e.b*.0722}function Hr(e){return`#${Ur(e.r)}${Ur(e.g)}${Ur(e.b)}`}function Ur(e){return e.toString(16).padStart(2,`0`)}function P(e){return Math.round(e*100*100)/100}const Wr=255*Math.sqrt(3);async function Gr(e,t,n={}){await Kr(e,`Baseline image not found`),await Kr(t,`Current screenshot not found`);let r=n.outputPath,[i,a]=await Promise.all([w.readFile(e),w.readFile(t)]),[o,s]=await Promise.all([k(i,`baseline screenshot`),k(a,`current screenshot`)]);qr(o.width,o.height,`baseline screenshot`,n.maxPixels),qr(s.width,s.height,`current screenshot`,n.maxPixels);let c=n.threshold??.1;if(o.width!==s.width||o.height!==s.height){let e=o.width*o.height;return await Jr(n.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:o.width,height:o.height},actual:{width:s.width,height:s.height}}}}let l=o.width*o.height,u=c*Wr,{diffData:d,diffMask:f,differentPixels:p}=await fn({width:o.width,height:o.height,baselineData:o.data,currentData:s.data,maxColorDistance:u}),m=p>0?kr({diffMask:f,baseline:o,current:s,totalPixels:l,differentPixels:p,maxRegions:n.maxRegions}):[];if(p>0&&r){let e=new C({width:o.width,height:o.height,data:d});mn(e,m),await w.mkdir(T.dirname(r),{recursive:!0}),await w.writeFile(r,await un(e))}else await Jr(n.outputPath);let h=p>0?await $n({baselinePath:e,currentPath:t,width:o.width,height:o.height}):void 0,ee=h&&(h.matches.length>0||(h.movementClusters?.length??0)>0)?{provider:h.provider,baselineBlocks:h.baselineBlocks,currentBlocks:h.currentBlocks,matches:h.matches,...h.movementClusters?{movementClusters:h.movementClusters}:{}}:void 0,te=p>0&&h?On({diffMask:f,width:o.width,height:o.height,regions:m,ocr:h}):[],ne=l>0?Math.round(p/l*100*100)/100:0;return{...p>0&&r?{diffPath:r}:{},...m.length>0?{regions:m}:{},...ee?{ocr:ee}:{},...te.length>0?{nonTextDeltas:te}:{},totalPixels:l,differentPixels:p,mismatchPercentage:ne,match:p===0}}async function Kr(e,n){try{await w.access(e)}catch{throw new t(`INVALID_ARGS`,`${n}: ${e}`)}}function qr(e,n,r,i){if(i==null||i<=0)return;let a=e*n;if(!(a<=i))throw new t(`INVALID_ARGS`,`${r} is ${a} pixels, which exceeds the configured maxImagePixels limit of ${i}`)}async function Jr(e){if(e)try{await w.unlink(e)}catch(e){if(!Yr(e,`ENOENT`))throw e}}function Yr(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function Xr(e,t){return e.map(e=>{let n=Zr(e,t);return n.length>0?{...e,currentOverlayMatches:n}:e})}function Zr(e,t){let n=Qr(e.rect);return t.map(t=>{let r=t.overlayRect,i=be(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:$r(i/Qr(r)),regionCoveragePercentage:$r(i/n)}}).filter(e=>e!==null).sort((e,t)=>{let n=t.regionCoveragePercentage-e.regionCoveragePercentage;return n===0?t.overlayCoveragePercentage-e.overlayCoveragePercentage:n}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage}))}function Qr(e){return e.width*e.height}function $r(e){return Math.round(e*100*100)/100}async function F(e,n,r){if(n.kind===`path`&&!e.policy.allowLocalInputPaths)throw new t(`INVALID_ARGS`,`Local ${r.field??`input`} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(n,r)}catch(e){throw s(e)}}async function I(e,n,r){if(n?.kind===`path`&&!e.policy.allowLocalOutputPaths)throw new t(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await e.artifacts.reserveOutput(n,{...r,visibility:r.visibility??`client-visible`,requestedClientPath:n?.kind===`downloadableArtifact`?n.clientPath??r.requestedClientPath:r.requestedClientPath})}catch(e){throw s(e)}}async function ei(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw s(e)}}const ti=async(e,n)=>{if(!n.baseline)throw new t(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let r=ni(n.threshold),i=n.current??{kind:`live`};if(n.overlayRefs&&!li(i))throw new t(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let a=await F(e,n.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let t;li(i)?(s=await ri(e,n),t=s.path):(o=await F(e,i,{usage:`diff screenshot current`,field:`current`}),t=o.path),c=n.out?await I(e,n.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await Gr(a.path,t,{threshold:r,outputPath:c?.path,maxPixels:e.policy.maxImagePixels});li(i)&&(u=await ii(e,n,c?.path,u,l));let d=u.diffPath?await c?.publish():void 0;return d&&l.push(d),u.diffPath||await c?.cleanup?.(),{...u,...l.length>0?{artifacts:l}:{}}}catch(e){throw await c?.cleanup?.(),e}finally{await a.cleanup?.(),await o?.cleanup?.(),await s?.cleanup?.()}};function ni(e){if(e==null||e===``)return .1;let n=Number(e);if(Number.isNaN(n)||n<0||n>1)throw new t(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return n}async function ri(e,t){let n=await ei(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await ai(e,t,n.path,oi(t))}catch(e){throw await n.cleanup(),e}return n}async function ii(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await ci(n),r;let a=await I(e,si(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await ai(e,t,a.path,{overlayRefs:!0,...oi(t)}),o=await a.publish();return o&&i.push(o),{...r,currentOverlayPath:n.path??a.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...r.regions&&n.overlayRefs?{regions:Xr(r.regions,n.overlayRefs)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function ai(e,n,r,i={}){if(!e.backend.captureScreenshot)throw new t(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await e.backend.captureScreenshot({session:n.session,requestId:n.requestId,signal:n.signal??e.signal,metadata:n.metadata},r,i)??{}}function oi(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function si(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:L(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:L(e.out.clientPath)}:{},...e.out.fileName?{fileName:L(e.out.fileName)}:{}}}function L(e){let t=T.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function ci(e){try{await w.unlink(L(e))}catch(e){if(!ui(e,`ENOENT`))throw e}}function li(e){return e.kind===`live`}function ui(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}async function di(e,n){if(!Number.isInteger(n)||n<1)throw new t(`INVALID_ARGS`,`Screenshot max size must be a positive integer`);let r=await k(await w.readFile(e),`screenshot`),i=Math.max(r.width,r.height);if(i<=n)return;let a=n/i,o=pi(r,Math.max(1,Math.round(r.width*a)),Math.max(1,Math.round(r.height*a)));await w.writeFile(e,await un(o))}async function fi(e,n,r){if(!Number.isInteger(n)||n<1||!Number.isInteger(r)||r<1)throw new t(`INVALID_ARGS`,`Screenshot resize dimensions must be positive integers`);let i=await k(await w.readFile(e),`screenshot`);i.width===n&&i.height===r||await w.writeFile(e,await un(pi(i,n,r)))}function pi(e,t,n){let r=new C({width:t,height:n});for(let i=0;i<n;i+=1){let a=i*e.height/n,o=(i+1)*e.height/n;for(let n=0;n<t;n+=1){let s=n*e.width/t,c=(n+1)*e.width/t,l=0,u=0,d=0,f=0,p=0;for(let t=Math.floor(a);t<Math.ceil(o);t+=1){let n=Math.min(t+1,o)-Math.max(t,a);for(let r=Math.floor(s);r<Math.ceil(c);r+=1){let i=n*(Math.min(r+1,c)-Math.max(r,s)),a=(t*e.width+r)*4;l+=(e.data[a]??0)*i,u+=(e.data[a+1]??0)*i,d+=(e.data[a+2]??0)*i,f+=(e.data[a+3]??0)*i,p+=i}}let m=(i*r.width+n)*4;r.data[m]=Math.round(l/p),r.data[m+1]=Math.round(u/p),r.data[m+2]=Math.round(d/p),r.data[m+3]=Math.round(f/p)}}return r}const mi=async(e,n)=>{if(!e.backend.captureScreenshot)throw new t(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);let r=await I(e,n.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),i;try{await e.backend.captureScreenshot({session:n.session,requestId:n.requestId,appId:n.appId,appBundleId:n.appBundleId,signal:n.signal??e.signal,metadata:n.metadata},r.path,{fullscreen:n.fullscreen,overlayRefs:n.overlayRefs,pixelDensity:n.pixelDensity,stabilize:n.stabilize,normalizeStatusBar:n.normalizeStatusBar,surface:n.surface}),n.maxSize!==void 0&&await di(r.path,n.maxSize),i=await r.publish()}catch(e){throw await r.cleanup?.(),e}return{path:r.path,...i?{artifacts:[i]}:{},...x(`Saved screenshot: ${r.path}`)}};function hi(e){let{nodes:t,backend:n,snapshotRaw:i}=e;if(i||!r(n))return{partial:!1,visibleNodeCount:t.length,totalNodeCount:t.length,reasons:[]};let a=Le(t),o=new Set;return a.hiddenCount>0&&o.add(`offscreen-nodes`),a.nodes.some(e=>e.hiddenContentAbove)&&o.add(`scroll-hidden-above`),a.nodes.some(e=>e.hiddenContentBelow)&&o.add(`scroll-hidden-below`),{partial:o.size>0,visibleNodeCount:a.nodes.length,totalNodeCount:t.length,reasons:[...o]}}const gi=`A system surface (notification shade, quick settings, or another system overlay) covers the app, so this snapshot shows that surface. Interact with it or dismiss it (press back or swipe up) to reach app content.`;function _i(e){return e?.systemSurfaceOnly===!0?gi:void 0}function vi(e,t){return e.presentationKey?e:{...e,presentationKey:i(t)}}function yi(e){let{previous:t,current:n,options:r,identity:i}=e;if(r.forceFull===!0||r.raw===!0||!t||t.comparisonSafe===!1||n.comparisonSafe===!1||!bi(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!xi(t,n))return;let a=r.scope?.trim();return{ageMs:Math.max(0,n.createdAt-t.createdAt),nodeCount:n.nodes.length,...r.interactiveOnly===!0?{interactiveOnly:!0}:{},...a?{scope:a}:{}}}function bi(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function xi(e,t){return e.truncated===t.truncated?JSON.stringify(Si(e.nodes))===JSON.stringify(Si(t.nodes)):!1}function Si(e){return e.map(e=>({index:e.index,depth:e.depth,parentIndex:e.parentIndex,type:e.type,role:e.role,subrole:e.subrole,label:e.label,value:e.value,identifier:e.identifier,enabled:e.enabled,selected:e.selected,focused:e.focused,hittable:e.hittable,rect:e.rect,bundleId:e.bundleId,appName:e.appName,windowTitle:e.windowTitle,surface:e.surface,hiddenContentAbove:e.hiddenContentAbove,hiddenContentBelow:e.hiddenContentBelow,interactionBlocked:e.interactionBlocked,presentationHints:e.presentationHints}))}const Ci=async(e,t)=>{let n=await Ti(e,t),r=yi({previous:n.session?.snapshot,current:n.snapshot,options:t,identity:{previousAppBundleId:n.session?.appBundleId,currentAppBundleId:n.result.appBundleId??n.session?.appBundleId}});return await e.sessions.set(Di(t.session,n)),{nodes:n.snapshot.nodes,truncated:n.snapshot.truncated??!1,visibility:hi({nodes:n.snapshot.nodes,backend:n.snapshot.backend,snapshotRaw:t.raw}),...ne({...n.annotations,warnings:n.warnings}),...r?{unchanged:r}:{},...n.result.snapshotDiagnostics?{snapshotDiagnostics:n.result.snapshotDiagnostics}:{},...Oi(n)}},wi=async(e,t)=>{let n=await Ti(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,a=Di(t.session,n);if(!i){let t=je(n.snapshot.nodes,{flatten:r});return await e.sessions.set(a),{mode:`snapshot`,baselineInitialized:!0,summary:{additions:0,removals:0,unchanged:t},lines:[],...n.warnings.length>0?{warnings:n.warnings}:{}}}let o=he(i.nodes,n.snapshot.nodes,{flatten:r});return await e.sessions.set(a),{mode:`snapshot`,baselineInitialized:!1,summary:o.summary,lines:o.lines,...n.warnings.length>0?{warnings:n.warnings}:{}}};async function Ti(e,n){if(!e.backend.captureSnapshot)throw new t(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=n.session??`default`,i=await e.sessions.get(r),a=await e.backend.captureSnapshot({session:r,requestId:n.requestId,appId:i?.appId,appBundleId:i?.appBundleId,signal:n.signal??e.signal,metadata:n.metadata},{interactiveOnly:n.interactiveOnly,depth:n.depth,scope:n.scope,raw:n.raw}),o=vi(Ei(a,e),n),s=le(a),c=b(e);return{snapshot:o,result:a,session:i,annotations:s,warnings:ki({result:a,annotations:s,snapshot:o,options:n,session:i,capturedAt:o.createdAt??c,runtimeNow:c})}}function Ei(e,t){return e.snapshot?e.snapshot:{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,createdAt:b(t)}}function Di(e,t){let n=t.session?.name??e??`default`;return{...t.session??{name:n},name:n,snapshot:t.snapshot,appName:t.result.appName??t.session?.appName,appBundleId:t.result.appBundleId??t.session?.appBundleId}}function Oi(e){let t=e.result.appName??e.session?.appName,n=e.result.appBundleId??e.session?.appBundleId;return{...t||n?{appName:t??n}:{},...n?{appBundleId:n}:{}}}function ki(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...Ke(e.annotations.quality,e.snapshot.nodes)),t.push(...Ni(e)),e.annotations.quality||(t.push(...ji(e)),t.push(...Mi(e.snapshot.nodes)));let n=ct(e.snapshot.nodes);n&&t.push(n);let r=Ai(e.annotations);r&&t.push(r);let i=Pi(e);return i&&t.push(i),t.push(...Ri(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function Ai(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return gi}function ji(e){return e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1||e.snapshot.nodes[0]?.type!==`Application`?[]:[`iOS interactive snapshot exposed only the application root. XCTest accessibility queries can fail to enumerate some simulator UI trees even when screenshots and direct gestures still work. Use screenshot as visual truth, try a scoped/full snapshot for diagnostics, and prefer direct selectors when known.`]}function Mi(e){let t=new Set(e.map(e=>e.parentIndex).filter(e=>e!==void 0));return e.filter(e=>t.has(e.index)||(e.type?.toLowerCase()??``).includes(`text`)?!1:(e.label??``).split(`, `).length>10).map(e=>{let t=(e.label??``).split(`, `).length,n=e.identifier?` (${e.identifier})`:``;return`@${e.ref} [${e.type??`element`}]${n} merges ~${t} labels into a single accessibility element. The app likely marks a container as accessible, which hides every descendant from assistive tech and automation — the children cannot be addressed individually. Fix the app's accessibility (mark the rows, not the container); until then use screenshot as visual truth and coordinate taps.`})}function Ni(e){let t=e.annotations.analysis;if(e.snapshot.backend!==`android`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length>0||!t||(t.rawNodeCount??0)<12)return[];let n=[`Interactive snapshot is empty after filtering ${t.rawNodeCount} raw Android nodes. Likely causes: the app content is not accessibility-visible yet, a transient route change, or depth/filter options hid the target.`];return typeof e.options.depth==`number`&&typeof t.maxDepth==`number`&&t.maxDepth>=e.options.depth+2&&n.push(`Interactive output is empty at depth ${e.options.depth}; retry without -d.`),n}function Pi(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&Fi(t,e.snapshot)&&Ii(t,e.capturedAt,e.runtimeNow)&&zi(t.nodes.length,e.snapshot.nodes.length))return Li}function Fi(e,t){return e.presentationKey===void 0||t.presentationKey===void 0?!0:e.presentationKey===t.presentationKey}function Ii(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const Li=`Recent snapshots dropped sharply in node count, which suggests stale or mid-transition UI. Use screenshot as visual truth, wait briefly, then re-snapshot once.`;function Ri(e,t){return!e?.staleAfterRetries||t!==`android`?[]:e.reason===`stuck-route`?[`Recent ${e.action} was followed by a nearly identical snapshot after ${e.retryCount} automatic retr${e.retryCount===1?`y`:`ies`}. If you expected navigation or submit, the tree may still be stale. Use screenshot as visual truth, wait briefly, then re-snapshot once.`]:e.reason===`sharp-drop`?[Li]:[]}function zi(e,t){return e<12?!1:t<=Math.floor(e*.2)}const Bi={screenshot:mi,diffScreenshot:ti,snapshot:Ci,diffSnapshot:wi};function Vi(e){return{screenshot:t=>Bi.screenshot(e,t),diffScreenshot:t=>Bi.diffScreenshot(e,t),snapshot:t=>Bi.snapshot(e,t),diffSnapshot:t=>Bi.diffSnapshot(e,t)}}const Hi=async(e,t)=>await Ki(e,t,`press`),Ui=async(e,t)=>await Ki(e,t,`click`),Wi=async(e,n)=>{if(!n.text)throw new t(`INVALID_ARGS`,`fill requires text`);let r=De(n),i=r.needsPreActionBaseline?null:await Yi(e,n);if(i)return i;let a=await se(e,n,{action:`fill`,requireInteractive:!0,promoteToHittableAncestor:!1,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!e.backend.fill)throw new t(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=qi(a),s=S(await e.backend.fill(y(e,n),o,n.text,{delayMs:n.delayMs})),c=`node`in a?a.node?.type??``:``,l=c&&!Fe(c,e.backend.platform)?`fill target ${Zi(a)} resolved to "${c}", attempting fill anyway.`:void 0;return await pe(e,n,a,{...a,text:n.text,...l?{warning:l}:{},...s?{backendResult:s}:{}},r)},Gi=async(e,n)=>{let r=n.text;if(!r)throw new t(`INVALID_ARGS`,`type requires text`);let i=Qi(r);if(i)throw new t(`INVALID_ARGS`,`type does not accept a target ref like "${i}"`,{hint:`Use fill ${i} "text" to target that field, or press ${i} then type "text" to append.`});if(!e.backend.typeText)throw new t(`UNSUPPORTED_OPERATION`,`type is not supported by this backend`);let a=v(n.delayMs??0,`delay-ms`,0,1e4),o=S(await e.backend.typeText(y(e,n),r,{delayMs:a}));return{kind:`text`,text:r,delayMs:a,...o?{backendResult:o}:{},...x(`Typed ${Array.from(r).length} chars`)}};async function Ki(e,n,r){let i=De(n),a=i.needsPreActionBaseline?null:await Ji(e,n,r);if(a)return a;let o=await se(e,n,{action:r,requireInteractive:!0,promoteToHittableAncestor:!0,captureEvidenceBaseline:i.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!e.backend.tap)throw new t(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let s=qi(o),c=S(await e.backend.tap(y(e,n),s,{button:n.button,count:n.count,intervalMs:n.intervalMs,holdMs:n.holdMs,jitterPx:n.jitterPx,doubleTap:n.doubleTap}));return await pe(e,n,o,{...o,...c?{backendResult:c}:{}},i)}function qi(e){if(!e.point)throw new t(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}async function Ji(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||Xi(t)||t.expectedResolvedTarget)return null;let r=await ye(e,t,t.target,n),i=S(await e.backend.tapTarget(y(e,t),{kind:`ref`,ref:t.target.ref,...t.target.fallbackLabel?{fallbackLabel:t.target.fallbackLabel}:{}}));return{kind:`ref`,target:{kind:`ref`,ref:t.target.ref},resolution:te,...r,...i?{backendResult:i}:{}}}async function Yi(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let n=await ye(e,t,t.target,`fill`),r=S(await e.backend.fillTarget(y(e,t),{kind:`ref`,ref:t.target.ref,...t.target.fallbackLabel?{fallbackLabel:t.target.fallbackLabel}:{}},t.text,{delayMs:t.delayMs}));return{kind:`ref`,target:{kind:`ref`,ref:t.target.ref},text:t.text,resolution:te,...n,...r?{backendResult:r}:{}}}function Xi(e){return e.count!==void 0||e.intervalMs!==void 0||e.holdMs!==void 0||e.jitterPx!==void 0||e.doubleTap!==void 0||e.button!==void 0&&e.button!==`primary`}function Zi(e){return e.target?.kind===`ref`?e.target.ref:e.target?.kind===`selector`?e.target.selector:`point`}function Qi(e){return Jt(e)}function $i(e){return{includeRects:ea(e.predicate),interactiveOnly:!1}}function ea(e){return e===`visible`||e===`hidden`}const ta=1e4,na=async(e,n)=>{let r=n.locator??`any`;if(!n.query)throw new t(`INVALID_ARGS`,`find requires a value`);if(n.action===`wait`)return await da(e,n,r);let{capture:i,match:a}=await fa(e,n,r);if(!a)throw new t(`COMMAND_FAILED`,`find did not match any element`);if(n.action===`exists`)return{kind:`found`,found:!0};let o=`@${a.ref}`;return n.action===`get_attrs`?{kind:`attrs`,ref:o,node:a}:{kind:`text`,ref:o,text:await fe(e,i,a),node:a}},ra=async(e,t)=>{if(t.target.kind===`ref`){let n=await me(e,t.session),r=oe(n.snapshot.nodes,t.target.ref,{fallbackLabel:t.target.fallbackLabel??``,invalidRefMessage:`get text requires a ref like @e2`,notFoundMessage:`Ref ${t.target.ref} not found`});ve(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=Ue(r.node,e.backend.platform,{action:`get`,nodes:n.snapshot.nodes}),a={kind:`ref`,ref:`@${r.ref}`},o=n.snapshot.nodes;return t.property===`attrs`?{kind:`attrs`,target:a,node:r.node,selectorChain:i,preActionNodes:o}:{kind:`text`,target:a,text:await fe(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await ya(e,t,t.session??`default`,{selector:t.target.selector,disambiguateAmbiguous:t.property===`text`});ve(n.node,n.capture.snapshot.nodes,t.expectedResolvedTarget,`get`);let r=Ue(n.node,e.backend.platform,{action:`get`,nodes:n.capture.snapshot.nodes});if(t.property===`attrs`)return{kind:`attrs`,target:{kind:`selector`,selector:n.selector},node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes};let i=await fe(e,n.capture,n.node);return{kind:`text`,target:{kind:`selector`,selector:n.selector},text:i,node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes}},ia=async(e,n)=>{let r=await ra(e,{...n,property:`text`,target:n.target});if(r.kind!==`text`)throw new t(`COMMAND_FAILED`,`getText returned non-text result`);return r},aa=async(e,n)=>{let r=await ra(e,{...n,property:`attrs`,target:n.target});if(r.kind!==`attrs`)throw new t(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return r},oa=async(e,n)=>{if(!Ge(n.predicate))throw new t(`INVALID_ARGS`,We);if(n.predicate===`text`&&!n.expectedText)throw new t(`INVALID_ARGS`,`is text requires expected text value`);let r=m(n.selector),i=await g(e,n,{updateSession:!0,...$i({predicate:n.predicate,selectorChain:r})});if(n.predicate===`exists`){let a=ze(i.snapshot.nodes,r,{platform:e.backend.platform});if(!a)throw new t(`COMMAND_FAILED`,Be(r,[],{unique:!1}),{hint:Ve([])});return{predicate:n.predicate,pass:!0,selector:a.selector.raw,matches:a.matches,selectorChain:r.selectors.map(e=>e.raw)}}let a=He(i.snapshot.nodes,r,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:!1});if(!a)throw new t(`COMMAND_FAILED`,Be(r,[],{unique:!0}),{command:`is`,reason:`selector_not_found`,predicate:n.predicate,selector:r.raw,hint:Ve([])});let o=Re({predicate:n.predicate,node:a.node,nodes:i.snapshot.nodes,expectedText:n.expectedText,platform:e.backend.platform});if(!o.pass)throw new t(`COMMAND_FAILED`,`is ${n.predicate} failed for selector ${a.selector.raw}: ${o.details}`,{command:`is`,reason:`predicate_failed`,predicate:n.predicate,selector:a.selector.raw,predicateDetails:o.details});return{predicate:n.predicate,pass:!0,selector:a.selector.raw,...n.predicate===`text`?{text:o.actualText}:{},selectorChain:r.selectors.map(e=>e.raw)}},sa=async(e,t)=>await oa(e,{...t,predicate:`visible`,selector:t.target.selector}),ca=async(e,t)=>await oa(e,{...t,predicate:`hidden`,selector:t.target.selector}),la=async(e,r)=>{if(r.target.kind===`sleep`)return await ke(e,r.target.durationMs),{kind:`sleep`,waitedMs:r.target.durationMs};if(r.target.kind===`ref`){let i=await me(e,r.session),o=a(r.target.ref);if(!o)throw new t(`INVALID_ARGS`,`Invalid ref: ${r.target.ref}`);let s=n(i.snapshot.nodes,o),c=s?Ie(s,i.snapshot.nodes):void 0;if(!c)throw new t(`COMMAND_FAILED`,`Ref ${r.target.ref} not found or has no label`);return await ga(e,r,c,r.target.timeoutMs)}if(r.target.kind===`selector`)return await ha(e,r,r.target.selector,r.target.timeoutMs);if(r.target.kind===`stable`)return await va(e,r,r.target.quietMs,r.target.timeoutMs);if(!r.target.text)throw new t(`INVALID_ARGS`,`wait requires text`);return await ga(e,r,r.target.text,r.target.timeoutMs)},ua=async(e,n)=>{let r=await la(e,{...n,target:{kind:`text`,text:n.text,timeoutMs:n.timeoutMs}});if(r.kind!==`text`)throw new t(`COMMAND_FAILED`,`waitForText returned non-text result`);return r};async function da(e,n,r){let i=n.timeoutMs??ta,a=b(e);for(;b(e)-a<i;){let{match:t}=await fa(e,n,r,{includeHiddenContentHints:!1});if(t)return{kind:`found`,found:!0,waitedMs:b(e)-a};await ke(e,300)}throw new t(`COMMAND_FAILED`,`find wait timed out`)}async function fa(e,t,n,r){let i=p(n,t.query),a=await g(e,t,{updateSession:!0,scope:pa(e,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...$i({selectorChain:i})});if(qe(a.snapshot.snapshotQuality))throw ma(a.snapshot.snapshotQuality);return i?{capture:a,match:He(a.snapshot.nodes,i,{platform:e.backend.platform,requireRect:!1,requireUnique:!1})?.node}:{capture:a,match:f(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}function pa(e,t,n,r){if(!r&&e.backend.platform!==`web`)return ue(t)?n:void 0}function ma(e){return new t(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth, navigate with coordinates if needed, then retry find after reaching a readable screen.`})}async function ha(e,n,r,i){let a=i??ta,o=b(e),s=m(r),c=$i({selectorChain:s});for(;b(e)-o<a;){let t=ze((await g(e,n,{updateSession:!0,includeHiddenContentHints:!1,...c})).snapshot.nodes,s,{platform:e.backend.platform});if(t)return{kind:`selector`,selector:t.selector.raw,waitedMs:b(e)-o};await ke(e,300)}throw new t(`COMMAND_FAILED`,`wait timed out for selector: ${r}`)}async function ga(e,n,r,i){let a=i??ta,o=b(e);for(;b(e)-o<a;){if(e.backend.findText?(await e.backend.findText(y(e,n),r)).found:await _a(e,n,r))return{kind:`text`,text:r,waitedMs:b(e)-o};await ke(e,300)}throw new t(`COMMAND_FAILED`,`wait timed out for text: ${r}`)}async function _a(e,t,n){return!!Me((await g(e,t,{updateSession:!0,includeHiddenContentHints:!1})).snapshot.nodes,n)}async function va(e,n,r,i){let a=i??ta,o=r??500,s=await Ee(e,n,{quietMs:o,timeoutMs:a});if(!s.settled)throw new t(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:`wait_stable_timeout`,...s.stalled?{captureStalled:!0}:{},quietMs:o,timeoutMs:a,captures:s.captures,nodeCount:s.nodeCount,...s.stalled?{hint:`A snapshot capture stalled past the wait timeout, so no settle verdict is available. The UI may still be readable: retry, or use screenshot to inspect the surface.`}:{}});return{kind:`stable`,waitedMs:s.waitedMs,captures:s.captures,nodeCount:s.nodeCount,...s.nodeCount<5?{hint:ee}:{}}}async function ya(e,n,r,i){let a=m(i.selector),o=await g(e,{...n,session:r},{updateSession:!0,...$i({selectorChain:a})}),s=He(o.snapshot.nodes,a,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:i.disambiguateAmbiguous});if(!s)throw new t(`COMMAND_FAILED`,Be(a,[],{unique:!0}),{hint:Ve([])});return{capture:o,node:s.node,selector:s.selector.raw,ref:`@${s.node.ref}`}}const R={pinchAxisDegrees:-90,frameCount:Math.floor},ba={ios:R,macos:R,android:{pinchAxisDegrees:0,frameCount:Math.round},linux:R,web:R};function xa(e,t,n){let r=Na(t),i=Ha(n);switch(e.intent){case`fling`:return Ca(e,r,i);case`pan`:return wa(e,r,i);case`pinch`:return Ea({intent:`pinch`,origin:e.origin??Ra(r),delta:{x:0,y:0},scale:Ia(e.scale,`gesture pinch scale`),rotationDegrees:0,durationMs:300},r,i);case`rotate`:{let t=B(e.degrees,`gesture rotate degrees`);return Ea({intent:`rotate`,origin:e.origin??Ra(r),delta:{x:0,y:0},scale:1,rotationDegrees:t,durationMs:Fa(t)},r,i)}case`transform`:{let t=B(e.degrees,`gesture transform degrees`);return Ea({intent:`transform`,origin:e.origin,delta:e.delta,scale:Ia(e.scale,`gesture transform scale`),rotationDegrees:t,durationMs:Pa(e.durationMs,Fa(t),`gesture transform durationMs`)},r,i)}}}function Sa(e){let n=e.pointers[0].samples[0]?.point,r=e.pointers[0].samples.at(-1)?.point;if(!n||!r)throw new t(`INVALID_ARGS`,`single-pointer gesture plan requires samples`);return{start:n,end:r}}function Ca(e,t,n){if(`preset`in e){let{from:r,to:i}=Va(e.preset,t);return Ta(`fling`,r,i,100,t,`endpoint-hold`,n)}if(`from`in e)return Ta(`fling`,e.from,e.to,100,t,`endpoint-hold`,n);let r=z(e.origin,`gesture fling origin`),i=La(e.distance??180,`gesture fling distance`);return Ta(`fling`,r,za(r,Ae(e.direction,i)),100,t,`endpoint-hold`,n)}function wa(e,n,r){let i=Pa(e.durationMs,500,`gesture pan durationMs`);if((e.pointerCount??1)===1){let t=z(e.origin,`gesture pan origin`);return Ta(`pan`,t,za(t,z(e.delta,`gesture pan delta`)),i,n,e.executionProfile??`timed-pan`,r)}if(e.pointerCount!==2)throw new t(`INVALID_ARGS`,`gesture pan pointerCount must be 1 or 2`);return Ea({intent:`pan`,origin:e.origin,delta:e.delta,scale:1,rotationDegrees:0,durationMs:i},n,r)}function Ta(e,t,n,r,i,a,o){let s=z(t,`gesture ${e} start`),c=z(n,`gesture ${e} end`),l=Aa(r,o).map(e=>({offsetMs:e,point:Ba(s,c,e/r)}));return ja(l,i,{intent:e,pointerId:0}),{topology:`single`,intent:e,executionProfile:a,durationMs:r,viewport:i,pointers:[{pointerId:0,samples:l}]}}function Ea(e,t,n){let r=z(e.origin,`gesture ${e.intent} origin`),i=za(r,z(e.delta,`gesture ${e.intent} delta`)),a=Math.min(t.width,t.height)*ka(e.intent),o=e.scale>1?a/e.scale:a,s=o*e.scale;if(Math.min(o,s)<48)throw Ma({intent:e.intent,viewport:t,initialSpan:o,finalSpan:s,minimumReliableSpan:48});let c=o/2,l=Aa(e.durationMs,n),u=(a,o)=>{let s=l.map(t=>({offsetMs:t,point:Da({...e,start:r,end:i,initialRadius:c,offsetMs:t,side:o,profile:n})}));return ja(s,t,{intent:e.intent,pointerId:a}),{pointerId:a,samples:s}};return{topology:`two`,intent:e.intent,durationMs:e.durationMs,viewport:t,pointers:[u(0,1),u(1,-1)]}}function Da(e){let t=e.offsetMs/e.durationMs,n=Ba(e.start,e.end,t),r=e.initialRadius*(1+(e.scale-1)*t),i=Ua(Oa(e.intent,e.profile)+e.rotationDegrees*t);return{x:n.x+Math.cos(i)*r*e.side,y:n.y+Math.sin(i)*r*e.side}}function Oa(e,t){return e===`pinch`?t.pinchAxisDegrees:-90}function ka(e){return e===`pinch`?.4:.25}function Aa(e,t){let n=e/16,r=Math.max(3,t.frameCount(n));return Array.from({length:r+1},(t,n)=>Math.round(e*n/r))}function ja(e,n,r){let i=n.x+n.width-1,a=n.y+n.height-1;for(let o of e){let{x:e,y:s}=o.point;if(!Number.isFinite(e)||!Number.isFinite(s))throw new t(`INVALID_ARGS`,`Gesture motion produces non-finite pointer coordinates`,{...r,reason:`GESTURE_TRAJECTORY_NON_FINITE`,hint:`Reduce the requested rotation, translation, or scale.`});if(e<n.x+1||e>i||s<n.y+1||s>a)throw Ma({...r,viewport:n,sample:o})}}function Ma(e){return new t(`INVALID_ARGS`,`Gesture trajectory does not fit inside the viewport`,{...e,reason:`GESTURE_TRAJECTORY_OUT_OF_BOUNDS`,hint:`Move the gesture away from the edge or reduce its translation, scale, or rotation.`})}function Na(e){let n={x:B(e.x,`gesture viewport x`),y:B(e.y,`gesture viewport y`),width:B(e.width,`gesture viewport width`),height:B(e.height,`gesture viewport height`)};if(n.width<=0||n.height<=0)throw new t(`INVALID_ARGS`,`gesture viewport width and height must be positive`);return n}function Pa(e,n,r){let i=e??n;if(!Number.isInteger(i)||i<16||i>1e4)throw new t(`INVALID_ARGS`,`${r} must be an integer between 16 and ${re}`);return i}function Fa(e){let t=Math.ceil(Math.abs(e)/3)*16;return Math.min(Math.max(300,t),2400)}function z(e,t){return{x:B(e.x,`${t} x`),y:B(e.y,`${t} y`)}}function B(e,n){if(!Number.isFinite(e))throw new t(`INVALID_ARGS`,`${n} must be a finite number`);return e}function Ia(e,n){let r=B(e,n);if(r<=0)throw new t(`INVALID_ARGS`,`${n} must be greater than 0`);return r}function La(e,n){let r=B(e,n);if(r<=0)throw new t(`INVALID_ARGS`,`${n} must be a positive number`);return r}function Ra(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function za(e,t){return{x:e.x+t.x,y:e.y+t.y}}function Ba(e,t,n){return{x:e.x+(t.x-e.x)*n,y:e.y+(t.y-e.y)*n}}function Va(e,t){let n=Ce(e,{referenceWidth:t.width,referenceHeight:t.height});return{from:{x:t.x+n.x1,y:t.y+n.y1},to:{x:t.x+n.x2,y:t.y+n.y2}}}function Ha(e){return e===void 0?R:ba[e]}function Ua(e){return e*Math.PI/180}function Wa(e,n){let r=e.filter(t=>Ne(t,e)).map(e=>e.rect).filter(Ga),i=r.length>0?r:e.map(e=>e.rect).filter(Ga);if(i.length===0)throw new t(`COMMAND_FAILED`,`Cannot infer viewport for ${n}`);let a=Math.min(...i.map(e=>e.x)),o=Math.min(...i.map(e=>e.y)),s=Math.max(...i.map(e=>e.x+e.width)),c=Math.max(...i.map(e=>e.y+e.height));return{x:a,y:o,width:s-a,height:c-o}}function Ga(e){return!!(e&&e.width>0&&e.height>0)}const Ka=async(e,n)=>{if(!e.backend.performGesture)throw new t(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await ce(e,n,n.gesture.intent);let r=await qa(e,n),i=xa(n.gesture,r,e.backend.platform),a=S(await e.backend.performGesture(y(e,n),i)),o=Ja(i.pointers,0),s=Ja(i.pointers,-1);return{kind:i.intent,durationMs:i.durationMs,pointerCount:i.topology===`single`?1:2,from:o,to:s,...a?{backendResult:a}:{},...x(Ya(n.gesture,o,s))}};async function qa(e,t){return await e.backend.resolveGestureViewport?.(y(e,t))||Wa((await _e(e,t,!1)).snapshot.nodes,`gesture`)}function Ja(e,n){let r=e.map(e=>n===0?e.samples[0]?.point:e.samples.at(-1)?.point);if(r.some(e=>e===void 0))throw new t(`COMMAND_FAILED`,`Gesture plan did not contain endpoint samples.`);let i=r;return{x:i.reduce((e,t)=>e+t.x,0)/i.length,y:i.reduce((e,t)=>e+t.y,0)/i.length}}function Ya(e,t,n){switch(e.intent){case`pan`:{let r=`preset`in e?t:e.origin,i=`preset`in e?{x:n.x-t.x,y:n.y-t.y}:e.delta;return`Panned (${r.x}, ${r.y}) by (${i.x}, ${i.y})`}case`fling`:return`direction`in e?`Flung ${e.direction}`:`Flung`;case`pinch`:return`Pinched to scale ${e.scale}`;case`rotate`:return`Rotated gesture ${e.degrees} degrees`;case`transform`:return`Requested transform gesture by (${e.delta.x}, ${e.delta.y}), scale ${e.scale}, rotate ${e.degrees} degrees`}}const V={find:na,get:ra,getText:ia,getAttrs:aa,is:oa,isVisible:sa,isHidden:ca,wait:la,waitForText:ua},H={click:Ui,press:Hi,fill:Wi,typeText:Gi,focus:ge,longPress:ae,scroll:ie,gesture:Ka};function Xa(e){return{find:t=>V.find(e,t),get:t=>V.get(e,t),getText:(t,n={})=>V.getText(e,{...n,target:t}),getAttrs:(t,n={})=>V.getAttrs(e,{...n,target:t}),is:t=>V.is(e,t),isVisible:(t,n={})=>V.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>V.isHidden(e,{...n,target:t}),wait:t=>V.wait(e,t),waitForText:(t,n={})=>V.waitForText(e,{...n,text:t})}}function Za(e){return{click:(t,n={})=>H.click(e,{...n,target:t}),press:(t,n={})=>H.press(e,{...n,target:t}),fill:(t,n,r={})=>H.fill(e,{...r,target:t,text:n}),typeText:(t,n={})=>H.typeText(e,{...n,text:t}),focus:(t,n={})=>H.focus(e,{...n,target:t}),longPress:(t,n={})=>H.longPress(e,{...n,target:t}),scroll:t=>H.scroll(e,t),gesture:t=>H.gesture(e,t)}}function U(e,t){if(e!==void 0)return W(e,t)}function W(e,n){let r=e?.trim();if(!r)throw new t(`INVALID_ARGS`,`${n} must be a non-empty string`);return r}const Qa=async(e,n={})=>{if(!e.backend.listDevices)throw new t(`UNSUPPORTED_OPERATION`,`admin.devices is not supported by this backend`);return{kind:`adminDevices`,devices:await e.backend.listDevices(y(e,n),n.filter)}},$a=async(e,n={})=>{if(!e.backend.bootDevice)throw new t(`UNSUPPORTED_OPERATION`,`admin.boot is not supported by this backend`);let r=lo(n.target),i=S(await e.backend.bootDevice(y(e,n),r));return{kind:`deviceBooted`,...r?{target:r}:{},...i?{backendResult:i}:{},...x(`Booted device`)}},eo=async(e,n={})=>{if(!e.backend.shutdownDevice)throw new t(`UNSUPPORTED_OPERATION`,`admin.shutdown is not supported by this backend`);let r=lo(n.target),i=S(await e.backend.shutdownDevice(y(e,n),r));return{kind:`deviceShutdown`,...r?{target:r}:{},...i?{backendResult:i}:{},...x(`Shutdown device`)}},to=async(e,t)=>await io(e,t,`install`),no=async(e,t)=>await io(e,t,`reinstall`),ro=async(e,t)=>await io(e,t,`installFromSource`);async function io(e,n,r){let i=r===`reinstall`?`reinstallApp`:`installApp`,a=e.backend[i];if(!a)throw new t(`UNSUPPORTED_OPERATION`,`admin.${r} is not supported by this backend`);let o=`app`in n&&n.app!==void 0?W(n.app,`app`):void 0;if(r!==`installFromSource`&&!o)throw new t(`INVALID_ARGS`,`admin.${r} requires app`);let s=y(e,n),c=await ao(e,s,n.source);try{let t=await a.call(e.backend,s,{...o?{app:o}:{},source:c.source});return uo(r,o,c.source,t)}finally{await c.cleanup?.()}}async function ao(e,t,n){let r=await oo(e,so(n));try{return{source:so(e.backend.resolveInstallSource?await e.backend.resolveInstallSource(t,r.source):r.source),...r.cleanup?{cleanup:r.cleanup}:{}}}catch(e){if(r.cleanup)try{await r.cleanup()}catch{}throw e}}async function oo(e,t){if(t.kind===`url`)return{source:t};let n=await F(e,t,{usage:`admin.install`,field:`source`});return{source:{kind:`path`,path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function so(e){if(!e||typeof e!=`object`)throw new t(`INVALID_ARGS`,`install source is required`);if(e.kind===`path`)return{kind:`path`,path:W(e.path,`source.path`)};if(e.kind===`uploadedArtifact`)return{kind:`uploadedArtifact`,id:W(e.id,`source.id`)};if(e.kind===`url`){let t=W(e.url,`source.url`);return co(t),{kind:`url`,url:t}}throw new t(`INVALID_ARGS`,`install source kind must be path, uploadedArtifact, or url`)}function co(e){let n;try{n=new URL(e)}catch{throw new t(`INVALID_ARGS`,`Invalid install source URL: ${e}`)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new t(`INVALID_ARGS`,`Install source URL must use http or https`)}function lo(e){if(!e)return;let t=U(e.id,`target.id`),n=U(e.name,`target.name`),r={...t?{id:t}:{},...n?{name:n}:{},...e.platform?{platform:e.platform}:{},...e.target?{target:e.target}:{},...e.headless===void 0?{}:{headless:e.headless}};return Object.keys(r).length>0?r:void 0}function uo(e,t,n,r){let i=S(r),a=e===`reinstall`?`appReinstalled`:e===`installFromSource`?`appInstalledFromSource`:`appInstalled`,o=G(r,`appName`),s=G(r,`appId`),c=G(r,`bundleId`),l=G(r,`packageName`),u=G(r,`launchTarget`),d=G(r,`installablePath`),f=G(r,`archivePath`);return{kind:a,...t?{app:t}:{},source:n,...s?{appId:s}:{},...o?{appName:o}:{},...c?{bundleId:c}:{},...l?{packageName:l}:{},...u?{launchTarget:u}:{},...d?{installablePath:d}:{},...f?{archivePath:f}:{},...i?{backendResult:i}:{},...x(`${e===`reinstall`?`Reinstalled`:`Installed`}: ${o??u??t??fo(n)}`)}}function G(e,t){let n=e[t];return typeof n==`string`&&n.length>0?n:void 0}function fo(e){return e.kind===`path`?e.path:e.kind===`uploadedArtifact`?e.id:e.url}const po=/^[A-Za-z0-9_.:-]{1,64}$/,mo=async(e,n)=>{if(!e.backend.openApp)throw new t(`UNSUPPORTED_OPERATION`,`apps.open is not supported by this backend`);let r=bo(n),i=S(await e.backend.openApp(K(e,n),r,{launchArgs:n.launchArgs,relaunch:n.relaunch}));return{kind:`appOpened`,target:r,relaunch:n.relaunch===!0,...i?{backendResult:i}:{},...x(`Opened: ${So(r)}`)}},ho=async(e,n={})=>{if(!e.backend.closeApp)throw new t(`UNSUPPORTED_OPERATION`,`apps.close is not supported by this backend`);let r=U(n.app,`app`),i=S(await e.backend.closeApp(K(e,n),r));return{kind:`appClosed`,...r?{app:r}:{},...i?{backendResult:i}:{},...x(r?`Closed: ${r}`:`Closed app`)}},go=async(e,n={})=>{if(!e.backend.listApps)throw new t(`UNSUPPORTED_OPERATION`,`apps.list is not supported by this backend`);return{kind:`appsList`,apps:await e.backend.listApps(K(e,n),Je(n.filter))}},_o=async(e,n)=>{if(!e.backend.getAppState)throw new t(`UNSUPPORTED_OPERATION`,`apps.state is not supported by this backend`);let r=W(n.app,`app`);return{kind:`appState`,app:r,state:await e.backend.getAppState(K(e,n),r)}},vo=async(e,n)=>{if(!e.backend.pushFile)throw new t(`UNSUPPORTED_OPERATION`,`apps.push is not supported by this backend`);let r=W(n.app,`app`),i=await Co(e,n.input);try{let t=S(await e.backend.pushFile(K(e,n),i.backendInput,r));return{kind:`appPushed`,app:r,inputKind:i.inputKind,...t?{backendResult:t}:{},...x(`Pushed to ${r}`)}}finally{await i.cleanup?.()}},yo=async(e,n)=>{if(!e.backend.triggerAppEvent)throw new t(`UNSUPPORTED_OPERATION`,`apps.triggerEvent is not supported by this backend`);let r=wo(n.name);To(n.payload,`apps.triggerEvent payload for "${r}"`);let i=S(await e.backend.triggerAppEvent(K(e,n),{name:r,...n.payload?{payload:n.payload}:{}}));return{kind:`appEventTriggered`,name:r,...n.payload?{payload:n.payload}:{},...i?{backendResult:i}:{},...x(`Triggered app event: ${r}`)}};function bo(e){let n=U(e.app,`app`),r=U(e.appId,`appId`),i=U(e.bundleId,`bundleId`),a=U(e.packageName,`packageName`),o=U(e.url,`url`),s=U(e.activity,`activity`),c={...n?{app:n}:{},...r?{appId:r}:{},...i?{bundleId:i}:{},...a?{packageName:a}:{},...o?{url:o}:{},...s?{activity:s}:{}};if(!xo(c))throw new t(`INVALID_ARGS`,`apps.open requires app, appId, bundleId, packageName, url, or activity`);return c}function xo(e){return!!(e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity)}function So(e){return e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity??`app`}async function Co(e,n){if(!n||typeof n!=`object`)throw new t(`INVALID_ARGS`,`apps.push requires an input`);if(n.kind===`json`)return Eo(n.payload,`apps.push JSON payload`,8192),{backendInput:{kind:`json`,payload:n.payload},inputKind:`json`};let r=await F(e,n,{usage:`apps.push`,field:`input`});return{backendInput:{kind:`file`,path:r.path},inputKind:`file`,...r.cleanup?{cleanup:r.cleanup}:{}}}function wo(e){let n=W(e,`name`);if(!po.test(n))throw new t(`INVALID_ARGS`,`Invalid apps.triggerEvent name: ${n}`,{hint:`Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash.`});return n}function To(e,t){e!==void 0&&Eo(e,t,8192)}function Eo(e,n,r){if(Do(e,n),Buffer.byteLength(Oo(e,n),`utf8`)>r)throw new t(`INVALID_ARGS`,`${n} exceeds ${r} bytes`)}function Do(e,n){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`INVALID_ARGS`,`${n} must be a JSON object`)}function Oo(e,n){try{let r=JSON.stringify(e);if(typeof r!=`string`)throw new t(`INVALID_ARGS`,`${n} must be JSON-serializable`);return r}catch{throw new t(`INVALID_ARGS`,`${n} must be JSON-serializable`)}}function K(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}const q={open:mo,close:ho,list:go,state:_o,push:vo,triggerEvent:yo},J={devices:Qa,boot:$a,shutdown:eo,install:to,reinstall:no,installFromSource:ro};function ko(e){return{open:t=>q.open(e,t),close:t=>q.close(e,t),list:(t={})=>q.list(e,{...t,filter:Ye(t.filter)}),state:t=>q.state(e,t),push:t=>q.push(e,t),triggerEvent:t=>q.triggerEvent(e,t)}}function Ao(e){return{devices:t=>J.devices(e,t),boot:t=>J.boot(e,t),shutdown:t=>J.shutdown(e,t),install:t=>J.install(e,t),reinstall:t=>J.reinstall(e,t),installFromSource:t=>J.installFromSource(e,t)}}const jo=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,Mo=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function No(e){let t=!1,n=e;return n=n.replaceAll(/(authorization|token|secret|password|passwd|api[-_]?key)=([^&\s]+)/gi,(e,n)=>(t=!0,`${String(n)}=[REDACTED]`)),n=n.replaceAll(/("(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)"\s*:\s*")([^"]*)(")/gi,(e,n,r,i)=>(t=!0,`${String(n)}[REDACTED]${String(i)}`)),n=n.replaceAll(/\b(Bearer\s+)([^\s",;]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`)),n=n.replaceAll(/((?:authorization|cookie|token|secret|password|passwd|api[-_]?key)\s*[:=]\s*)([^\s,;&]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`)),n=n.replaceAll(Mo,()=>(t=!0,`[REDACTED]`)),n=Fo(n,()=>{t=!0}),{value:n,redacted:t}}function Po(e){try{let t=new URL(e),n=Io(t);return(t.username||t.password)&&(t.username=`REDACTED`,t.password=`REDACTED`,n=!0),{value:t.toString(),redacted:n}}catch{return}}function Fo(e,t){return/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(e)?e.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let n=Po(e);return n?(n.redacted&&t(),n.value):e}):e}function Io(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))jo.test(n)&&(e.searchParams.set(n,`[REDACTED]`),t=!0);return t}const Y=2048,Lo=4096,Ro=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function zo(e){let t=e.redacted===!0;return{kind:`diagnosticsLogs`,entries:e.entries.map(e=>{let n=Z(e.message,Lo),r=Ko(e.metadata);return t||=n.redacted||r.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.level?{level:e.level}:{},message:n.value??``,...e.source?{source:e.source}:{},...r.value?{metadata:r.value}:{}}}),...e.nextCursor?{nextCursor:e.nextCursor}:{},...e.timeWindow?{timeWindow:e.timeWindow}:{},...e.backend?{backend:e.backend}:{},redacted:t,...e.notes?{notes:e.notes}:{}}}function Bo(e,t){let n=e.redacted===!0;return{kind:`diagnosticsNetwork`,entries:e.entries.map(e=>{let r=e.url?Uo(e.url):void 0,i=t===`headers`||t===`all`?Ho(e.requestHeaders):void 0,a=t===`headers`||t===`all`?Ho(e.responseHeaders):void 0,o=t===`body`||t===`all`?Wo(e.requestBody):void 0,s=t===`body`||t===`all`?Wo(e.responseBody):void 0,c=Ko(e.metadata);return n||=(r?.redacted??!1)||(i?.redacted??!1)||(a?.redacted??!1)||(o?.redacted??!1)||(s?.redacted??!1)||c.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.method?{method:e.method}:{},...r?{url:r.value}:{},...e.status===void 0?{}:{status:e.status},...e.durationMs===void 0?{}:{durationMs:e.durationMs},...i?.value?{requestHeaders:i.value}:{},...a?.value?{responseHeaders:a.value}:{},...o?.value===void 0?{}:{requestBody:o.value},...s?.value===void 0?{}:{responseBody:s.value},...c.value?{metadata:c.value}:{}}}),...e.nextCursor?{nextCursor:e.nextCursor}:{},...e.timeWindow?{timeWindow:e.timeWindow}:{},...e.backend?{backend:e.backend}:{},redacted:n,...e.notes?{notes:e.notes}:{}}}function Vo(e){let t=e.redacted===!0;return{kind:`diagnosticsPerf`,metrics:e.metrics.map(e=>{let n=Z(e.message,Lo),r=Ko(e.metadata);return t||=n.redacted||r.redacted,{name:e.name,...e.value===void 0?{}:{value:e.value},...e.unit?{unit:e.unit}:{},...e.status?{status:e.status}:{},...n.value===void 0?{}:{message:n.value},...r.value?{metadata:r.value}:{}}}),...e.startedAt?{startedAt:e.startedAt}:{},...e.endedAt?{endedAt:e.endedAt}:{},...e.backend?{backend:e.backend}:{},redacted:t,...e.notes?{notes:e.notes}:{}}}function Ho(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[r,i]of Object.entries(e))if(Ro.test(r))n[r]=`[REDACTED]`,t=!0;else{let e=Z(i,Y);n[r]=e.value??``,t||=e.redacted}return{value:n,redacted:t}}function Uo(e){return Po(e)??Z(e,Y)}function Wo(e){return e===void 0?{redacted:!1}:Go(e)??Z(e,Y)}function Go(e){try{let t=X(JSON.parse(e),No);return qo(JSON.stringify(t.value),Y,t.redacted)}catch{return}}function Ko(e){return X(e,e=>Z(e,Y))}function X(e,t){if(e===void 0)return{redacted:!1};if(typeof e==`string`)return t(e);if(!e||typeof e!=`object`)return{value:e,redacted:!1};if(Array.isArray(e)){let n=!1;return{value:e.map(e=>{let r=X(e,t);return n||=r.redacted,r.value}),redacted:n}}let n=!1,r={};for(let[i,a]of Object.entries(e)){if(Ro.test(i)){r[i]=`[REDACTED]`,n=!0;continue}let e=X(a,t);r[i]=e.value,n||=e.redacted}return{value:r,redacted:n}}function Z(e,t){if(e===void 0)return{redacted:!1};let n=No(e);return qo(n.value,t,n.redacted)}function qo(e,t,n){if(e===void 0)return{redacted:n};let r=e;return r.length>t&&(r=`${r.slice(0,t)}...[truncated]`,n=!0),{value:r,redacted:n}}const Jo=async(e,n={})=>{if(!e.backend.readLogs)throw new t(`UNSUPPORTED_OPERATION`,`diagnostics.logs is not supported by this backend`);return zo(await e.backend.readLogs(await Zo(e,n),Qo(n)))},Yo=async(e,n={})=>{if(!e.backend.dumpNetwork)throw new t(`UNSUPPORTED_OPERATION`,`diagnostics.network is not supported by this backend`);let r=$o(n);return Bo(await e.backend.dumpNetwork(await Zo(e,n),r),r.include??`summary`)},Xo=async(e,n={})=>{if(!e.backend.measurePerf)throw new t(`UNSUPPORTED_OPERATION`,`diagnostics.perf is not supported by this backend`);return Vo(await e.backend.measurePerf(await Zo(e,n),es(n)))};async function Zo(e,t){let n=y(e,t),r=t.session?await e.sessions.get(t.session):void 0;return{...n,...t.appId??r?.appId?{appId:t.appId??r?.appId}:{},...t.appBundleId??r?.appBundleId?{appBundleId:t.appBundleId??r?.appBundleId}:{}}}function Qo(e){return{...ts(e,100,500,`logs limit`),...e.levels===void 0?{}:{levels:is(e.levels,`levels`)},...e.search===void 0?{}:{search:W(e.search,`search`)},...e.source===void 0?{}:{source:W(e.source,`source`)}}}function $o(e){return{...ts(e,25,200,`network limit`),include:rs(e.include)}}function es(e){return{...ns(e),...e.sampleMs===void 0?{}:{sampleMs:v(e.sampleMs,`sampleMs`,100,6e4)},...e.metrics===void 0?{}:{metrics:is(e.metrics,`metrics`,20)}}}function ts(e,t,n,r){return{...ns(e),...e.cursor===void 0?{}:{cursor:W(e.cursor,`cursor`)},limit:e.limit===void 0?t:v(e.limit,r,1,n)}}function ns(e){return{...e.since===void 0?{}:{since:W(e.since,`since`)},...e.until===void 0?{}:{until:W(e.until,`until`)}}}function rs(e){if(e===void 0)return`summary`;if(e===`summary`||e===`headers`||e===`body`||e===`all`)return e;throw new t(`INVALID_ARGS`,`network include must be summary, headers, body, or all`)}function is(e,n,r=50){if(!Array.isArray(e))throw new t(`INVALID_ARGS`,`${n} must be an array of strings`);if(e.length>r)throw new t(`INVALID_ARGS`,`${n} must contain at most ${r} entries`);return e.map((e,t)=>W(e,`${n}[${t}]`))}const as={logs:Jo,network:Yo,perf:Xo};function os(e){return{logs:t=>as.logs(e,t),network:t=>as.network(e,t),perf:t=>as.perf(e,t)}}const ss=async(e,n)=>{let r=ps(n.action,`record`),i=r===`start`?e.backend.startRecording:e.backend.stopRecording;if(!i)throw new t(`UNSUPPORTED_OPERATION`,`record ${r} is not supported by this backend`);let a=n.out?await I(e,n.out,{field:`path`,ext:`.mp4`,artifactType:`screen-recording`}):void 0;try{let t=ls(n,a?.path);return ms(r,await i.call(e.backend,y(e,n),t),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}},cs=async(e,n)=>{let r=ps(n.action,`trace`),i=r===`start`?e.backend.startTrace:e.backend.stopTrace;if(!i)throw new t(`UNSUPPORTED_OPERATION`,`trace ${r} is not supported by this backend`);let a=n.out?await I(e,n.out,{field:`outPath`,ext:`.trace`,artifactType:`trace-log`}):void 0;try{let t={...a?.path?{outPath:a.path}:{}};return hs(r,await i.call(e.backend,y(e,n),t),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}};function ls(e,t){let n={};t&&(n.outPath=t);let r=us(e.fps);r!==void 0&&(n.fps=r);let i=ds(e.maxSize);i!==void 0&&(n.maxSize=i);let a=fs(e.quality);return a!==void 0&&(n.quality=a),e.hideTouches!==void 0&&(n.showTouches=e.hideTouches!==!0),n}function us(e){return e===void 0?void 0:v(e,`fps`,1,60)}function ds(e){return e===void 0?void 0:v(e,`maxSize`,1,2**53-1)}function fs(e){if(e===void 0)return;let n=we(e);if(n===void 0)throw new t(`INVALID_ARGS`,`quality must be one of: medium, high (legacy numeric values 5-10 are accepted)`);return n}function ps(e,n){if(e===`start`||e===`stop`)return e;throw new t(`INVALID_ARGS`,`${n} action must be start or stop`)}function ms(e,t,n){return{...typeof t.path==`string`?{path:t.path}:{},...typeof t.telemetryPath==`string`?{telemetryPath:t.telemetryPath}:{},...typeof t.warning==`string`?{warning:t.warning}:{},...gs(e,t,n,{startKind:`recordingStarted`,stopKind:`recordingStopped`,startMessage:`Recording started`,stopMessage:`Recording stopped`})}}function hs(e,t,n){return{...typeof t.outPath==`string`?{outPath:t.outPath}:{},...gs(e,t,n,{startKind:`traceStarted`,stopKind:`traceStopped`,startMessage:`Trace started`,stopMessage:`Trace stopped`})}}function gs(e,t,n,r){return{kind:e===`start`?r.startKind:r.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...x(e===`start`?r.startMessage:r.stopMessage)}}const _s={record:ss,trace:cs};function vs(e){return{record:t=>_s.record(e,t),trace:t=>_s.trace(e,t)}}const ys=async(e,n={})=>{if(!e.backend.pressBack)throw new t(`UNSUPPORTED_OPERATION`,`system.back is not supported by this backend`);let r=n.mode??`in-app`;if(r!==`in-app`&&r!==`system`)throw new t(`INVALID_ARGS`,`system.back mode must be in-app or system`);let i=S(await e.backend.pressBack(y(e,n),{mode:r}));return{kind:`systemBack`,mode:r,...i?{backendResult:i}:{},...x(`Back`)}},bs=async(e,n={})=>{if(!e.backend.pressHome)throw new t(`UNSUPPORTED_OPERATION`,`system.home is not supported by this backend`);let r=S(await e.backend.pressHome(y(e,n)));return{kind:`systemHome`,...r?{backendResult:r}:{},...x(`Home`)}},xs=async(e,n)=>{if(!e.backend.pressTvRemote)throw new t(`UNSUPPORTED_OPERATION`,`system.tvRemote is not supported by this backend`);let r=Oe(n.button),i=n.durationMs===void 0?void 0:v(n.durationMs,`durationMs`,0,1e4),a=S(await e.backend.pressTvRemote(y(e,n),{button:r,...i===void 0?{}:{durationMs:i}}));return{kind:`tvRemotePressed`,button:r,...i===void 0?{}:{durationMs:i},...a?{backendResult:a}:{},...x(`Pressed TV remote ${r}`)}},Ss=async(e,n)=>{if(!e.backend.setOrientation)throw new t(`UNSUPPORTED_OPERATION`,`system.orientation is not supported by this backend`);let r=ks(n.orientation),i=S(await e.backend.setOrientation(y(e,n),r));return{kind:`systemOrientationSet`,orientation:r,...i?{backendResult:i}:{},...x(`Rotated to ${r}`)}},Cs=async(e,t)=>({...await Ss(e,t),kind:`systemRotated`}),ws=async(e,n={})=>{if(!e.backend.setKeyboard)throw new t(`UNSUPPORTED_OPERATION`,`system.keyboard is not supported by this backend`);let r=n.action??`status`;if(!qt(r))throw new t(`INVALID_ARGS`,`system.keyboard action must be status, get, dismiss, enter, or return`);let i=await e.backend.setKeyboard(y(e,n),{action:r}),a=S(i),o=Ls(i)?i:{};return r===`enter`||r===`return`?js(o,a):r===`dismiss`?Ms(r,o,a):Ns(r,o,a)},Ts=async(e,n)=>{if(n.action===`read`){if(!e.backend.getClipboard)throw new t(`UNSUPPORTED_OPERATION`,`system.clipboard read is not supported by this backend`);let r=await e.backend.getClipboard(y(e,n));return{kind:`clipboardText`,action:`read`,text:typeof r==`string`?r:r.text}}if(n.action!==`write`)throw new t(`INVALID_ARGS`,`system.clipboard action must be read or write`);if(!e.backend.setClipboard)throw new t(`UNSUPPORTED_OPERATION`,`system.clipboard write is not supported by this backend`);if(typeof n.text!=`string`)throw new t(`INVALID_ARGS`,`system.clipboard write requires text`);let r=S(await e.backend.setClipboard(y(e,n),n.text));return{kind:`clipboardUpdated`,action:`write`,textLength:Array.from(n.text).length,...r?{backendResult:r}:{},...x(`Clipboard updated`)}},Es=async(e,n={})=>{if(!e.backend.openSettings)throw new t(`UNSUPPORTED_OPERATION`,`system.settings is not supported by this backend`);let r=U(n.target,`target`),i=S(await e.backend.openSettings(y(e,n),r));return{kind:`settingsOpened`,...r?{target:r}:{},...i?{backendResult:i}:{},...x(r?`Opened settings: ${r}`:`Opened settings`)}},Ds=async(e,n={})=>{if(!e.backend.handleAlert)throw new t(`UNSUPPORTED_OPERATION`,`system.alert is not supported by this backend`);let r=n.action??`get`;if(r!==`get`&&r!==`accept`&&r!==`dismiss`&&r!==`wait`)throw new t(`INVALID_ARGS`,`system.alert action must be get, accept, dismiss, or wait`);let i=n.timeoutMs===void 0?void 0:v(n.timeoutMs,`timeoutMs`,0,12e4);return As(r,await e.backend.handleAlert(y(e,n),r,{timeoutMs:i}))},Os=async(e,n={})=>{if(!e.backend.openAppSwitcher)throw new t(`UNSUPPORTED_OPERATION`,`system.appSwitcher is not supported by this backend`);let r=S(await e.backend.openAppSwitcher(y(e,n)));return{kind:`appSwitcherOpened`,...r?{backendResult:r}:{},...x(`Opened app switcher`)}};function ks(e){switch(e){case`portrait`:case`portrait-upside-down`:case`landscape-left`:case`landscape-right`:return e;default:throw new t(`INVALID_ARGS`,`system.orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right`)}}function As(e,t){return e===`get`?Ps(t):e===`wait`?Fs(t):Is(e,t)}function js(e,t){return{kind:`keyboardEnterPressed`,action:`enter`,state:e,...t?{backendResult:t}:{},...x(`Keyboard enter pressed`)}}function Ms(e,t,n){return{kind:`keyboardDismissed`,action:e,state:t,...n?{backendResult:n}:{},...x(t.dismissed===!1?`Keyboard already hidden`:`Keyboard dismissed`)}}function Ns(e,t,n){return{kind:`keyboardState`,action:e,state:t,...n?{backendResult:n}:{}}}function Ps(e){if(e.kind!==`alertStatus`)throw new t(`COMMAND_FAILED`,`system.alert get returned an invalid backend result`);return{kind:`alertStatus`,action:`get`,alert:e.alert}}function Fs(e){if(e.kind!==`alertWait`)throw new t(`COMMAND_FAILED`,`system.alert wait returned an invalid backend result`);return{kind:`alertWait`,action:`wait`,alert:e.alert,...e.waitedMs===void 0?{}:{waitedMs:e.waitedMs},...e.timedOut===void 0?{}:{timedOut:e.timedOut},...x(e.alert?`Alert visible`:`Alert wait timed out`)}}function Is(e,n){if(n.kind!==`alertHandled`)throw new t(`COMMAND_FAILED`,`system.alert ${e} returned an invalid backend result`);return{kind:`alertHandled`,action:e,handled:n.handled,...n.alert?{alert:n.alert}:{},...n.button?{button:n.button}:{},...x(n.handled?`Alert ${e}ed`:`No alert handled`)}}function Ls(e){return!!(e&&typeof e==`object`)}const Q={back:ys,home:bs,orientation:Ss,rotate:Cs,keyboard:ws,clipboard:Ts,settings:Es,alert:Ds,appSwitcher:Os,tvRemote:xs};function Rs(e){return{back:t=>Q.back(e,t),home:t=>Q.home(e,t),orientation:t=>Q.orientation(e,t),rotate:t=>Q.rotate(e,t),keyboard:t=>Q.keyboard(e,t),clipboard:t=>Q.clipboard(e,t),settings:t=>Q.settings(e,t),alert:t=>Q.alert(e,t),appSwitcher:t=>Q.appSwitcher(e,t),tvRemote:t=>Q.tvRemote(e,t)}}function zs(e){return{capture:Vi(e),selectors:Xa(e),interactions:Za(e),system:Rs(e),apps:ko(e),admin:Ao(e),recording:vs(e),observability:os(e)}}var Bs=e({createAgentDevice:()=>Vs,createMemorySessionStore:()=>Hs,localCommandPolicy:()=>Ws,restrictedCommandPolicy:()=>Gs});function Vs(e){let t={backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??Hs(),policy:e.policy??Gs(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal};return{...t,...zs(t)}}function Hs(e=[]){let t=new Map(e.map(e=>[e.name,$(e)]));return{get:e=>$(t.get(e)),set:e=>{t.set(e.name,$(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>$(e))}}function $(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:Us(e.metadata)}:{}}}function Us(e){try{return structuredClone(e)}catch{return{...e}}}function Ws(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,allowNamedBackendCapabilities:[],...e}}function Gs(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,allowNamedBackendCapabilities:[],...e}}export{dt as _,Sa as a,dn as c,cn as d,ln as f,ut as g,lt as h,xa as i,k as l,qt as m,Ws as n,_i as o,Jt as p,Bs as r,fi as s,Vs as t,un as u,Ct as v,Et as y};
+import{t as e}from"./rolldown-runtime.js";import{_ as t,d as n,g as r,l as i,p as a,u as o,v as s,w as c}from"./sdk-contracts.js";import{j as l,v as u,w as d}from"./sdk-android-adb.js";import{Q as f,U as p,V as m,q as h}from"./sdk-batch-runner.js";import{$ as g,A as _,C as ee,D as te,F as v,G as ne,H as re,I as ie,J as ae,K as y,L as oe,M as se,N as ce,O as le,P as ue,Q as b,Qn as x,R as de,S as fe,Sn as pe,T as me,U as he,W as ge,X as S,Y as C,Z as w,b as _e,j as ve,k as ye,q as be,r as xe,rt as T,w as Se,x as Ce,xt as we,y as Te,yt as Ee,z as De}from"./recording-export-quality.js";import{L as Oe}from"./snapshot-diagnostics.js";import{C as ke,E as Ae,F as je,K as Me,L as Ne,T as Pe,U as Fe,V as Ie,f as Le,ft as Re,g as ze,h as Be,i as Ve,m as He,p as Ue,s as We,t as Ge,v as Ke,z as qe}from"./sdk-selectors.js";import{i as Je,n as Ye,t as Xe}from"./snapshot-quality.js";import{a as Ze,i as Qe,o as $e}from"./android-input-method-overlays.js";import{n as et,r as tt}from"./sdk-app-inventory.js";import{s as nt}from"./selector-vocabulary.js";import{a as rt,i as it,n as at,r as ot,t as st}from"./png-worker-contract.js";import ct,{promises as E}from"node:fs";import D from"node:path";import{fileURLToPath as lt}from"node:url";import{Worker as ut}from"node:worker_threads";const dt=/\b(logbox|redbox|reload js|copy stack|component stack|call stack|runtime error|open debugger to view warnings)\b/,ft=[/\b[\w.$<>/-]+\.(?:tsx?|jsx?):\d+(?::\d+)?\b/,/\b[\w.$<>/-]+\.(?:tsx?|jsx?)\s+\(\d+:\d+\)/],pt=[/^!,\s+/,/^(warn|warning|error):\s+/,/\b(?:possible\s+)?unhandled (?:promise )?rejection\b/],mt=[`open debugger to view warnings`,`getsnapshot should be cached to avoid an infinite loop`,`unique "key" prop`,`unique 'key' prop`,`virtualizedlists should never be nested`,`failed prop type`],ht=new Set([`x`,`×`,`✕`,`✖`,`⨯`]);function gt(e){if(_t(e).detected)return[`Hint: React Native warning/error overlay detected. It overlays part of the app and should be handled before interacting.`,`Run: agent-device react-native dismiss-overlay`,`The command verifies the overlay is gone. Run agent-device snapshot -i afterward only when you need fresh refs for the next action.`].join(`
+`)}function _t(e){let t=bt(e),n=t.detected?xt(t):null;return{detected:t.detected,dismissNodes:t.dismissNodes,minimizeNodes:t.minimizeNodes,collapsedNodes:t.collapsedNodes,primaryAction:n}}function vt(e){return Ot(e.label?.trim())&&Rt(e.rect)}function yt(e,t){let n=e.label?.trim();return!n||!vt(e)?!1:t.some(e=>e.label?.trim()===n&&zt(e))}function bt(e){let t=e.map(St).join(`
+`).toLowerCase(),n=O(e,At),r=O(e,Pt),i=O(e,Ot,It),a=O(e,kt),o=wt(t),s=Tt(t);return{dismissNodes:n,minimizeNodes:r,collapsedNodes:i,detected:Dt({text:t,hasReactNativeStackFrame:o,hasOverlayControl:Et(t,n,r),hasControllessRedBoxText:s,collapsedNodes:i,openDebuggerWarningNodes:a})}}function xt(e){let t=Bt(e.dismissNodes);if(t)return Ut(t,Wt(t));let n=Gt(e.collapsedNodes.filter(Lt));return n?.rect?{action:`close-collapsed-banner`,point:Xt(n),rect:n.rect,ref:n.ref,label:k(n)}:null}function St(e){return[e.label,e.value,e.identifier,e.type,e.role].filter(Boolean).join(` `)}function Ct(e){return dt.test(e)}function wt(e){return ft.some(t=>t.test(e))}function Tt(e){return/\buncaught\b/.test(e)&&/unable to download asset/.test(e)}function Et(e,t,n){return t.length>0||n.length>0||/\b(reload js|copy stack)\b/.test(e)}function Dt(e){return e.collapsedNodes.length>0||e.openDebuggerWarningNodes.length>0||e.hasControllessRedBoxText||e.hasOverlayControl&&(Ct(e.text)||e.hasReactNativeStackFrame)}function Ot(e){let t=e?.trim().toLowerCase();return t?mt.some(e=>t.includes(e))||pt.some(e=>e.test(t)):!1}function kt(e){return e.includes(`open debugger to view warnings`)||/^!,\s+open debugger\b/.test(e)}function At(e){return jt(e)||Mt(e)||Nt(e)}function jt(e){return/^dismiss(?:\s*\([^)]*\))?$/i.test(e)}function Mt(e){return/^close(?:\s*\([^)]*\))?$/i.test(e)}function Nt(e){return ht.has(e)}function Pt(e){return/^minimi[sz]e(?:\b|\s|\()/i.test(e)}function Ft(e){return/^!,\s+/.test(e)}function It(e){return!e.rect||e.rect.height<=180}function Lt(e){let t=k(e)?.trim().toLowerCase()??``;return(kt(t)||Ft(t))&&zt(e)}function Rt(e){return e?e.x<=1&&e.y<=1&&e.width>=300&&e.height>=600:!1}function zt(e){return e.rect?e.rect.width>=120&&e.rect.height>=36&&e.rect.height<=180:!1}function O(e,t,n=()=>!0){let r=[];for(let i of e)i.ref&&n(i)&&[i.label,i.value,i.identifier].map(e=>e?.trim().toLowerCase()).filter(e=>!!e).some(e=>t(e))&&r.push(i);return r}function Bt(e){return Kt(e,Ht)}function Vt(e){let t=[e.type,e.role,e.subrole].join(` `).toLowerCase();return/\b(button|menuitem|link)\b/.test(t)}function Ht(e){return[Jt(Vt(e)),Jt(e.hittable),-(e.rect?Ie(e.rect):1/0)]}function Ut(e,t){if(!e.rect)throw Error(`React Native overlay target node must have rect`);return{action:t,point:o(e.rect),rect:e.rect,ref:e.ref,label:k(e)}}function Wt(e){let t=k(e)?.trim().toLowerCase();return t&&jt(t)?`dismiss`:`close`}function Gt(e){return Kt(e,qt)}function Kt(e,t){let n=e.filter(e=>e.rect);return n.length===0?null:n.sort((e,n)=>Yt(t(n),t(e)))[0]??null}function qt(e){return[Jt(e.hittable),e.rect?.width??0,e.rect?.y??0]}function Jt(e){return+(e===!0)}function Yt(e,t){for(let n=0;n<e.length;n+=1){let r=e[n]-t[n];if(r!==0)return r}return 0}function Xt(e){if(!e.rect)throw Error(`Collapsed React Native warning node must have rect`);let t=Math.min(e.rect.height,52),n=Math.min(36,Math.max(18,t*.45));return{x:Math.round(Zt(e.rect.x+e.rect.width-n,e.rect.x+1,e.rect.x+e.rect.width-1)),y:Math.round(e.rect.y+t/2)}}function Zt(e,t,n){return Math.min(n,Math.max(t,e))}function k(e){return e.label??e.value??e.identifier}function Qt(e){let t=e?.trim().split(/\s+/,1)[0];if(!t||!t.startsWith(`@`)||t.length<3)return null;let n=t.slice(1);return/^[A-Za-z_-]*\d[\w-]*$/i.test(n)||/^(?:ref|node|element|el)[\w-]*$/i.test(n)?t:null}function $t(e,t){try{let n=lt(e),r=D.extname(n)||`.js`;return[D.join(D.dirname(n),`${t}${r}`),D.join(D.dirname(n),`internal`,`${t}${r}`)].find(e=>ct.existsSync(e))??null}catch{return null}}var A=class extends Error{};let j=null,en=!1,tn=!1,nn=0;const M=new Map;function rn(e){en=!0,!tn&&(tn=!0,l({level:`warn`,phase:`png_worker_unavailable`,data:{reason:e}}),process.emitWarning(`PNG worker unavailable, falling back to in-process PNG processing: ${e}`))}function an(e){let n=M.get(e.id);n&&(M.delete(e.id),cn(),e.ok?n.resolve(e.result):n.reject(new t(c(e.error.code),e.error.message,e.error.details)))}function on(e,t){j===e&&(rn(t.message),j=null,e.terminate().catch(()=>{}),sn(new A(`PNG worker failed: ${t.message}`)))}function sn(e){let t=[...M.values()];M.clear();for(let n of t)n.reject(e)}function cn(){j&&(M.size>0?j.ref():j.unref())}function ln(){if(en)return null;if(j)return j;let e=$t(import.meta.url,`png-worker`);if(!e)return rn(`worker entry module not found next to the current module`),null;try{let t=new ut(e,{execArgv:e.endsWith(`.ts`)?[`--experimental-strip-types`]:[]});return t.on(`message`,an),t.on(`error`,e=>{on(t,e)}),t.on(`exit`,e=>{on(t,Error(`PNG worker exited with code ${e}`))}),t.unref(),j=t,t}catch(e){return rn(`failed to spawn worker: ${e instanceof Error?e.message:String(e)}`),null}}function un(e){let t=ln();if(!t)return Promise.reject(new A(`PNG worker is unavailable`));nn+=1;let n=nn;return new Promise((r,i)=>{M.set(n,{resolve:r,reject:i}),cn();try{t.postMessage({...e,id:n})}catch(e){M.delete(n),cn(),i(new A(`failed to post job to PNG worker: ${e instanceof Error?e.message:String(e)}`))}})}async function dn(e,t){try{return await un(e)}catch(e){if(e instanceof A)return t();throw e}}function fn(){ln()}async function pn(){let e=j;j=null,sn(new A(`PNG worker terminated`)),e&&await e.terminate()}async function N(e,t){let n=await dn({kind:`decode`,png:e,label:t},()=>{let n=it(e,t);return{kind:`decode`,width:n.width,height:n.height,data:n.data}});return new rt({width:n.width,height:n.height,data:st(n.data)})}async function P(e){return st((await dn({kind:`encode`,width:e.width,height:e.height,data:e.data},()=>({kind:`encode`,png:rt.sync.write(e)}))).png)}async function mn(e,t,n){let{kind:r,...i}=await dn({kind:`rgb-difference`,firstPng:e,secondPng:t,label:n},()=>({kind:`rgb-difference`,...at(it(e,n),it(t,n))}));return i}async function hn(e){let{kind:t,...n}=await dn({kind:`diff-pixels`,...e},()=>({kind:`diff-pixels`,...ot(e)}));return{...n,diffData:st(n.diffData)}}const F=[0,187,255,255];function gn(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||_n(e,n.rect)}function _n(e,t){let n=vn(t);if(n==null)return;let r=L(n.x,0,e.width-1),i=L(n.y,0,e.height-1),a=L(n.right,0,e.width-1),o=L(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)I(e,n,i+t,F),I(e,n,o-t,F);for(let n=i;n<=o;n+=1)I(e,r+t,n,F),I(e,a-t,n,F)}}function vn(e){let t=e.x+e.width-1,n=e.y+e.height-1;return[e.x,e.y,e.width,e.height,t,n].every(Number.isFinite)?{x:e.x,y:e.y,right:t,bottom:n}:null}function I(e,t,n,r){if(t<0||t>=e.width||n<0||n>=e.height)return;let i=(n*e.width+t)*4;e.data[i]=r[0],e.data[i+1]=r[1],e.data[i+2]=r[2],e.data[i+3]=r[3]}function L(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}const yn=[{x:-1,y:-1},{x:0,y:-1},{x:1,y:-1},{x:-1,y:0},{x:1,y:0},{x:-1,y:1},{x:0,y:1},{x:1,y:1}];function bn(e){let{mask:t,width:n,height:r,hooks:i}=e,a=new Uint8Array(t.length),o=new Int32Array(t.length),s=[];for(let e=0;e<t.length;e+=1){if(!Cn(t,a,e))continue;let c=0,l=Sn(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=xn({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function xn(e){let{mask:t,visited:n,queue:r,width:i,height:a,pixelIndex:o}=e,s=o%i,c=Math.floor(o/i),l=e.queueEnd;for(let e of yn){let o=s+e.x,u=c+e.y;if(!wn(o,u,i,a))continue;let d=u*i+o;Cn(t,n,d)&&(l=Sn(r,n,l,d))}return l}function Sn(e,t,n,r){return t[r]=1,e[n]=r,n+1}function Cn(e,t,n){return e[n]===1&&t[n]!==1}function wn(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}const Tn=.4,En={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},Dn={leading:20,trailing:20,separator:10,unknown:0,background:-30};function On(e){let t=Nn(An(kn(e.diffMask,e.width,e.height,e.ocr),e.width,e.height),10),n=Wn(e.ocr?.currentBlocksRaw??[]),r=Wn(e.ocr?.baselineBlocksRaw??[]);return t.filter(Jn).map(t=>Pn(t,e,n,r)).filter(t=>t.rect.y>=e.height*.08).filter(Rn).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,e.maxDeltas??12)).map((e,t)=>Fn(e,t+1))}function kn(e,t,n,r){let i=new Uint8Array(e);if(!r)return i;for(let e of[...r.baselineBlocksRaw,...r.currentBlocksRaw])Xn(i,t,n,he(e.rect,8));return i}function An(e,t,n){return bn({mask:e,width:t,height:n,hooks:{create:e=>jn(e,t),visit:(e,n)=>Mn(e,n,t)}})}function jn(e,t){let n=e%t,r=Math.floor(e/t);return{minX:n,minY:r,maxX:n,maxY:r,differentPixels:0}}function Mn(e,t,n){let r=t%n,i=Math.floor(t/n);e.minX=Math.min(e.minX,r),e.minY=Math.min(e.minY,i),e.maxX=Math.max(e.maxX,r),e.maxY=Math.max(e.maxY,i),e.differentPixels+=1}function Nn(e,t){let n=[];for(let r of e.sort((e,t)=>e.minY-t.minY||e.minX-t.minX)){let e=n.find(e=>Zn(e,r,t));if(!e){n.push({...r});continue}e.minX=Math.min(e.minX,r.minX),e.minY=Math.min(e.minY,r.minY),e.maxX=Math.max(e.maxX,r.maxX),e.maxY=Math.max(e.maxY,r.maxY),e.differentPixels+=r.differentPixels}return n}function Pn(e,t,n,r){let i=Yn(e),a=Vn(i,t.regions),o=Hn(i,n,r),s=In(i,o?.block.rect,t.width),c=Ln(i,s,e.differentPixels,t),l={...a?{regionIndex:a}:{},slot:s,likelyKind:c,rect:i};return{...a?{regionIndex:a}:{},slot:s,likelyKind:c,rect:i,...o?{nearestText:qn(o.block.text)}:{},score:zn(l,e.differentPixels,t)}}function Fn(e,t){return{index:t,...e.regionIndex?{regionIndex:e.regionIndex}:{},slot:e.slot,likelyKind:e.likelyKind,rect:e.rect,...e.nearestText?{nearestText:e.nearestText}:{}}}function In(e,t,n){if(e.height<=3&&e.width>=n*.12)return`separator`;if(!t)return e.width>=n*Tn?`background`:`unknown`;if(e.width>=n*Tn)return`background`;let r=e.x+e.width/2,i=t.x+t.width/2;return r<i-t.width/2?`leading`:r>i+t.width/2?`trailing`:e.width>=n*.35?`background`:`unknown`}function Ln(e,t,n,r){let i=e.width/e.height,a=n/(e.width*e.height);return t===`separator`?`separator`:t===`background`?`background`:t===`trailing`&&i>=1.5&&i<=3.8&&a>=.35?`toggle`:t===`trailing`&&e.width<=r.width*.06&&e.height<=r.height*.04?`chevron`:t===`leading`&&i>=.55&&i<=1.8?`icon`:Bn(e,r)?`background`:`visual`}function Rn(e){return e.likelyKind!==`background`}function zn(e,t,n){let r=Bn(e.rect,n)?-35:0,i=e.regionIndex?20:0;return En[e.likelyKind]+Dn[e.slot]+i+r+Math.min(20,t/200)}function Bn(e,t){return e.width>=t.width*.25||e.height>=t.height*.06}function Vn(e,t){let n,r=0;for(let i of t){let t=ge(e,i.rect);t<=r||(r=t,n=i)}return n?.index}function Hn(e,t,n){let r=Un(e,t);if(r)return Kn(e,r.blocks);let i=Un(e,n);return i?Kn(e,i.blocks):void 0}function Un(e,t){let n,r=0;for(let i of t){let t=Qn(e,i.rect);t<=r||(r=t,n=i)}return n}function Wn(e){let t=[];for(let n of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>Gn(e.rect,n.rect));if(!e){t.push({rect:n.rect,blocks:[n]});continue}e.blocks.push(n),e.blocks.sort((e,t)=>e.rect.x-t.rect.x),e.rect=ae([e.rect,n.rect])}return t}function Gn(e,t){return Qn(e,t)>0?!0:Math.abs(y(e).y-y(t).y)<=Math.max(e.height,t.height)*.5}function Kn(e,t){let n,r=y(e);for(let e of t){let t=Math.sqrt(be(r,y(e.rect)));n&&t>=n.distance||(n={block:e,distance:t})}return n}function qn(e){return e.trim().replace(/^[^\p{L}\p{N}]+/u,``).replace(/^\p{L}\s+/u,``)}function Jn(e){let t=Yn(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function Yn(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function Xn(e,t,n,r){let i=re(Math.floor(r.x),0,t-1),a=re(Math.floor(r.y),0,n-1),o=re(Math.ceil(r.x+r.width),0,t),s=re(Math.ceil(r.y+r.height),0,n);for(let n=a;n<s;n+=1)for(let r=i;r<o;r+=1)e[n*t+r]=0}function Zn(e,t,n){return e.minX-n<=t.maxX&&t.minX-n<=e.maxX&&e.minY-n<=t.maxY&&t.minY-n<=e.maxY}function Qn(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}async function $n(e){if(await d(`tesseract`))try{let[t,n]=await Promise.all([nr(e.baselinePath),nr(e.currentPath)]);if(t.exitCode!==0||n.exitCode!==0)return;let r=er(t.stdout,e.width,e.height),i=er(n.stdout,e.width,e.height),a=tr(r,i),o=lr(a);return r.length===0&&i.length===0?void 0:{provider:`tesseract`,baselineBlocks:r.length,currentBlocks:i.length,baselineBlocksRaw:r,currentBlocksRaw:i,matches:a,...o.length>0?{movementClusters:o}:{}}}catch{return}}function er(e,t,n){let[r,...i]=e.split(/\r?\n/);if(!r)return[];let a=r.split(`	`),o=new Map(a.map((e,t)=>[e,t])),s=[];for(let e of i){if(!e.trim())continue;let t=e.split(`	`),n=z(t,o,`level`),r=R(t,o,`text`).trim(),i=z(t,o,`conf`);if(n!==5||!fr(r)||i<0)continue;let a=z(t,o,`left`),c=z(t,o,`top`),l=z(t,o,`width`),u=z(t,o,`height`);l<=0||u<=0||s.push({key:[R(t,o,`page_num`),R(t,o,`block_num`),R(t,o,`par_num`),R(t,o,`line_num`)].join(`:`),text:r,confidence:i,rect:{x:a,y:c,width:l,height:u}})}let c=new Map;for(let e of s){let t=c.get(e.key);t?t.push(e):c.set(e.key,[e])}return Array.from(c.values()).flatMap(e=>ir(e)).map(e=>rr(e,t,n)).filter(e=>e!==null)}function tr(e,t){let n=new Set,r=[];for(let i of e){let e=ar(i,pr(i.text),t,n);if(e===null)continue;n.add(e);let a=t[e],o=or(i,a);sr(o)&&r.push(o)}return r.sort((e,t)=>cr(t)-cr(e)).slice(0,12)}function nr(e){return u(`tesseract`,[e,`stdout`,`-l`,`eng`,`tsv`],{allowFailure:!0,timeoutMs:1e4})}function rr(e,t,n){if(e.length===0)return null;let r=[...e].sort((e,t)=>e.rect.x-t.rect.x),i=ae(r.map(e=>e.rect)),a=Math.round(mr(r.map(e=>e.confidence))*100)/100;return{text:r.map(e=>e.text).join(` `),confidence:a,rect:i,normalizedRect:ne({x:B(i.x/t),y:B(i.y/n),width:B(i.width/t),height:B(i.height/n)})}}function ir(e){let t=[...e].sort((e,t)=>e.rect.x-t.rect.x),n=[],r=[];for(let e of t){let t=r.at(-1);if(!t){r.push(e);continue}let i=e.rect.x-(t.rect.x+t.rect.width),a=Math.max(t.rect.height,e.rect.height);if(i>Math.max(48,a*2.5)){n.push(r),r=[e];continue}r.push(e)}return r.length>0&&n.push(r),n}function ar(e,t,n,r){let i=null,a=1/0;for(let o=0;o<n.length;o+=1){if(r.has(o))continue;let s=n[o];if(pr(s.text)!==t)continue;let c=be(y(e.normalizedRect),y(s.normalizedRect));c>=a||(i=o,a=c)}return i}function or(e,t){let n={x:t.rect.x-e.rect.x,y:t.rect.y-e.rect.y,width:t.rect.width-e.rect.width,height:t.rect.height-e.rect.height},r=hr(t.rect.width/e.rect.width),i=hr(t.rect.height/e.rect.height),a=Math.abs(r-1)>=.08||Math.abs(i-1)>=.12;return{text:e.text,baselineRect:e.rect,currentRect:t.rect,delta:n,confidence:Math.round(Math.min(e.confidence,t.confidence)*100)/100,possibleTextMetricMismatch:a}}function sr(e){return Math.abs(e.delta.x)>=2||Math.abs(e.delta.y)>=2||Math.abs(e.delta.width)>=2||Math.abs(e.delta.height)>=2||e.possibleTextMetricMismatch}function cr(e){return Math.abs(e.delta.x)+Math.abs(e.delta.y)+Math.abs(e.delta.width)+Math.abs(e.delta.height)+(e.possibleTextMetricMismatch?25:0)}function lr(e){let t=[];for(let n of[...e].sort((e,t)=>e.currentRect.y-t.currentRect.y)){let e=t.find(e=>Math.abs(n.delta.x-mr(e.map(e=>e.delta.x)))<=32);e?e.push(n):t.push([n])}return t.filter(e=>e.length>=2).map(ur).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>dr(t)-dr(e)).slice(0,4)}function ur(e){let t=e.map(e=>e.delta.x),n=e.map(e=>e.delta.y);return{texts:e.map(e=>e.text),xRange:{min:Math.min(...t),max:Math.max(...t)},yRange:{min:Math.min(...n),max:Math.max(...n)}}}function dr(e){let t=(e.xRange.min+e.xRange.max)/2,n=(e.yRange.min+e.yRange.max)/2;return Math.abs(t)*2+Math.abs(n)}function R(e,t,n){let r=t.get(n);return r===void 0?``:e[r]??``}function z(e,t,n){let r=Number(R(e,t,n));return Number.isFinite(r)?r:0}function fr(e){return/[\p{L}\p{N}]/u.test(e)}function pr(e){return e.trim().replace(/\s+/g,` `).toLowerCase()}function mr(e){return e.reduce((e,t)=>e+t,0)/e.length}function B(e){return Math.round(e*100*100)/100}function hr(e){return Math.round(e*1e3)/1e3}function gr(e,t){return e.flatMap(e=>_r(e,t.baseline.width,t.baseline.height)?vr(e,t,wr(t.baseline.height)):[e])}function _r(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=Cr(n)&&r>=t*.35}function vr(e,t,n){let r=Sr(e,xr(br(yr(e,t.diffMask,t.baseline.width)),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),n);if(r.length<=1)return[e];let i=r.map(([n,r])=>Tr(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function yr(e,t,n){let r=[];for(let i=e.minY;i<=e.maxY;i+=1){let a=0;for(let r=e.minX;r<=e.maxX;r+=1)t[i*n+r]===1&&(a+=1);r.push(a)}return r}function br(e){return e.map((t,n)=>{let r=0,i=0,a=Math.max(0,n-3),o=Math.min(e.length-1,n+3);for(let t=a;t<=o;t+=1)r+=e[t],i+=1;return Math.round(r/i)})}function xr(e,t){let n=[],r=null;for(let i=0;i<e.length;i+=1){if(e[i]<=t){r??=i;continue}r!==null&&(i-r>=6&&n.push([r,i-1]),r=null)}return r!==null&&e.length-r>=6&&n.push([r,e.length-1]),n}function Sr(e,t,n){let r=[],i=e.minY;for(let[a,o]of t){let t=e.minY+Math.round((a+o)/2);t-i+1<n||e.maxY-t<n||(r.push([i,t]),i=t+1)}return r.push([i,e.maxY]),r}function Cr(e){return Math.max(48,Math.round(e*.07))}function wr(e){return Math.max(24,Math.round(e*.03))}function Tr(e,t,n,r){let i=null;for(let a=t;a<=n;a+=1)for(let t=e.minX;t<=e.maxX;t+=1){let e=a*r.baseline.width+t;r.diffMask[e]===1&&(i??=Er(t,a),Dr(i,e,t,a,r.baseline,r.current))}return i}function Er(e,t){return{minX:e,minY:t,maxX:e,maxY:t,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function Dr(e,t,n,r,i,a){let o=t*4;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,r),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,r),e.differentPixels+=1,e.baselineRed+=i.data[o],e.baselineGreen+=i.data[o+1],e.baselineBlue+=i.data[o+2],e.currentRed+=a.data[o],e.currentGreen+=a.data[o+1],e.currentBlue+=a.data[o+2]}const Or=2.5;function kr(e){let t=Ar(e);return gr(t.length<=2e3?Nr(t,12):t,e).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(n!==0)return n;let r=e.minY-t.minY;return r===0?e.minX-t.minX:r}).slice(0,8).map((t,n)=>Ir(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function Ar(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return bn({mask:t,width:i,height:a,hooks:{create:e=>jr(e,i),visit:(e,t)=>Mr(e,t,i,n,r)}})}function jr(e,t){let n=e%t,r=Math.floor(e/t);return{minX:n,minY:r,maxX:n,maxY:r,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function Mr(e,t,n,r,i){let a=t%n,o=Math.floor(t/n),s=t*4;e.minX=Math.min(e.minX,a),e.minY=Math.min(e.minY,o),e.maxX=Math.max(e.maxX,a),e.maxY=Math.max(e.maxY,o),e.differentPixels+=1,e.baselineRed+=r.data[s],e.baselineGreen+=r.data[s+1],e.baselineBlue+=r.data[s+2],e.currentRed+=i.data[s],e.currentGreen+=i.data[s+1],e.currentBlue+=i.data[s+2]}function Nr(e,t){let n=[];for(let r of e.sort((e,t)=>{let n=e.minY-t.minY;return n===0?e.minX-t.minX:n})){let e=n.find(e=>Pr(e,r,t));if(!e){n.push({...r});continue}Fr(e,r)}return n}function Pr(e,t,n){return e.minX-n<=t.maxX&&t.minX-n<=e.maxX&&e.minY-n<=t.maxY&&t.minY-n<=e.maxY}function Fr(e,t){e.minX=Math.min(e.minX,t.minX),e.minY=Math.min(e.minY,t.minY),e.maxX=Math.max(e.maxX,t.maxX),e.maxY=Math.max(e.maxY,t.maxY),e.differentPixels+=t.differentPixels,e.baselineRed+=t.baselineRed,e.baselineGreen+=t.baselineGreen,e.baselineBlue+=t.baselineBlue,e.currentRed+=t.currentRed,e.currentGreen+=t.currentGreen,e.currentBlue+=t.currentBlue}function Ir(e,t,n){let r={x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1},i={x:Math.round(e.minX+r.width/2),y:Math.round(e.minY+r.height/2)},a=Lr(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=Lr(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height,c=H(e.differentPixels/s),l=Math.round(V(a)),u=Math.round(V(o)),d=Br(r,n.width,n.height),f=Vr(s,n.totalPixels),p=zr(a,o),m=Rr(i,n.width,n.height);return{index:t,rect:r,normalizedRect:ne({x:H(r.x/n.width),y:H(r.y/n.height),width:H(r.width/n.width),height:H(r.height/n.height)}),differentPixels:e.differentPixels,shareOfDiffPercentage:H(e.differentPixels/n.differentPixels),densityPercentage:c,shape:d,size:f,location:m,averageBaselineColorHex:Hr(a),averageCurrentColorHex:Hr(o),baselineLuminance:l,currentLuminance:u,dominantChange:p}}function Lr(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function Rr(e,t,n){let r=e.x<t/3?`left`:e.x>t*2/3?`right`:`center`,i=e.y<n/3?`top`:e.y>n*2/3?`bottom`:`middle`;return r===`center`&&i===`middle`?`center`:`${i}-${r}`}function zr(e,t){let n=V(e),r=V(t)-n;return Math.abs(r)>=12?r>0?`brighter`:`darker`:Math.max(Math.abs(t.r-e.r),Math.abs(t.g-e.g),Math.abs(t.b-e.b))>=12?`color-shift`:`mixed`}function Br(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*Or?`horizontal-band`:e.height>=e.width*Or?`vertical-band`:`compact`}function Vr(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function V(e){return e.r*.2126+e.g*.7152+e.b*.0722}function Hr(e){return`#${Ur(e.r)}${Ur(e.g)}${Ur(e.b)}`}function Ur(e){return e.toString(16).padStart(2,`0`)}function H(e){return Math.round(e*100*100)/100}const Wr=255*Math.sqrt(3);async function Gr(e,t,n={}){await Kr(e,`Baseline image not found`),await Kr(t,`Current screenshot not found`);let r=n.outputPath,[i,a]=await Promise.all([E.readFile(e),E.readFile(t)]),[o,s]=await Promise.all([N(i,`baseline screenshot`),N(a,`current screenshot`)]);qr(o.width,o.height,`baseline screenshot`,n.maxPixels),qr(s.width,s.height,`current screenshot`,n.maxPixels);let c=n.threshold??.1;if(o.width!==s.width||o.height!==s.height){let e=o.width*o.height;return await Jr(n.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:o.width,height:o.height},actual:{width:s.width,height:s.height}}}}let l=o.width*o.height,u=c*Wr,{diffData:d,diffMask:f,differentPixels:p}=await hn({width:o.width,height:o.height,baselineData:o.data,currentData:s.data,maxColorDistance:u}),m=p>0?kr({diffMask:f,baseline:o,current:s,totalPixels:l,differentPixels:p}):[];if(p>0&&r){let e=new rt({width:o.width,height:o.height,data:d});gn(e,m),await E.mkdir(D.dirname(r),{recursive:!0}),await E.writeFile(r,await P(e))}else await Jr(n.outputPath);let h=p>0?await $n({baselinePath:e,currentPath:t,width:o.width,height:o.height}):void 0,g=h&&(h.matches.length>0||(h.movementClusters?.length??0)>0)?{provider:h.provider,baselineBlocks:h.baselineBlocks,currentBlocks:h.currentBlocks,matches:h.matches,...h.movementClusters?{movementClusters:h.movementClusters}:{}}:void 0,_=p>0&&h?On({diffMask:f,width:o.width,height:o.height,regions:m,ocr:h}):[],ee=l>0?Math.round(p/l*100*100)/100:0;return{...p>0&&r?{diffPath:r}:{},...m.length>0?{regions:m}:{},...g?{ocr:g}:{},..._.length>0?{nonTextDeltas:_}:{},totalPixels:l,differentPixels:p,mismatchPercentage:ee,match:p===0}}async function Kr(e,n){try{await E.access(e)}catch{throw new t(`INVALID_ARGS`,`${n}: ${e}`)}}function qr(e,n,r,i){if(i==null||i<=0)return;let a=e*n;if(!(a<=i))throw new t(`INVALID_ARGS`,`${r} is ${a} pixels, which exceeds the configured maxImagePixels limit of ${i}`)}async function Jr(e){if(e)try{await E.unlink(e)}catch(e){if(!Yr(e,`ENOENT`))throw e}}function Yr(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function Xr(e,t){return e.map(e=>{let n=Zr(e,t);return n.length>0?{...e,currentOverlayMatches:n}:e})}function Zr(e,t){let n=Qr(e.rect);return t.map(t=>{let r=t.overlayRect,i=ge(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:$r(i/Qr(r)),regionCoveragePercentage:$r(i/n)}}).filter(e=>e!==null).sort((e,t)=>{let n=t.regionCoveragePercentage-e.regionCoveragePercentage;return n===0?t.overlayCoveragePercentage-e.overlayCoveragePercentage:n}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage}))}function Qr(e){return e.width*e.height}function $r(e){return Math.round(e*100*100)/100}async function U(e,n,r){if(n.kind===`path`&&!e.policy.allowLocalInputPaths)throw new t(`INVALID_ARGS`,`Local ${r.field??`input`} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(n,r)}catch(e){throw s(e)}}async function W(e,n,r){if(n?.kind===`path`&&!e.policy.allowLocalOutputPaths)throw new t(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await e.artifacts.reserveOutput(n,{...r,visibility:r.visibility??`client-visible`,requestedClientPath:n?.kind===`downloadableArtifact`?n.clientPath??r.requestedClientPath:r.requestedClientPath})}catch(e){throw s(e)}}async function ei(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw s(e)}}const ti=async(e,n)=>{if(!n.baseline)throw new t(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let r=ni(n.threshold),i=n.current??{kind:`live`};if(n.overlayRefs&&!ui(i))throw new t(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let a=await U(e,n.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let t;ui(i)?(s=await ri(e,n),t=s.path):(o=await U(e,i,{usage:`diff screenshot current`,field:`current`}),t=o.path),c=n.out?await W(e,n.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await Gr(a.path,t,{threshold:r,outputPath:c?.path,maxPixels:e.policy.maxImagePixels});ui(i)&&(u=await ii(e,n,c?.path,u,l));let d=u.diffPath?await c?.publish():void 0;return d&&l.push(d),u.diffPath||await c?.cleanup?.(),{...u,...l.length>0?{artifacts:l}:{}}}catch(e){throw await c?.cleanup?.(),e}finally{await a.cleanup?.(),await o?.cleanup?.(),await s?.cleanup?.()}};function ni(e){if(e==null||e===``)return .1;let n=Number(e);if(Number.isNaN(n)||n<0||n>1)throw new t(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return n}async function ri(e,t){let n=await ei(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await ai(e,t,n.path,oi(t))}catch(e){throw await n.cleanup(),e}return n}async function ii(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await li(n),r;let a=await W(e,si(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await ai(e,t,a.path,{overlayRefs:!0,...oi(t)}),o=await a.publish();return o&&i.push(o),{...r,currentOverlayPath:n.path??a.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...r.regions&&n.overlayRefs?{regions:Xr(r.regions,n.overlayRefs)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function ai(e,n,r,i={}){if(!e.backend.captureScreenshot)throw new t(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await e.backend.captureScreenshot({session:n.session,requestId:n.requestId,signal:n.signal??e.signal,metadata:n.metadata},r,i)??{}}function oi(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function si(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:ci(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:ci(e.out.clientPath)}:{},...e.out.fileName?{fileName:ci(e.out.fileName)}:{}}}function ci(e){let t=D.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function li(e){try{await E.unlink(ci(e))}catch(e){if(!di(e,`ENOENT`))throw e}}function ui(e){return e.kind===`live`}function di(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}async function fi(e,n){if(!Number.isInteger(n)||n<1)throw new t(`INVALID_ARGS`,`Screenshot max size must be a positive integer`);let r=await N(await E.readFile(e),`screenshot`),i=Math.max(r.width,r.height);if(i<=n)return;let a=n/i,o=mi(r,Math.max(1,Math.round(r.width*a)),Math.max(1,Math.round(r.height*a)));await E.writeFile(e,await P(o))}async function pi(e,n,r){if(!Number.isInteger(n)||n<1||!Number.isInteger(r)||r<1)throw new t(`INVALID_ARGS`,`Screenshot resize dimensions must be positive integers`);let i=await N(await E.readFile(e),`screenshot`);i.width===n&&i.height===r||await E.writeFile(e,await P(mi(i,n,r)))}function mi(e,t,n){let r=new rt({width:t,height:n});for(let i=0;i<n;i+=1){let a=i*e.height/n,o=(i+1)*e.height/n;for(let n=0;n<t;n+=1){let s=n*e.width/t,c=(n+1)*e.width/t,l=0,u=0,d=0,f=0,p=0;for(let t=Math.floor(a);t<Math.ceil(o);t+=1){let n=Math.min(t+1,o)-Math.max(t,a);for(let r=Math.floor(s);r<Math.ceil(c);r+=1){let i=n*(Math.min(r+1,c)-Math.max(r,s)),a=(t*e.width+r)*4;l+=(e.data[a]??0)*i,u+=(e.data[a+1]??0)*i,d+=(e.data[a+2]??0)*i,f+=(e.data[a+3]??0)*i,p+=i}}let m=(i*r.width+n)*4;r.data[m]=Math.round(l/p),r.data[m+1]=Math.round(u/p),r.data[m+2]=Math.round(d/p),r.data[m+3]=Math.round(f/p)}}return r}const hi=async(e,n)=>{if(!e.backend.captureScreenshot)throw new t(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);let r=await W(e,n.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),i;try{await e.backend.captureScreenshot({session:n.session,requestId:n.requestId,appId:n.appId,appBundleId:n.appBundleId,signal:n.signal??e.signal,metadata:n.metadata},r.path,{fullscreen:n.fullscreen,overlayRefs:n.overlayRefs,pixelDensity:n.pixelDensity,stabilize:n.stabilize,normalizeStatusBar:n.normalizeStatusBar,surface:n.surface}),n.maxSize!==void 0&&await fi(r.path,n.maxSize),i=await r.publish()}catch(e){throw await r.cleanup?.(),e}return{path:r.path,...i?{artifacts:[i]}:{},...x(`Saved screenshot: ${r.path}`)}};function gi(e){let{nodes:t,backend:n,snapshotRaw:i}=e;if(i||!r(n))return{partial:!1,visibleNodeCount:t.length,totalNodeCount:t.length,reasons:[]};let a=Fe(t),o=new Set;return a.hiddenCount>0&&o.add(`offscreen-nodes`),a.nodes.some(e=>e.hiddenContentAbove)&&o.add(`scroll-hidden-above`),a.nodes.some(e=>e.hiddenContentBelow)&&o.add(`scroll-hidden-below`),{partial:o.size>0,visibleNodeCount:a.nodes.length,totalNodeCount:t.length,reasons:[...o]}}const _i=`A system surface (notification shade, quick settings, or another system overlay) covers the app, so this snapshot shows that surface. Interact with it or dismiss it (press back or swipe up) to reach app content.`;function vi(e){return e?.systemSurfaceOnly===!0?_i:void 0}function yi(e,t){return e.presentationKey?e:{...e,presentationKey:i(t)}}function bi(e){let{previous:t,current:n,options:r,identity:i}=e;if(r.forceFull===!0||r.raw===!0||!t||t.comparisonSafe===!1||n.comparisonSafe===!1||!xi(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!Si(t,n))return;let a=r.scope?.trim();return{ageMs:Math.max(0,n.createdAt-t.createdAt),nodeCount:n.nodes.length,...r.interactiveOnly===!0?{interactiveOnly:!0}:{},...a?{scope:a}:{}}}function xi(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function Si(e,t){return e.truncated===t.truncated?JSON.stringify(Ci(e.nodes))===JSON.stringify(Ci(t.nodes)):!1}function Ci(e){return e.map(e=>({index:e.index,depth:e.depth,parentIndex:e.parentIndex,type:e.type,role:e.role,subrole:e.subrole,label:e.label,value:e.value,identifier:e.identifier,enabled:e.enabled,selected:e.selected,focused:e.focused,hittable:e.hittable,rect:e.rect,bundleId:e.bundleId,appName:e.appName,windowTitle:e.windowTitle,surface:e.surface,hiddenContentAbove:e.hiddenContentAbove,hiddenContentBelow:e.hiddenContentBelow,interactionBlocked:e.interactionBlocked,presentationHints:e.presentationHints}))}const wi=async(e,t)=>{let n=await Ei(e,t),r=bi({previous:n.session?.snapshot,current:n.snapshot,options:t,identity:{previousAppBundleId:n.session?.appBundleId,currentAppBundleId:n.result.appBundleId??n.session?.appBundleId}});return await e.sessions.set(Oi(t.session,n)),{nodes:n.snapshot.nodes,truncated:n.snapshot.truncated??!1,visibility:gi({nodes:n.snapshot.nodes,backend:n.snapshot.backend,snapshotRaw:t.raw}),...Ee({...n.annotations,warnings:n.warnings}),...r?{unchanged:r}:{},...n.result.snapshotDiagnostics?{snapshotDiagnostics:n.result.snapshotDiagnostics}:{},...ki(n)}},Ti=async(e,t)=>{let n=await Ei(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,a=Oi(t.session,n);if(!i){let t=le(n.snapshot.nodes,{flatten:r});return await e.sessions.set(a),{mode:`snapshot`,baselineInitialized:!0,summary:{additions:0,removals:0,unchanged:t},lines:[],...n.warnings.length>0?{warnings:n.warnings}:{}}}let o=te(i.nodes,n.snapshot.nodes,{flatten:r});return await e.sessions.set(a),{mode:`snapshot`,baselineInitialized:!1,summary:o.summary,lines:o.lines,...n.warnings.length>0?{warnings:n.warnings}:{}}};async function Ei(e,n){if(!e.backend.captureSnapshot)throw new t(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=n.session??`default`,i=await e.sessions.get(r),a=await e.backend.captureSnapshot({session:r,requestId:n.requestId,appId:i?.appId,appBundleId:i?.appBundleId,signal:n.signal??e.signal,metadata:n.metadata},{interactiveOnly:n.interactiveOnly,depth:n.depth,scope:n.scope,raw:n.raw}),o=yi(Di(a,e),n),s=we(a),c=w(e);return{snapshot:o,result:a,session:i,annotations:s,warnings:Ai({result:a,annotations:s,snapshot:o,options:n,session:i,capturedAt:o.createdAt??c,runtimeNow:c})}}function Di(e,t){return e.snapshot?e.snapshot:{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,createdAt:w(t)}}function Oi(e,t){let n=t.session?.name??e??`default`;return{...t.session??{name:n},name:n,snapshot:t.snapshot,appName:t.result.appName??t.session?.appName,appBundleId:t.result.appBundleId??t.session?.appBundleId}}function ki(e){let t=e.result.appName??e.session?.appName,n=e.result.appBundleId??e.session?.appBundleId;return{...t||n?{appName:t??n}:{},...n?{appBundleId:n}:{}}}function Ai(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...Je(e.annotations.quality,e.snapshot.nodes)),t.push(...Pi(e)),e.annotations.quality||(t.push(...Mi(e)),t.push(...Ni(e.snapshot.nodes)));let n=gt(e.snapshot.nodes);n&&t.push(n);let r=ji(e.annotations);r&&t.push(r);let i=Fi(e);return i&&t.push(i),t.push(...zi(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function ji(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return _i}function Mi(e){return e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1||e.snapshot.nodes[0]?.type!==`Application`?[]:[`iOS interactive snapshot exposed only the application root. XCTest accessibility queries can fail to enumerate some simulator UI trees even when screenshots and direct gestures still work. Use screenshot as visual truth, try a scoped/full snapshot for diagnostics, and prefer direct selectors when known.`]}function Ni(e){let t=new Set(e.map(e=>e.parentIndex).filter(e=>e!==void 0));return e.filter(e=>t.has(e.index)||(e.type?.toLowerCase()??``).includes(`text`)?!1:(e.label??``).split(`, `).length>10).map(e=>{let t=(e.label??``).split(`, `).length,n=e.identifier?` (${e.identifier})`:``;return`@${e.ref} [${e.type??`element`}]${n} merges ~${t} labels into a single accessibility element. The app likely marks a container as accessible, which hides every descendant from assistive tech and automation — the children cannot be addressed individually. Fix the app's accessibility (mark the rows, not the container); until then use screenshot as visual truth and coordinate taps.`})}function Pi(e){let t=e.annotations.analysis;if(e.snapshot.backend!==`android`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length>0||!t||(t.rawNodeCount??0)<12)return[];let n=[`Interactive snapshot is empty after filtering ${t.rawNodeCount} raw Android nodes. Likely causes: the app content is not accessibility-visible yet, a transient route change, or depth/filter options hid the target.`];return typeof e.options.depth==`number`&&typeof t.maxDepth==`number`&&t.maxDepth>=e.options.depth+2&&n.push(`Interactive output is empty at depth ${e.options.depth}; retry without -d.`),n}function Fi(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&Ii(t,e.snapshot)&&Li(t,e.capturedAt,e.runtimeNow)&&Bi(t.nodes.length,e.snapshot.nodes.length))return Ri}function Ii(e,t){return e.presentationKey===void 0||t.presentationKey===void 0?!0:e.presentationKey===t.presentationKey}function Li(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const Ri=`Recent snapshots dropped sharply in node count, which suggests stale or mid-transition UI. Use screenshot as visual truth, wait briefly, then re-snapshot once.`;function zi(e,t){return!e?.staleAfterRetries||t!==`android`?[]:e.reason===`stuck-route`?[`Recent ${e.action} was followed by a nearly identical snapshot after ${e.retryCount} automatic retr${e.retryCount===1?`y`:`ies`}. If you expected navigation or submit, the tree may still be stale. Use screenshot as visual truth, wait briefly, then re-snapshot once.`]:e.reason===`sharp-drop`?[Ri]:[]}function Bi(e,t){return e<12?!1:t<=Math.floor(e*.2)}const Vi={screenshot:hi,diffScreenshot:ti,snapshot:wi,diffSnapshot:Ti},Hi=async(e,t)=>await Ki(e,t,`press`),Ui=async(e,t)=>await Ki(e,t,`click`),Wi=async(e,n)=>{if(!n.text)throw new t(`INVALID_ARGS`,`fill requires text`);let r=ee(n),i=r.needsPreActionBaseline?null:await Yi(e,n);if(i)return i;let a=await ue(e,n,{action:`fill`,requireInteractive:!0,promoteToHittableAncestor:!1,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!e.backend.fill)throw new t(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=qi(a),s=S(await e.backend.fill(g(e,n),o,n.text,{delayMs:n.delayMs})),c=`node`in a?a.node?.type??``:``,l=c&&!Ne(c,e.backend.platform)?`fill target ${Zi(a)} resolved to "${c}", attempting fill anyway.`:void 0;return await fe(e,n,a,{...a,text:n.text,...l?{warning:l}:{},...s?{backendResult:s}:{}},r)},Gi=async(e,n)=>{let r=n.text;if(!r)throw new t(`INVALID_ARGS`,`type requires text`);let i=Qi(r);if(i)throw new t(`INVALID_ARGS`,`type does not accept a target ref like "${i}"`,{hint:`Use fill ${i} "text" to target that field, or press ${i} then type "text" to append.`});if(!e.backend.typeText)throw new t(`UNSUPPORTED_OPERATION`,`type is not supported by this backend`);let a=T(n.delayMs??0,`delay-ms`,0,1e4),o=S(await e.backend.typeText(g(e,n),r,{delayMs:a}));return{kind:`text`,text:r,delayMs:a,...o?{backendResult:o}:{},...x(`Typed ${Array.from(r).length} chars`)}};async function Ki(e,n,r){let i=ee(n),a=i.needsPreActionBaseline?null:await Ji(e,n,r);if(a)return a;let o=await ue(e,n,{action:r,requireInteractive:!0,promoteToHittableAncestor:!0,captureEvidenceBaseline:i.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!e.backend.tap)throw new t(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let s=qi(o),c=S(await e.backend.tap(g(e,n),s,{button:n.button,count:n.count,intervalMs:n.intervalMs,holdMs:n.holdMs,jitterPx:n.jitterPx,doubleTap:n.doubleTap}));return await fe(e,n,o,{...o,...c?{backendResult:c}:{}},i)}function qi(e){if(!e.point)throw new t(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}async function Ji(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||Xi(t)||t.expectedResolvedTarget)return null;let r=await ce(e,t,t.target,n),i=S(await e.backend.tapTarget(g(e,t),{kind:`ref`,ref:t.target.ref,...t.target.fallbackLabel?{fallbackLabel:t.target.fallbackLabel}:{}}));return{kind:`ref`,target:{kind:`ref`,ref:t.target.ref},resolution:ye,...r,...i?{backendResult:i}:{}}}async function Yi(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let n=await ce(e,t,t.target,`fill`),r=S(await e.backend.fillTarget(g(e,t),{kind:`ref`,ref:t.target.ref,...t.target.fallbackLabel?{fallbackLabel:t.target.fallbackLabel}:{}},t.text,{delayMs:t.delayMs}));return{kind:`ref`,target:{kind:`ref`,ref:t.target.ref},text:t.text,resolution:ye,...n,...r?{backendResult:r}:{}}}function Xi(e){return e.count!==void 0||e.intervalMs!==void 0||e.holdMs!==void 0||e.jitterPx!==void 0||e.doubleTap!==void 0||e.button!==void 0&&e.button!==`primary`}function Zi(e){return e.target?.kind===`ref`?e.target.ref:e.target?.kind===`selector`?e.target.selector:`point`}function Qi(e){return Qt(e)}function $i(e){return{includeRects:ea(e.predicate),interactiveOnly:!1}}function ea(e){return e===`visible`||e===`hidden`}const ta=1e4,na=async(e,n)=>{let r=n.locator??`any`;if(!n.query)throw new t(`INVALID_ARGS`,m);if(n.action===`wait`)return await da(e,n,r);let{capture:i,match:a}=await fa(e,n,r);if(!a)throw new t(`COMMAND_FAILED`,`find did not match any element`);if(n.action===`exists`)return{kind:`found`,found:!0};let o=`@${a.ref}`;return n.action===`get_attrs`?{kind:`attrs`,ref:o,node:a}:{kind:`text`,ref:o,text:await ie(e,i,a),node:a}},ra=async(e,t)=>{if(t.target.kind===`ref`){let n=await oe(e,t.session),r=de(n.snapshot.nodes,t.target.ref,{fallbackLabel:t.target.fallbackLabel??``,invalidRefMessage:`get text requires a ref like @e2`,notFoundMessage:`Ref ${t.target.ref} not found`});_(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=Ge(r.node,e.backend.platform,{action:`get`,nodes:n.snapshot.nodes}),a={kind:`ref`,ref:`@${r.ref}`},o=n.snapshot.nodes;return t.property===`attrs`?{kind:`attrs`,target:a,node:r.node,selectorChain:i,preActionNodes:o}:{kind:`text`,target:a,text:await ie(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await xa(e,t,t.session??`default`,{selector:t.target.selector,disambiguateAmbiguous:t.property===`text`});_(n.node,n.capture.snapshot.nodes,t.expectedResolvedTarget,`get`);let r=Ge(n.node,e.backend.platform,{action:`get`,nodes:n.capture.snapshot.nodes});if(t.property===`attrs`)return{kind:`attrs`,target:{kind:`selector`,selector:n.selector},node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes};let i=await ie(e,n.capture,n.node);return{kind:`text`,target:{kind:`selector`,selector:n.selector},text:i,node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes}},ia=async(e,n)=>{let r=await ra(e,{...n,property:`text`,target:n.target});if(r.kind!==`text`)throw new t(`COMMAND_FAILED`,`getText returned non-text result`);return r},aa=async(e,n)=>{let r=await ra(e,{...n,property:`attrs`,target:n.target});if(r.kind!==`attrs`)throw new t(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return r},oa=async(e,n)=>{let r=Pe(n.predicate);if(!r.ok)throw new t(r.code,r.message,{hint:r.hint});let i=r.predicate;if(i===`text`&&!n.expectedText)throw new t(`INVALID_ARGS`,Ke);let a=f(n.selector),o=await v(e,n,{updateSession:!0,...$i({predicate:i,selectorChain:a})});if(i===`exists`){let n=Le(o.snapshot.nodes,a,{platform:e.backend.platform});if(!n)throw new t(`COMMAND_FAILED`,Ue(a,[],{unique:!1}),{hint:ze([])});return{predicate:i,pass:!0,selector:n.selector.raw,matches:n.matches,selectorChain:a.selectors.map(e=>e.raw)}}let s=Be(o.snapshot.nodes,a,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:!1});if(!s)throw new t(`COMMAND_FAILED`,Ue(a,[],{unique:!0}),{command:`is`,reason:`selector_not_found`,predicate:i,selector:a.raw,hint:ze([])});_(s.node,o.snapshot.nodes,n.expectedResolvedTarget,`is`);let c=Ae({predicate:i,node:s.node,nodes:o.snapshot.nodes,expectedText:n.expectedText,platform:e.backend.platform});if(!c.pass)throw new t(`COMMAND_FAILED`,`is ${i} failed for selector ${s.selector.raw}: ${c.details}`,{command:`is`,reason:`predicate_failed`,predicate:i,selector:s.selector.raw,predicateDetails:c.details});return{predicate:i,pass:!0,selector:s.selector.raw,...i===`text`?{text:c.actualText}:{},selectorChain:a.selectors.map(e=>e.raw),node:s.node,preActionNodes:o.snapshot.nodes}},sa=async(e,t)=>await oa(e,{...t,predicate:`visible`,selector:t.target.selector}),ca=async(e,t)=>await oa(e,{...t,predicate:`hidden`,selector:t.target.selector}),la=async(e,r)=>{if(r.target.kind===`sleep`)return await b(e,r.target.durationMs),{kind:`sleep`,waitedMs:r.target.durationMs};if(r.target.kind===`ref`){let i=await oe(e,r.session),o=a(r.target.ref);if(!o)throw new t(`INVALID_ARGS`,`Invalid ref: ${r.target.ref}`);let s=n(i.snapshot.nodes,o),c=s?qe(s,i.snapshot.nodes):void 0;if(!c)throw new t(`COMMAND_FAILED`,`Ref ${r.target.ref} not found or has no label`);return await va(e,r,c,r.target.timeoutMs)}if(r.target.kind===`selector`)return await ha(e,r,r.target.selector,r.target.timeoutMs,r.target.recordedLandmark);if(r.target.kind===`stable`)return await ba(e,r,r.target.quietMs,r.target.timeoutMs);let i=ke(r.target.text);if(!i.ok)throw new t(i.code,i.message);return await va(e,r,r.target.text,r.target.timeoutMs)},ua=async(e,n)=>{let r=await la(e,{...n,target:{kind:`text`,text:n.text,timeoutMs:n.timeoutMs}});if(r.kind!==`text`)throw new t(`COMMAND_FAILED`,`waitForText returned non-text result`);return r};async function da(e,n,r){let i=n.timeoutMs??ta,a=w(e);for(;w(e)-a<i;){let{match:t}=await fa(e,n,r,{includeHiddenContentHints:!1});if(t)return{kind:`found`,found:!0,waitedMs:w(e)-a};await b(e,300)}throw new t(`COMMAND_FAILED`,`find wait timed out`)}async function fa(e,t,n,r){let i=h(n,t.query),a=await v(e,t,{updateSession:!0,scope:pa(e,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...$i({selectorChain:i})});if(Xe(a.snapshot.snapshotQuality))throw ma(a.snapshot.snapshotQuality);return i?{capture:a,match:Be(a.snapshot.nodes,i,{platform:e.backend.platform,requireRect:!1,requireUnique:!1})?.node}:{capture:a,match:p(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}function pa(e,t,n,r){if(!r&&e.backend.platform!==`web`)return De(t)?n:void 0}function ma(e){return new t(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth, navigate with coordinates if needed, then retry find after reaching a readable screen.`})}async function ha(e,n,r,i,a){let o=i??ta,s=w(e),c=f(r),l=$i({selectorChain:c}),u,d=ga();for(;w(e)-s<o;){let t=await d.attempt(()=>v(e,n,{updateSession:!0,includeHiddenContentHints:!1,...l}));if(t){let n=t.snapshot.nodes,r=He(n,c,{platform:e.backend.platform});if(r){let t=_a(n,r,a);if(t.kind===`satisfied`)return{kind:`selector`,selector:r.selector.raw,waitedMs:w(e)-s,node:t.node,preActionNodes:n};u=t.evidence}}await b(e,300)}throw u?new t(`COMMAND_FAILED`,`wait matched selector ${r} but no candidate carried the recorded landmark identity`,{reason:Ve,...u}):(d.rethrowIfNeverReadable(),new t(`COMMAND_FAILED`,`wait timed out for selector: ${r}`))}function ga(){let e=!1,t;return{attempt:async n=>{try{let t=await n();return e=!0,t}catch(e){if(!Ye(e))throw e;t=e;return}},rethrowIfNeverReadable:()=>{if(!e&&t!==void 0)throw t}}}function _a(e,t,n){let r=t.matchedNodes[0];if(!n)return{kind:`satisfied`,node:r};let i=Ze(e),a=$e(t.matchedNodes,i,Re(n),n.ancestry)[0];return a?{kind:`satisfied`,node:a}:{kind:`identity-mismatch`,evidence:{matchCount:t.matchedNodes.length,observed:We(r),observedAncestry:Qe(r,i,Math.max(n.ancestry.length,1)).chain}}}async function va(e,n,r,i){let a=i??ta,o=w(e),s=ga();for(;w(e)-o<a;){if(await s.attempt(async()=>e.backend.findText?(await e.backend.findText(g(e,n),r)).found:await ya(e,n,r)))return{kind:`text`,text:r,waitedMs:w(e)-o};await b(e,300)}throw s.rethrowIfNeverReadable(),new t(`COMMAND_FAILED`,`wait timed out for text: ${r}`)}async function ya(e,t,n){return!!je((await v(e,t,{updateSession:!0,includeHiddenContentHints:!1})).snapshot.nodes,n)}async function ba(e,n,r,i){let a=i??ta,o=r??500,s=await me(e,n,{quietMs:o,timeoutMs:a});if(!s.settled)throw new t(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:`wait_stable_timeout`,...s.stalled?{captureStalled:!0}:{},quietMs:o,timeoutMs:a,captures:s.captures,nodeCount:s.nodeCount,...s.stalled?{hint:`A snapshot capture stalled past the wait timeout, so no settle verdict is available. The UI may still be readable: retry, or use screenshot to inspect the surface.`}:{}});return{kind:`stable`,waitedMs:s.waitedMs,captures:s.captures,nodeCount:s.nodeCount,...s.nodeCount<5?{hint:Se}:{}}}async function xa(e,n,r,i){let a=f(i.selector),o=await v(e,{...n,session:r},{updateSession:!0,...$i({selectorChain:a})}),s=Be(o.snapshot.nodes,a,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:i.disambiguateAmbiguous});if(!s)throw new t(`COMMAND_FAILED`,Ue(a,[],{unique:!0}),{hint:ze([])});return{capture:o,node:s.node,selector:s.selector.raw,ref:`@${s.node.ref}`}}function Sa(e,n){let r=e.filter(t=>Me(t,e)).map(e=>e.rect).filter(Ca),i=r.length>0?r:e.map(e=>e.rect).filter(Ca);if(i.length===0)throw new t(`COMMAND_FAILED`,`Cannot infer viewport for ${n}`);let a=Math.min(...i.map(e=>e.x)),o=Math.min(...i.map(e=>e.y)),s=Math.max(...i.map(e=>e.x+e.width)),c=Math.max(...i.map(e=>e.y+e.height));return{x:a,y:o,width:s-a,height:c-o}}function Ca(e){return!!(e&&e.width>0&&e.height>0)}const wa=async(e,n)=>{if(!e.backend.performGesture)throw new t(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await ve(e,n,n.gesture.intent);let r=await Ta(e,n),i=nt(n.gesture,r,e.backend.platform),a=S(await e.backend.performGesture(g(e,n),i)),o=Ea(i.pointers,0),s=Ea(i.pointers,-1);return{kind:i.intent,durationMs:i.durationMs,pointerCount:i.topology===`single`?1:2,from:o,to:s,...a?{backendResult:a}:{},...x(Da(n.gesture,o,s))}};async function Ta(e,t){return await e.backend.resolveGestureViewport?.(g(e,t))||Sa((await se(e,t,!1)).snapshot.nodes,`gesture`)}function Ea(e,n){let r=e.map(e=>n===0?e.samples[0]?.point:e.samples.at(-1)?.point);if(r.some(e=>e===void 0))throw new t(`COMMAND_FAILED`,`Gesture plan did not contain endpoint samples.`);let i=r;return{x:i.reduce((e,t)=>e+t.x,0)/i.length,y:i.reduce((e,t)=>e+t.y,0)/i.length}}function Da(e,t,n){switch(e.intent){case`pan`:{let r=`preset`in e?t:e.origin,i=`preset`in e?{x:n.x-t.x,y:n.y-t.y}:e.delta;return`Panned (${r.x}, ${r.y}) by (${i.x}, ${i.y})`}case`fling`:return`direction`in e?`Flung ${e.direction}`:`Flung`;case`pinch`:return`Pinched to scale ${e.scale}`;case`rotate`:return`Rotated gesture ${e.degrees} degrees`;case`transform`:return`Requested transform gesture by (${e.delta.x}, ${e.delta.y}), scale ${e.scale}, rotate ${e.degrees} degrees`}}const G={find:na,get:ra,getText:ia,getAttrs:aa,is:oa,isVisible:sa,isHidden:ca,wait:la,waitForText:ua},K={click:Ui,press:Hi,fill:Wi,typeText:Gi,focus:Te,longPress:_e,scroll:Ce,gesture:wa};function Oa(e){return{find:t=>G.find(e,t),get:t=>G.get(e,t),getText:(t,n={})=>G.getText(e,{...n,target:t}),getAttrs:(t,n={})=>G.getAttrs(e,{...n,target:t}),is:t=>G.is(e,t),isVisible:(t,n={})=>G.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>G.isHidden(e,{...n,target:t}),wait:t=>G.wait(e,t),waitForText:(t,n={})=>G.waitForText(e,{...n,text:t})}}function ka(e){return{click:(t,n={})=>K.click(e,{...n,target:t}),press:(t,n={})=>K.press(e,{...n,target:t}),fill:(t,n,r={})=>K.fill(e,{...r,target:t,text:n}),typeText:(t,n={})=>K.typeText(e,{...n,text:t}),focus:(t,n={})=>K.focus(e,{...n,target:t}),longPress:(t,n={})=>K.longPress(e,{...n,target:t}),scroll:t=>K.scroll(e,t),gesture:t=>K.gesture(e,t)}}function q(e,t){if(e!==void 0)return J(e,t)}function J(e,n){let r=e?.trim();if(!r)throw new t(`INVALID_ARGS`,`${n} must be a non-empty string`);return r}const Aa=async(e,n={})=>{if(!e.backend.listDevices)throw new t(`UNSUPPORTED_OPERATION`,`admin.devices is not supported by this backend`);return{kind:`adminDevices`,devices:await e.backend.listDevices(g(e,n),n.filter)}},ja=async(e,n={})=>{if(!e.backend.bootDevice)throw new t(`UNSUPPORTED_OPERATION`,`admin.boot is not supported by this backend`);let r=Va(n.target),i=S(await e.backend.bootDevice(g(e,n),r));return{kind:`deviceBooted`,...r?{target:r}:{},...i?{backendResult:i}:{},...x(`Booted device`)}},Ma=async(e,n={})=>{if(!e.backend.shutdownDevice)throw new t(`UNSUPPORTED_OPERATION`,`admin.shutdown is not supported by this backend`);let r=Va(n.target),i=S(await e.backend.shutdownDevice(g(e,n),r));return{kind:`deviceShutdown`,...r?{target:r}:{},...i?{backendResult:i}:{},...x(`Shutdown device`)}},Na=async(e,t)=>await Ia(e,t,`install`),Pa=async(e,t)=>await Ia(e,t,`reinstall`),Fa=async(e,t)=>await Ia(e,t,`installFromSource`);async function Ia(e,n,r){let i=r===`reinstall`?`reinstallApp`:`installApp`,a=e.backend[i];if(!a)throw new t(`UNSUPPORTED_OPERATION`,`admin.${r} is not supported by this backend`);let o=`app`in n&&n.app!==void 0?J(n.app,`app`):void 0;if(r!==`installFromSource`&&!o)throw new t(`INVALID_ARGS`,`admin.${r} requires app`);let s=g(e,n),c=await La(e,s,n.source);try{let t=await a.call(e.backend,s,{...o?{app:o}:{},source:c.source});return Ha(r,o,c.source,t)}finally{await c.cleanup?.()}}async function La(e,t,n){let r=await Ra(e,za(n));try{return{source:za(e.backend.resolveInstallSource?await e.backend.resolveInstallSource(t,r.source):r.source),...r.cleanup?{cleanup:r.cleanup}:{}}}catch(e){if(r.cleanup)try{await r.cleanup()}catch{}throw e}}async function Ra(e,t){if(t.kind===`url`)return{source:t};let n=await U(e,t,{usage:`admin.install`,field:`source`});return{source:{kind:`path`,path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function za(e){if(!e||typeof e!=`object`)throw new t(`INVALID_ARGS`,`install source is required`);if(e.kind===`path`)return{kind:`path`,path:J(e.path,`source.path`)};if(e.kind===`uploadedArtifact`)return{kind:`uploadedArtifact`,id:J(e.id,`source.id`)};if(e.kind===`url`){let t=J(e.url,`source.url`);return Ba(t),{kind:`url`,url:t}}throw new t(`INVALID_ARGS`,`install source kind must be path, uploadedArtifact, or url`)}function Ba(e){let n;try{n=new URL(e)}catch{throw new t(`INVALID_ARGS`,`Invalid install source URL: ${e}`)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new t(`INVALID_ARGS`,`Install source URL must use http or https`)}function Va(e){if(!e)return;let t=q(e.id,`target.id`),n=q(e.name,`target.name`),r={...t?{id:t}:{},...n?{name:n}:{},...e.platform?{platform:e.platform}:{},...e.target?{target:e.target}:{},...e.headless===void 0?{}:{headless:e.headless}};return Object.keys(r).length>0?r:void 0}function Ha(e,t,n,r){let i=S(r),a=e===`reinstall`?`appReinstalled`:e===`installFromSource`?`appInstalledFromSource`:`appInstalled`,o=Y(r,`appName`),s=Y(r,`appId`),c=Y(r,`bundleId`),l=Y(r,`packageName`),u=Y(r,`launchTarget`),d=Y(r,`installablePath`),f=Y(r,`archivePath`);return{kind:a,...t?{app:t}:{},source:n,...s?{appId:s}:{},...o?{appName:o}:{},...c?{bundleId:c}:{},...l?{packageName:l}:{},...u?{launchTarget:u}:{},...d?{installablePath:d}:{},...f?{archivePath:f}:{},...i?{backendResult:i}:{},...x(`${e===`reinstall`?`Reinstalled`:`Installed`}: ${o??u??t??Ua(n)}`)}}function Y(e,t){let n=e[t];return typeof n==`string`&&n.length>0?n:void 0}function Ua(e){return e.kind===`path`?e.path:e.kind===`uploadedArtifact`?e.id:e.url}const Wa=/^[A-Za-z0-9_.:-]{1,64}$/,Ga=async(e,n)=>{if(!e.backend.openApp)throw new t(`UNSUPPORTED_OPERATION`,`apps.open is not supported by this backend`);let r=Za(n),i=S(await e.backend.openApp(X(e,n),r,{launchArgs:n.launchArgs,relaunch:n.relaunch}));return{kind:`appOpened`,target:r,relaunch:n.relaunch===!0,...i?{backendResult:i}:{},...x(`Opened: ${$a(r)}`)}},Ka=async(e,n={})=>{if(!e.backend.closeApp)throw new t(`UNSUPPORTED_OPERATION`,`apps.close is not supported by this backend`);let r=q(n.app,`app`),i=S(await e.backend.closeApp(X(e,n),r));return{kind:`appClosed`,...r?{app:r}:{},...i?{backendResult:i}:{},...x(r?`Closed: ${r}`:`Closed app`)}},qa=async(e,n={})=>{if(!e.backend.listApps)throw new t(`UNSUPPORTED_OPERATION`,`apps.list is not supported by this backend`);return{kind:`appsList`,apps:await e.backend.listApps(X(e,n),et(n.filter))}},Ja=async(e,n)=>{if(!e.backend.getAppState)throw new t(`UNSUPPORTED_OPERATION`,`apps.state is not supported by this backend`);let r=J(n.app,`app`);return{kind:`appState`,app:r,state:await e.backend.getAppState(X(e,n),r)}},Ya=async(e,n)=>{if(!e.backend.pushFile)throw new t(`UNSUPPORTED_OPERATION`,`apps.push is not supported by this backend`);let r=J(n.app,`app`),i=await eo(e,n.input);try{let t=S(await e.backend.pushFile(X(e,n),i.backendInput,r));return{kind:`appPushed`,app:r,inputKind:i.inputKind,...t?{backendResult:t}:{},...x(`Pushed to ${r}`)}}finally{await i.cleanup?.()}},Xa=async(e,n)=>{if(!e.backend.triggerAppEvent)throw new t(`UNSUPPORTED_OPERATION`,`apps.triggerEvent is not supported by this backend`);let r=to(n.name);no(n.payload,`apps.triggerEvent payload for "${r}"`);let i=S(await e.backend.triggerAppEvent(X(e,n),{name:r,...n.payload?{payload:n.payload}:{}}));return{kind:`appEventTriggered`,name:r,...n.payload?{payload:n.payload}:{},...i?{backendResult:i}:{},...x(`Triggered app event: ${r}`)}};function Za(e){let n=q(e.app,`app`),r=q(e.appId,`appId`),i=q(e.bundleId,`bundleId`),a=q(e.packageName,`packageName`),o=q(e.url,`url`),s=q(e.activity,`activity`),c={...n?{app:n}:{},...r?{appId:r}:{},...i?{bundleId:i}:{},...a?{packageName:a}:{},...o?{url:o}:{},...s?{activity:s}:{}};if(!Qa(c))throw new t(`INVALID_ARGS`,`apps.open requires app, appId, bundleId, packageName, url, or activity`);return c}function Qa(e){return!!(e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity)}function $a(e){return e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity??`app`}async function eo(e,n){if(!n||typeof n!=`object`)throw new t(`INVALID_ARGS`,`apps.push requires an input`);if(n.kind===`json`)return ro(n.payload,`apps.push JSON payload`,8192),{backendInput:{kind:`json`,payload:n.payload},inputKind:`json`};let r=await U(e,n,{usage:`apps.push`,field:`input`});return{backendInput:{kind:`file`,path:r.path},inputKind:`file`,...r.cleanup?{cleanup:r.cleanup}:{}}}function to(e){let n=J(e,`name`);if(!Wa.test(n))throw new t(`INVALID_ARGS`,`Invalid apps.triggerEvent name: ${n}`,{hint:`Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash.`});return n}function no(e,t){e!==void 0&&ro(e,t,8192)}function ro(e,n,r){if(io(e,n),Buffer.byteLength(ao(e,n),`utf8`)>r)throw new t(`INVALID_ARGS`,`${n} exceeds ${r} bytes`)}function io(e,n){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`INVALID_ARGS`,`${n} must be a JSON object`)}function ao(e,n){try{let r=JSON.stringify(e);if(typeof r!=`string`)throw new t(`INVALID_ARGS`,`${n} must be JSON-serializable`);return r}catch{throw new t(`INVALID_ARGS`,`${n} must be JSON-serializable`)}}function X(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}const oo={open:Ga,close:Ka,list:qa,state:Ja,push:Ya,triggerEvent:Xa},so={devices:Aa,boot:ja,shutdown:Ma,install:Na,reinstall:Pa,installFromSource:Fa};function co(e){return{...C(oo,e),list:(t={})=>oo.list(e,{...t,filter:tt(t.filter)})}}const lo=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,uo=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function fo(e){let t=!1,n=e;return n=n.replaceAll(/(authorization|token|secret|password|passwd|api[-_]?key)=([^&\s]+)/gi,(e,n)=>(t=!0,`${String(n)}=[REDACTED]`)),n=n.replaceAll(/("(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)"\s*:\s*")([^"]*)(")/gi,(e,n,r,i)=>(t=!0,`${String(n)}[REDACTED]${String(i)}`)),n=n.replaceAll(/\b(Bearer\s+)([^\s",;]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`)),n=n.replaceAll(/((?:authorization|cookie|token|secret|password|passwd|api[-_]?key)\s*[:=]\s*)([^\s,;&]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`)),n=n.replaceAll(uo,()=>(t=!0,`[REDACTED]`)),n=mo(n,()=>{t=!0}),{value:n,redacted:t}}function po(e){try{let t=new URL(e),n=ho(t);return(t.username||t.password)&&(t.username=`REDACTED`,t.password=`REDACTED`,n=!0),{value:t.toString(),redacted:n}}catch{return}}function mo(e,t){return/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(e)?e.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let n=po(e);return n?(n.redacted&&t(),n.value):e}):e}function ho(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))lo.test(n)&&(e.searchParams.set(n,`[REDACTED]`),t=!0);return t}const Z=2048,go=4096,_o=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function vo(e){let t=e.redacted===!0;return{kind:`diagnosticsLogs`,entries:e.entries.map(e=>{let n=$(e.message,go),r=To(e.metadata);return t||=n.redacted||r.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.level?{level:e.level}:{},message:n.value??``,...e.source?{source:e.source}:{},...r.value?{metadata:r.value}:{}}}),...e.nextCursor?{nextCursor:e.nextCursor}:{},...e.timeWindow?{timeWindow:e.timeWindow}:{},...e.backend?{backend:e.backend}:{},redacted:t,...e.notes?{notes:e.notes}:{}}}function yo(e,t){let n=e.redacted===!0;return{kind:`diagnosticsNetwork`,entries:e.entries.map(e=>{let r=e.url?So(e.url):void 0,i=t===`headers`||t===`all`?xo(e.requestHeaders):void 0,a=t===`headers`||t===`all`?xo(e.responseHeaders):void 0,o=t===`body`||t===`all`?Co(e.requestBody):void 0,s=t===`body`||t===`all`?Co(e.responseBody):void 0,c=To(e.metadata);return n||=(r?.redacted??!1)||(i?.redacted??!1)||(a?.redacted??!1)||(o?.redacted??!1)||(s?.redacted??!1)||c.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.method?{method:e.method}:{},...r?{url:r.value}:{},...e.status===void 0?{}:{status:e.status},...e.durationMs===void 0?{}:{durationMs:e.durationMs},...i?.value?{requestHeaders:i.value}:{},...a?.value?{responseHeaders:a.value}:{},...o?.value===void 0?{}:{requestBody:o.value},...s?.value===void 0?{}:{responseBody:s.value},...c.value?{metadata:c.value}:{}}}),...e.nextCursor?{nextCursor:e.nextCursor}:{},...e.timeWindow?{timeWindow:e.timeWindow}:{},...e.backend?{backend:e.backend}:{},redacted:n,...e.notes?{notes:e.notes}:{}}}function bo(e){let t=e.redacted===!0;return{kind:`diagnosticsPerf`,metrics:e.metrics.map(e=>{let n=$(e.message,go),r=To(e.metadata);return t||=n.redacted||r.redacted,{name:e.name,...e.value===void 0?{}:{value:e.value},...e.unit?{unit:e.unit}:{},...e.status?{status:e.status}:{},...n.value===void 0?{}:{message:n.value},...r.value?{metadata:r.value}:{}}}),...e.startedAt?{startedAt:e.startedAt}:{},...e.endedAt?{endedAt:e.endedAt}:{},...e.backend?{backend:e.backend}:{},redacted:t,...e.notes?{notes:e.notes}:{}}}function xo(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[r,i]of Object.entries(e))if(_o.test(r))n[r]=`[REDACTED]`,t=!0;else{let e=$(i,Z);n[r]=e.value??``,t||=e.redacted}return{value:n,redacted:t}}function So(e){return po(e)??$(e,Z)}function Co(e){return e===void 0?{redacted:!1}:wo(e)??$(e,Z)}function wo(e){try{let t=Q(JSON.parse(e),fo);return Eo(JSON.stringify(t.value),Z,t.redacted)}catch{return}}function To(e){return Q(e,e=>$(e,Z))}function Q(e,t){if(e===void 0)return{redacted:!1};if(typeof e==`string`)return t(e);if(!e||typeof e!=`object`)return{value:e,redacted:!1};if(Array.isArray(e)){let n=!1;return{value:e.map(e=>{let r=Q(e,t);return n||=r.redacted,r.value}),redacted:n}}let n=!1,r={};for(let[i,a]of Object.entries(e)){if(_o.test(i)){r[i]=`[REDACTED]`,n=!0;continue}let e=Q(a,t);r[i]=e.value,n||=e.redacted}return{value:r,redacted:n}}function $(e,t){if(e===void 0)return{redacted:!1};let n=fo(e);return Eo(n.value,t,n.redacted)}function Eo(e,t,n){if(e===void 0)return{redacted:n};let r=e;return r.length>t&&(r=`${r.slice(0,t)}...[truncated]`,n=!0),{value:r,redacted:n}}const Do=async(e,n={})=>{if(!e.backend.readLogs)throw new t(`UNSUPPORTED_OPERATION`,`diagnostics.logs is not supported by this backend`);return vo(await e.backend.readLogs(await Ao(e,n),jo(n)))},Oo=async(e,n={})=>{if(!e.backend.dumpNetwork)throw new t(`UNSUPPORTED_OPERATION`,`diagnostics.network is not supported by this backend`);let r=Mo(n);return yo(await e.backend.dumpNetwork(await Ao(e,n),r),r.include??`summary`)},ko=async(e,n={})=>{if(!e.backend.measurePerf)throw new t(`UNSUPPORTED_OPERATION`,`diagnostics.perf is not supported by this backend`);return bo(await e.backend.measurePerf(await Ao(e,n),No(n)))};async function Ao(e,t){let n=g(e,t),r=t.session?await e.sessions.get(t.session):void 0;return{...n,...t.appId??r?.appId?{appId:t.appId??r?.appId}:{},...t.appBundleId??r?.appBundleId?{appBundleId:t.appBundleId??r?.appBundleId}:{}}}function jo(e){return{...Po(e,100,500,`logs limit`),...e.levels===void 0?{}:{levels:Lo(e.levels,`levels`)},...e.search===void 0?{}:{search:J(e.search,`search`)},...e.source===void 0?{}:{source:J(e.source,`source`)}}}function Mo(e){return{...Po(e,25,200,`network limit`),include:Io(e.include)}}function No(e){return{...Fo(e),...e.sampleMs===void 0?{}:{sampleMs:T(e.sampleMs,`sampleMs`,100,6e4)},...e.metrics===void 0?{}:{metrics:Lo(e.metrics,`metrics`,20)}}}function Po(e,t,n,r){return{...Fo(e),...e.cursor===void 0?{}:{cursor:J(e.cursor,`cursor`)},limit:e.limit===void 0?t:T(e.limit,r,1,n)}}function Fo(e){return{...e.since===void 0?{}:{since:J(e.since,`since`)},...e.until===void 0?{}:{until:J(e.until,`until`)}}}function Io(e){if(e===void 0)return`summary`;if(e===`summary`||e===`headers`||e===`body`||e===`all`)return e;throw new t(`INVALID_ARGS`,`network include must be summary, headers, body, or all`)}function Lo(e,n,r=50){if(!Array.isArray(e))throw new t(`INVALID_ARGS`,`${n} must be an array of strings`);if(e.length>r)throw new t(`INVALID_ARGS`,`${n} must contain at most ${r} entries`);return e.map((e,t)=>J(e,`${n}[${t}]`))}const Ro={logs:Do,network:Oo,perf:ko},zo=async(e,n)=>{let r=Go(n.action,`record`),i=r===`start`?e.backend.startRecording:e.backend.stopRecording;if(!i)throw new t(`UNSUPPORTED_OPERATION`,`record ${r} is not supported by this backend`);let a=n.out?await W(e,n.out,{field:`path`,ext:`.mp4`,artifactType:`screen-recording`}):void 0;try{let t=Vo(n,a?.path);return Ko(r,await i.call(e.backend,g(e,n),t),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}},Bo=async(e,n)=>{let r=Go(n.action,`trace`),i=r===`start`?e.backend.startTrace:e.backend.stopTrace;if(!i)throw new t(`UNSUPPORTED_OPERATION`,`trace ${r} is not supported by this backend`);let a=n.out?await W(e,n.out,{field:`outPath`,ext:`.trace`,artifactType:`trace-log`}):void 0;try{let t={...a?.path?{outPath:a.path}:{}};return qo(r,await i.call(e.backend,g(e,n),t),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}};function Vo(e,t){let n={};t&&(n.outPath=t);let r=Ho(e.fps);r!==void 0&&(n.fps=r);let i=Uo(e.maxSize);i!==void 0&&(n.maxSize=i);let a=Wo(e.quality);return a!==void 0&&(n.quality=a),e.hideTouches!==void 0&&(n.showTouches=e.hideTouches!==!0),n}function Ho(e){return e===void 0?void 0:T(e,`fps`,1,60)}function Uo(e){return e===void 0?void 0:T(e,`maxSize`,1,2**53-1)}function Wo(e){if(e===void 0)return;let n=xe(e);if(n===void 0)throw new t(`INVALID_ARGS`,`quality must be one of: medium, high (legacy numeric values 5-10 are accepted)`);return n}function Go(e,n){if(e===`start`||e===`stop`)return e;throw new t(`INVALID_ARGS`,`${n} action must be start or stop`)}function Ko(e,t,n){return{...typeof t.path==`string`?{path:t.path}:{},...typeof t.telemetryPath==`string`?{telemetryPath:t.telemetryPath}:{},...typeof t.warning==`string`?{warning:t.warning}:{},...Jo(e,t,n,{startKind:`recordingStarted`,stopKind:`recordingStopped`,startMessage:`Recording started`,stopMessage:`Recording stopped`})}}function qo(e,t,n){return{...typeof t.outPath==`string`?{outPath:t.outPath}:{},...Jo(e,t,n,{startKind:`traceStarted`,stopKind:`traceStopped`,startMessage:`Trace started`,stopMessage:`Trace stopped`})}}function Jo(e,t,n,r){return{kind:e===`start`?r.startKind:r.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...x(e===`start`?r.startMessage:r.stopMessage)}}const Yo={record:zo,trace:Bo},Xo=async(e,n={})=>{if(!e.backend.pressBack)throw new t(`UNSUPPORTED_OPERATION`,`system.back is not supported by this backend`);let r=n.mode??`in-app`;if(r!==`in-app`&&r!==`system`)throw new t(`INVALID_ARGS`,`system.back mode must be in-app or system`);let i=S(await e.backend.pressBack(g(e,n),{mode:r}));return{kind:`systemBack`,mode:r,...i?{backendResult:i}:{},...x(`Back`)}},Zo=async(e,n={})=>{if(!e.backend.pressHome)throw new t(`UNSUPPORTED_OPERATION`,`system.home is not supported by this backend`);let r=S(await e.backend.pressHome(g(e,n)));return{kind:`systemHome`,...r?{backendResult:r}:{},...x(`Home`)}},Qo=async(e,n)=>{if(!e.backend.pressTvRemote)throw new t(`UNSUPPORTED_OPERATION`,`system.tvRemote is not supported by this backend`);let r=pe(n.button),i=n.durationMs===void 0?void 0:T(n.durationMs,`durationMs`,0,1e4),a=S(await e.backend.pressTvRemote(g(e,n),{button:r,...i===void 0?{}:{durationMs:i}}));return{kind:`tvRemotePressed`,button:r,...i===void 0?{}:{durationMs:i},...a?{backendResult:a}:{},...x(`Pressed TV remote ${r}`)}},$o=async(e,n)=>{if(!e.backend.setOrientation)throw new t(`UNSUPPORTED_OPERATION`,`system.orientation is not supported by this backend`);let r=as(n.orientation),i=S(await e.backend.setOrientation(g(e,n),r));return{kind:`systemOrientationSet`,orientation:r,...i?{backendResult:i}:{},...x(`Rotated to ${r}`)}},es=async(e,n={})=>{if(!e.backend.setKeyboard)throw new t(`UNSUPPORTED_OPERATION`,`system.keyboard is not supported by this backend`);let r=n.action??`status`;if(!Oe(r))throw new t(`INVALID_ARGS`,`system.keyboard action must be status, get, dismiss, enter, or return`);let i=await e.backend.setKeyboard(g(e,n),{action:r}),a=S(i),o=ps(i)?i:{};return r===`enter`||r===`return`?ss(o,a):r===`dismiss`?cs(r,o,a):ls(r,o,a)},ts=async(e,n)=>{if(n.action===`read`){if(!e.backend.getClipboard)throw new t(`UNSUPPORTED_OPERATION`,`system.clipboard read is not supported by this backend`);let r=await e.backend.getClipboard(g(e,n));return{kind:`clipboardText`,action:`read`,text:typeof r==`string`?r:r.text}}if(n.action!==`write`)throw new t(`INVALID_ARGS`,`system.clipboard action must be read or write`);if(!e.backend.setClipboard)throw new t(`UNSUPPORTED_OPERATION`,`system.clipboard write is not supported by this backend`);if(typeof n.text!=`string`)throw new t(`INVALID_ARGS`,`system.clipboard write requires text`);let r=S(await e.backend.setClipboard(g(e,n),n.text));return{kind:`clipboardUpdated`,action:`write`,textLength:Array.from(n.text).length,...r?{backendResult:r}:{},...x(`Clipboard updated`)}},ns=async(e,n={})=>{if(!e.backend.openSettings)throw new t(`UNSUPPORTED_OPERATION`,`system.settings is not supported by this backend`);let r=q(n.target,`target`),i=S(await e.backend.openSettings(g(e,n),r));return{kind:`settingsOpened`,...r?{target:r}:{},...i?{backendResult:i}:{},...x(r?`Opened settings: ${r}`:`Opened settings`)}},rs=async(e,n={})=>{if(!e.backend.handleAlert)throw new t(`UNSUPPORTED_OPERATION`,`system.alert is not supported by this backend`);let r=n.action??`get`;if(r!==`get`&&r!==`accept`&&r!==`dismiss`&&r!==`wait`)throw new t(`INVALID_ARGS`,`system.alert action must be get, accept, dismiss, or wait`);let i=n.timeoutMs===void 0?void 0:T(n.timeoutMs,`timeoutMs`,0,12e4);return os(r,await e.backend.handleAlert(g(e,n),r,{timeoutMs:i}))},is=async(e,n={})=>{if(!e.backend.openAppSwitcher)throw new t(`UNSUPPORTED_OPERATION`,`system.appSwitcher is not supported by this backend`);let r=S(await e.backend.openAppSwitcher(g(e,n)));return{kind:`appSwitcherOpened`,...r?{backendResult:r}:{},...x(`Opened app switcher`)}};function as(e){switch(e){case`portrait`:case`portrait-upside-down`:case`landscape-left`:case`landscape-right`:return e;default:throw new t(`INVALID_ARGS`,`system.orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right`)}}function os(e,t){return e===`get`?us(t):e===`wait`?ds(t):fs(e,t)}function ss(e,t){return{kind:`keyboardEnterPressed`,action:`enter`,state:e,...t?{backendResult:t}:{},...x(`Keyboard enter pressed`)}}function cs(e,t,n){return{kind:`keyboardDismissed`,action:e,state:t,...n?{backendResult:n}:{},...x(t.dismissed===!1?`Keyboard already hidden`:`Keyboard dismissed`)}}function ls(e,t,n){return{kind:`keyboardState`,action:e,state:t,...n?{backendResult:n}:{}}}function us(e){if(e.kind!==`alertStatus`)throw new t(`COMMAND_FAILED`,`system.alert get returned an invalid backend result`);return{kind:`alertStatus`,action:`get`,alert:e.alert}}function ds(e){if(e.kind!==`alertWait`)throw new t(`COMMAND_FAILED`,`system.alert wait returned an invalid backend result`);return{kind:`alertWait`,action:`wait`,alert:e.alert,...e.waitedMs===void 0?{}:{waitedMs:e.waitedMs},...e.timedOut===void 0?{}:{timedOut:e.timedOut},...x(e.alert?`Alert visible`:`Alert wait timed out`)}}function fs(e,n){if(n.kind!==`alertHandled`)throw new t(`COMMAND_FAILED`,`system.alert ${e} returned an invalid backend result`);return{kind:`alertHandled`,action:e,handled:n.handled,...n.alert?{alert:n.alert}:{},...n.button?{button:n.button}:{},...x(n.handled?`Alert ${e}ed`:`No alert handled`)}}function ps(e){return!!(e&&typeof e==`object`)}const ms={back:Xo,home:Zo,orientation:$o,keyboard:es,clipboard:ts,settings:ns,alert:rs,appSwitcher:is,tvRemote:Qo};function hs(e){return{capture:C(Vi,e),selectors:Oa(e),interactions:ka(e),system:C(ms,e),apps:co(e),admin:C(so,e),recording:C(Yo,e),observability:C(Ro,e)}}var gs=e({createAgentDevice:()=>_s,createMemorySessionStore:()=>vs,localCommandPolicy:()=>xs,restrictedCommandPolicy:()=>Ss});function _s(e){let t={backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??vs(),policy:e.policy??Ss(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal};return{...t,...hs(t)}}function vs(e=[]){let t=new Map(e.map(e=>[e.name,ys(e)]));return{get:e=>ys(t.get(e)),set:e=>{t.set(e.name,ys(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>ys(e))}}function ys(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:bs(e.metadata)}:{}}}function bs(e){try{return structuredClone(e)}catch{return{...e}}}function xs(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,...e}}function Ss(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,...e}}export{pi as a,P as c,Qt as d,_t as f,Pt as g,jt as h,vi as i,fn as l,yt as m,xs as n,mn as o,vt as p,gs as r,N as s,_s as t,pn as u};

package/dist/src/runtime2.js

@@ -1 +1 @@
-import{_ as e}from"./sdk-contracts.js";import{p as t,v as n}from"./sdk-android-adb.js";import{n as r}from"./version.js";import{t as i}from"./timeouts.js";import{d as a}from"./logcat.js";import{Cn as o,En as s,Tn as c,wn as l}from"./internal/daemon.js";import{n as u}from"./android.js";import d from"node:fs";import f from"node:os";import p from"node:path";import m from"@limrun/api";import{createInstanceClient as h}from"@limrun/api/instance-client";import{createInstanceClient as g}from"@limrun/api/ios-client";function _(e){return e?.trim()||void 0}async function v(e){let t=await h({apiUrl:e.apiUrl,adbUrl:e.adbUrl,token:e.token,logLevel:`warn`}),n={platform:`android`,lease:e.lease,instanceId:e.instanceId,device:e.device,client:t},r={exec:async(e,t)=>await w(n,e,t),text:async e=>{await t.setText(e.target,e.text)}},{createAndroidPortReverseManager:i}=await import(`./sdk-android-adb.js`).then(e=>e.t);return r.reverse=i(r),Object.assign(n,{adbProvider:r})}function y(e){return u(e.device,e.adbProvider)}async function b(e,t,n,r){let i=_(r?.packageNameHint);r?.relaunch&&i&&await w(t,[`shell`,`am`,`force-stop`,i],{allowFailure:!0});let a=await e.assets.getOrUpload({path:n,name:A(i,n)});await t.client.sendAsset(a.signedDownloadUrl);let o=i?(await import(`./app-lifecycle.js`).then(e=>e.t)).inferAndroidAppName(i):void 0;return{...i?{packageName:i,launchTarget:i}:{},...o?{appName:o}:{}}}async function x(e,t){await e.adbProvider.reverse?.ensure({local:k(t.devicePort),remote:k(t.hostPort),ownerId:t.name})}async function S(e){await e.adbTunnelPromise?.catch(()=>{});let t=e.adbSerial;t&&(await C(e),await n(`adb`,[`disconnect`,t],{allowFailure:!0,timeoutMs:1e4}).catch(()=>{})),e.adbTunnel?.close(),e.adbTunnel=void 0,e.adbSerial=void 0,e.adbTunnelPromise=void 0}async function C(e){let t=e.adbProvider.reverse;if(!t?.list)return;let n=await t.list().catch(()=>[]),r=new Set,i=[];for(let e of n)e.ownerId?r.add(e.ownerId):i.push(e.local);await Promise.allSettled([...[...r].map(async e=>await t.removeAllOwned(e)),...i.map(async e=>await t.remove(e))])}async function w(e,t,n){let{adbArgs:r,result:i}=await T(e,t,n);return await E(r,i,n?.allowFailure)}async function T(e,t,r){let i=[`-s`,await D(e),...t];return{adbArgs:i,result:await n(`adb`,i,{allowFailure:r?.allowFailure,binaryStdout:r?.binaryStdout,stdin:r?.stdin,timeoutMs:r?.timeoutMs??3e4,signal:r?.signal})}}async function E(e,t,n){if(t.exitCode!==0&&n!==!0){let{androidAdbResultError:n}=await import(`./sdk-android-adb.js`).then(e=>e.t);throw n(`Limrun Android ADB command failed`,t,{command:[`adb`,...e].join(` `)})}return t}async function D(e){if(e.adbSerial)return e.adbSerial;let t=e.adbTunnelPromise??O(e);e.adbTunnelPromise=t;try{return await t}catch(n){throw e.adbTunnelPromise===t&&(e.adbTunnelPromise=void 0),n}}async function O(e){let t=await e.client.startAdbTunnel(),n=`${t.address.address}:${t.address.port}`;return e.adbTunnel=t,e.adbSerial=n,n}function k(t){if(!Number.isInteger(t)||t<1||t>65535)throw new e(`INVALID_ARGS`,`Invalid Android tcp reverse port: ${t}`);return`tcp:${t}`}function A(e,t){let n=p.extname(t)||`.apk`;return`${e?.replace(/[^a-zA-Z0-9_.-]+/g,`-`)||`android-app`}${n}`}function j(e){let t=Array.isArray(e)?e:[e],n=[],r=(e,t,i)=>{let a=n.length;n.push(M(e,{index:a,depth:t,parentIndex:i}));for(let n of R(e))r(n,t+1,a)};for(let e of t)r(e,0);return n}function M(e,t){return{index:t.index,type:N(e),role:P(e),label:F(e),value:I(e),identifier:L(e),rect:ee(e),enabled:e.enabled,selected:e.selected,hittable:e.hittable,depth:t.depth,parentIndex:t.parentIndex}}function N(e){return e.elementType??e.type}function P(e){return e.role??N(e)}function F(e){return e.label??e.AXLabel??void 0}function I(e){return e.value??e.AXValue??void 0}function L(e){return e.identifier??e.AXUniqueId??void 0}function ee(e){let t=e.rect??e.frame;if(!(!t||typeof t.x!=`number`||typeof t.y!=`number`||typeof t.width!=`number`||typeof t.height!=`number`))return{x:t.x,y:t.y,width:t.width,height:t.height}}function R(e){return e.children??e.nodes??e.elements??[]}function z(e){return e.key===`id`?{accessibilityId:e.value}:e.key===`value`?{value:e.value}:{label:e.value}}async function B(e,t){d.mkdirSync(p.dirname(e),{recursive:!0}),await d.promises.writeFile(e,Buffer.from(t,`base64`))}async function V(e){let t=await g({apiUrl:e.apiUrl,token:e.token,logLevel:`warn`});return{platform:`ios`,lease:e.lease,instanceId:e.instanceId,device:e.device,client:t}}async function H(e,t,n,r){let i=await G(n);try{let n=await e.assets.getOrUpload({path:i.uploadPath,name:i.assetName}),a=_((await t.client.installApp(n.signedDownloadUrl,{md5:n.md5,launchMode:r?.relaunch?`RelaunchIfRunning`:`ForegroundIfRunning`})).bundleId)??r?.appIdentifierHint;return{...a?{bundleId:a,launchTarget:a}:{},...i.appName?{appName:i.appName}:{}}}finally{await i.cleanup()}}function U(e){return new W(e)}var W=class{session;constructor(e){this.session=e}async open(e,t){if(t?.url){await this.session.client.launchApp(await K(e)),await this.session.client.openUrl(t.url);return}if(a(e)){await this.session.client.openUrl(e);return}await this.session.client.launchApp(await K(e))}async openDevice(){}async close(e){e&&await this.session.client.terminateApp(await K(e)).catch(()=>{})}async tap(e,t){await this.session.client.tap(e,t)}async tapElementSelector(e){await this.session.client.tapElement(z(e))}async doubleTap(e,t){await this.tap(e,t),await this.tap(e,t)}async longPress(){throw Y(`longpress`,`Limrun iOS direct sessions do not expose long press yet.`)}async focus(e,t){await this.tap(e,t)}async type(e,t){if(t&&t>0){for(let n of Array.from(e))await this.session.client.typeText(n),await i(t);return}await this.session.client.typeText(e)}async fill(e,t,n){await this.tap(e,t),await this.session.client.typeText(n)}async fillElementSelector(e,t){await this.session.client.setElementValue(t,z(e))}async scroll(e,t){await this.session.client.scroll(e,t?.pixels??300)}async screenshot(e){await B(e,(await this.session.client.screenshot()).base64)}async snapshot(e){let t=await this.session.client.elementTree();return{nodes:j(JSON.parse(t)),backend:`xctest`}}async back(){await this.session.client.pressKey(`escape`)}async home(){throw Y(`home`,`Limrun iOS direct sessions do not expose home yet.`)}async setOrientation(e){if(e===`portrait-upside-down`)throw Y(`orientation`,`Limrun iOS direct sessions support portrait and landscape orientation, not portrait upside-down.`);await this.session.client.setOrientation(e===`portrait`?`Portrait`:`Landscape`)}async performGesture(){throw Y(`gesture`,`Limrun iOS direct sessions do not expose portable gesture execution yet.`)}async appSwitcher(){throw Y(`app-switcher`,`Limrun iOS direct sessions do not expose app switcher yet.`)}async tvRemote(){throw Y(`tv-remote`,`Limrun iOS direct sessions do not expose tv remote control.`)}async readClipboard(){throw Y(`clipboard`,`Limrun iOS direct sessions do not expose clipboard read yet.`)}async writeClipboard(){throw Y(`clipboard`,`Limrun iOS direct sessions do not expose clipboard write yet.`)}async setSetting(){throw Y(`settings`,`Limrun iOS direct sessions do not expose settings changes yet.`)}};async function G(r){if(!(await d.promises.stat(r)).isDirectory())return{uploadPath:r,assetName:p.basename(r),appName:q(r),cleanup:async()=>{}};let i=await d.promises.mkdtemp(p.join(f.tmpdir(),`agent-device-limrun-ios-app-`)),a=p.join(i,`${p.basename(r)}.zip`),o=await n(`zip`,[`-qr`,a,p.basename(r)],{cwd:p.dirname(r),timeoutMs:12e4});if(o.exitCode!==0)throw await d.promises.rm(i,{recursive:!0,force:!0}),new e(`COMMAND_FAILED`,`Failed to package iOS .app for Limrun install`,{command:[`zip`,`-qr`,a,p.basename(r)].join(` `),...t(o)});return{uploadPath:a,assetName:p.basename(a),appName:await J(r),cleanup:async()=>{await d.promises.rm(i,{recursive:!0,force:!0})}}}async function K(e){let{resolveIosAppAlias:t}=await import(`./app-resolution.js`).then(e=>e.t);return t(e)}function q(e){return p.basename(e).replace(/\.(?:app|ipa|apk|aab|zip)$/i,``)||void 0}async function J(e){let{readIosBundleInfo:t}=await import(`./install-artifact.js`).then(e=>e.t);return(await t(e)).appName??q(e)}function Y(t,n){throw new e(`UNSUPPORTED_OPERATION`,n,{command:t})}const X=`agent-device-cli`;function Z(e){let t=e.LIMRUN_API_KEY?.trim();if(t)return new Q({apiKey:t,region:e.LIMRUN_REGION?.trim()||void 0,version:r()})}var Q=class{limrun;sessions=new Map;options;provider=o;leaseLifecycle={allocate:async e=>await this.allocate(e),release:async e=>await this.release(e)};recoverExpiredLease=async t=>{if(t.leaseProvider!==this.provider||!s(t.backend))throw new e(`UNSUPPORTED_OPERATION`,`Limrun cannot recover this expired lease.`,{leaseId:t.leaseId,leaseProvider:t.leaseProvider,leaseBackend:t.backend});await this.release(t)};deviceInventoryProvider=async e=>{if(e.leaseProvider!==this.provider||!e.leaseId)return null;let t=this.sessions.get(e.leaseId);return t?e.platform&&e.platform!==t.platform?[]:[t.device]:null};constructor(e){this.options=e,this.limrun=new m({apiKey:e.apiKey,defaultHeaders:{"x-agent-device-client":X,"x-agent-device-version":e.version??r()}})}ownsDevice(e){return c(e.id)!==void 0}getInteractor(e){let t=this.getSessionForDevice(e);if(t)return t.platform===`ios`?U(t):y(t)}async installApp(e,t,n,r){return await this.installInstallablePath(e,n,{...r,appIdentifierHint:r?.appIdentifierHint??t,packageNameHint:r?.packageNameHint??t})}async installInstallablePath(e,t,n){let r=this.getSessionForDevice(e);if(r)return r.platform===`ios`?await H(this.limrun,r,t,n):await b(this.limrun,r,t,n)}async configurePortReverse(e){let t=this.requireAndroidPortReverseSession(e.leaseId);if(t)return await x(t,e),$(e)}async shutdown(){let e=[...this.sessions.values()];await Promise.allSettled(e.map(async e=>await this.terminateSession(e))),this.sessions.clear()}async allocate(e){if(e.leaseProvider!==this.provider)return;let t=s(e.backend);if(!t)return;let n=this.sessions.get(e.leaseId);if(n)return{limrunInstanceId:n.instanceId,device:n.device};let r=t===`ios`?await this.createIosSession(e):await this.createAndroidSession(e);return this.sessions.set(e.leaseId,r),{limrunInstanceId:r.instanceId,device:r.device}}async createIosSession(t){let n=await this.limrun.iosInstances.create({wait:!0,metadata:this.buildInstanceMetadata(t),spec:this.options.region?{region:this.options.region}:{}});try{if(!n.status.apiUrl)throw new e(`COMMAND_FAILED`,`Limrun iOS instance did not expose apiUrl`);return await V({lease:t,instanceId:n.metadata.id,device:l(`ios`,t,n.metadata.id),apiUrl:n.status.apiUrl,token:n.status.token})}catch(e){throw await this.limrun.iosInstances.delete(n.metadata.id).catch(()=>{}),e}}async createAndroidSession(t){let n=await this.limrun.androidInstances.create({wait:!0,metadata:this.buildInstanceMetadata(t),spec:this.options.region?{region:this.options.region}:{}});try{if(!n.status.apiUrl||!n.status.adbWebSocketUrl)throw new e(`COMMAND_FAILED`,`Limrun Android instance did not expose API and ADB websocket endpoints`);return await v({lease:t,instanceId:n.metadata.id,device:l(`android`,t,n.metadata.id),apiUrl:n.status.apiUrl,adbUrl:n.status.adbWebSocketUrl,token:n.status.token})}catch(e){throw await this.limrun.androidInstances.delete(n.metadata.id).catch(()=>{}),e}}buildInstanceMetadata(e){return{displayName:`agent-device-${e.tenantId}-${e.runId}`,labels:{tenantId:e.tenantId,runId:e.runId,leaseId:e.leaseId,provider:e.leaseProvider??`limrun`,source:X}}}async release(e){let t=this.sessions.get(e.leaseId);return t?(await this.terminateSession(t),this.sessions.delete(e.leaseId),{limrunInstanceId:t.instanceId}):await this.releaseRecoveredSession(e)}async releaseRecoveredSession(e){let t=s(e.backend);if(!t)return;let n=`provider=${o},leaseId=${e.leaseId}`,r=(t===`ios`?await this.limrun.iosInstances.list({labelSelector:n}):await this.limrun.androidInstances.list({labelSelector:n})).getPaginatedItems().map(e=>e.metadata.id);for(let e of r)t===`ios`?await this.limrun.iosInstances.delete(e):await this.limrun.androidInstances.delete(e);if(r.length!==0)return{limrunInstanceId:r[0],limrunInstanceCount:r.length}}async terminateSession(e){if(e.client.disconnect(),e.platform===`ios`){await this.limrun.iosInstances.delete(e.instanceId);return}await S(e),await this.limrun.androidInstances.delete(e.instanceId)}getSessionForDevice(e){let t=c(e.id);if(!t)return;let n=this.sessions.get(t.leaseId);return n?.platform===t.platform?n:void 0}requireAndroidPortReverseSession(e){let t=this.sessions.get(e);if(!t||t.platform===`android`)return t;throw te(`port reverse`,`Direct Limrun iOS sessions cannot reach local host ports; use a bridge public URL.`)}};function $(e){return{leaseId:e.leaseId,devicePort:e.devicePort,hostPort:e.hostPort,name:e.name}}function te(t,n){throw new e(`UNSUPPORTED_OPERATION`,n,{command:t})}export{Z as createLimrunRuntimeFromEnv};
+import{_ as e}from"./sdk-contracts.js";import{p as t,v as n}from"./sdk-android-adb.js";import{n as r}from"./version.js";import{t as i}from"./timeouts.js";import{d as a}from"./logcat.js";import{An as o,Dn as s,On as c,kn as l}from"./internal/daemon.js";import{n as u}from"./android.js";import d from"node:fs";import f from"node:os";import p from"node:path";import m from"@limrun/api";import{createInstanceClient as h}from"@limrun/api/instance-client";import{createInstanceClient as g}from"@limrun/api/ios-client";function _(e){return e?.trim()||void 0}async function v(e){let t=await h({apiUrl:e.apiUrl,adbUrl:e.adbUrl,token:e.token,logLevel:`warn`}),n={platform:`android`,lease:e.lease,instanceId:e.instanceId,device:e.device,client:t},r={exec:async(e,t)=>await w(n,e,t),text:async e=>{await t.setText(e.target,e.text)}},{createAndroidPortReverseManager:i}=await import(`./sdk-android-adb.js`).then(e=>e.t);return r.reverse=i(r),Object.assign(n,{adbProvider:r})}function y(e){return u(e.device,e.adbProvider)}async function b(e,t,n,r){let i=_(r?.packageNameHint);r?.relaunch&&i&&await w(t,[`shell`,`am`,`force-stop`,i],{allowFailure:!0});let a=await e.assets.getOrUpload({path:n,name:A(i,n)});await t.client.sendAsset(a.signedDownloadUrl);let o=i?(await import(`./app-lifecycle.js`).then(e=>e.t)).inferAndroidAppName(i):void 0;return{...i?{packageName:i,launchTarget:i}:{},...o?{appName:o}:{}}}async function x(e,t){await e.adbProvider.reverse?.ensure({local:k(t.devicePort),remote:k(t.hostPort),ownerId:t.name})}async function S(e){await e.adbTunnelPromise?.catch(()=>{});let t=e.adbSerial;t&&(await C(e),await n(`adb`,[`disconnect`,t],{allowFailure:!0,timeoutMs:1e4}).catch(()=>{})),e.adbTunnel?.close(),e.adbTunnel=void 0,e.adbSerial=void 0,e.adbTunnelPromise=void 0}async function C(e){let t=e.adbProvider.reverse;if(!t?.list)return;let n=await t.list().catch(()=>[]),r=new Set,i=[];for(let e of n)e.ownerId?r.add(e.ownerId):i.push(e.local);await Promise.allSettled([...[...r].map(async e=>await t.removeAllOwned(e)),...i.map(async e=>await t.remove(e))])}async function w(e,t,n){let{adbArgs:r,result:i}=await T(e,t,n);return await E(r,i,n?.allowFailure)}async function T(e,t,r){let i=[`-s`,await D(e),...t];return{adbArgs:i,result:await n(`adb`,i,{allowFailure:r?.allowFailure,binaryStdout:r?.binaryStdout,stdin:r?.stdin,timeoutMs:r?.timeoutMs??3e4,signal:r?.signal})}}async function E(e,t,n){if(t.exitCode!==0&&n!==!0){let{androidAdbResultError:n}=await import(`./sdk-android-adb.js`).then(e=>e.t);throw n(`Limrun Android ADB command failed`,t,{command:[`adb`,...e].join(` `)})}return t}async function D(e){if(e.adbSerial)return e.adbSerial;let t=e.adbTunnelPromise??O(e);e.adbTunnelPromise=t;try{return await t}catch(n){throw e.adbTunnelPromise===t&&(e.adbTunnelPromise=void 0),n}}async function O(e){let t=await e.client.startAdbTunnel(),n=`${t.address.address}:${t.address.port}`;return e.adbTunnel=t,e.adbSerial=n,n}function k(t){if(!Number.isInteger(t)||t<1||t>65535)throw new e(`INVALID_ARGS`,`Invalid Android tcp reverse port: ${t}`);return`tcp:${t}`}function A(e,t){let n=p.extname(t)||`.apk`;return`${e?.replace(/[^a-zA-Z0-9_.-]+/g,`-`)||`android-app`}${n}`}function j(e){let t=Array.isArray(e)?e:[e],n=[],r=(e,t,i)=>{let a=n.length;n.push(M(e,{index:a,depth:t,parentIndex:i}));for(let n of R(e))r(n,t+1,a)};for(let e of t)r(e,0);return n}function M(e,t){return{index:t.index,type:N(e),role:P(e),label:F(e),value:I(e),identifier:L(e),rect:ee(e),enabled:e.enabled,selected:e.selected,hittable:e.hittable,depth:t.depth,parentIndex:t.parentIndex}}function N(e){return e.elementType??e.type}function P(e){return e.role??N(e)}function F(e){return e.label??e.AXLabel??void 0}function I(e){return e.value??e.AXValue??void 0}function L(e){return e.identifier??e.AXUniqueId??void 0}function ee(e){let t=e.rect??e.frame;if(!(!t||typeof t.x!=`number`||typeof t.y!=`number`||typeof t.width!=`number`||typeof t.height!=`number`))return{x:t.x,y:t.y,width:t.width,height:t.height}}function R(e){return e.children??e.nodes??e.elements??[]}function z(e){return e.key===`id`?{accessibilityId:e.value}:e.key===`value`?{value:e.value}:{label:e.value}}async function B(e,t){d.mkdirSync(p.dirname(e),{recursive:!0}),await d.promises.writeFile(e,Buffer.from(t,`base64`))}async function V(e){let t=await g({apiUrl:e.apiUrl,token:e.token,logLevel:`warn`});return{platform:`ios`,lease:e.lease,instanceId:e.instanceId,device:e.device,client:t}}async function H(e,t,n,r){let i=await G(n);try{let n=await e.assets.getOrUpload({path:i.uploadPath,name:i.assetName}),a=_((await t.client.installApp(n.signedDownloadUrl,{md5:n.md5,launchMode:r?.relaunch?`RelaunchIfRunning`:`ForegroundIfRunning`})).bundleId)??r?.appIdentifierHint;return{...a?{bundleId:a,launchTarget:a}:{},...i.appName?{appName:i.appName}:{}}}finally{await i.cleanup()}}function U(e){return new W(e)}var W=class{session;constructor(e){this.session=e}async open(e,t){if(t?.url){await this.session.client.launchApp(await K(e)),await this.session.client.openUrl(t.url);return}if(a(e)){await this.session.client.openUrl(e);return}await this.session.client.launchApp(await K(e))}async openDevice(){}async close(e){e&&await this.session.client.terminateApp(await K(e)).catch(()=>{})}async tap(e,t){await this.session.client.tap(e,t)}async tapElementSelector(e){await this.session.client.tapElement(z(e))}async doubleTap(e,t){await this.tap(e,t),await this.tap(e,t)}async longPress(){throw Y(`longpress`,`Limrun iOS direct sessions do not expose long press yet.`)}async focus(e,t){await this.tap(e,t)}async type(e,t){if(t&&t>0){for(let n of Array.from(e))await this.session.client.typeText(n),await i(t);return}await this.session.client.typeText(e)}async fill(e,t,n){await this.tap(e,t),await this.session.client.typeText(n)}async fillElementSelector(e,t){await this.session.client.setElementValue(t,z(e))}async scroll(e,t){await this.session.client.scroll(e,t?.pixels??300)}async screenshot(e){await B(e,(await this.session.client.screenshot()).base64)}async snapshot(e){let t=await this.session.client.elementTree();return{nodes:j(JSON.parse(t)),backend:`xctest`}}async back(){await this.session.client.pressKey(`escape`)}async home(){throw Y(`home`,`Limrun iOS direct sessions do not expose home yet.`)}async setOrientation(e){if(e===`portrait-upside-down`)throw Y(`orientation`,`Limrun iOS direct sessions support portrait and landscape orientation, not portrait upside-down.`);await this.session.client.setOrientation(e===`portrait`?`Portrait`:`Landscape`)}async performGesture(){throw Y(`gesture`,`Limrun iOS direct sessions do not expose portable gesture execution yet.`)}async appSwitcher(){throw Y(`app-switcher`,`Limrun iOS direct sessions do not expose app switcher yet.`)}async tvRemote(){throw Y(`tv-remote`,`Limrun iOS direct sessions do not expose tv remote control.`)}async readClipboard(){throw Y(`clipboard`,`Limrun iOS direct sessions do not expose clipboard read yet.`)}async writeClipboard(){throw Y(`clipboard`,`Limrun iOS direct sessions do not expose clipboard write yet.`)}async setSetting(){throw Y(`settings`,`Limrun iOS direct sessions do not expose settings changes yet.`)}};async function G(r){if(!(await d.promises.stat(r)).isDirectory())return{uploadPath:r,assetName:p.basename(r),appName:q(r),cleanup:async()=>{}};let i=await d.promises.mkdtemp(p.join(f.tmpdir(),`agent-device-limrun-ios-app-`)),a=p.join(i,`${p.basename(r)}.zip`),o=await n(`zip`,[`-qr`,a,p.basename(r)],{cwd:p.dirname(r),timeoutMs:12e4});if(o.exitCode!==0)throw await d.promises.rm(i,{recursive:!0,force:!0}),new e(`COMMAND_FAILED`,`Failed to package iOS .app for Limrun install`,{command:[`zip`,`-qr`,a,p.basename(r)].join(` `),...t(o)});return{uploadPath:a,assetName:p.basename(a),appName:await J(r),cleanup:async()=>{await d.promises.rm(i,{recursive:!0,force:!0})}}}async function K(e){let{resolveIosAppAlias:t}=await import(`./app-resolution.js`).then(e=>e.t);return t(e)}function q(e){return p.basename(e).replace(/\.(?:app|ipa|apk|aab|zip)$/i,``)||void 0}async function J(e){let{readIosBundleInfo:t}=await import(`./install-artifact.js`).then(e=>e.t);return(await t(e)).appName??q(e)}function Y(t,n){throw new e(`UNSUPPORTED_OPERATION`,n,{command:t})}const X=`agent-device-cli`;function Z(e){let t=e.LIMRUN_API_KEY?.trim();if(t)return new Q({apiKey:t,region:e.LIMRUN_REGION?.trim()||void 0,version:r()})}var Q=class{limrun;sessions=new Map;options;provider=s;leaseLifecycle={allocate:async e=>await this.allocate(e),release:async e=>await this.release(e)};recoverExpiredLease=async t=>{if(t.leaseProvider!==this.provider||!o(t.backend))throw new e(`UNSUPPORTED_OPERATION`,`Limrun cannot recover this expired lease.`,{leaseId:t.leaseId,leaseProvider:t.leaseProvider,leaseBackend:t.backend});await this.release(t)};deviceInventoryProvider=async e=>{if(e.leaseProvider!==this.provider||!e.leaseId)return null;let t=this.sessions.get(e.leaseId);return t?e.platform&&e.platform!==t.platform?[]:[t.device]:null};constructor(e){this.options=e,this.limrun=new m({apiKey:e.apiKey,defaultHeaders:{"x-agent-device-client":X,"x-agent-device-version":e.version??r()}})}ownsDevice(e){return l(e.id)!==void 0}getInteractor(e){let t=this.getSessionForDevice(e);if(t)return t.platform===`ios`?U(t):y(t)}async installApp(e,t,n,r){return await this.installInstallablePath(e,n,{...r,appIdentifierHint:r?.appIdentifierHint??t,packageNameHint:r?.packageNameHint??t})}async installInstallablePath(e,t,n){let r=this.getSessionForDevice(e);if(r)return r.platform===`ios`?await H(this.limrun,r,t,n):await b(this.limrun,r,t,n)}async configurePortReverse(e){let t=this.requireAndroidPortReverseSession(e.leaseId);if(t)return await x(t,e),$(e)}async shutdown(){let e=[...this.sessions.values()];await Promise.allSettled(e.map(async e=>await this.terminateSession(e))),this.sessions.clear()}async allocate(e){if(e.leaseProvider!==this.provider)return;let t=o(e.backend);if(!t)return;let n=this.sessions.get(e.leaseId);if(n)return{limrunInstanceId:n.instanceId,device:n.device};let r=t===`ios`?await this.createIosSession(e):await this.createAndroidSession(e);return this.sessions.set(e.leaseId,r),{limrunInstanceId:r.instanceId,device:r.device}}async createIosSession(t){let n=await this.limrun.iosInstances.create({wait:!0,metadata:this.buildInstanceMetadata(t),spec:this.options.region?{region:this.options.region}:{}});try{if(!n.status.apiUrl)throw new e(`COMMAND_FAILED`,`Limrun iOS instance did not expose apiUrl`);return await V({lease:t,instanceId:n.metadata.id,device:c(`ios`,t,n.metadata.id),apiUrl:n.status.apiUrl,token:n.status.token})}catch(e){throw await this.limrun.iosInstances.delete(n.metadata.id).catch(()=>{}),e}}async createAndroidSession(t){let n=await this.limrun.androidInstances.create({wait:!0,metadata:this.buildInstanceMetadata(t),spec:this.options.region?{region:this.options.region}:{}});try{if(!n.status.apiUrl||!n.status.adbWebSocketUrl)throw new e(`COMMAND_FAILED`,`Limrun Android instance did not expose API and ADB websocket endpoints`);return await v({lease:t,instanceId:n.metadata.id,device:c(`android`,t,n.metadata.id),apiUrl:n.status.apiUrl,adbUrl:n.status.adbWebSocketUrl,token:n.status.token})}catch(e){throw await this.limrun.androidInstances.delete(n.metadata.id).catch(()=>{}),e}}buildInstanceMetadata(e){return{displayName:`agent-device-${e.tenantId}-${e.runId}`,labels:{tenantId:e.tenantId,runId:e.runId,leaseId:e.leaseId,provider:e.leaseProvider??`limrun`,source:X}}}async release(e){let t=this.sessions.get(e.leaseId);return t?(await this.terminateSession(t),this.sessions.delete(e.leaseId),{limrunInstanceId:t.instanceId}):await this.releaseRecoveredSession(e)}async releaseRecoveredSession(e){let t=o(e.backend);if(!t)return;let n=`provider=${s},leaseId=${e.leaseId}`,r=(t===`ios`?await this.limrun.iosInstances.list({labelSelector:n}):await this.limrun.androidInstances.list({labelSelector:n})).getPaginatedItems().map(e=>e.metadata.id);for(let e of r)t===`ios`?await this.limrun.iosInstances.delete(e):await this.limrun.androidInstances.delete(e);if(r.length!==0)return{limrunInstanceId:r[0],limrunInstanceCount:r.length}}async terminateSession(e){if(e.client.disconnect(),e.platform===`ios`){await this.limrun.iosInstances.delete(e.instanceId);return}await S(e),await this.limrun.androidInstances.delete(e.instanceId)}getSessionForDevice(e){let t=l(e.id);if(!t)return;let n=this.sessions.get(t.leaseId);return n?.platform===t.platform?n:void 0}requireAndroidPortReverseSession(e){let t=this.sessions.get(e);if(!t||t.platform===`android`)return t;throw te(`port reverse`,`Direct Limrun iOS sessions cannot reach local host ports; use a bridge public URL.`)}};function $(e){return{leaseId:e.leaseId,devicePort:e.devicePort,hostPort:e.hostPort,name:e.name}}function te(t,n){throw new e(`UNSUPPORTED_OPERATION`,n,{command:t})}export{Z as createLimrunRuntimeFromEnv};

package/dist/src/sdk-android-adb.d.ts

@@ -1,28 +1,6 @@
-import { A as Point, j as Rect } from "./sdk-contracts.js";
+import { E as Rect, T as Point } from "./sdk-contracts.js";
 import { Readable, Writable } from "node:stream";
 import { StdioOptions, spawn } from "node:child_process";
-//#region src/platforms/android/snapshot-types.d.ts
-type AndroidSnapshotBackendMetadata = {
-  backend: 'android-helper';
-  helperVersion?: string;
-  helperApiVersion?: string;
-  helperTransport?: AndroidSnapshotHelperTransport;
-  helperSessionReused?: boolean;
-  installReason?: AndroidSnapshotHelperInstallReason;
-  waitForIdleTimeoutMs?: number;
-  waitForIdleQuietMs?: number;
-  timeoutMs?: number;
-  maxDepth?: number;
-  maxNodes?: number;
-  rootPresent?: boolean;
-  captureMode?: AndroidSnapshotCaptureMode;
-  systemSurfaceOnly?: boolean;
-  windowCount?: number;
-  nodeCount?: number;
-  helperTruncated?: boolean;
-  elapsedMs?: number;
-};
-//#endregion
 //#region src/platforms/android/snapshot-helper-types.d.ts
 type AndroidSnapshotHelperTransport = 'instrumentation' | 'persistent-session';
 type AndroidSnapshotCaptureMode = 'interactive-windows' | 'active-window';
@@ -227,4 +205,4 @@ type AndroidTouchCapabilities = {
 type AndroidAdbProvider = AndroidAdbProviderBase & AndroidTouchCapabilities;
 declare function createAndroidPortReverseManager(provider: AndroidAdbProvider | AndroidAdbExecutor): AndroidPortReverseProvider;
 //#endregion
-export { GesturePointerCount as a, SwipePreset as c, createAndroidPortReverseManager as i, TransformGestureParams as l, AndroidAdbExecutorOptions as n, ScrollDirection as o, AndroidPortReverseEndpoint as r, SwipePattern as s, AndroidAdbExecutor as t, AndroidSnapshotBackendMetadata as u };
+export { GesturePointerCount as a, SwipePreset as c, AndroidSnapshotHelperInstallReason as d, AndroidSnapshotHelperTransport as f, createAndroidPortReverseManager as i, TransformGestureParams as l, AndroidAdbExecutorOptions as n, ScrollDirection as o, AndroidPortReverseEndpoint as r, SwipePattern as s, AndroidAdbExecutor as t, AndroidSnapshotCaptureMode as u };

package/dist/src/sdk-android-adb.js

@@ -1,4 +1,4 @@
-import{t as e}from"./rolldown-runtime.js";import{T as t,_ as n}from"./sdk-contracts.js";import{AsyncLocalStorage as r}from"node:async_hooks";import i from"node:crypto";import a,{constants as o}from"node:fs";import s from"node:os";import c from"node:path";import{pipeline as l}from"node:stream/promises";import{Readable as u}from"node:stream";import{access as d,stat as f}from"node:fs/promises";import{spawn as p,spawnSync as m}from"node:child_process";const h=new r;function g(){return i.randomBytes(8).toString(`hex`)}function ee(){return`${Date.now().toString(36)}-${i.randomBytes(4).toString(`hex`)}`}async function te(e,t){let n={...e,diagnosticId:ee(),events:[],liveWrittenEventCount:0,phaseCounts:new Map};return await h.run(n,t)}function ne(e){let t=h.getStore();t&&Object.assign(t,e)}function re(){let e=h.getStore();return e?{diagnosticId:e.diagnosticId,requestId:e.requestId,session:e.session,command:e.command,debug:e.debug,flushOnSuccess:e.flushOnSuccess}:{}}function ie(e){let t=h.getStore();if(!t)return 0;let n=0;for(let r of e)n+=t.phaseCounts.get(r)??0;return n}function _(e){let n=h.getStore();if(!n)return;let r={ts:new Date().toISOString(),level:e.level??`info`,phase:e.phase,session:n.session,requestId:n.requestId,command:n.command,durationMs:e.durationMs,data:e.data?t(e.data):void 0};if(n.events.push(r),n.phaseCounts.set(e.phase,(n.phaseCounts.get(e.phase)??0)+1),!n.debug)return;let i=`${JSON.stringify(r)}\n`;try{n.logPath&&(v(n.logPath,i),n.liveWrittenEventCount=n.events.length),n.traceLogPath&&v(n.traceLogPath,i),!n.logPath&&!n.traceLogPath&&process.stderr.write(`[agent-device][diag] ${i}`)}catch{}}async function ae(e,t,n){let r=Date.now();try{let i=await t();return _({level:`info`,phase:e,durationMs:Date.now()-r,data:n}),i}catch(t){throw _({level:`error`,phase:e,durationMs:Date.now()-r,data:{...n??{},error:t instanceof Error?t.message:String(t)}}),t}}function oe(e={}){let n=h.getStore();if(!n||!e.force&&!n.debug&&!n.flushOnSuccess||n.events.length===0)return null;try{if(n.logPath){let e=n.events.slice(n.liveWrittenEventCount);if(e.length>0){let r=e.map(e=>JSON.stringify(t(e)));v(n.logPath,`${r.join(`
-`)}\n`)}let r=n.logPath;return n.events=[],n.liveWrittenEventCount=0,r}let e=se(n.session??`default`),r=new Date().toISOString().slice(0,10),i=c.join(s.homedir(),`.agent-device`,`logs`,e,r);a.mkdirSync(i,{recursive:!0});let o=new Date().toISOString().replace(/[:.]/g,`-`),l=c.join(i,`${o}-${n.diagnosticId}.ndjson`),u=n.events.map(e=>JSON.stringify(t(e)));return a.writeFileSync(l,`${u.join(`
-`)}\n`),n.events=[],l}catch{return null}}function se(e){return e.replace(/[^a-zA-Z0-9._-]/g,`_`)}function v(e,t){a.mkdirSync(c.dirname(e),{recursive:!0}),a.appendFileSync(e,t,`utf8`)}const ce=new Set([`1`,`true`,`yes`,`on`]),le=new Set([`0`,`false`,`no`,`off`]);function ue(e){return`AGENT_DEVICE_${e.replace(/([A-Z])/g,`_$1`).replace(/[^A-Za-z0-9_]/g,`_`).toUpperCase()}`}function de(e,t,r,i){if(e.multiple)return(Array.isArray(t)?t:[t]).map(t=>de({...e,multiple:!1},t,r,i));if(e.type===`boolean`)return fe(t,r,i);if(e.type===`booleanOrString`){if(typeof t==`boolean`)return t;if(typeof t==`string`&&y(t)!==void 0)return y(t);if(typeof t==`string`&&t.trim().length>0)return t;throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected boolean or non-empty string.`)}if(e.type===`string`){if(typeof t==`string`&&t.trim().length>0)return t;throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected non-empty string.`)}if(e.type===`enum`){if(e.setValue!==void 0)return pe(e,t,r,i);if(typeof t!=`string`||!e.enumValues?.includes(t))throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected one of: ${e.enumValues?.join(`, `)}.`);return t}let a=typeof t==`number`?t:typeof t==`string`?Number(t):NaN;if(!Number.isFinite(a)||!Number.isInteger(a))throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected integer.`);if(typeof e.min==`number`&&a<e.min)throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Must be >= ${e.min}.`);if(typeof e.max==`number`&&a>e.max)throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Must be <= ${e.max}.`);return a}function fe(e,t,r){if(typeof e==`boolean`)return e;if(typeof e==`string`){let t=y(e);if(t!==void 0)return t}throw new n(`INVALID_ARGS`,`Invalid value for "${r}" in ${t}. Expected boolean.`)}function y(e){let t=e.trim().toLowerCase();if(ce.has(t))return!0;if(le.has(t))return!1}function pe(e,t,r,i){let a=e.setValue;if(t===a)return a;if(typeof t==`string`){let e=t.trim();if(e===``||e===`true`||e===`1`)return a;if(e===`false`||e===`0`)return}if(t===!0)return a;if(t!==!1)throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected boolean-like value for enum flag.`)}const me=/^[A-Za-z0-9][A-Za-z0-9._+-]*$/,he=[`.com`,`.exe`,`.bat`,`.cmd`],b=new r;async function ge(e,t){return e?await b.run(e,t):await t()}async function x(e){return await b.run(void 0,e)}async function S(e,t,n={}){let r=b.getStore()?.(e,t,n);return r?C(await r):await w(e,t,n)}async function _e(e,t,n={}){let r=b.getStore()?.(e,t,n);return r?C(await r):await w(e,t,n)}function C(e){let t=typeof e.stdout==`string`?e.stdout:String(e.stdout??``),n=typeof e.stderr==`string`?e.stderr:String(e.stderr??``),r=typeof e.exitCode==`number`?e.exitCode:1;return t===e.stdout&&n===e.stderr&&r===e.exitCode?e:{...e,stdout:t,stderr:n,exitCode:r}}function w(e,t,n={}){let r=k(e),i=D();return new Promise((a,o)=>{let s=p(r,t,{cwd:n.cwd,env:n.env,stdio:[`pipe`,`pipe`,`pipe`],detached:n.detached,windowsHide:!0,shell:!1});n.onSpawn?.(s);let c=``,l=n.binaryStdout?[]:void 0,u=``,d=!1,f=V(n.timeoutMs),m=f?setTimeout(()=>{d=!0,U(s,n.detached)},f):null,h=H(s,n);n.binaryStdout||s.stdout.setEncoding(`utf8`),s.stderr.setEncoding(`utf8`),Ae(s,n.stdin).catch(i=>{h.didAbort||d||je(i)||(o(Te(r,e,t,i)),U(s,n.detached))}),s.stdout.on(`data`,e=>{if(n.binaryStdout){l?.push(Buffer.isBuffer(e)?e:Buffer.from(e));return}let t=String(e);c+=t,n.onStdoutChunk?.(t)}),s.stderr.on(`data`,e=>{let t=String(e);u+=t,n.onStderrChunk?.(t)}),s.on(`error`,n=>{m&&clearTimeout(m),h.dispose(),i.emitForegroundCompletion(e,t),o(F(h,r,e,t,n))}),s.on(`close`,s=>{m&&clearTimeout(m),h.dispose(),i.emitForegroundCompletion(e,t);let p=s??1;if(!h.didAbort&&d&&f){o(Ee(r,e,t,f,p,c,u));return}let g=I(h,r,e,t,p,n.allowFailure,c,u);if(g){o(g);return}a({stdout:c,stderr:u,exitCode:p,stdoutBuffer:l?Buffer.concat(l):void 0})})})}async function ve(e){let t=R(e);if(!t)return!1;if(c.isAbsolute(t))return z(t);let n=process.env.PATH;if(!n)return!1;let r=Oe();for(let e of n.split(c.delimiter)){let n=e.trim();if(n){for(let e of ke(t,r))if(await z(c.join(n,e)))return!0}}return!1}async function ye(e,t){let r=L(e,t,`executable`);if(r){if(!await z(r))throw new n(`TOOL_MISSING`,`${t} points to a missing or non-executable file: ${r}`,{envName:t,path:r});return r}}async function be(e,t){let r=L(e,t,`file`);if(r){if(!await B(r))throw new n(`TOOL_MISSING`,`${t} points to a missing or non-file path: ${r}`,{envName:t,path:r});return r}}function xe(e,t,r={}){let i=k(e),a=m(i,t,{cwd:r.cwd,env:r.env,stdio:[`pipe`,`pipe`,`pipe`],encoding:r.binaryStdout?void 0:`utf8`,input:r.stdin,timeout:V(r.timeoutMs),windowsHide:!0,shell:!1,...r.maxBuffer===void 0?{}:{maxBuffer:r.maxBuffer}});if(a.error){let o=a.error.code;throw o===`ETIMEDOUT`?new n(`COMMAND_FAILED`,`${i} timed out after ${V(r.timeoutMs)}ms`,{cmd:e,args:t,timeoutMs:V(r.timeoutMs)},a.error):o===`ENOENT`?A(i,e,a.error):j(i,e,t,a.error)}let o=r.binaryStdout?Buffer.isBuffer(a.stdout)?a.stdout:Buffer.from(a.stdout??``):void 0,s=r.binaryStdout?``:typeof a.stdout==`string`?a.stdout:(a.stdout??``).toString(),c=typeof a.stderr==`string`?a.stderr:(a.stderr??``).toString(),l=a.status??1;if(l!==0&&!r.allowFailure)throw N(i,e,t,l,s,c);return{stdout:s,stderr:c,exitCode:l,stdoutBuffer:o}}function Se(e,t,n={}){return T(e,t,n).pid}function T(e,t,n={}){let r=p(k(e),t,{cwd:n.cwd,env:n.env,stdio:n.stdio??`ignore`,detached:!0,windowsHide:!0,shell:!1}),i=r.pid??0,a=new Promise(e=>{r.once(`error`,t=>{e({pid:i,error:t.message})}),r.once(`exit`,(t,n)=>{e({pid:i,...typeof t==`number`?{exitCode:t}:{},...n?{signal:n}:{}})})});return r.unref(),{pid:i,exited:a}}function E(e,t,n={}){let r=k(e),i=D(),a=p(r,t,{cwd:n.cwd,env:n.env,stdio:n.stdio??[`ignore`,`pipe`,`pipe`],detached:n.detached,windowsHide:!0,shell:!1});i.emitBackgroundSpawn(e,t);let o=``,s=``,c=n.captureOutput??!0,l=H(a,n);return c&&(a.stdout?.setEncoding(`utf8`),a.stderr?.setEncoding(`utf8`),a.stdout?.on(`data`,e=>{o+=e}),a.stderr?.on(`data`,e=>{s+=e})),{child:a,wait:new Promise((c,u)=>{a.on(`error`,n=>{l.dispose(),i.emitBackgroundCompletion(e,t,`error`),u(F(l,r,e,t,n))}),a.on(`close`,a=>{l.dispose(),i.emitBackgroundCompletion(e,t,`exit`);let d=a??1,f=I(l,r,e,t,d,n.allowFailure,o,s);if(f){u(f);return}c({stdout:o,stderr:s,exitCode:d})})})}}function D(){let e=re(),t=e.debug===!0,n=y(process.env.AGENT_DEVICE_EXEC_TRACE??``)===!0;if(!t&&!n)return Ce();n&&e.flushOnSuccess!==!0&&ne({flushOnSuccess:!0});let r=Date.now(),i=!1;return{emitForegroundCompletion:(e,t)=>{i||(i=!0,O({cmd:e,args:t,startedAtMs:r}))},emitBackgroundSpawn:(e,t)=>{O({cmd:e,args:t,data:{event:`spawn`}})},emitBackgroundCompletion:(e,t,n)=>{i||(i=!0,O({cmd:e,args:t,startedAtMs:r,data:{event:n}}))}}}function Ce(){return{emitForegroundCompletion:()=>{},emitBackgroundSpawn:()=>{},emitBackgroundCompletion:()=>{}}}function O(e){let t=e.args.slice(0,6);_({level:`debug`,phase:`exec_command`,durationMs:e.startedAtMs===void 0?void 0:Math.max(0,Date.now()-e.startedAtMs),data:{command:e.cmd,argsPrefix:t,...e.args.length>t.length?{omittedArgCount:e.args.length-t.length}:{},...e.data??{}}})}function k(e){let t=R(e);if(!t)throw new n(`INVALID_ARGS`,`Invalid executable command: ${JSON.stringify(e)}`,{cmd:e,hint:`Use a bare command name from PATH or an absolute executable path.`});return t}function we(e,t,n,r){return r.code===`ENOENT`?A(e,t,r):j(e,t,n,r)}function A(e,t,r){return new n(`TOOL_MISSING`,`${e} not found in PATH`,{cmd:t},r)}function j(e,t,r,i){return new n(`COMMAND_FAILED`,`Failed to run ${e}`,{cmd:t,args:r},i)}function Te(e,t,r,i){return new n(`COMMAND_FAILED`,`Failed to write stdin for ${e}`,{cmd:t,args:r},i instanceof Error?i:void 0)}function M(e,t,r){return new n(`COMMAND_FAILED`,`request canceled`,{cmd:t,args:r,executable:e,reason:`request_canceled`})}function Ee(e,t,r,i,a,o,s){return new n(`COMMAND_FAILED`,`${e} timed out after ${i}ms`,{cmd:t,args:r,stdout:o,stderr:s,exitCode:a,timeoutMs:i})}function N(e,t,r,i,a,o){return new n(`COMMAND_FAILED`,`${e} exited with code ${i}`,P({stdout:a,stderr:o,exitCode:i},{cmd:t,args:r}))}function De(e,t,r){if(e.exitCode===0)return e;throw new n(`COMMAND_FAILED`,t,P(e,typeof r==`function`?r(e):r))}function P(e,t){return{stdout:e.stdout,stderr:e.stderr,exitCode:e.exitCode,processExitError:!0,...t}}function F(e,t,n,r,i){return e.didAbort?M(t,n,r):we(t,n,r,i)}function I(e,t,n,r,i,a,o,s){return e.didAbort?M(t,n,r):i!==0&&!a?N(t,n,r,i,o,s):null}function L(e,t,r){let i=e?.trim();if(i){if(!c.isAbsolute(i)||i.includes(`\0`))throw new n(`INVALID_ARGS`,`${t} must be an absolute ${r} path, not ${JSON.stringify(e)}`,{envName:t,path:e});return i}}function R(e){let t=e.trim();return!t||t.includes(`\0`)?null:c.isAbsolute(t)?t:t.includes(`/`)||t.includes(`\\`)?null:me.test(t)?t:null}function Oe(){if(process.platform!==`win32`)return[``];let e=process.env.PATHEXT;if(!e)return he;let t=e.split(`;`).map(e=>e.trim().toLowerCase()).filter(e=>e.length>0);return t.length>0?t:he}function ke(e,t){if(process.platform!==`win32`)return[e];let n=e.toLowerCase();return t.some(e=>n.endsWith(e))?[e]:t.map(t=>`${e}${t}`)}async function z(e){try{return await B(e)?(await d(e,process.platform===`win32`?o.F_OK:o.X_OK),!0):!1}catch{return!1}}async function B(e){try{return(await f(e)).isFile()}catch{return!1}}function V(e){if(!Number.isFinite(e))return;let t=Math.floor(e);if(!(t<=0))return t}function H(e,t){let n=!1,r=()=>{n=!0,U(e,t.detached)};return t.signal?.aborted?r():t.signal?.addEventListener(`abort`,r,{once:!0}),{get didAbort(){return n},dispose:()=>{t.signal?.removeEventListener(`abort`,r)}}}function U(e,t){if(t&&e.pid&&process.platform!==`win32`)try{process.kill(-e.pid,`SIGKILL`);return}catch{}e.kill(`SIGKILL`)}async function Ae(e,t){if(e.stdin){if(t===void 0){e.stdin?.end();return}await l(u.from([t]),e.stdin)}}function je(e){return e instanceof Error&&`code`in e&&e.code===`EPIPE`}var Me=e({androidAdbResultError:()=>q,attachAdbFailureHint:()=>K,classifyAdbFailure:()=>G,createAndroidPortReverseManager:()=>Ue,createDeviceAdbExecutor:()=>X,createLocalAndroidAdbProvider:()=>Be,installAndroidAdbPackage:()=>Ge,pullAndroidAdbFile:()=>We,resolveAndroidAdbExecutor:()=>Ve,resolveAndroidAdbProvider:()=>Z,resolveAndroidTextInjector:()=>He,resolveAndroidTouchProvider:()=>Q,withAndroidAdbProvider:()=>qe});const W=new r,Ne=[{reason:`device_unauthorized`,pattern:/device unauthorized|device still authorizing/,hint:`USB debugging is not authorized — accept the authorization prompt on the device screen (re-plug the cable if none appears), then retry.`},{reason:`device_offline`,pattern:/device offline/,hint:`The device is connected but offline — wait for it to finish booting or run adb reconnect, then retry.`,retriable:!0},{reason:`multiple_devices`,pattern:/more than one (?:device\/emulator|device and emulator)/,hint:`Multiple Android devices are connected — pass --serial <serial> (see adb devices) to select one.`},{reason:`no_devices`,pattern:/no devices\/emulators found|no devices found/,hint:`No Android devices detected — boot an emulator or connect a device and verify it appears in adb devices.`},{reason:`device_not_found`,pattern:/device (?:'[^']*' )?not found/,hint:`The device disconnected or is restarting — verify it is listed in adb devices, then retry.`,retriable:!0},{reason:`server_version_mismatch`,pattern:/adb server version \(\d+\) doesn't match this client/,hint:`Multiple adb installs conflict — adb restarts its server automatically, so retry; align PATH to a single adb to stop recurrences.`,retriable:!0},{reason:`connection_dropped`,pattern:/transport error|connection reset|broken pipe|protocol fault/,hint:`The adb connection dropped — retry; if it persists, run adb kill-server and reconnect the device.`,retriable:!0},{reason:`install_insufficient_storage`,pattern:/install_failed_insufficient_storage/,hint:`The device is out of storage — free up space or uninstall unused apps, then retry the install.`,matchStdout:!0},{reason:`install_update_incompatible`,pattern:/install_failed_update_incompatible/,hint:`The installed app has an incompatible signature — uninstall the existing app first, then retry the install.`,matchStdout:!0},{reason:`install_version_downgrade`,pattern:/install_failed_version_downgrade/,hint:`The APK is older than the installed app — uninstall the app first (or install with downgrade allowed), then retry.`,matchStdout:!0},{reason:`install_failed`,pattern:/install_failed_\w+|install_parse_failed_\w+/,hint:`The Android package installer rejected the APK — see the INSTALL_FAILED code in the error output for the exact cause.`,matchStdout:!0}],Pe={reason:`timeout`,hint:`adb timed out — the adb server may be wedged. Run adb kill-server && adb start-server, check adb devices, then retry.`};function G(e,t=``){let n=e.toLowerCase(),r=t.toLowerCase();for(let{pattern:e,matchStdout:t,...i}of Ne)if(e.test(n)||t&&e.test(r))return i}function K(e){if(!(e instanceof n)||e.code!==`COMMAND_FAILED`)return e;let t=Fe(e);return t&&(e.details={...e.details,adbFailure:t.reason,...typeof e.details?.hint==`string`?{}:{hint:t.hint},...t.retriable!==void 0&&e.details?.retriable===void 0?{retriable:t.retriable}:{}}),e}function Fe(e){return typeof e.details?.timeoutMs==`number`?Pe:G(typeof e.details?.stderr==`string`?e.details.stderr:``,typeof e.details?.stdout==`string`?e.details.stdout:``)}function q(e,t,r){return K(new n(`COMMAND_FAILED`,e,t.exitCode===0?{stdout:t.stdout,stderr:t.stderr,exitCode:t.exitCode,...r}:P(t,r)))}function J(e){return async(...t)=>{try{return await e(...t)}catch(e){throw K(e)}}}const Ie=new WeakSet;function Le(e){if(Ie.has(e))return e;let t={...e,exec:J(Y(e.exec)),...e.pull?{pull:J(Y(e.pull))}:{},...e.install?{install:J(Y(e.install))}:{},...e.installBundle?{installBundle:J(e.installBundle)}:{}};return Ie.add(t),t}function Y(e){return async(...t)=>C(await e(...t))}function X(e){return Re(e.id)}function Re(e){return J(async(t,n)=>await x(async()=>await S(`adb`,[`-s`,e,...t],{...n,detached:process.platform!==`win32`})))}function ze(e){return(t,n)=>{let r=E(`adb`,[`-s`,e,...t],{...n,allowFailure:!0,captureOutput:!1});return r.wait.catch(()=>{}),r.child}}function Be(e){let t=X(e);return{exec:t,spawn:ze(e.id),reverse:Ze(t),pull:async(e,n,r)=>await t([`pull`,e,n],r),install:async(e,n)=>{let{installArgs:r,execOptions:i}=et(n);return await t([`install`,...r,e],i)}}}function Ve(e,t){let n=W.getStore();return t||(n?.serial===e.id?n.provider.exec:X(e))}function Z(e,t){if(t)return $(t);let n=W.getStore();return n?.serial===e.id?$(n.provider):Be(e)}function He(e){let t=W.getStore();return t?.serial===e.id?t.provider.text:void 0}function Q(e){let t=W.getStore();return t?.serial===e.id&&t.provider.touch?t.provider:void 0}function Ue(e){let t=$(e);if(t.reverse&&Xe.has(t.reverse))return t.reverse;let r=t.reverse??Ze(t.exec),i=new Map,a={async ensure(e,t){let a=i.get(e.local);if(a&&a.ownerId!==e.ownerId)throw new n(`COMMAND_FAILED`,`Android port reverse ${e.local} is already owned by ${a.ownerId??`another session`}`,{current:a,requested:e});a?.remote!==e.remote&&(await r.ensure(e,t),i.set(e.local,{...e}))},async remove(e,t){if(!i.has(e)){await r.remove(e,t);return}await r.remove(e,t),i.delete(e)},async removeAllOwned(e,t){let n=[...i.values()].filter(t=>t.ownerId===e).map(e=>e.local);if(n.length===0){await r.removeAllOwned(e,t);return}for(let e of n)await r.remove(e,t),i.delete(e)},async list(e){return r.list?await r.list(e):[...i.values()]}};return Xe.add(a),a}function $(e){return Le(typeof e==`function`?{exec:e}:e)}async function We(e,t,r){let{device:i,provider:a,...o}=r??{},s=Ke(i,a),c=s?.pull;if(c)return await x(async()=>await c(e,t,o));let l=s?.exec;if(!l)throw new n(`COMMAND_FAILED`,`Android adb pull requires an adb provider`);return await x(async()=>await l([`pull`,e,t],o))}async function Ge(e,t){let{device:r,provider:i,...a}=t??{},o=Ke(r,i),s=o?.install;if(s)return await x(async()=>await s(e,a));let c=o?.exec;if(!c)throw new n(`COMMAND_FAILED`,`Android adb install requires an adb provider`);let{installArgs:l,execOptions:u}=et(a);return await x(async()=>await c([`install`,...l,e],u))}function Ke(e,t){if(t)return $(t);if(e)return Z(e);let n=W.getStore();if(n)return $(n.provider)}async function qe(e,t,n){if(!e)return await n();let r={provider:$(e),serial:t.serial},i=Je(r);return await W.run(r,async()=>await ge(i,n))}function Je(e){return(t,n,r)=>{if(t!==`adb`)return;let i=Ye(n,e.serial);if(i)return x(async()=>await e.provider.exec(i,r))}}function Ye(e,t){if(!(e[0]!==`-s`||!e[1])&&e[1]===t)return e.slice(2)}const Xe=new WeakSet;function Ze(e){let t=new Map;return{async ensure(n,r){if(await e([`reverse`,n.local,n.remote],{allowFailure:!1,signal:r?.signal,timeoutMs:r?.timeoutMs}),n.ownerId){let e=t.get(n.ownerId)??new Set;e.add(n.local),t.set(n.ownerId,e)}},async remove(n,r){let i=await e([`reverse`,`--remove`,n],{allowFailure:!0,signal:r?.signal,timeoutMs:r?.timeoutMs});if(i.exitCode!==0&&!$e(i.stdout,i.stderr))throw q(`Failed to remove Android port reverse ${n}`,i,{local:n});for(let e of t.values())e.delete(n)},async removeAllOwned(e,n){let r=[...t.get(e)??[]];for(let e of r)await this.remove(e,n);t.delete(e)},async list(n){let r=await e([`reverse`,`--list`],{allowFailure:!0,signal:n?.signal,timeoutMs:n?.timeoutMs});return r.exitCode===0?Qe(r.stdout,t):[]}}}function Qe(e,t){let n=new Map;for(let[e,r]of t)for(let t of r)n.set(t,e);return e.split(`
-`).map(e=>e.trim().split(/\s+/)).filter(e=>e.length>=3).map(([,e,t])=>{let r=e;return{local:r,remote:t,ownerId:n.get(r)}})}function $e(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`listener`)&&n.includes(`not found`)}function et(e){let{replace:t,allowTestPackages:n,allowDowngrade:r,grantPermissions:i,...a}=e??{},o=[];return t&&o.push(`-r`),n&&o.push(`-t`),r&&o.push(`-d`),i&&o.push(`-g`),{installArgs:o,execOptions:a}}export{g as A,xe as C,y as D,ue as E,ae as F,te as I,oe as M,re as N,de as O,ne as P,_e as S,x as T,be as _,Ge as a,Se as b,Z as c,qe as d,C as f,ye as g,De as h,Ue as i,_ as j,ie as k,He as l,z as m,q as n,We as o,P as p,K as r,Ve as s,Me as t,Q as u,S as v,ve as w,T as x,E as y};
+import{t as e}from"./rolldown-runtime.js";import{T as t,_ as n}from"./sdk-contracts.js";import{AsyncLocalStorage as r}from"node:async_hooks";import i from"node:crypto";import a,{constants as o}from"node:fs";import s from"node:os";import c from"node:path";import{pipeline as l}from"node:stream/promises";import{Readable as u}from"node:stream";import{access as d,stat as f}from"node:fs/promises";import{spawn as p,spawnSync as m}from"node:child_process";const h=new r;function g(){return i.randomBytes(8).toString(`hex`)}function ee(){return`${Date.now().toString(36)}-${i.randomBytes(4).toString(`hex`)}`}async function te(e,t){let n={...e,diagnosticId:ee(),events:[],liveWrittenEventCount:0,phaseCounts:new Map,sensitiveValues:new Set};return await h.run(n,t)}function _(e){let t=h.getStore();t&&Object.assign(t,e)}function ne(){let e=h.getStore();return e?{diagnosticId:e.diagnosticId,requestId:e.requestId,session:e.session,command:e.command,debug:e.debug,flushOnSuccess:e.flushOnSuccess}:{}}function re(e){e&&h.getStore()?.sensitiveValues.add(e)}function ie(e){let t=h.getStore();if(!t)return 0;let n=0;for(let r of e)n+=t.phaseCounts.get(r)??0;return n}function v(e){let t=h.getStore();if(!t)return;let n={ts:new Date().toISOString(),level:e.level??`info`,phase:e.phase,session:t.session,requestId:t.requestId,command:t.command,durationMs:e.durationMs,data:e.data?y(t,e.data):void 0};if(t.events.push(n),t.phaseCounts.set(e.phase,(t.phaseCounts.get(e.phase)??0)+1),!t.debug&&!t.traceLogPath)return;let r=`${JSON.stringify(n)}\n`;try{t.debug&&t.logPath&&(x(t.logPath,r),t.liveWrittenEventCount=t.events.length),t.traceLogPath&&x(t.traceLogPath,r),t.debug&&!t.logPath&&!t.traceLogPath&&process.stderr.write(`[agent-device][diag] ${r}`)}catch{}}async function ae(e,t,n){let r=Date.now();try{let i=await t();return v({level:`info`,phase:e,durationMs:Date.now()-r,data:n}),i}catch(t){throw v({level:`error`,phase:e,durationMs:Date.now()-r,data:{...n??{},error:t instanceof Error?t.message:String(t)}}),t}}function oe(e={}){let t=h.getStore();if(!t||!e.force&&!t.debug&&!t.flushOnSuccess||t.events.length===0)return null;try{if(t.logPath){let e=t.events.slice(t.liveWrittenEventCount);if(e.length>0){let n=e.map(e=>JSON.stringify(y(t,e)));x(t.logPath,`${n.join(`
+`)}\n`)}let n=t.logPath;return t.events=[],t.liveWrittenEventCount=0,n}let e=se(t.session??`default`),n=new Date().toISOString().slice(0,10),r=c.join(s.homedir(),`.agent-device`,`logs`,e,n);a.mkdirSync(r,{recursive:!0});let i=new Date().toISOString().replace(/[:.]/g,`-`),o=c.join(r,`${i}-${t.diagnosticId}.ndjson`),l=t.events.map(e=>JSON.stringify(y(t,e)));return a.writeFileSync(o,`${l.join(`
+`)}\n`),t.events=[],o}catch{return null}}function y(e,n){return b(t(n),[...e.sensitiveValues].sort((e,t)=>t.length-e.length))}function b(e,t){return typeof e==`string`?t.reduce((e,t)=>e.replaceAll(t,`[REDACTED]`),e):Array.isArray(e)?e.map(e=>b(e,t)):!e||typeof e!=`object`?e:Object.fromEntries(Object.entries(e).map(([e,n])=>[e,b(n,t)]))}function se(e){return e.replace(/[^a-zA-Z0-9._-]/g,`_`)}function x(e,t){a.mkdirSync(c.dirname(e),{recursive:!0}),a.appendFileSync(e,t,`utf8`)}const ce=new Set([`1`,`true`,`yes`,`on`]),le=new Set([`0`,`false`,`no`,`off`]);function ue(e){return`AGENT_DEVICE_${e.replace(/([A-Z])/g,`_$1`).replace(/[^A-Za-z0-9_]/g,`_`).toUpperCase()}`}function de(e,t,r,i){if(e.multiple)return(Array.isArray(t)?t:[t]).map(t=>de({...e,multiple:!1},t,r,i));if(e.type===`boolean`)return fe(t,r,i);if(e.type===`booleanOrString`){if(typeof t==`boolean`)return t;if(typeof t==`string`&&S(t)!==void 0)return S(t);if(typeof t==`string`&&t.trim().length>0)return t;throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected boolean or non-empty string.`)}if(e.type===`string`){if(typeof t==`string`&&t.trim().length>0)return t;throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected non-empty string.`)}if(e.type===`enum`){if(e.setValue!==void 0)return pe(e,t,r,i);if(typeof t!=`string`||!e.enumValues?.includes(t))throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected one of: ${e.enumValues?.join(`, `)}.`);return t}let a=typeof t==`number`?t:typeof t==`string`?Number(t):NaN;if(!Number.isFinite(a)||!Number.isInteger(a))throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected integer.`);if(typeof e.min==`number`&&a<e.min)throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Must be >= ${e.min}.`);if(typeof e.max==`number`&&a>e.max)throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Must be <= ${e.max}.`);return a}function fe(e,t,r){if(typeof e==`boolean`)return e;if(typeof e==`string`){let t=S(e);if(t!==void 0)return t}throw new n(`INVALID_ARGS`,`Invalid value for "${r}" in ${t}. Expected boolean.`)}function S(e){let t=e.trim().toLowerCase();if(ce.has(t))return!0;if(le.has(t))return!1}function pe(e,t,r,i){let a=e.setValue;if(t===a)return a;if(typeof t==`string`){let e=t.trim();if(e===``||e===`true`||e===`1`)return a;if(e===`false`||e===`0`)return}if(t===!0)return a;if(t!==!1)throw new n(`INVALID_ARGS`,`Invalid value for "${i}" in ${r}. Expected boolean-like value for enum flag.`)}const me=/^[A-Za-z0-9][A-Za-z0-9._+-]*$/,he=[`.com`,`.exe`,`.bat`,`.cmd`],C=new r;async function ge(e,t){return e?await C.run(e,t):await t()}async function w(e){return await C.run(void 0,e)}async function T(e,t,n={}){let r=C.getStore()?.(e,t,n);return r?E(await r):await D(e,t,n)}async function _e(e,t,n={}){let r=C.getStore()?.(e,t,n);return r?E(await r):await D(e,t,n)}function E(e){let t=typeof e.stdout==`string`?e.stdout:String(e.stdout??``),n=typeof e.stderr==`string`?e.stderr:String(e.stderr??``),r=typeof e.exitCode==`number`?e.exitCode:1;return t===e.stdout&&n===e.stderr&&r===e.exitCode?e:{...e,stdout:t,stderr:n,exitCode:r}}function D(e,t,n={}){let r=M(e),i=A();return new Promise((a,o)=>{let s=p(r,t,{cwd:n.cwd,env:n.env,stdio:[`pipe`,`pipe`,`pipe`],detached:n.detached,windowsHide:!0,shell:!1});n.onSpawn?.(s);let c=``,l=n.binaryStdout?[]:void 0,u=``,d=!1,f=H(n.timeoutMs),m=f?setTimeout(()=>{d=!0,U(s,n.detached)},f):null,h=Me(s,n);n.binaryStdout||s.stdout.setEncoding(`utf8`),s.stderr.setEncoding(`utf8`),Ne(s,n.stdin).catch(i=>{h.didAbort||d||Pe(i)||(o(Te(r,e,t,i)),U(s,n.detached))}),s.stdout.on(`data`,e=>{if(n.binaryStdout){l?.push(Buffer.isBuffer(e)?e:Buffer.from(e));return}let t=String(e);c+=t,n.onStdoutChunk?.(t)}),s.stderr.on(`data`,e=>{let t=String(e);u+=t,n.onStderrChunk?.(t)}),s.on(`error`,n=>{m&&clearTimeout(m),h.dispose(),i.emitForegroundCompletion(e,t),o(R(h,r,e,t,n))}),s.on(`close`,s=>{m&&clearTimeout(m),h.dispose(),i.emitForegroundCompletion(e,t);let p=s??1;if(!h.didAbort&&d&&f){o(Ee(r,e,t,f,p,c,u));return}let g=z(h,r,e,t,p,n.allowFailure,c,u);if(g){o(g);return}a({stdout:c,stderr:u,exitCode:p,stdoutBuffer:l?Buffer.concat(l):void 0})})})}async function ve(e){let t=Oe(e);if(!t)return!1;if(c.isAbsolute(t))return V(t);let n=process.env.PATH;if(!n)return!1;let r=ke();for(let e of n.split(c.delimiter)){let n=e.trim();if(n){for(let e of Ae(t,r))if(await V(c.join(n,e)))return!0}}return!1}async function ye(e,t){let r=B(e,t,`executable`);if(r){if(!await V(r))throw new n(`TOOL_MISSING`,`${t} points to a missing or non-executable file: ${r}`,{envName:t,path:r});return r}}async function be(e,t){let r=B(e,t,`file`);if(r){if(!await je(r))throw new n(`TOOL_MISSING`,`${t} points to a missing or non-file path: ${r}`,{envName:t,path:r});return r}}function xe(e,t,r={}){let i=M(e),a=m(i,t,{cwd:r.cwd,env:r.env,stdio:[`pipe`,`pipe`,`pipe`],encoding:r.binaryStdout?void 0:`utf8`,input:r.stdin,timeout:H(r.timeoutMs),windowsHide:!0,shell:!1,...r.maxBuffer===void 0?{}:{maxBuffer:r.maxBuffer}});if(a.error){let o=a.error.code;throw o===`ETIMEDOUT`?new n(`COMMAND_FAILED`,`${i} timed out after ${H(r.timeoutMs)}ms`,{cmd:e,args:t,timeoutMs:H(r.timeoutMs)},a.error):o===`ENOENT`?N(i,e,a.error):P(i,e,t,a.error)}let o=r.binaryStdout?Buffer.isBuffer(a.stdout)?a.stdout:Buffer.from(a.stdout??``):void 0,s=r.binaryStdout?``:typeof a.stdout==`string`?a.stdout:(a.stdout??``).toString(),c=typeof a.stderr==`string`?a.stderr:(a.stderr??``).toString(),l=a.status??1;if(l!==0&&!r.allowFailure)throw I(i,e,t,l,s,c);return{stdout:s,stderr:c,exitCode:l,stdoutBuffer:o}}function Se(e,t,n={}){return O(e,t,n).pid}function O(e,t,n={}){let r=p(M(e),t,{cwd:n.cwd,env:n.env,stdio:n.stdio??`ignore`,detached:!0,windowsHide:!0,shell:!1}),i=r.pid??0,a=new Promise(e=>{r.once(`error`,t=>{e({pid:i,error:t.message})}),r.once(`exit`,(t,n)=>{e({pid:i,...typeof t==`number`?{exitCode:t}:{},...n?{signal:n}:{}})})});return r.unref(),{pid:i,exited:a}}function k(e,t,n={}){let r=M(e),i=A(),a=p(r,t,{cwd:n.cwd,env:n.env,stdio:n.stdio??[`ignore`,`pipe`,`pipe`],detached:n.detached,windowsHide:!0,shell:!1});i.emitBackgroundSpawn(e,t);let o=``,s=``,c=n.captureOutput??!0,l=Me(a,n);return c&&(a.stdout?.setEncoding(`utf8`),a.stderr?.setEncoding(`utf8`),a.stdout?.on(`data`,e=>{o+=e}),a.stderr?.on(`data`,e=>{s+=e})),{child:a,wait:new Promise((c,u)=>{a.on(`error`,n=>{l.dispose(),i.emitBackgroundCompletion(e,t,`error`),u(R(l,r,e,t,n))}),a.on(`close`,a=>{l.dispose(),i.emitBackgroundCompletion(e,t,`exit`);let d=a??1,f=z(l,r,e,t,d,n.allowFailure,o,s);if(f){u(f);return}c({stdout:o,stderr:s,exitCode:d})})})}}function A(){let e=ne(),t=e.debug===!0,n=S(process.env.AGENT_DEVICE_EXEC_TRACE??``)===!0;if(!t&&!n)return Ce();n&&e.flushOnSuccess!==!0&&_({flushOnSuccess:!0});let r=Date.now(),i=!1;return{emitForegroundCompletion:(e,t)=>{i||(i=!0,j({cmd:e,args:t,startedAtMs:r}))},emitBackgroundSpawn:(e,t)=>{j({cmd:e,args:t,data:{event:`spawn`}})},emitBackgroundCompletion:(e,t,n)=>{i||(i=!0,j({cmd:e,args:t,startedAtMs:r,data:{event:n}}))}}}function Ce(){return{emitForegroundCompletion:()=>{},emitBackgroundSpawn:()=>{},emitBackgroundCompletion:()=>{}}}function j(e){let t=e.args.slice(0,6);v({level:`debug`,phase:`exec_command`,durationMs:e.startedAtMs===void 0?void 0:Math.max(0,Date.now()-e.startedAtMs),data:{command:e.cmd,argsPrefix:t,...e.args.length>t.length?{omittedArgCount:e.args.length-t.length}:{},...e.data??{}}})}function M(e){let t=Oe(e);if(!t)throw new n(`INVALID_ARGS`,`Invalid executable command: ${JSON.stringify(e)}`,{cmd:e,hint:`Use a bare command name from PATH or an absolute executable path.`});return t}function we(e,t,n,r){return r.code===`ENOENT`?N(e,t,r):P(e,t,n,r)}function N(e,t,r){return new n(`TOOL_MISSING`,`${e} not found in PATH`,{cmd:t},r)}function P(e,t,r,i){return new n(`COMMAND_FAILED`,`Failed to run ${e}`,{cmd:t,args:r},i)}function Te(e,t,r,i){return new n(`COMMAND_FAILED`,`Failed to write stdin for ${e}`,{cmd:t,args:r},i instanceof Error?i:void 0)}function F(e,t,r){return new n(`COMMAND_FAILED`,`request canceled`,{cmd:t,args:r,executable:e,reason:`request_canceled`})}function Ee(e,t,r,i,a,o,s){return new n(`COMMAND_FAILED`,`${e} timed out after ${i}ms`,{cmd:t,args:r,stdout:o,stderr:s,exitCode:a,timeoutMs:i})}function I(e,t,r,i,a,o){return new n(`COMMAND_FAILED`,`${e} exited with code ${i}`,L({stdout:a,stderr:o,exitCode:i},{cmd:t,args:r}))}function De(e,t,r){if(e.exitCode===0)return e;throw new n(`COMMAND_FAILED`,t,L(e,typeof r==`function`?r(e):r))}function L(e,t){return{stdout:e.stdout,stderr:e.stderr,exitCode:e.exitCode,processExitError:!0,...t}}function R(e,t,n,r,i){return e.didAbort?F(t,n,r):we(t,n,r,i)}function z(e,t,n,r,i,a,o,s){return e.didAbort?F(t,n,r):i!==0&&!a?I(t,n,r,i,o,s):null}function B(e,t,r){let i=e?.trim();if(i){if(!c.isAbsolute(i)||i.includes(`\0`))throw new n(`INVALID_ARGS`,`${t} must be an absolute ${r} path, not ${JSON.stringify(e)}`,{envName:t,path:e});return i}}function Oe(e){let t=e.trim();return!t||t.includes(`\0`)?null:c.isAbsolute(t)?t:t.includes(`/`)||t.includes(`\\`)?null:me.test(t)?t:null}function ke(){if(process.platform!==`win32`)return[``];let e=process.env.PATHEXT;if(!e)return he;let t=e.split(`;`).map(e=>e.trim().toLowerCase()).filter(e=>e.length>0);return t.length>0?t:he}function Ae(e,t){if(process.platform!==`win32`)return[e];let n=e.toLowerCase();return t.some(e=>n.endsWith(e))?[e]:t.map(t=>`${e}${t}`)}async function V(e){try{return await je(e)?(await d(e,process.platform===`win32`?o.F_OK:o.X_OK),!0):!1}catch{return!1}}async function je(e){try{return(await f(e)).isFile()}catch{return!1}}function H(e){if(!Number.isFinite(e))return;let t=Math.floor(e);if(!(t<=0))return t}function Me(e,t){let n=!1,r=()=>{n=!0,U(e,t.detached)};return t.signal?.aborted?r():t.signal?.addEventListener(`abort`,r,{once:!0}),{get didAbort(){return n},dispose:()=>{t.signal?.removeEventListener(`abort`,r)}}}function U(e,t){if(t&&e.pid&&process.platform!==`win32`)try{process.kill(-e.pid,`SIGKILL`);return}catch{}e.kill(`SIGKILL`)}async function Ne(e,t){if(e.stdin){if(t===void 0){e.stdin?.end();return}await l(u.from([t]),e.stdin)}}function Pe(e){return e instanceof Error&&`code`in e&&e.code===`EPIPE`}var Fe=e({androidAdbResultError:()=>K,attachAdbFailureHint:()=>G,classifyAdbFailure:()=>Re,createAndroidPortReverseManager:()=>qe,createDeviceAdbExecutor:()=>Y,createLocalAndroidAdbProvider:()=>We,installAndroidAdbPackage:()=>Ye,pullAndroidAdbFile:()=>Je,resolveAndroidAdbExecutor:()=>Ge,resolveAndroidAdbProvider:()=>X,resolveAndroidTextInjector:()=>Ke,resolveAndroidTouchProvider:()=>Z,withAndroidAdbProvider:()=>Ze});const W=new r,Ie=[{reason:`device_unauthorized`,pattern:/device unauthorized|device still authorizing/,hint:`USB debugging is not authorized — accept the authorization prompt on the device screen (re-plug the cable if none appears), then retry.`},{reason:`device_offline`,pattern:/device offline/,hint:`The device is connected but offline — wait for it to finish booting or run adb reconnect, then retry.`,retriable:!0},{reason:`multiple_devices`,pattern:/more than one (?:device\/emulator|device and emulator)/,hint:`Multiple Android devices are connected — pass --serial <serial> (see adb devices) to select one.`},{reason:`no_devices`,pattern:/no devices\/emulators found|no devices found/,hint:`No Android devices detected — boot an emulator or connect a device and verify it appears in adb devices.`},{reason:`device_not_found`,pattern:/device (?:'[^']*' )?not found/,hint:`The device disconnected or is restarting — verify it is listed in adb devices, then retry.`,retriable:!0},{reason:`server_version_mismatch`,pattern:/adb server version \(\d+\) doesn't match this client/,hint:`Multiple adb installs conflict — adb restarts its server automatically, so retry; align PATH to a single adb to stop recurrences.`,retriable:!0},{reason:`connection_dropped`,pattern:/transport error|connection reset|broken pipe|protocol fault/,hint:`The adb connection dropped — retry; if it persists, run adb kill-server and reconnect the device.`,retriable:!0},{reason:`install_insufficient_storage`,pattern:/install_failed_insufficient_storage/,hint:`The device is out of storage — free up space or uninstall unused apps, then retry the install.`,matchStdout:!0},{reason:`install_update_incompatible`,pattern:/install_failed_update_incompatible/,hint:`The installed app has an incompatible signature — uninstall the existing app first, then retry the install.`,matchStdout:!0},{reason:`install_version_downgrade`,pattern:/install_failed_version_downgrade/,hint:`The APK is older than the installed app — uninstall the app first (or install with downgrade allowed), then retry.`,matchStdout:!0},{reason:`install_failed`,pattern:/install_failed_\w+|install_parse_failed_\w+/,hint:`The Android package installer rejected the APK — see the INSTALL_FAILED code in the error output for the exact cause.`,matchStdout:!0}],Le={reason:`timeout`,hint:`adb timed out — the adb server may be wedged. Run adb kill-server && adb start-server, check adb devices, then retry.`};function Re(e,t=``){let n=e.toLowerCase(),r=t.toLowerCase();for(let{pattern:e,matchStdout:t,...i}of Ie)if(e.test(n)||t&&e.test(r))return i}function G(e){if(!(e instanceof n)||e.code!==`COMMAND_FAILED`)return e;let t=ze(e);return t&&(e.details={...e.details,adbFailure:t.reason,...typeof e.details?.hint==`string`?{}:{hint:t.hint},...t.retriable!==void 0&&e.details?.retriable===void 0?{retriable:t.retriable}:{}}),e}function ze(e){return typeof e.details?.timeoutMs==`number`?Le:Re(typeof e.details?.stderr==`string`?e.details.stderr:``,typeof e.details?.stdout==`string`?e.details.stdout:``)}function K(e,t,r){return G(new n(`COMMAND_FAILED`,e,t.exitCode===0?{stdout:t.stdout,stderr:t.stderr,exitCode:t.exitCode,...r}:L(t,r)))}function q(e){return async(...t)=>{try{return await e(...t)}catch(e){throw G(e)}}}const Be=new WeakSet;function Ve(e){if(Be.has(e))return e;let t={...e,exec:q(J(e.exec)),...e.pull?{pull:q(J(e.pull))}:{},...e.install?{install:q(J(e.install))}:{},...e.installBundle?{installBundle:q(e.installBundle)}:{}};return Be.add(t),t}function J(e){return async(...t)=>E(await e(...t))}function Y(e){return He(e.id)}function He(e){return q(async(t,n)=>await w(async()=>await T(`adb`,[`-s`,e,...t],{...n,detached:process.platform!==`win32`})))}function Ue(e){return(t,n)=>{let r=k(`adb`,[`-s`,e,...t],{...n,allowFailure:!0,captureOutput:!1});return r.wait.catch(()=>{}),r.child}}function We(e){let t=Y(e);return{exec:t,spawn:Ue(e.id),reverse:tt(t),pull:async(e,n,r)=>await t([`pull`,e,n],r),install:async(e,n)=>{let{installArgs:r,execOptions:i}=$(n);return await t([`install`,...r,e],i)}}}function Ge(e,t){let n=W.getStore();return t||(n?.serial===e.id?n.provider.exec:Y(e))}function X(e,t){if(t)return Q(t);let n=W.getStore();return n?.serial===e.id?Q(n.provider):We(e)}function Ke(e){let t=W.getStore();return t?.serial===e.id?t.provider.text:void 0}function Z(e){let t=W.getStore();return t?.serial===e.id&&t.provider.touch?t.provider:void 0}function qe(e){let t=Q(e);if(t.reverse&&et.has(t.reverse))return t.reverse;let r=t.reverse??tt(t.exec),i=new Map,a={async ensure(e,t){let a=i.get(e.local);if(a&&a.ownerId!==e.ownerId)throw new n(`COMMAND_FAILED`,`Android port reverse ${e.local} is already owned by ${a.ownerId??`another session`}`,{current:a,requested:e});a?.remote!==e.remote&&(await r.ensure(e,t),i.set(e.local,{...e}))},async remove(e,t){if(!i.has(e)){await r.remove(e,t);return}await r.remove(e,t),i.delete(e)},async removeAllOwned(e,t){let n=[...i.values()].filter(t=>t.ownerId===e).map(e=>e.local);if(n.length===0){await r.removeAllOwned(e,t);return}for(let e of n)await r.remove(e,t),i.delete(e)},async list(e){return r.list?await r.list(e):[...i.values()]}};return et.add(a),a}function Q(e){return Ve(typeof e==`function`?{exec:e}:e)}async function Je(e,t,r){let{device:i,provider:a,...o}=r??{},s=Xe(i,a),c=s?.pull;if(c)return await w(async()=>await c(e,t,o));let l=s?.exec;if(!l)throw new n(`COMMAND_FAILED`,`Android adb pull requires an adb provider`);return await w(async()=>await l([`pull`,e,t],o))}async function Ye(e,t){let{device:r,provider:i,...a}=t??{},o=Xe(r,i),s=o?.install;if(s)return await w(async()=>await s(e,a));let c=o?.exec;if(!c)throw new n(`COMMAND_FAILED`,`Android adb install requires an adb provider`);let{installArgs:l,execOptions:u}=$(a);return await w(async()=>await c([`install`,...l,e],u))}function Xe(e,t){if(t)return Q(t);if(e)return X(e);let n=W.getStore();if(n)return Q(n.provider)}async function Ze(e,t,n){if(!e)return await n();let r={provider:Q(e),serial:t.serial},i=Qe(r);return await W.run(r,async()=>await ge(i,n))}function Qe(e){return(t,n,r)=>{if(t!==`adb`)return;let i=$e(n,e.serial);if(i)return w(async()=>await e.provider.exec(i,r))}}function $e(e,t){if(!(e[0]!==`-s`||!e[1])&&e[1]===t)return e.slice(2)}const et=new WeakSet;function tt(e){let t=new Map;return{async ensure(n,r){if(await e([`reverse`,n.local,n.remote],{allowFailure:!1,signal:r?.signal,timeoutMs:r?.timeoutMs}),n.ownerId){let e=t.get(n.ownerId)??new Set;e.add(n.local),t.set(n.ownerId,e)}},async remove(n,r){let i=await e([`reverse`,`--remove`,n],{allowFailure:!0,signal:r?.signal,timeoutMs:r?.timeoutMs});if(i.exitCode!==0&&!rt(i.stdout,i.stderr))throw K(`Failed to remove Android port reverse ${n}`,i,{local:n});for(let e of t.values())e.delete(n)},async removeAllOwned(e,n){let r=[...t.get(e)??[]];for(let e of r)await this.remove(e,n);t.delete(e)},async list(n){let r=await e([`reverse`,`--list`],{allowFailure:!0,signal:n?.signal,timeoutMs:n?.timeoutMs});return r.exitCode===0?nt(r.stdout,t):[]}}}function nt(e,t){let n=new Map;for(let[e,r]of t)for(let t of r)n.set(t,e);return e.split(`
+`).map(e=>e.trim().split(/\s+/)).filter(e=>e.length>=3).map(([,e,t])=>{let r=e;return{local:r,remote:t,ownerId:n.get(r)}})}function rt(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`listener`)&&n.includes(`not found`)}function $(e){let{replace:t,allowTestPackages:n,allowDowngrade:r,grantPermissions:i,...a}=e??{},o=[];return t&&o.push(`-r`),n&&o.push(`-t`),r&&o.push(`-d`),i&&o.push(`-g`),{installArgs:o,execOptions:a}}export{g as A,xe as C,S as D,ue as E,_ as F,ae as I,te as L,oe as M,ne as N,de as O,re as P,_e as S,w as T,be as _,Ye as a,Se as b,X as c,Ze as d,E as f,ye as g,De as h,qe as i,v as j,ie as k,Ke as l,V as m,K as n,Je as o,L as p,G as r,Ge as s,Fe as t,Z as u,T as v,ve as w,O as x,k as y};