@beeos-ai/device-mcp-server 0.2.3

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @beeos-ai/device-mcp-server — public surface.
+ *
+ * Most callers use the CLI (`device-mcp-server`) and reach the server over
+ * HTTP. The exports here are for embedders that want to host a server in
+ * the same Node process (e.g. integration tests, custom orchestration).
+ */
+export { buildApp, type BuildAppOptions } from "./server/app.js";
+export { TOOLS, getTool, listToolDescriptors, type ToolEntry, type ToolHandler, type ToolHandlerContext, } from "./server/tool-registry.js";
+export { mapActionToTool, type ActionMappingResult, type ToolCall, type UnsupportedActionResult, } from "./server/action-mapping.js";
+export { AndroidAdbBackend, DesktopBackend, WindowsBackend, MacOsBackend, IosBackend, createBackend, SUPPORTED_BACKENDS, type BackendName, type SandboxBackend, type BackendFamily, type AndroidAdbBackendOptions, type DesktopBackendOptions, type CreateBackendOptions, } from "./backends/index.js";
+export { BaseSandboxBackend, type ScreenSize, type UiDumpOutput, type ExecuteCommandOutput, type ListDirectoryEntry, } from "./backends/base.js";
+export declare const VERSION = "0.2.0";

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @beeos-ai/device-mcp-server — public surface.
+ *
+ * Most callers use the CLI (`device-mcp-server`) and reach the server over
+ * HTTP. The exports here are for embedders that want to host a server in
+ * the same Node process (e.g. integration tests, custom orchestration).
+ */
+export { buildApp } from "./server/app.js";
+export { TOOLS, getTool, listToolDescriptors, } from "./server/tool-registry.js";
+export { mapActionToTool, } from "./server/action-mapping.js";
+export { AndroidAdbBackend, DesktopBackend, WindowsBackend, MacOsBackend, IosBackend, createBackend, SUPPORTED_BACKENDS, } from "./backends/index.js";
+export { BaseSandboxBackend, } from "./backends/base.js";
+export const VERSION = "0.2.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAwB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,KAAK,EACL,OAAO,EACP,mBAAmB,GAIpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,GAIhB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,EACb,kBAAkB,GAOnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAKnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/server/action-mapping.d.ts

@@ -0,0 +1,21 @@
+/**
+ * action-mapping — translate a unified `Action` (`type+target+payload`) into
+ * the matching MCP tool name + arguments.
+ *
+ * Used by `POST /act` so callers can hand the server a high-level Action and
+ * skip wiring up a tool name themselves. Mirrors the Python reference's
+ * `_action_to_call` table.
+ */
+import { type Action, type ActionType } from "@beeos-ai/device-common";
+export interface ToolCall {
+    toolName: string;
+    args: Record<string, unknown>;
+}
+export interface UnsupportedActionResult {
+    /** Terminal verbs (`done`, `fail`, `wait`, `call_for_user`) — server replies
+     *  with `{ ok: true, action }` and does NOT touch the backend. */
+    terminal: true;
+    type: ActionType;
+}
+export type ActionMappingResult = ToolCall | UnsupportedActionResult;
+export declare function mapActionToTool(action: Action): ActionMappingResult;

package/dist/server/action-mapping.js

@@ -0,0 +1,153 @@
+/**
+ * action-mapping — translate a unified `Action` (`type+target+payload`) into
+ * the matching MCP tool name + arguments.
+ *
+ * Used by `POST /act` so callers can hand the server a high-level Action and
+ * skip wiring up a tool name themselves. Mirrors the Python reference's
+ * `_action_to_call` table.
+ */
+import { TERMINAL_ACTIONS, } from "@beeos-ai/device-common";
+export function mapActionToTool(action) {
+    if (TERMINAL_ACTIONS.has(action.type) || action.type === "wait") {
+        return { terminal: true, type: action.type };
+    }
+    const target = action.target;
+    const payload = action.payload ?? {};
+    switch (action.type) {
+        case "click":
+        case "tap":
+        case "double_click":
+        case "right_click":
+        case "long_press":
+        case "move": {
+            const xy = pointFromTarget(target);
+            return {
+                toolName: action.type === "move" ? "move" : action.type,
+                args: {
+                    ...xy,
+                    ...(action.type === "click" && payload.button ? { button: payload.button } : {}),
+                    ...(action.type === "click" && payload.clicks ? { clicks: payload.clicks } : {}),
+                    ...(action.type === "long_press" && payload.durationMs
+                        ? { durationMs: payload.durationMs }
+                        : {}),
+                },
+            };
+        }
+        case "drag":
+        case "swipe": {
+            const seg = segmentFromTarget(target);
+            return {
+                toolName: action.type,
+                args: {
+                    ...seg,
+                    ...(payload.durationMs ? { durationMs: payload.durationMs } : {}),
+                },
+            };
+        }
+        case "scroll": {
+            const xy = target ? pointFromTarget(target) : { x: 0, y: 0 };
+            return {
+                toolName: "scroll",
+                args: {
+                    ...xy,
+                    direction: payload.direction ?? "down",
+                    ...(payload.amount ? { amount: payload.amount } : {}),
+                },
+            };
+        }
+        case "type":
+            return {
+                toolName: "type",
+                args: { text: payload.text ?? "" },
+            };
+        case "key":
+            return {
+                toolName: "key",
+                args: { key: payload.key ?? payload.keycode ?? "" },
+            };
+        case "hotkey":
+            return {
+                toolName: "hotkey",
+                args: { keys: payload.keys ?? [] },
+            };
+        case "back":
+            return { toolName: "back", args: {} };
+        case "home":
+            return { toolName: "home", args: {} };
+        case "navigate":
+            return {
+                toolName: "back",
+                args: {},
+            };
+        case "launch_app": {
+            const fromTarget = target && (target.kind === "text" || target.kind === "selector")
+                ? target.value
+                : undefined;
+            const pkg = fromTarget ??
+                payload.pkg ??
+                payload.appName ??
+                payload.packageOrName ??
+                payload.package ??
+                "";
+            return {
+                toolName: "launch_app",
+                args: {
+                    pkg,
+                    ...(payload.activity ? { activity: payload.activity } : {}),
+                },
+            };
+        }
+        case "screenshot":
+            return { toolName: "screenshot", args: {} };
+        case "ui_dump":
+            return {
+                toolName: "ui_dump",
+                args: {
+                    ...(payload.query ? { query: payload.query } : {}),
+                    ...(payload.format ? { format: payload.format } : {}),
+                },
+            };
+        case "execute_command":
+        case "run_code":
+            return {
+                toolName: "execute_command",
+                args: {
+                    body: payload.body ?? payload.command ?? "",
+                    ...(payload.timeoutS ? { timeoutS: payload.timeoutS } : {}),
+                    ...(payload.cwd ? { cwd: payload.cwd } : {}),
+                },
+            };
+        case "file_read": {
+            const path = payload.path ??
+                (target && (target.kind === "text" || target.kind === "selector")
+                    ? target.value
+                    : "");
+            return { toolName: "file_read", args: { path } };
+        }
+        case "file_write": {
+            const path = payload.path ??
+                (target && (target.kind === "text" || target.kind === "selector")
+                    ? target.value
+                    : "");
+            return {
+                toolName: "file_write",
+                args: { path, contentB64: payload.contentB64 ?? "" },
+            };
+        }
+        default:
+            throw new Error(`unsupported action type: ${String(action.type)}`);
+    }
+}
+function pointFromTarget(target) {
+    if (target && target.kind === "point") {
+        return { x: target.x, y: target.y };
+    }
+    throw new TypeError("action.target must be {kind:'point', x, y} for this action type");
+}
+function segmentFromTarget(target) {
+    if (target && target.kind === "box") {
+        return { x1: target.x1, y1: target.y1, x2: target.x2, y2: target.y2 };
+    }
+    throw new TypeError("action.target must be {kind:'box', x1, y1, x2, y2} for this action type");
+}
+//# sourceMappingURL=action-mapping.js.map

package/dist/server/action-mapping.js.map

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

package/dist/server/app.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Fastify factory — `buildApp({ backend })` returns a configured `FastifyInstance`
+ * with all routes wired up. Decoupled from `cli.ts` so unit tests can spin up
+ * an in-process server with a mock backend.
+ *
+ * Routes (mirrors the Python `mcp_tools/server.py` reference):
+ *   GET  /healthz             — liveness + backend OS + tool list
+ *   POST /mcp/tools/list      — MCP tool discovery
+ *   POST /mcp/tools/call      — invoke a single MCP tool
+ *   POST /act                 — translate `Action` → tool call
+ *   GET  /screen.png          — fast-path screenshot (no JSON envelope)
+ *   GET  /events              — SSE event stream (placeholder, no consumers yet)
+ */
+import { type FastifyInstance } from "fastify";
+import type { SandboxBackend } from "../backends/base.js";
+export interface BuildAppOptions {
+    backend: SandboxBackend;
+    /** Override Fastify's logger. Pass `false` to silence in tests. */
+    logger?: boolean | object;
+    /** Per-request body size cap (bytes). Defaults to 16MB for file_write base64. */
+    bodyLimit?: number;
+}
+export declare function buildApp(opts: BuildAppOptions): Promise<FastifyInstance>;

package/dist/server/app.js

@@ -0,0 +1,157 @@
+/**
+ * Fastify factory — `buildApp({ backend })` returns a configured `FastifyInstance`
+ * with all routes wired up. Decoupled from `cli.ts` so unit tests can spin up
+ * an in-process server with a mock backend.
+ *
+ * Routes (mirrors the Python `mcp_tools/server.py` reference):
+ *   GET  /healthz             — liveness + backend OS + tool list
+ *   POST /mcp/tools/list      — MCP tool discovery
+ *   POST /mcp/tools/call      — invoke a single MCP tool
+ *   POST /act                 — translate `Action` → tool call
+ *   GET  /screen.png          — fast-path screenshot (no JSON envelope)
+ *   GET  /events              — SSE event stream (placeholder, no consumers yet)
+ */
+import Fastify from "fastify";
+import { AcpError, DeviceError, VlmError, } from "@beeos-ai/device-common";
+import { mapActionToTool } from "./action-mapping.js";
+import { getToolFor, listToolDescriptorsFor } from "./tool-registry.js";
+export async function buildApp(opts) {
+    const app = Fastify({
+        logger: opts.logger ?? true,
+        bodyLimit: opts.bodyLimit ?? 16 * 1024 * 1024,
+    });
+    app.setErrorHandler((err, _req, reply) => {
+        if (err instanceof DeviceError) {
+            const status = err.subtype === "unsupported" ? 501 : err.subtype === "invalid_args" ? 400 : 500;
+            reply
+                .status(status)
+                .send({ error: err.message, subtype: err.subtype, retriable: err.retriable });
+            return;
+        }
+        if (err instanceof AcpError) {
+            reply.status(400).send({ error: err.message, code: err.code });
+            return;
+        }
+        if (err instanceof VlmError) {
+            reply.status(400).send({ error: err.message, retriable: err.retriable });
+            return;
+        }
+        reply.status(500).send({ error: err?.message ?? "internal error" });
+    });
+    /* ---------- /healthz ---------- */
+    app.get("/healthz", async () => {
+        return {
+            ok: true,
+            // Wire field name kept as `backend` even though the source is
+            // now `os` rather than `family`. Values are unchanged
+            // (`"android"` / `"desktop-macos"` / etc) — see the BackendOs
+            // taxonomy in @beeos-ai/device-common/backend.ts.
+            backend: opts.backend.os,
+            version: process.env.npm_package_version ?? "0.2.0",
+            // Tool-set-filtered list — agents that pick a tool out of this
+            // list are guaranteed it'll dispatch on the active backend.
+            tools: listToolDescriptorsFor(opts.backend).map((t) => t.name),
+        };
+    });
+    /* ---------- /mcp/tools/list ---------- */
+    const toolListHandler = async () => ({
+        tools: listToolDescriptorsFor(opts.backend),
+    });
+    app.get("/mcp/tools/list", toolListHandler);
+    app.post("/mcp/tools/list", toolListHandler);
+    /* ---------- /mcp/tools/call ---------- */
+    app.post("/mcp/tools/call", async (req, reply) => {
+        const { name, arguments: args = {} } = req.body ?? {};
+        if (!name || typeof name !== "string") {
+            reply.status(400).send({ error: "missing tool name" });
+            return;
+        }
+        const tool = getToolFor(name, opts.backend);
+        if (!tool) {
+            // Either the tool is unknown OR the backend lacks the required
+            // capability — collapse both to 404 so MCP clients reading
+            // `/mcp/tools/list` cannot bypass the filter via direct call.
+            reply.status(404).send({ error: `unknown tool '${name}'` });
+            return;
+        }
+        const startedAt = Date.now();
+        try {
+            const result = await tool.handler(args, { backend: opts.backend });
+            const response = {
+                ok: true,
+                tool: name,
+                durationMs: Date.now() - startedAt,
+                result,
+            };
+            reply.send(response);
+        }
+        catch (e) {
+            if (e instanceof DeviceError)
+                throw e;
+            if (e instanceof Error && e.name === "TypeError") {
+                reply.status(400).send({ error: e.message });
+                return;
+            }
+            throw e;
+        }
+    });
+    /* ---------- /act ---------- */
+    app.post("/act", async (req, reply) => {
+        const action = req.body?.action;
+        if (!action || typeof action.type !== "string") {
+            reply.status(400).send({ error: "missing or malformed action" });
+            return;
+        }
+        const startedAt = Date.now();
+        const mapped = mapActionToTool(action);
+        if ("terminal" in mapped) {
+            const response = {
+                ok: true,
+                action: mapped.type,
+                terminal: true,
+                durationMs: Date.now() - startedAt,
+            };
+            reply.send(response);
+            return;
+        }
+        const tool = getToolFor(mapped.toolName, opts.backend);
+        if (!tool) {
+            reply.status(404).send({ error: `tool '${mapped.toolName}' not registered` });
+            return;
+        }
+        const result = await tool.handler(mapped.args, { backend: opts.backend });
+        const response = {
+            ok: true,
+            action: action.type,
+            tool: mapped.toolName,
+            durationMs: Date.now() - startedAt,
+            result,
+        };
+        reply.send(response);
+    });
+    /* ---------- /screen.png ---------- */
+    app.get("/screen.png", async (_req, reply) => {
+        // 0.2.3: backend reports the encoded format directly so we never
+        // need to magic-byte-sniff the buffer here.
+        const shot = await opts.backend.screenshot();
+        reply
+            .header("content-type", shot.format === "png" ? "image/png" : "image/jpeg")
+            .send(shot.data);
+    });
+    /* ---------- /events (SSE placeholder) ---------- */
+    app.get("/events", async (_req, reply) => {
+        reply.raw.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+        });
+        reply.raw.write(": connected\n\n");
+        const interval = setInterval(() => {
+            reply.raw.write(`: heartbeat ${Date.now()}\n\n`);
+        }, 15_000);
+        reply.raw.on("close", () => clearInterval(interval));
+        return reply;
+    });
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/server/app.js.map

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

package/dist/server/tool-registry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 type { ToolDescriptor } from "@beeos-ai/device-common";
+import type { SandboxBackend } from "../backends/base.js";
+export interface ToolHandlerContext {
+    backend: SandboxBackend;
+}
+export type ToolHandler = (args: Record<string, unknown>, ctx: ToolHandlerContext) => Promise<unknown>;
+export interface ToolEntry {
+    descriptor: ToolDescriptor;
+    handler: ToolHandler;
+}
+export declare const TOOLS: Record<string, ToolEntry>;
+/**
+ * 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 declare function listToolDescriptors(): ToolDescriptor[];
+/** Return tool descriptors filtered by the backend's advertised tool set. */
+export declare function listToolDescriptorsFor(backend: SandboxBackend): ToolDescriptor[];
+/** Look up a tool by name, ignoring backend tool-set gates. */
+export declare function getTool(name: string): ToolEntry | undefined;
+/**
+ * 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 declare function getToolFor(name: string, backend: SandboxBackend): ToolEntry | undefined;