@imenam/mcp-messenger 1.0.1

package/dist/src/server/ui/app.js

@@ -0,0 +1,275 @@
+// Console de supervision : lecture seule sur les routes /admin du serveur.
+// Tout le contenu affiché provient d'agents : il est inséré via textContent uniquement.
+
+const TOKEN_KEY = "messenger.admin.token";
+const REFRESH_MS = 5000;
+
+// Le serveur exige un jeton sur toute requête, y compris celle qui a servi cette page :
+// il est propagé sur l'URL de ce script. On le reprend tel quel comme jeton de session.
+const TOKEN_FROM_URL = new URL(import.meta.url).searchParams.get("token");
+
+const state = {
+  token: TOKEN_FROM_URL || localStorage.getItem(TOKEN_KEY) || "",
+  agent: null,
+  search: "",
+  selectedMessageId: null,
+  threadId: null,
+};
+
+const el = {
+  statusDot: document.getElementById("status-dot"),
+  serverStats: document.getElementById("server-stats"),
+  agents: document.getElementById("agents"),
+  messages: document.getElementById("messages"),
+  detail: document.getElementById("detail"),
+  search: document.getElementById("search"),
+  filterLabel: document.getElementById("filter-label"),
+  clearFilters: document.getElementById("clear-filters"),
+  refresh: document.getElementById("refresh"),
+  autoRefresh: document.getElementById("auto-refresh"),
+  tokenBar: document.getElementById("token-bar"),
+  tokenInput: document.getElementById("token"),
+  tokenError: document.getElementById("token-error"),
+  saveToken: document.getElementById("save-token"),
+};
+
+async function api(path, params) {
+  const url = new URL(path, window.location.origin);
+  for (const [key, value] of Object.entries(params || {})) {
+    if (value !== undefined && value !== null && value !== "") url.searchParams.set(key, value);
+  }
+  const headers = { accept: "application/json" };
+  if (state.token) headers.authorization = "Bearer " + state.token;
+
+  const response = await fetch(url, { headers });
+  if (response.status === 401) {
+    el.tokenBar.hidden = false;
+    throw new Error("unauthorized");
+  }
+  if (!response.ok) {
+    const payload = await response.json().catch(() => ({}));
+    throw new Error(payload.error || response.statusText);
+  }
+  return response.json();
+}
+
+/** Remplace le contenu du panneau de détail (et retire l'état « vide » hérité du HTML). */
+function setDetail(child, empty) {
+  el.detail.className = empty ? "empty" : "detail-content";
+  el.detail.replaceChildren(child);
+}
+
+function node(tag, className, text) {
+  const element = document.createElement(tag);
+  if (className) element.className = className;
+  if (text !== undefined) element.textContent = text;
+  return element;
+}
+
+function formatDate(iso) {
+  const date = new Date(iso);
+  return Number.isNaN(date.getTime()) ? iso : date.toLocaleString();
+}
+
+function renderAgents(overview) {
+  el.serverStats.textContent =
+    overview.messages + " message(s) · " + overview.threads + " fil(s) · " + overview.agents.length + " agent(s)";
+  el.statusDot.className = "dot ok";
+  el.agents.replaceChildren();
+
+  for (const agent of overview.agents) {
+    const item = node("li", state.agent === agent.id ? "selected" : "");
+    item.appendChild(node("div", "id", agent.display_name ? agent.id + " — " + agent.display_name : agent.id));
+    item.appendChild(
+      node("div", "muted", "envoyés " + agent.sent + " · reçus " + agent.received + " · non lus " + agent.unread)
+    );
+    if (!agent.registered) item.appendChild(node("div", "muted", "jamais connecté"));
+    item.addEventListener("click", () => {
+      state.agent = state.agent === agent.id ? null : agent.id;
+      state.threadId = null;
+      refresh();
+    });
+    el.agents.appendChild(item);
+  }
+}
+
+function renderMessages(messages) {
+  el.filterLabel.textContent = [
+    state.agent ? "agent : " + state.agent : null,
+    state.threadId ? "fil : " + state.threadId : null,
+  ]
+    .filter(Boolean)
+    .join(" · ");
+
+  el.messages.replaceChildren();
+  if (messages.length === 0) {
+    el.messages.appendChild(node("li", "empty", "Aucun message."));
+    return;
+  }
+
+  for (const message of messages) {
+    const item = node("li", state.selectedMessageId === message.message_id ? "selected" : "");
+    const subject = node("div", "subject", message.subject);
+    if (message.priority !== "normal") {
+      const badge = node("span", "badge" + (message.priority === "high" ? " high" : ""), message.priority);
+      subject.appendChild(badge);
+    }
+    item.appendChild(subject);
+    item.appendChild(
+      node("div", "route", message.from + " → " + (message.to.join(", ") || "—") + " · " + formatDate(message.created_at))
+    );
+    item.appendChild(node("div", "preview", message.preview));
+    item.addEventListener("click", () => openMessage(message.message_id));
+    el.messages.appendChild(item);
+  }
+}
+
+async function openMessage(messageId) {
+  state.selectedMessageId = messageId;
+  try {
+    const message = await api("/admin/messages/" + encodeURIComponent(messageId));
+    renderDetail(message);
+    await refresh({ keepDetail: true });
+  } catch (error) {
+    setDetail(node("div", "error", error.message), false);
+  }
+}
+
+function renderDetail(message) {
+  const container = node("div", "detail");
+  container.appendChild(node("h3", null, message.subject));
+  container.appendChild(
+    node(
+      "div",
+      "meta",
+      "De " +
+        message.from +
+        " · À " +
+        (message.to.join(", ") || "—") +
+        (message.cc.length ? " · Cc " + message.cc.join(", ") : "") +
+        "\n" +
+        formatDate(message.created_at) +
+        " · priorité " +
+        message.priority +
+        "\nid " +
+        message.message_id +
+        " · fil " +
+        message.thread_id
+    )
+  );
+
+  const threadButton = node("button", null, "Voir le fil complet");
+  threadButton.addEventListener("click", () => showThread(message.thread_id));
+  container.appendChild(threadButton);
+
+  container.appendChild(node("div", "body", message.body));
+
+  const deliveries = node("div", "deliveries");
+  deliveries.appendChild(node("h2", null, "Distribution"));
+  const list = node("ul");
+  for (const delivery of message.deliveries) {
+    list.appendChild(
+      node(
+        "li",
+        null,
+        delivery.agent_id +
+          " · " +
+          delivery.role +
+          " · dossier " +
+          delivery.folder +
+          " · " +
+          (delivery.read ? "lu" : "non lu")
+      )
+    );
+  }
+  deliveries.appendChild(list);
+  container.appendChild(deliveries);
+
+  setDetail(container, false);
+}
+
+async function showThread(threadId) {
+  try {
+    const data = await api("/admin/threads/" + encodeURIComponent(threadId));
+    const container = node("div", "detail");
+    container.appendChild(node("h3", null, "Fil " + threadId + " — " + data.messages.length + " message(s)"));
+
+    const filterButton = node("button", null, "Filtrer la liste sur ce fil");
+    filterButton.addEventListener("click", () => {
+      state.threadId = threadId;
+      refresh({ keepDetail: true });
+    });
+    container.appendChild(filterButton);
+
+    for (const message of data.messages) {
+      const block = node("div", "thread-message");
+      block.appendChild(node("div", "subject", message.subject));
+      block.appendChild(
+        node("div", "meta", message.from + " → " + (message.to.join(", ") || "—") + " · " + formatDate(message.created_at))
+      );
+      block.appendChild(node("div", "preview", message.preview));
+      const openButton = node("button", "link", "ouvrir");
+      openButton.addEventListener("click", () => openMessage(message.message_id));
+      block.appendChild(openButton);
+      container.appendChild(block);
+    }
+    setDetail(container, false);
+  } catch (error) {
+    setDetail(node("div", "error", error.message), false);
+  }
+}
+
+async function refresh(options) {
+  try {
+    const [overview, list] = await Promise.all([
+      api("/admin/overview"),
+      api("/admin/messages", { agent: state.agent, search: state.search, thread_id: state.threadId, limit: 100 }),
+    ]);
+    el.tokenBar.hidden = true;
+    renderAgents(overview);
+    renderMessages(list.messages);
+    if (!options || !options.keepDetail) {
+      if (!state.selectedMessageId) {
+        setDetail(node("div", null, "Sélectionnez un message pour voir son contenu."), true);
+      }
+    }
+  } catch (error) {
+    el.statusDot.className = "dot ko";
+    if (error.message === "unauthorized") {
+      el.serverStats.textContent = "authentification requise";
+    } else {
+      el.serverStats.textContent = "erreur : " + error.message;
+    }
+  }
+}
+
+el.refresh.addEventListener("click", () => refresh({ keepDetail: true }));
+el.clearFilters.addEventListener("click", () => {
+  state.agent = null;
+  state.threadId = null;
+  state.search = "";
+  el.search.value = "";
+  refresh({ keepDetail: true });
+});
+
+let searchTimer = null;
+el.search.addEventListener("input", (event) => {
+  state.search = event.target.value.trim();
+  clearTimeout(searchTimer);
+  searchTimer = setTimeout(() => refresh({ keepDetail: true }), 250);
+});
+
+el.saveToken.addEventListener("click", () => {
+  state.token = el.tokenInput.value.trim();
+  localStorage.setItem(TOKEN_KEY, state.token);
+  el.tokenError.textContent = "";
+  refresh({ keepDetail: true }).then(() => {
+    if (!el.tokenBar.hidden) el.tokenError.textContent = "jeton refusé";
+  });
+});
+
+setInterval(() => {
+  if (el.autoRefresh.checked) refresh({ keepDetail: true });
+}, REFRESH_MS);
+
+refresh();

package/dist/src/server/ui/index.html

@@ -0,0 +1,53 @@
+<!doctype html>
+<html lang="fr">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>MCP Messenger — supervision</title>
+    <link rel="stylesheet" href="./styles.css" />
+  </head>
+  <body>
+    <header class="topbar">
+      <div class="brand">
+        <span class="dot" id="status-dot"></span>
+        <h1>MCP Messenger</h1>
+        <span class="muted" id="server-stats">chargement…</span>
+      </div>
+      <div class="controls">
+        <label class="auto">
+          <input type="checkbox" id="auto-refresh" checked />
+          rafraîchissement auto
+        </label>
+        <button id="refresh">Rafraîchir</button>
+      </div>
+    </header>
+
+    <div id="token-bar" class="token-bar" hidden>
+      <label for="token">Jeton d'accès requis</label>
+      <input type="password" id="token" placeholder="MESSENGER_ADMIN_TOKEN ou MESSENGER_TOKEN" />
+      <button id="save-token">Se connecter</button>
+      <span class="error" id="token-error"></span>
+    </div>
+
+    <main>
+      <aside class="panel agents">
+        <h2>Agents</h2>
+        <ul id="agents"></ul>
+      </aside>
+
+      <section class="panel messages">
+        <div class="filters">
+          <input type="search" id="search" placeholder="Rechercher dans les sujets et les corps…" />
+          <span class="muted" id="filter-label"></span>
+          <button id="clear-filters" class="link">tout afficher</button>
+        </div>
+        <ul id="messages"></ul>
+      </section>
+
+      <section class="panel detail">
+        <div id="detail" class="empty">Sélectionnez un message pour voir son contenu.</div>
+      </section>
+    </main>
+    <script type="module" src="./app.js"></script>
+  </body>
+</html>

package/dist/src/server/ui/styles.css

@@ -0,0 +1,303 @@
+:root {
+  --bg: #f6f7f9;
+  --panel: #ffffff;
+  --border: #e2e5ea;
+  --text: #1c2024;
+  --muted: #6b7280;
+  --accent: #2f6feb;
+  --accent-soft: #e8f0fe;
+  --danger: #c8362f;
+  --radius: 8px;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg: #14171c;
+    --panel: #1b1f26;
+    --border: #2b313b;
+    --text: #e6e9ee;
+    --muted: #98a1b0;
+    --accent: #7aa2f7;
+    --accent-soft: #223049;
+    --danger: #f07178;
+  }
+}
+
+* {
+  box-sizing: border-box;
+}
+
+/* `hidden` doit l'emporter sur les `display` posés plus bas (barre de jeton). */
+[hidden] {
+  display: none !important;
+}
+
+body {
+  margin: 0;
+  font: 14px/1.5 system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+}
+
+.topbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  padding: 12px 20px;
+  background: var(--panel);
+  border-bottom: 1px solid var(--border);
+}
+
+.brand {
+  display: flex;
+  align-items: baseline;
+  gap: 12px;
+}
+
+.brand h1 {
+  font-size: 16px;
+  margin: 0;
+}
+
+.dot {
+  width: 9px;
+  height: 9px;
+  border-radius: 50%;
+  background: var(--muted);
+  align-self: center;
+}
+
+.dot.ok {
+  background: #2ea043;
+}
+
+.dot.ko {
+  background: var(--danger);
+}
+
+.controls {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.auto {
+  color: var(--muted);
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+button {
+  font: inherit;
+  padding: 6px 12px;
+  border-radius: var(--radius);
+  border: 1px solid var(--border);
+  background: var(--panel);
+  color: var(--text);
+  cursor: pointer;
+}
+
+button:hover {
+  border-color: var(--accent);
+}
+
+button.link {
+  border: none;
+  background: none;
+  color: var(--accent);
+  padding: 0;
+}
+
+input[type="search"],
+input[type="password"] {
+  font: inherit;
+  padding: 6px 10px;
+  border-radius: var(--radius);
+  border: 1px solid var(--border);
+  background: var(--panel);
+  color: var(--text);
+}
+
+.token-bar {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 12px 20px;
+  background: var(--accent-soft);
+  border-bottom: 1px solid var(--border);
+}
+
+.token-bar input {
+  min-width: 320px;
+}
+
+main {
+  display: grid;
+  grid-template-columns: 260px minmax(320px, 1fr) minmax(320px, 1.2fr);
+  gap: 12px;
+  padding: 12px;
+  align-items: start;
+  height: calc(100vh - 58px);
+}
+
+.panel {
+  background: var(--panel);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  height: 100%;
+  overflow: auto;
+  padding: 12px;
+}
+
+.panel h2 {
+  font-size: 12px;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  color: var(--muted);
+  margin: 0 0 8px;
+}
+
+ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.agents li {
+  padding: 8px;
+  border-radius: var(--radius);
+  cursor: pointer;
+}
+
+.agents li:hover {
+  background: var(--accent-soft);
+}
+
+.agents li.selected {
+  background: var(--accent-soft);
+  outline: 1px solid var(--accent);
+}
+
+.agents .id {
+  font-weight: 600;
+  word-break: break-all;
+}
+
+.filters {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  margin-bottom: 10px;
+}
+
+.filters input {
+  flex: 1;
+}
+
+.messages li {
+  padding: 10px;
+  border-radius: var(--radius);
+  border: 1px solid transparent;
+  cursor: pointer;
+}
+
+.messages li:hover {
+  background: var(--accent-soft);
+}
+
+.messages li.selected {
+  border-color: var(--accent);
+  background: var(--accent-soft);
+}
+
+.messages .subject {
+  font-weight: 600;
+}
+
+.messages .route {
+  color: var(--muted);
+  font-size: 12px;
+  word-break: break-all;
+}
+
+.messages .preview {
+  color: var(--muted);
+  margin-top: 4px;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.muted {
+  color: var(--muted);
+}
+
+.error {
+  color: var(--danger);
+}
+
+.badge {
+  display: inline-block;
+  font-size: 11px;
+  padding: 1px 6px;
+  border-radius: 999px;
+  border: 1px solid var(--border);
+  color: var(--muted);
+  margin-left: 6px;
+}
+
+.badge.unread {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+.badge.high {
+  border-color: var(--danger);
+  color: var(--danger);
+}
+
+.detail h3 {
+  margin: 0 0 4px;
+  font-size: 16px;
+}
+
+.detail .meta {
+  color: var(--muted);
+  font-size: 12px;
+  white-space: pre-line;
+  margin-bottom: 12px;
+  word-break: break-all;
+}
+
+.detail .body {
+  white-space: pre-wrap;
+  word-wrap: break-word;
+  border-top: 1px solid var(--border);
+  padding-top: 12px;
+}
+
+.detail .deliveries {
+  margin-top: 16px;
+  border-top: 1px solid var(--border);
+  padding-top: 12px;
+}
+
+.detail .deliveries li {
+  padding: 2px 0;
+  color: var(--muted);
+}
+
+.thread-message {
+  border-top: 1px solid var(--border);
+  padding-top: 10px;
+  margin-top: 10px;
+}
+
+.empty {
+  color: var(--muted);
+  padding: 24px 8px;
+  text-align: center;
+}

package/dist/src/version.d.ts

@@ -0,0 +1 @@
+export declare const APP_VERSION = "1.0.1";

package/dist/src/version.js

@@ -0,0 +1,2 @@
+// Généré par scripts/generate-version.js — ne pas modifier à la main.
+export const APP_VERSION = "1.0.1";

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@imenam/mcp-messenger",
+  "version": "1.0.1",
+  "main": "dist/src/index.js",
+  "scripts": {
+    "test": "npm run build && vitest run",
+    "build": "node scripts/generate-version.js && tsc && node scripts/copy-assets.js",
+    "start": "node dist/src/index.js",
+    "serve": "node dist/src/index.js --server",
+    "prepublishOnly": "npm run build",
+    "release": "npm version patch && npm publish && git push --follow-tags",
+    "typecheck": "tsc --noEmit",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "messaging",
+    "mailbox",
+    "agent-to-agent"
+  ],
+  "author": "Matthieu Pesnot-Pin <matthieupin@gmail.com>",
+  "license": "ISC",
+  "description": "Cross-platform agent-to-agent messaging: an MCP mailbox client plus its HTTP mailbox server.",
+  "type": "module",
+  "bin": {
+    "mcp-messenger": "dist/src/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "better-sqlite3": "^12.11.1",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
+    "express-rate-limit": "^8.7.0",
+    "helmet": "^8.3.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.20.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    ".env.example",
+    "LICENSE"
+  ]
+}