agent-device 0.19.2 → 0.20.0

package/dist/src/runtime.js

@@ -1,3 +1,3 @@
-import{t as e}from"./rolldown-runtime.js";import{D as t,F as n,H as r,I as i,O as a,P as o,j as s,k 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}from"./sdk-batch.js";import{A as p,B as m,C as h,D as g,E as _,H as ee,L as te,M as ne,N as re,O as ie,P as ae,Q as v,R as oe,S as se,T as ce,U as le,V as y,X as b,Y as x,Z as S,_ as ue,b as de,d as fe,hn as pe,j as me,k as he,nt as C,pn as ge,r as _e,v as ve,w as ye,wn as w,x as be,y as xe,z as Se}from"./tv-remote.js";import{_ as Ce,a as we,b as Te,i as Ee,m as De,n as Oe,y as ke}from"./sdk-selectors.js";import{r as Ae,t as je}from"./snapshot-quality.js";import{o as Me,r as Ne}from"./sdk-finders.js";import{a as Pe,i as Fe,o as Ie,r as Le,t as Re}from"./selectors2.js";import{n as ze,r as Be}from"./sdk-app-inventory.js";import{i as Ve,n as He,r as Ue,t as We}from"./png-worker-contract.js";import Ge,{promises as T}from"node:fs";import E from"node:path";import{fileURLToPath as Ke}from"node:url";import{Worker as qe}from"node:worker_threads";const Je=/\b(logbox|redbox|reload js|copy stack|component stack|call stack|runtime error|open debugger to view warnings)\b/,Ye=/\b(redbox|runtime error|reload js|copy stack|component stack|call stack)\b/,Xe=[/\b[\w.$<>/-]+\.(?:tsx?|jsx?):\d+(?::\d+)?\b/,/\b[\w.$<>/-]+\.(?:tsx?|jsx?)\s+\(\d+:\d+\)/],Ze=[/^!,\s+/,/^(warn|warning|error):\s+/,/\b(?:possible\s+)?unhandled (?:promise )?rejection\b/],Qe=[`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`],$e=new Set([`x`,`×`,`✕`,`✖`,`⨯`]);function et(e){if(nt(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 tt(e){return nt(e)}function nt(e){let t=ot(e),n=t.detected?st(t):null;return{detected:t.detected,redBox:t.redBox,dismissNodes:t.dismissNodes,minimizeNodes:t.minimizeNodes,collapsedNodes:t.collapsedNodes,primaryAction:n}}function rt(e){return[...e.dismissNodes,...e.minimizeNodes,...e.collapsedNodes]}function it(e){return ht(e.label?.trim())&&Tt(e.rect)}function at(e,t){let n=e.label?.trim();return!n||!it(e)?!1:t.some(e=>e.label?.trim()===n&&Et(e))}function ot(e){let t=e.map(ct).join(`
-`).toLowerCase(),n=D(e,_t),r=D(e,xt),i=D(e,ht,Ct),a=D(e,gt),o=ut(t),s=dt(t),c=ft(t,n,r);return{dismissNodes:n,minimizeNodes:r,collapsedNodes:i,redBox:pt(t,o,c),detected:mt({text:t,hasReactNativeStackFrame:o,hasOverlayControl:c,hasControllessRedBoxText:s,collapsedNodes:i,openDebuggerWarningNodes:a})}}function st(e){let t=Dt(e.dismissNodes);if(t)return jt(t,Mt(t));let n=Nt(e.collapsedNodes.filter(wt));return n?.rect?{action:`close-collapsed-banner`,point:Rt(n),rect:n.rect,ref:n.ref,label:Bt(n)}:null}function ct(e){return[e.label,e.value,e.identifier,e.type,e.role].filter(Boolean).join(` `)}function lt(e){return Je.test(e)}function ut(e){return Xe.some(t=>t.test(e))}function dt(e){return/\buncaught\b/.test(e)&&/unable to download asset/.test(e)}function ft(e,t,n){return t.length>0||n.length>0||/\b(reload js|copy stack)\b/.test(e)}function pt(e,t,n){return Ye.test(e)||dt(e)||t&&n}function mt(e){return e.collapsedNodes.length>0||e.openDebuggerWarningNodes.length>0||e.hasControllessRedBoxText||e.hasOverlayControl&&(lt(e.text)||e.hasReactNativeStackFrame)}function ht(e){let t=e?.trim().toLowerCase();return t?Qe.some(e=>t.includes(e))||Ze.some(e=>e.test(t)):!1}function gt(e){return e.includes(`open debugger to view warnings`)||/^!,\s+open debugger\b/.test(e)}function _t(e){return vt(e)||yt(e)||bt(e)}function vt(e){return/^dismiss(?:\s*\([^)]*\))?$/i.test(e)}function yt(e){return/^close(?:\s*\([^)]*\))?$/i.test(e)}function bt(e){return $e.has(e)}function xt(e){return/^minimi[sz]e(?:\b|\s|\()/i.test(e)}function St(e){return/^!,\s+/.test(e)}function Ct(e){return!e.rect||e.rect.height<=180}function wt(e){let t=Bt(e)?.trim().toLowerCase()??``;return(gt(t)||St(t))&&Et(e)}function Tt(e){return e?e.x<=1&&e.y<=1&&e.width>=300&&e.height>=600:!1}function Et(e){return e.rect?e.rect.width>=120&&e.rect.height>=36&&e.rect.height<=180:!1}function D(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 Dt(e){return Pt(e,At)}function Ot(e){let t=[e.type,e.role,e.subrole].join(` `).toLowerCase();return/\b(button|menuitem|link)\b/.test(t)}function kt(e){return e?e.width*e.height:1/0}function At(e){return[It(Ot(e)),It(e.hittable),-kt(e.rect)]}function jt(e,t){if(!e.rect)throw Error(`React Native overlay target node must have rect`);return{action:t,point:a(e.rect),rect:e.rect,ref:e.ref,label:Bt(e)}}function Mt(e){let t=Bt(e)?.trim().toLowerCase();return t&&vt(t)?`dismiss`:`close`}function Nt(e){return Pt(e,Ft)}function Pt(e,t){let n=e.filter(e=>e.rect);return n.length===0?null:n.sort((e,n)=>Lt(t(n),t(e)))[0]??null}function Ft(e){return[It(e.hittable),e.rect?.width??0,e.rect?.y??0]}function It(e){return+(e===!0)}function Lt(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 Rt(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 Bt(e){return e.label??e.value??e.identifier}const Vt=[`status`,`get`,`dismiss`,`enter`,`return`];function Ht(e){return Vt.includes(e)}function Ut(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 Wt(e){let{nodes:t,backend:n,snapshotRaw:r}=e;if(r||!o(n))return{partial:!1,visibleNodeCount:t.length,totalNodeCount:t.length,reasons:[]};let i=Te(t),a=new Set;return i.hiddenCount>0&&a.add(`offscreen-nodes`),i.nodes.some(e=>e.hiddenContentAbove)&&a.add(`scroll-hidden-above`),i.nodes.some(e=>e.hiddenContentBelow)&&a.add(`scroll-hidden-below`),{partial:a.size>0,visibleNodeCount:i.nodes.length,totalNodeCount:t.length,reasons:[...a]}}function Gt(e,t){try{let n=Ke(e),r=E.extname(n)||`.js`;return[E.join(E.dirname(n),`${t}${r}`),E.join(E.dirname(n),`internal`,`${t}${r}`)].find(e=>Ge.existsSync(e))??null}catch{return null}}var O=class extends Error{};let k=null,Kt=!1,qt=!1,Jt=0;const A=new Map;function Yt(e){Kt=!0,!qt&&(qt=!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 Xt(e){let t=A.get(e.id);t&&(A.delete(e.id),$t(),e.ok?t.resolve(e.result):t.reject(new n(r(e.error.code),e.error.message,e.error.details)))}function Zt(e,t){k===e&&(Yt(t.message),k=null,e.terminate().catch(()=>{}),Qt(new O(`PNG worker failed: ${t.message}`)))}function Qt(e){let t=[...A.values()];A.clear();for(let n of t)n.reject(e)}function $t(){k&&(A.size>0?k.ref():k.unref())}function en(){if(Kt)return null;if(k)return k;let e=Gt(import.meta.url,`png-worker`);if(!e)return Yt(`worker entry module not found next to the current module`),null;try{let t=new qe(e,{execArgv:e.endsWith(`.ts`)?[`--experimental-strip-types`]:[]});return t.on(`message`,Xt),t.on(`error`,e=>{Zt(t,e)}),t.on(`exit`,e=>{Zt(t,Error(`PNG worker exited with code ${e}`))}),t.unref(),k=t,t}catch(e){return Yt(`failed to spawn worker: ${e instanceof Error?e.message:String(e)}`),null}}function tn(e){let t=en();if(!t)return Promise.reject(new O(`PNG worker is unavailable`));Jt+=1;let n=Jt;return new Promise((r,i)=>{A.set(n,{resolve:r,reject:i}),$t();try{t.postMessage({...e,id:n})}catch(e){A.delete(n),$t(),i(new O(`failed to post job to PNG worker: ${e instanceof Error?e.message:String(e)}`))}})}async function nn(e,t){try{return await tn(e)}catch(e){if(e instanceof O)return t();throw e}}function rn(){en()}async function an(){let e=k;k=null,Qt(new O(`PNG worker terminated`)),e&&await e.terminate()}async function j(e,t){let n=await nn({kind:`decode`,png:e,label:t},()=>{let n=Ue(e,t);return{kind:`decode`,width:n.width,height:n.height,data:n.data}});return new Ve({width:n.width,height:n.height,data:We(n.data)})}async function M(e){return We((await nn({kind:`encode`,width:e.width,height:e.height,data:e.data},()=>({kind:`encode`,png:Ve.sync.write(e)}))).png)}async function on(e){let{kind:t,...n}=await nn({kind:`diff-pixels`,...e},()=>({kind:`diff-pixels`,...He(e)}));return{...n,diffData:We(n.diffData)}}const sn=[0,187,255,255];function cn(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||ln(e,n.rect)}function ln(e,t){let n=N(t.x,0,e.width-1),r=N(t.y,0,e.height-1),i=N(t.x+t.width-1,0,e.width-1),a=N(t.y+t.height-1,0,e.height-1);for(let t=0;t<2;t+=1){for(let o=n;o<=i;o+=1)un(e,o,r+t,sn),un(e,o,a-t,sn);for(let o=r;o<=a;o+=1)un(e,n+t,o,sn),un(e,i-t,o,sn)}}function un(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 N(e,t,n){return Math.min(Math.max(e,t),n)}const dn=[{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 fn(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(!hn(t,a,e))continue;let c=0,l=mn(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=pn({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function pn(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 dn){let o=s+e.x,u=c+e.y;if(!gn(o,u,i,a))continue;let d=u*i+o;hn(t,n,d)&&(l=mn(r,n,l,d))}return l}function mn(e,t,n,r){return t[r]=1,e[n]=r,n+1}function hn(e,t,n){return e[n]===1&&t[n]!==1}function gn(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}const _n=.4,vn={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},yn={leading:20,trailing:20,separator:10,unknown:0,background:-30};function bn(e){let t=Tn(Sn(xn(e.diffMask,e.width,e.height,e.ocr),e.width,e.height),10),n=In(e.ocr?.currentBlocksRaw??[]),r=In(e.ocr?.baselineBlocksRaw??[]);return t.filter(Bn).map(t=>En(t,e,n,r)).filter(t=>t.rect.y>=e.height*.08).filter(An).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,e.maxDeltas??12)).map((e,t)=>Dn(e,t+1))}function xn(e,t,n,r){let i=new Uint8Array(e);if(!r)return i;for(let e of[...r.baselineBlocksRaw,...r.currentBlocksRaw])Hn(i,t,n,oe(e.rect,8));return i}function Sn(e,t,n){return fn({mask:e,width:t,height:n,hooks:{create:e=>Cn(e,t),visit:(e,n)=>wn(e,n,t)}})}function Cn(e,t){let n=e%t,r=Math.floor(e/t);return{minX:n,minY:r,maxX:n,maxY:r,differentPixels:0}}function wn(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 Tn(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=>Un(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 En(e,t,n,r){let i=Vn(e),a=Nn(i,t.regions),o=Pn(i,n,r),s=On(i,o?.block.rect,t.width),c=kn(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:zn(o.block.text)}:{},score:jn(l,e.differentPixels,t)}}function Dn(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 On(e,t,n){if(e.height<=3&&e.width>=n*.12)return`separator`;if(!t)return e.width>=n*_n?`background`:`unknown`;if(e.width>=n*_n)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 kn(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`:Mn(e,r)?`background`:`visual`}function An(e){return e.likelyKind!==`background`}function jn(e,t,n){let r=Mn(e.rect,n)?-35:0,i=e.regionIndex?20:0;return vn[e.likelyKind]+yn[e.slot]+i+r+Math.min(20,t/200)}function Mn(e,t){return e.width>=t.width*.25||e.height>=t.height*.06}function Nn(e,t){let n,r=0;for(let i of t){let t=Se(e,i.rect);t<=r||(r=t,n=i)}return n?.index}function Pn(e,t,n){let r=Fn(e,t);if(r)return Rn(e,r.blocks);let i=Fn(e,n);return i?Rn(e,i.blocks):void 0}function Fn(e,t){let n,r=0;for(let i of t){let t=Wn(e,i.rect);t<=r||(r=t,n=i)}return n}function In(e){let t=[];for(let n of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>Ln(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=le([e.rect,n.rect])}return t}function Ln(e,t){return Wn(e,t)>0?!0:Math.abs(y(e).y-y(t).y)<=Math.max(e.height,t.height)*.5}function Rn(e,t){let n,r=y(e);for(let e of t){let t=Math.sqrt(ee(r,y(e.rect)));n&&t>=n.distance||(n={block:e,distance:t})}return n}function zn(e){return e.trim().replace(/^[^\p{L}\p{N}]+/u,``).replace(/^\p{L}\s+/u,``)}function Bn(e){let t=Vn(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function Vn(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function Hn(e,t,n,r){let i=te(Math.floor(r.x),0,t-1),a=te(Math.floor(r.y),0,n-1),o=te(Math.ceil(r.x+r.width),0,t),s=te(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 Un(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 Wn(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}async function Gn(e){if(await d(`tesseract`))try{let[t,n]=await Promise.all([Jn(e.baselinePath),Jn(e.currentPath)]);if(t.exitCode!==0||n.exitCode!==0)return;let r=Kn(t.stdout,e.width,e.height),i=Kn(n.stdout,e.width,e.height),a=qn(r,i),o=tr(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 Kn(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=F(t,o,`level`),r=P(t,o,`text`).trim(),i=F(t,o,`conf`);if(n!==5||!ir(r)||i<0)continue;let a=F(t,o,`left`),c=F(t,o,`top`),l=F(t,o,`width`),u=F(t,o,`height`);l<=0||u<=0||s.push({key:[P(t,o,`page_num`),P(t,o,`block_num`),P(t,o,`par_num`),P(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=>Xn(e)).map(e=>Yn(e,t,n)).filter(e=>e!==null)}function qn(e,t){let n=new Set,r=[];for(let i of e){let e=Zn(i,ar(i.text),t,n);if(e===null)continue;n.add(e);let a=t[e],o=Qn(i,a);$n(o)&&r.push(o)}return r.sort((e,t)=>er(t)-er(e)).slice(0,12)}function Jn(e){return u(`tesseract`,[e,`stdout`,`-l`,`eng`,`tsv`],{allowFailure:!0,timeoutMs:1e4})}function Yn(e,t,n){if(e.length===0)return null;let r=[...e].sort((e,t)=>e.rect.x-t.rect.x),i=le(r.map(e=>e.rect)),a=Math.round(or(r.map(e=>e.confidence))*100)/100;return{text:r.map(e=>e.text).join(` `),confidence:a,rect:i,normalizedRect:m({x:I(i.x/t),y:I(i.y/n),width:I(i.width/t),height:I(i.height/n)})}}function Xn(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 Zn(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(ar(s.text)!==t)continue;let c=ee(y(e.normalizedRect),y(s.normalizedRect));c>=a||(i=o,a=c)}return i}function Qn(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=sr(t.rect.width/e.rect.width),i=sr(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 $n(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 er(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 tr(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-or(e.map(e=>e.delta.x)))<=32);e?e.push(n):t.push([n])}return t.filter(e=>e.length>=2).map(nr).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>rr(t)-rr(e)).slice(0,4)}function nr(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 rr(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 P(e,t,n){let r=t.get(n);return r===void 0?``:e[r]??``}function F(e,t,n){let r=Number(P(e,t,n));return Number.isFinite(r)?r:0}function ir(e){return/[\p{L}\p{N}]/u.test(e)}function ar(e){return e.trim().replace(/\s+/g,` `).toLowerCase()}function or(e){return e.reduce((e,t)=>e+t,0)/e.length}function I(e){return Math.round(e*100*100)/100}function sr(e){return Math.round(e*1e3)/1e3}function cr(e,t){return e.flatMap(e=>lr(e,t.baseline.width,t.baseline.height)?ur(e,t,gr(t.baseline.height)):[e])}function lr(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=hr(n)&&r>=t*.35}function ur(e,t,n){let r=mr(e,pr(fr(dr(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])=>_r(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function dr(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 fr(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 pr(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 mr(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 hr(e){return Math.max(48,Math.round(e*.07))}function gr(e){return Math.max(24,Math.round(e*.03))}function _r(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??=vr(t,a),yr(i,e,t,a,r.baseline,r.current))}return i}function vr(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 yr(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 br=2.5;function xr(e){let t=Sr(e);return cr(t.length<=2e3?Tr(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)=>Or(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function Sr(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return fn({mask:t,width:i,height:a,hooks:{create:e=>Cr(e,i),visit:(e,t)=>wr(e,t,i,n,r)}})}function Cr(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 wr(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 Tr(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=>Er(e,r,t));if(!e){n.push({...r});continue}Dr(e,r)}return n}function Er(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 Dr(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 Or(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=kr(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=kr(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height,c=R(e.differentPixels/s),l=Math.round(L(a)),u=Math.round(L(o)),d=Mr(r,n.width,n.height),f=Nr(s,n.totalPixels),p=jr(a,o),h=Ar(i,n.width,n.height);return{index:t,rect:r,normalizedRect:m({x:R(r.x/n.width),y:R(r.y/n.height),width:R(r.width/n.width),height:R(r.height/n.height)}),differentPixels:e.differentPixels,shareOfDiffPercentage:R(e.differentPixels/n.differentPixels),densityPercentage:c,shape:d,size:f,location:h,averageBaselineColorHex:Pr(a),averageCurrentColorHex:Pr(o),baselineLuminance:l,currentLuminance:u,dominantChange:p}}function kr(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function Ar(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 jr(e,t){let n=L(e),r=L(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 Mr(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*br?`horizontal-band`:e.height>=e.width*br?`vertical-band`:`compact`}function Nr(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function L(e){return e.r*.2126+e.g*.7152+e.b*.0722}function Pr(e){return`#${Fr(e.r)}${Fr(e.g)}${Fr(e.b)}`}function Fr(e){return e.toString(16).padStart(2,`0`)}function R(e){return Math.round(e*100*100)/100}const Ir=255*Math.sqrt(3);async function Lr(e,t,n={}){await Rr(e,`Baseline image not found`),await Rr(t,`Current screenshot not found`);let r=n.outputPath,[i,a]=await Promise.all([T.readFile(e),T.readFile(t)]),[o,s]=await Promise.all([j(i,`baseline screenshot`),j(a,`current screenshot`)]);zr(o.width,o.height,`baseline screenshot`,n.maxPixels),zr(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 Br(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*Ir,{diffData:d,diffMask:f,differentPixels:p}=await on({width:o.width,height:o.height,baselineData:o.data,currentData:s.data,maxColorDistance:u}),m=p>0?xr({diffMask:f,baseline:o,current:s,totalPixels:l,differentPixels:p,maxRegions:n.maxRegions}):[];if(p>0&&r){let e=new Ve({width:o.width,height:o.height,data:d});cn(e,m),await T.mkdir(E.dirname(r),{recursive:!0}),await T.writeFile(r,await M(e))}else await Br(n.outputPath);let h=p>0?await Gn({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?bn({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 Rr(e,t){try{await T.access(e)}catch{throw new n(`INVALID_ARGS`,`${t}: ${e}`)}}function zr(e,t,r,i){if(i==null||i<=0)return;let a=e*t;if(!(a<=i))throw new n(`INVALID_ARGS`,`${r} is ${a} pixels, which exceeds the configured maxImagePixels limit of ${i}`)}async function Br(e){if(e)try{await T.unlink(e)}catch(e){if(!Vr(e,`ENOENT`))throw e}}function Vr(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function Hr(e,t){return e.map(e=>{let n=Ur(e,t);return n.length>0?{...e,currentOverlayMatches:n}:e})}function Ur(e,t){let n=Wr(e.rect);return t.map(t=>{let r=t.overlayRect,i=Se(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:Gr(i/Wr(r)),regionCoveragePercentage:Gr(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 Wr(e){return e.width*e.height}function Gr(e){return Math.round(e*100*100)/100}async function z(e,t,r){if(t.kind===`path`&&!e.policy.allowLocalInputPaths)throw new n(`INVALID_ARGS`,`Local ${r.field??`input`} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(t,r)}catch(e){throw i(e)}}async function B(e,t,r){if(t?.kind===`path`&&!e.policy.allowLocalOutputPaths)throw new n(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await e.artifacts.reserveOutput(t,{...r,visibility:r.visibility??`client-visible`,requestedClientPath:t?.kind===`downloadableArtifact`?t.clientPath??r.requestedClientPath:r.requestedClientPath})}catch(e){throw i(e)}}async function Kr(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw i(e)}}const qr=async(e,t)=>{if(!t.baseline)throw new n(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let r=Jr(t.threshold),i=t.current??{kind:`live`};if(t.overlayRefs&&!ti(i))throw new n(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let a=await z(e,t.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let n;ti(i)?(s=await Yr(e,t),n=s.path):(o=await z(e,i,{usage:`diff screenshot current`,field:`current`}),n=o.path),c=t.out?await B(e,t.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await Lr(a.path,n,{threshold:r,outputPath:c?.path,maxPixels:e.policy.maxImagePixels});ti(i)&&(u=await Xr(e,t,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 Jr(e){if(e==null||e===``)return .1;let t=Number(e);if(Number.isNaN(t)||t<0||t>1)throw new n(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return t}async function Yr(e,t){let n=await Kr(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await Zr(e,t,n.path,Qr(t))}catch(e){throw await n.cleanup(),e}return n}async function Xr(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await ei(n),r;let a=await B(e,$r(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await Zr(e,t,a.path,{overlayRefs:!0,...Qr(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:Hr(r.regions,n.overlayRefs)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function Zr(e,t,r,i={}){if(!e.backend.captureScreenshot)throw new n(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata},r,i)??{}}function Qr(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function $r(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:V(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:V(e.out.clientPath)}:{},...e.out.fileName?{fileName:V(e.out.fileName)}:{}}}function V(e){let t=E.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function ei(e){try{await T.unlink(V(e))}catch(e){if(!ni(e,`ENOENT`))throw e}}function ti(e){return e.kind===`live`}function ni(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}async function ri(e,t){if(!Number.isInteger(t)||t<1)throw new n(`INVALID_ARGS`,`Screenshot max size must be a positive integer`);let r=await j(await T.readFile(e),`screenshot`),i=Math.max(r.width,r.height);if(i<=t)return;let a=t/i,o=ai(r,Math.max(1,Math.round(r.width*a)),Math.max(1,Math.round(r.height*a)));await T.writeFile(e,await M(o))}async function ii(e,t,r){if(!Number.isInteger(t)||t<1||!Number.isInteger(r)||r<1)throw new n(`INVALID_ARGS`,`Screenshot resize dimensions must be positive integers`);let i=await j(await T.readFile(e),`screenshot`);i.width===t&&i.height===r||await T.writeFile(e,await M(ai(i,t,r)))}function ai(e,t,n){let r=new Ve({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 oi=async(e,t)=>{if(!e.backend.captureScreenshot)throw new n(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);let r=await B(e,t.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),i;try{await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,appId:t.appId,appBundleId:t.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},r.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,pixelDensity:t.pixelDensity,stabilize:t.stabilize,normalizeStatusBar:t.normalizeStatusBar,surface:t.surface}),t.maxSize!==void 0&&await ri(r.path,t.maxSize),i=await r.publish()}catch(e){throw await r.cleanup?.(),e}return{path:r.path,...i?{artifacts:[i]}:{},...w(`Saved screenshot: ${r.path}`)}};function si(e,n){return e.presentationKey?e:{...e,presentationKey:t(n)}}function ci(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||!li(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!ui(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 li(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function ui(e,t){return e.truncated===t.truncated?JSON.stringify(di(e.nodes))===JSON.stringify(di(t.nodes)):!1}function di(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 fi=async(e,t)=>{let n=await mi(e,t),r=ci({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(gi(t.session,n)),{nodes:n.snapshot.nodes,truncated:n.snapshot.truncated??!1,visibility:Wt({nodes:n.snapshot.nodes,backend:n.snapshot.backend,snapshotRaw:t.raw}),...ge({...n.annotations,warnings:n.warnings}),...r?{unchanged:r}:{},...n.result.snapshotDiagnostics?{snapshotDiagnostics:n.result.snapshotDiagnostics}:{},..._i(n)}},pi=async(e,t)=>{let n=await mi(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,a=gi(t.session,n);if(!i){let t=ne(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=me(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 mi(e,t){if(!e.backend.captureSnapshot)throw new n(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=t.session??`default`,i=await e.sessions.get(r),a=await e.backend.captureSnapshot({session:r,requestId:t.requestId,appId:i?.appId,appBundleId:i?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,depth:t.depth,scope:t.scope,raw:t.raw}),o=si(hi(a,e),t),s=pe(a),c=b(e);return{snapshot:o,result:a,session:i,annotations:s,warnings:vi({result:a,annotations:s,snapshot:o,options:t,session:i,capturedAt:o.createdAt??c,runtimeNow:c})}}function hi(e,t){return e.snapshot?e.snapshot:{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,createdAt:b(t)}}function gi(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 _i(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 vi(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...Ae(e.annotations.quality,e.snapshot.nodes)),t.push(...xi(e)),e.annotations.quality||(t.push(...yi(e)),t.push(...bi(e.snapshot.nodes)));let n=Si(e.annotations.androidSnapshot);n&&t.push(n);let r=et(e.snapshot.nodes);r&&t.push(r);let i=Ci(e);return i&&t.push(i),t.push(...Di(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function yi(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 bi(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 xi(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 Si(e){if(e?.backend===`uiautomator-dump`)return`Android snapshot helper unavailable; using stock UIAutomator dump, which can time out on busy React Native UIs.${e.fallbackReason?` Reason: ${e.fallbackReason}`:``}`}function Ci(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&wi(t,e.snapshot)&&Ti(t,e.capturedAt,e.runtimeNow)&&Oi(t.nodes.length,e.snapshot.nodes.length))return Ei}function wi(e,t){return e.presentationKey===void 0||t.presentationKey===void 0?!0:e.presentationKey===t.presentationKey}function Ti(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const Ei=`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 Di(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`?[Ei]:[]}function Oi(e,t){return e<12?!1:t<=Math.floor(e*.2)}const H={screenshot:oi,diffScreenshot:qr,snapshot:fi,diffSnapshot:pi};function ki(e){return{screenshot:t=>H.screenshot(e,t),diffScreenshot:t=>H.diffScreenshot(e,t),snapshot:t=>H.snapshot(e,t),diffSnapshot:t=>H.diffSnapshot(e,t)}}const Ai=async(e,t)=>await Pi(e,t,`press`),ji=async(e,t)=>await Pi(e,t,`click`),Mi=async(e,t)=>{if(!t.text)throw new n(`INVALID_ARGS`,`fill requires text`);let r=h(t),i=r.needsPreActionBaseline?null:await Li(e,t);if(i)return i;let a=await ae(e,t,{action:`fill`,requireInteractive:!0,promoteToHittableAncestor:!1,captureEvidenceBaseline:r.needsPreActionBaseline});if(!e.backend.fill)throw new n(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=Fi(a),s=x(await e.backend.fill(v(e,t),o,t.text,{delayMs:t.delayMs})),c=`node`in a?a.node?.type??``:``,l=c&&!Ce(c,e.backend.platform)?`fill target ${zi(a)} resolved to "${c}", attempting fill anyway.`:void 0;return await se(e,t,a,{...a,text:t.text,...l?{warning:l}:{},...s?{backendResult:s}:{}},r)},Ni=async(e,t)=>{let r=t.text;if(!r)throw new n(`INVALID_ARGS`,`type requires text`);let i=Bi(r);if(i)throw new n(`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 n(`UNSUPPORTED_OPERATION`,`type is not supported by this backend`);let a=C(t.delayMs??0,`delay-ms`,0,1e4),o=x(await e.backend.typeText(v(e,t),r,{delayMs:a}));return{kind:`text`,text:r,delayMs:a,...o?{backendResult:o}:{},...w(`Typed ${Array.from(r).length} chars`)}};async function Pi(e,t,r){let i=h(t),a=i.needsPreActionBaseline?null:await Ii(e,t,r);if(a)return a;let o=await ae(e,t,{action:r,requireInteractive:!0,promoteToHittableAncestor:!0,captureEvidenceBaseline:i.needsPreActionBaseline});if(!e.backend.tap)throw new n(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let s=Fi(o),c=x(await e.backend.tap(v(e,t),s,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap}));return await se(e,t,o,{...o,...c?{backendResult:c}:{}},i)}function Fi(e){if(!e.point)throw new n(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}async function Ii(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||Ri(t))return null;let r=await re(e,t,t.target,n),i=x(await e.backend.tapTarget(v(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},...r,...i?{backendResult:i}:{}}}async function Li(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget)return null;let n=await re(e,t,t.target,`fill`),r=x(await e.backend.fillTarget(v(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,...n,...r?{backendResult:r}:{}}}function Ri(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 Bi(e){return Ut(e)}function Vi(e){return{includeRects:Hi(e.predicate),interactiveOnly:!1}}function Hi(e){return e===`visible`||e===`hidden`}const Ui=1e4,Wi=async(e,t)=>{let r=t.locator??`any`;if(!t.query)throw new n(`INVALID_ARGS`,`find requires a value`);if(t.action===`wait`)return await $i(e,t,r);let{capture:i,match:a}=await ea(e,t,r);if(!a)throw new n(`COMMAND_FAILED`,`find did not match any element`);if(t.action===`exists`)return{kind:`found`,found:!0};let o=`@${a.ref}`;return t.action===`get_attrs`?{kind:`attrs`,ref:o,node:a}:{kind:`text`,ref:o,text:await g(e,i,a),node:a}},Gi=async(e,t)=>{if(t.target.kind===`ref`){let n=await ie(e,t.session),r=he(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`}),i=Re(r.node,e.backend.platform,{action:`get`}),a={kind:`ref`,ref:`@${r.ref}`};return t.property===`attrs`?{kind:`attrs`,target:a,node:r.node,selectorChain:i}:{kind:`text`,target:a,text:await g(e,n,r.node),node:r.node,selectorChain:i}}let n=await sa(e,t,t.session??`default`,{selector:t.target.selector,disambiguateAmbiguous:t.property===`text`}),r=Re(n.node,e.backend.platform,{action:`get`});if(t.property===`attrs`)return{kind:`attrs`,target:{kind:`selector`,selector:n.selector},node:n.node,selectorChain:r};let i=await g(e,n.capture,n.node);return{kind:`text`,target:{kind:`selector`,selector:n.selector},text:i,node:n.node,selectorChain:r}},Ki=async(e,t)=>{let r=await Gi(e,{...t,property:`text`,target:t.target});if(r.kind!==`text`)throw new n(`COMMAND_FAILED`,`getText returned non-text result`);return r},qi=async(e,t)=>{let r=await Gi(e,{...t,property:`attrs`,target:t.target});if(r.kind!==`attrs`)throw new n(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return r},Ji=async(e,t)=>{if(!we(t.predicate))throw new n(`INVALID_ARGS`,Oe);if(t.predicate===`text`&&!t.expectedText)throw new n(`INVALID_ARGS`,`is text requires expected text value`);let r=f(t.selector),i=await _(e,t,{updateSession:!0,...Vi({predicate:t.predicate,selectorChain:r})});if(t.predicate===`exists`){let a=Le(i.snapshot.nodes,r,{platform:e.backend.platform});if(!a)throw new n(`COMMAND_FAILED`,Fe(r,[],{unique:!1}),{hint:Ie([])});return{predicate:t.predicate,pass:!0,selector:a.selector.raw,matches:a.matches,selectorChain:r.selectors.map(e=>e.raw)}}let a=Pe(i.snapshot.nodes,r,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:!1});if(!a)throw new n(`COMMAND_FAILED`,Fe(r,[],{unique:!0}),{command:`is`,reason:`selector_not_found`,predicate:t.predicate,selector:r.raw,hint:Ie([])});let o=Ee({predicate:t.predicate,node:a.node,nodes:i.snapshot.nodes,expectedText:t.expectedText,platform:e.backend.platform});if(!o.pass)throw new n(`COMMAND_FAILED`,`is ${t.predicate} failed for selector ${a.selector.raw}: ${o.details}`,{command:`is`,reason:`predicate_failed`,predicate:t.predicate,selector:a.selector.raw,predicateDetails:o.details});return{predicate:t.predicate,pass:!0,selector:a.selector.raw,...t.predicate===`text`?{text:o.actualText}:{},selectorChain:r.selectors.map(e=>e.raw)}},Yi=async(e,t)=>await Ji(e,{...t,predicate:`visible`,selector:t.target.selector}),Xi=async(e,t)=>await Ji(e,{...t,predicate:`hidden`,selector:t.target.selector}),Zi=async(e,t)=>{if(t.target.kind===`sleep`)return await S(e,t.target.durationMs),{kind:`sleep`,waitedMs:t.target.durationMs};if(t.target.kind===`ref`){let r=await ie(e,t.session),i=s(t.target.ref);if(!i)throw new n(`INVALID_ARGS`,`Invalid ref: ${t.target.ref}`);let a=c(r.snapshot.nodes,i),o=a?ke(a,r.snapshot.nodes):void 0;if(!o)throw new n(`COMMAND_FAILED`,`Ref ${t.target.ref} not found or has no label`);return await ia(e,t,o,t.target.timeoutMs)}if(t.target.kind===`selector`)return await ra(e,t,t.target.selector,t.target.timeoutMs);if(t.target.kind===`stable`)return await oa(e,t,t.target.quietMs,t.target.timeoutMs);if(!t.target.text)throw new n(`INVALID_ARGS`,`wait requires text`);return await ia(e,t,t.target.text,t.target.timeoutMs)},Qi=async(e,t)=>{let r=await Zi(e,{...t,target:{kind:`text`,text:t.text,timeoutMs:t.timeoutMs}});if(r.kind!==`text`)throw new n(`COMMAND_FAILED`,`waitForText returned non-text result`);return r};async function $i(e,t,r){let i=t.timeoutMs??Ui,a=b(e);for(;b(e)-a<i;){let{match:n}=await ea(e,t,r);if(n)return{kind:`found`,found:!0,waitedMs:b(e)-a};await S(e,300)}throw new n(`COMMAND_FAILED`,`find wait timed out`)}async function ea(e,t,n){let r=Me(n,t.query),i=await _(e,t,{updateSession:!0,scope:ta(e,n,t.query,r),...Vi({selectorChain:r})});if(je(i.snapshot.snapshotQuality))throw na(i.snapshot.snapshotQuality);return r?{capture:i,match:Pe(i.snapshot.nodes,r,{platform:e.backend.platform,requireRect:!1,requireUnique:!1})?.node}:{capture:i,match:Ne(i.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}function ta(e,t,n,r){if(!r&&e.backend.platform!==`web`)return p(t)?n:void 0}function na(e){return new n(`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 ra(e,t,r,i){let a=i??Ui,o=b(e),s=f(r),c=Vi({selectorChain:s});for(;b(e)-o<a;){let n=Le((await _(e,t,{updateSession:!0,...c})).snapshot.nodes,s,{platform:e.backend.platform});if(n)return{kind:`selector`,selector:n.selector.raw,waitedMs:b(e)-o};await S(e,300)}throw new n(`COMMAND_FAILED`,`wait timed out for selector: ${r}`)}async function ia(e,t,r,i){let a=i??Ui,o=b(e);for(;b(e)-o<a;){if(e.backend.findText?(await e.backend.findText(v(e,t),r)).found:await aa(e,t,r))return{kind:`text`,text:r,waitedMs:b(e)-o};await S(e,300)}throw new n(`COMMAND_FAILED`,`wait timed out for text: ${r}`)}async function aa(e,t,n){return!!De((await _(e,t,{updateSession:!0})).snapshot.nodes,n)}async function oa(e,t,r,i){let a=i??Ui,o=r??500,s=await ce(e,t,{quietMs:o,timeoutMs:a});if(!s.settled)throw new n(`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:ye}:{}}}async function sa(e,t,r,i){let a=f(i.selector),o=await _(e,{...t,session:r},{updateSession:!0,...Vi({selectorChain:a})}),s=Pe(o.snapshot.nodes,a,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:i.disambiguateAmbiguous});if(!s)throw new n(`COMMAND_FAILED`,Fe(a,[],{unique:!0}),{hint:Ie([])});return{capture:o,node:s.node,selector:s.selector.raw,ref:`@${s.node.ref}`}}const U={find:Wi,get:Gi,getText:Ki,getAttrs:qi,is:Ji,isVisible:Yi,isHidden:Xi,wait:Zi,waitForText:Qi},W={click:ji,press:Ai,fill:Mi,typeText:Ni,focus:ue,longPress:ve,swipe:be,scroll:de,pinch:xe};function ca(e){return{find:t=>U.find(e,t),get:t=>U.get(e,t),getText:(t,n={})=>U.getText(e,{...n,target:t}),getAttrs:(t,n={})=>U.getAttrs(e,{...n,target:t}),is:t=>U.is(e,t),isVisible:(t,n={})=>U.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>U.isHidden(e,{...n,target:t}),wait:t=>U.wait(e,t),waitForText:(t,n={})=>U.waitForText(e,{...n,text:t})}}function la(e){return{click:(t,n={})=>W.click(e,{...n,target:t}),press:(t,n={})=>W.press(e,{...n,target:t}),fill:(t,n,r={})=>W.fill(e,{...r,target:t,text:n}),typeText:(t,n={})=>W.typeText(e,{...n,text:t}),focus:(t,n={})=>W.focus(e,{...n,target:t}),longPress:(t,n={})=>W.longPress(e,{...n,target:t}),swipe:t=>W.swipe(e,t),scroll:t=>W.scroll(e,t),pinch:t=>W.pinch(e,t)}}function G(e,t){if(e!==void 0)return K(e,t)}function K(e,t){let r=e?.trim();if(!r)throw new n(`INVALID_ARGS`,`${t} must be a non-empty string`);return r}const ua=async(e,t={})=>{if(!e.backend.listDevices)throw new n(`UNSUPPORTED_OPERATION`,`admin.devices is not supported by this backend`);return{kind:`adminDevices`,devices:await e.backend.listDevices(v(e,t),t.filter)}},da=async(e,t={})=>{if(!e.backend.bootDevice)throw new n(`UNSUPPORTED_OPERATION`,`admin.boot is not supported by this backend`);let r=xa(t.target),i=x(await e.backend.bootDevice(v(e,t),r));return{kind:`deviceBooted`,...r?{target:r}:{},...i?{backendResult:i}:{},...w(`Booted device`)}},fa=async(e,t={})=>{if(!e.backend.shutdownDevice)throw new n(`UNSUPPORTED_OPERATION`,`admin.shutdown is not supported by this backend`);let r=xa(t.target),i=x(await e.backend.shutdownDevice(v(e,t),r));return{kind:`deviceShutdown`,...r?{target:r}:{},...i?{backendResult:i}:{},...w(`Shutdown device`)}},pa=async(e,t)=>await ga(e,t,`install`),ma=async(e,t)=>await ga(e,t,`reinstall`),ha=async(e,t)=>await ga(e,t,`installFromSource`);async function ga(e,t,r){let i=r===`reinstall`?`reinstallApp`:`installApp`,a=e.backend[i];if(!a)throw new n(`UNSUPPORTED_OPERATION`,`admin.${r} is not supported by this backend`);let o=`app`in t&&t.app!==void 0?K(t.app,`app`):void 0;if(r!==`installFromSource`&&!o)throw new n(`INVALID_ARGS`,`admin.${r} requires app`);let s=v(e,t),c=await _a(e,s,t.source);try{let t=await a.call(e.backend,s,{...o?{app:o}:{},source:c.source});return Sa(r,o,c.source,t)}finally{await c.cleanup?.()}}async function _a(e,t,n){let r=await va(e,ya(n));try{return{source:ya(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 va(e,t){if(t.kind===`url`)return{source:t};let n=await z(e,t,{usage:`admin.install`,field:`source`});return{source:{kind:`path`,path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function ya(e){if(!e||typeof e!=`object`)throw new n(`INVALID_ARGS`,`install source is required`);if(e.kind===`path`)return{kind:`path`,path:K(e.path,`source.path`)};if(e.kind===`uploadedArtifact`)return{kind:`uploadedArtifact`,id:K(e.id,`source.id`)};if(e.kind===`url`){let t=K(e.url,`source.url`);return ba(t),{kind:`url`,url:t}}throw new n(`INVALID_ARGS`,`install source kind must be path, uploadedArtifact, or url`)}function ba(e){let t;try{t=new URL(e)}catch{throw new n(`INVALID_ARGS`,`Invalid install source URL: ${e}`)}if(t.protocol!==`http:`&&t.protocol!==`https:`)throw new n(`INVALID_ARGS`,`Install source URL must use http or https`)}function xa(e){if(!e)return;let t=G(e.id,`target.id`),n=G(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 Sa(e,t,n,r){let i=x(r),a=e===`reinstall`?`appReinstalled`:e===`installFromSource`?`appInstalledFromSource`:`appInstalled`,o=q(r,`appName`),s=q(r,`appId`),c=q(r,`bundleId`),l=q(r,`packageName`),u=q(r,`launchTarget`),d=q(r,`installablePath`),f=q(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}:{},...w(`${e===`reinstall`?`Reinstalled`:`Installed`}: ${o??u??t??Ca(n)}`)}}function q(e,t){let n=e[t];return typeof n==`string`&&n.length>0?n:void 0}function Ca(e){return e.kind===`path`?e.path:e.kind===`uploadedArtifact`?e.id:e.url}const wa=/^[A-Za-z0-9_.:-]{1,64}$/,Ta=async(e,t)=>{if(!e.backend.openApp)throw new n(`UNSUPPORTED_OPERATION`,`apps.open is not supported by this backend`);let r=ja(t),i=x(await e.backend.openApp(J(e,t),r,{launchArgs:t.launchArgs,relaunch:t.relaunch}));return{kind:`appOpened`,target:r,relaunch:t.relaunch===!0,...i?{backendResult:i}:{},...w(`Opened: ${Na(r)}`)}},Ea=async(e,t={})=>{if(!e.backend.closeApp)throw new n(`UNSUPPORTED_OPERATION`,`apps.close is not supported by this backend`);let r=G(t.app,`app`),i=x(await e.backend.closeApp(J(e,t),r));return{kind:`appClosed`,...r?{app:r}:{},...i?{backendResult:i}:{},...w(r?`Closed: ${r}`:`Closed app`)}},Da=async(e,t={})=>{if(!e.backend.listApps)throw new n(`UNSUPPORTED_OPERATION`,`apps.list is not supported by this backend`);return{kind:`appsList`,apps:await e.backend.listApps(J(e,t),ze(t.filter))}},Oa=async(e,t)=>{if(!e.backend.getAppState)throw new n(`UNSUPPORTED_OPERATION`,`apps.state is not supported by this backend`);let r=K(t.app,`app`);return{kind:`appState`,app:r,state:await e.backend.getAppState(J(e,t),r)}},ka=async(e,t)=>{if(!e.backend.pushFile)throw new n(`UNSUPPORTED_OPERATION`,`apps.push is not supported by this backend`);let r=K(t.app,`app`),i=await Pa(e,t.input);try{let n=x(await e.backend.pushFile(J(e,t),i.backendInput,r));return{kind:`appPushed`,app:r,inputKind:i.inputKind,...n?{backendResult:n}:{},...w(`Pushed to ${r}`)}}finally{await i.cleanup?.()}},Aa=async(e,t)=>{if(!e.backend.triggerAppEvent)throw new n(`UNSUPPORTED_OPERATION`,`apps.triggerEvent is not supported by this backend`);let r=Fa(t.name);Ia(t.payload,`apps.triggerEvent payload for "${r}"`);let i=x(await e.backend.triggerAppEvent(J(e,t),{name:r,...t.payload?{payload:t.payload}:{}}));return{kind:`appEventTriggered`,name:r,...t.payload?{payload:t.payload}:{},...i?{backendResult:i}:{},...w(`Triggered app event: ${r}`)}};function ja(e){let t=G(e.app,`app`),r=G(e.appId,`appId`),i=G(e.bundleId,`bundleId`),a=G(e.packageName,`packageName`),o=G(e.url,`url`),s=G(e.activity,`activity`),c={...t?{app:t}:{},...r?{appId:r}:{},...i?{bundleId:i}:{},...a?{packageName:a}:{},...o?{url:o}:{},...s?{activity:s}:{}};if(!Ma(c))throw new n(`INVALID_ARGS`,`apps.open requires app, appId, bundleId, packageName, url, or activity`);return c}function Ma(e){return!!(e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity)}function Na(e){return e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity??`app`}async function Pa(e,t){if(!t||typeof t!=`object`)throw new n(`INVALID_ARGS`,`apps.push requires an input`);if(t.kind===`json`)return La(t.payload,`apps.push JSON payload`,8192),{backendInput:{kind:`json`,payload:t.payload},inputKind:`json`};let r=await z(e,t,{usage:`apps.push`,field:`input`});return{backendInput:{kind:`file`,path:r.path},inputKind:`file`,...r.cleanup?{cleanup:r.cleanup}:{}}}function Fa(e){let t=K(e,`name`);if(!wa.test(t))throw new n(`INVALID_ARGS`,`Invalid apps.triggerEvent name: ${t}`,{hint:`Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash.`});return t}function Ia(e,t){e!==void 0&&La(e,t,8192)}function La(e,t,r){if(Ra(e,t),Buffer.byteLength(za(e,t),`utf8`)>r)throw new n(`INVALID_ARGS`,`${t} exceeds ${r} bytes`)}function Ra(e,t){if(!e||typeof e!=`object`||Array.isArray(e))throw new n(`INVALID_ARGS`,`${t} must be a JSON object`)}function za(e,t){try{let r=JSON.stringify(e);if(typeof r!=`string`)throw new n(`INVALID_ARGS`,`${t} must be JSON-serializable`);return r}catch{throw new n(`INVALID_ARGS`,`${t} must be JSON-serializable`)}}function J(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}const Y={open:Ta,close:Ea,list:Da,state:Oa,push:ka,triggerEvent:Aa},X={devices:ua,boot:da,shutdown:fa,install:pa,reinstall:ma,installFromSource:ha};function Ba(e){return{open:t=>Y.open(e,t),close:t=>Y.close(e,t),list:(t={})=>Y.list(e,{...t,filter:Be(t.filter)}),state:t=>Y.state(e,t),push:t=>Y.push(e,t),triggerEvent:t=>Y.triggerEvent(e,t)}}function Va(e){return{devices:t=>X.devices(e,t),boot:t=>X.boot(e,t),shutdown:t=>X.shutdown(e,t),install:t=>X.install(e,t),reinstall:t=>X.reinstall(e,t),installFromSource:t=>X.installFromSource(e,t)}}const Ha=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,Ua=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function Wa(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(Ua,()=>(t=!0,`[REDACTED]`)),n=Ka(n,()=>{t=!0}),{value:n,redacted:t}}function Ga(e){try{let t=new URL(e),n=qa(t);return(t.username||t.password)&&(t.username=`REDACTED`,t.password=`REDACTED`,n=!0),{value:t.toString(),redacted:n}}catch{return}}function Ka(e,t){return/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(e)?e.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let n=Ga(e);return n?(n.redacted&&t(),n.value):e}):e}function qa(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))Ha.test(n)&&(e.searchParams.set(n,`[REDACTED]`),t=!0);return t}const Z=2048,Ja=4096,Ya=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function Xa(e){let t=e.redacted===!0;return{kind:`diagnosticsLogs`,entries:e.entries.map(e=>{let n=Q(e.message,Ja),r=ro(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 Za(e,t){let n=e.redacted===!0;return{kind:`diagnosticsNetwork`,entries:e.entries.map(e=>{let r=e.url?eo(e.url):void 0,i=t===`headers`||t===`all`?$a(e.requestHeaders):void 0,a=t===`headers`||t===`all`?$a(e.responseHeaders):void 0,o=t===`body`||t===`all`?to(e.requestBody):void 0,s=t===`body`||t===`all`?to(e.responseBody):void 0,c=ro(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 Qa(e){let t=e.redacted===!0;return{kind:`diagnosticsPerf`,metrics:e.metrics.map(e=>{let n=Q(e.message,Ja),r=ro(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 $a(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[r,i]of Object.entries(e))if(Ya.test(r))n[r]=`[REDACTED]`,t=!0;else{let e=Q(i,Z);n[r]=e.value??``,t||=e.redacted}return{value:n,redacted:t}}function eo(e){return Ga(e)??Q(e,Z)}function to(e){return e===void 0?{redacted:!1}:no(e)??Q(e,Z)}function no(e){try{let t=io(JSON.parse(e),Wa);return ao(JSON.stringify(t.value),Z,t.redacted)}catch{return}}function ro(e){return io(e,e=>Q(e,Z))}function io(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=io(e,t);return n||=r.redacted,r.value}),redacted:n}}let n=!1,r={};for(let[i,a]of Object.entries(e)){if(Ya.test(i)){r[i]=`[REDACTED]`,n=!0;continue}let e=io(a,t);r[i]=e.value,n||=e.redacted}return{value:r,redacted:n}}function Q(e,t){if(e===void 0)return{redacted:!1};let n=Wa(e);return ao(n.value,t,n.redacted)}function ao(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 oo=async(e,t={})=>{if(!e.backend.readLogs)throw new n(`UNSUPPORTED_OPERATION`,`diagnostics.logs is not supported by this backend`);return Xa(await e.backend.readLogs(await lo(e,t),uo(t)))},so=async(e,t={})=>{if(!e.backend.dumpNetwork)throw new n(`UNSUPPORTED_OPERATION`,`diagnostics.network is not supported by this backend`);let r=fo(t);return Za(await e.backend.dumpNetwork(await lo(e,t),r),r.include??`summary`)},co=async(e,t={})=>{if(!e.backend.measurePerf)throw new n(`UNSUPPORTED_OPERATION`,`diagnostics.perf is not supported by this backend`);return Qa(await e.backend.measurePerf(await lo(e,t),po(t)))};async function lo(e,t){let n=v(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 uo(e){return{...mo(e,100,500,`logs limit`),...e.levels===void 0?{}:{levels:_o(e.levels,`levels`)},...e.search===void 0?{}:{search:K(e.search,`search`)},...e.source===void 0?{}:{source:K(e.source,`source`)}}}function fo(e){return{...mo(e,25,200,`network limit`),include:go(e.include)}}function po(e){return{...ho(e),...e.sampleMs===void 0?{}:{sampleMs:C(e.sampleMs,`sampleMs`,100,6e4)},...e.metrics===void 0?{}:{metrics:_o(e.metrics,`metrics`,20)}}}function mo(e,t,n,r){return{...ho(e),...e.cursor===void 0?{}:{cursor:K(e.cursor,`cursor`)},limit:e.limit===void 0?t:C(e.limit,r,1,n)}}function ho(e){return{...e.since===void 0?{}:{since:K(e.since,`since`)},...e.until===void 0?{}:{until:K(e.until,`until`)}}}function go(e){if(e===void 0)return`summary`;if(e===`summary`||e===`headers`||e===`body`||e===`all`)return e;throw new n(`INVALID_ARGS`,`network include must be summary, headers, body, or all`)}function _o(e,t,r=50){if(!Array.isArray(e))throw new n(`INVALID_ARGS`,`${t} must be an array of strings`);if(e.length>r)throw new n(`INVALID_ARGS`,`${t} must contain at most ${r} entries`);return e.map((e,n)=>K(e,`${t}[${n}]`))}const vo={logs:oo,network:so,perf:co};function yo(e){return{logs:t=>vo.logs(e,t),network:t=>vo.network(e,t),perf:t=>vo.perf(e,t)}}const bo=async(e,t)=>{let r=Eo(t.action,`record`),i=r===`start`?e.backend.startRecording:e.backend.stopRecording;if(!i)throw new n(`UNSUPPORTED_OPERATION`,`record ${r} is not supported by this backend`);let a=t.out?await B(e,t.out,{field:`path`,ext:`.mp4`,artifactType:`screen-recording`}):void 0;try{let n=So(t,a?.path);return Do(r,await i.call(e.backend,v(e,t),n),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}},xo=async(e,t)=>{let r=Eo(t.action,`trace`),i=r===`start`?e.backend.startTrace:e.backend.stopTrace;if(!i)throw new n(`UNSUPPORTED_OPERATION`,`trace ${r} is not supported by this backend`);let a=t.out?await B(e,t.out,{field:`outPath`,ext:`.trace`,artifactType:`trace-log`}):void 0;try{let n={...a?.path?{outPath:a.path}:{}};return Oo(r,await i.call(e.backend,v(e,t),n),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}};function So(e,t){let n={};t&&(n.outPath=t);let r=Co(e.fps);r!==void 0&&(n.fps=r);let i=wo(e.maxSize);i!==void 0&&(n.maxSize=i);let a=To(e.quality);return a!==void 0&&(n.quality=a),e.hideTouches!==void 0&&(n.showTouches=e.hideTouches!==!0),n}function Co(e){return e===void 0?void 0:C(e,`fps`,1,60)}function wo(e){return e===void 0?void 0:C(e,`maxSize`,1,2**53-1)}function To(e){if(e===void 0)return;let t=fe(e);if(t===void 0)throw new n(`INVALID_ARGS`,`quality must be one of: medium, high (legacy numeric values 5-10 are accepted)`);return t}function Eo(e,t){if(e===`start`||e===`stop`)return e;throw new n(`INVALID_ARGS`,`${t} action must be start or stop`)}function Do(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}:{},...ko(e,t,n,{startKind:`recordingStarted`,stopKind:`recordingStopped`,startMessage:`Recording started`,stopMessage:`Recording stopped`})}}function Oo(e,t,n){return{...typeof t.outPath==`string`?{outPath:t.outPath}:{},...ko(e,t,n,{startKind:`traceStarted`,stopKind:`traceStopped`,startMessage:`Trace started`,stopMessage:`Trace stopped`})}}function ko(e,t,n,r){return{kind:e===`start`?r.startKind:r.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...w(e===`start`?r.startMessage:r.stopMessage)}}const Ao={record:bo,trace:xo};function jo(e){return{record:t=>Ao.record(e,t),trace:t=>Ao.trace(e,t)}}const Mo=async(e,t={})=>{if(!e.backend.pressBack)throw new n(`UNSUPPORTED_OPERATION`,`system.back is not supported by this backend`);let r=t.mode??`in-app`;if(r!==`in-app`&&r!==`system`)throw new n(`INVALID_ARGS`,`system.back mode must be in-app or system`);let i=x(await e.backend.pressBack(v(e,t),{mode:r}));return{kind:`systemBack`,mode:r,...i?{backendResult:i}:{},...w(`Back`)}},No=async(e,t={})=>{if(!e.backend.pressHome)throw new n(`UNSUPPORTED_OPERATION`,`system.home is not supported by this backend`);let r=x(await e.backend.pressHome(v(e,t)));return{kind:`systemHome`,...r?{backendResult:r}:{},...w(`Home`)}},Po=async(e,t)=>{if(!e.backend.pressTvRemote)throw new n(`UNSUPPORTED_OPERATION`,`system.tvRemote is not supported by this backend`);let r=_e(t.button),i=t.durationMs===void 0?void 0:C(t.durationMs,`durationMs`,0,1e4),a=x(await e.backend.pressTvRemote(v(e,t),{button:r,...i===void 0?{}:{durationMs:i}}));return{kind:`tvRemotePressed`,button:r,...i===void 0?{}:{durationMs:i},...a?{backendResult:a}:{},...w(`Pressed TV remote ${r}`)}},Fo=async(e,t)=>{if(!e.backend.rotate)throw new n(`UNSUPPORTED_OPERATION`,`system.rotate is not supported by this backend`);let r=Vo(t.orientation),i=x(await e.backend.rotate(v(e,t),r));return{kind:`systemRotated`,orientation:r,...i?{backendResult:i}:{},...w(`Rotated to ${r}`)}},Io=async(e,t={})=>{if(!e.backend.setKeyboard)throw new n(`UNSUPPORTED_OPERATION`,`system.keyboard is not supported by this backend`);let r=t.action??`status`;if(!Ht(r))throw new n(`INVALID_ARGS`,`system.keyboard action must be status, get, dismiss, enter, or return`);let i=await e.backend.setKeyboard(v(e,t),{action:r}),a=x(i),o=Yo(i)?i:{};return r===`enter`||r===`return`?Uo(o,a):r===`dismiss`?Wo(r,o,a):Go(r,o,a)},Lo=async(e,t)=>{if(t.action===`read`){if(!e.backend.getClipboard)throw new n(`UNSUPPORTED_OPERATION`,`system.clipboard read is not supported by this backend`);let r=await e.backend.getClipboard(v(e,t));return{kind:`clipboardText`,action:`read`,text:typeof r==`string`?r:r.text}}if(t.action!==`write`)throw new n(`INVALID_ARGS`,`system.clipboard action must be read or write`);if(!e.backend.setClipboard)throw new n(`UNSUPPORTED_OPERATION`,`system.clipboard write is not supported by this backend`);if(typeof t.text!=`string`)throw new n(`INVALID_ARGS`,`system.clipboard write requires text`);let r=x(await e.backend.setClipboard(v(e,t),t.text));return{kind:`clipboardUpdated`,action:`write`,textLength:Array.from(t.text).length,...r?{backendResult:r}:{},...w(`Clipboard updated`)}},Ro=async(e,t={})=>{if(!e.backend.openSettings)throw new n(`UNSUPPORTED_OPERATION`,`system.settings is not supported by this backend`);let r=G(t.target,`target`),i=x(await e.backend.openSettings(v(e,t),r));return{kind:`settingsOpened`,...r?{target:r}:{},...i?{backendResult:i}:{},...w(r?`Opened settings: ${r}`:`Opened settings`)}},zo=async(e,t={})=>{if(!e.backend.handleAlert)throw new n(`UNSUPPORTED_OPERATION`,`system.alert is not supported by this backend`);let r=t.action??`get`;if(r!==`get`&&r!==`accept`&&r!==`dismiss`&&r!==`wait`)throw new n(`INVALID_ARGS`,`system.alert action must be get, accept, dismiss, or wait`);let i=t.timeoutMs===void 0?void 0:C(t.timeoutMs,`timeoutMs`,0,12e4);return Ho(r,await e.backend.handleAlert(v(e,t),r,{timeoutMs:i}))},Bo=async(e,t={})=>{if(!e.backend.openAppSwitcher)throw new n(`UNSUPPORTED_OPERATION`,`system.appSwitcher is not supported by this backend`);let r=x(await e.backend.openAppSwitcher(v(e,t)));return{kind:`appSwitcherOpened`,...r?{backendResult:r}:{},...w(`Opened app switcher`)}};function Vo(e){switch(e){case`portrait`:case`portrait-upside-down`:case`landscape-left`:case`landscape-right`:return e;default:throw new n(`INVALID_ARGS`,`system.rotate orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right`)}}function Ho(e,t){return e===`get`?Ko(t):e===`wait`?qo(t):Jo(e,t)}function Uo(e,t){return{kind:`keyboardEnterPressed`,action:`enter`,state:e,...t?{backendResult:t}:{},...w(`Keyboard enter pressed`)}}function Wo(e,t,n){return{kind:`keyboardDismissed`,action:e,state:t,...n?{backendResult:n}:{},...w(t.dismissed===!1?`Keyboard already hidden`:`Keyboard dismissed`)}}function Go(e,t,n){return{kind:`keyboardState`,action:e,state:t,...n?{backendResult:n}:{}}}function Ko(e){if(e.kind!==`alertStatus`)throw new n(`COMMAND_FAILED`,`system.alert get returned an invalid backend result`);return{kind:`alertStatus`,action:`get`,alert:e.alert}}function qo(e){if(e.kind!==`alertWait`)throw new n(`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},...w(e.alert?`Alert visible`:`Alert wait timed out`)}}function Jo(e,t){if(t.kind!==`alertHandled`)throw new n(`COMMAND_FAILED`,`system.alert ${e} returned an invalid backend result`);return{kind:`alertHandled`,action:e,handled:t.handled,...t.alert?{alert:t.alert}:{},...t.button?{button:t.button}:{},...w(t.handled?`Alert ${e}ed`:`No alert handled`)}}function Yo(e){return!!(e&&typeof e==`object`)}const $={back:Mo,home:No,rotate:Fo,keyboard:Io,clipboard:Lo,settings:Ro,alert:zo,appSwitcher:Bo,tvRemote:Po};function Xo(e){return{back:t=>$.back(e,t),home:t=>$.home(e,t),rotate:t=>$.rotate(e,t),keyboard:t=>$.keyboard(e,t),clipboard:t=>$.clipboard(e,t),settings:t=>$.settings(e,t),alert:t=>$.alert(e,t),appSwitcher:t=>$.appSwitcher(e,t),tvRemote:t=>$.tvRemote(e,t)}}function Zo(e){return{capture:ki(e),selectors:ca(e),interactions:la(e),system:Xo(e),apps:Ba(e),admin:Va(e),recording:jo(e),observability:yo(e)}}var Qo=e({createAgentDevice:()=>$o,createMemorySessionStore:()=>es,localCommandPolicy:()=>rs,restrictedCommandPolicy:()=>is});function $o(e){let t={backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??es(),policy:e.policy??is(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal};return{...t,...Zo(t)}}function es(e=[]){let t=new Map(e.map(e=>[e.name,ts(e)]));return{get:e=>ts(t.get(e)),set:e=>{t.set(e.name,ts(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>ts(e))}}function ts(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:ns(e.metadata)}:{}}}function ns(e){try{return structuredClone(e)}catch{return{...e}}}function rs(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,allowNamedBackendCapabilities:[],...e}}function is(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,allowNamedBackendCapabilities:[],...e}}export{j as a,an as c,nt as d,tt as f,rt as h,ii as i,Ut as l,at as m,rs as n,M as o,it as p,Qo as r,rn as s,$o as t,Ht as u};
+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};

package/dist/src/runtime2.js

@@ -0,0 +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};

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

@@ -1,5 +1,111 @@
+import { A as Point, j as Rect } 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';
+type AndroidSnapshotHelperInstallReason = 'missing' | 'outdated' | 'mismatched' | 'unverifiable' | 'forced' | 'current' | 'skipped';
+type AndroidSnapshotHelperManifest = {
+  name: 'android-snapshot-helper';
+  version: string;
+  releaseTag?: string;
+  assetName?: string;
+  apkUrl: string | null;
+  sha256: string;
+  checksumName?: string;
+  packageName: string;
+  versionCode: number;
+  instrumentationRunner: string;
+  minSdk: number;
+  targetSdk?: number;
+  outputFormat: 'uiautomator-xml';
+  statusProtocol: 'android-snapshot-helper-v1';
+  installArgs: string[];
+};
+type AndroidSnapshotHelperArtifact = {
+  apkPath: string;
+  manifest: AndroidSnapshotHelperManifest;
+};
+//#endregion
+//#region src/contracts/scroll-gesture.d.ts
+declare const SCROLL_DIRECTIONS: readonly ['up', 'down', 'left', 'right'];
+type ScrollDirection = (typeof SCROLL_DIRECTIONS)[number];
+declare const SWIPE_PRESETS: readonly ['left', 'right', 'left-edge', 'right-edge'];
+type SwipePreset = (typeof SWIPE_PRESETS)[number];
+declare const SWIPE_PATTERNS: readonly ['one-way', 'ping-pong'];
+type SwipePattern = (typeof SWIPE_PATTERNS)[number];
+type TransformGestureParams = {
+  x: number;
+  y: number;
+  dx: number;
+  dy: number;
+  scale: number;
+  degrees: number;
+  durationMs?: number;
+};
+//#endregion
+//#region src/contracts/gesture-plan-types.d.ts
+type GesturePointerCount = 1 | 2;
+/** Selects one-pointer release timing without changing semantic gesture intent. */
+type GestureExecutionProfile = 'endpoint-hold' | 'timed-pan';
+type PointerTrajectorySample = {
+  offsetMs: number;
+  point: Point;
+};
+type PointerTrajectory = {
+  pointerId: 0 | 1;
+  samples: readonly PointerTrajectorySample[];
+};
+type SinglePointerGesturePlan = {
+  topology: 'single';
+  intent: 'fling' | 'pan';
+  executionProfile: GestureExecutionProfile;
+  durationMs: number;
+  viewport: Rect;
+  pointers: readonly [PointerTrajectory];
+};
+type MultiTouchGesturePlan = {
+  topology: 'two';
+  intent: 'pan' | 'pinch' | 'rotate' | 'transform';
+  durationMs: number;
+  viewport: Rect;
+  pointers: readonly [PointerTrajectory, PointerTrajectory];
+};
+type GesturePlan = SinglePointerGesturePlan | MultiTouchGesturePlan;
+//#endregion
+//#region src/platforms/android/touch-plan.d.ts
+type AndroidLongPressTouchPlan = {
+  topology: 'single';
+  intent: 'longPress';
+  durationMs: number;
+  pointers: readonly [PointerTrajectory];
+};
+type AndroidProviderTouchPlan = GesturePlan | (AndroidLongPressTouchPlan & {
+  viewport: Rect;
+});
+//#endregion
 //#region src/utils/exec.d.ts
 type ExecResult = {
   stdout: string;
@@ -95,37 +201,9 @@ type AndroidTextInjectionRequest = {
   };
 };
 type AndroidTextInjector = (request: AndroidTextInjectionRequest) => Promise<void>;
-type AndroidTouchGestureRequest = {
-  kind: 'swipe';
-  x1: number;
-  y1: number;
-  x2: number;
-  y2: number;
-  durationMs?: number;
-} | {
-  kind: 'pinch';
-  x: number;
-  y: number;
-  scale: number;
-  durationMs?: number;
-} | {
-  kind: 'rotate';
-  x: number;
-  y: number;
-  degrees: number;
-  durationMs?: number;
-} | {
-  kind: 'transform';
-  x: number;
-  y: number;
-  dx: number;
-  dy: number;
-  scale: number;
-  degrees: number;
-  durationMs?: number;
-};
-type AndroidTouchInjector = (request: AndroidTouchGestureRequest) => Promise<Record<string, unknown> | void>;
-type AndroidAdbProvider = {
+type AndroidTouchInjector = (request: AndroidProviderTouchPlan) => Promise<Record<string, unknown> | void>;
+type AndroidGestureViewportProvider = () => Promise<Rect>;
+type AndroidAdbProviderBase = {
   /**
    * Fallback executor for device-scoped adb arguments. Providers may omit explicit
    * methods to keep the legacy exec-shaped pull/install fallback.
@@ -137,8 +215,16 @@ type AndroidAdbProvider = {
   install?: AndroidAdbInstaller;
   installBundle?: AndroidBundleInstaller;
   text?: AndroidTextInjector;
-  touch?: AndroidTouchInjector;
+  snapshotHelperArtifact?: AndroidSnapshotHelperArtifact;
+};
+type AndroidTouchCapabilities = {
+  touch?: never;
+  gestureViewport?: never;
+} | {
+  touch: AndroidTouchInjector;
+  gestureViewport: AndroidGestureViewportProvider;
 };
+type AndroidAdbProvider = AndroidAdbProviderBase & AndroidTouchCapabilities;
 declare function createAndroidPortReverseManager(provider: AndroidAdbProvider | AndroidAdbExecutor): AndroidPortReverseProvider;
 //#endregion
-export { createAndroidPortReverseManager as i, AndroidAdbExecutorOptions as n, AndroidPortReverseEndpoint as r, AndroidAdbExecutor as t };
+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 };