agent-relay 1.0.22 → 1.2.0

package/dist/resiliency/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Agent Resiliency Module
+ *
+ * Provides comprehensive health monitoring, auto-restart, logging,
+ * metrics, and context persistence for agent-relay agents.
+ *
+ * Features:
+ * - Health monitoring with process liveness checks
+ * - Auto-restart on crash with configurable limits
+ * - Prometheus-compatible metrics export
+ * - Structured JSON logging with rotation
+ * - Context persistence across restarts (inspired by Continuous-Claude-v2)
+ * - Provider-specific context injection (Claude hooks, Codex config, Gemini instructions)
+ *
+ * Usage:
+ *
+ * ```ts
+ * import { getSupervisor, metrics, createLogger } from './resiliency';
+ *
+ * // Start the supervisor with context persistence
+ * const supervisor = getSupervisor({
+ *   autoRestart: true,
+ *   maxRestarts: 5,
+ *   contextPersistence: {
+ *     enabled: true,
+ *     autoInjectOnRestart: true,
+ *   },
+ * });
+ * supervisor.start();
+ *
+ * // Add an agent to supervision
+ * supervisor.supervise(
+ *   {
+ *     name: 'worker-1',
+ *     cli: 'claude',
+ *     pid: 12345,
+ *     spawnedAt: new Date(),
+ *     workingDir: '/path/to/repo',
+ *     provider: 'claude', // or 'codex', 'gemini'
+ *   },
+ *   {
+ *     isAlive: () => process.kill(12345, 0),
+ *     kill: (sig) => process.kill(12345, sig),
+ *     restart: async () => { ... },
+ *   }
+ * );
+ *
+ * // Get metrics
+ * console.log(metrics.toPrometheus());
+ * ```
+ *
+ * Context persistence works differently per provider:
+ * - Claude: Uses hooks to inject context into CLAUDE.md
+ * - Codex: Uses config for periodic context refresh via system prompt
+ * - Gemini: Updates system instruction file
+ */
+export { AgentHealthMonitor, getHealthMonitor, type AgentHealth, type AgentProcess, type HealthMonitorConfig, } from './health-monitor.js';
+export { Logger, createLogger, configure as configureLogging, loggers, type LogLevel, type LogEntry, type LoggerConfig, } from './logger.js';
+export { metrics, type AgentMetrics, type SystemMetrics, type MetricPoint } from './metrics.js';
+export { AgentSupervisor, getSupervisor, type SupervisedAgent, type SupervisorConfig, } from './supervisor.js';
+export { ContextPersistence, getContextPersistence, type AgentState, type Decision, type Artifact, type Handoff, type LedgerEntry, } from './context-persistence.js';
+export { createContextHandler, detectProvider, ClaudeContextHandler, CodexContextHandler, GeminiContextHandler, type ProviderType, type ProviderContextConfig, type ClaudeHooksConfig, type CodexContextConfig, } from './provider-context.js';
+export { AgentMemoryMonitor, getMemoryMonitor, formatBytes, type MemorySnapshot, type AgentMemoryMetrics, type MemoryThresholds, type MemoryMonitorConfig, type MemoryAlert, type CrashMemoryContext, } from './memory-monitor.js';
+export { CrashInsightsService, getCrashInsights, type CrashRecord, type CrashAnalysis, type CrashPattern, type CrashStats, } from './crash-insights.js';
+export { StatelessLeadCoordinator, createStatelessLead, type BeadsTask, type LeadHeartbeat, type StatelessLeadConfig, } from './stateless-lead.js';
+export { LeaderWatchdog, createLeaderWatchdog, type LeaderWatchdogConfig, type ElectionResult, } from './leader-watchdog.js';
+export { GossipHealthMonitor, createGossipHealth, type GossipHeartbeat, type PeerHealth, type GossipHealthConfig, } from './gossip-health.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resiliency/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resiliency/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,MAAM,EACN,YAAY,EACZ,SAAS,IAAI,gBAAgB,EAC7B,OAAO,EACP,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhG,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,WAAW,GACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/resiliency/index.js

@@ -0,0 +1,68 @@
+/**
+ * Agent Resiliency Module
+ *
+ * Provides comprehensive health monitoring, auto-restart, logging,
+ * metrics, and context persistence for agent-relay agents.
+ *
+ * Features:
+ * - Health monitoring with process liveness checks
+ * - Auto-restart on crash with configurable limits
+ * - Prometheus-compatible metrics export
+ * - Structured JSON logging with rotation
+ * - Context persistence across restarts (inspired by Continuous-Claude-v2)
+ * - Provider-specific context injection (Claude hooks, Codex config, Gemini instructions)
+ *
+ * Usage:
+ *
+ * ```ts
+ * import { getSupervisor, metrics, createLogger } from './resiliency';
+ *
+ * // Start the supervisor with context persistence
+ * const supervisor = getSupervisor({
+ *   autoRestart: true,
+ *   maxRestarts: 5,
+ *   contextPersistence: {
+ *     enabled: true,
+ *     autoInjectOnRestart: true,
+ *   },
+ * });
+ * supervisor.start();
+ *
+ * // Add an agent to supervision
+ * supervisor.supervise(
+ *   {
+ *     name: 'worker-1',
+ *     cli: 'claude',
+ *     pid: 12345,
+ *     spawnedAt: new Date(),
+ *     workingDir: '/path/to/repo',
+ *     provider: 'claude', // or 'codex', 'gemini'
+ *   },
+ *   {
+ *     isAlive: () => process.kill(12345, 0),
+ *     kill: (sig) => process.kill(12345, sig),
+ *     restart: async () => { ... },
+ *   }
+ * );
+ *
+ * // Get metrics
+ * console.log(metrics.toPrometheus());
+ * ```
+ *
+ * Context persistence works differently per provider:
+ * - Claude: Uses hooks to inject context into CLAUDE.md
+ * - Codex: Uses config for periodic context refresh via system prompt
+ * - Gemini: Updates system instruction file
+ */
+export { AgentHealthMonitor, getHealthMonitor, } from './health-monitor.js';
+export { Logger, createLogger, configure as configureLogging, loggers, } from './logger.js';
+export { metrics } from './metrics.js';
+export { AgentSupervisor, getSupervisor, } from './supervisor.js';
+export { ContextPersistence, getContextPersistence, } from './context-persistence.js';
+export { createContextHandler, detectProvider, ClaudeContextHandler, CodexContextHandler, GeminiContextHandler, } from './provider-context.js';
+export { AgentMemoryMonitor, getMemoryMonitor, formatBytes, } from './memory-monitor.js';
+export { CrashInsightsService, getCrashInsights, } from './crash-insights.js';
+export { StatelessLeadCoordinator, createStatelessLead, } from './stateless-lead.js';
+export { LeaderWatchdog, createLeaderWatchdog, } from './leader-watchdog.js';
+export { GossipHealthMonitor, createGossipHealth, } from './gossip-health.js';
+//# sourceMappingURL=index.js.map

package/dist/resiliency/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resiliency/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAIjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,MAAM,EACN,YAAY,EACZ,SAAS,IAAI,gBAAgB,EAC7B,OAAO,GAIR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAA2D,MAAM,cAAc,CAAC;AAEhG,OAAO,EACL,eAAe,EACf,aAAa,GAGd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GAMtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,GAOZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAKjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAIpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GAInB,MAAM,oBAAoB,CAAC"}

package/dist/resiliency/leader-watchdog.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Leader Watchdog
+ *
+ * Implements P3: Monitor lead health, trigger promotion if lead dies.
+ * Integrates with AgentSupervisor and heartbeat system.
+ *
+ * Features:
+ * - Monitors leader heartbeat file
+ * - Detects stale/missing leader
+ * - Triggers leader election or self-promotion
+ * - Integrates with supervisor events
+ */
+import { EventEmitter } from 'events';
+import { LeadHeartbeat } from './stateless-lead.js';
+/**
+ * Watchdog configuration
+ */
+export interface LeaderWatchdogConfig {
+    /** Path to .beads directory */
+    beadsDir: string;
+    /** This agent's name */
+    agentName: string;
+    /** This agent's unique ID */
+    agentId: string;
+    /** How often to check leader health (ms) */
+    checkIntervalMs: number;
+    /** Leader considered stale after this duration (ms) */
+    staleThresholdMs: number;
+    /** Callback when this agent should become leader */
+    onBecomeLeader: () => Promise<void>;
+    /** Callback to get all healthy agents for election */
+    getHealthyAgents: () => Promise<Array<{
+        name: string;
+        id: string;
+        spawnedAt: Date;
+    }>>;
+}
+/**
+ * Election result
+ */
+export interface ElectionResult {
+    winner: string;
+    winnerId: string;
+    candidates: string[];
+    method: 'oldest' | 'self' | 'none';
+}
+/**
+ * Leader Watchdog
+ *
+ * Runs on each agent, monitors leader health, triggers election if needed.
+ */
+export declare class LeaderWatchdog extends EventEmitter {
+    private config;
+    private heartbeatPath;
+    private checkInterval?;
+    private isRunning;
+    private currentLeader;
+    private isLeader;
+    constructor(config: LeaderWatchdogConfig);
+    /**
+     * Start watching for leader health
+     */
+    start(): void;
+    /**
+     * Stop watching
+     */
+    stop(): void;
+    /**
+     * Check if current leader is healthy
+     */
+    private checkLeaderHealth;
+    /**
+     * Trigger leader election
+     */
+    private triggerElection;
+    /**
+     * Simple leader election: oldest healthy agent wins
+     */
+    private electLeader;
+    /**
+     * Check if this agent is currently the leader
+     */
+    isCurrentLeader(): boolean;
+    /**
+     * Get current leader info
+     */
+    getCurrentLeader(): LeadHeartbeat | null;
+    /**
+     * Get watchdog status
+     */
+    getStatus(): {
+        isRunning: boolean;
+        isLeader: boolean;
+        currentLeader: LeadHeartbeat | null;
+        agentName: string;
+    };
+}
+/**
+ * Create a leader watchdog with defaults
+ */
+export declare function createLeaderWatchdog(beadsDir: string, agentName: string, agentId: string, callbacks: {
+    onBecomeLeader: () => Promise<void>;
+    getHealthyAgents: () => Promise<Array<{
+        name: string;
+        id: string;
+        spawnedAt: Date;
+    }>>;
+}): LeaderWatchdog;
+//# sourceMappingURL=leader-watchdog.d.ts.map

package/dist/resiliency/leader-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader-watchdog.d.ts","sourceRoot":"","sources":["../../src/resiliency/leader-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAA4B,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;CACvF;AAOD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,oBAAoB;IAMxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAuBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAaZ;;OAEG;YACW,iBAAiB;IAoC/B;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,WAAW;IAyBzB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC;;OAEG;IACH,SAAS,IAAI;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;KACnB;CAQF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE;IACT,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,gBAAgB,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;CACvF,GACA,cAAc,CAShB"}

package/dist/resiliency/leader-watchdog.js

@@ -0,0 +1,189 @@
+/**
+ * Leader Watchdog
+ *
+ * Implements P3: Monitor lead health, trigger promotion if lead dies.
+ * Integrates with AgentSupervisor and heartbeat system.
+ *
+ * Features:
+ * - Monitors leader heartbeat file
+ * - Detects stale/missing leader
+ * - Triggers leader election or self-promotion
+ * - Integrates with supervisor events
+ */
+import * as path from 'path';
+import { EventEmitter } from 'events';
+import { StatelessLeadCoordinator } from './stateless-lead.js';
+const DEFAULT_CONFIG = {
+    checkIntervalMs: 5000,
+    staleThresholdMs: 30000,
+};
+/**
+ * Leader Watchdog
+ *
+ * Runs on each agent, monitors leader health, triggers election if needed.
+ */
+export class LeaderWatchdog extends EventEmitter {
+    config;
+    heartbeatPath;
+    checkInterval;
+    isRunning = false;
+    currentLeader = null;
+    isLeader = false;
+    constructor(config) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.heartbeatPath = path.join(this.config.beadsDir, 'leader-heartbeat.json');
+    }
+    /**
+     * Start watching for leader health
+     */
+    start() {
+        if (this.isRunning)
+            return;
+        this.isRunning = true;
+        console.log(`[watchdog] Started monitoring leader health (${this.config.agentName})`);
+        this.checkInterval = setInterval(async () => {
+            try {
+                await this.checkLeaderHealth();
+            }
+            catch (err) {
+                console.error('[watchdog] Check error:', err);
+                this.emit('error', err);
+            }
+        }, this.config.checkIntervalMs);
+        // Initial check
+        this.checkLeaderHealth().catch((err) => {
+            console.error('[watchdog] Initial check error:', err);
+        });
+        this.emit('started');
+    }
+    /**
+     * Stop watching
+     */
+    stop() {
+        if (!this.isRunning)
+            return;
+        this.isRunning = false;
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = undefined;
+        }
+        console.log(`[watchdog] Stopped monitoring (${this.config.agentName})`);
+        this.emit('stopped');
+    }
+    /**
+     * Check if current leader is healthy
+     */
+    async checkLeaderHealth() {
+        const heartbeat = await StatelessLeadCoordinator.readHeartbeat(this.config.beadsDir);
+        // No leader - trigger election
+        if (!heartbeat) {
+            console.log('[watchdog] No leader detected, triggering election');
+            await this.triggerElection('no_leader');
+            return;
+        }
+        // Check if this is us
+        if (heartbeat.leadId === this.config.agentId) {
+            this.isLeader = true;
+            this.currentLeader = heartbeat;
+            return;
+        }
+        this.isLeader = false;
+        // Check if stale
+        const age = Date.now() - heartbeat.timestamp;
+        if (age > this.config.staleThresholdMs) {
+            console.log(`[watchdog] Leader ${heartbeat.leadName} is stale (${Math.round(age / 1000)}s old)`);
+            this.emit('leaderStale', { leader: heartbeat, age });
+            await this.triggerElection('stale_leader');
+            return;
+        }
+        // Leader is healthy
+        if (!this.currentLeader || this.currentLeader.leadId !== heartbeat.leadId) {
+            console.log(`[watchdog] Leader detected: ${heartbeat.leadName}`);
+            this.emit('leaderDetected', heartbeat);
+        }
+        this.currentLeader = heartbeat;
+    }
+    /**
+     * Trigger leader election
+     */
+    async triggerElection(reason) {
+        console.log(`[watchdog] Triggering election (reason: ${reason})`);
+        this.emit('electionStarted', { reason });
+        const result = await this.electLeader();
+        if (result.method === 'none') {
+            console.log('[watchdog] No candidates for election');
+            this.emit('electionFailed', { reason: 'no_candidates' });
+            return;
+        }
+        console.log(`[watchdog] Election result: ${result.winner} (method: ${result.method})`);
+        this.emit('electionComplete', result);
+        // If we won, become leader
+        if (result.winnerId === this.config.agentId) {
+            console.log(`[watchdog] This agent (${this.config.agentName}) won the election, becoming leader`);
+            this.isLeader = true;
+            await this.config.onBecomeLeader();
+            this.emit('becameLeader');
+        }
+    }
+    /**
+     * Simple leader election: oldest healthy agent wins
+     */
+    async electLeader() {
+        const candidates = await this.config.getHealthyAgents();
+        if (candidates.length === 0) {
+            return {
+                winner: '',
+                winnerId: '',
+                candidates: [],
+                method: 'none',
+            };
+        }
+        // Sort by spawn time (oldest first)
+        candidates.sort((a, b) => a.spawnedAt.getTime() - b.spawnedAt.getTime());
+        const winner = candidates[0];
+        return {
+            winner: winner.name,
+            winnerId: winner.id,
+            candidates: candidates.map((c) => c.name),
+            method: 'oldest',
+        };
+    }
+    /**
+     * Check if this agent is currently the leader
+     */
+    isCurrentLeader() {
+        return this.isLeader;
+    }
+    /**
+     * Get current leader info
+     */
+    getCurrentLeader() {
+        return this.currentLeader;
+    }
+    /**
+     * Get watchdog status
+     */
+    getStatus() {
+        return {
+            isRunning: this.isRunning,
+            isLeader: this.isLeader,
+            currentLeader: this.currentLeader,
+            agentName: this.config.agentName,
+        };
+    }
+}
+/**
+ * Create a leader watchdog with defaults
+ */
+export function createLeaderWatchdog(beadsDir, agentName, agentId, callbacks) {
+    return new LeaderWatchdog({
+        beadsDir,
+        agentName,
+        agentId,
+        ...callbacks,
+        checkIntervalMs: 5000,
+        staleThresholdMs: 30000,
+    });
+}
+//# sourceMappingURL=leader-watchdog.js.map

package/dist/resiliency/leader-watchdog.js.map

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

package/dist/resiliency/logger.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 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';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    component: string;
+    message: string;
+    correlationId?: string;
+    agentName?: string;
+    pid?: number;
+    duration?: number;
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    [key: string]: unknown;
+}
+export interface LoggerConfig {
+    level: LogLevel;
+    json: boolean;
+    file?: string;
+    maxFileSize?: number;
+    maxFiles?: number;
+    console: boolean;
+}
+export declare class Logger extends EventEmitter {
+    private config;
+    private component;
+    private context;
+    private fileStream?;
+    private currentFileSize;
+    constructor(component: string, config?: Partial<LoggerConfig>);
+    /**
+     * Create a child logger with additional context
+     */
+    child(context: Record<string, unknown>): Logger;
+    /**
+     * Set context that will be included in all log entries
+     */
+    setContext(context: Record<string, unknown>): void;
+    /**
+     * Log at debug level
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log at info level
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log at warn level
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log at error level
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log at fatal level
+     */
+    fatal(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log with timing (returns function to end timing)
+     */
+    time(message: string, context?: Record<string, unknown>): () => void;
+    /**
+     * Log an error with stack trace
+     */
+    logError(error: Error, message?: string, context?: Record<string, unknown>): void;
+    /**
+     * Core log method
+     */
+    private log;
+    /**
+     * Write to console
+     */
+    private writeConsole;
+    /**
+     * Write to file with rotation
+     */
+    private writeFile;
+    /**
+     * Initialize file stream
+     */
+    private initFileStream;
+    /**
+     * Rotate log file
+     */
+    private rotateFile;
+    /**
+     * Close the logger
+     */
+    close(): void;
+}
+export declare function configure(config: Partial<LoggerConfig>): void;
+export declare function createLogger(component: string, config?: Partial<LoggerConfig>): Logger;
+export declare const loggers: {
+    daemon: () => Logger;
+    spawner: () => Logger;
+    router: () => Logger;
+    agent: (name: string) => Logger;
+    health: () => Logger;
+    connection: (id: string) => Logger;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/resiliency/logger.d.ts.map

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