@within-7/minto 0.4.2 → 0.4.3

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/services/agentTeams/mailbox.ts"],
-  "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

@@ -1,80 +0,0 @@
-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

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/services/agentTeams/messageFormatter.ts"],
-  "sourcesContent": ["/**\n * Agent Teams Message Formatter\n *\n * Shared XML formatting helpers for consistent message injection\n * across REPL, TaskTool, headless agents, and heartbeat.\n *\n * All injection points use the CC-compatible `<team-message>` tag format.\n */\n\nimport type { TeamMessage } from '../../types/agentTeams'\n\n/**\n * Sanitize team message text to prevent injection attacks.\n * Replaces XML tags that could break message envelopes or forge system instructions.\n */\nexport function sanitizeTeamMessageText(text: string): string {\n  return (\n    text\n      // Prevent envelope breakout\n      .replace(/<\\/team-message>/gi, '[team-message-close]')\n      // Prevent system instruction forgery\n      .replace(/<system-reminder>/gi, '[system-reminder-open]')\n      .replace(/<\\/system-reminder>/gi, '[system-reminder-close]')\n      // Prevent API protocol injection\n      .replace(/<tool_use>/gi, '[tool-use-open]')\n      .replace(/<\\/tool_use>/gi, '[tool-use-close]')\n      .replace(/<tool_result>/gi, '[tool-result-open]')\n      .replace(/<\\/tool_result>/gi, '[tool-result-close]')\n      // Prevent opening tag injection (with potential attributes)\n      .replace(/<team-message\\b/gi, '[team-message-open')\n      // Prevent user guidance injection\n      .replace(/<user-guidance>/gi, '[user-guidance-open]')\n      .replace(/<\\/user-guidance>/gi, '[user-guidance-close]')\n      // Prevent task notification injection\n      .replace(/<task-notification>/gi, '[task-notification-open]')\n      .replace(/<\\/task-notification>/gi, '[task-notification-close]')\n      // Prevent skill injection\n      .replace(/<preloaded-skill>/gi, '[preloaded-skill-open]')\n      .replace(/<\\/preloaded-skill>/gi, '[preloaded-skill-close]')\n  )\n}\n\n/**\n * Data extracted from idle notification JSON messages\n */\nexport interface IdleNotificationData {\n  agentName: string\n  status: 'idle' | 'completed' | 'failed'\n  taskId?: string\n  message?: string\n  summary?: string\n}\n\n/**\n * Format a single team message as CC-compatible XML.\n *\n * Output:\n * ```xml\n * <team-message from=\"researcher\" color=\"cyan\" summary=\"Found 5 files\">\n * {message text}\n * </team-message>\n * ```\n */\nexport function formatTeamMessage(msg: TeamMessage): string {\n  const senderName = msg.from.split('@')[0] || msg.from\n  const summaryText = msg.summary || msg.text.slice(0, 60).replace(/\"/g, \"'\")\n  const colorAttr = msg.color ? ` color=\"${msg.color}\"` : ''\n  const sanitizedText = sanitizeTeamMessageText(msg.text)\n  return `<team-message from=\"${senderName}\"${colorAttr} summary=\"${summaryText}\">\\n${sanitizedText}\\n</team-message>`\n}\n\n/**\n * Format multiple team messages for injection into a conversation turn.\n * Returns a single string with all messages separated by double newlines.\n */\nexport function formatTeamMessagesForInjection(\n  messages: TeamMessage[],\n): string {\n  return messages.map(formatTeamMessage).join('\\n\\n')\n}\n\n/**\n * Format user guidance for injection when user types during a running query.\n *\n * Output:\n * ```xml\n * <user-guidance>\n * {user's input text}\n * </user-guidance>\n * ```\n */\nexport function formatUserGuidanceForInjection(input: string): string {\n  const sanitizedInput = sanitizeTeamMessageText(input)\n  return `<user-guidance>\\n${sanitizedInput}\\n</user-guidance>`\n}\n\n/**\n * Format an idle/task notification for injection.\n *\n * Output:\n * ```xml\n * <task-notification>\n *   <task-id>{taskId}</task-id>\n *   <status>{status}</status>\n *   <message>{message}</message>\n * </task-notification>\n * ```\n */\nexport function formatIdleNotificationForInjection(\n  notification: IdleNotificationData,\n): string {\n  const parts = ['<task-notification>']\n  if (notification.taskId) {\n    parts.push(`  <task-id>${notification.taskId}</task-id>`)\n  }\n  parts.push(`  <status>${notification.status}</status>`)\n  parts.push(\n    `  <message>${notification.message || `Teammate \"${notification.agentName}\" is now ${notification.status}.`}</message>`,\n  )\n  if (notification.summary) {\n    parts.push(`  <summary>${notification.summary}</summary>`)\n  }\n  parts.push('</task-notification>')\n  return parts.join('\\n')\n}\n\n/**\n * Try to parse a message as an idle notification JSON.\n * Returns parsed data if successful, null otherwise.\n */\n/**\n * Protocol message type \u2192 human-friendly summary mapping.\n */\nconst PROTOCOL_SUMMARIES: Record<string, string> = {\n  shutdown_approved: 'Shutdown approved',\n  shutdown_rejected: 'Shutdown rejected',\n  shutdown_request: 'Shutdown requested',\n  plan_approved: 'Plan approved',\n  plan_rejected: 'Plan rejected',\n  plan_approval_request: 'Plan review requested',\n}\n\n/**\n * Try to convert a protocol JSON message to a human-friendly summary.\n * Returns the friendly string, or null if not a protocol message.\n */\nexport function humanizeProtocolMessage(text: string): string | null {\n  try {\n    const parsed = JSON.parse(text)\n    if (\n      parsed &&\n      typeof parsed === 'object' &&\n      parsed.type in PROTOCOL_SUMMARIES\n    ) {\n      return PROTOCOL_SUMMARIES[parsed.type] || parsed.type\n    }\n  } catch {\n    /* not JSON */\n  }\n  return null\n}\n\nexport function parseIdleNotification(\n  text: string,\n): IdleNotificationData | null {\n  try {\n    const parsed = JSON.parse(text)\n    if (\n      parsed &&\n      typeof parsed === 'object' &&\n      (parsed.type === 'idle_notification' ||\n        parsed.type === 'task_completed' ||\n        parsed.type === 'idle')\n    ) {\n      return {\n        agentName: parsed.agentName || parsed.from || 'unknown',\n        status: parsed.status || parsed.completedStatus || 'idle',\n        taskId: parsed.taskId,\n        message: parsed.message,\n        summary: parsed.summary,\n      }\n    }\n  } catch {\n    // Not JSON \u2014 regular text message\n  }\n  return null\n}\n"],
-  "mappings": "AAeO,SAAS,wBAAwB,MAAsB;AAC5D,SACE,KAEG,QAAQ,sBAAsB,sBAAsB,EAEpD,QAAQ,uBAAuB,wBAAwB,EACvD,QAAQ,yBAAyB,yBAAyB,EAE1D,QAAQ,gBAAgB,iBAAiB,EACzC,QAAQ,kBAAkB,kBAAkB,EAC5C,QAAQ,mBAAmB,oBAAoB,EAC/C,QAAQ,qBAAqB,qBAAqB,EAElD,QAAQ,qBAAqB,oBAAoB,EAEjD,QAAQ,qBAAqB,sBAAsB,EACnD,QAAQ,uBAAuB,uBAAuB,EAEtD,QAAQ,yBAAyB,0BAA0B,EAC3D,QAAQ,2BAA2B,2BAA2B,EAE9D,QAAQ,uBAAuB,wBAAwB,EACvD,QAAQ,yBAAyB,yBAAyB;AAEjE;AAuBO,SAAS,kBAAkB,KAA0B;AAC1D,QAAM,aAAa,IAAI,KAAK,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI;AACjD,QAAM,cAAc,IAAI,WAAW,IAAI,KAAK,MAAM,GAAG,EAAE,EAAE,QAAQ,MAAM,GAAG;AAC1E,QAAM,YAAY,IAAI,QAAQ,WAAW,IAAI,KAAK,MAAM;AACxD,QAAM,gBAAgB,wBAAwB,IAAI,IAAI;AACtD,SAAO,uBAAuB,UAAU,IAAI,SAAS,aAAa,WAAW;AAAA,EAAO,aAAa;AAAA;AACnG;AAMO,SAAS,+BACd,UACQ;AACR,SAAO,SAAS,IAAI,iBAAiB,EAAE,KAAK,MAAM;AACpD;AAYO,SAAS,+BAA+B,OAAuB;AACpE,QAAM,iBAAiB,wBAAwB,KAAK;AACpD,SAAO;AAAA,EAAoB,cAAc;AAAA;AAC3C;AAcO,SAAS,mCACd,cACQ;AACR,QAAM,QAAQ,CAAC,qBAAqB;AACpC,MAAI,aAAa,QAAQ;AACvB,UAAM,KAAK,cAAc,aAAa,MAAM,YAAY;AAAA,EAC1D;AACA,QAAM,KAAK,aAAa,aAAa,MAAM,WAAW;AACtD,QAAM;AAAA,IACJ,cAAc,aAAa,WAAW,aAAa,aAAa,SAAS,YAAY,aAAa,MAAM,GAAG;AAAA,EAC7G;AACA,MAAI,aAAa,SAAS;AACxB,UAAM,KAAK,cAAc,aAAa,OAAO,YAAY;AAAA,EAC3D;AACA,QAAM,KAAK,sBAAsB;AACjC,SAAO,MAAM,KAAK,IAAI;AACxB;AASA,MAAM,qBAA6C;AAAA,EACjD,mBAAmB;AAAA,EACnB,mBAAmB;AAAA,EACnB,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,eAAe;AAAA,EACf,uBAAuB;AACzB;AAMO,SAAS,wBAAwB,MAA6B;AACnE,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QACE,UACA,OAAO,WAAW,YAClB,OAAO,QAAQ,oBACf;AACA,aAAO,mBAAmB,OAAO,IAAI,KAAK,OAAO;AAAA,IACnD;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAEO,SAAS,sBACd,MAC6B;AAC7B,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QACE,UACA,OAAO,WAAW,aACjB,OAAO,SAAS,uBACf,OAAO,SAAS,oBAChB,OAAO,SAAS,SAClB;AACA,aAAO;AAAA,QACL,WAAW,OAAO,aAAa,OAAO,QAAQ;AAAA,QAC9C,QAAQ,OAAO,UAAU,OAAO,mBAAmB;AAAA,QACnD,QAAQ,OAAO;AAAA,QACf,SAAS,OAAO;AAAA,QAChB,SAAS,OAAO;AAAA,MAClB;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;",
-  "names": []
-}

package/dist/services/agentTeams/permissionDelegation.js

@@ -1,71 +0,0 @@
-async function delegatePermissionToLead(options) {
-  const {
-    teamName,
-    agentId,
-    toolName,
-    toolUseId,
-    input,
-    description,
-    permissionSuggestions
-  } = options;
-  let mailbox;
-  try {
-    const { getTeam } = require("./teamManager");
-    const entry = getTeam(teamName);
-    if (!entry?.mailbox) {
-      return { approved: false, error: "Team not found or mailbox unavailable" };
-    }
-    mailbox = entry.mailbox;
-  } catch {
-    return { approved: false, error: "Failed to access team mailbox" };
-  }
-  const requestId = `perm-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-  const leadId = `team-lead@${teamName}`;
-  const request = JSON.stringify({
-    type: "permission_request",
-    request_id: requestId,
-    agent_id: agentId,
-    tool_name: toolName,
-    tool_use_id: toolUseId,
-    description,
-    input,
-    permission_suggestions: permissionSuggestions ?? [],
-    timestamp: (/* @__PURE__ */ new Date()).toISOString()
-  });
-  mailbox.send(agentId, leadId, request, {
-    summary: `Permission request: ${toolName}`
-  });
-  const POLL_INTERVAL = 500;
-  const TIMEOUT = 12e4;
-  const startTime = Date.now();
-  while (Date.now() - startTime < TIMEOUT) {
-    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL));
-    const messages = mailbox.getUnread(agentId);
-    for (const msg of messages) {
-      try {
-        const parsed = JSON.parse(msg.text);
-        if (parsed.type === "permission_response" && parsed.request_id === requestId) {
-          mailbox.markRead([msg.id]);
-          if (parsed.subtype === "success" || parsed.approved) {
-            return {
-              approved: true,
-              updatedInput: parsed.response?.updated_input ?? void 0,
-              permissionUpdates: parsed.response?.permission_updates ?? void 0
-            };
-          } else {
-            return {
-              approved: false,
-              error: parsed.error || "Permission denied by team lead"
-            };
-          }
-        }
-      } catch {
-      }
-    }
-  }
-  return { approved: false, error: "Permission request timed out (120s)" };
-}
-export {
-  delegatePermissionToLead
-};
-//# sourceMappingURL=permissionDelegation.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/services/agentTeams/permissionDelegation.ts"],
-  "sourcesContent": ["/**\n * Permission Delegation for Agent Teams\n *\n * Allows headless teammates to delegate permission decisions to the team lead\n * via the mailbox, instead of auto-denying tool usage.\n *\n * Flow:\n * 1. Teammate calls a tool that requires user permission\n * 2. Instead of auto-denying, teammate sends `permission_request` to leader's inbox\n * 3. Leader reviews and sends `permission_response` back via SendMessage\n * 4. Teammate blocks (polling) until response arrives, then proceeds or fails\n */\n\nimport type { Mailbox } from './mailbox'\n\nexport interface PermissionDelegationResult {\n  approved: boolean\n  updatedInput?: Record<string, unknown>\n  permissionUpdates?: Record<string, unknown>\n  error?: string\n}\n\n/**\n * Delegate a permission decision to the team lead via mailbox.\n * Sends a permission_request and polls for permission_response.\n *\n * @returns Result with approved status and optional updates from the leader\n */\nexport async function delegatePermissionToLead(options: {\n  teamName: string\n  agentId: string\n  toolName: string\n  toolUseId: string\n  input: Record<string, unknown>\n  description: string\n  permissionSuggestions?: string[]\n}): Promise<PermissionDelegationResult> {\n  const {\n    teamName,\n    agentId,\n    toolName,\n    toolUseId,\n    input,\n    description,\n    permissionSuggestions,\n  } = options\n\n  // Get the team's mailbox\n  let mailbox: Mailbox\n  try {\n    // Lazy require to avoid circular dependencies at module load time\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { getTeam } =\n      require('./teamManager') as typeof import('./teamManager')\n    const entry = getTeam(teamName)\n    if (!entry?.mailbox) {\n      return { approved: false, error: 'Team not found or mailbox unavailable' }\n    }\n    mailbox = entry.mailbox\n  } catch {\n    return { approved: false, error: 'Failed to access team mailbox' }\n  }\n\n  const requestId = `perm-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n  const leadId = `team-lead@${teamName}`\n\n  // Send permission_request to the team leader\n  const request = JSON.stringify({\n    type: 'permission_request',\n    request_id: requestId,\n    agent_id: agentId,\n    tool_name: toolName,\n    tool_use_id: toolUseId,\n    description,\n    input,\n    permission_suggestions: permissionSuggestions ?? [],\n    timestamp: new Date().toISOString(),\n  })\n\n  mailbox.send(agentId, leadId, request, {\n    summary: `Permission request: ${toolName}`,\n  })\n\n  // Poll for response with timeout\n  const POLL_INTERVAL = 500 // ms\n  const TIMEOUT = 120_000 // 2 minutes\n  const startTime = Date.now()\n\n  while (Date.now() - startTime < TIMEOUT) {\n    await new Promise(resolve => setTimeout(resolve, POLL_INTERVAL))\n\n    const messages = mailbox.getUnread(agentId)\n    for (const msg of messages) {\n      try {\n        const parsed = JSON.parse(msg.text)\n        if (\n          parsed.type === 'permission_response' &&\n          parsed.request_id === requestId\n        ) {\n          mailbox.markRead([msg.id])\n          if (parsed.subtype === 'success' || parsed.approved) {\n            return {\n              approved: true,\n              updatedInput: parsed.response?.updated_input ?? undefined,\n              permissionUpdates:\n                parsed.response?.permission_updates ?? undefined,\n            }\n          } else {\n            return {\n              approved: false,\n              error: parsed.error || 'Permission denied by team lead',\n            }\n          }\n        }\n      } catch {\n        // Not a JSON message or not our response \u2014 skip\n      }\n    }\n  }\n\n  return { approved: false, error: 'Permission request timed out (120s)' }\n}\n"],
-  "mappings": "AA4BA,eAAsB,yBAAyB,SAQP;AACtC,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAGJ,MAAI;AACJ,MAAI;AAGF,UAAM,EAAE,QAAQ,IACd,QAAQ,eAAe;AACzB,UAAM,QAAQ,QAAQ,QAAQ;AAC9B,QAAI,CAAC,OAAO,SAAS;AACnB,aAAO,EAAE,UAAU,OAAO,OAAO,wCAAwC;AAAA,IAC3E;AACA,cAAU,MAAM;AAAA,EAClB,QAAQ;AACN,WAAO,EAAE,UAAU,OAAO,OAAO,gCAAgC;AAAA,EACnE;AAEA,QAAM,YAAY,QAAQ,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAC9E,QAAM,SAAS,aAAa,QAAQ;AAGpC,QAAM,UAAU,KAAK,UAAU;AAAA,IAC7B,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,WAAW;AAAA,IACX,aAAa;AAAA,IACb;AAAA,IACA;AAAA,IACA,wBAAwB,yBAAyB,CAAC;AAAA,IAClD,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC,CAAC;AAED,UAAQ,KAAK,SAAS,QAAQ,SAAS;AAAA,IACrC,SAAS,uBAAuB,QAAQ;AAAA,EAC1C,CAAC;AAGD,QAAM,gBAAgB;AACtB,QAAM,UAAU;AAChB,QAAM,YAAY,KAAK,IAAI;AAE3B,SAAO,KAAK,IAAI,IAAI,YAAY,SAAS;AACvC,UAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,aAAa,CAAC;AAE/D,UAAM,WAAW,QAAQ,UAAU,OAAO;AAC1C,eAAW,OAAO,UAAU;AAC1B,UAAI;AACF,cAAM,SAAS,KAAK,MAAM,IAAI,IAAI;AAClC,YACE,OAAO,SAAS,yBAChB,OAAO,eAAe,WACtB;AACA,kBAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;AACzB,cAAI,OAAO,YAAY,aAAa,OAAO,UAAU;AACnD,mBAAO;AAAA,cACL,UAAU;AAAA,cACV,cAAc,OAAO,UAAU,iBAAiB;AAAA,cAChD,mBACE,OAAO,UAAU,sBAAsB;AAAA,YAC3C;AAAA,UACF,OAAO;AACL,mBAAO;AAAA,cACL,UAAU;AAAA,cACV,OAAO,OAAO,SAAS;AAAA,YACzB;AAAA,UACF;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,UAAU,OAAO,OAAO,sCAAsC;AACzE;",
-  "names": []
-}

package/dist/services/agentTeams/teamEvents.js

@@ -1,45 +0,0 @@
-import { EventEmitter } from "events";
-class TeamEventEmitter extends EventEmitter {
-  static instance = null;
-  constructor() {
-    super();
-    this.setMaxListeners(20);
-  }
-  static getInstance() {
-    if (!TeamEventEmitter.instance) {
-      TeamEventEmitter.instance = new TeamEventEmitter();
-    }
-    return TeamEventEmitter.instance;
-  }
-  /**
-   * Emit member status change event
-   */
-  emitMemberStatusChange(data) {
-    this.emit("member:status", data);
-  }
-  /**
-   * Emit team lifecycle change event
-   */
-  emitTeamChange(data) {
-    this.emit("team:change", data);
-  }
-  /**
-   * Subscribe to member status changes
-   */
-  onMemberStatusChange(callback) {
-    this.on("member:status", callback);
-    return () => this.off("member:status", callback);
-  }
-  /**
-   * Subscribe to team lifecycle changes
-   */
-  onTeamChange(callback) {
-    this.on("team:change", callback);
-    return () => this.off("team:change", callback);
-  }
-}
-const teamEvents = TeamEventEmitter.getInstance();
-export {
-  teamEvents
-};
-//# sourceMappingURL=teamEvents.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/services/agentTeams/teamEvents.ts"],
-  "sourcesContent": ["/**\n * Team Events\n *\n * Singleton EventEmitter for team lifecycle and member status changes.\n * Follows the same pattern as BackgroundAgentEventEmitter.\n *\n * Enables event-driven UI updates instead of polling.\n */\n\nimport { EventEmitter } from 'events'\nimport type { TeammateStatus } from '@minto-types/agentTeams'\n\nexport interface MemberStatusChangeData {\n  teamName: string\n  memberId: string\n  memberName: string\n  status: TeammateStatus\n  previousStatus: TeammateStatus\n  currentTaskId?: string\n}\n\nexport interface TeamChangeData {\n  teamName: string\n  event: 'created' | 'disbanded' | 'member_added'\n}\n\nclass TeamEventEmitter extends EventEmitter {\n  private static instance: TeamEventEmitter | null = null\n\n  private constructor() {\n    super()\n    this.setMaxListeners(20)\n  }\n\n  static getInstance(): TeamEventEmitter {\n    if (!TeamEventEmitter.instance) {\n      TeamEventEmitter.instance = new TeamEventEmitter()\n    }\n    return TeamEventEmitter.instance\n  }\n\n  /**\n   * Emit member status change event\n   */\n  emitMemberStatusChange(data: MemberStatusChangeData): void {\n    this.emit('member:status', data)\n  }\n\n  /**\n   * Emit team lifecycle change event\n   */\n  emitTeamChange(data: TeamChangeData): void {\n    this.emit('team:change', data)\n  }\n\n  /**\n   * Subscribe to member status changes\n   */\n  onMemberStatusChange(\n    callback: (data: MemberStatusChangeData) => void,\n  ): () => void {\n    this.on('member:status', callback)\n    return () => this.off('member:status', callback)\n  }\n\n  /**\n   * Subscribe to team lifecycle changes\n   */\n  onTeamChange(callback: (data: TeamChangeData) => void): () => void {\n    this.on('team:change', callback)\n    return () => this.off('team:change', callback)\n  }\n}\n\nexport const teamEvents = TeamEventEmitter.getInstance()\n"],
-  "mappings": "AASA,SAAS,oBAAoB;AAiB7B,MAAM,yBAAyB,aAAa;AAAA,EAC1C,OAAe,WAAoC;AAAA,EAE3C,cAAc;AACpB,UAAM;AACN,SAAK,gBAAgB,EAAE;AAAA,EACzB;AAAA,EAEA,OAAO,cAAgC;AACrC,QAAI,CAAC,iBAAiB,UAAU;AAC9B,uBAAiB,WAAW,IAAI,iBAAiB;AAAA,IACnD;AACA,WAAO,iBAAiB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,uBAAuB,MAAoC;AACzD,SAAK,KAAK,iBAAiB,IAAI;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,MAA4B;AACzC,SAAK,KAAK,eAAe,IAAI;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKA,qBACE,UACY;AACZ,SAAK,GAAG,iBAAiB,QAAQ;AACjC,WAAO,MAAM,KAAK,IAAI,iBAAiB,QAAQ;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,UAAsD;AACjE,SAAK,GAAG,eAAe,QAAQ;AAC/B,WAAO,MAAM,KAAK,IAAI,eAAe,QAAQ;AAAA,EAC/C;AACF;AAEO,MAAM,aAAa,iBAAiB,YAAY;",
-  "names": []
-}