@agent-relay/storage 0.1.0

package/dist/dead-letter-queue.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Dead Letter Queue (DLQ) for Agent Relay
+ *
+ * Captures failed message deliveries for inspection, retry, and debugging.
+ * Messages end up in DLQ when:
+ * - Delivery exceeds max retry attempts
+ * - TTL expires before successful delivery
+ * - Target agent disconnects during delivery
+ * - Signature verification fails
+ *
+ * Features:
+ * - Persistent storage (SQLite)
+ * - Configurable retention period
+ * - Manual retry capability
+ * - Failure categorization
+ * - Metrics and alerting hooks
+ */
+import type { Database as BetterSqlite3Database } from 'better-sqlite3';
+export type DLQFailureReason = 'max_retries_exceeded' | 'ttl_expired' | 'connection_lost' | 'target_not_found' | 'signature_invalid' | 'payload_too_large' | 'rate_limited' | 'unknown';
+export interface DeadLetter {
+    /** Unique identifier */
+    id: string;
+    /** Original message ID */
+    messageId: string;
+    /** Sender agent/user */
+    from: string;
+    /** Intended recipient */
+    to: string;
+    /** Topic (for subscriptions) */
+    topic?: string;
+    /** Message kind */
+    kind: string;
+    /** Message body */
+    body: string;
+    /** Additional data */
+    data?: Record<string, unknown>;
+    /** Thread ID */
+    thread?: string;
+    /** Original send timestamp */
+    originalTs: number;
+    /** DLQ entry timestamp */
+    dlqTs: number;
+    /** Failure reason */
+    reason: DLQFailureReason;
+    /** Detailed error message */
+    errorMessage?: string;
+    /** Number of delivery attempts made */
+    attemptCount: number;
+    /** Last attempt timestamp */
+    lastAttemptTs?: number;
+    /** Retry count from DLQ */
+    dlqRetryCount: number;
+    /** Whether message has been acknowledged/processed */
+    acknowledged: boolean;
+    /** Acknowledgment timestamp */
+    acknowledgedTs?: number;
+    /** Who acknowledged (agent name or 'system') */
+    acknowledgedBy?: string;
+}
+export interface DLQConfig {
+    /** Enable DLQ (default: true) */
+    enabled: boolean;
+    /** Maximum retention period in hours (default: 168 = 7 days) */
+    retentionHours: number;
+    /** Maximum entries to keep (default: 10000) */
+    maxEntries: number;
+    /** Enable automatic cleanup (default: true) */
+    autoCleanup: boolean;
+    /** Cleanup interval in minutes (default: 60) */
+    cleanupIntervalMinutes: number;
+    /** Alert threshold - emit warning when DLQ size exceeds this */
+    alertThreshold: number;
+}
+export interface DLQStats {
+    totalEntries: number;
+    unacknowledged: number;
+    byReason: Record<DLQFailureReason, number>;
+    byTarget: Record<string, number>;
+    oldestEntryTs: number | null;
+    newestEntryTs: number | null;
+    avgRetryCount: number;
+}
+export interface DLQQuery {
+    /** Filter by recipient */
+    to?: string;
+    /** Filter by sender */
+    from?: string;
+    /** Filter by failure reason */
+    reason?: DLQFailureReason;
+    /** Filter by acknowledged status */
+    acknowledged?: boolean;
+    /** Filter entries after this timestamp */
+    afterTs?: number;
+    /** Filter entries before this timestamp */
+    beforeTs?: number;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Order by (default: dlqTs DESC) */
+    orderBy?: 'dlqTs' | 'originalTs' | 'attemptCount';
+    /** Order direction */
+    orderDir?: 'ASC' | 'DESC';
+}
+export declare class DeadLetterQueue {
+    private config;
+    private db;
+    private cleanupTimer?;
+    private alertCallback?;
+    constructor(db: BetterSqlite3Database, config?: Partial<DLQConfig>);
+    /**
+     * Initialize database schema.
+     */
+    private initSchema;
+    /**
+     * Start automatic cleanup timer.
+     */
+    private startCleanupTimer;
+    /**
+     * Stop cleanup timer.
+     */
+    stopCleanupTimer(): void;
+    /**
+     * Set callback for alert threshold.
+     */
+    onAlert(callback: (stats: DLQStats) => void): void;
+    /**
+     * Add a failed message to DLQ.
+     */
+    add(messageId: string, envelope: {
+        from: string;
+        to: string;
+        topic?: string;
+        kind: string;
+        body: string;
+        data?: Record<string, unknown>;
+        thread?: string;
+        ts: number;
+    }, reason: DLQFailureReason, attemptCount: number, errorMessage?: string): DeadLetter;
+    /**
+     * Get a dead letter by ID.
+     */
+    get(id: string): DeadLetter | null;
+    /**
+     * Query dead letters.
+     */
+    query(query?: DLQQuery): DeadLetter[];
+    /**
+     * Acknowledge a dead letter (mark as processed).
+     */
+    acknowledge(id: string, acknowledgedBy?: string): boolean;
+    /**
+     * Acknowledge multiple dead letters.
+     */
+    acknowledgeMany(ids: string[], acknowledgedBy?: string): number;
+    /**
+     * Increment retry count for a dead letter.
+     */
+    incrementRetry(id: string): boolean;
+    /**
+     * Remove a dead letter.
+     */
+    remove(id: string): boolean;
+    /**
+     * Get DLQ statistics.
+     */
+    getStats(): DLQStats;
+    /**
+     * Cleanup old entries.
+     */
+    cleanup(): {
+        removed: number;
+        reason: string;
+    };
+    /**
+     * Check if we've exceeded alert threshold and call alert callback.
+     */
+    private checkAlertThreshold;
+    /**
+     * Convert database row to DeadLetter object.
+     */
+    private rowToDeadLetter;
+    /**
+     * Export dead letters for external processing.
+     */
+    export(query?: DLQQuery): string;
+    /**
+     * Get messages ready for retry (unacknowledged, low retry count).
+     */
+    getRetryable(maxRetries?: number, limit?: number): DeadLetter[];
+}
+/**
+ * Create a DLQ instance with the given database.
+ */
+export declare function createDeadLetterQueue(db: BetterSqlite3Database, config?: Partial<DLQConfig>): DeadLetterQueue;
+//# sourceMappingURL=dead-letter-queue.d.ts.map

package/dist/dead-letter-queue.d.ts.map

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

package/dist/dead-letter-queue.js

@@ -0,0 +1,427 @@
+/**
+ * Dead Letter Queue (DLQ) for Agent Relay
+ *
+ * Captures failed message deliveries for inspection, retry, and debugging.
+ * Messages end up in DLQ when:
+ * - Delivery exceeds max retry attempts
+ * - TTL expires before successful delivery
+ * - Target agent disconnects during delivery
+ * - Signature verification fails
+ *
+ * Features:
+ * - Persistent storage (SQLite)
+ * - Configurable retention period
+ * - Manual retry capability
+ * - Failure categorization
+ * - Metrics and alerting hooks
+ */
+// =============================================================================
+// Default Configuration
+// =============================================================================
+const DEFAULT_DLQ_CONFIG = {
+    enabled: true,
+    retentionHours: 168, // 7 days
+    maxEntries: 10000,
+    autoCleanup: true,
+    cleanupIntervalMinutes: 60,
+    alertThreshold: 1000,
+};
+// =============================================================================
+// DLQ Storage Schema
+// =============================================================================
+const DLQ_SCHEMA = `
+CREATE TABLE IF NOT EXISTS dead_letters (
+  id TEXT PRIMARY KEY,
+  message_id TEXT NOT NULL,
+  from_agent TEXT NOT NULL,
+  to_agent TEXT NOT NULL,
+  topic TEXT,
+  kind TEXT NOT NULL,
+  body TEXT NOT NULL,
+  data TEXT,
+  thread TEXT,
+  original_ts INTEGER NOT NULL,
+  dlq_ts INTEGER NOT NULL,
+  reason TEXT NOT NULL,
+  error_message TEXT,
+  attempt_count INTEGER NOT NULL DEFAULT 0,
+  last_attempt_ts INTEGER,
+  dlq_retry_count INTEGER NOT NULL DEFAULT 0,
+  acknowledged INTEGER NOT NULL DEFAULT 0,
+  acknowledged_ts INTEGER,
+  acknowledged_by TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_dlq_to ON dead_letters(to_agent);
+CREATE INDEX IF NOT EXISTS idx_dlq_from ON dead_letters(from_agent);
+CREATE INDEX IF NOT EXISTS idx_dlq_reason ON dead_letters(reason);
+CREATE INDEX IF NOT EXISTS idx_dlq_ts ON dead_letters(dlq_ts);
+CREATE INDEX IF NOT EXISTS idx_dlq_acknowledged ON dead_letters(acknowledged);
+`;
+// =============================================================================
+// Dead Letter Queue Implementation
+// =============================================================================
+export class DeadLetterQueue {
+    config;
+    db;
+    cleanupTimer;
+    alertCallback;
+    constructor(db, config = {}) {
+        this.config = { ...DEFAULT_DLQ_CONFIG, ...config };
+        this.db = db;
+        // Initialize schema
+        this.initSchema();
+        // Start cleanup timer if enabled
+        if (this.config.autoCleanup) {
+            this.startCleanupTimer();
+        }
+    }
+    /**
+     * Initialize database schema.
+     */
+    initSchema() {
+        this.db.exec(DLQ_SCHEMA);
+    }
+    /**
+     * Start automatic cleanup timer.
+     */
+    startCleanupTimer() {
+        const intervalMs = this.config.cleanupIntervalMinutes * 60 * 1000;
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, intervalMs);
+        // Don't block process exit
+        this.cleanupTimer.unref();
+    }
+    /**
+     * Stop cleanup timer.
+     */
+    stopCleanupTimer() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    /**
+     * Set callback for alert threshold.
+     */
+    onAlert(callback) {
+        this.alertCallback = callback;
+    }
+    /**
+     * Add a failed message to DLQ.
+     */
+    add(messageId, envelope, reason, attemptCount, errorMessage) {
+        if (!this.config.enabled) {
+            throw new Error('DLQ is disabled');
+        }
+        const id = `dlq_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+        const now = Date.now();
+        const deadLetter = {
+            id,
+            messageId,
+            from: envelope.from,
+            to: envelope.to,
+            topic: envelope.topic,
+            kind: envelope.kind,
+            body: envelope.body,
+            data: envelope.data,
+            thread: envelope.thread,
+            originalTs: envelope.ts,
+            dlqTs: now,
+            reason,
+            errorMessage,
+            attemptCount,
+            lastAttemptTs: now,
+            dlqRetryCount: 0,
+            acknowledged: false,
+        };
+        const stmt = this.db.prepare(`
+      INSERT INTO dead_letters (
+        id, message_id, from_agent, to_agent, topic, kind, body, data, thread,
+        original_ts, dlq_ts, reason, error_message, attempt_count, last_attempt_ts,
+        dlq_retry_count, acknowledged
+      ) VALUES (
+        ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
+      )
+    `);
+        stmt.run(deadLetter.id, deadLetter.messageId, deadLetter.from, deadLetter.to, deadLetter.topic ?? null, deadLetter.kind, deadLetter.body, deadLetter.data ? JSON.stringify(deadLetter.data) : null, deadLetter.thread ?? null, deadLetter.originalTs, deadLetter.dlqTs, deadLetter.reason, deadLetter.errorMessage ?? null, deadLetter.attemptCount, deadLetter.lastAttemptTs ?? null, deadLetter.dlqRetryCount, deadLetter.acknowledged ? 1 : 0);
+        console.log(`[dlq] Added dead letter ${id} for message ${messageId}: ${reason}`);
+        // Check alert threshold
+        this.checkAlertThreshold();
+        return deadLetter;
+    }
+    /**
+     * Get a dead letter by ID.
+     */
+    get(id) {
+        const stmt = this.db.prepare('SELECT * FROM dead_letters WHERE id = ?');
+        const row = stmt.get(id);
+        if (!row)
+            return null;
+        return this.rowToDeadLetter(row);
+    }
+    /**
+     * Query dead letters.
+     */
+    query(query = {}) {
+        const conditions = [];
+        const params = [];
+        if (query.to) {
+            conditions.push('to_agent = ?');
+            params.push(query.to);
+        }
+        if (query.from) {
+            conditions.push('from_agent = ?');
+            params.push(query.from);
+        }
+        if (query.reason) {
+            conditions.push('reason = ?');
+            params.push(query.reason);
+        }
+        if (query.acknowledged !== undefined) {
+            conditions.push('acknowledged = ?');
+            params.push(query.acknowledged ? 1 : 0);
+        }
+        if (query.afterTs) {
+            conditions.push('dlq_ts > ?');
+            params.push(query.afterTs);
+        }
+        if (query.beforeTs) {
+            conditions.push('dlq_ts < ?');
+            params.push(query.beforeTs);
+        }
+        const whereClause = conditions.length > 0
+            ? `WHERE ${conditions.join(' AND ')}`
+            : '';
+        const orderBy = query.orderBy ?? 'dlq_ts';
+        const orderDir = query.orderDir ?? 'DESC';
+        const orderColumn = orderBy === 'dlqTs' ? 'dlq_ts'
+            : orderBy === 'originalTs' ? 'original_ts'
+                : 'attempt_count';
+        const limit = query.limit ?? 100;
+        const offset = query.offset ?? 0;
+        const sql = `
+      SELECT * FROM dead_letters
+      ${whereClause}
+      ORDER BY ${orderColumn} ${orderDir}
+      LIMIT ? OFFSET ?
+    `;
+        params.push(limit, offset);
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map(row => this.rowToDeadLetter(row));
+    }
+    /**
+     * Acknowledge a dead letter (mark as processed).
+     */
+    acknowledge(id, acknowledgedBy = 'system') {
+        const stmt = this.db.prepare(`
+      UPDATE dead_letters
+      SET acknowledged = 1, acknowledged_ts = ?, acknowledged_by = ?
+      WHERE id = ? AND acknowledged = 0
+    `);
+        const result = stmt.run(Date.now(), acknowledgedBy, id);
+        return result.changes > 0;
+    }
+    /**
+     * Acknowledge multiple dead letters.
+     */
+    acknowledgeMany(ids, acknowledgedBy = 'system') {
+        const placeholders = ids.map(() => '?').join(',');
+        const stmt = this.db.prepare(`
+      UPDATE dead_letters
+      SET acknowledged = 1, acknowledged_ts = ?, acknowledged_by = ?
+      WHERE id IN (${placeholders}) AND acknowledged = 0
+    `);
+        const result = stmt.run(Date.now(), acknowledgedBy, ...ids);
+        return result.changes;
+    }
+    /**
+     * Increment retry count for a dead letter.
+     */
+    incrementRetry(id) {
+        const stmt = this.db.prepare(`
+      UPDATE dead_letters
+      SET dlq_retry_count = dlq_retry_count + 1, last_attempt_ts = ?
+      WHERE id = ?
+    `);
+        const result = stmt.run(Date.now(), id);
+        return result.changes > 0;
+    }
+    /**
+     * Remove a dead letter.
+     */
+    remove(id) {
+        const stmt = this.db.prepare('DELETE FROM dead_letters WHERE id = ?');
+        const result = stmt.run(id);
+        return result.changes > 0;
+    }
+    /**
+     * Get DLQ statistics.
+     */
+    getStats() {
+        const totalStmt = this.db.prepare('SELECT COUNT(*) as count FROM dead_letters');
+        const totalRow = totalStmt.get();
+        const unackStmt = this.db.prepare('SELECT COUNT(*) as count FROM dead_letters WHERE acknowledged = 0');
+        const unackRow = unackStmt.get();
+        const byReasonStmt = this.db.prepare(`
+      SELECT reason, COUNT(*) as count
+      FROM dead_letters
+      GROUP BY reason
+    `);
+        const reasonRows = byReasonStmt.all();
+        const byReason = {
+            max_retries_exceeded: 0,
+            ttl_expired: 0,
+            connection_lost: 0,
+            target_not_found: 0,
+            signature_invalid: 0,
+            payload_too_large: 0,
+            rate_limited: 0,
+            unknown: 0,
+        };
+        for (const row of reasonRows) {
+            byReason[row.reason] = row.count;
+        }
+        const byTargetStmt = this.db.prepare(`
+      SELECT to_agent, COUNT(*) as count
+      FROM dead_letters
+      GROUP BY to_agent
+      ORDER BY count DESC
+      LIMIT 10
+    `);
+        const targetRows = byTargetStmt.all();
+        const byTarget = {};
+        for (const row of targetRows) {
+            byTarget[row.to_agent] = row.count;
+        }
+        const oldestStmt = this.db.prepare('SELECT MIN(dlq_ts) as ts FROM dead_letters WHERE acknowledged = 0');
+        const oldestRow = oldestStmt.get();
+        const newestStmt = this.db.prepare('SELECT MAX(dlq_ts) as ts FROM dead_letters WHERE acknowledged = 0');
+        const newestRow = newestStmt.get();
+        const avgRetryStmt = this.db.prepare('SELECT AVG(dlq_retry_count) as avg FROM dead_letters');
+        const avgRow = avgRetryStmt.get();
+        return {
+            totalEntries: totalRow.count,
+            unacknowledged: unackRow.count,
+            byReason,
+            byTarget,
+            oldestEntryTs: oldestRow.ts,
+            newestEntryTs: newestRow.ts,
+            avgRetryCount: avgRow.avg ?? 0,
+        };
+    }
+    /**
+     * Cleanup old entries.
+     */
+    cleanup() {
+        const now = Date.now();
+        const cutoffTs = now - this.config.retentionHours * 3600 * 1000;
+        // Remove old acknowledged entries first
+        const oldAckStmt = this.db.prepare(`
+      DELETE FROM dead_letters
+      WHERE acknowledged = 1 AND dlq_ts < ?
+    `);
+        const oldAckResult = oldAckStmt.run(cutoffTs);
+        // Remove entries beyond retention (even if unacknowledged)
+        const retentionStmt = this.db.prepare(`
+      DELETE FROM dead_letters
+      WHERE dlq_ts < ?
+    `);
+        const retentionResult = retentionStmt.run(cutoffTs);
+        // Enforce max entries limit
+        const countStmt = this.db.prepare('SELECT COUNT(*) as count FROM dead_letters');
+        const countRow = countStmt.get();
+        let maxEntriesRemoved = 0;
+        if (countRow.count > this.config.maxEntries) {
+            const excess = countRow.count - this.config.maxEntries;
+            const trimStmt = this.db.prepare(`
+        DELETE FROM dead_letters
+        WHERE id IN (
+          SELECT id FROM dead_letters
+          WHERE acknowledged = 1
+          ORDER BY dlq_ts ASC
+          LIMIT ?
+        )
+      `);
+            const trimResult = trimStmt.run(excess);
+            maxEntriesRemoved = trimResult.changes;
+        }
+        const totalRemoved = oldAckResult.changes + retentionResult.changes + maxEntriesRemoved;
+        if (totalRemoved > 0) {
+            console.log(`[dlq] Cleanup removed ${totalRemoved} entries`);
+        }
+        return {
+            removed: totalRemoved,
+            reason: `retention=${retentionResult.changes}, maxEntries=${maxEntriesRemoved}`,
+        };
+    }
+    /**
+     * Check if we've exceeded alert threshold and call alert callback.
+     */
+    checkAlertThreshold() {
+        if (!this.alertCallback)
+            return;
+        const stats = this.getStats();
+        if (stats.unacknowledged >= this.config.alertThreshold) {
+            this.alertCallback(stats);
+        }
+    }
+    /**
+     * Convert database row to DeadLetter object.
+     */
+    rowToDeadLetter(row) {
+        return {
+            id: row.id,
+            messageId: row.message_id,
+            from: row.from_agent,
+            to: row.to_agent,
+            topic: row.topic,
+            kind: row.kind,
+            body: row.body,
+            data: row.data ? JSON.parse(row.data) : undefined,
+            thread: row.thread,
+            originalTs: row.original_ts,
+            dlqTs: row.dlq_ts,
+            reason: row.reason,
+            errorMessage: row.error_message,
+            attemptCount: row.attempt_count,
+            lastAttemptTs: row.last_attempt_ts,
+            dlqRetryCount: row.dlq_retry_count,
+            acknowledged: row.acknowledged === 1,
+            acknowledgedTs: row.acknowledged_ts,
+            acknowledgedBy: row.acknowledged_by,
+        };
+    }
+    /**
+     * Export dead letters for external processing.
+     */
+    export(query = {}) {
+        const letters = this.query(query);
+        return JSON.stringify(letters, null, 2);
+    }
+    /**
+     * Get messages ready for retry (unacknowledged, low retry count).
+     */
+    getRetryable(maxRetries = 3, limit = 10) {
+        const stmt = this.db.prepare(`
+      SELECT * FROM dead_letters
+      WHERE acknowledged = 0 AND dlq_retry_count < ?
+      ORDER BY dlq_ts ASC
+      LIMIT ?
+    `);
+        const rows = stmt.all(maxRetries, limit);
+        return rows.map(row => this.rowToDeadLetter(row));
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a DLQ instance with the given database.
+ */
+export function createDeadLetterQueue(db, config) {
+    return new DeadLetterQueue(db, config);
+}
+//# sourceMappingURL=dead-letter-queue.js.map

package/dist/dead-letter-queue.js.map

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