@imenam/mcp-messenger 1.0.10 → 1.0.13

package/README.md

@@ -173,13 +173,19 @@ superviseur capable de lire les lignes d'un processus peut la brancher. Sans rel
 
 ## Outils MCP
 
+**Deux mots, deux choses.** Une **boîte** (`mailbox` dans les outils) est une adresse
+`box_…` : elle désigne une session, et c'est à elle qu'on écrit. Un **nom d'agent** est le
+projet pour lequel une session travaille : c'est une étiquette, jamais une adresse, et
+toutes les sessions du projet la portent. Partout où un outil attend une adresse, sa
+description dit « mailbox address ».
+
 | Outil | Rôle |
 |---|---|
 | `whoami` | Adresse de cette session, serveur connecté, veilleur armé ou non, compteurs par dossier |
 | `attach_to_mailbox` | Se brancher sur une autre boîte via son adresse ; sans argument, retour à la sienne |
 | `rename_mailbox` | Nommer ou renommer sa boîte (de quoi la session s'occupe) ; le nom de l'agent, posé par la configuration, reste |
 | `rename_thread` | Nommer ou renommer un fil (`thread_id`) ; le nom est partagé par tous ses participants |
-| `list_threads` | Carte des conversations : nom, participants, non-lus, dernière activité ; `with_agent` ne garde que celles partagées avec une boîte |
+| `list_threads` | Carte des conversations : nom, participants, non-lus, dernière activité ; `with_mailbox` ne garde que celles partagées avec une boîte |
 | `list_agents` | Annuaire groupé par agent : un projet, ses sessions ; `agent_name` déplie un groupe. La boîte de l'appelant n'y figure pas |
 | `send_message` | Écrire à un agent — un seul destinataire par message (`to`, `priority`, `reply_to`, `thread_name`) |
 | `list_messages` | Lister la boîte (filtres : dossier, non lus, expéditeur, fil, texte libre) |
@@ -330,14 +336,36 @@ configuration partagent alors la même boîte. Utile pour un service unique et s
 
 ## Console web
 
-`http://127.0.0.1:3600/ui/` affiche, en lecture seule, **tous les échanges** de la flotte :
-
-- la liste des agents avec leurs compteurs (envoyés, reçus, non lus) ;
-- tous les messages, filtrables par agent, par fil ou par recherche texte ;
-- le contenu d'un message et son état de distribution (qui l'a reçu, dans quel dossier, lu ou non) ;
-- sous le message ouvert, les échanges qui l'ont précédé, repliés par défaut et dépliables d'un bouton, comme dans une boîte mail ;
-- le fil complet d'une conversation ;
-- un rafraîchissement automatique toutes les 5 secondes.
+`http://127.0.0.1:3600/ui/` affiche, en lecture seule, **tous les échanges** de la flotte,
+organisés autour du fil — l'unité d'une correspondance, celle qui porte le sujet, les deux
+correspondants et l'état de lecture :
+
+- **une colonne d'agents à deux niveaux** : un agent tient une boîte par session ouverte,
+  la colonne l'écrit donc ainsi. Chaque agent est **replié par défaut** et se déplie d'un
+  chevron sur ses boîtes ; une boîte que son agent n'a pas nommée s'affiche à son adresse,
+  la seule chose qui la distingue alors de ses sœurs. Cliquer l'agent filtre les fils sur
+  **toutes ses sessions**, cliquer une boîte sur **cette seule session**. La colonne se
+  replie sur les seuls avatars d'agents quand la place manque ;
+- **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
+  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
+  l'a lu ;
+- **le volet de détail** d'un message, ouvert à la demande : identifiants du message et du
+  fil, les deux noms et l'adresse de chaque boîte, et le tableau de distribution (rôle,
+  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 ;
+- 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
+`box_9f2c4a01b3d7e5f8` en nom d'agent, et ne montre l'adresse qu'aux endroits où elle sert
+vraiment : le volet de détail, l'en-tête d'un fil et les boîtes sans nom, chaque fois avec
+un bouton de copie. Quand plusieurs sessions d'un même projet apparaissent, le nom de
+l'agent est suivi de celui de la boîte entre parenthèses — sans quoi un fil se lirait
+« Documentor Dev → Documentor Dev » sans dire de quelles sessions il parle. Une boîte jamais connectée se distingue à son avatar en contour et à la mention
+« jamais connectée » — elle reste listée, puisqu'elle a du courrier en attente.
 
 À l'ouverture, la console demande `MESSENGER_ADMIN_TOKEN` dans un formulaire. Le serveur
 le vérifie (`POST /ui/login`) et ouvre une **session** de 12 heures, portée par un cookie
@@ -416,7 +444,9 @@ la console (cookie), qui elle n'ouvre rien d'autre.
 | `PATCH` | `/api/threads/:id` | Nommer le fil (`title`, `description`) — participants uniquement |
 | `GET` `POST` `DELETE` | `/api/folders[/:name]` | Gérer les dossiers |
 | `GET` | `/api/wait` | Attente longue (`timeout_seconds`, `folder`, `watcher`) |
-| `GET` | `/admin/overview` · `/admin/messages[/:id]` · `/admin/threads/:id` | Supervision, lecture seule |
+| `GET` | `/admin/overview` · `/admin/messages[/:id]` | Supervision, lecture seule |
+| `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 |
 | `POST` | `/ui/login` · `/ui/logout` | Session de la console (`{ "token": … }` → cookie `HttpOnly`) |
 
 ---

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

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import { type Agent, type AgentDirectoryEntry, type DeliveryRole, type FolderInfo, type ListMessagesOptions, type ListThreadsOptions, type MailboxStats, type Message, type MessageSummary, type SendMessageInput, type SendMessageResult, type ThreadInfo, type ThreadSummary } from "./types.js";
+import { type AdminThreadSummary, type Agent, type AgentDirectoryEntry, type DeliveryRole, type FolderInfo, type ListMessagesOptions, type ListThreadsOptions, type MailboxStats, type Message, type MessageSummary, type Priority, type SendMessageInput, type SendMessageResult, type ThreadInfo, type ThreadSummary } from "./types.js";
 /** Erreur métier : traduite en 4xx par la couche HTTP, en message d'outil côté MCP. */
 export declare class MessengerError extends Error {
     readonly status: number;
@@ -95,6 +95,28 @@ export declare class MessageStore extends EventEmitter<StoreEvents> {
         limit?: number;
         offset?: number;
     }): MessageSummary[];
+    /**
+     * Fils du serveur entier, le plus récemment actif en tête.
+     *
+     * La console est organisée autour du fil : c'est lui qui porte le sujet, les deux
+     * correspondants et l'état de lecture. Chaque ligne est autonome — dernier message,
+     * aperçu, priorité la plus haute du fil — pour que la liste s'affiche d'une requête.
+     */
+    listAllThreadsAdmin(opts?: {
+        search?: string;
+        /**
+         * Adresses de boîtes : un fil est gardé dès que l'une d'elles y participe.
+         *
+         * Une liste, et non une seule adresse, parce qu'un agent tient autant de boîtes
+         * qu'il a de sessions ouvertes : « les fils du projet Documentor » se demande en
+         * passant les adresses de toutes ses sessions d'un coup.
+         */
+        agents?: string[];
+        unread_only?: boolean;
+        priority?: Priority;
+        limit?: number;
+        offset?: number;
+    }): AdminThreadSummary[];
     /**
      * Fil complet vu du serveur, du plus ancien au plus récent, corps inclus.
      *