@beeos-ai/device-agent 0.4.0

package/dist/fleet/adapters/sources/remote-adb.js

@@ -0,0 +1,138 @@
+/**
+ * Adapter — `IDeviceSource` implementation that exposes a fixed list of
+ * remote ADB endpoints as if they were local devices.
+ *
+ * Use cases:
+ *
+ *   - Local ReDroid containers (e.g. `127.0.0.1:5555`). The Docker /
+ *     k8s pod publishes ADB on a TCP port; running `adb connect host:port`
+ *     once is enough to make `adb track-devices` pick it up, but that
+ *     extra step is fragile (manual connect, atomic-detach when the
+ *     container restarts). With `RemoteAdbSource`, the supervisor treats
+ *     each `(host, port)` as a logical "device with serial" without
+ *     needing real `adb track-devices` to see it.
+ *
+ *   - Edge sites where a remote `adb server -a -P 5037` exposes USB
+ *     devices over TCP. Static config is more deterministic than auto
+ *     discovery.
+ *
+ * Lifecycle:
+ *
+ *   - On `start()`: for every configured endpoint, optionally run `adb
+ *     connect host:port` (best-effort; non-fatal on failure) then emit
+ *     `adb_online` for each known serial. The optional `serial` override
+ *     in the config is what gets emitted; if absent, the canonical
+ *     `host:port` form (which is what `adb` itself would report) is
+ *     used. The serial used here is what flows into `devices.json` for
+ *     binding lookup, so users should keep them stable.
+ *
+ *   - During run: the source is otherwise quiescent. `RemoteAdbSource`
+ *     does NOT itself probe whether the remote ADB is alive — that's
+ *     the spawned `device-mcp-server`'s problem (and the fleet FSM will
+ *     enter `degraded` if the mcp child can't reach the device).
+ *
+ *   - On `stop()`: best-effort `adb disconnect host:port` for each
+ *     endpoint that was connected.
+ */
+import { spawn } from "node:child_process";
+const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+export function resolveEndpoint(ep) {
+    const port = ep.port ?? 5555;
+    const serial = ep.serial && ep.serial.length > 0 ? ep.serial : `${ep.host}:${port}`;
+    return { serial, host: ep.host, port, name: ep.name };
+}
+export class RemoteAdbSource {
+    endpoints;
+    adb;
+    autoConnect;
+    logger;
+    listeners = new Set();
+    online = new Set();
+    started = false;
+    constructor(opts) {
+        this.endpoints = opts.endpoints.map(resolveEndpoint);
+        this.adb = opts.adb ?? process.env.BEEOS_ADB_BIN ?? process.env.ADB_PATH ?? "adb";
+        this.autoConnect = opts.autoConnect ?? true;
+        this.logger = opts.logger ?? noopLogger;
+    }
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        if (this.autoConnect) {
+            await Promise.all(this.endpoints.map((ep) => this.connectOne(ep)));
+        }
+        for (const ep of this.endpoints) {
+            this.online.add(ep.serial);
+            this.emit({ kind: "adb_online", serial: ep.serial });
+        }
+    }
+    async stop() {
+        this.started = false;
+        if (this.autoConnect) {
+            await Promise.all(this.endpoints.map((ep) => this.disconnectOne(ep)));
+        }
+        this.online.clear();
+    }
+    on(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    snapshot() {
+        return [...this.online];
+    }
+    // ── Internals ────────────────────────────────────────────────────────────
+    connectOne(ep) {
+        return runAdb(this.adb, ["connect", `${ep.host}:${ep.port}`]).then((r) => {
+            if (r.code === 0) {
+                this.logger.info("adb connect ok", { endpoint: `${ep.host}:${ep.port}` });
+            }
+            else {
+                this.logger.warn("adb connect failed", {
+                    endpoint: `${ep.host}:${ep.port}`,
+                    code: r.code,
+                    stderr: r.stderr.trim(),
+                });
+            }
+        }, (e) => {
+            this.logger.warn("adb connect threw", {
+                endpoint: `${ep.host}:${ep.port}`,
+                error: String(e),
+            });
+        });
+    }
+    disconnectOne(ep) {
+        return runAdb(this.adb, ["disconnect", `${ep.host}:${ep.port}`]).then(() => undefined, () => undefined);
+    }
+    emit(event) {
+        for (const l of this.listeners) {
+            try {
+                l(event);
+            }
+            catch {
+                /* listener faults must not break the source */
+            }
+        }
+    }
+}
+function runAdb(bin, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (c) => {
+            stdout += c.toString();
+        });
+        child.stderr.on("data", (c) => {
+            stderr += c.toString();
+        });
+        child.on("error", reject);
+        child.on("close", (code) => resolve({ code: code ?? -1, stdout, stderr }));
+    });
+}
+//# sourceMappingURL=remote-adb.js.map

package/dist/fleet/adapters/sources/remote-adb.js.map

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

package/dist/fleet/adapters/state/beeos-cli-store.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Adapter — `IStateRegistry` over `~/.beeos/devices.json`.
+ *
+ * `web/packages/cli` `attach.ts` / `detach.ts` is the sole writer. Fleet only
+ * reads. The schema (`{ devices: DeviceEntry[] }`) is documented in
+ * `web/packages/cli/src/commands/device/state.ts`; the relevant fields for
+ * fleet are: `serial`, `name`, `instance_id`, `key_file`, `http_port`, plus
+ * the optional fleet-specific overrides `grace_ms` and `keep_ms`.
+ *
+ * Watching strategy: `fs.watch` on the file directly is fragile across editors
+ * (atomic-rename creates a new inode and the old watcher dies). We instead
+ * watch the parent directory and filter for the file name; this also catches
+ * the file being created the first time `beeos device attach` runs.
+ */
+import type { DeviceBinding, FleetBackend } from "../../domain/device.js";
+import type { IStateRegistry, BindingEventListener } from "../../ports/state-registry.js";
+interface RawDeviceEntry {
+    serial: string;
+    name: string;
+    instance_id: string | null;
+    key_file: string;
+    http_port: number;
+    /** Video backend selection (`scrcpy`/`vnc`/`none`); written by `web/packages/cli`. */
+    video_mode?: "scrcpy" | "vnc" | "none";
+    /**
+     * `device-mcp-server --backend` selection. Canonical: `adb` | `macos` |
+     * `linux` | `windows` | `desktop` | `mock-desktop`. Aliases (`android`,
+     * `mac`, `win`, `desktop-{linux,windows,macos}`) are also accepted.
+     */
+    backend?: string;
+    /** Fleet-specific overrides (per-device, optional). */
+    grace_ms?: number;
+    keep_ms?: number;
+}
+export interface BeeosCliStoreOptions {
+    /** Path to `devices.json` — defaults to `~/.beeos/devices.json`. */
+    filePath?: string;
+    /** Polling fallback interval (ms); only used when `fs.watch` is unsupported. */
+    pollIntervalMs?: number;
+}
+export declare class BeeosCliStore implements IStateRegistry {
+    private readonly filePath;
+    private readonly pollIntervalMs;
+    private listeners;
+    private bindings;
+    private watcher;
+    private pollHandle;
+    private started;
+    private debounce;
+    constructor(opts?: BeeosCliStoreOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    reload(): Promise<void>;
+    list(): readonly DeviceBinding[];
+    get(serial: string): DeviceBinding | null;
+    on(listener: BindingEventListener): () => void;
+    private beginWatching;
+    /** Coalesce rapid bursts of writes (atomic-rename = create + rename). */
+    private scheduleReload;
+    private applyDiff;
+    private emit;
+}
+export declare function defaultDevicesPath(): string;
+export declare function readBindings(filePath: string): Promise<Map<string, DeviceBinding>>;
+export declare function toBinding(entry: RawDeviceEntry): DeviceBinding;
+/**
+ * Normalize a raw `backend` string to a canonical `FleetBackend`.
+ * Returns `undefined` for missing / unknown values so the fleet
+ * supervisor can fall back to its default (`adb`).
+ */
+export declare function normalizeBackend(value: unknown): FleetBackend | undefined;
+export {};

package/dist/fleet/adapters/state/beeos-cli-store.js

@@ -0,0 +1,250 @@
+/**
+ * Adapter — `IStateRegistry` over `~/.beeos/devices.json`.
+ *
+ * `web/packages/cli` `attach.ts` / `detach.ts` is the sole writer. Fleet only
+ * reads. The schema (`{ devices: DeviceEntry[] }`) is documented in
+ * `web/packages/cli/src/commands/device/state.ts`; the relevant fields for
+ * fleet are: `serial`, `name`, `instance_id`, `key_file`, `http_port`, plus
+ * the optional fleet-specific overrides `grace_ms` and `keep_ms`.
+ *
+ * Watching strategy: `fs.watch` on the file directly is fragile across editors
+ * (atomic-rename creates a new inode and the old watcher dies). We instead
+ * watch the parent directory and filter for the file name; this also catches
+ * the file being created the first time `beeos device attach` runs.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+export class BeeosCliStore {
+    filePath;
+    pollIntervalMs;
+    listeners = new Set();
+    bindings = new Map();
+    watcher = null;
+    pollHandle = null;
+    started = false;
+    debounce = null;
+    constructor(opts = {}) {
+        this.filePath = opts.filePath ?? defaultDevicesPath();
+        this.pollIntervalMs = opts.pollIntervalMs ?? 1_500;
+    }
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        await this.reload();
+        this.beginWatching();
+    }
+    async stop() {
+        this.started = false;
+        if (this.watcher) {
+            try {
+                this.watcher.close();
+            }
+            catch {
+                /* ignore */
+            }
+            this.watcher = null;
+        }
+        if (this.pollHandle) {
+            clearInterval(this.pollHandle);
+            this.pollHandle = null;
+        }
+        if (this.debounce) {
+            clearTimeout(this.debounce);
+            this.debounce = null;
+        }
+    }
+    async reload() {
+        const next = await readBindings(this.filePath);
+        this.applyDiff(next);
+    }
+    list() {
+        return Array.from(this.bindings.values());
+    }
+    get(serial) {
+        return this.bindings.get(serial) ?? null;
+    }
+    on(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    // ── Internals ────────────────────────────────────────────────────────────
+    beginWatching() {
+        const dir = path.dirname(this.filePath);
+        const name = path.basename(this.filePath);
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        catch {
+            /* ignore — likely permission, falls back to polling */
+        }
+        try {
+            this.watcher = fs.watch(dir, (_event, changed) => {
+                if (!changed)
+                    return;
+                if (changed.toString() !== name)
+                    return;
+                this.scheduleReload();
+            });
+        }
+        catch {
+            // fs.watch may be unsupported (e.g. some FUSE / NFS); fall back to
+            // a low-frequency poll. We compare mtime to avoid re-parsing on every
+            // tick when nothing changed.
+            let lastMtimeMs = 0;
+            this.pollHandle = setInterval(() => {
+                fs.stat(this.filePath, (err, st) => {
+                    if (err)
+                        return;
+                    if (st.mtimeMs === lastMtimeMs)
+                        return;
+                    lastMtimeMs = st.mtimeMs;
+                    this.scheduleReload();
+                });
+            }, this.pollIntervalMs);
+            if (typeof this.pollHandle === "object" && this.pollHandle?.unref) {
+                this.pollHandle.unref();
+            }
+        }
+    }
+    /** Coalesce rapid bursts of writes (atomic-rename = create + rename). */
+    scheduleReload() {
+        if (this.debounce)
+            return;
+        this.debounce = setTimeout(() => {
+            this.debounce = null;
+            void this.reload().catch(() => {
+                /* swallowed: next event will retry */
+            });
+        }, 80);
+        if (typeof this.debounce === "object" && this.debounce?.unref) {
+            this.debounce.unref();
+        }
+    }
+    applyDiff(next) {
+        const prev = this.bindings;
+        this.bindings = next;
+        if (this.listeners.size === 0)
+            return;
+        for (const [serial, b] of next) {
+            const old = prev.get(serial);
+            if (!old) {
+                this.emit({ kind: "binding_added", serial });
+            }
+            else if (!shallowEqual(old, b)) {
+                this.emit({ kind: "binding_changed", serial });
+            }
+        }
+        for (const serial of prev.keys()) {
+            if (!next.has(serial)) {
+                this.emit({ kind: "binding_removed", serial });
+            }
+        }
+    }
+    emit(event) {
+        for (const l of this.listeners) {
+            try {
+                l(event);
+            }
+            catch {
+                /* listener faults must not break the store */
+            }
+        }
+    }
+}
+// ── Pure helpers (exported for tests) ────────────────────────────────────────
+export function defaultDevicesPath() {
+    const override = process.env.BEEOS_HOME;
+    const base = override && override.length > 0
+        ? override
+        : path.join(os.homedir(), ".beeos");
+    return path.join(base, "devices.json");
+}
+export async function readBindings(filePath) {
+    const out = new Map();
+    let raw;
+    try {
+        raw = await fs.promises.readFile(filePath, "utf8");
+    }
+    catch {
+        return out;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return out;
+    }
+    if (!parsed || !Array.isArray(parsed.devices))
+        return out;
+    for (const entry of parsed.devices) {
+        if (!entry || typeof entry.serial !== "string" || entry.serial.length === 0)
+            continue;
+        out.set(entry.serial, toBinding(entry));
+    }
+    return out;
+}
+export function toBinding(entry) {
+    return {
+        serial: entry.serial,
+        name: entry.name ?? entry.serial,
+        instanceId: typeof entry.instance_id === "string" && entry.instance_id.length > 0
+            ? entry.instance_id
+            : null,
+        keyFile: entry.key_file ?? "",
+        httpPort: typeof entry.http_port === "number" ? entry.http_port : undefined,
+        videoMode: entry.video_mode === "scrcpy" ||
+            entry.video_mode === "vnc" ||
+            entry.video_mode === "none"
+            ? entry.video_mode
+            : undefined,
+        backend: normalizeBackend(entry.backend),
+        graceMs: typeof entry.grace_ms === "number" ? entry.grace_ms : undefined,
+        keepMs: typeof entry.keep_ms === "number" ? entry.keep_ms : undefined,
+    };
+}
+/**
+ * Normalize a raw `backend` string to a canonical `FleetBackend`.
+ * Returns `undefined` for missing / unknown values so the fleet
+ * supervisor can fall back to its default (`adb`).
+ */
+export function normalizeBackend(value) {
+    if (typeof value !== "string")
+        return undefined;
+    switch (value) {
+        case "adb":
+        case "android":
+            return "adb";
+        case "macos":
+        case "mac":
+        case "desktop-macos":
+            return "macos";
+        case "linux":
+        case "desktop-linux":
+            return "linux";
+        case "windows":
+        case "win":
+        case "desktop-windows":
+            return "windows";
+        case "desktop":
+            return "desktop";
+        case "mock-desktop":
+            return "mock-desktop";
+        default:
+            return undefined;
+    }
+}
+function shallowEqual(a, b) {
+    return (a.serial === b.serial &&
+        a.name === b.name &&
+        a.instanceId === b.instanceId &&
+        a.keyFile === b.keyFile &&
+        a.httpPort === b.httpPort &&
+        a.videoMode === b.videoMode &&
+        a.backend === b.backend &&
+        a.graceMs === b.graceMs &&
+        a.keepMs === b.keepMs);
+}
+//# sourceMappingURL=beeos-cli-store.js.map

package/dist/fleet/adapters/state/beeos-cli-store.js.map

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

package/dist/fleet/adapters/state/port-allocator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Adapter — sticky port allocator backed by `~/.beeos/fleet.json`.
+ *
+ * Sticky semantics: once a serial is mapped to a port, that mapping is kept
+ * indefinitely so users can bookmark / paste the URL. The allocator only
+ * forgets a mapping if the persisted port collides with another listener at
+ * acquire time — then we probe the next free port within the configured
+ * range.
+ *
+ * Range: configurable, defaults to `[7900, 7999]` (matches the historical
+ * device-mcp-server default of 7900). 100 slots × per-laptop scale is plenty
+ * even for power users running 30 devices.
+ */
+import type { IPortAllocator } from "../../ports/state-registry.js";
+export interface PortAllocatorOptions {
+    filePath?: string;
+    basePort?: number;
+    rangeSize?: number;
+    /** Probe-port helper override (tests). */
+    probe?: (port: number) => Promise<boolean>;
+}
+export declare class StickyPortAllocator implements IPortAllocator {
+    private readonly filePath;
+    private readonly basePort;
+    private readonly rangeSize;
+    private readonly probe;
+    private map;
+    private writeQueue;
+    private started;
+    constructor(opts?: PortAllocatorOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    acquire(serial: string): Promise<number>;
+    release(serial: string): Promise<void>;
+    /** Test/maintenance helper: drop the persisted mapping for a serial. */
+    forget(serial: string): void;
+    snapshot(): ReadonlyMap<string, number>;
+    private hintFor;
+    private findAvailable;
+    private load;
+    private flush;
+}
+export declare function defaultFleetStatePath(): string;