agent-device 0.11.16 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/src/bin.js CHANGED
@@ -1,7 +1,7 @@
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 D,serializeSessionListEntry as A,serializeSnapshotResult as S,isAgentDeviceDaemonProcess as $,buildDeviceIdentifiers as x,buildAppIdentifiers as N,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 H,displayNodeLabel as J,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 eD}from"./113.js";function eA(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"],ex=[{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:"maxScrolls",names:["--max-scrolls"],type:"int",min:1,max:200,usageLabel:"--max-scrolls <n>",usageDescription:"scrollintoview: cap the number of scroll gestures before failing"},{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)"}],eN=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"]},scrollintoview:{usageOverride:"scrollintoview <text|@ref>",helpDescription:"Scroll until text appears or a snapshot ref is brought into view",summary:"Scroll until text or ref is visible",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:["maxScrolls"]},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 ex){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,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]
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(eN)),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=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}
5
5
  ${t}
6
6
 
7
7
  ${r}
@@ -13,20 +13,20 @@ ${o}
13
13
  ${s}
14
14
 
15
15
  ${n}
16
- `);function eO(e){return ex.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}
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
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 eH=new Set(["config","remoteConfig","help","version","batchSteps"]),eJ={iosSimulatorDeviceSet:["IOS_SIMULATOR_DEVICE_SET"],androidDeviceAllowlist:["ANDROID_DEVICE_ALLOWLIST"],metroBearerToken:["AGENT_DEVICE_PROXY_TOKEN"]},eK=function(){let e=new Map;for(let t of ex){let r=e.get(t.key);r?r.push(t):e.set(t.key,[t])}let t=new Map;for(let e of eN)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:!eH.has(e),key:e},env:{names:[eG(e),...eJ[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)}
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
19
  `)}function e2(e,t={}){let r=e instanceof ef?em(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 tA(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=H(),o=P((t=tD()).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=tD(),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 tD(){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 tA(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 tx(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 tN(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(tx(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(tN(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(tx(e,l,t.meta?.requestId,t.command,c,r))},r):void 0;u.on("error",e=>{p&&clearTimeout(p),i(tN(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 tH(e){return tU(e.consumerKey)??tU(e.profileKey)??null}function tJ(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 D(e.pid,1e3)){try{process.kill(e.pid,"SIGKILL")}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return;throw t}await D(e.pid,1e3)}}}async function tz(e){let t=tH(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=tJ(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,tJ(o,t)),{pid:o.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function tW(e){let t=tH(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}}function t4(e,t){let r=Error(e);return r.retryable=t,r}async function t6(e){var t,r,a,o;let s;try{s=await fetch(`${e.baseUrl}/api/metro/bridge`,{method:"POST",headers:(t=e.baseUrl,r=e.bearerToken,{Authorization:`Bearer ${r}`,"Content-Type":"application/json",...t.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 t4(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0);throw t4(t instanceof Error?t.message:String(t),!0)}let n=await s.text(),i=n?JSON.parse(n):{};if(!s.ok)throw t4(`/api/metro/bridge failed (${s.status}): ${JSON.stringify(i)}`,(a=s.status,!!(a>=500||408===a||425===a||429===a||JSON.stringify(i).includes("Metro companion is not connected"))));return{enabled:(o=i.data??i).enabled,baseUrl:o.base_url,statusUrl:o.status_url??"",bundleUrl:o.bundle_url??"",iosRuntime:t2(o.ios_runtime,"ios"),androidRuntime:t2(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}}}function t7(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 t9(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 re(e){let t=Date.now()+e.startupTimeoutMs,r=null,a=null;for(;Date.now()<t;){try{let t=await t6({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(t7(e.baseUrl,a,r,e.initialBridgeError,e.companionLogPath))}async function rt(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,D=!1,A=0;if(d&&await t8(k,p))D=!0;else if(I=!0,A=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 t9(k,c,p))throw Error(`Metro did not become ready at ${k} within ${c}ms. Check ${g}.`);let S=t1(u,"ios"),$=t1(u,"android"),x=null,N=null;if(y)try{x=await t6({baseUrl:w,bearerToken:b,runtime:{metro_bundle_url:S.bundleUrl},timeoutMs:p})}catch(e){N=e instanceof Error?e.message:String(e)}if(y&&(!x||!1===x.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(t7(w,e instanceof Error?e.message:String(e),x,N))}try{x=await re({baseUrl:w,bearerToken:b,runtime:{metro_bundle_url:S.bundleUrl},probeTimeoutMs:p,startupTimeoutMs:c,initialBridgeError:N,companionLogPath:r})}catch(e){throw e instanceof Error?e:Error(String(e))}}let L=x?.iosRuntime??S,E=x?.androidRuntime??$,P={projectRoot:a,kind:o,dependenciesInstalled:v.installed,packageManager:v.packageManager??null,started:I,reused:D,pid:A,logPath:g,statusUrl:k,runtimeFilePath:h,iosRuntime:L,androidRuntime:E,bridge:x};return h&&(f.mkdirSync(i.dirname(h),{recursive:!0}),f.writeFileSync(h,JSON.stringify(P,null,2))),P}let rr="alert",ra="appstate",ro="app-switcher",rs="apps",rn="back",ri="batch",rl="boot",ru="click",rc="clipboard",rp="devices",rd="diff",rm="fill",rf="find",rh="focus",rg="home",ry="keyboard",rw="logs",rb="longpress",rv="network",rk="perf",rI="pinch",rD="press",rA="push",rS="record",r$="replay",rx="rotate",rN="scroll",rL="scrollintoview",rE="screenshot",rP="settings",r_="snapshot",rM="swipe",rT="test",rR="trace",rO="trigger-app-event",rC="type",rU="wait",rF=[{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"}],rj=new Map(rF.map(e=>[e.key,e]));function rV(e){let t=e.env??process.env;return X(e.configPath,{cwd:e.cwd,env:t})}function rG(e){let t=function(e){let t,r,a=e.env??process.env,o=rV(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=rj.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 rF){let a=r[e.key];void 0!==a&&(t[e.key]=a)}return t}(function(e=process.env){let t={};for(let r of rF){let a=(function(e){let t=rj.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 rB=rF.map(e=>e.key),rq=["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 rB){let a=e[r];void 0!==a&&(t[r]=a)}return t}(rG({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}).profile),remoteConfig:e.remoteConfig}:{}}function rJ(e,t,r,a){let o=r(e[t]);if(void 0===o)throw new ef("COMMAND_FAILED",a,{response:e});return o}function rK(e,t){return rJ(e,t,rQ,`Daemon response is missing "${t}".`)}function rz(e,t){return rQ(e[t])}function rW(e,t){var r;let a;return r=rQ,null===(a=e[t])?null:r(a)}function rX(e,t){return rJ(e,t,r1,`Daemon response has invalid "${t}".`)}function rY(e,t){return function(e){return"tv"===e||"mobile"===e||"desktop"===e?e:void 0}(e[t])??"mobile"}function rZ(e,t){let r=e[t];if(!r5(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 rQ(e){return"string"==typeof e&&e.length>0?e:void 0}function r0(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function r1(e){return"ios"===e||"macos"===e||"android"===e?e:void 0}function r2(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}function r3(e){if(!r5(e))throw new ef("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:e});return e}function r5(e){return"object"==typeof e&&null!==e}function r8(e){let t={};for(let[r,a]of Object.entries(e))void 0!==a&&(t[r]=a);return t}function r4(e,t){let r=rz(e,"bundleId"),a=rz(e,"package");return{app:rK(e,"app"),appPath:rK(e,"appPath"),platform:rX(e,"platform"),appId:r??a,bundleId:r,package:a,identifiers:N({session:t,bundleId:r,packageName:a})}}function r6(e){let t=r3(e),r=rX(t,"platform"),a=rK(t,"id"),o=rK(t,"name");return{platform:r,target:rY(t,"target"),kind:rJ(t,"kind",r2,'Daemon response has invalid "kind".'),id:a,name:o,booted:"boolean"==typeof t.booted?t.booted:void 0,identifiers:x(r,a,o),ios:"ios"===r?{udid:a}:void 0,android:"android"===r?{serial:a}:void 0}}function r7(e){let t=r3(e),r=rX(t,"platform"),a=rK(t,"id"),o=rK(t,"name"),s=rY(t,"target"),n=rK(t,"device"),i={session:o,...x(r,a,n)};return{name:o,createdAt:rJ(t,"createdAt",r0,'Daemon response is missing numeric "createdAt".'),device:{platform:r,target:s,id:a,name:n,identifiers:i,ios:"ios"===r?{udid:a,simulatorSetPath:rW(t,"ios_simulator_device_set")}:void 0,android:"android"===r?{serial:a}:void 0},identifiers:i}}function r9(e){return e??"default"}function ae(e){return void 0!==e.ref?[e.ref,...at(e.label)]:void 0!==e.selector?[e.selector]:[String(e.x),String(e.y)]}function at(e){return void 0===e?[]:[e]}function ar(e){return void 0===e?[]:[String(e)]}function aa(e,t,r){return r.remoteConfig&&r.remoteConfig!==e.remoteConfig?{...ao({...e,...r}),...e,...r}:{...t,...e,...r}}function ao(e){if(!e.remoteConfig)return{};let{runtime:t,...r}=rH({remoteConfig:e.remoteConfig,cwd:e.cwd??process.cwd(),env:process.env});return r}function as(e){return{platform:e.platform,target:e.target,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist}}function an(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 ai(e,t){an(e,t,()=>U(t))}let al=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(A)};return an(t,a,()=>JSON.stringify(a,null,2)),!0},au=async({flags:e,client:t})=>{let r=await t.devices.list(as(e));return an(e,{devices:r.map(j)},()=>r.map(ac).join("\n")),!0};function ac(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 ap=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 an(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},ad=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 an(t,a,()=>JSON.stringify(a,null,2)),!0},am=async({flags:e,client:t})=>{let r=await t.apps.list({...as(e),appsFilter:e.appsFilter});return an(e,{apps:r},()=>r.join("\n")),!0},af=async({positionals:e,flags:t,client:r})=>{let a=C(await ay("install",e,t,r));return ai(t,a),!0},ah=async({positionals:e,flags:t,client:r})=>{let a=C(await ay("reinstall",e,t,r));return ai(t,a),!0},ag=async({positionals:e,flags:t,client:r})=>{let a=en(await aw(e,t,r));return ai(t,a),!0};async function ay(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,...as(r)};return"install"===e?await a.apps.install(n):await a.apps.reinstall(n)}async function aw(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({...as(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 ab(e){await tW(e)}async function av(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:rV({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 ak=async({positionals:e,flags:t,client:r})=>{let a=await av(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,...as(t)}));return ai(t,o),!0},aI=async({positionals:e,flags:t,client:r})=>{let a=(()=>{let e;if(!t.remoteConfig)return null;try{e=rG({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 ab(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 ai(t,s),!0},aD=async({flags:e,client:t})=>{let r=S(await t.capture.snapshot({...as(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}));return an(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=J(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")}
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
30
  `:"";if(0===i.length)return`${y}${g}
31
31
  ${b}`;if(t.raw){let e=i.map(e=>JSON.stringify(e));return`${y}${g}
32
32
  ${b}${e.join("\n")}
@@ -36,54 +36,53 @@ ${b}${e.join("\n")}${t}
36
36
  `}let v=V(f,{summarizeTextSurfaces:!0}).flatMap(e=>[e.text,...e4(e)]),k=u&&u.summaryLines.length>0?`
37
37
  ${u.summaryLines.join("\n")}`:"";return`${y}${g}
38
38
  ${b}${v.join("\n")}${k}
39
- `})(r,{raw:e.snapshotRaw,flatten:e.snapshotInteractiveOnly})),!0},aA=255*Math.sqrt(3);async function aS(e,t,r={}){await a$(e,"Baseline image not found"),await a$(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*aA,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 a$(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 aN=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 an(t,{path:a.path,...a.overlayRefs?{overlayRefs:a.overlayRefs}:{}},()=>a.overlayRefs?`Annotated ${a.overlayRefs.length} refs onto ${a.path}`:a.path),!0},aL=async({positionals:e,flags:t,client:r})=>{let a;if("snapshot"===e[0]){let e=await r.capture.diff({...as(t),kind:"snapshot",out:t.out,interactiveOnly:t.snapshotInteractiveOnly,compact:t.snapshotCompact,depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw});return an(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")}
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
40
  `:"";if(r)return`${c}Baseline initialized (${n} lines).
41
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
42
  `:"";if(!i)return`${c}${d}${o} additions, ${s} removals, ${n} unchanged
43
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 aS(s,d,{threshold:u,outputPath:n})}finally{try{f.unlinkSync(d)}catch{}try{f.rmSync(c,{recursive:!0,force:!0})}catch{}}return an(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 aE(e){return null===e?{}:{timeoutMs:e}}function aP(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="${aT(e.durationMs)}">`];for(let r of e.tests)t.push(...function(e){let t=aR(i.basename(e.file)),r=aR("."===i.dirname(e.file)?e.file:i.dirname(e.file)),a=aR(e.file),o=aT(e.durationMs),s=[` <testcase classname="${r}" name="${t}" file="${a}" time="${o}">`];"failed"===e.status?s.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&&s.push(` <skipped message="${aR(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>${aR(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(aM);if(t.verbose)for(let t of e.tests)!function(e){if("failed"===e.status)return a_(e);let t="passed"===e.status?aM(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}
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}
47
47
  `),"skipped"===e.status&&process.stdout.write(` ${e.message??"skipped"}
48
- `)}(t);else{for(let t of e.failures)a_(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}
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
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 a_(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}
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}
51
51
  `),process.stdout.write(` ${e.error?.message??"Unknown test failure"}
52
52
  `),e.error?.hint&&process.stdout.write(` hint: ${e.error.hint}
53
53
  `),e.artifactsDir&&process.stdout.write(` artifacts: ${e.artifactsDir}
54
54
  `),e.error?.logPath&&process.stdout.write(` log: ${e.error.logPath}
55
55
  `),e.error?.diagnosticId&&process.stdout.write(` diagnostic: ${e.error.diagnosticId}
56
- `)}function aM(e){return"passed"===e.status&&e.attempts>1}function aT(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 aO={[rl]:aC(rl,({client:e,flags:t})=>e.devices.boot({...as(t),headless:t.headless})),[rA]:aC(rA,({client:e,positionals:t,flags:r})=>e.apps.push({...as(r),app:aV(t[0],"push requires bundleOrPackage"),payload:aV(t[1],"push requires payloadOrJson")})),[rk]:aC(rk,({client:e,flags:t})=>e.observability.perf(as(t))),[ru]:aC(ru,({client:e,positionals:t,flags:r})=>e.interactions.click({...aF(t),...aU(r),...as(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap,button:r.clickButton})),get:aC("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)),...aU(r),...as(r),format:function(e){if("text"===e||"attrs"===e)return e;throw new ef("INVALID_ARGS","get only supports text or attrs")}(t[0])})),[r$]:aC(r$,({client:e,positionals:t,flags:r})=>e.replay.run({...as(r),path:aV(t[0],"replay requires path"),update:r.replayUpdate})),[rT]:aC(rT,({client:e,positionals:t,flags:r})=>(({json:r.json}).json||process.stderr.write("Running replay suite...\n"),e.replay.test({...as(r),paths:t,update:r.replayUpdate,failFast:r.failFast,timeoutMs:r.timeoutMs,retries:r.retries,artifactsDir:r.artifactsDir,reportJunit:r.reportJunit}))),[ri]:aC(ri,({client:e,flags:t})=>e.batch.run({...as(t),steps:t.batchSteps??[],onError:t.batchOnError,maxSteps:t.batchMaxSteps,out:t.out})),[rD]:aC(rD,({client:e,positionals:t,flags:r})=>e.interactions.press({...aF(t),...aU(r),...as(r),count:r.count,intervalMs:r.intervalMs,holdMs:r.holdMs,jitterPx:r.jitterPx,doubleTap:r.doubleTap})),[rb]:aC(rb,({client:e,positionals:t,flags:r})=>e.interactions.longPress({...as(r),x:Number(t[0]),y:Number(t[1]),durationMs:aG(t[2])})),[rM]:aC(rM,({client:e,positionals:t,flags:r})=>e.interactions.swipe({...as(r),from:{x:Number(t[0]),y:Number(t[1])},to:{x:Number(t[2]),y:Number(t[3])},durationMs:aG(t[4]),count:r.count,pauseMs:r.pauseMs,pattern:r.pattern})),[rh]:aC(rh,({client:e,positionals:t,flags:r})=>e.interactions.focus({...as(r),x:Number(t[0]),y:Number(t[1])})),[rC]:aC(rC,({client:e,positionals:t,flags:r})=>e.interactions.type({...as(r),text:t.join(" "),delayMs:r.delayMs})),[rm]:aC(rm,({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),...aU(r),...as(r),delayMs:r.delayMs})),[rN]:aC(rN,({client:e,positionals:t,flags:r})=>e.interactions.scroll({...as(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:aG(t[1]),pixels:r.pixels})),[rL]:aC(rL,({client:e,positionals:t,flags:r})=>e.interactions.scrollIntoView({...as(r),...t[0]?.startsWith("@")?{ref:t[0],label:t.slice(1).join(" ")||void 0}:{text:t.join(" ")},maxScrolls:r.maxScrolls})),[rI]:aC(rI,({client:e,positionals:t,flags:r})=>e.interactions.pinch({...as(r),scale:Number(t[0]),x:aG(t[1]),y:aG(t[2])})),[rO]:aC(rO,({client:e,positionals:t,flags:r})=>e.apps.triggerEvent({...as(r),event:aV(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})),[rS]:aC(rS,({client:e,positionals:t,flags:r})=>e.recording.record({...as(r),action:aj(t[0],"record"),path:t[1],fps:r.fps,hideTouches:r.hideTouches})),[rR]:aC(rR,({client:e,positionals:t,flags:r})=>e.recording.trace({...as(r),action:aj(t[0],"trace"),path:t[1]})),[rw]:aC(rw,({client:e,positionals:t,flags:r})=>e.observability.logs({...as(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})),[rv]:aC(rv,({client:e,positionals:t,flags:r})=>e.observability.network({...as(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:aG(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])})),[rf]:aC(rf,({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:aV(a,"find requires query")};if("get"===s){let r=e[o+1];if("text"===r)return{locator:t,query:aV(a,"find requires query"),action:"getText"};if("attrs"===r)return{locator:t,query:aV(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:aV(a,"find requires query"),action:"wait",timeoutMs:aG(e[o+1])};if("fill"===s||"type"===s)return{locator:t,query:aV(a,"find requires query"),action:s,value:e.slice(o+1).join(" ")};if("click"===s||"focus"===s||"exists"===s)return{locator:t,query:aV(a,"find requires query"),action:s};throw new ef("INVALID_ARGS",`Unsupported find action: ${s}`)}(t),...{depth:(a=r).snapshotDepth,raw:a.snapshotRaw},...as(r),first:r.findFirst,last:r.findLast})}),is:aC("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),...aU(r),...as(r)})),[rP]:aC(rP,({client:e,positionals:t,flags:r})=>e.settings.update(function(e,t){let r=as(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 aC(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===rT?aP({suite:a,json:!0,reportJunit:r.reportJunit}):(e1({success:!0,data:a}),0);if(e===rT)return aP({suite:a,verbose:r.verbose,reportJunit:r.reportJunit});if(e===ri)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`:""}
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
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
58
  `)}}(a),0;if("get"===e){let e=t[0];if("text"===e)return process.stdout.write(`${"string"==typeof a.text?a.text:""}
59
59
  `),0;if("attrs"===e)return process.stdout.write(`${JSON.stringify(a.node??{},null,2)}
60
- `),0}if(e===rf){if("string"==typeof a.text)return process.stdout.write(`${a.text}
60
+ `),0}if(e===rg){if("string"==typeof a.text)return process.stdout.write(`${a.text}
61
61
  `),0;if("boolean"==typeof a.found)return process.stdout.write(`Found: ${a.found}
62
62
  `),0;if(a.node)return process.stdout.write(`${JSON.stringify(a.node,null,2)}
63
63
  `),0}if("is"===e)return process.stdout.write(`Passed: is ${a.predicate??"assertion"}
64
- `),0;if(e===rl){let e=a.platform??"unknown",t=a.device??a.id??"unknown";return process.stdout.write(`Boot ready: ${t} (${e})
65
- `),0}if(e===rS){let e="string"==typeof a.outPath?a.outPath:"";return e&&process.stdout.write(`${e}
66
- `),0}if(e===rw)return function(e,t){let r="string"==typeof e.path?e.path:"";if(!r)return;process.stdout.write(`${r}
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
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
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}
69
69
  `),e.hint&&!t.json&&process.stderr.write(`${e.hint}
70
70
  `),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===rv)return function(e){let t="string"==typeof e.path?e.path:"";t&&process.stdout.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
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}
73
73
  `),"string"==typeof e.headers&&process.stdout.write(` headers: ${e.headers}
74
74
  `),"string"==typeof e.requestBody&&process.stdout.write(` request: ${e.requestBody}
75
75
  `),"string"==typeof e.responseBody&&process.stdout.write(` response: ${e.responseBody}
76
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
77
  `),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===ru||e===rD){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===rk)return process.stdout.write(`${JSON.stringify(a,null,2)}
80
- `),0;let o=U(a);if(o)for(let t of(process.stdout.write(`${o}
81
- `),function(e,t){if(e!==rL)return[];let r="string"==typeof t.ref?t.ref:"",a="string"==typeof t.currentRef?t.currentRef:"";return a&&a!==r?[`Current ref: @${a}`]:[]}(e,a)))process.stdout.write(`${t}
82
- `);return 0}(e,r,a,s);return 0!==n&&process.exit(n),!0}}function aU(e){return{depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}}function aF(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 aj(e,t){if("start"===e||"stop"===e)return e;throw new ef("INVALID_ARGS",`${t} requires start|stop`)}function aV(e,t){if(void 0===e||""===e)throw new ef("INVALID_ARGS",t);return e}function aG(e){return void 0===e?void 0:Number(e)}let aB={...{session:al,[rp]:au,[rs]:am,"ensure-simulator":ap,metro:ad,install:af,reinstall:ah,"install-from-source":ag,open:ak,close:aI,[r_]:aD,[rE]:aN,[rd]:aL},...{[rU]:async({positionals:e,flags:t,client:r})=>(ai(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={...as(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,...aE(r.timeoutMs)}}return"ref"===r.kind?{...a,ref:r.rawRef,...aE(r.timeoutMs)}:{...a,selector:r.selectorExpression,...aE(r.timeoutMs)}}(e,t))),!0),[rr]:async({positionals:e,flags:t,client:r})=>(ai(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{...as(t),...r?{action:r}:{},...void 0!==a?{timeoutMs:a}:{}}}(e,t))),!0),[ra]:async({flags:e,client:t})=>{let r=await t.command.appState(as(e));return an(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},[rn]:async({flags:e,client:t})=>(ai(e,await t.command.back({...as(e),mode:e.backMode})),!0),[rg]:async({flags:e,client:t})=>(ai(e,await t.command.home(as(e))),!0),[rx]:async({positionals:e,flags:t,client:r})=>(ai(t,await r.command.rotate(function(e,t){if(e.length>1)throw new ef("INVALID_ARGS","rotate accepts exactly one orientation argument.");return{...as(t),orientation:v(e[0])}}(e,t))),!0),[ro]:async({flags:e,client:t})=>(ai(e,await t.command.appSwitcher(as(e))),!0),[ry]:async({positionals:e,flags:t,client:r})=>(ai(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{...as(t),...r?{action:r}:{}}}(e,t))),!0),[rc]: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=as(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?an(a,o):"read"===o.action?process.stdout.write(`${o.text}
83
- `):ai(a,o),!0}},...aO};async function aq(e){let t=aB[e.command];return!!t&&await t(e)}function aH(e,t={}){let r=aJ(t),a={...e};return r.defaultPlatform&&void 0===a.platform&&(a.platform=r.defaultPlatform),a}function aJ(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??aK(a.AGENT_DEVICE_SESSION_LOCK)??aK(a.AGENT_DEVICE_SESSION_LOCK_CONFLICTS))||(r?.sessionLocked===!0||L(a.AGENT_DEVICE_SESSION_LOCKED)||o?"reject":void 0))}}function aK(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 az={sendToDaemon:tn};async function aW(e,t=az){let r=B(),a=H(),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=eA((s=(l={command:t.command,cwd:a,cliFlags:t.flags,env:r}).env??process.env,y=eA({},function(e){let t={};for(let r of e)eA(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}]))),eA(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=eA({json:!1,help:!1,version:!1},t?.defaultFlags??{});eA(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 rq){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}
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}
84
83
  `);w.flags.version&&(process.stdout.write(`${a}
85
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}
86
- `),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(eN),i=[];return s.length>0&&i.push(eC("Command flags:",s)),i.push(eC("Global flags:",n)),`agent-device ${o}
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}
87
86
 
88
87
  ${a.helpDescription}
89
88
 
@@ -93,7 +92,7 @@ Usage:
93
92
  ${i.join("\n\n")}
94
93
  `}(e0(e));t&&(process.stdout.write(t),process.exit(0)),e2(new ef("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${eR}
95
94
  `),process.exit(1)}w.command||(process.stdout.write(`${eR}
96
- `),process.exit(1));let{command:k,positionals:I}=w,D=aJ({policyOverrides:w.flags,configuredPlatform:w.flags.platform,configuredSession:w.flags.session}),A=D.lockPolicy?{...w.flags}:aH(w.flags,{policyOverrides:w.flags,configuredPlatform:w.flags.platform,configuredSession:w.flags.session}),S=ea(A.stateDir),$=A.session??"default";eD({command:k,currentVersion:a,stateDir:S.baseDir,flags:A});let L=A.daemonBaseUrl,P=!A.verbose||A.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=ao(e),n=async(t,r=[],a={})=>{let n=aa(e,s,a),i=await o({session:r9(n.session),command:t,positionals:r,flags:r8({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,maxScrolls:n.maxScrolls,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:r8({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(r7)},l=async(e,t=[],r={})=>await n(e,t,r),u=(t={})=>r9(aa(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:rU,positionals:[String(e.durationMs)],options:e};let t=void 0!==e.timeoutMs?[String(e.timeoutMs)]:[];if(void 0!==e.text)return{command:rU,positionals:["text",e.text,...t],options:e};if(void 0!==e.ref)return{command:rU,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:rU,positionals:[r,...t],options:e}}(e)),alert:async(e={})=>{var t;return await a({command:rr,positionals:[(t=e).action??"get",...void 0!==t.timeoutMs?[String(t.timeoutMs)]:[]],options:t})},appState:async(e={})=>await a({command:ra,positionals:[],options:e}),back:async(e={})=>await a({command:rn,positionals:[],options:{...e,backMode:e.mode}}),home:async(e={})=>await a({command:rg,positionals:[],options:e}),rotate:async e=>await a({command:rx,positionals:[e.orientation],options:e}),appSwitcher:async(e={})=>await a({command:ro,positionals:[],options:e}),keyboard:async(e={})=>await a({command:ry,positionals:e.action?[e.action]:[],options:e}),clipboard:async e=>{var t;return await a("read"===(t=e).action?{command:rc,positionals:["read"],options:t}:{command:rc,positionals:["write",t.text],options:t})}}),devices:{list:async(e={})=>{let t=await n(rp,[],e);return(Array.isArray(t.devices)?t.devices:[]).map(r6)},boot:async(e={})=>await l(rl,[],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=rK(a,"udid"),s=rK(a,"device");return{udid:o,device:s,runtime:rK(a,"runtime"),created:!0===a.created,booted:!0===a.booted,iosSimulatorDeviceSet:rW(a,"ios_simulator_device_set"),identifiers:{deviceId:o,deviceName:s,udid:o}}}},apps:{install:async e=>r4(await n("install",[e.app,e.appPath],e),u(e)),reinstall:async e=>r4(await n("reinstall",[e.app,e.appPath],e),u(e)),installFromSource:async e=>(function(e,t){let r=rz(e,"bundleId"),a=rz(e,"packageName"),o=r??a??rz(e,"appId"),s=rz(e,"launchTarget")??a??r??o;if(!s)throw new ef("COMMAND_FAILED",'Daemon response is missing "launchTarget".',{response:e});return{appName:rz(e,"appName"),appId:o,bundleId:r,packageName:a,launchTarget:s,installablePath:rz(e,"installablePath"),archivePath:rz(e,"archivePath"),materializationId:rz(e,"materializationId"),materializationExpiresAt:rz(e,"materializationExpiresAt"),identifiers:N({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(rs,[],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=rz(e,"id"),a=rz(e,"device");if("ios"!==t&&"macos"!==t&&"android"!==t||!r||!a)return;let o=rY(e,"target"),s=x(t,r,a);return{platform:t,target:o,id:r,name:a,identifiers:s,ios:"ios"===t?{udid:rz(e,"device_udid")??r,simulatorSetPath:rW(e,"ios_simulator_device_set")}:void 0,android:"android"===t?{serial:rz(e,"serial")??r}:void 0}}(a),s=rz(a,"appBundleId");return{session:t,appName:rz(a,"appName"),appBundleId:s,appId:s,startup:function(e){if(r5(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")}}(a.startup),runtime:function(e){if(!r5(e))return;let t=e.platform,r=rz(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:rz(e,"bundleUrl"),launchUrl:rz(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(rA,[e.app,"string"==typeof(t=e.payload)?t:JSON.stringify(t)],e)},triggerEvent:async e=>{var t;return await l(rO,[(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:rK(t,"materializationId"),identifiers:{}}}},metro:{prepare:async t=>await rt({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(r_,[],e),o=rz(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:rz(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(rE,e.path?[e.path]:[],{...e,screenshotFullscreen:e.fullscreen});return{path:rK(r,"path"),overlayRefs:function(e){let t=e.overlayRefs;if(!Array.isArray(t))return;let r=[];for(let e of t){if(!r5(e))continue;let t=rz(e,"ref"),a=rZ(e,"rect"),o=rZ(e,"overlayRect"),s=function(e,t){let r=e[t];if(!r5(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:rz(e,"label"),rect:a,overlayRect:o,center:s})}return r}(r),identifiers:{session:t}}},diff:async e=>await l(rd,[e.kind],{...e,interactiveOnly:e.interactiveOnly,compact:e.compact,depth:e.depth,scope:e.scope,raw:e.raw})},interactions:{click:async e=>await l(ru,ae(e),{...e,clickButton:e.button}),press:async e=>await l(rD,ae(e),e),longPress:async e=>await l(rb,[String(e.x),String(e.y),...ar(e.durationMs)],e),swipe:async e=>await l(rM,[String(e.from.x),String(e.from.y),String(e.to.x),String(e.to.y),...ar(e.durationMs)],e),focus:async e=>await l(rh,[String(e.x),String(e.y)],e),type:async e=>await l(rC,[e.text],e),fill:async e=>await l(rm,[...ae(e),e.text],e),scroll:async e=>await l(rN,[e.direction,...ar(e.amount)],e),scrollIntoView:async e=>{var t;return await l(rL,void 0!==(t=e).ref?[t.ref,...at(t.label)]:[t.text??""],e)},pinch:async e=>await l(rI,[String(e.scale),...ar(e.x),...ar(e.y)],e),get:async e=>{var t;return await l("get",[e.format,...void 0!==(t=e).ref?[t.ref,...at(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(rf,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",...ar(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(r$,[e.path],{...e,replayUpdate:e.update}),test:async e=>await l(rT,e.paths,{...e,replayUpdate:e.update})},batch:{run:async e=>await l(ri,[],{...e,batchSteps:e.steps,batchOnError:e.onError,batchMaxSteps:e.maxSteps})},observability:{perf:async(e={})=>await l(rk,[],e),logs:async(e={})=>{var t;return await l(rw,[(t=e).action??"path",...at(t.message)],e)},network:async(e={})=>{var t;return await l(rv,[...(t=e).action?[t.action]:[],...ar(t.limit)],{...e,networkInclude:e.include})}},recording:{record:async e=>await l(rS,[e.action,...at(e.path)],e),trace:async e=>await l(rR,[e.action,...at(e.path)],e)},settings:{update:async e=>await l(rP,[e.setting,e.state,..."permission"in e?[e.permission]:[],..."mode"in e&&e.mode?[e.mode]:[]],e)}}}({session:$,requestId:r,stateDir:A.stateDir,daemonBaseUrl:A.daemonBaseUrl,daemonAuthToken:A.daemonAuthToken,daemonTransport:A.daemonTransport,daemonServerMode:A.daemonServerMode,remoteConfig:A.remoteConfig,tenant:A.tenant,sessionIsolation:A.sessionIsolation,runId:A.runId,leaseId:A.leaseId,lockPolicy:D.lockPolicy,lockPlatform:D.defaultPlatform,cwd:process.cwd(),debug:!!A.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)})(A).map((e,t)=>({...e,flags:D.lockPolicy&&void 0===A.platform?{...e.flags??{}}:aH(e.flags??{},{policyOverrides:A,configuredPlatform:A.platform,configuredSession:A.session,inheritedPlatform:A.platform})}));if(await aq({command:k,positionals:I,flags:{...A,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 aq({command:k,positionals:I,flags:A,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))){A.json&&e1({success:!0,data:{closed:"session",source:"no-daemon"}});return}if(A.json)e1({success:!1,error:t});else if(e2(t,{showDetails:A.verbose}),A.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(`
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(`
97
96
  [daemon log]
98
97
  ${r}
99
- `)}}catch{}P&&P(),process.exit(1)}finally{P&&P()}})}c(process.argv[1]??"").href===import.meta.url&&aW(process.argv.slice(2)).catch(e=>{e2(em(ed(e)),{showDetails:!0}),process.exit(1)}),aW(process.argv.slice(2));
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));