openclaw-bitchat 0.1.0

package/dist/index.js

@@ -0,0 +1,240 @@
+/**
+ * @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 { BitchatBridge } from './bridge.js';
+// Default config values
+const DEFAULT_CONFIG = {
+    enabled: true,
+    nickname: 'openclaw',
+    bridgeUrl: 'http://localhost:3939',
+    webhookPath: '/bitchat-webhook',
+    autoStart: false,
+    dmPolicy: 'open',
+    allowFrom: [],
+};
+// Bridge instance (singleton for the gateway)
+let bridge = null;
+/**
+ * Resolve channel config from OpenClaw config
+ */
+function resolveConfig(cfg) {
+    const channelConfig = cfg.channels?.bitchat;
+    return {
+        ...DEFAULT_CONFIG,
+        ...channelConfig,
+    };
+}
+/**
+ * Check if a sender is allowed based on policy
+ */
+function isSenderAllowed(config, senderPeerID) {
+    switch (config.dmPolicy) {
+        case 'disabled':
+            return false;
+        case 'allowlist':
+            return config.allowFrom.includes(senderPeerID) || config.allowFrom.includes('*');
+        case 'open':
+        default:
+            return true;
+    }
+}
+/**
+ * Create the Bitchat channel plugin
+ */
+function createBitchatPlugin() {
+    return {
+        id: 'bitchat',
+        meta: {
+            id: 'bitchat',
+            label: 'Bitchat',
+            selectionLabel: 'Bitchat (BLE Mesh)',
+            docsPath: '/channels/bitchat',
+            docsLabel: 'bitchat',
+            blurb: 'Peer-to-peer BLE mesh network messaging.',
+            aliases: ['ble', 'mesh'],
+        },
+        capabilities: {
+            chatTypes: ['direct', 'group'],
+            media: false, // BLE bandwidth is limited
+        },
+        config: {
+            listAccountIds: () => ['default'],
+            resolveAccount: (cfg, accountId) => {
+                const config = resolveConfig(cfg);
+                return {
+                    accountId: accountId ?? 'default',
+                    enabled: config.enabled,
+                    configured: Boolean(config.bridgeUrl),
+                    config,
+                };
+            },
+            defaultAccountId: () => 'default',
+            isConfigured: (account) => account.configured ?? false,
+            describeAccount: (account) => ({
+                accountId: account.accountId,
+                enabled: account.enabled ?? true,
+                configured: account.configured ?? false,
+            }),
+        },
+        security: {
+            resolveDmPolicy: ({ account }) => ({
+                policy: String(account.config?.dmPolicy ?? 'open'),
+                allowFrom: account.config?.allowFrom ?? [],
+                policyPath: 'channels.bitchat.dmPolicy',
+                allowFromPath: 'channels.bitchat.allowFrom',
+                approveHint: 'Add peer ID to channels.bitchat.allowFrom',
+                normalizeEntry: (raw) => raw.trim().toLowerCase(),
+            }),
+        },
+        messaging: {
+            normalizeTarget: ({ target }) => {
+                // Accept peer ID or nickname
+                const cleaned = target.replace(/^bitchat:/i, '').trim();
+                return { target: cleaned, normalized: cleaned };
+            },
+            targetResolver: {
+                looksLikeId: (target) => /^[a-f0-9]{16}$/i.test(target),
+                hint: '<peerID|nickname>',
+            },
+        },
+        outbound: {
+            deliveryMode: 'direct',
+            sendText: async ({ text, target }) => {
+                if (!bridge) {
+                    return { ok: false, error: 'Bitchat bridge not initialized' };
+                }
+                try {
+                    // Determine if this is a DM or public message
+                    const isDirect = target && target !== 'public' && target !== '*';
+                    if (isDirect) {
+                        await bridge.sendDirectMessage(target, text);
+                    }
+                    else {
+                        await bridge.sendPublicMessage(text);
+                    }
+                    return { ok: true };
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err.message : String(err);
+                    return { ok: false, error };
+                }
+            },
+        },
+    };
+}
+/**
+ * Main plugin registration
+ */
+export default function register(api) {
+    const logger = api.logger;
+    // Register the channel
+    const plugin = createBitchatPlugin();
+    api.registerChannel({ plugin });
+    // Register background service to manage bridge connection
+    api.registerService({
+        id: 'bitchat-bridge',
+        start: async () => {
+            const cfg = api.config;
+            const config = resolveConfig(cfg);
+            if (!config.enabled) {
+                logger.info('[bitchat] Channel disabled');
+                return;
+            }
+            logger.info(`[bitchat] Starting bridge connection to ${config.bridgeUrl}`);
+            bridge = new BitchatBridge({
+                bridgeUrl: config.bridgeUrl,
+                nickname: config.nickname,
+                onMessage: async (msg) => {
+                    // Check if sender is allowed
+                    if (!isSenderAllowed(config, msg.senderPeerID)) {
+                        logger.debug(`[bitchat] Ignoring message from unauthorized peer: ${msg.senderPeerID}`);
+                        return;
+                    }
+                    // Route message to OpenClaw session
+                    try {
+                        await api.injectMessage({
+                            channel: 'bitchat',
+                            senderId: msg.senderPeerID,
+                            senderName: msg.senderNickname,
+                            text: msg.text,
+                            messageId: msg.messageId,
+                            chatType: msg.type === 'direct' ? 'direct' : 'group',
+                            timestamp: msg.timestamp,
+                        });
+                    }
+                    catch (err) {
+                        logger.error('[bitchat] Failed to inject message:', err);
+                    }
+                },
+                logger,
+            });
+            await bridge.connect();
+            logger.info('[bitchat] Bridge connected');
+        },
+        stop: async () => {
+            if (bridge) {
+                await bridge.disconnect();
+                bridge = null;
+                logger.info('[bitchat] Bridge disconnected');
+            }
+        },
+    });
+    // Register webhook handler for inbound messages
+    api.registerHttpHandler({
+        method: 'POST',
+        path: '/bitchat-webhook',
+        handler: async (req, res) => {
+            try {
+                const body = req.body;
+                if (!body || !body.senderPeerID || !body.text) {
+                    res.status(400).json({ error: 'Invalid message format' });
+                    return;
+                }
+                const cfg = api.config;
+                const config = resolveConfig(cfg);
+                if (!isSenderAllowed(config, body.senderPeerID)) {
+                    res.status(403).json({ error: 'Sender not allowed' });
+                    return;
+                }
+                await api.injectMessage({
+                    channel: 'bitchat',
+                    senderId: body.senderPeerID,
+                    senderName: body.senderNickname,
+                    text: body.text,
+                    messageId: body.messageId,
+                    chatType: body.type === 'direct' ? 'direct' : 'group',
+                    timestamp: body.timestamp,
+                });
+                res.json({ ok: true });
+            }
+            catch (err) {
+                logger.error('[bitchat] Webhook error:', err);
+                res.status(500).json({ error: 'Internal error' });
+            }
+        },
+    });
+    // Register RPC methods for status
+    api.registerGatewayMethod('bitchat.status', async ({ respond }) => {
+        const cfg = api.config;
+        const config = resolveConfig(cfg);
+        const status = {
+            enabled: config.enabled,
+            bridgeUrl: config.bridgeUrl,
+            connected: bridge?.isConnected() ?? false,
+            nickname: config.nickname,
+            dmPolicy: config.dmPolicy,
+        };
+        respond(true, status);
+    });
+    logger.info('[bitchat] Plugin registered');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Type definitions for OpenClaw plugin API
+ *
+ * These are simplified types based on the OpenClaw plugin interface.
+ * In production, these would come from the openclaw package types.
+ */
+export interface Logger {
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+}
+export interface InjectMessageOptions {
+    channel: string;
+    senderId: string;
+    senderName?: string;
+    text: string;
+    messageId?: string;
+    chatType?: 'direct' | 'group';
+    timestamp?: number;
+    replyToId?: string;
+    media?: {
+        type: string;
+        url?: string;
+        buffer?: Buffer;
+        filename?: string;
+    }[];
+}
+export interface HttpHandler {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    path: string;
+    handler: (req: HttpRequest, res: HttpResponse) => Promise<void> | void;
+}
+export interface HttpRequest {
+    body: unknown;
+    query: Record<string, string>;
+    params: Record<string, string>;
+    headers: Record<string, string>;
+}
+export interface HttpResponse {
+    status: (code: number) => HttpResponse;
+    json: (data: unknown) => void;
+    send: (data: string) => void;
+}
+export interface ServiceDefinition {
+    id: string;
+    start: () => Promise<void> | void;
+    stop: () => Promise<void> | void;
+}
+export interface GatewayMethodContext {
+    respond: (success: boolean, data?: unknown) => void;
+    params?: Record<string, unknown>;
+}
+export interface ChannelMeta {
+    id: string;
+    label: string;
+    selectionLabel?: string;
+    docsPath?: string;
+    docsLabel?: string;
+    blurb?: string;
+    aliases?: string[];
+}
+export interface ChannelCapabilities {
+    chatTypes: readonly ('direct' | 'group')[];
+    media?: boolean;
+    threads?: boolean;
+    reactions?: boolean;
+}
+export interface ChannelAccount {
+    accountId: string;
+    enabled?: boolean;
+    configured?: boolean;
+    config?: Record<string, unknown>;
+}
+export interface DmPolicyResult {
+    policy: string;
+    allowFrom: string[];
+    policyPath: string;
+    allowFromPath: string;
+    approveHint: string;
+    normalizeEntry: (raw: string) => string;
+}
+export interface NormalizeTargetResult {
+    target: string;
+    normalized: string;
+}
+export interface SendResult {
+    ok: boolean;
+    error?: string;
+    messageId?: string;
+}
+export interface ChannelPlugin {
+    id: string;
+    meta: ChannelMeta;
+    capabilities: ChannelCapabilities;
+    config: {
+        listAccountIds: (cfg: Record<string, unknown>) => string[];
+        resolveAccount: (cfg: Record<string, unknown>, accountId?: string) => ChannelAccount;
+        defaultAccountId?: (cfg: Record<string, unknown>) => string;
+        isConfigured?: (account: ChannelAccount) => boolean;
+        describeAccount?: (account: ChannelAccount) => Record<string, unknown>;
+    };
+    security?: {
+        resolveDmPolicy?: (ctx: {
+            cfg: Record<string, unknown>;
+            account: ChannelAccount;
+        }) => DmPolicyResult;
+    };
+    messaging?: {
+        normalizeTarget?: (ctx: {
+            target: string;
+            cfg: Record<string, unknown>;
+        }) => NormalizeTargetResult;
+        targetResolver?: {
+            looksLikeId: (target: string) => boolean;
+            hint: string;
+        };
+    };
+    outbound?: {
+        deliveryMode: 'direct' | 'queued';
+        sendText: (ctx: {
+            text: string;
+            target: string;
+            cfg: Record<string, unknown>;
+            account: ChannelAccount;
+        }) => Promise<SendResult>;
+        sendMedia?: (ctx: {
+            media: {
+                type: string;
+                buffer: Buffer;
+                filename?: string;
+            };
+            target: string;
+            cfg: Record<string, unknown>;
+            account: ChannelAccount;
+        }) => Promise<SendResult>;
+    };
+}
+export interface PluginApi {
+    logger: Logger;
+    config: unknown;
+    registerChannel: (opts: {
+        plugin: ChannelPlugin;
+    }) => void;
+    registerService: (service: ServiceDefinition) => void;
+    registerHttpHandler: (handler: HttpHandler) => void;
+    registerGatewayMethod: (name: string, handler: (ctx: GatewayMethodContext) => Promise<void> | void) => void;
+    injectMessage: (opts: InjectMessageOptions) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for OpenClaw plugin API
+ *
+ * These are simplified types based on the OpenClaw plugin interface.
+ * In production, these would come from the openclaw package types.
+ */
+export {};
+//# 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;;;;;GAKG"}

package/openclaw.plugin.json

@@ -0,0 +1,58 @@
+{
+  "id": "bitchat",
+  "name": "Bitchat Channel",
+  "version": "0.1.0",
+  "description": "Bitchat BLE mesh network channel plugin for OpenClaw",
+  "author": "Kyle Graves",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable/disable the Bitchat channel"
+      },
+      "nickname": {
+        "type": "string",
+        "description": "Display name on the mesh network"
+      },
+      "bridgeUrl": {
+        "type": "string",
+        "default": "http://localhost:3939",
+        "description": "URL of the bitchat-node HTTP bridge"
+      },
+      "webhookPath": {
+        "type": "string",
+        "default": "/bitchat-webhook",
+        "description": "Webhook endpoint path for incoming messages"
+      },
+      "autoStart": {
+        "type": "boolean",
+        "default": false,
+        "description": "Auto-start bitchat-node daemon (if installed locally)"
+      },
+      "dmPolicy": {
+        "type": "string",
+        "enum": ["open", "allowlist", "disabled"],
+        "default": "open",
+        "description": "DM access policy"
+      },
+      "allowFrom": {
+        "type": "array",
+        "items": { "type": "string" },
+        "default": [],
+        "description": "Allowed peer IDs (when dmPolicy=allowlist)"
+      }
+    }
+  },
+  "uiHints": {
+    "enabled": { "label": "Enabled" },
+    "nickname": { "label": "Nickname", "placeholder": "my-agent" },
+    "bridgeUrl": { "label": "Bridge URL", "placeholder": "http://localhost:3939" },
+    "webhookPath": { "label": "Webhook Path", "placeholder": "/bitchat-webhook" },
+    "autoStart": { "label": "Auto-start daemon" },
+    "dmPolicy": { "label": "DM Policy" },
+    "allowFrom": { "label": "Allowed Peer IDs" }
+  }
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "openclaw-bitchat",
+  "version": "0.1.0",
+  "description": "OpenClaw channel plugin for Bitchat BLE mesh network",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"],
+    "channel": {
+      "id": "bitchat",
+      "label": "Bitchat",
+      "selectionLabel": "Bitchat (BLE Mesh)",
+      "docsPath": "/channels/bitchat",
+      "docsLabel": "bitchat",
+      "blurb": "Peer-to-peer BLE mesh network messaging.",
+      "order": 90,
+      "aliases": ["ble", "mesh"]
+    },
+    "install": {
+      "npmSpec": "openclaw-bitchat",
+      "defaultChoice": "npm"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "bitchat-node": "^0.1.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wkyleg/openclaw-bitchat.git"
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "bitchat",
+    "bluetooth",
+    "ble",
+    "mesh",
+    "p2p"
+  ],
+  "license": "Unlicense",
+  "engines": {
+    "node": ">=18"
+  }
+}