@affectively/aeon 1.0.0 → 1.1.0

package/dist/presence/index.d.ts

@@ -0,0 +1,168 @@
+import { EventEmitter } from 'eventemitter3';
+
+/**
+ * Agent Presence Manager (Phase 14)
+ *
+ * Tracks real-time presence of all agents in a session.
+ * Provides status updates, cursor tracking, and activity monitoring.
+ */
+
+interface AgentPresence {
+    agentId: string;
+    name: string;
+    role: 'user' | 'assistant' | 'monitor' | 'admin';
+    status: 'online' | 'away' | 'offline' | 'reconnecting';
+    joinedAt: string;
+    lastSeen: string;
+    cursorPosition?: {
+        x: number;
+        y: number;
+        path: string;
+    };
+    activeSection?: string;
+    metadata?: Record<string, unknown>;
+}
+interface PresenceUpdate {
+    agentId: string;
+    changes: Partial<AgentPresence>;
+    timestamp: string;
+}
+interface PresenceEvents {
+    presence_updated: (data: {
+        agentId: string;
+        presence: AgentPresence;
+    }) => void;
+    agent_joined: (data: {
+        agentId: string;
+        presence: AgentPresence;
+    }) => void;
+    agent_left: (data: {
+        agentId: string;
+        presence: AgentPresence;
+    }) => void;
+    cursor_updated: (data: {
+        agentId: string;
+        cursorPosition: {
+            x: number;
+            y: number;
+            path: string;
+        };
+    }) => void;
+    section_updated: (data: {
+        agentId: string;
+        activeSection: string;
+    }) => void;
+    status_updated: (data: {
+        agentId: string;
+        status: AgentPresence['status'];
+    }) => void;
+}
+declare class AgentPresenceManager extends EventEmitter<PresenceEvents> {
+    private presences;
+    private sessionId;
+    private heartbeatInterval;
+    private heartbeatTimeout;
+    private inactivityThreshold;
+    constructor(sessionId: string);
+    /**
+     * Add or update agent presence
+     */
+    updatePresence(agentId: string, presence: Omit<AgentPresence, 'joinedAt' | 'lastSeen'>): void;
+    /**
+     * Agent joined
+     */
+    agentJoined(agentId: string, name: string, role?: AgentPresence['role'], metadata?: Record<string, unknown>): void;
+    /**
+     * Agent left
+     */
+    agentLeft(agentId: string): void;
+    /**
+     * Update cursor position
+     */
+    updateCursor(agentId: string, x: number, y: number, path: string): void;
+    /**
+     * Update active section
+     */
+    updateActiveSection(agentId: string, section: string): void;
+    /**
+     * Update status
+     */
+    updateStatus(agentId: string, status: AgentPresence['status']): void;
+    /**
+     * Heartbeat from agent (keeps them online)
+     */
+    heartbeat(agentId: string): void;
+    /**
+     * Get presence for agent
+     */
+    getPresence(agentId: string): AgentPresence | undefined;
+    /**
+     * Get all online agents
+     */
+    getOnlineAgents(): AgentPresence[];
+    /**
+     * Get all agents
+     */
+    getAllAgents(): AgentPresence[];
+    /**
+     * Get all presences
+     */
+    getAllPresences(): AgentPresence[];
+    /**
+     * Get agent count
+     */
+    getAgentCount(): Record<AgentPresence['status'], number>;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        totalAgents: number;
+        onlineAgents: number;
+        offlineAgents: number;
+        awayAgents: number;
+        reconnectingAgents: number;
+    };
+    /**
+     * Clear expired presences
+     */
+    clearExpiredPresences(maxAgeMs: number): void;
+    /**
+     * Get agents by role
+     */
+    getByRole(role: AgentPresence['role']): AgentPresence[];
+    /**
+     * Get agents in active section
+     */
+    getInSection(section: string): AgentPresence[];
+    /**
+     * Get presence timeline
+     */
+    getPresenceStats(): {
+        total: number;
+        online: number;
+        away: number;
+        offline: number;
+        reconnecting: number;
+        byRole: Record<string, number>;
+    };
+    /**
+     * Start heartbeat check (mark inactive agents as away)
+     */
+    private startHeartbeatCheck;
+    /**
+     * Stop heartbeat monitoring
+     */
+    stopHeartbeatMonitoring(): void;
+    /**
+     * Clear all presences
+     */
+    clear(): void;
+    /**
+     * Destroy the manager
+     */
+    destroy(): void;
+}
+declare function getAgentPresenceManager(sessionId: string): AgentPresenceManager;
+declare function clearAgentPresenceManager(sessionId: string): void;
+
+export { type AgentPresence, AgentPresenceManager, type PresenceEvents, type PresenceUpdate, clearAgentPresenceManager, getAgentPresenceManager };

package/dist/presence/index.js

@@ -0,0 +1,334 @@
+import { EventEmitter } from 'eventemitter3';
+
+// src/presence/AgentPresenceManager.ts
+
+// src/utils/logger.ts
+var consoleLogger = {
+  debug: (...args) => {
+    console.debug("[AEON:DEBUG]", ...args);
+  },
+  info: (...args) => {
+    console.info("[AEON:INFO]", ...args);
+  },
+  warn: (...args) => {
+    console.warn("[AEON:WARN]", ...args);
+  },
+  error: (...args) => {
+    console.error("[AEON:ERROR]", ...args);
+  }
+};
+var currentLogger = consoleLogger;
+function getLogger() {
+  return currentLogger;
+}
+
+// src/presence/AgentPresenceManager.ts
+var logger = getLogger();
+var AgentPresenceManager = class extends EventEmitter {
+  presences = /* @__PURE__ */ new Map();
+  sessionId;
+  heartbeatInterval = null;
+  heartbeatTimeout = 3e4;
+  inactivityThreshold = 6e4;
+  constructor(sessionId) {
+    super();
+    this.sessionId = sessionId;
+    this.startHeartbeatCheck();
+    logger.debug("[AgentPresenceManager] Initialized", { sessionId });
+  }
+  /**
+   * Add or update agent presence
+   */
+  updatePresence(agentId, presence) {
+    const existing = this.presences.get(agentId);
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const updated = {
+      ...existing,
+      ...presence,
+      agentId,
+      joinedAt: existing?.joinedAt ?? now,
+      lastSeen: now
+    };
+    this.presences.set(agentId, updated);
+    this.emit("presence_updated", {
+      agentId,
+      presence: updated
+    });
+  }
+  /**
+   * Agent joined
+   */
+  agentJoined(agentId, name, role = "user", metadata) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const presence = {
+      agentId,
+      name,
+      role,
+      status: "online",
+      joinedAt: now,
+      lastSeen: now,
+      metadata
+    };
+    this.presences.set(agentId, presence);
+    this.emit("agent_joined", { agentId, presence });
+    logger.debug("[AgentPresenceManager] Agent joined", {
+      agentId,
+      name,
+      role
+    });
+  }
+  /**
+   * Agent left
+   */
+  agentLeft(agentId) {
+    const presence = this.presences.get(agentId);
+    if (presence) {
+      presence.status = "offline";
+      presence.lastSeen = (/* @__PURE__ */ new Date()).toISOString();
+      this.presences.set(agentId, presence);
+      this.emit("agent_left", { agentId, presence });
+      logger.debug("[AgentPresenceManager] Agent left", { agentId });
+    }
+  }
+  /**
+   * Update cursor position
+   */
+  updateCursor(agentId, x, y, path) {
+    const presence = this.presences.get(agentId);
+    if (presence) {
+      presence.cursorPosition = { x, y, path };
+      presence.lastSeen = (/* @__PURE__ */ new Date()).toISOString();
+      this.presences.set(agentId, presence);
+      this.emit("cursor_updated", {
+        agentId,
+        cursorPosition: presence.cursorPosition
+      });
+    }
+  }
+  /**
+   * Update active section
+   */
+  updateActiveSection(agentId, section) {
+    const presence = this.presences.get(agentId);
+    if (presence) {
+      presence.activeSection = section;
+      presence.lastSeen = (/* @__PURE__ */ new Date()).toISOString();
+      this.presences.set(agentId, presence);
+      this.emit("section_updated", {
+        agentId,
+        activeSection: section
+      });
+    }
+  }
+  /**
+   * Update status
+   */
+  updateStatus(agentId, status) {
+    const presence = this.presences.get(agentId);
+    if (presence) {
+      presence.status = status;
+      presence.lastSeen = (/* @__PURE__ */ new Date()).toISOString();
+      this.presences.set(agentId, presence);
+      this.emit("status_updated", { agentId, status });
+    }
+  }
+  /**
+   * Heartbeat from agent (keeps them online)
+   */
+  heartbeat(agentId) {
+    const presence = this.presences.get(agentId);
+    if (presence) {
+      if (presence.status === "reconnecting") {
+        presence.status = "online";
+        this.emit("status_updated", { agentId, status: "online" });
+      }
+      presence.lastSeen = (/* @__PURE__ */ new Date()).toISOString();
+      this.presences.set(agentId, presence);
+    }
+  }
+  /**
+   * Get presence for agent
+   */
+  getPresence(agentId) {
+    return this.presences.get(agentId);
+  }
+  /**
+   * Get all online agents
+   */
+  getOnlineAgents() {
+    return Array.from(this.presences.values()).filter(
+      (p) => p.status === "online"
+    );
+  }
+  /**
+   * Get all agents
+   */
+  getAllAgents() {
+    return Array.from(this.presences.values());
+  }
+  /**
+   * Get all presences
+   */
+  getAllPresences() {
+    return Array.from(this.presences.values());
+  }
+  /**
+   * Get agent count
+   */
+  getAgentCount() {
+    const counts = {
+      online: 0,
+      away: 0,
+      offline: 0,
+      reconnecting: 0
+    };
+    this.presences.forEach((p) => {
+      counts[p.status]++;
+    });
+    return counts;
+  }
+  /**
+   * Get statistics
+   */
+  getStats() {
+    return {
+      totalAgents: this.presences.size,
+      onlineAgents: Array.from(this.presences.values()).filter(
+        (p) => p.status === "online"
+      ).length,
+      offlineAgents: Array.from(this.presences.values()).filter(
+        (p) => p.status === "offline"
+      ).length,
+      awayAgents: Array.from(this.presences.values()).filter(
+        (p) => p.status === "away"
+      ).length,
+      reconnectingAgents: Array.from(this.presences.values()).filter(
+        (p) => p.status === "reconnecting"
+      ).length
+    };
+  }
+  /**
+   * Clear expired presences
+   */
+  clearExpiredPresences(maxAgeMs) {
+    const now = Date.now();
+    const toRemove = [];
+    this.presences.forEach((presence, agentId) => {
+      const lastSeenTime = new Date(presence.lastSeen).getTime();
+      const ageMs = now - lastSeenTime;
+      if (ageMs > maxAgeMs && presence.status === "offline") {
+        toRemove.push(agentId);
+      }
+    });
+    toRemove.forEach((agentId) => {
+      this.presences.delete(agentId);
+    });
+    if (toRemove.length > 0) {
+      logger.debug("[AgentPresenceManager] Cleared expired presences", {
+        count: toRemove.length
+      });
+    }
+  }
+  /**
+   * Get agents by role
+   */
+  getByRole(role) {
+    return Array.from(this.presences.values()).filter((p) => p.role === role);
+  }
+  /**
+   * Get agents in active section
+   */
+  getInSection(section) {
+    return Array.from(this.presences.values()).filter(
+      (p) => p.activeSection === section && p.status === "online"
+    );
+  }
+  /**
+   * Get presence timeline
+   */
+  getPresenceStats() {
+    const stats = {
+      total: this.presences.size,
+      online: 0,
+      away: 0,
+      offline: 0,
+      reconnecting: 0,
+      byRole: {}
+    };
+    this.presences.forEach((p) => {
+      stats[p.status]++;
+      stats.byRole[p.role] = (stats.byRole[p.role] ?? 0) + 1;
+    });
+    return stats;
+  }
+  /**
+   * Start heartbeat check (mark inactive agents as away)
+   */
+  startHeartbeatCheck() {
+    this.heartbeatInterval = setInterval(() => {
+      const now = Date.now();
+      this.presences.forEach((presence) => {
+        const lastSeenTime = new Date(presence.lastSeen).getTime();
+        const timeSinceLastSeen = now - lastSeenTime;
+        if (timeSinceLastSeen > this.inactivityThreshold && presence.status === "online") {
+          presence.status = "away";
+          this.emit("status_updated", {
+            agentId: presence.agentId,
+            status: "away"
+          });
+        }
+        if (timeSinceLastSeen > this.heartbeatTimeout && presence.status !== "offline") {
+          presence.status = "reconnecting";
+          this.emit("status_updated", {
+            agentId: presence.agentId,
+            status: "reconnecting"
+          });
+        }
+      });
+    }, 1e4);
+  }
+  /**
+   * Stop heartbeat monitoring
+   */
+  stopHeartbeatMonitoring() {
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+      this.heartbeatInterval = null;
+    }
+  }
+  /**
+   * Clear all presences
+   */
+  clear() {
+    this.presences.clear();
+  }
+  /**
+   * Destroy the manager
+   */
+  destroy() {
+    this.stopHeartbeatMonitoring();
+    this.presences.clear();
+    this.removeAllListeners();
+    logger.debug("[AgentPresenceManager] Destroyed", {
+      sessionId: this.sessionId
+    });
+  }
+};
+var instances = /* @__PURE__ */ new Map();
+function getAgentPresenceManager(sessionId) {
+  if (!instances.has(sessionId)) {
+    instances.set(sessionId, new AgentPresenceManager(sessionId));
+  }
+  return instances.get(sessionId);
+}
+function clearAgentPresenceManager(sessionId) {
+  const instance = instances.get(sessionId);
+  if (instance) {
+    instance.destroy();
+    instances.delete(sessionId);
+  }
+}
+
+export { AgentPresenceManager, clearAgentPresenceManager, getAgentPresenceManager };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/presence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/logger.ts","../../src/presence/AgentPresenceManager.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Aeon Logger Interface\n *\n * Provides a pluggable logging interface that can be configured\n * by consumers to integrate with their preferred logging solution.\n */\n\n/**\n * Logger interface that consumers can implement\n */\nexport interface Logger {\n  debug: (...args: unknown[]) => void;\n  info: (...args: unknown[]) => void;\n  warn: (...args: unknown[]) => void;\n  error: (...args: unknown[]) => void;\n}\n\n/**\n * Default console logger implementation\n */\nconst consoleLogger: Logger = {\n  debug: (...args: unknown[]) => {\n    // eslint-disable-next-line no-console\n    console.debug('[AEON:DEBUG]', ...args);\n  },\n  info: (...args: unknown[]) => {\n    // eslint-disable-next-line no-console\n    console.info('[AEON:INFO]', ...args);\n  },\n  warn: (...args: unknown[]) => {\n    // eslint-disable-next-line no-console\n    console.warn('[AEON:WARN]', ...args);\n  },\n  error: (...args: unknown[]) => {\n    // eslint-disable-next-line no-console\n    console.error('[AEON:ERROR]', ...args);\n  },\n};\n\n/**\n * No-op logger for production or when logging is disabled\n */\nconst noopLogger: Logger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n};\n\n/**\n * Current logger instance\n */\nlet currentLogger: Logger = consoleLogger;\n\n/**\n * Get the current logger instance\n */\nexport function getLogger(): Logger {\n  return currentLogger;\n}\n\n/**\n * Set a custom logger implementation\n */\nexport function setLogger(logger: Logger): void {\n  currentLogger = logger;\n}\n\n/**\n * Reset to the default console logger\n */\nexport function resetLogger(): void {\n  currentLogger = consoleLogger;\n}\n\n/**\n * Disable all logging\n */\nexport function disableLogging(): void {\n  currentLogger = noopLogger;\n}\n\n/**\n * Create a namespaced logger\n */\nexport function createNamespacedLogger(namespace: string): Logger {\n  const logger = getLogger();\n  return {\n    debug: (...args: unknown[]) => logger.debug(`[${namespace}]`, ...args),\n    info: (...args: unknown[]) => logger.info(`[${namespace}]`, ...args),\n    warn: (...args: unknown[]) => logger.warn(`[${namespace}]`, ...args),\n    error: (...args: unknown[]) => logger.error(`[${namespace}]`, ...args),\n  };\n}\n\n// Export default logger for convenience\nexport const logger: Logger = {\n  debug: (...args: unknown[]) => getLogger().debug(...args),\n  info: (...args: unknown[]) => getLogger().info(...args),\n  warn: (...args: unknown[]) => getLogger().warn(...args),\n  error: (...args: unknown[]) => getLogger().error(...args),\n};\n","/**\n * Agent Presence Manager (Phase 14)\n *\n * Tracks real-time presence of all agents in a session.\n * Provides status updates, cursor tracking, and activity monitoring.\n */\n\nimport { EventEmitter } from 'eventemitter3';\nimport { getLogger } from '../utils/logger';\n\nconst logger = getLogger();\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface AgentPresence {\n  agentId: string;\n  name: string;\n  role: 'user' | 'assistant' | 'monitor' | 'admin';\n  status: 'online' | 'away' | 'offline' | 'reconnecting';\n  joinedAt: string;\n  lastSeen: string;\n  cursorPosition?: { x: number; y: number; path: string };\n  activeSection?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface PresenceUpdate {\n  agentId: string;\n  changes: Partial<AgentPresence>;\n  timestamp: string;\n}\n\nexport interface PresenceEvents {\n  presence_updated: (data: {\n    agentId: string;\n    presence: AgentPresence;\n  }) => void;\n  agent_joined: (data: { agentId: string; presence: AgentPresence }) => void;\n  agent_left: (data: { agentId: string; presence: AgentPresence }) => void;\n  cursor_updated: (data: {\n    agentId: string;\n    cursorPosition: { x: number; y: number; path: string };\n  }) => void;\n  section_updated: (data: { agentId: string; activeSection: string }) => void;\n  status_updated: (data: {\n    agentId: string;\n    status: AgentPresence['status'];\n  }) => void;\n}\n\n// ============================================================================\n// Agent Presence Manager\n// ============================================================================\n\nexport class AgentPresenceManager extends EventEmitter<PresenceEvents> {\n  private presences: Map<string, AgentPresence> = new Map();\n  private sessionId: string;\n  private heartbeatInterval: ReturnType<typeof setInterval> | null = null;\n  private heartbeatTimeout = 30000;\n  private inactivityThreshold = 60000;\n\n  constructor(sessionId: string) {\n    super();\n    this.sessionId = sessionId;\n    this.startHeartbeatCheck();\n    logger.debug('[AgentPresenceManager] Initialized', { sessionId });\n  }\n\n  /**\n   * Add or update agent presence\n   */\n  updatePresence(\n    agentId: string,\n    presence: Omit<AgentPresence, 'joinedAt' | 'lastSeen'>,\n  ): void {\n    const existing = this.presences.get(agentId);\n    const now = new Date().toISOString();\n\n    const updated: AgentPresence = {\n      ...existing,\n      ...presence,\n      agentId,\n      joinedAt: existing?.joinedAt ?? now,\n      lastSeen: now,\n    };\n\n    this.presences.set(agentId, updated);\n\n    this.emit('presence_updated', {\n      agentId,\n      presence: updated,\n    });\n  }\n\n  /**\n   * Agent joined\n   */\n  agentJoined(\n    agentId: string,\n    name: string,\n    role: AgentPresence['role'] = 'user',\n    metadata?: Record<string, unknown>,\n  ): void {\n    const now = new Date().toISOString();\n\n    const presence: AgentPresence = {\n      agentId,\n      name,\n      role,\n      status: 'online',\n      joinedAt: now,\n      lastSeen: now,\n      metadata,\n    };\n\n    this.presences.set(agentId, presence);\n    this.emit('agent_joined', { agentId, presence });\n\n    logger.debug('[AgentPresenceManager] Agent joined', {\n      agentId,\n      name,\n      role,\n    });\n  }\n\n  /**\n   * Agent left\n   */\n  agentLeft(agentId: string): void {\n    const presence = this.presences.get(agentId);\n\n    if (presence) {\n      presence.status = 'offline';\n      presence.lastSeen = new Date().toISOString();\n\n      this.presences.set(agentId, presence);\n      this.emit('agent_left', { agentId, presence });\n\n      logger.debug('[AgentPresenceManager] Agent left', { agentId });\n    }\n  }\n\n  /**\n   * Update cursor position\n   */\n  updateCursor(agentId: string, x: number, y: number, path: string): void {\n    const presence = this.presences.get(agentId);\n\n    if (presence) {\n      presence.cursorPosition = { x, y, path };\n      presence.lastSeen = new Date().toISOString();\n\n      this.presences.set(agentId, presence);\n      this.emit('cursor_updated', {\n        agentId,\n        cursorPosition: presence.cursorPosition,\n      });\n    }\n  }\n\n  /**\n   * Update active section\n   */\n  updateActiveSection(agentId: string, section: string): void {\n    const presence = this.presences.get(agentId);\n\n    if (presence) {\n      presence.activeSection = section;\n      presence.lastSeen = new Date().toISOString();\n\n      this.presences.set(agentId, presence);\n      this.emit('section_updated', {\n        agentId,\n        activeSection: section,\n      });\n    }\n  }\n\n  /**\n   * Update status\n   */\n  updateStatus(agentId: string, status: AgentPresence['status']): void {\n    const presence = this.presences.get(agentId);\n\n    if (presence) {\n      presence.status = status;\n      presence.lastSeen = new Date().toISOString();\n\n      this.presences.set(agentId, presence);\n      this.emit('status_updated', { agentId, status });\n    }\n  }\n\n  /**\n   * Heartbeat from agent (keeps them online)\n   */\n  heartbeat(agentId: string): void {\n    const presence = this.presences.get(agentId);\n\n    if (presence) {\n      if (presence.status === 'reconnecting') {\n        presence.status = 'online';\n        this.emit('status_updated', { agentId, status: 'online' });\n      }\n\n      presence.lastSeen = new Date().toISOString();\n      this.presences.set(agentId, presence);\n    }\n  }\n\n  /**\n   * Get presence for agent\n   */\n  getPresence(agentId: string): AgentPresence | undefined {\n    return this.presences.get(agentId);\n  }\n\n  /**\n   * Get all online agents\n   */\n  getOnlineAgents(): AgentPresence[] {\n    return Array.from(this.presences.values()).filter(\n      (p) => p.status === 'online',\n    );\n  }\n\n  /**\n   * Get all agents\n   */\n  getAllAgents(): AgentPresence[] {\n    return Array.from(this.presences.values());\n  }\n\n  /**\n   * Get all presences\n   */\n  getAllPresences(): AgentPresence[] {\n    return Array.from(this.presences.values());\n  }\n\n  /**\n   * Get agent count\n   */\n  getAgentCount(): Record<AgentPresence['status'], number> {\n    const counts = {\n      online: 0,\n      away: 0,\n      offline: 0,\n      reconnecting: 0,\n    };\n\n    this.presences.forEach((p) => {\n      counts[p.status]++;\n    });\n\n    return counts;\n  }\n\n  /**\n   * Get statistics\n   */\n  getStats() {\n    return {\n      totalAgents: this.presences.size,\n      onlineAgents: Array.from(this.presences.values()).filter(\n        (p) => p.status === 'online',\n      ).length,\n      offlineAgents: Array.from(this.presences.values()).filter(\n        (p) => p.status === 'offline',\n      ).length,\n      awayAgents: Array.from(this.presences.values()).filter(\n        (p) => p.status === 'away',\n      ).length,\n      reconnectingAgents: Array.from(this.presences.values()).filter(\n        (p) => p.status === 'reconnecting',\n      ).length,\n    };\n  }\n\n  /**\n   * Clear expired presences\n   */\n  clearExpiredPresences(maxAgeMs: number): void {\n    const now = Date.now();\n    const toRemove: string[] = [];\n\n    this.presences.forEach((presence, agentId) => {\n      const lastSeenTime = new Date(presence.lastSeen).getTime();\n      const ageMs = now - lastSeenTime;\n\n      if (ageMs > maxAgeMs && presence.status === 'offline') {\n        toRemove.push(agentId);\n      }\n    });\n\n    toRemove.forEach((agentId) => {\n      this.presences.delete(agentId);\n    });\n\n    if (toRemove.length > 0) {\n      logger.debug('[AgentPresenceManager] Cleared expired presences', {\n        count: toRemove.length,\n      });\n    }\n  }\n\n  /**\n   * Get agents by role\n   */\n  getByRole(role: AgentPresence['role']): AgentPresence[] {\n    return Array.from(this.presences.values()).filter((p) => p.role === role);\n  }\n\n  /**\n   * Get agents in active section\n   */\n  getInSection(section: string): AgentPresence[] {\n    return Array.from(this.presences.values()).filter(\n      (p) => p.activeSection === section && p.status === 'online',\n    );\n  }\n\n  /**\n   * Get presence timeline\n   */\n  getPresenceStats() {\n    const stats = {\n      total: this.presences.size,\n      online: 0,\n      away: 0,\n      offline: 0,\n      reconnecting: 0,\n      byRole: {} as Record<string, number>,\n    };\n\n    this.presences.forEach((p) => {\n      stats[p.status]++;\n      stats.byRole[p.role] = (stats.byRole[p.role] ?? 0) + 1;\n    });\n\n    return stats;\n  }\n\n  /**\n   * Start heartbeat check (mark inactive agents as away)\n   */\n  private startHeartbeatCheck(): void {\n    this.heartbeatInterval = setInterval(() => {\n      const now = Date.now();\n\n      this.presences.forEach((presence) => {\n        const lastSeenTime = new Date(presence.lastSeen).getTime();\n        const timeSinceLastSeen = now - lastSeenTime;\n\n        if (\n          timeSinceLastSeen > this.inactivityThreshold &&\n          presence.status === 'online'\n        ) {\n          presence.status = 'away';\n          this.emit('status_updated', {\n            agentId: presence.agentId,\n            status: 'away',\n          });\n        }\n\n        if (\n          timeSinceLastSeen > this.heartbeatTimeout &&\n          presence.status !== 'offline'\n        ) {\n          presence.status = 'reconnecting';\n          this.emit('status_updated', {\n            agentId: presence.agentId,\n            status: 'reconnecting',\n          });\n        }\n      });\n    }, 10000);\n  }\n\n  /**\n   * Stop heartbeat monitoring\n   */\n  stopHeartbeatMonitoring(): void {\n    if (this.heartbeatInterval) {\n      clearInterval(this.heartbeatInterval);\n      this.heartbeatInterval = null;\n    }\n  }\n\n  /**\n   * Clear all presences\n   */\n  clear(): void {\n    this.presences.clear();\n  }\n\n  /**\n   * Destroy the manager\n   */\n  destroy(): void {\n    this.stopHeartbeatMonitoring();\n    this.presences.clear();\n    this.removeAllListeners();\n    logger.debug('[AgentPresenceManager] Destroyed', {\n      sessionId: this.sessionId,\n    });\n  }\n}\n\n// ============================================================================\n// Singleton Instance Map\n// ============================================================================\n\nconst instances = new Map<string, AgentPresenceManager>();\n\nexport function getAgentPresenceManager(\n  sessionId: string,\n): AgentPresenceManager {\n  if (!instances.has(sessionId)) {\n    instances.set(sessionId, new AgentPresenceManager(sessionId));\n  }\n  return instances.get(sessionId)!;\n}\n\nexport function clearAgentPresenceManager(sessionId: string): void {\n  const instance = instances.get(sessionId);\n  if (instance) {\n    instance.destroy();\n    instances.delete(sessionId);\n  }\n}\n"]}

package/dist/types-CMxO7QF0.d.cts

@@ -0,0 +1,33 @@
+/**
+ * Persistence types for Aeon durable state.
+ *
+ * The adapter interface is intentionally minimal so consumers can map it to
+ * local storage, WASM-backed stores, D1/R2 synchronization layers, or custom
+ * encrypted stores without extra dependencies.
+ */
+/**
+ * Minimal storage adapter interface.
+ */
+interface StorageAdapter {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}
+/**
+ * Versioned envelope for persisted payloads.
+ */
+interface PersistedEnvelope<T> {
+    version: 1;
+    updatedAt: number;
+    data: T;
+}
+/**
+ * Serialization hook for custom privacy/security implementations.
+ */
+type PersistenceSerializer<T> = (value: PersistedEnvelope<T>) => string;
+/**
+ * Deserialization hook for custom privacy/security implementations.
+ */
+type PersistenceDeserializer<T> = (raw: string) => PersistedEnvelope<T>;
+
+export type { PersistedEnvelope as P, StorageAdapter as S, PersistenceDeserializer as a, PersistenceSerializer as b };

package/dist/types-CMxO7QF0.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Persistence types for Aeon durable state.
+ *
+ * The adapter interface is intentionally minimal so consumers can map it to
+ * local storage, WASM-backed stores, D1/R2 synchronization layers, or custom
+ * encrypted stores without extra dependencies.
+ */
+/**
+ * Minimal storage adapter interface.
+ */
+interface StorageAdapter {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}
+/**
+ * Versioned envelope for persisted payloads.
+ */
+interface PersistedEnvelope<T> {
+    version: 1;
+    updatedAt: number;
+    data: T;
+}
+/**
+ * Serialization hook for custom privacy/security implementations.
+ */
+type PersistenceSerializer<T> = (value: PersistedEnvelope<T>) => string;
+/**
+ * Deserialization hook for custom privacy/security implementations.
+ */
+type PersistenceDeserializer<T> = (raw: string) => PersistedEnvelope<T>;
+
+export type { PersistedEnvelope as P, StorageAdapter as S, PersistenceDeserializer as a, PersistenceSerializer as b };