agent-device 0.3.2 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/src/daemon.js +12 -12
- package/package.json +1 -1
- package/src/daemon/__tests__/selectors.test.ts +133 -0
- package/src/daemon/handlers/__tests__/replay-heal.test.ts +59 -0
- package/src/daemon/handlers/interaction.ts +5 -3
- package/src/daemon/handlers/session.ts +12 -5
- package/src/daemon/selectors.ts +138 -20
- package/src/daemon/snapshot-processing.ts +5 -1
package/dist/src/daemon.js
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
let e,t;import i from"node:crypto";import{isCancel as r,select as a}from"@clack/prompts";import{node_path as n,runCmdStreaming as o,promises as s,asAppError as l,fileURLToPath as c,runCmdBackground as d,node_fs as u,node_os as f,errors_AppError as p,runCmd as m,node_net as h,whichCmd as w,readVersion as g}from"./274.js";async function v(e,t){let i=e,n=e=>e.toLowerCase().replace(/_/g," ").replace(/\s+/g," ").trim();if(t.platform&&(i=i.filter(e=>e.platform===t.platform)),t.udid){let e=i.find(e=>e.id===t.udid&&"ios"===e.platform);if(!e)throw new p("DEVICE_NOT_FOUND",`No iOS device with UDID ${t.udid}`);return e}if(t.serial){let e=i.find(e=>e.id===t.serial&&"android"===e.platform);if(!e)throw new p("DEVICE_NOT_FOUND",`No Android device with serial ${t.serial}`);return e}if(t.deviceName){let e=n(t.deviceName),r=i.find(t=>n(t.name)===e);if(!r)throw new p("DEVICE_NOT_FOUND",`No device named ${t.deviceName}`);return r}if(1===i.length)return i[0];if(0===i.length)throw new p("DEVICE_NOT_FOUND","No devices found",{selector:t});let o=i.filter(e=>e.booted);if(1===o.length)return o[0];if(!process.env.CI&&process.stdin.isTTY&&process.stdout.isTTY){let e=await a({message:"Multiple devices available. Choose a device to continue:",options:(o.length>0?o:i).map(e=>({label:`${e.name} (${e.platform}${e.kind?`, ${e.kind}`:""}${e.booted?", booted":""})`,value:e.id}))});if(r(e))throw new p("INVALID_ARGS","Device selection cancelled");if(e){let t=i.find(t=>t.id===e);if(t)return t}}return o[0]??i[0]}function A(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function y(e){return["1","true","yes","on"].includes((e??"").toLowerCase())}let I=2e4,b=12e4,N=1e4;class S{static fromTimeoutMs(e,t=Date.now()){return new S(t,e)}remainingMs(e=Date.now()){return Math.max(0,this.expiresAtMs-e)}elapsedMs(e=Date.now()){return Math.max(0,e-this.startedAtMs)}isExpired(e=Date.now()){return 0>=this.remainingMs(e)}constructor(e,t){A(this,"startedAtMs",void 0),A(this,"expiresAtMs",void 0),this.startedAtMs=e,this.expiresAtMs=e+Math.max(0,t)}}async function D(e,t={},i={}){let r,a={maxAttempts:t.maxAttempts??3,baseDelayMs:t.baseDelayMs??200,maxDelayMs:t.maxDelayMs??2e3,jitter:t.jitter??.2,shouldRetry:t.shouldRetry};for(let t=1;t<=a.maxAttempts&&(!i.deadline?.isExpired()||!(t>1));t+=1)try{let r=await e({attempt:t,maxAttempts:a.maxAttempts,deadline:i.deadline});return i.onEvent?.({phase:i.phase,event:"succeeded",attempt:t,maxAttempts:a.maxAttempts,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs()}),r}catch(s){r=s;let e=i.classifyReason?.(s);if(i.onEvent?.({phase:i.phase,event:"attempt_failed",attempt:t,maxAttempts:a.maxAttempts,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs(),reason:e}),t>=a.maxAttempts||a.shouldRetry&&!a.shouldRetry(s,t))break;let n=function(e,t,i,r){let a=Math.min(t,e*2**(r-1));return Math.max(0,a+a*i*(2*Math.random()-1))}(a.baseDelayMs,a.maxDelayMs,a.jitter,t),o=i.deadline?Math.min(n,i.deadline.remainingMs()):n;if(o<=0)break;i.onEvent?.({phase:i.phase,event:"retry_scheduled",attempt:t,maxAttempts:a.maxAttempts,delayMs:o,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs(),reason:e}),await function(e){return new Promise(t=>setTimeout(t,e))}(o)}if(i.onEvent?.({phase:i.phase,event:"exhausted",attempt:a.maxAttempts,maxAttempts:a.maxAttempts,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs(),reason:i.classifyReason?.(r)}),r)throw r;throw new p("COMMAND_FAILED","retry failed")}async function
|
|
2
|
-
`)}})}catch(f){let a=l(f),o=i?.stdout,s=i?.stderr,c=i?.exitCode,d=
|
|
3
|
-
${r.stderr}`.toLowerCase();if(!e.includes("unknown package")&&!e.includes("not installed"))throw new p("COMMAND_FAILED",`adb uninstall failed for ${i.value}`,{stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode})}return{package:i.value}}async function ee(e,t){await m("adb",j(e,["install",t]))}async function et(e,t,i){e.booted||await
|
|
1
|
+
let e,t;import i from"node:crypto";import{isCancel as r,select as a}from"@clack/prompts";import{node_path as n,runCmdStreaming as o,promises as s,asAppError as l,fileURLToPath as c,runCmdBackground as d,node_fs as u,node_os as f,errors_AppError as p,runCmd as m,node_net as h,whichCmd as w,readVersion as g}from"./274.js";async function v(e,t){let i=e,n=e=>e.toLowerCase().replace(/_/g," ").replace(/\s+/g," ").trim();if(t.platform&&(i=i.filter(e=>e.platform===t.platform)),t.udid){let e=i.find(e=>e.id===t.udid&&"ios"===e.platform);if(!e)throw new p("DEVICE_NOT_FOUND",`No iOS device with UDID ${t.udid}`);return e}if(t.serial){let e=i.find(e=>e.id===t.serial&&"android"===e.platform);if(!e)throw new p("DEVICE_NOT_FOUND",`No Android device with serial ${t.serial}`);return e}if(t.deviceName){let e=n(t.deviceName),r=i.find(t=>n(t.name)===e);if(!r)throw new p("DEVICE_NOT_FOUND",`No device named ${t.deviceName}`);return r}if(1===i.length)return i[0];if(0===i.length)throw new p("DEVICE_NOT_FOUND","No devices found",{selector:t});let o=i.filter(e=>e.booted);if(1===o.length)return o[0];if(!process.env.CI&&process.stdin.isTTY&&process.stdout.isTTY){let e=await a({message:"Multiple devices available. Choose a device to continue:",options:(o.length>0?o:i).map(e=>({label:`${e.name} (${e.platform}${e.kind?`, ${e.kind}`:""}${e.booted?", booted":""})`,value:e.id}))});if(r(e))throw new p("INVALID_ARGS","Device selection cancelled");if(e){let t=i.find(t=>t.id===e);if(t)return t}}return o[0]??i[0]}function A(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function y(e){return["1","true","yes","on"].includes((e??"").toLowerCase())}let I=2e4,b=12e4,N=1e4;class S{static fromTimeoutMs(e,t=Date.now()){return new S(t,e)}remainingMs(e=Date.now()){return Math.max(0,this.expiresAtMs-e)}elapsedMs(e=Date.now()){return Math.max(0,e-this.startedAtMs)}isExpired(e=Date.now()){return 0>=this.remainingMs(e)}constructor(e,t){A(this,"startedAtMs",void 0),A(this,"expiresAtMs",void 0),this.startedAtMs=e,this.expiresAtMs=e+Math.max(0,t)}}async function D(e,t={},i={}){let r,a={maxAttempts:t.maxAttempts??3,baseDelayMs:t.baseDelayMs??200,maxDelayMs:t.maxDelayMs??2e3,jitter:t.jitter??.2,shouldRetry:t.shouldRetry};for(let t=1;t<=a.maxAttempts&&(!i.deadline?.isExpired()||!(t>1));t+=1)try{let r=await e({attempt:t,maxAttempts:a.maxAttempts,deadline:i.deadline});return i.onEvent?.({phase:i.phase,event:"succeeded",attempt:t,maxAttempts:a.maxAttempts,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs()}),r}catch(s){r=s;let e=i.classifyReason?.(s);if(i.onEvent?.({phase:i.phase,event:"attempt_failed",attempt:t,maxAttempts:a.maxAttempts,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs(),reason:e}),t>=a.maxAttempts||a.shouldRetry&&!a.shouldRetry(s,t))break;let n=function(e,t,i,r){let a=Math.min(t,e*2**(r-1));return Math.max(0,a+a*i*(2*Math.random()-1))}(a.baseDelayMs,a.maxDelayMs,a.jitter,t),o=i.deadline?Math.min(n,i.deadline.remainingMs()):n;if(o<=0)break;i.onEvent?.({phase:i.phase,event:"retry_scheduled",attempt:t,maxAttempts:a.maxAttempts,delayMs:o,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs(),reason:e}),await function(e){return new Promise(t=>setTimeout(t,e))}(o)}if(i.onEvent?.({phase:i.phase,event:"exhausted",attempt:a.maxAttempts,maxAttempts:a.maxAttempts,elapsedMs:i.deadline?.elapsedMs(),remainingMs:i.deadline?.remainingMs(),reason:i.classifyReason?.(r)}),r)throw r;throw new p("COMMAND_FAILED","retry failed")}async function x(e,t={}){return D(()=>e(),{maxAttempts:t.attempts,baseDelayMs:t.baseDelayMs,maxDelayMs:t.maxDelayMs,jitter:t.jitter,shouldRetry:t.shouldRetry})}function k(e){let t=e.error?l(e.error):null,i=e.context?.platform,r=e.context?.phase;if(t?.code==="TOOL_MISSING")return"android"===i?"ADB_TRANSPORT_UNAVAILABLE":"IOS_TOOL_MISSING";let a=t?.details??{},n="string"==typeof a.message?a.message:void 0,o="string"==typeof a.stdout?a.stdout:void 0,s="string"==typeof a.stderr?a.stderr:void 0,c=a.boot&&"object"==typeof a.boot?a.boot:null,d=a.bootstatus&&"object"==typeof a.bootstatus?a.bootstatus:null,u=[e.message,t?.message,e.stdout,e.stderr,n,o,s,"string"==typeof c?.stdout?c.stdout:void 0,"string"==typeof c?.stderr?c.stderr:void 0,"string"==typeof d?.stdout?d.stdout:void 0,"string"==typeof d?.stderr?d.stderr:void 0].filter(Boolean).join("\n").toLowerCase();return"ios"===i&&(u.includes("runner did not accept connection")||"connect"===r&&(u.includes("timed out")||u.includes("timeout")||u.includes("econnrefused")||u.includes("connection refused")||u.includes("fetch failed")||u.includes("socket hang up")))?"IOS_RUNNER_CONNECT_TIMEOUT":"ios"===i&&"boot"===r&&(u.includes("timed out")||u.includes("timeout"))?"IOS_BOOT_TIMEOUT":"android"===i&&"boot"===r&&(u.includes("timed out")||u.includes("timeout"))?"ANDROID_BOOT_TIMEOUT":u.includes("resource temporarily unavailable")||u.includes("killed: 9")||u.includes("cannot allocate memory")||u.includes("system is low on memory")?"CI_RESOURCE_STARVATION_SUSPECTED":"android"===i&&(u.includes("device not found")||u.includes("no devices")||u.includes("device offline")||u.includes("offline")||u.includes("unauthorized")||u.includes("not authorized")||u.includes("unable to locate device")||u.includes("invalid device"))?"ADB_TRANSPORT_UNAVAILABLE":t?.code==="COMMAND_FAILED"||u.length>0?"BOOT_COMMAND_FAILED":"UNKNOWN"}function O(e){switch(e){case"IOS_BOOT_TIMEOUT":return"Retry simulator boot and inspect simctl bootstatus logs; in CI consider increasing AGENT_DEVICE_IOS_BOOT_TIMEOUT_MS.";case"IOS_RUNNER_CONNECT_TIMEOUT":return"Retry runner startup, inspect xcodebuild logs, and verify simulator responsiveness before command execution.";case"ANDROID_BOOT_TIMEOUT":return"Retry emulator startup and verify sys.boot_completed reaches 1; consider increasing startup budget in CI.";case"ADB_TRANSPORT_UNAVAILABLE":return"Check adb server/device transport (adb devices -l), restart adb, and ensure the target device is online and authorized.";case"CI_RESOURCE_STARVATION_SUSPECTED":return"CI machine may be resource constrained; reduce parallel jobs or use a larger runner.";case"IOS_TOOL_MISSING":return"Xcode command-line tools are missing or not in PATH; run xcode-select --install and verify xcrun works.";case"BOOT_COMMAND_FAILED":return"Inspect command stderr/stdout for the failing boot phase and retry after environment validation.";default:return"Retry once and inspect verbose logs for the failing phase."}}let _=y(process.env.AGENT_DEVICE_RETRY_LOGS);function M(e){return e.startsWith("emulator-")}async function L(e,t=N){return m("adb",["-s",e,"shell","getprop","sys.boot_completed"],{allowFailure:!0,timeoutMs:t})}async function R(e,t){let i=t.replace(/_/g," ").trim();if(!M(e))return i||e;let r=await m("adb",["-s",e,"emu","avd","name"],{allowFailure:!0,timeoutMs:N}),a=r.stdout.trim();return 0===r.exitCode&&a?a.replace(/_/g," "):i||e}async function E(){if(!await w("adb"))throw new p("TOOL_MISSING","adb not found in PATH");let e=(await m("adb",["devices","-l"],{timeoutMs:N})).stdout.split("\n").map(e=>e.trim()).filter(e=>e.length>0&&!e.startsWith("List of devices")).map(e=>e.split(/\s+/)).filter(e=>"device"===e[1]).map(e=>({serial:e[0],rawModel:(e.find(e=>e.startsWith("model:"))??"").replace("model:","")}));return await Promise.all(e.map(async({serial:e,rawModel:t})=>{let[i,r]=await Promise.all([R(e,t),C(e)]);return{platform:"android",id:e,name:i,kind:M(e)?"emulator":"device",booted:r}}))}async function C(e){try{let t=await L(e);return"1"===t.stdout.trim()}catch{return!1}}async function T(e,t=6e4){let i,r=S.fromTimeoutMs(t),a=Math.max(1,Math.ceil(t/1e3)),n=!1;try{await D(async({deadline:a})=>{if(a?.isExpired())throw n=!0,new p("COMMAND_FAILED","Android boot deadline exceeded",{serial:e,timeoutMs:t,elapsedMs:r.elapsedMs(),message:"timeout"});let o=Math.max(1e3,a?.remainingMs()??t),s=await L(e,Math.min(o,N));if(i=s,"1"!==s.stdout.trim())throw new p("COMMAND_FAILED","Android device is still booting",{serial:e,stdout:s.stdout,stderr:s.stderr,exitCode:s.exitCode})},{maxAttempts:a,baseDelayMs:1e3,maxDelayMs:1e3,jitter:0,shouldRetry:e=>{let t=k({error:e,stdout:i?.stdout,stderr:i?.stderr,context:{platform:"android",phase:"boot"}});return"ADB_TRANSPORT_UNAVAILABLE"!==t&&"ANDROID_BOOT_TIMEOUT"!==t}},{deadline:r,phase:"boot",classifyReason:e=>k({error:e,stdout:i?.stdout,stderr:i?.stderr,context:{platform:"android",phase:"boot"}}),onEvent:e=>{_&&process.stderr.write(`[agent-device][retry] ${JSON.stringify(e)}
|
|
2
|
+
`)}})}catch(f){let a=l(f),o=i?.stdout,s=i?.stderr,c=i?.exitCode,d=k({error:f,stdout:o,stderr:s,context:{platform:"android",phase:"boot"}});"BOOT_COMMAND_FAILED"===d&&"Android device is still booting"===a.message&&(d="ANDROID_BOOT_TIMEOUT");let u={serial:e,timeoutMs:t,elapsedMs:r.elapsedMs(),reason:d,hint:O(d),stdout:o,stderr:s,exitCode:c};if(n||"ANDROID_BOOT_TIMEOUT"===d)throw new p("COMMAND_FAILED","Android device did not finish booting in time",u);if("TOOL_MISSING"===a.code)throw new p("TOOL_MISSING",a.message,{...u,...a.details??{}});if("ADB_TRANSPORT_UNAVAILABLE"===d)throw new p("COMMAND_FAILED",a.message,{...u,...a.details??{}});throw new p(a.code,a.message,{...u,...a.details??{}},a.cause)}}function P(e){let t=$(e),i=e=>{let i=F(t,e);if(null!==i)return"true"===i};return{text:F(t,"text"),desc:F(t,"content-desc"),resourceId:F(t,"resource-id"),className:F(t,"class"),bounds:F(t,"bounds"),clickable:i("clickable"),enabled:i("enabled"),focusable:i("focusable"),focused:i("focused")}}function $(e){let t=new Map,i=e.indexOf(" "),r=e.lastIndexOf(">");if(i<0||r<=i)return t;let a=/([^\s=/>]+)\s*=\s*(["'])([\s\S]*?)\2/y,n=i;for(;n<r;){for(;n<r;){let t=e[n];if(" "!==t&&"\n"!==t&&"\r"!==t&&" "!==t)break;n+=1}if(n>=r)break;let i=e[n];if("/"===i||">"===i)break;a.lastIndex=n;let o=a.exec(e);if(!o)break;t.set(o[1],o[3]),n=a.lastIndex}return t}function F(e,t){return e.get(t)??null}function B(e){if(!e)return;let t=/\[(\d+),(\d+)\]\[(\d+),(\d+)\]/.exec(e);if(!t)return;let i=Number(t[1]),r=Number(t[2]);return{x:i,y:r,width:Math.max(0,Number(t[3])-i),height:Math.max(0,Number(t[4])-r)}}function V(e){return e?e.toLowerCase():""}function U(e){let t=e.trim();return!!t&&/^[\w.]+:id\/[\w.-]+$/i.test(t)}let G={settings:{type:"intent",value:"android.settings.SETTINGS"}};function j(e,t){return["-s",e.id,...t]}async function q(e,t){let i=t.trim();if(i.includes("."))return{type:"package",value:i};let r=G[i.toLowerCase()];if(r)return r;let a=(await m("adb",j(e,["shell","pm","list","packages"]))).stdout.split("\n").map(e=>e.replace("package:","").trim()).filter(Boolean).filter(e=>e.toLowerCase().includes(i.toLowerCase()));if(1===a.length)return{type:"package",value:a[0]};if(a.length>1)throw new p("INVALID_ARGS",`Multiple packages matched "${t}"`,{matches:a});throw new p("APP_NOT_INSTALLED",`No package found matching "${t}"`)}async function W(e,t="launchable"){if("launchable"===t){let t=await m("adb",j(e,["shell","cmd","package","query-activities","--brief","-a","android.intent.action.MAIN","-c","android.intent.category.LAUNCHER"]),{allowFailure:!0});if(0===t.exitCode&&t.stdout.trim().length>0){let e=new Set;for(let i of t.stdout.split("\n")){let t=i.trim();if(!t)continue;let r=t.split(/\s+/)[0],a=r.includes("/")?r.split("/")[0]:r;a&&e.add(a)}if(e.size>0)return Array.from(e)}}return(await m("adb",j(e,"user-installed"===t?["shell","pm","list","packages","-3"]:["shell","pm","list","packages"]))).stdout.split("\n").map(e=>e.replace("package:","").trim()).filter(Boolean)}async function J(e,t="launchable"){let i=await W(e,t),r=new Set("launchable"===t?i:await W(e,"launchable"));return i.map(e=>({package:e,launchable:r.has(e)}))}async function H(e){let t=await z(e,[["shell","dumpsys","window","windows"],["shell","dumpsys","window"]]);if(t)return t;let i=await z(e,[["shell","dumpsys","activity","activities"],["shell","dumpsys","activity"]]);return i||{}}async function z(e,t){for(let i of t){let t=function(e){for(let t of[/mCurrentFocus=Window\{[^}]*\s([\w.]+)\/([\w.$]+)/,/mFocusedApp=AppWindowToken\{[^}]*\s([\w.]+)\/([\w.$]+)/,/mResumedActivity:.*?\s([\w.]+)\/([\w.$]+)/,/ResumedActivity:.*?\s([\w.]+)\/([\w.$]+)/]){let i=t.exec(e);if(i)return{package:i[1],activity:i[2]}}return null}((await m("adb",j(e,i),{allowFailure:!0})).stdout??"");if(t)return t}return null}async function X(e,t,i){e.booted||await T(e.id);let r=await q(e,t);if("intent"===r.type){if(i)throw new p("INVALID_ARGS","Activity override requires a package name, not an intent");await m("adb",j(e,["shell","am","start","-a",r.value]));return}if(i){let t=i.includes("/")?i:`${r.value}/${i.startsWith(".")?i:`.${i}`}`;await m("adb",j(e,["shell","am","start","-a","android.intent.action.MAIN","-c","android.intent.category.DEFAULT","-c","android.intent.category.LAUNCHER","-n",t]));return}try{await m("adb",j(e,["shell","am","start","-a","android.intent.action.MAIN","-c","android.intent.category.DEFAULT","-c","android.intent.category.LAUNCHER","-p",r.value]));return}catch(i){let t=await K(e,r.value);if(!t)throw i;await m("adb",j(e,["shell","am","start","-a","android.intent.action.MAIN","-c","android.intent.category.DEFAULT","-c","android.intent.category.LAUNCHER","-n",t]))}}async function K(e,t){let i=await m("adb",j(e,["shell","cmd","package","resolve-activity","--brief",t]),{allowFailure:!0});return 0!==i.exitCode?null:function(e){let t=e.split("\n").map(e=>e.trim()).filter(Boolean);for(let e=t.length-1;e>=0;e-=1){let i=t[e];if(i.includes("/"))return i.split(/\s+/)[0]}return null}(i.stdout)}async function Y(e){e.booted||await T(e.id)}async function Z(e,t){if("settings"===t.trim().toLowerCase())return void await m("adb",j(e,["shell","am","force-stop","com.android.settings"]));let i=await q(e,t);if("intent"===i.type)throw new p("INVALID_ARGS","Close requires a package name, not an intent");await m("adb",j(e,["shell","am","force-stop",i.value]))}async function Q(e,t){let i=await q(e,t);if("intent"===i.type)throw new p("INVALID_ARGS","reinstall requires a package name, not an intent");let r=await m("adb",j(e,["uninstall",i.value]),{allowFailure:!0});if(0!==r.exitCode){let e=`${r.stdout}
|
|
3
|
+
${r.stderr}`.toLowerCase();if(!e.includes("unknown package")&&!e.includes("not installed"))throw new p("COMMAND_FAILED",`adb uninstall failed for ${i.value}`,{stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode})}return{package:i.value}}async function ee(e,t){await m("adb",j(e,["install",t]))}async function et(e,t,i){e.booted||await T(e.id);let{package:r}=await Q(e,t);return await ee(e,i),{package:r}}async function ei(e,t,i){await m("adb",j(e,["shell","input","tap",String(t),String(i)]))}async function er(e){await m("adb",j(e,["shell","input","keyevent","4"]))}async function ea(e){await m("adb",j(e,["shell","input","keyevent","3"]))}async function en(e){await m("adb",j(e,["shell","input","keyevent","187"]))}async function eo(e,t,i,r=800){await m("adb",j(e,["shell","input","swipe",String(t),String(i),String(t),String(i),String(r)]))}async function es(e,t){let i=t.replace(/ /g,"%s");await m("adb",j(e,["shell","input","text",i]))}async function el(e,t,i){await ei(e,t,i)}async function ec(e,t,i,r){await el(e,t,i);let a=null;for(let s of[{clearPadding:12,minClear:8,maxClear:48,chunkSize:4,delayMs:0},{clearPadding:24,minClear:16,maxClear:96,chunkSize:1,delayMs:15}]){var n,o;let l=(n=r.length+s.clearPadding,o=s.minClear,Math.max(o,Math.min(s.maxClear,n)));if(await eb(e,l),await eI(e,r,s.chunkSize,s.delayMs),(a=await eN(e,t,i))===r)return}throw new p("COMMAND_FAILED","Android fill verification failed",{expected:r,actual:a??null})}async function ed(e,t,i=.6){let{width:r,height:a}=await ew(e),n=Math.floor(r*i),o=Math.floor(a*i),s=Math.floor(r/2),l=Math.floor(a/2),c=s,d=l,u=s,f=l;switch(t){case"up":d=l-Math.floor(o/2),f=l+Math.floor(o/2);break;case"down":d=l+Math.floor(o/2),f=l-Math.floor(o/2);break;case"left":c=s-Math.floor(n/2),u=s+Math.floor(n/2);break;case"right":c=s+Math.floor(n/2),u=s-Math.floor(n/2);break;default:throw new p("INVALID_ARGS",`Unknown direction: ${t}`)}await m("adb",j(e,["shell","input","swipe",String(c),String(d),String(u),String(f),"300"]))}async function eu(e,t){for(let i=0;i<8;i+=1){let i="";try{i=await eg(e)}catch(t){let e=t instanceof Error?t.message:String(t);throw new p("UNSUPPORTED_OPERATION",`uiautomator dump failed: ${e}`)}if(function(e,t){let i=t.toLowerCase(),r=/<node[^>]+>/g,a=r.exec(e);for(;a;){let t=$(a[0]),n=(F(t,"text")??"").toLowerCase(),o=(F(t,"content-desc")??"").toLowerCase();if(n.includes(i)||o.includes(i)){let e=B(F(t,"bounds"));if(e)return{x:Math.floor(e.x+e.width/2),y:Math.floor(e.y+e.height/2)};return{x:0,y:0}}a=r.exec(e)}return null}(i,t))return;await ed(e,"down",.5)}throw new p("COMMAND_FAILED",`Could not find element containing "${t}" after scrolling`)}async function ef(e,t){let i=await m("adb",j(e,["exec-out","screencap","-p"]),{binaryStdout:!0});if(!i.stdoutBuffer)throw new p("COMMAND_FAILED","Failed to capture screenshot");await s.writeFile(t,i.stdoutBuffer)}async function ep(e,t,i){let r=t.toLowerCase(),a=function(e){let t=e.toLowerCase();if("on"===t||"true"===t||"1"===t)return!0;if("off"===t||"false"===t||"0"===t)return!1;throw new p("INVALID_ARGS",`Invalid setting state: ${e}`)}(i);switch(r){case"wifi":return void await m("adb",j(e,["shell","svc","wifi",a?"enable":"disable"]));case"airplane":await m("adb",j(e,["shell","settings","put","global","airplane_mode_on",a?"1":"0"])),await m("adb",j(e,["shell","am","broadcast","-a","android.intent.action.AIRPLANE_MODE","--ez","state",a?"true":"false"]));return;case"location":return void await m("adb",j(e,["shell","settings","put","secure","location_mode",a?"3":"0"]));default:throw new p("INVALID_ARGS",`Unsupported setting: ${t}`)}}async function em(e,t={}){return function(e,t,i){let r=function(e){let t={type:null,label:null,value:null,identifier:null,depth:-1,children:[]},i=[t],r=/<node\b[^>]*>|<\/node>/g,a=r.exec(e);for(;a;){let t=a[0];if(t.startsWith("</node")){i.length>1&&i.pop(),a=r.exec(e);continue}let n=P(t),o=B(n.bounds),s=i[i.length-1],l={type:n.className,label:n.text||n.desc,value:n.text,identifier:n.resourceId,rect:o,enabled:n.enabled,hittable:n.clickable??n.focusable,depth:s.depth+1,parentIndex:void 0,children:[]};s.children.push(l),t.endsWith("/>")||i.push(l),a=r.exec(e)}return t}(e),a=[],n=!1,o=i.depth??1/0,s=i.scope?function(e,t){let i=t.toLowerCase(),r=[...e.children];for(;r.length>0;){let e=r.shift(),t=e.label?.toLowerCase()??"",a=e.value?.toLowerCase()??"",n=e.identifier?.toLowerCase()??"";if(t.includes(i)||a.includes(i)||n.includes(i))return e;r.push(...e.children)}return null}(r,i.scope):null,l=s?[s]:r.children,c=new Map,d=e=>{let t=c.get(e);if(void 0!==t)return t;for(let t of e.children)if(t.hittable||d(t))return c.set(e,!0),!0;return c.set(e,!1),!1},u=(e,t,r,s=!1,l=!1)=>{var c,f,p,m,h,w;let g,v,A,y,I,b,N,S;if(a.length>=800){n=!0;return}if(t>o)return;let D=!!i.raw||(c=e,f=i,p=s,m=d(e),h=l,v=V(c.type),A=!!(c.label&&c.label.trim().length>0),y=!!(c.identifier&&c.identifier.trim().length>0),I=A&&!U(c.label??""),b=y&&!U(c.identifier??""),N=(g=(w=v).split(".").pop()??w).includes("layout")||"viewgroup"===g||"view"===g,S="imageview"===v||"imagebutton"===v,f.interactiveOnly?!!c.hittable||!!(I||b)&&!S&&(!N||!!h)&&(p||m||h):f.compact?I||b||!!c.hittable:!N&&!S||!!c.hittable||!!I||!!b&&!!m||m),x=r;D&&(x=a.length,a.push({index:x,type:e.type??void 0,label:e.label??void 0,value:e.value??void 0,identifier:e.identifier??void 0,rect:e.rect,enabled:e.enabled,hittable:e.hittable,depth:t,parentIndex:r}));let k=s||!!e.hittable,O=l||function(e){if(!e)return!1;let t=V(e);return t.includes("recyclerview")||t.includes("listview")||t.includes("gridview")}(e.type);for(let i of e.children)if(u(i,t+1,x,k,O),n)return};for(let e of l)if(u(e,0,void 0,!1,!1),n)break;return n?{nodes:a,truncated:n}:{nodes:a}}(await eg(e),0,t)}async function eh(){if(!await w("adb"))throw new p("TOOL_MISSING","adb not found in PATH")}async function ew(e){let t=(await m("adb",j(e,["shell","wm","size"]))).stdout.match(/Physical size:\s*(\d+)x(\d+)/);if(!t)throw new p("COMMAND_FAILED","Unable to read screen size");return{width:Number(t[1]),height:Number(t[2])}}async function eg(e){return x(()=>ev(e),{shouldRetry:ey})}async function ev(e){var t,i,r;let a,n,o=await m("adb",j(e,["exec-out","uiautomator","dump","/dev/tty"]),{allowFailure:!0});if(0===o.exitCode){let e=eA(o.stdout,o.stderr);if(e)return e}let s="/sdcard/window_dump.xml",l=await m("adb",j(e,["shell","uiautomator","dump",s])),c=(t=s,i=l.stdout,r=l.stderr,a=`${i}
|
|
4
4
|
${r}`,n=/dumped to:\s*(\S+)/i.exec(a),n?.[1]??t),d=await m("adb",j(e,["shell","cat",c])),u=eA(d.stdout,d.stderr);if(!u)throw new p("COMMAND_FAILED","uiautomator dump did not return XML",{stdout:d.stdout,stderr:d.stderr});return u}function eA(e,t){let i=`${e}
|
|
5
|
-
${t}`,r=i.indexOf("<?xml"),a=r>=0?r:i.indexOf("<hierarchy");if(a<0)return null;let n=i.lastIndexOf("</hierarchy>");if(n<0||n<a)return null;let o=i.slice(a,n+12).trim();return o.length>0?o:null}function ey(e){if(!(e instanceof p)||"COMMAND_FAILED"!==e.code)return!1;let t=`${e.details?.stderr??""}`.toLowerCase();return!!(t.includes("device offline")||t.includes("device not found")||t.includes("transport error")||t.includes("connection reset")||t.includes("broken pipe")||t.includes("timed out")||t.includes("no such file or directory"))}async function eI(e,t,i,r){let a=Math.max(1,Math.floor(i));for(let i=0;i<t.length;i+=a){let n=t.slice(i,i+a);await es(e,n),r>0&&i+a<t.length&&await eD(r)}}async function eb(e,t){let i=Math.max(0,t);await m("adb",j(e,["shell","input","keyevent","KEYCODE_MOVE_END"]),{allowFailure:!0});for(let t=0;t<i;t+=24){let r=Math.min(24,i-t);await m("adb",j(e,["shell","input","keyevent",...Array(r).fill("KEYCODE_DEL")]),{allowFailure:!0})}}async function eN(e,t,i){let r,a=await eg(e),n=/<node\b[^>]*>/g,o=null,s=null,l=null;for(;null!==(r=n.exec(a));){let e=
|
|
6
|
-
${r.stderr}`.toLowerCase();if(!e.includes("not installed")&&!e.includes("not found")&&!e.includes("no such file"))throw new p("COMMAND_FAILED",`simctl uninstall failed for ${i}`,{stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode})}return{bundleId:i}}async function
|
|
7
|
-
${t.stderr}`.toLowerCase(),o=n.includes("already booted")||n.includes("current state: booted");if(0!==t.exitCode&&!o)throw new p("COMMAND_FAILED","simctl boot failed",{stdout:t.stdout,stderr:t.stderr,exitCode:t.exitCode});if(i=await m("xcrun",["simctl","bootstatus",e.id,"-b"],{allowFailure:!0,timeoutMs:a}),0!==i.exitCode)throw new p("COMMAND_FAILED","simctl bootstatus failed",{stdout:i.stdout,stderr:i.stderr,exitCode:i.exitCode});let s=await eG(e.id);if("Booted"!==s)throw new p("COMMAND_FAILED","Simulator is still booting",{state:s})},{maxAttempts:3,baseDelayMs:500,maxDelayMs:2e3,jitter:.2,shouldRetry:e=>{let r=
|
|
8
|
-
`)}})}catch(u){let a=t?.stdout,n=t?.stderr,o=t?.exitCode,s=i?.stdout,l=i?.stderr,c=i?.exitCode,d=
|
|
5
|
+
${t}`,r=i.indexOf("<?xml"),a=r>=0?r:i.indexOf("<hierarchy");if(a<0)return null;let n=i.lastIndexOf("</hierarchy>");if(n<0||n<a)return null;let o=i.slice(a,n+12).trim();return o.length>0?o:null}function ey(e){if(!(e instanceof p)||"COMMAND_FAILED"!==e.code)return!1;let t=`${e.details?.stderr??""}`.toLowerCase();return!!(t.includes("device offline")||t.includes("device not found")||t.includes("transport error")||t.includes("connection reset")||t.includes("broken pipe")||t.includes("timed out")||t.includes("no such file or directory"))}async function eI(e,t,i,r){let a=Math.max(1,Math.floor(i));for(let i=0;i<t.length;i+=a){let n=t.slice(i,i+a);await es(e,n),r>0&&i+a<t.length&&await eD(r)}}async function eb(e,t){let i=Math.max(0,t);await m("adb",j(e,["shell","input","keyevent","KEYCODE_MOVE_END"]),{allowFailure:!0});for(let t=0;t<i;t+=24){let r=Math.min(24,i-t);await m("adb",j(e,["shell","input","keyevent",...Array(r).fill("KEYCODE_DEL")]),{allowFailure:!0})}}async function eN(e,t,i){let r,a=await eg(e),n=/<node\b[^>]*>/g,o=null,s=null,l=null;for(;null!==(r=n.exec(a));){let e=P(r[0]),a=B(e.bounds);if(!a)continue;let n=e.className??"",c=(e.text??"").replace(/"/g,'"').replace(/'/g,"'").replace(/</g,"<").replace(/>/g,">").replace(/&/g,"&"),d=e.focused??!1;if(!c)continue;let u=Math.max(1,a.width*a.height),f=t>=a.x&&t<=a.x+a.width&&i>=a.y&&i<=a.y+a.height;if(d&&eS(n)){(!o||u<=o.area)&&(o={text:c,area:u});continue}if(f&&eS(n)){(!s||u<=s.area)&&(s={text:c,area:u});continue}f&&(!l||u<=l.area)&&(l={text:c,area:u})}return o?.text??s?.text??l?.text??null}function eS(e){let t=e.toLowerCase();return t.includes("edittext")||t.includes("textfield")}async function eD(e){await new Promise(t=>setTimeout(t,e))}async function ex(){if("darwin"!==process.platform)throw new p("UNSUPPORTED_PLATFORM","iOS tools are only available on macOS");if(!await w("xcrun"))throw new p("TOOL_MISSING","xcrun not found in PATH");let e=[],t=await m("xcrun",["simctl","list","devices","-j"]);try{let i=JSON.parse(t.stdout);for(let t of Object.values(i.devices))for(let i of t)i.isAvailable&&e.push({platform:"ios",id:i.udid,name:i.name,kind:"simulator",booted:"Booted"===i.state})}catch(e){throw new p("COMMAND_FAILED","Failed to parse simctl devices JSON",void 0,e)}if(await w("xcrun"))try{let t=await m("xcrun",["devicectl","list","devices","--json"]);for(let i of JSON.parse(t.stdout).devices??[])i.platform?.toLowerCase().includes("ios")&&e.push({platform:"ios",id:i.identifier,name:i.name,kind:"device",booted:!0})}catch{}return e}let ek={settings:"com.apple.Preferences"},eO=function(e,t,i){if(!e)return t;let r=Number(e);return Number.isFinite(r)?Math.max(5e3,Math.floor(r)):t}(process.env.AGENT_DEVICE_IOS_BOOT_TIMEOUT_MS,b,5e3),e_=y(process.env.AGENT_DEVICE_RETRY_LOGS);async function eM(e,t){let i=t.trim();if(i.includes("."))return i;let r=ek[i.toLowerCase()];if(r)return r;if("simulator"===e.kind){let r=(await eV(e)).filter(e=>e.name.toLowerCase()===i.toLowerCase());if(1===r.length)return r[0].bundleId;if(r.length>1)throw new p("INVALID_ARGS",`Multiple apps matched "${t}"`,{matches:r})}throw new p("APP_NOT_INSTALLED",`No app found matching "${t}"`)}async function eL(e,t){let i=await eM(e,t);if("simulator"===e.kind){await eU(e),await m("open",["-a","Simulator"],{allowFailure:!0}),await m("xcrun",["simctl","launch",e.id,i]);return}await m("xcrun",["devicectl","device","process","launch","--device",e.id,i])}async function eR(e){"simulator"!==e.kind||"Booted"!==await eG(e.id)&&(await eU(e),await m("open",["-a","Simulator"],{allowFailure:!0}))}async function eE(e,t){let i=await eM(e,t);if("simulator"===e.kind){await eU(e);let t=await m("xcrun",["simctl","terminate",e.id,i],{allowFailure:!0});if(0!==t.exitCode){if(t.stderr.toLowerCase().includes("found nothing to terminate"))return;throw new p("COMMAND_FAILED",`xcrun exited with code ${t.exitCode}`,{cmd:"xcrun",args:["simctl","terminate",e.id,i],stdout:t.stdout,stderr:t.stderr,exitCode:t.exitCode})}return}await m("xcrun",["devicectl","device","process","terminate","--device",e.id,i])}async function eC(e,t){eB(e,"reinstall");let i=await eM(e,t);await eU(e);let r=await m("xcrun",["simctl","uninstall",e.id,i],{allowFailure:!0});if(0!==r.exitCode){let e=`${r.stdout}
|
|
6
|
+
${r.stderr}`.toLowerCase();if(!e.includes("not installed")&&!e.includes("not found")&&!e.includes("no such file"))throw new p("COMMAND_FAILED",`simctl uninstall failed for ${i}`,{stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode})}return{bundleId:i}}async function eT(e,t){eB(e,"reinstall"),await eU(e),await m("xcrun",["simctl","install",e.id,t])}async function eP(e,t,i){let{bundleId:r}=await eC(e,t);return await eT(e,i),{bundleId:r}}async function e$(e,t){if("simulator"===e.kind){await eU(e),await m("xcrun",["simctl","io",e.id,"screenshot",t]);return}await m("xcrun",["devicectl","device","screenshot","--device",e.id,t])}async function eF(e,t,i,r){eB(e,"settings"),await eU(e);let a=t.toLowerCase(),n=function(e){let t=e.toLowerCase();if("on"===t||"true"===t||"1"===t)return!0;if("off"===t||"false"===t||"0"===t)return!1;throw new p("INVALID_ARGS",`Invalid setting state: ${e}`)}(i);switch(a){case"wifi":return void await m("xcrun",["simctl","status_bar",e.id,"override","--wifiMode",n?"active":"failed"]);case"airplane":n?await m("xcrun",["simctl","status_bar",e.id,"override","--dataNetwork","hide","--wifiMode","failed","--wifiBars","0","--cellularMode","failed","--cellularBars","0","--operatorName",""]):await m("xcrun",["simctl","status_bar",e.id,"clear"]);return;case"location":if(!r)throw new p("INVALID_ARGS","location setting requires an active app in session");await m("xcrun",["simctl","privacy",e.id,n?"grant":"revoke","location",r]);return;default:throw new p("INVALID_ARGS",`Unsupported setting: ${t}`)}}function eB(e,t){if("simulator"!==e.kind)throw new p("UNSUPPORTED_OPERATION",`${t} is only supported on iOS simulators in v1`)}async function eV(e){let t=(await m("xcrun",["simctl","listapps",e.id],{allowFailure:!0})).stdout.trim();if(!t)return[];let i=null;if(t.startsWith("{"))try{i=JSON.parse(t)}catch{i=null}if(!i&&t.startsWith("{"))try{let e=await m("plutil",["-convert","json","-o","-","-"],{allowFailure:!0,stdin:t});0===e.exitCode&&e.stdout.trim().startsWith("{")&&(i=JSON.parse(e.stdout))}catch{i=null}return i?Object.entries(i).map(([e,t])=>({bundleId:e,name:t.CFBundleDisplayName??t.CFBundleName??e})):[]}async function eU(e){let t,i;if("simulator"!==e.kind||"Booted"===await eG(e.id))return;let r=S.fromTimeoutMs(eO);try{await D(async({deadline:r})=>{if(r?.isExpired())throw new p("COMMAND_FAILED","iOS simulator boot deadline exceeded",{timeoutMs:eO});let a=Math.max(1e3,r?.remainingMs()??eO);t=await m("xcrun",["simctl","boot",e.id],{allowFailure:!0,timeoutMs:a});let n=`${t.stdout}
|
|
7
|
+
${t.stderr}`.toLowerCase(),o=n.includes("already booted")||n.includes("current state: booted");if(0!==t.exitCode&&!o)throw new p("COMMAND_FAILED","simctl boot failed",{stdout:t.stdout,stderr:t.stderr,exitCode:t.exitCode});if(i=await m("xcrun",["simctl","bootstatus",e.id,"-b"],{allowFailure:!0,timeoutMs:a}),0!==i.exitCode)throw new p("COMMAND_FAILED","simctl bootstatus failed",{stdout:i.stdout,stderr:i.stderr,exitCode:i.exitCode});let s=await eG(e.id);if("Booted"!==s)throw new p("COMMAND_FAILED","Simulator is still booting",{state:s})},{maxAttempts:3,baseDelayMs:500,maxDelayMs:2e3,jitter:.2,shouldRetry:e=>{let r=k({error:e,stdout:i?.stdout??t?.stdout,stderr:i?.stderr??t?.stderr,context:{platform:"ios",phase:"boot"}});return"IOS_BOOT_TIMEOUT"!==r&&"CI_RESOURCE_STARVATION_SUSPECTED"!==r}},{deadline:r,phase:"boot",classifyReason:e=>k({error:e,stdout:i?.stdout??t?.stdout,stderr:i?.stderr??t?.stderr,context:{platform:"ios",phase:"boot"}}),onEvent:e=>{e_&&process.stderr.write(`[agent-device][retry] ${JSON.stringify(e)}
|
|
8
|
+
`)}})}catch(u){let a=t?.stdout,n=t?.stderr,o=t?.exitCode,s=i?.stdout,l=i?.stderr,c=i?.exitCode,d=k({error:u,stdout:s??a,stderr:l??n,context:{platform:"ios",phase:"boot"}});throw new p("COMMAND_FAILED","iOS simulator failed to boot",{platform:"ios",deviceId:e.id,timeoutMs:eO,elapsedMs:r.elapsedMs(),reason:d,hint:O(d),boot:t?{exitCode:o,stdout:a,stderr:n}:void 0,bootstatus:i?{exitCode:c,stdout:s,stderr:l}:void 0})}}async function eG(e){let t=await m("xcrun",["simctl","list","devices","-j"],{allowFailure:!0,timeoutMs:I});if(0!==t.exitCode)return null;try{let i=JSON.parse(t.stdout);for(let t of Object.values(i.devices??{})){let i=t.find(t=>t.udid===e);if(i)return i.state}}catch{}return null}let ej=new Map,eq=eJ(process.env.AGENT_DEVICE_RUNNER_STARTUP_TIMEOUT_MS,12e4,5e3),eW=eJ(process.env.AGENT_DEVICE_RUNNER_COMMAND_TIMEOUT_MS,15e3,1e3);function eJ(e,t,i){if(!e)return t;let r=Number(e);return Number.isFinite(r)?Math.max(i,Math.floor(r)):t}async function eH(e,t,i={}){var r;return"snapshot"===(r=t.command)||"findText"===r||"listTappables"===r||"alert"===r?x(()=>ez(e,t,i),{shouldRetry:e4}):ez(e,t,i)}async function ez(e,t,i={}){if("simulator"!==e.kind)throw new p("UNSUPPORTED_OPERATION","iOS runner only supports simulators in v1");try{let r=await eQ(e,i),a=r.ready?eW:eq;return await eX(e,r,t,i.logPath,a)}catch(a){let r=a instanceof p?a:new p("COMMAND_FAILED",String(a));if("COMMAND_FAILED"===r.code&&"string"==typeof r.message&&r.message.includes("Runner did not accept connection")){await eY(e.id);let r=await eQ(e,i),a=await e5(r.device,r.port,t,i.logPath,eq);return await eK(a,r,i.logPath)}throw a}}async function eX(e,t,i,r,a){let n=await e5(e,t.port,i,r,a);return await eK(n,t,r)}async function eK(e,t,i){let r=await e.text(),a={};try{a=JSON.parse(r)}catch{throw new p("COMMAND_FAILED","Invalid runner response",{text:r})}if(!a.ok)throw new p("COMMAND_FAILED",a.error?.message??"Runner error",{runner:a,xcodebuild:{exitCode:1,stdout:"",stderr:""},logPath:i});return t.ready=!0,a.data??{}}async function eY(e){let t=ej.get(e);if(t){try{await e5(t.device,t.port,{command:"shutdown"},void 0,15e3)}catch{await e0(t.child.pid,"SIGTERM")}try{await Promise.race([t.testPromise,new Promise(e=>setTimeout(e,1e4))])}catch{}await e0(t.child.pid,"SIGKILL"),e9(t.xctestrunPath),e9(t.jsonPath),ej.delete(e)}}async function eZ(e){await m("xcrun",["simctl","bootstatus",e,"-b"],{allowFailure:!0,timeoutMs:eq})}async function eQ(e,t){let i=ej.get(e.id);if(i)return i;await eZ(e.id);let r=await e1(e.id,t),a=await e7(),{xctestrunPath:n,jsonPath:o}=await e6(r,{AGENT_DEVICE_RUNNER_PORT:String(a)},`session-${e.id}-${a}`),{child:s,wait:l}=d("xcodebuild",["test-without-building","-only-testing","AgentDeviceRunnerUITests/RunnerTests/testCommand","-parallel-testing-enabled","NO","-test-timeouts-enabled","NO","-maximum-concurrent-test-simulator-destinations","1","-xctestrun",n,"-destination",`platform=iOS Simulator,id=${e.id}`],{allowFailure:!0,env:{...process.env,AGENT_DEVICE_RUNNER_PORT:String(a)}});s.stdout?.on("data",e=>{e3(e,t.logPath,t.traceLogPath,t.verbose)}),s.stderr?.on("data",e=>{e3(e,t.logPath,t.traceLogPath,t.verbose)});let c={device:e,deviceId:e.id,port:a,xctestrunPath:n,jsonPath:o,testPromise:l,child:s,ready:!1};return ej.set(e.id,c),c}async function e0(e,t){if(!e||e<=0)return;try{process.kill(e,t)}catch{}let i="SIGTERM"===t?"TERM":"KILL";try{await m("pkill",[`-${i}`,"-P",String(e)],{allowFailure:!0})}catch{}}async function e1(e,t){let i,r=n.join(f.homedir(),".agent-device","ios-runner"),a=n.join(r,"derived");if((i=process.env.AGENT_DEVICE_IOS_CLEAN_DERIVED)&&["1","true","yes","on"].includes(i.toLowerCase()))try{u.rmSync(a,{recursive:!0,force:!0})}catch{}let s=e2(a);if(s)return s;let l=function(){let e=n.dirname(c(import.meta.url)),t=e;for(let e=0;e<6;e+=1){let e=n.join(t,"package.json");if(u.existsSync(e))return t;t=n.dirname(t)}return e}(),d=n.join(l,"ios-runner","AgentDeviceRunner","AgentDeviceRunner.xcodeproj");if(!u.existsSync(d))throw new p("COMMAND_FAILED","iOS runner project not found",{projectPath:d});try{await o("xcodebuild",["build-for-testing","-project",d,"-scheme","AgentDeviceRunner","-parallel-testing-enabled","NO","-maximum-concurrent-test-simulator-destinations","1","-destination",`platform=iOS Simulator,id=${e}`,"-derivedDataPath",a],{onStdoutChunk:e=>{e3(e,t.logPath,t.traceLogPath,t.verbose)},onStderrChunk:e=>{e3(e,t.logPath,t.traceLogPath,t.verbose)}})}catch(i){let e=i instanceof p?i:new p("COMMAND_FAILED",String(i));throw new p("COMMAND_FAILED","xcodebuild build-for-testing failed",{error:e.message,details:e.details,logPath:t.logPath})}let m=e2(a);if(!m)throw new p("COMMAND_FAILED","Failed to locate .xctestrun after build");return m}function e2(e){if(!u.existsSync(e))return null;let t=[],i=[e];for(;i.length>0;){let e=i.pop();for(let r of u.readdirSync(e,{withFileTypes:!0})){let a=n.join(e,r.name);if(r.isDirectory()){i.push(a);continue}if(r.isFile()&&r.name.endsWith(".xctestrun"))try{let e=u.statSync(a);t.push({path:a,mtimeMs:e.mtimeMs})}catch{}}}return 0===t.length?null:(t.sort((e,t)=>t.mtimeMs-e.mtimeMs),t[0]?.path??null)}function e3(e,t,i,r){t&&u.appendFileSync(t,e),i&&u.appendFileSync(i,e),r&&process.stderr.write(e)}function e4(e){if(!(e instanceof p)||"COMMAND_FAILED"!==e.code)return!1;let t=`${e.message??""}`.toLowerCase();return!!(t.includes("runner did not accept connection")||t.includes("fetch failed")||t.includes("econnrefused")||t.includes("socket hang up"))}async function e5(e,t,i,r,a=eq){let n=Date.now(),o=null;for(;Date.now()-n<a;)try{return await fetch(`http://127.0.0.1:${t}/command`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(i)})}catch(e){o=e,await new Promise(e=>setTimeout(e,100))}if("simulator"===e.kind){let r=await e8(e.id,t,i);return new Response(r.body,{status:r.status})}throw new p("COMMAND_FAILED","Runner did not accept connection",{port:t,logPath:r,lastError:o?String(o):void 0,reason:k({error:o,message:"Runner did not accept connection",context:{platform:"ios",phase:"connect"}}),hint:O("IOS_RUNNER_CONNECT_TIMEOUT")})}async function e8(e,t,i){let r=JSON.stringify(i),a=await m("xcrun",["simctl","spawn",e,"/usr/bin/curl","-s","-X","POST","-H","Content-Type: application/json","--data",r,`http://127.0.0.1:${t}/command`],{allowFailure:!0}),n=a.stdout;if(0!==a.exitCode){let e=k({message:"Runner did not accept connection (simctl spawn)",stdout:a.stdout,stderr:a.stderr,context:{platform:"ios",phase:"connect"}});throw new p("COMMAND_FAILED","Runner did not accept connection (simctl spawn)",{port:t,stdout:a.stdout,stderr:a.stderr,exitCode:a.exitCode,reason:e,hint:O(e)})}return{status:200,body:n}}async function e7(){return await new Promise((e,t)=>{let i=h.createServer();i.listen(0,"127.0.0.1",()=>{let r=i.address();i.close(),"object"==typeof r&&r?.port?e(r.port):t(new p("COMMAND_FAILED","Failed to allocate port"))}),i.on("error",t)})}async function e6(e,t,i){let r,a=n.dirname(e),o=i.replace(/[^a-zA-Z0-9._-]/g,"_"),s=n.join(a,`AgentDeviceRunner.env.${o}.json`),l=n.join(a,`AgentDeviceRunner.env.${o}.xctestrun`),c=await m("plutil",["-convert","json","-o","-",e],{allowFailure:!0});if(0!==c.exitCode||!c.stdout.trim())throw new p("COMMAND_FAILED","Failed to read xctestrun plist",{xctestrunPath:e,stderr:c.stderr});try{r=JSON.parse(c.stdout)}catch(t){throw new p("COMMAND_FAILED","Failed to parse xctestrun JSON",{xctestrunPath:e,error:String(t)})}let d=e=>{e.EnvironmentVariables={...e.EnvironmentVariables??{},...t},e.UITestEnvironmentVariables={...e.UITestEnvironmentVariables??{},...t},e.UITargetAppEnvironmentVariables={...e.UITargetAppEnvironmentVariables??{},...t},e.TestingEnvironmentVariables={...e.TestingEnvironmentVariables??{},...t}},f=r.TestConfigurations;if(Array.isArray(f))for(let e of f){if(!e||"object"!=typeof e)continue;let t=e.TestTargets;if(Array.isArray(t))for(let e of t)e&&"object"==typeof e&&d(e)}for(let[e,t]of Object.entries(r))t&&"object"==typeof t&&t.TestBundlePath&&(d(t),r[e]=t);u.writeFileSync(s,JSON.stringify(r,null,2));let h=await m("plutil",["-convert","xml1","-o",l,s],{allowFailure:!0});if(0!==h.exitCode)throw new p("COMMAND_FAILED","Failed to write xctestrun plist",{tmpXctestrunPath:l,stderr:h.stderr});return{xctestrunPath:l,jsonPath:s}}function e9(e){try{u.existsSync(e)&&u.unlinkSync(e)}catch{}}async function te(e,t={}){let i,r;if("ios"!==e.platform||"simulator"!==e.kind)throw new p("UNSUPPORTED_OPERATION","AX snapshot is only supported on iOS simulators");let a=await tt(),n=await x(async()=>{var e,i;let r,n,o,s=await m(a,[],{allowFailure:!0});if(t.traceLogPath&&(e=t.traceLogPath,r=((i=s).stdout??"").toString(),n=(i.stderr??"").toString(),o=`
|
|
9
9
|
[axsnapshot] exit=${i.exitCode} stdoutBytes=${r.length} stderrBytes=${n.length}
|
|
10
10
|
`,u.appendFileSync(e,o),(0!==i.exitCode||n.length>0)&&(n.length>0&&u.appendFileSync(e,`${n}
|
|
11
11
|
`),0!==i.exitCode&&r.length>0&&u.appendFileSync(e,`${r}
|
|
12
|
-
`))),0!==s.exitCode){let e,t,i=(s.stderr??"").toString(),r=(e=i.toLowerCase()).includes("accessibility permission")?" Enable Accessibility for your terminal in System Settings > Privacy & Security > Accessibility, or use --backend xctest (slower snapshots via XCTest).":e.includes("could not find ios app content")?" AX snapshot sometimes caches empty content. Try restarting the Simulator app.":"",a=!!((t=i.toLowerCase()).includes("could not find ios app content")||t.includes("timeout"));throw new p("COMMAND_FAILED","AX snapshot failed",{stderr:`${i}${r}`,stdout:s.stdout,retryable:a})}return s},{shouldRetry:e=>{var t;return(t=e)instanceof p&&"COMMAND_FAILED"===t.code&&t.details?.retryable===!0}});try{let e=JSON.parse(n.stdout);if(e&&"object"==typeof e&&"root"in e){if(!e.root)throw Error("AX snapshot missing root");i=e.root,r=e.windowFrame??void 0}else i=e}catch(e){throw new p("COMMAND_FAILED","Invalid AX snapshot JSON",{error:String(e)})}let o=i.frame??r,s=[],l=[],c=(e,t)=>{e.frame&&s.push(e.frame);let i=e.frame&&o?{x:e.frame.x-o.x,y:e.frame.y-o.y,width:e.frame.width,height:e.frame.height}:e.frame;for(let r of(l.push({...e,frame:i,children:void 0,depth:t}),e.children??[]))c(r,t+1)};return c(i,0),{nodes:(function(e,t,i){if(!t||0===i.length)return e;let r=1/0,a=1/0;for(let e of i)e.x<r&&(r=e.x),e.y<a&&(a=e.y);return r<=5&&a<=5?e.map(e=>({...e,frame:e.frame?{x:e.frame.x+t.x,y:e.frame.y+t.y,width:e.frame.width,height:e.frame.height}:void 0})):e})(l,o,s).map((e,t)=>({index:t,type:e.subrole??e.role,label:e.label,value:e.value,identifier:e.identifier,rect:e.frame?{x:e.frame.x,y:e.frame.y,width:e.frame.width,height:e.frame.height}:void 0,depth:e.depth}))}}async function tt(){let e=function(){let e=n.dirname(c(import.meta.url));for(let t=0;t<6;t+=1){let t=n.join(e,"package.json");if(u.existsSync(t))return e;e=n.dirname(e)}return process.cwd()}(),t=n.join(e,"ios-runner","AXSnapshot"),i=process.env.AGENT_DEVICE_AX_BINARY;if(i&&u.existsSync(i))return i;let r=n.join(e,"dist","bin","axsnapshot");if(u.existsSync(r))return r;let a=n.join(t,".build","release","axsnapshot");if(u.existsSync(a))return a;let o=await m("swift",["build","-c","release"],{cwd:t,allowFailure:!0});if(0!==o.exitCode||!u.existsSync(a))throw new p("COMMAND_FAILED","Failed to build AX snapshot tool",{stderr:o.stderr,stdout:o.stdout});return a}async function ti(e){let t={platform:e.platform,deviceName:e.device,udid:e.udid,serial:e.serial};if("android"===t.platform){await eh();let e=await E();return await v(e,t)}if("ios"===t.platform){let e=await ek();return await v(e,t)}let i=[];try{i.push(...await E())}catch{}try{i.push(...await ek())}catch{}return await v(i,t)}async function tr(e,t,i,r,a){let o=function(e,t){switch(e.platform){case"android":return{open:(t,i)=>X(e,t,i?.activity),openDevice:()=>Y(e),close:t=>Z(e,t),tap:(t,i)=>ei(e,t,i),longPress:(t,i,r)=>eo(e,t,i,r),focus:(t,i)=>el(e,t,i),type:t=>es(e,t),fill:(t,i,r)=>ec(e,t,i,r),scroll:(t,i)=>ed(e,t,i),scrollIntoView:t=>eu(e,t),screenshot:t=>ef(e,t)};case"ios":var i,r;let a;return{open:t=>eL(e,t),openDevice:()=>eR(e),close:t=>eE(e,t),screenshot:t=>e$(e,t),...(i=e,a={verbose:(r=t).verbose,logPath:r.logPath,traceLogPath:r.traceLogPath},{tap:async(e,t)=>{await eH(i,{command:"tap",x:e,y:t,appBundleId:r.appBundleId},a)},longPress:async(e,t,n)=>{await eH(i,{command:"longPress",x:e,y:t,durationMs:n,appBundleId:r.appBundleId},a)},focus:async(e,t)=>{await eH(i,{command:"tap",x:e,y:t,appBundleId:r.appBundleId},a)},type:async e=>{await eH(i,{command:"type",text:e,appBundleId:r.appBundleId},a)},fill:async(e,t,n)=>{await eH(i,{command:"tap",x:e,y:t,appBundleId:r.appBundleId},a),await eH(i,{command:"type",text:n,clearFirst:!0,appBundleId:r.appBundleId},a)},scroll:async(e,t)=>{if(!["up","down","left","right"].includes(e))throw new p("INVALID_ARGS",`Unknown direction: ${e}`);let n=function(e){switch(e){case"up":return"down";case"down":return"up";case"left":return"right";case"right":return"left"}}(e);await eH(i,{command:"swipe",direction:n,appBundleId:r.appBundleId},a)},scrollIntoView:async e=>{for(let t=0;t<8;t+=1){let n=await eH(i,{command:"findText",text:e,appBundleId:r.appBundleId},a);if(n?.found)return{attempts:t+1};await eH(i,{command:"swipe",direction:"up",appBundleId:r.appBundleId},a),await new Promise(e=>setTimeout(e,300))}throw new p("COMMAND_FAILED",`scrollintoview could not find text: ${e}`)}})};default:throw new p("UNSUPPORTED_PLATFORM",`Unsupported platform: ${e.platform}`)}}(e,{appBundleId:a?.appBundleId,verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath});switch(t){case"open":{let e=i[0];if(!e)return await o.openDevice(),{app:null};return await o.open(e,{activity:a?.activity}),{app:e}}case"close":{let e=i[0];if(!e)return{closed:"session"};return await o.close(e),{app:e}}case"press":{let[e,t]=i.map(Number);if(Number.isNaN(e)||Number.isNaN(t))throw new p("INVALID_ARGS","press requires x y");return await o.tap(e,t),{x:e,y:t}}case"long-press":{let e=Number(i[0]),t=Number(i[1]),r=i[2]?Number(i[2]):void 0;if(Number.isNaN(e)||Number.isNaN(t))throw new p("INVALID_ARGS","long-press requires x y [durationMs]");return await o.longPress(e,t,r),{x:e,y:t,durationMs:r}}case"focus":{let[e,t]=i.map(Number);if(Number.isNaN(e)||Number.isNaN(t))throw new p("INVALID_ARGS","focus requires x y");return await o.focus(e,t),{x:e,y:t}}case"type":{let e=i.join(" ");if(!e)throw new p("INVALID_ARGS","type requires text");return await o.type(e),{text:e}}case"fill":{let e=Number(i[0]),t=Number(i[1]),r=i.slice(2).join(" ");if(Number.isNaN(e)||Number.isNaN(t)||!r)throw new p("INVALID_ARGS","fill requires x y text");return await o.fill(e,t,r),{x:e,y:t,text:r}}case"scroll":{let e=i[0],t=i[1]?Number(i[1]):void 0;if(!e)throw new p("INVALID_ARGS","scroll requires direction");return await o.scroll(e,t),{direction:e,amount:t}}case"scrollintoview":{let e=i.join(" ").trim();if(!e)throw new p("INVALID_ARGS","scrollintoview requires text");let t=await o.scrollIntoView(e);if(t?.attempts)return{text:e,attempts:t.attempts};return{text:e}}case"pinch":{let t=Number(i[0]),r=i[1]?Number(i[1]):void 0,n=i[2]?Number(i[2]):void 0;if(Number.isNaN(t)||t<=0)throw new p("INVALID_ARGS","pinch requires scale > 0");return await eH(e,{command:"pinch",scale:t,x:r,y:n,appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{scale:t,x:r,y:n}}case"screenshot":{let e=i[0]??r??`./screenshot-${Date.now()}.png`;return await s.mkdir(n.dirname(e),{recursive:!0}),await o.screenshot(e),{path:e}}case"back":if("ios"===e.platform)return await eH(e,{command:"back",appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{action:"back"};return await er(e),{action:"back"};case"home":if("ios"===e.platform)return await eH(e,{command:"home",appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{action:"home"};return await ea(e),{action:"home"};case"app-switcher":if("ios"===e.platform)return await eH(e,{command:"appSwitcher",appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{action:"app-switcher"};return await en(e),{action:"app-switcher"};case"settings":{let[t,r,n]=i;if("ios"===e.platform)return await eF(e,t,r,n??a?.appBundleId),{setting:t,state:r};return await ep(e,t,r),{setting:t,state:r}}case"snapshot":{let t=a?.snapshotBackend??"xctest";if("ios"===e.platform){if("ax"===t)return{nodes:(await te(e,{traceLogPath:a?.traceLogPath})).nodes??[],truncated:!1,backend:"ax"};let i=await eH(e,{command:"snapshot",appBundleId:a?.appBundleId,interactiveOnly:a?.snapshotInteractiveOnly,compact:a?.snapshotCompact,depth:a?.snapshotDepth,scope:a?.snapshotScope,raw:a?.snapshotRaw},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),r=i.nodes??[];if(0===r.length)try{return{nodes:(await te(e,{traceLogPath:a?.traceLogPath})).nodes??[],truncated:!1,backend:"ax"}}catch{}return{nodes:r,truncated:i.truncated??!1,backend:"xctest"}}let i=await em(e,{interactiveOnly:a?.snapshotInteractiveOnly,compact:a?.snapshotCompact,depth:a?.snapshotDepth,scope:a?.snapshotScope,raw:a?.snapshotRaw});return{nodes:i.nodes??[],truncated:i.truncated??!1,backend:"android"}}default:throw new p("INVALID_ARGS",`Unknown command: ${t}`)}}let ta={alert:{ios:{simulator:!0},android:{}},pinch:{ios:{simulator:!0},android:{}},"app-switcher":{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},apps:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},back:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},boot:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},click:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},close:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},fill:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},find:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},focus:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},get:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},is:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},home:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},"long-press":{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},open:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},reinstall:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},press:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},record:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},screenshot:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},scroll:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},settings:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},snapshot:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},type:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},wait:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}}};function tn(e,t){let i=ta[e];if(!i)return!0;let r=i[t.platform];return!!r&&!0===r[t.kind??"unknown"]}function to(e){let t=e.result?.text;if("string"==typeof t&&t.trim().length>0)return t;let i=e.positionals??[];return 0===i.length?"":i[0].startsWith("@")?i.length>=3?i.slice(2).join(" ").trim():i.slice(1).join(" ").trim():!(i.length>=3)||Number.isNaN(Number(i[0]))||Number.isNaN(Number(i[1]))?i.slice(1).join(" ").trim():i.slice(2).join(" ").trim()}function ts(e){let t=new Set,i=[];for(let r of e)t.has(r)||(t.add(r),i.push(r));return i}function tl(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}class tc{get(e){return this.sessions.get(e)}has(e){return this.sessions.has(e)}set(e,t){this.sessions.set(e,t)}delete(e){return this.sessions.delete(e)}values(){return this.sessions.values()}toArray(){return Array.from(this.sessions.values())}recordAction(e,t){t.flags?.noRecord||(t.flags?.saveScript&&(e.recordSession=!0),e.actions.push({ts:Date.now(),command:t.command,positionals:t.positionals,flags:function(e){if(!e)return{};let{platform:t,device:i,udid:r,serial:a,out:n,verbose:o,snapshotInteractiveOnly:s,snapshotCompact:l,snapshotDepth:c,snapshotScope:d,snapshotRaw:u,snapshotBackend:f,appsMetadata:p,saveScript:m,noRecord:h}=e;return{platform:t,device:i,udid:r,serial:a,out:n,verbose:o,snapshotInteractiveOnly:s,snapshotCompact:l,snapshotDepth:c,snapshotScope:d,snapshotRaw:u,snapshotBackend:f,appsMetadata:p,saveScript:m,noRecord:h}}(t.flags),result:t.result}))}writeSessionLog(e){try{if(!e.recordSession)return;u.existsSync(this.sessionsDir)||u.mkdirSync(this.sessionsDir,{recursive:!0});let t=e.name.replace(/[^a-zA-Z0-9._-]/g,"_"),i=new Date(e.createdAt).toISOString().replace(/[:.]/g,"-"),r=n.join(this.sessionsDir,`${t}-${i}.ad`),a=function(e,t){let i=[],r=e.device.name.replace(/"/g,'\\"'),a=e.device.kind?` kind=${e.device.kind}`:"";for(let n of(i.push(`context platform=${e.device.platform} device="${r}"${a} theme=unknown`),t))n.flags?.noRecord||i.push(function(e){let t=[e.command];if("click"===e.command){let i=e.positionals?.[0];if(i){if(t.push(td(i)),i.startsWith("@")){let i=e.result?.refLabel;"string"==typeof i&&i.trim().length>0&&t.push(td(i))}return t.join(" ")}}if("fill"===e.command){let i=e.positionals?.[0];if(i&&i.startsWith("@")){t.push(td(i));let r=e.result?.refLabel,a=e.positionals.slice(1).join(" ");return"string"==typeof r&&r.trim().length>0&&t.push(td(r)),a&&t.push(td(a)),t.join(" ")}}if("get"===e.command){let i=e.positionals?.[0],r=e.positionals?.[1];if(i&&r){if(t.push(td(i)),t.push(td(r)),r.startsWith("@")){let i=e.result?.refLabel;"string"==typeof i&&i.trim().length>0&&t.push(td(i))}return t.join(" ")}}if("snapshot"===e.command)return e.flags?.snapshotInteractiveOnly&&t.push("-i"),e.flags?.snapshotCompact&&t.push("-c"),"number"==typeof e.flags?.snapshotDepth&&t.push("-d",String(e.flags.snapshotDepth)),e.flags?.snapshotScope&&t.push("-s",td(e.flags.snapshotScope)),e.flags?.snapshotRaw&&t.push("--raw"),e.flags?.snapshotBackend&&t.push("--backend",e.flags.snapshotBackend),t.join(" ");for(let i of e.positionals??[])t.push(td(i));return t.join(" ")}(n));return`${i.join("\n")}
|
|
13
|
-
`}(e,this.buildOptimizedActions(e));u.writeFileSync(r,a)}catch{}}defaultTracePath(e){let t=e.name.replace(/[^a-zA-Z0-9._-]/g,"_"),i=new Date().toISOString().replace(/[:.]/g,"-");return n.join(this.sessionsDir,`${t}-${i}.trace.log`)}static expandHome(e){return e.startsWith("~/")?n.join(f.homedir(),e.slice(2)):n.resolve(e)}buildOptimizedActions(e){let t=[];for(let i of e.actions){if("snapshot"===i.command)continue;let r=Array.isArray(i.result?.selectorChain)&&i.result?.selectorChain.every(e=>"string"==typeof e)?i.result.selectorChain:[];if(r.length>0&&("click"===i.command||"fill"===i.command||"get"===i.command)){let e=r.join(" || ");if("click"===i.command){t.push({...i,positionals:[e]});continue}if("fill"===i.command){let r=to(i);if(r.length>0){t.push({...i,positionals:[e,r]});continue}}if("get"===i.command){let r=i.positionals?.[0];if("text"===r||"attrs"===r){t.push({...i,positionals:[r,e]});continue}}}if("click"===i.command||"fill"===i.command||"get"===i.command){let r=i.result?.refLabel;"string"==typeof r&&r.trim().length>0&&t.push({ts:i.ts,command:"snapshot",positionals:[],flags:{platform:e.device.platform,snapshotInteractiveOnly:!0,snapshotCompact:!0,snapshotScope:r.trim()},result:{scope:r.trim()}})}t.push(i)}return t}constructor(e){tl(this,"sessions",new Map),tl(this,"sessionsDir",void 0),this.sessionsDir=e}}function td(e){let t=e.trim();return t.startsWith("@")||/^-?\d+(\.\d+)?$/.test(t)?t:JSON.stringify(t)}function tu(e,t,i,r){return{appBundleId:i,activity:t?.activity,verbose:t?.verbose,logPath:e,traceLogPath:r,snapshotInteractiveOnly:t?.snapshotInteractiveOnly,snapshotCompact:t?.snapshotCompact,snapshotDepth:t?.snapshotDepth,snapshotScope:t?.snapshotScope,snapshotRaw:t?.snapshotRaw,snapshotBackend:t?.snapshotBackend}}async function tf(e){if("ios"===e.platform&&"simulator"===e.kind){let{ensureBootedSimulator:t}=await Promise.resolve().then(()=>({ensureBootedSimulator:eV}));await t(e);return}if("android"===e.platform){let{waitForAndroidBoot:t}=await Promise.resolve().then(()=>({waitForAndroidBoot:P}));await t(e.id)}}function tp(e){return e.map((e,t)=>({...e,ref:`e${t+1}`}))}function tm(e){let t=e.trim();return t.startsWith("@")?t.slice(1)||null:t.startsWith("e")?t:null}function th(e,t){return e.find(e=>e.ref===t)??null}function tw(e){return{x:Math.round(e.x+e.width/2),y:Math.round(e.y+e.height/2)}}function tg(e,t){let i=t.toLowerCase();return e.find(e=>{let t=(e.label??"").toLowerCase(),r=(e.value??"").toLowerCase(),a=(e.identifier??"").toLowerCase();return t.includes(i)||r.includes(i)||a.includes(i)})??null}function tv(e,t){let i=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);return i&&tA(i)?i:function(e,t){if(!e.rect)return;let i=e.rect.y+e.rect.height/2,r=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||!tA(t))continue;let a=Math.abs(e.rect.y+e.rect.height/2-i);(!r||a<r.distance)&&(r={label:t,distance:a})}return r?.label}(e,t)??(i&&tA(i)?i:void 0)}function tA(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function ty(e){let t=[],i=[];for(let r of e){let e=r.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let a=tI(r.type??""),n=[r.label,r.value,r.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0),o=!!n&&tA(n);if(("group"===a||"ioscontentgroup"===a)&&!o){t.push(e);continue}let s=Math.max(0,e-t.length);i.push({...r,depth:s})}return i}function tI(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase();return t.startsWith("ax")&&(t=t.replace(/^ax/,"")),t}function tb(e,t){let i=tI(e);return!i||("android"===t?i.includes("edittext")||i.includes("autocompletetextview"):i.includes("textfield")||i.includes("securetextfield")||i.includes("searchfield")||i.includes("textview")||i.includes("textarea")||"search"===i)}function tN(e){return[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").filter(e=>e.length>0)[0]??""}async function tS(e,t,i,r){let a=tD(await tr(e,"snapshot",[],r?.out,{...tu(t,{...r,snapshotDepth:1,snapshotCompact:!0,snapshotBackend:"ax"},void 0,i)}));if(a?.appName||a?.appBundleId)return{appName:a.appName??a.appBundleId??"unknown",appBundleId:a.appBundleId,source:"snapshot-ax"};let n=tD(await tr(e,"snapshot",[],r?.out,{...tu(t,{...r,snapshotDepth:1,snapshotCompact:!0,snapshotBackend:"xctest"},void 0,i)}));return{appName:n?.appName??n?.appBundleId??"unknown",appBundleId:n?.appBundleId,source:"snapshot-xctest"}}function tD(e){let t=tp(e?.nodes??[]),i=t.find(e=>"application"===tI(e.type??""))??t[0];if(!i)return null;let r=i.label?.trim(),a=i.identifier?.trim();return r||a?{appName:r||void 0,appBundleId:a||void 0}:null}let tk=new Set(["id","role","text","label","value"]),tx=new Set(["visible","hidden","editable","selected","enabled","hittable"]),tO=new Set([...tk,...tx]);function t_(e){let t=e.trim();if(!t)throw new p("INVALID_ARGS","Selector expression cannot be empty");let i=function(e){let t=[],i="",r=null;for(let a=0;a<e.length;a+=1){let n=e[a];if(('"'===n||"'"===n)&&"\\"!==e[a-1]){r?r===n&&(r=null):r=n,i+=n;continue}if(!r&&"|"===n&&"|"===e[a+1]){let r=i.trim();if(!r)throw new p("INVALID_ARGS",`Invalid selector fallback expression: ${e}`);t.push(r),i="",a+=1;continue}i+=n}let a=i.trim();if(!a)throw new p("INVALID_ARGS",`Invalid selector fallback expression: ${e}`);return t.push(a),t}(t);if(0===i.length)throw new p("INVALID_ARGS","Selector expression cannot be empty");return{raw:t,selectors:i.map(e=>(function(e){let t=e.trim();if(!t)throw new p("INVALID_ARGS","Selector segment cannot be empty");let i=function(e){let t=[],i="",r=null;for(let a=0;a<e.length;a+=1){let n=e[a];if(('"'===n||"'"===n)&&"\\"!==e[a-1]){r?r===n&&(r=null):r=n,i+=n;continue}if(!r&&/\s/.test(n)){i.trim().length>0&&t.push(i.trim()),i="";continue}i+=n}if(r)throw new p("INVALID_ARGS",`Unclosed quote in selector: ${e}`);return i.trim().length>0&&t.push(i.trim()),t}(t);if(0===i.length)throw new p("INVALID_ARGS",`Invalid selector segment: ${e}`);return{raw:t,terms:i.map(t$)}})(e))}}function tM(e,t,i){let r=i.requireRect??!1,a=i.requireUnique??!0,n=[];for(let o=0;o<t.selectors.length;o+=1){let s=t.selectors[o],l=e.filter(e=>(!r||!!e.rect)&&tF(e,s,i.platform));if((n.push({selector:s.raw,matches:l.length}),0!==l.length)&&(!a||1===l.length))return{node:l[0],selector:s,selectorIndex:o,matches:l.length,diagnostics:n}}return null}function tL(e,t,i){let r=i.requireRect??!1,a=[];for(let n=0;n<t.selectors.length;n+=1){let o=t.selectors[n],s=e.filter(e=>(!r||!!e.rect)&&tF(e,o,i.platform));if(a.push({selector:o.raw,matches:s.length}),s.length>0)return{selectorIndex:n,selector:o,matches:s.length,diagnostics:a}}return null}function tR(e,t,i){let r=i.unique??!0;if(0===t.length)return`Selector did not match: ${e.raw}`;let a=t.map(e=>`${e.selector} -> ${e.matches}`).join(", ");return r?`Selector did not resolve uniquely (${a})`:`Selector did not match (${a})`}function tE(e){if(0===e.length)return null;let t=0;for(;t<e.length&&function(e){let t=e.trim();if(!t)return!1;if("||"===t)return!0;let i=t.indexOf("=");if(-1!==i){let e=t.slice(0,i).trim().toLowerCase();return tO.has(e)}return tO.has(t.toLowerCase())}(e[t]);)t+=1;if(0===t)return null;let i=e.slice(0,t).join(" ").trim();return i?{selectorExpression:i,rest:e.slice(t)}:null}function tC(e){return!0===e.hittable||!!e.rect&&e.rect.width>0&&e.rect.height>0}function tP(e,t){return tb(e.type??"",t)&&!1!==e.enabled}function tT(e,t,i={}){let r=[],a=tI(e.type??""),n=tj(e.identifier),o=tj(e.label),s=tj(e.value),l=tj(tN(e)),c="fill"===i.action;n&&r.push(`id=${tG(n)}`),a&&o&&r.push(c?`role=${tG(a)} label=${tG(o)} editable=true`:`role=${tG(a)} label=${tG(o)}`),o&&r.push(c?`label=${tG(o)} editable=true`:`label=${tG(o)}`),s&&r.push(c?`value=${tG(s)} editable=true`:`value=${tG(s)}`),l&&l!==o&&l!==s&&r.push(c?`text=${tG(l)} editable=true`:`text=${tG(l)}`),a&&c&&!r.some(e=>e.includes("editable=true"))&&r.push(`role=${tG(a)} editable=true`);let d=ts(r);return 0===d.length&&a&&d.push(c?`role=${tG(a)} editable=true`:`role=${tG(a)}`),0===d.length&&tC(e)&&d.push("visible=true"),d}function t$(e){let t=e.trim();if(!t)throw new p("INVALID_ARGS","Empty selector term");let i=t.indexOf("=");if(-1===i){let i=t.toLowerCase();if(!tx.has(i))throw new p("INVALID_ARGS",`Invalid selector term "${e}", expected key=value`);return{key:i,value:!0}}let r=t.slice(0,i).trim().toLowerCase(),a=t.slice(i+1).trim();if(!tO.has(r))throw new p("INVALID_ARGS",`Unknown selector key: ${r}`);if(!a)throw new p("INVALID_ARGS",`Missing selector value for key: ${r}`);if(tx.has(r)){let e,t="true"===(e=tB(a).toLowerCase())||"false"!==e&&null;if(null===t)throw new p("INVALID_ARGS",`Invalid boolean value for ${r}: ${a}`);return{key:r,value:t}}return{key:r,value:tB(a)}}function tF(e,t,i){return t.terms.every(t=>(function(e,t,i){switch(t.key){case"id":return tU(e.identifier,String(t.value));case"role":var r,a;return r=e.type,a=String(t.value),function(e){return tI(e)}(r??"")===function(e){return tI(e)}(a);case"label":return tU(e.label,String(t.value));case"value":return tU(e.value,String(t.value));case"text":{let i=tV(String(t.value));return tV(tN(e))===i}case"visible":return tC(e)===!!t.value;case"hidden":return!tC(e)==!!t.value;case"editable":return tP(e,i)===!!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,i))}function tB(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1).replace(/\\(["'])/g,"$1"):t}function tU(e,t){return tV(e??"")===tV(t)}function tV(e){return e.trim().toLowerCase().replace(/\s+/g," ")}function tG(e){return JSON.stringify(e)}function tj(e){if(!e)return null;let t=e.trim();return t||null}function tq(e){return!!(e?.platform||e?.device||e?.udid||e?.serial)}async function tW(e){let t=e.session?.device??await ti(e.flags??{});return!1!==e.ensureReady&&await e.ensureReadyFn(t),t}let tJ={ios:async(e,t,i)=>{let{reinstallIosApp:r}=await Promise.resolve().then(()=>({reinstallIosApp:eT}));return await r(e,t,i)},android:async(e,t,i)=>{let{reinstallAndroidApp:r}=await Promise.resolve().then(()=>({reinstallAndroidApp:et}));return await r(e,t,i)}};async function tH(e){let{req:t,sessionName:i,logPath:r,sessionStore:a,invoke:n,dispatch:o,ensureReady:s,reinstallOps:c=tJ}=e,d=o??tr,f=s??tf,m=t.command;if("session_list"===m)return{ok:!0,data:{sessions:a.toArray().map(e=>({name:e.name,platform:e.device.platform,device:e.device.name,id:e.device.id,createdAt:e.createdAt}))}};if("devices"===m)try{let e=[];if(t.flags?.platform==="android"){let{listAndroidDevices:t}=await Promise.resolve().then(()=>({listAndroidDevices:E}));e.push(...await t())}else if(t.flags?.platform==="ios"){let{listIosDevices:t}=await Promise.resolve().then(()=>({listIosDevices:ek}));e.push(...await t())}else{let{listAndroidDevices:t}=await Promise.resolve().then(()=>({listAndroidDevices:E})),{listIosDevices:i}=await Promise.resolve().then(()=>({listIosDevices:ek}));try{e.push(...await t())}catch{}try{e.push(...await i())}catch{}}return{ok:!0,data:{devices:e}}}catch(t){let e=l(t);return{ok:!1,error:{code:e.code,message:e.message,details:e.details}}}if("apps"===m){let e=a.get(i),r=t.flags??{};if(!e&&!tq(r))return{ok:!1,error:{code:"INVALID_ARGS",message:"apps requires an active session or an explicit device selector (e.g. --platform ios)."}};let n=await tW({session:e,flags:r,ensureReadyFn:f,ensureReady:!0});if(!tn("apps",n))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"apps is not supported on this device"}};if("ios"===n.platform){let{listSimulatorApps:e}=await Promise.resolve().then(()=>({listSimulatorApps:eU})),i=await e(n);return t.flags?.appsMetadata?{ok:!0,data:{apps:i}}:{ok:!0,data:{apps:i.map(e=>e.name&&e.name!==e.bundleId?`${e.name} (${e.bundleId})`:e.bundleId)}}}let{listAndroidApps:o,listAndroidAppsMetadata:s}=await Promise.resolve().then(()=>({listAndroidApps:W,listAndroidAppsMetadata:J}));return t.flags?.appsMetadata?{ok:!0,data:{apps:await s(n,t.flags?.appsFilter)}}:{ok:!0,data:{apps:await o(n,t.flags?.appsFilter)}}}if("boot"===m){let e=a.get(i),r=t.flags??{};if(!e&&!tq(r))return{ok:!1,error:{code:"INVALID_ARGS",message:"boot requires an active session or an explicit device selector (e.g. --platform ios)."}};let n=e?.device??await ti(r);return tn("boot",n)?(await f(n),{ok:!0,data:{platform:n.platform,device:n.name,id:n.id,kind:n.kind,booted:!0}}):{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"boot is not supported on this device"}}}if("appstate"===m){let e=a.get(i),n=t.flags??{},o=await tW({session:e,flags:n,ensureReadyFn:f,ensureReady:!0});if("ios"===o.platform){if(e?.appBundleId)return{ok:!0,data:{platform:"ios",appBundleId:e.appBundleId,appName:e.appName??e.appBundleId,source:"session"}};let i=await tS(o,r,e?.trace?.outPath,t.flags);return{ok:!0,data:{platform:"ios",appName:i.appName,appBundleId:i.appBundleId,source:i.source}}}let{getAndroidAppState:s}=await Promise.resolve().then(()=>({getAndroidAppState:H})),l=await s(o);return{ok:!0,data:{platform:"android",package:l.package,activity:l.activity}}}if("reinstall"===m){let e,r=a.get(i),n=t.flags??{};if(!r&&!tq(n))return{ok:!1,error:{code:"INVALID_ARGS",message:"reinstall requires an active session or an explicit device selector (e.g. --platform ios)."}};let o=t.positionals?.[0]?.trim(),s=t.positionals?.[1]?.trim();if(!o||!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"reinstall requires: reinstall <app> <path-to-app-binary>"}};let l=tc.expandHome(s);if(!u.existsSync(l))return{ok:!1,error:{code:"INVALID_ARGS",message:`App binary not found: ${l}`}};let d=await tW({session:r,flags:n,ensureReadyFn:f,ensureReady:!1});if(!tn("reinstall",d))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"reinstall is not supported on this device"}};if("ios"===d.platform){let t=await c.ios(d,o,l);e={platform:"ios",appId:t.bundleId,bundleId:t.bundleId}}else{let t=await c.android(d,o,l);e={platform:"android",appId:t.package,package:t.package}}let p={app:o,appPath:l,...e};return r&&a.recordAction(r,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:p}),{ok:!0,data:p}}if("open"===m){let e;if(a.has(i)){let e,n=a.get(i),o=t.positionals?.[0];if(!n||!o)return{ok:!1,error:{code:"INVALID_ARGS",message:"Session already active. Close it first or pass a new --session name."}};if("ios"===n.device.platform)try{let{resolveIosApp:t}=await Promise.resolve().then(()=>({resolveIosApp:eM}));e=await t(n.device,o)}catch{e=void 0}await d(n.device,"open",t.positionals??[],t.flags?.out,{...tu(r,t.flags,e)});let s={...n,appBundleId:e,appName:o,recordSession:n.recordSession||t.flags?.saveScript===!0,snapshot:void 0};return a.recordAction(s,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:{session:i,appName:o,appBundleId:e}}),a.set(i,s),{ok:!0,data:{session:i,appName:o,appBundleId:e}}}let n=await ti(t.flags??{}),o=a.toArray().find(e=>e.device.id===n.id);if(o)return{ok:!1,error:{code:"DEVICE_IN_USE",message:`Device is already in use by session "${o.name}".`,details:{session:o.name,deviceId:n.id,deviceName:n.name}}};let s=t.positionals?.[0];if("ios"===n.platform)try{let{resolveIosApp:i}=await Promise.resolve().then(()=>({resolveIosApp:eM}));e=await i(n,t.positionals?.[0]??"")}catch{e=void 0}await d(n,"open",t.positionals??[],t.flags?.out,{...tu(r,t.flags,e)});let l={name:i,device:n,createdAt:Date.now(),appBundleId:e,appName:s,recordSession:t.flags?.saveScript===!0,actions:[]};return a.recordAction(l,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:{session:i}}),a.set(i,l),{ok:!0,data:{session:i}}}if("replay"===m){let e=t.positionals?.[0];if(!e)return{ok:!1,error:{code:"INVALID_ARGS",message:"replay requires a path"}};try{let o=tc.expandHome(e),s=u.readFileSync(o,"utf8"),l=s.trimStart()[0];if("{"===l||"["===l)return{ok:!1,error:{code:"INVALID_ARGS",message:"replay accepts .ad script files. JSON replay payloads are no longer supported."}};let c=function(e){let t=[];for(let i of e.split(/\r?\n/)){let e=function(e){let t=e.trim();if(0===t.length||t.startsWith("#"))return null;let i=function(e){let t=[],i=0;for(;i<e.length;){for(;i<e.length&&/\s/.test(e[i]);)i+=1;if(i>=e.length)break;if('"'===e[i]){let r=i+1,a=!1;for(;r<e.length;){let t=e[r];if('"'===t&&!a)break;a="\\"===t&&!a,"\\"!==t&&(a=!1),r+=1}if(r>=e.length)throw new p("INVALID_ARGS",`Invalid replay script line: ${e}`);let n=e.slice(i,r+1);t.push(JSON.parse(n)),i=r+1;continue}let r=i;for(;r<e.length&&!/\s/.test(e[r]);)r+=1;t.push(e.slice(i,r)),i=r}return t}(t);if(0===i.length)return null;let[r,...a]=i;if("context"===r)return null;let n={ts:Date.now(),command:r,positionals:[],flags:{}};if("snapshot"===r){n.positionals=[];for(let e=0;e<a.length;e+=1){let t=a[e];if("-i"===t){n.flags.snapshotInteractiveOnly=!0;continue}if("-c"===t){n.flags.snapshotCompact=!0;continue}if("--raw"===t){n.flags.snapshotRaw=!0;continue}if(("-d"===t||"--depth"===t)&&e+1<a.length){let t=Number(a[e+1]);Number.isFinite(t)&&t>=0&&(n.flags.snapshotDepth=Math.floor(t)),e+=1;continue}if(("-s"===t||"--scope"===t)&&e+1<a.length){n.flags.snapshotScope=a[e+1],e+=1;continue}if("--backend"===t&&e+1<a.length){let t=a[e+1];("ax"===t||"xctest"===t)&&(n.flags.snapshotBackend=t),e+=1}}return n}if("click"===r){if(0===a.length)return n;let e=a[0];return e.startsWith("@")?(n.positionals=[e],a[1]&&(n.result={refLabel:a[1]})):n.positionals=[a.join(" ")],n}if("fill"===r){if(a.length<2)return n.positionals=a,n;let e=a[0];return e.startsWith("@")?(a.length>=3?(n.positionals=[e,a.slice(2).join(" ")],n.result={refLabel:a[1]}):n.positionals=[e,a[1]],n):(n.positionals=[e,a.slice(1).join(" ")],n)}if("get"===r){if(a.length<2)return n.positionals=a,n;let e=a[0],t=a[1];return t.startsWith("@")?(n.positionals=[e,t],a[2]&&(n.result={refLabel:a[2]})):n.positionals=[e,a.slice(1).join(" ")],n}return n.positionals=a,n}(i);e&&t.push(e)}return t}(s),f=t.flags?.replayUpdate===!0,m=0;for(let e=0;e<c.length;e+=1){let s=c[e];if(!s||"replay"===s.command)continue;let l=await n({token:t.token,session:i,command:s.command,positionals:s.positionals??[],flags:s.flags??{}});if(l.ok)continue;if(!f)return tz(l,s,e,o);let u=await tX({action:s,sessionName:i,logPath:r,sessionStore:a,dispatch:d});if(!u)return tz(l,s,e,o);if(c[e]=u,!(l=await n({token:t.token,session:i,command:u.command,positionals:u.positionals??[],flags:u.flags??{}})).ok)return tz(l,u,e,o);m+=1}if(f&&m>0){let e=a.get(i);!function(e,t,i){let r=[];if(i){let e=i.device.name.replace(/"/g,'\\"'),t=i.device.kind?` kind=${i.device.kind}`:"";r.push(`context platform=${i.device.platform} device="${e}"${t} theme=unknown`)}for(let e of t)r.push(function(e){let t=[e.command];if("snapshot"===e.command)return e.flags?.snapshotInteractiveOnly&&t.push("-i"),e.flags?.snapshotCompact&&t.push("-c"),"number"==typeof e.flags?.snapshotDepth&&t.push("-d",String(e.flags.snapshotDepth)),e.flags?.snapshotScope&&t.push("-s",tZ(e.flags.snapshotScope)),e.flags?.snapshotRaw&&t.push("--raw"),e.flags?.snapshotBackend&&t.push("--backend",e.flags.snapshotBackend),t.join(" ");for(let i of e.positionals??[])t.push(tZ(i));return t.join(" ")}(e));let a=`${r.join("\n")}
|
|
14
|
-
`,n=`${e}.tmp-${process.pid}-${Date.now()}`;u.writeFileSync(n,a),u.renameSync(n,e)}(o,c,e)}return{ok:!0,data:{replayed:c.length,healed:m,session:i}}}catch(t){let e=l(t);return{ok:!1,error:{code:e.code,message:e.message}}}}if("close"===m){let e=a.get(i);return e?(t.positionals&&t.positionals.length>0&&await d(e.device,"close",t.positionals??[],t.flags?.out,{...tu(r,t.flags,e.appBundleId,e.trace?.outPath)}),"ios"===e.device.platform&&"simulator"===e.device.kind&&await eY(e.device.id),a.recordAction(e,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:{session:i}}),t.flags?.saveScript&&(e.recordSession=!0),a.writeSessionLog(e),a.delete(i),{ok:!0,data:{session:i}}):{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session"}}}return null}function tz(e,t,i,r){var a;let n;if(e.ok)return e;let o=i+1,s=(n=((a=t).positionals??[]).map(e=>{let t=e.trim();return/^-?\d+(\.\d+)?$/.test(t)||t.startsWith("@")?t:JSON.stringify(t)}),[a.command,...n].join(" ")),l={...e.error.details??{},replayPath:r,step:o,action:t.command,positionals:t.positionals??[]};return{ok:!1,error:{code:e.error.code,message:`Replay failed at step ${o} (${s}): ${e.error.message}`,details:l}}}async function tX(e){let{action:t,sessionName:i,logPath:r,sessionStore:a,dispatch:n}=e;if(!["click","fill","get","is","wait"].includes(t.command))return null;let o=a.get(i);if(!o)return null;let s="click"===t.command||"fill"===t.command,l=await tK(o,t,r,s,n,a);for(let e of function(e){let t=[],i=Array.isArray(e.result?.selectorChain)&&e.result?.selectorChain.every(e=>"string"==typeof e)?e.result.selectorChain:[];if(t.push(...i),"click"===e.command){let i=e.positionals?.[0]??"";i&&!i.startsWith("@")&&t.push(e.positionals.join(" "))}if("fill"===e.command){let i=e.positionals?.[0]??"";i&&!i.startsWith("@")&&Number.isNaN(Number(i))&&t.push(i)}if("get"===e.command){let i=e.positionals?.[1]??"";i&&!i.startsWith("@")&&t.push(e.positionals.slice(1).join(" "))}if("is"===e.command){let i=tE(e.positionals.slice(1));i&&t.push(i.selectorExpression)}if("wait"===e.command){let{selectorExpression:i}=tY(e.positionals??[]);i&&t.push(i)}let r="string"==typeof e.result?.refLabel?e.result.refLabel.trim():"";if(r.length>0){let i=JSON.stringify(r);"fill"===e.command?(t.push(`id=${i} editable=true`),t.push(`label=${i} editable=true`),t.push(`text=${i} editable=true`),t.push(`value=${i} editable=true`)):(t.push(`id=${i}`),t.push(`label=${i}`),t.push(`text=${i}`),t.push(`value=${i}`))}return ts(t).filter(e=>e.trim().length>0)}(t)){let i=t_(e),r=tM(l.nodes,i,{platform:o.device.platform,requireRect:s,requireUnique:!0});if(!r)continue;let a=tT(r.node,o.device.platform,{action:"click"===t.command?"click":"fill"===t.command?"fill":"get"}).join(" || ");if("click"===t.command)return{...t,positionals:[a]};if("fill"===t.command){let e=to(t);if(!e)continue;return{...t,positionals:[a,e]}}if("get"===t.command){let e=t.positionals?.[0];if("text"!==e&&"attrs"!==e)continue;return{...t,positionals:[e,a]}}if("is"===t.command){let e=t.positionals?.[0];if(!e)continue;let i=tE(t.positionals.slice(1)),r=i?.rest.join(" ").trim()??"",n=[e,a];return"text"===e&&r.length>0&&n.push(r),{...t,positionals:n}}if("wait"===t.command){let{selectorTimeout:e}=tY(t.positionals??[]),i=[a];return e&&i.push(e),{...t,positionals:i}}}return null}async function tK(e,t,i,r,a,n){let o=await a(e.device,"snapshot",[],t.flags?.out,{...tu(i,{...t.flags??{},snapshotInteractiveOnly:r,snapshotCompact:r},e.appBundleId,e.trace?.outPath)}),s=o?.nodes??[],l={nodes:tp(t.flags?.snapshotRaw?s:ty(s)),truncated:o?.truncated,createdAt:Date.now(),backend:o?.backend};return e.snapshot=l,n.set(e.name,e),l}function tY(e){if(0===e.length)return{selectorExpression:null,selectorTimeout:null};let t=e[e.length-1],i=/^\d+$/.test(t??""),r=tE(i?e.slice(0,-1):e.slice());return!r||r.rest.length>0?{selectorExpression:null,selectorTimeout:null}:{selectorExpression:r.selectorExpression,selectorTimeout:i?t:null}}function tZ(e){let t=e.trim();return t.startsWith("@")||/^-?\d+(\.\d+)?$/.test(t)?t:JSON.stringify(t)}function tQ(e){if(!e)return null;let t=Number(e);return Number.isFinite(t)?t:null}async function t0(e){let{req:t,sessionName:i,logPath:r,sessionStore:a}=e,n=t.command;if("snapshot"===n){let{session:e,device:n}=await t1(a,i,t.flags);if(!tn("snapshot",n))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"snapshot is only supported on iOS simulators in v1"}};let o=e?.appBundleId,s=t.flags?.snapshotScope;if(s&&s.trim().startsWith("@")){if(!e?.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"Ref scope requires an existing snapshot in session."}};let t=tm(s.trim());if(!t)return{ok:!1,error:{code:"INVALID_ARGS",message:`Invalid ref scope: ${s}`}};let i=th(e.snapshot.nodes,t),r=i?tv(i,e.snapshot.nodes):void 0;if(!r)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${s} not found or has no label`}};s=r}let l=await tr(n,"snapshot",[],t.flags?.out,{...tu(r,{...t.flags,snapshotScope:s},o,e?.trace?.outPath)}),c=l?.nodes??[],d=tp(t.flags?.snapshotRaw?c:ty(c)),u={nodes:d,truncated:l?.truncated,createdAt:Date.now(),backend:l?.backend},f=e?{...e,snapshot:u}:{name:i,device:n,createdAt:Date.now(),appBundleId:o,snapshot:u,actions:[]};return t2(a,f,t,{nodes:d.length,truncated:l?.truncated??!1}),a.set(i,f),{ok:!0,data:{nodes:d,truncated:l?.truncated??!1,appName:f.appBundleId?f.appName??f.appBundleId:void 0,appBundleId:f.appBundleId}}}if("wait"===n){let e,n,{session:o,device:s}=await t1(a,i,t.flags),l=function(e){if(0===e.length)return null;let t=tQ(e[0]);if(null!==t)return{kind:"sleep",durationMs:t};if("text"===e[0]){let t=tQ(e[e.length-1]);return{kind:"text",text:(null!==t?e.slice(1,-1).join(" "):e.slice(1).join(" ")).trim(),timeoutMs:t}}if(e[0].startsWith("@")){let t=tQ(e[e.length-1]);return{kind:"ref",rawRef:e[0],timeoutMs:t}}let i=tQ(e[e.length-1]),r=tE(null!==i?e.slice(0,-1):e.slice());if(r&&0===r.rest.length){let e=function(e){try{return t_(e)}catch{return null}}(r.selectorExpression);if(e)return{kind:"selector",selector:e,selectorExpression:r.selectorExpression,timeoutMs:i}}return{kind:"text",text:(null!==i?e.slice(0,-1).join(" "):e.join(" ")).trim(),timeoutMs:i}}(t.positionals??[]);if(!l)return{ok:!1,error:{code:"INVALID_ARGS",message:"wait requires a duration or text"}};if("sleep"===l.kind)return await new Promise(e=>setTimeout(e,l.durationMs)),t2(a,o,t,{waitedMs:l.durationMs}),{ok:!0,data:{waitedMs:l.durationMs}};if(!tn("wait",s))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"wait is not supported on this device"}};if("selector"===l.kind){let e=l.timeoutMs??1e4,n=Date.now();for(;Date.now()-n<e;){let e=await tr(s,"snapshot",[],t.flags?.out,{...tu(r,{...t.flags,snapshotInteractiveOnly:!1,snapshotCompact:!1},o?.appBundleId,o?.trace?.outPath)}),c=e?.nodes??[],d=tp(t.flags?.snapshotRaw?c:ty(c));o&&(o.snapshot={nodes:d,truncated:e?.truncated,createdAt:Date.now(),backend:e?.backend},a.set(i,o));let u=tL(d,l.selector,{platform:s.platform});if(u)return t2(a,o,t,{selector:u.selector.raw,waitedMs:Date.now()-n}),{ok:!0,data:{selector:u.selector.raw,waitedMs:Date.now()-n}};await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:`wait timed out for selector: ${l.selectorExpression}`}}}if("ref"===l.kind){if(!o?.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"Ref wait requires an existing snapshot in session."}};let t=tm(l.rawRef);if(!t)return{ok:!1,error:{code:"INVALID_ARGS",message:`Invalid ref: ${l.rawRef}`}};let i=th(o.snapshot.nodes,t),r=i?tv(i,o.snapshot.nodes):void 0;if(!r)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${l.rawRef} not found or has no label`}};e=r,n=l.timeoutMs}else e=l.text,n=l.timeoutMs;if(!e)return{ok:!1,error:{code:"INVALID_ARGS",message:"wait requires text"}};let c=n??1e4,d=Date.now();for(;Date.now()-d<c;){if("ios"===s.platform&&"simulator"===s.kind){let i=await eH(s,{command:"findText",text:e,appBundleId:o?.appBundleId},{verbose:t.flags?.verbose,logPath:r,traceLogPath:o?.trace?.outPath});if(i?.found)return t2(a,o,t,{text:e,waitedMs:Date.now()-d}),{ok:!0,data:{text:e,waitedMs:Date.now()-d}}}else if("android"===s.platform&&tg(tp((await em(s,{scope:e})).nodes??[]),e))return t2(a,o,t,{text:e,waitedMs:Date.now()-d}),{ok:!0,data:{text:e,waitedMs:Date.now()-d}};await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:`wait timed out for text: ${e}`}}}if("alert"===n){let{session:e,device:n}=await t1(a,i,t.flags),o=(t.positionals?.[0]??"get").toLowerCase();if(!tn("alert",n))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"alert is only supported on iOS simulators in v1"}};if("wait"===o){let i=tQ(t.positionals?.[1])??1e4,o=Date.now();for(;Date.now()-o<i;){try{let i=await eH(n,{command:"alert",action:"get",appBundleId:e?.appBundleId},{verbose:t.flags?.verbose,logPath:r,traceLogPath:e?.trace?.outPath});return t2(a,e,t,i),{ok:!0,data:i}}catch{}await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:"alert wait timed out"}}}let s=await eH(n,{command:"alert",action:"accept"===o||"dismiss"===o?o:"get",appBundleId:e?.appBundleId},{verbose:t.flags?.verbose,logPath:r,traceLogPath:e?.trace?.outPath});return t2(a,e,t,s),{ok:!0,data:s}}if("settings"===n){let e=t.positionals?.[0],n=t.positionals?.[1];if(!e||!n)return{ok:!1,error:{code:"INVALID_ARGS",message:"settings requires <wifi|airplane|location> <on|off>"}};let{session:o,device:s}=await t1(a,i,t.flags),l=o?.appBundleId,c=await tr(s,"settings",[e,n,l??""],t.flags?.out,{...tu(r,t.flags,l,o?.trace?.outPath)});return t2(a,o,t,c??{setting:e,state:n}),{ok:!0,data:c??{setting:e,state:n}}}return null}async function t1(e,t,i){let r=e.get(t),a=r?.device??await ti(i??{});return r||await tf(a),{session:r,device:a}}function t2(e,t,i,r){t&&e.recordAction(t,{command:i.command,positionals:i.positionals??[],flags:i.flags??{},result:r})}function t3(e,t,i,r={}){let a=t5(i);if(!a)return{matches:[],score:0};let n=0,o=[];for(let i of e){if(r.requireRect&&!i.rect)continue;let e=function(e,t,i){switch(t){case"role":return function(e,t){let i=function(e){let t=e.trim();return t?((t=(t.split(".").pop()??t).replace(/XCUIElementType/gi,"").toLowerCase()).startsWith("ax")&&(t=t.replace(/^ax/,"")),t):""}(e??"");return i?i===t?2:+!!i.includes(t):0}(e.type,i);case"label":return t4(e.label,i);case"value":return t4(e.value,i);case"id":return t4(e.identifier,i);default:return Math.max(t4(e.label,i),t4(e.value,i),t4(e.identifier,i))}}(i,t,a);if(!(e<=0)){if(e>n){n=e,o.length=0,o.push(i);continue}e===n&&o.push(i)}}return{matches:o,score:n}}function t4(e,t){let i=t5(e??"");return i?i===t?2:+!!i.includes(t):0}function t5(e){return e.trim().toLowerCase().replace(/\s+/g," ")}async function t8(e){let{req:t,sessionName:i,logPath:r,sessionStore:a,invoke:n}=e,o=t.command;if("find"!==o)return null;let s=t.positionals??[];if(0===s.length)return{ok:!1,error:{code:"INVALID_ARGS",message:"find requires a locator or text"}};let{locator:l,query:c,action:d,value:u,timeoutMs:f}=function(e){let t="any",i=0;["text","label","value","role","id"].includes(e[0])&&(t=e[0],i=1);let r=e[i]??"",a=e.slice(i+1);if(0===a.length)return{locator:t,query:r,action:"click"};let n=a[0].toLowerCase();if("get"===n){let e=a[1]?.toLowerCase();if("text"===e)return{locator:t,query:r,action:"get_text"};if("attrs"===e)return{locator:t,query:r,action:"get_attrs"};throw new p("INVALID_ARGS","find get only supports text or attrs")}if("wait"===n)return{locator:t,query:r,action:"wait",timeoutMs:tQ(a[1])??void 0};if("exists"===n)return{locator:t,query:r,action:"exists"};if("click"===n)return{locator:t,query:r,action:"click"};if("focus"===n)return{locator:t,query:r,action:"focus"};if("fill"===n)return{locator:t,query:r,action:"fill",value:a.slice(1).join(" ")};if("type"===n)return{locator:t,query:r,action:"type",value:a.slice(1).join(" ")};throw new p("INVALID_ARGS",`Unsupported find action: ${a[0]}`)}(s);if(!c)return{ok:!1,error:{code:"INVALID_ARGS",message:"find requires a value"}};let m=a.get(i);if(!m&&"exists"!==d&&"wait"!==d&&"get_text"!==d&&"get_attrs"!==d)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let h=m?.device??await ti(t.flags??{});m||await tf(h);let w=m?.appBundleId,g="role"!==l?c:void 0,v="click"===d||"focus"===d||"fill"===d||"type"===d,A=0,y=null,I=async()=>{let e=Date.now();if(y&&e-A<750)return{nodes:y};let n=await tr(h,"snapshot",[],t.flags?.out,{...tu(r,{...t.flags,snapshotScope:g,snapshotInteractiveOnly:v,snapshotCompact:v},w,m?.trace?.outPath)}),o=n?.nodes??[],s=tp(t.flags?.snapshotRaw?o:ty(o));return A=e,y=s,m&&(m.snapshot={nodes:s,truncated:n?.truncated,createdAt:Date.now(),backend:n?.backend},a.set(i,m)),{nodes:s,truncated:n?.truncated,backend:n?.backend}};if("wait"===d){let e=f??1e4,i=Date.now();for(;Date.now()-i<e;){let{nodes:e}=await I();if(t3(e,l,c,{requireRect:!1}).matches[0])return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{found:!0,waitedMs:Date.now()-i}}),{ok:!0,data:{found:!0,waitedMs:Date.now()-i}};await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:"find wait timed out"}}}let{nodes:b}=await I(),N=t3(b,l,c,{requireRect:v});if(v&&N.matches.length>1){let e=N.matches.slice(0,8).map(e=>{let t=tN(e)||e.label||e.identifier||e.type||"";return`@${e.ref}${t?`(${t})`:""}`});return{ok:!1,error:{code:"AMBIGUOUS_MATCH",message:`find matched ${N.matches.length} elements for ${l} "${c}". Use a more specific locator or selector.`,details:{locator:l,query:c,matches:N.matches.length,candidates:e}}}}let S=N.matches[0]??null;if(!S)return{ok:!1,error:{code:"COMMAND_FAILED",message:"find did not match any element"}};let D="click"===d||"focus"===d||"fill"===d||"type"===d?function(e,t){if(t.hittable)return t;let i=t,r=new Set;for(;void 0!==i.parentIndex&&!r.has(i.ref);){r.add(i.ref);let t=e[i.parentIndex];if(!t)break;if(t.hittable)return t;i=t}return null}(b,S)??S:S,k=`@${D.ref}`,x={...t.flags??{},noRecord:!0};if("exists"===d)return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{found:!0}}),{ok:!0,data:{found:!0}};if("get_text"===d){let e=tN(S);return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:k,action:"get text",text:e}}),{ok:!0,data:{ref:k,text:e,node:S}}}if("get_attrs"===d)return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:k,action:"get attrs"}}),{ok:!0,data:{ref:k,node:S}};if("click"===d){let e=await n({token:t.token,session:i,command:"click",positionals:[k],flags:x});return e.ok&&m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:k,action:"click"}}),e}if("fill"===d){if(!u)return{ok:!1,error:{code:"INVALID_ARGS",message:"find fill requires text"}};let e=await n({token:t.token,session:i,command:"fill",positionals:[k,u],flags:x});return e.ok&&m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:k,action:"fill"}}),e}if("focus"===d){let e=S.rect?tw(S.rect):null;if(!e)return{ok:!1,error:{code:"COMMAND_FAILED",message:"matched element has no bounds"}};let i=await tr(h,"focus",[String(e.x),String(e.y)],t.flags?.out,{...tu(r,t.flags,m?.appBundleId,m?.trace?.outPath)});return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:k,action:"focus"}}),{ok:!0,data:i??{ref:k}}}if("type"===d){if(!u)return{ok:!1,error:{code:"INVALID_ARGS",message:"find type requires text"}};let e=S.rect?tw(S.rect):null;if(!e)return{ok:!1,error:{code:"COMMAND_FAILED",message:"matched element has no bounds"}};await tr(h,"focus",[String(e.x),String(e.y)],t.flags?.out,{...tu(r,t.flags,m?.appBundleId,m?.trace?.outPath)});let i=await tr(h,"type",[u],t.flags?.out,{...tu(r,t.flags,m?.appBundleId,m?.trace?.outPath)});return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:k,action:"type"}}),{ok:!0,data:i??{ref:k}}}return null}async function t7(e){let{req:t,sessionName:i,sessionStore:r}=e,a=t.command;if("record"===a){let e=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(e))return{ok:!1,error:{code:"INVALID_ARGS",message:"record requires start|stop"}};let o=r.get(i),s=o?.device??await ti(t.flags??{});o||await tf(s);let l=o??{name:i,device:s,createdAt:Date.now(),actions:[]};if("start"===e){if(l.recording)return{ok:!1,error:{code:"INVALID_ARGS",message:"recording already in progress"}};let e=t.positionals?.[1]??`./recording-${Date.now()}.mp4`,o=n.resolve(e),c=n.dirname(o);if(u.existsSync(c)||u.mkdirSync(c,{recursive:!0}),!tn("record",s))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"record is only supported on iOS simulators in v1"}};if("ios"===s.platform){let{child:e,wait:t}=d("xcrun",["simctl","io",s.id,"recordVideo",o],{allowFailure:!0});l.recording={platform:"ios",outPath:o,child:e,wait:t}}else{let e=`/sdcard/agent-device-recording-${Date.now()}.mp4`,{child:t,wait:i}=d("adb",["-s",s.id,"shell","screenrecord",e],{allowFailure:!0});l.recording={platform:"android",outPath:o,remotePath:e,child:t,wait:i}}return r.set(i,l),r.recordAction(l,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"start"}}),{ok:!0,data:{recording:"started",outPath:e}}}if(!l.recording)return{ok:!1,error:{code:"INVALID_ARGS",message:"no active recording"}};let c=l.recording;c.child.kill("SIGINT");try{await c.wait}catch{}if("android"===c.platform&&c.remotePath)try{await m("adb",["-s",s.id,"pull",c.remotePath,c.outPath],{allowFailure:!0}),await m("adb",["-s",s.id,"shell","rm","-f",c.remotePath],{allowFailure:!0})}catch{}return l.recording=void 0,r.recordAction(l,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:c.outPath}}),{ok:!0,data:{recording:"stopped",outPath:c.outPath}}}if("trace"===a){let e=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(e))return{ok:!1,error:{code:"INVALID_ARGS",message:"trace requires start|stop"}};let o=r.get(i);if(!o)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session"}};if("start"===e){if(o.trace)return{ok:!1,error:{code:"INVALID_ARGS",message:"trace already in progress"}};let e=t.positionals?.[1]??r.defaultTracePath(o),i=tc.expandHome(e);return u.mkdirSync(n.dirname(i),{recursive:!0}),u.appendFileSync(i,""),o.trace={outPath:i,startedAt:Date.now()},r.recordAction(o,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"start",outPath:i}}),{ok:!0,data:{trace:"started",outPath:i}}}if(!o.trace)return{ok:!1,error:{code:"INVALID_ARGS",message:"no active trace"}};let s=o.trace.outPath;if(t.positionals?.[1]){let e=tc.expandHome(t.positionals[1]);u.mkdirSync(n.dirname(e),{recursive:!0}),u.existsSync(s)?u.renameSync(s,e):u.appendFileSync(e,""),s=e}return o.trace=void 0,r.recordAction(o,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:s}}),{ok:!0,data:{trace:"stopped",outPath:s}}}return null}async function t6(e){let{req:t,sessionName:i,sessionStore:r,contextFromFlags:a}=e,n=t.command;if("click"===n){let e=r.get(i);if(!e)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let o=t.positionals?.[0]??"";if(o.startsWith("@")){if(!e.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"No snapshot in session. Run snapshot first."}};let i=tm(o);if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"click requires a ref like @e2"}};let s=th(e.snapshot.nodes,i);if(!s?.rect&&t.positionals.length>1){let i=t.positionals.slice(1).join(" ").trim();i.length>0&&(s=tg(e.snapshot.nodes,i))}if(!s?.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${o} not found or has no bounds`}};let l=tv(s,e.snapshot.nodes),c=tT(s,e.device.platform,{action:"click"}),{x:d,y:u}=tw(s.rect);return await tr(e.device,"press",[String(d),String(u)],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)}),r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{ref:i,x:d,y:u,refLabel:l,selectorChain:c}}),{ok:!0,data:{ref:i,x:d,y:u}}}let s=(t.positionals??[]).join(" ").trim();if(!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"click requires @ref or selector expression"}};let l=t_(s),c=await t9(e,t.flags,r,a,{interactiveOnly:!0}),d=tM(c.nodes,l,{platform:e.device.platform,requireRect:!0,requireUnique:!0});if(!d||!d.node.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:tR(l,d?.diagnostics??[],{unique:!0})}};let{x:u,y:f}=tw(d.node.rect);await tr(e.device,"press",[String(u),String(f)],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)});let p=tT(d.node,e.device.platform,{action:"click"}),m=tv(d.node,c.nodes);return r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{x:u,y:f,selector:d.selector.raw,selectorChain:p,refLabel:m}}),{ok:!0,data:{selector:d.selector.raw,x:u,y:f}}}if("fill"===n){let e=r.get(i);if(t.positionals?.[0]?.startsWith("@")){if(!e?.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"No snapshot in session. Run snapshot first."}};let i=tm(t.positionals[0]);if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires a ref like @e2"}};let o=t.positionals.length>=3?t.positionals[1]:"",s=t.positionals.length>=3?t.positionals.slice(2).join(" "):t.positionals.slice(1).join(" ");if(!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires text after ref"}};let l=th(e.snapshot.nodes,i);if(!l?.rect&&o&&(l=tg(e.snapshot.nodes,o)),!l?.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${t.positionals[0]} not found or has no bounds`}};let c=l.type??"",d=c&&!tb(c,e.device.platform)?`fill target ${t.positionals[0]} resolved to "${c}", attempting fill anyway.`:void 0,u=tv(l,e.snapshot.nodes),f=tT(l,e.device.platform,{action:"fill"}),{x:p,y:m}=tw(l.rect),h={...await tr(e.device,"fill",[String(p),String(m),s],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)})??{ref:i,x:p,y:m}};return d&&(h.warning=d),r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{...h,refLabel:u,selectorChain:f}}),{ok:!0,data:h}}if(!e)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let o=tE(t.positionals??[]);if(o){if(0===o.rest.length)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires text after selector"}};let i=o.rest.join(" ").trim();if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires text after selector"}};let s=t_(o.selectorExpression),l=await t9(e,t.flags,r,a,{interactiveOnly:!0}),c=tM(l.nodes,s,{platform:e.device.platform,requireRect:!0,requireUnique:!0});if(!c||!c.node.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:tR(s,c?.diagnostics??[],{unique:!0})}};let d=c.node,u=d.type??"",f=u&&!tb(u,e.device.platform)?`fill target ${c.selector.raw} resolved to "${u}", attempting fill anyway.`:void 0,{x:p,y:m}=tw(c.node.rect),h=await tr(e.device,"fill",[String(p),String(m),i],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)}),w=tT(d,e.device.platform,{action:"fill"}),g={...h??{x:p,y:m,text:i},selector:c.selector.raw,selectorChain:w,refLabel:tv(d,l.nodes)};return f&&(g.warning=f),r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:g}),{ok:!0,data:g}}return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires x y text, @ref text, or selector text"}}}if("get"===n){let e=t.positionals?.[0];if("text"!==e&&"attrs"!==e)return{ok:!1,error:{code:"INVALID_ARGS",message:"get only supports text or attrs"}};let o=r.get(i);if(!o)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let s=t.positionals?.[1]??"";if(s.startsWith("@")){if(!o.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"No snapshot in session. Run snapshot first."}};let i=tm(s??"");if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"get text requires a ref like @e2"}};let a=th(o.snapshot.nodes,i);if(!a&&t.positionals.length>2){let e=t.positionals.slice(2).join(" ").trim();e.length>0&&(a=tg(o.snapshot.nodes,e))}if(!a)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${s} not found`}};let l=tT(a,o.device.platform,{action:"get"});if("attrs"===e)return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{ref:i,selectorChain:l}}),{ok:!0,data:{ref:i,node:a}};let c=tN(a);return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{ref:i,text:c,refLabel:c||void 0,selectorChain:l}}),{ok:!0,data:{ref:i,text:c,node:a}}}let l=t.positionals.slice(1).join(" ").trim();if(!l)return{ok:!1,error:{code:"INVALID_ARGS",message:"get requires @ref or selector expression"}};let c=t_(l),d=tM((await t9(o,t.flags,r,a,{interactiveOnly:!1})).nodes,c,{platform:o.device.platform,requireRect:!1,requireUnique:!0});if(!d)return{ok:!1,error:{code:"COMMAND_FAILED",message:tR(c,[],{unique:!0})}};let u=d.node,f=tT(u,o.device.platform,{action:"get"});if("attrs"===e)return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{selector:d.selector.raw,selectorChain:f}}),{ok:!0,data:{selector:d.selector.raw,node:u}};let p=tN(u);return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{text:p,refLabel:p||void 0,selector:d.selector.raw,selectorChain:f}}),{ok:!0,data:{selector:d.selector.raw,text:p,node:u}}}if("is"===n){let e=(t.positionals?.[0]??"").toLowerCase();if(!["visible","hidden","exists","editable","selected","text"].includes(e))return{ok:!1,error:{code:"INVALID_ARGS",message:"is requires predicate: visible|hidden|exists|editable|selected|text"}};let o=r.get(i);if(!o)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};if(!tn("is",o.device))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"is is not supported on this device"}};let s=tE(t.positionals.slice(1));if(!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"is requires a selector expression"}};let l=s.rest.join(" ").trim();if("text"===e&&!l)return{ok:!1,error:{code:"INVALID_ARGS",message:"is text requires expected text value"}};if("text"!==e&&s.rest.length>0)return{ok:!1,error:{code:"INVALID_ARGS",message:`is ${e} does not accept trailing values`}};let c=t_(s.selectorExpression),d=await t9(o,t.flags,r,a,{interactiveOnly:!1});if("exists"===e){let i=tL(d.nodes,c,{platform:o.device.platform});return i?(r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{predicate:e,selector:i.selector.raw,selectorChain:c.selectors.map(e=>e.raw),pass:!0,matches:i.matches}}),{ok:!0,data:{predicate:e,pass:!0,selector:i.selector.raw,matches:i.matches}}):{ok:!1,error:{code:"COMMAND_FAILED",message:tR(c,[],{unique:!1})}}}let u=tM(d.nodes,c,{platform:o.device.platform,requireUnique:!0});if(!u)return{ok:!1,error:{code:"COMMAND_FAILED",message:tR(c,[],{unique:!0})}};let f=function(e){let{predicate:t,node:i,expectedText:r,platform:a}=e,n=tN(i),o=!1;switch(t){case"visible":o=tC(i);break;case"hidden":o=!tC(i);break;case"editable":o=tP(i,a);break;case"selected":o=!0===i.selected;break;case"text":o=n===(r??"")}let s="text"===t?`expected="${r??""}" actual="${n}"`:`actual=${JSON.stringify({visible:tC(i),editable:tP(i,a),selected:!0===i.selected})}`;return{pass:o,actualText:n,details:s}}({predicate:e,node:u.node,expectedText:l,platform:o.device.platform});return f.pass?(r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{predicate:e,selector:u.selector.raw,selectorChain:c.selectors.map(e=>e.raw),pass:!0,text:"text"===e?f.actualText:void 0}}),{ok:!0,data:{predicate:e,pass:!0,selector:u.selector.raw}}):{ok:!1,error:{code:"COMMAND_FAILED",message:`is ${e} failed for selector ${u.selector.raw}: ${f.details}`}}}return null}async function t9(e,t,i,r,a){let n=await tr(e.device,"snapshot",[],t?.out,{...r({...t??{},snapshotInteractiveOnly:a.interactiveOnly,snapshotCompact:a.interactiveOnly},e.appBundleId,e.trace?.outPath)}),o=n?.nodes??[];return e.snapshot={nodes:tp(t?.snapshotRaw?o:ty(o)),truncated:n?.truncated,createdAt:Date.now(),backend:n?.backend},i.set(e.name,e),e.snapshot}let ie=n.join(f.homedir(),".agent-device"),it=n.join(ie,"daemon.json"),ii=n.join(ie,"daemon.log"),ir=new tc(n.join(ie,"sessions")),ia=g(),io=i.randomBytes(24).toString("hex"),is=new Set(["session_list","devices"]);function il(e,t,i){return tu(ii,e,t,i)}async function ic(e){if(e.token!==io)return{ok:!1,error:{code:"UNAUTHORIZED",message:"Invalid token"}};let t=e.command,i=function(e,t){var i;let r,a=e.session||"default";if(i=e,"string"==typeof(r=i.flags?.session)&&r.trim().length>0||"default"!==a||t.has(a))return a;let n=t.toArray();return 1===n.length?n[0].name:a}(e,ir),r=ir.get(i);r&&!is.has(t)&&function(e,t){if(!t)return;let i=[],r=e.device;if(t.platform&&t.platform!==r.platform&&i.push(`--platform=${t.platform}`),t.udid&&("ios"!==r.platform||t.udid!==r.id)&&i.push(`--udid=${t.udid}`),t.serial&&("android"!==r.platform||t.serial!==r.id)&&i.push(`--serial=${t.serial}`),0!==i.length){var a;let t,r,n;throw new p("INVALID_ARGS",`Session "${e.name}" is bound to ${(t=(a=e).device.platform,r=a.device.name.trim(),n=a.device.id,`${t} device "${r}" (${n})`)} and cannot be used with ${i.join(", ")}. Use a different --session name or close this session first.`)}}(r,e.flags);let a=await tH({req:e,sessionName:i,logPath:ii,sessionStore:ir,invoke:ic});if(a)return a;let n=await t0({req:e,sessionName:i,logPath:ii,sessionStore:ir});if(n)return n;let o=await t7({req:e,sessionName:i,sessionStore:ir});if(o)return o;let s=await t8({req:e,sessionName:i,logPath:ii,sessionStore:ir,invoke:ic});if(s)return s;let l=await t6({req:e,sessionName:i,sessionStore:ir,contextFromFlags:il});if(l)return l;let c=ir.get(i);if(!c)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};if(!tn(t,c.device))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:`${t} is not supported on this device`}};let d=await tr(c.device,t,e.positionals??[],e.flags?.out,{...il(e.flags,c.appBundleId,c.trace?.outPath)});return ir.recordAction(c,{command:t,positionals:e.positionals??[],flags:e.flags??{},result:d??{}}),{ok:!0,data:d??{}}}(e=h.createServer(e=>{let t="";e.setEncoding("utf8"),e.on("data",async i=>{let r=(t+=i).indexOf("\n");for(;-1!==r;){let i,a=t.slice(0,r).trim();if(t=t.slice(r+1),0===a.length){r=t.indexOf("\n");continue}try{let e=JSON.parse(a);i=await ic(e)}catch(t){let e=l(t);i={ok:!1,error:{code:e.code,message:e.message,details:e.details}}}e.write(`${JSON.stringify(i)}
|
|
15
|
-
`),r=t.indexOf("\n")}})})).listen(0,"127.0.0.1",()=>{let t=e.address();if("object"==typeof t&&t?.port){var i;i=t.port,u.existsSync(
|
|
16
|
-
`)}}),t=async()=>{for(let e of
|
|
12
|
+
`))),0!==s.exitCode){let e,t,i=(s.stderr??"").toString(),r=(e=i.toLowerCase()).includes("accessibility permission")?" Enable Accessibility for your terminal in System Settings > Privacy & Security > Accessibility, or use --backend xctest (slower snapshots via XCTest).":e.includes("could not find ios app content")?" AX snapshot sometimes caches empty content. Try restarting the Simulator app.":"",a=!!((t=i.toLowerCase()).includes("could not find ios app content")||t.includes("timeout"));throw new p("COMMAND_FAILED","AX snapshot failed",{stderr:`${i}${r}`,stdout:s.stdout,retryable:a})}return s},{shouldRetry:e=>{var t;return(t=e)instanceof p&&"COMMAND_FAILED"===t.code&&t.details?.retryable===!0}});try{let e=JSON.parse(n.stdout);if(e&&"object"==typeof e&&"root"in e){if(!e.root)throw Error("AX snapshot missing root");i=e.root,r=e.windowFrame??void 0}else i=e}catch(e){throw new p("COMMAND_FAILED","Invalid AX snapshot JSON",{error:String(e)})}let o=i.frame??r,s=[],l=[],c=(e,t)=>{e.frame&&s.push(e.frame);let i=e.frame&&o?{x:e.frame.x-o.x,y:e.frame.y-o.y,width:e.frame.width,height:e.frame.height}:e.frame;for(let r of(l.push({...e,frame:i,children:void 0,depth:t}),e.children??[]))c(r,t+1)};return c(i,0),{nodes:(function(e,t,i){if(!t||0===i.length)return e;let r=1/0,a=1/0;for(let e of i)e.x<r&&(r=e.x),e.y<a&&(a=e.y);return r<=5&&a<=5?e.map(e=>({...e,frame:e.frame?{x:e.frame.x+t.x,y:e.frame.y+t.y,width:e.frame.width,height:e.frame.height}:void 0})):e})(l,o,s).map((e,t)=>({index:t,type:e.subrole??e.role,label:e.label,value:e.value,identifier:e.identifier,rect:e.frame?{x:e.frame.x,y:e.frame.y,width:e.frame.width,height:e.frame.height}:void 0,depth:e.depth}))}}async function tt(){let e=function(){let e=n.dirname(c(import.meta.url));for(let t=0;t<6;t+=1){let t=n.join(e,"package.json");if(u.existsSync(t))return e;e=n.dirname(e)}return process.cwd()}(),t=n.join(e,"ios-runner","AXSnapshot"),i=process.env.AGENT_DEVICE_AX_BINARY;if(i&&u.existsSync(i))return i;let r=n.join(e,"dist","bin","axsnapshot");if(u.existsSync(r))return r;let a=n.join(t,".build","release","axsnapshot");if(u.existsSync(a))return a;let o=await m("swift",["build","-c","release"],{cwd:t,allowFailure:!0});if(0!==o.exitCode||!u.existsSync(a))throw new p("COMMAND_FAILED","Failed to build AX snapshot tool",{stderr:o.stderr,stdout:o.stdout});return a}async function ti(e){let t={platform:e.platform,deviceName:e.device,udid:e.udid,serial:e.serial};if("android"===t.platform){await eh();let e=await E();return await v(e,t)}if("ios"===t.platform){let e=await ex();return await v(e,t)}let i=[];try{i.push(...await E())}catch{}try{i.push(...await ex())}catch{}return await v(i,t)}async function tr(e,t,i,r,a){let o=function(e,t){switch(e.platform){case"android":return{open:(t,i)=>X(e,t,i?.activity),openDevice:()=>Y(e),close:t=>Z(e,t),tap:(t,i)=>ei(e,t,i),longPress:(t,i,r)=>eo(e,t,i,r),focus:(t,i)=>el(e,t,i),type:t=>es(e,t),fill:(t,i,r)=>ec(e,t,i,r),scroll:(t,i)=>ed(e,t,i),scrollIntoView:t=>eu(e,t),screenshot:t=>ef(e,t)};case"ios":var i,r;let a;return{open:t=>eL(e,t),openDevice:()=>eR(e),close:t=>eE(e,t),screenshot:t=>e$(e,t),...(i=e,a={verbose:(r=t).verbose,logPath:r.logPath,traceLogPath:r.traceLogPath},{tap:async(e,t)=>{await eH(i,{command:"tap",x:e,y:t,appBundleId:r.appBundleId},a)},longPress:async(e,t,n)=>{await eH(i,{command:"longPress",x:e,y:t,durationMs:n,appBundleId:r.appBundleId},a)},focus:async(e,t)=>{await eH(i,{command:"tap",x:e,y:t,appBundleId:r.appBundleId},a)},type:async e=>{await eH(i,{command:"type",text:e,appBundleId:r.appBundleId},a)},fill:async(e,t,n)=>{await eH(i,{command:"tap",x:e,y:t,appBundleId:r.appBundleId},a),await eH(i,{command:"type",text:n,clearFirst:!0,appBundleId:r.appBundleId},a)},scroll:async(e,t)=>{if(!["up","down","left","right"].includes(e))throw new p("INVALID_ARGS",`Unknown direction: ${e}`);let n=function(e){switch(e){case"up":return"down";case"down":return"up";case"left":return"right";case"right":return"left"}}(e);await eH(i,{command:"swipe",direction:n,appBundleId:r.appBundleId},a)},scrollIntoView:async e=>{for(let t=0;t<8;t+=1){let n=await eH(i,{command:"findText",text:e,appBundleId:r.appBundleId},a);if(n?.found)return{attempts:t+1};await eH(i,{command:"swipe",direction:"up",appBundleId:r.appBundleId},a),await new Promise(e=>setTimeout(e,300))}throw new p("COMMAND_FAILED",`scrollintoview could not find text: ${e}`)}})};default:throw new p("UNSUPPORTED_PLATFORM",`Unsupported platform: ${e.platform}`)}}(e,{appBundleId:a?.appBundleId,verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath});switch(t){case"open":{let e=i[0];if(!e)return await o.openDevice(),{app:null};return await o.open(e,{activity:a?.activity}),{app:e}}case"close":{let e=i[0];if(!e)return{closed:"session"};return await o.close(e),{app:e}}case"press":{let[e,t]=i.map(Number);if(Number.isNaN(e)||Number.isNaN(t))throw new p("INVALID_ARGS","press requires x y");return await o.tap(e,t),{x:e,y:t}}case"long-press":{let e=Number(i[0]),t=Number(i[1]),r=i[2]?Number(i[2]):void 0;if(Number.isNaN(e)||Number.isNaN(t))throw new p("INVALID_ARGS","long-press requires x y [durationMs]");return await o.longPress(e,t,r),{x:e,y:t,durationMs:r}}case"focus":{let[e,t]=i.map(Number);if(Number.isNaN(e)||Number.isNaN(t))throw new p("INVALID_ARGS","focus requires x y");return await o.focus(e,t),{x:e,y:t}}case"type":{let e=i.join(" ");if(!e)throw new p("INVALID_ARGS","type requires text");return await o.type(e),{text:e}}case"fill":{let e=Number(i[0]),t=Number(i[1]),r=i.slice(2).join(" ");if(Number.isNaN(e)||Number.isNaN(t)||!r)throw new p("INVALID_ARGS","fill requires x y text");return await o.fill(e,t,r),{x:e,y:t,text:r}}case"scroll":{let e=i[0],t=i[1]?Number(i[1]):void 0;if(!e)throw new p("INVALID_ARGS","scroll requires direction");return await o.scroll(e,t),{direction:e,amount:t}}case"scrollintoview":{let e=i.join(" ").trim();if(!e)throw new p("INVALID_ARGS","scrollintoview requires text");let t=await o.scrollIntoView(e);if(t?.attempts)return{text:e,attempts:t.attempts};return{text:e}}case"pinch":{let t=Number(i[0]),r=i[1]?Number(i[1]):void 0,n=i[2]?Number(i[2]):void 0;if(Number.isNaN(t)||t<=0)throw new p("INVALID_ARGS","pinch requires scale > 0");return await eH(e,{command:"pinch",scale:t,x:r,y:n,appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{scale:t,x:r,y:n}}case"screenshot":{let e=i[0]??r??`./screenshot-${Date.now()}.png`;return await s.mkdir(n.dirname(e),{recursive:!0}),await o.screenshot(e),{path:e}}case"back":if("ios"===e.platform)return await eH(e,{command:"back",appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{action:"back"};return await er(e),{action:"back"};case"home":if("ios"===e.platform)return await eH(e,{command:"home",appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{action:"home"};return await ea(e),{action:"home"};case"app-switcher":if("ios"===e.platform)return await eH(e,{command:"appSwitcher",appBundleId:a?.appBundleId},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),{action:"app-switcher"};return await en(e),{action:"app-switcher"};case"settings":{let[t,r,n]=i;if("ios"===e.platform)return await eF(e,t,r,n??a?.appBundleId),{setting:t,state:r};return await ep(e,t,r),{setting:t,state:r}}case"snapshot":{let t=a?.snapshotBackend??"xctest";if("ios"===e.platform){if("ax"===t)return{nodes:(await te(e,{traceLogPath:a?.traceLogPath})).nodes??[],truncated:!1,backend:"ax"};let i=await eH(e,{command:"snapshot",appBundleId:a?.appBundleId,interactiveOnly:a?.snapshotInteractiveOnly,compact:a?.snapshotCompact,depth:a?.snapshotDepth,scope:a?.snapshotScope,raw:a?.snapshotRaw},{verbose:a?.verbose,logPath:a?.logPath,traceLogPath:a?.traceLogPath}),r=i.nodes??[];if(0===r.length)try{return{nodes:(await te(e,{traceLogPath:a?.traceLogPath})).nodes??[],truncated:!1,backend:"ax"}}catch{}return{nodes:r,truncated:i.truncated??!1,backend:"xctest"}}let i=await em(e,{interactiveOnly:a?.snapshotInteractiveOnly,compact:a?.snapshotCompact,depth:a?.snapshotDepth,scope:a?.snapshotScope,raw:a?.snapshotRaw});return{nodes:i.nodes??[],truncated:i.truncated??!1,backend:"android"}}default:throw new p("INVALID_ARGS",`Unknown command: ${t}`)}}let ta={alert:{ios:{simulator:!0},android:{}},pinch:{ios:{simulator:!0},android:{}},"app-switcher":{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},apps:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},back:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},boot:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},click:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},close:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},fill:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},find:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},focus:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},get:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},is:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},home:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},"long-press":{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},open:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},reinstall:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},press:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},record:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},screenshot:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},scroll:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},settings:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},snapshot:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},type:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},wait:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}}};function tn(e,t){let i=ta[e];if(!i)return!0;let r=i[t.platform];return!!r&&!0===r[t.kind??"unknown"]}function to(e){let t=e.result?.text;if("string"==typeof t&&t.trim().length>0)return t;let i=e.positionals??[];return 0===i.length?"":i[0].startsWith("@")?i.length>=3?i.slice(2).join(" ").trim():i.slice(1).join(" ").trim():!(i.length>=3)||Number.isNaN(Number(i[0]))||Number.isNaN(Number(i[1]))?i.slice(1).join(" ").trim():i.slice(2).join(" ").trim()}function ts(e){let t=new Set,i=[];for(let r of e)t.has(r)||(t.add(r),i.push(r));return i}function tl(e,t,i){return t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}class tc{get(e){return this.sessions.get(e)}has(e){return this.sessions.has(e)}set(e,t){this.sessions.set(e,t)}delete(e){return this.sessions.delete(e)}values(){return this.sessions.values()}toArray(){return Array.from(this.sessions.values())}recordAction(e,t){t.flags?.noRecord||(t.flags?.saveScript&&(e.recordSession=!0),e.actions.push({ts:Date.now(),command:t.command,positionals:t.positionals,flags:function(e){if(!e)return{};let{platform:t,device:i,udid:r,serial:a,out:n,verbose:o,snapshotInteractiveOnly:s,snapshotCompact:l,snapshotDepth:c,snapshotScope:d,snapshotRaw:u,snapshotBackend:f,appsMetadata:p,saveScript:m,noRecord:h}=e;return{platform:t,device:i,udid:r,serial:a,out:n,verbose:o,snapshotInteractiveOnly:s,snapshotCompact:l,snapshotDepth:c,snapshotScope:d,snapshotRaw:u,snapshotBackend:f,appsMetadata:p,saveScript:m,noRecord:h}}(t.flags),result:t.result}))}writeSessionLog(e){try{if(!e.recordSession)return;u.existsSync(this.sessionsDir)||u.mkdirSync(this.sessionsDir,{recursive:!0});let t=e.name.replace(/[^a-zA-Z0-9._-]/g,"_"),i=new Date(e.createdAt).toISOString().replace(/[:.]/g,"-"),r=n.join(this.sessionsDir,`${t}-${i}.ad`),a=function(e,t){let i=[],r=e.device.name.replace(/"/g,'\\"'),a=e.device.kind?` kind=${e.device.kind}`:"";for(let n of(i.push(`context platform=${e.device.platform} device="${r}"${a} theme=unknown`),t))n.flags?.noRecord||i.push(function(e){let t=[e.command];if("click"===e.command){let i=e.positionals?.[0];if(i){if(t.push(td(i)),i.startsWith("@")){let i=e.result?.refLabel;"string"==typeof i&&i.trim().length>0&&t.push(td(i))}return t.join(" ")}}if("fill"===e.command){let i=e.positionals?.[0];if(i&&i.startsWith("@")){t.push(td(i));let r=e.result?.refLabel,a=e.positionals.slice(1).join(" ");return"string"==typeof r&&r.trim().length>0&&t.push(td(r)),a&&t.push(td(a)),t.join(" ")}}if("get"===e.command){let i=e.positionals?.[0],r=e.positionals?.[1];if(i&&r){if(t.push(td(i)),t.push(td(r)),r.startsWith("@")){let i=e.result?.refLabel;"string"==typeof i&&i.trim().length>0&&t.push(td(i))}return t.join(" ")}}if("snapshot"===e.command)return e.flags?.snapshotInteractiveOnly&&t.push("-i"),e.flags?.snapshotCompact&&t.push("-c"),"number"==typeof e.flags?.snapshotDepth&&t.push("-d",String(e.flags.snapshotDepth)),e.flags?.snapshotScope&&t.push("-s",td(e.flags.snapshotScope)),e.flags?.snapshotRaw&&t.push("--raw"),e.flags?.snapshotBackend&&t.push("--backend",e.flags.snapshotBackend),t.join(" ");for(let i of e.positionals??[])t.push(td(i));return t.join(" ")}(n));return`${i.join("\n")}
|
|
13
|
+
`}(e,this.buildOptimizedActions(e));u.writeFileSync(r,a)}catch{}}defaultTracePath(e){let t=e.name.replace(/[^a-zA-Z0-9._-]/g,"_"),i=new Date().toISOString().replace(/[:.]/g,"-");return n.join(this.sessionsDir,`${t}-${i}.trace.log`)}static expandHome(e){return e.startsWith("~/")?n.join(f.homedir(),e.slice(2)):n.resolve(e)}buildOptimizedActions(e){let t=[];for(let i of e.actions){if("snapshot"===i.command)continue;let r=Array.isArray(i.result?.selectorChain)&&i.result?.selectorChain.every(e=>"string"==typeof e)?i.result.selectorChain:[];if(r.length>0&&("click"===i.command||"fill"===i.command||"get"===i.command)){let e=r.join(" || ");if("click"===i.command){t.push({...i,positionals:[e]});continue}if("fill"===i.command){let r=to(i);if(r.length>0){t.push({...i,positionals:[e,r]});continue}}if("get"===i.command){let r=i.positionals?.[0];if("text"===r||"attrs"===r){t.push({...i,positionals:[r,e]});continue}}}if("click"===i.command||"fill"===i.command||"get"===i.command){let r=i.result?.refLabel;"string"==typeof r&&r.trim().length>0&&t.push({ts:i.ts,command:"snapshot",positionals:[],flags:{platform:e.device.platform,snapshotInteractiveOnly:!0,snapshotCompact:!0,snapshotScope:r.trim()},result:{scope:r.trim()}})}t.push(i)}return t}constructor(e){tl(this,"sessions",new Map),tl(this,"sessionsDir",void 0),this.sessionsDir=e}}function td(e){let t=e.trim();return t.startsWith("@")||/^-?\d+(\.\d+)?$/.test(t)?t:JSON.stringify(t)}function tu(e,t,i,r){return{appBundleId:i,activity:t?.activity,verbose:t?.verbose,logPath:e,traceLogPath:r,snapshotInteractiveOnly:t?.snapshotInteractiveOnly,snapshotCompact:t?.snapshotCompact,snapshotDepth:t?.snapshotDepth,snapshotScope:t?.snapshotScope,snapshotRaw:t?.snapshotRaw,snapshotBackend:t?.snapshotBackend}}async function tf(e){if("ios"===e.platform&&"simulator"===e.kind){let{ensureBootedSimulator:t}=await Promise.resolve().then(()=>({ensureBootedSimulator:eU}));await t(e);return}if("android"===e.platform){let{waitForAndroidBoot:t}=await Promise.resolve().then(()=>({waitForAndroidBoot:T}));await t(e.id)}}function tp(e){return e.map((e,t)=>({...e,ref:`e${t+1}`}))}function tm(e){let t=e.trim();return t.startsWith("@")?t.slice(1)||null:t.startsWith("e")?t:null}function th(e,t){return e.find(e=>e.ref===t)??null}function tw(e){return{x:Math.round(e.x+e.width/2),y:Math.round(e.y+e.height/2)}}function tg(e,t){let i=t.toLowerCase();return e.find(e=>{let t=(e.label??"").toLowerCase(),r=(e.value??"").toLowerCase(),a=(e.identifier??"").toLowerCase();return t.includes(i)||r.includes(i)||a.includes(i)})??null}function tv(e,t){let i=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);return i&&tA(i)?i:function(e,t){if(!e.rect)return;let i=e.rect.y+e.rect.height/2,r=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||!tA(t))continue;let a=Math.abs(e.rect.y+e.rect.height/2-i);(!r||a<r.distance)&&(r={label:t,distance:a})}return r?.label}(e,t)??(i&&tA(i)?i:void 0)}function tA(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function ty(e){let t=[],i=[];for(let r of e){let e=r.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let a=tI(r.type??""),n=[r.label,r.value,r.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0),o=!!n&&tA(n);if(("group"===a||"ioscontentgroup"===a)&&!o){t.push(e);continue}let s=Math.max(0,e-t.length);i.push({...r,depth:s})}return i}function tI(e){let t=e.trim().replace(/XCUIElementType/gi,"").toLowerCase();t.startsWith("ax")&&(t=t.replace(/^ax/,""));let i=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==i&&(t=t.slice(i+1)),t}function tb(e,t){let i=tI(e);return!i||("android"===t?i.includes("edittext")||i.includes("autocompletetextview"):i.includes("textfield")||i.includes("securetextfield")||i.includes("searchfield")||i.includes("textview")||i.includes("textarea")||"search"===i)}function tN(e){return[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").filter(e=>e.length>0)[0]??""}async function tS(e,t,i,r){let a=tD(await tr(e,"snapshot",[],r?.out,{...tu(t,{...r,snapshotDepth:1,snapshotCompact:!0,snapshotBackend:"ax"},void 0,i)}));if(a?.appName||a?.appBundleId)return{appName:a.appName??a.appBundleId??"unknown",appBundleId:a.appBundleId,source:"snapshot-ax"};let n=tD(await tr(e,"snapshot",[],r?.out,{...tu(t,{...r,snapshotDepth:1,snapshotCompact:!0,snapshotBackend:"xctest"},void 0,i)}));return{appName:n?.appName??n?.appBundleId??"unknown",appBundleId:n?.appBundleId,source:"snapshot-xctest"}}function tD(e){let t=tp(e?.nodes??[]),i=t.find(e=>"application"===tI(e.type??""))??t[0];if(!i)return null;let r=i.label?.trim(),a=i.identifier?.trim();return r||a?{appName:r||void 0,appBundleId:a||void 0}:null}let tx=new Set(["id","role","text","label","value"]),tk=new Set(["visible","hidden","editable","selected","enabled","hittable"]),tO=new Set([...tx,...tk]);function t_(e){let t=e.trim();if(!t)throw new p("INVALID_ARGS","Selector expression cannot be empty");let i=function(e){let t=[],i="",r=null;for(let a=0;a<e.length;a+=1){let n=e[a];if(('"'===n||"'"===n)&&!tH(e,a)){r?r===n&&(r=null):r=n,i+=n;continue}if(!r&&"|"===n&&"|"===e[a+1]){let r=i.trim();if(!r)throw new p("INVALID_ARGS",`Invalid selector fallback expression: ${e}`);t.push(r),i="",a+=1;continue}i+=n}let a=i.trim();if(!a)throw new p("INVALID_ARGS",`Invalid selector fallback expression: ${e}`);return t.push(a),t}(t);if(0===i.length)throw new p("INVALID_ARGS","Selector expression cannot be empty");return{raw:t,selectors:i.map(e=>(function(e){let t=e.trim();if(!t)throw new p("INVALID_ARGS","Selector segment cannot be empty");let i=function(e){let t=[],i="",r=null;for(let a=0;a<e.length;a+=1){let n=e[a];if(('"'===n||"'"===n)&&!tH(e,a)){r?r===n&&(r=null):r=n,i+=n;continue}if(!r&&/\s/.test(n)){i.trim().length>0&&t.push(i.trim()),i="";continue}i+=n}if(r)throw new p("INVALID_ARGS",`Unclosed quote in selector: ${e}`);return i.trim().length>0&&t.push(i.trim()),t}(t);if(0===i.length)throw new p("INVALID_ARGS",`Invalid selector segment: ${e}`);return{raw:t,terms:i.map(tB)}})(e))}}function tM(e){try{return t_(e)}catch{return null}}function tL(e,t,i){let r=i.requireRect??!1,a=i.requireUnique??!0,n=i.disambiguateAmbiguous??!1,o=[];for(let s=0;s<t.selectors.length;s+=1){let l=t.selectors[s],c=function(e,t,i){let r=0,a=null,n=null,o=!1;for(let s of e){if(i.requireRect&&!s.rect||!tV(s,t,i.platform))continue;if(r+=1,a||(a=s),!n){n=s,o=!1;continue}let e=function(e,t){let i=e.depth??0,r=t.depth??0;if(i!==r)return i>r?1:-1;let a=tJ(e),n=tJ(t);return a!==n?a<n?1:-1:0}(s,n);if(e>0){n=s,o=!1;continue}0===e&&(o=!0)}return{count:r,firstNode:a,disambiguated:o?null:n}}(e,l,{platform:i.platform,requireRect:r});if(o.push({selector:l.raw,matches:c.count}),0!==c.count&&c.firstNode){if(a&&1!==c.count){if(!n)continue;let e=c.disambiguated;if(!e)continue;return{node:e,selector:l,selectorIndex:s,matches:c.count,diagnostics:o}}return{node:c.firstNode,selector:l,selectorIndex:s,matches:c.count,diagnostics:o}}}return null}function tR(e,t,i){let r=i.requireRect??!1,a=[];for(let n=0;n<t.selectors.length;n+=1){let o=t.selectors[n],s=function(e,t,i){let r=0;for(let a of e)(!i.requireRect||a.rect)&&tV(a,t,i.platform)&&(r+=1);return r}(e,o,{platform:i.platform,requireRect:r});if(a.push({selector:o.raw,matches:s}),s>0)return{selectorIndex:n,selector:o,matches:s,diagnostics:a}}return null}function tE(e,t,i){let r=i.unique??!0;if(0===t.length)return`Selector did not match: ${e.raw}`;let a=t.map(e=>`${e.selector} -> ${e.matches}`).join(", ");return r?`Selector did not resolve uniquely (${a})`:`Selector did not match (${a})`}function tC(e,t={}){if(0===e.length)return null;let i=t.preferTrailingValue??!1,r=0,a=[];for(;r<e.length&&function(e){let t=e.trim();if(!t)return!1;if("||"===t)return!0;let i=t.indexOf("=");if(-1!==i){let e=t.slice(0,i).trim().toLowerCase();return tO.has(e)}return tO.has(t.toLowerCase())}(e[r]);){r+=1;let t=e.slice(0,r).join(" ").trim();t&&tM(t)&&a.push(r)}if(0===a.length)return null;let n=a[a.length-1];if(i){for(let t=a.length-1;t>=0;t-=1)if(a[t]<e.length){n=a[t];break}}let o=e.slice(0,n).join(" ").trim();return o?{selectorExpression:o,rest:e.slice(n)}:null}function tT(e){let t=e[0]??"",i=tC(e.slice(1),{preferTrailingValue:"text"===t});return{predicate:t,split:i}}function tP(e){return!0===e.hittable||!!e.rect&&e.rect.width>0&&e.rect.height>0}function t$(e,t){return tb(e.type??"",t)&&!1!==e.enabled}function tF(e,t,i={}){let r=[],a=tI(e.type??""),n=tW(e.identifier),o=tW(e.label),s=tW(e.value),l=tW(tN(e)),c="fill"===i.action;n&&r.push(`id=${tq(n)}`),a&&o&&r.push(c?`role=${tq(a)} label=${tq(o)} editable=true`:`role=${tq(a)} label=${tq(o)}`),o&&r.push(c?`label=${tq(o)} editable=true`:`label=${tq(o)}`),s&&r.push(c?`value=${tq(s)} editable=true`:`value=${tq(s)}`),l&&l!==o&&l!==s&&r.push(c?`text=${tq(l)} editable=true`:`text=${tq(l)}`),a&&c&&!r.some(e=>e.includes("editable=true"))&&r.push(`role=${tq(a)} editable=true`);let d=ts(r);return 0===d.length&&a&&d.push(c?`role=${tq(a)} editable=true`:`role=${tq(a)}`),0===d.length&&tP(e)&&d.push("visible=true"),d}function tB(e){let t=e.trim();if(!t)throw new p("INVALID_ARGS","Empty selector term");let i=t.indexOf("=");if(-1===i){let i=t.toLowerCase();if(!tk.has(i))throw new p("INVALID_ARGS",`Invalid selector term "${e}", expected key=value`);return{key:i,value:!0}}let r=t.slice(0,i).trim().toLowerCase(),a=t.slice(i+1).trim();if(!tO.has(r))throw new p("INVALID_ARGS",`Unknown selector key: ${r}`);if(!a)throw new p("INVALID_ARGS",`Missing selector value for key: ${r}`);if(tk.has(r)){let e,t="true"===(e=tU(a).toLowerCase())||"false"!==e&&null;if(null===t)throw new p("INVALID_ARGS",`Invalid boolean value for ${r}: ${a}`);return{key:r,value:t}}return{key:r,value:tU(a)}}function tV(e,t,i){return t.terms.every(t=>(function(e,t,i){switch(t.key){case"id":return tG(e.identifier,String(t.value));case"role":var r,a;return r=e.type,a=String(t.value),function(e){return tI(e)}(r??"")===function(e){return tI(e)}(a);case"label":return tG(e.label,String(t.value));case"value":return tG(e.value,String(t.value));case"text":{let i=tj(String(t.value));return tj(tN(e))===i}case"visible":return tP(e)===!!t.value;case"hidden":return!tP(e)==!!t.value;case"editable":return t$(e,i)===!!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,i))}function tU(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1).replace(/\\(["'])/g,"$1"):t}function tG(e,t){return tj(e??"")===tj(t)}function tj(e){return e.trim().toLowerCase().replace(/\s+/g," ")}function tq(e){return JSON.stringify(e)}function tW(e){if(!e)return null;let t=e.trim();return t||null}function tJ(e){return e.rect?e.rect.width*e.rect.height:1/0}function tH(e,t){let i=0;for(let r=t-1;r>=0&&"\\"===e[r];r-=1)i+=1;return i%2==1}function tz(e){return!!(e?.platform||e?.device||e?.udid||e?.serial)}async function tX(e){let t=e.session?.device??await ti(e.flags??{});return!1!==e.ensureReady&&await e.ensureReadyFn(t),t}let tK={ios:async(e,t,i)=>{let{reinstallIosApp:r}=await Promise.resolve().then(()=>({reinstallIosApp:eP}));return await r(e,t,i)},android:async(e,t,i)=>{let{reinstallAndroidApp:r}=await Promise.resolve().then(()=>({reinstallAndroidApp:et}));return await r(e,t,i)}};async function tY(e){let{req:t,sessionName:i,logPath:r,sessionStore:a,invoke:n,dispatch:o,ensureReady:s,reinstallOps:c=tK}=e,d=o??tr,f=s??tf,m=t.command;if("session_list"===m)return{ok:!0,data:{sessions:a.toArray().map(e=>({name:e.name,platform:e.device.platform,device:e.device.name,id:e.device.id,createdAt:e.createdAt}))}};if("devices"===m)try{let e=[];if(t.flags?.platform==="android"){let{listAndroidDevices:t}=await Promise.resolve().then(()=>({listAndroidDevices:E}));e.push(...await t())}else if(t.flags?.platform==="ios"){let{listIosDevices:t}=await Promise.resolve().then(()=>({listIosDevices:ex}));e.push(...await t())}else{let{listAndroidDevices:t}=await Promise.resolve().then(()=>({listAndroidDevices:E})),{listIosDevices:i}=await Promise.resolve().then(()=>({listIosDevices:ex}));try{e.push(...await t())}catch{}try{e.push(...await i())}catch{}}return{ok:!0,data:{devices:e}}}catch(t){let e=l(t);return{ok:!1,error:{code:e.code,message:e.message,details:e.details}}}if("apps"===m){let e=a.get(i),r=t.flags??{};if(!e&&!tz(r))return{ok:!1,error:{code:"INVALID_ARGS",message:"apps requires an active session or an explicit device selector (e.g. --platform ios)."}};let n=await tX({session:e,flags:r,ensureReadyFn:f,ensureReady:!0});if(!tn("apps",n))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"apps is not supported on this device"}};if("ios"===n.platform){let{listSimulatorApps:e}=await Promise.resolve().then(()=>({listSimulatorApps:eV})),i=await e(n);return t.flags?.appsMetadata?{ok:!0,data:{apps:i}}:{ok:!0,data:{apps:i.map(e=>e.name&&e.name!==e.bundleId?`${e.name} (${e.bundleId})`:e.bundleId)}}}let{listAndroidApps:o,listAndroidAppsMetadata:s}=await Promise.resolve().then(()=>({listAndroidApps:W,listAndroidAppsMetadata:J}));return t.flags?.appsMetadata?{ok:!0,data:{apps:await s(n,t.flags?.appsFilter)}}:{ok:!0,data:{apps:await o(n,t.flags?.appsFilter)}}}if("boot"===m){let e=a.get(i),r=t.flags??{};if(!e&&!tz(r))return{ok:!1,error:{code:"INVALID_ARGS",message:"boot requires an active session or an explicit device selector (e.g. --platform ios)."}};let n=e?.device??await ti(r);return tn("boot",n)?(await f(n),{ok:!0,data:{platform:n.platform,device:n.name,id:n.id,kind:n.kind,booted:!0}}):{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"boot is not supported on this device"}}}if("appstate"===m){let e=a.get(i),n=t.flags??{},o=await tX({session:e,flags:n,ensureReadyFn:f,ensureReady:!0});if("ios"===o.platform){if(e?.appBundleId)return{ok:!0,data:{platform:"ios",appBundleId:e.appBundleId,appName:e.appName??e.appBundleId,source:"session"}};let i=await tS(o,r,e?.trace?.outPath,t.flags);return{ok:!0,data:{platform:"ios",appName:i.appName,appBundleId:i.appBundleId,source:i.source}}}let{getAndroidAppState:s}=await Promise.resolve().then(()=>({getAndroidAppState:H})),l=await s(o);return{ok:!0,data:{platform:"android",package:l.package,activity:l.activity}}}if("reinstall"===m){let e,r=a.get(i),n=t.flags??{};if(!r&&!tz(n))return{ok:!1,error:{code:"INVALID_ARGS",message:"reinstall requires an active session or an explicit device selector (e.g. --platform ios)."}};let o=t.positionals?.[0]?.trim(),s=t.positionals?.[1]?.trim();if(!o||!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"reinstall requires: reinstall <app> <path-to-app-binary>"}};let l=tc.expandHome(s);if(!u.existsSync(l))return{ok:!1,error:{code:"INVALID_ARGS",message:`App binary not found: ${l}`}};let d=await tX({session:r,flags:n,ensureReadyFn:f,ensureReady:!1});if(!tn("reinstall",d))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"reinstall is not supported on this device"}};if("ios"===d.platform){let t=await c.ios(d,o,l);e={platform:"ios",appId:t.bundleId,bundleId:t.bundleId}}else{let t=await c.android(d,o,l);e={platform:"android",appId:t.package,package:t.package}}let p={app:o,appPath:l,...e};return r&&a.recordAction(r,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:p}),{ok:!0,data:p}}if("open"===m){let e;if(a.has(i)){let e,n=a.get(i),o=t.positionals?.[0];if(!n||!o)return{ok:!1,error:{code:"INVALID_ARGS",message:"Session already active. Close it first or pass a new --session name."}};if("ios"===n.device.platform)try{let{resolveIosApp:t}=await Promise.resolve().then(()=>({resolveIosApp:eM}));e=await t(n.device,o)}catch{e=void 0}await d(n.device,"open",t.positionals??[],t.flags?.out,{...tu(r,t.flags,e)});let s={...n,appBundleId:e,appName:o,recordSession:n.recordSession||t.flags?.saveScript===!0,snapshot:void 0};return a.recordAction(s,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:{session:i,appName:o,appBundleId:e}}),a.set(i,s),{ok:!0,data:{session:i,appName:o,appBundleId:e}}}let n=await ti(t.flags??{}),o=a.toArray().find(e=>e.device.id===n.id);if(o)return{ok:!1,error:{code:"DEVICE_IN_USE",message:`Device is already in use by session "${o.name}".`,details:{session:o.name,deviceId:n.id,deviceName:n.name}}};let s=t.positionals?.[0];if("ios"===n.platform)try{let{resolveIosApp:i}=await Promise.resolve().then(()=>({resolveIosApp:eM}));e=await i(n,t.positionals?.[0]??"")}catch{e=void 0}await d(n,"open",t.positionals??[],t.flags?.out,{...tu(r,t.flags,e)});let l={name:i,device:n,createdAt:Date.now(),appBundleId:e,appName:s,recordSession:t.flags?.saveScript===!0,actions:[]};return a.recordAction(l,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:{session:i}}),a.set(i,l),{ok:!0,data:{session:i}}}if("replay"===m){let e=t.positionals?.[0];if(!e)return{ok:!1,error:{code:"INVALID_ARGS",message:"replay requires a path"}};try{let o=tc.expandHome(e),s=u.readFileSync(o,"utf8"),l=s.trimStart()[0];if("{"===l||"["===l)return{ok:!1,error:{code:"INVALID_ARGS",message:"replay accepts .ad script files. JSON replay payloads are no longer supported."}};let c=function(e){let t=[];for(let i of e.split(/\r?\n/)){let e=function(e){let t=e.trim();if(0===t.length||t.startsWith("#"))return null;let i=function(e){let t=[],i=0;for(;i<e.length;){for(;i<e.length&&/\s/.test(e[i]);)i+=1;if(i>=e.length)break;if('"'===e[i]){let r=i+1,a=!1;for(;r<e.length;){let t=e[r];if('"'===t&&!a)break;a="\\"===t&&!a,"\\"!==t&&(a=!1),r+=1}if(r>=e.length)throw new p("INVALID_ARGS",`Invalid replay script line: ${e}`);let n=e.slice(i,r+1);t.push(JSON.parse(n)),i=r+1;continue}let r=i;for(;r<e.length&&!/\s/.test(e[r]);)r+=1;t.push(e.slice(i,r)),i=r}return t}(t);if(0===i.length)return null;let[r,...a]=i;if("context"===r)return null;let n={ts:Date.now(),command:r,positionals:[],flags:{}};if("snapshot"===r){n.positionals=[];for(let e=0;e<a.length;e+=1){let t=a[e];if("-i"===t){n.flags.snapshotInteractiveOnly=!0;continue}if("-c"===t){n.flags.snapshotCompact=!0;continue}if("--raw"===t){n.flags.snapshotRaw=!0;continue}if(("-d"===t||"--depth"===t)&&e+1<a.length){let t=Number(a[e+1]);Number.isFinite(t)&&t>=0&&(n.flags.snapshotDepth=Math.floor(t)),e+=1;continue}if(("-s"===t||"--scope"===t)&&e+1<a.length){n.flags.snapshotScope=a[e+1],e+=1;continue}if("--backend"===t&&e+1<a.length){let t=a[e+1];("ax"===t||"xctest"===t)&&(n.flags.snapshotBackend=t),e+=1}}return n}if("click"===r){if(0===a.length)return n;let e=a[0];return e.startsWith("@")?(n.positionals=[e],a[1]&&(n.result={refLabel:a[1]})):n.positionals=[a.join(" ")],n}if("fill"===r){if(a.length<2)return n.positionals=a,n;let e=a[0];return e.startsWith("@")?(a.length>=3?(n.positionals=[e,a.slice(2).join(" ")],n.result={refLabel:a[1]}):n.positionals=[e,a[1]],n):(n.positionals=[e,a.slice(1).join(" ")],n)}if("get"===r){if(a.length<2)return n.positionals=a,n;let e=a[0],t=a[1];return t.startsWith("@")?(n.positionals=[e,t],a[2]&&(n.result={refLabel:a[2]})):n.positionals=[e,a.slice(1).join(" ")],n}return n.positionals=a,n}(i);e&&t.push(e)}return t}(s),f=t.flags?.replayUpdate===!0,m=0;for(let e=0;e<c.length;e+=1){let s=c[e];if(!s||"replay"===s.command)continue;let l=await n({token:t.token,session:i,command:s.command,positionals:s.positionals??[],flags:s.flags??{}});if(l.ok)continue;if(!f)return tZ(l,s,e,o);let u=await tQ({action:s,sessionName:i,logPath:r,sessionStore:a,dispatch:d});if(!u)return tZ(l,s,e,o);if(c[e]=u,!(l=await n({token:t.token,session:i,command:u.command,positionals:u.positionals??[],flags:u.flags??{}})).ok)return tZ(l,u,e,o);m+=1}if(f&&m>0){let e=a.get(i);!function(e,t,i){let r=[];if(i){let e=i.device.name.replace(/"/g,'\\"'),t=i.device.kind?` kind=${i.device.kind}`:"";r.push(`context platform=${i.device.platform} device="${e}"${t} theme=unknown`)}for(let e of t)r.push(function(e){let t=[e.command];if("snapshot"===e.command)return e.flags?.snapshotInteractiveOnly&&t.push("-i"),e.flags?.snapshotCompact&&t.push("-c"),"number"==typeof e.flags?.snapshotDepth&&t.push("-d",String(e.flags.snapshotDepth)),e.flags?.snapshotScope&&t.push("-s",t2(e.flags.snapshotScope)),e.flags?.snapshotRaw&&t.push("--raw"),e.flags?.snapshotBackend&&t.push("--backend",e.flags.snapshotBackend),t.join(" ");for(let i of e.positionals??[])t.push(t2(i));return t.join(" ")}(e));let a=`${r.join("\n")}
|
|
14
|
+
`,n=`${e}.tmp-${process.pid}-${Date.now()}`;u.writeFileSync(n,a),u.renameSync(n,e)}(o,c,e)}return{ok:!0,data:{replayed:c.length,healed:m,session:i}}}catch(t){let e=l(t);return{ok:!1,error:{code:e.code,message:e.message}}}}if("close"===m){let e=a.get(i);return e?(t.positionals&&t.positionals.length>0&&await d(e.device,"close",t.positionals??[],t.flags?.out,{...tu(r,t.flags,e.appBundleId,e.trace?.outPath)}),"ios"===e.device.platform&&"simulator"===e.device.kind&&await eY(e.device.id),a.recordAction(e,{command:m,positionals:t.positionals??[],flags:t.flags??{},result:{session:i}}),t.flags?.saveScript&&(e.recordSession=!0),a.writeSessionLog(e),a.delete(i),{ok:!0,data:{session:i}}):{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session"}}}return null}function tZ(e,t,i,r){var a;let n;if(e.ok)return e;let o=i+1,s=(n=((a=t).positionals??[]).map(e=>{let t=e.trim();return/^-?\d+(\.\d+)?$/.test(t)||t.startsWith("@")?t:JSON.stringify(t)}),[a.command,...n].join(" ")),l={...e.error.details??{},replayPath:r,step:o,action:t.command,positionals:t.positionals??[]};return{ok:!1,error:{code:e.error.code,message:`Replay failed at step ${o} (${s}): ${e.error.message}`,details:l}}}async function tQ(e){let{action:t,sessionName:i,logPath:r,sessionStore:a,dispatch:n}=e;if(!["click","fill","get","is","wait"].includes(t.command))return null;let o=a.get(i);if(!o)return null;let s="click"===t.command||"fill"===t.command,l=await t0(o,t,r,s,n,a);for(let e of function(e){let t=[],i=Array.isArray(e.result?.selectorChain)&&e.result?.selectorChain.every(e=>"string"==typeof e)?e.result.selectorChain:[];if(t.push(...i),"click"===e.command){let i=e.positionals?.[0]??"";i&&!i.startsWith("@")&&t.push(e.positionals.join(" "))}if("fill"===e.command){let i=e.positionals?.[0]??"";i&&!i.startsWith("@")&&Number.isNaN(Number(i))&&t.push(i)}if("get"===e.command){let i=e.positionals?.[1]??"";i&&!i.startsWith("@")&&t.push(e.positionals.slice(1).join(" "))}if("is"===e.command){let{split:i}=tT(e.positionals);i&&t.push(i.selectorExpression)}if("wait"===e.command){let{selectorExpression:i}=t1(e.positionals??[]);i&&t.push(i)}let r="string"==typeof e.result?.refLabel?e.result.refLabel.trim():"";if(r.length>0){let i=JSON.stringify(r);"fill"===e.command?(t.push(`id=${i} editable=true`),t.push(`label=${i} editable=true`),t.push(`text=${i} editable=true`),t.push(`value=${i} editable=true`)):(t.push(`id=${i}`),t.push(`label=${i}`),t.push(`text=${i}`),t.push(`value=${i}`))}return ts(t).filter(e=>e.trim().length>0)}(t)){let i=tM(e);if(!i)continue;let r=tL(l.nodes,i,{platform:o.device.platform,requireRect:s,requireUnique:!0,disambiguateAmbiguous:s});if(!r)continue;let a=tF(r.node,o.device.platform,{action:"click"===t.command?"click":"fill"===t.command?"fill":"get"}).join(" || ");if("click"===t.command)return{...t,positionals:[a]};if("fill"===t.command){let e=to(t);if(!e)continue;return{...t,positionals:[a,e]}}if("get"===t.command){let e=t.positionals?.[0];if("text"!==e&&"attrs"!==e)continue;return{...t,positionals:[e,a]}}if("is"===t.command){let{predicate:e,split:i}=tT(t.positionals);if(!e)continue;let r=i?.rest.join(" ").trim()??"",n=[e,a];return"text"===e&&r.length>0&&n.push(r),{...t,positionals:n}}if("wait"===t.command){let{selectorTimeout:e}=t1(t.positionals??[]),i=[a];return e&&i.push(e),{...t,positionals:i}}}return null}async function t0(e,t,i,r,a,n){let o=await a(e.device,"snapshot",[],t.flags?.out,{...tu(i,{...t.flags??{},snapshotInteractiveOnly:r,snapshotCompact:r},e.appBundleId,e.trace?.outPath)}),s=o?.nodes??[],l={nodes:tp(t.flags?.snapshotRaw?s:ty(s)),truncated:o?.truncated,createdAt:Date.now(),backend:o?.backend};return e.snapshot=l,n.set(e.name,e),l}function t1(e){if(0===e.length)return{selectorExpression:null,selectorTimeout:null};let t=e[e.length-1],i=/^\d+$/.test(t??""),r=tC(i?e.slice(0,-1):e.slice());return!r||r.rest.length>0?{selectorExpression:null,selectorTimeout:null}:{selectorExpression:r.selectorExpression,selectorTimeout:i?t:null}}function t2(e){let t=e.trim();return t.startsWith("@")||/^-?\d+(\.\d+)?$/.test(t)?t:JSON.stringify(t)}function t3(e){if(!e)return null;let t=Number(e);return Number.isFinite(t)?t:null}async function t4(e){let{req:t,sessionName:i,logPath:r,sessionStore:a}=e,n=t.command;if("snapshot"===n){let{session:e,device:n}=await t5(a,i,t.flags);if(!tn("snapshot",n))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"snapshot is only supported on iOS simulators in v1"}};let o=e?.appBundleId,s=t.flags?.snapshotScope;if(s&&s.trim().startsWith("@")){if(!e?.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"Ref scope requires an existing snapshot in session."}};let t=tm(s.trim());if(!t)return{ok:!1,error:{code:"INVALID_ARGS",message:`Invalid ref scope: ${s}`}};let i=th(e.snapshot.nodes,t),r=i?tv(i,e.snapshot.nodes):void 0;if(!r)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${s} not found or has no label`}};s=r}let l=await tr(n,"snapshot",[],t.flags?.out,{...tu(r,{...t.flags,snapshotScope:s},o,e?.trace?.outPath)}),c=l?.nodes??[],d=tp(t.flags?.snapshotRaw?c:ty(c)),u={nodes:d,truncated:l?.truncated,createdAt:Date.now(),backend:l?.backend},f=e?{...e,snapshot:u}:{name:i,device:n,createdAt:Date.now(),appBundleId:o,snapshot:u,actions:[]};return t8(a,f,t,{nodes:d.length,truncated:l?.truncated??!1}),a.set(i,f),{ok:!0,data:{nodes:d,truncated:l?.truncated??!1,appName:f.appBundleId?f.appName??f.appBundleId:void 0,appBundleId:f.appBundleId}}}if("wait"===n){let e,n,{session:o,device:s}=await t5(a,i,t.flags),l=function(e){if(0===e.length)return null;let t=t3(e[0]);if(null!==t)return{kind:"sleep",durationMs:t};if("text"===e[0]){let t=t3(e[e.length-1]);return{kind:"text",text:(null!==t?e.slice(1,-1).join(" "):e.slice(1).join(" ")).trim(),timeoutMs:t}}if(e[0].startsWith("@")){let t=t3(e[e.length-1]);return{kind:"ref",rawRef:e[0],timeoutMs:t}}let i=t3(e[e.length-1]),r=tC(null!==i?e.slice(0,-1):e.slice());if(r&&0===r.rest.length){let e=tM(r.selectorExpression);if(e)return{kind:"selector",selector:e,selectorExpression:r.selectorExpression,timeoutMs:i}}return{kind:"text",text:(null!==i?e.slice(0,-1).join(" "):e.join(" ")).trim(),timeoutMs:i}}(t.positionals??[]);if(!l)return{ok:!1,error:{code:"INVALID_ARGS",message:"wait requires a duration or text"}};if("sleep"===l.kind)return await new Promise(e=>setTimeout(e,l.durationMs)),t8(a,o,t,{waitedMs:l.durationMs}),{ok:!0,data:{waitedMs:l.durationMs}};if(!tn("wait",s))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"wait is not supported on this device"}};if("selector"===l.kind){let e=l.timeoutMs??1e4,n=Date.now();for(;Date.now()-n<e;){let e=await tr(s,"snapshot",[],t.flags?.out,{...tu(r,{...t.flags,snapshotInteractiveOnly:!1,snapshotCompact:!1},o?.appBundleId,o?.trace?.outPath)}),c=e?.nodes??[],d=tp(t.flags?.snapshotRaw?c:ty(c));o&&(o.snapshot={nodes:d,truncated:e?.truncated,createdAt:Date.now(),backend:e?.backend},a.set(i,o));let u=tR(d,l.selector,{platform:s.platform});if(u)return t8(a,o,t,{selector:u.selector.raw,waitedMs:Date.now()-n}),{ok:!0,data:{selector:u.selector.raw,waitedMs:Date.now()-n}};await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:`wait timed out for selector: ${l.selectorExpression}`}}}if("ref"===l.kind){if(!o?.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"Ref wait requires an existing snapshot in session."}};let t=tm(l.rawRef);if(!t)return{ok:!1,error:{code:"INVALID_ARGS",message:`Invalid ref: ${l.rawRef}`}};let i=th(o.snapshot.nodes,t),r=i?tv(i,o.snapshot.nodes):void 0;if(!r)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${l.rawRef} not found or has no label`}};e=r,n=l.timeoutMs}else e=l.text,n=l.timeoutMs;if(!e)return{ok:!1,error:{code:"INVALID_ARGS",message:"wait requires text"}};let c=n??1e4,d=Date.now();for(;Date.now()-d<c;){if("ios"===s.platform&&"simulator"===s.kind){let i=await eH(s,{command:"findText",text:e,appBundleId:o?.appBundleId},{verbose:t.flags?.verbose,logPath:r,traceLogPath:o?.trace?.outPath});if(i?.found)return t8(a,o,t,{text:e,waitedMs:Date.now()-d}),{ok:!0,data:{text:e,waitedMs:Date.now()-d}}}else if("android"===s.platform&&tg(tp((await em(s,{scope:e})).nodes??[]),e))return t8(a,o,t,{text:e,waitedMs:Date.now()-d}),{ok:!0,data:{text:e,waitedMs:Date.now()-d}};await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:`wait timed out for text: ${e}`}}}if("alert"===n){let{session:e,device:n}=await t5(a,i,t.flags),o=(t.positionals?.[0]??"get").toLowerCase();if(!tn("alert",n))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"alert is only supported on iOS simulators in v1"}};if("wait"===o){let i=t3(t.positionals?.[1])??1e4,o=Date.now();for(;Date.now()-o<i;){try{let i=await eH(n,{command:"alert",action:"get",appBundleId:e?.appBundleId},{verbose:t.flags?.verbose,logPath:r,traceLogPath:e?.trace?.outPath});return t8(a,e,t,i),{ok:!0,data:i}}catch{}await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:"alert wait timed out"}}}let s=await eH(n,{command:"alert",action:"accept"===o||"dismiss"===o?o:"get",appBundleId:e?.appBundleId},{verbose:t.flags?.verbose,logPath:r,traceLogPath:e?.trace?.outPath});return t8(a,e,t,s),{ok:!0,data:s}}if("settings"===n){let e=t.positionals?.[0],n=t.positionals?.[1];if(!e||!n)return{ok:!1,error:{code:"INVALID_ARGS",message:"settings requires <wifi|airplane|location> <on|off>"}};let{session:o,device:s}=await t5(a,i,t.flags),l=o?.appBundleId,c=await tr(s,"settings",[e,n,l??""],t.flags?.out,{...tu(r,t.flags,l,o?.trace?.outPath)});return t8(a,o,t,c??{setting:e,state:n}),{ok:!0,data:c??{setting:e,state:n}}}return null}async function t5(e,t,i){let r=e.get(t),a=r?.device??await ti(i??{});return r||await tf(a),{session:r,device:a}}function t8(e,t,i,r){t&&e.recordAction(t,{command:i.command,positionals:i.positionals??[],flags:i.flags??{},result:r})}function t7(e,t,i,r={}){let a=t9(i);if(!a)return{matches:[],score:0};let n=0,o=[];for(let i of e){if(r.requireRect&&!i.rect)continue;let e=function(e,t,i){switch(t){case"role":return function(e,t){let i=function(e){let t=e.trim();return t?((t=(t.split(".").pop()??t).replace(/XCUIElementType/gi,"").toLowerCase()).startsWith("ax")&&(t=t.replace(/^ax/,"")),t):""}(e??"");return i?i===t?2:+!!i.includes(t):0}(e.type,i);case"label":return t6(e.label,i);case"value":return t6(e.value,i);case"id":return t6(e.identifier,i);default:return Math.max(t6(e.label,i),t6(e.value,i),t6(e.identifier,i))}}(i,t,a);if(!(e<=0)){if(e>n){n=e,o.length=0,o.push(i);continue}e===n&&o.push(i)}}return{matches:o,score:n}}function t6(e,t){let i=t9(e??"");return i?i===t?2:+!!i.includes(t):0}function t9(e){return e.trim().toLowerCase().replace(/\s+/g," ")}async function ie(e){let{req:t,sessionName:i,logPath:r,sessionStore:a,invoke:n}=e,o=t.command;if("find"!==o)return null;let s=t.positionals??[];if(0===s.length)return{ok:!1,error:{code:"INVALID_ARGS",message:"find requires a locator or text"}};let{locator:l,query:c,action:d,value:u,timeoutMs:f}=function(e){let t="any",i=0;["text","label","value","role","id"].includes(e[0])&&(t=e[0],i=1);let r=e[i]??"",a=e.slice(i+1);if(0===a.length)return{locator:t,query:r,action:"click"};let n=a[0].toLowerCase();if("get"===n){let e=a[1]?.toLowerCase();if("text"===e)return{locator:t,query:r,action:"get_text"};if("attrs"===e)return{locator:t,query:r,action:"get_attrs"};throw new p("INVALID_ARGS","find get only supports text or attrs")}if("wait"===n)return{locator:t,query:r,action:"wait",timeoutMs:t3(a[1])??void 0};if("exists"===n)return{locator:t,query:r,action:"exists"};if("click"===n)return{locator:t,query:r,action:"click"};if("focus"===n)return{locator:t,query:r,action:"focus"};if("fill"===n)return{locator:t,query:r,action:"fill",value:a.slice(1).join(" ")};if("type"===n)return{locator:t,query:r,action:"type",value:a.slice(1).join(" ")};throw new p("INVALID_ARGS",`Unsupported find action: ${a[0]}`)}(s);if(!c)return{ok:!1,error:{code:"INVALID_ARGS",message:"find requires a value"}};let m=a.get(i);if(!m&&"exists"!==d&&"wait"!==d&&"get_text"!==d&&"get_attrs"!==d)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let h=m?.device??await ti(t.flags??{});m||await tf(h);let w=m?.appBundleId,g="role"!==l?c:void 0,v="click"===d||"focus"===d||"fill"===d||"type"===d,A=0,y=null,I=async()=>{let e=Date.now();if(y&&e-A<750)return{nodes:y};let n=await tr(h,"snapshot",[],t.flags?.out,{...tu(r,{...t.flags,snapshotScope:g,snapshotInteractiveOnly:v,snapshotCompact:v},w,m?.trace?.outPath)}),o=n?.nodes??[],s=tp(t.flags?.snapshotRaw?o:ty(o));return A=e,y=s,m&&(m.snapshot={nodes:s,truncated:n?.truncated,createdAt:Date.now(),backend:n?.backend},a.set(i,m)),{nodes:s,truncated:n?.truncated,backend:n?.backend}};if("wait"===d){let e=f??1e4,i=Date.now();for(;Date.now()-i<e;){let{nodes:e}=await I();if(t7(e,l,c,{requireRect:!1}).matches[0])return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{found:!0,waitedMs:Date.now()-i}}),{ok:!0,data:{found:!0,waitedMs:Date.now()-i}};await new Promise(e=>setTimeout(e,300))}return{ok:!1,error:{code:"COMMAND_FAILED",message:"find wait timed out"}}}let{nodes:b}=await I(),N=t7(b,l,c,{requireRect:v});if(v&&N.matches.length>1){let e=N.matches.slice(0,8).map(e=>{let t=tN(e)||e.label||e.identifier||e.type||"";return`@${e.ref}${t?`(${t})`:""}`});return{ok:!1,error:{code:"AMBIGUOUS_MATCH",message:`find matched ${N.matches.length} elements for ${l} "${c}". Use a more specific locator or selector.`,details:{locator:l,query:c,matches:N.matches.length,candidates:e}}}}let S=N.matches[0]??null;if(!S)return{ok:!1,error:{code:"COMMAND_FAILED",message:"find did not match any element"}};let D="click"===d||"focus"===d||"fill"===d||"type"===d?function(e,t){if(t.hittable)return t;let i=t,r=new Set;for(;void 0!==i.parentIndex&&!r.has(i.ref);){r.add(i.ref);let t=e[i.parentIndex];if(!t)break;if(t.hittable)return t;i=t}return null}(b,S)??S:S,x=`@${D.ref}`,k={...t.flags??{},noRecord:!0};if("exists"===d)return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{found:!0}}),{ok:!0,data:{found:!0}};if("get_text"===d){let e=tN(S);return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:x,action:"get text",text:e}}),{ok:!0,data:{ref:x,text:e,node:S}}}if("get_attrs"===d)return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:x,action:"get attrs"}}),{ok:!0,data:{ref:x,node:S}};if("click"===d){let e=await n({token:t.token,session:i,command:"click",positionals:[x],flags:k});return e.ok&&m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:x,action:"click"}}),e}if("fill"===d){if(!u)return{ok:!1,error:{code:"INVALID_ARGS",message:"find fill requires text"}};let e=await n({token:t.token,session:i,command:"fill",positionals:[x,u],flags:k});return e.ok&&m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:x,action:"fill"}}),e}if("focus"===d){let e=S.rect?tw(S.rect):null;if(!e)return{ok:!1,error:{code:"COMMAND_FAILED",message:"matched element has no bounds"}};let i=await tr(h,"focus",[String(e.x),String(e.y)],t.flags?.out,{...tu(r,t.flags,m?.appBundleId,m?.trace?.outPath)});return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:x,action:"focus"}}),{ok:!0,data:i??{ref:x}}}if("type"===d){if(!u)return{ok:!1,error:{code:"INVALID_ARGS",message:"find type requires text"}};let e=S.rect?tw(S.rect):null;if(!e)return{ok:!1,error:{code:"COMMAND_FAILED",message:"matched element has no bounds"}};await tr(h,"focus",[String(e.x),String(e.y)],t.flags?.out,{...tu(r,t.flags,m?.appBundleId,m?.trace?.outPath)});let i=await tr(h,"type",[u],t.flags?.out,{...tu(r,t.flags,m?.appBundleId,m?.trace?.outPath)});return m&&a.recordAction(m,{command:o,positionals:t.positionals??[],flags:t.flags??{},result:{ref:x,action:"type"}}),{ok:!0,data:i??{ref:x}}}return null}async function it(e){let{req:t,sessionName:i,sessionStore:r}=e,a=t.command;if("record"===a){let e=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(e))return{ok:!1,error:{code:"INVALID_ARGS",message:"record requires start|stop"}};let o=r.get(i),s=o?.device??await ti(t.flags??{});o||await tf(s);let l=o??{name:i,device:s,createdAt:Date.now(),actions:[]};if("start"===e){if(l.recording)return{ok:!1,error:{code:"INVALID_ARGS",message:"recording already in progress"}};let e=t.positionals?.[1]??`./recording-${Date.now()}.mp4`,o=n.resolve(e),c=n.dirname(o);if(u.existsSync(c)||u.mkdirSync(c,{recursive:!0}),!tn("record",s))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"record is only supported on iOS simulators in v1"}};if("ios"===s.platform){let{child:e,wait:t}=d("xcrun",["simctl","io",s.id,"recordVideo",o],{allowFailure:!0});l.recording={platform:"ios",outPath:o,child:e,wait:t}}else{let e=`/sdcard/agent-device-recording-${Date.now()}.mp4`,{child:t,wait:i}=d("adb",["-s",s.id,"shell","screenrecord",e],{allowFailure:!0});l.recording={platform:"android",outPath:o,remotePath:e,child:t,wait:i}}return r.set(i,l),r.recordAction(l,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"start"}}),{ok:!0,data:{recording:"started",outPath:e}}}if(!l.recording)return{ok:!1,error:{code:"INVALID_ARGS",message:"no active recording"}};let c=l.recording;c.child.kill("SIGINT");try{await c.wait}catch{}if("android"===c.platform&&c.remotePath)try{await m("adb",["-s",s.id,"pull",c.remotePath,c.outPath],{allowFailure:!0}),await m("adb",["-s",s.id,"shell","rm","-f",c.remotePath],{allowFailure:!0})}catch{}return l.recording=void 0,r.recordAction(l,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:c.outPath}}),{ok:!0,data:{recording:"stopped",outPath:c.outPath}}}if("trace"===a){let e=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(e))return{ok:!1,error:{code:"INVALID_ARGS",message:"trace requires start|stop"}};let o=r.get(i);if(!o)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session"}};if("start"===e){if(o.trace)return{ok:!1,error:{code:"INVALID_ARGS",message:"trace already in progress"}};let e=t.positionals?.[1]??r.defaultTracePath(o),i=tc.expandHome(e);return u.mkdirSync(n.dirname(i),{recursive:!0}),u.appendFileSync(i,""),o.trace={outPath:i,startedAt:Date.now()},r.recordAction(o,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"start",outPath:i}}),{ok:!0,data:{trace:"started",outPath:i}}}if(!o.trace)return{ok:!1,error:{code:"INVALID_ARGS",message:"no active trace"}};let s=o.trace.outPath;if(t.positionals?.[1]){let e=tc.expandHome(t.positionals[1]);u.mkdirSync(n.dirname(e),{recursive:!0}),u.existsSync(s)?u.renameSync(s,e):u.appendFileSync(e,""),s=e}return o.trace=void 0,r.recordAction(o,{command:a,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:s}}),{ok:!0,data:{trace:"stopped",outPath:s}}}return null}async function ii(e){let{req:t,sessionName:i,sessionStore:r,contextFromFlags:a}=e,n=t.command;if("click"===n){let e=r.get(i);if(!e)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let o=t.positionals?.[0]??"";if(o.startsWith("@")){if(!e.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"No snapshot in session. Run snapshot first."}};let i=tm(o);if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"click requires a ref like @e2"}};let s=th(e.snapshot.nodes,i);if(!s?.rect&&t.positionals.length>1){let i=t.positionals.slice(1).join(" ").trim();i.length>0&&(s=tg(e.snapshot.nodes,i))}if(!s?.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${o} not found or has no bounds`}};let l=tv(s,e.snapshot.nodes),c=tF(s,e.device.platform,{action:"click"}),{x:d,y:u}=tw(s.rect);return await tr(e.device,"press",[String(d),String(u)],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)}),r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{ref:i,x:d,y:u,refLabel:l,selectorChain:c}}),{ok:!0,data:{ref:i,x:d,y:u}}}let s=(t.positionals??[]).join(" ").trim();if(!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"click requires @ref or selector expression"}};let l=t_(s),c=await ir(e,t.flags,r,a,{interactiveOnly:!0}),d=tL(c.nodes,l,{platform:e.device.platform,requireRect:!0,requireUnique:!0,disambiguateAmbiguous:!0});if(!d||!d.node.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:tE(l,d?.diagnostics??[],{unique:!0})}};let{x:u,y:f}=tw(d.node.rect);await tr(e.device,"press",[String(u),String(f)],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)});let p=tF(d.node,e.device.platform,{action:"click"}),m=tv(d.node,c.nodes);return r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{x:u,y:f,selector:d.selector.raw,selectorChain:p,refLabel:m}}),{ok:!0,data:{selector:d.selector.raw,x:u,y:f}}}if("fill"===n){let e=r.get(i);if(t.positionals?.[0]?.startsWith("@")){if(!e?.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"No snapshot in session. Run snapshot first."}};let i=tm(t.positionals[0]);if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires a ref like @e2"}};let o=t.positionals.length>=3?t.positionals[1]:"",s=t.positionals.length>=3?t.positionals.slice(2).join(" "):t.positionals.slice(1).join(" ");if(!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires text after ref"}};let l=th(e.snapshot.nodes,i);if(!l?.rect&&o&&(l=tg(e.snapshot.nodes,o)),!l?.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${t.positionals[0]} not found or has no bounds`}};let c=l.type??"",d=c&&!tb(c,e.device.platform)?`fill target ${t.positionals[0]} resolved to "${c}", attempting fill anyway.`:void 0,u=tv(l,e.snapshot.nodes),f=tF(l,e.device.platform,{action:"fill"}),{x:p,y:m}=tw(l.rect),h={...await tr(e.device,"fill",[String(p),String(m),s],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)})??{ref:i,x:p,y:m}};return d&&(h.warning=d),r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{...h,refLabel:u,selectorChain:f}}),{ok:!0,data:h}}if(!e)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let o=tC(t.positionals??[],{preferTrailingValue:!0});if(o){if(0===o.rest.length)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires text after selector"}};let i=o.rest.join(" ").trim();if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires text after selector"}};let s=t_(o.selectorExpression),l=await ir(e,t.flags,r,a,{interactiveOnly:!0}),c=tL(l.nodes,s,{platform:e.device.platform,requireRect:!0,requireUnique:!0,disambiguateAmbiguous:!0});if(!c||!c.node.rect)return{ok:!1,error:{code:"COMMAND_FAILED",message:tE(s,c?.diagnostics??[],{unique:!0})}};let d=c.node,u=d.type??"",f=u&&!tb(u,e.device.platform)?`fill target ${c.selector.raw} resolved to "${u}", attempting fill anyway.`:void 0,{x:p,y:m}=tw(c.node.rect),h=await tr(e.device,"fill",[String(p),String(m),i],t.flags?.out,{...a(t.flags,e.appBundleId,e.trace?.outPath)}),w=tF(d,e.device.platform,{action:"fill"}),g={...h??{x:p,y:m,text:i},selector:c.selector.raw,selectorChain:w,refLabel:tv(d,l.nodes)};return f&&(g.warning=f),r.recordAction(e,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:g}),{ok:!0,data:g}}return{ok:!1,error:{code:"INVALID_ARGS",message:"fill requires x y text, @ref text, or selector text"}}}if("get"===n){let e=t.positionals?.[0];if("text"!==e&&"attrs"!==e)return{ok:!1,error:{code:"INVALID_ARGS",message:"get only supports text or attrs"}};let o=r.get(i);if(!o)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};let s=t.positionals?.[1]??"";if(s.startsWith("@")){if(!o.snapshot)return{ok:!1,error:{code:"INVALID_ARGS",message:"No snapshot in session. Run snapshot first."}};let i=tm(s??"");if(!i)return{ok:!1,error:{code:"INVALID_ARGS",message:"get text requires a ref like @e2"}};let a=th(o.snapshot.nodes,i);if(!a&&t.positionals.length>2){let e=t.positionals.slice(2).join(" ").trim();e.length>0&&(a=tg(o.snapshot.nodes,e))}if(!a)return{ok:!1,error:{code:"COMMAND_FAILED",message:`Ref ${s} not found`}};let l=tF(a,o.device.platform,{action:"get"});if("attrs"===e)return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{ref:i,selectorChain:l}}),{ok:!0,data:{ref:i,node:a}};let c=tN(a);return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{ref:i,text:c,refLabel:c||void 0,selectorChain:l}}),{ok:!0,data:{ref:i,text:c,node:a}}}let l=t.positionals.slice(1).join(" ").trim();if(!l)return{ok:!1,error:{code:"INVALID_ARGS",message:"get requires @ref or selector expression"}};let c=t_(l),d=tL((await ir(o,t.flags,r,a,{interactiveOnly:!1})).nodes,c,{platform:o.device.platform,requireRect:!1,requireUnique:!0});if(!d)return{ok:!1,error:{code:"COMMAND_FAILED",message:tE(c,[],{unique:!0})}};let u=d.node,f=tF(u,o.device.platform,{action:"get"});if("attrs"===e)return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{selector:d.selector.raw,selectorChain:f}}),{ok:!0,data:{selector:d.selector.raw,node:u}};let p=tN(u);return r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{text:p,refLabel:p||void 0,selector:d.selector.raw,selectorChain:f}}),{ok:!0,data:{selector:d.selector.raw,text:p,node:u}}}if("is"===n){let e=(t.positionals?.[0]??"").toLowerCase();if(!["visible","hidden","exists","editable","selected","text"].includes(e))return{ok:!1,error:{code:"INVALID_ARGS",message:"is requires predicate: visible|hidden|exists|editable|selected|text"}};let o=r.get(i);if(!o)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};if(!tn("is",o.device))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:"is is not supported on this device"}};let{split:s}=tT(t.positionals);if(!s)return{ok:!1,error:{code:"INVALID_ARGS",message:"is requires a selector expression"}};let l=s.rest.join(" ").trim();if("text"===e&&!l)return{ok:!1,error:{code:"INVALID_ARGS",message:"is text requires expected text value"}};if("text"!==e&&s.rest.length>0)return{ok:!1,error:{code:"INVALID_ARGS",message:`is ${e} does not accept trailing values`}};let c=t_(s.selectorExpression),d=await ir(o,t.flags,r,a,{interactiveOnly:!1});if("exists"===e){let i=tR(d.nodes,c,{platform:o.device.platform});return i?(r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{predicate:e,selector:i.selector.raw,selectorChain:c.selectors.map(e=>e.raw),pass:!0,matches:i.matches}}),{ok:!0,data:{predicate:e,pass:!0,selector:i.selector.raw,matches:i.matches}}):{ok:!1,error:{code:"COMMAND_FAILED",message:tE(c,[],{unique:!1})}}}let u=tL(d.nodes,c,{platform:o.device.platform,requireUnique:!0});if(!u)return{ok:!1,error:{code:"COMMAND_FAILED",message:tE(c,[],{unique:!0})}};let f=function(e){let{predicate:t,node:i,expectedText:r,platform:a}=e,n=tN(i),o=!1;switch(t){case"visible":o=tP(i);break;case"hidden":o=!tP(i);break;case"editable":o=t$(i,a);break;case"selected":o=!0===i.selected;break;case"text":o=n===(r??"")}let s="text"===t?`expected="${r??""}" actual="${n}"`:`actual=${JSON.stringify({visible:tP(i),editable:t$(i,a),selected:!0===i.selected})}`;return{pass:o,actualText:n,details:s}}({predicate:e,node:u.node,expectedText:l,platform:o.device.platform});return f.pass?(r.recordAction(o,{command:n,positionals:t.positionals??[],flags:t.flags??{},result:{predicate:e,selector:u.selector.raw,selectorChain:c.selectors.map(e=>e.raw),pass:!0,text:"text"===e?f.actualText:void 0}}),{ok:!0,data:{predicate:e,pass:!0,selector:u.selector.raw}}):{ok:!1,error:{code:"COMMAND_FAILED",message:`is ${e} failed for selector ${u.selector.raw}: ${f.details}`}}}return null}async function ir(e,t,i,r,a){let n=await tr(e.device,"snapshot",[],t?.out,{...r({...t??{},snapshotInteractiveOnly:a.interactiveOnly,snapshotCompact:a.interactiveOnly},e.appBundleId,e.trace?.outPath)}),o=n?.nodes??[];return e.snapshot={nodes:tp(t?.snapshotRaw?o:ty(o)),truncated:n?.truncated,createdAt:Date.now(),backend:n?.backend},i.set(e.name,e),e.snapshot}let ia=n.join(f.homedir(),".agent-device"),io=n.join(ia,"daemon.json"),is=n.join(ia,"daemon.log"),il=new tc(n.join(ia,"sessions")),ic=g(),id=i.randomBytes(24).toString("hex"),iu=new Set(["session_list","devices"]);function ip(e,t,i){return tu(is,e,t,i)}async function im(e){if(e.token!==id)return{ok:!1,error:{code:"UNAUTHORIZED",message:"Invalid token"}};let t=e.command,i=function(e,t){var i;let r,a=e.session||"default";if(i=e,"string"==typeof(r=i.flags?.session)&&r.trim().length>0||"default"!==a||t.has(a))return a;let n=t.toArray();return 1===n.length?n[0].name:a}(e,il),r=il.get(i);r&&!iu.has(t)&&function(e,t){if(!t)return;let i=[],r=e.device;if(t.platform&&t.platform!==r.platform&&i.push(`--platform=${t.platform}`),t.udid&&("ios"!==r.platform||t.udid!==r.id)&&i.push(`--udid=${t.udid}`),t.serial&&("android"!==r.platform||t.serial!==r.id)&&i.push(`--serial=${t.serial}`),0!==i.length){var a;let t,r,n;throw new p("INVALID_ARGS",`Session "${e.name}" is bound to ${(t=(a=e).device.platform,r=a.device.name.trim(),n=a.device.id,`${t} device "${r}" (${n})`)} and cannot be used with ${i.join(", ")}. Use a different --session name or close this session first.`)}}(r,e.flags);let a=await tY({req:e,sessionName:i,logPath:is,sessionStore:il,invoke:im});if(a)return a;let n=await t4({req:e,sessionName:i,logPath:is,sessionStore:il});if(n)return n;let o=await it({req:e,sessionName:i,sessionStore:il});if(o)return o;let s=await ie({req:e,sessionName:i,logPath:is,sessionStore:il,invoke:im});if(s)return s;let l=await ii({req:e,sessionName:i,sessionStore:il,contextFromFlags:ip});if(l)return l;let c=il.get(i);if(!c)return{ok:!1,error:{code:"SESSION_NOT_FOUND",message:"No active session. Run open first."}};if(!tn(t,c.device))return{ok:!1,error:{code:"UNSUPPORTED_OPERATION",message:`${t} is not supported on this device`}};let d=await tr(c.device,t,e.positionals??[],e.flags?.out,{...ip(e.flags,c.appBundleId,c.trace?.outPath)});return il.recordAction(c,{command:t,positionals:e.positionals??[],flags:e.flags??{},result:d??{}}),{ok:!0,data:d??{}}}(e=h.createServer(e=>{let t="";e.setEncoding("utf8"),e.on("data",async i=>{let r=(t+=i).indexOf("\n");for(;-1!==r;){let i,a=t.slice(0,r).trim();if(t=t.slice(r+1),0===a.length){r=t.indexOf("\n");continue}try{let e=JSON.parse(a);i=await im(e)}catch(t){let e=l(t);i={ok:!1,error:{code:e.code,message:e.message,details:e.details}}}e.write(`${JSON.stringify(i)}
|
|
15
|
+
`),r=t.indexOf("\n")}})})).listen(0,"127.0.0.1",()=>{let t=e.address();if("object"==typeof t&&t?.port){var i;i=t.port,u.existsSync(ia)||u.mkdirSync(ia,{recursive:!0}),u.writeFileSync(is,""),u.writeFileSync(io,JSON.stringify({port:i,token:id,pid:process.pid,version:ic},null,2),{mode:384}),process.stdout.write(`AGENT_DEVICE_DAEMON_PORT=${t.port}
|
|
16
|
+
`)}}),t=async()=>{for(let e of il.toArray())"ios"===e.device.platform&&"simulator"===e.device.kind&&await eY(e.device.id),il.writeSessionLog(e);e.close(()=>{u.existsSync(io)&&u.unlinkSync(io),process.exit(0)})},process.on("SIGINT",()=>{t()}),process.on("SIGTERM",()=>{t()}),process.on("SIGHUP",()=>{t()}),process.on("uncaughtException",e=>{let i=e instanceof p?e:l(e);process.stderr.write(`Daemon error: ${i.message}
|
|
17
17
|
`),t()});
|
package/package.json
CHANGED
|
@@ -74,6 +74,97 @@ test('resolveSelectorChain falls back when first selector is ambiguous', () => {
|
|
|
74
74
|
assert.equal(resolved.node.ref, 'e2');
|
|
75
75
|
});
|
|
76
76
|
|
|
77
|
+
test('resolveSelectorChain keeps strict ambiguity behavior by default', () => {
|
|
78
|
+
const chain = parseSelectorChain('label="Continue"');
|
|
79
|
+
const resolved = resolveSelectorChain(nodes, chain, {
|
|
80
|
+
platform: 'ios',
|
|
81
|
+
requireRect: true,
|
|
82
|
+
requireUnique: true,
|
|
83
|
+
});
|
|
84
|
+
assert.equal(resolved, null);
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
test('resolveSelectorChain disambiguates to deeper/smaller matching node when enabled', () => {
|
|
88
|
+
const disambiguationNodes: SnapshotState['nodes'] = [
|
|
89
|
+
{
|
|
90
|
+
ref: 'e1',
|
|
91
|
+
index: 0,
|
|
92
|
+
type: 'Other',
|
|
93
|
+
label: 'Press me',
|
|
94
|
+
rect: { x: 0, y: 0, width: 300, height: 300 },
|
|
95
|
+
depth: 1,
|
|
96
|
+
enabled: true,
|
|
97
|
+
hittable: true,
|
|
98
|
+
},
|
|
99
|
+
{
|
|
100
|
+
ref: 'e2',
|
|
101
|
+
index: 1,
|
|
102
|
+
type: 'Other',
|
|
103
|
+
label: 'Press me',
|
|
104
|
+
rect: { x: 10, y: 10, width: 100, height: 20 },
|
|
105
|
+
depth: 2,
|
|
106
|
+
enabled: true,
|
|
107
|
+
hittable: true,
|
|
108
|
+
},
|
|
109
|
+
];
|
|
110
|
+
const chain = parseSelectorChain('role="other" label="Press me" || label="Press me"');
|
|
111
|
+
const resolved = resolveSelectorChain(disambiguationNodes, chain, {
|
|
112
|
+
platform: 'ios',
|
|
113
|
+
requireRect: true,
|
|
114
|
+
requireUnique: true,
|
|
115
|
+
disambiguateAmbiguous: true,
|
|
116
|
+
});
|
|
117
|
+
assert.ok(resolved);
|
|
118
|
+
assert.equal(resolved.node.ref, 'e2');
|
|
119
|
+
assert.equal(resolved.matches, 2);
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
test('resolveSelectorChain disambiguation tie falls back to next selector', () => {
|
|
123
|
+
const tieNodes: SnapshotState['nodes'] = [
|
|
124
|
+
{
|
|
125
|
+
ref: 'e1',
|
|
126
|
+
index: 0,
|
|
127
|
+
type: 'Other',
|
|
128
|
+
label: 'Press me',
|
|
129
|
+
rect: { x: 0, y: 0, width: 100, height: 20 },
|
|
130
|
+
depth: 2,
|
|
131
|
+
enabled: true,
|
|
132
|
+
hittable: true,
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
ref: 'e2',
|
|
136
|
+
index: 1,
|
|
137
|
+
type: 'Other',
|
|
138
|
+
label: 'Press me',
|
|
139
|
+
rect: { x: 0, y: 40, width: 100, height: 20 },
|
|
140
|
+
depth: 2,
|
|
141
|
+
enabled: true,
|
|
142
|
+
hittable: true,
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
ref: 'e3',
|
|
146
|
+
index: 2,
|
|
147
|
+
type: 'Other',
|
|
148
|
+
label: 'Press me',
|
|
149
|
+
identifier: 'press_me_unique',
|
|
150
|
+
rect: { x: 0, y: 80, width: 100, height: 20 },
|
|
151
|
+
depth: 2,
|
|
152
|
+
enabled: true,
|
|
153
|
+
hittable: true,
|
|
154
|
+
},
|
|
155
|
+
];
|
|
156
|
+
const chain = parseSelectorChain('label="Press me" || id="press_me_unique"');
|
|
157
|
+
const resolved = resolveSelectorChain(tieNodes, chain, {
|
|
158
|
+
platform: 'ios',
|
|
159
|
+
requireRect: true,
|
|
160
|
+
requireUnique: true,
|
|
161
|
+
disambiguateAmbiguous: true,
|
|
162
|
+
});
|
|
163
|
+
assert.ok(resolved);
|
|
164
|
+
assert.equal(resolved.selectorIndex, 1);
|
|
165
|
+
assert.equal(resolved.node.ref, 'e3');
|
|
166
|
+
});
|
|
167
|
+
|
|
77
168
|
test('findSelectorChainMatch returns first matching selector for existence checks', () => {
|
|
78
169
|
const chain = parseSelectorChain('label="Continue" || id=auth_continue');
|
|
79
170
|
const match = findSelectorChainMatch(nodes, chain, {
|
|
@@ -91,12 +182,31 @@ test('splitSelectorFromArgs extracts selector prefix and trailing value', () =>
|
|
|
91
182
|
assert.deepEqual(split.rest, ['qa@example.com']);
|
|
92
183
|
});
|
|
93
184
|
|
|
185
|
+
test('splitSelectorFromArgs prefers trailing token for value when requested', () => {
|
|
186
|
+
const split = splitSelectorFromArgs(['label="Filter"', 'visible=true'], { preferTrailingValue: true });
|
|
187
|
+
assert.ok(split);
|
|
188
|
+
assert.equal(split.selectorExpression, 'label="Filter"');
|
|
189
|
+
assert.deepEqual(split.rest, ['visible=true']);
|
|
190
|
+
});
|
|
191
|
+
|
|
192
|
+
test('splitSelectorFromArgs keeps full selector when trailing value preference is disabled', () => {
|
|
193
|
+
const split = splitSelectorFromArgs(['label="Filter"', 'visible=true']);
|
|
194
|
+
assert.ok(split);
|
|
195
|
+
assert.equal(split.selectorExpression, 'label="Filter" visible=true');
|
|
196
|
+
assert.deepEqual(split.rest, []);
|
|
197
|
+
});
|
|
198
|
+
|
|
94
199
|
test('parseSelectorChain rejects unknown keys and malformed quotes', () => {
|
|
95
200
|
assert.throws(() => parseSelectorChain('foo=bar'), /Unknown selector key/i);
|
|
96
201
|
assert.throws(() => parseSelectorChain('label="unclosed'), /Unclosed quote/i);
|
|
97
202
|
assert.throws(() => parseSelectorChain(''), /cannot be empty/i);
|
|
98
203
|
});
|
|
99
204
|
|
|
205
|
+
test('parseSelectorChain handles quoted values ending in escaped backslashes', () => {
|
|
206
|
+
const chain = parseSelectorChain('label="path\\\\" || id=auth_continue');
|
|
207
|
+
assert.equal(chain.selectors.length, 2);
|
|
208
|
+
});
|
|
209
|
+
|
|
100
210
|
test('isSelectorToken only accepts known keys for key=value tokens', () => {
|
|
101
211
|
assert.equal(isSelectorToken('id=foo'), true);
|
|
102
212
|
assert.equal(isSelectorToken('editable=true'), true);
|
|
@@ -126,3 +236,26 @@ test('buildSelectorChainForNode prefers id and adds editable for fill action', (
|
|
|
126
236
|
assert.ok(chain.some((entry) => entry.includes('id=')));
|
|
127
237
|
assert.ok(chain.some((entry) => entry.includes('editable=true')));
|
|
128
238
|
});
|
|
239
|
+
|
|
240
|
+
test('role selector normalization matches Android class names by leaf type', () => {
|
|
241
|
+
const androidNodes: SnapshotState['nodes'] = [
|
|
242
|
+
{
|
|
243
|
+
ref: 'a1',
|
|
244
|
+
index: 0,
|
|
245
|
+
type: 'android.widget.Button',
|
|
246
|
+
label: 'Continue',
|
|
247
|
+
identifier: 'auth_continue',
|
|
248
|
+
rect: { x: 0, y: 0, width: 120, height: 44 },
|
|
249
|
+
enabled: true,
|
|
250
|
+
hittable: true,
|
|
251
|
+
},
|
|
252
|
+
];
|
|
253
|
+
const chain = parseSelectorChain('role=button label="Continue"');
|
|
254
|
+
const resolved = resolveSelectorChain(androidNodes, chain, {
|
|
255
|
+
platform: 'android',
|
|
256
|
+
requireRect: true,
|
|
257
|
+
requireUnique: true,
|
|
258
|
+
});
|
|
259
|
+
assert.ok(resolved);
|
|
260
|
+
assert.equal(resolved.node.ref, 'a1');
|
|
261
|
+
});
|
|
@@ -234,6 +234,65 @@ test('replay without --update does not heal or rewrite', async () => {
|
|
|
234
234
|
assert.equal(fs.readFileSync(replayPath, 'utf8'), originalPayload);
|
|
235
235
|
});
|
|
236
236
|
|
|
237
|
+
test('replay --update skips malformed selector candidates and preserves replay error context', async () => {
|
|
238
|
+
const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-device-replay-malformed-candidate-'));
|
|
239
|
+
const sessionsDir = path.join(tempRoot, 'sessions');
|
|
240
|
+
const replayPath = path.join(tempRoot, 'replay.ad');
|
|
241
|
+
const sessionStore = new SessionStore(sessionsDir);
|
|
242
|
+
const sessionName = 'malformed-candidate-session';
|
|
243
|
+
sessionStore.set(sessionName, makeSession(sessionName));
|
|
244
|
+
|
|
245
|
+
writeReplayFile(replayPath, {
|
|
246
|
+
ts: Date.now(),
|
|
247
|
+
command: 'click',
|
|
248
|
+
positionals: ['id="old_continue" ||'],
|
|
249
|
+
flags: {},
|
|
250
|
+
result: {},
|
|
251
|
+
});
|
|
252
|
+
|
|
253
|
+
const dispatch = async (): Promise<Record<string, unknown> | void> => {
|
|
254
|
+
return {
|
|
255
|
+
nodes: [
|
|
256
|
+
{
|
|
257
|
+
index: 0,
|
|
258
|
+
type: 'XCUIElementTypeButton',
|
|
259
|
+
label: 'Continue',
|
|
260
|
+
identifier: 'auth_continue',
|
|
261
|
+
rect: { x: 10, y: 10, width: 100, height: 44 },
|
|
262
|
+
enabled: true,
|
|
263
|
+
hittable: true,
|
|
264
|
+
},
|
|
265
|
+
],
|
|
266
|
+
truncated: false,
|
|
267
|
+
backend: 'xctest',
|
|
268
|
+
};
|
|
269
|
+
};
|
|
270
|
+
|
|
271
|
+
const response = await handleSessionCommands({
|
|
272
|
+
req: {
|
|
273
|
+
token: 't',
|
|
274
|
+
session: sessionName,
|
|
275
|
+
command: 'replay',
|
|
276
|
+
positionals: [replayPath],
|
|
277
|
+
flags: { replayUpdate: true },
|
|
278
|
+
},
|
|
279
|
+
sessionName,
|
|
280
|
+
logPath: path.join(tempRoot, 'daemon.log'),
|
|
281
|
+
sessionStore,
|
|
282
|
+
invoke: async () => ({ ok: false, error: { code: 'COMMAND_FAILED', message: 'selector stale' } }),
|
|
283
|
+
dispatch,
|
|
284
|
+
});
|
|
285
|
+
|
|
286
|
+
assert.ok(response);
|
|
287
|
+
assert.equal(response.ok, false);
|
|
288
|
+
if (!response.ok) {
|
|
289
|
+
assert.equal(response.error.code, 'COMMAND_FAILED');
|
|
290
|
+
assert.match(response.error.message, /Replay failed at step 1/);
|
|
291
|
+
assert.equal(response.error.details?.step, 1);
|
|
292
|
+
assert.equal(response.error.details?.action, 'click');
|
|
293
|
+
}
|
|
294
|
+
});
|
|
295
|
+
|
|
237
296
|
test('replay --update heals selector in is command', async () => {
|
|
238
297
|
const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-device-replay-heal-is-'));
|
|
239
298
|
const sessionsDir = path.join(tempRoot, 'sessions');
|
|
@@ -12,6 +12,7 @@ import {
|
|
|
12
12
|
formatSelectorFailure,
|
|
13
13
|
parseSelectorChain,
|
|
14
14
|
resolveSelectorChain,
|
|
15
|
+
splitIsSelectorArgs,
|
|
15
16
|
splitSelectorFromArgs,
|
|
16
17
|
} from '../selectors.ts';
|
|
17
18
|
|
|
@@ -90,6 +91,7 @@ export async function handleInteractionCommands(params: {
|
|
|
90
91
|
platform: session.device.platform,
|
|
91
92
|
requireRect: true,
|
|
92
93
|
requireUnique: true,
|
|
94
|
+
disambiguateAmbiguous: true,
|
|
93
95
|
});
|
|
94
96
|
if (!resolved || !resolved.node.rect) {
|
|
95
97
|
return {
|
|
@@ -180,7 +182,7 @@ export async function handleInteractionCommands(params: {
|
|
|
180
182
|
error: { code: 'SESSION_NOT_FOUND', message: 'No active session. Run open first.' },
|
|
181
183
|
};
|
|
182
184
|
}
|
|
183
|
-
const selectorArgs = splitSelectorFromArgs(req.positionals ?? []);
|
|
185
|
+
const selectorArgs = splitSelectorFromArgs(req.positionals ?? [], { preferTrailingValue: true });
|
|
184
186
|
if (selectorArgs) {
|
|
185
187
|
if (selectorArgs.rest.length === 0) {
|
|
186
188
|
return { ok: false, error: { code: 'INVALID_ARGS', message: 'fill requires text after selector' } };
|
|
@@ -197,6 +199,7 @@ export async function handleInteractionCommands(params: {
|
|
|
197
199
|
platform: session.device.platform,
|
|
198
200
|
requireRect: true,
|
|
199
201
|
requireUnique: true,
|
|
202
|
+
disambiguateAmbiguous: true,
|
|
200
203
|
});
|
|
201
204
|
if (!resolved || !resolved.node.rect) {
|
|
202
205
|
return {
|
|
@@ -367,8 +370,7 @@ export async function handleInteractionCommands(params: {
|
|
|
367
370
|
error: { code: 'UNSUPPORTED_OPERATION', message: 'is is not supported on this device' },
|
|
368
371
|
};
|
|
369
372
|
}
|
|
370
|
-
const
|
|
371
|
-
const split = splitSelectorFromArgs(selectorArgs);
|
|
373
|
+
const { split } = splitIsSelectorArgs(req.positionals);
|
|
372
374
|
if (!split) {
|
|
373
375
|
return {
|
|
374
376
|
ok: false,
|
|
@@ -11,7 +11,13 @@ import { resolveIosAppStateFromSnapshots } from '../app-state.ts';
|
|
|
11
11
|
import { stopIosRunnerSession } from '../../platforms/ios/runner-client.ts';
|
|
12
12
|
import { attachRefs, type RawSnapshotNode, type SnapshotState } from '../../utils/snapshot.ts';
|
|
13
13
|
import { pruneGroupNodes } from '../snapshot-processing.ts';
|
|
14
|
-
import {
|
|
14
|
+
import {
|
|
15
|
+
buildSelectorChainForNode,
|
|
16
|
+
resolveSelectorChain,
|
|
17
|
+
splitIsSelectorArgs,
|
|
18
|
+
splitSelectorFromArgs,
|
|
19
|
+
tryParseSelectorChain,
|
|
20
|
+
} from '../selectors.ts';
|
|
15
21
|
import { inferFillText, uniqueStrings } from '../action-utils.ts';
|
|
16
22
|
|
|
17
23
|
type ReinstallOps = {
|
|
@@ -514,11 +520,13 @@ async function healReplayAction(params: {
|
|
|
514
520
|
const snapshot = await captureSnapshotForReplay(session, action, logPath, requiresRect, dispatch, sessionStore);
|
|
515
521
|
const selectorCandidates = collectReplaySelectorCandidates(action);
|
|
516
522
|
for (const candidate of selectorCandidates) {
|
|
517
|
-
const chain =
|
|
523
|
+
const chain = tryParseSelectorChain(candidate);
|
|
524
|
+
if (!chain) continue;
|
|
518
525
|
const resolved = resolveSelectorChain(snapshot.nodes, chain, {
|
|
519
526
|
platform: session.device.platform,
|
|
520
527
|
requireRect: requiresRect,
|
|
521
528
|
requireUnique: true,
|
|
529
|
+
disambiguateAmbiguous: requiresRect,
|
|
522
530
|
});
|
|
523
531
|
if (!resolved) continue;
|
|
524
532
|
const selectorChain = buildSelectorChainForNode(resolved.node, session.device.platform, {
|
|
@@ -548,9 +556,8 @@ async function healReplayAction(params: {
|
|
|
548
556
|
};
|
|
549
557
|
}
|
|
550
558
|
if (action.command === 'is') {
|
|
551
|
-
const predicate = action.positionals
|
|
559
|
+
const { predicate, split } = splitIsSelectorArgs(action.positionals);
|
|
552
560
|
if (!predicate) continue;
|
|
553
|
-
const split = splitSelectorFromArgs(action.positionals.slice(1));
|
|
554
561
|
const expectedText = split?.rest.join(' ').trim() ?? '';
|
|
555
562
|
const nextPositionals = [predicate, selectorExpression];
|
|
556
563
|
if (predicate === 'text' && expectedText.length > 0) {
|
|
@@ -641,7 +648,7 @@ function collectReplaySelectorCandidates(action: SessionAction): string[] {
|
|
|
641
648
|
}
|
|
642
649
|
}
|
|
643
650
|
if (action.command === 'is') {
|
|
644
|
-
const split =
|
|
651
|
+
const { split } = splitIsSelectorArgs(action.positionals);
|
|
645
652
|
if (split) {
|
|
646
653
|
result.push(split.selectorExpression);
|
|
647
654
|
}
|
package/src/daemon/selectors.ts
CHANGED
|
@@ -85,25 +85,38 @@ export function resolveSelectorChain(
|
|
|
85
85
|
platform: 'ios' | 'android';
|
|
86
86
|
requireRect?: boolean;
|
|
87
87
|
requireUnique?: boolean;
|
|
88
|
+
disambiguateAmbiguous?: boolean;
|
|
88
89
|
},
|
|
89
90
|
): SelectorResolution | null {
|
|
90
91
|
const requireRect = options.requireRect ?? false;
|
|
91
92
|
const requireUnique = options.requireUnique ?? true;
|
|
93
|
+
const disambiguateAmbiguous = options.disambiguateAmbiguous ?? false;
|
|
92
94
|
const diagnostics: SelectorDiagnostics[] = [];
|
|
93
95
|
for (let i = 0; i < chain.selectors.length; i += 1) {
|
|
94
96
|
const selector = chain.selectors[i];
|
|
95
|
-
const
|
|
96
|
-
|
|
97
|
-
|
|
97
|
+
const summary = analyzeSelectorMatches(nodes, selector, {
|
|
98
|
+
platform: options.platform,
|
|
99
|
+
requireRect,
|
|
98
100
|
});
|
|
99
|
-
diagnostics.push({ selector: selector.raw, matches:
|
|
100
|
-
if (
|
|
101
|
-
if (requireUnique &&
|
|
101
|
+
diagnostics.push({ selector: selector.raw, matches: summary.count });
|
|
102
|
+
if (summary.count === 0 || !summary.firstNode) continue;
|
|
103
|
+
if (requireUnique && summary.count !== 1) {
|
|
104
|
+
if (!disambiguateAmbiguous) continue;
|
|
105
|
+
const disambiguatedNode = summary.disambiguated;
|
|
106
|
+
if (!disambiguatedNode) continue;
|
|
107
|
+
return {
|
|
108
|
+
node: disambiguatedNode,
|
|
109
|
+
selector,
|
|
110
|
+
selectorIndex: i,
|
|
111
|
+
matches: summary.count,
|
|
112
|
+
diagnostics,
|
|
113
|
+
};
|
|
114
|
+
}
|
|
102
115
|
return {
|
|
103
|
-
node:
|
|
116
|
+
node: summary.firstNode,
|
|
104
117
|
selector,
|
|
105
118
|
selectorIndex: i,
|
|
106
|
-
matches:
|
|
119
|
+
matches: summary.count,
|
|
107
120
|
diagnostics,
|
|
108
121
|
};
|
|
109
122
|
}
|
|
@@ -122,13 +135,13 @@ export function findSelectorChainMatch(
|
|
|
122
135
|
const diagnostics: SelectorDiagnostics[] = [];
|
|
123
136
|
for (let i = 0; i < chain.selectors.length; i += 1) {
|
|
124
137
|
const selector = chain.selectors[i];
|
|
125
|
-
const matches = nodes
|
|
126
|
-
|
|
127
|
-
|
|
138
|
+
const matches = countSelectorMatchesOnly(nodes, selector, {
|
|
139
|
+
platform: options.platform,
|
|
140
|
+
requireRect,
|
|
128
141
|
});
|
|
129
|
-
diagnostics.push({ selector: selector.raw, matches
|
|
130
|
-
if (matches
|
|
131
|
-
return { selectorIndex: i, selector, matches
|
|
142
|
+
diagnostics.push({ selector: selector.raw, matches });
|
|
143
|
+
if (matches > 0) {
|
|
144
|
+
return { selectorIndex: i, selector, matches, diagnostics };
|
|
132
145
|
}
|
|
133
146
|
}
|
|
134
147
|
return null;
|
|
@@ -162,21 +175,51 @@ export function isSelectorToken(token: string): boolean {
|
|
|
162
175
|
return ALL_KEYS.has(trimmed.toLowerCase() as SelectorKey);
|
|
163
176
|
}
|
|
164
177
|
|
|
165
|
-
export function splitSelectorFromArgs(
|
|
178
|
+
export function splitSelectorFromArgs(
|
|
179
|
+
args: string[],
|
|
180
|
+
options: { preferTrailingValue?: boolean } = {},
|
|
181
|
+
): { selectorExpression: string; rest: string[] } | null {
|
|
166
182
|
if (args.length === 0) return null;
|
|
183
|
+
const preferTrailingValue = options.preferTrailingValue ?? false;
|
|
167
184
|
let i = 0;
|
|
185
|
+
const boundaries: number[] = [];
|
|
168
186
|
while (i < args.length && isSelectorToken(args[i])) {
|
|
169
187
|
i += 1;
|
|
188
|
+
const candidate = args.slice(0, i).join(' ').trim();
|
|
189
|
+
if (!candidate) continue;
|
|
190
|
+
if (tryParseSelectorChain(candidate)) {
|
|
191
|
+
boundaries.push(i);
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
if (boundaries.length === 0) return null;
|
|
195
|
+
let boundary = boundaries[boundaries.length - 1];
|
|
196
|
+
if (preferTrailingValue) {
|
|
197
|
+
for (let j = boundaries.length - 1; j >= 0; j -= 1) {
|
|
198
|
+
if (boundaries[j] < args.length) {
|
|
199
|
+
boundary = boundaries[j];
|
|
200
|
+
break;
|
|
201
|
+
}
|
|
202
|
+
}
|
|
170
203
|
}
|
|
171
|
-
|
|
172
|
-
const selectorExpression = args.slice(0, i).join(' ').trim();
|
|
204
|
+
const selectorExpression = args.slice(0, boundary).join(' ').trim();
|
|
173
205
|
if (!selectorExpression) return null;
|
|
174
206
|
return {
|
|
175
207
|
selectorExpression,
|
|
176
|
-
rest: args.slice(
|
|
208
|
+
rest: args.slice(boundary),
|
|
177
209
|
};
|
|
178
210
|
}
|
|
179
211
|
|
|
212
|
+
export function splitIsSelectorArgs(positionals: string[]): {
|
|
213
|
+
predicate: string;
|
|
214
|
+
split: { selectorExpression: string; rest: string[] } | null;
|
|
215
|
+
} {
|
|
216
|
+
const predicate = positionals[0] ?? '';
|
|
217
|
+
const split = splitSelectorFromArgs(positionals.slice(1), {
|
|
218
|
+
preferTrailingValue: predicate === 'text',
|
|
219
|
+
});
|
|
220
|
+
return { predicate, split };
|
|
221
|
+
}
|
|
222
|
+
|
|
180
223
|
export function isNodeVisible(node: SnapshotNode): boolean {
|
|
181
224
|
if (node.hittable === true) return true;
|
|
182
225
|
if (!node.rect) return false;
|
|
@@ -318,7 +361,7 @@ function splitByFallback(expression: string): string[] {
|
|
|
318
361
|
let quote: '"' | "'" | null = null;
|
|
319
362
|
for (let i = 0; i < expression.length; i += 1) {
|
|
320
363
|
const ch = expression[i];
|
|
321
|
-
if ((ch === '"' || ch === "'") && expression
|
|
364
|
+
if ((ch === '"' || ch === "'") && !isEscapedQuote(expression, i)) {
|
|
322
365
|
if (!quote) {
|
|
323
366
|
quote = ch;
|
|
324
367
|
} else if (quote === ch) {
|
|
@@ -353,7 +396,7 @@ function tokenize(segment: string): string[] {
|
|
|
353
396
|
let quote: '"' | "'" | null = null;
|
|
354
397
|
for (let i = 0; i < segment.length; i += 1) {
|
|
355
398
|
const ch = segment[i];
|
|
356
|
-
if ((ch === '"' || ch === "'") && segment
|
|
399
|
+
if ((ch === '"' || ch === "'") && !isEscapedQuote(segment, i)) {
|
|
357
400
|
if (!quote) {
|
|
358
401
|
quote = ch;
|
|
359
402
|
} else if (quote === ch) {
|
|
@@ -421,3 +464,78 @@ function normalizeSelectorText(value: string | undefined): string | null {
|
|
|
421
464
|
if (!trimmed) return null;
|
|
422
465
|
return trimmed;
|
|
423
466
|
}
|
|
467
|
+
|
|
468
|
+
function analyzeSelectorMatches(
|
|
469
|
+
nodes: SnapshotState['nodes'],
|
|
470
|
+
selector: Selector,
|
|
471
|
+
options: { platform: 'ios' | 'android'; requireRect: boolean },
|
|
472
|
+
): { count: number; firstNode: SnapshotNode | null; disambiguated: SnapshotNode | null } {
|
|
473
|
+
let count = 0;
|
|
474
|
+
let firstNode: SnapshotNode | null = null;
|
|
475
|
+
let best: SnapshotNode | null = null;
|
|
476
|
+
let tie = false;
|
|
477
|
+
for (const node of nodes) {
|
|
478
|
+
if (options.requireRect && !node.rect) continue;
|
|
479
|
+
if (!matchesSelector(node, selector, options.platform)) continue;
|
|
480
|
+
count += 1;
|
|
481
|
+
if (!firstNode) {
|
|
482
|
+
firstNode = node;
|
|
483
|
+
}
|
|
484
|
+
if (!best) {
|
|
485
|
+
best = node;
|
|
486
|
+
tie = false;
|
|
487
|
+
continue;
|
|
488
|
+
}
|
|
489
|
+
const comparison = compareDisambiguationCandidates(node, best);
|
|
490
|
+
if (comparison > 0) {
|
|
491
|
+
best = node;
|
|
492
|
+
tie = false;
|
|
493
|
+
continue;
|
|
494
|
+
}
|
|
495
|
+
if (comparison === 0) {
|
|
496
|
+
tie = true;
|
|
497
|
+
}
|
|
498
|
+
}
|
|
499
|
+
return {
|
|
500
|
+
count,
|
|
501
|
+
firstNode,
|
|
502
|
+
disambiguated: tie ? null : best,
|
|
503
|
+
};
|
|
504
|
+
}
|
|
505
|
+
|
|
506
|
+
function countSelectorMatchesOnly(
|
|
507
|
+
nodes: SnapshotState['nodes'],
|
|
508
|
+
selector: Selector,
|
|
509
|
+
options: { platform: 'ios' | 'android'; requireRect: boolean },
|
|
510
|
+
): number {
|
|
511
|
+
let count = 0;
|
|
512
|
+
for (const node of nodes) {
|
|
513
|
+
if (options.requireRect && !node.rect) continue;
|
|
514
|
+
if (!matchesSelector(node, selector, options.platform)) continue;
|
|
515
|
+
count += 1;
|
|
516
|
+
}
|
|
517
|
+
return count;
|
|
518
|
+
}
|
|
519
|
+
|
|
520
|
+
function compareDisambiguationCandidates(a: SnapshotNode, b: SnapshotNode): number {
|
|
521
|
+
const depthA = a.depth ?? 0;
|
|
522
|
+
const depthB = b.depth ?? 0;
|
|
523
|
+
if (depthA !== depthB) return depthA > depthB ? 1 : -1;
|
|
524
|
+
const areaA = areaOfNode(a);
|
|
525
|
+
const areaB = areaOfNode(b);
|
|
526
|
+
if (areaA !== areaB) return areaA < areaB ? 1 : -1;
|
|
527
|
+
return 0;
|
|
528
|
+
}
|
|
529
|
+
|
|
530
|
+
function areaOfNode(node: SnapshotNode): number {
|
|
531
|
+
if (!node.rect) return Number.POSITIVE_INFINITY;
|
|
532
|
+
return node.rect.width * node.rect.height;
|
|
533
|
+
}
|
|
534
|
+
|
|
535
|
+
function isEscapedQuote(source: string, index: number): boolean {
|
|
536
|
+
let backslashCount = 0;
|
|
537
|
+
for (let i = index - 1; i >= 0 && source[i] === '\\'; i -= 1) {
|
|
538
|
+
backslashCount += 1;
|
|
539
|
+
}
|
|
540
|
+
return backslashCount % 2 === 1;
|
|
541
|
+
}
|
|
@@ -78,10 +78,14 @@ export function pruneGroupNodes(nodes: RawSnapshotNode[]): RawSnapshotNode[] {
|
|
|
78
78
|
}
|
|
79
79
|
|
|
80
80
|
export function normalizeType(type: string): string {
|
|
81
|
-
let value = type.replace(/XCUIElementType/gi, '').toLowerCase();
|
|
81
|
+
let value = type.trim().replace(/XCUIElementType/gi, '').toLowerCase();
|
|
82
82
|
if (value.startsWith('ax')) {
|
|
83
83
|
value = value.replace(/^ax/, '');
|
|
84
84
|
}
|
|
85
|
+
const lastSeparator = Math.max(value.lastIndexOf('.'), value.lastIndexOf('/'));
|
|
86
|
+
if (lastSeparator !== -1) {
|
|
87
|
+
value = value.slice(lastSeparator + 1);
|
|
88
|
+
}
|
|
85
89
|
return value;
|
|
86
90
|
}
|
|
87
91
|
|