@beeos-ai/device-mcp-server 0.2.3

package/dist/server/tool-registry.js

@@ -0,0 +1,504 @@
+/**
+ * MCP tool registry — verbs exposed by the device sandbox.
+ *
+ * Each tool entry carries:
+ *  - a name (the MCP tool identifier, e.g. `click`)
+ *  - a JSON schema describing the expected `arguments` payload
+ *  - a `handler` that maps `arguments` → `SandboxBackend` method call.
+ *
+ * Filtering is driven entirely by `backend.tools` (a flat
+ * `ReadonlySet<string>` declared on each backend). The registry is
+ * purely a name → schema/handler lookup table; it does not encode
+ * support gates of its own. `listToolDescriptorsFor(backend)` filters
+ * via `backend.tools.has(name)`; `getToolFor(name, backend)` mirrors
+ * the same gate so `/mcp/tools/call` returns 404 (instead of 200 +
+ * runtime `unsupported`) for any tool the active backend doesn't
+ * advertise.
+ *
+ * Inspired by the Python `mcp_tools/registry.py` reference; verbs are kept
+ * verbatim for cross-runtime compatibility.
+ */
+import { formatUiXmlToolOutput } from "../util/ui-xml.js";
+/* ----------------------------------------------------------------------- */
+/* Helpers                                                                  */
+/* ----------------------------------------------------------------------- */
+function n(args, key) {
+    const v = args[key];
+    if (typeof v !== "number" || !Number.isFinite(v)) {
+        throw new TypeError(`argument '${key}' must be a finite number`);
+    }
+    return v;
+}
+function s(args, key) {
+    const v = args[key];
+    if (typeof v !== "string") {
+        throw new TypeError(`argument '${key}' must be a string`);
+    }
+    return v;
+}
+function optS(args, key) {
+    const v = args[key];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== "string")
+        throw new TypeError(`argument '${key}' must be a string`);
+    return v;
+}
+function optN(args, key) {
+    const v = args[key];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== "number" || !Number.isFinite(v)) {
+        throw new TypeError(`argument '${key}' must be a finite number`);
+    }
+    return v;
+}
+const xy = {
+    type: "object",
+    properties: {
+        x: { type: "number" },
+        y: { type: "number" },
+    },
+    required: ["x", "y"],
+};
+/* ----------------------------------------------------------------------- */
+/* Tool definitions                                                         */
+/* ----------------------------------------------------------------------- */
+export const TOOLS = {
+    /* — observation — */
+    screenshot: {
+        descriptor: {
+            name: "screenshot",
+            description: "Capture a screenshot. Returns base64 image bytes plus actual " +
+                "image dimensions (width/height) and click coordinate-system " +
+                "dimensions (deviceWidth/deviceHeight).",
+            inputSchema: { type: "object", properties: {} },
+        },
+        handler: async (_args, { backend }) => {
+            // 0.2.3 split: `width/height` reflect the actual encoded bytes
+            // (so an agent that decodes `b64` always agrees with these
+            // numbers), while `deviceWidth/deviceHeight` carry the click
+            // coordinate-system size used by `tap(x, y)` / `click(x, y)`.
+            const shot = await backend.screenshot();
+            const size = await backend
+                .screenSize()
+                .catch(() => ({ w: shot.width, h: shot.height }));
+            return {
+                b64: shot.data.toString("base64"),
+                format: shot.format,
+                width: shot.width,
+                height: shot.height,
+                deviceWidth: size.w,
+                deviceHeight: size.h,
+            };
+        },
+    },
+    ui_dump: {
+        descriptor: {
+            name: "ui_dump",
+            description: "Dump the active UI hierarchy. Optional `query` filters nodes server-side.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string" },
+                    format: { type: "string", enum: ["compact", "raw"] },
+                },
+            },
+        },
+        handler: async (args, { backend }) => {
+            const out = await backend.uiDump();
+            if (!out.supported)
+                return { supported: false };
+            const fmt = optS(args, "format") ?? "compact";
+            const query = optS(args, "query");
+            if (fmt === "raw")
+                return { supported: true, content: out.content ?? "" };
+            const compact = formatUiXmlToolOutput(out.content ?? "", query);
+            return { supported: true, content: compact };
+        },
+    },
+    device_info: {
+        descriptor: {
+            name: "device_info",
+            description: "Return DeviceInfo (type, name, screen size, capabilities, metadata).",
+            inputSchema: { type: "object", properties: {} },
+        },
+        // Always available — every backend has `info()` (platform metadata
+        // is the one thing even a stub backend can report). Backends still
+        // need to include `device_info` in their `tools` set to advertise
+        // it; the iOS stub uses this as its single advertised tool so the
+        // health check has something to call.
+        handler: async (_args, { backend }) => backend.info(),
+    },
+    screen_size: {
+        descriptor: {
+            name: "screen_size",
+            description: "Return current screen size (w, h).",
+            inputSchema: { type: "object", properties: {} },
+        },
+        handler: async (_args, { backend }) => backend.screenSize(),
+    },
+    /* — pointer / gesture — */
+    click: {
+        descriptor: {
+            name: "click",
+            description: "Mouse click at (x, y). Equivalent to tap on touch backends.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    ...xy.properties,
+                    button: { type: "string", enum: ["left", "right", "middle"] },
+                    clicks: { type: "number" },
+                },
+                required: ["x", "y"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.click(n(args, "x"), n(args, "y"), optS(args, "button") ?? "left", optN(args, "clicks") ?? 1);
+            return { ok: true };
+        },
+    },
+    double_click: {
+        descriptor: {
+            name: "double_click",
+            description: "Double click at (x, y).",
+            inputSchema: { ...xy },
+        },
+        handler: async (args, { backend }) => {
+            await backend.doubleClick(n(args, "x"), n(args, "y"));
+            return { ok: true };
+        },
+    },
+    right_click: {
+        descriptor: {
+            name: "right_click",
+            description: "Right click at (x, y).",
+            inputSchema: { ...xy },
+        },
+        handler: async (args, { backend }) => {
+            await backend.rightClick(n(args, "x"), n(args, "y"));
+            return { ok: true };
+        },
+    },
+    tap: {
+        descriptor: {
+            name: "tap",
+            description: "Tap at (x, y) on a touch device.",
+            inputSchema: { ...xy },
+        },
+        handler: async (args, { backend }) => {
+            await backend.tap(n(args, "x"), n(args, "y"));
+            return { ok: true };
+        },
+    },
+    long_press: {
+        descriptor: {
+            name: "long_press",
+            description: "Long-press at (x, y) for `durationMs` (default 3000).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    ...xy.properties,
+                    durationMs: { type: "number" },
+                },
+                required: ["x", "y"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.longPress(n(args, "x"), n(args, "y"), optN(args, "durationMs"));
+            return { ok: true };
+        },
+    },
+    drag: {
+        descriptor: {
+            name: "drag",
+            description: "Drag from (x1, y1) to (x2, y2).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    x1: { type: "number" },
+                    y1: { type: "number" },
+                    x2: { type: "number" },
+                    y2: { type: "number" },
+                    durationMs: { type: "number" },
+                },
+                required: ["x1", "y1", "x2", "y2"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.drag(n(args, "x1"), n(args, "y1"), n(args, "x2"), n(args, "y2"), optN(args, "durationMs"));
+            return { ok: true };
+        },
+    },
+    swipe: {
+        descriptor: {
+            name: "swipe",
+            description: "Swipe from (x1, y1) to (x2, y2).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    x1: { type: "number" },
+                    y1: { type: "number" },
+                    x2: { type: "number" },
+                    y2: { type: "number" },
+                    durationMs: { type: "number" },
+                },
+                required: ["x1", "y1", "x2", "y2"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.swipe(n(args, "x1"), n(args, "y1"), n(args, "x2"), n(args, "y2"), optN(args, "durationMs"));
+            return { ok: true };
+        },
+    },
+    scroll: {
+        descriptor: {
+            name: "scroll",
+            description: "Scroll at (x, y) in `direction` (up | down | left | right).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    x: { type: "number" },
+                    y: { type: "number" },
+                    direction: { type: "string", enum: ["up", "down", "left", "right"] },
+                    amount: { type: "number" },
+                },
+                required: ["direction"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.scroll(optN(args, "x") ?? 0, optN(args, "y") ?? 0, s(args, "direction"), optN(args, "amount"));
+            return { ok: true };
+        },
+    },
+    /* — keyboard — */
+    type: {
+        descriptor: {
+            name: "type",
+            description: "Type the given Unicode `text` into the focused field.",
+            inputSchema: {
+                type: "object",
+                properties: { text: { type: "string" } },
+                required: ["text"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.typeText(s(args, "text"));
+            return { ok: true };
+        },
+    },
+    key: {
+        descriptor: {
+            name: "key",
+            description: "Press a single named key (e.g. `KEYCODE_HOME`, `Escape`).",
+            inputSchema: {
+                type: "object",
+                properties: { key: { type: "string" } },
+                required: ["key"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.pressKey(s(args, "key"));
+            return { ok: true };
+        },
+    },
+    hotkey: {
+        descriptor: {
+            name: "hotkey",
+            description: "Press a hotkey combo, e.g. ['Cmd', 'Shift', 'P'].",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    keys: { type: "array", items: { type: "string" } },
+                },
+                required: ["keys"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            const keys = args.keys;
+            if (!Array.isArray(keys) || keys.some((k) => typeof k !== "string")) {
+                throw new TypeError("argument 'keys' must be a string[]");
+            }
+            await backend.hotkey(...keys);
+            return { ok: true };
+        },
+    },
+    /* — system nav — */
+    back: {
+        descriptor: {
+            name: "back",
+            description: "Press the system back button (Android) / browser back.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        handler: async (_args, { backend }) => {
+            await backend.back();
+            return { ok: true };
+        },
+    },
+    home: {
+        descriptor: {
+            name: "home",
+            description: "Press the system home button (Android).",
+            inputSchema: { type: "object", properties: {} },
+        },
+        handler: async (_args, { backend }) => {
+            await backend.home();
+            return { ok: true };
+        },
+    },
+    /* — app — */
+    launch_app: {
+        descriptor: {
+            name: "launch_app",
+            description: "Launch app by package or display name.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    pkg: { type: "string" },
+                    activity: { type: "string" },
+                },
+                required: ["pkg"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.launchApp(s(args, "pkg"), optS(args, "activity"));
+            return { ok: true };
+        },
+    },
+    /* — shell / files — */
+    execute_command: {
+        descriptor: {
+            name: "execute_command",
+            description: "Run a shell command on the sandbox. Returns stdout/stderr/exitCode.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    body: { type: "string" },
+                    timeoutS: { type: "number" },
+                    cwd: { type: "string" },
+                },
+                required: ["body"],
+            },
+        },
+        handler: async (args, { backend }) => backend.executeCommand(s(args, "body"), {
+            timeoutS: optN(args, "timeoutS"),
+            cwd: optS(args, "cwd"),
+        }),
+    },
+    file_read: {
+        descriptor: {
+            name: "file_read",
+            description: "Read a file from the sandbox. Returns base64 content.",
+            inputSchema: {
+                type: "object",
+                properties: { path: { type: "string" } },
+                required: ["path"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            const buf = await backend.fileRead(s(args, "path"));
+            return { contentB64: buf.toString("base64"), bytes: buf.length };
+        },
+    },
+    file_write: {
+        descriptor: {
+            name: "file_write",
+            description: "Write base64 content to a file in the sandbox.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    contentB64: { type: "string" },
+                },
+                required: ["path", "contentB64"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            const buf = Buffer.from(s(args, "contentB64"), "base64");
+            await backend.fileWrite(s(args, "path"), buf);
+            return { ok: true, bytes: buf.length };
+        },
+    },
+    list_directory: {
+        descriptor: {
+            name: "list_directory",
+            description: "List directory entries.",
+            inputSchema: {
+                type: "object",
+                properties: { path: { type: "string" } },
+                required: ["path"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            const entries = await backend.listDirectory(s(args, "path"));
+            return { entries };
+        },
+    },
+    /**
+     * `install_package` — backend-agnostic native-package install.
+     *
+     * Dispatches to whichever installer the backend implements (APK on
+     * Android, DMG/PKG on macOS, MSI/EXE on Windows, DEB/RPM on Linux).
+     * Wire-compatible alias `install_apk` is kept registered for
+     * existing agents that still hardcode the Android verb name.
+     *
+     * Reference: plan §3.4 — "工具命名上，去掉 backend 私有词".
+     */
+    install_package: installToolEntry("install_package"),
+    install_apk: installToolEntry("install_apk"),
+};
+function installToolEntry(name) {
+    return {
+        descriptor: {
+            name,
+            description: name === "install_package"
+                ? "Install a native package at `path`. Backend-agnostic — dispatches " +
+                    "to APK / DMG / MSI / DEB based on the active backend."
+                : "Install an APK at `path` (Android only). Alias for `install_package`.",
+            inputSchema: {
+                type: "object",
+                properties: { path: { type: "string" } },
+                required: ["path"],
+            },
+        },
+        handler: async (args, { backend }) => {
+            await backend.install(s(args, "path"));
+            return { ok: true };
+        },
+    };
+}
+/* ----------------------------------------------------------------------- */
+/* Public API                                                               */
+/* ----------------------------------------------------------------------- */
+/**
+ * Return ALL registered tool descriptors regardless of backend support.
+ *
+ * Useful for documentation / tests that want to enumerate the catalog.
+ * Wire callers SHOULD use `listToolDescriptorsFor(backend)` so the list
+ * only contains tools the active backend can actually execute.
+ */
+export function listToolDescriptors() {
+    return Object.values(TOOLS).map((t) => t.descriptor);
+}
+/** Return tool descriptors filtered by the backend's advertised tool set. */
+export function listToolDescriptorsFor(backend) {
+    return Object.values(TOOLS)
+        .filter((t) => backend.tools.has(t.descriptor.name))
+        .map((t) => t.descriptor);
+}
+/** Look up a tool by name, ignoring backend tool-set gates. */
+export function getTool(name) {
+    return TOOLS[name];
+}
+/**
+ * Look up a tool by name, **gated** on the backend's advertised tool
+ * set. Returns `undefined` for tools the active backend cannot
+ * satisfy — the `/mcp/tools/call` route uses this and returns 404,
+ * mirroring the filtering applied at `/mcp/tools/list`.
+ */
+export function getToolFor(name, backend) {
+    if (!backend.tools.has(name))
+        return undefined;
+    return TOOLS[name];
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/server/tool-registry.js.map

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

package/dist/util/adb-files.d.ts

@@ -0,0 +1,92 @@
+/**
+ * adb-files — file-IO and listing primitives over the native `adb`
+ * `pull` / `push` / `shell ls` protocols.
+ *
+ * # Why this module exists
+ *
+ * Earlier versions of the Android backend did file IO with two ad-hoc
+ * tricks:
+ *
+ *   - `fileRead` → `adb exec-out cat <path>` and decoded the bytes from
+ *     stdout. This silently swallowed device-side `cat` errors because
+ *     `adb exec-out` does NOT propagate the remote command's exit code
+ *     back to the host adb client (the host always exits 0 when the
+ *     channel closes cleanly), so reading a non-existent path returned
+ *     `cat`'s stderr text base64-encoded as if it were file content.
+ *
+ *   - `fileWrite` → `adb shell sh -c "echo <b64> | base64 -d > <path>"`.
+ *     Because `adb shell` joins argv with spaces and re-evaluates through
+ *     `sh -c`, the shell saw `sh -c sh -c echo <b64> | base64 -d > path`,
+ *     which dropped the pipeline body, ran `sh -c echo` with no args, and
+ *     left an empty file on the device. The bug went undetected because
+ *     the host-side `adb` still returned exit 0.
+ *
+ * The right tools for this job are `adb pull` and `adb push`: they speak
+ * the file-sync protocol designed for binary transfer, the host-side
+ * `adb` exits with a non-zero code when the device-side path is missing
+ * or unwritable, and they side-step the shell tokeniser entirely. This
+ * module wraps those primitives in async-friendly helpers and routes
+ * every error through `wrapAdbFailure` so callers see the familiar
+ * `DeviceError` shape.
+ *
+ * `adbListDir` exists in this module rather than in the backend so the
+ * "use `ls -laL` to dereference symlinks" rule has a single home. The
+ * raw `ls -la` form does not deref symlinks (so listing `/sdcard` returns
+ * the symlink itself instead of the contents of `/storage/self/primary`,
+ * which is almost never what callers want).
+ */
+import type { AdbRunner } from "../backends/android-adb-runner.js";
+import type { ListDirectoryEntry } from "../backends/base.js";
+export interface AdbFileOpOptions {
+    /** Hard timeout for the underlying `adb` invocation. */
+    timeoutMs: number;
+    /** Optional override for the host-side temp directory (tests). */
+    tmpdir?: () => string;
+    /** Cap stdout buffer for pull (defaults to 64 MiB). */
+    maxBufferBytes?: number;
+}
+/**
+ * Prepend `["-s", serial]` when a serial is set. Mirrors the private
+ * `adbArgs()` helper in the backend so the helpers here can build their
+ * own argv without leaking the backend's internal state.
+ */
+export declare function withSerial(serial: string | undefined, args: readonly string[]): string[];
+/**
+ * `adb pull <remote> <hostTmp>` followed by an in-memory read of the
+ * temp file. Throws `DeviceError(file_not_found)` when the device path
+ * does not exist (host-side adb exits with code 1 and prints
+ * `adb: error: failed to stat remote object ... No such file or directory`),
+ * and the generic `adb_failed` shape for everything else.
+ */
+export declare function adbPull(runner: AdbRunner, serial: string | undefined, remote: string, opts: AdbFileOpOptions): Promise<Buffer>;
+/**
+ * `adb push <hostTmp> <remote>`. The buffer is written to a temp file
+ * first because `adb push` reads from disk; piping into stdin is not
+ * supported by the file-sync protocol.
+ */
+export declare function adbPush(runner: AdbRunner, serial: string | undefined, remote: string, content: Buffer, opts: AdbFileOpOptions): Promise<void>;
+/**
+ * `ls -laL <path>` over `adb shell` (single-string command, properly
+ * quoted via `sh\`...\``). The `-L` flag dereferences symlinks so callers
+ * who pass `/sdcard` (a symlink to `/storage/self/primary` on stock AOSP)
+ * see the contents of the linked directory rather than a single
+ * `lrwxrwxrwx ... /sdcard -> /storage/self/primary` row.
+ *
+ * The runner contract is: throws on non-zero adb exit (the call site
+ * handles that with `wrapAdbFailure`); on success, parses the textual
+ * output via `parseLsOutput`.
+ */
+export declare function adbListDir(runner: AdbRunner, serial: string | undefined, pathArg: string, opts: AdbFileOpOptions): Promise<ListDirectoryEntry[]>;
+/**
+ * Parse the output of `ls -la` / `ls -laL` from Android's toybox `ls`
+ * into structured entries. Tolerates header lines (`total 12`) and skips
+ * the canonical `.` / `..` entries.
+ *
+ * Entry layout (toybox): `perms links owner group size month day time name`.
+ * We index by whitespace-split position rather than parsing each column
+ * type-by-type because Android's `ls` output is stable across releases.
+ *
+ * Exported here (not in the backend) so the symlink-dereferencing rule
+ * lives next to the `ls -laL` invocation it depends on.
+ */
+export declare function parseLsOutput(out: string): ListDirectoryEntry[];