agent-device 0.5.5 → 0.6.0

package/README.md

@@ -15,7 +15,7 @@ The project is in early development and considered experimental. Pull requests a
 ## Features
 - Platforms: iOS (simulator + physical device core automation) and Android (emulator + device).
 - Core commands: `open`, `back`, `home`, `app-switcher`, `press`, `long-press`, `focus`, `type`, `fill`, `scroll`, `scrollintoview`, `wait`, `alert`, `screenshot`, `close`, `reinstall`.
-- Inspection commands: `snapshot` (accessibility tree), `appstate`, `apps`, `devices`.
+- Inspection commands: `snapshot` (accessibility tree), `diff snapshot` (structural baseline diff), `appstate`, `apps`, `devices`.
 - Device tooling: `adb` (Android), `simctl`/`devicectl` (iOS via Xcode).
 - Minimal dependencies; TypeScript executed directly on Node 22+ (no build step).
 
@@ -40,6 +40,7 @@ Use `press` as the canonical tap command; `click` is an equivalent alias.
 agent-device open Contacts --platform ios # creates session on iOS Simulator
 agent-device snapshot
 agent-device press @e5
+agent-device diff snapshot # subsequent runs compare against previous baseline
 agent-device fill @e6 "John"
 agent-device fill @e7 "Doe"
 agent-device press @e3
@@ -118,7 +119,7 @@ agent-device trace stop ./trace.log
 ```
 
 Coordinates:
-- All coordinate-based commands (`press`, `long-press`, `swipe`, `focus`, `fill`) use device coordinates with origin at top-left.
+- All coordinate-based commands (`press`, `longpress`, `swipe`, `focus`, `fill`) use device coordinates with origin at top-left.
 - X increases to the right, Y increases downward.
 - `press` is the canonical tap command.
 - `click` is an equivalent alias and accepts the same targets (`x y`, `@ref`, selector) and flags.
@@ -130,12 +131,14 @@ agent-device press 300 500 --count 12 --interval-ms 45
 agent-device press 300 500 --count 6 --hold-ms 120 --interval-ms 30 --jitter-px 2
 agent-device press @e5 --count 5 --double-tap
 agent-device swipe 540 1500 540 500 120 --count 8 --pause-ms 30 --pattern ping-pong
+agent-device scrollintoview "Sign in"
+agent-device scrollintoview @e42
 ```
 
 ## Command Index
 - `boot`, `open`, `close`, `reinstall`, `home`, `back`, `app-switcher`
 - `batch`
-- `snapshot`, `find`, `get`
+- `snapshot`, `diff snapshot`, `find`, `get`
 - `press` (alias: `click`), `focus`, `type`, `fill`, `long-press`, `swipe`, `scroll`, `scrollintoview`, `pinch`, `is`
 - `alert`, `wait`, `screenshot`
 - `trace start`, `trace stop`
@@ -149,6 +152,20 @@ Notes:
 - iOS snapshots use XCTest on simulators and physical devices.
 - Scope snapshots with `-s "<label>"` or `-s @ref`.
 - If XCTest returns 0 nodes (e.g., foreground app changed), agent-device fails explicitly.
+- `diff snapshot` uses the same snapshot flags and compares the current capture with the previous session baseline, then updates baseline.
+
+Diff snapshots:
+- Run `diff snapshot` once to initialize baseline for the current session.
+- Run `diff snapshot` again after UI changes to get unified-style output (`-` removed, `+` added, unchanged context).
+- Use `--json` to get `{ mode, baselineInitialized, summary, lines }`.
+
+Efficient snapshot usage:
+- Default to `snapshot -i` for iterative agent loops.
+- Add `-s "<label>"` (or `-s @ref`) for screen-local work to reduce payload size.
+- Add `-d <depth>` when lower tree levels are not needed.
+- Re-snapshot after UI mutations before reusing refs.
+- Use `diff snapshot` for low-noise structural change verification between adjacent states.
+- Reserve `--raw` for troubleshooting and parser/debug investigations.
 
 Flags:
 - `--version, -V` print version and exit
@@ -179,7 +196,8 @@ Pinch:
 Swipe timing:
 - `swipe` accepts optional `durationMs` (default `250`, range `16..10000`).
 - Android uses requested swipe duration directly.
-- iOS uses a safe normalized duration to avoid long-press side effects.
+- iOS clamps swipe duration to a safe range (`16..60ms`) to avoid longpress side effects.
+- `scrollintoview` accepts either plain text or a snapshot ref (`@eN`); ref mode uses best-effort geometry-based scrolling without post-scroll verification. Run `snapshot` again before follow-up `@ref` commands.
 
 ## Skills
 Install the automation skills listed in [SKILL.md](skills/agent-device/SKILL.md).
@@ -304,8 +322,15 @@ Diagnostics files:
 - Built-in aliases include `Settings` for both platforms.
 
 ## iOS notes
-- Core runner commands: `snapshot`, `wait`, `click`, `fill`, `get`, `is`, `find`, `press`, `long-press`, `focus`, `type`, `scroll`, `scrollintoview`, `back`, `home`, `app-switcher`.
-- Simulator-only commands: `alert`, `pinch`, `record`, `settings`.
+- Core runner commands: `snapshot`, `wait`, `click`, `fill`, `get`, `is`, `find`, `press`, `longpress`, `focus`, `type`, `scroll`, `scrollintoview`, `back`, `home`, `app-switcher`.
+- Simulator-only commands: `alert`, `pinch`, `settings`.
+- `record` supports iOS simulators and physical iOS devices.
+  - iOS simulator recording uses native `simctl io ... recordVideo`.
+  - Physical iOS device recording is runner-based and built from repeated `XCUIScreen.main.screenshot()` frames (no native video stream/audio capture).
+  - Physical iOS device recording requires an active app session context (`open <app>` first) so capture targets your app instead of the runner host app.
+  - Physical iOS device capture is best-effort: dropped frames are expected and true 60 FPS is not guaranteed even with `--fps 60`.
+  - Physical iOS device recording defaults to uncapped (max available) FPS.
+  - Use `agent-device record start [path] --fps <n>` (1-120) to set an explicit FPS cap on physical iOS devices.
 - iOS device runs require valid signing/provisioning (Automatic Signing recommended). Optional overrides: `AGENT_DEVICE_IOS_TEAM_ID`, `AGENT_DEVICE_IOS_SIGNING_IDENTITY`, `AGENT_DEVICE_IOS_PROVISIONING_PROFILE`.
 
 ## Testing
@@ -337,7 +362,7 @@ Environment selectors:
 - `AGENT_DEVICE_IOS_SIGNING_IDENTITY=<identity>` optional signing identity override.
 - `AGENT_DEVICE_IOS_PROVISIONING_PROFILE=<profile>` optional provisioning profile specifier for iOS device runner signing.
 - `AGENT_DEVICE_IOS_RUNNER_DERIVED_PATH=<path>` optional override for iOS runner derived data root. By default, simulator uses `~/.agent-device/ios-runner/derived` and physical device uses `~/.agent-device/ios-runner/derived/device`. If you set this override, use separate paths per kind to avoid simulator/device artifact collisions.
-- `AGENT_DEVICE_IOS_CLEAN_DERIVED=1` rebuild iOS runner artifacts from scratch. When `AGENT_DEVICE_IOS_RUNNER_DERIVED_PATH` is set, cleanup is blocked by default; set `AGENT_DEVICE_IOS_ALLOW_OVERRIDE_DERIVED_CLEAN=1` only for trusted custom paths.
+- `AGENT_DEVICE_IOS_CLEAN_DERIVED=1` rebuild iOS runner artifacts from scratch for runtime daemon-triggered builds (`pnpm ad ...`) on the selected path. `pnpm build:xcuitest`/`pnpm build:all` already clear `~/.agent-device/ios-runner/derived/device` and do not require this variable. When `AGENT_DEVICE_IOS_RUNNER_DERIVED_PATH` is set, cleanup is blocked by default; set `AGENT_DEVICE_IOS_ALLOW_OVERRIDE_DERIVED_CLEAN=1` only for trusted custom paths.
 
 Test screenshots are written to:
 - `test/screenshots/android-settings.png`

package/dist/src/350.js

@@ -0,0 +1,3 @@
+import{AsyncLocalStorage as e}from"node:async_hooks";import t from"node:crypto";import r,{promises as n}from"node:fs";import o from"node:os";import i from"node:path";import{fileURLToPath as a,pathToFileURL as s}from"node:url";import{spawn as c,spawnSync as l}from"node:child_process";let d=new e,u=/(token|secret|password|authorization|cookie|api[_-]?key|access[_-]?key|private[_-]?key)/i,f=/(bearer\s+[a-z0-9._-]+|(?:api[_-]?key|token|secret|password)\s*[=:]\s*\S+)/i;function m(){return t.randomBytes(8).toString("hex")}async function p(e,r){let n={...e,diagnosticId:`${Date.now().toString(36)}-${t.randomBytes(4).toString("hex")}`,events:[]};return await d.run(n,r)}function h(){let e=d.getStore();return e?{diagnosticId:e.diagnosticId,requestId:e.requestId,session:e.session,command:e.command,debug:e.debug}:{}}function w(e){let t=d.getStore();if(!t)return;let n={ts:new Date().toISOString(),level:e.level??"info",phase:e.phase,session:t.session,requestId:t.requestId,command:t.command,durationMs:e.durationMs,data:e.data?y(e.data):void 0};if(t.events.push(n),!t.debug)return;let o=`[agent-device][diag] ${JSON.stringify(n)}
+`;try{t.logPath&&r.appendFile(t.logPath,o,()=>{}),t.traceLogPath&&r.appendFile(t.traceLogPath,o,()=>{}),t.logPath||t.traceLogPath||process.stderr.write(o)}catch{}}async function g(e,t,r){let n=Date.now();try{let o=await t();return w({level:"info",phase:e,durationMs:Date.now()-n,data:r}),o}catch(t){throw w({level:"error",phase:e,durationMs:Date.now()-n,data:{...r??{},error:t instanceof Error?t.message:String(t)}}),t}}function S(e={}){let t=d.getStore();if(!t||!e.force&&!t.debug||0===t.events.length)return null;try{let e=(t.session??"default").replace(/[^a-zA-Z0-9._-]/g,"_"),n=new Date().toISOString().slice(0,10),a=i.join(o.homedir(),".agent-device","logs",e,n);r.mkdirSync(a,{recursive:!0});let s=new Date().toISOString().replace(/[:.]/g,"-"),c=i.join(a,`${s}-${t.diagnosticId}.ndjson`),l=t.events.map(e=>JSON.stringify(y(e)));return r.writeFileSync(c,`${l.join("\n")}
+`),t.events=[],c}catch{return null}}function y(e){return function e(t,r,n){if(null==t)return t;if("string"==typeof t){var o=t,i=n;let e=o.trim();if(!e)return o;if(i&&u.test(i)||f.test(e))return"[REDACTED]";let r=function(e){try{let t=new URL(e);return t.search&&(t.search="?REDACTED"),(t.username||t.password)&&(t.username="REDACTED",t.password="REDACTED"),t.toString()}catch{return null}}(e);return r||(e.length>400?`${e.slice(0,200)}...<truncated>`:e)}if("object"!=typeof t)return t;if(r.has(t))return"[Circular]";if(r.add(t),Array.isArray(t))return t.map(t=>e(t,r));let a={};for(let[n,o]of Object.entries(t)){if(u.test(n)){a[n]="[REDACTED]";continue}a[n]=e(o,r,n)}return a}(e,new WeakSet)}class v extends Error{code;details;cause;constructor(e,t,r,n){super(t),this.code=e,this.details=r,this.cause=n}}function A(e){return e instanceof v?e:e instanceof Error?new v("UNKNOWN",e.message,void 0,e):new v("UNKNOWN","Unknown error",{err:e})}function I(e,t={}){let r=A(e),n=r.details?y(r.details):void 0,o=n&&"string"==typeof n.hint?n.hint:void 0,i=(n&&"string"==typeof n.diagnosticId?n.diagnosticId:void 0)??t.diagnosticId,a=(n&&"string"==typeof n.logPath?n.logPath:void 0)??t.logPath,s=o??function(e){switch(e){case"INVALID_ARGS":return"Check command arguments and run --help for usage examples.";case"SESSION_NOT_FOUND":return"Run open first or pass an explicit device selector.";case"TOOL_MISSING":return"Install required platform tooling and ensure it is available in PATH.";case"DEVICE_NOT_FOUND":return"Verify the target device is booted/connected and selectors match.";case"UNSUPPORTED_OPERATION":return"This command is not available for the selected platform/device.";case"COMMAND_FAILED":default:return"Retry with --debug and inspect diagnostics log for details.";case"UNAUTHORIZED":return"Refresh daemon metadata and retry the command."}}(r.code),c=function(e){if(!e)return;let t={...e};return delete t.hint,delete t.diagnosticId,delete t.logPath,Object.keys(t).length>0?t:void 0}(n);return{code:r.code,message:r.message,hint:s,diagnosticId:i,logPath:a,details:c}}function D(e){let t=[],r=[];for(let n of e){let e=n.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let o=n.label?.trim()||n.value?.trim()||n.identifier?.trim()||"",i=N(n.type??"Element"),a="group"===i&&!o;a&&t.push(e);let s=a?e:Math.max(0,e-t.length);r.push({node:n,depth:s,type:i,text:b(n,s,a,i)})}return r}function b(e,t,r,n){let o=n??N(e.type??"Element"),i=E(e,o),a="  ".repeat(t),s=e.ref?`@${e.ref}`:"",c=[!1===e.enabled?"disabled":null].filter(Boolean).join(", "),l=c?` [${c}]`:"",d=i?` "${i}"`:"";return r?`${a}${s} [${o}]${l}`.trimEnd():`${a}${s} [${o}]${d}${l}`.trimEnd()}function E(e,t){var r,n;let o=e.label?.trim(),i=e.value?.trim();if("text-field"===(r=t)||"text-view"===r||"search"===r){if(i)return i;if(o)return o}else if(o)return o;if(i)return i;let a=e.identifier?.trim();return!a||(n=a,/^[\w.]+:id\/[\w.-]+$/i.test(n)&&("group"===t||"image"===t||"list"===t||"collection"===t))?"":a}function N(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),r=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,"")),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return r?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}function $(){try{let e=_();return JSON.parse(r.readFileSync(i.join(e,"package.json"),"utf8")).version??"0.0.0"}catch{return"0.0.0"}}function _(){let e=i.dirname(a(import.meta.url)),t=e;for(let e=0;e<6;e+=1){let e=i.join(t,"package.json");if(r.existsSync(e))return t;t=i.dirname(t)}return e}async function M(e,t,r={}){return new Promise((n,o)=>{let i=c(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],detached:r.detached}),a="",s=r.binaryStdout?Buffer.alloc(0):void 0,l="",d=!1,u=F(r.timeoutMs),f=u?setTimeout(()=>{d=!0,i.kill("SIGKILL")},u):null;r.binaryStdout||i.stdout.setEncoding("utf8"),i.stderr.setEncoding("utf8"),void 0!==r.stdin&&i.stdin.write(r.stdin),i.stdin.end(),i.stdout.on("data",e=>{r.binaryStdout?s=Buffer.concat([s??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]):a+=e}),i.stderr.on("data",e=>{l+=e}),i.on("error",r=>{(f&&clearTimeout(f),"ENOENT"===r.code)?o(new v("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):o(new v("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),i.on("close",i=>{f&&clearTimeout(f);let c=i??1;d&&u?o(new v("COMMAND_FAILED",`${e} timed out after ${u}ms`,{cmd:e,args:t,stdout:a,stderr:l,exitCode:c,timeoutMs:u})):0===c||r.allowFailure?n({stdout:a,stderr:l,exitCode:c,stdoutBuffer:s}):o(new v("COMMAND_FAILED",`${e} exited with code ${c}`,{cmd:e,args:t,stdout:a,stderr:l,exitCode:c}))})})}async function O(e){try{var t;let{shell:r,args:n}=(t=e,"win32"===process.platform?{shell:"cmd.exe",args:["/c","where",t]}:{shell:"bash",args:["-lc",`command -v ${t}`]}),o=await M(r,n,{allowFailure:!0});return 0===o.exitCode&&o.stdout.trim().length>0}catch{return!1}}function T(e,t,r={}){let n=l(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],encoding:r.binaryStdout?void 0:"utf8",input:r.stdin,timeout:F(r.timeoutMs)});if(n.error){let o=n.error.code;if("ETIMEDOUT"===o)throw new v("COMMAND_FAILED",`${e} timed out after ${F(r.timeoutMs)}ms`,{cmd:e,args:t,timeoutMs:F(r.timeoutMs)},n.error);if("ENOENT"===o)throw new v("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n.error);throw new v("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n.error)}let o=r.binaryStdout?Buffer.isBuffer(n.stdout)?n.stdout:Buffer.from(n.stdout??""):void 0,i=r.binaryStdout?"":"string"==typeof n.stdout?n.stdout:(n.stdout??"").toString(),a="string"==typeof n.stderr?n.stderr:(n.stderr??"").toString(),s=n.status??1;if(0!==s&&!r.allowFailure)throw new v("COMMAND_FAILED",`${e} exited with code ${s}`,{cmd:e,args:t,stdout:i,stderr:a,exitCode:s});return{stdout:i,stderr:a,exitCode:s,stdoutBuffer:o}}function L(e,t,r={}){c(e,t,{cwd:r.cwd,env:r.env,stdio:"ignore",detached:!0}).unref()}async function x(e,t,r={}){return new Promise((n,o)=>{let i=c(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],detached:r.detached});r.onSpawn?.(i);let a="",s="",l=r.binaryStdout?Buffer.alloc(0):void 0;r.binaryStdout||i.stdout.setEncoding("utf8"),i.stderr.setEncoding("utf8"),void 0!==r.stdin&&i.stdin.write(r.stdin),i.stdin.end(),i.stdout.on("data",e=>{if(r.binaryStdout){l=Buffer.concat([l??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]);return}let t=String(e);a+=t,r.onStdoutChunk?.(t)}),i.stderr.on("data",e=>{let t=String(e);s+=t,r.onStderrChunk?.(t)}),i.on("error",r=>{"ENOENT"===r.code?o(new v("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):o(new v("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),i.on("close",i=>{let c=i??1;0===c||r.allowFailure?n({stdout:a,stderr:s,exitCode:c,stdoutBuffer:l}):o(new v("COMMAND_FAILED",`${e} exited with code ${c}`,{cmd:e,args:t,stdout:a,stderr:s,exitCode:c}))})})}function C(e,t,r={}){let n=c(e,t,{cwd:r.cwd,env:r.env,stdio:["ignore","pipe","pipe"],detached:r.detached}),o="",i="";n.stdout.setEncoding("utf8"),n.stderr.setEncoding("utf8"),n.stdout.on("data",e=>{o+=e}),n.stderr.on("data",e=>{i+=e});let a=new Promise((a,s)=>{n.on("error",r=>{"ENOENT"===r.code?s(new v("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):s(new v("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),n.on("close",n=>{let c=n??1;0===c||r.allowFailure?a({stdout:o,stderr:i,exitCode:c}):s(new v("COMMAND_FAILED",`${e} exited with code ${c}`,{cmd:e,args:t,stdout:o,stderr:i,exitCode:c}))})});return{child:n,wait:a}}function F(e){if(!Number.isFinite(e))return;let t=Math.floor(e);if(!(t<=0))return t}let R=[/(^|[\/\s"'=])dist\/src\/daemon\.js($|[\s"'])/,/(^|[\/\s"'=])src\/daemon\.ts($|[\s"'])/];function P(e){if(!Number.isInteger(e)||e<=0)return!1;try{return process.kill(e,0),!0}catch(e){return"EPERM"===e.code}}function k(e){if(!Number.isInteger(e)||e<=0)return null;try{let t=T("ps",["-p",String(e),"-o","lstart="],{allowFailure:!0,timeoutMs:1e3});if(0!==t.exitCode)return null;let r=t.stdout.trim();return r.length>0?r:null}catch{return null}}function B(e,t){let r;if(!P(e))return!1;if(t){let r=k(e);if(!r||r!==t)return!1}let n=function(e){if(!Number.isInteger(e)||e<=0)return null;try{let t=T("ps",["-p",String(e),"-o","command="],{allowFailure:!0,timeoutMs:1e3});if(0!==t.exitCode)return null;let r=t.stdout.trim();return r.length>0?r:null}catch{return null}}(e);return!!n&&!!(r=n.toLowerCase().replaceAll("\\","/")).includes("agent-device")&&R.some(e=>e.test(r))}function G(e,t){try{return process.kill(e,t),!0}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return!1;throw t}}async function j(e,t){if(!P(e))return!0;let r=Date.now();for(;Date.now()-r<t;)if(await new Promise(e=>setTimeout(e,50)),!P(e))return!0;return!P(e)}async function U(e,t){!B(e,t.expectedStartTime)||!G(e,"SIGTERM")||await j(e,t.termTimeoutMs)||G(e,"SIGKILL")&&await j(e,t.killTimeoutMs)}let V=100,q=new Set(["batch","replay"]);function H(e){let t;try{t=JSON.parse(e)}catch{throw new v("INVALID_ARGS","Batch steps must be valid JSON.")}if(!Array.isArray(t)||0===t.length)throw new v("INVALID_ARGS","Batch steps must be a non-empty JSON array.");return t}function J(e,t){if(!Array.isArray(e)||0===e.length)throw new v("INVALID_ARGS","batch requires a non-empty batchSteps array.");if(e.length>t)throw new v("INVALID_ARGS",`batch has ${e.length} steps; max allowed is ${t}.`);let r=[];for(let t=0;t<e.length;t+=1){let n=e[t];if(!n||"object"!=typeof n)throw new v("INVALID_ARGS",`Invalid batch step at index ${t}.`);let o="string"==typeof n.command?n.command.trim().toLowerCase():"";if(!o)throw new v("INVALID_ARGS",`Batch step ${t+1} requires command.`);if(q.has(o))throw new v("INVALID_ARGS",`Batch step ${t+1} cannot run ${o}.`);if(void 0!==n.positionals&&!Array.isArray(n.positionals))throw new v("INVALID_ARGS",`Batch step ${t+1} positionals must be an array.`);let i=n.positionals??[];if(i.some(e=>"string"!=typeof e))throw new v("INVALID_ARGS",`Batch step ${t+1} positionals must contain only strings.`);if(void 0!==n.flags&&("object"!=typeof n.flags||Array.isArray(n.flags)||!n.flags))throw new v("INVALID_ARGS",`Batch step ${t+1} flags must be an object.`);r.push({command:o,positionals:i,flags:n.flags??{}})}return r}export{default as node_net}from"node:net";export{v as AppError,V as DEFAULT_BATCH_MAX_STEPS,A as asAppError,D as buildSnapshotDisplayLines,m as createRequestId,E as displayLabel,w as emitDiagnostic,a as fileURLToPath,_ as findProjectRoot,S as flushDiagnosticsToSessionFile,N as formatRole,b as formatSnapshotLine,h as getDiagnosticsMeta,B as isAgentDeviceDaemonProcess,P as isProcessAlive,t as node_crypto,r as node_fs,o as node_os,i as node_path,I as normalizeError,H as parseBatchStepsJson,s as pathToFileURL,n as promises,k as readProcessStartTime,$ as readVersion,M as runCmd,C as runCmdBackground,L as runCmdDetached,x as runCmdStreaming,T as runCmdSync,U as stopProcessForTakeover,J as validateAndNormalizeBatchSteps,O as whichCmd,g as withDiagnosticTimer,p as withDiagnosticsScope};

package/dist/src/bin.js

@@ -1,57 +1,61 @@
-import{createRequestId as e,node_path as t,parseBatchStepsJson as s,normalizeError as a,isAgentDeviceDaemonProcess as r,runCmdDetached as i,readVersion as o,findProjectRoot as n,getDiagnosticsMeta as l,withDiagnosticTimer as c,emitDiagnostic as p,asAppError as d,pathToFileURL as u,AppError as g,node_fs as m,node_os as f,flushDiagnosticsToSessionFile as h,node_net as w,withDiagnosticsScope as y,stopProcessForTakeover as v}from"./407.js";let b=["snapshotDepth","snapshotScope","snapshotRaw"],x=[{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","android"],usageLabel:"--platform ios|android",usageDescription:"Platform to target"},{key:"device",names:["--device"],type:"string",usageLabel:"--device <name>",usageDescription:"Device name to target"},{key:"udid",names:["--udid"],type:"string",usageLabel:"--udid <udid>",usageDescription:"iOS device UDID"},{key:"serial",names:["--serial"],type:"string",usageLabel:"--serial <serial>",usageDescription:"Android device serial"},{key:"activity",names:["--activity"],type:"string",usageLabel:"--activity <component>",usageDescription:"Android app launch activity (package/Activity); not for URL opens"},{key:"session",names:["--session"],type:"string",usageLabel:"--session <name>",usageDescription:"Named session"},{key:"count",names:["--count"],type:"int",min:1,max:200,usageLabel:"--count <n>",usageDescription:"Repeat count for press/swipe series"},{key:"intervalMs",names:["--interval-ms"],type:"int",min:0,max:1e4,usageLabel:"--interval-ms <ms>",usageDescription:"Delay between press iterations"},{key:"holdMs",names:["--hold-ms"],type:"int",min:0,max:1e4,usageLabel:"--hold-ms <ms>",usageDescription:"Press hold duration for each iteration"},{key:"jitterPx",names:["--jitter-px"],type:"int",min:0,max:100,usageLabel:"--jitter-px <n>",usageDescription:"Deterministic coordinate jitter radius for press"},{key:"doubleTap",names:["--double-tap"],type:"boolean",usageLabel:"--double-tap",usageDescription:"Use double-tap gesture per press iteration"},{key:"pauseMs",names:["--pause-ms"],type:"int",min:0,max:1e4,usageLabel:"--pause-ms <ms>",usageDescription:"Delay between swipe iterations"},{key:"pattern",names:["--pattern"],type:"enum",enumValues:["one-way","ping-pong"],usageLabel:"--pattern one-way|ping-pong",usageDescription:"Swipe repeat pattern"},{key:"verbose",names:["--debug","--verbose","-v"],type:"boolean",usageLabel:"--debug, --verbose, -v",usageDescription:"Enable debug diagnostics and stream daemon/runner logs"},{key:"json",names:["--json"],type:"boolean",usageLabel:"--json",usageDescription:"JSON output"},{key:"help",names:["--help","-h"],type:"boolean",usageLabel:"--help, -h",usageDescription:"Print help and exit"},{key:"version",names:["--version","-V"],type:"boolean",usageLabel:"--version, -V",usageDescription:"Print version and exit"},{key:"saveScript",names:["--save-script"],type:"booleanOrString",usageLabel:"--save-script [path]",usageDescription:"Save session script (.ad) on close; optional custom output path"},{key:"relaunch",names:["--relaunch"],type:"boolean",usageLabel:"--relaunch",usageDescription:"open: terminate app process before launching it"},{key:"noRecord",names:["--no-record"],type:"boolean",usageLabel:"--no-record",usageDescription:"Do not record this action"},{key:"replayUpdate",names:["--update","-u"],type:"boolean",usageLabel:"--update, -u",usageDescription:"Replay: update selectors and rewrite replay file in place"},{key:"steps",names:["--steps"],type:"string",usageLabel:"--steps <json>",usageDescription:"Batch: JSON array of steps"},{key:"stepsFile",names:["--steps-file"],type:"string",usageLabel:"--steps-file <path>",usageDescription:"Batch: read steps JSON from file"},{key:"batchOnError",names:["--on-error"],type:"enum",enumValues:["stop"],usageLabel:"--on-error stop",usageDescription:"Batch: stop when a step fails"},{key:"batchMaxSteps",names:["--max-steps"],type:"int",min:1,max:1e3,usageLabel:"--max-steps <n>",usageDescription:"Batch: maximum number of allowed steps"},{key:"appsFilter",names:["--user-installed"],type:"enum",setValue:"user-installed",usageLabel:"--user-installed",usageDescription:"Apps: list user-installed apps"},{key:"appsFilter",names:["--all"],type:"enum",setValue:"all",usageLabel:"--all",usageDescription:"Apps: list all apps (include system/default apps)"},{key:"snapshotInteractiveOnly",names:["-i"],type:"boolean",usageLabel:"-i",usageDescription:"Snapshot: interactive elements only"},{key:"snapshotCompact",names:["-c"],type:"boolean",usageLabel:"-c",usageDescription:"Snapshot: compact output (drop empty structure)"},{key:"snapshotDepth",names:["--depth","-d"],type:"int",min:0,usageLabel:"--depth, -d <depth>",usageDescription:"Snapshot: limit snapshot depth"},{key:"snapshotScope",names:["--scope","-s"],type:"string",usageLabel:"--scope, -s <scope>",usageDescription:"Snapshot: scope snapshot to label/identifier"},{key:"snapshotRaw",names:["--raw"],type:"boolean",usageLabel:"--raw",usageDescription:"Snapshot: raw node output"},{key:"out",names:["--out"],type:"string",usageLabel:"--out <path>",usageDescription:"Output path"}],$=new Set(["json","help","version","verbose","platform","device","udid","serial","session","noRecord"]),k={boot:{description:"Ensure target device/simulator is booted and ready",positionalArgs:[],allowedFlags:[]},open:{description:"Boot device/simulator; optionally launch app or deep link URL",positionalArgs:["appOrUrl?","url?"],allowedFlags:["activity","saveScript","relaunch"]},close:{description:"Close app or just end session",positionalArgs:["app?"],allowedFlags:["saveScript"]},reinstall:{description:"Uninstall + install app from binary path",positionalArgs:["app","path"],allowedFlags:[]},snapshot:{description:"Capture accessibility tree",positionalArgs:[],allowedFlags:["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"]},devices:{description:"List available devices",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},apps:{description:"List installed apps (includes default/system apps by default)",positionalArgs:[],allowedFlags:["appsFilter"],defaults:{appsFilter:"all"}},appstate:{description:"Show foreground app/activity",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},back:{description:"Navigate back (where supported)",positionalArgs:[],allowedFlags:[]},home:{description:"Go to home screen (where supported)",positionalArgs:[],allowedFlags:[]},"app-switcher":{description:"Open app switcher (where supported)",positionalArgs:[],allowedFlags:[]},wait:{usageOverride:"wait <ms>|text <text>|@ref|<selector> [timeoutMs]",description:"Wait for duration, text, ref, or selector to appear",positionalArgs:["durationOrSelector","timeoutMs?"],allowsExtraPositionals:!0,allowedFlags:[...b]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",description:"Inspect or handle alert (iOS simulator)",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <x y|@ref|selector>",description:"Tap/click by coordinates, snapshot ref, or selector",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...b]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...b]},replay:{description:"Replay a recorded session",positionalArgs:["path"],allowedFlags:["replayUpdate"],skipCapabilityCheck:!0},batch:{usageOverride:"batch [--steps <json> | --steps-file <path>]",description:"Execute multiple commands in one daemon request",positionalArgs:[],allowedFlags:["steps","stepsFile","batchOnError","batchMaxSteps","out"],skipCapabilityCheck:!0},press:{usageOverride:"press <x y|@ref|selector>",description:"Tap/press by coordinates, snapshot ref, or selector (supports repeated series)",positionalArgs:["targetOrX","y?"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...b]},"long-press":{description:"Long press (where supported)",positionalArgs:["x","y","durationMs?"],allowedFlags:[]},swipe:{description:"Swipe coordinates with optional repeat pattern",positionalArgs:["x1","y1","x2","y2","durationMs?"],allowedFlags:["count","pauseMs","pattern"]},focus:{description:"Focus input at coordinates",positionalArgs:["x","y"],allowedFlags:[]},type:{description:"Type text in focused field",positionalArgs:["text"],allowsExtraPositionals:!0,allowedFlags:[]},fill:{usageOverride:"fill <x> <y> <text> | fill <@ref|selector> <text>",description:"Tap then type",positionalArgs:["targetOrX","yOrText","text?"],allowsExtraPositionals:!0,allowedFlags:[...b]},scroll:{description:"Scroll in direction (0-1 amount)",positionalArgs:["direction","amount?"],allowedFlags:[]},scrollintoview:{description:"Scroll until text appears",positionalArgs:["text"],allowedFlags:[]},pinch:{description:"Pinch/zoom gesture (iOS simulator)",positionalArgs:["scale","x?","y?"],allowedFlags:[]},screenshot:{description:"Capture screenshot",positionalArgs:["path?"],allowedFlags:["out"]},record:{usageOverride:"record start [path] | record stop",description:"Start/stop screen recording",positionalArgs:["start|stop","path?"],allowedFlags:[]},trace:{usageOverride:"trace start [path] | trace stop [path]",description:"Start/stop trace log capture",positionalArgs:["start|stop","path?"],allowedFlags:[],skipCapabilityCheck:!0},find:{usageOverride:"find <locator|text> <action> [value]",description:"Find by text/label/value/role/id and run action",positionalArgs:["query","action","value?"],allowsExtraPositionals:!0,allowedFlags:["snapshotDepth","snapshotRaw"]},is:{description:"Assert UI state (visible|hidden|exists|editable|selected|text)",positionalArgs:["predicate","selector","value?"],allowsExtraPositionals:!0,allowedFlags:[...b]},settings:{usageOverride:"settings <wifi|airplane|location|faceid> <on|off|match|nonmatch|enroll|unenroll>",description:"Toggle OS settings (simulators), including Face ID on iOS simulators",positionalArgs:["setting","state"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},A=new Map,S=new Map;for(let e of x){for(let t of e.names)A.set(t,e);let t=S.get(e.key);t?t.push(e):S.set(e.key,[e])}function D(e){if(e)return k[e]}function I(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function F(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(I),...t.allowedFlags.flatMap(e=>(S.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let L=function(){let e=`agent-device <command> [args] [--json]
+import{styleText as e}from"node:util";import{createRequestId as t,node_path as s,buildSnapshotDisplayLines as a,parseBatchStepsJson as i,normalizeError as r,isAgentDeviceDaemonProcess as n,runCmdDetached as o,readVersion as l,findProjectRoot as p,getDiagnosticsMeta as d,runCmdSync as c,withDiagnosticTimer as u,emitDiagnostic as g,asAppError as m,pathToFileURL as f,AppError as h,node_fs as y,node_os as w,node_net as v,withDiagnosticsScope as b,flushDiagnosticsToSessionFile as x,stopProcessForTakeover as A,formatSnapshotLine as S}from"./350.js";let k=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],$=["snapshotDepth","snapshotScope","snapshotRaw"],D=[{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","android"],usageLabel:"--platform ios|android",usageDescription:"Platform to target"},{key:"device",names:["--device"],type:"string",usageLabel:"--device <name>",usageDescription:"Device name to target"},{key:"udid",names:["--udid"],type:"string",usageLabel:"--udid <udid>",usageDescription:"iOS device UDID"},{key:"serial",names:["--serial"],type:"string",usageLabel:"--serial <serial>",usageDescription:"Android device serial"},{key:"activity",names:["--activity"],type:"string",usageLabel:"--activity <component>",usageDescription:"Android app launch activity (package/Activity); not for URL opens"},{key:"session",names:["--session"],type:"string",usageLabel:"--session <name>",usageDescription:"Named session"},{key:"count",names:["--count"],type:"int",min:1,max:200,usageLabel:"--count <n>",usageDescription:"Repeat count for press/swipe series"},{key:"fps",names:["--fps"],type:"int",min:1,max:120,usageLabel:"--fps <n>",usageDescription:"Record: target frames per second (iOS physical device runner)"},{key:"intervalMs",names:["--interval-ms"],type:"int",min:0,max:1e4,usageLabel:"--interval-ms <ms>",usageDescription:"Delay between press iterations"},{key:"holdMs",names:["--hold-ms"],type:"int",min:0,max:1e4,usageLabel:"--hold-ms <ms>",usageDescription:"Press hold duration for each iteration"},{key:"jitterPx",names:["--jitter-px"],type:"int",min:0,max:100,usageLabel:"--jitter-px <n>",usageDescription:"Deterministic coordinate jitter radius for press"},{key:"doubleTap",names:["--double-tap"],type:"boolean",usageLabel:"--double-tap",usageDescription:"Use double-tap gesture per press iteration"},{key:"pauseMs",names:["--pause-ms"],type:"int",min:0,max:1e4,usageLabel:"--pause-ms <ms>",usageDescription:"Delay between swipe iterations"},{key:"pattern",names:["--pattern"],type:"enum",enumValues:["one-way","ping-pong"],usageLabel:"--pattern one-way|ping-pong",usageDescription:"Swipe repeat pattern"},{key:"verbose",names:["--debug","--verbose","-v"],type:"boolean",usageLabel:"--debug, --verbose, -v",usageDescription:"Enable debug diagnostics and stream daemon/runner logs"},{key:"json",names:["--json"],type:"boolean",usageLabel:"--json",usageDescription:"JSON output"},{key:"help",names:["--help","-h"],type:"boolean",usageLabel:"--help, -h",usageDescription:"Print help and exit"},{key:"version",names:["--version","-V"],type:"boolean",usageLabel:"--version, -V",usageDescription:"Print version and exit"},{key:"saveScript",names:["--save-script"],type:"booleanOrString",usageLabel:"--save-script [path]",usageDescription:"Save session script (.ad) on close; optional custom output path"},{key:"relaunch",names:["--relaunch"],type:"boolean",usageLabel:"--relaunch",usageDescription:"open: terminate app process before launching it"},{key:"noRecord",names:["--no-record"],type:"boolean",usageLabel:"--no-record",usageDescription:"Do not record this action"},{key:"replayUpdate",names:["--update","-u"],type:"boolean",usageLabel:"--update, -u",usageDescription:"Replay: update selectors and rewrite replay file in place"},{key:"steps",names:["--steps"],type:"string",usageLabel:"--steps <json>",usageDescription:"Batch: JSON array of steps"},{key:"stepsFile",names:["--steps-file"],type:"string",usageLabel:"--steps-file <path>",usageDescription:"Batch: read steps JSON from file"},{key:"batchOnError",names:["--on-error"],type:"enum",enumValues:["stop"],usageLabel:"--on-error stop",usageDescription:"Batch: stop when a step fails"},{key:"batchMaxSteps",names:["--max-steps"],type:"int",min:1,max:1e3,usageLabel:"--max-steps <n>",usageDescription:"Batch: maximum number of allowed steps"},{key:"appsFilter",names:["--user-installed"],type:"enum",setValue:"user-installed",usageLabel:"--user-installed",usageDescription:"Apps: list user-installed apps"},{key:"appsFilter",names:["--all"],type:"enum",setValue:"all",usageLabel:"--all",usageDescription:"Apps: list all apps (include system/default apps)"},{key:"snapshotInteractiveOnly",names:["-i"],type:"boolean",usageLabel:"-i",usageDescription:"Snapshot: interactive elements only"},{key:"snapshotCompact",names:["-c"],type:"boolean",usageLabel:"-c",usageDescription:"Snapshot: compact output (drop empty structure)"},{key:"snapshotDepth",names:["--depth","-d"],type:"int",min:0,usageLabel:"--depth, -d <depth>",usageDescription:"Snapshot: limit snapshot depth"},{key:"snapshotScope",names:["--scope","-s"],type:"string",usageLabel:"--scope, -s <scope>",usageDescription:"Snapshot: scope snapshot to label/identifier"},{key:"snapshotRaw",names:["--raw"],type:"boolean",usageLabel:"--raw",usageDescription:"Snapshot: raw node output"},{key:"out",names:["--out"],type:"string",usageLabel:"--out <path>",usageDescription:"Output path"}],I=new Set(["json","help","version","verbose","platform","device","udid","serial","session","noRecord"]),F={boot:{description:"Ensure target device/simulator is booted and ready",positionalArgs:[],allowedFlags:[]},open:{description:"Boot device/simulator; optionally launch app or deep link URL",positionalArgs:["appOrUrl?","url?"],allowedFlags:["activity","saveScript","relaunch"]},close:{description:"Close app or just end session",positionalArgs:["app?"],allowedFlags:["saveScript"]},reinstall:{description:"Uninstall + install app from binary path",positionalArgs:["app","path"],allowedFlags:[]},snapshot:{description:"Capture accessibility tree",positionalArgs:[],allowedFlags:[...k]},diff:{usageOverride:"diff snapshot",description:"Diff current accessibility snapshot against previous baseline",positionalArgs:["kind"],allowedFlags:[...k]},devices:{description:"List available devices",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},apps:{description:"List installed apps (includes default/system apps by default)",positionalArgs:[],allowedFlags:["appsFilter"],defaults:{appsFilter:"all"}},appstate:{description:"Show foreground app/activity",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},back:{description:"Navigate back (where supported)",positionalArgs:[],allowedFlags:[]},home:{description:"Go to home screen (where supported)",positionalArgs:[],allowedFlags:[]},"app-switcher":{description:"Open app switcher (where supported)",positionalArgs:[],allowedFlags:[]},wait:{usageOverride:"wait <ms>|text <text>|@ref|<selector> [timeoutMs]",description:"Wait for duration, text, ref, or selector to appear",positionalArgs:["durationOrSelector","timeoutMs?"],allowsExtraPositionals:!0,allowedFlags:[...$]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",description:"Inspect or handle alert (iOS simulator)",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <x y|@ref|selector>",description:"Tap/click by coordinates, snapshot ref, or selector",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...$]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...$]},replay:{description:"Replay a recorded session",positionalArgs:["path"],allowedFlags:["replayUpdate"],skipCapabilityCheck:!0},batch:{usageOverride:"batch [--steps <json> | --steps-file <path>]",description:"Execute multiple commands in one daemon request",positionalArgs:[],allowedFlags:["steps","stepsFile","batchOnError","batchMaxSteps","out"],skipCapabilityCheck:!0},press:{usageOverride:"press <x y|@ref|selector>",description:"Tap/press by coordinates, snapshot ref, or selector (supports repeated series)",positionalArgs:["targetOrX","y?"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...$]},longpress:{description:"Long press by coordinates (iOS and Android)",positionalArgs:["x","y","durationMs?"],allowedFlags:[]},swipe:{description:"Swipe coordinates with optional repeat pattern",positionalArgs:["x1","y1","x2","y2","durationMs?"],allowedFlags:["count","pauseMs","pattern"]},focus:{description:"Focus input at coordinates",positionalArgs:["x","y"],allowedFlags:[]},type:{description:"Type text in focused field",positionalArgs:["text"],allowsExtraPositionals:!0,allowedFlags:[]},fill:{usageOverride:"fill <x> <y> <text> | fill <@ref|selector> <text>",description:"Tap then type",positionalArgs:["targetOrX","yOrText","text?"],allowsExtraPositionals:!0,allowedFlags:[...$]},scroll:{description:"Scroll in direction (0-1 amount)",positionalArgs:["direction","amount?"],allowedFlags:[]},scrollintoview:{usageOverride:"scrollintoview <text|@ref>",description:"Scroll until text appears or a snapshot ref is brought into view",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:[]},pinch:{description:"Pinch/zoom gesture (iOS simulator)",positionalArgs:["scale","x?","y?"],allowedFlags:[]},screenshot:{description:"Capture screenshot",positionalArgs:["path?"],allowedFlags:["out"]},record:{usageOverride:"record start [path] [--fps <n>] | record stop",description:"Start/stop screen recording",positionalArgs:["start|stop","path?"],allowedFlags:["fps"]},trace:{usageOverride:"trace start [path] | trace stop [path]",description:"Start/stop trace log capture",positionalArgs:["start|stop","path?"],allowedFlags:[],skipCapabilityCheck:!0},find:{usageOverride:"find <locator|text> <action> [value]",description:"Find by text/label/value/role/id and run action",positionalArgs:["query","action","value?"],allowsExtraPositionals:!0,allowedFlags:["snapshotDepth","snapshotRaw"]},is:{description:"Assert UI state (visible|hidden|exists|editable|selected|text)",positionalArgs:["predicate","selector","value?"],allowsExtraPositionals:!0,allowedFlags:[...$]},settings:{usageOverride:"settings <wifi|airplane|location|faceid> <on|off|match|nonmatch|enroll|unenroll>",description:"Toggle OS settings (simulators), including Face ID on iOS simulators",positionalArgs:["setting","state"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},L=new Map,O=new Map;for(let e of D){for(let t of e.names)L.set(t,e);let t=O.get(e.key);t?t.push(e):O.set(e.key,[e])}function N(e){if(e)return F[e]}function _(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function j(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(_),...t.allowedFlags.flatMap(e=>(O.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let E=function(){let e=`agent-device <command> [args] [--json]
 
 CLI to control iOS and Android devices for AI agents.
-`,t=Object.keys(k).map(e=>{let t=k[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:F(e,t)}}),s=Math.max(...t.map(e=>e.usage.length))+2,a=["Commands:"];for(let e of t)a.push(`  ${e.usage.padEnd(s)}${e.schema.description}`);let r=O("Flags:",x.filter(e=>e.usageLabel&&e.usageDescription));return`${e}
+`,t=Object.keys(F).map(e=>{let t=F[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:j(e,t)}}),s=Math.max(...t.map(e=>e.usage.length))+2,a=["Commands:"];for(let e of t)a.push(`  ${e.usage.padEnd(s)}${e.schema.description}`);let i=T("Flags:",D.filter(e=>e.usageLabel&&e.usageDescription));return`${e}
 ${a.join("\n")}
 
-${r}
-`}();function N(e){return x.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function O(e,t){if(0===t.length)return`${e}
-  (none)`;let s=Math.max(...t.map(e=>(e.usageLabel??"").length))+2,a=[e];for(let e of t)a.push(`  ${(e.usageLabel??"").padEnd(s)}${e.usageDescription??""}`);return a.join("\n")}function _(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function E(e){return e.replace(/^-+/,"")}function j(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?_(e):[e,void 0];return void 0!==A.get(t)}function M(e){process.stdout.write(`${JSON.stringify(e,null,2)}
-`)}function C(e,t={}){let s=e instanceof g?a(e):e;process.stderr.write(`Error (${s.code}): ${s.message}
+${i}
+`}();function M(e){return D.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function T(e,t){if(0===t.length)return`${e}
+  (none)`;let s=Math.max(...t.map(e=>(e.usageLabel??"").length))+2,a=[e];for(let e of t)a.push(`  ${(e.usageLabel??"").padEnd(s)}${e.usageDescription??""}`);return a.join("\n")}function C(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function R(e){return e.replace(/^-+/,"")}function P(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?C(e):[e,void 0];return void 0!==L.get(t)}function V(e){return"long-press"===e?"longpress":e}function G(e){process.stdout.write(`${JSON.stringify(e,null,2)}
+`)}function q(e,t={}){let s=e instanceof h?r(e):e;process.stderr.write(`Error (${s.code}): ${s.message}
 `),s.hint&&process.stderr.write(`Hint: ${s.hint}
 `),s.diagnosticId&&process.stderr.write(`Diagnostic ID: ${s.diagnosticId}
 `),s.logPath&&process.stderr.write(`Diagnostics Log: ${s.logPath}
 `),t.showDetails&&s.details&&process.stderr.write(`${JSON.stringify(s.details,null,2)}
-`)}function T(e,t,s){let a=P(e.type??"Element"),r=function(e,t){var s,a;let r=e.label?.trim(),i=e.value?.trim();if("text-field"===(s=t)||"text-view"===s||"search"===s){if(i)return i;if(r)return r}else if(r)return r;if(i)return i;let o=e.identifier?.trim();return!o||(a=o,/^[\w.]+:id\/[\w.-]+$/i.test(a)&&("group"===t||"image"===t||"list"===t||"collection"===t))?"":o}(e,a),i="  ".repeat(t),o=e.ref?`@${e.ref}`:"",n=[!1===e.enabled?"disabled":null].filter(Boolean).join(", "),l=n?` [${n}]`:"",c=r?` "${r}"`:"";return s?`${i}${o} [${a}]${l}`.trimEnd():`${i}${o} [${a}]${c}${l}`.trimEnd()}function P(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),s=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,"")),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return s?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}let R=t.join(f.homedir(),".agent-device"),V=t.join(R,"daemon.json"),q=t.join(R,"daemon.lock"),G=function(e=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS){if(!e)return 9e4;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):9e4}();async function W(t){let s=t.meta?.requestId??e(),a=!!(t.meta?.debug||t.flags?.verbose),r=await c("daemon_startup",async()=>await U(),{requestId:s,session:t.session}),i={...t,token:r.token,meta:{requestId:s,debug:a,cwd:t.meta?.cwd}};return p({level:"info",phase:"daemon_request_prepare",data:{requestId:s,command:t.command,session:t.session}}),await c("daemon_request",async()=>await et(r,i),{requestId:s,command:t.command})}async function U(){var e;let t=X(),s=o(),a=!!t&&await Y(t);if(t&&t.version===s&&a)return t;t&&(t.version!==s||!a)&&(await z(t),Q(V)),function(){let e=K();if(!e.hasLock||e.hasInfo)return;let t=H();t&&r(t.pid,t.processStartTime)||Q(q)}(),await ee();let i=await B(5e3);if(i)return i;if(await J()){await ee();let e=await B(5e3);if(e)return e}throw new g("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:V,lockPath:q,hint:(e=K()).hasLock&&!e.hasInfo?"Detected ~/.agent-device/daemon.lock without daemon.json. If no agent-device daemon process is running, delete ~/.agent-device/daemon.lock and retry.":e.hasLock&&e.hasInfo?"Daemon metadata may be stale. If no agent-device daemon process is running, delete ~/.agent-device/daemon.json and ~/.agent-device/daemon.lock, then retry.":"Daemon metadata is missing or stale. Delete ~/.agent-device/daemon.json if present and retry."})}async function B(e){let t=Date.now();for(;Date.now()-t<e;){let e=X();if(e&&await Y(e))return e;await new Promise(e=>setTimeout(e,100))}return null}async function J(){let e=K();if(!e.hasLock||e.hasInfo)return!1;let t=H();return t&&r(t.pid,t.processStartTime)&&await v(t.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:t.processStartTime}),Q(q),!0}async function z(e){await v(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function X(){let e=Z(V);return e&&e.port&&e.token?{...e,pid:Number.isInteger(e.pid)&&e.pid>0?e.pid:0}:null}function H(){let e=Z(q);return e&&Number.isInteger(e.pid)&&!(e.pid<=0)?e:null}function K(){return{hasInfo:m.existsSync(V),hasLock:m.existsSync(q)}}function Z(e){if(!m.existsSync(e))return null;try{return JSON.parse(m.readFileSync(e,"utf8"))}catch{return null}}function Q(e){try{m.existsSync(e)&&m.unlinkSync(e)}catch{}}async function Y(e){return new Promise(t=>{let s=w.createConnection({host:"127.0.0.1",port:e.port},()=>{s.destroy(),t(!0)});s.on("error",()=>{t(!1)})})}async function ee(){let e=n(),s=t.join(e,"dist","src","daemon.js"),a=t.join(e,"src","daemon.ts"),r=m.existsSync(s),o=m.existsSync(a);if(!r&&!o)throw new g("COMMAND_FAILED","Daemon entry not found",{distPath:s,srcPath:a});let l=(process.execArgv.includes("--experimental-strip-types")?o:!r&&o)?["--experimental-strip-types",a]:[s];i(process.execPath,l)}async function et(e,t){return new Promise((s,a)=>{let r=w.createConnection({host:"127.0.0.1",port:e.port},()=>{r.write(`${JSON.stringify(t)}
-`)}),i=setTimeout(()=>{r.destroy(),p({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:G,requestId:t.meta?.requestId,command:t.command}}),a(new g("COMMAND_FAILED","Daemon request timed out",{timeoutMs:G,requestId:t.meta?.requestId,hint:"Retry with --debug and check daemon diagnostics logs."}))},G),o="";r.setEncoding("utf8"),r.on("data",e=>{let n=(o+=e).indexOf("\n");if(-1===n)return;let l=o.slice(0,n).trim();if(l)try{let e=JSON.parse(l);r.end(),clearTimeout(i),s(e)}catch(e){clearTimeout(i),a(new g("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:l},e instanceof Error?e:void 0))}}),r.on("error",e=>{clearTimeout(i),p({level:"error",phase:"daemon_request_socket_error",data:{requestId:t.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),a(new g("COMMAND_FAILED","Failed to communicate with daemon",{requestId:t.meta?.requestId,hint:"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e))})})}let es={sendToDaemon:W};async function ea(r,i=es){let n=e(),c=r.includes("--debug")||r.includes("--verbose")||r.includes("-v"),u=r.includes("--json"),w=function(e){for(let t=0;t<e.length;t+=1){let s=e[t];if(s.startsWith("--session=")){let e=s.slice(10).trim();return e.length>0?e:null}if("--session"===s){let s=e[t+1]?.trim();if(s&&!s.startsWith("-"))return s;break}}return null}(r)??process.env.AGENT_DEVICE_SESSION??"default";await y({session:w,requestId:n,command:r[0],debug:c},async()=>{var e,w;let y;try{y=function(e,t){let s=(void 0)??function(e){if(!e)return!1;let t=e.trim().toLowerCase();return"1"===t||"true"===t||"yes"===t||"on"===t}(process.env.AGENT_DEVICE_STRICT_FLAGS),a={json:!1,help:!1,version:!1},r=null,i=[],o=[],n=[],l=!0;for(let t=0;t<e.length;t+=1){let s=e[t];if(l&&"--"===s){l=!1;continue}if(!l){r?i.push(s):r=s;continue}let o=s.startsWith("--"),c=s.startsWith("-")&&s.length>1;if(!o&&!c){r?i.push(s):r=s;continue}let[p,d]=o?_(s):[s,void 0],u=A.get(p);if(!u){if(function(e,t,s){var a;if(a=s,!/^-\d+(\.\d+)?$/.test(a)||!e)return!1;let r=D(e);return!r||!!r.allowsExtraPositionals||0!==r.positionalArgs.length&&(t.length<r.positionalArgs.length||r.positionalArgs.some(e=>e.includes("?")))}(r,i,s)){r?i.push(s):r=s;continue}throw new g("INVALID_ARGS",`Unknown flag: ${p}`)}let m=function(e,t,s,a){if(void 0!==e.setValue){if(void 0!==s)throw new g("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if("boolean"===e.type){if(void 0!==s)throw new g("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if("booleanOrString"===e.type){if(void 0!==s){if(0===s.trim().length)throw new g("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===a||j(a)||!function(e){let t=e.trim();return!(!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t))&&!!(t.startsWith("./")||t.startsWith("../")||t.startsWith("~/")||t.startsWith("/")||t.includes("/")||t.includes("\\"))}(a)?{value:!0,consumeNext:!1}:{value:a,consumeNext:!0}}let r=s??a;if(void 0===r||void 0===s&&j(r))throw new g("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:r,consumeNext:void 0===s};if("enum"===e.type){if(!e.enumValues?.includes(r))throw new g("INVALID_ARGS",`Invalid ${E(t)}: ${r}`);return{value:r,consumeNext:void 0===s}}let i=Number(r);if(!Number.isFinite(i)||"number"==typeof e.min&&i<e.min||"number"==typeof e.max&&i>e.max)throw new g("INVALID_ARGS",`Invalid ${E(t)}: ${r}`);return{value:Math.floor(i),consumeNext:void 0===s}}(u,p,d,e[t+1]);m.consumeNext&&(t+=1),a[u.key]=m.value,n.push({key:u.key,token:p})}let c=D(r),p=new Set([...$,...c?.allowedFlags??[]]),d=n.filter(e=>!p.has(e.key));if(d.length>0){var u,m;let e=(u=r,m=d.map(e=>e.token),u?1===m.length?`Flag ${m[0]} is not supported for command ${u}.`:`Flags ${m.join(", ")} are not supported for command ${u}.`:1===m.length?`Flag ${m[0]} requires a command that supports it.`:`Flags ${m.join(", ")} require a command that supports them.`);if(s)throw new g("INVALID_ARGS",e);for(let t of(o.push(`${e} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),d))delete a[t.key]}if(c?.defaults)for(let[e,t]of Object.entries(c.defaults))void 0===a[e]&&(a[e]=t);if("batch"===r&&1!=+!!a.steps+ +!!a.stepsFile)throw new g("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return{command:r,positionals:i,flags:a,warnings:o}}(r)}catch(t){p({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=a(t,{diagnosticId:l().diagnosticId,logPath:h({force:!0})??void 0});u?M({success:!1,error:e}):C(e,{showDetails:c}),process.exit(1);return}for(let e of y.warnings)process.stderr.write(`Warning: ${e}
-`);y.flags.version&&(process.stdout.write(`${o()}
-`),process.exit(0));let v="help"===y.command,b=y.flags.help;if(v||b){v&&y.positionals.length>1&&(C(new g("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=v?y.positionals[0]:y.command;e||(process.stdout.write(`${L}
-`),process.exit(0));let t=function(e){let t=D(e);if(!t)return null;let s=F(e,t),a=N(new Set(t.allowedFlags)),r=N($),i=[];return a.length>0&&i.push(O("Command flags:",a)),i.push(O("Global flags:",r)),`agent-device ${s}
+`)}function U(e){return"number"==typeof e&&Number.isFinite(e)?e:0}let W=s.join(w.homedir(),".agent-device"),B=s.join(W,"daemon.json"),J=s.join(W,"daemon.lock"),z=function(e=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS){if(!e)return 9e4;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):9e4}(),K=["xcodebuild .*AgentDeviceRunnerUITests/RunnerTests/testCommand","xcodebuild .*AgentDeviceRunner\\.env\\.session-","xcodebuild build-for-testing .*ios-runner/AgentDeviceRunner/AgentDeviceRunner\\.xcodeproj"];async function H(e){let s=e.meta?.requestId??t(),a=!!(e.meta?.debug||e.flags?.verbose),i=await u("daemon_startup",async()=>await X(),{requestId:s,session:e.session}),r={...e,token:i.token,meta:{requestId:s,debug:a,cwd:e.meta?.cwd}};return g({level:"info",phase:"daemon_request_prepare",data:{requestId:s,command:e.command,session:e.session}}),await u("daemon_request",async()=>await eo(i,r),{requestId:s,command:e.command})}async function X(){var e;let t=ee(),s=l(),a=!!t&&await er(t);if(t&&t.version===s&&a)return t;t&&(t.version!==s||!a)&&(await Q(t),ei(B)),function(){let e=es();if(!e.hasLock||e.hasInfo)return;let t=et();t&&n(t.pid,t.processStartTime)||ei(J)}(),await en();let i=await Z(5e3);if(i)return i;if(await Y()){await en();let e=await Z(5e3);if(e)return e}throw new h("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:B,lockPath:J,hint:(e=es()).hasLock&&!e.hasInfo?"Detected ~/.agent-device/daemon.lock without daemon.json. If no agent-device daemon process is running, delete ~/.agent-device/daemon.lock and retry.":e.hasLock&&e.hasInfo?"Daemon metadata may be stale. If no agent-device daemon process is running, delete ~/.agent-device/daemon.json and ~/.agent-device/daemon.lock, then retry.":"Daemon metadata is missing or stale. Delete ~/.agent-device/daemon.json if present and retry."})}async function Z(e){let t=Date.now();for(;Date.now()-t<e;){let e=ee();if(e&&await er(e))return e;await new Promise(e=>setTimeout(e,100))}return null}async function Y(){let e=es();if(!e.hasLock||e.hasInfo)return!1;let t=et();return t&&n(t.pid,t.processStartTime)&&await A(t.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:t.processStartTime}),ei(J),!0}async function Q(e){await A(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function ee(){let e=ea(B);return e&&e.port&&e.token?{...e,pid:Number.isInteger(e.pid)&&e.pid>0?e.pid:0}:null}function et(){let e=ea(J);return e&&Number.isInteger(e.pid)&&!(e.pid<=0)?e:null}function es(){return{hasInfo:y.existsSync(B),hasLock:y.existsSync(J)}}function ea(e){if(!y.existsSync(e))return null;try{return JSON.parse(y.readFileSync(e,"utf8"))}catch{return null}}function ei(e){try{y.existsSync(e)&&y.unlinkSync(e)}catch{}}async function er(e){return new Promise(t=>{let s=v.createConnection({host:"127.0.0.1",port:e.port},()=>{s.destroy(),t(!0)});s.on("error",()=>{t(!1)})})}async function en(){let e=p(),t=s.join(e,"dist","src","daemon.js"),a=s.join(e,"src","daemon.ts"),i=y.existsSync(t),r=y.existsSync(a);if(!i&&!r)throw new h("COMMAND_FAILED","Daemon entry not found",{distPath:t,srcPath:a});let n=(process.execArgv.includes("--experimental-strip-types")?r:!i&&r)?["--experimental-strip-types",a]:[t];o(process.execPath,n)}async function eo(e,t){return new Promise((s,a)=>{let i=v.createConnection({host:"127.0.0.1",port:e.port},()=>{i.write(`${JSON.stringify(t)}
+`)}),r=setTimeout(()=>{i.destroy();let s=function(){let e=0;try{for(let t of K){let s=c("pkill",["-f",t],{allowFailure:!0});0===s.exitCode&&(e+=1)}return{terminated:e}}catch(t){return{terminated:e,error:t instanceof Error?t.message:String(t)}}}(),r=function(e){let t=!1;try{n(e.pid,e.processStartTime)&&(process.kill(e.pid,"SIGKILL"),t=!0)}catch{A(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}finally{ei(B),ei(J)}return{forcedKill:t}}(e);g({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:z,requestId:t.meta?.requestId,command:t.command,timedOutRunnerPidsTerminated:s.terminated,timedOutRunnerCleanupError:s.error,daemonPidReset:e.pid,daemonPidForceKilled:r.forcedKill}}),a(new h("COMMAND_FAILED","Daemon request timed out",{timeoutMs:z,requestId:t.meta?.requestId,hint:"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."}))},z),o="";i.setEncoding("utf8"),i.on("data",e=>{let n=(o+=e).indexOf("\n");if(-1===n)return;let l=o.slice(0,n).trim();if(l)try{let e=JSON.parse(l);i.end(),clearTimeout(r),s(e)}catch(e){clearTimeout(r),a(new h("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:l},e instanceof Error?e:void 0))}}),i.on("error",e=>{clearTimeout(r),g({level:"error",phase:"daemon_request_socket_error",data:{requestId:t.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),a(new h("COMMAND_FAILED","Failed to communicate with daemon",{requestId:t.meta?.requestId,hint:"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e))})})}let el={sendToDaemon:H};async function ep(n,o=el){let p=t(),c=n.includes("--debug")||n.includes("--verbose")||n.includes("-v"),u=n.includes("--json"),f=function(e){for(let t=0;t<e.length;t+=1){let s=e[t];if(s.startsWith("--session=")){let e=s.slice(10).trim();return e.length>0?e:null}if("--session"===s){let s=e[t+1]?.trim();if(s&&!s.startsWith("-"))return s;break}}return null}(n)??process.env.AGENT_DEVICE_SESSION??"default";await b({session:f,requestId:p,command:n[0],debug:c},async()=>{var t,f;let v;try{v=function(e,t){let s=(void 0)??function(e){if(!e)return!1;let t=e.trim().toLowerCase();return"1"===t||"true"===t||"yes"===t||"on"===t}(process.env.AGENT_DEVICE_STRICT_FLAGS),a={json:!1,help:!1,version:!1},i=null,r=[],n=[],o=[],l=!0;for(let t=0;t<e.length;t+=1){let s=e[t];if(l&&"--"===s){l=!1;continue}if(!l){i?r.push(s):i=V(s);continue}let n=s.startsWith("--"),p=s.startsWith("-")&&s.length>1;if(!n&&!p){i?r.push(s):i=V(s);continue}let[d,c]=n?C(s):[s,void 0],u=L.get(d);if(!u){if(function(e,t,s){var a;if(a=s,!/^-\d+(\.\d+)?$/.test(a)||!e)return!1;let i=N(e);return!i||!!i.allowsExtraPositionals||0!==i.positionalArgs.length&&(t.length<i.positionalArgs.length||i.positionalArgs.some(e=>e.includes("?")))}(i,r,s)){i?r.push(s):i=s;continue}throw new h("INVALID_ARGS",`Unknown flag: ${d}`)}let g=function(e,t,s,a){if(void 0!==e.setValue){if(void 0!==s)throw new h("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if("boolean"===e.type){if(void 0!==s)throw new h("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if("booleanOrString"===e.type){if(void 0!==s){if(0===s.trim().length)throw new h("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===a||P(a)||!function(e){let t=e.trim();return!(!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t))&&!!(t.startsWith("./")||t.startsWith("../")||t.startsWith("~/")||t.startsWith("/")||t.includes("/")||t.includes("\\"))}(a)?{value:!0,consumeNext:!1}:{value:a,consumeNext:!0}}let i=s??a;if(void 0===i||void 0===s&&P(i))throw new h("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:i,consumeNext:void 0===s};if("enum"===e.type){if(!e.enumValues?.includes(i))throw new h("INVALID_ARGS",`Invalid ${R(t)}: ${i}`);return{value:i,consumeNext:void 0===s}}let r=Number(i);if(!Number.isFinite(r)||"number"==typeof e.min&&r<e.min||"number"==typeof e.max&&r>e.max)throw new h("INVALID_ARGS",`Invalid ${R(t)}: ${i}`);return{value:Math.floor(r),consumeNext:void 0===s}}(u,d,c,e[t+1]);g.consumeNext&&(t+=1),a[u.key]=g.value,o.push({key:u.key,token:d})}let p=N(i),d=new Set([...I,...p?.allowedFlags??[]]),c=o.filter(e=>!d.has(e.key));if(c.length>0){var u,g;let e=(u=i,g=c.map(e=>e.token),u?1===g.length?`Flag ${g[0]} is not supported for command ${u}.`:`Flags ${g.join(", ")} are not supported for command ${u}.`:1===g.length?`Flag ${g[0]} requires a command that supports it.`:`Flags ${g.join(", ")} require a command that supports them.`);if(s)throw new h("INVALID_ARGS",e);for(let t of(n.push(`${e} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),c))delete a[t.key]}if(p?.defaults)for(let[e,t]of Object.entries(p.defaults))void 0===a[e]&&(a[e]=t);if("batch"===i&&1!=+!!a.steps+ +!!a.stepsFile)throw new h("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return{command:i,positionals:r,flags:a,warnings:n}}(n)}catch(t){g({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=r(t,{diagnosticId:d().diagnosticId,logPath:x({force:!0})??void 0});u?G({success:!1,error:e}):q(e,{showDetails:c}),process.exit(1);return}for(let e of v.warnings)process.stderr.write(`Warning: ${e}
+`);v.flags.version&&(process.stdout.write(`${l()}
+`),process.exit(0));let b="help"===v.command,A=v.flags.help;if(b||A){b&&v.positionals.length>1&&(q(new h("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=b?v.positionals[0]:v.command;e||(process.stdout.write(`${E}
+`),process.exit(0));let t=function(e){let t=N(e);if(!t)return null;let s=j(e,t),a=M(new Set(t.allowedFlags)),i=M(I),r=[];return a.length>0&&r.push(T("Command flags:",a)),r.push(T("Global flags:",i)),`agent-device ${s}
 
 ${t.description}
 
 Usage:
   agent-device ${s}
 
-${i.join("\n\n")}
-`}(e);t&&(process.stdout.write(t),process.exit(0)),C(new g("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${L}
-`),process.exit(1)}y.command||(process.stdout.write(`${L}
-`),process.exit(1));let{command:x,positionals:k,flags:S}=y,I=function(e){let{json:t,help:s,version:a,...r}=e;return r}(S),R=S.session??process.env.AGENT_DEVICE_SESSION??"default",V=S.verbose&&!S.json?function(){try{let e=t.join(f.homedir(),".agent-device","daemon.log"),s=0,a=!1,r=setInterval(()=>{if(!a&&m.existsSync(e))try{let t=m.statSync(e);if(t.size<s&&(s=0),t.size<=s)return;let a=m.openSync(e,"r");try{let e=Buffer.alloc(t.size-s);m.readSync(a,e,0,e.length,s),s=t.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{m.closeSync(a)}}catch{}},200);return()=>{a=!0,clearInterval(r)}}catch{return null}}():null,q=async e=>await i.sendToDaemon({session:R,command:e.command,positionals:e.positionals,flags:e.flags,meta:{requestId:n,debug:!!S.verbose,cwd:process.cwd()}});try{if("batch"===x){let t,a,r;if(k.length>0)throw new g("INVALID_ARGS","batch does not accept positional arguments.");let i=function(e){let t="";if(e.steps)t=e.steps;else if(e.stepsFile)try{t=m.readFileSync(e.stepsFile,"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new g("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return s(t)}(S),o={...I,batchSteps:i};delete o.steps,delete o.stepsFile;let n=await q({command:"batch",positionals:k,flags:o});if(!n.ok)throw new g(n.error.code,n.error.message,{...n.error.details??{},hint:n.error.hint,diagnosticId:n.error.diagnosticId,logPath:n.error.logPath});S.json?M({success:!0,data:n.data??{}}):(e=n.data??{},t="number"==typeof e.total?e.total:0,a="number"==typeof e.executed?e.executed:0,r="number"==typeof e.totalDurationMs?e.totalDurationMs:void 0,process.stdout.write(`Batch completed: ${a}/${t} steps${void 0!==r?` in ${r}ms`:""}
-`)),V&&V();return}if("session"===x){let e=k[0]??"list";if("list"!==e)throw new g("INVALID_ARGS","session only supports list");let t=await q({command:"session_list",positionals:[],flags:I});if(!t.ok)throw new g(t.error.code,t.error.message,{...t.error.details??{},hint:t.error.hint,diagnosticId:t.error.diagnosticId,logPath:t.error.logPath});S.json?M({success:!0,data:t.data??{}}):process.stdout.write(`${JSON.stringify(t.data??{},null,2)}
-`),V&&V();return}let t=await q({command:x,positionals:k,flags:I});if(t.ok){if(S.json){M({success:!0,data:t.data??{}}),V&&V();return}if("snapshot"===x){process.stdout.write(function(e,t={}){let s=e.nodes,a=Array.isArray(s)?s:[],r=!!e.truncated,i="string"==typeof e.appName?e.appName:void 0,o="string"==typeof e.appBundleId?e.appBundleId:void 0,n=[];i&&n.push(`Page: ${i}`),o&&n.push(`App: ${o}`);let l=`Snapshot: ${a.length} nodes${r?" (truncated)":""}`,c=n.length>0?`${n.join("\n")}
-`:"";if(0===a.length)return`${c}${l}
-`;if(t.raw){let e=a.map(e=>JSON.stringify(e));return`${c}${l}
+${r.join("\n\n")}
+`}(V(e));t&&(process.stdout.write(t),process.exit(0)),q(new h("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${E}
+`),process.exit(1)}v.command||(process.stdout.write(`${E}
+`),process.exit(1));let{command:k,positionals:$,flags:D}=v,F=function(e){let{json:t,help:s,version:a,...i}=e;return i}(D),O=D.session??process.env.AGENT_DEVICE_SESSION??"default",_=D.verbose&&!D.json?function(){try{let e=s.join(w.homedir(),".agent-device","daemon.log"),t=0,a=!1,i=setInterval(()=>{if(!a&&y.existsSync(e))try{let s=y.statSync(e);if(s.size<t&&(t=0),s.size<=t)return;let a=y.openSync(e,"r");try{let e=Buffer.alloc(s.size-t);y.readSync(a,e,0,e.length,t),t=s.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{y.closeSync(a)}}catch{}},200);return()=>{a=!0,clearInterval(i)}}catch{return null}}():null,W=async e=>await o.sendToDaemon({session:O,command:e.command,positionals:e.positionals,flags:e.flags,meta:{requestId:p,debug:!!D.verbose,cwd:process.cwd()}});try{if("batch"===k){let e,s,a;if($.length>0)throw new h("INVALID_ARGS","batch does not accept positional arguments.");let r=function(e){let t="";if(e.steps)t=e.steps;else if(e.stepsFile)try{t=y.readFileSync(e.stepsFile,"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new h("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return i(t)}(D),n={...F,batchSteps:r};delete n.steps,delete n.stepsFile;let o=await W({command:"batch",positionals:$,flags:n});if(!o.ok)throw new h(o.error.code,o.error.message,{...o.error.details??{},hint:o.error.hint,diagnosticId:o.error.diagnosticId,logPath:o.error.logPath});D.json?G({success:!0,data:o.data??{}}):(t=o.data??{},e="number"==typeof t.total?t.total:0,s="number"==typeof t.executed?t.executed:0,a="number"==typeof t.totalDurationMs?t.totalDurationMs:void 0,process.stdout.write(`Batch completed: ${s}/${e} steps${void 0!==a?` in ${a}ms`:""}
+`)),_&&_();return}if("session"===k){let e=$[0]??"list";if("list"!==e)throw new h("INVALID_ARGS","session only supports list");let t=await W({command:"session_list",positionals:[],flags:F});if(!t.ok)throw new h(t.error.code,t.error.message,{...t.error.details??{},hint:t.error.hint,diagnosticId:t.error.diagnosticId,logPath:t.error.logPath});D.json?G({success:!0,data:t.data??{}}):process.stdout.write(`${JSON.stringify(t.data??{},null,2)}
+`),_&&_();return}let s=await W({command:k,positionals:$,flags:F});if(s.ok){if(D.json){G({success:!0,data:s.data??{}}),_&&_();return}if("snapshot"===k){process.stdout.write(function(e,t={}){let s=e.nodes,i=Array.isArray(s)?s:[],r=!!e.truncated,n="string"==typeof e.appName?e.appName:void 0,o="string"==typeof e.appBundleId?e.appBundleId:void 0,l=[];n&&l.push(`Page: ${n}`),o&&l.push(`App: ${o}`);let p=`Snapshot: ${i.length} nodes${r?" (truncated)":""}`,d=l.length>0?`${l.join("\n")}
+`:"";if(0===i.length)return`${d}${p}
+`;if(t.raw){let e=i.map(e=>JSON.stringify(e));return`${d}${p}
 ${e.join("\n")}
-`}if(t.flatten){let e=a.map(e=>T(e,0,!1));return`${c}${l}
+`}if(t.flatten){let e=i.map(e=>S(e,0,!1));return`${d}${p}
 ${e.join("\n")}
-`}let p=[],d=[];for(let e of a){let t=e.depth??0;for(;p.length>0&&t<=p[p.length-1];)p.pop();let s=e.label?.trim()||e.value?.trim()||e.identifier?.trim()||"",a="group"===P(e.type??"Element")&&!s;a&&p.push(t);let r=a?t:Math.max(0,t-p.length);d.push(T(e,r,a))}return`${c}${l}
-${d.join("\n")}
-`}(t.data??{},{raw:S.snapshotRaw,flatten:S.snapshotInteractiveOnly})),V&&V();return}if("get"===x){let e=k[0];if("text"===e){let e=t.data?.text??"";process.stdout.write(`${e}
-`),V&&V();return}if("attrs"===e){let e=t.data?.node??{};process.stdout.write(`${JSON.stringify(e,null,2)}
-`),V&&V();return}}if("find"===x){let e=t.data;if("string"==typeof e?.text){process.stdout.write(`${e.text}
-`),V&&V();return}if("boolean"==typeof e?.found){process.stdout.write(`Found: ${e.found}
-`),V&&V();return}if(e?.node){process.stdout.write(`${JSON.stringify(e.node,null,2)}
-`),V&&V();return}}if("is"===x){let e=t.data?.predicate??"assertion";process.stdout.write(`Passed: is ${e}
-`),V&&V();return}if("boot"===x){let e=t.data?.platform??"unknown",s=t.data?.device??t.data?.id??"unknown";process.stdout.write(`Boot ready: ${s} (${e})
-`),V&&V();return}if("click"===x||"press"===x){let e=t.data?.ref??"",s=t.data?.x,a=t.data?.y;e&&"number"==typeof s&&"number"==typeof a&&process.stdout.write(`Tapped @${e} (${s}, ${a})
-`),V&&V();return}if(t.data&&"object"==typeof t.data){let e=t.data;if("devices"===x){let t=(Array.isArray(e.devices)?e.devices:[]).map(e=>{let t=e?.name??e?.id??"unknown",s=e?.platform??"unknown",a=e?.kind?` ${e.kind}`:"",r="boolean"==typeof e?.booted?` booted=${e.booted}`:"";return`${t} (${s}${a})${r}`});process.stdout.write(`${t.join("\n")}
-`),V&&V();return}if("apps"===x){let t=(Array.isArray(e.apps)?e.apps:[]).map(e=>{if("string"==typeof e)return e;if(e&&"object"==typeof e){let t=e.bundleId??e.package,s=e.name??e.label;return s&&t?`${s} (${t})`:t?String(t):JSON.stringify(e)}return String(e)});process.stdout.write(`${t.join("\n")}
-`),V&&V();return}if("appstate"===x){let t=e?.platform,s=e?.appBundleId,a=e?.appName,r=e?.source,i=e?.package,o=e?.activity;if("ios"===t){process.stdout.write(`Foreground app: ${a??s??"unknown"}
+`}let c=a(i).map(e=>e.text);return`${d}${p}
+${c.join("\n")}
+`}(s.data??{},{raw:D.snapshotRaw,flatten:D.snapshotInteractiveOnly})),_&&_();return}if("diff"===k&&"snapshot"===$[0]){process.stdout.write(function(t){var s,a,i,r;let n,o=!0===t.baselineInitialized,l=t.summary??{},p=U(l.additions),d=U(l.removals),c=U(l.unchanged),u=(n=process.env.FORCE_COLOR,"string"==typeof n?"0"!==n:"string"!=typeof process.env.NO_COLOR&&!!process.stdout.isTTY);if(o)return`Baseline initialized (${c} lines).
+`;let g=(function(e,t){if(0===e.length)return e;let s=e.map((e,t)=>({index:t,kind:e.kind})).filter(e=>"added"===e.kind||"removed"===e.kind).map(e=>e.index);if(0===s.length)return e;let a=Array(e.length).fill(!1);for(let t of s){let s=Math.max(0,t-1),i=Math.min(e.length-1,t+1);for(let e=s;e<=i;e+=1)a[e]=!0}return e.filter((e,t)=>a[t])})(Array.isArray(t.lines)?t.lines:[],1).map(t=>{var s,a,i,r;let n="string"==typeof t.text?t.text:"";if("added"===t.kind){let t=n.startsWith(" ")?`+${n}`:`+ ${n}`;return u?(s=t,a="green",e(a,s)):t}if("removed"===t.kind){let t=n.startsWith(" ")?`-${n}`:`- ${n}`;return u?(i=t,e("red",i)):t}return u?(r=n,e("dim",r)):n}),m=g.length>0?`${g.join("\n")}
+`:"";if(!u)return`${m}${p} additions, ${d} removals, ${c} unchanged
+`;let f=`${(s=String(p),a="green",e(a,s))} additions, ${(i=String(d),e("red",i))} removals, ${(r=String(c),e("dim",r))} unchanged`;return`${m}${f}
+`}(s.data??{})),_&&_();return}if("get"===k){let e=$[0];if("text"===e){let e=s.data?.text??"";process.stdout.write(`${e}
+`),_&&_();return}if("attrs"===e){let e=s.data?.node??{};process.stdout.write(`${JSON.stringify(e,null,2)}
+`),_&&_();return}}if("find"===k){let e=s.data;if("string"==typeof e?.text){process.stdout.write(`${e.text}
+`),_&&_();return}if("boolean"==typeof e?.found){process.stdout.write(`Found: ${e.found}
+`),_&&_();return}if(e?.node){process.stdout.write(`${JSON.stringify(e.node,null,2)}
+`),_&&_();return}}if("is"===k){let e=s.data?.predicate??"assertion";process.stdout.write(`Passed: is ${e}
+`),_&&_();return}if("boot"===k){let e=s.data?.platform??"unknown",t=s.data?.device??s.data?.id??"unknown";process.stdout.write(`Boot ready: ${t} (${e})
+`),_&&_();return}if("click"===k||"press"===k){let e=s.data?.ref??"",t=s.data?.x,a=s.data?.y;e&&"number"==typeof t&&"number"==typeof a&&process.stdout.write(`Tapped @${e} (${t}, ${a})
+`),_&&_();return}if(s.data&&"object"==typeof s.data){let e=s.data;if("devices"===k){let t=(Array.isArray(e.devices)?e.devices:[]).map(e=>{let t=e?.name??e?.id??"unknown",s=e?.platform??"unknown",a=e?.kind?` ${e.kind}`:"",i="boolean"==typeof e?.booted?` booted=${e.booted}`:"";return`${t} (${s}${a})${i}`});process.stdout.write(`${t.join("\n")}
+`),_&&_();return}if("apps"===k){let t=(Array.isArray(e.apps)?e.apps:[]).map(e=>{if("string"==typeof e)return e;if(e&&"object"==typeof e){let t=e.bundleId??e.package,s=e.name??e.label;return s&&t?`${s} (${t})`:t?String(t):JSON.stringify(e)}return String(e)});process.stdout.write(`${t.join("\n")}
+`),_&&_();return}if("appstate"===k){let t=e?.platform,s=e?.appBundleId,a=e?.appName,i=e?.source,r=e?.package,n=e?.activity;if("ios"===t){process.stdout.write(`Foreground app: ${a??s??"unknown"}
 `),s&&process.stdout.write(`Bundle: ${s}
-`),r&&process.stdout.write(`Source: ${r}
-`),V&&V();return}if("android"===t){process.stdout.write(`Foreground app: ${i??"unknown"}
-`),o&&process.stdout.write(`Activity: ${o}
-`),V&&V();return}}}V&&V();return}throw new g(t.error.code,t.error.message,{...t.error.details??{},hint:t.error.hint,diagnosticId:t.error.diagnosticId,logPath:t.error.logPath})}catch(r){let e=d(r),s=a(e,{diagnosticId:l().diagnosticId,logPath:h({force:!0})??void 0});if("close"===x&&"COMMAND_FAILED"===(w=e).code&&(w.details?.kind==="daemon_startup_failed"||w.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof w.details?.infoPath||"string"==typeof w.details?.lockPath))){S.json&&M({success:!0,data:{closed:"session",source:"no-daemon"}}),V&&V();return}if(S.json)M({success:!1,error:s});else if(C(s,{showDetails:S.verbose}),S.verbose)try{let e=t.join(f.homedir(),".agent-device","daemon.log");if(m.existsSync(e)){let t=m.readFileSync(e,"utf8").split("\n"),s=t.slice(Math.max(0,t.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
+`),i&&process.stdout.write(`Source: ${i}
+`),_&&_();return}if("android"===t){process.stdout.write(`Foreground app: ${r??"unknown"}
+`),n&&process.stdout.write(`Activity: ${n}
+`),_&&_();return}}}_&&_();return}throw new h(s.error.code,s.error.message,{...s.error.details??{},hint:s.error.hint,diagnosticId:s.error.diagnosticId,logPath:s.error.logPath})}catch(a){let e=m(a),t=r(e,{diagnosticId:d().diagnosticId,logPath:x({force:!0})??void 0});if("close"===k&&"COMMAND_FAILED"===(f=e).code&&(f.details?.kind==="daemon_startup_failed"||f.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof f.details?.infoPath||"string"==typeof f.details?.lockPath))){D.json&&G({success:!0,data:{closed:"session",source:"no-daemon"}}),_&&_();return}if(D.json)G({success:!1,error:t});else if(q(t,{showDetails:D.verbose}),D.verbose)try{let e=s.join(w.homedir(),".agent-device","daemon.log");if(y.existsSync(e)){let t=y.readFileSync(e,"utf8").split("\n"),s=t.slice(Math.max(0,t.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
 [daemon log]
 ${s}
-`)}}catch{}V&&V(),process.exit(1)}})}u(process.argv[1]??"").href===import.meta.url&&ea(process.argv.slice(2)).catch(e=>{C(a(d(e)),{showDetails:!0}),process.exit(1)}),ea(process.argv.slice(2));
+`)}}catch{}_&&_(),process.exit(1)}})}f(process.argv[1]??"").href===import.meta.url&&ep(process.argv.slice(2)).catch(e=>{q(r(m(e)),{showDetails:!0}),process.exit(1)}),ep(process.argv.slice(2));