clodds 1.1.0

package/dist/auto-reply/index.js

@@ -0,0 +1,391 @@
+"use strict";
+/**
+ * Auto-Reply System - Clawdbot-style automatic responses
+ *
+ * Features:
+ * - Rule-based auto-responses
+ * - Pattern matching (regex, keywords, exact)
+ * - Cooldowns per user/channel
+ * - Time-based rules (only active during certain hours)
+ * - Priority-based rule matching
+ * - Response templates with variables
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exampleRules = exports.ruleBuilder = void 0;
+exports.createAutoReplyService = createAutoReplyService;
+const eventemitter3_1 = require("eventemitter3");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const RULES_FILE = (0, path_1.join)((0, os_1.homedir)(), '.clodds', 'auto-reply-rules.json');
+// =============================================================================
+// HELPERS
+// =============================================================================
+/** Check if current time is within time window */
+function isWithinTimeWindow(window) {
+    const now = new Date();
+    const hour = now.getHours();
+    const day = now.getDay();
+    // Check day of week
+    if (window.days && !window.days.includes(day)) {
+        return false;
+    }
+    // Check hour range
+    if (window.startHour <= window.endHour) {
+        // Normal range (e.g., 9-17)
+        return hour >= window.startHour && hour < window.endHour;
+    }
+    else {
+        // Overnight range (e.g., 22-6)
+        return hour >= window.startHour || hour < window.endHour;
+    }
+}
+/** Match message against condition */
+function matchCondition(text, condition) {
+    const testText = condition.ignoreCase ? text.toLowerCase() : text;
+    const pattern = condition.pattern
+        ? (condition.ignoreCase ? condition.pattern.toLowerCase() : condition.pattern)
+        : '';
+    switch (condition.type) {
+        case 'exact':
+            return { matched: testText === pattern, captures: [] };
+        case 'contains':
+            return { matched: testText.includes(pattern), captures: [] };
+        case 'startsWith':
+            return { matched: testText.startsWith(pattern), captures: [] };
+        case 'endsWith':
+            return { matched: testText.endsWith(pattern), captures: [] };
+        case 'regex': {
+            if (!condition.pattern)
+                return { matched: false, captures: [] };
+            try {
+                const flags = condition.ignoreCase ? 'i' : '';
+                const regex = new RegExp(condition.pattern, flags);
+                const match = text.match(regex);
+                return {
+                    matched: !!match,
+                    captures: match ? match.slice(1) : [],
+                };
+            }
+            catch {
+                return { matched: false, captures: [] };
+            }
+        }
+        case 'keywords': {
+            const keywords = condition.keywords || [];
+            const minKeywords = condition.minKeywords || 1;
+            const matched = keywords.filter(kw => {
+                const kwLower = condition.ignoreCase ? kw.toLowerCase() : kw;
+                return testText.includes(kwLower);
+            });
+            return {
+                matched: matched.length >= minKeywords,
+                captures: matched,
+            };
+        }
+        default:
+            return { matched: false, captures: [] };
+    }
+}
+/** Replace template variables */
+function replaceVariables(template, variables) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => variables[key] || `{${key}}`);
+}
+// =============================================================================
+// SERVICE IMPLEMENTATION
+// =============================================================================
+function createAutoReplyService() {
+    const emitter = new eventemitter3_1.EventEmitter();
+    const rules = new Map();
+    const cooldowns = new Map(); // ruleId:userId -> timestamp
+    /** Get cooldown key */
+    function getCooldownKey(ruleId, userId, perUser) {
+        return perUser ? `${ruleId}:${userId}` : ruleId;
+    }
+    /** Check if rule is on cooldown */
+    function isOnCooldown(rule, userId) {
+        if (!rule.cooldownMs)
+            return false;
+        const key = getCooldownKey(rule.id, userId, rule.perUserCooldown || false);
+        const lastTriggered = cooldowns.get(key);
+        if (lastTriggered && Date.now() - lastTriggered < rule.cooldownMs) {
+            return true;
+        }
+        return false;
+    }
+    /** Set cooldown for rule */
+    function setCooldown(rule, userId) {
+        if (!rule.cooldownMs)
+            return;
+        const key = getCooldownKey(rule.id, userId, rule.perUserCooldown || false);
+        cooldowns.set(key, Date.now());
+    }
+    const service = {
+        addRule(rule) {
+            rules.set(rule.id, rule);
+            logger_1.logger.debug({ ruleId: rule.id, name: rule.name }, 'Auto-reply rule added');
+        },
+        removeRule(ruleId) {
+            const existed = rules.delete(ruleId);
+            if (existed) {
+                logger_1.logger.debug({ ruleId }, 'Auto-reply rule removed');
+            }
+            return existed;
+        },
+        updateRule(ruleId, updates) {
+            const rule = rules.get(ruleId);
+            if (!rule)
+                return false;
+            Object.assign(rule, updates);
+            logger_1.logger.debug({ ruleId }, 'Auto-reply rule updated');
+            return true;
+        },
+        getRule(ruleId) {
+            return rules.get(ruleId) || null;
+        },
+        listRules() {
+            return Array.from(rules.values()).sort((a, b) => b.priority - a.priority);
+        },
+        enableRule(ruleId) {
+            const rule = rules.get(ruleId);
+            if (!rule)
+                return false;
+            rule.enabled = true;
+            return true;
+        },
+        disableRule(ruleId) {
+            const rule = rules.get(ruleId);
+            if (!rule)
+                return false;
+            rule.enabled = false;
+            return true;
+        },
+        async process(message) {
+            const result = this.check(message);
+            if (!result)
+                return null;
+            // Check cooldown
+            if (isOnCooldown(result.rule, message.userId)) {
+                emitter.emit('rule:cooldown', result.rule.id, message);
+                return null;
+            }
+            // Set cooldown
+            setCooldown(result.rule, message.userId);
+            // Format response
+            const responseText = this.formatResponse(result, message);
+            emitter.emit('rule:matched', result.rule.id, message, responseText);
+            // Handle delay
+            if (result.rule.response.delay) {
+                await new Promise(r => setTimeout(r, result.rule.response.delay));
+            }
+            return result;
+        },
+        check(message) {
+            const sortedRules = Array.from(rules.values())
+                .filter(r => r.enabled)
+                .sort((a, b) => b.priority - a.priority);
+            for (const rule of sortedRules) {
+                // Check channel filter
+                if (rule.channels && !rule.channels.includes(message.platform)) {
+                    continue;
+                }
+                // Check user filter
+                if (rule.users && !rule.users.includes(message.userId)) {
+                    continue;
+                }
+                // Check user exclusion
+                if (rule.excludeUsers && rule.excludeUsers.includes(message.userId)) {
+                    continue;
+                }
+                // Check time window
+                if (rule.timeWindow && !isWithinTimeWindow(rule.timeWindow)) {
+                    continue;
+                }
+                // Match all conditions
+                const matches = [];
+                const variables = {};
+                let allMatched = true;
+                for (let i = 0; i < rule.conditions.length; i++) {
+                    const condition = rule.conditions[i];
+                    const result = matchCondition(message.text, condition);
+                    if (!result.matched) {
+                        allMatched = false;
+                        break;
+                    }
+                    matches.push(...result.captures);
+                    result.captures.forEach((cap, j) => {
+                        variables[`match${i}_${j}`] = cap;
+                        variables[`$${i + 1}`] = cap; // Numbered backreference
+                    });
+                }
+                if (allMatched) {
+                    return { rule, matches, variables };
+                }
+            }
+            return null;
+        },
+        formatResponse(result, message) {
+            const { rule, matches, variables } = result;
+            // Built-in variables
+            const allVars = {
+                ...variables,
+                user: message.userId,
+                username: message.userId,
+                channel: message.platform,
+                text: message.text,
+                time: new Date().toLocaleTimeString(),
+                date: new Date().toLocaleDateString(),
+                matches: matches.join(', '),
+            };
+            // Add numbered matches
+            matches.forEach((m, i) => {
+                allVars[`match${i}`] = m;
+            });
+            return replaceVariables(rule.response.content, allVars);
+        },
+        save() {
+            const data = Array.from(rules.values());
+            (0, fs_1.writeFileSync)(RULES_FILE, JSON.stringify(data, null, 2));
+            logger_1.logger.debug({ count: data.length }, 'Auto-reply rules saved');
+        },
+        load() {
+            try {
+                if ((0, fs_1.existsSync)(RULES_FILE)) {
+                    const data = JSON.parse((0, fs_1.readFileSync)(RULES_FILE, 'utf-8'));
+                    rules.clear();
+                    for (const rule of data) {
+                        rules.set(rule.id, rule);
+                    }
+                    logger_1.logger.debug({ count: data.length }, 'Auto-reply rules loaded');
+                }
+            }
+            catch (e) {
+                logger_1.logger.error({ error: e }, 'Failed to load auto-reply rules');
+            }
+        },
+        clearCooldowns() {
+            cooldowns.clear();
+        },
+        on(event, fn) {
+            emitter.on(event, fn);
+        },
+        off(event, fn) {
+            emitter.off(event, fn);
+        },
+    };
+    // Load rules on init
+    service.load();
+    return service;
+}
+// =============================================================================
+// RULE BUILDERS
+// =============================================================================
+/** Helper to create rules */
+exports.ruleBuilder = {
+    /** Create a simple keyword response rule */
+    keyword(id, name, keywords, response, options) {
+        return {
+            id,
+            name,
+            enabled: true,
+            priority: 0,
+            conditions: [{
+                    type: 'keywords',
+                    keywords,
+                    ignoreCase: true,
+                    minKeywords: 1,
+                }],
+            response: { type: 'text', content: response },
+            ...options,
+        };
+    },
+    /** Create a regex capture rule */
+    regex(id, name, pattern, response, options) {
+        return {
+            id,
+            name,
+            enabled: true,
+            priority: 0,
+            conditions: [{
+                    type: 'regex',
+                    pattern,
+                    ignoreCase: true,
+                }],
+            response: { type: 'text', content: response },
+            ...options,
+        };
+    },
+    /** Create an exact match rule */
+    exact(id, name, text, response, options) {
+        return {
+            id,
+            name,
+            enabled: true,
+            priority: 10, // Higher priority for exact matches
+            conditions: [{
+                    type: 'exact',
+                    pattern: text,
+                    ignoreCase: true,
+                }],
+            response: { type: 'text', content: response },
+            stopOnMatch: true,
+            ...options,
+        };
+    },
+    /** Create a greeting rule (time-aware) */
+    greeting(id, keywords, morningResponse, afternoonResponse, eveningResponse) {
+        const hour = new Date().getHours();
+        let response;
+        if (hour < 12)
+            response = morningResponse;
+        else if (hour < 17)
+            response = afternoonResponse;
+        else
+            response = eveningResponse;
+        return {
+            id,
+            name: 'Greeting',
+            enabled: true,
+            priority: 5,
+            conditions: [{
+                    type: 'keywords',
+                    keywords,
+                    ignoreCase: true,
+                }],
+            response: { type: 'text', content: response },
+            cooldownMs: 60000, // 1 minute cooldown
+            perUserCooldown: true,
+        };
+    },
+    /** Create an away message rule */
+    awayMessage(id, response, startHour, endHour, days) {
+        return {
+            id,
+            name: 'Away Message',
+            enabled: true,
+            priority: 100, // High priority
+            conditions: [{
+                    type: 'regex',
+                    pattern: '.*', // Match everything
+                }],
+            response: { type: 'text', content: response },
+            timeWindow: { startHour, endHour, days },
+            cooldownMs: 300000, // 5 minute cooldown per user
+            perUserCooldown: true,
+        };
+    },
+};
+// =============================================================================
+// EXAMPLE RULES
+// =============================================================================
+exports.exampleRules = [
+    exports.ruleBuilder.keyword('faq-hours', 'Business Hours FAQ', ['hours', 'open', 'close', 'when'], 'Our hours are Monday-Friday 9am-5pm EST. Is there something specific I can help you with?', { cooldownMs: 30000 }),
+    exports.ruleBuilder.regex('price-query', 'Price Query', 'how much (?:is|does|for) (.+?)\\??$', 'I\'d be happy to help with pricing for {$1}. Let me check that for you...'),
+    exports.ruleBuilder.exact('hello', 'Hello Response', 'hello', 'Hello {username}! How can I help you today?'),
+    exports.ruleBuilder.keyword('thanks', 'Thanks Response', ['thank', 'thanks', 'thx', 'ty'], 'You\'re welcome! Let me know if you need anything else.', { cooldownMs: 60000, perUserCooldown: true }),
+];
+//# sourceMappingURL=index.js.map

package/dist/auto-reply/index.js.map

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

package/dist/automation/cron.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Cron Jobs - Clawdbot-style scheduled tasks
+ *
+ * Features:
+ * - Cron expression support (standard 5-field format)
+ * - Timezone-aware scheduling
+ * - Per-user scheduled tasks
+ * - Built-in jobs: daily summaries, market alerts
+ */
+/** Cron job definition */
+export interface CronJob {
+    id: string;
+    /** Cron expression: "minute hour day month weekday" */
+    schedule: string;
+    /** Job handler function */
+    handler: () => Promise<void>;
+    /** Optional timezone (default: UTC) */
+    timezone?: string;
+    /** Whether job is enabled */
+    enabled: boolean;
+    /** Last run timestamp */
+    lastRun?: Date;
+    /** Next scheduled run */
+    nextRun?: Date;
+}
+export interface CronScheduler {
+    /** Add a new cron job */
+    add(id: string, schedule: string, handler: () => Promise<void>, options?: {
+        timezone?: string;
+        enabled?: boolean;
+    }): void;
+    /** Remove a cron job */
+    remove(id: string): boolean;
+    /** Enable/disable a job */
+    setEnabled(id: string, enabled: boolean): void;
+    /** Get all jobs */
+    list(): CronJob[];
+    /** Get a specific job */
+    get(id: string): CronJob | undefined;
+    /** Start the scheduler */
+    start(): void;
+    /** Stop the scheduler */
+    stop(): void;
+    /** Manually trigger a job */
+    trigger(id: string): Promise<void>;
+}
+export declare function createCronScheduler(): CronScheduler;
+/** Common cron schedules */
+export declare const CronSchedules: {
+    /** Every minute */
+    EVERY_MINUTE: string;
+    /** Every 5 minutes */
+    EVERY_5_MINUTES: string;
+    /** Every 15 minutes */
+    EVERY_15_MINUTES: string;
+    /** Every hour */
+    HOURLY: string;
+    /** Every day at midnight */
+    DAILY_MIDNIGHT: string;
+    /** Every day at 9am */
+    DAILY_9AM: string;
+    /** Every Monday at 9am */
+    WEEKLY_MONDAY_9AM: string;
+    /** First of every month at midnight */
+    MONTHLY: string;
+};