execbro 0.0.1-reserve → 1.10.13

package/build/core/android.d.ts

@@ -0,0 +1,299 @@
+export interface AndroidDevice {
+    id: string;
+    status: "device" | "offline" | "unauthorized" | "no permissions" | string;
+    product?: string;
+    model?: string;
+    device?: string;
+    transportId?: string;
+}
+export interface AdbResult {
+    success: boolean;
+    result?: string;
+    error?: string;
+    data?: Buffer;
+    scaleFactor?: number;
+    originalWidth?: number;
+    originalHeight?: number;
+    devices?: AndroidDevice[];
+}
+/**
+ * Check if ADB is reachable. Caches the result for the lifetime of the process.
+ *
+ * Resolution order:
+ *   1. `adb version` against the inherited PATH.
+ *   2. Standard SDK install paths (ANDROID_HOME, ~/Library/Android/sdk/..., etc).
+ *      If found, prepend the directory to process.env.PATH so subsequent bare
+ *      `adb` invocations work without any call-site changes.
+ *
+ * The recovery path covers the common case of macOS users with Android Studio
+ * installed but adb missing from PATH because ~/.zshrc isn't sourced by GUI-spawned
+ * processes (Claude Code, VS Code MCP, etc).
+ */
+export declare function isAdbAvailable(): Promise<boolean>;
+/**
+ * Test-only: clear the ADB availability cache so the next call re-probes.
+ */
+export declare function resetAdbAvailabilityCache(): void;
+/**
+ * List connected Android devices
+ */
+export declare function listAndroidDevices(): Promise<AdbResult>;
+/**
+ * Get the first connected Android device ID
+ */
+export declare function getDefaultAndroidDevice(): Promise<string | null>;
+/**
+ * List all Android Virtual Devices defined on the host machine, regardless of
+ * whether they are currently running.
+ *
+ * Returns `[]` when adb is missing, the emulator binary cannot be located, or
+ * the listing fails. Callers should treat that as "no inventory available"
+ * rather than an error so the surrounding tool can still surface other
+ * platforms.
+ */
+export declare function getAndroidEmulatorAvds(): Promise<string[]>;
+/**
+ * Map a running emulator's AVD name to its adb serial (e.g. "emulator-5554").
+ *
+ * Strategy: list adb devices, filter to `emulator-NNNN` serials, then call
+ * `adb -s <serial> emu avd name` per serial until one matches the requested
+ * AVD name. Returns `null` if no running emulator matches or if adb is
+ * unavailable. This is the slow path for the resolver — callers should prefer
+ * the cached registry entry first.
+ */
+export declare function getAdbIdForAvd(avdName: string): Promise<string | null>;
+/**
+ * Take a screenshot from an Android device
+ */
+export declare function androidScreenshot(outputPath?: string, deviceId?: string, signal?: AbortSignal): Promise<AdbResult>;
+/**
+ * Install an APK on an Android device
+ */
+export declare function androidInstallApp(apkPath: string, deviceId?: string, options?: {
+    replace?: boolean;
+    grantPermissions?: boolean;
+}): Promise<AdbResult>;
+/**
+ * Launch an app on an Android device
+ */
+export declare function androidLaunchApp(packageName: string, activityName?: string, deviceId?: string): Promise<AdbResult>;
+/**
+ * Get list of installed packages on the device
+ */
+export declare function androidListPackages(deviceId?: string, filter?: string): Promise<AdbResult>;
+/**
+ * Common key event codes for Android
+ */
+export declare const ANDROID_KEY_EVENTS: {
+    readonly HOME: 3;
+    readonly BACK: 4;
+    readonly CALL: 5;
+    readonly END_CALL: 6;
+    readonly VOLUME_UP: 24;
+    readonly VOLUME_DOWN: 25;
+    readonly POWER: 26;
+    readonly CAMERA: 27;
+    readonly CLEAR: 28;
+    readonly TAB: 61;
+    readonly ENTER: 66;
+    readonly DEL: 67;
+    readonly MENU: 82;
+    readonly SEARCH: 84;
+    readonly MEDIA_PLAY_PAUSE: 85;
+    readonly MEDIA_STOP: 86;
+    readonly MEDIA_NEXT: 87;
+    readonly MEDIA_PREVIOUS: 88;
+    readonly MOVE_HOME: 122;
+    readonly MOVE_END: 123;
+    readonly APP_SWITCH: 187;
+    readonly ESCAPE: 111;
+};
+/**
+ * Tap at coordinates on an Android device
+ */
+export declare function androidTap(x: number, y: number, deviceId?: string): Promise<AdbResult>;
+/**
+ * Long press at coordinates on an Android device
+ */
+export declare function androidLongPress(x: number, y: number, durationMs?: number, deviceId?: string): Promise<AdbResult>;
+/**
+ * Swipe on an Android device
+ */
+export declare function androidSwipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number, deviceId?: string): Promise<AdbResult>;
+/**
+ * Input text on an Android device
+ *
+ * ADB input text has limitations with special characters.
+ * This function handles escaping properly for URLs, emails, and special strings.
+ */
+export declare function androidInputText(text: string, deviceId?: string): Promise<AdbResult>;
+/**
+ * Send a key event to an Android device
+ */
+export declare function androidKeyEvent(keyCode: number | keyof typeof ANDROID_KEY_EVENTS, deviceId?: string): Promise<AdbResult>;
+/**
+ * UI Element from accessibility tree
+ */
+export interface AndroidUIElement {
+    text: string;
+    contentDesc: string;
+    resourceId: string;
+    className: string;
+    bounds: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+        width: number;
+        height: number;
+    };
+    center: {
+        x: number;
+        y: number;
+    };
+    clickable: boolean;
+    enabled: boolean;
+    focused: boolean;
+    scrollable: boolean;
+    selected: boolean;
+}
+/**
+ * Result of element find operations
+ */
+export interface FindElementResult {
+    success: boolean;
+    found: boolean;
+    element?: AndroidUIElement;
+    allMatches?: AndroidUIElement[];
+    matchCount?: number;
+    error?: string;
+}
+/**
+ * Result of wait for element operations
+ */
+export interface WaitForElementResult extends FindElementResult {
+    elapsedMs?: number;
+    timedOut?: boolean;
+}
+/**
+ * Options for finding elements
+ */
+export interface FindElementOptions {
+    text?: string;
+    textContains?: string;
+    contentDesc?: string;
+    contentDescContains?: string;
+    resourceId?: string;
+    index?: number;
+}
+/**
+ * Get UI accessibility tree from Android device using uiautomator
+ */
+export declare function androidGetUITree(deviceId?: string, signal?: AbortSignal): Promise<{
+    success: boolean;
+    elements?: AndroidUIElement[];
+    rawXml?: string;
+    error?: string;
+}>;
+/**
+ * Find element(s) in the UI tree matching the given criteria
+ */
+export declare function androidFindElement(options: FindElementOptions, deviceId?: string, signal?: AbortSignal): Promise<FindElementResult>;
+/**
+ * Wait for element to appear on screen with polling
+ */
+export declare function androidWaitForElement(options: FindElementOptions & {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}, deviceId?: string): Promise<WaitForElementResult>;
+/**
+ * Get device screen size
+ */
+export declare function androidGetScreenSize(deviceId?: string): Promise<{
+    success: boolean;
+    width?: number;
+    height?: number;
+    error?: string;
+}>;
+/**
+ * Get device display density (dpi)
+ */
+export declare function androidGetDensity(deviceId?: string): Promise<{
+    success: boolean;
+    density?: number;
+    error?: string;
+}>;
+/**
+ * Get status bar height in pixels
+ * Android status bar is typically 24dp, but can vary by device/OS version
+ */
+export declare function androidGetStatusBarHeight(deviceId?: string): Promise<{
+    success: boolean;
+    heightPixels?: number;
+    heightDp?: number;
+    error?: string;
+}>;
+/**
+ * Android UI element from uiautomator dump
+ */
+export interface AndroidAccessibilityElement {
+    class: string;
+    text?: string;
+    contentDesc?: string;
+    resourceId?: string;
+    bounds: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    frame: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    tap: {
+        x: number;
+        y: number;
+    };
+    children: AndroidAccessibilityElement[];
+    checkable?: boolean;
+    checked?: boolean;
+    clickable?: boolean;
+    enabled?: boolean;
+    focusable?: boolean;
+    focused?: boolean;
+    scrollable?: boolean;
+    selected?: boolean;
+}
+/**
+ * Result type for accessibility operations
+ */
+export interface AndroidDescribeResult {
+    success: boolean;
+    elements?: AndroidAccessibilityElement[];
+    formatted?: string;
+    error?: string;
+}
+/**
+ * Get the UI hierarchy from the connected Android device using uiautomator dump
+ */
+export declare function androidDescribeAll(deviceId?: string): Promise<AndroidDescribeResult>;
+/**
+ * Get accessibility info for the UI element at specific coordinates
+ */
+export declare function androidDescribePoint(x: number, y: number, deviceId?: string): Promise<AndroidDescribeResult>;
+/**
+ * Tap an element by its text, content-description, or resource-id
+ */
+export declare function androidTapElement(options: {
+    text?: string;
+    textContains?: string;
+    contentDesc?: string;
+    contentDescContains?: string;
+    resourceId?: string;
+    index?: number;
+    deviceId?: string;
+}): Promise<AdbResult>;
+//# sourceMappingURL=android.d.ts.map

package/build/core/android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.d.ts","sourceRoot":"","sources":["../../src/core/android.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,gBAAgB,GAAG,MAAM,CAAC;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,SAAS;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAgCD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CA+BvD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAcD;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,SAAS,CAAC,CAyD7D;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBtE;AAiCD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBhE;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2B5E;AASD;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,SAAS,CAAC,CAoFpB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5D,OAAO,CAAC,SAAS,CAAC,CAsDpB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CA+CpB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,CAAC,CAgDpB;AAMD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CAuBrB,CAAC;AAEX;;GAEG;AACH,wBAAsB,UAAU,CAC5B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CA8BpB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,UAAU,GAAE,MAAa,EACzB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CAmCpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CAoCpB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CAgHpB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,OAAO,kBAAkB,EACjD,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CAgDpB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAqHD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IACrF,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAmDD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAuE5B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACvC,OAAO,EAAE,kBAAkB,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,EACD,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CA+C/B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAwCD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAuCD;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAuDD;AAMD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE;QACH,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,GAAG,EAAE;QACD,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,QAAQ,EAAE,2BAA2B,EAAE,CAAC;IAExC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,2BAA2B,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAmKD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmE1F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CA2EhC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE;IACL,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GACF,OAAO,CAAC,SAAS,CAAC,CAqFpB"}