@agent-relay/resiliency 0.1.0

package/dist/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/memory-monitor.d.ts.map

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