agent-device 0.15.1 → 0.16.0

package/dist/src/index.d.ts

@@ -44,11 +44,15 @@ export declare type AgentDeviceClient = {
         press: (options: PressOptions) => Promise<CommandRequestResult>;
         longPress: (options: LongPressOptions) => Promise<CommandRequestResult>;
         swipe: (options: SwipeOptions) => Promise<CommandRequestResult>;
+        pan: (options: PanOptions) => Promise<CommandRequestResult>;
+        fling: (options: FlingOptions) => Promise<CommandRequestResult>;
         focus: (options: FocusOptions_2) => Promise<CommandRequestResult>;
         type: (options: TypeTextOptions) => Promise<CommandRequestResult>;
         fill: (options: FillOptions) => Promise<CommandRequestResult>;
         scroll: (options: ScrollOptions_2) => Promise<CommandRequestResult>;
         pinch: (options: PinchOptions) => Promise<CommandRequestResult>;
+        rotateGesture: (options: RotateGestureOptions) => Promise<CommandRequestResult>;
+        transformGesture: (options: TransformGestureOptions) => Promise<CommandRequestResult>;
         get: (options: GetOptions) => Promise<CommandRequestResult>;
         is: (options: IsOptions) => Promise<CommandRequestResult>;
         find: (options: FindOptions) => Promise<CommandRequestResult>;
@@ -211,6 +215,7 @@ declare type AndroidSnapshotBackendMetadata = {
     fallbackReason?: string;
     installReason?: 'missing' | 'outdated' | 'forced' | 'current' | 'skipped';
     waitForIdleTimeoutMs?: number;
+    waitForIdleQuietMs?: number;
     timeoutMs?: number;
     maxDepth?: number;
     maxNodes?: number;
@@ -294,6 +299,7 @@ export declare type AppOpenOptions = AgentDeviceRequestOverrides & AgentDeviceSe
     url?: string;
     surface?: 'app' | 'frontmost-app' | 'desktop' | 'menubar';
     activity?: string;
+    launchConsole?: string;
     relaunch?: boolean;
     saveScript?: boolean | string;
     noRecord?: boolean;
@@ -378,8 +384,8 @@ export declare type BatchRunOptions = AgentDeviceRequestOverrides & {
 
 export declare type BatchStep = {
     command: string;
-    positionals?: string[];
-    flags?: Record<string, unknown>;
+    input: Record<string, unknown>;
+    runtime?: unknown;
 };
 
 export declare type CaptureDiffOptions = ClientCommandBaseOptions & Pick<CaptureSnapshotOptions, 'interactiveOnly' | 'compact' | 'depth' | 'scope' | 'raw'> & {
@@ -609,6 +615,14 @@ export declare type FindOptions = (FindBaseOptions & {
 
 declare type FindSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'raw'>;
 
+declare type FlingOptions = ClientCommandBaseOptions & {
+    direction: 'up' | 'down' | 'left' | 'right';
+    x: number;
+    y: number;
+    distance?: number;
+    durationMs?: number;
+};
+
 declare type FocusOptions_2 = ClientCommandBaseOptions & {
     x: number;
     y: number;
@@ -642,12 +656,12 @@ declare type IsTextPredicateOptions = ClientCommandBaseOptions & SelectorSnapsho
 };
 
 export declare type KeyboardCommandOptions = DeviceCommandBaseOptions & {
-    action?: 'status' | 'dismiss';
+    action?: 'status' | 'dismiss' | 'enter' | 'return';
 };
 
 export declare type KeyboardCommandResult = DaemonResponseData & {
     platform?: 'android' | 'ios';
-    action?: 'status' | 'dismiss';
+    action?: 'status' | 'dismiss' | 'enter';
     visible?: boolean;
     inputType?: string | null;
     inputMethodPackage?: string | null;
@@ -798,6 +812,14 @@ export declare type NormalizedError = {
 
 export declare type OutputVisibility = 'client-visible' | 'internal';
 
+declare type PanOptions = ClientCommandBaseOptions & {
+    x: number;
+    y: number;
+    dx: number;
+    dy: number;
+    durationMs?: number;
+};
+
 export declare type PerfOptions = ClientCommandBaseOptions;
 
 export declare type PermissionTarget = 'camera' | 'microphone' | 'photos' | 'contacts' | 'contacts-limited' | 'notifications' | 'calendar' | 'location' | 'location-always' | 'media-library' | 'motion' | 'reminders' | 'siri' | 'accessibility' | 'screen-recording' | 'input-monitoring';
@@ -912,18 +934,22 @@ declare type RepeatedPressOptions = {
     doubleTap?: boolean;
 };
 
-export declare type ReplayRunOptions = AgentDeviceRequestOverrides & {
+export declare type ReplayRunOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
     path: string;
     update?: boolean;
     /** @deprecated Use backend: 'maestro'. */
     maestro?: boolean;
     backend?: string;
     env?: string[];
+    timeoutMs?: number;
 };
 
 export declare type ReplayTestOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
     paths: string[];
     update?: boolean;
+    /** @deprecated Use backend: 'maestro'. */
+    maestro?: boolean;
+    backend?: string;
     env?: string[];
     failFast?: boolean;
     timeoutMs?: number;
@@ -966,6 +992,13 @@ export declare type RotateCommandResult = CommandActionResult<'rotate'> & {
     orientation?: RotateCommandOptions['orientation'];
 };
 
+declare type RotateGestureOptions = ClientCommandBaseOptions & {
+    degrees: number;
+    x?: number;
+    y?: number;
+    velocity?: number;
+};
+
 export declare type ScreenshotOverlayRef = {
     ref: string;
     label?: string;
@@ -1088,6 +1121,16 @@ export declare type TraceOptions = AgentDeviceRequestOverrides & {
     path?: string;
 };
 
+declare type TransformGestureOptions = ClientCommandBaseOptions & {
+    x: number;
+    y: number;
+    dx: number;
+    dy: number;
+    scale: number;
+    degrees: number;
+    durationMs?: number;
+};
+
 export declare type TypeTextOptions = ClientCommandBaseOptions & {
     text: string;
     delayMs?: number;