@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/esp32-serial.d.ts

@@ -0,0 +1,112 @@
+/**
+ * ESP32 Serial Bridge — bidirectional USB serial communication.
+ *
+ * Detects ESP32 devices (CH340/CP210x) on USB serial ports,
+ * opens the port for read+write, and sends newline-delimited JSON
+ * matching the same protocol as WebSocket.
+ *
+ * Read path: parses newline-delimited JSON from ESP32 (device_info,
+ * wifi_provision_ack, wifi_status). Non-JSON debug lines are ignored.
+ *
+ * ESP32 side reads lines starting with '{' and passes to Protocol::parseMessage().
+ */
+import { type WriteStream, type ReadStream } from 'fs';
+import type { BridgeEvent } from './types.js';
+import type { ESP32ToHostMessage, WifiProvisionMessage } from '@agentdeck/shared/protocol';
+/** @internal Exported for testing only */
+export declare const ESP32_PORT_PATTERNS: RegExp[];
+/** @internal Exported for testing only */
+export declare const EXCLUDE_PATTERNS: RegExp[];
+/** @internal Exported for testing only */
+export interface SerialConnection {
+    port: string;
+    stream: WriteStream;
+    reader: ReadStream | null;
+    readBuf: string;
+    connected: boolean;
+    deviceInfo: {
+        board?: string;
+        version?: string;
+        wifiConfigured?: boolean;
+        wifiConnected?: boolean;
+    } | null;
+    provisionSent: boolean;
+}
+/**
+ * Prepare a BridgeEvent for serial transmission.
+ * - Pre-format ISO reset times (ESP32 has no NTP)
+ * - Strip fields the ESP32 firmware doesn't parse (reduce size for small RX buffers)
+ */
+/** @internal Exported for testing only */
+export declare function prepareForSerial(event: BridgeEvent): BridgeEvent;
+/** @internal Exported for testing only */
+export declare function handleSerialLine(conn: SerialConnection, line: string): void;
+/**
+ * Register a callback that returns the current state_update event.
+ * Used to send periodic heartbeats so ESP32 gets data even without
+ * state changes (e.g., after reboot while bridge is idle).
+ */
+export declare function setESP32StateProvider(provider: () => BridgeEvent | null): void;
+/**
+ * Register a callback that returns the current usage_update event.
+ * Heartbeat sends both state + usage every cycle so ESP32 stays in sync.
+ */
+export declare function setESP32UsageProvider(provider: () => BridgeEvent | null): void;
+/**
+ * Register a provider that returns all initial state events (state + usage + sessions).
+ * Called when a new ESP32 device connects to send full state immediately.
+ */
+export declare function setESP32InitialStateProvider(provider: () => BridgeEvent[]): void;
+/**
+ * Register a handler for messages received from ESP32 devices.
+ * Called with (portPath, parsedMessage) for each JSON message.
+ */
+export declare function onESP32Message(handler: (port: string, msg: ESP32ToHostMessage) => void): void;
+/**
+ * Start ESP32 serial bridge.
+ * Detects USB serial ports and opens connections.
+ * Call broadcast() to send events to all connected ESP32 devices.
+ *
+ * Non-blocking: initial device detection runs in background so a hung
+ * USB port (stty stuck in kernel I/O) cannot block bridge startup.
+ */
+export declare function startESP32Serial(): void;
+/**
+ * Broadcast a BridgeEvent to all connected ESP32 devices via serial.
+ */
+export declare function broadcastESP32(event: BridgeEvent): void;
+/**
+ * Send a WiFi provision message to a specific ESP32 device by port path.
+ */
+export declare function sendWifiProvision(port: string, msg: WifiProvisionMessage): boolean;
+/**
+ * Send WiFi provision to all connected ESP32 devices that haven't been provisioned.
+ */
+export declare function sendWifiProvisionToAll(msg: WifiProvisionMessage): number;
+/**
+ * Get device info for all connected ESP32 devices.
+ */
+export declare function getESP32DeviceInfo(): Array<{
+    port: string;
+    board?: string;
+    version?: string;
+    wifiConfigured?: boolean;
+    wifiConnected?: boolean;
+}>;
+/**
+ * Wake recovery — close stale file descriptors, force immediate re-poll.
+ */
+export declare function handleESP32Wake(): void;
+/**
+ * Stop ESP32 serial bridge and close all connections.
+ */
+export declare function stopESP32Serial(): void;
+/**
+ * Get number of connected ESP32 devices.
+ */
+export declare function esp32ConnectionCount(): number;
+/**
+ * Get list of connected ESP32 serial port paths.
+ */
+export declare function getESP32Ports(): string[];
+//# sourceMappingURL=esp32-serial.d.ts.map

package/dist/esp32-serial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esp32-serial.d.ts","sourceRoot":"","sources":["../src/esp32-serial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAuC,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,IAAI,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAI3F,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB,UAM/B,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,UAG5B,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3G,aAAa,EAAE,OAAO,CAAC;CACxB;AAgBD;;;;GAIG;AACH,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAuBhE;AA8CD,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAyB3E;AA4HD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,WAAW,EAAE,GAAG,IAAI,CAEhF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAE7F;AAgCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAiBvC;AA0BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAsBvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAOlF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAaxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAOjJ;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CActC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAiBtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/esp32-serial.js

@@ -0,0 +1,502 @@
+/**
+ * ESP32 Serial Bridge — bidirectional USB serial communication.
+ *
+ * Detects ESP32 devices (CH340/CP210x) on USB serial ports,
+ * opens the port for read+write, and sends newline-delimited JSON
+ * matching the same protocol as WebSocket.
+ *
+ * Read path: parses newline-delimited JSON from ESP32 (device_info,
+ * wifi_provision_ack, wifi_status). Non-JSON debug lines are ignored.
+ *
+ * ESP32 side reads lines starting with '{' and passes to Protocol::parseMessage().
+ */
+import { exec } from 'child_process';
+import { createWriteStream, createReadStream } from 'fs';
+import { SERIAL_FORWARDED_EVENTS } from '@agentdeck/shared/protocol';
+import { formatResetTime } from '@agentdeck/shared';
+import { debug } from './logger.js';
+/** @internal Exported for testing only */
+export const ESP32_PORT_PATTERNS = [
+    /\/dev\/cu\.usbserial-\d+/, // CP210x / CH340 (cu.usbserial-XXXX)
+    /\/dev\/cu\.wchusbserial\d+/, // CH340 (cu.wchusbserialXXXX — 86 Box)
+    /\/dev\/cu\.usbmodem\d+/, // Native USB JTAG (IPS 3.5", Round AMOLED)
+    /\/dev\/ttyUSB\d+/, // Linux CH340
+    /\/dev\/ttyACM\d+/, // Linux native USB
+];
+/** @internal Exported for testing only */
+export const EXCLUDE_PATTERNS = [
+    /Bluetooth/i,
+    /WLAN/i,
+];
+let connections = [];
+let pollTimer = null;
+let heartbeatTimer = null;
+let stateProvider = null;
+let usageProvider = null;
+let initialStateProvider = null;
+let messageHandler = null;
+// Events to forward — shared constant from @agentdeck/shared
+const FORWARDED_EVENTS = SERIAL_FORWARDED_EVENTS;
+// ESP32 without WiFi/NTP can't parse ISO dates — shared formatResetTime
+// handles undefined and pre-formatted strings.
+/**
+ * Prepare a BridgeEvent for serial transmission.
+ * - Pre-format ISO reset times (ESP32 has no NTP)
+ * - Strip fields the ESP32 firmware doesn't parse (reduce size for small RX buffers)
+ */
+/** @internal Exported for testing only */
+export function prepareForSerial(event) {
+    const e = event;
+    if (event.type === 'usage_update') {
+        // Pre-format ISO dates + strip unused fields
+        const { ollamaStatus, tokenStatus, extraUsageEnabled, extraUsageMonthlyLimit, extraUsageUsedCredits, extraUsageUtilization, costSpent, costLimit, sessionPercent, resetTime, resetDate, ...keep } = e;
+        return {
+            ...keep,
+            fiveHourResetsAt: formatResetTime(keep.fiveHourResetsAt),
+            sevenDayResetsAt: formatResetTime(keep.sevenDayResetsAt),
+        };
+    }
+    if (event.type === 'state_update') {
+        // Strip agentCapabilities + other fields ESP32 doesn't parse
+        const { agentCapabilities, billingType, remoteUrl, diff, context, selectedOptionIndex, ...keep } = e;
+        return keep;
+    }
+    return event;
+}
+/** Run a shell command with timeout, escalating to SIGKILL if SIGTERM fails. */
+function execWithKill(cmd, timeoutMs = 3000) {
+    return new Promise((resolve, reject) => {
+        const child = exec(cmd, { encoding: 'utf-8', timeout: timeoutMs }, (err, stdout) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+        // When exec timeout fires, it sends SIGTERM. But stty stuck in kernel I/O
+        // ignores SIGTERM. Schedule a SIGKILL as escalation.
+        const killTimer = setTimeout(() => {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch { /* already dead */ }
+        }, timeoutMs + 1000);
+        child.on('exit', () => clearTimeout(killTimer));
+    });
+}
+async function detectESP32Ports() {
+    try {
+        const platform = process.platform;
+        let output;
+        if (platform === 'darwin') {
+            output = await execWithKill('ls /dev/cu.usb* /dev/cu.wchusbserial* 2>/dev/null || true');
+        }
+        else if (platform === 'linux') {
+            output = await execWithKill('ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null || true');
+        }
+        else {
+            return [];
+        }
+        const ports = output.trim().split('\n').filter(Boolean);
+        // Filter to ESP32 patterns, exclude known non-ESP32
+        return ports.filter(port => {
+            if (EXCLUDE_PATTERNS.some(p => p.test(port)))
+                return false;
+            return ESP32_PORT_PATTERNS.some(p => p.test(port));
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/** @internal Exported for testing only */
+export function handleSerialLine(conn, line) {
+    if (!line.startsWith('{'))
+        return; // Skip debug output like "[WiFi] Connected"
+    try {
+        const msg = JSON.parse(line);
+        if (msg.type) {
+            debug('ESP32', `← ${conn.port}: ${msg.type}`);
+            conn.deviceInfo = conn.deviceInfo || {};
+            if (msg.type === 'device_info') {
+                conn.deviceInfo = {
+                    board: msg.board,
+                    version: msg.version,
+                    wifiConfigured: msg.wifiConfigured,
+                    wifiConnected: msg.wifiConnected,
+                };
+            }
+            if (messageHandler) {
+                messageHandler(conn.port, msg);
+            }
+        }
+    }
+    catch {
+        // Not valid JSON — ignore (ESP32 debug output)
+    }
+}
+async function openPort(port) {
+    try {
+        // Open streams first, THEN configure baud rate.
+        // On macOS, opening a serial device can reset stty settings to defaults (9600).
+        // So stty must run AFTER the file descriptors are open.
+        const stream = createWriteStream(port, { flags: 'w' });
+        const conn = {
+            port, stream, reader: null, readBuf: '',
+            connected: true, deviceInfo: null, provisionSent: false,
+        };
+        stream.on('error', (err) => {
+            debug('ESP32', `Serial write error on ${port}: ${err.message}`);
+            conn.connected = false;
+            try {
+                conn.reader?.destroy();
+            }
+            catch { /* ignore */ }
+        });
+        stream.on('close', () => {
+            debug('ESP32', `Serial write closed: ${port}`);
+            conn.connected = false;
+        });
+        // Open read stream for incoming ESP32 messages
+        try {
+            const reader = createReadStream(port, { flags: 'r', encoding: 'utf-8' });
+            reader.pause(); // Don't process data until baud rate is configured
+            conn.reader = reader;
+            reader.on('data', (chunk) => {
+                const str = typeof chunk === 'string' ? chunk : chunk.toString('utf-8');
+                conn.readBuf += str;
+                let newlineIdx;
+                while ((newlineIdx = conn.readBuf.indexOf('\n')) !== -1) {
+                    const line = conn.readBuf.slice(0, newlineIdx).trim();
+                    conn.readBuf = conn.readBuf.slice(newlineIdx + 1);
+                    if (line.length > 0) {
+                        handleSerialLine(conn, line);
+                    }
+                }
+                // Prevent buffer bloat from non-newline data
+                if (conn.readBuf.length > 8192) {
+                    conn.readBuf = '';
+                }
+            });
+            reader.on('error', (err) => {
+                debug('ESP32', `Serial read error on ${port}: ${err.message}`);
+                conn.connected = false;
+                try {
+                    reader.destroy();
+                }
+                catch { /* ignore */ }
+                try {
+                    conn.stream.end();
+                }
+                catch { /* ignore */ }
+            });
+            reader.on('close', () => {
+                conn.reader = null;
+                conn.connected = false;
+            });
+        }
+        catch (err) {
+            debug('ESP32', `Failed to open reader on ${port}: ${err.message}`);
+            // Write-only still works for broadcast
+        }
+        // Configure baud rate AFTER file descriptors are open.
+        // On macOS, open() on serial devices can reset stty to defaults (9600).
+        // Skip stty for native USB CDC ports (cu.usbmodem / ttyACM) — they use
+        // USB bus speed, not UART baud rate. stty can interfere with open fds.
+        const isCDC = /usbmodem|ttyACM/.test(port);
+        if (!isCDC) {
+            const platform = process.platform;
+            if (platform === 'darwin') {
+                await execWithKill(`stty -f ${port} 115200 cs8 -cstopb -parenb -hupcl`);
+            }
+            else if (platform === 'linux') {
+                await execWithKill(`stty -F ${port} 115200 cs8 -cstopb -parenb -hupcl`);
+            }
+        }
+        // Resume reader now that baud rate is configured (flush any garbled data from open→stty window)
+        if (conn.reader) {
+            conn.readBuf = '';
+            conn.reader.resume();
+        }
+        const portType = isCDC ? 'CDC' : 'UART';
+        debug('ESP32', `Opened serial port (r/w): ${port} [${portType}]`);
+        // Request device info on connect
+        sendToConnection(conn, JSON.stringify({ type: 'device_info_request' }));
+        // Send full initial state (state + usage + sessions) so ESP32 doesn't
+        // have to wait for next state change or heartbeat cycle
+        if (initialStateProvider) {
+            const events = initialStateProvider();
+            for (const event of events) {
+                if (!FORWARDED_EVENTS.has(event.type))
+                    continue;
+                // Skip usage_update without API data — would reset ESP32 to "no data"
+                if (event.type === 'usage_update' && event.fiveHourPercent == null)
+                    continue;
+                sendToConnection(conn, JSON.stringify(prepareForSerial(event)));
+            }
+        }
+        else if (stateProvider) {
+            const event = stateProvider();
+            if (event)
+                sendToConnection(conn, JSON.stringify(event));
+        }
+        return conn;
+    }
+    catch (err) {
+        debug('ESP32', `Failed to open ${port}: ${err.message}`);
+        return null;
+    }
+}
+function sendToConnection(conn, json) {
+    if (!conn.connected)
+        return;
+    if (conn.stream.destroyed || !conn.stream.writable) {
+        conn.connected = false;
+        return;
+    }
+    try {
+        conn.stream.write(json + '\n');
+    }
+    catch {
+        conn.connected = false;
+    }
+}
+/**
+ * Register a callback that returns the current state_update event.
+ * Used to send periodic heartbeats so ESP32 gets data even without
+ * state changes (e.g., after reboot while bridge is idle).
+ */
+export function setESP32StateProvider(provider) {
+    stateProvider = provider;
+}
+/**
+ * Register a callback that returns the current usage_update event.
+ * Heartbeat sends both state + usage every cycle so ESP32 stays in sync.
+ */
+export function setESP32UsageProvider(provider) {
+    usageProvider = provider;
+}
+/**
+ * Register a provider that returns all initial state events (state + usage + sessions).
+ * Called when a new ESP32 device connects to send full state immediately.
+ */
+export function setESP32InitialStateProvider(provider) {
+    initialStateProvider = provider;
+}
+/**
+ * Register a handler for messages received from ESP32 devices.
+ * Called with (portPath, parsedMessage) for each JSON message.
+ */
+export function onESP32Message(handler) {
+    messageHandler = handler;
+}
+let heartbeatCount = 0;
+function sendHeartbeat() {
+    if (connections.length === 0)
+        return;
+    heartbeatCount++;
+    // Send state_update (stripped for serial — smaller payload)
+    if (stateProvider) {
+        const event = stateProvider();
+        if (event) {
+            const json = JSON.stringify(prepareForSerial(event));
+            for (const conn of connections) {
+                sendToConnection(conn, json);
+            }
+        }
+    }
+    // Send usage_update (so ESP32 always has fresh usage/reset times)
+    // Only send if API usage data is present (fiveHourPercent defined),
+    // otherwise the ESP32 would reset its cached values to "no data" sentinel.
+    if (usageProvider) {
+        const event = usageProvider();
+        if (event && event.fiveHourPercent != null) {
+            const json = JSON.stringify(prepareForSerial(event));
+            for (const conn of connections) {
+                sendToConnection(conn, json);
+            }
+        }
+    }
+}
+/**
+ * Start ESP32 serial bridge.
+ * Detects USB serial ports and opens connections.
+ * Call broadcast() to send events to all connected ESP32 devices.
+ *
+ * Non-blocking: initial device detection runs in background so a hung
+ * USB port (stty stuck in kernel I/O) cannot block bridge startup.
+ */
+export function startESP32Serial() {
+    // Fire-and-forget initial detection (non-blocking)
+    pollForDevices().catch(err => {
+        debug('ESP32', `Initial poll failed: ${err.message}`);
+    });
+    // Poll for new/disconnected devices every 10 seconds
+    pollTimer = setInterval(() => {
+        pollForDevices().catch(err => {
+            debug('ESP32', `Poll failed: ${err.message}`);
+        });
+    }, 10000);
+    // Heartbeat: send current state every 5 seconds so ESP32 stays in sync
+    heartbeatTimer = setInterval(sendHeartbeat, 5000);
+    debug('ESP32', 'Serial bridge started');
+}
+async function pollForDevices() {
+    const ports = await detectESP32Ports();
+    // Remove disconnected
+    connections = connections.filter(c => {
+        if (!c.connected) {
+            try {
+                c.stream.end();
+            }
+            catch { /* ignore */ }
+            try {
+                c.reader?.destroy();
+            }
+            catch { /* ignore */ }
+            return false;
+        }
+        return true;
+    });
+    // Add new ports
+    for (const port of ports) {
+        if (!connections.some(c => c.port === port)) {
+            const conn = await openPort(port);
+            if (conn) {
+                connections.push(conn);
+            }
+        }
+    }
+}
+/**
+ * Broadcast a BridgeEvent to all connected ESP32 devices via serial.
+ */
+export function broadcastESP32(event) {
+    if (connections.length === 0)
+        return;
+    if (!FORWARDED_EVENTS.has(event.type))
+        return;
+    const prepared = prepareForSerial(event);
+    // Debug: log sessions_list and state_update details for ESP32 troubleshooting
+    if (event.type === 'sessions_list') {
+        const e = event;
+        const summary = (e.sessions || []).map((s) => `${s.agentType}:${s.state ?? '?'}(${s.alive ? 'alive' : 'dead'})`).join(', ');
+        debug('ESP32', `→ sessions_list: [${summary}]`);
+    }
+    else if (event.type === 'state_update') {
+        const e = event;
+        debug('ESP32', `→ state_update: agent=${e.agentType} state=${e.state}`);
+    }
+    const json = JSON.stringify(prepared);
+    for (const conn of connections) {
+        sendToConnection(conn, json);
+    }
+}
+/**
+ * Send a WiFi provision message to a specific ESP32 device by port path.
+ */
+export function sendWifiProvision(port, msg) {
+    const conn = connections.find(c => c.port === port && c.connected);
+    if (!conn)
+        return false;
+    sendToConnection(conn, JSON.stringify(msg));
+    conn.provisionSent = true;
+    debug('ESP32', `→ ${port}: wifi_provision (SSID: ${msg.ssid})`);
+    return true;
+}
+/**
+ * Send WiFi provision to all connected ESP32 devices that haven't been provisioned.
+ */
+export function sendWifiProvisionToAll(msg) {
+    let count = 0;
+    for (const conn of connections) {
+        if (!conn.connected)
+            continue;
+        // Skip if already provisioned or WiFi already configured
+        if (conn.provisionSent)
+            continue;
+        if (conn.deviceInfo?.wifiConnected)
+            continue;
+        sendToConnection(conn, JSON.stringify(msg));
+        conn.provisionSent = true;
+        count++;
+        debug('ESP32', `→ ${conn.port}: wifi_provision (SSID: ${msg.ssid})`);
+    }
+    return count;
+}
+/**
+ * Get device info for all connected ESP32 devices.
+ */
+export function getESP32DeviceInfo() {
+    return connections
+        .filter(c => c.connected)
+        .map(c => ({
+        port: c.port,
+        ...c.deviceInfo,
+    }));
+}
+/**
+ * Wake recovery — close stale file descriptors, force immediate re-poll.
+ */
+export function handleESP32Wake() {
+    debug('ESP32', `Wake recovery — closing ${connections.length} stale connection(s)`);
+    for (const conn of connections) {
+        conn.connected = false;
+        try {
+            conn.stream.end();
+        }
+        catch { /* ignore */ }
+        try {
+            conn.reader?.destroy();
+        }
+        catch { /* ignore */ }
+    }
+    connections = [];
+    // Delay re-poll 2s to let USB bus stabilize after wake
+    setTimeout(() => {
+        pollForDevices().catch(err => {
+            debug('ESP32', `Wake poll failed: ${err.message}`);
+        });
+    }, 2000);
+}
+/**
+ * Stop ESP32 serial bridge and close all connections.
+ */
+export function stopESP32Serial() {
+    if (pollTimer) {
+        clearInterval(pollTimer);
+        pollTimer = null;
+    }
+    if (heartbeatTimer) {
+        clearInterval(heartbeatTimer);
+        heartbeatTimer = null;
+    }
+    for (const conn of connections) {
+        conn.connected = false;
+        try {
+            conn.stream.end();
+        }
+        catch { /* ignore */ }
+        try {
+            conn.reader?.destroy();
+        }
+        catch { /* ignore */ }
+    }
+    connections = [];
+    messageHandler = null;
+    debug('ESP32', 'Serial bridge stopped');
+}
+/**
+ * Get number of connected ESP32 devices.
+ */
+export function esp32ConnectionCount() {
+    return connections.filter(c => c.connected).length;
+}
+/**
+ * Get list of connected ESP32 serial port paths.
+ */
+export function getESP32Ports() {
+    return connections.filter(c => c.connected).map(c => c.port);
+}
+//# sourceMappingURL=esp32-serial.js.map

package/dist/esp32-serial.js.map

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

package/dist/gateway-probe.d.ts

@@ -0,0 +1,12 @@
+export interface GatewayStatus {
+    available: boolean;
+    hasError?: boolean;
+}
+export declare function probeGateway(): Promise<GatewayStatus>;
+/**
+ * Run `openclaw doctor` to check gateway health.
+ * Returns true if errors are detected (exit code != 0).
+ * Runs at a slower cadence than probeGateway (caller should throttle).
+ */
+export declare function checkGatewayHealth(): Promise<boolean>;
+//# sourceMappingURL=gateway-probe.d.ts.map

package/dist/gateway-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-probe.d.ts","sourceRoot":"","sources":["../src/gateway-probe.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAQ3D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAiB3D"}