agent-device 0.12.7 → 0.12.9

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 (55) hide show
  1. package/dist/src/113.js +1 -1
  2. package/dist/src/1974.js +2 -0
  3. package/dist/src/3883.js +1 -0
  4. package/dist/src/3918.js +32 -0
  5. package/dist/src/4057.js +1 -0
  6. package/dist/src/4829.js +1 -0
  7. package/dist/src/4993.js +1 -0
  8. package/dist/src/7556.js +1 -0
  9. package/dist/src/7651.js +1 -0
  10. package/dist/src/7847.js +1 -0
  11. package/dist/src/8164.js +1 -0
  12. package/dist/src/8564.js +3 -0
  13. package/dist/src/9076.js +1 -0
  14. package/dist/src/9152.js +1 -0
  15. package/dist/src/9323.js +5 -0
  16. package/dist/src/9366.js +1 -0
  17. package/dist/src/9542.js +2 -0
  18. package/dist/src/9818.js +1 -0
  19. package/dist/src/989.js +1 -0
  20. package/dist/src/android-apps.js +1 -1
  21. package/dist/src/artifacts.js +1 -1
  22. package/dist/src/backend.js +1 -1
  23. package/dist/src/bin.d.ts +1 -0
  24. package/dist/src/bin.js +68 -70
  25. package/dist/src/commands/index.d.ts +4 -1
  26. package/dist/src/commands/index.js +1 -1
  27. package/dist/src/contracts.d.ts +3 -1
  28. package/dist/src/contracts.js +1 -1
  29. package/dist/src/daemon.d.ts +1 -0
  30. package/dist/src/daemon.js +15 -15
  31. package/dist/src/finders.js +1 -1
  32. package/dist/src/index.d.ts +17 -11
  33. package/dist/src/index.js +1 -3
  34. package/dist/src/install-source.js +1 -1
  35. package/dist/src/io.js +1 -1
  36. package/dist/src/metro-companion.d.ts +1 -0
  37. package/dist/src/metro.d.ts +9 -11
  38. package/dist/src/metro.js +1 -1
  39. package/dist/src/remote-config.js +1 -1
  40. package/dist/src/selectors.js +1 -1
  41. package/dist/src/testing/conformance.js +1 -1
  42. package/dist/src/update-check-entry.d.ts +1 -0
  43. package/package.json +9 -1
  44. package/skills/agent-device/references/exploration.md +1 -0
  45. package/skills/agent-device/references/remote-tenancy.md +9 -6
  46. package/skills/agent-device/references/verification.md +3 -0
  47. package/dist/src/152.js +0 -1
  48. package/dist/src/164.js +0 -1
  49. package/dist/src/556.js +0 -1
  50. package/dist/src/57.js +0 -1
  51. package/dist/src/641.js +0 -38
  52. package/dist/src/818.js +0 -1
  53. package/dist/src/974.js +0 -2
  54. /package/dist/src/{267.js → 3267.js} +0 -0
  55. /package/dist/src/{1~rslib-runtime.js → rslib-runtime.js} +0 -0
package/dist/src/bin.js CHANGED
@@ -1,99 +1,97 @@
1
- let e,t,r,a,n,o,s;import i from"node:path";import{styleText as l}from"node:util";import{fileURLToPath as c,pathToFileURL as u}from"node:url";import d from"node:net";import p from"node:http";import m from"node:https";import f,{promises as h}from"node:fs";import g from"node:os";import y,{createHash as w,randomUUID as b}from"node:crypto";import{parseDeviceRotation as v,SESSION_SURFACES as I,readProcessCommand as k,waitForProcessExit as A,serializeSessionListEntry as S,serializeSnapshotResult as D,isAgentDeviceDaemonProcess as $,buildDeviceIdentifiers as x,buildAppIdentifiers as N,isEnvTruthy as P,parseBatchStepsJson as L,computeDaemonCodeSignature as _,resolveDaemonTransportPreference as E,splitSelectorFromArgs as M,serializeOpenResult as R,parseWaitArgs as T,expandUserHomePath as C,serializeDeployResult as O,readCommandMessage as U,serializeEnsureSimulatorResult as F,localCommandPolicy as j,serializeDevice as B,buildSnapshotDisplayLines as V,buildMobileSnapshotPresentation as G,createRequestId as q,tryParseSelectorChain as H,readVersion as K,displayNodeLabel as J,findProjectRoot as z,getDiagnosticsMeta as W,withDiagnosticTimer as X,resolveUserPath as Y,serializeCloseResult as Z,emitDiagnostic as Q,SETTINGS_USAGE_OVERRIDE as ee,isProcessAlive as et,readProcessStartTime as er,withDiagnosticsScope as ea,resolveDaemonPaths as en,flushDiagnosticsToSessionFile as eo,resolveDaemonServerMode as es,serializeInstallFromSourceResult as ei,createAgentDevice as el,stopProcessForTakeover as ec,formatSnapshotLine as eu}from"./641.js";import{runCmdDetached as ed,runCmdSync as ep,asAppError as em,normalizeError as ef,runCmd as eh,AppError as eg}from"./818.js";import{METRO_COMPANION_RUN_ARG as ey,normalizeBaseUrl as ew,buildBundleUrl as eb,ENV_SERVER_BASE_URL as ev,ENV_LOCAL_BASE_URL as eI,ENV_STATE_PATH as ek,ENV_LAUNCH_URL as eA,ENV_SCOPE_TENANT_ID as eS,ENV_SCOPE_RUN_ID as eD,ENV_BEARER_TOKEN as e$,ENV_SCOPE_LEASE_ID as ex}from"./320.js";import{maybeRunUpgradeNotifier as eN}from"./113.js";function eP(e,t){for(let[r,a]of Object.entries(t))void 0!==a&&(e[r]=a);return e}let eL=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],e_=["snapshotDepth","snapshotScope","snapshotRaw"],eE=[{key:"config",names:["--config"],type:"string",usageLabel:"--config <path>",usageDescription:"Load CLI defaults from a specific config file"},{key:"remoteConfig",names:["--remote-config"],type:"string",usageLabel:"--remote-config <path>",usageDescription:"Load remote host + Metro workflow settings from a specific profile file"},{key:"stateDir",names:["--state-dir"],type:"string",usageLabel:"--state-dir <path>",usageDescription:"Daemon state directory (defaults to ~/.agent-device)"},{key:"daemonBaseUrl",names:["--daemon-base-url"],type:"string",usageLabel:"--daemon-base-url <url>",usageDescription:"Explicit remote HTTP daemon base URL (skip local daemon discovery/startup)"},{key:"daemonAuthToken",names:["--daemon-auth-token"],type:"string",usageLabel:"--daemon-auth-token <token>",usageDescription:"Remote HTTP daemon auth token (sent as request token and bearer header)"},{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:"leaseBackend",names:["--lease-backend"],type:"enum",enumValues:["ios-simulator","ios-instance","android-instance"],usageLabel:"--lease-backend ios-simulator|ios-instance|android-instance",usageDescription:"Lease backend for remote tenant connection admission"},{key:"force",names:["--force"],type:"boolean",usageLabel:"--force",usageDescription:"Force connection state replacement when reconnecting"},{key:"sessionLock",names:["--session-lock"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock reject|strip",usageDescription:"Lock bound-session device routing for this CLI invocation and nested batch steps"},{key:"sessionLocked",names:["--session-locked"],type:"boolean",usageLabel:"--session-locked",usageDescription:"Deprecated alias for --session-lock reject"},{key:"sessionLockConflicts",names:["--session-lock-conflicts"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock-conflicts reject|strip",usageDescription:"Deprecated alias for --session-lock"},{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","macos","android","linux","apple"],usageLabel:"--platform ios|macos|android|linux|apple",usageDescription:"Platform to target (`apple` aliases the Apple automation backend)"},{key:"target",names:["--target"],type:"enum",enumValues:["mobile","tv","desktop"],usageLabel:"--target mobile|tv|desktop",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:"surface",names:["--surface"],type:"enum",enumValues:I,usageLabel:"--surface app|frontmost-app|desktop|menubar",usageDescription:"macOS session surface for open (defaults to app)"},{key:"headless",names:["--headless"],type:"boolean",usageLabel:"--headless",usageDescription:"Boot: launch Android emulator without a GUI window"},{key:"runtime",names:["--runtime"],type:"string",usageLabel:"--runtime <id>",usageDescription:"ensure-simulator: CoreSimulator runtime identifier (e.g. com.apple.CoreSimulator.SimRuntime.iOS-18-0)"},{key:"metroHost",names:["--metro-host"],type:"string",usageLabel:"--metro-host <host>",usageDescription:"Session-scoped Metro/debug host hint"},{key:"metroPort",names:["--metro-port"],type:"int",min:1,max:65535,usageLabel:"--metro-port <port>",usageDescription:"Session-scoped Metro/debug port hint"},{key:"metroProjectRoot",names:["--project-root"],type:"string",usageLabel:"--project-root <path>",usageDescription:"metro prepare: React Native project root (default: cwd)"},{key:"metroKind",names:["--kind"],type:"enum",enumValues:["auto","react-native","expo"],usageLabel:"--kind auto|react-native|expo",usageDescription:"metro prepare: detect or force the Metro launcher kind"},{key:"metroPublicBaseUrl",names:["--public-base-url"],type:"string",usageLabel:"--public-base-url <url>",usageDescription:"metro prepare: public base URL used to build bundle hints"},{key:"metroProxyBaseUrl",names:["--proxy-base-url"],type:"string",usageLabel:"--proxy-base-url <url>",usageDescription:"metro prepare: optional remote host bridge base URL for Metro access"},{key:"metroBearerToken",names:["--bearer-token"],type:"string",usageLabel:"--bearer-token <token>",usageDescription:"metro prepare: host bridge bearer token (prefer AGENT_DEVICE_PROXY_TOKEN or AGENT_DEVICE_METRO_BEARER_TOKEN)"},{key:"metroPreparePort",names:["--port"],type:"int",min:1,max:65535,usageLabel:"--port <port>",usageDescription:"metro prepare: local Metro port (default: 8081)"},{key:"metroListenHost",names:["--listen-host"],type:"string",usageLabel:"--listen-host <host>",usageDescription:"metro prepare: host Metro listens on (default: 0.0.0.0)"},{key:"metroStatusHost",names:["--status-host"],type:"string",usageLabel:"--status-host <host>",usageDescription:"metro prepare: host used for local /status polling (default: 127.0.0.1)"},{key:"metroStartupTimeoutMs",names:["--startup-timeout-ms"],type:"int",min:1,usageLabel:"--startup-timeout-ms <ms>",usageDescription:"metro prepare: timeout while waiting for Metro to become ready"},{key:"metroProbeTimeoutMs",names:["--probe-timeout-ms"],type:"int",min:1,usageLabel:"--probe-timeout-ms <ms>",usageDescription:"metro prepare: timeout for /status and proxy bridge calls"},{key:"metroRuntimeFile",names:["--runtime-file"],type:"string",usageLabel:"--runtime-file <path>",usageDescription:"metro prepare: optional file path to persist the JSON result"},{key:"metroNoReuseExisting",names:["--no-reuse-existing"],type:"boolean",usageLabel:"--no-reuse-existing",usageDescription:"metro prepare: always start a fresh Metro process"},{key:"metroNoInstallDeps",names:["--no-install-deps"],type:"boolean",usageLabel:"--no-install-deps",usageDescription:"metro prepare: skip package-manager install when node_modules is missing"},{key:"bundleUrl",names:["--bundle-url"],type:"string",usageLabel:"--bundle-url <url>",usageDescription:"Session-scoped bundle URL hint"},{key:"launchUrl",names:["--launch-url"],type:"string",usageLabel:"--launch-url <url>",usageDescription:"Session-scoped deep link / launch URL hint"},{key:"boot",names:["--boot"],type:"boolean",usageLabel:"--boot",usageDescription:"ensure-simulator: boot the simulator after ensuring it exists"},{key:"reuseExisting",names:["--reuse-existing"],type:"boolean",usageLabel:"--reuse-existing",usageDescription:"ensure-simulator: reuse an existing simulator (default: true)"},{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:"header",names:["--header"],type:"string",multiple:!0,usageLabel:"--header <name:value>",usageDescription:"install-from-source: repeatable HTTP header for URL downloads"},{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:"quality",names:["--quality"],type:"int",min:5,max:10,usageLabel:"--quality <5-10>",usageDescription:"Record: scale recording resolution from 5 (50%) through 10 (native resolution)"},{key:"hideTouches",names:["--hide-touches"],type:"boolean",usageLabel:"--hide-touches",usageDescription:"Record: disable touch overlays in the final video"},{key:"intervalMs",names:["--interval-ms"],type:"int",min:0,max:1e4,usageLabel:"--interval-ms <ms>",usageDescription:"Delay between press iterations"},{key:"delayMs",names:["--delay-ms"],type:"int",min:0,max:1e4,usageLabel:"--delay-ms <ms>",usageDescription:"Delay between typed characters"},{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:"pixels",names:["--pixels"],type:"int",min:1,max:1e5,usageLabel:"--pixels <n>",usageDescription:"Scroll: explicit gesture distance in pixels"},{key:"doubleTap",names:["--double-tap"],type:"boolean",usageLabel:"--double-tap",usageDescription:"Use double-tap gesture per press iteration"},{key:"clickButton",names:["--button"],type:"enum",enumValues:["primary","secondary","middle"],usageLabel:"--button primary|secondary|middle",usageDescription:"Click: choose mouse button (middle reserved for future macOS support)"},{key:"backMode",names:["--in-app"],type:"enum",enumValues:["in-app","system"],setValue:"in-app",usageLabel:"--in-app",usageDescription:"Back: use app-provided back UI when available"},{key:"backMode",names:["--system"],type:"enum",enumValues:["in-app","system"],setValue:"system",usageLabel:"--system",usageDescription:"Back: use system back input or gesture when available"},{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:"snapshotDiff",names:["--diff"],type:"boolean",usageLabel:"--diff",usageDescription:"Snapshot: show structural diff against the previous session baseline"},{key:"saveScript",names:["--save-script"],type:"booleanOrString",usageLabel:"--save-script [path]",usageDescription:"Save session script (.ad) on close; optional custom output path"},{key:"networkInclude",names:["--include"],type:"enum",enumValues:["summary","headers","body","all"],usageLabel:"--include summary|headers|body|all",usageDescription:"Network: include headers, bodies, or both in output"},{key:"shutdown",names:["--shutdown"],type:"boolean",usageLabel:"--shutdown",usageDescription:"close: shutdown associated iOS simulator after ending session"},{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:"retainPaths",names:["--retain-paths"],type:"boolean",usageLabel:"--retain-paths",usageDescription:"install-from-source: keep materialized artifact paths after install"},{key:"retentionMs",names:["--retention-ms"],type:"int",min:1,usageLabel:"--retention-ms <ms>",usageDescription:"install-from-source: retention TTL for materialized artifact paths"},{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:"failFast",names:["--fail-fast"],type:"boolean",usageLabel:"--fail-fast",usageDescription:"Test: stop the suite after the first failing script"},{key:"timeoutMs",names:["--timeout"],type:"int",min:1,usageLabel:"--timeout <ms>",usageDescription:"Test: maximum wall-clock time per script attempt"},{key:"retries",names:["--retries"],type:"int",min:0,max:3,usageLabel:"--retries <n>",usageDescription:"Test: retry each failed script up to n additional times"},{key:"artifactsDir",names:["--artifacts-dir"],type:"string",usageLabel:"--artifacts-dir <path>",usageDescription:"Test: root directory for suite artifacts"},{key:"reportJunit",names:["--report-junit"],type:"string",usageLabel:"--report-junit <path>",usageDescription:"Test: write a JUnit XML report for the replay suite"},{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:"findFirst",names:["--first"],type:"boolean",usageLabel:"--first",usageDescription:"Find: pick the first match when ambiguous"},{key:"findLast",names:["--last"],type:"boolean",usageLabel:"--last",usageDescription:"Find: pick the last match when ambiguous"},{key:"out",names:["--out"],type:"string",usageLabel:"--out <path>",usageDescription:"Output path"},{key:"overlayRefs",names:["--overlay-refs"],type:"boolean",usageLabel:"--overlay-refs",usageDescription:"Screenshot: draw current snapshot refs and target rectangles onto the saved PNG; diff screenshot: also write a separate current-screen overlay guide"},{key:"screenshotFullscreen",names:["--fullscreen"],type:"boolean",usageLabel:"--fullscreen",usageDescription:"Screenshot: capture the full screen instead of the app window"},{key:"baseline",names:["--baseline","-b"],type:"string",usageLabel:"--baseline, -b <path>",usageDescription:"Diff screenshot: path to baseline image file"},{key:"threshold",names:["--threshold"],type:"string",usageLabel:"--threshold <0-1>",usageDescription:"Diff screenshot: color distance threshold (default 0.1)"}],eM=new Set(["json","config","remoteConfig","stateDir","daemonBaseUrl","daemonAuthToken","daemonTransport","daemonServerMode","tenant","sessionIsolation","runId","leaseId","leaseBackend","sessionLock","sessionLocked","sessionLockConflicts","help","version","verbose","platform","target","device","udid","serial","iosSimulatorDeviceSet","androidDeviceAllowlist","session","noRecord"]),eR={boot:{helpDescription:"Ensure target device/simulator is booted and ready",summary:"Boot target device/simulator",positionalArgs:[],allowedFlags:["headless"]},open:{helpDescription:"Boot device/simulator; optionally launch app or deep link URL (macOS also supports --surface app|frontmost-app|desktop|menubar)",summary:"Open an app, deep link or URL, save replays",positionalArgs:["appOrUrl?","url?"],allowedFlags:["activity","saveScript","relaunch","surface"]},connect:{usageOverride:"connect --remote-config <path> [--tenant <id>] [--run-id <id>] [--lease-backend <backend>] [--force]",helpDescription:"Connect to a remote daemon and save remote session state",summary:"Connect to remote daemon",positionalArgs:[],allowedFlags:["force","metroProjectRoot","metroKind","metroPublicBaseUrl","metroProxyBaseUrl","metroBearerToken","metroPreparePort","metroListenHost","metroStatusHost","metroStartupTimeoutMs","metroProbeTimeoutMs","metroRuntimeFile","metroNoReuseExisting","metroNoInstallDeps","launchUrl"],skipCapabilityCheck:!0},disconnect:{helpDescription:"Disconnect remote daemon state, stop owned Metro companion, and release lease",summary:"Disconnect remote daemon",positionalArgs:[],allowedFlags:["shutdown"],skipCapabilityCheck:!0},connection:{usageOverride:"connection status",listUsageOverride:"connection status",helpDescription:"Inspect active remote connection state",summary:"Inspect remote connection",positionalArgs:["status"],allowedFlags:[],skipCapabilityCheck:!0},close:{helpDescription:"Close app or just end session",summary:"Close app or end session",positionalArgs:["app?"],allowedFlags:["saveScript","shutdown"]},reinstall:{helpDescription:"Uninstall + install app from binary path",summary:"Reinstall app from binary path",positionalArgs:["app","path"],allowedFlags:[]},install:{helpDescription:"Install app from binary path without uninstalling first",summary:"Install app from binary path",positionalArgs:["app","path"],allowedFlags:[]},"install-from-source":{helpDescription:"Install app from a URL source through the normal daemon artifact flow",summary:"Install app from a URL source",positionalArgs:["url"],allowedFlags:["header","retainPaths","retentionMs"]},push:{helpDescription:"Simulate push notification payload delivery",summary:"Deliver push payload",positionalArgs:["bundleOrPackage","payloadOrJson"],allowedFlags:[]},snapshot:{usageOverride:"snapshot [--diff] [-i] [-c] [-d <depth>] [-s <scope>] [--raw]",helpDescription:"Capture accessibility tree or diff against the previous session baseline",positionalArgs:[],allowedFlags:["snapshotDiff",...eL]},diff:{usageOverride:"diff snapshot | diff screenshot --baseline <path> [current.png] [--out <diff.png>] [--threshold <0-1>] [--overlay-refs]",helpDescription:"Diff accessibility snapshot or compare screenshots pixel-by-pixel",summary:"Diff snapshot or screenshot",positionalArgs:["kind","current?"],allowedFlags:[...eL,"baseline","threshold","out","overlayRefs"]},"ensure-simulator":{helpDescription:"Ensure an iOS simulator exists in a device set (create if missing)",summary:"Ensure iOS simulator exists",positionalArgs:[],allowedFlags:["runtime","boot","reuseExisting"],skipCapabilityCheck:!0},devices:{helpDescription:"List available devices",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},apps:{helpDescription:"List installed apps (includes default/system apps by default)",summary:"List installed apps",positionalArgs:[],allowedFlags:["appsFilter"],defaults:{appsFilter:"all"}},appstate:{helpDescription:"Show foreground app/activity",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},metro:{usageOverride:"metro prepare --public-base-url <url> [--project-root <path>] [--port <port>] [--kind auto|react-native|expo]",listUsageOverride:"metro prepare --public-base-url <url>",helpDescription:"Prepare a local Metro runtime and optionally bridge it through a remote host",summary:"Prepare local Metro runtime",positionalArgs:["prepare"],allowedFlags:["metroProjectRoot","metroKind","metroPublicBaseUrl","metroProxyBaseUrl","metroBearerToken","metroPreparePort","metroListenHost","metroStatusHost","metroStartupTimeoutMs","metroProbeTimeoutMs","metroRuntimeFile","metroNoReuseExisting","metroNoInstallDeps"],skipCapabilityCheck:!0},clipboard:{usageOverride:"clipboard read | clipboard write <text>",listUsageOverride:"clipboard read | clipboard write <text>",helpDescription:"Read or write device clipboard text",positionalArgs:["read|write","text?"],allowsExtraPositionals:!0,allowedFlags:[]},keyboard:{usageOverride:"keyboard [status|get|dismiss]",helpDescription:"Inspect Android keyboard visibility/type or dismiss the device keyboard",summary:"Inspect or dismiss the device keyboard",positionalArgs:["action?"],allowedFlags:[]},perf:{helpDescription:"Show session performance metrics",summary:"Show performance metrics",positionalArgs:[],allowedFlags:[]},back:{usageOverride:"back [--in-app|--system]",helpDescription:"Navigate back with explicit app or system semantics",summary:"Go back",positionalArgs:[],allowedFlags:["backMode"]},home:{helpDescription:"Go to home screen (where supported)",summary:"Go home",positionalArgs:[],allowedFlags:[]},rotate:{usageOverride:"rotate <portrait|portrait-upside-down|landscape-left|landscape-right>",helpDescription:"Rotate device orientation on iOS and Android",summary:"Rotate device orientation",positionalArgs:["orientation"],allowedFlags:[]},"app-switcher":{helpDescription:"Open app switcher (where supported)",summary:"Open app switcher",positionalArgs:[],allowedFlags:[]},wait:{usageOverride:"wait <ms>|text <text>|@ref|<selector> [timeoutMs]",helpDescription:"Wait for duration, text, ref, or selector to appear",summary:"Wait for time, text, ref, or selector",positionalArgs:["durationOrSelector","timeoutMs?"],allowsExtraPositionals:!0,allowedFlags:[...e_]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",helpDescription:"Inspect or handle alert (iOS simulator and macOS desktop)",summary:"Inspect or handle iOS/macOS alerts",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <x y|@ref|selector>",helpDescription:"Tap/click by coordinates, snapshot ref, or selector",summary:"Tap by coordinates, ref, or selector",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap","clickButton",...e_]},get:{usageOverride:"get text|attrs <@ref|selector>",helpDescription:"Return element text/attributes by ref or selector",summary:"Get text or attrs by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...e_]},replay:{helpDescription:"Replay a recorded session",positionalArgs:["path"],allowedFlags:["replayUpdate"],skipCapabilityCheck:!0},test:{usageOverride:"test <path-or-glob>...",listUsageOverride:"test <path-or-glob>...",helpDescription:"Run one or more .ad scripts as a serial test suite",summary:"Run .ad test suites",positionalArgs:["pathOrGlob"],allowsExtraPositionals:!0,allowedFlags:["replayUpdate","failFast","timeoutMs","retries","artifactsDir","reportJunit"],skipCapabilityCheck:!0},batch:{usageOverride:"batch [--steps <json> | --steps-file <path>]",listUsageOverride:"batch --steps <json> | --steps-file <path>",helpDescription:"Execute multiple commands in one daemon request",summary:"Run multiple commands",positionalArgs:[],allowedFlags:["steps","stepsFile","batchOnError","batchMaxSteps","out"],skipCapabilityCheck:!0},press:{usageOverride:"press <x y|@ref|selector>",helpDescription:"Tap/press by coordinates, snapshot ref, or selector (supports repeated series)",summary:"Press by coordinates, ref, or selector",positionalArgs:["targetOrX","y?"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...e_]},longpress:{helpDescription:"Long press by coordinates (iOS and Android)",summary:"Long press by coordinates",positionalArgs:["x","y","durationMs?"],allowedFlags:[]},swipe:{helpDescription:"Swipe coordinates with optional repeat pattern",summary:"Swipe coordinates",positionalArgs:["x1","y1","x2","y2","durationMs?"],allowedFlags:["count","pauseMs","pattern"]},focus:{helpDescription:"Focus input at coordinates",positionalArgs:["x","y"],allowedFlags:[]},type:{helpDescription:"Type text in focused field",positionalArgs:["text"],allowsExtraPositionals:!0,allowedFlags:["delayMs"]},fill:{usageOverride:"fill <x> <y> <text> | fill <@ref|selector> <text>",helpDescription:"Tap then type",positionalArgs:["targetOrX","yOrText","text?"],allowsExtraPositionals:!0,allowedFlags:[...e_,"delayMs"]},scroll:{usageOverride:"scroll <direction> [amount] [--pixels <n>]",helpDescription:"Scroll in direction (relative amount or explicit pixels)",summary:"Scroll in a direction",positionalArgs:["direction","amount?"],allowedFlags:["pixels"]},pinch:{helpDescription:"Pinch/zoom gesture (Apple simulator or macOS app session)",positionalArgs:["scale","x?","y?"],allowedFlags:[]},screenshot:{helpDescription:"Capture screenshot (macOS app sessions default to the app window; use --fullscreen for full desktop, or --overlay-refs to annotate the image with current refs)",positionalArgs:["path?"],allowedFlags:["out","overlayRefs","screenshotFullscreen"]},"trigger-app-event":{usageOverride:"trigger-app-event <event> [payloadJson]",helpDescription:"Trigger app-defined event hook via deep link template",summary:"Trigger app event hook",positionalArgs:["event","payloadJson?"],allowedFlags:[]},record:{usageOverride:"record start [path] [--fps <n>] [--quality <5-10>] [--hide-touches] | record stop",listUsageOverride:"record start [path] | record stop",helpDescription:"Start/stop screen recording",summary:"Start or stop screen recording",positionalArgs:["start|stop","path?"],allowedFlags:["fps","quality","hideTouches"]},trace:{usageOverride:"trace start [path] | trace stop [path]",listUsageOverride:"trace start [path] | trace stop",helpDescription:"Start/stop trace log capture",summary:"Start or stop trace capture",positionalArgs:["start|stop","path?"],allowedFlags:[],skipCapabilityCheck:!0},logs:{usageOverride:"logs path | logs start | logs stop | logs clear [--restart] | logs doctor | logs mark [message...]",helpDescription:"Session app log info, start/stop streaming, diagnostics, and markers",summary:"Manage session app logs",positionalArgs:["path|start|stop|clear|doctor|mark","message?"],allowsExtraPositionals:!0,allowedFlags:["restart"]},network:{usageOverride:"network dump [limit] [summary|headers|body|all] [--include summary|headers|body|all] | network log [limit] [summary|headers|body|all] [--include summary|headers|body|all]",helpDescription:"Dump recent HTTP(s) traffic parsed from the session app log",summary:"Show recent HTTP traffic",positionalArgs:["dump|log","limit?","include?"],allowedFlags:["networkInclude"]},find:{usageOverride:"find <locator|text> <action> [value] [--first|--last]",helpDescription:"Find by text/label/value/role/id and run action",summary:"Find an element and act",positionalArgs:["query","action","value?"],allowsExtraPositionals:!0,allowedFlags:["snapshotDepth","snapshotRaw","findFirst","findLast"]},is:{helpDescription:"Assert UI state (visible|hidden|exists|editable|selected|text)",summary:"Assert UI state",positionalArgs:["predicate","selector","value?"],allowsExtraPositionals:!0,allowedFlags:[...e_]},settings:{usageOverride:ee,listUsageOverride:"settings [area] [options]",helpDescription:"Toggle OS settings, appearance, and app permissions (macOS supports only settings appearance <light|dark|toggle> and settings permission <grant|reset> <accessibility|screen-recording|input-monitoring>; wifi|airplane|location remain unsupported on macOS; mobile permission actions use the active session app)",summary:"Change OS settings and app permissions",positionalArgs:["setting","state","target?","mode?"],allowedFlags:[]},session:{usageOverride:"session list",helpDescription:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},eT=new Map,eC=new Map;for(let e of eE){for(let t of e.names)eT.set(t,e);let t=eC.get(e.key);t?t.push(e):eC.set(e.key,[e])}function eO(e){if(e)return eR[e]}function eU(){return Object.keys(eR)}function eF(e){let t=e.endsWith("?"),r=t?e.slice(0,-1):e;return t?`[${r}]`:`<${r}>`}let ej=(e=`agent-device <command> [args] [--json]
1
+ let e,t,s,r,o,n,a;import i from"node:path";import{styleText as l}from"node:util";import{pathToFileURL as c}from"node:url";import u from"node:fs";import p from"node:crypto";import{isEnvTruthy as d,SESSION_SURFACES as m,parseDeviceRotation as f,SETTINGS_USAGE_OVERRIDE as g,parseBatchStepsJson as h,parseWaitArgs as y}from"./3918.js";import{resolveRemoteConfigProfile as w,resolveRemoteConfigPath as b,REMOTE_CONFIG_FIELD_SPECS as v,parseSourceValue as k,buildPrimaryEnvVarName as D}from"./remote-config.js";import{asAppError as $,normalizeError as S,AppError as I}from"./9152.js";import{buildMobileSnapshotPresentation as A,formatSnapshotLine as x,displayNodeLabel as L,readCommandMessage as R,buildSnapshotDisplayLines as N}from"./9076.js";import{createRequestId as C,serializeSessionListEntry as _,serializeSnapshotResult as P,serializeCloseResult as O,readVersion as M,getDiagnosticsMeta as E,emitDiagnostic as F,serializeOpenResult as j,serializeDeployResult as T,resolveDaemonPaths as V,withDiagnosticsScope as B,createAgentDevice as U,flushDiagnosticsToSessionFile as G,serializeEnsureSimulatorResult as q,serializeInstallFromSourceResult as H,serializeDevice as K,localCommandPolicy as J}from"./8564.js";import{stopMetroTunnel as z}from"./metro.js";import{resolveUserPath as W,expandUserHomePath as X}from"./3267.js";import{createLocalArtifactAdapter as Y}from"./io.js";import{createAgentDeviceClient as Z,CLIENT_COMMANDS as Q,sendToDaemon as ee}from"./9542.js";import{splitSelectorFromArgs as et}from"./7847.js";import{maybeRunUpgradeNotifier as es}from"./113.js";function er(e,t){for(let[s,r]of Object.entries(t))void 0!==r&&(e[s]=r);return e}let eo=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],en=["snapshotDepth","snapshotScope","snapshotRaw"],ea=[{key:"config",names:["--config"],type:"string",usageLabel:"--config <path>",usageDescription:"Load CLI defaults from a specific config file"},{key:"remoteConfig",names:["--remote-config"],type:"string",usageLabel:"--remote-config <path>",usageDescription:"Load remote host + Metro workflow settings from a specific profile file"},{key:"stateDir",names:["--state-dir"],type:"string",usageLabel:"--state-dir <path>",usageDescription:"Daemon state directory (defaults to ~/.agent-device)"},{key:"daemonBaseUrl",names:["--daemon-base-url"],type:"string",usageLabel:"--daemon-base-url <url>",usageDescription:"Explicit remote HTTP daemon base URL (skip local daemon discovery/startup)"},{key:"daemonAuthToken",names:["--daemon-auth-token"],type:"string",usageLabel:"--daemon-auth-token <token>",usageDescription:"Remote HTTP daemon auth token (sent as request token and bearer header)"},{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:"leaseBackend",names:["--lease-backend"],type:"enum",enumValues:["ios-simulator","ios-instance","android-instance"],usageLabel:"--lease-backend ios-simulator|ios-instance|android-instance",usageDescription:"Lease backend for remote tenant connection admission"},{key:"force",names:["--force"],type:"boolean",usageLabel:"--force",usageDescription:"Force connection state replacement when reconnecting"},{key:"sessionLock",names:["--session-lock"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock reject|strip",usageDescription:"Lock bound-session device routing for this CLI invocation and nested batch steps"},{key:"sessionLocked",names:["--session-locked"],type:"boolean",usageLabel:"--session-locked",usageDescription:"Deprecated alias for --session-lock reject"},{key:"sessionLockConflicts",names:["--session-lock-conflicts"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock-conflicts reject|strip",usageDescription:"Deprecated alias for --session-lock"},{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","macos","android","linux","apple"],usageLabel:"--platform ios|macos|android|linux|apple",usageDescription:"Platform to target (`apple` aliases the Apple automation backend)"},{key:"target",names:["--target"],type:"enum",enumValues:["mobile","tv","desktop"],usageLabel:"--target mobile|tv|desktop",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:"surface",names:["--surface"],type:"enum",enumValues:m,usageLabel:"--surface app|frontmost-app|desktop|menubar",usageDescription:"macOS session surface for open (defaults to app)"},{key:"headless",names:["--headless"],type:"boolean",usageLabel:"--headless",usageDescription:"Boot: launch Android emulator without a GUI window"},{key:"runtime",names:["--runtime"],type:"string",usageLabel:"--runtime <id>",usageDescription:"ensure-simulator: CoreSimulator runtime identifier (e.g. com.apple.CoreSimulator.SimRuntime.iOS-18-0)"},{key:"metroHost",names:["--metro-host"],type:"string",usageLabel:"--metro-host <host>",usageDescription:"Session-scoped Metro/debug host hint"},{key:"metroPort",names:["--metro-port"],type:"int",min:1,max:65535,usageLabel:"--metro-port <port>",usageDescription:"Session-scoped Metro/debug port hint"},{key:"metroProjectRoot",names:["--project-root"],type:"string",usageLabel:"--project-root <path>",usageDescription:"metro prepare: React Native project root (default: cwd)"},{key:"metroKind",names:["--kind"],type:"enum",enumValues:["auto","react-native","expo"],usageLabel:"--kind auto|react-native|expo",usageDescription:"metro prepare: detect or force the Metro launcher kind"},{key:"metroPublicBaseUrl",names:["--public-base-url"],type:"string",usageLabel:"--public-base-url <url>",usageDescription:"metro prepare: public base URL used for direct bundle hints"},{key:"metroProxyBaseUrl",names:["--proxy-base-url"],type:"string",usageLabel:"--proxy-base-url <url>",usageDescription:"metro prepare: optional bridge origin for remote Metro access"},{key:"metroBearerToken",names:["--bearer-token"],type:"string",usageLabel:"--bearer-token <token>",usageDescription:"metro prepare: host bridge bearer token (prefer AGENT_DEVICE_PROXY_TOKEN or AGENT_DEVICE_METRO_BEARER_TOKEN)"},{key:"metroPreparePort",names:["--port"],type:"int",min:1,max:65535,usageLabel:"--port <port>",usageDescription:"metro prepare: local Metro port (default: 8081)"},{key:"metroListenHost",names:["--listen-host"],type:"string",usageLabel:"--listen-host <host>",usageDescription:"metro prepare: host Metro listens on (default: 0.0.0.0)"},{key:"metroStatusHost",names:["--status-host"],type:"string",usageLabel:"--status-host <host>",usageDescription:"metro prepare: host used for local /status polling (default: 127.0.0.1)"},{key:"metroStartupTimeoutMs",names:["--startup-timeout-ms"],type:"int",min:1,usageLabel:"--startup-timeout-ms <ms>",usageDescription:"metro prepare: timeout while waiting for Metro to become ready"},{key:"metroProbeTimeoutMs",names:["--probe-timeout-ms"],type:"int",min:1,usageLabel:"--probe-timeout-ms <ms>",usageDescription:"metro prepare: timeout for /status and proxy bridge calls"},{key:"metroRuntimeFile",names:["--runtime-file"],type:"string",usageLabel:"--runtime-file <path>",usageDescription:"metro prepare: optional file path to persist the JSON result"},{key:"metroNoReuseExisting",names:["--no-reuse-existing"],type:"boolean",usageLabel:"--no-reuse-existing",usageDescription:"metro prepare: always start a fresh Metro process"},{key:"metroNoInstallDeps",names:["--no-install-deps"],type:"boolean",usageLabel:"--no-install-deps",usageDescription:"metro prepare: skip package-manager install when node_modules is missing"},{key:"bundleUrl",names:["--bundle-url"],type:"string",usageLabel:"--bundle-url <url>",usageDescription:"Session-scoped bundle URL hint"},{key:"launchUrl",names:["--launch-url"],type:"string",usageLabel:"--launch-url <url>",usageDescription:"Session-scoped deep link / launch URL hint"},{key:"boot",names:["--boot"],type:"boolean",usageLabel:"--boot",usageDescription:"ensure-simulator: boot the simulator after ensuring it exists"},{key:"reuseExisting",names:["--reuse-existing"],type:"boolean",usageLabel:"--reuse-existing",usageDescription:"ensure-simulator: reuse an existing simulator (default: true)"},{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:"header",names:["--header"],type:"string",multiple:!0,usageLabel:"--header <name:value>",usageDescription:"install-from-source: repeatable HTTP header for URL downloads"},{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:"quality",names:["--quality"],type:"int",min:5,max:10,usageLabel:"--quality <5-10>",usageDescription:"Record: scale recording resolution from 5 (50%) through 10 (native resolution)"},{key:"hideTouches",names:["--hide-touches"],type:"boolean",usageLabel:"--hide-touches",usageDescription:"Record: disable touch overlays in the final video"},{key:"intervalMs",names:["--interval-ms"],type:"int",min:0,max:1e4,usageLabel:"--interval-ms <ms>",usageDescription:"Delay between press iterations"},{key:"delayMs",names:["--delay-ms"],type:"int",min:0,max:1e4,usageLabel:"--delay-ms <ms>",usageDescription:"Delay between typed characters"},{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:"pixels",names:["--pixels"],type:"int",min:1,max:1e5,usageLabel:"--pixels <n>",usageDescription:"Scroll: explicit gesture distance in pixels"},{key:"doubleTap",names:["--double-tap"],type:"boolean",usageLabel:"--double-tap",usageDescription:"Use double-tap gesture per press iteration"},{key:"clickButton",names:["--button"],type:"enum",enumValues:["primary","secondary","middle"],usageLabel:"--button primary|secondary|middle",usageDescription:"Click: choose mouse button (middle reserved for future macOS support)"},{key:"backMode",names:["--in-app"],type:"enum",enumValues:["in-app","system"],setValue:"in-app",usageLabel:"--in-app",usageDescription:"Back: use app-provided back UI when available"},{key:"backMode",names:["--system"],type:"enum",enumValues:["in-app","system"],setValue:"system",usageLabel:"--system",usageDescription:"Back: use system back input or gesture when available"},{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:"snapshotDiff",names:["--diff"],type:"boolean",usageLabel:"--diff",usageDescription:"Snapshot: show structural diff against the previous session baseline"},{key:"saveScript",names:["--save-script"],type:"booleanOrString",usageLabel:"--save-script [path]",usageDescription:"Save session script (.ad) on close; optional custom output path"},{key:"networkInclude",names:["--include"],type:"enum",enumValues:["summary","headers","body","all"],usageLabel:"--include summary|headers|body|all",usageDescription:"Network: include headers, bodies, or both in output"},{key:"shutdown",names:["--shutdown"],type:"boolean",usageLabel:"--shutdown",usageDescription:"close: shutdown associated iOS simulator after ending session"},{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:"retainPaths",names:["--retain-paths"],type:"boolean",usageLabel:"--retain-paths",usageDescription:"install-from-source: keep materialized artifact paths after install"},{key:"retentionMs",names:["--retention-ms"],type:"int",min:1,usageLabel:"--retention-ms <ms>",usageDescription:"install-from-source: retention TTL for materialized artifact paths"},{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:"failFast",names:["--fail-fast"],type:"boolean",usageLabel:"--fail-fast",usageDescription:"Test: stop the suite after the first failing script"},{key:"timeoutMs",names:["--timeout"],type:"int",min:1,usageLabel:"--timeout <ms>",usageDescription:"Test: maximum wall-clock time per script attempt"},{key:"retries",names:["--retries"],type:"int",min:0,max:3,usageLabel:"--retries <n>",usageDescription:"Test: retry each failed script up to n additional times"},{key:"artifactsDir",names:["--artifacts-dir"],type:"string",usageLabel:"--artifacts-dir <path>",usageDescription:"Test: root directory for suite artifacts"},{key:"reportJunit",names:["--report-junit"],type:"string",usageLabel:"--report-junit <path>",usageDescription:"Test: write a JUnit XML report for the replay suite"},{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:"findFirst",names:["--first"],type:"boolean",usageLabel:"--first",usageDescription:"Find: pick the first match when ambiguous"},{key:"findLast",names:["--last"],type:"boolean",usageLabel:"--last",usageDescription:"Find: pick the last match when ambiguous"},{key:"out",names:["--out"],type:"string",usageLabel:"--out <path>",usageDescription:"Output path"},{key:"overlayRefs",names:["--overlay-refs"],type:"boolean",usageLabel:"--overlay-refs",usageDescription:"Screenshot: draw current snapshot refs and target rectangles onto the saved PNG; diff screenshot: also write a separate current-screen overlay guide"},{key:"screenshotFullscreen",names:["--fullscreen"],type:"boolean",usageLabel:"--fullscreen",usageDescription:"Screenshot: capture the full screen instead of the app window"},{key:"screenshotMaxSize",names:["--max-size"],type:"int",min:1,usageLabel:"--max-size <px>",usageDescription:"Screenshot: downscale so the longest edge is at most <px>"},{key:"baseline",names:["--baseline","-b"],type:"string",usageLabel:"--baseline, -b <path>",usageDescription:"Diff screenshot: path to baseline image file"},{key:"threshold",names:["--threshold"],type:"string",usageLabel:"--threshold <0-1>",usageDescription:"Diff screenshot: color distance threshold (default 0.1)"}],ei=new Set(["json","config","remoteConfig","stateDir","daemonBaseUrl","daemonAuthToken","daemonTransport","daemonServerMode","tenant","sessionIsolation","runId","leaseId","leaseBackend","sessionLock","sessionLocked","sessionLockConflicts","help","version","verbose","platform","target","device","udid","serial","iosSimulatorDeviceSet","androidDeviceAllowlist","session","noRecord"]),el={boot:{helpDescription:"Ensure target device/simulator is booted and ready",summary:"Boot target device/simulator",positionalArgs:[],allowedFlags:["headless"]},open:{helpDescription:"Boot device/simulator; optionally launch app or deep link URL (macOS also supports --surface app|frontmost-app|desktop|menubar)",summary:"Open an app, deep link or URL, save replays",positionalArgs:["appOrUrl?","url?"],allowedFlags:["activity","saveScript","relaunch","surface"]},connect:{usageOverride:"connect --remote-config <path> [--tenant <id>] [--run-id <id>] [--lease-backend <backend>] [--force]",helpDescription:"Connect to a remote daemon and save remote session state",summary:"Connect to remote daemon",positionalArgs:[],allowedFlags:["force","metroProjectRoot","metroKind","metroPublicBaseUrl","metroProxyBaseUrl","metroBearerToken","metroPreparePort","metroListenHost","metroStatusHost","metroStartupTimeoutMs","metroProbeTimeoutMs","metroRuntimeFile","metroNoReuseExisting","metroNoInstallDeps","launchUrl"],skipCapabilityCheck:!0},disconnect:{helpDescription:"Disconnect remote daemon state, stop owned Metro companion, and release lease",summary:"Disconnect remote daemon",positionalArgs:[],allowedFlags:["shutdown"],skipCapabilityCheck:!0},connection:{usageOverride:"connection status",listUsageOverride:"connection status",helpDescription:"Inspect active remote connection state",summary:"Inspect remote connection",positionalArgs:["status"],allowedFlags:[],skipCapabilityCheck:!0},close:{helpDescription:"Close app or just end session",summary:"Close app or end session",positionalArgs:["app?"],allowedFlags:["saveScript","shutdown"]},reinstall:{helpDescription:"Uninstall + install app from binary path",summary:"Reinstall app from binary path",positionalArgs:["app","path"],allowedFlags:[]},install:{helpDescription:"Install app from binary path without uninstalling first",summary:"Install app from binary path",positionalArgs:["app","path"],allowedFlags:[]},"install-from-source":{helpDescription:"Install app from a URL source through the normal daemon artifact flow",summary:"Install app from a URL source",positionalArgs:["url"],allowedFlags:["header","retainPaths","retentionMs"]},push:{helpDescription:"Simulate push notification payload delivery",summary:"Deliver push payload",positionalArgs:["bundleOrPackage","payloadOrJson"],allowedFlags:[]},snapshot:{usageOverride:"snapshot [--diff] [-i] [-c] [-d <depth>] [-s <scope>] [--raw]",helpDescription:"Capture accessibility tree or diff against the previous session baseline",positionalArgs:[],allowedFlags:["snapshotDiff",...eo]},diff:{usageOverride:"diff snapshot | diff screenshot --baseline <path> [current.png] [--out <diff.png>] [--threshold <0-1>] [--overlay-refs]",helpDescription:"Diff accessibility snapshot or compare screenshots pixel-by-pixel",summary:"Diff snapshot or screenshot",positionalArgs:["kind","current?"],allowedFlags:[...eo,"baseline","threshold","out","overlayRefs"]},"ensure-simulator":{helpDescription:"Ensure an iOS simulator exists in a device set (create if missing)",summary:"Ensure iOS simulator exists",positionalArgs:[],allowedFlags:["runtime","boot","reuseExisting"],skipCapabilityCheck:!0},devices:{helpDescription:"List available devices",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},apps:{helpDescription:"List installed apps (includes default/system apps by default)",summary:"List installed apps",positionalArgs:[],allowedFlags:["appsFilter"],defaults:{appsFilter:"all"}},appstate:{helpDescription:"Show foreground app/activity",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},metro:{usageOverride:"metro prepare (--public-base-url <url> | --proxy-base-url <url>) [--project-root <path>] [--port <port>] [--kind auto|react-native|expo]",listUsageOverride:"metro prepare --public-base-url <url> | --proxy-base-url <url>",helpDescription:"Prepare a local Metro runtime and optionally bridge it through a remote host",summary:"Prepare local Metro runtime",positionalArgs:["prepare"],allowedFlags:["metroProjectRoot","metroKind","metroPublicBaseUrl","metroProxyBaseUrl","metroBearerToken","metroPreparePort","metroListenHost","metroStatusHost","metroStartupTimeoutMs","metroProbeTimeoutMs","metroRuntimeFile","metroNoReuseExisting","metroNoInstallDeps"],skipCapabilityCheck:!0},clipboard:{usageOverride:"clipboard read | clipboard write <text>",listUsageOverride:"clipboard read | clipboard write <text>",helpDescription:"Read or write device clipboard text",positionalArgs:["read|write","text?"],allowsExtraPositionals:!0,allowedFlags:[]},keyboard:{usageOverride:"keyboard [status|get|dismiss]",helpDescription:"Inspect Android keyboard visibility/type or dismiss the device keyboard",summary:"Inspect or dismiss the device keyboard",positionalArgs:["action?"],allowedFlags:[]},perf:{helpDescription:"Show session performance metrics",summary:"Show performance metrics",positionalArgs:[],allowedFlags:[]},back:{usageOverride:"back [--in-app|--system]",helpDescription:"Navigate back with explicit app or system semantics",summary:"Go back",positionalArgs:[],allowedFlags:["backMode"]},home:{helpDescription:"Go to home screen (where supported)",summary:"Go home",positionalArgs:[],allowedFlags:[]},rotate:{usageOverride:"rotate <portrait|portrait-upside-down|landscape-left|landscape-right>",helpDescription:"Rotate device orientation on iOS and Android",summary:"Rotate device orientation",positionalArgs:["orientation"],allowedFlags:[]},"app-switcher":{helpDescription:"Open app switcher (where supported)",summary:"Open app switcher",positionalArgs:[],allowedFlags:[]},wait:{usageOverride:"wait <ms>|text <text>|@ref|<selector> [timeoutMs]",helpDescription:"Wait for duration, text, ref, or selector to appear",summary:"Wait for time, text, ref, or selector",positionalArgs:["durationOrSelector","timeoutMs?"],allowsExtraPositionals:!0,allowedFlags:[...en]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",helpDescription:"Inspect or handle alert (iOS simulator and macOS desktop)",summary:"Inspect or handle iOS/macOS alerts",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <x y|@ref|selector>",helpDescription:"Tap/click by coordinates, snapshot ref, or selector",summary:"Tap by coordinates, ref, or selector",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap","clickButton",...en]},get:{usageOverride:"get text|attrs <@ref|selector>",helpDescription:"Return element text/attributes by ref or selector",summary:"Get text or attrs by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...en]},replay:{helpDescription:"Replay a recorded session",positionalArgs:["path"],allowedFlags:["replayUpdate"],skipCapabilityCheck:!0},test:{usageOverride:"test <path-or-glob>...",listUsageOverride:"test <path-or-glob>...",helpDescription:"Run one or more .ad scripts as a serial test suite",summary:"Run .ad test suites",positionalArgs:["pathOrGlob"],allowsExtraPositionals:!0,allowedFlags:["replayUpdate","failFast","timeoutMs","retries","artifactsDir","reportJunit"],skipCapabilityCheck:!0},batch:{usageOverride:"batch [--steps <json> | --steps-file <path>]",listUsageOverride:"batch --steps <json> | --steps-file <path>",helpDescription:"Execute multiple commands in one daemon request",summary:"Run multiple commands",positionalArgs:[],allowedFlags:["steps","stepsFile","batchOnError","batchMaxSteps","out"],skipCapabilityCheck:!0},press:{usageOverride:"press <x y|@ref|selector>",helpDescription:"Tap/press by coordinates, snapshot ref, or selector (supports repeated series)",summary:"Press by coordinates, ref, or selector",positionalArgs:["targetOrX","y?"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...en]},longpress:{helpDescription:"Long press by coordinates (iOS and Android)",summary:"Long press by coordinates",positionalArgs:["x","y","durationMs?"],allowedFlags:[]},swipe:{helpDescription:"Swipe coordinates with optional repeat pattern",summary:"Swipe coordinates",positionalArgs:["x1","y1","x2","y2","durationMs?"],allowedFlags:["count","pauseMs","pattern"]},focus:{helpDescription:"Focus input at coordinates",positionalArgs:["x","y"],allowedFlags:[]},type:{helpDescription:"Type text in focused field",positionalArgs:["text"],allowsExtraPositionals:!0,allowedFlags:["delayMs"]},fill:{usageOverride:"fill <x> <y> <text> | fill <@ref|selector> <text>",helpDescription:"Tap then type",positionalArgs:["targetOrX","yOrText","text?"],allowsExtraPositionals:!0,allowedFlags:[...en,"delayMs"]},scroll:{usageOverride:"scroll <direction> [amount] [--pixels <n>]",helpDescription:"Scroll in direction (relative amount or explicit pixels)",summary:"Scroll in a direction",positionalArgs:["direction","amount?"],allowedFlags:["pixels"]},pinch:{helpDescription:"Pinch/zoom gesture (Apple simulator or macOS app session)",positionalArgs:["scale","x?","y?"],allowedFlags:[]},screenshot:{helpDescription:"Capture screenshot (macOS app sessions default to the app window; use --fullscreen for full desktop, --max-size to downscale, or --overlay-refs to annotate the image with current refs)",positionalArgs:["path?"],allowedFlags:["out","overlayRefs","screenshotFullscreen","screenshotMaxSize"]},"trigger-app-event":{usageOverride:"trigger-app-event <event> [payloadJson]",helpDescription:"Trigger app-defined event hook via deep link template",summary:"Trigger app event hook",positionalArgs:["event","payloadJson?"],allowedFlags:[]},record:{usageOverride:"record start [path] [--fps <n>] [--quality <5-10>] [--hide-touches] | record stop",listUsageOverride:"record start [path] | record stop",helpDescription:"Start/stop screen recording",summary:"Start or stop screen recording",positionalArgs:["start|stop","path?"],allowedFlags:["fps","quality","hideTouches"]},trace:{usageOverride:"trace start [path] | trace stop [path]",listUsageOverride:"trace start [path] | trace stop",helpDescription:"Start/stop trace log capture",summary:"Start or stop trace capture",positionalArgs:["start|stop","path?"],allowedFlags:[],skipCapabilityCheck:!0},logs:{usageOverride:"logs path | logs start | logs stop | logs clear [--restart] | logs doctor | logs mark [message...]",helpDescription:"Session app log info, start/stop streaming, diagnostics, and markers",summary:"Manage session app logs",positionalArgs:["path|start|stop|clear|doctor|mark","message?"],allowsExtraPositionals:!0,allowedFlags:["restart"]},network:{usageOverride:"network dump [limit] [summary|headers|body|all] [--include summary|headers|body|all] | network log [limit] [summary|headers|body|all] [--include summary|headers|body|all]",helpDescription:"Dump recent HTTP(s) traffic parsed from the session app log",summary:"Show recent HTTP traffic",positionalArgs:["dump|log","limit?","include?"],allowedFlags:["networkInclude"]},find:{usageOverride:"find <locator|text> <action> [value] [--first|--last]",helpDescription:"Find by text/label/value/role/id and run action",summary:"Find an element and act",positionalArgs:["query","action","value?"],allowsExtraPositionals:!0,allowedFlags:["snapshotDepth","snapshotRaw","findFirst","findLast"]},is:{helpDescription:"Assert UI state (visible|hidden|exists|editable|selected|text)",summary:"Assert UI state",positionalArgs:["predicate","selector","value?"],allowsExtraPositionals:!0,allowedFlags:[...en]},settings:{usageOverride:g,listUsageOverride:"settings [area] [options]",helpDescription:"Toggle OS settings, appearance, and app permissions (macOS supports only settings appearance <light|dark|toggle> and settings permission <grant|reset> <accessibility|screen-recording|input-monitoring>; wifi|airplane|location remain unsupported on macOS; mobile permission actions use the active session app)",summary:"Change OS settings and app permissions",positionalArgs:["setting","state","target?","mode?"],allowedFlags:[]},session:{usageOverride:"session list",helpDescription:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},ec=new Map,eu=new Map;for(let e of ea){for(let t of e.names)ec.set(t,e);let t=eu.get(e.key);t?t.push(e):eu.set(e.key,[e])}function ep(e){if(e)return el[e]}function ed(){return Object.keys(el)}function em(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}let ef=(e=`agent-device <command> [args] [--json]
2
2
 
3
3
  CLI to control iOS and Android devices for AI agents.
4
- `,t=eG("Commands:",eU().map(e=>{let t=eR[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:function(e,t){if(t.listUsageOverride)return t.listUsageOverride;let r=t.positionalArgs.map(r=>{var a,n,o;let s,i,l,c;return a=e,n=t,i=(s=(o=r).endsWith("?"))?o.slice(0,-1):o,c=(l=/^[a-z-]+(?:\|[a-z-]+)+$/i.test(i))||void 0!==n.usageOverride&&n.usageOverride.startsWith(`${a} ${i}`),s?l?`[${i}]`:c?i:`[${i}]`:c?i:`<${i}>`});return[e,...r].join(" ")}(e,t)}}).map(e=>({label:e.usage,description:e.schema.summary??e.schema.helpDescription}))),r=eV("Flags:",eB(eM)),a=[eG("Agent Skills:",[{label:"agent-device",description:"Canonical mobile automation flows"},{label:"dogfood",description:"Exploratory QA and bug hunts"}]),"See `skills/<name>/SKILL.md` in the installed package."].join("\n\n"),n=eq("Configuration:",["Default config files: ~/.agent-device/config.json, ./agent-device.json","Use --config <path> or AGENT_DEVICE_CONFIG to load one explicit config file."]),o=eG("Environment:",[{label:"AGENT_DEVICE_SESSION",description:"Default session name"},{label:"AGENT_DEVICE_PLATFORM",description:"Default platform binding"},{label:"AGENT_DEVICE_SESSION_LOCK",description:"Bound-session conflict mode"},{label:"AGENT_DEVICE_DAEMON_BASE_URL",description:"Connect to remote daemon"}]),s=eq("Examples:",["agent-device open Settings --platform ios","agent-device open TextEdit --platform macos","agent-device snapshot -i",'agent-device fill @e3 "test@example.com"',"agent-device replay ./session.ad","agent-device test ./suite --platform android"]),`${e}
4
+ `,t=ey("Commands:",ed().map(e=>{let t=el[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:function(e,t){if(t.listUsageOverride)return t.listUsageOverride;let s=t.positionalArgs.map(s=>{var r,o,n;let a,i,l,c;return r=e,o=t,i=(a=(n=s).endsWith("?"))?n.slice(0,-1):n,c=(l=/^[a-z-]+(?:\|[a-z-]+)+$/i.test(i))||void 0!==o.usageOverride&&o.usageOverride.startsWith(`${r} ${i}`),a?l?`[${i}]`:c?i:`[${i}]`:c?i:`<${i}>`});return[e,...s].join(" ")}(e,t)}}).map(e=>({label:e.usage,description:e.schema.summary??e.schema.helpDescription}))),s=eh("Flags:",eg(ei)),r=[ey("Agent Skills:",[{label:"agent-device",description:"Canonical mobile automation flows"},{label:"dogfood",description:"Exploratory QA and bug hunts"}]),"See `skills/<name>/SKILL.md` in the installed package."].join("\n\n"),o=ew("Configuration:",["Default config files: ~/.agent-device/config.json, ./agent-device.json","Use --config <path> or AGENT_DEVICE_CONFIG to load one explicit config file."]),n=ey("Environment:",[{label:"AGENT_DEVICE_SESSION",description:"Default session name"},{label:"AGENT_DEVICE_PLATFORM",description:"Default platform binding"},{label:"AGENT_DEVICE_SESSION_LOCK",description:"Bound-session conflict mode"},{label:"AGENT_DEVICE_DAEMON_BASE_URL",description:"Connect to remote daemon"}]),a=ew("Examples:",["agent-device open Settings --platform ios","agent-device open TextEdit --platform macos","agent-device snapshot -i",'agent-device fill @e3 "test@example.com"',"agent-device replay ./session.ad","agent-device test ./suite --platform android"]),`${e}
5
5
  ${t}
6
6
 
7
+ ${s}
8
+
7
9
  ${r}
8
10
 
9
- ${a}
11
+ ${o}
10
12
 
11
13
  ${n}
12
14
 
13
- ${o}
14
-
15
- ${s}
16
- `);function eB(e){return eE.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function eV(e,t){return eG(e,t.map(e=>({label:e.usageLabel??"",description:e.usageDescription??""})))}function eG(e,t){if(0===t.length)return`${e}
17
- (none)`;let r=Math.max(...t.map(e=>e.label.length))+2,a=[e];for(let e of t)a.push(` ${e.label.padEnd(r)}${e.description}`);return a.join("\n")}function eq(e,t){return 0===t.length?`${e}
18
- (none)`:[e,...t.map(e=>` ${e}`)].join("\n")}let eH=new Set(["1","true","yes","on"]),eK=new Set(["0","false","no","off"]);function eJ(e){return`AGENT_DEVICE_${e.replace(/([A-Z])/g,"_$1").replace(/[^A-Za-z0-9_]/g,"_").toUpperCase()}`}function ez(e,t,r,a){if(e.multiple)return(Array.isArray(t)?t:[t]).map(t=>ez({...e,multiple:!1},t,r,a));if("boolean"===e.type){var n=t,o=r,s=a;if("boolean"==typeof n)return n;if("string"==typeof n){let e=eW(n);if(void 0!==e)return e}throw new eg("INVALID_ARGS",`Invalid value for "${s}" in ${o}. Expected boolean.`)}if("booleanOrString"===e.type){if("boolean"==typeof t)return t;if("string"==typeof t&&void 0!==eW(t))return eW(t);if("string"==typeof t&&t.trim().length>0)return t;throw new eg("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Expected boolean or non-empty string.`)}if("string"===e.type){if("string"==typeof t&&t.trim().length>0)return t;throw new eg("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Expected non-empty string.`)}if("enum"===e.type){if(void 0!==e.setValue){var i=e,l=t,c=r,u=a;let n=i.setValue;if(l===n)return n;if("string"==typeof l){let e=l.trim();if(""===e||"true"===e||"1"===e)return n;if("false"===e||"0"===e)return}if(!0===l)return n;if(!1!==l)throw new eg("INVALID_ARGS",`Invalid value for "${u}" in ${c}. Expected boolean-like value for enum flag.`);return}if("string"!=typeof t||!e.enumValues?.includes(t))throw new eg("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Expected one of: ${e.enumValues?.join(", ")}.`);return t}let d="number"==typeof t?t:"string"==typeof t?Number(t):NaN;if(!Number.isFinite(d)||!Number.isInteger(d))throw new eg("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Expected integer.`);if("number"==typeof e.min&&d<e.min)throw new eg("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Must be >= ${e.min}.`);if("number"==typeof e.max&&d>e.max)throw new eg("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Must be <= ${e.max}.`);return d}function eW(e){let t=e.trim().toLowerCase();return!!eH.has(t)||!eK.has(t)&&void 0}let eX=new Set(["config","remoteConfig","help","version","batchSteps"]),eY={iosSimulatorDeviceSet:["IOS_SIMULATOR_DEVICE_SET"],androidDeviceAllowlist:["ANDROID_DEVICE_ALLOWLIST"],metroBearerToken:["AGENT_DEVICE_PROXY_TOKEN"]},eZ=function(){let e=new Map;for(let t of eE){let r=e.get(t.key);r?r.push(t):e.set(t.key,[t])}let t=new Map;for(let e of eM)t.set(e,new Set(["*"]));for(let e of eU()){let r=eO(e);if(r)for(let a of r.allowedFlags){let r=t.get(a);r&&r.has("*")||(r?r.add(e):t.set(a,new Set([e])))}}return[...e.entries()].map(([e,r])=>({key:e,flagDefinitions:r,config:{enabled:!eX.has(e),key:e},env:{names:[eJ(e),...eY[e]??[]]},supportsCommand(r){let a=t.get(e);return!!a&&(!!a.has("*")||!!r&&a.has(r))}})).sort((e,t)=>e.key.localeCompare(t.key))}(),eQ=new Map(eZ.map(e=>[e.key,e]));function e0(e,t){return eQ.get(e)?.supportsCommand(t)??!1}function e1(e){let t=e.flagDefinitions.find(e=>void 0===e.setValue);if(t)return t;let r=function(e){let t=e.flagDefinitions[0];if(!t)throw Error(`Missing flag definition for option ${e.key}`);return t}(e);if("enum"===r.type){let t=e.flagDefinitions.map(e=>e.setValue).filter(e=>void 0!==e);return{...r,setValue:void 0,enumValues:t}}return r}function e2(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function e3(e){return e.replace(/^-+/,"")}function e5(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?e2(e):[e,void 0];return void 0!==eT.get(t)}function e8(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}function e4(e){process.stdout.write(`${JSON.stringify(e,null,2)}
19
- `)}function e6(e,t={}){let r=e instanceof eg?ef(e):e;process.stderr.write(`Error (${r.code}): ${r.message}
20
- `),r.hint&&process.stderr.write(`Hint: ${r.hint}
21
- `),r.diagnosticId&&process.stderr.write(`Diagnostic ID: ${r.diagnosticId}
22
- `),r.logPath&&process.stderr.write(`Diagnostics Log: ${r.logPath}
23
- `),t.showDetails&&r.details&&process.stderr.write(`${JSON.stringify(r.details,null,2)}
24
- `)}function e7(e){return`x=${e.x},y=${e.y},w=${e.width},h=${e.height}`}function e9(e){return e>0?`+${e}`:String(e)}function te(e){let t=e.nearestText?` near ${JSON.stringify(e.nearestText)}`:"",r=e.regionIndex?` r${e.regionIndex}`:"";return`${e.likelyKind}${t}${r}`}function tt(e){return e.min===e.max?e9(e.min):`${e9(e.min)}..${e9(e.max)}`}function tr(e){let t=process.cwd(),r=i.relative(t,e);return""!==r&&(r.startsWith("..")||i.isAbsolute(r))?e:""===r?".":`.${i.sep}${r}`}function ta(e){return"number"==typeof e&&Number.isFinite(e)?e:0}function tn(){let e=process.env.FORCE_COLOR;return"string"==typeof e?"0"!==e:"string"!=typeof process.env.NO_COLOR&&!!process.stdout.isTTY}function to(e,t){return t?l("dim",e):e}function ts(e){let t=e.warnings;return Array.isArray(t)?t.filter(e=>"string"==typeof e&&e.length>0):[]}function ti(e){var t;let r="scroll-area"===(t=e.type)||"list"===t||"collection"===t||"table"===t?t:null;if(!r)return[];let a=[];if(e.node.hiddenContentAbove&&a.push(`[content above ${r} hidden]`),e.node.hiddenContentBelow&&a.push(`[content below ${r} hidden]`),0===a.length)return[];let n=" ".repeat(e.depth+1);return a.map(e=>`${n}${e}`)}let tl="sha256";async function tc(e){let t=await tu(e.localPath,e.platform),r=e.baseUrl.endsWith("/")?e.baseUrl:`${e.baseUrl}/`;try{let a=await tf({normalizedBase:r,token:e.token,artifact:t});if(a?.kind==="cache-hit")return a.uploadId;if(a?.kind==="direct-upload")try{return await th(t.payloadPath,a),await ty({normalizedBase:r,token:e.token,uploadId:a.uploadId})}catch{}return await tm({normalizedBase:r,token:e.token,artifact:t})}finally{t.cleanup()}}async function tu(e,t){var r,a,n;let o,s=f.statSync(e),l=i.basename(e),c=s.isDirectory(),u=("ios"===(r=t)||"android"===r?r:void 0)??(a=e,n=s,o=a.toLowerCase(),n.isDirectory()&&o.endsWith(".app")||o.endsWith(".ipa")?"ios":o.endsWith(".apk")||o.endsWith(".aab")?"android":void 0),d=[];try{let t=c?await td(e,d):e,r=f.statSync(t);return{payloadPath:t,fileName:l,artifactType:c?"app-bundle":"file",platform:u,contentType:c?"application/gzip":"application/octet-stream",sha256:await tw(t),sizeBytes:r.size,cleanup:()=>tp(d)}}catch(e){throw tp(d),e}}async function td(e,t){let r=f.mkdtempSync(i.join(g.tmpdir(),`agent-device-upload-${b()}-`));t.push(r);let a=i.join(r,`${i.basename(e)}.tar.gz`);return await eh("tar",["czf",a,"-C",i.dirname(e),i.basename(e)]),a}function tp(e){for(let t of e)f.rmSync(t,{recursive:!0,force:!0})}async function tm(e){let{normalizedBase:t,token:r,artifact:a}=e,n=new URL("upload",t),o={"content-type":a.contentType,"x-artifact-type":a.artifactType,"x-artifact-filename":a.fileName,"x-artifact-hash":a.sha256,"x-artifact-hash-algorithm":tl,"transfer-encoding":"chunked"};r&&(o.authorization=`Bearer ${r}`,o["x-agent-device-token"]=r);let s=await tg({url:n,method:"POST",headers:o,payloadPath:a.payloadPath,timeoutMessage:"Artifact upload timed out",timeoutHint:"The upload to the remote daemon exceeded the 5-minute timeout.",errorMessage:"Failed to upload artifact to remote daemon",errorHint:"Verify the remote daemon is reachable and supports artifact uploads."});try{let e=JSON.parse(s.body);if(!e.ok||!e.uploadId)throw new eg("COMMAND_FAILED",`Upload failed: ${s.body}`);return e.uploadId}catch(e){if(e instanceof eg)throw e;throw new eg("COMMAND_FAILED",`Invalid upload response: ${s.body}`)}}async function tf(e){let t=new URL("upload/preflight",e.normalizedBase),r={"content-type":"application/json"};e.token&&(r.authorization=`Bearer ${e.token}`,r["x-agent-device-token"]=e.token);let a=await fetch(t,{method:"POST",headers:r,signal:AbortSignal.timeout(3e4),body:JSON.stringify({sha256:e.artifact.sha256,fileName:e.artifact.fileName,sizeBytes:e.artifact.sizeBytes,artifactType:e.artifact.artifactType,...e.artifact.platform?{platform:e.artifact.platform}:{},contentType:e.artifact.contentType})}).catch(()=>void 0);if(a?.ok)return function(e){var t;if(!e||"object"!=typeof e||!0!==e.ok||"string"!=typeof e.uploadId)return;if(!0===e.cacheHit)return{kind:"cache-hit",uploadId:e.uploadId};let r=e.upload;if(!r||"string"!=typeof r.url)return;let a=r.headers??{};if(!(!(t=a)||"object"!=typeof t||Array.isArray(t))&&Object.values(t).every(e=>"string"==typeof e))return{kind:"direct-upload",uploadId:e.uploadId,url:r.url,headers:a}}(await a.json().catch(()=>void 0))}async function th(e,t){let r=await tg({url:new URL(t.url),method:"PUT",headers:t.headers,payloadPath:e,timeoutMessage:"Direct artifact upload timed out",timeoutHint:"The direct upload ticket did not accept the artifact within the timeout.",errorMessage:"Failed to upload artifact with direct upload ticket"});if(r.statusCode<200||r.statusCode>=300)throw new eg("COMMAND_FAILED","Direct artifact upload failed",{statusCode:r.statusCode,statusMessage:r.statusMessage})}async function tg(e){let t="https:"===e.url.protocol?m:p;return await new Promise((r,a)=>{let n=t.request({protocol:e.url.protocol,host:e.url.hostname,port:e.url.port,method:e.method,path:e.url.pathname+e.url.search,headers:e.headers},e=>{let t="";e.setEncoding("utf8"),e.on("data",e=>{t+=e}),e.on("end",()=>{clearTimeout(o),r({statusCode:e.statusCode??500,statusMessage:e.statusMessage,body:t})})}),o=setTimeout(()=>{n.destroy(),a(new eg("COMMAND_FAILED",e.timeoutMessage,{timeoutMs:3e5,...e.timeoutHint?{hint:e.timeoutHint}:{}}))},3e5);n.on("error",t=>{clearTimeout(o),a(new eg("COMMAND_FAILED",e.errorMessage,e.errorHint?{hint:e.errorHint}:{},t))}),n.on("close",()=>clearTimeout(o));let s=f.createReadStream(e.payloadPath);s.pipe(n),s.on("error",e=>{n.destroy(),a(new eg("COMMAND_FAILED","Failed to read local artifact",{},e))})})}async function ty(e){let t=new URL("upload/finalize",e.normalizedBase),r={"content-type":"application/json"};e.token&&(r.authorization=`Bearer ${e.token}`,r["x-agent-device-token"]=e.token);let a=await fetch(t,{method:"POST",headers:r,signal:AbortSignal.timeout(3e4),body:JSON.stringify({uploadId:e.uploadId})}).catch(e=>{throw new eg("COMMAND_FAILED","Failed to finalize direct artifact upload",{},e)});if(!a.ok)throw new eg("COMMAND_FAILED","Direct artifact upload finalize failed",{status:a.status,statusText:a.statusText});let n=await a.json().catch(()=>void 0);if(!n?.ok||!n.uploadId)throw new eg("COMMAND_FAILED","Invalid upload finalize response");return n.uploadId}async function tw(e){let t=w(tl);return await new Promise((r,a)=>{f.createReadStream(e).on("data",e=>t.update(e)).on("error",e=>{a(new eg("COMMAND_FAILED","Failed to read local artifact",{},e))}).on("end",r)}),t.digest("hex")}let tb=tQ(),tv=function(e=process.env.AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS){if(!e)return 15e3;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):15e3}(),tI=function(e=process.env.AGENT_DEVICE_DAEMON_STARTUP_ATTEMPTS){if(!e)return 2;let t=Number(e);return Number.isFinite(t)?Math.min(5,Math.max(1,Math.floor(t))):2}(),tk=["xcodebuild .*AgentDeviceRunnerUITests/RunnerTests/testCommand","xcodebuild .*AgentDeviceRunner\\.env\\.session-","xcodebuild build-for-testing .*ios-runner/AgentDeviceRunner/AgentDeviceRunner\\.xcodeproj"],tA=new d.BlockList;async function tS(e){let t=e.meta?.requestId??q(),r=!!(e.meta?.debug||e.flags?.verbose),a=function(e){let t,r=e.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR,a=function(e){let t;if(e){try{t=new URL(e)}catch(t){throw new eg("INVALID_ARGS","Invalid daemon base URL",{daemonBaseUrl:e},t instanceof Error?t:void 0)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new eg("INVALID_ARGS","Daemon base URL must use http or https",{daemonBaseUrl:e});return t.toString().replace(/\/+$/,"")}}(e.flags?.daemonBaseUrl??process.env.AGENT_DEVICE_DAEMON_BASE_URL),n=e.flags?.daemonAuthToken??process.env.AGENT_DEVICE_DAEMON_AUTH_TOKEN;var o=a,s=n;if(!(!o||"localhost"===(t=new URL(o).hostname.trim().toLowerCase().replace(/^\[(.*)\]$/,"$1"))||(d.isIPv4(t)?tA.check(t,"ipv4"):!!d.isIPv6(t)&&tA.check(t,"ipv6")))&&("string"!=typeof s||!(s.trim().length>0)))throw new eg("INVALID_ARGS","Remote daemon base URL for non-loopback hosts requires daemon authentication",{daemonBaseUrl:o,hint:"Provide --daemon-auth-token or AGENT_DEVICE_DAEMON_AUTH_TOKEN when using a non-loopback remote daemon URL."});let i=e.flags?.daemonTransport??process.env.AGENT_DEVICE_DAEMON_TRANSPORT,l=E(i);if(a&&"socket"===l)throw new eg("INVALID_ARGS","Remote daemon base URL only supports HTTP transport. Remove --daemon-transport socket.",{daemonBaseUrl:a});let c=es(e.flags?.daemonServerMode??process.env.AGENT_DEVICE_DAEMON_SERVER_MODE??("dual"===i?"dual":void 0));return{paths:en(r),transportPreference:l,serverMode:c,remoteBaseUrl:a,remoteAuthToken:n}}(e),n=function(e,t=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS){if("test"!==e)return tQ(t)}(e.command),o=await X("daemon_startup",async()=>await tP(a),{requestId:t,session:e.session}),s=await tD(e,o),i={...e,positionals:s.positionals,flags:s.flags,token:o.token,meta:{...e.meta??{},requestId:t,debug:r,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,lockPolicy:e.meta?.lockPolicy,lockPlatform:e.meta?.lockPlatform,...s.uploadedArtifactId?{uploadedArtifactId:s.uploadedArtifactId}:{},...s.clientArtifactPaths?{clientArtifactPaths:s.clientArtifactPaths}:{},...s.installSource?{installSource:s.installSource}:{}}};return Q({level:"info",phase:"daemon_request_prepare",data:{requestId:t,command:e.command,session:e.session}}),await X("daemon_request",async()=>await tV(o,i,a.transportPreference,n),{requestId:t,command:e.command})}async function tD(e,t){let r,a=[...e.positionals??[]],n=e.flags?{...e.flags}:void 0,o=e.meta?.installSource,s={};if(tW(t)){let l=function(e,t){if("screenshot"===e.command){let r=tx(e,"path",".png");return t[0]?{field:"path",localPath:r,positionalIndex:0,positionalPath:tN("screenshot",".png")}:{field:"path",localPath:r,positionalIndex:0,flagPath:tN("screenshot",".png")}}if("record"===e.command&&"start"===(t[0]??"").toLowerCase()){let t=tx(e,"outPath",".mp4",1);return{field:"outPath",localPath:t,positionalIndex:1,positionalPath:tN("recording",i.extname(t)||".mp4")}}return null}(e,a);l&&(void 0!==l.positionalPath&&(a[l.positionalIndex]=l.positionalPath),void 0!==l.flagPath&&((n??={}).out=l.flagPath),s[l.field]=l.localPath);let c=await t$(e,t);c&&(o=c.installSource,r=c.uploadedArtifactId??r)}if(!tW(t)||"install"!==e.command&&"reinstall"!==e.command||a.length<2)return{positionals:a,flags:n,installSource:o,uploadedArtifactId:r,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}};let l=a[1];if(l.startsWith("remote:"))return a[1]=l.slice(7),{positionals:a,flags:n,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}};let c=i.isAbsolute(l)?l:i.resolve(e.meta?.cwd??process.cwd(),l);return f.existsSync(c)?{positionals:a,flags:n,installSource:o,uploadedArtifactId:r=await tc({localPath:c,baseUrl:t.baseUrl,token:t.token,platform:e.flags?.platform}),...Object.keys(s).length>0?{clientArtifactPaths:s}:{}}:{positionals:a,flags:n,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}}}async function t$(e,t){let r=e.meta?.installSource;if("install_source"!==e.command||!r||"path"!==r.kind)return null;let a=r.path.trim();if(!a)return{installSource:r};if(a.startsWith("remote:"))return{installSource:{...r,path:a.slice(7)}};let n=i.isAbsolute(a)?a:i.resolve(e.meta?.cwd??process.cwd(),a);if(!f.existsSync(n))return{installSource:{...r,path:n}};let o=await tc({localPath:n,baseUrl:t.baseUrl,token:t.token,platform:e.flags?.platform});return{installSource:{...r,path:n},uploadedArtifactId:o}}function tx(e,t,r,a=0){let n=e.positionals?.[a]??e.flags?.out,o=`${"path"===t?"screenshot":"recording"}-${Date.now()}${r}`,s=n&&n.trim().length>0?n:o;return i.isAbsolute(s)?s:i.resolve(e.meta?.cwd??process.cwd(),s)}function tN(e,t){let r=t.startsWith(".")?t:`.${t}`;return i.posix.join("/tmp",`agent-device-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}${r}`)}async function tP(e){let t;if(e.remoteBaseUrl){let t={transport:"http",token:e.remoteAuthToken??"",pid:0,baseUrl:e.remoteBaseUrl};if(await tF(t,"http"))return t;throw new eg("COMMAND_FAILED","Remote daemon is unavailable",{daemonBaseUrl:e.remoteBaseUrl,hint:"Verify AGENT_DEVICE_DAEMON_BASE_URL points to a reachable daemon with GET /health and POST /rpc."})}let r=tR(e.paths.infoPath),a=K(),n=_((t=tB()).useSrc?t.srcPath:t.distPath,t.root),o=!!r&&await tF(r,e.transportPreference);if(r&&r.version===a&&r.codeSignature===n&&o)return r;r&&(r.version!==a||r.codeSignature!==n||!o)&&(await tM(r),tU(e.paths.infoPath)),function(e){let t=tC(e);if(!t.hasLock||t.hasInfo)return;let r=tT(e.lockPath);if(!r)return tU(e.lockPath);$(r.pid,r.processStartTime)||tU(e.lockPath)}(e.paths);let s=0;for(let t=1;t<=tI;t+=1){await tj(e);let r=await tL(tv,e);if(r)return r;if(await tE(e.paths)){s+=1;continue}let a=tC(e.paths);if(!(t<tI))break;if(!a.hasInfo&&!a.hasLock){await t_(150);continue}}let i=tC(e.paths);throw new eg("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:e.paths.infoPath,lockPath:e.paths.lockPath,startupTimeoutMs:tv,startupAttempts:tI,lockRecoveryCount:s,metadataState:i,hint:function(e,t=en(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.`}(i,e.paths)})}async function tL(e,t){let r=Date.now();for(;Date.now()-r<e;){let e=tR(t.paths.infoPath);if(e&&await tF(e,t.transportPreference))return e;await new Promise(e=>setTimeout(e,100))}return null}async function t_(e){await new Promise(t=>setTimeout(t,e))}async function tE(e){let t=tC(e);if(!t.hasLock||t.hasInfo)return!1;let r=tT(e.lockPath);return r&&$(r.pid,r.processStartTime)&&await ec(r.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:r.processStartTime}),tU(e.lockPath),!0}async function tM(e){await ec(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function tR(e){let t=tO(e);if(!t||"object"!=typeof t)return null;let r="string"==typeof t.token&&t.token.length>0?t.token:null;if(!r)return null;let a=Number.isInteger(t.port)&&Number(t.port)>0,n=Number.isInteger(t.httpPort)&&Number(t.httpPort)>0;if(!a&&!n)return null;let o=t.transport,s="string"==typeof t.version?t.version:void 0,i="string"==typeof t.codeSignature?t.codeSignature:void 0,l="string"==typeof t.processStartTime?t.processStartTime:void 0,c=Number.isInteger(t.pid)&&Number(t.pid)>0;return{token:r,port:a?Number(t.port):void 0,httpPort:n?Number(t.httpPort):void 0,transport:"socket"===o||"http"===o||"dual"===o?o:void 0,pid:c?Number(t.pid):0,version:s,codeSignature:i,processStartTime:l}}function tT(e){let t=tO(e);return t&&"object"==typeof t&&Number.isInteger(t.pid)&&Number(t.pid)>0?{pid:Number(t.pid),processStartTime:"string"==typeof t.processStartTime?t.processStartTime:void 0,startedAt:"number"==typeof t.startedAt?t.startedAt:void 0}:null}tA.addSubnet("127.0.0.0",8,"ipv4"),tA.addAddress("::1","ipv6"),tA.addSubnet("::ffff:127.0.0.0",104,"ipv6");function tC(e){return{hasInfo:f.existsSync(e.infoPath),hasLock:f.existsSync(e.lockPath)}}function tO(e){if(!f.existsSync(e))return null;try{return JSON.parse(f.readFileSync(e,"utf8"))}catch{return null}}function tU(e){try{f.existsSync(e)&&f.unlinkSync(e)}catch{}}async function tF(e,t){var r;return"http"===tG(e,t)?await function(e){let t=e.baseUrl?tX(e.baseUrl,"health"):e.httpPort?`http://127.0.0.1:${e.httpPort}/health`:null;if(!t)return Promise.resolve(!1);let r=new URL(t),a="https:"===r.protocol?m:p,n=e.baseUrl?3e3:500;return new Promise(e=>{let t=a.request({protocol:r.protocol,host:r.hostname,port:r.port,path:r.pathname+r.search,method:"GET",timeout:n},t=>{t.resume(),e((t.statusCode??500)<500)});t.on("timeout",()=>{t.destroy(),e(!1)}),t.on("error",()=>{e(!1)}),t.end()})}(e):await ((r=e.port)?new Promise(e=>{let t=d.createConnection({host:"127.0.0.1",port:r},()=>{t.destroy(),e(!0)});t.on("error",()=>{e(!1)})}):Promise.resolve(!1))}async function tj(e){let t=tB(),r=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};ed(process.execPath,r,{env:a})}function tB(){let e=z(),t=i.join(e,"dist","src","daemon.js"),r=i.join(e,"src","daemon.ts"),a=f.existsSync(t),n=f.existsSync(r);if(!a&&!n)throw new eg("COMMAND_FAILED","Daemon entry not found",{distPath:t,srcPath:r});return{root:e,distPath:t,srcPath:r,useSrc:process.execArgv.includes("--experimental-strip-types")?n:!a&&n}}async function tV(e,t,r,a){return"http"===tG(e,r)?await tz(e,t,a):await tJ(e,t,a)}function tG(e,t){if(e.baseUrl){if("socket"===t)throw new eg("COMMAND_FAILED","Remote daemon endpoint only supports HTTP transport",{daemonBaseUrl:e.baseUrl});return"http"}if("http"===t||"socket"===t){var r=e,a=t;if(tq(r,a))return a;throw new eg("COMMAND_FAILED","http"===a?"Daemon HTTP endpoint is unavailable":"Daemon socket endpoint is unavailable")}let n=("socket"===e.transport||"dual"===e.transport?["socket","http"]:["http","socket"]).find(t=>tq(e,t));if(n)return n;throw new eg("COMMAND_FAILED","Daemon metadata has no reachable transport")}function tq(e,t){return"http"===t?!!e.httpPort:!!e.port}function tH(e,t,r,a,n,o){let s=n?{terminated:0}:function(){let e=0;try{for(let t of tk){let r=ep("pkill",["-f",t],{allowFailure:!0});0===r.exitCode&&(e+=1)}return{terminated:e}}catch(t){return{terminated:e,error:t instanceof Error?t.message:String(t)}}}(),i=n?{forcedKill:!1}:function(e,t){let r=!1;try{$(e.pid,e.processStartTime)&&(process.kill(e.pid,"SIGKILL"),r=!0)}catch{ec(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}finally{tU(t.infoPath),tU(t.lockPath)}return{forcedKill:r}}(e,t);return Q({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:o,requestId:r,command:a,timedOutRunnerPidsTerminated:s.terminated,timedOutRunnerCleanupError:s.error,daemonPidReset:n?void 0:e.pid,daemonPidForceKilled:n?void 0:i.forcedKill,daemonBaseUrl:e.baseUrl}}),new eg("COMMAND_FAILED","Daemon request timed out",{timeoutMs:o,requestId:r,hint:n?"Retry with --debug and verify the remote daemon URL, auth token, and remote host logs.":"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."})}function tK(e,t,r){return Q({level:"error",phase:"daemon_request_socket_error",data:{requestId:t,message:e instanceof Error?e.message:String(e)}}),new eg("COMMAND_FAILED","Failed to communicate with daemon",{requestId:t,hint:r?"Retry command. If this persists, verify the remote daemon URL, auth token, and remote host reachability.":"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e instanceof Error?e:void 0)}async function tJ(e,t,r){let a=e.port;if(!a)throw new eg("COMMAND_FAILED","Daemon socket endpoint is unavailable");return new Promise((n,o)=>{let s=d.createConnection({host:"127.0.0.1",port:a},()=>{s.write(`${JSON.stringify(t)}
25
- `)}),i=en(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),l="number"==typeof r?setTimeout(()=>{s.destroy(),o(tH(e,i,t.meta?.requestId,t.command,!1,r))},r):void 0,c="";s.setEncoding("utf8"),s.on("data",e=>{let r=(c+=e).indexOf("\n");if(-1===r)return;let a=c.slice(0,r).trim();if(a)try{let e=JSON.parse(a);s.end(),l&&clearTimeout(l),n(e)}catch(e){l&&clearTimeout(l),o(new eg("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:a},e instanceof Error?e:void 0))}}),s.on("error",e=>{l&&clearTimeout(l),o(tK(e,t.meta?.requestId,!1))})})}async function tz(e,t,r){var a,n,o;let s,i=e.baseUrl?new URL(tX(e.baseUrl,"rpc")):e.httpPort?new URL(`http://127.0.0.1:${e.httpPort}/rpc`):null;if(!i)throw new eg("COMMAND_FAILED","Daemon HTTP endpoint is unavailable");let l=JSON.stringify((a=t,n={includeTokenParam:!e.baseUrl},s=a.meta?.requestId??q(),"lease_allocate"!==(o=a.command)&&"lease_heartbeat"!==o&&"lease_release"!==o?{jsonrpc:"2.0",id:s,method:"agent_device.command",params:a}:{jsonrpc:"2.0",id:s,method:function(e){switch(e){case"lease_allocate":return"agent_device.lease.allocate";case"lease_heartbeat":return"agent_device.lease.heartbeat";case"lease_release":return"agent_device.lease.release"}}(a.command),params:function(e,t,r){let a={...r.includeTokenParam?{token:e.token}:{},session:e.session,tenantId:e.meta?.tenantId,runId:e.meta?.runId};switch(t){case"lease_allocate":return{...a,ttlMs:e.meta?.leaseTtlMs,backend:e.meta?.leaseBackend};case"lease_heartbeat":return{...a,leaseId:e.meta?.leaseId,ttlMs:e.meta?.leaseTtlMs};case"lease_release":return{...a,leaseId:e.meta?.leaseId}}}(a,a.command,n)})),c={"content-type":"application/json","content-length":Buffer.byteLength(l)};return e.baseUrl&&e.token&&(c.authorization=`Bearer ${e.token}`,c["x-agent-device-token"]=e.token),await new Promise((a,n)=>{let o=en(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),s=("https:"===i.protocol?m:p).request({protocol:i.protocol,host:i.hostname,port:i.port,method:"POST",path:i.pathname+i.search,headers:c},r=>{let o="";r.setEncoding("utf8"),r.on("data",e=>{o+=e}),r.on("end",()=>{d&&clearTimeout(d);try{let r=JSON.parse(o);if(r.error){let e=r.error.data??{};n(new eg(String(e.code??"COMMAND_FAILED"),String(e.message??r.error.message??"Daemon RPC request failed"),{..."object"==typeof e.details&&e.details?e.details:{},hint:"string"==typeof e.hint?e.hint:void 0,diagnosticId:"string"==typeof e.diagnosticId?e.diagnosticId:void 0,logPath:"string"==typeof e.logPath?e.logPath:void 0,requestId:t.meta?.requestId}));return}if(!r.result||"object"!=typeof r.result)return void n(new eg("COMMAND_FAILED","Invalid daemon RPC response",{requestId:t.meta?.requestId}));if(e.baseUrl&&r.result.ok)return void tY(e,t,r.result).then(a).catch(n);a(r.result)}catch(e){d&&clearTimeout(d),n(new eg("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:o},e instanceof Error?e:void 0))}})}),u=tW(e),d="number"==typeof r?setTimeout(()=>{s.destroy(),n(tH(e,o,t.meta?.requestId,t.command,u,r))},r):void 0;s.on("error",e=>{d&&clearTimeout(d),n(tK(e,t.meta?.requestId,u))}),s.write(l),s.end()})}function tW(e){return"string"==typeof e.baseUrl&&e.baseUrl.length>0}function tX(e,t){return new URL(t,e.endsWith("/")?e:`${e}/`).toString()}async function tY(e,t,r){let a=Array.isArray(r.data?.artifacts)?r.data.artifacts:[];if(0===a.length||!e.baseUrl)return r;let n=r.data?{...r.data}:{},o=[];for(let r of a){if(!r||"object"!=typeof r||"string"!=typeof r.artifactId){o.push(r);continue}let a=function(e,t){if(e.localPath&&e.localPath.trim().length>0)return e.localPath;let r=e.fileName?.trim()||`${e.field}-${Date.now()}`;return i.resolve(t.meta?.cwd??process.cwd(),r)}(r,t);await tZ({baseUrl:e.baseUrl,token:e.token,artifactId:r.artifactId,destinationPath:a,requestId:t.meta?.requestId}),n[r.field]=a,o.push({...r,localPath:a})}return n.artifacts=o,{ok:!0,data:n}}async function tZ(e){var t,r;let a,n=new URL((t=e.baseUrl,r=e.artifactId,a=t.endsWith("/")?t:`${t}/`,new URL(`upload/${encodeURIComponent(r)}`,a).toString())),o="https:"===n.protocol?m:p;await f.promises.mkdir(i.dirname(e.destinationPath),{recursive:!0}),await new Promise((t,r)=>{let a=!1,s=e.timeoutMs??tb,i=n=>{if(!a){if(a=!0,clearTimeout(c),n)return void f.promises.rm(e.destinationPath,{force:!0}).finally(()=>r(n));t()}},l=o.request({protocol:n.protocol,host:n.hostname,port:n.port,method:"GET",path:n.pathname+n.search,headers:e.token?{authorization:`Bearer ${e.token}`,"x-agent-device-token":e.token}:void 0},t=>{if((t.statusCode??500)>=400){let r="";t.setEncoding("utf8"),t.on("data",e=>{r+=e}),t.on("end",()=>{i(new eg("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,statusCode:t.statusCode,requestId:e.requestId,body:r}))});return}let r=f.createWriteStream(e.destinationPath);r.on("error",e=>{i(e instanceof Error?e:Error(String(e)))}),t.on("error",e=>{i(e instanceof Error?e:Error(String(e)))}),t.on("aborted",()=>{i(new eg("COMMAND_FAILED","Remote artifact download was interrupted",{artifactId:e.artifactId,requestId:e.requestId}))}),r.on("finish",()=>{r.close(()=>i())}),t.pipe(r)}),c=setTimeout(()=>{l.destroy(new eg("COMMAND_FAILED","Remote artifact download timed out",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:s}))},s);l.on("error",t=>{t instanceof eg?i(t):i(new eg("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:s},t instanceof Error?t:void 0))}),l.end()})}function tQ(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}let t0="metro-companion";function t1(e){return w("sha256").update(e).digest("hex")}function t2(e){return e?.trim()?e.trim():void 0}function t3(e,t){let r=i.join(e,".agent-device");if(!t)return{statePath:i.join(r,"metro-companion.json"),logPath:i.join(r,"metro-companion.log")};let a=t1(t).slice(0,12),n=i.join(r,t0);return{statePath:i.join(n,`metro-companion-${a}.json`),logPath:i.join(n,`metro-companion-${a}.log`)}}function t5(e){try{let t=JSON.parse(f.readFileSync(e,"utf8"));if(!Number.isInteger(t.pid)||0>=Number(t.pid)||"string"!=typeof t.serverBaseUrl||"string"!=typeof t.localBaseUrl||"string"!=typeof t.tokenHash||0===t.tokenHash.length)return null;let r=Array.isArray(t.consumers)?t.consumers.filter(e=>"string"==typeof e&&e.length>0):[];return{pid:Number(t.pid),startTime:"string"==typeof t.startTime?t.startTime:void 0,command:"string"==typeof t.command?t.command:void 0,serverBaseUrl:t.serverBaseUrl,localBaseUrl:t.localBaseUrl,launchUrl:t2("string"==typeof t.launchUrl?t.launchUrl:void 0),bridgeScope:function(e){if(!(!e||"object"!=typeof e||Array.isArray(e))&&"string"==typeof e.tenantId&&"string"==typeof e.runId&&"string"==typeof e.leaseId)return{tenantId:e.tenantId,runId:e.runId,leaseId:e.leaseId}}(t.bridgeScope),tokenHash:t.tokenHash,consumers:r}}catch{return null}}function t8(e,t){f.mkdirSync(i.dirname(e),{recursive:!0}),f.writeFileSync(e,`${JSON.stringify(t,null,2)}
26
- `,"utf8")}function t4(e){try{let t=f.readdirSync(e);0===t.length&&f.rmdirSync(e)}catch{}}function t6(e){let t=i.dirname(e.statePath),r=i.dirname(e.logPath);var a=e.statePath;try{f.unlinkSync(a)}catch{}var n=e.logPath;try{f.unlinkSync(n)}catch{}t4(t),r!==t&&t4(r),i.basename(t)===t0&&t4(i.dirname(t))}function t7(e){return e.includes(ey)}function t9(e){return t2(e.consumerKey)??t2(e.profileKey)??null}function re(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}async function rt(e){if(!et(e.pid))return;let t=k(e.pid);if(t&&t7(t)){try{process.kill(e.pid,"SIGTERM")}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return;throw t}if(!await A(e.pid,1e3)){try{process.kill(e.pid,"SIGKILL")}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return;throw t}await A(e.pid,1e3)}}}async function rr(e){let t=t9(e),r=t3(e.projectRoot,e.profileKey),a=t5(r.statePath);if(a&&function(e,t){var r,a;if(!et(e.pid))return!1;if(e.startTime){let t=er(e.pid);if(!t||t!==e.startTime)return!1}let n=k(e.pid);return!!n&&!!t7(n)&&!!e.bridgeScope&&e.serverBaseUrl===ew(t.serverBaseUrl)&&e.localBaseUrl===ew(t.localBaseUrl)&&e.launchUrl===t2(t.launchUrl)&&(r=e.bridgeScope,a=t.bridgeScope,r.tenantId===a.tenantId&&r.runId===a.runId&&r.leaseId===a.leaseId)&&e.tokenHash===t1(t.bearerToken)}(a,e)){let e=re(a,t);return e!==a&&t8(r.statePath,e),{pid:a.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}a&&(await rt(a),t6(r));let n=function(e,t){let r=function(){let e=c(import.meta.url),t=i.extname(e)||".js",r=i.join(i.dirname(e),`metro-companion${t}`);if(!f.existsSync(r))throw Error(`Metro companion entrypoint not found at ${r}. Rebuild the package to include the companion worker entry.`);return r}(),a=r.endsWith(".ts")?["--experimental-strip-types"]:[];f.mkdirSync(i.dirname(t),{recursive:!0});let n=f.openSync(t,"a"),o=0;try{let t;o=ed(process.execPath,[...a,r,ey],{env:((t={...e.env??process.env,[ev]:ew(e.serverBaseUrl),[e$]:e.bearerToken,[eI]:ew(e.localBaseUrl),[ek]:t3(e.projectRoot,e.profileKey).statePath})[eS]=e.bridgeScope.tenantId,t[eD]=e.bridgeScope.runId,t[ex]=e.bridgeScope.leaseId,e.launchUrl?.trim()?t[eA]=e.launchUrl.trim():delete t[eA],t),stdio:["ignore",n,n]})}finally{f.closeSync(n)}if(!Number.isInteger(o)||o<=0)throw Error("Failed to start Metro companion process.");return{pid:o,startTime:er(o)??void 0,command:k(o)??void 0,serverBaseUrl:ew(e.serverBaseUrl),localBaseUrl:ew(e.localBaseUrl),launchUrl:t2(e.launchUrl),bridgeScope:e.bridgeScope,tokenHash:t1(e.bearerToken),consumers:[]}}(e,r.logPath);return t8(r.statePath,re(n,t)),{pid:n.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function ra(e){let t=t9(e),r=t3(e.projectRoot,e.profileKey),a=t5(r.statePath);if(!a)return t6(r),{stopped:!1,statePath:r.statePath};let n=t?{...a,consumers:a.consumers.filter(e=>e!==t)}:{...a,consumers:[]};return n.consumers.length>0?(t8(r.statePath,n),{stopped:!1,statePath:r.statePath}):(await rt(a),t6(r),{stopped:!0,statePath:r.statePath})}function rn(e){return"string"==typeof e&&e.trim()?ew(e.trim()):""}function ro(e){return"string"==typeof e&&e.trim()?e.trim():void 0}function rs(e,t,r){return Y(e,{env:t,cwd:r})}function ri(e){try{return f.accessSync(e,f.constants.F_OK),!0}catch{return!1}}function rl(e,t,r){if(null==e||""===e)return t;let a=Number.parseInt(String(e),10);return Number.isInteger(a)?Math.max(a,r):t}function rc(e,t){return{platform:t,bundleUrl:eb(e,t)}}function ru(e,t){return{platform:t,metroHost:ro(e?.metro_host),metroPort:e?.metro_port,bundleUrl:ro(e?.metro_bundle_url),launchUrl:ro(e?.launch_url)}}async function rd(e){await new Promise(t=>setTimeout(t,e))}async function rp(e,t,r={}){try{let a=await fetch(e,{headers:r,signal:AbortSignal.timeout(t)});return{ok:a.ok,status:a.status,body:await a.text()}}catch(r){if(r instanceof Error&&"TimeoutError"===r.name)throw Error(`Timed out fetching ${e} after ${t}ms`);throw r}}async function rm(e,t){try{let r=await rp(e,t);return r.ok&&r.body.includes("packager-status:running")}catch{return!1}}async function rf(e){if(Number.isInteger(e)&&!(e<=0)){try{process.kill(e,"SIGTERM")}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return;throw t}if(!await A(e,1e3)){try{process.kill(e,"SIGKILL")}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return;throw t}await A(e,1e3)}}}function rh(e,t){let r=Error(e);return r.retryable=t,r}function rg(e,t){return!!(e>=500||408===e||425===e||429===e||JSON.stringify(t).includes("Metro companion is not connected"))}function ry(e){return!!(e&&"object"==typeof e&&"retryable"in e&&!0===e.retryable)}async function rw(e){let t;try{var r,a;t=await fetch(`${e.baseUrl}/api/metro/bridge`,{method:"POST",headers:(r=e.baseUrl,a=e.bearerToken,{Authorization:`Bearer ${a}`,"Content-Type":"application/json",...r.includes("ngrok")?{"ngrok-skip-browser-warning":"1"}:{}}),body:JSON.stringify({...e.scope,ios_runtime:e.runtime,timeout_ms:e.timeoutMs}),signal:AbortSignal.timeout(e.timeoutMs)})}catch(t){if(t instanceof Error&&"TimeoutError"===t.name)throw rh(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0);throw rh(t instanceof Error?t.message:String(t),!0)}let n=function(e,t,r){if(!e)return{};try{let t=JSON.parse(e);if(!t||"object"!=typeof t||Array.isArray(t))throw Error("Expected a JSON object");return t}catch(o){let a=e.slice(0,200),n=o instanceof Error?o.message:String(o);throw rh(`/api/metro/bridge returned invalid JSON (${t}) from ${r}: ${n}. body=${JSON.stringify(a)}`,rg(t,e))}}(await t.text(),t.status,e.baseUrl);if(!t.ok)throw rh(`/api/metro/bridge failed (${t.status}): ${JSON.stringify(n)}`,rg(t.status,n));var o=n;let s=o.data??o;if(!s||"object"!=typeof s||Array.isArray(s))throw rh("/api/metro/bridge returned malformed descriptor: Expected a JSON object.",!1);try{return{enabled:s.enabled,baseUrl:s.base_url,statusUrl:s.status_url??"",bundleUrl:s.bundle_url??"",iosRuntime:ru(s.ios_runtime,"ios"),androidRuntime:ru(s.android_runtime,"android"),upstream:{bundleUrl:s.upstream.bundle_url??"",host:s.upstream.host??"",port:s.upstream.port??0,statusUrl:s.upstream.status_url??""},probe:{reachable:s.probe.reachable,statusCode:s.probe.status_code,latencyMs:s.probe.latency_ms,detail:s.probe.detail}}}catch(e){throw rh(`/api/metro/bridge returned malformed descriptor: ${e instanceof Error?e.message:String(e)}`,!1)}}function rb(e,t,r,a,n){let o=[`Metro bridge is required for this run but could not be configured via ${e}/api/metro/bridge.`];return t&&o.push(`bridgeError=${t}`),r?.probe.reachable===!1&&o.push(`bridgeProbe=${r.probe.detail||`unreachable (status ${r.probe.statusCode||0})`}`),a&&a!==t&&o.push(`initialBridgeError=${a}`),n&&o.push(`metroCompanionLog=${n}`),o.join(" ")}async function rv(e,t,r){let a=Date.now()+t;for(;Date.now()<a;){let t=Math.min(r,Math.max(a-Date.now(),1));if(await rm(e,t))return!0;let n=Math.min(500,Math.max(a-Date.now(),0));n>0&&await rd(n)}return!1}async function rI(e){let t=Date.now()+e.startupTimeoutMs,r=null,a=null;for(;Date.now()<t;){try{let t=await rw({baseUrl:e.baseUrl,bearerToken:e.bearerToken,scope:e.scope,runtime:e.runtime,timeoutMs:e.probeTimeoutMs});if(!1!==t.probe.reachable)return t;r=t,a=null}catch(e){if(a=e instanceof Error?e.message:String(e),!ry(e))break}let n=Math.min(1e3,Math.max(t-Date.now(),0));n>0&&await rd(n)}throw Error(rb(e.baseUrl,a,r,e.initialBridgeError,e.companionLogPath))}async function rk(e={}){let t=e.env??process.env,r=process.cwd(),a=rs(e.projectRoot??r,t,r),n=function(e,t){if("auto"!==t)return t;let r=function(e){let t=i.join(e,"package.json");if(!ri(t))throw new eg("INVALID_ARGS",`package.json not found at ${t}`);return JSON.parse(f.readFileSync(t,"utf8"))}(e);return"string"==typeof({...r.dependencies??{},...r.devDependencies??{}}).expo?"expo":"react-native"}(a,e.kind??"auto"),o=function(e){if(null==e||""===e)return 8081;let t=Number.parseInt(String(e),10);if(!Number.isInteger(t)||t<1||t>65535)throw new eg("INVALID_ARGS",`Invalid Metro port: ${String(e)}. Use 1-65535.`);return t}(e.metroPort??8081),s=ro(e.listenHost)??"0.0.0.0",l=ro(e.statusHost)??"127.0.0.1",c=rn(e.publicBaseUrl),u=rl(e.startupTimeoutMs,18e4,3e4),d=rl(e.probeTimeoutMs,1e4,1e3),p=e.reuseExisting??!0,m=e.installDependenciesIfNeeded??!0,h=e.runtimeFilePath?rs(e.runtimeFilePath,t,r):null,g=rs(e.logPath??i.join(a,".agent-device","metro.log"),t,r);if(!c)throw new eg("INVALID_ARGS","metro prepare requires --public-base-url <url>.");let{proxyEnabled:y,proxyBaseUrl:w,proxyBearerToken:b}=function(e,t){if(e&&!t)throw new eg("INVALID_ARGS","metro prepare requires proxy auth when --proxy-base-url is provided. Pass --bearer-token or set AGENT_DEVICE_PROXY_TOKEN.");if(!e&&t)throw new eg("INVALID_ARGS","metro prepare requires --proxy-base-url when proxy auth is provided.");return{proxyEnabled:!!(e&&t),proxyBaseUrl:e,proxyBearerToken:t}}(rn(e.proxyBaseUrl),ro(e.proxyBearerToken)??""),v=y?function(e){if(!e?.tenantId||!e.runId||!e.leaseId)throw new eg("INVALID_ARGS","metro prepare with proxy requires tenantId, runId, and leaseId bridge scope.");return e}(e.bridgeScope):null,I=m?function(e,t){if(function(e){try{return f.statSync(e).isDirectory()}catch{return!1}}(i.join(e,"node_modules")))return{installed:!1};let r=ri(i.join(e,"pnpm-lock.yaml"))?{command:"pnpm",installArgs:["install"]}:ri(i.join(e,"yarn.lock"))?{command:"yarn",installArgs:["install"]}:{command:"npm",installArgs:["install"]};return ep(r.command,r.installArgs,{cwd:e,env:t}),{installed:!0,packageManager:r.command}}(a,t):{installed:!1},k=`http://${l}:${o}/status`,A=!1,S=!1,D=0;if(p&&await rm(k,d))S=!0;else if(A=!0,D=function(e,t,r,a,n,o){let s="expo"===t?{command:"npx",installArgs:["expo","start","--host","lan","--port",String(r)]}:{command:"npx",installArgs:["react-native","start","--host",a,"--port",String(r)]};f.mkdirSync(i.dirname(n),{recursive:!0});let l=f.openSync(n,"a"),c=0;try{c=ed(s.command,s.installArgs,{cwd:e,env:o,stdio:["ignore",l,l]})}finally{f.closeSync(l)}if(!Number.isInteger(c)||c<=0)throw Error("Failed to start Metro. Expected a detached child PID.");return{pid:c}}(a,n,o,s,g,t).pid,!await rv(k,u,d))throw await rf(D).catch(()=>{}),Error(`Metro did not become ready at ${k} within ${u}ms. Check ${g}.`);let $=rc(c,"ios"),x=rc(c,"android"),N=null,P=null;if(v)try{N=await rw({baseUrl:w,bearerToken:b,scope:v,runtime:{metro_bundle_url:$.bundleUrl},timeoutMs:d})}catch(e){if(!ry(e))throw e;P=e instanceof Error?e.message:String(e)}if(v&&(!N||!1===N.probe.reachable)){let r;try{r=(await rr({projectRoot:a,serverBaseUrl:w,bearerToken:b,bridgeScope:v,localBaseUrl:`http://${l}:${o}`,launchUrl:ro(e.launchUrl),profileKey:ro(e.companionProfileKey),consumerKey:ro(e.companionConsumerKey),env:t})).logPath}catch(e){throw Error(rb(w,e instanceof Error?e.message:String(e),N,P))}try{N=await rI({baseUrl:w,bearerToken:b,scope:v,runtime:{metro_bundle_url:$.bundleUrl},probeTimeoutMs:d,startupTimeoutMs:u,initialBridgeError:P,companionLogPath:r})}catch(e){throw e instanceof Error?e:Error(String(e))}}let L=N?.iosRuntime??$,_=N?.androidRuntime??x,E={projectRoot:a,kind:n,dependenciesInstalled:I.installed,packageManager:I.packageManager??null,started:A,reused:S,pid:D,logPath:g,statusUrl:k,runtimeFilePath:h,iosRuntime:L,androidRuntime:_,bridge:N};return h&&(f.mkdirSync(i.dirname(h),{recursive:!0}),f.writeFileSync(h,JSON.stringify(E,null,2))),E}let rA="alert",rS="appstate",rD="app-switcher",r$="apps",rx="back",rN="batch",rP="boot",rL="click",r_="clipboard",rE="devices",rM="diff",rR="fill",rT="find",rC="focus",rO="home",rU="keyboard",rF="logs",rj="longpress",rB="network",rV="perf",rG="pinch",rq="press",rH="push",rK="record",rJ="replay",rz="rotate",rW="scroll",rX="screenshot",rY="settings",rZ="snapshot",rQ="swipe",r0="test",r1="trace",r2="trigger-app-event",r3="type",r5="wait";function r8(e,t,r,a){let n=r(e[t]);if(void 0===n)throw new eg("COMMAND_FAILED",a,{response:e});return n}function r4(e,t){return r8(e,t,ar,`Daemon response is missing "${t}".`)}function r6(e,t){return ar(e[t])}function r7(e,t){var r;let a;return r=ar,null===(a=e[t])?null:r(a)}function r9(e,t){return r8(e,t,an,`Daemon response has invalid "${t}".`)}function ae(e,t){return function(e){return"tv"===e||"mobile"===e||"desktop"===e?e:void 0}(e[t])??"mobile"}function at(e,t){let r=e[t];if(!ai(r))return;let a="number"==typeof r.x?r.x:void 0,n="number"==typeof r.y?r.y:void 0,o="number"==typeof r.width?r.width:void 0,s="number"==typeof r.height?r.height:void 0;if(void 0!==a&&void 0!==n&&void 0!==o&&void 0!==s)return{x:a,y:n,width:o,height:s}}function ar(e){return"string"==typeof e&&e.length>0?e:void 0}function aa(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function an(e){return"ios"===e||"macos"===e||"android"===e?e:void 0}function ao(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}function as(e){if(!ai(e))throw new eg("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:e});return e}function ai(e){return"object"==typeof e&&null!==e}function al(e){let t={};for(let[r,a]of Object.entries(e))void 0!==a&&(t[r]=a);return t}function ac(e,t){let r=r6(e,"bundleId"),a=r6(e,"package");return{app:r4(e,"app"),appPath:r4(e,"appPath"),platform:r9(e,"platform"),appId:r??a,bundleId:r,package:a,identifiers:N({session:t,bundleId:r,packageName:a})}}function au(e){let t=as(e),r=r9(t,"platform"),a=r4(t,"id"),n=r4(t,"name");return{platform:r,target:ae(t,"target"),kind:r8(t,"kind",ao,'Daemon response has invalid "kind".'),id:a,name:n,booted:"boolean"==typeof t.booted?t.booted:void 0,identifiers:x(r,a,n),ios:"ios"===r?{udid:a}:void 0,android:"android"===r?{serial:a}:void 0}}function ad(e){let t=as(e),r=r9(t,"platform"),a=r4(t,"id"),n=r4(t,"name"),o=ae(t,"target"),s=r4(t,"device"),i={session:n,...x(r,a,s)};return{name:n,createdAt:r8(t,"createdAt",aa,'Daemon response is missing numeric "createdAt".'),device:{platform:r,target:o,id:a,name:s,identifiers:i,ios:"ios"===r?{udid:a,simulatorSetPath:r7(t,"ios_simulator_device_set")}:void 0,android:"android"===r?{serial:a}:void 0},identifiers:i}}function ap(e){return e??"default"}function am(e={},t={}){var r;let a,n=t.transport??tS,o=async(t,r=[],a={})=>{var o,s;let i=(o=e,s=a,{...o,...s}),l=await n({session:ap(i.session),command:t,positionals:r,flags:al({stateDir:i.stateDir,daemonBaseUrl:i.daemonBaseUrl,daemonAuthToken:i.daemonAuthToken,daemonTransport:i.daemonTransport,daemonServerMode:i.daemonServerMode,tenant:i.tenant,sessionIsolation:i.sessionIsolation,runId:i.runId,leaseId:i.leaseId,leaseBackend:i.leaseBackend,platform:i.platform,target:i.target,device:i.device,udid:i.udid,serial:i.serial,iosSimulatorDeviceSet:i.iosSimulatorDeviceSet,androidDeviceAllowlist:i.androidDeviceAllowlist,runtime:i.simulatorRuntimeId,boot:i.boot,reuseExisting:i.reuseExisting,surface:i.surface,activity:i.activity,relaunch:i.relaunch,shutdown:i.shutdown,saveScript:i.saveScript,noRecord:i.noRecord,backMode:i.backMode,metroHost:i.metroHost,metroPort:i.metroPort,bundleUrl:i.bundleUrl,launchUrl:i.launchUrl,snapshotInteractiveOnly:i.interactiveOnly,snapshotCompact:i.compact,snapshotDepth:i.depth,snapshotScope:i.scope,snapshotRaw:i.raw,screenshotFullscreen:i.screenshotFullscreen,overlayRefs:i.overlayRefs,appsFilter:i.appsFilter,out:i.out,count:i.count,fps:i.fps,quality:i.quality,hideTouches:i.hideTouches,intervalMs:i.intervalMs,delayMs:i.delayMs,holdMs:i.holdMs,jitterPx:i.jitterPx,pixels:i.pixels,doubleTap:i.doubleTap,clickButton:i.clickButton,pauseMs:i.pauseMs,pattern:i.pattern,headless:i.headless,restart:i.restart,replayUpdate:i.replayUpdate,failFast:i.failFast,timeoutMs:i.timeoutMs,retries:i.retries,artifactsDir:i.artifactsDir,reportJunit:i.reportJunit,findFirst:i.findFirst,findLast:i.findLast,networkInclude:i.networkInclude,batchOnError:i.batchOnError,batchMaxSteps:i.batchMaxSteps,batchSteps:i.batchSteps,verbose:i.debug}),runtime:i.runtime,meta:al({requestId:i.requestId,cwd:i.cwd,debug:i.debug,lockPolicy:i.lockPolicy,lockPlatform:i.lockPlatform,tenantId:i.tenant,runId:i.runId,leaseId:i.leaseId,leaseBackend:i.leaseBackend,leaseTtlMs:i.leaseTtlMs,sessionIsolation:i.sessionIsolation,installSource:i.installSource,retainMaterializedPaths:i.retainMaterializedPaths,materializedPathRetentionMs:i.materializedPathRetentionMs,materializationId:i.materializationId})});return l.ok||function(e){throw new eg(e.code,e.message,{...e.details??{},hint:e.hint,diagnosticId:e.diagnosticId,logPath:e.logPath})}(l.error),l.data??{}},s=async(e={})=>{let t=await o("session_list",[],e);return(Array.isArray(t.sessions)?t.sessions:[]).map(ad)},i=async(e,t=[],r={})=>await o(e,t,r),l=(t={})=>{var r,a;return ap((r=e,a=t,{...r,...a}).session)};return{command:(r=async e=>await o(e.command,e.positionals,e.options),a=async e=>await r(e),{wait:async e=>await a(function(e){if(1!==[void 0!==e.durationMs?"durationMs":void 0,void 0!==e.text?"text":void 0,void 0!==e.ref?"ref":void 0,void 0!==e.selector?"selector":void 0].filter(Boolean).length)throw new eg("INVALID_ARGS","wait command requires exactly one of durationMs, text, ref, or selector.");if(void 0!==e.durationMs)return{command:r5,positionals:[String(e.durationMs)],options:e};let t=void 0!==e.timeoutMs?[String(e.timeoutMs)]:[];if(void 0!==e.text)return{command:r5,positionals:["text",e.text,...t],options:e};if(void 0!==e.ref)return{command:r5,positionals:[e.ref,...t],options:e};let r=e.selector;return function(e){if(!H(e))throw new eg("INVALID_ARGS",`Invalid wait selector: ${e}`)}(r),{command:r5,positionals:[r,...t],options:e}}(e)),alert:async(e={})=>{var t;return await a({command:rA,positionals:[(t=e).action??"get",...void 0!==t.timeoutMs?[String(t.timeoutMs)]:[]],options:t})},appState:async(e={})=>await a({command:rS,positionals:[],options:e}),back:async(e={})=>await a({command:rx,positionals:[],options:{...e,backMode:e.mode}}),home:async(e={})=>await a({command:rO,positionals:[],options:e}),rotate:async e=>await a({command:rz,positionals:[e.orientation],options:e}),appSwitcher:async(e={})=>await a({command:rD,positionals:[],options:e}),keyboard:async(e={})=>await a({command:rU,positionals:e.action?[e.action]:[],options:e}),clipboard:async e=>{var t;return await a("read"===(t=e).action?{command:r_,positionals:["read"],options:t}:{command:r_,positionals:["write",t.text],options:t})}}),devices:{list:async(e={})=>{let t=await o(rE,[],e);return(Array.isArray(t.devices)?t.devices:[]).map(au)},boot:async(e={})=>await i(rP,[],e)},sessions:{list:async(e={})=>await s(e),close:async(e={})=>{let t=l(e),r=(await o("close",[],e)).shutdown;return{session:t,shutdown:"object"==typeof r&&null!==r?r:void 0,identifiers:{session:t}}}},simulators:{ensure:async e=>{let{runtime:t,...r}=e,a=await o("ensure-simulator",[],{...r,simulatorRuntimeId:t}),n=r4(a,"udid"),s=r4(a,"device");return{udid:n,device:s,runtime:r4(a,"runtime"),created:!0===a.created,booted:!0===a.booted,iosSimulatorDeviceSet:r7(a,"ios_simulator_device_set"),identifiers:{deviceId:n,deviceName:s,udid:n}}}},apps:{install:async e=>ac(await o("install",[e.app,e.appPath],e),l(e)),reinstall:async e=>ac(await o("reinstall",[e.app,e.appPath],e),l(e)),installFromSource:async e=>(function(e,t){let r=r6(e,"bundleId"),a=r6(e,"packageName"),n=r??a??r6(e,"appId"),o=r6(e,"launchTarget")??a??r??n;if(!o)throw new eg("COMMAND_FAILED",'Daemon response is missing "launchTarget".',{response:e});return{appName:r6(e,"appName"),appId:n,bundleId:r,packageName:a,launchTarget:o,installablePath:r6(e,"installablePath"),archivePath:r6(e,"archivePath"),materializationId:r6(e,"materializationId"),materializationExpiresAt:r6(e,"materializationExpiresAt"),identifiers:N({session:t,bundleId:r,packageName:a,appId:n})}})(await o("install_source",[],{...e,installSource:e.source,retainMaterializedPaths:e.retainPaths,materializedPathRetentionMs:e.retentionMs}),l(e)),list:async(e={})=>{let t=await o(r$,[],e);return Array.isArray(t.apps)?t.apps.filter(e=>"string"==typeof e):[]},open:async e=>{let t=l(e),r=e.app?e.url?[e.app,e.url]:[e.app]:[],a=await o("open",r,e),n=function(e){let t=e.platform,r=r6(e,"id"),a=r6(e,"device");if("ios"!==t&&"macos"!==t&&"android"!==t||!r||!a)return;let n=ae(e,"target"),o=x(t,r,a);return{platform:t,target:n,id:r,name:a,identifiers:o,ios:"ios"===t?{udid:r6(e,"device_udid")??r,simulatorSetPath:r7(e,"ios_simulator_device_set")}:void 0,android:"android"===t?{serial:r6(e,"serial")??r}:void 0}}(a),s=r6(a,"appBundleId");return{session:t,appName:r6(a,"appName"),appBundleId:s,appId:s,startup:function(e){if(ai(e)&&"number"==typeof e.durationMs&&"string"==typeof e.measuredAt&&"string"==typeof e.method)return{durationMs:e.durationMs,measuredAt:e.measuredAt,method:e.method,appTarget:r6(e,"appTarget"),appBundleId:r6(e,"appBundleId")}}(a.startup),runtime:function(e){if(!ai(e))return;let t=e.platform,r=r6(e,"metroHost"),a="number"==typeof e.metroPort?e.metroPort:void 0;return{platform:"ios"===t||"android"===t?t:void 0,metroHost:r,metroPort:a,bundleUrl:r6(e,"bundleUrl"),launchUrl:r6(e,"launchUrl")}}(a.runtime),device:n,identifiers:{session:t,deviceId:n?.id,deviceName:n?.name,udid:n?.ios?.udid,serial:n?.android?.serial,appId:s,appBundleId:s}}},close:async(e={})=>{let t=l(e),r=(await o("close",e.app?[e.app]:[],e)).shutdown;return{session:t,closedApp:e.app,shutdown:"object"==typeof r&&null!==r?r:void 0,identifiers:{session:t}}},push:async e=>{var t;return await i(rH,[e.app,"string"==typeof(t=e.payload)?t:JSON.stringify(t)],e)},triggerEvent:async e=>{var t;return await i(r2,[(t=e).event,...t.payload?[JSON.stringify(t.payload)]:[]],e)}},materializations:{release:async e=>{var t;return{released:!0===(t=await o("release_materialized_paths",[],{...e,materializationId:e.materializationId})).released,materializationId:r4(t,"materializationId"),identifiers:{}}}},leases:{allocate:async e=>ay(await o("lease_allocate",[],{...e,leaseId:void 0,leaseTtlMs:e.ttlMs})),heartbeat:async e=>ay(await o("lease_heartbeat",[],{...e,leaseTtlMs:e.ttlMs})),release:async e=>({released:!0===(await o("lease_release",[],e)).released})},metro:{prepare:async t=>await rk({projectRoot:t.projectRoot??e.cwd,kind:t.kind,publicBaseUrl:t.publicBaseUrl,proxyBaseUrl:t.proxyBaseUrl,proxyBearerToken:t.bearerToken,bridgeScope:t.bridgeScope,launchUrl:t.launchUrl,companionProfileKey:t.companionProfileKey,companionConsumerKey:t.companionConsumerKey,metroPort:t.port,listenHost:t.listenHost,statusHost:t.statusHost,startupTimeoutMs:t.startupTimeoutMs,probeTimeoutMs:t.probeTimeoutMs,reuseExisting:t.reuseExisting,installDependenciesIfNeeded:t.installDependenciesIfNeeded,runtimeFilePath:t.runtimeFilePath,logPath:t.logPath})},capture:{snapshot:async(e={})=>{var t;let r=l(e),a=await o(rZ,[],e),n=r6(a,"appBundleId"),s="object"==typeof a.visibility&&null!==a.visibility?a.visibility:void 0;return{nodes:Array.isArray(t=a.nodes)?t:[],truncated:!0===a.truncated,appName:r6(a,"appName"),appBundleId:n,...s?{visibility:s}:{},warnings:Array.isArray(a.warnings)?a.warnings.filter(e=>"string"==typeof e):void 0,identifiers:{session:r,appId:n,appBundleId:n}}},screenshot:async(e={})=>{let t=l(e),r=await o(rX,e.path?[e.path]:[],{...e,screenshotFullscreen:e.fullscreen});return{path:r4(r,"path"),overlayRefs:function(e){let t=e.overlayRefs;if(!Array.isArray(t))return;let r=[];for(let e of t){if(!ai(e))continue;let t=r6(e,"ref"),a=at(e,"rect"),n=at(e,"overlayRect"),o=function(e,t){let r=e[t];if(!ai(r))return;let a="number"==typeof r.x?r.x:void 0,n="number"==typeof r.y?r.y:void 0;if(void 0!==a&&void 0!==n)return{x:a,y:n}}(e,"center");t&&a&&n&&o&&r.push({ref:t,label:r6(e,"label"),rect:a,overlayRect:n,center:o})}return r}(r),identifiers:{session:t}}},diff:async e=>await i(rM,[e.kind],{...e,interactiveOnly:e.interactiveOnly,compact:e.compact,depth:e.depth,scope:e.scope,raw:e.raw})},interactions:{click:async e=>await i(rL,af(e),{...e,clickButton:e.button}),press:async e=>await i(rq,af(e),e),longPress:async e=>await i(rj,[String(e.x),String(e.y),...ag(e.durationMs)],e),swipe:async e=>await i(rQ,[String(e.from.x),String(e.from.y),String(e.to.x),String(e.to.y),...ag(e.durationMs)],e),focus:async e=>await i(rC,[String(e.x),String(e.y)],e),type:async e=>await i(r3,[e.text],e),fill:async e=>await i(rR,[...af(e),e.text],e),scroll:async e=>await i(rW,[e.direction,...ag(e.amount)],e),pinch:async e=>await i(rG,[String(e.scale),...ag(e.x),...ag(e.y)],e),get:async e=>{var t;return await i("get",[e.format,...void 0!==(t=e).ref?[t.ref,...ah(t.label)]:[t.selector]],e)},is:async e=>await i("is",[e.predicate,e.selector,..."text"===e.predicate?[e.value]:[]],e),find:async e=>await i(rT,function(e){let t=e.locator&&"any"!==e.locator?[e.locator,e.query]:[e.query];switch(e.action){case void 0:case"click":case"focus":case"exists":return e.action?[...t,e.action]:t;case"getText":return[...t,"get","text"];case"getAttrs":return[...t,"get","attrs"];case"wait":return[...t,"wait",...ag(e.timeoutMs)];case"fill":case"type":return[...t,e.action,e.value]}}(e),{...e,findFirst:e.first,findLast:e.last})},replay:{run:async e=>await i(rJ,[e.path],{...e,replayUpdate:e.update}),test:async e=>await i(r0,e.paths,{...e,replayUpdate:e.update})},batch:{run:async e=>await i(rN,[],{...e,batchSteps:e.steps,batchOnError:e.onError,batchMaxSteps:e.maxSteps})},observability:{perf:async(e={})=>await i(rV,[],e),logs:async(e={})=>{var t;return await i(rF,[(t=e).action??"path",...ah(t.message)],e)},network:async(e={})=>{var t;return await i(rB,[...(t=e).action?[t.action]:[],...ag(t.limit)],{...e,networkInclude:e.include})}},recording:{record:async e=>await i(rK,[e.action,...ah(e.path)],e),trace:async e=>await i(r1,[e.action,...ah(e.path)],e)},settings:{update:async e=>await i(rY,[e.setting,e.state,..."permission"in e?[e.permission]:[],..."mode"in e&&e.mode?[e.mode]:[]],e)}}}function af(e){return void 0!==e.ref?[e.ref,...ah(e.label)]:void 0!==e.selector?[e.selector]:[String(e.x),String(e.y)]}function ah(e){return void 0===e?[]:[e]}function ag(e){return void 0===e?[]:[String(e)]}function ay(e){let t=e.lease;if(!t||"object"!=typeof t||Array.isArray(t))throw Error("Invalid lease response from daemon");return{leaseId:r4(t,"leaseId"),tenantId:r4(t,"tenantId"),runId:r4(t,"runId"),backend:r4(t,"backend"),createdAt:"number"==typeof t.createdAt?t.createdAt:void 0,heartbeatAt:"number"==typeof t.heartbeatAt?t.heartbeatAt:void 0,expiresAt:"number"==typeof t.expiresAt?t.expiresAt:void 0}}async function aw(e){await ra(e)}let ab=[{key:"stateDir",type:"string",path:!0},{key:"daemonBaseUrl",type:"string"},{key:"daemonAuthToken",type:"string"},{key:"daemonTransport",type:"enum",enumValues:["auto","socket","http"]},{key:"daemonServerMode",type:"enum",enumValues:["socket","http","dual"]},{key:"tenant",type:"string"},{key:"sessionIsolation",type:"enum",enumValues:["none","tenant"]},{key:"runId",type:"string"},{key:"leaseId",type:"string"},{key:"leaseBackend",type:"enum",enumValues:["ios-simulator","ios-instance","android-instance"]},{key:"platform",type:"enum",enumValues:["ios","macos","android","linux","apple"]},{key:"target",type:"enum",enumValues:["mobile","tv","desktop"]},{key:"device",type:"string"},{key:"udid",type:"string"},{key:"serial",type:"string"},{key:"iosSimulatorDeviceSet",type:"string",path:!0,legacyEnvNames:["IOS_SIMULATOR_DEVICE_SET"]},{key:"androidDeviceAllowlist",type:"string",legacyEnvNames:["ANDROID_DEVICE_ALLOWLIST"]},{key:"session",type:"string"},{key:"metroProjectRoot",type:"string",path:!0},{key:"metroKind",type:"enum",enumValues:["auto","react-native","expo"]},{key:"metroPublicBaseUrl",type:"string"},{key:"metroProxyBaseUrl",type:"string"},{key:"metroBearerToken",type:"string",legacyEnvNames:["AGENT_DEVICE_PROXY_TOKEN"]},{key:"metroPreparePort",type:"int",min:1,max:65535},{key:"metroListenHost",type:"string"},{key:"metroStatusHost",type:"string"},{key:"metroStartupTimeoutMs",type:"int",min:1},{key:"metroProbeTimeoutMs",type:"int",min:1},{key:"metroRuntimeFile",type:"string",path:!0},{key:"metroNoReuseExisting",type:"boolean"},{key:"metroNoInstallDeps",type:"boolean"}],av=new Map(ab.map(e=>[e.key,e]));function aI(e){let t=e.env??process.env;return Y(e.configPath,{cwd:e.cwd,env:t})}function ak(e){let t=function(e){let t,r,a=e.env??process.env,n=aI(e);if(!f.existsSync(n))throw new eg("INVALID_ARGS",`Remote config file not found: ${n}`);try{t=f.readFileSync(n,"utf8")}catch(e){throw new eg("INVALID_ARGS",`Failed to read remote config file: ${n}`,{cause:e instanceof Error?e.message:String(e)})}try{r=JSON.parse(t)}catch(e){throw new eg("INVALID_ARGS",`Invalid JSON in remote config file: ${n}`,{cause:e instanceof Error?e.message:String(e)})}if(!r||"object"!=typeof r||Array.isArray(r))throw new eg("INVALID_ARGS",`Remote config file must contain a JSON object: ${n}`);let o={},s=r,l=i.dirname(n);for(let[e,t]of Object.entries(s)){let r=av.get(e);if(!r)throw new eg("INVALID_ARGS",`Unsupported remote config key "${e}" in remote config file ${n}.`);let s=ez(r,t,`remote config file ${n}`,e);o[r.key]="string"==typeof s&&"path"in r&&r.path?Y(s,{cwd:l,env:a}):s}return{resolvedPath:n,profile:o}}(e);return{resolvedPath:t.resolvedPath,profile:function(...e){let t={};for(let r of e)if(r)for(let e of ab){let a=r[e.key];void 0!==a&&(t[e.key]=a)}return t}(function(e=process.env){let t={};for(let r of ab){let a=(function(e){let t=av.get(e);return[eJ(e),...t?.legacyEnvNames??[]]})(r.key).map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);a&&(t[r.key]=ez(r,a.value,`environment variable ${a.name}`,a.name))}return t}(e.env),t.profile)}}function aA(e){var t;let r,a=aN(e);if(!f.existsSync(a))return null;try{r=JSON.parse(f.readFileSync(a,"utf8"))}catch(t){return aM(e,t),null}return!(!(t=r)||"object"!=typeof t||Array.isArray(t))&&1===t.version&&"string"==typeof t.session&&"string"==typeof t.remoteConfigPath&&"string"==typeof t.remoteConfigHash&&(void 0===t.daemon||"object"==typeof t.daemon&&null!==t.daemon&&!Array.isArray(t.daemon))&&"string"==typeof t.tenant&&"string"==typeof t.runId&&(void 0===t.leaseId||"string"==typeof t.leaseId)&&(void 0===t.leaseBackend||"string"==typeof t.leaseBackend)&&"string"==typeof t.connectedAt&&"string"==typeof t.updatedAt?r:(aM(e),null)}function aS(e){let t=aN({stateDir:e.stateDir,session:e.state.session});f.mkdirSync(i.dirname(t),{recursive:!0}),aE(t,e.state),aE(aP(e.stateDir),{session:e.state.session})}function aD(e){return{baseUrl:function(e){if(!e)return;let t=new URL(e);for(let e of(t.username="",t.password="",[...t.searchParams.keys()]))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,"")}(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function a$(e){f.rmSync(aN(e),{force:!0});let t=aP(e.stateDir);a_(e.stateDir)===e.session&&f.rmSync(t,{force:!0})}function ax(e){try{return y.createHash("sha256").update(f.readFileSync(e)).digest("hex")}catch(t){throw new eg("INVALID_ARGS",`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function aN(e){return i.join(e.stateDir,"remote-connections",`${function(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,"_");if(!t)return"default";if(t===e)return t;let r=y.createHash("sha256").update(e).digest("hex").slice(0,8);return`${t}-${r}`}(e.session)}.json`)}function aP(e){return i.join(e,"remote-connections",".active-session.json")}function aL(e){let t=a_(e.stateDir);return t?aA({stateDir:e.stateDir,session:t}):null}function a_(e){let t=aP(e);if(f.existsSync(t))try{let e=JSON.parse(f.readFileSync(t,"utf8"));return"string"==typeof e.session?e.session:void 0}catch{return}}function aE(e,t){f.writeFileSync(e,`${JSON.stringify(t,null,2)}
27
- `,{encoding:"utf8",mode:384}),f.chmodSync(e,384)}function aM(e,t){Q({level:"warn",phase:"remote_connection_state_invalid",data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),a$(e)}let aR=new Set(["connect","connection","close","devices","disconnect","ensure-simulator","metro","session"]),aT=new Set(["open"]);async function aC(e){let t,r,{command:a,flags:n,client:o}=e;if(!n.remoteConfig)return{flags:n,runtime:e.runtime};let s=en(n.stateDir).baseDir,i=ak({configPath:n.remoteConfig,cwd:process.cwd(),env:process.env}),l={...function(e){let t={};for(let r of ab){let a=e[r.key];void 0!==a&&(t[r.key]=a)}return t}(i.profile),...n,remoteConfig:i.resolvedPath},c=aA({stateDir:s,session:l.session??"default"});if(c&&c.remoteConfigPath!==i.resolvedPath)throw new eg("INVALID_ARGS","A different remote connection is already active for this session. Run connect --force or disconnect before using a different --remote-config.",{session:c.session,activeRemoteConfig:c.remoteConfigPath,requestedRemoteConfig:i.resolvedPath});let u=c??function(e,t){if(!e.tenant)throw new eg("INVALID_ARGS","remote command requires tenant in remote config or via --tenant <id>.");if(!e.runId)throw new eg("INVALID_ARGS","remote command requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new eg("INVALID_ARGS","remote command requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let r=new Date().toISOString();return{version:1,session:e.session??"default",remoteConfigPath:t,remoteConfigHash:ax(t),daemon:aD(e),tenant:e.tenant,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend??aj(e),platform:e.platform,target:e.target,connectedAt:r,updatedAt:r}}(l,i.resolvedPath),d={...l,session:u.session},p=function(e,t){if(e)return aV(e,t)?e:void 0}(u.runtime,d.platform)??e.runtime,m=u,f=!c;if(h=a,!aR.has(h)){let e=u.leaseBackend??function(e,t){let r=aj(e);if(r)return r;throw new eg("INVALID_ARGS",`${t} requires --platform ios|android or --lease-backend when the remote connection has not resolved a lease yet.`)}(n,a);var h,g,y,w,b,v=u,I=n,k=e;if(v.leaseBackend&&v.leaseBackend!==k)throw new eg("INVALID_ARGS","Active remote connection is already bound to a different lease backend. Re-run connect --force to replace it.",{session:v.session,leaseBackend:v.leaseBackend});if(v.platform&&I.platform&&v.platform!==I.platform)throw new eg("INVALID_ARGS","Active remote connection is already bound to a different platform. Re-run connect --force to replace it.",{session:v.session,platform:v.platform});if(v.target&&I.target&&v.target!==I.target)throw new eg("INVALID_ARGS","Active remote connection is already bound to a different target. Re-run connect --force to replace it.",{session:v.session,target:v.target});let t=await aG(o,m,e);d.leaseId=t.leaseId,d.leaseBackend=e,d.platform=m.platform??d.platform,d.target=m.target??d.target,(m.leaseId!==t.leaseId||m.leaseBackend!==e)&&(m={...m,leaseId:t.leaseId,leaseBackend:e,platform:m.platform??n.platform,target:m.target??n.target,updatedAt:new Date().toISOString()},f=!0)}if(g=a,y=e.batchSteps,(aT.has(g)||"batch"===g&&y&&y.some(e=>{let t=e.command.trim().toLowerCase();return aT.has(t)&&void 0===e.runtime}))&&aB(d)&&(!m.leaseId&&d.leaseId&&(m={...m,leaseId:d.leaseId,leaseBackend:d.leaseBackend}),e.forceRuntimePrepare||!p||!aV(p,d.platform))){if(!m.leaseId)throw new eg("INVALID_ARGS",`${a} requires a resolved remote lease before Metro runtime can be prepared.`);let e=await aO(d,o,u.remoteConfigPath,u.session,{tenantId:u.tenant,runId:u.runId,leaseId:m.leaseId});p=e.runtime;let n=(w=m.metro,b=e.cleanup,w?.projectRoot!==b?.projectRoot||w?.profileKey!==b?.profileKey||w?.consumerKey!==b?.consumerKey);t=n?m.metro:void 0,r=n?e.cleanup:void 0,m={...m,runtime:e.runtime,metro:e.cleanup,updatedAt:new Date().toISOString()},f=!0}if(f)try{aS({stateDir:s,state:m})}catch(e){throw await aU(r),e}return await aU(t),{flags:{...d,session:m.session,leaseId:m.leaseId,leaseBackend:m.leaseBackend,platform:m.platform??d.platform,target:m.target??d.target},runtime:p}}async function aO(e,t,r,a,n){if(!e.metroProjectRoot&&!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)return{};if("ios"!==e.platform&&"android"!==e.platform)throw new eg("INVALID_ARGS",'Deferred Metro preparation requires platform "ios" or "android".');if(!e.metroPublicBaseUrl)throw new eg("INVALID_ARGS","Deferred Metro preparation requires metroPublicBaseUrl when Metro settings are provided.");let o=await t.metro.prepare({projectRoot:e.metroProjectRoot,kind:e.metroKind,publicBaseUrl:e.metroPublicBaseUrl,proxyBaseUrl:e.metroProxyBaseUrl,bearerToken:e.metroBearerToken,bridgeScope:n,launchUrl:e.launchUrl,companionProfileKey:r,companionConsumerKey:a,port:e.metroPreparePort,listenHost:e.metroListenHost,statusHost:e.metroStatusHost,startupTimeoutMs:e.metroStartupTimeoutMs,probeTimeoutMs:e.metroProbeTimeoutMs,reuseExisting:!e.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!e.metroNoInstallDeps&&void 0,runtimeFilePath:e.metroRuntimeFile});return{runtime:"ios"===e.platform?o.iosRuntime:o.androidRuntime,cleanup:e.metroProxyBaseUrl?{projectRoot:o.projectRoot,profileKey:r,consumerKey:a}:void 0}}async function aU(e){if(e)try{await aw(e)}catch{}}async function aF(e,t){if(t.leaseId)try{await e.leases.release({tenant:t.tenant,runId:t.runId,leaseId:t.leaseId,daemonBaseUrl:t.daemon?.baseUrl,daemonTransport:t.daemon?.transport,daemonServerMode:t.daemon?.serverMode})}catch{}}function aj(e){return e.leaseBackend?e.leaseBackend:"android"===e.platform?"android-instance":"ios"===e.platform?"ios-instance":void 0}function aB(e){return!!(e.metroPublicBaseUrl||e.metroProxyBaseUrl||e.metroProjectRoot||e.metroKind)}function aV(e,t){return!e.platform||!t||"ios"!==t&&"android"!==t||e.platform===t}async function aG(e,t,r){if(t.leaseId&&t.leaseBackend===r){let a=await aq(e,t.leaseId,{tenant:t.tenant,runId:t.runId,leaseBackend:r});if(a)return a}return await e.leases.allocate({tenant:t.tenant,runId:t.runId,leaseBackend:r})}async function aq(e,t,r){try{return await e.leases.heartbeat({tenant:r.tenant,runId:r.runId,leaseId:t,leaseBackend:r.leaseBackend})}catch(e){var a;if((a=e)instanceof eg&&"UNAUTHORIZED"===a.code&&(a.details?.reason==="LEASE_NOT_FOUND"||a.details?.reason==="LEASE_EXPIRED"||a.details?.reason==="LEASE_REVOKED"))return;throw e}}function aH(e){return{platform:e.platform,target:e.target,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist}}function aK(e,t,r){var a;if(e.json)return void e4({success:!0,data:t});let n=r?.();n&&(a=n,process.stdout.write(a.endsWith("\n")?a:`${a}
28
- `))}function aJ(e,t){aK(e,t,()=>U(t))}let az=async({positionals:e,flags:t,client:r})=>{if("list"!==(e[0]??"list"))throw new eg("INVALID_ARGS","session only supports list");let a={sessions:(await r.sessions.list()).map(S)};return aK(t,a,()=>JSON.stringify(a,null,2)),!0},aW=async({flags:e,client:t})=>{let r=await t.devices.list(aH(e));return aK(e,{devices:r.map(B)},()=>r.map(aX).join("\n")),!0};function aX(e){let t=e.kind?` ${e.kind}`:"",r=e.target?` target=${e.target}`:"",a="boolean"==typeof e.booted?` booted=${e.booted}`:"";return`${e.name} (${e.platform}${t}${r})${a}`}let aY=async({flags:e,client:t})=>{if(!e.device)throw new eg("INVALID_ARGS","ensure-simulator requires --device <name>");let r=await t.simulators.ensure({device:e.device,runtime:e.runtime,boot:e.boot,reuseExisting:e.reuseExisting,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet});return aK(e,F(r),()=>{let e=r.created?"Created":"Reused",t=r.booted?" (booted)":"";return r.runtime?`${e}: ${r.device} ${r.udid}${t}
29
- Runtime: ${r.runtime}`:`${e}: ${r.device} ${r.udid}${t}`}),!0},aZ=async({positionals:e,flags:t,client:r})=>{if("prepare"!==(e[0]??"").toLowerCase())throw new eg("INVALID_ARGS","metro only supports prepare");if(!t.metroPublicBaseUrl)throw new eg("INVALID_ARGS","metro prepare requires --public-base-url <url>.");let a=await r.metro.prepare({projectRoot:t.metroProjectRoot,kind:t.metroKind,port:t.metroPreparePort,listenHost:t.metroListenHost,statusHost:t.metroStatusHost,publicBaseUrl:t.metroPublicBaseUrl,proxyBaseUrl:t.metroProxyBaseUrl,bearerToken:t.metroBearerToken,bridgeScope:t.tenant&&t.runId&&t.leaseId?{tenantId:t.tenant,runId:t.runId,leaseId:t.leaseId}:void 0,startupTimeoutMs:t.metroStartupTimeoutMs,probeTimeoutMs:t.metroProbeTimeoutMs,reuseExisting:!t.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!t.metroNoInstallDeps&&void 0,runtimeFilePath:t.metroRuntimeFile});return aK(t,a,()=>JSON.stringify(a,null,2)),!0},aQ=async({flags:e,client:t})=>{let r=await t.apps.list({...aH(e),appsFilter:e.appsFilter});return aK(e,{apps:r},()=>r.join("\n")),!0},a0=async({positionals:e,flags:t,client:r})=>{let a=O(await a3("install",e,t,r));return aJ(t,a),!0},a1=async({positionals:e,flags:t,client:r})=>{let a=O(await a3("reinstall",e,t,r));return aJ(t,a),!0},a2=async({positionals:e,flags:t,client:r})=>{let a=ei(await a5(e,t,r));return aJ(t,a),!0};async function a3(e,t,r,a){let n=t[0],o=t[1];if(!n||!o)throw new eg("INVALID_ARGS",`${e} requires: ${e} <app> <path-to-app-binary>`);let s={app:n,appPath:o,...aH(r)};return"install"===e?await a.apps.install(s):await a.apps.reinstall(s)}async function a5(e,t,r){let a=e[0]?.trim();if(!a)throw new eg("INVALID_ARGS","install-from-source requires: install-from-source <url>");if(e.length>1)throw new eg("INVALID_ARGS","install-from-source accepts exactly one positional argument: <url>");return await r.apps.installFromSource({...aH(t),retainPaths:t.retainPaths,retentionMs:t.retentionMs,source:{kind:"url",url:a,headers:function(e){if(!e||0===e.length)return;let t={};for(let r of e){let e=r.indexOf(":");if(e<=0)throw new eg("INVALID_ARGS",`Invalid --header value "${r}". Expected "name:value".`);let a=r.slice(0,e).trim(),n=r.slice(e+1).trim();if(!a)throw new eg("INVALID_ARGS",`Invalid --header value "${r}". Header name cannot be empty.`);t[a]=n}return t}(t.header)}})}let a8=async({positionals:e,flags:t,client:r})=>{let a=R(await r.apps.open({app:e[0],url:e[1],surface:t.surface,activity:t.activity,relaunch:t.relaunch,saveScript:t.saveScript,noRecord:t.noRecord,...aH(t)}));return aJ(t,a),!0},a4=async({positionals:e,flags:t,client:r})=>{let a=Z(e[0]?await r.apps.close({app:e[0],shutdown:t.shutdown}):await r.sessions.close({shutdown:t.shutdown}));return aJ(t,a),!0},a6=async({flags:e,client:t})=>{var r,a,n,o;if(!e.remoteConfig)throw new eg("INVALID_ARGS","connect requires --remote-config <path>.");let s=e.tenant,i=e.runId;if(!s)throw new eg("INVALID_ARGS","connect requires tenant in remote config or via --tenant <id>.");if(!i)throw new eg("INVALID_ARGS","connect requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new eg("INVALID_ARGS","connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let l=en(e.stateDir).baseDir,c=e.session?null:aL({stateDir:l}),u=e.session??c?.session??function(e){for(let t=0;t<8;t+=1){let t=`adc-${y.randomBytes(3).toString("hex")}`;if(!aA({stateDir:e,session:t}))return t}return`adc-${Date.now().toString(36)}-${y.randomBytes(2).toString("hex")}`}(l),d=ak({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env}),p=ax(d.resolvedPath),m=aD(e),f=c?.session===u?c:aA({stateDir:l,session:u});if(f&&(r=f,a={flags:e,session:u,remoteConfigPath:d.resolvedPath,remoteConfigHash:p,desiredLeaseBackend:aj(e),daemon:m},r.remoteConfigPath!==a.remoteConfigPath||r.remoteConfigHash!==a.remoteConfigHash||r.session!==a.session||r.tenant!==a.flags.tenant||r.runId!==a.flags.runId||void 0!==a.desiredLeaseBackend&&r.leaseBackend!==a.desiredLeaseBackend||void 0!==a.flags.platform&&r.platform!==a.flags.platform||void 0!==a.flags.target&&r.target!==a.flags.target||(n=r.daemon,o=a.daemon,(n?.baseUrl??void 0)!==(o?.baseUrl??void 0)||(n?.transport??void 0)!==(o?.transport??void 0)||(n?.serverMode??void 0)!==(o?.serverMode??void 0)))&&!e.force)throw new eg("INVALID_ARGS","A different remote connection is already active for this session. Re-run connect with --force to replace it.",{session:u,remoteConfig:f.remoteConfigPath});let h=new Date().toISOString(),g={version:1,session:u,remoteConfigPath:d.resolvedPath,remoteConfigHash:p,daemon:m,tenant:s,runId:i,leaseId:f&&!e.force?f.leaseId:void 0,leaseBackend:f&&!e.force?f.leaseBackend:aj(e),platform:e.platform??(f&&!e.force?f.platform:void 0),target:e.target??(f&&!e.force?f.target:void 0),runtime:f&&!e.force?f.runtime:void 0,metro:f&&!e.force?f.metro:void 0,connectedAt:f&&!e.force?f.connectedAt:h,updatedAt:h};aS({stateDir:l,state:g}),f&&e.force&&(await aU(f.metro),await aF(t,f));let w=function(e,t){if(!t.runtime&&(aB(e)||nt(t.remoteConfigPath)))return ne(t.remoteConfigPath)}(e,g);return aK(e,nr(g,w),()=>[`Connected remote session "${u}" tenant "${s}" run "${i}" ${g.leaseId?`lease ${g.leaseId}`:"lease pending"}`,w?.message].filter(e=>!!e).join("\n")),!0},a7=async({flags:e,client:t})=>{let r=e.session??"default",a=en(e.stateDir).baseDir,n=aA({stateDir:a,session:r})??(e.session?null:aL({stateDir:a}));if(!n)return aK(e,{connected:!1,session:r},()=>`No remote connection for "${r}".`),!0;let o=n.session;try{await t.sessions.close({shutdown:e.shutdown})}catch{}await aU(n.metro);let s=!1;if(n.leaseId)try{s=(await t.leases.release({tenant:n.tenant,runId:n.runId,leaseId:n.leaseId})).released}catch{}return a$({stateDir:a,session:o}),aK(e,{connected:!1,session:o,released:s},()=>`Disconnected remote session "${o}".`),!0},a9=async({positionals:e,flags:t})=>{if("status"!==e[0])throw new eg("INVALID_ARGS","connection accepts only: status");let r=t.session??"default",a=en(t.stateDir).baseDir,n=aA({stateDir:a,session:r})??(t.session?null:aL({stateDir:a}));if(!n)return aK(t,{connected:!1,session:r},()=>`No remote connection for "${r}".`),!0;let o=function(e){if(!e.runtime&&nt(e.remoteConfigPath))return ne(e.remoteConfigPath)}(n);return aK(t,nr(n,o),()=>[`Connected remote session "${n.session}".`,`tenant=${n.tenant} runId=${n.runId} leaseId=${n.leaseId??"pending"} backend=${n.leaseBackend??"pending"}`,`remoteConfig=${n.remoteConfigPath}`,n.runtime?"metro=prepared":"metro=not-prepared",o?.message].filter(e=>!!e).join("\n")),!0};function ne(e){let t=`agent-device metro prepare --remote-config ${e}`;return{status:"deferred",nextStep:t,message:`Metro runtime is not prepared yet; it will be prepared automatically on first open, or run "${t}" to inspect it before launch.`}}function nt(e){try{let t=ak({configPath:e,cwd:process.cwd(),env:process.env}).profile;return!!(t.metroPublicBaseUrl||t.metroProxyBaseUrl||t.metroProjectRoot||t.metroKind)}catch{return!1}}function nr(e,t){return{connected:!0,session:e.session,tenant:e.tenant,runId:e.runId,leaseAllocated:!!e.leaseId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,platform:e.platform,target:e.target,remoteConfig:e.remoteConfigPath,remoteConfigHash:e.remoteConfigHash,daemonBaseUrlFingerprint:function(e){if(e)return y.createHash("sha256").update(e).digest("hex").slice(0,12)}(e.daemon?.baseUrl),metro:e.metro?{prepared:!0,projectRoot:e.metro.projectRoot}:{prepared:!1},...t?{runtimePreparation:t}:{},connectedAt:e.connectedAt,updatedAt:e.updatedAt}}let na=async({flags:e,client:t})=>{let r=D(await t.capture.snapshot({...aH(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}));return aK(e,r,()=>(function(e,t={}){var r,a,n;let o,s=e.nodes,i=Array.isArray(s)?s:[],l="string"==typeof e.backend?e.backend:void 0,c=t.raw||"macos-helper"===l?null:G(i),u=!!e.truncated,d="string"==typeof e.appName?e.appName:void 0,p="string"==typeof e.appBundleId?e.appBundleId:void 0,m=[];d&&m.push(`Page: ${d}`),p&&m.push(`App: ${p}`);let f=c?.nodes??i,h=t.raw||"macos-helper"===l?null:function(e,t,r,a){let n=e.visibility;if(n&&"object"==typeof n&&"boolean"==typeof n.partial&&"number"==typeof n.visibleNodeCount&&"number"==typeof n.totalNodeCount&&Array.isArray(n.reasons))return{partial:n.partial,visibleNodeCount:n.visibleNodeCount,totalNodeCount:n.totalNodeCount,reasons:n.reasons.filter(e=>"string"==typeof e)};let o=t?.hiddenCount??0,s=!!t&&t.nodes.some(e=>e.hiddenContentAbove||e.hiddenContentBelow);return o>0?{partial:!0,visibleNodeCount:r,totalNodeCount:a,reasons:["offscreen-nodes"]}:s?{partial:!0,visibleNodeCount:r,totalNodeCount:r,reasons:[]}:null}(e,c,f.length,i.length),g=h?.partial?h.totalNodeCount>h.visibleNodeCount?`Snapshot: ${h.visibleNodeCount} visible nodes (${h.totalNodeCount} total)${u?" (truncated)":""}`:`Snapshot: ${h.visibleNodeCount} visible nodes${u?" (truncated)":""}`:`Snapshot: ${i.length} nodes${u?" (truncated)":""}`,y=m.length>0?`${m.join("\n")}
30
- `:"",w=(r=e,a=i,n=t,o=ts(r),!n.raw&&function(e){if(e.length<20)return!1;let t=new Map;for(let r of e){let e=(r.type??"").toLowerCase(),a=J(r).trim().toLowerCase();if(!a)continue;let n=`${e}|${a}`;t.set(n,(t.get(n)??0)+1)}let r=0;for(let e of t.values())e>1&&(r+=e);return r>=8}(a)&&o.push("Warning: possible repeated nav subtree detected."),o),b=w.length>0?`${w.join("\n")}
31
- `:"";if(0===i.length)return`${y}${g}
32
- ${b}`;if(t.raw){let e=i.map(e=>JSON.stringify(e));return`${y}${g}
15
+ ${a}
16
+ `);function eg(e){return ea.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function eh(e,t){return ey(e,t.map(e=>({label:e.usageLabel??"",description:e.usageDescription??""})))}function ey(e,t){if(0===t.length)return`${e}
17
+ (none)`;let s=Math.max(...t.map(e=>e.label.length))+2,r=[e];for(let e of t)r.push(` ${e.label.padEnd(s)}${e.description}`);return r.join("\n")}function ew(e,t){return 0===t.length?`${e}
18
+ (none)`:[e,...t.map(e=>` ${e}`)].join("\n")}let eb=new Set(["config","remoteConfig","help","version","batchSteps"]),ev={iosSimulatorDeviceSet:["IOS_SIMULATOR_DEVICE_SET"],androidDeviceAllowlist:["ANDROID_DEVICE_ALLOWLIST"],metroBearerToken:["AGENT_DEVICE_PROXY_TOKEN"]},ek=function(){let e=new Map;for(let t of ea){let s=e.get(t.key);s?s.push(t):e.set(t.key,[t])}let t=new Map;for(let e of ei)t.set(e,new Set(["*"]));for(let e of ed()){let s=ep(e);if(s)for(let r of s.allowedFlags){let s=t.get(r);s&&s.has("*")||(s?s.add(e):t.set(r,new Set([e])))}}return[...e.entries()].map(([e,s])=>({key:e,flagDefinitions:s,config:{enabled:!eb.has(e),key:e},env:{names:[D(e),...ev[e]??[]]},supportsCommand(s){let r=t.get(e);return!!r&&(!!r.has("*")||!!s&&r.has(s))}})).sort((e,t)=>e.key.localeCompare(t.key))}(),eD=new Map(ek.map(e=>[e.key,e]));function e$(e,t){return eD.get(e)?.supportsCommand(t)??!1}function eS(e){let t=e.flagDefinitions.find(e=>void 0===e.setValue);if(t)return t;let s=function(e){let t=e.flagDefinitions[0];if(!t)throw Error(`Missing flag definition for option ${e.key}`);return t}(e);if("enum"===s.type){let t=e.flagDefinitions.map(e=>e.setValue).filter(e=>void 0!==e);return{...s,setValue:void 0,enumValues:t}}return s}function eI(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function eA(e){return e.replace(/^-+/,"")}function ex(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?eI(e):[e,void 0];return void 0!==ec.get(t)}function eL(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}function eR(e){process.stdout.write(`${JSON.stringify(e,null,2)}
19
+ `)}function eN(e,t={}){let s=e instanceof I?S(e):e;process.stderr.write(`Error (${s.code}): ${s.message}
20
+ `),s.hint&&process.stderr.write(`Hint: ${s.hint}
21
+ `),s.diagnosticId&&process.stderr.write(`Diagnostic ID: ${s.diagnosticId}
22
+ `),s.logPath&&process.stderr.write(`Diagnostics Log: ${s.logPath}
23
+ `),t.showDetails&&s.details&&process.stderr.write(`${JSON.stringify(s.details,null,2)}
24
+ `)}function eC(e){return`x=${e.x},y=${e.y},w=${e.width},h=${e.height}`}function e_(e){return e>0?`+${e}`:String(e)}function eP(e){let t=e.nearestText?` near ${JSON.stringify(e.nearestText)}`:"",s=e.regionIndex?` r${e.regionIndex}`:"";return`${e.likelyKind}${t}${s}`}function eO(e){return e.min===e.max?e_(e.min):`${e_(e.min)}..${e_(e.max)}`}function eM(e){let t=process.cwd(),s=i.relative(t,e);return""!==s&&(s.startsWith("..")||i.isAbsolute(s))?e:""===s?".":`.${i.sep}${s}`}function eE(e){return"number"==typeof e&&Number.isFinite(e)?e:0}function eF(){let e=process.env.FORCE_COLOR;return"string"==typeof e?"0"!==e:"string"!=typeof process.env.NO_COLOR&&!!process.stdout.isTTY}function ej(e,t){return t?l("dim",e):e}function eT(e){let t=e.warnings;return Array.isArray(t)?t.filter(e=>"string"==typeof e&&e.length>0):[]}function eV(e){var t;let s="scroll-area"===(t=e.type)||"list"===t||"collection"===t||"table"===t?t:null;if(!s)return[];let r=[];if(e.node.hiddenContentAbove&&r.push(`[content above ${s} hidden]`),e.node.hiddenContentBelow&&r.push(`[content below ${s} hidden]`),0===r.length)return[];let o=" ".repeat(e.depth+1);return r.map(e=>`${o}${e}`)}function eB(e){var t;let s,r=eK(e);if(!u.existsSync(r))return null;try{s=JSON.parse(u.readFileSync(r,"utf8"))}catch(t){return eY(e,t),null}return!(!(t=s)||"object"!=typeof t||Array.isArray(t))&&1===t.version&&"string"==typeof t.session&&"string"==typeof t.remoteConfigPath&&"string"==typeof t.remoteConfigHash&&(void 0===t.daemon||"object"==typeof t.daemon&&null!==t.daemon&&!Array.isArray(t.daemon))&&"string"==typeof t.tenant&&"string"==typeof t.runId&&(void 0===t.leaseId||"string"==typeof t.leaseId)&&(void 0===t.leaseBackend||"string"==typeof t.leaseBackend)&&"string"==typeof t.connectedAt&&"string"==typeof t.updatedAt?s:(eY(e),null)}function eU(e){let t=eK({stateDir:e.stateDir,session:e.state.session});u.mkdirSync(i.dirname(t),{recursive:!0}),eX(t,e.state),eX(eJ(e.stateDir),{session:e.state.session})}function eG(e){return{baseUrl:function(e){if(!e)return;let t=new URL(e);for(let e of(t.username="",t.password="",[...t.searchParams.keys()]))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,"")}(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function eq(e){u.rmSync(eK(e),{force:!0});let t=eJ(e.stateDir);eW(e.stateDir)===e.session&&u.rmSync(t,{force:!0})}function eH(e){try{return p.createHash("sha256").update(u.readFileSync(e)).digest("hex")}catch(t){throw new I("INVALID_ARGS",`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function eK(e){return i.join(e.stateDir,"remote-connections",`${function(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,"_");if(!t)return"default";if(t===e)return t;let s=p.createHash("sha256").update(e).digest("hex").slice(0,8);return`${t}-${s}`}(e.session)}.json`)}function eJ(e){return i.join(e,"remote-connections",".active-session.json")}function ez(e){let t=eW(e.stateDir);return t?eB({stateDir:e.stateDir,session:t}):null}function eW(e){let t=eJ(e);if(u.existsSync(t))try{let e=JSON.parse(u.readFileSync(t,"utf8"));return"string"==typeof e.session?e.session:void 0}catch{return}}function eX(e,t){u.writeFileSync(e,`${JSON.stringify(t,null,2)}
25
+ `,{encoding:"utf8",mode:384}),u.chmodSync(e,384)}function eY(e,t){F({level:"warn",phase:"remote_connection_state_invalid",data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),eq(e)}let eZ=new Set(["connect","connection","close","devices","disconnect","ensure-simulator","metro","session"]),eQ=new Set(["open"]);async function e0(e){let t,s,{command:r,flags:o,client:n}=e;if(!o.remoteConfig)return{flags:o,runtime:e.runtime};let a=V(o.stateDir).baseDir,i=w({configPath:o.remoteConfig,cwd:process.cwd(),env:process.env}),l={...function(e){let t={};for(let s of v){let r=e[s.key];void 0!==r&&(t[s.key]=r)}return t}(i.profile),...o,remoteConfig:i.resolvedPath},c=eB({stateDir:a,session:l.session??"default"});if(c&&c.remoteConfigPath!==i.resolvedPath)throw new I("INVALID_ARGS","A different remote connection is already active for this session. Run connect --force or disconnect before using a different --remote-config.",{session:c.session,activeRemoteConfig:c.remoteConfigPath,requestedRemoteConfig:i.resolvedPath});let u=c??function(e,t){if(!e.tenant)throw new I("INVALID_ARGS","remote command requires tenant in remote config or via --tenant <id>.");if(!e.runId)throw new I("INVALID_ARGS","remote command requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new I("INVALID_ARGS","remote command requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let s=new Date().toISOString();return{version:1,session:e.session??"default",remoteConfigPath:t,remoteConfigHash:eH(t),daemon:eG(e),tenant:e.tenant,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend??e3(e),platform:e.platform,target:e.target,connectedAt:s,updatedAt:s}}(l,i.resolvedPath),p={...l,session:u.session},d=function(e,t){if(e)return e4(e,t)?e:void 0}(u.runtime,p.platform)??e.runtime,m=u,f=!c;if(g=r,!eZ.has(g)){let e=u.leaseBackend??function(e,t){let s=e3(e);if(s)return s;throw new I("INVALID_ARGS",`${t} requires --platform ios|android or --lease-backend when the remote connection has not resolved a lease yet.`)}(o,r);var g,h,y,b,k,D=u,$=o,S=e;if(D.leaseBackend&&D.leaseBackend!==S)throw new I("INVALID_ARGS","Active remote connection is already bound to a different lease backend. Re-run connect --force to replace it.",{session:D.session,leaseBackend:D.leaseBackend});if(D.platform&&$.platform&&D.platform!==$.platform)throw new I("INVALID_ARGS","Active remote connection is already bound to a different platform. Re-run connect --force to replace it.",{session:D.session,platform:D.platform});if(D.target&&$.target&&D.target!==$.target)throw new I("INVALID_ARGS","Active remote connection is already bound to a different target. Re-run connect --force to replace it.",{session:D.session,target:D.target});let t=await e6(n,m,e);p.leaseId=t.leaseId,p.leaseBackend=e,p.platform=m.platform??p.platform,p.target=m.target??p.target,(m.leaseId!==t.leaseId||m.leaseBackend!==e)&&(m={...m,leaseId:t.leaseId,leaseBackend:e,platform:m.platform??o.platform,target:m.target??o.target,updatedAt:new Date().toISOString()},f=!0)}if(h=r,y=e.batchSteps,(eQ.has(h)||"batch"===h&&y&&y.some(e=>{let t=e.command.trim().toLowerCase();return eQ.has(t)&&void 0===e.runtime}))&&e5(p)&&(!m.leaseId&&p.leaseId&&(m={...m,leaseId:p.leaseId,leaseBackend:p.leaseBackend}),e.forceRuntimePrepare||!d||!e4(d,p.platform))){if(!m.leaseId)throw new I("INVALID_ARGS",`${r} requires a resolved remote lease before Metro runtime can be prepared.`);let e=await e1(p,n,u.remoteConfigPath,u.session,{tenantId:u.tenant,runId:u.runId,leaseId:m.leaseId});d=e.runtime;let o=(b=m.metro,k=e.cleanup,b?.projectRoot!==k?.projectRoot||b?.profileKey!==k?.profileKey||b?.consumerKey!==k?.consumerKey);t=o?m.metro:void 0,s=o?e.cleanup:void 0,m={...m,runtime:e.runtime,metro:e.cleanup,updatedAt:new Date().toISOString()},f=!0}if(f)try{eU({stateDir:a,state:m})}catch(e){throw await e2(s),e}return await e2(t),{flags:{...p,session:m.session,leaseId:m.leaseId,leaseBackend:m.leaseBackend,platform:m.platform??p.platform,target:m.target??p.target},runtime:d}}async function e1(e,t,s,r,o){if(!e.metroProjectRoot&&!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)return{};if("ios"!==e.platform&&"android"!==e.platform)throw new I("INVALID_ARGS",'Deferred Metro preparation requires platform "ios" or "android".');if(!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)throw new I("INVALID_ARGS","Deferred Metro preparation requires metroPublicBaseUrl or metroProxyBaseUrl when Metro settings are provided.");let n=await t.metro.prepare({projectRoot:e.metroProjectRoot,kind:e.metroKind,publicBaseUrl:e.metroPublicBaseUrl,proxyBaseUrl:e.metroProxyBaseUrl,bearerToken:e.metroBearerToken,bridgeScope:o,launchUrl:e.launchUrl,companionProfileKey:s,companionConsumerKey:r,port:e.metroPreparePort,listenHost:e.metroListenHost,statusHost:e.metroStatusHost,startupTimeoutMs:e.metroStartupTimeoutMs,probeTimeoutMs:e.metroProbeTimeoutMs,reuseExisting:!e.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!e.metroNoInstallDeps&&void 0,runtimeFilePath:e.metroRuntimeFile});return{runtime:"ios"===e.platform?n.iosRuntime:n.androidRuntime,cleanup:e.metroProxyBaseUrl?{projectRoot:n.projectRoot,profileKey:s,consumerKey:r}:void 0}}async function e2(e){if(e)try{await z(e)}catch{}}async function e8(e,t){if(t.leaseId)try{await e.leases.release({tenant:t.tenant,runId:t.runId,leaseId:t.leaseId,daemonBaseUrl:t.daemon?.baseUrl,daemonTransport:t.daemon?.transport,daemonServerMode:t.daemon?.serverMode})}catch{}}function e3(e){return e.leaseBackend?e.leaseBackend:"android"===e.platform?"android-instance":"ios"===e.platform?"ios-instance":void 0}function e5(e){return!!(e.metroPublicBaseUrl||e.metroProxyBaseUrl||e.metroProjectRoot||e.metroKind)}function e4(e,t){return!e.platform||!t||"ios"!==t&&"android"!==t||e.platform===t}async function e6(e,t,s){if(t.leaseId&&t.leaseBackend===s){let r=await e9(e,t.leaseId,{tenant:t.tenant,runId:t.runId,leaseBackend:s});if(r)return r}return await e.leases.allocate({tenant:t.tenant,runId:t.runId,leaseBackend:s})}async function e9(e,t,s){try{return await e.leases.heartbeat({tenant:s.tenant,runId:s.runId,leaseId:t,leaseBackend:s.leaseBackend})}catch(e){var r;if((r=e)instanceof I&&"UNAUTHORIZED"===r.code&&(r.details?.reason==="LEASE_NOT_FOUND"||r.details?.reason==="LEASE_EXPIRED"||r.details?.reason==="LEASE_REVOKED"))return;throw e}}function e7(e){return{platform:e.platform,target:e.target,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist}}function te(e,t,s){var r;if(e.json)return void eR({success:!0,data:t});let o=s?.();o&&(r=o,process.stdout.write(r.endsWith("\n")?r:`${r}
26
+ `))}function tt(e,t){te(e,t,()=>R(t))}let ts=async({positionals:e,flags:t,client:s})=>{if("list"!==(e[0]??"list"))throw new I("INVALID_ARGS","session only supports list");let r={sessions:(await s.sessions.list()).map(_)};return te(t,r,()=>JSON.stringify(r,null,2)),!0},tr=async({flags:e,client:t})=>{let s=await t.devices.list(e7(e));return te(e,{devices:s.map(K)},()=>s.map(to).join("\n")),!0};function to(e){let t=e.kind?` ${e.kind}`:"",s=e.target?` target=${e.target}`:"",r="boolean"==typeof e.booted?` booted=${e.booted}`:"";return`${e.name} (${e.platform}${t}${s})${r}`}let tn=async({flags:e,client:t})=>{if(!e.device)throw new I("INVALID_ARGS","ensure-simulator requires --device <name>");let s=await t.simulators.ensure({device:e.device,runtime:e.runtime,boot:e.boot,reuseExisting:e.reuseExisting,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet});return te(e,q(s),()=>{let e=s.created?"Created":"Reused",t=s.booted?" (booted)":"";return s.runtime?`${e}: ${s.device} ${s.udid}${t}
27
+ Runtime: ${s.runtime}`:`${e}: ${s.device} ${s.udid}${t}`}),!0},ta=async({positionals:e,flags:t,client:s})=>{if("prepare"!==(e[0]??"").toLowerCase())throw new I("INVALID_ARGS","metro only supports prepare");if(!t.metroPublicBaseUrl&&!t.metroProxyBaseUrl)throw new I("INVALID_ARGS","metro prepare requires --public-base-url <url> or --proxy-base-url <url>.");let r=await s.metro.prepare({projectRoot:t.metroProjectRoot,kind:t.metroKind,port:t.metroPreparePort,listenHost:t.metroListenHost,statusHost:t.metroStatusHost,publicBaseUrl:t.metroPublicBaseUrl,proxyBaseUrl:t.metroProxyBaseUrl,bearerToken:t.metroBearerToken,bridgeScope:t.tenant&&t.runId&&t.leaseId?{tenantId:t.tenant,runId:t.runId,leaseId:t.leaseId}:void 0,startupTimeoutMs:t.metroStartupTimeoutMs,probeTimeoutMs:t.metroProbeTimeoutMs,reuseExisting:!t.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!t.metroNoInstallDeps&&void 0,runtimeFilePath:t.metroRuntimeFile});return te(t,r,()=>JSON.stringify(r,null,2)),!0},ti=async({flags:e,client:t})=>{let s=await t.apps.list({...e7(e),appsFilter:e.appsFilter});return te(e,{apps:s},()=>s.join("\n")),!0},tl=async({positionals:e,flags:t,client:s})=>{let r=T(await tp("install",e,t,s));return tt(t,r),!0},tc=async({positionals:e,flags:t,client:s})=>{let r=T(await tp("reinstall",e,t,s));return tt(t,r),!0},tu=async({positionals:e,flags:t,client:s})=>{let r=H(await td(e,t,s));return tt(t,r),!0};async function tp(e,t,s,r){let o=t[0],n=t[1];if(!o||!n)throw new I("INVALID_ARGS",`${e} requires: ${e} <app> <path-to-app-binary>`);let a={app:o,appPath:n,...e7(s)};return"install"===e?await r.apps.install(a):await r.apps.reinstall(a)}async function td(e,t,s){let r=e[0]?.trim();if(!r)throw new I("INVALID_ARGS","install-from-source requires: install-from-source <url>");if(e.length>1)throw new I("INVALID_ARGS","install-from-source accepts exactly one positional argument: <url>");return await s.apps.installFromSource({...e7(t),retainPaths:t.retainPaths,retentionMs:t.retentionMs,source:{kind:"url",url:r,headers:function(e){if(!e||0===e.length)return;let t={};for(let s of e){let e=s.indexOf(":");if(e<=0)throw new I("INVALID_ARGS",`Invalid --header value "${s}". Expected "name:value".`);let r=s.slice(0,e).trim(),o=s.slice(e+1).trim();if(!r)throw new I("INVALID_ARGS",`Invalid --header value "${s}". Header name cannot be empty.`);t[r]=o}return t}(t.header)}})}let tm=async({positionals:e,flags:t,client:s})=>{let r=j(await s.apps.open({app:e[0],url:e[1],surface:t.surface,activity:t.activity,relaunch:t.relaunch,saveScript:t.saveScript,noRecord:t.noRecord,...e7(t)}));return tt(t,r),!0},tf=async({positionals:e,flags:t,client:s})=>{let r=O(e[0]?await s.apps.close({app:e[0],shutdown:t.shutdown}):await s.sessions.close({shutdown:t.shutdown}));return tt(t,r),!0},tg=async({flags:e,client:t})=>{var s,r,o,n;if(!e.remoteConfig)throw new I("INVALID_ARGS","connect requires --remote-config <path>.");let a=e.tenant,i=e.runId;if(!a)throw new I("INVALID_ARGS","connect requires tenant in remote config or via --tenant <id>.");if(!i)throw new I("INVALID_ARGS","connect requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new I("INVALID_ARGS","connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let l=V(e.stateDir).baseDir,c=e.session?null:ez({stateDir:l}),u=e.session??c?.session??function(e){for(let t=0;t<8;t+=1){let t=`adc-${p.randomBytes(3).toString("hex")}`;if(!eB({stateDir:e,session:t}))return t}return`adc-${Date.now().toString(36)}-${p.randomBytes(2).toString("hex")}`}(l),d=w({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env}),m=eH(d.resolvedPath),f=eG(e),g=c?.session===u?c:eB({stateDir:l,session:u});if(g&&(s=g,r={flags:e,session:u,remoteConfigPath:d.resolvedPath,remoteConfigHash:m,desiredLeaseBackend:e3(e),daemon:f},s.remoteConfigPath!==r.remoteConfigPath||s.remoteConfigHash!==r.remoteConfigHash||s.session!==r.session||s.tenant!==r.flags.tenant||s.runId!==r.flags.runId||void 0!==r.desiredLeaseBackend&&s.leaseBackend!==r.desiredLeaseBackend||void 0!==r.flags.platform&&s.platform!==r.flags.platform||void 0!==r.flags.target&&s.target!==r.flags.target||(o=s.daemon,n=r.daemon,(o?.baseUrl??void 0)!==(n?.baseUrl??void 0)||(o?.transport??void 0)!==(n?.transport??void 0)||(o?.serverMode??void 0)!==(n?.serverMode??void 0)))&&!e.force)throw new I("INVALID_ARGS","A different remote connection is already active for this session. Re-run connect with --force to replace it.",{session:u,remoteConfig:g.remoteConfigPath});let h=new Date().toISOString(),y={version:1,session:u,remoteConfigPath:d.resolvedPath,remoteConfigHash:m,daemon:f,tenant:a,runId:i,leaseId:g&&!e.force?g.leaseId:void 0,leaseBackend:g&&!e.force?g.leaseBackend:e3(e),platform:e.platform??(g&&!e.force?g.platform:void 0),target:e.target??(g&&!e.force?g.target:void 0),runtime:g&&!e.force?g.runtime:void 0,metro:g&&!e.force?g.metro:void 0,connectedAt:g&&!e.force?g.connectedAt:h,updatedAt:h};eU({stateDir:l,state:y}),g&&e.force&&(await e2(g.metro),await e8(t,g));let b=function(e,t){if(!t.runtime&&(e5(e)||tb(t.remoteConfigPath)))return tw(t.remoteConfigPath)}(e,y);return te(e,tv(y,b),()=>[`Connected remote session "${u}" tenant "${a}" run "${i}" ${y.leaseId?`lease ${y.leaseId}`:"lease pending"}`,b?.message].filter(e=>!!e).join("\n")),!0},th=async({flags:e,client:t})=>{let s=e.session??"default",r=V(e.stateDir).baseDir,o=eB({stateDir:r,session:s})??(e.session?null:ez({stateDir:r}));if(!o)return te(e,{connected:!1,session:s},()=>`No remote connection for "${s}".`),!0;let n=o.session;try{await t.sessions.close({shutdown:e.shutdown})}catch{}await e2(o.metro);let a=!1;if(o.leaseId)try{a=(await t.leases.release({tenant:o.tenant,runId:o.runId,leaseId:o.leaseId})).released}catch{}return eq({stateDir:r,session:n}),te(e,{connected:!1,session:n,released:a},()=>`Disconnected remote session "${n}".`),!0},ty=async({positionals:e,flags:t})=>{if("status"!==e[0])throw new I("INVALID_ARGS","connection accepts only: status");let s=t.session??"default",r=V(t.stateDir).baseDir,o=eB({stateDir:r,session:s})??(t.session?null:ez({stateDir:r}));if(!o)return te(t,{connected:!1,session:s},()=>`No remote connection for "${s}".`),!0;let n=function(e){if(!e.runtime&&tb(e.remoteConfigPath))return tw(e.remoteConfigPath)}(o);return te(t,tv(o,n),()=>[`Connected remote session "${o.session}".`,`tenant=${o.tenant} runId=${o.runId} leaseId=${o.leaseId??"pending"} backend=${o.leaseBackend??"pending"}`,`remoteConfig=${o.remoteConfigPath}`,o.runtime?"metro=prepared":"metro=not-prepared",n?.message].filter(e=>!!e).join("\n")),!0};function tw(e){let t=`agent-device metro prepare --remote-config ${e}`;return{status:"deferred",nextStep:t,message:`Metro runtime is not prepared yet; it will be prepared automatically on first open, or run "${t}" to inspect it before launch.`}}function tb(e){try{let t=w({configPath:e,cwd:process.cwd(),env:process.env}).profile;return!!(t.metroPublicBaseUrl||t.metroProxyBaseUrl||t.metroProjectRoot||t.metroKind)}catch{return!1}}function tv(e,t){return{connected:!0,session:e.session,tenant:e.tenant,runId:e.runId,leaseAllocated:!!e.leaseId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,platform:e.platform,target:e.target,remoteConfig:e.remoteConfigPath,remoteConfigHash:e.remoteConfigHash,daemonBaseUrlFingerprint:function(e){if(e)return p.createHash("sha256").update(e).digest("hex").slice(0,12)}(e.daemon?.baseUrl),metro:e.metro?{prepared:!0,projectRoot:e.metro.projectRoot}:{prepared:!1},...t?{runtimePreparation:t}:{},connectedAt:e.connectedAt,updatedAt:e.updatedAt}}let tk=async({flags:e,client:t})=>{let s=P(await t.capture.snapshot({...e7(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}));return te(e,s,()=>(function(e,t={}){var s,r,o;let n,a=e.nodes,i=Array.isArray(a)?a:[],l="string"==typeof e.backend?e.backend:void 0,c=t.raw||"macos-helper"===l?null:A(i),u=!!e.truncated,p="string"==typeof e.appName?e.appName:void 0,d="string"==typeof e.appBundleId?e.appBundleId:void 0,m=[];p&&m.push(`Page: ${p}`),d&&m.push(`App: ${d}`);let f=c?.nodes??i,g=t.raw||"macos-helper"===l?null:function(e,t,s,r){let o=e.visibility;if(o&&"object"==typeof o&&"boolean"==typeof o.partial&&"number"==typeof o.visibleNodeCount&&"number"==typeof o.totalNodeCount&&Array.isArray(o.reasons))return{partial:o.partial,visibleNodeCount:o.visibleNodeCount,totalNodeCount:o.totalNodeCount,reasons:o.reasons.filter(e=>"string"==typeof e)};let n=t?.hiddenCount??0,a=!!t&&t.nodes.some(e=>e.hiddenContentAbove||e.hiddenContentBelow);return n>0?{partial:!0,visibleNodeCount:s,totalNodeCount:r,reasons:["offscreen-nodes"]}:a?{partial:!0,visibleNodeCount:s,totalNodeCount:s,reasons:[]}:null}(e,c,f.length,i.length),h=g?.partial?g.totalNodeCount>g.visibleNodeCount?`Snapshot: ${g.visibleNodeCount} visible nodes (${g.totalNodeCount} total)${u?" (truncated)":""}`:`Snapshot: ${g.visibleNodeCount} visible nodes${u?" (truncated)":""}`:`Snapshot: ${i.length} nodes${u?" (truncated)":""}`,y=m.length>0?`${m.join("\n")}
28
+ `:"",w=(s=e,r=i,o=t,n=eT(s),!o.raw&&function(e){if(e.length<20)return!1;let t=new Map;for(let s of e){let e=(s.type??"").toLowerCase(),r=L(s).trim().toLowerCase();if(!r)continue;let o=`${e}|${r}`;t.set(o,(t.get(o)??0)+1)}let s=0;for(let e of t.values())e>1&&(s+=e);return s>=8}(r)&&n.push("Warning: possible repeated nav subtree detected."),n),b=w.length>0?`${w.join("\n")}
29
+ `:"";if(0===i.length)return`${y}${h}
30
+ ${b}`;if(t.raw){let e=i.map(e=>JSON.stringify(e));return`${y}${h}
33
31
  ${b}${e.join("\n")}
34
- `}if(t.flatten){let e=V(f,{summarizeTextSurfaces:!0}).flatMap(e=>[eu(e.node,0,!1,e.type,{summarizeTextSurfaces:!0}),...ti({...e,depth:0})]),t=c&&c.summaryLines.length>0?`
35
- ${c.summaryLines.join("\n")}`:"";return`${y}${g}
32
+ `}if(t.flatten){let e=N(f,{summarizeTextSurfaces:!0}).flatMap(e=>[x(e.node,0,!1,e.type,{summarizeTextSurfaces:!0}),...eV({...e,depth:0})]),t=c&&c.summaryLines.length>0?`
33
+ ${c.summaryLines.join("\n")}`:"";return`${y}${h}
36
34
  ${b}${e.join("\n")}${t}
37
- `}let v=V(f,{summarizeTextSurfaces:!0}).flatMap(e=>[e.text,...ti(e)]),I=c&&c.summaryLines.length>0?`
38
- ${c.summaryLines.join("\n")}`:"";return`${y}${g}
39
- ${b}${v.join("\n")}${I}
40
- `})(r,{raw:e.snapshotRaw,flatten:e.snapshotInteractiveOnly})),!0};function nn(e,t,r){var a,n;let o,s=i.isAbsolute(e)?e:i.resolve(t,e);if(r&&(a=s,n=r,""!==(o=i.relative(n,a))&&(o.startsWith("..")||i.isAbsolute(o))))throw new eg("INVALID_ARGS","Local path is outside the artifact adapter root",{path:s,rootDir:r});return s}let no=async({positionals:e,flags:t,client:r})=>{let a=await r.capture.screenshot({path:e[0]??t.out,overlayRefs:t.overlayRefs,...void 0!==t.screenshotFullscreen?{fullscreen:t.screenshotFullscreen}:{}});return aK(t,{path:a.path,...a.overlayRefs?{overlayRefs:a.overlayRefs}:{}},()=>a.overlayRefs?`Annotated ${a.overlayRefs.length} refs onto ${a.path}`:a.path),!0},ns=async({positionals:e,flags:t,client:r})=>{var a;if("snapshot"===e[0]){let e=await r.capture.diff({...aH(t),kind:"snapshot",out:t.out,interactiveOnly:t.snapshotInteractiveOnly,compact:t.snapshotCompact,depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw});return aK(t,e,()=>(function(e){var t;let r=!0===e.baselineInitialized,a=e.summary??{},n=ta(a.additions),o=ta(a.removals),s=ta(a.unchanged),i=tn(),c=ts(e),u=c.length>0?`${c.join("\n")}
41
- `:"";if(r)return`${u}Baseline initialized (${s} lines).
42
- `;let d=(function(e){if(0===e.length)return e;let t=e.map((e,t)=>({index:t,kind:e.kind})).filter(e=>"added"===e.kind||"removed"===e.kind).map(e=>e.index);if(0===t.length)return e;let r=Array(e.length).fill(!1);for(let a of t){let t=Math.max(0,a-1),n=Math.min(e.length-1,a+1);for(let e=t;e<=n;e+=1)r[e]=!0}return e.filter((e,t)=>r[t])})(Array.isArray(e.lines)?e.lines:[]).map(e=>{let t="string"==typeof e.text?e.text:"";if("added"===e.kind){let e=t.startsWith(" ")?`+${t}`:`+ ${t}`;return i?l("green",e):e}if("removed"===e.kind){let e=t.startsWith(" ")?`-${t}`:`- ${t}`;return i?l("red",e):e}return i?l("dim",t):t}),p=d.length>0?`${d.join("\n")}
43
- `:"";if(!i)return`${u}${p}${n} additions, ${o} removals, ${s} unchanged
44
- `;let m=`${(t=String(n),l("green",t))} additions, ${l("red",String(o))} removals, ${l("dim",String(s))} unchanged`;return`${u}${p}${m}
45
- `})(e)),!0}if("screenshot"!==e[0])return!1;let n=t.baseline;if(!n||"string"!=typeof n)throw new eg("INVALID_ARGS","diff screenshot requires --baseline <path>");let o=Y(n),s="string"==typeof t.out?Y(t.out):void 0,c=e[1];if(e.length>2)throw new eg("INVALID_ARGS","diff screenshot accepts at most one current screenshot path");let u=el({backend:(a=r,{platform:function(e){switch(e.platform){case"android":case"linux":case"macos":return e.platform;default:return"ios"}}(t),captureScreenshot:async(e,t,r)=>{let n=await a.capture.screenshot({path:t,session:e.session,overlayRefs:r?.overlayRefs,fullscreen:r?.fullscreen,surface:r?.surface});return{path:n.path,...n.overlayRefs?{overlayRefs:n.overlayRefs}:{}}}}),artifacts:function(e={}){let t=e.cwd??process.cwd(),r=e.tempDir??g.tmpdir(),a=e.rootDir?nn(e.rootDir,t):void 0;return{resolveInput:async e=>{if("uploadedArtifact"===e.kind)throw new eg("UNSUPPORTED_OPERATION","Uploaded artifact inputs require a custom artifact adapter");return{path:nn(e.path,t,a)}},reserveOutput:async(e,n)=>{let o,s=n.visibility??"client-visible",l=e?.kind==="path"?nn(e.path,t,a):i.join(o=await h.mkdtemp(i.join(r,`agent-device-${n.field}-`)),`${n.field}${n.ext}`);return await h.mkdir(i.dirname(l),{recursive:!0}),{path:l,visibility:s,...o?{cleanup:async()=>{await h.rm(o,{recursive:!0,force:!0})}}:{},publish:async()=>e?.kind==="downloadableArtifact"?{kind:"localPath",field:n.field,path:l,fileName:e.fileName??i.basename(e.clientPath??l)}:void 0}},createTempFile:async e=>{let t=await h.mkdtemp(i.join(r,`${e.prefix}-`));return{path:i.join(t,`file${e.ext}`),visibility:"internal",cleanup:async()=>{await h.rm(t,{recursive:!0,force:!0})}}}}}(),sessions:{get:e=>({name:e}),set:()=>{}},policy:j()}),d=await u.capture.diffScreenshot({session:t.session,baseline:{kind:"path",path:o},current:c?{kind:"path",path:Y(c)}:{kind:"live"},...s?{out:{kind:"path",path:s}}:{},threshold:function(e){if(null!=e&&""!==e)return Number(e)}(t.threshold),overlayRefs:t.overlayRefs,surface:t.surface});return aK(t,d,()=>(function(e){let t=tn(),r=!0===e.match,a=ta(e.differentPixels),n=ta(e.totalPixels),o=ta(e.mismatchPercentage),s=e.diffPath,i=e.dimensionMismatch,c=[];if(r){let e=t?l("green","✓"):"✓";c.push(`${e} Screenshots match.`)}else if(i){let e=t?l("red","✗"):"✗",r=i.expected,a=i.actual;c.push(`${e} Screenshots have different dimensions: expected ${r?.width}x${r?.height}, got ${a?.width}x${a?.height}`)}else{let e=t?l("red","✗"):"✗",r=0===o&&a>0?"<0.01":String(o),n=`${r}% pixels differ`;c.push(`${e} ${t?l("red",n):n}`)}if(s&&!r){let e=tr(s),r=t?l("dim","Diff image:"):"Diff image:",a=t?l("green",e):e;c.push(` ${r} ${a}`)}if(e.currentOverlayPath&&!r){let r=tr(e.currentOverlayPath),a=t?l("dim","Current overlay:"):"Current overlay:",n=t?l("green",r):r,o=ta(e.currentOverlayRefCount),s=o>0?` (${o} refs)`:"";c.push(` ${a} ${n}${s}`)}if(!r&&!i){let e=t?l("red",String(a)):String(a);c.push(` ${e} different / ${n} total pixels`)}let u=r||i?[]:function(e){let t=[];for(let r of(e.ocr?.movementClusters??[]).slice(0,2))t.push(`text movement cluster: ${function(e){let t=e.slice(0,4).map(e=>JSON.stringify(e)),r=e.length>t.length?` +${e.length-t.length} more`:"";return`${t.join(", ")}${r}`}(r.texts)} dx=${tt(r.xRange)}px dy=${tt(r.yRange)}px`);let r=(e.nonTextDeltas??[]).filter(e=>["icon","toggle","chevron"].includes(e.likelyKind)).slice(0,3);r.length>0&&t.push(`non-text controls: ${r.map(te).join("; ")}`);let a=(e.nonTextDeltas??[]).filter(e=>"separator"===e.likelyKind).slice(0,2);return a.length>0&&t.push(`non-text boundaries: ${a.map(te).join("; ")}`),t.slice(0,6)}(e);if(u.length>0)for(let e of(c.push(` ${to("Hints:",t)}`),u))c.push(` - ${e}`);let d=Array.isArray(e.regions)?e.regions:[];if(!r&&!i&&d.length>0)for(let e of(c.push(` ${to("Changed regions:",t)}`),d.slice(0,5))){let t=0===e.shareOfDiffPercentage&&e.differentPixels>0?"<0.01":String(e.shareOfDiffPercentage),r=e.rect;c.push(` ${e.index}. ${e.location} x=${r.x} y=${r.y} ${r.width}x${r.height}, ${t}% of diff, change=${e.dominantChange}`);let a=function(e){let t=[e.size?`size=${e.size}`:null,e.shape?`shape=${e.shape}`:null,"number"==typeof e.densityPercentage?`density=${e.densityPercentage}%`:null,e.averageBaselineColorHex&&e.averageCurrentColorHex?`avgColor=${e.averageBaselineColorHex}->${e.averageCurrentColorHex}`:null,"number"==typeof e.baselineLuminance&&"number"==typeof e.currentLuminance?`luminance=${e.baselineLuminance}->${e.currentLuminance}`:null].filter(e=>null!==e);return t.length>0?t.join(" "):null}(e);a&&c.push(` ${a}`);let n=e.currentOverlayMatches?.[0];if(n){let e=n.label?` "${n.label}"`:"";c.push(` overlaps @${n.ref}${e}, ${n.regionCoveragePercentage}% of region`)}}let p=e.ocr?.matches??[];if(!r&&!i&&p.length>0){let r=p.slice(0,8);for(let[a,n]of(c.push(` ${to(`OCR text deltas (${e.ocr?.provider}; baselineBlocks=${e.ocr?.baselineBlocks} currentBlocks=${e.ocr?.currentBlocks}; showing ${r.length}/${p.length}; px):`,t)}`),c.push(` ${to("item | text | movePx | sizeDeltaPx | bboxBaseline | bboxCurrent | confidence | issueHint",t)}`),r.entries())){let e=n.delta;c.push(` ${a+1} | ${JSON.stringify(n.text)} | ${e9(e.x)},${e9(e.y)} | ${e9(e.width)},${e9(e.height)} | ${e7(n.baselineRect)} | ${e7(n.currentRect)} | ${n.confidence} | ${n.possibleTextMetricMismatch?"ocr-bbox-size-change":"-"}`)}}let m=e.nonTextDeltas??[];if(!r&&!i&&m.length>0){let e=m.slice(0,8);for(let r of(c.push(` ${to(`Non-text visual deltas (showing ${e.length}/${m.length}; px):`,t)}`),c.push(` ${to("item | region | slot | kind | bboxCurrent | nearestText",t)}`),e))c.push(` ${r.index} | ${r.regionIndex?`r${r.regionIndex}`:"-"} | ${r.slot} | ${r.likelyKind} | ${e7(r.rect)} | ${r.nearestText?JSON.stringify(r.nearestText):"-"}`)}return`${c.join("\n")}
46
- `})(d)),!0};function ni(e){return null===e?{}:{timeoutMs:e}}function nl(e){let{suite:t,json:r,verbose:a,reportJunit:n}=e;return(n&&function(e,t){let r=i.dirname(e);try{f.mkdirSync(r,{recursive:!0}),f.writeFileSync(e,function(e){let t=['<?xml version="1.0" encoding="UTF-8"?>',"<testsuites>",` <testsuite name="agent-device replay suite" tests="${e.total}" failures="${e.failed}" skipped="${e.skipped}" time="${nd(e.durationMs)}">`];for(let r of e.tests)t.push(...function(e){let t=np(i.basename(e.file)),r=np("."===i.dirname(e.file)?e.file:i.dirname(e.file)),a=np(e.file),n=nd(e.durationMs),o=[` <testcase classname="${r}" name="${t}" file="${a}" time="${n}">`];"failed"===e.status?o.push(` <failure message="${np(e.error.message)}">${np(function(e){let t=[e.error.message];e.error.hint&&t.push(`hint: ${e.error.hint}`),e.error.diagnosticId&&t.push(`diagnosticId: ${e.error.diagnosticId}`),e.error.logPath&&t.push(`logPath: ${e.error.logPath}`),e.artifactsDir&&t.push(`artifactsDir: ${e.artifactsDir}`);let r=e.error.details?JSON.stringify(e.error.details,null,2):void 0;return r&&t.push(`details: ${r}`),t.join("\n")}(e))}</failure>`):"skipped"===e.status&&o.push(` <skipped message="${np(e.message)}" />`);let s=function(e){let t=[`status: ${e.status}`,`durationMs: ${e.durationMs}`];return"attempts"in e&&t.push(`attempts: ${e.attempts}`),"session"in e&&t.push(`session: ${e.session}`),"replayed"in e&&t.push(`replayed: ${e.replayed}`),"healed"in e&&t.push(`healed: ${e.healed}`),"artifactsDir"in e&&e.artifactsDir&&t.push(`artifactsDir: ${e.artifactsDir}`),"passed"===e.status&&e.attempts>1&&t.push("flaky: true"),t.join("\n")}(e);return s&&o.push(` <system-out>${np(s)}</system-out>`),o.push(" </testcase>"),o}(r));return t.push(" </testsuite>"),t.push("</testsuites>"),`${t.join("\n")}
47
- `}(t),"utf8")}catch(r){let t=r instanceof Error?r.message:String(r);throw new eg("COMMAND_FAILED",`Failed to write JUnit report to ${e}: ${t}`)}}(n,t),r)?(e4({success:!0,data:t}),function(e){return+(e.failed>0)}(t)):function(e,t={}){let r=e.tests.filter(nu);if(t.verbose)for(let t of e.tests)!function(e){if("failed"===e.status)return nc(e);let t="passed"===e.status?nu(e)?"FLAKY":"PASS":"skipped"===e.status?"SKIP":"INFO",r="attempts"in e&&e.attempts>1?` after ${e.attempts} attempts`:"",a=e.durationMs>0?` (${e.durationMs}ms)`:"";process.stdout.write(`${t} ${e.file}${r}${a}
35
+ `}let v=N(f,{summarizeTextSurfaces:!0}).flatMap(e=>[e.text,...eV(e)]),k=c&&c.summaryLines.length>0?`
36
+ ${c.summaryLines.join("\n")}`:"";return`${y}${h}
37
+ ${b}${v.join("\n")}${k}
38
+ `})(s,{raw:e.snapshotRaw,flatten:e.snapshotInteractiveOnly})),!0},tD=async({positionals:e,flags:t,client:s})=>{let r=await s.capture.screenshot({path:e[0]??t.out,overlayRefs:t.overlayRefs,maxSize:t.screenshotMaxSize,...void 0!==t.screenshotFullscreen?{fullscreen:t.screenshotFullscreen}:{}});return te(t,{path:r.path,...r.overlayRefs?{overlayRefs:r.overlayRefs}:{}},()=>r.overlayRefs?`Annotated ${r.overlayRefs.length} refs onto ${r.path}`:r.path),!0},t$=async({positionals:e,flags:t,client:s})=>{var r;if("snapshot"===e[0]){let e=await s.capture.diff({...e7(t),kind:"snapshot",out:t.out,interactiveOnly:t.snapshotInteractiveOnly,compact:t.snapshotCompact,depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw});return te(t,e,()=>(function(e){var t;let s=!0===e.baselineInitialized,r=e.summary??{},o=eE(r.additions),n=eE(r.removals),a=eE(r.unchanged),i=eF(),c=eT(e),u=c.length>0?`${c.join("\n")}
39
+ `:"";if(s)return`${u}Baseline initialized (${a} lines).
40
+ `;let p=(function(e){if(0===e.length)return e;let t=e.map((e,t)=>({index:t,kind:e.kind})).filter(e=>"added"===e.kind||"removed"===e.kind).map(e=>e.index);if(0===t.length)return e;let s=Array(e.length).fill(!1);for(let r of t){let t=Math.max(0,r-1),o=Math.min(e.length-1,r+1);for(let e=t;e<=o;e+=1)s[e]=!0}return e.filter((e,t)=>s[t])})(Array.isArray(e.lines)?e.lines:[]).map(e=>{let t="string"==typeof e.text?e.text:"";if("added"===e.kind){let e=t.startsWith(" ")?`+${t}`:`+ ${t}`;return i?l("green",e):e}if("removed"===e.kind){let e=t.startsWith(" ")?`-${t}`:`- ${t}`;return i?l("red",e):e}return i?l("dim",t):t}),d=p.length>0?`${p.join("\n")}
41
+ `:"";if(!i)return`${u}${d}${o} additions, ${n} removals, ${a} unchanged
42
+ `;let m=`${(t=String(o),l("green",t))} additions, ${l("red",String(n))} removals, ${l("dim",String(a))} unchanged`;return`${u}${d}${m}
43
+ `})(e)),!0}if("screenshot"!==e[0])return!1;let o=t.baseline;if(!o||"string"!=typeof o)throw new I("INVALID_ARGS","diff screenshot requires --baseline <path>");let n=W(o),a="string"==typeof t.out?W(t.out):void 0,i=e[1];if(e.length>2)throw new I("INVALID_ARGS","diff screenshot accepts at most one current screenshot path");let c=U({backend:(r=s,{platform:function(e){switch(e.platform){case"android":case"linux":case"macos":return e.platform;default:return"ios"}}(t),captureScreenshot:async(e,t,s)=>{let o=await r.capture.screenshot({path:t,session:e.session,overlayRefs:s?.overlayRefs,fullscreen:s?.fullscreen,surface:s?.surface});return{path:o.path,...o.overlayRefs?{overlayRefs:o.overlayRefs}:{}}}}),artifacts:Y(),sessions:{get:e=>({name:e}),set:()=>{}},policy:J()}),u=await c.capture.diffScreenshot({session:t.session,baseline:{kind:"path",path:n},current:i?{kind:"path",path:W(i)}:{kind:"live"},...a?{out:{kind:"path",path:a}}:{},threshold:function(e){if(null!=e&&""!==e)return Number(e)}(t.threshold),overlayRefs:t.overlayRefs,surface:t.surface});return te(t,u,()=>(function(e){let t=eF(),s=!0===e.match,r=eE(e.differentPixels),o=eE(e.totalPixels),n=eE(e.mismatchPercentage),a=e.diffPath,i=e.dimensionMismatch,c=[];if(s){let e=t?l("green","✓"):"✓";c.push(`${e} Screenshots match.`)}else if(i){let e=t?l("red","✗"):"✗",s=i.expected,r=i.actual;c.push(`${e} Screenshots have different dimensions: expected ${s?.width}x${s?.height}, got ${r?.width}x${r?.height}`)}else{let e=t?l("red","✗"):"✗",s=0===n&&r>0?"<0.01":String(n),o=`${s}% pixels differ`;c.push(`${e} ${t?l("red",o):o}`)}if(a&&!s){let e=eM(a),s=t?l("dim","Diff image:"):"Diff image:",r=t?l("green",e):e;c.push(` ${s} ${r}`)}if(e.currentOverlayPath&&!s){let s=eM(e.currentOverlayPath),r=t?l("dim","Current overlay:"):"Current overlay:",o=t?l("green",s):s,n=eE(e.currentOverlayRefCount),a=n>0?` (${n} refs)`:"";c.push(` ${r} ${o}${a}`)}if(!s&&!i){let e=t?l("red",String(r)):String(r);c.push(` ${e} different / ${o} total pixels`)}let u=s||i?[]:function(e){let t=[];for(let s of(e.ocr?.movementClusters??[]).slice(0,2))t.push(`text movement cluster: ${function(e){let t=e.slice(0,4).map(e=>JSON.stringify(e)),s=e.length>t.length?` +${e.length-t.length} more`:"";return`${t.join(", ")}${s}`}(s.texts)} dx=${eO(s.xRange)}px dy=${eO(s.yRange)}px`);let s=(e.nonTextDeltas??[]).filter(e=>["icon","toggle","chevron"].includes(e.likelyKind)).slice(0,3);s.length>0&&t.push(`non-text controls: ${s.map(eP).join("; ")}`);let r=(e.nonTextDeltas??[]).filter(e=>"separator"===e.likelyKind).slice(0,2);return r.length>0&&t.push(`non-text boundaries: ${r.map(eP).join("; ")}`),t.slice(0,6)}(e);if(u.length>0)for(let e of(c.push(` ${ej("Hints:",t)}`),u))c.push(` - ${e}`);let p=Array.isArray(e.regions)?e.regions:[];if(!s&&!i&&p.length>0)for(let e of(c.push(` ${ej("Changed regions:",t)}`),p.slice(0,5))){let t=0===e.shareOfDiffPercentage&&e.differentPixels>0?"<0.01":String(e.shareOfDiffPercentage),s=e.rect;c.push(` ${e.index}. ${e.location} x=${s.x} y=${s.y} ${s.width}x${s.height}, ${t}% of diff, change=${e.dominantChange}`);let r=function(e){let t=[e.size?`size=${e.size}`:null,e.shape?`shape=${e.shape}`:null,"number"==typeof e.densityPercentage?`density=${e.densityPercentage}%`:null,e.averageBaselineColorHex&&e.averageCurrentColorHex?`avgColor=${e.averageBaselineColorHex}->${e.averageCurrentColorHex}`:null,"number"==typeof e.baselineLuminance&&"number"==typeof e.currentLuminance?`luminance=${e.baselineLuminance}->${e.currentLuminance}`:null].filter(e=>null!==e);return t.length>0?t.join(" "):null}(e);r&&c.push(` ${r}`);let o=e.currentOverlayMatches?.[0];if(o){let e=o.label?` "${o.label}"`:"";c.push(` overlaps @${o.ref}${e}, ${o.regionCoveragePercentage}% of region`)}}let d=e.ocr?.matches??[];if(!s&&!i&&d.length>0){let s=d.slice(0,8);for(let[r,o]of(c.push(` ${ej(`OCR text deltas (${e.ocr?.provider}; baselineBlocks=${e.ocr?.baselineBlocks} currentBlocks=${e.ocr?.currentBlocks}; showing ${s.length}/${d.length}; px):`,t)}`),c.push(` ${ej("item | text | movePx | sizeDeltaPx | bboxBaseline | bboxCurrent | confidence | issueHint",t)}`),s.entries())){let e=o.delta;c.push(` ${r+1} | ${JSON.stringify(o.text)} | ${e_(e.x)},${e_(e.y)} | ${e_(e.width)},${e_(e.height)} | ${eC(o.baselineRect)} | ${eC(o.currentRect)} | ${o.confidence} | ${o.possibleTextMetricMismatch?"ocr-bbox-size-change":"-"}`)}}let m=e.nonTextDeltas??[];if(!s&&!i&&m.length>0){let e=m.slice(0,8);for(let s of(c.push(` ${ej(`Non-text visual deltas (showing ${e.length}/${m.length}; px):`,t)}`),c.push(` ${ej("item | region | slot | kind | bboxCurrent | nearestText",t)}`),e))c.push(` ${s.index} | ${s.regionIndex?`r${s.regionIndex}`:"-"} | ${s.slot} | ${s.likelyKind} | ${eC(s.rect)} | ${s.nearestText?JSON.stringify(s.nearestText):"-"}`)}return`${c.join("\n")}
44
+ `})(u)),!0},tS={[Q.wait]:async({positionals:e,flags:t,client:s})=>(tt(t,await s.command.wait(function(e,t){let s=y(e);if(!s)throw new I("INVALID_ARGS","wait requires <ms>, text <text>, @ref, or <selector> [timeoutMs].");let r={...e7(t),depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw};if("sleep"===s.kind)return{...r,durationMs:s.durationMs};if("text"===s.kind){if(!s.text)throw new I("INVALID_ARGS","wait requires text.");return{...r,text:s.text,...tI(s.timeoutMs)}}return"ref"===s.kind?{...r,ref:s.rawRef,...tI(s.timeoutMs)}:{...r,selector:s.selectorExpression,...tI(s.timeoutMs)}}(e,t))),!0),[Q.alert]:async({positionals:e,flags:t,client:s})=>(tt(t,await s.command.alert(function(e,t){if(e.length>2)throw new I("INVALID_ARGS","alert accepts at most action and timeout arguments.");let s=function(e){let t=e?.toLowerCase();if(void 0===t||"get"===t||"accept"===t||"dismiss"===t||"wait"===t)return t;throw new I("INVALID_ARGS","alert action must be get, accept, dismiss, or wait.")}(e[0]),r=function(e,t){if(void 0===e)return;let s=Number(e);if(Number.isFinite(s))return s;throw new I("INVALID_ARGS",`${t} must be a finite number.`)}(e[1],"alert timeout");return{...e7(t),...s?{action:s}:{},...void 0!==r?{timeoutMs:r}:{}}}(e,t))),!0),[Q.appState]:async({flags:e,client:t})=>{let s=await t.command.appState(e7(e));return te(e,s,()=>(function(e){if("ios"===e.platform){let t=[`Foreground app: ${e.appName??e.appBundleId??"unknown"}`];return e.appBundleId&&t.push(`Bundle: ${e.appBundleId}`),e.source&&t.push(`Source: ${e.source}`),t.join("\n")}if("android"===e.platform){let t=[`Foreground app: ${e.package??"unknown"}`];return e.activity&&t.push(`Activity: ${e.activity}`),t.join("\n")}return null})(s)),!0},[Q.back]:async({flags:e,client:t})=>(tt(e,await t.command.back({...e7(e),mode:e.backMode})),!0),[Q.home]:async({flags:e,client:t})=>(tt(e,await t.command.home(e7(e))),!0),[Q.rotate]:async({positionals:e,flags:t,client:s})=>(tt(t,await s.command.rotate(function(e,t){if(e.length>1)throw new I("INVALID_ARGS","rotate accepts exactly one orientation argument.");return{...e7(t),orientation:f(e[0])}}(e,t))),!0),[Q.appSwitcher]:async({flags:e,client:t})=>(tt(e,await t.command.appSwitcher(e7(e))),!0),[Q.keyboard]:async({positionals:e,flags:t,client:s})=>(tt(t,await s.command.keyboard(function(e,t){if(e.length>1)throw new I("INVALID_ARGS","keyboard accepts at most one action argument.");let s=function(e){let t=e?.toLowerCase();if("get"===t)return"status";if(void 0===t||"status"===t||"dismiss"===t)return t;throw new I("INVALID_ARGS","keyboard action must be status, get, or dismiss.")}(e[0]);return{...e7(t),...s?{action:s}:{}}}(e,t))),!0),[Q.clipboard]:async({positionals:e,flags:t,client:s})=>{var r,o;return r=t,o=await s.command.clipboard(function(e,t){let s=e[0]?.toLowerCase();if("read"!==s&&"write"!==s)throw new I("INVALID_ARGS","clipboard requires a subcommand: read or write.");let r=e7(t);if("read"===s){if(1!==e.length)throw new I("INVALID_ARGS","clipboard read does not accept additional arguments.");return{...r,action:s}}if(e.length<2)throw new I("INVALID_ARGS","clipboard write requires text.");return{...r,action:s,text:e.slice(1).join(" ")}}(e,t)),r.json?te(r,o):"read"===o.action?process.stdout.write(`${o.text}
45
+ `):tt(r,o),!0}};function tI(e){return null===e?{}:{timeoutMs:e}}function tA(e){let{suite:t,json:s,verbose:r,reportJunit:o}=e;return(o&&function(e,t){let s=i.dirname(e);try{u.mkdirSync(s,{recursive:!0}),u.writeFileSync(e,function(e){let t=['<?xml version="1.0" encoding="UTF-8"?>',"<testsuites>",` <testsuite name="agent-device replay suite" tests="${e.total}" failures="${e.failed}" skipped="${e.skipped}" time="${tR(e.durationMs)}">`];for(let s of e.tests)t.push(...function(e){let t=tN(i.basename(e.file)),s=tN("."===i.dirname(e.file)?e.file:i.dirname(e.file)),r=tN(e.file),o=tR(e.durationMs),n=[` <testcase classname="${s}" name="${t}" file="${r}" time="${o}">`];"failed"===e.status?n.push(` <failure message="${tN(e.error.message)}">${tN(function(e){let t=[e.error.message];e.error.hint&&t.push(`hint: ${e.error.hint}`),e.error.diagnosticId&&t.push(`diagnosticId: ${e.error.diagnosticId}`),e.error.logPath&&t.push(`logPath: ${e.error.logPath}`),e.artifactsDir&&t.push(`artifactsDir: ${e.artifactsDir}`);let s=e.error.details?JSON.stringify(e.error.details,null,2):void 0;return s&&t.push(`details: ${s}`),t.join("\n")}(e))}</failure>`):"skipped"===e.status&&n.push(` <skipped message="${tN(e.message)}" />`);let a=function(e){let t=[`status: ${e.status}`,`durationMs: ${e.durationMs}`];return"attempts"in e&&t.push(`attempts: ${e.attempts}`),"session"in e&&t.push(`session: ${e.session}`),"replayed"in e&&t.push(`replayed: ${e.replayed}`),"healed"in e&&t.push(`healed: ${e.healed}`),"artifactsDir"in e&&e.artifactsDir&&t.push(`artifactsDir: ${e.artifactsDir}`),"passed"===e.status&&e.attempts>1&&t.push("flaky: true"),t.join("\n")}(e);return a&&n.push(` <system-out>${tN(a)}</system-out>`),n.push(" </testcase>"),n}(s));return t.push(" </testsuite>"),t.push("</testsuites>"),`${t.join("\n")}
46
+ `}(t),"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new I("COMMAND_FAILED",`Failed to write JUnit report to ${e}: ${t}`)}}(o,t),s)?(eR({success:!0,data:t}),function(e){return+(e.failed>0)}(t)):function(e,t={}){let s=e.tests.filter(tL);if(t.verbose)for(let t of e.tests)!function(e){if("failed"===e.status)return tx(e);let t="passed"===e.status?tL(e)?"FLAKY":"PASS":"skipped"===e.status?"SKIP":"INFO",s="attempts"in e&&e.attempts>1?` after ${e.attempts} attempts`:"",r=e.durationMs>0?` (${e.durationMs}ms)`:"";process.stdout.write(`${t} ${e.file}${s}${r}
48
47
  `),"skipped"===e.status&&process.stdout.write(` ${e.message??"skipped"}
49
- `)}(t);else{for(let t of e.failures)nc(t);for(let e of r)!function(e){let t=e.durationMs>0?` (${e.durationMs}ms)`:"";process.stdout.write(`FLAKY ${e.file} after ${e.attempts} attempts${t}
50
- `)}(e)}let a="number"==typeof e.durationMs?e.durationMs:void 0,n=r.length>0?`, ${r.length} flaky`:"";return process.stdout.write(`Test summary: ${e.passed} passed, ${e.failed} failed${n}${void 0!==a?` in ${a}ms`:""}
51
- `),function(e){return+(e.failed>0)}(e)}(t,{verbose:a})}function nc(e){let t=e.attempts>1?` after ${e.attempts} attempts`:"",r=e.durationMs>0?` (${e.durationMs}ms)`:"";process.stdout.write(`FAIL ${e.file}${t}${r}
48
+ `)}(t);else{for(let t of e.failures)tx(t);for(let e of s)!function(e){let t=e.durationMs>0?` (${e.durationMs}ms)`:"";process.stdout.write(`FLAKY ${e.file} after ${e.attempts} attempts${t}
49
+ `)}(e)}let r="number"==typeof e.durationMs?e.durationMs:void 0,o=s.length>0?`, ${s.length} flaky`:"";return process.stdout.write(`Test summary: ${e.passed} passed, ${e.failed} failed${o}${void 0!==r?` in ${r}ms`:""}
50
+ `),function(e){return+(e.failed>0)}(e)}(t,{verbose:r})}function tx(e){let t=e.attempts>1?` after ${e.attempts} attempts`:"",s=e.durationMs>0?` (${e.durationMs}ms)`:"";process.stdout.write(`FAIL ${e.file}${t}${s}
52
51
  `),process.stdout.write(` ${e.error?.message??"Unknown test failure"}
53
52
  `),e.error?.hint&&process.stdout.write(` hint: ${e.error.hint}
54
53
  `),e.artifactsDir&&process.stdout.write(` artifacts: ${e.artifactsDir}
55
54
  `),e.error?.logPath&&process.stdout.write(` log: ${e.error.logPath}
56
55
  `),e.error?.diagnosticId&&process.stdout.write(` diagnostic: ${e.error.diagnosticId}
57
- `)}function nu(e){return"passed"===e.status&&e.attempts>1}function nd(e){return(Math.max(0,e)/1e3).toFixed(3)}function np(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;").replaceAll("'","&apos;")}let nm={[rP]:nf(rP,({client:e,flags:t})=>e.devices.boot({...aH(t),headless:t.headless})),[rH]:nf(rH,({client:e,positionals:t,flags:r})=>e.apps.push({...aH(r),app:nw(t[0],"push requires bundleOrPackage"),payload:nw(t[1],"push requires payloadOrJson")})),[rV]:nf(rV,({client:e,flags:t})=>e.observability.perf(aH(t))),[rL]:nf(rL,({client:e,positionals:t,flags:r})=>e.interactions.click({...ng(t),...nh(r),...aH(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap,button:r.clickButton})),get:nf("get",({client:e,positionals:t,flags:r})=>e.interactions.get({...function(e){if(e[0]?.startsWith("@"))return{ref:e[0],label:e.slice(1).join(" ")||void 0};let t=e.join(" ").trim();if(!t)throw new eg("INVALID_ARGS","get requires @ref or selector expression");return{selector:t}}(t.slice(1)),...nh(r),...aH(r),format:function(e){if("text"===e||"attrs"===e)return e;throw new eg("INVALID_ARGS","get only supports text or attrs")}(t[0])})),[rJ]:nf(rJ,({client:e,positionals:t,flags:r})=>e.replay.run({...aH(r),path:nw(t[0],"replay requires path"),update:r.replayUpdate})),[r0]:nf(r0,({client:e,positionals:t,flags:r})=>(({json:r.json}).json||process.stderr.write("Running replay suite...\n"),e.replay.test({...aH(r),paths:t,update:r.replayUpdate,failFast:r.failFast,timeoutMs:r.timeoutMs,retries:r.retries,artifactsDir:r.artifactsDir,reportJunit:r.reportJunit}))),[rN]:nf(rN,({client:e,flags:t})=>e.batch.run({...aH(t),steps:t.batchSteps??[],onError:t.batchOnError,maxSteps:t.batchMaxSteps,out:t.out})),[rq]:nf(rq,({client:e,positionals:t,flags:r})=>e.interactions.press({...ng(t),...nh(r),...aH(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap})),[rj]:nf(rj,({client:e,positionals:t,flags:r})=>e.interactions.longPress({...aH(r),x:Number(t[0]),y:Number(t[1]),durationMs:nb(t[2])})),[rQ]:nf(rQ,({client:e,positionals:t,flags:r})=>e.interactions.swipe({...aH(r),from:{x:Number(t[0]),y:Number(t[1])},to:{x:Number(t[2]),y:Number(t[3])},durationMs:nb(t[4]),count:r.count,pauseMs:r.pauseMs,pattern:r.pattern})),[rC]:nf(rC,({client:e,positionals:t,flags:r})=>e.interactions.focus({...aH(r),x:Number(t[0]),y:Number(t[1])})),[r3]:nf(r3,({client:e,positionals:t,flags:r})=>e.interactions.type({...aH(r),text:t.join(" "),delayMs:r.delayMs})),[rR]:nf(rR,({client:e,positionals:t,flags:r})=>e.interactions.fill({...function(e){if(e[0]?.startsWith("@")){let t=e.length>=3?e.slice(2).join(" "):e.slice(1).join(" ");return{ref:e[0],label:e.length>=3?e[1]:void 0,text:t}}let t=M(e,{preferTrailingValue:!0});return t?{selector:t.selectorExpression,text:t.rest.join(" ")}:{x:Number(e[0]),y:Number(e[1]),text:e.slice(2).join(" ")}}(t),...nh(r),...aH(r),delayMs:r.delayMs})),[rW]:nf(rW,({client:e,positionals:t,flags:r})=>e.interactions.scroll({...aH(r),direction:function(e){if("up"===e||"down"===e||"left"===e||"right"===e)return e;throw new eg("INVALID_ARGS",`Unknown direction: ${String(e)}`)}(t[0]),amount:nb(t[1]),pixels:r.pixels})),[rG]:nf(rG,({client:e,positionals:t,flags:r})=>e.interactions.pinch({...aH(r),scale:Number(t[0]),x:nb(t[1]),y:nb(t[2])})),[r2]:nf(r2,({client:e,positionals:t,flags:r})=>e.apps.triggerEvent({...aH(r),event:nw(t[0],"trigger-app-event requires event"),payload:t[1]?function(e,t){try{let t=JSON.parse(e);if(t&&"object"==typeof t&&!Array.isArray(t))return t}catch{}throw new eg("INVALID_ARGS",`${t} must be a JSON object`)}(t[1],"trigger-app-event payload"):void 0})),[rK]:nf(rK,({client:e,positionals:t,flags:r})=>e.recording.record({...aH(r),action:ny(t[0],"record"),path:t[1],fps:r.fps,quality:r.quality,hideTouches:r.hideTouches})),[r1]:nf(r1,({client:e,positionals:t,flags:r})=>e.recording.trace({...aH(r),action:ny(t[0],"trace"),path:t[1]})),[rF]:nf(rF,({client:e,positionals:t,flags:r})=>e.observability.logs({...aH(r),action:function(e){if(void 0!==e){if("path"===e||"start"===e||"stop"===e||"doctor"===e||"mark"===e||"clear"===e)return e;throw new eg("INVALID_ARGS","logs requires path, start, stop, doctor, mark, or clear")}}(t[0]),message:t.slice(1).join(" ")||void 0,restart:r.restart})),[rB]:nf(rB,({client:e,positionals:t,flags:r})=>e.observability.network({...aH(r),action:function(e){if(void 0!==e){if("dump"===e||"log"===e)return e;throw new eg("INVALID_ARGS","network requires dump or log")}}(t[0]),limit:nb(t[1]),include:r.networkInclude??function(e){if(void 0!==e){if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new eg("INVALID_ARGS","network include mode must be summary, headers, body, or all")}}(t[2])})),[rT]:nf(rT,({client:e,positionals:t,flags:r})=>{var a;return e.interactions.find({...function(e){let t=function(e){if("text"===e||"label"===e||"value"===e||"role"===e||"id"===e)return e}(e[0]),r=void 0!==t,a=r?e[1]:e[0],n=r?2:1,o=e[n];if(void 0===o)return{locator:t,query:nw(a,"find requires query")};if("get"===o){let r=e[n+1];if("text"===r)return{locator:t,query:nw(a,"find requires query"),action:"getText"};if("attrs"===r)return{locator:t,query:nw(a,"find requires query"),action:"getAttrs"};throw new eg("INVALID_ARGS","find get only supports text or attrs")}if("wait"===o)return{locator:t,query:nw(a,"find requires query"),action:"wait",timeoutMs:nb(e[n+1])};if("fill"===o||"type"===o)return{locator:t,query:nw(a,"find requires query"),action:o,value:e.slice(n+1).join(" ")};if("click"===o||"focus"===o||"exists"===o)return{locator:t,query:nw(a,"find requires query"),action:o};throw new eg("INVALID_ARGS",`Unsupported find action: ${o}`)}(t),...{depth:(a=r).snapshotDepth,raw:a.snapshotRaw},...aH(r),first:r.findFirst,last:r.findLast})}),is:nf("is",({client:e,positionals:t,flags:r})=>e.interactions.is({...function(e){let t=e[0],r=M(e.slice(1),{preferTrailingValue:"text"===t});if(!r)throw new eg("INVALID_ARGS","is requires a selector expression");if("text"===t)return{predicate:t,selector:r.selectorExpression,value:r.rest.join(" ")};if("visible"===t||"hidden"===t||"exists"===t||"editable"===t||"selected"===t)return{predicate:t,selector:r.selectorExpression};throw new eg("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text")}(t),...nh(r),...aH(r)})),[rY]:nf(rY,({client:e,positionals:t,flags:r})=>e.settings.update(function(e,t){let r=aH(t),a=e[0],n=e[1];if(("wifi"===a||"airplane"===a||"location"===a)&&("on"===n||"off"===n)||"appearance"===a&&("light"===n||"dark"===n||"toggle"===n)||("faceid"===a||"touchid"===a)&&("match"===n||"nonmatch"===n||"enroll"===n||"unenroll"===n)||"fingerprint"===a&&("match"===n||"nonmatch"===n))return{...r,setting:a,state:n};if("permission"===a&&("grant"===n||"deny"===n||"reset"===n))return{...r,setting:a,state:n,permission:function(e){switch(e){case"camera":case"microphone":case"photos":case"contacts":case"contacts-limited":case"notifications":case"calendar":case"location":case"location-always":case"media-library":case"motion":case"reminders":case"siri":case"accessibility":case"screen-recording":case"input-monitoring":return e;default:throw new eg("INVALID_ARGS","settings permission requires a permission target.")}}(e[2]),mode:function(e){if(void 0===e||"full"===e||"limited"===e)return e;throw new eg("INVALID_ARGS","settings permission mode must be full or limited.")}(e[3])};throw new eg("INVALID_ARGS","Invalid settings arguments.")}(t,r)))};function nf(e,t){return async({positionals:r,flags:a,client:n})=>{let o=await t({client:n,positionals:r,flags:a}),s=function(e,t,r,a){if(r.json)return e===r0?nl({suite:a,json:!0,reportJunit:r.reportJunit}):(e4({success:!0,data:a}),0);if(e===r0)return nl({suite:a,verbose:r.verbose,reportJunit:r.reportJunit});if(e===rN)return!function(e){let t="number"==typeof e.total?e.total:0,r="number"==typeof e.executed?e.executed:0,a="number"==typeof e.totalDurationMs?e.totalDurationMs:void 0;for(let o of(process.stdout.write(`Batch completed: ${r}/${t} steps${void 0!==a?` in ${a}ms`:""}
58
- `),Array.isArray(e.results)?e.results:[])){var n;if(!o||"object"!=typeof o)continue;let e="number"==typeof o.step?o.step:void 0,t="string"==typeof o.command?o.command:"step",r=!1!==o.ok,a="number"==typeof o.durationMs?o.durationMs:void 0,s=o.data&&"object"==typeof o.data?o.data:void 0,i=o.error&&"object"==typeof o.error?o.error:void 0,l=r?U(s)??t:(n=i,("string"==typeof n?.message&&n.message.length>0?n.message:null)??t),c=void 0!==e?`${e}. `:"- ",u=void 0!==a?` (${a}ms)`:"";process.stdout.write(`${c}${r?"OK":"FAILED"} ${l}${u}
59
- `)}}(a),0;if("get"===e){let e=t[0];if("text"===e)return process.stdout.write(`${"string"==typeof a.text?a.text:""}
60
- `),0;if("attrs"===e)return process.stdout.write(`${JSON.stringify(a.node??{},null,2)}
61
- `),0}if(e===rT){if("string"==typeof a.text)return process.stdout.write(`${a.text}
62
- `),0;if("boolean"==typeof a.found)return process.stdout.write(`Found: ${a.found}
63
- `),0;if(a.node)return process.stdout.write(`${JSON.stringify(a.node,null,2)}
64
- `),0}if("is"===e)return process.stdout.write(`Passed: is ${a.predicate??"assertion"}
65
- `),0;if(e===rP){let e=a.platform??"unknown",t=a.device??a.id??"unknown";return process.stdout.write(`Boot ready: ${t} (${e})
66
- `),0}if(e===rK){let e="string"==typeof a.outPath?a.outPath:"";return e&&process.stdout.write(`${e}
67
- `),0}if(e===rF)return function(e,t){let r="string"==typeof e.path?e.path:"";if(!r)return;process.stdout.write(`${r}
68
- `);let a=["active","state","backend","sizeBytes"].map(t=>void 0!==e[t]&&null!==e[t]?`${t}=${e[t]}`:"").filter(Boolean).join(" ");a&&!t.json&&process.stderr.write(`${a}
69
- `);let n=["started","stopped","marked","cleared","restarted","removedRotatedFiles"].map(t=>{let r=e[t];return!0===r?`${t}=true`:"number"==typeof r?`${t}=${r}`:""}).filter(Boolean).join(" ");if(n&&!t.json&&process.stderr.write(`${n}
56
+ `)}function tL(e){return"passed"===e.status&&e.attempts>1}function tR(e){return(Math.max(0,e)/1e3).toFixed(3)}function tN(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;").replaceAll("'","&apos;")}let tC={[Q.boot]:t_(Q.boot,({client:e,flags:t})=>e.devices.boot({...e7(t),headless:t.headless})),[Q.push]:t_(Q.push,({client:e,positionals:t,flags:s})=>e.apps.push({...e7(s),app:tE(t[0],"push requires bundleOrPackage"),payload:tE(t[1],"push requires payloadOrJson")})),[Q.perf]:t_(Q.perf,({client:e,flags:t})=>e.observability.perf(e7(t))),[Q.click]:t_(Q.click,({client:e,positionals:t,flags:s})=>e.interactions.click({...tO(t),...tP(s),...e7(s),count:s.count,intervalMs:s.intervalMs,holdMs:s.holdMs,jitterPx:s.jitterPx,doubleTap:s.doubleTap,button:s.clickButton})),[Q.get]:t_(Q.get,({client:e,positionals:t,flags:s})=>e.interactions.get({...function(e){if(e[0]?.startsWith("@"))return{ref:e[0],label:e.slice(1).join(" ")||void 0};let t=e.join(" ").trim();if(!t)throw new I("INVALID_ARGS","get requires @ref or selector expression");return{selector:t}}(t.slice(1)),...tP(s),...e7(s),format:function(e){if("text"===e||"attrs"===e)return e;throw new I("INVALID_ARGS","get only supports text or attrs")}(t[0])})),[Q.replay]:t_(Q.replay,({client:e,positionals:t,flags:s})=>e.replay.run({...e7(s),path:tE(t[0],"replay requires path"),update:s.replayUpdate})),[Q.test]:t_(Q.test,({client:e,positionals:t,flags:s})=>(({json:s.json}).json||process.stderr.write("Running replay suite...\n"),e.replay.test({...e7(s),paths:t,update:s.replayUpdate,failFast:s.failFast,timeoutMs:s.timeoutMs,retries:s.retries,artifactsDir:s.artifactsDir,reportJunit:s.reportJunit}))),[Q.batch]:t_(Q.batch,({client:e,flags:t})=>e.batch.run({...e7(t),steps:t.batchSteps??[],onError:t.batchOnError,maxSteps:t.batchMaxSteps,out:t.out})),[Q.press]:t_(Q.press,({client:e,positionals:t,flags:s})=>e.interactions.press({...tO(t),...tP(s),...e7(s),count:s.count,intervalMs:s.intervalMs,holdMs:s.holdMs,jitterPx:s.jitterPx,doubleTap:s.doubleTap})),[Q.longPress]:t_(Q.longPress,({client:e,positionals:t,flags:s})=>e.interactions.longPress({...e7(s),x:Number(t[0]),y:Number(t[1]),durationMs:tF(t[2])})),[Q.swipe]:t_(Q.swipe,({client:e,positionals:t,flags:s})=>e.interactions.swipe({...e7(s),from:{x:Number(t[0]),y:Number(t[1])},to:{x:Number(t[2]),y:Number(t[3])},durationMs:tF(t[4]),count:s.count,pauseMs:s.pauseMs,pattern:s.pattern})),[Q.focus]:t_(Q.focus,({client:e,positionals:t,flags:s})=>e.interactions.focus({...e7(s),x:Number(t[0]),y:Number(t[1])})),[Q.type]:t_(Q.type,({client:e,positionals:t,flags:s})=>e.interactions.type({...e7(s),text:t.join(" "),delayMs:s.delayMs})),[Q.fill]:t_(Q.fill,({client:e,positionals:t,flags:s})=>e.interactions.fill({...function(e){if(e[0]?.startsWith("@")){let t=e.length>=3?e.slice(2).join(" "):e.slice(1).join(" ");return{ref:e[0],label:e.length>=3?e[1]:void 0,text:t}}let t=et(e,{preferTrailingValue:!0});return t?{selector:t.selectorExpression,text:t.rest.join(" ")}:{x:Number(e[0]),y:Number(e[1]),text:e.slice(2).join(" ")}}(t),...tP(s),...e7(s),delayMs:s.delayMs})),[Q.scroll]:t_(Q.scroll,({client:e,positionals:t,flags:s})=>e.interactions.scroll({...e7(s),direction:function(e){if("up"===e||"down"===e||"left"===e||"right"===e)return e;throw new I("INVALID_ARGS",`Unknown direction: ${String(e)}`)}(t[0]),amount:tF(t[1]),pixels:s.pixels})),[Q.pinch]:t_(Q.pinch,({client:e,positionals:t,flags:s})=>e.interactions.pinch({...e7(s),scale:Number(t[0]),x:tF(t[1]),y:tF(t[2])})),[Q.triggerAppEvent]:t_(Q.triggerAppEvent,({client:e,positionals:t,flags:s})=>e.apps.triggerEvent({...e7(s),event:tE(t[0],"trigger-app-event requires event"),payload:t[1]?function(e,t){try{let t=JSON.parse(e);if(t&&"object"==typeof t&&!Array.isArray(t))return t}catch{}throw new I("INVALID_ARGS",`${t} must be a JSON object`)}(t[1],"trigger-app-event payload"):void 0})),[Q.record]:t_(Q.record,({client:e,positionals:t,flags:s})=>e.recording.record({...e7(s),action:tM(t[0],"record"),path:t[1],fps:s.fps,quality:s.quality,hideTouches:s.hideTouches})),[Q.trace]:t_(Q.trace,({client:e,positionals:t,flags:s})=>e.recording.trace({...e7(s),action:tM(t[0],"trace"),path:t[1]})),[Q.logs]:t_(Q.logs,({client:e,positionals:t,flags:s})=>e.observability.logs({...e7(s),action:function(e){if(void 0!==e){if("path"===e||"start"===e||"stop"===e||"doctor"===e||"mark"===e||"clear"===e)return e;throw new I("INVALID_ARGS","logs requires path, start, stop, doctor, mark, or clear")}}(t[0]),message:t.slice(1).join(" ")||void 0,restart:s.restart})),[Q.network]:t_(Q.network,({client:e,positionals:t,flags:s})=>e.observability.network({...e7(s),action:function(e){if(void 0!==e){if("dump"===e||"log"===e)return e;throw new I("INVALID_ARGS","network requires dump or log")}}(t[0]),limit:tF(t[1]),include:s.networkInclude??function(e){if(void 0!==e){if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new I("INVALID_ARGS","network include mode must be summary, headers, body, or all")}}(t[2])})),[Q.find]:t_(Q.find,({client:e,positionals:t,flags:s})=>{var r;return e.interactions.find({...function(e){let t=function(e){if("text"===e||"label"===e||"value"===e||"role"===e||"id"===e)return e}(e[0]),s=void 0!==t,r=s?e[1]:e[0],o=s?2:1,n=e[o];if(void 0===n)return{locator:t,query:tE(r,"find requires query")};if("get"===n){let s=e[o+1];if("text"===s)return{locator:t,query:tE(r,"find requires query"),action:"getText"};if("attrs"===s)return{locator:t,query:tE(r,"find requires query"),action:"getAttrs"};throw new I("INVALID_ARGS","find get only supports text or attrs")}if("wait"===n)return{locator:t,query:tE(r,"find requires query"),action:"wait",timeoutMs:tF(e[o+1])};if("fill"===n||"type"===n)return{locator:t,query:tE(r,"find requires query"),action:n,value:e.slice(o+1).join(" ")};if("click"===n||"focus"===n||"exists"===n)return{locator:t,query:tE(r,"find requires query"),action:n};throw new I("INVALID_ARGS",`Unsupported find action: ${n}`)}(t),...{depth:(r=s).snapshotDepth,raw:r.snapshotRaw},...e7(s),first:s.findFirst,last:s.findLast})}),[Q.is]:t_(Q.is,({client:e,positionals:t,flags:s})=>e.interactions.is({...function(e){let t=e[0],s=et(e.slice(1),{preferTrailingValue:"text"===t});if(!s)throw new I("INVALID_ARGS","is requires a selector expression");if("text"===t)return{predicate:t,selector:s.selectorExpression,value:s.rest.join(" ")};if("visible"===t||"hidden"===t||"exists"===t||"editable"===t||"selected"===t)return{predicate:t,selector:s.selectorExpression};throw new I("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text")}(t),...tP(s),...e7(s)})),[Q.settings]:t_(Q.settings,({client:e,positionals:t,flags:s})=>e.settings.update(function(e,t){let s=e7(t),r=e[0],o=e[1];if(("wifi"===r||"airplane"===r||"location"===r)&&("on"===o||"off"===o)||"appearance"===r&&("light"===o||"dark"===o||"toggle"===o)||("faceid"===r||"touchid"===r)&&("match"===o||"nonmatch"===o||"enroll"===o||"unenroll"===o)||"fingerprint"===r&&("match"===o||"nonmatch"===o))return{...s,setting:r,state:o};if("permission"===r&&("grant"===o||"deny"===o||"reset"===o))return{...s,setting:r,state:o,permission:function(e){switch(e){case"camera":case"microphone":case"photos":case"contacts":case"contacts-limited":case"notifications":case"calendar":case"location":case"location-always":case"media-library":case"motion":case"reminders":case"siri":case"accessibility":case"screen-recording":case"input-monitoring":return e;default:throw new I("INVALID_ARGS","settings permission requires a permission target.")}}(e[2]),mode:function(e){if(void 0===e||"full"===e||"limited"===e)return e;throw new I("INVALID_ARGS","settings permission mode must be full or limited.")}(e[3])};throw new I("INVALID_ARGS","Invalid settings arguments.")}(t,s)))};function t_(e,t){return async({positionals:s,flags:r,client:o})=>{let n=await t({client:o,positionals:s,flags:r}),a=function(e,t,s,r){if(s.json)return e===Q.test?tA({suite:r,json:!0,reportJunit:s.reportJunit}):(eR({success:!0,data:r}),0);if(e===Q.test)return tA({suite:r,verbose:s.verbose,reportJunit:s.reportJunit});if(e===Q.batch)return!function(e){let t="number"==typeof e.total?e.total:0,s="number"==typeof e.executed?e.executed:0,r="number"==typeof e.totalDurationMs?e.totalDurationMs:void 0;for(let n of(process.stdout.write(`Batch completed: ${s}/${t} steps${void 0!==r?` in ${r}ms`:""}
57
+ `),Array.isArray(e.results)?e.results:[])){var o;if(!n||"object"!=typeof n)continue;let e="number"==typeof n.step?n.step:void 0,t="string"==typeof n.command?n.command:"step",s=!1!==n.ok,r="number"==typeof n.durationMs?n.durationMs:void 0,a=n.data&&"object"==typeof n.data?n.data:void 0,i=n.error&&"object"==typeof n.error?n.error:void 0,l=s?R(a)??t:(o=i,("string"==typeof o?.message&&o.message.length>0?o.message:null)??t),c=void 0!==e?`${e}. `:"- ",u=void 0!==r?` (${r}ms)`:"";process.stdout.write(`${c}${s?"OK":"FAILED"} ${l}${u}
58
+ `)}}(r),0;if(e===Q.get){let e=t[0];if("text"===e)return process.stdout.write(`${"string"==typeof r.text?r.text:""}
59
+ `),0;if("attrs"===e)return process.stdout.write(`${JSON.stringify(r.node??{},null,2)}
60
+ `),0}if(e===Q.find){if("string"==typeof r.text)return process.stdout.write(`${r.text}
61
+ `),0;if("boolean"==typeof r.found)return process.stdout.write(`Found: ${r.found}
62
+ `),0;if(r.node)return process.stdout.write(`${JSON.stringify(r.node,null,2)}
63
+ `),0}if(e===Q.is)return process.stdout.write(`Passed: is ${r.predicate??"assertion"}
64
+ `),0;if(e===Q.boot){let e=r.platform??"unknown",t=r.device??r.id??"unknown";return process.stdout.write(`Boot ready: ${t} (${e})
65
+ `),0}if(e===Q.record){let e="string"==typeof r.outPath?r.outPath:"";return e&&process.stdout.write(`${e}
66
+ `),0}if(e===Q.logs)return function(e,t){let s="string"==typeof e.path?e.path:"";if(!s)return;process.stdout.write(`${s}
67
+ `);let r=["active","state","backend","sizeBytes"].map(t=>void 0!==e[t]&&null!==e[t]?`${t}=${e[t]}`:"").filter(Boolean).join(" ");r&&!t.json&&process.stderr.write(`${r}
68
+ `);let o=["started","stopped","marked","cleared","restarted","removedRotatedFiles"].map(t=>{let s=e[t];return!0===s?`${t}=true`:"number"==typeof s?`${t}=${s}`:""}).filter(Boolean).join(" ");if(o&&!t.json&&process.stderr.write(`${o}
70
69
  `),e.hint&&!t.json&&process.stderr.write(`${e.hint}
71
70
  `),Array.isArray(e.notes)&&!t.json)for(let t of e.notes)"string"==typeof t&&t.length>0&&process.stderr.write(`${t}
72
- `)}(a,r),0;if(e===rB)return function(e){let t="string"==typeof e.path?e.path:"";t&&process.stdout.write(`${t}
73
- `);let r=Array.isArray(e.entries)?e.entries:[];if(0===r.length)process.stdout.write("No recent HTTP(s) entries found.\n");else for(let e of r){let t="string"==typeof e.method?e.method:"HTTP",r="string"==typeof e.url?e.url:"<unknown-url>",a="number"==typeof e.status?` status=${e.status}`:"",n="string"==typeof e.timestamp?`${e.timestamp} `:"",o="number"==typeof e.durationMs?` durationMs=${e.durationMs}`:"";process.stdout.write(`${n}${t} ${r}${a}${o}
71
+ `)}(r,s),0;if(e===Q.network)return function(e){let t="string"==typeof e.path?e.path:"";t&&process.stdout.write(`${t}
72
+ `);let s=Array.isArray(e.entries)?e.entries:[];if(0===s.length)process.stdout.write("No recent HTTP(s) entries found.\n");else for(let e of s){let t="string"==typeof e.method?e.method:"HTTP",s="string"==typeof e.url?e.url:"<unknown-url>",r="number"==typeof e.status?` status=${e.status}`:"",o="string"==typeof e.timestamp?`${e.timestamp} `:"",n="number"==typeof e.durationMs?` durationMs=${e.durationMs}`:"";process.stdout.write(`${o}${t} ${s}${r}${n}
74
73
  `),"string"==typeof e.headers&&process.stdout.write(` headers: ${e.headers}
75
74
  `),"string"==typeof e.requestBody&&process.stdout.write(` request: ${e.requestBody}
76
75
  `),"string"==typeof e.responseBody&&process.stdout.write(` response: ${e.responseBody}
77
- `)}let a=["active","state","backend","include","scannedLines","matchedLines"].map(t=>void 0!==e[t]&&null!==e[t]?`${t}=${e[t]}`:"").filter(Boolean).join(" ");if(a&&process.stderr.write(`${a}
76
+ `)}let r=["active","state","backend","include","scannedLines","matchedLines"].map(t=>void 0!==e[t]&&null!==e[t]?`${t}=${e[t]}`:"").filter(Boolean).join(" ");if(r&&process.stderr.write(`${r}
78
77
  `),Array.isArray(e.notes))for(let t of e.notes)"string"==typeof t&&t.length>0&&process.stderr.write(`${t}
79
- `)}(a),0;if(e===rL||e===rq){let e=a.ref??"",t=a.x,r=a.y;if(e&&"number"==typeof t&&"number"==typeof r)return process.stdout.write(`Tapped @${e} (${t}, ${r})
80
- `),0}if(e===rV)return process.stdout.write(`${JSON.stringify(a,null,2)}
81
- `),0;let n=U(a);return n&&process.stdout.write(`${n}
82
- `),0}(e,r,a,o);return 0!==s&&process.exit(s),!0}}function nh(e){return{depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}}function ng(e){if(e[0]?.startsWith("@"))return{ref:e[0],label:e.slice(1).join(" ")||void 0};let t=M(e);return t?{selector:t.selectorExpression}:{x:Number(e[0]),y:Number(e[1])}}function ny(e,t){if("start"===e||"stop"===e)return e;throw new eg("INVALID_ARGS",`${t} requires start|stop`)}function nw(e,t){if(void 0===e||""===e)throw new eg("INVALID_ARGS",t);return e}function nb(e){return void 0===e?void 0:Number(e)}let nv={...{session:az,[rE]:aW,[r$]:aQ,"ensure-simulator":aY,metro:aZ,install:a0,reinstall:a1,"install-from-source":a2,connect:a6,disconnect:a7,connection:a9,open:a8,close:a4,[rZ]:na,[rX]:no,[rM]:ns},...{[r5]:async({positionals:e,flags:t,client:r})=>(aJ(t,await r.command.wait(function(e,t){let r=T(e);if(!r)throw new eg("INVALID_ARGS","wait requires <ms>, text <text>, @ref, or <selector> [timeoutMs].");let a={...aH(t),depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw};if("sleep"===r.kind)return{...a,durationMs:r.durationMs};if("text"===r.kind){if(!r.text)throw new eg("INVALID_ARGS","wait requires text.");return{...a,text:r.text,...ni(r.timeoutMs)}}return"ref"===r.kind?{...a,ref:r.rawRef,...ni(r.timeoutMs)}:{...a,selector:r.selectorExpression,...ni(r.timeoutMs)}}(e,t))),!0),[rA]:async({positionals:e,flags:t,client:r})=>(aJ(t,await r.command.alert(function(e,t){if(e.length>2)throw new eg("INVALID_ARGS","alert accepts at most action and timeout arguments.");let r=function(e){let t=e?.toLowerCase();if(void 0===t||"get"===t||"accept"===t||"dismiss"===t||"wait"===t)return t;throw new eg("INVALID_ARGS","alert action must be get, accept, dismiss, or wait.")}(e[0]),a=function(e,t){if(void 0===e)return;let r=Number(e);if(Number.isFinite(r))return r;throw new eg("INVALID_ARGS",`${t} must be a finite number.`)}(e[1],"alert timeout");return{...aH(t),...r?{action:r}:{},...void 0!==a?{timeoutMs:a}:{}}}(e,t))),!0),[rS]:async({flags:e,client:t})=>{let r=await t.command.appState(aH(e));return aK(e,r,()=>(function(e){if("ios"===e.platform){let t=[`Foreground app: ${e.appName??e.appBundleId??"unknown"}`];return e.appBundleId&&t.push(`Bundle: ${e.appBundleId}`),e.source&&t.push(`Source: ${e.source}`),t.join("\n")}if("android"===e.platform){let t=[`Foreground app: ${e.package??"unknown"}`];return e.activity&&t.push(`Activity: ${e.activity}`),t.join("\n")}return null})(r)),!0},[rx]:async({flags:e,client:t})=>(aJ(e,await t.command.back({...aH(e),mode:e.backMode})),!0),[rO]:async({flags:e,client:t})=>(aJ(e,await t.command.home(aH(e))),!0),[rz]:async({positionals:e,flags:t,client:r})=>(aJ(t,await r.command.rotate(function(e,t){if(e.length>1)throw new eg("INVALID_ARGS","rotate accepts exactly one orientation argument.");return{...aH(t),orientation:v(e[0])}}(e,t))),!0),[rD]:async({flags:e,client:t})=>(aJ(e,await t.command.appSwitcher(aH(e))),!0),[rU]:async({positionals:e,flags:t,client:r})=>(aJ(t,await r.command.keyboard(function(e,t){if(e.length>1)throw new eg("INVALID_ARGS","keyboard accepts at most one action argument.");let r=function(e){let t=e?.toLowerCase();if("get"===t)return"status";if(void 0===t||"status"===t||"dismiss"===t)return t;throw new eg("INVALID_ARGS","keyboard action must be status, get, or dismiss.")}(e[0]);return{...aH(t),...r?{action:r}:{}}}(e,t))),!0),[r_]:async({positionals:e,flags:t,client:r})=>{var a,n;return a=t,n=await r.command.clipboard(function(e,t){let r=e[0]?.toLowerCase();if("read"!==r&&"write"!==r)throw new eg("INVALID_ARGS","clipboard requires a subcommand: read or write.");let a=aH(t);if("read"===r){if(1!==e.length)throw new eg("INVALID_ARGS","clipboard read does not accept additional arguments.");return{...a,action:r}}if(e.length<2)throw new eg("INVALID_ARGS","clipboard write requires text.");return{...a,action:r,text:e.slice(1).join(" ")}}(e,t)),a.json?aK(a,n):"read"===n.action?process.stdout.write(`${n.text}
83
- `):aJ(a,n),!0}},...nm};async function nI(e){let t=nv[e.command];return!!t&&await t(e)}function nk(e,t={}){let r=nA(t),a={...e};return r.defaultPlatform&&void 0===a.platform&&(a.platform=r.defaultPlatform),a}function nA(e){var t,r,a,n;let o,s=e.env??process.env,i=e.inheritedPlatform??e.configuredPlatform??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("ios"===t||"android"===t||"apple"===t)return t;throw new eg("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(s.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??s.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:i,lockPolicy:(r=e.policyOverrides,a=s,n=l,(o=r?.sessionLock??r?.sessionLockConflicts??nS(a.AGENT_DEVICE_SESSION_LOCK)??nS(a.AGENT_DEVICE_SESSION_LOCK_CONFLICTS))||(r?.sessionLocked===!0||P(a.AGENT_DEVICE_SESSION_LOCKED)||n?"reject":void 0))}}function nS(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new eg("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}let nD=ab.map(e=>e.key),n$={sendToDaemon:tS},nx=new Set(["launchUrl","metroBearerToken","metroKind","metroListenHost","metroNoInstallDeps","metroNoReuseExisting","metroPreparePort","metroProbeTimeoutMs","metroProjectRoot","metroProxyBaseUrl","metroPublicBaseUrl","metroRuntimeFile","metroStartupTimeoutMs","metroStatusHost"]),nN=new Set(["connect","connection","close","devices","disconnect","ensure-simulator","metro","session"]);async function nP(e,t=n$){let r=q(),a=K(),n=e.includes("--debug")||e.includes("--verbose")||e.includes("-v"),o=e.includes("--json"),s=function(e){for(let t=0;t<e.length;t+=1){let r=e[t];if(r.startsWith("--session=")){let e=r.slice(10).trim();return e.length>0?e:null}if("--session"===r){let r=e[t+1]?.trim();if(r&&!r.startsWith("-"))return r;break}}return null}(e)??process.env.AGENT_DEVICE_SESSION??"default";await ea({session:s,requestId:r,command:e[0],debug:n},async()=>{var s,l,c,u,d,p,m,h,g,y,w,b,v,I,k,A;let S,D,$,x,N,P,_;try{let t,r,a,n,o,b,v,I;s={cwd:process.cwd(),env:process.env},t=function(e){let t={json:!1,help:!1,version:!1},r=null,a=[],n=[],o=!0;for(let s=0;s<e.length;s+=1){let i=e[s];if(o&&"--"===i){o=!1;continue}if(!o){r?a.push(i):r=e8(i);continue}let l=i.startsWith("--"),c=i.startsWith("-")&&i.length>1;if(!l&&!c){r?a.push(i):r=e8(i);continue}let[u,d]=l?e2(i):[i,void 0],p=eT.get(u);if(!p){if(function(e,t,r){var a;if(a=r,!/^-\d+(\.\d+)?$/.test(a)||!e)return!1;let n=eO(e);return!n||!!n.allowsExtraPositionals||0!==n.positionalArgs.length&&(t.length<n.positionalArgs.length||n.positionalArgs.some(e=>e.includes("?")))}(r,a,i)){r?a.push(i):r=i;continue}throw new eg("INVALID_ARGS",`Unknown flag: ${u}`)}let m=function(e,t,r,a){if(void 0!==e.setValue){if(void 0!==r)throw new eg("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if("boolean"===e.type){if(void 0!==r)throw new eg("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if("booleanOrString"===e.type){if(void 0!==r){if(0===r.trim().length)throw new eg("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:r,consumeNext:!1}}return void 0===a||e5(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 n=r??a;if(void 0===n||void 0===r&&e5(n))throw new eg("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:n,consumeNext:void 0===r};if("enum"===e.type){if(!e.enumValues?.includes(n))throw new eg("INVALID_ARGS",`Invalid ${e3(t)}: ${n}`);return{value:n,consumeNext:void 0===r}}let o=Number(n);if(!Number.isFinite(o)||"number"==typeof e.min&&o<e.min||"number"==typeof e.max&&o>e.max)throw new eg("INVALID_ARGS",`Invalid ${e3(t)}: ${n}`);return{value:Math.floor(o),consumeNext:void 0===r}}(p,u,d,e[s+1]);m.consumeNext&&(s+=1);let f=t[p.key];if(p.multiple){let e=Array.isArray(f)?[...f,m.value]:void 0===f?[m.value]:[f,m.value];t[p.key]=e}else t[p.key]=m.value;n.push({key:p.key,token:u})}return{command:r,positionals:a,flags:t,warnings:[],providedFlags:n}}(e),r=s?.env??process.env,a=s?.cwd??process.cwd(),u=t.command,n=null!==u&&(l={remoteConfig:t.flags.remoteConfig,cwd:a,env:r}).remoteConfig?{...function(e){let t={};for(let r of nD){let a=e[r];void 0!==a&&(t[r]=a)}return t}(ak({configPath:l.remoteConfig,cwd:l.cwd,env:l.env}).profile),remoteConfig:l.remoteConfig}:{},v=eP((o=(c={command:t.command,cwd:a,cliFlags:t.flags,env:r}).env??process.env,b=eP({},function(e){let t={};for(let r of e)eP(t,function(e,t){let r,a;if(!f.existsSync(e)){if(t)throw new eg("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{r=f.readFileSync(e,"utf8")}catch(t){throw new eg("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{a=JSON.parse(r)}catch(t){throw new eg("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!a||"object"!=typeof a||Array.isArray(a))throw new eg("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let r={};for(let[a,n]of Object.entries(e)){let e=eQ.get(a);if(!e)throw new eg("INVALID_ARGS",`Unknown config key "${a}" in ${t}.`);if(!e.config.enabled)throw new eg("INVALID_ARGS",`Unsupported config key "${a}" in ${t}.`);r[a]=ez(e1(e),n,t,a)}return r}(a,`config file ${e}`)}(r.path,r.required));return t}((d=c.cwd,p=c.cliFlags.config,m=o,(I=p??m.AGENT_DEVICE_CONFIG)?[{path:(h=I,g=d,y=m,Y(h,{cwd:g,env:y})),required:!0}]:[{path:(w=m,i.join(C("~",{env:w}),".agent-device","config.json")),required:!1},{path:i.resolve(d,"agent-device.json"),required:!1}]))),eP(b,function(e,t){var r,a,n;let o={};for(let s of eZ.filter(e=>e.config.enabled&&e.supportsCommand(t))){let t=s.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(o[s.key]=(r=t.value,a=`environment variable ${t.name}`,n=t.name,ez(e1(s),r,a,n)))}return o}(o,c.command))),n),S={...function(e,t){let r=t?.strictFlags??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=[...e.warnings],n=eP({json:!1,help:!1,version:!1},t?.defaultFlags??{});eP(n,e.flags);let o=eO(e.command),s=e.providedFlags.filter(t=>!e0(t.key,e.command));if(s.length>0){var i,l;let t=s.map(e=>e.token),o=(i=e.command,l=t,i?1===l.length?`Flag ${l[0]} is not supported for command ${i}.`:`Flags ${l.join(", ")} are not supported for command ${i}.`:1===l.length?`Flag ${l[0]} requires a command that supports it.`:`Flags ${l.join(", ")} require a command that supports them.`);if(r)throw new eg("INVALID_ARGS",o);for(let e of(a.push(`${o} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),s))delete n[e.key]}for(let t of Object.keys(n))void 0!==n[t]&&(e0(t,e.command)||delete n[t]);if(function(e){if("back"===e.command&&!(new Set(e.providedFlags.filter(e=>"backMode"===e.key).map(e=>e.token)).size<=1))throw new eg("INVALID_ARGS","back accepts only one explicit mode flag: use either --in-app or --system.")}(e),o?.defaults)for(let[e,t]of Object.entries(o.defaults))void 0===n[e]&&(n[e]=t);if("batch"===e.command&&1!=+!!n.steps+ +!!n.stepsFile)throw new eg("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return function(e){if(e.flags.help)return e;if("snapshot"===e.command&&e.flags.snapshotDiff){let{snapshotDiff:t,...r}=e.flags;return{command:"diff",positionals:["snapshot",...e.positionals],flags:r,warnings:e.warnings}}return e}({command:e.command,positionals:e.positionals,flags:n,warnings:a})}(t,{strictFlags:s?.strictFlags,defaultFlags:v}),providedFlags:t.providedFlags}}catch(t){Q({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=ef(t,{diagnosticId:W().diagnosticId,logPath:eo({force:!0})??void 0});o?e4({success:!1,error:e}):e6(e,{showDetails:n}),process.exit(1);return}for(let e of S.warnings)process.stderr.write(`Warning: ${e}
84
- `);S.flags.version&&(process.stdout.write(`${a}
85
- `),process.exit(0));let E="help"===S.command,M=S.flags.help;if(E||M){E&&S.positionals.length>1&&(e6(new eg("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=E?S.positionals[0]:S.command;e||(process.stdout.write(`${ej}
86
- `),process.exit(0));let t=function(e){var t,r;let a=eO(e);if(!a)return null;let n=(t=e,(r=a).usageOverride?r.usageOverride:[t,...r.positionalArgs.map(eF),...r.allowedFlags.flatMap(e=>(eC.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")),o=eB(new Set(a.allowedFlags)),s=eB(eM),i=[];return o.length>0&&i.push(eV("Command flags:",o)),i.push(eV("Global flags:",s)),`agent-device ${n}
78
+ `)}(r),0;if(e===Q.click||e===Q.press){let e=r.ref??"",t=r.x,s=r.y;if(e&&"number"==typeof t&&"number"==typeof s)return process.stdout.write(`Tapped @${e} (${t}, ${s})
79
+ `),0}if(e===Q.perf)return process.stdout.write(`${JSON.stringify(r,null,2)}
80
+ `),0;let o=R(r);return o&&process.stdout.write(`${o}
81
+ `),0}(e,s,r,n);return 0!==a&&process.exit(a),!0}}function tP(e){return{depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}}function tO(e){if(e[0]?.startsWith("@"))return{ref:e[0],label:e.slice(1).join(" ")||void 0};let t=et(e);return t?{selector:t.selectorExpression}:{x:Number(e[0]),y:Number(e[1])}}function tM(e,t){if("start"===e||"stop"===e)return e;throw new I("INVALID_ARGS",`${t} requires start|stop`)}function tE(e,t){if(void 0===e||""===e)throw new I("INVALID_ARGS",t);return e}function tF(e){return void 0===e?void 0:Number(e)}let tj={...{session:ts,[Q.devices]:tr,[Q.apps]:ti,"ensure-simulator":tn,metro:ta,install:tl,reinstall:tc,"install-from-source":tu,connect:tg,disconnect:th,connection:ty,open:tm,close:tf,[Q.snapshot]:tk,[Q.screenshot]:tD,[Q.diff]:t$},...tS,...tC};async function tT(e){let t=tj[e.command];return!!t&&await t(e)}function tV(e,t={}){let s=tB(t),r={...e};return s.defaultPlatform&&void 0===r.platform&&(r.platform=s.defaultPlatform),r}function tB(e){var t,s,r,o;let n,a=e.env??process.env,i=e.inheritedPlatform??e.configuredPlatform??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("ios"===t||"android"===t||"apple"===t)return t;throw new I("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(a.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??a.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:i,lockPolicy:(s=e.policyOverrides,r=a,o=l,(n=s?.sessionLock??s?.sessionLockConflicts??tU(r.AGENT_DEVICE_SESSION_LOCK)??tU(r.AGENT_DEVICE_SESSION_LOCK_CONFLICTS))||(s?.sessionLocked===!0||d(r.AGENT_DEVICE_SESSION_LOCKED)||o?"reject":void 0))}}function tU(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new I("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}let tG=v.map(e=>e.key),tq={sendToDaemon:ee},tH=new Set(["launchUrl","metroBearerToken","metroKind","metroListenHost","metroNoInstallDeps","metroNoReuseExisting","metroPreparePort","metroProbeTimeoutMs","metroProjectRoot","metroProxyBaseUrl","metroPublicBaseUrl","metroRuntimeFile","metroStartupTimeoutMs","metroStatusHost"]),tK=new Set(["connect","connection","close","devices","disconnect","ensure-simulator","metro","session"]);async function tJ(e,t=tq){let s=C(),r=M(),o=e.includes("--debug")||e.includes("--verbose")||e.includes("-v"),n=e.includes("--json"),a=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}(e)??process.env.AGENT_DEVICE_SESSION??"default";await B({session:a,requestId:s,command:e[0],debug:o},async()=>{var a,l,c,p,d,m,f,g,y,v,D,A,x,L,R,N;let C,_,P,O,M,j,T;try{let t,s,r,o,n,h,b,$;a={cwd:process.cwd(),env:process.env},t=function(e){let t={json:!1,help:!1,version:!1},s=null,r=[],o=[],n=!0;for(let a=0;a<e.length;a+=1){let i=e[a];if(n&&"--"===i){n=!1;continue}if(!n){s?r.push(i):s=eL(i);continue}let l=i.startsWith("--"),c=i.startsWith("-")&&i.length>1;if(!l&&!c){s?r.push(i):s=eL(i);continue}let[u,p]=l?eI(i):[i,void 0],d=ec.get(u);if(!d){if(function(e,t,s){var r;if(r=s,!/^-\d+(\.\d+)?$/.test(r)||!e)return!1;let o=ep(e);return!o||!!o.allowsExtraPositionals||0!==o.positionalArgs.length&&(t.length<o.positionalArgs.length||o.positionalArgs.some(e=>e.includes("?")))}(s,r,i)){s?r.push(i):s=i;continue}throw new I("INVALID_ARGS",`Unknown flag: ${u}`)}let m=function(e,t,s,r){if(void 0!==e.setValue){if(void 0!==s)throw new I("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 I("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 I("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===r||ex(r)||!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("\\"))}(r)?{value:!0,consumeNext:!1}:{value:r,consumeNext:!0}}let o=s??r;if(void 0===o||void 0===s&&ex(o))throw new I("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:o,consumeNext:void 0===s};if("enum"===e.type){if(!e.enumValues?.includes(o))throw new I("INVALID_ARGS",`Invalid ${eA(t)}: ${o}`);return{value:o,consumeNext:void 0===s}}let n=Number(o);if(!Number.isFinite(n)||"number"==typeof e.min&&n<e.min||"number"==typeof e.max&&n>e.max)throw new I("INVALID_ARGS",`Invalid ${eA(t)}: ${o}`);return{value:Math.floor(n),consumeNext:void 0===s}}(d,u,p,e[a+1]);m.consumeNext&&(a+=1);let f=t[d.key];if(d.multiple){let e=Array.isArray(f)?[...f,m.value]:void 0===f?[m.value]:[f,m.value];t[d.key]=e}else t[d.key]=m.value;o.push({key:d.key,token:u})}return{command:s,positionals:r,flags:t,warnings:[],providedFlags:o}}(e),s=a?.env??process.env,r=a?.cwd??process.cwd(),p=t.command,o=null!==p&&(l={remoteConfig:t.flags.remoteConfig,cwd:r,env:s}).remoteConfig?{...function(e){let t={};for(let s of tG){let r=e[s];void 0!==r&&(t[s]=r)}return t}(w({configPath:l.remoteConfig,cwd:l.cwd,env:l.env}).profile),remoteConfig:l.remoteConfig}:{},b=er((n=(c={command:t.command,cwd:r,cliFlags:t.flags,env:s}).env??process.env,h=er({},function(e){let t={};for(let s of e)er(t,function(e,t){let s,r;if(!u.existsSync(e)){if(t)throw new I("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{s=u.readFileSync(e,"utf8")}catch(t){throw new I("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{r=JSON.parse(s)}catch(t){throw new I("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!r||"object"!=typeof r||Array.isArray(r))throw new I("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let s={};for(let[r,o]of Object.entries(e)){let e=eD.get(r);if(!e)throw new I("INVALID_ARGS",`Unknown config key "${r}" in ${t}.`);if(!e.config.enabled)throw new I("INVALID_ARGS",`Unsupported config key "${r}" in ${t}.`);s[r]=k(eS(e),o,t,r)}return s}(r,`config file ${e}`)}(s.path,s.required));return t}((d=c.cwd,m=c.cliFlags.config,f=n,($=m??f.AGENT_DEVICE_CONFIG)?[{path:(g=$,y=d,v=f,W(g,{cwd:y,env:v})),required:!0}]:[{path:(D=f,i.join(X("~",{env:D}),".agent-device","config.json")),required:!1},{path:i.resolve(d,"agent-device.json"),required:!1}]))),er(h,function(e,t){var s,r,o;let n={};for(let a of ek.filter(e=>e.config.enabled&&e.supportsCommand(t))){let t=a.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(n[a.key]=(s=t.value,r=`environment variable ${t.name}`,o=t.name,k(eS(a),s,r,o)))}return n}(n,c.command))),o),C={...function(e,t){let s=t?.strictFlags??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),r=[...e.warnings],o=er({json:!1,help:!1,version:!1},t?.defaultFlags??{});er(o,e.flags);let n=ep(e.command),a=e.providedFlags.filter(t=>!e$(t.key,e.command));if(a.length>0){var i,l;let t=a.map(e=>e.token),n=(i=e.command,l=t,i?1===l.length?`Flag ${l[0]} is not supported for command ${i}.`:`Flags ${l.join(", ")} are not supported for command ${i}.`:1===l.length?`Flag ${l[0]} requires a command that supports it.`:`Flags ${l.join(", ")} require a command that supports them.`);if(s)throw new I("INVALID_ARGS",n);for(let e of(r.push(`${n} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),a))delete o[e.key]}for(let t of Object.keys(o))void 0!==o[t]&&(e$(t,e.command)||delete o[t]);if(function(e){if("back"===e.command&&!(new Set(e.providedFlags.filter(e=>"backMode"===e.key).map(e=>e.token)).size<=1))throw new I("INVALID_ARGS","back accepts only one explicit mode flag: use either --in-app or --system.")}(e),n?.defaults)for(let[e,t]of Object.entries(n.defaults))void 0===o[e]&&(o[e]=t);if("batch"===e.command&&1!=+!!o.steps+ +!!o.stepsFile)throw new I("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return function(e){if(e.flags.help)return e;if("snapshot"===e.command&&e.flags.snapshotDiff){let{snapshotDiff:t,...s}=e.flags;return{command:"diff",positionals:["snapshot",...e.positionals],flags:s,warnings:e.warnings}}return e}({command:e.command,positionals:e.positionals,flags:o,warnings:r})}(t,{strictFlags:a?.strictFlags,defaultFlags:b}),providedFlags:t.providedFlags}}catch(t){F({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=S(t,{diagnosticId:E().diagnosticId,logPath:G({force:!0})??void 0});n?eR({success:!1,error:e}):eN(e,{showDetails:o}),process.exit(1);return}for(let e of C.warnings)process.stderr.write(`Warning: ${e}
82
+ `);C.flags.version&&(process.stdout.write(`${r}
83
+ `),process.exit(0));let B="help"===C.command,U=C.flags.help;if(B||U){B&&C.positionals.length>1&&(eN(new I("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=B?C.positionals[0]:C.command;e||(process.stdout.write(`${ef}
84
+ `),process.exit(0));let t=function(e){var t,s;let r=ep(e);if(!r)return null;let o=(t=e,(s=r).usageOverride?s.usageOverride:[t,...s.positionalArgs.map(em),...s.allowedFlags.flatMap(e=>(eu.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")),n=eg(new Set(r.allowedFlags)),a=eg(ei),i=[];return n.length>0&&i.push(eh("Command flags:",n)),i.push(eh("Global flags:",a)),`agent-device ${o}
87
85
 
88
- ${a.helpDescription}
86
+ ${r.helpDescription}
89
87
 
90
88
  Usage:
91
- agent-device ${n}
89
+ agent-device ${o}
92
90
 
93
91
  ${i.join("\n\n")}
94
- `}(e8(e));t&&(process.stdout.write(t),process.exit(0)),e6(new eg("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${ej}
95
- `),process.exit(1)}S.command||(process.stdout.write(`${ej}
96
- `),process.exit(1));let{command:R,positionals:T}=S,O=new Set(S.providedFlags.map(e=>e.key));try{$=(D=nA({policyOverrides:S.flags,configuredPlatform:S.flags.platform,configuredSession:S.flags.session})).lockPolicy?{...S.flags}:nk(S.flags,{policyOverrides:S.flags,configuredPlatform:S.flags.platform,configuredSession:S.flags.session}),x=en($.stateDir),N=$.session??"default",b={command:R,explicitFlagKeys:O,stateDir:x.baseDir,session:N,remoteConfig:$.remoteConfig},_=(P="connect"===b.command||"connection"===b.command?null:function(e){let t=e.validateRemoteConfigHash??!0,r=e.remoteConfig?aI({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,a=aA(e)??(e.allowActiveFallback?aL({stateDir:e.stateDir}):null);if(!a||r&&a.remoteConfigPath!==r)return null;if(t&&ax(a.remoteConfigPath)!==a.remoteConfigHash)throw new eg("INVALID_ARGS","Active remote connection config changed. Run agent-device connect --force to refresh it.",{remoteConfig:a.remoteConfigPath});let n=function(e,t){try{return ak({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(!1===t.validateRemoteConfigHash)return{};throw e}}(a,e);return{runtime:a.runtime,flags:{...n,remoteConfig:a.remoteConfigPath,daemonBaseUrl:a.daemon?.baseUrl??n.daemonBaseUrl,daemonTransport:a.daemon?.transport??n.daemonTransport,daemonServerMode:a.daemon?.serverMode??n.daemonServerMode,tenant:a.tenant,sessionIsolation:"tenant",runId:a.runId,leaseId:a.leaseId,leaseBackend:a.leaseBackend,session:a.session,platform:a.platform??n.platform,target:a.target??n.target}}}({stateDir:b.stateDir,session:b.session,remoteConfig:b.remoteConfig,cwd:process.cwd(),env:process.env,allowActiveFallback:!b.explicitFlagKeys.has("session")&&(!b.remoteConfig||"disconnect"===b.command),validateRemoteConfigHash:"disconnect"!==b.command}))?function(e,t,r){let a={...e};for(let[e,n]of Object.entries(t))void 0!==n&&(r.has(e)||(a[e]=n));return a}($,P.flags,O):$}catch(t){let e=ef(em(t),{diagnosticId:W().diagnosticId,logPath:eo({force:!0})??void 0});S.flags.json?e4({success:!1,error:e}):e6(e,{showDetails:S.flags.verbose}),process.exit(1);return}let U=null;try{let e;eN({command:R,currentVersion:a,stateDir:x.baseDir,flags:_});let n=P?.runtime,o=(e,t)=>({session:e.session??N,requestId:r,stateDir:e.stateDir,daemonBaseUrl:e.daemonBaseUrl,daemonAuthToken:e.daemonAuthToken,daemonTransport:e.daemonTransport,daemonServerMode:e.daemonServerMode,tenant:e.tenant,sessionIsolation:e.sessionIsolation,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,runtime:t,lockPolicy:D.lockPolicy,lockPlatform:D.defaultPlatform,cwd:process.cwd(),debug:!!e.verbose});if("batch"===R){if(T.length>0)throw new eg("INVALID_ARGS","batch does not accept positional arguments.");e=function(e){let t="";if(e.steps)t=e.steps;else if(e.stepsFile)try{t=f.readFileSync(e.stepsFile,"utf8")}catch(r){let t=r instanceof Error?r.message:String(r);throw new eg("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return L(t)}($)}if(_.remoteConfig&&(v=R,!nN.has(v))){let r=am(o(_,n),{transport:t.sendToDaemon}),a=await aC({command:R,flags:_,client:r,runtime:n,batchSteps:e,forceRuntimePrepare:function(e){for(let t of nx)if(e.has(t))return!0;return!1}(O)});_=a.flags,n=a.runtime}I={command:R,flags:_,runtime:n,explicitFlagKeys:O,hadConnectionDefaults:!!P},!("open"===I.command&&!I.runtime&&!I.flags.bundleUrl&&!I.flags.metroHost&&!I.flags.metroPort&&!I.flags.remoteConfig&&!I.hadConnectionDefaults&&((k=I.explicitFlagKeys).has("daemonBaseUrl")||k.has("daemonTransport")||k.has("tenant")||k.has("sessionIsolation")||k.has("runId")||k.has("leaseId")||k.has("leaseBackend")))||process.stderr.write("Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.\n");let s=_.daemonBaseUrl;U=!_.verbose||_.json||s?null:function(e){try{let t=0,r=!1,a=setInterval(()=>{if(!r&&f.existsSync(e))try{let r=f.statSync(e);if(r.size<t&&(t=0),r.size<=t)return;let a=f.openSync(e,"r");try{let e=Buffer.alloc(r.size-t);f.readSync(a,e,0,e.length,t),t=r.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{f.closeSync(a)}}catch{}},200);return()=>{r=!0,clearInterval(a)}}catch{return null}}(x.logPath);let i=am(o(_,n),{transport:t.sendToDaemon});if("batch"===R){if(!e)throw new eg("INVALID_ARGS","batch requires --steps or --steps-file.");let t=e.map((e,t)=>({...e,flags:D.lockPolicy&&void 0===$.platform?{...e.flags??{}}:nk(e.flags??{},{policyOverrides:_,configuredPlatform:_.platform,configuredSession:_.session,inheritedPlatform:_.platform})}));if(await nI({command:R,positionals:T,flags:{..._,batchSteps:t},client:i}))return}else if("runtime"===R)throw new eg("INVALID_ARGS","runtime command was removed. Use connect --remote-config <path> for remote runs, or metro prepare --remote-config <path> for inspection.");else if(await nI({command:R,positionals:T,flags:_,client:i}))return;throw new eg("INVALID_ARGS",`Unknown command: ${R}`)}catch(r){let e=em(r),t=ef(e,{diagnosticId:W().diagnosticId,logPath:eo({force:!0})??void 0});if("close"===R&&"COMMAND_FAILED"===(A=e).code&&(A.details?.kind==="daemon_startup_failed"||A.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof A.details?.infoPath||"string"==typeof A.details?.lockPath))){_.json&&e4({success:!0,data:{closed:"session",source:"no-daemon"}});return}if(_.json)e4({success:!1,error:t});else if(e6(t,{showDetails:_.verbose}),_.verbose)try{let e=x.logPath;if(f.existsSync(e)){let t=f.readFileSync(e,"utf8").split("\n"),r=t.slice(Math.max(0,t.length-200)).join("\n");r.trim().length>0&&process.stderr.write(`
92
+ `}(eL(e));t&&(process.stdout.write(t),process.exit(0)),eN(new I("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${ef}
93
+ `),process.exit(1)}C.command||(process.stdout.write(`${ef}
94
+ `),process.exit(1));let{command:q,positionals:H}=C,K=new Set(C.providedFlags.map(e=>e.key));try{P=(_=tB({policyOverrides:C.flags,configuredPlatform:C.flags.platform,configuredSession:C.flags.session})).lockPolicy?{...C.flags}:tV(C.flags,{policyOverrides:C.flags,configuredPlatform:C.flags.platform,configuredSession:C.flags.session}),O=V(P.stateDir),M=P.session??"default",A={command:q,explicitFlagKeys:K,stateDir:O.baseDir,session:M,remoteConfig:P.remoteConfig},T=(j="connect"===A.command||"connection"===A.command?null:function(e){let t=e.validateRemoteConfigHash??!0,s=e.remoteConfig?b({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,r=eB(e)??(e.allowActiveFallback?ez({stateDir:e.stateDir}):null);if(!r||s&&r.remoteConfigPath!==s)return null;if(t&&eH(r.remoteConfigPath)!==r.remoteConfigHash)throw new I("INVALID_ARGS","Active remote connection config changed. Run agent-device connect --force to refresh it.",{remoteConfig:r.remoteConfigPath});let o=function(e,t){try{return w({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(!1===t.validateRemoteConfigHash)return{};throw e}}(r,e);return{runtime:r.runtime,flags:{...o,remoteConfig:r.remoteConfigPath,daemonBaseUrl:r.daemon?.baseUrl??o.daemonBaseUrl,daemonTransport:r.daemon?.transport??o.daemonTransport,daemonServerMode:r.daemon?.serverMode??o.daemonServerMode,tenant:r.tenant,sessionIsolation:"tenant",runId:r.runId,leaseId:r.leaseId,leaseBackend:r.leaseBackend,session:r.session,platform:r.platform??o.platform,target:r.target??o.target}}}({stateDir:A.stateDir,session:A.session,remoteConfig:A.remoteConfig,cwd:process.cwd(),env:process.env,allowActiveFallback:!A.explicitFlagKeys.has("session")&&(!A.remoteConfig||"disconnect"===A.command),validateRemoteConfigHash:"disconnect"!==A.command}))?function(e,t,s){let r={...e};for(let[e,o]of Object.entries(t))void 0!==o&&(s.has(e)||(r[e]=o));return r}(P,j.flags,K):P}catch(t){let e=S($(t),{diagnosticId:E().diagnosticId,logPath:G({force:!0})??void 0});C.flags.json?eR({success:!1,error:e}):eN(e,{showDetails:C.flags.verbose}),process.exit(1);return}let J=null;try{let e;es({command:q,currentVersion:r,stateDir:O.baseDir,flags:T});let o=j?.runtime,n=(e,t)=>({session:e.session??M,requestId:s,stateDir:e.stateDir,daemonBaseUrl:e.daemonBaseUrl,daemonAuthToken:e.daemonAuthToken,daemonTransport:e.daemonTransport,daemonServerMode:e.daemonServerMode,tenant:e.tenant,sessionIsolation:e.sessionIsolation,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,runtime:t,lockPolicy:_.lockPolicy,lockPlatform:_.defaultPlatform,cwd:process.cwd(),debug:!!e.verbose});if("batch"===q){if(H.length>0)throw new I("INVALID_ARGS","batch does not accept positional arguments.");e=function(e){let t="";if(e.steps)t=e.steps;else if(e.stepsFile)try{t=u.readFileSync(e.stepsFile,"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new I("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return h(t)}(P)}if(T.remoteConfig&&(x=q,!tK.has(x))){let s=Z(n(T,o),{transport:t.sendToDaemon}),r=await e0({command:q,flags:T,client:s,runtime:o,batchSteps:e,forceRuntimePrepare:function(e){for(let t of tH)if(e.has(t))return!0;return!1}(K)});T=r.flags,o=r.runtime}L={command:q,flags:T,runtime:o,explicitFlagKeys:K,hadConnectionDefaults:!!j},!("open"===L.command&&!L.runtime&&!L.flags.bundleUrl&&!L.flags.metroHost&&!L.flags.metroPort&&!L.flags.remoteConfig&&!L.hadConnectionDefaults&&((R=L.explicitFlagKeys).has("daemonBaseUrl")||R.has("daemonTransport")||R.has("tenant")||R.has("sessionIsolation")||R.has("runId")||R.has("leaseId")||R.has("leaseBackend")))||process.stderr.write("Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.\n");let a=T.daemonBaseUrl;J=!T.verbose||T.json||a?null:function(e){try{let t=0,s=!1,r=setInterval(()=>{if(!s&&u.existsSync(e))try{let s=u.statSync(e);if(s.size<t&&(t=0),s.size<=t)return;let r=u.openSync(e,"r");try{let e=Buffer.alloc(s.size-t);u.readSync(r,e,0,e.length,t),t=s.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{u.closeSync(r)}}catch{}},200);return()=>{s=!0,clearInterval(r)}}catch{return null}}(O.logPath);let i=Z(n(T,o),{transport:t.sendToDaemon});if("batch"===q){if(!e)throw new I("INVALID_ARGS","batch requires --steps or --steps-file.");let t=e.map((e,t)=>({...e,flags:_.lockPolicy&&void 0===P.platform?{...e.flags??{}}:tV(e.flags??{},{policyOverrides:T,configuredPlatform:T.platform,configuredSession:T.session,inheritedPlatform:T.platform})}));if(await tT({command:q,positionals:H,flags:{...T,batchSteps:t},client:i}))return}else if("runtime"===q)throw new I("INVALID_ARGS","runtime command was removed. Use connect --remote-config <path> for remote runs, or metro prepare --remote-config <path> for inspection.");else if(await tT({command:q,positionals:H,flags:T,client:i}))return;throw new I("INVALID_ARGS",`Unknown command: ${q}`)}catch(s){let e=$(s),t=S(e,{diagnosticId:E().diagnosticId,logPath:G({force:!0})??void 0});if("close"===q&&"COMMAND_FAILED"===(N=e).code&&(N.details?.kind==="daemon_startup_failed"||N.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof N.details?.infoPath||"string"==typeof N.details?.lockPath))){T.json&&eR({success:!0,data:{closed:"session",source:"no-daemon"}});return}if(T.json)eR({success:!1,error:t});else if(eN(t,{showDetails:T.verbose}),T.verbose)try{let e=O.logPath;if(u.existsSync(e)){let t=u.readFileSync(e,"utf8").split("\n"),s=t.slice(Math.max(0,t.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
97
95
  [daemon log]
98
- ${r}
99
- `)}}catch{}U&&U(),process.exit(1)}finally{U&&U()}})}u(process.argv[1]??"").href===import.meta.url&&nP(process.argv.slice(2)).catch(e=>{e6(ef(em(e)),{showDetails:!0}),process.exit(1)}),nP(process.argv.slice(2));
96
+ ${s}
97
+ `)}}catch{}J&&J(),process.exit(1)}finally{J&&J()}})}c(process.argv[1]??"").href===import.meta.url&&tJ(process.argv.slice(2)).catch(e=>{eN(S($(e)),{showDetails:!0}),process.exit(1)}),tJ(process.argv.slice(2));