attocode 0.1.3 → 0.1.4

package/dist/src/integrations/dead-letter-queue.js

@@ -0,0 +1,458 @@
+/**
+ * Dead Letter Queue
+ *
+ * Persists failed operations for later retry or manual intervention.
+ * Integrates with SQLite store for durability across sessions.
+ *
+ * @example
+ * ```typescript
+ * const dlq = createDeadLetterQueue(db);
+ *
+ * // On failure, add to DLQ
+ * await dlq.add({
+ *   operation: 'tool:bash',
+ *   args: { command: 'npm install' },
+ *   error: new Error('ETIMEDOUT'),
+ *   sessionId: 'session-123',
+ * });
+ *
+ * // At session start, drain pending items
+ * const pending = await dlq.getPending();
+ * for (const item of pending) {
+ *   const success = await retry(item);
+ *   if (success) await dlq.resolve(item.id);
+ * }
+ * ```
+ */
+import { randomUUID } from 'node:crypto';
+import { ErrorCategory, categorizeError } from '../errors/index.js';
+// =============================================================================
+// DEAD LETTER QUEUE IMPLEMENTATION
+// =============================================================================
+/**
+ * Dead letter queue backed by SQLite.
+ */
+export class DeadLetterQueue {
+    db;
+    listeners = new Set();
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.prepareStatements();
+    }
+    prepareStatements() {
+        // Check if table exists
+        const tableExists = this.db
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='dead_letters'")
+            .get();
+        if (!tableExists) {
+            return; // Table not yet created - will be available after migration
+        }
+        this.stmts = {
+            insert: this.db.prepare(`
+        INSERT INTO dead_letters (
+          id, session_id, operation, args, error, category,
+          attempts, max_attempts, last_attempt, next_retry,
+          metadata, status, created_at
+        ) VALUES (
+          @id, @sessionId, @operation, @args, @error, @category,
+          @attempts, @maxAttempts, @lastAttempt, @nextRetry,
+          @metadata, @status, @createdAt
+        )
+      `),
+            update: this.db.prepare(`
+        UPDATE dead_letters SET
+          attempts = @attempts,
+          last_attempt = @lastAttempt,
+          next_retry = @nextRetry,
+          status = @status,
+          resolved_at = @resolvedAt
+        WHERE id = @id
+      `),
+            get: this.db.prepare('SELECT * FROM dead_letters WHERE id = ?'),
+            delete: this.db.prepare('DELETE FROM dead_letters WHERE id = ?'),
+            list: this.db.prepare('SELECT * FROM dead_letters ORDER BY created_at DESC'),
+            stats: this.db.prepare(`
+        SELECT
+          status,
+          operation,
+          category,
+          COUNT(*) as count
+        FROM dead_letters
+        GROUP BY status, operation, category
+      `),
+        };
+    }
+    /**
+     * Check if DLQ is available (table exists).
+     */
+    isAvailable() {
+        return this.stmts !== undefined;
+    }
+    /**
+     * Add a failed operation to the dead letter queue.
+     */
+    async add(input) {
+        if (!this.stmts) {
+            throw new Error('Dead letter queue not available - migration required');
+        }
+        const { category } = input.error instanceof Error
+            ? categorizeError(input.error)
+            : { category: ErrorCategory.INTERNAL };
+        const item = {
+            id: randomUUID(),
+            sessionId: input.sessionId,
+            operation: input.operation,
+            args: JSON.stringify(input.args),
+            error: input.error.message,
+            category,
+            attempts: 1,
+            maxAttempts: input.maxAttempts ?? 3,
+            lastAttempt: new Date(),
+            nextRetry: this.calculateNextRetry(1, category),
+            metadata: input.metadata,
+            status: 'pending',
+            createdAt: new Date(),
+        };
+        this.stmts.insert.run({
+            id: item.id,
+            sessionId: item.sessionId ?? null,
+            operation: item.operation,
+            args: item.args,
+            error: item.error,
+            category: item.category,
+            attempts: item.attempts,
+            maxAttempts: item.maxAttempts,
+            lastAttempt: item.lastAttempt.toISOString(),
+            nextRetry: item.nextRetry?.toISOString() ?? null,
+            metadata: item.metadata ? JSON.stringify(item.metadata) : null,
+            status: item.status,
+            createdAt: item.createdAt.toISOString(),
+        });
+        this.emit({ type: 'item.added', item });
+        return item;
+    }
+    /**
+     * Get a dead letter item by ID.
+     */
+    get(id) {
+        if (!this.stmts)
+            return null;
+        const row = this.stmts.get.get(id);
+        return row ? this.rowToItem(row) : null;
+    }
+    /**
+     * Get pending items ready for retry.
+     */
+    getPending(options = {}) {
+        if (!this.stmts)
+            return [];
+        const conditions = ["status = 'pending'"];
+        const params = {};
+        if (options.operation) {
+            conditions.push('operation = @operation');
+            params.operation = options.operation;
+        }
+        if (options.sessionId) {
+            conditions.push('session_id = @sessionId');
+            params.sessionId = options.sessionId;
+        }
+        if (options.readyForRetry !== false) {
+            conditions.push('(next_retry IS NULL OR next_retry <= @now)');
+            params.now = new Date().toISOString();
+        }
+        const orderBy = options.orderBy ?? 'createdAt';
+        const orderCol = orderBy === 'createdAt' ? 'created_at'
+            : orderBy === 'lastAttempt' ? 'last_attempt'
+                : 'next_retry';
+        const limit = options.limit ?? 100;
+        const sql = `
+      SELECT * FROM dead_letters
+      WHERE ${conditions.join(' AND ')}
+      ORDER BY ${orderCol} ASC
+      LIMIT ${limit}
+    `;
+        const rows = this.db.prepare(sql).all(params);
+        return rows.map(row => this.rowToItem(row));
+    }
+    /**
+     * Query dead letters with filters.
+     */
+    query(options = {}) {
+        if (!this.stmts)
+            return [];
+        const conditions = [];
+        const params = {};
+        if (options.status) {
+            conditions.push('status = @status');
+            params.status = options.status;
+        }
+        if (options.operation) {
+            conditions.push('operation = @operation');
+            params.operation = options.operation;
+        }
+        if (options.sessionId) {
+            conditions.push('session_id = @sessionId');
+            params.sessionId = options.sessionId;
+        }
+        if (options.readyForRetry) {
+            conditions.push("status = 'pending' AND (next_retry IS NULL OR next_retry <= @now)");
+            params.now = new Date().toISOString();
+        }
+        const orderBy = options.orderBy ?? 'createdAt';
+        const orderCol = orderBy === 'createdAt' ? 'created_at'
+            : orderBy === 'lastAttempt' ? 'last_attempt'
+                : 'next_retry';
+        const limit = options.limit ?? 100;
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const sql = `
+      SELECT * FROM dead_letters
+      ${whereClause}
+      ORDER BY ${orderCol} DESC
+      LIMIT ${limit}
+    `;
+        const rows = this.db.prepare(sql).all(params);
+        return rows.map(row => this.rowToItem(row));
+    }
+    /**
+     * Mark an item as being retried.
+     */
+    markRetrying(id) {
+        if (!this.stmts)
+            return;
+        const item = this.get(id);
+        if (!item)
+            return;
+        const now = new Date();
+        this.stmts.update.run({
+            id,
+            attempts: item.attempts + 1,
+            lastAttempt: now.toISOString(),
+            nextRetry: this.calculateNextRetry(item.attempts + 1, item.category)?.toISOString() ?? null,
+            status: 'retrying',
+            resolvedAt: null,
+        });
+        this.emit({ type: 'item.retrying', item: { ...item, status: 'retrying' } });
+    }
+    /**
+     * Mark an item as resolved (successful retry).
+     */
+    resolve(id) {
+        if (!this.stmts)
+            return;
+        const item = this.get(id);
+        if (!item)
+            return;
+        const now = new Date();
+        this.stmts.update.run({
+            id,
+            attempts: item.attempts,
+            lastAttempt: item.lastAttempt.toISOString(),
+            nextRetry: null,
+            status: 'resolved',
+            resolvedAt: now.toISOString(),
+        });
+        this.emit({ type: 'item.resolved', item: { ...item, status: 'resolved', resolvedAt: now } });
+    }
+    /**
+     * Mark an item as abandoned (max retries exceeded or non-recoverable).
+     */
+    abandon(id) {
+        if (!this.stmts)
+            return;
+        const item = this.get(id);
+        if (!item)
+            return;
+        this.stmts.update.run({
+            id,
+            attempts: item.attempts,
+            lastAttempt: item.lastAttempt.toISOString(),
+            nextRetry: null,
+            status: 'abandoned',
+            resolvedAt: new Date().toISOString(),
+        });
+        this.emit({ type: 'item.abandoned', item: { ...item, status: 'abandoned' } });
+    }
+    /**
+     * Return an item to pending status after a failed retry.
+     */
+    returnToPending(id) {
+        if (!this.stmts)
+            return;
+        const item = this.get(id);
+        if (!item)
+            return;
+        // Check if max attempts reached
+        if (item.attempts >= item.maxAttempts) {
+            this.abandon(id);
+            return;
+        }
+        const now = new Date();
+        this.stmts.update.run({
+            id,
+            attempts: item.attempts,
+            lastAttempt: now.toISOString(),
+            nextRetry: this.calculateNextRetry(item.attempts, item.category)?.toISOString() ?? null,
+            status: 'pending',
+            resolvedAt: null,
+        });
+    }
+    /**
+     * Delete an item from the queue.
+     */
+    delete(id) {
+        if (!this.stmts)
+            return;
+        this.stmts.delete.run(id);
+        this.emit({ type: 'item.deleted', id });
+    }
+    /**
+     * Get queue statistics.
+     */
+    getStats() {
+        if (!this.stmts) {
+            return {
+                total: 0,
+                pending: 0,
+                retrying: 0,
+                resolved: 0,
+                abandoned: 0,
+                byOperation: {},
+                byCategory: {},
+            };
+        }
+        const rows = this.stmts.stats.all();
+        const stats = {
+            total: 0,
+            pending: 0,
+            retrying: 0,
+            resolved: 0,
+            abandoned: 0,
+            byOperation: {},
+            byCategory: {},
+        };
+        for (const row of rows) {
+            const count = row.count;
+            stats.total += count;
+            // Count by status
+            if (row.status === 'pending')
+                stats.pending += count;
+            else if (row.status === 'retrying')
+                stats.retrying += count;
+            else if (row.status === 'resolved')
+                stats.resolved += count;
+            else if (row.status === 'abandoned')
+                stats.abandoned += count;
+            // Count by operation
+            stats.byOperation[row.operation] = (stats.byOperation[row.operation] || 0) + count;
+            // Count by category
+            stats.byCategory[row.category] = (stats.byCategory[row.category] || 0) + count;
+        }
+        return stats;
+    }
+    /**
+     * Cleanup old resolved/abandoned items.
+     */
+    cleanup(olderThanDays = 7) {
+        if (!this.stmts)
+            return 0;
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - olderThanDays);
+        const result = this.db.prepare(`
+      DELETE FROM dead_letters
+      WHERE status IN ('resolved', 'abandoned')
+        AND resolved_at < ?
+    `).run(cutoff.toISOString());
+        return result.changes;
+    }
+    /**
+     * Add an event listener.
+     */
+    on(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    /**
+     * Calculate next retry time based on attempts and error category.
+     */
+    calculateNextRetry(attempts, category) {
+        // Don't retry permanent errors
+        if (category === ErrorCategory.PERMANENT || category === ErrorCategory.VALIDATION) {
+            return undefined;
+        }
+        // Exponential backoff: 1min, 5min, 15min, 30min, 1hr
+        const delays = [60, 300, 900, 1800, 3600]; // seconds
+        const delaySeconds = delays[Math.min(attempts - 1, delays.length - 1)];
+        const nextRetry = new Date();
+        nextRetry.setSeconds(nextRetry.getSeconds() + delaySeconds);
+        return nextRetry;
+    }
+    rowToItem(row) {
+        return {
+            id: row.id,
+            sessionId: row.session_id,
+            operation: row.operation,
+            args: row.args,
+            error: row.error,
+            category: row.category,
+            attempts: row.attempts,
+            maxAttempts: row.max_attempts,
+            lastAttempt: new Date(row.last_attempt),
+            nextRetry: row.next_retry ? new Date(row.next_retry) : undefined,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            status: row.status,
+            createdAt: new Date(row.created_at),
+            resolvedAt: row.resolved_at ? new Date(row.resolved_at) : undefined,
+        };
+    }
+}
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create a dead letter queue instance.
+ */
+export function createDeadLetterQueue(db) {
+    return new DeadLetterQueue(db);
+}
+// =============================================================================
+// FORMATTING
+// =============================================================================
+/**
+ * Format dead letter stats for display.
+ */
+export function formatDeadLetterStats(stats) {
+    const lines = [];
+    lines.push(`Dead Letter Queue Statistics`);
+    lines.push(`  Total: ${stats.total}`);
+    lines.push(`  Pending: ${stats.pending}`);
+    lines.push(`  Retrying: ${stats.retrying}`);
+    lines.push(`  Resolved: ${stats.resolved}`);
+    lines.push(`  Abandoned: ${stats.abandoned}`);
+    if (Object.keys(stats.byOperation).length > 0) {
+        lines.push('');
+        lines.push('  By Operation:');
+        for (const [op, count] of Object.entries(stats.byOperation)) {
+            lines.push(`    ${op}: ${count}`);
+        }
+    }
+    if (Object.keys(stats.byCategory).length > 0) {
+        lines.push('');
+        lines.push('  By Category:');
+        for (const [cat, count] of Object.entries(stats.byCategory)) {
+            lines.push(`    ${cat}: ${count}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=dead-letter-queue.js.map

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

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

package/dist/src/integrations/health-check.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Health Check System
+ *
+ * Proactively detects failing dependencies and provides health status
+ * for LLM providers, MCP servers, databases, and file system access.
+ *
+ * @example
+ * ```typescript
+ * const health = createHealthChecker();
+ *
+ * // Register checks
+ * health.register('llm', async () => {
+ *   await provider.chat([{ role: 'user', content: 'ping' }]);
+ *   return true;
+ * });
+ *
+ * // Check all
+ * const report = await health.checkAll();
+ * console.log(report.healthy ? 'All systems go!' : 'Issues detected');
+ *
+ * // Start periodic checks
+ * health.startPeriodicChecks(60000); // Every minute
+ * ```
+ */
+/**
+ * Result of a single health check.
+ */
+export interface HealthCheckResult {
+    /** Name of the check */
+    name: string;
+    /** Whether the check passed */
+    healthy: boolean;
+    /** Time taken for the check in ms */
+    latencyMs: number;
+    /** Error message if unhealthy */
+    error?: string;
+    /** Timestamp of the check */
+    timestamp: Date;
+    /** Additional details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Aggregated health report.
+ */
+export interface HealthReport {
+    /** Overall system health */
+    healthy: boolean;
+    /** Number of healthy checks */
+    healthyCount: number;
+    /** Total number of checks */
+    totalCount: number;
+    /** Individual check results */
+    checks: HealthCheckResult[];
+    /** Timestamp of the report */
+    timestamp: Date;
+    /** Total time to run all checks */
+    totalLatencyMs: number;
+}
+/**
+ * Health check function signature.
+ * Returns true if healthy, false or throws if unhealthy.
+ */
+export type HealthCheckFn = () => Promise<boolean>;
+/**
+ * Configuration for a health check.
+ */
+export interface HealthCheckConfig {
+    /** Name of the check */
+    name: string;
+    /** The check function */
+    check: HealthCheckFn;
+    /** Timeout for the check in ms (default: 5000) */
+    timeout?: number;
+    /** Whether this check is critical (default: true) */
+    critical?: boolean;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Configuration for the health checker.
+ */
+export interface HealthCheckerConfig {
+    /** Default timeout for checks in ms */
+    defaultTimeout?: number;
+    /** Whether to run checks in parallel (default: true) */
+    parallel?: boolean;
+    /** Callback when health status changes */
+    onStatusChange?: (name: string, healthy: boolean, previous: boolean | undefined) => void;
+}
+/**
+ * Health check event types.
+ */
+export type HealthEvent = {
+    type: 'check.started';
+    name: string;
+} | {
+    type: 'check.completed';
+    name: string;
+    result: HealthCheckResult;
+} | {
+    type: 'status.changed';
+    name: string;
+    healthy: boolean;
+    previous: boolean | undefined;
+} | {
+    type: 'report.generated';
+    report: HealthReport;
+};
+export type HealthEventListener = (event: HealthEvent) => void;
+/**
+ * Manages health checks for system dependencies.
+ */
+export declare class HealthChecker {
+    private checks;
+    private lastResults;
+    private listeners;
+    private periodicInterval?;
+    private config;
+    constructor(config?: HealthCheckerConfig);
+    /**
+     * Register a health check.
+     */
+    register(name: string, check: HealthCheckFn, options?: Partial<Omit<HealthCheckConfig, 'name' | 'check'>>): void;
+    /**
+     * Unregister a health check.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Run a single health check.
+     */
+    check(name: string): Promise<HealthCheckResult>;
+    /**
+     * Run all health checks.
+     */
+    checkAll(): Promise<HealthReport>;
+    /**
+     * Get the last result for a check.
+     */
+    getLastResult(name: string): HealthCheckResult | undefined;
+    /**
+     * Get all last results.
+     */
+    getAllLastResults(): Map<string, HealthCheckResult>;
+    /**
+     * Check if system is healthy based on last results.
+     * Returns true if all critical checks passed.
+     */
+    isHealthy(): boolean;
+    /**
+     * Get list of unhealthy checks.
+     */
+    getUnhealthyChecks(): string[];
+    /**
+     * Start periodic health checks.
+     */
+    startPeriodicChecks(intervalMs: number): void;
+    /**
+     * Stop periodic health checks.
+     */
+    stopPeriodicChecks(): void;
+    /**
+     * Add an event listener.
+     */
+    on(listener: HealthEventListener): () => void;
+    private emit;
+    /**
+     * Get registered check names.
+     */
+    getCheckNames(): string[];
+    /**
+     * Cleanup resources.
+     */
+    dispose(): void;
+}
+/**
+ * Create a health checker instance.
+ */
+export declare function createHealthChecker(config?: HealthCheckerConfig): HealthChecker;
+/**
+ * Create a health check for an LLM provider.
+ * Uses a minimal ping request to verify connectivity.
+ */
+export declare function createProviderHealthCheck(provider: {
+    chat: (messages: Array<{
+        role: string;
+        content: string;
+    }>) => Promise<unknown>;
+}, providerName?: string): HealthCheckConfig;
+/**
+ * Create a health check for file system access.
+ */
+export declare function createFileSystemHealthCheck(path?: string): HealthCheckConfig;
+/**
+ * Create a health check for SQLite database.
+ */
+export declare function createSQLiteHealthCheck(dbPath: string): HealthCheckConfig;
+/**
+ * Create a health check for MCP server connectivity.
+ */
+export declare function createMCPHealthCheck(mcpClient: {
+    listServers: () => Array<{
+        name: string;
+        status: string;
+    }>;
+}, serverName?: string): HealthCheckConfig;
+/**
+ * Create a health check for network connectivity.
+ */
+export declare function createNetworkHealthCheck(testUrl?: string): HealthCheckConfig;
+/**
+ * Format health report for display.
+ */
+export declare function formatHealthReport(report: HealthReport): string;
+/**
+ * Format health report as JSON for APIs.
+ */
+export declare function healthReportToJSON(report: HealthReport): Record<string, unknown>;
+//# sourceMappingURL=health-check.d.ts.map