agent-device 0.14.8 → 0.15.0

package/dist/src/android-snapshot-helper.d.ts

@@ -1,5 +1,5 @@
 import type { Readable } from 'node:stream';
-import { SpawnOptions } from 'node:child_process';
+import { StdioOptions } from 'node:child_process';
 import type { Writable } from 'node:stream';
 
 export declare const ANDROID_SNAPSHOT_HELPER_NAME = "android-snapshot-helper";
@@ -59,14 +59,20 @@ declare type AndroidAdbProvider = {
     reverse?: AndroidPortReverseProvider;
     pull?: AndroidAdbPuller;
     install?: AndroidAdbInstaller;
+    installBundle?: AndroidBundleInstaller;
+    text?: AndroidTextInjector;
 };
 
 declare type AndroidAdbPuller = (remotePath: string, localPath: string, options?: AndroidAdbTransferOptions) => Promise<AndroidAdbExecutorResult>;
 
-declare type AndroidAdbSpawner = (args: string[], options?: SpawnOptions) => AndroidAdbProcess;
+declare type AndroidAdbSpawner = (args: string[], options?: ExecBackgroundOptions) => AndroidAdbProcess;
 
 declare type AndroidAdbTransferOptions = AndroidAdbExecutorOptions;
 
+declare type AndroidBundleInstaller = (bundlePath: string, options: {
+    mode: string;
+}) => Promise<void>;
+
 declare type AndroidPortReverseEndpoint = `tcp:${number}` | `localabstract:${string}`;
 
 declare type AndroidPortReverseMapping = {
@@ -185,6 +191,22 @@ export declare type AndroidSnapshotHelperPreparedArtifact = AndroidSnapshotHelpe
     cleanup?: () => Promise<void>;
 };
 
+declare type AndroidTextInjectionRequest = {
+    action: 'type' | 'fill';
+    text: string;
+    delayMs?: number;
+    /**
+     * Present only for fill. Providers must make this target the focused/replaced
+     * input for the request, not inject into an unrelated currently focused field.
+     */
+    target?: {
+        x: number;
+        y: number;
+    };
+};
+
+declare type AndroidTextInjector = (request: AndroidTextInjectionRequest) => Promise<void>;
+
 export declare function captureAndroidSnapshotWithHelper(options: AndroidSnapshotHelperCaptureOptions): Promise<AndroidSnapshotHelperOutput>;
 
 export declare function ensureAndroidSnapshotHelper(options: {
@@ -196,6 +218,15 @@ export declare function ensureAndroidSnapshotHelper(options: {
     timeoutMs?: number;
 }): Promise<AndroidSnapshotHelperInstallResult>;
 
+declare type ExecBackgroundOptions = ExecOptions & {
+    /**
+     * Capture stdout/stderr into the wait result when the child has piped stdio.
+     * Set false when the caller owns, ignores, or forwards the streams.
+     */
+    captureOutput?: boolean;
+    stdio?: StdioOptions;
+};
+
 declare type ExecOptions = {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
@@ -237,6 +268,7 @@ declare type RawSnapshotNode = {
     rect?: Rect;
     enabled?: boolean;
     selected?: boolean;
+    focused?: boolean;
     hittable?: boolean;
     depth?: number;
     parentIndex?: number;
@@ -247,6 +279,7 @@ declare type RawSnapshotNode = {
     surface?: string;
     hiddenContentAbove?: boolean;
     hiddenContentBelow?: boolean;
+    presentationHints?: string[];
 };
 
 declare type Rect = {