@within-7/minto 0.4.2 → 0.4.3

package/dist/services/agentTeams/index.js

@@ -1,75 +0,0 @@
-import {
-  isAgentTeamsEnabled,
-  sanitizeTeamName,
-  createTeam,
-  addTeammate,
-  updateTeammateStatus,
-  getTeam,
-  getActiveTeams,
-  disbandTeam,
-  disbandAllTeams,
-  loadTeam,
-  resolveDisplayMode,
-  registerAgentAbortController,
-  unregisterAgentAbortController,
-  updateTeammateWorktree
-} from "./teamManager.js";
-import { Mailbox } from "./mailbox.js";
-import { TeamTaskStore } from "./teamTaskStore.js";
-import {
-  spawnTeammate,
-  markTeammateIdle,
-  markTeammateCompleted,
-  getTeamSummary
-} from "./teammateSpawner.js";
-import { teamEvents } from "./teamEvents.js";
-import { MessageInjectionChannel } from "./injectionChannel.js";
-import { AgentHeartbeat } from "./heartbeat.js";
-import {
-  formatTeamMessage,
-  formatTeamMessagesForInjection,
-  formatUserGuidanceForInjection,
-  formatIdleNotificationForInjection,
-  parseIdleNotification
-} from "./messageFormatter.js";
-import { resolveBackend } from "./backends/resolver.js";
-import { TmuxBackend } from "./backends/tmux.js";
-import { InProcessBackend } from "./backends/inProcess.js";
-function safeQuote(s) {
-  return `'${s.replace(/'/g, "'\\''")}'`;
-}
-export {
-  AgentHeartbeat,
-  InProcessBackend,
-  Mailbox,
-  MessageInjectionChannel,
-  TeamTaskStore,
-  TmuxBackend,
-  addTeammate,
-  createTeam,
-  disbandAllTeams,
-  disbandTeam,
-  formatIdleNotificationForInjection,
-  formatTeamMessage,
-  formatTeamMessagesForInjection,
-  formatUserGuidanceForInjection,
-  getActiveTeams,
-  getTeam,
-  getTeamSummary,
-  isAgentTeamsEnabled,
-  loadTeam,
-  markTeammateCompleted,
-  markTeammateIdle,
-  parseIdleNotification,
-  registerAgentAbortController,
-  resolveBackend,
-  resolveDisplayMode,
-  safeQuote,
-  sanitizeTeamName,
-  spawnTeammate,
-  teamEvents,
-  unregisterAgentAbortController,
-  updateTeammateStatus,
-  updateTeammateWorktree
-};
-//# sourceMappingURL=index.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/services/agentTeams/index.ts"],
-  "sourcesContent": ["/**\n * Agent Teams Module\n *\n * Multi-agent collaboration with message-based coordination.\n * Enabled by default. Disable with MINTO_EXPERIMENTAL_AGENT_TEAMS=0\n */\n\nexport {\n  isAgentTeamsEnabled,\n  sanitizeTeamName,\n  createTeam,\n  addTeammate,\n  updateTeammateStatus,\n  getTeam,\n  getActiveTeams,\n  disbandTeam,\n  disbandAllTeams,\n  loadTeam,\n  resolveDisplayMode,\n  registerAgentAbortController,\n  unregisterAgentAbortController,\n  updateTeammateWorktree,\n} from './teamManager'\n\nexport { Mailbox } from './mailbox'\nexport { TeamTaskStore } from './teamTaskStore'\nexport {\n  spawnTeammate,\n  markTeammateIdle,\n  markTeammateCompleted,\n  getTeamSummary,\n} from './teammateSpawner'\n\nexport { teamEvents } from './teamEvents'\nexport type { MemberStatusChangeData, TeamChangeData } from './teamEvents'\n\n// Message injection infrastructure\nexport { MessageInjectionChannel } from './injectionChannel'\nexport type { InjectionSource, InjectedMessage } from './injectionChannel'\n\nexport { AgentHeartbeat } from './heartbeat'\n\nexport {\n  formatTeamMessage,\n  formatTeamMessagesForInjection,\n  formatUserGuidanceForInjection,\n  formatIdleNotificationForInjection,\n  parseIdleNotification,\n} from './messageFormatter'\nexport type { IdleNotificationData } from './messageFormatter'\n\n// DisplayBackend abstractions\nexport { resolveBackend } from './backends/resolver'\nexport { TmuxBackend } from './backends/tmux'\nexport { InProcessBackend } from './backends/inProcess'\nexport type {\n  DisplayBackend,\n  AgentHandle,\n  SpawnOptions,\n} from './backends/types'\n\n/**\n * POSIX-safe single-quote escaping for shell arguments.\n * Prevents shell injection when passing args through tmux or other shells.\n */\nexport function safeQuote(s: string): string {\n  return `'${s.replace(/'/g, \"'\\\\''\")}'`\n}\n"],
-  "mappings": "AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,kBAAkB;AAI3B,SAAS,+BAA+B;AAGxC,SAAS,sBAAsB;AAE/B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AAW1B,SAAS,UAAU,GAAmB;AAC3C,SAAO,IAAI,EAAE,QAAQ,MAAM,OAAO,CAAC;AACrC;",
-  "names": []
-}

package/dist/services/agentTeams/injectionChannel.js

@@ -1,105 +0,0 @@
-class MessageInjectionChannel {
-  queue = [];
-  listeners = [];
-  /** Bounded set of processed message IDs to prevent double delivery */
-  processedIds = /* @__PURE__ */ new Set();
-  static MAX_PROCESSED_IDS = 500;
-  /**
-   * Push a message into the channel.
-   * Fires onMessage callbacks to notify listeners of new messages.
-   * @param displayText Optional original user text for visual queue display
-   * @param messageId Optional unique ID for deduplication (heartbeat + subscription)
-   */
-  push(text, source, displayText, messageId) {
-    if (messageId) {
-      if (this.processedIds.has(messageId)) return;
-      this.processedIds.add(messageId);
-      if (this.processedIds.size > MessageInjectionChannel.MAX_PROCESSED_IDS) {
-        const iter = this.processedIds.values();
-        for (let i = 0; i < 100; i++) iter.next();
-        const toDelete = [];
-        const entries = [...this.processedIds];
-        for (let i = 0; i < 100 && i < entries.length; i++) {
-          toDelete.push(entries[i]);
-        }
-        for (const id of toDelete) this.processedIds.delete(id);
-      }
-    }
-    const msg = {
-      text,
-      source,
-      timestamp: Date.now(),
-      displayText
-    };
-    this.queue.push(msg);
-    for (const cb of this.listeners) {
-      try {
-        cb(msg);
-      } catch {
-      }
-    }
-  }
-  /**
-   * Drain all messages from the channel, clearing the queue.
-   * Returns messages in insertion order.
-   */
-  drain() {
-    if (this.queue.length === 0) return [];
-    const messages = this.queue.splice(0);
-    return messages;
-  }
-  /**
-   * Check if there are pending messages without draining.
-   */
-  hasMessages() {
-    return this.queue.length > 0;
-  }
-  /**
-   * Number of pending messages.
-   */
-  get size() {
-    return this.queue.length;
-  }
-  /**
-   * Register a callback for when new messages are pushed.
-   * Returns an unsubscribe function.
-   */
-  onMessage(cb) {
-    this.listeners.push(cb);
-    return () => {
-      const idx = this.listeners.indexOf(cb);
-      if (idx >= 0) this.listeners.splice(idx, 1);
-    };
-  }
-  /**
-   * Peek at display texts of user-sourced messages without draining.
-   * Used by PromptInput to sync visual queue when switching focused agents.
-   */
-  peekUserDisplayTexts() {
-    return this.queue.filter((m) => m.source === "user" && m.displayText).map((m) => m.displayText);
-  }
-  /**
-   * Remove the last user-sourced message from the queue (for editing support).
-   * Returns the displayText (or raw text) of the removed message, or undefined if none found.
-   */
-  removeLastUserMessage() {
-    for (let i = this.queue.length - 1; i >= 0; i--) {
-      if (this.queue[i].source === "user") {
-        const msg = this.queue.splice(i, 1)[0];
-        return msg.displayText ?? msg.text;
-      }
-    }
-    return void 0;
-  }
-  /**
-   * Remove all pending messages and listeners.
-   */
-  dispose() {
-    this.queue.length = 0;
-    this.listeners.length = 0;
-  }
-}
-export {
-  MessageInjectionChannel
-};
-//# sourceMappingURL=injectionChannel.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/services/agentTeams/injectionChannel.ts"],
-  "sourcesContent": ["/**\n * Message Injection Channel\n *\n * Accumulates messages from multiple sources (team mailbox, user guidance,\n * task notifications) and provides a drain interface for the REPL's query loop.\n *\n * Messages are pushed by:\n * - AgentHeartbeat (team messages from mailbox)\n * - PromptInput (user guidance during active query)\n * - Task notifications (teammate idle/complete events)\n *\n * Messages are consumed by:\n * - REPL.tsx between query turns (drain + inject as user messages)\n * - REPL.tsx after query completion (drain + re-enter if messages found)\n * - REPL.tsx event-driven re-query (triggered by onMessage callback)\n */\n\nexport type InjectionSource = 'team' | 'user' | 'task'\n\nexport interface InjectedMessage {\n  text: string\n  source: InjectionSource\n  timestamp: number\n  /** Original user-facing text before XML formatting (for visual queue display) */\n  displayText?: string\n}\n\ntype MessageCallback = (msg: InjectedMessage) => void\n\nexport class MessageInjectionChannel {\n  private queue: InjectedMessage[] = []\n  private listeners: MessageCallback[] = []\n  /** Bounded set of processed message IDs to prevent double delivery */\n  private processedIds = new Set<string>()\n  private static readonly MAX_PROCESSED_IDS = 500\n\n  /**\n   * Push a message into the channel.\n   * Fires onMessage callbacks to notify listeners of new messages.\n   * @param displayText Optional original user text for visual queue display\n   * @param messageId Optional unique ID for deduplication (heartbeat + subscription)\n   */\n  push(\n    text: string,\n    source: InjectionSource,\n    displayText?: string,\n    messageId?: string,\n  ): void {\n    // Deduplicate by messageId if provided\n    if (messageId) {\n      if (this.processedIds.has(messageId)) return\n      this.processedIds.add(messageId)\n      // Prune oldest entries when set grows too large\n      if (this.processedIds.size > MessageInjectionChannel.MAX_PROCESSED_IDS) {\n        const iter = this.processedIds.values()\n        for (let i = 0; i < 100; i++) iter.next()\n        // Delete first 100 entries\n        const toDelete: string[] = []\n        const entries = [...this.processedIds]\n        for (let i = 0; i < 100 && i < entries.length; i++) {\n          toDelete.push(entries[i]!)\n        }\n        for (const id of toDelete) this.processedIds.delete(id)\n      }\n    }\n\n    const msg: InjectedMessage = {\n      text,\n      source,\n      timestamp: Date.now(),\n      displayText,\n    }\n    this.queue.push(msg)\n\n    // Notify listeners (e.g. REPL idle re-query)\n    for (const cb of this.listeners) {\n      try {\n        cb(msg)\n      } catch {\n        // Don't let listener errors break the channel\n      }\n    }\n  }\n\n  /**\n   * Drain all messages from the channel, clearing the queue.\n   * Returns messages in insertion order.\n   */\n  drain(): InjectedMessage[] {\n    if (this.queue.length === 0) return []\n    const messages = this.queue.splice(0)\n    return messages\n  }\n\n  /**\n   * Check if there are pending messages without draining.\n   */\n  hasMessages(): boolean {\n    return this.queue.length > 0\n  }\n\n  /**\n   * Number of pending messages.\n   */\n  get size(): number {\n    return this.queue.length\n  }\n\n  /**\n   * Register a callback for when new messages are pushed.\n   * Returns an unsubscribe function.\n   */\n  onMessage(cb: MessageCallback): () => void {\n    this.listeners.push(cb)\n    return () => {\n      const idx = this.listeners.indexOf(cb)\n      if (idx >= 0) this.listeners.splice(idx, 1)\n    }\n  }\n\n  /**\n   * Peek at display texts of user-sourced messages without draining.\n   * Used by PromptInput to sync visual queue when switching focused agents.\n   */\n  peekUserDisplayTexts(): string[] {\n    return this.queue\n      .filter(m => m.source === 'user' && m.displayText)\n      .map(m => m.displayText!)\n  }\n\n  /**\n   * Remove the last user-sourced message from the queue (for editing support).\n   * Returns the displayText (or raw text) of the removed message, or undefined if none found.\n   */\n  removeLastUserMessage(): string | undefined {\n    for (let i = this.queue.length - 1; i >= 0; i--) {\n      if (this.queue[i]!.source === 'user') {\n        const msg = this.queue.splice(i, 1)[0]!\n        return msg.displayText ?? msg.text\n      }\n    }\n    return undefined\n  }\n\n  /**\n   * Remove all pending messages and listeners.\n   */\n  dispose(): void {\n    this.queue.length = 0\n    this.listeners.length = 0\n  }\n}\n"],
-  "mappings": "AA6BO,MAAM,wBAAwB;AAAA,EAC3B,QAA2B,CAAC;AAAA,EAC5B,YAA+B,CAAC;AAAA;AAAA,EAEhC,eAAe,oBAAI,IAAY;AAAA,EACvC,OAAwB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ5C,KACE,MACA,QACA,aACA,WACM;AAEN,QAAI,WAAW;AACb,UAAI,KAAK,aAAa,IAAI,SAAS,EAAG;AACtC,WAAK,aAAa,IAAI,SAAS;AAE/B,UAAI,KAAK,aAAa,OAAO,wBAAwB,mBAAmB;AACtE,cAAM,OAAO,KAAK,aAAa,OAAO;AACtC,iBAAS,IAAI,GAAG,IAAI,KAAK,IAAK,MAAK,KAAK;AAExC,cAAM,WAAqB,CAAC;AAC5B,cAAM,UAAU,CAAC,GAAG,KAAK,YAAY;AACrC,iBAAS,IAAI,GAAG,IAAI,OAAO,IAAI,QAAQ,QAAQ,KAAK;AAClD,mBAAS,KAAK,QAAQ,CAAC,CAAE;AAAA,QAC3B;AACA,mBAAW,MAAM,SAAU,MAAK,aAAa,OAAO,EAAE;AAAA,MACxD;AAAA,IACF;AAEA,UAAM,MAAuB;AAAA,MAC3B;AAAA,MACA;AAAA,MACA,WAAW,KAAK,IAAI;AAAA,MACpB;AAAA,IACF;AACA,SAAK,MAAM,KAAK,GAAG;AAGnB,eAAW,MAAM,KAAK,WAAW;AAC/B,UAAI;AACF,WAAG,GAAG;AAAA,MACR,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAA2B;AACzB,QAAI,KAAK,MAAM,WAAW,EAAG,QAAO,CAAC;AACrC,UAAM,WAAW,KAAK,MAAM,OAAO,CAAC;AACpC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,cAAuB;AACrB,WAAO,KAAK,MAAM,SAAS;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,OAAe;AACjB,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAU,IAAiC;AACzC,SAAK,UAAU,KAAK,EAAE;AACtB,WAAO,MAAM;AACX,YAAM,MAAM,KAAK,UAAU,QAAQ,EAAE;AACrC,UAAI,OAAO,EAAG,MAAK,UAAU,OAAO,KAAK,CAAC;AAAA,IAC5C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,uBAAiC;AAC/B,WAAO,KAAK,MACT,OAAO,OAAK,EAAE,WAAW,UAAU,EAAE,WAAW,EAChD,IAAI,OAAK,EAAE,WAAY;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,wBAA4C;AAC1C,aAAS,IAAI,KAAK,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK;AAC/C,UAAI,KAAK,MAAM,CAAC,EAAG,WAAW,QAAQ;AACpC,cAAM,MAAM,KAAK,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC;AACrC,eAAO,IAAI,eAAe,IAAI;AAAA,MAChC;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,SAAK,MAAM,SAAS;AACpB,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;",
-  "names": []
-}

package/dist/services/agentTeams/mailbox.js

@@ -1,494 +0,0 @@
-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 = [];
-  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.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, text, options) {
-    const msg = {
-      id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
-      from,
-      to,
-      text,
-      ...options?.summary && { summary: options.summary },
-      ...options?.color && { color: options.color },
-      timestamp: Date.now(),
-      type: to === "all" ? "broadcast" : "direct"
-    };
-    this.messages.push(msg);
-    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 {
-        listener(msg);
-      } catch {
-      }
-    }
-    this.prune();
-    return msg;
-  }
-  /**
-   * 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
-    );
-  }
-  /**
-   * Mark messages as read
-   */
-  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);
-        }
-      }
-    }
-    if (this.initialized) {
-      for (const recipientId of affectedRecipients) {
-        this.persistInbox(recipientId);
-      }
-    }
-    this.prune();
-  }
-  /**
-   * Subscribe to messages for a teammate
-   */
-  subscribe(recipientId, callback) {
-    const existing = this.listeners.get(recipientId) || [];
-    existing.push(callback);
-    this.listeners.set(recipientId, existing);
-    return () => {
-      const list = this.listeners.get(recipientId);
-      if (list) {
-        const idx = list.indexOf(callback);
-        if (idx >= 0) list.splice(idx, 1);
-      }
-    };
-  }
-  /**
-   * Get all messages (for debugging/display)
-   */
-  getAll() {
-    return [...this.messages];
-  }
-  /**
-   * Get all messages involving a specific agent (sent or received)
-   */
-  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 {
-      if (!existsSync(this.inboxesDir)) {
-        mkdirSync(this.inboxesDir, { recursive: true, mode: 448 });
-      }
-    } catch {
-    }
-  }
-  /**
-   * Get the file path for an agent's inbox.
-   * Uses the agent name portion before '@' for readability.
-   */
-  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 { 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
-};
-//# sourceMappingURL=mailbox.js.map