@shuyhere/takotako 0.0.1

package/dist/core/rate-limiter.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Rate Limiter — sliding window counter for per-user, per-channel, and global rate limits.
+ *
+ * In-memory only, no external dependencies. Tracks request timestamps
+ * in a circular buffer per key.
+ */
+export interface RateLimitConfig {
+    /** Enable rate limiting (default: true). */
+    enabled: boolean;
+    /** Per-user limits. */
+    perUser: {
+        maxRequests: number;
+        windowMs: number;
+    };
+    /** Per-channel limits. */
+    perChannel: {
+        maxRequests: number;
+        windowMs: number;
+    };
+    /** Global limits. */
+    global: {
+        maxRequests: number;
+        windowMs: number;
+    };
+}
+export interface RateLimitResult {
+    /** Whether the request is allowed. */
+    allowed: boolean;
+    /** Seconds until the user can retry (if blocked). */
+    retryAfterSeconds: number;
+    /** Which limit was hit ('user' | 'channel' | 'global' | null). */
+    limitType: 'user' | 'channel' | 'global' | null;
+    /** Remaining requests in the most constrained window. */
+    remaining: number;
+}
+export declare class RateLimiter {
+    private config;
+    private userWindows;
+    private channelWindows;
+    private globalWindow;
+    constructor(config: RateLimitConfig);
+    /**
+     * Check if a request is allowed.
+     * @param userId - User identifier (Discord user ID, Telegram chat ID, etc.)
+     * @param channelId - Channel identifier
+     */
+    check(userId: string, channelId: string): RateLimitResult;
+    /**
+     * Reset all rate limit counters.
+     */
+    reset(): void;
+    /**
+     * Reset rate limits for a specific user.
+     */
+    resetUser(userId: string): void;
+    /**
+     * Get stats for debugging.
+     */
+    getStats(): {
+        users: number;
+        channels: number;
+    };
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/core/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/core/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,0BAA0B;IAC1B,UAAU,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,qBAAqB;IACrB,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;IAChD,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB;AAqDD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,YAAY,CAAgB;gBAExB,MAAM,EAAE,eAAe;IAKnC;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe;IAwEzD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAMhD"}

package/dist/core/rate-limiter.js

@@ -0,0 +1,142 @@
+/**
+ * Rate Limiter — sliding window counter for per-user, per-channel, and global rate limits.
+ *
+ * In-memory only, no external dependencies. Tracks request timestamps
+ * in a circular buffer per key.
+ */
+// ─── Sliding Window ─────────────────────────────────────────────────
+class SlidingWindow {
+    timestamps = [];
+    maxRequests;
+    windowMs;
+    constructor(maxRequests, windowMs) {
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+    }
+    /** Record a request and return whether it's allowed. */
+    check(now) {
+        // Prune old timestamps
+        const cutoff = now - this.windowMs;
+        this.timestamps = this.timestamps.filter((t) => t > cutoff);
+        if (this.timestamps.length >= this.maxRequests) {
+            // Calculate when the oldest request in window will expire
+            const oldestInWindow = this.timestamps[0];
+            const retryAfterMs = (oldestInWindow + this.windowMs) - now;
+            return {
+                allowed: false,
+                retryAfterMs: Math.max(0, retryAfterMs),
+                remaining: 0,
+            };
+        }
+        this.timestamps.push(now);
+        return {
+            allowed: true,
+            retryAfterMs: 0,
+            remaining: this.maxRequests - this.timestamps.length,
+        };
+    }
+    /** Get current count without recording. */
+    count(now) {
+        const cutoff = now - this.windowMs;
+        return this.timestamps.filter((t) => t > cutoff).length;
+    }
+    /** Reset this window. */
+    reset() {
+        this.timestamps = [];
+    }
+}
+// ─── Rate Limiter ───────────────────────────────────────────────────
+export class RateLimiter {
+    config;
+    userWindows = new Map();
+    channelWindows = new Map();
+    globalWindow;
+    constructor(config) {
+        this.config = config;
+        this.globalWindow = new SlidingWindow(config.global.maxRequests, config.global.windowMs);
+    }
+    /**
+     * Check if a request is allowed.
+     * @param userId - User identifier (Discord user ID, Telegram chat ID, etc.)
+     * @param channelId - Channel identifier
+     */
+    check(userId, channelId) {
+        if (!this.config.enabled) {
+            return { allowed: true, retryAfterSeconds: 0, limitType: null, remaining: Infinity };
+        }
+        const now = Date.now();
+        // Check global limit first
+        const globalResult = this.globalWindow.check(now);
+        if (!globalResult.allowed) {
+            // Undo the check (we didn't actually record it)
+            return {
+                allowed: false,
+                retryAfterSeconds: Math.ceil(globalResult.retryAfterMs / 1000),
+                limitType: 'global',
+                remaining: 0,
+            };
+        }
+        // Check per-channel limit
+        let channelWindow = this.channelWindows.get(channelId);
+        if (!channelWindow) {
+            channelWindow = new SlidingWindow(this.config.perChannel.maxRequests, this.config.perChannel.windowMs);
+            this.channelWindows.set(channelId, channelWindow);
+        }
+        const channelResult = channelWindow.check(now);
+        if (!channelResult.allowed) {
+            return {
+                allowed: false,
+                retryAfterSeconds: Math.ceil(channelResult.retryAfterMs / 1000),
+                limitType: 'channel',
+                remaining: 0,
+            };
+        }
+        // Check per-user limit
+        let userWindow = this.userWindows.get(userId);
+        if (!userWindow) {
+            userWindow = new SlidingWindow(this.config.perUser.maxRequests, this.config.perUser.windowMs);
+            this.userWindows.set(userId, userWindow);
+        }
+        const userResult = userWindow.check(now);
+        if (!userResult.allowed) {
+            return {
+                allowed: false,
+                retryAfterSeconds: Math.ceil(userResult.retryAfterMs / 1000),
+                limitType: 'user',
+                remaining: 0,
+            };
+        }
+        // All limits OK — return the most constrained remaining
+        const minRemaining = Math.min(globalResult.remaining, channelResult.remaining, userResult.remaining);
+        return {
+            allowed: true,
+            retryAfterSeconds: 0,
+            limitType: null,
+            remaining: minRemaining,
+        };
+    }
+    /**
+     * Reset all rate limit counters.
+     */
+    reset() {
+        this.userWindows.clear();
+        this.channelWindows.clear();
+        this.globalWindow.reset();
+    }
+    /**
+     * Reset rate limits for a specific user.
+     */
+    resetUser(userId) {
+        this.userWindows.delete(userId);
+    }
+    /**
+     * Get stats for debugging.
+     */
+    getStats() {
+        return {
+            users: this.userWindows.size,
+            channels: this.channelWindows.size,
+        };
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/core/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/core/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,uEAAuE;AAEvE,MAAM,aAAa;IACT,UAAU,GAAa,EAAE,CAAC;IAC1B,WAAW,CAAS;IACpB,QAAQ,CAAS;IAEzB,YAAY,WAAmB,EAAE,QAAgB;QAC/C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,GAAW;QACf,uBAAuB;QACvB,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/C,0DAA0D;YAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,YAAY,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC;gBACvC,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,CAAC;YACf,SAAS,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM;SACrD,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,GAAW;QACf,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;IAC1D,CAAC;IAED,yBAAyB;IACzB,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF;AAED,uEAAuE;AAEvE,MAAM,OAAO,WAAW;IACd,MAAM,CAAkB;IACxB,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;IAClD,YAAY,CAAgB;IAEpC,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3F,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAc,EAAE,SAAiB;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACvF,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,2BAA2B;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,gDAAgD;YAChD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC9D,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,IAAI,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,IAAI,aAAa,CAC/B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAClC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAChC,CAAC;YACF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC/D,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,IAAI,aAAa,CAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAC7B,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC5D,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,wDAAwD;QACxD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,YAAY,CAAC,SAAS,EACtB,aAAa,CAAC,SAAS,EACvB,UAAU,CAAC,SAAS,CACrB,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,CAAC;YACpB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,YAAY;SACxB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAC5B,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI;SACnC,CAAC;IACJ,CAAC;CACF"}

package/dist/core/reactions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Reaction feedback — use emoji reactions to signal agent state.
+ *
+ * - 👀 = received/processing
+ * - ⏳ = queued/waiting
+ * - ✅ = completed successfully
+ * - ❌ = failed
+ * - 🔄 = retrying
+ * - 🤔 = thinking/reasoning
+ */
+import type { Channel } from '../channels/channel.js';
+export type ReactionState = 'received' | 'processing' | 'completed' | 'failed' | 'retrying' | 'thinking';
+export interface ReactionConfig {
+    enabled: boolean;
+    reactions: Record<ReactionState, string>;
+}
+export declare class ReactionManager {
+    private config;
+    constructor(config?: Partial<ReactionConfig>);
+    /** Whether reactions are enabled. */
+    get enabled(): boolean;
+    /** Get the emoji for a given state. */
+    getEmoji(state: ReactionState): string;
+    /** React to a message with a state emoji. */
+    react(channel: Channel, chatId: string, messageId: string, state: ReactionState): Promise<void>;
+    /** Remove a previous reaction. */
+    unreact(channel: Channel, chatId: string, messageId: string, state: ReactionState): Promise<void>;
+    /** Transition reaction (remove old, add new). */
+    transition(channel: Channel, chatId: string, messageId: string, from: ReactionState, to: ReactionState): Promise<void>;
+}
+//# sourceMappingURL=reactions.d.ts.map

package/dist/core/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../src/core/reactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAItD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzG,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;CAC1C;AAeD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAOhD,qCAAqC;IACrC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IAItC,6CAA6C;IACvC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrG,kCAAkC;IAC5B,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvG,iDAAiD;IAC3C,UAAU,CACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,IAAI,CAAC;CAIjB"}

package/dist/core/reactions.js

@@ -0,0 +1,67 @@
+/**
+ * Reaction feedback — use emoji reactions to signal agent state.
+ *
+ * - 👀 = received/processing
+ * - ⏳ = queued/waiting
+ * - ✅ = completed successfully
+ * - ❌ = failed
+ * - 🔄 = retrying
+ * - 🤔 = thinking/reasoning
+ */
+// ─── Defaults ───────────────────────────────────────────────────────
+const DEFAULT_REACTIONS = {
+    received: '👋',
+    processing: '💭',
+    completed: '👍',
+    failed: '😅',
+    retrying: '🤞',
+    thinking: '🧐',
+};
+// ─── Implementation ─────────────────────────────────────────────────
+export class ReactionManager {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            reactions: { ...DEFAULT_REACTIONS, ...config.reactions },
+        };
+    }
+    /** Whether reactions are enabled. */
+    get enabled() {
+        return this.config.enabled;
+    }
+    /** Get the emoji for a given state. */
+    getEmoji(state) {
+        return this.config.reactions[state];
+    }
+    /** React to a message with a state emoji. */
+    async react(channel, chatId, messageId, state) {
+        if (!this.config.enabled || !channel.addReaction)
+            return;
+        const emoji = this.config.reactions[state];
+        try {
+            await channel.addReaction(chatId, messageId, emoji);
+        }
+        catch {
+            // Silently swallow — never break the agent loop due to reaction failures
+        }
+    }
+    /** Remove a previous reaction. */
+    async unreact(channel, chatId, messageId, state) {
+        if (!this.config.enabled || !channel.removeReaction)
+            return;
+        const emoji = this.config.reactions[state];
+        try {
+            await channel.removeReaction(chatId, messageId, emoji);
+        }
+        catch {
+            // Silently swallow
+        }
+    }
+    /** Transition reaction (remove old, add new). */
+    async transition(channel, chatId, messageId, from, to) {
+        await this.unreact(channel, chatId, messageId, from);
+        await this.react(channel, chatId, messageId, to);
+    }
+}
+//# sourceMappingURL=reactions.js.map

package/dist/core/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../../src/core/reactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,uEAAuE;AAEvE,MAAM,iBAAiB,GAAkC;IACvD,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF,uEAAuE;AAEvE,MAAM,OAAO,eAAe;IAClB,MAAM,CAAiB;IAE/B,YAAY,SAAkC,EAAE;QAC9C,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,SAAS,EAAE,EAAE,GAAG,iBAAiB,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE;SACzD,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,uCAAuC;IACvC,QAAQ,CAAC,KAAoB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,KAAK,CAAC,OAAgB,EAAE,MAAc,EAAE,SAAiB,EAAE,KAAoB;QACnF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,OAAO;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;QAC3E,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,MAAc,EAAE,SAAiB,EAAE,KAAoB;QACrF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,OAAO;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,UAAU,CACd,OAAgB,EAChB,MAAc,EACd,SAAiB,EACjB,IAAmB,EACnB,EAAiB;QAEjB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACrD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/core/retry-queue.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Failed message re-queue — retry failed model runs after a delay.
+ *
+ * When all model fallbacks are exhausted, the failed user message is
+ * stored in a retry queue. After a configurable delay, it's retried
+ * once. If the retry also fails, the failure is logged and optionally
+ * a reaction emoji is added to the original message.
+ */
+import type { RetryQueueConfig } from '../config/schema.js';
+import type { Channel } from '../channels/channel.js';
+/** A message queued for retry. */
+export interface QueuedMessage {
+    /** Unique ID for this retry entry. */
+    id: string;
+    /** The user's original message text. */
+    userMessage: string;
+    /** Session ID for the conversation. */
+    sessionId: string;
+    /** Number of retries attempted so far. */
+    retryCount: number;
+    /** Timestamp when the message was first queued. */
+    queuedAt: number;
+    /** Channel ID for the original message (for emoji reaction). */
+    channelId?: string;
+    /** Original message ID (for emoji reaction). */
+    messageId?: string;
+    /** The channel reference (for reactions). */
+    channel?: Channel;
+}
+/** Callback to run the agent loop for a retried message. */
+export type RetryRunner = (sessionId: string, userMessage: string) => Promise<string>;
+export declare class RetryQueue {
+    private config;
+    private queue;
+    private timers;
+    private runner;
+    constructor(config: RetryQueueConfig);
+    /** Set the retry runner (called when a message is retried). */
+    setRunner(runner: RetryRunner): void;
+    /**
+     * Enqueue a failed message for retry.
+     * Returns true if the message was queued, false if retries are disabled
+     * or max retries already reached.
+     */
+    enqueue(msg: Omit<QueuedMessage, 'id' | 'retryCount' | 'queuedAt'>): boolean;
+    private scheduleRetry;
+    private executeRetry;
+    private handlePermanentFailure;
+    /** Get the number of messages currently queued. */
+    get size(): number;
+    /** Get all queued messages (for diagnostics). */
+    getQueued(): QueuedMessage[];
+    /** Clear all pending retries and timers. */
+    dispose(): void;
+}
+//# sourceMappingURL=retry-queue.d.ts.map

package/dist/core/retry-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-queue.d.ts","sourceRoot":"","sources":["../../src/core/retry-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG,CACxB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,gBAAgB;IAIpC,+DAA+D;IAC/D,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIpC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,YAAY,GAAG,UAAU,CAAC,GAAG,OAAO;IAsB5E,OAAO,CAAC,aAAa;YASP,YAAY;YAkCZ,sBAAsB;IAuBpC,mDAAmD;IACnD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,iDAAiD;IACjD,SAAS,IAAI,aAAa,EAAE;IAI5B,4CAA4C;IAC5C,OAAO,IAAI,IAAI;CAOhB"}

package/dist/core/retry-queue.js

@@ -0,0 +1,106 @@
+/**
+ * Failed message re-queue — retry failed model runs after a delay.
+ *
+ * When all model fallbacks are exhausted, the failed user message is
+ * stored in a retry queue. After a configurable delay, it's retried
+ * once. If the retry also fails, the failure is logged and optionally
+ * a reaction emoji is added to the original message.
+ */
+export class RetryQueue {
+    config;
+    queue = new Map();
+    timers = new Map();
+    runner = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Set the retry runner (called when a message is retried). */
+    setRunner(runner) {
+        this.runner = runner;
+    }
+    /**
+     * Enqueue a failed message for retry.
+     * Returns true if the message was queued, false if retries are disabled
+     * or max retries already reached.
+     */
+    enqueue(msg) {
+        if (!this.config.enabled)
+            return false;
+        const id = `retry-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const entry = {
+            ...msg,
+            id,
+            retryCount: 0,
+            queuedAt: Date.now(),
+        };
+        this.queue.set(id, entry);
+        this.scheduleRetry(entry);
+        console.log(`[retry-queue] Queued message for retry in ${this.config.delaySeconds}s ` +
+            `(session: ${msg.sessionId})`);
+        return true;
+    }
+    scheduleRetry(entry) {
+        const timer = setTimeout(async () => {
+            this.timers.delete(entry.id);
+            await this.executeRetry(entry);
+        }, this.config.delaySeconds * 1000);
+        this.timers.set(entry.id, timer);
+    }
+    async executeRetry(entry) {
+        if (!this.runner) {
+            console.warn('[retry-queue] No runner set, dropping retry');
+            this.queue.delete(entry.id);
+            return;
+        }
+        entry.retryCount++;
+        console.log(`[retry-queue] Retrying message (attempt ${entry.retryCount}/${this.config.maxRetries}, ` +
+            `session: ${entry.sessionId})`);
+        try {
+            await this.runner(entry.sessionId, entry.userMessage);
+            console.log(`[retry-queue] Retry succeeded (session: ${entry.sessionId})`);
+            this.queue.delete(entry.id);
+        }
+        catch (err) {
+            console.error(`[retry-queue] Retry failed (session: ${entry.sessionId}):`, err instanceof Error ? err.message : String(err));
+            if (entry.retryCount >= this.config.maxRetries) {
+                // Permanent failure — react with failure emoji if possible
+                await this.handlePermanentFailure(entry);
+                this.queue.delete(entry.id);
+            }
+            else {
+                // Schedule another retry
+                this.scheduleRetry(entry);
+            }
+        }
+    }
+    async handlePermanentFailure(entry) {
+        console.error(`[retry-queue] Permanent failure for message in session ${entry.sessionId} ` +
+            `after ${entry.retryCount} retries`);
+        // Add failure reaction if channel supports it
+        if (entry.channel && entry.channelId && entry.messageId && entry.channel.addReaction) {
+            try {
+                await entry.channel.addReaction(entry.channelId, entry.messageId, this.config.failureEmoji);
+            }
+            catch (err) {
+                console.warn('[retry-queue] Failed to add failure reaction:', err instanceof Error ? err.message : String(err));
+            }
+        }
+    }
+    /** Get the number of messages currently queued. */
+    get size() {
+        return this.queue.size;
+    }
+    /** Get all queued messages (for diagnostics). */
+    getQueued() {
+        return [...this.queue.values()];
+    }
+    /** Clear all pending retries and timers. */
+    dispose() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        this.queue.clear();
+    }
+}
+//# sourceMappingURL=retry-queue.js.map

package/dist/core/retry-queue.js.map

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

package/dist/core/sanitizer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Input Sanitizer — detects and strips prompt injection patterns.
+ *
+ * Modes:
+ * - 'strip': remove dangerous tokens, continue processing
+ * - 'warn': log but don't modify
+ * - 'block': reject the message entirely
+ */
+export interface SanitizerConfig {
+    /** Enable input sanitization (default: true). */
+    enabled: boolean;
+    /** Action mode: 'strip', 'warn', or 'block'. */
+    mode: 'strip' | 'warn' | 'block';
+}
+export interface SanitizeResult {
+    /** The (possibly sanitized) text. */
+    text: string;
+    /** Whether any issues were detected. */
+    flagged: boolean;
+    /** Whether the message was blocked. */
+    blocked: boolean;
+    /** List of detected patterns. */
+    detections: SanitizeDetection[];
+}
+export interface SanitizeDetection {
+    pattern: string;
+    category: 'injection' | 'extraction' | 'role_confusion' | 'encoding';
+    severity: 'low' | 'medium' | 'high';
+}
+export declare class InputSanitizer {
+    private config;
+    constructor(config: SanitizerConfig);
+    /**
+     * Sanitize user input.
+     */
+    sanitize(text: string): SanitizeResult;
+}
+//# sourceMappingURL=sanitizer.d.ts.map

package/dist/core/sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/core/sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,gBAAgB,GAAG,UAAU,CAAC;IACrE,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AA6HD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;CA4DvC"}