@0xhayd3n/fling 0.6.0

package/dist/tools/tap-by-text.js

@@ -0,0 +1,180 @@
+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";
+const SCROLL_INTO_VIEW_MAX_SWIPES = 5;
+export function buildTapArgs(deviceArgs, x, y) {
+    return [...deviceArgs, "shell", "input", "tap", String(x), String(y)];
+}
+/**
+ * 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 function buildLongPressArgs(deviceArgs, x, y, durationMs) {
+    return [
+        ...deviceArgs,
+        "shell",
+        "input",
+        "swipe",
+        String(x),
+        String(y),
+        String(x),
+        String(y),
+        String(durationMs),
+    ];
+}
+/**
+ * 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 function tapDispatchArgs(input) {
+    return input.holdMs
+        ? buildLongPressArgs(input.deviceArgs, input.x, input.y, input.holdMs)
+        : buildTapArgs(input.deviceArgs, input.x, input.y);
+}
+export function selectTapTarget(nodes, selector) {
+    const matches = findNodes(nodes, selector);
+    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_text: matches[0].text,
+        fell_back_to_match: best.fellBackToMatch,
+        candidates_count: matches.length,
+    };
+}
+async function swipeDownFullScreen(deviceArgs) {
+    // Coordinates picked to be safe on a wide range of phone resolutions.
+    // 500ms slow-drag avoids being recognized as a fling that overshoots.
+    await runAdb([
+        ...deviceArgs,
+        "shell",
+        "input",
+        "swipe",
+        "500",
+        "1500",
+        "500",
+        "500",
+        "500",
+    ]);
+}
+export function registerTapByText(server) {
+    server.registerTool("tap_by_text", {
+        title: "Tap (or long-press) a UI element by visible text",
+        description: "Dump UI, find the first node whose text matches, and tap the smallest " +
+            "clickable container whose bounds contain it — folding dump + filter + " +
+            "input dispatch into one call. " +
+            "Substring matching is case-sensitive by default; pass exact:true for " +
+            "strict equality. With scroll_into_view:true, performs up to 5 down-swipes " +
+            "if the element is not currently visible. " +
+            "Pass hold_ms to long-press for the given duration instead of tapping — " +
+            "useful for context menus and drag handles. " +
+            "For icon buttons with no text, use tap_by_content_desc. For non-localized " +
+            "or robust targeting, prefer tap_by_resource_id.",
+        inputSchema: {
+            text: z.string().min(1).describe("Visible text to match."),
+            exact: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Require equality instead of case-sensitive substring."),
+            scroll_into_view: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("If the element is not visible, swipe down up to 5 times searching for it."),
+            hold_ms: z
+                .number()
+                .int()
+                .positive()
+                .max(10_000)
+                .optional()
+                .describe("If set, long-press for this many milliseconds instead of tapping. Range 1–10000."),
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            matched_text: 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(),
+            scrolled_into_view: z.boolean(),
+            candidates_count: z.number().int().nonnegative(),
+            fell_back_to_match: z.boolean(),
+            hold_ms: z.number().int().positive().optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ text, exact, scroll_into_view, hold_ms, device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            let target = null;
+            let scrolled = false;
+            const { nodes } = await fetchUiDump(deviceArgs);
+            target = selectTapTarget(nodes, { by: "text", value: text, exact });
+            if (!target && scroll_into_view) {
+                for (let i = 0; i < SCROLL_INTO_VIEW_MAX_SWIPES; i++) {
+                    await swipeDownFullScreen(deviceArgs);
+                    scrolled = true;
+                    const { nodes: nextNodes } = await fetchUiDump(deviceArgs);
+                    target = selectTapTarget(nextNodes, {
+                        by: "text",
+                        value: text,
+                        exact,
+                    });
+                    if (target)
+                        break;
+                }
+            }
+            if (!target) {
+                throw new FlingError("UI_ELEMENT_NOT_FOUND", `No clickable element found for text="${text}" on ${serial}${scroll_into_view ? " (after scrolling)" : ""}.`);
+            }
+            await runAdb(tapDispatchArgs({
+                deviceArgs,
+                x: target.tap_x,
+                y: target.tap_y,
+                holdMs: hold_ms,
+            }));
+            const verb = hold_ms ? `Long-pressed (${hold_ms}ms)` : "Tapped";
+            const msg = `${verb} "${target.matched_text}" at (${target.tap_x}, ${target.tap_y}) on ${serial}${target.candidates_count > 1 ? ` [${target.candidates_count} candidates; took first]` : ""}.`;
+            return {
+                content: [{ type: "text", text: msg }],
+                structuredContent: {
+                    device_id: serial,
+                    matched_text: target.matched_text,
+                    bounds: target.bounds,
+                    tap_x: target.tap_x,
+                    tap_y: target.tap_y,
+                    scrolled_into_view: scrolled,
+                    candidates_count: target.candidates_count,
+                    fell_back_to_match: target.fell_back_to_match,
+                    hold_ms,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=tap-by-text.js.map

package/dist/tools/tap-by-text.js.map

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

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

@@ -0,0 +1,37 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { UiNode } from "../uiDump.js";
+export interface TapAndVerifyInput {
+    text: string;
+    expect?: string;
+    gone?: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    dumpFn: () => Promise<UiNode[]>;
+    tapFn: (x: number, y: number) => Promise<void>;
+    sleepFn: (ms: number) => Promise<void>;
+    nowFn: () => number;
+}
+export interface TapAndVerifyResult {
+    tapped: boolean;
+    verified: boolean;
+    before_node: {
+        text: string;
+        center: {
+            x: number;
+            y: number;
+        };
+    };
+}
+/**
+ * Atomic semantic tap: find a node by text, tap its center, optionally
+ * re-dump and verify a follow-up condition. Saves the Claude round-trip
+ * that would otherwise be dump → reason → tap → re-dump → check.
+ *
+ * Verify modes:
+ *   - expect: a string that should APPEAR in the post-tap dump
+ *   - gone:   a string that should be ABSENT from the post-tap dump
+ * If both are provided, verified=true if EITHER condition holds (OR).
+ * If neither is provided, verified=true immediately after the tap.
+ */
+export declare function tapAndVerify(input: TapAndVerifyInput): Promise<TapAndVerifyResult>;
+export declare function registerTapTextVerified(server: McpServer): void;

package/dist/tools/tap-text-verified.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { runAdb } from "../adb.js";
+import { fetchUiDump } from "../uiDump.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { FlingError } from "../errors.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+/**
+ * Atomic semantic tap: find a node by text, tap its center, optionally
+ * re-dump and verify a follow-up condition. Saves the Claude round-trip
+ * that would otherwise be dump → reason → tap → re-dump → check.
+ *
+ * Verify modes:
+ *   - expect: a string that should APPEAR in the post-tap dump
+ *   - gone:   a string that should be ABSENT from the post-tap dump
+ * If both are provided, verified=true if EITHER condition holds (OR).
+ * If neither is provided, verified=true immediately after the tap.
+ */
+export async function tapAndVerify(input) {
+    const timeoutMs = input.timeoutMs ?? 5000;
+    const pollIntervalMs = input.pollIntervalMs ?? 250;
+    const initial = await input.dumpFn();
+    const target = initial.find((n) => n.text.includes(input.text));
+    if (!target) {
+        throw new FlingError("UI_ELEMENT_NOT_FOUND", `No node matches text="${input.text}".`);
+    }
+    await input.tapFn(target.center.x, target.center.y);
+    const before_node = { text: target.text, center: target.center };
+    if (!input.expect && !input.gone) {
+        return { tapped: true, verified: true, before_node };
+    }
+    const start = input.nowFn();
+    while (input.nowFn() - start < timeoutMs) {
+        await input.sleepFn(pollIntervalMs);
+        const dump = await input.dumpFn();
+        if (input.expect && dump.some((n) => n.text.includes(input.expect))) {
+            return { tapped: true, verified: true, before_node };
+        }
+        if (input.gone && !dump.some((n) => n.text.includes(input.gone))) {
+            return { tapped: true, verified: true, before_node };
+        }
+    }
+    return { tapped: true, verified: false, before_node };
+}
+export function registerTapTextVerified(server) {
+    server.registerTool("tap_text_verified", {
+        title: "Atomically tap a text node and verify the result",
+        description: "One-shot: dump UI, find a node containing `text`, tap its center, " +
+            "then optionally re-dump and verify `expect` appears (or `gone` is " +
+            "absent). Saves the dump-reason-tap-verify round-trips. Prefer over " +
+            "separate dump_ui + tap_by_text when the goal includes verification.",
+        inputSchema: {
+            device_id: deviceIdInput,
+            text: z.string().min(1),
+            expect: z.string().optional(),
+            gone: z.string().optional(),
+            timeout_ms: z.number().int().positive().optional(),
+        },
+        outputSchema: {
+            device_id: z.string(),
+            tapped: z.boolean(),
+            verified: z.boolean(),
+            before_node: z.object({
+                text: z.string(),
+                center: z.object({ x: z.number(), y: z.number() }),
+            }),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ device_id, text, expect, gone, timeout_ms }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const result = await tapAndVerify({
+                text,
+                expect,
+                gone,
+                timeoutMs: timeout_ms,
+                dumpFn: async () => (await fetchUiDump(deviceArgs)).nodes,
+                tapFn: async (x, y) => {
+                    await runAdb([
+                        ...deviceArgs,
+                        "shell",
+                        "input",
+                        "tap",
+                        String(x),
+                        String(y),
+                    ]);
+                },
+                sleepFn: (ms) => new Promise((r) => setTimeout(r, ms)),
+                nowFn: () => Date.now(),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Tapped "${result.before_node.text}" on ${serial} — verified=${result.verified}`,
+                    },
+                ],
+                structuredContent: { device_id: serial, ...result },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=tap-text-verified.js.map

package/dist/tools/tap-text-verified.js.map

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

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

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

package/dist/tools/uninstall-app.js

@@ -0,0 +1,96 @@
+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 registerUninstallApp(server) {
+    server.registerTool("uninstall_app", {
+        title: "Uninstall an Android app",
+        description: "Remove an installed app via `adb uninstall`. Pass `keep_data: true` to keep the " +
+            "app's data and cache directories (adb's -k flag). 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."),
+            keep_data: z
+                .boolean()
+                .optional()
+                .describe("Pass -k (keep data and cache directories). Default false."),
+            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(),
+            success: z.boolean(),
+            already_absent: z.boolean(),
+            message: z.string(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ package_name, keep_data, 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", "uninstall_app needs a package_name (argument or config.packageName).");
+            }
+            validatePackage(pkg);
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const uninstallArgs = ["uninstall"];
+            if (keep_data)
+                uninstallArgs.push("-k");
+            uninstallArgs.push(pkg);
+            const { stdout, stderr } = await runAdb([...deviceArgs, ...uninstallArgs]);
+            const combined = `${stdout}\n${stderr}`;
+            if (/^Success\b/m.test(combined)) {
+                const text = `Uninstalled ${pkg} from ${serial}.`;
+                return {
+                    content: [{ type: "text", text }],
+                    structuredContent: {
+                        device_id: serial,
+                        package_name: pkg,
+                        success: true,
+                        already_absent: false,
+                        message: text,
+                    },
+                };
+            }
+            // Modern adb (Android 9+) returns "Failure [DELETE_FAILED_INTERNAL_ERROR]"
+            // when the package isn't installed. Older clients used "Unknown package".
+            // The verbose API 30+ exception form catches future variants.
+            const alreadyAbsent = /DELETE_FAILED_INTERNAL_ERROR|Unknown package|Exception occurred while executing 'uninstall'/i.test(combined);
+            const text = alreadyAbsent
+                ? `${pkg} was not installed on ${serial} — nothing to uninstall.`
+                : `Uninstall failed on ${serial}: ${combined.trim()}`;
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: {
+                    device_id: serial,
+                    package_name: pkg,
+                    success: false,
+                    already_absent: alreadyAbsent,
+                    message: text,
+                },
+                isError: !alreadyAbsent,
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=uninstall-app.js.map

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

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

package/dist/tools/wait-for-pair.d.ts

@@ -0,0 +1,29 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PairStatus } from "../pairing.js";
+type OrchestratorFn = (args: {
+    serviceName: string;
+    password: string;
+    timeoutMs: number;
+}) => Promise<PairStatus>;
+export declare function __setOrchestratorForTest(fn: OrchestratorFn | null): void;
+export interface WaitForPairArgs {
+    service_name: string;
+    timeout_ms?: number;
+}
+export declare function handleWaitForPair(args: WaitForPairArgs): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: {
+        paired: boolean;
+        serial?: string;
+        model?: string;
+        error?: {
+            code: string;
+            message: string;
+        };
+    };
+}>;
+export declare function registerWaitForPair(server: McpServer): void;
+export {};

package/dist/tools/wait-for-pair.js

@@ -0,0 +1,132 @@
+import { z } from "zod";
+import { toolErrorFrom } from "../toolResult.js";
+import { consumeSession } from "./start-pair-qr.js";
+const realOrchestrator = async ({ serviceName, password, timeoutMs }) => {
+    const { discoverPairingPort, discoverConnectByHost } = await import("../mdns.js");
+    const { runAdb } = await import("../adb.js");
+    let host;
+    let port;
+    try {
+        const r = await discoverPairingPort(serviceName, timeoutMs);
+        host = r.host;
+        port = r.port;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "MDNS_UNAVAILABLE")
+            return { kind: "error", reason: "mDNS daemon unavailable" };
+        return { kind: "timeout" };
+    }
+    try {
+        await runAdb(["pair", `${host}:${port}`, password]);
+    }
+    catch (err) {
+        const e = err;
+        return { kind: "error", reason: (e.stderr && e.stderr.trim()) || e.message || "adb pair failed", rawAdbError: e.stderr };
+    }
+    let connectHost = host;
+    let connectPort = port;
+    try {
+        const r = await discoverConnectByHost(host, 10_000);
+        connectHost = r.host;
+        connectPort = r.port;
+    }
+    catch {
+        // Fall through with pairing host:port — adb connect will surface a clean error.
+    }
+    try {
+        await runAdb(["connect", `${connectHost}:${connectPort}`]);
+    }
+    catch (err) {
+        const e = err;
+        return { kind: "error", reason: (e.stderr && e.stderr.trim()) || e.message || "adb connect failed", rawAdbError: e.stderr };
+    }
+    const { stdout } = await runAdb(["devices", "-l"]);
+    const serial = `${connectHost}:${connectPort}`;
+    for (const line of stdout.split(/\r?\n/)) {
+        if (!line.includes(serial))
+            continue;
+        const parts = line.trim().split(/\s+/);
+        if (parts[1] !== "device")
+            continue;
+        const modelMatch = parts.find((p) => p.startsWith("model:"));
+        return { kind: "success", serial: parts[0], model: modelMatch ? modelMatch.slice(6) : "Unknown" };
+    }
+    return { kind: "error", reason: `Paired ${serial} but device not ready.` };
+};
+let orchestratorImpl = realOrchestrator;
+export function __setOrchestratorForTest(fn) {
+    orchestratorImpl = fn ?? realOrchestrator;
+}
+const ERROR_CODE_BY_STATUS = {
+    timeout: "PAIRING_TIMEOUT",
+    error: "ADB_PAIR_FAILED",
+};
+export async function handleWaitForPair(args) {
+    const session = consumeSession(args.service_name);
+    if (!session) {
+        return {
+            content: [{ type: "text", text: `No active pairing session for '${args.service_name}'.` }],
+            structuredContent: {
+                paired: false,
+                error: { code: "UNKNOWN_SERVICE", message: "service_name does not match a recent start_pair_qr call." },
+            },
+        };
+    }
+    const timeoutMs = args.timeout_ms ?? 60_000;
+    const status = await orchestratorImpl({
+        serviceName: args.service_name,
+        password: session.password,
+        timeoutMs,
+    });
+    if (status.kind === "success") {
+        return {
+            content: [{ type: "text", text: `Paired ${status.serial} (${status.model}).` }],
+            structuredContent: { paired: true, serial: status.serial, model: status.model },
+        };
+    }
+    if (status.kind === "timeout") {
+        return {
+            content: [{ type: "text", text: "Pairing timed out before the phone scanned the QR." }],
+            structuredContent: {
+                paired: false,
+                error: { code: "PAIRING_TIMEOUT", message: `No phone scanned within ${timeoutMs}ms.` },
+            },
+        };
+    }
+    const reason = status.kind === "error" ? status.reason : `Unexpected pairing status: ${status.kind}`;
+    return {
+        content: [{ type: "text", text: `Pairing failed: ${reason}` }],
+        structuredContent: {
+            paired: false,
+            error: { code: ERROR_CODE_BY_STATUS[status.kind] ?? "ADB_PAIR_FAILED", message: reason },
+        },
+    };
+}
+export function registerWaitForPair(server) {
+    server.registerTool("wait_for_pair", {
+        title: "Wait for a phone to scan a pairing QR",
+        description: "Block until a phone scans a QR generated by start_pair_qr and the pair + connect " +
+            "handshake completes. Returns { paired, serial?, model? } on success or { paired: false, error } on " +
+            "timeout/failure. Default timeout 60s.",
+        inputSchema: {
+            service_name: z.string().describe("The service_name returned by a prior start_pair_qr call."),
+            timeout_ms: z.number().int().positive().optional().describe("Timeout in milliseconds. Default 60000."),
+        },
+        outputSchema: {
+            paired: z.boolean(),
+            serial: z.string().optional(),
+            model: z.string().optional(),
+            error: z.object({ code: z.string(), message: z.string() }).optional(),
+        },
+        annotations: { readOnlyHint: false, openWorldHint: true },
+    }, async (args) => {
+        try {
+            return await handleWaitForPair(args);
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=wait-for-pair.js.map

package/dist/tools/wait-for-pair.js.map

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

package/dist/tools/wait-for.d.ts

@@ -0,0 +1,26 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type UiNode } from "../uiDump.js";
+import { type Selector } from "../uiSelector.js";
+export interface PollUntilFoundOptions {
+    timeoutMs: number;
+    pollIntervalMs: number;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface PollUntilFoundResult {
+    found: true;
+    attempts: number;
+    elapsed_ms: number;
+    bounds: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    center: {
+        x: number;
+        y: number;
+    };
+}
+export declare function pollUntilFound(dumpFn: () => Promise<UiNode[]>, selector: Selector, options: PollUntilFoundOptions): Promise<PollUntilFoundResult>;
+export declare function registerWaitFor(server: McpServer): void;