npm - agent-device - Versions diffs - 0.19.3 → 0.20.1 - Mend

agent-device 0.19.3 → 0.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (179) hide show

package/dist/src/runner-sequence.js CHANGED Viewed

	@@ -1 +1 @@
1	- import{t as e}from"./rolldown-runtime.js";import{_ as t,w as n}from"./sdk-contracts.js";var r=e({MAX_RUNNER_SEQUENCE_STEPS:()=>20,SEQUENCEABLE_RUNNER_STEP_KINDS:()=>i,buildRunnerSequenceCommand:()=>u,parseRunnerSequenceResult:()=>d,validateRunnerSequenceSteps:()=>s});const i=[`tap`,`doubleTap`,`longPress~~`,`drag~~`];function a(e){return typeof e==`string`&&i.includes(e)}function o(e,n,r){return new t(`INVALID_ARGS`,r,{stepIndex:e,kind:typeof n==`string`?n:void 0})}function s(e){if(!Array.isArray(e)\|\|e.length===0)throw new t(`INVALID_ARGS`,`sequence requires at least one step`,{stepCount:Array.isArray(e)?e.length:0});if(e.length>20)throw new t(`INVALID_ARGS`,`sequence accepts at most 20 steps, received ${e.length}`,{stepCount:e.length,maxSteps:20});e.forEach((e,t)=>c(e,t))}function c(e,t){if(!a(e.kind))throw o(t,e.kind,`sequence step ${t} has unsupported kind "${String(e.kind)}"; allowed: ${i.join(`, `)}`);if(!Number.isFinite(e.x)\|\|!Number.isFinite(e.y))throw o(t,e.kind,`sequence step ${t} (${e.kind}) requires finite x and y`);~~if(~~e.~~kind===`drag`&&(!Number.isFinite(e.x2)\|\|!Number.isFinite(e.y2)))throw o(t,e.kind,`sequence step ${t} (drag) requires finite x2 and y2`);e.~~durationMs!==void 0&&l(e.durationMs,0,1e4,t,e.kind,`durationMs`),e.pauseMs!==void 0&&l(e.pauseMs,0,1e4,t,e.kind,`pauseMs`)}function l(e,t,n,r,i,a){if(!Number.isFinite(e)\|\|e<t\|\|e>n)throw o(r,i,`sequence step ${r} (${i}) ${a} must be between ${t} and ${n}`)}function u(e,t){return s(e),{command:`sequence`,steps:e,appBundleId:t}}function d(e){let t=p(e.sequenceResults),n=typeof e.completedSteps==`number`&&Number.isFinite(e.completedSteps)?e.completedSteps:t.filter(e=>e.ok).length,r=typeof e.failedStepIndex==`number`&&Number.isFinite(e.failedStepIndex)?e.failedStepIndex:t.findIndex(e=>!e.ok)>=0?t.findIndex(e=>!e.ok):void 0;if(r!==void 0)throw f(t,n,r);return{results:t,completedSteps:n,failedStepIndex:r}}function f(e,r,i){let a=e[i],o=a?.kind??`step`,s=a?.errorMessage??`sequence step ${i} (${o}) failed`;return new t(n(a?.errorCode),s,{failedStepIndex:i,failedStepKind:o,completedSteps:r,sequenceResults:e,hint:`Run snapshot -i to inspect the current UI, then continue from the observed state.`})}function p(e){return Array.isArray(e)?e.map(e=>{let t=e??{};return{ok:t.ok===!0,kind:typeof t.kind==`string`?t.kind:`unknown`,errorCode:typeof t.errorCode==`string`?t.errorCode:void 0,errorMessage:typeof t.errorMessage==`string`?t.errorMessage:void 0,gestureStartUptimeMs:typeof t.gestureStartUptimeMs==`number`?t.gestureStartUptimeMs:void 0,gestureEndUptimeMs:typeof t.gestureEndUptimeMs==`number`?t.gestureEndUptimeMs:void 0}}):[]}export{d as n,r,u as t};
1	+ import{t as e}from"./rolldown-runtime.js";import{_ as t,w as n}from"./sdk-contracts.js";var r=e({MAX_RUNNER_SEQUENCE_STEPS:()=>20,SEQUENCEABLE_RUNNER_STEP_KINDS:()=>i,buildRunnerSequenceCommand:()=>u,parseRunnerSequenceResult:()=>d,validateRunnerSequenceSteps:()=>s});const i=[`tap`,`doubleTap`,`longPress`];function a(e){return typeof e==`string`&&i.includes(e)}function o(e,n,r){return new t(`INVALID_ARGS`,r,{stepIndex:e,kind:typeof n==`string`?n:void 0})}function s(e){if(!Array.isArray(e)\|\|e.length===0)throw new t(`INVALID_ARGS`,`sequence requires at least one step`,{stepCount:Array.isArray(e)?e.length:0});if(e.length>20)throw new t(`INVALID_ARGS`,`sequence accepts at most 20 steps, received ${e.length}`,{stepCount:e.length,maxSteps:20});e.forEach((e,t)=>c(e,t))}function c(e,t){if(!a(e.kind))throw o(t,e.kind,`sequence step ${t} has unsupported kind "${String(e.kind)}"; allowed: ${i.join(`, `)}`);if(!Number.isFinite(e.x)\|\|!Number.isFinite(e.y))throw o(t,e.kind,`sequence step ${t} (${e.kind}) requires finite x and y`);e.durationMs!==void 0&&l(e.durationMs,0,1e4,t,e.kind,`durationMs`),e.pauseMs!==void 0&&l(e.pauseMs,0,1e4,t,e.kind,`pauseMs`)}function l(e,t,n,r,i,a){if(!Number.isFinite(e)\|\|e<t\|\|e>n)throw o(r,i,`sequence step ${r} (${i}) ${a} must be between ${t} and ${n}`)}function u(e,t){return s(e),{command:`sequence`,steps:e,appBundleId:t}}function d(e){let t=p(e.sequenceResults),n=typeof e.completedSteps==`number`&&Number.isFinite(e.completedSteps)?e.completedSteps:t.filter(e=>e.ok).length,r=typeof e.failedStepIndex==`number`&&Number.isFinite(e.failedStepIndex)?e.failedStepIndex:t.findIndex(e=>!e.ok)>=0?t.findIndex(e=>!e.ok):void 0;if(r!==void 0)throw f(t,n,r);return{results:t,completedSteps:n,failedStepIndex:r}}function f(e,r,i){let a=e[i],o=a?.kind??`step`,s=a?.errorMessage??`sequence step ${i} (${o}) failed`;return new t(n(a?.errorCode),s,{failedStepIndex:i,failedStepKind:o,completedSteps:r,sequenceResults:e,hint:`Run snapshot -i to inspect the current UI, then continue from the observed state.`})}function p(e){return Array.isArray(e)?e.map(e=>{let t=e??{};return{ok:t.ok===!0,kind:typeof t.kind==`string`?t.kind:`unknown`,errorCode:typeof t.errorCode==`string`?t.errorCode:void 0,errorMessage:typeof t.errorMessage==`string`?t.errorMessage:void 0,gestureStartUptimeMs:typeof t.gestureStartUptimeMs==`number`?t.gestureStartUptimeMs:void 0,gestureEndUptimeMs:typeof t.gestureEndUptimeMs==`number`?t.gestureEndUptimeMs:void 0}}):[]}export{d as n,r,u as t};

package/dist/src/runtime.js CHANGED Viewed

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

package/dist/src/runtime2.js ADDED Viewed

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

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

@@ -1,5 +1,89 @@
+import { E as Rect, T as Point } from "./sdk-contracts.js";
 import { Readable, Writable } from "node:stream";
 import { StdioOptions, spawn } from "node:child_process";
+//#region src/platforms/android/snapshot-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 +179,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 +193,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, AndroidSnapshotHelperInstallReason as d, AndroidSnapshotHelperTransport as f, createAndroidPortReverseManager as i, TransformGestureParams as l, AndroidAdbExecutorOptions as n, ScrollDirection as o, AndroidPortReverseEndpoint as r, SwipePattern as s, AndroidAdbExecutor as t, AndroidSnapshotCaptureMode as u };