@imenam/mcp-messenger 1.0.32 → 1.0.34

package/.env.example

@@ -1,78 +1,69 @@
-# ---------------------------------------------------------------------------
-# MCP Messenger — configuration
-# Deux modes, deux jeux de variables. Une même installation peut servir aux deux.
-# ---------------------------------------------------------------------------
-
-# === Mode serveur (boîte aux lettres) : `mcp-messenger --server` ===========
-
-# Port d'écoute. L'interface, elle, n'est pas configurable : le serveur écoute
-# toujours sur 127.0.0.1 et refuse de démarrer si MESSENGER_HOST vaut autre chose.
-# Pour l'atteindre depuis une autre machine, placer un reverse proxy devant.
-MESSENGER_PORT=3600
-
-# Chemin du fichier SQLite (défaut : <cwd>/data/messenger.db).
-# MESSENGER_DB_PATH=/var/lib/mcp-messenger/messenger.db
-
-# Jeton exigé sur TOUTE requête de données (API, /health, données de la console).
-# Seule la page de la console (/ui), qui ne contient aucun secret, est servie sans lui.
-# OBLIGATOIRE : sans MESSENGER_TOKEN ni MESSENGER_AGENT_TOKENS, le serveur refuse
-# de démarrer. Générer avec : npx @imenam/mcp-messenger --generate-token
-MESSENGER_TOKEN=change-me
-
-# Alternative plus stricte : un jeton par agent (prioritaire sur MESSENGER_TOKEN).
-# Un jeton d'agent ne permet pas d'écrire sous l'identité d'un autre agent.
-# Format : agent_id:token,agent_id:token
-# MESSENGER_AGENT_TOKENS=planner:tok-planner,coder:tok-coder
-
-# Jeton de la console web, saisi une fois dans son formulaire (/ui) : le serveur ouvre
-# alors une session de 12 h dans un cookie HttpOnly, sans jamais y mettre le jeton.
-# À défaut, MESSENGER_TOKEN fait office ; il devient obligatoire si seul
-# MESSENGER_AGENT_TOKENS est utilisé.
-# MESSENGER_ADMIN_TOKEN=change-me-too
-
-# Rate limiting (par IP).
-MESSENGER_RATE_LIMIT_MAX=600
-MESSENGER_RATE_LIMIT_WINDOW_MINUTES=15
-
-# Purge automatique de la corbeille (0 = désactivée).
-MESSENGER_TRASH_RETENTION_DAYS=30
-
-# === Mode MCP (côté agent) : `mcp-messenger` ==============================
-
-# Adresse FIXE de l'agent — à laisser vide dans la plupart des cas.
-# Vide : chaque session reçoit sa propre boîte (`box_…`), allouée au démarrage. Deux
-#   sessions ouvertes sur le même projet ne partagent donc pas leur courrier. L'agent
-#   donne son adresse avec `whoami`, et reprend une boîte existante avec
-#   `attach_to_mailbox`.
-# Renseignée : toutes les sessions utilisant cette configuration partagent cette boîte.
-# MESSENGER_AGENT_ID=
-
-# Adresse du serveur boîte aux lettres (http ou https, local ou distant).
-MESSENGER_SERVER_URL=http://127.0.0.1:3600
-
-# Jeton envoyé au serveur — obligatoire (doit correspondre à MESSENGER_TOKEN ou au
-# jeton de cet agent dans MESSENGER_AGENT_TOKENS).
-MESSENGER_TOKEN=change-me
-
-# Métadonnées publiées dans l'annuaire des agents (facultatif).
-# MESSENGER_AGENT_NAME=Planner
-# MESSENGER_AGENT_DESCRIPTION=Agent de planification, répond aux demandes de découpage de tâches.
-
-# Délai maximal d'un appel HTTP vers le serveur (ms).
-MESSENGER_TIMEOUT_MS=15000
-
-# Reprise de la boîte d'une session interrompue puis relancée.
-# auto (défaut) : la session retrouve sa boîte quand c'est certain (l'hôte a redonné le
-#   même identifiant de session) ou sans ambiguïté (une seule boîte du projet n'est plus
-#   tenue par personne, et elle a servi).
-# ask : rien n'est repris tout seul ; `whoami` présente les boîtes en attente, l'agent en
-#   rattache une avec `attach_to_mailbox`.
-# off : chaque session repart d'une boîte neuve.
-# Une boîte tenue par une session vivante n'est jamais reprise, quel que soit le réglage.
-# MESSENGER_RESUME=auto
-
-# Identifiant de la session hôte, celui qui relie une session reprise à celle qu'elle
-# continue. Inutile à renseigner : il est lu dans l'environnement hérité de l'hôte
-# (CLAUDE_CODE_SESSION_ID et équivalents). À poser soi-même pour des sessions lancées par
-# script. Il n'est jamais écrit sur le disque en clair, seule son empreinte l'est.
-# MESSENGER_SESSION_KEY=
+# ---------------------------------------------------------------------------
+# MCP Messenger — configuration
+# Deux modes, deux jeux de variables. Une même installation peut servir aux deux.
+# ---------------------------------------------------------------------------
+
+# === Mode serveur (boîte aux lettres) : `mcp-messenger --server` ===========
+
+# Port d'écoute. L'interface, elle, n'est pas configurable : le serveur écoute
+# toujours sur 127.0.0.1 et refuse de démarrer si MESSENGER_HOST vaut autre chose.
+# Pour l'atteindre depuis une autre machine, placer un reverse proxy devant.
+MESSENGER_PORT=3600
+
+# Chemin du fichier SQLite (défaut : <cwd>/data/messenger.db).
+# MESSENGER_DB_PATH=/var/lib/mcp-messenger/messenger.db
+
+# Aucun secret à poser ici : au premier démarrage, le serveur écrit un code d'installation
+# dans son journal ; la console (/ui) le demande pour créer le compte administrateur
+# (nom d'utilisateur + mot de passe). Les clés des agents se créent ensuite dans la
+# console, onglet Clés API. MESSENGER_TOKEN, MESSENGER_AGENT_TOKENS et
+# MESSENGER_ADMIN_TOKEN ne sont plus lus : le serveur refuse de démarrer s'ils sont posés.
+# Mot de passe perdu : npx @imenam/mcp-messenger --reset-password
+
+# Rate limiting (par IP).
+MESSENGER_RATE_LIMIT_MAX=600
+MESSENGER_RATE_LIMIT_WINDOW_MINUTES=15
+
+# Purge automatique de la corbeille (0 = désactivée).
+MESSENGER_TRASH_RETENTION_DAYS=30
+
+# === Mode MCP (côté agent) : `mcp-messenger` ==============================
+
+# Adresse FIXE de l'agent — à laisser vide dans la plupart des cas.
+# Vide : chaque session reçoit sa propre boîte (`box_…`), allouée au démarrage. Deux
+#   sessions ouvertes sur le même projet ne partagent donc pas leur courrier. L'agent
+#   donne son adresse avec `whoami`, et reprend une boîte existante avec
+#   `attach_to_mailbox`.
+# Renseignée : toutes les sessions utilisant cette configuration partagent cette boîte.
+# MESSENGER_AGENT_ID=
+
+# Adresse du serveur boîte aux lettres (http ou https, local ou distant).
+MESSENGER_SERVER_URL=http://127.0.0.1:3600
+
+# Clé API créée dans la console (onglet Clés API) — obligatoire.
+MESSENGER_API_KEY=mk_change-me
+
+# Métadonnées publiées dans l'annuaire des agents (facultatif). Elles ne servent qu'avec
+# une clé valable pour tous les agents : une clé liée à un agent porte son nom et sa
+# description, et refuse d'autres valeurs.
+# MESSENGER_AGENT_NAME=Planner
+# MESSENGER_AGENT_DESCRIPTION=Agent de planification, répond aux demandes de découpage de tâches.
+
+# Délai maximal d'un appel HTTP vers le serveur (ms).
+MESSENGER_TIMEOUT_MS=15000
+
+# Reprise de la boîte d'une session interrompue puis relancée.
+# auto (défaut) : la session retrouve sa boîte quand c'est certain (l'hôte a redonné le
+#   même identifiant de session) ou sans ambiguïté (une seule boîte du projet n'est plus
+#   tenue par personne, et elle a servi).
+# ask : rien n'est repris tout seul ; `whoami` présente les boîtes en attente, l'agent en
+#   rattache une avec `attach_to_mailbox`.
+# off : chaque session repart d'une boîte neuve.
+# Une boîte tenue par une session vivante n'est jamais reprise, quel que soit le réglage.
+# MESSENGER_RESUME=auto
+
+# Identifiant de la session hôte, celui qui relie une session reprise à celle qu'elle
+# continue. Inutile à renseigner : il est lu dans l'environnement hérité de l'hôte
+# (CLAUDE_CODE_SESSION_ID et équivalents). À poser soi-même pour des sessions lancées par
+# script. Il n'est jamais écrit sur le disque en clair, seule son empreinte l'est.
+# MESSENGER_SESSION_KEY=