agent-device 0.7.21 → 0.8.0

package/dist/src/daemon/types.d.ts

@@ -0,0 +1,118 @@
+import type { MaterializeInstallSource } from '../platforms/install-source.ts';
+import type { CommandFlags } from '../core/dispatch.ts';
+import type { DeviceInfo } from '../utils/device.ts';
+import type { ExecResult } from '../utils/exec.ts';
+import type { SnapshotState } from '../utils/snapshot.ts';
+export type DaemonInstallSource = MaterializeInstallSource;
+export type DaemonLockPolicy = 'reject' | 'strip';
+export type DaemonRequest = {
+    token: string;
+    session: string;
+    command: string;
+    positionals: string[];
+    flags?: CommandFlags;
+    runtime?: SessionRuntimeHints;
+    meta?: {
+        requestId?: string;
+        debug?: boolean;
+        cwd?: string;
+        tenantId?: string;
+        runId?: string;
+        leaseId?: string;
+        leaseTtlMs?: number;
+        leaseBackend?: 'ios-simulator';
+        sessionIsolation?: 'none' | 'tenant';
+        uploadedArtifactId?: string;
+        clientArtifactPaths?: Record<string, string>;
+        installSource?: DaemonInstallSource;
+        retainMaterializedPaths?: boolean;
+        materializedPathRetentionMs?: number;
+        materializationId?: string;
+        lockPolicy?: DaemonLockPolicy;
+        lockPlatform?: 'ios' | 'android' | 'apple';
+    };
+};
+export type SessionRuntimeHints = {
+    platform?: 'ios' | 'android';
+    metroHost?: string;
+    metroPort?: number;
+    bundleUrl?: string;
+    launchUrl?: string;
+};
+export type DaemonArtifact = {
+    field: string;
+    artifactId?: string;
+    fileName?: string;
+    localPath?: string;
+    path?: string;
+};
+export type DaemonResponseData = Record<string, unknown> & {
+    artifacts?: DaemonArtifact[];
+};
+export type DaemonResponse = {
+    ok: true;
+    data?: DaemonResponseData;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+        diagnosticId?: string;
+        logPath?: string;
+        details?: Record<string, unknown>;
+    };
+};
+export type SessionState = {
+    name: string;
+    device: DeviceInfo;
+    createdAt: number;
+    appBundleId?: string;
+    appName?: string;
+    snapshot?: SnapshotState;
+    trace?: {
+        outPath: string;
+        startedAt: number;
+    };
+    recordSession?: boolean;
+    saveScriptPath?: string;
+    actions: SessionAction[];
+    recording?: {
+        platform: 'ios' | 'android';
+        outPath: string;
+        clientOutPath?: string;
+        remotePath?: string;
+        child: ReturnType<typeof import('node:child_process').spawn>;
+        wait: Promise<ExecResult>;
+    } | {
+        platform: 'ios-device-runner';
+        outPath: string;
+        clientOutPath?: string;
+        remotePath: string;
+    };
+    /** Session-scoped app log stream; logs written to outPath for agent to grep */
+    appLog?: {
+        platform: 'ios' | 'android';
+        backend: 'ios-simulator' | 'ios-device' | 'android';
+        outPath: string;
+        startedAt: number;
+        getState: () => 'active' | 'failed';
+        stop: () => Promise<void>;
+        wait: Promise<ExecResult>;
+    };
+};
+export type SessionAction = {
+    ts: number;
+    command: string;
+    positionals: string[];
+    flags: Partial<CommandFlags> & {
+        snapshotInteractiveOnly?: boolean;
+        snapshotCompact?: boolean;
+        snapshotDepth?: number;
+        snapshotScope?: string;
+        snapshotRaw?: boolean;
+        saveScript?: boolean | string;
+        noRecord?: boolean;
+    };
+    result?: Record<string, unknown>;
+};

package/dist/src/daemon/upload-registry.d.ts

@@ -0,0 +1,7 @@
+export declare function trackUploadedArtifact(params: {
+    artifactPath: string;
+    tempDir: string;
+    tenantId?: string;
+}): string;
+export declare function prepareUploadedArtifact(uploadId: string, tenantId?: string): string;
+export declare function cleanupUploadedArtifact(uploadId: string): void;

package/dist/src/daemon/upload.d.ts

@@ -0,0 +1,5 @@
+import type { IncomingMessage } from 'node:http';
+export declare function receiveUpload(req: IncomingMessage): Promise<{
+    artifactPath: string;
+    tempDir: string;
+}>;

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

@@ -0,0 +1,40 @@
+import type { DaemonRequest as SharedDaemonRequest, DaemonResponse as SharedDaemonResponse } from './daemon/types.ts';
+import { type DaemonPaths } from './daemon/config.ts';
+export type DaemonRequest = SharedDaemonRequest;
+export type DaemonResponse = SharedDaemonResponse;
+export type OpenAppOptions = {
+    session?: string;
+    app?: string;
+    url?: string;
+    lockPolicy?: NonNullable<DaemonRequest['meta']>['lockPolicy'];
+    lockPlatform?: NonNullable<DaemonRequest['meta']>['lockPlatform'];
+    platform?: NonNullable<DaemonRequest['flags']>['platform'];
+    target?: NonNullable<DaemonRequest['flags']>['target'];
+    device?: NonNullable<DaemonRequest['flags']>['device'];
+    udid?: NonNullable<DaemonRequest['flags']>['udid'];
+    serial?: NonNullable<DaemonRequest['flags']>['serial'];
+    activity?: NonNullable<DaemonRequest['flags']>['activity'];
+    out?: NonNullable<DaemonRequest['flags']>['out'];
+    saveScript?: NonNullable<DaemonRequest['flags']>['saveScript'];
+    relaunch?: boolean;
+    runtime?: DaemonRequest['runtime'];
+    meta?: Omit<NonNullable<DaemonRequest['meta']>, 'uploadedArtifactId' | 'clientArtifactPaths'>;
+};
+export declare function sendToDaemon(req: Omit<DaemonRequest, 'token'>): Promise<DaemonResponse>;
+export declare function openApp(options?: OpenAppOptions): Promise<DaemonResponse>;
+export declare function computeDaemonCodeSignature(entryPath: string, root?: string): string;
+export declare function downloadRemoteArtifact(params: {
+    baseUrl: string;
+    token: string;
+    artifactId: string;
+    destinationPath: string;
+    requestId?: string;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function resolveDaemonRequestTimeoutMs(raw?: string | undefined): number;
+export declare function resolveDaemonStartupTimeoutMs(raw?: string | undefined): number;
+export declare function resolveDaemonStartupAttempts(raw?: string | undefined): number;
+export declare function resolveDaemonStartupHint(state: {
+    hasInfo: boolean;
+    hasLock: boolean;
+}, paths?: Pick<DaemonPaths, 'infoPath' | 'lockPath'>): string;

package/dist/src/daemon.d.ts

@@ -0,0 +1 @@
+export {};