@0xhayd3n/fling 0.6.0

package/dist/tools/dump-ui.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { fetchUiDump, isInteresting } from "../uiDump.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+const uiNodeOut = z.object({
+    text: z.string(),
+    content_desc: z.string(),
+    resource_id: z.string(),
+    class: z.string(),
+    package: z.string(),
+    bounds: z.object({
+        x1: z.number(),
+        y1: z.number(),
+        x2: z.number(),
+        y2: z.number(),
+    }),
+    center: z.object({ x: z.number(), y: z.number() }),
+    clickable: z.boolean(),
+    long_clickable: z.boolean(),
+    scrollable: z.boolean(),
+    focusable: z.boolean(),
+    focused: z.boolean(),
+    enabled: z.boolean(),
+    selected: z.boolean(),
+    checkable: z.boolean(),
+    checked: z.boolean(),
+});
+// Re-export for backwards-compatibility with the existing test file's import path.
+export { parseUiHierarchy, isInteresting } from "../uiDump.js";
+export function registerDumpUi(server) {
+    server.registerTool("dump_ui", {
+        title: "Dump current UI hierarchy",
+        description: "Capture the visible Android view hierarchy via `uiautomator dump`. " +
+            "Returns a flat list of elements with text, content-desc, resource-id, " +
+            "bounds, and a pre-computed center {x,y}. Feed matches into " +
+            "`tap_by_text`, `tap_by_resource_id`, or `tap_by_content_desc` " +
+            "instead of computing tap coordinates from a screenshot. " +
+            "Defaults to interactive_only=true, which keeps nodes that are " +
+            "clickable / long-clickable / scrollable / focusable OR have any of " +
+            "text / content-desc / resource-id. " +
+            "When the goal includes verifying the tap worked, prefer " +
+            "`tap_text_verified` (one call vs three) or `screenshot_with_ui` " +
+            "when you need both visual and semantic data.",
+        inputSchema: {
+            device_id: deviceIdInput,
+            interactive_only: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Keep only nodes likely to matter for navigation. Set false to include layout containers and pure decorations."),
+            include_raw_xml: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Also return the raw uiautomator XML. Off by default because dense screens (heavy WebViews, long lists) can produce multi-MB payloads that risk breaching MCP transport size limits."),
+        },
+        outputSchema: {
+            device_id: z.string(),
+            node_count: z.number().int().nonnegative(),
+            nodes: z.array(uiNodeOut),
+            raw_xml: z.string().optional(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ device_id, interactive_only, include_raw_xml }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const { nodes: all, raw_xml } = await fetchUiDump(deviceArgs);
+            const nodes = interactive_only ? all.filter(isInteresting) : all;
+            const summary = interactive_only
+                ? `Parsed ${all.length} node${all.length === 1 ? "" : "s"} on ${serial}; ${nodes.length} interactive.`
+                : `Parsed ${nodes.length} node${nodes.length === 1 ? "" : "s"} on ${serial}.`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    device_id: serial,
+                    node_count: nodes.length,
+                    nodes,
+                    raw_xml: include_raw_xml ? raw_xml : undefined,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=dump-ui.js.map

package/dist/tools/dump-ui.js.map

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

package/dist/tools/find-on-screen.d.ts

@@ -0,0 +1,27 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type UiNode } from "../uiDump.js";
+import { type Selector } from "../uiSelector.js";
+export interface FindOnScreenMatch {
+    text: string;
+    content_desc: string;
+    resource_id: string;
+    bounds: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    center: {
+        x: number;
+        y: number;
+    };
+    clickable: boolean;
+}
+export interface FindOnScreenResult {
+    found: boolean;
+    count: number;
+    matches: FindOnScreenMatch[];
+    truncated: boolean;
+}
+export declare function buildFindOnScreenResult(nodes: UiNode[], selector: Selector): FindOnScreenResult;
+export declare function registerFindOnScreen(server: McpServer): void;

package/dist/tools/find-on-screen.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import { fetchUiDump } from "../uiDump.js";
+import { findNodes } from "../uiSelector.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+const MAX_MATCHES = 20;
+export function buildFindOnScreenResult(nodes, selector) {
+    const matched = findNodes(nodes, selector);
+    const matches = matched.slice(0, MAX_MATCHES).map((n) => ({
+        text: n.text,
+        content_desc: n.content_desc,
+        resource_id: n.resource_id,
+        bounds: n.bounds,
+        center: n.center,
+        clickable: n.clickable,
+    }));
+    return {
+        found: matched.length > 0,
+        count: matched.length,
+        matches,
+        truncated: matched.length > MAX_MATCHES,
+    };
+}
+export function registerFindOnScreen(server) {
+    server.registerTool("find_on_screen", {
+        title: "Find UI elements on the current screen (no action)",
+        description: "Pure query — no action taken. Returns up to 20 matches for the given selector. " +
+            "Use to assert state, disambiguate between multiple matches, or check whether " +
+            "something is visible before deciding what to do.",
+        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("When true, requires equality (ignored for resource_id which is always exact)."),
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            found: z.boolean(),
+            count: z.number().int().nonnegative(),
+            matches: z.array(z.object({
+                text: z.string(),
+                content_desc: z.string(),
+                resource_id: z.string(),
+                bounds: z.object({
+                    x1: z.number(),
+                    y1: z.number(),
+                    x2: z.number(),
+                    y2: z.number(),
+                }),
+                center: z.object({ x: z.number(), y: z.number() }),
+                clickable: z.boolean(),
+            })),
+            truncated: z.boolean(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ by, value, exact, device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const { nodes } = await fetchUiDump(deviceArgs);
+            const selector = by === "resource_id"
+                ? { by, value }
+                : { by, value, exact };
+            const result = buildFindOnScreenResult(nodes, selector);
+            const summary = result.found
+                ? `Found ${result.count} match${result.count === 1 ? "" : "es"} for ${by}="${value}" on ${serial}${result.truncated ? ` (showing first ${MAX_MATCHES})` : ""}.`
+                : `No matches for ${by}="${value}" on ${serial}.`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    device_id: serial,
+                    ...result,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=find-on-screen.js.map

package/dist/tools/find-on-screen.js.map

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

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

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function extractInstallFailure(stdout: string, stderr: string): {
+    code?: string;
+    raw: string;
+};
+export interface PerformInstallParams {
+    apkPath: string;
+    deviceArgs: string[];
+    reinstall: boolean;
+    grantRuntimePermissions: boolean;
+}
+export interface InstallResult {
+    success: boolean;
+    failureCode?: string;
+    rawFailure?: string;
+    message: string;
+}
+/**
+ * Run `adb install` and parse the result. Caller is responsible for verifying
+ * the apk exists and resolving device args.
+ */
+export declare function performInstall(params: PerformInstallParams): Promise<InstallResult>;
+export declare function registerInstallApp(server: McpServer): void;

package/dist/tools/install-app.js

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import { runAdb } from "../adb.js";
+import { loadFlingConfig, resolveBuildCwd } from "../config.js";
+import { resolveApk } from "../apkResolver.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+const INSTALL_TIMEOUT_MS = 180_000;
+const INSTALL_FAILURE_HINTS = {
+    INSTALL_FAILED_INSUFFICIENT_STORAGE: "The device is out of free space. Uninstall unused apps or clear caches and retry.",
+    INSTALL_FAILED_UPDATE_INCOMPATIBLE: "An app with the same package name is already installed with a different signing certificate. Uninstall it first (`uninstall_app`), then retry.",
+    INSTALL_FAILED_VERSION_DOWNGRADE: "The installed version is newer than the APK you're trying to install. Either bump the APK's versionCode or uninstall the existing app first.",
+    INSTALL_PARSE_FAILED_NO_CERTIFICATES: "The APK is unsigned. Sign it with apksigner (or build a signed variant) before installing.",
+    INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES: "The APK's signing certificates are inconsistent. Rebuild and re-sign.",
+    INSTALL_FAILED_MISSING_SHARED_LIBRARY: "The app depends on a shared library that isn't present on this device.",
+    INSTALL_FAILED_OLDER_SDK: "The APK requires a newer Android version than the device runs.",
+    INSTALL_FAILED_NEWER_SDK: "The APK targets an older Android version than the device supports.",
+    INSTALL_FAILED_NO_MATCHING_ABIS: "The APK doesn't include native libraries for the device's CPU architecture.",
+    INSTALL_FAILED_USER_RESTRICTED: "Installation was blocked by the user or a device policy.",
+};
+export function extractInstallFailure(stdout, stderr) {
+    const haystack = `${stdout}\n${stderr}`.trim();
+    const codeMatch = haystack.match(/INSTALL_(?:FAILED|PARSE_FAILED)_[A-Z_]+/);
+    const lines = haystack.split(/\r?\n/);
+    const markerIdx = lines.findIndex((l) => /adb: failed|^Failure\b|INSTALL_(?:FAILED|PARSE_FAILED)_/.test(l));
+    const raw = markerIdx >= 0
+        ? lines.slice(markerIdx, markerIdx + 3).join("\n").trim()
+        : haystack;
+    return { code: codeMatch?.[0], raw };
+}
+/**
+ * Run `adb install` and parse the result. Caller is responsible for verifying
+ * the apk exists and resolving device args.
+ */
+export async function performInstall(params) {
+    const installArgs = ["install"];
+    if (params.reinstall)
+        installArgs.push("-r");
+    if (params.grantRuntimePermissions)
+        installArgs.push("-g");
+    installArgs.push(params.apkPath);
+    const { stdout, stderr } = await runAdb([...params.deviceArgs, ...installArgs], {
+        timeoutMs: INSTALL_TIMEOUT_MS,
+    });
+    const combined = `${stdout}\n${stderr}`;
+    if (/^Success\b/m.test(combined)) {
+        return { success: true, message: `Installed ${params.apkPath}` };
+    }
+    const { code, raw } = extractInstallFailure(stdout, stderr);
+    const hint = code ? INSTALL_FAILURE_HINTS[code] : undefined;
+    const message = `Install failed: ${raw}${hint ? `\n\n→ ${hint}` : ""}`;
+    return { success: false, failureCode: code, rawFailure: raw, message };
+}
+export function registerInstallApp(server) {
+    server.registerTool("install_app", {
+        title: "Install an APK on a device",
+        description: "Push an .apk file to a connected Android device and install it via `adb install`. " +
+            "By default the install is a reinstall (-r) which preserves existing app data. " +
+            "When `apk_path` is omitted, Fling resolves it from fling.config.json (apkPath / apkGlob).",
+        inputSchema: {
+            apk_path: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Path to the .apk file on the host machine. If omitted, falls back to fling.config.json."),
+            device_id: deviceIdInput,
+            reinstall: z
+                .boolean()
+                .optional()
+                .describe("Pass -r (reinstall keeping data). Default true."),
+            grant_runtime_permissions: z
+                .boolean()
+                .optional()
+                .describe("Pass -g (grant all runtime permissions on install). Default false."),
+            cwd: z
+                .string()
+                .optional()
+                .describe("Starting directory for config lookup. Defaults to the MCP server's cwd."),
+        },
+        outputSchema: {
+            device_id: z.string(),
+            apk_path: z.string(),
+            apk_source: z.string(),
+            success: z.boolean(),
+            failure_code: z.string().optional(),
+            message: z.string(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ apk_path, device_id, reinstall, grant_runtime_permissions, cwd }) => {
+        try {
+            const loaded = await loadFlingConfig(cwd ?? process.cwd());
+            const buildCwd = resolveBuildCwd(loaded);
+            const apk = await resolveApk(apk_path, loaded.config, buildCwd);
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const result = await performInstall({
+                apkPath: apk.path,
+                deviceArgs,
+                reinstall: reinstall !== false,
+                grantRuntimePermissions: !!grant_runtime_permissions,
+            });
+            const text = result.success
+                ? `Installed ${apk.path} on ${serial}. (apk source: ${apk.source})`
+                : `Install failed on ${serial}.\n\n${result.message}`;
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: {
+                    device_id: serial,
+                    apk_path: apk.path,
+                    apk_source: apk.source,
+                    success: result.success,
+                    failure_code: result.failureCode,
+                    message: text,
+                },
+                isError: !result.success,
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=install-app.js.map

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

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

package/dist/tools/launch-and-wait.d.ts

@@ -0,0 +1,27 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { UiNode } from "../uiDump.js";
+export type ReadySelector = {
+    by: "text" | "resource_id";
+    value: string;
+};
+export interface LaunchAndWaitInput {
+    packageName: string;
+    readyWhen: ReadySelector;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    launchFn: (pkg: string) => Promise<void>;
+    dumpFn: () => Promise<UiNode[]>;
+    sleepFn: (ms: number) => Promise<void>;
+    nowFn: () => number;
+}
+export interface LaunchAndWaitResult {
+    ready: boolean;
+    attempts: number;
+}
+/**
+ * Launch a package via monkey, then poll the UI hierarchy until the
+ * readyWhen selector appears (or timeout). Saves the launch → wait →
+ * screenshot → check round-trip loop.
+ */
+export declare function launchAndWait(input: LaunchAndWaitInput): Promise<LaunchAndWaitResult>;
+export declare function registerLaunchAndWait(server: McpServer): void;

package/dist/tools/launch-and-wait.js

@@ -0,0 +1,103 @@
+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";
+function matchesSelector(nodes, sel) {
+    if (sel.by === "text")
+        return nodes.some((n) => n.text.includes(sel.value));
+    return nodes.some((n) => n.resource_id === sel.value);
+}
+/**
+ * Launch a package via monkey, then poll the UI hierarchy until the
+ * readyWhen selector appears (or timeout). Saves the launch → wait →
+ * screenshot → check round-trip loop.
+ */
+export async function launchAndWait(input) {
+    const timeoutMs = input.timeoutMs ?? 10_000;
+    const pollIntervalMs = input.pollIntervalMs ?? 250;
+    await input.launchFn(input.packageName);
+    const start = input.nowFn();
+    let attempts = 0;
+    while (input.nowFn() - start < timeoutMs) {
+        attempts++;
+        const dump = await input.dumpFn();
+        if (matchesSelector(dump, input.readyWhen)) {
+            return { ready: true, attempts };
+        }
+        await input.sleepFn(pollIntervalMs);
+    }
+    throw new FlingError("UI_WAIT_TIMEOUT", `Ready selector ${input.readyWhen.by}="${input.readyWhen.value}" did not appear within ${timeoutMs}ms after launching ${input.packageName}.`);
+}
+export function registerLaunchAndWait(server) {
+    server.registerTool("launch_and_wait", {
+        title: "Launch an app and wait until it's ready",
+        description: "Launch the package via monkey then poll dump_ui until a ready " +
+            "selector (text or resource_id) appears. Prefer over " +
+            "launch_app + repeated dump_ui calls when you need to wait for the " +
+            "UI to become interactive.",
+        inputSchema: {
+            device_id: deviceIdInput,
+            package_name: z.string().min(1),
+            ready_when_text: z.string().optional(),
+            ready_when_resource_id: z.string().optional(),
+            timeout_ms: z.number().int().positive().optional(),
+        },
+        outputSchema: {
+            device_id: z.string(),
+            ready: z.boolean(),
+            attempts: z.number().int().nonnegative(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ device_id, package_name, ready_when_text, ready_when_resource_id, timeout_ms, }) => {
+        try {
+            if (!ready_when_text && !ready_when_resource_id) {
+                throw new FlingError("INVALID_INPUT", "Provide either ready_when_text or ready_when_resource_id.");
+            }
+            const readyWhen = ready_when_text
+                ? { by: "text", value: ready_when_text }
+                : { by: "resource_id", value: ready_when_resource_id };
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const result = await launchAndWait({
+                packageName: package_name,
+                readyWhen,
+                timeoutMs: timeout_ms,
+                launchFn: async (pkg) => {
+                    await runAdb([
+                        ...deviceArgs,
+                        "shell",
+                        "monkey",
+                        "-p",
+                        pkg,
+                        "-c",
+                        "android.intent.category.LAUNCHER",
+                        "1",
+                    ]);
+                },
+                dumpFn: async () => (await fetchUiDump(deviceArgs)).nodes,
+                sleepFn: (ms) => new Promise((r) => setTimeout(r, ms)),
+                nowFn: () => Date.now(),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Launched ${package_name} on ${serial}; ready after ${result.attempts} dump(s).`,
+                    },
+                ],
+                structuredContent: { device_id: serial, ...result },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=launch-and-wait.js.map

package/dist/tools/launch-and-wait.js.map

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

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

@@ -0,0 +1,20 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function validatePackage(name: string): void;
+export declare function validateActivity(activity: string): void;
+export interface PerformLaunchParams {
+    packageName: string;
+    activity?: string;
+    deviceArgs: string[];
+}
+export interface LaunchResult {
+    success: boolean;
+    message: string;
+    raw: string;
+}
+/**
+ * Start an app on the device. With activity: `am start -W -n pkg/activity`.
+ * Without: `monkey -p pkg -c LAUNCHER 1`. Note: success means the launch
+ * intent was dispatched, not that the app is stable.
+ */
+export declare function performLaunch(params: PerformLaunchParams): Promise<LaunchResult>;
+export declare function registerLaunchApp(server: McpServer): void;