@agent-relay/resiliency 0.1.0

package/dist/gossip-health.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Gossip-Based Health Broadcast
+ *
+ * Implements P4: Agents broadcast heartbeats via relay.
+ * Collective failure detection without central monitor.
+ *
+ * Each agent:
+ * - Periodically broadcasts HEARTBEAT message to all agents
+ * - Tracks health of all known peers
+ * - Detects failures when peer heartbeats go stale
+ * - Emits events for peer health changes
+ */
+import { EventEmitter } from 'events';
+/**
+ * Peer health state
+ */
+export interface PeerHealth {
+    name: string;
+    lastHeartbeat: number;
+    load: number;
+    healthy: boolean;
+    isLeader: boolean;
+    taskCount: number;
+}
+/**
+ * Heartbeat payload (broadcast via relay)
+ */
+export interface GossipHeartbeat {
+    type: 'HEARTBEAT';
+    agent: string;
+    agentId: string;
+    timestamp: number;
+    load: number;
+    healthy: boolean;
+    isLeader: boolean;
+    taskCount: number;
+}
+/**
+ * Gossip health configuration
+ */
+export interface GossipHealthConfig {
+    /** This agent's name */
+    agentName: string;
+    /** This agent's unique ID */
+    agentId: string;
+    /** How often to broadcast heartbeat (ms) */
+    broadcastIntervalMs: number;
+    /** Peer considered stale after this duration (ms) */
+    staleThresholdMs: number;
+    /** How often to check for stale peers (ms) */
+    checkIntervalMs: number;
+    /** Callback to broadcast message to all agents */
+    broadcast: (message: string) => Promise<void>;
+    /** Callback to get current load (0-1) */
+    getLoad?: () => number;
+    /** Callback to get current task count */
+    getTaskCount?: () => number;
+    /** Callback to check if this agent is leader */
+    isLeader?: () => boolean;
+}
+/**
+ * Gossip Health Monitor
+ *
+ * Broadcasts heartbeats and tracks peer health via gossip protocol.
+ */
+export declare class GossipHealthMonitor extends EventEmitter {
+    private config;
+    private peers;
+    private broadcastInterval?;
+    private checkInterval?;
+    private isRunning;
+    private healthy;
+    constructor(config: GossipHealthConfig);
+    /**
+     * Start gossip health monitoring
+     */
+    start(): void;
+    /**
+     * Stop gossip health monitoring
+     */
+    stop(): void;
+    /**
+     * Broadcast heartbeat to all agents
+     */
+    private broadcastHeartbeat;
+    /**
+     * Process incoming heartbeat from another agent
+     */
+    processHeartbeat(heartbeat: GossipHeartbeat): void;
+    /**
+     * Parse heartbeat from relay message
+     */
+    static parseHeartbeat(message: string): GossipHeartbeat | null;
+    /**
+     * Check for stale peers
+     */
+    private checkStalePeers;
+    /**
+     * Set this agent's health status
+     */
+    setHealthy(healthy: boolean): void;
+    /**
+     * Get all known peers
+     */
+    getPeers(): PeerHealth[];
+    /**
+     * Get healthy peers
+     */
+    getHealthyPeers(): PeerHealth[];
+    /**
+     * Get current leader from gossip
+     */
+    getLeader(): PeerHealth | null;
+    /**
+     * Get peer by name
+     */
+    getPeer(name: string): PeerHealth | undefined;
+    /**
+     * Get status
+     */
+    getStatus(): {
+        isRunning: boolean;
+        agentName: string;
+        peerCount: number;
+        healthyPeerCount: number;
+        leader: string | null;
+    };
+}
+/**
+ * Create gossip health monitor with defaults
+ */
+export declare function createGossipHealth(agentName: string, agentId: string, broadcast: (message: string) => Promise<void>, options?: {
+    getLoad?: () => number;
+    getTaskCount?: () => number;
+    isLeader?: () => boolean;
+}): GossipHealthMonitor;
+//# sourceMappingURL=gossip-health.d.ts.map

package/dist/gossip-health.d.ts.map

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

package/dist/gossip-health.js

@@ -0,0 +1,241 @@
+/**
+ * Gossip-Based Health Broadcast
+ *
+ * Implements P4: Agents broadcast heartbeats via relay.
+ * Collective failure detection without central monitor.
+ *
+ * Each agent:
+ * - Periodically broadcasts HEARTBEAT message to all agents
+ * - Tracks health of all known peers
+ * - Detects failures when peer heartbeats go stale
+ * - Emits events for peer health changes
+ */
+import { EventEmitter } from 'events';
+const DEFAULT_CONFIG = {
+    broadcastIntervalMs: 10000,
+    staleThresholdMs: 30000,
+    checkIntervalMs: 5000,
+};
+/**
+ * Gossip Health Monitor
+ *
+ * Broadcasts heartbeats and tracks peer health via gossip protocol.
+ */
+export class GossipHealthMonitor extends EventEmitter {
+    config;
+    peers = new Map();
+    broadcastInterval;
+    checkInterval;
+    isRunning = false;
+    healthy = true;
+    constructor(config) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Start gossip health monitoring
+     */
+    start() {
+        if (this.isRunning)
+            return;
+        this.isRunning = true;
+        console.log(`[gossip] Started health broadcast for ${this.config.agentName}`);
+        // Start broadcasting heartbeats
+        this.broadcastInterval = setInterval(async () => {
+            try {
+                await this.broadcastHeartbeat();
+            }
+            catch (err) {
+                console.error('[gossip] Broadcast error:', err);
+            }
+        }, this.config.broadcastIntervalMs);
+        // Start checking for stale peers
+        this.checkInterval = setInterval(() => {
+            this.checkStalePeers();
+        }, this.config.checkIntervalMs);
+        // Initial broadcast
+        this.broadcastHeartbeat().catch((err) => {
+            console.error('[gossip] Initial broadcast error:', err);
+        });
+        this.emit('started');
+    }
+    /**
+     * Stop gossip health monitoring
+     */
+    stop() {
+        if (!this.isRunning)
+            return;
+        this.isRunning = false;
+        if (this.broadcastInterval) {
+            clearInterval(this.broadcastInterval);
+            this.broadcastInterval = undefined;
+        }
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = undefined;
+        }
+        console.log(`[gossip] Stopped health broadcast for ${this.config.agentName}`);
+        this.emit('stopped');
+    }
+    /**
+     * Broadcast heartbeat to all agents
+     */
+    async broadcastHeartbeat() {
+        const heartbeat = {
+            type: 'HEARTBEAT',
+            agent: this.config.agentName,
+            agentId: this.config.agentId,
+            timestamp: Date.now(),
+            load: this.config.getLoad?.() ?? 0,
+            healthy: this.healthy,
+            isLeader: this.config.isLeader?.() ?? false,
+            taskCount: this.config.getTaskCount?.() ?? 0,
+        };
+        const message = `HEARTBEAT: ${JSON.stringify(heartbeat)}`;
+        await this.config.broadcast(message);
+    }
+    /**
+     * Process incoming heartbeat from another agent
+     */
+    processHeartbeat(heartbeat) {
+        // Ignore our own heartbeats
+        if (heartbeat.agentId === this.config.agentId)
+            return;
+        const existing = this.peers.get(heartbeat.agent);
+        const wasHealthy = existing?.healthy ?? true;
+        const wasLeader = existing?.isLeader ?? false;
+        // Update peer state
+        const peer = {
+            name: heartbeat.agent,
+            lastHeartbeat: heartbeat.timestamp,
+            load: heartbeat.load,
+            healthy: heartbeat.healthy,
+            isLeader: heartbeat.isLeader,
+            taskCount: heartbeat.taskCount,
+        };
+        this.peers.set(heartbeat.agent, peer);
+        // Emit events for state changes
+        if (!existing) {
+            this.emit('peerDiscovered', peer);
+        }
+        else {
+            if (!wasHealthy && heartbeat.healthy) {
+                this.emit('peerRecovered', peer);
+            }
+            if (wasHealthy && !heartbeat.healthy) {
+                this.emit('peerUnhealthy', peer);
+            }
+            if (!wasLeader && heartbeat.isLeader) {
+                this.emit('newLeader', peer);
+            }
+        }
+    }
+    /**
+     * Parse heartbeat from relay message
+     */
+    static parseHeartbeat(message) {
+        const match = message.match(/^HEARTBEAT:\s*(.+)$/);
+        if (!match)
+            return null;
+        try {
+            const data = JSON.parse(match[1]);
+            if (data.type === 'HEARTBEAT') {
+                return data;
+            }
+        }
+        catch {
+            // Invalid JSON
+        }
+        return null;
+    }
+    /**
+     * Check for stale peers
+     */
+    checkStalePeers() {
+        const now = Date.now();
+        for (const [name, peer] of this.peers) {
+            const age = now - peer.lastHeartbeat;
+            if (age > this.config.staleThresholdMs) {
+                if (peer.healthy) {
+                    // Mark as unhealthy
+                    peer.healthy = false;
+                    console.log(`[gossip] Peer ${name} is stale (${Math.round(age / 1000)}s since last heartbeat)`);
+                    this.emit('peerStale', { peer, age });
+                    // If the stale peer was leader, emit leader lost
+                    if (peer.isLeader) {
+                        this.emit('leaderLost', peer);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Set this agent's health status
+     */
+    setHealthy(healthy) {
+        if (this.healthy !== healthy) {
+            this.healthy = healthy;
+            // Broadcast immediately on health change
+            this.broadcastHeartbeat().catch((err) => {
+                console.error('[gossip] Immediate broadcast error:', err);
+            });
+        }
+    }
+    /**
+     * Get all known peers
+     */
+    getPeers() {
+        return Array.from(this.peers.values());
+    }
+    /**
+     * Get healthy peers
+     */
+    getHealthyPeers() {
+        return this.getPeers().filter((p) => p.healthy);
+    }
+    /**
+     * Get current leader from gossip
+     */
+    getLeader() {
+        for (const peer of this.peers.values()) {
+            if (peer.isLeader && peer.healthy) {
+                return peer;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get peer by name
+     */
+    getPeer(name) {
+        return this.peers.get(name);
+    }
+    /**
+     * Get status
+     */
+    getStatus() {
+        const leader = this.getLeader();
+        return {
+            isRunning: this.isRunning,
+            agentName: this.config.agentName,
+            peerCount: this.peers.size,
+            healthyPeerCount: this.getHealthyPeers().length,
+            leader: leader?.name ?? null,
+        };
+    }
+}
+/**
+ * Create gossip health monitor with defaults
+ */
+export function createGossipHealth(agentName, agentId, broadcast, options) {
+    return new GossipHealthMonitor({
+        agentName,
+        agentId,
+        broadcast,
+        broadcastIntervalMs: 10000,
+        staleThresholdMs: 30000,
+        checkIntervalMs: 5000,
+        ...options,
+    });
+}
+//# sourceMappingURL=gossip-health.js.map

package/dist/gossip-health.js.map

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

package/dist/health-monitor.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Agent Health Monitor
+ *
+ * Monitors spawned agent processes and ensures they stay alive.
+ * - Periodic health checks (process liveness)
+ * - Auto-restart on crash
+ * - Death detection and logging
+ * - Metrics collection
+ */
+import { EventEmitter } from 'events';
+export interface AgentHealth {
+    name: string;
+    pid: number;
+    status: 'healthy' | 'unresponsive' | 'dead' | 'restarting';
+    lastHealthCheck: Date;
+    lastResponse: Date;
+    restartCount: number;
+    consecutiveFailures: number;
+    uptime: number;
+    startedAt: Date;
+    memoryUsage?: number;
+    cpuUsage?: number;
+    lastError?: string;
+}
+export interface HealthMonitorConfig {
+    checkIntervalMs: number;
+    responseTimeoutMs: number;
+    maxRestarts: number;
+    restartCooldownMs: number;
+    maxConsecutiveFailures: number;
+}
+export interface AgentProcess {
+    name: string;
+    pid: number;
+    isAlive: () => boolean;
+    kill: (signal?: string) => void;
+    restart: () => Promise<void>;
+    sendHealthCheck?: () => Promise<boolean>;
+}
+export declare class AgentHealthMonitor extends EventEmitter {
+    private agents;
+    private health;
+    private intervalId?;
+    private config;
+    private isRunning;
+    constructor(config?: Partial<HealthMonitorConfig>);
+    /**
+     * Register an agent for health monitoring
+     */
+    register(agent: AgentProcess): void;
+    /**
+     * Unregister an agent from health monitoring
+     */
+    unregister(name: string): void;
+    /**
+     * Start the health monitoring loop
+     */
+    start(): void;
+    /**
+     * Stop the health monitoring loop
+     */
+    stop(): void;
+    /**
+     * Get health status for all agents
+     */
+    getAll(): AgentHealth[];
+    /**
+     * Get health status for a specific agent
+     */
+    get(name: string): AgentHealth | undefined;
+    /**
+     * Check health of all registered agents
+     */
+    private checkAll;
+    /**
+     * Check health of a single agent
+     */
+    private checkAgent;
+    /**
+     * Handle agent death - attempt restart or mark as dead
+     */
+    private handleDeath;
+    /**
+     * Check if a process is alive by PID
+     */
+    private isProcessAlive;
+    /**
+     * Get memory and CPU usage for a process
+     */
+    private getProcessUsage;
+    /**
+     * Structured logging
+     */
+    private log;
+}
+export declare function getHealthMonitor(config?: Partial<HealthMonitorConfig>): AgentHealthMonitor;
+//# sourceMappingURL=health-monitor.d.ts.map

package/dist/health-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-monitor.d.ts","sourceRoot":"","sources":["../src/health-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;IAC3D,eAAe,EAAE,IAAI,CAAC;IACtB,YAAY,EAAE,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAUD,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAKrD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAkBnC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAiBb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,MAAM,IAAI,WAAW,EAAE;IAOvB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAQ1C;;OAEG;YACW,QAAQ;IAOtB;;OAEG;YACW,UAAU;IAoExB;;OAEG;YACW,WAAW;IAgEzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;YACW,eAAe;IAgB7B;;OAEG;IACH,OAAO,CAAC,GAAG;CA6BZ;AAKD,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,kBAAkB,CAK1F"}