#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
import type { HealthSnapshot } from "../types.js";
interface ThresholdConfig {
eventLoopLagWarnMs: number;
eventLoopLagCriticalMs: number;
cpuWarnPercent: number;
cpuCriticalPercent: number;
memoryWarnPercent: number;
memoryCriticalPercent: number;
memoryRssFloorBytes: number;
}
const DEFAULTS: ThresholdConfig = {
eventLoopLagWarnMs: 100,
eventLoopLagCriticalMs: 500,
cpuWarnPercent: 80,
cpuCriticalPercent: 90,
memoryWarnPercent: 80,
memoryCriticalPercent: 95,
memoryRssFloorBytes: 512 * 1024 * 1024,
};
export function evaluateHealth(
snapshot: HealthSnapshot,
config: Partial<ThresholdConfig> = {},
): { status: "healthy" | "degraded" | "critical"; alerts: string[]; notes: string[] } {
const cfg = { ...DEFAULTS, ...config };
const alerts: string[] = [];
const notes: string[] = [];
let critical = false;
let degraded = false;
if (
snapshot.connectionState === "disconnected" ||
snapshot.connectionState === "failed"
) {
alerts.push(`connection_${snapshot.connectionState}`);
critical = true;
} else if (snapshot.connectionState === "reconnecting") {
alerts.push("connection_reconnecting");
degraded = true;
}
if (snapshot.eventLoopLagMs > cfg.eventLoopLagCriticalMs) {
alerts.push(
`event_loop_lag_critical_${Math.round(snapshot.eventLoopLagMs)}ms`,
);
critical = true;
} else if (snapshot.eventLoopLagMs > cfg.eventLoopLagWarnMs) {
alerts.push(`event_loop_lag_warn_${Math.round(snapshot.eventLoopLagMs)}ms`);
degraded = true;
}
if (snapshot.cpu.percent > cfg.cpuCriticalPercent) {
alerts.push(`cpu_critical_${Math.round(snapshot.cpu.percent)}%`);
critical = true;
} else if (snapshot.cpu.percent > cfg.cpuWarnPercent) {
alerts.push(`cpu_warn_${Math.round(snapshot.cpu.percent)}%`);
degraded = true;
}
const heapCeiling = snapshot.memory.heapLimit || snapshot.memory.heapTotal;
const memPercent =
heapCeiling > 0 ? (snapshot.memory.heapUsed / heapCeiling) * 100 : 0;
const rss = snapshot.memory.rss ?? 0;
const rssAboveFloor = rss >= cfg.memoryRssFloorBytes;
const memMb = Math.round(rss / (1024 * 1024));
if (memPercent > cfg.memoryCriticalPercent && rssAboveFloor) {
alerts.push(`memory_critical_${Math.round(memPercent)}%_rss${memMb}mb`);
critical = true;
} else if (memPercent > cfg.memoryWarnPercent && rssAboveFloor) {
alerts.push(`memory_warn_${Math.round(memPercent)}%_rss${memMb}mb`);
degraded = true;
} else if (memPercent > cfg.memoryWarnPercent) {
notes.push(`memory_heap_tight_${Math.round(memPercent)}%_rss${memMb}mb`);
}
const status = critical ? "critical" : degraded ? "degraded" : "healthy";
return { status, alerts, notes };
}