nduka 1.0.0

package/dist/ai/execution-controller.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,3 @@
+export { AIExecutionController } from './execution-controller.js';
+export type { ActiveGeneration } from './execution-controller.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,2 @@
+export { AIExecutionController } from './execution-controller.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/ai-context/engine.d.ts

@@ -0,0 +1,85 @@
+/**
+ * AI Context Isolation Engine
+ *
+ * Ensures conversation context is strictly isolated per chat.
+ * Prevents memory poisoning, cross-conversation leakage, and
+ * context window explosions.
+ *
+ * Implements:
+ *  - Per-chat message windows (last N messages)
+ *  - Thread-safe context access
+ *  - Context trimming strategies
+ *  - Cross-conversation isolation verification
+ */
+import type { Message } from '../llm/types.js';
+export interface ConversationWindow {
+    chatJid: string;
+    messages: Message[];
+    maxMessages: number;
+    lastUpdatedAt: number;
+    metadata: Record<string, unknown>;
+}
+export interface ContextLeakReport {
+    sourceChat: string;
+    targetChat: string;
+    leaked: boolean;
+    details: string;
+}
+export declare class AIContextEngine {
+    private conversations;
+    private maxMessages;
+    constructor(maxMessages?: number);
+    /**
+     * Add a message to a conversation window.
+     * Automatically trims oldest messages when limit exceeded.
+     */
+    addMessage(chatJid: string, role: 'user' | 'assistant' | 'system', content: string): void;
+    /**
+     * Get the full conversation context for a chat.
+     * Returns messages in chronological order.
+     */
+    getContext(chatJid: string): Message[];
+    /**
+     * Get conversation context as a string (for system prompts).
+     */
+    getContextString(chatJid: string): string;
+    /**
+     * Get the last N messages for a chat.
+     */
+    getLastMessages(chatJid: string, n: number): Message[];
+    /**
+     * Verify strict isolation between two chats.
+     * Messages from chat A must never appear in chat B's context.
+     */
+    verifyIsolation(chatA: string, chatB: string): ContextLeakReport;
+    /**
+     * Verify all conversations are isolated from each other.
+     */
+    verifyAllIsolation(): ContextLeakReport[];
+    /**
+     * Simulate interleaved messages from 3 conversations.
+     * Verifies no context corruption occurs.
+     */
+    simulateInterleaved(chatA: string, chatB: string, chatC: string): {
+        aMessages: number;
+        bMessages: number;
+        cMessages: number;
+        anyLeak: boolean;
+    };
+    /**
+     * Clear context for a specific chat.
+     */
+    clearContext(chatJid: string): void;
+    /**
+     * Get all tracked chat JIDs.
+     */
+    getTrackedChats(): string[];
+    /**
+     * Get total message count across all conversations.
+     */
+    getTotalMessageCount(): number;
+    /** Reset all state. */
+    reset(): void;
+    private findOldestChat;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/ai-context/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/ai-context/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,SAAuB;IAI9C;;;OAGG;IACH,UAAU,CACR,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,EACrC,OAAO,EAAE,MAAM,GACd,IAAI;IA4BP;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;IAMtC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IASzC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAKtD;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAkChE;;OAEG;IACH,kBAAkB,IAAI,iBAAiB,EAAE;IAazC;;;OAGG;IACH,mBAAmB,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;KAClB;IAoBD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAQ9B,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,cAAc;CAWvB"}

package/dist/ai-context/engine.js

@@ -0,0 +1,173 @@
+// ─── Config ──────────────────────────────────────────────────────────────────
+const DEFAULT_MAX_MESSAGES = 100;
+const MAX_CONTEXT_CHATS = 10_000;
+// ─── AI Context Engine ───────────────────────────────────────────────────────
+export class AIContextEngine {
+    conversations = new Map();
+    maxMessages;
+    constructor(maxMessages = DEFAULT_MAX_MESSAGES) {
+        this.maxMessages = maxMessages;
+    }
+    /**
+     * Add a message to a conversation window.
+     * Automatically trims oldest messages when limit exceeded.
+     */
+    addMessage(chatJid, role, content) {
+        let window = this.conversations.get(chatJid);
+        if (!window) {
+            window = {
+                chatJid,
+                messages: [],
+                maxMessages: this.maxMessages,
+                lastUpdatedAt: Date.now(),
+                metadata: {},
+            };
+            this.conversations.set(chatJid, window);
+            // Evict oldest chat if at capacity
+            if (this.conversations.size > MAX_CONTEXT_CHATS) {
+                const oldest = this.findOldestChat();
+                if (oldest)
+                    this.conversations.delete(oldest);
+            }
+        }
+        window.messages.push({ role, content });
+        window.lastUpdatedAt = Date.now();
+        // Trim if exceeded
+        while (window.messages.length > window.maxMessages) {
+            window.messages.shift();
+        }
+    }
+    /**
+     * Get the full conversation context for a chat.
+     * Returns messages in chronological order.
+     */
+    getContext(chatJid) {
+        const window = this.conversations.get(chatJid);
+        if (!window)
+            return [];
+        return [...window.messages];
+    }
+    /**
+     * Get conversation context as a string (for system prompts).
+     */
+    getContextString(chatJid) {
+        const messages = this.getContext(chatJid);
+        if (messages.length === 0)
+            return '';
+        return messages
+            .map((m) => `[${m.role.toUpperCase()}]: ${m.content}`)
+            .join('\n');
+    }
+    /**
+     * Get the last N messages for a chat.
+     */
+    getLastMessages(chatJid, n) {
+        const messages = this.getContext(chatJid);
+        return messages.slice(-n);
+    }
+    /**
+     * Verify strict isolation between two chats.
+     * Messages from chat A must never appear in chat B's context.
+     */
+    verifyIsolation(chatA, chatB) {
+        const contextA = this.conversations.get(chatA);
+        const contextB = this.conversations.get(chatB);
+        if (!contextA || !contextB) {
+            return {
+                sourceChat: chatA,
+                targetChat: chatB,
+                leaked: false,
+                details: 'One or both chats have no context',
+            };
+        }
+        // Check: any message from B appears in A?
+        const bMessages = new Set(contextB.messages.map((m) => m.content));
+        for (const msg of contextA.messages) {
+            if (typeof msg.content === 'string' && bMessages.has(msg.content)) {
+                return {
+                    sourceChat: chatA,
+                    targetChat: chatB,
+                    leaked: true,
+                    details: `Message leaked: "${msg.content.slice(0, 50)}..."`,
+                };
+            }
+        }
+        return {
+            sourceChat: chatA,
+            targetChat: chatB,
+            leaked: false,
+            details: 'Contexts are isolated',
+        };
+    }
+    /**
+     * Verify all conversations are isolated from each other.
+     */
+    verifyAllIsolation() {
+        const reports = [];
+        const chatIds = Array.from(this.conversations.keys());
+        for (let i = 0; i < chatIds.length; i++) {
+            for (let j = i + 1; j < chatIds.length; j++) {
+                reports.push(this.verifyIsolation(chatIds[i], chatIds[j]));
+            }
+        }
+        return reports;
+    }
+    /**
+     * Simulate interleaved messages from 3 conversations.
+     * Verifies no context corruption occurs.
+     */
+    simulateInterleaved(chatA, chatB, chatC) {
+        // Interleave: A, B, A, C, B pattern
+        const sequence = [chatA, chatB, chatA, chatC, chatB, chatA, chatC, chatB, chatC, chatA];
+        for (let i = 0; i < sequence.length; i++) {
+            this.addMessage(sequence[i], 'user', `Message ${i} in ${sequence[i]}`);
+        }
+        // Verify isolation
+        const leaks = this.verifyAllIsolation();
+        const anyLeak = leaks.some((l) => l.leaked);
+        return {
+            aMessages: this.getContext(chatA).length,
+            bMessages: this.getContext(chatB).length,
+            cMessages: this.getContext(chatC).length,
+            anyLeak,
+        };
+    }
+    /**
+     * Clear context for a specific chat.
+     */
+    clearContext(chatJid) {
+        this.conversations.delete(chatJid);
+    }
+    /**
+     * Get all tracked chat JIDs.
+     */
+    getTrackedChats() {
+        return Array.from(this.conversations.keys());
+    }
+    /**
+     * Get total message count across all conversations.
+     */
+    getTotalMessageCount() {
+        let count = 0;
+        for (const window of this.conversations.values()) {
+            count += window.messages.length;
+        }
+        return count;
+    }
+    /** Reset all state. */
+    reset() {
+        this.conversations.clear();
+    }
+    findOldestChat() {
+        let oldest;
+        let oldestTime = Infinity;
+        for (const [jid, window] of this.conversations) {
+            if (window.lastUpdatedAt < oldestTime) {
+                oldestTime = window.lastUpdatedAt;
+                oldest = jid;
+            }
+        }
+        return oldest;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/ai-context/engine.js.map

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

package/dist/ai-context/index.d.ts

@@ -0,0 +1,3 @@
+export { AIContextEngine } from './engine.js';
+export type { ConversationWindow, ContextLeakReport } from './engine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/ai-context/index.js

@@ -0,0 +1,2 @@
+export { AIContextEngine } from './engine.js';
+//# sourceMappingURL=index.js.map

package/dist/ai-context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/ai-router/index.d.ts

@@ -0,0 +1,3 @@
+export { AiRouter } from './router.js';
+export type { MessageClassification, ClassificationResult, RateLimitResult, CooldownResult, RouterDecision, } from './router.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/ai-router/index.js

@@ -0,0 +1,2 @@
+export { AiRouter } from './router.js';
+//# sourceMappingURL=index.js.map

package/dist/ai-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/ai-router/router.d.ts

@@ -0,0 +1,68 @@
+/**
+ * AI Safety Router
+ *
+ * Pre-classifies every message and enforces safety guardrails:
+ *  - Rate limiting (per user, per chat)
+ *  - Cooldowns between AI responses
+ *  - Spam detection
+ *  - Prompt injection detection
+ *  - Self-reference detection
+ *
+ * Maximum AI response chain: 1
+ * If AI generated the previous message, AI cannot auto-respond.
+ */
+import type { MessageReceivedPayload } from '../event-bus/index.js';
+export type MessageClassification = 'human_chat' | 'ai_candidate' | 'command' | 'system_event' | 'media' | 'voice_note' | 'spam' | 'prompt_injection' | 'self_reference';
+export interface ClassificationResult {
+    class: MessageClassification;
+    confidence: number;
+    reasons: string[];
+}
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: number;
+    reason: string | null;
+}
+export interface CooldownResult {
+    allowed: boolean;
+    remainingMs: number;
+    reason: string | null;
+}
+export interface RouterDecision {
+    /** Should AI process this message? */
+    routeToAi: boolean;
+    /** Classification of the message */
+    classification: ClassificationResult;
+    /** Rate limit check */
+    rateLimit: RateLimitResult;
+    /** Cooldown check */
+    cooldown: CooldownResult;
+    /** Reasons for denial (if any) */
+    denialReasons: string[];
+}
+export declare class AiRouter {
+    private userRateCounters;
+    private chatRateCounters;
+    private lastResponseTime;
+    private lastChatResponseTime;
+    private lastGlobalResponseTime;
+    /**
+     * Make a routing decision for a message — should AI process it?
+     */
+    decide(payload: MessageReceivedPayload): RouterDecision;
+    /** Record that AI sent a response (updates cooldowns). */
+    recordResponse(senderJid: string, chatJid: string): void;
+    /**
+     * Classify a message.
+     */
+    classify(payload: MessageReceivedPayload): ClassificationResult;
+    private checkRateLimit;
+    private checkCooldown;
+    private getOrCreateRateCounter;
+    private isSpam;
+    private isCommand;
+    /** Reset all state (for testing). */
+    reset(): void;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/ai-router/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/ai-router/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAIpE,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,cAAc,GACd,SAAS,GACT,cAAc,GACd,OAAO,GACP,YAAY,GACZ,MAAM,GACN,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,cAAc,EAAE,oBAAoB,CAAC;IACrC,uBAAuB;IACvB,SAAS,EAAE,eAAe,CAAC;IAC3B,qBAAqB;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,kCAAkC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAkCD,qBAAa,QAAQ;IAEnB,OAAO,CAAC,gBAAgB,CAAkE;IAC1F,OAAO,CAAC,gBAAgB,CAAkE;IAG1F,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,oBAAoB,CAAkC;IAC9D,OAAO,CAAC,sBAAsB,CAAK;IAEnC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc;IAoCvD,0DAA0D;IAC1D,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOxD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,oBAAoB;IAwE/D,OAAO,CAAC,cAAc;IAuDtB,OAAO,CAAC,aAAa;IA0CrB,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,MAAM;IAiBd,OAAO,CAAC,SAAS;IAajB,qCAAqC;IACrC,KAAK,IAAI,IAAI;CAOd"}

package/dist/ai-router/router.js

@@ -0,0 +1,260 @@
+// ─── Config ──────────────────────────────────────────────────────────────────
+const RATE_LIMIT = {
+    maxPerUserPerMinute: 10,
+    maxPerChatPerMinute: 30,
+    windowMs: 60_000,
+};
+const COOLDOWN_MS = {
+    perUser: 5_000, // 5 seconds between AI responses to same user
+    perChat: 2_000, // 2 seconds between AI responses in same chat
+    global: 500, // 500ms global minimum
+};
+const PROMPT_INJECTION_PATTERNS = [
+    /(?:ignore|forget|disregard)\s+(?:all\s+)?(?:previous|prior|above)\s+(?:instructions?|prompts?|rules?)/i,
+    /you\s+are\s+now\s+(?:a\s+)?(?:DAN|jailbreak|evil|unethical)/i,
+    /system\s*(?:prompt|message|instruction):/i,
+    /<\|im_start\|>/i,
+    /\[system\]/i,
+    /pretend\s+(?:you\s+are|to\s+be)/i,
+    /respond\s+(?:as|like)\s+(?:if\s+you\s+were)/i,
+];
+const SELF_REFERENCE_PATTERNS = [
+    /@ai\s+(?:summarize|repeat|echo)\s+your/i,
+    /what\s+did\s+(?:you|i)\s+just\s+say/i,
+    /respond\s+to\s+(?:yourself|your\s+own)/i,
+];
+// ─── AI Router ───────────────────────────────────────────────────────────────
+export class AiRouter {
+    // Rate limiting state
+    userRateCounters = new Map();
+    chatRateCounters = new Map();
+    // Cooldown state
+    lastResponseTime = new Map(); // user -> timestamp
+    lastChatResponseTime = new Map(); // chat -> timestamp
+    lastGlobalResponseTime = 0;
+    /**
+     * Make a routing decision for a message — should AI process it?
+     */
+    decide(payload) {
+        const denialReasons = [];
+        // Step 1: Classify the message
+        const classification = this.classify(payload);
+        if (classification.class === 'spam' || classification.class === 'prompt_injection') {
+            denialReasons.push(classification.class);
+        }
+        // Step 2: Check rate limits
+        const rateLimit = this.checkRateLimit(payload.senderJid, payload.chatJid);
+        if (!rateLimit.allowed) {
+            denialReasons.push(rateLimit.reason || 'rate_limited');
+        }
+        // Step 3: Check cooldowns
+        const cooldown = this.checkCooldown(payload.senderJid, payload.chatJid);
+        if (!cooldown.allowed) {
+            denialReasons.push(cooldown.reason || 'cooldown');
+        }
+        // Decision
+        const routeToAi = classification.class === 'ai_candidate' ||
+            classification.class === 'human_chat' ||
+            classification.class === 'command';
+        return {
+            routeToAi: routeToAi && denialReasons.length === 0,
+            classification,
+            rateLimit,
+            cooldown,
+            denialReasons,
+        };
+    }
+    /** Record that AI sent a response (updates cooldowns). */
+    recordResponse(senderJid, chatJid) {
+        const now = Date.now();
+        this.lastResponseTime.set(senderJid, now);
+        this.lastChatResponseTime.set(chatJid, now);
+        this.lastGlobalResponseTime = now;
+    }
+    /**
+     * Classify a message.
+     */
+    classify(payload) {
+        const text = payload.textContent || '';
+        // Check for prompt injection
+        for (const pattern of PROMPT_INJECTION_PATTERNS) {
+            if (pattern.test(text)) {
+                return {
+                    class: 'prompt_injection',
+                    confidence: 0.95,
+                    reasons: [`Matched injection pattern: ${pattern.source}`],
+                };
+            }
+        }
+        // Check for self-reference
+        for (const pattern of SELF_REFERENCE_PATTERNS) {
+            if (pattern.test(text)) {
+                return {
+                    class: 'self_reference',
+                    confidence: 0.8,
+                    reasons: ['Self-referential AI command detected'],
+                };
+            }
+        }
+        // Check for spam (repeated characters, excessive length, URL-only)
+        if (this.isSpam(text)) {
+            return {
+                class: 'spam',
+                confidence: 0.7,
+                reasons: ['Message appears to be spam'],
+            };
+        }
+        // Check for media/voice indicators
+        if (payload.messageType === 'imageMessage' ||
+            payload.messageType === 'videoMessage' ||
+            payload.messageType === 'documentMessage') {
+            return {
+                class: 'media',
+                confidence: 1.0,
+                reasons: ['Media message detected'],
+            };
+        }
+        if (payload.messageType === 'audioMessage') {
+            return {
+                class: 'voice_note',
+                confidence: 1.0,
+                reasons: ['Voice note detected'],
+            };
+        }
+        // Check for command-like messages
+        if (this.isCommand(text)) {
+            return {
+                class: 'command',
+                confidence: 0.85,
+                reasons: ['Message appears to be a command'],
+            };
+        }
+        // Default: human chat, candidate for AI
+        return {
+            class: 'ai_candidate',
+            confidence: 0.6,
+            reasons: ['Regular text message'],
+        };
+    }
+    // ─── Rate Limiting ──────────────────────────────────────────────────────
+    checkRateLimit(senderJid, chatJid) {
+        const now = Date.now();
+        // Per-user rate limit
+        const userState = this.getOrCreateRateCounter(this.userRateCounters, senderJid);
+        if (now - userState.windowStart > RATE_LIMIT.windowMs) {
+            userState.count = 0;
+            userState.windowStart = now;
+        }
+        if (userState.count >= RATE_LIMIT.maxPerUserPerMinute) {
+            return {
+                allowed: false,
+                remaining: 0,
+                resetAt: userState.windowStart + RATE_LIMIT.windowMs,
+                reason: `User rate limit exceeded (${RATE_LIMIT.maxPerUserPerMinute}/min)`,
+            };
+        }
+        // Per-chat rate limit
+        const chatState = this.getOrCreateRateCounter(this.chatRateCounters, chatJid);
+        if (now - chatState.windowStart > RATE_LIMIT.windowMs) {
+            chatState.count = 0;
+            chatState.windowStart = now;
+        }
+        if (chatState.count >= RATE_LIMIT.maxPerChatPerMinute) {
+            return {
+                allowed: false,
+                remaining: 0,
+                resetAt: chatState.windowStart + RATE_LIMIT.windowMs,
+                reason: `Chat rate limit exceeded (${RATE_LIMIT.maxPerChatPerMinute}/min)`,
+            };
+        }
+        // Increment counters
+        userState.count++;
+        chatState.count++;
+        return {
+            allowed: true,
+            remaining: Math.min(RATE_LIMIT.maxPerUserPerMinute - userState.count, RATE_LIMIT.maxPerChatPerMinute - chatState.count),
+            resetAt: Math.min(userState.windowStart + RATE_LIMIT.windowMs, chatState.windowStart + RATE_LIMIT.windowMs),
+            reason: null,
+        };
+    }
+    // ─── Cooldowns ──────────────────────────────────────────────────────────
+    checkCooldown(senderJid, chatJid) {
+        const now = Date.now();
+        // Global cooldown
+        const globalElapsed = now - this.lastGlobalResponseTime;
+        if (globalElapsed < COOLDOWN_MS.global) {
+            return {
+                allowed: false,
+                remainingMs: COOLDOWN_MS.global - globalElapsed,
+                reason: 'Global cooldown active',
+            };
+        }
+        // Per-user cooldown
+        const userLast = this.lastResponseTime.get(senderJid);
+        if (userLast && now - userLast < COOLDOWN_MS.perUser) {
+            return {
+                allowed: false,
+                remainingMs: COOLDOWN_MS.perUser - (now - userLast),
+                reason: 'Per-user cooldown active',
+            };
+        }
+        // Per-chat cooldown
+        const chatLast = this.lastChatResponseTime.get(chatJid);
+        if (chatLast && now - chatLast < COOLDOWN_MS.perChat) {
+            return {
+                allowed: false,
+                remainingMs: COOLDOWN_MS.perChat - (now - chatLast),
+                reason: 'Per-chat cooldown active',
+            };
+        }
+        return {
+            allowed: true,
+            remainingMs: 0,
+            reason: null,
+        };
+    }
+    // ─── Private Helpers ────────────────────────────────────────────────────
+    getOrCreateRateCounter(map, key) {
+        let counter = map.get(key);
+        if (!counter) {
+            counter = { count: 0, windowStart: Date.now() };
+            map.set(key, counter);
+        }
+        return counter;
+    }
+    isSpam(text) {
+        // Repeated characters (> 20 same chars)
+        if (/(.)\1{20,}/.test(text))
+            return true;
+        // URL-only messages
+        if (/^https?:\/\/\S+$/.test(text.trim()))
+            return true;
+        // Very short (< 2 chars non-whitespace)
+        if (text.trim().length < 2)
+            return true;
+        // Excessive special characters (> 30)
+        const specials = text.replace(/[a-zA-Z0-9\s]/g, '').length;
+        if (specials > 30)
+            return true;
+        return false;
+    }
+    isCommand(text) {
+        const lower = text.toLowerCase().trim();
+        return (lower.startsWith('/') ||
+            lower.startsWith('!') ||
+            lower.startsWith('@ai ') ||
+            lower.startsWith('hey ai') ||
+            lower === 'help' ||
+            lower === 'status' ||
+            lower === 'ping');
+    }
+    /** Reset all state (for testing). */
+    reset() {
+        this.userRateCounters.clear();
+        this.chatRateCounters.clear();
+        this.lastResponseTime.clear();
+        this.lastChatResponseTime.clear();
+        this.lastGlobalResponseTime = 0;
+    }
+}
+//# sourceMappingURL=router.js.map