@directive-run/ai 1.13.0 → 1.15.0

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

@@ -0,0 +1,55 @@
+import { H as HealthMonitorConfig } from './types-DJ09LjZX.js';
+
+/**
+ * Health Monitor — tracks per-agent health metrics for self-healing networks.
+ *
+ * Pure computation module with zero Directive dependency.
+ * Maintains a rolling window of success/failure events and computes a health
+ * score from 0-100 based on configurable weights.
+ *
+ * @module
+ */
+
+/** Circuit state values */
+type HealthCircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
+/** Per-agent health metrics */
+interface AgentHealthMetrics {
+    agentId: string;
+    circuitState: HealthCircuitState;
+    successRate: number;
+    avgLatencyMs: number;
+    recentFailures: number;
+    recentSuccesses: number;
+    healthScore: number;
+    /** Last N error messages (most recent last) */
+    lastErrors: string[];
+}
+/** Health monitor instance */
+interface HealthMonitor {
+    recordSuccess(agentId: string, latencyMs: number): void;
+    recordFailure(agentId: string, latencyMs: number, error?: Error): void;
+    getMetrics(agentId: string): AgentHealthMetrics;
+    getAllMetrics(): Record<string, AgentHealthMetrics>;
+    /** Returns a 0-100 health score. Returns 50 (neutral) when no data is available for the agent. */
+    getHealthScore(agentId: string): number;
+    updateCircuitState(agentId: string, state: HealthCircuitState): void;
+    /** Reset all metrics. Useful for testing. */
+    reset(): void;
+}
+/**
+ * Create a health monitor that tracks per-agent metrics.
+ *
+ * @example
+ * ```typescript
+ * const monitor = createHealthMonitor({ windowMs: 30000 });
+ *
+ * monitor.recordSuccess("agent-a", 120);
+ * monitor.recordFailure("agent-a", 5000, new Error("timeout"));
+ *
+ * const score = monitor.getHealthScore("agent-a");
+ * console.log(score); // 0-100
+ * ```
+ */
+declare function createHealthMonitor(config?: HealthMonitorConfig): HealthMonitor;
+
+export { type AgentHealthMetrics as A, type HealthMonitor as H, type HealthCircuitState as a, createHealthMonitor as c };