@beeos-ai/device-agent 0.4.0

package/dist/plugins/agent-sync/index.js

@@ -0,0 +1,98 @@
+/**
+ * Plugin — agent-sync.
+ *
+ * Posts a single `POST /api/v1/agents/sync` to Agent Gateway during
+ * `start()` so the device-agent appears in the platform's Agents
+ * directory and is discoverable via A2A.
+ *
+ * Failure is non-fatal — sync errors only emit a warning, the device
+ * still serves ACP normally. This keeps ground-truth agent metadata
+ * close to the binary that hosts the actual capabilities, while
+ * allowing development setups (no AGW reachability, no key file)
+ * to keep working.
+ *
+ * Resync semantics:
+ *   - one shot at start (parity with the legacy `main.ts` behavior)
+ *   - if `BEEOS_AGENT_SYNC_INTERVAL_MS` (or the constructor option) is
+ *     set to a positive number, we re-post on that cadence; default off
+ */
+import { syncAgents, } from "../../adapters/agent-gateway-client.js";
+export class AgentSyncPlugin {
+    opts;
+    name = "agent-sync";
+    ctx;
+    timer = null;
+    stopped = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    init(ctx) {
+        this.ctx = ctx;
+    }
+    async start() {
+        if (!this.ctx)
+            return;
+        await this.runOnce();
+        const interval = this.opts.intervalMs ??
+            Number(process.env.BEEOS_AGENT_SYNC_INTERVAL_MS ?? "0");
+        if (interval > 0) {
+            this.timer = setInterval(() => {
+                if (this.stopped)
+                    return;
+                void this.runOnce();
+            }, interval);
+            this.timer.unref?.();
+        }
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async runOnce() {
+        if (!this.ctx)
+            return;
+        const { config, log } = this.ctx;
+        if (!config.agentGatewayUrl) {
+            log.debug("agent-sync: agentGatewayUrl unset, skipping");
+            return;
+        }
+        const identity = await this.opts.loadIdentity().catch(() => null);
+        if (!identity) {
+            log.debug("agent-sync: identity unavailable, skipping");
+            return;
+        }
+        let agents;
+        try {
+            agents = await this.opts.buildDeclarations();
+        }
+        catch (e) {
+            log.warn({ err: e.message }, "agent-sync: declaration build failed");
+            return;
+        }
+        if (agents.length === 0) {
+            log.debug("agent-sync: no declarations to publish");
+            return;
+        }
+        try {
+            const result = await syncAgents({
+                agentGatewayUrl: config.agentGatewayUrl,
+                identity,
+                agents,
+            });
+            log.info({
+                created: result.created,
+                updated: result.updated,
+                deactivated: result.deactivated,
+                agents: result.agents.map((a) => ({ id: a.id, name: a.name, status: a.status })),
+            }, "agent-sync: agents synced to platform");
+        }
+        catch (e) {
+            const ae = e;
+            log.warn({ err: ae.message, status: ae.status, body: ae.body }, "agent-sync: sync failed (non-fatal)");
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/agent-sync/index.js.map

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

package/dist/plugins/http-debug/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Plugin — http-debug.
+ *
+ * Local Fastify HTTP server that exposes the device-agent's primitives
+ * for `curl` testing and the device-viewer web client. Off by default;
+ * enable with `--http` (CLI) or `httpEnabled = true` (config).
+ *
+ * Tasks submitted via `POST /tasks` are forwarded to `AgentHost.submitTask`,
+ * so they share the same agent core as ACP / future plugins.
+ */
+import type { AgentPlugin, PluginContext } from "../../ports/plugin.js";
+import type { DeviceManager } from "../../app/device-manager.js";
+export interface HttpDebugPluginOptions {
+    devices: DeviceManager;
+    /** Override port from config (e.g. tests using ephemeral ports). */
+    portOverride?: number;
+    /** Override bind host from config. */
+    hostOverride?: string;
+    fastifyLog?: boolean;
+}
+export declare class HttpDebugPlugin implements AgentPlugin {
+    private readonly opts;
+    readonly name = "http-debug";
+    private ctx?;
+    private server?;
+    constructor(opts: HttpDebugPluginOptions);
+    init(ctx: PluginContext): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}

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

@@ -0,0 +1,64 @@
+/**
+ * Plugin — http-debug.
+ *
+ * Local Fastify HTTP server that exposes the device-agent's primitives
+ * for `curl` testing and the device-viewer web client. Off by default;
+ * enable with `--http` (CLI) or `httpEnabled = true` (config).
+ *
+ * Tasks submitted via `POST /tasks` are forwarded to `AgentHost.submitTask`,
+ * so they share the same agent core as ACP / future plugins.
+ */
+import { HttpServer } from "./server.js";
+export class HttpDebugPlugin {
+    opts;
+    name = "http-debug";
+    ctx;
+    server;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    init(ctx) {
+        this.ctx = ctx;
+    }
+    async start() {
+        if (!this.ctx)
+            return;
+        const { config, log, host } = this.ctx;
+        if (!config.httpEnabled) {
+            log.debug("http-debug: httpEnabled=false, skipping");
+            return;
+        }
+        if (config.disableHttp) {
+            log.debug("http-debug: disabled by --no-http");
+            return;
+        }
+        const bindHost = this.opts.hostOverride ?? config.httpHost;
+        const port = this.opts.portOverride ?? config.httpPort;
+        if (bindHost === "0.0.0.0" ||
+            (bindHost && !["127.0.0.1", "localhost", "::1"].includes(bindHost))) {
+            log.warn({ host: bindHost }, "http-debug: bound to non-loopback interface — exposes device control to your LAN; only do this for trusted networks");
+        }
+        this.server = new HttpServer({
+            devices: this.opts.devices,
+            host,
+            bindHost,
+            port,
+            corsOrigins: config.httpCorsOrigins,
+            log: this.opts.fastifyLog ?? false,
+        });
+        await this.server.start();
+        log.info(`http-debug: listening on ${bindHost}:${port}`);
+    }
+    async stop() {
+        if (this.server) {
+            try {
+                await this.server.stop();
+            }
+            catch {
+                /* ignore */
+            }
+            this.server = undefined;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/http-debug/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,MAAM,OAAO,eAAe;IAKG;IAJpB,IAAI,GAAG,YAAY,CAAC;IACrB,GAAG,CAAiB;IACpB,MAAM,CAAc;IAE5B,YAA6B,IAA4B;QAA5B,SAAI,GAAJ,IAAI,CAAwB;IAAG,CAAC;IAE7D,IAAI,CAAC,GAAkB;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO;QACtB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,GAAG,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,CAAC;QACvD,IACE,QAAQ,KAAK,SAAS;YACtB,CAAC,QAAQ,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EACnE,CAAC;YACD,GAAG,CAAC,IAAI,CACN,EAAE,IAAI,EAAE,QAAQ,EAAE,EAClB,qHAAqH,CACtH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YAC1B,IAAI;YACJ,QAAQ;YACR,IAAI;YACJ,WAAW,EAAE,MAAM,CAAC,eAAe;YACnC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK;SACnC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,4BAA4B,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/plugins/http-debug/server.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 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 { type FastifyInstance, type FastifyReply, type FastifyRequest } from "fastify";
+import type { DeviceManager } from "../../app/device-manager.js";
+import type { AgentHost, SubmittedTask } from "../../ports/agent-host.js";
+export interface HttpServerOptions {
+    devices: DeviceManager;
+    host: AgentHost;
+    bindHost?: string;
+    port?: number;
+    log?: boolean;
+    /**
+     * Comma-separated list of allowed CORS origins, or `*` to allow all.
+     * Default: localhost:3000 / 127.0.0.1:3000 only — the HTTP debug API is
+     * intended for local dev and must not be exposed to arbitrary cross-origin
+     * pages by default.
+     */
+    corsOrigins?: string;
+}
+export type HttpTaskStatus = "pending" | "running" | "completed" | "cancelled" | "failed";
+export interface HttpTaskStep {
+    index: number;
+    action: string;
+    parameters: Record<string, unknown>;
+    status: "running" | "completed" | "failed";
+    reasoning: string;
+}
+export interface HttpTaskRecord {
+    id: string;
+    prompt: string;
+    status: HttpTaskStatus;
+    createdAt: number;
+    startedAt: number | null;
+    completedAt: number | null;
+    result: string | null;
+    error: string | null;
+    steps: HttpTaskStep[];
+}
+/**
+ * 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 declare class HttpTaskStore {
+    private readonly tasks;
+    private readonly submitted;
+    private detach;
+    attach(host: AgentHost): void;
+    stop(): void;
+    /**
+     * 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: SubmittedTask, prompt: string): HttpTaskRecord;
+    list(): HttpTaskRecord[];
+    get(id: string): HttpTaskRecord | undefined;
+    cancel(id: string): boolean;
+    pruneCompleted(olderThanMs?: number): number;
+    private onEvent;
+}
+export declare class HttpServer {
+    private readonly opts;
+    private app;
+    readonly tasks: HttpTaskStore;
+    constructor(opts: HttpServerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** For tests: returns the underlying Fastify instance for `inject()` calls. */
+    get instance(): FastifyInstance | null;
+    private registerRoutes;
+}
+/**
+ * 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 declare function buildErrorHandler(err: Error, request: FastifyRequest, reply: FastifyReply): unknown;