@within-7/minto 0.4.1 → 0.4.2

package/dist/services/agentTeams/mailbox.js

@@ -1,33 +1,69 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { existsSync, readFileSync, mkdirSync, watch } from "fs";
+import { acquireFileLock, releaseFileLock } from "../../utils/fileLock.js";
 import { join } from "path";
 import { homedir } from "os";
+import { z } from "zod";
+import { atomicWriteFileSync } from "../../utils/atomicWrite.js";
+import { debug as debugLog } from "../../utils/debugLogger.js";
+const TeamMessageSchema = z.object({
+  id: z.string(),
+  from: z.string(),
+  to: z.string(),
+  text: z.string(),
+  summary: z.string().optional(),
+  color: z.string().optional(),
+  timestamp: z.number(),
+  type: z.enum(["direct", "broadcast"]),
+  read: z.boolean().optional()
+});
+const LOCK_MAX_RETRIES = 2;
+const LOCK_RETRY_DELAY_MS = 500;
+function cooperativeDelay(ms) {
+  try {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+  } catch {
+    const waitUntil = Date.now() + ms;
+    while (Date.now() < waitUntil) {
+    }
+  }
+}
+const MAX_MESSAGES_PER_INBOX = 1e3;
+const READ_MESSAGE_TTL_MS = 5 * 60 * 1e3;
 class Mailbox {
   messages = [];
-  storePath;
+  teamDir;
+  inboxesDir;
   listeners = /* @__PURE__ */ new Map();
+  /** Whether load() has been called. Disk I/O is skipped until initialized. */
+  initialized = false;
+  /** Active fs.watch cleanups keyed by agentId */
+  watcherCleanups = /* @__PURE__ */ new Map();
   constructor(teamName) {
-    this.storePath = join(
-      homedir(),
-      ".minto",
-      "teams",
-      teamName,
-      "mailbox.json"
-    );
+    this.teamDir = join(homedir(), ".minto", "teams", teamName);
+    this.inboxesDir = join(this.teamDir, "inboxes");
   }
   /**
    * Send a message to a specific teammate or broadcast to all
    */
-  send(from, to, content) {
+  send(from, to, text, options) {
     const msg = {
       id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
       from,
       to,
-      content,
+      text,
+      ...options?.summary && { summary: options.summary },
+      ...options?.color && { color: options.color },
       timestamp: Date.now(),
       type: to === "all" ? "broadcast" : "direct"
     };
     this.messages.push(msg);
-    this.persist();
+    if (this.initialized) {
+      if (to === "all") {
+        this.broadcastToInboxes(msg);
+      } else {
+        this.appendToInbox(to, msg);
+      }
+    }
     const targetListeners = to === "all" ? Array.from(this.listeners.values()).flat() : this.listeners.get(to) || [];
     for (const listener of targetListeners) {
       try {
@@ -35,12 +71,15 @@ class Mailbox {
       } catch {
       }
     }
+    this.prune();
     return msg;
   }
   /**
-   * Get unread messages for a teammate
+   * Get unread messages for a teammate.
+   * Reloads from disk first to pick up cross-process messages.
    */
   getUnread(recipientId) {
+    if (this.initialized) this.reloadInbox(recipientId);
     return this.messages.filter(
       (m) => !m.read && (m.to === recipientId || m.to === "all") && m.from !== recipientId
     );
@@ -50,12 +89,21 @@ class Mailbox {
    */
   markRead(messageIds) {
     const idSet = new Set(messageIds);
+    const affectedRecipients = /* @__PURE__ */ new Set();
     for (const msg of this.messages) {
       if (idSet.has(msg.id)) {
         msg.read = true;
+        if (msg.to !== "all") {
+          affectedRecipients.add(msg.to);
+        }
       }
     }
-    this.persist();
+    if (this.initialized) {
+      for (const recipientId of affectedRecipients) {
+        this.persistInbox(recipientId);
+      }
+    }
+    this.prune();
   }
   /**
    * Subscribe to messages for a teammate
@@ -79,34 +127,366 @@ class Mailbox {
     return [...this.messages];
   }
   /**
-   * Persist mailbox to disk (for cross-process teams)
+   * Get all messages involving a specific agent (sent or received)
    */
-  persist() {
+  getMessagesFor(agentId) {
+    if (this.initialized) this.reloadInbox(agentId);
+    return this.messages.filter(
+      (m) => m.from === agentId || m.to === agentId || m.to === "all"
+    );
+  }
+  /**
+   * Load mailbox from disk (initial load).
+   */
+  load() {
+    this.initialized = true;
+    this.ensureInboxesDir();
+    this.loadAllInboxes();
+  }
+  /**
+   * Prune stale messages to prevent unbounded memory growth.
+   * Removes read messages older than READ_MESSAGE_TTL_MS,
+   * then hard-caps at MAX_MESSAGES_PER_INBOX.
+   */
+  prune() {
+    const now = Date.now();
+    this.messages = this.messages.filter(
+      (m) => !m.read || now - m.timestamp < READ_MESSAGE_TTL_MS
+    );
+    if (this.messages.length > MAX_MESSAGES_PER_INBOX) {
+      this.messages = this.messages.slice(-MAX_MESSAGES_PER_INBOX);
+    }
+  }
+  // ── Per-agent inbox persistence ──────────────────────────────
+  ensureInboxesDir() {
     try {
-      const dir = join(this.storePath, "..");
-      if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-      }
-      writeFileSync(
-        this.storePath,
-        JSON.stringify(this.messages, null, 2),
-        "utf-8"
-      );
+      if (!existsSync(this.inboxesDir)) {
+        mkdirSync(this.inboxesDir, { recursive: true, mode: 448 });
+      }
     } catch {
     }
   }
   /**
-   * Load mailbox from disk
+   * Get the file path for an agent's inbox.
+   * Uses the agent name portion before '@' for readability.
    */
-  load() {
-    if (!existsSync(this.storePath)) return;
+  getInboxPath(agentId) {
+    const name = agentId.split("@")[0] || agentId;
+    const safeName = name.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(this.inboxesDir, `${safeName}.json`);
+  }
+  /**
+   * Append a message to a recipient's inbox file.
+   * Retries up to LOCK_MAX_RETRIES times on lock timeout.
+   */
+  appendToInbox(recipientId, msg) {
+    this.ensureInboxesDir();
+    const path = this.getInboxPath(recipientId);
+    const lockPath = path + ".lock";
+    for (let attempt = 0; attempt <= LOCK_MAX_RETRIES; attempt++) {
+      if (attempt > 0) {
+        cooperativeDelay(LOCK_RETRY_DELAY_MS);
+      }
+      if (!acquireFileLock(lockPath, 3e3)) {
+        if (attempt === LOCK_MAX_RETRIES) {
+          debugLog.error("MAILBOX_LOCK_TIMEOUT", {
+            recipientId,
+            attempts: attempt + 1
+          });
+          return;
+        }
+        debugLog.warn("MAILBOX_LOCK_RETRY", {
+          recipientId,
+          attempt: attempt + 1
+        });
+        continue;
+      }
+      try {
+        let inbox = [];
+        if (existsSync(path)) {
+          const content = readFileSync(path, "utf-8");
+          const parsed = z.array(TeamMessageSchema).safeParse(JSON.parse(content));
+          if (parsed.success) {
+            inbox = parsed.data;
+          } else {
+            debugLog.warn("MAILBOX_VALIDATION_FAILED", {
+              recipientId,
+              error: parsed.error.message
+            });
+          }
+        }
+        inbox.push(msg);
+        atomicWriteFileSync(path, JSON.stringify(inbox), 384);
+        return;
+      } catch (error) {
+        debugLog.warn("MAILBOX_APPEND_FAILED", { recipientId, error });
+        return;
+      } finally {
+        releaseFileLock(lockPath);
+      }
+    }
+  }
+  /**
+   * Write all messages for a recipient to their inbox file.
+   * Retries up to LOCK_MAX_RETRIES times on lock timeout.
+   */
+  persistInbox(recipientId) {
+    this.ensureInboxesDir();
+    const path = this.getInboxPath(recipientId);
+    const lockPath = path + ".lock";
+    for (let attempt = 0; attempt <= LOCK_MAX_RETRIES; attempt++) {
+      if (attempt > 0) {
+        cooperativeDelay(LOCK_RETRY_DELAY_MS);
+      }
+      if (!acquireFileLock(lockPath, 3e3)) {
+        if (attempt === LOCK_MAX_RETRIES) {
+          debugLog.error("MAILBOX_LOCK_TIMEOUT", {
+            recipientId,
+            op: "persist",
+            attempts: attempt + 1
+          });
+          return;
+        }
+        debugLog.warn("MAILBOX_LOCK_RETRY", {
+          recipientId,
+          op: "persist",
+          attempt: attempt + 1
+        });
+        continue;
+      }
+      try {
+        const inbox = this.messages.filter(
+          (m) => m.to === recipientId || m.to === "all" && m.from !== recipientId
+        );
+        atomicWriteFileSync(path, JSON.stringify(inbox), 384);
+        return;
+      } catch (error) {
+        debugLog.warn("MAILBOX_PERSIST_FAILED", { recipientId, error });
+        return;
+      } finally {
+        releaseFileLock(lockPath);
+      }
+    }
+  }
+  /**
+   * Broadcast a message by appending it to every known inbox.
+   */
+  broadcastToInboxes(msg) {
+    this.ensureInboxesDir();
+    try {
+      const { readdirSync } = require("fs");
+      const files = readdirSync(this.inboxesDir).filter(
+        (f) => f.endsWith(".json")
+      );
+      for (const file of files) {
+        const filePath = join(this.inboxesDir, file);
+        const lockFilePath = filePath + ".lock";
+        const agentName = file.replace(".json", "");
+        const senderName = msg.from.split("@")[0] || msg.from;
+        if (senderName === agentName) continue;
+        let lockAcquired = false;
+        for (let attempt = 0; attempt <= LOCK_MAX_RETRIES; attempt++) {
+          if (attempt > 0) {
+            cooperativeDelay(LOCK_RETRY_DELAY_MS);
+          }
+          if (acquireFileLock(lockFilePath, 3e3)) {
+            lockAcquired = true;
+            break;
+          }
+        }
+        if (!lockAcquired) {
+          debugLog.error("MAILBOX_BROADCAST_LOCK_TIMEOUT", { file });
+          continue;
+        }
+        try {
+          let inbox = [];
+          const content = readFileSync(filePath, "utf-8");
+          const parsed = z.array(TeamMessageSchema).safeParse(JSON.parse(content));
+          if (parsed.success) {
+            inbox = parsed.data;
+          } else {
+            debugLog.warn("MAILBOX_BROADCAST_VALIDATION_FAILED", {
+              file,
+              error: parsed.error.message
+            });
+          }
+          inbox.push(msg);
+          atomicWriteFileSync(filePath, JSON.stringify(inbox), 384);
+        } catch (error) {
+          debugLog.warn("MAILBOX_BROADCAST_WRITE_FAILED", { file, error });
+        } finally {
+          releaseFileLock(lockFilePath);
+        }
+      }
+    } catch (error) {
+      debugLog.warn("MAILBOX_BROADCAST_FAILED", { error });
+    }
+  }
+  /**
+   * Reload a specific agent's inbox from disk, merging new messages.
+   * Throttled to at most once per 100ms per agent.
+   */
+  inboxReloadTimestamps = /* @__PURE__ */ new Map();
+  reloadInbox(agentId) {
+    const now = Date.now();
+    const lastReload = this.inboxReloadTimestamps.get(agentId) ?? 0;
+    if (now - lastReload < 100) return;
+    this.inboxReloadTimestamps.set(agentId, now);
+    const path = this.getInboxPath(agentId);
+    if (!existsSync(path)) return;
+    try {
+      const content = readFileSync(path, "utf-8");
+      const parsed = z.array(TeamMessageSchema).safeParse(JSON.parse(content));
+      if (!parsed.success) {
+        debugLog.warn("MAILBOX_RELOAD_VALIDATION_FAILED", {
+          agentId,
+          error: parsed.error.message
+        });
+        return;
+      }
+      const diskMessages = parsed.data;
+      const knownIds = new Set(this.messages.map((m) => m.id));
+      let merged = false;
+      for (const msg of diskMessages) {
+        if (!knownIds.has(msg.id)) {
+          this.messages.push(msg);
+          merged = true;
+        } else {
+          const local = this.messages.find((m) => m.id === msg.id);
+          if (local && msg.read && !local.read) {
+            local.read = true;
+          }
+        }
+      }
+      if (merged) {
+        this.messages.sort((a, b) => a.timestamp - b.timestamp);
+      }
+    } catch (error) {
+      debugLog.warn("MAILBOX_RELOAD_FAILED", { agentId, error });
+    }
+  }
+  /**
+   * Load all inbox files into memory (initial load).
+   */
+  loadAllInboxes() {
     try {
-      const content = readFileSync(this.storePath, "utf-8");
-      this.messages = JSON.parse(content);
+      const { readdirSync } = require("fs");
+      const files = readdirSync(this.inboxesDir).filter(
+        (f) => f.endsWith(".json")
+      );
+      const allMessages = [];
+      const seenIds = /* @__PURE__ */ new Set();
+      for (const file of files) {
+        try {
+          const content = readFileSync(join(this.inboxesDir, file), "utf-8");
+          const parsed = z.array(TeamMessageSchema).safeParse(JSON.parse(content));
+          if (!parsed.success) {
+            debugLog.warn("MAILBOX_LOAD_VALIDATION_FAILED", {
+              file,
+              error: parsed.error.message
+            });
+            continue;
+          }
+          const inbox = parsed.data;
+          for (const msg of inbox) {
+            if (!seenIds.has(msg.id)) {
+              allMessages.push(msg);
+              seenIds.add(msg.id);
+            }
+          }
+        } catch {
+        }
+      }
+      this.messages = allMessages.sort((a, b) => a.timestamp - b.timestamp);
     } catch {
       this.messages = [];
     }
   }
+  // ── fs.watch for real-time cross-process delivery ─────────
+  /**
+   * Watch an agent's inbox file for cross-process changes.
+   * When the file is modified by another process, reloads it
+   * and fires subscribe() listeners for any new messages.
+   *
+   * This enables near-instant (~30ms) cross-process message delivery,
+   * replacing heartbeat polling as the primary detection mechanism.
+   * Returns an unsubscribe function that stops the watcher.
+   */
+  startWatching(agentId) {
+    if (this.watcherCleanups.has(agentId)) {
+      return () => this.stopWatching(agentId);
+    }
+    this.ensureInboxesDir();
+    const inboxPath = this.getInboxPath(agentId);
+    const expectedFilename = inboxPath.split("/").pop();
+    let debounceTimer = null;
+    try {
+      const watcher = watch(
+        this.inboxesDir,
+        { persistent: false },
+        (_event, filename) => {
+          if (!filename || filename !== expectedFilename) return;
+          if (debounceTimer) clearTimeout(debounceTimer);
+          debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            this.reloadAndNotify(agentId);
+          }, 30);
+        }
+      );
+      watcher.on("error", () => {
+        this.stopWatching(agentId);
+      });
+      this.watcherCleanups.set(agentId, () => {
+        if (debounceTimer) clearTimeout(debounceTimer);
+        try {
+          watcher.close();
+        } catch {
+        }
+      });
+    } catch {
+    }
+    return () => this.stopWatching(agentId);
+  }
+  /**
+   * Stop watching an agent's inbox file.
+   */
+  stopWatching(agentId) {
+    const cleanup = this.watcherCleanups.get(agentId);
+    if (cleanup) {
+      cleanup();
+      this.watcherCleanups.delete(agentId);
+    }
+  }
+  /**
+   * Stop all active file watchers.
+   */
+  stopAllWatchers() {
+    for (const [agentId] of this.watcherCleanups) {
+      this.stopWatching(agentId);
+    }
+  }
+  /**
+   * Reload an inbox from disk (bypassing throttle) and fire
+   * subscribe() listeners for any genuinely new messages.
+   */
+  reloadAndNotify(agentId) {
+    this.inboxReloadTimestamps.set(agentId, 0);
+    const beforeIds = new Set(this.messages.map((m) => m.id));
+    this.reloadInbox(agentId);
+    const newMessages = this.messages.filter(
+      (m) => !beforeIds.has(m.id) && !m.read && (m.to === agentId || m.to === "all") && m.from !== agentId
+    );
+    if (newMessages.length === 0) return;
+    const targetListeners = this.listeners.get(agentId) || [];
+    for (const msg of newMessages) {
+      for (const listener of targetListeners) {
+        try {
+          listener(msg);
+        } catch {
+        }
+      }
+    }
+  }
 }
 export {
   Mailbox

package/dist/services/agentTeams/mailbox.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/services/agentTeams/mailbox.ts"],
-  "sourcesContent": ["/**\n * Agent Teams Mailbox\n *\n * Message passing system between teammates.\n * In-memory for in-process mode; file-based for cross-process (tmux).\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs'\nimport { join } from 'path'\nimport { homedir } from 'os'\nimport type { TeamMessage } from '../../types/agentTeams'\n\n/**\n * Mailbox for a team's inter-agent messaging\n */\nexport class Mailbox {\n  private messages: TeamMessage[] = []\n  private storePath: string\n  private listeners = new Map<string, ((msg: TeamMessage) => void)[]>()\n\n  constructor(teamName: string) {\n    this.storePath = join(\n      homedir(),\n      '.minto',\n      'teams',\n      teamName,\n      'mailbox.json',\n    )\n  }\n\n  /**\n   * Send a message to a specific teammate or broadcast to all\n   */\n  send(from: string, to: string | 'all', content: string): TeamMessage {\n    const msg: TeamMessage = {\n      id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,\n      from,\n      to,\n      content,\n      timestamp: Date.now(),\n      type: to === 'all' ? 'broadcast' : 'direct',\n    }\n\n    this.messages.push(msg)\n    this.persist()\n\n    // Notify listeners\n    const targetListeners =\n      to === 'all'\n        ? Array.from(this.listeners.values()).flat()\n        : this.listeners.get(to) || []\n\n    for (const listener of targetListeners) {\n      try {\n        listener(msg)\n      } catch {\n        // Don't let listener errors break sending\n      }\n    }\n\n    return msg\n  }\n\n  /**\n   * Get unread messages for a teammate\n   */\n  getUnread(recipientId: string): TeamMessage[] {\n    return this.messages.filter(\n      m =>\n        !m.read &&\n        (m.to === recipientId || m.to === 'all') &&\n        m.from !== recipientId,\n    )\n  }\n\n  /**\n   * Mark messages as read\n   */\n  markRead(messageIds: string[]): void {\n    const idSet = new Set(messageIds)\n    for (const msg of this.messages) {\n      if (idSet.has(msg.id)) {\n        msg.read = true\n      }\n    }\n    this.persist()\n  }\n\n  /**\n   * Subscribe to messages for a teammate\n   */\n  subscribe(\n    recipientId: string,\n    callback: (msg: TeamMessage) => void,\n  ): () => void {\n    const existing = this.listeners.get(recipientId) || []\n    existing.push(callback)\n    this.listeners.set(recipientId, existing)\n\n    return () => {\n      const list = this.listeners.get(recipientId)\n      if (list) {\n        const idx = list.indexOf(callback)\n        if (idx >= 0) list.splice(idx, 1)\n      }\n    }\n  }\n\n  /**\n   * Get all messages (for debugging/display)\n   */\n  getAll(): TeamMessage[] {\n    return [...this.messages]\n  }\n\n  /**\n   * Persist mailbox to disk (for cross-process teams)\n   */\n  private persist(): void {\n    try {\n      const dir = join(this.storePath, '..')\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true })\n      }\n      writeFileSync(\n        this.storePath,\n        JSON.stringify(this.messages, null, 2),\n        'utf-8',\n      )\n    } catch {\n      // Best-effort persistence\n    }\n  }\n\n  /**\n   * Load mailbox from disk\n   */\n  load(): void {\n    if (!existsSync(this.storePath)) return\n\n    try {\n      const content = readFileSync(this.storePath, 'utf-8')\n      this.messages = JSON.parse(content)\n    } catch {\n      // Start fresh on parse error\n      this.messages = []\n    }\n  }\n}\n"],
-  "mappings": "AAOA,SAAS,YAAY,cAAc,eAAe,iBAAiB;AACnE,SAAS,YAAY;AACrB,SAAS,eAAe;AAMjB,MAAM,QAAQ;AAAA,EACX,WAA0B,CAAC;AAAA,EAC3B;AAAA,EACA,YAAY,oBAAI,IAA4C;AAAA,EAEpE,YAAY,UAAkB;AAC5B,SAAK,YAAY;AAAA,MACf,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,KAAK,MAAc,IAAoB,SAA8B;AACnE,UAAM,MAAmB;AAAA,MACvB,IAAI,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAAA,MAC/D;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,KAAK,IAAI;AAAA,MACpB,MAAM,OAAO,QAAQ,cAAc;AAAA,IACrC;AAEA,SAAK,SAAS,KAAK,GAAG;AACtB,SAAK,QAAQ;AAGb,UAAM,kBACJ,OAAO,QACH,MAAM,KAAK,KAAK,UAAU,OAAO,CAAC,EAAE,KAAK,IACzC,KAAK,UAAU,IAAI,EAAE,KAAK,CAAC;AAEjC,eAAW,YAAY,iBAAiB;AACtC,UAAI;AACF,iBAAS,GAAG;AAAA,MACd,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,aAAoC;AAC5C,WAAO,KAAK,SAAS;AAAA,MACnB,OACE,CAAC,EAAE,SACF,EAAE,OAAO,eAAe,EAAE,OAAO,UAClC,EAAE,SAAS;AAAA,IACf;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,YAA4B;AACnC,UAAM,QAAQ,IAAI,IAAI,UAAU;AAChC,eAAW,OAAO,KAAK,UAAU;AAC/B,UAAI,MAAM,IAAI,IAAI,EAAE,GAAG;AACrB,YAAI,OAAO;AAAA,MACb;AAAA,IACF;AACA,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,UACE,aACA,UACY;AACZ,UAAM,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,CAAC;AACrD,aAAS,KAAK,QAAQ;AACtB,SAAK,UAAU,IAAI,aAAa,QAAQ;AAExC,WAAO,MAAM;AACX,YAAM,OAAO,KAAK,UAAU,IAAI,WAAW;AAC3C,UAAI,MAAM;AACR,cAAM,MAAM,KAAK,QAAQ,QAAQ;AACjC,YAAI,OAAO,EAAG,MAAK,OAAO,KAAK,CAAC;AAAA,MAClC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,SAAwB;AACtB,WAAO,CAAC,GAAG,KAAK,QAAQ;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKQ,UAAgB;AACtB,QAAI;AACF,YAAM,MAAM,KAAK,KAAK,WAAW,IAAI;AACrC,UAAI,CAAC,WAAW,GAAG,GAAG;AACpB,kBAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AAAA,MACpC;AACA;AAAA,QACE,KAAK;AAAA,QACL,KAAK,UAAU,KAAK,UAAU,MAAM,CAAC;AAAA,QACrC;AAAA,MACF;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACX,QAAI,CAAC,WAAW,KAAK,SAAS,EAAG;AAEjC,QAAI;AACF,YAAM,UAAU,aAAa,KAAK,WAAW,OAAO;AACpD,WAAK,WAAW,KAAK,MAAM,OAAO;AAAA,IACpC,QAAQ;AAEN,WAAK,WAAW,CAAC;AAAA,IACnB;AAAA,EACF;AACF;",
+  "sourcesContent": ["/**\n * Agent Teams Mailbox\n *\n * Message passing system between teammates.\n * Uses per-agent inbox files to reduce lock contention in multi-process mode.\n *\n * Directory structure:\n *   ~/.minto/teams/<team>/\n *     \u2514\u2500\u2500 inboxes/\n *         \u251C\u2500\u2500 team-lead.json     # team-lead's inbox\n *         \u251C\u2500\u2500 researcher.json    # researcher's inbox\n *         \u2514\u2500\u2500 implementer.json   # implementer's inbox\n */\n\nimport { existsSync, readFileSync, mkdirSync, watch } from 'fs'\nimport { randomUUID } from 'crypto'\nimport { acquireFileLock, releaseFileLock } from '@utils/fileLock'\nimport { join } from 'path'\nimport { homedir } from 'os'\nimport { z } from 'zod'\nimport type { TeamMessage } from '../../types/agentTeams'\nimport { atomicWriteFileSync } from '../../utils/atomicWrite'\nimport { debug as debugLog } from '../../utils/debugLogger'\n\n/** Zod schema for TeamMessage \u2014 used to validate JSON parsed from inbox files */\nconst TeamMessageSchema = z.object({\n  id: z.string(),\n  from: z.string(),\n  to: z.string(),\n  text: z.string(),\n  summary: z.string().optional(),\n  color: z.string().optional(),\n  timestamp: z.number(),\n  type: z.enum(['direct', 'broadcast']),\n  read: z.boolean().optional(),\n})\n\n/** Max retries when file lock acquisition fails */\nconst LOCK_MAX_RETRIES = 2\n/** Delay between lock retries (ms) */\nconst LOCK_RETRY_DELAY_MS = 500\n\n/**\n * Cooperative delay that yields the thread instead of spin-waiting.\n * Uses Atomics.wait (true thread sleep) when available,\n * falls back to spin-wait for environments without SharedArrayBuffer.\n */\nfunction cooperativeDelay(ms: number): void {\n  try {\n    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms)\n  } catch {\n    const waitUntil = Date.now() + ms\n    while (Date.now() < waitUntil) {\n      /* fallback for environments without SharedArrayBuffer */\n    }\n  }\n}\n\n/**\n * Mailbox for a team's inter-agent messaging\n *\n * Uses per-agent inbox files for cross-process safety.\n */\n/** Max messages kept per inbox before hard-pruning */\nconst MAX_MESSAGES_PER_INBOX = 1000\n/** Read messages older than this are eligible for pruning */\nconst READ_MESSAGE_TTL_MS = 5 * 60 * 1000 // 5 minutes\n\nexport class Mailbox {\n  private messages: TeamMessage[] = []\n  private teamDir: string\n  private inboxesDir: string\n  private listeners = new Map<string, ((msg: TeamMessage) => void)[]>()\n  /** Whether load() has been called. Disk I/O is skipped until initialized. */\n  private initialized = false\n  /** Active fs.watch cleanups keyed by agentId */\n  private watcherCleanups = new Map<string, () => void>()\n\n  constructor(teamName: string) {\n    this.teamDir = join(homedir(), '.minto', 'teams', teamName)\n    this.inboxesDir = join(this.teamDir, 'inboxes')\n  }\n\n  /**\n   * Send a message to a specific teammate or broadcast to all\n   */\n  send(\n    from: string,\n    to: string | 'all',\n    text: string,\n    options?: {\n      summary?: string\n      color?: string\n    },\n  ): TeamMessage {\n    const msg: TeamMessage = {\n      id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,\n      from,\n      to,\n      text,\n      ...(options?.summary && { summary: options.summary }),\n      ...(options?.color && { color: options.color }),\n      timestamp: Date.now(),\n      type: to === 'all' ? 'broadcast' : 'direct',\n    }\n\n    this.messages.push(msg)\n\n    if (this.initialized) {\n      if (to === 'all') {\n        this.broadcastToInboxes(msg)\n      } else {\n        this.appendToInbox(to, msg)\n      }\n    }\n\n    // Notify in-process listeners\n    const targetListeners =\n      to === 'all'\n        ? Array.from(this.listeners.values()).flat()\n        : this.listeners.get(to) || []\n\n    for (const listener of targetListeners) {\n      try {\n        listener(msg)\n      } catch {\n        // Don't let listener errors break sending\n      }\n    }\n\n    this.prune()\n    return msg\n  }\n\n  /**\n   * Get unread messages for a teammate.\n   * Reloads from disk first to pick up cross-process messages.\n   */\n  getUnread(recipientId: string): TeamMessage[] {\n    if (this.initialized) this.reloadInbox(recipientId)\n    return this.messages.filter(\n      m =>\n        !m.read &&\n        (m.to === recipientId || m.to === 'all') &&\n        m.from !== recipientId,\n    )\n  }\n\n  /**\n   * Mark messages as read\n   */\n  markRead(messageIds: string[]): void {\n    const idSet = new Set(messageIds)\n    const affectedRecipients = new Set<string>()\n\n    for (const msg of this.messages) {\n      if (idSet.has(msg.id)) {\n        msg.read = true\n        if (msg.to !== 'all') {\n          affectedRecipients.add(msg.to)\n        }\n      }\n    }\n\n    if (this.initialized) {\n      for (const recipientId of affectedRecipients) {\n        this.persistInbox(recipientId)\n      }\n    }\n    this.prune()\n  }\n\n  /**\n   * Subscribe to messages for a teammate\n   */\n  subscribe(\n    recipientId: string,\n    callback: (msg: TeamMessage) => void,\n  ): () => void {\n    const existing = this.listeners.get(recipientId) || []\n    existing.push(callback)\n    this.listeners.set(recipientId, existing)\n\n    return () => {\n      const list = this.listeners.get(recipientId)\n      if (list) {\n        const idx = list.indexOf(callback)\n        if (idx >= 0) list.splice(idx, 1)\n      }\n    }\n  }\n\n  /**\n   * Get all messages (for debugging/display)\n   */\n  getAll(): TeamMessage[] {\n    return [...this.messages]\n  }\n\n  /**\n   * Get all messages involving a specific agent (sent or received)\n   */\n  getMessagesFor(agentId: string): TeamMessage[] {\n    if (this.initialized) this.reloadInbox(agentId)\n    return this.messages.filter(\n      m => m.from === agentId || m.to === agentId || m.to === 'all',\n    )\n  }\n\n  /**\n   * Load mailbox from disk (initial load).\n   */\n  load(): void {\n    this.initialized = true\n    this.ensureInboxesDir()\n    this.loadAllInboxes()\n  }\n\n  /**\n   * Prune stale messages to prevent unbounded memory growth.\n   * Removes read messages older than READ_MESSAGE_TTL_MS,\n   * then hard-caps at MAX_MESSAGES_PER_INBOX.\n   */\n  private prune(): void {\n    const now = Date.now()\n    // Remove read messages that have expired\n    this.messages = this.messages.filter(\n      m => !m.read || now - m.timestamp < READ_MESSAGE_TTL_MS,\n    )\n    // Hard cap: keep most recent messages\n    if (this.messages.length > MAX_MESSAGES_PER_INBOX) {\n      this.messages = this.messages.slice(-MAX_MESSAGES_PER_INBOX)\n    }\n  }\n\n  // \u2500\u2500 Per-agent inbox persistence \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private ensureInboxesDir(): void {\n    try {\n      if (!existsSync(this.inboxesDir)) {\n        mkdirSync(this.inboxesDir, { recursive: true, mode: 0o700 })\n      }\n    } catch {\n      // Best-effort\n    }\n  }\n\n  /**\n   * Get the file path for an agent's inbox.\n   * Uses the agent name portion before '@' for readability.\n   */\n  private getInboxPath(agentId: string): string {\n    // \"researcher@my-team\" \u2192 \"researcher.json\"\n    const name = agentId.split('@')[0] || agentId\n    // Sanitize for filesystem safety\n    const safeName = name.replace(/[^a-zA-Z0-9_-]/g, '_')\n    return join(this.inboxesDir, `${safeName}.json`)\n  }\n\n  /**\n   * Append a message to a recipient's inbox file.\n   * Retries up to LOCK_MAX_RETRIES times on lock timeout.\n   */\n  private appendToInbox(recipientId: string, msg: TeamMessage): void {\n    this.ensureInboxesDir()\n    const path = this.getInboxPath(recipientId)\n    const lockPath = path + '.lock'\n\n    for (let attempt = 0; attempt <= LOCK_MAX_RETRIES; attempt++) {\n      if (attempt > 0) {\n        cooperativeDelay(LOCK_RETRY_DELAY_MS)\n      }\n\n      if (!acquireFileLock(lockPath, 3000)) {\n        if (attempt === LOCK_MAX_RETRIES) {\n          debugLog.error('MAILBOX_LOCK_TIMEOUT', {\n            recipientId,\n            attempts: attempt + 1,\n          })\n          return\n        }\n        debugLog.warn('MAILBOX_LOCK_RETRY', {\n          recipientId,\n          attempt: attempt + 1,\n        })\n        continue\n      }\n\n      try {\n        let inbox: TeamMessage[] = []\n        if (existsSync(path)) {\n          const content = readFileSync(path, 'utf-8')\n          const parsed = z\n            .array(TeamMessageSchema)\n            .safeParse(JSON.parse(content))\n          if (parsed.success) {\n            inbox = parsed.data as TeamMessage[]\n          } else {\n            debugLog.warn('MAILBOX_VALIDATION_FAILED', {\n              recipientId,\n              error: parsed.error.message,\n            })\n            // Fall back to empty inbox rather than corrupting further\n          }\n        }\n        inbox.push(msg)\n        atomicWriteFileSync(path, JSON.stringify(inbox), 0o600)\n        return // success\n      } catch (error) {\n        debugLog.warn('MAILBOX_APPEND_FAILED', { recipientId, error })\n        return\n      } finally {\n        releaseFileLock(lockPath)\n      }\n    }\n  }\n\n  /**\n   * Write all messages for a recipient to their inbox file.\n   * Retries up to LOCK_MAX_RETRIES times on lock timeout.\n   */\n  private persistInbox(recipientId: string): void {\n    this.ensureInboxesDir()\n    const path = this.getInboxPath(recipientId)\n    const lockPath = path + '.lock'\n\n    for (let attempt = 0; attempt <= LOCK_MAX_RETRIES; attempt++) {\n      if (attempt > 0) {\n        cooperativeDelay(LOCK_RETRY_DELAY_MS)\n      }\n\n      if (!acquireFileLock(lockPath, 3000)) {\n        if (attempt === LOCK_MAX_RETRIES) {\n          debugLog.error('MAILBOX_LOCK_TIMEOUT', {\n            recipientId,\n            op: 'persist',\n            attempts: attempt + 1,\n          })\n          return\n        }\n        debugLog.warn('MAILBOX_LOCK_RETRY', {\n          recipientId,\n          op: 'persist',\n          attempt: attempt + 1,\n        })\n        continue\n      }\n\n      try {\n        const inbox = this.messages.filter(\n          m =>\n            m.to === recipientId || (m.to === 'all' && m.from !== recipientId),\n        )\n        atomicWriteFileSync(path, JSON.stringify(inbox), 0o600)\n        return // success\n      } catch (error) {\n        debugLog.warn('MAILBOX_PERSIST_FAILED', { recipientId, error })\n        return\n      } finally {\n        releaseFileLock(lockPath)\n      }\n    }\n  }\n\n  /**\n   * Broadcast a message by appending it to every known inbox.\n   */\n  private broadcastToInboxes(msg: TeamMessage): void {\n    this.ensureInboxesDir()\n    try {\n      const { readdirSync } = require('fs') as typeof import('fs')\n      const files = readdirSync(this.inboxesDir).filter((f: string) =>\n        f.endsWith('.json'),\n      )\n      for (const file of files) {\n        const filePath = join(this.inboxesDir, file)\n        const lockFilePath = filePath + '.lock'\n        // Don't add to sender's own inbox\n        const agentName = file.replace('.json', '')\n        const senderName = msg.from.split('@')[0] || msg.from\n        if (senderName === agentName) continue\n\n        let lockAcquired = false\n        for (let attempt = 0; attempt <= LOCK_MAX_RETRIES; attempt++) {\n          if (attempt > 0) {\n            cooperativeDelay(LOCK_RETRY_DELAY_MS)\n          }\n          if (acquireFileLock(lockFilePath, 3000)) {\n            lockAcquired = true\n            break\n          }\n        }\n        if (!lockAcquired) {\n          debugLog.error('MAILBOX_BROADCAST_LOCK_TIMEOUT', { file })\n          continue\n        }\n\n        try {\n          let inbox: TeamMessage[] = []\n          const content = readFileSync(filePath, 'utf-8')\n          const parsed = z\n            .array(TeamMessageSchema)\n            .safeParse(JSON.parse(content))\n          if (parsed.success) {\n            inbox = parsed.data as TeamMessage[]\n          } else {\n            debugLog.warn('MAILBOX_BROADCAST_VALIDATION_FAILED', {\n              file,\n              error: parsed.error.message,\n            })\n          }\n          inbox.push(msg)\n          atomicWriteFileSync(filePath, JSON.stringify(inbox), 0o600)\n        } catch (error) {\n          debugLog.warn('MAILBOX_BROADCAST_WRITE_FAILED', { file, error })\n        } finally {\n          releaseFileLock(lockFilePath)\n        }\n      }\n    } catch (error) {\n      debugLog.warn('MAILBOX_BROADCAST_FAILED', { error })\n    }\n  }\n\n  /**\n   * Reload a specific agent's inbox from disk, merging new messages.\n   * Throttled to at most once per 100ms per agent.\n   */\n  private inboxReloadTimestamps = new Map<string, number>()\n  private reloadInbox(agentId: string): void {\n    const now = Date.now()\n    const lastReload = this.inboxReloadTimestamps.get(agentId) ?? 0\n    if (now - lastReload < 100) return\n    this.inboxReloadTimestamps.set(agentId, now)\n\n    const path = this.getInboxPath(agentId)\n    if (!existsSync(path)) return\n\n    try {\n      const content = readFileSync(path, 'utf-8')\n      const parsed = z.array(TeamMessageSchema).safeParse(JSON.parse(content))\n      if (!parsed.success) {\n        debugLog.warn('MAILBOX_RELOAD_VALIDATION_FAILED', {\n          agentId,\n          error: parsed.error.message,\n        })\n        return\n      }\n      const diskMessages = parsed.data as TeamMessage[]\n\n      const knownIds = new Set(this.messages.map(m => m.id))\n      let merged = false\n      for (const msg of diskMessages) {\n        if (!knownIds.has(msg.id)) {\n          this.messages.push(msg)\n          merged = true\n        } else {\n          // Sync read state from disk\n          const local = this.messages.find(m => m.id === msg.id)\n          if (local && msg.read && !local.read) {\n            local.read = true\n          }\n        }\n      }\n      if (merged) {\n        this.messages.sort((a, b) => a.timestamp - b.timestamp)\n      }\n    } catch (error) {\n      debugLog.warn('MAILBOX_RELOAD_FAILED', { agentId, error })\n    }\n  }\n\n  /**\n   * Load all inbox files into memory (initial load).\n   */\n  private loadAllInboxes(): void {\n    try {\n      const { readdirSync } = require('fs') as typeof import('fs')\n      const files = readdirSync(this.inboxesDir).filter((f: string) =>\n        f.endsWith('.json'),\n      )\n      const allMessages: TeamMessage[] = []\n      const seenIds = new Set<string>()\n\n      for (const file of files) {\n        try {\n          const content = readFileSync(join(this.inboxesDir, file), 'utf-8')\n          const parsed = z\n            .array(TeamMessageSchema)\n            .safeParse(JSON.parse(content))\n          if (!parsed.success) {\n            debugLog.warn('MAILBOX_LOAD_VALIDATION_FAILED', {\n              file,\n              error: parsed.error.message,\n            })\n            continue // Skip files that fail validation\n          }\n          const inbox = parsed.data as TeamMessage[]\n          for (const msg of inbox) {\n            if (!seenIds.has(msg.id)) {\n              allMessages.push(msg)\n              seenIds.add(msg.id)\n            }\n          }\n        } catch {\n          // Skip corrupt inbox files\n        }\n      }\n\n      this.messages = allMessages.sort((a, b) => a.timestamp - b.timestamp)\n    } catch {\n      this.messages = []\n    }\n  }\n\n  // \u2500\u2500 fs.watch for real-time cross-process delivery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Watch an agent's inbox file for cross-process changes.\n   * When the file is modified by another process, reloads it\n   * and fires subscribe() listeners for any new messages.\n   *\n   * This enables near-instant (~30ms) cross-process message delivery,\n   * replacing heartbeat polling as the primary detection mechanism.\n   * Returns an unsubscribe function that stops the watcher.\n   */\n  startWatching(agentId: string): () => void {\n    if (this.watcherCleanups.has(agentId)) {\n      return () => this.stopWatching(agentId)\n    }\n\n    this.ensureInboxesDir()\n\n    // Derive the expected filename (same logic as getInboxPath)\n    const inboxPath = this.getInboxPath(agentId)\n    const expectedFilename = inboxPath.split('/').pop()!\n\n    let debounceTimer: ReturnType<typeof setTimeout> | null = null\n\n    try {\n      const watcher = watch(\n        this.inboxesDir,\n        { persistent: false },\n        (_event, filename) => {\n          if (!filename || filename !== expectedFilename) return\n\n          // Debounce: batch rapid writes (e.g. multiple sends in quick succession)\n          if (debounceTimer) clearTimeout(debounceTimer)\n          debounceTimer = setTimeout(() => {\n            debounceTimer = null\n            this.reloadAndNotify(agentId)\n          }, 30)\n        },\n      )\n\n      watcher.on('error', () => {\n        // Watcher failed \u2014 heartbeat safety net will continue polling\n        this.stopWatching(agentId)\n      })\n\n      this.watcherCleanups.set(agentId, () => {\n        if (debounceTimer) clearTimeout(debounceTimer)\n        try {\n          watcher.close()\n        } catch {\n          // Best-effort cleanup\n        }\n      })\n    } catch {\n      // fs.watch not available on this platform \u2014 fall back to heartbeat polling\n    }\n\n    return () => this.stopWatching(agentId)\n  }\n\n  /**\n   * Stop watching an agent's inbox file.\n   */\n  stopWatching(agentId: string): void {\n    const cleanup = this.watcherCleanups.get(agentId)\n    if (cleanup) {\n      cleanup()\n      this.watcherCleanups.delete(agentId)\n    }\n  }\n\n  /**\n   * Stop all active file watchers.\n   */\n  stopAllWatchers(): void {\n    for (const [agentId] of this.watcherCleanups) {\n      this.stopWatching(agentId)\n    }\n  }\n\n  /**\n   * Reload an inbox from disk (bypassing throttle) and fire\n   * subscribe() listeners for any genuinely new messages.\n   */\n  private reloadAndNotify(agentId: string): void {\n    // Force fresh read by setting timestamp far enough in the past\n    this.inboxReloadTimestamps.set(agentId, 0)\n\n    // Snapshot current message IDs before reload\n    const beforeIds = new Set(this.messages.map(m => m.id))\n\n    // Reload from disk (reloadInbox sets timestamp to Date.now() after read)\n    this.reloadInbox(agentId)\n\n    // Find genuinely new, unread messages for this agent\n    const newMessages = this.messages.filter(\n      m =>\n        !beforeIds.has(m.id) &&\n        !m.read &&\n        (m.to === agentId || m.to === 'all') &&\n        m.from !== agentId,\n    )\n\n    if (newMessages.length === 0) return\n\n    // Fire subscribe() listeners \u2014 same callback path as in-process sends\n    const targetListeners = this.listeners.get(agentId) || []\n    for (const msg of newMessages) {\n      for (const listener of targetListeners) {\n        try {\n          listener(msg)\n        } catch {\n          // Don't let listener errors break the watcher\n        }\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/services/agentTeams/messageFormatter.js

@@ -0,0 +1,80 @@
+function sanitizeTeamMessageText(text) {
+  return text.replace(/<\/team-message>/gi, "[team-message-close]").replace(/<system-reminder>/gi, "[system-reminder-open]").replace(/<\/system-reminder>/gi, "[system-reminder-close]").replace(/<tool_use>/gi, "[tool-use-open]").replace(/<\/tool_use>/gi, "[tool-use-close]").replace(/<tool_result>/gi, "[tool-result-open]").replace(/<\/tool_result>/gi, "[tool-result-close]").replace(/<team-message\b/gi, "[team-message-open").replace(/<user-guidance>/gi, "[user-guidance-open]").replace(/<\/user-guidance>/gi, "[user-guidance-close]").replace(/<task-notification>/gi, "[task-notification-open]").replace(/<\/task-notification>/gi, "[task-notification-close]").replace(/<preloaded-skill>/gi, "[preloaded-skill-open]").replace(/<\/preloaded-skill>/gi, "[preloaded-skill-close]");
+}
+function formatTeamMessage(msg) {
+  const senderName = msg.from.split("@")[0] || msg.from;
+  const summaryText = msg.summary || msg.text.slice(0, 60).replace(/"/g, "'");
+  const colorAttr = msg.color ? ` color="${msg.color}"` : "";
+  const sanitizedText = sanitizeTeamMessageText(msg.text);
+  return `<team-message from="${senderName}"${colorAttr} summary="${summaryText}">
+${sanitizedText}
+</team-message>`;
+}
+function formatTeamMessagesForInjection(messages) {
+  return messages.map(formatTeamMessage).join("\n\n");
+}
+function formatUserGuidanceForInjection(input) {
+  const sanitizedInput = sanitizeTeamMessageText(input);
+  return `<user-guidance>
+${sanitizedInput}
+</user-guidance>`;
+}
+function formatIdleNotificationForInjection(notification) {
+  const parts = ["<task-notification>"];
+  if (notification.taskId) {
+    parts.push(`  <task-id>${notification.taskId}</task-id>`);
+  }
+  parts.push(`  <status>${notification.status}</status>`);
+  parts.push(
+    `  <message>${notification.message || `Teammate "${notification.agentName}" is now ${notification.status}.`}</message>`
+  );
+  if (notification.summary) {
+    parts.push(`  <summary>${notification.summary}</summary>`);
+  }
+  parts.push("</task-notification>");
+  return parts.join("\n");
+}
+const PROTOCOL_SUMMARIES = {
+  shutdown_approved: "Shutdown approved",
+  shutdown_rejected: "Shutdown rejected",
+  shutdown_request: "Shutdown requested",
+  plan_approved: "Plan approved",
+  plan_rejected: "Plan rejected",
+  plan_approval_request: "Plan review requested"
+};
+function humanizeProtocolMessage(text) {
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed && typeof parsed === "object" && parsed.type in PROTOCOL_SUMMARIES) {
+      return PROTOCOL_SUMMARIES[parsed.type] || parsed.type;
+    }
+  } catch {
+  }
+  return null;
+}
+function parseIdleNotification(text) {
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed && typeof parsed === "object" && (parsed.type === "idle_notification" || parsed.type === "task_completed" || parsed.type === "idle")) {
+      return {
+        agentName: parsed.agentName || parsed.from || "unknown",
+        status: parsed.status || parsed.completedStatus || "idle",
+        taskId: parsed.taskId,
+        message: parsed.message,
+        summary: parsed.summary
+      };
+    }
+  } catch {
+  }
+  return null;
+}
+export {
+  formatIdleNotificationForInjection,
+  formatTeamMessage,
+  formatTeamMessagesForInjection,
+  formatUserGuidanceForInjection,
+  humanizeProtocolMessage,
+  parseIdleNotification,
+  sanitizeTeamMessageText
+};
+//# sourceMappingURL=messageFormatter.js.map