@athenafleet/bridge 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# @athenafleet/bridge
+
+CLI bridge connecting your local OpenClaw gateway to the Athena dashboard via WebSocket.
+
+## Install
+
+```bash
+npm i -g @athenafleet/bridge
+```
+
+## Usage
+
+```bash
+athena-bridge --key rtk_xxx
+```
+
+That's it. The bridge connects to the Athena API, authenticates with your runtime key, and begins syncing agent data from your local OpenClaw gateway to the dashboard.
+
+## Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--key`, `-k` | *(required)* | Runtime API key (`rtk_` prefix) |
+| `--api-url` | `https://api.athenafleet.ai` | Athena API URL |
+| `--gateway-id` | hostname | Identifier for this gateway |
+| `--openclaw-url` | `http://localhost:3007` | Local OpenClaw gateway URL |
+| `--verbose`, `-v` | `false` | Enable debug logging |
+
+## What it does
+
+1. **Connects** to the Athena WebSocket endpoint (`/ws/runtime`)
+2. **Authenticates** with your runtime API key (first-message auth)
+3. **Syncs** agent data from your local OpenClaw gateway every 60 seconds
+4. **Heartbeats** every 30 seconds to keep the connection alive
+5. **Reconnects** automatically with exponential backoff if disconnected
+
+## Generate a key
+
+Runtime keys are created in the Athena dashboard under **Settings → Runtime Keys**, or via the API:
+
+```bash
+curl -X POST https://api.athenafleet.ai/api/admin/runtime-keys \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "My Gateway"}'
+```
+
+The key is shown **once** on creation — save it.
+
+## Requirements
+
+- Node.js ≥ 18
+- An Athena account with a runtime API key
+- OpenClaw gateway running locally (optional — bridge works without it, just syncs empty agent list)
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @athenafleet/bridge — WebSocket Client
+ *
+ * Manages the persistent WS connection to the Athena API:
+ * - First-message auth with runtime API key
+ * - Health pings on heartbeat_interval_ms
+ * - Agent sync every 60s + on server request
+ * - Exponential backoff reconnection with jitter
+ * - Graceful shutdown
+ */
+import type { BridgeOptions } from './types.js';
+export declare class BridgeClient {
+    private ws;
+    private options;
+    private runtimeId;
+    private heartbeatIntervalMs;
+    private startedAt;
+    private heartbeatTimer;
+    private syncTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private intentionalClose;
+    private lastAgents;
+    private gatewayConnected;
+    constructor(options: BridgeOptions);
+    /**
+     * Start the bridge. Connects and begins sync loop.
+     */
+    start(): void;
+    /**
+     * Graceful shutdown.
+     */
+    stop(): void;
+    private connect;
+    private sendAuth;
+    private handleMessage;
+    private handleAuthOk;
+    private syncAgents;
+    private sendHealthPing;
+    private scheduleReconnect;
+    private send;
+    private clearTimers;
+}

package/dist/client.js

@@ -0,0 +1,261 @@
+/**
+ * @athenafleet/bridge — WebSocket Client
+ *
+ * Manages the persistent WS connection to the Athena API:
+ * - First-message auth with runtime API key
+ * - Health pings on heartbeat_interval_ms
+ * - Agent sync every 60s + on server request
+ * - Exponential backoff reconnection with jitter
+ * - Graceful shutdown
+ */
+import WebSocket from 'ws';
+import { CLOSE_CODES } from './types.js';
+import { fetchAgents } from './gateway.js';
+import * as log from './logger.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const BRIDGE_VERSION = '1.0.0';
+const SYNC_INTERVAL_MS = 60_000; // 1/min (server rate limit)
+const BASE_BACKOFF_MS = 1_000;
+const MAX_BACKOFF_MS = 30_000;
+const JITTER_FACTOR = 0.25; // ±25%
+// =============================================================================
+// Bridge Client
+// =============================================================================
+export class BridgeClient {
+    ws = null;
+    options;
+    runtimeId = null;
+    heartbeatIntervalMs = 30_000;
+    startedAt = Date.now();
+    // Timers
+    heartbeatTimer = null;
+    syncTimer = null;
+    reconnectTimer = null;
+    // Reconnection state
+    reconnectAttempt = 0;
+    intentionalClose = false;
+    // Cached agent data
+    lastAgents = [];
+    gatewayConnected = false;
+    constructor(options) {
+        this.options = options;
+    }
+    // ===========================================================================
+    // Public API
+    // ===========================================================================
+    /**
+     * Start the bridge. Connects and begins sync loop.
+     */
+    start() {
+        this.startedAt = Date.now();
+        this.intentionalClose = false;
+        this.connect();
+    }
+    /**
+     * Graceful shutdown.
+     */
+    stop() {
+        log.info('Shutting down...');
+        this.intentionalClose = true;
+        this.clearTimers();
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.close(1000, 'Client shutdown');
+        }
+        this.ws = null;
+    }
+    // ===========================================================================
+    // Connection
+    // ===========================================================================
+    connect() {
+        const apiUrl = this.options.apiUrl.replace(/\/+$/, '');
+        const wsUrl = apiUrl.replace(/^http/, 'ws') + '/ws/runtime';
+        log.info(`Connecting to ${wsUrl}...`);
+        try {
+            this.ws = new WebSocket(wsUrl, {
+                headers: {
+                    'User-Agent': `@athenafleet/bridge/${BRIDGE_VERSION}`,
+                },
+                handshakeTimeout: 10_000,
+            });
+        }
+        catch (err) {
+            log.error('Failed to create WebSocket', err);
+            this.scheduleReconnect();
+            return;
+        }
+        this.ws.on('open', () => {
+            log.debug('WebSocket connected, sending auth...');
+            this.sendAuth();
+        });
+        this.ws.on('message', (data) => {
+            this.handleMessage(data);
+        });
+        this.ws.on('close', (code, reason) => {
+            const reasonStr = reason?.toString() || 'unknown';
+            log.info(`Disconnected (code=${code}, reason=${reasonStr})`);
+            this.clearTimers();
+            this.ws = null;
+            this.runtimeId = null;
+            // Don't reconnect on intentional close or fatal auth errors
+            if (this.intentionalClose)
+                return;
+            if (code === CLOSE_CODES.INVALID_AUTH) {
+                log.error('Authentication failed — check your --key. Not reconnecting.');
+                process.exit(1);
+            }
+            if (code === CLOSE_CODES.LIMIT_EXCEEDED) {
+                log.warn('Connection limit exceeded — will retry with backoff');
+            }
+            this.scheduleReconnect();
+        });
+        this.ws.on('error', (err) => {
+            log.error('WebSocket error', err);
+            // 'close' event will fire after this, triggering reconnect
+        });
+        // ws library auto-responds to ping with pong
+    }
+    // ===========================================================================
+    // Auth
+    // ===========================================================================
+    sendAuth() {
+        this.send({
+            type: 'auth',
+            key: this.options.key,
+            bridge_version: BRIDGE_VERSION,
+            gateway_version: 'unknown', // Future: detect OpenClaw version
+        });
+    }
+    // ===========================================================================
+    // Message handling
+    // ===========================================================================
+    handleMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw.toString());
+        }
+        catch {
+            log.debug('Received non-JSON message, ignoring');
+            return;
+        }
+        log.debug(`← ${msg.type}`, msg);
+        switch (msg.type) {
+            case 'auth_ok':
+                this.handleAuthOk(msg.runtime_id, msg.heartbeat_interval_ms);
+                break;
+            case 'auth_error':
+                log.error(`Auth rejected: ${msg.reason}`);
+                // Server will close the socket; close handler deals with exit
+                break;
+            case 'agents.sync_request':
+                log.info('Server requested agent sync');
+                void this.syncAgents();
+                break;
+            case 'runtime.disconnect':
+                log.warn(`Server disconnecting: ${msg.reason}`);
+                break;
+            case 'error':
+                log.warn(`Server error: ${msg.message}`);
+                break;
+            default:
+                log.debug('Unknown message type', { raw: raw.toString().slice(0, 200) });
+        }
+    }
+    handleAuthOk(runtimeId, heartbeatIntervalMs) {
+        this.runtimeId = runtimeId;
+        this.heartbeatIntervalMs = heartbeatIntervalMs;
+        this.reconnectAttempt = 0; // Reset backoff on successful auth
+        log.info(`✓ Authenticated (runtime=${runtimeId}, heartbeat=${heartbeatIntervalMs}ms)`);
+        // Start heartbeat
+        this.heartbeatTimer = setInterval(() => {
+            this.sendHealthPing();
+        }, this.heartbeatIntervalMs);
+        // Initial sync + periodic sync
+        void this.syncAgents();
+        this.syncTimer = setInterval(() => {
+            void this.syncAgents();
+        }, SYNC_INTERVAL_MS);
+    }
+    // ===========================================================================
+    // Agent sync
+    // ===========================================================================
+    async syncAgents() {
+        try {
+            const agents = await fetchAgents(this.options.openclawUrl);
+            this.lastAgents = agents;
+            this.gatewayConnected = agents.length > 0;
+            this.send({
+                type: 'agents.sync',
+                agents,
+                gateway_id: this.options.gatewayId,
+                timestamp: new Date().toISOString(),
+            });
+            log.info(`Synced ${agents.length} agent(s)`);
+        }
+        catch (err) {
+            log.error('Agent sync failed', err);
+            this.gatewayConnected = false;
+        }
+    }
+    // ===========================================================================
+    // Health ping
+    // ===========================================================================
+    sendHealthPing() {
+        this.send({
+            type: 'health.ping',
+            gateway_connected: this.gatewayConnected,
+            agent_count: this.lastAgents.length,
+            uptime_ms: Date.now() - this.startedAt,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    // ===========================================================================
+    // Reconnection (FINF-35: exponential backoff + jitter)
+    // ===========================================================================
+    scheduleReconnect() {
+        this.reconnectAttempt++;
+        // Exponential backoff: 1s, 2s, 4s, 8s, 16s, 30s cap
+        const baseDelay = Math.min(BASE_BACKOFF_MS * Math.pow(2, this.reconnectAttempt - 1), MAX_BACKOFF_MS);
+        // ±25% jitter
+        const jitter = baseDelay * JITTER_FACTOR * (2 * Math.random() - 1);
+        const delay = Math.max(500, Math.round(baseDelay + jitter));
+        log.info(`Reconnecting in ${(delay / 1000).toFixed(1)}s (attempt ${this.reconnectAttempt})...`);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+    }
+    // ===========================================================================
+    // Helpers
+    // ===========================================================================
+    send(msg) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            log.debug(`Cannot send ${msg.type} — not connected`);
+            return;
+        }
+        const payload = JSON.stringify(msg);
+        log.debug(`→ ${msg.type}`, { size: payload.length });
+        try {
+            this.ws.send(payload);
+        }
+        catch (err) {
+            log.error(`Failed to send ${msg.type}`, err);
+        }
+    }
+    clearTimers() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.syncTimer) {
+            clearInterval(this.syncTimer);
+            this.syncTimer = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/gateway.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @athenafleet/bridge — Gateway Data Collector
+ *
+ * Fetches agent data from the local OpenClaw gateway.
+ * Gracefully handles connection failures (returns empty array).
+ */
+import type { SyncedAgent } from './types.js';
+/**
+ * Fetch agent list from local OpenClaw gateway.
+ *
+ * Expected response shape from OpenClaw /api/agents:
+ * ```json
+ * [{ "id": "...", "name": "...", "emoji": "...", "status": "...", ... }]
+ * ```
+ *
+ * Fields are mapped to the SyncedAgent shape expected by the server.
+ * Missing fields get safe defaults.
+ */
+export declare function fetchAgents(openclawUrl: string): Promise<SyncedAgent[]>;

package/dist/gateway.js

@@ -0,0 +1,71 @@
+/**
+ * @athenafleet/bridge — Gateway Data Collector
+ *
+ * Fetches agent data from the local OpenClaw gateway.
+ * Gracefully handles connection failures (returns empty array).
+ */
+import * as log from './logger.js';
+/**
+ * Fetch agent list from local OpenClaw gateway.
+ *
+ * Expected response shape from OpenClaw /api/agents:
+ * ```json
+ * [{ "id": "...", "name": "...", "emoji": "...", "status": "...", ... }]
+ * ```
+ *
+ * Fields are mapped to the SyncedAgent shape expected by the server.
+ * Missing fields get safe defaults.
+ */
+export async function fetchAgents(openclawUrl) {
+    const url = `${openclawUrl.replace(/\/+$/, '')}/api/agents`;
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5_000);
+        const res = await fetch(url, {
+            signal: controller.signal,
+            headers: { Accept: 'application/json' },
+        });
+        clearTimeout(timeout);
+        if (!res.ok) {
+            log.warn(`Gateway returned ${res.status} from ${url}`);
+            return [];
+        }
+        const data = await res.json();
+        if (!Array.isArray(data)) {
+            log.warn('Gateway /api/agents did not return an array');
+            return [];
+        }
+        return data.map(sanitizeAgent).filter((a) => a !== null);
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'AbortError') {
+            log.debug('Gateway request timed out');
+        }
+        else {
+            log.debug('Gateway unreachable', { error: err instanceof Error ? err.message : String(err) });
+        }
+        return [];
+    }
+}
+/**
+ * Map raw gateway agent data to SyncedAgent with safe defaults.
+ */
+function sanitizeAgent(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const r = raw;
+    const id = r.id;
+    if (!id || typeof id !== 'string')
+        return null;
+    return {
+        id,
+        name: typeof r.name === 'string' ? r.name : 'Unknown',
+        emoji: typeof r.emoji === 'string' ? r.emoji : '🤖',
+        status: typeof r.status === 'string' ? r.status : 'unknown',
+        model: typeof r.model === 'string' ? r.model : '',
+        uptime: typeof r.uptime === 'number' ? r.uptime : 0,
+        lastHeartbeat: typeof r.lastHeartbeat === 'string' ? r.lastHeartbeat : new Date().toISOString(),
+        sessionCount: typeof r.sessionCount === 'number' ? r.sessionCount : 0,
+    };
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * @athenafleet/bridge — CLI Entry Point
+ *
+ * Usage:
+ *   athena-bridge --key rtk_xxx [--api-url https://api.athenafleet.ai] [--verbose]
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+/**
+ * @athenafleet/bridge — CLI Entry Point
+ *
+ * Usage:
+ *   athena-bridge --key rtk_xxx [--api-url https://api.athenafleet.ai] [--verbose]
+ */
+import { hostname } from 'os';
+import { BridgeClient } from './client.js';
+import * as log from './logger.js';
+import { setVerbose } from './logger.js';
+// =============================================================================
+// Argument parsing (zero deps — just process.argv)
+// =============================================================================
+function parseArgs(argv) {
+    let key;
+    let apiUrl = 'https://api.athenafleet.ai';
+    let gatewayId = hostname();
+    let openclawUrl = 'http://localhost:3007';
+    let verbose = false;
+    for (let i = 2; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--key' || arg === '-k') {
+            key = argv[++i];
+        }
+        else if (arg.startsWith('--key=')) {
+            key = arg.slice('--key='.length);
+        }
+        else if (arg === '--api-url') {
+            apiUrl = argv[++i] ?? apiUrl;
+        }
+        else if (arg.startsWith('--api-url=')) {
+            apiUrl = arg.slice('--api-url='.length);
+        }
+        else if (arg === '--gateway-id') {
+            gatewayId = argv[++i] ?? gatewayId;
+        }
+        else if (arg.startsWith('--gateway-id=')) {
+            gatewayId = arg.slice('--gateway-id='.length);
+        }
+        else if (arg === '--openclaw-url') {
+            openclawUrl = argv[++i] ?? openclawUrl;
+        }
+        else if (arg.startsWith('--openclaw-url=')) {
+            openclawUrl = arg.slice('--openclaw-url='.length);
+        }
+        else if (arg === '--verbose' || arg === '-v') {
+            verbose = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg === '--version') {
+            console.log('1.0.0');
+            process.exit(0);
+        }
+        else {
+            console.error(`Unknown argument: ${arg}`);
+            printHelp();
+            process.exit(1);
+        }
+    }
+    if (!key) {
+        console.error('Error: --key is required\n');
+        printHelp();
+        process.exit(1);
+    }
+    if (!key.startsWith('rtk_')) {
+        console.error('Error: key must start with rtk_ prefix\n');
+        process.exit(1);
+    }
+    return { key, apiUrl, gatewayId, openclawUrl, verbose };
+}
+function printHelp() {
+    console.log(`
+  @athenafleet/bridge — Connect your OpenClaw gateway to Athena
+
+  Usage:
+    athena-bridge --key rtk_xxx [options]
+
+  Options:
+    --key, -k <key>           Runtime API key (required, rtk_ prefix)
+    --api-url <url>           Athena API URL (default: https://api.athenafleet.ai)
+    --gateway-id <id>         Gateway identifier (default: hostname)
+    --openclaw-url <url>      Local OpenClaw URL (default: http://localhost:3007)
+    --verbose, -v             Enable debug logging
+    --version                 Print version
+    --help, -h                Print this help
+
+  Examples:
+    athena-bridge --key rtk_abc123
+    athena-bridge --key rtk_abc123 --api-url http://localhost:4000 --verbose
+`);
+}
+// =============================================================================
+// Main
+// =============================================================================
+const options = parseArgs(process.argv);
+setVerbose(options.verbose);
+log.info('@athenafleet/bridge starting...');
+log.info(`  API:      ${options.apiUrl}`);
+log.info(`  Gateway:  ${options.gatewayId}`);
+log.info(`  OpenClaw: ${options.openclawUrl}`);
+log.info(`  Verbose:  ${options.verbose}`);
+const client = new BridgeClient(options);
+// Graceful shutdown
+function shutdown(signal) {
+    log.info(`Received ${signal}`);
+    client.stop();
+    // Give WS close frame time to send
+    setTimeout(() => process.exit(0), 500);
+}
+process.on('SIGINT', () => shutdown('SIGINT'));
+process.on('SIGTERM', () => shutdown('SIGTERM'));
+client.start();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,GAAuB,CAAC;IAC5B,IAAI,MAAM,GAAG,4BAA4B,CAAC;IAC1C,IAAI,SAAS,GAAG,QAAQ,EAAE,CAAC;IAC3B,IAAI,WAAW,GAAG,uBAAuB,CAAC;IAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QAErB,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACpC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC;QAC/B,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAClC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC;QACrC,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3C,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YACpC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC;QACzC,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC7C,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/C,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;YAC1C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;CAkBb,CAAC,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAExC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5B,GAAG,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;AAC5C,GAAG,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1C,GAAG,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;AAC7C,GAAG,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/C,GAAG,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAE3C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AAEzC,oBAAoB;AACpB,SAAS,QAAQ,CAAC,MAAc;IAC9B,GAAG,CAAC,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;IAC/B,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,mCAAmC;IACnC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAEjD,MAAM,CAAC,KAAK,EAAE,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @athenafleet/bridge — Logger
+ *
+ * Simple structured logger with verbose mode.
+ */
+export declare function setVerbose(enabled: boolean): void;
+export declare function info(msg: string, data?: Record<string, unknown>): void;
+export declare function error(msg: string, err?: unknown): void;
+export declare function warn(msg: string): void;
+export declare function debug(msg: string, data?: Record<string, unknown>): void;

package/dist/logger.js

@@ -0,0 +1,39 @@
+/**
+ * @athenafleet/bridge — Logger
+ *
+ * Simple structured logger with verbose mode.
+ */
+let verboseEnabled = false;
+export function setVerbose(enabled) {
+    verboseEnabled = enabled;
+}
+function timestamp() {
+    return new Date().toISOString();
+}
+export function info(msg, data) {
+    const parts = [`[${timestamp()}] ${msg}`];
+    if (data && verboseEnabled) {
+        parts.push(JSON.stringify(data));
+    }
+    console.log(parts.join(' '));
+}
+export function error(msg, err) {
+    const parts = [`[${timestamp()}] ERROR: ${msg}`];
+    if (err instanceof Error) {
+        parts.push(`— ${err.message}`);
+    }
+    console.error(parts.join(' '));
+}
+export function warn(msg) {
+    console.warn(`[${timestamp()}] WARN: ${msg}`);
+}
+export function debug(msg, data) {
+    if (!verboseEnabled)
+        return;
+    const parts = [`[${timestamp()}] DEBUG: ${msg}`];
+    if (data) {
+        parts.push(JSON.stringify(data));
+    }
+    console.log(parts.join(' '));
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,cAAc,GAAG,OAAO,CAAC;AAC3B,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,IAA8B;IAC9D,MAAM,KAAK,GAAG,CAAC,IAAI,SAAS,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC1C,IAAI,IAAI,IAAI,cAAc,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,GAAa;IAC9C,MAAM,KAAK,GAAG,CAAC,IAAI,SAAS,EAAE,YAAY,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,IAA8B;IAC/D,IAAI,CAAC,cAAc;QAAE,OAAO;IAC5B,MAAM,KAAK,GAAG,CAAC,IAAI,SAAS,EAAE,YAAY,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @athenafleet/bridge — Message Types
+ *
+ * Mirrors athena-api src/ws/runtime-types.ts
+ */
+export interface SyncedAgent {
+    id: string;
+    name: string;
+    emoji: string;
+    status: string;
+    model: string;
+    uptime: number;
+    lastHeartbeat: string;
+    sessionCount: number;
+}
+export interface AuthMessage {
+    type: 'auth';
+    key: string;
+    bridge_version: string;
+    gateway_version: string;
+}
+export interface AgentsSyncMessage {
+    type: 'agents.sync';
+    agents: SyncedAgent[];
+    gateway_id: string;
+    timestamp: string;
+}
+export interface AgentStatusMessage {
+    type: 'agents.status';
+    agent_id: string;
+    status: string;
+    timestamp: string;
+}
+export interface HealthPingMessage {
+    type: 'health.ping';
+    gateway_connected: boolean;
+    agent_count: number;
+    uptime_ms: number;
+    timestamp: string;
+}
+export type BridgeOutbound = AuthMessage | AgentsSyncMessage | AgentStatusMessage | HealthPingMessage;
+export interface AuthOkMessage {
+    type: 'auth_ok';
+    runtime_id: string;
+    heartbeat_interval_ms: number;
+}
+export interface AuthErrorMessage {
+    type: 'auth_error';
+    reason: string;
+}
+export interface SyncRequestMessage {
+    type: 'agents.sync_request';
+}
+export interface RuntimeDisconnectMessage {
+    type: 'runtime.disconnect';
+    reason: string;
+}
+export interface ErrorMessage {
+    type: 'error';
+    message: string;
+}
+export type ServerInbound = AuthOkMessage | AuthErrorMessage | SyncRequestMessage | RuntimeDisconnectMessage | ErrorMessage;
+export declare const CLOSE_CODES: {
+    readonly INVALID_AUTH: 4001;
+    readonly LIMIT_EXCEEDED: 4003;
+    readonly AUTH_TIMEOUT: 4008;
+    readonly PONG_TIMEOUT: 4009;
+};
+export interface BridgeOptions {
+    key: string;
+    apiUrl: string;
+    gatewayId: string;
+    openclawUrl: string;
+    verbose: boolean;
+}

package/dist/types.js

@@ -0,0 +1,15 @@
+/**
+ * @athenafleet/bridge — Message Types
+ *
+ * Mirrors athena-api src/ws/runtime-types.ts
+ */
+// =============================================================================
+// Close codes (from server)
+// =============================================================================
+export const CLOSE_CODES = {
+    INVALID_AUTH: 4001,
+    LIMIT_EXCEEDED: 4003,
+    AUTH_TIMEOUT: 4008,
+    PONG_TIMEOUT: 4009,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4FH,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;CACV,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@athenafleet/bridge",
+  "version": "1.0.0",
+  "description": "CLI bridge connecting local OpenClaw gateway to Athena dashboard via WebSocket",
+  "type": "module",
+  "bin": {
+    "athena-bridge": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "athena",
+    "bridge",
+    "openclaw",
+    "runtime",
+    "websocket"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.0"
+  }
+}