@beeos-ai/device-agent 0.4.0

package/dist/fleet/http/status-server.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Fleet status server — local HTTP endpoint exposing supervisor state and a
+ * minimal control plane for the `device-agent fleet …` CLI subcommands.
+ *
+ * Bind: `127.0.0.1:7950` by default (env `FLEET_STATUS_PORT`). Loopback-only
+ * by design — there is NO authentication. Anyone on the host who can reach
+ * loopback is already trusted (they could read `~/.beeos/keys/`).
+ *
+ * Routes:
+ *
+ *   GET  /healthz                            — liveness probe (200 "ok\n")
+ *   GET  /fleet/devices                      — array of `DeviceSnapshot`
+ *   GET  /fleet/devices/:serial              — single device snapshot or 404
+ *   POST /fleet/devices/:serial/restart      — kick device's mcp + daemon
+ *   POST /fleet/reload                       — re-read `~/.beeos/devices.json`
+ *   POST /fleet/shutdown                     — graceful exit (`fleet stop`)
+ *
+ * `shutdown` is opt-in — the caller must wire an `onShutdown` callback that
+ * tears down the supervisor + status server in the right order. Without
+ * that callback the route returns 501 so we don't accidentally mask a
+ * misconfigured stack with a confusing 200.
+ *
+ * The dispatcher uses Node's stdlib `http` module to keep the dependency
+ * footprint minimal — fastify pulls in a heavy plugin chain we don't need
+ * for five trivial endpoints.
+ */
+import type { FleetSupervisor, SupervisorLogger } from "../supervisor.js";
+export interface StatusServerOptions {
+    supervisor: FleetSupervisor;
+    host?: string;
+    port?: number;
+    logger?: SupervisorLogger;
+    /**
+     * Optional graceful-shutdown hook for `POST /fleet/shutdown`.
+     *
+     * The caller is responsible for tearing down the supervisor + status
+     * server (and exiting the process if appropriate). We schedule it as
+     * a microtask so the HTTP response goes out before we close the
+     * listener — a synchronous call would leave the client hanging.
+     */
+    onShutdown?: () => Promise<void> | void;
+}
+export declare class StatusServer {
+    private readonly supervisor;
+    private readonly host;
+    private port;
+    private readonly logger;
+    private readonly onShutdown?;
+    private server;
+    constructor(opts: StatusServerOptions);
+    /**
+     * Public address (only meaningful after `start()`). When `port: 0` was
+     * passed (tests), this reflects the OS-assigned ephemeral port — not the
+     * 0 that was supplied at construction time.
+     */
+    get address(): {
+        host: string;
+        port: number;
+    };
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handle;
+    private json;
+}

package/dist/fleet/http/status-server.js

@@ -0,0 +1,200 @@
+/**
+ * Fleet status server — local HTTP endpoint exposing supervisor state and a
+ * minimal control plane for the `device-agent fleet …` CLI subcommands.
+ *
+ * Bind: `127.0.0.1:7950` by default (env `FLEET_STATUS_PORT`). Loopback-only
+ * by design — there is NO authentication. Anyone on the host who can reach
+ * loopback is already trusted (they could read `~/.beeos/keys/`).
+ *
+ * Routes:
+ *
+ *   GET  /healthz                            — liveness probe (200 "ok\n")
+ *   GET  /fleet/devices                      — array of `DeviceSnapshot`
+ *   GET  /fleet/devices/:serial              — single device snapshot or 404
+ *   POST /fleet/devices/:serial/restart      — kick device's mcp + daemon
+ *   POST /fleet/reload                       — re-read `~/.beeos/devices.json`
+ *   POST /fleet/shutdown                     — graceful exit (`fleet stop`)
+ *
+ * `shutdown` is opt-in — the caller must wire an `onShutdown` callback that
+ * tears down the supervisor + status server in the right order. Without
+ * that callback the route returns 501 so we don't accidentally mask a
+ * misconfigured stack with a confusing 200.
+ *
+ * The dispatcher uses Node's stdlib `http` module to keep the dependency
+ * footprint minimal — fastify pulls in a heavy plugin chain we don't need
+ * for five trivial endpoints.
+ */
+import * as http from "node:http";
+import { Buffer } from "node:buffer";
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_PORT = 7950;
+const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+export class StatusServer {
+    supervisor;
+    host;
+    // Mutable so we can reflect the OS-assigned port back when callers pass
+    // `port: 0` (tests typically do).
+    port;
+    logger;
+    onShutdown;
+    server = null;
+    constructor(opts) {
+        this.supervisor = opts.supervisor;
+        this.host = opts.host ?? DEFAULT_HOST;
+        this.port = opts.port ?? Number(process.env.FLEET_STATUS_PORT ?? DEFAULT_PORT);
+        this.logger = opts.logger ?? noopLogger;
+        this.onShutdown = opts.onShutdown;
+    }
+    /**
+     * Public address (only meaningful after `start()`). When `port: 0` was
+     * passed (tests), this reflects the OS-assigned ephemeral port — not the
+     * 0 that was supplied at construction time.
+     */
+    get address() {
+        return { host: this.host, port: this.port };
+    }
+    async start() {
+        if (this.server)
+            return;
+        this.server = http.createServer((req, res) => {
+            this.handle(req, res).catch((e) => {
+                this.logger.error("status-server handler threw", { error: String(e) });
+                if (!res.headersSent) {
+                    res.statusCode = 500;
+                    res.setHeader("content-type", "application/json");
+                    res.end(JSON.stringify({ error: "internal" }));
+                }
+            });
+        });
+        await new Promise((resolve, reject) => {
+            this.server.once("error", reject);
+            this.server.listen(this.port, this.host, () => {
+                this.server.off("error", reject);
+                // Reflect the OS-assigned port back into `this.port` so callers
+                // reading `server.address` after `start()` see the real bound
+                // port — important for tests using `port: 0`.
+                const addr = this.server.address();
+                if (addr && typeof addr === "object") {
+                    this.port = addr.port;
+                }
+                resolve();
+            });
+        });
+        this.logger.info("fleet status-server listening", {
+            host: this.host,
+            port: this.port,
+        });
+    }
+    async stop() {
+        const server = this.server;
+        if (!server)
+            return;
+        this.server = null;
+        await new Promise((resolve) => {
+            server.close(() => resolve());
+        });
+    }
+    // ── Dispatcher ──────────────────────────────────────────────────────────
+    async handle(req, res) {
+        const url = req.url ?? "/";
+        const [pathOnly] = url.split("?");
+        const method = (req.method ?? "GET").toUpperCase();
+        // Healthz first — used by service managers, must be cheap.
+        if (pathOnly === "/healthz" && method === "GET") {
+            res.statusCode = 200;
+            res.setHeader("content-type", "text/plain");
+            res.end("ok\n");
+            return;
+        }
+        if (pathOnly === "/fleet/devices" && method === "GET") {
+            this.json(res, 200, this.supervisor.snapshot());
+            return;
+        }
+        if (pathOnly === "/fleet/reload" && method === "POST") {
+            await drain(req);
+            try {
+                await this.supervisor.reload();
+                this.json(res, 202, { ok: true });
+            }
+            catch (e) {
+                this.json(res, 500, { ok: false, error: String(e) });
+            }
+            return;
+        }
+        if (pathOnly === "/fleet/shutdown" && method === "POST") {
+            await drain(req);
+            if (!this.onShutdown) {
+                this.json(res, 501, {
+                    ok: false,
+                    error: "shutdown hook not configured",
+                });
+                return;
+            }
+            // Reply first, then run the shutdown hook on the next tick so the
+            // socket flushes before we close the listener. Errors inside the
+            // hook are logged but not surfaced to the caller — the response
+            // has already been sent and the process is on its way out.
+            this.json(res, 202, { ok: true });
+            const hook = this.onShutdown;
+            setImmediate(() => {
+                Promise.resolve()
+                    .then(() => hook())
+                    .catch((e) => {
+                    this.logger.error("fleet shutdown hook failed", {
+                        error: String(e),
+                    });
+                });
+            });
+            return;
+        }
+        // /fleet/devices/<serial> [/restart]
+        const m = pathOnly.match(/^\/fleet\/devices\/([^/]+)(\/restart)?$/);
+        if (m) {
+            const serial = decodeURIComponent(m[1]);
+            const isRestart = Boolean(m[2]);
+            if (isRestart && method === "POST") {
+                await drain(req);
+                const ok = await this.supervisor.restartDevice(serial);
+                if (!ok) {
+                    this.json(res, 404, { error: "unknown serial", serial });
+                }
+                else {
+                    this.json(res, 202, { ok: true, serial });
+                }
+                return;
+            }
+            if (!isRestart && method === "GET") {
+                const found = this.supervisor.snapshot().find((d) => d.serial === serial);
+                if (!found) {
+                    this.json(res, 404, { error: "unknown serial", serial });
+                }
+                else {
+                    this.json(res, 200, found);
+                }
+                return;
+            }
+        }
+        res.statusCode = 404;
+        res.setHeader("content-type", "application/json");
+        res.end(JSON.stringify({ error: "not found", path: pathOnly, method }));
+    }
+    json(res, status, body) {
+        res.statusCode = status;
+        res.setHeader("content-type", "application/json");
+        res.end(JSON.stringify(body));
+    }
+}
+async function drain(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", reject);
+    });
+}
+//# sourceMappingURL=status-server.js.map

package/dist/fleet/http/status-server.js.map

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

package/dist/fleet/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Public surface of the `device-agent fleet` module.
+ *
+ * Fleet is opt-in: import nothing here unless you actually want the
+ * multi-device supervisor. The CLI (`device-agent fleet …` subcommands) lives
+ * in `inbound/cli/fleet-command.ts` and is the canonical consumer.
+ */
+export type { DeviceBinding, DeviceRecord, DeviceSnapshot, FleetState, } from "./domain/device.js";
+export { newDeviceRecord, stateExpectsDaemon, stateExpectsMcp, } from "./domain/device.js";
+export type { AdbEvent, BindingEvent, FleetEvent, ProcessEvent, TimerEvent, } from "./domain/events.js";
+export type { FleetEffect, StepContext, StepResult, } from "./domain/fsm.js";
+export { backoffMs, markHealthy, step } from "./domain/fsm.js";
+export type { IDeviceSource } from "./ports/device-source.js";
+export type { IProcessManager, SpawnOptions } from "./ports/process-manager.js";
+export type { IPortAllocator, IStateRegistry } from "./ports/state-registry.js";
+export type { CancelFn, IClock } from "./ports/clock.js";
+export { SystemClock } from "./ports/clock.js";
+export { BeeosCliStore, defaultDevicesPath, readBindings, } from "./adapters/state/beeos-cli-store.js";
+export { StickyPortAllocator, defaultFleetStatePath, } from "./adapters/state/port-allocator.js";
+export { LocalAdbSource, diffSnapshots, parseSnapshotBody, parseTrackDevicesLine, tryParseFrames, } from "./adapters/sources/local-adb.js";
+export type { LocalAdbSourceOptions, AdbLogger } from "./adapters/sources/local-adb.js";
+export { NodeProcessManager } from "./adapters/process/node-process-manager.js";
+export type { HttpProbeFn, ManagedChild, NodeProcessManagerOptions, ProcessManagerLogger, SpawnFn, } from "./adapters/process/node-process-manager.js";
+export { FleetSupervisor } from "./supervisor.js";
+export type { FleetSupervisorOptions, SupervisorLogger, } from "./supervisor.js";
+export { buildFleetServiceSpec, FLEET_LABEL, fleetPlistPath, installFleetLaunchd, LEGACY_DEVICE_AGENT_PREFIX, LEGACY_SCRCPY_BRIDGE_PREFIX, migrateFromAttach, renderFleetPlist, uninstallFleetLaunchd, } from "./installer/index.js";
+export type { BuildFleetSpecInput, FleetRestartPolicy, FleetServiceLabel, FleetServiceSpec, InstallResult, MigrateResult, UninstallResult, } from "./installer/index.js";

package/dist/fleet/index.js

@@ -0,0 +1,17 @@
+/**
+ * Public surface of the `device-agent fleet` module.
+ *
+ * Fleet is opt-in: import nothing here unless you actually want the
+ * multi-device supervisor. The CLI (`device-agent fleet …` subcommands) lives
+ * in `inbound/cli/fleet-command.ts` and is the canonical consumer.
+ */
+export { newDeviceRecord, stateExpectsDaemon, stateExpectsMcp, } from "./domain/device.js";
+export { backoffMs, markHealthy, step } from "./domain/fsm.js";
+export { SystemClock } from "./ports/clock.js";
+export { BeeosCliStore, defaultDevicesPath, readBindings, } from "./adapters/state/beeos-cli-store.js";
+export { StickyPortAllocator, defaultFleetStatePath, } from "./adapters/state/port-allocator.js";
+export { LocalAdbSource, diffSnapshots, parseSnapshotBody, parseTrackDevicesLine, tryParseFrames, } from "./adapters/sources/local-adb.js";
+export { NodeProcessManager } from "./adapters/process/node-process-manager.js";
+export { FleetSupervisor } from "./supervisor.js";
+export { buildFleetServiceSpec, FLEET_LABEL, fleetPlistPath, installFleetLaunchd, LEGACY_DEVICE_AGENT_PREFIX, LEGACY_SCRCPY_BRIDGE_PREFIX, migrateFromAttach, renderFleetPlist, uninstallFleetLaunchd, } from "./installer/index.js";
+//# sourceMappingURL=index.js.map

package/dist/fleet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fleet/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAe5B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAM/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,YAAY,GACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,GACf,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAShF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMlD,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/fleet/installer/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fleet OS-service installer — public surface.
+ *
+ * Currently macOS-only (launchd). Linux (`systemd --user`) and Windows
+ * (Task Scheduler) are deliberately deferred to a follow-up milestone;
+ * `installFleet` throws an actionable error on those platforms so users
+ * see "fleet enable not yet supported on linux" rather than a silently
+ * broken install.
+ */
+export { buildFleetServiceSpec, FLEET_LABEL, type BuildFleetSpecInput, type FleetRestartPolicy, type FleetServiceLabel, type FleetServiceSpec, } from "./service-spec.js";
+export { installFleetLaunchd, uninstallFleetLaunchd, migrateFromAttach, renderFleetPlist, fleetPlistPath, LEGACY_DEVICE_AGENT_PREFIX, LEGACY_SCRCPY_BRIDGE_PREFIX, type InstallResult, type UninstallResult, type MigrateResult, } from "./launchd-mac.js";
+export { deriveFleetSpawnEnv, parseConfigToml, defaultReadConfigToml, type ConfigToml, type DeriveSpawnEnvOptions, } from "./spawn-env.js";

package/dist/fleet/installer/index.js

@@ -0,0 +1,13 @@
+/**
+ * Fleet OS-service installer — public surface.
+ *
+ * Currently macOS-only (launchd). Linux (`systemd --user`) and Windows
+ * (Task Scheduler) are deliberately deferred to a follow-up milestone;
+ * `installFleet` throws an actionable error on those platforms so users
+ * see "fleet enable not yet supported on linux" rather than a silently
+ * broken install.
+ */
+export { buildFleetServiceSpec, FLEET_LABEL, } from "./service-spec.js";
+export { installFleetLaunchd, uninstallFleetLaunchd, migrateFromAttach, renderFleetPlist, fleetPlistPath, LEGACY_DEVICE_AGENT_PREFIX, LEGACY_SCRCPY_BRIDGE_PREFIX, } from "./launchd-mac.js";
+export { deriveFleetSpawnEnv, parseConfigToml, defaultReadConfigToml, } from "./spawn-env.js";
+//# sourceMappingURL=index.js.map

package/dist/fleet/installer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fleet/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,qBAAqB,EACrB,WAAW,GAKZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,2BAA2B,GAI5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GAGtB,MAAM,gBAAgB,CAAC"}

package/dist/fleet/installer/launchd-mac.d.ts

@@ -0,0 +1,73 @@
+/**
+ * macOS-only launchd integration for `device-agent fleet enable / disable`.
+ *
+ * The fleet package intentionally does NOT depend on `@beeos/core` — that
+ * would pull the entire web monorepo into the runtime. Instead, this file
+ * mirrors the renderer + bootstrap sequence in `web/packages/core/src/services/launchd.ts`
+ * for the single label `ai.beeos.device-fleet` plus the migration sweep over
+ * legacy per-device labels.
+ *
+ * Restart policy: the rendered plist always sets `KeepAlive: true` —
+ * if the fleet process exits, every connected device goes silent, so
+ * we want unconditional restarts capped by `ThrottleInterval` (10s).
+ *
+ * Bootstrap sequence: same pattern as `web/packages/core` — `bootout`
+ * any prior copy, then `bootstrap gui/<uid>` and `kickstart -k`. We
+ * fall back to legacy `launchctl load -w` on macOS versions that
+ * lack `bootstrap`.
+ *
+ * `migrate-from-attach` removes EVERY plist that matches one of the
+ * legacy per-device prefixes (`ai.beeos.device-agent-` /
+ * `ai.beeos.scrcpy-bridge-`). Those were how `beeos device attach`
+ * used to register supervision before the fleet existed; once the
+ * user opts into fleet mode they MUST be removed or we'd double-spawn
+ * device-agent for every adb device.
+ */
+import type { FleetServiceSpec } from "./service-spec.js";
+/** Legacy per-device labels written by `beeos device attach` v0.3.x. */
+export declare const LEGACY_DEVICE_AGENT_PREFIX = "ai.beeos.device-agent-";
+export declare const LEGACY_SCRCPY_BRIDGE_PREFIX = "ai.beeos.scrcpy-bridge-";
+export interface InstallResult {
+    plistPath: string;
+    bootstrapped: boolean;
+    warnings: string[];
+}
+export interface UninstallResult {
+    removed: boolean;
+    plistPath: string;
+    warnings: string[];
+}
+export interface MigrateResult {
+    removedDeviceAgents: string[];
+    removedScrcpyBridges: string[];
+    warnings: string[];
+}
+/**
+ * Render the plist file for a `FleetServiceSpec` and bootstrap it into
+ * the user's GUI session. Idempotent — calling twice in a row leaves
+ * the same loaded service running with the latest plist.
+ */
+export declare function installFleetLaunchd(spec: FleetServiceSpec): Promise<InstallResult>;
+/**
+ * Stop and remove the `ai.beeos.device-fleet` plist. Returns
+ * `removed: false` when nothing was installed (idempotent).
+ */
+export declare function uninstallFleetLaunchd(label: string): Promise<UninstallResult>;
+/**
+ * Sweep `~/Library/LaunchAgents/` for legacy per-device plists left
+ * behind by older `beeos device attach`, unload them via launchctl,
+ * and delete the files. The fleet supersedes them all.
+ *
+ * No-op when the directory doesn't exist (fresh install) or no
+ * matching files are found.
+ */
+export declare function migrateFromAttach(): Promise<MigrateResult>;
+/**
+ * Render a launchd plist for a `FleetServiceSpec`.
+ *
+ * Exported for unit tests — the full byte-for-byte XML is the contract
+ * we ship to launchd, so any change MUST surface as a test diff.
+ */
+export declare function renderFleetPlist(spec: FleetServiceSpec): string;
+/** Path that `installFleetLaunchd` writes to. Exported for tests / `fleet logs`. */
+export declare function fleetPlistPath(label: string): string;