agent-device 0.14.3 → 0.14.4

package/dist/src/daemon-embedding.d.ts

@@ -1,632 +0,0 @@
-import { ChildProcess } from 'node:child_process';
-import { spawn } from 'node:child_process';
-import { SpawnOptions } from 'node:child_process';
-
-export declare type AdmissionRequest = {
-    tenantId: string | undefined;
-    runId: string | undefined;
-    leaseId: string | undefined;
-    backend?: LeaseBackend;
-};
-
-export declare type AllocateLeaseRequest = {
-    tenantId: string;
-    runId: string;
-    backend?: LeaseBackend;
-    ttlMs?: number;
-};
-
-/**
- * Runs device-scoped adb arguments after the device serial has already been selected.
- * Implementations must be safe to call concurrently for one request.
- */
-export declare type AndroidAdbExecutor = (args: string[], options?: AndroidAdbExecutorOptions) => Promise<AndroidAdbExecutorResult>;
-
-export declare type AndroidAdbExecutorOptions = Pick<ExecOptions, 'allowFailure' | 'timeoutMs' | 'binaryStdout' | 'stdin' | 'signal'>;
-
-export declare type AndroidAdbExecutorResult = Pick<ExecResult, 'exitCode' | 'stdout' | 'stderr' | 'stdoutBuffer'>;
-
-export declare type AndroidAdbProvider = {
-    exec: AndroidAdbExecutor;
-    spawn?: AndroidAdbSpawner;
-};
-
-export declare type AndroidAdbProviderResolver = (params: {
-    req: DaemonRequest;
-    device: DeviceInfo;
-    session?: SessionState;
-}) => AndroidAdbProvider | AndroidAdbExecutor | undefined;
-
-declare type AndroidAdbSpawner = (args: string[], options?: SpawnOptions) => ChildProcess;
-
-declare type AndroidSnapshotFreshness = {
-    action: string;
-    markedAt: number;
-    baselineCount: number;
-    baselineSignatures?: string[];
-    routeComparable: boolean;
-};
-
-declare type ApplePlatform = 'ios' | 'macos';
-
-declare type AppLogState = 'active' | 'recovering' | 'failed';
-
-declare type BatchStep = {
-    command: string;
-    positionals?: string[];
-    flags?: Partial<CommandFlags>;
-    runtime?: unknown;
-};
-
-export declare function cleanupDownloadableArtifact(artifactId: string): void;
-
-export declare function cleanupUploadedArtifact(uploadId: string): void;
-
-declare type CliFlags = {
-    json: boolean;
-    config?: string;
-    remoteConfig?: string;
-    stateDir?: string;
-    daemonBaseUrl?: string;
-    daemonAuthToken?: string;
-    daemonTransport?: 'auto' | 'socket' | 'http';
-    daemonServerMode?: 'socket' | 'http' | 'dual';
-    tenant?: string;
-    sessionIsolation?: 'none' | 'tenant';
-    runId?: string;
-    leaseId?: string;
-    leaseBackend?: 'ios-simulator' | 'ios-instance' | 'android-instance';
-    force?: boolean;
-    noLogin?: boolean;
-    sessionLock?: 'reject' | 'strip';
-    sessionLocked?: boolean;
-    sessionLockConflicts?: 'reject' | 'strip';
-    platform?: 'ios' | 'macos' | 'android' | 'linux' | 'apple';
-    target?: 'mobile' | 'tv' | 'desktop';
-    device?: string;
-    udid?: string;
-    serial?: string;
-    iosSimulatorDeviceSet?: string;
-    androidDeviceAllowlist?: string;
-    out?: string;
-    session?: string;
-    runtime?: string;
-    metroHost?: string;
-    metroPort?: number;
-    metroProjectRoot?: string;
-    metroKind?: 'auto' | 'react-native' | 'expo';
-    metroPublicBaseUrl?: string;
-    metroProxyBaseUrl?: string;
-    metroBearerToken?: string;
-    metroPreparePort?: number;
-    metroListenHost?: string;
-    metroStatusHost?: string;
-    metroStartupTimeoutMs?: number;
-    metroProbeTimeoutMs?: number;
-    metroRuntimeFile?: string;
-    metroNoReuseExisting?: boolean;
-    metroNoInstallDeps?: boolean;
-    bundleUrl?: string;
-    launchUrl?: string;
-    boot?: boolean;
-    reuseExisting?: boolean;
-    verbose?: boolean;
-    snapshotInteractiveOnly?: boolean;
-    snapshotDiff?: boolean;
-    snapshotCompact?: boolean;
-    snapshotDepth?: number;
-    snapshotScope?: string;
-    snapshotRaw?: boolean;
-    networkInclude?: 'summary' | 'headers' | 'body' | 'all';
-    overlayRefs?: boolean;
-    screenshotFullscreen?: boolean;
-    screenshotMaxSize?: number;
-    baseline?: string;
-    threshold?: string;
-    appsFilter?: 'user-installed' | 'all';
-    count?: number;
-    fps?: number;
-    quality?: number;
-    hideTouches?: boolean;
-    intervalMs?: number;
-    delayMs?: number;
-    holdMs?: number;
-    jitterPx?: number;
-    pixels?: number;
-    doubleTap?: boolean;
-    clickButton?: 'primary' | 'secondary' | 'middle';
-    backMode?: 'in-app' | 'system';
-    pauseMs?: number;
-    pattern?: 'one-way' | 'ping-pong';
-    activity?: string;
-    header?: string[];
-    githubActionsArtifact?: string;
-    installSource?: DaemonInstallSource_2;
-    saveScript?: boolean | string;
-    shutdown?: boolean;
-    relaunch?: boolean;
-    surface?: 'app' | 'frontmost-app' | 'desktop' | 'menubar';
-    headless?: boolean;
-    restart?: boolean;
-    noRecord?: boolean;
-    retainPaths?: boolean;
-    retentionMs?: number;
-    replayUpdate?: boolean;
-    replayEnv?: string[];
-    replayShellEnv?: Record<string, string>;
-    failFast?: boolean;
-    timeoutMs?: number;
-    retries?: number;
-    artifactsDir?: string;
-    reportJunit?: string;
-    steps?: string;
-    stepsFile?: string;
-    findFirst?: boolean;
-    findLast?: boolean;
-    batchOnError?: 'stop';
-    batchMaxSteps?: number;
-    batchSteps?: Array<{
-        command: string;
-        positionals?: string[];
-        flags?: Record<string, unknown>;
-    }>;
-    help: boolean;
-    version: boolean;
-};
-
-declare type CommandFlags = Omit<CliFlags, 'json' | 'help' | 'version' | 'batchSteps'> & {
-    batchSteps?: BatchStep[];
-};
-
-export declare function createRequestHandler(deps: RequestRouterDeps): (req: DaemonRequest) => Promise<DaemonResponse>;
-
-export declare type DaemonArtifact = DaemonArtifact_2;
-
-declare type DaemonArtifact_2 = {
-    field: string;
-    artifactId?: string;
-    fileName?: string;
-    localPath?: string;
-    path?: string;
-};
-
-declare type DaemonError = {
-    code: string;
-    message: string;
-    hint?: string;
-    diagnosticId?: string;
-    logPath?: string;
-    details?: Record<string, unknown>;
-};
-
-export declare type DaemonInstallSource = DaemonInstallSource_2;
-
-declare type DaemonInstallSource_2 = {
-    kind: 'url';
-    url: string;
-    headers?: Record<string, string>;
-} | {
-    kind: 'path';
-    path: string;
-} | ({
-    kind: 'github-actions-artifact';
-    owner: string;
-    repo: string;
-} & ({
-    artifactId: number;
-} | {
-    runId: number;
-    artifactName: string;
-} | {
-    artifactName: string;
-}));
-
-declare type DaemonLockPolicy = 'reject' | 'strip';
-
-export declare type DaemonRequest = Omit<DaemonRequest_2, 'token' | 'session' | 'flags' | 'meta'> & {
-    token: string;
-    session: string;
-    flags?: CommandFlags;
-    meta?: DaemonRequestMeta_2;
-};
-
-declare type DaemonRequest_2 = {
-    token?: string;
-    session?: string;
-    command: string;
-    positionals: string[];
-    flags?: Record<string, unknown>;
-    runtime?: SessionRuntimeHints_2;
-    meta?: DaemonRequestMeta;
-};
-
-declare type DaemonRequestMeta = {
-    requestId?: string;
-    debug?: boolean;
-    cwd?: string;
-    tenantId?: string;
-    runId?: string;
-    leaseId?: string;
-    leaseTtlMs?: number;
-    leaseBackend?: LeaseBackend;
-    sessionIsolation?: 'none' | 'tenant';
-    uploadedArtifactId?: string;
-    clientArtifactPaths?: Record<string, string>;
-    installSource?: DaemonInstallSource_2;
-    retainMaterializedPaths?: boolean;
-    materializedPathRetentionMs?: number;
-    materializationId?: string;
-    lockPolicy?: DaemonLockPolicy;
-    lockPlatform?: 'ios' | 'macos' | 'android' | 'linux' | 'apple';
-};
-
-declare type DaemonRequestMeta_2 = Omit<DaemonRequestMeta, 'installSource' | 'lockPlatform'> & {
-    installSource?: DaemonInstallSource;
-    lockPlatform?: PlatformSelector;
-    leaseBackend?: LeaseBackend;
-};
-
-export declare type DaemonResponse = DaemonResponse_2;
-
-declare type DaemonResponse_2 = {
-    ok: true;
-    data?: DaemonResponseData_2;
-} | {
-    ok: false;
-    error: DaemonError;
-};
-
-export declare type DaemonResponseData = DaemonResponseData_2;
-
-declare type DaemonResponseData_2 = Record<string, unknown> & {
-    artifacts?: DaemonArtifact_2[];
-};
-
-export declare type DeviceInfo = {
-    platform: Platform;
-    id: string;
-    name: string;
-    kind: DeviceKind;
-    target?: DeviceTarget;
-    booted?: boolean;
-    simulatorSetPath?: string;
-};
-
-export declare type DeviceInventoryProvider = (request: DeviceInventoryRequest) => Promise<DeviceInfo[] | null | undefined>;
-
-export declare type DeviceInventoryRequest = {
-    platform?: PlatformSelector;
-    target?: DeviceTarget;
-    deviceName?: string;
-    udid?: string;
-    serial?: string;
-    iosSimulatorSetPath?: string;
-    androidSerialAllowlist?: string[];
-};
-
-declare type DeviceKind = 'simulator' | 'emulator' | 'device';
-
-declare type DeviceTarget = 'mobile' | 'tv' | 'desktop';
-
-declare type ExecOptions = {
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    allowFailure?: boolean;
-    binaryStdout?: boolean;
-    stdin?: string | Buffer;
-    timeoutMs?: number;
-    detached?: boolean;
-    signal?: AbortSignal;
-};
-
-declare type ExecResult = {
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-    stdoutBuffer?: Buffer;
-};
-
-export declare type HeartbeatLeaseRequest = {
-    leaseId: string;
-    tenantId?: string;
-    runId?: string;
-    ttlMs?: number;
-};
-
-declare type LeaseBackend = 'ios-simulator' | 'ios-instance' | 'android-instance';
-
-export declare class LeaseRegistry {
-    private readonly leases;
-    private readonly runBindings;
-    private readonly maxActiveSimulatorLeases;
-    private readonly defaultLeaseTtlMs;
-    private readonly minLeaseTtlMs;
-    private readonly maxLeaseTtlMs;
-    private readonly now;
-    constructor(options?: LeaseRegistryOptions);
-    allocateLease(request: AllocateLeaseRequest): SimulatorLease;
-    heartbeatLease(request: HeartbeatLeaseRequest): SimulatorLease;
-    releaseLease(request: ReleaseLeaseRequest): {
-        released: boolean;
-    };
-    assertLeaseAdmission(request: AdmissionRequest): void;
-    listActiveLeases(): SimulatorLease[];
-    private cleanupExpiredLeases;
-    private enforceCapacity;
-    private resolveLeaseTtlMs;
-    private refreshLease;
-    private bindingKey;
-    private assertOptionalScopeMatch;
-}
-
-export declare type LeaseRegistryOptions = {
-    maxActiveSimulatorLeases?: number;
-    defaultLeaseTtlMs?: number;
-    minLeaseTtlMs?: number;
-    maxLeaseTtlMs?: number;
-    now?: () => number;
-};
-
-export declare type Platform = ApplePlatform | 'android' | 'linux';
-
-export declare type PlatformSelector = Platform | 'apple';
-
-export declare function prepareDownloadableArtifact(artifactId: string, tenantId?: string): {
-    artifactPath: string;
-    fileName?: string;
-    deleteAfterDownload: boolean;
-};
-
-export declare function prepareUploadedArtifact(uploadId: string, tenantId?: string): string;
-
-declare 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;
-    hiddenContentAbove?: boolean;
-    hiddenContentBelow?: boolean;
-};
-
-declare type RecordingGestureEvent = (RecordingTelemetryBase & {
-    kind: 'tap' | 'longpress';
-    durationMs?: number;
-}) | (RecordingTelemetryTravel & {
-    kind: 'swipe';
-}) | (RecordingTelemetryTravel & {
-    kind: 'scroll';
-    contentDirection: 'up' | 'down' | 'left' | 'right';
-    amount?: number;
-    pixels?: number;
-}) | (RecordingTelemetryTravel & {
-    kind: 'back-swipe';
-    edge: 'left' | 'right';
-}) | (RecordingTelemetryBase & {
-    kind: 'pinch';
-    scale: number;
-    durationMs: number;
-});
-
-declare type RecordingTelemetryBase = {
-    tMs: number;
-    x: number;
-    y: number;
-    referenceWidth?: number;
-    referenceHeight?: number;
-};
-
-declare type RecordingTelemetryTravel = RecordingTelemetryBase & {
-    x2: number;
-    y2: number;
-    durationMs: number;
-};
-
-declare type Rect = {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-};
-
-export declare type ReleaseLeaseRequest = {
-    leaseId: string;
-    tenantId?: string;
-    runId?: string;
-};
-
-export declare type RequestRouterDeps = {
-    logPath: string;
-    token: string;
-    sessionStore: SessionStore;
-    leaseRegistry: LeaseRegistry;
-    androidAdbProvider?: AndroidAdbProviderResolver;
-    deviceInventoryProvider?: DeviceInventoryProvider;
-    trackDownloadableArtifact: (opts: {
-        artifactPath: string;
-        tenantId?: string;
-        fileName?: string;
-    }) => string;
-};
-
-declare type SessionAction = {
-    ts: number;
-    command: string;
-    positionals: string[];
-    runtime?: SessionRuntimeHints;
-    flags: Partial<CommandFlags> & {
-        snapshotInteractiveOnly?: boolean;
-        snapshotCompact?: boolean;
-        snapshotDepth?: number;
-        snapshotScope?: string;
-        snapshotRaw?: boolean;
-        saveScript?: boolean | string;
-        noRecord?: boolean;
-    };
-    result?: Record<string, unknown>;
-};
-
-declare type SessionRecordingBase = {
-    outPath: string;
-    clientOutPath?: string;
-    telemetryPath?: string;
-    overlayWarning?: string;
-    startedAt: number;
-    quality?: number;
-    showTouches: boolean;
-    gestureEvents: RecordingGestureEvent[];
-    touchReferenceFrame?: {
-        referenceWidth: number;
-        referenceHeight: number;
-    };
-    gestureClockOriginAtMs?: number;
-    gestureClockOriginUptimeMs?: number;
-    runnerSessionId?: string;
-    invalidatedReason?: string;
-};
-
-export declare type SessionRuntimeHints = SessionRuntimeHints_2;
-
-declare type SessionRuntimeHints_2 = {
-    platform?: 'ios' | 'android';
-    metroHost?: string;
-    metroPort?: number;
-    bundleUrl?: string;
-    launchUrl?: string;
-};
-
-export declare type SessionState = {
-    name: string;
-    device: DeviceInfo;
-    createdAt: number;
-    surface?: SessionSurface;
-    appBundleId?: string;
-    appName?: string;
-    snapshot?: SnapshotState;
-    /** Source snapshot used to resolve repeated `snapshot -s @ref` after scoped output replaces refs. */
-    snapshotScopeSource?: SnapshotState;
-    androidSnapshotFreshness?: AndroidSnapshotFreshness;
-    trace?: {
-        outPath: string;
-        startedAt: number;
-    };
-    recordSession?: boolean;
-    saveScriptPath?: string;
-    actions: SessionAction[];
-    recording?: (SessionRecordingBase & {
-        platform: 'ios';
-        child: ReturnType<spawn>;
-        wait: Promise<ExecResult>;
-        remotePath?: string;
-    }) | (SessionRecordingBase & {
-        platform: 'android';
-        remotePath: string;
-        remotePid: string;
-    }) | (SessionRecordingBase & {
-        platform: 'ios-device-runner';
-        remotePath: string;
-        runnerStartedAtUptimeMs?: number;
-        targetAppReadyUptimeMs?: number;
-    }) | (SessionRecordingBase & {
-        platform: 'macos-runner';
-        remotePath?: string;
-    });
-    /** Session-scoped app log stream; logs written to outPath for agent to grep */
-    appLog?: {
-        platform: Platform;
-        backend: 'ios-simulator' | 'ios-device' | 'android' | 'macos';
-        outPath: string;
-        startedAt: number;
-        getState: () => AppLogState;
-        stop: () => Promise<void>;
-        wait: Promise<ExecResult>;
-    };
-};
-
-export declare class SessionStore {
-    private readonly sessions;
-    private readonly runtimeHints;
-    private readonly sessionsDir;
-    constructor(sessionsDir: string);
-    get(name: string): SessionState | undefined;
-    has(name: string): boolean;
-    set(name: string, session: SessionState): void;
-    delete(name: string): boolean;
-    values(): IterableIterator<SessionState>;
-    toArray(): SessionState[];
-    getRuntimeHints(name: string): SessionRuntimeHints | undefined;
-    setRuntimeHints(name: string, hints: SessionRuntimeHints): void;
-    clearRuntimeHints(name: string): boolean;
-    recordAction(session: SessionState, entry: {
-        command: string;
-        positionals: string[];
-        flags: CommandFlags;
-        runtime?: SessionRuntimeHints;
-        result?: Record<string, unknown>;
-    }): void;
-    writeSessionLog(session: SessionState): void;
-    defaultTracePath(session: SessionState): string;
-    /** Path to session-scoped app log file. Agent can grep this for token-efficient debugging. */
-    resolveAppLogPath(sessionName: string): string;
-    resolveAppLogPidPath(sessionName: string): string;
-    static safeSessionName(name: string): string;
-    static expandHome(filePath: string, cwd?: string): string;
-    private resolveScriptPath;
-    private buildOptimizedActions;
-}
-
-declare type SessionSurface = 'app' | 'frontmost-app' | 'desktop' | 'menubar';
-
-export declare type SimulatorLease = {
-    leaseId: string;
-    tenantId: string;
-    runId: string;
-    backend: LeaseBackend;
-    createdAt: number;
-    heartbeatAt: number;
-    expiresAt: number;
-};
-
-declare type SnapshotBackend = 'xctest' | 'android' | 'macos-helper' | 'linux-atspi';
-
-declare type SnapshotNode = RawSnapshotNode & {
-    ref: string;
-};
-
-declare type SnapshotState = {
-    nodes: SnapshotNode[];
-    createdAt: number;
-    truncated?: boolean;
-    backend?: SnapshotBackend;
-    comparisonSafe?: boolean;
-};
-
-export declare function trackDownloadableArtifact(params: {
-    artifactPath: string;
-    tenantId?: string;
-    fileName?: string;
-    deleteAfterDownload?: boolean;
-}): string;
-
-export declare function trackUploadedArtifact(params: {
-    artifactPath: string;
-    tempDir: string;
-    tenantId?: string;
-}): string;
-
-export declare function withDeviceInventoryProvider<T>(provider: DeviceInventoryProvider | undefined, task: () => Promise<T>): Promise<T>;
-
-export { }

package/dist/src/daemon-embedding.js

@@ -1 +0,0 @@
-export{LeaseRegistry,SessionStore,cleanupDownloadableArtifact,cleanupUploadedArtifact,createRequestHandler,prepareDownloadableArtifact,prepareUploadedArtifact,trackDownloadableArtifact,trackUploadedArtifact}from"./6479.js";export{withDeviceInventoryProvider}from"./2007.js";