@phuetz/code-buddy 0.1.12 → 0.1.14

package/dist/channels/group-security.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Group Chat Security
+ *
+ * OpenClaw-inspired group chat security with mention-gating, group allowlists,
+ * and activation control.
+ *
+ * In group chats, bots can be noisy if they respond to every message. This
+ * module provides configurable security controls:
+ *
+ * 1. **Mention-gating** - Require @mention to activate in groups
+ * 2. **Group allowlists** - Per-group user allowlists
+ * 3. **Activation modes** - Per-group control (active, mention-only, inactive, allowlist-only)
+ * 4. **Global blocklist** - Block users across all groups
+ * 5. **Rate limiting** - Per-group message rate limiting
+ *
+ * Usage:
+ * ```typescript
+ * const security = getGroupSecurity();
+ *
+ * // Check if an inbound message should be processed
+ * const result = security.shouldProcess(message);
+ * if (result.allowed) {
+ *   // Process message
+ * } else {
+ *   logger.debug('Message blocked', { reason: result.reason });
+ * }
+ *
+ * // Configure a group
+ * security.addGroup({
+ *   groupId: 'telegram:-100123456',
+ *   channelType: 'telegram',
+ *   activationMode: 'mention-only',
+ *   allowedUsers: ['user-1', 'user-2'],
+ * });
+ * ```
+ */
+import { EventEmitter } from 'events';
+import type { ChannelType, InboundMessage } from './index.js';
+/**
+ * Group activation mode controlling how the bot responds in a group.
+ *
+ * - `active` - Process all messages (no gating)
+ * - `mention-only` - Only process messages that mention the bot
+ * - `inactive` - Ignore all messages in this group
+ * - `allowlist-only` - Only process messages from allowlisted users
+ */
+export type GroupActivationMode = 'active' | 'mention-only' | 'inactive' | 'allowlist-only';
+/**
+ * Per-group configuration
+ */
+export interface GroupConfig {
+    /** Group/channel ID */
+    groupId: string;
+    /** Channel type (telegram, discord, etc.) */
+    channelType: ChannelType;
+    /** How the bot is activated in this group */
+    activationMode: GroupActivationMode;
+    /** Users allowed to interact in this group (for allowlist-only mode) */
+    allowedUsers?: string[];
+    /** Custom mention patterns for this group (overrides global) */
+    mentionPatterns?: string[];
+    /** Whether mentions are required in this group (default true for groups) */
+    requireMention?: boolean;
+    /** Cooldown between processed messages in ms */
+    cooldownMs?: number;
+    /** Maximum messages per minute for this group */
+    maxMessagesPerMinute?: number;
+}
+/**
+ * Global group security configuration
+ */
+export interface GroupSecurityConfig {
+    /** Enable group security */
+    enabled: boolean;
+    /** Default activation mode for unconfigured groups */
+    defaultMode: GroupActivationMode;
+    /** Default mention patterns to detect bot mentions */
+    mentionPatterns: string[];
+    /** Per-group configurations (groupId -> config) */
+    groupConfigs: Map<string, GroupConfig>;
+    /** Users allowed in all groups */
+    globalAllowlist: string[];
+    /** Users blocked from all groups */
+    blocklist: string[];
+    /** Require @mention in group chats by default */
+    requireMentionInGroups: boolean;
+}
+/**
+ * Result of shouldProcess check
+ */
+export interface ProcessResult {
+    /** Whether the message should be processed */
+    allowed: boolean;
+    /** Human-readable reason for the decision */
+    reason: string;
+}
+export declare const DEFAULT_GROUP_SECURITY_CONFIG: GroupSecurityConfig;
+export declare class GroupSecurityManager extends EventEmitter {
+    private config;
+    private rateLimits;
+    constructor(config?: Partial<GroupSecurityConfig>);
+    /**
+     * Determine whether an inbound message should be processed.
+     *
+     * DM (direct message) channels always pass through.
+     * Group messages are checked against activation mode, mention patterns,
+     * allowlists, blocklist, and rate limits.
+     */
+    shouldProcess(message: InboundMessage): ProcessResult;
+    /**
+     * Check if message content contains any of the mention patterns.
+     * Case-insensitive matching.
+     */
+    private containsMention;
+    /**
+     * Check if a group has exceeded its rate limit.
+     */
+    private checkRateLimit;
+    /**
+     * Record a processed message for rate limiting purposes.
+     */
+    private recordMessage;
+    /**
+     * Add a group configuration.
+     */
+    addGroup(config: GroupConfig): void;
+    /**
+     * Remove a group configuration.
+     */
+    removeGroup(groupId: string): boolean;
+    /**
+     * Update a group configuration (partial merge).
+     */
+    updateGroup(groupId: string, partial: Partial<GroupConfig>): boolean;
+    /**
+     * Get configuration for a specific group.
+     */
+    getGroupConfig(groupId: string): GroupConfig | undefined;
+    /**
+     * List all configured groups.
+     */
+    listGroups(): GroupConfig[];
+    /**
+     * Add a user to a group's allowlist.
+     */
+    addToAllowlist(groupId: string, userId: string): boolean;
+    /**
+     * Remove a user from a group's allowlist.
+     */
+    removeFromAllowlist(groupId: string, userId: string): boolean;
+    /**
+     * Add a user to the global blocklist.
+     */
+    addToBlocklist(userId: string): void;
+    /**
+     * Remove a user from the global blocklist.
+     */
+    removeFromBlocklist(userId: string): boolean;
+    /**
+     * Get group security statistics.
+     */
+    getStats(): {
+        enabled: boolean;
+        totalGroups: number;
+        defaultMode: GroupActivationMode;
+        globalAllowlistSize: number;
+        blocklistSize: number;
+        groupsByMode: Record<string, number>;
+    };
+    /**
+     * Dispose all internal state and remove all listeners.
+     */
+    dispose(): void;
+}
+/**
+ * Get the singleton GroupSecurityManager instance.
+ */
+export declare function getGroupSecurity(config?: Partial<GroupSecurityConfig>): GroupSecurityManager;
+/**
+ * Reset the singleton GroupSecurityManager (for testing).
+ */
+export declare function resetGroupSecurity(): void;

package/dist/channels/group-security.js

@@ -0,0 +1,407 @@
+/**
+ * Group Chat Security
+ *
+ * OpenClaw-inspired group chat security with mention-gating, group allowlists,
+ * and activation control.
+ *
+ * In group chats, bots can be noisy if they respond to every message. This
+ * module provides configurable security controls:
+ *
+ * 1. **Mention-gating** - Require @mention to activate in groups
+ * 2. **Group allowlists** - Per-group user allowlists
+ * 3. **Activation modes** - Per-group control (active, mention-only, inactive, allowlist-only)
+ * 4. **Global blocklist** - Block users across all groups
+ * 5. **Rate limiting** - Per-group message rate limiting
+ *
+ * Usage:
+ * ```typescript
+ * const security = getGroupSecurity();
+ *
+ * // Check if an inbound message should be processed
+ * const result = security.shouldProcess(message);
+ * if (result.allowed) {
+ *   // Process message
+ * } else {
+ *   logger.debug('Message blocked', { reason: result.reason });
+ * }
+ *
+ * // Configure a group
+ * security.addGroup({
+ *   groupId: 'telegram:-100123456',
+ *   channelType: 'telegram',
+ *   activationMode: 'mention-only',
+ *   allowedUsers: ['user-1', 'user-2'],
+ * });
+ * ```
+ */
+import { EventEmitter } from 'events';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+export const DEFAULT_GROUP_SECURITY_CONFIG = {
+    enabled: true,
+    defaultMode: 'mention-only',
+    mentionPatterns: ['@buddy', '@codebuddy', '@bot'],
+    groupConfigs: new Map(),
+    globalAllowlist: [],
+    blocklist: [],
+    requireMentionInGroups: true,
+};
+// ============================================================================
+// GroupSecurityManager
+// ============================================================================
+export class GroupSecurityManager extends EventEmitter {
+    config;
+    rateLimits = new Map();
+    constructor(config = {}) {
+        super();
+        this.config = {
+            ...DEFAULT_GROUP_SECURITY_CONFIG,
+            ...config,
+            // Deep-copy collections so mutations don't leak
+            groupConfigs: config.groupConfigs
+                ? new Map(config.groupConfigs)
+                : new Map(),
+            globalAllowlist: config.globalAllowlist
+                ? [...config.globalAllowlist]
+                : [],
+            blocklist: config.blocklist
+                ? [...config.blocklist]
+                : [],
+            mentionPatterns: config.mentionPatterns
+                ? [...config.mentionPatterns]
+                : [...DEFAULT_GROUP_SECURITY_CONFIG.mentionPatterns],
+        };
+    }
+    // ==========================================================================
+    // Main Gating Function
+    // ==========================================================================
+    /**
+     * Determine whether an inbound message should be processed.
+     *
+     * DM (direct message) channels always pass through.
+     * Group messages are checked against activation mode, mention patterns,
+     * allowlists, blocklist, and rate limits.
+     */
+    shouldProcess(message) {
+        // If security is disabled, allow everything
+        if (!this.config.enabled) {
+            return { allowed: true, reason: 'group security disabled' };
+        }
+        // DMs always pass through - group security only applies to groups
+        if (message.channel.isDM || !message.channel.isGroup) {
+            return { allowed: true, reason: 'direct message' };
+        }
+        const groupId = message.channel.id;
+        const senderId = message.sender.id;
+        // Check global blocklist first
+        if (this.config.blocklist.includes(senderId)) {
+            const result = { allowed: false, reason: 'user is on global blocklist' };
+            this.emit('message:blocked', message, result.reason);
+            logger.debug('Group security: blocked message (blocklist)', {
+                groupId,
+                senderId,
+            });
+            return result;
+        }
+        // Get group-specific config or fall back to defaults
+        const groupConfig = this.config.groupConfigs.get(groupId);
+        const activationMode = groupConfig?.activationMode ?? this.config.defaultMode;
+        // Handle activation modes
+        switch (activationMode) {
+            case 'inactive': {
+                const result = { allowed: false, reason: 'group is inactive' };
+                this.emit('message:blocked', message, result.reason);
+                logger.debug('Group security: blocked message (inactive group)', { groupId });
+                return result;
+            }
+            case 'active': {
+                // Active mode: process all (but still check blocklist which is done above
+                // and rate limits below)
+                break;
+            }
+            case 'allowlist-only': {
+                const allowedUsers = groupConfig?.allowedUsers ?? [];
+                const isGloballyAllowed = this.config.globalAllowlist.includes(senderId);
+                const isGroupAllowed = allowedUsers.includes(senderId);
+                if (!isGloballyAllowed && !isGroupAllowed) {
+                    const result = { allowed: false, reason: 'user not on allowlist' };
+                    this.emit('message:blocked', message, result.reason);
+                    logger.debug('Group security: blocked message (not on allowlist)', {
+                        groupId,
+                        senderId,
+                    });
+                    return result;
+                }
+                break;
+            }
+            case 'mention-only': {
+                const requireMention = groupConfig?.requireMention ?? this.config.requireMentionInGroups;
+                if (requireMention) {
+                    const patterns = groupConfig?.mentionPatterns ?? this.config.mentionPatterns;
+                    const hasMention = this.containsMention(message.content, patterns);
+                    if (!hasMention) {
+                        const result = { allowed: false, reason: 'no mention detected' };
+                        this.emit('message:blocked', message, result.reason);
+                        logger.debug('Group security: blocked message (no mention)', {
+                            groupId,
+                            senderId,
+                        });
+                        return result;
+                    }
+                }
+                break;
+            }
+        }
+        // Rate limiting
+        const rateLimitResult = this.checkRateLimit(groupId, groupConfig);
+        if (!rateLimitResult.allowed) {
+            this.emit('message:rate-limited', message, rateLimitResult.reason);
+            logger.debug('Group security: rate limited', {
+                groupId,
+                reason: rateLimitResult.reason,
+            });
+            return rateLimitResult;
+        }
+        // Record this message for rate limiting
+        this.recordMessage(groupId);
+        const result = { allowed: true, reason: 'passed all checks' };
+        this.emit('message:allowed', message);
+        return result;
+    }
+    // ==========================================================================
+    // Mention Detection
+    // ==========================================================================
+    /**
+     * Check if message content contains any of the mention patterns.
+     * Case-insensitive matching.
+     */
+    containsMention(content, patterns) {
+        const lower = content.toLowerCase();
+        return patterns.some(pattern => lower.includes(pattern.toLowerCase()));
+    }
+    // ==========================================================================
+    // Rate Limiting
+    // ==========================================================================
+    /**
+     * Check if a group has exceeded its rate limit.
+     */
+    checkRateLimit(groupId, groupConfig) {
+        if (!groupConfig) {
+            return { allowed: true, reason: 'no rate limit configured' };
+        }
+        const entry = this.rateLimits.get(groupId);
+        if (!entry) {
+            return { allowed: true, reason: 'no rate limit history' };
+        }
+        const now = Date.now();
+        // Check cooldown
+        if (groupConfig.cooldownMs && groupConfig.cooldownMs > 0) {
+            const elapsed = now - entry.lastProcessed;
+            if (elapsed < groupConfig.cooldownMs) {
+                return {
+                    allowed: false,
+                    reason: `cooldown active (${groupConfig.cooldownMs - elapsed}ms remaining)`,
+                };
+            }
+        }
+        // Check messages per minute
+        if (groupConfig.maxMessagesPerMinute && groupConfig.maxMessagesPerMinute > 0) {
+            const oneMinuteAgo = now - 60_000;
+            const recentCount = entry.timestamps.filter(ts => ts >= oneMinuteAgo).length;
+            if (recentCount >= groupConfig.maxMessagesPerMinute) {
+                return {
+                    allowed: false,
+                    reason: `rate limit exceeded (${recentCount}/${groupConfig.maxMessagesPerMinute} per minute)`,
+                };
+            }
+        }
+        return { allowed: true, reason: 'within rate limits' };
+    }
+    /**
+     * Record a processed message for rate limiting purposes.
+     */
+    recordMessage(groupId) {
+        const now = Date.now();
+        let entry = this.rateLimits.get(groupId);
+        if (!entry) {
+            entry = { timestamps: [], lastProcessed: 0 };
+            this.rateLimits.set(groupId, entry);
+        }
+        entry.timestamps.push(now);
+        entry.lastProcessed = now;
+        // Prune old timestamps (keep only last 2 minutes)
+        const cutoff = now - 120_000;
+        entry.timestamps = entry.timestamps.filter(ts => ts >= cutoff);
+    }
+    // ==========================================================================
+    // Group Management
+    // ==========================================================================
+    /**
+     * Add a group configuration.
+     */
+    addGroup(config) {
+        this.config.groupConfigs.set(config.groupId, { ...config });
+        logger.debug('Group security: added group', {
+            groupId: config.groupId,
+            mode: config.activationMode,
+        });
+    }
+    /**
+     * Remove a group configuration.
+     */
+    removeGroup(groupId) {
+        const existed = this.config.groupConfigs.delete(groupId);
+        if (existed) {
+            this.rateLimits.delete(groupId);
+            logger.debug('Group security: removed group', { groupId });
+        }
+        return existed;
+    }
+    /**
+     * Update a group configuration (partial merge).
+     */
+    updateGroup(groupId, partial) {
+        const existing = this.config.groupConfigs.get(groupId);
+        if (!existing) {
+            return false;
+        }
+        const updated = { ...existing, ...partial, groupId };
+        this.config.groupConfigs.set(groupId, updated);
+        logger.debug('Group security: updated group', {
+            groupId,
+            mode: updated.activationMode,
+        });
+        return true;
+    }
+    /**
+     * Get configuration for a specific group.
+     */
+    getGroupConfig(groupId) {
+        const config = this.config.groupConfigs.get(groupId);
+        return config ? { ...config } : undefined;
+    }
+    /**
+     * List all configured groups.
+     */
+    listGroups() {
+        return Array.from(this.config.groupConfigs.values()).map(c => ({ ...c }));
+    }
+    // ==========================================================================
+    // Allowlist Management
+    // ==========================================================================
+    /**
+     * Add a user to a group's allowlist.
+     */
+    addToAllowlist(groupId, userId) {
+        const config = this.config.groupConfigs.get(groupId);
+        if (!config) {
+            return false;
+        }
+        if (!config.allowedUsers) {
+            config.allowedUsers = [];
+        }
+        if (!config.allowedUsers.includes(userId)) {
+            config.allowedUsers.push(userId);
+            logger.debug('Group security: added user to allowlist', { groupId, userId });
+        }
+        return true;
+    }
+    /**
+     * Remove a user from a group's allowlist.
+     */
+    removeFromAllowlist(groupId, userId) {
+        const config = this.config.groupConfigs.get(groupId);
+        if (!config || !config.allowedUsers) {
+            return false;
+        }
+        const index = config.allowedUsers.indexOf(userId);
+        if (index === -1) {
+            return false;
+        }
+        config.allowedUsers.splice(index, 1);
+        logger.debug('Group security: removed user from allowlist', { groupId, userId });
+        return true;
+    }
+    // ==========================================================================
+    // Blocklist Management
+    // ==========================================================================
+    /**
+     * Add a user to the global blocklist.
+     */
+    addToBlocklist(userId) {
+        if (!this.config.blocklist.includes(userId)) {
+            this.config.blocklist.push(userId);
+            logger.debug('Group security: added user to blocklist', { userId });
+        }
+    }
+    /**
+     * Remove a user from the global blocklist.
+     */
+    removeFromBlocklist(userId) {
+        const index = this.config.blocklist.indexOf(userId);
+        if (index === -1) {
+            return false;
+        }
+        this.config.blocklist.splice(index, 1);
+        logger.debug('Group security: removed user from blocklist', { userId });
+        return true;
+    }
+    // ==========================================================================
+    // Statistics
+    // ==========================================================================
+    /**
+     * Get group security statistics.
+     */
+    getStats() {
+        const groupsByMode = {};
+        for (const config of this.config.groupConfigs.values()) {
+            groupsByMode[config.activationMode] = (groupsByMode[config.activationMode] || 0) + 1;
+        }
+        return {
+            enabled: this.config.enabled,
+            totalGroups: this.config.groupConfigs.size,
+            defaultMode: this.config.defaultMode,
+            globalAllowlistSize: this.config.globalAllowlist.length,
+            blocklistSize: this.config.blocklist.length,
+            groupsByMode,
+        };
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    /**
+     * Dispose all internal state and remove all listeners.
+     */
+    dispose() {
+        this.config.groupConfigs.clear();
+        this.config.globalAllowlist = [];
+        this.config.blocklist = [];
+        this.rateLimits.clear();
+        this.removeAllListeners();
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let securityInstance = null;
+/**
+ * Get the singleton GroupSecurityManager instance.
+ */
+export function getGroupSecurity(config) {
+    if (!securityInstance) {
+        securityInstance = new GroupSecurityManager(config);
+    }
+    return securityInstance;
+}
+/**
+ * Reset the singleton GroupSecurityManager (for testing).
+ */
+export function resetGroupSecurity() {
+    if (securityInstance) {
+        securityInstance.dispose();
+    }
+    securityInstance = null;
+}
+//# sourceMappingURL=group-security.js.map

package/dist/channels/group-security.js.map

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

package/dist/channels/index.d.ts

@@ -9,7 +9,7 @@ import type { CanonicalIdentity } from './identity-links.js';
 /**
  * Supported channel types
  */
-export type ChannelType = 'telegram' | 'discord' | 'slack' | 'whatsapp' | 'signal' | 'matrix' | 'cli' | 'web' | 'api';
+export type ChannelType = 'telegram' | 'discord' | 'slack' | 'whatsapp' | 'signal' | 'matrix' | 'google-chat' | 'teams' | 'webchat' | 'cli' | 'web' | 'api';
 /**
  * Message direction
  */
@@ -414,6 +414,22 @@ export type { RouteAgentConfig, PeerRoute, RouteCondition, ResolvedRoute, PeerRo
 export { PeerRouter, getPeerRouter, resetPeerRouter, } from './peer-routing.js';
 export type { PairingStatus, ApprovedSender, PairingRequest, DMPairingConfig, } from './dm-pairing.js';
 export { DEFAULT_DM_PAIRING_CONFIG, DMPairingManager, getDMPairing, resetDMPairing, } from './dm-pairing.js';
+export { WhatsAppChannel } from './whatsapp/index.js';
+export type { WhatsAppConfig, WhatsAppContact } from './whatsapp/index.js';
+export { SignalChannel } from './signal/index.js';
+export type { SignalConfig, SignalMessage, SignalAttachment, SignalGroup, } from './signal/index.js';
+export { GoogleChatChannel } from './google-chat/index.js';
+export type { GoogleChatConfig, GoogleChatSpace, GoogleChatUser, GoogleChatMessage, GoogleChatEvent, } from './google-chat/index.js';
+export { TeamsChannel } from './teams/index.js';
+export type { TeamsConfig, BotFrameworkActivity, BotFrameworkAccount, BotFrameworkConversation, BotFrameworkAttachment, ConversationReference, } from './teams/index.js';
+export { MatrixChannel } from './matrix/index.js';
+export type { MatrixConfig, MatrixRoom, MatrixEventContent, MatrixRoomEvent, } from './matrix/index.js';
+export { WebChatChannel } from './webchat/index.js';
+export type { WebChatConfig } from './webchat/index.js';
+export { ReconnectionManager } from './reconnection-manager.js';
+export type { ReconnectionConfig, ReconnectionEvents } from './reconnection-manager.js';
+export { OfflineQueue } from './offline-queue.js';
+export type { QueuedMessage } from './offline-queue.js';
 import { LaneQueue } from '../concurrency/lane-queue.js';
 import type { TaskOptions } from '../concurrency/lane-queue.js';
 /**

package/dist/channels/index.js

@@ -461,6 +461,22 @@ export { DEFAULT_SESSION_ISOLATION_CONFIG, SessionIsolator, getSessionIsolator,
 export { IdentityLinker, getIdentityLinker, resetIdentityLinker, } from './identity-links.js';
 export { PeerRouter, getPeerRouter, resetPeerRouter, } from './peer-routing.js';
 export { DEFAULT_DM_PAIRING_CONFIG, DMPairingManager, getDMPairing, resetDMPairing, } from './dm-pairing.js';
+// WhatsApp
+export { WhatsAppChannel } from './whatsapp/index.js';
+// Signal
+export { SignalChannel } from './signal/index.js';
+// Google Chat
+export { GoogleChatChannel } from './google-chat/index.js';
+// Microsoft Teams
+export { TeamsChannel } from './teams/index.js';
+// Matrix
+export { MatrixChannel } from './matrix/index.js';
+// WebChat
+export { WebChatChannel } from './webchat/index.js';
+// Reconnection Manager
+export { ReconnectionManager } from './reconnection-manager.js';
+// Offline Queue
+export { OfflineQueue } from './offline-queue.js';
 // ============================================================================
 // Lane Queue Helpers
 // ============================================================================