ruvbot 0.1.0

package/dist/esm/channels/ChannelRegistry.js

@@ -0,0 +1,226 @@
+/**
+ * ChannelRegistry - Multi-Channel Management
+ *
+ * Manages multiple channel adapters with unified message routing,
+ * multi-tenant isolation, and rate limiting.
+ */
+// ============================================================================
+// ChannelRegistry Implementation
+// ============================================================================
+export class ChannelRegistry {
+    adapters = new Map();
+    adaptersByType = new Map();
+    adaptersByTenant = new Map();
+    globalHandlers = [];
+    config;
+    // Rate limiting state
+    rateLimitWindows = new Map();
+    constructor(config = {}) {
+        this.config = config;
+    }
+    /**
+     * Generate unique adapter key
+     */
+    getAdapterKey(type, tenantId) {
+        return `${type}:${tenantId}`;
+    }
+    /**
+     * Register a channel adapter
+     */
+    register(adapter) {
+        const key = this.getAdapterKey(adapter.type, adapter.tenantId);
+        // Store adapter
+        this.adapters.set(key, adapter);
+        // Index by type
+        if (!this.adaptersByType.has(adapter.type)) {
+            this.adaptersByType.set(adapter.type, new Set());
+        }
+        this.adaptersByType.get(adapter.type).add(key);
+        // Index by tenant
+        if (!this.adaptersByTenant.has(adapter.tenantId)) {
+            this.adaptersByTenant.set(adapter.tenantId, new Set());
+        }
+        this.adaptersByTenant.get(adapter.tenantId).add(key);
+        // Register global message handler on adapter
+        adapter.onMessage(async (message) => {
+            await this.handleMessage(message);
+        });
+    }
+    /**
+     * Unregister a channel adapter
+     */
+    unregister(type, tenantId) {
+        const key = this.getAdapterKey(type, tenantId);
+        const adapter = this.adapters.get(key);
+        if (!adapter)
+            return false;
+        // Remove from indices
+        this.adaptersByType.get(type)?.delete(key);
+        this.adaptersByTenant.get(tenantId)?.delete(key);
+        // Remove adapter
+        this.adapters.delete(key);
+        return true;
+    }
+    /**
+     * Get a specific adapter
+     */
+    get(type, tenantId) {
+        return this.adapters.get(this.getAdapterKey(type, tenantId));
+    }
+    /**
+     * Get all adapters for a type
+     */
+    getByType(type) {
+        const keys = this.adaptersByType.get(type);
+        if (!keys)
+            return [];
+        return Array.from(keys)
+            .map(key => this.adapters.get(key))
+            .filter((a) => a !== undefined);
+    }
+    /**
+     * Get all adapters for a tenant
+     */
+    getByTenant(tenantId) {
+        const keys = this.adaptersByTenant.get(tenantId);
+        if (!keys)
+            return [];
+        return Array.from(keys)
+            .map(key => this.adapters.get(key))
+            .filter((a) => a !== undefined);
+    }
+    /**
+     * Get all registered adapters
+     */
+    getAll() {
+        return Array.from(this.adapters.values());
+    }
+    /**
+     * Register a global message handler
+     */
+    onMessage(handler) {
+        this.globalHandlers.push(handler);
+    }
+    /**
+     * Remove a global message handler
+     */
+    offMessage(handler) {
+        const index = this.globalHandlers.indexOf(handler);
+        if (index > -1) {
+            this.globalHandlers.splice(index, 1);
+        }
+    }
+    /**
+     * Start all adapters
+     */
+    async start() {
+        const startPromises = Array.from(this.adapters.values())
+            .filter(adapter => adapter.enabled)
+            .map(adapter => adapter.connect());
+        await Promise.all(startPromises);
+    }
+    /**
+     * Stop all adapters
+     */
+    async stop() {
+        const stopPromises = Array.from(this.adapters.values())
+            .map(adapter => adapter.disconnect());
+        await Promise.all(stopPromises);
+    }
+    /**
+     * Broadcast a message to multiple channels
+     */
+    async broadcast(message, channelIds, filter) {
+        const results = new Map();
+        const adapters = this.filterAdapters(filter);
+        for (const adapter of adapters) {
+            for (const channelId of channelIds) {
+                try {
+                    if (this.checkRateLimit(adapter)) {
+                        const messageId = await adapter.send(channelId, message);
+                        results.set(`${adapter.type}:${channelId}`, messageId);
+                    }
+                }
+                catch (error) {
+                    console.error(`Failed to broadcast to ${adapter.type}:${channelId}:`, error);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        const byType = {};
+        const byTenant = {};
+        let connected = 0;
+        let totalMessages = 0;
+        for (const adapter of this.adapters.values()) {
+            // By type
+            byType[adapter.type] = (byType[adapter.type] ?? 0) + 1;
+            // By tenant
+            byTenant[adapter.tenantId] = (byTenant[adapter.tenantId] ?? 0) + 1;
+            // Connected status
+            const status = adapter.getStatus();
+            if (status.connected)
+                connected++;
+            totalMessages += status.messageCount;
+        }
+        return {
+            totalAdapters: this.adapters.size,
+            byType,
+            byTenant,
+            connected,
+            totalMessages,
+        };
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    async handleMessage(message) {
+        for (const handler of this.globalHandlers) {
+            try {
+                await handler(message);
+            }
+            catch (error) {
+                console.error('Global message handler error:', error);
+            }
+        }
+    }
+    filterAdapters(filter) {
+        let adapters = Array.from(this.adapters.values());
+        if (filter?.types) {
+            adapters = adapters.filter(a => filter.types.includes(a.type));
+        }
+        if (filter?.tenantIds) {
+            adapters = adapters.filter(a => filter.tenantIds.includes(a.tenantId));
+        }
+        return adapters.filter(a => a.enabled);
+    }
+    checkRateLimit(adapter) {
+        const config = this.config.defaultRateLimit;
+        if (!config)
+            return true;
+        const key = this.getAdapterKey(adapter.type, adapter.tenantId);
+        const now = Date.now();
+        let window = this.rateLimitWindows.get(key);
+        if (!window || now > window.resetAt) {
+            window = { count: 0, resetAt: now + config.windowMs };
+            this.rateLimitWindows.set(key, window);
+        }
+        if (window.count >= config.requests) {
+            return false;
+        }
+        window.count++;
+        return true;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createChannelRegistry(config) {
+    return new ChannelRegistry(config);
+}
+export default ChannelRegistry;
+//# sourceMappingURL=ChannelRegistry.js.map

package/dist/esm/channels/ChannelRegistry.js.map

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

package/dist/esm/channels/adapters/BaseAdapter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * BaseAdapter - Abstract Channel Adapter
+ *
+ * Base class for all channel adapters providing a unified interface
+ * for multi-channel messaging support.
+ */
+import type { EventEmitter } from 'events';
+export type ChannelType = 'slack' | 'discord' | 'telegram' | 'signal' | 'whatsapp' | 'line' | 'imessage' | 'web' | 'api' | 'cli';
+export interface Attachment {
+    id: string;
+    type: 'image' | 'file' | 'audio' | 'video' | 'link';
+    url?: string;
+    data?: Buffer;
+    mimeType?: string;
+    filename?: string;
+    size?: number;
+}
+export interface UnifiedMessage {
+    id: string;
+    channelId: string;
+    channelType: ChannelType;
+    tenantId: string;
+    userId: string;
+    username?: string;
+    content: string;
+    attachments?: Attachment[];
+    threadId?: string;
+    replyTo?: string;
+    timestamp: Date;
+    metadata: Record<string, unknown>;
+}
+export interface SendOptions {
+    threadId?: string;
+    replyTo?: string;
+    attachments?: Attachment[];
+    metadata?: Record<string, unknown>;
+}
+export interface ChannelCredentials {
+    token?: string;
+    apiKey?: string;
+    webhookUrl?: string;
+    clientId?: string;
+    clientSecret?: string;
+    botId?: string;
+    [key: string]: unknown;
+}
+export interface AdapterConfig {
+    type: ChannelType;
+    tenantId: string;
+    credentials: ChannelCredentials;
+    enabled?: boolean;
+    rateLimit?: {
+        requests: number;
+        windowMs: number;
+    };
+}
+export interface AdapterStatus {
+    connected: boolean;
+    lastActivity?: Date;
+    errorCount: number;
+    messageCount: number;
+}
+export type MessageHandler = (message: UnifiedMessage) => Promise<void>;
+export declare abstract class BaseAdapter {
+    protected readonly config: AdapterConfig;
+    protected status: AdapterStatus;
+    protected messageHandlers: MessageHandler[];
+    protected eventEmitter?: EventEmitter;
+    constructor(config: AdapterConfig);
+    /**
+     * Get channel type
+     */
+    get type(): ChannelType;
+    /**
+     * Get tenant ID
+     */
+    get tenantId(): string;
+    /**
+     * Check if adapter is enabled
+     */
+    get enabled(): boolean;
+    /**
+     * Get adapter status
+     */
+    getStatus(): AdapterStatus;
+    /**
+     * Register a message handler
+     */
+    onMessage(handler: MessageHandler): void;
+    /**
+     * Remove a message handler
+     */
+    offMessage(handler: MessageHandler): void;
+    /**
+     * Emit a received message to all handlers
+     */
+    protected emitMessage(message: UnifiedMessage): Promise<void>;
+    /**
+     * Create a unified message from raw input
+     */
+    protected createUnifiedMessage(content: string, userId: string, channelId: string, extra?: Partial<UnifiedMessage>): UnifiedMessage;
+    /**
+     * Connect to the channel
+     */
+    abstract connect(): Promise<void>;
+    /**
+     * Disconnect from the channel
+     */
+    abstract disconnect(): Promise<void>;
+    /**
+     * Send a message to the channel
+     */
+    abstract send(channelId: string, content: string, options?: SendOptions): Promise<string>;
+    /**
+     * Reply to a message
+     */
+    abstract reply(message: UnifiedMessage, content: string, options?: SendOptions): Promise<string>;
+}
+export default BaseAdapter;
+//# sourceMappingURL=BaseAdapter.d.ts.map

package/dist/esm/channels/adapters/BaseAdapter.d.ts.map

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

package/dist/esm/channels/adapters/BaseAdapter.js

@@ -0,0 +1,100 @@
+/**
+ * BaseAdapter - Abstract Channel Adapter
+ *
+ * Base class for all channel adapters providing a unified interface
+ * for multi-channel messaging support.
+ */
+import { v4 as uuidv4 } from 'uuid';
+// ============================================================================
+// BaseAdapter Abstract Class
+// ============================================================================
+export class BaseAdapter {
+    config;
+    status;
+    messageHandlers = [];
+    eventEmitter;
+    constructor(config) {
+        this.config = {
+            ...config,
+            enabled: config.enabled ?? true,
+        };
+        this.status = {
+            connected: false,
+            errorCount: 0,
+            messageCount: 0,
+        };
+    }
+    /**
+     * Get channel type
+     */
+    get type() {
+        return this.config.type;
+    }
+    /**
+     * Get tenant ID
+     */
+    get tenantId() {
+        return this.config.tenantId;
+    }
+    /**
+     * Check if adapter is enabled
+     */
+    get enabled() {
+        return this.config.enabled ?? true;
+    }
+    /**
+     * Get adapter status
+     */
+    getStatus() {
+        return { ...this.status };
+    }
+    /**
+     * Register a message handler
+     */
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    /**
+     * Remove a message handler
+     */
+    offMessage(handler) {
+        const index = this.messageHandlers.indexOf(handler);
+        if (index > -1) {
+            this.messageHandlers.splice(index, 1);
+        }
+    }
+    /**
+     * Emit a received message to all handlers
+     */
+    async emitMessage(message) {
+        this.status.messageCount++;
+        this.status.lastActivity = new Date();
+        for (const handler of this.messageHandlers) {
+            try {
+                await handler(message);
+            }
+            catch (error) {
+                this.status.errorCount++;
+                console.error(`Message handler error in ${this.type}:`, error);
+            }
+        }
+    }
+    /**
+     * Create a unified message from raw input
+     */
+    createUnifiedMessage(content, userId, channelId, extra = {}) {
+        return {
+            id: uuidv4(),
+            channelId,
+            channelType: this.config.type,
+            tenantId: this.config.tenantId,
+            userId,
+            content,
+            timestamp: new Date(),
+            metadata: {},
+            ...extra,
+        };
+    }
+}
+export default BaseAdapter;
+//# sourceMappingURL=BaseAdapter.js.map

package/dist/esm/channels/adapters/BaseAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAdapter.js","sourceRoot":"","sources":["../../../../src/channels/adapters/BaseAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAqFpC,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,MAAM,OAAgB,WAAW;IACZ,MAAM,CAAgB;IAC/B,MAAM,CAAgB;IACtB,eAAe,GAAqB,EAAE,CAAC;IACvC,YAAY,CAAgB;IAEtC,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;SAChC,CAAC;QACF,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAuB;QAC/B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAuB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,WAAW,CAAC,OAAuB;QACjD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;QAEtC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACO,oBAAoB,CAC5B,OAAe,EACf,MAAc,EACd,SAAiB,EACjB,QAAiC,EAAE;QAEnC,OAAO;YACL,EAAE,EAAE,MAAM,EAAE;YACZ,SAAS;YACT,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,MAAM;YACN,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE,EAAE;YACZ,GAAG,KAAK;SACT,CAAC;IACJ,CAAC;CAiCF;AAED,eAAe,WAAW,CAAC"}

package/dist/esm/channels/adapters/DiscordAdapter.d.ts

@@ -0,0 +1,67 @@
+/**
+ * DiscordAdapter - Discord Channel Integration
+ *
+ * Connects to Discord servers using discord.js for real-time messaging.
+ * Supports threads, embeds, reactions, and slash commands.
+ */
+import { BaseAdapter, type AdapterConfig, type UnifiedMessage, type SendOptions } from './BaseAdapter.js';
+export interface DiscordCredentials {
+    token: string;
+    clientId?: string;
+    guildId?: string;
+    intents?: number[];
+}
+export interface DiscordMessage {
+    id: string;
+    channelId: string;
+    guildId?: string;
+    author: {
+        id: string;
+        username: string;
+        discriminator: string;
+    };
+    content: string;
+    timestamp: Date;
+    reference?: {
+        messageId: string;
+    };
+    attachments: Map<string, DiscordAttachment>;
+}
+export interface DiscordAttachment {
+    id: string;
+    filename: string;
+    contentType?: string;
+    url: string;
+    size: number;
+}
+export declare class DiscordAdapter extends BaseAdapter {
+    private client;
+    constructor(config: Omit<AdapterConfig, 'type'> & {
+        credentials: DiscordCredentials;
+    });
+    /**
+     * Connect to Discord
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from Discord
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Send a message to a Discord channel
+     */
+    send(channelId: string, content: string, options?: SendOptions): Promise<string>;
+    /**
+     * Reply to a Discord message
+     */
+    reply(message: UnifiedMessage, content: string, options?: SendOptions): Promise<string>;
+    private loadDiscordJs;
+    private getChannel;
+    private discordToUnified;
+    private getMimeCategory;
+}
+export declare function createDiscordAdapter(config: Omit<AdapterConfig, 'type'> & {
+    credentials: DiscordCredentials;
+}): DiscordAdapter;
+export default DiscordAdapter;
+//# sourceMappingURL=DiscordAdapter.d.ts.map

package/dist/esm/channels/adapters/DiscordAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscordAdapter.d.ts","sourceRoot":"","sources":["../../../../src/channels/adapters/DiscordAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,qBAAa,cAAe,SAAQ,WAAW;IAC7C,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG;QAAE,WAAW,EAAE,kBAAkB,CAAA;KAAE;IAIrF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC;IAwBlB;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC;YAYJ,aAAa;YAUb,UAAU;IASxB,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,eAAe;CAMxB;AAMD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG;IAAE,WAAW,EAAE,kBAAkB,CAAA;CAAE,GACxE,cAAc,CAEhB;AAED,eAAe,cAAc,CAAC"}