@imenam/mcp-messenger 1.0.30 → 1.0.32

package/dist/src/core/store.js

@@ -22,14 +22,15 @@ const THREAD_DESCRIPTION_MAX = 2000;
 const FILENAME_MAX = 255;
 const MIME_TYPE_RE = /^[a-z0-9][a-z0-9!#$&^_.+-]*\/[a-z0-9][a-z0-9!#$&^_.+-]*$/;
 const DEFAULT_MIME_TYPE = "application/octet-stream";
+const LINK_NOTE_MAX = 500;
 /**
  * Dernière activité d'une boîte : sa dernière connexion, ou le dernier message qui l'a
  * touchée. Une boîte qui ne fait que recevoir reste vivante, alors que `last_seen_at`
  * seul la ferait paraître abandonnée.
  */
-const LAST_ACTIVITY = `MAX(
-  COALESCE(a.last_seen_at, ''),
-  COALESCE((SELECT MAX(d.created_at) FROM deliveries d WHERE d.agent_id = a.id), '')
+const LAST_ACTIVITY = `MAX(
+  COALESCE(a.last_seen_at, ''),
+  COALESCE((SELECT MAX(d.created_at) FROM deliveries d WHERE d.agent_id = a.id), '')
 )`;
 /** Colonnes du fil jointes à tout message : le titre voyage avec chaque livraison. */
 const THREAD_JOIN = "LEFT JOIN threads t ON t.id = m.thread_id";
@@ -42,10 +43,10 @@ const THREAD_JOIN = "LEFT JOIN threads t ON t.id = m.thread_id";
  * pose. Un message n'ayant qu'une copie d'expéditeur (destinataire jamais enregistré) n'a
  * pas de ligne ici : `read_at` reste alors nul, donc non lu.
  */
-const ADMIN_DELIVERY = `'to' AS role,
-                (SELECT dr.read_at FROM deliveries dr WHERE dr.message_id = m.id AND dr.role != 'sender'
-                  ORDER BY dr.agent_id LIMIT 1) AS read_at,
-                COALESCE((SELECT dr.folder FROM deliveries dr WHERE dr.message_id = m.id AND dr.role != 'sender'
+const ADMIN_DELIVERY = `'to' AS role,
+                (SELECT dr.read_at FROM deliveries dr WHERE dr.message_id = m.id AND dr.role != 'sender'
+                  ORDER BY dr.agent_id LIMIT 1) AS read_at,
+                COALESCE((SELECT dr.folder FROM deliveries dr WHERE dr.message_id = m.id AND dr.role != 'sender'
                   ORDER BY dr.agent_id LIMIT 1), 'inbox') AS folder`;
 /**
  * Boîte aux lettres persistée en SQLite.
@@ -68,96 +69,108 @@ export class MessageStore extends EventEmitter {
         this.migrate();
     }
     migrate() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS agents (
-        id                TEXT PRIMARY KEY,
-        agent_name        TEXT,
-        agent_description TEXT,
-        display_name      TEXT,
-        description       TEXT,
-        created_at   TEXT NOT NULL,
-        last_seen_at TEXT,
-        registered   INTEGER NOT NULL DEFAULT 0
-      );
-
-      CREATE TABLE IF NOT EXISTS messages (
-        id          TEXT PRIMARY KEY,
-        thread_id   TEXT NOT NULL,
-        sender_id   TEXT NOT NULL,
-        subject     TEXT NOT NULL,
-        body        TEXT NOT NULL,
-        priority    TEXT NOT NULL DEFAULT 'normal',
-        in_reply_to TEXT,
-        created_at  TEXT NOT NULL
-      );
-
-      CREATE TABLE IF NOT EXISTS deliveries (
-        id         TEXT PRIMARY KEY,
-        message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
-        agent_id   TEXT NOT NULL,
-        role       TEXT NOT NULL,
-        folder     TEXT NOT NULL,
-        read_at    TEXT,
-        starred    INTEGER NOT NULL DEFAULT 0,
-        created_at TEXT NOT NULL,
-        UNIQUE (message_id, agent_id, role)
-      );
-
-      CREATE TABLE IF NOT EXISTS threads (
-        id          TEXT PRIMARY KEY,
-        title       TEXT,
-        description TEXT,
-        named_by    TEXT,
-        created_at  TEXT NOT NULL,
-        updated_at  TEXT
-      );
-
-      CREATE TABLE IF NOT EXISTS folders (
-        agent_id   TEXT NOT NULL,
-        name       TEXT NOT NULL,
-        created_at TEXT NOT NULL,
-        PRIMARY KEY (agent_id, name)
-      );
-
-      CREATE TABLE IF NOT EXISTS attachments (
-        id         TEXT PRIMARY KEY,
-        message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
-        position   INTEGER NOT NULL,
-        filename   TEXT NOT NULL,
-        mime_type  TEXT NOT NULL,
-        size       INTEGER NOT NULL,
-        data       BLOB NOT NULL,
-        created_at TEXT NOT NULL
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_attachments_message ON attachments (message_id, position);
-      CREATE INDEX IF NOT EXISTS idx_deliveries_mailbox ON deliveries (agent_id, folder, created_at DESC);
-      CREATE INDEX IF NOT EXISTS idx_deliveries_message ON deliveries (message_id);
-      CREATE INDEX IF NOT EXISTS idx_messages_thread ON messages (thread_id, created_at);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agents (
+        id                TEXT PRIMARY KEY,
+        agent_name        TEXT,
+        agent_description TEXT,
+        display_name      TEXT,
+        description       TEXT,
+        created_at   TEXT NOT NULL,
+        last_seen_at TEXT,
+        registered   INTEGER NOT NULL DEFAULT 0
+      );
+
+      CREATE TABLE IF NOT EXISTS messages (
+        id          TEXT PRIMARY KEY,
+        thread_id   TEXT NOT NULL,
+        sender_id   TEXT NOT NULL,
+        subject     TEXT NOT NULL,
+        body        TEXT NOT NULL,
+        priority    TEXT NOT NULL DEFAULT 'normal',
+        in_reply_to TEXT,
+        created_at  TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS deliveries (
+        id         TEXT PRIMARY KEY,
+        message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
+        agent_id   TEXT NOT NULL,
+        role       TEXT NOT NULL,
+        folder     TEXT NOT NULL,
+        read_at    TEXT,
+        starred    INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT NOT NULL,
+        UNIQUE (message_id, agent_id, role)
+      );
+
+      CREATE TABLE IF NOT EXISTS threads (
+        id          TEXT PRIMARY KEY,
+        title       TEXT,
+        description TEXT,
+        named_by    TEXT,
+        created_at  TEXT NOT NULL,
+        updated_at  TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS folders (
+        agent_id   TEXT NOT NULL,
+        name       TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        PRIMARY KEY (agent_id, name)
+      );
+
+      CREATE TABLE IF NOT EXISTS attachments (
+        id         TEXT PRIMARY KEY,
+        message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
+        position   INTEGER NOT NULL,
+        filename   TEXT NOT NULL,
+        mime_type  TEXT NOT NULL,
+        size       INTEGER NOT NULL,
+        data       BLOB NOT NULL,
+        created_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS links (
+        id           TEXT PRIMARY KEY,
+        mailbox_a    TEXT NOT NULL,
+        mailbox_b    TEXT NOT NULL,
+        note         TEXT,
+        created_at   TEXT NOT NULL,
+        seen_by_a_at TEXT,
+        seen_by_b_at TEXT,
+        UNIQUE (mailbox_a, mailbox_b)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_links_b ON links (mailbox_b);
+      CREATE INDEX IF NOT EXISTS idx_attachments_message ON attachments (message_id, position);
+      CREATE INDEX IF NOT EXISTS idx_deliveries_mailbox ON deliveries (agent_id, folder, created_at DESC);
+      CREATE INDEX IF NOT EXISTS idx_deliveries_message ON deliveries (message_id);
+      CREATE INDEX IF NOT EXISTS idx_messages_thread ON messages (thread_id, created_at);
     `);
         // Bases antérieures à la séparation agent / boîte : `display_name` y tenait les deux
         // rôles, et venait presque toujours de la configuration (le nom du projet). On le
         // déplace vers l'identité de l'agent ; la boîte repart sans nom, à poser par l'agent.
         const agentColumns = this.db.prepare("PRAGMA table_info(agents)").all().map((c) => c.name);
         if (!agentColumns.includes("agent_name")) {
-            this.db.exec(`
-        ALTER TABLE agents ADD COLUMN agent_name TEXT;
-        ALTER TABLE agents ADD COLUMN agent_description TEXT;
-        UPDATE agents
-           SET agent_name = display_name,
-               agent_description = description,
-               display_name = NULL,
-               description = NULL;
+            this.db.exec(`
+        ALTER TABLE agents ADD COLUMN agent_name TEXT;
+        ALTER TABLE agents ADD COLUMN agent_description TEXT;
+        UPDATE agents
+           SET agent_name = display_name,
+               agent_description = description,
+               display_name = NULL,
+               description = NULL;
       `);
         }
         // Bases antérieures aux fils nommés : chaque fil déjà présent reçoit sa ligne, sans
         // titre. L'affichage retombe alors sur le sujet d'ouverture, comme avant.
-        this.db.exec(`
-      INSERT INTO threads (id, title, description, named_by, created_at, updated_at)
-      SELECT m.thread_id, NULL, NULL, NULL, MIN(m.created_at), NULL
-        FROM messages m
-       WHERE NOT EXISTS (SELECT 1 FROM threads t WHERE t.id = m.thread_id)
-       GROUP BY m.thread_id;
+        this.db.exec(`
+      INSERT INTO threads (id, title, description, named_by, created_at, updated_at)
+      SELECT m.thread_id, NULL, NULL, NULL, MIN(m.created_at), NULL
+        FROM messages m
+       WHERE NOT EXISTS (SELECT 1 FROM threads t WHERE t.id = m.thread_id)
+       GROUP BY m.thread_id;
     `);
     }
     close() {
@@ -174,24 +187,34 @@ export class MessageStore extends EventEmitter {
         const existing = this.db.prepare("SELECT id FROM agents WHERE id = ?").get(id);
         if (!existing) {
             this.db
-                .prepare(`INSERT INTO agents (id, agent_name, agent_description, display_name, description, created_at, last_seen_at, registered)
+                .prepare(`INSERT INTO agents (id, agent_name, agent_description, display_name, description, created_at, last_seen_at, registered)
            VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
                 .run(id, opts.agent_name ?? null, opts.agent_description ?? null, opts.display_name ?? null, opts.description ?? null, now, opts.registered ? now : null, opts.registered ? 1 : 0);
         }
         else {
             this.db
-                .prepare(`UPDATE agents
-              SET agent_name        = COALESCE(?, agent_name),
-                  agent_description = COALESCE(?, agent_description),
-                  display_name      = COALESCE(?, display_name),
-                  description       = COALESCE(?, description),
-                  registered        = MAX(registered, ?),
-                  last_seen_at      = CASE WHEN ? = 1 THEN ? ELSE last_seen_at END
+                .prepare(`UPDATE agents
+              SET agent_name        = COALESCE(?, agent_name),
+                  agent_description = COALESCE(?, agent_description),
+                  display_name      = COALESCE(?, display_name),
+                  description       = COALESCE(?, description),
+                  registered        = MAX(registered, ?),
+                  last_seen_at      = CASE WHEN ? = 1 THEN ? ELSE last_seen_at END
             WHERE id = ?`)
                 .run(opts.agent_name ?? null, opts.agent_description ?? null, opts.display_name ?? null, opts.description ?? null, opts.registered ? 1 : 0, opts.registered ? 1 : 0, now, id);
         }
         return this.getAgent(id);
     }
+    /**
+     * Nomme une boîte depuis la console. Le nom remplace celui en place, quel qu'en soit
+     * l'auteur ; null l'efface. La boîte doit exister, et sa date de passage ne bouge pas.
+     */
+    setMailboxName(id, name) {
+        const result = this.db.prepare("UPDATE agents SET display_name = ? WHERE id = ?").run(name, id);
+        if (result.changes === 0)
+            throw new MessengerError(`mailbox not found: ${id}`, 404);
+        return this.getAgent(id);
+    }
     touchAgent(id) {
         this.db.prepare("UPDATE agents SET last_seen_at = ? WHERE id = ?").run(new Date().toISOString(), id);
     }
@@ -208,9 +231,9 @@ export class MessageStore extends EventEmitter {
     listAgents(exclude) {
         const excluded = exclude ? normalizeAgentId(exclude) : "";
         const rows = this.db
-            .prepare(`SELECT a.*, ${LAST_ACTIVITY} AS last_activity_at
-           FROM agents a
-          WHERE a.id != ?
+            .prepare(`SELECT a.*, ${LAST_ACTIVITY} AS last_activity_at
+           FROM agents a
+          WHERE a.id != ?
           ORDER BY last_activity_at DESC, a.id`)
             .all(excluded);
         return rows.map((r) => ({
@@ -268,23 +291,23 @@ export class MessageStore extends EventEmitter {
             // Le fil naît avec son premier message ; sur une réponse, la ligne existe déjà et
             // n'est touchée que si l'expéditeur fournit un nouveau titre.
             this.db
-                .prepare(`INSERT INTO threads (id, title, description, named_by, created_at, updated_at)
-           VALUES (?, NULL, NULL, NULL, ?, NULL)
+                .prepare(`INSERT INTO threads (id, title, description, named_by, created_at, updated_at)
+           VALUES (?, NULL, NULL, NULL, ?, NULL)
            ON CONFLICT (id) DO NOTHING`)
                 .run(threadId, now);
             if (title !== null || threadDescription !== null) {
                 this.renameThreadRow(threadId, from, title, threadDescription, now);
             }
             this.db
-                .prepare(`INSERT INTO messages (id, thread_id, sender_id, subject, body, priority, in_reply_to, created_at)
+                .prepare(`INSERT INTO messages (id, thread_id, sender_id, subject, body, priority, in_reply_to, created_at)
            VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
                 .run(messageId, threadId, from, subject, input.body, priority, inReplyTo, now);
-            const insertAttachment = this.db.prepare(`INSERT INTO attachments (id, message_id, position, filename, mime_type, size, data, created_at)
+            const insertAttachment = this.db.prepare(`INSERT INTO attachments (id, message_id, position, filename, mime_type, size, data, created_at)
          VALUES (?, ?, ?, ?, ?, ?, ?, ?)`);
             attachments.forEach((a, position) => {
                 insertAttachment.run(newId("att"), messageId, position, a.filename, a.mime_type, a.data.length, a.data, now);
             });
-            const insert = this.db.prepare(`INSERT INTO deliveries (id, message_id, agent_id, role, folder, read_at, starred, created_at)
+            const insert = this.db.prepare(`INSERT INTO deliveries (id, message_id, agent_id, role, folder, read_at, starred, created_at)
          VALUES (?, ?, ?, ?, ?, ?, 0, ?)`);
             for (const d of deliveries) {
                 insert.run(newId("dlv"), messageId, d.agent_id, d.role, d.folder, d.read_at, now);
@@ -329,13 +352,13 @@ export class MessageStore extends EventEmitter {
             params.push(like, like);
         }
         const rows = this.db
-            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
-                m.priority, m.in_reply_to, m.created_at, d.folder, d.role, d.read_at, d.starred
-           FROM deliveries d
-           JOIN messages m ON m.id = d.message_id
-           ${THREAD_JOIN}
-          WHERE ${where.join(" AND ")}
-          ORDER BY m.created_at DESC, m.id DESC
+            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
+                m.priority, m.in_reply_to, m.created_at, d.folder, d.role, d.read_at, d.starred
+           FROM deliveries d
+           JOIN messages m ON m.id = d.message_id
+           ${THREAD_JOIN}
+          WHERE ${where.join(" AND ")}
+          ORDER BY m.created_at DESC, m.id DESC
           LIMIT ? OFFSET ?`)
             .all(...params, limit, offset);
         const related = this.relatedFor(rows.map((r) => r.message_id));
@@ -343,13 +366,13 @@ export class MessageStore extends EventEmitter {
     }
     getMessage(agentId, messageId, markRead = false) {
         const row = this.db
-            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
-                m.priority, m.in_reply_to, m.created_at, d.folder, d.role, d.read_at, d.starred
-           FROM deliveries d
-           JOIN messages m ON m.id = d.message_id
-           ${THREAD_JOIN}
-          WHERE d.agent_id = ? AND d.message_id = ?
-          ORDER BY CASE d.role WHEN 'to' THEN 0 ELSE 1 END
+            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
+                m.priority, m.in_reply_to, m.created_at, d.folder, d.role, d.read_at, d.starred
+           FROM deliveries d
+           JOIN messages m ON m.id = d.message_id
+           ${THREAD_JOIN}
+          WHERE d.agent_id = ? AND d.message_id = ?
+          ORDER BY CASE d.role WHEN 'to' THEN 0 ELSE 1 END
           LIMIT 1`)
             .get(agentId, messageId);
         if (!row)
@@ -367,14 +390,14 @@ export class MessageStore extends EventEmitter {
     /** Tous les messages d'un fil visibles par l'agent, du plus ancien au plus récent. */
     getThread(agentId, threadId) {
         const rows = this.db
-            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
-                m.priority, m.in_reply_to, m.created_at,
-                MIN(d.folder) AS folder, MIN(d.role) AS role, MIN(d.read_at) AS read_at, MAX(d.starred) AS starred
-           FROM deliveries d
-           JOIN messages m ON m.id = d.message_id
-           ${THREAD_JOIN}
-          WHERE d.agent_id = ? AND m.thread_id = ?
-          GROUP BY m.id
+            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
+                m.priority, m.in_reply_to, m.created_at,
+                MIN(d.folder) AS folder, MIN(d.role) AS role, MIN(d.read_at) AS read_at, MAX(d.starred) AS starred
+           FROM deliveries d
+           JOIN messages m ON m.id = d.message_id
+           ${THREAD_JOIN}
+          WHERE d.agent_id = ? AND m.thread_id = ?
+          GROUP BY m.id
           ORDER BY m.created_at ASC`)
             .all(agentId, threadId);
         if (rows.length === 0)
@@ -385,9 +408,9 @@ export class MessageStore extends EventEmitter {
     /** Pièce jointe d'un message livré à cet agent, contenu compris. */
     getAttachment(agentId, attachmentId) {
         const row = this.db
-            .prepare(`SELECT a.id AS attachment_id, a.message_id, a.filename, a.mime_type, a.size, a.data
-           FROM attachments a
-          WHERE a.id = ?
+            .prepare(`SELECT a.id AS attachment_id, a.message_id, a.filename, a.mime_type, a.size, a.data
+           FROM attachments a
+          WHERE a.id = ?
             AND EXISTS (SELECT 1 FROM deliveries d WHERE d.message_id = a.message_id AND d.agent_id = ?)`)
             .get(attachmentId, agentId);
         if (!row)
@@ -432,7 +455,7 @@ export class MessageStore extends EventEmitter {
         // qu'elle ait écrit ou seulement reçu. Les paramètres du WHERE se lient avant ceux du
         // HAVING : cette condition doit donc être poussée avant celles de la recherche.
         if (opts.with_agent) {
-            where.push(`EXISTS (SELECT 1 FROM deliveries d2 JOIN messages m2 ON m2.id = d2.message_id
+            where.push(`EXISTS (SELECT 1 FROM deliveries d2 JOIN messages m2 ON m2.id = d2.message_id
                   WHERE m2.thread_id = m.thread_id AND d2.agent_id = ?)`);
             params.push(normalizeAgentId(opts.with_agent));
         }
@@ -445,20 +468,20 @@ export class MessageStore extends EventEmitter {
             params.push(like, like, like);
         }
         const rows = this.db
-            .prepare(`SELECT m.thread_id,
-                t.title, t.description, t.named_by, t.created_at, t.updated_at,
-                (SELECT r.subject FROM messages r WHERE r.thread_id = m.thread_id
-                  ORDER BY r.created_at ASC, r.id ASC LIMIT 1) AS subject,
-                COUNT(DISTINCT m.id) AS messages,
-                COUNT(DISTINCT CASE WHEN d.read_at IS NULL AND d.role != 'sender' THEN m.id END) AS unread,
-                MAX(m.created_at) AS last_message_at
-           FROM deliveries d
-           JOIN messages m ON m.id = d.message_id
-           ${THREAD_JOIN}
-          WHERE ${where.join(" AND ")}
-          GROUP BY m.thread_id
-          ${having.length ? `HAVING ${having.join(" AND ")}` : ""}
-          ORDER BY last_message_at DESC
+            .prepare(`SELECT m.thread_id,
+                t.title, t.description, t.named_by, t.created_at, t.updated_at,
+                (SELECT r.subject FROM messages r WHERE r.thread_id = m.thread_id
+                  ORDER BY r.created_at ASC, r.id ASC LIMIT 1) AS subject,
+                COUNT(DISTINCT m.id) AS messages,
+                COUNT(DISTINCT CASE WHEN d.read_at IS NULL AND d.role != 'sender' THEN m.id END) AS unread,
+                MAX(m.created_at) AS last_message_at
+           FROM deliveries d
+           JOIN messages m ON m.id = d.message_id
+           ${THREAD_JOIN}
+          WHERE ${where.join(" AND ")}
+          GROUP BY m.thread_id
+          ${having.length ? `HAVING ${having.join(" AND ")}` : ""}
+          ORDER BY last_message_at DESC
           LIMIT ? OFFSET ?`)
             .all(...params, limit, offset);
         const participants = this.participantsFor(rows.map((r) => r.thread_id));
@@ -481,18 +504,18 @@ export class MessageStore extends EventEmitter {
     /** Écriture brute du nom : un champ absent (`null`) laisse l'ancienne valeur en place. */
     renameThreadRow(threadId, agentId, title, description, now) {
         this.db
-            .prepare(`INSERT INTO threads (id, title, description, named_by, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?)
-         ON CONFLICT (id) DO UPDATE SET
-           title       = COALESCE(excluded.title, threads.title),
-           description = COALESCE(excluded.description, threads.description),
-           named_by    = excluded.named_by,
+            .prepare(`INSERT INTO threads (id, title, description, named_by, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?)
+         ON CONFLICT (id) DO UPDATE SET
+           title       = COALESCE(excluded.title, threads.title),
+           description = COALESCE(excluded.description, threads.description),
+           named_by    = excluded.named_by,
            updated_at  = excluded.updated_at`)
             .run(threadId, title, description, agentId, now, now);
     }
     assertThreadVisible(agentId, threadId) {
         const row = this.db
-            .prepare(`SELECT 1 FROM deliveries d JOIN messages m ON m.id = d.message_id
+            .prepare(`SELECT 1 FROM deliveries d JOIN messages m ON m.id = d.message_id
           WHERE d.agent_id = ? AND m.thread_id = ? LIMIT 1`)
             .get(agentId, threadId);
         if (!row)
@@ -505,9 +528,9 @@ export class MessageStore extends EventEmitter {
             return map;
         const placeholders = ids.map(() => "?").join(",");
         const rows = this.db
-            .prepare(`SELECT DISTINCT m.thread_id, d.agent_id
-           FROM deliveries d JOIN messages m ON m.id = d.message_id
-          WHERE m.thread_id IN (${placeholders})
+            .prepare(`SELECT DISTINCT m.thread_id, d.agent_id
+           FROM deliveries d JOIN messages m ON m.id = d.message_id
+          WHERE m.thread_id IN (${placeholders})
           ORDER BY d.agent_id`)
             .all(...ids);
         for (const row of rows) {
@@ -553,7 +576,7 @@ export class MessageStore extends EventEmitter {
     listFolders(agentId) {
         const custom = this.db.prepare("SELECT name FROM folders WHERE agent_id = ? ORDER BY name").all(agentId);
         const counts = this.db
-            .prepare(`SELECT folder, COUNT(*) AS total, SUM(CASE WHEN read_at IS NULL THEN 1 ELSE 0 END) AS unread
+            .prepare(`SELECT folder, COUNT(*) AS total, SUM(CASE WHEN read_at IS NULL THEN 1 ELSE 0 END) AS unread
            FROM deliveries WHERE agent_id = ? GROUP BY folder`)
             .all(agentId);
         const byName = new Map(counts.map((c) => [c.folder, c]));
@@ -592,7 +615,7 @@ export class MessageStore extends EventEmitter {
         if (!exists)
             throw new MessengerError(`folder not found: ${folder}`, 404);
         const moved = this.db
-            .prepare(`UPDATE deliveries SET folder = CASE role WHEN 'sender' THEN 'sent' ELSE 'inbox' END
+            .prepare(`UPDATE deliveries SET folder = CASE role WHEN 'sender' THEN 'sent' ELSE 'inbox' END
           WHERE agent_id = ? AND folder = ?`)
             .run(agentId, folder).changes;
         this.db.prepare("DELETE FROM folders WHERE agent_id = ? AND name = ?").run(agentId, folder);
@@ -625,10 +648,10 @@ export class MessageStore extends EventEmitter {
      */
     staleMailboxes(before) {
         const rows = this.db
-            .prepare(`SELECT a.*, ${LAST_ACTIVITY} AS last_activity_at,
-                (SELECT COUNT(*) FROM deliveries d WHERE d.agent_id = a.id) AS messages
-           FROM agents a
-          WHERE MAX(${LAST_ACTIVITY}, a.created_at) < ?
+            .prepare(`SELECT a.*, ${LAST_ACTIVITY} AS last_activity_at,
+                (SELECT COUNT(*) FROM deliveries d WHERE d.agent_id = a.id) AS messages
+           FROM agents a
+          WHERE MAX(${LAST_ACTIVITY}, a.created_at) < ?
           ORDER BY MAX(${LAST_ACTIVITY}, a.created_at) ASC`)
             .all(before);
         return rows.map((row) => ({
@@ -647,10 +670,10 @@ export class MessageStore extends EventEmitter {
      */
     mailboxesCreatedBefore(before) {
         const rows = this.db
-            .prepare(`SELECT a.*, ${LAST_ACTIVITY} AS last_activity_at,
-                (SELECT COUNT(*) FROM deliveries d WHERE d.agent_id = a.id) AS messages
-           FROM agents a
-          WHERE a.created_at < ?
+            .prepare(`SELECT a.*, ${LAST_ACTIVITY} AS last_activity_at,
+                (SELECT COUNT(*) FROM deliveries d WHERE d.agent_id = a.id) AS messages
+           FROM agents a
+          WHERE a.created_at < ?
           ORDER BY a.created_at ASC`)
             .all(before);
         return rows.map((row) => ({
@@ -669,9 +692,9 @@ export class MessageStore extends EventEmitter {
      */
     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)
+            .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) => ({
@@ -699,9 +722,11 @@ export class MessageStore extends EventEmitter {
             const dropDeliveries = this.db.prepare("DELETE FROM deliveries WHERE agent_id = ?");
             const dropFolders = this.db.prepare("DELETE FROM folders WHERE agent_id = ?");
             const dropAgent = this.db.prepare("DELETE FROM agents WHERE id = ?");
+            const dropLinks = this.db.prepare("DELETE FROM links WHERE mailbox_a = ? OR mailbox_b = ?");
             for (const id of ids) {
                 deliveries += dropDeliveries.run(id).changes;
                 dropFolders.run(id);
+                dropLinks.run(id, id);
                 mailboxes += dropAgent.run(id).changes;
             }
             this.dropOrphanMessages();
@@ -715,6 +740,74 @@ export class MessageStore extends EventEmitter {
             };
         })();
     }
+    // --- Liaisons -----------------------------------------------------------
+    /**
+     * Lie deux boîtes existantes. La paire est stockée dans l'ordre des adresses : une
+     * liaison n'a pas de direction, et la même paire ne peut être liée deux fois.
+     */
+    createLink(first, second, note) {
+        const ids = [normalizeAgentId(first), normalizeAgentId(second)];
+        if (!ids[0] || !ids[1])
+            throw new MessengerError("two mailbox addresses are required");
+        if (ids[0] === ids[1])
+            throw new MessengerError("a mailbox cannot be linked to itself");
+        for (const id of ids) {
+            if (!this.getAgent(id))
+                throw new MessengerError(`mailbox not found: ${id}`, 404);
+        }
+        const [a, b] = ids.sort();
+        if (this.db.prepare("SELECT 1 FROM links WHERE mailbox_a = ? AND mailbox_b = ?").get(a, b)) {
+            throw new MessengerError(`these mailboxes are already linked: ${a}, ${b}`, 409);
+        }
+        const id = newId("lnk");
+        this.db
+            .prepare("INSERT INTO links (id, mailbox_a, mailbox_b, note, created_at) VALUES (?, ?, ?, ?, ?)")
+            .run(id, a, b, normalizeLabel(note, LINK_NOTE_MAX, "note"), new Date().toISOString());
+        for (const agentId of [a, b])
+            this.emit("link", { agent_id: agentId, link_id: id });
+        return this.getLink(id);
+    }
+    getLink(linkId) {
+        const row = this.db.prepare("SELECT * FROM links WHERE id = ?").get(linkId);
+        return row ? toLink(row) : null;
+    }
+    /** Toutes les liaisons du serveur, la plus récente en tête. */
+    listLinks() {
+        const rows = this.db.prepare("SELECT * FROM links ORDER BY created_at DESC, rowid DESC").all();
+        return rows.map(toLink);
+    }
+    deleteLink(linkId) {
+        const removed = this.db.prepare("DELETE FROM links WHERE id = ?").run(linkId).changes;
+        if (removed === 0)
+            throw new MessengerError(`link not found: ${linkId}`, 404);
+    }
+    /**
+     * Liaisons d'une boîte, la plus récente en tête, chacune avec la fiche de la boîte d'en
+     * face. `markSeen` note que l'agent de cette boîte en a pris connaissance.
+     */
+    linksFor(agentId, opts = {}) {
+        const id = normalizeAgentId(agentId);
+        const where = ["(mailbox_a = ? OR mailbox_b = ?)"];
+        const params = [id, id];
+        if (opts.linkId) {
+            where.push("id = ?");
+            params.push(opts.linkId);
+        }
+        const rows = this.db
+            .prepare(`SELECT * FROM links WHERE ${where.join(" AND ")} ORDER BY created_at DESC, rowid DESC`)
+            .all(...params);
+        if (opts.markSeen && rows.length > 0) {
+            const now = new Date().toISOString();
+            this.db.prepare("UPDATE links SET seen_by_a_at = ? WHERE mailbox_a = ? AND seen_by_a_at IS NULL").run(now, id);
+            this.db.prepare("UPDATE links SET seen_by_b_at = ? WHERE mailbox_b = ? AND seen_by_b_at IS NULL").run(now, id);
+        }
+        return rows.map((row) => ({
+            link_id: row.id,
+            note: row.note,
+            created_at: row.created_at,
+            correspondent: this.getAgent(row.mailbox_a === id ? row.mailbox_b : row.mailbox_a),
+        }));
+    }
     // --- Supervision (interface web, lecture seule sauf purge) ---------------
     /** Vue globale : tous les messages du serveur, indépendamment des boîtes. */
     listAllMessages(opts = {}) {
@@ -736,12 +829,12 @@ export class MessageStore extends EventEmitter {
             params.push(opts.thread_id);
         }
         const rows = this.db
-            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
-                m.priority, m.in_reply_to, m.created_at, 0 AS starred, ${ADMIN_DELIVERY}
-           FROM messages m
-           ${THREAD_JOIN}
-          WHERE ${where.join(" AND ")}
-          ORDER BY m.created_at DESC, m.id DESC
+            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
+                m.priority, m.in_reply_to, m.created_at, 0 AS starred, ${ADMIN_DELIVERY}
+           FROM messages m
+           ${THREAD_JOIN}
+          WHERE ${where.join(" AND ")}
+          ORDER BY m.created_at DESC, m.id DESC
           LIMIT ? OFFSET ?`)
             .all(...params, limit, offset);
         const related = this.relatedFor(rows.map((r) => r.message_id));
@@ -764,7 +857,7 @@ export class MessageStore extends EventEmitter {
         // reçu : c'est la correspondance qui est filtrée, pas les messages qu'elle a signés.
         const agents = dedupe((opts.agents ?? []).map((id) => normalizeAgentId(id)).filter(Boolean));
         if (agents.length > 0) {
-            where.push(`EXISTS (SELECT 1 FROM deliveries d JOIN messages mp ON mp.id = d.message_id
+            where.push(`EXISTS (SELECT 1 FROM deliveries d JOIN messages mp ON mp.id = d.message_id
                   WHERE mp.thread_id = m.thread_id AND d.agent_id IN (${agents.map(() => "?").join(",")}))`);
             params.push(...agents);
         }
@@ -772,8 +865,8 @@ export class MessageStore extends EventEmitter {
         // n'importe lequel de ses messages. Un fil non nommé reste ainsi trouvable.
         if (opts.search) {
             const like = `%${escapeLike(opts.search)}%`;
-            where.push(`(COALESCE(t.title, '') LIKE ? ESCAPE '\\' OR COALESCE(t.description, '') LIKE ? ESCAPE '\\'
-          OR EXISTS (SELECT 1 FROM messages ms WHERE ms.thread_id = m.thread_id
+            where.push(`(COALESCE(t.title, '') LIKE ? ESCAPE '\\' OR COALESCE(t.description, '') LIKE ? ESCAPE '\\'
+          OR EXISTS (SELECT 1 FROM messages ms WHERE ms.thread_id = m.thread_id
                       AND (ms.subject LIKE ? ESCAPE '\\' OR ms.body LIKE ? ESCAPE '\\')))`);
             params.push(like, like, like, like);
         }
@@ -782,28 +875,28 @@ export class MessageStore extends EventEmitter {
         if (opts.priority)
             having.push("top_priority = ?");
         const rows = this.db
-            .prepare(`SELECT m.thread_id,
-                t.title, t.description, t.named_by, t.created_at, t.updated_at,
-                (SELECT r.subject FROM messages r WHERE r.thread_id = m.thread_id
-                  ORDER BY r.created_at ASC, r.id ASC LIMIT 1) AS subject,
-                COUNT(*) AS messages,
-                MAX(m.created_at) AS last_message_at,
-                (SELECT r.sender_id FROM messages r WHERE r.thread_id = m.thread_id
-                  ORDER BY r.created_at DESC, r.id DESC LIMIT 1) AS last_message_from,
-                (SELECT r.body FROM messages r WHERE r.thread_id = m.thread_id
-                  ORDER BY r.created_at DESC, r.id DESC LIMIT 1) AS last_body,
-                (SELECT COUNT(*) FROM deliveries d JOIN messages mu ON mu.id = d.message_id
-                  WHERE mu.thread_id = m.thread_id AND d.role != 'sender'
-                    AND d.read_at IS NULL AND d.folder != 'trash') AS unread,
-                CASE WHEN SUM(m.priority = 'high') > 0 THEN 'high'
-                     WHEN SUM(m.priority = 'normal') > 0 THEN 'normal'
-                     ELSE 'low' END AS top_priority
-           FROM messages m
-           ${THREAD_JOIN}
-          WHERE ${where.join(" AND ")}
-          GROUP BY m.thread_id
-          ${having.length ? `HAVING ${having.join(" AND ")}` : ""}
-          ORDER BY last_message_at DESC
+            .prepare(`SELECT m.thread_id,
+                t.title, t.description, t.named_by, t.created_at, t.updated_at,
+                (SELECT r.subject FROM messages r WHERE r.thread_id = m.thread_id
+                  ORDER BY r.created_at ASC, r.id ASC LIMIT 1) AS subject,
+                COUNT(*) AS messages,
+                MAX(m.created_at) AS last_message_at,
+                (SELECT r.sender_id FROM messages r WHERE r.thread_id = m.thread_id
+                  ORDER BY r.created_at DESC, r.id DESC LIMIT 1) AS last_message_from,
+                (SELECT r.body FROM messages r WHERE r.thread_id = m.thread_id
+                  ORDER BY r.created_at DESC, r.id DESC LIMIT 1) AS last_body,
+                (SELECT COUNT(*) FROM deliveries d JOIN messages mu ON mu.id = d.message_id
+                  WHERE mu.thread_id = m.thread_id AND d.role != 'sender'
+                    AND d.read_at IS NULL AND d.folder != 'trash') AS unread,
+                CASE WHEN SUM(m.priority = 'high') > 0 THEN 'high'
+                     WHEN SUM(m.priority = 'normal') > 0 THEN 'normal'
+                     ELSE 'low' END AS top_priority
+           FROM messages m
+           ${THREAD_JOIN}
+          WHERE ${where.join(" AND ")}
+          GROUP BY m.thread_id
+          ${having.length ? `HAVING ${having.join(" AND ")}` : ""}
+          ORDER BY last_message_at DESC
           LIMIT ? OFFSET ?`)
             .all(...params, ...(opts.priority ? [opts.priority] : []), limit, offset);
         const participants = this.participantsFor(rows.map((r) => r.thread_id));
@@ -833,11 +926,11 @@ export class MessageStore extends EventEmitter {
      */
     listThreadAdmin(threadId) {
         const rows = this.db
-            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
-                m.priority, m.in_reply_to, m.created_at, 0 AS starred, ${ADMIN_DELIVERY}
-           FROM messages m
-           ${THREAD_JOIN}
-          WHERE m.thread_id = ?
+            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
+                m.priority, m.in_reply_to, m.created_at, 0 AS starred, ${ADMIN_DELIVERY}
+           FROM messages m
+           ${THREAD_JOIN}
+          WHERE m.thread_id = ?
           ORDER BY m.created_at ASC, m.id ASC`)
             .all(threadId);
         const related = this.relatedFor(rows.map((r) => r.message_id));
@@ -846,8 +939,8 @@ export class MessageStore extends EventEmitter {
     /** Message complet vu du serveur, avec l'état de lecture de chaque destinataire. */
     getMessageAdmin(messageId) {
         const row = this.db
-            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
-                m.priority, m.in_reply_to, m.created_at, 0 AS starred, ${ADMIN_DELIVERY}
+            .prepare(`SELECT m.id AS message_id, m.thread_id, t.title AS thread_title, m.sender_id, m.subject, m.body,
+                m.priority, m.in_reply_to, m.created_at, 0 AS starred, ${ADMIN_DELIVERY}
            FROM messages m ${THREAD_JOIN} WHERE m.id = ?`)
             .get(messageId);
         if (!row)
@@ -869,7 +962,7 @@ export class MessageStore extends EventEmitter {
     /** Pièce jointe vue du serveur, quelle que soit la boîte. */
     getAttachmentAdmin(attachmentId) {
         const row = this.db
-            .prepare(`SELECT id AS attachment_id, message_id, filename, mime_type, size, data
+            .prepare(`SELECT id AS attachment_id, message_id, filename, mime_type, size, data
            FROM attachments WHERE id = ?`)
             .get(attachmentId);
         if (!row)
@@ -881,9 +974,9 @@ export class MessageStore extends EventEmitter {
         const threads = this.db.prepare("SELECT COUNT(DISTINCT thread_id) AS n FROM messages").get().n;
         const sentByAgent = new Map(this.db.prepare("SELECT sender_id, COUNT(*) AS n FROM messages GROUP BY sender_id").all().map((r) => [r.sender_id, r.n]));
         const receivedByAgent = new Map(this.db
-            .prepare(`SELECT agent_id,
-                    COUNT(*) AS received,
-                    SUM(CASE WHEN read_at IS NULL AND folder != 'trash' THEN 1 ELSE 0 END) AS unread
+            .prepare(`SELECT agent_id,
+                    COUNT(*) AS received,
+                    SUM(CASE WHEN read_at IS NULL AND folder != 'trash' THEN 1 ELSE 0 END) AS unread
                FROM deliveries WHERE role != 'sender' GROUP BY agent_id`)
             .all().map((r) => [r.agent_id, r]));
         const agents = this.listAgents().map((agent) => ({
@@ -930,14 +1023,14 @@ export class MessageStore extends EventEmitter {
             return related;
         const placeholders = ids.map(() => "?").join(",");
         const recipients = this.db
-            .prepare(`SELECT message_id, agent_id FROM deliveries
+            .prepare(`SELECT message_id, agent_id FROM deliveries
           WHERE message_id IN (${placeholders}) AND role = 'to'`)
             .all(...ids);
         for (const row of recipients)
             related.recipients.set(row.message_id, row.agent_id);
         const attachments = this.db
-            .prepare(`SELECT id AS attachment_id, message_id, filename, mime_type, size FROM attachments
-          WHERE message_id IN (${placeholders})
+            .prepare(`SELECT id AS attachment_id, message_id, filename, mime_type, size FROM attachments
+          WHERE message_id IN (${placeholders})
           ORDER BY message_id, position`)
             .all(...ids);
         for (const { message_id, ...info } of attachments) {
@@ -975,6 +1068,17 @@ export class MessageStore extends EventEmitter {
         this.db.exec("DELETE FROM threads WHERE NOT EXISTS (SELECT 1 FROM messages m WHERE m.thread_id = threads.id)");
     }
 }
+function toLink(row) {
+    return {
+        link_id: row.id,
+        note: row.note,
+        created_at: row.created_at,
+        mailboxes: [
+            { mailbox: row.mailbox_a, seen_at: row.seen_by_a_at },
+            { mailbox: row.mailbox_b, seen_at: row.seen_by_b_at },
+        ],
+    };
+}
 export function normalizeAgentId(id) {
     return String(id ?? "").trim();
 }