@imenam/mcp-messenger 1.0.28 → 1.0.29

package/README.md

@@ -136,11 +136,10 @@ enable_notifications()      → retourne immédiatement, ne bloque rien
   Last step — call the Monitor tool now, with exactly these arguments:
     command:     npx -y @imenam/mcp-messenger --watch box_9f2c4a01b3d7e5f8
     description: Incoming messenger messages
-    persistent:  true
+    timeout_ms:  1800000
 ```
 
-L'agent recopie ces trois arguments dans l'outil `Monitor` de son hôte, et c'est fini pour la
-session. Le veilleur tourne en fond, tient une attente longue sur `/api/wait`, et écrit **une
+L'agent recopie ces trois arguments dans l'outil `Monitor` de son hôte. Le veilleur tourne en fond, tient une attente longue sur `/api/wait`, et écrit **une
 ligne par message** sur sa sortie standard :
 
 ```
@@ -149,6 +148,13 @@ ligne par message** sur sa sortie standard :
 
 Chaque ligne réveille l'agent, qui appelle `read_message` s'il décide de traiter le message.
 
+**Réarmer à l'expiration.** Claude Code arrête tout `Monitor` au bout de 30 minutes au plus,
+quelle que soit la durée demandée, et prévient l'agent. Ce minuteur appartient à l'hôte : le
+veilleur ne peut ni le prolonger ni le remettre à zéro. L'agent relance donc le même appel
+`Monitor` à chaque expiration, sans repasser par `enable_notifications` — la réponse de cet
+outil, les instructions du serveur et le bloc `CLAUDE.md` le lui disent. Le délai de grâce
+décrit plus bas couvre l'intervalle : `whoami` reste à « armed » pendant le réarmement.
+
 **Pourquoi deux appels et pas un.** Armer un réveil, c'est ouvrir un canal vers la boucle de
 la session hôte. Un serveur MCP ne peut pas le faire seul : `Monitor` est un outil de l'hôte,
 seul le modèle peut l'appeler. `enable_notifications` fait donc tout le reste — il connaît

package/dist/src/cli/setup-mcp.js

@@ -56,6 +56,10 @@ Au démarrage de la session, avant toute autre chose : appeler \`enable_notifica
 puis armer l'outil \`Monitor\` avec la commande exacte qu'il retourne. Sans cela, aucun
 message ne parviendra à l'agent — il ne l'apprendra qu'en appelant \`list_messages\`.
 
+L'hôte arrête le veilleur au bout de 30 minutes au plus. À chaque expiration signalée,
+le réarmer aussitôt avec le même appel \`Monitor\`, sans repasser par
+\`enable_notifications\`.
+
 Une fois le veilleur armé, ne rien attendre : les messages entrants interrompent l'agent
 d'eux-mêmes, y compris à l'arrêt. \`wait_for_message\` ne sert plus qu'à bloquer
 volontairement sur une réponse précise.

package/dist/src/mcp/start.js

@@ -39,7 +39,8 @@ Resuming earlier work:
 Writing:
 - One message goes to exactly one mailbox, and never to your own. To reach several correspondents, send each one its own message.
 - Never write a mailbox address in the body of a message. The server attaches the sender and the recipient to every message, and the reader sees them: an address copied by hand adds nothing and misleads as soon as it is stale or mistaken.
-- Call \`enable_notifications\` once at the start of the session and arm the watcher it hands you. Until then, no incoming message reaches you.`;
+- Call \`enable_notifications\` once at the start of the session and arm the watcher it hands you. Until then, no incoming message reaches you.
+- The host stops that watcher after 30 minutes at most. Each time it tells you the watcher expired, re-arm it at once with the same Monitor call; otherwise notifications stop for good.`;
 /** Serveur MCP prêt à être branché sur n'importe quel transport (stdio en production, mémoire en test). */
 export function createMcpServer(client) {
     const server = new Server({ name: "mcp-messenger", version: APP_VERSION }, { capabilities: { tools: {} }, instructions: INSTRUCTIONS });

package/dist/src/mcp/tools.js

@@ -5,6 +5,8 @@ import { rebind } from "./mailbox-registry.js";
 import { forgetCandidate, getResumeState } from "./resume-state.js";
 /** Nom publié : l'agent recopie la commande, il n'a pas à connaître de chemin local. */
 const PACKAGE_NAME = "@imenam/mcp-messenger";
+/** Durée maximale d'un `Monitor` côté hôte : au-delà, l'hôte la ramène à cette valeur. */
+const MONITOR_TIMEOUT_MS = 1_800_000;
 const FOLDER_HINT = `Folder name. System folders: ${SYSTEM_FOLDERS.join(", ")}. Custom folders come from list_folders.`;
 export const TOOLS = [
     {
@@ -217,7 +219,7 @@ export const TOOLS = [
     },
     {
         name: "enable_notifications",
-        description: "Get notified of incoming messages without waiting for them. Returns immediately: it blocks nothing and starts nothing on its own. It hands you the exact Monitor call to make right after — arming that watcher is what actually delivers notifications, and until you do it no message will reach you. Call this once at the start of a session, before any other work; then just keep working, incoming messages will interrupt you on their own.",
+        description: "Get notified of incoming messages without waiting for them. Returns immediately: it blocks nothing and starts nothing on its own. It hands you the exact Monitor call to make right after — arming that watcher is what actually delivers notifications, and until you do it no message will reach you. Call this once at the start of a session, before any other work; then just keep working, incoming messages will interrupt you on their own. The host stops the watcher after 30 minutes at most: re-arm it with the same Monitor call each time it expires.",
         inputSchema: { type: "object", properties: {}, additionalProperties: false },
     },
     {
@@ -522,6 +524,9 @@ export async function callTool(client, name, rawArgs) {
                     `Notifications are already live on mailbox \`${mailbox}\` (watcher armed since ${stats.watcher.since}).`,
                     "Nothing to do: keep working, incoming messages will interrupt you on their own.",
                     "Do not arm a second watcher — you would get every message twice.",
+                    "Only exception: if the host just told you your watcher expired or stopped, re-arm it",
+                    `with the same Monitor call (command \`npx -y ${PACKAGE_NAME} --watch ${mailbox}\`,`,
+                    `timeout_ms ${MONITOR_TIMEOUT_MS}).`,
                 ].join("\n");
             }
             const lines = [
@@ -530,11 +535,15 @@ export async function callTool(client, name, rawArgs) {
                 "Last step — call the Monitor tool now, with exactly these arguments:",
                 `  command:     npx -y ${PACKAGE_NAME} --watch ${mailbox}`,
                 "  description: Incoming messenger messages",
-                "  persistent:  true",
+                `  timeout_ms:  ${MONITOR_TIMEOUT_MS}`,
                 "",
                 "Until that watcher is armed, nothing will reach you: no message will be announced.",
                 "Once it is, keep working normally — each incoming message shows up on its own, even",
                 "while you are idle. One line per message; read it with read_message.",
+                "",
+                "The host stops every monitor after 30 minutes at most. Each time it tells you this",
+                "watcher expired, call Monitor again right away with the same arguments — do not call",
+                "enable_notifications again. Skip that and notifications stop for good.",
             ];
             if (client.isAttachedElsewhere) {
                 lines.push("", `Note: you are attached to \`${mailbox}\`, not to this session's own mailbox ` +

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "1.0.28";
+export declare const APP_VERSION = "1.0.29";

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.28";
+export const APP_VERSION = "1.0.29";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imenam/mcp-messenger",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "main": "dist/src/index.js",
   "scripts": {
     "test": "npm run build && vitest run",