#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
fix(health+cli): move heap_tight to notes, harden demo readiness probe
Rohit Ghumare701372231400
diff --git a/src/cli.ts b/src/cli.tsindex 0acc671a..b90d6270 100644--- a/src/cli.ts+++ b/src/cli.ts@@ -81,6 +81,17 @@ async function isEngineRunning(): Promise<boolean> {}}+async function isAgentmemoryReady(): Promise<boolean> {+ try {+ const res = await fetch(`http://localhost:${getRestPort()}/agentmemory/livez`, {+ signal: AbortSignal.timeout(2000),+ });+ return res.ok;+ } catch {+ return false;+ }+}+function findIiiConfig(): string {const candidates = [join(__dirname, "iii-config.yaml"),@@ -616,9 +627,11 @@ async function runDemo() {const base = `http://localhost:${port}`;p.intro("agentmemory demo");- if (!(await isEngineRunning())) {- p.log.error(`Not running — no response on port ${port}`);- p.log.info("Start the server first: npx @agentmemory/agentmemory");+ if (!(await isAgentmemoryReady())) {+ p.log.error(+ `agentmemory worker not reachable on port ${port} (livez probe failed). Something may be on the port but it isn't serving /agentmemory/*.`,+ );+ p.log.info("Start it with: npx @agentmemory/agentmemory");process.exit(1);}diff --git a/src/health/monitor.ts b/src/health/monitor.tsindex 641bb869..953c94a0 100644--- a/src/health/monitor.ts+++ b/src/health/monitor.ts@@ -87,6 +87,7 @@ export function registerHealthMonitor(const evaluated = evaluateHealth(snapshot);snapshot.status = evaluated.status;snapshot.alerts = evaluated.alerts;+ snapshot.notes = evaluated.notes;await kv.set(KV.health, "latest", snapshot).catch(() => {});return snapshot;diff --git a/src/health/thresholds.ts b/src/health/thresholds.tsindex 3d84742e..7279afad 100644--- a/src/health/thresholds.ts+++ b/src/health/thresholds.ts@@ -23,9 +23,10 @@ const DEFAULTS: ThresholdConfig = {export function evaluateHealth(snapshot: HealthSnapshot,config: Partial<ThresholdConfig> = {},-): { status: "healthy" | "degraded" | "critical"; alerts: string[] } {+): { status: "healthy" | "degraded" | "critical"; alerts: string[]; notes: string[] } {const cfg = { ...DEFAULTS, ...config };const alerts: string[] = [];+ const notes: string[] = [];let critical = false;let degraded = false;@@ -72,9 +73,9 @@ export function evaluateHealth(alerts.push(`memory_warn_${Math.round(memPercent)}%_rss${memMb}mb`);degraded = true;} else if (memPercent > cfg.memoryWarnPercent) {- alerts.push(`memory_heap_tight_${Math.round(memPercent)}%_rss${memMb}mb`);+ notes.push(`memory_heap_tight_${Math.round(memPercent)}%_rss${memMb}mb`);}const status = critical ? "critical" : degraded ? "degraded" : "healthy";- return { status, alerts };+ return { status, alerts, notes };}diff --git a/src/types.ts b/src/types.tsindex 636a6111..9eeef947 100644--- a/src/types.ts+++ b/src/types.ts@@ -182,6 +182,7 @@ export interface HealthSnapshot {kvConnectivity?: { status: string; latencyMs?: number; error?: string };status: "healthy" | "degraded" | "critical";alerts: string[];+ notes?: string[];}export interface CircuitBreakerState {diff --git a/src/viewer/index.html b/src/viewer/index.htmlindex 4154c695..f189b5ab 100644--- a/src/viewer/index.html+++ b/src/viewer/index.html@@ -1078,7 +1078,8 @@var heapTotal = Math.round((snap.memory.heapTotal || 0) / 1024 / 1024);var rss = Math.round((snap.memory.rss || 0) / 1024 / 1024);var heapPct = heapTotal > 0 ? Math.round((heapUsed / heapTotal) * 100) : 0;- var heapColor = heapPct > 80 ? 'var(--red)' : heapPct > 60 ? 'var(--yellow)' : 'var(--green)';+ var rssAboveFloor = rss >= 512;+ var heapColor = (heapPct > 80 && rssAboveFloor) ? 'var(--red)' : (heapPct > 60 && rssAboveFloor) ? 'var(--yellow)' : 'var(--green)';html += '<div class="gauge"><span class="gauge-label">Heap</span><div class="gauge-bar"><div class="gauge-fill" style="width:' + heapPct + '%;background:' + heapColor + '"></div></div><span class="gauge-value">' + heapUsed + ' / ' + heapTotal + ' MB</span></div>';html += '<div class="gauge"><span class="gauge-label">RSS</span><div class="gauge-bar"><div class="gauge-fill" style="width:' + Math.min(100, Math.round(rss / 512 * 100)) + '%;background:var(--blue)"></div></div><span class="gauge-value">' + rss + ' MB</span></div>';if (snap.memory.external) {@@ -1113,6 +1114,14 @@html += '</div>';}+ if (snap.notes && snap.notes.length > 0) {+ html += '<div class="card" style="margin-bottom:16px;"><div class="card-title" style="color:var(--ink-muted);">Notes (' + snap.notes.length + ')</div>';+ snap.notes.forEach(function(n) {+ html += '<div style="font-size:12px;color:var(--ink-muted);padding:4px 0;border-bottom:1px solid var(--border-light);font-family:var(--font-ui);">' + esc(n) + '</div>';+ });+ html += '</div>';+ }+html += '<div class="two-col">';html += '<div class="card"><div class="card-title">Recent Sessions</div>';diff --git a/test/health-thresholds.test.ts b/test/health-thresholds.test.tsindex 7636456e..6f918a91 100644--- a/test/health-thresholds.test.ts+++ b/test/health-thresholds.test.ts@@ -27,11 +27,12 @@ describe("evaluateHealth memory severity", () => {external: 0,},});- const { status, alerts } = evaluateHealth(s);+ const { status, alerts, notes } = evaluateHealth(s);expect(status).toBe("healthy");expect(alerts.find((a) => a.startsWith("memory_critical_"))).toBeUndefined();expect(alerts.find((a) => a.startsWith("memory_warn_"))).toBeUndefined();- expect(alerts.find((a) => a.startsWith("memory_heap_tight_"))).toBeDefined();+ expect(alerts.find((a) => a.startsWith("memory_heap_tight_"))).toBeUndefined();+ expect(notes.find((n) => n.startsWith("memory_heap_tight_"))).toBeDefined();});it("goes critical when heap ratio is high AND RSS is above the floor", () => {@@ -57,9 +58,10 @@ describe("evaluateHealth memory severity", () => {external: 0,},});- const { status, alerts } = evaluateHealth(s);+ const { status, alerts, notes } = evaluateHealth(s);expect(status).toBe("healthy");- expect(alerts.some((a) => a.startsWith("memory_heap_tight_"))).toBe(true);+ expect(notes.some((n) => n.startsWith("memory_heap_tight_"))).toBe(true);+ expect(alerts.some((a) => a.startsWith("memory_heap_tight_"))).toBe(false);expect(alerts.some((a) => a.startsWith("memory_warn_"))).toBe(false);expect(alerts.some((a) => a.startsWith("memory_critical_"))).toBe(false);});