agent-comms 2.20.1 → 2.21.0

package/dist/core/stale-agent-checker.d.ts

@@ -0,0 +1,28 @@
+/**
+ * StaleAgentChecker — coordinator-only periodic liveness probe over every registered agent's own PID, marking a dead process's agent offline and, separately, purging agent records that have sat offline past a fixed threshold. Split out of MeshStore purely to keep mesh-store.ts under the repo's max-lines cap; owns its own probe-interval timer exclusively (nothing outside this class ever reads or writes it).
+ */
+import type { AgentIdentity, AgentStatus, DeliveryEvent } from "./types.js";
+import type { MeshStatePatch, PeerInfo } from "./wire-protocol.js";
+/** The state and collaborators StaleAgentChecker needs from MeshStore -- the core agent/delivery/peer/identity Maps it reads and mutates directly (shared references into MeshStore's own fields), plus the two DeliveryEngine operations a status change and an offline patch need to broadcast. */
+export interface StaleAgentCheckerDeps {
+    agents: Map<string, AgentIdentity>;
+    deliveryQueues: Map<string, DeliveryEvent[]>;
+    identityCache: Map<string, {
+        id: string;
+    }>;
+    peerInfo: Map<string, PeerInfo>;
+    notifyRoomsOfStatus: (agentId: string, status: AgentStatus) => Promise<void>;
+    broadcastPatch: (patch: MeshStatePatch) => Promise<void>;
+}
+export declare class StaleAgentChecker {
+    private readonly deps;
+    private timer;
+    constructor(deps: StaleAgentCheckerDeps);
+    /** Starts the periodic probe (coordinator-only). No-op if already running. */
+    start(): void;
+    /** Stops the periodic probe, if running. */
+    stop(): void;
+    private probeStaleAgents;
+    private isProcessAlive;
+}
+//# sourceMappingURL=stale-agent-checker.d.ts.map

package/dist/core/stale-agent-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-agent-checker.d.ts","sourceRoot":"","sources":["../../src/core/stale-agent-checker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnE,qSAAqS;AACrS,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAQD,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,KAAK,CAA6C;gBAE7B,IAAI,EAAE,qBAAqB;IAExD,8EAA8E;IAC9E,KAAK,IAAI,IAAI;IAOb,4CAA4C;IAC5C,IAAI,IAAI,IAAI;YAOE,gBAAgB;IA+C9B,OAAO,CAAC,cAAc;CAQvB"}

package/dist/core/stale-agent-checker.js

@@ -0,0 +1,77 @@
+/**
+ * StaleAgentChecker — coordinator-only periodic liveness probe over every registered agent's own PID, marking a dead process's agent offline and, separately, purging agent records that have sat offline past a fixed threshold. Split out of MeshStore purely to keep mesh-store.ts under the repo's max-lines cap; owns its own probe-interval timer exclusively (nothing outside this class ever reads or writes it).
+ */
+/** How often the coordinator probes registered agent PIDs for liveness. */
+const PROBE_INTERVAL_MS = 5000;
+/** How long an agent may sit "offline" before its record is purged entirely, to prevent indefinite accumulation. */
+const OFFLINE_PURGE_THRESHOLD_MS = 30 * 60 * 1000;
+export class StaleAgentChecker {
+    deps;
+    timer;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Starts the periodic probe (coordinator-only). No-op if already running. */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.probeStaleAgents();
+        }, PROBE_INTERVAL_MS);
+    }
+    /** Stops the periodic probe, if running. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    async probeStaleAgents() {
+        const { agents, deliveryQueues, identityCache, peerInfo, notifyRoomsOfStatus, broadcastPatch, } = this.deps;
+        const deadIds = [];
+        for (const [id, agent] of agents) {
+            if (agent.status !== "active")
+                continue;
+            if (!this.isProcessAlive(agent.pid)) {
+                deadIds.push(id);
+            }
+        }
+        for (const id of deadIds) {
+            const agent = agents.get(id);
+            if (agent) {
+                agent.status = "offline";
+                agents.set(id, agent);
+                await notifyRoomsOfStatus(id, "offline");
+            }
+            await broadcastPatch({ type: "agent_offline", agentId: id });
+            peerInfo.delete(id);
+        }
+        // Also purge long-offline agents to prevent indefinite accumulation.
+        const offlineThreshold = Date.now() - OFFLINE_PURGE_THRESHOLD_MS;
+        const purgeIds = [];
+        for (const [id, agent] of agents) {
+            if (agent.status !== "offline")
+                continue;
+            const startedAt = new Date(agent.startedAt).getTime();
+            if (startedAt < offlineThreshold) {
+                purgeIds.push(id);
+            }
+        }
+        for (const id of purgeIds) {
+            agents.delete(id);
+            peerInfo.delete(id);
+            identityCache.delete(id);
+            deliveryQueues.delete(id);
+        }
+    }
+    isProcessAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=stale-agent-checker.js.map

package/dist/core/stale-agent-checker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "2.20.1",
+  "version": "2.21.0",
   "description": "Cross-harness communication mesh for LLM agents — rooms, DMs, presence, and real-time push delivery over TCP",
   "type": "module",
   "packageManager": "pnpm@10.33.0",