agent-device 0.7.1 → 0.7.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -14,9 +14,10 @@ The project is in early development and considered experimental. Pull requests a
|
|
|
14
14
|
|
|
15
15
|
## Features
|
|
16
16
|
- Platforms: iOS/tvOS (simulator + physical device core automation) and Android/AndroidTV (emulator + device).
|
|
17
|
-
- Core commands: `open`, `back`, `home`, `app-switcher`, `press`, `long-press`, `focus`, `type`, `fill`, `scroll`, `scrollintoview`, `wait`, `alert`, `screenshot`, `close`, `reinstall`, `push`.
|
|
17
|
+
- Core commands: `open`, `back`, `home`, `app-switcher`, `press`, `long-press`, `focus`, `type`, `fill`, `scroll`, `scrollintoview`, `wait`, `alert`, `screenshot`, `close`, `reinstall`, `push`, `trigger-app-event`.
|
|
18
18
|
- Inspection commands: `snapshot` (accessibility tree), `diff snapshot` (structural baseline diff), `appstate`, `apps`, `devices`.
|
|
19
19
|
- Clipboard commands: `clipboard read`, `clipboard write <text>`.
|
|
20
|
+
- Keyboard commands: `keyboard status|get|dismiss` (Android).
|
|
20
21
|
- Performance command: `perf` (alias: `metrics`) returns a metrics JSON blob for the active session; startup timing is currently sampled.
|
|
21
22
|
- App logs and traffic inspection: `logs path` returns session log metadata; `logs start` / `logs stop` stream app output; `logs clear` truncates session app logs; `logs clear --restart` resets and restarts stream in one step; `logs doctor` checks readiness; `logs mark` writes timeline markers; `network dump` parses recent HTTP(s) entries from session logs.
|
|
22
23
|
- Device tooling: `adb` (Android), `simctl`/`devicectl` (iOS via Xcode).
|
|
@@ -148,9 +149,11 @@ agent-device scrollintoview @e42
|
|
|
148
149
|
- `snapshot`, `diff snapshot`, `find`, `get`
|
|
149
150
|
- `press` (alias: `click`), `focus`, `type`, `fill`, `long-press`, `swipe`, `scroll`, `scrollintoview`, `pinch`, `is`
|
|
150
151
|
- `alert`, `wait`, `screenshot`
|
|
152
|
+
- `trigger-app-event <event> [payloadJson]`
|
|
151
153
|
- `trace start`, `trace stop`
|
|
152
154
|
- `logs path`, `logs start`, `logs stop`, `logs clear`, `logs clear --restart`, `logs doctor`, `logs mark` (session app log file for grep; iOS simulator + iOS device + Android)
|
|
153
155
|
- `clipboard read`, `clipboard write <text>` (iOS simulator + Android)
|
|
156
|
+
- `keyboard [status|get|dismiss]` (Android emulator/device)
|
|
154
157
|
- `network dump [limit] [summary|headers|body|all]`, `network log ...` (best-effort HTTP(s) parsing from session app log)
|
|
155
158
|
- `settings wifi|airplane|location on|off`
|
|
156
159
|
- `settings appearance light|dark|toggle`
|
|
@@ -181,6 +184,25 @@ Payload notes:
|
|
|
181
184
|
- Android extras support string/boolean/number values.
|
|
182
185
|
- `push` works with session context (uses session device) or explicit device selectors.
|
|
183
186
|
|
|
187
|
+
App event triggers (app hook):
|
|
188
|
+
|
|
189
|
+
```bash
|
|
190
|
+
agent-device trigger-app-event screenshot_taken '{"source":"qa"}'
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
- `trigger-app-event` dispatches an app event via deep link and requires an app-side test/debug hook.
|
|
194
|
+
- `trigger-app-event` requires either an active session or explicit device selectors (`--platform`, `--device`, `--udid`, `--serial`).
|
|
195
|
+
- On iOS physical devices, custom-scheme deep links require active app context (open the app in-session first).
|
|
196
|
+
- Configure one of:
|
|
197
|
+
- `AGENT_DEVICE_APP_EVENT_URL_TEMPLATE`
|
|
198
|
+
- `AGENT_DEVICE_IOS_APP_EVENT_URL_TEMPLATE`
|
|
199
|
+
- `AGENT_DEVICE_ANDROID_APP_EVENT_URL_TEMPLATE`
|
|
200
|
+
- Template placeholders: `{event}`, `{payload}`, `{platform}`.
|
|
201
|
+
- Example template: `myapp://agent-device/event?name={event}&payload={payload}`.
|
|
202
|
+
- `payloadJson` must be a JSON object.
|
|
203
|
+
- This is app-hook-based simulation, not an OS-global notification injector.
|
|
204
|
+
- Canonical trigger contract lives in [`website/docs/docs/commands.md`](website/docs/docs/commands.md) under **App event triggers**.
|
|
205
|
+
|
|
184
206
|
## iOS Snapshots
|
|
185
207
|
|
|
186
208
|
Notes:
|
|
@@ -209,6 +231,8 @@ Flags:
|
|
|
209
231
|
- `--device <name>`
|
|
210
232
|
- `--udid <udid>` (iOS)
|
|
211
233
|
- `--serial <serial>` (Android)
|
|
234
|
+
- `--ios-simulator-device-set <path>` constrain iOS simulator discovery/commands to one simulator set (`xcrun simctl --set`)
|
|
235
|
+
- `--android-device-allowlist <serials>` constrain Android discovery/selection to comma/space-separated serials
|
|
212
236
|
- `--activity <component>` (Android app launch only; package/Activity or package/.Activity; not for URL opens)
|
|
213
237
|
- `--session <name>`
|
|
214
238
|
- `--state-dir <path>` daemon state directory override (default: `~/.agent-device`)
|
|
@@ -232,6 +256,11 @@ Flags:
|
|
|
232
256
|
- `--on-error stop` batch: stop when a step fails
|
|
233
257
|
- `--max-steps <n>` batch: max allowed steps per request
|
|
234
258
|
|
|
259
|
+
Isolation precedence:
|
|
260
|
+
- Discovery scope (`--ios-simulator-device-set`, `--android-device-allowlist`) is applied before selector matching (`--device`, `--udid`, `--serial`).
|
|
261
|
+
- If a selector points outside the scoped set/allowlist, command resolution fails with `DEVICE_NOT_FOUND` (no host-global fallback).
|
|
262
|
+
- When `--ios-simulator-device-set` is set (or its env equivalent), iOS discovery is simulator-set only (physical iOS devices are not enumerated).
|
|
263
|
+
|
|
235
264
|
TV targets:
|
|
236
265
|
- Use `--target tv` together with `--platform ios|android|apple`.
|
|
237
266
|
- TV target selection supports both simulator/emulator and connected physical devices (AppleTV + AndroidTV).
|
|
@@ -391,6 +420,12 @@ Clipboard:
|
|
|
391
420
|
- Supported on Android emulator/device and iOS simulator.
|
|
392
421
|
- iOS physical devices currently return `UNSUPPORTED_OPERATION` for clipboard commands.
|
|
393
422
|
|
|
423
|
+
Keyboard:
|
|
424
|
+
- `keyboard status` (or `keyboard get`) reports Android keyboard visibility and best-effort input type classification (`text`, `number`, `email`, `phone`, `password`, `datetime`).
|
|
425
|
+
- `keyboard dismiss` issues Android back keyevent only when keyboard is visible, then verifies hidden state.
|
|
426
|
+
- Works with an active session device or explicit selectors (`--platform`, `--device`, `--udid`, `--serial`).
|
|
427
|
+
- Supported on Android emulator/device.
|
|
428
|
+
|
|
394
429
|
## Debug
|
|
395
430
|
|
|
396
431
|
- **App logs (token-efficient):** Logging is off by default in normal flows. Enable it on demand when debugging. With an active session, run `logs path` to get path + state metadata (e.g. `<state-dir>/sessions/<session>/app.log`). Run `logs start` to stream app output to that file; use `logs stop` to stop. Run `logs clear` to truncate `app.log` (and remove rotated `app.log.N` files) before a new repro window. Run `logs doctor` for tool/runtime checks and `logs mark "step"` to insert timeline markers. Grep the file when you need to inspect errors (e.g. `grep -n "Error\|Exception" <path>`) instead of pulling full logs into context. Supported on iOS simulator, iOS physical device, and Android.
|
|
@@ -414,6 +449,8 @@ Boot diagnostics:
|
|
|
414
449
|
- Reason codes: `IOS_BOOT_TIMEOUT`, `IOS_RUNNER_CONNECT_TIMEOUT`, `ANDROID_BOOT_TIMEOUT`, `ADB_TRANSPORT_UNAVAILABLE`, `CI_RESOURCE_STARVATION_SUSPECTED`, `BOOT_COMMAND_FAILED`, `UNKNOWN`.
|
|
415
450
|
- Android boot waits fail fast for permission/tooling issues and do not always collapse into timeout errors.
|
|
416
451
|
- Use `agent-device boot --platform ios|android|apple` when starting a new session only if `open` cannot find/connect to an available target.
|
|
452
|
+
- Android emulator boot by AVD name (GUI): `agent-device boot --platform android --device Pixel_9_Pro_XL`.
|
|
453
|
+
- Android headless emulator boot: `agent-device boot --platform android --device Pixel_9_Pro_XL --headless`.
|
|
417
454
|
- `--debug` captures retry telemetry in diagnostics logs.
|
|
418
455
|
- Set `AGENT_DEVICE_RETRY_LOGS=1` to also print retry telemetry directly to stderr (ad-hoc troubleshooting).
|
|
419
456
|
|
|
@@ -463,6 +500,9 @@ pnpm build
|
|
|
463
500
|
Environment selectors:
|
|
464
501
|
- `ANDROID_DEVICE=Pixel_9_Pro_XL` or `ANDROID_SERIAL=emulator-5554`
|
|
465
502
|
- `IOS_DEVICE="iPhone 17 Pro"` or `IOS_UDID=<udid>`
|
|
503
|
+
- `AGENT_DEVICE_IOS_SIMULATOR_DEVICE_SET=<path>` (or `IOS_SIMULATOR_DEVICE_SET=<path>`) to scope all iOS simulator discovery/commands to one simulator set.
|
|
504
|
+
- `AGENT_DEVICE_ANDROID_DEVICE_ALLOWLIST=<serials>` (or `ANDROID_DEVICE_ALLOWLIST=<serials>`) to scope Android discovery to allowlisted serials.
|
|
505
|
+
- CLI flags `--ios-simulator-device-set` / `--android-device-allowlist` override environment values.
|
|
466
506
|
- `AGENT_DEVICE_IOS_BOOT_TIMEOUT_MS=<ms>` to adjust iOS simulator boot timeout (default: `120000`, minimum: `5000`).
|
|
467
507
|
- `AGENT_DEVICE_DAEMON_TIMEOUT_MS=<ms>` to override daemon request timeout (default `90000`). Increase for slow physical-device setup (for example `120000`).
|
|
468
508
|
- `AGENT_DEVICE_STATE_DIR=<path>` override daemon state directory (metadata, logs, session artifacts).
|
package/dist/src/bin.js
CHANGED
|
@@ -1,22 +1,22 @@
|
|
|
1
|
-
import{styleText as e}from"node:util";import{node_http as t,node_path as s,buildSnapshotDisplayLines as r,createRequestId as a,parseBatchStepsJson as o,normalizeError as n,isAgentDeviceDaemonProcess as i,runCmdDetached as l,readVersion as d,findProjectRoot as p,getDiagnosticsMeta as u,runCmdSync as c,withDiagnosticTimer as m,resolveDaemonTransportPreference as g,emitDiagnostic as f,SETTINGS_USAGE_OVERRIDE as h,asAppError as y,pathToFileURL as w,AppError as v,node_fs as b,withDiagnosticsScope as D,node_net as I,flushDiagnosticsToSessionFile as A,resolveDaemonServerMode as k,resolveDaemonPaths as $,stopProcessForTakeover as S,formatSnapshotLine as x}from"./678.js";let E=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],L=["snapshotDepth","snapshotScope","snapshotRaw"],O=[{key:"stateDir",names:["--state-dir"],type:"string",usageLabel:"--state-dir <path>",usageDescription:"Daemon state directory (defaults to ~/.agent-device)"},{key:"daemonTransport",names:["--daemon-transport"],type:"enum",enumValues:["auto","socket","http"],usageLabel:"--daemon-transport auto|socket|http",usageDescription:"Daemon client transport preference"},{key:"daemonServerMode",names:["--daemon-server-mode"],type:"enum",enumValues:["socket","http","dual"],usageLabel:"--daemon-server-mode socket|http|dual",usageDescription:"Daemon server mode used when spawning daemon"},{key:"tenant",names:["--tenant"],type:"string",usageLabel:"--tenant <id>",usageDescription:"Tenant scope identifier for isolated daemon sessions"},{key:"sessionIsolation",names:["--session-isolation"],type:"enum",enumValues:["none","tenant"],usageLabel:"--session-isolation none|tenant",usageDescription:"Session isolation strategy (tenant prefixes session namespace)"},{key:"runId",names:["--run-id"],type:"string",usageLabel:"--run-id <id>",usageDescription:"Run identifier used for tenant lease admission checks"},{key:"leaseId",names:["--lease-id"],type:"string",usageLabel:"--lease-id <id>",usageDescription:"Lease identifier bound to tenant/run admission scope"},{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","android","apple"],usageLabel:"--platform ios|android|apple",usageDescription:"Platform to target (`apple` aliases the iOS/tvOS backend)"},{key:"target",names:["--target"],type:"enum",enumValues:["mobile","tv"],usageLabel:"--target mobile|tv",usageDescription:"Device target class to match"},{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:"restart",names:["--restart"],type:"boolean",usageLabel:"--restart",usageDescription:"logs clear: stop active stream, clear logs, then start streaming again"},{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","stateDir","daemonTransport","daemonServerMode","tenant","sessionIsolation","runId","leaseId","help","version","verbose","platform","target","device","udid","serial","session","noRecord"]),_={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:[]},push:{description:"Simulate push notification payload delivery",positionalArgs:["bundleOrPackage","payloadOrJson"],allowedFlags:[]},snapshot:{description:"Capture accessibility tree",positionalArgs:[],allowedFlags:[...E]},diff:{usageOverride:"diff snapshot",description:"Diff current accessibility snapshot against previous baseline",positionalArgs:["kind"],allowedFlags:[...E]},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},clipboard:{usageOverride:"clipboard read | clipboard write <text>",description:"Read or write device clipboard text",positionalArgs:["read|write","text?"],allowsExtraPositionals:!0,allowedFlags:[]},perf:{description:"Show session performance metrics (startup timing)",positionalArgs:[],allowedFlags:[]},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:[...L]},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",...L]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...L]},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",...L]},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:[...L]},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},logs:{usageOverride:"logs path | logs start | logs stop | logs clear [--restart] | logs doctor | logs mark [message...]",description:"Session app log info, start/stop streaming, diagnostics, and markers",positionalArgs:["path|start|stop|clear|doctor|mark","message?"],allowsExtraPositionals:!0,allowedFlags:["restart"]},network:{usageOverride:"network dump [limit] [summary|headers|body|all] | network log [limit] [summary|headers|body|all]",description:"Dump recent HTTP(s) traffic parsed from the session app log",positionalArgs:["dump|log","limit?","include?"],allowedFlags:[]},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:[...L]},settings:{usageOverride:h,description:"Toggle OS settings, appearance, and app permissions (session app scope for permission actions)",positionalArgs:["setting","state","target?","mode?"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},P=new Map,N=new Map;for(let e of O){for(let t of e.names)P.set(t,e);let t=N.get(e.key);t?t.push(e):N.set(e.key,[e])}function T(e){if(e)return _[e]}function M(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function C(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(M),...t.allowedFlags.flatMap(e=>(N.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let R=function(){let e=`agent-device <command> [args] [--json]
|
|
1
|
+
import{styleText as e}from"node:util";import{node_http as t,node_path as s,buildSnapshotDisplayLines as a,createRequestId as r,parseBatchStepsJson as o,normalizeError as i,isAgentDeviceDaemonProcess as n,runCmdDetached as l,readVersion as d,findProjectRoot as p,getDiagnosticsMeta as u,runCmdSync as c,withDiagnosticTimer as m,resolveDaemonTransportPreference as g,emitDiagnostic as f,SETTINGS_USAGE_OVERRIDE as h,asAppError as y,pathToFileURL as w,AppError as v,node_fs as b,withDiagnosticsScope as D,node_net as I,flushDiagnosticsToSessionFile as k,resolveDaemonServerMode as A,resolveDaemonPaths as $,stopProcessForTakeover as S,formatSnapshotLine as x}from"./678.js";let E=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],L=["snapshotDepth","snapshotScope","snapshotRaw"],O=[{key:"stateDir",names:["--state-dir"],type:"string",usageLabel:"--state-dir <path>",usageDescription:"Daemon state directory (defaults to ~/.agent-device)"},{key:"daemonTransport",names:["--daemon-transport"],type:"enum",enumValues:["auto","socket","http"],usageLabel:"--daemon-transport auto|socket|http",usageDescription:"Daemon client transport preference"},{key:"daemonServerMode",names:["--daemon-server-mode"],type:"enum",enumValues:["socket","http","dual"],usageLabel:"--daemon-server-mode socket|http|dual",usageDescription:"Daemon server mode used when spawning daemon"},{key:"tenant",names:["--tenant"],type:"string",usageLabel:"--tenant <id>",usageDescription:"Tenant scope identifier for isolated daemon sessions"},{key:"sessionIsolation",names:["--session-isolation"],type:"enum",enumValues:["none","tenant"],usageLabel:"--session-isolation none|tenant",usageDescription:"Session isolation strategy (tenant prefixes session namespace)"},{key:"runId",names:["--run-id"],type:"string",usageLabel:"--run-id <id>",usageDescription:"Run identifier used for tenant lease admission checks"},{key:"leaseId",names:["--lease-id"],type:"string",usageLabel:"--lease-id <id>",usageDescription:"Lease identifier bound to tenant/run admission scope"},{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","android","apple"],usageLabel:"--platform ios|android|apple",usageDescription:"Platform to target (`apple` aliases the iOS/tvOS backend)"},{key:"target",names:["--target"],type:"enum",enumValues:["mobile","tv"],usageLabel:"--target mobile|tv",usageDescription:"Device target class to match"},{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:"headless",names:["--headless"],type:"boolean",usageLabel:"--headless",usageDescription:"Boot: launch Android emulator without a GUI window"},{key:"iosSimulatorDeviceSet",names:["--ios-simulator-device-set"],type:"string",usageLabel:"--ios-simulator-device-set <path>",usageDescription:"Scope iOS simulator discovery/commands to this simulator device set"},{key:"androidDeviceAllowlist",names:["--android-device-allowlist"],type:"string",usageLabel:"--android-device-allowlist <serials>",usageDescription:"Comma/space separated Android serial allowlist for discovery/selection"},{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:"restart",names:["--restart"],type:"boolean",usageLabel:"--restart",usageDescription:"logs clear: stop active stream, clear logs, then start streaming again"},{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","stateDir","daemonTransport","daemonServerMode","tenant","sessionIsolation","runId","leaseId","help","version","verbose","platform","target","device","udid","serial","iosSimulatorDeviceSet","androidDeviceAllowlist","session","noRecord"]),_={boot:{description:"Ensure target device/simulator is booted and ready",positionalArgs:[],allowedFlags:["headless"]},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:[]},push:{description:"Simulate push notification payload delivery",positionalArgs:["bundleOrPackage","payloadOrJson"],allowedFlags:[]},snapshot:{description:"Capture accessibility tree",positionalArgs:[],allowedFlags:[...E]},diff:{usageOverride:"diff snapshot",description:"Diff current accessibility snapshot against previous baseline",positionalArgs:["kind"],allowedFlags:[...E]},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},clipboard:{usageOverride:"clipboard read | clipboard write <text>",description:"Read or write device clipboard text",positionalArgs:["read|write","text?"],allowsExtraPositionals:!0,allowedFlags:[]},keyboard:{usageOverride:"keyboard [status|get|dismiss]",description:"Inspect Android keyboard visibility/type or dismiss it",positionalArgs:["action?"],allowedFlags:[]},perf:{description:"Show session performance metrics (startup timing)",positionalArgs:[],allowedFlags:[]},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:[...L]},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",...L]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...L]},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",...L]},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:[...L]},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"]},"trigger-app-event":{usageOverride:"trigger-app-event <event> [payloadJson]",description:"Trigger app-defined event hook via deep link template",positionalArgs:["event","payloadJson?"],allowedFlags:[]},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},logs:{usageOverride:"logs path | logs start | logs stop | logs clear [--restart] | logs doctor | logs mark [message...]",description:"Session app log info, start/stop streaming, diagnostics, and markers",positionalArgs:["path|start|stop|clear|doctor|mark","message?"],allowsExtraPositionals:!0,allowedFlags:["restart"]},network:{usageOverride:"network dump [limit] [summary|headers|body|all] | network log [limit] [summary|headers|body|all]",description:"Dump recent HTTP(s) traffic parsed from the session app log",positionalArgs:["dump|log","limit?","include?"],allowedFlags:[]},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:[...L]},settings:{usageOverride:h,description:"Toggle OS settings, appearance, and app permissions (session app scope for permission actions)",positionalArgs:["setting","state","target?","mode?"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},P=new Map,N=new Map;for(let e of O){for(let t of e.names)P.set(t,e);let t=N.get(e.key);t?t.push(e):N.set(e.key,[e])}function T(e){if(e)return _[e]}function M(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function C(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(M),...t.allowedFlags.flatMap(e=>(N.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let R=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(_).map(e=>{let t=_[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:C(e,t)}}),s=Math.max(...t.map(e=>e.usage.length))+2,
|
|
5
|
-
${
|
|
4
|
+
`,t=Object.keys(_).map(e=>{let t=_[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:C(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=q("Flags:",O.filter(e=>e.usageLabel&&e.usageDescription));return`${e}
|
|
5
|
+
${a.join("\n")}
|
|
6
6
|
|
|
7
|
-
${
|
|
7
|
+
${r}
|
|
8
8
|
`}();function j(e){return O.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function q(e,t){if(0===t.length)return`${e}
|
|
9
|
-
(none)`;let s=Math.max(...t.map(e=>(e.usageLabel??"").length))+2,
|
|
10
|
-
`)}function W(e,t={}){let s=e instanceof v?
|
|
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 V(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function G(e){return e.replace(/^-+/,"")}function B(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?V(e):[e,void 0];return void 0!==P.get(t)}function J(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}function U(e){process.stdout.write(`${JSON.stringify(e,null,2)}
|
|
10
|
+
`)}function W(e,t={}){let s=e instanceof v?i(e):e;process.stderr.write(`Error (${s.code}): ${s.message}
|
|
11
11
|
`),s.hint&&process.stderr.write(`Hint: ${s.hint}
|
|
12
12
|
`),s.diagnosticId&&process.stderr.write(`Diagnostic ID: ${s.diagnosticId}
|
|
13
13
|
`),s.logPath&&process.stderr.write(`Diagnostics Log: ${s.logPath}
|
|
14
14
|
`),t.showDetails&&s.details&&process.stderr.write(`${JSON.stringify(s.details,null,2)}
|
|
15
|
-
`)}function z(e){return"number"==typeof e&&Number.isFinite(e)?e:0}let H=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 X(e){var t;let s,
|
|
16
|
-
`)}),
|
|
15
|
+
`)}function z(e){return"number"==typeof e&&Number.isFinite(e)?e:0}let H=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 X(e){var t;let s,a,o,i,n=e.meta?.requestId??r(),l=!!(e.meta?.debug||e.flags?.verbose),d=(t=e,s=t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR,o=g(a=t.flags?.daemonTransport??process.env.AGENT_DEVICE_DAEMON_TRANSPORT),i=A(t.flags?.daemonServerMode??process.env.AGENT_DEVICE_DAEMON_SERVER_MODE??("dual"===a?"dual":void 0)),{paths:$(s),transportPreference:o,serverMode:i}),p=await m("daemon_startup",async()=>await Z(d),{requestId:n,session:e.session}),u={...e,token:p.token,meta:{requestId:n,debug:l,cwd:e.meta?.cwd,tenantId:e.meta?.tenantId??e.flags?.tenant,runId:e.meta?.runId??e.flags?.runId,leaseId:e.meta?.leaseId??e.flags?.leaseId,sessionIsolation:e.meta?.sessionIsolation??e.flags?.sessionIsolation}};return f({level:"info",phase:"daemon_request_prepare",data:{requestId:n,command:e.command,session:e.session}}),await m("daemon_request",async()=>await ed(p,u,d.transportPreference),{requestId:n,command:e.command})}async function Z(e){let t,a=et(e.paths.infoPath),r=d(),o=function(e,t=p()){try{let a=b.statSync(e),r=s.relative(t,e)||e;return`${r}:${a.size}:${Math.trunc(a.mtimeMs)}`}catch{return"unknown"}}((t=el()).useSrc?t.srcPath:t.distPath,t.root),i=!!a&&await ei(a,e.transportPreference);if(a&&a.version===r&&a.codeSignature===o&&i)return a;a&&(a.version!==r||a.codeSignature!==o||!i)&&(await ee(a),eo(e.paths.infoPath)),function(e){let t=ea(e);if(!t.hasLock||t.hasInfo)return;let s=es(e.lockPath);if(!s)return eo(e.lockPath);n(s.pid,s.processStartTime)||eo(e.lockPath)}(e.paths),await en(e);let l=await Y(5e3,e);if(l)return l;if(await Q(e.paths)){await en(e);let t=await Y(5e3,e);if(t)return t}throw new v("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:e.paths.infoPath,lockPath:e.paths.lockPath,hint:function(e,t=$(process.env.AGENT_DEVICE_STATE_DIR)){return e.hasLock&&!e.hasInfo?`Detected ${t.lockPath} without ${t.infoPath}. If no agent-device daemon process is running, delete ${t.lockPath} and retry.`:e.hasLock&&e.hasInfo?`Daemon metadata may be stale. If no agent-device daemon process is running, delete ${t.infoPath} and ${t.lockPath}, then retry.`:`Daemon metadata is missing or stale. Delete ${t.infoPath} if present and retry.`}(ea(e.paths),e.paths)})}async function Y(e,t){let s=Date.now();for(;Date.now()-s<e;){let e=et(t.paths.infoPath);if(e&&await ei(e,t.transportPreference))return e;await new Promise(e=>setTimeout(e,100))}return null}async function Q(e){let t=ea(e);if(!t.hasLock||t.hasInfo)return!1;let s=es(e.lockPath);return s&&n(s.pid,s.processStartTime)&&await S(s.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:s.processStartTime}),eo(e.lockPath),!0}async function ee(e){await S(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function et(e){let t=er(e);if(!t||"string"!=typeof t.token||0===t.token.length)return null;let s=Number.isInteger(t.port)&&Number(t.port)>0,a=Number.isInteger(t.httpPort)&&Number(t.httpPort)>0;return s||a?{...t,port:s?Number(t.port):void 0,httpPort:a?Number(t.httpPort):void 0,pid:Number.isInteger(t.pid)&&t.pid>0?t.pid:0}:null}function es(e){let t=er(e);return t&&Number.isInteger(t.pid)&&!(t.pid<=0)?t:null}function ea(e){return{hasInfo:b.existsSync(e.infoPath),hasLock:b.existsSync(e.lockPath)}}function er(e){if(!b.existsSync(e))return null;try{return JSON.parse(b.readFileSync(e,"utf8"))}catch{return null}}function eo(e){try{b.existsSync(e)&&b.unlinkSync(e)}catch{}}async function ei(e,s){var a,r;return"http"===ep(e,s)?await ((a=e.httpPort)?new Promise(e=>{let s=t.request({host:"127.0.0.1",port:a,path:"/health",method:"GET",timeout:500},t=>{t.resume(),e((t.statusCode??500)<500)});s.on("timeout",()=>{s.destroy(),e(!1)}),s.on("error",()=>{e(!1)}),s.end()}):Promise.resolve(!1)):await ((r=e.port)?new Promise(e=>{let t=I.createConnection({host:"127.0.0.1",port:r},()=>{t.destroy(),e(!0)});t.on("error",()=>{e(!1)})}):Promise.resolve(!1))}async function en(e){let t=el(),s=t.useSrc?["--experimental-strip-types",t.srcPath]:[t.distPath],a={...process.env,AGENT_DEVICE_STATE_DIR:e.paths.baseDir,AGENT_DEVICE_DAEMON_SERVER_MODE:e.serverMode};l(process.execPath,s,{env:a})}function el(){let e=p(),t=s.join(e,"dist","src","daemon.js"),a=s.join(e,"src","daemon.ts"),r=b.existsSync(t),o=b.existsSync(a);if(!r&&!o)throw new v("COMMAND_FAILED","Daemon entry not found",{distPath:t,srcPath:a});return{root:e,distPath:t,srcPath:a,useSrc:process.execArgv.includes("--experimental-strip-types")?o:!r&&o}}async function ed(e,t,s){return"http"===ep(e,s)?await ec(e,t):await eu(e,t)}function ep(e,t){if("http"===t){if(!e.httpPort)throw new v("COMMAND_FAILED","Daemon HTTP endpoint is unavailable");return"http"}if("socket"===t){if(!e.port)throw new v("COMMAND_FAILED","Daemon socket endpoint is unavailable");return"socket"}let s=e.transport;if("http"===s&&e.httpPort)return"http";if(("socket"===s||"dual"===s)&&e.port)return"socket";if(e.httpPort)return"http";if(e.port)return"socket";throw new v("COMMAND_FAILED","Daemon metadata has no reachable transport")}async function eu(e,t){let s=e.port;if(!s)throw new v("COMMAND_FAILED","Daemon socket endpoint is unavailable");return new Promise((a,r)=>{let o=I.createConnection({host:"127.0.0.1",port:s},()=>{o.write(`${JSON.stringify(t)}
|
|
16
|
+
`)}),i=setTimeout(()=>{o.destroy();let s=em(),a=eg(e,$(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR));f({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:H,requestId:t.meta?.requestId,command:t.command,timedOutRunnerPidsTerminated:s.terminated,timedOutRunnerCleanupError:s.error,daemonPidReset:e.pid,daemonPidForceKilled:a.forcedKill}}),r(new v("COMMAND_FAILED","Daemon request timed out",{timeoutMs:H,requestId:t.meta?.requestId,hint:"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."}))},H),n="";o.setEncoding("utf8"),o.on("data",e=>{let s=(n+=e).indexOf("\n");if(-1===s)return;let l=n.slice(0,s).trim();if(l)try{let e=JSON.parse(l);o.end(),clearTimeout(i),a(e)}catch(e){clearTimeout(i),r(new v("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:l},e instanceof Error?e:void 0))}}),o.on("error",e=>{clearTimeout(i),f({level:"error",phase:"daemon_request_socket_error",data:{requestId:t.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),r(new v("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))})})}async function ec(e,s){let a=e.httpPort;if(!a)throw new v("COMMAND_FAILED","Daemon HTTP endpoint is unavailable");let o=JSON.stringify({jsonrpc:"2.0",id:s.meta?.requestId??r(),method:"agent_device.command",params:s});return await new Promise((r,i)=>{let n=$(s.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),l=t.request({host:"127.0.0.1",port:a,method:"POST",path:"/rpc",headers:{"content-type":"application/json","content-length":Buffer.byteLength(o)}},e=>{let t="";e.setEncoding("utf8"),e.on("data",e=>{t+=e}),e.on("end",()=>{clearTimeout(d);try{let e=JSON.parse(t);if(e.error){let t=e.error.data??{};i(new v(String(t.code??"COMMAND_FAILED"),String(t.message??e.error.message??"Daemon RPC request failed"),{..."object"==typeof t.details&&t.details?t.details:{},hint:"string"==typeof t.hint?t.hint:void 0,diagnosticId:"string"==typeof t.diagnosticId?t.diagnosticId:void 0,logPath:"string"==typeof t.logPath?t.logPath:void 0,requestId:s.meta?.requestId}));return}if(!e.result||"object"!=typeof e.result)return void i(new v("COMMAND_FAILED","Invalid daemon RPC response",{requestId:s.meta?.requestId}));r(e.result)}catch(e){clearTimeout(d),i(new v("COMMAND_FAILED","Invalid daemon response",{requestId:s.meta?.requestId,line:t},e instanceof Error?e:void 0))}})}),d=setTimeout(()=>{l.destroy();let t=em(),a=eg(e,n);f({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:H,requestId:s.meta?.requestId,command:s.command,timedOutRunnerPidsTerminated:t.terminated,timedOutRunnerCleanupError:t.error,daemonPidReset:e.pid,daemonPidForceKilled:a.forcedKill}}),i(new v("COMMAND_FAILED","Daemon request timed out",{timeoutMs:H,requestId:s.meta?.requestId,hint:"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."}))},H);l.on("error",e=>{clearTimeout(d),f({level:"error",phase:"daemon_request_socket_error",data:{requestId:s.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),i(new v("COMMAND_FAILED","Failed to communicate with daemon",{requestId:s.meta?.requestId,hint:"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e))}),l.write(o),l.end()})}function em(){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)}}}function eg(e,t){let s=!1;try{n(e.pid,e.processStartTime)&&(process.kill(e.pid,"SIGKILL"),s=!0)}catch{S(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}finally{eo(t.infoPath),eo(t.lockPath)}return{forcedKill:s}}let ef={sendToDaemon:X};async function eh(t,s=ef){let n=r(),l=t.includes("--debug")||t.includes("--verbose")||t.includes("-v"),p=t.includes("--json"),c=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}(t)??process.env.AGENT_DEVICE_SESSION??"default";await D({session:c,requestId:n,command:t[0],debug:l},async()=>{var r,c;let m;try{m=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,o=[],i=[],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?o.push(s):r=J(s);continue}let i=s.startsWith("--"),d=s.startsWith("-")&&s.length>1;if(!i&&!d){r?o.push(s):r=J(s);continue}let[p,u]=i?V(s):[s,void 0],c=P.get(p);if(!c){if(function(e,t,s){var a;if(a=s,!/^-\d+(\.\d+)?$/.test(a)||!e)return!1;let r=T(e);return!r||!!r.allowsExtraPositionals||0!==r.positionalArgs.length&&(t.length<r.positionalArgs.length||r.positionalArgs.some(e=>e.includes("?")))}(r,o,s)){r?o.push(s):r=s;continue}throw new v("INVALID_ARGS",`Unknown flag: ${p}`)}let m=function(e,t,s,a){if(void 0!==e.setValue){if(void 0!==s)throw new v("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 v("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 v("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===a||B(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&&B(r))throw new v("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 v("INVALID_ARGS",`Invalid ${G(t)}: ${r}`);return{value:r,consumeNext:void 0===s}}let o=Number(r);if(!Number.isFinite(o)||"number"==typeof e.min&&o<e.min||"number"==typeof e.max&&o>e.max)throw new v("INVALID_ARGS",`Invalid ${G(t)}: ${r}`);return{value:Math.floor(o),consumeNext:void 0===s}}(c,p,u,e[t+1]);m.consumeNext&&(t+=1),a[c.key]=m.value,n.push({key:c.key,token:p})}let d=T(r),p=new Set([...F,...d?.allowedFlags??[]]),u=n.filter(e=>!p.has(e.key));if(u.length>0){var c,m;let e=(c=r,m=u.map(e=>e.token),c?1===m.length?`Flag ${m[0]} is not supported for command ${c}.`:`Flags ${m.join(", ")} are not supported for command ${c}.`: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 v("INVALID_ARGS",e);for(let t of(i.push(`${e} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),u))delete a[t.key]}if(d?.defaults)for(let[e,t]of Object.entries(d.defaults))void 0===a[e]&&(a[e]=t);if("batch"===r&&1!=+!!a.steps+ +!!a.stepsFile)throw new v("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return{command:r,positionals:o,flags:a,warnings:i}}(t)}catch(t){f({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=i(t,{diagnosticId:u().diagnosticId,logPath:k({force:!0})??void 0});p?U({success:!1,error:e}):W(e,{showDetails:l}),process.exit(1);return}for(let e of m.warnings)process.stderr.write(`Warning: ${e}
|
|
17
17
|
`);m.flags.version&&(process.stdout.write(`${d()}
|
|
18
18
|
`),process.exit(0));let g="help"===m.command,h=m.flags.help;if(g||h){g&&m.positionals.length>1&&(W(new v("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=g?m.positionals[0]:m.command;e||(process.stdout.write(`${R}
|
|
19
|
-
`),process.exit(0));let t=function(e){let t=T(e);if(!t)return null;let s=C(e,t),
|
|
19
|
+
`),process.exit(0));let t=function(e){let t=T(e);if(!t)return null;let s=C(e,t),a=j(new Set(t.allowedFlags)),r=j(F),o=[];return a.length>0&&o.push(q("Command flags:",a)),o.push(q("Global flags:",r)),`agent-device ${s}
|
|
20
20
|
|
|
21
21
|
${t.description}
|
|
22
22
|
|
|
@@ -26,20 +26,20 @@ Usage:
|
|
|
26
26
|
${o.join("\n\n")}
|
|
27
27
|
`}(J(e));t&&(process.stdout.write(t),process.exit(0)),W(new v("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${R}
|
|
28
28
|
`),process.exit(1)}m.command||(process.stdout.write(`${R}
|
|
29
|
-
`),process.exit(1));let{command:w,positionals:D,flags:I}=m,
|
|
30
|
-
`)),L&&L();return}if("session"===w){let e=D[0]??"list";if("list"!==e)throw new v("INVALID_ARGS","session only supports list");let t=await O({command:"session_list",positionals:[],flags:
|
|
31
|
-
`),L&&L();return}let t=await O({command:w,positionals:D,flags:
|
|
32
|
-
`:"";if(0===
|
|
33
|
-
`;if(t.raw){let e=
|
|
29
|
+
`),process.exit(1));let{command:w,positionals:D,flags:I}=m,A=function(e){let{json:t,help:s,version:a,...r}=e;return r}(I),S=$(I.stateDir??process.env.AGENT_DEVICE_STATE_DIR),E=I.session??process.env.AGENT_DEVICE_SESSION??"default",L=I.verbose&&!I.json?function(e){try{let t=0,s=!1,a=setInterval(()=>{if(!s&&b.existsSync(e))try{let s=b.statSync(e);if(s.size<t&&(t=0),s.size<=t)return;let a=b.openSync(e,"r");try{let e=Buffer.alloc(s.size-t);b.readSync(a,e,0,e.length,t),t=s.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{b.closeSync(a)}}catch{}},200);return()=>{s=!0,clearInterval(a)}}catch{return null}}(S.logPath):null,O=async e=>await s.sendToDaemon({session:E,command:e.command,positionals:e.positionals,flags:e.flags,meta:{requestId:n,debug:!!I.verbose,cwd:process.cwd(),tenantId:I.tenant,runId:I.runId,leaseId:I.leaseId,sessionIsolation:I.sessionIsolation}});try{if("batch"===w){let e,t,s;if(D.length>0)throw new v("INVALID_ARGS","batch does not accept positional arguments.");let a=function(e){let t="";if(e.steps)t=e.steps;else if(e.stepsFile)try{t=b.readFileSync(e.stepsFile,"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new v("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return o(t)}(I),i={...A,batchSteps:a};delete i.steps,delete i.stepsFile;let n=await O({command:"batch",positionals:D,flags:i});if(!n.ok)throw new v(n.error.code,n.error.message,{...n.error.details??{},hint:n.error.hint,diagnosticId:n.error.diagnosticId,logPath:n.error.logPath});I.json?U({success:!0,data:n.data??{}}):(r=n.data??{},e="number"==typeof r.total?r.total:0,t="number"==typeof r.executed?r.executed:0,s="number"==typeof r.totalDurationMs?r.totalDurationMs:void 0,process.stdout.write(`Batch completed: ${t}/${e} steps${void 0!==s?` in ${s}ms`:""}
|
|
30
|
+
`)),L&&L();return}if("session"===w){let e=D[0]??"list";if("list"!==e)throw new v("INVALID_ARGS","session only supports list");let t=await O({command:"session_list",positionals:[],flags:A});if(!t.ok)throw new v(t.error.code,t.error.message,{...t.error.details??{},hint:t.error.hint,diagnosticId:t.error.diagnosticId,logPath:t.error.logPath});I.json?U({success:!0,data:t.data??{}}):process.stdout.write(`${JSON.stringify(t.data??{},null,2)}
|
|
31
|
+
`),L&&L();return}let t=await O({command:w,positionals:D,flags:A});if(t.ok){if(I.json){U({success:!0,data:t.data??{}}),L&&L();return}if("snapshot"===w){process.stdout.write(function(e,t={}){let s=e.nodes,r=Array.isArray(s)?s:[],o=!!e.truncated,i="string"==typeof e.appName?e.appName:void 0,n="string"==typeof e.appBundleId?e.appBundleId:void 0,l=[];i&&l.push(`Page: ${i}`),n&&l.push(`App: ${n}`);let d=`Snapshot: ${r.length} nodes${o?" (truncated)":""}`,p=l.length>0?`${l.join("\n")}
|
|
32
|
+
`:"";if(0===r.length)return`${p}${d}
|
|
33
|
+
`;if(t.raw){let e=r.map(e=>JSON.stringify(e));return`${p}${d}
|
|
34
34
|
${e.join("\n")}
|
|
35
|
-
`}if(t.flatten){let e=
|
|
35
|
+
`}if(t.flatten){let e=r.map(e=>x(e,0,!1));return`${p}${d}
|
|
36
36
|
${e.join("\n")}
|
|
37
|
-
`}let u=r
|
|
37
|
+
`}let u=a(r).map(e=>e.text);return`${p}${d}
|
|
38
38
|
${u.join("\n")}
|
|
39
|
-
`}(t.data??{},{raw:I.snapshotRaw,flatten:I.snapshotInteractiveOnly})),L&&L();return}if("diff"===w&&"snapshot"===D[0]){process.stdout.write(function(t){var s,r,
|
|
40
|
-
`;let m=(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
|
|
39
|
+
`}(t.data??{},{raw:I.snapshotRaw,flatten:I.snapshotInteractiveOnly})),L&&L();return}if("diff"===w&&"snapshot"===D[0]){process.stdout.write(function(t){var s,a,r,o;let i,n=!0===t.baselineInitialized,l=t.summary??{},d=z(l.additions),p=z(l.removals),u=z(l.unchanged),c=(i=process.env.FORCE_COLOR,"string"==typeof i?"0"!==i:"string"!=typeof process.env.NO_COLOR&&!!process.stdout.isTTY);if(n)return`Baseline initialized (${u} lines).
|
|
40
|
+
`;let m=(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),r=Math.min(e.length-1,t+1);for(let e=s;e<=r;e+=1)a[e]=!0}return e.filter((e,t)=>a[t])})(Array.isArray(t.lines)?t.lines:[],1).map(t=>{var s,a,r,o;let i="string"==typeof t.text?t.text:"";if("added"===t.kind){let t=i.startsWith(" ")?`+${i}`:`+ ${i}`;return c?(s=t,a="green",e(a,s)):t}if("removed"===t.kind){let t=i.startsWith(" ")?`-${i}`:`- ${i}`;return c?(r=t,e("red",r)):t}return c?(o=i,e("dim",o)):i}),g=m.length>0?`${m.join("\n")}
|
|
41
41
|
`:"";if(!c)return`${g}${d} additions, ${p} removals, ${u} unchanged
|
|
42
|
-
`;let f=`${(s=String(d),
|
|
42
|
+
`;let f=`${(s=String(d),a="green",e(a,s))} additions, ${(r=String(p),e("red",r))} removals, ${(o=String(u),e("dim",o))} unchanged`;return`${g}${f}
|
|
43
43
|
`}(t.data??{})),L&&L();return}if("get"===w){let e=D[0];if("text"===e){let e=t.data?.text??"";process.stdout.write(`${e}
|
|
44
44
|
`),L&&L();return}if("attrs"===e){let e=t.data?.node??{};process.stdout.write(`${JSON.stringify(e,null,2)}
|
|
45
45
|
`),L&&L();return}}if("find"===w){let e=t.data;if("string"==typeof e?.text){process.stdout.write(`${e.text}
|
|
@@ -48,28 +48,28 @@ ${u.join("\n")}
|
|
|
48
48
|
`),L&&L();return}}if("is"===w){let e=t.data?.predicate??"assertion";process.stdout.write(`Passed: is ${e}
|
|
49
49
|
`),L&&L();return}if("boot"===w){let e=t.data?.platform??"unknown",s=t.data?.device??t.data?.id??"unknown";process.stdout.write(`Boot ready: ${s} (${e})
|
|
50
50
|
`),L&&L();return}if("logs"===w){let e=t.data,s="string"==typeof e?.path?e.path:"";if(s){process.stdout.write(`${s}
|
|
51
|
-
`);let t="boolean"==typeof e?.active?e.active:void 0,
|
|
52
|
-
`)}if(!I.json&&(n||
|
|
51
|
+
`);let t="boolean"==typeof e?.active?e.active:void 0,a="string"==typeof e?.state?e.state:void 0,r="string"==typeof e?.backend?e.backend:void 0,o="number"==typeof e?.sizeBytes?e.sizeBytes:void 0,i=e?.started===!0,n=e?.stopped===!0,l=e?.marked===!0,d=e?.cleared===!0,p=e?.restarted===!0,u="number"==typeof e?.removedRotatedFiles?e.removedRotatedFiles:void 0;if(!I.json&&(void 0!==t||a||r||void 0!==o)){let e=[void 0!==t?`active=${t}`:"",a?`state=${a}`:"",r?`backend=${r}`:"",void 0!==o?`sizeBytes=${o}`:""].filter(Boolean).join(" ");e&&process.stderr.write(`${e}
|
|
52
|
+
`)}if(!I.json&&(i||n||l||d||p||void 0!==u)){let e=[i?"started=true":"",n?"stopped=true":"",l?"marked=true":"",d?"cleared=true":"",p?"restarted=true":"",void 0!==u?`removedRotatedFiles=${u}`:""].filter(Boolean).join(" ");e&&process.stderr.write(`${e}
|
|
53
53
|
`)}if(e?.hint&&!I.json&&process.stderr.write(`${e.hint}
|
|
54
54
|
`),Array.isArray(e?.notes)&&!I.json)for(let t of e.notes)"string"==typeof t&&t.length>0&&process.stderr.write(`${t}
|
|
55
55
|
`)}L&&L();return}if("clipboard"===w){let e=t.data,s=(D[0]??("string"==typeof e?.action?e.action:"")).toLowerCase();if("read"===s){let t="string"==typeof e?.text?e.text:"";process.stdout.write(`${t}
|
|
56
56
|
`),L&&L();return}if("write"===s){process.stdout.write("Clipboard updated\n"),L&&L();return}}if("network"===w){let e=t.data,s="string"==typeof e?.path?e.path:"";s&&process.stdout.write(`${s}
|
|
57
|
-
`);let
|
|
57
|
+
`);let a=Array.isArray(e?.entries)?e.entries:[];if(0===a.length)process.stdout.write("No recent HTTP(s) entries found.\n");else for(let e of a){let t="string"==typeof e.method?e.method:"HTTP",s="string"==typeof e.url?e.url:"<unknown-url>",a="number"==typeof e.status?` status=${e.status}`:"",r="string"==typeof e.timestamp?`${e.timestamp} `:"";process.stdout.write(`${r}${t} ${s}${a}
|
|
58
58
|
`),"string"==typeof e.headers&&process.stdout.write(` headers: ${e.headers}
|
|
59
59
|
`),"string"==typeof e.requestBody&&process.stdout.write(` request: ${e.requestBody}
|
|
60
60
|
`),"string"==typeof e.responseBody&&process.stdout.write(` response: ${e.responseBody}
|
|
61
|
-
`)}let
|
|
61
|
+
`)}let r="boolean"==typeof e?.active?e.active:void 0,o="string"==typeof e?.state?e.state:void 0,i="string"==typeof e?.backend?e.backend:void 0,n="number"==typeof e?.scannedLines?e.scannedLines:void 0,l="number"==typeof e?.matchedLines?e.matchedLines:void 0,d="string"==typeof e?.include?e.include:void 0,p=[void 0!==r?`active=${r}`:"",o?`state=${o}`:"",i?`backend=${i}`:"",d?`include=${d}`:"",void 0!==n?`scannedLines=${n}`:"",void 0!==l?`matchedLines=${l}`:""].filter(Boolean).join(" ");if(p&&process.stderr.write(`${p}
|
|
62
62
|
`),Array.isArray(e?.notes))for(let t of e.notes)"string"==typeof t&&t.length>0&&process.stderr.write(`${t}
|
|
63
|
-
`);L&&L();return}if("click"===w||"press"===w){let e=t.data?.ref??"",s=t.data?.x,
|
|
64
|
-
`),L&&L();return}if(t.data&&"object"==typeof t.data){let e=t.data;if("devices"===w){let t=(Array.isArray(e.devices)?e.devices:[]).map(e=>{let t=e?.name??e?.id??"unknown",s=e?.platform??"unknown",
|
|
63
|
+
`);L&&L();return}if("click"===w||"press"===w){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})
|
|
64
|
+
`),L&&L();return}if(t.data&&"object"==typeof t.data){let e=t.data;if("devices"===w){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=e?.target?` target=${e.target}`:"",o="boolean"==typeof e?.booted?` booted=${e.booted}`:"";return`${t} (${s}${a}${r})${o}`});process.stdout.write(`${t.join("\n")}
|
|
65
65
|
`),L&&L();return}if("apps"===w){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")}
|
|
66
|
-
`),L&&L();return}if("appstate"===w){let t=e?.platform,s=e?.appBundleId,
|
|
66
|
+
`),L&&L();return}if("appstate"===w){let t=e?.platform,s=e?.appBundleId,a=e?.appName,r=e?.source,o=e?.package,i=e?.activity;if("ios"===t){process.stdout.write(`Foreground app: ${a??s??"unknown"}
|
|
67
67
|
`),s&&process.stdout.write(`Bundle: ${s}
|
|
68
|
-
`),
|
|
68
|
+
`),r&&process.stdout.write(`Source: ${r}
|
|
69
69
|
`),L&&L();return}if("android"===t){process.stdout.write(`Foreground app: ${o??"unknown"}
|
|
70
|
-
`),
|
|
70
|
+
`),i&&process.stdout.write(`Activity: ${i}
|
|
71
71
|
`),L&&L();return}}if("perf"===w){process.stdout.write(`${JSON.stringify(e,null,2)}
|
|
72
|
-
`),L&&L();return}}L&&L();return}throw new v(t.error.code,t.error.message,{...t.error.details??{},hint:t.error.hint,diagnosticId:t.error.diagnosticId,logPath:t.error.logPath})}catch(s){let e=y(s),t=
|
|
72
|
+
`),L&&L();return}}L&&L();return}throw new v(t.error.code,t.error.message,{...t.error.details??{},hint:t.error.hint,diagnosticId:t.error.diagnosticId,logPath:t.error.logPath})}catch(s){let e=y(s),t=i(e,{diagnosticId:u().diagnosticId,logPath:k({force:!0})??void 0});if("close"===w&&"COMMAND_FAILED"===(c=e).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))){I.json&&U({success:!0,data:{closed:"session",source:"no-daemon"}}),L&&L();return}if(I.json)U({success:!1,error:t});else if(W(t,{showDetails:I.verbose}),I.verbose)try{let e=S.logPath;if(b.existsSync(e)){let t=b.readFileSync(e,"utf8").split("\n"),s=t.slice(Math.max(0,t.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
|
|
73
73
|
[daemon log]
|
|
74
74
|
${s}
|
|
75
|
-
`)}}catch{}L&&L(),process.exit(1)}})}w(process.argv[1]??"").href===import.meta.url&&eh(process.argv.slice(2)).catch(e=>{W(
|
|
75
|
+
`)}}catch{}L&&L(),process.exit(1)}})}w(process.argv[1]??"").href===import.meta.url&&eh(process.argv.slice(2)).catch(e=>{W(i(y(e)),{showDetails:!0}),process.exit(1)}),eh(process.argv.slice(2));
|