@beeos-ai/device-agent 0.4.0

package/dist/inbound/acp/router.d.ts

@@ -0,0 +1,67 @@
+/**
+ * ACP JSON-RPC 2.0 router.
+ *
+ * Parses incoming messages from the Bridge transport, dispatches to the
+ * matching handler, and returns the wire-format response string (or null for
+ * notifications).
+ *
+ * Wire types come from `@beeos-ai/beeos-types/acp` so the request /
+ * notification envelope is byte-compatible with the beeos-claw + web SDK
+ * implementations:
+ *
+ *   import type { JsonRpcRequest, JsonRpcNotification } from
+ *     "@beeos-ai/beeos-types/acp";
+ *
+ * The handler signatures still take the lenient legacy `AcpMessage` because
+ * many handlers tolerate `params` being either present or absent and use
+ * `params?.foo` indexing internally — keeping that shape avoids churn while
+ * still gaining a strict outer envelope check at parse time.
+ *
+ * Error mapping (ACP wire v2):
+ *  - JSON parse error  → -32700
+ *  - method not found  → -32601
+ *  - AcpError          → forwarded with its own `code` (default -32000)
+ *  - DeviceError       → -32001 + `data: { category: "device", subtype, retriable }`
+ *  - VlmError          → -32002 + `data: { category: "vlm", retriable }`
+ *  - other Error       → -32000 + `data: { category: "internal" }`
+ */
+import type { IBridgeTransport } from "../../ports/transport.js";
+import { type InitializeOptions } from "./handlers/initialize.js";
+import { AcpDeviceHandlers, type AcpMessage } from "./handlers/device.js";
+import { AcpSessionHandlers } from "./handlers/session.js";
+import { AcpModelHandlers, type ModelListProvider } from "./handlers/models.js";
+import { AcpSkillsHandlers } from "./handlers/skills.js";
+export interface AcpRouterOptions {
+    device: AcpDeviceHandlers;
+    session: AcpSessionHandlers;
+    models?: AcpModelHandlers;
+    skills?: AcpSkillsHandlers;
+    initialize?: InitializeOptions;
+    modelListProvider?: ModelListProvider;
+    /** Logger hook — defaults to a no-op. */
+    log?: (event: {
+        method?: string;
+        id?: unknown;
+        error?: unknown;
+    }) => void;
+}
+export declare class AcpRouter {
+    private readonly handlers;
+    private readonly notificationHandlers;
+    private readonly initOpts;
+    private readonly log;
+    constructor(opts: AcpRouterOptions);
+    handleMessage(raw: string): Promise<string | null>;
+}
+/**
+ * Map a thrown error to the ACP wire-v2 JSON-RPC error envelope.
+ *
+ * Exported for unit tests; mirrors the contract documented at the top of this
+ * file (see "Error mapping").
+ */
+export declare function mapErrorResponse(id: AcpMessage["id"] | null, err: Error): string;
+/**
+ * Wire the router to a transport. Pumps inbound messages into the router and
+ * sends responses back. Returns a `dispose` function.
+ */
+export declare function bindRouterToTransport(router: AcpRouter, transport: IBridgeTransport): () => Promise<void>;

package/dist/inbound/acp/router.js

@@ -0,0 +1,179 @@
+/**
+ * ACP JSON-RPC 2.0 router.
+ *
+ * Parses incoming messages from the Bridge transport, dispatches to the
+ * matching handler, and returns the wire-format response string (or null for
+ * notifications).
+ *
+ * Wire types come from `@beeos-ai/beeos-types/acp` so the request /
+ * notification envelope is byte-compatible with the beeos-claw + web SDK
+ * implementations:
+ *
+ *   import type { JsonRpcRequest, JsonRpcNotification } from
+ *     "@beeos-ai/beeos-types/acp";
+ *
+ * The handler signatures still take the lenient legacy `AcpMessage` because
+ * many handlers tolerate `params` being either present or absent and use
+ * `params?.foo` indexing internally — keeping that shape avoids churn while
+ * still gaining a strict outer envelope check at parse time.
+ *
+ * Error mapping (ACP wire v2):
+ *  - JSON parse error  → -32700
+ *  - method not found  → -32601
+ *  - AcpError          → forwarded with its own `code` (default -32000)
+ *  - DeviceError       → -32001 + `data: { category: "device", subtype, retriable }`
+ *  - VlmError          → -32002 + `data: { category: "vlm", retriable }`
+ *  - other Error       → -32000 + `data: { category: "internal" }`
+ */
+import { AcpError, DeviceError, VlmError } from "../../core/errors.js";
+import { runWithCorrelation } from "../../logger/index.js";
+import { buildInitializeResponse, } from "./handlers/initialize.js";
+import { AcpModelHandlers } from "./handlers/models.js";
+import { AcpSkillsHandlers } from "./handlers/skills.js";
+export class AcpRouter {
+    handlers = new Map();
+    notificationHandlers = new Map();
+    initOpts;
+    log;
+    constructor(opts) {
+        this.initOpts = opts.initialize ?? {};
+        this.log = opts.log ?? (() => undefined);
+        const m = opts.models ?? new AcpModelHandlers(opts.modelListProvider);
+        const sk = opts.skills ?? new AcpSkillsHandlers();
+        this.handlers.set("initialize", async (msg) => {
+            const resp = buildInitializeResponse(this.initOpts, (msg.params ?? {}));
+            return resp;
+        });
+        // Lightweight liveness probe. Mirrors the beeos-claw `ping` method —
+        // clients use it to verify the daemon's ACP stack is responsive
+        // independent of session state. Intentionally takes / returns nothing
+        // beyond `{ pong: true }`.
+        this.handlers.set("ping", async () => ({ pong: true }));
+        this.handlers.set("device/info", (msg) => opts.device.info(msg));
+        this.handlers.set("device/screenshot", (msg) => opts.device.screenshot(msg));
+        this.handlers.set("device/ui-tree", (msg) => opts.device.uiTree(msg));
+        this.handlers.set("device/action", (msg) => opts.device.action(msg));
+        this.handlers.set("device/install", (msg) => opts.device.install(msg));
+        this.handlers.set("device/shell", (msg) => opts.device.shell(msg));
+        this.handlers.set("session/new", (msg) => opts.session.new(msg));
+        this.handlers.set("session/load", (msg) => opts.session.load(msg));
+        this.handlers.set("session/list", (msg) => opts.session.list(msg));
+        this.handlers.set("session/prompt", (msg) => opts.session.prompt(msg));
+        this.handlers.set("session/rename", (msg) => opts.session.rename(msg));
+        this.handlers.set("session/delete", (msg) => opts.session.delete(msg));
+        this.handlers.set("session/clear", (msg) => opts.session.clear(msg));
+        this.handlers.set("session/cancel", (msg) => opts.session.cancel(msg));
+        this.handlers.set("session/set_mode", (msg) => opts.session.setMode(msg));
+        this.handlers.set("session/set_model", (msg) => opts.session.setModel(msg));
+        this.handlers.set("models/list", () => m.list());
+        this.handlers.set("skills/list", () => sk.list());
+        // Notifications (no id, no response)
+        this.notificationHandlers.set("session/cancel", (msg) => opts.session.cancel(msg));
+    }
+    async handleMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return errorResponse(null, -32700, "Parse error");
+        }
+        const method = msg.method ?? "";
+        // Notifications (per JSON-RPC 2.0) MUST omit `id`; we treat any
+        // missing/null id as a notification regardless of which envelope
+        // alias the client picked.
+        const id = msg.id;
+        const params = typeof msg.params === "object" && msg.params !== null
+            ? msg.params
+            : undefined;
+        const sessionId = params?.sessionId ?? undefined;
+        const requestId = id !== undefined && id !== null ? `acp-${String(id)}` : undefined;
+        this.log({ method, id });
+        // The handlers were written against the looser legacy `AcpMessage`
+        // shape (params is optional + indexable). Build a single object that
+        // satisfies both their input contract and the canonical wire types.
+        const legacy = {
+            jsonrpc: msg.jsonrpc,
+            id: id,
+            method,
+            params,
+        };
+        return runWithCorrelation({ requestId, sessionId }, async () => {
+            if (id === undefined || id === null) {
+                const handler = this.notificationHandlers.get(method);
+                if (handler) {
+                    try {
+                        await handler(legacy);
+                    }
+                    catch (e) {
+                        this.log({ method, error: e });
+                    }
+                }
+                return null;
+            }
+            const handler = this.handlers.get(method);
+            if (!handler)
+                return errorResponse(id, -32601, `Method not found: ${method}`);
+            try {
+                const result = await handler(legacy);
+                return JSON.stringify({ jsonrpc: "2.0", id, result });
+            }
+            catch (e) {
+                const err = e;
+                this.log({ method, id, error: err });
+                return mapErrorResponse(id, err);
+            }
+        });
+    }
+}
+function errorResponse(id, code, message, data) {
+    const error = { code, message };
+    if (data !== undefined)
+        error.data = data;
+    return JSON.stringify({ jsonrpc: "2.0", id: id ?? null, error });
+}
+/**
+ * Map a thrown error to the ACP wire-v2 JSON-RPC error envelope.
+ *
+ * Exported for unit tests; mirrors the contract documented at the top of this
+ * file (see "Error mapping").
+ */
+export function mapErrorResponse(id, err) {
+    if (err instanceof AcpError) {
+        return errorResponse(id, err.code, err.message || "ACP error", err.data);
+    }
+    if (err instanceof DeviceError) {
+        return errorResponse(id, -32001, err.message || "Device error", {
+            category: "device",
+            subtype: err.subtype,
+            retriable: err.retriable,
+        });
+    }
+    if (err instanceof VlmError) {
+        return errorResponse(id, -32002, err.message || "VLM error", {
+            category: "vlm",
+            retriable: err.retriable,
+        });
+    }
+    return errorResponse(id, -32000, err.message ?? String(err), {
+        category: "internal",
+    });
+}
+/**
+ * Wire the router to a transport. Pumps inbound messages into the router and
+ * sends responses back. Returns a `dispose` function.
+ */
+export function bindRouterToTransport(router, transport) {
+    const onMessage = async (raw) => {
+        const resp = await router.handleMessage(raw);
+        if (resp) {
+            try {
+                await transport.send(resp);
+            }
+            catch { /* ignore — transport handles reconnect */ }
+        }
+    };
+    transport.on("message", onMessage);
+    return async () => transport.close();
+}
+//# sourceMappingURL=router.js.map

package/dist/inbound/acp/router.js.map

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

package/dist/inbound/cli/fleet-command.d.ts

@@ -0,0 +1,34 @@
+/**
+ * inbound/cli/fleet-command — `device-agent fleet …` subcommand family.
+ *
+ * The fleet supervisor process is a single long-running daemon that:
+ *
+ *   - Listens to ADB events (`adb track-devices`)
+ *   - Watches `~/.beeos/devices.json` for binding changes
+ *   - For every BOUND device, spawns and supervises:
+ *       device-mcp-server  (local AI tooling)
+ *       device-agent       (BeeOS cloud control daemon, Ed25519 → Agent Gateway)
+ *   - Exposes a tiny HTTP status server on `127.0.0.1:7950` for the
+ *     other CLI subcommands (`status`, `devices`, `restart`, `reload`).
+ *
+ * The CLI splits into two halves:
+ *
+ *   server side: `start [--no-daemon]` → builds the `FleetSupervisor` and
+ *                serves `/fleet/*` over HTTP.
+ *   client side: `status | devices | restart | reload` → opens an HTTP
+ *                connection to the running fleet on `:7950`.
+ *
+ * All client-side commands fail fast with an actionable hint when the
+ * fleet isn't running. There is intentionally NO auto-spawn: the user is
+ * expected to start the fleet via `fleet start` (foreground) or `fleet
+ * enable` (launchd / systemd, M5 in a follow-up plan).
+ */
+export interface FleetCommandIO {
+    stdout?: {
+        write(s: string): void;
+    };
+    stderr?: {
+        write(s: string): void;
+    };
+}
+export declare function fleetCommand(argv: string[], io?: FleetCommandIO): Promise<number>;