agent-device 0.10.2 → 0.11.0

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

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

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

@@ -1,30 +0,0 @@
-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

@@ -1,26 +0,0 @@
-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

@@ -1,32 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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/interactors.d.ts

@@ -1,38 +0,0 @@
-import type { DeviceInfo } from './device.ts';
-import type { PermissionSettingOptions } from '../platforms/permission-utils.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<Record<string, unknown> | void>;
-    doubleTap(x: number, y: number): Promise<Record<string, unknown> | void>;
-    swipe(x1: number, y1: number, x2: number, y2: number, durationMs?: number): Promise<Record<string, unknown> | void>;
-    longPress(x: number, y: number, durationMs?: number): Promise<Record<string, unknown> | void>;
-    focus(x: number, y: number): Promise<Record<string, unknown> | void>;
-    type(text: string): Promise<void>;
-    fill(x: number, y: number, text: string): Promise<Record<string, unknown> | void>;
-    scroll(direction: string, amount?: number): Promise<Record<string, unknown> | void>;
-    scrollIntoView(text: string): Promise<{
-        attempts?: number;
-    } | void>;
-    screenshot(outPath: string, appBundleId?: string): Promise<void>;
-    back(): Promise<void>;
-    home(): Promise<void>;
-    appSwitcher(): Promise<void>;
-    readClipboard(): Promise<string>;
-    writeClipboard(text: string): Promise<void>;
-    setSetting(setting: string, state: string, appId?: string, options?: PermissionSettingOptions): Promise<Record<string, unknown> | void>;
-};
-export declare function getInteractor(device: DeviceInfo, runnerContext: RunnerContext): Interactor;
-export {};

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

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

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

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

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

@@ -1,27 +0,0 @@
-import { AppError, type NormalizedError } from './errors.ts';
-import type { ScreenshotDiffResult } from './screenshot-diff.ts';
-type JsonResult = {
-    success: true;
-    data?: 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 declare function formatScreenshotDiffText(data: ScreenshotDiffResult): string;
-export {};

package/dist/src/utils/path-resolution.d.ts

@@ -1,8 +0,0 @@
-type EnvMap = Record<string, string | undefined>;
-type PathResolutionOptions = {
-    cwd?: string;
-    env?: EnvMap;
-};
-export declare function expandUserHomePath(inputPath: string, options?: PathResolutionOptions): string;
-export declare function resolveUserPath(inputPath: string, options?: PathResolutionOptions): string;
-export {};

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

@@ -1,12 +0,0 @@
-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

@@ -1,11 +0,0 @@
-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/remote-config.d.ts

@@ -1,15 +0,0 @@
-import type { CliFlags } from './command-schema.ts';
-type EnvMap = Record<string, string | undefined>;
-export declare const REMOTE_OPEN_FLAG_KEYS: readonly ["remoteConfig", "session", "platform", "daemonBaseUrl", "daemonAuthToken", "daemonTransport", "metroProjectRoot", "metroKind", "metroPublicBaseUrl", "metroProxyBaseUrl", "metroBearerToken", "metroPreparePort", "metroListenHost", "metroStatusHost", "metroStartupTimeoutMs", "metroProbeTimeoutMs", "metroRuntimeFile", "metroNoReuseExisting", "metroNoInstallDeps"];
-export declare function loadRemoteConfigFile(options: {
-    configPath: string;
-    cwd: string;
-    env?: EnvMap;
-}): Partial<CliFlags>;
-export declare function resolveRemoteConfigDefaults(options: {
-    cliFlags: CliFlags;
-    cwd: string;
-    env: EnvMap;
-}): Partial<CliFlags>;
-export declare function pickRemoteOpenDefaults(defaultFlags: Partial<CliFlags>): Partial<CliFlags>;
-export {};

package/dist/src/utils/remote-open.d.ts

@@ -1,9 +0,0 @@
-import type { AgentDeviceClient } from '../client.ts';
-import type { CliFlags } from './command-schema.ts';
-export declare function resolveRemoteOpenRuntime(flags: CliFlags, client: AgentDeviceClient): Promise<{
-    platform?: 'ios' | 'android';
-    metroHost?: string;
-    metroPort?: number;
-    bundleUrl?: string;
-    launchUrl?: string;
-} | undefined>;

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

@@ -1,54 +0,0 @@
-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/screenshot-diff.d.ts

@@ -1,23 +0,0 @@
-export type ScreenshotDimensionMismatch = {
-    expected: {
-        width: number;
-        height: number;
-    };
-    actual: {
-        width: number;
-        height: number;
-    };
-};
-export type ScreenshotDiffResult = {
-    diffPath?: string;
-    totalPixels: number;
-    differentPixels: number;
-    mismatchPercentage: number;
-    match: boolean;
-    dimensionMismatch?: ScreenshotDimensionMismatch;
-};
-export type ScreenshotDiffOptions = {
-    threshold?: number;
-    outputPath?: string;
-};
-export declare function compareScreenshots(baselinePath: string, currentPath: string, options?: ScreenshotDiffOptions): Promise<ScreenshotDiffResult>;

package/dist/src/utils/session-binding.d.ts

@@ -1,18 +0,0 @@
-import type { CliFlags } from './command-schema.ts';
-import type { DaemonLockPolicy } from '../daemon/types.ts';
-export type BindingSettings = {
-    defaultPlatform?: CliFlags['platform'];
-    lockPolicy?: DaemonLockPolicy;
-};
-type BindingPolicyOverrides = Pick<Partial<CliFlags>, 'sessionLock' | 'sessionLocked' | 'sessionLockConflicts'>;
-type LockableFlags = Pick<Partial<CliFlags>, 'platform' | 'target' | 'device' | 'udid' | 'serial' | 'iosSimulatorDeviceSet' | 'androidDeviceAllowlist'>;
-type BindingOptions = {
-    env?: NodeJS.ProcessEnv;
-    policyOverrides?: BindingPolicyOverrides;
-    configuredPlatform?: CliFlags['platform'];
-    configuredSession?: string;
-    inheritedPlatform?: CliFlags['platform'];
-};
-export declare function applyDefaultPlatformBinding<T extends LockableFlags>(flags: T, options?: BindingOptions): T;
-export declare function resolveBindingSettings(options: BindingOptions): BindingSettings;
-export {};

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

@@ -1,15 +0,0 @@
-import type { SnapshotNode } from './snapshot.ts';
-type SnapshotDisplayLine = {
-    node: SnapshotNode;
-    depth: number;
-    type: string;
-    text: string;
-};
-type SnapshotLineFormatOptions = {
-    summarizeTextSurfaces?: boolean;
-};
-export declare function buildSnapshotDisplayLines(nodes: SnapshotNode[], options?: SnapshotLineFormatOptions): SnapshotDisplayLine[];
-export declare function formatSnapshotLine(node: SnapshotNode, depth: number, hiddenGroup: boolean, normalizedType?: string, options?: SnapshotLineFormatOptions): 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

@@ -1,49 +0,0 @@
-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;
-    role?: string;
-    subrole?: string;
-    label?: string;
-    value?: string;
-    identifier?: string;
-    rect?: Rect;
-    enabled?: boolean;
-    selected?: boolean;
-    hittable?: boolean;
-    depth?: number;
-    parentIndex?: number;
-    pid?: number;
-    bundleId?: string;
-    appName?: string;
-    windowTitle?: string;
-    surface?: string;
-};
-export type SnapshotNode = RawSnapshotNode & {
-    ref: string;
-};
-export type SnapshotState = {
-    nodes: SnapshotNode[];
-    createdAt: number;
-    truncated?: boolean;
-    backend?: 'xctest' | 'android' | 'macos-helper';
-};
-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/text-surface.d.ts

@@ -1,19 +0,0 @@
-type TextSurfaceNode = {
-    type?: string;
-    label?: string;
-    value?: string;
-    identifier?: string;
-    role?: string;
-    subrole?: string;
-};
-export declare function extractReadableText(node: TextSurfaceNode): string;
-export declare function isLargeTextSurface(node: TextSurfaceNode, displayType?: string): boolean;
-export declare function buildTextPreview(text: string): string;
-export declare function describeTextSurface(node: TextSurfaceNode, displayType?: string): {
-    text: string;
-    isLargeSurface: boolean;
-    shouldSummarize: boolean;
-};
-export declare function shouldSummarizeTextSurface(text: string): boolean;
-export declare function trimText(value: unknown): string;
-export {};

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

@@ -1,3 +0,0 @@
-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

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

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

@@ -1,9 +0,0 @@
-export declare function waitForStableFile(filePath: string, options?: {
-    pollMs?: number;
-    attempts?: number;
-}): Promise<void>;
-export declare function isPlayableVideo(filePath: string): Promise<boolean>;
-export declare function waitForPlayableVideo(filePath: string, options?: {
-    pollMs?: number;
-    attempts?: number;
-}): Promise<void>;