@tapflowio/android-agent 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tapflow contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @tapflowio/android-agent
+
+Android emulator agent for [tapflow](https://github.com/jo-duchan/tapflow).
+
+Controls Android emulators via ADB and streams H.264 video using [scrcpy](https://github.com/Genymobile/scrcpy).
+
+## Requirements
+
+- Node.js ≥ 20
+- Android SDK with `adb` (`$ANDROID_HOME` or `$ADB_PATH` must be set)
+- AVD with `google_apis/arm64-v8a` system image (android-34 recommended)
+
+## Usage
+
+Typically started via the `tapflow` CLI:
+
+```sh
+tapflow start
+```
+
+Or programmatically:
+
+```ts
+import { AndroidAgent } from '@tapflowio/android-agent'
+
+const agent = new AndroidAgent()
+await agent.connect('ws://your-relay:3000')
+```
+
+## License
+
+[MIT](LICENSE) — part of the [tapflow](https://github.com/jo-duchan/tapflow) project.
+
+> Bundles [scrcpy-server](https://github.com/Genymobile/scrcpy) (Apache-2.0). See [NOTICE](../../NOTICE) for full attribution.

package/dist/AdbWrapper.d.ts

@@ -0,0 +1,28 @@
+import type { Device } from '@tapflowio/agent-core';
+import { type AdbRunner } from './adb.js';
+export declare class AdbWrapper {
+    private readonly runner;
+    private readonly serialMap;
+    constructor(runner?: AdbRunner);
+    getSerial(avdId: string): string | undefined;
+    setSerial(avdId: string, serial: string): void;
+    clearSerial(avdId: string): void;
+    listDevices(): Promise<Device[]>;
+    private getBootedAvdMap;
+    private getOsVersion;
+    getScreenSize(serial: string): Promise<{
+        width: number;
+        height: number;
+    }>;
+    clearAppData(serial: string, packageName: string): Promise<void>;
+    installApp(serial: string, apkPath: string): Promise<void>;
+    launchApp(serial: string, packageName: string): Promise<void>;
+    screenshot(serial: string): Promise<Buffer>;
+    enableAutoRotate(serial: string): Promise<void>;
+    emuRotate(serial: string): Promise<void>;
+    sendInput(serial: string, ...args: string[]): Promise<void>;
+    sendKeyEvent(serial: string, keyCode: string): Promise<void>;
+    shutdown(serial: string): Promise<void>;
+    pkill(serial: string, pattern: string): Promise<void>;
+}
+//# sourceMappingURL=AdbWrapper.d.ts.map

package/dist/AdbWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdbWrapper.d.ts","sourceRoot":"","sources":["../src/AdbWrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAA;AAExD,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;gBAEzB,MAAM,GAAE,SAAyB;IAE9D,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI9C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YA0CxB,eAAe;YAwBf,YAAY;IAKpB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQzE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5D"}

package/dist/AdbWrapper.js

@@ -0,0 +1,138 @@
+import { defaultRunner } from './adb.js';
+export class AdbWrapper {
+    runner;
+    // avdId ("avd:<name>") → ADB serial ("emulator-5554")
+    serialMap = new Map();
+    constructor(runner = defaultRunner) {
+        this.runner = runner;
+    }
+    getSerial(avdId) {
+        return this.serialMap.get(avdId);
+    }
+    setSerial(avdId, serial) {
+        this.serialMap.set(avdId, serial);
+    }
+    clearSerial(avdId) {
+        this.serialMap.delete(avdId);
+    }
+    async listDevices() {
+        const [avdNames, bootedMap] = await Promise.all([
+            this.runner.listAvds(),
+            this.getBootedAvdMap(),
+        ]);
+        // Sync serial map
+        for (const [serial, avdName] of bootedMap) {
+            this.serialMap.set(`avd:${avdName}`, serial);
+        }
+        // Remove stale serials (emulator was killed externally)
+        const bootedAvdNames = new Set(bootedMap.values());
+        for (const [avdId] of this.serialMap) {
+            if (!bootedAvdNames.has(avdId.replace('avd:', ''))) {
+                this.serialMap.delete(avdId);
+            }
+        }
+        const devices = [];
+        for (const avdName of avdNames) {
+            const avdId = `avd:${avdName}`;
+            const serial = this.serialMap.get(avdId);
+            const isBooted = Boolean(serial);
+            let osVersion;
+            if (isBooted && serial) {
+                osVersion = await this.getOsVersion(serial).catch(() => undefined);
+                if (osVersion)
+                    osVersion = `Android ${osVersion}`;
+            }
+            devices.push({
+                id: avdId,
+                name: avdName,
+                platform: 'android',
+                status: isBooted ? 'booted' : 'shutdown',
+                osVersion,
+            });
+        }
+        return devices;
+    }
+    async getBootedAvdMap() {
+        const result = new Map();
+        try {
+            const output = await this.runner.exec('devices');
+            const serials = output
+                .split('\n')
+                .slice(1)
+                .map((l) => l.split('\t'))
+                .filter(([serial, state]) => serial?.startsWith('emulator-') && state?.trim() === 'device')
+                .map(([serial]) => serial.trim());
+            await Promise.all(serials.map(async (serial) => {
+                const avdName = await this.runner
+                    .exec('-s', serial, 'emu', 'avd', 'name')
+                    .then((o) => o.split('\n')[0].trim())
+                    .catch(() => null);
+                if (avdName)
+                    result.set(serial, avdName);
+            }));
+        }
+        catch { /* adb server not running */ }
+        return result;
+    }
+    async getOsVersion(serial) {
+        const output = await this.runner.exec('-s', serial, 'shell', 'getprop', 'ro.build.version.release');
+        return output.trim();
+    }
+    async getScreenSize(serial) {
+        const output = await this.runner.exec('-s', serial, 'shell', 'wm', 'size');
+        // "Physical size: 1080x2400"
+        const m = output.match(/(\d+)x(\d+)/);
+        if (!m)
+            throw new Error(`Cannot parse screen size from: ${output}`);
+        return { width: parseInt(m[1], 10), height: parseInt(m[2], 10) };
+    }
+    async clearAppData(serial, packageName) {
+        await this.runner.exec('-s', serial, 'shell', 'pm', 'clear', packageName);
+    }
+    async installApp(serial, apkPath) {
+        try {
+            await this.runner.exec('-s', serial, 'install', '-r', apkPath);
+        }
+        catch (e) {
+            const stderr = e.stderr?.trim();
+            if (stderr) {
+                // "Failure [INSTALL_FAILED_...]" → show just the code
+                const failureMatch = stderr.match(/Failure\s*\[(.+?)\]/);
+                if (failureMatch)
+                    throw new Error(failureMatch[1]);
+                // Strip "adb: failed to install <path>:" prefix and stack trace
+                const stripped = stderr
+                    .replace(/^adb: failed to install [^:]+:\s*/, '')
+                    .replace(/\s+at\s+[\w$.]+\([\w.]+:\d+\)[\s\S]*$/, '')
+                    .trim();
+                throw new Error(stripped || stderr);
+            }
+            throw new Error(e.message);
+        }
+    }
+    async launchApp(serial, packageName) {
+        await this.runner.exec('-s', serial, 'shell', 'monkey', '-p', packageName, '-c', 'android.intent.category.LAUNCHER', '1');
+    }
+    async screenshot(serial) {
+        return this.runner.execBinary('-s', serial, 'exec-out', 'screencap', '-p');
+    }
+    async enableAutoRotate(serial) {
+        await this.runner.exec('-s', serial, 'shell', 'settings', 'put', 'system', 'accelerometer_rotation', '1');
+    }
+    async emuRotate(serial) {
+        await this.runner.exec('-s', serial, 'emu', 'rotate');
+    }
+    async sendInput(serial, ...args) {
+        await this.runner.exec('-s', serial, 'shell', 'input', ...args);
+    }
+    async sendKeyEvent(serial, keyCode) {
+        await this.runner.exec('-s', serial, 'shell', 'input', 'keyevent', keyCode);
+    }
+    async shutdown(serial) {
+        await this.runner.exec('-s', serial, 'emu', 'kill');
+    }
+    async pkill(serial, pattern) {
+        await this.runner.exec('-s', serial, 'shell', 'pkill', '-f', pattern);
+    }
+}
+//# sourceMappingURL=AdbWrapper.js.map

package/dist/AdbWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdbWrapper.js","sourceRoot":"","sources":["../src/AdbWrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAA;AAExD,MAAM,OAAO,UAAU;IAIQ;IAH7B,sDAAsD;IACrC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEtD,YAA6B,SAAoB,aAAa;QAAjC,WAAM,GAAN,MAAM,CAA2B;IAAG,CAAC;IAElE,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,MAAc;QACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;YACtB,IAAI,CAAC,eAAe,EAAE;SACvB,CAAC,CAAA;QAEF,kBAAkB;QAClB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,EAAE,MAAM,CAAC,CAAA;QAC9C,CAAC;QACD,wDAAwD;QACxD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;QAClD,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;gBACnD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,OAAO,OAAO,EAAE,CAAA;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;YAEhC,IAAI,SAA6B,CAAA;YACjC,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;gBACvB,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;gBAClE,IAAI,SAAS;oBAAE,SAAS,GAAG,WAAW,SAAS,EAAE,CAAA;YACnD,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;gBACxC,SAAS;aACV,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAChD,MAAM,OAAO,GAAG,MAAM;iBACnB,KAAK,CAAC,IAAI,CAAC;iBACX,KAAK,CAAC,CAAC,CAAC;iBACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;iBACzB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,KAAK,EAAE,IAAI,EAAE,KAAK,QAAQ,CAAC;iBAC1F,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;YAEnC,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM;qBAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;qBACxC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;gBACpB,IAAI,OAAO;oBAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YAC1C,CAAC,CAAC,CACH,CAAA;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,4BAA4B,CAAC,CAAC;QACxC,OAAO,MAAM,CAAA;IACf,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAAc;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAA;QACnG,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAC1E,6BAA6B;QAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;QACrC,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAA;QACnE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;IAClE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,WAAmB;QACpD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;IAC3E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAAe;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,MAAM,GAAI,CAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,CAAA;YACxD,IAAI,MAAM,EAAE,CAAC;gBACX,sDAAsD;gBACtD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAA;gBACxD,IAAI,YAAY;oBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;gBAClD,gEAAgE;gBAChE,MAAM,QAAQ,GAAG,MAAM;qBACpB,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;qBAChD,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC;qBACpD,IAAI,EAAE,CAAA;gBACT,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAA;YACrC,CAAC;YACD,MAAM,IAAI,KAAK,CAAE,CAAW,CAAC,OAAO,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,WAAmB;QACjD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAC/B,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,kCAAkC,EAAE,GAAG,CACjE,CAAA;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,CAAA;IAC5E,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc;QACnC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,wBAAwB,EAAE,GAAG,CAAC,CAAA;IAC3G,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,GAAG,IAAc;QAC/C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACjE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,OAAe;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IAC7E,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,OAAe;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvE,CAAC;CACF"}

package/dist/AndroidAgent.d.ts

@@ -0,0 +1,44 @@
+import type { Device, DeviceAgent } from '@tapflowio/agent-core';
+import { AdbWrapper } from './AdbWrapper.js';
+export interface AndroidAgentOptions {
+    fps?: number;
+    /** AVD name or emulator serial to expose. Omit to expose all detected devices. */
+    deviceFilter?: string;
+}
+export declare class AndroidAgent implements DeviceAgent {
+    private readonly adb;
+    private readonly launcher;
+    private ws;
+    private deviceStates;
+    private relayUrl;
+    private resourcesTimer;
+    private readonly resources;
+    private readonly deviceFilter?;
+    constructor(options?: AndroidAgentOptions, adb?: AdbWrapper);
+    get sessionId(): string | null;
+    connect(relayUrl: string): Promise<void>;
+    private initDeviceStates;
+    disconnect(): void;
+    private reportResources;
+    private cleanupDeviceState;
+    private sendDeviceInfo;
+    private startVideoStream;
+    private restartVideoStream;
+    private handleRotationNotification;
+    private openStreamWs;
+    private handleDeviceBoot;
+    private handleDeviceShutdown;
+    private handleRelayMessage;
+    private handleKeyInput;
+    listDevices(): Promise<Device[]>;
+    boot(avdId: string): Promise<void>;
+    shutdown(avdId: string): Promise<void>;
+    installApp(apkPath: string): Promise<void>;
+    launchApp(packageName: string): Promise<void>;
+    screenshot(): Promise<Buffer>;
+    stream(): ReadableStream<Buffer>;
+    touchStart(x: number, y: number): void;
+    touchMove(x: number, y: number): Promise<void>;
+    touchEnd(): Promise<void>;
+}
+//# sourceMappingURL=AndroidAgent.d.ts.map

package/dist/AndroidAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AndroidAgent.d.ts","sourceRoot":"","sources":["../src/AndroidAgent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAG/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AA8G5C,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAQ;gBAE1B,OAAO,GAAE,mBAAwB,EAAE,GAAG,CAAC,EAAE,UAAU;IAM/D,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAG7B;IAEK,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C9C,OAAO,CAAC,gBAAgB;IAsBxB,UAAU,IAAI,IAAI;IAWlB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,cAAc;YAYR,gBAAgB;YAiDhB,kBAAkB;IAmChC,OAAO,CAAC,0BAA0B;YAwBpB,YAAY;YAOZ,gBAAgB;YA2DhB,oBAAoB;IAsBlC,OAAO,CAAC,kBAAkB;YAwJZ,cAAc;IAqC5B,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAE1B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAOnC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC;IAMhC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAM1B"}