@0xhayd3n/fling 0.6.0

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

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

package/dist/tools/build-app.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { loadFlingConfig, resolveBuildCwd } from "../config.js";
+import { resolveApk } from "../apkResolver.js";
+import { FlingError } from "../errors.js";
+import { resolveBuildCommand, runBuild } from "../gradle.js";
+import { toolErrorFrom } from "../toolResult.js";
+export function registerBuildApp(server) {
+    server.registerTool("build_app", {
+        title: "Build the Android app",
+        description: "Run the project's build (default: gradle wrapper + assembleDebug). On success " +
+            "returns the discovered APK path. Honors fling.config.json fields: buildCommand, " +
+            "gradleTask, buildCwd, apkPath, apkGlob.",
+        inputSchema: {
+            cwd: z
+                .string()
+                .optional()
+                .describe("Starting directory for config lookup and (when not overridden) the build. " +
+                "Defaults to the MCP server's cwd."),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            command_run: z.string(),
+            build_cwd: z.string(),
+            duration_ms: z.number().int().nonnegative(),
+            apk_path: z.string().optional(),
+            message: z.string(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ cwd }) => {
+        try {
+            const loaded = await loadFlingConfig(cwd ?? process.cwd());
+            const buildCwd = resolveBuildCwd(loaded);
+            const command = await resolveBuildCommand(buildCwd, loaded.config);
+            const printable = [command.command, ...command.args].join(" ");
+            const outcome = await runBuild(buildCwd, command);
+            let apkPath;
+            try {
+                const apk = await resolveApk(undefined, loaded.config, buildCwd);
+                apkPath = apk.path;
+            }
+            catch (err) {
+                if (!(err instanceof FlingError) || err.code !== "APK_NOT_FOUND") {
+                    throw err;
+                }
+            }
+            const text = [
+                `✓ Build succeeded in ${(outcome.durationMs / 1000).toFixed(1)}s`,
+                `  Command: ${printable}`,
+                `  cwd: ${buildCwd}`,
+                apkPath ? `  APK: ${apkPath}` : "  APK: (not auto-located — set apkPath or check apkGlob)",
+            ].join("\n");
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: {
+                    success: true,
+                    command_run: printable,
+                    build_cwd: buildCwd,
+                    duration_ms: outcome.durationMs,
+                    apk_path: apkPath,
+                    message: text,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=build-app.js.map

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

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

package/dist/tools/deploy-and-run.d.ts

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

package/dist/tools/deploy-and-run.js

@@ -0,0 +1,195 @@
+import { z } from "zod";
+import { loadFlingConfig, resolveBuildCwd } from "../config.js";
+import { resolveApk } from "../apkResolver.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { FlingError } from "../errors.js";
+import { resolveBuildCommand, runBuild } from "../gradle.js";
+import { performInstall } from "./install-app.js";
+import { performLaunch, validateActivity, validatePackage } from "./launch-app.js";
+async function timedStep(name, fn) {
+    const start = Date.now();
+    try {
+        const value = await fn();
+        return {
+            step: { name, success: true, duration_ms: Date.now() - start, message: "ok" },
+            value,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            step: { name, success: false, duration_ms: Date.now() - start, message },
+            error: err,
+        };
+    }
+}
+export function registerDeployAndRun(server) {
+    server.registerTool("deploy_and_run", {
+        title: "Build, install, and launch an Android app",
+        description: "Convenience tool: build (gradle), find the APK, install on the connected device, " +
+            "and start the app. Honors fling.config.json defaults. Stops at the first failed " +
+            "step and reports which step broke. Use `skip_build: true` to reuse an existing APK.",
+        inputSchema: {
+            cwd: z.string().optional().describe("Starting directory for config lookup. Defaults to the MCP server's cwd."),
+            skip_build: z
+                .boolean()
+                .optional()
+                .describe("Skip the build step and use an existing APK. Default false."),
+            apk_path: z
+                .string()
+                .optional()
+                .describe("Override the APK to install. Falls back to config.apkPath / apkGlob."),
+            package_name: z
+                .string()
+                .optional()
+                .describe("Override the package to launch. Falls back to config.packageName."),
+            activity: z
+                .string()
+                .optional()
+                .describe("Override the activity to launch. Falls back to config.mainActivity."),
+            device_id: z
+                .string()
+                .optional()
+                .describe("Target device serial (required when multiple ready devices are connected)."),
+            reinstall: z.boolean().optional(),
+            grant_runtime_permissions: z.boolean().optional(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            device_id: z.string().optional(),
+            apk_path: z.string().optional(),
+            package_name: z.string().optional(),
+            steps: z.array(z.object({
+                name: z.string(),
+                success: z.boolean(),
+                duration_ms: z.number().int().nonnegative(),
+                message: z.string(),
+            })),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const steps = [];
+        let serial;
+        let apkPath;
+        let pkg;
+        try {
+            const loaded = await loadFlingConfig(input.cwd ?? process.cwd());
+            const buildCwd = resolveBuildCwd(loaded);
+            pkg = input.package_name ?? loaded.config.packageName;
+            if (!pkg) {
+                throw new FlingError("CONFIG_MISSING", "deploy_and_run needs a package_name (argument or config.packageName).");
+            }
+            validatePackage(pkg);
+            const activity = input.activity ?? loaded.config.mainActivity;
+            if (activity)
+                validateActivity(activity);
+            if (!input.skip_build) {
+                const build = await timedStep("build", async () => {
+                    const command = await resolveBuildCommand(buildCwd, loaded.config);
+                    const printable = [command.command, ...command.args].join(" ");
+                    const outcome = await runBuild(buildCwd, command);
+                    return { printable, outcome };
+                });
+                if (build.value) {
+                    build.step.message = `Built via ${build.value.printable} in ${(build.value.outcome.durationMs / 1000).toFixed(1)}s`;
+                }
+                steps.push(build.step);
+                if (!build.step.success)
+                    throw build.error ?? new Error("build step failed");
+            }
+            const apkResolution = await timedStep("resolve_apk", async () => {
+                return await resolveApk(input.apk_path, loaded.config, buildCwd);
+            });
+            if (apkResolution.value) {
+                apkResolution.step.message = `Using APK ${apkResolution.value.path} (${apkResolution.value.source})`;
+                apkPath = apkResolution.value.path;
+            }
+            steps.push(apkResolution.step);
+            if (!apkResolution.step.success)
+                throw apkResolution.error ?? new Error("apk resolution failed");
+            const deviceStep = await timedStep("resolve_device", async () => {
+                return await resolveDeviceArgs(input.device_id);
+            });
+            if (deviceStep.value) {
+                serial = deviceStep.value.serial;
+                deviceStep.step.message = `Targeting ${serial}`;
+            }
+            steps.push(deviceStep.step);
+            if (!deviceStep.step.success)
+                throw deviceStep.error ?? new Error("device resolution failed");
+            const installStep = await timedStep("install", async () => {
+                return await performInstall({
+                    apkPath: apkResolution.value.path,
+                    deviceArgs: deviceStep.value.args,
+                    reinstall: input.reinstall !== false,
+                    grantRuntimePermissions: !!input.grant_runtime_permissions,
+                });
+            });
+            if (installStep.value) {
+                installStep.step.success = installStep.value.success;
+                installStep.step.message = installStep.value.message;
+            }
+            steps.push(installStep.step);
+            if (!installStep.step.success) {
+                throw installStep.error ?? new FlingError("INSTALL_FAILED", installStep.step.message);
+            }
+            const launchStep = await timedStep("launch", async () => {
+                return await performLaunch({
+                    packageName: pkg,
+                    activity,
+                    deviceArgs: deviceStep.value.args,
+                });
+            });
+            if (launchStep.value) {
+                launchStep.step.success = launchStep.value.success;
+                launchStep.step.message = launchStep.value.message;
+            }
+            steps.push(launchStep.step);
+            if (!launchStep.step.success) {
+                throw launchStep.error ?? new FlingError("LAUNCH_FAILED", launchStep.step.message);
+            }
+            const totalMs = steps.reduce((acc, s) => acc + s.duration_ms, 0);
+            const summary = [
+                `✓ Deployed ${pkg} to ${serial} in ${(totalMs / 1000).toFixed(1)}s`,
+                ...steps.map((s) => `  • ${s.name}: ${s.message} (${s.duration_ms}ms)`),
+            ].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    success: true,
+                    device_id: serial,
+                    apk_path: apkPath,
+                    package_name: pkg,
+                    steps,
+                },
+            };
+        }
+        catch (err) {
+            const failedStep = steps.find((s) => !s.success);
+            const detail = err instanceof Error ? err.message : String(err);
+            const summary = [
+                `✗ deploy_and_run failed${failedStep ? ` at step "${failedStep.name}"` : ""}.`,
+                ...steps.map((s) => `  • ${s.name}: ${s.success ? "ok" : "FAILED — " + s.message} (${s.duration_ms}ms)`),
+                "",
+                detail,
+            ].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    success: false,
+                    device_id: serial,
+                    apk_path: apkPath,
+                    package_name: pkg,
+                    steps,
+                },
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=deploy-and-run.js.map

package/dist/tools/deploy-and-run.js.map

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

package/dist/tools/device-state.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface DeviceStateResult {
+    foreground_package: string | null;
+    foreground_activity: string | null;
+    screen_on: boolean | null;
+    orientation: number | null;
+    logcat_tail: string[];
+}
+export declare function parseDeviceState(stdout: string): DeviceStateResult;
+export declare function buildDeviceStateCommand(): string;
+export declare function registerDeviceState(server: McpServer): void;

package/dist/tools/device-state.js

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import { runAdb } from "../adb.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+function splitSections(stdout) {
+    const out = {};
+    const lines = stdout.split(/\r?\n/);
+    let current = null;
+    for (const line of lines) {
+        const m = /^##([A-Z]+)$/.exec(line);
+        if (m) {
+            current = m[1];
+            out[current] = "";
+            continue;
+        }
+        if (current !== null) {
+            out[current] += (out[current] ? "\n" : "") + line;
+        }
+    }
+    return out;
+}
+export function parseDeviceState(stdout) {
+    const sections = splitSections(stdout);
+    // Foreground activity. Format from `dumpsys activity activities`:
+    //   mResumedActivity: ActivityRecord{<hash> u0 <package>/<activity> t<task>}
+    let pkg = null;
+    let activity = null;
+    const fg = sections["FOREGROUND"] ?? "";
+    const fgMatch = /ActivityRecord\{\S+\s+\S+\s+([^\s/]+)\/([^\s}]+)/.exec(fg);
+    if (fgMatch) {
+        pkg = fgMatch[1];
+        activity = `${fgMatch[1]}/${fgMatch[2]}`;
+    }
+    // Screen on/off. `mWakefulness` is the source of truth on modern AOSP; the
+    // legacy `Display Power: state=ON|OFF` line stopped being emitted somewhere
+    // around Android 13 (modern builds print the PowerManagerService object ref
+    // there instead), so check it first and fall back to the legacy format.
+    let screenOn = null;
+    const screen = sections["SCREEN"] ?? "";
+    if (/mWakefulness=Awake\b/.test(screen))
+        screenOn = true;
+    else if (/mWakefulness=(Asleep|Dozing)\b/.test(screen))
+        screenOn = false;
+    else if (/Display Power: state=ON\b/i.test(screen))
+        screenOn = true;
+    else if (/Display Power: state=OFF\b/i.test(screen))
+        screenOn = false;
+    // Orientation. Modern AOSP exposes `mCurrentOrientation=N` via `dumpsys
+    // display`; older devices used `SurfaceOrientation: N` via `dumpsys input`.
+    // We source from `dumpsys display` (see buildDeviceStateCommand) but accept
+    // either format for forward/backward compatibility.
+    let orientation = null;
+    const orient = sections["ORIENTATION"] ?? "";
+    const oMatch = /mCurrentOrientation=(\d+)/.exec(orient) ??
+        /SurfaceOrientation:\s*(\d+)/.exec(orient);
+    if (oMatch)
+        orientation = Number(oMatch[1]);
+    // Logcat tail — non-empty lines only.
+    const logcat = (sections["LOGCAT"] ?? "")
+        .split(/\r?\n/)
+        .filter((l) => l.trim().length > 0);
+    return {
+        foreground_package: pkg,
+        foreground_activity: activity,
+        screen_on: screenOn,
+        orientation,
+        logcat_tail: logcat,
+    };
+}
+export function buildDeviceStateCommand() {
+    // Section markers MUST be single-quoted: Android's sh (mksh/toybox) treats
+    // an unquoted `#` as the start of a comment, which swallows the marker and
+    // every subsequent token on the line. Without the quotes `echo ##FOREGROUND`
+    // emits an empty string and parseDeviceState sees no sections at all.
+    return [
+        "echo '##FOREGROUND'",
+        // `ResumedActivity` substring catches `mResumedActivity`,
+        // `topResumedActivity`, and `ResumedActivity:` across Android versions.
+        // `mFocusedApp` is the modern equivalent of the legacy `mFocusedActivity`.
+        "dumpsys activity activities | grep -E 'ResumedActivity|mFocusedApp|mFocusedActivity' || true",
+        "echo '##SCREEN'",
+        "dumpsys power | grep -E 'Display Power|mWakefulness' || true",
+        "echo '##ORIENTATION'",
+        "dumpsys display | grep -E 'mCurrentOrientation|SurfaceOrientation' || true",
+        "echo '##LOGCAT'",
+        "logcat -d -t 50",
+    ].join(" ; ");
+}
+export function registerDeviceState(server) {
+    server.registerTool("device_state", {
+        title: "Batched device status probe",
+        description: "One MCP call returns foreground package + activity, screen on/off, " +
+            "orientation, and the last 50 logcat lines. All four checks are " +
+            "chained into a single shell invocation, sectioned by ##MARKER " +
+            "lines. Prefer over running dumpsys / logcat separately when you " +
+            "need 'what's happening on the device right now?'",
+        inputSchema: {
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            foreground_package: z.string().nullable(),
+            foreground_activity: z.string().nullable(),
+            screen_on: z.boolean().nullable(),
+            orientation: z.number().int().nullable(),
+            logcat_tail: z.array(z.string()),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const { stdout } = await runAdb([
+                ...deviceArgs,
+                "shell",
+                buildDeviceStateCommand(),
+            ]);
+            const state = parseDeviceState(stdout);
+            const fg = state.foreground_package ?? "?";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${serial}: foreground=${fg} screen_on=${state.screen_on} orientation=${state.orientation} logcat=${state.logcat_tail.length} line(s)`,
+                    },
+                ],
+                structuredContent: { device_id: serial, ...state },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=device-state.js.map

package/dist/tools/device-state.js.map

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

package/dist/tools/dismiss-dialog.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type UiNode } from "../uiDump.js";
+export interface DenyButton {
+    label: string;
+    tap_x: number;
+    tap_y: number;
+    bounds: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+}
+export declare function selectDenyButton(nodes: UiNode[]): DenyButton | null;
+export declare function registerDismissDialog(server: McpServer): void;

package/dist/tools/dismiss-dialog.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { fetchUiDump } from "../uiDump.js";
+import { DENY_LABELS } from "../uiSelector.js";
+import { runAdb } from "../adb.js";
+import { resolveDeviceArgs } from "../devices.js";
+import { deviceIdInput } from "../schemas.js";
+import { toolErrorFrom } from "../toolResult.js";
+import { buildTapArgs } from "./tap-by-text.js";
+const LOWER_DENY_LABELS = new Set(DENY_LABELS.map((l) => l.toLowerCase()));
+export function selectDenyButton(nodes) {
+    for (const n of nodes) {
+        if (!n.clickable || !n.enabled)
+            continue;
+        const lowered = n.text.toLowerCase();
+        if (LOWER_DENY_LABELS.has(lowered)) {
+            return {
+                label: n.text,
+                tap_x: n.center.x,
+                tap_y: n.center.y,
+                bounds: n.bounds,
+            };
+        }
+    }
+    return null;
+}
+export function registerDismissDialog(server) {
+    server.registerTool("dismiss_dialog", {
+        title: "Dismiss a dialog by tapping its deny / cancel / skip button",
+        description: "Dump UI, find the first clickable button whose text matches one of the " +
+            "known dismissal labels (Don't allow, Cancel, Skip, Dismiss, No thanks, " +
+            "Maybe later, Deny, Close, No, Not now, and their variants), and tap it. " +
+            "Case-insensitive. Single-purpose — dismisses one dialog per call. " +
+            "If multiple stacked dialogs are open, call again.",
+        inputSchema: {
+            device_id: deviceIdInput,
+        },
+        outputSchema: {
+            device_id: z.string(),
+            dismissed: z.boolean(),
+            dismissed_with: z.string().optional(),
+            button_bounds: z
+                .object({
+                x1: z.number(),
+                y1: z.number(),
+                x2: z.number(),
+                y2: z.number(),
+            })
+                .optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ device_id }) => {
+        try {
+            const { args: deviceArgs, serial } = await resolveDeviceArgs(device_id);
+            const { nodes } = await fetchUiDump(deviceArgs);
+            const button = selectDenyButton(nodes);
+            if (!button) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No dialog to dismiss on ${serial}.`,
+                        },
+                    ],
+                    structuredContent: { device_id: serial, dismissed: false },
+                };
+            }
+            await runAdb(buildTapArgs(deviceArgs, button.tap_x, button.tap_y));
+            const msg = `Dismissed dialog by tapping "${button.label}" on ${serial}.`;
+            return {
+                content: [{ type: "text", text: msg }],
+                structuredContent: {
+                    device_id: serial,
+                    dismissed: true,
+                    dismissed_with: button.label,
+                    button_bounds: button.bounds,
+                },
+            };
+        }
+        catch (err) {
+            return toolErrorFrom(err);
+        }
+    });
+}
+//# sourceMappingURL=dismiss-dialog.js.map

package/dist/tools/dismiss-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-dialog.js","sourceRoot":"","sources":["../../src/tools/dismiss-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAe,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAShD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAE3E,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAS;QACzC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,OAAO;gBACL,KAAK,EAAE,CAAC,CAAC,IAAI;gBACb,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;gBACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,6DAA6D;QACpE,WAAW,EACT,yEAAyE;YACzE,yEAAyE;YACzE,0EAA0E;YAC1E,oEAAoE;YACpE,mDAAmD;QACrD,WAAW,EAAE;YACX,SAAS,EAAE,aAAa;SACzB;QACD,YAAY,EAAE;YACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;YACtB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,aAAa,EAAE,CAAC;iBACb,MAAM,CAAC;gBACN,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;iBACD,QAAQ,EAAE;SACd;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,SAAS,EAAE,EAAE,EAAE;QACtB,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,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAEvC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,2BAA2B,MAAM,GAAG;yBAC3C;qBACF;oBACD,iBAAiB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE;iBAC3D,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEnE,MAAM,GAAG,GAAG,gCAAgC,MAAM,CAAC,KAAK,QAAQ,MAAM,GAAG,CAAC;YAC1E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;gBAC/C,iBAAiB,EAAE;oBACjB,SAAS,EAAE,MAAM;oBACjB,SAAS,EAAE,IAAI;oBACf,cAAc,EAAE,MAAM,CAAC,KAAK;oBAC5B,aAAa,EAAE,MAAM,CAAC,MAAM;iBAC7B;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/dump-ui.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export { parseUiHierarchy, isInteresting } from "../uiDump.js";
+export type { UiNode, UiBounds } from "../uiDump.js";
+export declare function registerDumpUi(server: McpServer): void;