@agent-relay/daemon 0.1.0

package/dist/relay-ledger.js

@@ -0,0 +1,532 @@
+/**
+ * Relay Ledger - SQLite-based tracking of relay file processing
+ *
+ * Tracks files discovered in agent outboxes through their lifecycle:
+ * pending -> processing -> delivered/failed -> archived
+ *
+ * Features:
+ * - Atomic claims with status WHERE clause
+ * - Crash recovery (reset processing -> pending on startup)
+ * - Archive path tracking for auditing
+ * - Configurable retention
+ * - Schema migrations for version upgrades
+ */
+import Database from 'better-sqlite3';
+import path from 'node:path';
+import fs from 'node:fs';
+import crypto from 'node:crypto';
+import { runMigrations, getPendingMigrations, verifyMigrations } from './migrations/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_ARCHIVE_RETENTION_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const DEFAULT_BUSY_TIMEOUT = 5000;
+// Reserved agent names for special routing
+const RESERVED_AGENT_NAMES = new Set(['Lead', 'System', 'Broadcast', '*']);
+// ============================================================================
+// RelayLedger Class
+// ============================================================================
+export class RelayLedger {
+    db;
+    config;
+    // Prepared statements for performance
+    stmtInsert;
+    stmtClaim;
+    stmtUpdateStatus;
+    stmtMarkDelivered;
+    stmtMarkFailed;
+    stmtMarkArchived;
+    stmtGetPending;
+    stmtGetByPath;
+    stmtGetById;
+    stmtResetProcessing;
+    stmtCleanupArchived;
+    stmtGetStats;
+    constructor(config) {
+        this.config = {
+            dbPath: config.dbPath,
+            maxRetries: config.maxRetries ?? DEFAULT_MAX_RETRIES,
+            archiveRetentionMs: config.archiveRetentionMs ?? DEFAULT_ARCHIVE_RETENTION_MS,
+            busyTimeout: config.busyTimeout ?? DEFAULT_BUSY_TIMEOUT,
+        };
+        // Ensure directory exists
+        const dbDir = path.dirname(this.config.dbPath);
+        if (!fs.existsSync(dbDir)) {
+            fs.mkdirSync(dbDir, { recursive: true });
+        }
+        // Open database with recommended settings
+        this.db = new Database(this.config.dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma(`busy_timeout = ${this.config.busyTimeout}`);
+        this.db.pragma('synchronous = NORMAL');
+        this.db.pragma('foreign_keys = ON');
+        this.initSchema();
+        this.prepareStatements();
+    }
+    /** Last migration result (for debugging) */
+    lastMigrationResult;
+    /**
+     * Initialize database schema using migrations
+     */
+    initSchema() {
+        // Run migrations (creates tables if they don't exist, or upgrades existing schema)
+        this.lastMigrationResult = runMigrations(this.db);
+        // Log migration results for debugging
+        if (this.lastMigrationResult.applied.length > 0) {
+            console.log(`[relay-ledger] Applied migrations: ${this.lastMigrationResult.applied.join(', ')}`);
+        }
+        if (this.lastMigrationResult.errors.length > 0) {
+            console.error(`[relay-ledger] Migration errors:`, this.lastMigrationResult.errors);
+        }
+    }
+    /**
+     * Get the last migration result
+     */
+    getMigrationResult() {
+        return this.lastMigrationResult;
+    }
+    /**
+     * Get pending migrations that haven't been applied
+     */
+    getPendingMigrations() {
+        return getPendingMigrations(this.db);
+    }
+    /**
+     * Verify migration checksums match what was originally applied
+     */
+    verifyMigrationIntegrity() {
+        return verifyMigrations(this.db);
+    }
+    /**
+     * Prepare frequently-used statements
+     */
+    prepareStatements() {
+        this.stmtInsert = this.db.prepare(`
+      INSERT INTO relay_files (file_id, source_path, symlink_path, agent_name, message_type, discovered_at, file_size, content_hash, file_mtime_ns, file_inode)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(file_id) DO NOTHING
+    `);
+        this.stmtClaim = this.db.prepare(`
+      UPDATE relay_files
+      SET status = 'processing', retries = retries + 1
+      WHERE file_id = ? AND status = 'pending' AND retries < max_retries
+      RETURNING *
+    `);
+        this.stmtUpdateStatus = this.db.prepare(`
+      UPDATE relay_files SET status = ? WHERE file_id = ?
+    `);
+        this.stmtMarkDelivered = this.db.prepare(`
+      UPDATE relay_files
+      SET status = 'delivered', processed_at = ?
+      WHERE file_id = ?
+    `);
+        this.stmtMarkFailed = this.db.prepare(`
+      UPDATE relay_files
+      SET status = 'failed', processed_at = ?, error = ?
+      WHERE file_id = ?
+    `);
+        this.stmtMarkArchived = this.db.prepare(`
+      UPDATE relay_files
+      SET status = 'archived', archive_path = ?, archived_at = ?
+      WHERE file_id = ?
+    `);
+        this.stmtGetPending = this.db.prepare(`
+      SELECT * FROM relay_files
+      WHERE status = 'pending' AND retries < max_retries
+      ORDER BY id ASC
+      LIMIT ?
+    `);
+        this.stmtGetByPath = this.db.prepare(`
+      SELECT * FROM relay_files WHERE source_path = ?
+    `);
+        this.stmtGetById = this.db.prepare(`
+      SELECT * FROM relay_files WHERE file_id = ?
+    `);
+        this.stmtResetProcessing = this.db.prepare(`
+      UPDATE relay_files
+      SET status = 'pending'
+      WHERE status = 'processing'
+    `);
+        this.stmtCleanupArchived = this.db.prepare(`
+      DELETE FROM relay_files
+      WHERE status = 'archived' AND archived_at < ?
+    `);
+        this.stmtGetStats = this.db.prepare(`
+      SELECT status, COUNT(*) as count FROM relay_files GROUP BY status
+    `);
+    }
+    /**
+     * Generate a unique file ID (12-char hex for ~281 trillion combinations)
+     */
+    generateFileId() {
+        return crypto.randomBytes(6).toString('hex');
+    }
+    /**
+     * Check if an agent name is reserved
+     */
+    isReservedAgentName(name) {
+        return RESERVED_AGENT_NAMES.has(name);
+    }
+    /**
+     * Register a newly discovered file
+     * @param sourcePath - Canonical path (symlinks resolved)
+     * @param agentName - Agent that owns the file
+     * @param messageType - Type of message (msg, spawn, release, etc.)
+     * @param fileSize - Size in bytes
+     * @param contentHash - Optional hash for deduplication
+     * @param fileMtimeNs - Optional modification time in nanoseconds
+     * @param fileInode - Optional inode number
+     * @param symlinkPath - Original path if it was a symlink (for debugging)
+     */
+    registerFile(sourcePath, agentName, messageType, fileSize, contentHash, fileMtimeNs, fileInode, symlinkPath) {
+        const fileId = this.generateFileId();
+        const now = Date.now();
+        this.stmtInsert.run(fileId, sourcePath, symlinkPath ?? null, agentName, messageType, now, fileSize, contentHash ?? null, fileMtimeNs ?? null, fileInode ?? null);
+        return fileId;
+    }
+    /**
+     * Check if a file is already registered
+     */
+    isFileRegistered(sourcePath) {
+        const row = this.stmtGetByPath.get(sourcePath);
+        return row !== undefined;
+    }
+    /**
+     * Atomically claim a file for processing
+     * Returns the record if claim succeeded, null otherwise
+     */
+    claimFile(fileId) {
+        const row = this.stmtClaim.get(fileId);
+        if (!row) {
+            // Check why claim failed
+            const existing = this.stmtGetById.get(fileId);
+            if (!existing) {
+                return { success: false, reason: 'File not found' };
+            }
+            if (existing.status !== 'pending') {
+                return { success: false, reason: `File status is ${existing.status}, not pending` };
+            }
+            if (existing.retries >= existing.max_retries) {
+                return { success: false, reason: `Max retries (${existing.max_retries}) exceeded` };
+            }
+            return { success: false, reason: 'Unknown claim failure' };
+        }
+        return {
+            success: true,
+            record: this.rowToRecord(row),
+        };
+    }
+    /**
+     * Mark a file as successfully delivered
+     */
+    markDelivered(fileId) {
+        this.stmtMarkDelivered.run(Date.now(), fileId);
+    }
+    /**
+     * Mark a file as failed (will retry if under max retries)
+     */
+    markFailed(fileId, error) {
+        const record = this.getById(fileId);
+        if (!record)
+            return;
+        if (record.retries >= record.maxRetries) {
+            // Permanent failure
+            this.stmtMarkFailed.run(Date.now(), error, fileId);
+        }
+        else {
+            // Reset to pending for retry
+            this.stmtUpdateStatus.run('pending', fileId);
+        }
+    }
+    /**
+     * Mark a file as archived (moved to archive location)
+     */
+    markArchived(fileId, archivePath) {
+        this.stmtMarkArchived.run(archivePath, Date.now(), fileId);
+    }
+    /**
+     * Get pending files ready for processing
+     */
+    getPendingFiles(limit = 100) {
+        const rows = this.stmtGetPending.all(limit);
+        return rows.map(row => this.rowToRecord(row));
+    }
+    /**
+     * Get a file record by ID
+     */
+    getById(fileId) {
+        const row = this.stmtGetById.get(fileId);
+        return row ? this.rowToRecord(row) : null;
+    }
+    /**
+     * Get a file record by source path
+     */
+    getByPath(sourcePath) {
+        const row = this.stmtGetByPath.get(sourcePath);
+        return row ? this.rowToRecord(row) : null;
+    }
+    /**
+     * Reset all 'processing' files to 'pending' (crash recovery)
+     */
+    resetProcessingFiles() {
+        const result = this.stmtResetProcessing.run();
+        return result.changes;
+    }
+    /**
+     * Mark files as failed if their source file no longer exists
+     */
+    reconcileWithFilesystem() {
+        let reset = 0;
+        let failed = 0;
+        // Get all processing files
+        const processingFiles = this.db
+            .prepare(`SELECT * FROM relay_files WHERE status = 'processing'`)
+            .all();
+        for (const row of processingFiles) {
+            if (!fs.existsSync(row.source_path)) {
+                // File was deleted while processing - mark as failed
+                this.stmtMarkFailed.run(Date.now(), 'Source file deleted during processing', row.file_id);
+                failed++;
+            }
+            else {
+                // Reset to pending
+                this.stmtUpdateStatus.run('pending', row.file_id);
+                reset++;
+            }
+        }
+        return { reset, failed };
+    }
+    /**
+     * Clean up old archived records
+     */
+    cleanupArchivedRecords() {
+        const cutoff = Date.now() - this.config.archiveRetentionMs;
+        const result = this.stmtCleanupArchived.run(cutoff);
+        return result.changes;
+    }
+    /**
+     * Get statistics about file processing
+     */
+    getStats() {
+        const rows = this.stmtGetStats.all();
+        const stats = {
+            pending: 0,
+            processing: 0,
+            delivered: 0,
+            failed: 0,
+            archived: 0,
+        };
+        for (const row of rows) {
+            stats[row.status] = row.count;
+        }
+        return stats;
+    }
+    /**
+     * Convert database row to RelayFileRecord
+     */
+    rowToRecord(row) {
+        return {
+            id: row.id,
+            fileId: row.file_id,
+            sourcePath: row.source_path,
+            symlinkPath: row.symlink_path,
+            archivePath: row.archive_path,
+            agentName: row.agent_name,
+            messageType: row.message_type,
+            status: row.status,
+            retries: row.retries,
+            maxRetries: row.max_retries,
+            discoveredAt: row.discovered_at,
+            processedAt: row.processed_at,
+            archivedAt: row.archived_at,
+            error: row.error,
+            contentHash: row.content_hash,
+            fileSize: row.file_size,
+            fileMtimeNs: row.file_mtime_ns,
+            fileInode: row.file_inode,
+        };
+    }
+    // ==========================================================================
+    // Agent Management
+    // ==========================================================================
+    /**
+     * Register or update an agent
+     */
+    registerAgent(agentName, metadata) {
+        const now = Date.now();
+        const metadataJson = metadata ? JSON.stringify(metadata) : null;
+        this.db.prepare(`
+      INSERT INTO agents (agent_name, created_at, last_seen_at, status, metadata)
+      VALUES (?, ?, ?, 'active', ?)
+      ON CONFLICT(agent_name) DO UPDATE SET
+        last_seen_at = excluded.last_seen_at,
+        status = 'active',
+        metadata = COALESCE(excluded.metadata, agents.metadata)
+    `).run(agentName, now, now, metadataJson);
+    }
+    /**
+     * Update agent last seen time
+     */
+    updateAgentLastSeen(agentName) {
+        this.db.prepare(`
+      UPDATE agents SET last_seen_at = ? WHERE agent_name = ?
+    `).run(Date.now(), agentName);
+    }
+    /**
+     * Mark agent as inactive
+     */
+    markAgentInactive(agentName) {
+        this.db.prepare(`
+      UPDATE agents SET status = 'inactive' WHERE agent_name = ?
+    `).run(agentName);
+    }
+    /**
+     * Get all active agents
+     */
+    getActiveAgents() {
+        const rows = this.db.prepare(`
+      SELECT * FROM agents WHERE status = 'active' ORDER BY last_seen_at DESC
+    `).all();
+        return rows.map(row => ({
+            id: row.id,
+            agentName: row.agent_name,
+            createdAt: row.created_at,
+            lastSeenAt: row.last_seen_at,
+            status: row.status,
+            metadata: row.metadata ? JSON.parse(row.metadata) : null,
+        }));
+    }
+    /**
+     * Get agent by name
+     */
+    getAgent(agentName) {
+        const row = this.db.prepare(`
+      SELECT * FROM agents WHERE agent_name = ?
+    `).get(agentName);
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            agentName: row.agent_name,
+            createdAt: row.created_at,
+            lastSeenAt: row.last_seen_at,
+            status: row.status,
+            metadata: row.metadata ? JSON.parse(row.metadata) : null,
+        };
+    }
+    // ==========================================================================
+    // Orchestrator State
+    // ==========================================================================
+    /**
+     * Save orchestrator state
+     */
+    saveState(key, value) {
+        this.db.prepare(`
+      INSERT INTO orchestrator_state (key, value, updated_at)
+      VALUES (?, ?, ?)
+      ON CONFLICT(key) DO UPDATE SET
+        value = excluded.value,
+        updated_at = excluded.updated_at
+    `).run(key, value, Date.now());
+    }
+    /**
+     * Get orchestrator state
+     */
+    getState(key) {
+        const row = this.db.prepare(`
+      SELECT value FROM orchestrator_state WHERE key = ?
+    `).get(key);
+        return row?.value ?? null;
+    }
+    /**
+     * Delete orchestrator state
+     */
+    deleteState(key) {
+        this.db.prepare(`
+      DELETE FROM orchestrator_state WHERE key = ?
+    `).run(key);
+    }
+    /**
+     * Get all orchestrator state
+     */
+    getAllState() {
+        const rows = this.db.prepare(`
+      SELECT * FROM orchestrator_state ORDER BY key
+    `).all();
+        return rows.map(row => ({
+            key: row.key,
+            value: row.value,
+            updatedAt: row.updated_at,
+        }));
+    }
+    // ==========================================================================
+    // Pending Operations (for crash recovery)
+    // ==========================================================================
+    /**
+     * Add a pending operation
+     */
+    addPendingOperation(operationType, targetId, payload) {
+        const result = this.db.prepare(`
+      INSERT INTO pending_operations (operation_type, target_id, payload, created_at)
+      VALUES (?, ?, ?, ?)
+    `).run(operationType, targetId, payload ?? null, Date.now());
+        return result.lastInsertRowid;
+    }
+    /**
+     * Complete a pending operation (remove it)
+     */
+    completePendingOperation(id) {
+        this.db.prepare(`
+      DELETE FROM pending_operations WHERE id = ?
+    `).run(id);
+    }
+    /**
+     * Fail a pending operation (increment attempts, record error)
+     */
+    failPendingOperation(id, error) {
+        this.db.prepare(`
+      UPDATE pending_operations
+      SET attempts = attempts + 1, last_attempt_at = ?, error = ?
+      WHERE id = ?
+    `).run(Date.now(), error, id);
+    }
+    /**
+     * Get pending operations for recovery
+     */
+    getPendingOperations(maxAttempts = 5) {
+        const rows = this.db.prepare(`
+      SELECT * FROM pending_operations
+      WHERE attempts < ?
+      ORDER BY created_at ASC
+    `).all(maxAttempts);
+        return rows.map(row => ({
+            id: row.id,
+            operationType: row.operation_type,
+            targetId: row.target_id,
+            payload: row.payload,
+            createdAt: row.created_at,
+            attempts: row.attempts,
+            lastAttemptAt: row.last_attempt_at,
+            error: row.error,
+        }));
+    }
+    /**
+     * Cleanup old failed operations
+     */
+    cleanupFailedOperations(maxAge = 24 * 60 * 60 * 1000) {
+        const cutoff = Date.now() - maxAge;
+        const result = this.db.prepare(`
+      DELETE FROM pending_operations
+      WHERE created_at < ? AND attempts >= 5
+    `).run(cutoff);
+        return result.changes;
+    }
+    /**
+     * Close the database connection
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=relay-ledger.js.map

package/dist/relay-ledger.js.map

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

package/dist/relay-watchdog.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Relay Watchdog - File-based relay message detection and processing
+ *
+ * Monitors agent outbox directories for new relay files and processes them:
+ * 1. Detects new files via fs.watch + periodic reconciliation
+ * 2. Validates files (size > 0, not symlink, settled)
+ * 3. Claims files atomically via ledger
+ * 4. Processes and archives files
+ *
+ * Features:
+ * - fsevents/inotify watchers with overflow fallback
+ * - Configurable settle time for file stability
+ * - Symlink rejection (security)
+ * - Orphaned .pending file cleanup
+ * - Crash recovery on startup
+ */
+import { EventEmitter } from 'node:events';
+import { type RelayFileRecord } from './relay-ledger.js';
+import { type RelayPaths } from '@agent-relay/config/relay-file-writer';
+export interface WatchdogConfig {
+    /** Base relay paths (auto-detected if not provided) */
+    relayPaths?: RelayPaths;
+    /** Ledger database path (default: ~/.agent-relay/meta/ledger.sqlite) */
+    ledgerPath?: string;
+    /** Settle time before processing file (default: 500ms) */
+    settleTimeMs?: number;
+    /** Timeout for malformed/incomplete files (default: 10000ms) */
+    malformedTimeoutMs?: number;
+    /** Interval for periodic reconciliation (default: 30000ms) */
+    reconcileIntervalMs?: number;
+    /** Maximum message size in bytes (default: 1MB) */
+    maxMessageSizeBytes?: number;
+    /** Maximum attachment size in bytes (default: 10MB) */
+    maxAttachmentSizeBytes?: number;
+    /** Cleanup interval for orphaned files (default: 60000ms) */
+    cleanupIntervalMs?: number;
+    /** Age threshold for orphaned .pending files (default: 30000ms) */
+    orphanedPendingAgeMs?: number;
+    /** Archive retention in milliseconds (default: 7 days) */
+    archiveRetentionMs?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface DiscoveredFile {
+    path: string;
+    agentName: string;
+    messageType: string;
+    size: number;
+    mtime: number;
+    contentHash?: string;
+}
+export interface ProcessedFile {
+    fileId: string;
+    agentName: string;
+    messageType: string;
+    content: string;
+    headers: Record<string, string>;
+    body: string;
+}
+export interface WatchdogEvents {
+    'file:discovered': (file: DiscoveredFile) => void;
+    'file:processing': (record: RelayFileRecord) => void;
+    'file:delivered': (result: ProcessedFile) => void;
+    'file:failed': (record: RelayFileRecord, error: Error) => void;
+    'file:archived': (record: RelayFileRecord, archivePath: string) => void;
+    'watcher:overflow': (dir: string) => void;
+    'reconcile:complete': (stats: {
+        discovered: number;
+        failed: number;
+    }) => void;
+    error: (error: Error) => void;
+}
+export declare class RelayWatchdog extends EventEmitter {
+    private config;
+    private relayPaths;
+    private ledger;
+    private watchers;
+    private pendingFiles;
+    private reconcileTimer?;
+    private cleanupTimer?;
+    private running;
+    constructor(config?: WatchdogConfig);
+    /**
+     * Resolve symlinks in relay paths for cloud/production workspace support
+     * This ensures we work with canonical paths even when directories are symlinked
+     */
+    private resolveRelayPaths;
+    /**
+     * Start the watchdog
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the watchdog
+     */
+    stop(): Promise<void>;
+    /**
+     * Get ledger statistics
+     */
+    getStats(): Record<string, number>;
+    /**
+     * Get pending file count
+     */
+    getPendingCount(): number;
+    private ensureDirectories;
+    private startRootWatcher;
+    private startAgentWatchers;
+    private checkAndWatchAgentDir;
+    private startAgentWatcher;
+    private handleFileEvent;
+    private processDiscoveredFile;
+    private validateFile;
+    private calculateFileHash;
+    private processFile;
+    private parseFileContent;
+    private archiveFile;
+    private fullReconciliation;
+    private cleanupOrphanedFiles;
+    private shouldIgnore;
+    private log;
+}
+export interface RelayWatchdog {
+    on<K extends keyof WatchdogEvents>(event: K, listener: WatchdogEvents[K]): this;
+    emit<K extends keyof WatchdogEvents>(event: K, ...args: Parameters<WatchdogEvents[K]>): boolean;
+}
+//# sourceMappingURL=relay-watchdog.d.ts.map

package/dist/relay-watchdog.d.ts.map

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