agent-device 0.21.12 → 0.21.13

package/dist/src/runtime.js

@@ -1,3 +1,3 @@
-import{D as e,E as t,F as n,O as r,_ as i,b as a,g as o,h 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{An as m,Ar as h,Bn as g,Dn as _,Er as v,Gn as y,Hr as b,Ir as x,Jn as ee,Kn as te,Kr as ne,Ln as re,Mr as ie,Nn as ae,Nr as oe,On as se,Pr as ce,Rn as S,Rr as le,Sn as ue,Tn as de,Ur as fe,Vn as pe,Wn as me,Xn as he,bn as C,cr as ge,hr as _e,jr as ve,mr as ye,pr as be,qn as w,un as xe,wn as Se,xn as Ce,xr as we,zn as Te,zr as Ee}from"./sdk-batch.js";import{n as De}from"./snapshot-scope.js";import{r as T}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 E,n as D,t as O}from"./rect-center.js";import{a as Ge,n as Ke,t as qe}from"./gesture-plan.js";import{n as Je,o as Ye,r as Xe}from"./android-system-chrome.js";import{c as Ze,n as Qe,o as $e,r as et,s as k}from"./quality-warnings.js";import{a as tt,n as nt,o as rt}from"./png-worker-client.js";import{r as it}from"./png.js";import{i as at}from"./ios-system-surface.js";import{n as ot}from"./ios-snapshot-acquisition.js";import st from"node:path";import{promises as A}from"node:fs";import{createHash as ct}from"node:crypto";function lt(e){let t=new Map;for(let n of e)t.set(n.index,n);return t}function ut(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=w(e);r.push({role:n.role,...n.label===void 0?{}:{label:n.label}}),a=e}return{chain:r,broken:!1}}function dt(e,t,n,r){return e.filter(e=>{if(!te(w(e),n))return!1;let i=ut(e,t,Math.max(r.length,1));return!i.broken&&y(i.chain,r)})}const ft=/\b(logbox|redbox|reload js|copy stack|component stack|call stack|runtime error|open debugger to view warnings)\b/,pt=[/\b[\w.$<>/-]+\.(?:tsx?|jsx?):\d+(?::\d+)?\b/,/\b[\w.$<>/-]+\.(?:tsx?|jsx?)\s+\(\d+:\d+\)/],mt=new Set([`x`,`×`,`✕`,`✖`,`⨯`]);function ht(e){if(gt(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 gt(e){let t=_t(e),n=t.detected?vt(t):null;return{detected:t.detected,dismissNodes:t.dismissNodes,minimizeNodes:t.minimizeNodes,collapsedNodes:t.collapsedNodes,primaryAction:n}}function _t(e){let t=e.map(yt).join(`
-`).toLowerCase(),n=Mt(e,Et),r=Mt(e,Ue),i=Mt(e,He,At),a=Mt(e,Tt),o=xt(t),s=St(t);return{dismissNodes:n,minimizeNodes:r,collapsedNodes:i,detected:wt({text:t,hasReactNativeStackFrame:o,hasOverlayControl:Ct(t,n,r),hasControllessRedBoxText:s,collapsedNodes:i,openDebuggerWarningNodes:a})}}function vt(e){let t=Nt(e.dismissNodes);if(t)return It(t,Lt(t));let n=Rt(e.collapsedNodes.filter(jt));return n?.rect?{action:`close-collapsed-banner`,point:Ut(n),rect:n.rect,ref:n.ref,label:Gt(n)}:null}function yt(e){return[e.label,e.value,e.identifier,e.type,e.role].filter(Boolean).join(` `)}function bt(e){return ft.test(e)}function xt(e){return pt.some(t=>t.test(e))}function St(e){return/\buncaught\b/.test(e)&&/unable to download asset/.test(e)}function Ct(e,t,n){return t.length>0||n.length>0||/\b(reload js|copy stack)\b/.test(e)}function wt(e){return e.collapsedNodes.length>0||e.openDebuggerWarningNodes.length>0||e.hasControllessRedBoxText||e.hasOverlayControl&&(bt(e.text)||e.hasReactNativeStackFrame)}function Tt(e){return e.includes(`open debugger to view warnings`)||/^!,\s+open debugger\b/.test(e)}function Et(e){return Ve(e)||Dt(e)||Ot(e)}function Dt(e){return/^close(?:\s*\([^)]*\))?$/i.test(e)}function Ot(e){return mt.has(e)}function kt(e){return/^!,\s+/.test(e)}function At(e){return!e.rect||e.rect.height<=180}function jt(e){let t=Gt(e)?.trim().toLowerCase()??``;return(Tt(t)||kt(t))&&We(e)}function Mt(e,t,n=()=>!0){let r=[];for(let i of e)i.ref&&n(i)&&[i.label,i.value,i.identifier].map(e=>e?.trim().toLowerCase()).filter(e=>!!e).some(e=>t(e))&&r.push(i);return r}function Nt(e){return zt(e,Ft)}function Pt(e){let t=[e.type,e.role,e.subrole].join(` `).toLowerCase();return/\b(button|menuitem|link)\b/.test(t)}function Ft(e){return[Vt(Pt(e)),Vt(e.hittable),-(e.rect?ne(e.rect):1/0)]}function It(e,t){if(!e.rect)throw Error(`React Native overlay target node must have rect`);return{action:t,point:o(e.rect),rect:e.rect,ref:e.ref,label:Gt(e)}}function Lt(e){let t=Gt(e)?.trim().toLowerCase();return t&&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 Gt(e){return e.label??e.value??e.identifier}const Kt=new Set([`textfield`,`securetextfield`,`textview`,`textarea`,`searchfield`,`edittext`]),qt={strippedIndexes:new Set,refs:new Set};function Jt(e){let t=new Set(e.filter(e=>x(e.type??``)===`keyboard`).map(e=>e.index));if(t.size===0)return qt;let n=new Map(e.map(e=>[e.index,e])),r=$t(e,n,t),i=new Set(r),a=cn(e,n,r);for(let t of $t(e,n,a))i.add(t);for(let o of Yt(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 Yt(e,t,n,r,i){let a=new Set;if(n.size===0)return a;let o=Zt(t,n,r);if(o.size===0)return a;let s=Qt(t,r);for(let n of e)!i.has(n.index)&&!s.has(n.index)&&n.rect&&Xt(n,t,o)&&a.add(n.index);return a}function Xt(e,t,n){if(!e.rect)return!1;let r=ln(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 Zt(e,t,n){let r=new Map;for(let i of n){let n=e.get(i);if(!n?.rect)continue;let a=ln(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 Qt(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 $t(e,t,n){let r=new Set(n);if(n.size===0)return r;for(let i of e)un(i,t,n)&&r.add(i.index);return r}function en(e,t){if(e.bundleId!==`com.android.systemui`)return!1;if(Je(e))return!0;let n=new Set,r=e;for(;r?.bundleId===`com.android.systemui`&&!n.has(r.index);){if(Xe(r.identifier))return!0;n.add(r.index),r=r.parentIndex===void 0?void 0:t.get(r.parentIndex)}return!1}function tn(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:nn(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?qt:{strippedIndexes:o,refs:s}}function nn(e,t,n){return new Set(e.filter(e=>!n.has(e.index)&&en(e,t)).map(e=>e.index))}function rn(e,t){let n=Jt(e),r=tn(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 an(e,t){let{strippedIndexes:n}=rn(e,t);return n.size===0?e:e.filter(e=>!n.has(e.index))}function on(e,t){return rn(e,t).refs}function sn(e){return Jt(e).refs}function cn(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=ln(n,t);i!==void 0&&r.add(i)}for(let i of r){let a=new Set([i]);e.some(e=>Kt.has(x(e.type??``))&&!n.has(e.index)&&un(e,t,a))&&r.delete(i)}return r}function ln(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 un(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}const j={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`},dn=`replay_target_guard_mismatch`,fn=j.landmarkIdentityMismatch;function pn(e,t){return e.find(e=>De(e,t))??null}function M(e,t){let n=ie(e);return n&&ce(n)?n:mn(e,t)}function mn(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=ie(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 hn(e){return e}function gn(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 _n=[`button`,`link`,`menuitem`,`tabitem`,`textfield`,`searchfield`,`securetextfield`,`checkbox`,`radio`,`switch`,`cell`];function N(e){return[e.type,e.role,e.subrole].map(e=>x(e??``)).some(e=>e===`tab`||_n.some(t=>e.includes(t)))}function vn(e,t){let n=t[0];if(!n)return{kind:`ambiguous`,candidates:t};let r=Fn(e);if(!yn(t,r.nodesByIndex))return{kind:`ambiguous`,candidates:t};let i=Dn(e,n,r).node;for(let n of t.slice(1))if(Dn(e,n,r).node.index!==i.index){let e=Sn(t,r);return e?{kind:`equivalent`,node:e}:{kind:`ambiguous`,candidates:t}}return{kind:`equivalent`,node:i}}function yn(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(!bn(i,a,t)&&!bn(a,i,t))return!1}return!0}function bn(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 xn(e,t){return Sn(t,Fn(e))}function Sn(e,t){if(e.length<2||!yn(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(!N(n)||!e.every(e=>e===n||!N(e)))return null;let r=D(n.rect);return r&&e.every(e=>Cn(D(e.rect),r))?n:null}function Cn(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 wn(e,t){if(!t?.rect||!e.rect||!h(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 Tn(e,t){return Dn(e,t)}function En(e){let t=Fn(e);return n=>Dn(e,n,t)}function Dn(e,t,n){return f(t)?{node:t,reason:`covered`}:On(e,t,n)??kn(t)??An(e,t,n)??{node:t,reason:`original`}}function On(e,t,n){let r=Mn(e,t,n);return r?.rect&&E(r.rect)?{node:r,reason:`same-rect-descendant`}:null}function kn(e){return N(e)&&e.rect&&E(e.rect)?{node:e,reason:`semantic-target`}:null}function An(e,t,n){let r=jn(e,t,n);return!r?.rect||f(r)||!E(r.rect)?null:Nn(t,r,e,n)?{node:t,reason:`overly-broad-ancestor`}:{node:r,reason:`hittable-ancestor`}}function jn(e,t,n){if(t.hittable)return t;let r=e=>e.hittable===!0;return n?Ee(e,t,n.nodesByIndex,e=>r(e)?e:null):le(e,t,r)}function Mn(e,t,n){let r=D(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=D(e.rect);return t?O(t,r):!1});if(t.length!==1)break;i=t[0]}return i===t?null:i}function Nn(e,t,n,r){let i=D(e.rect),a=D(t.rect);if(!i||!a)return!1;if(Pn(t)&&!O(i,a))return!0;let o=ve(n,i,r?.viewportRootRects);return!o||!In(a,o)?!1:!O(i,a)}function Pn(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 Fn(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(h(i)){let e=D(i.rect);e&&r.push(e)}}return{nodesByIndex:t,childrenByParentIndex:n,viewportRootRects:r}}function In(e,t){let n=gn(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}function Ln(t,n,r,i){if(!Number.isFinite(t)||!Number.isInteger(t)||t<r||t>i)throw new e(`INVALID_ARGS`,`${n} must be an integer between ${r} and ${i}`);return t}function Rn(t,n,r){let i=Number(t[0]),a=Number(t[1]);if(Number.isNaN(i)||Number.isNaN(a))throw new e(`INVALID_ARGS`,n,r);return{x:i,y:a}}function zn(e){return{backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??Bn(),policy:e.policy??Wn(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal}}function Bn(e=[]){let t=new Map(e.map(e=>[e.name,Vn(e)]));return{get:e=>Vn(t.get(e)),set:e=>{t.set(e.name,Vn(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>Vn(e))}}function Vn(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:Hn(e.metadata)}:{}}}function Hn(e){try{return structuredClone(e)}catch{return{...e}}}function Un(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,...e}}function Wn(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,...e}}const Gn={defaultTimeoutMs:1e4,intervalMs:300},P={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:Gn},wait:{resolution:C.wait,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:Gn},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`}},Kn=new WeakMap;function qn(e,t){Yn(e)&&Kn.set(e,t)}function Jn(e){return Yn(e)?Kn.get(e):void 0}function Yn(e){return typeof e==`object`&&!!e||typeof e==`function`}function F(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function I(e){return e.clock?.now()??Date.now()}async function Xn(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}function Zn(e,t){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,e=>n(t,e)]))}function L(e){return e&&typeof e==`object`?e:void 0}function Qn(e,t,n,r){let i=n.ambiguity;if(i===`first-match`||i===`reject-candidates`){let a=de(e,t,{...r,requireRect:n.requireRect});return!a||a.matchedNodes.length===0?{kind:`none`}:i===`first-match`?er(a):a.matchedNodes.length>1?$n(a):er(a)}let a=_(e,t,{...r,...Ce({ambiguity:i,requireRect:n.requireRect})});return a.firstMatch?a.resolution?{kind:`resolved`,resolution:a.resolution,matchedNodes:a.firstMatch.matchedNodes}:$n(a.firstMatch):{kind:`none`}}function $n(e){return{kind:`ambiguous`,selector:e.selector.raw,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}function er(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 tr(e,t,n){let r=de(e,we(t),n);return r?{...r,selector:r.selector.raw}:null}function nr(e,t,n,r){let i=Qn(e,we(t),n,r);return i.kind===`resolved`?{...i,resolution:{...i.resolution,selector:i.resolution.selector.raw}}:i}async function R(e,t,n,r,i={}){let a=nr(sr(e,t),n,e.resolution,r);if(a.kind===`none`)return{kind:`none`};if(a.kind===`resolved`)return await ir(e,t,{node:a.resolution.node,selector:a.resolution.selector,selectorIndex:a.resolution.selectorIndex,matches:a.resolution.matches,matchedNodes:a.matchedNodes},i);let o=rr(t,a);return o?await ir(e,t,o,i):a}function rr(e,t){let n=xn(e,t.matchedNodes);return n?{node:n,selector:t.selector,selectorIndex:t.selectorIndex,matches:t.matchedNodes.length,matchedNodes:t.matchedNodes}:null}async function ir(e,t,n,r){let i=await or(e,t,n.node,r);return i.kind===`occluded`?{kind:`occluded`,node:i.node,selector:n.selector}:{...n,kind:`target`,node:i.node}}function ar(e,t,n,r){let i=sr(e,t);return{candidates:i,list:tr(i,n,{...r,requireRect:e.resolution.requireRect})}}async function or(e,t,n,r={}){r.onResolved?.(n,t);let i=cr(e.promotion,t,n);return e.occlusion!==`ignore`&&(i.covered||f(i.node))?{kind:`occluded`,node:i.node}:{kind:`target`,node:await lr(e,t,i.node,r)}}function sr(e,t){return e.occlusion===`exclude-and-refuse`?t.filter(e=>!f(e)):t}function cr(e,t,n){if(e===`none`)return{node:n,covered:!1};let r=Tn(t,n);return r.reason===`covered`?{node:r.node,covered:!0}:e===`hittable-ancestor-below-root`&&wn(r.node,t[0])&&n.rect?{node:n,covered:!1}:{node:r.node,covered:!1}}async function lr(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 ur(e){if(e.poll===`none`)throw Error(`selector pipeline row resolves against one capture and declares no poll budget`);return e.poll}function dr(e){return e.hittable===!0||N(e)}function fr(e,t){let n=pe(w(e),t);return n.id!==void 0||n.label!==void 0?!1:Te(e.value)===null}function pr(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 mr(e,t){let n=lt(t);return t.filter(t=>t.index!==e.index&&pr(t,e,n)).sort((e,t)=>e.index-t.index)}function hr(e,t){let n=E(e.rect);return!n||!t.rect?!1:b(t.rect,n.x,n.y)}function gr(e,t){if(!fr(e,t))return e;let n=mr(e,t);if(n.some(dr))return e;let r=n.find(e=>w(e).label!==void 0);return!r||!hr(r,e)?e:r}function _r(e){return e===`text`||e===`label`||e===`any`}function vr(e,t,n,r){if(!(r||e===`web`))return _r(t)?n:void 0}function yr(t){return new e(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:t.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 br(t,n){let r=n??`default`,i=await t.sessions.get(r);if(!i)throw new e(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let a=i.refFrameSnapshot??i.snapshot;if(!a)throw new e(`INVALID_ARGS`,`No snapshot in session. Run snapshot first.`);return{sessionName:r,session:i,snapshot:a}}async function z(t,n,r={updateSession:!0}){let i=t.backend.captureSnapshot;if(!i)throw new e(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let a=n.session??`default`,o=await t.sessions.get(a),s=xr(await i(F(t,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}}),t);return(n.signal??t.signal)?.throwIfAborted(),r.updateSession&&o&&!k(s.snapshotQuality)&&await t.sessions.set({...o,snapshot:s}),{sessionName:a,session:o,snapshot:s}}function xr(e,t){return e.snapshot?Sr(e.snapshot,e):{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,...e.quality?{snapshotQuality:e.quality}:{},createdAt:I(t)}}function Sr(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 Cr(e,t,n){if(e.backend.readText){let r=await e.backend.readText(F(e,{session:t.sessionName}),n);if(r.text.trim())return r.text}return Fe(n)}function wr(t,n,r){let o=a(n);if(!o)throw new e(`INVALID_ARGS`,r.invalidRefMessage);let s=i(t,o)??(r.fallbackLabel.length>0?pn(t,r.fallbackLabel):null);if(!s)throw new e(`COMMAND_FAILED`,r.notFoundMessage);return{ref:o,node:s}}function Tr(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 Er(e){let t=Buffer.alloc(16);for(let n of e)Or(t,Dr(n));return{digest:`ax1:${ct(`sha256`).update(t).update(`\0`).update(String(e.length)).digest(`hex`).slice(0,16)}`,nodeCount:e.length}}function Dr(e){return ct(`sha256`).update(e.type??``).update(`\0`).update(e.label??``).update(`\0`).update(e.identifier??``).digest().subarray(0,16)}function Or(e,t){for(let n=0;n<e.length;n+=1)e[n]=(e[n]??0)^(t[n]??0)}function kr(e){let{digest:t,nodeCount:n}=Er(e),r=e.reduce((e,t)=>t.hittable===!1?e:e+1,0),i=Ar(e);return{digest:t,nodeCount:n,interactiveNodeCount:r,...i?{foregroundApp:i}:{}}}function Ar(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 jr(e,t){if(!e||e.surfaceBundleId===t.surfaceBundleId)return;let n={from:e.surfaceBundleId??`app`,to:t.surfaceBundleId??`app`};return{...n,disclosure:at(n)}}function Mr(e,t){let n=kr(e.nodes),r=jr(t,e);if(r)return{...n,changedFromBefore:!0,surfaceChange:r};let i=t!==void 0&&n.digest!==kr(t.nodes).digest;return{...n,changedFromBefore:i}}function Nr(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 Pr(e,t,n={}){let r=D(t.rect),i=E(r??void 0);if(!r||!i)return{kind:`invalid`};let a=Fr(e,t,r);if(a.length===0)return{kind:`resolved`,point:i,strategy:`center`};let o=(n.bounds??[]).reduce((e,t)=>e?Lr(e,t):null,r),s=o?Rr(r,o,i,a):null;return s?{kind:`resolved`,point:s,strategy:`parent-owned`}:{kind:`blocked`,competitorRefs:a.map(e=>e.ref)}}function Fr(e,t,n){let r=new Map(e.map(e=>[e.index,e]));return e.filter(e=>e.index!==t.index).filter(e=>Ir(e,t,r)).filter(N).flatMap(e=>{let t=D(e.rect);if(!t||O(t,n))return[];let r=Lr(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 Ir(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 Lr(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 Rr(e,t,n,r){let i=Ur(e),a=Vr(t.x,t.width,n.x,r.flatMap(({rect:e})=>[e.x,e.x+e.width]),i),o=Vr(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(!b(t,s.x,s.y))return[];let c=zr(s,e,n,r,i);return c?[c]:[]})).sort(Br)[0]?.point??null}function zr(e,t,n,r,i){let a=Hr(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 Br(e,t){return e.distanceSquared-t.distanceSquared||t.clearance-e.clearance||e.point.y-t.point.y||e.point.x-t.point.x}function Vr(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 Hr(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 Ur(e){let t=Math.min(e.width,e.height);return Math.max(0,Math.min(12,Math.floor(t/2)-1))}function Wr(t,n,r,i){let{candidates:a,list:o}=ar(i,t,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=vn(a,s);if(l.kind===`ambiguous`)throw new e(`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)}}}const Gr=Object.freeze({reason:`tap_keyboard_occludes_target`,hint:"The visible keyboard covers this target, so the tap would land on a key instead of on it. End editing first: tap the app's own Done/Cancel/close control, or run `keyboard enter` when submitting is what you want (`keyboard dismiss` works only when the keyboard exposes its own dismiss key). This reads the snapshot the command measured against, so if the keyboard closed since it was taken, run `snapshot -i` and retry."}),Kr=new Set([`keyboard`,`key`]);function qr(e){return Kr.has(x(e.type??``))||p(e)}const Jr=new Set([`UIKeyboardDockItemButton`,`UIAccessibilityElementKBKey`]);function Yr(e){return qr(e)||Jr.has(e.role??``)}function Xr(e,t,n){return n.has(e.index)||$r(t,n,e.index).length>0}function Zr(e){return e!==null&&fe(e)}function V(e){return e.flatMap(e=>fe(e.rect)?[e.rect]:[])}function Qr(e,t){let n=new Map(e.map(e=>[e.index,e.parentIndex])),r=new Set(t.map(e=>e.index)),i=new Set;for(let e of t)for(let t of $r(n,r,e.index))i.add(t);return i}function $r(e,t,n){let r=[],i=new Set,a=e.get(n);for(;typeof a==`number`&&!i.has(a);)i.add(a),t.has(a)&&r.push(a),a=e.get(a);return r}function ei(e){let t=e.map(e=>[e.x,e.x+e.width]).sort((e,t)=>e[0]-t[0]),n=t[0]?.[1]??0;for(let[e,r]of t){if(e-n>2)return!1;n=Math.max(n,r)}return!0}function ti(e){let t=Math.min(...e.anchorRects.map(e=>e.y)),n=Math.min(...e.anchorRects.map(e=>e.x)),r=Math.max(...e.anchorRects.map(e=>e.x+e.width)),i=e.viewport.y+e.viewport.height;return e.reportedBottom<i-80||r-n<=e.reportedBottom-t?null:{x:n,y:t,width:r-n,height:i-t}}function ni(e){let t=V(e.anchorNodes.filter(t=>!e.planeIndices.has(t.index)));return ei(t.length>0?t:e.anchorRects)}function ri(e){let t=e.filter(Yr),n=Qr(e,t);return V(t.filter(e=>!n.has(e.index)))}function ii(e,t){let n=e.filter(qr),r=V(n);if(r.length===0||!Zr(t))return null;let i=e.filter(Yr),a=V(i);if(a.length===0)return null;let o=ti({anchorRects:r,reportedBottom:Math.max(...a.map(e=>e.y+e.height)),viewport:t});if(!o)return null;let s=Qr(e,i);return ni({anchorNodes:n,anchorRects:r,planeIndices:s})?{frame:o,controlRects:V(i.filter(e=>!s.has(e.index)))}:null}function ai(e){if(e.keyboard?.kind===`absent`)return{kind:`no-keyboard`};let t=e.keyboard?.kind===`visible`?{frame:e.keyboard.frame,controlRects:ri(e.nodes)}:ii(e.nodes,e.viewport);if(!t)return e.nodes.some(qr)?{kind:`undetermined`}:{kind:`no-keyboard`};if(!e.node)return oi(e.point,t);let n=new Map(e.nodes.map(e=>[e.index,e.parentIndex])),r=new Set(e.nodes.filter(Yr).map(e=>e.index));return Xr(e.node,n,r)?{kind:`clear`,surface:t}:b(t.frame,e.point.x,e.point.y)?{kind:`occluded`,surface:t}:{kind:`clear`,surface:t}}function oi(e,t){return t.controlRects.some(t=>b(t,e.x,e.y))?{kind:`clear`,surface:t}:b(t.frame,e.x,e.y)?{kind:`occluded`,surface:t}:{kind:`clear`,surface:t}}function si(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`}}function ci(e){let t=e.node.rect;if(!t||!e.tapPoint)return;let n=ai({nodes:e.nodes,viewport:v(e.nodes).resolveViewport(t),point:e.tapPoint,node:e.node,...e.keyboard?{keyboard:e.keyboard}:{}});if(n.kind===`occluded`)throw di({label:e.label,action:e.action,ref:e.node.ref,targetRect:t,surface:n.surface})}function li(e){let t=ai({nodes:e.nodes,viewport:e.viewport,point:e.point,...e.keyboard?{keyboard:e.keyboard}:{}});if(t.kind===`occluded`)return ui(e.point,t.surface)}function ui(e,t){return`(${e.x}, ${e.y}) is behind the visible keyboard, so this tap lands on the keyboard rather than anything under it (${Gr.reason}; keyboard frame ${Math.round(t.frame.y)}..${Math.round(t.frame.y+t.frame.height)}). `+Gr.hint}function di(t){return new e(`COMMAND_FAILED`,`${t.label} is behind the visible keyboard and cannot ${si(t.action)} safely`,{...Gr,ref:`@${t.ref}`,rect:t.targetRect,keyboardFrame:t.surface.frame})}function fi(t,n,r,i,a){if(!r)return;let o=w(t),s=ee(t,n);if(!(me(o,r.identity)&&he(s,r.structural)))throw new e(`COMMAND_FAILED`,`${i} resolved to a different element than replay verification isolated; the action was not sent`,{reason:dn,observed:o,observedStructural:s,expected:r.identity,expectedStructural:r.structural,...a?{targetRole:a}:{}})}async function H(e,t,n){return await Ni(e,t,n.action),t.target.kind===`point`?await mi(e,t,t.target,n):t.target.kind===`ref`?await vi(e,t,t.target,n):await yi(e,t,t.target,n)}async function pi(e,t,n){let r=(await e.sessions.get(t.session??`default`))?.snapshot,i=r?.nodes;if(!i)return;let a={x:n.x,y:n.y},o=v(i).resolveViewport({x:a.x,y:a.y,width:0,height:0});return o&&!b(o,a.x,a.y)?`Coordinates (${a.x}, ${a.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.`:li({nodes:i,point:a,viewport:o,...r?.keyboard?{keyboard:r.keyboard}:{}})}async function mi(e,t,n,r){let i=await pi(e,t,n);if(!r.captureEvidenceBaseline)return{kind:`point`,point:{x:n.x,y:n.y},...i?{warning:i}:{}};let a=await hi(e,t);return{kind:`point`,point:{x:n.x,y:n.y},...a?{preAction:a}:{},...i?{warning:i}:{}}}async function hi(e,t){try{return B((await U(e,t,!0)).snapshot)}catch{return}}function gi(t,n){let r=a(t.ref);if(!r)throw new e(`INVALID_ARGS`,`Invalid ref: ${t.ref}`);let i=a(n.ref),o=n.node.ref?a(n.node.ref):null;if(i!==r||o!==r||!n.nodes.includes(n.node))throw new e(`COMMAND_FAILED`,`Internal find target provenance does not match the interaction ref`);return{tree:{nodes:n.nodes,...n.iosSystemSurfaceBundleId?{surfaceBundleId:n.iosSystemSurfaceBundleId}:{}},...n.keyboard?{keyboard:n.keyboard}:{},resolved:wi(r,n.node,`exact`)}}async function _i(e,t,n){let r=await Fi(e,t,n);return{tree:B(r.snapshot),...r.snapshot.keyboard?{keyboard:r.snapshot.keyboard}:{},resolved:r.resolved}}async function vi(e,t,n,r){let{tree:i,keyboard:o,resolved:s}=r.preresolvedTarget?gi(n,r.preresolvedTarget):await _i(e,t,n),c=i.nodes,{node:l,tapPoint:u}=await ji({policy:r.pipeline,nodes:c,...o?{keyboard:o}:{},node:s.node,action:r.action,label:`Ref ${n.ref}`,hooks:{onResolved:(e,t)=>xi(e,t,r),offscreen:async(i,a)=>await Vi(e,t,i,a,n.ref,r)},resolveTapPoint:e=>Ri(e,c,{invalidMessage:`Ref ${n.ref} not found or has invalid bounds`,blockedTargetLabel:`Ref ${n.ref}`,blockedTargetDetails:{ref:`@${a(n.ref)??e.ref}`}})});return{kind:`ref`,point:u,target:{kind:`ref`,ref:`@${s.ref}`},...Oi(e,l,i,r.action,s.resolution)}}async function yi(e,t,n,r){let i=n.selector,a=await U(e,t,r.requireInteractive),o=Wr(a.snapshot.nodes,i,e.backend.platform,r.pipeline);if((!o||!o.node.rect)&&r.requireInteractive&&(a=await U(e,t,!1),o=Wr(a.snapshot.nodes,i,e.backend.platform,r.pipeline)),!o||!o.node.rect)throw await bi({runtime:e,nodes:a.snapshot.nodes,selectorExpression:i,action:r.action,resolved:o});let s=o,{node:c,tapPoint:l}=await ji({policy:r.pipeline,nodes:a.snapshot.nodes,...a.snapshot.keyboard?{keyboard:a.snapshot.keyboard}:{},node:s.node,action:r.action,label:`Selector ${s.selector}`,hooks:{onResolved:(e,t)=>xi(e,t,r),offscreen:async(n,i)=>await Bi(e,t,n,i,s.selector,r)},resolveTapPoint:e=>Ri(e,a.snapshot.nodes,{invalidMessage:`Selector ${o.selector} resolved to invalid bounds`,blockedTargetLabel:`Selector ${i}`,blockedTargetDetails:{selector:i}})});return{kind:`selector`,point:l,target:{kind:`selector`,selector:o.selector},...Oi(e,c,B(a.snapshot),r.action,Ei(o,a.snapshot.nodes))}}async function bi(t){let{runtime:n,nodes:r,selectorExpression:i,action:a,resolved:o}=t,s=await R(P.coveredDiagnosis,r,i,{platform:n.backend.platform});if(s.kind===`occluded`)return Mi({label:`Selector ${s.selector}`,node:s.node,action:a,selector:s.selector});let c=o?.diagnostics??[];return new e(`COMMAND_FAILED`,Se(i,c,{unique:!0}),{reason:je.selectorNotFound,hint:se(c)})}function xi(e,t,n){fi(e,t,n.expectedResolvedTarget,n.action,n.replayTargetRole)}const Si={source:`ref`,phase:`pre-action`,kind:`exact`},Ci={source:`ref`,phase:`pre-action`,kind:`label-fallback`};function wi(e,t,n){return{ref:e,node:t,resolution:n===`exact`?Si:Ci}}const Ti={source:`runtime`,phase:`pre-action`,kind:`unique`};function Ei(e,t){return e.disambiguation?{source:`runtime`,phase:`pre-action`,kind:`disambiguated`,matchCount:e.disambiguation.matchCount,winnerDiagnostic:Di(e.node,t),tiebreak:e.disambiguation.tiebreak,alternatives:e.disambiguation.alternatives.slice(0,5).map(e=>Di(e,t))}:Ti}function Di(e,t){let n=x(e.type??``),r=M(e,t);return{diagnosticRef:`diag-${e.ref}`,...n?{role:Tr(n,256)}:{},...r===void 0?{}:{label:Tr(r,256)}}}function Oi(e,t,n,r,i){let a=n.nodes;return{node:t,selectorChain:S(t,e.backend.platform,{action:r===`fill`?`fill`:`click`,nodes:a}),refLabel:M(t,a),...Ai(t,r),preAction:n,resolution:i,...ki(e,t,a,r)}}function ki(e,t,n,r){if(r!==`click`&&r!==`press`)return{};let i=gr(t,n);return i===t?{}:{recordingTarget:{node:i,selectorChain:S(i,e.backend.platform,{action:`click`,nodes:n}),refLabel:M(i,n)}}}function Ai(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 ji(e){let t=await or(e.policy,e.nodes,e.node,e.hooks);if(t.kind===`occluded`)throw Mi({label:e.label,node:t.node,action:e.action});let n=e.resolveTapPoint(t.node);return ci({nodes:e.nodes,node:t.node,action:e.action,label:e.label,...e.keyboard?{keyboard:e.keyboard}:{},tapPoint:n}),{node:t.node,tapPoint:n}}function Mi(t){return new e(`COMMAND_FAILED`,`${t.label} is covered by another visible element and cannot ${si(t.action)} safely`,{hint:`Use a different visible target, scroll it clear of the overlay, or inspect with snapshot/screenshot before retrying.`,...t.selector?{selector:t.selector}:{},ref:`@${t.node.ref}`,interactionBlocked:t.node.interactionBlocked})}async function U(t,n,r){if(!t.backend.captureSnapshot)throw new e(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let i=n.session??`default`,a=await t.sessions.get(i);if(!a)throw new e(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let o=await t.backend.captureSnapshot(F(t,n),{interactiveOnly:r,includeRects:!0}),s=o.snapshot??{nodes:o.nodes??[],truncated:o.truncated,backend:o.backend,createdAt:I(t)};return await t.sessions.set({...a,snapshot:s}),{snapshot:s}}async function Ni(t,n,r){if(t.backend.platform!==`macos`)return;let i=await Pi(t,n);if((i===`desktop`||i===`menubar`)&&(i!==`menubar`||r!==`click`&&r!==`press`))throw new e(`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 Pi(e,t){return(await e.sessions.get(t.session??`default`))?.metadata?.surface}async function Fi(t,n,r){let{session:i,snapshot:a}=await br(t,n.session),o=r.fallbackLabel??``,s=Li(a.nodes,r.ref,{fallbackLabel:o});if(!s)throw new e(`COMMAND_FAILED`,`Ref ${r.ref} not found or has no bounds`,{hint:ue});return Ii({session:i,frameTree:a,target:r,fallbackLabel:o,authorized:s})}function Ii(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=Li(o.nodes,r.ref,{fallbackLabel:i});return s&&me(w(a.node),w(s.node))?{snapshot:o,resolved:s}:{snapshot:n,resolved:a}}function Li(t,n,r){let o=a(n);if(!o)throw new e(`INVALID_ARGS`,`Invalid ref: ${n}`);let s=i(t,o);if(zi(s))return wi(o,s,`exact`);let c=r.fallbackLabel.length>0?pn(t,r.fallbackLabel):null;return zi(c)?wi(o,c,`label-fallback`):null}function Ri(t,n,r){let i=v(n),a=Pr(n,t,{bounds:[i.resolveEffectiveViewport(t),t.rect?i.resolveViewport(t.rect):null].filter(e=>e!==null)});if(a.kind===`resolved`)return a.point;throw a.kind===`invalid`?new e(`COMMAND_FAILED`,r.invalidMessage):new e(`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 zi(e){return e?E(e.rect)!==null:!1}async function Bi(e,t,n,r,i,{action:a}){return await Gi(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=>`${Hi(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 Vi(e,t,n,r,i,{action:o}){return await Gi(e,t,n,r,{message:`Ref ${i} is off-screen and not safe to ${o}`,details:{reason:`offscreen_ref`,ref:a(i)},hint:e=>`${Hi(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 Hi(e,t){return e?t?`Run scroll ${e} --until '${t}' to bring it on screen,`:`Scroll ${e} toward it,`:`Scroll toward it,`}async function Ui(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=Li(o,n.ref,{fallbackLabel:n.fallbackLabel??``});if(!s)return{};let c=P.resolvedTarget,{node:l}=await ji({policy:c,nodes:o,node:s.node,action:r,label:`Ref ${n.ref}`,hooks:{offscreen:async(i,a)=>await Vi(e,t,i,a,n.ref,{action:r,pipeline:c})},resolveTapPoint:e=>E(e.rect)});return{...Ai(l,r),node:l,preAction:B(i)}}async function Wi(e,t,n,r,i){let a=await Ui(e,t,n,r),o=L(await i(F(e,t),{kind:`ref`,ref:n.ref,...n.fallbackLabel?{fallbackLabel:n.fallbackLabel}:{}}));return{kind:`ref`,target:{kind:`ref`,ref:n.ref},resolution:Si,...a,...o?{backendResult:o}:{}}}async function Gi(t,n,r,i,a){let o=v(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 t.backend.confirmOffscreenTargetVisible?.(F(t,n),r,c);if(l)return{...r,rect:l};let u=ze(r,o);throw new e(`COMMAND_FAILED`,a.message,{...a.details,rect:r.rect,viewport:s,...u?{scrollDirection:u}:{},hint:a.hint(u)})}function Ki(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 qi(e,t,n={}){let r=Xi(Yi(e,n),Yi(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 Ji(e,t={}){return Yi(e,t).length}function Yi(e,t){return t.flatten?e.map(e=>({text:Ae(e,0,!1),comparable:Ki(e,0),...t.withRefs&&e.ref?{ref:e.ref}:{}})):Me(e).map(e=>({text:e.text,comparable:Ki(e.node,e.depth),...t.withRefs&&e.node.ref?{ref:e.node.ref}:{}}))}function Xi(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=Qi(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 Zi(o,e,t,n,r)}}return[]}function Zi(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=Qi(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 Qi(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 $i(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 ea(e){let t=e.snapshotQuality?.backend,n=(e.backend===`xctest`?ta(e.nodes):e.nodes).map(ia);return n.sort((e,t)=>oa(e).localeCompare(oa(t))),{captureBackend:t,nodes:n}}function ta(e){let t=v(e);return e.filter(e=>h(e)||t.isVisibleOnScreen(e))}function na(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 ra(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 ia(e){return{identity:`${e.type??``}#${aa(e)}`,...e.rect?{rect:{...e.rect}}:{}}}function aa(e){return[e.label,e.identifier,e.value].map(e=>String(e??``).trim()).join(`#`)}function oa(e){let t=e.rect;return`${e.identity}#${t?`${t.x},${t.y},${t.width},${t.height}`:``}`}const sa=`Settled on a nearly-empty tree — the app may still be loading. Wait for specific content (wait text ...) before interacting.`;async function ca(e,t,n){let{quietMs:r,timeoutMs:i}=n,a=I(e),o=a+i,s=!1,c=await e.sessions.get(t.session??`default`),l,u=Ze(c?.snapshot?.snapshotQuality),d=Math.min(300,Math.max(25,r)),f=0,p,m=0,h,g=a,_=r;for(;I(e)<o;){let c=await ha(e,t,o-I(e),u);if(!c)return{settled:!1,stalled:!0,waitedMs:I(e)-a,captures:f,nodeCount:m,lastCapture:h};f+=1,h=c,l??=la(n.broadTransitionBaselineNodes,c.snapshot,e.backend.platform);let v=ea(c.snapshot);_=da({baseline:l,signal:v,requestedQuietMs:r,currentQuietMs:_}),u??=Ze(c.snapshot.snapshotQuality);let y=I(e),b=pa({resetRequested:n.resetBudgetOnPrivateAxRecovery,alreadyReset:s,verdict:c.snapshot.snapshotQuality,nowMs:y,timeoutMs:i,deadlineMs:o});if(b!==void 0){s=!0,o=b,g=y,p=v,m=c.snapshot.nodes.length;let t=ma({nowMs:y,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(t<=0)break;await Xn(e,t);continue}if(!na(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 x=ma({nowMs:y,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(x<=0)break;await Xn(e,x)}return{settled:!1,stalled:!1,waitedMs:I(e)-a,captures:f,nodeCount:m,lastCapture:h}}function la(e,t,n){if(!e||!t||!ua(t.backend,n))return;let r=t.nodes.some(h),i=e.length<=5;if(!(!r&&!i))return ea({...t,nodes:e})}function ua(e,t){return e===`xctest`||e===void 0&&t===`ios`}function da(e){return e.requestedQuietMs<500||!ra(e.baseline,e.signal)?e.currentQuietMs:Math.max(e.requestedQuietMs,1500)}function fa(e){return e?.state===`recovered`&&e.backend===`private-ax`&&e.reasonCode!==`deferred`}function pa(e){if(!(e.resetRequested!==!0||e.alreadyReset||!fa(e.verdict)))return Math.max(e.deadlineMs,e.nowMs+e.timeoutMs)}function ma(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 ha(e,t,n,r){let i=await $i(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 ga=`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.`,_a=`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 va(e,t,n){return await ba(e,t,{...n,baseline:await Ca(e,t,n.resolved),actionPoint:n.resolved.point})}const ya=async(e,t)=>(await ba(e,t,t)).observation;async function ba(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 xa(e,t,n,a,await ca(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 xa(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?_a:ga}};let{stored:o,session:s}=await Ia(e,t,i.lastCapture),c=B(i.lastCapture.snapshot),l=c.nodes,u=jr(n.baseline,c);return{observation:{...a,...u?{surfaceChange:u}:{},...i.settled&&o&&!u?Oa(n.baseline.nodes,l,n.actionPoint,s?.appBundleId):{},...Pa(i,o,l.length,u)},settledCapture:c}}function Sa(e,t){if(e)return Mr(e,t)}async function Ca(e,t,n){let r=await e.sessions.get(t.session??`default`);return wa(n,r)??Ea(n.preAction)??Ta(r)}function wa(e,t){if(e.kind!==`ref`)return;let n=t?.refFrameSnapshot;return n?Ea(B(n)):void 0}function Ta(e){let t=e?.refFrameSnapshot??e?.snapshot;return t?B(t):{nodes:[]}}function Ea(e){return e?.nodes.length?e:void 0}function Da(e,t,n){let r=qi(an(e,n),an(t,n),{flatten:!0,withRefs:!0}),i=r.lines.filter(e=>e.kind!==`unchanged`),a=Na(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=Da(e,t,r);return{diff:i,...ka(i,t,n,r)}}function ka(e,t,n,r){let i=new Set(e.lines.filter(e=>e.kind===`added`&&e.ref).map(e=>e.ref)),a=on(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)&&!Aa(o.get(e),n))?{}:Ma(t,i,r)}function Aa(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 ja=new Set([`application`,`window`]);function Ma(e,t,n){let r=on(e,n),i=e.filter(e=>e.ref&&e.interactionBlocked!==`covered`&&!t.has(e.ref)&&!r.has(e.ref)&&!ja.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 Na(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 Pa(e,t,n,r){let i=Fa(e,t,n).hint;if(!r)return i===void 0?{}:{hint:i};let a=Nr(r);return{hint:i===void 0?a:`${a} ${i}`}}function Fa(e,t,n){return e.stalled?{hint:_a}:e.settled?t?n<5?{hint:sa}:{}:{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:ga}}async function Ia(e,t,n){if(k(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 La(e){let t=e.verify===!0;return{verify:t,needsPreActionBaseline:t||e.settle!==void 0,...e.settle===void 0?{}:{settle:e.settle}}}async function Ra(e,t,n,r,i){let a=await za(e,t,n,i);return Va({...r,...a})}async function za(e,t,n,r){if(r.settle!==void 0){let i=await va(e,t,{...r.settle,resolved:n}),a=r.verify?Sa(i.settledCapture,n.preAction):void 0;return{settle:i.observation,...a?{evidence:a}:{}}}if(!r.verify)return{};let i=await Ba(e,t,n);return i?{evidence:i}:{}}async function Ba(e,t,n){try{return Mr(B((await U(e,t,!0)).snapshot),n.preAction)}catch{return}}function Va(e){let t=e;if(t.targetHittable!==!1||!Ha(t)||t.hint===void 0)return e;let{hint:n,...r}=t;return r}function Ha(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 Ua(t,n){let r=v(t),i=t.filter(r.isVisibleInEffectiveViewport).map(e=>e.rect).filter(Wa),a=i.length>0?i:t.map(e=>e.rect).filter(Wa);if(a.length===0)throw new e(`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 Wa(e){return!!(e&&e.width>0&&e.height>0)}async function Ga(e,t){return await e.backend.resolveGestureViewport?.(F(e,t))||Ua((await U(e,t,!1)).snapshot.nodes,`gesture`)}const Ka=async(t,n)=>{let r=await H(t,n,{action:`focus`,requireInteractive:!0,pipeline:P.resolvedTarget});if(!t.backend.focus)throw new e(`UNSUPPORTED_OPERATION`,`focus is not supported by this backend`);let i=G(r),a=L(await t.backend.focus(F(t,n),i));return{...r,...a?{backendResult:a}:{},...T(`Focused (${i.x}, ${i.y})`)}},qa=async(t,n)=>{let r=La(n),i=await H(t,n,{action:`longPress`,requireInteractive:!0,pipeline:P.promotedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!t.backend.longPress)throw new e(`UNSUPPORTED_OPERATION`,`longPress is not supported by this backend`);let a=n.durationMs===void 0?void 0:Ln(n.durationMs,`durationMs`,0,12e4),o=G(i),s=L(await t.backend.longPress(F(t,n),o,{durationMs:a}));return await Ra(t,n,i,{...i,...a===void 0?{}:{durationMs:a},...s?{backendResult:s}:{},...T(`Long pressed (${o.x}, ${o.y})`)},r)},Ja=async(t,n)=>{let r=La(n),i=r.needsPreActionBaseline?null:await Ya(t,n);if(i)return i;let a=await H(t,n,{action:`hover`,requireInteractive:!1,pipeline:P.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!t.backend.hover)throw new e(`UNSUPPORTED_OPERATION`,`hover is not supported by this backend`);let o=G(a),s=L(await t.backend.hover(F(t,n),o));return await Ra(t,n,a,{...a,...s?{backendResult:s}:{},...T(`Hovered (${o.x}, ${o.y})`)},r)};async function Ya(e,t){if(t.target.kind!==`ref`||!e.backend.hoverTarget||t.expectedResolvedTarget)return null;let{hoverTarget:n}=e.backend;return await Wi(e,t,t.target,`hover`,async(e,t)=>await n(e,t))}const Xa=async(t,n)=>{if(!t.backend.performGesture)throw new e(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await Ni(t,n,`drag`);let r=await Ga(t,n),i=await Za(t,n,`source`),a=await Za(t,n,`destination`),o=qe({from:G(i),to:G(a),sourceHoldMs:n.gesture.sourceHoldMs,moveMs:n.gesture.moveMs,destinationHoldMs:n.gesture.destinationHoldMs},r),s=L(await t.backend.performGesture(F(t,n),o)),{start:c,end:l}=Ge(o);return{kind:`drag`,durationMs:o.durationMs,pointerCount:1,from:c,to:l,targets:{source:Qa(i),destination:Qa(a)},recording:$a(i,a),...s?{backendResult:s}:{},...T(`Dragged ${n.gesture.source} to ${n.gesture.destination}`)}};async function Za(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:P.resolvedTarget,expectedResolvedTarget:t.expectedResolvedTargets?.[n],replayTargetRole:n})}function Qa(t){if(t.kind===`point`||!t.resolution)throw new e(`COMMAND_FAILED`,`gesture drag target resolution was not disclosed`);let n=`selectorChain`in t?t.selectorChain:void 0;return{...n?.length?{selectorChain:n}:{},resolution:t.resolution}}function $a(e,t){let n=eo(e),r=eo(t),i=to(e),a=to(t);return{...n?{sourceSelector:n}:{},...r?{destinationSelector:r}:{},...i?{sourceTarget:i}:{},...a?{destinationTarget:a}:{}}}function eo(e){return`selectorChain`in e&&e.selectorChain?.length?e.selectorChain.join(` || `):void 0}function to(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(t){if(!t.point)throw new e(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return t.point}const no=async(e,t)=>await ao(e,t,`press`),ro=async(e,t)=>await ao(e,t,`click`),io=async(t,n)=>{if(typeof n.text!=`string`)throw new e(`INVALID_ARGS`,`fill requires text`);let r=La(n),i=r.needsPreActionBaseline?null:await co(t,n);if(i)return i;let a=await H(t,n,{action:`fill`,requireInteractive:!0,pipeline:P.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget,preresolvedTarget:n.preresolvedTarget});if(!t.backend.fill)throw new e(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=oo(a),s=`node`in a?a.node?.type??``:``,c=s!==``&&oe(s,t.backend.platform),l=n.allowNonHittableCoordinateFallback===!0&&`node`in a&&a.node?.hittable===!1,u=L(await t.backend.fill(F(t,n),o,n.text,{delayMs:n.delayMs,allowNonHittableCoordinateFallback:l})),d=s&&!c?`fill target ${uo(a)} resolved to "${s}", attempting fill anyway.`:void 0;return await Ra(t,n,a,{...a,text:n.text,...d?{warning:d}:{},...u?{backendResult:u}:{}},r)};async function ao(t,n,r){let i=La(n),a=i.needsPreActionBaseline?null:await so(t,n,r);if(a)return a;let o=await H(t,n,{action:r,requireInteractive:!0,pipeline:P.promotedTarget,captureEvidenceBaseline:i.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget,preresolvedTarget:n.preresolvedTarget});if(!t.backend.tap)throw new e(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let s=oo(o),c;try{c=await t.backend.tap(F(t,n),s,{button:n.button,count:n.count,intervalMs:n.intervalMs,holdMs:n.holdMs,jitterPx:n.jitterPx,doubleTap:n.doubleTap})}catch(e){throw qn(e,o),e}let l=L(c);return await Ra(t,n,o,{...o,...l?{backendResult:l}:{}},i)}function oo(t){if(!t.point)throw new e(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return t.point}async function so(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||lo(t)||t.expectedResolvedTarget)return null;let{tapTarget:r}=e.backend;return await Wi(e,t,t.target,n,async(e,t)=>await r(e,t))}async function co(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let{fillTarget:n}=e.backend;return{...await Wi(e,t,t.target,`fill`,async(e,r)=>await n(e,r,t.text,{delayMs:t.delayMs})),text:t.text}}function lo(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 uo(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 fo=P.wait.poll.defaultTimeoutMs;function po(e,t,n,r,i={}){let a=ur(r),o=n??a.defaultTimeoutMs,s=Y(e),c=To(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 $i(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(mo(r,c.lastUnobservedCause())),o;let f=Co(o.error);return a(f?`runner-restart`:`deadline`),u=f??{},{timedOut:!0,deadline:ho(f!==void 0,c.readableCaptures())}},hasTimeRemaining:()=>d()>0,failureEvidence:()=>({timeoutMs:o,readableCaptures:c.readableCaptures(),captures:l.length,polls:go(l),waitedMs:Y(e)-s,...u}),preserveUnreadableOnStall:i.preserveUnreadableOnStall,neverReadableCause:c.neverReadableCause,sleepUntilNextPoll:async()=>await Eo(e,t,Math.min(a.intervalMs,d())),timeoutMs:o,waitedMs:()=>Y(e)-s}}function mo(e,t){return e?`readable`:t?.outcome??`unreadable`}function ho(e,t){return e?`runner-restart-exhausted`:t===0?`capture-stalled`:`capture-truncated`}function go(e){return e.length<=30?[...e]:[...e.slice(0,5),...e.slice(-25)]}function _o(t,n){return new e(`COMMAND_FAILED`,t,{reason:j.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 vo(t,n){return new e(`COMMAND_FAILED`,t,{reason:j.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 yo(t,n){return new e(`COMMAND_FAILED`,t,{reason:j.deadlineExceeded,captureTruncated:!0,...n})}function bo(t,n){return new e(`COMMAND_FAILED`,t,{reason:j.targetAbsent,...n})}function xo(e,t,n){let r=e.neverReadableCause();if(r!==void 0){if(r.outcome===`retriable`)throw So(r.error,t);if(n)throw r.error}}function So(t,n){let i=r(t);return new e(i.code,i.message,{reason:j.captureStalled,...i.details,...n},i)}function q(e,t,n){let r=t.failureEvidence();return n===`runner-restart-exhausted`?vo(e,r):n===`capture-stalled`?(xo(t,r,t.preserveUnreadableOnStall===!0),_o(e,r)):n===`capture-truncated`?yo(e,r):(xo(t,r,!0),r.readableCaptures===0?_o(e,r):bo(e,r))}function Co(t){if(!(t instanceof e))return;let n=t.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 wo(t){return t instanceof e&&t.details?.retriable===!0}function To(e=Ye){let t=0,n;return{attempt:async t=>{try{return await t()}catch(t){if(e(t))n={outcome:`unreadable`,error:t};else if(wo(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 Eo(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 Do(e,t,n){let r=await R(P.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 Oo(e,t,n){let r=await Do(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 ko(e,t,n,r,i){let a=Oe(n);if(a)throw Le(a,`wait`);let o=po(t,n,i,P.wait,{isUnreadableError:jo,preserveUnreadableOnStall:!0}),s=K(),c,l;for(;o.hasTimeRemaining();){let i=await o.capture(async i=>{try{let{observation:a}=await Do((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 Ye(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?Ao(r,c,o.failureEvidence()):q(`wait absent timed out for selector: ${r}`,o,l)}function Ao(t,n,r){let i=n.matches!==1;return new e(`COMMAND_FAILED`,`wait absent timed out for selector ${t}: ${n.matches} match${i?`es`:``} remain`,{reason:j.targetPresent,selector:t,...r,matches:n.matches,firstMatch:n.firstMatch})}function jo(t){if(!(t instanceof e))return!1;let n=t.details;return n?.command===`wait`&&n.predicate===`absent`&&(n.observation===`sparse`||n.observation===`truncated`||n.observation===`unreadable`)}function Mo(e){if(e.kind===`ambiguous`||e.kind===`target`)return{selector:e.selector,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}async function No(t,n,r,i,a,o){let s=po(n,r,a,P.wait),c=K(),l,u;for(;s.hasTimeRemaining();){let e=await s.capture(async e=>await t.captureSnapshot(n,{...r,signal:e},{updateSession:!0,includeHiddenContentHints:!1,...c}));if(e.timedOut){u=e.deadline;break}let a=e.value;if(a){let e=a.snapshot.nodes,t=Mo(await R(P.wait,e,i,{platform:n.backend.platform}));if(t){let n=Po(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 e(`COMMAND_FAILED`,`wait matched selector ${i} but no candidate carried the recorded landmark identity`,{reason:fn,...s.failureEvidence(),...l}):q(`wait timed out for selector: ${i}`,s,u)}function Po(e,t,n){let r=t.matchedNodes[0];if(!n)return{kind:`satisfied`,node:r};let i=lt(e),a=dt(t.matchedNodes,i,g(n),n.ancestry)[0];return a?{kind:`satisfied`,node:a}:{kind:`identity-mismatch`,evidence:{matchCount:t.matchedNodes.length,observed:w(r),observedAncestry:ut(r,i,Math.max(n.ancestry.length,1)).chain}}}async function Fo(t,n,r,i,a){let o=a??fo,s=i??t.stable.defaultQuietMs,c=await t.stable.capture(n,r,{quietMs:s,timeoutMs:o});if(!c.settled)throw new e(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:j.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<t.stable.tinyTreeNodeCount?{hint:t.stable.tinyTreeHint}:{}}}async function Io(e,t,n,r,i){let a=po(t,n,i,P.wait),o;for(;a.hasTimeRemaining();){let i=await a.capture(async i=>await Lo(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 Lo(e,t,n,r){return t.backend.findText&&(await t.backend.findText(zo(t,n),r)).found?!0:await Ro(e,t,n,r)}async function Ro(e,t,n,r){return!!pn((await e.captureSnapshot(t,n,{updateSession:!0,includeHiddenContentHints:!1})).snapshot.nodes,r)}function zo(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function Bo(t){let n=async(e,n)=>{switch(n.target.kind){case`sleep`:return await Eo(e,n,n.target.durationMs),{kind:`sleep`,waitedMs:n.target.durationMs};case`ref`:return await Vo(t,e,n,n.target.ref,n.target.timeoutMs);case`selector`:return await No(t,e,n,n.target.selector,n.target.timeoutMs,n.target.recordedLandmark);case`absent`:return await ko(t,e,n,n.target.selector,n.target.timeoutMs);case`stable`:return await Fo(t,e,n,n.target.quietMs,n.target.timeoutMs);case`text`:return await Ho(t,e,n,n.target.text,n.target.timeoutMs);default:return Uo(n.target)}};return{waitCommand:n,waitForTextCommand:async(t,r)=>{let i=await n(t,{...r,target:{kind:`text`,text:r.text,timeoutMs:r.timeoutMs}});if(i.kind!==`text`)throw new e(`COMMAND_FAILED`,`waitForText returned non-text result`);return i}}}async function Vo(t,n,r,o,s){let c=await t.requireSnapshot(n,r.session),l=a(o);if(!l)throw new e(`INVALID_ARGS`,`Invalid ref: ${o}`);let u=i(c.snapshot.nodes,l),d=u?M(u,c.snapshot.nodes):void 0;if(!d)throw new e(`COMMAND_FAILED`,`Ref ${o} not found or has no label`);return await Io(t,n,r,d,s)}async function Ho(t,n,r,i,a){let o=be(i);if(!o.ok)throw new e(o.code,o.message);return await Io(t,n,r,o.text,a)}function Uo(e){throw Error(`Unsupported wait target: ${String(e)}`)}const Wo=Bo({captureSnapshot:z,requireSnapshot:br,stable:{defaultQuietMs:500,tinyTreeHint:sa,tinyTreeNodeCount:5,capture:ca}}),Go=Wo.waitCommand,Ko=Wo.waitForTextCommand,qo=async(t,n)=>{let r=n.locator??`any`;if(!n.query)throw new e(`INVALID_ARGS`,m);if(n.action===`wait`)return await Zo(t,n,r);if(n.action===`list`)return await Qo(t,n,r);let{capture:i,match:a}=await $o(t,n,r);if(!a)throw new e(`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 Cr(t,i,a),node:a}},Jo=async(e,t)=>{if(t.target.kind===`ref`){let n=await br(e,t.session),r=wr(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`});fi(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=S(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 Cr(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await es(e,t,t.session??`default`,{selector:t.target.selector,policy:t.property===`text`?P.readText:P.readUnique,hooks:{onResolved:(e,n)=>fi(e,n,t.expectedResolvedTarget,`get`)}}),r=S(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 Cr(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}},Yo=async(t,n)=>{let r=await Jo(t,{...n,property:`text`,target:n.target});if(r.kind!==`text`)throw new e(`COMMAND_FAILED`,`getText returned non-text result`);return r},Xo=async(t,n)=>{let r=await Jo(t,{...n,property:`attrs`,target:n.target});if(r.kind!==`attrs`)throw new e(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return r};async function Zo(e,t,n){let r=po(e,t,t.timeoutMs,P.findWait),i;for(;r.hasTimeRemaining();){let a=await r.capture(async r=>await $o(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 Qo(e,t,n){let r=re(n,t.query),i=await z(e,t,{updateSession:!0,...K()});if(k(i.snapshot.snapshotQuality))throw yr(i.snapshot.snapshotQuality);return{kind:`list`,matches:(r?ar(P.readList,i.snapshot.nodes,r,{platform:e.backend.platform}).list?.matchedNodes??[]:ae(i.snapshot.nodes,n,t.query,{}).matches).map(e=>({ref:`@${e.ref}`,node:e}))}}async function $o(e,t,n,r){let i=re(n,t.query),a=await z(e,t,{updateSession:!0,scope:vr(e.backend.platform,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...K()});if(k(a.snapshot.snapshotQuality))throw yr(a.snapshot.snapshotQuality);if(i){let t=await R(P.readAny,a.snapshot.nodes,i,{platform:e.backend.platform});return{capture:a,match:t.kind===`target`?t.node:void 0}}return{capture:a,match:ae(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}async function es(t,n,r,i){let a=await z(t,{...n,session:r},{updateSession:!0,...K()}),o=await R(i.policy,a.snapshot.nodes,i.selector,{platform:t.backend.platform},i.hooks);if(o.kind!==`target`)throw new e(`COMMAND_FAILED`,Se(i.selector,[],{unique:!0}),{hint:se([])});return{capture:a,node:o.node,selector:o.selector,ref:`@${o.node.ref}`}}const ts=async(t,n)=>{let r=ye(n.predicate);if(!r.ok)throw new e(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 e(`INVALID_ARGS`,ge);let a=n.selector,o=await ns(t,n,i,a);return i===`exists`?await rs(t,o,a):i===`absent`?await Oo(o.snapshot,a,t.backend.platform):await is(t,n,o,i,a)};async function ns(e,t,r,i){try{return await z(e,t,{updateSession:!0,...K(r)})}catch(e){throw r!==`absent`||n(e)?e:Ie(i,e)}}async function rs(t,n,r){let i=await R(P.readAny,n.snapshot.nodes,r,{platform:t.backend.platform});if(i.kind!==`target`)throw new e(`COMMAND_FAILED`,Se(r,[],{unique:!1}),{hint:se([])});return{predicate:`exists`,pass:!0,selector:i.selector,matches:i.matches,selectorChain:xe(r)}}async function is(t,n,r,i,a){let o=await R(P.readUnique,r.snapshot.nodes,a,{platform:t.backend.platform},{onResolved:(e,t)=>fi(e,t,n.expectedResolvedTarget,`is`)});if(o.kind!==`target`)throw new e(`COMMAND_FAILED`,Se(a,[],{unique:!0}),{command:`is`,reason:je.selectorNotFound,predicate:i,selector:a,hint:se([])});let s=_e({predicate:i,node:o.node,visibility:v(r.snapshot.nodes),expectedText:n.expectedText,platform:t.backend.platform});if(!s.pass)throw new e(`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:xe(a),node:o.node,preActionNodes:r.snapshot.nodes}}const as=async(e,t)=>await ts(e,{...t,predicate:`visible`,selector:t.target.selector}),os=async(e,t)=>await ts(e,{...t,predicate:`hidden`,selector:t.target.selector}),ss=async(t,n)=>{if(!t.backend.performGesture)throw new e(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await Ni(t,n,n.gesture.intent);let r=await Ga(t,n),i=Ke(n.gesture,r,t.backend.platform),a=L(await t.backend.performGesture(F(t,n),i)),o=ls(i.pointers,0),s=ls(i.pointers,-1);return{kind:n.gesture.intent,durationMs:i.durationMs,pointerCount:i.topology===`single`?1:2,from:o,to:s,...a?{backendResult:a}:{},...T(us(n.gesture,o,s))}},cs=async(e,t)=>{let n=t.gesture;return n.intent===`drag`?await Xa(e,{...t,gesture:n}):await ss(e,{...t,gesture:n})};function ls(t,n){let r=t.map(e=>n===0?e.samples[0]?.point:e.samples.at(-1)?.point);if(r.some(e=>e===void 0))throw new e(`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 us(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:qo,get:Jo,getText:Yo,getAttrs:Xo,is:ts,isVisible:as,isHidden:os,wait:Go,waitForText:Ko},Z={click:ro,press:no,fill:io,focus:Ka,longPress:qa,hover:Ja,gesture:cs,settleObservation:ya};function ds(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 fs(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 Q=[0,187,255,255];function ps(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||ms(e,n.rect)}function ms(e,t){let n=hs(t);if(n==null)return;let r=_s(n.x,0,e.width-1),i=_s(n.y,0,e.height-1),a=_s(n.right,0,e.width-1),o=_s(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)gs(e,n,i+t,Q),gs(e,n,o-t,Q);for(let n=i;n<=o;n+=1)gs(e,r+t,n,Q),gs(e,a-t,n,Q)}}function hs(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 gs(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 _s(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}const vs=[{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 ys(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(!Ss(t,a,e))continue;let c=0,l=xs(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=bs({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function bs(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 vs){let o=s+e.x,u=c+e.y;if(!Cs(o,u,i,a))continue;let d=u*i+o;Ss(t,n,d)&&(l=xs(r,n,l,d))}return l}function xs(e,t,n,r){return t[r]=1,e[n]=r,n+1}function Ss(e,t,n){return e[n]===1&&t[n]!==1}function Cs(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}function ws(e,t){return e.flatMap(e=>Ts(e,t.baseline.width,t.baseline.height)?Es(e,t,Ms(t.baseline.height)):[e])}function Ts(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=js(n)&&r>=t*.35}function Es(e,t,n){let r=As(e,ks(Os(Ds(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])=>Ns(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function Ds(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 ks(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 As(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 js(e){return Math.max(48,Math.round(e*.07))}function Ms(e){return Math.max(24,Math.round(e*.03))}function Ns(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??=Ps(t,a),Fs(i,e,t,a,r.baseline,r.current))}return i}function Ps(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 Fs(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 Is=2.5;function Ls(e){let t=Rs(e);return ws(t.length<=2e3?Vs(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)=>Ws(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function Rs(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return ys({mask:t,width:i,height:a,hooks:{create:e=>zs(e,i),visit:(e,t)=>Bs(e,t,i,n,r)}})}function zs(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 Bs(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 Vs(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=>Hs(e,r,t));if(!e){n.push({...r});continue}Us(e,r)}return n}function Hs(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 Us(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 Ws(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=Gs(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=Gs(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height;return{index:t,rect:r,normalizedRect:hn({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:Js(r,n.width,n.height),size:Ys(s,n.totalPixels),location:Ks(i,n.width,n.height),averageBaselineColorHex:Zs(a),averageCurrentColorHex:Zs(o),baselineLuminance:Math.round(Xs(a)),currentLuminance:Math.round(Xs(o)),dominantChange:qs(a,o)}}function Gs(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function Ks(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 qs(e,t){let n=Xs(t)-Xs(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 Js(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*Is?`horizontal-band`:e.height>=e.width*Is?`vertical-band`:`compact`}function Ys(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function Xs(e){return e.r*.2126+e.g*.7152+e.b*.0722}function Zs(e){return`#${Qs(e.r)}${Qs(e.g)}${Qs(e.b)}`}function Qs(e){return e.toString(16).padStart(2,`0`)}function $(e){return Math.round(e*100*100)/100}const $s=Math.sqrt(3*255**2);async function ec(e,t,n={}){await tc(e,`Baseline image not found`),await tc(t,`Current screenshot not found`);let r=n.outputPath,[i,a]=await Promise.all([A.readFile(e),A.readFile(t)]),[o,s]=await Promise.all([tt(i,`baseline screenshot`),tt(a,`current screenshot`)]);nc(o.width,o.height,`baseline screenshot`,n.maxPixels),nc(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 rc(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*$s,{diffData:d,diffMask:f,differentPixels:p}=await nt({baselineData:o.data,currentData:s.data,width:o.width,height:o.height,maxColorDistance:u}),m=p>0?Ls({diffMask:f,baseline:o,current:s,totalPixels:l,differentPixels:p}):[];if(p>0&&r){let e=new it.PNG({width:o.width,height:o.height});e.data=d,ps(e,m),await A.mkdir(st.dirname(r),{recursive:!0}),await A.writeFile(r,await rt(e))}else await rc(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 tc(t,n){try{await A.access(t)}catch{throw new e(`INVALID_ARGS`,`${n}: ${t}`)}}function nc(t,n,r,i){if(i==null||i<=0)return;let a=t*n;if(!(a<=i))throw new e(`INVALID_ARGS`,`${r} is ${a} pixels, which exceeds the configured maxImagePixels limit of ${i}`)}async function rc(e){if(e)try{await A.unlink(e)}catch(e){if(!ic(e,`ENOENT`))throw e}}function ic(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function ac(e,t){return e.map(e=>{let n=oc(e,t);return n.length>0?{...e,currentOverlayMatches:n}:e})}function oc(e,t){let n=ne(e.rect);return t.map(t=>{let r=t.overlayRect,i=gn(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:sc(i/ne(r)),regionCoveragePercentage:sc(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 sc(e){return Math.round(e*100*100)/100}async function cc(t,n,i){if(n.kind===`path`&&!t.policy.allowLocalInputPaths)throw new e(`INVALID_ARGS`,`Local ${i.field??`input`} paths are not allowed by command policy`);try{return await t.artifacts.resolveInput(n,i)}catch(e){throw r(e)}}async function lc(t,n,i){if(n?.kind===`path`&&!t.policy.allowLocalOutputPaths)throw new e(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await t.artifacts.reserveOutput(n,{...i,visibility:i.visibility??`client-visible`,requestedClientPath:n?.kind===`downloadableArtifact`?n.clientPath??i.requestedClientPath:i.requestedClientPath})}catch(e){throw r(e)}}async function uc(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw r(e)}}const dc=async(t,n)=>{if(!n.baseline)throw new e(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let r=fc(n.threshold),i=n.current??{kind:`live`};if(n.overlayRefs&&!bc(i))throw new e(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let a=await cc(t,n.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let e;bc(i)?(s=await pc(t,n),e=s.path):(o=await cc(t,i,{usage:`diff screenshot current`,field:`current`}),e=o.path),c=n.out?await lc(t,n.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await ec(a.path,e,{threshold:r,outputPath:c?.path,maxPixels:t.policy.maxImagePixels});bc(i)&&(u=await mc(t,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 fc(t){if(t==null||t===``)return .1;let n=Number(t);if(Number.isNaN(n)||n<0||n>1)throw new e(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return n}async function pc(e,t){let n=await uc(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await hc(e,t,n.path,gc(t))}catch(e){throw await n.cleanup(),e}return n}async function mc(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await yc(n),r;let a=await lc(e,_c(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await hc(e,t,a.path,{overlayRefs:!0,...gc(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:ac(r.regions,n.overlayRefs)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function hc(t,n,r,i={}){if(!t.backend.captureScreenshot)throw new e(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await t.backend.captureScreenshot({session:n.session,requestId:n.requestId,signal:n.signal??t.signal,metadata:n.metadata},r,i)??{}}function gc(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function _c(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:vc(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:vc(e.out.clientPath)}:{},...e.out.fileName?{fileName:vc(e.out.fileName)}:{}}}function vc(e){let t=st.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function yc(e){try{await A.unlink(vc(e))}catch(e){if(!xc(e,`ENOENT`))throw e}}function bc(e){return e.kind===`live`}function xc(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}const Sc=async(t,n)=>{if(!t.backend.captureScreenshot)throw new e(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);c(n);let r=await lc(t,n.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),i;try{await t.backend.captureScreenshot({session:n.session,requestId:n.requestId,appId:n.appId,appBundleId:n.appBundleId,signal:n.signal??t.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 $e(r.path,n.scale),i=await r.publish()}catch(e){throw await r.cleanup?.(),e}return{path:r.path,...i?{artifacts:[i]}:{},...T(`Saved screenshot: ${r.path}`)}};function Cc(e){let{nodes:n,backend:r,snapshotRaw:i}=e;if(i||!t(r))return{partial:!1,visibleNodeCount:n.length,totalNodeCount:n.length,reasons:[]};let a=Be(n),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:n.length,reasons:[...o]}}const wc=`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 Tc(e){return e?.systemSurfaceOnly===!0?wc:void 0}function Ec(e,t){return e.presentationKey?e:{...e,presentationKey:s(t)}}function Dc(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||!kc(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 kc(e,t){return e.truncated===t.truncated&&e.nodes.length===t.nodes.length&&e.nodes.every((e,n)=>jc(e,t.nodes[n]))}const Ac=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 jc(e,t){return Ac.every(n=>e[n]===t[n])&&Mc(e.rect,t.rect)&&Nc(e.presentationHints,t.presentationHints)&&Nc(e.actions,t.actions)}function Mc(e,t){return!e||!t?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function Nc(e,t){return!e||!t?e===t:e.length===t.length&&e.every((e,n)=>e===t[n])}const Pc=async(e,t)=>{let n=await Ic(e,t),r=Dc({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(Rc(t.session,n));let i=Bc(n.snapshot);return d(n.snapshot,{nodes:n.snapshot.nodes,...i===void 0?{}:{truncated:i},visibility:Cc({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}:{},...n.snapshot.keyboard?{keyboard:n.snapshot.keyboard}:{},...zc(n)})},Fc=async(e,t)=>{let n=await Ic(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,a=Rc(t.session,n);if(!i){let t=Ji(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=qi(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 Ic(t,n){if(!t.backend.captureSnapshot)throw new e(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=n.session??`default`,i=await t.sessions.get(r),a=await t.backend.captureSnapshot({session:r,requestId:n.requestId,appId:i?.appId,appBundleId:i?.appBundleId,signal:n.signal??t.signal,metadata:n.metadata},{interactiveOnly:n.interactiveOnly,depth:n.depth,scope:n.scope,raw:n.raw,customActions:n.customActions}),o=Lc(a,t),s=d(o,Ec(o,n)),c=l(a),u=I(t);return{snapshot:s,result:a,session:i,annotations:c,warnings:Vc({result:a,annotations:c,snapshot:s,options:n,session:i,capturedAt:s.createdAt??u,runtimeNow:u})}}function Lc(e,t){return e.snapshot?e.snapshot:{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,createdAt:I(t),...e.keyboard?{keyboard:e.keyboard}:{}}}function Rc(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 zc(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 Bc(e){return e.truncated===void 0?e.backend!==`xctest`||e.producer===void 0?!1:ot(e.producer)===`unavailable`&&void 0:e.truncated}function Vc(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...Qe(e.annotations.quality,e.snapshot.nodes)),t.push(...et(Bc(e.snapshot))),t.push(...Kc(e)),e.annotations.quality||(t.push(...Uc(e)),t.push(...Gc(e.snapshot.nodes)));let n=ht(e.snapshot.nodes);n&&t.push(n);let r=Hc(e.annotations);r&&t.push(r);let i=qc(e);return i&&t.push(i),t.push(...Zc(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function Hc(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return wc}function Uc(e){if(e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1)return[];let t=e.snapshot.nodes[0];return Wc(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 Wc(e){return e?x(e.type??``)===`application`:!1}function Gc(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 Kc(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 qc(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&Jc(t,e.snapshot)&&Yc(t,e.capturedAt,e.runtimeNow)&&Qc(t.nodes.length,e.snapshot.nodes.length))return Xc}function Jc(e,t){return e.presentationKey===void 0||t.presentationKey===void 0||e.presentationKey===t.presentationKey}function Yc(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const Xc=`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 Zc(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`?[Xc]:[]}function Qc(e,t){return e<12?!1:t<=Math.floor(e*.2)}const $c={screenshot:Sc,diffScreenshot:dc,snapshot:Pc,diffSnapshot:Fc};function el(e){return Zn($c,e)}export{sn as A,wn as C,dn as D,pn as E,dt as F,gt as M,ut as N,fn as O,lt as P,En as S,M as T,Bn as _,fs as a,Rn as b,ar as c,Zn as d,L as f,zn as g,P as h,cc as i,on as j,j as k,R as l,Jn as m,Tc as n,ds as o,F as p,lc as r,kr as s,el as t,or as u,Un as v,xn as w,Ln as x,Wn as y};
+import{D as e,E as t,F as n,O as r,_ as i,b as a,g as o,h as s}from"./sdk-contracts.js";import{m 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{An as m,Ar as h,Bn as g,Dn as _,Er as v,Gn as y,Hr as b,Ir as x,Jn as ee,Kn as te,Ln as ne,Mr as re,Nn as ie,Nr as ae,On as oe,Pr as se,Rn as ce,Rr as le,Sn as ue,Tn as de,Vn as fe,Wn as pe,Wr as me,Xn as he,bn as S,cr as ge,hr as _e,jr as ve,mr as ye,pr as be,qn as C,qr as xe,un as Se,wn as Ce,xn as we,xr as Te,zn as Ee,zr as De}from"./sdk-batch.js";import{n as Oe}from"./snapshot-scope.js";import{r as w}from"./success-text.js";import{a as ke,c as Ae,d as je,f as Me,i as Ne,m as Pe,n as Fe,o as Ie,p as Le,r as Re,t as ze,u as Be}from"./absence-observation-errors.js";import{n as Ve,t as He}from"./mobile-snapshot-semantics.js";import{a as Ue,n as We,o as Ge,t as Ke}from"./react-native-overlay.js";import{r as T}from"./diagnostics.js";import{t as qe}from"./timeouts.js";import"./diagnostics2.js";import"./retry.js";import{i as E,n as D,t as Je}from"./rect-center.js";import{a as Ye,n as Xe,t as Ze}from"./gesture-plan.js";import{n as Qe,o as $e,r as et}from"./android-system-chrome.js";import{c as tt,n as nt,o as rt,r as it,s as at}from"./quality-warnings.js";import{a as ot,n as st,o as ct}from"./png-worker-client.js";import{r as lt}from"./png.js";import{i as ut}from"./ios-system-surface.js";import{n as dt}from"./ios-snapshot-acquisition.js";import ft from"node:path";import{promises as O}from"node:fs";import{createHash as pt}from"node:crypto";function mt(e){let t=new Map;for(let n of e)t.set(n.index,n);return t}function ht(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=C(e);r.push({role:n.role,...n.label===void 0?{}:{label:n.label}}),a=e}return{chain:r,broken:!1}}function gt(e,t,n,r){return e.filter(e=>{if(!te(C(e),n))return!1;let i=ht(e,t,Math.max(r.length,1));return!i.broken&&y(i.chain,r)})}const _t=/\b(logbox|redbox|reload js|copy stack|component stack|call stack|runtime error|open debugger to view warnings)\b/,vt=[/\b[\w.$<>/-]+\.(?:tsx?|jsx?):\d+(?::\d+)?\b/,/\b[\w.$<>/-]+\.(?:tsx?|jsx?)\s+\(\d+:\d+\)/],yt=new Set([`x`,`×`,`✕`,`✖`,`⨯`]);function bt(e){if(xt(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 xt(e){let t=St(e),n=t.detected?Ct(t):null;return{detected:t.detected,dismissNodes:t.dismissNodes,minimizeNodes:t.minimizeNodes,collapsedNodes:t.collapsedNodes,primaryAction:n}}function St(e){let t=e.map(wt).join(`
+`).toLowerCase(),n=Lt(e,jt),r=Lt(e,Ge),i=Lt(e,We,Ft),a=Lt(e,At),o=Et(t),s=Dt(t);return{dismissNodes:n,minimizeNodes:r,collapsedNodes:i,detected:kt({text:t,hasReactNativeStackFrame:o,hasOverlayControl:Ot(t,n,r),hasControllessRedBoxText:s,collapsedNodes:i,openDebuggerWarningNodes:a})}}function Ct(e){let t=Rt(e.dismissNodes);if(t)return Vt(t,Ht(t));let n=Ut(e.collapsedNodes.filter(It));return n?.rect?{action:`close-collapsed-banner`,point:Jt(n),rect:n.rect,ref:n.ref,label:Xt(n)}:null}function wt(e){return[e.label,e.value,e.identifier,e.type,e.role].filter(Boolean).join(` `)}function Tt(e){return _t.test(e)}function Et(e){return vt.some(t=>t.test(e))}function Dt(e){return/\buncaught\b/.test(e)&&/unable to download asset/.test(e)}function Ot(e,t,n){return t.length>0||n.length>0||/\b(reload js|copy stack)\b/.test(e)}function kt(e){return e.collapsedNodes.length>0||e.openDebuggerWarningNodes.length>0||e.hasControllessRedBoxText||e.hasOverlayControl&&(Tt(e.text)||e.hasReactNativeStackFrame)}function At(e){return e.includes(`open debugger to view warnings`)||/^!,\s+open debugger\b/.test(e)}function jt(e){return Ue(e)||Mt(e)||Nt(e)}function Mt(e){return/^close(?:\s*\([^)]*\))?$/i.test(e)}function Nt(e){return yt.has(e)}function Pt(e){return/^!,\s+/.test(e)}function Ft(e){return!e.rect||e.rect.height<=180}function It(e){let t=Xt(e)?.trim().toLowerCase()??``;return(At(t)||Pt(t))&&Ke(e)}function Lt(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 Rt(e){return Wt(e,Bt)}function zt(e){let t=[e.type,e.role,e.subrole].join(` `).toLowerCase();return/\b(button|menuitem|link)\b/.test(t)}function Bt(e){return[Kt(zt(e)),Kt(e.hittable),-(e.rect?xe(e.rect):1/0)]}function Vt(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:Xt(e)}}function Ht(e){let t=Xt(e)?.trim().toLowerCase();return t&&Ue(t)?`dismiss`:`close`}function Ut(e){return Wt(e,Gt)}function Wt(e,t){let n=e.filter(e=>e.rect);return n.length===0?null:n.sort((e,n)=>qt(t(n),t(e)))[0]??null}function Gt(e){return[Kt(e.hittable),e.rect?.width??0,e.rect?.y??0]}function Kt(e){return+(e===!0)}function qt(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 Jt(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(Yt(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 Yt(e,t,n){return Math.min(n,Math.max(t,e))}function Xt(e){return e.label??e.value??e.identifier}const Zt=3500;function Qt(e){return[e.action,...e.positionals].join(` `).trim()}function $t(e,t){return`${Qt({action:e,positionals:t})} produced no visible change: the tree still matches its pre-gesture state. Either the container is already at its edge, or it ignores synthesized scrolls — a raw drag moves such lists: swipe x1 y1 x2 y2 (start inside the list).`}function en(e){return`The surface was still changing after ${Qt(e)} when this was read, so an element missing from it may still be on screen. Read again before treating it as absent.`}function tn(e){let{needsBaselineDistrust:t,baselineSignature:n,quietSignature:r,elapsedMs:i,distrustCapMs:a}=e;return!t||!n?.length||e.classifyBaselineEvidence(n,r)!==`unchanged`?`trust`:i<a?`distrust`:`accept-stale`}async function nn(e){let{pending:t,needsBaselineDistrust:n,hooks:r}=e,i=Date.now(),a=1,o=await rn(r,e.initial),s=t.baselineSignature,c=t.baselineBackend,l=!1,u=1500,d=!1;for(;a<2||Date.now()-i<u;){await qe(200),a+=1;let e=await rn(r);if(d=r.signaturesStable(o.signature,e.signature),d){let d=Date.now()-i;if(s&&c!==e.backend){T({level:`debug`,phase:`post_gesture_snapshot_baseline_rebased`,data:{action:t.action,from:c,to:e.backend,attempts:a}}),s=e.signature,c=e.backend,l=!0,o=e;continue}let f=tn({needsBaselineDistrust:n,baselineSignature:s,quietSignature:e.signature,elapsedMs:d,distrustCapMs:Zt,classifyBaselineEvidence:r.classifyBaselineEvidence});if(f===`distrust`){u=Zt,o=e;continue}return an(f,t.action,a,d),on(f,t,e,r,l)}o=e}return T({level:`warn`,phase:`post_gesture_snapshot_stabilization_timeout`,data:{action:t.action,attempts:a,durationMs:Date.now()-i,lastPairAgreed:d}}),d?{value:o.value}:{value:o.value,unsettledGesture:{action:t.action,positionals:t.positionals}}}async function rn(e,t){let n=t??await e.capture();return{value:n,...e.readSurface(n)}}function an(e,t,n,r){if(e===`accept-stale`){T({level:`warn`,phase:`post_gesture_snapshot_stale_accept`,data:{action:t,attempts:n,durationMs:r,matchedPreGestureBaseline:!0}});return}T({level:n>2?`info`:`debug`,phase:`post_gesture_snapshot_stabilized`,data:{action:t,attempts:n,durationMs:r}})}function on(e,t,n,r,i){if(e!==`accept-stale`)return{value:n.value};let a=t.baselineSignature;return a!==void 0&&r.surfacesIdentical(a,n.signature)?{value:n.value,gestureNoEffect:{action:t.action,positionals:t.positionals}}:(T({level:`info`,phase:`post_gesture_no_effect_vetoed`,data:{action:t.action,backend:n.backend,...i?{reason:`baseline_rebased`}:{reason:`surface_divergence`,...a===void 0?{}:r.summarizeDivergence(a,n.signature)}}}),{value:n.value})}const sn=new Set([`textfield`,`securetextfield`,`textview`,`textarea`,`searchfield`,`edittext`]),cn={strippedIndexes:new Set,refs:new Set};function ln(e){let t=new Set(e.filter(e=>x(e.type??``)===`keyboard`).map(e=>e.index));if(t.size===0)return cn;let n=new Map(e.map(e=>[e.index,e])),r=mn(e,n,t),i=new Set(r),a=Sn(e,n,r);for(let t of mn(e,n,a))i.add(t);for(let o of un(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 un(e,t,n,r,i){let a=new Set;if(n.size===0)return a;let o=fn(t,n,r);if(o.size===0)return a;let s=pn(t,r);for(let n of e)!i.has(n.index)&&!s.has(n.index)&&n.rect&&dn(n,t,o)&&a.add(n.index);return a}function dn(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 fn(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 pn(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 mn(e,t,n){let r=new Set(n);if(n.size===0)return r;for(let i of e)wn(i,t,n)&&r.add(i.index);return r}function hn(e,t){if(e.bundleId!==`com.android.systemui`)return!1;if(Qe(e))return!0;let n=new Set,r=e;for(;r?.bundleId===`com.android.systemui`&&!n.has(r.index);){if(et(r.identifier))return!0;n.add(r.index),r=r.parentIndex===void 0?void 0:t.get(r.parentIndex)}return!1}function gn(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:_n(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?cn:{strippedIndexes:o,refs:s}}function _n(e,t,n){return new Set(e.filter(e=>!n.has(e.index)&&hn(e,t)).map(e=>e.index))}function vn(e,t){let n=ln(e),r=gn(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 yn(e,t){let{strippedIndexes:n}=vn(e,t);return n.size===0?e:e.filter(e=>!n.has(e.index))}function bn(e,t){return vn(e,t).refs}function xn(e){return ln(e).refs}function Sn(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=Cn(n,t);i!==void 0&&r.add(i)}for(let i of r){let a=new Set([i]);e.some(e=>sn.has(x(e.type??``))&&!n.has(e.index)&&wn(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(x(n.type??``)===`window`)return n.index;n=typeof n.parentIndex==`number`?t.get(n.parentIndex):void 0}}function wn(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}const k={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`},Tn=`replay_target_guard_mismatch`,En=k.landmarkIdentityMismatch;function Dn(e,t){return e.find(e=>Oe(e,t))??null}function A(e,t){let n=re(e);return n&&se(n)?n:On(e,t)}function On(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=re(e);if(!t||!se(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 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 j(e){return[e.type,e.role,e.subrole].map(e=>x(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(!j(n)||!e.every(e=>e===n||!j(e)))return null;let r=D(n.rect);return r&&e.every(e=>Ln(D(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||!h(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&&E(r.rect)?{node:r,reason:`same-rect-descendant`}:null}function Un(e){return j(e)&&e.rect&&E(e.rect)?{node:e,reason:`semantic-target`}:null}function Wn(e,t,n){let r=Gn(e,t,n);return!r?.rect||f(r)||!E(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?De(e,t,n.nodesByIndex,e=>r(e)?e:null):le(e,t,r)}function Kn(e,t,n){let r=D(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=D(e.rect);return t?Je(t,r):!1});if(t.length!==1)break;i=t[0]}return i===t?null:i}function qn(e,t,n,r){let i=D(e.rect),a=D(t.rect);if(!i||!a)return!1;if(Jn(t)&&!Je(i,a))return!0;let o=ve(n,i,r?.viewportRootRects);return!o||!Xn(a,o)?!1:!Je(i,a)}function Jn(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 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(h(i)){let e=D(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}function Zn(t,n,r,i){if(!Number.isFinite(t)||!Number.isInteger(t)||t<r||t>i)throw new e(`INVALID_ARGS`,`${n} must be an integer between ${r} and ${i}`);return t}function Qn(t,n,r){let i=Number(t[0]),a=Number(t[1]);if(Number.isNaN(i)||Number.isNaN(a))throw new e(`INVALID_ARGS`,n,r);return{x:i,y:a}}function $n(e){return{backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??er(),policy:e.policy??ir(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal}}function er(e=[]){let t=new Map(e.map(e=>[e.name,tr(e)]));return{get:e=>tr(t.get(e)),set:e=>{t.set(e.name,tr(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>tr(e))}}function tr(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:nr(e.metadata)}:{}}}function nr(e){try{return structuredClone(e)}catch{return{...e}}}function rr(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,...e}}function ir(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,...e}}const ar={defaultTimeoutMs:1e4,intervalMs:300},M={promotedTarget:{resolution:S.act,occlusion:`exclude-and-refuse`,offscreen:`refuse`,promotion:`hittable-ancestor`,poll:`none`},resolvedTarget:{resolution:S.act,occlusion:`exclude-and-refuse`,offscreen:`refuse`,promotion:`none`,poll:`none`},coveredDiagnosis:{resolution:S.actCoveredDiagnosis,occlusion:`refuse`,offscreen:`ignore`,promotion:`none`,poll:`none`},readText:{resolution:S.readText,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},readUnique:{resolution:S.readUnique,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},readAny:{resolution:S.readAny,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`},findWait:{resolution:S.readAny,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:ar},wait:{resolution:S.wait,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:ar},readList:{resolution:S.readList,occlusion:`ignore`},findAct:{resolution:S.findAct,occlusion:`refuse`,offscreen:`ignore`,promotion:`hittable-ancestor-below-root`,poll:`none`},cropTarget:{resolution:S.cropTarget,occlusion:`ignore`,offscreen:`ignore`,promotion:`none`,poll:`none`}},or=new WeakMap;function sr(e,t){lr(e)&&or.set(e,t)}function cr(e){return lr(e)?or.get(e):void 0}function lr(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 ur(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}function dr(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 fr(e,t,n,r){let i=n.ambiguity;if(i===`first-match`||i===`reject-candidates`){let a=de(e,t,{...r,requireRect:n.requireRect});return!a||a.matchedNodes.length===0?{kind:`none`}:i===`first-match`?mr(a):a.matchedNodes.length>1?pr(a):mr(a)}let a=_(e,t,{...r,...we({ambiguity:i,requireRect:n.requireRect})});return a.firstMatch?a.resolution?{kind:`resolved`,resolution:a.resolution,matchedNodes:a.firstMatch.matchedNodes}:pr(a.firstMatch):{kind:`none`}}function pr(e){return{kind:`ambiguous`,selector:e.selector.raw,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}function mr(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 hr(e,t,n){let r=de(e,Te(t),n);return r?{...r,selector:r.selector.raw}:null}function gr(e,t,n,r){let i=fr(e,Te(t),n,r);return i.kind===`resolved`?{...i,resolution:{...i.resolution,selector:i.resolution.selector.raw}}:i}async function I(e,t,n,r,i={}){let a=gr(xr(e,t),n,e.resolution,r);if(a.kind===`none`)return{kind:`none`};if(a.kind===`resolved`)return await vr(e,t,{node:a.resolution.node,selector:a.resolution.selector,selectorIndex:a.resolution.selectorIndex,matches:a.resolution.matches,matchedNodes:a.matchedNodes},i);let o=_r(t,a);return o?await vr(e,t,o,i):a}function _r(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 vr(e,t,n,r){let i=await br(e,t,n.node,r);return i.kind===`occluded`?{kind:`occluded`,node:i.node,selector:n.selector}:{...n,kind:`target`,node:i.node}}function yr(e,t,n,r){let i=xr(e,t);return{candidates:i,list:hr(i,n,{...r,requireRect:e.resolution.requireRect})}}async function br(e,t,n,r={}){r.onResolved?.(n,t);let i=Sr(e.promotion,t,n);return e.occlusion!==`ignore`&&(i.covered||f(i.node))?{kind:`occluded`,node:i.node}:{kind:`target`,node:await Cr(e,t,i.node,r)}}function xr(e,t){return e.occlusion===`exclude-and-refuse`?t.filter(e=>!f(e)):t}function Sr(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 Cr(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 wr(e){if(e.poll===`none`)throw Error(`selector pipeline row resolves against one capture and declares no poll budget`);return e.poll}function Tr(e){return e.hittable===!0||j(e)}function Er(e,t){let n=fe(C(e),t);return n.id!==void 0||n.label!==void 0?!1:Ee(e.value)===null}function Dr(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 Or(e,t){let n=mt(t);return t.filter(t=>t.index!==e.index&&Dr(t,e,n)).sort((e,t)=>e.index-t.index)}function kr(e,t){let n=E(e.rect);return!n||!t.rect?!1:b(t.rect,n.x,n.y)}function Ar(e,t){if(!Er(e,t))return e;let n=Or(e,t);if(n.some(Tr))return e;let r=n.find(e=>C(e).label!==void 0);return!r||!kr(r,e)?e:r}function jr(e){return e===`text`||e===`label`||e===`any`}function Mr(e,t,n,r){if(!(r||e===`web`))return jr(t)?n:void 0}function Nr(t){return new e(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:t.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 Pr(t,n){let r=n??`default`,i=await t.sessions.get(r);if(!i)throw new e(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let a=i.refFrameSnapshot??i.snapshot;if(!a)throw new e(`INVALID_ARGS`,`No snapshot in session. Run snapshot first.`);return{sessionName:r,session:i,snapshot:a}}async function L(t,n,r={updateSession:!0}){let i=t.backend.captureSnapshot;if(!i)throw new e(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let a=n.session??`default`,o=await t.sessions.get(a),s=Fr(await i(N(t,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}}),t);return(n.signal??t.signal)?.throwIfAborted(),r.updateSession&&o&&!at(s.snapshotQuality)&&await t.sessions.set({...o,snapshot:s}),{sessionName:a,session:o,snapshot:s}}function Fr(e,t){return e.snapshot?Ir(e.snapshot,e):{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,...e.quality?{snapshotQuality:e.quality}:{},createdAt:P(t)}}function Ir(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 Lr(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 Pe(n)}function Rr(t,n,r){let o=a(n);if(!o)throw new e(`INVALID_ARGS`,r.invalidRefMessage);let s=i(t,o)??(r.fallbackLabel.length>0?Dn(t,r.fallbackLabel):null);if(!s)throw new e(`COMMAND_FAILED`,r.notFoundMessage);return{ref:o,node:s}}function zr(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 Br(e){let t=Buffer.alloc(16);for(let n of e)Hr(t,Vr(n));return{digest:`ax1:${pt(`sha256`).update(t).update(`\0`).update(String(e.length)).digest(`hex`).slice(0,16)}`,nodeCount:e.length}}function Vr(e){return pt(`sha256`).update(e.type??``).update(`\0`).update(e.label??``).update(`\0`).update(e.identifier??``).digest().subarray(0,16)}function Hr(e,t){for(let n=0;n<e.length;n+=1)e[n]=(e[n]??0)^(t[n]??0)}function Ur(e){let{digest:t,nodeCount:n}=Br(e),r=e.reduce((e,t)=>t.hittable===!1?e:e+1,0),i=Wr(e);return{digest:t,nodeCount:n,interactiveNodeCount:r,...i?{foregroundApp:i}:{}}}function Wr(e){for(let t of e)if(t.bundleId)return t.bundleId;for(let t of e)if(t.appName)return t.appName}function R(e){return{nodes:e.nodes,...e.iosSystemSurfaceBundleId?{surfaceBundleId:e.iosSystemSurfaceBundleId}:{}}}function Gr(e,t){if(!e||e.surfaceBundleId===t.surfaceBundleId)return;let n={from:e.surfaceBundleId??`app`,to:t.surfaceBundleId??`app`};return{...n,disclosure:ut(n)}}function Kr(e,t){let n=Ur(e.nodes),r=Gr(t,e);if(r)return{...n,changedFromBefore:!0,surfaceChange:r};let i=t!==void 0&&n.digest!==Ur(t.nodes).digest;return{...n,changedFromBefore:i}}function qr(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 Jr(e,t,n={}){let r=D(t.rect),i=E(r??void 0);if(!r||!i)return{kind:`invalid`};let a=Yr(e,t,r);if(a.length===0)return{kind:`resolved`,point:i,strategy:`center`};let o=(n.bounds??[]).reduce((e,t)=>e?Zr(e,t):null,r),s=o?Qr(r,o,i,a):null;return s?{kind:`resolved`,point:s,strategy:`parent-owned`}:{kind:`blocked`,competitorRefs:a.map(e=>e.ref)}}function Yr(e,t,n){let r=new Map(e.map(e=>[e.index,e]));return e.filter(e=>e.index!==t.index).filter(e=>Xr(e,t,r)).filter(j).flatMap(e=>{let t=D(e.rect);if(!t||Je(t,n))return[];let r=Zr(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 Xr(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 Zr(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 Qr(e,t,n,r){let i=ri(e),a=ti(t.x,t.width,n.x,r.flatMap(({rect:e})=>[e.x,e.x+e.width]),i),o=ti(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(!b(t,s.x,s.y))return[];let c=$r(s,e,n,r,i);return c?[c]:[]})).sort(ei)[0]?.point??null}function $r(e,t,n,r,i){let a=ni(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 ei(e,t){return e.distanceSquared-t.distanceSquared||t.clearance-e.clearance||e.point.y-t.point.y||e.point.x-t.point.x}function ti(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 ni(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 ri(e){let t=Math.min(e.width,e.height);return Math.max(0,Math.min(12,Math.floor(t/2)-1))}function ii(t,n,r,i){let{candidates:a,list:o}=yr(i,t,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 e(`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=>Le(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)}}}const ai=Object.freeze({reason:`tap_keyboard_occludes_target`,hint:"The visible keyboard covers this target, so the tap would land on a key instead of on it. End editing first: tap the app's own Done/Cancel/close control, or run `keyboard enter` when submitting is what you want (`keyboard dismiss` works only when the keyboard exposes its own dismiss key). This reads the snapshot the command measured against, so if the keyboard closed since it was taken, run `snapshot -i` and retry."}),oi=new Set([`keyboard`,`key`]);function si(e){return oi.has(x(e.type??``))||p(e)}const ci=new Set([`UIKeyboardDockItemButton`,`UIAccessibilityElementKBKey`]);function li(e){return si(e)||ci.has(e.role??``)}function ui(e,t,n){return n.has(e.index)||pi(t,n,e.index).length>0}function di(e){return e!==null&&me(e)}function z(e){return e.flatMap(e=>me(e.rect)?[e.rect]:[])}function fi(e,t){let n=new Map(e.map(e=>[e.index,e.parentIndex])),r=new Set(t.map(e=>e.index)),i=new Set;for(let e of t)for(let t of pi(n,r,e.index))i.add(t);return i}function pi(e,t,n){let r=[],i=new Set,a=e.get(n);for(;typeof a==`number`&&!i.has(a);)i.add(a),t.has(a)&&r.push(a),a=e.get(a);return r}function mi(e){let t=e.map(e=>[e.x,e.x+e.width]).sort((e,t)=>e[0]-t[0]),n=t[0]?.[1]??0;for(let[e,r]of t){if(e-n>2)return!1;n=Math.max(n,r)}return!0}function hi(e){let t=Math.min(...e.anchorRects.map(e=>e.y)),n=Math.min(...e.anchorRects.map(e=>e.x)),r=Math.max(...e.anchorRects.map(e=>e.x+e.width)),i=e.viewport.y+e.viewport.height;return e.reportedBottom<i-80||r-n<=e.reportedBottom-t?null:{x:n,y:t,width:r-n,height:i-t}}function gi(e){let t=z(e.anchorNodes.filter(t=>!e.planeIndices.has(t.index)));return mi(t.length>0?t:e.anchorRects)}function _i(e){let t=e.filter(li),n=fi(e,t);return z(t.filter(e=>!n.has(e.index)))}function vi(e,t){let n=e.filter(si),r=z(n);if(r.length===0||!di(t))return null;let i=e.filter(li),a=z(i);if(a.length===0)return null;let o=hi({anchorRects:r,reportedBottom:Math.max(...a.map(e=>e.y+e.height)),viewport:t});if(!o)return null;let s=fi(e,i);return gi({anchorNodes:n,anchorRects:r,planeIndices:s})?{frame:o,controlRects:z(i.filter(e=>!s.has(e.index)))}:null}function yi(e){if(e.keyboard?.kind===`absent`)return{kind:`no-keyboard`};let t=e.keyboard?.kind===`visible`?{frame:e.keyboard.frame,controlRects:_i(e.nodes)}:vi(e.nodes,e.viewport);if(!t)return e.nodes.some(si)?{kind:`undetermined`}:{kind:`no-keyboard`};if(!e.node)return bi(e.point,t);let n=new Map(e.nodes.map(e=>[e.index,e.parentIndex])),r=new Set(e.nodes.filter(li).map(e=>e.index));return ui(e.node,n,r)?{kind:`clear`,surface:t}:b(t.frame,e.point.x,e.point.y)?{kind:`occluded`,surface:t}:{kind:`clear`,surface:t}}function bi(e,t){return t.controlRects.some(t=>b(t,e.x,e.y))?{kind:`clear`,surface:t}:b(t.frame,e.x,e.y)?{kind:`occluded`,surface:t}:{kind:`clear`,surface:t}}function xi(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`}}function Si(e){let t=e.node.rect;if(!t||!e.tapPoint)return;let n=yi({nodes:e.nodes,viewport:v(e.nodes).resolveViewport(t),point:e.tapPoint,node:e.node,...e.keyboard?{keyboard:e.keyboard}:{}});if(n.kind===`occluded`)throw Ti({label:e.label,action:e.action,ref:e.node.ref,targetRect:t,surface:n.surface})}function Ci(e){let t=yi({nodes:e.nodes,viewport:e.viewport,point:e.point,...e.keyboard?{keyboard:e.keyboard}:{}});if(t.kind===`occluded`)return wi(e.point,t.surface)}function wi(e,t){return`(${e.x}, ${e.y}) is behind the visible keyboard, so this tap lands on the keyboard rather than anything under it (${ai.reason}; keyboard frame ${Math.round(t.frame.y)}..${Math.round(t.frame.y+t.frame.height)}). `+ai.hint}function Ti(t){return new e(`COMMAND_FAILED`,`${t.label} is behind the visible keyboard and cannot ${xi(t.action)} safely`,{...ai,ref:`@${t.ref}`,rect:t.targetRect,keyboardFrame:t.surface.frame})}function Ei(t,n,r,i,a){if(!r)return;let o=C(t),s=ee(t,n);if(!(pe(o,r.identity)&&he(s,r.structural)))throw new e(`COMMAND_FAILED`,`${i} resolved to a different element than replay verification isolated; the action was not sent`,{reason:Tn,observed:o,observedStructural:s,expected:r.identity,expectedStructural:r.structural,...a?{targetRole:a}:{}})}async function B(e,t,n){return await qi(e,t,n.action),t.target.kind===`point`?await Oi(e,t,t.target,n):t.target.kind===`ref`?await Mi(e,t,t.target,n):await Ni(e,t,t.target,n)}async function Di(e,t,n){let r=(await e.sessions.get(t.session??`default`))?.snapshot,i=r?.nodes;if(!i)return;let a={x:n.x,y:n.y},o=v(i).resolveViewport({x:a.x,y:a.y,width:0,height:0});return o&&!b(o,a.x,a.y)?`Coordinates (${a.x}, ${a.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.`:Ci({nodes:i,point:a,viewport:o,...r?.keyboard?{keyboard:r.keyboard}:{}})}async function Oi(e,t,n,r){let i=await Di(e,t,n);if(!r.captureEvidenceBaseline)return{kind:`point`,point:{x:n.x,y:n.y},...i?{warning:i}:{}};let a=await ki(e,t);return{kind:`point`,point:{x:n.x,y:n.y},...a?{preAction:a}:{},...i?{warning:i}:{}}}async function ki(e,t){try{return R((await V(e,t,!0)).snapshot)}catch{return}}function Ai(t,n){let r=a(t.ref);if(!r)throw new e(`INVALID_ARGS`,`Invalid ref: ${t.ref}`);let i=a(n.ref),o=n.node.ref?a(n.node.ref):null;if(i!==r||o!==r||!n.nodes.includes(n.node))throw new e(`COMMAND_FAILED`,`Internal find target provenance does not match the interaction ref`);return{tree:{nodes:n.nodes,...n.iosSystemSurfaceBundleId?{surfaceBundleId:n.iosSystemSurfaceBundleId}:{}},...n.keyboard?{keyboard:n.keyboard}:{},resolved:Ri(r,n.node,`exact`)}}async function ji(e,t,n){let r=await Yi(e,t,n);return{tree:R(r.snapshot),...r.snapshot.keyboard?{keyboard:r.snapshot.keyboard}:{},resolved:r.resolved}}async function Mi(e,t,n,r){let{tree:i,keyboard:o,resolved:s}=r.preresolvedTarget?Ai(n,r.preresolvedTarget):await ji(e,t,n),c=i.nodes,{node:l,tapPoint:u}=await Gi({policy:r.pipeline,nodes:c,...o?{keyboard:o}:{},node:s.node,action:r.action,label:`Ref ${n.ref}`,hooks:{onResolved:(e,t)=>Fi(e,t,r),offscreen:async(i,a)=>await ta(e,t,i,a,n.ref,r)},resolveTapPoint:e=>Qi(e,c,{invalidMessage:`Ref ${n.ref} not found or has invalid bounds`,blockedTargetLabel:`Ref ${n.ref}`,blockedTargetDetails:{ref:`@${a(n.ref)??e.ref}`}})});return{kind:`ref`,point:u,target:{kind:`ref`,ref:`@${s.ref}`},...Hi(e,l,i,r.action,s.resolution)}}async function Ni(e,t,n,r){let i=n.selector,a=await V(e,t,r.requireInteractive),o=ii(a.snapshot.nodes,i,e.backend.platform,r.pipeline);if((!o||!o.node.rect)&&r.requireInteractive&&(a=await V(e,t,!1),o=ii(a.snapshot.nodes,i,e.backend.platform,r.pipeline)),!o||!o.node.rect)throw await Pi({runtime:e,nodes:a.snapshot.nodes,selectorExpression:i,action:r.action,resolved:o});let s=o,{node:c,tapPoint:l}=await Gi({policy:r.pipeline,nodes:a.snapshot.nodes,...a.snapshot.keyboard?{keyboard:a.snapshot.keyboard}:{},node:s.node,action:r.action,label:`Selector ${s.selector}`,hooks:{onResolved:(e,t)=>Fi(e,t,r),offscreen:async(n,i)=>await ea(e,t,n,i,s.selector,r)},resolveTapPoint:e=>Qi(e,a.snapshot.nodes,{invalidMessage:`Selector ${o.selector} resolved to invalid bounds`,blockedTargetLabel:`Selector ${i}`,blockedTargetDetails:{selector:i}})});return{kind:`selector`,point:l,target:{kind:`selector`,selector:o.selector},...Hi(e,c,R(a.snapshot),r.action,Bi(o,a.snapshot.nodes))}}async function Pi(t){let{runtime:n,nodes:r,selectorExpression:i,action:a,resolved:o}=t,s=await I(M.coveredDiagnosis,r,i,{platform:n.backend.platform});if(s.kind===`occluded`)return Ki({label:`Selector ${s.selector}`,node:s.node,action:a,selector:s.selector});let c=o?.diagnostics??[];return new e(`COMMAND_FAILED`,Ce(i,c,{unique:!0}),{reason:Ne.selectorNotFound,hint:oe(c)})}function Fi(e,t,n){Ei(e,t,n.expectedResolvedTarget,n.action,n.replayTargetRole)}const Ii={source:`ref`,phase:`pre-action`,kind:`exact`},Li={source:`ref`,phase:`pre-action`,kind:`label-fallback`};function Ri(e,t,n){return{ref:e,node:t,resolution:n===`exact`?Ii:Li}}const zi={source:`runtime`,phase:`pre-action`,kind:`unique`};function Bi(e,t){return e.disambiguation?{source:`runtime`,phase:`pre-action`,kind:`disambiguated`,matchCount:e.disambiguation.matchCount,winnerDiagnostic:Vi(e.node,t),tiebreak:e.disambiguation.tiebreak,alternatives:e.disambiguation.alternatives.slice(0,5).map(e=>Vi(e,t))}:zi}function Vi(e,t){let n=x(e.type??``),r=A(e,t);return{diagnosticRef:`diag-${e.ref}`,...n?{role:zr(n,256)}:{},...r===void 0?{}:{label:zr(r,256)}}}function Hi(e,t,n,r,i){let a=n.nodes;return{node:t,selectorChain:ce(t,e.backend.platform,{action:r===`fill`?`fill`:`click`,nodes:a}),refLabel:A(t,a),...Wi(t,r),preAction:n,resolution:i,...Ui(e,t,a,r)}}function Ui(e,t,n,r){if(r!==`click`&&r!==`press`)return{};let i=Ar(t,n);return i===t?{}:{recordingTarget:{node:i,selectorChain:ce(i,e.backend.platform,{action:`click`,nodes:n}),refLabel:A(i,n)}}}function Wi(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 Gi(e){let t=await br(e.policy,e.nodes,e.node,e.hooks);if(t.kind===`occluded`)throw Ki({label:e.label,node:t.node,action:e.action});let n=e.resolveTapPoint(t.node);return Si({nodes:e.nodes,node:t.node,action:e.action,label:e.label,...e.keyboard?{keyboard:e.keyboard}:{},tapPoint:n}),{node:t.node,tapPoint:n}}function Ki(t){return new e(`COMMAND_FAILED`,`${t.label} is covered by another visible element and cannot ${xi(t.action)} safely`,{hint:`Use a different visible target, scroll it clear of the overlay, or inspect with snapshot/screenshot before retrying.`,...t.selector?{selector:t.selector}:{},ref:`@${t.node.ref}`,interactionBlocked:t.node.interactionBlocked})}async function V(t,n,r){if(!t.backend.captureSnapshot)throw new e(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let i=n.session??`default`,a=await t.sessions.get(i);if(!a)throw new e(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let o=await t.backend.captureSnapshot(N(t,n),{interactiveOnly:r,includeRects:!0}),s=o.snapshot??{nodes:o.nodes??[],truncated:o.truncated,backend:o.backend,createdAt:P(t)};return await t.sessions.set({...a,snapshot:s}),{snapshot:s}}async function qi(t,n,r){if(t.backend.platform!==`macos`)return;let i=await Ji(t,n);if((i===`desktop`||i===`menubar`)&&(i!==`menubar`||r!==`click`&&r!==`press`))throw new e(`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 Ji(e,t){return(await e.sessions.get(t.session??`default`))?.metadata?.surface}async function Yi(t,n,r){let{session:i,snapshot:a}=await Pr(t,n.session),o=r.fallbackLabel??``,s=Zi(a.nodes,r.ref,{fallbackLabel:o});if(!s)throw new e(`COMMAND_FAILED`,`Ref ${r.ref} not found or has no bounds`,{hint:ue});return Xi({session:i,frameTree:a,target:r,fallbackLabel:o,authorized:s})}function Xi(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=Zi(o.nodes,r.ref,{fallbackLabel:i});return s&&pe(C(a.node),C(s.node))?{snapshot:o,resolved:s}:{snapshot:n,resolved:a}}function Zi(t,n,r){let o=a(n);if(!o)throw new e(`INVALID_ARGS`,`Invalid ref: ${n}`);let s=i(t,o);if($i(s))return Ri(o,s,`exact`);let c=r.fallbackLabel.length>0?Dn(t,r.fallbackLabel):null;return $i(c)?Ri(o,c,`label-fallback`):null}function Qi(t,n,r){let i=v(n),a=Jr(n,t,{bounds:[i.resolveEffectiveViewport(t),t.rect?i.resolveViewport(t.rect):null].filter(e=>e!==null)});if(a.kind===`resolved`)return a.point;throw a.kind===`invalid`?new e(`COMMAND_FAILED`,r.invalidMessage):new e(`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?E(e.rect)!==null:!1}async function ea(e,t,n,r,i,{action:a}){return await aa(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=>`${na(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 ta(e,t,n,r,i,{action:o}){return await aa(e,t,n,r,{message:`Ref ${i} is off-screen and not safe to ${o}`,details:{reason:`offscreen_ref`,ref:a(i)},hint:e=>`${na(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 na(e,t){return e?t?`Run scroll ${e} --until '${t}' to bring it on screen,`:`Scroll ${e} toward it,`:`Scroll toward it,`}async function ra(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=Zi(o,n.ref,{fallbackLabel:n.fallbackLabel??``});if(!s)return{};let c=M.resolvedTarget,{node:l}=await Gi({policy:c,nodes:o,node:s.node,action:r,label:`Ref ${n.ref}`,hooks:{offscreen:async(i,a)=>await ta(e,t,i,a,n.ref,{action:r,pipeline:c})},resolveTapPoint:e=>E(e.rect)});return{...Wi(l,r),node:l,preAction:R(i)}}async function ia(e,t,n,r,i){let a=await ra(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:Ii,...a,...o?{backendResult:o}:{}}}async function aa(t,n,r,i,a){let o=v(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 t.backend.confirmOffscreenTargetVisible?.(N(t,n),r,c);if(l)return{...r,rect:l};let u=Ve(r,o);throw new e(`COMMAND_FAILED`,a.message,{...a.details,rect:r.rect,viewport:s,...u?{scrollDirection:u}:{},hint:a.hint(u)})}function oa(e,t){let n=Me(e.type??`Element`),r=je(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 sa(e,t,n={}){let r=ua(la(e,n),la(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 ca(e,t={}){return la(e,t).length}function la(e,t){return t.flatten?e.map(e=>({text:Le(e,0,!1),comparable:oa(e,0),...t.withRefs&&e.ref?{ref:e.ref}:{}})):Be(e).map(e=>({text:e.text,comparable:oa(e.node,e.depth),...t.withRefs&&e.node.ref?{ref:e.node.ref}:{}}))}function ua(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=fa(a,i,s)?H(a,i+1):H(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 da(o,e,t,n,r)}}return[]}function da(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=fa(i,c,r)?c+1:c-1,u=H(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 fa(e,t,n){return t===-n||t!==n&&H(e,t-1)<H(e,t+1)}function H(e,t){return e.get(t)??0}async function pa(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 ma(e){let t=e.snapshotQuality?.backend,n=(e.backend===`xctest`?ha(e.nodes):e.nodes).map(va);return n.sort((e,t)=>ba(e).localeCompare(ba(t))),{captureBackend:t,nodes:n}}function ha(e){let t=v(e);return e.filter(e=>h(e)||t.isVisibleOnScreen(e))}function ga(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 _a(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 va(e){return{identity:`${e.type??``}#${ya(e)}`,...e.rect?{rect:{...e.rect}}:{}}}function ya(e){return[e.label,e.identifier,e.value].map(e=>String(e??``).trim()).join(`#`)}function ba(e){let t=e.rect;return`${e.identity}#${t?`${t.x},${t.y},${t.width},${t.height}`:``}`}const xa=`Settled on a nearly-empty tree — the app may still be loading. Wait for specific content (wait text ...) before interacting.`;async function Sa(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=tt(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 ka(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??=Ca(n.broadTransitionBaselineNodes,c.snapshot,e.backend.platform);let v=ma(c.snapshot);_=Ta({baseline:l,signal:v,requestedQuietMs:r,currentQuietMs:_}),u??=tt(c.snapshot.snapshotQuality);let y=P(e),b=Da({resetRequested:n.resetBudgetOnPrivateAxRecovery,alreadyReset:s,verdict:c.snapshot.snapshotQuality,nowMs:y,timeoutMs:i,deadlineMs:o});if(b!==void 0){s=!0,o=b,g=y,p=v,m=c.snapshot.nodes.length;let t=Oa({nowMs:y,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(t<=0)break;await ur(e,t);continue}if(!ga(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 x=Oa({nowMs:y,quietSinceMs:g,quietMs:_,pollMs:d,deadlineMs:o});if(x<=0)break;await ur(e,x)}return{settled:!1,stalled:!1,waitedMs:P(e)-a,captures:f,nodeCount:m,lastCapture:h}}function Ca(e,t,n){if(!e||!t||!wa(t.backend,n))return;let r=t.nodes.some(h),i=e.length<=5;if(!(!r&&!i))return ma({...t,nodes:e})}function wa(e,t){return e===`xctest`||e===void 0&&t===`ios`}function Ta(e){return e.requestedQuietMs<500||!_a(e.baseline,e.signal)?e.currentQuietMs:Math.max(e.requestedQuietMs,1500)}function Ea(e){return e?.state===`recovered`&&e.backend===`private-ax`&&e.reasonCode!==`deferred`}function Da(e){if(!(e.resetRequested!==!0||e.alreadyReset||!Ea(e.verdict)))return Math.max(e.deadlineMs,e.nowMs+e.timeoutMs)}function Oa(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 ka(e,t,n,r){let i=await pa(e,t,n,async n=>await L(e,{...t,signal:n},{updateSession:!1,interactiveOnly:!0,preferredBackend:r}));return i.timedOut?void 0:i.value}const Aa=`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.`,ja=`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 Ma(e,t,n){return await Pa(e,t,{...n,baseline:await La(e,t,n.resolved),actionPoint:n.resolved.point})}const Na=async(e,t)=>(await Pa(e,t,t)).observation;async function Pa(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 Fa(e,t,n,a,await Sa(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 Fa(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?ja:Aa}};let{stored:o,session:s}=await Xa(e,t,i.lastCapture),c=R(i.lastCapture.snapshot),l=c.nodes,u=Gr(n.baseline,c);return{observation:{...a,...u?{surfaceChange:u}:{},...i.settled&&o&&!u?Ha(n.baseline.nodes,l,n.actionPoint,s?.appBundleId):{},...Ja(i,o,l.length,u)},settledCapture:c}}function Ia(e,t){if(e)return Kr(e,t)}async function La(e,t,n){let r=await e.sessions.get(t.session??`default`);return Ra(n,r)??Ba(n.preAction)??za(r)}function Ra(e,t){if(e.kind!==`ref`)return;let n=t?.refFrameSnapshot;return n?Ba(R(n)):void 0}function za(e){let t=e?.refFrameSnapshot??e?.snapshot;return t?R(t):{nodes:[]}}function Ba(e){return e?.nodes.length?e:void 0}function Va(e,t,n){let r=sa(yn(e,n),yn(t,n),{flatten:!0,withRefs:!0}),i=r.lines.filter(e=>e.kind!==`unchanged`),a=qa(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 Ha(e,t,n,r){let i=Va(e,t,r);return{diff:i,...Ua(i,t,n,r)}}function Ua(e,t,n,r){let i=new Set(e.lines.filter(e=>e.kind===`added`&&e.ref).map(e=>e.ref)),a=bn(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)&&!Wa(o.get(e),n))?{}:Ka(t,i,r)}function Wa(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 Ga=new Set([`application`,`window`]);function Ka(e,t,n){let r=bn(e,n),i=e.filter(e=>e.ref&&e.interactionBlocked!==`covered`&&!t.has(e.ref)&&!r.has(e.ref)&&!Ga.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=je(e,t);return{ref:e.ref,role:t,...n?{label:n}:{}}});return{tail:a,...i.length>a.length?{tailTruncated:!0}:{}}}function qa(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 Ja(e,t,n,r){let i=Ya(e,t,n).hint;if(!r)return i===void 0?{}:{hint:i};let a=qr(r);return{hint:i===void 0?a:`${a} ${i}`}}function Ya(e,t,n){return e.stalled?{hint:ja}:e.settled?t?n<5?{hint:xa}:{}:{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:Aa}}async function Xa(e,t,n){if(at(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 U(e){let t=e.verify===!0;return{verify:t,needsPreActionBaseline:t||e.settle!==void 0,...e.settle===void 0?{}:{settle:e.settle}}}async function W(e,t,n,r,i){let a=await Za(e,t,n,i);return $a({...r,...a})}async function Za(e,t,n,r){if(r.settle!==void 0){let i=await Ma(e,t,{...r.settle,resolved:n}),a=r.verify?Ia(i.settledCapture,n.preAction):void 0;return{settle:i.observation,...a?{evidence:a}:{}}}if(!r.verify)return{};let i=await Qa(e,t,n);return i?{evidence:i}:{}}async function Qa(e,t,n){try{return Kr(R((await V(e,t,!0)).snapshot),n.preAction)}catch{return}}function $a(e){let t=e;if(t.targetHittable!==!1||!eo(t)||t.hint===void 0)return e;let{hint:n,...r}=t;return r}function eo(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 to(t,n){let r=v(t),i=t.filter(r.isVisibleInEffectiveViewport).map(e=>e.rect).filter(no),a=i.length>0?i:t.map(e=>e.rect).filter(no);if(a.length===0)throw new e(`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 no(e){return!!(e&&e.width>0&&e.height>0)}async function ro(e,t){return await e.backend.resolveGestureViewport?.(N(e,t))||to((await V(e,t,!1)).snapshot.nodes,`gesture`)}const io=async(t,n)=>{let r=await B(t,n,{action:`focus`,requireInteractive:!0,pipeline:M.resolvedTarget});if(!t.backend.focus)throw new e(`UNSUPPORTED_OPERATION`,`focus is not supported by this backend`);let i=G(r),a=F(await t.backend.focus(N(t,n),i));return{...r,...a?{backendResult:a}:{},...w(`Focused (${i.x}, ${i.y})`)}},ao=async(t,n)=>{let r=U(n),i=await B(t,n,{action:`longPress`,requireInteractive:!0,pipeline:M.promotedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!t.backend.longPress)throw new e(`UNSUPPORTED_OPERATION`,`longPress is not supported by this backend`);let a=n.durationMs===void 0?void 0:Zn(n.durationMs,`durationMs`,0,12e4),o=G(i),s=F(await t.backend.longPress(N(t,n),o,{durationMs:a}));return await W(t,n,i,{...i,...a===void 0?{}:{durationMs:a},...s?{backendResult:s}:{},...w(`Long pressed (${o.x}, ${o.y})`)},r)},oo=async(t,n)=>{let r=U(n),i=r.needsPreActionBaseline?null:await so(t,n);if(i)return i;let a=await B(t,n,{action:`hover`,requireInteractive:!1,pipeline:M.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget});if(!t.backend.hover)throw new e(`UNSUPPORTED_OPERATION`,`hover is not supported by this backend`);let o=G(a),s=F(await t.backend.hover(N(t,n),o));return await W(t,n,a,{...a,...s?{backendResult:s}:{},...w(`Hovered (${o.x}, ${o.y})`)},r)};async function so(e,t){if(t.target.kind!==`ref`||!e.backend.hoverTarget||t.expectedResolvedTarget)return null;let{hoverTarget:n}=e.backend;return await ia(e,t,t.target,`hover`,async(e,t)=>await n(e,t))}const co=async(t,n)=>{if(!t.backend.performGesture)throw new e(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await qi(t,n,`drag`);let r=await ro(t,n),i=await lo(t,n,`source`),a=await lo(t,n,`destination`),o=Ze({from:G(i),to:G(a),sourceHoldMs:n.gesture.sourceHoldMs,moveMs:n.gesture.moveMs,destinationHoldMs:n.gesture.destinationHoldMs},r),s=F(await t.backend.performGesture(N(t,n),o)),{start:c,end:l}=Ye(o);return{kind:`drag`,durationMs:o.durationMs,pointerCount:1,from:c,to:l,targets:{source:uo(i),destination:uo(a)},recording:fo(i,a),...s?{backendResult:s}:{},...w(`Dragged ${n.gesture.source} to ${n.gesture.destination}`)}};async function lo(e,t,n){let r=t.gesture[n];return await B(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 uo(t){if(t.kind===`point`||!t.resolution)throw new e(`COMMAND_FAILED`,`gesture drag target resolution was not disclosed`);let n=`selectorChain`in t?t.selectorChain:void 0;return{...n?.length?{selectorChain:n}:{},resolution:t.resolution}}function fo(e,t){let n=po(e),r=po(t),i=mo(e),a=mo(t);return{...n?{sourceSelector:n}:{},...r?{destinationSelector:r}:{},...i?{sourceTarget:i}:{},...a?{destinationTarget:a}:{}}}function po(e){return`selectorChain`in e&&e.selectorChain?.length?e.selectorChain.join(` || `):void 0}function mo(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(t){if(!t.point)throw new e(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return t.point}const ho=async(e,t)=>await vo(e,t,`press`),go=async(e,t)=>await vo(e,t,`click`),_o=async(t,n)=>{if(typeof n.text!=`string`)throw new e(`INVALID_ARGS`,`fill requires text`);let r=U(n),i=r.needsPreActionBaseline?null:await xo(t,n);if(i)return i;let a=await B(t,n,{action:`fill`,requireInteractive:!0,pipeline:M.resolvedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget,preresolvedTarget:n.preresolvedTarget});if(!t.backend.fill)throw new e(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=yo(a),s=`node`in a?a.node?.type??``:``,c=s!==``&&ae(s,t.backend.platform),l=n.allowNonHittableCoordinateFallback===!0&&`node`in a&&a.node?.hittable===!1,u=F(await t.backend.fill(N(t,n),o,n.text,{delayMs:n.delayMs,allowNonHittableCoordinateFallback:l})),d=s&&!c?`fill target ${Co(a)} resolved to "${s}", attempting fill anyway.`:void 0;return await W(t,n,a,{...a,text:n.text,...d?{warning:d}:{},...u?{backendResult:u}:{}},r)};async function vo(t,n,r){let i=U(n),a=i.needsPreActionBaseline?null:await bo(t,n,r);if(a)return a;let o=await B(t,n,{action:r,requireInteractive:!0,pipeline:M.promotedTarget,captureEvidenceBaseline:i.needsPreActionBaseline,expectedResolvedTarget:n.expectedResolvedTarget,preresolvedTarget:n.preresolvedTarget});if(!t.backend.tap)throw new e(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let s=yo(o),c;try{c=await t.backend.tap(N(t,n),s,{button:n.button,count:n.count,intervalMs:n.intervalMs,holdMs:n.holdMs,jitterPx:n.jitterPx,doubleTap:n.doubleTap})}catch(e){throw sr(e,o),e}let l=F(c);return await W(t,n,o,{...o,...l?{backendResult:l}:{}},i)}function yo(t){if(!t.point)throw new e(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return t.point}async function bo(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||So(t)||t.expectedResolvedTarget)return null;let{tapTarget:r}=e.backend;return await ia(e,t,t.target,n,async(e,t)=>await r(e,t))}async function xo(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let{fillTarget:n}=e.backend;return{...await ia(e,t,t.target,`fill`,async(e,r)=>await n(e,r,t.text,{delayMs:t.delayMs})),text:t.text}}function So(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 Co(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 wo=M.wait.poll.defaultTimeoutMs;function To(e,t,n,r,i={}){let a=wr(r),o=n??a.defaultTimeoutMs,s=Y(e),c=Lo(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 pa(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(Eo(r,c.lastUnobservedCause())),o;let f=Fo(o.error);return a(f?`runner-restart`:`deadline`),u=f??{},{timedOut:!0,deadline:Do(f!==void 0,c.readableCaptures())}},hasTimeRemaining:()=>d()>0,failureEvidence:()=>({timeoutMs:o,readableCaptures:c.readableCaptures(),captures:l.length,polls:Oo(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 Eo(e,t){return e?`readable`:t?.outcome??`unreadable`}function Do(e,t){return e?`runner-restart-exhausted`:t===0?`capture-stalled`:`capture-truncated`}function Oo(e){return e.length<=30?[...e]:[...e.slice(0,5),...e.slice(-25)]}function ko(t,n){return new e(`COMMAND_FAILED`,t,{reason:k.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 Ao(t,n){return new e(`COMMAND_FAILED`,t,{reason:k.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 jo(t,n){return new e(`COMMAND_FAILED`,t,{reason:k.deadlineExceeded,captureTruncated:!0,...n})}function Mo(t,n){return new e(`COMMAND_FAILED`,t,{reason:k.targetAbsent,...n})}function No(e,t,n){let r=e.neverReadableCause();if(r!==void 0){if(r.outcome===`retriable`)throw Po(r.error,t);if(n)throw r.error}}function Po(t,n){let i=r(t);return new e(i.code,i.message,{reason:k.captureStalled,...i.details,...n},i)}function q(e,t,n){let r=t.failureEvidence();return n===`runner-restart-exhausted`?Ao(e,r):n===`capture-stalled`?(No(t,r,t.preserveUnreadableOnStall===!0),ko(e,r)):n===`capture-truncated`?jo(e,r):(No(t,r,!0),r.readableCaptures===0?ko(e,r):Mo(e,r))}function Fo(t){if(!(t instanceof e))return;let n=t.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 Io(t){return t instanceof e&&t.details?.retriable===!0}function Lo(e=$e){let t=0,n;return{attempt:async t=>{try{return await t()}catch(t){if(e(t))n={outcome:`unreadable`,error:t};else if(Io(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 zo(e,t,n){let r=await I(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:Ie(e,i)}}async function Bo(e,t,n){let r=await zo(e,t,n),i=r.observation;if(i.kind!==`absent`)throw Fe(r.selector,i);return{predicate:`absent`,pass:!0,selector:t,matches:i.matches}}async function Vo(e,t,n,r,i){let a=ke(n);if(a)throw ze(a,`wait`);let o=To(t,n,i,M.wait,{isUnreadableError:Uo,preserveUnreadableOnStall:!0}),s=K(),c,l;for(;o.hasTimeRemaining();){let i=await o.capture(async i=>{try{let{observation:a}=await zo((await e.captureSnapshot(t,{...n,signal:i},{updateSession:!0,includeHiddenContentHints:!1,...s})).snapshot,r,t.backend.platform);if(Ae(a.kind))throw Fe(r,a,`wait`);return a}catch(e){throw $e(e)?Re(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?Ho(r,c,o.failureEvidence()):q(`wait absent timed out for selector: ${r}`,o,l)}function Ho(t,n,r){let i=n.matches!==1;return new e(`COMMAND_FAILED`,`wait absent timed out for selector ${t}: ${n.matches} match${i?`es`:``} remain`,{reason:k.targetPresent,selector:t,...r,matches:n.matches,firstMatch:n.firstMatch})}function Uo(t){if(!(t instanceof e))return!1;let n=t.details;return n?.command===`wait`&&n.predicate===`absent`&&(Ae(n.observation)||n.observation===`unreadable`)}function Wo(e){if(e.kind===`ambiguous`||e.kind===`target`)return{selector:e.selector,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}async function Go(t,n,r,i,a,o){let s=To(n,r,a,M.wait),c=K(),l,u;for(;s.hasTimeRemaining();){let e=await s.capture(async e=>await t.captureSnapshot(n,{...r,signal:e},{updateSession:!0,includeHiddenContentHints:!1,...c}));if(e.timedOut){u=e.deadline;break}let a=e.value;if(a){let e=a.snapshot.nodes,t=Wo(await I(M.wait,e,i,{platform:n.backend.platform}));if(t){let n=Ko(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 e(`COMMAND_FAILED`,`wait matched selector ${i} but no candidate carried the recorded landmark identity`,{reason:En,...s.failureEvidence(),...l}):q(`wait timed out for selector: ${i}`,s,u)}function Ko(e,t,n){let r=t.matchedNodes[0];if(!n)return{kind:`satisfied`,node:r};let i=mt(e),a=gt(t.matchedNodes,i,g(n),n.ancestry)[0];return a?{kind:`satisfied`,node:a}:{kind:`identity-mismatch`,evidence:{matchCount:t.matchedNodes.length,observed:C(r),observedAncestry:ht(r,i,Math.max(n.ancestry.length,1)).chain}}}async function qo(t,n,r,i,a){let o=a??wo,s=i??t.stable.defaultQuietMs,c=await t.stable.capture(n,r,{quietMs:s,timeoutMs:o});if(!c.settled)throw new e(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:k.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<t.stable.tinyTreeNodeCount?{hint:t.stable.tinyTreeHint}:{}}}async function Jo(e,t,n,r,i){let a=To(t,n,i,M.wait),o;for(;a.hasTimeRemaining();){let i=await a.capture(async i=>await Yo(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 Yo(e,t,n,r){return t.backend.findText&&(await t.backend.findText(Zo(t,n),r)).found?!0:await Xo(e,t,n,r)}async function Xo(e,t,n,r){return!!Dn((await e.captureSnapshot(t,n,{updateSession:!0,includeHiddenContentHints:!1})).snapshot.nodes,r)}function Zo(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function Qo(t){let n=async(e,n)=>{switch(n.target.kind){case`sleep`:return await Ro(e,n,n.target.durationMs),{kind:`sleep`,waitedMs:n.target.durationMs};case`ref`:return await $o(t,e,n,n.target.ref,n.target.timeoutMs);case`selector`:return await Go(t,e,n,n.target.selector,n.target.timeoutMs,n.target.recordedLandmark);case`absent`:return await Vo(t,e,n,n.target.selector,n.target.timeoutMs);case`stable`:return await qo(t,e,n,n.target.quietMs,n.target.timeoutMs);case`text`:return await es(t,e,n,n.target.text,n.target.timeoutMs);default:return ts(n.target)}};return{waitCommand:n,waitForTextCommand:async(t,r)=>{let i=await n(t,{...r,target:{kind:`text`,text:r.text,timeoutMs:r.timeoutMs}});if(i.kind!==`text`)throw new e(`COMMAND_FAILED`,`waitForText returned non-text result`);return i}}}async function $o(t,n,r,o,s){let c=await t.requireSnapshot(n,r.session),l=a(o);if(!l)throw new e(`INVALID_ARGS`,`Invalid ref: ${o}`);let u=i(c.snapshot.nodes,l),d=u?A(u,c.snapshot.nodes):void 0;if(!d)throw new e(`COMMAND_FAILED`,`Ref ${o} not found or has no label`);return await Jo(t,n,r,d,s)}async function es(t,n,r,i,a){let o=be(i);if(!o.ok)throw new e(o.code,o.message);return await Jo(t,n,r,o.text,a)}function ts(e){throw Error(`Unsupported wait target: ${String(e)}`)}const ns=Qo({captureSnapshot:L,requireSnapshot:Pr,stable:{defaultQuietMs:500,tinyTreeHint:xa,tinyTreeNodeCount:5,capture:Sa}}),rs=ns.waitCommand,is=ns.waitForTextCommand,as=async(t,n)=>{let r=n.locator??`any`;if(!n.query)throw new e(`INVALID_ARGS`,m);if(n.action===`wait`)return await ls(t,n,r);if(n.action===`list`)return await us(t,n,r);let{capture:i,match:a}=await ds(t,n,r);if(!a)throw new e(`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 Lr(t,i,a),node:a}},os=async(e,t)=>{if(t.target.kind===`ref`){let n=await Pr(e,t.session),r=Rr(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`});Ei(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=ce(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 Lr(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await fs(e,t,t.session??`default`,{selector:t.target.selector,policy:t.property===`text`?M.readText:M.readUnique,hooks:{onResolved:(e,n)=>Ei(e,n,t.expectedResolvedTarget,`get`)}}),r=ce(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 Lr(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}},ss=async(t,n)=>{let r=await os(t,{...n,property:`text`,target:n.target});if(r.kind!==`text`)throw new e(`COMMAND_FAILED`,`getText returned non-text result`);return r},cs=async(t,n)=>{let r=await os(t,{...n,property:`attrs`,target:n.target});if(r.kind!==`attrs`)throw new e(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return r};async function ls(e,t,n){let r=To(e,t,t.timeoutMs,M.findWait),i;for(;r.hasTimeRemaining();){let a=await r.capture(async r=>await ds(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 us(e,t,n){let r=ne(n,t.query),i=await L(e,t,{updateSession:!0,...K()});if(at(i.snapshot.snapshotQuality))throw Nr(i.snapshot.snapshotQuality);return{kind:`list`,matches:(r?yr(M.readList,i.snapshot.nodes,r,{platform:e.backend.platform}).list?.matchedNodes??[]:ie(i.snapshot.nodes,n,t.query,{}).matches).map(e=>({ref:`@${e.ref}`,node:e}))}}async function ds(e,t,n,r){let i=ne(n,t.query),a=await L(e,t,{updateSession:!0,scope:Mr(e.backend.platform,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...K()});if(at(a.snapshot.snapshotQuality))throw Nr(a.snapshot.snapshotQuality);if(i){let t=await I(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:ie(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}async function fs(t,n,r,i){let a=await L(t,{...n,session:r},{updateSession:!0,...K()}),o=await I(i.policy,a.snapshot.nodes,i.selector,{platform:t.backend.platform},i.hooks);if(o.kind!==`target`)throw new e(`COMMAND_FAILED`,Ce(i.selector,[],{unique:!0}),{hint:oe([])});return{capture:a,node:o.node,selector:o.selector,ref:`@${o.node.ref}`}}const ps=async(t,n)=>{let r=ye(n.predicate);if(!r.ok)throw new e(r.code,r.message,{hint:r.hint});let i=r.predicate;if(i===`absent`){let e=ke(n);if(e)throw ze(e)}if(i===`text`&&!n.expectedText)throw new e(`INVALID_ARGS`,ge);let a=n.selector,o=await ms(t,n,i,a);return i===`exists`?await hs(t,o,a):i===`absent`?await Bo(o.snapshot,a,t.backend.platform):await gs(t,n,o,i,a)};async function ms(e,t,r,i){try{return await L(e,t,{updateSession:!0,...K(r)})}catch(e){throw r!==`absent`||n(e)?e:Re(i,e)}}async function hs(t,n,r){let i=await I(M.readAny,n.snapshot.nodes,r,{platform:t.backend.platform});if(i.kind!==`target`)throw new e(`COMMAND_FAILED`,Ce(r,[],{unique:!1}),{hint:oe([])});return{predicate:`exists`,pass:!0,selector:i.selector,matches:i.matches,selectorChain:Se(r)}}async function gs(t,n,r,i,a){let o=await I(M.readUnique,r.snapshot.nodes,a,{platform:t.backend.platform},{onResolved:(e,t)=>Ei(e,t,n.expectedResolvedTarget,`is`)});if(o.kind!==`target`)throw new e(`COMMAND_FAILED`,Ce(a,[],{unique:!0}),{command:`is`,reason:Ne.selectorNotFound,predicate:i,selector:a,hint:oe([])});let s=_e({predicate:i,node:o.node,visibility:v(r.snapshot.nodes),expectedText:n.expectedText,platform:t.backend.platform});if(!s.pass)throw new e(`COMMAND_FAILED`,`is ${i} failed for selector ${o.selector}: ${s.details}`,{command:`is`,reason:Ne.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 _s=async(e,t)=>await ps(e,{...t,predicate:`visible`,selector:t.target.selector}),vs=async(e,t)=>await ps(e,{...t,predicate:`hidden`,selector:t.target.selector}),ys=async(t,n)=>{if(!t.backend.performGesture)throw new e(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await qi(t,n,n.gesture.intent);let r=await ro(t,n),i=Xe(n.gesture,r,t.backend.platform),a=F(await t.backend.performGesture(N(t,n),i)),o=xs(i.pointers,0),s=xs(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(Ss(n.gesture,o,s))}},bs=async(e,t)=>{let n=t.gesture;return n.intent===`drag`?await co(e,{...t,gesture:n}):await ys(e,{...t,gesture:n})};function xs(t,n){let r=t.map(e=>n===0?e.samples[0]?.point:e.samples.at(-1)?.point);if(r.some(e=>e===void 0))throw new e(`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 Ss(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:as,get:os,getText:ss,getAttrs:cs,is:ps,isVisible:_s,isHidden:vs,wait:rs,waitForText:is},Z={click:go,press:ho,fill:_o,focus:io,longPress:ao,hover:oo,gesture:bs,settleObservation:Na};function Cs(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 ws(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 Q=[0,187,255,255];function Ts(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||Es(e,n.rect)}function Es(e,t){let n=Ds(t);if(n==null)return;let r=ks(n.x,0,e.width-1),i=ks(n.y,0,e.height-1),a=ks(n.right,0,e.width-1),o=ks(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)Os(e,n,i+t,Q),Os(e,n,o-t,Q);for(let n=i;n<=o;n+=1)Os(e,r+t,n,Q),Os(e,a-t,n,Q)}}function Ds(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 Os(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 ks(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}const As=[{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 js(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(!Ps(t,a,e))continue;let c=0,l=Ns(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=Ms({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function Ms(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 As){let o=s+e.x,u=c+e.y;if(!Fs(o,u,i,a))continue;let d=u*i+o;Ps(t,n,d)&&(l=Ns(r,n,l,d))}return l}function Ns(e,t,n,r){return t[r]=1,e[n]=r,n+1}function Ps(e,t,n){return e[n]===1&&t[n]!==1}function Fs(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}function Is(e,t){return e.flatMap(e=>Ls(e,t.baseline.width,t.baseline.height)?Rs(e,t,Ws(t.baseline.height)):[e])}function Ls(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=Us(n)&&r>=t*.35}function Rs(e,t,n){let r=Hs(e,Vs(Bs(zs(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])=>Gs(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function zs(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 Bs(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 Vs(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 Hs(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 Us(e){return Math.max(48,Math.round(e*.07))}function Ws(e){return Math.max(24,Math.round(e*.03))}function Gs(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??=Ks(t,a),qs(i,e,t,a,r.baseline,r.current))}return i}function Ks(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 qs(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 Js=2.5;function Ys(e){let t=Xs(e);return Is(t.length<=2e3?$s(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)=>nc(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function Xs(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return js({mask:t,width:i,height:a,hooks:{create:e=>Zs(e,i),visit:(e,t)=>Qs(e,t,i,n,r)}})}function Zs(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 Qs(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 $s(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=>ec(e,r,t));if(!e){n.push({...r});continue}tc(e,r)}return n}function ec(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 tc(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 nc(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=rc(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=rc(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:oc(r,n.width,n.height),size:sc(s,n.totalPixels),location:ic(i,n.width,n.height),averageBaselineColorHex:lc(a),averageCurrentColorHex:lc(o),baselineLuminance:Math.round(cc(a)),currentLuminance:Math.round(cc(o)),dominantChange:ac(a,o)}}function rc(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function ic(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 ac(e,t){let n=cc(t)-cc(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 oc(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*Js?`horizontal-band`:e.height>=e.width*Js?`vertical-band`:`compact`}function sc(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function cc(e){return e.r*.2126+e.g*.7152+e.b*.0722}function lc(e){return`#${uc(e.r)}${uc(e.g)}${uc(e.b)}`}function uc(e){return e.toString(16).padStart(2,`0`)}function $(e){return Math.round(e*100*100)/100}const dc=Math.sqrt(3*255**2);async function fc(e,t,n={}){await pc(e,`Baseline image not found`),await pc(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([ot(i,`baseline screenshot`),ot(a,`current screenshot`)]);mc(o.width,o.height,`baseline screenshot`,n.maxPixels),mc(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 hc(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*dc,{diffData:d,diffMask:f,differentPixels:p}=await st({baselineData:o.data,currentData:s.data,width:o.width,height:o.height,maxColorDistance:u}),m=p>0?Ys({diffMask:f,baseline:o,current:s,totalPixels:l,differentPixels:p}):[];if(p>0&&r){let e=new lt.PNG({width:o.width,height:o.height});e.data=d,Ts(e,m),await O.mkdir(ft.dirname(r),{recursive:!0}),await O.writeFile(r,await ct(e))}else await hc(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 pc(t,n){try{await O.access(t)}catch{throw new e(`INVALID_ARGS`,`${n}: ${t}`)}}function mc(t,n,r,i){if(i==null||i<=0)return;let a=t*n;if(!(a<=i))throw new e(`INVALID_ARGS`,`${r} is ${a} pixels, which exceeds the configured maxImagePixels limit of ${i}`)}async function hc(e){if(e)try{await O.unlink(e)}catch(e){if(!gc(e,`ENOENT`))throw e}}function gc(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function _c(e,t){return e.map(e=>{let n=vc(e,t);return n.length>0?{...e,currentOverlayMatches:n}:e})}function vc(e,t){let n=xe(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:yc(i/xe(r)),regionCoveragePercentage:yc(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 yc(e){return Math.round(e*100*100)/100}async function bc(t,n,i){if(n.kind===`path`&&!t.policy.allowLocalInputPaths)throw new e(`INVALID_ARGS`,`Local ${i.field??`input`} paths are not allowed by command policy`);try{return await t.artifacts.resolveInput(n,i)}catch(e){throw r(e)}}async function xc(t,n,i){if(n?.kind===`path`&&!t.policy.allowLocalOutputPaths)throw new e(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await t.artifacts.reserveOutput(n,{...i,visibility:i.visibility??`client-visible`,requestedClientPath:n?.kind===`downloadableArtifact`?n.clientPath??i.requestedClientPath:i.requestedClientPath})}catch(e){throw r(e)}}async function Sc(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw r(e)}}const Cc=async(t,n)=>{if(!n.baseline)throw new e(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let r=wc(n.threshold),i=n.current??{kind:`live`};if(n.overlayRefs&&!Mc(i))throw new e(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let a=await bc(t,n.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let e;Mc(i)?(s=await Tc(t,n),e=s.path):(o=await bc(t,i,{usage:`diff screenshot current`,field:`current`}),e=o.path),c=n.out?await xc(t,n.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await fc(a.path,e,{threshold:r,outputPath:c?.path,maxPixels:t.policy.maxImagePixels});Mc(i)&&(u=await Ec(t,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 wc(t){if(t==null||t===``)return .1;let n=Number(t);if(Number.isNaN(n)||n<0||n>1)throw new e(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return n}async function Tc(e,t){let n=await Sc(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await Dc(e,t,n.path,Oc(t))}catch(e){throw await n.cleanup(),e}return n}async function Ec(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await jc(n),r;let a=await xc(e,kc(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await Dc(e,t,a.path,{overlayRefs:!0,...Oc(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:_c(r.regions,n.overlayRefs)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function Dc(t,n,r,i={}){if(!t.backend.captureScreenshot)throw new e(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await t.backend.captureScreenshot({session:n.session,requestId:n.requestId,signal:n.signal??t.signal,metadata:n.metadata},r,i)??{}}function Oc(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function kc(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:Ac(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:Ac(e.out.clientPath)}:{},...e.out.fileName?{fileName:Ac(e.out.fileName)}:{}}}function Ac(e){let t=ft.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function jc(e){try{await O.unlink(Ac(e))}catch(e){if(!Nc(e,`ENOENT`))throw e}}function Mc(e){return e.kind===`live`}function Nc(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}const Pc=async(t,n)=>{if(!t.backend.captureScreenshot)throw new e(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);c(n);let r=await xc(t,n.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),i;try{await t.backend.captureScreenshot({session:n.session,requestId:n.requestId,appId:n.appId,appBundleId:n.appBundleId,signal:n.signal??t.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 rt(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 Fc(e){let{nodes:n,backend:r,snapshotRaw:i}=e;if(i||!t(r))return{partial:!1,visibleNodeCount:n.length,totalNodeCount:n.length,reasons:[]};let a=He(n),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:n.length,reasons:[...o]}}const Ic=`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 Lc(e){return e?.systemSurfaceOnly===!0?Ic:void 0}function Rc(e,t){return e.presentationKey?e:{...e,presentationKey:s(t)}}function zc(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||!Bc(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!Vc(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 Bc(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function Vc(e,t){return e.truncated===t.truncated&&e.nodes.length===t.nodes.length&&e.nodes.every((e,n)=>Uc(e,t.nodes[n]))}const Hc=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 Uc(e,t){return Hc.every(n=>e[n]===t[n])&&Wc(e.rect,t.rect)&&Gc(e.presentationHints,t.presentationHints)&&Gc(e.actions,t.actions)}function Wc(e,t){return!e||!t?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function Gc(e,t){return!e||!t?e===t:e.length===t.length&&e.every((e,n)=>e===t[n])}const Kc=async(e,t)=>{let n=await Jc(e,t),r=zc({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(Xc(t.session,n));let i=Qc(n.snapshot);return d(n.snapshot,{nodes:n.snapshot.nodes,...i===void 0?{}:{truncated:i},visibility:Fc({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}:{},...n.snapshot.keyboard?{keyboard:n.snapshot.keyboard}:{},...Zc(n)})},qc=async(e,t)=>{let n=await Jc(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,a=Xc(t.session,n);if(!i){let t=ca(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=sa(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 Jc(t,n){if(!t.backend.captureSnapshot)throw new e(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=n.session??`default`,i=await t.sessions.get(r),a=await t.backend.captureSnapshot({session:r,requestId:n.requestId,appId:i?.appId,appBundleId:i?.appBundleId,signal:n.signal??t.signal,metadata:n.metadata},{interactiveOnly:n.interactiveOnly,depth:n.depth,scope:n.scope,raw:n.raw,customActions:n.customActions}),o=Yc(a,t),s=d(o,Rc(o,n)),c=l(a),u=P(t);return{snapshot:s,result:a,session:i,annotations:c,warnings:$c({result:a,annotations:c,snapshot:s,options:n,session:i,capturedAt:s.createdAt??u,runtimeNow:u})}}function Yc(e,t){return e.snapshot?e.snapshot:{nodes:e.nodes??[],truncated:e.truncated,backend:e.backend,createdAt:P(t),...e.keyboard?{keyboard:e.keyboard}:{}}}function Xc(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 Zc(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 Qc(e){return e.truncated===void 0?e.backend!==`xctest`||e.producer===void 0?!1:dt(e.producer)===`unavailable`&&void 0:e.truncated}function $c(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...nt(e.annotations.quality,e.snapshot.nodes)),t.push(...it(Qc(e.snapshot))),e.snapshot.unsettledGesture&&t.push(en(e.snapshot.unsettledGesture)),t.push(...il(e)),e.annotations.quality||(t.push(...tl(e)),t.push(...rl(e.snapshot.nodes)));let n=bt(e.snapshot.nodes);n&&t.push(n);let r=el(e.annotations);r&&t.push(r);let i=al(e);return i&&t.push(i),t.push(...ll(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function el(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return Ic}function tl(e){if(e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1)return[];let t=e.snapshot.nodes[0];return nl(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 nl(e){return e?x(e.type??``)===`application`:!1}function rl(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 il(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 al(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&ol(t,e.snapshot)&&sl(t,e.capturedAt,e.runtimeNow)&&ul(t.nodes.length,e.snapshot.nodes.length))return cl}function ol(e,t){return e.presentationKey===void 0||t.presentationKey===void 0||e.presentationKey===t.presentationKey}function sl(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const cl=`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 ll(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`?[cl]:[]}function ul(e,t){return e<12?!1:t<=Math.floor(e*.2)}const dl={screenshot:Pc,diffScreenshot:Cc,snapshot:Kc,diffSnapshot:qc};function fl(e){return dr(dl,e)}export{xn as A,Rn as C,Tn as D,Dn as E,xt as F,ht as I,mt as L,$t as M,en as N,En as O,nn as P,gt as R,Bn as S,A as T,er as _,ws as a,Qn as b,yr as c,dr as d,F as f,$n as g,M as h,bc as i,bn as j,k,I as l,cr as m,Lc as n,Cs as o,N as p,xc as r,Ur as s,fl as t,br as u,rr as v,Fn as w,Zn as x,ir as y};

package/dist/src/runtime10.js

@@ -1,2 +1,2 @@
-import{D as e,F as t,j as n,k as r}from"./sdk-contracts.js";import{i}from"./recording-export-quality.js";import{_ as a,a as o,d as s,f as c,g as l,i as u,o as d,p as f,r as p,t as ee,v as te,x as m,y as ne}from"./runtime.js";import{r as h}from"./success-text.js";import{n as re,t as ie}from"./app-inventory.js";import"./app-inventory-contract.js";import{D as ae}from"./owner-identity.js";import{c as oe}from"./exec.js";import"./file.js";import{r as se}from"./tv-remote.js";import"./command.js";import{n as g}from"./version.js";import{t as ce}from"./keyboard-actions.js";import{i as le}from"./quality-warnings.js";import{i as ue}from"./png-worker-client.js";import{r as _}from"./png.js";import{t as de}from"./png-size.js";import{i as v,n as fe,r as pe}from"./screenshot-overlay-draw.js";import{t as me}from"./png-encode.js";import{r as y}from"./artifact-paths.js";import{t as he}from"./mp4-duration.js";import{c as b,o as ge,r as _e,s as ve}from"./video.js";import x from"node:path";import S from"node:fs";import ye from"node:os";function C(e,t){if(e!==void 0)return w(e,t)}function w(t,n){let r=t?.trim();if(!r)throw new e(`INVALID_ARGS`,`${n} must be a non-empty string`);return r}const be=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(f(t,n),n.filter)}},xe=async(t,n={})=>{if(!t.backend.bootDevice)throw new e(`UNSUPPORTED_OPERATION`,`admin.boot is not supported by this backend`);let r=D(n.target),i=await t.backend.bootDevice(f(t,n),r),a=c(i);return{kind:`deviceBooted`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(`Booted device`)}},Se=async(t,n={})=>{if(!t.backend.shutdownDevice)throw new e(`UNSUPPORTED_OPERATION`,`admin.shutdown is not supported by this backend`);let r=D(n.target),i=await t.backend.shutdownDevice(f(t,n),r),a=c(i);return{kind:`deviceShutdown`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(`Shutdown device`)}},Ce=async(e,t)=>await T(e,t,`install`),we=async(e,t)=>await T(e,t,`reinstall`),Te=async(e,t)=>await T(e,t,`installFromSource`);async function T(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?w(n.app,`app`):void 0;if(r!==`installFromSource`&&!o)throw new e(`INVALID_ARGS`,`admin.${r} requires app`);let s=f(t,n),c=await Ee(t,s,n.source);try{let e=await a.call(t.backend,s,{...o?{app:o}:{},source:c.source});return ke(r,o,c.source,e)}finally{await c.cleanup?.()}}async function Ee(e,t,n){let r=await De(e,E(n));try{return{source:E(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 De(e,t){if(t.kind===`url`)return{source:t};let n=await u(e,t,{usage:`admin.install`,field:`source`});return{source:{kind:`path`,path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function E(t){if(!t||typeof t!=`object`)throw new e(`INVALID_ARGS`,`install source is required`);if(t.kind===`path`)return{kind:`path`,path:w(t.path,`source.path`)};if(t.kind===`uploadedArtifact`)return{kind:`uploadedArtifact`,id:w(t.id,`source.id`)};if(t.kind===`url`){let e=w(t.url,`source.url`);return Oe(e),{kind:`url`,url:e}}throw new e(`INVALID_ARGS`,`install source kind must be path, uploadedArtifact, or url`)}function Oe(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 D(e){if(!e)return;let t=C(e.id,`target.id`),n=C(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 ke(e,t,n,r){let i=c(r),a=e===`reinstall`?`appReinstalled`:e===`installFromSource`?`appInstalledFromSource`:`appInstalled`,o=O(r,`appName`),s=O(r,`appId`),l=O(r,`bundleId`),u=O(r,`packageName`),d=O(r,`launchTarget`),f=O(r,`installablePath`),p=O(r,`archivePath`);return{kind:a,...t?{app:t}:{},source:n,...s?{appId:s}:{},...o?{appName:o}:{},...l?{bundleId:l}:{},...u?{packageName:u}:{},...d?{launchTarget:d}:{},...f?{installablePath:f}:{},...p?{archivePath:p}:{},...i?{backendResult:i}:{},...h(`${e===`reinstall`?`Reinstalled`:`Installed`}: ${o??d??t??Ae(n)}`)}}function O(e,t){let n=e[t];return typeof n==`string`&&n.length>0?n:void 0}function Ae(e){return e.kind===`path`?e.path:e.kind===`uploadedArtifact`?e.id:e.url}const je=/^[A-Za-z0-9_.:-]{1,64}$/,Me=async(t,n)=>{if(!t.backend.openApp)throw new e(`UNSUPPORTED_OPERATION`,`apps.open is not supported by this backend`);let r=Re(n),i=await t.backend.openApp(A(t,n),r,{launchArgs:n.launchArgs,relaunch:n.relaunch}),a=c(i);return{kind:`appOpened`,target:r,relaunch:n.relaunch===!0,...a?{backendResult:a}:{},...h(`Opened: ${Be(r)}`)}},Ne=async(t,n={})=>{if(!t.backend.closeApp)throw new e(`UNSUPPORTED_OPERATION`,`apps.close is not supported by this backend`);let r=C(n.app,`app`),i=await t.backend.closeApp(A(t,n),r),a=c(i);return{kind:`appClosed`,...r?{app:r}:{},...a?{backendResult:a}:{},...h(r?`Closed: ${r}`:`Closed app`)}},Pe=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(A(t,n),ie(n.filter))}},Fe=async(t,n)=>{if(!t.backend.getAppState)throw new e(`UNSUPPORTED_OPERATION`,`apps.state is not supported by this backend`);let r=w(n.app,`app`);return{kind:`appState`,app:r,state:await t.backend.getAppState(A(t,n),r)}},Ie=async(t,n)=>{if(!t.backend.pushFile)throw new e(`UNSUPPORTED_OPERATION`,`apps.push is not supported by this backend`);let r=w(n.app,`app`),i=await Ve(t,n.input);try{let e=await t.backend.pushFile(A(t,n),i.backendInput,r),a=c(e);return{kind:`appPushed`,app:r,inputKind:i.inputKind,...a?{backendResult:a}:{},...h(`Pushed to ${r}`)}}finally{await i.cleanup?.()}},Le=async(t,n)=>{if(!t.backend.triggerAppEvent)throw new e(`UNSUPPORTED_OPERATION`,`apps.triggerEvent is not supported by this backend`);let r=He(n.name);Ue(n.payload,`apps.triggerEvent payload for "${r}"`);let i=await t.backend.triggerAppEvent(A(t,n),{name:r,...n.payload?{payload:n.payload}:{}}),a=c(i);return{kind:`appEventTriggered`,name:r,...n.payload?{payload:n.payload}:{},...a?{backendResult:a}:{},...h(`Triggered app event: ${r}`)}};function Re(t){let n=C(t.app,`app`),r=C(t.appId,`appId`),i=C(t.bundleId,`bundleId`),a=C(t.packageName,`packageName`),o=C(t.url,`url`),s=C(t.activity,`activity`),c={...n?{app:n}:{},...r?{appId:r}:{},...i?{bundleId:i}:{},...a?{packageName:a}:{},...o?{url:o}:{},...s?{activity:s}:{}};if(!ze(c))throw new e(`INVALID_ARGS`,`apps.open requires app, appId, bundleId, packageName, url, or activity`);return c}function ze(e){return!!(e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity)}function Be(e){return e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity??`app`}async function Ve(t,n){if(!n||typeof n!=`object`)throw new e(`INVALID_ARGS`,`apps.push requires an input`);if(n.kind===`json`)return k(n.payload,`apps.push JSON payload`,8192),{backendInput:{kind:`json`,payload:n.payload},inputKind:`json`};let r=await u(t,n,{usage:`apps.push`,field:`input`});return{backendInput:{kind:`file`,path:r.path},inputKind:`file`,...r.cleanup?{cleanup:r.cleanup}:{}}}function He(t){let n=w(t,`name`);if(!je.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 Ue(e,t){e!==void 0&&k(e,t,8192)}function k(t,n,r){if(We(t,n),Buffer.byteLength(Ge(t,n),`utf8`)>r)throw new e(`INVALID_ARGS`,`${n} exceeds ${r} bytes`)}function We(t,n){if(!t||typeof t!=`object`||Array.isArray(t))throw new e(`INVALID_ARGS`,`${n} must be a JSON object`)}function Ge(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 A(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}const j={open:Me,close:Ne,list:Pe,state:Fe,push:Ie,triggerEvent:Le},Ke={devices:be,boot:xe,shutdown:Se,install:Ce,reinstall:we,installFromSource:Te};function qe(e){return{...s(j,e),list:(t={})=>j.list(e,{...t,filter:re(t.filter)})}}const Je=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,Ye=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function Xe(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(Ye,()=>(t=!0,`[REDACTED]`)),n=Qe(n,()=>{t=!0}),{value:n,redacted:t}}function Ze(e){try{let t=new URL(e),n=$e(t);return(t.username||t.password)&&(t.username=`REDACTED`,t.password=`REDACTED`,n=!0),{value:t.toString(),redacted:n}}catch{return}}function Qe(e,t){return/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(e)?e.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let n=Ze(e);return n?(n.redacted&&t(),n.value):e}):e}function $e(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))Je.test(n)&&(e.searchParams.set(n,`[REDACTED]`),t=!0);return t}const M=2048,N=4096,P=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function et(e){let t=e.redacted===!0;return{kind:`diagnosticsLogs`,entries:e.entries.map(e=>{let n=z(e.message,N),r=L(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 tt(e,t){let n=e.redacted===!0;return{kind:`diagnosticsNetwork`,entries:e.entries.map(e=>{let r=e.url?rt(e.url):void 0,i=t===`headers`||t===`all`?F(e.requestHeaders):void 0,a=t===`headers`||t===`all`?F(e.responseHeaders):void 0,o=t===`body`||t===`all`?I(e.requestBody):void 0,s=t===`body`||t===`all`?I(e.responseBody):void 0,c=L(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 nt(e){let t=e.redacted===!0;return{kind:`diagnosticsPerf`,metrics:e.metrics.map(e=>{let n=z(e.message,N),r=L(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 F(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[r,i]of Object.entries(e))if(P.test(r))n[r]=`[REDACTED]`,t=!0;else{let e=z(i,M);n[r]=e.value??``,t||=e.redacted}return{value:n,redacted:t}}function rt(e){return Ze(e)??z(e,M)}function I(e){return e===void 0?{redacted:!1}:it(e)??z(e,M)}function it(e){try{let t=R(JSON.parse(e),Xe);return B(JSON.stringify(t.value),M,t.redacted)}catch{return}}function L(e){return R(e,e=>z(e,M))}function R(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=R(e,t);return n||=r.redacted,r.value}),redacted:n}}let n=!1,r={};for(let[i,a]of Object.entries(e)){if(P.test(i)){r[i]=`[REDACTED]`,n=!0;continue}let e=R(a,t);r[i]=e.value,n||=e.redacted}return{value:r,redacted:n}}function z(e,t){if(e===void 0)return{redacted:!1};let n=Xe(e);return B(n.value,t,n.redacted)}function B(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 at=async(t,n={})=>{if(!t.backend.readLogs)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.logs is not supported by this backend`);return et(await t.backend.readLogs(await V(t,n),ct(n)))},ot=async(t,n={})=>{if(!t.backend.dumpNetwork)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.network is not supported by this backend`);let r=lt(n);return tt(await t.backend.dumpNetwork(await V(t,n),r),r.include??`summary`)},st=async(t,n={})=>{if(!t.backend.measurePerf)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.perf is not supported by this backend`);return nt(await t.backend.measurePerf(await V(t,n),ut(n)))};async function V(e,t){let n=f(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 ct(e){return{...H(e,100,500,`logs limit`),...e.levels===void 0?{}:{levels:W(e.levels,`levels`)},...e.search===void 0?{}:{search:w(e.search,`search`)},...e.source===void 0?{}:{source:w(e.source,`source`)}}}function lt(e){return{...H(e,25,200,`network limit`),include:dt(e.include)}}function ut(e){return{...U(e),...e.sampleMs===void 0?{}:{sampleMs:m(e.sampleMs,`sampleMs`,100,6e4)},...e.metrics===void 0?{}:{metrics:W(e.metrics,`metrics`,20)}}}function H(e,t,n,r){return{...U(e),...e.cursor===void 0?{}:{cursor:w(e.cursor,`cursor`)},limit:e.limit===void 0?t:m(e.limit,r,1,n)}}function U(e){return{...e.since===void 0?{}:{since:w(e.since,`since`)},...e.until===void 0?{}:{until:w(e.until,`until`)}}}function dt(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 W(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)=>w(e,`${n}[${t}]`))}const ft={logs:at,network:ot,perf:st},G=`contact_sheet_frame_extraction_failed`,K=`contact_sheet_no_frames`;function q(t=process.platform){if(t!==`darwin`)throw new e(`UNSUPPORTED_OPERATION`,`Contact sheets can only be built on macOS hosts, which is where the frame decoder runs`,{reason:`contact_sheet_unsupported_host`,hostPlatform:t,hint:`Run this command on the macOS host that recorded the clip, or read the video artifact itself.`})}async function pt(t){if(q(t.hostPlatform??process.platform),t.timesMs.length===0)throw new e(`COMMAND_FAILED`,`Contact sheet sampling requested no frames`,{reason:K,videoPath:t.videoPath});vt(t.signal);let n=await _t(t);vt(t.signal);let r;try{r=await oe(n,[`--input`,t.videoPath,`--output-dir`,t.scratchDir,`--times`,t.timesMs.join(`,`),`--max-width`,String(t.maxWidth)],{timeoutMs:9e4,env:ge(),allowFailure:!0,...t.signal===void 0?{}:{signal:t.signal}})}catch(e){X(e,t.videoPath,`Failed to run the frame decoder`)}if(r.exitCode!==0)throw new e(`COMMAND_FAILED`,`Failed to extract frames from the recording: ${gt(r.stderr)||`exit ${r.exitCode}`}`,{reason:G,videoPath:t.videoPath,exitCode:r.exitCode});let i=mt(r.stdout,t.videoPath,t.scratchDir,t.timesMs.length);if(i.frames.length===0)throw new e(`COMMAND_FAILED`,`The recording returned no decodable frames for a contact sheet`,{reason:K,videoPath:t.videoPath,skippedSampleCount:i.skippedSampleCount});return i}function mt(e,t,n,r){let i;try{i=JSON.parse(e)}catch(e){throw Y(t,`invalid manifest: ${String(e)}`)}let a=Z(i).frames;if(!Array.isArray(a))throw Y(t,`manifest has no frames array`);let o=Z(i).skipped;if(a.length>r)throw Y(t,`returned ${a.length} frames for ${r} requested samples`);let s=a.flatMap(e=>{let r=Z(e),i=ht(r.path),a=Q(r.actualTimeMs);if(i===void 0||a===void 0||a<0)throw Y(t,`frame entry is missing a path or presentation time`);let o=x.resolve(n,x.basename(i));return S.existsSync(o)?[{requestedTimeMs:Q(r.requestedTimeMs)??a,actualTimeMs:a,path:o}]:[]});return{frames:s.sort((e,t)=>e.actualTimeMs-t.actualTimeMs),skippedSampleCount:Math.max(Array.isArray(o)?o.length:0,r-s.length)}}function J(t,n,r){return new e(`COMMAND_FAILED`,t,{reason:G,videoPath:n},r)}function Y(e,t){return J(`Frame extraction returned an unreadable manifest: ${t}`,e)}function X(r,i,a){throw t(r)||r instanceof e&&r.code===`COMMAND_FAILED`&&r.details?.reason?r:J(`${a} for ${i}: ${n(r)}`,i,r)}function Z(e){return typeof e==`object`&&e?e:{}}function ht(e){return typeof e==`string`&&e!==``?e:void 0}function Q(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function gt(e){return(e.trim().split(`
+import{D as e,F as t,j as n,k as r}from"./sdk-contracts.js";import{i}from"./recording-export-quality.js";import{_ as a,a as o,d as s,f as c,g as l,i as u,o as d,p as f,r as p,t as ee,v as te,x as m,y as ne}from"./runtime.js";import{r as h}from"./success-text.js";import{n as re,t as ie}from"./app-inventory.js";import"./app-inventory-contract.js";import{D as ae}from"./owner-identity.js";import{c as oe}from"./exec.js";import"./file.js";import{r as se}from"./tv-remote.js";import"./command.js";import{r as g}from"./version.js";import{t as ce}from"./keyboard-actions.js";import{i as le}from"./quality-warnings.js";import{i as ue}from"./png-worker-client.js";import{r as _}from"./png.js";import{t as de}from"./png-size.js";import{i as v,n as fe,r as pe}from"./screenshot-overlay-draw.js";import{t as me}from"./png-encode.js";import{r as y}from"./artifact-paths.js";import{t as he}from"./mp4-duration.js";import{c as b,o as ge,r as _e,s as ve}from"./video.js";import x from"node:path";import S from"node:fs";import ye from"node:os";function C(e,t){if(e!==void 0)return w(e,t)}function w(t,n){let r=t?.trim();if(!r)throw new e(`INVALID_ARGS`,`${n} must be a non-empty string`);return r}const be=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(f(t,n),n.filter)}},xe=async(t,n={})=>{if(!t.backend.bootDevice)throw new e(`UNSUPPORTED_OPERATION`,`admin.boot is not supported by this backend`);let r=D(n.target),i=await t.backend.bootDevice(f(t,n),r),a=c(i);return{kind:`deviceBooted`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(`Booted device`)}},Se=async(t,n={})=>{if(!t.backend.shutdownDevice)throw new e(`UNSUPPORTED_OPERATION`,`admin.shutdown is not supported by this backend`);let r=D(n.target),i=await t.backend.shutdownDevice(f(t,n),r),a=c(i);return{kind:`deviceShutdown`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(`Shutdown device`)}},Ce=async(e,t)=>await T(e,t,`install`),we=async(e,t)=>await T(e,t,`reinstall`),Te=async(e,t)=>await T(e,t,`installFromSource`);async function T(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?w(n.app,`app`):void 0;if(r!==`installFromSource`&&!o)throw new e(`INVALID_ARGS`,`admin.${r} requires app`);let s=f(t,n),c=await Ee(t,s,n.source);try{let e=await a.call(t.backend,s,{...o?{app:o}:{},source:c.source});return ke(r,o,c.source,e)}finally{await c.cleanup?.()}}async function Ee(e,t,n){let r=await De(e,E(n));try{return{source:E(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 De(e,t){if(t.kind===`url`)return{source:t};let n=await u(e,t,{usage:`admin.install`,field:`source`});return{source:{kind:`path`,path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function E(t){if(!t||typeof t!=`object`)throw new e(`INVALID_ARGS`,`install source is required`);if(t.kind===`path`)return{kind:`path`,path:w(t.path,`source.path`)};if(t.kind===`uploadedArtifact`)return{kind:`uploadedArtifact`,id:w(t.id,`source.id`)};if(t.kind===`url`){let e=w(t.url,`source.url`);return Oe(e),{kind:`url`,url:e}}throw new e(`INVALID_ARGS`,`install source kind must be path, uploadedArtifact, or url`)}function Oe(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 D(e){if(!e)return;let t=C(e.id,`target.id`),n=C(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 ke(e,t,n,r){let i=c(r),a=e===`reinstall`?`appReinstalled`:e===`installFromSource`?`appInstalledFromSource`:`appInstalled`,o=O(r,`appName`),s=O(r,`appId`),l=O(r,`bundleId`),u=O(r,`packageName`),d=O(r,`launchTarget`),f=O(r,`installablePath`),p=O(r,`archivePath`);return{kind:a,...t?{app:t}:{},source:n,...s?{appId:s}:{},...o?{appName:o}:{},...l?{bundleId:l}:{},...u?{packageName:u}:{},...d?{launchTarget:d}:{},...f?{installablePath:f}:{},...p?{archivePath:p}:{},...i?{backendResult:i}:{},...h(`${e===`reinstall`?`Reinstalled`:`Installed`}: ${o??d??t??Ae(n)}`)}}function O(e,t){let n=e[t];return typeof n==`string`&&n.length>0?n:void 0}function Ae(e){return e.kind===`path`?e.path:e.kind===`uploadedArtifact`?e.id:e.url}const je=/^[A-Za-z0-9_.:-]{1,64}$/,Me=async(t,n)=>{if(!t.backend.openApp)throw new e(`UNSUPPORTED_OPERATION`,`apps.open is not supported by this backend`);let r=Re(n),i=await t.backend.openApp(A(t,n),r,{launchArgs:n.launchArgs,relaunch:n.relaunch}),a=c(i);return{kind:`appOpened`,target:r,relaunch:n.relaunch===!0,...a?{backendResult:a}:{},...h(`Opened: ${Be(r)}`)}},Ne=async(t,n={})=>{if(!t.backend.closeApp)throw new e(`UNSUPPORTED_OPERATION`,`apps.close is not supported by this backend`);let r=C(n.app,`app`),i=await t.backend.closeApp(A(t,n),r),a=c(i);return{kind:`appClosed`,...r?{app:r}:{},...a?{backendResult:a}:{},...h(r?`Closed: ${r}`:`Closed app`)}},Pe=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(A(t,n),ie(n.filter))}},Fe=async(t,n)=>{if(!t.backend.getAppState)throw new e(`UNSUPPORTED_OPERATION`,`apps.state is not supported by this backend`);let r=w(n.app,`app`);return{kind:`appState`,app:r,state:await t.backend.getAppState(A(t,n),r)}},Ie=async(t,n)=>{if(!t.backend.pushFile)throw new e(`UNSUPPORTED_OPERATION`,`apps.push is not supported by this backend`);let r=w(n.app,`app`),i=await Ve(t,n.input);try{let e=await t.backend.pushFile(A(t,n),i.backendInput,r),a=c(e);return{kind:`appPushed`,app:r,inputKind:i.inputKind,...a?{backendResult:a}:{},...h(`Pushed to ${r}`)}}finally{await i.cleanup?.()}},Le=async(t,n)=>{if(!t.backend.triggerAppEvent)throw new e(`UNSUPPORTED_OPERATION`,`apps.triggerEvent is not supported by this backend`);let r=He(n.name);Ue(n.payload,`apps.triggerEvent payload for "${r}"`);let i=await t.backend.triggerAppEvent(A(t,n),{name:r,...n.payload?{payload:n.payload}:{}}),a=c(i);return{kind:`appEventTriggered`,name:r,...n.payload?{payload:n.payload}:{},...a?{backendResult:a}:{},...h(`Triggered app event: ${r}`)}};function Re(t){let n=C(t.app,`app`),r=C(t.appId,`appId`),i=C(t.bundleId,`bundleId`),a=C(t.packageName,`packageName`),o=C(t.url,`url`),s=C(t.activity,`activity`),c={...n?{app:n}:{},...r?{appId:r}:{},...i?{bundleId:i}:{},...a?{packageName:a}:{},...o?{url:o}:{},...s?{activity:s}:{}};if(!ze(c))throw new e(`INVALID_ARGS`,`apps.open requires app, appId, bundleId, packageName, url, or activity`);return c}function ze(e){return!!(e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity)}function Be(e){return e.app??e.appId??e.bundleId??e.packageName??e.url??e.activity??`app`}async function Ve(t,n){if(!n||typeof n!=`object`)throw new e(`INVALID_ARGS`,`apps.push requires an input`);if(n.kind===`json`)return k(n.payload,`apps.push JSON payload`,8192),{backendInput:{kind:`json`,payload:n.payload},inputKind:`json`};let r=await u(t,n,{usage:`apps.push`,field:`input`});return{backendInput:{kind:`file`,path:r.path},inputKind:`file`,...r.cleanup?{cleanup:r.cleanup}:{}}}function He(t){let n=w(t,`name`);if(!je.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 Ue(e,t){e!==void 0&&k(e,t,8192)}function k(t,n,r){if(We(t,n),Buffer.byteLength(Ge(t,n),`utf8`)>r)throw new e(`INVALID_ARGS`,`${n} exceeds ${r} bytes`)}function We(t,n){if(!t||typeof t!=`object`||Array.isArray(t))throw new e(`INVALID_ARGS`,`${n} must be a JSON object`)}function Ge(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 A(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}const j={open:Me,close:Ne,list:Pe,state:Fe,push:Ie,triggerEvent:Le},Ke={devices:be,boot:xe,shutdown:Se,install:Ce,reinstall:we,installFromSource:Te};function qe(e){return{...s(j,e),list:(t={})=>j.list(e,{...t,filter:re(t.filter)})}}const Je=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,Ye=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function Xe(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(Ye,()=>(t=!0,`[REDACTED]`)),n=Qe(n,()=>{t=!0}),{value:n,redacted:t}}function Ze(e){try{let t=new URL(e),n=$e(t);return(t.username||t.password)&&(t.username=`REDACTED`,t.password=`REDACTED`,n=!0),{value:t.toString(),redacted:n}}catch{return}}function Qe(e,t){return/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(e)?e.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let n=Ze(e);return n?(n.redacted&&t(),n.value):e}):e}function $e(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))Je.test(n)&&(e.searchParams.set(n,`[REDACTED]`),t=!0);return t}const M=2048,N=4096,P=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function et(e){let t=e.redacted===!0;return{kind:`diagnosticsLogs`,entries:e.entries.map(e=>{let n=z(e.message,N),r=L(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 tt(e,t){let n=e.redacted===!0;return{kind:`diagnosticsNetwork`,entries:e.entries.map(e=>{let r=e.url?rt(e.url):void 0,i=t===`headers`||t===`all`?F(e.requestHeaders):void 0,a=t===`headers`||t===`all`?F(e.responseHeaders):void 0,o=t===`body`||t===`all`?I(e.requestBody):void 0,s=t===`body`||t===`all`?I(e.responseBody):void 0,c=L(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 nt(e){let t=e.redacted===!0;return{kind:`diagnosticsPerf`,metrics:e.metrics.map(e=>{let n=z(e.message,N),r=L(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 F(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[r,i]of Object.entries(e))if(P.test(r))n[r]=`[REDACTED]`,t=!0;else{let e=z(i,M);n[r]=e.value??``,t||=e.redacted}return{value:n,redacted:t}}function rt(e){return Ze(e)??z(e,M)}function I(e){return e===void 0?{redacted:!1}:it(e)??z(e,M)}function it(e){try{let t=R(JSON.parse(e),Xe);return B(JSON.stringify(t.value),M,t.redacted)}catch{return}}function L(e){return R(e,e=>z(e,M))}function R(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=R(e,t);return n||=r.redacted,r.value}),redacted:n}}let n=!1,r={};for(let[i,a]of Object.entries(e)){if(P.test(i)){r[i]=`[REDACTED]`,n=!0;continue}let e=R(a,t);r[i]=e.value,n||=e.redacted}return{value:r,redacted:n}}function z(e,t){if(e===void 0)return{redacted:!1};let n=Xe(e);return B(n.value,t,n.redacted)}function B(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 at=async(t,n={})=>{if(!t.backend.readLogs)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.logs is not supported by this backend`);return et(await t.backend.readLogs(await V(t,n),ct(n)))},ot=async(t,n={})=>{if(!t.backend.dumpNetwork)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.network is not supported by this backend`);let r=lt(n);return tt(await t.backend.dumpNetwork(await V(t,n),r),r.include??`summary`)},st=async(t,n={})=>{if(!t.backend.measurePerf)throw new e(`UNSUPPORTED_OPERATION`,`diagnostics.perf is not supported by this backend`);return nt(await t.backend.measurePerf(await V(t,n),ut(n)))};async function V(e,t){let n=f(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 ct(e){return{...H(e,100,500,`logs limit`),...e.levels===void 0?{}:{levels:W(e.levels,`levels`)},...e.search===void 0?{}:{search:w(e.search,`search`)},...e.source===void 0?{}:{source:w(e.source,`source`)}}}function lt(e){return{...H(e,25,200,`network limit`),include:dt(e.include)}}function ut(e){return{...U(e),...e.sampleMs===void 0?{}:{sampleMs:m(e.sampleMs,`sampleMs`,100,6e4)},...e.metrics===void 0?{}:{metrics:W(e.metrics,`metrics`,20)}}}function H(e,t,n,r){return{...U(e),...e.cursor===void 0?{}:{cursor:w(e.cursor,`cursor`)},limit:e.limit===void 0?t:m(e.limit,r,1,n)}}function U(e){return{...e.since===void 0?{}:{since:w(e.since,`since`)},...e.until===void 0?{}:{until:w(e.until,`until`)}}}function dt(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 W(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)=>w(e,`${n}[${t}]`))}const ft={logs:at,network:ot,perf:st},G=`contact_sheet_frame_extraction_failed`,K=`contact_sheet_no_frames`;function q(t=process.platform){if(t!==`darwin`)throw new e(`UNSUPPORTED_OPERATION`,`Contact sheets can only be built on macOS hosts, which is where the frame decoder runs`,{reason:`contact_sheet_unsupported_host`,hostPlatform:t,hint:`Run this command on the macOS host that recorded the clip, or read the video artifact itself.`})}async function pt(t){if(q(t.hostPlatform??process.platform),t.timesMs.length===0)throw new e(`COMMAND_FAILED`,`Contact sheet sampling requested no frames`,{reason:K,videoPath:t.videoPath});vt(t.signal);let n=await _t(t);vt(t.signal);let r;try{r=await oe(n,[`--input`,t.videoPath,`--output-dir`,t.scratchDir,`--times`,t.timesMs.join(`,`),`--max-width`,String(t.maxWidth)],{timeoutMs:9e4,env:ge(),allowFailure:!0,...t.signal===void 0?{}:{signal:t.signal}})}catch(e){X(e,t.videoPath,`Failed to run the frame decoder`)}if(r.exitCode!==0)throw new e(`COMMAND_FAILED`,`Failed to extract frames from the recording: ${gt(r.stderr)||`exit ${r.exitCode}`}`,{reason:G,videoPath:t.videoPath,exitCode:r.exitCode});let i=mt(r.stdout,t.videoPath,t.scratchDir,t.timesMs.length);if(i.frames.length===0)throw new e(`COMMAND_FAILED`,`The recording returned no decodable frames for a contact sheet`,{reason:K,videoPath:t.videoPath,skippedSampleCount:i.skippedSampleCount});return i}function mt(e,t,n,r){let i;try{i=JSON.parse(e)}catch(e){throw Y(t,`invalid manifest: ${String(e)}`)}let a=Z(i).frames;if(!Array.isArray(a))throw Y(t,`manifest has no frames array`);let o=Z(i).skipped;if(a.length>r)throw Y(t,`returned ${a.length} frames for ${r} requested samples`);let s=a.flatMap(e=>{let r=Z(e),i=ht(r.path),a=Q(r.actualTimeMs);if(i===void 0||a===void 0||a<0)throw Y(t,`frame entry is missing a path or presentation time`);let o=x.resolve(n,x.basename(i));return S.existsSync(o)?[{requestedTimeMs:Q(r.requestedTimeMs)??a,actualTimeMs:a,path:o}]:[]});return{frames:s.sort((e,t)=>e.actualTimeMs-t.actualTimeMs),skippedSampleCount:Math.max(Array.isArray(o)?o.length:0,r-s.length)}}function J(t,n,r){return new e(`COMMAND_FAILED`,t,{reason:G,videoPath:n},r)}function Y(e,t){return J(`Frame extraction returned an unreadable manifest: ${t}`,e)}function X(r,i,a){throw t(r)||r instanceof e&&r.code===`COMMAND_FAILED`&&r.details?.reason?r:J(`${a} for ${i}: ${n(r)}`,i,r)}function Z(e){return typeof e==`object`&&e?e:{}}function ht(e){return typeof e==`string`&&e!==``?e:void 0}function Q(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function gt(e){return(e.trim().split(`
 `).pop()??``).trim()}async function _t(e){try{return await ve({sourcePath:b(`recording-frames.swift`,g()),extraSourcePaths:[b(`RecordingExportSupport.swift`,g())],cacheName:`recording-frames`,timeoutMs:12e4})}catch(t){X(t,e.videoPath,`Could not build the frame decoder`)}}function vt(e){if(e?.aborted)throw r()}function yt(t,n){if(t===void 0||!Number.isFinite(t)||t<0)throw new e(`COMMAND_FAILED`,`Cannot plan a contact sheet: the video timeline of ${n} could not be read`,{reason:`contact_sheet_duration_unknown`,videoPath:n,hint:`Retry once the recording finished finalizing; a clip whose container is still being written has no readable duration.`});if(t<=250)return{durationMs:t,timesMs:t>0?[0,Math.round(t)]:[0]};let r=Math.min(48,Math.floor(t/250)+1),i=t/(r-1);return{durationMs:t,timesMs:Array.from({length:r},(e,t)=>Math.round(t*i))}}const bt=[360,320,280,240,200,160],xt=[255,255,255,255],St=[17,24,39,255],$=pe(2)+8;function Ct(t){let{cells:n}=t;if(n.length===0)throw new e(`COMMAND_FAILED`,`Contact sheet has no cells to render`);let r=Tt(n[0].image.height/Math.max(1,n[0].image.width),n.length,t),i=Ot(r.width,r.height,St);return n.forEach((e,t)=>{let n=t%r.columns,a=Math.floor(t/r.columns);wt(i,8+n*(r.cellWidth+8),8+a*($+r.cellHeight+8),e,r.cellWidth,r.cellHeight)}),{bytes:me(i.data,r.width,r.height,4),width:r.width,height:r.height,cellWidth:r.cellWidth}}function wt(e,t,n,r,i,a){fe(e,{x:t+4,y:n+4,text:jt(r.timeMs),color:xt,scale:2}),kt(e,le(At(r.image),i,a),t,n+$)}function Tt(t,n,r){let i=Et(t,n,r.maxPixels);if(i)return i;let a=Dt(t,n,160);throw new e(`COMMAND_FAILED`,`Contact sheet would be ${a.width*a.height} pixels, above the configured maxImagePixels limit of ${r.maxPixels}`,{reason:`contact_sheet_pixel_budget_exceeded`,cellCount:r.cells.length,maxPixels:r.maxPixels,hint:`Shorten the recording or raise the command policy maxImagePixels limit.`})}function Et(e,t,n){for(let r of bt){let i=Dt(e,t,r);if(i.width*i.height<=n)return i}}function Dt(e,t,n){let r=Math.min(4,t),i=Math.ceil(t/r),a=Math.max(1,Math.round(n*e));return{columns:r,cellWidth:n,cellHeight:a,width:16+r*n+(r-1)*8,height:16+i*($+a)+(i-1)*8}}function Ot(e,t,n){let r=new _.PNG({width:e,height:t});for(let i=0;i<t;i+=1)for(let t=0;t<e;t+=1)v(r,t,i,n);return r}function kt(e,t,n,r){for(let i=0;i<t.height;i+=1)for(let a=0;a<t.width;a+=1){let o=(i*t.width+a)*4;v(e,n+a,r+i,[t.data[o],t.data[o+1],t.data[o+2],t.data[o+3]])}}function At(e){let t=new _.PNG({width:e.width,height:e.height});return Buffer.from(e.data.buffer,e.data.byteOffset,e.data.byteLength).copy(t.data),t}function jt(e){let t=Math.floor(e/1e3),n=Math.floor(t/3600),r=Math.floor(t%3600/60),i=t%60,a=Math.floor(e%1e3);return`${[n,r,i].map(e=>String(e).padStart(2,`0`)).join(`:`)}.${String(a).padStart(3,`0`)}`}function Mt(e,t){if(e.width!==t.width||e.height!==t.height)return{status:`dimension_mismatch`};let n=e.width*e.height;if(n===0)return{status:`compared`,changedPixelRatio:0};if(e.data.length!==t.data.length)return{status:`dimension_mismatch`};let r=0;for(let n=0;n+3<e.data.length;n+=4)(e.data[n]!==t.data[n]||e.data[n+1]!==t.data[n+1]||e.data[n+2]!==t.data[n+2])&&(r+=1);return{status:`compared`,changedPixelRatio:r/n}}function Nt(e,t=.02,n=24){let r=[],i;for(let n of e){let e=i?Ft(i,n.image):1;e<t||(r.push({timeMs:n.timeMs,changedPixelRatio:e,image:n.image}),i=n.image)}Pt(r,e);let a=r.length>n?It(r,n):r;return{cells:a,keptCellCount:r.length,thinned:a.length<r.length}}function Pt(e,t){let n=t.at(-1);if(!n)return;let r=e.at(-1);!r||r.timeMs===n.timeMs||e.push({timeMs:n.timeMs,changedPixelRatio:Ft(r.image,n.image),image:n.image})}function Ft(e,t){let n=Mt(e,t);return n.status===`compared`?n.changedPixelRatio:1}function It(e,t){if(t<=1)return[e.at(-1)];let n=(e.length-1)/(t-1);return Array.from({length:t},(t,r)=>e[Math.round(r*n)])}async function Lt(t){q(t.hostPlatform??process.platform);let n=x.resolve(t.videoPath),r=x.resolve(t.outputPath??y(n));Bt(n,r);let i=await _e(n);if(i!==`mp4`)throw new e(`INVALID_ARGS`,i===`webm`?`Contact sheets need an MP4 recording; ${n} is WebM, whose frames this decoder does not read`:`Contact sheets need an MP4 recording; ${n} is not a readable MP4`,{reason:`contact_sheet_container_unsupported`,videoPath:n,container:i??`unknown`,hint:`Re-record on a backend that exports MP4, or pass the MP4 artifact the recording produced.`});let a=yt(he(n),n),o=S.mkdtempSync(x.join(ye.tmpdir(),`agent-device-contact-sheet-`));try{let e=await pt({videoPath:n,scratchDir:o,timesMs:a.timesMs,maxWidth:360,hostPlatform:t.hostPlatform??process.platform,...t.signal===void 0?{}:{signal:t.signal}}),i=await Rt(e.frames,t.maxPixels);zt(t.signal);let s=Nt(i,t.changedPixelThreshold??.02),c=Ct({cells:s.cells,maxPixels:t.maxPixels});return Gt(r,c.bytes),{path:r,videoPath:n,durationMs:a.durationMs,width:c.width,height:c.height,sampledFrameCount:a.timesMs.length,decodedFrameCount:e.frames.length,skippedSampleCount:e.skippedSampleCount,changedPixelThreshold:t.changedPixelThreshold??.02,cells:s.cells.map(Ut),...Wt(s,e)}}finally{S.rmSync(o,{recursive:!0,force:!0})}}async function Rt(t,n){let r=[];for(let i of t){let t=await de(i.path);if(t.width>360)throw new e(`COMMAND_FAILED`,`Frame extraction returned a ${t.width}px-wide frame when the sheet asked for 360px cells`,{reason:G,framePath:i.path,frameWidth:t.width,frameWidthLimit:360});if(t.width*t.height>n)throw new e(`COMMAND_FAILED`,`Frame extraction returned a ${t.width}x${t.height} frame, above the ${n}-pixel budget for the whole sheet`,{reason:G,framePath:i.path,framePixels:t.width*t.height,maxPixels:n});let a=await ue(S.readFileSync(i.path),`recording frame`);r.push({timeMs:i.actualTimeMs,image:a})}return r}function zt(e){if(e?.aborted)throw r()}function Bt(t,n){if(Vt(t,n)??n===t)throw new e(`INVALID_ARGS`,`A contact sheet cannot be written over the recording it describes: ${n}`,{reason:`contact_sheet_output_collides_with_input`,videoPath:t,outputPath:n,hint:`Choose a different --out path, or omit it to write beside the recording.`})}function Vt(e,t){let n=Ht(e),r=Ht(t);if(n!==void 0&&r!==void 0)return n.dev===r.dev&&n.ino===r.ino}function Ht(e){try{return S.statSync(e)}catch{return}}function Ut(e){return{timeMs:e.timeMs,changedPixelRatio:e.changedPixelRatio}}function Wt(e,t){let n=[];return t.skippedSampleCount>0&&n.push(`${t.skippedSampleCount} sample times returned no frame, so the sheet covers less of the recording than it asked for`),e.thinned&&n.push(`${e.keptCellCount} changes were found and 24 cells are printed, so the sheet thins evenly across the recording instead of showing every change`),n.length===0?{}:{warning:n.join(`; `)}}function Gt(t,n){try{S.mkdirSync(x.dirname(t),{recursive:!0}),ae({destination:t,contents:n})}catch(n){throw new e(`COMMAND_FAILED`,`Failed to write the contact sheet to ${t}: ${n instanceof Error?n.message:String(n)}`,{reason:`contact_sheet_output_write_failed`,outputPath:t})}}const Kt=async(t,n)=>{if(!n.video)throw new e(`INVALID_ARGS`,`record contact-sheet requires a recording to read`);Jt(n.changedPixelThreshold);let r=await u(t,n.video,{usage:`record contact-sheet`,field:`video`}),i;try{let e=qt(n,n.video,r.path);i=await p(t,e,{field:`path`,ext:`.png`,artifactType:`screen-recording-contact-sheet`});let a=await Lt({videoPath:r.path,outputPath:i.path,maxPixels:t.policy.maxImagePixels,...n.changedPixelThreshold===void 0?{}:{changedPixelThreshold:n.changedPixelThreshold},signal:n.signal??t.signal}),o=await i.publish();return{...a,path:Yt(a.path,o),...o?{artifact:o}:{}}}catch(e){throw await i?.cleanup?.(),e}finally{await r.cleanup?.()}};function qt(t,n,r){if(t.out)return t.out;if(n.kind===`path`)return{kind:`path`,path:x.resolve(y(n.path||r))};throw new e(`INVALID_ARGS`,`record contact-sheet needs an output path when the recording is an uploaded artifact`,{hint:"Pass --out <sheet.png> (CLI) or `out` (Node) to name where the sheet is written."})}function Jt(t){if(t!==void 0&&(!Number.isFinite(t)||t<0||t>1))throw new e(`INVALID_ARGS`,`record contact-sheet needs a changedPixelThreshold between 0 and 1, got ${t}`,{reason:`contact_sheet_threshold_invalid`,changedPixelThreshold:t,hint:`Omit it to use the calibrated default, or pass a share of the frame between 0 and 1.`})}function Yt(e,t){return t?t.kind===`localPath`?t.path:t.clientPath??e:e}const Xt=async(t,n)=>{let r=tn(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 p(t,n.out,{field:`path`,ext:`.mp4`,artifactType:`screen-recording`}):void 0;try{let e=Qt(n,a?.path);return nn(r,await i.call(t.backend,f(t,n),e),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}},Zt=async(t,n)=>{let r=tn(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 p(t,n.out,{field:`outPath`,ext:`.trace`,artifactType:`trace-log`}):void 0;try{let e=a?.path?{outPath:a.path}:{};return rn(r,await i.call(t.backend,f(t,n),e),await a?.publish())}catch(e){throw await a?.cleanup?.(),e}};function Qt(e,t){let n={};t&&(n.outPath=t);let r=$t(e.fps);r!==void 0&&(n.fps=r);let i=en(e.quality);return i!==void 0&&(n.quality=i),e.hideTouches!==void 0&&(n.showTouches=e.hideTouches!==!0),n}function $t(e){return e===void 0?void 0:m(e,`fps`,1,60)}function en(t){if(t===void 0)return;let n=i(t);if(n===void 0)throw new e(`INVALID_ARGS`,`quality must be one of: medium, high (legacy numeric values 5-10 are accepted)`);return n}function tn(t,n){if(t===`start`||t===`stop`)return t;throw new e(`INVALID_ARGS`,`${n} action must be start or stop`)}function nn(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}:{},...an(e,t,n,{startKind:`recordingStarted`,stopKind:`recordingStopped`,startMessage:`Recording started`,stopMessage:`Recording stopped`})}}function rn(e,t,n){return{...typeof t.outPath==`string`?{outPath:t.outPath}:{},...an(e,t,n,{startKind:`traceStarted`,stopKind:`traceStopped`,startMessage:`Trace started`,stopMessage:`Trace stopped`})}}function an(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 on={record:Xt,trace:Zt,contactSheet:Kt},sn=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(f(t,n),{mode:r}),a=c(i);return{kind:`systemBack`,mode:r,...a?{backendResult:a}:{},...h(`Back`)}},cn=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(f(t,n)),i=c(r);return{kind:`systemHome`,...i?{backendResult:i}:{},...h(`Home`)}},ln=async(t,n)=>{if(!t.backend.pressTvRemote)throw new e(`UNSUPPORTED_OPERATION`,`system.tvRemote is not supported by this backend`);let r=se(n.button),i=n.durationMs===void 0?void 0:m(n.durationMs,`durationMs`,0,1e4),a=await t.backend.pressTvRemote(f(t,n),{button:r,...i===void 0?{}:{durationMs:i}}),o=c(a);return{kind:`tvRemotePressed`,button:r,...i===void 0?{}:{durationMs:i},...o?{backendResult:o}:{},...h(`Pressed TV remote ${r}`)}},un=async(t,n)=>{if(!t.backend.setOrientation)throw new e(`UNSUPPORTED_OPERATION`,`system.orientation is not supported by this backend`);let r=gn(n.orientation),i=await t.backend.setOrientation(f(t,n),r),a=c(i);return{kind:`systemOrientationSet`,orientation:r,...a?{backendResult:a}:{},...h(`Rotated to ${r}`)}},dn=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(!ce(r))throw new e(`INVALID_ARGS`,`system.keyboard action must be status, get, dismiss, enter, or return`);let i=await t.backend.setKeyboard(f(t,n),{action:r}),a=c(i),o=Tn(i)?i:{};return r===`enter`||r===`return`?vn(o,a):r===`dismiss`?yn(r,o,a):xn(r,o,a)},fn=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(f(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(f(t,n),n.text),i=c(r);return{kind:`clipboardUpdated`,action:`write`,textLength:Array.from(n.text).length,...i?{backendResult:i}:{},...h(`Clipboard updated`)}},pn=async(t,n={})=>{if(!t.backend.openSettings)throw new e(`UNSUPPORTED_OPERATION`,`system.settings is not supported by this backend`);let r=C(n.target,`target`),i=await t.backend.openSettings(f(t,n),r),a=c(i);return{kind:`settingsOpened`,...r?{target:r}:{},...a?{backendResult:a}:{},...h(r?`Opened settings: ${r}`:`Opened settings`)}},mn=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:m(n.timeoutMs,`timeoutMs`,0,12e4);return _n(r,await t.backend.handleAlert(f(t,n),r,{timeoutMs:i}))},hn=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(f(t,n)),i=c(r);return{kind:`appSwitcherOpened`,...i?{backendResult:i}:{},...h(`Opened app switcher`)}};function gn(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 _n(e,t){return e===`get`?Sn(t):e===`wait`?Cn(t):wn(e,t)}function vn(e,t){return{kind:`keyboardEnterPressed`,action:`enter`,state:e,...t?{backendResult:t}:{},...h(`Keyboard enter pressed`)}}function yn(e,t,n){return{kind:`keyboardDismissed`,action:e,state:t,...n?{backendResult:n}:{},...h(bn(t))}}function bn(e){return e.dismissed===!1?`Keyboard already hidden`:e.mechanism===`dismissKey`?`Keyboard dismissed via its dismiss key`:`Keyboard dismissed`}function xn(e,t,n){return{kind:`keyboardState`,action:e,state:t,...n?{backendResult:n}:{}}}function Sn(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 Cn(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 wn(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 Tn(e){return!!(e&&typeof e==`object`)}const En={back:sn,home:cn,orientation:un,keyboard:dn,clipboard:fn,settings:pn,alert:mn,appSwitcher:hn,tvRemote:ln};function Dn(e){return{capture:ee(e),selectors:d(e),interactions:o(e),system:s(En,e),apps:qe(e),admin:s(Ke,e),recording:s(on,e),observability:s(ft,e)}}function On(e){let t=l(e);return{...t,...Dn(t)}}export{On as createAgentDevice,a as createMemorySessionStore,te as localCommandPolicy,ne as restrictedCommandPolicy};