agent-device 0.12.4 → 0.12.5

package/dist/src/commands/index.js

@@ -0,0 +1 @@
+import{promises as e}from"node:fs";import t from"node:path";import{PNG as n}from"pngjs";import{asAppError as r,AppError as a,normalizeAgentDeviceError as i}from"../152.js";import{whichCmd as s,runCmd as o}from"../818.js";import{centerOfRect as l,findNodeByRef as c,normalizeRef as u}from"../57.js";import{findSelectorChainMatch as d,extractNodeText as h,findNearestHittableAncestor as f,resolveSelectorChain as m,parseSelectorChain as p,findNodeByLabel as w,resolveRefLabel as g,isNodeVisible as b,formatSelectorFailure as x,normalizeType as y,isNodeEditable as v,isFillableType as M}from"../selectors.js";import{findBestMatchesByLocator as k}from"../556.js";function N(e){return e?{message:e}:{}}async function I(e,t,n){if("path"===t.kind&&!e.policy.allowLocalInputPaths)throw new a("INVALID_ARGS",`Local ${n.field??"input"} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(t,n)}catch(e){throw r(e)}}async function A(e,t,n){if(t?.kind==="path"&&!e.policy.allowLocalOutputPaths)throw new a("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 r(e)}}async function R(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw r(e)}}let S=async(e,t)=>{let n;if(!e.backend.captureScreenshot)throw new a("UNSUPPORTED_OPERATION","screenshot is not supported by this backend");let r=await A(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},r.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,surface:t.surface}),n=await r.publish()}catch(e){throw await r.cleanup?.(),e}return{path:r.path,...n?{artifacts:[n]}:{},...N(`Saved screenshot: ${r.path}`)}};function P(e,t){try{return n.sync.read(e)}catch(e){throw new a("COMMAND_FAILED",`Failed to decode ${t} as PNG`,{label:t,reason:e instanceof Error?e.message:String(e)})}}let $=[0,187,255,255];function _(e,t,n,r){if(t<0||t>=e.width||n<0||n>=e.height)return;let a=(n*e.width+t)*4;e.data[a]=r[0],e.data[a+1]=r[1],e.data[a+2]=r[2],e.data[a+3]=r[3]}function C(e,t,n){return Math.min(Math.max(e,t),n)}let O={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},D={leading:20,trailing:20,separator:10,unknown:0,background:-30};function L(e){return"background"!==e.likelyKind}function T(e,t){return e.width>=.25*t.width||e.height>=.06*t.height}function E(e,t){let n,r=0;for(let a of t){let t=U(e,a.rect);t<=r||(r=t,n=a)}return n}function X(e){let t=[];for(let n of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>{var t,r;return t=e.rect,U(t,r=n.rect)>0||Math.abs(B(t).y-B(r).y)<=.5*Math.max(t.height,r.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,r=-1/0,a=-1/0;for(let i of e)t=Math.min(t,i.x),n=Math.min(n,i.y),r=Math.max(r,i.x+i.width),a=Math.max(a,i.y+i.height);return{x:t,y:n,width:r-t,height:a-n}}([e.rect,n.rect])}return t}function F(e,t){let n,r=B(e);for(let e of t){var a,i;let t=Math.sqrt((a=r,i=B(e.rect),(a.x-i.x)**2+(a.y-i.y)**2));n&&t>=n.distance||(n={block:e,distance:t})}return n}function Y(e){let t=q(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function q(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function U(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}function B(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function G(e,t,n){return Math.min(Math.max(e,t),n)}async function V(e){if(await s("tesseract"))try{let[t,n]=await Promise.all([H(e.baselinePath),H(e.currentPath)]);if(0!==t.exitCode||0!==n.exitCode)return;let r=z(t.stdout,e.width,e.height),a=z(n.stdout,e.width,e.height),i=function(e,t){let n=new Set,r=[];for(let i of e){var a;let e=ee(i.text),s=function(e,t,n,r){let a=null,i=1/0;for(let l=0;l<n.length;l+=1){var s,o;if(r.has(l))continue;let c=n[l];if(ee(c.text)!==t)continue;let u=(s=J(e.normalizedRect),o=J(c.normalizedRect),(s.x-o.x)**2+(s.y-o.y)**2);u>=i||(a=l,i=u)}return a}(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},r=er(t.rect.width/e.rect.width),a=er(t.rect.height/e.rect.height),i=Math.abs(r-1)>=.08||Math.abs(a-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]);a=o,(Math.abs(a.delta.x)>=2||Math.abs(a.delta.y)>=2||Math.abs(a.delta.width)>=2||Math.abs(a.delta.height)>=2||a.possibleTextMetricMismatch)&&r.push(o)}return r.sort((e,t)=>K(t)-K(e)).slice(0,12)}(r,a),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-et(e.map(e=>e.delta.x))));e?e.push(n):t.push([n])}return t.filter(e=>e.length>=2).map(j).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>W(t)-W(e)).slice(0,4)}(i);if(0===r.length&&0===a.length)return;return{provider:"tesseract",baselineBlocks:r.length,currentBlocks:a.length,baselineBlocksRaw:r,currentBlocksRaw:a,matches:i,...s.length>0?{movementClusters:s}:{}}}catch{return}}function z(e,t,n){let[r,...a]=e.split(/\r?\n/);if(!r)return[];let i=new Map(r.split("	").map((e,t)=>[e,t])),s=[];for(let e of a){var o;if(!e.trim())continue;let t=e.split("	"),n=Q(t,i,"level"),r=Z(t,i,"text").trim(),a=Q(t,i,"conf");if(5!==n||(o=r,!/[\p{L}\p{N}]/u.test(o))||a<0)continue;let l=Q(t,i,"left"),c=Q(t,i,"top"),u=Q(t,i,"width"),d=Q(t,i,"height");u<=0||d<=0||s.push({key:[Z(t,i,"page_num"),Z(t,i,"block_num"),Z(t,i,"par_num"),Z(t,i,"line_num")].join(":"),text:r,confidence:a,rect:{x:l,y:c,width:u,height:d}})}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=[],r=[];for(let e of t){let t=r.at(-1);if(!t){r.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(r),r=[e];continue}r.push(e)}return r.length>0&&n.push(r),n})(e)).map(e=>(function(e,t,n){if(0===e.length)return null;let r=[...e].sort((e,t)=>e.rect.x-t.rect.x),a=function(e){let t=1/0,n=1/0,r=-1/0,a=-1/0;for(let i of e)t=Math.min(t,i.x),n=Math.min(n,i.y),r=Math.max(r,i.x+i.width),a=Math.max(a,i.y+i.height);return{x:t,y:n,width:r-t,height:a-n}}(r.map(e=>e.rect)),i=Math.round(100*et(r.map(e=>e.confidence)))/100;return{text:r.map(e=>e.text).join(" "),confidence:i,rect:a,normalizedRect:{x:en(a.x/t),y:en(a.y/n),width:en(a.width/t),height:en(a.height/n)}}})(e,t,n)).filter(e=>null!==e)}function H(e){return o("tesseract",[e,"stdout","-l","eng","tsv"],{allowFailure:!0,timeoutMs:1e4})}function K(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 j(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 W(e){return 2*Math.abs((e.xRange.min+e.xRange.max)/2)+Math.abs((e.yRange.min+e.yRange.max)/2)}function J(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function Z(e,t,n){let r=t.get(n);return void 0===r?"":e[r]??""}function Q(e,t,n){let r=Number(Z(e,t,n));return Number.isFinite(r)?r:0}function ee(e){return e.trim().replace(/\s+/g," ").toLowerCase()}function et(e){return e.reduce((e,t)=>e+t,0)/e.length}function en(e){return Math.round(100*e*100)/100}function er(e){return Math.round(1e3*e)/1e3}function ea(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function ei(e){return .2126*e.r+.7152*e.g+.0722*e.b}function es(e){return`#${eo(e.r)}${eo(e.g)}${eo(e.b)}`}function eo(e){return e.toString(16).padStart(2,"0")}function el(e){return Math.round(100*e*100)/100}let ec=255*Math.sqrt(3);async function eu(r,a,i={}){let s,o,l,c;await ed(r,"Baseline image not found"),await ed(a,"Current screenshot not found");let u=i.outputPath,[d,h]=await Promise.all([e.readFile(r),e.readFile(a)]),f=P(d,"baseline screenshot"),m=P(h,"current screenshot");eh(f.width,f.height,"baseline screenshot",i.maxPixels),eh(m.width,m.height,"current screenshot",i.maxPixels);let p=i.threshold??.1;if(f.width!==m.width||f.height!==m.height){let e=f.width*f.height;return await ef(i.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:f.width,height:f.height},actual:{width:m.width,height:m.height}}}}let w=f.width*f.height,g=p*ec,b=new n({width:f.width,height:f.height}),x=new Uint8Array(w),y=0;for(let e=0,t=0;e<f.data.length;e+=4,t+=1){if(Math.sqrt((f.data[e]-m.data[e])**2+(f.data[e+1]-m.data[e+1])**2+(f.data[e+2]-m.data[e+2])**2)>g){y+=1,x[t]=1;let n=em(m,e);b.data[e]=ep(n,220,.78),b.data[e+1]=ep(n,0,.78),b.data[e+2]=ep(n,0,.78),b.data[e+3]=255;continue}let n=em(m,e);b.data[e]=n,b.data[e+1]=n,b.data[e+2]=n,b.data[e+3]=255}let v=y>0?(k=(s=function(e){let{diffMask:t,baseline:n,current:r}=e,{width:a,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,u=0;o[0]=e,u+=1,s[e]=1;let d=e%a,h=Math.floor(e/a),f={minX:d,minY:h,maxX:d,maxY:h,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0};for(;c<u;){let e=o[c];c+=1,function(e,t,n,r,a){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+=r.data[o],e.baselineGreen+=r.data[o+1],e.baselineBlue+=r.data[o+2],e.currentRed+=a.data[o],e.currentGreen+=a.data[o+1],e.currentBlue+=a.data[o+2]}(f,e,a,n,r);let l=e%a,d=Math.floor(e/a);for(let e=-1;e<=1;e+=1){let n=d+e;if(!(n<0)&&!(n>=i))for(let r=-1;r<=1;r+=1){if(0===r&&0===e)continue;let i=l+r;if(i<0||i>=a)continue;let c=n*a+i;1===t[c]&&1!==s[c]&&(s[c]=1,o[u]=c,u+=1)}}}l.push(f)}return l}(M={diffMask:x,baseline:f,current:m,totalPixels:w,differentPixels:y,maxRegions:i.maxRegions})).length<=2e3?function(e){let t=[];for(let a of e.sort((e,t)=>{let n=e.minY-t.minY;return 0!==n?n:e.minX-t.minX})){var n,r;let e=t.find(e=>{var t,n,r;return t=e,n=a,r=12,t.minX-r<=n.maxX&&n.minX-r<=t.maxX&&t.minY-r<=n.maxY&&n.minY-r<=t.maxY});if(!e){t.push({...a});continue}n=e,r=a,n.minX=Math.min(n.minX,r.minX),n.minY=Math.min(n.minY,r.minY),n.maxX=Math.max(n.maxX,r.maxX),n.maxY=Math.max(n.maxY,r.maxY),n.differentPixels+=r.differentPixels,n.baselineRed+=r.baselineRed,n.baselineGreen+=r.baselineGreen,n.baselineBlue+=r.baselineBlue,n.currentRed+=r.currentRed,n.currentGreen+=r.currentGreen,n.currentBlue+=r.currentBlue}return t}(s):s,k.flatMap(e=>{var t,n,r;let a;return(t=e,n=M.baseline.width,r=M.baseline.height,a=t.maxX-t.minX+1,t.maxY-t.minY+1>=Math.max(48,Math.round(.07*r))&&a>=.35*n)?function(e,t,n){var r;let a=function(e,t){let n=[],r=null;for(let a=0;a<e.length;a+=1){if(e[a]<=t){r??=a;continue}null!==r&&(a-r>=6&&n.push([r,a-1]),r=null)}return null!==r&&e.length-r>=6&&n.push([r,e.length-1]),n}((r=function(e,t,n){let r=[];for(let a=e.minY;a<=e.maxY;a+=1){let i=0;for(let r=e.minX;r<=e.maxX;r+=1)1===t[a*n+r]&&(i+=1);r.push(i)}return r}(e,t.diffMask,t.baseline.width)).map((e,t)=>{let n=0,a=0,i=Math.max(0,t-3),s=Math.min(r.length-1,t+3);for(let e=i;e<=s;e+=1)n+=r[e],a+=1;return Math.round(n/a)}),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),i=function(e,t,n){let r=[],a=e.minY;for(let[i,s]of t){let t=e.minY+Math.round((i+s)/2);t-a+1<n||e.maxY-t<n||(r.push([a,t]),a=t+1)}return r.push([a,e.maxY]),r}(e,a,n);if(i.length<=1)return[e];let s=i.map(([n,r])=>(function(e,t,n,r){let a=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*r.baseline.width+t;1===r.diffMask[e]&&function(e,t,n,r,a,i){let s=4*t;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,r),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,r),e.differentPixels+=1,e.baselineRed+=a.data[s],e.baselineGreen+=a.data[s+1],e.baselineBlue+=a.data[s+2],e.currentRed+=i.data[s],e.currentGreen+=i.data[s+1],e.currentBlue+=i.data[s+2]}(a??={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,r.baseline,r.current)}return a})(e,n,r,t)).filter(e=>null!==e);return s.length>1?s:[e]}(e,M,Math.max(24,Math.round(.03*M.baseline.height))):[e]})).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(0!==n)return n;let r=e.minY-t.minY;return 0!==r?r:e.minX-t.minX}).slice(0,Math.max(0,M.maxRegions??8)).map((e,t)=>{var n,r,a,i,s,o,l,c,u,d,h;let f,m,p,w,g,b,x,y,v,k,N,I,A,R,S,P,$;return n=e,r=t+1,a={width:M.baseline.width,height:M.baseline.height,totalPixels:M.totalPixels,differentPixels:M.differentPixels},b={x:n.minX,y:n.minY,width:n.maxX-n.minX+1,height:n.maxY-n.minY+1},x={x:Math.round(n.minX+b.width/2),y:Math.round(n.minY+b.height/2)},y=ea(n.baselineRed,n.baselineGreen,n.baselineBlue,n.differentPixels),v=ea(n.currentRed,n.currentGreen,n.currentBlue,n.differentPixels),k=b.width*b.height,N=el(n.differentPixels/k),I=Math.round(ei(y)),A=Math.round(ei(v)),R=(i=b,s=a.width,o=a.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=(f=k/a.totalPixels)>=.04?"large":f>=.01?"medium":"small",P=(l=y,c=v,m=ei(l),Math.abs(p=ei(c)-m)>=12?p>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"),$=(u=x,d=a.width,h=a.height,w=u.x<d/3?"left":u.x>2*d/3?"right":"center",g=u.y<h/3?"top":u.y>2*h/3?"bottom":"middle","center"===w&&"middle"===g?"center":`${g}-${w}`),{index:r,rect:b,normalizedRect:{x:el(b.x/a.width),y:el(b.y/a.height),width:el(b.width/a.width),height:el(b.height/a.height)},differentPixels:n.differentPixels,shareOfDiffPercentage:el(n.differentPixels/a.differentPixels),densityPercentage:N,shape:R,size:S,location:$,averageBaselineColorHex:es(y),averageCurrentColorHex:es(v),baselineLuminance:I,currentLuminance:A,dominantChange:P}}):[];if(y>0&&u){var M,k,N;for(let e of v)e.rect.width<4||e.rect.height<4||function(e,t){let n=C(t.x,0,e.width-1),r=C(t.y,0,e.height-1),a=C(t.x+t.width-1,0,e.width-1),i=C(t.y+t.height-1,0,e.height-1);for(let t=0;t<2;t+=1){for(let s=n;s<=a;s+=1)_(e,s,r+t,$),_(e,s,i-t,$);for(let s=r;s<=i;s+=1)_(e,n+t,s,$),_(e,a-t,s,$)}}(b,e.rect);await e.mkdir(t.dirname(u),{recursive:!0}),await e.writeFile(u,n.sync.write(b))}else await ef(i.outputPath);let I=y>0?await V({baselinePath:r,currentPath:a,width:f.width,height:f.height}):void 0,A=I&&(I.matches.length>0||(I.movementClusters?.length??0)>0)?{provider:I.provider,baselineBlocks:I.baselineBlocks,currentBlocks:I.currentBlocks,matches:I.matches,...I.movementClusters?{movementClusters:I.movementClusters}:{}}:void 0,R=y>0&&I?(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,r,a;return t=e,r=n,a=10,t.minX-a<=r.maxX&&r.minX-a<=t.maxX&&t.minY-a<=r.maxY&&r.minY-a<=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 r=new Uint8Array(e.length),a=new Int32Array(e.length),i=[];for(let s=0;s<e.length;s+=1){if(1!==e[s]||1===r[s])continue;let o=0,l=0;a[0]=s,l+=1,r[s]=1;let c=s%t,u=Math.floor(s/t),d={minX:c,minY:u,maxX:c,maxY:u,differentPixels:0};for(;o<l;){let i=a[o];o+=1;let s=i%t,c=Math.floor(i/t);d.minX=Math.min(d.minX,s),d.minY=Math.min(d.minY,c),d.maxX=Math.max(d.maxX,s),d.maxY=Math.max(d.maxY,c),d.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 u=o*t+c;1===e[u]&&1!==r[u]&&(r[u]=1,a[l]=u,l+=1)}}}i.push(d)}return i}(function(e,t,n,r){let a=new Uint8Array(e);if(!r)return a;for(let e of[...r.baselineBlocksRaw,...r.currentBlocksRaw]){var i;!function(e,t,n,r){let a=G(Math.floor(r.x),0,t-1),i=G(Math.floor(r.y),0,n-1),s=G(Math.ceil(r.x+r.width),0,t),o=G(Math.ceil(r.y+r.height),0,n);for(let n=i;n<o;n+=1)for(let r=a;r<s;r+=1)e[n*t+r]=0}(a,t,n,{x:(i=e.rect).x-8,y:i.y-8,width:i.width+16,height:i.height+16})}return a}((N={diffMask:x,width:f.width,height:f.height,regions:v,ocr:I}).diffMask,N.width,N.height,N.ocr),N.width,N.height)),l=X(N.ocr?.currentBlocksRaw??[]),c=X(N.ocr?.baselineBlocksRaw??[]),o.filter(Y).map(e=>{var t,n,r,a,i,s,o,u,d,h,f;let m,p,w,g,b,x,y,v,M,k;return t=e,n=N,r=l,a=c,g=function(e,t){let n,r=0;for(let a of t){let t=function(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),a=Math.min(e.x+e.width,t.x+t.width),i=Math.min(e.y+e.height,t.y+t.height);return a<=n||i<=r?0:(a-n)*(i-r)}(e,a.rect);t<=r||(r=t,n=a)}return n?.index}(w=q(t),n.regions),b=function(e,t,n){let r=E(e,t);if(r)return F(e,r.blocks);let a=E(e,n);return a?F(e,a.blocks):void 0}(w,r,a),x=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 r=e.x+e.width/2,a=t.x+t.width/2;return r<a-t.width/2?"leading":r>a+t.width/2?"trailing":e.width>=.35*n?"background":"unknown"}(w,b?.block.rect,n.width),y=(i=w,s=x,o=t.differentPixels,u=n,m=i.width/i.height,p=o/(i.width*i.height),"separator"===s?"separator":"background"===s?"background":"trailing"===s&&m>=1.5&&m<=3.8&&p>=.35?"toggle":"trailing"===s&&i.width<=.06*u.width&&i.height<=.04*u.height?"chevron":"leading"===s&&m>=.55&&m<=1.8?"icon":T(i,u)?"background":"visual"),v={...g?{regionIndex:g}:{},slot:x,likelyKind:y,rect:w},{...g?{regionIndex:g}:{},slot:x,likelyKind:y,rect:w,...b?{nearestText:b.block.text.trim().replace(/^[^\p{L}\p{N}]+/u,"").replace(/^\p{L}\s+/u,"")}:{},score:(d=v,h=t.differentPixels,f=n,M=T(d.rect,f)?-35:0,k=20*!!d.regionIndex,O[d.likelyKind]+D[d.slot]+k+M+Math.min(20,h/200))}}).filter(e=>e.rect.y>=.08*N.height).filter(L).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,N.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(y/w*1e4)/100:0;return{...y>0&&u?{diffPath:u}:{},...v.length>0?{regions:v}:{},...A?{ocr:A}:{},...R.length>0?{nonTextDeltas:R}:{},totalPixels:w,differentPixels:y,mismatchPercentage:S,match:0===y}}async function ed(t,n){try{await e.access(t)}catch{throw new a("INVALID_ARGS",`${n}: ${t}`)}}function eh(e,t,n,r){if(null==r||r<=0)return;let i=e*t;if(!(i<=r))throw new a("INVALID_ARGS",`${n} is ${i} pixels, which exceeds the configured maxImagePixels limit of ${r}`)}async function ef(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 em(e,t){return ep(Math.round(.299*e.data[t]+.587*e.data[t+1]+.114*e.data[t+2]),255,.72)}function ep(e,t,n){return Math.round(e*(1-n)+t*n)}function ew(e){return e.width*e.height}function eg(e){return Math.round(100*e*100)/100}let eb=async(e,t)=>{let n,r,i;if(!t.baseline)throw new a("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 a("INVALID_ARGS","--threshold must be a number between 0 and 1");return t}(t.threshold),o=t.current??{kind:"live"};if(t.overlayRefs&&!eI(o))throw new a("INVALID_ARGS","diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs");let l=await I(e,t.baseline,{usage:"diff screenshot baseline",field:"baseline"}),c=[];try{let a;a=eI(o)?(r=await ex(e,t)).path:(n=await I(e,o,{usage:"diff screenshot current",field:"current"})).path,i=t.out?await A(e,t.out,{field:"diffPath",ext:".png"}):void 0;let u=await eu(l.path,a,{threshold:s,outputPath:i?.path,maxPixels:e.policy.maxImagePixels});eI(o)&&(u=await ey(e,t,i?.path,u,c));let d=u.diffPath?await i?.publish():void 0;return d&&c.push(d),u.diffPath||await i?.cleanup?.(),{...u,...c.length>0?{artifacts:c}:{}}}catch(e){throw await i?.cleanup?.(),e}finally{await l.cleanup?.(),await n?.cleanup?.(),await r?.cleanup?.()}};async function ex(e,t){let n=await R(e,{prefix:"agent-device-diff-current",ext:".png"});try{await ev(e,t,n.path,eM(t))}catch(e){throw await n.cleanup(),e}return n}async function ey(e,t,n,r,a){var i,s,o,l;if(!t.overlayRefs)return r;if(r.match||r.dimensionMismatch)return n&&await eN(n),r;let c=(i=t,s=n,i.currentOverlayOut?i.currentOverlayOut:i.out?.kind==="path"?{kind:"path",path:ek(s??i.out.path)}:i.out?.kind==="downloadableArtifact"?{kind:"downloadableArtifact",...i.out.clientPath?{clientPath:ek(i.out.clientPath)}:{},...i.out.fileName?{fileName:ek(i.out.fileName)}:{}}:void 0),u=await A(e,c,{field:"currentOverlayPath",ext:".png"});try{let n=await ev(e,t,u.path,{overlayRefs:!0,...eM(t)}),i=await u.publish();return i&&a.push(i),{...r,currentOverlayPath:n.path??u.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...r.regions&&n.overlayRefs?{regions:(o=r.regions,l=n.overlayRefs,o.map(e=>{var t,n;let r,a=(t=e,n=l,r=ew(t.rect),n.map(e=>{var n,a;let i,s,o,l,c=e.overlayRect,u=(n=t.rect,a=c,i=Math.max(n.x,a.x),s=Math.max(n.y,a.y),o=Math.min(n.x+n.width,a.x+a.width),l=Math.min(n.y+n.height,a.y+a.height),o<=i||l<=s?0:(o-i)*(l-s));return u<=0?null:{ref:e.ref,...e.label?{label:e.label}:{},rect:c,overlayCoveragePercentage:eg(u/ew(c)),regionCoveragePercentage:eg(u/r)}}).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 a.length>0?{...e,currentOverlayMatches:a}:e}))}:{}}}catch(e){throw await u.cleanup?.(),e}}async function ev(e,t,n,r={}){if(!e.backend.captureScreenshot)throw new a("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,r)??{}}function eM(e){return e.surface?{surface:e.surface}:{}}function ek(e){let n=t.extname(e),r=n?e.slice(0,-n.length):e;return`${r}.current-overlay${n||".png"}`}async function eN(t){try{await e.unlink(ek(t))}catch(e){var n;if(!("object"==typeof(n=e)&&null!==n&&"code"in n&&"ENOENT"===n.code))throw e}}function eI(e){return"live"===e.kind}function eA(e){var t;let n,r=eR(e.label),a=eR(e.value),i=eR(e.identifier),s=(t=i)&&!/^[\w.]+:id\/[\w.-]+$/i.test(t)&&!/^_?NS:\d+$/i.test(t)?i:"";return(n=eS(e.type??"")).includes("textfield")||n.includes("securetextfield")||n.includes("searchfield")||n.includes("edittext")||n.includes("textview")||n.includes("textarea")?a||r||s:r||a||s}function eR(e){return"string"==typeof e?e.trim():""}function eS(e){let t=e.trim().replace(/XCUIElementType/gi,"").replace(/^AX/,"").toLowerCase(),n=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==n&&(t=t.slice(n+1)),t}function eP(e,t,n,r,a={}){var i,s,o,l,c;let u,d,h=r??e_(e.type??"Element"),f=(u=eA(e),{text:u,isLargeSurface:d=function(e,t){if("text-view"===t||"text-field"===t||"search"===t)return!0;let n=eS(e.type??""),r=`${e.role??""} ${e.subrole??""}`.toLowerCase();return n.includes("textview")||n.includes("textarea")||n.includes("textfield")||n.includes("securetextfield")||n.includes("searchfield")||n.includes("edittext")||r.includes("text area")||r.includes("text field")}(e,h),shouldSummarize:d&&!!(i=u)&&(i.length>80||/[\r\n]/.test(i))}),m=(s=e,o=h,l=a,c=f,l.summarizeTextSurfaces&&c.shouldSummarize&&function(e,t,n){let r=eR(e.label);if(r&&r!==n)return r;let a=eR(e.identifier);if(a&&!eO(a)&&a!==n)return a;switch(t){case"text":case"text-view":return"Text view";case"text-field":return"Text field";case"search":return"Search field";default:return""}}(s,o,c.text)||e$(s,o)),p="  ".repeat(t),w=e.ref?`@${e.ref}`:"",g=(function(e,t,n,r){let a,i=[];if(!1===e.enabled&&i.push("disabled"),!n.summarizeTextSurfaces||(!0===e.selected&&i.push("selected"),eC(t)&&i.push("editable"),function(e,t){if("scroll-area"===t)return!0;let n=(e.type??"").toLowerCase(),r=`${e.role??""} ${e.subrole??""}`.toLowerCase();return n.includes("scroll")||r.includes("scroll")}(e,t)&&i.push("scrollable"),!r.shouldSummarize))return i;return i.push(`preview:"${((a=r.text.replace(/\s+/g," ").trim()).length<=48?a:`${a.slice(0,45)}...`).replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`),i.push("truncated"),[...new Set(i)]})(e,h,a,f).map(e=>` [${e}]`).join(""),b=m?` "${m}"`:"";return n?`${p}${w} [${h}]${g}`.trimEnd():`${p}${w} [${h}]${b}${g}`.trimEnd()}function e$(e,t){var n,r;let a,i=e.label?.trim();if(i&&(n=t,r=i,("scroll-area"===n||"list"===n||"collection"===n||"table"===n)&&(a=r.trim().toLowerCase())&&/^(vertical|horizontal)\s+scroll\s+bar(?:,?\s*\d+\s+pages?)?$/.test(a)))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||eO(o)&&("group"===t||"image"===t||"list"===t||"collection"===t)?"":o}function e_(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 eO(e){return/^[\w.]+:id\/[\w.-]+$/i.test(e)}function eD(e,t){let n=e_(e.type??"Element"),r=e$(e,n),a=!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,r,a,i,s].join("|")}function eL(e,t){return t.flatten?e.map(e=>({text:eP(e,0,!1),comparable:eD(e,0)})):(function(e,t={}){let n=[],r=[];for(let a of e){let e=a.depth??0,i=a.label?.trim()||a.value?.trim()||a.identifier?.trim()||"",s=e_(a.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),r.push({node:a,depth:o,type:s,text:eP(a,o,!1,s,t)})}return r})(e).map(e=>({text:e.text,comparable:eD(e.node,e.depth)}))}function eT(e,t){return e.get(t)??0}function eE(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 r of e){let e=r.width*r.height;e>n&&(t=r,n=e)}return t}function eF(e,t,n,r){return Math.max(e,n)<=Math.min(t,r)}function eY(e){return new Map(e.map(e=>[e.index,e]))}function eq(e){return e.label?.trim()||e.value?.trim()||e.identifier?.trim()||""}function eU(e){var t;let n;return t=e.type,!!((n=`${t??""}`.toLowerCase()).includes("scroll")||n.includes("recyclerview")||n.includes("listview")||n.includes("gridview")||n.includes("collectionview"))||"table"===n||`${e.role??""} ${e.subrole??""}`.toLowerCase().includes("scroll")}function eB(e,t,n=eY(t)){var r;if(!e.rect)return!0;let a=eG(e,t,n);return!a||(r=e.rect,eF(r.x,r.x+r.width,a.x,a.x+a.width)&&eF(r.y,r.y+r.height,a.y,a.y+a.height))}function eG(e,t,n=eY(t)){let r=function(e,t){let n="number"==typeof e.parentIndex?t.get(e.parentIndex):void 0,r=new Set;for(;n&&!r.has(n.index);){if(r.add(n.index),n.rect&&eU(n))return n.rect;n="number"==typeof n.parentIndex?t.get(n.parentIndex):void 0}return null}(e,n);return r||function(e,t){let n=l(t),r=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)}),a=r.filter(e=>{let t=(e.type??"").toLowerCase();return t.includes("application")||t.includes("window")}),i=eX(a.map(e=>e.rect).filter(e=>eE(e,n.x,n.y)));if(i)return i;let s=eX(a.map(e=>e.rect));if(s)return s;let o=eX(r.map(e=>e.rect).filter(e=>eE(e,n.x,n.y)));return o||null}(t,e.rect??{x:0,y:0,width:0,height:0})}function eV(e,t){return e.y+e.height<=t.y?"above":e.y>=t.y+t.height?"below":null}function ez(e,t,n){let r="number"==typeof e.parentIndex?n.get(e.parentIndex):void 0,a=new Set;for(;r&&!a.has(r.index);){if(a.add(r.index),t.has(r.index)&&eU(r))return r;r="number"==typeof r.parentIndex?n.get(r.parentIndex):void 0}return null}let eH=async(e,t)=>{var n;let r,a,i=await ej(e,t);return await e.sessions.set(eW(t.session,i)),{nodes:i.snapshot.nodes,truncated:i.snapshot.truncated??!1,visibility:function(e){var t;let{nodes:n,backend:r,snapshotRaw:a}=e;if(a||"macos-helper"===(t=r)||"linux-atspi"===t)return{partial:!1,visibleNodeCount:n.length,totalNodeCount:n.length,reasons:[]};let i=function(e){if(0===e.length)return{nodes:e,hiddenCount:0,summaryLines:[]};let t=eY(e),n=new Set,r=[];for(let a of e){if(eB(a,e,t)){!function(e,t,n){let r=e,a=new Set;for(;r&&!a.has(r.index);)a.add(r.index),t.add(r.index),r="number"==typeof r.parentIndex?n.get(r.parentIndex):void 0}(a,n,t);continue}r.push(a)}let a=function(e,t,n,r){let a=new Map,i=new Set;for(let e of t){if(!e.rect)continue;let t=ez(e,n,r);if(!t?.rect)continue;let s=eV(e.rect,t.rect);if(!s)continue;let o=a.get(t.index)??new Set;o.add(s),a.set(t.index,o),i.add(e.index)}return function(e,t,n,r){for(let a 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}(a);if(!e||0===e.size)continue;let i=ez(a,t,n);if(!i)continue;let s=r.get(i.index)??new Set;for(let t of e)s.add(t);r.set(i.index,s)}}(e,n,r,a),{directionsByContainer:a,coveredNodeIndexes:i}}(e,r,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 r=!!(!0===e.hiddenContentAbove||n.has("above"))||void 0,a=!!(!0===e.hiddenContentBelow||n.has("below"))||void 0;return{...e,hiddenContentAbove:r,hiddenContentBelow:a}})(e,a.directionsByContainer)),hiddenCount:0===n.size?0:e.length-i.length,summaryLines:function(e,t,n){let r=new Map;for(let a of e){let e=function(e,t,n){if(!e.rect)return null;let r=eG(e,t,n);return r?eV(e.rect,r):null}(a,t,n);if(!e)continue;let i=r.get(e)??[];i.push(a),r.set(e,i)}return["above","below"].flatMap(e=>{let t=r.get(e);if(!t||0===t.length)return[];let n=(function(e){let t=new Set,n=[];for(let r of e){let e=eq(r);!e||t.has(e)||(t.add(e),n.push(e))}return n})(t).slice(0,3).map(e=>`"${e}"`),a=1===t.length?"interactive item":"interactive items",i=n.length>0?`: ${n.join(", ")}`:"";return[`[off-screen ${e}] ${t.length} ${a}${i}`]})}(r.filter(e=>!a.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")||!!eq(e)}(e)),e,t)}}(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}:{},...(r=(n=i).result.appName??n.session?.appName,a=n.result.appBundleId??n.session?.appBundleId,{...r||a?{appName:r??a}:{},...a?{appBundleId:a}:{}})}},eK=async(e,t)=>{let n=await ej(e,t),r=!0===t.interactiveOnly,a=n.session?.snapshot,i=eW(t.session,n);if(!a){let t=function(e,t={}){return eL(e,t).length}(n.snapshot.nodes,{flatten:r});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 r=function(e,t){let n=e.length,r=t.length,a=n+r,i=new Map,s=[];i.set(1,0);for(let o=0;o<=a;o+=1){s.push(new Map(i));for(let a=-o;a<=o;a+=2){let l=a===-o||a!==o&&eT(i,a-1)<eT(i,a+1)?eT(i,a+1):eT(i,a-1)+1,c=l-a;for(;l<n&&c<r&&e[l].comparable===t[c].comparable;)l+=1,c+=1;if(i.set(a,l),l>=n&&c>=r)return function(e,t,n,r,a){let i=[],s=r,o=a;for(let r=e.length-1;r>=0;r-=1){let a=e[r],l=s-o,c=l===-r||l!==r&&eT(a,l-1)<eT(a,l+1)?l+1:l-1,u=eT(a,c),d=u-c;for(;s>u&&o>d;)i.push({kind:"unchanged",text:n[o-1].text}),s-=1,o-=1;if(0===r)break;s===u?(i.push({kind:"added",text:n[d].text}),o=d):(i.push({kind:"removed",text:t[u].text}),s=u)}return i.reverse(),i}(s,e,t,n,r)}}return[]}(eL(e,n),eL(t,n)),a={additions:0,removals:0,unchanged:0};for(let e of r)"added"===e.kind&&(a.additions+=1),"removed"===e.kind&&(a.removals+=1),"unchanged"===e.kind&&(a.unchanged+=1);return{summary:a,lines:r}}(a.nodes,n.snapshot.nodes,{flatten:r});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 ej(e,t){var n,r,i,s,o;let l,c,u,d,h,f;if(!e.backend.captureSnapshot)throw new a("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let m=t.session??"default",p=await e.sessions.get(m),w=await e.backend.captureSnapshot({session:m,requestId:t.requestId,appId:p?.appId,appBundleId:p?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,compact:t.compact,depth:t.depth,scope:t.scope,raw:t.raw}),g=(n=w,r=e,n.snapshot?n.snapshot:{nodes:n.nodes??[],truncated:n.truncated,backend:n.backend,createdAt:eJ(r)}),b=eJ(e);return{snapshot:g,result:w,session:p,warnings:(l=[...(i={result:w,snapshot:g,options:t,session:p,capturedAt:g.createdAt??b,runtimeNow:b}).result.warnings??[]],c=!0===i.options.interactiveOnly,u=i.result.analysis,"android"===i.snapshot.backend&&c&&0===i.snapshot.nodes.length&&u&&(u.rawNodeCount??0)>=12&&(l.push(`Interactive snapshot is empty after filtering ${u.rawNodeCount} raw Android nodes. Likely causes: depth too low, transient route change, or collector filtering.`),"number"==typeof i.options.depth&&"number"==typeof u.maxDepth&&u.maxDepth>=i.options.depth+2&&l.push(`Interactive output is empty at depth ${i.options.depth}; retry without -d.`)),h=!!(d=i.session?.snapshot)&&[i.capturedAt,i.runtimeNow].some(e=>{let t=e-d.createdAt;return t>=0&&t<=2e3}),!i.result.freshness&&d&&h&&(s=d.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."),f=i.result.freshness,f?.staleAfterRetries&&"android"===i.snapshot.backend&&("stuck-route"===f.reason?l.push(`Recent ${f.action} was followed by a nearly identical snapshot after ${f.retryCount} automatic retr${1===f.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"===f.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 eW(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 eJ(e){return e.clock?.now()??Date.now()}function eZ(e,t,n={}){let r=[],a=y(e.type??""),i=e0(e.identifier),s=e0(e.label),o=e0(e.value),l=e0(h(e)),c="fill"===n.action;i&&r.push(`id=${eQ(i)}`),a&&s&&r.push(c?`role=${eQ(a)} label=${eQ(s)} editable=true`:`role=${eQ(a)} label=${eQ(s)}`),s&&r.push(c?`label=${eQ(s)} editable=true`:`label=${eQ(s)}`),o&&r.push(c?`value=${eQ(o)} editable=true`:`value=${eQ(o)}`),l&&l!==s&&l!==o&&r.push(c?`text=${eQ(l)} editable=true`:`text=${eQ(l)}`),a&&c&&!r.some(e=>e.includes("editable=true"))&&r.push(`role=${eQ(a)} editable=true`);let u=Array.from(new Set(r));return 0===u.length&&a&&u.push(c?`role=${eQ(a)} editable=true`:`role=${eQ(a)}`),0===u.length&&b(e)&&u.push("visible=true"),u}function eQ(e){return JSON.stringify(e)}function e0(e){if(!e)return null;let t=e.trim();return t||null}function e1(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)}function e2(e){return"text"===e||"label"===e||"any"===e}function e5(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function e3(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))}async function e8(e,t){let n=t??"default",r=await e.sessions.get(n);if(!r)throw new a("SESSION_NOT_FOUND","No active session. Run open first.");if(!r.snapshot)throw new a("INVALID_ARGS","No snapshot in session. Run snapshot first.");return{sessionName:n,session:r,snapshot:r.snapshot}}async function e6(e,t,n={updateSession:!0}){if(!e.backend.captureSnapshot)throw new a("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let r=t.session??"default",i=await e.sessions.get(r),s=await e.backend.captureSnapshot(e5(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:e3(e)};return n.updateSession&&i&&await e.sessions.set({...i,snapshot:o}),{sessionName:r,session:i,snapshot:o}}async function e7(e,t,n){if(e.backend.readText){let r=await e.backend.readText(e5(e,{session:t.sessionName}),n);if(r.text.trim())return r.text}return eA(n)}function e9(e){return{kind:"selector",selector:e}}function te(e,t={}){return{kind:"ref",ref:e,...t.fallbackLabel?{fallbackLabel:t.fallbackLabel}:{}}}let tt=async(e,t)=>{let n=t.locator??"any";if(!t.query)throw new a("INVALID_ARGS","find requires a value");if("wait"===t.action)return await tu(e,t,n);let r=await e6(e,t,{updateSession:!0,scope:e2(n)?t.query:void 0}),i=k(r.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0];if(!i)throw new a("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 e7(e,r,i),node:i}},tn=async(e,t)=>{if("ref"===t.target.kind){let n=await e8(e,t.session),r=function(e,t,n){let r=u(t);if(!r)throw new a("INVALID_ARGS",n.invalidRefMessage);let i=c(e,r)??(n.fallbackLabel.length>0?w(e,n.fallbackLabel):null);if(!i)throw new a("COMMAND_FAILED",n.notFoundMessage);return{ref:r,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=eZ(r.node,e.backend.platform,{action:"get"}),s={kind:"ref",ref:`@${r.ref}`};return"attrs"===t.property?{kind:"attrs",target:s,node:r.node,selectorChain:i}:{kind:"text",target:s,text:await e7(e,n,r.node),node:r.node,selectorChain:i}}let n=await tm(e,t,t.session??"default",{selector:t.target.selector,disambiguateAmbiguous:"text"===t.property}),r=eZ(n.node,e.backend.platform,{action:"get"});if("attrs"===t.property)return{kind:"attrs",target:{kind:"selector",selector:n.selector},node:n.node,selectorChain:r};let i=await e7(e,n.capture,n.node);return{kind:"text",target:{kind:"selector",selector:n.selector},text:i,node:n.node,selectorChain:r}},tr=async(e,t)=>{let n=await tn(e,{...t,property:"text",target:t.target});if("text"!==n.kind)throw new a("COMMAND_FAILED","getText returned non-text result");return n},ta=async(e,t)=>{let n=await tn(e,{...t,property:"attrs",target:t.target});if("attrs"!==n.kind)throw new a("COMMAND_FAILED","getAttrs returned non-attrs result");return n},ti=async(e,t)=>{if(!["visible","hidden","exists","editable","selected","text"].includes(t.predicate))throw new a("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text");if("text"===t.predicate&&!t.expectedText)throw new a("INVALID_ARGS","is text requires expected text value");let n=await e6(e,t,{updateSession:!0}),r=p(t.selector);if("exists"===t.predicate){let i=d(n.snapshot.nodes,r,{platform:e.backend.platform});if(!i)throw new a("COMMAND_FAILED",x(r,[],{unique:!1}));return{predicate:t.predicate,pass:!0,selector:i.selector.raw,matches:i.matches,selectorChain:r.selectors.map(e=>e.raw)}}let i=m(n.snapshot.nodes,r,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:!1});if(!i)throw new a("COMMAND_FAILED",x(r,[],{unique:!0}));let s=function(e){let{predicate:t,node:n,nodes:r,expectedText:a,platform:i}=e,s=h(n),o=v(n,i),l=!0===n.selected,c="text"===t?b(n):function(e,t){if(!0===e.hittable)return!0;if(e1(e.rect))return eB(e,t);if(e.rect)return!1;let n=function(e,t){let n=new Map(t.map(e=>[e.index,e])),r=e,a=new Set;for(;"number"==typeof r.parentIndex&&!a.has(r.index);){a.add(r.index);let e=n.get(r.parentIndex);if(!e)break;if(function(e){let t=y(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||e1(e.rect))}(e))return e;r=e}return null}(e,t);return!!n&&(!0===n.hittable||!!e1(n.rect)&&eB(n,t))}(n,r),u=!1;switch(t){case"visible":u=c;break;case"hidden":u=!c;break;case"editable":u=o;break;case"selected":u=l;break;case"text":u=s===(a??"")}let d="text"===t?`expected="${a??""}" actual="${s}"`:`actual=${JSON.stringify({visible:c,editable:o,selected:l})}`;return{pass:u,actualText:s,details:d}}({predicate:t.predicate,node:i.node,nodes:n.snapshot.nodes,expectedText:t.expectedText,platform:e.backend.platform});if(!s.pass)throw new a("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:r.selectors.map(e=>e.raw)}},ts=async(e,t)=>await ti(e,{...t,predicate:"visible",selector:t.target.selector}),to=async(e,t)=>await ti(e,{...t,predicate:"hidden",selector:t.target.selector}),tl=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 e8(e,t.session),r=u(t.target.ref);if(!r)throw new a("INVALID_ARGS",`Invalid ref: ${t.target.ref}`);let i=c(n.snapshot.nodes,r),s=i?g(i,n.snapshot.nodes):void 0;if(!s)throw new a("COMMAND_FAILED",`Ref ${t.target.ref} not found or has no label`);return await th(e,t,s,t.target.timeoutMs)}if("selector"===t.target.kind)return await td(e,t,t.target.selector,t.target.timeoutMs);if(!t.target.text)throw new a("INVALID_ARGS","wait requires text");return await th(e,t,t.target.text,t.target.timeoutMs)},tc=async(e,t)=>{let n=await tl(e,{...t,target:{kind:"text",text:t.text,timeoutMs:t.timeoutMs}});if("text"!==n.kind)throw new a("COMMAND_FAILED","waitForText returned non-text result");return n};async function tu(e,t,n){let r=t.timeoutMs??1e4,i=e3(e);for(;e3(e)-i<r;){if(k((await e6(e,t,{updateSession:!0,scope:e2(n)?t.query:void 0})).snapshot.nodes,n,t.query,{requireRect:!1}).matches[0])return{kind:"found",found:!0,waitedMs:e3(e)-i};await e4(e,300)}throw new a("COMMAND_FAILED","find wait timed out")}async function td(e,t,n,r){let i=r??1e4,s=e3(e),o=p(n);for(;e3(e)-s<i;){let n=d((await e6(e,t,{updateSession:!0})).snapshot.nodes,o,{platform:e.backend.platform});if(n)return{kind:"selector",selector:n.selector.raw,waitedMs:e3(e)-s};await e4(e,300)}throw new a("COMMAND_FAILED",`wait timed out for selector: ${n}`)}async function th(e,t,n,r){let i=r??1e4,s=e3(e);for(;e3(e)-s<i;){if(e.backend.findText?(await e.backend.findText(e5(e,t),n)).found:await tf(e,t,n))return{kind:"text",text:n,waitedMs:e3(e)-s};await e4(e,300)}throw new a("COMMAND_FAILED",`wait timed out for text: ${n}`)}async function tf(e,t,n){return!!w((await e6(e,t,{updateSession:!0})).snapshot.nodes,n)}async function tm(e,t,n,r){let i=await e6(e,{...t,session:n},{updateSession:!0}),s=p(r.selector),o=m(i.snapshot.nodes,s,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:r.disambiguateAmbiguous});if(!o)throw new a("COMMAND_FAILED",x(s,[],{unique:!0}));return{capture:i,node:o.node,selector:o.selector.raw,ref:`@${o.node.ref}`}}function tp(e,t){let n=function(e,t){let n=tg(t.rect);if(!n)return null;let r=t,a=new Set;for(;!a.has(r.ref);){a.add(r.ref);let t=e.filter(e=>{if(e.parentIndex!==r.index||!e.hittable)return!1;let t=tg(e.rect);return!!t&&tb(t,n)});if(1!==t.length)break;r=t[0]}return r===t?null:r}(e,t);if(n?.rect&&tw(n.rect))return n;let r=f(e,t);return r?.rect&&tw(r.rect)?!function(e,t,n){var r,a,i,s;let o,c,u,d=tg(e.rect),h=tg(t.rect);if(!d||!h)return!1;let f=function(e,t){let n=l(t),r=e.filter(e=>{let t=(e.type??"").toLowerCase();return t.includes("application")||t.includes("window")}).map(e=>tg(e.rect)).filter(e=>null!==e);if(0===r.length)return null;let a=r.filter(e=>eE(e,n.x,n.y));return eX(a.length>0?a:r)}(n,d);return!!f&&(r=h,a=f,o=(i=r,s=a,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))),c=r.width*r.height,u=a.width*a.height,!(o<=0)&&!(c<=0)&&!(u<=0)&&!!(o/u>=.9)&&!!(o/c>=.8))&&!tb(d,h)}(t,r,e)?r:t:t}function tw(e){let t=tg(e);if(!t)return null;let n=l(t);return Number.isFinite(n.x)&&Number.isFinite(n.y)?n:null}function tg(e){if(!e)return null;let t=Number(e.x),n=Number(e.y),r=Number(e.width),a=Number(e.height);return Number.isFinite(t)&&Number.isFinite(n)&&Number.isFinite(r)&&Number.isFinite(a)&&!(r<0)&&!(a<0)?{x:t,y:n,width:r,height:a}:null}function tb(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)}let tx=async(e,t)=>await tv(e,t,"press"),ty=async(e,t)=>await tv(e,t,"click");async function tv(e,t,n){let r=await tN(e,t,{action:n,requireInteractive:!0,promoteToHittableAncestor:!0});if(!e.backend.tap)throw new a("UNSUPPORTED_OPERATION","tap is not supported by this backend");let i=await e.backend.tap(e5(e,t),r.point,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap});return{...r,...tC(i)?{backendResult:tC(i)}:{}}}let tM=async(e,t)=>{var n;if(!t.text)throw new a("INVALID_ARGS","fill requires text");let r=await tN(e,t,{action:"fill",requireInteractive:!0,promoteToHittableAncestor:!1});if(!e.backend.fill)throw new a("UNSUPPORTED_OPERATION","fill is not supported by this backend");let i=await e.backend.fill(e5(e,t),r.point,t.text,{delayMs:t.delayMs}),s="node"in r?r.node.type??"":"",o=s&&!M(s,e.backend.platform)?`fill target ${n=r,n.target?.kind==="ref"?n.target.ref:n.target?.kind==="selector"?n.target.selector:"point"} resolved to "${s}", attempting fill anyway.`:void 0;return{...r,text:t.text,...o?{warning:o}:{},...tC(i)?{backendResult:tC(i)}:{}}},tk=async(e,t)=>{var n;let r=t.text;if(!r)throw new a("INVALID_ARGS","type requires text");let i=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}(r);if(i)throw new a("INVALID_ARGS",`type does not accept a target ref like "${i}"`,{hint:`Use fill ${i} "text" to target that field, or press ${i} then type "text" to append.`});if(!e.backend.typeText)throw new a("UNSUPPORTED_OPERATION","type is not supported by this backend");let s=function(e,t){if(!Number.isFinite(e)||!Number.isInteger(e)||e<0||e>1e4)throw new a("INVALID_ARGS",`${t} must be an integer between 0 and 10000`);return e}(t.delayMs??0,"delay-ms"),o=await e.backend.typeText(e5(e,t),r,{delayMs:s}),l=(n=r,`Typed ${Array.from(n).length} chars`);return{kind:"text",text:r,delayMs:s,...tC(o)?{backendResult:tC(o)}:{},...N(l)}};async function tN(e,t,n){if(await tI(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 r=await tS(e,t,t.target),i=r.resolved,s=n.promoteToHittableAncestor?tp(r.snapshot.nodes,i.node):i.node;return function(e,t,n,r){let i=e.rect?eG(e,t):null;if(!(!e.rect||!i||eB(e,t)))throw new a("COMMAND_FAILED",`Ref ${n} is off-screen and not safe to ${r}`,{reason:"offscreen_ref",ref:u(n),rect:e.rect,viewport:i,hint:`Use scroll with the direction from the off-screen summary, take a fresh snapshot, then retry ${r} with the new ref or a selector.`})}(s,r.snapshot.nodes,t.target.ref,n.action),{kind:"ref",point:t$(s,`Ref ${t.target.ref} not found or has invalid bounds`),target:{kind:"ref",ref:`@${i.ref}`},node:s,selectorChain:eZ(s,e.backend.platform,{action:"fill"===n.action?"fill":"click"}),refLabel:g(s,r.snapshot.nodes)}}let r=await tR(e,t,n.requireInteractive),i=p(t.target.selector),s=m(r.snapshot.nodes,i,{platform:e.backend.platform,requireRect:!0,requireUnique:!0,disambiguateAmbiguous:!0});if(!s||!s.node.rect)throw new a("COMMAND_FAILED",x(i,s?.diagnostics??[],{unique:!0}));let o=n.promoteToHittableAncestor?tp(r.snapshot.nodes,s.node):s.node;return{kind:"selector",point:t$(o,`Selector ${s.selector.raw} resolved to invalid bounds`),target:{kind:"selector",selector:s.selector.raw},node:o,selectorChain:eZ(o,e.backend.platform,{action:"fill"===n.action?"fill":"click"}),refLabel:g(o,r.snapshot.nodes)}}async function tI(e,t,n){if("macos"!==e.backend.platform)return;let r=await tA(e,t);if(("desktop"===r||"menubar"===r)&&("menubar"!==r||"click"!==n&&"press"!==n))throw new a("UNSUPPORTED_OPERATION",`${n} is not supported on macOS ${r} sessions yet. Open an app session to act, or use the ${r} surface to inspect.`)}async function tA(e,t){let n=await e.sessions.get(t.session??"default");return n?.metadata?.surface}async function tR(e,t,n){if(!e.backend.captureSnapshot)throw new a("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let r=t.session??"default",i=await e.sessions.get(r);if(!i)throw new a("SESSION_NOT_FOUND","No active session. Run open first.");let s=await e.backend.captureSnapshot(e5(e,t),{interactiveOnly:n,compact:n}),o=s.snapshot??{nodes:s.nodes??[],truncated:s.truncated,backend:s.backend,createdAt:e3(e)};return await e.sessions.set({...i,snapshot:o}),{snapshot:o}}async function tS(e,t,n){let r=t.session??"default",i=await e.sessions.get(r);if(!i)throw new a("SESSION_NOT_FOUND","No active session. Run open first.");if(!i.snapshot)throw new a("INVALID_ARGS","No snapshot in session. Run snapshot first.");let s=n.fallbackLabel??"",o=tP(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=tP(l.snapshot.nodes,n.ref,{fallbackLabel:s,requireRect:!0});if(!c)throw new a("COMMAND_FAILED",`Ref ${n.ref} not found or has no bounds`);return{...l,resolved:c}}function tP(e,t,n){let r=u(t);if(!r)throw new a("INVALID_ARGS",`Invalid ref: ${t}`);let i=c(e,r);if(t_(i,n.requireRect))return{ref:r,node:i};let s=n.fallbackLabel.length>0?w(e,n.fallbackLabel):null;return t_(s,n.requireRect)?{ref:r,node:s}:null}function t$(e,t){if(!e.rect)throw new a("COMMAND_FAILED",t);let n=l(e.rect);if(!Number.isFinite(n.x)||!Number.isFinite(n.y))throw new a("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:r,width:a,height:i}=e.rect;if(!Number.isFinite(Number(n))||!Number.isFinite(Number(r))||!Number.isFinite(Number(a))||!Number.isFinite(Number(i))||0>Number(a)||0>Number(i))return!1;let s=l(e.rect);return Number.isFinite(s.x)&&Number.isFinite(s.y)}function tC(e){return e&&"object"==typeof e?e:void 0}let tO=[{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:"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:"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:"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:"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:"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:"push",category:"portable-runtime",status:"planned"},{command:"trigger-app-event",category:"portable-runtime",status:"planned"},{command:"devices",category:"backend-admin",status:"planned"},{command:"boot",category:"backend-admin",status:"planned"},{command:"ensure-simulator",category:"backend-admin",status:"planned"},{command:"install",category:"backend-admin",status:"planned"},{command:"reinstall",category:"backend-admin",status:"planned"},{command:"install-from-source",category:"backend-admin",status:"planned"},{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:"planned"},{command:"trace",category:"capability-gated",status:"planned"},{command:"replay",category:"capability-gated",status:"planned"},{command:"test",category:"capability-gated",status:"planned"},{command:"batch",category:"capability-gated",status:"planned"},{command:"logs",category:"capability-gated",status:"planned"},{command:"network",category:"capability-gated",status:"planned"},{command:"perf",category:"capability-gated",status:"planned"}];function tD(e){return{dispatch:async t=>{try{(function(e){if(tL.has(e.command))return;let t=tO.find(t=>t.command===e.command);if(t?.status==="planned")throw new a("NOT_IMPLEMENTED",`Command ${e.command} is planned but not implemented in the runtime router yet`,{command:e.command});throw new a("UNSUPPORTED_OPERATION",`Unknown runtime command: ${e.command}`,{command:e.command})})(t),await e.beforeDispatch?.(t);let n=await e.createRuntime(t);return{ok:!0,data:await tT(n,t)}}catch(n){return{ok:!1,error:e.formatError?.(n,t)??i(n)}}}}}let tL=new Set(["capture.screenshot","capture.diffScreenshot","capture.snapshot","capture.diffSnapshot","selectors.find","selectors.get","selectors.is","selectors.wait","interactions.click","interactions.press","interactions.fill","interactions.typeText"]);async function tT(e,t){switch(t.command){case"capture.screenshot":return await S(e,t.options);case"capture.diffScreenshot":return await eb(e,t.options);case"capture.snapshot":return await eH(e,t.options);case"capture.diffSnapshot":return await eK(e,t.options);case"selectors.find":return await tt(e,t.options);case"selectors.get":return await tn(e,t.options);case"selectors.is":return await ti(e,t.options);case"selectors.wait":return await tl(e,t.options);case"interactions.click":return await ty(e,t.options);case"interactions.press":return await tx(e,t.options);case"interactions.fill":return await tM(e,t.options);case"interactions.typeText":return await tk(e,t.options)}}let tE={capture:{screenshot:S,diffScreenshot:eb,snapshot:eH,diffSnapshot:eK},selectors:{find:tt,get:tn,getText:tr,getAttrs:ta,is:ti,isVisible:ts,isHidden:to,wait:tl,waitForText:tc},interactions:{click:ty,press:tx,fill:tM,typeText:tk}};function tX(e){return{capture:{screenshot:t=>tE.capture.screenshot(e,t),diffScreenshot:t=>tE.capture.diffScreenshot(e,t),snapshot:t=>tE.capture.snapshot(e,t),diffSnapshot:t=>tE.capture.diffSnapshot(e,t)},selectors:{find:t=>tE.selectors.find(e,t),get:t=>tE.selectors.get(e,t),getText:(t,n={})=>tE.selectors.getText(e,{...n,target:t}),getAttrs:(t,n={})=>tE.selectors.getAttrs(e,{...n,target:t}),is:t=>tE.selectors.is(e,t),isVisible:(t,n={})=>tE.selectors.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>tE.selectors.isHidden(e,{...n,target:t}),wait:t=>tE.selectors.wait(e,t),waitForText:(t,n={})=>tE.selectors.waitForText(e,{...n,text:t})},interactions:{click:(t,n={})=>tE.interactions.click(e,{...n,target:t}),press:(t,n={})=>tE.interactions.press(e,{...n,target:t}),fill:(t,n,r={})=>tE.interactions.fill(e,{...r,target:t,text:n}),typeText:(t,n={})=>tE.interactions.typeText(e,{...n,text:t})}}}export{tX as bindCommands,tO as commandCatalog,tE as commands,tD as createCommandRouter,e9 as selector,te as ref};

package/dist/src/contracts.d.ts

@@ -1,4 +1,4 @@
-export declare type AppErrorCode = 'INVALID_ARGS' | 'DEVICE_NOT_FOUND' | 'TOOL_MISSING' | 'APP_NOT_INSTALLED' | 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_OPERATION' | 'COMMAND_FAILED' | 'SESSION_NOT_FOUND' | 'UNAUTHORIZED' | 'UNKNOWN';
+export declare type AppErrorCode = 'INVALID_ARGS' | 'DEVICE_NOT_FOUND' | 'TOOL_MISSING' | 'APP_NOT_INSTALLED' | 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_OPERATION' | 'NOT_IMPLEMENTED' | 'COMMAND_FAILED' | 'SESSION_NOT_FOUND' | 'UNAUTHORIZED' | 'UNKNOWN';
 
 export declare function centerOfRect(rect: Rect): Point;