agent-device 0.21.1 → 0.21.3

package/dist/src/runner-presentation.js

@@ -1 +1 @@
-import{Hr as e,Lr as t,Rr as n,jr as r}from"./sdk-batch.js";import{n as i}from"./ios-snapshot-planning.js";import{t as a}from"./semantic-index.js";var o=class extends Error{code=`IOS_SNAPSHOT_ENGINE_FAILED`;reason;details;constructor(e,t,n={}){super(t),this.name=`IosSnapshotEngineError`,this.reason=e,this.details=n}};function s(e){return{reason:e.reason,...e.details}}function c(e){let t=new Map;for(let[n,r]of e.entries()){if(!Number.isInteger(r.index)||r.index<0||t.has(r.index))throw new o(`malformed-graph`,`iOS snapshot graph contains a duplicate or invalid node index`,{index:r.index});if(t.set(r.index,n),r.depth!==void 0&&(!Number.isInteger(r.depth)||r.depth<0))throw new o(`malformed-graph`,`iOS snapshot graph contains an invalid node depth`,{index:r.index,field:`depth`})}for(let[n,r]of e.entries()){if(r.parentIndex===void 0)continue;let e=t.get(r.parentIndex);if(e===void 0||e>=n)throw new o(`malformed-graph`,`iOS snapshot graph parent must precede its child`,{index:r.index,parentIndex:r.parentIndex})}}const l=new Set([`collectionview`,`scrollview`,`table`]);function u(e){return d(e.viewport)}function d(e){if(e.kind===`missing`)throw new o(e.reason===`invalid`?`invalid-viewport`:`missing-viewport`,`regular iOS snapshot presentation requires a valid viewport`,{field:`viewport`});if(!n(e.rect))throw new o(`invalid-viewport`,`regular iOS snapshot presentation requires a positive finite viewport`,{field:`viewport`});return e.rect}function f(e,t,r,i=!0){c(e);let a=new Map,o=0;for(let s of e){let e=p(s,a,t,()=>{o+=1}),c=b(s.rect);if(m(s,i),!c||!n(c)){h(s,c),a.set(s.index,e);continue}g(s,c,e),_(s,c,t),a.set(s.index,v(s,c,e,r))}return{parentClipLookups:o}}function p(e,t,n,r){if(e.parentIndex===void 0)return n;r();let i=t.get(e.parentIndex);if(!i)throw new o(`invalid-presented-payload`,`regular iOS snapshot payload refers to a parent outside the payload`,{index:e.index,parentIndex:e.parentIndex});return i}function m(e,t){if(!(e.hittable!==!0||t))throw new o(`invalid-presented-payload`,`iOS snapshot payload marked a node actionable without hittability evidence`,{index:e.index})}function h(e,t){if(e.hittable===!0)throw new o(`regular-degenerate-actionable-node`,`regular iOS snapshot node with a missing or degenerate frame is actionable`,{index:e.index,frame:t??e.rect})}function g(e,t,n){if(!x(t,n))throw new o(`regular-node-outside-cumulative-clip`,`regular iOS snapshot node escaped its cumulative clip`,{index:e.index,frame:t,clip:n})}function _(e,n,r){if(!(e.hittable!==!0||e.enabled!==!1&&t(r,n.x+n.width/2,n.y+n.height/2)))throw new o(`invalid-presented-payload`,`regular iOS snapshot payload marked a disabled or off-viewport node actionable`,{index:e.index,frame:n})}function v(e,t,n,i){return i===`cursor-projected`&&l.has(r(e.type??``))?t:n}function y(e,t,n,r,i=!0){if(t===`raw`)return c(e),{parentClipLookups:0};if(!n)throw new o(`missing-viewport`,`regular iOS snapshot payload cannot be validated without a viewport`,{field:`viewport`});try{return f(e,n,r,i)}catch(e){throw e instanceof o&&e.code===`IOS_SNAPSHOT_ENGINE_FAILED`&&e.reason===`malformed-graph`?new o(`invalid-presented-payload`,e.message,e.details):e}}function b(e){if(!(!e||![e.x,e.y,e.width,e.height].every(Number.isFinite))&&!(e.width<0||e.height<0))return{...e,width:Math.max(0,e.width),height:Math.max(0,e.height)}}function x(t,n){let r=1e-4;return e({x:n.x-r,y:n.y-r,width:n.width+r*2,height:n.height+r*2},t)}function S(e,t,n=`cursor-projected`){C(e,t);let r=e.validation.presentationKey.projection,i=r===`regular`?d(e.validation.viewport):void 0,a=e.validation.hittability.kind===`available`,o=w(e,r,i,n,a),s=T(e.presentation.payload.nodes,r,t),c=E(s.nodes,r,i,n,a,o);return{nodes:s.nodes,...e.presentation.qualityPayload?{qualityNodes:[...e.presentation.qualityPayload.nodes]}:{},presentedIndexesBySourceIndex:s.presentedIndexesBySourceIndex,stats:{presentedNodeCount:s.nodes.length,sourceNodeCount:e.presentation.payload.nodes.length,parentClipLookups:c.parentClipLookups}}}function C(e,t){if(!D(i(t),e.validation.presentationKey))throw new o(`projection-mismatch`,`presented iOS snapshot does not match the requested presentation key`,{projection:e.validation.presentationKey.projection});if(e.presentation.intent!==t.acquisitionIntent)throw new o(`projection-mismatch`,`presented iOS snapshot does not match the requested acquisition intent`,{field:`acquisitionIntent`})}function w(e,t,n,r,i){let a=y(e.presentation.payload.nodes,t,n,r,i);if(e.presentation.qualityPayload)try{y(e.presentation.qualityPayload.nodes,t,n,r,i)}catch(e){throw e instanceof o?new o(`invalid-quality-payload`,e.message,e.details):e}return a}function T(e,t,n){return t===`regular`&&n.interactiveOnly?a([...e]):{nodes:[...e],presentedIndexesBySourceIndex:O(e)}}function E(e,t,n,r,i,a){return t!==`regular`||!n?a:y(e,t,n,r,i)}function D(e,t){return e.projection===t.projection&&e.interactiveOnly===t.interactiveOnly&&e.depth===t.depth&&e.scope===t.scope&&e.customActions===t.customActions}function O(e){return new Map(e.map(e=>[e.index,[e.index]]))}export{o as a,c as i,u as n,s as o,y as r,S as t};
+import{Mr as e,Rr as t,Ur as n,zr as r}from"./sdk-batch.js";import{n as i}from"./ios-snapshot-planning.js";import{t as a}from"./semantic-index.js";var o=class extends Error{code=`IOS_SNAPSHOT_ENGINE_FAILED`;reason;details;constructor(e,t,n={}){super(t),this.name=`IosSnapshotEngineError`,this.reason=e,this.details=n}};function s(e){return{reason:e.reason,...e.details}}function c(e){let t=new Map;for(let[n,r]of e.entries()){if(!Number.isInteger(r.index)||r.index<0||t.has(r.index))throw new o(`malformed-graph`,`iOS snapshot graph contains a duplicate or invalid node index`,{index:r.index});if(t.set(r.index,n),r.depth!==void 0&&(!Number.isInteger(r.depth)||r.depth<0))throw new o(`malformed-graph`,`iOS snapshot graph contains an invalid node depth`,{index:r.index,field:`depth`})}for(let[n,r]of e.entries()){if(r.parentIndex===void 0)continue;let e=t.get(r.parentIndex);if(e===void 0||e>=n)throw new o(`malformed-graph`,`iOS snapshot graph parent must precede its child`,{index:r.index,parentIndex:r.parentIndex})}}const l=new Set([`collectionview`,`scrollview`,`table`]);function u(e){return d(e.viewport)}function d(e){if(e.kind===`missing`)throw new o(e.reason===`invalid`?`invalid-viewport`:`missing-viewport`,`regular iOS snapshot presentation requires a valid viewport`,{field:`viewport`});if(!r(e.rect))throw new o(`invalid-viewport`,`regular iOS snapshot presentation requires a positive finite viewport`,{field:`viewport`});return e.rect}function f(e,t,n,i=!0){c(e);let a=new Map,o=0;for(let s of e){let e=p(s,a,t,()=>{o+=1}),c=b(s.rect);if(m(s,i),!c||!r(c)){h(s,c),a.set(s.index,e);continue}g(s,c,e),_(s,c,t),a.set(s.index,v(s,c,e,n))}return{parentClipLookups:o}}function p(e,t,n,r){if(e.parentIndex===void 0)return n;r();let i=t.get(e.parentIndex);if(!i)throw new o(`invalid-presented-payload`,`regular iOS snapshot payload refers to a parent outside the payload`,{index:e.index,parentIndex:e.parentIndex});return i}function m(e,t){if(!(e.hittable!==!0||t))throw new o(`invalid-presented-payload`,`iOS snapshot payload marked a node actionable without hittability evidence`,{index:e.index})}function h(e,t){if(e.hittable===!0)throw new o(`regular-degenerate-actionable-node`,`regular iOS snapshot node with a missing or degenerate frame is actionable`,{index:e.index,frame:t??e.rect})}function g(e,t,n){if(!x(t,n))throw new o(`regular-node-outside-cumulative-clip`,`regular iOS snapshot node escaped its cumulative clip`,{index:e.index,frame:t,clip:n})}function _(e,n,r){if(!(e.hittable!==!0||e.enabled!==!1&&t(r,n.x+n.width/2,n.y+n.height/2)))throw new o(`invalid-presented-payload`,`regular iOS snapshot payload marked a disabled or off-viewport node actionable`,{index:e.index,frame:n})}function v(t,n,r,i){return i===`cursor-projected`&&l.has(e(t.type??``))?n:r}function y(e,t,n,r,i=!0){if(t===`raw`)return c(e),{parentClipLookups:0};if(!n)throw new o(`missing-viewport`,`regular iOS snapshot payload cannot be validated without a viewport`,{field:`viewport`});try{return f(e,n,r,i)}catch(e){throw e instanceof o&&e.code===`IOS_SNAPSHOT_ENGINE_FAILED`&&e.reason===`malformed-graph`?new o(`invalid-presented-payload`,e.message,e.details):e}}function b(e){if(!(!e||![e.x,e.y,e.width,e.height].every(Number.isFinite))&&!(e.width<0||e.height<0))return{...e,width:Math.max(0,e.width),height:Math.max(0,e.height)}}function x(e,t){let r=1e-4;return n({x:t.x-r,y:t.y-r,width:t.width+r*2,height:t.height+r*2},e)}function S(e,t,n=`cursor-projected`){C(e,t);let r=e.validation.presentationKey.projection,i=r===`regular`?d(e.validation.viewport):void 0,a=e.validation.hittability.kind===`available`,o=w(e,r,i,n,a),s=T(e.presentation.payload.nodes,r,t),c=E(s.nodes,r,i,n,a,o);return{nodes:s.nodes,...e.presentation.qualityPayload?{qualityNodes:[...e.presentation.qualityPayload.nodes]}:{},presentedIndexesBySourceIndex:s.presentedIndexesBySourceIndex,stats:{presentedNodeCount:s.nodes.length,sourceNodeCount:e.presentation.payload.nodes.length,parentClipLookups:c.parentClipLookups}}}function C(e,t){if(!D(i(t),e.validation.presentationKey))throw new o(`projection-mismatch`,`presented iOS snapshot does not match the requested presentation key`,{projection:e.validation.presentationKey.projection});if(e.presentation.intent!==t.acquisitionIntent)throw new o(`projection-mismatch`,`presented iOS snapshot does not match the requested acquisition intent`,{field:`acquisitionIntent`})}function w(e,t,n,r,i){let a=y(e.presentation.payload.nodes,t,n,r,i);if(e.presentation.qualityPayload)try{y(e.presentation.qualityPayload.nodes,t,n,r,i)}catch(e){throw e instanceof o?new o(`invalid-quality-payload`,e.message,e.details):e}return a}function T(e,t,n){return t===`regular`&&n.interactiveOnly?a([...e]):{nodes:[...e],presentedIndexesBySourceIndex:O(e)}}function E(e,t,n,r,i,a){return t!==`regular`||!n?a:y(e,t,n,r,i)}function D(e,t){return e.projection===t.projection&&e.interactiveOnly===t.interactiveOnly&&e.depth===t.depth&&e.scope===t.scope&&e.customActions===t.customActions}function O(e){return new Map(e.map(e=>[e.index,[e.index]]))}export{o as a,c as i,u as n,s as o,y as r,S as t};

package/dist/src/runtime.js

@@ -1,3 +1,3 @@
-import{r as e}from"./rolldown-runtime.js";import{A as t,C as n,S as r,f as i,g as a,m as o,p as s,w as c}from"./sdk-contracts.js";import{p as l}from"./capture.js";import{r as u,t as d}from"./snapshot-capture-annotations.js";import{f,l as p,n as m}from"./android-input-ownership.js";import{Bn as h,Cn as g,Dr as _,Er as ee,Fn as v,Gn as te,Hn as y,In as ne,Lr as re,Mn as ie,Nn as ae,Nr as oe,On as se,Or as ce,Pn as le,Pr as ue,Sn as de,Tn as fe,Tr as pe,Un as me,Vn as he,Vr as ge,_n as _e,an as ve,bn as ye,cr as be,gn as xe,gr as Se,hn as b,jr as x,kr as Ce,lr as we,rr as Te,ur as Ee,xr as S,yn as De,zn as Oe}from"./sdk-batch.js";import{n as ke}from"./snapshot-scope.js";import{r as Ae}from"./recording-export-quality.js";import{n as C}from"./success-text.js";import{a as je,d as Me,f as Ne,i as Pe,l as Fe,n as Ie,o as Le,p as Re,r as ze,t as Be,u as Ve}from"./app-inventory-contract.js";import{n as He,t as Ue}from"./mobile-snapshot-semantics.js";import{n as We,r as Ge}from"./app-inventory.js";import{a as Ke,n as qe,o as Je,t as Ye}from"./react-native-overlay.js";import{r as Xe}from"./tv-remote.js";import{i as w,n as T,t as Ze}from"./rect-center.js";import{a as Qe,n as $e,t as et}from"./gesture-plan.js";import{n as tt,o as nt,r as rt}from"./android-system-chrome.js";import{t as it}from"./keyboard-actions.js";import{a as at}from"./png-worker-contract.js";import{a as ot,c as st,l as ct,n as lt,s as ut,t as dt}from"./snapshot-quality-verdict.js";import{n as ft}from"./ios-snapshot-acquisition.js";import{r as pt}from"./ios-system-surface.js";import mt from"node:path";import{promises as E}from"node:fs";import{createHash as ht}from"node:crypto";function gt(e){let t=new Map;for(let n of e)t.set(n.index,n);return t}function _t(e,t,n){let r=[],i=new Set([e.index]),a=e;for(;r.length<n;){if(typeof a.parentIndex!=`number`)return{chain:r,broken:!1};let e=t.get(a.parentIndex);if(!e||i.has(e.index))return{chain:r,broken:!0};i.add(e.index);let n=y(e);r.push({role:n.role,...n.label===void 0?{}:{label:n.label}}),a=e}return{chain:r,broken:!1}}function vt(e,t,n,r){return e.filter(e=>{if(!he(y(e),n))return!1;let i=_t(e,t,Math.max(r.length,1));return!i.broken&&h(i.chain,r)})}const yt=/\b(logbox|redbox|reload js|copy stack|component stack|call stack|runtime error|open debugger to view warnings)\b/,bt=[/\b[\w.$<>/-]+\.(?:tsx?|jsx?):\d+(?::\d+)?\b/,/\b[\w.$<>/-]+\.(?:tsx?|jsx?)\s+\(\d+:\d+\)/],xt=new Set([`x`,`×`,`✕`,`✖`,`⨯`]);function St(e){if(Ct(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 Ct(e){let t=wt(e),n=t.detected?Tt(t):null;return{detected:t.detected,dismissNodes:t.dismissNodes,minimizeNodes:t.minimizeNodes,collapsedNodes:t.collapsedNodes,primaryAction:n}}function wt(e){let t=e.map(Et).join(`
-`).toLowerCase(),n=zt(e,Nt),r=zt(e,Je),i=zt(e,qe,Lt),a=zt(e,Mt),o=Ot(t),s=kt(t);return{dismissNodes:n,minimizeNodes:r,collapsedNodes:i,detected:jt({text:t,hasReactNativeStackFrame:o,hasOverlayControl:At(t,n,r),hasControllessRedBoxText:s,collapsedNodes:i,openDebuggerWarningNodes:a})}}function Tt(e){let t=Bt(e.dismissNodes);if(t)return Ut(t,Wt(t));let n=Gt(e.collapsedNodes.filter(Rt));return n?.rect?{action:`close-collapsed-banner`,point:Xt(n),rect:n.rect,ref:n.ref,label:Qt(n)}:null}function Et(e){return[e.label,e.value,e.identifier,e.type,e.role].filter(Boolean).join(` `)}function Dt(e){return yt.test(e)}function Ot(e){return bt.some(t=>t.test(e))}function kt(e){return/\buncaught\b/.test(e)&&/unable to download asset/.test(e)}function At(e,t,n){return t.length>0||n.length>0||/\b(reload js|copy stack)\b/.test(e)}function jt(e){return e.collapsedNodes.length>0||e.openDebuggerWarningNodes.length>0||e.hasControllessRedBoxText||e.hasOverlayControl&&(Dt(e.text)||e.hasReactNativeStackFrame)}function Mt(e){return e.includes(`open debugger to view warnings`)||/^!,\s+open debugger\b/.test(e)}function Nt(e){return Ke(e)||Pt(e)||Ft(e)}function Pt(e){return/^close(?:\s*\([^)]*\))?$/i.test(e)}function Ft(e){return xt.has(e)}function It(e){return/^!,\s+/.test(e)}function Lt(e){return!e.rect||e.rect.height<=180}function Rt(e){let t=Qt(e)?.trim().toLowerCase()??``;return(Mt(t)||It(t))&&Ye(e)}function zt(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?ge(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:s(e.rect),rect:e.rect,ref:e.ref,label:Qt(e)}}function Wt(e){let t=Qt(e)?.trim().toLowerCase();return t&&Ke(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 Qt(e){return e.label??e.value??e.identifier}const $t=new Set([`textfield`,`securetextfield`,`textview`,`textarea`,`searchfield`,`edittext`]),en={strippedIndexes:new Set,refs:new Set};function tn(e){let t=new Set(e.filter(e=>x(e.type??``)===`keyboard`).map(e=>e.index));if(t.size===0)return en;let n=new Map(e.map(e=>[e.index,e])),r=sn(e,n,t),i=new Set(r),a=hn(e,n,r);for(let t of sn(e,n,a))i.add(t);for(let o of nn(e,n,a,t,r))i.delete(o);let o=new Set(e.filter(e=>e.ref&&i.has(e.index)).map(e=>e.ref));return{strippedIndexes:new Set([...i].filter(e=>!t.has(e))),refs:o}}function nn(e,t,n,r,i){let a=new Set;if(n.size===0)return a;let o=an(t,n,r);if(o.size===0)return a;let s=on(t,r);for(let n of e)!i.has(n.index)&&!s.has(n.index)&&n.rect&&rn(n,t,o)&&a.add(n.index);return a}function rn(e,t,n){if(!e.rect)return!1;let r=gn(e,t);if(r===void 0)return!1;let i=n.get(r);return i!==void 0&&e.rect.y+e.rect.height/2<i}function an(e,t,n){let r=new Map;for(let i of n){let n=e.get(i);if(!n?.rect)continue;let a=gn(n,e);if(a===void 0||!t.has(a))continue;let o=r.get(a);(o===void 0||n.rect.y<o)&&r.set(a,n.rect.y)}return r}function on(e,t){let n=new Set;for(let r of t){let t=e.get(r),i=t&&typeof t.parentIndex==`number`?e.get(t.parentIndex):void 0;for(;i;)n.add(i.index),i=typeof i.parentIndex==`number`?e.get(i.parentIndex):void 0}return n}function sn(e,t,n){let r=new Set(n);if(n.size===0)return r;for(let i of e)_n(i,t,n)&&r.add(i.index);return r}function cn(e,t){if(e.bundleId!==`com.android.systemui`)return!1;if(tt(e))return!0;let n=new Set,r=e;for(;r?.bundleId===`com.android.systemui`&&!n.has(r.index);){if(rt(r.identifier))return!0;n.add(r.index),r=r.parentIndex===void 0?void 0:t.get(r.parentIndex)}return!1}function ln(e,t){let n=new Map(e.map(e=>[e.index,e])),r=new Set(e.filter(m).map(e=>e.index)),i=new Set([...r].filter(e=>{let t=n.get(e)?.parentIndex,i=t===void 0?void 0:n.get(t);return!i||!r.has(i.index)})),a=t===`com.android.systemui`?new Set:un(e,n,r),o=new Set([...r].filter(e=>!i.has(e)));for(let e of a)o.add(e);let s=new Set(e.filter(e=>e.ref&&(r.has(e.index)||a.has(e.index))).map(e=>e.ref));return o.size===0&&s.size===0?en:{strippedIndexes:o,refs:s}}function un(e,t,n){return new Set(e.filter(e=>!n.has(e.index)&&cn(e,t)).map(e=>e.index))}function dn(e,t){let n=tn(e),r=ln(e,t);return n.strippedIndexes.size===0&&n.refs.size===0?r:r.strippedIndexes.size===0&&r.refs.size===0?n:{strippedIndexes:new Set([...n.strippedIndexes,...r.strippedIndexes]),refs:new Set([...n.refs,...r.refs])}}function fn(e,t){let{strippedIndexes:n}=dn(e,t);return n.size===0?e:e.filter(e=>!n.has(e.index))}function pn(e,t){return dn(e,t).refs}function mn(e){return tn(e).refs}function hn(e,t,n){let r=new Set;for(let e of n){let n=t.get(e);if(!n||x(n.type??``)!==`keyboard`)continue;let i=gn(n,t);i!==void 0&&r.add(i)}for(let i of r){let a=new Set([i]);e.some(e=>$t.has(x(e.type??``))&&!n.has(e.index)&&_n(e,t,a))&&r.delete(i)}return r}function gn(e,t){let n=typeof e.parentIndex==`number`?t.get(e.parentIndex):void 0;for(;n;){if(x(n.type??``)===`window`)return n.index;n=typeof n.parentIndex==`number`?t.get(n.parentIndex):void 0}}function _n(e,t,n){let r=typeof e.parentIndex==`number`?t.get(e.parentIndex):void 0;for(;r;){if(n.has(r.index))return!0;r=typeof r.parentIndex==`number`?t.get(r.parentIndex):void 0}return!1}function D(e,t,r,i){if(!Number.isFinite(e)||!Number.isInteger(e)||e<r||e>i)throw new n(`INVALID_ARGS`,`${t} must be an integer between ${r} and ${i}`);return e}function vn(e,t,r){let i=Number(e[0]),a=Number(e[1]);if(Number.isNaN(i)||Number.isNaN(a))throw new n(`INVALID_ARGS`,t,r);return{x:i,y:a}}function O(e,t){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,e=>n(t,e)]))}function k(e){return e&&typeof e==`object`?e:void 0}const yn=[0,187,255,255];function bn(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||xn(e,n.rect)}function xn(e,t){let n=Sn(t);if(n==null)return;let r=wn(n.x,0,e.width-1),i=wn(n.y,0,e.height-1),a=wn(n.right,0,e.width-1),o=wn(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)Cn(e,n,i+t,yn),Cn(e,n,o-t,yn);for(let n=i;n<=o;n+=1)Cn(e,r+t,n,yn),Cn(e,a-t,n,yn)}}function Sn(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 Cn(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 wn(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}function Tn(e){return e}function En(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height);return i<=n||a<=r?0:(i-n)*(a-r)}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 On(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(!jn(t,a,e))continue;let c=0,l=An(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=kn({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function kn(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(!Mn(o,u,i,a))continue;let d=u*i+o;jn(t,n,d)&&(l=An(r,n,l,d))}return l}function An(e,t,n,r){return t[r]=1,e[n]=r,n+1}function jn(e,t,n){return e[n]===1&&t[n]!==1}function Mn(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}function Nn(e,t){return e.flatMap(e=>Pn(e,t.baseline.width,t.baseline.height)?Fn(e,t,Vn(t.baseline.height)):[e])}function Pn(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=Bn(n)&&r>=t*.35}function Fn(e,t,n){let r=zn(e,Rn(Ln(In(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])=>Hn(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function In(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 Ln(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 Rn(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 zn(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 Bn(e){return Math.max(48,Math.round(e*.07))}function Vn(e){return Math.max(24,Math.round(e*.03))}function Hn(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??=Un(t,a),Wn(i,e,t,a,r.baseline,r.current))}return i}function Un(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 Wn(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 Gn=2.5;function Kn(e){let t=qn(e);return Nn(t.length<=2e3?Xn(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)=>$n(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function qn(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return On({mask:t,width:i,height:a,hooks:{create:e=>Jn(e,i),visit:(e,t)=>Yn(e,t,i,n,r)}})}function Jn(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 Yn(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 Xn(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=>Zn(e,r,t));if(!e){n.push({...r});continue}Qn(e,r)}return n}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){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 $n(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=er(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=er(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height;return{index:t,rect:r,normalizedRect:Tn({x:A(r.x/n.width),y:A(r.y/n.height),width:A(r.width/n.width),height:A(r.height/n.height)}),differentPixels:e.differentPixels,shareOfDiffPercentage:A(e.differentPixels/n.differentPixels),densityPercentage:A(e.differentPixels/s),shape:rr(r,n.width,n.height),size:ir(s,n.totalPixels),location:tr(i,n.width,n.height),averageBaselineColorHex:or(a),averageCurrentColorHex:or(o),baselineLuminance:Math.round(ar(a)),currentLuminance:Math.round(ar(o)),dominantChange:nr(a,o)}}function er(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function tr(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 nr(e,t){let n=ar(t)-ar(e);return Math.abs(n)>=12?n>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 rr(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*Gn?`horizontal-band`:e.height>=e.width*Gn?`vertical-band`:`compact`}function ir(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function ar(e){return e.r*.2126+e.g*.7152+e.b*.0722}function or(e){return`#${sr(e.r)}${sr(e.g)}${sr(e.b)}`}function sr(e){return e.toString(16).padStart(2,`0`)}function A(e){return Math.round(e*100*100)/100}const cr=255*Math.sqrt(3);async function lr(e,t,n={}){await ur(e,`Baseline image not found`),await ur(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([st(i,`baseline screenshot`),st(a,`current screenshot`)]);dr(o.width,o.height,`baseline screenshot`,n.maxPixels),dr(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 fr(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*cr,{diffData:d,diffMask:f,differentPixels:p}=await ut({baselineData:o.data,currentData:s.data,width:o.width,height:o.height,maxColorDistance:u}),m=p>0?Kn({diffMask:f,baseline:o,current:s,totalPixels:l,differentPixels:p}):[];if(p>0&&r){let e=new at.PNG({width:o.width,height:o.height});e.data=d,bn(e,m),await E.mkdir(mt.dirname(r),{recursive:!0}),await E.writeFile(r,await ct(e))}else await fr(n.outputPath);let h=l>0?Math.round(p/l*100*100)/100:0;return{...p>0&&r?{diffPath:r}:{},...m.length>0?{regions:m}:{},totalPixels:l,differentPixels:p,mismatchPercentage:h,match:p===0}}async function ur(e,t){try{await E.access(e)}catch{throw new n(`INVALID_ARGS`,`${t}: ${e}`)}}function dr(e,t,r,i){if(i==null||i<=0)return;let a=e*t;if(!(a<=i))throw new n(`INVALID_ARGS`,`${r} is ${a} pixels, which exceeds the configured maxImagePixels limit of ${i}`)}async function fr(e){if(e)try{await E.unlink(e)}catch(e){if(!pr(e,`ENOENT`))throw e}}function pr(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function mr(e,t){return e.map(e=>{let n=hr(e,t);return n.length>0?{...e,currentOverlayMatches:n}:e})}function hr(e,t){let n=ge(e.rect);return t.map(t=>{let r=t.overlayRect,i=En(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:gr(i/ge(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 gr(e){return Math.round(e*100*100)/100}async function _r(e,t,r){if(t.kind===`path`&&!e.policy.allowLocalInputPaths)throw new n(`INVALID_ARGS`,`Local ${r.field??`input`} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(t,r)}catch(e){throw c(e)}}async function j(e,t,r){if(t?.kind===`path`&&!e.policy.allowLocalOutputPaths)throw new n(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await e.artifacts.reserveOutput(t,{...r,visibility:r.visibility??`client-visible`,requestedClientPath:t?.kind===`downloadableArtifact`?t.clientPath??r.requestedClientPath:r.requestedClientPath})}catch(e){throw c(e)}}async function vr(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw c(e)}}const yr=async(e,t)=>{if(!t.baseline)throw new n(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let r=br(t.threshold),i=t.current??{kind:`live`};if(t.overlayRefs&&!Or(i))throw new n(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let a=await _r(e,t.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let n;Or(i)?(s=await xr(e,t),n=s.path):(o=await _r(e,i,{usage:`diff screenshot current`,field:`current`}),n=o.path),c=t.out?await j(e,t.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await lr(a.path,n,{threshold:r,outputPath:c?.path,maxPixels:e.policy.maxImagePixels});Or(i)&&(u=await Sr(e,t,c?.path,u,l));let d=u.diffPath?await c?.publish():void 0;return d&&l.push(d),u.diffPath||await c?.cleanup?.(),{...u,...l.length>0?{artifacts:l}:{}}}catch(e){throw await c?.cleanup?.(),e}finally{await a.cleanup?.(),await o?.cleanup?.(),await s?.cleanup?.()}};function br(e){if(e==null||e===``)return .1;let t=Number(e);if(Number.isNaN(t)||t<0||t>1)throw new n(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return t}async function xr(e,t){let n=await vr(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await Cr(e,t,n.path,wr(t))}catch(e){throw await n.cleanup(),e}return n}async function Sr(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await Dr(n),r;let a=await j(e,Tr(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await Cr(e,t,a.path,{overlayRefs:!0,...wr(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:mr(r.regions,n.overlayRefs)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function Cr(e,t,r,i={}){if(!e.backend.captureScreenshot)throw new n(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata},r,i)??{}}function wr(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function Tr(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:Er(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:Er(e.out.clientPath)}:{},...e.out.fileName?{fileName:Er(e.out.fileName)}:{}}}function Er(e){let t=mt.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function Dr(e){try{await E.unlink(Er(e))}catch(e){if(!kr(e,`ENOENT`))throw e}}function Or(e){return e.kind===`live`}function kr(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}const Ar=async(e,t)=>{if(!e.backend.captureScreenshot)throw new n(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);l(t);let r=await j(e,t.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),i;try{await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,appId:t.appId,appBundleId:t.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},r.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,pixelDensity:t.pixelDensity,stabilize:t.stabilize,normalizeStatusBar:t.normalizeStatusBar,surface:t.surface}),t.scale!==void 0&&await ot(r.path,t.scale),i=await r.publish()}catch(e){throw await r.cleanup?.(),e}return{path:r.path,...i?{artifacts:[i]}:{},...C(`Saved screenshot: ${r.path}`)}};function jr(e,t){let n=Me(e.type??`Element`),r=Ve(e,n),i=e.enabled===!1?`disabled`:`enabled`,a=e.selected===!0?`selected`:`unselected`,o=e.hittable===!0?`hittable`:`not-hittable`;return[String(t??e.depth??0),n,r,i,a,o,e.actions?JSON.stringify(e.actions):``].join(`|`)}function Mr(e,t,n={}){let r=Fr(Pr(e,n),Pr(t,n)),i={additions:0,removals:0,unchanged:0};for(let e of r)e.kind===`added`&&(i.additions+=1),e.kind===`removed`&&(i.removals+=1),e.kind===`unchanged`&&(i.unchanged+=1);return{summary:i,lines:r}}function Nr(e,t={}){return Pr(e,t).length}function Pr(e,t){return t.flatten?e.map(e=>({text:Ne(e,0,!1),comparable:jr(e,0),...t.withRefs&&e.ref?{ref:e.ref}:{}})):Fe(e).map(e=>({text:e.text,comparable:jr(e.node,e.depth),...t.withRefs&&e.node.ref?{ref:e.node.ref}:{}}))}function Fr(e,t){let n=e.length,r=t.length,i=n+r,a=new Map,o=[];a.set(1,0);for(let s=0;s<=i;s+=1){o.push(new Map(a));for(let i=-s;i<=s;i+=2){let c=Lr(a,i,s)?M(a,i+1):M(a,i-1)+1,l=c-i;for(;c<n&&l<r&&e[c].comparable===t[l].comparable;)c+=1,l+=1;if(a.set(i,c),c>=n&&l>=r)return Ir(o,e,t,n,r)}}return[]}function Ir(e,t,n,r,i){let a=[],o=r,s=i;for(let r=e.length-1;r>=0;--r){let i=e[r],c=o-s,l=Lr(i,c,r)?c+1:c-1,u=M(i,l),d=u-l;for(;o>u&&s>d;)a.push({kind:`unchanged`,text:n[s-1].text}),--o,--s;if(r===0)break;if(o===u){let e=n[d];a.push({kind:`added`,text:e.text,...e.ref?{ref:e.ref}:{}}),s=d}else a.push({kind:`removed`,text:t[u].text}),o=u}return a.reverse(),a}function Lr(e,t,n){return t===-n||t!==n&&M(e,t-1)<M(e,t+1)}function M(e,t){return e.get(t)??0}function Rr(e,t){return[...Vr(e),...zr(e),...Ur(e),...Wr(e,t)]}function zr(e){let t=e.customActions;if(!t)return[];let n=[];return t.blocked?n.push(`Custom actions were not read: an earlier accessibility read is still hung, so this capture skipped the read pass instead of queueing behind it. No element’s actions list is authoritative here. Reads resume once that call returns.`):t.read<t.candidates&&n.push(`Custom actions were read for ${t.read} of ${t.candidates} merged elements, on-screen ones first; the remaining ${t.candidates-t.read} were not read, so an absent actions list on those is not evidence that they have none. Scroll them into view and re-run to read them.`),t.truncated>0&&n.push(`${t.truncated} element(s) published more custom actions than are shown; those lists are clipped to the first 8 names, and long names are shortened.`),n}function Br(e){return`Detected an overly complex or slow accessibility tree. Fell back to the ${e} snapshot backend. It is OK to continue; use --json to inspect snapshotQuality.reason if you need recovery details.`}function Vr(e){return e.state===`recovered`?e.reasonCode===`deferred`||e.reasonCode===`requested-backend`?[]:e.reasonCode===`presentation-failed`?[`Agent Device could not safely present the captured accessibility tree and fell back to the ${e.backend} snapshot backend. This is an Agent Device runner bug, not an app accessibility-tree issue. Use screenshot as visual truth and report snapshotQuality.reason with the screenshot.`]:[Br(e.backend)]:e.state===`sparse`?[`No snapshot backend could read this screen`+(e.reason?` (${e.reason})`:``)+`. Its refs and selectors are invalid. Use screenshot as visual truth and coordinate taps; retry snapshot after navigating.`,...Hr(e)]:[]}function Hr(e){return e.reasonCode===`sparse-tree`?[`This screen publishes no accessibility content at all; assistive technologies see the same empty tree, so it is worth flagging as an app accessibility bug rather than only an automation limitation.`]:[]}function Ur(e){return e.effectiveDepth===void 0?[]:[`Some deeper accessibility nodes were omitted; this tree is capped at depth ${e.effectiveDepth}. Re-run with --depth ${e.effectiveDepth} --scope <container> only if you need deeper content.`]}function Wr(e,t){let n=[];for(let r of e.collapsedLeafIndexes??[]){let e=t.find(e=>e.index===r);if(!e)continue;let i=e.identifier?` (${e.identifier})`:``;n.push(`@${e.ref} [${e.type??`element`}]${i} merges many 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.`)}return n}function Gr(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=Ue(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 Kr=`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 qr(e){return e?.systemSurfaceOnly===!0?Kr:void 0}function N(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function P(e){return e.clock?.now()??Date.now()}async function Jr(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}function Yr(e,t){return e.presentationKey?e:{...e,presentationKey:i(t)}}function Xr(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||!Zr(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!Qr(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 Zr(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function Qr(e,t){return e.truncated===t.truncated&&e.nodes.length===t.nodes.length&&e.nodes.every((e,n)=>ei(e,t.nodes[n]))}const $r=Object.keys({index:!0,depth:!0,parentIndex:!0,type:!0,role:!0,subrole:!0,label:!0,value:!0,identifier:!0,enabled:!0,selected:!0,focused:!0,hittable:!0,bundleId:!0,appName:!0,windowTitle:!0,surface:!0,hiddenContentAbove:!0,hiddenContentBelow:!0,interactionBlocked:!0});function ei(e,t){return $r.every(n=>e[n]===t[n])&&ti(e.rect,t.rect)&&ni(e.presentationHints,t.presentationHints)&&ni(e.actions,t.actions)}function ti(e,t){return!e||!t?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function ni(e,t){return!e||!t?e===t:e.length===t.length&&e.every((e,n)=>e===t[n])}const ri=async(e,t)=>{let n=await ai(e,t),r=Xr({previous:n.session?.snapshot,current:n.snapshot,options:t,identity:{previousAppBundleId:n.session?.appBundleId,currentAppBundleId:n.result.appBundleId??n.session?.appBundleId}});await e.sessions.set(si(t.session,n));let i=li(n.snapshot);return f(n.snapshot,{nodes:n.snapshot.nodes,...i===void 0?{}:{truncated:i},visibility:Gr({nodes:n.snapshot.nodes,backend:n.snapshot.backend,snapshotRaw:t.raw}),...d({...n.annotations,warnings:n.warnings}),...r?{unchanged:r}:{},...n.result.snapshotDiagnostics?{snapshotDiagnostics:n.result.snapshotDiagnostics}:{},...ci(n)})},ii=async(e,t)=>{let n=await ai(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,a=si(t.session,n);if(!i){let t=Nr(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=Mr(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 ai(e,t){if(!e.backend.captureSnapshot)throw new n(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=t.session??`default`,i=await e.sessions.get(r),a=await e.backend.captureSnapshot({session:r,requestId:t.requestId,appId:i?.appId,appBundleId:i?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,depth:t.depth,scope:t.scope,raw:t.raw,customActions:t.customActions}),o=oi(a,e),s=f(o,Yr(o,t)),c=u(a),l=P(e);return{snapshot:s,result:a,session:i,annotations:c,warnings:ui({result:a,annotations:c,snapshot:s,options:t,session:i,capturedAt:s.createdAt??l,runtimeNow:l})}}function oi(e,t){return e.snapshot?e.snapshot:{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,createdAt:P(t)}}function si(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 ci(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 li(e){return e.truncated===void 0?e.backend!==`xctest`||e.producer===void 0?!1:ft(e.producer)===`unavailable`&&void 0:e.truncated}function ui(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...Rr(e.annotations.quality,e.snapshot.nodes)),t.push(...hi(e)),e.annotations.quality||(t.push(...fi(e)),t.push(...mi(e.snapshot.nodes)));let n=St(e.snapshot.nodes);n&&t.push(n);let r=di(e.annotations);r&&t.push(r);let i=gi(e);return i&&t.push(i),t.push(...bi(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function di(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return Kr}function fi(e){if(e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1)return[];let t=e.snapshot.nodes[0];return pi(t)?e.snapshot.producer===`appium-source`?[`Appium page source exposed only the application root. Descendants may be absent from the acquired hierarchy; use snapshot --raw to inspect the source and verify the app accessibility tree.`]:e.snapshot.producer!==void 0&&e.snapshot.producer!==`apple-runner`?[]:[`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 pi(e){return e?x(e.type??``)===`application`:!1}function mi(e){let t=new Set(e.map(e=>e.parentIndex).filter(e=>e!==void 0));return e.filter(e=>t.has(e.index)||(e.type?.toLowerCase()??``).includes(`text`)?!1:(e.label??``).split(`, `).length>10).map(e=>{let t=(e.label??``).split(`, `).length,n=e.identifier?` (${e.identifier})`:``;return`@${e.ref} [${e.type??`element`}]${n} merges ~${t} labels into a single accessibility element. The app likely marks a container as accessible, which hides every descendant from assistive tech and automation — the children cannot be addressed individually. Fix the app's accessibility (mark the rows, not the container); until then use screenshot as visual truth and coordinate taps.`})}function hi(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 gi(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&_i(t,e.snapshot)&&vi(t,e.capturedAt,e.runtimeNow)&&xi(t.nodes.length,e.snapshot.nodes.length))return yi}function _i(e,t){return e.presentationKey===void 0||t.presentationKey===void 0||e.presentationKey===t.presentationKey}function vi(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const yi=`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 bi(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`?[yi]:[]}function xi(e,t){return e<12?!1:t<=Math.floor(e*.2)}const Si={screenshot:Ar,diffScreenshot:yr,snapshot:ri,diffSnapshot:ii},Ci={defaultTimeoutMs:1e4,intervalMs:300},F={promotedTarget:{resolution:b.act,occlusion:`exclude-and-refuse`,offscreen:`refuse`,promotion:`hittable-ancestor`,poll:`none`},resolvedTarget:{resolution:b.act,occlusion:`exclude-and-refuse`,offscreen:`refuse`,promotion:`none`,poll:`none`},coveredDiagnosis:{resolution:b.actCoveredDiagnosis,occlusion:`refuse`,offscreen:`ignore`,promotion:`none`,poll:`none`},readText:{resolution:b.readText,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},readUnique:{resolution:b.readUnique,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},readAny:{resolution:b.readAny,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},findWait:{resolution:b.readAny,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:Ci},wait:{resolution:b.wait,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:Ci},readList:{resolution:b.readList,occlusion:`ignore`},findAct:{resolution:b.findAct,occlusion:`refuse`,offscreen:`ignore`,promotion:`hittable-ancestor-below-root`,poll:`none`},cropTarget:{resolution:b.cropTarget,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`}},wi=new WeakMap;function Ti(e,t){Di(e)&&wi.set(e,t)}function Ei(e){return Di(e)?wi.get(e):void 0}function Di(e){return typeof e==`object`&&!!e||typeof e==`function`}function Oi(e,t,n,r){let i=n.ambiguity;if(i===`first-match`||i===`reject-candidates`){let a=ye(e,t,{...r,requireRect:n.requireRect});return!a||a.matchedNodes.length===0?{kind:`none`}:i===`first-match`?Ai(a):a.matchedNodes.length>1?ki(a):Ai(a)}let a=de(e,t,{...r,...xe({ambiguity:i,requireRect:n.requireRect})});return a.firstMatch?a.resolution?{kind:`resolved`,resolution:a.resolution,matchedNodes:a.firstMatch.matchedNodes}:ki(a.firstMatch):{kind:`none`}}function ki(e){return{kind:`ambiguous`,selector:e.selector.raw,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}function Ai(e){let t=e.matchedNodes[0];return t?{kind:`resolved`,matchedNodes:e.matchedNodes,resolution:{node:t,selector:e.selector,selectorIndex:e.selectorIndex,matches:e.matchedNodes.length,diagnostics:[{selector:e.selector.raw,matches:e.matchedNodes.length}]}}:{kind:`none`}}function ji(e,t,n){let r=ye(e,Se(t),n);return r?{...r,selector:r.selector.raw}:null}function Mi(e,t,n,r){let i=Oi(e,Se(t),n,r);return i.kind===`resolved`?{...i,resolution:{...i.resolution,selector:i.resolution.selector.raw}}:i}const Ni=[`button`,`link`,`menuitem`,`tabitem`,`textfield`,`searchfield`,`securetextfield`,`checkbox`,`radio`,`switch`,`cell`];function I(e){return[e.type,e.role,e.subrole].map(e=>x(e??``)).some(e=>e===`tab`||Ni.some(t=>e.includes(t)))}function Pi(e,t){let n=t[0];if(!n)return{kind:`ambiguous`,candidates:t};let r=Xi(e);if(!Fi(t,r.nodesByIndex))return{kind:`ambiguous`,candidates:t};let i=Hi(e,n,r).node;for(let n of t.slice(1))if(Hi(e,n,r).node.index!==i.index){let e=Li(t);return e?{kind:`equivalent`,node:e}:{kind:`ambiguous`,candidates:t}}return{kind:`equivalent`,node:i}}function Fi(e,t){for(let n=0;n<e.length;n+=1)for(let r=n+1;r<e.length;r+=1){let i=e[n],a=e[r];if(!Ii(i,a,t)&&!Ii(a,i,t))return!1}return!0}function Ii(e,t,n){let r=t,i=new Set;for(;r.parentIndex!==void 0&&!i.has(r.index);){if(i.add(r.index),r.parentIndex===e.index)return!0;let t=n.get(r.parentIndex);if(!t)return!1;r=t}return!1}function Li(e){if(e.length<2||e.some(e=>e.hittable!==void 0))return null;let t=e.reduce((e,t)=>(t.depth??0)>(e.depth??0)?t:e);if(!I(t)||!e.every(e=>e===t||!I(e)))return null;let n=T(t.rect);return n&&e.every(e=>Ri(T(e.rect),n))?t:null}function Ri(e,t){return e?Math.abs(e.x-t.x)<=1&&Math.abs(e.y-t.y)<=1&&Math.abs(e.width-t.width)<=1&&Math.abs(e.height-t.height)<=1:!1}function zi(e,t){if(!t?.rect||!e.rect||!pe(e))return!1;let n=e.rect,r=t.rect;return n.x===r.x&&n.y===r.y&&n.width===r.width&&n.height===r.height}function Bi(e,t){return Hi(e,t)}function Vi(e){let t=Xi(e);return n=>Hi(e,n,t)}function Hi(e,t,n){return p(t)?{node:t,reason:`covered`}:Ui(e,t,n)??Wi(t)??Gi(e,t,n)??{node:t,reason:`original`}}function Ui(e,t,n){let r=qi(e,t,n);return r?.rect&&w(r.rect)?{node:r,reason:`same-rect-descendant`}:null}function Wi(e){return I(e)&&e.rect&&w(e.rect)?{node:e,reason:`semantic-target`}:null}function Gi(e,t,n){let r=Ki(e,t,n);return!r?.rect||p(r)||!w(r.rect)?null:Ji(t,r,e,n)?{node:t,reason:`overly-broad-ancestor`}:{node:r,reason:`hittable-ancestor`}}function Ki(e,t,n){if(t.hittable)return t;let r=e=>e.hittable===!0;return n?ue(e,t,n.nodesByIndex,e=>r(e)?e:null):oe(e,t,r)}function qi(e,t,n){let r=T(t.rect);if(!r)return null;let i=t,a=new Set;for(;!a.has(i.ref);){a.add(i.ref);let t=(n?n.childrenByParentIndex.get(i.index)??[]:e.filter(e=>e.parentIndex===i.index)).filter(e=>{if(!e.hittable||p(e))return!1;let t=T(e.rect);return t?Ze(t,r):!1});if(t.length!==1)break;i=t[0]}return i===t?null:i}function Ji(e,t,n,r){let i=T(e.rect),a=T(t.rect);if(!i||!a)return!1;if(Yi(t)&&!Ze(i,a))return!0;let o=ee(n,i,r?.viewportRootRects);return!o||!Zi(a,o)?!1:!Ze(i,a)}function Yi(e){let t=x(e.type??``);return t.includes(`scrollview`)||t.includes(`scrollarea`)||t.includes(`listview`)||t.includes(`recyclerview`)||t.includes(`collectionview`)||t===`list`||t===`table`||t===`collection`}function Xi(e){let t=new Map,n=new Map,r=[];for(let i of e){if(t.set(i.index,i),typeof i.parentIndex==`number`){let e=n.get(i.parentIndex);e?e.push(i):n.set(i.parentIndex,[i])}if(pe(i)){let e=T(i.rect);e&&r.push(e)}}return{nodesByIndex:t,childrenByParentIndex:n,viewportRootRects:r}}function Zi(e,t){let n=En(e,t),r=e.width*e.height,i=t.width*t.height;if(n<=0||r<=0||i<=0)return!1;let a=n/i,o=n/r;return a>=.9&&o>=.8}async function L(e,t,n,r,i={}){let a=Mi(ea(e,t),n,e.resolution,r);if(a.kind===`none`)return{kind:`none`};if(a.kind===`ambiguous`)return{kind:`ambiguous`,selector:a.selector,selectorIndex:a.selectorIndex,matchedNodes:a.matchedNodes};let o=a.resolution,s=await $i(e,t,o.node,i);return s.kind===`occluded`?{kind:`occluded`,node:s.node,selector:o.selector}:{kind:`target`,node:s.node,selector:o.selector,selectorIndex:o.selectorIndex,matches:o.matches,matchedNodes:a.matchedNodes}}function Qi(e,t,n,r){let i=ea(e,t);return{candidates:i,list:ji(i,n,{...r,requireRect:e.resolution.requireRect})}}async function $i(e,t,n,r={}){r.onResolved?.(n,t);let i=ta(e.promotion,t,n);return e.occlusion!==`ignore`&&(i.covered||p(i.node))?{kind:`occluded`,node:i.node}:{kind:`target`,node:await na(e,t,i.node,r)}}function ea(e,t){return e.occlusion===`exclude-and-refuse`?t.filter(e=>!p(e)):t}function ta(e,t,n){if(e===`none`)return{node:n,covered:!1};let r=Bi(t,n);return r.reason===`covered`?{node:r.node,covered:!0}:e===`hittable-ancestor-below-root`&&zi(r.node,t[0])&&n.rect?{node:n,covered:!1}:{node:r.node,covered:!1}}async function na(e,t,n,r){if(e.offscreen!==`refuse`)return n;if(!r.offscreen)throw Error(`selector pipeline row declares an off-screen refusal but this route supplies no refusal shape`);return await r.offscreen(n,t)}function ra(e){if(e.poll===`none`)throw Error(`selector pipeline row resolves against one capture and declares no poll budget`);return e.poll}function ia(e){return e.hittable===!0||I(e)}function aa(e,t){let n=ne(y(e),t);return n.id!==void 0||n.label!==void 0?!1:le(e.value)===null}function oa(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`;){if(r.has(i.index))return!1;if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function sa(e,t){let n=gt(t);return t.filter(t=>t.index!==e.index&&oa(t,e,n)).sort((e,t)=>e.index-t.index)}function ca(e,t){let n=w(e.rect);return!n||!t.rect?!1:re(t.rect,n.x,n.y)}function la(e,t){if(!aa(e,t))return e;let n=sa(e,t);if(n.some(ia))return e;let r=n.find(e=>y(e).label!==void 0);return!r||!ca(r,e)?e:r}function ua(e,t){return e.find(e=>ke(e,t))??null}function R(e,t){let n=_(e);return n&&Ce(n)?n:da(e,t)}function da(e,t){if(!e.rect)return;let n=e.rect.y+e.rect.height/2,r=null;for(let e of t){if(!e.rect)continue;let t=_(e);if(!t||!Ce(t))continue;let i=e.rect.y+e.rect.height/2,a=Math.abs(i-n);(!r||a<r.distance)&&(r={label:t,distance:a})}return r?.label}function fa(e){return e===`text`||e===`label`||e===`any`}function pa(e,t,n,r){if(!(r||e===`web`))return fa(t)?n:void 0}function ma(e){return new n(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth, navigate with coordinates if needed, then retry find after reaching a readable screen.`})}async function ha(e,t){let r=t??`default`,i=await e.sessions.get(r);if(!i)throw new n(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let a=i.refFrameSnapshot??i.snapshot;if(!a)throw new n(`INVALID_ARGS`,`No snapshot in session. Run snapshot first.`);return{sessionName:r,session:i,snapshot:a}}async function z(e,t,r={updateSession:!0}){let i=e.backend.captureSnapshot;if(!i)throw new n(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let a=t.session??`default`,o=await e.sessions.get(a),s=ga(await i(N(e,t),{interactiveOnly:r.interactiveOnly??!1,depth:t.depth,scope:r.scope??t.scope,raw:t.raw,includeRects:r.includeRects,...r.preferredBackend?{preferredBackend:r.preferredBackend}:{},...r.includeHiddenContentHints===void 0?{}:{includeHiddenContentHints:r.includeHiddenContentHints}}),e);return(t.signal??e.signal)?.throwIfAborted(),r.updateSession&&o&&!dt(s.snapshotQuality)&&await e.sessions.set({...o,snapshot:s}),{sessionName:a,session:o,snapshot:s}}function ga(e,t){return e.snapshot?_a(e.snapshot,e):{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,...e.quality?{snapshotQuality:e.quality}:{},createdAt:P(t)}}function _a(e,t){let n={...e};return t.truncated===!0||n.truncated===!0?n.truncated=!0:t.truncated!==void 0&&(n.truncated=t.truncated),t.quality&&n.snapshotQuality===void 0&&(n.snapshotQuality=t.quality),n}async function va(e,t,n){if(e.backend.readText){let r=await e.backend.readText(N(e,{session:t.sessionName}),n);if(r.text.trim())return r.text}return Re(n)}function ya(e,t,r){let i=a(t);if(!i)throw new n(`INVALID_ARGS`,r.invalidRefMessage);let s=o(e,i)??(r.fallbackLabel.length>0?ua(e,r.fallbackLabel):null);if(!s)throw new n(`COMMAND_FAILED`,r.notFoundMessage);return{ref:i,node:s}}function ba(e,t){if(Buffer.byteLength(e,`utf8`)<=t)return e;let n=Buffer.byteLength(`…`,`utf8`),r=Math.max(0,t-n),i=Buffer.from(e,`utf8`),a=Math.min(r,i.length);for(;a>0&&(i[a]&192)==128;)--a;return i.subarray(0,a).toString(`utf8`)+`…`}function xa(e){let t=Buffer.alloc(16);for(let n of e)Ca(t,Sa(n));return{digest:`ax1:${ht(`sha256`).update(t).update(`\0`).update(String(e.length)).digest(`hex`).slice(0,16)}`,nodeCount:e.length}}function Sa(e){return ht(`sha256`).update(e.type??``).update(`\0`).update(e.label??``).update(`\0`).update(e.identifier??``).digest().subarray(0,16)}function Ca(e,t){for(let n=0;n<e.length;n+=1)e[n]=(e[n]??0)^(t[n]??0)}function wa(e){let{digest:t,nodeCount:n}=xa(e),r=e.reduce((e,t)=>t.hittable===!1?e:e+1,0),i=Ta(e);return{digest:t,nodeCount:n,interactiveNodeCount:r,...i?{foregroundApp:i}:{}}}function Ta(e){for(let t of e)if(t.bundleId)return t.bundleId;for(let t of e)if(t.appName)return t.appName}function B(e){return{nodes:e.nodes,...e.iosSystemSurfaceBundleId?{surfaceBundleId:e.iosSystemSurfaceBundleId}:{}}}function Ea(e,t){if(!(!e||e.surfaceBundleId===t.surfaceBundleId))return{from:e.surfaceBundleId??`app`,to:t.surfaceBundleId??`app`,disclosure:pt(t.surfaceBundleId)}}function Da(e,t){let n=wa(e.nodes),r=Ea(t,e);if(r)return{...n,changedFromBefore:!0,surfaceChange:r};let i=t!==void 0&&n.digest!==wa(t.nodes).digest;return{...n,changedFromBefore:i}}function Oa(e){return`${e.disclosure} The settled tree and the pre-action tree describe different surfaces (${e.from} → ${e.to}), so no settled diff or refs are shown; take a snapshot to read the current surface.`}function ka(e,t,n={}){let r=T(t.rect),i=w(r??void 0);if(!r||!i)return{kind:`invalid`};let a=Aa(e,t,r);if(a.length===0)return{kind:`resolved`,point:i,strategy:`center`};let o=(n.bounds??[]).reduce((e,t)=>e?Ma(e,t):null,r),s=o?Na(r,o,i,a):null;return s?{kind:`resolved`,point:s,strategy:`parent-owned`}:{kind:`blocked`,competitorRefs:a.map(e=>e.ref)}}function Aa(e,t,n){let r=new Map(e.map(e=>[e.index,e]));return e.filter(e=>e.index!==t.index).filter(e=>ja(e,t,r)).filter(I).flatMap(e=>{let t=T(e.rect);if(!t||Ze(t,n))return[];let r=Ma(t,n);return r&&r.width>0&&r.height>0?[{ref:e.ref,index:e.index,rect:r}]:[]}).sort((e,t)=>e.index-t.index)}function ja(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`&&!r.has(i.index);){if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function Ma(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height);return i<=n||a<=r?null:{x:n,y:r,width:i-n,height:a-r}}function Na(e,t,n,r){let i=Ra(e),a=Ia(t.x,t.width,n.x,r.flatMap(({rect:e})=>[e.x,e.x+e.width]),i),o=Ia(t.y,t.height,n.y,r.flatMap(({rect:e})=>[e.y,e.y+e.height]),i);return a.flatMap(a=>o.flatMap(o=>{let s={x:Math.round(a),y:Math.round(o)};if(!re(t,s.x,s.y))return[];let c=Pa(s,e,n,r,i);return c?[c]:[]})).sort(Fa)[0]?.point??null}function Pa(e,t,n,r,i){let a=La(e,t,r);return a.parentEdge<i||a.competitor<12?null:{point:e,distanceSquared:(e.x-n.x)**2+(e.y-n.y)**2,clearance:Math.min(a.parentEdge,a.competitor)}}function Fa(e,t){return e.distanceSquared-t.distanceSquared||t.clearance-e.clearance||e.point.y-t.point.y||e.point.x-t.point.x}function Ia(e,t,n,r,i){let a=e+i,o=e+t-i;if(a>o)return[];let s=[...new Set([e,e+t,...r])].sort((e,t)=>e-t),c=new Set([n,a,o]);for(let e of r)c.add(e-12),c.add(e+12);for(let e=1;e<s.length;e+=1)c.add((s[e-1]+s[e])/2);return[...c].filter(e=>e>=a&&e<=o).sort((e,t)=>e-t)}function La(e,t,n){let r=Math.min(e.x-t.x,t.x+t.width-e.x,e.y-t.y,t.y+t.height-e.y),i=1/0;for(let{rect:t}of n){let n=e.x<t.x?t.x-e.x:Math.max(0,e.x-(t.x+t.width)),r=e.y<t.y?t.y-e.y:Math.max(0,e.y-(t.y+t.height));i=Math.min(i,Math.max(n,r))}return{parentEdge:r,competitor:i}}function Ra(e){let t=Math.min(e.width,e.height);return Math.max(0,Math.min(12,Math.floor(t/2)-1))}const V={captureStalled:`wait_capture_stalled`,deadlineExceeded:`wait_deadline_exceeded`,runnerRestartExhausted:`wait_runner_restart_exhausted`,targetAbsent:`wait_target_absent`,targetPresent:`wait_target_present`,stableTimeout:`wait_stable_timeout`,landmarkIdentityMismatch:`wait_landmark_identity_mismatch`},za=`replay_target_guard_mismatch`,Ba=V.landmarkIdentityMismatch;function Va(e,t,r,i){let{candidates:a,list:o}=Qi(i,e,t,{platform:r}),s=o?.matchedNodes??[];if(!o||s.length===0)return null;let c=[{selector:o.selector,matches:s.length}];if(s.length===1)return{node:s[0],selector:o.selector,selectorIndex:o.selectorIndex,matches:1,diagnostics:c};let l=Pi(a,s);if(l.kind===`ambiguous`)throw new n(`AMBIGUOUS_MATCH`,`Selector matched ${l.candidates.length} distinct actionable elements: ${o.selector}`,{selector:o.selector,matches:l.candidates.length,candidates:l.candidates.slice(0,5).map(e=>Ne(e,0,!1))});return{node:l.node,selector:o.selector,selectorIndex:o.selectorIndex,matches:s.length,diagnostics:c,disambiguation:{matchCount:s.length,tiebreak:`structural-equivalence`,alternatives:s.filter(e=>e.index!==l.node.index)}}}function Ha(e,t,r,i,a){if(!r)return;let o=y(e),s=me(e,t);if(!(Oe(o,r.identity)&&te(s,r.structural)))throw new n(`COMMAND_FAILED`,`${i} resolved to a different element than replay verification isolated; the action was not sent`,{reason:za,observed:o,observedStructural:s,expected:r.identity,expectedStructural:r.structural,...a?{targetRole:a}:{}})}async function H(e,t,n){return await uo(e,t,n.action),t.target.kind===`point`?await Wa(e,t,t.target,n):t.target.kind===`ref`?await Ja(e,t,t.target,n):await Ya(e,t,t.target,n)}async function Ua(e,t,n){let r=t.session??`default`,i=await e.sessions.get(r);if(!i?.snapshot)return;let a={x:n.x,y:n.y,width:0,height:0},o=S(i.snapshot.nodes).resolveViewport(a);if(!o)return;let s={x:n.x,y:n.y};if(!re(o,s.x,s.y))return`Coordinates (${s.x}, ${s.y}) are outside the last-known viewport (${o.width}x${o.height}). The tap will be forwarded anyway; take a fresh snapshot if the screen changed.`}async function Wa(e,t,n,r){let i=await Ua(e,t,n);if(!r.captureEvidenceBaseline)return{kind:`point`,point:{x:n.x,y:n.y},...i?{warning:i}:{}};let a=await Ga(e,t);return{kind:`point`,point:{x:n.x,y:n.y},...a?{preAction:a}:{},...i?{warning:i}:{}}}async function Ga(e,t){try{return B((await U(e,t,!0)).snapshot)}catch{return}}function Ka(e,t){let r=a(e.ref);if(!r)throw new n(`INVALID_ARGS`,`Invalid ref: ${e.ref}`);let i=a(t.ref),o=t.node.ref?a(t.node.ref):null;if(i!==r||o!==r||!t.nodes.includes(t.node))throw new n(`COMMAND_FAILED`,`Internal find target provenance does not match the interaction ref`);return{tree:{nodes:t.nodes,...t.iosSystemSurfaceBundleId?{surfaceBundleId:t.iosSystemSurfaceBundleId}:{}},resolved:eo(r,t.node,`exact`)}}async function qa(e,t,n){let r=await po(e,t,n);return{tree:B(r.snapshot),resolved:r.resolved}}async function Ja(e,t,n,r){let{tree:i,resolved:o}=r.preresolvedTarget?Ka(n,r.preresolvedTarget):await qa(e,t,n),s=i.nodes,c=await so({policy:r.pipeline,nodes:s,node:o.node,action:r.action,label:`Ref ${n.ref}`,hooks:{onResolved:(e,t)=>Za(e,t,r),offscreen:async(i,a)=>await yo(e,t,i,a,n.ref,r)}});return{kind:`ref`,point:go(c,s,{invalidMessage:`Ref ${n.ref} not found or has invalid bounds`,blockedTargetLabel:`Ref ${n.ref}`,blockedTargetDetails:{ref:`@${a(n.ref)??c.ref}`}}),target:{kind:`ref`,ref:`@${o.ref}`},...io(e,c,i,r.action,o.resolution)}}async function Ya(e,t,n,r){let i=n.selector,a=await U(e,t,r.requireInteractive),o=Va(a.snapshot.nodes,i,e.backend.platform,r.pipeline);if((!o||!o.node.rect)&&r.requireInteractive&&(a=await U(e,t,!1),o=Va(a.snapshot.nodes,i,e.backend.platform,r.pipeline)),!o||!o.node.rect)throw await Xa({runtime:e,nodes:a.snapshot.nodes,selectorExpression:i,action:r.action,resolved:o});let s=o,c=await so({policy:r.pipeline,nodes:a.snapshot.nodes,node:s.node,action:r.action,label:`Selector ${s.selector}`,hooks:{onResolved:(e,t)=>Za(e,t,r),offscreen:async(n,i)=>await vo(e,t,n,i,s.selector,r)}});return{kind:`selector`,point:go(c,a.snapshot.nodes,{invalidMessage:`Selector ${o.selector} resolved to invalid bounds`,blockedTargetLabel:`Selector ${i}`,blockedTargetDetails:{selector:i}}),target:{kind:`selector`,selector:o.selector},...io(e,c,B(a.snapshot),r.action,no(o,a.snapshot.nodes))}}async function Xa(e){let{runtime:t,nodes:r,selectorExpression:i,action:a,resolved:o}=e,s=await L(F.coveredDiagnosis,r,i,{platform:t.backend.platform});if(s.kind===`occluded`)return co({label:`Selector ${s.selector}`,node:s.node,action:a,selector:s.selector});let c=o?.diagnostics??[];return new n(`COMMAND_FAILED`,De(i,c,{unique:!0}),{reason:Pe.selectorNotFound,hint:g(c)})}function Za(e,t,n){Ha(e,t,n.expectedResolvedTarget,n.action,n.replayTargetRole)}const Qa={source:`ref`,phase:`pre-action`,kind:`exact`},$a={source:`ref`,phase:`pre-action`,kind:`label-fallback`};function eo(e,t,n){return{ref:e,node:t,resolution:n===`exact`?Qa:$a}}const to={source:`runtime`,phase:`pre-action`,kind:`unique`};function no(e,t){return e.disambiguation?{source:`runtime`,phase:`pre-action`,kind:`disambiguated`,matchCount:e.disambiguation.matchCount,winnerDiagnostic:ro(e.node,t),tiebreak:e.disambiguation.tiebreak,alternatives:e.disambiguation.alternatives.slice(0,5).map(e=>ro(e,t))}:to}function ro(e,t){let n=x(e.type??``),r=R(e,t);return{diagnosticRef:`diag-${e.ref}`,...n?{role:ba(n,256)}:{},...r===void 0?{}:{label:ba(r,256)}}}function io(e,t,n,r,i){let a=n.nodes;return{node:t,selectorChain:ae(t,e.backend.platform,{action:r===`fill`?`fill`:`click`,nodes:a}),refLabel:R(t,a),...oo(t,r),preAction:n,resolution:i,...ao(e,t,a,r)}}function ao(e,t,n,r){if(r!==`click`&&r!==`press`)return{};let i=la(t,n);return i===t?{}:{recordingTarget:{node:i,selectorChain:ae(i,e.backend.platform,{action:`click`,nodes:n}),refLabel:R(i,n)}}}function oo(e,t){return e.hittable===!1?{targetHittable:!1,hint:`The resolved element reports hittable: false, so this ${t} may have had no visible effect. Verify with a snapshot, or prefer a @ref or a longer/more specific selector to target the intended element.`}:{}}async function so(e){let t=await $i(e.policy,e.nodes,e.node,e.hooks);if(t.kind===`occluded`)throw co({label:e.label,node:t.node,action:e.action});return t.node}function co(e){return new n(`COMMAND_FAILED`,`${e.label} is covered by another visible element and cannot ${lo(e.action)} safely`,{hint:`Use a different visible target, scroll it clear of the overlay, or inspect with snapshot/screenshot before retrying.`,...e.selector?{selector:e.selector}:{},ref:`@${e.node.ref}`,interactionBlocked:e.node.interactionBlocked})}function lo(e){switch(e){case`fill`:return`be filled`;case`focus`:return`be focused`;case`longPress`:return`be long-pressed`;case`hover`:return`be hovered`;default:return`be tapped`}}async function U(e,t,r){if(!e.backend.captureSnapshot)throw new n(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let i=t.session??`default`,a=await e.sessions.get(i);if(!a)throw new n(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let o=await e.backend.captureSnapshot(N(e,t),{interactiveOnly:r,includeRects:!0}),s=o.snapshot??{nodes:o.nodes??[],truncated:o.truncated,backend:o.backend,createdAt:P(e)};return await e.sessions.set({...a,snapshot:s}),{snapshot:s}}async function uo(e,t,r){if(e.backend.platform!==`macos`)return;let i=await fo(e,t);if((i===`desktop`||i===`menubar`)&&(i!==`menubar`||r!==`click`&&r!==`press`))throw new n(`UNSUPPORTED_OPERATION`,`${r} is not supported on macOS ${i} sessions yet. Open an app session to act, or use the ${i} surface to inspect.`)}async function fo(e,t){return(await e.sessions.get(t.session??`default`))?.metadata?.surface}async function po(e,t,r){let{session:i,snapshot:a}=await ha(e,t.session),o=r.fallbackLabel??``,s=ho(a.nodes,r.ref,{fallbackLabel:o});if(!s)throw new n(`COMMAND_FAILED`,`Ref ${r.ref} not found or has no bounds`,{hint:_e});return mo({session:i,frameTree:a,target:r,fallbackLabel:o,authorized:s})}function mo(e){let{session:t,frameTree:n,target:r,fallbackLabel:i,authorized:a}=e,o=t.snapshot;if(!o||o===n)return{snapshot:n,resolved:a};let s=ho(o.nodes,r.ref,{fallbackLabel:i});return s&&Oe(y(a.node),y(s.node))?{snapshot:o,resolved:s}:{snapshot:n,resolved:a}}function ho(e,t,r){let i=a(t);if(!i)throw new n(`INVALID_ARGS`,`Invalid ref: ${t}`);let s=o(e,i);if(_o(s))return eo(i,s,`exact`);let c=r.fallbackLabel.length>0?ua(e,r.fallbackLabel):null;return _o(c)?eo(i,c,`label-fallback`):null}function go(e,t,r){let i=S(t),a=ka(t,e,{bounds:[i.resolveEffectiveViewport(e),e.rect?i.resolveViewport(e.rect):null].filter(e=>e!==null)});if(a.kind===`resolved`)return a.point;throw a.kind===`invalid`?new n(`COMMAND_FAILED`,r.invalidMessage):new n(`COMMAND_FAILED`,`${r.blockedTargetLabel} has no parent-owned touch point outside its interactive descendants`,{reason:`covered_by_interactive_descendants`,...r.blockedTargetDetails,competitorRefs:a.competitorRefs.slice(0,5).map(e=>`@${e}`),competitorCount:a.competitorRefs.length,hint:`Tap the specific interactive child you intend, or use a more specific selector. Every safely tappable region of the parent belongs to one of its child controls.`})}function _o(e){return e?w(e.rect)!==null:!1}async function vo(e,t,n,r,i,{action:a}){return await Co(e,t,n,r,{message:`Selector ${i} resolved to an off-screen element and is not safe to ${a}`,details:{reason:`offscreen_selector`,selector:i},hint:e=>`${bo(e,i)} then retry ${a} with the same selector. --until checks the selector between passes, so it stops on the target rather than sailing past it. If it is inside a closed drawer or another tab, open that container first.`})}async function yo(e,t,n,r,i,{action:o}){return await Co(e,t,n,r,{message:`Ref ${i} is off-screen and not safe to ${o}`,details:{reason:`offscreen_ref`,ref:a(i)},hint:e=>`${bo(e,null)} then retry ${o} with a selector (e.g. text=/id=) rather than this @ref — the scroll expires the ref frame, so re-run snapshot -i before reusing any @ref.`})}function bo(e,t){return e?t?`Run scroll ${e} --until '${t}' to bring it on screen,`:`Scroll ${e} toward it,`:`Scroll toward it,`}async function xo(e,t,n,r){let i=(await e.sessions.get(t.session??`default`))?.snapshot,o=i?.nodes;if(!i||!o||a(n.ref)===null)return{};let s=ho(o,n.ref,{fallbackLabel:n.fallbackLabel??``});if(!s)return{};let c=F.resolvedTarget,l=await so({policy:c,nodes:o,node:s.node,action:r,label:`Ref ${n.ref}`,hooks:{offscreen:async(i,a)=>await yo(e,t,i,a,n.ref,{action:r,pipeline:c})}});return{...oo(l,r),node:l,preAction:B(i)}}async function So(e,t,n,r,i){let a=await xo(e,t,n,r),o=k(await i(N(e,t),{kind:`ref`,ref:n.ref,...n.fallbackLabel?{fallbackLabel:n.fallbackLabel}:{}}));return{kind:`ref`,target:{kind:`ref`,ref:n.ref},resolution:Qa,...a,...o?{backendResult:o}:{}}}async function Co(e,t,r,i,a){let o=S(i),s=r.rect?o.resolveEffectiveViewport(r):null;if(!r.rect||!s||o.isVisibleOnScreen(r))return r;let c=o.resolveViewport(r.rect),l=await e.backend.confirmOffscreenTargetVisible?.(N(e,t),r,c);if(l)return{...r,rect:l};let u=He(r,o);throw new n(`COMMAND_FAILED`,a.message,{...a.details,rect:r.rect,viewport:s,...u?{scrollDirection:u}:{},hint:a.hint(u)})}async function wo(e,t,n,r){let i=new AbortController,a=[t.signal,e.signal].filter(e=>e!==void 0),o=AbortSignal.any([...a,i.signal]),s=!1,c=setTimeout(()=>{s=!0,i.abort(new DOMException(`Wait deadline exceeded`,`TimeoutError`))},Math.max(0,n));c.unref();try{let e=await r(o);return s&&!a.some(e=>e.aborted)?{timedOut:!0}:(o.throwIfAborted(),{timedOut:!1,value:e})}catch(e){if(s&&!a.some(e=>e.aborted))return{timedOut:!0,error:e};throw e}finally{clearTimeout(c)}}function To(e){let t=e.snapshotQuality?.backend,n=(e.backend===`xctest`?Eo(e.nodes):e.nodes).map(ko);return n.sort((e,t)=>jo(e).localeCompare(jo(t))),{captureBackend:t,nodes:n}}function Eo(e){let t=S(e);return e.filter(e=>pe(e)||t.isVisibleOnScreen(e))}function Do(e,t){return!e||e.captureBackend!==t.captureBackend||e.nodes.length!==t.nodes.length?!1:e.nodes.every((e,n)=>{let r=t.nodes[n];if(!r||e.identity!==r.identity)return!1;if(!e.rect||!r.rect)return e.rect===r.rect;let i=e.rect,a=r.rect;return[`x`,`y`,`width`,`height`].every(e=>Math.abs(Math.round(i[e])-Math.round(a[e]))<=1)})}function Oo(e,t){if(!e||e.nodes.length===0||t.nodes.length===0)return!1;let n=new Map;for(let t of e.nodes)n.set(t.identity,(n.get(t.identity)??0)+1);let r=0;for(let e of t.nodes){let t=n.get(e.identity)??0;t!==0&&(r+=1,n.set(e.identity,t-1))}return r/Math.max(e.nodes.length,t.nodes.length)<.5}function ko(e){return{identity:`${e.type??``}#${Ao(e)}`,...e.rect?{rect:{...e.rect}}:{}}}function Ao(e){return[e.label,e.identifier,e.value].map(e=>String(e??``).trim()).join(`#`)}function jo(e){let t=e.rect;return`${e.identity}#${t?`${t.x},${t.y},${t.width},${t.height}`:``}`}const Mo=`Settled on a nearly-empty tree — the app may still be loading. Wait for specific content (wait text ...) before interacting.`;async function No(e,t,n){let{quietMs:r,timeoutMs:i}=n,a=P(e),o=a+i,s=!1,c=await e.sessions.get(t.session??`default`),l,u=lt(c?.snapshot?.snapshotQuality),d=Math.min(300,Math.max(25,r)),f=0,p,m=0,h,g=a,_=r;for(;P(e)<o;){let c=await Bo(e,t,o-P(e),u);if(!c)return{settled:!1,stalled:!0,waitedMs:P(e)-a,captures:f,nodeCount:m,lastCapture:h};f+=1,h=c,l??=Po(n.broadTransitionBaselineNodes,c.snapshot,e.backend.platform);let ee=To(c.snapshot);_=Io({baseline:l,signal:ee,requestedQuietMs:r,currentQuietMs:_}),u??=lt(c.snapshot.snapshotQuality);let v=P(e),te=Ro({resetRequested:n.resetBudgetOnPrivateAxRecovery,alreadyReset:s,verdict:c.snapshot.snapshotQuality,nowMs:v,timeoutMs:i,deadlineMs:o});if(te!==void 0){s=!0,o=te,g=v,p=ee,m=c.snapshot.nodes.length;let t=zo({nowMs:v,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(t<=0)break;await Jr(e,t);continue}if(!Do(p,ee))p=ee,m=c.snapshot.nodes.length,g=v;else if(f>=2&&v-g>=_)return{settled:!0,stalled:!1,waitedMs:v-a,captures:f,nodeCount:m,lastCapture:h};let y=zo({nowMs:v,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(y<=0)break;await Jr(e,y)}return{settled:!1,stalled:!1,waitedMs:P(e)-a,captures:f,nodeCount:m,lastCapture:h}}function Po(e,t,n){if(!e||!t||!Fo(t.backend,n))return;let r=t.nodes.some(pe),i=e.length<=5;if(!(!r&&!i))return To({...t,nodes:e})}function Fo(e,t){return e===`xctest`||e===void 0&&t===`ios`}function Io(e){return e.requestedQuietMs<500||!Oo(e.baseline,e.signal)?e.currentQuietMs:Math.max(e.requestedQuietMs,1500)}function Lo(e){return e?.state===`recovered`&&e.backend===`private-ax`&&e.reasonCode!==`deferred`}function Ro(e){if(!(e.resetRequested!==!0||e.alreadyReset||!Lo(e.verdict)))return Math.max(e.deadlineMs,e.nowMs+e.timeoutMs)}function zo(e){let t=e.quietSinceMs+e.quietMs-e.nowMs,n=t>e.pollMs?e.pollMs:Math.max(25,t+2),r=e.deadlineMs-e.nowMs,i=r-1;return i<2?r>=2?r:0:Math.min(n,i)}async function Bo(e,t,n,r){let i=await wo(e,t,n,async n=>await z(e,{...t,signal:n},{updateSession:!1,interactiveOnly:!0,preferredBackend:r}));return i.timedOut?void 0:i.value}const Vo=`The UI kept changing for the whole settle budget (animation, carousel, or ticker?), so no settled diff is shown. Raise --timeout, wait for specific content, or take a fresh snapshot.`,Ho=`A snapshot capture stalled past the settle budget, so no settled diff is shown. The action itself succeeded; observe with wait stable or snapshot.`;async function Uo(e,t,n){return await Go(e,t,{...n,baseline:await Jo(e,t,n.resolved),actionPoint:n.resolved.point})}const Wo=async(e,t)=>(await Go(e,t,t)).observation;async function Go(e,t,n){let r=n.quietMs??500,i=n.timeoutMs??1e4,a={settled:!1,waitedMs:0,captures:0,quietMs:r,timeoutMs:i};try{return await Ko(e,t,n,a,await No(e,t,{quietMs:r,timeoutMs:i,resetBudgetOnPrivateAxRecovery:!0,broadTransitionBaselineNodes:n.baseline.nodes}))}catch(e){return{observation:{...a,hint:`Settle observation unavailable (${e instanceof Error?e.message:String(e)}). The action itself succeeded; take a snapshot to observe the result.`}}}}async function Ko(e,t,n,r,i){let a={...r,settled:i.settled,waitedMs:i.waitedMs,captures:i.captures};if(!i.lastCapture)return{observation:{...a,hint:i.stalled?Ho:Vo}};let{stored:o,session:s}=await ss(e,t,i.lastCapture),c=B(i.lastCapture.snapshot),l=c.nodes,u=Ea(n.baseline,c);return{observation:{...a,...u?{surfaceChange:u}:{},...i.settled&&o&&!u?$o(n.baseline.nodes,l,n.actionPoint,s?.appBundleId):{},...as(i,o,l.length,u)},settledCapture:c}}function qo(e,t){if(e)return Da(e,t)}async function Jo(e,t,n){let r=await e.sessions.get(t.session??`default`);return Yo(n,r)??Zo(n.preAction)??Xo(r)}function Yo(e,t){if(e.kind!==`ref`)return;let n=t?.refFrameSnapshot;return n?Zo(B(n)):void 0}function Xo(e){let t=e?.refFrameSnapshot??e?.snapshot;return t?B(t):{nodes:[]}}function Zo(e){return e?.nodes.length?e:void 0}function Qo(e,t,n){let r=Mr(fn(e,n),fn(t,n),{flatten:!0,withRefs:!0}),i=r.lines.filter(e=>e.kind!==`unchanged`),a=is(i).map(e=>({kind:e.kind,text:e.text,...e.ref?{ref:e.ref}:{}}));return{summary:r.summary,lines:a,...i.length>a.length?{truncated:!0}:{}}}function $o(e,t,n,r){let i=Qo(e,t,r);return{diff:i,...es(i,t,n,r)}}function es(e,t,n,r){let i=new Set(e.lines.filter(e=>e.kind===`added`&&e.ref).map(e=>e.ref)),a=pn(t,r),o=new Map(t.filter(e=>e.ref).map(e=>[e.ref,e]));return[...i].some(e=>e!==void 0&&!a.has(e)&&!ts(o.get(e),n))?{}:rs(t,i,r)}function ts(e,t){if(!e?.rect||!t)return!1;let{x:n,y:r,width:i,height:a}=e.rect;return t.x>=n&&t.x<=n+i&&t.y>=r&&t.y<=r+a}const ns=new Set([`application`,`window`]);function rs(e,t,n){let r=pn(e,n),i=e.filter(e=>e.ref&&e.interactionBlocked!==`covered`&&!t.has(e.ref)&&!r.has(e.ref)&&!ns.has(Me(e.type??`Element`)));if(i.length===0)return{};let a=i.slice(0,20).map(e=>{let t=Me(e.type??`Element`),n=Ve(e,t);return{ref:e.ref,role:t,...n?{label:n}:{}}});return{tail:a,...i.length>a.length?{tailTruncated:!0}:{}}}function is(e){if(e.length<=80)return e;let t=e.filter(e=>e.kind===`added`),n=new Set(t.slice(0,80)),r=80-n.size,i=[];for(let t of e)n.has(t)?i.push(t):t.kind===`removed`&&r>0&&(i.push(t),--r);return i}function as(e,t,n,r){let i=os(e,t,n).hint;if(!r)return i===void 0?{}:{hint:i};let a=Oa(r);return{hint:i===void 0?a:`${a} ${i}`}}function os(e,t,n){return e.stalled?{hint:Ho}:e.settled?t?n<5?{hint:Mo}:{}:{hint:`Settled on a sparse, unreadable tree — the diff is omitted and its refs/selectors are invalid. Use screenshot as visual truth and coordinate taps; retry snapshot after navigating.`}:{hint:Vo}}async function ss(e,t,n){if(dt(n.snapshot.snapshotQuality))return{stored:!1};let r=await e.sessions.get(t.session??`default`);return r?(await e.sessions.set({...r,snapshot:n.snapshot}),{stored:!0,session:r}):{stored:!1}}function cs(e){let t=e.verify===!0;return{verify:t,needsPreActionBaseline:t||e.settle!==void 0,...e.settle===void 0?{}:{settle:e.settle}}}async function ls(e,t,n,r,i){let a=await us(e,t,n,i);return fs({...r,...a})}async function us(e,t,n,r){if(r.settle!==void 0){let i=await Uo(e,t,{...r.settle,resolved:n}),a=r.verify?qo(i.settledCapture,n.preAction):void 0;return{settle:i.observation,...a?{evidence:a}:{}}}if(!r.verify)return{};let i=await ds(e,t,n);return i?{evidence:i}:{}}async function ds(e,t,n){try{return Da(B((await U(e,t,!0)).snapshot),n.preAction)}catch{return}}function fs(e){let t=e;if(t.targetHittable!==!1||!ps(t)||t.hint===void 0)return e;let{hint:n,...r}=t;return r}function ps(e){if(e.evidence?.changedFromBefore===!0||e.settle?.surfaceChange!==void 0)return!0;let t=e.settle?.diff?.summary;return!!t&&(t.additions>0||t.removals>0)}function ms(e,t){let r=S(e),i=e.filter(r.isVisibleInEffectiveViewport).map(e=>e.rect).filter(hs),a=i.length>0?i:e.map(e=>e.rect).filter(hs);if(a.length===0)throw new n(`COMMAND_FAILED`,`Cannot infer viewport for ${t}`);let o=Math.min(...a.map(e=>e.x)),s=Math.min(...a.map(e=>e.y)),c=Math.max(...a.map(e=>e.x+e.width)),l=Math.max(...a.map(e=>e.y+e.height));return{x:o,y:s,width:c-o,height:l-s}}function hs(e){return!!(e&&e.width>0&&e.height>0)}async function gs(e,t){return await e.backend.resolveGestureViewport?.(N(e,t))||ms((await U(e,t,!1)).snapshot.nodes,`gesture`)}const _s=async(e,t)=>{let r=await H(e,t,{action:`focus`,requireInteractive:!0,pipeline:F.resolvedTarget});if(!e.backend.focus)throw new n(`UNSUPPORTED_OPERATION`,`focus is not supported by this backend`);let i=Ds(r),a=k(await e.backend.focus(N(e,t),i));return{...r,...a?{backendResult:a}:{},...C(`Focused (${i.x}, ${i.y})`)}},vs=async(e,t)=>{let r=cs(t),i=await H(e,t,{action:`longPress`,requireInteractive:!0,pipeline:F.promotedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget});if(!e.backend.longPress)throw new n(`UNSUPPORTED_OPERATION`,`longPress is not supported by this backend`);let a=t.durationMs===void 0?void 0:D(t.durationMs,`durationMs`,0,12e4),o=Ds(i),s=k(await e.backend.longPress(N(e,t),o,{durationMs:a}));return await ls(e,t,i,{...i,...a===void 0?{}:{durationMs:a},...s?{backendResult:s}:{},...C(`Long pressed (${o.x}, ${o.y})`)},r)},ys=async(e,t)=>{let r=cs(t),i=r.needsPreActionBaseline?null:await bs(e,t);if(i)return i;let a=await H(e,t,{action:`hover`,requireInteractive:!1,pipeline:F.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget});if(!e.backend.hover)throw new n(`UNSUPPORTED_OPERATION`,`hover is not supported by this backend`);let o=Ds(a),s=k(await e.backend.hover(N(e,t),o));return await ls(e,t,a,{...a,...s?{backendResult:s}:{},...C(`Hovered (${o.x}, ${o.y})`)},r)};async function bs(e,t){if(t.target.kind!==`ref`||!e.backend.hoverTarget||t.expectedResolvedTarget)return null;let{hoverTarget:n}=e.backend;return await So(e,t,t.target,`hover`,async(e,t)=>await n(e,t))}const xs=async(e,t)=>{if(!e.backend.performGesture)throw new n(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await uo(e,t,`drag`);let r=await gs(e,t),i=await Ss(e,t,`source`),a=await Ss(e,t,`destination`),o=et({from:Ds(i),to:Ds(a),sourceHoldMs:t.gesture.sourceHoldMs,moveMs:t.gesture.moveMs,destinationHoldMs:t.gesture.destinationHoldMs},r),s=k(await e.backend.performGesture(N(e,t),o)),{start:c,end:l}=Qe(o);return{kind:`drag`,durationMs:o.durationMs,pointerCount:1,from:c,to:l,targets:{source:Cs(i),destination:Cs(a)},recording:ws(i,a),...s?{backendResult:s}:{},...C(`Dragged ${t.gesture.source} to ${t.gesture.destination}`)}};async function Ss(e,t,n){let r=t.gesture[n];return await H(e,{...t,target:r.startsWith(`@`)?{kind:`ref`,ref:r}:{kind:`selector`,selector:r}},{action:`drag`,requireInteractive:!1,pipeline:F.resolvedTarget,expectedResolvedTarget:t.expectedResolvedTargets?.[n],replayTargetRole:n})}function Cs(e){if(e.kind===`point`||!e.resolution)throw new n(`COMMAND_FAILED`,`gesture drag target resolution was not disclosed`);let t=`selectorChain`in e?e.selectorChain:void 0;return{...t?.length?{selectorChain:t}:{},resolution:e.resolution}}function ws(e,t){let n=Ts(e),r=Ts(t),i=Es(e),a=Es(t);return{...n?{sourceSelector:n}:{},...r?{destinationSelector:r}:{},...i?{sourceTarget:i}:{},...a?{destinationTarget:a}:{}}}function Ts(e){return`selectorChain`in e&&e.selectorChain?.length?e.selectorChain.join(` || `):void 0}function Es(e){if(!(!(`selectorChain`in e)||!e.selectorChain?.length||!e.node||!e.preAction))return{selectorChain:e.selectorChain,node:e.node,preActionNodes:e.preAction.nodes}}function Ds(e){if(!e.point)throw new n(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}const Os=async(e,t)=>await js(e,t,`press`),ks=async(e,t)=>await js(e,t,`click`),As=async(e,t)=>{if(typeof t.text!=`string`)throw new n(`INVALID_ARGS`,`fill requires text`);let r=cs(t),i=r.needsPreActionBaseline?null:await Ps(e,t);if(i)return i;let a=await H(e,t,{action:`fill`,requireInteractive:!0,pipeline:F.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget,preresolvedTarget:t.preresolvedTarget});if(!e.backend.fill)throw new n(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=Ms(a),s=`node`in a?a.node?.type??``:``,c=s!==``&&ce(s,e.backend.platform),l=t.allowNonHittableCoordinateFallback===!0&&`node`in a&&a.node?.hittable===!1,u=k(await e.backend.fill(N(e,t),o,t.text,{delayMs:t.delayMs,allowNonHittableCoordinateFallback:l})),d=s&&!c?`fill target ${Is(a)} resolved to "${s}", attempting fill anyway.`:void 0;return await ls(e,t,a,{...a,text:t.text,...d?{warning:d}:{},...u?{backendResult:u}:{}},r)};async function js(e,t,r){let i=cs(t),a=i.needsPreActionBaseline?null:await Ns(e,t,r);if(a)return a;let o=await H(e,t,{action:r,requireInteractive:!0,pipeline:F.promotedTarget,captureEvidenceBaseline:i.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget,preresolvedTarget:t.preresolvedTarget});if(!e.backend.tap)throw new n(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let s=Ms(o),c;try{c=await e.backend.tap(N(e,t),s,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap})}catch(e){throw Ti(e,o),e}let l=k(c);return await ls(e,t,o,{...o,...l?{backendResult:l}:{}},i)}function Ms(e){if(!e.point)throw new n(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}async function Ns(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||Fs(t)||t.expectedResolvedTarget)return null;let{tapTarget:r}=e.backend;return await So(e,t,t.target,n,async(e,t)=>await r(e,t))}async function Ps(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let{fillTarget:n}=e.backend;return{...await So(e,t,t.target,`fill`,async(e,r)=>await n(e,r,t.text,{delayMs:t.delayMs})),text:t.text}}function Fs(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 Is(e){return e.target?.kind===`ref`?e.target.ref:e.target?.kind===`selector`?e.target.selector:`point`}function W(e){return{includeRects:e===`visible`||e===`hidden`,interactiveOnly:!1}}const Ls=F.wait.poll.defaultTimeoutMs;function Rs(e,t,n,r,i={}){let a=ra(r),o=n??a.defaultTimeoutMs,s=K(e),c=Zs(i.isUnreadableError),l=[],u={},d=()=>Math.max(0,o-(K(e)-s));return{capture:async n=>{let r=!1,i=K(e)-s,a=t=>l.push({startedMs:i,durationMs:K(e)-s-i,outcome:t}),o=await wo(e,t,d(),async e=>await c.attempt(async()=>{let t=await n(e);return r=!0,t}));if(!o.timedOut)return r&&c.recordReadableCapture(),a(zs(r,c.lastUnobservedCause())),o;let f=Ys(o.error);return a(f?`runner-restart`:`deadline`),u=f??{},{timedOut:!0,deadline:Bs(f!==void 0,c.readableCaptures())}},hasTimeRemaining:()=>d()>0,failureEvidence:()=>({timeoutMs:o,readableCaptures:c.readableCaptures(),captures:l.length,polls:Vs(l),waitedMs:K(e)-s,...u}),preserveUnreadableOnStall:i.preserveUnreadableOnStall,neverReadableCause:c.neverReadableCause,sleepUntilNextPoll:async()=>await Qs(e,t,Math.min(a.intervalMs,d())),timeoutMs:o,waitedMs:()=>K(e)-s}}function zs(e,t){return e?`readable`:t?.outcome??`unreadable`}function Bs(e,t){return e?`runner-restart-exhausted`:t===0?`capture-stalled`:`capture-truncated`}function Vs(e){return e.length<=30?[...e]:[...e.slice(0,5),...e.slice(-25)]}function Hs(e,t){return new n(`COMMAND_FAILED`,e,{reason:V.captureStalled,captureStalled:!0,...t,retriable:!0,hint:`No readable snapshot capture completed before the wait timeout. Retry, or use screenshot to inspect the current surface.`})}function Us(e,t){return new n(`COMMAND_FAILED`,e,{reason:V.runnerRestartExhausted,waitRunnerRestartExhausted:!0,...t,retriable:!0,hint:`An iOS runner restart consumed the wait timeout before a readable snapshot completed. Inspect the diagnostics log for the runner invalidation/restart sequence, then retry.`})}function Ws(e,t){return new n(`COMMAND_FAILED`,e,{reason:V.deadlineExceeded,captureTruncated:!0,...t})}function Gs(e,t){return new n(`COMMAND_FAILED`,e,{reason:V.targetAbsent,...t})}function Ks(e,t,n){let r=e.neverReadableCause();if(r!==void 0){if(r.outcome===`retriable`)throw qs(r.error,t);if(n)throw r.error}}function qs(e,t){let r=c(e);return new n(r.code,r.message,{reason:V.captureStalled,...r.details,...t},r)}function Js(e,t,n){let r=t.failureEvidence();return n===`runner-restart-exhausted`?Us(e,r):n===`capture-stalled`?(Ks(t,r,t.preserveUnreadableOnStall===!0),Hs(e,r)):n===`capture-truncated`?Ws(e,r):(Ks(t,r,!0),r.readableCaptures===0?Hs(e,r):Gs(e,r))}function Ys(e){if(!(e instanceof n))return;let t=e.details;if(t?.runnerRestarted===!0)return{runnerRestarted:!0,...G(t,`runnerRestartReason`),...G(t,`runnerRestartCommand`),...G(t,`runnerRestartCommandId`),...G(t,`runnerInvalidatedSessionId`),...G(t,`runnerRestartSessionId`),...G(t,`logPath`),...G(t,`diagnosticId`)}}function G(e,t){let n=e?.[t];return typeof n==`string`?{[t]:n}:{}}function Xs(e){return e instanceof n&&e.details?.retriable===!0}function Zs(e=nt){let t=0,n;return{attempt:async t=>{try{return await t()}catch(t){if(e(t))n={outcome:`unreadable`,error:t};else if(Xs(t))n={outcome:`retriable`,error:t};else throw t;return}},lastUnobservedCause:()=>n,recordReadableCapture:()=>{t+=1},readableCaptures:()=>t,neverReadableCause:()=>t===0?n:void 0}}function K(e){return e.clock?.now()??Date.now()}async function Qs(e,t,n){let r=[t.signal,e.signal].filter(e=>e!==void 0);for(let e of r)e.throwIfAborted();if(n<=0)return!1;if(e.clock){await e.clock.sleep(n);for(let e of r)e.throwIfAborted();return!0}return await new Promise((e,t)=>{let i=r.length>0?AbortSignal.any(r):void 0,a=()=>i?.removeEventListener(`abort`,s),o=setTimeout(()=>{a(),e()},n),s=()=>{clearTimeout(o),a(),t(i?.reason)};i?.addEventListener(`abort`,s,{once:!0}),o.unref()}),!0}async function $s(e,t,n){let r=await L(F.readAny,e.nodes,t,{platform:n}),i=r.kind===`target`||r.kind===`ambiguous`?r.matchedNodes:r.kind===`occluded`?[r.node]:[];return{selector:r.kind===`target`||r.kind===`ambiguous`?r.selector:t,observation:Le(e,i)}}async function ec(e,t,n){let r=await $s(e,t,n),i=r.observation;if(i.kind!==`absent`)throw Ie(r.selector,i);return{predicate:`absent`,pass:!0,selector:t,matches:i.matches}}async function tc(e,t,n,r,i){let a=je(n);if(a)throw Be(a,`wait`);let o=Rs(t,n,i,F.wait,{isUnreadableError:rc,preserveUnreadableOnStall:!0}),s=W(),c,l;for(;o.hasTimeRemaining();){let i=await o.capture(async i=>{try{let{observation:a}=await $s((await e.captureSnapshot(t,{...n,signal:i},{updateSession:!0,includeHiddenContentHints:!1,...s})).snapshot,r,t.backend.platform);if(a.kind===`sparse`||a.kind===`truncated`)throw Ie(r,a,`wait`);return a}catch(e){throw nt(e)?ze(r,e,`wait`):e}});if(i.timedOut){l=i.deadline;break}let a=i.value;if(a?.kind===`absent`)return{kind:`absent`,waitedMs:o.waitedMs()};a?.kind===`present`&&(c=a),await o.sleepUntilNextPoll()}throw l===`runner-restart-exhausted`?Js(`wait absent timed out for selector: ${r}`,o,l):c?nc(r,c,o.failureEvidence()):Js(`wait absent timed out for selector: ${r}`,o,l)}function nc(e,t,r){let i=t.matches!==1;return new n(`COMMAND_FAILED`,`wait absent timed out for selector ${e}: ${t.matches} match${i?`es`:``} remain`,{reason:V.targetPresent,selector:e,...r,matches:t.matches,firstMatch:t.firstMatch})}function rc(e){if(!(e instanceof n))return!1;let t=e.details;return t?.command===`wait`&&t.predicate===`absent`&&(t.observation===`sparse`||t.observation===`truncated`||t.observation===`unreadable`)}function ic(e){if(e.kind===`ambiguous`||e.kind===`target`)return{selector:e.selector,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}async function ac(e,t,r,i,a,o){let s=Rs(t,r,a,F.wait),c=W(),l,u;for(;s.hasTimeRemaining();){let n=await s.capture(async n=>await e.captureSnapshot(t,{...r,signal:n},{updateSession:!0,includeHiddenContentHints:!1,...c}));if(n.timedOut){u=n.deadline;break}let a=n.value;if(a){let e=a.snapshot.nodes,n=ic(await L(F.wait,e,i,{platform:t.backend.platform}));if(n){let t=oc(e,n,o);if(t.kind===`satisfied`)return{kind:`selector`,selector:n.selector,waitedMs:s.waitedMs(),node:t.node,preActionNodes:e};l=t.evidence}}await s.sleepUntilNextPoll()}throw u!==`capture-stalled`&&l?new n(`COMMAND_FAILED`,`wait matched selector ${i} but no candidate carried the recorded landmark identity`,{reason:Ba,...s.failureEvidence(),...l}):Js(`wait timed out for selector: ${i}`,s,u)}function oc(e,t,n){let r=t.matchedNodes[0];if(!n)return{kind:`satisfied`,node:r};let i=gt(e),a=vt(t.matchedNodes,i,v(n),n.ancestry)[0];return a?{kind:`satisfied`,node:a}:{kind:`identity-mismatch`,evidence:{matchCount:t.matchedNodes.length,observed:y(r),observedAncestry:_t(r,i,Math.max(n.ancestry.length,1)).chain}}}async function sc(e,t,r,i,a){let o=a??Ls,s=i??e.stable.defaultQuietMs,c=await e.stable.capture(t,r,{quietMs:s,timeoutMs:o});if(!c.settled)throw new n(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:V.stableTimeout,...c.stalled?{captureStalled:!0}:{},quietMs:s,timeoutMs:o,captures:c.captures,nodeCount:c.nodeCount,...c.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:c.waitedMs,captures:c.captures,nodeCount:c.nodeCount,...c.nodeCount<e.stable.tinyTreeNodeCount?{hint:e.stable.tinyTreeHint}:{}}}async function cc(e,t,n,r,i){let a=Rs(t,n,i,F.wait),o;for(;a.hasTimeRemaining();){let i=await a.capture(async i=>await lc(e,t,{...n,signal:i},r));if(i.timedOut){o=i.deadline;break}if(i.value)return{kind:`text`,text:r,waitedMs:a.waitedMs()};await a.sleepUntilNextPoll()}throw Js(`wait timed out for text: ${r}`,a,o)}async function lc(e,t,n,r){return t.backend.findText&&(await t.backend.findText(dc(t,n),r)).found?!0:await uc(e,t,n,r)}async function uc(e,t,n,r){return!!ua((await e.captureSnapshot(t,n,{updateSession:!0,includeHiddenContentHints:!1})).snapshot.nodes,r)}function dc(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function fc(e){let t=async(t,n)=>{switch(n.target.kind){case`sleep`:return await Qs(t,n,n.target.durationMs),{kind:`sleep`,waitedMs:n.target.durationMs};case`ref`:return await pc(e,t,n,n.target.ref,n.target.timeoutMs);case`selector`:return await ac(e,t,n,n.target.selector,n.target.timeoutMs,n.target.recordedLandmark);case`absent`:return await tc(e,t,n,n.target.selector,n.target.timeoutMs);case`stable`:return await sc(e,t,n,n.target.quietMs,n.target.timeoutMs);case`text`:return await mc(e,t,n,n.target.text,n.target.timeoutMs);default:return hc(n.target)}};return{waitCommand:t,waitForTextCommand:async(e,r)=>{let i=await t(e,{...r,target:{kind:`text`,text:r.text,timeoutMs:r.timeoutMs}});if(i.kind!==`text`)throw new n(`COMMAND_FAILED`,`waitForText returned non-text result`);return i}}}async function pc(e,t,r,i,s){let c=await e.requireSnapshot(t,r.session),l=a(i);if(!l)throw new n(`INVALID_ARGS`,`Invalid ref: ${i}`);let u=o(c.snapshot.nodes,l),d=u?R(u,c.snapshot.nodes):void 0;if(!d)throw new n(`COMMAND_FAILED`,`Ref ${i} not found or has no label`);return await cc(e,t,r,d,s)}async function mc(e,t,r,i,a){let o=be(i);if(!o.ok)throw new n(o.code,o.message);return await cc(e,t,r,o.text,a)}function hc(e){throw Error(`Unsupported wait target: ${String(e)}`)}const gc=fc({captureSnapshot:z,requireSnapshot:ha,stable:{defaultQuietMs:500,tinyTreeHint:Mo,tinyTreeNodeCount:5,capture:No}}),_c=gc.waitCommand,vc=gc.waitForTextCommand,yc=async(e,t)=>{let r=t.locator??`any`;if(!t.query)throw new n(`INVALID_ARGS`,fe);if(t.action===`wait`)return await Cc(e,t,r);if(t.action===`list`)return await wc(e,t,r);let{capture:i,match:a}=await Tc(e,t,r);if(!a)throw new n(`COMMAND_FAILED`,`find did not match any element`);if(t.action===`exists`)return{kind:`found`,found:!0};let o=`@${a.ref}`;return t.action===`get_attrs`?{kind:`attrs`,ref:o,node:a}:{kind:`text`,ref:o,text:await va(e,i,a),node:a}},bc=async(e,t)=>{if(t.target.kind===`ref`){let n=await ha(e,t.session),r=ya(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`});Ha(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=ae(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 va(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await Ec(e,t,t.session??`default`,{selector:t.target.selector,policy:t.property===`text`?F.readText:F.readUnique,hooks:{onResolved:(e,n)=>Ha(e,n,t.expectedResolvedTarget,`get`)}}),r=ae(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 va(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}},xc=async(e,t)=>{let r=await bc(e,{...t,property:`text`,target:t.target});if(r.kind!==`text`)throw new n(`COMMAND_FAILED`,`getText returned non-text result`);return r},Sc=async(e,t)=>{let r=await bc(e,{...t,property:`attrs`,target:t.target});if(r.kind!==`attrs`)throw new n(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return r};async function Cc(e,t,n){let r=Rs(e,t,t.timeoutMs,F.findWait),i;for(;r.hasTimeRemaining();){let a=await r.capture(async r=>await Tc(e,{...t,signal:r},n,{includeHiddenContentHints:!1}));if(a.timedOut){i=a.deadline;break}if(a.value?.match)return{kind:`found`,found:!0,waitedMs:r.waitedMs()};await r.sleepUntilNextPoll()}throw Js(`find wait timed out`,r,i)}async function wc(e,t,n){let r=ie(n,t.query),i=await z(e,t,{updateSession:!0,...W()});if(dt(i.snapshot.snapshotQuality))throw ma(i.snapshot.snapshotQuality);return{kind:`list`,matches:(r?Qi(F.readList,i.snapshot.nodes,r,{platform:e.backend.platform}).list?.matchedNodes??[]:se(i.snapshot.nodes,n,t.query,{}).matches).map(e=>({ref:`@${e.ref}`,node:e}))}}async function Tc(e,t,n,r){let i=ie(n,t.query),a=await z(e,t,{updateSession:!0,scope:pa(e.backend.platform,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...W()});if(dt(a.snapshot.snapshotQuality))throw ma(a.snapshot.snapshotQuality);if(i){let t=await L(F.readAny,a.snapshot.nodes,i,{platform:e.backend.platform});return{capture:a,match:t.kind===`target`?t.node:void 0}}return{capture:a,match:se(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}async function Ec(e,t,r,i){let a=await z(e,{...t,session:r},{updateSession:!0,...W()}),o=await L(i.policy,a.snapshot.nodes,i.selector,{platform:e.backend.platform},i.hooks);if(o.kind!==`target`)throw new n(`COMMAND_FAILED`,De(i.selector,[],{unique:!0}),{hint:g([])});return{capture:a,node:o.node,selector:o.selector,ref:`@${o.node.ref}`}}const Dc=async(e,t)=>{let r=we(t.predicate);if(!r.ok)throw new n(r.code,r.message,{hint:r.hint});let i=r.predicate;if(i===`absent`){let e=je(t);if(e)throw Be(e)}if(i===`text`&&!t.expectedText)throw new n(`INVALID_ARGS`,Te);let a=t.selector,o=await Oc(e,t,i,a);return i===`exists`?await kc(e,o,a):i===`absent`?await ec(o.snapshot,a,e.backend.platform):await Ac(e,t,o,i,a)};async function Oc(e,n,r,i){try{return await z(e,n,{updateSession:!0,...W(r)})}catch(e){throw r!==`absent`||t(e)?e:ze(i,e)}}async function kc(e,t,r){let i=await L(F.readAny,t.snapshot.nodes,r,{platform:e.backend.platform});if(i.kind!==`target`)throw new n(`COMMAND_FAILED`,De(r,[],{unique:!1}),{hint:g([])});return{predicate:`exists`,pass:!0,selector:i.selector,matches:i.matches,selectorChain:ve(r)}}async function Ac(e,t,r,i,a){let o=await L(F.readUnique,r.snapshot.nodes,a,{platform:e.backend.platform},{onResolved:(e,n)=>Ha(e,n,t.expectedResolvedTarget,`is`)});if(o.kind!==`target`)throw new n(`COMMAND_FAILED`,De(a,[],{unique:!0}),{command:`is`,reason:Pe.selectorNotFound,predicate:i,selector:a,hint:g([])});let s=Ee({predicate:i,node:o.node,nodes:r.snapshot.nodes,expectedText:t.expectedText,platform:e.backend.platform});if(!s.pass)throw new n(`COMMAND_FAILED`,`is ${i} failed for selector ${o.selector}: ${s.details}`,{command:`is`,reason:Pe.predicateFailed,predicate:i,selector:o.selector,predicateDetails:s.details});return{predicate:i,pass:!0,selector:o.selector,...i===`text`?{text:s.actualText}:{},selectorChain:ve(a),node:o.node,preActionNodes:r.snapshot.nodes}}const jc=async(e,t)=>await Dc(e,{...t,predicate:`visible`,selector:t.target.selector}),Mc=async(e,t)=>await Dc(e,{...t,predicate:`hidden`,selector:t.target.selector}),Nc=async(e,t)=>{if(!e.backend.performGesture)throw new n(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await uo(e,t,t.gesture.intent);let r=await gs(e,t),i=$e(t.gesture,r,e.backend.platform),a=k(await e.backend.performGesture(N(e,t),i)),o=Fc(i.pointers,0),s=Fc(i.pointers,-1);return{kind:t.gesture.intent,durationMs:i.durationMs,pointerCount:i.topology===`single`?1:2,from:o,to:s,...a?{backendResult:a}:{},...C(Ic(t.gesture,o,s))}},Pc=async(e,t)=>{let n=t.gesture;return n.intent===`drag`?await xs(e,{...t,gesture:n}):await Nc(e,{...t,gesture:n})};function Fc(e,t){let r=e.map(e=>t===0?e.samples[0]?.point:e.samples.at(-1)?.point);if(r.some(e=>e===void 0))throw new n(`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 Ic(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 q={find:yc,get:bc,getText:xc,getAttrs:Sc,is:Dc,isVisible:jc,isHidden:Mc,wait:_c,waitForText:vc},J={click:ks,press:Os,fill:As,focus:_s,longPress:vs,hover:ys,gesture:Pc,settleObservation:Wo};function Lc(e){return{find:t=>q.find(e,t),get:t=>q.get(e,t),getText:(t,n={})=>q.getText(e,{...n,target:t}),getAttrs:(t,n={})=>q.getAttrs(e,{...n,target:t}),is:t=>q.is(e,t),isVisible:(t,n={})=>q.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>q.isHidden(e,{...n,target:t}),wait:t=>q.wait(e,t),waitForText:(t,n={})=>q.waitForText(e,{...n,text:t})}}function Rc(e){return{click:(t,n={})=>J.click(e,{...n,target:t}),press:(t,n={})=>J.press(e,{...n,target:t}),fill:(t,n,r={})=>J.fill(e,{...r,target:t,text:n}),focus:(t,n={})=>J.focus(e,{...n,target:t}),longPress:(t,n={})=>J.longPress(e,{...n,target:t}),hover:(t,n={})=>J.hover(e,{...n,target:t}),gesture:t=>J.gesture(e,t),settleObservation:t=>J.settleObservation(e,t)}}function Y(e,t){if(e!==void 0)return X(e,t)}function X(e,t){let r=e?.trim();if(!r)throw new n(`INVALID_ARGS`,`${t} must be a non-empty string`);return r}const zc=async(e,t={})=>{if(!e.backend.listDevices)throw new n(`UNSUPPORTED_OPERATION`,`admin.devices is not supported by this backend`);return{kind:`adminDevices`,devices:await e.backend.listDevices(N(e,t),t.filter)}},Bc=async(e,t={})=>{if(!e.backend.bootDevice)throw new n(`UNSUPPORTED_OPERATION`,`admin.boot is not supported by this backend`);let r=Xc(t.target),i=k(await e.backend.bootDevice(N(e,t),r));return{kind:`deviceBooted`,...r?{target:r}:{},...i?{backendResult:i}:{},...C(`Booted device`)}},Vc=async(e,t={})=>{if(!e.backend.shutdownDevice)throw new n(`UNSUPPORTED_OPERATION`,`admin.shutdown is not supported by this backend`);let r=Xc(t.target),i=k(await e.backend.shutdownDevice(N(e,t),r));return{kind:`deviceShutdown`,...r?{target:r}:{},...i?{backendResult:i}:{},...C(`Shutdown device`)}},Hc=async(e,t)=>await Gc(e,t,`install`),Uc=async(e,t)=>await Gc(e,t,`reinstall`),Wc=async(e,t)=>await Gc(e,t,`installFromSource`);async function Gc(e,t,r){let i=r===`reinstall`?`reinstallApp`:`installApp`,a=e.backend[i];if(!a)throw new n(`UNSUPPORTED_OPERATION`,`admin.${r} is not supported by this backend`);let o=`app`in t&&t.app!==void 0?X(t.app,`app`):void 0;if(r!==`installFromSource`&&!o)throw new n(`INVALID_ARGS`,`admin.${r} requires app`);let s=N(e,t),c=await Kc(e,s,t.source);try{let t=await a.call(e.backend,s,{...o?{app:o}:{},source:c.source});return Zc(r,o,c.source,t)}finally{await c.cleanup?.()}}async function Kc(e,t,n){let r=await qc(e,Jc(n));try{return{source:Jc(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 qc(e,t){if(t.kind===`url`)return{source:t};let n=await _r(e,t,{usage:`admin.install`,field:`source`});return{source:{kind:`path`,path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function Jc(e){if(!e||typeof e!=`object`)throw new n(`INVALID_ARGS`,`install source is required`);if(e.kind===`path`)return{kind:`path`,path:X(e.path,`source.path`)};if(e.kind===`uploadedArtifact`)return{kind:`uploadedArtifact`,id:X(e.id,`source.id`)};if(e.kind===`url`){let t=X(e.url,`source.url`);return Yc(t),{kind:`url`,url:t}}throw new n(`INVALID_ARGS`,`install source kind must be path, uploadedArtifact, or url`)}function Yc(e){let t;try{t=new URL(e)}catch{throw new n(`INVALID_ARGS`,`Invalid install source URL: ${e}`)}if(t.protocol!==`http:`&&t.protocol!==`https:`)throw new n(`INVALID_ARGS`,`Install source URL must use http or https`)}function Xc(e){if(!e)return;let t=Y(e.id,`target.id`),n=Y(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 Zc(e,t,n,r){let i=k(r),a=e===`reinstall`?`appReinstalled`:e===`installFromSource`?`appInstalledFromSource`:`appInstalled`,o=Z(r,`appName`),s=Z(r,`appId`),c=Z(r,`bundleId`),l=Z(r,`packageName`),u=Z(r,`launchTarget`),d=Z(r,`installablePath`),f=Z(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}:{},...C(`${e===`reinstall`?`Reinstalled`:`Installed`}: ${o??u??t??Qc(n)}`)}}function Z(e,t){let n=e[t];return typeof n==`string`&&n.length>0?n:void 0}function Qc(e){return e.kind===`path`?e.path:e.kind===`uploadedArtifact`?e.id:e.url}const $c=/^[A-Za-z0-9_.:-]{1,64}$/,el=async(e,t)=>{if(!e.backend.openApp)throw new n(`UNSUPPORTED_OPERATION`,`apps.open is not supported by this backend`);let r=ol(t),i=k(await e.backend.openApp(Q(e,t),r,{launchArgs:t.launchArgs,relaunch:t.relaunch}));return{kind:`appOpened`,target:r,relaunch:t.relaunch===!0,...i?{backendResult:i}:{},...C(`Opened: ${cl(r)}`)}},tl=async(e,t={})=>{if(!e.backend.closeApp)throw new n(`UNSUPPORTED_OPERATION`,`apps.close is not supported by this backend`);let r=Y(t.app,`app`),i=k(await e.backend.closeApp(Q(e,t),r));return{kind:`appClosed`,...r?{app:r}:{},...i?{backendResult:i}:{},...C(r?`Closed: ${r}`:`Closed app`)}},nl=async(e,t={})=>{if(!e.backend.listApps)throw new n(`UNSUPPORTED_OPERATION`,`apps.list is not supported by this backend`);return{kind:`appsList`,apps:await e.backend.listApps(Q(e,t),We(t.filter))}},rl=async(e,t)=>{if(!e.backend.getAppState)throw new n(`UNSUPPORTED_OPERATION`,`apps.state is not supported by this backend`);let r=X(t.app,`app`);return{kind:`appState`,app:r,state:await e.backend.getAppState(Q(e,t),r)}},il=async(e,t)=>{if(!e.backend.pushFile)throw new n(`UNSUPPORTED_OPERATION`,`apps.push is not supported by this backend`);let r=X(t.app,`app`),i=await ll(e,t.input);try{let n=k(await e.backend.pushFile(Q(e,t),i.backendInput,r));return{kind:`appPushed`,app:r,inputKind:i.inputKind,...n?{backendResult:n}:{},...C(`Pushed to ${r}`)}}finally{await i.cleanup?.()}},al=async(e,t)=>{if(!e.backend.triggerAppEvent)throw new n(`UNSUPPORTED_OPERATION`,`apps.triggerEvent is not supported by this backend`);let r=ul(t.name);dl(t.payload,`apps.triggerEvent payload for "${r}"`);let i=k(await e.backend.triggerAppEvent(Q(e,t),{name:r,...t.payload?{payload:t.payload}:{}}));return{kind:`appEventTriggered`,name:r,...t.payload?{payload:t.payload}:{},...i?{backendResult:i}:{},...C(`Triggered app event: ${r}`)}};function ol(e){let t=Y(e.app,`app`),r=Y(e.appId,`appId`),i=Y(e.bundleId,`bundleId`),a=Y(e.packageName,`packageName`),o=Y(e.url,`url`),s=Y(e.activity,`activity`),c={...t?{app:t}:{},...r?{appId:r}:{},...i?{bundleId:i}:{},...a?{packageName:a}:{},...o?{url:o}:{},...s?{activity:s}:{}};if(!sl(c))throw new n(`INVALID_ARGS`,`apps.open requires app, appId, bundleId, packageName, url, or activity`);return c}function sl(e){return!!(e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity)}function cl(e){return e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity??`app`}async function ll(e,t){if(!t||typeof t!=`object`)throw new n(`INVALID_ARGS`,`apps.push requires an input`);if(t.kind===`json`)return fl(t.payload,`apps.push JSON payload`,8192),{backendInput:{kind:`json`,payload:t.payload},inputKind:`json`};let r=await _r(e,t,{usage:`apps.push`,field:`input`});return{backendInput:{kind:`file`,path:r.path},inputKind:`file`,...r.cleanup?{cleanup:r.cleanup}:{}}}function ul(e){let t=X(e,`name`);if(!$c.test(t))throw new n(`INVALID_ARGS`,`Invalid apps.triggerEvent name: ${t}`,{hint:`Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash.`});return t}function dl(e,t){e!==void 0&&fl(e,t,8192)}function fl(e,t,r){if(pl(e,t),Buffer.byteLength(ml(e,t),`utf8`)>r)throw new n(`INVALID_ARGS`,`${t} exceeds ${r} bytes`)}function pl(e,t){if(!e||typeof e!=`object`||Array.isArray(e))throw new n(`INVALID_ARGS`,`${t} must be a JSON object`)}function ml(e,t){try{let r=JSON.stringify(e);if(typeof r!=`string`)throw new n(`INVALID_ARGS`,`${t} must be JSON-serializable`);return r}catch{throw new n(`INVALID_ARGS`,`${t} must be JSON-serializable`)}}function Q(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}const hl={open:el,close:tl,list:nl,state:rl,push:il,triggerEvent:al},gl={devices:zc,boot:Bc,shutdown:Vc,install:Hc,reinstall:Uc,installFromSource:Wc};function _l(e){return{...O(hl,e),list:(t={})=>hl.list(e,{...t,filter:Ge(t.filter)})}}const vl=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,yl=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function bl(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(yl,()=>(t=!0,`[REDACTED]`)),n=Sl(n,()=>{t=!0}),{value:n,redacted:t}}function xl(e){try{let t=new URL(e),n=Cl(t);return(t.username||t.password)&&(t.username=`REDACTED`,t.password=`REDACTED`,n=!0),{value:t.toString(),redacted:n}}catch{return}}function Sl(e,t){return/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(e)?e.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let n=xl(e);return n?(n.redacted&&t(),n.value):e}):e}function Cl(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))vl.test(n)&&(e.searchParams.set(n,`[REDACTED]`),t=!0);return t}const wl=2048,Tl=4096,El=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function Dl(e){let t=e.redacted===!0;return{kind:`diagnosticsLogs`,entries:e.entries.map(e=>{let n=$(e.message,Tl),r=Pl(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 Ol(e,t){let n=e.redacted===!0;return{kind:`diagnosticsNetwork`,entries:e.entries.map(e=>{let r=e.url?jl(e.url):void 0,i=t===`headers`||t===`all`?Al(e.requestHeaders):void 0,a=t===`headers`||t===`all`?Al(e.responseHeaders):void 0,o=t===`body`||t===`all`?Ml(e.requestBody):void 0,s=t===`body`||t===`all`?Ml(e.responseBody):void 0,c=Pl(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 kl(e){let t=e.redacted===!0;return{kind:`diagnosticsPerf`,metrics:e.metrics.map(e=>{let n=$(e.message,Tl),r=Pl(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 Al(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[r,i]of Object.entries(e))if(El.test(r))n[r]=`[REDACTED]`,t=!0;else{let e=$(i,wl);n[r]=e.value??``,t||=e.redacted}return{value:n,redacted:t}}function jl(e){return xl(e)??$(e,wl)}function Ml(e){return e===void 0?{redacted:!1}:Nl(e)??$(e,wl)}function Nl(e){try{let t=Fl(JSON.parse(e),bl);return Il(JSON.stringify(t.value),wl,t.redacted)}catch{return}}function Pl(e){return Fl(e,e=>$(e,wl))}function Fl(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=Fl(e,t);return n||=r.redacted,r.value}),redacted:n}}let n=!1,r={};for(let[i,a]of Object.entries(e)){if(El.test(i)){r[i]=`[REDACTED]`,n=!0;continue}let e=Fl(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=bl(e);return Il(n.value,t,n.redacted)}function Il(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 Ll=async(e,t={})=>{if(!e.backend.readLogs)throw new n(`UNSUPPORTED_OPERATION`,`diagnostics.logs is not supported by this backend`);return Dl(await e.backend.readLogs(await Bl(e,t),Vl(t)))},Rl=async(e,t={})=>{if(!e.backend.dumpNetwork)throw new n(`UNSUPPORTED_OPERATION`,`diagnostics.network is not supported by this backend`);let r=Hl(t);return Ol(await e.backend.dumpNetwork(await Bl(e,t),r),r.include??`summary`)},zl=async(e,t={})=>{if(!e.backend.measurePerf)throw new n(`UNSUPPORTED_OPERATION`,`diagnostics.perf is not supported by this backend`);return kl(await e.backend.measurePerf(await Bl(e,t),Ul(t)))};async function Bl(e,t){let n=N(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 Vl(e){return{...Wl(e,100,500,`logs limit`),...e.levels===void 0?{}:{levels:ql(e.levels,`levels`)},...e.search===void 0?{}:{search:X(e.search,`search`)},...e.source===void 0?{}:{source:X(e.source,`source`)}}}function Hl(e){return{...Wl(e,25,200,`network limit`),include:Kl(e.include)}}function Ul(e){return{...Gl(e),...e.sampleMs===void 0?{}:{sampleMs:D(e.sampleMs,`sampleMs`,100,6e4)},...e.metrics===void 0?{}:{metrics:ql(e.metrics,`metrics`,20)}}}function Wl(e,t,n,r){return{...Gl(e),...e.cursor===void 0?{}:{cursor:X(e.cursor,`cursor`)},limit:e.limit===void 0?t:D(e.limit,r,1,n)}}function Gl(e){return{...e.since===void 0?{}:{since:X(e.since,`since`)},...e.until===void 0?{}:{until:X(e.until,`until`)}}}function Kl(e){if(e===void 0)return`summary`;if(e===`summary`||e===`headers`||e===`body`||e===`all`)return e;throw new n(`INVALID_ARGS`,`network include must be summary, headers, body, or all`)}function ql(e,t,r=50){if(!Array.isArray(e))throw new n(`INVALID_ARGS`,`${t} must be an array of strings`);if(e.length>r)throw new n(`INVALID_ARGS`,`${t} must contain at most ${r} entries`);return e.map((e,n)=>X(e,`${t}[${n}]`))}const Jl={logs:Ll,network:Rl,perf:zl},Yl=async(e,t)=>{let r=eu(t.action,`record`),i=r===`start`?e.backend.startRecording:e.backend.stopRecording;if(!i)throw new n(`UNSUPPORTED_OPERATION`,`record ${r} is not supported by this backend`);let a=t.out?await j(e,t.out,{field:`path`,ext:`.mp4`,artifactType:`screen-recording`}):void 0;try{let n=Zl(t,a?.path);return tu(r,await i.call(e.backend,N(e,t),n),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}},Xl=async(e,t)=>{let r=eu(t.action,`trace`),i=r===`start`?e.backend.startTrace:e.backend.stopTrace;if(!i)throw new n(`UNSUPPORTED_OPERATION`,`trace ${r} is not supported by this backend`);let a=t.out?await j(e,t.out,{field:`outPath`,ext:`.trace`,artifactType:`trace-log`}):void 0;try{let n=a?.path?{outPath:a.path}:{};return nu(r,await i.call(e.backend,N(e,t),n),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}};function Zl(e,t){let n={};t&&(n.outPath=t);let r=Ql(e.fps);r!==void 0&&(n.fps=r);let i=$l(e.quality);return i!==void 0&&(n.quality=i),e.hideTouches!==void 0&&(n.showTouches=e.hideTouches!==!0),n}function Ql(e){return e===void 0?void 0:D(e,`fps`,1,60)}function $l(e){if(e===void 0)return;let t=Ae(e);if(t===void 0)throw new n(`INVALID_ARGS`,`quality must be one of: medium, high (legacy numeric values 5-10 are accepted)`);return t}function eu(e,t){if(e===`start`||e===`stop`)return e;throw new n(`INVALID_ARGS`,`${t} action must be start or stop`)}function tu(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}:{},...ru(e,t,n,{startKind:`recordingStarted`,stopKind:`recordingStopped`,startMessage:`Recording started`,stopMessage:`Recording stopped`})}}function nu(e,t,n){return{...typeof t.outPath==`string`?{outPath:t.outPath}:{},...ru(e,t,n,{startKind:`traceStarted`,stopKind:`traceStopped`,startMessage:`Trace started`,stopMessage:`Trace stopped`})}}function ru(e,t,n,r){return{kind:e===`start`?r.startKind:r.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...C(e===`start`?r.startMessage:r.stopMessage)}}const iu={record:Yl,trace:Xl},au=async(e,t={})=>{if(!e.backend.pressBack)throw new n(`UNSUPPORTED_OPERATION`,`system.back is not supported by this backend`);let r=t.mode??`in-app`;if(r!==`in-app`&&r!==`system`)throw new n(`INVALID_ARGS`,`system.back mode must be in-app or system`);let i=k(await e.backend.pressBack(N(e,t),{mode:r}));return{kind:`systemBack`,mode:r,...i?{backendResult:i}:{},...C(`Back`)}},ou=async(e,t={})=>{if(!e.backend.pressHome)throw new n(`UNSUPPORTED_OPERATION`,`system.home is not supported by this backend`);let r=k(await e.backend.pressHome(N(e,t)));return{kind:`systemHome`,...r?{backendResult:r}:{},...C(`Home`)}},su=async(e,t)=>{if(!e.backend.pressTvRemote)throw new n(`UNSUPPORTED_OPERATION`,`system.tvRemote is not supported by this backend`);let r=Xe(t.button),i=t.durationMs===void 0?void 0:D(t.durationMs,`durationMs`,0,1e4),a=k(await e.backend.pressTvRemote(N(e,t),{button:r,...i===void 0?{}:{durationMs:i}}));return{kind:`tvRemotePressed`,button:r,...i===void 0?{}:{durationMs:i},...a?{backendResult:a}:{},...C(`Pressed TV remote ${r}`)}},cu=async(e,t)=>{if(!e.backend.setOrientation)throw new n(`UNSUPPORTED_OPERATION`,`system.orientation is not supported by this backend`);let r=mu(t.orientation),i=k(await e.backend.setOrientation(N(e,t),r));return{kind:`systemOrientationSet`,orientation:r,...i?{backendResult:i}:{},...C(`Rotated to ${r}`)}},lu=async(e,t={})=>{if(!e.backend.setKeyboard)throw new n(`UNSUPPORTED_OPERATION`,`system.keyboard is not supported by this backend`);let r=t.action??`status`;if(!it(r))throw new n(`INVALID_ARGS`,`system.keyboard action must be status, get, dismiss, enter, or return`);let i=await e.backend.setKeyboard(N(e,t),{action:r}),a=k(i),o=Cu(i)?i:{};return r===`enter`||r===`return`?gu(o,a):r===`dismiss`?_u(r,o,a):yu(r,o,a)},uu=async(e,t)=>{if(t.action===`read`){if(!e.backend.getClipboard)throw new n(`UNSUPPORTED_OPERATION`,`system.clipboard read is not supported by this backend`);let r=await e.backend.getClipboard(N(e,t));return{kind:`clipboardText`,action:`read`,text:typeof r==`string`?r:r.text}}if(t.action!==`write`)throw new n(`INVALID_ARGS`,`system.clipboard action must be read or write`);if(!e.backend.setClipboard)throw new n(`UNSUPPORTED_OPERATION`,`system.clipboard write is not supported by this backend`);if(typeof t.text!=`string`)throw new n(`INVALID_ARGS`,`system.clipboard write requires text`);let r=k(await e.backend.setClipboard(N(e,t),t.text));return{kind:`clipboardUpdated`,action:`write`,textLength:Array.from(t.text).length,...r?{backendResult:r}:{},...C(`Clipboard updated`)}},du=async(e,t={})=>{if(!e.backend.openSettings)throw new n(`UNSUPPORTED_OPERATION`,`system.settings is not supported by this backend`);let r=Y(t.target,`target`),i=k(await e.backend.openSettings(N(e,t),r));return{kind:`settingsOpened`,...r?{target:r}:{},...i?{backendResult:i}:{},...C(r?`Opened settings: ${r}`:`Opened settings`)}},fu=async(e,t={})=>{if(!e.backend.handleAlert)throw new n(`UNSUPPORTED_OPERATION`,`system.alert is not supported by this backend`);let r=t.action??`get`;if(r!==`get`&&r!==`accept`&&r!==`dismiss`&&r!==`wait`)throw new n(`INVALID_ARGS`,`system.alert action must be get, accept, dismiss, or wait`);let i=t.timeoutMs===void 0?void 0:D(t.timeoutMs,`timeoutMs`,0,12e4);return hu(r,await e.backend.handleAlert(N(e,t),r,{timeoutMs:i}))},pu=async(e,t={})=>{if(!e.backend.openAppSwitcher)throw new n(`UNSUPPORTED_OPERATION`,`system.appSwitcher is not supported by this backend`);let r=k(await e.backend.openAppSwitcher(N(e,t)));return{kind:`appSwitcherOpened`,...r?{backendResult:r}:{},...C(`Opened app switcher`)}};function mu(e){switch(e){case`portrait`:case`portrait-upside-down`:case`landscape-left`:case`landscape-right`:return e;default:throw new n(`INVALID_ARGS`,`system.orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right`)}}function hu(e,t){return e===`get`?bu(t):e===`wait`?xu(t):Su(e,t)}function gu(e,t){return{kind:`keyboardEnterPressed`,action:`enter`,state:e,...t?{backendResult:t}:{},...C(`Keyboard enter pressed`)}}function _u(e,t,n){return{kind:`keyboardDismissed`,action:e,state:t,...n?{backendResult:n}:{},...C(vu(t))}}function vu(e){return e.dismissed===!1?`Keyboard already hidden`:e.mechanism===`dismissKey`?`Keyboard dismissed via its dismiss key`:`Keyboard dismissed`}function yu(e,t,n){return{kind:`keyboardState`,action:e,state:t,...n?{backendResult:n}:{}}}function bu(e){if(e.kind!==`alertStatus`)throw new n(`COMMAND_FAILED`,`system.alert get returned an invalid backend result`);return{kind:`alertStatus`,action:`get`,alert:e.alert}}function xu(e){if(e.kind!==`alertWait`)throw new n(`COMMAND_FAILED`,`system.alert wait returned an invalid backend result`);return{kind:`alertWait`,action:`wait`,alert:e.alert,...e.waitedMs===void 0?{}:{waitedMs:e.waitedMs},...e.timedOut===void 0?{}:{timedOut:e.timedOut},...C(e.alert?`Alert visible`:`Alert wait timed out`)}}function Su(e,t){if(t.kind!==`alertHandled`)throw new n(`COMMAND_FAILED`,`system.alert ${e} returned an invalid backend result`);return{kind:`alertHandled`,action:e,handled:t.handled,...t.alert?{alert:t.alert}:{},...t.button?{button:t.button}:{},...C(t.handled?`Alert ${e}ed`:`No alert handled`)}}function Cu(e){return!!(e&&typeof e==`object`)}const wu={back:au,home:ou,orientation:cu,keyboard:lu,clipboard:uu,settings:du,alert:fu,appSwitcher:pu,tvRemote:su};function Tu(e){return{capture:O(Si,e),selectors:Lc(e),interactions:Rc(e),system:O(wu,e),apps:_l(e),admin:O(gl,e),recording:O(iu,e),observability:O(Jl,e)}}var Eu=e({createAgentDevice:()=>Du,createMemorySessionStore:()=>Ou,localCommandPolicy:()=>ju,restrictedCommandPolicy:()=>Mu});function Du(e){let t={backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??Ou(),policy:e.policy??Mu(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal};return{...t,...Tu(t)}}function Ou(e=[]){let t=new Map(e.map(e=>[e.name,ku(e)]));return{get:e=>ku(t.get(e)),set:e=>{t.set(e.name,ku(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>ku(e))}}function ku(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:Au(e.metadata)}:{}}}function Au(e){try{return structuredClone(e)}catch{return{...e}}}function ju(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,...e}}function Mu(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,...e}}export{Ct as C,vt as E,pn as S,gt as T,qr as _,Ba as a,D as b,R as c,L as d,$i as f,F as g,Ei as h,za as i,ua as l,zi as m,ju as n,V as o,Vi as p,Eu as r,wa as s,Du as t,Qi as u,Br as v,_t as w,mn as x,vn as y};
+import{A as e,C as t,S as n,f as r,g as i,m as a,p as o,w as s}from"./sdk-contracts.js";import{p as c}from"./capture.js";import{r as l,t as u}from"./snapshot-capture-annotations.js";import{f as d,l as f,n as p}from"./android-input-ownership.js";import{Ar as m,Bn as h,Cn as g,Dr as _,En as v,Er as y,Fn as ee,Fr as te,Hn as ne,Hr as re,In as ie,Kn as ae,Ln as oe,Mr as b,Nn as se,Or as ce,Pn as le,Pr as ue,Rr as de,Sr as x,Un as S,Vn as fe,Wn as pe,_n as me,_r as he,bn as ge,dr as _e,gn as C,ir as ve,kn as ye,kr as be,lr as xe,on as Se,ur as Ce,vn as we,wn as Te,xn as Ee}from"./sdk-batch.js";import{n as De}from"./snapshot-scope.js";import{n as w}from"./success-text.js";import{a as Oe,d as ke,f as Ae,i as je,l as Me,n as Ne,o as Pe,p as Fe,r as Ie,t as Le,u as Re}from"./absence-observation-errors.js";import{n as ze,t as Be}from"./mobile-snapshot-semantics.js";import{a as Ve,n as He,o as Ue,t as We}from"./react-native-overlay.js";import{i as T,n as E,t as Ge}from"./rect-center.js";import{a as Ke,n as qe,t as Je}from"./gesture-plan.js";import{n as Ye,o as Xe,r as Ze}from"./android-system-chrome.js";import{a as Qe,l as $e,m as et,n as tt,p as D,r as nt,s as rt,u as it}from"./quality-warnings.js";import{r as at}from"./ios-system-surface.js";import{n as ot}from"./png.js";import{n as st}from"./ios-snapshot-acquisition.js";import ct from"node:path";import{promises as O}from"node:fs";import{createHash as lt}from"node:crypto";function ut(e){let t=new Map;for(let n of e)t.set(n.index,n);return t}function dt(e,t,n){let r=[],i=new Set([e.index]),a=e;for(;r.length<n;){if(typeof a.parentIndex!=`number`)return{chain:r,broken:!1};let e=t.get(a.parentIndex);if(!e||i.has(e.index))return{chain:r,broken:!0};i.add(e.index);let n=S(e);r.push({role:n.role,...n.label===void 0?{}:{label:n.label}}),a=e}return{chain:r,broken:!1}}function ft(e,t,n,r){return e.filter(e=>{if(!ne(S(e),n))return!1;let i=dt(e,t,Math.max(r.length,1));return!i.broken&&fe(i.chain,r)})}const pt=/\b(logbox|redbox|reload js|copy stack|component stack|call stack|runtime error|open debugger to view warnings)\b/,mt=[/\b[\w.$<>/-]+\.(?:tsx?|jsx?):\d+(?::\d+)?\b/,/\b[\w.$<>/-]+\.(?:tsx?|jsx?)\s+\(\d+:\d+\)/],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=vt(e),n=t.detected?yt(t):null;return{detected:t.detected,dismissNodes:t.dismissNodes,minimizeNodes:t.minimizeNodes,collapsedNodes:t.collapsedNodes,primaryAction:n}}function vt(e){let t=e.map(bt).join(`
+`).toLowerCase(),n=k(e,Dt),r=k(e,Ue),i=k(e,He,jt),a=k(e,Et),o=St(t),s=Ct(t);return{dismissNodes:n,minimizeNodes:r,collapsedNodes:i,detected:Tt({text:t,hasReactNativeStackFrame:o,hasOverlayControl:wt(t,n,r),hasControllessRedBoxText:s,collapsedNodes:i,openDebuggerWarningNodes:a})}}function yt(e){let t=Nt(e.dismissNodes);if(t)return It(t,Lt(t));let n=Rt(e.collapsedNodes.filter(Mt));return n?.rect?{action:`close-collapsed-banner`,point:Ut(n),rect:n.rect,ref:n.ref,label:A(n)}:null}function bt(e){return[e.label,e.value,e.identifier,e.type,e.role].filter(Boolean).join(` `)}function xt(e){return pt.test(e)}function St(e){return mt.some(t=>t.test(e))}function Ct(e){return/\buncaught\b/.test(e)&&/unable to download asset/.test(e)}function wt(e,t,n){return t.length>0||n.length>0||/\b(reload js|copy stack)\b/.test(e)}function Tt(e){return e.collapsedNodes.length>0||e.openDebuggerWarningNodes.length>0||e.hasControllessRedBoxText||e.hasOverlayControl&&(xt(e.text)||e.hasReactNativeStackFrame)}function Et(e){return e.includes(`open debugger to view warnings`)||/^!,\s+open debugger\b/.test(e)}function Dt(e){return Ve(e)||Ot(e)||kt(e)}function Ot(e){return/^close(?:\s*\([^)]*\))?$/i.test(e)}function kt(e){return ht.has(e)}function At(e){return/^!,\s+/.test(e)}function jt(e){return!e.rect||e.rect.height<=180}function Mt(e){let t=A(e)?.trim().toLowerCase()??``;return(Et(t)||At(t))&&We(e)}function k(e,t,n=()=>!0){let r=[];for(let i of e)i.ref&&n(i)&&[i.label,i.value,i.identifier].map(e=>e?.trim().toLowerCase()).filter(e=>!!e).some(e=>t(e))&&r.push(i);return r}function Nt(e){return zt(e,Ft)}function Pt(e){let t=[e.type,e.role,e.subrole].join(` `).toLowerCase();return/\b(button|menuitem|link)\b/.test(t)}function Ft(e){return[Vt(Pt(e)),Vt(e.hittable),-(e.rect?re(e.rect):1/0)]}function It(e,t){if(!e.rect)throw Error(`React Native overlay target node must have rect`);return{action:t,point:o(e.rect),rect:e.rect,ref:e.ref,label:A(e)}}function Lt(e){let t=A(e)?.trim().toLowerCase();return t&&Ve(t)?`dismiss`:`close`}function Rt(e){return zt(e,Bt)}function zt(e,t){let n=e.filter(e=>e.rect);return n.length===0?null:n.sort((e,n)=>Ht(t(n),t(e)))[0]??null}function Bt(e){return[Vt(e.hittable),e.rect?.width??0,e.rect?.y??0]}function Vt(e){return+(e===!0)}function Ht(e,t){for(let n=0;n<e.length;n+=1){let r=e[n]-t[n];if(r!==0)return r}return 0}function Ut(e){if(!e.rect)throw Error(`Collapsed React Native warning node must have rect`);let t=Math.min(e.rect.height,52),n=Math.min(36,Math.max(18,t*.45));return{x:Math.round(Wt(e.rect.x+e.rect.width-n,e.rect.x+1,e.rect.x+e.rect.width-1)),y:Math.round(e.rect.y+t/2)}}function Wt(e,t,n){return Math.min(n,Math.max(t,e))}function A(e){return e.label??e.value??e.identifier}const Gt=new Set([`textfield`,`securetextfield`,`textview`,`textarea`,`searchfield`,`edittext`]),Kt={strippedIndexes:new Set,refs:new Set};function qt(e){let t=new Set(e.filter(e=>b(e.type??``)===`keyboard`).map(e=>e.index));if(t.size===0)return Kt;let n=new Map(e.map(e=>[e.index,e])),r=Qt(e,n,t),i=new Set(r),a=sn(e,n,r);for(let t of Qt(e,n,a))i.add(t);for(let o of Jt(e,n,a,t,r))i.delete(o);let o=new Set(e.filter(e=>e.ref&&i.has(e.index)).map(e=>e.ref));return{strippedIndexes:new Set([...i].filter(e=>!t.has(e))),refs:o}}function Jt(e,t,n,r,i){let a=new Set;if(n.size===0)return a;let o=Xt(t,n,r);if(o.size===0)return a;let s=Zt(t,r);for(let n of e)!i.has(n.index)&&!s.has(n.index)&&n.rect&&Yt(n,t,o)&&a.add(n.index);return a}function Yt(e,t,n){if(!e.rect)return!1;let r=cn(e,t);if(r===void 0)return!1;let i=n.get(r);return i!==void 0&&e.rect.y+e.rect.height/2<i}function Xt(e,t,n){let r=new Map;for(let i of n){let n=e.get(i);if(!n?.rect)continue;let a=cn(n,e);if(a===void 0||!t.has(a))continue;let o=r.get(a);(o===void 0||n.rect.y<o)&&r.set(a,n.rect.y)}return r}function Zt(e,t){let n=new Set;for(let r of t){let t=e.get(r),i=t&&typeof t.parentIndex==`number`?e.get(t.parentIndex):void 0;for(;i;)n.add(i.index),i=typeof i.parentIndex==`number`?e.get(i.parentIndex):void 0}return n}function Qt(e,t,n){let r=new Set(n);if(n.size===0)return r;for(let i of e)ln(i,t,n)&&r.add(i.index);return r}function $t(e,t){if(e.bundleId!==`com.android.systemui`)return!1;if(Ye(e))return!0;let n=new Set,r=e;for(;r?.bundleId===`com.android.systemui`&&!n.has(r.index);){if(Ze(r.identifier))return!0;n.add(r.index),r=r.parentIndex===void 0?void 0:t.get(r.parentIndex)}return!1}function en(e,t){let n=new Map(e.map(e=>[e.index,e])),r=new Set(e.filter(p).map(e=>e.index)),i=new Set([...r].filter(e=>{let t=n.get(e)?.parentIndex,i=t===void 0?void 0:n.get(t);return!i||!r.has(i.index)})),a=t===`com.android.systemui`?new Set:tn(e,n,r),o=new Set([...r].filter(e=>!i.has(e)));for(let e of a)o.add(e);let s=new Set(e.filter(e=>e.ref&&(r.has(e.index)||a.has(e.index))).map(e=>e.ref));return o.size===0&&s.size===0?Kt:{strippedIndexes:o,refs:s}}function tn(e,t,n){return new Set(e.filter(e=>!n.has(e.index)&&$t(e,t)).map(e=>e.index))}function nn(e,t){let n=qt(e),r=en(e,t);return n.strippedIndexes.size===0&&n.refs.size===0?r:r.strippedIndexes.size===0&&r.refs.size===0?n:{strippedIndexes:new Set([...n.strippedIndexes,...r.strippedIndexes]),refs:new Set([...n.refs,...r.refs])}}function rn(e,t){let{strippedIndexes:n}=nn(e,t);return n.size===0?e:e.filter(e=>!n.has(e.index))}function an(e,t){return nn(e,t).refs}function on(e){return qt(e).refs}function sn(e,t,n){let r=new Set;for(let e of n){let n=t.get(e);if(!n||b(n.type??``)!==`keyboard`)continue;let i=cn(n,t);i!==void 0&&r.add(i)}for(let i of r){let a=new Set([i]);e.some(e=>Gt.has(b(e.type??``))&&!n.has(e.index)&&ln(e,t,a))&&r.delete(i)}return r}function cn(e,t){let n=typeof e.parentIndex==`number`?t.get(e.parentIndex):void 0;for(;n;){if(b(n.type??``)===`window`)return n.index;n=typeof n.parentIndex==`number`?t.get(n.parentIndex):void 0}}function ln(e,t,n){let r=typeof e.parentIndex==`number`?t.get(e.parentIndex):void 0;for(;r;){if(n.has(r.index))return!0;r=typeof r.parentIndex==`number`?t.get(r.parentIndex):void 0}return!1}function un(e,n,r,i){if(!Number.isFinite(e)||!Number.isInteger(e)||e<r||e>i)throw new t(`INVALID_ARGS`,`${n} must be an integer between ${r} and ${i}`);return e}function dn(e,n,r){let i=Number(e[0]),a=Number(e[1]);if(Number.isNaN(i)||Number.isNaN(a))throw new t(`INVALID_ARGS`,n,r);return{x:i,y:a}}function fn(e){return{backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??pn(),policy:e.policy??gn(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal}}function pn(e=[]){let t=new Map(e.map(e=>[e.name,j(e)]));return{get:e=>j(t.get(e)),set:e=>{t.set(e.name,j(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>j(e))}}function j(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:mn(e.metadata)}:{}}}function mn(e){try{return structuredClone(e)}catch{return{...e}}}function hn(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,...e}}function gn(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,...e}}const _n={defaultTimeoutMs:1e4,intervalMs:300},M={promotedTarget:{resolution:C.act,occlusion:`exclude-and-refuse`,offscreen:`refuse`,promotion:`hittable-ancestor`,poll:`none`},resolvedTarget:{resolution:C.act,occlusion:`exclude-and-refuse`,offscreen:`refuse`,promotion:`none`,poll:`none`},coveredDiagnosis:{resolution:C.actCoveredDiagnosis,occlusion:`refuse`,offscreen:`ignore`,promotion:`none`,poll:`none`},readText:{resolution:C.readText,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},readUnique:{resolution:C.readUnique,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},readAny:{resolution:C.readAny,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},findWait:{resolution:C.readAny,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:_n},wait:{resolution:C.wait,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:_n},readList:{resolution:C.readList,occlusion:`ignore`},findAct:{resolution:C.findAct,occlusion:`refuse`,offscreen:`ignore`,promotion:`hittable-ancestor-below-root`,poll:`none`},cropTarget:{resolution:C.cropTarget,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`}},vn=new WeakMap;function yn(e,t){xn(e)&&vn.set(e,t)}function bn(e){return xn(e)?vn.get(e):void 0}function xn(e){return typeof e==`object`&&!!e||typeof e==`function`}function N(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function P(e){return e.clock?.now()??Date.now()}async function Sn(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}function Cn(e,t){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,e=>n(t,e)]))}function F(e){return e&&typeof e==`object`?e:void 0}function wn(e,t,n,r){let i=n.ambiguity;if(i===`first-match`||i===`reject-candidates`){let a=Ee(e,t,{...r,requireRect:n.requireRect});return!a||a.matchedNodes.length===0?{kind:`none`}:i===`first-match`?En(a):a.matchedNodes.length>1?Tn(a):En(a)}let a=g(e,t,{...r,...me({ambiguity:i,requireRect:n.requireRect})});return a.firstMatch?a.resolution?{kind:`resolved`,resolution:a.resolution,matchedNodes:a.firstMatch.matchedNodes}:Tn(a.firstMatch):{kind:`none`}}function Tn(e){return{kind:`ambiguous`,selector:e.selector.raw,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}function En(e){let t=e.matchedNodes[0];return t?{kind:`resolved`,matchedNodes:e.matchedNodes,resolution:{node:t,selector:e.selector,selectorIndex:e.selectorIndex,matches:e.matchedNodes.length,diagnostics:[{selector:e.selector.raw,matches:e.matchedNodes.length}]}}:{kind:`none`}}function Dn(e,t,n){let r=Ee(e,he(t),n);return r?{...r,selector:r.selector.raw}:null}function On(e,t,n,r){let i=wn(e,he(t),n,r);return i.kind===`resolved`?{...i,resolution:{...i.resolution,selector:i.resolution.selector.raw}}:i}function kn(e){return e}function An(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height);return i<=n||a<=r?0:(i-n)*(a-r)}const jn=[`button`,`link`,`menuitem`,`tabitem`,`textfield`,`searchfield`,`securetextfield`,`checkbox`,`radio`,`switch`,`cell`];function I(e){return[e.type,e.role,e.subrole].map(e=>b(e??``)).some(e=>e===`tab`||jn.some(t=>e.includes(t)))}function Mn(e,t){let n=t[0];if(!n)return{kind:`ambiguous`,candidates:t};let r=Yn(e);if(!Nn(t,r.nodesByIndex))return{kind:`ambiguous`,candidates:t};let i=Vn(e,n,r).node;for(let n of t.slice(1))if(Vn(e,n,r).node.index!==i.index){let e=In(t,r);return e?{kind:`equivalent`,node:e}:{kind:`ambiguous`,candidates:t}}return{kind:`equivalent`,node:i}}function Nn(e,t){for(let n=0;n<e.length;n+=1)for(let r=n+1;r<e.length;r+=1){let i=e[n],a=e[r];if(!Pn(i,a,t)&&!Pn(a,i,t))return!1}return!0}function Pn(e,t,n){let r=t,i=new Set;for(;r.parentIndex!==void 0&&!i.has(r.index);){if(i.add(r.index),r.parentIndex===e.index)return!0;let t=n.get(r.parentIndex);if(!t)return!1;r=t}return!1}function Fn(e,t){return In(t,Yn(e))}function In(e,t){if(e.length<2||!Nn(e,t.nodesByIndex)||e.some(e=>e.hittable!==void 0))return null;let n=e.reduce((e,t)=>(t.depth??0)>(e.depth??0)?t:e);if(!I(n)||!e.every(e=>e===n||!I(e)))return null;let r=E(n.rect);return r&&e.every(e=>Ln(E(e.rect),r))?n:null}function Ln(e,t){return e?Math.abs(e.x-t.x)<=1&&Math.abs(e.y-t.y)<=1&&Math.abs(e.width-t.width)<=1&&Math.abs(e.height-t.height)<=1:!1}function Rn(e,t){if(!t?.rect||!e.rect||!y(e))return!1;let n=e.rect,r=t.rect;return n.x===r.x&&n.y===r.y&&n.width===r.width&&n.height===r.height}function zn(e,t){return Vn(e,t)}function Bn(e){let t=Yn(e);return n=>Vn(e,n,t)}function Vn(e,t,n){return f(t)?{node:t,reason:`covered`}:Hn(e,t,n)??Un(t)??Wn(e,t,n)??{node:t,reason:`original`}}function Hn(e,t,n){let r=Kn(e,t,n);return r?.rect&&T(r.rect)?{node:r,reason:`same-rect-descendant`}:null}function Un(e){return I(e)&&e.rect&&T(e.rect)?{node:e,reason:`semantic-target`}:null}function Wn(e,t,n){let r=Gn(e,t,n);return!r?.rect||f(r)||!T(r.rect)?null:qn(t,r,e,n)?{node:t,reason:`overly-broad-ancestor`}:{node:r,reason:`hittable-ancestor`}}function Gn(e,t,n){if(t.hittable)return t;let r=e=>e.hittable===!0;return n?te(e,t,n.nodesByIndex,e=>r(e)?e:null):ue(e,t,r)}function Kn(e,t,n){let r=E(t.rect);if(!r)return null;let i=t,a=new Set;for(;!a.has(i.ref);){a.add(i.ref);let t=(n?n.childrenByParentIndex.get(i.index)??[]:e.filter(e=>e.parentIndex===i.index)).filter(e=>{if(!e.hittable||f(e))return!1;let t=E(e.rect);return t?Ge(t,r):!1});if(t.length!==1)break;i=t[0]}return i===t?null:i}function qn(e,t,n,r){let i=E(e.rect),a=E(t.rect);if(!i||!a)return!1;if(Jn(t)&&!Ge(i,a))return!0;let o=_(n,i,r?.viewportRootRects);return!o||!Xn(a,o)?!1:!Ge(i,a)}function Jn(e){let t=b(e.type??``);return t.includes(`scrollview`)||t.includes(`scrollarea`)||t.includes(`listview`)||t.includes(`recyclerview`)||t.includes(`collectionview`)||t===`list`||t===`table`||t===`collection`}function Yn(e){let t=new Map,n=new Map,r=[];for(let i of e){if(t.set(i.index,i),typeof i.parentIndex==`number`){let e=n.get(i.parentIndex);e?e.push(i):n.set(i.parentIndex,[i])}if(y(i)){let e=E(i.rect);e&&r.push(e)}}return{nodesByIndex:t,childrenByParentIndex:n,viewportRootRects:r}}function Xn(e,t){let n=An(e,t),r=e.width*e.height,i=t.width*t.height;if(n<=0||r<=0||i<=0)return!1;let a=n/i,o=n/r;return a>=.9&&o>=.8}async function L(e,t,n,r,i={}){let a=On(tr(e,t),n,e.resolution,r);if(a.kind===`none`)return{kind:`none`};if(a.kind===`resolved`)return await Qn(e,t,{node:a.resolution.node,selector:a.resolution.selector,selectorIndex:a.resolution.selectorIndex,matches:a.resolution.matches,matchedNodes:a.matchedNodes},i);let o=Zn(t,a);return o?await Qn(e,t,o,i):a}function Zn(e,t){let n=Fn(e,t.matchedNodes);return n?{node:n,selector:t.selector,selectorIndex:t.selectorIndex,matches:t.matchedNodes.length,matchedNodes:t.matchedNodes}:null}async function Qn(e,t,n,r){let i=await er(e,t,n.node,r);return i.kind===`occluded`?{kind:`occluded`,node:i.node,selector:n.selector}:{...n,kind:`target`,node:i.node}}function $n(e,t,n,r){let i=tr(e,t);return{candidates:i,list:Dn(i,n,{...r,requireRect:e.resolution.requireRect})}}async function er(e,t,n,r={}){r.onResolved?.(n,t);let i=nr(e.promotion,t,n);return e.occlusion!==`ignore`&&(i.covered||f(i.node))?{kind:`occluded`,node:i.node}:{kind:`target`,node:await rr(e,t,i.node,r)}}function tr(e,t){return e.occlusion===`exclude-and-refuse`?t.filter(e=>!f(e)):t}function nr(e,t,n){if(e===`none`)return{node:n,covered:!1};let r=zn(t,n);return r.reason===`covered`?{node:r.node,covered:!0}:e===`hittable-ancestor-below-root`&&Rn(r.node,t[0])&&n.rect?{node:n,covered:!1}:{node:r.node,covered:!1}}async function rr(e,t,n,r){if(e.offscreen!==`refuse`)return n;if(!r.offscreen)throw Error(`selector pipeline row declares an off-screen refusal but this route supplies no refusal shape`);return await r.offscreen(n,t)}function ir(e){if(e.poll===`none`)throw Error(`selector pipeline row resolves against one capture and declares no poll budget`);return e.poll}function ar(e){return e.hittable===!0||I(e)}function or(e,t){let n=oe(S(e),t);return n.id!==void 0||n.label!==void 0?!1:ee(e.value)===null}function sr(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`;){if(r.has(i.index))return!1;if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function cr(e,t){let n=ut(t);return t.filter(t=>t.index!==e.index&&sr(t,e,n)).sort((e,t)=>e.index-t.index)}function lr(e,t){let n=T(e.rect);return!n||!t.rect?!1:de(t.rect,n.x,n.y)}function ur(e,t){if(!or(e,t))return e;let n=cr(e,t);if(n.some(ar))return e;let r=n.find(e=>S(e).label!==void 0);return!r||!lr(r,e)?e:r}function dr(e,t){return e.find(e=>De(e,t))??null}function R(e,t){let n=ce(e);return n&&m(n)?n:fr(e,t)}function fr(e,t){if(!e.rect)return;let n=e.rect.y+e.rect.height/2,r=null;for(let e of t){if(!e.rect)continue;let t=ce(e);if(!t||!m(t))continue;let i=e.rect.y+e.rect.height/2,a=Math.abs(i-n);(!r||a<r.distance)&&(r={label:t,distance:a})}return r?.label}function pr(e){return e===`text`||e===`label`||e===`any`}function mr(e,t,n,r){if(!(r||e===`web`))return pr(t)?n:void 0}function hr(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 gr(e,n){let r=n??`default`,i=await e.sessions.get(r);if(!i)throw new t(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let a=i.refFrameSnapshot??i.snapshot;if(!a)throw new t(`INVALID_ARGS`,`No snapshot in session. Run snapshot first.`);return{sessionName:r,session:i,snapshot:a}}async function z(e,n,r={updateSession:!0}){let i=e.backend.captureSnapshot;if(!i)throw new t(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let a=n.session??`default`,o=await e.sessions.get(a),s=_r(await i(N(e,n),{interactiveOnly:r.interactiveOnly??!1,depth:n.depth,scope:r.scope??n.scope,raw:n.raw,includeRects:r.includeRects,...r.preferredBackend?{preferredBackend:r.preferredBackend}:{},...r.includeHiddenContentHints===void 0?{}:{includeHiddenContentHints:r.includeHiddenContentHints}}),e);return(n.signal??e.signal)?.throwIfAborted(),r.updateSession&&o&&!D(s.snapshotQuality)&&await e.sessions.set({...o,snapshot:s}),{sessionName:a,session:o,snapshot:s}}function _r(e,t){return e.snapshot?vr(e.snapshot,e):{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,...e.quality?{snapshotQuality:e.quality}:{},createdAt:P(t)}}function vr(e,t){let n={...e};return t.truncated===!0||n.truncated===!0?n.truncated=!0:t.truncated!==void 0&&(n.truncated=t.truncated),t.quality&&n.snapshotQuality===void 0&&(n.snapshotQuality=t.quality),n}async function yr(e,t,n){if(e.backend.readText){let r=await e.backend.readText(N(e,{session:t.sessionName}),n);if(r.text.trim())return r.text}return Fe(n)}function br(e,n,r){let o=i(n);if(!o)throw new t(`INVALID_ARGS`,r.invalidRefMessage);let s=a(e,o)??(r.fallbackLabel.length>0?dr(e,r.fallbackLabel):null);if(!s)throw new t(`COMMAND_FAILED`,r.notFoundMessage);return{ref:o,node:s}}function xr(e,t){if(Buffer.byteLength(e,`utf8`)<=t)return e;let n=Buffer.byteLength(`…`,`utf8`),r=Math.max(0,t-n),i=Buffer.from(e,`utf8`),a=Math.min(r,i.length);for(;a>0&&(i[a]&192)==128;)--a;return i.subarray(0,a).toString(`utf8`)+`…`}function Sr(e){let t=Buffer.alloc(16);for(let n of e)wr(t,Cr(n));return{digest:`ax1:${lt(`sha256`).update(t).update(`\0`).update(String(e.length)).digest(`hex`).slice(0,16)}`,nodeCount:e.length}}function Cr(e){return lt(`sha256`).update(e.type??``).update(`\0`).update(e.label??``).update(`\0`).update(e.identifier??``).digest().subarray(0,16)}function wr(e,t){for(let n=0;n<e.length;n+=1)e[n]=(e[n]??0)^(t[n]??0)}function Tr(e){let{digest:t,nodeCount:n}=Sr(e),r=e.reduce((e,t)=>t.hittable===!1?e:e+1,0),i=Er(e);return{digest:t,nodeCount:n,interactiveNodeCount:r,...i?{foregroundApp:i}:{}}}function Er(e){for(let t of e)if(t.bundleId)return t.bundleId;for(let t of e)if(t.appName)return t.appName}function B(e){return{nodes:e.nodes,...e.iosSystemSurfaceBundleId?{surfaceBundleId:e.iosSystemSurfaceBundleId}:{}}}function Dr(e,t){if(!(!e||e.surfaceBundleId===t.surfaceBundleId))return{from:e.surfaceBundleId??`app`,to:t.surfaceBundleId??`app`,disclosure:at(t.surfaceBundleId)}}function Or(e,t){let n=Tr(e.nodes),r=Dr(t,e);if(r)return{...n,changedFromBefore:!0,surfaceChange:r};let i=t!==void 0&&n.digest!==Tr(t.nodes).digest;return{...n,changedFromBefore:i}}function kr(e){return`${e.disclosure} The settled tree and the pre-action tree describe different surfaces (${e.from} → ${e.to}), so no settled diff or refs are shown; take a snapshot to read the current surface.`}function Ar(e,t,n={}){let r=E(t.rect),i=T(r??void 0);if(!r||!i)return{kind:`invalid`};let a=jr(e,t,r);if(a.length===0)return{kind:`resolved`,point:i,strategy:`center`};let o=(n.bounds??[]).reduce((e,t)=>e?Nr(e,t):null,r),s=o?Pr(r,o,i,a):null;return s?{kind:`resolved`,point:s,strategy:`parent-owned`}:{kind:`blocked`,competitorRefs:a.map(e=>e.ref)}}function jr(e,t,n){let r=new Map(e.map(e=>[e.index,e]));return e.filter(e=>e.index!==t.index).filter(e=>Mr(e,t,r)).filter(I).flatMap(e=>{let t=E(e.rect);if(!t||Ge(t,n))return[];let r=Nr(t,n);return r&&r.width>0&&r.height>0?[{ref:e.ref,index:e.index,rect:r}]:[]}).sort((e,t)=>e.index-t.index)}function Mr(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`&&!r.has(i.index);){if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function Nr(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height);return i<=n||a<=r?null:{x:n,y:r,width:i-n,height:a-r}}function Pr(e,t,n,r){let i=zr(e),a=Lr(t.x,t.width,n.x,r.flatMap(({rect:e})=>[e.x,e.x+e.width]),i),o=Lr(t.y,t.height,n.y,r.flatMap(({rect:e})=>[e.y,e.y+e.height]),i);return a.flatMap(a=>o.flatMap(o=>{let s={x:Math.round(a),y:Math.round(o)};if(!de(t,s.x,s.y))return[];let c=Fr(s,e,n,r,i);return c?[c]:[]})).sort(Ir)[0]?.point??null}function Fr(e,t,n,r,i){let a=Rr(e,t,r);return a.parentEdge<i||a.competitor<12?null:{point:e,distanceSquared:(e.x-n.x)**2+(e.y-n.y)**2,clearance:Math.min(a.parentEdge,a.competitor)}}function Ir(e,t){return e.distanceSquared-t.distanceSquared||t.clearance-e.clearance||e.point.y-t.point.y||e.point.x-t.point.x}function Lr(e,t,n,r,i){let a=e+i,o=e+t-i;if(a>o)return[];let s=[...new Set([e,e+t,...r])].sort((e,t)=>e-t),c=new Set([n,a,o]);for(let e of r)c.add(e-12),c.add(e+12);for(let e=1;e<s.length;e+=1)c.add((s[e-1]+s[e])/2);return[...c].filter(e=>e>=a&&e<=o).sort((e,t)=>e-t)}function Rr(e,t,n){let r=Math.min(e.x-t.x,t.x+t.width-e.x,e.y-t.y,t.y+t.height-e.y),i=1/0;for(let{rect:t}of n){let n=e.x<t.x?t.x-e.x:Math.max(0,e.x-(t.x+t.width)),r=e.y<t.y?t.y-e.y:Math.max(0,e.y-(t.y+t.height));i=Math.min(i,Math.max(n,r))}return{parentEdge:r,competitor:i}}function zr(e){let t=Math.min(e.width,e.height);return Math.max(0,Math.min(12,Math.floor(t/2)-1))}const V={captureStalled:`wait_capture_stalled`,deadlineExceeded:`wait_deadline_exceeded`,runnerRestartExhausted:`wait_runner_restart_exhausted`,targetAbsent:`wait_target_absent`,targetPresent:`wait_target_present`,stableTimeout:`wait_stable_timeout`,landmarkIdentityMismatch:`wait_landmark_identity_mismatch`},Br=`replay_target_guard_mismatch`,Vr=V.landmarkIdentityMismatch;function Hr(e,n,r,i){let{candidates:a,list:o}=$n(i,e,n,{platform:r}),s=o?.matchedNodes??[];if(!o||s.length===0)return null;let c=[{selector:o.selector,matches:s.length}];if(s.length===1)return{node:s[0],selector:o.selector,selectorIndex:o.selectorIndex,matches:1,diagnostics:c};let l=Mn(a,s);if(l.kind===`ambiguous`)throw new t(`AMBIGUOUS_MATCH`,`Selector matched ${l.candidates.length} distinct actionable elements: ${o.selector}`,{selector:o.selector,matches:l.candidates.length,candidates:l.candidates.slice(0,5).map(e=>Ae(e,0,!1))});return{node:l.node,selector:o.selector,selectorIndex:o.selectorIndex,matches:s.length,diagnostics:c,disambiguation:{matchCount:s.length,tiebreak:`structural-equivalence`,alternatives:s.filter(e=>e.index!==l.node.index)}}}function Ur(e,n,r,i,a){if(!r)return;let o=S(e),s=pe(e,n);if(!(h(o,r.identity)&&ae(s,r.structural)))throw new t(`COMMAND_FAILED`,`${i} resolved to a different element than replay verification isolated; the action was not sent`,{reason:Br,observed:o,observedStructural:s,expected:r.identity,expectedStructural:r.structural,...a?{targetRole:a}:{}})}async function H(e,t,n){return await di(e,t,n.action),t.target.kind===`point`?await Gr(e,t,t.target,n):t.target.kind===`ref`?await Yr(e,t,t.target,n):await Xr(e,t,t.target,n)}async function Wr(e,t,n){let r=t.session??`default`,i=await e.sessions.get(r);if(!i?.snapshot)return;let a={x:n.x,y:n.y,width:0,height:0},o=x(i.snapshot.nodes).resolveViewport(a);if(!o)return;let s={x:n.x,y:n.y};if(!de(o,s.x,s.y))return`Coordinates (${s.x}, ${s.y}) are outside the last-known viewport (${o.width}x${o.height}). The tap will be forwarded anyway; take a fresh snapshot if the screen changed.`}async function Gr(e,t,n,r){let i=await Wr(e,t,n);if(!r.captureEvidenceBaseline)return{kind:`point`,point:{x:n.x,y:n.y},...i?{warning:i}:{}};let a=await Kr(e,t);return{kind:`point`,point:{x:n.x,y:n.y},...a?{preAction:a}:{},...i?{warning:i}:{}}}async function Kr(e,t){try{return B((await U(e,t,!0)).snapshot)}catch{return}}function qr(e,n){let r=i(e.ref);if(!r)throw new t(`INVALID_ARGS`,`Invalid ref: ${e.ref}`);let a=i(n.ref),o=n.node.ref?i(n.node.ref):null;if(a!==r||o!==r||!n.nodes.includes(n.node))throw new t(`COMMAND_FAILED`,`Internal find target provenance does not match the interaction ref`);return{tree:{nodes:n.nodes,...n.iosSystemSurfaceBundleId?{surfaceBundleId:n.iosSystemSurfaceBundleId}:{}},resolved:ti(r,n.node,`exact`)}}async function Jr(e,t,n){let r=await pi(e,t,n);return{tree:B(r.snapshot),resolved:r.resolved}}async function Yr(e,t,n,r){let{tree:a,resolved:o}=r.preresolvedTarget?qr(n,r.preresolvedTarget):await Jr(e,t,n),s=a.nodes,c=await ci({policy:r.pipeline,nodes:s,node:o.node,action:r.action,label:`Ref ${n.ref}`,hooks:{onResolved:(e,t)=>Qr(e,t,r),offscreen:async(i,a)=>await yi(e,t,i,a,n.ref,r)}});return{kind:`ref`,point:gi(c,s,{invalidMessage:`Ref ${n.ref} not found or has invalid bounds`,blockedTargetLabel:`Ref ${n.ref}`,blockedTargetDetails:{ref:`@${i(n.ref)??c.ref}`}}),target:{kind:`ref`,ref:`@${o.ref}`},...ai(e,c,a,r.action,o.resolution)}}async function Xr(e,t,n,r){let i=n.selector,a=await U(e,t,r.requireInteractive),o=Hr(a.snapshot.nodes,i,e.backend.platform,r.pipeline);if((!o||!o.node.rect)&&r.requireInteractive&&(a=await U(e,t,!1),o=Hr(a.snapshot.nodes,i,e.backend.platform,r.pipeline)),!o||!o.node.rect)throw await Zr({runtime:e,nodes:a.snapshot.nodes,selectorExpression:i,action:r.action,resolved:o});let s=o,c=await ci({policy:r.pipeline,nodes:a.snapshot.nodes,node:s.node,action:r.action,label:`Selector ${s.selector}`,hooks:{onResolved:(e,t)=>Qr(e,t,r),offscreen:async(n,i)=>await vi(e,t,n,i,s.selector,r)}});return{kind:`selector`,point:gi(c,a.snapshot.nodes,{invalidMessage:`Selector ${o.selector} resolved to invalid bounds`,blockedTargetLabel:`Selector ${i}`,blockedTargetDetails:{selector:i}}),target:{kind:`selector`,selector:o.selector},...ai(e,c,B(a.snapshot),r.action,ri(o,a.snapshot.nodes))}}async function Zr(e){let{runtime:n,nodes:r,selectorExpression:i,action:a,resolved:o}=e,s=await L(M.coveredDiagnosis,r,i,{platform:n.backend.platform});if(s.kind===`occluded`)return li({label:`Selector ${s.selector}`,node:s.node,action:a,selector:s.selector});let c=o?.diagnostics??[];return new t(`COMMAND_FAILED`,ge(i,c,{unique:!0}),{reason:je.selectorNotFound,hint:Te(c)})}function Qr(e,t,n){Ur(e,t,n.expectedResolvedTarget,n.action,n.replayTargetRole)}const $r={source:`ref`,phase:`pre-action`,kind:`exact`},ei={source:`ref`,phase:`pre-action`,kind:`label-fallback`};function ti(e,t,n){return{ref:e,node:t,resolution:n===`exact`?$r:ei}}const ni={source:`runtime`,phase:`pre-action`,kind:`unique`};function ri(e,t){return e.disambiguation?{source:`runtime`,phase:`pre-action`,kind:`disambiguated`,matchCount:e.disambiguation.matchCount,winnerDiagnostic:ii(e.node,t),tiebreak:e.disambiguation.tiebreak,alternatives:e.disambiguation.alternatives.slice(0,5).map(e=>ii(e,t))}:ni}function ii(e,t){let n=b(e.type??``),r=R(e,t);return{diagnosticRef:`diag-${e.ref}`,...n?{role:xr(n,256)}:{},...r===void 0?{}:{label:xr(r,256)}}}function ai(e,t,n,r,i){let a=n.nodes;return{node:t,selectorChain:le(t,e.backend.platform,{action:r===`fill`?`fill`:`click`,nodes:a}),refLabel:R(t,a),...si(t,r),preAction:n,resolution:i,...oi(e,t,a,r)}}function oi(e,t,n,r){if(r!==`click`&&r!==`press`)return{};let i=ur(t,n);return i===t?{}:{recordingTarget:{node:i,selectorChain:le(i,e.backend.platform,{action:`click`,nodes:n}),refLabel:R(i,n)}}}function si(e,t){return e.hittable===!1?{targetHittable:!1,hint:`The resolved element reports hittable: false, so this ${t} may have had no visible effect. Verify with a snapshot, or prefer a @ref or a longer/more specific selector to target the intended element.`}:{}}async function ci(e){let t=await er(e.policy,e.nodes,e.node,e.hooks);if(t.kind===`occluded`)throw li({label:e.label,node:t.node,action:e.action});return t.node}function li(e){return new t(`COMMAND_FAILED`,`${e.label} is covered by another visible element and cannot ${ui(e.action)} safely`,{hint:`Use a different visible target, scroll it clear of the overlay, or inspect with snapshot/screenshot before retrying.`,...e.selector?{selector:e.selector}:{},ref:`@${e.node.ref}`,interactionBlocked:e.node.interactionBlocked})}function ui(e){switch(e){case`fill`:return`be filled`;case`focus`:return`be focused`;case`longPress`:return`be long-pressed`;case`hover`:return`be hovered`;default:return`be tapped`}}async function U(e,n,r){if(!e.backend.captureSnapshot)throw new t(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let i=n.session??`default`,a=await e.sessions.get(i);if(!a)throw new t(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let o=await e.backend.captureSnapshot(N(e,n),{interactiveOnly:r,includeRects:!0}),s=o.snapshot??{nodes:o.nodes??[],truncated:o.truncated,backend:o.backend,createdAt:P(e)};return await e.sessions.set({...a,snapshot:s}),{snapshot:s}}async function di(e,n,r){if(e.backend.platform!==`macos`)return;let i=await fi(e,n);if((i===`desktop`||i===`menubar`)&&(i!==`menubar`||r!==`click`&&r!==`press`))throw new t(`UNSUPPORTED_OPERATION`,`${r} is not supported on macOS ${i} sessions yet. Open an app session to act, or use the ${i} surface to inspect.`)}async function fi(e,t){return(await e.sessions.get(t.session??`default`))?.metadata?.surface}async function pi(e,n,r){let{session:i,snapshot:a}=await gr(e,n.session),o=r.fallbackLabel??``,s=hi(a.nodes,r.ref,{fallbackLabel:o});if(!s)throw new t(`COMMAND_FAILED`,`Ref ${r.ref} not found or has no bounds`,{hint:we});return mi({session:i,frameTree:a,target:r,fallbackLabel:o,authorized:s})}function mi(e){let{session:t,frameTree:n,target:r,fallbackLabel:i,authorized:a}=e,o=t.snapshot;if(!o||o===n)return{snapshot:n,resolved:a};let s=hi(o.nodes,r.ref,{fallbackLabel:i});return s&&h(S(a.node),S(s.node))?{snapshot:o,resolved:s}:{snapshot:n,resolved:a}}function hi(e,n,r){let o=i(n);if(!o)throw new t(`INVALID_ARGS`,`Invalid ref: ${n}`);let s=a(e,o);if(_i(s))return ti(o,s,`exact`);let c=r.fallbackLabel.length>0?dr(e,r.fallbackLabel):null;return _i(c)?ti(o,c,`label-fallback`):null}function gi(e,n,r){let i=x(n),a=Ar(n,e,{bounds:[i.resolveEffectiveViewport(e),e.rect?i.resolveViewport(e.rect):null].filter(e=>e!==null)});if(a.kind===`resolved`)return a.point;throw a.kind===`invalid`?new t(`COMMAND_FAILED`,r.invalidMessage):new t(`COMMAND_FAILED`,`${r.blockedTargetLabel} has no parent-owned touch point outside its interactive descendants`,{reason:`covered_by_interactive_descendants`,...r.blockedTargetDetails,competitorRefs:a.competitorRefs.slice(0,5).map(e=>`@${e}`),competitorCount:a.competitorRefs.length,hint:`Tap the specific interactive child you intend, or use a more specific selector. Every safely tappable region of the parent belongs to one of its child controls.`})}function _i(e){return e?T(e.rect)!==null:!1}async function vi(e,t,n,r,i,{action:a}){return await Ci(e,t,n,r,{message:`Selector ${i} resolved to an off-screen element and is not safe to ${a}`,details:{reason:`offscreen_selector`,selector:i},hint:e=>`${bi(e,i)} then retry ${a} with the same selector. --until checks the selector between passes, so it stops on the target rather than sailing past it. If it is inside a closed drawer or another tab, open that container first.`})}async function yi(e,t,n,r,a,{action:o}){return await Ci(e,t,n,r,{message:`Ref ${a} is off-screen and not safe to ${o}`,details:{reason:`offscreen_ref`,ref:i(a)},hint:e=>`${bi(e,null)} then retry ${o} with a selector (e.g. text=/id=) rather than this @ref — the scroll expires the ref frame, so re-run snapshot -i before reusing any @ref.`})}function bi(e,t){return e?t?`Run scroll ${e} --until '${t}' to bring it on screen,`:`Scroll ${e} toward it,`:`Scroll toward it,`}async function xi(e,t,n,r){let a=(await e.sessions.get(t.session??`default`))?.snapshot,o=a?.nodes;if(!a||!o||i(n.ref)===null)return{};let s=hi(o,n.ref,{fallbackLabel:n.fallbackLabel??``});if(!s)return{};let c=M.resolvedTarget,l=await ci({policy:c,nodes:o,node:s.node,action:r,label:`Ref ${n.ref}`,hooks:{offscreen:async(i,a)=>await yi(e,t,i,a,n.ref,{action:r,pipeline:c})}});return{...si(l,r),node:l,preAction:B(a)}}async function Si(e,t,n,r,i){let a=await xi(e,t,n,r),o=F(await i(N(e,t),{kind:`ref`,ref:n.ref,...n.fallbackLabel?{fallbackLabel:n.fallbackLabel}:{}}));return{kind:`ref`,target:{kind:`ref`,ref:n.ref},resolution:$r,...a,...o?{backendResult:o}:{}}}async function Ci(e,n,r,i,a){let o=x(i),s=r.rect?o.resolveEffectiveViewport(r):null;if(!r.rect||!s||o.isVisibleOnScreen(r))return r;let c=o.resolveViewport(r.rect),l=await e.backend.confirmOffscreenTargetVisible?.(N(e,n),r,c);if(l)return{...r,rect:l};let u=ze(r,o);throw new t(`COMMAND_FAILED`,a.message,{...a.details,rect:r.rect,viewport:s,...u?{scrollDirection:u}:{},hint:a.hint(u)})}function wi(e,t){let n=ke(e.type??`Element`),r=Re(e,n),i=e.enabled===!1?`disabled`:`enabled`,a=e.selected===!0?`selected`:`unselected`,o=e.hittable===!0?`hittable`:`not-hittable`;return[String(t??e.depth??0),n,r,i,a,o,e.actions?JSON.stringify(e.actions):``].join(`|`)}function Ti(e,t,n={}){let r=Oi(Di(e,n),Di(t,n)),i={additions:0,removals:0,unchanged:0};for(let e of r)e.kind===`added`&&(i.additions+=1),e.kind===`removed`&&(i.removals+=1),e.kind===`unchanged`&&(i.unchanged+=1);return{summary:i,lines:r}}function Ei(e,t={}){return Di(e,t).length}function Di(e,t){return t.flatten?e.map(e=>({text:Ae(e,0,!1),comparable:wi(e,0),...t.withRefs&&e.ref?{ref:e.ref}:{}})):Me(e).map(e=>({text:e.text,comparable:wi(e.node,e.depth),...t.withRefs&&e.node.ref?{ref:e.node.ref}:{}}))}function Oi(e,t){let n=e.length,r=t.length,i=n+r,a=new Map,o=[];a.set(1,0);for(let s=0;s<=i;s+=1){o.push(new Map(a));for(let i=-s;i<=s;i+=2){let c=Ai(a,i,s)?W(a,i+1):W(a,i-1)+1,l=c-i;for(;c<n&&l<r&&e[c].comparable===t[l].comparable;)c+=1,l+=1;if(a.set(i,c),c>=n&&l>=r)return ki(o,e,t,n,r)}}return[]}function ki(e,t,n,r,i){let a=[],o=r,s=i;for(let r=e.length-1;r>=0;--r){let i=e[r],c=o-s,l=Ai(i,c,r)?c+1:c-1,u=W(i,l),d=u-l;for(;o>u&&s>d;)a.push({kind:`unchanged`,text:n[s-1].text}),--o,--s;if(r===0)break;if(o===u){let e=n[d];a.push({kind:`added`,text:e.text,...e.ref?{ref:e.ref}:{}}),s=d}else a.push({kind:`removed`,text:t[u].text}),o=u}return a.reverse(),a}function Ai(e,t,n){return t===-n||t!==n&&W(e,t-1)<W(e,t+1)}function W(e,t){return e.get(t)??0}async function ji(e,t,n,r){let i=new AbortController,a=[t.signal,e.signal].filter(e=>e!==void 0),o=AbortSignal.any([...a,i.signal]),s=!1,c=setTimeout(()=>{s=!0,i.abort(new DOMException(`Wait deadline exceeded`,`TimeoutError`))},Math.max(0,n));c.unref();try{let e=await r(o);return s&&!a.some(e=>e.aborted)?{timedOut:!0}:(o.throwIfAborted(),{timedOut:!1,value:e})}catch(e){if(s&&!a.some(e=>e.aborted))return{timedOut:!0,error:e};throw e}finally{clearTimeout(c)}}function Mi(e){let t=e.snapshotQuality?.backend,n=(e.backend===`xctest`?Ni(e.nodes):e.nodes).map(Ii);return n.sort((e,t)=>Ri(e).localeCompare(Ri(t))),{captureBackend:t,nodes:n}}function Ni(e){let t=x(e);return e.filter(e=>y(e)||t.isVisibleOnScreen(e))}function Pi(e,t){return!e||e.captureBackend!==t.captureBackend||e.nodes.length!==t.nodes.length?!1:e.nodes.every((e,n)=>{let r=t.nodes[n];if(!r||e.identity!==r.identity)return!1;if(!e.rect||!r.rect)return e.rect===r.rect;let i=e.rect,a=r.rect;return[`x`,`y`,`width`,`height`].every(e=>Math.abs(Math.round(i[e])-Math.round(a[e]))<=1)})}function Fi(e,t){if(!e||e.nodes.length===0||t.nodes.length===0)return!1;let n=new Map;for(let t of e.nodes)n.set(t.identity,(n.get(t.identity)??0)+1);let r=0;for(let e of t.nodes){let t=n.get(e.identity)??0;t!==0&&(r+=1,n.set(e.identity,t-1))}return r/Math.max(e.nodes.length,t.nodes.length)<.5}function Ii(e){return{identity:`${e.type??``}#${Li(e)}`,...e.rect?{rect:{...e.rect}}:{}}}function Li(e){return[e.label,e.identifier,e.value].map(e=>String(e??``).trim()).join(`#`)}function Ri(e){let t=e.rect;return`${e.identity}#${t?`${t.x},${t.y},${t.width},${t.height}`:``}`}const zi=`Settled on a nearly-empty tree — the app may still be loading. Wait for specific content (wait text ...) before interacting.`;async function Bi(e,t,n){let{quietMs:r,timeoutMs:i}=n,a=P(e),o=a+i,s=!1,c=await e.sessions.get(t.session??`default`),l,u=et(c?.snapshot?.snapshotQuality),d=Math.min(300,Math.max(25,r)),f=0,p,m=0,h,g=a,_=r;for(;P(e)<o;){let c=await qi(e,t,o-P(e),u);if(!c)return{settled:!1,stalled:!0,waitedMs:P(e)-a,captures:f,nodeCount:m,lastCapture:h};f+=1,h=c,l??=Vi(n.broadTransitionBaselineNodes,c.snapshot,e.backend.platform);let v=Mi(c.snapshot);_=Ui({baseline:l,signal:v,requestedQuietMs:r,currentQuietMs:_}),u??=et(c.snapshot.snapshotQuality);let y=P(e),ee=Gi({resetRequested:n.resetBudgetOnPrivateAxRecovery,alreadyReset:s,verdict:c.snapshot.snapshotQuality,nowMs:y,timeoutMs:i,deadlineMs:o});if(ee!==void 0){s=!0,o=ee,g=y,p=v,m=c.snapshot.nodes.length;let t=Ki({nowMs:y,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(t<=0)break;await Sn(e,t);continue}if(!Pi(p,v))p=v,m=c.snapshot.nodes.length,g=y;else if(f>=2&&y-g>=_)return{settled:!0,stalled:!1,waitedMs:y-a,captures:f,nodeCount:m,lastCapture:h};let te=Ki({nowMs:y,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(te<=0)break;await Sn(e,te)}return{settled:!1,stalled:!1,waitedMs:P(e)-a,captures:f,nodeCount:m,lastCapture:h}}function Vi(e,t,n){if(!e||!t||!Hi(t.backend,n))return;let r=t.nodes.some(y),i=e.length<=5;if(!(!r&&!i))return Mi({...t,nodes:e})}function Hi(e,t){return e===`xctest`||e===void 0&&t===`ios`}function Ui(e){return e.requestedQuietMs<500||!Fi(e.baseline,e.signal)?e.currentQuietMs:Math.max(e.requestedQuietMs,1500)}function Wi(e){return e?.state===`recovered`&&e.backend===`private-ax`&&e.reasonCode!==`deferred`}function Gi(e){if(!(e.resetRequested!==!0||e.alreadyReset||!Wi(e.verdict)))return Math.max(e.deadlineMs,e.nowMs+e.timeoutMs)}function Ki(e){let t=e.quietSinceMs+e.quietMs-e.nowMs,n=t>e.pollMs?e.pollMs:Math.max(25,t+2),r=e.deadlineMs-e.nowMs,i=r-1;return i<2?r>=2?r:0:Math.min(n,i)}async function qi(e,t,n,r){let i=await ji(e,t,n,async n=>await z(e,{...t,signal:n},{updateSession:!1,interactiveOnly:!0,preferredBackend:r}));return i.timedOut?void 0:i.value}const Ji=`The UI kept changing for the whole settle budget (animation, carousel, or ticker?), so no settled diff is shown. Raise --timeout, wait for specific content, or take a fresh snapshot.`,Yi=`A snapshot capture stalled past the settle budget, so no settled diff is shown. The action itself succeeded; observe with wait stable or snapshot.`;async function Xi(e,t,n){return await Qi(e,t,{...n,baseline:await ta(e,t,n.resolved),actionPoint:n.resolved.point})}const Zi=async(e,t)=>(await Qi(e,t,t)).observation;async function Qi(e,t,n){let r=n.quietMs??500,i=n.timeoutMs??1e4,a={settled:!1,waitedMs:0,captures:0,quietMs:r,timeoutMs:i};try{return await $i(e,t,n,a,await Bi(e,t,{quietMs:r,timeoutMs:i,resetBudgetOnPrivateAxRecovery:!0,broadTransitionBaselineNodes:n.baseline.nodes}))}catch(e){return{observation:{...a,hint:`Settle observation unavailable (${e instanceof Error?e.message:String(e)}). The action itself succeeded; take a snapshot to observe the result.`}}}}async function $i(e,t,n,r,i){let a={...r,settled:i.settled,waitedMs:i.waitedMs,captures:i.captures};if(!i.lastCapture)return{observation:{...a,hint:i.stalled?Yi:Ji}};let{stored:o,session:s}=await ma(e,t,i.lastCapture),c=B(i.lastCapture.snapshot),l=c.nodes,u=Dr(n.baseline,c);return{observation:{...a,...u?{surfaceChange:u}:{},...i.settled&&o&&!u?oa(n.baseline.nodes,l,n.actionPoint,s?.appBundleId):{},...fa(i,o,l.length,u)},settledCapture:c}}function ea(e,t){if(e)return Or(e,t)}async function ta(e,t,n){let r=await e.sessions.get(t.session??`default`);return na(n,r)??ia(n.preAction)??ra(r)}function na(e,t){if(e.kind!==`ref`)return;let n=t?.refFrameSnapshot;return n?ia(B(n)):void 0}function ra(e){let t=e?.refFrameSnapshot??e?.snapshot;return t?B(t):{nodes:[]}}function ia(e){return e?.nodes.length?e:void 0}function aa(e,t,n){let r=Ti(rn(e,n),rn(t,n),{flatten:!0,withRefs:!0}),i=r.lines.filter(e=>e.kind!==`unchanged`),a=da(i).map(e=>({kind:e.kind,text:e.text,...e.ref?{ref:e.ref}:{}}));return{summary:r.summary,lines:a,...i.length>a.length?{truncated:!0}:{}}}function oa(e,t,n,r){let i=aa(e,t,r);return{diff:i,...sa(i,t,n,r)}}function sa(e,t,n,r){let i=new Set(e.lines.filter(e=>e.kind===`added`&&e.ref).map(e=>e.ref)),a=an(t,r),o=new Map(t.filter(e=>e.ref).map(e=>[e.ref,e]));return[...i].some(e=>e!==void 0&&!a.has(e)&&!ca(o.get(e),n))?{}:ua(t,i,r)}function ca(e,t){if(!e?.rect||!t)return!1;let{x:n,y:r,width:i,height:a}=e.rect;return t.x>=n&&t.x<=n+i&&t.y>=r&&t.y<=r+a}const la=new Set([`application`,`window`]);function ua(e,t,n){let r=an(e,n),i=e.filter(e=>e.ref&&e.interactionBlocked!==`covered`&&!t.has(e.ref)&&!r.has(e.ref)&&!la.has(ke(e.type??`Element`)));if(i.length===0)return{};let a=i.slice(0,20).map(e=>{let t=ke(e.type??`Element`),n=Re(e,t);return{ref:e.ref,role:t,...n?{label:n}:{}}});return{tail:a,...i.length>a.length?{tailTruncated:!0}:{}}}function da(e){if(e.length<=80)return e;let t=e.filter(e=>e.kind===`added`),n=new Set(t.slice(0,80)),r=80-n.size,i=[];for(let t of e)n.has(t)?i.push(t):t.kind===`removed`&&r>0&&(i.push(t),--r);return i}function fa(e,t,n,r){let i=pa(e,t,n).hint;if(!r)return i===void 0?{}:{hint:i};let a=kr(r);return{hint:i===void 0?a:`${a} ${i}`}}function pa(e,t,n){return e.stalled?{hint:Yi}:e.settled?t?n<5?{hint:zi}:{}:{hint:`Settled on a sparse, unreadable tree — the diff is omitted and its refs/selectors are invalid. Use screenshot as visual truth and coordinate taps; retry snapshot after navigating.`}:{hint:Ji}}async function ma(e,t,n){if(D(n.snapshot.snapshotQuality))return{stored:!1};let r=await e.sessions.get(t.session??`default`);return r?(await e.sessions.set({...r,snapshot:n.snapshot}),{stored:!0,session:r}):{stored:!1}}function ha(e){let t=e.verify===!0;return{verify:t,needsPreActionBaseline:t||e.settle!==void 0,...e.settle===void 0?{}:{settle:e.settle}}}async function ga(e,t,n,r,i){let a=await _a(e,t,n,i);return ya({...r,...a})}async function _a(e,t,n,r){if(r.settle!==void 0){let i=await Xi(e,t,{...r.settle,resolved:n}),a=r.verify?ea(i.settledCapture,n.preAction):void 0;return{settle:i.observation,...a?{evidence:a}:{}}}if(!r.verify)return{};let i=await va(e,t,n);return i?{evidence:i}:{}}async function va(e,t,n){try{return Or(B((await U(e,t,!0)).snapshot),n.preAction)}catch{return}}function ya(e){let t=e;if(t.targetHittable!==!1||!ba(t)||t.hint===void 0)return e;let{hint:n,...r}=t;return r}function ba(e){if(e.evidence?.changedFromBefore===!0||e.settle?.surfaceChange!==void 0)return!0;let t=e.settle?.diff?.summary;return!!t&&(t.additions>0||t.removals>0)}function xa(e,n){let r=x(e),i=e.filter(r.isVisibleInEffectiveViewport).map(e=>e.rect).filter(Sa),a=i.length>0?i:e.map(e=>e.rect).filter(Sa);if(a.length===0)throw new t(`COMMAND_FAILED`,`Cannot infer viewport for ${n}`);let o=Math.min(...a.map(e=>e.x)),s=Math.min(...a.map(e=>e.y)),c=Math.max(...a.map(e=>e.x+e.width)),l=Math.max(...a.map(e=>e.y+e.height));return{x:o,y:s,width:c-o,height:l-s}}function Sa(e){return!!(e&&e.width>0&&e.height>0)}async function Ca(e,t){return await e.backend.resolveGestureViewport?.(N(e,t))||xa((await U(e,t,!1)).snapshot.nodes,`gesture`)}const wa=async(e,n)=>{let r=await H(e,n,{action:`focus`,requireInteractive:!0,pipeline:M.resolvedTarget});if(!e.backend.focus)throw new t(`UNSUPPORTED_OPERATION`,`focus is not supported by this backend`);let i=G(r),a=F(await e.backend.focus(N(e,n),i));return{...r,...a?{backendResult:a}:{},...w(`Focused (${i.x}, ${i.y})`)}},Ta=async(e,n)=>{let r=ha(n),i=await H(e,n,{action:`longPress`,requireInteractive:!0,pipeline:M.promotedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!e.backend.longPress)throw new t(`UNSUPPORTED_OPERATION`,`longPress is not supported by this backend`);let a=n.durationMs===void 0?void 0:un(n.durationMs,`durationMs`,0,12e4),o=G(i),s=F(await e.backend.longPress(N(e,n),o,{durationMs:a}));return await ga(e,n,i,{...i,...a===void 0?{}:{durationMs:a},...s?{backendResult:s}:{},...w(`Long pressed (${o.x}, ${o.y})`)},r)},Ea=async(e,n)=>{let r=ha(n),i=r.needsPreActionBaseline?null:await Da(e,n);if(i)return i;let a=await H(e,n,{action:`hover`,requireInteractive:!1,pipeline:M.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!e.backend.hover)throw new t(`UNSUPPORTED_OPERATION`,`hover is not supported by this backend`);let o=G(a),s=F(await e.backend.hover(N(e,n),o));return await ga(e,n,a,{...a,...s?{backendResult:s}:{},...w(`Hovered (${o.x}, ${o.y})`)},r)};async function Da(e,t){if(t.target.kind!==`ref`||!e.backend.hoverTarget||t.expectedResolvedTarget)return null;let{hoverTarget:n}=e.backend;return await Si(e,t,t.target,`hover`,async(e,t)=>await n(e,t))}const Oa=async(e,n)=>{if(!e.backend.performGesture)throw new t(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await di(e,n,`drag`);let r=await Ca(e,n),i=await ka(e,n,`source`),a=await ka(e,n,`destination`),o=Je({from:G(i),to:G(a),sourceHoldMs:n.gesture.sourceHoldMs,moveMs:n.gesture.moveMs,destinationHoldMs:n.gesture.destinationHoldMs},r),s=F(await e.backend.performGesture(N(e,n),o)),{start:c,end:l}=Ke(o);return{kind:`drag`,durationMs:o.durationMs,pointerCount:1,from:c,to:l,targets:{source:Aa(i),destination:Aa(a)},recording:ja(i,a),...s?{backendResult:s}:{},...w(`Dragged ${n.gesture.source} to ${n.gesture.destination}`)}};async function ka(e,t,n){let r=t.gesture[n];return await H(e,{...t,target:r.startsWith(`@`)?{kind:`ref`,ref:r}:{kind:`selector`,selector:r}},{action:`drag`,requireInteractive:!1,pipeline:M.resolvedTarget,expectedResolvedTarget:t.expectedResolvedTargets?.[n],replayTargetRole:n})}function Aa(e){if(e.kind===`point`||!e.resolution)throw new t(`COMMAND_FAILED`,`gesture drag target resolution was not disclosed`);let n=`selectorChain`in e?e.selectorChain:void 0;return{...n?.length?{selectorChain:n}:{},resolution:e.resolution}}function ja(e,t){let n=Ma(e),r=Ma(t),i=Na(e),a=Na(t);return{...n?{sourceSelector:n}:{},...r?{destinationSelector:r}:{},...i?{sourceTarget:i}:{},...a?{destinationTarget:a}:{}}}function Ma(e){return`selectorChain`in e&&e.selectorChain?.length?e.selectorChain.join(` || `):void 0}function Na(e){if(!(!(`selectorChain`in e)||!e.selectorChain?.length||!e.node||!e.preAction))return{selectorChain:e.selectorChain,node:e.node,preActionNodes:e.preAction.nodes}}function G(e){if(!e.point)throw new t(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}const Pa=async(e,t)=>await La(e,t,`press`),Fa=async(e,t)=>await La(e,t,`click`),Ia=async(e,n)=>{if(typeof n.text!=`string`)throw new t(`INVALID_ARGS`,`fill requires text`);let r=ha(n),i=r.needsPreActionBaseline?null:await Ba(e,n);if(i)return i;let a=await H(e,n,{action:`fill`,requireInteractive:!0,pipeline:M.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget,preresolvedTarget:n.preresolvedTarget});if(!e.backend.fill)throw new t(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=Ra(a),s=`node`in a?a.node?.type??``:``,c=s!==``&&be(s,e.backend.platform),l=n.allowNonHittableCoordinateFallback===!0&&`node`in a&&a.node?.hittable===!1,u=F(await e.backend.fill(N(e,n),o,n.text,{delayMs:n.delayMs,allowNonHittableCoordinateFallback:l})),d=s&&!c?`fill target ${Ha(a)} resolved to "${s}", attempting fill anyway.`:void 0;return await ga(e,n,a,{...a,text:n.text,...d?{warning:d}:{},...u?{backendResult:u}:{}},r)};async function La(e,n,r){let i=ha(n),a=i.needsPreActionBaseline?null:await za(e,n,r);if(a)return a;let o=await H(e,n,{action:r,requireInteractive:!0,pipeline:M.promotedTarget,captureEvidenceBaseline:i.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget,preresolvedTarget:n.preresolvedTarget});if(!e.backend.tap)throw new t(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let s=Ra(o),c;try{c=await e.backend.tap(N(e,n),s,{button:n.button,count:n.count,intervalMs:n.intervalMs,holdMs:n.holdMs,jitterPx:n.jitterPx,doubleTap:n.doubleTap})}catch(e){throw yn(e,o),e}let l=F(c);return await ga(e,n,o,{...o,...l?{backendResult:l}:{}},i)}function Ra(e){if(!e.point)throw new t(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}async function za(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||Va(t)||t.expectedResolvedTarget)return null;let{tapTarget:r}=e.backend;return await Si(e,t,t.target,n,async(e,t)=>await r(e,t))}async function Ba(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let{fillTarget:n}=e.backend;return{...await Si(e,t,t.target,`fill`,async(e,r)=>await n(e,r,t.text,{delayMs:t.delayMs})),text:t.text}}function Va(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 Ha(e){return e.target?.kind===`ref`?e.target.ref:e.target?.kind===`selector`?e.target.selector:`point`}function K(e){return{includeRects:e===`visible`||e===`hidden`,interactiveOnly:!1}}const Ua=M.wait.poll.defaultTimeoutMs;function Wa(e,t,n,r,i={}){let a=ir(r),o=n??a.defaultTimeoutMs,s=Y(e),c=no(i.isUnreadableError),l=[],u={},d=()=>Math.max(0,o-(Y(e)-s));return{capture:async n=>{let r=!1,i=Y(e)-s,a=t=>l.push({startedMs:i,durationMs:Y(e)-s-i,outcome:t}),o=await ji(e,t,d(),async e=>await c.attempt(async()=>{let t=await n(e);return r=!0,t}));if(!o.timedOut)return r&&c.recordReadableCapture(),a(Ga(r,c.lastUnobservedCause())),o;let f=eo(o.error);return a(f?`runner-restart`:`deadline`),u=f??{},{timedOut:!0,deadline:Ka(f!==void 0,c.readableCaptures())}},hasTimeRemaining:()=>d()>0,failureEvidence:()=>({timeoutMs:o,readableCaptures:c.readableCaptures(),captures:l.length,polls:qa(l),waitedMs:Y(e)-s,...u}),preserveUnreadableOnStall:i.preserveUnreadableOnStall,neverReadableCause:c.neverReadableCause,sleepUntilNextPoll:async()=>await ro(e,t,Math.min(a.intervalMs,d())),timeoutMs:o,waitedMs:()=>Y(e)-s}}function Ga(e,t){return e?`readable`:t?.outcome??`unreadable`}function Ka(e,t){return e?`runner-restart-exhausted`:t===0?`capture-stalled`:`capture-truncated`}function qa(e){return e.length<=30?[...e]:[...e.slice(0,5),...e.slice(-25)]}function Ja(e,n){return new t(`COMMAND_FAILED`,e,{reason:V.captureStalled,captureStalled:!0,...n,retriable:!0,hint:`No readable snapshot capture completed before the wait timeout. Retry, or use screenshot to inspect the current surface.`})}function Ya(e,n){return new t(`COMMAND_FAILED`,e,{reason:V.runnerRestartExhausted,waitRunnerRestartExhausted:!0,...n,retriable:!0,hint:`An iOS runner restart consumed the wait timeout before a readable snapshot completed. Inspect the diagnostics log for the runner invalidation/restart sequence, then retry.`})}function Xa(e,n){return new t(`COMMAND_FAILED`,e,{reason:V.deadlineExceeded,captureTruncated:!0,...n})}function Za(e,n){return new t(`COMMAND_FAILED`,e,{reason:V.targetAbsent,...n})}function Qa(e,t,n){let r=e.neverReadableCause();if(r!==void 0){if(r.outcome===`retriable`)throw $a(r.error,t);if(n)throw r.error}}function $a(e,n){let r=s(e);return new t(r.code,r.message,{reason:V.captureStalled,...r.details,...n},r)}function q(e,t,n){let r=t.failureEvidence();return n===`runner-restart-exhausted`?Ya(e,r):n===`capture-stalled`?(Qa(t,r,t.preserveUnreadableOnStall===!0),Ja(e,r)):n===`capture-truncated`?Xa(e,r):(Qa(t,r,!0),r.readableCaptures===0?Ja(e,r):Za(e,r))}function eo(e){if(!(e instanceof t))return;let n=e.details;if(n?.runnerRestarted===!0)return{runnerRestarted:!0,...J(n,`runnerRestartReason`),...J(n,`runnerRestartCommand`),...J(n,`runnerRestartCommandId`),...J(n,`runnerInvalidatedSessionId`),...J(n,`runnerRestartSessionId`),...J(n,`logPath`),...J(n,`diagnosticId`)}}function J(e,t){let n=e?.[t];return typeof n==`string`?{[t]:n}:{}}function to(e){return e instanceof t&&e.details?.retriable===!0}function no(e=Xe){let t=0,n;return{attempt:async t=>{try{return await t()}catch(t){if(e(t))n={outcome:`unreadable`,error:t};else if(to(t))n={outcome:`retriable`,error:t};else throw t;return}},lastUnobservedCause:()=>n,recordReadableCapture:()=>{t+=1},readableCaptures:()=>t,neverReadableCause:()=>t===0?n:void 0}}function Y(e){return e.clock?.now()??Date.now()}async function ro(e,t,n){let r=[t.signal,e.signal].filter(e=>e!==void 0);for(let e of r)e.throwIfAborted();if(n<=0)return!1;if(e.clock){await e.clock.sleep(n);for(let e of r)e.throwIfAborted();return!0}return await new Promise((e,t)=>{let i=r.length>0?AbortSignal.any(r):void 0,a=()=>i?.removeEventListener(`abort`,s),o=setTimeout(()=>{a(),e()},n),s=()=>{clearTimeout(o),a(),t(i?.reason)};i?.addEventListener(`abort`,s,{once:!0}),o.unref()}),!0}async function io(e,t,n){let r=await L(M.readAny,e.nodes,t,{platform:n}),i=r.kind===`target`||r.kind===`ambiguous`?r.matchedNodes:r.kind===`occluded`?[r.node]:[];return{selector:r.kind===`target`||r.kind===`ambiguous`?r.selector:t,observation:Pe(e,i)}}async function ao(e,t,n){let r=await io(e,t,n),i=r.observation;if(i.kind!==`absent`)throw Ne(r.selector,i);return{predicate:`absent`,pass:!0,selector:t,matches:i.matches}}async function oo(e,t,n,r,i){let a=Oe(n);if(a)throw Le(a,`wait`);let o=Wa(t,n,i,M.wait,{isUnreadableError:co,preserveUnreadableOnStall:!0}),s=K(),c,l;for(;o.hasTimeRemaining();){let i=await o.capture(async i=>{try{let{observation:a}=await io((await e.captureSnapshot(t,{...n,signal:i},{updateSession:!0,includeHiddenContentHints:!1,...s})).snapshot,r,t.backend.platform);if(a.kind===`sparse`||a.kind===`truncated`)throw Ne(r,a,`wait`);return a}catch(e){throw Xe(e)?Ie(r,e,`wait`):e}});if(i.timedOut){l=i.deadline;break}let a=i.value;if(a?.kind===`absent`)return{kind:`absent`,waitedMs:o.waitedMs()};a?.kind===`present`&&(c=a),await o.sleepUntilNextPoll()}throw l===`runner-restart-exhausted`?q(`wait absent timed out for selector: ${r}`,o,l):c?so(r,c,o.failureEvidence()):q(`wait absent timed out for selector: ${r}`,o,l)}function so(e,n,r){let i=n.matches!==1;return new t(`COMMAND_FAILED`,`wait absent timed out for selector ${e}: ${n.matches} match${i?`es`:``} remain`,{reason:V.targetPresent,selector:e,...r,matches:n.matches,firstMatch:n.firstMatch})}function co(e){if(!(e instanceof t))return!1;let n=e.details;return n?.command===`wait`&&n.predicate===`absent`&&(n.observation===`sparse`||n.observation===`truncated`||n.observation===`unreadable`)}function lo(e){if(e.kind===`ambiguous`||e.kind===`target`)return{selector:e.selector,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}async function uo(e,n,r,i,a,o){let s=Wa(n,r,a,M.wait),c=K(),l,u;for(;s.hasTimeRemaining();){let t=await s.capture(async t=>await e.captureSnapshot(n,{...r,signal:t},{updateSession:!0,includeHiddenContentHints:!1,...c}));if(t.timedOut){u=t.deadline;break}let a=t.value;if(a){let e=a.snapshot.nodes,t=lo(await L(M.wait,e,i,{platform:n.backend.platform}));if(t){let n=fo(e,t,o);if(n.kind===`satisfied`)return{kind:`selector`,selector:t.selector,waitedMs:s.waitedMs(),node:n.node,preActionNodes:e};l=n.evidence}}await s.sleepUntilNextPoll()}throw u!==`capture-stalled`&&l?new t(`COMMAND_FAILED`,`wait matched selector ${i} but no candidate carried the recorded landmark identity`,{reason:Vr,...s.failureEvidence(),...l}):q(`wait timed out for selector: ${i}`,s,u)}function fo(e,t,n){let r=t.matchedNodes[0];if(!n)return{kind:`satisfied`,node:r};let i=ut(e),a=ft(t.matchedNodes,i,ie(n),n.ancestry)[0];return a?{kind:`satisfied`,node:a}:{kind:`identity-mismatch`,evidence:{matchCount:t.matchedNodes.length,observed:S(r),observedAncestry:dt(r,i,Math.max(n.ancestry.length,1)).chain}}}async function po(e,n,r,i,a){let o=a??Ua,s=i??e.stable.defaultQuietMs,c=await e.stable.capture(n,r,{quietMs:s,timeoutMs:o});if(!c.settled)throw new t(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:V.stableTimeout,...c.stalled?{captureStalled:!0}:{},quietMs:s,timeoutMs:o,captures:c.captures,nodeCount:c.nodeCount,...c.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:c.waitedMs,captures:c.captures,nodeCount:c.nodeCount,...c.nodeCount<e.stable.tinyTreeNodeCount?{hint:e.stable.tinyTreeHint}:{}}}async function mo(e,t,n,r,i){let a=Wa(t,n,i,M.wait),o;for(;a.hasTimeRemaining();){let i=await a.capture(async i=>await ho(e,t,{...n,signal:i},r));if(i.timedOut){o=i.deadline;break}if(i.value)return{kind:`text`,text:r,waitedMs:a.waitedMs()};await a.sleepUntilNextPoll()}throw q(`wait timed out for text: ${r}`,a,o)}async function ho(e,t,n,r){return t.backend.findText&&(await t.backend.findText(_o(t,n),r)).found?!0:await go(e,t,n,r)}async function go(e,t,n,r){return!!dr((await e.captureSnapshot(t,n,{updateSession:!0,includeHiddenContentHints:!1})).snapshot.nodes,r)}function _o(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function vo(e){let n=async(t,n)=>{switch(n.target.kind){case`sleep`:return await ro(t,n,n.target.durationMs),{kind:`sleep`,waitedMs:n.target.durationMs};case`ref`:return await yo(e,t,n,n.target.ref,n.target.timeoutMs);case`selector`:return await uo(e,t,n,n.target.selector,n.target.timeoutMs,n.target.recordedLandmark);case`absent`:return await oo(e,t,n,n.target.selector,n.target.timeoutMs);case`stable`:return await po(e,t,n,n.target.quietMs,n.target.timeoutMs);case`text`:return await bo(e,t,n,n.target.text,n.target.timeoutMs);default:return xo(n.target)}};return{waitCommand:n,waitForTextCommand:async(e,r)=>{let i=await n(e,{...r,target:{kind:`text`,text:r.text,timeoutMs:r.timeoutMs}});if(i.kind!==`text`)throw new t(`COMMAND_FAILED`,`waitForText returned non-text result`);return i}}}async function yo(e,n,r,o,s){let c=await e.requireSnapshot(n,r.session),l=i(o);if(!l)throw new t(`INVALID_ARGS`,`Invalid ref: ${o}`);let u=a(c.snapshot.nodes,l),d=u?R(u,c.snapshot.nodes):void 0;if(!d)throw new t(`COMMAND_FAILED`,`Ref ${o} not found or has no label`);return await mo(e,n,r,d,s)}async function bo(e,n,r,i,a){let o=xe(i);if(!o.ok)throw new t(o.code,o.message);return await mo(e,n,r,o.text,a)}function xo(e){throw Error(`Unsupported wait target: ${String(e)}`)}const So=vo({captureSnapshot:z,requireSnapshot:gr,stable:{defaultQuietMs:500,tinyTreeHint:zi,tinyTreeNodeCount:5,capture:Bi}}),Co=So.waitCommand,wo=So.waitForTextCommand,To=async(e,n)=>{let r=n.locator??`any`;if(!n.query)throw new t(`INVALID_ARGS`,v);if(n.action===`wait`)return await ko(e,n,r);if(n.action===`list`)return await Ao(e,n,r);let{capture:i,match:a}=await jo(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 yr(e,i,a),node:a}},Eo=async(e,t)=>{if(t.target.kind===`ref`){let n=await gr(e,t.session),r=br(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`});Ur(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=le(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 yr(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await Mo(e,t,t.session??`default`,{selector:t.target.selector,policy:t.property===`text`?M.readText:M.readUnique,hooks:{onResolved:(e,n)=>Ur(e,n,t.expectedResolvedTarget,`get`)}}),r=le(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 yr(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}},Do=async(e,n)=>{let r=await Eo(e,{...n,property:`text`,target:n.target});if(r.kind!==`text`)throw new t(`COMMAND_FAILED`,`getText returned non-text result`);return r},Oo=async(e,n)=>{let r=await Eo(e,{...n,property:`attrs`,target:n.target});if(r.kind!==`attrs`)throw new t(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return r};async function ko(e,t,n){let r=Wa(e,t,t.timeoutMs,M.findWait),i;for(;r.hasTimeRemaining();){let a=await r.capture(async r=>await jo(e,{...t,signal:r},n,{includeHiddenContentHints:!1}));if(a.timedOut){i=a.deadline;break}if(a.value?.match)return{kind:`found`,found:!0,waitedMs:r.waitedMs()};await r.sleepUntilNextPoll()}throw q(`find wait timed out`,r,i)}async function Ao(e,t,n){let r=se(n,t.query),i=await z(e,t,{updateSession:!0,...K()});if(D(i.snapshot.snapshotQuality))throw hr(i.snapshot.snapshotQuality);return{kind:`list`,matches:(r?$n(M.readList,i.snapshot.nodes,r,{platform:e.backend.platform}).list?.matchedNodes??[]:ye(i.snapshot.nodes,n,t.query,{}).matches).map(e=>({ref:`@${e.ref}`,node:e}))}}async function jo(e,t,n,r){let i=se(n,t.query),a=await z(e,t,{updateSession:!0,scope:mr(e.backend.platform,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...K()});if(D(a.snapshot.snapshotQuality))throw hr(a.snapshot.snapshotQuality);if(i){let t=await L(M.readAny,a.snapshot.nodes,i,{platform:e.backend.platform});return{capture:a,match:t.kind===`target`?t.node:void 0}}return{capture:a,match:ye(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}async function Mo(e,n,r,i){let a=await z(e,{...n,session:r},{updateSession:!0,...K()}),o=await L(i.policy,a.snapshot.nodes,i.selector,{platform:e.backend.platform},i.hooks);if(o.kind!==`target`)throw new t(`COMMAND_FAILED`,ge(i.selector,[],{unique:!0}),{hint:Te([])});return{capture:a,node:o.node,selector:o.selector,ref:`@${o.node.ref}`}}const No=async(e,n)=>{let r=Ce(n.predicate);if(!r.ok)throw new t(r.code,r.message,{hint:r.hint});let i=r.predicate;if(i===`absent`){let e=Oe(n);if(e)throw Le(e)}if(i===`text`&&!n.expectedText)throw new t(`INVALID_ARGS`,ve);let a=n.selector,o=await Po(e,n,i,a);return i===`exists`?await Fo(e,o,a):i===`absent`?await ao(o.snapshot,a,e.backend.platform):await Io(e,n,o,i,a)};async function Po(t,n,r,i){try{return await z(t,n,{updateSession:!0,...K(r)})}catch(t){throw r!==`absent`||e(t)?t:Ie(i,t)}}async function Fo(e,n,r){let i=await L(M.readAny,n.snapshot.nodes,r,{platform:e.backend.platform});if(i.kind!==`target`)throw new t(`COMMAND_FAILED`,ge(r,[],{unique:!1}),{hint:Te([])});return{predicate:`exists`,pass:!0,selector:i.selector,matches:i.matches,selectorChain:Se(r)}}async function Io(e,n,r,i,a){let o=await L(M.readUnique,r.snapshot.nodes,a,{platform:e.backend.platform},{onResolved:(e,t)=>Ur(e,t,n.expectedResolvedTarget,`is`)});if(o.kind!==`target`)throw new t(`COMMAND_FAILED`,ge(a,[],{unique:!0}),{command:`is`,reason:je.selectorNotFound,predicate:i,selector:a,hint:Te([])});let s=_e({predicate:i,node:o.node,visibility:x(r.snapshot.nodes),expectedText:n.expectedText,platform:e.backend.platform});if(!s.pass)throw new t(`COMMAND_FAILED`,`is ${i} failed for selector ${o.selector}: ${s.details}`,{command:`is`,reason:je.predicateFailed,predicate:i,selector:o.selector,predicateDetails:s.details});return{predicate:i,pass:!0,selector:o.selector,...i===`text`?{text:s.actualText}:{},selectorChain:Se(a),node:o.node,preActionNodes:r.snapshot.nodes}}const Lo=async(e,t)=>await No(e,{...t,predicate:`visible`,selector:t.target.selector}),Ro=async(e,t)=>await No(e,{...t,predicate:`hidden`,selector:t.target.selector}),zo=async(e,n)=>{if(!e.backend.performGesture)throw new t(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await di(e,n,n.gesture.intent);let r=await Ca(e,n),i=qe(n.gesture,r,e.backend.platform),a=F(await e.backend.performGesture(N(e,n),i)),o=Vo(i.pointers,0),s=Vo(i.pointers,-1);return{kind:n.gesture.intent,durationMs:i.durationMs,pointerCount:i.topology===`single`?1:2,from:o,to:s,...a?{backendResult:a}:{},...w(Ho(n.gesture,o,s))}},Bo=async(e,t)=>{let n=t.gesture;return n.intent===`drag`?await Oa(e,{...t,gesture:n}):await zo(e,{...t,gesture:n})};function Vo(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 Ho(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 X={find:To,get:Eo,getText:Do,getAttrs:Oo,is:No,isVisible:Lo,isHidden:Ro,wait:Co,waitForText:wo},Z={click:Fa,press:Pa,fill:Ia,focus:wa,longPress:Ta,hover:Ea,gesture:Bo,settleObservation:Zi};function Uo(e){return{find:t=>X.find(e,t),get:t=>X.get(e,t),getText:(t,n={})=>X.getText(e,{...n,target:t}),getAttrs:(t,n={})=>X.getAttrs(e,{...n,target:t}),is:t=>X.is(e,t),isVisible:(t,n={})=>X.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>X.isHidden(e,{...n,target:t}),wait:t=>X.wait(e,t),waitForText:(t,n={})=>X.waitForText(e,{...n,text:t})}}function Wo(e){return{click:(t,n={})=>Z.click(e,{...n,target:t}),press:(t,n={})=>Z.press(e,{...n,target:t}),fill:(t,n,r={})=>Z.fill(e,{...r,target:t,text:n}),focus:(t,n={})=>Z.focus(e,{...n,target:t}),longPress:(t,n={})=>Z.longPress(e,{...n,target:t}),hover:(t,n={})=>Z.hover(e,{...n,target:t}),gesture:t=>Z.gesture(e,t),settleObservation:t=>Z.settleObservation(e,t)}}const Go=[0,187,255,255];function Ko(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||qo(e,n.rect)}function qo(e,t){let n=Jo(t);if(n==null)return;let r=Yo(n.x,0,e.width-1),i=Yo(n.y,0,e.height-1),a=Yo(n.right,0,e.width-1),o=Yo(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)Q(e,n,i+t,Go),Q(e,n,o-t,Go);for(let n=i;n<=o;n+=1)Q(e,r+t,n,Go),Q(e,a-t,n,Go)}}function Jo(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 Q(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 Yo(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}const Xo=[{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 Zo(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(!es(t,a,e))continue;let c=0,l=$o(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=Qo({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function Qo(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 Xo){let o=s+e.x,u=c+e.y;if(!ts(o,u,i,a))continue;let d=u*i+o;es(t,n,d)&&(l=$o(r,n,l,d))}return l}function $o(e,t,n,r){return t[r]=1,e[n]=r,n+1}function es(e,t,n){return e[n]===1&&t[n]!==1}function ts(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}function ns(e,t){return e.flatMap(e=>rs(e,t.baseline.width,t.baseline.height)?is(e,t,us(t.baseline.height)):[e])}function rs(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=ls(n)&&r>=t*.35}function is(e,t,n){let r=cs(e,ss(os(as(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])=>ds(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function as(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 os(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 ss(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 cs(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 ls(e){return Math.max(48,Math.round(e*.07))}function us(e){return Math.max(24,Math.round(e*.03))}function ds(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??=fs(t,a),ps(i,e,t,a,r.baseline,r.current))}return i}function fs(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 ps(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 ms=2.5;function hs(e){let t=gs(e);return ns(t.length<=2e3?ys(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)=>Ss(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function gs(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return Zo({mask:t,width:i,height:a,hooks:{create:e=>_s(e,i),visit:(e,t)=>vs(e,t,i,n,r)}})}function _s(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 vs(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 ys(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=>bs(e,r,t));if(!e){n.push({...r});continue}xs(e,r)}return n}function bs(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 xs(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 Ss(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=Cs(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=Cs(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height;return{index:t,rect:r,normalizedRect:kn({x:$(r.x/n.width),y:$(r.y/n.height),width:$(r.width/n.width),height:$(r.height/n.height)}),differentPixels:e.differentPixels,shareOfDiffPercentage:$(e.differentPixels/n.differentPixels),densityPercentage:$(e.differentPixels/s),shape:Es(r,n.width,n.height),size:Ds(s,n.totalPixels),location:ws(i,n.width,n.height),averageBaselineColorHex:ks(a),averageCurrentColorHex:ks(o),baselineLuminance:Math.round(Os(a)),currentLuminance:Math.round(Os(o)),dominantChange:Ts(a,o)}}function Cs(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function ws(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 Ts(e,t){let n=Os(t)-Os(e);return Math.abs(n)>=12?n>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 Es(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*ms?`horizontal-band`:e.height>=e.width*ms?`vertical-band`:`compact`}function Ds(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function Os(e){return e.r*.2126+e.g*.7152+e.b*.0722}function ks(e){return`#${As(e.r)}${As(e.g)}${As(e.b)}`}function As(e){return e.toString(16).padStart(2,`0`)}function $(e){return Math.round(e*100*100)/100}const js=Math.sqrt(3*255**2);async function Ms(e,t,n={}){await Ns(e,`Baseline image not found`),await Ns(t,`Current screenshot not found`);let r=n.outputPath,[i,a]=await Promise.all([O.readFile(e),O.readFile(t)]),[o,s]=await Promise.all([$e(i,`baseline screenshot`),$e(a,`current screenshot`)]);Ps(o.width,o.height,`baseline screenshot`,n.maxPixels),Ps(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 Fs(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*js,{diffData:d,diffMask:f,differentPixels:p}=await rt({baselineData:o.data,currentData:s.data,width:o.width,height:o.height,maxColorDistance:u}),m=p>0?hs({diffMask:f,baseline:o,current:s,totalPixels:l,differentPixels:p}):[];if(p>0&&r){let e=new ot.PNG({width:o.width,height:o.height});e.data=d,Ko(e,m),await O.mkdir(ct.dirname(r),{recursive:!0}),await O.writeFile(r,await it(e))}else await Fs(n.outputPath);let h=l>0?Math.round(p/l*100*100)/100:0;return{...p>0&&r?{diffPath:r}:{},...m.length>0?{regions:m}:{},totalPixels:l,differentPixels:p,mismatchPercentage:h,match:p===0}}async function Ns(e,n){try{await O.access(e)}catch{throw new t(`INVALID_ARGS`,`${n}: ${e}`)}}function Ps(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 Fs(e){if(e)try{await O.unlink(e)}catch(e){if(!Is(e,`ENOENT`))throw e}}function Is(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function Ls(e,t){return e.map(e=>{let n=Rs(e,t);return n.length>0?{...e,currentOverlayMatches:n}:e})}function Rs(e,t){let n=re(e.rect);return t.map(t=>{let r=t.overlayRect,i=An(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:zs(i/re(r)),regionCoveragePercentage:zs(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 zs(e){return Math.round(e*100*100)/100}async function Bs(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 Vs(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 Hs(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw s(e)}}const Us=async(e,n)=>{if(!n.baseline)throw new t(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let r=Ws(n.threshold),i=n.current??{kind:`live`};if(n.overlayRefs&&!Qs(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 Bs(e,n.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let t;Qs(i)?(s=await Gs(e,n),t=s.path):(o=await Bs(e,i,{usage:`diff screenshot current`,field:`current`}),t=o.path),c=n.out?await Vs(e,n.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await Ms(a.path,t,{threshold:r,outputPath:c?.path,maxPixels:e.policy.maxImagePixels});Qs(i)&&(u=await Ks(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 Ws(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 Gs(e,t){let n=await Hs(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await qs(e,t,n.path,Js(t))}catch(e){throw await n.cleanup(),e}return n}async function Ks(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await Zs(n),r;let a=await Vs(e,Ys(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await qs(e,t,a.path,{overlayRefs:!0,...Js(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:Ls(r.regions,n.overlayRefs)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function qs(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 Js(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function Ys(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:Xs(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:Xs(e.out.clientPath)}:{},...e.out.fileName?{fileName:Xs(e.out.fileName)}:{}}}function Xs(e){let t=ct.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function Zs(e){try{await O.unlink(Xs(e))}catch(e){if(!$s(e,`ENOENT`))throw e}}function Qs(e){return e.kind===`live`}function $s(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}const ec=async(e,n)=>{if(!e.backend.captureScreenshot)throw new t(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);c(n);let r=await Vs(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.scale!==void 0&&await Qe(r.path,n.scale),i=await r.publish()}catch(e){throw await r.cleanup?.(),e}return{path:r.path,...i?{artifacts:[i]}:{},...w(`Saved screenshot: ${r.path}`)}};function tc(e){let{nodes:t,backend:r,snapshotRaw:i}=e;if(i||!n(r))return{partial:!1,visibleNodeCount:t.length,totalNodeCount:t.length,reasons:[]};let a=Be(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 nc=`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 rc(e){return e?.systemSurfaceOnly===!0?nc:void 0}function ic(e,t){return e.presentationKey?e:{...e,presentationKey:r(t)}}function ac(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||!oc(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!sc(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 oc(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function sc(e,t){return e.truncated===t.truncated&&e.nodes.length===t.nodes.length&&e.nodes.every((e,n)=>lc(e,t.nodes[n]))}const cc=Object.keys({index:!0,depth:!0,parentIndex:!0,type:!0,role:!0,subrole:!0,label:!0,value:!0,identifier:!0,enabled:!0,selected:!0,focused:!0,hittable:!0,bundleId:!0,appName:!0,windowTitle:!0,surface:!0,hiddenContentAbove:!0,hiddenContentBelow:!0,interactionBlocked:!0});function lc(e,t){return cc.every(n=>e[n]===t[n])&&uc(e.rect,t.rect)&&dc(e.presentationHints,t.presentationHints)&&dc(e.actions,t.actions)}function uc(e,t){return!e||!t?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function dc(e,t){return!e||!t?e===t:e.length===t.length&&e.every((e,n)=>e===t[n])}const fc=async(e,t)=>{let n=await mc(e,t),r=ac({previous:n.session?.snapshot,current:n.snapshot,options:t,identity:{previousAppBundleId:n.session?.appBundleId,currentAppBundleId:n.result.appBundleId??n.session?.appBundleId}});await e.sessions.set(gc(t.session,n));let i=vc(n.snapshot);return d(n.snapshot,{nodes:n.snapshot.nodes,...i===void 0?{}:{truncated:i},visibility:tc({nodes:n.snapshot.nodes,backend:n.snapshot.backend,snapshotRaw:t.raw}),...u({...n.annotations,warnings:n.warnings}),...r?{unchanged:r}:{},...n.result.snapshotDiagnostics?{snapshotDiagnostics:n.result.snapshotDiagnostics}:{},..._c(n)})},pc=async(e,t)=>{let n=await mc(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,a=gc(t.session,n);if(!i){let t=Ei(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=Ti(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 mc(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,customActions:n.customActions}),o=hc(a,e),s=d(o,ic(o,n)),c=l(a),u=P(e);return{snapshot:s,result:a,session:i,annotations:c,warnings:yc({result:a,annotations:c,snapshot:s,options:n,session:i,capturedAt:s.createdAt??u,runtimeNow:u})}}function hc(e,t){return e.snapshot?e.snapshot:{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,createdAt:P(t)}}function gc(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 _c(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 vc(e){return e.truncated===void 0?e.backend!==`xctest`||e.producer===void 0?!1:st(e.producer)===`unavailable`&&void 0:e.truncated}function yc(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...tt(e.annotations.quality,e.snapshot.nodes)),t.push(...nt(vc(e.snapshot))),t.push(...wc(e)),e.annotations.quality||(t.push(...xc(e)),t.push(...Cc(e.snapshot.nodes)));let n=gt(e.snapshot.nodes);n&&t.push(n);let r=bc(e.annotations);r&&t.push(r);let i=Tc(e);return i&&t.push(i),t.push(...kc(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function bc(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return nc}function xc(e){if(e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1)return[];let t=e.snapshot.nodes[0];return Sc(t)?e.snapshot.producer===`appium-source`?[`Appium page source exposed only the application root. Descendants may be absent from the acquired hierarchy; use snapshot --raw to inspect the source and verify the app accessibility tree.`]:e.snapshot.producer!==void 0&&e.snapshot.producer!==`apple-runner`?[]:[`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 Sc(e){return e?b(e.type??``)===`application`:!1}function Cc(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 wc(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 Tc(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&Ec(t,e.snapshot)&&Dc(t,e.capturedAt,e.runtimeNow)&&Ac(t.nodes.length,e.snapshot.nodes.length))return Oc}function Ec(e,t){return e.presentationKey===void 0||t.presentationKey===void 0||e.presentationKey===t.presentationKey}function Dc(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const Oc=`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 kc(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`?[Oc]:[]}function Ac(e,t){return e<12?!1:t<=Math.floor(e*.2)}const jc={screenshot:ec,diffScreenshot:Us,snapshot:fc,diffSnapshot:pc};function Mc(e){return Cn(jc,e)}export{on as A,M as C,gn as D,hn as E,ft as F,_t as M,dt as N,dn as O,ut as P,bn as S,pn as T,Rn as _,Wo as a,F as b,Vr as c,R as d,dr as f,Bn as g,er as h,Bs as i,an as j,un as k,V as l,L as m,rc as n,Uo as o,$n as p,Vs as r,Br as s,Mc as t,Tr as u,Fn as v,fn as w,N as x,Cn as y};

package/dist/src/runtime10.js

@@ -0,0 +1 @@
+import{C as e}from"./sdk-contracts.js";import{r as t}from"./recording-export-quality.js";import{D as n,E as r,T as i,a,b as o,i as s,k as c,o as l,r as u,t as d,w as f,x as p,y as m}from"./runtime.js";import{n as h}from"./success-text.js";import{n as g,t as ee}from"./app-inventory.js";import"./app-inventory-contract.js";import{r as te}from"./tv-remote.js";import{t as ne}from"./keyboard-actions.js";function _(e,t){if(e!==void 0)return v(e,t)}function v(t,n){let r=t?.trim();if(!r)throw new e(`INVALID_ARGS`,`${n} must be a non-empty string`);return r}const re=async(t,n={})=>{if(!t.backend.listDevices)throw new e(`UNSUPPORTED_OPERATION`,`admin.devices is not supported by this backend`);return{kind:`adminDevices`,devices:await t.backend.listDevices(p(t,n),n.filter)}},ie=async(t,n={})=>{if(!t.backend.bootDevice)throw new e(`UNSUPPORTED_OPERATION`,`admin.boot is not supported by this backend`);let r=C(n.target),i=await t.backend.bootDevice(p(t,n),r),a=o(i);return{kind:`deviceBooted`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(`Booted device`)}},ae=async(t,n={})=>{if(!t.backend.shutdownDevice)throw new e(`UNSUPPORTED_OPERATION`,`admin.shutdown is not supported by this backend`);let r=C(n.target),i=await t.backend.shutdownDevice(p(t,n),r),a=o(i);return{kind:`deviceShutdown`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(`Shutdown device`)}},oe=async(e,t)=>await y(e,t,`install`),se=async(e,t)=>await y(e,t,`reinstall`),ce=async(e,t)=>await y(e,t,`installFromSource`);async function y(t,n,r){let i=r===`reinstall`?`reinstallApp`:`installApp`,a=t.backend[i];if(!a)throw new e(`UNSUPPORTED_OPERATION`,`admin.${r} is not supported by this backend`);let o=`app`in n&&n.app!==void 0?v(n.app,`app`):void 0;if(r!==`installFromSource`&&!o)throw new e(`INVALID_ARGS`,`admin.${r} requires app`);let s=p(t,n),c=await b(t,s,n.source);try{let e=await a.call(t.backend,s,{...o?{app:o}:{},source:c.source});return ue(r,o,c.source,e)}finally{await c.cleanup?.()}}async function b(e,t,n){let r=await le(e,x(n));try{return{source:x(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 le(e,t){if(t.kind===`url`)return{source:t};let n=await s(e,t,{usage:`admin.install`,field:`source`});return{source:{kind:`path`,path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function x(t){if(!t||typeof t!=`object`)throw new e(`INVALID_ARGS`,`install source is required`);if(t.kind===`path`)return{kind:`path`,path:v(t.path,`source.path`)};if(t.kind===`uploadedArtifact`)return{kind:`uploadedArtifact`,id:v(t.id,`source.id`)};if(t.kind===`url`){let e=v(t.url,`source.url`);return S(e),{kind:`url`,url:e}}throw new e(`INVALID_ARGS`,`install source kind must be path, uploadedArtifact, or url`)}function S(t){let n;try{n=new URL(t)}catch{throw new e(`INVALID_ARGS`,`Invalid install source URL: ${t}`)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new e(`INVALID_ARGS`,`Install source URL must use http or https`)}function C(e){if(!e)return;let t=_(e.id,`target.id`),n=_(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 ue(e,t,n,r){let i=o(r),a=e===`reinstall`?`appReinstalled`:e===`installFromSource`?`appInstalledFromSource`:`appInstalled`,s=w(r,`appName`),c=w(r,`appId`),l=w(r,`bundleId`),u=w(r,`packageName`),d=w(r,`launchTarget`),f=w(r,`installablePath`),p=w(r,`archivePath`);return{kind:a,...t?{app:t}:{},source:n,...c?{appId:c}:{},...s?{appName:s}:{},...l?{bundleId:l}:{},...u?{packageName:u}:{},...d?{launchTarget:d}:{},...f?{installablePath:f}:{},...p?{archivePath:p}:{},...i?{backendResult:i}:{},...h(`${e===`reinstall`?`Reinstalled`:`Installed`}: ${s??d??t??de(n)}`)}}function w(e,t){let n=e[t];return typeof n==`string`&&n.length>0?n:void 0}function de(e){return e.kind===`path`?e.path:e.kind===`uploadedArtifact`?e.id:e.url}const fe=/^[A-Za-z0-9_.:-]{1,64}$/,pe=async(t,n)=>{if(!t.backend.openApp)throw new e(`UNSUPPORTED_OPERATION`,`apps.open is not supported by this backend`);let r=T(n),i=await t.backend.openApp(P(t,n),r,{launchArgs:n.launchArgs,relaunch:n.relaunch}),a=o(i);return{kind:`appOpened`,target:r,relaunch:n.relaunch===!0,...a?{backendResult:a}:{},...h(`Opened: ${D(r)}`)}},me=async(t,n={})=>{if(!t.backend.closeApp)throw new e(`UNSUPPORTED_OPERATION`,`apps.close is not supported by this backend`);let r=_(n.app,`app`),i=await t.backend.closeApp(P(t,n),r),a=o(i);return{kind:`appClosed`,...r?{app:r}:{},...a?{backendResult:a}:{},...h(r?`Closed: ${r}`:`Closed app`)}},he=async(t,n={})=>{if(!t.backend.listApps)throw new e(`UNSUPPORTED_OPERATION`,`apps.list is not supported by this backend`);return{kind:`appsList`,apps:await t.backend.listApps(P(t,n),ee(n.filter))}},ge=async(t,n)=>{if(!t.backend.getAppState)throw new e(`UNSUPPORTED_OPERATION`,`apps.state is not supported by this backend`);let r=v(n.app,`app`);return{kind:`appState`,app:r,state:await t.backend.getAppState(P(t,n),r)}},_e=async(t,n)=>{if(!t.backend.pushFile)throw new e(`UNSUPPORTED_OPERATION`,`apps.push is not supported by this backend`);let r=v(n.app,`app`),i=await O(t,n.input);try{let e=await t.backend.pushFile(P(t,n),i.backendInput,r),a=o(e);return{kind:`appPushed`,app:r,inputKind:i.inputKind,...a?{backendResult:a}:{},...h(`Pushed to ${r}`)}}finally{await i.cleanup?.()}},ve=async(t,n)=>{if(!t.backend.triggerAppEvent)throw new e(`UNSUPPORTED_OPERATION`,`apps.triggerEvent is not supported by this backend`);let r=k(n.name);A(n.payload,`apps.triggerEvent payload for "${r}"`);let i=await t.backend.triggerAppEvent(P(t,n),{name:r,...n.payload?{payload:n.payload}:{}}),a=o(i);return{kind:`appEventTriggered`,name:r,...n.payload?{payload:n.payload}:{},...a?{backendResult:a}:{},...h(`Triggered app event: ${r}`)}};function T(t){let n=_(t.app,`app`),r=_(t.appId,`appId`),i=_(t.bundleId,`bundleId`),a=_(t.packageName,`packageName`),o=_(t.url,`url`),s=_(t.activity,`activity`),c={...n?{app:n}:{},...r?{appId:r}:{},...i?{bundleId:i}:{},...a?{packageName:a}:{},...o?{url:o}:{},...s?{activity:s}:{}};if(!E(c))throw new e(`INVALID_ARGS`,`apps.open requires app, appId, bundleId, packageName, url, or activity`);return c}function E(e){return!!(e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity)}function D(e){return e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity??`app`}async function O(t,n){if(!n||typeof n!=`object`)throw new e(`INVALID_ARGS`,`apps.push requires an input`);if(n.kind===`json`)return j(n.payload,`apps.push JSON payload`,8192),{backendInput:{kind:`json`,payload:n.payload},inputKind:`json`};let r=await s(t,n,{usage:`apps.push`,field:`input`});return{backendInput:{kind:`file`,path:r.path},inputKind:`file`,...r.cleanup?{cleanup:r.cleanup}:{}}}function k(t){let n=v(t,`name`);if(!fe.test(n))throw new e(`INVALID_ARGS`,`Invalid apps.triggerEvent name: ${n}`,{hint:`Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash.`});return n}function A(e,t){e!==void 0&&j(e,t,8192)}function j(t,n,r){if(M(t,n),Buffer.byteLength(N(t,n),`utf8`)>r)throw new e(`INVALID_ARGS`,`${n} exceeds ${r} bytes`)}function M(t,n){if(!t||typeof t!=`object`||Array.isArray(t))throw new e(`INVALID_ARGS`,`${n} must be a JSON object`)}function N(t,n){try{let r=JSON.stringify(t);if(typeof r!=`string`)throw new e(`INVALID_ARGS`,`${n} must be JSON-serializable`);return r}catch{throw new e(`INVALID_ARGS`,`${n} must be JSON-serializable`)}}function P(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}const F={open:pe,close:me,list:he,state:ge,push:_e,triggerEvent:ve},ye={devices:re,boot:ie,shutdown:ae,install:oe,reinstall:se,installFromSource:ce};function be(e){return{...m(F,e),list:(t={})=>F.list(e,{...t,filter:g(t.filter)})}}const xe=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,Se=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function I(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(Se,()=>(t=!0,`[REDACTED]`)),n=Ce(n,()=>{t=!0}),{value:n,redacted:t}}function L(e){try{let t=new URL(e),n=we(t);return(t.username||t.password)&&(t.username=`REDACTED`,t.password=`REDACTED`,n=!0),{value:t.toString(),redacted:n}}catch{return}}function Ce(e,t){return/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(e)?e.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let n=L(e);return n?(n.redacted&&t(),n.value):e}):e}function we(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))xe.test(n)&&(e.searchParams.set(n,`[REDACTED]`),t=!0);return t}const R=2048,z=4096,B=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function Te(e){let t=e.redacted===!0;return{kind:`diagnosticsLogs`,entries:e.entries.map(e=>{let n=G(e.message,z),r=U(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 Ee(e,t){let n=e.redacted===!0;return{kind:`diagnosticsNetwork`,entries:e.entries.map(e=>{let r=e.url?Oe(e.url):void 0,i=t===`headers`||t===`all`?V(e.requestHeaders):void 0,a=t===`headers`||t===`all`?V(e.responseHeaders):void 0,o=t===`body`||t===`all`?H(e.requestBody):void 0,s=t===`body`||t===`all`?H(e.responseBody):void 0,c=U(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 De(e){let t=e.redacted===!0;return{kind:`diagnosticsPerf`,metrics:e.metrics.map(e=>{let n=G(e.message,z),r=U(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 V(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[r,i]of Object.entries(e))if(B.test(r))n[r]=`[REDACTED]`,t=!0;else{let e=G(i,R);n[r]=e.value??``,t||=e.redacted}return{value:n,redacted:t}}function Oe(e){return L(e)??G(e,R)}function H(e){return e===void 0?{redacted:!1}:ke(e)??G(e,R)}function ke(e){try{let t=W(JSON.parse(e),I);return K(JSON.stringify(t.value),R,t.redacted)}catch{return}}function U(e){return W(e,e=>G(e,R))}function W(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=W(e,t);return n||=r.redacted,r.value}),redacted:n}}let n=!1,r={};for(let[i,a]of Object.entries(e)){if(B.test(i)){r[i]=`[REDACTED]`,n=!0;continue}let e=W(a,t);r[i]=e.value,n||=e.redacted}return{value:r,redacted:n}}function G(e,t){if(e===void 0)return{redacted:!1};let n=I(e);return K(n.value,t,n.redacted)}function K(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 Ae=async(t,n={})=>{if(!t.backend.readLogs)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.logs is not supported by this backend`);return Te(await t.backend.readLogs(await J(t,n),Me(n)))},q=async(t,n={})=>{if(!t.backend.dumpNetwork)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.network is not supported by this backend`);let r=Ne(n);return Ee(await t.backend.dumpNetwork(await J(t,n),r),r.include??`summary`)},je=async(t,n={})=>{if(!t.backend.measurePerf)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.perf is not supported by this backend`);return De(await t.backend.measurePerf(await J(t,n),Pe(n)))};async function J(e,t){let n=p(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 Me(e){return{...Y(e,100,500,`logs limit`),...e.levels===void 0?{}:{levels:Z(e.levels,`levels`)},...e.search===void 0?{}:{search:v(e.search,`search`)},...e.source===void 0?{}:{source:v(e.source,`source`)}}}function Ne(e){return{...Y(e,25,200,`network limit`),include:Fe(e.include)}}function Pe(e){return{...X(e),...e.sampleMs===void 0?{}:{sampleMs:c(e.sampleMs,`sampleMs`,100,6e4)},...e.metrics===void 0?{}:{metrics:Z(e.metrics,`metrics`,20)}}}function Y(e,t,n,r){return{...X(e),...e.cursor===void 0?{}:{cursor:v(e.cursor,`cursor`)},limit:e.limit===void 0?t:c(e.limit,r,1,n)}}function X(e){return{...e.since===void 0?{}:{since:v(e.since,`since`)},...e.until===void 0?{}:{until:v(e.until,`until`)}}}function Fe(t){if(t===void 0)return`summary`;if(t===`summary`||t===`headers`||t===`body`||t===`all`)return t;throw new e(`INVALID_ARGS`,`network include must be summary, headers, body, or all`)}function Z(t,n,r=50){if(!Array.isArray(t))throw new e(`INVALID_ARGS`,`${n} must be an array of strings`);if(t.length>r)throw new e(`INVALID_ARGS`,`${n} must contain at most ${r} entries`);return t.map((e,t)=>v(e,`${n}[${t}]`))}const Ie={logs:Ae,network:q,perf:je},Le=async(t,n)=>{let r=Q(n.action,`record`),i=r===`start`?t.backend.startRecording:t.backend.stopRecording;if(!i)throw new e(`UNSUPPORTED_OPERATION`,`record ${r} is not supported by this backend`);let a=n.out?await u(t,n.out,{field:`path`,ext:`.mp4`,artifactType:`screen-recording`}):void 0;try{let e=ze(n,a?.path);return He(r,await i.call(t.backend,p(t,n),e),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}},Re=async(t,n)=>{let r=Q(n.action,`trace`),i=r===`start`?t.backend.startTrace:t.backend.stopTrace;if(!i)throw new e(`UNSUPPORTED_OPERATION`,`trace ${r} is not supported by this backend`);let a=n.out?await u(t,n.out,{field:`outPath`,ext:`.trace`,artifactType:`trace-log`}):void 0;try{let e=a?.path?{outPath:a.path}:{};return Ue(r,await i.call(t.backend,p(t,n),e),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}};function ze(e,t){let n={};t&&(n.outPath=t);let r=Be(e.fps);r!==void 0&&(n.fps=r);let i=Ve(e.quality);return i!==void 0&&(n.quality=i),e.hideTouches!==void 0&&(n.showTouches=e.hideTouches!==!0),n}function Be(e){return e===void 0?void 0:c(e,`fps`,1,60)}function Ve(n){if(n===void 0)return;let r=t(n);if(r===void 0)throw new e(`INVALID_ARGS`,`quality must be one of: medium, high (legacy numeric values 5-10 are accepted)`);return r}function Q(t,n){if(t===`start`||t===`stop`)return t;throw new e(`INVALID_ARGS`,`${n} action must be start or stop`)}function He(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}:{},...$(e,t,n,{startKind:`recordingStarted`,stopKind:`recordingStopped`,startMessage:`Recording started`,stopMessage:`Recording stopped`})}}function Ue(e,t,n){return{...typeof t.outPath==`string`?{outPath:t.outPath}:{},...$(e,t,n,{startKind:`traceStarted`,stopKind:`traceStopped`,startMessage:`Trace started`,stopMessage:`Trace stopped`})}}function $(e,t,n,r){return{kind:e===`start`?r.startKind:r.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...h(e===`start`?r.startMessage:r.stopMessage)}}const We={record:Le,trace:Re},Ge=async(t,n={})=>{if(!t.backend.pressBack)throw new e(`UNSUPPORTED_OPERATION`,`system.back is not supported by this backend`);let r=n.mode??`in-app`;if(r!==`in-app`&&r!==`system`)throw new e(`INVALID_ARGS`,`system.back mode must be in-app or system`);let i=await t.backend.pressBack(p(t,n),{mode:r}),a=o(i);return{kind:`systemBack`,mode:r,...a?{backendResult:a}:{},...h(`Back`)}},Ke=async(t,n={})=>{if(!t.backend.pressHome)throw new e(`UNSUPPORTED_OPERATION`,`system.home is not supported by this backend`);let r=await t.backend.pressHome(p(t,n)),i=o(r);return{kind:`systemHome`,...i?{backendResult:i}:{},...h(`Home`)}},qe=async(t,n)=>{if(!t.backend.pressTvRemote)throw new e(`UNSUPPORTED_OPERATION`,`system.tvRemote is not supported by this backend`);let r=te(n.button),i=n.durationMs===void 0?void 0:c(n.durationMs,`durationMs`,0,1e4),a=await t.backend.pressTvRemote(p(t,n),{button:r,...i===void 0?{}:{durationMs:i}}),s=o(a);return{kind:`tvRemotePressed`,button:r,...i===void 0?{}:{durationMs:i},...s?{backendResult:s}:{},...h(`Pressed TV remote ${r}`)}},Je=async(t,n)=>{if(!t.backend.setOrientation)throw new e(`UNSUPPORTED_OPERATION`,`system.orientation is not supported by this backend`);let r=et(n.orientation),i=await t.backend.setOrientation(p(t,n),r),a=o(i);return{kind:`systemOrientationSet`,orientation:r,...a?{backendResult:a}:{},...h(`Rotated to ${r}`)}},Ye=async(t,n={})=>{if(!t.backend.setKeyboard)throw new e(`UNSUPPORTED_OPERATION`,`system.keyboard is not supported by this backend`);let r=n.action??`status`;if(!ne(r))throw new e(`INVALID_ARGS`,`system.keyboard action must be status, get, dismiss, enter, or return`);let i=await t.backend.setKeyboard(p(t,n),{action:r}),a=o(i),s=lt(i)?i:{};return r===`enter`||r===`return`?nt(s,a):r===`dismiss`?rt(r,s,a):at(r,s,a)},Xe=async(t,n)=>{if(n.action===`read`){if(!t.backend.getClipboard)throw new e(`UNSUPPORTED_OPERATION`,`system.clipboard read is not supported by this backend`);let r=await t.backend.getClipboard(p(t,n));return{kind:`clipboardText`,action:`read`,text:typeof r==`string`?r:r.text}}if(n.action!==`write`)throw new e(`INVALID_ARGS`,`system.clipboard action must be read or write`);if(!t.backend.setClipboard)throw new e(`UNSUPPORTED_OPERATION`,`system.clipboard write is not supported by this backend`);if(typeof n.text!=`string`)throw new e(`INVALID_ARGS`,`system.clipboard write requires text`);let r=await t.backend.setClipboard(p(t,n),n.text),i=o(r);return{kind:`clipboardUpdated`,action:`write`,textLength:Array.from(n.text).length,...i?{backendResult:i}:{},...h(`Clipboard updated`)}},Ze=async(t,n={})=>{if(!t.backend.openSettings)throw new e(`UNSUPPORTED_OPERATION`,`system.settings is not supported by this backend`);let r=_(n.target,`target`),i=await t.backend.openSettings(p(t,n),r),a=o(i);return{kind:`settingsOpened`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(r?`Opened settings: ${r}`:`Opened settings`)}},Qe=async(t,n={})=>{if(!t.backend.handleAlert)throw new e(`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 e(`INVALID_ARGS`,`system.alert action must be get, accept, dismiss, or wait`);let i=n.timeoutMs===void 0?void 0:c(n.timeoutMs,`timeoutMs`,0,12e4);return tt(r,await t.backend.handleAlert(p(t,n),r,{timeoutMs:i}))},$e=async(t,n={})=>{if(!t.backend.openAppSwitcher)throw new e(`UNSUPPORTED_OPERATION`,`system.appSwitcher is not supported by this backend`);let r=await t.backend.openAppSwitcher(p(t,n)),i=o(r);return{kind:`appSwitcherOpened`,...i?{backendResult:i}:{},...h(`Opened app switcher`)}};function et(t){switch(t){case`portrait`:case`portrait-upside-down`:case`landscape-left`:case`landscape-right`:return t;default:throw new e(`INVALID_ARGS`,`system.orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right`)}}function tt(e,t){return e===`get`?ot(t):e===`wait`?st(t):ct(e,t)}function nt(e,t){return{kind:`keyboardEnterPressed`,action:`enter`,state:e,...t?{backendResult:t}:{},...h(`Keyboard enter pressed`)}}function rt(e,t,n){return{kind:`keyboardDismissed`,action:e,state:t,...n?{backendResult:n}:{},...h(it(t))}}function it(e){return e.dismissed===!1?`Keyboard already hidden`:e.mechanism===`dismissKey`?`Keyboard dismissed via its dismiss key`:`Keyboard dismissed`}function at(e,t,n){return{kind:`keyboardState`,action:e,state:t,...n?{backendResult:n}:{}}}function ot(t){if(t.kind!==`alertStatus`)throw new e(`COMMAND_FAILED`,`system.alert get returned an invalid backend result`);return{kind:`alertStatus`,action:`get`,alert:t.alert}}function st(t){if(t.kind!==`alertWait`)throw new e(`COMMAND_FAILED`,`system.alert wait returned an invalid backend result`);return{kind:`alertWait`,action:`wait`,alert:t.alert,...t.waitedMs===void 0?{}:{waitedMs:t.waitedMs},...t.timedOut===void 0?{}:{timedOut:t.timedOut},...h(t.alert?`Alert visible`:`Alert wait timed out`)}}function ct(t,n){if(n.kind!==`alertHandled`)throw new e(`COMMAND_FAILED`,`system.alert ${t} returned an invalid backend result`);return{kind:`alertHandled`,action:t,handled:n.handled,...n.alert?{alert:n.alert}:{},...n.button?{button:n.button}:{},...h(n.handled?`Alert ${t}ed`:`No alert handled`)}}function lt(e){return!!(e&&typeof e==`object`)}const ut={back:Ge,home:Ke,orientation:Je,keyboard:Ye,clipboard:Xe,settings:Ze,alert:Qe,appSwitcher:$e,tvRemote:qe};function dt(e){return{capture:d(e),selectors:l(e),interactions:a(e),system:m(ut,e),apps:be(e),admin:m(ye,e),recording:m(We,e),observability:m(Ie,e)}}function ft(e){let t=f(e);return{...t,...dt(t)}}export{ft as createAgentDevice,i as createMemorySessionStore,r as localCommandPolicy,n as restrictedCommandPolicy};