@imenam/mcp-messenger 1.0.30 → 1.0.31

package/dist/src/cli/watch.d.ts

@@ -1,5 +1,5 @@
 import { type AgentConfig } from "../config.js";
-import type { Message } from "../core/types.js";
+import type { LinkedMailbox, Message } from "../core/types.js";
 export interface WatchConfig {
     config: AgentConfig;
     mailbox: string;
@@ -16,4 +16,6 @@ export interface WatchConfig {
 export declare function resolveWatchConfig(mailbox: string | null, env?: NodeJS.ProcessEnv): WatchConfig;
 /** Ligne d'évènement : une seule ligne, lisible telle quelle dans la notification. */
 export declare function formatEvent(message: Message): string;
+/** Ligne d'une liaison posée depuis la console sur la boîte surveillée. */
+export declare function formatLinkEvent(link: LinkedMailbox): string;
 export declare function runWatchMode(mailbox: string | null): Promise<void>;

package/dist/src/cli/watch.js

@@ -62,6 +62,13 @@ export function formatEvent(message) {
     const thread = message.thread_title ? ` · ${message.thread_title.replace(/\s+/g, " ").trim()}` : "";
     return `[messenger] ${flag}${message.from} — ${subject}${thread} (${message.message_id})`;
 }
+/** Ligne d'une liaison posée depuis la console sur la boîte surveillée. */
+export function formatLinkEvent(link) {
+    const who = link.correspondent;
+    const names = [who.agent_name, who.display_name].filter(Boolean).join(" · ") || "unnamed mailbox";
+    const note = link.note ? ` — ${link.note.replace(/\s+/g, " ").trim()}` : "";
+    return `[messenger] linked with ${names} (${who.id})${note} — call list_links`;
+}
 export async function runWatchMode(mailbox) {
     const { config, mailbox: target, source } = resolveWatchConfig(mailbox);
     const client = new MessengerClient(config);
@@ -71,11 +78,14 @@ export async function runWatchMode(mailbox) {
         try {
             const result = await client.waitForMessage(POLL_SECONDS, undefined, { watcher: true });
             backoff = BACKOFF_MIN_MS;
-            if (result.timed_out || !result.message)
+            if (result.timed_out)
                 continue;
             // Une ligne, un réveil. On repart aussitôt en attente : les messages suivants
             // arrivés entre-temps sont récupérés au tour d'après.
-            process.stdout.write(`${formatEvent(result.message)}\n`);
+            if (result.message)
+                process.stdout.write(`${formatEvent(result.message)}\n`);
+            else if (result.link)
+                process.stdout.write(`${formatLinkEvent(result.link)}\n`);
         }
         catch (error) {
             const detail = error instanceof Error ? error.message : String(error);

package/dist/src/client/messenger-client.d.ts

@@ -1,5 +1,5 @@
 import type { AgentConfig } from "../config.js";
-import type { Agent, AgentDirectoryEntry, FolderInfo, ListMessagesOptions, MailboxStats, Message, MessageSummary, Priority, SendMessageResult, ThreadInfo, ThreadSummary } from "../core/types.js";
+import type { Agent, AgentDirectoryEntry, FolderInfo, LinkedMailbox, ListMessagesOptions, MailboxStats, Message, MessageSummary, Priority, SendMessageResult, ThreadInfo, ThreadSummary } from "../core/types.js";
 /** Échec d'un appel au serveur boîte aux lettres (réseau, authentification ou métier). */
 export declare class MessengerClientError extends Error {
     readonly status?: number | undefined;
@@ -19,6 +19,8 @@ export interface DownloadedAttachment {
 export interface WaitResult {
     timed_out: boolean;
     message: Message | null;
+    /** Liaison posée sur la boîte pendant l'attente ; seul un veilleur en reçoit. */
+    link?: LinkedMailbox | null;
 }
 /**
  * Client HTTP du serveur boîte aux lettres.
@@ -70,6 +72,8 @@ export declare class MessengerClient {
     }): Promise<Agent>;
     getAgent(agentId: string): Promise<Agent>;
     listAgents(): Promise<AgentDirectoryEntry[]>;
+    /** Liaisons de la boîte courante. Le serveur les note comme reçues par cet agent. */
+    listLinks(): Promise<LinkedMailbox[]>;
     stats(): Promise<MailboxStats>;
     sendMessage(input: {
         to: string;

package/dist/src/client/messenger-client.js

@@ -89,6 +89,11 @@ export class MessengerClient {
         const { agents } = await this.request("GET", "/api/agents");
         return agents;
     }
+    /** Liaisons de la boîte courante. Le serveur les note comme reçues par cet agent. */
+    async listLinks() {
+        const { links } = await this.request("GET", "/api/links");
+        return links;
+    }
     async stats() {
         return this.request("GET", "/api/mailbox");
     }

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

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import { type AdminThreadSummary, type Agent, type AgentDirectoryEntry, type AttachmentInfo, 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";
+import { type AdminThreadSummary, type Agent, type AgentDirectoryEntry, type AttachmentInfo, type DeliveryRole, type FolderInfo, type LinkedMailbox, type ListMessagesOptions, type ListThreadsOptions, type MailboxLink, 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;
@@ -27,6 +27,11 @@ export interface StoreEvents {
         folder: string;
         role: DeliveryRole;
     }];
+    /** Émis pour chacune des deux boîtes d'une liaison qui vient d'être créée. */
+    link: [{
+        agent_id: string;
+        link_id: string;
+    }];
 }
 /**
  * Boîte aux lettres persistée en SQLite.
@@ -141,6 +146,23 @@ export declare class MessageStore extends EventEmitter<StoreEvents> {
         messages: number;
         threads: number;
     };
+    /**
+     * 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: string, second: string, note?: string | null): MailboxLink;
+    getLink(linkId: string): MailboxLink | null;
+    /** Toutes les liaisons du serveur, la plus récente en tête. */
+    listLinks(): MailboxLink[];
+    deleteLink(linkId: string): void;
+    /**
+     * 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: string, opts?: {
+        markSeen?: boolean;
+        linkId?: string;
+    }): LinkedMailbox[];
     /** Vue globale : tous les messages du serveur, indépendamment des boîtes. */
     listAllMessages(opts?: {
         search?: string;