@imenam/mcp-messenger 1.0.18 → 1.0.20

package/README.md

@@ -395,12 +395,18 @@ correspondants et l'état de lecture :
   une par session ouverte, et beaucoup n'échangeront jamais rien. Ces boîtes-là sont
   **masquées par défaut**, derrière un bouton en fin de dépli qui dit combien il y en a ;
   les masquer ne cache jamais de courrier, une boîte sans réception n'ayant par
-  construction aucun non-lu. Un agent dont aucune session n'a rien échangé passe de même
-  derrière les autres. Chaque boîte affiche la date qui la classe, et deux dates
+  construction aucun non-lu. **Un agent dont aucune session n'a rien échangé est masqué de
+  la même façon**, derrière un bouton en pied de colonne : même geste, un cran plus haut.
+  Chaque boîte affiche la date qui la classe, et deux dates
   identiques sont départagées par l'adresse pour que l'ordre ne bouge pas d'un
   rafraîchissement à l'autre ;
 - **la liste des fils**, du plus récemment actif au plus ancien, chacun résumé par son
-  nom, ses correspondants, son dernier message et sa priorité la plus haute. Trois puces
+  nom, ses correspondants, son dernier message et sa priorité la plus haute. Les deux
+  correspondants y sont d'abord **deux pastilles côte à côte**, séparées et non superposées
+  — leurs initiales doivent rester lisibles —, de la couleur que leur adresse leur donne
+  partout ailleurs : on voit qui parle avant de lire. Au survol, la
+  pastille dit d'où la boîte écrit, ce dont la session s'occupe, son adresse, et si c'est
+  elle qui a écrit en dernier. Trois puces
   la filtrent : tous, non lus, priorité haute ;
 - **le lecteur du fil** : la conversation entière dans l'ordre, un bloc par message, avec
   qui écrit à qui — en clair, pas en adresses — et une pastille disant si le destinataire
@@ -417,6 +423,10 @@ correspondants et l'état de lecture :
   dossier, état). Tout ce qui se recopie a son bouton de copie ;
 - une recherche unique, qui couvre le nom d'un fil, sa description et le texte de ses
   messages ;
+- **des panneaux redimensionnables** : chaque ligne de séparation se saisit à la souris,
+  se règle aussi aux flèches du clavier une fois qu'elle a le focus, et rend sa largeur
+  d'origine sur un double-clic. Les largeurs choisies sont retenues par le navigateur d'une
+  visite à l'autre ;
 - un rafraîchissement automatique toutes les 5 secondes, débrayable.
 
 **Les adresses ne sont pas de l'information de lecture.** La console résout partout
@@ -440,23 +450,35 @@ navigateur de l'administrateur. Les routes `/admin` acceptent toujours le jeton
 `Authorization: Bearer` pour les scripts. Le formulaire est limité à 10 tentatives par
 quart d'heure et par IP.
 
-La console n'envoie ni ne modifie aucun message. Elle ne commande qu'une seule écriture,
-et c'est une suppression : la **purge des boîtes inactives**, derrière l'icône de corbeille
-de la barre du haut.
+La console n'envoie ni ne modifie aucun message. Les seules écritures qu'elle commande
+sont des suppressions, derrière l'icône de corbeille de la barre du haut. **Deux
+nettoyages y cohabitent, avec chacun son bouton, parce qu'ils ne visent pas la même
+chose :**
 
-Une boîte est inactive quand plus rien ne l'a touchée depuis la date choisie : ni
-connexion, ni message reçu ou envoyé. **Une boîte créée après cette date est épargnée,
-même vide** — une session qui vient de démarrer et n'a pas encore parlé n'est pas une
-boîte à l'abandon.
+- **les boîtes vides** : rien n'y est jamais passé, ni envoi ni réception. Elles n'ont pas
+  d'âge, une boîte vide est vide qu'elle date d'un mois ou d'une minute. C'est le
+  nettoyage à passer sur un serveur qui a vu défiler beaucoup de sessions muettes. **Un
+  agent dont toutes les boîtes disparaissent quitte l'annuaire avec elles**, faute de
+  boîte à regrouper ;
+- **les boîtes inactives depuis une date** : elles ont servi, mais plus rien ne les a
+  touchées depuis. **Une boîte créée après cette date est épargnée, même vide** — une
+  session qui vient de démarrer et n'a pas encore parlé n'est pas une boîte à l'abandon.
 
-La purge se fait en deux temps, parce qu'elle ne se rattrape pas :
+S'y ajoute la suppression d'**une boîte en particulier** : chaque ligne de la colonne de
+gauche porte une corbeille, révélée au survol ou au clavier. Elle n'efface rien d'elle-même,
+elle ouvre la même fenêtre sur cette seule boîte, avec ce qu'elle contient sous les yeux.
+C'est la seule des trois qui ne demande aucun critère : l'adresse vient d'être montrée du
+doigt, il n'y a rien à revérifier.
+
+Toutes se font en deux temps, parce qu'elles ne se rattrapent pas :
 
 1. **L'aperçu** liste les boîtes concernées, chacune avec son nom, son adresse, son nombre
    de messages et sa dernière activité. Chaque ligne se décoche.
-2. **La confirmation** demande deux clics, et n'envoie que les adresses affichées. Le
-   serveur, lui, reconfronte chacune à la date avant de supprimer : une boîte redevenue
-   active entre l'aperçu et la confirmation fait échouer la purge entière, nommément.
-   Changer la date ou décocher une ligne annule une confirmation déjà donnée.
+2. **La confirmation** demande deux clics, et n'envoie que les adresses affichées, avec le
+   critère qui les a désignées. Le serveur, lui, reconfronte chacune à ce critère avant de
+   supprimer : une boîte redevenue active, ou qui vient de recevoir son premier message,
+   fait échouer le nettoyage entier, nommément. Changer de critère, changer la date ou
+   décocher une ligne annule une confirmation déjà donnée.
 
 **Ce qui disparaît.** Un message a deux copies, une par correspondant : supprimer une
 boîte n'emporte que sa moitié. Le message lui-même ne s'efface qu'une fois sa dernière
@@ -532,7 +554,9 @@ la console (cookie), qui elle n'ouvre rien d'autre.
 | `GET` | `/admin/threads` | Fils du serveur entier (`agent` — une ou plusieurs adresses séparées par des virgules —, `search`, `unread_only`, `priority`, `limit`, `offset`) |
 | `GET` | `/admin/threads/:id` | Fil complet, corps inclus |
 | `GET` | `/admin/mailboxes/stale` | Boîtes sans activité depuis `before`, avec ce que chacune contient |
-| `POST` | `/admin/mailboxes/purge` | Supprime les boîtes nommées (`before`, `mailboxes`) — refusé si l'une d'elles est redevenue active |
+| `GET` | `/admin/mailboxes/empty` | Boîtes par lesquelles rien n'est jamais passé, sans critère de date |
+| `POST` | `/admin/mailboxes/purge` | Supprime les boîtes nommées (`mailboxes`, plus `before` **ou** `empty: true`) — refusé si l'une d'elles ne répond plus au critère |
+| `DELETE` | `/admin/mailboxes/:id` | Supprime une boîte désignée, quel que soit son état — 404 si l'adresse est inconnue |
 | `POST` | `/ui/login` · `/ui/logout` | Session de la console (`{ "token": … }` → cookie `HttpOnly`) |
 
 ---
@@ -555,9 +579,9 @@ la console (cookie), qui elle n'ouvre rien d'autre.
 - La console web n'insère jamais de HTML fourni par un agent : le corps des messages est
   rendu en markdown par construction de nœuds, jamais par assignation de balisage, et la
   CSP interdit tout script tiers.
-- La console ne peut ni écrire ni modifier un message. Sa seule commande destructrice est
-  la purge des boîtes inactives, réservée au jeton d'administration, confirmée deux fois et
-  revérifiée par le serveur avant exécution.
+- La console ne peut ni écrire ni modifier un message. Ses seules commandes destructrices
+  suppriment des boîtes : réservées au jeton d'administration, confirmées deux fois, et
+  revérifiées par le serveur quand elles portent sur un lot.
 - Derrière un reverse proxy TLS, exposer le serveur en `https://` et donner cette URL aux
   agents via `MESSENGER_SERVER_URL`.
 
@@ -598,8 +622,9 @@ test/                   # store, config, API HTTP, outils MCP, binaire réel
 
 ### Tests
 
-231 tests couvrant : la purge des boîtes inactives commandée depuis la console (aperçu,
-double confirmation, refus nominatif d'une boîte redevenue active), la reprise de la boîte d'une session interrompue (clé de session de
+266 tests couvrant : les suppressions de boîtes commandées depuis la console — une boîte
+désignée à la main, les vides, celles sans activité depuis une date — avec leur aperçu,
+leur double confirmation et le refus nominatif d'une boîte qui ne répond plus au critère, la reprise de la boîte d'une session interrompue (clé de session de
 l'hôte, boîte orpheline, boîte d'une session vivante jamais reprise), le rendu markdown des messages et l'aplatissement des aperçus (dont
 l'innocuité du rendu : ni HTML interprété, ni lien vers un autre schéma qu'`http`, `https`
 ou `mailto`), le stockage et l'isolation des boîtes, la validation de configuration,

package/dist/src/core/store.d.ts

@@ -98,6 +98,17 @@ export declare class MessageStore extends EventEmitter<StoreEvents> {
     staleMailboxes(before: string): (AgentDirectoryEntry & {
         messages: number;
     })[];
+    /**
+     * Boîtes par lesquelles rien n'est jamais passé, ni envoi ni réception.
+     *
+     * Elles n'ont pas d'âge : une boîte vide est vide, qu'elle date d'un mois ou d'une
+     * minute. C'est ce qui la distingue d'une boîte inactive, et ce qui rend ce nettoyage
+     * différent de la purge par date — la boîte d'une session qui vient d'ouvrir et n'a pas
+     * encore parlé en fait donc partie.
+     */
+    emptyMailboxes(): (AgentDirectoryEntry & {
+        messages: number;
+    })[];
     /**
      * Supprime ces boîtes et tout ce qui n'appartenait qu'à elles.
      *

package/dist/src/core/store.js

@@ -603,6 +603,27 @@ export class MessageStore extends EventEmitter {
             last_activity_at: row.last_activity_at || null,
         }));
     }
+    /**
+     * Boîtes par lesquelles rien n'est jamais passé, ni envoi ni réception.
+     *
+     * Elles n'ont pas d'âge : une boîte vide est vide, qu'elle date d'un mois ou d'une
+     * minute. C'est ce qui la distingue d'une boîte inactive, et ce qui rend ce nettoyage
+     * différent de la purge par date — la boîte d'une session qui vient d'ouvrir et n'a pas
+     * encore parlé en fait donc partie.
+     */
+    emptyMailboxes() {
+        const rows = this.db
+            .prepare(`SELECT a.*, ${LAST_ACTIVITY} AS last_activity_at, 0 AS messages
+           FROM agents a
+          WHERE NOT EXISTS (SELECT 1 FROM deliveries d WHERE d.agent_id = a.id)
+          ORDER BY a.created_at ASC`)
+            .all();
+        return rows.map((row) => ({
+            ...row,
+            registered: Boolean(row.registered),
+            last_activity_at: row.last_activity_at || null,
+        }));
+    }
     /**
      * Supprime ces boîtes et tout ce qui n'appartenait qu'à elles.
      *

package/dist/src/server/app.js

@@ -102,10 +102,21 @@ const isoDate = z
     .regex(/^\d{4}-\d{2}-\d{2}(T[\d:.]+Z?)?$/, "expected a date such as 2026-08-01")
     .refine((value) => !Number.isNaN(Date.parse(value)), "not a real date");
 const staleSchema = z.object({ before: isoDate });
-const purgeSchema = z.object({
-    before: isoDate,
+/**
+ * Une suppression désigne ses boîtes, et rappelle à quel titre elles sont supprimables :
+ * `before`, elles n'ont plus d'activité depuis cette date ; `empty`, rien n'y est jamais
+ * passé. Les deux critères s'excluent — le serveur revérifie celui qu'on lui donne, il
+ * doit donc savoir lequel c'est.
+ */
+const purgeSchema = z
+    .object({
+    before: isoDate.optional(),
+    empty: z.literal(true).optional(),
     /** Les adresses vues dans l'aperçu : on ne supprime jamais autre chose que ce qui a été montré. */
     mailboxes: z.array(z.string().trim().min(1)).min(1).max(500),
+})
+    .refine((input) => (input.before === undefined) !== (input.empty === undefined), {
+    message: "provide either `before` (inactive since that date) or `empty: true`, not both",
 });
 const adminListSchema = z.object({
     search: z.string().trim().min(1).optional(),
@@ -175,7 +186,7 @@ export function createApp({ store, config }) {
     app.get("/", (_req, res) => {
         res.redirect("/ui/");
     });
-    // --- Supervision (lecture, sauf la purge des boîtes inactives) -----------
+    // --- Supervision (lecture, sauf les nettoyages de boîtes) ----------------
     // Montée avant la porte d'entrée : son contrôle est au moins aussi strict (session de
     // console ou jeton admin), et la session par cookie n'est reconnue nulle part ailleurs.
     const admin = express.Router();
@@ -225,24 +236,50 @@ export function createApp({ store, config }) {
         const { before } = staleSchema.parse(req.query);
         res.json({ before, mailboxes: store.staleMailboxes(before) });
     });
+    /**
+     * Boîtes par lesquelles rien n'est jamais passé. Sans date : une boîte vide l'est
+     * indépendamment de son âge, et un agent dont toutes les boîtes sont vides disparaît
+     * de l'annuaire du même coup, faute de boîte à regrouper.
+     */
+    admin.get("/mailboxes/empty", (_req, res) => {
+        res.json({ mailboxes: store.emptyMailboxes() });
+    });
     /**
      * La seule route de la console qui écrit, et elle détruit.
      *
-     * Deux garde-fous, parce qu'une purge ne se rattrape pas : la date est redemandée avec
-     * les adresses, et le serveur refuse toute adresse qui ne serait pas, au moment où il
-     * répond, sans activité depuis cette date. Une boîte redevenue vivante entre l'aperçu
-     * et la confirmation est donc épargnée, et le refus est nominatif.
+     * Deux garde-fous, parce qu'un nettoyage ne se rattrape pas : le critère est redemandé
+     * avec les adresses, et le serveur refuse toute adresse qui n'y répond plus au moment
+     * où il l'examine. Une boîte redevenue vivante, ou qui vient de recevoir son premier
+     * message, est donc épargnée — et le refus est nominatif, il porte sur le lot entier.
      */
     admin.post("/mailboxes/purge", (req, res) => {
         const input = purgeSchema.parse(req.body ?? {});
-        const stale = new Set(store.staleMailboxes(input.before).map((mailbox) => mailbox.id));
-        const active = input.mailboxes.filter((id) => !stale.has(id));
-        if (active.length > 0) {
-            throw new MessengerError(`these mailboxes are no longer inactive since ${input.before}, nothing was deleted: ${active.join(", ")}`, 409);
+        const reason = input.empty ? "empty" : `inactive since ${input.before}`;
+        const eligible = new Set((input.empty ? store.emptyMailboxes() : store.staleMailboxes(input.before)).map((mailbox) => mailbox.id));
+        const changed = input.mailboxes.filter((id) => !eligible.has(id));
+        if (changed.length > 0) {
+            throw new MessengerError(`these mailboxes are no longer ${reason}, nothing was deleted: ${changed.join(", ")}`, 409);
         }
         const removed = store.deleteMailboxes(input.mailboxes);
-        logger.warn(`admin purge: ${removed.mailboxes} mailbox(es) deleted, inactive since ${input.before}`);
-        res.json({ before: input.before, ...removed });
+        logger.warn(`admin purge: ${removed.mailboxes} mailbox(es) deleted, ${reason}`);
+        res.json({ before: input.before ?? null, empty: input.empty ?? false, ...removed });
+    });
+    /**
+     * Suppression d'une boîte désignée à la main, quel que soit son état.
+     *
+     * Pas de critère à revérifier ici, et c'est voulu : les deux nettoyages en lot se
+     * protègent d'une liste qui aurait vieilli entre l'aperçu et la confirmation, alors que
+     * celle-ci porte sur une boîte que l'on vient de montrer du doigt. La boîte doit
+     * exister — supprimer une adresse inconnue serait un geste sans effet présenté comme un
+     * succès.
+     */
+    admin.delete("/mailboxes/:id", (req, res) => {
+        const id = normalizeAgentId(String(req.params.id));
+        if (!store.getAgent(id))
+            throw new MessengerError(`mailbox not found: ${id}`, 404);
+        const removed = store.deleteMailboxes([id]);
+        logger.warn(`admin delete: mailbox ${id} deleted (${removed.messages} message(s) erased)`);
+        res.json({ mailbox: id, ...removed });
     });
     app.use("/admin", admin);
     // Porte d'entrée de tout le reste : aucune requête n'est servie sans jeton valide. Le