agent-device 0.7.21 → 0.7.22

package/dist/src/utils/command-schema.d.ts

@@ -0,0 +1,93 @@
+export type CliFlags = {
+    json: boolean;
+    stateDir?: string;
+    daemonBaseUrl?: string;
+    daemonAuthToken?: string;
+    daemonTransport?: 'auto' | 'socket' | 'http';
+    daemonServerMode?: 'socket' | 'http' | 'dual';
+    tenant?: string;
+    sessionIsolation?: 'none' | 'tenant';
+    runId?: string;
+    leaseId?: string;
+    platform?: 'ios' | 'android' | 'apple';
+    target?: 'mobile' | 'tv';
+    device?: string;
+    udid?: string;
+    serial?: string;
+    iosSimulatorDeviceSet?: string;
+    androidDeviceAllowlist?: string;
+    out?: string;
+    session?: string;
+    runtime?: string;
+    metroHost?: string;
+    metroPort?: number;
+    bundleUrl?: string;
+    launchUrl?: string;
+    boot?: boolean;
+    reuseExisting?: boolean;
+    verbose?: boolean;
+    snapshotInteractiveOnly?: boolean;
+    snapshotCompact?: boolean;
+    snapshotDepth?: number;
+    snapshotScope?: string;
+    snapshotRaw?: boolean;
+    appsFilter?: 'user-installed' | 'all';
+    count?: number;
+    fps?: number;
+    intervalMs?: number;
+    holdMs?: number;
+    jitterPx?: number;
+    doubleTap?: boolean;
+    pauseMs?: number;
+    pattern?: 'one-way' | 'ping-pong';
+    activity?: string;
+    saveScript?: boolean | string;
+    shutdown?: boolean;
+    relaunch?: boolean;
+    headless?: boolean;
+    restart?: boolean;
+    noRecord?: boolean;
+    replayUpdate?: boolean;
+    steps?: string;
+    stepsFile?: string;
+    batchOnError?: 'stop';
+    batchMaxSteps?: number;
+    batchSteps?: Array<{
+        command: string;
+        positionals?: string[];
+        flags?: Record<string, unknown>;
+    }>;
+    help: boolean;
+    version: boolean;
+};
+export type FlagKey = keyof CliFlags;
+type FlagType = 'boolean' | 'int' | 'enum' | 'string' | 'booleanOrString';
+export type FlagDefinition = {
+    key: FlagKey;
+    names: readonly string[];
+    type: FlagType;
+    enumValues?: readonly string[];
+    min?: number;
+    max?: number;
+    setValue?: CliFlags[FlagKey];
+    usageLabel?: string;
+    usageDescription?: string;
+};
+type CommandSchema = {
+    description: string;
+    positionalArgs: readonly string[];
+    allowsExtraPositionals?: boolean;
+    allowedFlags: readonly FlagKey[];
+    defaults?: Partial<CliFlags>;
+    skipCapabilityCheck?: boolean;
+    usageOverride?: string;
+};
+export declare const GLOBAL_FLAG_KEYS: Set<keyof CliFlags>;
+export declare function getFlagDefinition(token: string): FlagDefinition | undefined;
+export declare function getCommandSchema(command: string | null): CommandSchema | undefined;
+export declare function getCliCommandNames(): string[];
+export declare function getSchemaCapabilityKeys(): string[];
+export declare function isStrictFlagModeEnabled(value: string | undefined): boolean;
+export declare function buildUsageText(): string;
+export declare function buildCommandUsageText(commandName: string): string | null;
+export {};

package/dist/src/utils/device-isolation.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveIosSimulatorDeviceSetPath(flagValue: string | undefined, env?: NodeJS.ProcessEnv): string | undefined;
+export declare function parseSerialAllowlist(value: string): Set<string>;
+export declare function resolveAndroidSerialAllowlist(flagValue: string | undefined, env?: NodeJS.ProcessEnv): ReadonlySet<string> | undefined;

package/dist/src/utils/device.d.ts

@@ -0,0 +1,27 @@
+export type Platform = 'ios' | 'android';
+export type PlatformSelector = Platform | 'apple';
+export type DeviceKind = 'simulator' | 'emulator' | 'device';
+export type DeviceTarget = 'mobile' | 'tv';
+export type DeviceInfo = {
+    platform: Platform;
+    id: string;
+    name: string;
+    kind: DeviceKind;
+    target?: DeviceTarget;
+    booted?: boolean;
+    simulatorSetPath?: string;
+};
+type DeviceSelector = {
+    platform?: Platform;
+    target?: DeviceTarget;
+    deviceName?: string;
+    udid?: string;
+    serial?: string;
+};
+type DeviceSelectionContext = {
+    simulatorSetPath?: string;
+};
+export declare function normalizePlatformSelector(platform: PlatformSelector | undefined): Platform | undefined;
+export declare function resolveApplePlatformName(target: DeviceTarget | undefined): 'iOS' | 'tvOS';
+export declare function selectDevice(devices: DeviceInfo[], selector: DeviceSelector, context?: DeviceSelectionContext): Promise<DeviceInfo>;
+export {};

package/dist/src/utils/diagnostics.d.ts

@@ -0,0 +1,30 @@
+type DiagnosticLevel = 'info' | 'warn' | 'error' | 'debug';
+type DiagnosticsScopeOptions = {
+    session?: string;
+    requestId?: string;
+    command?: string;
+    debug?: boolean;
+    logPath?: string;
+    traceLogPath?: string;
+};
+export declare function createRequestId(): string;
+export declare function withDiagnosticsScope<T>(options: DiagnosticsScopeOptions, fn: () => Promise<T> | T): Promise<T>;
+export declare function getDiagnosticsMeta(): {
+    diagnosticId?: string;
+    requestId?: string;
+    session?: string;
+    command?: string;
+    debug?: boolean;
+};
+export declare function emitDiagnostic(event: {
+    level?: DiagnosticLevel;
+    phase: string;
+    durationMs?: number;
+    data?: Record<string, unknown>;
+}): void;
+export declare function withDiagnosticTimer<T>(phase: string, fn: () => Promise<T> | T, data?: Record<string, unknown>): Promise<T>;
+export declare function flushDiagnosticsToSessionFile(options?: {
+    force?: boolean;
+}): string | null;
+export declare function redactDiagnosticData<T>(input: T): T;
+export {};

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,26 @@
+type ErrorCode = 'INVALID_ARGS' | 'DEVICE_NOT_FOUND' | 'TOOL_MISSING' | 'APP_NOT_INSTALLED' | 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_OPERATION' | 'COMMAND_FAILED' | 'SESSION_NOT_FOUND' | 'UNAUTHORIZED' | 'UNKNOWN';
+type AppErrorDetails = Record<string, unknown> & {
+    hint?: string;
+    diagnosticId?: string;
+    logPath?: string;
+};
+export type NormalizedError = {
+    code: string;
+    message: string;
+    hint?: string;
+    diagnosticId?: string;
+    logPath?: string;
+    details?: Record<string, unknown>;
+};
+export declare class AppError extends Error {
+    code: ErrorCode;
+    details?: AppErrorDetails;
+    cause?: unknown;
+    constructor(code: ErrorCode, message: string, details?: AppErrorDetails, cause?: unknown);
+}
+export declare function asAppError(err: unknown): AppError;
+export declare function normalizeError(err: unknown, context?: {
+    diagnosticId?: string;
+    logPath?: string;
+}): NormalizedError;
+export {};

package/dist/src/utils/exec.d.ts

@@ -0,0 +1,32 @@
+import { spawn } from 'node:child_process';
+export type ExecResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    stdoutBuffer?: Buffer;
+};
+type ExecOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    allowFailure?: boolean;
+    binaryStdout?: boolean;
+    stdin?: string | Buffer;
+    timeoutMs?: number;
+    detached?: boolean;
+};
+type ExecStreamOptions = ExecOptions & {
+    onStdoutChunk?: (chunk: string) => void;
+    onStderrChunk?: (chunk: string) => void;
+    onSpawn?: (child: ReturnType<typeof spawn>) => void;
+};
+export type ExecBackgroundResult = {
+    child: ReturnType<typeof spawn>;
+    wait: Promise<ExecResult>;
+};
+export declare function runCmd(cmd: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
+export declare function whichCmd(cmd: string): Promise<boolean>;
+export declare function runCmdSync(cmd: string, args: string[], options?: ExecOptions): ExecResult;
+export declare function runCmdDetached(cmd: string, args: string[], options?: ExecOptions): void;
+export declare function runCmdStreaming(cmd: string, args: string[], options?: ExecStreamOptions): Promise<ExecResult>;
+export declare function runCmdBackground(cmd: string, args: string[], options?: ExecOptions): ExecBackgroundResult;
+export {};

package/dist/src/utils/finders.d.ts

@@ -0,0 +1,12 @@
+import type { SnapshotNode } from './snapshot.ts';
+export type FindLocator = 'any' | 'text' | 'label' | 'value' | 'role' | 'id';
+type FindMatchOptions = {
+    requireRect?: boolean;
+};
+type FindBestMatches = {
+    matches: SnapshotNode[];
+    score: number;
+};
+export declare function findNodeByLocator(nodes: SnapshotNode[], locator: FindLocator, query: string, options?: FindMatchOptions): SnapshotNode | null;
+export declare function findBestMatchesByLocator(nodes: SnapshotNode[], locator: FindLocator, query: string, options?: FindMatchOptions): FindBestMatches;
+export {};

package/dist/src/utils/interactive.d.ts

@@ -0,0 +1 @@
+export declare function isInteractive(): boolean;

package/dist/src/utils/interactors.d.ts

@@ -0,0 +1,31 @@
+import type { DeviceInfo } from './device.ts';
+export type RunnerContext = {
+    requestId?: string;
+    appBundleId?: string;
+    verbose?: boolean;
+    logPath?: string;
+    traceLogPath?: string;
+};
+type Interactor = {
+    open(app: string, options?: {
+        activity?: string;
+        appBundleId?: string;
+        url?: string;
+    }): Promise<void>;
+    openDevice(): Promise<void>;
+    close(app: string): Promise<void>;
+    tap(x: number, y: number): Promise<void>;
+    doubleTap(x: number, y: number): Promise<void>;
+    swipe(x1: number, y1: number, x2: number, y2: number, durationMs?: number): Promise<void>;
+    longPress(x: number, y: number, durationMs?: number): Promise<void>;
+    focus(x: number, y: number): Promise<void>;
+    type(text: string): Promise<void>;
+    fill(x: number, y: number, text: string): Promise<void>;
+    scroll(direction: string, amount?: number): Promise<void>;
+    scrollIntoView(text: string): Promise<{
+        attempts?: number;
+    } | void>;
+    screenshot(outPath: string, appBundleId?: string): Promise<void>;
+};
+export declare function getInteractor(device: DeviceInfo, runnerContext: RunnerContext): Interactor;
+export {};

package/dist/src/utils/json-input.d.ts

@@ -0,0 +1 @@
+export declare function looksLikeInlineJson(value: string): boolean;

package/dist/src/utils/keyed-lock.d.ts

@@ -0,0 +1 @@
+export declare function withKeyedLock<T>(locks: Map<string, Promise<unknown>>, key: string, task: () => Promise<T>): Promise<T>;

package/dist/src/utils/output.d.ts

@@ -0,0 +1,25 @@
+import { AppError, type NormalizedError } from './errors.ts';
+type JsonResult = {
+    success: true;
+    data?: Record<string, unknown>;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+        diagnosticId?: string;
+        logPath?: string;
+        details?: Record<string, unknown>;
+    };
+};
+export declare function printJson(result: JsonResult): void;
+export declare function printHumanError(err: AppError | NormalizedError, options?: {
+    showDetails?: boolean;
+}): void;
+export declare function formatSnapshotText(data: Record<string, unknown>, options?: {
+    raw?: boolean;
+    flatten?: boolean;
+}): string;
+export declare function formatSnapshotDiffText(data: Record<string, unknown>): string;
+export {};

package/dist/src/utils/payload-input.d.ts

@@ -0,0 +1,12 @@
+export type ResolvedPayloadInput = {
+    kind: 'file';
+    path: string;
+} | {
+    kind: 'inline';
+    text: string;
+};
+export declare function resolvePayloadInput(value: string, options?: {
+    subject?: string;
+    cwd?: string;
+    expandPath?: (value: string, cwd?: string) => string;
+}): ResolvedPayloadInput;

package/dist/src/utils/process-identity.d.ts

@@ -0,0 +1,11 @@
+export declare function isProcessAlive(pid: number): boolean;
+export declare function readProcessStartTime(pid: number): string | null;
+export declare function readProcessCommand(pid: number): string | null;
+export declare function isAgentDeviceDaemonCommand(command: string): boolean;
+export declare function isAgentDeviceDaemonProcess(pid: number, expectedStartTime?: string): boolean;
+export declare function waitForProcessExit(pid: number, timeoutMs: number): Promise<boolean>;
+export declare function stopProcessForTakeover(pid: number, options: {
+    termTimeoutMs: number;
+    killTimeoutMs: number;
+    expectedStartTime?: string;
+}): Promise<void>;

package/dist/src/utils/retry.d.ts

@@ -0,0 +1,54 @@
+type RetryOptions = {
+    attempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+};
+type RetryPolicy = {
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    jitter: number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+};
+type RetryAttemptContext = {
+    attempt: number;
+    maxAttempts: number;
+    deadline?: Deadline;
+};
+type TimeoutProfile = {
+    startupMs: number;
+    operationMs: number;
+    totalMs: number;
+};
+type RetryTelemetryEvent = {
+    phase?: string;
+    event: 'attempt_failed' | 'retry_scheduled' | 'succeeded' | 'exhausted';
+    attempt: number;
+    maxAttempts: number;
+    delayMs?: number;
+    elapsedMs?: number;
+    remainingMs?: number;
+    reason?: string;
+};
+export declare function isEnvTruthy(value: string | undefined): boolean;
+export declare const TIMEOUT_PROFILES: Record<string, TimeoutProfile>;
+export declare class Deadline {
+    private readonly startedAtMs;
+    private readonly expiresAtMs;
+    private constructor();
+    static fromTimeoutMs(timeoutMs: number, nowMs?: number): Deadline;
+    remainingMs(nowMs?: number): number;
+    elapsedMs(nowMs?: number): number;
+    isExpired(nowMs?: number): boolean;
+}
+export declare function retryWithPolicy<T>(fn: (context: RetryAttemptContext) => Promise<T>, policy?: Partial<RetryPolicy>, options?: {
+    deadline?: Deadline;
+    phase?: string;
+    signal?: AbortSignal;
+    classifyReason?: (error: unknown) => string | undefined;
+    onEvent?: (event: RetryTelemetryEvent) => void;
+}): Promise<T>;
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export {};

package/dist/src/utils/snapshot-lines.d.ts

@@ -0,0 +1,12 @@
+import type { SnapshotNode } from './snapshot.ts';
+type SnapshotDisplayLine = {
+    node: SnapshotNode;
+    depth: number;
+    type: string;
+    text: string;
+};
+export declare function buildSnapshotDisplayLines(nodes: SnapshotNode[]): SnapshotDisplayLine[];
+export declare function formatSnapshotLine(node: SnapshotNode, depth: number, hiddenGroup: boolean, normalizedType?: string): string;
+export declare function displayLabel(node: SnapshotNode, type: string): string;
+export declare function formatRole(type: string): string;
+export {};

package/dist/src/utils/snapshot.d.ts

@@ -0,0 +1,42 @@
+export type Rect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type SnapshotOptions = {
+    interactiveOnly?: boolean;
+    compact?: boolean;
+    depth?: number;
+    scope?: string;
+    raw?: boolean;
+};
+export type RawSnapshotNode = {
+    index: number;
+    type?: string;
+    label?: string;
+    value?: string;
+    identifier?: string;
+    rect?: Rect;
+    enabled?: boolean;
+    selected?: boolean;
+    hittable?: boolean;
+    depth?: number;
+    parentIndex?: number;
+};
+export type SnapshotNode = RawSnapshotNode & {
+    ref: string;
+};
+export type SnapshotState = {
+    nodes: SnapshotNode[];
+    createdAt: number;
+    truncated?: boolean;
+    backend?: 'xctest' | 'android';
+};
+export declare function attachRefs(nodes: RawSnapshotNode[]): SnapshotNode[];
+export declare function normalizeRef(input: string): string | null;
+export declare function findNodeByRef(nodes: SnapshotNode[], ref: string): SnapshotNode | null;
+export declare function centerOfRect(rect: Rect): {
+    x: number;
+    y: number;
+};

package/dist/src/utils/timeouts.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveTimeoutMs(raw: string | undefined, fallback: number, min: number): number;
+/** Alias for `resolveTimeoutMs` — semantically marks the caller expects seconds. */
+export declare const resolveTimeoutSeconds: typeof resolveTimeoutMs;

package/dist/src/utils/version.d.ts

@@ -0,0 +1,2 @@
+export declare function readVersion(): string;
+export declare function findProjectRoot(): string;

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "agent-device",
-  "version": "0.7.21",
+  "version": "0.7.22",
   "description": "Unified control plane for physical and virtual devices via an agent-driven CLI.",
   "license": "MIT",
   "author": "Callstack",
   "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
   "engines": {
     "node": ">=22"
   },

package/skills/agent-device/references/session-management.md

@@ -21,7 +21,7 @@ Sessions isolate device context. A device can only be held by one session at a t
 - On iOS, `appstate` is session-scoped and requires a matching active session on the target device.
 - For dev loops where runtime state can persist (for example React Native Fast Refresh), use `open <app> --relaunch` to restart the app process in the same session.
 - Use `--save-script [path]` to record replay scripts on `close`; path is a file path and parent directories are created automatically.
-- Use `close --shutdown` (iOS simulator only) to shut down the simulator as part of session teardown, preventing resource leakage in multi-tenant or CI workloads.
+- Use `close --shutdown` on iOS simulators or Android emulators to shut down the target as part of session teardown, preventing resource leakage in multi-tenant or CI workloads.
 - For ambiguous bare `--save-script` values, prefer `--save-script=workflow.ad` or `./workflow.ad`.
 - For deterministic replay scripts, prefer selector-based actions and assertions.
 - Use `replay -u` to update selector drift during maintenance.

package/dist/src/678.js

@@ -1,3 +0,0 @@
-import{AsyncLocalStorage as e}from"node:async_hooks";import t from"node:crypto";import r,{promises as n}from"node:fs";import o from"node:os";import i from"node:path";import{URL as a,fileURLToPath as s,pathToFileURL as c}from"node:url";import{spawn as l,spawnSync as d}from"node:child_process";let u=new e,f=/(token|secret|password|authorization|cookie|api[_-]?key|access[_-]?key|private[_-]?key)/i,m=/(bearer\s+[a-z0-9._-]+|(?:api[_-]?key|token|secret|password)\s*[=:]\s*\S+)/i;function p(){return t.randomBytes(8).toString("hex")}async function h(e,r){let n={...e,diagnosticId:`${Date.now().toString(36)}-${t.randomBytes(4).toString("hex")}`,events:[]};return await u.run(n,r)}function g(){let e=u.getStore();return e?{diagnosticId:e.diagnosticId,requestId:e.requestId,session:e.session,command:e.command,debug:e.debug}:{}}function w(e){let t=u.getStore();if(!t)return;let n={ts:new Date().toISOString(),level:e.level??"info",phase:e.phase,session:t.session,requestId:t.requestId,command:t.command,durationMs:e.durationMs,data:e.data?v(e.data):void 0};if(t.events.push(n),!t.debug)return;let o=`[agent-device][diag] ${JSON.stringify(n)}
-`;try{t.logPath&&r.appendFile(t.logPath,o,()=>{}),t.traceLogPath&&r.appendFile(t.traceLogPath,o,()=>{}),t.logPath||t.traceLogPath||process.stderr.write(o)}catch{}}async function S(e,t,r){let n=Date.now();try{let o=await t();return w({level:"info",phase:e,durationMs:Date.now()-n,data:r}),o}catch(t){throw w({level:"error",phase:e,durationMs:Date.now()-n,data:{...r??{},error:t instanceof Error?t.message:String(t)}}),t}}function y(e={}){let t=u.getStore();if(!t||!e.force&&!t.debug||0===t.events.length)return null;try{let e=(t.session??"default").replace(/[^a-zA-Z0-9._-]/g,"_"),n=new Date().toISOString().slice(0,10),a=i.join(o.homedir(),".agent-device","logs",e,n);r.mkdirSync(a,{recursive:!0});let s=new Date().toISOString().replace(/[:.]/g,"-"),c=i.join(a,`${s}-${t.diagnosticId}.ndjson`),l=t.events.map(e=>JSON.stringify(v(e)));return r.writeFileSync(c,`${l.join("\n")}
-`),t.events=[],c}catch{return null}}function v(e){return function e(t,r,n){if(null==t)return t;if("string"==typeof t){var o=t,i=n;let e=o.trim();if(!e)return o;if(i&&f.test(i)||m.test(e))return"[REDACTED]";let r=function(e){try{let t=new URL(e);return t.search&&(t.search="?REDACTED"),(t.username||t.password)&&(t.username="REDACTED",t.password="REDACTED"),t.toString()}catch{return null}}(e);return r||(e.length>400?`${e.slice(0,200)}...<truncated>`:e)}if("object"!=typeof t)return t;if(r.has(t))return"[Circular]";if(r.add(t),Array.isArray(t))return t.map(t=>e(t,r));let a={};for(let[n,o]of Object.entries(t)){if(f.test(n)){a[n]="[REDACTED]";continue}a[n]=e(o,r,n)}return a}(e,new WeakSet)}class A extends Error{code;details;cause;constructor(e,t,r,n){super(t),this.code=e,this.details=r,this.cause=n}}function I(e){return e instanceof A?e:e instanceof Error?new A("UNKNOWN",e.message,void 0,e):new A("UNKNOWN","Unknown error",{err:e})}function E(e,t={}){let r=I(e),n=r.details?v(r.details):void 0,o=n&&"string"==typeof n.hint?n.hint:void 0,i=(n&&"string"==typeof n.diagnosticId?n.diagnosticId:void 0)??t.diagnosticId,a=(n&&"string"==typeof n.logPath?n.logPath:void 0)??t.logPath,s=o??function(e){switch(e){case"INVALID_ARGS":return"Check command arguments and run --help for usage examples.";case"SESSION_NOT_FOUND":return"Run open first or pass an explicit device selector.";case"TOOL_MISSING":return"Install required platform tooling and ensure it is available in PATH.";case"DEVICE_NOT_FOUND":return"Verify the target device is booted/connected and selectors match.";case"UNSUPPORTED_OPERATION":return"This command is not available for the selected platform/device.";case"COMMAND_FAILED":default:return"Retry with --debug and inspect diagnostics log for details.";case"UNAUTHORIZED":return"Refresh daemon metadata and retry the command."}}(r.code),c=function(e){if(!e)return;let t={...e};return delete t.hint,delete t.diagnosticId,delete t.logPath,Object.keys(t).length>0?t:void 0}(n),l=function(e,t,r){if("COMMAND_FAILED"!==e||r?.processExitError!==!0)return t;let n=function(e){let t=[/^an error was encountered processing the command/i,/^underlying error\b/i,/^simulator device failed to complete the requested operation/i];for(let r of e.split("\n")){let e=r.trim();if(e&&!t.some(t=>t.test(e)))return e.length>200?`${e.slice(0,200)}...`:e}return null}("string"==typeof r?.stderr?r.stderr:"");return n||t}(r.code,r.message,n);return{code:r.code,message:l,hint:s,diagnosticId:i,logPath:a,details:c}}let D="<wifi|airplane|location> <on|off>",$="appearance <light|dark|toggle>",b="faceid <match|nonmatch|enroll|unenroll>",N="touchid <match|nonmatch|enroll|unenroll>",_="fingerprint <match|nonmatch>",M="permission <grant|deny|reset> <camera|microphone|photos|contacts|contacts-limited|notifications|calendar|location|location-always|media-library|motion|reminders|siri> [full|limited]",L=`settings ${D} | settings ${$} | settings ${b} | settings ${N} | settings ${_} | settings ${M}`,T=`settings requires ${D}, ${$}, ${b}, ${N}, ${_}, or ${M}`;function O(e){let t=[],r=[];for(let n of e){let e=n.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let o=n.label?.trim()||n.value?.trim()||n.identifier?.trim()||"",i=P(n.type??"Element"),a="group"===i&&!o;a&&t.push(e);let s=a?e:Math.max(0,e-t.length);r.push({node:n,depth:s,type:i,text:x(n,s,a,i)})}return r}function x(e,t,r,n){let o=n??P(e.type??"Element"),i=C(e,o),a="  ".repeat(t),s=e.ref?`@${e.ref}`:"",c=[!1===e.enabled?"disabled":null].filter(Boolean).join(", "),l=c?` [${c}]`:"",d=i?` "${i}"`:"";return r?`${a}${s} [${o}]${l}`.trimEnd():`${a}${s} [${o}]${d}${l}`.trimEnd()}function C(e,t){var r,n;let o=e.label?.trim(),i=e.value?.trim();if("text-field"===(r=t)||"text-view"===r||"search"===r){if(i)return i;if(o)return o}else if(o)return o;if(i)return i;let a=e.identifier?.trim();return!a||(n=a,/^[\w.]+:id\/[\w.-]+$/i.test(n)&&("group"===t||"image"===t||"list"===t||"collection"===t))?"":a}function P(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),r=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,"")),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return r?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}function R(){try{let e=k();return JSON.parse(r.readFileSync(i.join(e,"package.json"),"utf8")).version??"0.0.0"}catch{return"0.0.0"}}function k(){let e=i.dirname(s(import.meta.url)),t=e;for(let e=0;e<6;e+=1){let e=i.join(t,"package.json");if(r.existsSync(e))return t;t=i.dirname(t)}return e}async function F(e,t,r={}){return new Promise((n,o)=>{let i=l(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],detached:r.detached}),a="",s=r.binaryStdout?Buffer.alloc(0):void 0,c="",d=!1,u=q(r.timeoutMs),f=u?setTimeout(()=>{d=!0,i.kill("SIGKILL")},u):null;r.binaryStdout||i.stdout.setEncoding("utf8"),i.stderr.setEncoding("utf8"),void 0!==r.stdin&&i.stdin.write(r.stdin),i.stdin.end(),i.stdout.on("data",e=>{r.binaryStdout?s=Buffer.concat([s??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]):a+=e}),i.stderr.on("data",e=>{c+=e}),i.on("error",r=>{(f&&clearTimeout(f),"ENOENT"===r.code)?o(new A("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):o(new A("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),i.on("close",i=>{f&&clearTimeout(f);let l=i??1;d&&u?o(new A("COMMAND_FAILED",`${e} timed out after ${u}ms`,{cmd:e,args:t,stdout:a,stderr:c,exitCode:l,timeoutMs:u})):0===l||r.allowFailure?n({stdout:a,stderr:c,exitCode:l,stdoutBuffer:s}):o(new A("COMMAND_FAILED",`${e} exited with code ${l}`,{cmd:e,args:t,stdout:a,stderr:c,exitCode:l,processExitError:!0}))})})}async function B(e){try{var t;let{shell:r,args:n}=(t=e,"win32"===process.platform?{shell:"cmd.exe",args:["/c","where",t]}:{shell:"bash",args:["-lc",`command -v ${t}`]}),o=await F(r,n,{allowFailure:!0});return 0===o.exitCode&&o.stdout.trim().length>0}catch{return!1}}function j(e,t,r={}){let n=d(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],encoding:r.binaryStdout?void 0:"utf8",input:r.stdin,timeout:q(r.timeoutMs)});if(n.error){let o=n.error.code;if("ETIMEDOUT"===o)throw new A("COMMAND_FAILED",`${e} timed out after ${q(r.timeoutMs)}ms`,{cmd:e,args:t,timeoutMs:q(r.timeoutMs)},n.error);if("ENOENT"===o)throw new A("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n.error);throw new A("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n.error)}let o=r.binaryStdout?Buffer.isBuffer(n.stdout)?n.stdout:Buffer.from(n.stdout??""):void 0,i=r.binaryStdout?"":"string"==typeof n.stdout?n.stdout:(n.stdout??"").toString(),a="string"==typeof n.stderr?n.stderr:(n.stderr??"").toString(),s=n.status??1;if(0!==s&&!r.allowFailure)throw new A("COMMAND_FAILED",`${e} exited with code ${s}`,{cmd:e,args:t,stdout:i,stderr:a,exitCode:s,processExitError:!0});return{stdout:i,stderr:a,exitCode:s,stdoutBuffer:o}}function G(e,t,r={}){l(e,t,{cwd:r.cwd,env:r.env,stdio:"ignore",detached:!0}).unref()}async function U(e,t,r={}){return new Promise((n,o)=>{let i=l(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],detached:r.detached});r.onSpawn?.(i);let a="",s="",c=r.binaryStdout?Buffer.alloc(0):void 0;r.binaryStdout||i.stdout.setEncoding("utf8"),i.stderr.setEncoding("utf8"),void 0!==r.stdin&&i.stdin.write(r.stdin),i.stdin.end(),i.stdout.on("data",e=>{if(r.binaryStdout){c=Buffer.concat([c??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]);return}let t=String(e);a+=t,r.onStdoutChunk?.(t)}),i.stderr.on("data",e=>{let t=String(e);s+=t,r.onStderrChunk?.(t)}),i.on("error",r=>{"ENOENT"===r.code?o(new A("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):o(new A("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),i.on("close",i=>{let l=i??1;0===l||r.allowFailure?n({stdout:a,stderr:s,exitCode:l,stdoutBuffer:c}):o(new A("COMMAND_FAILED",`${e} exited with code ${l}`,{cmd:e,args:t,stdout:a,stderr:s,exitCode:l,processExitError:!0}))})})}function V(e,t,r={}){let n=l(e,t,{cwd:r.cwd,env:r.env,stdio:["ignore","pipe","pipe"],detached:r.detached}),o="",i="";n.stdout.setEncoding("utf8"),n.stderr.setEncoding("utf8"),n.stdout.on("data",e=>{o+=e}),n.stderr.on("data",e=>{i+=e});let a=new Promise((a,s)=>{n.on("error",r=>{"ENOENT"===r.code?s(new A("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):s(new A("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),n.on("close",n=>{let c=n??1;0===c||r.allowFailure?a({stdout:o,stderr:i,exitCode:c}):s(new A("COMMAND_FAILED",`${e} exited with code ${c}`,{cmd:e,args:t,stdout:o,stderr:i,exitCode:c,processExitError:!0}))})});return{child:n,wait:a}}function q(e){if(!Number.isFinite(e))return;let t=Math.floor(e);if(!(t<=0))return t}let H=[/(^|[\/\s"'=])dist\/src\/daemon\.js($|[\s"'])/,/(^|[\/\s"'=])src\/daemon\.ts($|[\s"'])/];function z(e){if(!Number.isInteger(e)||e<=0)return!1;try{return process.kill(e,0),!0}catch(e){return"EPERM"===e.code}}function J(e){if(!Number.isInteger(e)||e<=0)return null;try{let t=j("ps",["-p",String(e),"-o","lstart="],{allowFailure:!0,timeoutMs:1e3});if(0!==t.exitCode)return null;let r=t.stdout.trim();return r.length>0?r:null}catch{return null}}function W(e){if(!Number.isInteger(e)||e<=0)return null;try{let t=j("ps",["-p",String(e),"-o","command="],{allowFailure:!0,timeoutMs:1e3});if(0!==t.exitCode)return null;let r=t.stdout.trim();return r.length>0?r:null}catch{return null}}function K(e,t){let r;if(!z(e))return!1;if(t){let r=J(e);if(!r||r!==t)return!1}let n=W(e);return!!n&&!!(r=n.toLowerCase().replaceAll("\\","/")).includes("agent-device")&&H.some(e=>e.test(r))}function Z(e,t){try{return process.kill(e,t),!0}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return!1;throw t}}async function X(e,t){if(!z(e))return!0;let r=Date.now();for(;Date.now()-r<t;)if(await new Promise(e=>setTimeout(e,50)),!z(e))return!0;return!z(e)}async function Q(e,t){!K(e,t.expectedStartTime)||!Z(e,"SIGTERM")||await X(e,t.termTimeoutMs)||Z(e,"SIGKILL")&&await X(e,t.killTimeoutMs)}function Y(e){let t,r=(t=(e??"").trim())?"~"===t?o.homedir():t.startsWith("~/")?i.join(o.homedir(),t.slice(2)):i.resolve(t):i.join(o.homedir(),".agent-device");return{baseDir:r,infoPath:i.join(r,"daemon.json"),lockPath:i.join(r,"daemon.lock"),logPath:i.join(r,"daemon.log"),sessionsDir:i.join(r,"sessions")}}function ee(e){let t=(e??"").trim().toLowerCase();return"http"===t?"http":"dual"===t?"dual":"socket"}function et(e){let t=(e??"").trim().toLowerCase();return"auto"===t?"auto":"socket"===t?"socket":"http"===t?"http":"auto"}function er(e){return"tenant"===(e??"").trim().toLowerCase()?"tenant":"none"}function en(e){if(!e)return;let t=e.trim();if(t&&/^[a-zA-Z0-9._-]{1,128}$/.test(t))return t}let eo=100,ei=new Set(["batch","replay"]);function ea(e){let t;try{t=JSON.parse(e)}catch{throw new A("INVALID_ARGS","Batch steps must be valid JSON.")}if(!Array.isArray(t)||0===t.length)throw new A("INVALID_ARGS","Batch steps must be a non-empty JSON array.");return t}function es(e,t){if(!Array.isArray(e)||0===e.length)throw new A("INVALID_ARGS","batch requires a non-empty batchSteps array.");if(e.length>t)throw new A("INVALID_ARGS",`batch has ${e.length} steps; max allowed is ${t}.`);let r=[];for(let t=0;t<e.length;t+=1){let n=e[t];if(!n||"object"!=typeof n)throw new A("INVALID_ARGS",`Invalid batch step at index ${t}.`);let o="string"==typeof n.command?n.command.trim().toLowerCase():"";if(!o)throw new A("INVALID_ARGS",`Batch step ${t+1} requires command.`);if(ei.has(o))throw new A("INVALID_ARGS",`Batch step ${t+1} cannot run ${o}.`);if(void 0!==n.positionals&&!Array.isArray(n.positionals))throw new A("INVALID_ARGS",`Batch step ${t+1} positionals must be an array.`);let i=n.positionals??[];if(i.some(e=>"string"!=typeof e))throw new A("INVALID_ARGS",`Batch step ${t+1} positionals must contain only strings.`);if(void 0!==n.flags&&("object"!=typeof n.flags||Array.isArray(n.flags)||!n.flags))throw new A("INVALID_ARGS",`Batch step ${t+1} flags must be an object.`);r.push({command:o,positionals:i,flags:n.flags??{}})}return r}export{default as node_net}from"node:net";export{default as node_http}from"node:http";export{A as AppError,eo as DEFAULT_BATCH_MAX_STEPS,T as SETTINGS_INVALID_ARGS_MESSAGE,L as SETTINGS_USAGE_OVERRIDE,I as asAppError,O as buildSnapshotDisplayLines,p as createRequestId,C as displayLabel,w as emitDiagnostic,a as external_node_url_URL,s as fileURLToPath,k as findProjectRoot,y as flushDiagnosticsToSessionFile,P as formatRole,x as formatSnapshotLine,g as getDiagnosticsMeta,K as isAgentDeviceDaemonProcess,z as isProcessAlive,t as node_crypto,r as node_fs,o as node_os,i as node_path,E as normalizeError,en as normalizeTenantId,ea as parseBatchStepsJson,c as pathToFileURL,n as promises,W as readProcessCommand,J as readProcessStartTime,R as readVersion,Y as resolveDaemonPaths,ee as resolveDaemonServerMode,et as resolveDaemonTransportPreference,er as resolveSessionIsolationMode,F as runCmd,V as runCmdBackground,G as runCmdDetached,U as runCmdStreaming,j as runCmdSync,l as spawn,Q as stopProcessForTakeover,es as validateAndNormalizeBatchSteps,B as whichCmd,S as withDiagnosticTimer,h as withDiagnosticsScope};