@0xhayd3n/fling 0.6.0

package/dist/tools/scroll-until-visible.d.ts

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type UiNode } from "../uiDump.js";
+import { type Selector } from "../uiSelector.js";
+export declare function buildSwipeArgs(deviceArgs: string[], direction: "up" | "down", screenWidth: number, screenHeight: number): string[];
+export interface ScrollAndSearchOptions {
+    maxScrolls: number;
+}
+export interface ScrollAndSearchResult {
+    found: boolean;
+    scrolls_performed: number;
+    bounds?: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    center?: {
+        x: number;
+        y: number;
+    };
+}
+export declare function scrollAndSearch(dumpFn: () => Promise<UiNode[]>, swipeFn: () => Promise<void>, selector: Selector, options: ScrollAndSearchOptions): Promise<ScrollAndSearchResult>;
+export declare function registerScrollUntilVisible(server: McpServer): void;

package/dist/tools/scroll-until-visible.js

@@ -0,0 +1,138 @@
+import { z } from "zod";
+import { fetchUiDump } from "../uiDump.js";
+import { findNodes } from "../uiSelector.js";
+import { runAdb } from "../adb.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+const SWIPE_DURATION_MS = 500;
+export function buildSwipeArgs(deviceArgs, direction, screenWidth, screenHeight) {
+    const x = Math.round(screenWidth / 2);
+    const high = Math.round(screenHeight * 0.8);
+    const low = Math.round(screenHeight * 0.2);
+    const [y1, y2] = direction === "down" ? [high, low] : [low, high];
+    return [
+        ...deviceArgs,
+        "shell",
+        "input",
+        "swipe",
+        String(x),
+        String(y1),
+        String(x),
+        String(y2),
+        String(SWIPE_DURATION_MS),
+    ];
+}
+export async function scrollAndSearch(dumpFn, swipeFn, selector, options) {
+    let scrolls = 0;
+    for (let i = 0; i <= options.maxScrolls; i++) {
+        const nodes = await dumpFn();
+        const matches = findNodes(nodes, selector);
+        if (matches.length > 0) {
+            return {
+                found: true,
+                scrolls_performed: scrolls,
+                bounds: matches[0].bounds,
+                center: matches[0].center,
+            };
+        }
+        if (scrolls >= options.maxScrolls)
+            break;
+        await swipeFn();
+        scrolls++;
+    }
+    return { found: false, scrolls_performed: scrolls };
+}
+async function getScreenSize(deviceArgs) {
+    // `wm size` returns "Physical size: WxH" and possibly "Override size: WxH".
+    // Override wins when present (matches what uiautomator sees).
+    const { stdout } = await runAdb([...deviceArgs, "shell", "wm", "size"]);
+    const lines = stdout.split(/\r?\n/);
+    const override = lines.find((l) => /^Override size:/i.test(l));
+    const physical = lines.find((l) => /^Physical size:/i.test(l));
+    const line = override ?? physical;
+    if (!line) {
+        // Fallback: assume the resolution this device showed in dump_ui — 1220x2712.
+        return { width: 1220, height: 2712 };
+    }
+    const m = /(\d+)x(\d+)/.exec(line);
+    if (!m)
+        return { width: 1220, height: 2712 };
+    return { width: Number(m[1]), height: Number(m[2]) };
+}
+export function registerScrollUntilVisible(server) {
+    server.registerTool("scroll_until_visible", {
+        title: "Scroll the screen until a UI element becomes visible",
+        description: "Dump UI; if the selector matches, return immediately. Otherwise swipe " +
+            "in the given direction (default \"down\") and redump, up to max_scrolls " +
+            "times. Returns {found: false} when exhausted — NOT an error. The AI " +
+            "decides whether to keep trying or change strategy.",
+        inputSchema: {
+            by: z
+                .enum(["text", "resource_id", "content_desc"])
+                .describe("Which attribute to match on."),
+            value: z.string().min(1).describe("Value to look up."),
+            exact: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Exact match (ignored for resource_id which is always exact)."),
+            direction: z
+                .enum(["up", "down"])
+                .optional()
+                .default("down")
+                .describe("Which way to swipe between dumps."),
+            max_scrolls: z
+                .number()
+                .int()
+                .positive()
+                .max(50)
+                .optional()
+                .default(10)
+                .describe("Stop after this many swipes (default 10)."),
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            found: z.boolean(),
+            scrolls_performed: z.number().int().nonnegative(),
+            bounds: z
+                .object({
+                x1: z.number(),
+                y1: z.number(),
+                x2: z.number(),
+                y2: z.number(),
+            })
+                .optional(),
+            center: z
+                .object({ x: z.number(), y: z.number() })
+                .optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ by, value, exact, direction, max_scrolls, device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const selector = by === "resource_id" ? { by, value } : { by, value, exact };
+            const { width, height } = await getScreenSize(deviceArgs);
+            const result = await scrollAndSearch(async () => (await fetchUiDump(deviceArgs)).nodes, async () => {
+                await runAdb(buildSwipeArgs(deviceArgs, direction, width, height));
+            }, selector, { maxScrolls: max_scrolls });
+            const msg = result.found
+                ? `Found ${by}="${value}" after ${result.scrolls_performed} scroll${result.scrolls_performed === 1 ? "" : "s"} on ${serial}.`
+                : `Did not find ${by}="${value}" after ${result.scrolls_performed} scrolls on ${serial}.`;
+            return {
+                content: [{ type: "text", text: msg }],
+                structuredContent: { device_id: serial, ...result },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=scroll-until-visible.js.map

package/dist/tools/scroll-until-visible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-until-visible.js","sourceRoot":"","sources":["../../src/tools/scroll-until-visible.ts"],"names":[],"mappings":"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"}

package/dist/tools/start-pair-qr.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+interface PendingSession {
+    password: string;
+    expiresAt: number;
+}
+export declare function consumeSession(serviceName: string): PendingSession | undefined;
+export declare function __pendingForTest(): Map<string, PendingSession>;
+export declare function clearPending(): void;
+export declare function registerSessionForTest(serviceName: string, password: string, expiresAt: number): void;
+export declare function registerStartPairQr(server: McpServer): void;
+export {};

package/dist/tools/start-pair-qr.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { randomBytes } from "node:crypto";
+import { buildQrText } from "../qrText.js";
+import { toolErrorFrom } from "../toolResult.js";
+const pending = new Map();
+function pruneExpired() {
+    const now = Date.now();
+    for (const [k, v] of pending.entries()) {
+        if (v.expiresAt <= now)
+            pending.delete(k);
+    }
+}
+export function consumeSession(serviceName) {
+    pruneExpired();
+    const s = pending.get(serviceName);
+    if (!s)
+        return undefined;
+    pending.delete(serviceName);
+    return s;
+}
+export function __pendingForTest() {
+    pruneExpired();
+    return pending;
+}
+export function clearPending() {
+    pending.clear();
+}
+export function registerSessionForTest(serviceName, password, expiresAt) {
+    pending.set(serviceName, { password, expiresAt });
+}
+const DEFAULT_EXPIRES_IN_MS = 60_000;
+export function registerStartPairQr(server) {
+    server.registerTool("start_pair_qr", {
+        title: "Generate a wireless-ADB pairing QR",
+        description: "Generate a QR-code payload (WIFI:T:ADB;S:<name>;P:<password>;;) for Android's " +
+            "Wireless debugging → Pair device with QR code flow. Returns the QR text plus the " +
+            "service_name to pass to wait_for_pair. The QR expires in 60 seconds.",
+        inputSchema: {},
+        outputSchema: {
+            qr_text: z.string(),
+            service_name: z.string(),
+            expires_at_ms: z.number().int(),
+        },
+        annotations: { readOnlyHint: false, openWorldHint: false },
+    }, async () => {
+        try {
+            const serviceName = `fling-debug-${randomBytes(2).toString("hex")}`;
+            const password = randomBytes(12).toString("base64").replace(/[=+/]/g, "");
+            const expiresAt = Date.now() + DEFAULT_EXPIRES_IN_MS;
+            const qrText = buildQrText({ serviceName, password });
+            pending.set(serviceName, { password, expiresAt });
+            return {
+                content: [{ type: "text", text: `QR payload: ${qrText}\nService name: ${serviceName}\nExpires in ~60s.` }],
+                structuredContent: { qr_text: qrText, service_name: serviceName, expires_at_ms: expiresAt },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=start-pair-qr.js.map

package/dist/tools/start-pair-qr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-pair-qr.js","sourceRoot":"","sources":["../../src/tools/start-pair-qr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;AAElD,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG;YAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,YAAY,EAAE,CAAC;IACf,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,YAAY,EAAE,CAAC;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,QAAgB,EAAE,SAAiB;IAC7F,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,gFAAgF;YAChF,mFAAmF;YACnF,sEAAsE;QACxE,WAAW,EAAE,EAAE;QACf,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;SAChC;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KAC3D,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,eAAe,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAC;YACrD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,MAAM,mBAAmB,WAAW,oBAAoB,EAAE,CAAC;gBACnH,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE;aAC5F,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/stop-app.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStopApp(server: McpServer): void;

package/dist/tools/stop-app.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { runAdb } from "../adb.js";
+import { loadFlingConfig } from "../config.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { FlingError } from "../errors.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+import { validatePackage } from "./launch-app.js";
+export function registerStopApp(server) {
+    server.registerTool("stop_app", {
+        title: "Force-stop an Android app",
+        description: "Issue `adb shell am force-stop <package>` to terminate every process of the named app. " +
+            "Force-stopping an already-stopped app is a no-op (idempotent). " +
+            "When `package_name` is omitted, falls back to fling.config.json packageName.",
+        inputSchema: {
+            package_name: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("App package name. Optional if set in fling.config.json."),
+            device_id: deviceIdInput,
+            cwd: z
+                .string()
+                .optional()
+                .describe("Starting directory for config lookup. Defaults to the MCP server's cwd."),
+        },
+        outputSchema: {
+            device_id: z.string(),
+            package_name: z.string(),
+            message: z.string(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ package_name, device_id, cwd }) => {
+        try {
+            const loaded = await loadFlingConfig(cwd ?? process.cwd());
+            const pkg = package_name ?? loaded.config.packageName;
+            if (!pkg) {
+                throw new FlingError("CONFIG_MISSING", "stop_app needs a package_name (argument or config.packageName).");
+            }
+            validatePackage(pkg);
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            await runAdb([...deviceArgs, "shell", "am", "force-stop", pkg]);
+            // `am force-stop` exits 0 and prints nothing whether the app was
+            // running, stopped, or never installed. The success message reflects
+            // that — we sent the signal; we can't claim a process was actually
+            // killed without a separate `pidof` check.
+            const text = `Force-stop signal sent to ${pkg} on ${serial} (no-op if the app wasn't running or isn't installed).`;
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: { device_id: serial, package_name: pkg, message: text },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=stop-app.js.map

package/dist/tools/stop-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-app.js","sourceRoot":"","sources":["../../src/tools/stop-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,yFAAyF;YACzF,iEAAiE;YACjE,8EAA8E;QAChF,WAAW,EAAE;YACX,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,yDAAyD,CAAC;YACtE,SAAS,EAAE,aAAa;YACxB,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;SACvF;QACD,YAAY,EAAE;YACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3D,MAAM,GAAG,GAAG,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACtD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,iEAAiE,CAClE,CAAC;YACJ,CAAC;YACD,eAAe,CAAC,GAAG,CAAC,CAAC;YAErB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACxE,MAAM,MAAM,CAAC,CAAC,GAAG,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;YAEhE,iEAAiE;YACjE,qEAAqE;YACrE,mEAAmE;YACnE,2CAA2C;YAC3C,MAAM,IAAI,GAAG,6BAA6B,GAAG,OAAO,MAAM,wDAAwD,CAAC;YACnH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;gBAC1C,iBAAiB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;aAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tap-by-content-desc.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type UiNode } from "../uiDump.js";
+export interface ContentDescTapTarget {
+    tap_x: number;
+    tap_y: number;
+    bounds: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    matched_content_desc: string;
+    fell_back_to_match: boolean;
+    candidates_count: number;
+}
+export declare function selectTapByContentDesc(nodes: UiNode[], contentDesc: string, exact: boolean): ContentDescTapTarget | null;
+export declare function registerTapByContentDesc(server: McpServer): void;

package/dist/tools/tap-by-content-desc.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+import { fetchUiDump } from "../uiDump.js";
+import { findNodes, pickBest } from "../uiSelector.js";
+import { runAdb } from "../adb.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { FlingError } from "../errors.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+import { buildTapArgs } from "./tap-by-text.js";
+export function selectTapByContentDesc(nodes, contentDesc, exact) {
+    const matches = findNodes(nodes, {
+        by: "content_desc",
+        value: contentDesc,
+        exact,
+    });
+    if (matches.length === 0)
+        return null;
+    const best = pickBest(matches, nodes);
+    if (!best)
+        return null;
+    return {
+        tap_x: best.node.center.x,
+        tap_y: best.node.center.y,
+        bounds: best.node.bounds,
+        matched_content_desc: matches[0].content_desc,
+        fell_back_to_match: best.fellBackToMatch,
+        candidates_count: matches.length,
+    };
+}
+export function registerTapByContentDesc(server) {
+    server.registerTool("tap_by_content_desc", {
+        title: "Tap a UI element by accessibility label (content-desc)",
+        description: "Dump UI, find the first node whose content-desc matches, and tap the " +
+            "smallest clickable container whose bounds contain it. Substring matching " +
+            "is case-sensitive by default; pass exact:true for strict equality. " +
+            "Used for icon buttons with no visible text (Search, Back, Account).",
+        inputSchema: {
+            content_desc: z
+                .string()
+                .min(1)
+                .describe("Accessibility label to match."),
+            exact: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Require equality instead of case-sensitive substring."),
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            matched_content_desc: z.string(),
+            bounds: z.object({
+                x1: z.number(),
+                y1: z.number(),
+                x2: z.number(),
+                y2: z.number(),
+            }),
+            tap_x: z.number(),
+            tap_y: z.number(),
+            candidates_count: z.number().int().nonnegative(),
+            fell_back_to_match: z.boolean(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ content_desc, exact, device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const { nodes } = await fetchUiDump(deviceArgs);
+            const target = selectTapByContentDesc(nodes, content_desc, exact);
+            if (!target) {
+                throw new FlingError("UI_ELEMENT_NOT_FOUND", `No clickable element found for content_desc="${content_desc}" on ${serial}.`);
+            }
+            await runAdb(buildTapArgs(deviceArgs, target.tap_x, target.tap_y));
+            const msg = `Tapped content_desc="${target.matched_content_desc}" at (${target.tap_x}, ${target.tap_y}) on ${serial}.`;
+            return {
+                content: [{ type: "text", text: msg }],
+                structuredContent: {
+                    device_id: serial,
+                    matched_content_desc: target.matched_content_desc,
+                    bounds: target.bounds,
+                    tap_x: target.tap_x,
+                    tap_y: target.tap_y,
+                    candidates_count: target.candidates_count,
+                    fell_back_to_match: target.fell_back_to_match,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=tap-by-content-desc.js.map

package/dist/tools/tap-by-content-desc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-by-content-desc.js","sourceRoot":"","sources":["../../src/tools/tap-by-content-desc.ts"],"names":[],"mappings":"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"}

package/dist/tools/tap-by-resource-id.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type UiNode } from "../uiDump.js";
+export interface ResourceIdTapTarget {
+    tap_x: number;
+    tap_y: number;
+    bounds: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    matched_resource_id: string;
+    fell_back_to_match: boolean;
+    candidates_count: number;
+}
+export declare function selectTapByResourceId(nodes: UiNode[], resourceId: string): ResourceIdTapTarget | null;
+export declare function registerTapByResourceId(server: McpServer): void;

package/dist/tools/tap-by-resource-id.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { fetchUiDump } from "../uiDump.js";
+import { findNodes, pickBest } from "../uiSelector.js";
+import { runAdb } from "../adb.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { FlingError } from "../errors.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+import { buildTapArgs } from "./tap-by-text.js";
+export function selectTapByResourceId(nodes, resourceId) {
+    const matches = findNodes(nodes, { by: "resource_id", value: resourceId });
+    if (matches.length === 0)
+        return null;
+    const best = pickBest(matches, nodes);
+    if (!best)
+        return null;
+    return {
+        tap_x: best.node.center.x,
+        tap_y: best.node.center.y,
+        bounds: best.node.bounds,
+        matched_resource_id: matches[0].resource_id,
+        fell_back_to_match: best.fellBackToMatch,
+        candidates_count: matches.length,
+    };
+}
+export function registerTapByResourceId(server) {
+    server.registerTool("tap_by_resource_id", {
+        title: "Tap a UI element by its Android resource ID",
+        description: "Dump UI, find the node with the exact resource_id, and tap the smallest " +
+            "clickable container whose bounds contain it. Resource IDs are unique by " +
+            "construction — typically 0 or 1 match. Most robust selector when you " +
+            "know the id (survives localization changes). No scroll_into_view; " +
+            "compose with scroll_until_visible if the element is off-screen.",
+        inputSchema: {
+            resource_id: z
+                .string()
+                .min(1)
+                .describe("Full Android resource ID (e.g. com.google.android.apps.photos:id/searchbar)."),
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            matched_resource_id: z.string(),
+            bounds: z.object({
+                x1: z.number(),
+                y1: z.number(),
+                x2: z.number(),
+                y2: z.number(),
+            }),
+            tap_x: z.number(),
+            tap_y: z.number(),
+            candidates_count: z.number().int().nonnegative(),
+            fell_back_to_match: z.boolean(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ resource_id, device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const { nodes } = await fetchUiDump(deviceArgs);
+            const target = selectTapByResourceId(nodes, resource_id);
+            if (!target) {
+                throw new FlingError("UI_ELEMENT_NOT_FOUND", `No clickable element found for resource_id="${resource_id}" on ${serial}.`);
+            }
+            await runAdb(buildTapArgs(deviceArgs, target.tap_x, target.tap_y));
+            const msg = `Tapped resource_id="${target.matched_resource_id}" at (${target.tap_x}, ${target.tap_y}) on ${serial}.`;
+            return {
+                content: [{ type: "text", text: msg }],
+                structuredContent: {
+                    device_id: serial,
+                    matched_resource_id: target.matched_resource_id,
+                    bounds: target.bounds,
+                    tap_x: target.tap_x,
+                    tap_y: target.tap_y,
+                    candidates_count: target.candidates_count,
+                    fell_back_to_match: target.fell_back_to_match,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=tap-by-resource-id.js.map

package/dist/tools/tap-by-resource-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-by-resource-id.js","sourceRoot":"","sources":["../../src/tools/tap-by-resource-id.ts"],"names":[],"mappings":"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"}

package/dist/tools/tap-by-text.d.ts

@@ -0,0 +1,40 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type UiNode } from "../uiDump.js";
+export declare function buildTapArgs(deviceArgs: string[], x: number, y: number): string[];
+/**
+ * Build the adb argv for a long-press at (x, y) held for `durationMs`. A
+ * long-press is a zero-length swipe — start and end coordinates are
+ * identical; only the duration matters.
+ */
+export declare function buildLongPressArgs(deviceArgs: string[], x: number, y: number, durationMs: number): string[];
+export interface TapDispatchInput {
+    deviceArgs: string[];
+    x: number;
+    y: number;
+    holdMs?: number;
+}
+/**
+ * Pick between a plain tap and a long-press based on holdMs. Returns the
+ * adb argv to run. Extracted so the dispatch decision is unit-testable
+ * without driving a real device.
+ */
+export declare function tapDispatchArgs(input: TapDispatchInput): string[];
+export interface TapTarget {
+    tap_x: number;
+    tap_y: number;
+    bounds: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    matched_text: string;
+    fell_back_to_match: boolean;
+    candidates_count: number;
+}
+export declare function selectTapTarget(nodes: UiNode[], selector: {
+    by: "text";
+    value: string;
+    exact?: boolean;
+}): TapTarget | null;
+export declare function registerTapByText(server: McpServer): void;