@imenam/mcp-messenger 1.0.9 → 1.0.11

package/README.md

@@ -173,14 +173,20 @@ 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é |
-| `list_agents` | Annuaire : qui est joignable, du plus récemment actif au plus ancien ; la boîte de l'appelant n'y figure pas |
+| `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) |
 | `read_message` | Lire un message en entier ; le marque lu par défaut |
@@ -254,12 +260,18 @@ pas au même rythme :
 | Exemple | `Ai Corrector Dev` | `Correction du parseur de copies` |
 
 Le nom de l'agent seul ne distingue pas deux sessions ouvertes sur le même projet ; le nom
-de la boîte seul ne dit pas d'où l'agent écrit. L'annuaire (`list_agents`), `whoami` et la
-console web montrent donc toujours les deux, sous la forme `Agent · Boîte`. Renommer la
-boîte ne touche jamais au nom de l'agent.
+de la boîte seul ne dit pas d'où l'agent écrit. `whoami` et la console web montrent donc
+toujours les deux, et l'annuaire (`list_agents`) les met l'un sous l'autre : le nom de
+l'agent en tête de groupe, une ligne par boîte en dessous. Renommer la boîte ne touche
+jamais au nom de l'agent.
 
 **Un nom d'agent ne désigne personne.** C'est le piège de ce modèle : plusieurs boîtes
-portent le même `agent_name`, une par session lancée depuis la même configuration. Un agent
+portent le même `agent_name`, une par session lancée depuis la même configuration.
+L'annuaire le rend visible en groupant les boîtes sous leur nom d'agent — un groupe à
+plusieurs lignes, ce sont plusieurs sessions vivantes du même projet, chacune à sa propre
+adresse. Un groupe nombreux n'affiche que ses trois sessions les plus récentes ;
+`list_agents` avec `agent_name` donne le reste, sans imposer ce second appel dans le cas
+courant. Un agent
 qui croise son propre nom d'agent dans l'annuaire regarde une *autre* session du même
 projet, jamais la sienne — sa boîte, elle, n'y figure pas du tout. Seule l'adresse identifie
 une session. Ce rappel est servi à trois endroits, du plus tôt au plus tard : les
@@ -324,13 +336,31 @@ 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) ;
-- 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** : un par boîte, avec son nom d'agent, ce dont la session
+  s'occupe et son nombre de messages non lus. La sélection filtre les fils sur cette
+  boîte ; la colonne se replie sur ses seuls avatars 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 deux endroits où elle
+sert vraiment : le volet de détail et l'en-tête d'un fil, chaque fois avec un bouton de
+copie. 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
@@ -409,7 +439,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`, `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/client/messenger-client.d.ts

@@ -83,6 +83,7 @@ export declare class MessengerClient {
     }>;
     listThreads(options?: {
         unread_only?: boolean;
+        with_agent?: string;
         search?: string;
         limit?: number;
     }): Promise<ThreadSummary[]>;

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,31 @@ 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;
+        agent?: 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.
+     *
+     * La console affiche les échanges antérieurs sous le message ouvert : elle a besoin du
+     * texte, pas seulement de l'aperçu. Les deux sont renvoyés, l'aperçu servant aux vues
+     * qui ne déplient rien.
+     */
+    listThreadAdmin(threadId: string): (MessageSummary & {
+        body: string;
+    })[];
     /** Message complet vu du serveur, avec l'état de lecture de chaque destinataire. */
     getMessageAdmin(messageId: string): Message & {
         deliveries: {