execbro 2.8.3 → 2.8.5

package/README.md

@@ -46,7 +46,7 @@ Linking your installation here is also **required to unlock [ExecBro Pro](#prici
 - **Unified Tap** - Single `tap` tool with automatic fallback chain: fiber tree → accessibility → OCR → coordinates. Auto-detects platform, accepts coordinates from screenshots and layout tools unchanged. Returns post-tap screenshot and verifies visual change by default
 - **Unified Swipe** - Single `swipe` tool that auto-routes to iOS or Android based on the connected device. Takes coordinates in the same screen space as the layout tools and screenshots — no conversion — and returns a `verification.meaningful` signal so agents detect end-of-list, non-scrollable surfaces, and missed coordinates. Essential for scrolling virtualized lists (FlatList/SectionList) where off-screen items aren't in the fiber tree
 - **Real Multi-Touch Pinch** *(Android emulator only — iOS in progress)* - A `pinch` tool that sends two genuine kernel touch contacts through the Android emulator's multi-touch bridge, so it zooms maps, galleries, WebViews, and native views alike — it works below the app, not through React Native. Returns the same `verification.meaningful` signal as `swipe`, and refuses on unsupported targets instead of faking a result
-- **UI Automation** - Swipe, long press, key events, and text input on both platforms. On Bridgeless/Fabric apps, `dismiss_keyboard` operates on whatever has focus, and `ios_input_text` / `android_input_text` accept `replace:true` to overwrite pre-filled values — updating React state through `onChangeText` so controlled components (Formik, react-hook-form, useState) stay consistent
+- **UI Automation** - Swipe, long press (`tap` with `duration`, resolving the target by testID/text/component), key events, and text input on both platforms. On Bridgeless/Fabric apps, `dismiss_keyboard` operates on whatever has focus, and `ios_input_text` / `android_input_text` accept `replace:true` to overwrite pre-filled values — updating React state through `onChangeText` so controlled components (Formik, react-hook-form, useState) stay consistent
 - **Accessibility Inspection** - Query UI hierarchy to find elements by text, label, or resource ID
 - **OCR Text Extraction** - Extract visible text with tap-ready coordinates via Google Cloud Vision (works on any screen content)
 

package/build/__tests__/unit/metroGateReconnect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metroGateReconnect.test.d.ts.map

package/build/__tests__/unit/metroGateReconnect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metroGateReconnect.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/metroGateReconnect.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/metroGateReconnect.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect, beforeEach } from "@jest/globals";
+import WebSocket from "ws";
+const { connectedApps } = await import("../../core/state.js");
+const { awaitMetro, buildMetroMissingHint } = await import("../../core/nativeOnlyHints.js");
+const { saveReconnectionTimer, cancelReconnectionTimer } = await import("../../core/connectionState.js");
+function connectApp(key = "app-1") {
+    connectedApps.set(key, {
+        ws: { readyState: WebSocket.OPEN },
+        deviceInfo: {
+            id: key,
+            title: "Hermes React Native",
+            description: "",
+            appId: "com.test",
+            type: "node",
+            webSocketDebuggerUrl: "ws://localhost:8081/x",
+            deviceName: "iPhone Air"
+        },
+        port: 8081,
+        platform: "ios"
+    });
+}
+function fakeSleep() {
+    const waits = [];
+    return {
+        waits,
+        sleep: async (ms) => {
+            waits.push(ms);
+        }
+    };
+}
+describe("awaitMetro", () => {
+    beforeEach(() => {
+        connectedApps.clear();
+        cancelReconnectionTimer("app-1");
+    });
+    it("answers immediately when an app is connected", async () => {
+        connectApp();
+        const { waits, sleep } = fakeSleep();
+        expect(await awaitMetro({ sleep })).toBe(true);
+        expect(waits).toEqual([]);
+    });
+    it("does not wait when nothing is reconnecting", async () => {
+        const { waits, sleep } = fakeSleep();
+        expect(await awaitMetro({ sleep })).toBe(false);
+        expect(waits).toEqual([]);
+    });
+    it("waits for an in-flight reconnection and reports the recovery", async () => {
+        const timer = setTimeout(() => { }, 60_000);
+        saveReconnectionTimer("app-1", timer);
+        const { waits, sleep } = fakeSleep();
+        let polls = 0;
+        const countingSleep = async (ms) => {
+            await sleep(ms);
+            if (++polls === 3)
+                connectApp();
+        };
+        expect(await awaitMetro({ sleep: countingSleep })).toBe(true);
+        expect(waits.length).toBe(3);
+        clearTimeout(timer);
+    });
+    it("gives up inside its budget when the reconnection never lands", async () => {
+        const timer = setTimeout(() => { }, 60_000);
+        saveReconnectionTimer("app-1", timer);
+        const { waits, sleep } = fakeSleep();
+        expect(await awaitMetro({ timeoutMs: 2000, sleep })).toBe(false);
+        expect(waits.reduce((a, b) => a + b, 0)).toBeLessThanOrEqual(2000);
+        expect(waits.length).toBeGreaterThan(0);
+        clearTimeout(timer);
+    });
+});
+describe("the no-Metro hint", () => {
+    it("names the reconnecting device instead of telling the user to scan again", () => {
+        const hint = buildMetroMissingHint({
+            toolName: "get_screen_state",
+            devices: { ios: true, android: true, any: true },
+            reconnecting: ["iPhone Air"]
+        });
+        expect(hint).toMatch(/iPhone Air/);
+        expect(hint).toMatch(/reconnect/i);
+        expect(hint).not.toMatch(/run scan_metro/i);
+    });
+    it("does not present an attached device as if it were the connection", () => {
+        const hint = buildMetroMissingHint({
+            toolName: "get_screen_state",
+            devices: { ios: true, android: true, any: true }
+        });
+        expect(hint).toMatch(/attached/i);
+        expect(hint).toMatch(/scan_metro/);
+    });
+    it("still guides the user when nothing is running at all", () => {
+        const hint = buildMetroMissingHint({
+            toolName: "get_screen_state",
+            devices: { ios: false, android: false, any: false }
+        });
+        expect(hint).toMatch(/No running simulators or devices/i);
+    });
+});
+//# sourceMappingURL=metroGateReconnect.test.js.map

package/build/__tests__/unit/metroGateReconnect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metroGateReconnect.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/metroGateReconnect.test.ts"],"names":[],"mappings":"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"}

package/build/__tests__/unit/pressablesLongPress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pressablesLongPress.test.d.ts.map

package/build/__tests__/unit/pressablesLongPress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressablesLongPress.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/pressablesLongPress.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/pressablesLongPress.test.js

@@ -0,0 +1,91 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+const evaluated = [];
+let evalResult = null;
+jest.unstable_mockModule("../../core/jsExecute.js", () => ({
+    executeInApp: async (expression) => {
+        evaluated.push(expression);
+        return { success: true, result: JSON.stringify(evalResult) };
+    },
+    delay: async () => { }
+}));
+const { pressElement } = await import("../../core/pressables.js");
+function fiber(props, type = "View", children = []) {
+    const node = {
+        type,
+        memoizedProps: props,
+        stateNode: { measureInWindow: (cb) => cb(10, 20, 100, 50) },
+        child: null,
+        sibling: null,
+        return: null
+    };
+    let prev = null;
+    for (const c of children) {
+        c.return = node;
+        if (prev)
+            prev.sibling = c;
+        else
+            node.child = c;
+        prev = c;
+    }
+    return node;
+}
+async function search(options, root) {
+    evaluated.length = 0;
+    evalResult = { dispatched: 1 };
+    await pressElement(options);
+    const globalThisStub = {
+        __REACT_DEVTOOLS_GLOBAL_HOOK__: {
+            getFiberRoots: () => new Set([{ current: root }]),
+            renderers: new Map()
+        }
+    };
+    let last = null;
+    for (const expression of evaluated) {
+        const fn = new Function("globalThis", `return (${expression.trim()});`);
+        last = fn(globalThisStub);
+    }
+    return typeof last === "string" ? JSON.parse(last) : last;
+}
+describe("fiber search and onLongPress", () => {
+    beforeEach(() => {
+        evaluated.length = 0;
+    });
+    it("ignores a long-press-only element for an ordinary tap", async () => {
+        const root = fiber({}, "View", [
+            fiber({ testID: "row-3", onLongPress: () => { } }, "View", [
+                fiber({ children: "Row 3" }, "Text")
+            ])
+        ]);
+        const out = await search({ testID: "row-3" }, root);
+        expect(out.needsNativeTap).toBeUndefined();
+        expect(out.error).toBeDefined();
+    });
+    it("finds a long-press-only element when a hold was requested", async () => {
+        const root = fiber({}, "View", [
+            fiber({ testID: "row-3", onLongPress: () => { } }, "View", [
+                fiber({ children: "Row 3" }, "Text")
+            ])
+        ]);
+        const out = await search({ testID: "row-3", longPress: true }, root);
+        expect(out.needsNativeTap).toBe(true);
+        expect(out.hasLongPress).toBe(true);
+    });
+    it("reports an ordinary button as having no long-press handler", async () => {
+        const root = fiber({}, "View", [
+            fiber({ testID: "save", onPress: () => { } }, "View", [
+                fiber({ children: "Save" }, "Text")
+            ])
+        ]);
+        const out = await search({ testID: "save", longPress: true }, root);
+        expect(out.needsNativeTap).toBe(true);
+        expect(out.hasLongPress).toBe(false);
+    });
+    it("still finds ordinary pressables when a hold was requested", async () => {
+        const root = fiber({}, "View", [
+            fiber({ onPress: () => { } }, "View", [fiber({ children: "Save" }, "Text")])
+        ]);
+        const out = await search({ text: "Save", longPress: true }, root);
+        expect(out.needsNativeTap).toBe(true);
+    });
+});
+//# sourceMappingURL=pressablesLongPress.test.js.map

package/build/__tests__/unit/pressablesLongPress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressablesLongPress.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/pressablesLongPress.test.ts"],"names":[],"mappings":"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"}

package/build/__tests__/unit/socketLifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=socketLifecycle.test.d.ts.map

package/build/__tests__/unit/socketLifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socketLifecycle.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/socketLifecycle.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/socketLifecycle.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect, beforeEach } from "@jest/globals";
+import WebSocket from "ws";
+const { connectedApps, isSupersededSocket } = await import("../../core/state.js");
+const { shouldTerminateForMissedPong } = await import("../../core/connectionState.js");
+function app(ws) {
+    return {
+        ws: ws,
+        deviceInfo: {
+            id: "dev-1",
+            title: "Hermes React Native",
+            description: "",
+            appId: "com.test",
+            type: "node",
+            webSocketDebuggerUrl: "ws://localhost:8081/x",
+            deviceName: "iPhone Air"
+        },
+        port: 8081,
+        platform: "ios"
+    };
+}
+describe("isSupersededSocket", () => {
+    beforeEach(() => connectedApps.clear());
+    it("says a socket still holding its entry is not superseded", () => {
+        const live = { readyState: WebSocket.OPEN };
+        connectedApps.set("k", app(live));
+        expect(isSupersededSocket("k", live)).toBe(false);
+    });
+    it("says a replaced socket is superseded", () => {
+        const old = { readyState: WebSocket.CLOSED };
+        const live = { readyState: WebSocket.OPEN };
+        connectedApps.set("k", app(old));
+        connectedApps.set("k", app(live));
+        expect(isSupersededSocket("k", old)).toBe(true);
+        expect(isSupersededSocket("k", live)).toBe(false);
+    });
+    it("does not call an unregistered socket superseded", () => {
+        expect(isSupersededSocket("k", { readyState: WebSocket.OPEN })).toBe(false);
+    });
+});
+describe("shouldTerminateForMissedPong", () => {
+    const now = 1_000_000;
+    const quietWindowMs = 10_000;
+    it("keeps a socket whose pong arrived", () => {
+        expect(shouldTerminateForMissedPong({ pongReceived: true, lastCdpMessageAt: null, now, quietWindowMs })).toBe(false);
+    });
+    it("keeps a socket that is still carrying CDP traffic", () => {
+        expect(shouldTerminateForMissedPong({
+            pongReceived: false,
+            lastCdpMessageAt: new Date(now - 2_000),
+            now,
+            quietWindowMs
+        })).toBe(false);
+    });
+    it("terminates when the pong is missed and the socket has gone quiet", () => {
+        expect(shouldTerminateForMissedPong({
+            pongReceived: false,
+            lastCdpMessageAt: new Date(now - 30_000),
+            now,
+            quietWindowMs
+        })).toBe(true);
+    });
+    it("terminates when there was never any traffic to vouch for it", () => {
+        expect(shouldTerminateForMissedPong({ pongReceived: false, lastCdpMessageAt: null, now, quietWindowMs })).toBe(true);
+    });
+});
+//# sourceMappingURL=socketLifecycle.test.js.map

package/build/__tests__/unit/socketLifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socketLifecycle.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/socketLifecycle.test.ts"],"names":[],"mappings":"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"}

package/build/__tests__/unit/swipeProbeWithoutRn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=swipeProbeWithoutRn.test.d.ts.map

package/build/__tests__/unit/swipeProbeWithoutRn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipeProbeWithoutRn.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/swipeProbeWithoutRn.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/swipeProbeWithoutRn.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect, jest } from "@jest/globals";
+const execCalls = [];
+let execBehaviour = async () => ({ success: false });
+jest.unstable_mockModule("../../core/jsExecute.js", () => ({
+    executeInApp: async (...args) => {
+        execCalls.push(args);
+        return execBehaviour();
+    },
+    delay: async () => { }
+}));
+const { probeScrollAt, explainNoOpSwipe } = await import("../../core/swipeDiagnosis.js");
+describe("probeScrollAt without a React Native connection", () => {
+    it("reports the probe as unavailable instead of throwing", async () => {
+        execCalls.length = 0;
+        execBehaviour = () => {
+            throw new Error('No connected device matches "emulator-5556"');
+        };
+        const probe = await probeScrollAt(446, 1330, "emulator-5556");
+        expect(probe.found).toBe(false);
+        expect(probe.unavailable).toBe(true);
+    });
+    it("does not claim the gesture missed a scroll view when it could not look", async () => {
+        const unavailable = explainNoOpSwipe({ found: false, unavailable: true }, { x: 446, y: 1330 });
+        expect(unavailable).toMatch(/no React Native connection|could not/i);
+        expect(unavailable).not.toMatch(/did not land on a scrollable surface/);
+        const genuinelyMissed = explainNoOpSwipe({ found: false }, { x: 446, y: 1330 });
+        expect(genuinelyMissed).toMatch(/did not land on a scrollable surface/);
+    });
+    it("treats a failed probe the same as a thrown one — both mean we could not look", async () => {
+        execCalls.length = 0;
+        execBehaviour = async () => ({ success: false, error: "Not connected to any app" });
+        const probe = await probeScrollAt(446, 1330, "emulator-5556");
+        expect(probe.found).toBe(false);
+        expect(probe.unavailable).toBe(true);
+    });
+    it("still reports a real miss when the app answers", async () => {
+        execCalls.length = 0;
+        execBehaviour = async () => ({ success: true, result: JSON.stringify({ found: false }) });
+        const probe = await probeScrollAt(446, 1330, "emulator-5556");
+        expect(probe.found).toBe(false);
+        expect(probe.unavailable).toBeUndefined();
+    });
+});
+//# sourceMappingURL=swipeProbeWithoutRn.test.js.map

package/build/__tests__/unit/swipeProbeWithoutRn.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipeProbeWithoutRn.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/swipeProbeWithoutRn.test.ts"],"names":[],"mappings":"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"}

package/build/__tests__/unit/tapAndroidSerial.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tapAndroidSerial.test.d.ts.map

package/build/__tests__/unit/tapAndroidSerial.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapAndroidSerial.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/tapAndroidSerial.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/tapAndroidSerial.test.js

@@ -0,0 +1,179 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+import WebSocket from "ws";
+const TARGET = "emulator-5556";
+const DEFAULT = "emulator-5554";
+const adbCalls = [];
+const verifyCalls = [];
+jest.unstable_mockModule("../../core/exec.js", () => ({
+    execFileAsync: async (file, args) => {
+        if (file === "adb")
+            adbCalls.push(args);
+        if (args?.[0] === "devices") {
+            return { stdout: `List of devices attached\n${DEFAULT}\tdevice\n${TARGET}\tdevice\n`, stderr: "" };
+        }
+        if (args?.includes("wm density"))
+            return { stdout: "Physical density: 160", stderr: "" };
+        return { stdout: "", stderr: "" };
+    },
+    execAsync: async () => ({ stdout: "", stderr: "" }),
+    quoteForDeviceShell: (v) => v,
+    withCancelableTimeout: async (p) => p
+}));
+jest.unstable_mockModule("../../core/deviceResolver.js", () => ({
+    resolveDeviceTarget: async () => ({
+        ok: true,
+        target: {
+            platform: "android",
+            androidSerial: TARGET,
+            deviceName: "sdk_gphone64_arm64",
+            source: "adb-serial"
+        }
+    }),
+    formatResolverError: (e) => e.message
+}));
+jest.unstable_mockModule("../../pro/verifyAction.js", () => ({
+    captureScreenshot: async (platform, udid, deviceId) => {
+        verifyCalls.push({ fn: "captureScreenshot", platform, udid, deviceId });
+        return { buffer: Buffer.from("png"), width: 1080, height: 2400, scaleFactor: 1 };
+    },
+    verifyAndCapture: async (args) => {
+        verifyCalls.push({ fn: "verifyAndCapture", ...args });
+        return { screenshot: undefined, verification: undefined, afterWithMarkerBuffer: null };
+    },
+    burstCaptureAndVerify: async (args) => {
+        verifyCalls.push({ fn: "burstCaptureAndVerify", ...args });
+        return { screenshot: undefined, verification: undefined };
+    },
+    drawTapMarker: async (b) => b,
+    settleAndDiff: async () => null
+}));
+jest.unstable_mockModule("../../pro/overlayGuard.js", () => ({
+    checkOverlayBlocking: async () => null
+}));
+jest.unstable_mockModule("../../core/pressables.js", () => ({
+    pressElement: async () => ({
+        success: true,
+        result: JSON.stringify({
+            needsNativeTap: true,
+            nativeTapTarget: { x: 100, y: 200, unit: "points" },
+            pressed: "Button",
+            totalMatches: 1,
+            text: "Submit",
+            testID: "submit-btn",
+            path: "App > Button",
+            isInput: false
+        })
+    }),
+    findPressableElements: async () => ({ success: true, result: "[]" })
+}));
+const { tap } = await import("../../pro/tap.js");
+const { connectedApps } = await import("../../core/state.js");
+function connectAndroidApp() {
+    connectedApps.set("android-1", {
+        ws: { readyState: WebSocket.OPEN },
+        deviceInfo: {
+            id: "android-1",
+            title: "Hermes React Native",
+            description: "",
+            appId: "com.test",
+            type: "node",
+            webSocketDebuggerUrl: "ws://localhost:8081/android-1",
+            deviceName: "sdk_gphone64_arm64"
+        },
+        port: 8081,
+        platform: "android",
+        adbSerial: TARGET
+    });
+}
+function adbCallsMatching(fragment) {
+    return adbCalls.filter((args) => args.some((a) => a.includes(fragment)));
+}
+function targetsTheResolvedDevice(args) {
+    const i = args.indexOf("-s");
+    return i !== -1 && args[i + 1] === TARGET;
+}
+describe("tap threads the Android serial to the device", () => {
+    beforeEach(() => {
+        adbCalls.length = 0;
+        verifyCalls.length = 0;
+        connectedApps.clear();
+    });
+    it("sends a native coordinate tap to the resolved emulator, not the default one", async () => {
+        await tap({ x: 300, y: 600, native: true, device: TARGET, screenshot: false });
+        const taps = adbCallsMatching("input tap");
+        expect(taps).toHaveLength(1);
+        expect(targetsTheResolvedDevice(taps[0])).toBe(true);
+    });
+    it("captures the verification frames from the resolved emulator", async () => {
+        await tap({ x: 300, y: 600, native: true, device: TARGET, screenshot: false });
+        expect(verifyCalls.length).toBeGreaterThan(0);
+        for (const call of verifyCalls) {
+            expect(call.deviceId).toBe(TARGET);
+        }
+    });
+    it("sends a fiber-resolved tap to the resolved emulator", async () => {
+        connectAndroidApp();
+        await tap({ testID: "submit-btn", device: TARGET, screenshot: false, verify: false });
+        const taps = adbCallsMatching("input tap");
+        expect(taps).toHaveLength(1);
+        expect(targetsTheResolvedDevice(taps[0])).toBe(true);
+        const density = adbCallsMatching("wm density");
+        expect(density.length).toBeGreaterThan(0);
+        expect(density.every(targetsTheResolvedDevice)).toBe(true);
+    });
+    it("dumps the accessibility tree from the resolved emulator", async () => {
+        connectAndroidApp();
+        await tap({
+            text: "Submit",
+            device: TARGET,
+            strategy: "accessibility",
+            screenshot: false,
+            verify: false
+        });
+        const dumps = adbCallsMatching("uiautomator dump");
+        expect(dumps.length).toBeGreaterThan(0);
+        expect(dumps.every(targetsTheResolvedDevice)).toBe(true);
+    });
+    it("screenshots the resolved emulator for OCR", async () => {
+        connectAndroidApp();
+        await tap({
+            text: "Submit",
+            device: TARGET,
+            strategy: "ocr",
+            screenshot: false,
+            verify: false
+        });
+        const caps = adbCallsMatching("screencap");
+        expect(caps.length).toBeGreaterThan(0);
+        expect(caps.every(targetsTheResolvedDevice)).toBe(true);
+    });
+    it("leaves adb on its default device when no device is named", async () => {
+        await tap({ x: 300, y: 600, native: true, screenshot: false, verify: false });
+        const version = adbCalls.filter((args) => args[0] === "version");
+        expect(version.every((args) => !args.includes("-s"))).toBe(true);
+    });
+});
+describe("swipe verification frames come from the resolved emulator", () => {
+    beforeEach(() => {
+        adbCalls.length = 0;
+        verifyCalls.length = 0;
+        connectedApps.clear();
+    });
+    it("captures before/after frames from the target, not adb's default", async () => {
+        const handlers = new Map();
+        jest.unstable_mockModule("../../core/register.js", () => ({
+            registerToolWithTelemetry: (_s, name, _c, handler) => {
+                handlers.set(name, handler);
+            },
+            toolRegistry: new Map()
+        }));
+        const { registerInteractionTools } = await import("../../tools/interactionTools.js");
+        registerInteractionTools({ registerTool: () => { } });
+        await handlers.get("swipe")({ direction: "up", device: TARGET, screenshot: false });
+        expect(verifyCalls.length).toBeGreaterThan(0);
+        for (const call of verifyCalls) {
+            expect(call.deviceId).toBe(TARGET);
+        }
+    });
+});
+//# sourceMappingURL=tapAndroidSerial.test.js.map

package/build/__tests__/unit/tapAndroidSerial.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapAndroidSerial.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/tapAndroidSerial.test.ts"],"names":[],"mappings":"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"}

package/build/__tests__/unit/tapDuration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tapDuration.test.d.ts.map

package/build/__tests__/unit/tapDuration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapDuration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/tapDuration.test.ts"],"names":[],"mappings":""}