@imenam/mcp-messenger 1.0.3 → 1.0.5

package/dist/src/server/watchers.js

@@ -0,0 +1,69 @@
+/**
+ * Présence des veilleurs, par boîte.
+ *
+ * L'armement du veilleur dépend de l'agent : rien ne peut le déclencher à sa place, et
+ * un agent qui saute l'étape se croit joignable sans l'être. Ce registre rend le fait
+ * observable — `whoami` peut alors répondre « armé » ou « pas armé » plutôt que rien.
+ *
+ * État de connexion, donc volatile : il vit en mémoire du processus serveur et disparaît
+ * avec lui. Le mettre en base ferait croire à un veilleur qui n'existe plus.
+ */
+/**
+ * Un veilleur enchaîne des attentes longues ; entre deux, il n'est plus connecté pendant
+ * quelques millisecondes. Ce délai de grâce évite de le déclarer absent dans cet
+ * intervalle, ou juste après qu'un message a mis fin à son attente.
+ */
+const GRACE_MS = 2 * 60 * 1000;
+export class WatcherRegistry {
+    now;
+    presence = new Map();
+    /** L'horloge est injectable : le délai de grâce se teste sans faire attendre la suite. */
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    /** Déclare une attente de veilleur. La fonction rendue la clôt, et doit toujours être appelée. */
+    begin(agentId) {
+        const now = this.now();
+        const current = this.presence.get(agentId);
+        // Une absence dépassant le délai de grâce commence une nouvelle série : `since`
+        // désigne le moment où ce veilleur-ci s'est armé, pas un ancêtre oublié.
+        const continuing = current && now - current.lastSeen <= GRACE_MS;
+        const entry = continuing
+            ? { ...current, inflight: current.inflight + 1, lastSeen: now }
+            : { inflight: 1, since: now, lastSeen: now };
+        this.presence.set(agentId, entry);
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            const active = this.presence.get(agentId);
+            if (!active)
+                return;
+            // On garde l'entrée après la dernière attente : c'est elle qui porte le délai de
+            // grâce, le temps que le veilleur relance son tour suivant.
+            this.presence.set(agentId, {
+                ...active,
+                inflight: Math.max(0, active.inflight - 1),
+                lastSeen: this.now(),
+            });
+        };
+    }
+    status(agentId) {
+        const now = this.now();
+        const entry = this.presence.get(agentId);
+        if (!entry)
+            return { armed: false, since: null, last_seen: null };
+        const armed = entry.inflight > 0 || now - entry.lastSeen <= GRACE_MS;
+        if (!armed) {
+            // Purge à la lecture : sans veilleur pour cette boîte, l'entrée n'a plus d'objet.
+            this.presence.delete(agentId);
+            return { armed: false, since: null, last_seen: new Date(entry.lastSeen).toISOString() };
+        }
+        return {
+            armed: true,
+            since: new Date(entry.since).toISOString(),
+            last_seen: new Date(entry.lastSeen).toISOString(),
+        };
+    }
+}

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "1.0.3";
+export declare const APP_VERSION = "1.0.5";

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Généré par scripts/generate-version.js — ne pas modifier à la main.
-export const APP_VERSION = "1.0.3";
+export const APP_VERSION = "1.0.5";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imenam/mcp-messenger",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "main": "dist/src/index.js",
   "scripts": {
     "test": "npm run build && vitest run",
@@ -48,6 +48,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/express": "^5.0.6",
     "@types/node": "^22.20.1",
+    "@vitest/coverage-v8": "^3.2.7",
     "typescript": "^5.9.3",
     "vitest": "^3.2.7"
   },