agent-relay 1.0.22 → 1.2.0

package/dist/resiliency/logger.js

@@ -0,0 +1,250 @@
+/**
+ * Structured Logger
+ *
+ * Provides consistent, structured logging across agent-relay components.
+ * - JSON format for machine parsing
+ * - Log levels with filtering
+ * - Context propagation (correlation IDs, agent names)
+ * - File rotation support
+ */
+import { EventEmitter } from 'events';
+import * as fs from 'fs';
+import * as path from 'path';
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    fatal: 4,
+};
+const LEVEL_COLORS = {
+    debug: '\x1b[90m', // gray
+    info: '\x1b[36m', // cyan
+    warn: '\x1b[33m', // yellow
+    error: '\x1b[31m', // red
+    fatal: '\x1b[35m', // magenta
+};
+const RESET = '\x1b[0m';
+const DEFAULT_CONFIG = {
+    level: 'info',
+    json: process.env.NODE_ENV === 'production',
+    console: true,
+    maxFileSize: 10 * 1024 * 1024, // 10MB
+    maxFiles: 5,
+};
+export class Logger extends EventEmitter {
+    config;
+    component;
+    context = {};
+    fileStream;
+    currentFileSize = 0;
+    constructor(component, config = {}) {
+        super();
+        this.component = component;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        if (this.config.file) {
+            this.initFileStream();
+        }
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(context) {
+        const child = new Logger(this.component, this.config);
+        child.context = { ...this.context, ...context };
+        return child;
+    }
+    /**
+     * Set context that will be included in all log entries
+     */
+    setContext(context) {
+        this.context = { ...this.context, ...context };
+    }
+    /**
+     * Log at debug level
+     */
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    /**
+     * Log at info level
+     */
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    /**
+     * Log at warn level
+     */
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    /**
+     * Log at error level
+     */
+    error(message, context) {
+        this.log('error', message, context);
+    }
+    /**
+     * Log at fatal level
+     */
+    fatal(message, context) {
+        this.log('fatal', message, context);
+    }
+    /**
+     * Log with timing (returns function to end timing)
+     */
+    time(message, context) {
+        const start = Date.now();
+        return () => {
+            const duration = Date.now() - start;
+            this.info(message, { ...context, duration });
+        };
+    }
+    /**
+     * Log an error with stack trace
+     */
+    logError(error, message, context) {
+        this.log('error', message || error.message, {
+            ...context,
+            error: {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            },
+        });
+    }
+    /**
+     * Core log method
+     */
+    log(level, message, context) {
+        if (LOG_LEVELS[level] < LOG_LEVELS[this.config.level]) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            component: this.component,
+            message,
+            ...this.context,
+            ...context,
+        };
+        // Emit for external handlers
+        this.emit('log', entry);
+        // Console output
+        if (this.config.console) {
+            this.writeConsole(entry);
+        }
+        // File output
+        if (this.fileStream) {
+            this.writeFile(entry);
+        }
+    }
+    /**
+     * Write to console
+     */
+    writeConsole(entry) {
+        if (this.config.json) {
+            console.log(JSON.stringify(entry));
+        }
+        else {
+            const color = LEVEL_COLORS[entry.level];
+            const levelStr = entry.level.toUpperCase().padEnd(5);
+            const componentStr = `[${entry.component}]`.padEnd(20);
+            let line = `${entry.timestamp} ${color}${levelStr}${RESET} ${componentStr} ${entry.message}`;
+            // Add context fields (exclude standard log entry fields)
+            const { timestamp: _t, level: _l, component: _c, message: _m, ...contextFields } = entry;
+            if (Object.keys(contextFields).length > 0) {
+                line += ` ${JSON.stringify(contextFields)}`;
+            }
+            console.log(line);
+        }
+    }
+    /**
+     * Write to file with rotation
+     */
+    writeFile(entry) {
+        if (!this.fileStream)
+            return;
+        const line = JSON.stringify(entry) + '\n';
+        const lineBytes = Buffer.byteLength(line);
+        // Check if rotation needed
+        if (this.config.maxFileSize &&
+            this.currentFileSize + lineBytes > this.config.maxFileSize) {
+            this.rotateFile();
+        }
+        this.fileStream.write(line);
+        this.currentFileSize += lineBytes;
+    }
+    /**
+     * Initialize file stream
+     */
+    initFileStream() {
+        if (!this.config.file)
+            return;
+        const dir = path.dirname(this.config.file);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Get current file size
+        if (fs.existsSync(this.config.file)) {
+            const stats = fs.statSync(this.config.file);
+            this.currentFileSize = stats.size;
+        }
+        this.fileStream = fs.createWriteStream(this.config.file, { flags: 'a' });
+    }
+    /**
+     * Rotate log file
+     */
+    rotateFile() {
+        if (!this.config.file || !this.fileStream)
+            return;
+        this.fileStream.end();
+        // Rotate existing files
+        for (let i = (this.config.maxFiles || 5) - 1; i >= 1; i--) {
+            const oldPath = `${this.config.file}.${i}`;
+            const newPath = `${this.config.file}.${i + 1}`;
+            if (fs.existsSync(oldPath)) {
+                if (i === (this.config.maxFiles || 5) - 1) {
+                    fs.unlinkSync(oldPath); // Delete oldest
+                }
+                else {
+                    fs.renameSync(oldPath, newPath);
+                }
+            }
+        }
+        // Rename current to .1
+        if (fs.existsSync(this.config.file)) {
+            fs.renameSync(this.config.file, `${this.config.file}.1`);
+        }
+        // Create new stream
+        this.currentFileSize = 0;
+        this.fileStream = fs.createWriteStream(this.config.file, { flags: 'a' });
+    }
+    /**
+     * Close the logger
+     */
+    close() {
+        if (this.fileStream) {
+            this.fileStream.end();
+            this.fileStream = undefined;
+        }
+    }
+}
+// Logger factory with global configuration
+let globalConfig = {};
+export function configure(config) {
+    globalConfig = config;
+}
+export function createLogger(component, config) {
+    return new Logger(component, { ...globalConfig, ...config });
+}
+// Pre-configured loggers for common components
+export const loggers = {
+    daemon: () => createLogger('daemon'),
+    spawner: () => createLogger('spawner'),
+    router: () => createLogger('router'),
+    agent: (name) => createLogger('agent').child({ agentName: name }),
+    health: () => createLogger('health-monitor'),
+    connection: (id) => createLogger('connection').child({ connectionId: id }),
+};
+//# sourceMappingURL=logger.js.map

package/dist/resiliency/logger.js.map

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

package/dist/resiliency/memory-monitor.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Agent Memory Monitor
+ *
+ * Comprehensive memory monitoring for agent processes:
+ * - Detailed memory metrics (RSS, heap, external)
+ * - Memory trend analysis (growing/stable/shrinking)
+ * - High watermark tracking
+ * - Configurable thresholds for proactive alerting
+ * - Memory history for trend analysis
+ * - Crash prevention through memory pressure detection
+ */
+import { EventEmitter } from 'events';
+export interface MemorySnapshot {
+    timestamp: Date;
+    rssBytes: number;
+    heapUsedBytes: number;
+    heapTotalBytes: number;
+    externalBytes: number;
+    cpuPercent: number;
+}
+export interface AgentMemoryMetrics {
+    name: string;
+    pid: number;
+    current: MemorySnapshot;
+    highWatermark: number;
+    lowWatermark: number;
+    averageRss: number;
+    trend: 'growing' | 'stable' | 'shrinking' | 'unknown';
+    trendRatePerMinute: number;
+    alertLevel: 'normal' | 'warning' | 'critical' | 'oom_imminent';
+    lastAlertAt?: Date;
+    memoryHistory: MemorySnapshot[];
+    startedAt: Date;
+    uptimeMs: number;
+}
+export interface MemoryThresholds {
+    warningBytes: number;
+    criticalBytes: number;
+    oomImminentBytes: number;
+    trendGrowthRateWarning: number;
+    historyRetentionMinutes: number;
+    historyMaxSamples: number;
+}
+export interface MemoryMonitorConfig {
+    checkIntervalMs: number;
+    thresholds: MemoryThresholds;
+    enableTrendAnalysis: boolean;
+    enableProactiveAlerts: boolean;
+}
+export interface MemoryAlert {
+    type: 'warning' | 'critical' | 'oom_imminent' | 'trend_warning' | 'recovered';
+    agentName: string;
+    pid: number;
+    currentRss: number;
+    threshold: number;
+    message: string;
+    recommendation: string;
+    timestamp: Date;
+}
+export interface CrashMemoryContext {
+    agentName: string;
+    pid: number;
+    crashTime: Date;
+    lastKnownMemory: MemorySnapshot | null;
+    peakMemory: number;
+    averageMemory: number;
+    memoryTrend: string;
+    recentHistory: MemorySnapshot[];
+    likelyCause: 'oom' | 'memory_leak' | 'sudden_spike' | 'unknown';
+    analysisNotes: string[];
+}
+export declare class AgentMemoryMonitor extends EventEmitter {
+    private agents;
+    private pids;
+    private intervalId?;
+    private config;
+    private isRunning;
+    private alertCooldowns;
+    constructor(config?: Partial<MemoryMonitorConfig>);
+    /**
+     * Register an agent for memory monitoring
+     */
+    register(name: string, pid: number): void;
+    /**
+     * Update PID for an agent (after restart)
+     */
+    updatePid(name: string, newPid: number): void;
+    /**
+     * Unregister an agent
+     */
+    unregister(name: string): void;
+    /**
+     * Start memory monitoring
+     */
+    start(): void;
+    /**
+     * Stop memory monitoring
+     */
+    stop(): void;
+    /**
+     * Get memory metrics for all agents
+     */
+    getAll(): AgentMemoryMetrics[];
+    /**
+     * Get memory metrics for a specific agent
+     */
+    get(name: string): AgentMemoryMetrics | undefined;
+    /**
+     * Get crash context for an agent (for crash analysis)
+     */
+    getCrashContext(name: string): CrashMemoryContext;
+    /**
+     * Get system-wide memory summary
+     */
+    getSystemSummary(): {
+        totalAgents: number;
+        totalMemoryBytes: number;
+        agentsByAlertLevel: Record<string, number>;
+        topMemoryConsumers: Array<{
+            name: string;
+            rssBytes: number;
+        }>;
+        systemMemory: {
+            total: number;
+            free: number;
+            available: number;
+        };
+    };
+    /**
+     * Sample memory for all registered agents
+     */
+    private sampleAll;
+    /**
+     * Sample memory for a single agent
+     */
+    private sampleAgent;
+    /**
+     * Update metrics with new snapshot
+     */
+    private updateMetrics;
+    /**
+     * Analyze memory trend
+     */
+    private analyzeTrend;
+    /**
+     * Check and emit alerts
+     */
+    private checkAlerts;
+    /**
+     * Get memory for a process using ps
+     */
+    private getProcessMemory;
+    /**
+     * Get system memory info
+     */
+    private getSystemMemory;
+    /**
+     * Check if a process is alive
+     */
+    private isProcessAlive;
+    /**
+     * Structured logging
+     */
+    private log;
+}
+/**
+ * Format bytes for human-readable display
+ */
+declare function formatBytes(bytes: number): string;
+export { formatBytes };
+export declare function getMemoryMonitor(config?: Partial<MemoryMonitorConfig>): AgentMemoryMonitor;
+//# sourceMappingURL=memory-monitor.d.ts.map

package/dist/resiliency/memory-monitor.d.ts.map

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