agent-device 0.4.2 → 0.5.1

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.
Files changed (93) hide show
  1. package/README.md +55 -11
  2. package/dist/src/50.js +1 -0
  3. package/dist/src/bin.js +31 -30
  4. package/dist/src/daemon.js +17 -20
  5. package/package.json +7 -9
  6. package/skills/agent-device/SKILL.md +48 -6
  7. package/skills/agent-device/references/batching.md +79 -0
  8. package/skills/agent-device/references/permissions.md +3 -15
  9. package/skills/agent-device/references/snapshot-refs.md +1 -4
  10. package/dist/bin/axsnapshot +0 -0
  11. package/dist/src/797.js +0 -1
  12. package/ios-runner/AXSnapshot/Package.swift +0 -18
  13. package/ios-runner/AXSnapshot/Sources/AXSnapshot/main.swift +0 -444
  14. package/src/__tests__/cli-close.test.ts +0 -155
  15. package/src/__tests__/cli-help.test.ts +0 -102
  16. package/src/bin.ts +0 -3
  17. package/src/cli.ts +0 -305
  18. package/src/core/__tests__/capabilities.test.ts +0 -75
  19. package/src/core/__tests__/dispatch-open.test.ts +0 -25
  20. package/src/core/__tests__/open-target.test.ts +0 -55
  21. package/src/core/capabilities.ts +0 -57
  22. package/src/core/dispatch.ts +0 -382
  23. package/src/core/open-target.ts +0 -27
  24. package/src/daemon/__tests__/device-ready.test.ts +0 -52
  25. package/src/daemon/__tests__/is-predicates.test.ts +0 -68
  26. package/src/daemon/__tests__/selectors.test.ts +0 -261
  27. package/src/daemon/__tests__/session-routing.test.ts +0 -108
  28. package/src/daemon/__tests__/session-selector.test.ts +0 -64
  29. package/src/daemon/__tests__/session-store.test.ts +0 -142
  30. package/src/daemon/__tests__/snapshot-processing.test.ts +0 -47
  31. package/src/daemon/action-utils.ts +0 -29
  32. package/src/daemon/context.ts +0 -48
  33. package/src/daemon/device-ready.ts +0 -155
  34. package/src/daemon/handlers/__tests__/find.test.ts +0 -99
  35. package/src/daemon/handlers/__tests__/interaction.test.ts +0 -22
  36. package/src/daemon/handlers/__tests__/replay-heal.test.ts +0 -509
  37. package/src/daemon/handlers/__tests__/session-reinstall.test.ts +0 -219
  38. package/src/daemon/handlers/__tests__/session.test.ts +0 -820
  39. package/src/daemon/handlers/__tests__/snapshot-handler.test.ts +0 -92
  40. package/src/daemon/handlers/__tests__/snapshot.test.ts +0 -128
  41. package/src/daemon/handlers/find.ts +0 -324
  42. package/src/daemon/handlers/interaction.ts +0 -550
  43. package/src/daemon/handlers/parse-utils.ts +0 -8
  44. package/src/daemon/handlers/record-trace.ts +0 -154
  45. package/src/daemon/handlers/session.ts +0 -1137
  46. package/src/daemon/handlers/snapshot.ts +0 -439
  47. package/src/daemon/is-predicates.ts +0 -46
  48. package/src/daemon/selectors.ts +0 -540
  49. package/src/daemon/session-routing.ts +0 -22
  50. package/src/daemon/session-selector.ts +0 -39
  51. package/src/daemon/session-store.ts +0 -296
  52. package/src/daemon/snapshot-processing.ts +0 -131
  53. package/src/daemon/types.ts +0 -56
  54. package/src/daemon-client.ts +0 -272
  55. package/src/daemon.ts +0 -295
  56. package/src/platforms/__tests__/boot-diagnostics.test.ts +0 -59
  57. package/src/platforms/android/__tests__/index.test.ts +0 -274
  58. package/src/platforms/android/devices.ts +0 -196
  59. package/src/platforms/android/index.ts +0 -784
  60. package/src/platforms/android/ui-hierarchy.ts +0 -312
  61. package/src/platforms/boot-diagnostics.ts +0 -128
  62. package/src/platforms/ios/__tests__/index.test.ts +0 -312
  63. package/src/platforms/ios/__tests__/runner-client.test.ts +0 -155
  64. package/src/platforms/ios/apps.ts +0 -358
  65. package/src/platforms/ios/ax-snapshot.ts +0 -207
  66. package/src/platforms/ios/config.ts +0 -28
  67. package/src/platforms/ios/devicectl.ts +0 -134
  68. package/src/platforms/ios/devices.ts +0 -100
  69. package/src/platforms/ios/index.ts +0 -20
  70. package/src/platforms/ios/runner-client.ts +0 -994
  71. package/src/platforms/ios/simulator.ts +0 -164
  72. package/src/utils/__tests__/args.test.ts +0 -239
  73. package/src/utils/__tests__/daemon-client.test.ts +0 -95
  74. package/src/utils/__tests__/exec.test.ts +0 -16
  75. package/src/utils/__tests__/finders.test.ts +0 -34
  76. package/src/utils/__tests__/keyed-lock.test.ts +0 -55
  77. package/src/utils/__tests__/process-identity.test.ts +0 -33
  78. package/src/utils/__tests__/retry.test.ts +0 -44
  79. package/src/utils/args.ts +0 -239
  80. package/src/utils/command-schema.ts +0 -622
  81. package/src/utils/device.ts +0 -84
  82. package/src/utils/errors.ts +0 -35
  83. package/src/utils/exec.ts +0 -339
  84. package/src/utils/finders.ts +0 -101
  85. package/src/utils/interactive.ts +0 -4
  86. package/src/utils/interactors.ts +0 -173
  87. package/src/utils/keyed-lock.ts +0 -14
  88. package/src/utils/output.ts +0 -204
  89. package/src/utils/process-identity.ts +0 -100
  90. package/src/utils/retry.ts +0 -180
  91. package/src/utils/snapshot.ts +0 -64
  92. package/src/utils/timeouts.ts +0 -9
  93. package/src/utils/version.ts +0 -26
package/README.md CHANGED
@@ -45,6 +45,52 @@ agent-device click @e3
45
45
  agent-device close
46
46
  ```
47
47
 
48
+ ## Fast batching (JSON steps)
49
+
50
+ Use `batch` to execute multiple commands in a single daemon request.
51
+
52
+ CLI examples:
53
+
54
+ ```bash
55
+ agent-device batch \
56
+ --session sim \
57
+ --platform ios \
58
+ --udid 00008150-001849640CF8401C \
59
+ --steps-file /tmp/batch-steps.json \
60
+ --json
61
+ ```
62
+
63
+ Small inline payloads are also supported:
64
+
65
+ ```bash
66
+ agent-device batch --steps '[{"command":"open","positionals":["settings"]},{"command":"wait","positionals":["100"]}]'
67
+ ```
68
+
69
+ Batch payload format:
70
+
71
+ ```json
72
+ [
73
+ { "command": "open", "positionals": ["settings"], "flags": {} },
74
+ { "command": "wait", "positionals": ["label=\"Privacy & Security\"", "3000"], "flags": {} },
75
+ { "command": "click", "positionals": ["label=\"Privacy & Security\""], "flags": {} },
76
+ { "command": "get", "positionals": ["text", "label=\"Tracking\""], "flags": {} }
77
+ ]
78
+ ```
79
+
80
+ Batch response includes:
81
+
82
+ - `total`, `executed`, `totalDurationMs`
83
+ - per-step `results[]` with `durationMs`
84
+ - failure context with failing `step` and `partialResults`
85
+
86
+ Agent usage guidelines:
87
+
88
+ - Keep each batch to one screen-local workflow.
89
+ - Add sync guards (`wait`, `is exists`) after mutating steps (`open`, `click`, `fill`, `swipe`).
90
+ - Treat refs/snapshot assumptions as stale after UI mutations.
91
+ - Prefer `--steps-file` over inline JSON for reliability.
92
+ - Keep batches moderate (about 5-20 steps) and stop on first error.
93
+
48
94
  ## CLI Usage
49
95
 
50
96
  ```bash
@@ -84,6 +130,7 @@ agent-device swipe 540 1500 540 500 120 --count 8 --pause-ms 30 --pattern ping-p
84
130
 
85
131
  ## Command Index
86
132
  - `boot`, `open`, `close`, `reinstall`, `home`, `back`, `app-switcher`
133
+ - `batch`
87
134
  - `snapshot`, `find`, `get`
88
135
  - `click`, `focus`, `type`, `fill`, `press`, `long-press`, `swipe`, `scroll`, `scrollintoview`, `pinch`, `is`
89
136
  - `alert`, `wait`, `screenshot`
@@ -91,18 +138,12 @@ agent-device swipe 540 1500 540 500 120 --count 8 --pause-ms 30 --pattern ping-p
91
138
  - `settings wifi|airplane|location on|off`
92
139
  - `appstate`, `apps`, `devices`, `session list`
93
140
 
94
- ## Backends (iOS snapshots)
95
-
96
- | Backend | Speed | Accuracy | Requirements |
97
- | --- | --- | --- | --- |
98
- | `xctest` | Fast | High | No Accessibility permission required |
99
- | `ax` | Fast | Medium | Accessibility permission for the terminal app, not recommended |
141
+ ## iOS Snapshots
100
142
 
101
143
  Notes:
102
- - Default backend is `xctest`.
144
+ - iOS snapshots use XCTest on simulators and physical devices.
103
145
  - Scope snapshots with `-s "<label>"` or `-s @ref`.
104
146
  - If XCTest returns 0 nodes (e.g., foreground app changed), agent-device fails explicitly.
105
- - `ax` backend is simulator-only.
106
147
 
107
148
  Flags:
108
149
  - `--version, -V` print version and exit
@@ -120,7 +161,10 @@ Flags:
120
161
  - `--pattern one-way|ping-pong` repeat pattern for `swipe`
121
162
  - `--verbose` for daemon and runner logs
122
163
  - `--json` for structured output
123
- - `--backend ax|xctest` (snapshot only; defaults to `xctest` on iOS)
164
+ - `--steps <json>` batch: JSON array of steps
165
+ - `--steps-file <path>` batch: read step JSON from file
166
+ - `--on-error stop` batch: stop when a step fails
167
+ - `--max-steps <n>` batch: max allowed steps per request
124
168
 
125
169
  Pinch:
126
170
  - `pinch` is supported on iOS simulators.
@@ -154,7 +198,7 @@ Navigation helpers:
154
198
  - `boot --platform ios|android` ensures the target is ready without launching an app.
155
199
  - Use `boot` mainly when starting a new session and `open` fails because no booted simulator/emulator is available.
156
200
  - `open [app|url] [url]` already boots/activates the selected target when needed.
157
- - `reinstall <app> <path>` uninstalls and installs the app binary in one command (Android + iOS simulator).
201
+ - `reinstall <app> <path>` uninstalls and installs the app binary in one command (Android + iOS simulator/device).
158
202
  - `reinstall` accepts package/bundle id style app names and supports `~` in paths.
159
203
 
160
204
  Deep links:
@@ -249,7 +293,7 @@ Boot diagnostics:
249
293
 
250
294
  ## iOS notes
251
295
  - Core runner commands: `snapshot`, `wait`, `click`, `fill`, `get`, `is`, `find`, `press`, `long-press`, `focus`, `type`, `scroll`, `scrollintoview`, `back`, `home`, `app-switcher`.
252
- - Simulator-only commands: `alert`, `pinch`, `record`, `reinstall`, `settings`.
296
+ - Simulator-only commands: `alert`, `pinch`, `record`, `settings`.
253
297
  - 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`.
254
298
 
255
299
  ## Testing
package/dist/src/50.js ADDED
@@ -0,0 +1 @@
1
+ import t,{promises as e}from"node:fs";import r from"node:path";import{fileURLToPath as n,pathToFileURL as o}from"node:url";import{spawn as i,spawnSync as s}from"node:child_process";class a extends Error{code;details;cause;constructor(t,e,r,n){super(e),this.code=t,this.details=r,this.cause=n}}function u(t){return t instanceof a?t:t instanceof Error?new a("UNKNOWN",t.message,void 0,t):new a("UNKNOWN","Unknown error",{err:t})}function d(){try{let e=l();return JSON.parse(t.readFileSync(r.join(e,"package.json"),"utf8")).version??"0.0.0"}catch{return"0.0.0"}}function l(){let e=r.dirname(n(import.meta.url)),o=e;for(let e=0;e<6;e+=1){let e=r.join(o,"package.json");if(t.existsSync(e))return o;o=r.dirname(o)}return e}async function c(t,e,r={}){return new Promise((n,o)=>{let s=i(t,e,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"]}),u="",d=r.binaryStdout?Buffer.alloc(0):void 0,l="",c=!1,f=A(r.timeoutMs),p=f?setTimeout(()=>{c=!0,s.kill("SIGKILL")},f):null;r.binaryStdout||s.stdout.setEncoding("utf8"),s.stderr.setEncoding("utf8"),void 0!==r.stdin&&s.stdin.write(r.stdin),s.stdin.end(),s.stdout.on("data",t=>{r.binaryStdout?d=Buffer.concat([d??Buffer.alloc(0),Buffer.isBuffer(t)?t:Buffer.from(t)]):u+=t}),s.stderr.on("data",t=>{l+=t}),s.on("error",r=>{(p&&clearTimeout(p),"ENOENT"===r.code)?o(new a("TOOL_MISSING",`${t} not found in PATH`,{cmd:t},r)):o(new a("COMMAND_FAILED",`Failed to run ${t}`,{cmd:t,args:e},r))}),s.on("close",i=>{p&&clearTimeout(p);let s=i??1;c&&f?o(new a("COMMAND_FAILED",`${t} timed out after ${f}ms`,{cmd:t,args:e,stdout:u,stderr:l,exitCode:s,timeoutMs:f})):0===s||r.allowFailure?n({stdout:u,stderr:l,exitCode:s,stdoutBuffer:d}):o(new a("COMMAND_FAILED",`${t} exited with code ${s}`,{cmd:t,args:e,stdout:u,stderr:l,exitCode:s}))})})}async function f(t){try{var e;let{shell:r,args:n}=(e=t,"win32"===process.platform?{shell:"cmd.exe",args:["/c","where",e]}:{shell:"bash",args:["-lc",`command -v ${e}`]}),o=await c(r,n,{allowFailure:!0});return 0===o.exitCode&&o.stdout.trim().length>0}catch{return!1}}function p(t,e,r={}){let n=s(t,e,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],encoding:r.binaryStdout?void 0:"utf8",input:r.stdin,timeout:A(r.timeoutMs)});if(n.error){let o=n.error.code;if("ETIMEDOUT"===o)throw new a("COMMAND_FAILED",`${t} timed out after ${A(r.timeoutMs)}ms`,{cmd:t,args:e,timeoutMs:A(r.timeoutMs)},n.error);if("ENOENT"===o)throw new a("TOOL_MISSING",`${t} not found in PATH`,{cmd:t},n.error);throw new a("COMMAND_FAILED",`Failed to run ${t}`,{cmd:t,args:e},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(),u="string"==typeof n.stderr?n.stderr:(n.stderr??"").toString(),d=n.status??1;if(0!==d&&!r.allowFailure)throw new a("COMMAND_FAILED",`${t} exited with code ${d}`,{cmd:t,args:e,stdout:i,stderr:u,exitCode:d});return{stdout:i,stderr:u,exitCode:d,stdoutBuffer:o}}function m(t,e,r={}){i(t,e,{cwd:r.cwd,env:r.env,stdio:"ignore",detached:!0}).unref()}async function w(t,e,r={}){return new Promise((n,o)=>{let s=i(t,e,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"]}),u="",d="",l=r.binaryStdout?Buffer.alloc(0):void 0;r.binaryStdout||s.stdout.setEncoding("utf8"),s.stderr.setEncoding("utf8"),void 0!==r.stdin&&s.stdin.write(r.stdin),s.stdin.end(),s.stdout.on("data",t=>{if(r.binaryStdout){l=Buffer.concat([l??Buffer.alloc(0),Buffer.isBuffer(t)?t:Buffer.from(t)]);return}let e=String(t);u+=e,r.onStdoutChunk?.(e)}),s.stderr.on("data",t=>{let e=String(t);d+=e,r.onStderrChunk?.(e)}),s.on("error",r=>{"ENOENT"===r.code?o(new a("TOOL_MISSING",`${t} not found in PATH`,{cmd:t},r)):o(new a("COMMAND_FAILED",`Failed to run ${t}`,{cmd:t,args:e},r))}),s.on("close",i=>{let s=i??1;0===s||r.allowFailure?n({stdout:u,stderr:d,exitCode:s,stdoutBuffer:l}):o(new a("COMMAND_FAILED",`${t} exited with code ${s}`,{cmd:t,args:e,stdout:u,stderr:d,exitCode:s}))})})}function h(t,e,r={}){let n=i(t,e,{cwd:r.cwd,env:r.env,stdio:["ignore","pipe","pipe"]}),o="",s="";n.stdout.setEncoding("utf8"),n.stderr.setEncoding("utf8"),n.stdout.on("data",t=>{o+=t}),n.stderr.on("data",t=>{s+=t});let u=new Promise((i,u)=>{n.on("error",r=>{"ENOENT"===r.code?u(new a("TOOL_MISSING",`${t} not found in PATH`,{cmd:t},r)):u(new a("COMMAND_FAILED",`Failed to run ${t}`,{cmd:t,args:e},r))}),n.on("close",n=>{let d=n??1;0===d||r.allowFailure?i({stdout:o,stderr:s,exitCode:d}):u(new a("COMMAND_FAILED",`${t} exited with code ${d}`,{cmd:t,args:e,stdout:o,stderr:s,exitCode:d}))})});return{child:n,wait:u}}function A(t){if(!Number.isFinite(t))return;let e=Math.floor(t);if(!(e<=0))return e}let S=[/(^|[\/\s"'=])dist\/src\/daemon\.js($|[\s"'])/,/(^|[\/\s"'=])src\/daemon\.ts($|[\s"'])/];function I(t){if(!Number.isInteger(t)||t<=0)return!1;try{return process.kill(t,0),!0}catch(t){return"EPERM"===t.code}}function g(t){if(!Number.isInteger(t)||t<=0)return null;try{let e=p("ps",["-p",String(t),"-o","lstart="],{allowFailure:!0,timeoutMs:1e3});if(0!==e.exitCode)return null;let r=e.stdout.trim();return r.length>0?r:null}catch{return null}}function N(t,e){let r;if(!I(t))return!1;if(e){let r=g(t);if(!r||r!==e)return!1}let n=function(t){if(!Number.isInteger(t)||t<=0)return null;try{let e=p("ps",["-p",String(t),"-o","command="],{allowFailure:!0,timeoutMs:1e3});if(0!==e.exitCode)return null;let r=e.stdout.trim();return r.length>0?r:null}catch{return null}}(t);return!!n&&!!(r=n.toLowerCase().replaceAll("\\","/")).includes("agent-device")&&S.some(t=>t.test(r))}function y(t,e){try{return process.kill(t,e),!0}catch(e){let t=e.code;if("ESRCH"===t||"EPERM"===t)return!1;throw e}}async function M(t,e){if(!I(t))return!0;let r=Date.now();for(;Date.now()-r<e;)if(await new Promise(t=>setTimeout(t,50)),!I(t))return!0;return!I(t)}async function E(t,e){!N(t,e.expectedStartTime)||!y(t,"SIGTERM")||await M(t,e.termTimeoutMs)||y(t,"SIGKILL")&&await M(t,e.killTimeoutMs)}let D=100,L=new Set(["batch","replay"]);function $(t){let e;try{e=JSON.parse(t)}catch{throw new a("INVALID_ARGS","Batch steps must be valid JSON.")}if(!Array.isArray(e)||0===e.length)throw new a("INVALID_ARGS","Batch steps must be a non-empty JSON array.");return e}function _(t,e){if(!Array.isArray(t)||0===t.length)throw new a("INVALID_ARGS","batch requires a non-empty batchSteps array.");if(t.length>e)throw new a("INVALID_ARGS",`batch has ${t.length} steps; max allowed is ${e}.`);let r=[];for(let e=0;e<t.length;e+=1){let n=t[e];if(!n||"object"!=typeof n)throw new a("INVALID_ARGS",`Invalid batch step at index ${e}.`);let o="string"==typeof n.command?n.command.trim().toLowerCase():"";if(!o)throw new a("INVALID_ARGS",`Batch step ${e+1} requires command.`);if(L.has(o))throw new a("INVALID_ARGS",`Batch step ${e+1} cannot run ${o}.`);if(void 0!==n.positionals&&!Array.isArray(n.positionals))throw new a("INVALID_ARGS",`Batch step ${e+1} positionals must be an array.`);let i=n.positionals??[];if(i.some(t=>"string"!=typeof t))throw new a("INVALID_ARGS",`Batch step ${e+1} positionals must contain only strings.`);if(void 0!==n.flags&&("object"!=typeof n.flags||Array.isArray(n.flags)||!n.flags))throw new a("INVALID_ARGS",`Batch step ${e+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{default as node_os}from"node:os";export{a as AppError,D as DEFAULT_BATCH_MAX_STEPS,u as asAppError,n as fileURLToPath,l as findProjectRoot,N as isAgentDeviceDaemonProcess,I as isProcessAlive,t as node_fs,r as node_path,$ as parseBatchStepsJson,o as pathToFileURL,e as promises,g as readProcessStartTime,d as readVersion,c as runCmd,h as runCmdBackground,m as runCmdDetached,w as runCmdStreaming,E as stopProcessForTakeover,_ as validateAndNormalizeBatchSteps,f as whichCmd};
package/dist/src/bin.js CHANGED
@@ -1,19 +1,19 @@
1
- import{node_path as e,asAppError as t,isAgentDeviceDaemonProcess as s,runCmdDetached as a,node_fs as i,node_os as n,node_net as r,AppError as o,readVersion as l,findProjectRoot as p,stopProcessForTakeover as c,pathToFileURL as u}from"./797.js";let d=["snapshotDepth","snapshotScope","snapshotRaw","snapshotBackend"],g=[{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:"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:["--verbose","-v"],type:"boolean",usageLabel:"--verbose",usageDescription:"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:"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:"snapshotBackend",names:["--backend"],type:"enum",enumValues:["ax","xctest"],usageLabel:"--backend ax|xctest",usageDescription:"Snapshot backend (iOS): ax or xctest"},{key:"out",names:["--out"],type:"string",usageLabel:"--out <path>",usageDescription:"Output path"}],m=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:["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw","snapshotBackend"]},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:[...d]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",description:"Inspect or handle alert (iOS simulator)",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <@ref|selector>",description:"Click element by snapshot ref or selector",positionalArgs:["target"],allowedFlags:[...d]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...d]},replay:{description:"Replay a recorded session",positionalArgs:["path"],allowedFlags:["replayUpdate"],skipCapabilityCheck:!0},press:{description:"Tap/press at coordinates (supports repeated gesture series)",positionalArgs:["x","y"],allowedFlags:["count","intervalMs","holdMs","jitterPx"]},"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:[...d]},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","snapshotBackend"]},is:{description:"Assert UI state (visible|hidden|exists|editable|selected|text)",positionalArgs:["predicate","selector","value?"],allowsExtraPositionals:!0,allowedFlags:[...d]},settings:{description:"Toggle OS settings (simulators)",positionalArgs:["setting","state"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},h=new Map,y=new Map;for(let e of g){for(let t of e.names)h.set(t,e);let t=y.get(e.key);t?t.push(e):y.set(e.key,[e])}function w(e){if(e)return f[e]}function v(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function b(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(v),...t.allowedFlags.flatMap(e=>(y.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let x=function(){let e=`agent-device <command> [args] [--json]
1
+ import{node_path as e,parseBatchStepsJson as t,asAppError as s,isAgentDeviceDaemonProcess as a,runCmdDetached as i,node_fs as n,node_os as r,node_net as o,AppError as l,readVersion as p,findProjectRoot as c,stopProcessForTakeover as u,pathToFileURL as d}from"./50.js";let g=["snapshotDepth","snapshotScope","snapshotRaw"],m=[{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:"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:["--verbose","-v"],type:"boolean",usageLabel:"--verbose",usageDescription:"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"}],f=new Set(["json","help","version","verbose","platform","device","udid","serial","session","noRecord"]),h={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:[...g]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",description:"Inspect or handle alert (iOS simulator)",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <@ref|selector>",description:"Click element by snapshot ref or selector",positionalArgs:["target"],allowedFlags:[...g]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...g]},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:{description:"Tap/press at coordinates (supports repeated gesture series)",positionalArgs:["x","y"],allowedFlags:["count","intervalMs","holdMs","jitterPx"]},"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:[...g]},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:[...g]},settings:{description:"Toggle OS settings (simulators)",positionalArgs:["setting","state"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},y=new Map,w=new Map;for(let e of m){for(let t of e.names)y.set(t,e);let t=w.get(e.key);t?t.push(e):w.set(e.key,[e])}function v(e){if(e)return h[e]}function b(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function x(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(b),...t.allowedFlags.flatMap(e=>(w.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let $=function(){let e=`agent-device <command> [args] [--json]
2
2
 
3
3
  CLI to control iOS and Android devices for AI agents.
4
- `,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:b(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=$("Flags:",g.filter(e=>e.usageLabel&&e.usageDescription));return`${e}
4
+ `,t=Object.keys(h).map(e=>{let t=h[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:x(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=A("Flags:",m.filter(e=>e.usageLabel&&e.usageDescription));return`${e}
5
5
  ${a.join("\n")}
6
6
 
7
7
  ${i}
8
- `}();function k(e){return g.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function $(e,t){if(0===t.length)return`${e}
9
- (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 A(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function S(e){return e.replace(/^-+/,"")}function D(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?A(e):[e,void 0];return void 0!==h.get(t)}function L(e){process.stdout.write(`${JSON.stringify(e,null,2)}
10
- `)}function F(e){let t=e.details?`
8
+ `}();function k(e){return m.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function A(e,t){if(0===t.length)return`${e}
9
+ (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 S(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function D(e){return e.replace(/^-+/,"")}function F(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?S(e):[e,void 0];return void 0!==y.get(t)}function L(e){process.stdout.write(`${JSON.stringify(e,null,2)}
10
+ `)}function I(e){let t=e.details?`
11
11
  ${JSON.stringify(e.details,null,2)}`:"";process.stderr.write(`Error (${e.code}): ${e.message}${t}
12
- `)}function I(e,t,s){let a=N(e.type??"Element"),i=function(e,t){var s,a;let i=e.label?.trim(),n=e.value?.trim();if("text-field"===(s=t)||"text-view"===s||"search"===s){if(n)return n;if(i)return i}else if(i)return i;if(n)return n;let r=e.identifier?.trim();return!r||(a=r,/^[\w.]+:id\/[\w.-]+$/i.test(a)&&("group"===t||"image"===t||"list"===t||"collection"===t))?"":r}(e,a),n=" ".repeat(t),r=e.ref?`@${e.ref}`:"",o=[!1===e.enabled?"disabled":null].filter(Boolean).join(", "),l=o?` [${o}]`:"",p=i?` "${i}"`:"";return s?`${n}${r} [${a}]${l}`.trimEnd():`${n}${r} [${a}]${p}${l}`.trimEnd()}function N(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),s=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.startsWith("ax")&&(t=t.replace(/^ax/,"")),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 O=e.join(n.homedir(),".agent-device"),j=e.join(O,"daemon.json"),C=e.join(O,"daemon.lock"),E=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 M(e){let t=await _(),s={...e,token:t.token};return await q(t,s)}async function _(){var e;let t=P(),a=l(),i=!!t&&await J(t);if(t&&t.version===a&&i)return t;t&&(t.version!==a||!i)&&(await V(t),B(j)),function(){let e=W();if(!e.hasLock||e.hasInfo)return;let t=G();t&&s(t.pid,t.processStartTime)||B(C)}(),await z();let n=await T(5e3);if(n)return n;if(await R()){await z();let e=await T(5e3);if(e)return e}throw new o("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:j,lockPath:C,hint:(e=W()).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 T(e){let t=Date.now();for(;Date.now()-t<e;){let e=P();if(e&&await J(e))return e;await new Promise(e=>setTimeout(e,100))}return null}async function R(){let e=W();if(!e.hasLock||e.hasInfo)return!1;let t=G();return t&&s(t.pid,t.processStartTime)&&await c(t.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:t.processStartTime}),B(C),!0}async function V(e){await c(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function P(){let e=U(j);return e&&e.port&&e.token?{...e,pid:Number.isInteger(e.pid)&&e.pid>0?e.pid:0}:null}function G(){let e=U(C);return e&&Number.isInteger(e.pid)&&!(e.pid<=0)?e:null}function W(){return{hasInfo:i.existsSync(j),hasLock:i.existsSync(C)}}function U(e){if(!i.existsSync(e))return null;try{return JSON.parse(i.readFileSync(e,"utf8"))}catch{return null}}function B(e){try{i.existsSync(e)&&i.unlinkSync(e)}catch{}}async function J(e){return new Promise(t=>{let s=r.createConnection({host:"127.0.0.1",port:e.port},()=>{s.destroy(),t(!0)});s.on("error",()=>{t(!1)})})}async function z(){let t=p(),s=e.join(t,"dist","src","daemon.js"),n=e.join(t,"src","daemon.ts"),r=i.existsSync(s),l=i.existsSync(n);if(!r&&!l)throw new o("COMMAND_FAILED","Daemon entry not found",{distPath:s,srcPath:n});let c=(process.execArgv.includes("--experimental-strip-types")?l:!r&&l)?["--experimental-strip-types",n]:[s];a(process.execPath,c)}async function q(e,t){return new Promise((s,a)=>{let i=r.createConnection({host:"127.0.0.1",port:e.port},()=>{i.write(`${JSON.stringify(t)}
13
- `)}),n=setTimeout(()=>{i.destroy(),a(new o("COMMAND_FAILED","Daemon request timed out",{timeoutMs:E}))},E),l="";i.setEncoding("utf8"),i.on("data",e=>{let t=(l+=e).indexOf("\n");if(-1===t)return;let r=l.slice(0,t).trim();if(r)try{let e=JSON.parse(r);i.end(),clearTimeout(n),s(e)}catch(e){clearTimeout(n),a(e)}}),i.on("error",e=>{clearTimeout(n),a(e)})})}let K={sendToDaemon:M};async function X(s,a=K){let r=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,n=[],r=[],l=[],p=!0;for(let t=0;t<e.length;t+=1){let s=e[t];if(p&&"--"===s){p=!1;continue}if(!p){i?n.push(s):i=s;continue}let r=s.startsWith("--"),c=s.startsWith("-")&&s.length>1;if(!r&&!c){i?n.push(s):i=s;continue}let[u,d]=r?A(s):[s,void 0],g=h.get(u);if(!g){if(function(e,t,s){var a;if(a=s,!/^-\d+(\.\d+)?$/.test(a)||!e)return!1;let i=w(e);return!i||!!i.allowsExtraPositionals||0!==i.positionalArgs.length&&(t.length<i.positionalArgs.length||i.positionalArgs.some(e=>e.includes("?")))}(i,n,s)){i?n.push(s):i=s;continue}throw new o("INVALID_ARGS",`Unknown flag: ${u}`)}let m=function(e,t,s,a){if(void 0!==e.setValue){if(void 0!==s)throw new o("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 o("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 o("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===a||D(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&&D(i))throw new o("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 o("INVALID_ARGS",`Invalid ${S(t)}: ${i}`);return{value:i,consumeNext:void 0===s}}let n=Number(i);if(!Number.isFinite(n)||"number"==typeof e.min&&n<e.min||"number"==typeof e.max&&n>e.max)throw new o("INVALID_ARGS",`Invalid ${S(t)}: ${i}`);return{value:Math.floor(n),consumeNext:void 0===s}}(g,u,d,e[t+1]);m.consumeNext&&(t+=1),a[g.key]=m.value,l.push({key:g.key,token:u})}let c=w(i),u=new Set([...m,...c?.allowedFlags??[]]),d=l.filter(e=>!u.has(e.key));if(d.length>0){var g,f;let e=(g=i,f=d.map(e=>e.token),g?1===f.length?`Flag ${f[0]} is not supported for command ${g}.`:`Flags ${f.join(", ")} are not supported for command ${g}.`:1===f.length?`Flag ${f[0]} requires a command that supports it.`:`Flags ${f.join(", ")} require a command that supports them.`);if(s)throw new o("INVALID_ARGS",e);for(let t of(r.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);return{command:i,positionals:n,flags:a,warnings:r}}(s);for(let e of r.warnings)process.stderr.write(`Warning: ${e}
14
- `);r.flags.version&&(process.stdout.write(`${l()}
15
- `),process.exit(0));let p="help"===r.command,c=r.flags.help;if(p||c){p&&r.positionals.length>1&&(F(new o("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=p?r.positionals[0]:r.command;e||(process.stdout.write(`${x}
16
- `),process.exit(0));let t=function(e){let t=w(e);if(!t)return null;let s=b(e,t),a=k(new Set(t.allowedFlags)),i=k(m),n=[];return a.length>0&&n.push($("Command flags:",a)),n.push($("Global flags:",i)),`agent-device ${s}
12
+ `)}function N(e,t,s){let a=O(e.type??"Element"),i=function(e,t){var s,a;let i=e.label?.trim(),n=e.value?.trim();if("text-field"===(s=t)||"text-view"===s||"search"===s){if(n)return n;if(i)return i}else if(i)return i;if(n)return n;let r=e.identifier?.trim();return!r||(a=r,/^[\w.]+:id\/[\w.-]+$/i.test(a)&&("group"===t||"image"===t||"list"===t||"collection"===t))?"":r}(e,a),n=" ".repeat(t),r=e.ref?`@${e.ref}`:"",o=[!1===e.enabled?"disabled":null].filter(Boolean).join(", "),l=o?` [${o}]`:"",p=i?` "${i}"`:"";return s?`${n}${r} [${a}]${l}`.trimEnd():`${n}${r} [${a}]${p}${l}`.trimEnd()}function O(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 j=e.join(r.homedir(),".agent-device"),E=e.join(j,"daemon.json"),M=e.join(j,"daemon.lock"),C=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 _(e){let t=await T(),s={...e,token:t.token};return await K(t,s)}async function T(){var e;let t=G(),s=p(),i=!!t&&await q(t);if(t&&t.version===s&&i)return t;t&&(t.version!==s||!i)&&(await P(t),J(E)),function(){let e=W();if(!e.hasLock||e.hasInfo)return;let t=U();t&&a(t.pid,t.processStartTime)||J(M)}(),await z();let n=await R(5e3);if(n)return n;if(await V()){await z();let e=await R(5e3);if(e)return e}throw new l("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:E,lockPath:M,hint:(e=W()).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 R(e){let t=Date.now();for(;Date.now()-t<e;){let e=G();if(e&&await q(e))return e;await new Promise(e=>setTimeout(e,100))}return null}async function V(){let e=W();if(!e.hasLock||e.hasInfo)return!1;let t=U();return t&&a(t.pid,t.processStartTime)&&await u(t.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:t.processStartTime}),J(M),!0}async function P(e){await u(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function G(){let e=B(E);return e&&e.port&&e.token?{...e,pid:Number.isInteger(e.pid)&&e.pid>0?e.pid:0}:null}function U(){let e=B(M);return e&&Number.isInteger(e.pid)&&!(e.pid<=0)?e:null}function W(){return{hasInfo:n.existsSync(E),hasLock:n.existsSync(M)}}function B(e){if(!n.existsSync(e))return null;try{return JSON.parse(n.readFileSync(e,"utf8"))}catch{return null}}function J(e){try{n.existsSync(e)&&n.unlinkSync(e)}catch{}}async function q(e){return new Promise(t=>{let s=o.createConnection({host:"127.0.0.1",port:e.port},()=>{s.destroy(),t(!0)});s.on("error",()=>{t(!1)})})}async function z(){let t=c(),s=e.join(t,"dist","src","daemon.js"),a=e.join(t,"src","daemon.ts"),r=n.existsSync(s),o=n.existsSync(a);if(!r&&!o)throw new l("COMMAND_FAILED","Daemon entry not found",{distPath:s,srcPath:a});let p=(process.execArgv.includes("--experimental-strip-types")?o:!r&&o)?["--experimental-strip-types",a]:[s];i(process.execPath,p)}async function K(e,t){return new Promise((s,a)=>{let i=o.createConnection({host:"127.0.0.1",port:e.port},()=>{i.write(`${JSON.stringify(t)}
13
+ `)}),n=setTimeout(()=>{i.destroy(),a(new l("COMMAND_FAILED","Daemon request timed out",{timeoutMs:C}))},C),r="";i.setEncoding("utf8"),i.on("data",e=>{let t=(r+=e).indexOf("\n");if(-1===t)return;let o=r.slice(0,t).trim();if(o)try{let e=JSON.parse(o);i.end(),clearTimeout(n),s(e)}catch(e){clearTimeout(n),a(e)}}),i.on("error",e=>{clearTimeout(n),a(e)})})}let X={sendToDaemon:_};async function Z(a,i=X){var o,c;let u=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,n=[],r=[],o=[],p=!0;for(let t=0;t<e.length;t+=1){let s=e[t];if(p&&"--"===s){p=!1;continue}if(!p){i?n.push(s):i=s;continue}let r=s.startsWith("--"),c=s.startsWith("-")&&s.length>1;if(!r&&!c){i?n.push(s):i=s;continue}let[u,d]=r?S(s):[s,void 0],g=y.get(u);if(!g){if(function(e,t,s){var a;if(a=s,!/^-\d+(\.\d+)?$/.test(a)||!e)return!1;let i=v(e);return!i||!!i.allowsExtraPositionals||0!==i.positionalArgs.length&&(t.length<i.positionalArgs.length||i.positionalArgs.some(e=>e.includes("?")))}(i,n,s)){i?n.push(s):i=s;continue}throw new l("INVALID_ARGS",`Unknown flag: ${u}`)}let m=function(e,t,s,a){if(void 0!==e.setValue){if(void 0!==s)throw new l("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 l("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 l("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===a||F(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&&F(i))throw new l("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 l("INVALID_ARGS",`Invalid ${D(t)}: ${i}`);return{value:i,consumeNext:void 0===s}}let n=Number(i);if(!Number.isFinite(n)||"number"==typeof e.min&&n<e.min||"number"==typeof e.max&&n>e.max)throw new l("INVALID_ARGS",`Invalid ${D(t)}: ${i}`);return{value:Math.floor(n),consumeNext:void 0===s}}(g,u,d,e[t+1]);m.consumeNext&&(t+=1),a[g.key]=m.value,o.push({key:g.key,token:u})}let c=v(i),u=new Set([...f,...c?.allowedFlags??[]]),d=o.filter(e=>!u.has(e.key));if(d.length>0){var g,m;let e=(g=i,m=d.map(e=>e.token),g?1===m.length?`Flag ${m[0]} is not supported for command ${g}.`:`Flags ${m.join(", ")} are not supported for command ${g}.`: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 l("INVALID_ARGS",e);for(let t of(r.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"===i&&1!=+!!a.steps+ +!!a.stepsFile)throw new l("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return{command:i,positionals:n,flags:a,warnings:r}}(a);for(let e of u.warnings)process.stderr.write(`Warning: ${e}
14
+ `);u.flags.version&&(process.stdout.write(`${p()}
15
+ `),process.exit(0));let d="help"===u.command,g=u.flags.help;if(d||g){d&&u.positionals.length>1&&(I(new l("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=d?u.positionals[0]:u.command;e||(process.stdout.write(`${$}
16
+ `),process.exit(0));let t=function(e){let t=v(e);if(!t)return null;let s=x(e,t),a=k(new Set(t.allowedFlags)),i=k(f),n=[];return a.length>0&&n.push(A("Command flags:",a)),n.push(A("Global flags:",i)),`agent-device ${s}
17
17
 
18
18
  ${t.description}
19
19
 
@@ -21,33 +21,34 @@ Usage:
21
21
  agent-device ${s}
22
22
 
23
23
  ${n.join("\n\n")}
24
- `}(e);t&&(process.stdout.write(t),process.exit(0)),F(new o("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${x}
25
- `),process.exit(1)}r.command||(process.stdout.write(`${x}
26
- `),process.exit(1));let{command:u,positionals:d,flags:g}=r,f=function(e){let{json:t,help:s,version:a,...i}=e;return i}(g),y=g.session??process.env.AGENT_DEVICE_SESSION??"default",v=g.verbose&&!g.json?function(){try{let t=e.join(n.homedir(),".agent-device","daemon.log"),s=0,a=!1,r=setInterval(()=>{if(!a&&i.existsSync(t))try{let e=i.statSync(t);if(e.size<s&&(s=0),e.size<=s)return;let a=i.openSync(t,"r");try{let t=Buffer.alloc(e.size-s);i.readSync(a,t,0,t.length,s),s=e.size,t.length>0&&process.stdout.write(t.toString("utf8"))}finally{i.closeSync(a)}}catch{}},200);return()=>{a=!0,clearInterval(r)}}catch{return null}}():null;try{if("session"===u){let e=d[0]??"list";if("list"!==e)throw new o("INVALID_ARGS","session only supports list");let t=await a.sendToDaemon({session:y,command:"session_list",positionals:[],flags:f});if(!t.ok)throw new o(t.error.code,t.error.message);g.json?L({success:!0,data:t.data??{}}):process.stdout.write(`${JSON.stringify(t.data??{},null,2)}
27
- `),v&&v();return}let e=await a.sendToDaemon({session:y,command:u,positionals:d,flags:f});if(e.ok){if(g.json){L({success:!0,data:e.data??{}}),v&&v();return}if("snapshot"===u){process.stdout.write(function(e,t={}){let s=e.nodes,a=Array.isArray(s)?s:[],i=!!e.truncated,n="string"==typeof e.appName?e.appName:void 0,r="string"==typeof e.appBundleId?e.appBundleId:void 0,o=[];n&&o.push(`Page: ${n}`),r&&o.push(`App: ${r}`);let l=`Snapshot: ${a.length} nodes${i?" (truncated)":""}`,p=o.length>0?`${o.join("\n")}
24
+ `}(e);t&&(process.stdout.write(t),process.exit(0)),I(new l("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${$}
25
+ `),process.exit(1)}u.command||(process.stdout.write(`${$}
26
+ `),process.exit(1));let{command:m,positionals:h,flags:w}=u,b=function(e){let{json:t,help:s,version:a,...i}=e;return i}(w),j=w.session??process.env.AGENT_DEVICE_SESSION??"default",E=w.verbose&&!w.json?function(){try{let t=e.join(r.homedir(),".agent-device","daemon.log"),s=0,a=!1,i=setInterval(()=>{if(!a&&n.existsSync(t))try{let e=n.statSync(t);if(e.size<s&&(s=0),e.size<=s)return;let a=n.openSync(t,"r");try{let t=Buffer.alloc(e.size-s);n.readSync(a,t,0,t.length,s),s=e.size,t.length>0&&process.stdout.write(t.toString("utf8"))}finally{n.closeSync(a)}}catch{}},200);return()=>{a=!0,clearInterval(i)}}catch{return null}}():null;try{if("batch"===m){let e,s,a;if(h.length>0)throw new l("INVALID_ARGS","batch does not accept positional arguments.");let r=function(e){let s="";if(e.steps)s=e.steps;else if(e.stepsFile)try{s=n.readFileSync(e.stepsFile,"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new l("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return t(s)}(w),p={...b,batchSteps:r};delete p.steps,delete p.stepsFile;let c=await i.sendToDaemon({session:j,command:"batch",positionals:h,flags:p});if(!c.ok)throw new l(c.error.code,c.error.message,c.error.details);w.json?L({success:!0,data:c.data??{}}):(o=c.data??{},e="number"==typeof o.total?o.total:0,s="number"==typeof o.executed?o.executed:0,a="number"==typeof o.totalDurationMs?o.totalDurationMs:void 0,process.stdout.write(`Batch completed: ${s}/${e} steps${void 0!==a?` in ${a}ms`:""}
27
+ `)),E&&E();return}if("session"===m){let e=h[0]??"list";if("list"!==e)throw new l("INVALID_ARGS","session only supports list");let t=await i.sendToDaemon({session:j,command:"session_list",positionals:[],flags:b});if(!t.ok)throw new l(t.error.code,t.error.message);w.json?L({success:!0,data:t.data??{}}):process.stdout.write(`${JSON.stringify(t.data??{},null,2)}
28
+ `),E&&E();return}let e=await i.sendToDaemon({session:j,command:m,positionals:h,flags:b});if(e.ok){if(w.json){L({success:!0,data:e.data??{}}),E&&E();return}if("snapshot"===m){process.stdout.write(function(e,t={}){let s=e.nodes,a=Array.isArray(s)?s:[],i=!!e.truncated,n="string"==typeof e.appName?e.appName:void 0,r="string"==typeof e.appBundleId?e.appBundleId:void 0,o=[];n&&o.push(`Page: ${n}`),r&&o.push(`App: ${r}`);let l=`Snapshot: ${a.length} nodes${i?" (truncated)":""}`,p=o.length>0?`${o.join("\n")}
28
29
  `:"";if(0===a.length)return`${p}${l}
29
30
  `;if(t.raw){let e=a.map(e=>JSON.stringify(e));return`${p}${l}
30
31
  ${e.join("\n")}
31
- `}if(t.flatten){let e=a.map(e=>I(e,0,!1));return`${p}${l}
32
+ `}if(t.flatten){let e=a.map(e=>N(e,0,!1));return`${p}${l}
32
33
  ${e.join("\n")}
33
- `}let c=[],u=[];for(let e of a){let t=e.depth??0;for(;c.length>0&&t<=c[c.length-1];)c.pop();let s=e.label?.trim()||e.value?.trim()||e.identifier?.trim()||"",a="group"===N(e.type??"Element")&&!s;a&&c.push(t);let i=a?t:Math.max(0,t-c.length);u.push(I(e,i,a))}return`${p}${l}
34
+ `}let c=[],u=[];for(let e of a){let t=e.depth??0;for(;c.length>0&&t<=c[c.length-1];)c.pop();let s=e.label?.trim()||e.value?.trim()||e.identifier?.trim()||"",a="group"===O(e.type??"Element")&&!s;a&&c.push(t);let i=a?t:Math.max(0,t-c.length);u.push(N(e,i,a))}return`${p}${l}
34
35
  ${u.join("\n")}
35
- `}(e.data??{},{raw:g.snapshotRaw,flatten:g.snapshotInteractiveOnly})),v&&v();return}if("get"===u){let t=d[0];if("text"===t){let t=e.data?.text??"";process.stdout.write(`${t}
36
- `),v&&v();return}if("attrs"===t){let t=e.data?.node??{};process.stdout.write(`${JSON.stringify(t,null,2)}
37
- `),v&&v();return}}if("find"===u){let t=e.data;if("string"==typeof t?.text){process.stdout.write(`${t.text}
38
- `),v&&v();return}if("boolean"==typeof t?.found){process.stdout.write(`Found: ${t.found}
39
- `),v&&v();return}if(t?.node){process.stdout.write(`${JSON.stringify(t.node,null,2)}
40
- `),v&&v();return}}if("is"===u){let t=e.data?.predicate??"assertion";process.stdout.write(`Passed: is ${t}
41
- `),v&&v();return}if("boot"===u){let t=e.data?.platform??"unknown",s=e.data?.device??e.data?.id??"unknown";process.stdout.write(`Boot ready: ${s} (${t})
42
- `),v&&v();return}if("click"===u){let t=e.data?.ref??"",s=e.data?.x,a=e.data?.y;t&&"number"==typeof s&&"number"==typeof a&&process.stdout.write(`Clicked @${t} (${s}, ${a})
43
- `),v&&v();return}if(e.data&&"object"==typeof e.data){let t=e.data;if("devices"===u){let e=(Array.isArray(t.devices)?t.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(`${e.join("\n")}
44
- `),v&&v();return}if("apps"===u){let e=(Array.isArray(t.apps)?t.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(`${e.join("\n")}
45
- `),v&&v();return}if("appstate"===u){let e=t?.platform,s=t?.appBundleId,a=t?.appName,i=t?.source,n=t?.package,r=t?.activity;if("ios"===e){process.stdout.write(`Foreground app: ${a??s??"unknown"}
36
+ `}(e.data??{},{raw:w.snapshotRaw,flatten:w.snapshotInteractiveOnly})),E&&E();return}if("get"===m){let t=h[0];if("text"===t){let t=e.data?.text??"";process.stdout.write(`${t}
37
+ `),E&&E();return}if("attrs"===t){let t=e.data?.node??{};process.stdout.write(`${JSON.stringify(t,null,2)}
38
+ `),E&&E();return}}if("find"===m){let t=e.data;if("string"==typeof t?.text){process.stdout.write(`${t.text}
39
+ `),E&&E();return}if("boolean"==typeof t?.found){process.stdout.write(`Found: ${t.found}
40
+ `),E&&E();return}if(t?.node){process.stdout.write(`${JSON.stringify(t.node,null,2)}
41
+ `),E&&E();return}}if("is"===m){let t=e.data?.predicate??"assertion";process.stdout.write(`Passed: is ${t}
42
+ `),E&&E();return}if("boot"===m){let t=e.data?.platform??"unknown",s=e.data?.device??e.data?.id??"unknown";process.stdout.write(`Boot ready: ${s} (${t})
43
+ `),E&&E();return}if("click"===m){let t=e.data?.ref??"",s=e.data?.x,a=e.data?.y;t&&"number"==typeof s&&"number"==typeof a&&process.stdout.write(`Clicked @${t} (${s}, ${a})
44
+ `),E&&E();return}if(e.data&&"object"==typeof e.data){let t=e.data;if("devices"===m){let e=(Array.isArray(t.devices)?t.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(`${e.join("\n")}
45
+ `),E&&E();return}if("apps"===m){let e=(Array.isArray(t.apps)?t.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(`${e.join("\n")}
46
+ `),E&&E();return}if("appstate"===m){let e=t?.platform,s=t?.appBundleId,a=t?.appName,i=t?.source,n=t?.package,r=t?.activity;if("ios"===e){process.stdout.write(`Foreground app: ${a??s??"unknown"}
46
47
  `),s&&process.stdout.write(`Bundle: ${s}
47
48
  `),i&&process.stdout.write(`Source: ${i}
48
- `),v&&v();return}if("android"===e){process.stdout.write(`Foreground app: ${n??"unknown"}
49
+ `),E&&E();return}if("android"===e){process.stdout.write(`Foreground app: ${n??"unknown"}
49
50
  `),r&&process.stdout.write(`Activity: ${r}
50
- `),v&&v();return}}}v&&v();return}throw new o(e.error.code,e.error.message,e.error.details)}catch(a){var O;let s=t(a);if("close"===u&&"COMMAND_FAILED"===(O=s).code&&(O.details?.kind==="daemon_startup_failed"||O.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof O.details?.infoPath||"string"==typeof O.details?.lockPath))){g.json&&L({success:!0,data:{closed:"session",source:"no-daemon"}}),v&&v();return}if(g.json)L({success:!1,error:{code:s.code,message:s.message,details:s.details}});else if(F(s),g.verbose)try{let t=e.join(n.homedir(),".agent-device","daemon.log");if(i.existsSync(t)){let e=i.readFileSync(t,"utf8").split("\n"),s=e.slice(Math.max(0,e.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
51
+ `),E&&E();return}}}E&&E();return}throw new l(e.error.code,e.error.message,e.error.details)}catch(a){let t=s(a);if("close"===m&&"COMMAND_FAILED"===(c=t).code&&(c.details?.kind==="daemon_startup_failed"||c.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof c.details?.infoPath||"string"==typeof c.details?.lockPath))){w.json&&L({success:!0,data:{closed:"session",source:"no-daemon"}}),E&&E();return}if(w.json)L({success:!1,error:{code:t.code,message:t.message,details:t.details}});else if(I(t),w.verbose)try{let t=e.join(r.homedir(),".agent-device","daemon.log");if(n.existsSync(t)){let e=n.readFileSync(t,"utf8").split("\n"),s=e.slice(Math.max(0,e.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
51
52
  [daemon log]
52
53
  ${s}
53
- `)}}catch{}v&&v(),process.exit(1)}}u(process.argv[1]??"").href===import.meta.url&&X(process.argv.slice(2)).catch(e=>{F(t(e)),process.exit(1)}),X(process.argv.slice(2));
54
+ `)}}catch{}E&&E(),process.exit(1)}}d(process.argv[1]??"").href===import.meta.url&&Z(process.argv.slice(2)).catch(e=>{I(s(e)),process.exit(1)}),Z(process.argv.slice(2));