agent-device 0.12.1 → 0.12.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/src/bin.js CHANGED
@@ -1,98 +1,99 @@
1
- let e,t,r,a,o,s,n;import i from"node:path";import{styleText as l}from"node:util";import{fileURLToPath as u,pathToFileURL as c}from"node:url";import p from"node:net";import d from"node:http";import m from"node:https";import f,{promises as h}from"node:fs";import{spawn as g}from"node:child_process";import{createHash as y}from"node:crypto";import w from"node:os";import{PNG as b}from"pngjs";import{parseDeviceRotation as v,SESSION_SURFACES as k,readProcessCommand as I,waitForProcessExit as A,serializeSessionListEntry as D,serializeSnapshotResult as S,isAgentDeviceDaemonProcess as $,buildDeviceIdentifiers as N,buildAppIdentifiers as x,isEnvTruthy as L,parseBatchStepsJson as E,computeDaemonCodeSignature as P,resolveDaemonTransportPreference as _,splitSelectorFromArgs as M,serializeOpenResult as T,parseWaitArgs as R,expandUserHomePath as O,serializeDeployResult as C,readCommandMessage as U,serializeEnsureSimulatorResult as F,serializeDevice as j,buildSnapshotDisplayLines as V,buildMobileSnapshotPresentation as G,createRequestId as B,tryParseSelectorChain as q,readVersion as J,displayNodeLabel as H,findProjectRoot as K,getDiagnosticsMeta as z,withDiagnosticTimer as W,resolveUserPath as X,serializeCloseResult as Y,emitDiagnostic as Z,SETTINGS_USAGE_OVERRIDE as Q,isProcessAlive as ee,readProcessStartTime as et,withDiagnosticsScope as er,resolveDaemonPaths as ea,flushDiagnosticsToSessionFile as eo,resolveDaemonServerMode as es,serializeInstallFromSourceResult as en,decodePng as ei,stopProcessForTakeover as el,formatSnapshotLine as eu}from"./155.js";import{runCmdDetached as ec,runCmdSync as ep,asAppError as ed,normalizeError as em,AppError as ef}from"./818.js";import{METRO_COMPANION_RUN_ARG as eh,normalizeBaseUrl as eg,buildBundleUrl as ey,ENV_SERVER_BASE_URL as ew,ENV_LOCAL_BASE_URL as eb,ENV_STATE_PATH as ev,ENV_LAUNCH_URL as ek,ENV_BEARER_TOKEN as eI}from"./320.js";import{maybeRunUpgradeNotifier as eA}from"./113.js";function eD(e,t){for(let[r,a]of Object.entries(t))void 0!==a&&(e[r]=a);return e}let eS=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],e$=["snapshotDepth","snapshotScope","snapshotRaw"],eN=[{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:"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:k,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:"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"},{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)"}],ex=new Set(["json","config","remoteConfig","stateDir","daemonBaseUrl","daemonAuthToken","daemonTransport","daemonServerMode","tenant","sessionIsolation","runId","leaseId","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"]},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",...eS]},diff:{usageOverride:"diff snapshot | diff screenshot --baseline <path> [--out <diff.png>] [--threshold <0-1>]",helpDescription:"Diff accessibility snapshot or compare screenshots pixel-by-pixel",summary:"Diff snapshot or screenshot",positionalArgs:["kind"],allowedFlags:[...eS,"baseline","threshold","out"]},"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>] [--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","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:Q,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}},eE=new Map,eP=new Map;for(let e of eN){for(let t of e.names)eE.set(t,e);let t=eP.get(e.key);t?t.push(e):eP.set(e.key,[e])}function e_(e){if(e)return eL[e]}function eM(){return Object.keys(eL)}function eT(e){let t=e.endsWith("?"),r=t?e.slice(0,-1):e;return t?`[${r}]`:`<${r}>`}let eR=(e=`agent-device <command> [args] [--json]
1
+ let e,t,r,n,a,i,o;import s 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{spawn as g}from"node:child_process";import y,{createHash as w}from"node:crypto";import b from"node:os";import{PNG as v}from"pngjs";import{parseDeviceRotation as k,SESSION_SURFACES as x,readProcessCommand as I,waitForProcessExit as A,serializeSessionListEntry as D,serializeSnapshotResult as S,isAgentDeviceDaemonProcess as $,buildDeviceIdentifiers as M,buildAppIdentifiers as P,isEnvTruthy as N,parseBatchStepsJson as L,computeDaemonCodeSignature as R,resolveDaemonTransportPreference as _,splitSelectorFromArgs as E,serializeOpenResult as T,parseWaitArgs as C,expandUserHomePath as O,serializeDeployResult as U,readCommandMessage as F,serializeEnsureSimulatorResult as j,serializeDevice as B,buildSnapshotDisplayLines as V,buildMobileSnapshotPresentation as G,createRequestId as q,tryParseSelectorChain as H,readVersion as K,displayNodeLabel as X,findProjectRoot as Y,getDiagnosticsMeta as J,withDiagnosticTimer as z,resolveUserPath as W,serializeCloseResult as Z,emitDiagnostic as Q,SETTINGS_USAGE_OVERRIDE as ee,isProcessAlive as et,readProcessStartTime as er,withDiagnosticsScope as en,resolveDaemonPaths as ea,flushDiagnosticsToSessionFile as ei,resolveDaemonServerMode as eo,serializeInstallFromSourceResult as es,decodePng as el,stopProcessForTakeover as ec,formatSnapshotLine as eu}from"./155.js";import{whichCmd as ed,runCmdDetached as ep,runCmdSync as em,asAppError as ef,normalizeError as eh,runCmd as eg,AppError as ey}from"./818.js";import{METRO_COMPANION_RUN_ARG as ew,normalizeBaseUrl as eb,buildBundleUrl as ev,ENV_SERVER_BASE_URL as ek,ENV_LOCAL_BASE_URL as ex,ENV_STATE_PATH as eI,ENV_LAUNCH_URL as eA,ENV_BEARER_TOKEN as eD}from"./320.js";import{maybeRunUpgradeNotifier as eS}from"./113.js";function e$(e,t){for(let[r,n]of Object.entries(t))void 0!==n&&(e[r]=n);return e}let eM=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],eP=["snapshotDepth","snapshotScope","snapshotRaw"],eN=[{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:x,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:"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)"}],eL=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, allocate a tenant lease, and prepare Metro",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",...eM]},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:[...eM,"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:[...eP]},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",...eP]},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:[...eP]},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",...eP]},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:[...eP,"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>] [--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","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:[...eP]},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}},e_=new Map,eE=new Map;for(let e of eN){for(let t of e.names)e_.set(t,e);let t=eE.get(e.key);t?t.push(e):eE.set(e.key,[e])}function eT(e){if(e)return eR[e]}function eC(){return Object.keys(eR)}function eO(e){let t=e.endsWith("?"),r=t?e.slice(0,-1):e;return t?`[${r}]`:`<${r}>`}let eU=(e=`agent-device <command> [args] [--json]
2
2
 
3
3
  CLI to control iOS and Android devices for AI agents.
4
- `,t=eU("Commands:",eM().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 r=t.positionalArgs.map(r=>{var a,o,s;let n,i,l,u;return a=e,o=t,i=(n=(s=r).endsWith("?"))?s.slice(0,-1):s,u=(l=/^[a-z-]+(?:\|[a-z-]+)+$/i.test(i))||void 0!==o.usageOverride&&o.usageOverride.startsWith(`${a} ${i}`),n?l?`[${i}]`:u?i:`[${i}]`:u?i:`<${i}>`});return[e,...r].join(" ")}(e,t)}}).map(e=>({label:e.usage,description:e.schema.summary??e.schema.helpDescription}))),r=eC("Flags:",eO(ex)),a=[eU("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=eF("Configuration:",["Default config files: ~/.agent-device/config.json, ./agent-device.json","Use --config <path> or AGENT_DEVICE_CONFIG to load one explicit config file."]),s=eU("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"}]),n=eF("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=eB("Commands:",eC().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 n,a,i;let o,s,l,c;return n=e,a=t,s=(o=(i=r).endsWith("?"))?i.slice(0,-1):i,c=(l=/^[a-z-]+(?:\|[a-z-]+)+$/i.test(s))||void 0!==a.usageOverride&&a.usageOverride.startsWith(`${n} ${s}`),o?l?`[${s}]`:c?s:`[${s}]`:c?s:`<${s}>`});return[e,...r].join(" ")}(e,t)}}).map(e=>({label:e.usage,description:e.schema.summary??e.schema.helpDescription}))),r=ej("Flags:",eF(eL)),n=[eB("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"),a=eV("Configuration:",["Default config files: ~/.agent-device/config.json, ./agent-device.json","Use --config <path> or AGENT_DEVICE_CONFIG to load one explicit config file."]),i=eB("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"}]),o=eV("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
7
  ${r}
8
8
 
9
- ${a}
9
+ ${n}
10
10
 
11
- ${o}
11
+ ${a}
12
12
 
13
- ${s}
13
+ ${i}
14
14
 
15
- ${n}
16
- `);function eO(e){return eN.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function eC(e,t){return eU(e,t.map(e=>({label:e.usageLabel??"",description:e.usageDescription??""})))}function eU(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 eF(e,t){return 0===t.length?`${e}
18
- (none)`:[e,...t.map(e=>` ${e}`)].join("\n")}let ej=new Set(["1","true","yes","on"]),eV=new Set(["0","false","no","off"]);function eG(e){return`AGENT_DEVICE_${e.replace(/([A-Z])/g,"_$1").replace(/[^A-Za-z0-9_]/g,"_").toUpperCase()}`}function eB(e,t,r,a){if(e.multiple)return(Array.isArray(t)?t:[t]).map(t=>eB({...e,multiple:!1},t,r,a));if("boolean"===e.type){var o=t,s=r,n=a;if("boolean"==typeof o)return o;if("string"==typeof o){let e=eq(o);if(void 0!==e)return e}throw new ef("INVALID_ARGS",`Invalid value for "${n}" in ${s}. Expected boolean.`)}if("booleanOrString"===e.type){if("boolean"==typeof t)return t;if("string"==typeof t&&void 0!==eq(t))return eq(t);if("string"==typeof t&&t.trim().length>0)return t;throw new ef("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 ef("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,u=r,c=a;let o=i.setValue;if(l===o)return o;if("string"==typeof l){let e=l.trim();if(""===e||"true"===e||"1"===e)return o;if("false"===e||"0"===e)return}if(!0===l)return o;if(!1!==l)throw new ef("INVALID_ARGS",`Invalid value for "${c}" in ${u}. Expected boolean-like value for enum flag.`);return}if("string"!=typeof t||!e.enumValues?.includes(t))throw new ef("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Expected one of: ${e.enumValues?.join(", ")}.`);return t}let p="number"==typeof t?t:"string"==typeof t?Number(t):NaN;if(!Number.isFinite(p)||!Number.isInteger(p))throw new ef("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Expected integer.`);if("number"==typeof e.min&&p<e.min)throw new ef("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Must be >= ${e.min}.`);if("number"==typeof e.max&&p>e.max)throw new ef("INVALID_ARGS",`Invalid value for "${a}" in ${r}. Must be <= ${e.max}.`);return p}function eq(e){let t=e.trim().toLowerCase();return!!ej.has(t)||!eV.has(t)&&void 0}let eJ=new Set(["config","remoteConfig","help","version","batchSteps"]),eH={iosSimulatorDeviceSet:["IOS_SIMULATOR_DEVICE_SET"],androidDeviceAllowlist:["ANDROID_DEVICE_ALLOWLIST"],metroBearerToken:["AGENT_DEVICE_PROXY_TOKEN"]},eK=function(){let e=new Map;for(let t of eN){let r=e.get(t.key);r?r.push(t):e.set(t.key,[t])}let t=new Map;for(let e of ex)t.set(e,new Set(["*"]));for(let e of eM()){let r=e_(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:!eJ.has(e),key:e},env:{names:[eG(e),...eH[e]??[]]},supportsCommand(r){let a=t.get(e);return!!a&&(!!a.has("*")||!!r&&a.has(r))}})).sort((e,t)=>e.key.localeCompare(t.key))}(),ez=new Map(eK.map(e=>[e.key,e]));function eW(e,t){return ez.get(e)?.supportsCommand(t)??!1}function eX(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 eY(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function eZ(e){return e.replace(/^-+/,"")}function eQ(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?eY(e):[e,void 0];return void 0!==eE.get(t)}function e0(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}function e1(e){process.stdout.write(`${JSON.stringify(e,null,2)}
19
- `)}function e2(e,t={}){let r=e instanceof ef?em(e):e;process.stderr.write(`Error (${r.code}): ${r.message}
15
+ ${o}
16
+ `);function eF(e){return eN.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function ej(e,t){return eB(e,t.map(e=>({label:e.usageLabel??"",description:e.usageDescription??""})))}function eB(e,t){if(0===t.length)return`${e}
17
+ (none)`;let r=Math.max(...t.map(e=>e.label.length))+2,n=[e];for(let e of t)n.push(` ${e.label.padEnd(r)}${e.description}`);return n.join("\n")}function eV(e,t){return 0===t.length?`${e}
18
+ (none)`:[e,...t.map(e=>` ${e}`)].join("\n")}let eG=new Set(["1","true","yes","on"]),eq=new Set(["0","false","no","off"]);function eH(e){return`AGENT_DEVICE_${e.replace(/([A-Z])/g,"_$1").replace(/[^A-Za-z0-9_]/g,"_").toUpperCase()}`}function eK(e,t,r,n){if(e.multiple)return(Array.isArray(t)?t:[t]).map(t=>eK({...e,multiple:!1},t,r,n));if("boolean"===e.type){var a=t,i=r,o=n;if("boolean"==typeof a)return a;if("string"==typeof a){let e=eX(a);if(void 0!==e)return e}throw new ey("INVALID_ARGS",`Invalid value for "${o}" in ${i}. Expected boolean.`)}if("booleanOrString"===e.type){if("boolean"==typeof t)return t;if("string"==typeof t&&void 0!==eX(t))return eX(t);if("string"==typeof t&&t.trim().length>0)return t;throw new ey("INVALID_ARGS",`Invalid value for "${n}" in ${r}. Expected boolean or non-empty string.`)}if("string"===e.type){if("string"==typeof t&&t.trim().length>0)return t;throw new ey("INVALID_ARGS",`Invalid value for "${n}" in ${r}. Expected non-empty string.`)}if("enum"===e.type){if(void 0!==e.setValue){var s=e,l=t,c=r,u=n;let a=s.setValue;if(l===a)return a;if("string"==typeof l){let e=l.trim();if(""===e||"true"===e||"1"===e)return a;if("false"===e||"0"===e)return}if(!0===l)return a;if(!1!==l)throw new ey("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 ey("INVALID_ARGS",`Invalid value for "${n}" 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 ey("INVALID_ARGS",`Invalid value for "${n}" in ${r}. Expected integer.`);if("number"==typeof e.min&&d<e.min)throw new ey("INVALID_ARGS",`Invalid value for "${n}" in ${r}. Must be >= ${e.min}.`);if("number"==typeof e.max&&d>e.max)throw new ey("INVALID_ARGS",`Invalid value for "${n}" in ${r}. Must be <= ${e.max}.`);return d}function eX(e){let t=e.trim().toLowerCase();return!!eG.has(t)||!eq.has(t)&&void 0}let eY=new Set(["config","remoteConfig","help","version","batchSteps"]),eJ={iosSimulatorDeviceSet:["IOS_SIMULATOR_DEVICE_SET"],androidDeviceAllowlist:["ANDROID_DEVICE_ALLOWLIST"],metroBearerToken:["AGENT_DEVICE_PROXY_TOKEN"]},ez=function(){let e=new Map;for(let t of eN){let r=e.get(t.key);r?r.push(t):e.set(t.key,[t])}let t=new Map;for(let e of eL)t.set(e,new Set(["*"]));for(let e of eC()){let r=eT(e);if(r)for(let n of r.allowedFlags){let r=t.get(n);r&&r.has("*")||(r?r.add(e):t.set(n,new Set([e])))}}return[...e.entries()].map(([e,r])=>({key:e,flagDefinitions:r,config:{enabled:!eY.has(e),key:e},env:{names:[eH(e),...eJ[e]??[]]},supportsCommand(r){let n=t.get(e);return!!n&&(!!n.has("*")||!!r&&n.has(r))}})).sort((e,t)=>e.key.localeCompare(t.key))}(),eW=new Map(ez.map(e=>[e.key,e]));function eZ(e,t){return eW.get(e)?.supportsCommand(t)??!1}function eQ(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 e0(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function e1(e){return e.replace(/^-+/,"")}function e2(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?e0(e):[e,void 0];return void 0!==e_.get(t)}function e3(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}function e5(e){process.stdout.write(`${JSON.stringify(e,null,2)}
19
+ `)}function e8(e,t={}){let r=e instanceof ey?eh(e):e;process.stderr.write(`Error (${r.code}): ${r.message}
20
20
  `),r.hint&&process.stderr.write(`Hint: ${r.hint}
21
21
  `),r.diagnosticId&&process.stderr.write(`Diagnostic ID: ${r.diagnosticId}
22
22
  `),r.logPath&&process.stderr.write(`Diagnostics Log: ${r.logPath}
23
23
  `),t.showDetails&&r.details&&process.stderr.write(`${JSON.stringify(r.details,null,2)}
24
- `)}function e3(e){return"number"==typeof e&&Number.isFinite(e)?e:0}function e5(){let e=process.env.FORCE_COLOR;return"string"==typeof e?"0"!==e:"string"!=typeof process.env.NO_COLOR&&!!process.stdout.isTTY}function e8(e){let t=e.warnings;return Array.isArray(t)?t.filter(e=>"string"==typeof e&&e.length>0):[]}function e4(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 o=" ".repeat(e.depth+1);return a.map(e=>`${o}${e}`)}let e6="sha256";async function e7(e){let{localPath:t,baseUrl:r,token:a}=e,o=f.statSync(t),s=o.isDirectory(),n=i.basename(t),l=s?"app-bundle":"file",u=r.endsWith("/")?r:`${r}/`,c=s?void 0:await te(t);if(c){let e=await e9({normalizedBase:u,token:a,hash:c,filename:n,sizeBytes:o.size,artifactType:l});if(e)return e}let p=new URL("upload",u),h="https:"===p.protocol?m:d,y={"x-artifact-type":l,"x-artifact-filename":n,"transfer-encoding":"chunked"};return c&&(y["x-artifact-hash"]=c,y["x-artifact-hash-algorithm"]=e6),a&&(y.authorization=`Bearer ${a}`,y["x-agent-device-token"]=a),new Promise((e,r)=>{let a=h.request({protocol:p.protocol,host:p.hostname,port:p.port,method:"POST",path:p.pathname+p.search,headers:y},t=>{let a="";t.setEncoding("utf8"),t.on("data",e=>{a+=e}),t.on("end",()=>{clearTimeout(o);try{let t=JSON.parse(a);if(!t.ok||!t.uploadId)return void r(new ef("COMMAND_FAILED",`Upload failed: ${a}`));e(t.uploadId)}catch{r(new ef("COMMAND_FAILED",`Invalid upload response: ${a}`))}})}),o=setTimeout(()=>{a.destroy(),r(new ef("COMMAND_FAILED","Artifact upload timed out",{timeoutMs:3e5,hint:"The upload to the remote daemon exceeded the 5-minute timeout."}))},3e5);if(a.on("error",e=>{clearTimeout(o),r(new ef("COMMAND_FAILED","Failed to upload artifact to remote daemon",{hint:"Verify the remote daemon is reachable and supports artifact uploads."},e))}),s){let e=g("tar",["cf","-","-C",i.dirname(t),i.basename(t)],{stdio:["ignore","pipe","pipe"]});e.stdout.pipe(a),e.on("error",e=>{a.destroy(),r(new ef("COMMAND_FAILED","Failed to create tar archive for app bundle",{},e))}),e.on("close",e=>{0!==e&&(a.destroy(),r(new ef("COMMAND_FAILED",`tar failed with exit code ${e}`)))})}else{let e=f.createReadStream(t);e.pipe(a),e.on("error",e=>{a.destroy(),r(new ef("COMMAND_FAILED","Failed to read local artifact",{},e))})}})}async function e9(e){var t;let r=new URL("upload/preflight",e.normalizedBase),a={"content-type":"application/json"};e.token&&(a.authorization=`Bearer ${e.token}`,a["x-agent-device-token"]=e.token);let o=await fetch(r,{method:"POST",headers:a,signal:AbortSignal.timeout(3e4),body:JSON.stringify({hash:e.hash,hashAlgorithm:e6,fileName:e.filename,sizeBytes:e.sizeBytes,artifactType:e.artifactType})}).catch(()=>void 0);if(!o?.ok)return;let s=await o.json().catch(()=>void 0);return(t=s)&&"object"==typeof t&&!0===t.ok&&!0===t.cacheHit&&"string"==typeof t.uploadId?s.uploadId:void 0}async function te(e){let t=y(e6);return await new Promise((r,a)=>{f.createReadStream(e).on("data",e=>t.update(e)).on("error",e=>{a(new ef("COMMAND_FAILED","Failed to read local artifact",{},e))}).on("end",r)}),t.digest("hex")}let tt=tR(),tr=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}(),ta=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}(),to=["xcodebuild .*AgentDeviceRunnerUITests/RunnerTests/testCommand","xcodebuild .*AgentDeviceRunner\\.env\\.session-","xcodebuild build-for-testing .*ios-runner/AgentDeviceRunner/AgentDeviceRunner\\.xcodeproj"],ts=new p.BlockList;async function tn(e){let t=e.meta?.requestId??B(),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 ef("INVALID_ARGS","Invalid daemon base URL",{daemonBaseUrl:e},t instanceof Error?t:void 0)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new ef("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),o=e.flags?.daemonAuthToken??process.env.AGENT_DEVICE_DAEMON_AUTH_TOKEN;var s=a,n=o;if(!(!s||"localhost"===(t=new URL(s).hostname.trim().toLowerCase().replace(/^\[(.*)\]$/,"$1"))||(p.isIPv4(t)?ts.check(t,"ipv4"):!!p.isIPv6(t)&&ts.check(t,"ipv6")))&&("string"!=typeof n||!(n.trim().length>0)))throw new ef("INVALID_ARGS","Remote daemon base URL for non-loopback hosts requires daemon authentication",{daemonBaseUrl:s,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=_(i);if(a&&"socket"===l)throw new ef("INVALID_ARGS","Remote daemon base URL only supports HTTP transport. Remove --daemon-transport socket.",{daemonBaseUrl:a});let u=es(e.flags?.daemonServerMode??process.env.AGENT_DEVICE_DAEMON_SERVER_MODE??("dual"===i?"dual":void 0));return{paths:ea(r),transportPreference:l,serverMode:u,remoteBaseUrl:a,remoteAuthToken:o}}(e),o=function(e,t=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS){if("test"!==e)return tR(t)}(e.command),s=await W("daemon_startup",async()=>await tp(a),{requestId:t,session:e.session}),n=await ti(e,s),i={...e,positionals:n.positionals,flags:n.flags,token:s.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,...n.uploadedArtifactId?{uploadedArtifactId:n.uploadedArtifactId}:{},...n.clientArtifactPaths?{clientArtifactPaths:n.clientArtifactPaths}:{},...n.installSource?{installSource:n.installSource}:{}}};return Z({level:"info",phase:"daemon_request_prepare",data:{requestId:t,command:e.command,session:e.session}}),await W("daemon_request",async()=>await tD(s,i,a.transportPreference,o),{requestId:t,command:e.command})}async function ti(e,t){let r,a=[...e.positionals??[]],o=e.flags?{...e.flags}:void 0,s=e.meta?.installSource,n={};if(tP(t)){let l=function(e,t){if("screenshot"===e.command){let r=tu(e,"path",".png");return t[0]?{field:"path",localPath:r,positionalIndex:0,positionalPath:tc("screenshot",".png")}:{field:"path",localPath:r,positionalIndex:0,flagPath:tc("screenshot",".png")}}if("record"===e.command&&"start"===(t[0]??"").toLowerCase()){let t=tu(e,"outPath",".mp4",1);return{field:"outPath",localPath:t,positionalIndex:1,positionalPath:tc("recording",i.extname(t)||".mp4")}}return null}(e,a);l&&(void 0!==l.positionalPath&&(a[l.positionalIndex]=l.positionalPath),void 0!==l.flagPath&&((o??={}).out=l.flagPath),n[l.field]=l.localPath);let u=await tl(e,t);u&&(s=u.installSource,r=u.uploadedArtifactId??r)}if(!tP(t)||"install"!==e.command&&"reinstall"!==e.command||a.length<2)return{positionals:a,flags:o,installSource:s,uploadedArtifactId:r,...Object.keys(n).length>0?{clientArtifactPaths:n}:{}};let l=a[1];if(l.startsWith("remote:"))return a[1]=l.slice(7),{positionals:a,flags:o,...Object.keys(n).length>0?{clientArtifactPaths:n}:{}};let u=i.isAbsolute(l)?l:i.resolve(e.meta?.cwd??process.cwd(),l);return f.existsSync(u)?{positionals:a,flags:o,installSource:s,uploadedArtifactId:r=await e7({localPath:u,baseUrl:t.baseUrl,token:t.token}),...Object.keys(n).length>0?{clientArtifactPaths:n}:{}}:{positionals:a,flags:o,...Object.keys(n).length>0?{clientArtifactPaths:n}:{}}}async function tl(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 o=i.isAbsolute(a)?a:i.resolve(e.meta?.cwd??process.cwd(),a);if(!f.existsSync(o))return{installSource:{...r,path:o}};let s=await e7({localPath:o,baseUrl:t.baseUrl,token:t.token});return{installSource:{...r,path:o},uploadedArtifactId:s}}function tu(e,t,r,a=0){let o=e.positionals?.[a]??e.flags?.out,s=`${"path"===t?"screenshot":"recording"}-${Date.now()}${r}`,n=o&&o.trim().length>0?o:s;return i.isAbsolute(n)?n:i.resolve(e.meta?.cwd??process.cwd(),n)}function tc(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 tk(t,"http"))return t;throw new ef("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=tg(e.paths.infoPath),a=J(),o=P((t=tA()).useSrc?t.srcPath:t.distPath,t.root),s=!!r&&await tk(r,e.transportPreference);if(r&&r.version===a&&r.codeSignature===o&&s)return r;r&&(r.version!==a||r.codeSignature!==o||!s)&&(await th(r),tv(e.paths.infoPath)),function(e){let t=tw(e);if(!t.hasLock||t.hasInfo)return;let r=ty(e.lockPath);if(!r)return tv(e.lockPath);$(r.pid,r.processStartTime)||tv(e.lockPath)}(e.paths);let n=0;for(let t=1;t<=ta;t+=1){await tI(e);let r=await td(tr,e);if(r)return r;if(await tf(e.paths)){n+=1;continue}let a=tw(e.paths);if(!(t<ta))break;if(!a.hasInfo&&!a.hasLock){await tm(150);continue}}let i=tw(e.paths);throw new ef("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:e.paths.infoPath,lockPath:e.paths.lockPath,startupTimeoutMs:tr,startupAttempts:ta,lockRecoveryCount:n,metadataState:i,hint:function(e,t=ea(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 td(e,t){let r=Date.now();for(;Date.now()-r<e;){let e=tg(t.paths.infoPath);if(e&&await tk(e,t.transportPreference))return e;await new Promise(e=>setTimeout(e,100))}return null}async function tm(e){await new Promise(t=>setTimeout(t,e))}async function tf(e){let t=tw(e);if(!t.hasLock||t.hasInfo)return!1;let r=ty(e.lockPath);return r&&$(r.pid,r.processStartTime)&&await el(r.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:r.processStartTime}),tv(e.lockPath),!0}async function th(e){await el(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function tg(e){let t=tb(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,o=Number.isInteger(t.httpPort)&&Number(t.httpPort)>0;if(!a&&!o)return null;let s=t.transport,n="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,u=Number.isInteger(t.pid)&&Number(t.pid)>0;return{token:r,port:a?Number(t.port):void 0,httpPort:o?Number(t.httpPort):void 0,transport:"socket"===s||"http"===s||"dual"===s?s:void 0,pid:u?Number(t.pid):0,version:n,codeSignature:i,processStartTime:l}}function ty(e){let t=tb(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}ts.addSubnet("127.0.0.0",8,"ipv4"),ts.addAddress("::1","ipv6"),ts.addSubnet("::ffff:127.0.0.0",104,"ipv6");function tw(e){return{hasInfo:f.existsSync(e.infoPath),hasLock:f.existsSync(e.lockPath)}}function tb(e){if(!f.existsSync(e))return null;try{return JSON.parse(f.readFileSync(e,"utf8"))}catch{return null}}function tv(e){try{f.existsSync(e)&&f.unlinkSync(e)}catch{}}async function tk(e,t){var r;return"http"===tS(e,t)?await function(e){let t=e.baseUrl?t_(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:d,o=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:o},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=p.createConnection({host:"127.0.0.1",port:r},()=>{t.destroy(),e(!0)});t.on("error",()=>{e(!1)})}):Promise.resolve(!1))}async function tI(e){let t=tA(),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};ec(process.execPath,r,{env:a})}function tA(){let e=K(),t=i.join(e,"dist","src","daemon.js"),r=i.join(e,"src","daemon.ts"),a=f.existsSync(t),o=f.existsSync(r);if(!a&&!o)throw new ef("COMMAND_FAILED","Daemon entry not found",{distPath:t,srcPath:r});return{root:e,distPath:t,srcPath:r,useSrc:process.execArgv.includes("--experimental-strip-types")?o:!a&&o}}async function tD(e,t,r,a){return"http"===tS(e,r)?await tE(e,t,a):await tL(e,t,a)}function tS(e,t){if(e.baseUrl){if("socket"===t)throw new ef("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(t$(r,a))return a;throw new ef("COMMAND_FAILED","http"===a?"Daemon HTTP endpoint is unavailable":"Daemon socket endpoint is unavailable")}let o=("socket"===e.transport||"dual"===e.transport?["socket","http"]:["http","socket"]).find(t=>t$(e,t));if(o)return o;throw new ef("COMMAND_FAILED","Daemon metadata has no reachable transport")}function t$(e,t){return"http"===t?!!e.httpPort:!!e.port}function tN(e,t,r,a,o,s){let n=o?{terminated:0}:function(){let e=0;try{for(let t of to){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=o?{forcedKill:!1}:function(e,t){let r=!1;try{$(e.pid,e.processStartTime)&&(process.kill(e.pid,"SIGKILL"),r=!0)}catch{el(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}finally{tv(t.infoPath),tv(t.lockPath)}return{forcedKill:r}}(e,t);return Z({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:s,requestId:r,command:a,timedOutRunnerPidsTerminated:n.terminated,timedOutRunnerCleanupError:n.error,daemonPidReset:o?void 0:e.pid,daemonPidForceKilled:o?void 0:i.forcedKill,daemonBaseUrl:e.baseUrl}}),new ef("COMMAND_FAILED","Daemon request timed out",{timeoutMs:s,requestId:r,hint:o?"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 tx(e,t,r){return Z({level:"error",phase:"daemon_request_socket_error",data:{requestId:t,message:e instanceof Error?e.message:String(e)}}),new ef("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 tL(e,t,r){let a=e.port;if(!a)throw new ef("COMMAND_FAILED","Daemon socket endpoint is unavailable");return new Promise((o,s)=>{let n=p.createConnection({host:"127.0.0.1",port:a},()=>{n.write(`${JSON.stringify(t)}
25
- `)}),i=ea(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),l="number"==typeof r?setTimeout(()=>{n.destroy(),s(tN(e,i,t.meta?.requestId,t.command,!1,r))},r):void 0,u="";n.setEncoding("utf8"),n.on("data",e=>{let r=(u+=e).indexOf("\n");if(-1===r)return;let a=u.slice(0,r).trim();if(a)try{let e=JSON.parse(a);n.end(),l&&clearTimeout(l),o(e)}catch(e){l&&clearTimeout(l),s(new ef("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:a},e instanceof Error?e:void 0))}}),n.on("error",e=>{l&&clearTimeout(l),s(tx(e,t.meta?.requestId,!1))})})}async function tE(e,t,r){let a=e.baseUrl?new URL(t_(e.baseUrl,"rpc")):e.httpPort?new URL(`http://127.0.0.1:${e.httpPort}/rpc`):null;if(!a)throw new ef("COMMAND_FAILED","Daemon HTTP endpoint is unavailable");let o=JSON.stringify({jsonrpc:"2.0",id:t.meta?.requestId??B(),method:"agent_device.command",params:t}),s={"content-type":"application/json","content-length":Buffer.byteLength(o)};return e.baseUrl&&e.token&&(s.authorization=`Bearer ${e.token}`,s["x-agent-device-token"]=e.token),await new Promise((n,i)=>{let l=ea(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),u=("https:"===a.protocol?m:d).request({protocol:a.protocol,host:a.hostname,port:a.port,method:"POST",path:a.pathname+a.search,headers:s},r=>{let a="";r.setEncoding("utf8"),r.on("data",e=>{a+=e}),r.on("end",()=>{p&&clearTimeout(p);try{let r=JSON.parse(a);if(r.error){let e=r.error.data??{};i(new ef(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 i(new ef("COMMAND_FAILED","Invalid daemon RPC response",{requestId:t.meta?.requestId}));if(e.baseUrl&&r.result.ok)return void tM(e,t,r.result).then(n).catch(i);n(r.result)}catch(e){p&&clearTimeout(p),i(new ef("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:a},e instanceof Error?e:void 0))}})}),c=tP(e),p="number"==typeof r?setTimeout(()=>{u.destroy(),i(tN(e,l,t.meta?.requestId,t.command,c,r))},r):void 0;u.on("error",e=>{p&&clearTimeout(p),i(tx(e,t.meta?.requestId,c))}),u.write(o),u.end()})}function tP(e){return"string"==typeof e.baseUrl&&e.baseUrl.length>0}function t_(e,t){return new URL(t,e.endsWith("/")?e:`${e}/`).toString()}async function tM(e,t,r){let a=Array.isArray(r.data?.artifacts)?r.data.artifacts:[];if(0===a.length||!e.baseUrl)return r;let o=r.data?{...r.data}:{},s=[];for(let r of a){if(!r||"object"!=typeof r||"string"!=typeof r.artifactId){s.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 tT({baseUrl:e.baseUrl,token:e.token,artifactId:r.artifactId,destinationPath:a,requestId:t.meta?.requestId}),o[r.field]=a,s.push({...r,localPath:a})}return o.artifacts=s,{ok:!0,data:o}}async function tT(e){var t,r;let a,o=new URL((t=e.baseUrl,r=e.artifactId,a=t.endsWith("/")?t:`${t}/`,new URL(`upload/${encodeURIComponent(r)}`,a).toString())),s="https:"===o.protocol?m:d;await f.promises.mkdir(i.dirname(e.destinationPath),{recursive:!0}),await new Promise((t,r)=>{let a=!1,n=e.timeoutMs??tt,i=o=>{if(!a){if(a=!0,clearTimeout(u),o)return void f.promises.rm(e.destinationPath,{force:!0}).finally(()=>r(o));t()}},l=s.request({protocol:o.protocol,host:o.hostname,port:o.port,method:"GET",path:o.pathname+o.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 ef("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 ef("COMMAND_FAILED","Remote artifact download was interrupted",{artifactId:e.artifactId,requestId:e.requestId}))}),r.on("finish",()=>{r.close(()=>i())}),t.pipe(r)}),u=setTimeout(()=>{l.destroy(new ef("COMMAND_FAILED","Remote artifact download timed out",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:n}))},n);l.on("error",t=>{t instanceof ef?i(t):i(new ef("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:n},t instanceof Error?t:void 0))}),l.end()})}function tR(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 tO="metro-companion";function tC(e){return y("sha256").update(e).digest("hex")}function tU(e){return e?.trim()?e.trim():void 0}function tF(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=tC(t).slice(0,12),o=i.join(r,tO);return{statePath:i.join(o,`metro-companion-${a}.json`),logPath:i.join(o,`metro-companion-${a}.log`)}}function tj(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:tU("string"==typeof t.launchUrl?t.launchUrl:void 0),tokenHash:t.tokenHash,consumers:r}}catch{return null}}function tV(e,t){f.mkdirSync(i.dirname(e),{recursive:!0}),f.writeFileSync(e,`${JSON.stringify(t,null,2)}
26
- `,"utf8")}function tG(e){try{let t=f.readdirSync(e);0===t.length&&f.rmdirSync(e)}catch{}}function tB(e){let t=i.dirname(e.statePath),r=i.dirname(e.logPath);var a=e.statePath;try{f.unlinkSync(a)}catch{}var o=e.logPath;try{f.unlinkSync(o)}catch{}tG(t),r!==t&&tG(r),i.basename(t)===tO&&tG(i.dirname(t))}function tq(e){return e.includes(eh)}function tJ(e){return tU(e.consumerKey)??tU(e.profileKey)??null}function tH(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}async function tK(e){if(!ee(e.pid))return;let t=I(e.pid);if(t&&tq(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 tz(e){let t=tJ(e),r=tF(e.projectRoot,e.profileKey),a=tj(r.statePath);if(a&&function(e,t){if(!ee(e.pid))return!1;if(e.startTime){let t=et(e.pid);if(!t||t!==e.startTime)return!1}let r=I(e.pid);return!!r&&!!tq(r)&&e.serverBaseUrl===eg(t.serverBaseUrl)&&e.localBaseUrl===eg(t.localBaseUrl)&&e.launchUrl===tU(t.launchUrl)&&e.tokenHash===tC(t.bearerToken)}(a,e)){let e=tH(a,t);return e!==a&&tV(r.statePath,e),{pid:a.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}a&&(await tK(a),tB(r));let o=function(e,t){let r=function(){let e=u(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 o=f.openSync(t,"a"),s=0;try{let t;s=ec(process.execPath,[...a,r,eh],{env:(t={...e.env??process.env,[ew]:eg(e.serverBaseUrl),[eI]:e.bearerToken,[eb]:eg(e.localBaseUrl),[ev]:tF(e.projectRoot,e.profileKey).statePath},e.launchUrl?.trim()?t[ek]=e.launchUrl.trim():delete t[ek],t),stdio:["ignore",o,o]})}finally{f.closeSync(o)}if(!Number.isInteger(s)||s<=0)throw Error("Failed to start Metro companion process.");return{pid:s,startTime:et(s)??void 0,command:I(s)??void 0,serverBaseUrl:eg(e.serverBaseUrl),localBaseUrl:eg(e.localBaseUrl),launchUrl:tU(e.launchUrl),tokenHash:tC(e.bearerToken),consumers:[]}}(e,r.logPath);return tV(r.statePath,tH(o,t)),{pid:o.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function tW(e){let t=tJ(e),r=tF(e.projectRoot,e.profileKey),a=tj(r.statePath);if(!a)return tB(r),{stopped:!1,statePath:r.statePath};let o=t?{...a,consumers:a.consumers.filter(e=>e!==t)}:{...a,consumers:[]};return o.consumers.length>0?(tV(r.statePath,o),{stopped:!1,statePath:r.statePath}):(await tK(a),tB(r),{stopped:!0,statePath:r.statePath})}function tX(e){return"string"==typeof e&&e.trim()?eg(e.trim()):""}function tY(e){return"string"==typeof e&&e.trim()?e.trim():void 0}function tZ(e,t,r){return X(e,{env:t,cwd:r})}function tQ(e){try{return f.accessSync(e,f.constants.F_OK),!0}catch{return!1}}function t0(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 t1(e,t){return{platform:t,bundleUrl:ey(e,t)}}function t2(e,t){return{platform:t,metroHost:tY(e?.metro_host),metroPort:e?.metro_port,bundleUrl:tY(e?.metro_bundle_url),launchUrl:tY(e?.launch_url)}}async function t3(e){await new Promise(t=>setTimeout(t,e))}async function t5(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 t8(e,t){try{let r=await t5(e,t);return r.ok&&r.body.includes("packager-status:running")}catch{return!1}}async function t4(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 t6(e,t){let r=Error(e);return r.retryable=t,r}function t7(e,t){return!!(e>=500||408===e||425===e||429===e||JSON.stringify(t).includes("Metro companion is not connected"))}async function t9(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({ios_runtime:e.runtime,timeout_ms:e.timeoutMs}),signal:AbortSignal.timeout(e.timeoutMs)})}catch(t){if(t instanceof Error&&"TimeoutError"===t.name)throw t6(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0);throw t6(t instanceof Error?t.message:String(t),!0)}let o=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(s){let a=e.slice(0,200),o=s instanceof Error?s.message:String(s);throw t6(`/api/metro/bridge returned invalid JSON (${t}) from ${r}: ${o}. body=${JSON.stringify(a)}`,t7(t,e))}}(await t.text(),t.status,e.baseUrl);if(!t.ok)throw t6(`/api/metro/bridge failed (${t.status}): ${JSON.stringify(o)}`,t7(t.status,o));var s=o;let n=s.data??s;if(!n||"object"!=typeof n||Array.isArray(n))throw t6("/api/metro/bridge returned malformed descriptor: Expected a JSON object.",!1);try{return{enabled:n.enabled,baseUrl:n.base_url,statusUrl:n.status_url??"",bundleUrl:n.bundle_url??"",iosRuntime:t2(n.ios_runtime,"ios"),androidRuntime:t2(n.android_runtime,"android"),upstream:{bundleUrl:n.upstream.bundle_url??"",host:n.upstream.host??"",port:n.upstream.port??0,statusUrl:n.upstream.status_url??""},probe:{reachable:n.probe.reachable,statusCode:n.probe.status_code,latencyMs:n.probe.latency_ms,detail:n.probe.detail}}}catch(e){throw t6(`/api/metro/bridge returned malformed descriptor: ${e instanceof Error?e.message:String(e)}`,!1)}}function re(e,t,r,a,o){let s=[`Metro bridge is required for this run but could not be configured via ${e}/api/metro/bridge.`];return t&&s.push(`bridgeError=${t}`),r?.probe.reachable===!1&&s.push(`bridgeProbe=${r.probe.detail||`unreachable (status ${r.probe.statusCode||0})`}`),a&&a!==t&&s.push(`initialBridgeError=${a}`),o&&s.push(`metroCompanionLog=${o}`),s.join(" ")}async function rt(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 t8(e,t))return!0;let o=Math.min(500,Math.max(a-Date.now(),0));o>0&&await t3(o)}return!1}async function rr(e){let t=Date.now()+e.startupTimeoutMs,r=null,a=null;for(;Date.now()<t;){try{let t=await t9({baseUrl:e.baseUrl,bearerToken:e.bearerToken,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),!(e&&"object"==typeof e&&"retryable"in e&&!0===e.retryable))break}let o=Math.min(1e3,Math.max(t-Date.now(),0));o>0&&await t3(o)}throw Error(re(e.baseUrl,a,r,e.initialBridgeError,e.companionLogPath))}async function ra(e={}){let t=e.env??process.env,r=process.cwd(),a=tZ(e.projectRoot??r,t,r),o=function(e,t){if("auto"!==t)return t;let r=function(e){let t=i.join(e,"package.json");if(!tQ(t))throw new ef("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"),s=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 ef("INVALID_ARGS",`Invalid Metro port: ${String(e)}. Use 1-65535.`);return t}(e.metroPort??8081),n=tY(e.listenHost)??"0.0.0.0",l=tY(e.statusHost)??"127.0.0.1",u=tX(e.publicBaseUrl),c=t0(e.startupTimeoutMs,18e4,3e4),p=t0(e.probeTimeoutMs,1e4,1e3),d=e.reuseExisting??!0,m=e.installDependenciesIfNeeded??!0,h=e.runtimeFilePath?tZ(e.runtimeFilePath,t,r):null,g=tZ(e.logPath??i.join(a,".agent-device","metro.log"),t,r);if(!u)throw new ef("INVALID_ARGS","metro prepare requires --public-base-url <url>.");let{proxyEnabled:y,proxyBaseUrl:w,proxyBearerToken:b}=function(e,t){if(e&&!t)throw new ef("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 ef("INVALID_ARGS","metro prepare requires --proxy-base-url when proxy auth is provided.");return{proxyEnabled:!!(e&&t),proxyBaseUrl:e,proxyBearerToken:t}}(tX(e.proxyBaseUrl),tY(e.proxyBearerToken)??""),v=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=tQ(i.join(e,"pnpm-lock.yaml"))?{command:"pnpm",installArgs:["install"]}:tQ(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}:${s}/status`,I=!1,A=!1,D=0;if(d&&await t8(k,p))A=!0;else if(I=!0,D=function(e,t,r,a,o,s){let n="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(o),{recursive:!0});let l=f.openSync(o,"a"),u=0;try{u=ec(n.command,n.installArgs,{cwd:e,env:s,stdio:["ignore",l,l]})}finally{f.closeSync(l)}if(!Number.isInteger(u)||u<=0)throw Error("Failed to start Metro. Expected a detached child PID.");return{pid:u}}(a,o,s,n,g,t).pid,!await rt(k,c,p))throw await t4(D).catch(()=>{}),Error(`Metro did not become ready at ${k} within ${c}ms. Check ${g}.`);let S=t1(u,"ios"),$=t1(u,"android"),N=null,x=null;if(y)try{N=await t9({baseUrl:w,bearerToken:b,runtime:{metro_bundle_url:S.bundleUrl},timeoutMs:p})}catch(e){x=e instanceof Error?e.message:String(e)}if(y&&(!N||!1===N.probe.reachable)){let r;try{r=(await tz({projectRoot:a,serverBaseUrl:w,bearerToken:b,localBaseUrl:`http://${l}:${s}`,launchUrl:tY(e.launchUrl),profileKey:tY(e.companionProfileKey),consumerKey:tY(e.companionConsumerKey),env:t})).logPath}catch(e){throw Error(re(w,e instanceof Error?e.message:String(e),N,x))}try{N=await rr({baseUrl:w,bearerToken:b,runtime:{metro_bundle_url:S.bundleUrl},probeTimeoutMs:p,startupTimeoutMs:c,initialBridgeError:x,companionLogPath:r})}catch(e){throw e instanceof Error?e:Error(String(e))}}let L=N?.iosRuntime??S,E=N?.androidRuntime??$,P={projectRoot:a,kind:o,dependenciesInstalled:v.installed,packageManager:v.packageManager??null,started:I,reused:A,pid:D,logPath:g,statusUrl:k,runtimeFilePath:h,iosRuntime:L,androidRuntime:E,bridge:N};return h&&(f.mkdirSync(i.dirname(h),{recursive:!0}),f.writeFileSync(h,JSON.stringify(P,null,2))),P}let ro="alert",rs="appstate",rn="app-switcher",ri="apps",rl="back",ru="batch",rc="boot",rp="click",rd="clipboard",rm="devices",rf="diff",rh="fill",rg="find",ry="focus",rw="home",rb="keyboard",rv="logs",rk="longpress",rI="network",rA="perf",rD="pinch",rS="press",r$="push",rN="record",rx="replay",rL="rotate",rE="scroll",rP="screenshot",r_="settings",rM="snapshot",rT="swipe",rR="test",rO="trace",rC="trigger-app-event",rU="type",rF="wait",rj=[{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:"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"}],rV=new Map(rj.map(e=>[e.key,e]));function rG(e){let t=e.env??process.env;return X(e.configPath,{cwd:e.cwd,env:t})}function rB(e){let t=function(e){let t,r,a=e.env??process.env,o=rG(e);if(!f.existsSync(o))throw new ef("INVALID_ARGS",`Remote config file not found: ${o}`);try{t=f.readFileSync(o,"utf8")}catch(e){throw new ef("INVALID_ARGS",`Failed to read remote config file: ${o}`,{cause:e instanceof Error?e.message:String(e)})}try{r=JSON.parse(t)}catch(e){throw new ef("INVALID_ARGS",`Invalid JSON in remote config file: ${o}`,{cause:e instanceof Error?e.message:String(e)})}if(!r||"object"!=typeof r||Array.isArray(r))throw new ef("INVALID_ARGS",`Remote config file must contain a JSON object: ${o}`);let s={},n=r,l=i.dirname(o);for(let[e,t]of Object.entries(n)){let r=rV.get(e);if(!r)throw new ef("INVALID_ARGS",`Unsupported remote config key "${e}" in remote config file ${o}.`);let n=eB(r,t,`remote config file ${o}`,e);s[r.key]="string"==typeof n&&"path"in r&&r.path?X(n,{cwd:l,env:a}):n}return{resolvedPath:o,profile:s}}(e);return{resolvedPath:t.resolvedPath,profile:function(...e){let t={};for(let r of e)if(r)for(let e of rj){let a=r[e.key];void 0!==a&&(t[e.key]=a)}return t}(function(e=process.env){let t={};for(let r of rj){let a=(function(e){let t=rV.get(e);return[eG(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]=eB(r,a.value,`environment variable ${a.name}`,a.name))}return t}(e.env),t.profile)}}let rq=rj.map(e=>e.key),rJ=["remoteConfig","session","platform","daemonBaseUrl","daemonAuthToken","daemonTransport","metroProjectRoot","metroKind","metroPublicBaseUrl","metroProxyBaseUrl","metroBearerToken","metroPreparePort","metroListenHost","metroStatusHost","metroStartupTimeoutMs","metroProbeTimeoutMs","metroRuntimeFile","metroNoReuseExisting","metroNoInstallDeps"];function rH(e){return e.remoteConfig?{...function(e){let t={};for(let r of rq){let a=e[r];void 0!==a&&(t[r]=a)}return t}(rB({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}).profile),remoteConfig:e.remoteConfig}:{}}function rK(e,t,r,a){let o=r(e[t]);if(void 0===o)throw new ef("COMMAND_FAILED",a,{response:e});return o}function rz(e,t){return rK(e,t,r0,`Daemon response is missing "${t}".`)}function rW(e,t){return r0(e[t])}function rX(e,t){var r;let a;return r=r0,null===(a=e[t])?null:r(a)}function rY(e,t){return rK(e,t,r2,`Daemon response has invalid "${t}".`)}function rZ(e,t){return function(e){return"tv"===e||"mobile"===e||"desktop"===e?e:void 0}(e[t])??"mobile"}function rQ(e,t){let r=e[t];if(!r8(r))return;let a="number"==typeof r.x?r.x:void 0,o="number"==typeof r.y?r.y:void 0,s="number"==typeof r.width?r.width:void 0,n="number"==typeof r.height?r.height:void 0;if(void 0!==a&&void 0!==o&&void 0!==s&&void 0!==n)return{x:a,y:o,width:s,height:n}}function r0(e){return"string"==typeof e&&e.length>0?e:void 0}function r1(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function r2(e){return"ios"===e||"macos"===e||"android"===e?e:void 0}function r3(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}function r5(e){if(!r8(e))throw new ef("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:e});return e}function r8(e){return"object"==typeof e&&null!==e}function r4(e){let t={};for(let[r,a]of Object.entries(e))void 0!==a&&(t[r]=a);return t}function r6(e,t){let r=rW(e,"bundleId"),a=rW(e,"package");return{app:rz(e,"app"),appPath:rz(e,"appPath"),platform:rY(e,"platform"),appId:r??a,bundleId:r,package:a,identifiers:x({session:t,bundleId:r,packageName:a})}}function r7(e){let t=r5(e),r=rY(t,"platform"),a=rz(t,"id"),o=rz(t,"name");return{platform:r,target:rZ(t,"target"),kind:rK(t,"kind",r3,'Daemon response has invalid "kind".'),id:a,name:o,booted:"boolean"==typeof t.booted?t.booted:void 0,identifiers:N(r,a,o),ios:"ios"===r?{udid:a}:void 0,android:"android"===r?{serial:a}:void 0}}function r9(e){let t=r5(e),r=rY(t,"platform"),a=rz(t,"id"),o=rz(t,"name"),s=rZ(t,"target"),n=rz(t,"device"),i={session:o,...N(r,a,n)};return{name:o,createdAt:rK(t,"createdAt",r1,'Daemon response is missing numeric "createdAt".'),device:{platform:r,target:s,id:a,name:n,identifiers:i,ios:"ios"===r?{udid:a,simulatorSetPath:rX(t,"ios_simulator_device_set")}:void 0,android:"android"===r?{serial:a}:void 0},identifiers:i}}function ae(e){return e??"default"}function at(e){return void 0!==e.ref?[e.ref,...ar(e.label)]:void 0!==e.selector?[e.selector]:[String(e.x),String(e.y)]}function ar(e){return void 0===e?[]:[e]}function aa(e){return void 0===e?[]:[String(e)]}function ao(e,t,r){return r.remoteConfig&&r.remoteConfig!==e.remoteConfig?{...as({...e,...r}),...e,...r}:{...t,...e,...r}}function as(e){if(!e.remoteConfig)return{};let{runtime:t,...r}=rH({remoteConfig:e.remoteConfig,cwd:e.cwd??process.cwd(),env:process.env});return r}function an(e){return{platform:e.platform,target:e.target,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist}}function ai(e,t,r){var a;if(e.json)return void e1({success:!0,data:t});let o=r?.();o&&(a=o,process.stdout.write(a.endsWith("\n")?a:`${a}
27
- `))}function al(e,t){ai(e,t,()=>U(t))}let au=async({positionals:e,flags:t,client:r})=>{if("list"!==(e[0]??"list"))throw new ef("INVALID_ARGS","session only supports list");let a={sessions:(await r.sessions.list()).map(D)};return ai(t,a,()=>JSON.stringify(a,null,2)),!0},ac=async({flags:e,client:t})=>{let r=await t.devices.list(an(e));return ai(e,{devices:r.map(j)},()=>r.map(ap).join("\n")),!0};function ap(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 ad=async({flags:e,client:t})=>{if(!e.device)throw new ef("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 ai(e,F(r),()=>{let e=r.created?"Created":"Reused",t=r.booted?" (booted)":"";return r.runtime?`${e}: ${r.device} ${r.udid}${t}
28
- Runtime: ${r.runtime}`:`${e}: ${r.device} ${r.udid}${t}`}),!0},am=async({positionals:e,flags:t,client:r})=>{if("prepare"!==(e[0]??"").toLowerCase())throw new ef("INVALID_ARGS","metro only supports prepare");if(!t.metroPublicBaseUrl)throw new ef("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,startupTimeoutMs:t.metroStartupTimeoutMs,probeTimeoutMs:t.metroProbeTimeoutMs,reuseExisting:!t.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!t.metroNoInstallDeps&&void 0,runtimeFilePath:t.metroRuntimeFile});return ai(t,a,()=>JSON.stringify(a,null,2)),!0},af=async({flags:e,client:t})=>{let r=await t.apps.list({...an(e),appsFilter:e.appsFilter});return ai(e,{apps:r},()=>r.join("\n")),!0},ah=async({positionals:e,flags:t,client:r})=>{let a=C(await aw("install",e,t,r));return al(t,a),!0},ag=async({positionals:e,flags:t,client:r})=>{let a=C(await aw("reinstall",e,t,r));return al(t,a),!0},ay=async({positionals:e,flags:t,client:r})=>{let a=en(await ab(e,t,r));return al(t,a),!0};async function aw(e,t,r,a){let o=t[0],s=t[1];if(!o||!s)throw new ef("INVALID_ARGS",`${e} requires: ${e} <app> <path-to-app-binary>`);let n={app:o,appPath:s,...an(r)};return"install"===e?await a.apps.install(n):await a.apps.reinstall(n)}async function ab(e,t,r){let a=e[0]?.trim();if(!a)throw new ef("INVALID_ARGS","install-from-source requires: install-from-source <url>");if(e.length>1)throw new ef("INVALID_ARGS","install-from-source accepts exactly one positional argument: <url>");return await r.apps.installFromSource({...an(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 ef("INVALID_ARGS",`Invalid --header value "${r}". Expected "name:value".`);let a=r.slice(0,e).trim(),o=r.slice(e+1).trim();if(!a)throw new ef("INVALID_ARGS",`Invalid --header value "${r}". Header name cannot be empty.`);t[a]=o}return t}(t.header)}})}async function av(e){await tW(e)}async function ak(e,t){if(!e.remoteConfig)return;let r=e.platform;if("ios"!==r&&"android"!==r)throw new ef("INVALID_ARGS",'open --remote-config requires platform "ios" or "android" in the remote config file or CLI flags.');if(!e.metroPublicBaseUrl)throw new ef("INVALID_ARGS",'open --remote-config requires "metroPublicBaseUrl" in the remote config file.');let a=await t.metro.prepare({projectRoot:e.metroProjectRoot,kind:e.metroKind,publicBaseUrl:e.metroPublicBaseUrl,proxyBaseUrl:e.metroProxyBaseUrl,bearerToken:e.metroBearerToken,launchUrl:e.launchUrl,companionProfileKey:rG({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env}),companionConsumerKey:e.session,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"ios"===r?a.iosRuntime:a.androidRuntime}let aI=async({positionals:e,flags:t,client:r})=>{let a=await ak(t,r),o=T(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,runtime:a,...an(t)}));return al(t,o),!0},aA=async({positionals:e,flags:t,client:r})=>{let a=(()=>{let e;if(!t.remoteConfig)return null;try{e=rB({configPath:t.remoteConfig,cwd:process.cwd(),env:process.env})}catch{return null}return e.profile.metroProjectRoot&&e.profile.metroProxyBaseUrl?{projectRoot:e.profile.metroProjectRoot,profileKey:e.resolvedPath,consumerKey:t.session}:null})(),o=async e=>{try{return await e()}finally{try{a&&await av(a)}catch{}}},s=Y(await o(async()=>e[0]?await r.apps.close({app:e[0],shutdown:t.shutdown}):await r.sessions.close({shutdown:t.shutdown})));return al(t,s),!0},aD=async({flags:e,client:t})=>{let r=S(await t.capture.snapshot({...an(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}));return ai(e,r,()=>(function(e,t={}){var r,a,o;let s,n=e.nodes,i=Array.isArray(n)?n:[],l="string"==typeof e.backend?e.backend:void 0,u=t.raw||"macos-helper"===l?null:G(i),c=!!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=u?.nodes??i,h=t.raw||"macos-helper"===l?null:function(e,t,r,a){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 s=t?.hiddenCount??0,n=!!t&&t.nodes.some(e=>e.hiddenContentAbove||e.hiddenContentBelow);return s>0?{partial:!0,visibleNodeCount:r,totalNodeCount:a,reasons:["offscreen-nodes"]}:n?{partial:!0,visibleNodeCount:r,totalNodeCount:r,reasons:[]}:null}(e,u,f.length,i.length),g=h?.partial?h.totalNodeCount>h.visibleNodeCount?`Snapshot: ${h.visibleNodeCount} visible nodes (${h.totalNodeCount} total)${c?" (truncated)":""}`:`Snapshot: ${h.visibleNodeCount} visible nodes${c?" (truncated)":""}`:`Snapshot: ${i.length} nodes${c?" (truncated)":""}`,y=m.length>0?`${m.join("\n")}
29
- `:"",w=(r=e,a=i,o=t,s=e8(r),!o.raw&&function(e){if(e.length<20)return!1;let t=new Map;for(let r of e){let e=(r.type??"").toLowerCase(),a=H(r).trim().toLowerCase();if(!a)continue;let o=`${e}|${a}`;t.set(o,(t.get(o)??0)+1)}let r=0;for(let e of t.values())e>1&&(r+=e);return r>=8}(a)&&s.push("Warning: possible repeated nav subtree detected."),s),b=w.length>0?`${w.join("\n")}
30
- `:"";if(0===i.length)return`${y}${g}
31
- ${b}`;if(t.raw){let e=i.map(e=>JSON.stringify(e));return`${y}${g}
24
+ `)}function e4(e){let t=tn(),r=!0===e.match,n=tr(e.differentPixels),a=tr(e.totalPixels),i=tr(e.mismatchPercentage),o=e.diffPath,s=e.dimensionMismatch,c=[];if(r){let e=t?l("green","✓"):"✓";c.push(`${e} Screenshots match.`)}else if(s){let e=t?l("red","✗"):"✗",r=s.expected,n=s.actual;c.push(`${e} Screenshots have different dimensions: expected ${r?.width}x${r?.height}, got ${n?.width}x${n?.height}`)}else{let e=t?l("red","✗"):"✗",r=0===i&&n>0?"<0.01":String(i),a=`${r}% pixels differ`;c.push(`${e} ${t?l("red",a):a}`)}if(o&&!r){let e=tt(o),r=t?l("dim","Diff image:"):"Diff image:",n=t?l("green",e):e;c.push(` ${r} ${n}`)}if(e.currentOverlayPath&&!r){let r=tt(e.currentOverlayPath),n=t?l("dim","Current overlay:"):"Current overlay:",a=t?l("green",r):r,i=tr(e.currentOverlayRefCount),o=i>0?` (${i} refs)`:"";c.push(` ${n} ${a}${o}`)}if(!r&&!s){let e=t?l("red",String(n)):String(n);c.push(` ${e} different / ${a} total pixels`)}let u=r||s?[]: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=${te(r.xRange)}px dy=${te(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(e9).join("; ")}`);let n=(e.nonTextDeltas??[]).filter(e=>"separator"===e.likelyKind).slice(0,2);return n.length>0&&t.push(`non-text boundaries: ${n.map(e9).join("; ")}`),t.slice(0,6)}(e);if(u.length>0)for(let e of(c.push(` ${ta("Hints:",t)}`),u))c.push(` - ${e}`);let d=Array.isArray(e.regions)?e.regions:[];if(!r&&!s&&d.length>0)for(let e of(c.push(` ${ta("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 n=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);n&&c.push(` ${n}`);let a=e.currentOverlayMatches?.[0];if(a){let e=a.label?` "${a.label}"`:"";c.push(` overlaps @${a.ref}${e}, ${a.regionCoveragePercentage}% of region`)}}let p=e.ocr?.matches??[];if(!r&&!s&&p.length>0){let r=p.slice(0,8);for(let[n,a]of(c.push(` ${ta(`OCR text deltas (${e.ocr?.provider}; baselineBlocks=${e.ocr?.baselineBlocks} currentBlocks=${e.ocr?.currentBlocks}; showing ${r.length}/${p.length}; px):`,t)}`),c.push(` ${ta("item | text | movePx | sizeDeltaPx | bboxBaseline | bboxCurrent | confidence | issueHint",t)}`),r.entries())){let e=a.delta;c.push(` ${n+1} | ${JSON.stringify(a.text)} | ${e7(e.x)},${e7(e.y)} | ${e7(e.width)},${e7(e.height)} | ${e6(a.baselineRect)} | ${e6(a.currentRect)} | ${a.confidence} | ${a.possibleTextMetricMismatch?"ocr-bbox-size-change":"-"}`)}}let m=e.nonTextDeltas??[];if(!r&&!s&&m.length>0){let e=m.slice(0,8);for(let r of(c.push(` ${ta(`Non-text visual deltas (showing ${e.length}/${m.length}; px):`,t)}`),c.push(` ${ta("item | region | slot | kind | bboxCurrent | nearestText",t)}`),e))c.push(` ${r.index} | ${r.regionIndex?`r${r.regionIndex}`:"-"} | ${r.slot} | ${r.likelyKind} | ${e6(r.rect)} | ${r.nearestText?JSON.stringify(r.nearestText):"-"}`)}return`${c.join("\n")}
25
+ `}function e6(e){return`x=${e.x},y=${e.y},w=${e.width},h=${e.height}`}function e7(e){return e>0?`+${e}`:String(e)}function e9(e){let t=e.nearestText?` near ${JSON.stringify(e.nearestText)}`:"",r=e.regionIndex?` r${e.regionIndex}`:"";return`${e.likelyKind}${t}${r}`}function te(e){return e.min===e.max?e7(e.min):`${e7(e.min)}..${e7(e.max)}`}function tt(e){let t=process.cwd(),r=s.relative(t,e);return""!==r&&(r.startsWith("..")||s.isAbsolute(r))?e:""===r?".":`.${s.sep}${r}`}function tr(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 ta(e,t){return t?l("dim",e):e}function ti(e){let t=e.warnings;return Array.isArray(t)?t.filter(e=>"string"==typeof e&&e.length>0):[]}function to(e){var t;let r="scroll-area"===(t=e.type)||"list"===t||"collection"===t||"table"===t?t:null;if(!r)return[];let n=[];if(e.node.hiddenContentAbove&&n.push(`[content above ${r} hidden]`),e.node.hiddenContentBelow&&n.push(`[content below ${r} hidden]`),0===n.length)return[];let a=" ".repeat(e.depth+1);return n.map(e=>`${a}${e}`)}let ts="sha256";async function tl(e){let{localPath:t,baseUrl:r,token:n}=e,a=f.statSync(t),i=a.isDirectory(),o=s.basename(t),l=i?"app-bundle":"file",c=r.endsWith("/")?r:`${r}/`,u=i?void 0:await tu(t);if(u){let e=await tc({normalizedBase:c,token:n,hash:u,filename:o,sizeBytes:a.size,artifactType:l});if(e)return e}let d=new URL("upload",c),h="https:"===d.protocol?m:p,y={"x-artifact-type":l,"x-artifact-filename":o,"transfer-encoding":"chunked"};return u&&(y["x-artifact-hash"]=u,y["x-artifact-hash-algorithm"]=ts),n&&(y.authorization=`Bearer ${n}`,y["x-agent-device-token"]=n),new Promise((e,r)=>{let n=h.request({protocol:d.protocol,host:d.hostname,port:d.port,method:"POST",path:d.pathname+d.search,headers:y},t=>{let n="";t.setEncoding("utf8"),t.on("data",e=>{n+=e}),t.on("end",()=>{clearTimeout(a);try{let t=JSON.parse(n);if(!t.ok||!t.uploadId)return void r(new ey("COMMAND_FAILED",`Upload failed: ${n}`));e(t.uploadId)}catch{r(new ey("COMMAND_FAILED",`Invalid upload response: ${n}`))}})}),a=setTimeout(()=>{n.destroy(),r(new ey("COMMAND_FAILED","Artifact upload timed out",{timeoutMs:3e5,hint:"The upload to the remote daemon exceeded the 5-minute timeout."}))},3e5);if(n.on("error",e=>{clearTimeout(a),r(new ey("COMMAND_FAILED","Failed to upload artifact to remote daemon",{hint:"Verify the remote daemon is reachable and supports artifact uploads."},e))}),i){let e=g("tar",["cf","-","-C",s.dirname(t),s.basename(t)],{stdio:["ignore","pipe","pipe"]});e.stdout.pipe(n),e.on("error",e=>{n.destroy(),r(new ey("COMMAND_FAILED","Failed to create tar archive for app bundle",{},e))}),e.on("close",e=>{0!==e&&(n.destroy(),r(new ey("COMMAND_FAILED",`tar failed with exit code ${e}`)))})}else{let e=f.createReadStream(t);e.pipe(n),e.on("error",e=>{n.destroy(),r(new ey("COMMAND_FAILED","Failed to read local artifact",{},e))})}})}async function tc(e){var t;let r=new URL("upload/preflight",e.normalizedBase),n={"content-type":"application/json"};e.token&&(n.authorization=`Bearer ${e.token}`,n["x-agent-device-token"]=e.token);let a=await fetch(r,{method:"POST",headers:n,signal:AbortSignal.timeout(3e4),body:JSON.stringify({hash:e.hash,hashAlgorithm:ts,fileName:e.filename,sizeBytes:e.sizeBytes,artifactType:e.artifactType})}).catch(()=>void 0);if(!a?.ok)return;let i=await a.json().catch(()=>void 0);return(t=i)&&"object"==typeof t&&!0===t.ok&&!0===t.cacheHit&&"string"==typeof t.uploadId?i.uploadId:void 0}async function tu(e){let t=w(ts);return await new Promise((r,n)=>{f.createReadStream(e).on("data",e=>t.update(e)).on("error",e=>{n(new ey("COMMAND_FAILED","Failed to read local artifact",{},e))}).on("end",r)}),t.digest("hex")}let td=tH(),tp=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}(),tm=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}(),tf=["xcodebuild .*AgentDeviceRunnerUITests/RunnerTests/testCommand","xcodebuild .*AgentDeviceRunner\\.env\\.session-","xcodebuild build-for-testing .*ios-runner/AgentDeviceRunner/AgentDeviceRunner\\.xcodeproj"],th=new d.BlockList;async function tg(e){let t=e.meta?.requestId??q(),r=!!(e.meta?.debug||e.flags?.verbose),n=function(e){let t,r=e.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR,n=function(e){let t;if(e){try{t=new URL(e)}catch(t){throw new ey("INVALID_ARGS","Invalid daemon base URL",{daemonBaseUrl:e},t instanceof Error?t:void 0)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new ey("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),a=e.flags?.daemonAuthToken??process.env.AGENT_DEVICE_DAEMON_AUTH_TOKEN;var i=n,o=a;if(!(!i||"localhost"===(t=new URL(i).hostname.trim().toLowerCase().replace(/^\[(.*)\]$/,"$1"))||(d.isIPv4(t)?th.check(t,"ipv4"):!!d.isIPv6(t)&&th.check(t,"ipv6")))&&("string"!=typeof o||!(o.trim().length>0)))throw new ey("INVALID_ARGS","Remote daemon base URL for non-loopback hosts requires daemon authentication",{daemonBaseUrl:i,hint:"Provide --daemon-auth-token or AGENT_DEVICE_DAEMON_AUTH_TOKEN when using a non-loopback remote daemon URL."});let s=e.flags?.daemonTransport??process.env.AGENT_DEVICE_DAEMON_TRANSPORT,l=_(s);if(n&&"socket"===l)throw new ey("INVALID_ARGS","Remote daemon base URL only supports HTTP transport. Remove --daemon-transport socket.",{daemonBaseUrl:n});let c=eo(e.flags?.daemonServerMode??process.env.AGENT_DEVICE_DAEMON_SERVER_MODE??("dual"===s?"dual":void 0));return{paths:ea(r),transportPreference:l,serverMode:c,remoteBaseUrl:n,remoteAuthToken:a}}(e),a=function(e,t=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS){if("test"!==e)return tH(t)}(e.command),i=await z("daemon_startup",async()=>await tk(n),{requestId:t,session:e.session}),o=await ty(e,i),s={...e,positionals:o.positionals,flags:o.flags,token:i.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,...o.uploadedArtifactId?{uploadedArtifactId:o.uploadedArtifactId}:{},...o.clientArtifactPaths?{clientArtifactPaths:o.clientArtifactPaths}:{},...o.installSource?{installSource:o.installSource}:{}}};return Q({level:"info",phase:"daemon_request_prepare",data:{requestId:t,command:e.command,session:e.session}}),await z("daemon_request",async()=>await tE(i,s,n.transportPreference,a),{requestId:t,command:e.command})}async function ty(e,t){let r,n=[...e.positionals??[]],a=e.flags?{...e.flags}:void 0,i=e.meta?.installSource,o={};if(tB(t)){let l=function(e,t){if("screenshot"===e.command){let r=tb(e,"path",".png");return t[0]?{field:"path",localPath:r,positionalIndex:0,positionalPath:tv("screenshot",".png")}:{field:"path",localPath:r,positionalIndex:0,flagPath:tv("screenshot",".png")}}if("record"===e.command&&"start"===(t[0]??"").toLowerCase()){let t=tb(e,"outPath",".mp4",1);return{field:"outPath",localPath:t,positionalIndex:1,positionalPath:tv("recording",s.extname(t)||".mp4")}}return null}(e,n);l&&(void 0!==l.positionalPath&&(n[l.positionalIndex]=l.positionalPath),void 0!==l.flagPath&&((a??={}).out=l.flagPath),o[l.field]=l.localPath);let c=await tw(e,t);c&&(i=c.installSource,r=c.uploadedArtifactId??r)}if(!tB(t)||"install"!==e.command&&"reinstall"!==e.command||n.length<2)return{positionals:n,flags:a,installSource:i,uploadedArtifactId:r,...Object.keys(o).length>0?{clientArtifactPaths:o}:{}};let l=n[1];if(l.startsWith("remote:"))return n[1]=l.slice(7),{positionals:n,flags:a,...Object.keys(o).length>0?{clientArtifactPaths:o}:{}};let c=s.isAbsolute(l)?l:s.resolve(e.meta?.cwd??process.cwd(),l);return f.existsSync(c)?{positionals:n,flags:a,installSource:i,uploadedArtifactId:r=await tl({localPath:c,baseUrl:t.baseUrl,token:t.token}),...Object.keys(o).length>0?{clientArtifactPaths:o}:{}}:{positionals:n,flags:a,...Object.keys(o).length>0?{clientArtifactPaths:o}:{}}}async function tw(e,t){let r=e.meta?.installSource;if("install_source"!==e.command||!r||"path"!==r.kind)return null;let n=r.path.trim();if(!n)return{installSource:r};if(n.startsWith("remote:"))return{installSource:{...r,path:n.slice(7)}};let a=s.isAbsolute(n)?n:s.resolve(e.meta?.cwd??process.cwd(),n);if(!f.existsSync(a))return{installSource:{...r,path:a}};let i=await tl({localPath:a,baseUrl:t.baseUrl,token:t.token});return{installSource:{...r,path:a},uploadedArtifactId:i}}function tb(e,t,r,n=0){let a=e.positionals?.[n]??e.flags?.out,i=`${"path"===t?"screenshot":"recording"}-${Date.now()}${r}`,o=a&&a.trim().length>0?a:i;return s.isAbsolute(o)?o:s.resolve(e.meta?.cwd??process.cwd(),o)}function tv(e,t){let r=t.startsWith(".")?t:`.${t}`;return s.posix.join("/tmp",`agent-device-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}${r}`)}async function tk(e){let t;if(e.remoteBaseUrl){let t={transport:"http",token:e.remoteAuthToken??"",pid:0,baseUrl:e.remoteBaseUrl};if(await tL(t,"http"))return t;throw new ey("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=tS(e.paths.infoPath),n=K(),a=R((t=t_()).useSrc?t.srcPath:t.distPath,t.root),i=!!r&&await tL(r,e.transportPreference);if(r&&r.version===n&&r.codeSignature===a&&i)return r;r&&(r.version!==n||r.codeSignature!==a||!i)&&(await tD(r),tN(e.paths.infoPath)),function(e){let t=tM(e);if(!t.hasLock||t.hasInfo)return;let r=t$(e.lockPath);if(!r)return tN(e.lockPath);$(r.pid,r.processStartTime)||tN(e.lockPath)}(e.paths);let o=0;for(let t=1;t<=tm;t+=1){await tR(e);let r=await tx(tp,e);if(r)return r;if(await tA(e.paths)){o+=1;continue}let n=tM(e.paths);if(!(t<tm))break;if(!n.hasInfo&&!n.hasLock){await tI(150);continue}}let s=tM(e.paths);throw new ey("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:e.paths.infoPath,lockPath:e.paths.lockPath,startupTimeoutMs:tp,startupAttempts:tm,lockRecoveryCount:o,metadataState:s,hint:function(e,t=ea(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.`}(s,e.paths)})}async function tx(e,t){let r=Date.now();for(;Date.now()-r<e;){let e=tS(t.paths.infoPath);if(e&&await tL(e,t.transportPreference))return e;await new Promise(e=>setTimeout(e,100))}return null}async function tI(e){await new Promise(t=>setTimeout(t,e))}async function tA(e){let t=tM(e);if(!t.hasLock||t.hasInfo)return!1;let r=t$(e.lockPath);return r&&$(r.pid,r.processStartTime)&&await ec(r.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:r.processStartTime}),tN(e.lockPath),!0}async function tD(e){await ec(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function tS(e){let t=tP(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 n=Number.isInteger(t.port)&&Number(t.port)>0,a=Number.isInteger(t.httpPort)&&Number(t.httpPort)>0;if(!n&&!a)return null;let i=t.transport,o="string"==typeof t.version?t.version:void 0,s="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:n?Number(t.port):void 0,httpPort:a?Number(t.httpPort):void 0,transport:"socket"===i||"http"===i||"dual"===i?i:void 0,pid:c?Number(t.pid):0,version:o,codeSignature:s,processStartTime:l}}function t$(e){let t=tP(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}th.addSubnet("127.0.0.0",8,"ipv4"),th.addAddress("::1","ipv6"),th.addSubnet("::ffff:127.0.0.0",104,"ipv6");function tM(e){return{hasInfo:f.existsSync(e.infoPath),hasLock:f.existsSync(e.lockPath)}}function tP(e){if(!f.existsSync(e))return null;try{return JSON.parse(f.readFileSync(e,"utf8"))}catch{return null}}function tN(e){try{f.existsSync(e)&&f.unlinkSync(e)}catch{}}async function tL(e,t){var r;return"http"===tT(e,t)?await function(e){let t=e.baseUrl?tV(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),n="https:"===r.protocol?m:p,a=e.baseUrl?3e3:500;return new Promise(e=>{let t=n.request({protocol:r.protocol,host:r.hostname,port:r.port,path:r.pathname+r.search,method:"GET",timeout:a},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 tR(e){let t=t_(),r=t.useSrc?["--experimental-strip-types",t.srcPath]:[t.distPath],n={...process.env,AGENT_DEVICE_STATE_DIR:e.paths.baseDir,AGENT_DEVICE_DAEMON_SERVER_MODE:e.serverMode};ep(process.execPath,r,{env:n})}function t_(){let e=Y(),t=s.join(e,"dist","src","daemon.js"),r=s.join(e,"src","daemon.ts"),n=f.existsSync(t),a=f.existsSync(r);if(!n&&!a)throw new ey("COMMAND_FAILED","Daemon entry not found",{distPath:t,srcPath:r});return{root:e,distPath:t,srcPath:r,useSrc:process.execArgv.includes("--experimental-strip-types")?a:!n&&a}}async function tE(e,t,r,n){return"http"===tT(e,r)?await tj(e,t,n):await tF(e,t,n)}function tT(e,t){if(e.baseUrl){if("socket"===t)throw new ey("COMMAND_FAILED","Remote daemon endpoint only supports HTTP transport",{daemonBaseUrl:e.baseUrl});return"http"}if("http"===t||"socket"===t){var r=e,n=t;if(tC(r,n))return n;throw new ey("COMMAND_FAILED","http"===n?"Daemon HTTP endpoint is unavailable":"Daemon socket endpoint is unavailable")}let a=("socket"===e.transport||"dual"===e.transport?["socket","http"]:["http","socket"]).find(t=>tC(e,t));if(a)return a;throw new ey("COMMAND_FAILED","Daemon metadata has no reachable transport")}function tC(e,t){return"http"===t?!!e.httpPort:!!e.port}function tO(e,t,r,n,a,i){let o=a?{terminated:0}:function(){let e=0;try{for(let t of tf){let r=em("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)}}}(),s=a?{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{tN(t.infoPath),tN(t.lockPath)}return{forcedKill:r}}(e,t);return Q({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:i,requestId:r,command:n,timedOutRunnerPidsTerminated:o.terminated,timedOutRunnerCleanupError:o.error,daemonPidReset:a?void 0:e.pid,daemonPidForceKilled:a?void 0:s.forcedKill,daemonBaseUrl:e.baseUrl}}),new ey("COMMAND_FAILED","Daemon request timed out",{timeoutMs:i,requestId:r,hint:a?"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 tU(e,t,r){return Q({level:"error",phase:"daemon_request_socket_error",data:{requestId:t,message:e instanceof Error?e.message:String(e)}}),new ey("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 tF(e,t,r){let n=e.port;if(!n)throw new ey("COMMAND_FAILED","Daemon socket endpoint is unavailable");return new Promise((a,i)=>{let o=d.createConnection({host:"127.0.0.1",port:n},()=>{o.write(`${JSON.stringify(t)}
26
+ `)}),s=ea(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),l="number"==typeof r?setTimeout(()=>{o.destroy(),i(tO(e,s,t.meta?.requestId,t.command,!1,r))},r):void 0,c="";o.setEncoding("utf8"),o.on("data",e=>{let r=(c+=e).indexOf("\n");if(-1===r)return;let n=c.slice(0,r).trim();if(n)try{let e=JSON.parse(n);o.end(),l&&clearTimeout(l),a(e)}catch(e){l&&clearTimeout(l),i(new ey("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:n},e instanceof Error?e:void 0))}}),o.on("error",e=>{l&&clearTimeout(l),i(tU(e,t.meta?.requestId,!1))})})}async function tj(e,t,r){var n,a,i;let o,s=e.baseUrl?new URL(tV(e.baseUrl,"rpc")):e.httpPort?new URL(`http://127.0.0.1:${e.httpPort}/rpc`):null;if(!s)throw new ey("COMMAND_FAILED","Daemon HTTP endpoint is unavailable");let l=JSON.stringify((n=t,a={includeTokenParam:!e.baseUrl},o=n.meta?.requestId??q(),"lease_allocate"!==(i=n.command)&&"lease_heartbeat"!==i&&"lease_release"!==i?{jsonrpc:"2.0",id:o,method:"agent_device.command",params:n}:{jsonrpc:"2.0",id:o,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"}}(n.command),params:function(e,t,r){let n={...r.includeTokenParam?{token:e.token}:{},session:e.session,tenantId:e.meta?.tenantId,runId:e.meta?.runId};switch(t){case"lease_allocate":return{...n,ttlMs:e.meta?.leaseTtlMs,backend:e.meta?.leaseBackend};case"lease_heartbeat":return{...n,leaseId:e.meta?.leaseId,ttlMs:e.meta?.leaseTtlMs};case"lease_release":return{...n,leaseId:e.meta?.leaseId}}}(n,n.command,a)})),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((n,a)=>{let i=ea(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),o=("https:"===s.protocol?m:p).request({protocol:s.protocol,host:s.hostname,port:s.port,method:"POST",path:s.pathname+s.search,headers:c},r=>{let i="";r.setEncoding("utf8"),r.on("data",e=>{i+=e}),r.on("end",()=>{d&&clearTimeout(d);try{let r=JSON.parse(i);if(r.error){let e=r.error.data??{};a(new ey(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 a(new ey("COMMAND_FAILED","Invalid daemon RPC response",{requestId:t.meta?.requestId}));if(e.baseUrl&&r.result.ok)return void tG(e,t,r.result).then(n).catch(a);n(r.result)}catch(e){d&&clearTimeout(d),a(new ey("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:i},e instanceof Error?e:void 0))}})}),u=tB(e),d="number"==typeof r?setTimeout(()=>{o.destroy(),a(tO(e,i,t.meta?.requestId,t.command,u,r))},r):void 0;o.on("error",e=>{d&&clearTimeout(d),a(tU(e,t.meta?.requestId,u))}),o.write(l),o.end()})}function tB(e){return"string"==typeof e.baseUrl&&e.baseUrl.length>0}function tV(e,t){return new URL(t,e.endsWith("/")?e:`${e}/`).toString()}async function tG(e,t,r){let n=Array.isArray(r.data?.artifacts)?r.data.artifacts:[];if(0===n.length||!e.baseUrl)return r;let a=r.data?{...r.data}:{},i=[];for(let r of n){if(!r||"object"!=typeof r||"string"!=typeof r.artifactId){i.push(r);continue}let n=function(e,t){if(e.localPath&&e.localPath.trim().length>0)return e.localPath;let r=e.fileName?.trim()||`${e.field}-${Date.now()}`;return s.resolve(t.meta?.cwd??process.cwd(),r)}(r,t);await tq({baseUrl:e.baseUrl,token:e.token,artifactId:r.artifactId,destinationPath:n,requestId:t.meta?.requestId}),a[r.field]=n,i.push({...r,localPath:n})}return a.artifacts=i,{ok:!0,data:a}}async function tq(e){var t,r;let n,a=new URL((t=e.baseUrl,r=e.artifactId,n=t.endsWith("/")?t:`${t}/`,new URL(`upload/${encodeURIComponent(r)}`,n).toString())),i="https:"===a.protocol?m:p;await f.promises.mkdir(s.dirname(e.destinationPath),{recursive:!0}),await new Promise((t,r)=>{let n=!1,o=e.timeoutMs??td,s=a=>{if(!n){if(n=!0,clearTimeout(c),a)return void f.promises.rm(e.destinationPath,{force:!0}).finally(()=>r(a));t()}},l=i.request({protocol:a.protocol,host:a.hostname,port:a.port,method:"GET",path:a.pathname+a.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",()=>{s(new ey("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=>{s(e instanceof Error?e:Error(String(e)))}),t.on("error",e=>{s(e instanceof Error?e:Error(String(e)))}),t.on("aborted",()=>{s(new ey("COMMAND_FAILED","Remote artifact download was interrupted",{artifactId:e.artifactId,requestId:e.requestId}))}),r.on("finish",()=>{r.close(()=>s())}),t.pipe(r)}),c=setTimeout(()=>{l.destroy(new ey("COMMAND_FAILED","Remote artifact download timed out",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:o}))},o);l.on("error",t=>{t instanceof ey?s(t):s(new ey("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:o},t instanceof Error?t:void 0))}),l.end()})}function tH(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 tK="metro-companion";function tX(e){return w("sha256").update(e).digest("hex")}function tY(e){return e?.trim()?e.trim():void 0}function tJ(e,t){let r=s.join(e,".agent-device");if(!t)return{statePath:s.join(r,"metro-companion.json"),logPath:s.join(r,"metro-companion.log")};let n=tX(t).slice(0,12),a=s.join(r,tK);return{statePath:s.join(a,`metro-companion-${n}.json`),logPath:s.join(a,`metro-companion-${n}.log`)}}function tz(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:tY("string"==typeof t.launchUrl?t.launchUrl:void 0),tokenHash:t.tokenHash,consumers:r}}catch{return null}}function tW(e,t){f.mkdirSync(s.dirname(e),{recursive:!0}),f.writeFileSync(e,`${JSON.stringify(t,null,2)}
27
+ `,"utf8")}function tZ(e){try{let t=f.readdirSync(e);0===t.length&&f.rmdirSync(e)}catch{}}function tQ(e){let t=s.dirname(e.statePath),r=s.dirname(e.logPath);var n=e.statePath;try{f.unlinkSync(n)}catch{}var a=e.logPath;try{f.unlinkSync(a)}catch{}tZ(t),r!==t&&tZ(r),s.basename(t)===tK&&tZ(s.dirname(t))}function t0(e){return e.includes(ew)}function t1(e){return tY(e.consumerKey)??tY(e.profileKey)??null}function t2(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}async function t3(e){if(!et(e.pid))return;let t=I(e.pid);if(t&&t0(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 t5(e){let t=t1(e),r=tJ(e.projectRoot,e.profileKey),n=tz(r.statePath);if(n&&function(e,t){if(!et(e.pid))return!1;if(e.startTime){let t=er(e.pid);if(!t||t!==e.startTime)return!1}let r=I(e.pid);return!!r&&!!t0(r)&&e.serverBaseUrl===eb(t.serverBaseUrl)&&e.localBaseUrl===eb(t.localBaseUrl)&&e.launchUrl===tY(t.launchUrl)&&e.tokenHash===tX(t.bearerToken)}(n,e)){let e=t2(n,t);return e!==n&&tW(r.statePath,e),{pid:n.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}n&&(await t3(n),tQ(r));let a=function(e,t){let r=function(){let e=c(import.meta.url),t=s.extname(e)||".js",r=s.join(s.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}(),n=r.endsWith(".ts")?["--experimental-strip-types"]:[];f.mkdirSync(s.dirname(t),{recursive:!0});let a=f.openSync(t,"a"),i=0;try{let t;i=ep(process.execPath,[...n,r,ew],{env:(t={...e.env??process.env,[ek]:eb(e.serverBaseUrl),[eD]:e.bearerToken,[ex]:eb(e.localBaseUrl),[eI]:tJ(e.projectRoot,e.profileKey).statePath},e.launchUrl?.trim()?t[eA]=e.launchUrl.trim():delete t[eA],t),stdio:["ignore",a,a]})}finally{f.closeSync(a)}if(!Number.isInteger(i)||i<=0)throw Error("Failed to start Metro companion process.");return{pid:i,startTime:er(i)??void 0,command:I(i)??void 0,serverBaseUrl:eb(e.serverBaseUrl),localBaseUrl:eb(e.localBaseUrl),launchUrl:tY(e.launchUrl),tokenHash:tX(e.bearerToken),consumers:[]}}(e,r.logPath);return tW(r.statePath,t2(a,t)),{pid:a.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function t8(e){let t=t1(e),r=tJ(e.projectRoot,e.profileKey),n=tz(r.statePath);if(!n)return tQ(r),{stopped:!1,statePath:r.statePath};let a=t?{...n,consumers:n.consumers.filter(e=>e!==t)}:{...n,consumers:[]};return a.consumers.length>0?(tW(r.statePath,a),{stopped:!1,statePath:r.statePath}):(await t3(n),tQ(r),{stopped:!0,statePath:r.statePath})}function t4(e){return"string"==typeof e&&e.trim()?eb(e.trim()):""}function t6(e){return"string"==typeof e&&e.trim()?e.trim():void 0}function t7(e,t,r){return W(e,{env:t,cwd:r})}function t9(e){try{return f.accessSync(e,f.constants.F_OK),!0}catch{return!1}}function re(e,t,r){if(null==e||""===e)return t;let n=Number.parseInt(String(e),10);return Number.isInteger(n)?Math.max(n,r):t}function rt(e,t){return{platform:t,bundleUrl:ev(e,t)}}function rr(e,t){return{platform:t,metroHost:t6(e?.metro_host),metroPort:e?.metro_port,bundleUrl:t6(e?.metro_bundle_url),launchUrl:t6(e?.launch_url)}}async function rn(e){await new Promise(t=>setTimeout(t,e))}async function ra(e,t,r={}){try{let n=await fetch(e,{headers:r,signal:AbortSignal.timeout(t)});return{ok:n.ok,status:n.status,body:await n.text()}}catch(r){if(r instanceof Error&&"TimeoutError"===r.name)throw Error(`Timed out fetching ${e} after ${t}ms`);throw r}}async function ri(e,t){try{let r=await ra(e,t);return r.ok&&r.body.includes("packager-status:running")}catch{return!1}}async function ro(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 rs(e,t){let r=Error(e);return r.retryable=t,r}function rl(e,t){return!!(e>=500||408===e||425===e||429===e||JSON.stringify(t).includes("Metro companion is not connected"))}async function rc(e){let t;try{var r,n;t=await fetch(`${e.baseUrl}/api/metro/bridge`,{method:"POST",headers:(r=e.baseUrl,n=e.bearerToken,{Authorization:`Bearer ${n}`,"Content-Type":"application/json",...r.includes("ngrok")?{"ngrok-skip-browser-warning":"1"}:{}}),body:JSON.stringify({ios_runtime:e.runtime,timeout_ms:e.timeoutMs}),signal:AbortSignal.timeout(e.timeoutMs)})}catch(t){if(t instanceof Error&&"TimeoutError"===t.name)throw rs(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0);throw rs(t instanceof Error?t.message:String(t),!0)}let a=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(i){let n=e.slice(0,200),a=i instanceof Error?i.message:String(i);throw rs(`/api/metro/bridge returned invalid JSON (${t}) from ${r}: ${a}. body=${JSON.stringify(n)}`,rl(t,e))}}(await t.text(),t.status,e.baseUrl);if(!t.ok)throw rs(`/api/metro/bridge failed (${t.status}): ${JSON.stringify(a)}`,rl(t.status,a));var i=a;let o=i.data??i;if(!o||"object"!=typeof o||Array.isArray(o))throw rs("/api/metro/bridge returned malformed descriptor: Expected a JSON object.",!1);try{return{enabled:o.enabled,baseUrl:o.base_url,statusUrl:o.status_url??"",bundleUrl:o.bundle_url??"",iosRuntime:rr(o.ios_runtime,"ios"),androidRuntime:rr(o.android_runtime,"android"),upstream:{bundleUrl:o.upstream.bundle_url??"",host:o.upstream.host??"",port:o.upstream.port??0,statusUrl:o.upstream.status_url??""},probe:{reachable:o.probe.reachable,statusCode:o.probe.status_code,latencyMs:o.probe.latency_ms,detail:o.probe.detail}}}catch(e){throw rs(`/api/metro/bridge returned malformed descriptor: ${e instanceof Error?e.message:String(e)}`,!1)}}function ru(e,t,r,n,a){let i=[`Metro bridge is required for this run but could not be configured via ${e}/api/metro/bridge.`];return t&&i.push(`bridgeError=${t}`),r?.probe.reachable===!1&&i.push(`bridgeProbe=${r.probe.detail||`unreachable (status ${r.probe.statusCode||0})`}`),n&&n!==t&&i.push(`initialBridgeError=${n}`),a&&i.push(`metroCompanionLog=${a}`),i.join(" ")}async function rd(e,t,r){let n=Date.now()+t;for(;Date.now()<n;){let t=Math.min(r,Math.max(n-Date.now(),1));if(await ri(e,t))return!0;let a=Math.min(500,Math.max(n-Date.now(),0));a>0&&await rn(a)}return!1}async function rp(e){let t=Date.now()+e.startupTimeoutMs,r=null,n=null;for(;Date.now()<t;){try{let t=await rc({baseUrl:e.baseUrl,bearerToken:e.bearerToken,runtime:e.runtime,timeoutMs:e.probeTimeoutMs});if(!1!==t.probe.reachable)return t;r=t,n=null}catch(e){if(n=e instanceof Error?e.message:String(e),!(e&&"object"==typeof e&&"retryable"in e&&!0===e.retryable))break}let a=Math.min(1e3,Math.max(t-Date.now(),0));a>0&&await rn(a)}throw Error(ru(e.baseUrl,n,r,e.initialBridgeError,e.companionLogPath))}async function rm(e={}){let t=e.env??process.env,r=process.cwd(),n=t7(e.projectRoot??r,t,r),a=function(e,t){if("auto"!==t)return t;let r=function(e){let t=s.join(e,"package.json");if(!t9(t))throw new ey("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"}(n,e.kind??"auto"),i=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 ey("INVALID_ARGS",`Invalid Metro port: ${String(e)}. Use 1-65535.`);return t}(e.metroPort??8081),o=t6(e.listenHost)??"0.0.0.0",l=t6(e.statusHost)??"127.0.0.1",c=t4(e.publicBaseUrl),u=re(e.startupTimeoutMs,18e4,3e4),d=re(e.probeTimeoutMs,1e4,1e3),p=e.reuseExisting??!0,m=e.installDependenciesIfNeeded??!0,h=e.runtimeFilePath?t7(e.runtimeFilePath,t,r):null,g=t7(e.logPath??s.join(n,".agent-device","metro.log"),t,r);if(!c)throw new ey("INVALID_ARGS","metro prepare requires --public-base-url <url>.");let{proxyEnabled:y,proxyBaseUrl:w,proxyBearerToken:b}=function(e,t){if(e&&!t)throw new ey("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 ey("INVALID_ARGS","metro prepare requires --proxy-base-url when proxy auth is provided.");return{proxyEnabled:!!(e&&t),proxyBaseUrl:e,proxyBearerToken:t}}(t4(e.proxyBaseUrl),t6(e.proxyBearerToken)??""),v=m?function(e,t){if(function(e){try{return f.statSync(e).isDirectory()}catch{return!1}}(s.join(e,"node_modules")))return{installed:!1};let r=t9(s.join(e,"pnpm-lock.yaml"))?{command:"pnpm",installArgs:["install"]}:t9(s.join(e,"yarn.lock"))?{command:"yarn",installArgs:["install"]}:{command:"npm",installArgs:["install"]};return em(r.command,r.installArgs,{cwd:e,env:t}),{installed:!0,packageManager:r.command}}(n,t):{installed:!1},k=`http://${l}:${i}/status`,x=!1,I=!1,A=0;if(p&&await ri(k,d))I=!0;else if(x=!0,A=function(e,t,r,n,a,i){let o="expo"===t?{command:"npx",installArgs:["expo","start","--host","lan","--port",String(r)]}:{command:"npx",installArgs:["react-native","start","--host",n,"--port",String(r)]};f.mkdirSync(s.dirname(a),{recursive:!0});let l=f.openSync(a,"a"),c=0;try{c=ep(o.command,o.installArgs,{cwd:e,env:i,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}}(n,a,i,o,g,t).pid,!await rd(k,u,d))throw await ro(A).catch(()=>{}),Error(`Metro did not become ready at ${k} within ${u}ms. Check ${g}.`);let D=rt(c,"ios"),S=rt(c,"android"),$=null,M=null;if(y)try{$=await rc({baseUrl:w,bearerToken:b,runtime:{metro_bundle_url:D.bundleUrl},timeoutMs:d})}catch(e){M=e instanceof Error?e.message:String(e)}if(y&&(!$||!1===$.probe.reachable)){let r;try{r=(await t5({projectRoot:n,serverBaseUrl:w,bearerToken:b,localBaseUrl:`http://${l}:${i}`,launchUrl:t6(e.launchUrl),profileKey:t6(e.companionProfileKey),consumerKey:t6(e.companionConsumerKey),env:t})).logPath}catch(e){throw Error(ru(w,e instanceof Error?e.message:String(e),$,M))}try{$=await rp({baseUrl:w,bearerToken:b,runtime:{metro_bundle_url:D.bundleUrl},probeTimeoutMs:d,startupTimeoutMs:u,initialBridgeError:M,companionLogPath:r})}catch(e){throw e instanceof Error?e:Error(String(e))}}let P=$?.iosRuntime??D,N=$?.androidRuntime??S,L={projectRoot:n,kind:a,dependenciesInstalled:v.installed,packageManager:v.packageManager??null,started:x,reused:I,pid:A,logPath:g,statusUrl:k,runtimeFilePath:h,iosRuntime:P,androidRuntime:N,bridge:$};return h&&(f.mkdirSync(s.dirname(h),{recursive:!0}),f.writeFileSync(h,JSON.stringify(L,null,2))),L}let rf="alert",rh="appstate",rg="app-switcher",ry="apps",rw="back",rb="batch",rv="boot",rk="click",rx="clipboard",rI="devices",rA="diff",rD="fill",rS="find",r$="focus",rM="home",rP="keyboard",rN="logs",rL="longpress",rR="network",r_="perf",rE="pinch",rT="press",rC="push",rO="record",rU="replay",rF="rotate",rj="scroll",rB="screenshot",rV="settings",rG="snapshot",rq="swipe",rH="test",rK="trace",rX="trigger-app-event",rY="type",rJ="wait";function rz(e,t,r,n){let a=r(e[t]);if(void 0===a)throw new ey("COMMAND_FAILED",n,{response:e});return a}function rW(e,t){return rz(e,t,r3,`Daemon response is missing "${t}".`)}function rZ(e,t){return r3(e[t])}function rQ(e,t){var r;let n;return r=r3,null===(n=e[t])?null:r(n)}function r0(e,t){return rz(e,t,r8,`Daemon response has invalid "${t}".`)}function r1(e,t){return function(e){return"tv"===e||"mobile"===e||"desktop"===e?e:void 0}(e[t])??"mobile"}function r2(e,t){let r=e[t];if(!r7(r))return;let n="number"==typeof r.x?r.x:void 0,a="number"==typeof r.y?r.y:void 0,i="number"==typeof r.width?r.width:void 0,o="number"==typeof r.height?r.height:void 0;if(void 0!==n&&void 0!==a&&void 0!==i&&void 0!==o)return{x:n,y:a,width:i,height:o}}function r3(e){return"string"==typeof e&&e.length>0?e:void 0}function r5(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function r8(e){return"ios"===e||"macos"===e||"android"===e?e:void 0}function r4(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}function r6(e){if(!r7(e))throw new ey("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:e});return e}function r7(e){return"object"==typeof e&&null!==e}function r9(e){let t={};for(let[r,n]of Object.entries(e))void 0!==n&&(t[r]=n);return t}function ne(e,t){let r=rZ(e,"bundleId"),n=rZ(e,"package");return{app:rW(e,"app"),appPath:rW(e,"appPath"),platform:r0(e,"platform"),appId:r??n,bundleId:r,package:n,identifiers:P({session:t,bundleId:r,packageName:n})}}function nt(e){let t=r6(e),r=r0(t,"platform"),n=rW(t,"id"),a=rW(t,"name");return{platform:r,target:r1(t,"target"),kind:rz(t,"kind",r4,'Daemon response has invalid "kind".'),id:n,name:a,booted:"boolean"==typeof t.booted?t.booted:void 0,identifiers:M(r,n,a),ios:"ios"===r?{udid:n}:void 0,android:"android"===r?{serial:n}:void 0}}function nr(e){let t=r6(e),r=r0(t,"platform"),n=rW(t,"id"),a=rW(t,"name"),i=r1(t,"target"),o=rW(t,"device"),s={session:a,...M(r,n,o)};return{name:a,createdAt:rz(t,"createdAt",r5,'Daemon response is missing numeric "createdAt".'),device:{platform:r,target:i,id:n,name:o,identifiers:s,ios:"ios"===r?{udid:n,simulatorSetPath:rQ(t,"ios_simulator_device_set")}:void 0,android:"android"===r?{serial:n}:void 0},identifiers:s}}function nn(e){return e??"default"}function na(e){return void 0!==e.ref?[e.ref,...ni(e.label)]:void 0!==e.selector?[e.selector]:[String(e.x),String(e.y)]}function ni(e){return void 0===e?[]:[e]}function no(e){return void 0===e?[]:[String(e)]}function ns(e){let t=e.lease;if(!t||"object"!=typeof t||Array.isArray(t))throw Error("Invalid lease response from daemon");return{leaseId:rW(t,"leaseId"),tenantId:rW(t,"tenantId"),runId:rW(t,"runId"),backend:rW(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}}function nl(e){return{platform:e.platform,target:e.target,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist}}function nc(e,t,r){var n;if(e.json)return void e5({success:!0,data:t});let a=r?.();a&&(n=a,process.stdout.write(n.endsWith("\n")?n:`${n}
28
+ `))}function nu(e,t){nc(e,t,()=>F(t))}let nd=async({positionals:e,flags:t,client:r})=>{if("list"!==(e[0]??"list"))throw new ey("INVALID_ARGS","session only supports list");let n={sessions:(await r.sessions.list()).map(D)};return nc(t,n,()=>JSON.stringify(n,null,2)),!0},np=async({flags:e,client:t})=>{let r=await t.devices.list(nl(e));return nc(e,{devices:r.map(B)},()=>r.map(nm).join("\n")),!0};function nm(e){let t=e.kind?` ${e.kind}`:"",r=e.target?` target=${e.target}`:"",n="boolean"==typeof e.booted?` booted=${e.booted}`:"";return`${e.name} (${e.platform}${t}${r})${n}`}let nf=async({flags:e,client:t})=>{if(!e.device)throw new ey("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 nc(e,j(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},nh=async({positionals:e,flags:t,client:r})=>{if("prepare"!==(e[0]??"").toLowerCase())throw new ey("INVALID_ARGS","metro only supports prepare");if(!t.metroPublicBaseUrl)throw new ey("INVALID_ARGS","metro prepare requires --public-base-url <url>.");let n=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,startupTimeoutMs:t.metroStartupTimeoutMs,probeTimeoutMs:t.metroProbeTimeoutMs,reuseExisting:!t.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!t.metroNoInstallDeps&&void 0,runtimeFilePath:t.metroRuntimeFile});return nc(t,n,()=>JSON.stringify(n,null,2)),!0},ng=async({flags:e,client:t})=>{let r=await t.apps.list({...nl(e),appsFilter:e.appsFilter});return nc(e,{apps:r},()=>r.join("\n")),!0},ny=async({positionals:e,flags:t,client:r})=>{let n=U(await nv("install",e,t,r));return nu(t,n),!0},nw=async({positionals:e,flags:t,client:r})=>{let n=U(await nv("reinstall",e,t,r));return nu(t,n),!0},nb=async({positionals:e,flags:t,client:r})=>{let n=es(await nk(e,t,r));return nu(t,n),!0};async function nv(e,t,r,n){let a=t[0],i=t[1];if(!a||!i)throw new ey("INVALID_ARGS",`${e} requires: ${e} <app> <path-to-app-binary>`);let o={app:a,appPath:i,...nl(r)};return"install"===e?await n.apps.install(o):await n.apps.reinstall(o)}async function nk(e,t,r){let n=e[0]?.trim();if(!n)throw new ey("INVALID_ARGS","install-from-source requires: install-from-source <url>");if(e.length>1)throw new ey("INVALID_ARGS","install-from-source accepts exactly one positional argument: <url>");return await r.apps.installFromSource({...nl(t),retainPaths:t.retainPaths,retentionMs:t.retentionMs,source:{kind:"url",url:n,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 ey("INVALID_ARGS",`Invalid --header value "${r}". Expected "name:value".`);let n=r.slice(0,e).trim(),a=r.slice(e+1).trim();if(!n)throw new ey("INVALID_ARGS",`Invalid --header value "${r}". Header name cannot be empty.`);t[n]=a}return t}(t.header)}})}let nx=async({positionals:e,flags:t,client:r})=>{let n=T(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,...nl(t)}));return nu(t,n),!0},nI=async({positionals:e,flags:t,client:r})=>{let n=Z(e[0]?await r.apps.close({app:e[0],shutdown:t.shutdown}):await r.sessions.close({shutdown:t.shutdown}));return nu(t,n),!0};async function nA(e){await t8(e)}let nD=[{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"}],nS=new Map(nD.map(e=>[e.key,e]));function n$(e){let t=function(e){var t;let r,n,a,i=e.env??process.env,o=(r=(t=e).env??process.env,W(t.configPath,{cwd:t.cwd,env:r}));if(!f.existsSync(o))throw new ey("INVALID_ARGS",`Remote config file not found: ${o}`);try{n=f.readFileSync(o,"utf8")}catch(e){throw new ey("INVALID_ARGS",`Failed to read remote config file: ${o}`,{cause:e instanceof Error?e.message:String(e)})}try{a=JSON.parse(n)}catch(e){throw new ey("INVALID_ARGS",`Invalid JSON in remote config file: ${o}`,{cause:e instanceof Error?e.message:String(e)})}if(!a||"object"!=typeof a||Array.isArray(a))throw new ey("INVALID_ARGS",`Remote config file must contain a JSON object: ${o}`);let l={},c=a,u=s.dirname(o);for(let[e,t]of Object.entries(c)){let r=nS.get(e);if(!r)throw new ey("INVALID_ARGS",`Unsupported remote config key "${e}" in remote config file ${o}.`);let n=eK(r,t,`remote config file ${o}`,e);l[r.key]="string"==typeof n&&"path"in r&&r.path?W(n,{cwd:u,env:i}):n}return{resolvedPath:o,profile:l}}(e);return{resolvedPath:t.resolvedPath,profile:function(...e){let t={};for(let r of e)if(r)for(let e of nD){let n=r[e.key];void 0!==n&&(t[e.key]=n)}return t}(function(e=process.env){let t={};for(let r of nD){let n=(function(e){let t=nS.get(e);return[eH(e),...t?.legacyEnvNames??[]]})(r.key).map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);n&&(t[r.key]=eK(r,n.value,`environment variable ${n.name}`,n.name))}return t}(e.env),t.profile)}}function nM(e){var t;let r,n=nL(e);if(!f.existsSync(n))return null;try{r=JSON.parse(f.readFileSync(n,"utf8"))}catch(t){return nC(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&&"string"==typeof t.leaseId&&"string"==typeof t.leaseBackend&&"string"==typeof t.connectedAt&&"string"==typeof t.updatedAt?r:(nC(e),null)}function nP(e){f.rmSync(nL(e),{force:!0});let t=nR(e.stateDir);nE(e.stateDir)===e.session&&f.rmSync(t,{force:!0})}function nN(e){try{return y.createHash("sha256").update(f.readFileSync(e)).digest("hex")}catch(t){throw new ey("INVALID_ARGS",`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function nL(e){return s.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 nR(e){return s.join(e,"remote-connections",".active-session.json")}function n_(e){let t=nE(e.stateDir);return t?nM({stateDir:e.stateDir,session:t}):null}function nE(e){let t=nR(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 nT(e,t){f.writeFileSync(e,`${JSON.stringify(t,null,2)}
30
+ `,{encoding:"utf8",mode:384}),f.chmodSync(e,384)}function nC(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}}),nP(e)}let nO=async({flags:e,client:t})=>{var r,n,a,i;let o,l;if(!e.remoteConfig)throw new ey("INVALID_ARGS","connect requires --remote-config <path>.");let c=e.session??"default",u=e.tenant,d=e.runId;if(!u)throw new ey("INVALID_ARGS","connect requires tenant in remote config or via --tenant <id>.");if(!d)throw new ey("INVALID_ARGS","connect requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new ey("INVALID_ARGS","connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let p=n$({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env}),m=nN(p.resolvedPath),h=e.leaseBackend??function(e){if("android"===e)return"android-instance";if("ios"===e)return"ios-instance";throw new ey("INVALID_ARGS","connect requires --lease-backend when platform is not ios or android.")}(e.platform),g={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(/\/+$/,"")}((r=e).daemonBaseUrl),transport:r.daemonTransport,serverMode:r.daemonServerMode},y=ea(e.stateDir).baseDir,w=nM({stateDir:y,session:c});if(w&&(n=w,a={flags:e,remoteConfigPath:p.resolvedPath,remoteConfigHash:m,leaseBackend:h,daemon:g},!(n.remoteConfigPath===a.remoteConfigPath&&n.remoteConfigHash===a.remoteConfigHash&&n.session===(a.flags.session??"default")&&n.tenant===a.flags.tenant&&n.runId===a.flags.runId&&n.leaseBackend===a.leaseBackend&&n.platform===a.flags.platform&&n.target===a.flags.target&&nq(n.daemon,a.daemon)))&&!e.force)throw new ey("INVALID_ARGS","A different remote connection is already active for this session. Re-run connect with --force to replace it.",{session:c,remoteConfig:w.remoteConfigPath});let b=!1,v=!1;try{let r;(o=w&&w.leaseId&&!e.force?await nj(t,w.leaseId,{tenant:u,runId:d,leaseBackend:h}):void 0)||(o=await t.leases.allocate({tenant:u,runId:d,leaseBackend:h}),b=!0);let n=await nB(e,t,p.resolvedPath,c);l=n.cleanup;let a=new Date().toISOString(),k={version:1,session:c,remoteConfigPath:p.resolvedPath,remoteConfigHash:m,daemon:g,tenant:u,runId:d,leaseId:o.leaseId,leaseBackend:h,platform:e.platform,target:e.target,runtime:n.runtime,metro:l,connectedAt:w&&!e.force?w.connectedAt:a,updatedAt:a};i={stateDir:y,state:k},r=nL({stateDir:i.stateDir,session:i.state.session}),f.mkdirSync(s.dirname(r),{recursive:!0}),nT(r,i.state),nT(nR(i.stateDir),{session:i.state.session}),v=!0,w&&e.force&&(w.metro?.projectRoot!==l?.projectRoot||w.metro?.profileKey!==l?.profileKey||w.metro?.consumerKey!==l?.consumerKey)&&await nV(w.metro),w&&e.force&&(w.tenant!==k.tenant||w.runId!==k.runId||w.leaseId!==k.leaseId||!nq(w.daemon,k.daemon))&&await nG(t,w),nc(e,nH(k),()=>`Connected remote session "${c}" tenant "${u}" run "${d}" lease ${k.leaseId}`)}catch(e){if(v||await nV(l),b&&o)try{await t.leases.release({tenant:u,runId:d,leaseId:o.leaseId})}catch{}throw e}return!0},nU=async({flags:e,client:t})=>{let r=e.session??"default",n=ea(e.stateDir).baseDir,a=nM({stateDir:n,session:r})??(e.session?null:n_({stateDir:n}));if(!a)return nc(e,{connected:!1,session:r},()=>`No remote connection for "${r}".`),!0;let i=a.session;try{await t.sessions.close({shutdown:e.shutdown})}catch{}await nV(a.metro);let o=!1;try{o=(await t.leases.release({tenant:a.tenant,runId:a.runId,leaseId:a.leaseId})).released}catch{}return nP({stateDir:n,session:i}),nc(e,{connected:!1,session:i,released:o},()=>`Disconnected remote session "${i}".`),!0},nF=async({positionals:e,flags:t})=>{if("status"!==e[0])throw new ey("INVALID_ARGS","connection accepts only: status");let r=t.session??"default",n=ea(t.stateDir).baseDir,a=nM({stateDir:n,session:r})??(t.session?null:n_({stateDir:n}));return a?nc(t,nH(a),()=>[`Connected remote session "${a.session}".`,`tenant=${a.tenant} runId=${a.runId} leaseId=${a.leaseId} backend=${a.leaseBackend}`,`remoteConfig=${a.remoteConfigPath}`,a.runtime?"metro=prepared":"metro=not-prepared"].join("\n")):nc(t,{connected:!1,session:r},()=>`No remote connection for "${r}".`),!0};async function nj(e,t,r){try{return await e.leases.heartbeat({tenant:r.tenant,runId:r.runId,leaseId:t,leaseBackend:r.leaseBackend})}catch(e){var n;if((n=e)instanceof ey&&"UNAUTHORIZED"===n.code&&(n.details?.reason==="LEASE_NOT_FOUND"||n.details?.reason==="LEASE_EXPIRED"||n.details?.reason==="LEASE_REVOKED"))return;throw e}}async function nB(e,t,r,n){if(!e.metroProjectRoot&&!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)return{};if("ios"!==e.platform&&"android"!==e.platform)throw new ey("INVALID_ARGS",'connect Metro preparation requires platform "ios" or "android".');if(!e.metroPublicBaseUrl)throw new ey("INVALID_ARGS","connect Metro preparation requires metroPublicBaseUrl.");let a=await t.metro.prepare({projectRoot:e.metroProjectRoot,kind:e.metroKind,publicBaseUrl:e.metroPublicBaseUrl,proxyBaseUrl:e.metroProxyBaseUrl,bearerToken:e.metroBearerToken,launchUrl:e.launchUrl,companionProfileKey:r,companionConsumerKey:n,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?a.iosRuntime:a.androidRuntime,cleanup:e.metroProxyBaseUrl?{projectRoot:a.projectRoot,profileKey:r,consumerKey:n}:void 0}}async function nV(e){if(e)try{await nA(e)}catch{}}async function nG(e,t){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 nq(e,t){return(e?.baseUrl??void 0)===(t?.baseUrl??void 0)&&(e?.transport??void 0)===(t?.transport??void 0)&&(e?.serverMode??void 0)===(t?.serverMode??void 0)}function nH(e){return{connected:!0,session:e.session,tenant:e.tenant,runId:e.runId,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},connectedAt:e.connectedAt,updatedAt:e.updatedAt}}let nK=async({flags:e,client:t})=>{let r=S(await t.capture.snapshot({...nl(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}));return nc(e,r,()=>(function(e,t={}){var r,n,a;let i,o=e.nodes,s=Array.isArray(o)?o:[],l="string"==typeof e.backend?e.backend:void 0,c=t.raw||"macos-helper"===l?null:G(s),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??s,h=t.raw||"macos-helper"===l?null:function(e,t,r,n){let a=e.visibility;if(a&&"object"==typeof a&&"boolean"==typeof a.partial&&"number"==typeof a.visibleNodeCount&&"number"==typeof a.totalNodeCount&&Array.isArray(a.reasons))return{partial:a.partial,visibleNodeCount:a.visibleNodeCount,totalNodeCount:a.totalNodeCount,reasons:a.reasons.filter(e=>"string"==typeof e)};let i=t?.hiddenCount??0,o=!!t&&t.nodes.some(e=>e.hiddenContentAbove||e.hiddenContentBelow);return i>0?{partial:!0,visibleNodeCount:r,totalNodeCount:n,reasons:["offscreen-nodes"]}:o?{partial:!0,visibleNodeCount:r,totalNodeCount:r,reasons:[]}:null}(e,c,f.length,s.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: ${s.length} nodes${u?" (truncated)":""}`,y=m.length>0?`${m.join("\n")}
31
+ `:"",w=(r=e,n=s,a=t,i=ti(r),!a.raw&&function(e){if(e.length<20)return!1;let t=new Map;for(let r of e){let e=(r.type??"").toLowerCase(),n=X(r).trim().toLowerCase();if(!n)continue;let a=`${e}|${n}`;t.set(a,(t.get(a)??0)+1)}let r=0;for(let e of t.values())e>1&&(r+=e);return r>=8}(n)&&i.push("Warning: possible repeated nav subtree detected."),i),b=w.length>0?`${w.join("\n")}
32
+ `:"";if(0===s.length)return`${y}${g}
33
+ ${b}`;if(t.raw){let e=s.map(e=>JSON.stringify(e));return`${y}${g}
32
34
  ${b}${e.join("\n")}
33
- `}if(t.flatten){let e=V(f,{summarizeTextSurfaces:!0}).flatMap(e=>[eu(e.node,0,!1,e.type,{summarizeTextSurfaces:!0}),...e4({...e,depth:0})]),t=u&&u.summaryLines.length>0?`
34
- ${u.summaryLines.join("\n")}`:"";return`${y}${g}
35
+ `}if(t.flatten){let e=V(f,{summarizeTextSurfaces:!0}).flatMap(e=>[eu(e.node,0,!1,e.type,{summarizeTextSurfaces:!0}),...to({...e,depth:0})]),t=c&&c.summaryLines.length>0?`
36
+ ${c.summaryLines.join("\n")}`:"";return`${y}${g}
35
37
  ${b}${e.join("\n")}${t}
36
- `}let v=V(f,{summarizeTextSurfaces:!0}).flatMap(e=>[e.text,...e4(e)]),k=u&&u.summaryLines.length>0?`
37
- ${u.summaryLines.join("\n")}`:"";return`${y}${g}
38
+ `}let v=V(f,{summarizeTextSurfaces:!0}).flatMap(e=>[e.text,...to(e)]),k=c&&c.summaryLines.length>0?`
39
+ ${c.summaryLines.join("\n")}`:"";return`${y}${g}
38
40
  ${b}${v.join("\n")}${k}
39
- `})(r,{raw:e.snapshotRaw,flatten:e.snapshotInteractiveOnly})),!0},aS=255*Math.sqrt(3);async function a$(e,t,r={}){await aN(e,"Baseline image not found"),await aN(t,"Current screenshot not found");let a=r.outputPath,[o,s]=await Promise.all([h.readFile(e),h.readFile(t)]),n=ei(o,"baseline screenshot"),l=ei(s,"current screenshot"),u=r.threshold??.1;if(n.width!==l.width||n.height!==l.height){let e=n.width*n.height;return await ax(r.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:n.width,height:n.height},actual:{width:l.width,height:l.height}}}}let c=n.width*n.height,p=u*aS,d=new b({width:n.width,height:n.height}),m=0;for(let e=0;e<n.data.length;e+=4){if(Math.sqrt((n.data[e]-l.data[e])**2+(n.data[e+1]-l.data[e+1])**2+(n.data[e+2]-l.data[e+2])**2)>p){m+=1,d.data[e]=255,d.data[e+1]=0,d.data[e+2]=0,d.data[e+3]=255;continue}let t=Math.round(.3*Math.round((n.data[e]+n.data[e+1]+n.data[e+2])/3));d.data[e]=t,d.data[e+1]=t,d.data[e+2]=t,d.data[e+3]=255}m>0&&a?(await h.mkdir(i.dirname(a),{recursive:!0}),await h.writeFile(a,b.sync.write(d))):await ax(r.outputPath);let f=c>0?Math.round(m/c*1e4)/100:0;return{...m>0&&a?{diffPath:a}:{},totalPixels:c,differentPixels:m,mismatchPercentage:f,match:0===m}}async function aN(e,t){try{await h.access(e)}catch{throw new ef("INVALID_ARGS",`${t}: ${e}`)}}async function ax(e){if(e)try{await h.unlink(e)}catch(e){var t;if(!("object"==typeof(t=e)&&null!==t&&"code"in t&&"ENOENT"===t.code))throw e}}let aL=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 ai(t,{path:a.path,...a.overlayRefs?{overlayRefs:a.overlayRefs}:{}},()=>a.overlayRefs?`Annotated ${a.overlayRefs.length} refs onto ${a.path}`:a.path),!0},aE=async({positionals:e,flags:t,client:r})=>{let a;if("snapshot"===e[0]){let e=await r.capture.diff({...an(t),kind:"snapshot",out:t.out,interactiveOnly:t.snapshotInteractiveOnly,compact:t.snapshotCompact,depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw});return ai(t,e,()=>(function(e){var t;let r=!0===e.baselineInitialized,a=e.summary??{},o=e3(a.additions),s=e3(a.removals),n=e3(a.unchanged),i=e5(),u=e8(e),c=u.length>0?`${u.join("\n")}
40
- `:"";if(r)return`${c}Baseline initialized (${n} lines).
41
- `;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 r=Array(e.length).fill(!1);for(let a of t){let t=Math.max(0,a-1),o=Math.min(e.length-1,a+1);for(let e=t;e<=o;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}),d=p.length>0?`${p.join("\n")}
42
- `:"";if(!i)return`${c}${d}${o} additions, ${s} removals, ${n} unchanged
43
- `;let m=`${(t=String(o),l("green",t))} additions, ${l("red",String(s))} removals, ${l("dim",String(n))} unchanged`;return`${c}${d}${m}
44
- `})(e)),!0}if("screenshot"!==e[0])return!1;let o=t.baseline;if(!o||"string"!=typeof o)throw new ef("INVALID_ARGS","diff screenshot requires --baseline <path>");let s=X(o),n="string"==typeof t.out?X(t.out):void 0,u=.1;if(null!=t.threshold&&""!==t.threshold&&(Number.isNaN(u=Number(t.threshold))||u<0||u>1))throw new ef("INVALID_ARGS","--threshold must be a number between 0 and 1");let c=f.mkdtempSync(i.join(w.tmpdir(),"agent-device-diff-current-")),p=i.join(c,`current-${Date.now()}.png`),d=(await r.capture.screenshot({path:p})).path;try{a=await a$(s,d,{threshold:u,outputPath:n})}finally{try{f.unlinkSync(d)}catch{}try{f.rmSync(c,{recursive:!0,force:!0})}catch{}}return ai(t,a,()=>(function(e){let t=e5(),r=!0===e.match,a=e3(e.differentPixels),o=e3(e.totalPixels),s=e3(e.mismatchPercentage),n=e.diffPath,u=e.dimensionMismatch,c=[];if(r){let e=t?l("green","✓"):"✓";c.push(`${e} Screenshots match.`)}else if(u){let e=t?l("red","✗"):"✗",r=u.expected,a=u.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===s&&a>0?"<0.01":String(s);c.push(`${e} ${r}% pixels differ`)}if(n&&!r){var p;let e,r,a=(p=n,e=process.cwd(),""!==(r=i.relative(e,p))&&(r.startsWith("..")||i.isAbsolute(r))?p:""===r?".":`.${i.sep}${r}`),o=t?l("dim","Diff image:"):"Diff image:",s=t?l("green",a):a;c.push(` ${o} ${s}`)}if(!r&&!u){let e=t?l("red",String(a)):String(a);c.push(` ${e} different / ${o} total pixels`)}return`${c.join("\n")}
45
- `})(a)),!0};function aP(e){return null===e?{}:{timeoutMs:e}}function a_(e){let{suite:t,json:r,verbose:a,reportJunit:o}=e;return(o&&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="${aR(e.durationMs)}">`];for(let r of e.tests)t.push(...function(e){let t=aO(i.basename(e.file)),r=aO("."===i.dirname(e.file)?e.file:i.dirname(e.file)),a=aO(e.file),o=aR(e.durationMs),s=[` <testcase classname="${r}" name="${t}" file="${a}" time="${o}">`];"failed"===e.status?s.push(` <failure message="${aO(e.error.message)}">${aO(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&&s.push(` <skipped message="${aO(e.message)}" />`);let n=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 n&&s.push(` <system-out>${aO(n)}</system-out>`),s.push(" </testcase>"),s}(r));return t.push(" </testsuite>"),t.push("</testsuites>"),`${t.join("\n")}
46
- `}(t),"utf8")}catch(r){let t=r instanceof Error?r.message:String(r);throw new ef("COMMAND_FAILED",`Failed to write JUnit report to ${e}: ${t}`)}}(o,t),r)?(e1({success:!0,data:t}),function(e){return+(e.failed>0)}(t)):function(e,t={}){let r=e.tests.filter(aT);if(t.verbose)for(let t of e.tests)!function(e){if("failed"===e.status)return aM(e);let t="passed"===e.status?aT(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}
41
+ `})(r,{raw:e.snapshotRaw,flatten:e.snapshotInteractiveOnly})),!0},nX=[0,187,255,255];function nY(e,t,r,n){if(t<0||t>=e.width||r<0||r>=e.height)return;let a=(r*e.width+t)*4;e.data[a]=n[0],e.data[a+1]=n[1],e.data[a+2]=n[2],e.data[a+3]=n[3]}function nJ(e,t,r){return Math.min(Math.max(e,t),r)}let nz={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},nW={leading:20,trailing:20,separator:10,unknown:0,background:-30};function nZ(e){return"background"!==e.likelyKind}function nQ(e,t){return e.width>=.25*t.width||e.height>=.06*t.height}function n0(e,t){let r,n=0;for(let a of t){let t=n8(e,a.rect);t<=n||(n=t,r=a)}return r}function n1(e){let t=[];for(let r of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>{var t,n;return t=e.rect,n8(t,n=r.rect)>0||Math.abs(n4(t).y-n4(n).y)<=.5*Math.max(t.height,n.height)});if(!e){t.push({rect:r.rect,blocks:[r]});continue}e.blocks.push(r),e.blocks.sort((e,t)=>e.rect.x-t.rect.x),e.rect=function(e){let t=1/0,r=1/0,n=-1/0,a=-1/0;for(let i of e)t=Math.min(t,i.x),r=Math.min(r,i.y),n=Math.max(n,i.x+i.width),a=Math.max(a,i.y+i.height);return{x:t,y:r,width:n-t,height:a-r}}([e.rect,r.rect])}return t}function n2(e,t){let r,n=n4(e);for(let e of t){var a,i;let t=Math.sqrt((a=n,i=n4(e.rect),(a.x-i.x)**2+(a.y-i.y)**2));r&&t>=r.distance||(r={block:e,distance:t})}return r}function n3(e){let t=n5(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function n5(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function n8(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}function n4(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function n6(e,t,r){return Math.min(Math.max(e,t),r)}async function n7(e){if(await ed("tesseract"))try{let[t,r]=await Promise.all([ae(e.baselinePath),ae(e.currentPath)]);if(0!==t.exitCode||0!==r.exitCode)return;let n=n9(t.stdout,e.width,e.height),a=n9(r.stdout,e.width,e.height),i=function(e,t){let r=new Set,n=[];for(let i of e){var a;let e=as(i.text),o=function(e,t,r,n){let a=null,i=1/0;for(let l=0;l<r.length;l+=1){var o,s;if(n.has(l))continue;let c=r[l];if(as(c.text)!==t)continue;let u=(o=aa(e.normalizedRect),s=aa(c.normalizedRect),(o.x-s.x)**2+(o.y-s.y)**2);u>=i||(a=l,i=u)}return a}(i,e,t,r);if(null===o)continue;r.add(o);let s=function(e,t){let r={x:t.rect.x-e.rect.x,y:t.rect.y-e.rect.y,width:t.rect.width-e.rect.width,height:t.rect.height-e.rect.height},n=au(t.rect.width/e.rect.width),a=au(t.rect.height/e.rect.height),i=Math.abs(n-1)>=.08||Math.abs(a-1)>=.12;return{text:e.text,baselineRect:e.rect,currentRect:t.rect,delta:r,confidence:Math.round(100*Math.min(e.confidence,t.confidence))/100,possibleTextMetricMismatch:i}}(i,t[o]);a=s,(Math.abs(a.delta.x)>=2||Math.abs(a.delta.y)>=2||Math.abs(a.delta.width)>=2||Math.abs(a.delta.height)>=2||a.possibleTextMetricMismatch)&&n.push(s)}return n.sort((e,t)=>at(t)-at(e)).slice(0,12)}(n,a),o=function(e){let t=[];for(let r of[...e].sort((e,t)=>e.currentRect.y-t.currentRect.y)){let e=t.find(e=>32>=Math.abs(r.delta.x-al(e.map(e=>e.delta.x))));e?e.push(r):t.push([r])}return t.filter(e=>e.length>=2).map(ar).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>an(t)-an(e)).slice(0,4)}(i);if(0===n.length&&0===a.length)return;return{provider:"tesseract",baselineBlocks:n.length,currentBlocks:a.length,baselineBlocksRaw:n,currentBlocksRaw:a,matches:i,...o.length>0?{movementClusters:o}:{}}}catch{return}}function n9(e,t,r){let[n,...a]=e.split(/\r?\n/);if(!n)return[];let i=new Map(n.split(" ").map((e,t)=>[e,t])),o=[];for(let e of a){var s;if(!e.trim())continue;let t=e.split(" "),r=ao(t,i,"level"),n=ai(t,i,"text").trim(),a=ao(t,i,"conf");if(5!==r||(s=n,!/[\p{L}\p{N}]/u.test(s))||a<0)continue;let l=ao(t,i,"left"),c=ao(t,i,"top"),u=ao(t,i,"width"),d=ao(t,i,"height");u<=0||d<=0||o.push({key:[ai(t,i,"page_num"),ai(t,i,"block_num"),ai(t,i,"par_num"),ai(t,i,"line_num")].join(":"),text:n,confidence:a,rect:{x:l,y:c,width:u,height:d}})}let l=new Map;for(let e of o){let t=l.get(e.key);t?t.push(e):l.set(e.key,[e])}return Array.from(l.values()).flatMap(e=>(function(e){let t=[...e].sort((e,t)=>e.rect.x-t.rect.x),r=[],n=[];for(let e of t){let t=n.at(-1);if(!t){n.push(e);continue}if(e.rect.x-(t.rect.x+t.rect.width)>Math.max(48,2.5*Math.max(t.rect.height,e.rect.height))){r.push(n),n=[e];continue}n.push(e)}return n.length>0&&r.push(n),r})(e)).map(e=>(function(e,t,r){if(0===e.length)return null;let n=[...e].sort((e,t)=>e.rect.x-t.rect.x),a=function(e){let t=1/0,r=1/0,n=-1/0,a=-1/0;for(let i of e)t=Math.min(t,i.x),r=Math.min(r,i.y),n=Math.max(n,i.x+i.width),a=Math.max(a,i.y+i.height);return{x:t,y:r,width:n-t,height:a-r}}(n.map(e=>e.rect)),i=Math.round(100*al(n.map(e=>e.confidence)))/100;return{text:n.map(e=>e.text).join(" "),confidence:i,rect:a,normalizedRect:{x:ac(a.x/t),y:ac(a.y/r),width:ac(a.width/t),height:ac(a.height/r)}}})(e,t,r)).filter(e=>null!==e)}function ae(e){return eg("tesseract",[e,"stdout","-l","eng","tsv"],{allowFailure:!0,timeoutMs:1e4})}function at(e){return Math.abs(e.delta.x)+Math.abs(e.delta.y)+Math.abs(e.delta.width)+Math.abs(e.delta.height)+25*!!e.possibleTextMetricMismatch}function ar(e){let t=e.map(e=>e.delta.x),r=e.map(e=>e.delta.y);return{texts:e.map(e=>e.text),xRange:{min:Math.min(...t),max:Math.max(...t)},yRange:{min:Math.min(...r),max:Math.max(...r)}}}function an(e){return 2*Math.abs((e.xRange.min+e.xRange.max)/2)+Math.abs((e.yRange.min+e.yRange.max)/2)}function aa(e){return{x:e.x+e.width/2,y:e.y+e.height/2}}function ai(e,t,r){let n=t.get(r);return void 0===n?"":e[n]??""}function ao(e,t,r){let n=Number(ai(e,t,r));return Number.isFinite(n)?n:0}function as(e){return e.trim().replace(/\s+/g," ").toLowerCase()}function al(e){return e.reduce((e,t)=>e+t,0)/e.length}function ac(e){return Math.round(100*e*100)/100}function au(e){return Math.round(1e3*e)/1e3}function ad(e,t,r,n){return{r:Math.round(e/n),g:Math.round(t/n),b:Math.round(r/n)}}function ap(e){return .2126*e.r+.7152*e.g+.0722*e.b}function am(e){return`#${af(e.r)}${af(e.g)}${af(e.b)}`}function af(e){return e.toString(16).padStart(2,"0")}function ah(e){return Math.round(100*e*100)/100}let ag=255*Math.sqrt(3);async function ay(e,t,r={}){let n,a,i,o;await aw(e,"Baseline image not found"),await aw(t,"Current screenshot not found");let l=r.outputPath,[c,u]=await Promise.all([h.readFile(e),h.readFile(t)]),d=el(c,"baseline screenshot"),p=el(u,"current screenshot"),m=r.threshold??.1;if(d.width!==p.width||d.height!==p.height){let e=d.width*d.height;return await ab(r.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:d.width,height:d.height},actual:{width:p.width,height:p.height}}}}let f=d.width*d.height,g=m*ag,y=new v({width:d.width,height:d.height}),w=new Uint8Array(f),b=0;for(let e=0,t=0;e<d.data.length;e+=4,t+=1){if(Math.sqrt((d.data[e]-p.data[e])**2+(d.data[e+1]-p.data[e+1])**2+(d.data[e+2]-p.data[e+2])**2)>g){b+=1,w[t]=1;let r=av(p,e);y.data[e]=ak(r,220,.78),y.data[e+1]=ak(r,0,.78),y.data[e+2]=ak(r,0,.78),y.data[e+3]=255;continue}let r=av(p,e);y.data[e]=r,y.data[e+1]=r,y.data[e+2]=r,y.data[e+3]=255}let k=b>0?(I=(n=function(e){let{diffMask:t,baseline:r,current:n}=e,{width:a,height:i}=r,o=new Uint8Array(t.length),s=new Int32Array(t.length),l=[];for(let e=0;e<t.length;e+=1){if(1!==t[e]||1===o[e])continue;let c=0,u=0;s[0]=e,u+=1,o[e]=1;let d=e%a,p=Math.floor(e/a),m={minX:d,minY:p,maxX:d,maxY:p,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0};for(;c<u;){let e=s[c];c+=1,function(e,t,r,n,a){let i=t%r,o=Math.floor(t/r),s=4*t;e.minX=Math.min(e.minX,i),e.minY=Math.min(e.minY,o),e.maxX=Math.max(e.maxX,i),e.maxY=Math.max(e.maxY,o),e.differentPixels+=1,e.baselineRed+=n.data[s],e.baselineGreen+=n.data[s+1],e.baselineBlue+=n.data[s+2],e.currentRed+=a.data[s],e.currentGreen+=a.data[s+1],e.currentBlue+=a.data[s+2]}(m,e,a,r,n);let l=e%a,d=Math.floor(e/a);for(let e=-1;e<=1;e+=1){let r=d+e;if(!(r<0)&&!(r>=i))for(let n=-1;n<=1;n+=1){if(0===n&&0===e)continue;let i=l+n;if(i<0||i>=a)continue;let c=r*a+i;1===t[c]&&1!==o[c]&&(o[c]=1,s[u]=c,u+=1)}}}l.push(m)}return l}(x={diffMask:w,baseline:d,current:p,totalPixels:f,differentPixels:b,maxRegions:r.maxRegions})).length<=2e3?function(e){let t=[];for(let a of e.sort((e,t)=>{let r=e.minY-t.minY;return 0!==r?r:e.minX-t.minX})){var r,n;let e=t.find(e=>{var t,r,n;return t=e,r=a,n=12,t.minX-n<=r.maxX&&r.minX-n<=t.maxX&&t.minY-n<=r.maxY&&r.minY-n<=t.maxY});if(!e){t.push({...a});continue}r=e,n=a,r.minX=Math.min(r.minX,n.minX),r.minY=Math.min(r.minY,n.minY),r.maxX=Math.max(r.maxX,n.maxX),r.maxY=Math.max(r.maxY,n.maxY),r.differentPixels+=n.differentPixels,r.baselineRed+=n.baselineRed,r.baselineGreen+=n.baselineGreen,r.baselineBlue+=n.baselineBlue,r.currentRed+=n.currentRed,r.currentGreen+=n.currentGreen,r.currentBlue+=n.currentBlue}return t}(n):n,I.flatMap(e=>{var t,r,n;let a;return(t=e,r=x.baseline.width,n=x.baseline.height,a=t.maxX-t.minX+1,t.maxY-t.minY+1>=Math.max(48,Math.round(.07*n))&&a>=.35*r)?function(e,t,r){var n;let a=function(e,t){let r=[],n=null;for(let a=0;a<e.length;a+=1){if(e[a]<=t){n??=a;continue}null!==n&&(a-n>=6&&r.push([n,a-1]),n=null)}return null!==n&&e.length-n>=6&&r.push([n,e.length-1]),r}((n=function(e,t,r){let n=[];for(let a=e.minY;a<=e.maxY;a+=1){let i=0;for(let n=e.minX;n<=e.maxX;n+=1)1===t[a*r+n]&&(i+=1);n.push(i)}return n}(e,t.diffMask,t.baseline.width)).map((e,t)=>{let r=0,a=0,i=Math.max(0,t-3),o=Math.min(n.length-1,t+3);for(let e=i;e<=o;e+=1)r+=n[e],a+=1;return Math.round(r/a)}),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),i=function(e,t,r){let n=[],a=e.minY;for(let[i,o]of t){let t=e.minY+Math.round((i+o)/2);t-a+1<r||e.maxY-t<r||(n.push([a,t]),a=t+1)}return n.push([a,e.maxY]),n}(e,a,r);if(i.length<=1)return[e];let o=i.map(([r,n])=>(function(e,t,r,n){let a=null;for(let s=t;s<=r;s+=1)for(let t=e.minX;t<=e.maxX;t+=1){var i,o;let e=s*n.baseline.width+t;1===n.diffMask[e]&&function(e,t,r,n,a,i){let o=4*t;e.minX=Math.min(e.minX,r),e.minY=Math.min(e.minY,n),e.maxX=Math.max(e.maxX,r),e.maxY=Math.max(e.maxY,n),e.differentPixels+=1,e.baselineRed+=a.data[o],e.baselineGreen+=a.data[o+1],e.baselineBlue+=a.data[o+2],e.currentRed+=i.data[o],e.currentGreen+=i.data[o+1],e.currentBlue+=i.data[o+2]}(a??={minX:i=t,minY:o=s,maxX:i,maxY:o,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0},e,t,s,n.baseline,n.current)}return a})(e,r,n,t)).filter(e=>null!==e);return o.length>1?o:[e]}(e,x,Math.max(24,Math.round(.03*x.baseline.height))):[e]})).sort((e,t)=>{let r=t.differentPixels-e.differentPixels;if(0!==r)return r;let n=e.minY-t.minY;return 0!==n?n:e.minX-t.minX}).slice(0,Math.max(0,x.maxRegions??8)).map((e,t)=>{var r,n,a,i,o,s,l,c,u,d,p;let m,f,h,g,y,w,b,v,k,I,A,D,S,$,M,P,N;return r=e,n=t+1,a={width:x.baseline.width,height:x.baseline.height,totalPixels:x.totalPixels,differentPixels:x.differentPixels},w={x:r.minX,y:r.minY,width:r.maxX-r.minX+1,height:r.maxY-r.minY+1},b={x:Math.round(r.minX+w.width/2),y:Math.round(r.minY+w.height/2)},v=ad(r.baselineRed,r.baselineGreen,r.baselineBlue,r.differentPixels),k=ad(r.currentRed,r.currentGreen,r.currentBlue,r.differentPixels),I=w.width*w.height,A=ah(r.differentPixels/I),D=Math.round(ap(v)),S=Math.round(ap(k)),$=(i=w,o=a.width,s=a.height,i.width>=.55*o&&i.height>=.12*s?"large-area":i.width>=2.5*i.height?"horizontal-band":i.height>=2.5*i.width?"vertical-band":"compact"),M=(m=I/a.totalPixels)>=.04?"large":m>=.01?"medium":"small",P=(l=v,c=k,f=ap(l),Math.abs(h=ap(c)-f)>=12?h>0?"brighter":"darker":Math.max(Math.abs(c.r-l.r),Math.abs(c.g-l.g),Math.abs(c.b-l.b))>=12?"color-shift":"mixed"),N=(u=b,d=a.width,p=a.height,g=u.x<d/3?"left":u.x>2*d/3?"right":"center",y=u.y<p/3?"top":u.y>2*p/3?"bottom":"middle","center"===g&&"middle"===y?"center":`${y}-${g}`),{index:n,rect:w,normalizedRect:{x:ah(w.x/a.width),y:ah(w.y/a.height),width:ah(w.width/a.width),height:ah(w.height/a.height)},differentPixels:r.differentPixels,shareOfDiffPercentage:ah(r.differentPixels/a.differentPixels),densityPercentage:A,shape:$,size:M,location:N,averageBaselineColorHex:am(v),averageCurrentColorHex:am(k),baselineLuminance:D,currentLuminance:S,dominantChange:P}}):[];if(b>0&&l){var x,I,A;for(let e of k)e.rect.width<4||e.rect.height<4||function(e,t){let r=nJ(t.x,0,e.width-1),n=nJ(t.y,0,e.height-1),a=nJ(t.x+t.width-1,0,e.width-1),i=nJ(t.y+t.height-1,0,e.height-1);for(let t=0;t<2;t+=1){for(let o=r;o<=a;o+=1)nY(e,o,n+t,nX),nY(e,o,i-t,nX);for(let o=n;o<=i;o+=1)nY(e,r+t,o,nX),nY(e,a-t,o,nX)}}(y,e.rect);await h.mkdir(s.dirname(l),{recursive:!0}),await h.writeFile(l,v.sync.write(y))}else await ab(r.outputPath);let D=b>0?await n7({baselinePath:e,currentPath:t,width:d.width,height:d.height}):void 0,S=D&&(D.matches.length>0||(D.movementClusters?.length??0)>0)?{provider:D.provider,baselineBlocks:D.baselineBlocks,currentBlocks:D.currentBlocks,matches:D.matches,...D.movementClusters?{movementClusters:D.movementClusters}:{}}:void 0,$=b>0&&D?(a=function(e){let t=[];for(let r of e.sort((e,t)=>e.minY-t.minY||e.minX-t.minX)){let e=t.find(e=>{var t,n,a;return t=e,n=r,a=10,t.minX-a<=n.maxX&&n.minX-a<=t.maxX&&t.minY-a<=n.maxY&&n.minY-a<=t.maxY});if(!e){t.push({...r});continue}e.minX=Math.min(e.minX,r.minX),e.minY=Math.min(e.minY,r.minY),e.maxX=Math.max(e.maxX,r.maxX),e.maxY=Math.max(e.maxY,r.maxY),e.differentPixels+=r.differentPixels}return t}(function(e,t,r){let n=new Uint8Array(e.length),a=new Int32Array(e.length),i=[];for(let o=0;o<e.length;o+=1){if(1!==e[o]||1===n[o])continue;let s=0,l=0;a[0]=o,l+=1,n[o]=1;let c=o%t,u=Math.floor(o/t),d={minX:c,minY:u,maxX:c,maxY:u,differentPixels:0};for(;s<l;){let i=a[s];s+=1;let o=i%t,c=Math.floor(i/t);d.minX=Math.min(d.minX,o),d.minY=Math.min(d.minY,c),d.maxX=Math.max(d.maxX,o),d.maxY=Math.max(d.maxY,c),d.differentPixels+=1;for(let i=-1;i<=1;i+=1){let s=c+i;if(!(s<0)&&!(s>=r))for(let r=-1;r<=1;r+=1){if(0===r&&0===i)continue;let c=o+r;if(c<0||c>=t)continue;let u=s*t+c;1===e[u]&&1!==n[u]&&(n[u]=1,a[l]=u,l+=1)}}}i.push(d)}return i}(function(e,t,r,n){let a=new Uint8Array(e);if(!n)return a;for(let e of[...n.baselineBlocksRaw,...n.currentBlocksRaw]){var i;!function(e,t,r,n){let a=n6(Math.floor(n.x),0,t-1),i=n6(Math.floor(n.y),0,r-1),o=n6(Math.ceil(n.x+n.width),0,t),s=n6(Math.ceil(n.y+n.height),0,r);for(let r=i;r<s;r+=1)for(let n=a;n<o;n+=1)e[r*t+n]=0}(a,t,r,{x:(i=e.rect).x-8,y:i.y-8,width:i.width+16,height:i.height+16})}return a}((A={diffMask:w,width:d.width,height:d.height,regions:k,ocr:D}).diffMask,A.width,A.height,A.ocr),A.width,A.height)),i=n1(A.ocr?.currentBlocksRaw??[]),o=n1(A.ocr?.baselineBlocksRaw??[]),a.filter(n3).map(e=>{var t,r,n,a,s,l,c,u,d,p,m;let f,h,g,y,w,b,v,k,x,I;return t=e,r=A,n=i,a=o,y=function(e,t){let r,n=0;for(let a of t){let t=function(e,t){let r=Math.max(e.x,t.x),n=Math.max(e.y,t.y),a=Math.min(e.x+e.width,t.x+t.width),i=Math.min(e.y+e.height,t.y+t.height);return a<=r||i<=n?0:(a-r)*(i-n)}(e,a.rect);t<=n||(n=t,r=a)}return r?.index}(g=n5(t),r.regions),w=function(e,t,r){let n=n0(e,t);if(n)return n2(e,n.blocks);let a=n0(e,r);return a?n2(e,a.blocks):void 0}(g,n,a),b=function(e,t,r){if(e.height<=3&&e.width>=.12*r)return"separator";if(!t)return e.width>=.4*r?"background":"unknown";if(e.width>=.4*r)return"background";let n=e.x+e.width/2,a=t.x+t.width/2;return n<a-t.width/2?"leading":n>a+t.width/2?"trailing":e.width>=.35*r?"background":"unknown"}(g,w?.block.rect,r.width),v=(s=g,l=b,c=t.differentPixels,u=r,f=s.width/s.height,h=c/(s.width*s.height),"separator"===l?"separator":"background"===l?"background":"trailing"===l&&f>=1.5&&f<=3.8&&h>=.35?"toggle":"trailing"===l&&s.width<=.06*u.width&&s.height<=.04*u.height?"chevron":"leading"===l&&f>=.55&&f<=1.8?"icon":nQ(s,u)?"background":"visual"),k={...y?{regionIndex:y}:{},slot:b,likelyKind:v,rect:g},{...y?{regionIndex:y}:{},slot:b,likelyKind:v,rect:g,...w?{nearestText:w.block.text.trim().replace(/^[^\p{L}\p{N}]+/u,"").replace(/^\p{L}\s+/u,"")}:{},score:(d=k,p=t.differentPixels,m=r,x=nQ(d.rect,m)?-35:0,I=20*!!d.regionIndex,nz[d.likelyKind]+nW[d.slot]+I+x+Math.min(20,p/200))}}).filter(e=>e.rect.y>=.08*A.height).filter(nZ).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,A.maxDeltas??12)).map((e,t)=>{var r;return r=e,{index:t+1,...r.regionIndex?{regionIndex:r.regionIndex}:{},slot:r.slot,likelyKind:r.likelyKind,rect:r.rect,...r.nearestText?{nearestText:r.nearestText}:{}}})):[],M=f>0?Math.round(b/f*1e4)/100:0;return{...b>0&&l?{diffPath:l}:{},...k.length>0?{regions:k}:{},...S?{ocr:S}:{},...$.length>0?{nonTextDeltas:$}:{},totalPixels:f,differentPixels:b,mismatchPercentage:M,match:0===b}}async function aw(e,t){try{await h.access(e)}catch{throw new ey("INVALID_ARGS",`${t}: ${e}`)}}async function ab(e){if(e)try{await h.unlink(e)}catch(e){var t;if(!("object"==typeof(t=e)&&null!==t&&"code"in t&&"ENOENT"===t.code))throw e}}function av(e,t){return ak(Math.round(.299*e.data[t]+.587*e.data[t+1]+.114*e.data[t+2]),255,.72)}function ak(e,t,r){return Math.round(e*(1-r)+t*r)}function ax(e){return e.width*e.height}function aI(e){return Math.round(100*e*100)/100}let aA=async({positionals:e,flags:t,client:r})=>{let n=await r.capture.screenshot({path:e[0]??t.out,overlayRefs:t.overlayRefs,...void 0!==t.screenshotFullscreen?{fullscreen:t.screenshotFullscreen}:{}});return nc(t,{path:n.path,...n.overlayRefs?{overlayRefs:n.overlayRefs}:{}},()=>n.overlayRefs?`Annotated ${n.overlayRefs.length} refs onto ${n.path}`:n.path),!0},aD=async({positionals:e,flags:t,client:r})=>{let n;if("snapshot"===e[0]){let e=await r.capture.diff({...nl(t),kind:"snapshot",out:t.out,interactiveOnly:t.snapshotInteractiveOnly,compact:t.snapshotCompact,depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw});return nc(t,e,()=>(function(e){var t;let r=!0===e.baselineInitialized,n=e.summary??{},a=tr(n.additions),i=tr(n.removals),o=tr(n.unchanged),s=tn(),c=ti(e),u=c.length>0?`${c.join("\n")}
42
+ `:"";if(r)return`${u}Baseline initialized (${o} lines).
43
+ `;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 n of t){let t=Math.max(0,n-1),a=Math.min(e.length-1,n+1);for(let e=t;e<=a;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 s?l("green",e):e}if("removed"===e.kind){let e=t.startsWith(" ")?`-${t}`:`- ${t}`;return s?l("red",e):e}return s?l("dim",t):t}),p=d.length>0?`${d.join("\n")}
44
+ `:"";if(!s)return`${u}${p}${a} additions, ${i} removals, ${o} unchanged
45
+ `;let m=`${(t=String(a),l("green",t))} additions, ${l("red",String(i))} removals, ${l("dim",String(o))} unchanged`;return`${u}${p}${m}
46
+ `})(e)),!0}if("screenshot"!==e[0])return!1;let a=t.baseline;if(!a||"string"!=typeof a)throw new ey("INVALID_ARGS","diff screenshot requires --baseline <path>");let i=W(a),o="string"==typeof t.out?W(t.out):void 0,c=e[1];if(e.length>2)throw new ey("INVALID_ARGS","diff screenshot accepts at most one current screenshot path");let u=.1;if(null!=t.threshold&&""!==t.threshold&&(Number.isNaN(u=Number(t.threshold))||u<0||u>1))throw new ey("INVALID_ARGS","--threshold must be a number between 0 and 1");if(c){if(t.overlayRefs)throw new ey("INVALID_ARGS","diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs");let e=await ay(i,W(c),{threshold:u,outputPath:o});return nc(t,e,()=>e4(e)),!0}let d=f.mkdtempSync(s.join(b.tmpdir(),"agent-device-diff-current-")),p=s.join(d,`current-${Date.now()}.png`),m=(await r.capture.screenshot({path:p})).path;try{if(n=await ay(i,m,{threshold:u,outputPath:o}),!t.overlayRefs||n.match||n.dimensionMismatch)t.overlayRefs&&o&&function(e){try{f.unlinkSync(aS(e))}catch(e){var t;if(t=e,"object"!=typeof t||null===t||!("code"in t)||"ENOENT"!==t.code)throw e}}(o);else{var h,g;let e=await r.capture.screenshot({path:o?aS(o):void 0,overlayRefs:!0});n={...n,currentOverlayPath:e.path,...e.overlayRefs?{currentOverlayRefCount:e.overlayRefs.length}:{},...n.regions&&e.overlayRefs?{regions:(h=n.regions,g=e.overlayRefs,h.map(e=>{var t,r;let n,a=(t=e,r=g,n=ax(t.rect),r.map(e=>{var r,a;let i,o,s,l,c=e.overlayRect,u=(r=t.rect,a=c,i=Math.max(r.x,a.x),o=Math.max(r.y,a.y),s=Math.min(r.x+r.width,a.x+a.width),l=Math.min(r.y+r.height,a.y+a.height),s<=i||l<=o?0:(s-i)*(l-o));return u<=0?null:{ref:e.ref,...e.label?{label:e.label}:{},rect:c,overlayCoveragePercentage:aI(u/ax(c)),regionCoveragePercentage:aI(u/n)}}).filter(e=>null!==e).sort((e,t)=>{let r=t.regionCoveragePercentage-e.regionCoveragePercentage;return 0!==r?r:t.overlayCoveragePercentage-e.overlayCoveragePercentage}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage})));return a.length>0?{...e,currentOverlayMatches:a}:e}))}:{}}}}finally{try{f.unlinkSync(m)}catch{}try{f.rmSync(d,{recursive:!0,force:!0})}catch{}}return nc(t,n,()=>e4(n)),!0};function aS(e){let t=s.extname(e),r=t?e.slice(0,-t.length):e;return`${r}.current-overlay${t||".png"}`}function a$(e){return null===e?{}:{timeoutMs:e}}function aM(e){let{suite:t,json:r,verbose:n,reportJunit:a}=e;return(a&&function(e,t){let r=s.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="${aL(e.durationMs)}">`];for(let r of e.tests)t.push(...function(e){let t=aR(s.basename(e.file)),r=aR("."===s.dirname(e.file)?e.file:s.dirname(e.file)),n=aR(e.file),a=aL(e.durationMs),i=[` <testcase classname="${r}" name="${t}" file="${n}" time="${a}">`];"failed"===e.status?i.push(` <failure message="${aR(e.error.message)}">${aR(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&&i.push(` <skipped message="${aR(e.message)}" />`);let o=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 o&&i.push(` <system-out>${aR(o)}</system-out>`),i.push(" </testcase>"),i}(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 ey("COMMAND_FAILED",`Failed to write JUnit report to ${e}: ${t}`)}}(a,t),r)?(e5({success:!0,data:t}),function(e){return+(e.failed>0)}(t)):function(e,t={}){let r=e.tests.filter(aN);if(t.verbose)for(let t of e.tests)!function(e){if("failed"===e.status)return aP(e);let t="passed"===e.status?aN(e)?"FLAKY":"PASS":"skipped"===e.status?"SKIP":"INFO",r="attempts"in e&&e.attempts>1?` after ${e.attempts} attempts`:"",n=e.durationMs>0?` (${e.durationMs}ms)`:"";process.stdout.write(`${t} ${e.file}${r}${n}
47
48
  `),"skipped"===e.status&&process.stdout.write(` ${e.message??"skipped"}
48
- `)}(t);else{for(let t of e.failures)aM(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}
49
- `)}(e)}let a="number"==typeof e.durationMs?e.durationMs:void 0,o=r.length>0?`, ${r.length} flaky`:"";return process.stdout.write(`Test summary: ${e.passed} passed, ${e.failed} failed${o}${void 0!==a?` in ${a}ms`:""}
50
- `),function(e){return+(e.failed>0)}(e)}(t,{verbose:a})}function aM(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}
49
+ `)}(t);else{for(let t of e.failures)aP(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 n="number"==typeof e.durationMs?e.durationMs:void 0,a=r.length>0?`, ${r.length} flaky`:"";return process.stdout.write(`Test summary: ${e.passed} passed, ${e.failed} failed${a}${void 0!==n?` in ${n}ms`:""}
51
+ `),function(e){return+(e.failed>0)}(e)}(t,{verbose:n})}function aP(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}
51
52
  `),process.stdout.write(` ${e.error?.message??"Unknown test failure"}
52
53
  `),e.error?.hint&&process.stdout.write(` hint: ${e.error.hint}
53
54
  `),e.artifactsDir&&process.stdout.write(` artifacts: ${e.artifactsDir}
54
55
  `),e.error?.logPath&&process.stdout.write(` log: ${e.error.logPath}
55
56
  `),e.error?.diagnosticId&&process.stdout.write(` diagnostic: ${e.error.diagnosticId}
56
- `)}function aT(e){return"passed"===e.status&&e.attempts>1}function aR(e){return(Math.max(0,e)/1e3).toFixed(3)}function aO(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;").replaceAll("'","&apos;")}let aC={[rc]:aU(rc,({client:e,flags:t})=>e.devices.boot({...an(t),headless:t.headless})),[r$]:aU(r$,({client:e,positionals:t,flags:r})=>e.apps.push({...an(r),app:aG(t[0],"push requires bundleOrPackage"),payload:aG(t[1],"push requires payloadOrJson")})),[rA]:aU(rA,({client:e,flags:t})=>e.observability.perf(an(t))),[rp]:aU(rp,({client:e,positionals:t,flags:r})=>e.interactions.click({...aj(t),...aF(r),...an(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap,button:r.clickButton})),get:aU("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 ef("INVALID_ARGS","get requires @ref or selector expression");return{selector:t}}(t.slice(1)),...aF(r),...an(r),format:function(e){if("text"===e||"attrs"===e)return e;throw new ef("INVALID_ARGS","get only supports text or attrs")}(t[0])})),[rx]:aU(rx,({client:e,positionals:t,flags:r})=>e.replay.run({...an(r),path:aG(t[0],"replay requires path"),update:r.replayUpdate})),[rR]:aU(rR,({client:e,positionals:t,flags:r})=>(({json:r.json}).json||process.stderr.write("Running replay suite...\n"),e.replay.test({...an(r),paths:t,update:r.replayUpdate,failFast:r.failFast,timeoutMs:r.timeoutMs,retries:r.retries,artifactsDir:r.artifactsDir,reportJunit:r.reportJunit}))),[ru]:aU(ru,({client:e,flags:t})=>e.batch.run({...an(t),steps:t.batchSteps??[],onError:t.batchOnError,maxSteps:t.batchMaxSteps,out:t.out})),[rS]:aU(rS,({client:e,positionals:t,flags:r})=>e.interactions.press({...aj(t),...aF(r),...an(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap})),[rk]:aU(rk,({client:e,positionals:t,flags:r})=>e.interactions.longPress({...an(r),x:Number(t[0]),y:Number(t[1]),durationMs:aB(t[2])})),[rT]:aU(rT,({client:e,positionals:t,flags:r})=>e.interactions.swipe({...an(r),from:{x:Number(t[0]),y:Number(t[1])},to:{x:Number(t[2]),y:Number(t[3])},durationMs:aB(t[4]),count:r.count,pauseMs:r.pauseMs,pattern:r.pattern})),[ry]:aU(ry,({client:e,positionals:t,flags:r})=>e.interactions.focus({...an(r),x:Number(t[0]),y:Number(t[1])})),[rU]:aU(rU,({client:e,positionals:t,flags:r})=>e.interactions.type({...an(r),text:t.join(" "),delayMs:r.delayMs})),[rh]:aU(rh,({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),...aF(r),...an(r),delayMs:r.delayMs})),[rE]:aU(rE,({client:e,positionals:t,flags:r})=>e.interactions.scroll({...an(r),direction:function(e){if("up"===e||"down"===e||"left"===e||"right"===e)return e;throw new ef("INVALID_ARGS",`Unknown direction: ${String(e)}`)}(t[0]),amount:aB(t[1]),pixels:r.pixels})),[rD]:aU(rD,({client:e,positionals:t,flags:r})=>e.interactions.pinch({...an(r),scale:Number(t[0]),x:aB(t[1]),y:aB(t[2])})),[rC]:aU(rC,({client:e,positionals:t,flags:r})=>e.apps.triggerEvent({...an(r),event:aG(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 ef("INVALID_ARGS",`${t} must be a JSON object`)}(t[1],"trigger-app-event payload"):void 0})),[rN]:aU(rN,({client:e,positionals:t,flags:r})=>e.recording.record({...an(r),action:aV(t[0],"record"),path:t[1],fps:r.fps,hideTouches:r.hideTouches})),[rO]:aU(rO,({client:e,positionals:t,flags:r})=>e.recording.trace({...an(r),action:aV(t[0],"trace"),path:t[1]})),[rv]:aU(rv,({client:e,positionals:t,flags:r})=>e.observability.logs({...an(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 ef("INVALID_ARGS","logs requires path, start, stop, doctor, mark, or clear")}}(t[0]),message:t.slice(1).join(" ")||void 0,restart:r.restart})),[rI]:aU(rI,({client:e,positionals:t,flags:r})=>e.observability.network({...an(r),action:function(e){if(void 0!==e){if("dump"===e||"log"===e)return e;throw new ef("INVALID_ARGS","network requires dump or log")}}(t[0]),limit:aB(t[1]),include:r.networkInclude??function(e){if(void 0!==e){if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new ef("INVALID_ARGS","network include mode must be summary, headers, body, or all")}}(t[2])})),[rg]:aU(rg,({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],o=r?2:1,s=e[o];if(void 0===s)return{locator:t,query:aG(a,"find requires query")};if("get"===s){let r=e[o+1];if("text"===r)return{locator:t,query:aG(a,"find requires query"),action:"getText"};if("attrs"===r)return{locator:t,query:aG(a,"find requires query"),action:"getAttrs"};throw new ef("INVALID_ARGS","find get only supports text or attrs")}if("wait"===s)return{locator:t,query:aG(a,"find requires query"),action:"wait",timeoutMs:aB(e[o+1])};if("fill"===s||"type"===s)return{locator:t,query:aG(a,"find requires query"),action:s,value:e.slice(o+1).join(" ")};if("click"===s||"focus"===s||"exists"===s)return{locator:t,query:aG(a,"find requires query"),action:s};throw new ef("INVALID_ARGS",`Unsupported find action: ${s}`)}(t),...{depth:(a=r).snapshotDepth,raw:a.snapshotRaw},...an(r),first:r.findFirst,last:r.findLast})}),is:aU("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 ef("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 ef("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text")}(t),...aF(r),...an(r)})),[r_]:aU(r_,({client:e,positionals:t,flags:r})=>e.settings.update(function(e,t){let r=an(t),a=e[0],o=e[1];if(("wifi"===a||"airplane"===a||"location"===a)&&("on"===o||"off"===o)||"appearance"===a&&("light"===o||"dark"===o||"toggle"===o)||("faceid"===a||"touchid"===a)&&("match"===o||"nonmatch"===o||"enroll"===o||"unenroll"===o)||"fingerprint"===a&&("match"===o||"nonmatch"===o))return{...r,setting:a,state:o};if("permission"===a&&("grant"===o||"deny"===o||"reset"===o))return{...r,setting:a,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 ef("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 ef("INVALID_ARGS","settings permission mode must be full or limited.")}(e[3])};throw new ef("INVALID_ARGS","Invalid settings arguments.")}(t,r)))};function aU(e,t){return async({positionals:r,flags:a,client:o})=>{let s=await t({client:o,positionals:r,flags:a}),n=function(e,t,r,a){if(r.json)return e===rR?a_({suite:a,json:!0,reportJunit:r.reportJunit}):(e1({success:!0,data:a}),0);if(e===rR)return a_({suite:a,verbose:r.verbose,reportJunit:r.reportJunit});if(e===ru)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 s of(process.stdout.write(`Batch completed: ${r}/${t} steps${void 0!==a?` in ${a}ms`:""}
57
- `),Array.isArray(e.results)?e.results:[])){var o;if(!s||"object"!=typeof s)continue;let e="number"==typeof s.step?s.step:void 0,t="string"==typeof s.command?s.command:"step",r=!1!==s.ok,a="number"==typeof s.durationMs?s.durationMs:void 0,n=s.data&&"object"==typeof s.data?s.data:void 0,i=s.error&&"object"==typeof s.error?s.error:void 0,l=r?U(n)??t:(o=i,("string"==typeof o?.message&&o.message.length>0?o.message:null)??t),u=void 0!==e?`${e}. `:"- ",c=void 0!==a?` (${a}ms)`:"";process.stdout.write(`${u}${r?"OK":"FAILED"} ${l}${c}
58
- `)}}(a),0;if("get"===e){let e=t[0];if("text"===e)return process.stdout.write(`${"string"==typeof a.text?a.text:""}
59
- `),0;if("attrs"===e)return process.stdout.write(`${JSON.stringify(a.node??{},null,2)}
60
- `),0}if(e===rg){if("string"==typeof a.text)return process.stdout.write(`${a.text}
61
- `),0;if("boolean"==typeof a.found)return process.stdout.write(`Found: ${a.found}
62
- `),0;if(a.node)return process.stdout.write(`${JSON.stringify(a.node,null,2)}
63
- `),0}if("is"===e)return process.stdout.write(`Passed: is ${a.predicate??"assertion"}
64
- `),0;if(e===rc){let e=a.platform??"unknown",t=a.device??a.id??"unknown";return process.stdout.write(`Boot ready: ${t} (${e})
65
- `),0}if(e===rN){let e="string"==typeof a.outPath?a.outPath:"";return e&&process.stdout.write(`${e}
66
- `),0}if(e===rv)return function(e,t){let r="string"==typeof e.path?e.path:"";if(!r)return;process.stdout.write(`${r}
67
- `);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}
68
- `);let o=["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(o&&!t.json&&process.stderr.write(`${o}
57
+ `)}function aN(e){return"passed"===e.status&&e.attempts>1}function aL(e){return(Math.max(0,e)/1e3).toFixed(3)}function aR(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;").replaceAll("'","&apos;")}let a_={[rv]:aE(rv,({client:e,flags:t})=>e.devices.boot({...nl(t),headless:t.headless})),[rC]:aE(rC,({client:e,positionals:t,flags:r})=>e.apps.push({...nl(r),app:aU(t[0],"push requires bundleOrPackage"),payload:aU(t[1],"push requires payloadOrJson")})),[r_]:aE(r_,({client:e,flags:t})=>e.observability.perf(nl(t))),[rk]:aE(rk,({client:e,positionals:t,flags:r})=>e.interactions.click({...aC(t),...aT(r),...nl(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap,button:r.clickButton})),get:aE("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 ey("INVALID_ARGS","get requires @ref or selector expression");return{selector:t}}(t.slice(1)),...aT(r),...nl(r),format:function(e){if("text"===e||"attrs"===e)return e;throw new ey("INVALID_ARGS","get only supports text or attrs")}(t[0])})),[rU]:aE(rU,({client:e,positionals:t,flags:r})=>e.replay.run({...nl(r),path:aU(t[0],"replay requires path"),update:r.replayUpdate})),[rH]:aE(rH,({client:e,positionals:t,flags:r})=>(({json:r.json}).json||process.stderr.write("Running replay suite...\n"),e.replay.test({...nl(r),paths:t,update:r.replayUpdate,failFast:r.failFast,timeoutMs:r.timeoutMs,retries:r.retries,artifactsDir:r.artifactsDir,reportJunit:r.reportJunit}))),[rb]:aE(rb,({client:e,flags:t})=>e.batch.run({...nl(t),steps:t.batchSteps??[],onError:t.batchOnError,maxSteps:t.batchMaxSteps,out:t.out})),[rT]:aE(rT,({client:e,positionals:t,flags:r})=>e.interactions.press({...aC(t),...aT(r),...nl(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap})),[rL]:aE(rL,({client:e,positionals:t,flags:r})=>e.interactions.longPress({...nl(r),x:Number(t[0]),y:Number(t[1]),durationMs:aF(t[2])})),[rq]:aE(rq,({client:e,positionals:t,flags:r})=>e.interactions.swipe({...nl(r),from:{x:Number(t[0]),y:Number(t[1])},to:{x:Number(t[2]),y:Number(t[3])},durationMs:aF(t[4]),count:r.count,pauseMs:r.pauseMs,pattern:r.pattern})),[r$]:aE(r$,({client:e,positionals:t,flags:r})=>e.interactions.focus({...nl(r),x:Number(t[0]),y:Number(t[1])})),[rY]:aE(rY,({client:e,positionals:t,flags:r})=>e.interactions.type({...nl(r),text:t.join(" "),delayMs:r.delayMs})),[rD]:aE(rD,({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=E(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),...aT(r),...nl(r),delayMs:r.delayMs})),[rj]:aE(rj,({client:e,positionals:t,flags:r})=>e.interactions.scroll({...nl(r),direction:function(e){if("up"===e||"down"===e||"left"===e||"right"===e)return e;throw new ey("INVALID_ARGS",`Unknown direction: ${String(e)}`)}(t[0]),amount:aF(t[1]),pixels:r.pixels})),[rE]:aE(rE,({client:e,positionals:t,flags:r})=>e.interactions.pinch({...nl(r),scale:Number(t[0]),x:aF(t[1]),y:aF(t[2])})),[rX]:aE(rX,({client:e,positionals:t,flags:r})=>e.apps.triggerEvent({...nl(r),event:aU(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 ey("INVALID_ARGS",`${t} must be a JSON object`)}(t[1],"trigger-app-event payload"):void 0})),[rO]:aE(rO,({client:e,positionals:t,flags:r})=>e.recording.record({...nl(r),action:aO(t[0],"record"),path:t[1],fps:r.fps,hideTouches:r.hideTouches})),[rK]:aE(rK,({client:e,positionals:t,flags:r})=>e.recording.trace({...nl(r),action:aO(t[0],"trace"),path:t[1]})),[rN]:aE(rN,({client:e,positionals:t,flags:r})=>e.observability.logs({...nl(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 ey("INVALID_ARGS","logs requires path, start, stop, doctor, mark, or clear")}}(t[0]),message:t.slice(1).join(" ")||void 0,restart:r.restart})),[rR]:aE(rR,({client:e,positionals:t,flags:r})=>e.observability.network({...nl(r),action:function(e){if(void 0!==e){if("dump"===e||"log"===e)return e;throw new ey("INVALID_ARGS","network requires dump or log")}}(t[0]),limit:aF(t[1]),include:r.networkInclude??function(e){if(void 0!==e){if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new ey("INVALID_ARGS","network include mode must be summary, headers, body, or all")}}(t[2])})),[rS]:aE(rS,({client:e,positionals:t,flags:r})=>{var n;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,n=r?e[1]:e[0],a=r?2:1,i=e[a];if(void 0===i)return{locator:t,query:aU(n,"find requires query")};if("get"===i){let r=e[a+1];if("text"===r)return{locator:t,query:aU(n,"find requires query"),action:"getText"};if("attrs"===r)return{locator:t,query:aU(n,"find requires query"),action:"getAttrs"};throw new ey("INVALID_ARGS","find get only supports text or attrs")}if("wait"===i)return{locator:t,query:aU(n,"find requires query"),action:"wait",timeoutMs:aF(e[a+1])};if("fill"===i||"type"===i)return{locator:t,query:aU(n,"find requires query"),action:i,value:e.slice(a+1).join(" ")};if("click"===i||"focus"===i||"exists"===i)return{locator:t,query:aU(n,"find requires query"),action:i};throw new ey("INVALID_ARGS",`Unsupported find action: ${i}`)}(t),...{depth:(n=r).snapshotDepth,raw:n.snapshotRaw},...nl(r),first:r.findFirst,last:r.findLast})}),is:aE("is",({client:e,positionals:t,flags:r})=>e.interactions.is({...function(e){let t=e[0],r=E(e.slice(1),{preferTrailingValue:"text"===t});if(!r)throw new ey("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 ey("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text")}(t),...aT(r),...nl(r)})),[rV]:aE(rV,({client:e,positionals:t,flags:r})=>e.settings.update(function(e,t){let r=nl(t),n=e[0],a=e[1];if(("wifi"===n||"airplane"===n||"location"===n)&&("on"===a||"off"===a)||"appearance"===n&&("light"===a||"dark"===a||"toggle"===a)||("faceid"===n||"touchid"===n)&&("match"===a||"nonmatch"===a||"enroll"===a||"unenroll"===a)||"fingerprint"===n&&("match"===a||"nonmatch"===a))return{...r,setting:n,state:a};if("permission"===n&&("grant"===a||"deny"===a||"reset"===a))return{...r,setting:n,state:a,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 ey("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 ey("INVALID_ARGS","settings permission mode must be full or limited.")}(e[3])};throw new ey("INVALID_ARGS","Invalid settings arguments.")}(t,r)))};function aE(e,t){return async({positionals:r,flags:n,client:a})=>{let i=await t({client:a,positionals:r,flags:n}),o=function(e,t,r,n){if(r.json)return e===rH?aM({suite:n,json:!0,reportJunit:r.reportJunit}):(e5({success:!0,data:n}),0);if(e===rH)return aM({suite:n,verbose:r.verbose,reportJunit:r.reportJunit});if(e===rb)return!function(e){let t="number"==typeof e.total?e.total:0,r="number"==typeof e.executed?e.executed:0,n="number"==typeof e.totalDurationMs?e.totalDurationMs:void 0;for(let i of(process.stdout.write(`Batch completed: ${r}/${t} steps${void 0!==n?` in ${n}ms`:""}
58
+ `),Array.isArray(e.results)?e.results:[])){var a;if(!i||"object"!=typeof i)continue;let e="number"==typeof i.step?i.step:void 0,t="string"==typeof i.command?i.command:"step",r=!1!==i.ok,n="number"==typeof i.durationMs?i.durationMs:void 0,o=i.data&&"object"==typeof i.data?i.data:void 0,s=i.error&&"object"==typeof i.error?i.error:void 0,l=r?F(o)??t:(a=s,("string"==typeof a?.message&&a.message.length>0?a.message:null)??t),c=void 0!==e?`${e}. `:"- ",u=void 0!==n?` (${n}ms)`:"";process.stdout.write(`${c}${r?"OK":"FAILED"} ${l}${u}
59
+ `)}}(n),0;if("get"===e){let e=t[0];if("text"===e)return process.stdout.write(`${"string"==typeof n.text?n.text:""}
60
+ `),0;if("attrs"===e)return process.stdout.write(`${JSON.stringify(n.node??{},null,2)}
61
+ `),0}if(e===rS){if("string"==typeof n.text)return process.stdout.write(`${n.text}
62
+ `),0;if("boolean"==typeof n.found)return process.stdout.write(`Found: ${n.found}
63
+ `),0;if(n.node)return process.stdout.write(`${JSON.stringify(n.node,null,2)}
64
+ `),0}if("is"===e)return process.stdout.write(`Passed: is ${n.predicate??"assertion"}
65
+ `),0;if(e===rv){let e=n.platform??"unknown",t=n.device??n.id??"unknown";return process.stdout.write(`Boot ready: ${t} (${e})
66
+ `),0}if(e===rO){let e="string"==typeof n.outPath?n.outPath:"";return e&&process.stdout.write(`${e}
67
+ `),0}if(e===rN)return function(e,t){let r="string"==typeof e.path?e.path:"";if(!r)return;process.stdout.write(`${r}
68
+ `);let n=["active","state","backend","sizeBytes"].map(t=>void 0!==e[t]&&null!==e[t]?`${t}=${e[t]}`:"").filter(Boolean).join(" ");n&&!t.json&&process.stderr.write(`${n}
69
+ `);let a=["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(a&&!t.json&&process.stderr.write(`${a}
69
70
  `),e.hint&&!t.json&&process.stderr.write(`${e.hint}
70
71
  `),Array.isArray(e.notes)&&!t.json)for(let t of e.notes)"string"==typeof t&&t.length>0&&process.stderr.write(`${t}
71
- `)}(a,r),0;if(e===rI)return function(e){let t="string"==typeof e.path?e.path:"";t&&process.stdout.write(`${t}
72
- `);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}`:"",o="string"==typeof e.timestamp?`${e.timestamp} `:"",s="number"==typeof e.durationMs?` durationMs=${e.durationMs}`:"";process.stdout.write(`${o}${t} ${r}${a}${s}
72
+ `)}(n,r),0;if(e===rR)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>",n="number"==typeof e.status?` status=${e.status}`:"",a="string"==typeof e.timestamp?`${e.timestamp} `:"",i="number"==typeof e.durationMs?` durationMs=${e.durationMs}`:"";process.stdout.write(`${a}${t} ${r}${n}${i}
73
74
  `),"string"==typeof e.headers&&process.stdout.write(` headers: ${e.headers}
74
75
  `),"string"==typeof e.requestBody&&process.stdout.write(` request: ${e.requestBody}
75
76
  `),"string"==typeof e.responseBody&&process.stdout.write(` response: ${e.responseBody}
76
- `)}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}
77
+ `)}let n=["active","state","backend","include","scannedLines","matchedLines"].map(t=>void 0!==e[t]&&null!==e[t]?`${t}=${e[t]}`:"").filter(Boolean).join(" ");if(n&&process.stderr.write(`${n}
77
78
  `),Array.isArray(e.notes))for(let t of e.notes)"string"==typeof t&&t.length>0&&process.stderr.write(`${t}
78
- `)}(a),0;if(e===rp||e===rS){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})
79
- `),0}if(e===rA)return process.stdout.write(`${JSON.stringify(a,null,2)}
80
- `),0;let o=U(a);return o&&process.stdout.write(`${o}
81
- `),0}(e,r,a,s);return 0!==n&&process.exit(n),!0}}function aF(e){return{depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}}function aj(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 aV(e,t){if("start"===e||"stop"===e)return e;throw new ef("INVALID_ARGS",`${t} requires start|stop`)}function aG(e,t){if(void 0===e||""===e)throw new ef("INVALID_ARGS",t);return e}function aB(e){return void 0===e?void 0:Number(e)}let aq={...{session:au,[rm]:ac,[ri]:af,"ensure-simulator":ad,metro:am,install:ah,reinstall:ag,"install-from-source":ay,open:aI,close:aA,[rM]:aD,[rP]:aL,[rf]:aE},...{[rF]:async({positionals:e,flags:t,client:r})=>(al(t,await r.command.wait(function(e,t){let r=R(e);if(!r)throw new ef("INVALID_ARGS","wait requires <ms>, text <text>, @ref, or <selector> [timeoutMs].");let a={...an(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 ef("INVALID_ARGS","wait requires text.");return{...a,text:r.text,...aP(r.timeoutMs)}}return"ref"===r.kind?{...a,ref:r.rawRef,...aP(r.timeoutMs)}:{...a,selector:r.selectorExpression,...aP(r.timeoutMs)}}(e,t))),!0),[ro]:async({positionals:e,flags:t,client:r})=>(al(t,await r.command.alert(function(e,t){if(e.length>2)throw new ef("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 ef("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 ef("INVALID_ARGS",`${t} must be a finite number.`)}(e[1],"alert timeout");return{...an(t),...r?{action:r}:{},...void 0!==a?{timeoutMs:a}:{}}}(e,t))),!0),[rs]:async({flags:e,client:t})=>{let r=await t.command.appState(an(e));return ai(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},[rl]:async({flags:e,client:t})=>(al(e,await t.command.back({...an(e),mode:e.backMode})),!0),[rw]:async({flags:e,client:t})=>(al(e,await t.command.home(an(e))),!0),[rL]:async({positionals:e,flags:t,client:r})=>(al(t,await r.command.rotate(function(e,t){if(e.length>1)throw new ef("INVALID_ARGS","rotate accepts exactly one orientation argument.");return{...an(t),orientation:v(e[0])}}(e,t))),!0),[rn]:async({flags:e,client:t})=>(al(e,await t.command.appSwitcher(an(e))),!0),[rb]:async({positionals:e,flags:t,client:r})=>(al(t,await r.command.keyboard(function(e,t){if(e.length>1)throw new ef("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 ef("INVALID_ARGS","keyboard action must be status, get, or dismiss.")}(e[0]);return{...an(t),...r?{action:r}:{}}}(e,t))),!0),[rd]:async({positionals:e,flags:t,client:r})=>{var a,o;return a=t,o=await r.command.clipboard(function(e,t){let r=e[0]?.toLowerCase();if("read"!==r&&"write"!==r)throw new ef("INVALID_ARGS","clipboard requires a subcommand: read or write.");let a=an(t);if("read"===r){if(1!==e.length)throw new ef("INVALID_ARGS","clipboard read does not accept additional arguments.");return{...a,action:r}}if(e.length<2)throw new ef("INVALID_ARGS","clipboard write requires text.");return{...a,action:r,text:e.slice(1).join(" ")}}(e,t)),a.json?ai(a,o):"read"===o.action?process.stdout.write(`${o.text}
82
- `):al(a,o),!0}},...aC};async function aJ(e){let t=aq[e.command];return!!t&&await t(e)}function aH(e,t={}){let r=aK(t),a={...e};return r.defaultPlatform&&void 0===a.platform&&(a.platform=r.defaultPlatform),a}function aK(e){var t,r,a,o;let s,n=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 ef("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(n.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??n.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:i,lockPolicy:(r=e.policyOverrides,a=n,o=l,(s=r?.sessionLock??r?.sessionLockConflicts??az(a.AGENT_DEVICE_SESSION_LOCK)??az(a.AGENT_DEVICE_SESSION_LOCK_CONFLICTS))||(r?.sessionLocked===!0||L(a.AGENT_DEVICE_SESSION_LOCKED)||o?"reject":void 0))}}function az(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new ef("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}let aW={sendToDaemon:tn};async function aX(e,t=aW){let r=B(),a=J(),o=e.includes("--debug")||e.includes("--verbose")||e.includes("-v"),s=e.includes("--json"),n=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 er({session:n,requestId:r,command:e[0],debug:o},async()=>{var n,l,u,c,p,d,m,h,g,y;let w;try{let t,r,a,o,s,y,b,v,k;n={cwd:process.cwd(),env:process.env},t=function(e){let t={json:!1,help:!1,version:!1},r=null,a=[],o=[],s=!0;for(let n=0;n<e.length;n+=1){let i=e[n];if(s&&"--"===i){s=!1;continue}if(!s){r?a.push(i):r=e0(i);continue}let l=i.startsWith("--"),u=i.startsWith("-")&&i.length>1;if(!l&&!u){r?a.push(i):r=e0(i);continue}let[c,p]=l?eY(i):[i,void 0],d=eE.get(c);if(!d){if(function(e,t,r){var a;if(a=r,!/^-\d+(\.\d+)?$/.test(a)||!e)return!1;let o=e_(e);return!o||!!o.allowsExtraPositionals||0!==o.positionalArgs.length&&(t.length<o.positionalArgs.length||o.positionalArgs.some(e=>e.includes("?")))}(r,a,i)){r?a.push(i):r=i;continue}throw new ef("INVALID_ARGS",`Unknown flag: ${c}`)}let m=function(e,t,r,a){if(void 0!==e.setValue){if(void 0!==r)throw new ef("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 ef("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 ef("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:r,consumeNext:!1}}return void 0===a||eQ(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 o=r??a;if(void 0===o||void 0===r&&eQ(o))throw new ef("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:o,consumeNext:void 0===r};if("enum"===e.type){if(!e.enumValues?.includes(o))throw new ef("INVALID_ARGS",`Invalid ${eZ(t)}: ${o}`);return{value:o,consumeNext:void 0===r}}let s=Number(o);if(!Number.isFinite(s)||"number"==typeof e.min&&s<e.min||"number"==typeof e.max&&s>e.max)throw new ef("INVALID_ARGS",`Invalid ${eZ(t)}: ${o}`);return{value:Math.floor(s),consumeNext:void 0===r}}(d,c,p,e[n+1]);m.consumeNext&&(n+=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:c})}return{command:r,positionals:a,flags:t,warnings:[],providedFlags:o}}(e),r=n?.env??process.env,a=n?.cwd??process.cwd(),o=rH({remoteConfig:t.flags.remoteConfig,cwd:a,env:r}),b=eD((s=(l={command:t.command,cwd:a,cliFlags:t.flags,env:r}).env??process.env,y=eD({},function(e){let t={};for(let r of e)eD(t,function(e,t){let r,a;if(!f.existsSync(e)){if(t)throw new ef("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{r=f.readFileSync(e,"utf8")}catch(t){throw new ef("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 ef("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 ef("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let r={};for(let[a,o]of Object.entries(e)){let e=ez.get(a);if(!e)throw new ef("INVALID_ARGS",`Unknown config key "${a}" in ${t}.`);if(!e.config.enabled)throw new ef("INVALID_ARGS",`Unsupported config key "${a}" in ${t}.`);r[a]=eB(eX(e),o,t,a)}return r}(a,`config file ${e}`)}(r.path,r.required));return t}((u=l.cwd,c=l.cliFlags.config,p=s,(k=c??p.AGENT_DEVICE_CONFIG)?[{path:(d=k,m=u,h=p,X(d,{cwd:m,env:h})),required:!0}]:[{path:(g=p,i.join(O("~",{env:g}),".agent-device","config.json")),required:!1},{path:i.resolve(u,"agent-device.json"),required:!1}]))),eD(y,function(e,t){var r,a,o;let s={};for(let n of eK.filter(e=>e.config.enabled&&e.supportsCommand(t))){let t=n.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(s[n.key]=(r=t.value,a=`environment variable ${t.name}`,o=t.name,eB(eX(n),r,a,o)))}return s}(s,l.command))),o),v=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],o=eD({json:!1,help:!1,version:!1},t?.defaultFlags??{});eD(o,e.flags);let s=e_(e.command),n=e.providedFlags.filter(t=>!eW(t.key,e.command));if(n.length>0){var i,l;let t=n.map(e=>e.token),s=(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 ef("INVALID_ARGS",s);for(let e of(a.push(`${s} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),n))delete o[e.key]}for(let t of Object.keys(o))void 0!==o[t]&&(eW(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 ef("INVALID_ARGS","back accepts only one explicit mode flag: use either --in-app or --system.")}(e),s?.defaults)for(let[e,t]of Object.entries(s.defaults))void 0===o[e]&&(o[e]=t);if("batch"===e.command&&1!=+!!o.steps+ +!!o.stepsFile)throw new ef("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:o,warnings:a})}(t,{strictFlags:n?.strictFlags,defaultFlags:b}),"open"===t.command&&t.flags.remoteConfig&&function(e,t){for(let[r,a]of Object.entries(t))void 0!==a&&void 0===e[r]&&(e[r]=a)}(v.flags,function(e){let t={};for(let r of rJ){let a=e[r];void 0!==a&&(t[r]=a)}return t}(b)),w=v}catch(t){Z({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=em(t,{diagnosticId:z().diagnosticId,logPath:eo({force:!0})??void 0});s?e1({success:!1,error:e}):e2(e,{showDetails:o}),process.exit(1);return}for(let e of w.warnings)process.stderr.write(`Warning: ${e}
83
- `);w.flags.version&&(process.stdout.write(`${a}
84
- `),process.exit(0));let b="help"===w.command,v=w.flags.help;if(b||v){b&&w.positionals.length>1&&(e2(new ef("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=b?w.positionals[0]:w.command;e||(process.stdout.write(`${eR}
85
- `),process.exit(0));let t=function(e){var t,r;let a=e_(e);if(!a)return null;let o=(t=e,(r=a).usageOverride?r.usageOverride:[t,...r.positionalArgs.map(eT),...r.allowedFlags.flatMap(e=>(eP.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")),s=eO(new Set(a.allowedFlags)),n=eO(ex),i=[];return s.length>0&&i.push(eC("Command flags:",s)),i.push(eC("Global flags:",n)),`agent-device ${o}
79
+ `)}(n),0;if(e===rk||e===rT){let e=n.ref??"",t=n.x,r=n.y;if(e&&"number"==typeof t&&"number"==typeof r)return process.stdout.write(`Tapped @${e} (${t}, ${r})
80
+ `),0}if(e===r_)return process.stdout.write(`${JSON.stringify(n,null,2)}
81
+ `),0;let a=F(n);return a&&process.stdout.write(`${a}
82
+ `),0}(e,r,n,i);return 0!==o&&process.exit(o),!0}}function aT(e){return{depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}}function aC(e){if(e[0]?.startsWith("@"))return{ref:e[0],label:e.slice(1).join(" ")||void 0};let t=E(e);return t?{selector:t.selectorExpression}:{x:Number(e[0]),y:Number(e[1])}}function aO(e,t){if("start"===e||"stop"===e)return e;throw new ey("INVALID_ARGS",`${t} requires start|stop`)}function aU(e,t){if(void 0===e||""===e)throw new ey("INVALID_ARGS",t);return e}function aF(e){return void 0===e?void 0:Number(e)}let aj={...{session:nd,[rI]:np,[ry]:ng,"ensure-simulator":nf,metro:nh,install:ny,reinstall:nw,"install-from-source":nb,connect:nO,disconnect:nU,connection:nF,open:nx,close:nI,[rG]:nK,[rB]:aA,[rA]:aD},...{[rJ]:async({positionals:e,flags:t,client:r})=>(nu(t,await r.command.wait(function(e,t){let r=C(e);if(!r)throw new ey("INVALID_ARGS","wait requires <ms>, text <text>, @ref, or <selector> [timeoutMs].");let n={...nl(t),depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw};if("sleep"===r.kind)return{...n,durationMs:r.durationMs};if("text"===r.kind){if(!r.text)throw new ey("INVALID_ARGS","wait requires text.");return{...n,text:r.text,...a$(r.timeoutMs)}}return"ref"===r.kind?{...n,ref:r.rawRef,...a$(r.timeoutMs)}:{...n,selector:r.selectorExpression,...a$(r.timeoutMs)}}(e,t))),!0),[rf]:async({positionals:e,flags:t,client:r})=>(nu(t,await r.command.alert(function(e,t){if(e.length>2)throw new ey("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 ey("INVALID_ARGS","alert action must be get, accept, dismiss, or wait.")}(e[0]),n=function(e,t){if(void 0===e)return;let r=Number(e);if(Number.isFinite(r))return r;throw new ey("INVALID_ARGS",`${t} must be a finite number.`)}(e[1],"alert timeout");return{...nl(t),...r?{action:r}:{},...void 0!==n?{timeoutMs:n}:{}}}(e,t))),!0),[rh]:async({flags:e,client:t})=>{let r=await t.command.appState(nl(e));return nc(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},[rw]:async({flags:e,client:t})=>(nu(e,await t.command.back({...nl(e),mode:e.backMode})),!0),[rM]:async({flags:e,client:t})=>(nu(e,await t.command.home(nl(e))),!0),[rF]:async({positionals:e,flags:t,client:r})=>(nu(t,await r.command.rotate(function(e,t){if(e.length>1)throw new ey("INVALID_ARGS","rotate accepts exactly one orientation argument.");return{...nl(t),orientation:k(e[0])}}(e,t))),!0),[rg]:async({flags:e,client:t})=>(nu(e,await t.command.appSwitcher(nl(e))),!0),[rP]:async({positionals:e,flags:t,client:r})=>(nu(t,await r.command.keyboard(function(e,t){if(e.length>1)throw new ey("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 ey("INVALID_ARGS","keyboard action must be status, get, or dismiss.")}(e[0]);return{...nl(t),...r?{action:r}:{}}}(e,t))),!0),[rx]:async({positionals:e,flags:t,client:r})=>{var n,a;return n=t,a=await r.command.clipboard(function(e,t){let r=e[0]?.toLowerCase();if("read"!==r&&"write"!==r)throw new ey("INVALID_ARGS","clipboard requires a subcommand: read or write.");let n=nl(t);if("read"===r){if(1!==e.length)throw new ey("INVALID_ARGS","clipboard read does not accept additional arguments.");return{...n,action:r}}if(e.length<2)throw new ey("INVALID_ARGS","clipboard write requires text.");return{...n,action:r,text:e.slice(1).join(" ")}}(e,t)),n.json?nc(n,a):"read"===a.action?process.stdout.write(`${a.text}
83
+ `):nu(n,a),!0}},...a_};async function aB(e){let t=aj[e.command];return!!t&&await t(e)}function aV(e,t={}){let r=aG(t),n={...e};return r.defaultPlatform&&void 0===n.platform&&(n.platform=r.defaultPlatform),n}function aG(e){var t,r,n,a;let i,o=e.env??process.env,s=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 ey("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(o.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??o.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:s,lockPolicy:(r=e.policyOverrides,n=o,a=l,(i=r?.sessionLock??r?.sessionLockConflicts??aq(n.AGENT_DEVICE_SESSION_LOCK)??aq(n.AGENT_DEVICE_SESSION_LOCK_CONFLICTS))||(r?.sessionLocked===!0||N(n.AGENT_DEVICE_SESSION_LOCKED)||a?"reject":void 0))}}function aq(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new ey("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}let aH=nD.map(e=>e.key),aK={sendToDaemon:tg};async function aX(e,t=aK){let r=q(),n=K(),a=e.includes("--debug")||e.includes("--verbose")||e.includes("-v"),i=e.includes("--json"),o=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 en({session:o,requestId:r,command:e[0],debug:a},async()=>{var o,l,c,u,d,p,m,h,g,y,w,b,v;let k,x,I,A,D,S,$;try{let t,r,n,a,i,b,v,x;o={cwd:process.cwd(),env:process.env},t=function(e){let t={json:!1,help:!1,version:!1},r=null,n=[],a=[],i=!0;for(let o=0;o<e.length;o+=1){let s=e[o];if(i&&"--"===s){i=!1;continue}if(!i){r?n.push(s):r=e3(s);continue}let l=s.startsWith("--"),c=s.startsWith("-")&&s.length>1;if(!l&&!c){r?n.push(s):r=e3(s);continue}let[u,d]=l?e0(s):[s,void 0],p=e_.get(u);if(!p){if(function(e,t,r){var n;if(n=r,!/^-\d+(\.\d+)?$/.test(n)||!e)return!1;let a=eT(e);return!a||!!a.allowsExtraPositionals||0!==a.positionalArgs.length&&(t.length<a.positionalArgs.length||a.positionalArgs.some(e=>e.includes("?")))}(r,n,s)){r?n.push(s):r=s;continue}throw new ey("INVALID_ARGS",`Unknown flag: ${u}`)}let m=function(e,t,r,n){if(void 0!==e.setValue){if(void 0!==r)throw new ey("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 ey("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 ey("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:r,consumeNext:!1}}return void 0===n||e2(n)||!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("\\"))}(n)?{value:!0,consumeNext:!1}:{value:n,consumeNext:!0}}let a=r??n;if(void 0===a||void 0===r&&e2(a))throw new ey("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:a,consumeNext:void 0===r};if("enum"===e.type){if(!e.enumValues?.includes(a))throw new ey("INVALID_ARGS",`Invalid ${e1(t)}: ${a}`);return{value:a,consumeNext:void 0===r}}let i=Number(a);if(!Number.isFinite(i)||"number"==typeof e.min&&i<e.min||"number"==typeof e.max&&i>e.max)throw new ey("INVALID_ARGS",`Invalid ${e1(t)}: ${a}`);return{value:Math.floor(i),consumeNext:void 0===r}}(p,u,d,e[o+1]);m.consumeNext&&(o+=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;a.push({key:p.key,token:u})}return{command:r,positionals:n,flags:t,warnings:[],providedFlags:a}}(e),r=o?.env??process.env,n=o?.cwd??process.cwd(),u=t.command,a=("connect"===u||"metro"===u)&&(l={remoteConfig:t.flags.remoteConfig,cwd:n,env:r}).remoteConfig?{...function(e){let t={};for(let r of aH){let n=e[r];void 0!==n&&(t[r]=n)}return t}(n$({configPath:l.remoteConfig,cwd:l.cwd,env:l.env}).profile),remoteConfig:l.remoteConfig}:{},v=e$((i=(c={command:t.command,cwd:n,cliFlags:t.flags,env:r}).env??process.env,b=e$({},function(e){let t={};for(let r of e)e$(t,function(e,t){let r,n;if(!f.existsSync(e)){if(t)throw new ey("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{r=f.readFileSync(e,"utf8")}catch(t){throw new ey("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{n=JSON.parse(r)}catch(t){throw new ey("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!n||"object"!=typeof n||Array.isArray(n))throw new ey("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let r={};for(let[n,a]of Object.entries(e)){let e=eW.get(n);if(!e)throw new ey("INVALID_ARGS",`Unknown config key "${n}" in ${t}.`);if(!e.config.enabled)throw new ey("INVALID_ARGS",`Unsupported config key "${n}" in ${t}.`);r[n]=eK(eQ(e),a,t,n)}return r}(n,`config file ${e}`)}(r.path,r.required));return t}((d=c.cwd,p=c.cliFlags.config,m=i,(x=p??m.AGENT_DEVICE_CONFIG)?[{path:(h=x,g=d,y=m,W(h,{cwd:g,env:y})),required:!0}]:[{path:(w=m,s.join(O("~",{env:w}),".agent-device","config.json")),required:!1},{path:s.resolve(d,"agent-device.json"),required:!1}]))),e$(b,function(e,t){var r,n,a;let i={};for(let o of ez.filter(e=>e.config.enabled&&e.supportsCommand(t))){let t=o.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(i[o.key]=(r=t.value,n=`environment variable ${t.name}`,a=t.name,eK(eQ(o),r,n,a)))}return i}(i,c.command))),a),k={...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),n=[...e.warnings],a=e$({json:!1,help:!1,version:!1},t?.defaultFlags??{});e$(a,e.flags);let i=eT(e.command),o=e.providedFlags.filter(t=>!eZ(t.key,e.command));if(o.length>0){var s,l;let t=o.map(e=>e.token),i=(s=e.command,l=t,s?1===l.length?`Flag ${l[0]} is not supported for command ${s}.`:`Flags ${l.join(", ")} are not supported for command ${s}.`: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 ey("INVALID_ARGS",i);for(let e of(n.push(`${i} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),o))delete a[e.key]}for(let t of Object.keys(a))void 0!==a[t]&&(eZ(t,e.command)||delete a[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 ey("INVALID_ARGS","back accepts only one explicit mode flag: use either --in-app or --system.")}(e),i?.defaults)for(let[e,t]of Object.entries(i.defaults))void 0===a[e]&&(a[e]=t);if("batch"===e.command&&1!=+!!a.steps+ +!!a.stepsFile)throw new ey("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:a,warnings:n})}(t,{strictFlags:o?.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=eh(t,{diagnosticId:J().diagnosticId,logPath:ei({force:!0})??void 0});i?e5({success:!1,error:e}):e8(e,{showDetails:a}),process.exit(1);return}for(let e of k.warnings)process.stderr.write(`Warning: ${e}
84
+ `);k.flags.version&&(process.stdout.write(`${n}
85
+ `),process.exit(0));let N="help"===k.command,R=k.flags.help;if(N||R){N&&k.positionals.length>1&&(e8(new ey("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=N?k.positionals[0]:k.command;e||(process.stdout.write(`${eU}
86
+ `),process.exit(0));let t=function(e){var t,r;let n=eT(e);if(!n)return null;let a=(t=e,(r=n).usageOverride?r.usageOverride:[t,...r.positionalArgs.map(eO),...r.allowedFlags.flatMap(e=>(eE.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")),i=eF(new Set(n.allowedFlags)),o=eF(eL),s=[];return i.length>0&&s.push(ej("Command flags:",i)),s.push(ej("Global flags:",o)),`agent-device ${a}
86
87
 
87
- ${a.helpDescription}
88
+ ${n.helpDescription}
88
89
 
89
90
  Usage:
90
- agent-device ${o}
91
+ agent-device ${a}
91
92
 
92
- ${i.join("\n\n")}
93
- `}(e0(e));t&&(process.stdout.write(t),process.exit(0)),e2(new ef("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${eR}
94
- `),process.exit(1)}w.command||(process.stdout.write(`${eR}
95
- `),process.exit(1));let{command:k,positionals:I}=w,A=aK({policyOverrides:w.flags,configuredPlatform:w.flags.platform,configuredSession:w.flags.session}),D=A.lockPolicy?{...w.flags}:aH(w.flags,{policyOverrides:w.flags,configuredPlatform:w.flags.platform,configuredSession:w.flags.session}),S=ea(D.stateDir),$=D.session??"default";eA({command:k,currentVersion:a,stateDir:S.baseDir,flags:D});let L=D.daemonBaseUrl,P=!D.verbose||D.json||L?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}}(S.logPath),_=function(e={},t={}){var r;let a,o=t.transport??tn,s=as(e),n=async(t,r=[],a={})=>{let n=ao(e,s,a),i=await o({session:ae(n.session),command:t,positionals:r,flags:r4({stateDir:n.stateDir,daemonBaseUrl:n.daemonBaseUrl,daemonAuthToken:n.daemonAuthToken,daemonTransport:n.daemonTransport,daemonServerMode:n.daemonServerMode,tenant:n.tenant,sessionIsolation:n.sessionIsolation,runId:n.runId,leaseId:n.leaseId,platform:n.platform,target:n.target,device:n.device,udid:n.udid,serial:n.serial,iosSimulatorDeviceSet:n.iosSimulatorDeviceSet,androidDeviceAllowlist:n.androidDeviceAllowlist,runtime:n.simulatorRuntimeId,boot:n.boot,reuseExisting:n.reuseExisting,surface:n.surface,activity:n.activity,relaunch:n.relaunch,shutdown:n.shutdown,saveScript:n.saveScript,noRecord:n.noRecord,backMode:n.backMode,metroHost:n.metroHost,metroPort:n.metroPort,bundleUrl:n.bundleUrl,launchUrl:n.launchUrl,snapshotInteractiveOnly:n.interactiveOnly,snapshotCompact:n.compact,snapshotDepth:n.depth,snapshotScope:n.scope,snapshotRaw:n.raw,screenshotFullscreen:n.screenshotFullscreen,overlayRefs:n.overlayRefs,appsFilter:n.appsFilter,out:n.out,count:n.count,fps:n.fps,hideTouches:n.hideTouches,intervalMs:n.intervalMs,delayMs:n.delayMs,holdMs:n.holdMs,jitterPx:n.jitterPx,pixels:n.pixels,doubleTap:n.doubleTap,clickButton:n.clickButton,pauseMs:n.pauseMs,pattern:n.pattern,headless:n.headless,restart:n.restart,replayUpdate:n.replayUpdate,failFast:n.failFast,timeoutMs:n.timeoutMs,retries:n.retries,artifactsDir:n.artifactsDir,reportJunit:n.reportJunit,findFirst:n.findFirst,findLast:n.findLast,networkInclude:n.networkInclude,batchOnError:n.batchOnError,batchMaxSteps:n.batchMaxSteps,batchSteps:n.batchSteps,verbose:n.debug}),runtime:n.runtime,meta:r4({requestId:n.requestId,cwd:n.cwd,debug:n.debug,lockPolicy:n.lockPolicy,lockPlatform:n.lockPlatform,tenantId:n.tenant,runId:n.runId,leaseId:n.leaseId,sessionIsolation:n.sessionIsolation,installSource:n.installSource,retainMaterializedPaths:n.retainMaterializedPaths,materializedPathRetentionMs:n.materializedPathRetentionMs,materializationId:n.materializationId})});return i.ok||function(e){throw new ef(e.code,e.message,{...e.details??{},hint:e.hint,diagnosticId:e.diagnosticId,logPath:e.logPath})}(i.error),i.data??{}},i=async(e={})=>{let t=await n("session_list",[],e);return(Array.isArray(t.sessions)?t.sessions:[]).map(r9)},l=async(e,t=[],r={})=>await n(e,t,r),u=(t={})=>ae(ao(e,s,t).session);return{command:(r=async e=>await n(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 ef("INVALID_ARGS","wait command requires exactly one of durationMs, text, ref, or selector.");if(void 0!==e.durationMs)return{command:rF,positionals:[String(e.durationMs)],options:e};let t=void 0!==e.timeoutMs?[String(e.timeoutMs)]:[];if(void 0!==e.text)return{command:rF,positionals:["text",e.text,...t],options:e};if(void 0!==e.ref)return{command:rF,positionals:[e.ref,...t],options:e};let r=e.selector;return function(e){if(!q(e))throw new ef("INVALID_ARGS",`Invalid wait selector: ${e}`)}(r),{command:rF,positionals:[r,...t],options:e}}(e)),alert:async(e={})=>{var t;return await a({command:ro,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:rl,positionals:[],options:{...e,backMode:e.mode}}),home:async(e={})=>await a({command:rw,positionals:[],options:e}),rotate:async e=>await a({command:rL,positionals:[e.orientation],options:e}),appSwitcher:async(e={})=>await a({command:rn,positionals:[],options:e}),keyboard:async(e={})=>await a({command:rb,positionals:e.action?[e.action]:[],options:e}),clipboard:async e=>{var t;return await a("read"===(t=e).action?{command:rd,positionals:["read"],options:t}:{command:rd,positionals:["write",t.text],options:t})}}),devices:{list:async(e={})=>{let t=await n(rm,[],e);return(Array.isArray(t.devices)?t.devices:[]).map(r7)},boot:async(e={})=>await l(rc,[],e)},sessions:{list:async(e={})=>await i(e),close:async(e={})=>{let t=u(e),r=(await n("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 n("ensure-simulator",[],{...r,simulatorRuntimeId:t}),o=rz(a,"udid"),s=rz(a,"device");return{udid:o,device:s,runtime:rz(a,"runtime"),created:!0===a.created,booted:!0===a.booted,iosSimulatorDeviceSet:rX(a,"ios_simulator_device_set"),identifiers:{deviceId:o,deviceName:s,udid:o}}}},apps:{install:async e=>r6(await n("install",[e.app,e.appPath],e),u(e)),reinstall:async e=>r6(await n("reinstall",[e.app,e.appPath],e),u(e)),installFromSource:async e=>(function(e,t){let r=rW(e,"bundleId"),a=rW(e,"packageName"),o=r??a??rW(e,"appId"),s=rW(e,"launchTarget")??a??r??o;if(!s)throw new ef("COMMAND_FAILED",'Daemon response is missing "launchTarget".',{response:e});return{appName:rW(e,"appName"),appId:o,bundleId:r,packageName:a,launchTarget:s,installablePath:rW(e,"installablePath"),archivePath:rW(e,"archivePath"),materializationId:rW(e,"materializationId"),materializationExpiresAt:rW(e,"materializationExpiresAt"),identifiers:x({session:t,bundleId:r,packageName:a,appId:o})}})(await n("install_source",[],{...e,installSource:e.source,retainMaterializedPaths:e.retainPaths,materializedPathRetentionMs:e.retentionMs}),u(e)),list:async(e={})=>{let t=await n(ri,[],e);return Array.isArray(t.apps)?t.apps.filter(e=>"string"==typeof e):[]},open:async e=>{let t=u(e),r=e.app?e.url?[e.app,e.url]:[e.app]:[],a=await n("open",r,e),o=function(e){let t=e.platform,r=rW(e,"id"),a=rW(e,"device");if("ios"!==t&&"macos"!==t&&"android"!==t||!r||!a)return;let o=rZ(e,"target"),s=N(t,r,a);return{platform:t,target:o,id:r,name:a,identifiers:s,ios:"ios"===t?{udid:rW(e,"device_udid")??r,simulatorSetPath:rX(e,"ios_simulator_device_set")}:void 0,android:"android"===t?{serial:rW(e,"serial")??r}:void 0}}(a),s=rW(a,"appBundleId");return{session:t,appName:rW(a,"appName"),appBundleId:s,appId:s,startup:function(e){if(r8(e)&&"number"==typeof e.durationMs&&"string"==typeof e.measuredAt&&"string"==typeof e.method)return{durationMs:e.durationMs,measuredAt:e.measuredAt,method:e.method,appTarget:rW(e,"appTarget"),appBundleId:rW(e,"appBundleId")}}(a.startup),runtime:function(e){if(!r8(e))return;let t=e.platform,r=rW(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:rW(e,"bundleUrl"),launchUrl:rW(e,"launchUrl")}}(a.runtime),device:o,identifiers:{session:t,deviceId:o?.id,deviceName:o?.name,udid:o?.ios?.udid,serial:o?.android?.serial,appId:s,appBundleId:s}}},close:async(e={})=>{let t=u(e),r=(await n("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 l(r$,[e.app,"string"==typeof(t=e.payload)?t:JSON.stringify(t)],e)},triggerEvent:async e=>{var t;return await l(rC,[(t=e).event,...t.payload?[JSON.stringify(t.payload)]:[]],e)}},materializations:{release:async e=>{var t;return{released:!0===(t=await n("release_materialized_paths",[],{...e,materializationId:e.materializationId})).released,materializationId:rz(t,"materializationId"),identifiers:{}}}},metro:{prepare:async t=>await ra({projectRoot:t.projectRoot??e.cwd,kind:t.kind,publicBaseUrl:t.publicBaseUrl,proxyBaseUrl:t.proxyBaseUrl,proxyBearerToken:t.bearerToken,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=u(e),a=await n(rM,[],e),o=rW(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:rW(a,"appName"),appBundleId:o,...s?{visibility:s}:{},warnings:Array.isArray(a.warnings)?a.warnings.filter(e=>"string"==typeof e):void 0,identifiers:{session:r,appId:o,appBundleId:o}}},screenshot:async(e={})=>{let t=u(e),r=await n(rP,e.path?[e.path]:[],{...e,screenshotFullscreen:e.fullscreen});return{path:rz(r,"path"),overlayRefs:function(e){let t=e.overlayRefs;if(!Array.isArray(t))return;let r=[];for(let e of t){if(!r8(e))continue;let t=rW(e,"ref"),a=rQ(e,"rect"),o=rQ(e,"overlayRect"),s=function(e,t){let r=e[t];if(!r8(r))return;let a="number"==typeof r.x?r.x:void 0,o="number"==typeof r.y?r.y:void 0;if(void 0!==a&&void 0!==o)return{x:a,y:o}}(e,"center");t&&a&&o&&s&&r.push({ref:t,label:rW(e,"label"),rect:a,overlayRect:o,center:s})}return r}(r),identifiers:{session:t}}},diff:async e=>await l(rf,[e.kind],{...e,interactiveOnly:e.interactiveOnly,compact:e.compact,depth:e.depth,scope:e.scope,raw:e.raw})},interactions:{click:async e=>await l(rp,at(e),{...e,clickButton:e.button}),press:async e=>await l(rS,at(e),e),longPress:async e=>await l(rk,[String(e.x),String(e.y),...aa(e.durationMs)],e),swipe:async e=>await l(rT,[String(e.from.x),String(e.from.y),String(e.to.x),String(e.to.y),...aa(e.durationMs)],e),focus:async e=>await l(ry,[String(e.x),String(e.y)],e),type:async e=>await l(rU,[e.text],e),fill:async e=>await l(rh,[...at(e),e.text],e),scroll:async e=>await l(rE,[e.direction,...aa(e.amount)],e),pinch:async e=>await l(rD,[String(e.scale),...aa(e.x),...aa(e.y)],e),get:async e=>{var t;return await l("get",[e.format,...void 0!==(t=e).ref?[t.ref,...ar(t.label)]:[t.selector]],e)},is:async e=>await l("is",[e.predicate,e.selector,..."text"===e.predicate?[e.value]:[]],e),find:async e=>await l(rg,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",...aa(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 l(rx,[e.path],{...e,replayUpdate:e.update}),test:async e=>await l(rR,e.paths,{...e,replayUpdate:e.update})},batch:{run:async e=>await l(ru,[],{...e,batchSteps:e.steps,batchOnError:e.onError,batchMaxSteps:e.maxSteps})},observability:{perf:async(e={})=>await l(rA,[],e),logs:async(e={})=>{var t;return await l(rv,[(t=e).action??"path",...ar(t.message)],e)},network:async(e={})=>{var t;return await l(rI,[...(t=e).action?[t.action]:[],...aa(t.limit)],{...e,networkInclude:e.include})}},recording:{record:async e=>await l(rN,[e.action,...ar(e.path)],e),trace:async e=>await l(rO,[e.action,...ar(e.path)],e)},settings:{update:async e=>await l(r_,[e.setting,e.state,..."permission"in e?[e.permission]:[],..."mode"in e&&e.mode?[e.mode]:[]],e)}}}({session:$,requestId:r,stateDir:D.stateDir,daemonBaseUrl:D.daemonBaseUrl,daemonAuthToken:D.daemonAuthToken,daemonTransport:D.daemonTransport,daemonServerMode:D.daemonServerMode,remoteConfig:D.remoteConfig,tenant:D.tenant,sessionIsolation:D.sessionIsolation,runId:D.runId,leaseId:D.leaseId,lockPolicy:A.lockPolicy,lockPlatform:A.defaultPlatform,cwd:process.cwd(),debug:!!D.verbose},{transport:t.sendToDaemon});try{if("batch"===k){if(I.length>0)throw new ef("INVALID_ARGS","batch does not accept positional arguments.");let 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 ef("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return E(t)})(D).map((e,t)=>({...e,flags:A.lockPolicy&&void 0===D.platform?{...e.flags??{}}:aH(e.flags??{},{policyOverrides:D,configuredPlatform:D.platform,configuredSession:D.session,inheritedPlatform:D.platform})}));if(await aJ({command:k,positionals:I,flags:{...D,batchSteps:e},client:_}))return}else if("runtime"===k)throw new ef("INVALID_ARGS","runtime command was removed. Use open --remote-config <path> --relaunch for remote Metro launches, or metro prepare --remote-config <path> for inspection.");else if(await aJ({command:k,positionals:I,flags:D,client:_}))return;throw new ef("INVALID_ARGS",`Unknown command: ${k}`)}catch(r){let e=ed(r),t=em(e,{diagnosticId:z().diagnosticId,logPath:eo({force:!0})??void 0});if("close"===k&&"COMMAND_FAILED"===(y=e).code&&(y.details?.kind==="daemon_startup_failed"||y.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof y.details?.infoPath||"string"==typeof y.details?.lockPath))){D.json&&e1({success:!0,data:{closed:"session",source:"no-daemon"}});return}if(D.json)e1({success:!1,error:t});else if(e2(t,{showDetails:D.verbose}),D.verbose)try{let e=S.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(`
93
+ ${s.join("\n\n")}
94
+ `}(e3(e));t&&(process.stdout.write(t),process.exit(0)),e8(new ey("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${eU}
95
+ `),process.exit(1)}k.command||(process.stdout.write(`${eU}
96
+ `),process.exit(1));let{command:_,positionals:E}=k,T=new Set(k.providedFlags.map(e=>e.key));try{if(k.flags.remoteConfig&&"connect"!==_&&"metro"!==_)throw new ey("INVALID_ARGS","--remote-config is only supported by connect and metro prepare. Run agent-device connect first, then use normal commands.");I=(x=aG({policyOverrides:k.flags,configuredPlatform:k.flags.platform,configuredSession:k.flags.session})).lockPolicy?{...k.flags}:aV(k.flags,{policyOverrides:k.flags,configuredPlatform:k.flags.platform,configuredSession:k.flags.session}),A=ea(I.stateDir),D=I.session??"default",b={command:_,explicitFlagKeys:T,stateDir:A.baseDir,session:D},$=(S="connect"===b.command||"connection"===b.command||b.explicitFlagKeys.has("remoteConfig")?null:function(e){let t=e.validateRemoteConfigHash??!0,r=nM(e)??(e.allowActiveFallback?n_({stateDir:e.stateDir}):null);if(!r)return null;if(t&&nN(r.remoteConfigPath)!==r.remoteConfigHash)throw new ey("INVALID_ARGS","Active remote connection config changed. Run agent-device connect --force to refresh it.",{remoteConfig:r.remoteConfigPath});let n=function(e,t){try{return n$({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:{...n,remoteConfig:r.remoteConfigPath,daemonBaseUrl:r.daemon?.baseUrl??n.daemonBaseUrl,daemonTransport:r.daemon?.transport??n.daemonTransport,daemonServerMode:r.daemon?.serverMode??n.daemonServerMode,tenant:r.tenant,sessionIsolation:"tenant",runId:r.runId,leaseId:r.leaseId,leaseBackend:r.leaseBackend,session:r.session,platform:r.platform??n.platform,target:r.target??n.target}}}({stateDir:b.stateDir,session:b.session,cwd:process.cwd(),env:process.env,allowActiveFallback:!b.explicitFlagKeys.has("session"),validateRemoteConfigHash:"disconnect"!==b.command}))?function(e,t,r){let n={...e};for(let[e,a]of Object.entries(t))void 0!==a&&(r.has(e)||(n[e]=a));return n}(I,S.flags,T):I}catch(t){let e=eh(ef(t),{diagnosticId:J().diagnosticId,logPath:ei({force:!0})??void 0});k.flags.json?e5({success:!1,error:e}):e8(e,{showDetails:k.flags.verbose}),process.exit(1);return}eS({command:_,currentVersion:n,stateDir:A.baseDir,flags:$});let C=$.daemonBaseUrl,U=!$.verbose||$.json||C?null:function(e){try{let t=0,r=!1,n=setInterval(()=>{if(!r&&f.existsSync(e))try{let r=f.statSync(e);if(r.size<t&&(t=0),r.size<=t)return;let n=f.openSync(e,"r");try{let e=Buffer.alloc(r.size-t);f.readSync(n,e,0,e.length,t),t=r.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{f.closeSync(n)}}catch{}},200);return()=>{r=!0,clearInterval(n)}}catch{return null}}(A.logPath),F=function(e={},t={}){var r;let n,a=t.transport??tg,i=async(t,r=[],n={})=>{var i,o;let s=(i=e,o=n,{...i,...o}),l=await a({session:nn(s.session),command:t,positionals:r,flags:r9({stateDir:s.stateDir,daemonBaseUrl:s.daemonBaseUrl,daemonAuthToken:s.daemonAuthToken,daemonTransport:s.daemonTransport,daemonServerMode:s.daemonServerMode,tenant:s.tenant,sessionIsolation:s.sessionIsolation,runId:s.runId,leaseId:s.leaseId,leaseBackend:s.leaseBackend,platform:s.platform,target:s.target,device:s.device,udid:s.udid,serial:s.serial,iosSimulatorDeviceSet:s.iosSimulatorDeviceSet,androidDeviceAllowlist:s.androidDeviceAllowlist,runtime:s.simulatorRuntimeId,boot:s.boot,reuseExisting:s.reuseExisting,surface:s.surface,activity:s.activity,relaunch:s.relaunch,shutdown:s.shutdown,saveScript:s.saveScript,noRecord:s.noRecord,backMode:s.backMode,metroHost:s.metroHost,metroPort:s.metroPort,bundleUrl:s.bundleUrl,launchUrl:s.launchUrl,snapshotInteractiveOnly:s.interactiveOnly,snapshotCompact:s.compact,snapshotDepth:s.depth,snapshotScope:s.scope,snapshotRaw:s.raw,screenshotFullscreen:s.screenshotFullscreen,overlayRefs:s.overlayRefs,appsFilter:s.appsFilter,out:s.out,count:s.count,fps:s.fps,hideTouches:s.hideTouches,intervalMs:s.intervalMs,delayMs:s.delayMs,holdMs:s.holdMs,jitterPx:s.jitterPx,pixels:s.pixels,doubleTap:s.doubleTap,clickButton:s.clickButton,pauseMs:s.pauseMs,pattern:s.pattern,headless:s.headless,restart:s.restart,replayUpdate:s.replayUpdate,failFast:s.failFast,timeoutMs:s.timeoutMs,retries:s.retries,artifactsDir:s.artifactsDir,reportJunit:s.reportJunit,findFirst:s.findFirst,findLast:s.findLast,networkInclude:s.networkInclude,batchOnError:s.batchOnError,batchMaxSteps:s.batchMaxSteps,batchSteps:s.batchSteps,verbose:s.debug}),runtime:s.runtime,meta:r9({requestId:s.requestId,cwd:s.cwd,debug:s.debug,lockPolicy:s.lockPolicy,lockPlatform:s.lockPlatform,tenantId:s.tenant,runId:s.runId,leaseId:s.leaseId,leaseBackend:s.leaseBackend,leaseTtlMs:s.leaseTtlMs,sessionIsolation:s.sessionIsolation,installSource:s.installSource,retainMaterializedPaths:s.retainMaterializedPaths,materializedPathRetentionMs:s.materializedPathRetentionMs,materializationId:s.materializationId})});return l.ok||function(e){throw new ey(e.code,e.message,{...e.details??{},hint:e.hint,diagnosticId:e.diagnosticId,logPath:e.logPath})}(l.error),l.data??{}},o=async(e={})=>{let t=await i("session_list",[],e);return(Array.isArray(t.sessions)?t.sessions:[]).map(nr)},s=async(e,t=[],r={})=>await i(e,t,r),l=(t={})=>{var r,n;return nn((r=e,n=t,{...r,...n}).session)};return{command:(r=async e=>await i(e.command,e.positionals,e.options),n=async e=>await r(e),{wait:async e=>await n(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 ey("INVALID_ARGS","wait command requires exactly one of durationMs, text, ref, or selector.");if(void 0!==e.durationMs)return{command:rJ,positionals:[String(e.durationMs)],options:e};let t=void 0!==e.timeoutMs?[String(e.timeoutMs)]:[];if(void 0!==e.text)return{command:rJ,positionals:["text",e.text,...t],options:e};if(void 0!==e.ref)return{command:rJ,positionals:[e.ref,...t],options:e};let r=e.selector;return function(e){if(!H(e))throw new ey("INVALID_ARGS",`Invalid wait selector: ${e}`)}(r),{command:rJ,positionals:[r,...t],options:e}}(e)),alert:async(e={})=>{var t;return await n({command:rf,positionals:[(t=e).action??"get",...void 0!==t.timeoutMs?[String(t.timeoutMs)]:[]],options:t})},appState:async(e={})=>await n({command:rh,positionals:[],options:e}),back:async(e={})=>await n({command:rw,positionals:[],options:{...e,backMode:e.mode}}),home:async(e={})=>await n({command:rM,positionals:[],options:e}),rotate:async e=>await n({command:rF,positionals:[e.orientation],options:e}),appSwitcher:async(e={})=>await n({command:rg,positionals:[],options:e}),keyboard:async(e={})=>await n({command:rP,positionals:e.action?[e.action]:[],options:e}),clipboard:async e=>{var t;return await n("read"===(t=e).action?{command:rx,positionals:["read"],options:t}:{command:rx,positionals:["write",t.text],options:t})}}),devices:{list:async(e={})=>{let t=await i(rI,[],e);return(Array.isArray(t.devices)?t.devices:[]).map(nt)},boot:async(e={})=>await s(rv,[],e)},sessions:{list:async(e={})=>await o(e),close:async(e={})=>{let t=l(e),r=(await i("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,n=await i("ensure-simulator",[],{...r,simulatorRuntimeId:t}),a=rW(n,"udid"),o=rW(n,"device");return{udid:a,device:o,runtime:rW(n,"runtime"),created:!0===n.created,booted:!0===n.booted,iosSimulatorDeviceSet:rQ(n,"ios_simulator_device_set"),identifiers:{deviceId:a,deviceName:o,udid:a}}}},apps:{install:async e=>ne(await i("install",[e.app,e.appPath],e),l(e)),reinstall:async e=>ne(await i("reinstall",[e.app,e.appPath],e),l(e)),installFromSource:async e=>(function(e,t){let r=rZ(e,"bundleId"),n=rZ(e,"packageName"),a=r??n??rZ(e,"appId"),i=rZ(e,"launchTarget")??n??r??a;if(!i)throw new ey("COMMAND_FAILED",'Daemon response is missing "launchTarget".',{response:e});return{appName:rZ(e,"appName"),appId:a,bundleId:r,packageName:n,launchTarget:i,installablePath:rZ(e,"installablePath"),archivePath:rZ(e,"archivePath"),materializationId:rZ(e,"materializationId"),materializationExpiresAt:rZ(e,"materializationExpiresAt"),identifiers:P({session:t,bundleId:r,packageName:n,appId:a})}})(await i("install_source",[],{...e,installSource:e.source,retainMaterializedPaths:e.retainPaths,materializedPathRetentionMs:e.retentionMs}),l(e)),list:async(e={})=>{let t=await i(ry,[],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]:[],n=await i("open",r,e),a=function(e){let t=e.platform,r=rZ(e,"id"),n=rZ(e,"device");if("ios"!==t&&"macos"!==t&&"android"!==t||!r||!n)return;let a=r1(e,"target"),i=M(t,r,n);return{platform:t,target:a,id:r,name:n,identifiers:i,ios:"ios"===t?{udid:rZ(e,"device_udid")??r,simulatorSetPath:rQ(e,"ios_simulator_device_set")}:void 0,android:"android"===t?{serial:rZ(e,"serial")??r}:void 0}}(n),o=rZ(n,"appBundleId");return{session:t,appName:rZ(n,"appName"),appBundleId:o,appId:o,startup:function(e){if(r7(e)&&"number"==typeof e.durationMs&&"string"==typeof e.measuredAt&&"string"==typeof e.method)return{durationMs:e.durationMs,measuredAt:e.measuredAt,method:e.method,appTarget:rZ(e,"appTarget"),appBundleId:rZ(e,"appBundleId")}}(n.startup),runtime:function(e){if(!r7(e))return;let t=e.platform,r=rZ(e,"metroHost"),n="number"==typeof e.metroPort?e.metroPort:void 0;return{platform:"ios"===t||"android"===t?t:void 0,metroHost:r,metroPort:n,bundleUrl:rZ(e,"bundleUrl"),launchUrl:rZ(e,"launchUrl")}}(n.runtime),device:a,identifiers:{session:t,deviceId:a?.id,deviceName:a?.name,udid:a?.ios?.udid,serial:a?.android?.serial,appId:o,appBundleId:o}}},close:async(e={})=>{let t=l(e),r=(await i("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 s(rC,[e.app,"string"==typeof(t=e.payload)?t:JSON.stringify(t)],e)},triggerEvent:async e=>{var t;return await s(rX,[(t=e).event,...t.payload?[JSON.stringify(t.payload)]:[]],e)}},materializations:{release:async e=>{var t;return{released:!0===(t=await i("release_materialized_paths",[],{...e,materializationId:e.materializationId})).released,materializationId:rW(t,"materializationId"),identifiers:{}}}},leases:{allocate:async e=>ns(await i("lease_allocate",[],{...e,leaseId:void 0,leaseTtlMs:e.ttlMs})),heartbeat:async e=>ns(await i("lease_heartbeat",[],{...e,leaseTtlMs:e.ttlMs})),release:async e=>({released:!0===(await i("lease_release",[],e)).released})},metro:{prepare:async t=>await rm({projectRoot:t.projectRoot??e.cwd,kind:t.kind,publicBaseUrl:t.publicBaseUrl,proxyBaseUrl:t.proxyBaseUrl,proxyBearerToken:t.bearerToken,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),n=await i(rG,[],e),a=rZ(n,"appBundleId"),o="object"==typeof n.visibility&&null!==n.visibility?n.visibility:void 0;return{nodes:Array.isArray(t=n.nodes)?t:[],truncated:!0===n.truncated,appName:rZ(n,"appName"),appBundleId:a,...o?{visibility:o}:{},warnings:Array.isArray(n.warnings)?n.warnings.filter(e=>"string"==typeof e):void 0,identifiers:{session:r,appId:a,appBundleId:a}}},screenshot:async(e={})=>{let t=l(e),r=await i(rB,e.path?[e.path]:[],{...e,screenshotFullscreen:e.fullscreen});return{path:rW(r,"path"),overlayRefs:function(e){let t=e.overlayRefs;if(!Array.isArray(t))return;let r=[];for(let e of t){if(!r7(e))continue;let t=rZ(e,"ref"),n=r2(e,"rect"),a=r2(e,"overlayRect"),i=function(e,t){let r=e[t];if(!r7(r))return;let n="number"==typeof r.x?r.x:void 0,a="number"==typeof r.y?r.y:void 0;if(void 0!==n&&void 0!==a)return{x:n,y:a}}(e,"center");t&&n&&a&&i&&r.push({ref:t,label:rZ(e,"label"),rect:n,overlayRect:a,center:i})}return r}(r),identifiers:{session:t}}},diff:async e=>await s(rA,[e.kind],{...e,interactiveOnly:e.interactiveOnly,compact:e.compact,depth:e.depth,scope:e.scope,raw:e.raw})},interactions:{click:async e=>await s(rk,na(e),{...e,clickButton:e.button}),press:async e=>await s(rT,na(e),e),longPress:async e=>await s(rL,[String(e.x),String(e.y),...no(e.durationMs)],e),swipe:async e=>await s(rq,[String(e.from.x),String(e.from.y),String(e.to.x),String(e.to.y),...no(e.durationMs)],e),focus:async e=>await s(r$,[String(e.x),String(e.y)],e),type:async e=>await s(rY,[e.text],e),fill:async e=>await s(rD,[...na(e),e.text],e),scroll:async e=>await s(rj,[e.direction,...no(e.amount)],e),pinch:async e=>await s(rE,[String(e.scale),...no(e.x),...no(e.y)],e),get:async e=>{var t;return await s("get",[e.format,...void 0!==(t=e).ref?[t.ref,...ni(t.label)]:[t.selector]],e)},is:async e=>await s("is",[e.predicate,e.selector,..."text"===e.predicate?[e.value]:[]],e),find:async e=>await s(rS,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",...no(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 s(rU,[e.path],{...e,replayUpdate:e.update}),test:async e=>await s(rH,e.paths,{...e,replayUpdate:e.update})},batch:{run:async e=>await s(rb,[],{...e,batchSteps:e.steps,batchOnError:e.onError,batchMaxSteps:e.maxSteps})},observability:{perf:async(e={})=>await s(r_,[],e),logs:async(e={})=>{var t;return await s(rN,[(t=e).action??"path",...ni(t.message)],e)},network:async(e={})=>{var t;return await s(rR,[...(t=e).action?[t.action]:[],...no(t.limit)],{...e,networkInclude:e.include})}},recording:{record:async e=>await s(rO,[e.action,...ni(e.path)],e),trace:async e=>await s(rK,[e.action,...ni(e.path)],e)},settings:{update:async e=>await s(rV,[e.setting,e.state,..."permission"in e?[e.permission]:[],..."mode"in e&&e.mode?[e.mode]:[]],e)}}}({session:$.session??D,requestId:r,stateDir:$.stateDir,daemonBaseUrl:$.daemonBaseUrl,daemonAuthToken:$.daemonAuthToken,daemonTransport:$.daemonTransport,daemonServerMode:$.daemonServerMode,tenant:$.tenant,sessionIsolation:$.sessionIsolation,runId:$.runId,leaseId:$.leaseId,leaseBackend:$.leaseBackend,runtime:S?.runtime,lockPolicy:x.lockPolicy,lockPlatform:x.defaultPlatform,cwd:process.cwd(),debug:!!$.verbose},{transport:t.sendToDaemon});try{if("batch"===_){if(E.length>0)throw new ey("INVALID_ARGS","batch does not accept positional arguments.");let 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 ey("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return L(t)})(I).map((e,t)=>({...e,flags:x.lockPolicy&&void 0===I.platform?{...e.flags??{}}:aV(e.flags??{},{policyOverrides:$,configuredPlatform:$.platform,configuredSession:$.session,inheritedPlatform:$.platform})}));if(await aB({command:_,positionals:E,flags:{...$,batchSteps:e},client:F}))return}else if("runtime"===_)throw new ey("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 aB({command:_,positionals:E,flags:$,client:F}))return;throw new ey("INVALID_ARGS",`Unknown command: ${_}`)}catch(r){let e=ef(r),t=eh(e,{diagnosticId:J().diagnosticId,logPath:ei({force:!0})??void 0});if("close"===_&&"COMMAND_FAILED"===(v=e).code&&(v.details?.kind==="daemon_startup_failed"||v.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof v.details?.infoPath||"string"==typeof v.details?.lockPath))){$.json&&e5({success:!0,data:{closed:"session",source:"no-daemon"}});return}if($.json)e5({success:!1,error:t});else if(e8(t,{showDetails:$.verbose}),$.verbose)try{let e=A.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(`
96
97
  [daemon log]
97
98
  ${r}
98
- `)}}catch{}P&&P(),process.exit(1)}finally{P&&P()}})}c(process.argv[1]??"").href===import.meta.url&&aX(process.argv.slice(2)).catch(e=>{e2(em(ed(e)),{showDetails:!0}),process.exit(1)}),aX(process.argv.slice(2));
99
+ `)}}catch{}U&&U(),process.exit(1)}finally{U&&U()}})}u(process.argv[1]??"").href===import.meta.url&&aX(process.argv.slice(2)).catch(e=>{e8(eh(ef(e)),{showDetails:!0}),process.exit(1)}),aX(process.argv.slice(2));