@0xhayd3n/fling 0.6.0

package/dist/tools/launch-app.js

@@ -0,0 +1,131 @@
+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";
+const PACKAGE_RE = /^[A-Za-z][\w]*(\.[A-Za-z][\w]*)+$/;
+const ACTIVITY_RE = /^\.?[A-Za-z][\w$]*(\.[A-Za-z][\w$]*)*$/;
+export function validatePackage(name) {
+    if (!PACKAGE_RE.test(name)) {
+        throw new FlingError("INVALID_INPUT", `Invalid Android package name: "${name}". Expected dotted identifier like com.example.app.`);
+    }
+}
+export function validateActivity(activity) {
+    if (!ACTIVITY_RE.test(activity)) {
+        throw new FlingError("INVALID_INPUT", `Invalid activity name: "${activity}". Expected a class name like MainActivity, .MainActivity, or com.example.MainActivity.`);
+    }
+}
+/**
+ * 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 async function performLaunch(params) {
+    const shellCmd = params.activity
+        ? ["shell", "am", "start", "-W", "-n", `${params.packageName}/${params.activity}`]
+        : [
+            "shell",
+            "monkey",
+            "-p",
+            params.packageName,
+            "-c",
+            "android.intent.category.LAUNCHER",
+            "1",
+        ];
+    const { stdout, stderr } = await runAdb([...params.deviceArgs, ...shellCmd]);
+    const combined = `${stdout}\n${stderr}`;
+    const failureRe = /No activities found to run|Monkey aborted|Error: (?:Activity class|Activity not started)|java\.lang\.SecurityException/;
+    const successRe = params.activity ? /Status:\s*ok/i : /Events injected:\s*1/;
+    if (failureRe.test(combined) || !successRe.test(combined)) {
+        const reason = combined.trim().split(/\r?\n/).slice(0, 8).join("\n");
+        return {
+            success: false,
+            message: `Launch dispatch failed for ${params.packageName}.`,
+            raw: reason,
+        };
+    }
+    return {
+        success: true,
+        message: params.activity
+            ? `Launched ${params.packageName}/${params.activity}`
+            : `Launched ${params.packageName} (default activity)`,
+        raw: combined.trim(),
+    };
+}
+export function registerLaunchApp(server) {
+    server.registerTool("launch_app", {
+        title: "Launch an Android app",
+        description: "Start an installed app on the device. If `activity` is omitted, the default " +
+            "launcher activity is started (via `monkey`). If `activity` is given, it is " +
+            "passed to `am start -n <package>/<activity>` directly. " +
+            "When `package_name` is omitted, falls back to fling.config.json (packageName, mainActivity). " +
+            "Note: success means the launch intent was dispatched, not that the app is " +
+            "stable — an app that crashes immediately after onCreate still returns success. " +
+            "When you need to wait for a specific UI element before proceeding, prefer " +
+            "`launch_and_wait` which polls dump_ui internally.",
+        inputSchema: {
+            package_name: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("App package name (e.g. com.example.app). Optional if set in fling.config.json."),
+            activity: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Optional activity. Use a leading dot for relative (e.g. .MainActivity) or a fully-qualified class name."),
+            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(),
+            activity: z.string().optional(),
+            success: z.boolean(),
+            message: z.string(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ package_name, activity, 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", "package_name was not provided and no packageName is set in fling.config.json.");
+            }
+            const act = activity ?? loaded.config.mainActivity;
+            validatePackage(pkg);
+            if (act)
+                validateActivity(act);
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const result = await performLaunch({ packageName: pkg, activity: act, deviceArgs });
+            const text = result.success
+                ? `${result.message} on ${serial}.`
+                : `${result.message} (on ${serial})\n\n${result.raw}`;
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: {
+                    device_id: serial,
+                    package_name: pkg,
+                    activity: act,
+                    success: result.success,
+                    message: text,
+                },
+                isError: !result.success,
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=launch-app.js.map

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

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

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

@@ -0,0 +1,42 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SETTINGS_ACTION_ALLOWLIST: ReadonlySet<string>;
+/**
+ * Accepts either the bare suffix (e.g. "WIFI_SETTINGS") or the fully qualified
+ * action (e.g. "android.settings.WIFI_SETTINGS") and returns the fully
+ * qualified form. Throws FlingError("INVALID_INPUT") on anything else — most
+ * importantly, on actions outside the allowlist, which is the guard against
+ * using this tool to fire arbitrary intents.
+ */
+export declare function normalizeSettingsAction(input: string): string;
+/**
+ * Strictly validates the `-d` payload. The only documented use for a data URI
+ * on a built-in settings intent is APPLICATION_DETAILS_SETTINGS, which expects
+ * `package:<dotted-android-id>`. Anything else is rejected to prevent arbitrary
+ * URI dispatch via this tool.
+ */
+export declare function validateSettingsDataUri(uri: string): void;
+export interface BuildSettingsAmArgsParams {
+    action: string;
+    dataUri?: string;
+    deviceArgs: string[];
+}
+export declare function buildSettingsAmArgs(params: BuildSettingsAmArgsParams): string[];
+export interface SettingsLaunchResult {
+    success: boolean;
+    message: string;
+    raw: string;
+}
+/**
+ * Interpret `am start` output. Mirrors performLaunch in launch-app.ts: the
+ * activity manager merges device-side stderr into adb stdout in some Android
+ * builds, so we concatenate both and look for known failure markers OR the
+ * absence of `Status: ok` (which `am start -W` always emits on success).
+ */
+export declare function interpretSettingsResult(stdout: string, stderr: string): SettingsLaunchResult;
+export interface PerformLaunchSettingsParams {
+    action: string;
+    dataUri?: string;
+    deviceArgs: string[];
+}
+export declare function performLaunchSettings(params: PerformLaunchSettingsParams): Promise<SettingsLaunchResult>;
+export declare function registerLaunchSettings(server: McpServer): void;

package/dist/tools/launch-settings.js

@@ -0,0 +1,211 @@
+import { z } from "zod";
+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 ACTION_PREFIX = "android.settings.";
+const SUFFIX_RE = /^[A-Z][A-Z0-9_]*$/;
+const DATA_URI_RE = /^package:[A-Za-z][\w]*(?:\.[A-Za-z][\w]*)+$/;
+// Standard android.provider.Settings.ACTION_* values that point at a built-in
+// Settings screen reachable via `am start -a android.settings.<X>`. Restricted
+// to a known set to avoid arbitrary intent dispatch through this tool.
+export const SETTINGS_ACTION_ALLOWLIST = new Set([
+    "ACCESSIBILITY_SETTINGS",
+    "AIRPLANE_MODE_SETTINGS",
+    "APN_SETTINGS",
+    "APPLICATION_DETAILS_SETTINGS",
+    "APPLICATION_DEVELOPMENT_SETTINGS",
+    "APPLICATION_SETTINGS",
+    "APP_NOTIFICATION_SETTINGS",
+    "BATTERY_SAVER_SETTINGS",
+    "BLUETOOTH_SETTINGS",
+    "CAPTIONING_SETTINGS",
+    "CAST_SETTINGS",
+    "DATA_ROAMING_SETTINGS",
+    "DATE_SETTINGS",
+    "DEVICE_INFO_SETTINGS",
+    "DISPLAY_SETTINGS",
+    "DREAM_SETTINGS",
+    "HARD_KEYBOARD_SETTINGS",
+    "HOME_SETTINGS",
+    "IGNORE_BATTERY_OPTIMIZATION_SETTINGS",
+    "INPUT_METHOD_SETTINGS",
+    "INPUT_METHOD_SUBTYPE_SETTINGS",
+    "INTERNAL_STORAGE_SETTINGS",
+    "LOCALE_SETTINGS",
+    "LOCATION_SOURCE_SETTINGS",
+    "MANAGE_ALL_APPLICATIONS_SETTINGS",
+    "MANAGE_APPLICATIONS_SETTINGS",
+    "MEMORY_CARD_SETTINGS",
+    "NETWORK_OPERATOR_SETTINGS",
+    "NFC_PAYMENT_SETTINGS",
+    "NFC_SETTINGS",
+    "NFCSHARING_SETTINGS",
+    "NOTIFICATION_SETTINGS",
+    "PRIVACY_SETTINGS",
+    "QUICK_LAUNCH_SETTINGS",
+    "SEARCH_SETTINGS",
+    "SECURITY_SETTINGS",
+    "SETTINGS",
+    "SOUND_SETTINGS",
+    "SYNC_SETTINGS",
+    "TETHER_SETTINGS",
+    "USAGE_ACCESS_SETTINGS",
+    "USER_DICTIONARY_SETTINGS",
+    "VOICE_INPUT_SETTINGS",
+    "VPN_SETTINGS",
+    "WIFI_IP_SETTINGS",
+    "WIFI_SETTINGS",
+    "WIRELESS_SETTINGS",
+]);
+/**
+ * Accepts either the bare suffix (e.g. "WIFI_SETTINGS") or the fully qualified
+ * action (e.g. "android.settings.WIFI_SETTINGS") and returns the fully
+ * qualified form. Throws FlingError("INVALID_INPUT") on anything else — most
+ * importantly, on actions outside the allowlist, which is the guard against
+ * using this tool to fire arbitrary intents.
+ */
+export function normalizeSettingsAction(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new FlingError("INVALID_INPUT", "Settings action is required.");
+    }
+    const suffix = trimmed.startsWith(ACTION_PREFIX)
+        ? trimmed.slice(ACTION_PREFIX.length)
+        : trimmed;
+    if (!SUFFIX_RE.test(suffix)) {
+        throw new FlingError("INVALID_INPUT", `Invalid settings action: "${input}". Expected an uppercase suffix like WIFI_SETTINGS, optionally prefixed with android.settings..`);
+    }
+    if (!SETTINGS_ACTION_ALLOWLIST.has(suffix)) {
+        throw new FlingError("INVALID_INPUT", `Settings action "${suffix}" is not in the allowlist. Known actions: ${[...SETTINGS_ACTION_ALLOWLIST].sort().join(", ")}.`);
+    }
+    return ACTION_PREFIX + suffix;
+}
+/**
+ * Strictly validates the `-d` payload. The only documented use for a data URI
+ * on a built-in settings intent is APPLICATION_DETAILS_SETTINGS, which expects
+ * `package:<dotted-android-id>`. Anything else is rejected to prevent arbitrary
+ * URI dispatch via this tool.
+ */
+export function validateSettingsDataUri(uri) {
+    if (!DATA_URI_RE.test(uri)) {
+        throw new FlingError("INVALID_INPUT", `Invalid data_uri: "${uri}". Only package:<dotted-android-id> is accepted (e.g. package:com.example.app).`);
+    }
+}
+export function buildSettingsAmArgs(params) {
+    // -W makes `am start` wait for the activity to come up and print Status: ok;
+    // without it the success line is suppressed and we can't tell whether the
+    // dispatch actually resolved an activity.
+    const argv = [
+        ...params.deviceArgs,
+        "shell",
+        "am",
+        "start",
+        "-W",
+        "-a",
+        params.action,
+    ];
+    if (params.dataUri) {
+        argv.push("-d", params.dataUri);
+    }
+    return argv;
+}
+/**
+ * Interpret `am start` output. Mirrors performLaunch in launch-app.ts: the
+ * activity manager merges device-side stderr into adb stdout in some Android
+ * builds, so we concatenate both and look for known failure markers OR the
+ * absence of `Status: ok` (which `am start -W` always emits on success).
+ */
+export function interpretSettingsResult(stdout, stderr) {
+    const combined = `${stdout}\n${stderr}`;
+    const failureRe = /Error: (?:Activity (?:class|not started)|Intent does not match|.+ not found)|java\.lang\.SecurityException|No Activity found to handle/;
+    const successRe = /Status:\s*ok/i;
+    if (failureRe.test(combined) || !successRe.test(combined)) {
+        const reason = combined.trim().split(/\r?\n/).slice(0, 8).join("\n");
+        return {
+            success: false,
+            message: "Settings launch dispatch failed.",
+            raw: reason,
+        };
+    }
+    return {
+        success: true,
+        message: "Settings launch dispatched.",
+        raw: combined.trim(),
+    };
+}
+export async function performLaunchSettings(params) {
+    const { stdout, stderr } = await runAdb(buildSettingsAmArgs(params));
+    return interpretSettingsResult(stdout, stderr);
+}
+export function registerLaunchSettings(server) {
+    server.registerTool("launch_settings", {
+        title: "Launch an Android system settings screen by intent action",
+        description: "Open a built-in Android Settings screen via `am start -a android.settings.<ACTION>`. " +
+            "Dramatically faster than navigating Settings by screenshot + dump_ui + input_tap " +
+            "loops — one adb call instead of ~10 round-trips. " +
+            "`action` accepts either the bare suffix (e.g. WIFI_SETTINGS) or the fully qualified " +
+            "form (android.settings.WIFI_SETTINGS), restricted to a known-good allowlist of " +
+            "standard android.provider.Settings.ACTION_* values. " +
+            "`data_uri` is for actions that need a target, currently restricted to " +
+            "package:<dotted-android-id> (the canonical form for APPLICATION_DETAILS_SETTINGS). " +
+            "For common panels by friendly name (wifi/bluetooth/apps/display/etc.), prefer " +
+            "`open_setting` — same intent dispatch with friendlier naming.",
+        inputSchema: {
+            action: z
+                .string()
+                .min(1)
+                .describe("Settings action. Bare suffix (WIFI_SETTINGS) or fully qualified (android.settings.WIFI_SETTINGS). Must be on the allowlist."),
+            data_uri: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Optional `-d` payload. Must be of the form package:<dotted-id>, e.g. package:com.example.app for APPLICATION_DETAILS_SETTINGS."),
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            action: z.string(),
+            data_uri: z.string().optional(),
+            success: z.boolean(),
+            message: z.string(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ action, data_uri, device_id }) => {
+        try {
+            const fullAction = normalizeSettingsAction(action);
+            if (data_uri !== undefined)
+                validateSettingsDataUri(data_uri);
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const result = await performLaunchSettings({
+                action: fullAction,
+                dataUri: data_uri,
+                deviceArgs,
+            });
+            const text = result.success
+                ? `${result.message} (${fullAction}) on ${serial}.`
+                : `${result.message} (${fullAction} on ${serial})\n\n${result.raw}`;
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: {
+                    device_id: serial,
+                    action: fullAction,
+                    data_uri,
+                    success: result.success,
+                    message: text,
+                },
+                isError: !result.success,
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=launch-settings.js.map

package/dist/tools/launch-settings.js.map

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

package/dist/tools/list-devices.d.ts

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

package/dist/tools/list-devices.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { formatDevicesSummary, listDevices } from "../devices.js";
+import { deviceShape } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+export function registerListDevices(server) {
+    server.registerTool("list_devices", {
+        title: "List Android devices",
+        description: "Show every Android device adb can see (USB or wireless), with its state " +
+            "(device / unauthorized / offline / etc). Use this first to confirm a phone " +
+            "is reachable before any other operation.",
+        inputSchema: {},
+        outputSchema: {
+            devices: z.array(deviceShape),
+            count: z.number().int().nonnegative(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        try {
+            const devices = await listDevices();
+            return {
+                content: [
+                    { type: "text", text: formatDevicesSummary(devices) },
+                ],
+                structuredContent: { devices, count: devices.length },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=list-devices.js.map

package/dist/tools/list-devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-devices.js","sourceRoot":"","sources":["../../src/tools/list-devices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,0EAA0E;YAC1E,6EAA6E;YAC7E,0CAA0C;QAC5C,WAAW,EAAE,EAAE;QACf,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;YAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;SACtC;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE;iBAC/D;gBACD,iBAAiB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;aACtD,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/long-press-by-text.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function buildLongPressArgs(deviceArgs: string[], x: number, y: number, durationMs: number): string[];
+export declare function registerLongPressByText(server: McpServer): void;

package/dist/tools/long-press-by-text.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { fetchUiDump } from "../uiDump.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 { selectTapTarget } from "./tap-by-text.js";
+export function buildLongPressArgs(deviceArgs, x, y, durationMs) {
+    return [
+        ...deviceArgs,
+        "shell",
+        "input",
+        "swipe",
+        String(x),
+        String(y),
+        String(x),
+        String(y),
+        String(durationMs),
+    ];
+}
+export function registerLongPressByText(server) {
+    server.registerTool("long_press_by_text", {
+        title: "Long-press a UI element by visible text",
+        description: "Same matching and disambiguation as tap_by_text, but holds the touch for " +
+            "the specified duration (default 1000ms). Used to invoke context menus, " +
+            "drag handles, and similar long-press affordances.",
+        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."),
+            duration_ms: z
+                .number()
+                .int()
+                .positive()
+                .max(10_000)
+                .optional()
+                .default(1000)
+                .describe("How long to hold the touch, in milliseconds (1–9999)."),
+            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(),
+            duration_ms: z.number().int().positive(),
+            candidates_count: z.number().int().nonnegative(),
+            fell_back_to_match: z.boolean(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ text, exact, duration_ms, device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const { nodes } = await fetchUiDump(deviceArgs);
+            const target = selectTapTarget(nodes, {
+                by: "text",
+                value: text,
+                exact,
+            });
+            if (!target) {
+                throw new FlingError("UI_ELEMENT_NOT_FOUND", `No clickable element found for text="${text}" on ${serial}.`);
+            }
+            await runAdb(buildLongPressArgs(deviceArgs, target.tap_x, target.tap_y, duration_ms));
+            const msg = `Long-pressed "${target.matched_text}" for ${duration_ms}ms at (${target.tap_x}, ${target.tap_y}) on ${serial}.`;
+            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,
+                    duration_ms,
+                    candidates_count: target.candidates_count,
+                    fell_back_to_match: target.fell_back_to_match,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=long-press-by-text.js.map

package/dist/tools/long-press-by-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-press-by-text.js","sourceRoot":"","sources":["../../src/tools/long-press-by-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,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,kBAAkB,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAChC,UAAoB,EACpB,CAAS,EACT,CAAS,EACT,UAAkB;IAElB,OAAO;QACL,GAAG,UAAU;QACb,OAAO;QACP,OAAO;QACP,OAAO;QACP,MAAM,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,UAAU,CAAC;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,yCAAyC;QAChD,WAAW,EACT,2EAA2E;YAC3E,yEAAyE;YACzE,mDAAmD;QACrD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC1D,KAAK,EAAE,CAAC;iBACL,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,uDAAuD,CAAC;YACpE,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,GAAG,CAAC,MAAM,CAAC;iBACX,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CAAC,uDAAuD,CAAC;YACpE,SAAS,EAAE,aAAa;SACzB;QACD,YAAY,EAAE;YACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;gBACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;gBACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;gBACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;aACf,CAAC;YACF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;YACxC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YAChD,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;SAChC;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACxE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE;gBACpC,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,IAAI;gBACX,KAAK;aACN,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,UAAU,CAClB,sBAAsB,EACtB,wCAAwC,IAAI,QAAQ,MAAM,GAAG,CAC9D,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,CACV,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CACxE,CAAC;YAEF,MAAM,GAAG,GAAG,iBAAiB,MAAM,CAAC,YAAY,SAAS,WAAW,UAAU,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,QAAQ,MAAM,GAAG,CAAC;YAC7H,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;gBAC/C,iBAAiB,EAAE;oBACjB,SAAS,EAAE,MAAM;oBACjB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,WAAW;oBACX,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;oBACzC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;iBAC9C;aACF,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/open-setting.d.ts

@@ -0,0 +1,55 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SETTINGS_ACTION_ALLOWLIST: ReadonlySet<string>;
+export declare function panelToAction(panel: string): string;
+/**
+ * Accepts either the bare suffix (e.g. "WIFI_SETTINGS") or the fully qualified
+ * action (e.g. "android.settings.WIFI_SETTINGS") and returns the fully
+ * qualified form. Throws FlingError("INVALID_INPUT") on anything else — most
+ * importantly, on actions outside the allowlist, which is the guard against
+ * using this tool to fire arbitrary intents.
+ */
+export declare function normalizeSettingsAction(input: string): string;
+/**
+ * Strictly validates the `-d` payload. The only documented use for a data URI
+ * on a built-in settings intent is APPLICATION_DETAILS_SETTINGS, which expects
+ * `package:<dotted-android-id>`. Anything else is rejected to prevent arbitrary
+ * URI dispatch via this tool.
+ */
+export declare function validateSettingsDataUri(uri: string): void;
+export interface BuildSettingsAmArgsParams {
+    action: string;
+    dataUri?: string;
+    deviceArgs: string[];
+}
+export declare function buildSettingsAmArgs(params: BuildSettingsAmArgsParams): string[];
+export interface SettingsLaunchResult {
+    success: boolean;
+    message: string;
+    raw: string;
+}
+/**
+ * Interpret `am start` output. The activity manager merges device-side stderr
+ * into adb stdout in some Android builds, so we concatenate both and look for
+ * known failure markers OR the absence of `Status: ok` (which `am start -W`
+ * always emits on success).
+ */
+export declare function interpretSettingsResult(stdout: string, stderr: string): SettingsLaunchResult;
+export interface PerformOpenSettingParams {
+    action: string;
+    dataUri?: string;
+    deviceArgs: string[];
+}
+export declare function performOpenSetting(params: PerformOpenSettingParams): Promise<SettingsLaunchResult>;
+export interface ResolveOpenSettingActionInput {
+    panel?: string;
+    action?: string;
+}
+/**
+ * Resolve the user's panel-or-action input into the fully qualified
+ * android.settings.* action string. Enforces XOR — exactly one of
+ * {panel, action} must be set. Delegates value validation to panelToAction
+ * (unknown panel) and normalizeSettingsAction (unknown / malformed /
+ * non-allowlisted action), each of which throws INVALID_INPUT on rejection.
+ */
+export declare function resolveOpenSettingAction(input: ResolveOpenSettingActionInput): string;
+export declare function registerOpenSetting(server: McpServer): void;