openclaw-bitchat 0.1.0

package/README.md

@@ -0,0 +1,156 @@
+# @openclaw/bitchat
+
+OpenClaw channel plugin for Bitchat BLE mesh network.
+
+> ⚠️ **Alpha Software** — This plugin and bitchat-node are experimental. APIs may change without notice.
+
+## Overview
+
+This plugin enables OpenClaw to communicate via the Bitchat peer-to-peer BLE mesh network. Messages travel directly between devices over Bluetooth Low Energy without any central server.
+
+**Requirements:**
+- [bitchat-node](https://github.com/wkyleg/bitchat-node) running as a background service
+- BLE-capable hardware (Mac, Linux with BlueZ, or Windows with BLE support)
+- Other Bitchat peers nearby (iOS app, other nodes)
+
+## Installation
+
+```bash
+openclaw plugins install @openclaw/bitchat
+```
+
+Or for development:
+
+```bash
+openclaw plugins install -l /path/to/openclaw-bitchat
+```
+
+## Configuration
+
+Add to your OpenClaw config (`~/.openclaw/openclaw.json`):
+
+```json5
+{
+  channels: {
+    bitchat: {
+      enabled: true,
+      nickname: "my-agent",
+      bridgeUrl: "http://localhost:3939",
+      dmPolicy: "open", // or "allowlist", "disabled"
+      allowFrom: [], // peer IDs when using allowlist
+    },
+  },
+}
+```
+
+### Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enabled` | boolean | `true` | Enable/disable the channel |
+| `nickname` | string | `"openclaw"` | Display name on the mesh network |
+| `bridgeUrl` | string | `"http://localhost:3939"` | URL of the bitchat-node HTTP bridge |
+| `webhookPath` | string | `"/bitchat-webhook"` | Webhook endpoint for incoming messages |
+| `autoStart` | boolean | `false` | Auto-start bitchat-node daemon |
+| `dmPolicy` | string | `"open"` | DM access policy (`open`, `allowlist`, `disabled`) |
+| `allowFrom` | string[] | `[]` | Allowed peer IDs when using `allowlist` policy |
+
+## Usage
+
+### 1. Start bitchat-node
+
+First, ensure bitchat-node is running:
+
+```bash
+cd /path/to/bitchat-node
+node dist/bin/bitchat.js --nickname=MyAgent --port=3939
+```
+
+Or run it as a background service.
+
+### 2. Configure OpenClaw
+
+Add the bitchat channel configuration to your OpenClaw config.
+
+### 3. Restart OpenClaw Gateway
+
+```bash
+openclaw gateway restart
+```
+
+### 4. Test
+
+Send a message from a Bitchat peer (iOS app or another node). OpenClaw will receive it and route it to a session.
+
+To send messages via OpenClaw:
+
+```bash
+# Via message tool in session
+message tool with channel=bitchat, target=<peerID>, message="Hello!"
+```
+
+## Architecture
+
+```
+┌─────────────────────┐     ┌──────────────────────┐     ┌─────────────────┐
+│   Bitchat Peers     │     │    bitchat-node      │     │    OpenClaw     │
+│   (iOS, Android,    │◄───►│    (BLE + HTTP)      │◄───►│    Gateway      │
+│    other nodes)     │ BLE │    localhost:3939    │HTTP │    + Plugin     │
+└─────────────────────┘     └──────────────────────┘     └─────────────────┘
+```
+
+1. **bitchat-node** maintains BLE connections to nearby peers
+2. **HTTP Bridge** exposes REST API for sending/receiving messages
+3. **OpenClaw Plugin** polls the bridge or receives webhooks for incoming messages
+4. **Outbound messages** go through the bridge API to the BLE mesh
+
+## API Endpoints (bitchat-node)
+
+The plugin communicates with bitchat-node via these endpoints:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/status` | GET | Get node status (peerID, nickname, peer count) |
+| `/api/peers` | GET | List connected peers |
+| `/api/messages` | GET | Get recent messages (polling, `?since=timestamp`) |
+| `/api/send` | POST | Send a message (`{ type, text, recipientPeerID? }`) |
+| `/api/webhook` | POST | Register a webhook URL |
+
+## Limitations
+
+- **BLE Range**: Messages only propagate within BLE range (~10-100m)
+- **No Media**: BLE bandwidth is limited; text-only messaging
+- **No Persistence**: Messages are ephemeral; no server-side storage
+- **Peer Discovery**: Requires active BLE scanning/advertising
+
+## Security Considerations
+
+- **Local Only**: All communication is local mesh; nothing leaves your network
+- **No Encryption for Public**: Public messages are unencrypted
+- **DM Encryption**: Direct messages use Noise protocol encryption
+- **DM Policy**: Configure `dmPolicy` and `allowFrom` to restrict who can message
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/wkyleg/openclaw-bitchat.git
+cd openclaw-bitchat
+npm install
+
+# Build
+npm run build
+
+# Link for development
+openclaw plugins install -l .
+```
+
+## Related
+
+- [bitchat-node](https://github.com/wkyleg/bitchat-node) — Node.js Bitchat implementation
+- [Bitchat iOS](https://github.com/...) — Original iOS implementation
+- [OpenClaw Plugins](https://docs.openclaw.ai/plugins) — Plugin development guide
+
+## License
+
+[Unlicense](https://unlicense.org/) — Public Domain

package/dist/bridge.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Bitchat Bridge
+ *
+ * Handles communication with the bitchat-node HTTP bridge.
+ * Supports both polling and WebSocket connections for real-time messages.
+ */
+import type { BitchatInboundMessage } from './index.js';
+import type { Logger } from './types.js';
+export interface BridgeOptions {
+    bridgeUrl: string;
+    nickname: string;
+    onMessage: (msg: BitchatInboundMessage) => Promise<void>;
+    logger: Logger;
+    pollIntervalMs?: number;
+}
+interface BridgeStatus {
+    connected: boolean;
+    peerID?: string;
+    nickname?: string;
+    peersCount?: number;
+}
+interface PendingMessage {
+    id: string;
+    type: 'public' | 'direct';
+    senderPeerID: string;
+    senderNickname: string;
+    text: string;
+    timestamp: number;
+}
+export declare class BitchatBridge {
+    private readonly bridgeUrl;
+    private readonly onMessage;
+    private readonly logger;
+    private readonly pollIntervalMs;
+    private connected;
+    private pollTimer;
+    private lastMessageTimestamp;
+    private ws;
+    constructor(options: BridgeOptions);
+    /**
+     * Connect to the bitchat-node bridge
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the bridge
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get bridge status
+     */
+    getStatus(): Promise<BridgeStatus>;
+    /**
+     * Send a public message to all peers
+     */
+    sendPublicMessage(text: string): Promise<void>;
+    /**
+     * Send a direct message to a specific peer
+     */
+    sendDirectMessage(recipientPeerID: string, text: string): Promise<void>;
+    /**
+     * Get list of known peers
+     */
+    getPeers(): Promise<{
+        peerID: string;
+        nickname: string;
+        lastSeen: number;
+    }[]>;
+    /**
+     * Get recent messages (for polling)
+     */
+    getMessages(since?: number): Promise<PendingMessage[]>;
+    /**
+     * Register webhook for incoming messages
+     */
+    registerWebhook(webhookUrl: string): Promise<void>;
+    /**
+     * Connect via WebSocket for real-time messages
+     */
+    private connectWebSocket;
+    /**
+     * Start polling for messages
+     */
+    private startPolling;
+}
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,EAAE,CAA0B;gBAExB,OAAO,EAAE,aAAa;IAOlC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAQxC;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD;;OAEG;IACG,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7E;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAQnF;;OAEG;IACG,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAY5D;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxD;;OAEG;YACW,gBAAgB;IAwD9B;;OAEG;IACH,OAAO,CAAC,YAAY;CAmCrB"}

package/dist/bridge.js

@@ -0,0 +1,232 @@
+/**
+ * Bitchat Bridge
+ *
+ * Handles communication with the bitchat-node HTTP bridge.
+ * Supports both polling and WebSocket connections for real-time messages.
+ */
+export class BitchatBridge {
+    bridgeUrl;
+    onMessage;
+    logger;
+    pollIntervalMs;
+    connected = false;
+    pollTimer = null;
+    lastMessageTimestamp = 0;
+    ws = null;
+    constructor(options) {
+        this.bridgeUrl = options.bridgeUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.onMessage = options.onMessage;
+        this.logger = options.logger;
+        this.pollIntervalMs = options.pollIntervalMs ?? 2000;
+    }
+    /**
+     * Connect to the bitchat-node bridge
+     */
+    async connect() {
+        // First, verify the bridge is reachable
+        try {
+            const status = await this.getStatus();
+            this.logger.info(`[bitchat-bridge] Connected to bridge. PeerID: ${status.peerID}`);
+            this.connected = true;
+        }
+        catch (err) {
+            this.logger.error('[bitchat-bridge] Failed to connect to bridge:', err);
+            throw err;
+        }
+        // Try WebSocket first, fall back to polling
+        const wsUrl = this.bridgeUrl.replace(/^http/, 'ws') + '/ws';
+        try {
+            await this.connectWebSocket(wsUrl);
+            this.logger.info('[bitchat-bridge] WebSocket connected');
+        }
+        catch {
+            this.logger.info('[bitchat-bridge] WebSocket unavailable, using polling');
+            this.startPolling();
+        }
+    }
+    /**
+     * Disconnect from the bridge
+     */
+    async disconnect() {
+        this.connected = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get bridge status
+     */
+    async getStatus() {
+        const response = await fetch(`${this.bridgeUrl}/api/status`);
+        if (!response.ok) {
+            throw new Error(`Bridge status failed: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Send a public message to all peers
+     */
+    async sendPublicMessage(text) {
+        const response = await fetch(`${this.bridgeUrl}/api/send`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ type: 'public', text }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to send public message: ${error}`);
+        }
+    }
+    /**
+     * Send a direct message to a specific peer
+     */
+    async sendDirectMessage(recipientPeerID, text) {
+        const response = await fetch(`${this.bridgeUrl}/api/send`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ type: 'direct', recipientPeerID, text }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to send direct message: ${error}`);
+        }
+    }
+    /**
+     * Get list of known peers
+     */
+    async getPeers() {
+        const response = await fetch(`${this.bridgeUrl}/api/peers`);
+        if (!response.ok) {
+            throw new Error(`Failed to get peers: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get recent messages (for polling)
+     */
+    async getMessages(since) {
+        const url = since
+            ? `${this.bridgeUrl}/api/messages?since=${since}`
+            : `${this.bridgeUrl}/api/messages`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to get messages: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Register webhook for incoming messages
+     */
+    async registerWebhook(webhookUrl) {
+        const response = await fetch(`${this.bridgeUrl}/api/webhook`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ url: webhookUrl }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to register webhook: ${error}`);
+        }
+    }
+    /**
+     * Connect via WebSocket for real-time messages
+     */
+    async connectWebSocket(wsUrl) {
+        return new Promise((resolve, reject) => {
+            try {
+                // Note: In Node.js, we'd use the 'ws' package
+                // This is a simplified version that may need adjustment
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const WebSocketImpl = typeof WebSocket !== 'undefined' ? WebSocket : require('ws');
+                const ws = new WebSocketImpl(wsUrl);
+                this.ws = ws;
+                const timeout = setTimeout(() => {
+                    reject(new Error('WebSocket connection timeout'));
+                }, 5000);
+                ws.onopen = () => {
+                    clearTimeout(timeout);
+                    resolve();
+                };
+                ws.onerror = (err) => {
+                    clearTimeout(timeout);
+                    reject(err);
+                };
+                ws.onmessage = async (event) => {
+                    try {
+                        const data = JSON.parse(String(event.data));
+                        if (data.type === 'message') {
+                            await this.onMessage({
+                                type: data.isDirect ? 'direct' : 'public',
+                                senderPeerID: data.senderPeerID,
+                                senderNickname: data.senderNickname,
+                                text: data.text,
+                                timestamp: data.timestamp,
+                                messageId: data.id ?? `ws-${Date.now()}`,
+                            });
+                        }
+                    }
+                    catch (err) {
+                        this.logger.error('[bitchat-bridge] WebSocket message parse error:', err);
+                    }
+                };
+                ws.onclose = () => {
+                    this.logger.info('[bitchat-bridge] WebSocket closed');
+                    this.ws = null;
+                    // Reconnect or fall back to polling
+                    if (this.connected) {
+                        this.startPolling();
+                    }
+                };
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    /**
+     * Start polling for messages
+     */
+    startPolling() {
+        if (this.pollTimer) {
+            return; // Already polling
+        }
+        this.logger.info(`[bitchat-bridge] Starting message polling (${this.pollIntervalMs}ms)`);
+        this.pollTimer = setInterval(async () => {
+            if (!this.connected) {
+                return;
+            }
+            try {
+                const messages = await this.getMessages(this.lastMessageTimestamp);
+                for (const msg of messages) {
+                    // Update timestamp to avoid duplicates
+                    if (msg.timestamp > this.lastMessageTimestamp) {
+                        this.lastMessageTimestamp = msg.timestamp;
+                    }
+                    await this.onMessage({
+                        type: msg.type,
+                        senderPeerID: msg.senderPeerID,
+                        senderNickname: msg.senderNickname,
+                        text: msg.text,
+                        timestamp: msg.timestamp,
+                        messageId: msg.id,
+                    });
+                }
+            }
+            catch (err) {
+                this.logger.error('[bitchat-bridge] Poll error:', err);
+            }
+        }, this.pollIntervalMs);
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @openclaw/bitchat - Bitchat BLE Mesh Channel Plugin
+ *
+ * This plugin enables OpenClaw to communicate via the Bitchat
+ * peer-to-peer BLE mesh network.
+ *
+ * Architecture:
+ * - bitchat-node runs as a background service (separate process)
+ * - This plugin communicates with it via HTTP bridge
+ * - Inbound: webhook from bitchat-node → OpenClaw session
+ * - Outbound: OpenClaw → HTTP API → bitchat-node → BLE mesh
+ */
+import type { PluginApi, ChannelPlugin } from './types.js';
+export interface BitchatConfig {
+    enabled?: boolean;
+    nickname?: string;
+    bridgeUrl?: string;
+    webhookPath?: string;
+    autoStart?: boolean;
+    dmPolicy?: 'open' | 'allowlist' | 'disabled';
+    allowFrom?: string[];
+}
+export interface BitchatInboundMessage {
+    type: 'public' | 'direct';
+    senderPeerID: string;
+    senderNickname: string;
+    text: string;
+    timestamp: number;
+    messageId: string;
+}
+/**
+ * Main plugin registration
+ */
+export default function register(api: PluginApi): void;
+export type { PluginApi, ChannelPlugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3D,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAGD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAiID;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAqHrD;AAGD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC"}