@beeos-ai/device-agent 0.4.0

package/dist/plugins/http-debug/server.js

@@ -0,0 +1,464 @@
+/**
+ * HTTP debug server (Fastify) — backed by AgentHost.
+ *
+ * Mirrors the Python `DeviceAgentAPI` route table 1:1. Used for local testing,
+ * `curl`-friendly debugging, and the device-viewer web client. Production
+ * traffic flows through ACP — HTTP is opt-in.
+ *
+ * Tasks submitted via `POST /tasks` are forwarded to `AgentHost.submitTask`.
+ * The server keeps a private `HttpTaskStore` populated from `host.on(...)`
+ * events to back the legacy `/tasks/*` polling routes.
+ *
+ * adb-proxy routes are stubbed: they respond `404 not active` until the proxy
+ * is implemented.
+ */
+import Fastify from "fastify";
+import cors from "@fastify/cors";
+import multipart from "@fastify/multipart";
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { parseAcpAction } from "../../core/actions.js";
+import { AcpError, DeviceError, VlmError } from "../../core/errors.js";
+import { enterCorrelation, getLogger } from "../../logger/index.js";
+/**
+ * Minimal task store driven by `AgentHost` events. Owned by the HTTP
+ * debug plugin so it can serve `/tasks` polling routes without reaching
+ * into the ACP plugin's session state.
+ */
+export class HttpTaskStore {
+    tasks = new Map();
+    submitted = new Map();
+    detach = null;
+    attach(host) {
+        if (this.detach)
+            return;
+        this.detach = host.on((ev) => this.onEvent(ev));
+    }
+    stop() {
+        if (this.detach) {
+            this.detach();
+            this.detach = null;
+        }
+    }
+    /**
+     * Track a task that this store submitted. Tasks submitted by other
+     * plugins (e.g. ACP `prompt`) will not appear in `/tasks` listings —
+     * the debug HTTP API only shows what was submitted through it.
+     */
+    track(task, prompt) {
+        const rec = {
+            id: task.taskId,
+            prompt,
+            status: "pending",
+            createdAt: Date.now(),
+            startedAt: null,
+            completedAt: null,
+            result: null,
+            error: null,
+            steps: [],
+        };
+        this.tasks.set(task.taskId, rec);
+        this.submitted.set(task.taskId, task);
+        return rec;
+    }
+    list() {
+        return Array.from(this.tasks.values()).sort((a, b) => b.createdAt - a.createdAt);
+    }
+    get(id) {
+        return this.tasks.get(id);
+    }
+    cancel(id) {
+        const t = this.submitted.get(id);
+        if (!t)
+            return false;
+        return t.cancel();
+    }
+    pruneCompleted(olderThanMs = 60 * 60 * 1000) {
+        const cutoff = Date.now() - olderThanMs;
+        let removed = 0;
+        for (const [id, t] of this.tasks) {
+            if (t.status !== "completed" && t.status !== "failed" && t.status !== "cancelled")
+                continue;
+            const ts = t.completedAt ?? t.createdAt;
+            if (ts < cutoff) {
+                this.tasks.delete(id);
+                this.submitted.delete(id);
+                removed += 1;
+            }
+        }
+        return removed;
+    }
+    // ── Internal ───────────────────────────────────────────────────────────────
+    onEvent(ev) {
+        const rec = this.tasks.get(ev.taskId);
+        if (!rec)
+            return;
+        if (ev.type === "task:start") {
+            rec.status = "running";
+            rec.startedAt = ev.createdAt;
+            return;
+        }
+        if (ev.type === "task:step") {
+            const step = ev.step;
+            const action = step.action ? step.action.kind : step.finished ? "done" : "wait";
+            const parameters = step.action ? extractActionParams(step.action) : {};
+            rec.steps.push({
+                index: step.stepIndex,
+                action,
+                parameters,
+                status: step.finished ? "completed" : "running",
+                reasoning: step.thinking,
+            });
+            return;
+        }
+        if (ev.type === "task:end") {
+            rec.completedAt = ev.completedAt;
+            if (ev.error) {
+                rec.status = "failed";
+                rec.error = ev.error;
+            }
+            else if (ev.result.cancelled) {
+                rec.status = "cancelled";
+            }
+            else {
+                rec.status = "completed";
+                rec.result = ev.result.finalMessage;
+            }
+            return;
+        }
+        // task:text / task:tool: ignored — HTTP debug API surfaces VlmStep records
+    }
+}
+export class HttpServer {
+    opts;
+    app = null;
+    tasks = new HttpTaskStore();
+    constructor(opts) {
+        this.opts = {
+            devices: opts.devices,
+            host: opts.host,
+            bindHost: opts.bindHost ?? "127.0.0.1",
+            port: opts.port ?? 9090,
+            log: opts.log ?? false,
+            corsOrigins: opts.corsOrigins ?? "",
+        };
+    }
+    async start() {
+        this.tasks.attach(this.opts.host);
+        const app = Fastify({ logger: this.opts.log });
+        await app.register(cors, {
+            origin: parseCorsOrigins(this.opts.corsOrigins),
+            methods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+            allowedHeaders: ["Content-Type", "Authorization"],
+            maxAge: 86400,
+        });
+        await app.register(multipart, { limits: { fileSize: 200 * 1024 * 1024 } });
+        app.addHook("onRequest", (req, _reply, done) => {
+            const incoming = req.headers["x-request-id"] ??
+                req.headers["x-correlation-id"];
+            const requestId = incoming || randomUUID();
+            req.requestId = requestId;
+            enterCorrelation({ requestId });
+            done();
+        });
+        app.setErrorHandler(buildErrorHandler);
+        this.registerRoutes(app);
+        await app.listen({ host: this.opts.bindHost, port: this.opts.port });
+        this.app = app;
+    }
+    async stop() {
+        if (this.app)
+            await this.app.close();
+        this.app = null;
+        this.tasks.stop();
+    }
+    /** For tests: returns the underlying Fastify instance for `inject()` calls. */
+    get instance() {
+        return this.app;
+    }
+    registerRoutes(app) {
+        const { devices, host } = this.opts;
+        const tasks = this.tasks;
+        app.get("/health", async () => {
+            const reg = devices.get();
+            if (!reg)
+                return { status: "ok", device: null, connected: false };
+            const info = await reg.device.getInfo().catch(() => null);
+            return {
+                status: "ok",
+                device: info?.name ?? reg.id,
+                connected: !!info,
+            };
+        });
+        app.get("/device/info", async () => {
+            const info = await devices.active().getInfo();
+            return {
+                type: info.type,
+                name: info.name,
+                os: info.os,
+                version: info.osVersion,
+                screen: { width: info.width, height: info.height, density: info.density },
+                capabilities: info.capabilities,
+            };
+        });
+        app.get("/device/screenshot", async () => {
+            const ss = await devices.active().capture({ raw: true });
+            return { image: ss.imageBase64, format: ss.imageFormat };
+        });
+        app.get("/device/ui-tree", async () => {
+            const nodes = await devices.active().getUiTree();
+            return { nodes };
+        });
+        app.get("/device/screenshot.png", async (_req, reply) => {
+            const ss = await devices.active().capture({ raw: true });
+            const buf = Buffer.from(ss.imageBase64, "base64");
+            reply.header("Content-Type", "image/png");
+            return reply.send(buf);
+        });
+        app.post("/device/action", async (req) => {
+            const body = (req.body ?? {});
+            const action = body.action ?? "";
+            const params = body.parameters ?? {};
+            if (!action)
+                throw new DeviceError("action is required", { subtype: "invalid_args" });
+            if (action === "shell") {
+                if (process.env.BEEOS_SHELL_ALLOW !== "true") {
+                    throw new AcpError("shell command execution is disabled — set BEEOS_SHELL_ALLOW=true to opt in", -32603, { category: "shell-disabled" });
+                }
+                const out = await devices.active().shell(params.command ?? "");
+                return { output: out };
+            }
+            const a = parseAcpAction(action, params);
+            await devices.active().apply(a);
+            return { ok: true };
+        });
+        app.post("/tasks", async (req, reply) => {
+            const body = (req.body ?? {});
+            const instruction = body.instruction ?? "";
+            if (!instruction) {
+                throw new AcpError("instruction is required", -32602);
+            }
+            const submitted = host.submitTask(instruction);
+            const rec = tasks.track(submitted, instruction);
+            return reply.status(201).send({
+                task_id: rec.id,
+                status: rec.status,
+                instruction: rec.prompt,
+            });
+        });
+        app.get("/tasks", async (req) => {
+            const limit = Number((req.query?.limit) ?? 50);
+            const list = tasks.list().slice(0, limit);
+            return {
+                tasks: list.map((t) => ({
+                    id: t.id,
+                    instruction: t.prompt,
+                    status: t.status,
+                    steps: t.steps.length,
+                    elapsed: t.completedAt && t.startedAt ? Math.round((t.completedAt - t.startedAt) / 100) / 10 : 0,
+                    created_at: t.createdAt,
+                })),
+            };
+        });
+        app.get("/tasks/:task_id", async (req) => {
+            const t = tasks.get(req.params.task_id);
+            if (!t)
+                throw new AcpError("Task not found", -32004);
+            return {
+                id: t.id,
+                instruction: t.prompt,
+                status: t.status,
+                steps: t.steps,
+                result: t.result,
+                error: t.error,
+                elapsed: t.completedAt && t.startedAt ? Math.round((t.completedAt - t.startedAt) / 100) / 10 : 0,
+            };
+        });
+        app.post("/tasks/:task_id/cancel", async (req) => {
+            const ok = tasks.cancel(req.params.task_id);
+            if (!ok)
+                throw new AcpError("Task not found or already done", -32004);
+            return { ok: true };
+        });
+        app.post("/prompt", async (req, reply) => {
+            const body = (req.body ?? {});
+            const instruction = body.instruction ?? body.prompt ?? "";
+            const timeoutMs = (body.timeout ?? 120) * 1000;
+            if (!instruction)
+                throw new AcpError("instruction is required", -32602);
+            const submitted = host.submitTask(instruction);
+            const rec = tasks.track(submitted, instruction);
+            const deadline = Date.now() + timeoutMs;
+            while (Date.now() < deadline) {
+                const cur = tasks.get(rec.id);
+                if (cur && (cur.status === "completed" || cur.status === "failed" || cur.status === "cancelled")) {
+                    return {
+                        task_id: cur.id,
+                        status: cur.status,
+                        result: cur.result,
+                        error: cur.error,
+                        steps: cur.steps,
+                        elapsed: cur.completedAt && cur.startedAt ? Math.round((cur.completedAt - cur.startedAt) / 100) / 10 : 0,
+                    };
+                }
+                await sleep(1000);
+            }
+            return reply.status(202).send({
+                task_id: rec.id,
+                status: "running",
+                message: "Task still running, check /tasks/{task_id} for updates",
+            });
+        });
+        app.post("/device/install-apk", async (req) => {
+            const data = await req.file({ limits: { fileSize: 200 * 1024 * 1024 } });
+            // Accept either `file` (web frontend convention) or `apk` (legacy)
+            // multipart field name.
+            if (!data || (data.fieldname !== "file" && data.fieldname !== "apk")) {
+                throw new DeviceError("multipart field 'file' or 'apk' required", {
+                    subtype: "invalid_args",
+                });
+            }
+            const filename = path.basename(data.filename ?? "upload.apk");
+            if (!filename.endsWith(".apk")) {
+                throw new DeviceError("only .apk files accepted", { subtype: "invalid_args" });
+            }
+            const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "beeos_apk_"));
+            const tmpPath = path.join(tmpDir, filename);
+            let size = 0;
+            try {
+                await pipeline(data.file, fs.createWriteStream(tmpPath).on("drain", () => undefined));
+                size = fs.statSync(tmpPath).size;
+                await devices.active().install(tmpPath);
+                return { ok: true, filename, size };
+            }
+            finally {
+                try {
+                    fs.unlinkSync(tmpPath);
+                }
+                catch { /* ignore */ }
+                try {
+                    fs.rmdirSync(tmpDir);
+                }
+                catch { /* ignore */ }
+            }
+        });
+        // ── adb-proxy routes — stub-only until the proxy lands ─────────────────
+        const adbStubResp = (reply) => reply.status(404).send({ error: "ADB proxy not active" });
+        app.post("/adb-proxy/keys", async (_req, reply) => adbStubResp(reply));
+        app.delete("/adb-proxy/keys", async (_req, reply) => adbStubResp(reply));
+        app.get("/adb-proxy/status", async () => ({ active: false }));
+    }
+}
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+function extractActionParams(a) {
+    const { kind: _kind, ...rest } = a;
+    return rest;
+}
+const DEFAULT_LOCAL_ORIGINS = [
+    "http://localhost:3000",
+    "http://127.0.0.1:3000",
+    "http://localhost:5173",
+    "http://127.0.0.1:5173",
+    "http://localhost:5174",
+    "http://127.0.0.1:5174",
+];
+/** Parse the `corsOrigins` config value into the shape `@fastify/cors` wants. */
+function parseCorsOrigins(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (trimmed === "*")
+        return true;
+    if (!trimmed)
+        return DEFAULT_LOCAL_ORIGINS;
+    const list = trimmed
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    return list.length > 0 ? list : DEFAULT_LOCAL_ORIGINS;
+}
+/**
+ * Global Fastify error handler — every thrown error funnels through here.
+ *
+ * Response envelope: `{ error: { code, message, requestId, category?, subtype?, retriable? } }`.
+ * The handler also emits a structured log entry that includes the full stack
+ * (filtered through pino redact in production via the shared logger).
+ */
+export function buildErrorHandler(err, request, reply) {
+    const requestId = request.requestId ?? randomUUID();
+    const log = getLogger().child({ component: "http" });
+    if (err instanceof AcpError) {
+        const status = mapJsonRpcStatus(err.code);
+        log.warn({ requestId, route: request.url, code: err.code, err }, "acp error");
+        return reply.status(status).send({
+            error: {
+                code: err.code,
+                message: err.message,
+                requestId,
+                category: "acp",
+                ...(err.data && typeof err.data === "object" ? { data: err.data } : {}),
+            },
+        });
+    }
+    if (err instanceof DeviceError) {
+        const status = err.subtype === "invalid_args" ? 400 : err.subtype === "not_ready" ? 409 : 502;
+        log.warn({ requestId, route: request.url, subtype: err.subtype, retriable: err.retriable, err }, "device error");
+        return reply.status(status).send({
+            error: {
+                code: -32001,
+                message: err.message,
+                requestId,
+                category: "device",
+                subtype: err.subtype,
+                retriable: err.retriable,
+            },
+        });
+    }
+    if (err instanceof VlmError) {
+        log.warn({ requestId, route: request.url, retriable: err.retriable, err }, "vlm error");
+        return reply.status(502).send({
+            error: {
+                code: -32002,
+                message: err.message,
+                requestId,
+                category: "vlm",
+                retriable: err.retriable,
+            },
+        });
+    }
+    // Fastify validation / 4xx errors carry a `statusCode`.
+    const fastifyErr = err;
+    if (fastifyErr.statusCode && fastifyErr.statusCode >= 400 && fastifyErr.statusCode < 500) {
+        log.warn({ requestId, route: request.url, statusCode: fastifyErr.statusCode, err }, "client error");
+        return reply.status(fastifyErr.statusCode).send({
+            error: {
+                code: -32602,
+                message: err.message,
+                requestId,
+                category: "client",
+            },
+        });
+    }
+    log.error({ requestId, route: request.url, err }, "unhandled error");
+    return reply.status(500).send({
+        error: {
+            code: -32000,
+            message: "internal server error",
+            requestId,
+            category: "internal",
+        },
+    });
+}
+function mapJsonRpcStatus(code) {
+    if (code === -32700 || code === -32600 || code === -32602)
+        return 400;
+    if (code === -32601 || code === -32004)
+        return 404;
+    if (code === -32603)
+        return 500;
+    return 400;
+}
+//# sourceMappingURL=server.js.map

package/dist/plugins/http-debug/server.js.map

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

package/dist/ports/agent-core.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Port — IAgentCore.
+ *
+ * Represents the *entire* agent brain (potentially two-layered:
+ * outer orchestrator + inner mobile_use VLM loop) as a single black box
+ * that the rest of the process talks to. The core is intentionally
+ * **unaware** of:
+ *
+ *   - ACP / Bridge / HTTP transports
+ *   - SessionManager / TaskRunner accounting
+ *   - the pi-coding-agent vs single-layer details
+ *
+ * Plugins (ACP, HTTP debug, agent-sync, ...) interact with the core
+ * indirectly through `AgentHost`. The host owns the IAgentCore instance
+ * and dispatches events; plugins never call `IAgentCore.run` directly.
+ *
+ * Implementations:
+ *  - `adapters/agentcore-pi.ts` — pi-coding-agent two-layer orchestrator
+ *    (default; outer = arouter/kimi-k2.6, inner = autoglm-9b via mobile_use)
+ *  - `adapters/agentcore-inner-loop.ts` — single-layer fallback that wraps
+ *    `vlm-inner-loop.ts` (selected by `--legacy-inner`)
+ */
+import type { Action } from "../core/actions.js";
+/**
+ * Tool / action event surfaced by the agent core. Mirrors what an outer
+ * orchestrator would emit when calling a tool like `mobile_use`, `ground`,
+ * or `ui_xml`. For the legacy single-layer adapter, every step's
+ * `Action` is also reported as a synthetic `ToolCallEvent` (`name = action.kind`)
+ * so consumers can keep one code path.
+ */
+export interface ToolCallEvent {
+    /** Stable id local to this run (orchestrator-assigned). */
+    id: string;
+    /** Tool name, e.g. `mobile_use`, `ground`, or for the legacy adapter: `tap`, `swipe`, ... */
+    name: string;
+    /** JSON-serializable arguments passed to the tool. */
+    args: Record<string, unknown>;
+    /**
+     * Lifecycle phase:
+     *  - `start`   — tool was invoked
+     *  - `update`  — partial result or progress
+     *  - `end`     — tool finished (`isError` and `result` populated)
+     */
+    status: "start" | "update" | "end";
+    /** Free-form result blob (string output, structured JSON, …). */
+    result?: unknown;
+    /** Whether `end` represents a failure. */
+    isError?: boolean;
+}
+/**
+ * Per-step record kept for backward compatibility with the legacy
+ * `IVlm.runTask` shape. The host translates `ToolCallEvent`s into
+ * `VlmStep`-style records for the ACP `tool_call_update` envelope.
+ *
+ * Re-exported under the `VlmStep` alias from `ports/vlm.ts` so existing
+ * imports keep working.
+ */
+export interface VlmStep {
+    /** Free-form thinking/commentary, rendered as `agent_message_chunk`. */
+    thinking: string;
+    /** The action the model wants the device to perform, or null when finished. */
+    action: Action | null;
+    /** True iff the model declared the task done. */
+    finished: boolean;
+    /** Final user-facing message (only meaningful when `finished`). */
+    message: string | null;
+}
+/**
+ * Structured error surfaced by the agent runtime mid-run. Mirrors the
+ * `agent-runtime` `AgentRunHooks.onError` payload one-for-one so the
+ * adapter can forward it without re-shaping.
+ *
+ * `fatal=true` — the runtime gave up (e.g. exhausted retry budget); a
+ *   `task:end` with an `error` field is about to follow. UI should show
+ *   a terminal failure notice.
+ * `fatal=false` — transient, the runtime will keep retrying. UI should
+ *   surface a soft "still trying…" hint, throttled by AgentHost so a
+ *   long retry storm doesn't spam the chat.
+ */
+export interface AgentCoreRunError {
+    code: string;
+    message: string;
+    fatal: boolean;
+}
+/** Optional callbacks an `IAgentCore` may invoke during `run()`. */
+export interface AgentCoreRunCallbacks {
+    /** Streaming text delta — surfaced by ACP as `agent_message_chunk`. */
+    onText?: (text: string) => void | Promise<void>;
+    /**
+     * Streaming "thinking" delta — surfaced by ACP as `agent_thought_chunk`
+     * (a separate reasoning channel from the user-visible reply). Sources:
+     * VLM rationale per step (`AgentLoop`), planner `makePlan` / `replan`
+     * descriptions (`PlanExecutor.firePlan`), and any future o1-style
+     * reasoning tokens. Distinct from `onText` so the web UI can render
+     * thoughts in the reasoning side panel without polluting the main
+     * conversation stream.
+     */
+    onReasoning?: (text: string) => void | Promise<void>;
+    /** Tool call lifecycle — start / update / end. */
+    onTool?: (event: ToolCallEvent) => void | Promise<void>;
+    /**
+     * Per-step record (legacy compatibility). Mainly used by the
+     * single-layer `InnerLoopAgent`.
+     */
+    onStep?: (step: VlmStep & {
+        stepIndex: number;
+    }) => void | Promise<void>;
+    /**
+     * Mid-run error — typically a transient model 5xx that the runner is
+     * retrying. AgentHost translates this into a throttled `task:notice`
+     * so the UI shows "Model temporarily unavailable, retrying…" instead
+     * of going silent for the duration of the retry storm. The runtime
+     * adapter MAY also synthesise an `isError=true` `tool_call` for
+     * structured audit; the two are independent and complementary.
+     */
+    onError?: (err: AgentCoreRunError) => void | Promise<void>;
+}
+/** Result of a single `run()` call. */
+export interface AgentCoreRunResult {
+    /** Final user-facing reply. */
+    finalMessage: string;
+    /** Number of inner steps observed (0 for the pi adapter — opaque tools). */
+    steps: number;
+    /** True iff the run terminated due to abort / timeout. */
+    cancelled: boolean;
+}
+/** Options passed to `IAgentCore.run`. */
+export interface AgentCoreRunOptions extends AgentCoreRunCallbacks {
+    /** Natural language task / prompt. */
+    task: string;
+    /** Soft cap on inner steps (legacy adapter); pi adapter may ignore. */
+    maxSteps?: number;
+    abortSignal?: AbortSignal;
+}
+/**
+ * IAgentCore — the protocol-agnostic agent brain.
+ *
+ * Implementations MUST:
+ *  - be safe to call concurrently with `setModel`; new tasks pick up the
+ *    new model, in-flight tasks may keep the previous client.
+ *  - report progress via the supplied callbacks.
+ *  - honor `abortSignal` and reflect cancellation in the returned
+ *    `AgentCoreRunResult.cancelled` flag.
+ */
+export interface IAgentCore {
+    /** Currently active model id (informational only — e.g. for logs). */
+    readonly modelName: string;
+    /** Optional human-friendly tag for the active provider/adapter. */
+    readonly providerName?: string;
+    /** Run a single task to completion. */
+    run(opts: AgentCoreRunOptions): Promise<AgentCoreRunResult>;
+    /**
+     * Hot-swap the underlying model. `provider` is a free-form tag
+     * ("openai", "openrouter", "arouter", …) used by the implementation
+     * to pick the right adapter; `model` is the upstream id.
+     */
+    setModel(provider: string, model: string): Promise<void>;
+}

package/dist/ports/agent-core.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-core.js.map

package/dist/ports/agent-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-core.js","sourceRoot":"","sources":["../../src/ports/agent-core.ts"],"names":[],"mappings":""}