agent-device 0.12.8 → 0.13.0

package/dist/src/4829.js

@@ -0,0 +1 @@
+function e(e,t,r){if(!e)return t;let n=Number(e);return Number.isFinite(n)?Math.max(r,Math.floor(n)):t}function t(e){return new Promise(t=>setTimeout(t,e))}function r(t,r,n){return e(t,r,n)}export{e as resolveTimeoutMs,r as resolveTimeoutSeconds,t as sleep};

package/dist/src/7847.js

@@ -1 +1 @@
-import{AppError as e}from"./9152.js";import{normalizeText as t}from"./7556.js";function r(e){var t;let r,n=i(e.label),l=i(e.value),o=i(e.identifier),a=(t=o)&&!/^[\w.]+:id\/[\w.-]+$/i.test(t)&&!/^_?NS:\d+$/i.test(t)?o:"";return(r=u(e.type??"")).includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||r.includes("textview")||r.includes("textarea")?l||n||a:n||l||a}function n(e){let t=e.replace(/\s+/g," ").trim();return t.length<=48?t:`${t.slice(0,45)}...`}function l(e,t){var n;let l=r(e),i=function(e,t){if("text-view"===t||"text-field"===t||"search"===t)return!0;let r=u(e.type??""),n=`${e.role??""} ${e.subrole??""}`.toLowerCase();return r.includes("textview")||r.includes("textarea")||r.includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||n.includes("text area")||n.includes("text field")}(e,t);return{text:l,isLargeSurface:i,shouldSummarize:i&&!!(n=l)&&(n.length>80||/[\r\n]/.test(n))}}function i(e){return"string"==typeof e?e.trim():""}function u(e){let t=e.trim().replace(/XCUIElementType/gi,"").replace(/^AX/,"").toLowerCase(),r=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==r&&(t=t.slice(r+1)),t}let o=new Set(["id","role","text","label","value","appname","windowtitle"]),a=new Set(["visible","hidden","editable","selected","enabled","hittable"]),s=new Set([...o,...a]);function c(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Selector expression cannot be empty");let n=function(t){let r=[],n="",l=null;for(let i=0;i<t.length;i+=1){let u=t[i];if(('"'===u||"'"===u)&&!g(t,i)){l=b(l,u),n+=u;continue}if(!l&&"|"===u&&"|"===t[i+1]){let l=n.trim();if(!l)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);r.push(l),n="",i+=1;continue}n+=u}let i=n.trim();if(!i)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);return r.push(i),r}(r);if(0===n.length)throw new e("INVALID_ARGS","Selector expression cannot be empty");return{raw:r,selectors:n.map(t=>(function(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Selector segment cannot be empty");let n=function(t){let r=[],n="",l=null;for(let e=0;e<t.length;e+=1){let i=t[e];if(('"'===i||"'"===i)&&!g(t,e)){l=b(l,i),n+=i;continue}if(!l&&/\s/.test(i)){n.trim()&&r.push(n.trim()),n="";continue}n+=i}if(l)throw new e("INVALID_ARGS",`Unclosed quote in selector: ${t}`);return n.trim()&&r.push(n.trim()),r}(r);if(0===n.length)throw new e("INVALID_ARGS",`Invalid selector segment: ${t}`);return{raw:r,terms:n.map(m)}})(t))}}function f(e){try{return c(e)}catch{return null}}function d(e){let t=e.trim();if(!t)return!1;if("||"===t)return!0;let r=t.indexOf("=");if(-1!==r){let e=t.slice(0,r).trim().toLowerCase();return s.has(e)}return s.has(t.toLowerCase())}function h(e,t={}){if(0===e.length)return null;let r=t.preferTrailingValue??!1,n=0,l=[];for(;n<e.length&&d(e[n]);){n+=1;let t=e.slice(0,n).join(" ").trim();t&&f(t)&&l.push(n)}if(0===l.length)return null;let i=l[l.length-1];if(r){for(let t=l.length-1;t>=0;t-=1)if(l[t]<e.length){i=l[t];break}}let u=e.slice(0,i).join(" ").trim();return u?{selectorExpression:u,rest:e.slice(i)}:null}function p(e){let t=e[0]??"",r=h(e.slice(1),{preferTrailingValue:"text"===t});return{predicate:t,split:r}}function m(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Empty selector term");let n=r.indexOf("=");if(-1===n){let n=r.toLowerCase();if(!a.has(n))throw new e("INVALID_ARGS",`Invalid selector term "${t}", expected key=value`);return{key:n,value:!0}}let l=r.slice(0,n).trim().toLowerCase(),i=r.slice(n+1).trim();if(!s.has(l))throw new e("INVALID_ARGS",`Unknown selector key: ${l}`);if(!i)throw new e("INVALID_ARGS",`Missing selector value for key: ${l}`);if(a.has(l)){let t,r="true"===(t=w(i).toLowerCase())||"false"!==t&&null;if(null===r)throw new e("INVALID_ARGS",`Invalid boolean value for ${l}: ${i}`);return{key:l,value:r}}return{key:l,value:w(i)}}function b(e,t){return e?e===t?null:e:t}function w(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1).replace(/\\(["'])/g,"$1"):t}function g(e,t){let r=0;for(let n=t-1;n>=0&&"\\"===e[n];n-=1)r+=1;return r%2==1}function x(e,t){let r=t.toLowerCase();return e.find(e=>{let t=(e.label??"").toLowerCase(),n=(e.value??"").toLowerCase(),l=(e.identifier??"").toLowerCase();return t.includes(r)||n.includes(r)||l.includes(r)})??null}function v(e,t){let r=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);return r&&S(r)?r:function(e,t){if(!e.rect)return;let r=e.rect.y+e.rect.height/2,n=null;for(let e of t){if(!e.rect)continue;let t=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);if(!t||!S(t))continue;let l=Math.abs(e.rect.y+e.rect.height/2-r);(!n||l<n.distance)&&(n={label:t,distance:l})}return n?.label}(e,t)??(r&&S(r)?r:void 0)}function S(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function I(e){let t=[],r=[];for(let n of e){let e=n.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let l=$(n.type??""),i=[n.label,n.value,n.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0),u=!!i&&S(i);if(("group"===l||"ioscontentgroup"===l)&&!u){t.push(e);continue}let o=Math.max(0,e-t.length);r.push({...n,depth:o})}return r}function $(e){let t=e.trim().replace(/XCUIElementType/gi,"");t.startsWith("AX")&&(t=t.slice(2));let r=Math.max((t=t.toLowerCase()).lastIndexOf("."),t.lastIndexOf("/"));return -1!==r&&(t=t.slice(r+1)),t}function A(e,t){let r=$(e);return!r||("android"===t?r.includes("edittext")||r.includes("autocompletetextview"):r.includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("textview")||r.includes("textarea")||"search"===r)}function y(e,t){if(t.hittable)return t;let r=t,n=new Set;for(;void 0!==r.parentIndex&&!n.has(r.ref);){n.add(r.ref);let t=e[r.parentIndex];if(!t)break;if(t.hittable)return t;r=t}return null}function N(e){return[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").filter(e=>e.length>0)[0]??""}function L(e){return r(e)}function C(e){return!0===e.hittable||!!e.rect&&e.rect.width>0&&e.rect.height>0}function _(e,t){return A(e.type??"",t)&&!1!==e.enabled}function R(e,t,r){return t.terms.every(t=>(function(e,t,r){switch(t.key){case"id":return V(e.identifier,String(t.value));case"role":return V($(e.type??""),String(t.value));case"label":return V(e.label,String(t.value));case"value":return V(e.value,String(t.value));case"text":return V(N(e),String(t.value));case"appname":return V(e.appName,String(t.value));case"windowtitle":return V(e.windowTitle,String(t.value));case"visible":return C(e)===!!t.value;case"hidden":return!C(e)==!!t.value;case"editable":return _(e,r)===!!t.value;case"selected":return!0===e.selected==!!t.value;case"enabled":return!1!==e.enabled==!!t.value;case"hittable":return!0===e.hittable==!!t.value;default:return!1}})(e,t,r))}function V(e,r){return t(e??"")===t(r)}function T(e,t,r){let n=r.requireRect??!1,l=r.requireUnique??!0,i=[];for(let u=0;u<t.selectors.length;u+=1){let o=t.selectors[u],a=function(e,t,r,n){let l=0,i=null,u=null,o=!1;for(let a of e){if(n&&!a.rect||!R(a,t,r))continue;if(l+=1,i??=a,!u){u=a;continue}let e=function(e,t){let r=e.depth??0,n=t.depth??0;if(r!==n)return r>n?1:-1;let l=k(e),i=k(t);return l!==i?l<i?1:-1:0}(a,u);e>0?(u=a,o=!1):0===e&&(o=!0)}return{count:l,firstNode:i,disambiguated:o?null:u}}(e,o,r.platform,n);if(i.push({selector:o.raw,matches:a.count}),0!==a.count&&a.firstNode){if(l&&1!==a.count){if(!r.disambiguateAmbiguous||!a.disambiguated)continue;return{node:a.disambiguated,selector:o,selectorIndex:u,matches:a.count,diagnostics:i}}return{node:a.firstNode,selector:o,selectorIndex:u,matches:a.count,diagnostics:i}}}return null}function G(e,t,r){let n=r.requireRect??!1,l=[];for(let i=0;i<t.selectors.length;i+=1){let u=t.selectors[i],o=function(e,t,r,n){let l=0;for(let i of e)(!n||i.rect)&&R(i,t,r)&&(l+=1);return l}(e,u,r.platform,n);if(l.push({selector:u.raw,matches:o}),o>0)return{selectorIndex:i,selector:u,matches:o,diagnostics:l}}return null}function D(e,t,r){if(0===t.length)return`Selector did not match: ${e.raw}`;let n=t.map(e=>`${e.selector} -> ${e.matches}`).join(", ");return r.unique??!0?`Selector did not resolve uniquely (${n})`:`Selector did not match (${n})`}function k(e){return e.rect?e.rect.width*e.rect.height:1/0}function M(e,t,r={}){let n=[],l=$(e.type??""),i=O(e.identifier),u=O(e.label),o=O(e.value),a=O(N(e)),s="fill"===r.action;i&&n.push(`id=${q(i)}`),l&&u&&n.push(s?`role=${q(l)} label=${q(u)} editable=true`:`role=${q(l)} label=${q(u)}`),u&&n.push(s?`label=${q(u)} editable=true`:`label=${q(u)}`),o&&n.push(s?`value=${q(o)} editable=true`:`value=${q(o)}`),a&&a!==u&&a!==o&&n.push(s?`text=${q(a)} editable=true`:`text=${q(a)}`),l&&s&&!n.some(e=>e.includes("editable=true"))&&n.push(`role=${q(l)} editable=true`);let c=Array.from(new Set(n));return 0===c.length&&l&&c.push(s?`role=${q(l)} editable=true`:`role=${q(l)}`),0===c.length&&C(e)&&c.push("visible=true"),c}function q(e){return JSON.stringify(e)}function O(e){if(!e)return null;let t=e.trim();return t||null}export{M as buildSelectorChainForNode,n as buildTextPreview,l as describeTextSurface,L as extractNodeReadText,N as extractNodeText,r as extractReadableText,y as findNearestHittableAncestor,x as findNodeByLabel,G as findSelectorChainMatch,D as formatSelectorFailure,A as isFillableType,_ as isNodeEditable,C as isNodeVisible,d as isSelectorToken,$ as normalizeType,c as parseSelectorChain,I as pruneGroupNodes,v as resolveRefLabel,T as resolveSelectorChain,p as splitIsSelectorArgs,h as splitSelectorFromArgs,i as trimText,f as tryParseSelectorChain};
+import{AppError as e}from"./9152.js";import{normalizeText as t}from"./7556.js";function r(e){var t;let r,n=i(e.label),l=i(e.value),o=i(e.identifier),a=(t=o)&&!/^[\w.]+:id\/[\w.-]+$/i.test(t)&&!/^_?NS:\d+$/i.test(t)?o:"";return(r=u(e.type??"")).includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||r.includes("textview")||r.includes("textarea")?l||n||a:n||l||a}function n(e){let t=e.replace(/\s+/g," ").trim();return t.length<=48?t:`${t.slice(0,45)}...`}function l(e,t){var n;let l=r(e),i=function(e,t){if("text-view"===t||"text-field"===t||"search"===t)return!0;let r=u(e.type??""),n=`${e.role??""} ${e.subrole??""}`.toLowerCase();return r.includes("textview")||r.includes("textarea")||r.includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||n.includes("text area")||n.includes("text field")}(e,t);return{text:l,isLargeSurface:i,shouldSummarize:i&&!!(n=l)&&(n.length>80||/[\r\n]/.test(n))}}function i(e){return"string"==typeof e?e.trim():""}function u(e){let t=e.trim().replace(/XCUIElementType/gi,"").replace(/^AX/,"").toLowerCase(),r=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==r&&(t=t.slice(r+1)),t}let o=new Set(["id","role","text","label","value","appname","windowtitle"]),a=new Set(["visible","hidden","editable","selected","enabled","hittable"]),c=new Set([...o,...a]);function s(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Selector expression cannot be empty");let n=function(t){let r=[],n="",l=null;for(let i=0;i<t.length;i+=1){let u=t[i];if(('"'===u||"'"===u)&&!g(t,i)){l=b(l,u),n+=u;continue}if(!l&&"|"===u&&"|"===t[i+1]){let l=n.trim();if(!l)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);r.push(l),n="",i+=1;continue}n+=u}let i=n.trim();if(!i)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);return r.push(i),r}(r);if(0===n.length)throw new e("INVALID_ARGS","Selector expression cannot be empty");return{raw:r,selectors:n.map(t=>(function(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Selector segment cannot be empty");let n=function(t){let r=[],n="",l=null;for(let e=0;e<t.length;e+=1){let i=t[e];if(('"'===i||"'"===i)&&!g(t,e)){l=b(l,i),n+=i;continue}if(!l&&/\s/.test(i)){n.trim()&&r.push(n.trim()),n="";continue}n+=i}if(l)throw new e("INVALID_ARGS",`Unclosed quote in selector: ${t}`);return n.trim()&&r.push(n.trim()),r}(r);if(0===n.length)throw new e("INVALID_ARGS",`Invalid selector segment: ${t}`);return{raw:r,terms:n.map(m)}})(t))}}function f(e){try{return s(e)}catch{return null}}function d(e){let t=e.trim();if(!t)return!1;if("||"===t)return!0;let r=t.indexOf("=");if(-1!==r){let e=t.slice(0,r).trim().toLowerCase();return c.has(e)}return c.has(t.toLowerCase())}function h(e,t={}){if(0===e.length)return null;let r=t.preferTrailingValue??!1,n=0,l=[];for(;n<e.length&&d(e[n]);){n+=1;let t=e.slice(0,n).join(" ").trim();t&&f(t)&&l.push(n)}if(0===l.length)return null;let i=l[l.length-1];if(r){for(let t=l.length-1;t>=0;t-=1)if(l[t]<e.length){i=l[t];break}}let u=e.slice(0,i).join(" ").trim();return u?{selectorExpression:u,rest:e.slice(i)}:null}function p(e){let t=e[0]??"",r=h(e.slice(1),{preferTrailingValue:"text"===t});return{predicate:t,split:r}}function m(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Empty selector term");let n=r.indexOf("=");if(-1===n){let n=r.toLowerCase();if(!a.has(n))throw new e("INVALID_ARGS",`Invalid selector term "${t}", expected key=value`);return{key:n,value:!0}}let l=r.slice(0,n).trim().toLowerCase(),i=r.slice(n+1).trim();if(!c.has(l))throw new e("INVALID_ARGS",`Unknown selector key: ${l}`);if(!i)throw new e("INVALID_ARGS",`Missing selector value for key: ${l}`);if(a.has(l)){let t,r="true"===(t=w(i).toLowerCase())||"false"!==t&&null;if(null===r)throw new e("INVALID_ARGS",`Invalid boolean value for ${l}: ${i}`);return{key:l,value:r}}return{key:l,value:w(i)}}function b(e,t){return e?e===t?null:e:t}function w(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1).replace(/\\(["'])/g,"$1"):t}function g(e,t){let r=0;for(let n=t-1;n>=0&&"\\"===e[n];n-=1)r+=1;return r%2==1}function v(e,t){let r=t.toLowerCase();return e.find(e=>{let t=(e.label??"").toLowerCase(),n=(e.value??"").toLowerCase(),l=(e.identifier??"").toLowerCase();return t.includes(r)||n.includes(r)||l.includes(r)})??null}function x(e,t){let r=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);return r&&S(r)?r:function(e,t){if(!e.rect)return;let r=e.rect.y+e.rect.height/2,n=null;for(let e of t){if(!e.rect)continue;let t=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);if(!t||!S(t))continue;let l=Math.abs(e.rect.y+e.rect.height/2-r);(!n||l<n.distance)&&(n={label:t,distance:l})}return n?.label}(e,t)??(r&&S(r)?r:void 0)}function S(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function I(e){let t=[],r=[];for(let n of e){let e=n.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let l=u(n.type??""),i=[n.label,n.value,n.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0),o=!!i&&S(i);if(("group"===l||"ioscontentgroup"===l)&&!o){t.push(e);continue}let a=Math.max(0,e-t.length);r.push({...n,depth:a})}return r}function $(e,t){let r=u(e);return!r||("android"===t?r.includes("edittext")||r.includes("autocompletetextview"):r.includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("textview")||r.includes("textarea")||"search"===r)}function A(e,t){if(t.hittable)return t;let r=t,n=new Set;for(;void 0!==r.parentIndex&&!n.has(r.ref);){n.add(r.ref);let t=e[r.parentIndex];if(!t)break;if(t.hittable)return t;r=t}return null}function y(e){return[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").filter(e=>e.length>0)[0]??""}function N(e){return r(e)}function L(e){return!0===e.hittable||!!e.rect&&e.rect.width>0&&e.rect.height>0}function _(e,t){return $(e.type??"",t)&&!1!==e.enabled}function C(e,t,r){return t.terms.every(t=>(function(e,t,r){switch(t.key){case"id":return R(e.identifier,String(t.value));case"role":return R(u(e.type??""),String(t.value));case"label":return R(e.label,String(t.value));case"value":return R(e.value,String(t.value));case"text":return R(y(e),String(t.value));case"appname":return R(e.appName,String(t.value));case"windowtitle":return R(e.windowTitle,String(t.value));case"visible":return L(e)===!!t.value;case"hidden":return!L(e)==!!t.value;case"editable":return _(e,r)===!!t.value;case"selected":return!0===e.selected==!!t.value;case"enabled":return!1!==e.enabled==!!t.value;case"hittable":return!0===e.hittable==!!t.value;default:return!1}})(e,t,r))}function R(e,r){return t(e??"")===t(r)}function V(e,t,r){let n=r.requireRect??!1,l=r.requireUnique??!0,i=[];for(let u=0;u<t.selectors.length;u+=1){let o=t.selectors[u],a=function(e,t,r,n){let l=0,i=null,u=null,o=!1;for(let a of e){if(n&&!a.rect||!C(a,t,r))continue;if(l+=1,i??=a,!u){u=a;continue}let e=function(e,t){let r=e.depth??0,n=t.depth??0;if(r!==n)return r>n?1:-1;let l=D(e),i=D(t);return l!==i?l<i?1:-1:0}(a,u);e>0?(u=a,o=!1):0===e&&(o=!0)}return{count:l,firstNode:i,disambiguated:o?null:u}}(e,o,r.platform,n);if(i.push({selector:o.raw,matches:a.count}),0!==a.count&&a.firstNode){if(l&&1!==a.count){if(!r.disambiguateAmbiguous||!a.disambiguated)continue;return{node:a.disambiguated,selector:o,selectorIndex:u,matches:a.count,diagnostics:i}}return{node:a.firstNode,selector:o,selectorIndex:u,matches:a.count,diagnostics:i}}}return null}function G(e,t,r){let n=r.requireRect??!1,l=[];for(let i=0;i<t.selectors.length;i+=1){let u=t.selectors[i],o=function(e,t,r,n){let l=0;for(let i of e)(!n||i.rect)&&C(i,t,r)&&(l+=1);return l}(e,u,r.platform,n);if(l.push({selector:u.raw,matches:o}),o>0)return{selectorIndex:i,selector:u,matches:o,diagnostics:l}}return null}function T(e,t,r){if(0===t.length)return`Selector did not match: ${e.raw}`;let n=t.map(e=>`${e.selector} -> ${e.matches}`).join(", ");return r.unique??!0?`Selector did not resolve uniquely (${n})`:`Selector did not match (${n})`}function D(e){return e.rect?e.rect.width*e.rect.height:1/0}function k(e,t,r={}){let n=[],l=u(e.type??""),i=M(e.identifier),o=M(e.label),a=M(e.value),c=M(y(e)),s="fill"===r.action;i&&n.push(`id=${q(i)}`),l&&o&&n.push(s?`role=${q(l)} label=${q(o)} editable=true`:`role=${q(l)} label=${q(o)}`),o&&n.push(s?`label=${q(o)} editable=true`:`label=${q(o)}`),a&&n.push(s?`value=${q(a)} editable=true`:`value=${q(a)}`),c&&c!==o&&c!==a&&n.push(s?`text=${q(c)} editable=true`:`text=${q(c)}`),l&&s&&!n.some(e=>e.includes("editable=true"))&&n.push(`role=${q(l)} editable=true`);let f=Array.from(new Set(n));return 0===f.length&&l&&f.push(s?`role=${q(l)} editable=true`:`role=${q(l)}`),0===f.length&&L(e)&&f.push("visible=true"),f}function q(e){return JSON.stringify(e)}function M(e){if(!e)return null;let t=e.trim();return t||null}export{k as buildSelectorChainForNode,n as buildTextPreview,l as describeTextSurface,N as extractNodeReadText,y as extractNodeText,r as extractReadableText,A as findNearestHittableAncestor,v as findNodeByLabel,G as findSelectorChainMatch,T as formatSelectorFailure,$ as isFillableType,_ as isNodeEditable,L as isNodeVisible,d as isSelectorToken,u as normalizeType,s as parseSelectorChain,I as pruneGroupNodes,x as resolveRefLabel,V as resolveSelectorChain,p as splitIsSelectorArgs,h as splitSelectorFromArgs,i as trimText,f as tryParseSelectorChain};

package/dist/src/9076.js

@@ -1 +1 @@
-import{promises as e}from"node:fs";import t from"node:path";import{PNG as n}from"pngjs";import{asAppError as a,AppError as r,normalizeAgentDeviceError as i}from"./9152.js";import{whichCmd as s,runCmd as o}from"./9818.js";import{trimText as l,extractNodeText as c,parseSelectorChain as d,isNodeVisible as u,isNodeEditable as p,buildTextPreview as m,findNearestHittableAncestor as h,buildSelectorChainForNode as f,findSelectorChainMatch as w,resolveSelectorChain as b,findNodeByLabel as g,resolveRefLabel as y,describeTextSurface as x,extractReadableText as k,formatSelectorFailure as v,normalizeType as A,isFillableType as I}from"./7847.js";import{centerOfRect as N,findNodeByRef as R,normalizeRef as M}from"./4057.js";import{findBestMatchesByLocator as S}from"./7556.js";function P(e){return e?{message:e}:{}}function O(e,t){return t?{...e,message:t}:e}function D(e){return"string"==typeof e?.message&&e.message.length>0?e.message:null}async function _(e,t,n){if("path"===t.kind&&!e.policy.allowLocalInputPaths)throw new r("INVALID_ARGS",`Local ${n.field??"input"} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(t,n)}catch(e){throw a(e)}}async function T(e,t,n){if(t?.kind==="path"&&!e.policy.allowLocalOutputPaths)throw new r("INVALID_ARGS","Local output paths are not allowed by command policy");try{return await e.artifacts.reserveOutput(t,{...n,visibility:n.visibility??"client-visible",requestedClientPath:t?.kind==="downloadableArtifact"?t.clientPath??n.requestedClientPath:n.requestedClientPath})}catch(e){throw a(e)}}async function E(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw a(e)}}let $=async(e,t)=>{let n;if(!e.backend.captureScreenshot)throw new r("UNSUPPORTED_OPERATION","screenshot is not supported by this backend");let a=await T(e,t.out,{field:"path",ext:".png"});try{await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,appId:t.appId,appBundleId:t.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},a.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,surface:t.surface}),n=await a.publish()}catch(e){throw await a.cleanup?.(),e}return{path:a.path,...n?{artifacts:[n]}:{},...P(`Saved screenshot: ${a.path}`)}};function L(e,t){try{return n.sync.read(e)}catch(e){throw new r("COMMAND_FAILED",`Failed to decode ${t} as PNG`,{label:t,reason:e instanceof Error?e.message:String(e)})}}let C=[0,187,255,255];function U(e,t,n,a){if(t<0||t>=e.width||n<0||n>=e.height)return;let r=(n*e.width+t)*4;e.data[r]=a[0],e.data[r+1]=a[1],e.data[r+2]=a[2],e.data[r+3]=a[3]}function F(e,t,n){return Math.min(Math.max(e,t),n)}let q={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},G={leading:20,trailing:20,separator:10,unknown:0,background:-30};function V(e){return"background"!==e.likelyKind}function X(e,t){return e.width>=.25*t.width||e.height>=.06*t.height}function Y(e,t){let n,a=0;for(let r of t){let t=z(e,r.rect);t<=a||(a=t,n=r)}return n}function B(e){let t=[];for(let n of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>{var t,a;return t=e.rect,z(t,a=n.rect)>0||Math.abs(W(t).y-W(a).y)<=.5*Math.max(t.height,a.height)});if(!e){t.push({rect:n.rect,blocks:[n]});continue}e.blocks.push(n),e.blocks.sort((e,t)=>e.rect.x-t.rect.x),e.rect=function(e){let t=1/0,n=1/0,a=-1/0,r=-1/0;for(let i of e)t=Math.min(t,i.x),n=Math.min(n,i.y),a=Math.max(a,i.x+i.width),r=Math.max(r,i.y+i.height);return{x:t,y:n,width:a-t,height:r-n}}([e.rect,n.rect])}return t}function j(e,t){let n,a=W(e);for(let e of t){var r,i;let t=Math.sqrt((r=a,i=W(e.rect),(r.x-i.x)**2+(r.y-i.y)**2));n&&t>=n.distance||(n={block:e,distance:t})}return n}function H(e){let t=K(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function K(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function z(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}function W(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function J(e,t,n){return Math.min(Math.max(e,t),n)}async function Z(e){if(await s("tesseract"))try{let[t,n]=await Promise.all([ee(e.baselinePath),ee(e.currentPath)]);if(0!==t.exitCode||0!==n.exitCode)return;let a=Q(t.stdout,e.width,e.height),r=Q(n.stdout,e.width,e.height),i=function(e,t){let n=new Set,a=[];for(let i of e){var r;let e=eo(i.text),s=function(e,t,n,a){let r=null,i=1/0;for(let l=0;l<n.length;l+=1){var s,o;if(a.has(l))continue;let c=n[l];if(eo(c.text)!==t)continue;let d=(s=er(e.normalizedRect),o=er(c.normalizedRect),(s.x-o.x)**2+(s.y-o.y)**2);d>=i||(r=l,i=d)}return r}(i,e,t,n);if(null===s)continue;n.add(s);let o=function(e,t){let n={x:t.rect.x-e.rect.x,y:t.rect.y-e.rect.y,width:t.rect.width-e.rect.width,height:t.rect.height-e.rect.height},a=ed(t.rect.width/e.rect.width),r=ed(t.rect.height/e.rect.height),i=Math.abs(a-1)>=.08||Math.abs(r-1)>=.12;return{text:e.text,baselineRect:e.rect,currentRect:t.rect,delta:n,confidence:Math.round(100*Math.min(e.confidence,t.confidence))/100,possibleTextMetricMismatch:i}}(i,t[s]);r=o,(Math.abs(r.delta.x)>=2||Math.abs(r.delta.y)>=2||Math.abs(r.delta.width)>=2||Math.abs(r.delta.height)>=2||r.possibleTextMetricMismatch)&&a.push(o)}return a.sort((e,t)=>et(t)-et(e)).slice(0,12)}(a,r),s=function(e){let t=[];for(let n of[...e].sort((e,t)=>e.currentRect.y-t.currentRect.y)){let e=t.find(e=>32>=Math.abs(n.delta.x-el(e.map(e=>e.delta.x))));e?e.push(n):t.push([n])}return t.filter(e=>e.length>=2).map(en).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>ea(t)-ea(e)).slice(0,4)}(i);if(0===a.length&&0===r.length)return;return{provider:"tesseract",baselineBlocks:a.length,currentBlocks:r.length,baselineBlocksRaw:a,currentBlocksRaw:r,matches:i,...s.length>0?{movementClusters:s}:{}}}catch{return}}function Q(e,t,n){let[a,...r]=e.split(/\r?\n/);if(!a)return[];let i=new Map(a.split("	").map((e,t)=>[e,t])),s=[];for(let e of r){var o;if(!e.trim())continue;let t=e.split("	"),n=es(t,i,"level"),a=ei(t,i,"text").trim(),r=es(t,i,"conf");if(5!==n||(o=a,!/[\p{L}\p{N}]/u.test(o))||r<0)continue;let l=es(t,i,"left"),c=es(t,i,"top"),d=es(t,i,"width"),u=es(t,i,"height");d<=0||u<=0||s.push({key:[ei(t,i,"page_num"),ei(t,i,"block_num"),ei(t,i,"par_num"),ei(t,i,"line_num")].join(":"),text:a,confidence:r,rect:{x:l,y:c,width:d,height:u}})}let l=new Map;for(let e of s){let t=l.get(e.key);t?t.push(e):l.set(e.key,[e])}return Array.from(l.values()).flatMap(e=>(function(e){let t=[...e].sort((e,t)=>e.rect.x-t.rect.x),n=[],a=[];for(let e of t){let t=a.at(-1);if(!t){a.push(e);continue}if(e.rect.x-(t.rect.x+t.rect.width)>Math.max(48,2.5*Math.max(t.rect.height,e.rect.height))){n.push(a),a=[e];continue}a.push(e)}return a.length>0&&n.push(a),n})(e)).map(e=>(function(e,t,n){if(0===e.length)return null;let a=[...e].sort((e,t)=>e.rect.x-t.rect.x),r=function(e){let t=1/0,n=1/0,a=-1/0,r=-1/0;for(let i of e)t=Math.min(t,i.x),n=Math.min(n,i.y),a=Math.max(a,i.x+i.width),r=Math.max(r,i.y+i.height);return{x:t,y:n,width:a-t,height:r-n}}(a.map(e=>e.rect)),i=Math.round(100*el(a.map(e=>e.confidence)))/100;return{text:a.map(e=>e.text).join(" "),confidence:i,rect:r,normalizedRect:{x:ec(r.x/t),y:ec(r.y/n),width:ec(r.width/t),height:ec(r.height/n)}}})(e,t,n)).filter(e=>null!==e)}function ee(e){return o("tesseract",[e,"stdout","-l","eng","tsv"],{allowFailure:!0,timeoutMs:1e4})}function et(e){return Math.abs(e.delta.x)+Math.abs(e.delta.y)+Math.abs(e.delta.width)+Math.abs(e.delta.height)+25*!!e.possibleTextMetricMismatch}function en(e){let t=e.map(e=>e.delta.x),n=e.map(e=>e.delta.y);return{texts:e.map(e=>e.text),xRange:{min:Math.min(...t),max:Math.max(...t)},yRange:{min:Math.min(...n),max:Math.max(...n)}}}function ea(e){return 2*Math.abs((e.xRange.min+e.xRange.max)/2)+Math.abs((e.yRange.min+e.yRange.max)/2)}function er(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function ei(e,t,n){let a=t.get(n);return void 0===a?"":e[a]??""}function es(e,t,n){let a=Number(ei(e,t,n));return Number.isFinite(a)?a:0}function eo(e){return e.trim().replace(/\s+/g," ").toLowerCase()}function el(e){return e.reduce((e,t)=>e+t,0)/e.length}function ec(e){return Math.round(100*e*100)/100}function ed(e){return Math.round(1e3*e)/1e3}function eu(e,t,n,a){return{r:Math.round(e/a),g:Math.round(t/a),b:Math.round(n/a)}}function ep(e){return .2126*e.r+.7152*e.g+.0722*e.b}function em(e){return`#${eh(e.r)}${eh(e.g)}${eh(e.b)}`}function eh(e){return e.toString(16).padStart(2,"0")}function ef(e){return Math.round(100*e*100)/100}let ew=255*Math.sqrt(3);async function eb(a,r,i={}){let s,o,l,c;await eg(a,"Baseline image not found"),await eg(r,"Current screenshot not found");let d=i.outputPath,[u,p]=await Promise.all([e.readFile(a),e.readFile(r)]),m=L(u,"baseline screenshot"),h=L(p,"current screenshot");ey(m.width,m.height,"baseline screenshot",i.maxPixels),ey(h.width,h.height,"current screenshot",i.maxPixels);let f=i.threshold??.1;if(m.width!==h.width||m.height!==h.height){let e=m.width*m.height;return await ex(i.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:m.width,height:m.height},actual:{width:h.width,height:h.height}}}}let w=m.width*m.height,b=f*ew,g=new n({width:m.width,height:m.height}),y=new Uint8Array(w),x=0;for(let e=0,t=0;e<m.data.length;e+=4,t+=1){if(Math.sqrt((m.data[e]-h.data[e])**2+(m.data[e+1]-h.data[e+1])**2+(m.data[e+2]-h.data[e+2])**2)>b){x+=1,y[t]=1;let n=ek(h,e);g.data[e]=ev(n,220,.78),g.data[e+1]=ev(n,0,.78),g.data[e+2]=ev(n,0,.78),g.data[e+3]=255;continue}let n=ek(h,e);g.data[e]=n,g.data[e+1]=n,g.data[e+2]=n,g.data[e+3]=255}let k=x>0?(A=(s=function(e){let{diffMask:t,baseline:n,current:a}=e,{width:r,height:i}=n,s=new Uint8Array(t.length),o=new Int32Array(t.length),l=[];for(let e=0;e<t.length;e+=1){if(1!==t[e]||1===s[e])continue;let c=0,d=0;o[0]=e,d+=1,s[e]=1;let u=e%r,p=Math.floor(e/r),m={minX:u,minY:p,maxX:u,maxY:p,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0};for(;c<d;){let e=o[c];c+=1,function(e,t,n,a,r){let i=t%n,s=Math.floor(t/n),o=4*t;e.minX=Math.min(e.minX,i),e.minY=Math.min(e.minY,s),e.maxX=Math.max(e.maxX,i),e.maxY=Math.max(e.maxY,s),e.differentPixels+=1,e.baselineRed+=a.data[o],e.baselineGreen+=a.data[o+1],e.baselineBlue+=a.data[o+2],e.currentRed+=r.data[o],e.currentGreen+=r.data[o+1],e.currentBlue+=r.data[o+2]}(m,e,r,n,a);let l=e%r,u=Math.floor(e/r);for(let e=-1;e<=1;e+=1){let n=u+e;if(!(n<0)&&!(n>=i))for(let a=-1;a<=1;a+=1){if(0===a&&0===e)continue;let i=l+a;if(i<0||i>=r)continue;let c=n*r+i;1===t[c]&&1!==s[c]&&(s[c]=1,o[d]=c,d+=1)}}}l.push(m)}return l}(v={diffMask:y,baseline:m,current:h,totalPixels:w,differentPixels:x,maxRegions:i.maxRegions})).length<=2e3?function(e){let t=[];for(let r of e.sort((e,t)=>{let n=e.minY-t.minY;return 0!==n?n:e.minX-t.minX})){var n,a;let e=t.find(e=>{var t,n,a;return t=e,n=r,a=12,t.minX-a<=n.maxX&&n.minX-a<=t.maxX&&t.minY-a<=n.maxY&&n.minY-a<=t.maxY});if(!e){t.push({...r});continue}n=e,a=r,n.minX=Math.min(n.minX,a.minX),n.minY=Math.min(n.minY,a.minY),n.maxX=Math.max(n.maxX,a.maxX),n.maxY=Math.max(n.maxY,a.maxY),n.differentPixels+=a.differentPixels,n.baselineRed+=a.baselineRed,n.baselineGreen+=a.baselineGreen,n.baselineBlue+=a.baselineBlue,n.currentRed+=a.currentRed,n.currentGreen+=a.currentGreen,n.currentBlue+=a.currentBlue}return t}(s):s,A.flatMap(e=>{var t,n,a;let r;return(t=e,n=v.baseline.width,a=v.baseline.height,r=t.maxX-t.minX+1,t.maxY-t.minY+1>=Math.max(48,Math.round(.07*a))&&r>=.35*n)?function(e,t,n){var a;let r=function(e,t){let n=[],a=null;for(let r=0;r<e.length;r+=1){if(e[r]<=t){a??=r;continue}null!==a&&(r-a>=6&&n.push([a,r-1]),a=null)}return null!==a&&e.length-a>=6&&n.push([a,e.length-1]),n}((a=function(e,t,n){let a=[];for(let r=e.minY;r<=e.maxY;r+=1){let i=0;for(let a=e.minX;a<=e.maxX;a+=1)1===t[r*n+a]&&(i+=1);a.push(i)}return a}(e,t.diffMask,t.baseline.width)).map((e,t)=>{let n=0,r=0,i=Math.max(0,t-3),s=Math.min(a.length-1,t+3);for(let e=i;e<=s;e+=1)n+=a[e],r+=1;return Math.round(n/r)}),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),i=function(e,t,n){let a=[],r=e.minY;for(let[i,s]of t){let t=e.minY+Math.round((i+s)/2);t-r+1<n||e.maxY-t<n||(a.push([r,t]),r=t+1)}return a.push([r,e.maxY]),a}(e,r,n);if(i.length<=1)return[e];let s=i.map(([n,a])=>(function(e,t,n,a){let r=null;for(let o=t;o<=n;o+=1)for(let t=e.minX;t<=e.maxX;t+=1){var i,s;let e=o*a.baseline.width+t;1===a.diffMask[e]&&function(e,t,n,a,r,i){let s=4*t;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,a),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,a),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]}(r??={minX:i=t,minY:s=o,maxX:i,maxY:s,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0},e,t,o,a.baseline,a.current)}return r})(e,n,a,t)).filter(e=>null!==e);return s.length>1?s:[e]}(e,v,Math.max(24,Math.round(.03*v.baseline.height))):[e]})).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(0!==n)return n;let a=e.minY-t.minY;return 0!==a?a:e.minX-t.minX}).slice(0,Math.max(0,v.maxRegions??8)).map((e,t)=>{var n,a,r,i,s,o,l,c,d,u,p;let m,h,f,w,b,g,y,x,k,A,I,N,R,M,S,P,O;return n=e,a=t+1,r={width:v.baseline.width,height:v.baseline.height,totalPixels:v.totalPixels,differentPixels:v.differentPixels},g={x:n.minX,y:n.minY,width:n.maxX-n.minX+1,height:n.maxY-n.minY+1},y={x:Math.round(n.minX+g.width/2),y:Math.round(n.minY+g.height/2)},x=eu(n.baselineRed,n.baselineGreen,n.baselineBlue,n.differentPixels),k=eu(n.currentRed,n.currentGreen,n.currentBlue,n.differentPixels),A=g.width*g.height,I=ef(n.differentPixels/A),N=Math.round(ep(x)),R=Math.round(ep(k)),M=(i=g,s=r.width,o=r.height,i.width>=.55*s&&i.height>=.12*o?"large-area":i.width>=2.5*i.height?"horizontal-band":i.height>=2.5*i.width?"vertical-band":"compact"),S=(m=A/r.totalPixels)>=.04?"large":m>=.01?"medium":"small",P=(l=x,c=k,h=ep(l),Math.abs(f=ep(c)-h)>=12?f>0?"brighter":"darker":Math.max(Math.abs(c.r-l.r),Math.abs(c.g-l.g),Math.abs(c.b-l.b))>=12?"color-shift":"mixed"),O=(d=y,u=r.width,p=r.height,w=d.x<u/3?"left":d.x>2*u/3?"right":"center",b=d.y<p/3?"top":d.y>2*p/3?"bottom":"middle","center"===w&&"middle"===b?"center":`${b}-${w}`),{index:a,rect:g,normalizedRect:{x:ef(g.x/r.width),y:ef(g.y/r.height),width:ef(g.width/r.width),height:ef(g.height/r.height)},differentPixels:n.differentPixels,shareOfDiffPercentage:ef(n.differentPixels/r.differentPixels),densityPercentage:I,shape:M,size:S,location:O,averageBaselineColorHex:em(x),averageCurrentColorHex:em(k),baselineLuminance:N,currentLuminance:R,dominantChange:P}}):[];if(x>0&&d){var v,A,I;for(let e of k)e.rect.width<4||e.rect.height<4||function(e,t){let n=F(t.x,0,e.width-1),a=F(t.y,0,e.height-1),r=F(t.x+t.width-1,0,e.width-1),i=F(t.y+t.height-1,0,e.height-1);for(let t=0;t<2;t+=1){for(let s=n;s<=r;s+=1)U(e,s,a+t,C),U(e,s,i-t,C);for(let s=a;s<=i;s+=1)U(e,n+t,s,C),U(e,r-t,s,C)}}(g,e.rect);await e.mkdir(t.dirname(d),{recursive:!0}),await e.writeFile(d,n.sync.write(g))}else await ex(i.outputPath);let N=x>0?await Z({baselinePath:a,currentPath:r,width:m.width,height:m.height}):void 0,R=N&&(N.matches.length>0||(N.movementClusters?.length??0)>0)?{provider:N.provider,baselineBlocks:N.baselineBlocks,currentBlocks:N.currentBlocks,matches:N.matches,...N.movementClusters?{movementClusters:N.movementClusters}:{}}:void 0,M=x>0&&N?(o=function(e){let t=[];for(let n of e.sort((e,t)=>e.minY-t.minY||e.minX-t.minX)){let e=t.find(e=>{var t,a,r;return t=e,a=n,r=10,t.minX-r<=a.maxX&&a.minX-r<=t.maxX&&t.minY-r<=a.maxY&&a.minY-r<=t.maxY});if(!e){t.push({...n});continue}e.minX=Math.min(e.minX,n.minX),e.minY=Math.min(e.minY,n.minY),e.maxX=Math.max(e.maxX,n.maxX),e.maxY=Math.max(e.maxY,n.maxY),e.differentPixels+=n.differentPixels}return t}(function(e,t,n){let a=new Uint8Array(e.length),r=new Int32Array(e.length),i=[];for(let s=0;s<e.length;s+=1){if(1!==e[s]||1===a[s])continue;let o=0,l=0;r[0]=s,l+=1,a[s]=1;let c=s%t,d=Math.floor(s/t),u={minX:c,minY:d,maxX:c,maxY:d,differentPixels:0};for(;o<l;){let i=r[o];o+=1;let s=i%t,c=Math.floor(i/t);u.minX=Math.min(u.minX,s),u.minY=Math.min(u.minY,c),u.maxX=Math.max(u.maxX,s),u.maxY=Math.max(u.maxY,c),u.differentPixels+=1;for(let i=-1;i<=1;i+=1){let o=c+i;if(!(o<0)&&!(o>=n))for(let n=-1;n<=1;n+=1){if(0===n&&0===i)continue;let c=s+n;if(c<0||c>=t)continue;let d=o*t+c;1===e[d]&&1!==a[d]&&(a[d]=1,r[l]=d,l+=1)}}}i.push(u)}return i}(function(e,t,n,a){let r=new Uint8Array(e);if(!a)return r;for(let e of[...a.baselineBlocksRaw,...a.currentBlocksRaw]){var i;!function(e,t,n,a){let r=J(Math.floor(a.x),0,t-1),i=J(Math.floor(a.y),0,n-1),s=J(Math.ceil(a.x+a.width),0,t),o=J(Math.ceil(a.y+a.height),0,n);for(let n=i;n<o;n+=1)for(let a=r;a<s;a+=1)e[n*t+a]=0}(r,t,n,{x:(i=e.rect).x-8,y:i.y-8,width:i.width+16,height:i.height+16})}return r}((I={diffMask:y,width:m.width,height:m.height,regions:k,ocr:N}).diffMask,I.width,I.height,I.ocr),I.width,I.height)),l=B(I.ocr?.currentBlocksRaw??[]),c=B(I.ocr?.baselineBlocksRaw??[]),o.filter(H).map(e=>{var t,n,a,r,i,s,o,d,u,p,m;let h,f,w,b,g,y,x,k,v,A;return t=e,n=I,a=l,r=c,b=function(e,t){let n,a=0;for(let r of t){let t=function(e,t){let n=Math.max(e.x,t.x),a=Math.max(e.y,t.y),r=Math.min(e.x+e.width,t.x+t.width),i=Math.min(e.y+e.height,t.y+t.height);return r<=n||i<=a?0:(r-n)*(i-a)}(e,r.rect);t<=a||(a=t,n=r)}return n?.index}(w=K(t),n.regions),g=function(e,t,n){let a=Y(e,t);if(a)return j(e,a.blocks);let r=Y(e,n);return r?j(e,r.blocks):void 0}(w,a,r),y=function(e,t,n){if(e.height<=3&&e.width>=.12*n)return"separator";if(!t)return e.width>=.4*n?"background":"unknown";if(e.width>=.4*n)return"background";let a=e.x+e.width/2,r=t.x+t.width/2;return a<r-t.width/2?"leading":a>r+t.width/2?"trailing":e.width>=.35*n?"background":"unknown"}(w,g?.block.rect,n.width),x=(i=w,s=y,o=t.differentPixels,d=n,h=i.width/i.height,f=o/(i.width*i.height),"separator"===s?"separator":"background"===s?"background":"trailing"===s&&h>=1.5&&h<=3.8&&f>=.35?"toggle":"trailing"===s&&i.width<=.06*d.width&&i.height<=.04*d.height?"chevron":"leading"===s&&h>=.55&&h<=1.8?"icon":X(i,d)?"background":"visual"),k={...b?{regionIndex:b}:{},slot:y,likelyKind:x,rect:w},{...b?{regionIndex:b}:{},slot:y,likelyKind:x,rect:w,...g?{nearestText:g.block.text.trim().replace(/^[^\p{L}\p{N}]+/u,"").replace(/^\p{L}\s+/u,"")}:{},score:(u=k,p=t.differentPixels,m=n,v=X(u.rect,m)?-35:0,A=20*!!u.regionIndex,q[u.likelyKind]+G[u.slot]+A+v+Math.min(20,p/200))}}).filter(e=>e.rect.y>=.08*I.height).filter(V).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,I.maxDeltas??12)).map((e,t)=>{var n;return n=e,{index:t+1,...n.regionIndex?{regionIndex:n.regionIndex}:{},slot:n.slot,likelyKind:n.likelyKind,rect:n.rect,...n.nearestText?{nearestText:n.nearestText}:{}}})):[],S=w>0?Math.round(x/w*1e4)/100:0;return{...x>0&&d?{diffPath:d}:{},...k.length>0?{regions:k}:{},...R?{ocr:R}:{},...M.length>0?{nonTextDeltas:M}:{},totalPixels:w,differentPixels:x,mismatchPercentage:S,match:0===x}}async function eg(t,n){try{await e.access(t)}catch{throw new r("INVALID_ARGS",`${n}: ${t}`)}}function ey(e,t,n,a){if(null==a||a<=0)return;let i=e*t;if(!(i<=a))throw new r("INVALID_ARGS",`${n} is ${i} pixels, which exceeds the configured maxImagePixels limit of ${a}`)}async function ex(t){if(t)try{await e.unlink(t)}catch(e){var n;if(!("object"==typeof(n=e)&&null!==n&&"code"in n&&"ENOENT"===n.code))throw e}}function ek(e,t){return ev(Math.round(.299*e.data[t]+.587*e.data[t+1]+.114*e.data[t+2]),255,.72)}function ev(e,t,n){return Math.round(e*(1-n)+t*n)}function eA(e){return e.width*e.height}function eI(e){return Math.round(100*e*100)/100}let eN=async(e,t)=>{let n,a,i;if(!t.baseline)throw new r("INVALID_ARGS","diff screenshot requires a baseline image");let s=function(e){if(null==e||""===e)return .1;let t=Number(e);if(Number.isNaN(t)||t<0||t>1)throw new r("INVALID_ARGS","--threshold must be a number between 0 and 1");return t}(t.threshold),o=t.current??{kind:"live"};if(t.overlayRefs&&!e_(o))throw new r("INVALID_ARGS","diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs");let l=await _(e,t.baseline,{usage:"diff screenshot baseline",field:"baseline"}),c=[];try{let r;r=e_(o)?(a=await eR(e,t)).path:(n=await _(e,o,{usage:"diff screenshot current",field:"current"})).path,i=t.out?await T(e,t.out,{field:"diffPath",ext:".png"}):void 0;let d=await eb(l.path,r,{threshold:s,outputPath:i?.path,maxPixels:e.policy.maxImagePixels});e_(o)&&(d=await eM(e,t,i?.path,d,c));let u=d.diffPath?await i?.publish():void 0;return u&&c.push(u),d.diffPath||await i?.cleanup?.(),{...d,...c.length>0?{artifacts:c}:{}}}catch(e){throw await i?.cleanup?.(),e}finally{await l.cleanup?.(),await n?.cleanup?.(),await a?.cleanup?.()}};async function eR(e,t){let n=await E(e,{prefix:"agent-device-diff-current",ext:".png"});try{await eS(e,t,n.path,eP(t))}catch(e){throw await n.cleanup(),e}return n}async function eM(e,t,n,a,r){var i,s,o,l;if(!t.overlayRefs)return a;if(a.match||a.dimensionMismatch)return n&&await eD(n),a;let c=(i=t,s=n,i.currentOverlayOut?i.currentOverlayOut:i.out?.kind==="path"?{kind:"path",path:eO(s??i.out.path)}:i.out?.kind==="downloadableArtifact"?{kind:"downloadableArtifact",...i.out.clientPath?{clientPath:eO(i.out.clientPath)}:{},...i.out.fileName?{fileName:eO(i.out.fileName)}:{}}:void 0),d=await T(e,c,{field:"currentOverlayPath",ext:".png"});try{let n=await eS(e,t,d.path,{overlayRefs:!0,...eP(t)}),i=await d.publish();return i&&r.push(i),{...a,currentOverlayPath:n.path??d.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...a.regions&&n.overlayRefs?{regions:(o=a.regions,l=n.overlayRefs,o.map(e=>{var t,n;let a,r=(t=e,n=l,a=eA(t.rect),n.map(e=>{var n,r;let i,s,o,l,c=e.overlayRect,d=(n=t.rect,r=c,i=Math.max(n.x,r.x),s=Math.max(n.y,r.y),o=Math.min(n.x+n.width,r.x+r.width),l=Math.min(n.y+n.height,r.y+r.height),o<=i||l<=s?0:(o-i)*(l-s));return d<=0?null:{ref:e.ref,...e.label?{label:e.label}:{},rect:c,overlayCoveragePercentage:eI(d/eA(c)),regionCoveragePercentage:eI(d/a)}}).filter(e=>null!==e).sort((e,t)=>{let n=t.regionCoveragePercentage-e.regionCoveragePercentage;return 0!==n?n:t.overlayCoveragePercentage-e.overlayCoveragePercentage}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage})));return r.length>0?{...e,currentOverlayMatches:r}:e}))}:{}}}catch(e){throw await d.cleanup?.(),e}}async function eS(e,t,n,a={}){if(!e.backend.captureScreenshot)throw new r("UNSUPPORTED_OPERATION","screenshot is not supported by this backend");return await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata},n,a)??{}}function eP(e){return e.surface?{surface:e.surface}:{}}function eO(e){let n=t.extname(e),a=n?e.slice(0,-n.length):e;return`${a}.current-overlay${n||".png"}`}async function eD(t){try{await e.unlink(eO(t))}catch(e){var n;if(!("object"==typeof(n=e)&&null!==n&&"code"in n&&"ENOENT"===n.code))throw e}}function e_(e){return"live"===e.kind}function eT(e,t={}){let n=[],a=[];for(let r of e){let e=r.depth??0,i=r.label?.trim()||r.value?.trim()||r.identifier?.trim()||"",s=eL(r.type??"Element");if("group"===s&&!i)continue;for(;n.length>0&&e<=n[n.length-1];)n.pop();let o=n.length;n.push(e),a.push({node:r,depth:o,type:s,text:eE(r,o,!1,s,t)})}return a}function eE(e,t,n,a,r={}){var i,s,o,c,d,u,p,h;let f,w=a??eL(e.type??"Element"),b=x(e,w),g=(i=e,s=w,o=r,c=b,o.summarizeTextSurfaces&&c.shouldSummarize&&function(e,t,n){let a=l(e.label);if(a&&a!==n)return a;let r=l(e.identifier);if(r&&!eU(r)&&r!==n)return r;switch(t){case"text":case"text-view":return"Text view";case"text-field":return"Text field";case"search":return"Search field";default:return""}}(i,s,c.text)||e$(i,s)),y="  ".repeat(t),k=e.ref?`@${e.ref}`:"",v=(d=e,u=w,p=r,h=b,f=[],(!1===d.enabled&&f.push("disabled"),p.summarizeTextSurfaces&&(!0===d.selected&&f.push("selected"),eC(u)&&f.push("editable"),function(e,t){if("scroll-area"===t)return!0;let n=(e.type??"").toLowerCase(),a=`${e.role??""} ${e.subrole??""}`.toLowerCase();return n.includes("scroll")||a.includes("scroll")}(d,u)&&f.push("scrollable"),h.shouldSummarize))?(f.push(`preview:"${m(h.text).replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`),f.push("truncated"),[...new Set(f)]):f).map(e=>` [${e}]`).join(""),A=g?` "${g}"`:"";return n?`${y}${k} [${w}]${v}`.trimEnd():`${y}${k} [${w}]${A}${v}`.trimEnd()}function e$(e,t){var n,a;let r,i=e.label?.trim();if(i&&(n=t,a=i,("scroll-area"===n||"list"===n||"collection"===n||"table"===n)&&(r=a.trim().toLowerCase())&&/^(vertical|horizontal)\s+scroll\s+bar(?:,?\s*\d+\s+pages?)?$/.test(r)))return"";let s=e.value?.trim();if(eC(t)){if(s)return s;if(i)return i}else if(i)return i;if(s)return s;let o=e.identifier?.trim();return!o||eU(o)&&("group"===t||"image"===t||"list"===t||"collection"===t)?"":o}function eL(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),n=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,""),n&&t.includes(".")&&(t=t.slice(t.lastIndexOf(".")+1))),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return n?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}function eC(e){return"text-field"===e||"text-view"===e||"search"===e}function eU(e){return/^[\w.]+:id\/[\w.-]+$/i.test(e)}function eF(e,t){let n=eL(e.type??"Element"),a=e$(e,n),r=!1===e.enabled?"disabled":"enabled",i=!0===e.selected?"selected":"unselected",s=!0===e.hittable?"hittable":"not-hittable";return[String(t??e.depth??0),n,a,r,i,s].join("|")}function eq(e,t){return t.flatten?e.map(e=>({text:eE(e,0,!1),comparable:eF(e,0)})):eT(e).map(e=>({text:e.text,comparable:eF(e.node,e.depth)}))}function eG(e,t){return e.get(t)??0}function eV(e,t,n){return t>=e.x&&t<=e.x+e.width&&n>=e.y&&n<=e.y+e.height}function eX(e){let t=null,n=-1;for(let a of e){let e=a.width*a.height;e>n&&(t=a,n=e)}return t}function eY(e,t,n,a){return Math.max(e,n)<=Math.min(t,a)}function eB(e){let t=new Map;for(let[n,a]of e.entries())t.set(a.index,n);let n=[],a=[];for(let[r,i]of e.entries()){let e=Math.max(0,i.depth??0);for(;a.length>0&&e<=a[a.length-1].depth;)a.pop();let s="number"==typeof i.parentIndex?t.get(i.parentIndex):void 0,o="number"==typeof s&&s<r?s:a[a.length-1]?.index;n.push({...i,index:r,depth:e,parentIndex:o}),a.push({depth:e,index:r})}return n}function ej(e){return new Map(e.map(e=>[e.index,e]))}function eH(e){return e.label?.trim()||e.value?.trim()||e.identifier?.trim()||""}function eK(e){let t=`${e??""}`.toLowerCase();return t.includes("scroll")||t.includes("recyclerview")||t.includes("listview")||t.includes("gridview")||t.includes("collectionview")||"table"===t}function ez(e){return!!eK(e.type)||`${e.role??""} ${e.subrole??""}`.toLowerCase().includes("scroll")}function eW(e){if(0===e.length)return{nodes:e,hiddenCount:0,summaryLines:[]};let t=ej(e),n=new Set,a=[];for(let r of e){if(eJ(r,e,t)){!function(e,t,n){let a=e,r=new Set;for(;a&&!r.has(a.index);)r.add(a.index),t.add(a.index),a="number"==typeof a.parentIndex?n.get(a.parentIndex):void 0}(r,n,t);continue}a.push(r)}let r=function(e,t,n,a){let r=new Map,i=new Set;for(let e of t){if(!e.rect)continue;let t=e0(e,n,a);if(!t?.rect)continue;let s=eQ(e.rect,t.rect);if(!s)continue;let o=r.get(t.index)??new Set;o.add(s),r.set(t.index,o),i.add(e.index)}return function(e,t,n,a){for(let r of e){let e=function(e){let t=function(e,t){if(!(e?.trim().toLowerCase()??"").includes("vertical scroll bar"))return null;let n=function(e){if(!e)return null;let t=/^(\d{1,3})%$/.exec(e.trim());if(!t)return null;let n=Number(t[1]);return Number.isFinite(n)?Math.max(0,Math.min(100,n)):null}(t);return null===n?null:n<=1?{above:!1,below:!0}:n>=99?{above:!0,below:!1}:{above:!0,below:!0}}(e.label,e.value);if(!t)return null;let n=new Set;return t.above&&n.add("above"),t.below&&n.add("below"),n.size>0?n:null}(r);if(!e||0===e.size)continue;let i=e0(r,t,n);if(!i)continue;let s=a.get(i.index)??new Set;for(let t of e)s.add(t);a.set(i.index,s)}}(e,n,a,r),{directionsByContainer:r,coveredNodeIndexes:i}}(e,a,n,t),i=0===n.size?e:e.filter(e=>n.has(e.index));return{nodes:i.map(e=>(function(e,t){let n=t.get(e.index);if(!n||0===n.size)return e;let a=!!(!0===e.hiddenContentAbove||n.has("above"))||void 0,r=!!(!0===e.hiddenContentBelow||n.has("below"))||void 0;return{...e,hiddenContentAbove:a,hiddenContentBelow:r}})(e,r.directionsByContainer)),hiddenCount:0===n.size?0:e.length-i.length,summaryLines:function(e,t,n){let a=new Map;for(let r of e){let e=function(e,t,n){if(!e.rect)return null;let a=eZ(e,t,n);return a?eQ(e.rect,a):null}(r,t,n);if(!e)continue;let i=a.get(e)??[];i.push(r),a.set(e,i)}return["above","below"].flatMap(e=>{let t=a.get(e);if(!t||0===t.length)return[];let n=(function(e){let t=new Set,n=[];for(let a of e){let e=eH(a);!e||t.has(e)||(t.add(e),n.push(e))}return n})(t).slice(0,3).map(e=>`"${e}"`),r=1===t.length?"interactive item":"interactive items",i=n.length>0?`: ${n.join(", ")}`:"";return[`[off-screen ${e}] ${t.length} ${r}${i}`]})}(a.filter(e=>!r.coveredNodeIndexes.has(e.index)&&function(e){if(!0===e.hittable)return!0;let t=(e.type??"").toLowerCase();return t.includes("button")||t.includes("link")||t.includes("textfield")||t.includes("edittext")||t.includes("searchfield")||t.includes("checkbox")||t.includes("radio")||t.includes("switch")||t.includes("menuitem")||!!eH(e)}(e)),e,t)}}function eJ(e,t,n=ej(t)){var a;if(!e.rect)return!0;let r=eZ(e,t,n);return!r||(a=e.rect,eY(a.x,a.x+a.width,r.x,r.x+r.width)&&eY(a.y,a.y+a.height,r.y,r.y+r.height))}function eZ(e,t,n=ej(t)){let a=function(e,t){let n="number"==typeof e.parentIndex?t.get(e.parentIndex):void 0,a=new Set;for(;n&&!a.has(n.index);){if(a.add(n.index),n.rect&&ez(n))return n.rect;n="number"==typeof n.parentIndex?t.get(n.parentIndex):void 0}return null}(e,n);return a||function(e,t){let n=N(t),a=e.filter(e=>{var t;return!!(t=e.rect)&&Number.isFinite(t.x)&&Number.isFinite(t.y)&&Number.isFinite(t.width)&&Number.isFinite(t.height)}),r=a.filter(e=>{let t=(e.type??"").toLowerCase();return t.includes("application")||t.includes("window")}),i=eX(r.map(e=>e.rect).filter(e=>eV(e,n.x,n.y)));if(i)return i;let s=eX(r.map(e=>e.rect));if(s)return s;let o=eX(a.map(e=>e.rect).filter(e=>eV(e,n.x,n.y)));return o||null}(t,e.rect??{x:0,y:0,width:0,height:0})}function eQ(e,t){return e.y+e.height<=t.y?"above":e.y>=t.y+t.height?"below":null}function e0(e,t,n){let a="number"==typeof e.parentIndex?n.get(e.parentIndex):void 0,r=new Set;for(;a&&!r.has(a.index);){if(r.add(a.index),t.has(a.index)&&ez(a))return a;a="number"==typeof a.parentIndex?n.get(a.parentIndex):void 0}return null}function e1(e){return"text"===e||"label"===e||"any"===e}function e2(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function e5(e){return e.clock?.now()??Date.now()}async function e4(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}let e3=async(e,t)=>{var n;let a,r,i=await e6(e,t);return await e.sessions.set(e7(t.session,i)),{nodes:i.snapshot.nodes,truncated:i.snapshot.truncated??!1,visibility:function(e){var t;let{nodes:n,backend:a,snapshotRaw:r}=e;if(r||"macos-helper"===(t=a)||"linux-atspi"===t)return{partial:!1,visibleNodeCount:n.length,totalNodeCount:n.length,reasons:[]};let i=eW(n),s=new Set;return i.hiddenCount>0&&s.add("offscreen-nodes"),i.nodes.some(e=>e.hiddenContentAbove)&&s.add("scroll-hidden-above"),i.nodes.some(e=>e.hiddenContentBelow)&&s.add("scroll-hidden-below"),{partial:s.size>0,visibleNodeCount:i.nodes.length,totalNodeCount:n.length,reasons:[...s]}}({nodes:i.snapshot.nodes,backend:i.snapshot.backend,snapshotRaw:t.raw}),...i.warnings.length>0?{warnings:i.warnings}:{},...(a=(n=i).result.appName??n.session?.appName,r=n.result.appBundleId??n.session?.appBundleId,{...a||r?{appName:a??r}:{},...r?{appBundleId:r}:{}})}},e8=async(e,t)=>{let n=await e6(e,t),a=!0===t.interactiveOnly,r=n.session?.snapshot,i=e7(t.session,n);if(!r){let t=function(e,t={}){return eq(e,t).length}(n.snapshot.nodes,{flatten:a});return await e.sessions.set(i),{mode:"snapshot",baselineInitialized:!0,summary:{additions:0,removals:0,unchanged:t},lines:[],...n.warnings.length>0?{warnings:n.warnings}:{}}}let s=function(e,t,n={}){let a=function(e,t){let n=e.length,a=t.length,r=n+a,i=new Map,s=[];i.set(1,0);for(let o=0;o<=r;o+=1){s.push(new Map(i));for(let r=-o;r<=o;r+=2){let l=r===-o||r!==o&&eG(i,r-1)<eG(i,r+1)?eG(i,r+1):eG(i,r-1)+1,c=l-r;for(;l<n&&c<a&&e[l].comparable===t[c].comparable;)l+=1,c+=1;if(i.set(r,l),l>=n&&c>=a)return function(e,t,n,a,r){let i=[],s=a,o=r;for(let a=e.length-1;a>=0;a-=1){let r=e[a],l=s-o,c=l===-a||l!==a&&eG(r,l-1)<eG(r,l+1)?l+1:l-1,d=eG(r,c),u=d-c;for(;s>d&&o>u;)i.push({kind:"unchanged",text:n[o-1].text}),s-=1,o-=1;if(0===a)break;s===d?(i.push({kind:"added",text:n[u].text}),o=u):(i.push({kind:"removed",text:t[d].text}),s=d)}return i.reverse(),i}(s,e,t,n,a)}}return[]}(eq(e,n),eq(t,n)),r={additions:0,removals:0,unchanged:0};for(let e of a)"added"===e.kind&&(r.additions+=1),"removed"===e.kind&&(r.removals+=1),"unchanged"===e.kind&&(r.unchanged+=1);return{summary:r,lines:a}}(r.nodes,n.snapshot.nodes,{flatten:a});return await e.sessions.set(i),{mode:"snapshot",baselineInitialized:!1,summary:s.summary,lines:s.lines,...n.warnings.length>0?{warnings:n.warnings}:{}}};async function e6(e,t){var n,a,i,s,o;let l,c,d,u,p,m;if(!e.backend.captureSnapshot)throw new r("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let h=t.session??"default",f=await e.sessions.get(h),w=await e.backend.captureSnapshot({session:h,requestId:t.requestId,appId:f?.appId,appBundleId:f?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,compact:t.compact,depth:t.depth,scope:t.scope,raw:t.raw}),b=(n=w,a=e,n.snapshot?n.snapshot:{nodes:n.nodes??[],truncated:n.truncated,backend:n.backend,createdAt:e5(a)}),g=e5(e);return{snapshot:b,result:w,session:f,warnings:(l=[...(i={result:w,snapshot:b,options:t,session:f,capturedAt:b.createdAt??g,runtimeNow:g}).result.warnings??[]],c=!0===i.options.interactiveOnly,d=i.result.analysis,"android"===i.snapshot.backend&&c&&0===i.snapshot.nodes.length&&d&&(d.rawNodeCount??0)>=12&&(l.push(`Interactive snapshot is empty after filtering ${d.rawNodeCount} raw Android nodes. Likely causes: depth too low, transient route change, or collector filtering.`),"number"==typeof i.options.depth&&"number"==typeof d.maxDepth&&d.maxDepth>=i.options.depth+2&&l.push(`Interactive output is empty at depth ${i.options.depth}; retry without -d.`)),p=!!(u=i.session?.snapshot)&&[i.capturedAt,i.runtimeNow].some(e=>{let t=e-u.createdAt;return t>=0&&t<=2e3}),!i.result.freshness&&u&&p&&(s=u.nodes.length,o=i.snapshot.nodes.length,!(s<12)&&o<=Math.floor(.2*s))&&l.push("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."),m=i.result.freshness,m?.staleAfterRetries&&"android"===i.snapshot.backend&&("stuck-route"===m.reason?l.push(`Recent ${m.action} was followed by a nearly identical snapshot after ${m.retryCount} automatic retr${1===m.retryCount?"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.`):"sharp-drop"===m.reason&&l.push("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.")),Array.from(new Set(l)))}}function e7(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 e9(e){return["visible","hidden","exists","editable","selected","text"].includes(e)}function te(e){return!!(e&&Number.isFinite(e.x)&&Number.isFinite(e.y)&&Number.isFinite(e.width)&&Number.isFinite(e.height)&&e.width>0&&e.height>0)}async function tt(e,t){let n=t??"default",a=await e.sessions.get(n);if(!a)throw new r("SESSION_NOT_FOUND","No active session. Run open first.");if(!a.snapshot)throw new r("INVALID_ARGS","No snapshot in session. Run snapshot first.");return{sessionName:n,session:a,snapshot:a.snapshot}}async function tn(e,t,n={updateSession:!0}){if(!e.backend.captureSnapshot)throw new r("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let a=t.session??"default",i=await e.sessions.get(a),s=await e.backend.captureSnapshot(e2(e,t),{interactiveOnly:!1,compact:!1,depth:t.depth,scope:n.scope??t.scope,raw:t.raw}),o=s.snapshot??{nodes:s.nodes??[],truncated:s.truncated,backend:s.backend,createdAt:e5(e)};return n.updateSession&&i&&await e.sessions.set({...i,snapshot:o}),{sessionName:a,session:i,snapshot:o}}async function ta(e,t,n){if(e.backend.readText){let a=await e.backend.readText(e2(e,{session:t.sessionName}),n);if(a.text.trim())return a.text}return k(n)}function tr(e){return{kind:"selector",selector:e}}function ti(e,t={}){return{kind:"ref",ref:e,...t.fallbackLabel?{fallbackLabel:t.fallbackLabel}:{}}}let ts=async(e,t)=>{let n=t.locator??"any";if(!t.query)throw new r("INVALID_ARGS","find requires a value");if("wait"===t.action)return await tf(e,t,n);let a=await tn(e,t,{updateSession:!0,scope:e1(n)?t.query:void 0}),i=S(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0];if(!i)throw new r("COMMAND_FAILED","find did not match any element");if("exists"===t.action)return{kind:"found",found:!0};let s=`@${i.ref}`;return"get_attrs"===t.action?{kind:"attrs",ref:s,node:i}:{kind:"text",ref:s,text:await ta(e,a,i),node:i}},to=async(e,t)=>{if("ref"===t.target.kind){let n=await tt(e,t.session),a=function(e,t,n){let a=M(t);if(!a)throw new r("INVALID_ARGS",n.invalidRefMessage);let i=R(e,a)??(n.fallbackLabel.length>0?g(e,n.fallbackLabel):null);if(!i)throw new r("COMMAND_FAILED",n.notFoundMessage);return{ref:a,node:i}}(n.snapshot.nodes,t.target.ref,{fallbackLabel:t.target.fallbackLabel??"",invalidRefMessage:"get text requires a ref like @e2",notFoundMessage:`Ref ${t.target.ref} not found`}),i=f(a.node,e.backend.platform,{action:"get"}),s={kind:"ref",ref:`@${a.ref}`};return"attrs"===t.property?{kind:"attrs",target:s,node:a.node,selectorChain:i}:{kind:"text",target:s,text:await ta(e,n,a.node),node:a.node,selectorChain:i}}let n=await ty(e,t,t.session??"default",{selector:t.target.selector,disambiguateAmbiguous:"text"===t.property}),a=f(n.node,e.backend.platform,{action:"get"});if("attrs"===t.property)return{kind:"attrs",target:{kind:"selector",selector:n.selector},node:n.node,selectorChain:a};let i=await ta(e,n.capture,n.node);return{kind:"text",target:{kind:"selector",selector:n.selector},text:i,node:n.node,selectorChain:a}},tl=async(e,t)=>{let n=await to(e,{...t,property:"text",target:t.target});if("text"!==n.kind)throw new r("COMMAND_FAILED","getText returned non-text result");return n},tc=async(e,t)=>{let n=await to(e,{...t,property:"attrs",target:t.target});if("attrs"!==n.kind)throw new r("COMMAND_FAILED","getAttrs returned non-attrs result");return n},td=async(e,t)=>{if(!e9(t.predicate))throw new r("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text");if("text"===t.predicate&&!t.expectedText)throw new r("INVALID_ARGS","is text requires expected text value");let n=await tn(e,t,{updateSession:!0}),a=d(t.selector);if("exists"===t.predicate){let i=w(n.snapshot.nodes,a,{platform:e.backend.platform});if(!i)throw new r("COMMAND_FAILED",v(a,[],{unique:!1}));return{predicate:t.predicate,pass:!0,selector:i.selector.raw,matches:i.matches,selectorChain:a.selectors.map(e=>e.raw)}}let i=b(n.snapshot.nodes,a,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:!1});if(!i)throw new r("COMMAND_FAILED",v(a,[],{unique:!0}));let s=function(e){let{predicate:t,node:n,nodes:a,expectedText:r,platform:i}=e,s=c(n),o=p(n,i),l=!0===n.selected,d="text"===t?u(n):function(e,t){if(!0===e.hittable)return!0;if(te(e.rect))return eJ(e,t);if(e.rect)return!1;let n=function(e,t){let n=new Map(t.map(e=>[e.index,e])),a=e,r=new Set;for(;"number"==typeof a.parentIndex&&!r.has(a.index);){r.add(a.index);let e=n.get(a.parentIndex);if(!e)break;if(function(e){let t=A(e.type??"");return!(t.includes("application")||t.includes("window")||t.includes("scrollview")||t.includes("tableview")||t.includes("collectionview"))&&"table"!==t&&"list"!==t&&"listview"!==t&&(!0===e.hittable||te(e.rect))}(e))return e;a=e}return null}(e,t);return!!n&&(!0===n.hittable||!!te(n.rect)&&eJ(n,t))}(n,a),m=!1;switch(t){case"visible":m=d;break;case"hidden":m=!d;break;case"editable":m=o;break;case"selected":m=l;break;case"text":m=s===(r??"")}let h="text"===t?`expected="${r??""}" actual="${s}"`:`actual=${JSON.stringify({visible:d,editable:o,selected:l})}`;return{pass:m,actualText:s,details:h}}({predicate:t.predicate,node:i.node,nodes:n.snapshot.nodes,expectedText:t.expectedText,platform:e.backend.platform});if(!s.pass)throw new r("COMMAND_FAILED",`is ${t.predicate} failed for selector ${i.selector.raw}: ${s.details}`);return{predicate:t.predicate,pass:!0,selector:i.selector.raw,..."text"===t.predicate?{text:s.actualText}:{},selectorChain:a.selectors.map(e=>e.raw)}},tu=async(e,t)=>await td(e,{...t,predicate:"visible",selector:t.target.selector}),tp=async(e,t)=>await td(e,{...t,predicate:"hidden",selector:t.target.selector}),tm=async(e,t)=>{if("sleep"===t.target.kind)return await e4(e,t.target.durationMs),{kind:"sleep",waitedMs:t.target.durationMs};if("ref"===t.target.kind){let n=await tt(e,t.session),a=M(t.target.ref);if(!a)throw new r("INVALID_ARGS",`Invalid ref: ${t.target.ref}`);let i=R(n.snapshot.nodes,a),s=i?y(i,n.snapshot.nodes):void 0;if(!s)throw new r("COMMAND_FAILED",`Ref ${t.target.ref} not found or has no label`);return await tb(e,t,s,t.target.timeoutMs)}if("selector"===t.target.kind)return await tw(e,t,t.target.selector,t.target.timeoutMs);if(!t.target.text)throw new r("INVALID_ARGS","wait requires text");return await tb(e,t,t.target.text,t.target.timeoutMs)},th=async(e,t)=>{let n=await tm(e,{...t,target:{kind:"text",text:t.text,timeoutMs:t.timeoutMs}});if("text"!==n.kind)throw new r("COMMAND_FAILED","waitForText returned non-text result");return n};async function tf(e,t,n){let a=t.timeoutMs??1e4,i=e5(e);for(;e5(e)-i<a;){if(S((await tn(e,t,{updateSession:!0,scope:e1(n)?t.query:void 0})).snapshot.nodes,n,t.query,{requireRect:!1}).matches[0])return{kind:"found",found:!0,waitedMs:e5(e)-i};await e4(e,300)}throw new r("COMMAND_FAILED","find wait timed out")}async function tw(e,t,n,a){let i=a??1e4,s=e5(e),o=d(n);for(;e5(e)-s<i;){let n=w((await tn(e,t,{updateSession:!0})).snapshot.nodes,o,{platform:e.backend.platform});if(n)return{kind:"selector",selector:n.selector.raw,waitedMs:e5(e)-s};await e4(e,300)}throw new r("COMMAND_FAILED",`wait timed out for selector: ${n}`)}async function tb(e,t,n,a){let i=a??1e4,s=e5(e);for(;e5(e)-s<i;){if(e.backend.findText?(await e.backend.findText(e2(e,t),n)).found:await tg(e,t,n))return{kind:"text",text:n,waitedMs:e5(e)-s};await e4(e,300)}throw new r("COMMAND_FAILED",`wait timed out for text: ${n}`)}async function tg(e,t,n){return!!g((await tn(e,t,{updateSession:!0})).snapshot.nodes,n)}async function ty(e,t,n,a){let i=await tn(e,{...t,session:n},{updateSession:!0}),s=d(a.selector),o=b(i.snapshot.nodes,s,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:a.disambiguateAmbiguous});if(!o)throw new r("COMMAND_FAILED",v(s,[],{unique:!0}));return{capture:i,node:o.node,selector:o.selector.raw,ref:`@${o.node.ref}`}}function tx(e,t,n,a){if(!Number.isFinite(e)||!Number.isInteger(e)||e<n||e>a)throw new r("INVALID_ARGS",`${t} must be an integer between ${n} and ${a}`);return e}function tk(e,t){let n=function(e,t){let n=tA(t.rect);if(!n)return null;let a=t,r=new Set;for(;!r.has(a.ref);){r.add(a.ref);let t=e.filter(e=>{if(e.parentIndex!==a.index||!e.hittable)return!1;let t=tA(e.rect);return!!t&&tI(t,n)});if(1!==t.length)break;a=t[0]}return a===t?null:a}(e,t);if(n?.rect&&tv(n.rect))return n;let a=h(e,t);return a?.rect&&tv(a.rect)?!function(e,t,n){var a,r,i,s;let o,l,c,d=tA(e.rect),u=tA(t.rect);if(!d||!u)return!1;let p=function(e,t){let n=N(t),a=e.filter(e=>{let t=(e.type??"").toLowerCase();return t.includes("application")||t.includes("window")}).map(e=>tA(e.rect)).filter(e=>null!==e);if(0===a.length)return null;let r=a.filter(e=>eV(e,n.x,n.y));return eX(r.length>0?r:a)}(n,d);return!!p&&(a=u,r=p,o=(i=a,s=r,Math.max(0,Math.min(i.x+i.width,s.x+s.width)-Math.max(i.x,s.x))*Math.max(0,Math.min(i.y+i.height,s.y+s.height)-Math.max(i.y,s.y))),l=a.width*a.height,c=r.width*r.height,!(o<=0)&&!(l<=0)&&!(c<=0)&&!!(o/c>=.9)&&!!(o/l>=.8))&&!tI(d,u)}(t,a,e)?a:t:t}function tv(e){let t=tA(e);if(!t)return null;let n=N(t);return Number.isFinite(n.x)&&Number.isFinite(n.y)?n:null}function tA(e){if(!e)return null;let t=Number(e.x),n=Number(e.y),a=Number(e.width),r=Number(e.height);return Number.isFinite(t)&&Number.isFinite(n)&&Number.isFinite(a)&&Number.isFinite(r)&&!(a<0)&&!(r<0)?{x:t,y:n,width:a,height:r}:null}function tI(e,t){return .5>=Math.abs(e.x-t.x)&&.5>=Math.abs(e.y-t.y)&&.5>=Math.abs(e.width-t.width)&&.5>=Math.abs(e.height-t.height)}async function tN(e,t,n){if(await tM(e,t,n.action),"point"===t.target.kind)return{kind:"point",point:{x:t.target.x,y:t.target.y}};if("ref"===t.target.kind){let a=await tP(e,t,t.target),i=a.resolved,s=n.promoteToHittableAncestor?tk(a.snapshot.nodes,i.node):i.node;return function(e,t,n,a){let i=e.rect?eZ(e,t):null;if(!(!e.rect||!i||eJ(e,t)))throw new r("COMMAND_FAILED",`Ref ${n} is off-screen and not safe to ${a}`,{reason:"offscreen_ref",ref:M(n),rect:e.rect,viewport:i,hint:`Use scroll with the direction from the off-screen summary, take a fresh snapshot, then retry ${a} with the new ref or a selector.`})}(s,a.snapshot.nodes,t.target.ref,n.action),{kind:"ref",point:tD(s,`Ref ${t.target.ref} not found or has invalid bounds`),target:{kind:"ref",ref:`@${i.ref}`},node:s,selectorChain:f(s,e.backend.platform,{action:"fill"===n.action?"fill":"click"}),refLabel:y(s,a.snapshot.nodes)}}let a=await tR(e,t,n.requireInteractive),i=d(t.target.selector),s=b(a.snapshot.nodes,i,{platform:e.backend.platform,requireRect:!0,requireUnique:!0,disambiguateAmbiguous:!0});if(!s||!s.node.rect)throw new r("COMMAND_FAILED",v(i,s?.diagnostics??[],{unique:!0}));let o=n.promoteToHittableAncestor?tk(a.snapshot.nodes,s.node):s.node;return{kind:"selector",point:tD(o,`Selector ${s.selector.raw} resolved to invalid bounds`),target:{kind:"selector",selector:s.selector.raw},node:o,selectorChain:f(o,e.backend.platform,{action:"fill"===n.action?"fill":"click"}),refLabel:y(o,a.snapshot.nodes)}}async function tR(e,t,n){if(!e.backend.captureSnapshot)throw new r("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let a=t.session??"default",i=await e.sessions.get(a);if(!i)throw new r("SESSION_NOT_FOUND","No active session. Run open first.");let s=await e.backend.captureSnapshot(e2(e,t),{interactiveOnly:n,compact:n}),o=s.snapshot??{nodes:s.nodes??[],truncated:s.truncated,backend:s.backend,createdAt:e5(e)};return await e.sessions.set({...i,snapshot:o}),{snapshot:o}}async function tM(e,t,n){if("macos"!==e.backend.platform)return;let a=await tS(e,t);if(("desktop"===a||"menubar"===a)&&("menubar"!==a||"click"!==n&&"press"!==n))throw new r("UNSUPPORTED_OPERATION",`${n} is not supported on macOS ${a} sessions yet. Open an app session to act, or use the ${a} surface to inspect.`)}async function tS(e,t){let n=await e.sessions.get(t.session??"default");return n?.metadata?.surface}async function tP(e,t,n){let a=t.session??"default",i=await e.sessions.get(a);if(!i)throw new r("SESSION_NOT_FOUND","No active session. Run open first.");if(!i.snapshot)throw new r("INVALID_ARGS","No snapshot in session. Run snapshot first.");let s=n.fallbackLabel??"",o=tO(i.snapshot.nodes,n.ref,{fallbackLabel:s,requireRect:!0});if(o)return{snapshot:i.snapshot,resolved:o};let l=await tR(e,t,!0),c=tO(l.snapshot.nodes,n.ref,{fallbackLabel:s,requireRect:!0});if(!c)throw new r("COMMAND_FAILED",`Ref ${n.ref} not found or has no bounds`);return{...l,resolved:c}}function tO(e,t,n){let a=M(t);if(!a)throw new r("INVALID_ARGS",`Invalid ref: ${t}`);let i=R(e,a);if(t_(i,n.requireRect))return{ref:a,node:i};let s=n.fallbackLabel.length>0?g(e,n.fallbackLabel):null;return t_(s,n.requireRect)?{ref:a,node:s}:null}function tD(e,t){if(!e.rect)throw new r("COMMAND_FAILED",t);let n=N(e.rect);if(!Number.isFinite(n.x)||!Number.isFinite(n.y))throw new r("COMMAND_FAILED",t);return n}function t_(e,t){if(!e)return!1;if(!t)return!0;if(!e.rect)return!1;let{x:n,y:a,width:r,height:i}=e.rect;if(!Number.isFinite(Number(n))||!Number.isFinite(Number(a))||!Number.isFinite(Number(r))||!Number.isFinite(Number(i))||0>Number(r)||0>Number(i))return!1;let s=N(e.rect);return Number.isFinite(s.x)&&Number.isFinite(s.y)}let tT=async(e,t)=>{let n=await tN(e,t,{action:"focus",requireInteractive:!0,promoteToHittableAncestor:!1});if(!e.backend.focus)throw new r("UNSUPPORTED_OPERATION","focus is not supported by this backend");let a=tY(await e.backend.focus(e2(e,t),n.point));return{...n,...a?{backendResult:a}:{},...P(`Focused (${n.point.x}, ${n.point.y})`)}},tE=async(e,t)=>{let n=await tN(e,t,{action:"longPress",requireInteractive:!0,promoteToHittableAncestor:!0});if(!e.backend.longPress)throw new r("UNSUPPORTED_OPERATION","longPress is not supported by this backend");let a=void 0===t.durationMs?void 0:tx(t.durationMs,"durationMs",0,12e4),i=tY(await e.backend.longPress(e2(e,t),n.point,{durationMs:a}));return{...n,...void 0!==a?{durationMs:a}:{},...i?{backendResult:i}:{},...P(`Long pressed (${n.point.x}, ${n.point.y})`)}},t$=async(e,t)=>{var n,a;if(!e.backend.scroll)throw new r("UNSUPPORTED_OPERATION","scroll is not supported by this backend");let i=tq(t.direction,"scroll direction"),s=(n=t.amount,a="scroll amount",void 0===n?void 0:tV(n,a)),o=function(e,t){if(void 0!==e){if(!Number.isFinite(e)||!Number.isInteger(e)||e<=0)throw new r("INVALID_ARGS",`${t} must be a positive integer`);return e}}(t.pixels,"scroll pixels");if(void 0!==s&&void 0!==o)throw new r("INVALID_ARGS","scroll accepts either amount or pixels, not both");let l=await tU(e,t),c="viewport"===l.kind?{kind:"viewport"}:{kind:"point",point:l.point},d=tY(await e.backend.scroll(e2(e,t),c,{direction:i,...void 0!==s?{amount:s}:{},...void 0!==o?{pixels:o}:{}}));return{...l,direction:i,...void 0!==s?{amount:s}:{},...void 0!==o?{pixels:o}:{},...d?{backendResult:d}:{},...P(void 0!==o?`Scrolled ${i} by ${o}px`:void 0!==s?`Scrolled ${i} by ${s}`:`Scrolled ${i}`)}},tL=async(e,t)=>{if(!e.backend.swipe)throw new r("UNSUPPORTED_OPERATION","swipe is not supported by this backend");let n=await tF(e,t),a=function(e,t){if(t.to)return{point:tG(t.to,"to")};let n=tq(t.direction,"swipe direction"),a=tV(t.distance??200,"swipe distance");switch(n){case"up":return{point:{x:e.x,y:e.y-a},direction:n,distance:a};case"down":return{point:{x:e.x,y:e.y+a},direction:n,distance:a};case"left":return{point:{x:e.x-a,y:e.y},direction:n,distance:a};case"right":return{point:{x:e.x+a,y:e.y},direction:n,distance:a}}}(n.point,t),i=void 0===t.durationMs?void 0:tx(t.durationMs,"durationMs",16,1e4),s=tY(await e.backend.swipe(e2(e,t),n.point,a.point,{durationMs:i}));return{kind:"swipe",from:n.point,to:a.point,...a.direction?{direction:a.direction}:{},...void 0!==a.distance?{distance:a.distance}:{},...void 0!==i?{durationMs:i}:{},...n.target?{fromTarget:n.target}:{},...s?{backendResult:s}:{},...P("Swiped")}},tC=async(e,t)=>{if(!e.backend.pinch)throw new r("UNSUPPORTED_OPERATION","pinch is not supported by this backend");await tM(e,t,"pinch");let n=tV(t.scale,"pinch scale"),a=t.center?await tN(e,{...t,target:t.center},{action:"pinch",requireInteractive:!1,promoteToHittableAncestor:!1}):void 0,i=tY(await e.backend.pinch(e2(e,t),{scale:n,...a?{center:a.point}:{}}));return{kind:"pinch",scale:n,...a?{center:a.point,centerTarget:a}:{},...i?{backendResult:i}:{},...P(`Pinched to scale ${n}`)}};async function tU(e,t){let n=t.target??{kind:"viewport"};return"viewport"===n.kind?(await tM(e,t,"scroll"),{kind:"viewport"}):await tN(e,{...t,target:n},{action:"scroll",requireInteractive:!1,promoteToHittableAncestor:!1})}async function tF(e,t){if(t.from){var n;if("x"in(n=t.from)&&"y"in n)return await tM(e,t,"swipe"),{point:tG(t.from,"from")};let a=await tN(e,{...t,target:t.from},{action:"swipe",requireInteractive:!1,promoteToHittableAncestor:!1});return{point:a.point,target:a}}if(!t.direction)throw new r("INVALID_ARGS","swipe requires from+to or a direction");return await tM(e,t,"swipe"),{point:N(function(e){let t=e.filter(t=>eJ(t,e)).map(e=>e.rect).filter(tX),n=t.length>0?t:e.map(e=>e.rect).filter(tX);if(0===n.length)throw new r("COMMAND_FAILED","Cannot infer viewport for directional swipe");let a=Math.min(...n.map(e=>e.x)),i=Math.min(...n.map(e=>e.y));return{x:a,y:i,width:Math.max(...n.map(e=>e.x+e.width))-a,height:Math.max(...n.map(e=>e.y+e.height))-i}}((await tR(e,t,!1)).snapshot.nodes)),target:{kind:"viewport"}}}function tq(e,t){switch(e){case"up":case"down":case"left":case"right":return e;default:throw new r("INVALID_ARGS",`${t} must be up, down, left, or right`)}}function tG(e,t){let n=Number(e.x),a=Number(e.y);if(!Number.isFinite(n)||!Number.isFinite(a))throw new r("INVALID_ARGS",`${t} point requires finite x and y`);return{x:n,y:a}}function tV(e,t){if(!Number.isFinite(e)||e<=0)throw new r("INVALID_ARGS",`${t} must be a positive number`);return e}function tX(e){return!!(e&&e.width>0&&e.height>0)}function tY(e){return e&&"object"==typeof e?e:void 0}let tB=async(e,t)=>await tz(e,t,"press"),tj=async(e,t)=>await tz(e,t,"click"),tH=async(e,t)=>{var n;if(!t.text)throw new r("INVALID_ARGS","fill requires text");let a=await tN(e,t,{action:"fill",requireInteractive:!0,promoteToHittableAncestor:!1});if(!e.backend.fill)throw new r("UNSUPPORTED_OPERATION","fill is not supported by this backend");let i=tW(await e.backend.fill(e2(e,t),a.point,t.text,{delayMs:t.delayMs})),s="node"in a?a.node.type??"":"",o=s&&!I(s,e.backend.platform)?`fill target ${n=a,n.target?.kind==="ref"?n.target.ref:n.target?.kind==="selector"?n.target.selector:"point"} resolved to "${s}", attempting fill anyway.`:void 0;return{...a,text:t.text,...o?{warning:o}:{},...i?{backendResult:i}:{}}},tK=async(e,t)=>{let n=t.text;if(!n)throw new r("INVALID_ARGS","type requires text");let a=function(e){let t=e.trim().split(/\s+/,1)[0];if(!t||!t.startsWith("@")||t.length<3)return null;let n=t.slice(1);return/^[A-Za-z_-]*\d[\w-]*$/i.test(n)||/^(?:ref|node|element|el)[\w-]*$/i.test(n)?t:null}(n);if(a)throw new r("INVALID_ARGS",`type does not accept a target ref like "${a}"`,{hint:`Use fill ${a} "text" to target that field, or press ${a} then type "text" to append.`});if(!e.backend.typeText)throw new r("UNSUPPORTED_OPERATION","type is not supported by this backend");let i=tx(t.delayMs??0,"delay-ms",0,1e4),s=tW(await e.backend.typeText(e2(e,t),n,{delayMs:i}));return{kind:"text",text:n,delayMs:i,...s?{backendResult:s}:{},...P(`Typed ${Array.from(n).length} chars`)}};async function tz(e,t,n){let a=await tN(e,t,{action:n,requireInteractive:!0,promoteToHittableAncestor:!0});if(!e.backend.tap)throw new r("UNSUPPORTED_OPERATION","tap is not supported by this backend");let i=tW(await e.backend.tap(e2(e,t),a.point,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap}));return{...a,...i?{backendResult:i}:{}}}function tW(e){return e&&"object"==typeof e?e:void 0}let tJ=async(e,t={})=>{if(!e.backend.pressBack)throw new r("UNSUPPORTED_OPERATION","system.back is not supported by this backend");let n=t.mode??"in-app";if("in-app"!==n&&"system"!==n)throw new r("INVALID_ARGS","system.back mode must be in-app or system");let a=t8(await e.backend.pressBack(e2(e,t),{mode:n}));return{kind:"systemBack",mode:n,...a?{backendResult:a}:{},...P("Back")}},tZ=async(e,t={})=>{if(!e.backend.pressHome)throw new r("UNSUPPORTED_OPERATION","system.home is not supported by this backend");let n=t8(await e.backend.pressHome(e2(e,t)));return{kind:"systemHome",...n?{backendResult:n}:{},...P("Home")}},tQ=async(e,t)=>{if(!e.backend.rotate)throw new r("UNSUPPORTED_OPERATION","system.rotate is not supported by this backend");let n=function(e){switch(e){case"portrait":case"portrait-upside-down":case"landscape-left":case"landscape-right":return e;default:throw new r("INVALID_ARGS","system.rotate orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right")}}(t.orientation),a=t8(await e.backend.rotate(e2(e,t),n));return{kind:"systemRotated",orientation:n,...a?{backendResult:a}:{},...P(`Rotated to ${n}`)}},t0=async(e,t={})=>{if(!e.backend.setKeyboard)throw new r("UNSUPPORTED_OPERATION","system.keyboard is not supported by this backend");let n=t.action??"status";if("status"!==n&&"get"!==n&&"dismiss"!==n)throw new r("INVALID_ARGS","system.keyboard action must be status, get, or dismiss");let a=await e.backend.setKeyboard(e2(e,t),{action:n}),i=t8(a);if("dismiss"===n){let e=t3(a)?a.dismissed:void 0;return{kind:"keyboardDismissed",action:n,state:t3(a)?a:{},...i?{backendResult:i}:{},...P(!1===e?"Keyboard already hidden":"Keyboard dismissed")}}return{kind:"keyboardState",action:n,state:t3(a)?a:{},...i?{backendResult:i}:{}}},t1=async(e,t)=>{if("read"===t.action){if(!e.backend.getClipboard)throw new r("UNSUPPORTED_OPERATION","system.clipboard read is not supported by this backend");let n=await e.backend.getClipboard(e2(e,t));return{kind:"clipboardText",action:"read",text:"string"==typeof n?n:n.text}}if("write"!==t.action)throw new r("INVALID_ARGS","system.clipboard action must be read or write");if(!e.backend.setClipboard)throw new r("UNSUPPORTED_OPERATION","system.clipboard write is not supported by this backend");if("string"!=typeof t.text)throw new r("INVALID_ARGS","system.clipboard write requires text");let n=t8(await e.backend.setClipboard(e2(e,t),t.text));return{kind:"clipboardUpdated",action:"write",textLength:Array.from(t.text).length,...n?{backendResult:n}:{},...P("Clipboard updated")}},t2=async(e,t={})=>{if(!e.backend.openSettings)throw new r("UNSUPPORTED_OPERATION","system.settings is not supported by this backend");let n=function(e,t){if(void 0===e)return;let n=e.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}(t.target,"target"),a=t8(await e.backend.openSettings(e2(e,t),n));return{kind:"settingsOpened",...n?{target:n}:{},...a?{backendResult:a}:{},...P(n?`Opened settings: ${n}`:"Opened settings")}},t5=async(e,t={})=>{if(!e.backend.handleAlert)throw new r("UNSUPPORTED_OPERATION","system.alert is not supported by this backend");let n=t.action??"get";if("get"!==n&&"accept"!==n&&"dismiss"!==n&&"wait"!==n)throw new r("INVALID_ARGS","system.alert action must be get, accept, dismiss, or wait");let a=void 0===t.timeoutMs?void 0:tx(t.timeoutMs,"timeoutMs",0,12e4),i=await e.backend.handleAlert(e2(e,t),n,{timeoutMs:a});var s=n,o=i;if("get"===s){if("alertStatus"!==o.kind)throw new r("COMMAND_FAILED","system.alert get returned an invalid backend result");return{kind:"alertStatus",action:s,alert:o.alert}}if("wait"===s){if("alertWait"!==o.kind)throw new r("COMMAND_FAILED","system.alert wait returned an invalid backend result");return{kind:"alertWait",action:s,alert:o.alert,...void 0!==o.waitedMs?{waitedMs:o.waitedMs}:{},...void 0!==o.timedOut?{timedOut:o.timedOut}:{},...P(o.alert?"Alert visible":"Alert wait timed out")}}if("alertHandled"!==o.kind)throw new r("COMMAND_FAILED",`system.alert ${s} returned an invalid backend result`);return{kind:"alertHandled",action:s,handled:o.handled,...o.alert?{alert:o.alert}:{},...o.button?{button:o.button}:{},...P(o.handled?`Alert ${s}ed`:"No alert handled")}},t4=async(e,t={})=>{if(!e.backend.openAppSwitcher)throw new r("UNSUPPORTED_OPERATION","system.appSwitcher is not supported by this backend");let n=t8(await e.backend.openAppSwitcher(e2(e,t)));return{kind:"appSwitcherOpened",...n?{backendResult:n}:{},...P("Opened app switcher")}};function t3(e){return!!(e&&"object"==typeof e)}function t8(e){return e&&"object"==typeof e?e:void 0}let t6=/^[A-Za-z0-9_.:-]{1,64}$/,t7=async(e,t)=>{var n;if(!e.backend.openApp)throw new r("UNSUPPORTED_OPERATION","apps.open is not supported by this backend");let a=function(e){var t;let n=nr(e.app,"app"),a=nr(e.appId,"appId"),i=nr(e.bundleId,"bundleId"),s=nr(e.packageName,"packageName"),o=nr(e.url,"url"),l=nr(e.activity,"activity"),c={...n?{app:n}:{},...a?{appId:a}:{},...i?{bundleId:i}:{},...s?{packageName:s}:{},...o?{url:o}:{},...l?{activity:l}:{}};if(!((t=c).app??t.appId??t.bundleId??t.packageName??t.url??t.activity))throw new r("INVALID_ARGS","apps.open requires app, appId, bundleId, packageName, url, or activity");return c}(t),i=nc(await e.backend.openApp(nl(e,t),a,{relaunch:t.relaunch}));return{kind:"appOpened",target:a,relaunch:!0===t.relaunch,...i?{backendResult:i}:{},...P(`Opened: ${(n=a).app??n.appId??n.bundleId??n.packageName??n.url??n.activity??"app"}`)}},t9=async(e,t={})=>{if(!e.backend.closeApp)throw new r("UNSUPPORTED_OPERATION","apps.close is not supported by this backend");let n=nr(t.app,"app"),a=nc(await e.backend.closeApp(nl(e,t),n));return{kind:"appClosed",...n?{app:n}:{},...a?{backendResult:a}:{},...P(n?`Closed: ${n}`:"Closed app")}},ne=async(e,t={})=>{if(!e.backend.listApps)throw new r("UNSUPPORTED_OPERATION","apps.list is not supported by this backend");return{kind:"appsList",apps:await e.backend.listApps(nl(e,t),t.filter??"all")}},nt=async(e,t)=>{if(!e.backend.getAppState)throw new r("UNSUPPORTED_OPERATION","apps.state is not supported by this backend");let n=ni(t.app,"app"),a=await e.backend.getAppState(nl(e,t),n);return{kind:"appState",app:n,state:a}},nn=async(e,t)=>{if(!e.backend.pushFile)throw new r("UNSUPPORTED_OPERATION","apps.push is not supported by this backend");let n=ni(t.app,"app"),a=await ns(e,t.input);try{let r=await e.backend.pushFile(nl(e,t),a.backendInput,n),i=nc(r);return{kind:"appPushed",app:n,inputKind:a.inputKind,...i?{backendResult:i}:{},...P(`Pushed to ${n}`)}}finally{await a.cleanup?.()}},na=async(e,t)=>{var n,a;if(!e.backend.triggerAppEvent)throw new r("UNSUPPORTED_OPERATION","apps.triggerEvent is not supported by this backend");let i=function(e){let t=ni(e,"name");if(!t6.test(t))throw new r("INVALID_ARGS",`Invalid apps.triggerEvent name: ${t}`,{hint:"Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash."});return t}(t.name);n=t.payload,a=`apps.triggerEvent payload for "${i}"`,void 0!==n&&no(n,a,8192);let s=nc(await e.backend.triggerAppEvent(nl(e,t),{name:i,...t.payload?{payload:t.payload}:{}}));return{kind:"appEventTriggered",name:i,...t.payload?{payload:t.payload}:{},...s?{backendResult:s}:{},...P(`Triggered app event: ${i}`)}};function nr(e,t){if(void 0!==e)return ni(e,t)}function ni(e,t){let n=e?.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}async function ns(e,t){if(!t||"object"!=typeof t)throw new r("INVALID_ARGS","apps.push requires an input");if("json"===t.kind)return no(t.payload,"apps.push JSON payload",8192),{backendInput:{kind:"json",payload:t.payload},inputKind:"json"};let n=await _(e,t,{usage:"apps.push",field:"input"});return{backendInput:{kind:"file",path:n.path},inputKind:"file",...n.cleanup?{cleanup:n.cleanup}:{}}}function no(e,t,n){if(function(e,t){if(!e||"object"!=typeof e||Array.isArray(e))throw new r("INVALID_ARGS",`${t} must be a JSON object`)}(e,t),Buffer.byteLength(function(e,t){try{let n=JSON.stringify(e);if("string"!=typeof n)throw new r("INVALID_ARGS",`${t} must be JSON-serializable`);return n}catch{throw new r("INVALID_ARGS",`${t} must be JSON-serializable`)}}(e,t),"utf8")>n)throw new r("INVALID_ARGS",`${t} exceeds ${n} bytes`)}function nl(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function nc(e){return e&&"object"==typeof e?e:void 0}let nd=async(e,t={})=>{if(!e.backend.listDevices)throw new r("UNSUPPORTED_OPERATION","admin.devices is not supported by this backend");return{kind:"adminDevices",devices:await e.backend.listDevices(e2(e,t),t.filter)}},nu=async(e,t={})=>{if(!e.backend.bootDevice)throw new r("UNSUPPORTED_OPERATION","admin.boot is not supported by this backend");let n=function(e){if(!e)return;let t=nx(e.id,"target.id"),n=nx(e.name,"target.name"),a={...t?{id:t}:{},...n?{name:n}:{},...e.platform?{platform:e.platform}:{},...e.target?{target:e.target}:{},...void 0!==e.headless?{headless:e.headless}:{}};return Object.keys(a).length>0?a:void 0}(t.target),a=nA(await e.backend.bootDevice(e2(e,t),n));return{kind:"deviceBooted",...n?{target:n}:{},...a?{backendResult:a}:{},...P("Booted device")}},np=async(e,t)=>{if(!e.backend.ensureSimulator)throw new r("UNSUPPORTED_OPERATION","admin.ensureSimulator is not supported by this backend");let n=nk(t.device,"device");return{kind:"simulatorEnsured",...await e.backend.ensureSimulator(e2(e,t),{device:n,...t.runtime?{runtime:nk(t.runtime,"runtime")}:{},...void 0!==t.boot?{boot:t.boot}:{},...void 0!==t.reuseExisting?{reuseExisting:t.reuseExisting}:{}})}},nm=async(e,t)=>await nw(e,t,"install"),nh=async(e,t)=>await nw(e,t,"reinstall"),nf=async(e,t)=>await nw(e,t,"installFromSource");async function nw(e,t,n){let a="reinstall"===n?"reinstallApp":"installApp",i=e.backend[a];if(!i)throw new r("UNSUPPORTED_OPERATION",`admin.${n} is not supported by this backend`);let s="app"in t&&void 0!==t.app?nk(t.app,"app"):void 0;if("installFromSource"!==n&&!s)throw new r("INVALID_ARGS",`admin.${n} requires app`);let o=e2(e,t),l=await nb(e,o,t.source);try{var c,d,u,p,m;let t,a,r,h,f,w,b,g,y=await i.call(e.backend,o,{...s?{app:s}:{},source:l.source});return c=n,d=s,u=l.source,p=y,t=nA(p),a=nv(p,"appName"),r=nv(p,"appId"),h=nv(p,"bundleId"),f=nv(p,"packageName"),w=nv(p,"launchTarget"),b=nv(p,"installablePath"),g=nv(p,"archivePath"),{kind:"reinstall"===c?"appReinstalled":"installFromSource"===c?"appInstalledFromSource":"appInstalled",...d?{app:d}:{},source:u,...r?{appId:r}:{},...a?{appName:a}:{},...h?{bundleId:h}:{},...f?{packageName:f}:{},...w?{launchTarget:w}:{},...b?{installablePath:b}:{},...g?{archivePath:g}:{},...t?{backendResult:t}:{},...P(`${"reinstall"===c?"Reinstalled":"Installed"}: ${a??w??d??(m=u,"path"===m.kind?m.path:"uploadedArtifact"===m.kind?m.id:m.url)}`)}}finally{await l.cleanup?.()}}async function nb(e,t,n){let a=ny(n),r=await ng(e,a);try{let n=e.backend.resolveInstallSource?await e.backend.resolveInstallSource(t,r.source):r.source;return{source:ny(n),...r.cleanup?{cleanup:r.cleanup}:{}}}catch(e){if(r.cleanup)try{await r.cleanup()}catch{}throw e}}async function ng(e,t){if("url"===t.kind)return{source:t};let n=await _(e,t,{usage:"admin.install",field:"source"});return{source:{kind:"path",path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function ny(e){if(!e||"object"!=typeof e)throw new r("INVALID_ARGS","install source is required");if("path"===e.kind)return{kind:"path",path:nk(e.path,"source.path")};if("uploadedArtifact"===e.kind)return{kind:"uploadedArtifact",id:nk(e.id,"source.id")};if("url"===e.kind){let t=nk(e.url,"source.url");return function(e){let t;try{t=new URL(e)}catch{throw new r("INVALID_ARGS",`Invalid install source URL: ${e}`)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new r("INVALID_ARGS","Install source URL must use http or https")}(t),{kind:"url",url:t}}throw new r("INVALID_ARGS","install source kind must be path, uploadedArtifact, or url")}function nx(e,t){if(void 0!==e)return nk(e,t)}function nk(e,t){let n=e?.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}function nv(e,t){let n=e[t];return"string"==typeof n&&n.length>0?n:void 0}function nA(e){return e&&"object"==typeof e?e:void 0}let nI=async(e,t)=>{let n=nR(t.action,"record"),a="start"===n?e.backend.startRecording:e.backend.stopRecording;if(!a)throw new r("UNSUPPORTED_OPERATION",`record ${n} is not supported by this backend`);let i=t.out?await T(e,t.out,{field:"path",ext:".mp4"}):void 0;try{var s,o,l,c,d;let r,u,p=(s=t,o=i?.path,r=void 0===s.fps?void 0:tx(s.fps,"fps",1,60),u=void 0===s.quality?void 0:tx(s.quality,"quality",5,10),{...o?{outPath:o}:{},...void 0!==r?{fps:r}:{},...void 0!==u?{quality:u}:{},...void 0!==s.hideTouches?{showTouches:!0!==s.hideTouches}:{}}),m=await a.call(e.backend,e2(e,t),p),h=await i?.publish();return l=n,c=m,d=h,{..."string"==typeof c.path?{path:c.path}:{},..."string"==typeof c.telemetryPath?{telemetryPath:c.telemetryPath}:{},..."string"==typeof c.warning?{warning:c.warning}:{},...nM(l,c,d,{startKind:"recordingStarted",stopKind:"recordingStopped",startMessage:"Recording started",stopMessage:"Recording stopped"})}}catch(e){throw await i?.cleanup?.(),e}},nN=async(e,t)=>{let n=nR(t.action,"trace"),a="start"===n?e.backend.startTrace:e.backend.stopTrace;if(!a)throw new r("UNSUPPORTED_OPERATION",`trace ${n} is not supported by this backend`);let i=t.out?await T(e,t.out,{field:"outPath",ext:".trace"}):void 0;try{var s,o,l;let r={...i?.path?{outPath:i.path}:{}},c=await a.call(e.backend,e2(e,t),r),d=await i?.publish();return s=n,o=c,l=d,{..."string"==typeof o.outPath?{outPath:o.outPath}:{},...nM(s,o,l,{startKind:"traceStarted",stopKind:"traceStopped",startMessage:"Trace started",stopMessage:"Trace stopped"})}}catch(e){throw await i?.cleanup?.(),e}};function nR(e,t){if("start"===e||"stop"===e)return e;throw new r("INVALID_ARGS",`${t} action must be start or stop`)}function nM(e,t,n,a){return{kind:"start"===e?a.startKind:a.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...P("start"===e?a.startMessage:a.stopMessage)}}let nS=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function nP(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[a,r]of Object.entries(e))if(nS.test(a))n[a]="[REDACTED]",t=!0;else{let e=nT(r,2048);n[a]=e.value??"",t||=e.redacted}return{value:n,redacted:t}}function nO(e){return void 0===e?{redacted:!1}:function(e){try{let t=JSON.parse(e),n=n_(t,nE);return n$(JSON.stringify(n.value),2048,n.redacted)}catch{return}}(e)??nT(e,2048)}function nD(e){return n_(e,e=>nT(e,2048))}function n_(e,t){if(void 0===e)return{redacted:!1};if("string"==typeof e)return t(e);if(!e||"object"!=typeof e)return{value:e,redacted:!1};if(Array.isArray(e)){let n=!1;return{value:e.map(e=>{let a=n_(e,t);return n||=a.redacted,a.value}),redacted:n}}let n=!1,a={};for(let[r,i]of Object.entries(e)){if(nS.test(r)){a[r]="[REDACTED]",n=!0;continue}let e=n_(i,t);a[r]=e.value,n||=e.redacted}return{value:a,redacted:n}}function nT(e,t){if(void 0===e)return{redacted:!1};let n=nE(e);return n$(n.value,t,n.redacted)}function nE(e){let t=!1,n=e.replaceAll(/(authorization|token|secret|password|passwd|api[-_]?key)=([^&\s]+)/gi,(e,n)=>(t=!0,`${String(n)}=[REDACTED]`));return{value:n=(n=(n=n.replaceAll(/("(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)"\s*:\s*")([^"]*)(")/gi,(e,n,a,r)=>(t=!0,`${String(n)}[REDACTED]${String(r)}`))).replaceAll(/\b(Bearer\s+)([^\s",;]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`))).replaceAll(/((?:authorization|cookie|token|secret|password|passwd|api[-_]?key)\s*[:=]\s*)([^\s,;]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`)),redacted:t}}function n$(e,t,n){if(void 0===e)return{redacted:n};let a=e;return a.length>t&&(a=`${a.slice(0,t)}...[truncated]`,n=!0),{value:a,redacted:n}}let nL=async(e,t={})=>{var n,a;let i;if(!e.backend.readLogs)throw new r("UNSUPPORTED_OPERATION","diagnostics.logs is not supported by this backend");return i=!0===(n=await e.backend.readLogs(await nF(e,t),{...nq(a=t,100,500,"logs limit"),...void 0!==a.levels?{levels:nV(a.levels,"levels")}:{},...void 0!==a.search?{search:nX(a.search,"search")}:{},...void 0!==a.source?{source:nX(a.source,"source")}:{}})).redacted,{kind:"diagnosticsLogs",entries:n.entries.map(e=>{let t=nT(e.message,4096),n=nD(e.metadata);return i||=t.redacted||n.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.level?{level:e.level}:{},message:t.value??"",...e.source?{source:e.source}:{},...n.value?{metadata:n.value}:{}}}),...n.nextCursor?{nextCursor:n.nextCursor}:{},...n.timeWindow?{timeWindow:n.timeWindow}:{},...n.backend?{backend:n.backend}:{},redacted:i,...n.notes?{notes:n.notes}:{}}},nC=async(e,t={})=>{var n,a,i;let s;if(!e.backend.dumpNetwork)throw new r("UNSUPPORTED_OPERATION","diagnostics.network is not supported by this backend");let o={...nq(i=t,25,200,"network limit"),include:function(e){if(void 0===e)return"summary";if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new r("INVALID_ARGS","network include must be summary, headers, body, or all")}(i.include)};return n=await e.backend.dumpNetwork(await nF(e,t),o),a=o.include??"summary",s=!0===n.redacted,{kind:"diagnosticsNetwork",entries:n.entries.map(e=>{let t=e.url?function(e){try{let t=new URL(e),n=!1;for(let e of Array.from(t.searchParams.keys()))nS.test(e)&&(t.searchParams.set(e,"[REDACTED]"),n=!0);return{value:t.toString(),redacted:n}}catch{return nT(e,2048)}}(e.url):void 0,n="headers"===a||"all"===a?nP(e.requestHeaders):void 0,r="headers"===a||"all"===a?nP(e.responseHeaders):void 0,i="body"===a||"all"===a?nO(e.requestBody):void 0,o="body"===a||"all"===a?nO(e.responseBody):void 0,l=nD(e.metadata);return s||=(t?.redacted??!1)||(n?.redacted??!1)||(r?.redacted??!1)||(i?.redacted??!1)||(o?.redacted??!1)||l.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.method?{method:e.method}:{},...t?{url:t.value}:{},...void 0!==e.status?{status:e.status}:{},...void 0!==e.durationMs?{durationMs:e.durationMs}:{},...n?.value?{requestHeaders:n.value}:{},...r?.value?{responseHeaders:r.value}:{},...i?.value!==void 0?{requestBody:i.value}:{},...o?.value!==void 0?{responseBody:o.value}:{},...l.value?{metadata:l.value}:{}}}),...n.nextCursor?{nextCursor:n.nextCursor}:{},...n.timeWindow?{timeWindow:n.timeWindow}:{},...n.backend?{backend:n.backend}:{},redacted:s,...n.notes?{notes:n.notes}:{}}},nU=async(e,t={})=>{var n,a;let i;if(!e.backend.measurePerf)throw new r("UNSUPPORTED_OPERATION","diagnostics.perf is not supported by this backend");return i=!0===(n=await e.backend.measurePerf(await nF(e,t),{...nG(a=t),...void 0!==a.sampleMs?{sampleMs:tx(a.sampleMs,"sampleMs",100,6e4)}:{},...void 0!==a.metrics?{metrics:nV(a.metrics,"metrics",20)}:{}})).redacted,{kind:"diagnosticsPerf",metrics:n.metrics.map(e=>{let t=nT(e.message,4096),n=nD(e.metadata);return i||=t.redacted||n.redacted,{name:e.name,...void 0!==e.value?{value:e.value}:{},...e.unit?{unit:e.unit}:{},...e.status?{status:e.status}:{},...void 0!==t.value?{message:t.value}:{},...n.value?{metadata:n.value}:{}}}),...n.startedAt?{startedAt:n.startedAt}:{},...n.endedAt?{endedAt:n.endedAt}:{},...n.backend?{backend:n.backend}:{},redacted:i,...n.notes?{notes:n.notes}:{}}};async function nF(e,t){let n=e2(e,t),a=t.session?await e.sessions.get(t.session):void 0;return{...n,...t.appId??a?.appId?{appId:t.appId??a?.appId}:{},...t.appBundleId??a?.appBundleId?{appBundleId:t.appBundleId??a?.appBundleId}:{}}}function nq(e,t,n,a){return{...nG(e),...void 0!==e.cursor?{cursor:nX(e.cursor,"cursor")}:{},limit:void 0===e.limit?t:tx(e.limit,a,1,n)}}function nG(e){return{...void 0!==e.since?{since:nX(e.since,"since")}:{},...void 0!==e.until?{until:nX(e.until,"until")}:{}}}function nV(e,t,n=50){if(!Array.isArray(e))throw new r("INVALID_ARGS",`${t} must be an array of strings`);if(e.length>n)throw new r("INVALID_ARGS",`${t} must contain at most ${n} entries`);return e.map((e,n)=>nX(e,`${t}[${n}]`))}function nX(e,t){let n=e.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}let nY=[{command:"screenshot",category:"portable-runtime",status:"implemented"},{command:"diff screenshot",category:"portable-runtime",status:"implemented"},{command:"snapshot",category:"portable-runtime",status:"implemented"},{command:"diff snapshot",category:"portable-runtime",status:"implemented"},{command:"capture.screenshot",category:"portable-runtime",status:"implemented"},{command:"capture.diffScreenshot",category:"portable-runtime",status:"implemented"},{command:"capture.snapshot",category:"portable-runtime",status:"implemented"},{command:"capture.diffSnapshot",category:"portable-runtime",status:"implemented"},{command:"find read-only",category:"portable-runtime",status:"implemented"},{command:"get",category:"portable-runtime",status:"implemented"},{command:"is",category:"portable-runtime",status:"implemented"},{command:"wait",category:"portable-runtime",status:"implemented"},{command:"selectors.find",category:"portable-runtime",status:"implemented"},{command:"selectors.get",category:"portable-runtime",status:"implemented"},{command:"selectors.is",category:"portable-runtime",status:"implemented"},{command:"selectors.wait",category:"portable-runtime",status:"implemented"},{command:"alert",category:"portable-runtime",status:"planned"},{command:"click",category:"portable-runtime",status:"implemented"},{command:"press",category:"portable-runtime",status:"implemented"},{command:"fill",category:"portable-runtime",status:"implemented"},{command:"interactions.click",category:"portable-runtime",status:"implemented"},{command:"interactions.press",category:"portable-runtime",status:"implemented"},{command:"interactions.fill",category:"portable-runtime",status:"implemented"},{command:"interactions.typeText",category:"portable-runtime",status:"implemented"},{command:"longpress",category:"portable-runtime",status:"planned"},{command:"swipe",category:"portable-runtime",status:"planned"},{command:"focus",category:"portable-runtime",status:"planned"},{command:"type",category:"portable-runtime",status:"implemented"},{command:"scroll",category:"portable-runtime",status:"planned"},{command:"pinch",category:"portable-runtime",status:"planned"},{command:"interactions.focus",category:"portable-runtime",status:"implemented"},{command:"interactions.longPress",category:"portable-runtime",status:"implemented"},{command:"interactions.swipe",category:"portable-runtime",status:"implemented"},{command:"interactions.scroll",category:"portable-runtime",status:"implemented"},{command:"interactions.pinch",category:"portable-runtime",status:"implemented"},{command:"open",category:"portable-runtime",status:"planned"},{command:"close",category:"portable-runtime",status:"planned"},{command:"apps",category:"portable-runtime",status:"planned"},{command:"appstate",category:"portable-runtime",status:"planned"},{command:"apps.open",category:"portable-runtime",status:"implemented"},{command:"apps.close",category:"portable-runtime",status:"implemented"},{command:"apps.list",category:"portable-runtime",status:"implemented"},{command:"apps.state",category:"portable-runtime",status:"implemented"},{command:"apps.push",category:"portable-runtime",status:"implemented"},{command:"apps.triggerEvent",category:"portable-runtime",status:"implemented"},{command:"back",category:"portable-runtime",status:"planned"},{command:"home",category:"portable-runtime",status:"planned"},{command:"rotate",category:"portable-runtime",status:"planned"},{command:"app-switcher",category:"portable-runtime",status:"planned"},{command:"keyboard",category:"portable-runtime",status:"planned"},{command:"clipboard",category:"portable-runtime",status:"planned"},{command:"settings",category:"portable-runtime",status:"planned"},{command:"system.back",category:"portable-runtime",status:"implemented"},{command:"system.home",category:"portable-runtime",status:"implemented"},{command:"system.rotate",category:"portable-runtime",status:"implemented"},{command:"system.appSwitcher",category:"portable-runtime",status:"implemented"},{command:"system.keyboard",category:"portable-runtime",status:"implemented"},{command:"system.clipboard",category:"portable-runtime",status:"implemented"},{command:"system.settings",category:"portable-runtime",status:"implemented"},{command:"system.alert",category:"portable-runtime",status:"implemented"},{command:"push",category:"portable-runtime",status:"planned"},{command:"trigger-app-event",category:"portable-runtime",status:"planned"},{command:"devices",category:"backend-admin",status:"implemented"},{command:"boot",category:"backend-admin",status:"implemented"},{command:"ensure-simulator",category:"backend-admin",status:"implemented"},{command:"install",category:"backend-admin",status:"implemented"},{command:"reinstall",category:"backend-admin",status:"implemented"},{command:"install-from-source",category:"backend-admin",status:"implemented"},{command:"admin.devices",category:"backend-admin",status:"implemented"},{command:"admin.boot",category:"backend-admin",status:"implemented"},{command:"admin.ensureSimulator",category:"backend-admin",status:"implemented"},{command:"admin.install",category:"backend-admin",status:"implemented"},{command:"admin.reinstall",category:"backend-admin",status:"implemented"},{command:"admin.installFromSource",category:"backend-admin",status:"implemented"},{command:"session",category:"transport-session",status:"planned"},{command:"connect",category:"environment",status:"planned"},{command:"disconnect",category:"environment",status:"planned"},{command:"connection",category:"environment",status:"planned"},{command:"metro",category:"environment",status:"planned"},{command:"record",category:"capability-gated",status:"implemented"},{command:"trace",category:"capability-gated",status:"implemented"},{command:"replay",category:"capability-gated",status:"planned"},{command:"test",category:"capability-gated",status:"planned"},{command:"batch",category:"capability-gated",status:"implemented"},{command:"logs",category:"capability-gated",status:"implemented"},{command:"network",category:"capability-gated",status:"implemented"},{command:"perf",category:"capability-gated",status:"implemented"},{command:"diagnostics.logs",category:"capability-gated",status:"implemented"},{command:"diagnostics.network",category:"capability-gated",status:"implemented"},{command:"diagnostics.perf",category:"capability-gated",status:"implemented"}];async function nB(e,t){let n=function(e,t){let n=t??50;if(!Number.isInteger(n)||n<1||n>50)throw new r("INVALID_ARGS","batch maxSteps must be an integer between 1 and 50");if(!Array.isArray(e)||0===e.length)throw new r("INVALID_ARGS","batch requires a non-empty steps array");if(e.length>n)throw new r("INVALID_ARGS",`batch has ${e.length} steps; max allowed is ${n}`);for(let t=0;t<e.length;t+=1){let n=e[t];if(!n||"object"!=typeof n||"string"!=typeof n.command)throw new r("INVALID_ARGS",`Invalid batch step at index ${t}`);if("batch"===n.command)throw new r("INVALID_ARGS",`Batch step ${t+1} cannot run ${n.command}`)}return e}(e.options.steps,e.options.maxSteps),a=Date.now(),i=[];for(let a=0;a<n.length;a+=1){let r=function(e,t,n){var a;return{...e,context:e.context??n,options:{...(a=t).session?{session:a.session}:{},...a.requestId?{requestId:a.requestId}:{},...a.signal?{signal:a.signal}:{},...a.metadata?{metadata:a.metadata}:{},...e.options??{}}}}(n[a],e.options,e.context),s=Date.now(),o=await t(r),l=Date.now()-s;if(o.ok){i.push({step:a+1,command:r.command,ok:!0,data:o.data,durationMs:l});continue}if(i.push({step:a+1,command:r.command,ok:!1,error:o.error,durationMs:l}),!1!==e.options.stopOnError)break}return{kind:"batch",total:n.length,executed:i.length,failed:i.filter(e=>!e.ok).length,totalDurationMs:Date.now()-a,results:i}}function nj(e){let t=async n=>{try{if(function(e){if("batch"===e.command||Object.hasOwn(nK,e.command))return;let t=nY.find(t=>t.command===e.command);if(t?.status==="planned")throw new r("NOT_IMPLEMENTED",`Command ${e.command} is planned but not implemented in the runtime router yet`,{command:e.command});throw new r("UNSUPPORTED_OPERATION",`Unknown runtime command: ${e.command}`,{command:e.command})}(n),await e.beforeDispatch?.(n),"batch"===n.command)return{ok:!0,data:await nB(n,t)};let a=await e.createRuntime(n);return{ok:!0,data:await nz(a,n)}}catch(t){return{ok:!1,error:e.formatError?.(t,n)??i(t)}}};return{dispatch:t}}function nH(e){return async(t,n)=>await e(t,n.options)}let nK={"capture.screenshot":nH($),"capture.diffScreenshot":nH(eN),"capture.snapshot":nH(e3),"capture.diffSnapshot":nH(e8),"selectors.find":nH(ts),"selectors.get":nH(to),"selectors.is":nH(td),"selectors.wait":nH(tm),"interactions.click":nH(tj),"interactions.press":nH(tB),"interactions.fill":nH(tH),"interactions.typeText":nH(tK),"interactions.focus":nH(tT),"interactions.longPress":nH(tE),"interactions.swipe":nH(tL),"interactions.scroll":nH(t$),"interactions.pinch":nH(tC),"system.back":nH(tJ),"system.home":nH(tZ),"system.rotate":nH(tQ),"system.keyboard":nH(t0),"system.clipboard":nH(t1),"system.settings":nH(t2),"system.alert":nH(t5),"system.appSwitcher":nH(t4),"apps.open":nH(t7),"apps.close":nH(t9),"apps.list":nH(ne),"apps.state":nH(nt),"apps.push":nH(nn),"apps.triggerEvent":nH(na),"admin.devices":nH(nd),"admin.boot":nH(nu),"admin.ensureSimulator":nH(np),"admin.install":nH(nm),"admin.reinstall":nH(nh),"admin.installFromSource":nH(nf),record:nH(nI),trace:nH(nN),"diagnostics.logs":nH(nL),"diagnostics.network":nH(nC),"diagnostics.perf":nH(nU)};async function nz(e,t){let n=nK[t.command];if(!n)throw new r("UNSUPPORTED_OPERATION",`Router command ${t.command} is not a runtime command`);return await n(e,t)}let nW={capture:{screenshot:$,diffScreenshot:eN,snapshot:e3,diffSnapshot:e8},selectors:{find:ts,get:to,getText:tl,getAttrs:tc,is:td,isVisible:tu,isHidden:tp,wait:tm,waitForText:th},interactions:{click:tj,press:tB,fill:tH,typeText:tK,focus:tT,longPress:tE,swipe:tL,scroll:t$,pinch:tC},system:{back:tJ,home:tZ,rotate:tQ,keyboard:t0,clipboard:t1,settings:t2,alert:t5,appSwitcher:t4},apps:{open:t7,close:t9,list:ne,state:nt,push:nn,triggerEvent:na},admin:{devices:nd,boot:nu,ensureSimulator:np,install:nm,reinstall:nh,installFromSource:nf},recording:{record:nI,trace:nN},diagnostics:{logs:nL,network:nC,perf:nU}};function nJ(e){return{capture:{screenshot:t=>nW.capture.screenshot(e,t),diffScreenshot:t=>nW.capture.diffScreenshot(e,t),snapshot:t=>nW.capture.snapshot(e,t),diffSnapshot:t=>nW.capture.diffSnapshot(e,t)},selectors:{find:t=>nW.selectors.find(e,t),get:t=>nW.selectors.get(e,t),getText:(t,n={})=>nW.selectors.getText(e,{...n,target:t}),getAttrs:(t,n={})=>nW.selectors.getAttrs(e,{...n,target:t}),is:t=>nW.selectors.is(e,t),isVisible:(t,n={})=>nW.selectors.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>nW.selectors.isHidden(e,{...n,target:t}),wait:t=>nW.selectors.wait(e,t),waitForText:(t,n={})=>nW.selectors.waitForText(e,{...n,text:t})},interactions:{click:(t,n={})=>nW.interactions.click(e,{...n,target:t}),press:(t,n={})=>nW.interactions.press(e,{...n,target:t}),fill:(t,n,a={})=>nW.interactions.fill(e,{...a,target:t,text:n}),typeText:(t,n={})=>nW.interactions.typeText(e,{...n,text:t}),focus:(t,n={})=>nW.interactions.focus(e,{...n,target:t}),longPress:(t,n={})=>nW.interactions.longPress(e,{...n,target:t}),swipe:t=>nW.interactions.swipe(e,t),scroll:t=>nW.interactions.scroll(e,t),pinch:t=>nW.interactions.pinch(e,t)},system:{back:t=>nW.system.back(e,t),home:t=>nW.system.home(e,t),rotate:t=>nW.system.rotate(e,t),keyboard:t=>nW.system.keyboard(e,t),clipboard:t=>nW.system.clipboard(e,t),settings:t=>nW.system.settings(e,t),alert:t=>nW.system.alert(e,t),appSwitcher:t=>nW.system.appSwitcher(e,t)},apps:{open:t=>nW.apps.open(e,t),close:t=>nW.apps.close(e,t),list:t=>nW.apps.list(e,t),state:t=>nW.apps.state(e,t),push:t=>nW.apps.push(e,t),triggerEvent:t=>nW.apps.triggerEvent(e,t)},admin:{devices:t=>nW.admin.devices(e,t),boot:t=>nW.admin.boot(e,t),ensureSimulator:t=>nW.admin.ensureSimulator(e,t),install:t=>nW.admin.install(e,t),reinstall:t=>nW.admin.reinstall(e,t),installFromSource:t=>nW.admin.installFromSource(e,t)},recording:{record:t=>nW.recording.record(e,t),trace:t=>nW.recording.trace(e,t)},observability:{logs:t=>nW.diagnostics.logs(e,t),network:t=>nW.diagnostics.network(e,t),perf:t=>nW.diagnostics.perf(e,t)}}}export{nJ as bindCommands,eW as buildMobileSnapshotPresentation,eT as buildSnapshotDisplayLines,nY as commandCatalog,nW as commands,nj as createCommandRouter,L as decodePng,eH as displayNodeLabel,eE as formatSnapshotLine,eK as isScrollableType,e9 as isSupportedPredicate,eB as normalizeSnapshotTree,D as readCommandMessage,tx as requireIntInRange,tr as selector,ti as ref,P as successText,O as withSuccessText};
+import{promises as e}from"node:fs";import{PNG as t}from"pngjs";import n from"node:path";import{asAppError as a,AppError as r,normalizeAgentDeviceError as i}from"./9152.js";import{whichCmd as s,runCmd as o}from"./9818.js";import{trimText as l,extractNodeText as c,parseSelectorChain as d,isNodeVisible as u,isNodeEditable as p,buildTextPreview as m,findNearestHittableAncestor as h,buildSelectorChainForNode as f,findSelectorChainMatch as w,resolveSelectorChain as b,findNodeByLabel as g,resolveRefLabel as y,describeTextSurface as x,extractReadableText as k,formatSelectorFailure as v,normalizeType as A,isFillableType as I}from"./7847.js";import{centerOfRect as N,findNodeByRef as M,normalizeRef as R}from"./4057.js";import{findBestMatchesByLocator as S}from"./7556.js";function P(e){return e?{message:e}:{}}function O(e,t){return t?{...e,message:t}:e}function D(e){return"string"==typeof e?.message&&e.message.length>0?e.message:null}function _(e,n){try{return t.sync.read(e)}catch(e){throw new r("COMMAND_FAILED",`Failed to decode ${n} as PNG`,{label:n,reason:e instanceof Error?e.message:String(e)})}}async function T(n,a){if(!Number.isInteger(a)||a<1)throw new r("INVALID_ARGS","Screenshot max size must be a positive integer");let i=_(await e.readFile(n),"screenshot"),s=Math.max(i.width,i.height);if(s<=a)return;let o=a/s,l=Math.max(1,Math.round(i.width*o)),c=Math.max(1,Math.round(i.height*o)),d=function(e,n,a){let r=new t({width:n,height:a});for(let t=0;t<a;t+=1){let i=t*e.height/a,s=(t+1)*e.height/a;for(let a=0;a<n;a+=1){let o=a*e.width/n,l=(a+1)*e.width/n,c=0,d=0,u=0,p=0,m=0;for(let t=Math.floor(i);t<Math.ceil(s);t+=1){let n=Math.min(t+1,s)-Math.max(t,i);for(let a=Math.floor(o);a<Math.ceil(l);a+=1){let r=n*(Math.min(a+1,l)-Math.max(a,o)),i=(t*e.width+a)*4;c+=(e.data[i]??0)*r,d+=(e.data[i+1]??0)*r,u+=(e.data[i+2]??0)*r,p+=(e.data[i+3]??0)*r,m+=r}}let h=(t*r.width+a)*4;r.data[h]=Math.round(c/m),r.data[h+1]=Math.round(d/m),r.data[h+2]=Math.round(u/m),r.data[h+3]=Math.round(p/m)}}return r}(i,l,c);await e.writeFile(n,t.sync.write(d))}async function E(e,t,n){if("path"===t.kind&&!e.policy.allowLocalInputPaths)throw new r("INVALID_ARGS",`Local ${n.field??"input"} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(t,n)}catch(e){throw a(e)}}async function $(e,t,n){if(t?.kind==="path"&&!e.policy.allowLocalOutputPaths)throw new r("INVALID_ARGS","Local output paths are not allowed by command policy");try{return await e.artifacts.reserveOutput(t,{...n,visibility:n.visibility??"client-visible",requestedClientPath:t?.kind==="downloadableArtifact"?t.clientPath??n.requestedClientPath:n.requestedClientPath})}catch(e){throw a(e)}}async function L(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw a(e)}}let C=async(e,t)=>{let n;if(!e.backend.captureScreenshot)throw new r("UNSUPPORTED_OPERATION","screenshot is not supported by this backend");let a=await $(e,t.out,{field:"path",ext:".png"});try{await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,appId:t.appId,appBundleId:t.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},a.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,surface:t.surface}),void 0!==t.maxSize&&await T(a.path,t.maxSize),n=await a.publish()}catch(e){throw await a.cleanup?.(),e}return{path:a.path,...n?{artifacts:[n]}:{},...P(`Saved screenshot: ${a.path}`)}},U=[0,187,255,255];function F(e,t,n,a){if(t<0||t>=e.width||n<0||n>=e.height)return;let r=(n*e.width+t)*4;e.data[r]=a[0],e.data[r+1]=a[1],e.data[r+2]=a[2],e.data[r+3]=a[3]}function q(e,t,n){return Math.min(Math.max(e,t),n)}let G={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},B={leading:20,trailing:20,separator:10,unknown:0,background:-30};function V(e){return"background"!==e.likelyKind}function X(e,t){return e.width>=.25*t.width||e.height>=.06*t.height}function Y(e,t){let n,a=0;for(let r of t){let t=W(e,r.rect);t<=a||(a=t,n=r)}return n}function H(e){let t=[];for(let n of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>{var t,a;return t=e.rect,W(t,a=n.rect)>0||Math.abs(J(t).y-J(a).y)<=.5*Math.max(t.height,a.height)});if(!e){t.push({rect:n.rect,blocks:[n]});continue}e.blocks.push(n),e.blocks.sort((e,t)=>e.rect.x-t.rect.x),e.rect=function(e){let t=1/0,n=1/0,a=-1/0,r=-1/0;for(let i of e)t=Math.min(t,i.x),n=Math.min(n,i.y),a=Math.max(a,i.x+i.width),r=Math.max(r,i.y+i.height);return{x:t,y:n,width:a-t,height:r-n}}([e.rect,n.rect])}return t}function z(e,t){let n,a=J(e);for(let e of t){var r,i;let t=Math.sqrt((r=a,i=J(e.rect),(r.x-i.x)**2+(r.y-i.y)**2));n&&t>=n.distance||(n={block:e,distance:t})}return n}function j(e){let t=K(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function K(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function W(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}function J(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function Z(e,t,n){return Math.min(Math.max(e,t),n)}async function Q(e){if(await s("tesseract"))try{let[t,n]=await Promise.all([et(e.baselinePath),et(e.currentPath)]);if(0!==t.exitCode||0!==n.exitCode)return;let a=ee(t.stdout,e.width,e.height),r=ee(n.stdout,e.width,e.height),i=function(e,t){let n=new Set,a=[];for(let i of e){var r;let e=el(i.text),s=function(e,t,n,a){let r=null,i=1/0;for(let l=0;l<n.length;l+=1){var s,o;if(a.has(l))continue;let c=n[l];if(el(c.text)!==t)continue;let d=(s=ei(e.normalizedRect),o=ei(c.normalizedRect),(s.x-o.x)**2+(s.y-o.y)**2);d>=i||(r=l,i=d)}return r}(i,e,t,n);if(null===s)continue;n.add(s);let o=function(e,t){let n={x:t.rect.x-e.rect.x,y:t.rect.y-e.rect.y,width:t.rect.width-e.rect.width,height:t.rect.height-e.rect.height},a=eu(t.rect.width/e.rect.width),r=eu(t.rect.height/e.rect.height),i=Math.abs(a-1)>=.08||Math.abs(r-1)>=.12;return{text:e.text,baselineRect:e.rect,currentRect:t.rect,delta:n,confidence:Math.round(100*Math.min(e.confidence,t.confidence))/100,possibleTextMetricMismatch:i}}(i,t[s]);r=o,(Math.abs(r.delta.x)>=2||Math.abs(r.delta.y)>=2||Math.abs(r.delta.width)>=2||Math.abs(r.delta.height)>=2||r.possibleTextMetricMismatch)&&a.push(o)}return a.sort((e,t)=>en(t)-en(e)).slice(0,12)}(a,r),s=function(e){let t=[];for(let n of[...e].sort((e,t)=>e.currentRect.y-t.currentRect.y)){let e=t.find(e=>32>=Math.abs(n.delta.x-ec(e.map(e=>e.delta.x))));e?e.push(n):t.push([n])}return t.filter(e=>e.length>=2).map(ea).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>er(t)-er(e)).slice(0,4)}(i);if(0===a.length&&0===r.length)return;return{provider:"tesseract",baselineBlocks:a.length,currentBlocks:r.length,baselineBlocksRaw:a,currentBlocksRaw:r,matches:i,...s.length>0?{movementClusters:s}:{}}}catch{return}}function ee(e,t,n){let[a,...r]=e.split(/\r?\n/);if(!a)return[];let i=new Map(a.split("	").map((e,t)=>[e,t])),s=[];for(let e of r){var o;if(!e.trim())continue;let t=e.split("	"),n=eo(t,i,"level"),a=es(t,i,"text").trim(),r=eo(t,i,"conf");if(5!==n||(o=a,!/[\p{L}\p{N}]/u.test(o))||r<0)continue;let l=eo(t,i,"left"),c=eo(t,i,"top"),d=eo(t,i,"width"),u=eo(t,i,"height");d<=0||u<=0||s.push({key:[es(t,i,"page_num"),es(t,i,"block_num"),es(t,i,"par_num"),es(t,i,"line_num")].join(":"),text:a,confidence:r,rect:{x:l,y:c,width:d,height:u}})}let l=new Map;for(let e of s){let t=l.get(e.key);t?t.push(e):l.set(e.key,[e])}return Array.from(l.values()).flatMap(e=>(function(e){let t=[...e].sort((e,t)=>e.rect.x-t.rect.x),n=[],a=[];for(let e of t){let t=a.at(-1);if(!t){a.push(e);continue}if(e.rect.x-(t.rect.x+t.rect.width)>Math.max(48,2.5*Math.max(t.rect.height,e.rect.height))){n.push(a),a=[e];continue}a.push(e)}return a.length>0&&n.push(a),n})(e)).map(e=>(function(e,t,n){if(0===e.length)return null;let a=[...e].sort((e,t)=>e.rect.x-t.rect.x),r=function(e){let t=1/0,n=1/0,a=-1/0,r=-1/0;for(let i of e)t=Math.min(t,i.x),n=Math.min(n,i.y),a=Math.max(a,i.x+i.width),r=Math.max(r,i.y+i.height);return{x:t,y:n,width:a-t,height:r-n}}(a.map(e=>e.rect)),i=Math.round(100*ec(a.map(e=>e.confidence)))/100;return{text:a.map(e=>e.text).join(" "),confidence:i,rect:r,normalizedRect:{x:ed(r.x/t),y:ed(r.y/n),width:ed(r.width/t),height:ed(r.height/n)}}})(e,t,n)).filter(e=>null!==e)}function et(e){return o("tesseract",[e,"stdout","-l","eng","tsv"],{allowFailure:!0,timeoutMs:1e4})}function en(e){return Math.abs(e.delta.x)+Math.abs(e.delta.y)+Math.abs(e.delta.width)+Math.abs(e.delta.height)+25*!!e.possibleTextMetricMismatch}function ea(e){let t=e.map(e=>e.delta.x),n=e.map(e=>e.delta.y);return{texts:e.map(e=>e.text),xRange:{min:Math.min(...t),max:Math.max(...t)},yRange:{min:Math.min(...n),max:Math.max(...n)}}}function er(e){return 2*Math.abs((e.xRange.min+e.xRange.max)/2)+Math.abs((e.yRange.min+e.yRange.max)/2)}function ei(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function es(e,t,n){let a=t.get(n);return void 0===a?"":e[a]??""}function eo(e,t,n){let a=Number(es(e,t,n));return Number.isFinite(a)?a:0}function el(e){return e.trim().replace(/\s+/g," ").toLowerCase()}function ec(e){return e.reduce((e,t)=>e+t,0)/e.length}function ed(e){return Math.round(100*e*100)/100}function eu(e){return Math.round(1e3*e)/1e3}function ep(e,t,n,a){return{r:Math.round(e/a),g:Math.round(t/a),b:Math.round(n/a)}}function em(e){return .2126*e.r+.7152*e.g+.0722*e.b}function eh(e){return`#${ef(e.r)}${ef(e.g)}${ef(e.b)}`}function ef(e){return e.toString(16).padStart(2,"0")}function ew(e){return Math.round(100*e*100)/100}let eb=255*Math.sqrt(3);async function eg(a,r,i={}){let s,o,l,c;await ey(a,"Baseline image not found"),await ey(r,"Current screenshot not found");let d=i.outputPath,[u,p]=await Promise.all([e.readFile(a),e.readFile(r)]),m=_(u,"baseline screenshot"),h=_(p,"current screenshot");ex(m.width,m.height,"baseline screenshot",i.maxPixels),ex(h.width,h.height,"current screenshot",i.maxPixels);let f=i.threshold??.1;if(m.width!==h.width||m.height!==h.height){let e=m.width*m.height;return await ek(i.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:m.width,height:m.height},actual:{width:h.width,height:h.height}}}}let w=m.width*m.height,b=f*eb,g=new t({width:m.width,height:m.height}),y=new Uint8Array(w),x=0;for(let e=0,t=0;e<m.data.length;e+=4,t+=1){if(Math.sqrt((m.data[e]-h.data[e])**2+(m.data[e+1]-h.data[e+1])**2+(m.data[e+2]-h.data[e+2])**2)>b){x+=1,y[t]=1;let n=ev(h,e);g.data[e]=eA(n,220,.78),g.data[e+1]=eA(n,0,.78),g.data[e+2]=eA(n,0,.78),g.data[e+3]=255;continue}let n=ev(h,e);g.data[e]=n,g.data[e+1]=n,g.data[e+2]=n,g.data[e+3]=255}let k=x>0?(A=(s=function(e){let{diffMask:t,baseline:n,current:a}=e,{width:r,height:i}=n,s=new Uint8Array(t.length),o=new Int32Array(t.length),l=[];for(let e=0;e<t.length;e+=1){if(1!==t[e]||1===s[e])continue;let c=0,d=0;o[0]=e,d+=1,s[e]=1;let u=e%r,p=Math.floor(e/r),m={minX:u,minY:p,maxX:u,maxY:p,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0};for(;c<d;){let e=o[c];c+=1,function(e,t,n,a,r){let i=t%n,s=Math.floor(t/n),o=4*t;e.minX=Math.min(e.minX,i),e.minY=Math.min(e.minY,s),e.maxX=Math.max(e.maxX,i),e.maxY=Math.max(e.maxY,s),e.differentPixels+=1,e.baselineRed+=a.data[o],e.baselineGreen+=a.data[o+1],e.baselineBlue+=a.data[o+2],e.currentRed+=r.data[o],e.currentGreen+=r.data[o+1],e.currentBlue+=r.data[o+2]}(m,e,r,n,a);let l=e%r,u=Math.floor(e/r);for(let e=-1;e<=1;e+=1){let n=u+e;if(!(n<0)&&!(n>=i))for(let a=-1;a<=1;a+=1){if(0===a&&0===e)continue;let i=l+a;if(i<0||i>=r)continue;let c=n*r+i;1===t[c]&&1!==s[c]&&(s[c]=1,o[d]=c,d+=1)}}}l.push(m)}return l}(v={diffMask:y,baseline:m,current:h,totalPixels:w,differentPixels:x,maxRegions:i.maxRegions})).length<=2e3?function(e){let t=[];for(let r of e.sort((e,t)=>{let n=e.minY-t.minY;return 0!==n?n:e.minX-t.minX})){var n,a;let e=t.find(e=>{var t,n,a;return t=e,n=r,a=12,t.minX-a<=n.maxX&&n.minX-a<=t.maxX&&t.minY-a<=n.maxY&&n.minY-a<=t.maxY});if(!e){t.push({...r});continue}n=e,a=r,n.minX=Math.min(n.minX,a.minX),n.minY=Math.min(n.minY,a.minY),n.maxX=Math.max(n.maxX,a.maxX),n.maxY=Math.max(n.maxY,a.maxY),n.differentPixels+=a.differentPixels,n.baselineRed+=a.baselineRed,n.baselineGreen+=a.baselineGreen,n.baselineBlue+=a.baselineBlue,n.currentRed+=a.currentRed,n.currentGreen+=a.currentGreen,n.currentBlue+=a.currentBlue}return t}(s):s,A.flatMap(e=>{var t,n,a;let r;return(t=e,n=v.baseline.width,a=v.baseline.height,r=t.maxX-t.minX+1,t.maxY-t.minY+1>=Math.max(48,Math.round(.07*a))&&r>=.35*n)?function(e,t,n){var a;let r=function(e,t){let n=[],a=null;for(let r=0;r<e.length;r+=1){if(e[r]<=t){a??=r;continue}null!==a&&(r-a>=6&&n.push([a,r-1]),a=null)}return null!==a&&e.length-a>=6&&n.push([a,e.length-1]),n}((a=function(e,t,n){let a=[];for(let r=e.minY;r<=e.maxY;r+=1){let i=0;for(let a=e.minX;a<=e.maxX;a+=1)1===t[r*n+a]&&(i+=1);a.push(i)}return a}(e,t.diffMask,t.baseline.width)).map((e,t)=>{let n=0,r=0,i=Math.max(0,t-3),s=Math.min(a.length-1,t+3);for(let e=i;e<=s;e+=1)n+=a[e],r+=1;return Math.round(n/r)}),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),i=function(e,t,n){let a=[],r=e.minY;for(let[i,s]of t){let t=e.minY+Math.round((i+s)/2);t-r+1<n||e.maxY-t<n||(a.push([r,t]),r=t+1)}return a.push([r,e.maxY]),a}(e,r,n);if(i.length<=1)return[e];let s=i.map(([n,a])=>(function(e,t,n,a){let r=null;for(let o=t;o<=n;o+=1)for(let t=e.minX;t<=e.maxX;t+=1){var i,s;let e=o*a.baseline.width+t;1===a.diffMask[e]&&function(e,t,n,a,r,i){let s=4*t;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,a),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,a),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]}(r??={minX:i=t,minY:s=o,maxX:i,maxY:s,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0},e,t,o,a.baseline,a.current)}return r})(e,n,a,t)).filter(e=>null!==e);return s.length>1?s:[e]}(e,v,Math.max(24,Math.round(.03*v.baseline.height))):[e]})).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(0!==n)return n;let a=e.minY-t.minY;return 0!==a?a:e.minX-t.minX}).slice(0,Math.max(0,v.maxRegions??8)).map((e,t)=>{var n,a,r,i,s,o,l,c,d,u,p;let m,h,f,w,b,g,y,x,k,A,I,N,M,R,S,P,O;return n=e,a=t+1,r={width:v.baseline.width,height:v.baseline.height,totalPixels:v.totalPixels,differentPixels:v.differentPixels},g={x:n.minX,y:n.minY,width:n.maxX-n.minX+1,height:n.maxY-n.minY+1},y={x:Math.round(n.minX+g.width/2),y:Math.round(n.minY+g.height/2)},x=ep(n.baselineRed,n.baselineGreen,n.baselineBlue,n.differentPixels),k=ep(n.currentRed,n.currentGreen,n.currentBlue,n.differentPixels),A=g.width*g.height,I=ew(n.differentPixels/A),N=Math.round(em(x)),M=Math.round(em(k)),R=(i=g,s=r.width,o=r.height,i.width>=.55*s&&i.height>=.12*o?"large-area":i.width>=2.5*i.height?"horizontal-band":i.height>=2.5*i.width?"vertical-band":"compact"),S=(m=A/r.totalPixels)>=.04?"large":m>=.01?"medium":"small",P=(l=x,c=k,h=em(l),Math.abs(f=em(c)-h)>=12?f>0?"brighter":"darker":Math.max(Math.abs(c.r-l.r),Math.abs(c.g-l.g),Math.abs(c.b-l.b))>=12?"color-shift":"mixed"),O=(d=y,u=r.width,p=r.height,w=d.x<u/3?"left":d.x>2*u/3?"right":"center",b=d.y<p/3?"top":d.y>2*p/3?"bottom":"middle","center"===w&&"middle"===b?"center":`${b}-${w}`),{index:a,rect:g,normalizedRect:{x:ew(g.x/r.width),y:ew(g.y/r.height),width:ew(g.width/r.width),height:ew(g.height/r.height)},differentPixels:n.differentPixels,shareOfDiffPercentage:ew(n.differentPixels/r.differentPixels),densityPercentage:I,shape:R,size:S,location:O,averageBaselineColorHex:eh(x),averageCurrentColorHex:eh(k),baselineLuminance:N,currentLuminance:M,dominantChange:P}}):[];if(x>0&&d){var v,A,I;for(let e of k)e.rect.width<4||e.rect.height<4||function(e,t){let n=q(t.x,0,e.width-1),a=q(t.y,0,e.height-1),r=q(t.x+t.width-1,0,e.width-1),i=q(t.y+t.height-1,0,e.height-1);for(let t=0;t<2;t+=1){for(let s=n;s<=r;s+=1)F(e,s,a+t,U),F(e,s,i-t,U);for(let s=a;s<=i;s+=1)F(e,n+t,s,U),F(e,r-t,s,U)}}(g,e.rect);await e.mkdir(n.dirname(d),{recursive:!0}),await e.writeFile(d,t.sync.write(g))}else await ek(i.outputPath);let N=x>0?await Q({baselinePath:a,currentPath:r,width:m.width,height:m.height}):void 0,M=N&&(N.matches.length>0||(N.movementClusters?.length??0)>0)?{provider:N.provider,baselineBlocks:N.baselineBlocks,currentBlocks:N.currentBlocks,matches:N.matches,...N.movementClusters?{movementClusters:N.movementClusters}:{}}:void 0,R=x>0&&N?(o=function(e){let t=[];for(let n of e.sort((e,t)=>e.minY-t.minY||e.minX-t.minX)){let e=t.find(e=>{var t,a,r;return t=e,a=n,r=10,t.minX-r<=a.maxX&&a.minX-r<=t.maxX&&t.minY-r<=a.maxY&&a.minY-r<=t.maxY});if(!e){t.push({...n});continue}e.minX=Math.min(e.minX,n.minX),e.minY=Math.min(e.minY,n.minY),e.maxX=Math.max(e.maxX,n.maxX),e.maxY=Math.max(e.maxY,n.maxY),e.differentPixels+=n.differentPixels}return t}(function(e,t,n){let a=new Uint8Array(e.length),r=new Int32Array(e.length),i=[];for(let s=0;s<e.length;s+=1){if(1!==e[s]||1===a[s])continue;let o=0,l=0;r[0]=s,l+=1,a[s]=1;let c=s%t,d=Math.floor(s/t),u={minX:c,minY:d,maxX:c,maxY:d,differentPixels:0};for(;o<l;){let i=r[o];o+=1;let s=i%t,c=Math.floor(i/t);u.minX=Math.min(u.minX,s),u.minY=Math.min(u.minY,c),u.maxX=Math.max(u.maxX,s),u.maxY=Math.max(u.maxY,c),u.differentPixels+=1;for(let i=-1;i<=1;i+=1){let o=c+i;if(!(o<0)&&!(o>=n))for(let n=-1;n<=1;n+=1){if(0===n&&0===i)continue;let c=s+n;if(c<0||c>=t)continue;let d=o*t+c;1===e[d]&&1!==a[d]&&(a[d]=1,r[l]=d,l+=1)}}}i.push(u)}return i}(function(e,t,n,a){let r=new Uint8Array(e);if(!a)return r;for(let e of[...a.baselineBlocksRaw,...a.currentBlocksRaw]){var i;!function(e,t,n,a){let r=Z(Math.floor(a.x),0,t-1),i=Z(Math.floor(a.y),0,n-1),s=Z(Math.ceil(a.x+a.width),0,t),o=Z(Math.ceil(a.y+a.height),0,n);for(let n=i;n<o;n+=1)for(let a=r;a<s;a+=1)e[n*t+a]=0}(r,t,n,{x:(i=e.rect).x-8,y:i.y-8,width:i.width+16,height:i.height+16})}return r}((I={diffMask:y,width:m.width,height:m.height,regions:k,ocr:N}).diffMask,I.width,I.height,I.ocr),I.width,I.height)),l=H(I.ocr?.currentBlocksRaw??[]),c=H(I.ocr?.baselineBlocksRaw??[]),o.filter(j).map(e=>{var t,n,a,r,i,s,o,d,u,p,m;let h,f,w,b,g,y,x,k,v,A;return t=e,n=I,a=l,r=c,b=function(e,t){let n,a=0;for(let r of t){let t=function(e,t){let n=Math.max(e.x,t.x),a=Math.max(e.y,t.y),r=Math.min(e.x+e.width,t.x+t.width),i=Math.min(e.y+e.height,t.y+t.height);return r<=n||i<=a?0:(r-n)*(i-a)}(e,r.rect);t<=a||(a=t,n=r)}return n?.index}(w=K(t),n.regions),g=function(e,t,n){let a=Y(e,t);if(a)return z(e,a.blocks);let r=Y(e,n);return r?z(e,r.blocks):void 0}(w,a,r),y=function(e,t,n){if(e.height<=3&&e.width>=.12*n)return"separator";if(!t)return e.width>=.4*n?"background":"unknown";if(e.width>=.4*n)return"background";let a=e.x+e.width/2,r=t.x+t.width/2;return a<r-t.width/2?"leading":a>r+t.width/2?"trailing":e.width>=.35*n?"background":"unknown"}(w,g?.block.rect,n.width),x=(i=w,s=y,o=t.differentPixels,d=n,h=i.width/i.height,f=o/(i.width*i.height),"separator"===s?"separator":"background"===s?"background":"trailing"===s&&h>=1.5&&h<=3.8&&f>=.35?"toggle":"trailing"===s&&i.width<=.06*d.width&&i.height<=.04*d.height?"chevron":"leading"===s&&h>=.55&&h<=1.8?"icon":X(i,d)?"background":"visual"),k={...b?{regionIndex:b}:{},slot:y,likelyKind:x,rect:w},{...b?{regionIndex:b}:{},slot:y,likelyKind:x,rect:w,...g?{nearestText:g.block.text.trim().replace(/^[^\p{L}\p{N}]+/u,"").replace(/^\p{L}\s+/u,"")}:{},score:(u=k,p=t.differentPixels,m=n,v=X(u.rect,m)?-35:0,A=20*!!u.regionIndex,G[u.likelyKind]+B[u.slot]+A+v+Math.min(20,p/200))}}).filter(e=>e.rect.y>=.08*I.height).filter(V).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,I.maxDeltas??12)).map((e,t)=>{var n;return n=e,{index:t+1,...n.regionIndex?{regionIndex:n.regionIndex}:{},slot:n.slot,likelyKind:n.likelyKind,rect:n.rect,...n.nearestText?{nearestText:n.nearestText}:{}}})):[],S=w>0?Math.round(x/w*1e4)/100:0;return{...x>0&&d?{diffPath:d}:{},...k.length>0?{regions:k}:{},...M?{ocr:M}:{},...R.length>0?{nonTextDeltas:R}:{},totalPixels:w,differentPixels:x,mismatchPercentage:S,match:0===x}}async function ey(t,n){try{await e.access(t)}catch{throw new r("INVALID_ARGS",`${n}: ${t}`)}}function ex(e,t,n,a){if(null==a||a<=0)return;let i=e*t;if(!(i<=a))throw new r("INVALID_ARGS",`${n} is ${i} pixels, which exceeds the configured maxImagePixels limit of ${a}`)}async function ek(t){if(t)try{await e.unlink(t)}catch(e){var n;if(!("object"==typeof(n=e)&&null!==n&&"code"in n&&"ENOENT"===n.code))throw e}}function ev(e,t){return eA(Math.round(.299*e.data[t]+.587*e.data[t+1]+.114*e.data[t+2]),255,.72)}function eA(e,t,n){return Math.round(e*(1-n)+t*n)}function eI(e){return e.width*e.height}function eN(e){return Math.round(100*e*100)/100}let eM=async(e,t)=>{let n,a,i;if(!t.baseline)throw new r("INVALID_ARGS","diff screenshot requires a baseline image");let s=function(e){if(null==e||""===e)return .1;let t=Number(e);if(Number.isNaN(t)||t<0||t>1)throw new r("INVALID_ARGS","--threshold must be a number between 0 and 1");return t}(t.threshold),o=t.current??{kind:"live"};if(t.overlayRefs&&!eT(o))throw new r("INVALID_ARGS","diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs");let l=await E(e,t.baseline,{usage:"diff screenshot baseline",field:"baseline"}),c=[];try{let r;r=eT(o)?(a=await eR(e,t)).path:(n=await E(e,o,{usage:"diff screenshot current",field:"current"})).path,i=t.out?await $(e,t.out,{field:"diffPath",ext:".png"}):void 0;let d=await eg(l.path,r,{threshold:s,outputPath:i?.path,maxPixels:e.policy.maxImagePixels});eT(o)&&(d=await eS(e,t,i?.path,d,c));let u=d.diffPath?await i?.publish():void 0;return u&&c.push(u),d.diffPath||await i?.cleanup?.(),{...d,...c.length>0?{artifacts:c}:{}}}catch(e){throw await i?.cleanup?.(),e}finally{await l.cleanup?.(),await n?.cleanup?.(),await a?.cleanup?.()}};async function eR(e,t){let n=await L(e,{prefix:"agent-device-diff-current",ext:".png"});try{await eP(e,t,n.path,eO(t))}catch(e){throw await n.cleanup(),e}return n}async function eS(e,t,n,a,r){var i,s,o,l;if(!t.overlayRefs)return a;if(a.match||a.dimensionMismatch)return n&&await e_(n),a;let c=(i=t,s=n,i.currentOverlayOut?i.currentOverlayOut:i.out?.kind==="path"?{kind:"path",path:eD(s??i.out.path)}:i.out?.kind==="downloadableArtifact"?{kind:"downloadableArtifact",...i.out.clientPath?{clientPath:eD(i.out.clientPath)}:{},...i.out.fileName?{fileName:eD(i.out.fileName)}:{}}:void 0),d=await $(e,c,{field:"currentOverlayPath",ext:".png"});try{let n=await eP(e,t,d.path,{overlayRefs:!0,...eO(t)}),i=await d.publish();return i&&r.push(i),{...a,currentOverlayPath:n.path??d.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...a.regions&&n.overlayRefs?{regions:(o=a.regions,l=n.overlayRefs,o.map(e=>{var t,n;let a,r=(t=e,n=l,a=eI(t.rect),n.map(e=>{var n,r;let i,s,o,l,c=e.overlayRect,d=(n=t.rect,r=c,i=Math.max(n.x,r.x),s=Math.max(n.y,r.y),o=Math.min(n.x+n.width,r.x+r.width),l=Math.min(n.y+n.height,r.y+r.height),o<=i||l<=s?0:(o-i)*(l-s));return d<=0?null:{ref:e.ref,...e.label?{label:e.label}:{},rect:c,overlayCoveragePercentage:eN(d/eI(c)),regionCoveragePercentage:eN(d/a)}}).filter(e=>null!==e).sort((e,t)=>{let n=t.regionCoveragePercentage-e.regionCoveragePercentage;return 0!==n?n:t.overlayCoveragePercentage-e.overlayCoveragePercentage}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage})));return r.length>0?{...e,currentOverlayMatches:r}:e}))}:{}}}catch(e){throw await d.cleanup?.(),e}}async function eP(e,t,n,a={}){if(!e.backend.captureScreenshot)throw new r("UNSUPPORTED_OPERATION","screenshot is not supported by this backend");return await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata},n,a)??{}}function eO(e){return e.surface?{surface:e.surface}:{}}function eD(e){let t=n.extname(e),a=t?e.slice(0,-t.length):e;return`${a}.current-overlay${t||".png"}`}async function e_(t){try{await e.unlink(eD(t))}catch(e){var n;if(!("object"==typeof(n=e)&&null!==n&&"code"in n&&"ENOENT"===n.code))throw e}}function eT(e){return"live"===e.kind}function eE(e,t={}){let n=[],a=[];for(let r of e){let e=r.depth??0,i=r.label?.trim()||r.value?.trim()||r.identifier?.trim()||"",s=eC(r.type??"Element");if("group"===s&&!i)continue;for(;n.length>0&&e<=n[n.length-1];)n.pop();let o=n.length;n.push(e),a.push({node:r,depth:o,type:s,text:e$(r,o,!1,s,t)})}return a}function e$(e,t,n,a,r={}){var i,s,o,c,d,u,p,h;let f,w=a??eC(e.type??"Element"),b=x(e,w),g=(i=e,s=w,o=r,c=b,o.summarizeTextSurfaces&&c.shouldSummarize&&function(e,t,n){let a=l(e.label);if(a&&a!==n)return a;let r=l(e.identifier);if(r&&!eF(r)&&r!==n)return r;switch(t){case"text":case"text-view":return"Text view";case"text-field":return"Text field";case"search":return"Search field";default:return""}}(i,s,c.text)||eL(i,s)),y="  ".repeat(t),k=e.ref?`@${e.ref}`:"",v=(d=e,u=w,p=r,h=b,f=[],(!1===d.enabled&&f.push("disabled"),p.summarizeTextSurfaces&&(!0===d.selected&&f.push("selected"),eU(u)&&f.push("editable"),function(e,t){if("scroll-area"===t)return!0;let n=(e.type??"").toLowerCase(),a=`${e.role??""} ${e.subrole??""}`.toLowerCase();return n.includes("scroll")||a.includes("scroll")}(d,u)&&f.push("scrollable"),h.shouldSummarize))?(f.push(`preview:"${m(h.text).replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`),f.push("truncated"),[...new Set(f)]):f).map(e=>` [${e}]`).join(""),A=g?` "${g}"`:"";return n?`${y}${k} [${w}]${v}`.trimEnd():`${y}${k} [${w}]${A}${v}`.trimEnd()}function eL(e,t){var n,a;let r,i=e.label?.trim();if(i&&(n=t,a=i,("scroll-area"===n||"list"===n||"collection"===n||"table"===n)&&(r=a.trim().toLowerCase())&&/^(vertical|horizontal)\s+scroll\s+bar(?:,?\s*\d+\s+pages?)?$/.test(r)))return"";let s=e.value?.trim();if(eU(t)){if(s)return s;if(i)return i}else if(i)return i;if(s)return s;let o=e.identifier?.trim();return!o||eF(o)&&("group"===t||"image"===t||"list"===t||"collection"===t)?"":o}function eC(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),n=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,""),n&&t.includes(".")&&(t=t.slice(t.lastIndexOf(".")+1))),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return n?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}function eU(e){return"text-field"===e||"text-view"===e||"search"===e}function eF(e){return/^[\w.]+:id\/[\w.-]+$/i.test(e)}function eq(e,t){let n=eC(e.type??"Element"),a=eL(e,n),r=!1===e.enabled?"disabled":"enabled",i=!0===e.selected?"selected":"unselected",s=!0===e.hittable?"hittable":"not-hittable";return[String(t??e.depth??0),n,a,r,i,s].join("|")}function eG(e,t){return t.flatten?e.map(e=>({text:e$(e,0,!1),comparable:eq(e,0)})):eE(e).map(e=>({text:e.text,comparable:eq(e.node,e.depth)}))}function eB(e,t){return e.get(t)??0}function eV(e,t,n){return t>=e.x&&t<=e.x+e.width&&n>=e.y&&n<=e.y+e.height}function eX(e){let t=null,n=-1;for(let a of e){let e=a.width*a.height;e>n&&(t=a,n=e)}return t}function eY(e,t,n,a){return Math.max(e,n)<=Math.min(t,a)}function eH(e){let t=new Map;for(let[n,a]of e.entries())t.set(a.index,n);let n=[],a=[];for(let[r,i]of e.entries()){let e=Math.max(0,i.depth??0);for(;a.length>0&&e<=a[a.length-1].depth;)a.pop();let s="number"==typeof i.parentIndex?t.get(i.parentIndex):void 0,o="number"==typeof s&&s<r?s:a[a.length-1]?.index;n.push({...i,index:r,depth:e,parentIndex:o}),a.push({depth:e,index:r})}return n}function ez(e){return new Map(e.map(e=>[e.index,e]))}function ej(e){return e.label?.trim()||e.value?.trim()||e.identifier?.trim()||""}function eK(e){let t=`${e??""}`.toLowerCase();return t.includes("scroll")||t.includes("recyclerview")||t.includes("listview")||t.includes("gridview")||t.includes("collectionview")||"table"===t}function eW(e){return!!eK(e.type)||`${e.role??""} ${e.subrole??""}`.toLowerCase().includes("scroll")}function eJ(e){if(0===e.length)return{nodes:e,hiddenCount:0,summaryLines:[]};let{byIndex:t,visibleNodeIndexes:n,offscreenNodes:a,hintedContainers:r}=eQ(e),i=0===n.size?e:e.filter(e=>n.has(e.index));return{nodes:i.map(e=>(function(e,t){let n=t.get(e.index);if(!n||0===n.size)return e;let a=!!(!0===e.hiddenContentAbove||n.has("above"))||void 0,r=!!(!0===e.hiddenContentBelow||n.has("below"))||void 0;return{...e,hiddenContentAbove:a,hiddenContentBelow:r}})(e,r.directionsByContainer)),hiddenCount:0===n.size?0:e.length-i.length,summaryLines:function(e,t,n){let a=new Map;for(let r of e){let e=function(e,t,n){if(!e.rect)return null;let a=e1(e,t,n);return a?e2(e.rect,a):null}(r,t,n);if(!e)continue;let i=a.get(e)??[];i.push(r),a.set(e,i)}return["above","below"].flatMap(e=>{let t=a.get(e);if(!t||0===t.length)return[];let n=(function(e){let t=new Set,n=[];for(let a of e){let e=ej(a);!e||t.has(e)||(t.add(e),n.push(e))}return n})(t).slice(0,3).map(e=>`"${e}"`),r=1===t.length?"interactive item":"interactive items",i=n.length>0?`: ${n.join(", ")}`:"";return[`[off-screen ${e}] ${t.length} ${r}${i}`]})}(a.filter(e=>!r.coveredNodeIndexes.has(e.index)&&function(e){if(!0===e.hittable)return!0;let t=(e.type??"").toLowerCase();return t.includes("button")||t.includes("link")||t.includes("textfield")||t.includes("edittext")||t.includes("searchfield")||t.includes("checkbox")||t.includes("radio")||t.includes("switch")||t.includes("menuitem")||!!ej(e)}(e)),e,t)}}function eZ(e){if(0===e.length)return new Map;let{hintedContainers:t}=eQ(e);var n=t.directionsByContainer;let a=new Map;for(let[e,t]of n){let n={};t.has("above")&&(n.hiddenContentAbove=!0),t.has("below")&&(n.hiddenContentBelow=!0),(n.hiddenContentAbove||n.hiddenContentBelow)&&a.set(e,n)}return a}function eQ(e){let t=ez(e),n=new Set,a=[];for(let r of e){if(e0(r,e,t)){!function(e,t,n){let a=e,r=new Set;for(;a&&!r.has(a.index);)r.add(a.index),t.add(a.index),a="number"==typeof a.parentIndex?n.get(a.parentIndex):void 0}(r,n,t);continue}a.push(r)}let r=function(e,t,n,a){let r=new Map,i=new Set;for(let e of t){if(!e.rect)continue;let t=e5(e,n,a);if(!t?.rect)continue;let s=e2(e.rect,t.rect);if(!s)continue;let o=r.get(t.index)??new Set;o.add(s),r.set(t.index,o),i.add(e.index)}return function(e,t,n,a){for(let r of e){let e=function(e){let t=function(e,t){if(!(e?.trim().toLowerCase()??"").includes("vertical scroll bar"))return null;let n=function(e){if(!e)return null;let t=/^(\d{1,3})%$/.exec(e.trim());if(!t)return null;let n=Number(t[1]);return Number.isFinite(n)?Math.max(0,Math.min(100,n)):null}(t);return null===n?null:n<=1?{above:!1,below:!0}:n>=99?{above:!0,below:!1}:{above:!0,below:!0}}(e.label,e.value);if(!t)return null;let n=new Set;return t.above&&n.add("above"),t.below&&n.add("below"),n.size>0?n:null}(r);if(!e||0===e.size)continue;let i=e5(r,t,n);if(!i)continue;let s=a.get(i.index)??new Set;for(let t of e)s.add(t);a.set(i.index,s)}}(e,n,a,r),{directionsByContainer:r,coveredNodeIndexes:i}}(e,a,n,t);return{byIndex:t,visibleNodeIndexes:n,offscreenNodes:a,hintedContainers:r}}function e0(e,t,n=ez(t)){var a;if(!e.rect)return!0;let r=e1(e,t,n);return!r||(a=e.rect,eY(a.x,a.x+a.width,r.x,r.x+r.width)&&eY(a.y,a.y+a.height,r.y,r.y+r.height))}function e1(e,t,n=ez(t)){let a=function(e,t){let n="number"==typeof e.parentIndex?t.get(e.parentIndex):void 0,a=new Set;for(;n&&!a.has(n.index);){if(a.add(n.index),n.rect&&eW(n))return n.rect;n="number"==typeof n.parentIndex?t.get(n.parentIndex):void 0}return null}(e,n);return a||function(e,t){let n=N(t),a=e.filter(e=>{var t;return!!(t=e.rect)&&Number.isFinite(t.x)&&Number.isFinite(t.y)&&Number.isFinite(t.width)&&Number.isFinite(t.height)}),r=a.filter(e=>{let t=(e.type??"").toLowerCase();return t.includes("application")||t.includes("window")}),i=eX(r.map(e=>e.rect).filter(e=>eV(e,n.x,n.y)));if(i)return i;let s=eX(r.map(e=>e.rect));if(s)return s;let o=eX(a.map(e=>e.rect).filter(e=>eV(e,n.x,n.y)));return o||null}(t,e.rect??{x:0,y:0,width:0,height:0})}function e2(e,t){return e.y+e.height<=t.y?"above":e.y>=t.y+t.height?"below":null}function e5(e,t,n){let a="number"==typeof e.parentIndex?n.get(e.parentIndex):void 0,r=new Set;for(;a&&!r.has(a.index);){if(r.add(a.index),t.has(a.index)&&eW(a))return a;a="number"==typeof a.parentIndex?n.get(a.parentIndex):void 0}return null}function e4(e){return"text"===e||"label"===e||"any"===e}function e3(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function e8(e){return e.clock?.now()??Date.now()}async function e6(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}let e7=async(e,t)=>{var n;let a,r,i=await te(e,t);return await e.sessions.set(tt(t.session,i)),{nodes:i.snapshot.nodes,truncated:i.snapshot.truncated??!1,visibility:function(e){var t;let{nodes:n,backend:a,snapshotRaw:r}=e;if(r||"macos-helper"===(t=a)||"linux-atspi"===t)return{partial:!1,visibleNodeCount:n.length,totalNodeCount:n.length,reasons:[]};let i=eJ(n),s=new Set;return i.hiddenCount>0&&s.add("offscreen-nodes"),i.nodes.some(e=>e.hiddenContentAbove)&&s.add("scroll-hidden-above"),i.nodes.some(e=>e.hiddenContentBelow)&&s.add("scroll-hidden-below"),{partial:s.size>0,visibleNodeCount:i.nodes.length,totalNodeCount:n.length,reasons:[...s]}}({nodes:i.snapshot.nodes,backend:i.snapshot.backend,snapshotRaw:t.raw}),...i.warnings.length>0?{warnings:i.warnings}:{},...(a=(n=i).result.appName??n.session?.appName,r=n.result.appBundleId??n.session?.appBundleId,{...a||r?{appName:a??r}:{},...r?{appBundleId:r}:{}})}},e9=async(e,t)=>{let n=await te(e,t),a=!0===t.interactiveOnly,r=n.session?.snapshot,i=tt(t.session,n);if(!r){let t=function(e,t={}){return eG(e,t).length}(n.snapshot.nodes,{flatten:a});return await e.sessions.set(i),{mode:"snapshot",baselineInitialized:!0,summary:{additions:0,removals:0,unchanged:t},lines:[],...n.warnings.length>0?{warnings:n.warnings}:{}}}let s=function(e,t,n={}){let a=function(e,t){let n=e.length,a=t.length,r=n+a,i=new Map,s=[];i.set(1,0);for(let o=0;o<=r;o+=1){s.push(new Map(i));for(let r=-o;r<=o;r+=2){let l=r===-o||r!==o&&eB(i,r-1)<eB(i,r+1)?eB(i,r+1):eB(i,r-1)+1,c=l-r;for(;l<n&&c<a&&e[l].comparable===t[c].comparable;)l+=1,c+=1;if(i.set(r,l),l>=n&&c>=a)return function(e,t,n,a,r){let i=[],s=a,o=r;for(let a=e.length-1;a>=0;a-=1){let r=e[a],l=s-o,c=l===-a||l!==a&&eB(r,l-1)<eB(r,l+1)?l+1:l-1,d=eB(r,c),u=d-c;for(;s>d&&o>u;)i.push({kind:"unchanged",text:n[o-1].text}),s-=1,o-=1;if(0===a)break;s===d?(i.push({kind:"added",text:n[u].text}),o=u):(i.push({kind:"removed",text:t[d].text}),s=d)}return i.reverse(),i}(s,e,t,n,a)}}return[]}(eG(e,n),eG(t,n)),r={additions:0,removals:0,unchanged:0};for(let e of a)"added"===e.kind&&(r.additions+=1),"removed"===e.kind&&(r.removals+=1),"unchanged"===e.kind&&(r.unchanged+=1);return{summary:r,lines:a}}(r.nodes,n.snapshot.nodes,{flatten:a});return await e.sessions.set(i),{mode:"snapshot",baselineInitialized:!1,summary:s.summary,lines:s.lines,...n.warnings.length>0?{warnings:n.warnings}:{}}};async function te(e,t){var n,a,i,s,o;let l,c,d,u,p,m;if(!e.backend.captureSnapshot)throw new r("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let h=t.session??"default",f=await e.sessions.get(h),w=await e.backend.captureSnapshot({session:h,requestId:t.requestId,appId:f?.appId,appBundleId:f?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,compact:t.compact,depth:t.depth,scope:t.scope,raw:t.raw}),b=(n=w,a=e,n.snapshot?n.snapshot:{nodes:n.nodes??[],truncated:n.truncated,backend:n.backend,createdAt:e8(a)}),g=e8(e);return{snapshot:b,result:w,session:f,warnings:(l=[...(i={result:w,snapshot:b,options:t,session:f,capturedAt:b.createdAt??g,runtimeNow:g}).result.warnings??[]],c=!0===i.options.interactiveOnly,d=i.result.analysis,"android"===i.snapshot.backend&&c&&0===i.snapshot.nodes.length&&d&&(d.rawNodeCount??0)>=12&&(l.push(`Interactive snapshot is empty after filtering ${d.rawNodeCount} raw Android nodes. Likely causes: depth too low, transient route change, or collector filtering.`),"number"==typeof i.options.depth&&"number"==typeof d.maxDepth&&d.maxDepth>=i.options.depth+2&&l.push(`Interactive output is empty at depth ${i.options.depth}; retry without -d.`)),p=!!(u=i.session?.snapshot)&&[i.capturedAt,i.runtimeNow].some(e=>{let t=e-u.createdAt;return t>=0&&t<=2e3}),!i.result.freshness&&u&&p&&(s=u.nodes.length,o=i.snapshot.nodes.length,!(s<12)&&o<=Math.floor(.2*s))&&l.push("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."),m=i.result.freshness,m?.staleAfterRetries&&"android"===i.snapshot.backend&&("stuck-route"===m.reason?l.push(`Recent ${m.action} was followed by a nearly identical snapshot after ${m.retryCount} automatic retr${1===m.retryCount?"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.`):"sharp-drop"===m.reason&&l.push("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.")),Array.from(new Set(l)))}}function tt(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 tn(e){return["visible","hidden","exists","editable","selected","text"].includes(e)}function ta(e){return!!(e&&Number.isFinite(e.x)&&Number.isFinite(e.y)&&Number.isFinite(e.width)&&Number.isFinite(e.height)&&e.width>0&&e.height>0)}async function tr(e,t){let n=t??"default",a=await e.sessions.get(n);if(!a)throw new r("SESSION_NOT_FOUND","No active session. Run open first.");if(!a.snapshot)throw new r("INVALID_ARGS","No snapshot in session. Run snapshot first.");return{sessionName:n,session:a,snapshot:a.snapshot}}async function ti(e,t,n={updateSession:!0}){if(!e.backend.captureSnapshot)throw new r("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let a=t.session??"default",i=await e.sessions.get(a),s=await e.backend.captureSnapshot(e3(e,t),{interactiveOnly:!1,compact:!1,depth:t.depth,scope:n.scope??t.scope,raw:t.raw}),o=s.snapshot??{nodes:s.nodes??[],truncated:s.truncated,backend:s.backend,createdAt:e8(e)};return n.updateSession&&i&&await e.sessions.set({...i,snapshot:o}),{sessionName:a,session:i,snapshot:o}}async function ts(e,t,n){if(e.backend.readText){let a=await e.backend.readText(e3(e,{session:t.sessionName}),n);if(a.text.trim())return a.text}return k(n)}function to(e){return{kind:"selector",selector:e}}function tl(e,t={}){return{kind:"ref",ref:e,...t.fallbackLabel?{fallbackLabel:t.fallbackLabel}:{}}}let tc=async(e,t)=>{let n=t.locator??"any";if(!t.query)throw new r("INVALID_ARGS","find requires a value");if("wait"===t.action)return await tg(e,t,n);let a=await ti(e,t,{updateSession:!0,scope:e4(n)?t.query:void 0}),i=S(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0];if(!i)throw new r("COMMAND_FAILED","find did not match any element");if("exists"===t.action)return{kind:"found",found:!0};let s=`@${i.ref}`;return"get_attrs"===t.action?{kind:"attrs",ref:s,node:i}:{kind:"text",ref:s,text:await ts(e,a,i),node:i}},td=async(e,t)=>{if("ref"===t.target.kind){let n=await tr(e,t.session),a=function(e,t,n){let a=R(t);if(!a)throw new r("INVALID_ARGS",n.invalidRefMessage);let i=M(e,a)??(n.fallbackLabel.length>0?g(e,n.fallbackLabel):null);if(!i)throw new r("COMMAND_FAILED",n.notFoundMessage);return{ref:a,node:i}}(n.snapshot.nodes,t.target.ref,{fallbackLabel:t.target.fallbackLabel??"",invalidRefMessage:"get text requires a ref like @e2",notFoundMessage:`Ref ${t.target.ref} not found`}),i=f(a.node,e.backend.platform,{action:"get"}),s={kind:"ref",ref:`@${a.ref}`};return"attrs"===t.property?{kind:"attrs",target:s,node:a.node,selectorChain:i}:{kind:"text",target:s,text:await ts(e,n,a.node),node:a.node,selectorChain:i}}let n=await tv(e,t,t.session??"default",{selector:t.target.selector,disambiguateAmbiguous:"text"===t.property}),a=f(n.node,e.backend.platform,{action:"get"});if("attrs"===t.property)return{kind:"attrs",target:{kind:"selector",selector:n.selector},node:n.node,selectorChain:a};let i=await ts(e,n.capture,n.node);return{kind:"text",target:{kind:"selector",selector:n.selector},text:i,node:n.node,selectorChain:a}},tu=async(e,t)=>{let n=await td(e,{...t,property:"text",target:t.target});if("text"!==n.kind)throw new r("COMMAND_FAILED","getText returned non-text result");return n},tp=async(e,t)=>{let n=await td(e,{...t,property:"attrs",target:t.target});if("attrs"!==n.kind)throw new r("COMMAND_FAILED","getAttrs returned non-attrs result");return n},tm=async(e,t)=>{if(!tn(t.predicate))throw new r("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text");if("text"===t.predicate&&!t.expectedText)throw new r("INVALID_ARGS","is text requires expected text value");let n=await ti(e,t,{updateSession:!0}),a=d(t.selector);if("exists"===t.predicate){let i=w(n.snapshot.nodes,a,{platform:e.backend.platform});if(!i)throw new r("COMMAND_FAILED",v(a,[],{unique:!1}));return{predicate:t.predicate,pass:!0,selector:i.selector.raw,matches:i.matches,selectorChain:a.selectors.map(e=>e.raw)}}let i=b(n.snapshot.nodes,a,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:!1});if(!i)throw new r("COMMAND_FAILED",v(a,[],{unique:!0}));let s=function(e){let{predicate:t,node:n,nodes:a,expectedText:r,platform:i}=e,s=c(n),o=p(n,i),l=!0===n.selected,d="text"===t?u(n):function(e,t){if(!0===e.hittable)return!0;if(ta(e.rect))return e0(e,t);if(e.rect)return!1;let n=function(e,t){let n=new Map(t.map(e=>[e.index,e])),a=e,r=new Set;for(;"number"==typeof a.parentIndex&&!r.has(a.index);){r.add(a.index);let e=n.get(a.parentIndex);if(!e)break;if(function(e){let t=A(e.type??"");return!(t.includes("application")||t.includes("window")||t.includes("scrollview")||t.includes("tableview")||t.includes("collectionview"))&&"table"!==t&&"list"!==t&&"listview"!==t&&(!0===e.hittable||ta(e.rect))}(e))return e;a=e}return null}(e,t);return!!n&&(!0===n.hittable||!!ta(n.rect)&&e0(n,t))}(n,a),m=!1;switch(t){case"visible":m=d;break;case"hidden":m=!d;break;case"editable":m=o;break;case"selected":m=l;break;case"text":m=s===(r??"")}let h="text"===t?`expected="${r??""}" actual="${s}"`:`actual=${JSON.stringify({visible:d,editable:o,selected:l})}`;return{pass:m,actualText:s,details:h}}({predicate:t.predicate,node:i.node,nodes:n.snapshot.nodes,expectedText:t.expectedText,platform:e.backend.platform});if(!s.pass)throw new r("COMMAND_FAILED",`is ${t.predicate} failed for selector ${i.selector.raw}: ${s.details}`);return{predicate:t.predicate,pass:!0,selector:i.selector.raw,..."text"===t.predicate?{text:s.actualText}:{},selectorChain:a.selectors.map(e=>e.raw)}},th=async(e,t)=>await tm(e,{...t,predicate:"visible",selector:t.target.selector}),tf=async(e,t)=>await tm(e,{...t,predicate:"hidden",selector:t.target.selector}),tw=async(e,t)=>{if("sleep"===t.target.kind)return await e6(e,t.target.durationMs),{kind:"sleep",waitedMs:t.target.durationMs};if("ref"===t.target.kind){let n=await tr(e,t.session),a=R(t.target.ref);if(!a)throw new r("INVALID_ARGS",`Invalid ref: ${t.target.ref}`);let i=M(n.snapshot.nodes,a),s=i?y(i,n.snapshot.nodes):void 0;if(!s)throw new r("COMMAND_FAILED",`Ref ${t.target.ref} not found or has no label`);return await tx(e,t,s,t.target.timeoutMs)}if("selector"===t.target.kind)return await ty(e,t,t.target.selector,t.target.timeoutMs);if(!t.target.text)throw new r("INVALID_ARGS","wait requires text");return await tx(e,t,t.target.text,t.target.timeoutMs)},tb=async(e,t)=>{let n=await tw(e,{...t,target:{kind:"text",text:t.text,timeoutMs:t.timeoutMs}});if("text"!==n.kind)throw new r("COMMAND_FAILED","waitForText returned non-text result");return n};async function tg(e,t,n){let a=t.timeoutMs??1e4,i=e8(e);for(;e8(e)-i<a;){if(S((await ti(e,t,{updateSession:!0,scope:e4(n)?t.query:void 0})).snapshot.nodes,n,t.query,{requireRect:!1}).matches[0])return{kind:"found",found:!0,waitedMs:e8(e)-i};await e6(e,300)}throw new r("COMMAND_FAILED","find wait timed out")}async function ty(e,t,n,a){let i=a??1e4,s=e8(e),o=d(n);for(;e8(e)-s<i;){let n=w((await ti(e,t,{updateSession:!0})).snapshot.nodes,o,{platform:e.backend.platform});if(n)return{kind:"selector",selector:n.selector.raw,waitedMs:e8(e)-s};await e6(e,300)}throw new r("COMMAND_FAILED",`wait timed out for selector: ${n}`)}async function tx(e,t,n,a){let i=a??1e4,s=e8(e);for(;e8(e)-s<i;){if(e.backend.findText?(await e.backend.findText(e3(e,t),n)).found:await tk(e,t,n))return{kind:"text",text:n,waitedMs:e8(e)-s};await e6(e,300)}throw new r("COMMAND_FAILED",`wait timed out for text: ${n}`)}async function tk(e,t,n){return!!g((await ti(e,t,{updateSession:!0})).snapshot.nodes,n)}async function tv(e,t,n,a){let i=await ti(e,{...t,session:n},{updateSession:!0}),s=d(a.selector),o=b(i.snapshot.nodes,s,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:a.disambiguateAmbiguous});if(!o)throw new r("COMMAND_FAILED",v(s,[],{unique:!0}));return{capture:i,node:o.node,selector:o.selector.raw,ref:`@${o.node.ref}`}}function tA(e,t,n,a){if(!Number.isFinite(e)||!Number.isInteger(e)||e<n||e>a)throw new r("INVALID_ARGS",`${t} must be an integer between ${n} and ${a}`);return e}function tI(e,t){let n=function(e,t){let n=tM(t.rect);if(!n)return null;let a=t,r=new Set;for(;!r.has(a.ref);){r.add(a.ref);let t=e.filter(e=>{if(e.parentIndex!==a.index||!e.hittable)return!1;let t=tM(e.rect);return!!t&&tR(t,n)});if(1!==t.length)break;a=t[0]}return a===t?null:a}(e,t);if(n?.rect&&tN(n.rect))return n;let a=h(e,t);return a?.rect&&tN(a.rect)?!function(e,t,n){var a,r,i,s;let o,l,c,d=tM(e.rect),u=tM(t.rect);if(!d||!u)return!1;let p=function(e,t){let n=N(t),a=e.filter(e=>{let t=(e.type??"").toLowerCase();return t.includes("application")||t.includes("window")}).map(e=>tM(e.rect)).filter(e=>null!==e);if(0===a.length)return null;let r=a.filter(e=>eV(e,n.x,n.y));return eX(r.length>0?r:a)}(n,d);return!!p&&(a=u,r=p,o=(i=a,s=r,Math.max(0,Math.min(i.x+i.width,s.x+s.width)-Math.max(i.x,s.x))*Math.max(0,Math.min(i.y+i.height,s.y+s.height)-Math.max(i.y,s.y))),l=a.width*a.height,c=r.width*r.height,!(o<=0)&&!(l<=0)&&!(c<=0)&&!!(o/c>=.9)&&!!(o/l>=.8))&&!tR(d,u)}(t,a,e)?a:t:t}function tN(e){let t=tM(e);if(!t)return null;let n=N(t);return Number.isFinite(n.x)&&Number.isFinite(n.y)?n:null}function tM(e){if(!e)return null;let t=Number(e.x),n=Number(e.y),a=Number(e.width),r=Number(e.height);return Number.isFinite(t)&&Number.isFinite(n)&&Number.isFinite(a)&&Number.isFinite(r)&&!(a<0)&&!(r<0)?{x:t,y:n,width:a,height:r}:null}function tR(e,t){return .5>=Math.abs(e.x-t.x)&&.5>=Math.abs(e.y-t.y)&&.5>=Math.abs(e.width-t.width)&&.5>=Math.abs(e.height-t.height)}async function tS(e,t,n){if(await tO(e,t,n.action),"point"===t.target.kind)return{kind:"point",point:{x:t.target.x,y:t.target.y}};if("ref"===t.target.kind){let a=await t_(e,t,t.target),i=a.resolved,s=n.promoteToHittableAncestor?tI(a.snapshot.nodes,i.node):i.node;return function(e,t,n,a){let i=e.rect?e1(e,t):null;if(!(!e.rect||!i||e0(e,t)))throw new r("COMMAND_FAILED",`Ref ${n} is off-screen and not safe to ${a}`,{reason:"offscreen_ref",ref:R(n),rect:e.rect,viewport:i,hint:`Use scroll with the direction from the off-screen summary, take a fresh snapshot, then retry ${a} with the new ref or a selector.`})}(s,a.snapshot.nodes,t.target.ref,n.action),{kind:"ref",point:tE(s,`Ref ${t.target.ref} not found or has invalid bounds`),target:{kind:"ref",ref:`@${i.ref}`},node:s,selectorChain:f(s,e.backend.platform,{action:"fill"===n.action?"fill":"click"}),refLabel:y(s,a.snapshot.nodes)}}let a=await tP(e,t,n.requireInteractive),i=d(t.target.selector),s=b(a.snapshot.nodes,i,{platform:e.backend.platform,requireRect:!0,requireUnique:!0,disambiguateAmbiguous:!0});if(!s||!s.node.rect)throw new r("COMMAND_FAILED",v(i,s?.diagnostics??[],{unique:!0}));let o=n.promoteToHittableAncestor?tI(a.snapshot.nodes,s.node):s.node;return{kind:"selector",point:tE(o,`Selector ${s.selector.raw} resolved to invalid bounds`),target:{kind:"selector",selector:s.selector.raw},node:o,selectorChain:f(o,e.backend.platform,{action:"fill"===n.action?"fill":"click"}),refLabel:y(o,a.snapshot.nodes)}}async function tP(e,t,n){if(!e.backend.captureSnapshot)throw new r("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let a=t.session??"default",i=await e.sessions.get(a);if(!i)throw new r("SESSION_NOT_FOUND","No active session. Run open first.");let s=await e.backend.captureSnapshot(e3(e,t),{interactiveOnly:n,compact:n}),o=s.snapshot??{nodes:s.nodes??[],truncated:s.truncated,backend:s.backend,createdAt:e8(e)};return await e.sessions.set({...i,snapshot:o}),{snapshot:o}}async function tO(e,t,n){if("macos"!==e.backend.platform)return;let a=await tD(e,t);if(("desktop"===a||"menubar"===a)&&("menubar"!==a||"click"!==n&&"press"!==n))throw new r("UNSUPPORTED_OPERATION",`${n} is not supported on macOS ${a} sessions yet. Open an app session to act, or use the ${a} surface to inspect.`)}async function tD(e,t){let n=await e.sessions.get(t.session??"default");return n?.metadata?.surface}async function t_(e,t,n){let a=t.session??"default",i=await e.sessions.get(a);if(!i)throw new r("SESSION_NOT_FOUND","No active session. Run open first.");if(!i.snapshot)throw new r("INVALID_ARGS","No snapshot in session. Run snapshot first.");let s=n.fallbackLabel??"",o=tT(i.snapshot.nodes,n.ref,{fallbackLabel:s,requireRect:!0});if(o)return{snapshot:i.snapshot,resolved:o};let l=await tP(e,t,!0),c=tT(l.snapshot.nodes,n.ref,{fallbackLabel:s,requireRect:!0});if(!c)throw new r("COMMAND_FAILED",`Ref ${n.ref} not found or has no bounds`);return{...l,resolved:c}}function tT(e,t,n){let a=R(t);if(!a)throw new r("INVALID_ARGS",`Invalid ref: ${t}`);let i=M(e,a);if(t$(i,n.requireRect))return{ref:a,node:i};let s=n.fallbackLabel.length>0?g(e,n.fallbackLabel):null;return t$(s,n.requireRect)?{ref:a,node:s}:null}function tE(e,t){if(!e.rect)throw new r("COMMAND_FAILED",t);let n=N(e.rect);if(!Number.isFinite(n.x)||!Number.isFinite(n.y))throw new r("COMMAND_FAILED",t);return n}function t$(e,t){if(!e)return!1;if(!t)return!0;if(!e.rect)return!1;let{x:n,y:a,width:r,height:i}=e.rect;if(!Number.isFinite(Number(n))||!Number.isFinite(Number(a))||!Number.isFinite(Number(r))||!Number.isFinite(Number(i))||0>Number(r)||0>Number(i))return!1;let s=N(e.rect);return Number.isFinite(s.x)&&Number.isFinite(s.y)}let tL=async(e,t)=>{let n=await tS(e,t,{action:"focus",requireInteractive:!0,promoteToHittableAncestor:!1});if(!e.backend.focus)throw new r("UNSUPPORTED_OPERATION","focus is not supported by this backend");let a=tz(await e.backend.focus(e3(e,t),n.point));return{...n,...a?{backendResult:a}:{},...P(`Focused (${n.point.x}, ${n.point.y})`)}},tC=async(e,t)=>{let n=await tS(e,t,{action:"longPress",requireInteractive:!0,promoteToHittableAncestor:!0});if(!e.backend.longPress)throw new r("UNSUPPORTED_OPERATION","longPress is not supported by this backend");let a=void 0===t.durationMs?void 0:tA(t.durationMs,"durationMs",0,12e4),i=tz(await e.backend.longPress(e3(e,t),n.point,{durationMs:a}));return{...n,...void 0!==a?{durationMs:a}:{},...i?{backendResult:i}:{},...P(`Long pressed (${n.point.x}, ${n.point.y})`)}},tU=async(e,t)=>{var n,a;if(!e.backend.scroll)throw new r("UNSUPPORTED_OPERATION","scroll is not supported by this backend");let i=tV(t.direction,"scroll direction"),s=(n=t.amount,a="scroll amount",void 0===n?void 0:tY(n,a)),o=function(e,t){if(void 0!==e){if(!Number.isFinite(e)||!Number.isInteger(e)||e<=0)throw new r("INVALID_ARGS",`${t} must be a positive integer`);return e}}(t.pixels,"scroll pixels");if(void 0!==s&&void 0!==o)throw new r("INVALID_ARGS","scroll accepts either amount or pixels, not both");let l=await tG(e,t),c="viewport"===l.kind?{kind:"viewport"}:{kind:"point",point:l.point},d=tz(await e.backend.scroll(e3(e,t),c,{direction:i,...void 0!==s?{amount:s}:{},...void 0!==o?{pixels:o}:{}}));return{...l,direction:i,...void 0!==s?{amount:s}:{},...void 0!==o?{pixels:o}:{},...d?{backendResult:d}:{},...P(void 0!==o?`Scrolled ${i} by ${o}px`:void 0!==s?`Scrolled ${i} by ${s}`:`Scrolled ${i}`)}},tF=async(e,t)=>{if(!e.backend.swipe)throw new r("UNSUPPORTED_OPERATION","swipe is not supported by this backend");let n=await tB(e,t),a=function(e,t){if(t.to)return{point:tX(t.to,"to")};let n=tV(t.direction,"swipe direction"),a=tY(t.distance??200,"swipe distance");switch(n){case"up":return{point:{x:e.x,y:e.y-a},direction:n,distance:a};case"down":return{point:{x:e.x,y:e.y+a},direction:n,distance:a};case"left":return{point:{x:e.x-a,y:e.y},direction:n,distance:a};case"right":return{point:{x:e.x+a,y:e.y},direction:n,distance:a}}}(n.point,t),i=void 0===t.durationMs?void 0:tA(t.durationMs,"durationMs",16,1e4),s=tz(await e.backend.swipe(e3(e,t),n.point,a.point,{durationMs:i}));return{kind:"swipe",from:n.point,to:a.point,...a.direction?{direction:a.direction}:{},...void 0!==a.distance?{distance:a.distance}:{},...void 0!==i?{durationMs:i}:{},...n.target?{fromTarget:n.target}:{},...s?{backendResult:s}:{},...P("Swiped")}},tq=async(e,t)=>{if(!e.backend.pinch)throw new r("UNSUPPORTED_OPERATION","pinch is not supported by this backend");await tO(e,t,"pinch");let n=tY(t.scale,"pinch scale"),a=t.center?await tS(e,{...t,target:t.center},{action:"pinch",requireInteractive:!1,promoteToHittableAncestor:!1}):void 0,i=tz(await e.backend.pinch(e3(e,t),{scale:n,...a?{center:a.point}:{}}));return{kind:"pinch",scale:n,...a?{center:a.point,centerTarget:a}:{},...i?{backendResult:i}:{},...P(`Pinched to scale ${n}`)}};async function tG(e,t){let n=t.target??{kind:"viewport"};return"viewport"===n.kind?(await tO(e,t,"scroll"),{kind:"viewport"}):await tS(e,{...t,target:n},{action:"scroll",requireInteractive:!1,promoteToHittableAncestor:!1})}async function tB(e,t){if(t.from){var n;if("x"in(n=t.from)&&"y"in n)return await tO(e,t,"swipe"),{point:tX(t.from,"from")};let a=await tS(e,{...t,target:t.from},{action:"swipe",requireInteractive:!1,promoteToHittableAncestor:!1});return{point:a.point,target:a}}if(!t.direction)throw new r("INVALID_ARGS","swipe requires from+to or a direction");return await tO(e,t,"swipe"),{point:N(function(e){let t=e.filter(t=>e0(t,e)).map(e=>e.rect).filter(tH),n=t.length>0?t:e.map(e=>e.rect).filter(tH);if(0===n.length)throw new r("COMMAND_FAILED","Cannot infer viewport for directional swipe");let a=Math.min(...n.map(e=>e.x)),i=Math.min(...n.map(e=>e.y));return{x:a,y:i,width:Math.max(...n.map(e=>e.x+e.width))-a,height:Math.max(...n.map(e=>e.y+e.height))-i}}((await tP(e,t,!1)).snapshot.nodes)),target:{kind:"viewport"}}}function tV(e,t){switch(e){case"up":case"down":case"left":case"right":return e;default:throw new r("INVALID_ARGS",`${t} must be up, down, left, or right`)}}function tX(e,t){let n=Number(e.x),a=Number(e.y);if(!Number.isFinite(n)||!Number.isFinite(a))throw new r("INVALID_ARGS",`${t} point requires finite x and y`);return{x:n,y:a}}function tY(e,t){if(!Number.isFinite(e)||e<=0)throw new r("INVALID_ARGS",`${t} must be a positive number`);return e}function tH(e){return!!(e&&e.width>0&&e.height>0)}function tz(e){return e&&"object"==typeof e?e:void 0}let tj=async(e,t)=>await tZ(e,t,"press"),tK=async(e,t)=>await tZ(e,t,"click"),tW=async(e,t)=>{var n;if(!t.text)throw new r("INVALID_ARGS","fill requires text");let a=await tS(e,t,{action:"fill",requireInteractive:!0,promoteToHittableAncestor:!1});if(!e.backend.fill)throw new r("UNSUPPORTED_OPERATION","fill is not supported by this backend");let i=tQ(await e.backend.fill(e3(e,t),a.point,t.text,{delayMs:t.delayMs})),s="node"in a?a.node.type??"":"",o=s&&!I(s,e.backend.platform)?`fill target ${n=a,n.target?.kind==="ref"?n.target.ref:n.target?.kind==="selector"?n.target.selector:"point"} resolved to "${s}", attempting fill anyway.`:void 0;return{...a,text:t.text,...o?{warning:o}:{},...i?{backendResult:i}:{}}},tJ=async(e,t)=>{let n=t.text;if(!n)throw new r("INVALID_ARGS","type requires text");let a=function(e){let t=e.trim().split(/\s+/,1)[0];if(!t||!t.startsWith("@")||t.length<3)return null;let n=t.slice(1);return/^[A-Za-z_-]*\d[\w-]*$/i.test(n)||/^(?:ref|node|element|el)[\w-]*$/i.test(n)?t:null}(n);if(a)throw new r("INVALID_ARGS",`type does not accept a target ref like "${a}"`,{hint:`Use fill ${a} "text" to target that field, or press ${a} then type "text" to append.`});if(!e.backend.typeText)throw new r("UNSUPPORTED_OPERATION","type is not supported by this backend");let i=tA(t.delayMs??0,"delay-ms",0,1e4),s=tQ(await e.backend.typeText(e3(e,t),n,{delayMs:i}));return{kind:"text",text:n,delayMs:i,...s?{backendResult:s}:{},...P(`Typed ${Array.from(n).length} chars`)}};async function tZ(e,t,n){let a=await tS(e,t,{action:n,requireInteractive:!0,promoteToHittableAncestor:!0});if(!e.backend.tap)throw new r("UNSUPPORTED_OPERATION","tap is not supported by this backend");let i=tQ(await e.backend.tap(e3(e,t),a.point,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap}));return{...a,...i?{backendResult:i}:{}}}function tQ(e){return e&&"object"==typeof e?e:void 0}let t0=async(e,t={})=>{if(!e.backend.pressBack)throw new r("UNSUPPORTED_OPERATION","system.back is not supported by this backend");let n=t.mode??"in-app";if("in-app"!==n&&"system"!==n)throw new r("INVALID_ARGS","system.back mode must be in-app or system");let a=t9(await e.backend.pressBack(e3(e,t),{mode:n}));return{kind:"systemBack",mode:n,...a?{backendResult:a}:{},...P("Back")}},t1=async(e,t={})=>{if(!e.backend.pressHome)throw new r("UNSUPPORTED_OPERATION","system.home is not supported by this backend");let n=t9(await e.backend.pressHome(e3(e,t)));return{kind:"systemHome",...n?{backendResult:n}:{},...P("Home")}},t2=async(e,t)=>{if(!e.backend.rotate)throw new r("UNSUPPORTED_OPERATION","system.rotate is not supported by this backend");let n=function(e){switch(e){case"portrait":case"portrait-upside-down":case"landscape-left":case"landscape-right":return e;default:throw new r("INVALID_ARGS","system.rotate orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right")}}(t.orientation),a=t9(await e.backend.rotate(e3(e,t),n));return{kind:"systemRotated",orientation:n,...a?{backendResult:a}:{},...P(`Rotated to ${n}`)}},t5=async(e,t={})=>{if(!e.backend.setKeyboard)throw new r("UNSUPPORTED_OPERATION","system.keyboard is not supported by this backend");let n=t.action??"status";if("status"!==n&&"get"!==n&&"dismiss"!==n)throw new r("INVALID_ARGS","system.keyboard action must be status, get, or dismiss");let a=await e.backend.setKeyboard(e3(e,t),{action:n}),i=t9(a);if("dismiss"===n){let e=t7(a)?a.dismissed:void 0;return{kind:"keyboardDismissed",action:n,state:t7(a)?a:{},...i?{backendResult:i}:{},...P(!1===e?"Keyboard already hidden":"Keyboard dismissed")}}return{kind:"keyboardState",action:n,state:t7(a)?a:{},...i?{backendResult:i}:{}}},t4=async(e,t)=>{if("read"===t.action){if(!e.backend.getClipboard)throw new r("UNSUPPORTED_OPERATION","system.clipboard read is not supported by this backend");let n=await e.backend.getClipboard(e3(e,t));return{kind:"clipboardText",action:"read",text:"string"==typeof n?n:n.text}}if("write"!==t.action)throw new r("INVALID_ARGS","system.clipboard action must be read or write");if(!e.backend.setClipboard)throw new r("UNSUPPORTED_OPERATION","system.clipboard write is not supported by this backend");if("string"!=typeof t.text)throw new r("INVALID_ARGS","system.clipboard write requires text");let n=t9(await e.backend.setClipboard(e3(e,t),t.text));return{kind:"clipboardUpdated",action:"write",textLength:Array.from(t.text).length,...n?{backendResult:n}:{},...P("Clipboard updated")}},t3=async(e,t={})=>{if(!e.backend.openSettings)throw new r("UNSUPPORTED_OPERATION","system.settings is not supported by this backend");let n=function(e,t){if(void 0===e)return;let n=e.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}(t.target,"target"),a=t9(await e.backend.openSettings(e3(e,t),n));return{kind:"settingsOpened",...n?{target:n}:{},...a?{backendResult:a}:{},...P(n?`Opened settings: ${n}`:"Opened settings")}},t8=async(e,t={})=>{if(!e.backend.handleAlert)throw new r("UNSUPPORTED_OPERATION","system.alert is not supported by this backend");let n=t.action??"get";if("get"!==n&&"accept"!==n&&"dismiss"!==n&&"wait"!==n)throw new r("INVALID_ARGS","system.alert action must be get, accept, dismiss, or wait");let a=void 0===t.timeoutMs?void 0:tA(t.timeoutMs,"timeoutMs",0,12e4),i=await e.backend.handleAlert(e3(e,t),n,{timeoutMs:a});var s=n,o=i;if("get"===s){if("alertStatus"!==o.kind)throw new r("COMMAND_FAILED","system.alert get returned an invalid backend result");return{kind:"alertStatus",action:s,alert:o.alert}}if("wait"===s){if("alertWait"!==o.kind)throw new r("COMMAND_FAILED","system.alert wait returned an invalid backend result");return{kind:"alertWait",action:s,alert:o.alert,...void 0!==o.waitedMs?{waitedMs:o.waitedMs}:{},...void 0!==o.timedOut?{timedOut:o.timedOut}:{},...P(o.alert?"Alert visible":"Alert wait timed out")}}if("alertHandled"!==o.kind)throw new r("COMMAND_FAILED",`system.alert ${s} returned an invalid backend result`);return{kind:"alertHandled",action:s,handled:o.handled,...o.alert?{alert:o.alert}:{},...o.button?{button:o.button}:{},...P(o.handled?`Alert ${s}ed`:"No alert handled")}},t6=async(e,t={})=>{if(!e.backend.openAppSwitcher)throw new r("UNSUPPORTED_OPERATION","system.appSwitcher is not supported by this backend");let n=t9(await e.backend.openAppSwitcher(e3(e,t)));return{kind:"appSwitcherOpened",...n?{backendResult:n}:{},...P("Opened app switcher")}};function t7(e){return!!(e&&"object"==typeof e)}function t9(e){return e&&"object"==typeof e?e:void 0}let ne=/^[A-Za-z0-9_.:-]{1,64}$/,nt=async(e,t)=>{var n;if(!e.backend.openApp)throw new r("UNSUPPORTED_OPERATION","apps.open is not supported by this backend");let a=function(e){var t;let n=no(e.app,"app"),a=no(e.appId,"appId"),i=no(e.bundleId,"bundleId"),s=no(e.packageName,"packageName"),o=no(e.url,"url"),l=no(e.activity,"activity"),c={...n?{app:n}:{},...a?{appId:a}:{},...i?{bundleId:i}:{},...s?{packageName:s}:{},...o?{url:o}:{},...l?{activity:l}:{}};if(!((t=c).app??t.appId??t.bundleId??t.packageName??t.url??t.activity))throw new r("INVALID_ARGS","apps.open requires app, appId, bundleId, packageName, url, or activity");return c}(t),i=np(await e.backend.openApp(nu(e,t),a,{relaunch:t.relaunch}));return{kind:"appOpened",target:a,relaunch:!0===t.relaunch,...i?{backendResult:i}:{},...P(`Opened: ${(n=a).app??n.appId??n.bundleId??n.packageName??n.url??n.activity??"app"}`)}},nn=async(e,t={})=>{if(!e.backend.closeApp)throw new r("UNSUPPORTED_OPERATION","apps.close is not supported by this backend");let n=no(t.app,"app"),a=np(await e.backend.closeApp(nu(e,t),n));return{kind:"appClosed",...n?{app:n}:{},...a?{backendResult:a}:{},...P(n?`Closed: ${n}`:"Closed app")}},na=async(e,t={})=>{if(!e.backend.listApps)throw new r("UNSUPPORTED_OPERATION","apps.list is not supported by this backend");return{kind:"appsList",apps:await e.backend.listApps(nu(e,t),t.filter??"all")}},nr=async(e,t)=>{if(!e.backend.getAppState)throw new r("UNSUPPORTED_OPERATION","apps.state is not supported by this backend");let n=nl(t.app,"app"),a=await e.backend.getAppState(nu(e,t),n);return{kind:"appState",app:n,state:a}},ni=async(e,t)=>{if(!e.backend.pushFile)throw new r("UNSUPPORTED_OPERATION","apps.push is not supported by this backend");let n=nl(t.app,"app"),a=await nc(e,t.input);try{let r=await e.backend.pushFile(nu(e,t),a.backendInput,n),i=np(r);return{kind:"appPushed",app:n,inputKind:a.inputKind,...i?{backendResult:i}:{},...P(`Pushed to ${n}`)}}finally{await a.cleanup?.()}},ns=async(e,t)=>{var n,a;if(!e.backend.triggerAppEvent)throw new r("UNSUPPORTED_OPERATION","apps.triggerEvent is not supported by this backend");let i=function(e){let t=nl(e,"name");if(!ne.test(t))throw new r("INVALID_ARGS",`Invalid apps.triggerEvent name: ${t}`,{hint:"Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash."});return t}(t.name);n=t.payload,a=`apps.triggerEvent payload for "${i}"`,void 0!==n&&nd(n,a,8192);let s=np(await e.backend.triggerAppEvent(nu(e,t),{name:i,...t.payload?{payload:t.payload}:{}}));return{kind:"appEventTriggered",name:i,...t.payload?{payload:t.payload}:{},...s?{backendResult:s}:{},...P(`Triggered app event: ${i}`)}};function no(e,t){if(void 0!==e)return nl(e,t)}function nl(e,t){let n=e?.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}async function nc(e,t){if(!t||"object"!=typeof t)throw new r("INVALID_ARGS","apps.push requires an input");if("json"===t.kind)return nd(t.payload,"apps.push JSON payload",8192),{backendInput:{kind:"json",payload:t.payload},inputKind:"json"};let n=await E(e,t,{usage:"apps.push",field:"input"});return{backendInput:{kind:"file",path:n.path},inputKind:"file",...n.cleanup?{cleanup:n.cleanup}:{}}}function nd(e,t,n){if(function(e,t){if(!e||"object"!=typeof e||Array.isArray(e))throw new r("INVALID_ARGS",`${t} must be a JSON object`)}(e,t),Buffer.byteLength(function(e,t){try{let n=JSON.stringify(e);if("string"!=typeof n)throw new r("INVALID_ARGS",`${t} must be JSON-serializable`);return n}catch{throw new r("INVALID_ARGS",`${t} must be JSON-serializable`)}}(e,t),"utf8")>n)throw new r("INVALID_ARGS",`${t} exceeds ${n} bytes`)}function nu(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function np(e){return e&&"object"==typeof e?e:void 0}let nm=async(e,t={})=>{if(!e.backend.listDevices)throw new r("UNSUPPORTED_OPERATION","admin.devices is not supported by this backend");return{kind:"adminDevices",devices:await e.backend.listDevices(e3(e,t),t.filter)}},nh=async(e,t={})=>{if(!e.backend.bootDevice)throw new r("UNSUPPORTED_OPERATION","admin.boot is not supported by this backend");let n=function(e){if(!e)return;let t=nA(e.id,"target.id"),n=nA(e.name,"target.name"),a={...t?{id:t}:{},...n?{name:n}:{},...e.platform?{platform:e.platform}:{},...e.target?{target:e.target}:{},...void 0!==e.headless?{headless:e.headless}:{}};return Object.keys(a).length>0?a:void 0}(t.target),a=nM(await e.backend.bootDevice(e3(e,t),n));return{kind:"deviceBooted",...n?{target:n}:{},...a?{backendResult:a}:{},...P("Booted device")}},nf=async(e,t)=>{if(!e.backend.ensureSimulator)throw new r("UNSUPPORTED_OPERATION","admin.ensureSimulator is not supported by this backend");let n=nI(t.device,"device");return{kind:"simulatorEnsured",...await e.backend.ensureSimulator(e3(e,t),{device:n,...t.runtime?{runtime:nI(t.runtime,"runtime")}:{},...void 0!==t.boot?{boot:t.boot}:{},...void 0!==t.reuseExisting?{reuseExisting:t.reuseExisting}:{}})}},nw=async(e,t)=>await ny(e,t,"install"),nb=async(e,t)=>await ny(e,t,"reinstall"),ng=async(e,t)=>await ny(e,t,"installFromSource");async function ny(e,t,n){let a="reinstall"===n?"reinstallApp":"installApp",i=e.backend[a];if(!i)throw new r("UNSUPPORTED_OPERATION",`admin.${n} is not supported by this backend`);let s="app"in t&&void 0!==t.app?nI(t.app,"app"):void 0;if("installFromSource"!==n&&!s)throw new r("INVALID_ARGS",`admin.${n} requires app`);let o=e3(e,t),l=await nx(e,o,t.source);try{var c,d,u,p,m;let t,a,r,h,f,w,b,g,y=await i.call(e.backend,o,{...s?{app:s}:{},source:l.source});return c=n,d=s,u=l.source,p=y,t=nM(p),a=nN(p,"appName"),r=nN(p,"appId"),h=nN(p,"bundleId"),f=nN(p,"packageName"),w=nN(p,"launchTarget"),b=nN(p,"installablePath"),g=nN(p,"archivePath"),{kind:"reinstall"===c?"appReinstalled":"installFromSource"===c?"appInstalledFromSource":"appInstalled",...d?{app:d}:{},source:u,...r?{appId:r}:{},...a?{appName:a}:{},...h?{bundleId:h}:{},...f?{packageName:f}:{},...w?{launchTarget:w}:{},...b?{installablePath:b}:{},...g?{archivePath:g}:{},...t?{backendResult:t}:{},...P(`${"reinstall"===c?"Reinstalled":"Installed"}: ${a??w??d??(m=u,"path"===m.kind?m.path:"uploadedArtifact"===m.kind?m.id:m.url)}`)}}finally{await l.cleanup?.()}}async function nx(e,t,n){let a=nv(n),r=await nk(e,a);try{let n=e.backend.resolveInstallSource?await e.backend.resolveInstallSource(t,r.source):r.source;return{source:nv(n),...r.cleanup?{cleanup:r.cleanup}:{}}}catch(e){if(r.cleanup)try{await r.cleanup()}catch{}throw e}}async function nk(e,t){if("url"===t.kind)return{source:t};let n=await E(e,t,{usage:"admin.install",field:"source"});return{source:{kind:"path",path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function nv(e){if(!e||"object"!=typeof e)throw new r("INVALID_ARGS","install source is required");if("path"===e.kind)return{kind:"path",path:nI(e.path,"source.path")};if("uploadedArtifact"===e.kind)return{kind:"uploadedArtifact",id:nI(e.id,"source.id")};if("url"===e.kind){let t=nI(e.url,"source.url");return function(e){let t;try{t=new URL(e)}catch{throw new r("INVALID_ARGS",`Invalid install source URL: ${e}`)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new r("INVALID_ARGS","Install source URL must use http or https")}(t),{kind:"url",url:t}}throw new r("INVALID_ARGS","install source kind must be path, uploadedArtifact, or url")}function nA(e,t){if(void 0!==e)return nI(e,t)}function nI(e,t){let n=e?.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}function nN(e,t){let n=e[t];return"string"==typeof n&&n.length>0?n:void 0}function nM(e){return e&&"object"==typeof e?e:void 0}let nR=async(e,t)=>{let n=nP(t.action,"record"),a="start"===n?e.backend.startRecording:e.backend.stopRecording;if(!a)throw new r("UNSUPPORTED_OPERATION",`record ${n} is not supported by this backend`);let i=t.out?await $(e,t.out,{field:"path",ext:".mp4"}):void 0;try{var s,o,l,c,d;let r,u,p=(s=t,o=i?.path,r=void 0===s.fps?void 0:tA(s.fps,"fps",1,60),u=void 0===s.quality?void 0:tA(s.quality,"quality",5,10),{...o?{outPath:o}:{},...void 0!==r?{fps:r}:{},...void 0!==u?{quality:u}:{},...void 0!==s.hideTouches?{showTouches:!0!==s.hideTouches}:{}}),m=await a.call(e.backend,e3(e,t),p),h=await i?.publish();return l=n,c=m,d=h,{..."string"==typeof c.path?{path:c.path}:{},..."string"==typeof c.telemetryPath?{telemetryPath:c.telemetryPath}:{},..."string"==typeof c.warning?{warning:c.warning}:{},...nO(l,c,d,{startKind:"recordingStarted",stopKind:"recordingStopped",startMessage:"Recording started",stopMessage:"Recording stopped"})}}catch(e){throw await i?.cleanup?.(),e}},nS=async(e,t)=>{let n=nP(t.action,"trace"),a="start"===n?e.backend.startTrace:e.backend.stopTrace;if(!a)throw new r("UNSUPPORTED_OPERATION",`trace ${n} is not supported by this backend`);let i=t.out?await $(e,t.out,{field:"outPath",ext:".trace"}):void 0;try{var s,o,l;let r={...i?.path?{outPath:i.path}:{}},c=await a.call(e.backend,e3(e,t),r),d=await i?.publish();return s=n,o=c,l=d,{..."string"==typeof o.outPath?{outPath:o.outPath}:{},...nO(s,o,l,{startKind:"traceStarted",stopKind:"traceStopped",startMessage:"Trace started",stopMessage:"Trace stopped"})}}catch(e){throw await i?.cleanup?.(),e}};function nP(e,t){if("start"===e||"stop"===e)return e;throw new r("INVALID_ARGS",`${t} action must be start or stop`)}function nO(e,t,n,a){return{kind:"start"===e?a.startKind:a.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...P("start"===e?a.startMessage:a.stopMessage)}}let nD=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function n_(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[a,r]of Object.entries(e))if(nD.test(a))n[a]="[REDACTED]",t=!0;else{let e=nL(r,2048);n[a]=e.value??"",t||=e.redacted}return{value:n,redacted:t}}function nT(e){return void 0===e?{redacted:!1}:function(e){try{let t=JSON.parse(e),n=n$(t,nC);return nU(JSON.stringify(n.value),2048,n.redacted)}catch{return}}(e)??nL(e,2048)}function nE(e){return n$(e,e=>nL(e,2048))}function n$(e,t){if(void 0===e)return{redacted:!1};if("string"==typeof e)return t(e);if(!e||"object"!=typeof e)return{value:e,redacted:!1};if(Array.isArray(e)){let n=!1;return{value:e.map(e=>{let a=n$(e,t);return n||=a.redacted,a.value}),redacted:n}}let n=!1,a={};for(let[r,i]of Object.entries(e)){if(nD.test(r)){a[r]="[REDACTED]",n=!0;continue}let e=n$(i,t);a[r]=e.value,n||=e.redacted}return{value:a,redacted:n}}function nL(e,t){if(void 0===e)return{redacted:!1};let n=nC(e);return nU(n.value,t,n.redacted)}function nC(e){let t=!1,n=e.replaceAll(/(authorization|token|secret|password|passwd|api[-_]?key)=([^&\s]+)/gi,(e,n)=>(t=!0,`${String(n)}=[REDACTED]`));return{value:n=(n=(n=n.replaceAll(/("(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)"\s*:\s*")([^"]*)(")/gi,(e,n,a,r)=>(t=!0,`${String(n)}[REDACTED]${String(r)}`))).replaceAll(/\b(Bearer\s+)([^\s",;]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`))).replaceAll(/((?:authorization|cookie|token|secret|password|passwd|api[-_]?key)\s*[:=]\s*)([^\s,;]+)/gi,(e,n)=>(t=!0,`${String(n)}[REDACTED]`)),redacted:t}}function nU(e,t,n){if(void 0===e)return{redacted:n};let a=e;return a.length>t&&(a=`${a.slice(0,t)}...[truncated]`,n=!0),{value:a,redacted:n}}let nF=async(e,t={})=>{var n,a;let i;if(!e.backend.readLogs)throw new r("UNSUPPORTED_OPERATION","diagnostics.logs is not supported by this backend");return i=!0===(n=await e.backend.readLogs(await nB(e,t),{...nV(a=t,100,500,"logs limit"),...void 0!==a.levels?{levels:nY(a.levels,"levels")}:{},...void 0!==a.search?{search:nH(a.search,"search")}:{},...void 0!==a.source?{source:nH(a.source,"source")}:{}})).redacted,{kind:"diagnosticsLogs",entries:n.entries.map(e=>{let t=nL(e.message,4096),n=nE(e.metadata);return i||=t.redacted||n.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.level?{level:e.level}:{},message:t.value??"",...e.source?{source:e.source}:{},...n.value?{metadata:n.value}:{}}}),...n.nextCursor?{nextCursor:n.nextCursor}:{},...n.timeWindow?{timeWindow:n.timeWindow}:{},...n.backend?{backend:n.backend}:{},redacted:i,...n.notes?{notes:n.notes}:{}}},nq=async(e,t={})=>{var n,a,i;let s;if(!e.backend.dumpNetwork)throw new r("UNSUPPORTED_OPERATION","diagnostics.network is not supported by this backend");let o={...nV(i=t,25,200,"network limit"),include:function(e){if(void 0===e)return"summary";if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new r("INVALID_ARGS","network include must be summary, headers, body, or all")}(i.include)};return n=await e.backend.dumpNetwork(await nB(e,t),o),a=o.include??"summary",s=!0===n.redacted,{kind:"diagnosticsNetwork",entries:n.entries.map(e=>{let t=e.url?function(e){try{let t=new URL(e),n=!1;for(let e of Array.from(t.searchParams.keys()))nD.test(e)&&(t.searchParams.set(e,"[REDACTED]"),n=!0);return{value:t.toString(),redacted:n}}catch{return nL(e,2048)}}(e.url):void 0,n="headers"===a||"all"===a?n_(e.requestHeaders):void 0,r="headers"===a||"all"===a?n_(e.responseHeaders):void 0,i="body"===a||"all"===a?nT(e.requestBody):void 0,o="body"===a||"all"===a?nT(e.responseBody):void 0,l=nE(e.metadata);return s||=(t?.redacted??!1)||(n?.redacted??!1)||(r?.redacted??!1)||(i?.redacted??!1)||(o?.redacted??!1)||l.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.method?{method:e.method}:{},...t?{url:t.value}:{},...void 0!==e.status?{status:e.status}:{},...void 0!==e.durationMs?{durationMs:e.durationMs}:{},...n?.value?{requestHeaders:n.value}:{},...r?.value?{responseHeaders:r.value}:{},...i?.value!==void 0?{requestBody:i.value}:{},...o?.value!==void 0?{responseBody:o.value}:{},...l.value?{metadata:l.value}:{}}}),...n.nextCursor?{nextCursor:n.nextCursor}:{},...n.timeWindow?{timeWindow:n.timeWindow}:{},...n.backend?{backend:n.backend}:{},redacted:s,...n.notes?{notes:n.notes}:{}}},nG=async(e,t={})=>{var n,a;let i;if(!e.backend.measurePerf)throw new r("UNSUPPORTED_OPERATION","diagnostics.perf is not supported by this backend");return i=!0===(n=await e.backend.measurePerf(await nB(e,t),{...nX(a=t),...void 0!==a.sampleMs?{sampleMs:tA(a.sampleMs,"sampleMs",100,6e4)}:{},...void 0!==a.metrics?{metrics:nY(a.metrics,"metrics",20)}:{}})).redacted,{kind:"diagnosticsPerf",metrics:n.metrics.map(e=>{let t=nL(e.message,4096),n=nE(e.metadata);return i||=t.redacted||n.redacted,{name:e.name,...void 0!==e.value?{value:e.value}:{},...e.unit?{unit:e.unit}:{},...e.status?{status:e.status}:{},...void 0!==t.value?{message:t.value}:{},...n.value?{metadata:n.value}:{}}}),...n.startedAt?{startedAt:n.startedAt}:{},...n.endedAt?{endedAt:n.endedAt}:{},...n.backend?{backend:n.backend}:{},redacted:i,...n.notes?{notes:n.notes}:{}}};async function nB(e,t){let n=e3(e,t),a=t.session?await e.sessions.get(t.session):void 0;return{...n,...t.appId??a?.appId?{appId:t.appId??a?.appId}:{},...t.appBundleId??a?.appBundleId?{appBundleId:t.appBundleId??a?.appBundleId}:{}}}function nV(e,t,n,a){return{...nX(e),...void 0!==e.cursor?{cursor:nH(e.cursor,"cursor")}:{},limit:void 0===e.limit?t:tA(e.limit,a,1,n)}}function nX(e){return{...void 0!==e.since?{since:nH(e.since,"since")}:{},...void 0!==e.until?{until:nH(e.until,"until")}:{}}}function nY(e,t,n=50){if(!Array.isArray(e))throw new r("INVALID_ARGS",`${t} must be an array of strings`);if(e.length>n)throw new r("INVALID_ARGS",`${t} must contain at most ${n} entries`);return e.map((e,n)=>nH(e,`${t}[${n}]`))}function nH(e,t){let n=e.trim();if(!n)throw new r("INVALID_ARGS",`${t} must be a non-empty string`);return n}let nz=[{command:"screenshot",category:"portable-runtime",status:"implemented"},{command:"diff screenshot",category:"portable-runtime",status:"implemented"},{command:"snapshot",category:"portable-runtime",status:"implemented"},{command:"diff snapshot",category:"portable-runtime",status:"implemented"},{command:"capture.screenshot",category:"portable-runtime",status:"implemented"},{command:"capture.diffScreenshot",category:"portable-runtime",status:"implemented"},{command:"capture.snapshot",category:"portable-runtime",status:"implemented"},{command:"capture.diffSnapshot",category:"portable-runtime",status:"implemented"},{command:"find read-only",category:"portable-runtime",status:"implemented"},{command:"get",category:"portable-runtime",status:"implemented"},{command:"is",category:"portable-runtime",status:"implemented"},{command:"wait",category:"portable-runtime",status:"implemented"},{command:"selectors.find",category:"portable-runtime",status:"implemented"},{command:"selectors.get",category:"portable-runtime",status:"implemented"},{command:"selectors.is",category:"portable-runtime",status:"implemented"},{command:"selectors.wait",category:"portable-runtime",status:"implemented"},{command:"alert",category:"portable-runtime",status:"planned"},{command:"click",category:"portable-runtime",status:"implemented"},{command:"press",category:"portable-runtime",status:"implemented"},{command:"fill",category:"portable-runtime",status:"implemented"},{command:"interactions.click",category:"portable-runtime",status:"implemented"},{command:"interactions.press",category:"portable-runtime",status:"implemented"},{command:"interactions.fill",category:"portable-runtime",status:"implemented"},{command:"interactions.typeText",category:"portable-runtime",status:"implemented"},{command:"longpress",category:"portable-runtime",status:"planned"},{command:"swipe",category:"portable-runtime",status:"planned"},{command:"focus",category:"portable-runtime",status:"planned"},{command:"type",category:"portable-runtime",status:"implemented"},{command:"scroll",category:"portable-runtime",status:"planned"},{command:"pinch",category:"portable-runtime",status:"planned"},{command:"interactions.focus",category:"portable-runtime",status:"implemented"},{command:"interactions.longPress",category:"portable-runtime",status:"implemented"},{command:"interactions.swipe",category:"portable-runtime",status:"implemented"},{command:"interactions.scroll",category:"portable-runtime",status:"implemented"},{command:"interactions.pinch",category:"portable-runtime",status:"implemented"},{command:"open",category:"portable-runtime",status:"planned"},{command:"close",category:"portable-runtime",status:"planned"},{command:"apps",category:"portable-runtime",status:"planned"},{command:"appstate",category:"portable-runtime",status:"planned"},{command:"apps.open",category:"portable-runtime",status:"implemented"},{command:"apps.close",category:"portable-runtime",status:"implemented"},{command:"apps.list",category:"portable-runtime",status:"implemented"},{command:"apps.state",category:"portable-runtime",status:"implemented"},{command:"apps.push",category:"portable-runtime",status:"implemented"},{command:"apps.triggerEvent",category:"portable-runtime",status:"implemented"},{command:"back",category:"portable-runtime",status:"planned"},{command:"home",category:"portable-runtime",status:"planned"},{command:"rotate",category:"portable-runtime",status:"planned"},{command:"app-switcher",category:"portable-runtime",status:"planned"},{command:"keyboard",category:"portable-runtime",status:"planned"},{command:"clipboard",category:"portable-runtime",status:"planned"},{command:"settings",category:"portable-runtime",status:"planned"},{command:"system.back",category:"portable-runtime",status:"implemented"},{command:"system.home",category:"portable-runtime",status:"implemented"},{command:"system.rotate",category:"portable-runtime",status:"implemented"},{command:"system.appSwitcher",category:"portable-runtime",status:"implemented"},{command:"system.keyboard",category:"portable-runtime",status:"implemented"},{command:"system.clipboard",category:"portable-runtime",status:"implemented"},{command:"system.settings",category:"portable-runtime",status:"implemented"},{command:"system.alert",category:"portable-runtime",status:"implemented"},{command:"push",category:"portable-runtime",status:"planned"},{command:"trigger-app-event",category:"portable-runtime",status:"planned"},{command:"devices",category:"backend-admin",status:"implemented"},{command:"boot",category:"backend-admin",status:"implemented"},{command:"ensure-simulator",category:"backend-admin",status:"implemented"},{command:"install",category:"backend-admin",status:"implemented"},{command:"reinstall",category:"backend-admin",status:"implemented"},{command:"install-from-source",category:"backend-admin",status:"implemented"},{command:"admin.devices",category:"backend-admin",status:"implemented"},{command:"admin.boot",category:"backend-admin",status:"implemented"},{command:"admin.ensureSimulator",category:"backend-admin",status:"implemented"},{command:"admin.install",category:"backend-admin",status:"implemented"},{command:"admin.reinstall",category:"backend-admin",status:"implemented"},{command:"admin.installFromSource",category:"backend-admin",status:"implemented"},{command:"session",category:"transport-session",status:"planned"},{command:"connect",category:"environment",status:"planned"},{command:"disconnect",category:"environment",status:"planned"},{command:"connection",category:"environment",status:"planned"},{command:"metro",category:"environment",status:"planned"},{command:"react-devtools",category:"environment",status:"implemented"},{command:"record",category:"capability-gated",status:"implemented"},{command:"trace",category:"capability-gated",status:"implemented"},{command:"replay",category:"capability-gated",status:"planned"},{command:"test",category:"capability-gated",status:"planned"},{command:"batch",category:"capability-gated",status:"implemented"},{command:"logs",category:"capability-gated",status:"implemented"},{command:"network",category:"capability-gated",status:"implemented"},{command:"perf",category:"capability-gated",status:"implemented"},{command:"diagnostics.logs",category:"capability-gated",status:"implemented"},{command:"diagnostics.network",category:"capability-gated",status:"implemented"},{command:"diagnostics.perf",category:"capability-gated",status:"implemented"}];async function nj(e,t){let n=function(e,t){let n=t??50;if(!Number.isInteger(n)||n<1||n>50)throw new r("INVALID_ARGS","batch maxSteps must be an integer between 1 and 50");if(!Array.isArray(e)||0===e.length)throw new r("INVALID_ARGS","batch requires a non-empty steps array");if(e.length>n)throw new r("INVALID_ARGS",`batch has ${e.length} steps; max allowed is ${n}`);for(let t=0;t<e.length;t+=1){let n=e[t];if(!n||"object"!=typeof n||"string"!=typeof n.command)throw new r("INVALID_ARGS",`Invalid batch step at index ${t}`);if("batch"===n.command)throw new r("INVALID_ARGS",`Batch step ${t+1} cannot run ${n.command}`)}return e}(e.options.steps,e.options.maxSteps),a=Date.now(),i=[];for(let a=0;a<n.length;a+=1){let r=function(e,t,n){var a;return{...e,context:e.context??n,options:{...(a=t).session?{session:a.session}:{},...a.requestId?{requestId:a.requestId}:{},...a.signal?{signal:a.signal}:{},...a.metadata?{metadata:a.metadata}:{},...e.options??{}}}}(n[a],e.options,e.context),s=Date.now(),o=await t(r),l=Date.now()-s;if(o.ok){i.push({step:a+1,command:r.command,ok:!0,data:o.data,durationMs:l});continue}if(i.push({step:a+1,command:r.command,ok:!1,error:o.error,durationMs:l}),!1!==e.options.stopOnError)break}return{kind:"batch",total:n.length,executed:i.length,failed:i.filter(e=>!e.ok).length,totalDurationMs:Date.now()-a,results:i}}function nK(e){let t=async n=>{try{if(function(e){if("batch"===e.command||Object.hasOwn(nJ,e.command))return;let t=nz.find(t=>t.command===e.command);if(t?.status==="planned")throw new r("NOT_IMPLEMENTED",`Command ${e.command} is planned but not implemented in the runtime router yet`,{command:e.command});throw new r("UNSUPPORTED_OPERATION",`Unknown runtime command: ${e.command}`,{command:e.command})}(n),await e.beforeDispatch?.(n),"batch"===n.command)return{ok:!0,data:await nj(n,t)};let a=await e.createRuntime(n);return{ok:!0,data:await nZ(a,n)}}catch(t){return{ok:!1,error:e.formatError?.(t,n)??i(t)}}};return{dispatch:t}}function nW(e){return async(t,n)=>await e(t,n.options)}let nJ={"capture.screenshot":nW(C),"capture.diffScreenshot":nW(eM),"capture.snapshot":nW(e7),"capture.diffSnapshot":nW(e9),"selectors.find":nW(tc),"selectors.get":nW(td),"selectors.is":nW(tm),"selectors.wait":nW(tw),"interactions.click":nW(tK),"interactions.press":nW(tj),"interactions.fill":nW(tW),"interactions.typeText":nW(tJ),"interactions.focus":nW(tL),"interactions.longPress":nW(tC),"interactions.swipe":nW(tF),"interactions.scroll":nW(tU),"interactions.pinch":nW(tq),"system.back":nW(t0),"system.home":nW(t1),"system.rotate":nW(t2),"system.keyboard":nW(t5),"system.clipboard":nW(t4),"system.settings":nW(t3),"system.alert":nW(t8),"system.appSwitcher":nW(t6),"apps.open":nW(nt),"apps.close":nW(nn),"apps.list":nW(na),"apps.state":nW(nr),"apps.push":nW(ni),"apps.triggerEvent":nW(ns),"admin.devices":nW(nm),"admin.boot":nW(nh),"admin.ensureSimulator":nW(nf),"admin.install":nW(nw),"admin.reinstall":nW(nb),"admin.installFromSource":nW(ng),record:nW(nR),trace:nW(nS),"diagnostics.logs":nW(nF),"diagnostics.network":nW(nq),"diagnostics.perf":nW(nG)};async function nZ(e,t){let n=nJ[t.command];if(!n)throw new r("UNSUPPORTED_OPERATION",`Router command ${t.command} is not a runtime command`);return await n(e,t)}let nQ={capture:{screenshot:C,diffScreenshot:eM,snapshot:e7,diffSnapshot:e9},selectors:{find:tc,get:td,getText:tu,getAttrs:tp,is:tm,isVisible:th,isHidden:tf,wait:tw,waitForText:tb},interactions:{click:tK,press:tj,fill:tW,typeText:tJ,focus:tL,longPress:tC,swipe:tF,scroll:tU,pinch:tq},system:{back:t0,home:t1,rotate:t2,keyboard:t5,clipboard:t4,settings:t3,alert:t8,appSwitcher:t6},apps:{open:nt,close:nn,list:na,state:nr,push:ni,triggerEvent:ns},admin:{devices:nm,boot:nh,ensureSimulator:nf,install:nw,reinstall:nb,installFromSource:ng},recording:{record:nR,trace:nS},diagnostics:{logs:nF,network:nq,perf:nG}};function n0(e){return{capture:{screenshot:t=>nQ.capture.screenshot(e,t),diffScreenshot:t=>nQ.capture.diffScreenshot(e,t),snapshot:t=>nQ.capture.snapshot(e,t),diffSnapshot:t=>nQ.capture.diffSnapshot(e,t)},selectors:{find:t=>nQ.selectors.find(e,t),get:t=>nQ.selectors.get(e,t),getText:(t,n={})=>nQ.selectors.getText(e,{...n,target:t}),getAttrs:(t,n={})=>nQ.selectors.getAttrs(e,{...n,target:t}),is:t=>nQ.selectors.is(e,t),isVisible:(t,n={})=>nQ.selectors.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>nQ.selectors.isHidden(e,{...n,target:t}),wait:t=>nQ.selectors.wait(e,t),waitForText:(t,n={})=>nQ.selectors.waitForText(e,{...n,text:t})},interactions:{click:(t,n={})=>nQ.interactions.click(e,{...n,target:t}),press:(t,n={})=>nQ.interactions.press(e,{...n,target:t}),fill:(t,n,a={})=>nQ.interactions.fill(e,{...a,target:t,text:n}),typeText:(t,n={})=>nQ.interactions.typeText(e,{...n,text:t}),focus:(t,n={})=>nQ.interactions.focus(e,{...n,target:t}),longPress:(t,n={})=>nQ.interactions.longPress(e,{...n,target:t}),swipe:t=>nQ.interactions.swipe(e,t),scroll:t=>nQ.interactions.scroll(e,t),pinch:t=>nQ.interactions.pinch(e,t)},system:{back:t=>nQ.system.back(e,t),home:t=>nQ.system.home(e,t),rotate:t=>nQ.system.rotate(e,t),keyboard:t=>nQ.system.keyboard(e,t),clipboard:t=>nQ.system.clipboard(e,t),settings:t=>nQ.system.settings(e,t),alert:t=>nQ.system.alert(e,t),appSwitcher:t=>nQ.system.appSwitcher(e,t)},apps:{open:t=>nQ.apps.open(e,t),close:t=>nQ.apps.close(e,t),list:t=>nQ.apps.list(e,t),state:t=>nQ.apps.state(e,t),push:t=>nQ.apps.push(e,t),triggerEvent:t=>nQ.apps.triggerEvent(e,t)},admin:{devices:t=>nQ.admin.devices(e,t),boot:t=>nQ.admin.boot(e,t),ensureSimulator:t=>nQ.admin.ensureSimulator(e,t),install:t=>nQ.admin.install(e,t),reinstall:t=>nQ.admin.reinstall(e,t),installFromSource:t=>nQ.admin.installFromSource(e,t)},recording:{record:t=>nQ.recording.record(e,t),trace:t=>nQ.recording.trace(e,t)},observability:{logs:t=>nQ.diagnostics.logs(e,t),network:t=>nQ.diagnostics.network(e,t),perf:t=>nQ.diagnostics.perf(e,t)}}}export{n0 as bindCommands,eJ as buildMobileSnapshotPresentation,eE as buildSnapshotDisplayLines,nz as commandCatalog,nQ as commands,nK as createCommandRouter,_ as decodePng,eZ as deriveMobileSnapshotHiddenContentHints,ej as displayNodeLabel,e$ as formatSnapshotLine,eK as isScrollableType,tn as isSupportedPredicate,eH as normalizeSnapshotTree,D as readCommandMessage,tA as requireIntInRange,to as selector,tl as ref,P as successText,O as withSuccessText};

package/dist/src/9152.js

@@ -1 +1 @@
-let e=/(token|secret|password|authorization|cookie|api[_-]?key|access[_-]?key|private[_-]?key)/i,t=/(bearer\s+[a-z0-9._-]+|(?:api[_-]?key|token|secret|password)\s*[=:]\s*\S+)/i;function r(r){return function r(n,i,o){if(null==n)return n;if("string"==typeof n){var s=n,a=o;let r=s.trim();if(!r)return s;if(a&&e.test(a)||t.test(r))return"[REDACTED]";let i=function(e){try{let t=new URL(e);return t.search&&(t.search="?REDACTED"),(t.username||t.password)&&(t.username="REDACTED",t.password="REDACTED"),t.toString()}catch{return null}}(r);return i||(r.length>400?`${r.slice(0,200)}...<truncated>`:r)}if("object"!=typeof n)return n;if(i.has(n))return"[Circular]";if(i.add(n),Array.isArray(n))return n.map(e=>r(e,i));let c={};for(let[t,o]of Object.entries(n)){if(e.test(t)){c[t]="[REDACTED]";continue}c[t]=r(o,i,t)}return c}(r,new WeakSet)}class n extends Error{code;details;cause;constructor(e,t,r,n){super(t),this.code=e,this.details=r,this.cause=n}}function i(e){return e instanceof n?e:e instanceof Error?new n("UNKNOWN",e.message,void 0,e):new n("UNKNOWN","Unknown error",{err:e})}function o(e){return e instanceof n}function s(e,t={}){return a(e,t)}function a(e,t={}){let n=i(e),o=n.details?r(n.details):void 0,s=o&&"string"==typeof o.hint?o.hint:void 0,d=(o&&"string"==typeof o.diagnosticId?o.diagnosticId:void 0)??t.diagnosticId,l=(o&&"string"==typeof o.logPath?o.logPath:void 0)??t.logPath,u=s??c(n.code),f=function(e){if(!e)return;let t={...e};return delete t.hint,delete t.diagnosticId,delete t.logPath,Object.keys(t).length>0?t:void 0}(o),p=function(e,t,r){if("COMMAND_FAILED"!==e||r?.processExitError!==!0)return t;let n=function(e){let t=[/^an error was encountered processing the command/i,/^underlying error\b/i,/^simulator device failed to complete the requested operation/i];for(let r of e.split("\n")){let e=r.trim();if(e&&!t.some(t=>t.test(e)))return e.length>200?`${e.slice(0,200)}...`:e}return null}("string"==typeof r?.stderr?r.stderr:"");return n||t}(n.code,n.message,o);return{code:n.code,message:p,hint:u,diagnosticId:d,logPath:l,details:f}}function c(e){switch(e){case"INVALID_ARGS":return"Check command arguments and run --help for usage examples.";case"SESSION_NOT_FOUND":return"Run open first or pass an explicit device selector.";case"TOOL_MISSING":return"Install required platform tooling and ensure it is available in PATH.";case"DEVICE_NOT_FOUND":return"Verify the target device is booted/connected and selectors match.";case"APP_NOT_INSTALLED":return"Run apps to discover the exact installed package or bundle id, or install the app before open.";case"UNSUPPORTED_OPERATION":return"This command is not available for the selected platform/device.";case"NOT_IMPLEMENTED":return"This command is part of the planned API but is not implemented yet.";case"COMMAND_FAILED":default:return"Retry with --debug and inspect diagnostics log for details.";case"UNAUTHORIZED":return"Refresh daemon metadata and retry the command."}}export{n as AppError,i as asAppError,c as defaultHintForCode,o as isAgentDeviceError,s as normalizeAgentDeviceError,a as normalizeError,r as redactDiagnosticData};
+let e=/(token|secret|password|authorization|cookie|api[_-]?key|access[_-]?key|private[_-]?key)/i,t=/(bearer\s+[a-z0-9._-]+|(?:api[_-]?key|token|secret|password)\s*[=:]\s*\S+)/i;function r(r){return function r(n,i,o){if(null==n)return n;if("string"==typeof n){var s=n,a=o;let r=s.trim();if(!r)return s;if(a&&e.test(a)||t.test(r))return"[REDACTED]";let i=function(e){try{let t=new URL(e);return t.search&&(t.search="?REDACTED"),(t.username||t.password)&&(t.username="REDACTED",t.password="REDACTED"),t.toString()}catch{return null}}(r);return i||(r.length>400?`${r.slice(0,200)}...<truncated>`:r)}if("object"!=typeof n)return n;if(i.has(n))return"[Circular]";if(i.add(n),Array.isArray(n))return n.map(e=>r(e,i));let c={};for(let[t,o]of Object.entries(n)){if(e.test(t)){c[t]="[REDACTED]";continue}c[t]=r(o,i,t)}return c}(r,new WeakSet)}function n(e,t="COMMAND_FAILED"){return"string"==typeof e&&e.length>0?e:t}class i extends Error{code;details;cause;constructor(e,t,r,n){super(t),this.code=e,this.details=r,this.cause=n}}function o(e){return e instanceof i?e:e instanceof Error?new i("UNKNOWN",e.message,void 0,e):new i("UNKNOWN","Unknown error",{err:e})}function s(e){return e instanceof i}function a(e,t={}){return c(e,t)}function c(e,t={}){let n=o(e),i=n.details?r(n.details):void 0,s=i&&"string"==typeof i.hint?i.hint:void 0,a=(i&&"string"==typeof i.diagnosticId?i.diagnosticId:void 0)??t.diagnosticId,u=(i&&"string"==typeof i.logPath?i.logPath:void 0)??t.logPath,l=s??d(n.code),f=function(e){if(!e)return;let t={...e};return delete t.hint,delete t.diagnosticId,delete t.logPath,Object.keys(t).length>0?t:void 0}(i),p=function(e,t,r){if("COMMAND_FAILED"!==e||r?.processExitError!==!0)return t;let n=function(e){let t=[/^an error was encountered processing the command/i,/^underlying error\b/i,/^simulator device failed to complete the requested operation/i];for(let r of e.split("\n")){let e=r.trim();if(e&&!t.some(t=>t.test(e)))return e.length>200?`${e.slice(0,200)}...`:e}return null}("string"==typeof r?.stderr?r.stderr:"");return n||t}(n.code,n.message,i);return{code:n.code,message:p,hint:l,diagnosticId:a,logPath:u,details:f}}function d(e){switch(e){case"INVALID_ARGS":return"Check command arguments and run --help for usage examples.";case"SESSION_NOT_FOUND":return"Run open first or pass an explicit device selector.";case"TOOL_MISSING":return"Install required platform tooling and ensure it is available in PATH.";case"DEVICE_NOT_FOUND":return"Verify the target device is booted/connected and selectors match.";case"APP_NOT_INSTALLED":return"Run apps to discover the exact installed package or bundle id, or install the app before open.";case"UNSUPPORTED_OPERATION":return"This command is not available for the selected platform/device.";case"NOT_IMPLEMENTED":return"This command is part of the planned API but is not implemented yet.";case"COMMAND_FAILED":default:return"Retry with --debug and inspect diagnostics log for details.";case"UNAUTHORIZED":return"Refresh daemon metadata and retry the command."}}export{i as AppError,o as asAppError,d as defaultHintForCode,s as isAgentDeviceError,a as normalizeAgentDeviceError,c as normalizeError,r as redactDiagnosticData,n as toAppErrorCode};