@dexto/core 1.1.10 → 1.2.0

package/dist/session/session-manager.cjs

@@ -66,18 +66,18 @@ class SessionManager {
    */
   async restoreSessionsFromStorage() {
     try {
-      const sessionKeys = await this.services.storage.database.list("session:");
+      const sessionKeys = await this.services.storageManager.getDatabase().list("session:");
       import_logger.logger.debug(`Found ${sessionKeys.length} persisted sessions to restore`);
       for (const sessionKey of sessionKeys) {
         const sessionId = sessionKey.replace("session:", "");
-        const sessionData = await this.services.storage.database.get(sessionKey);
+        const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
         if (sessionData) {
           const now = Date.now();
           const lastActivity = sessionData.lastActivity;
           if (now - lastActivity <= this.sessionTTL) {
             import_logger.logger.debug(`Session ${sessionId} restored from storage`);
           } else {
-            await this.services.storage.database.delete(sessionKey);
+            await this.services.storageManager.getDatabase().delete(sessionKey);
             import_logger.logger.debug(`Expired session ${sessionId} cleaned up during restore`);
           }
         }
@@ -132,16 +132,16 @@ class SessionManager {
   async createSessionInternal(id) {
     await this.cleanupExpiredSessions();
     const sessionKey = `session:${id}`;
-    const existingMetadata = await this.services.storage.database.get(sessionKey);
+    const existingMetadata = await this.services.storageManager.getDatabase().get(sessionKey);
     if (existingMetadata) {
       await this.updateSessionActivity(id);
-      const session2 = new import_chat_session.ChatSession(this.services, id);
+      const session2 = new import_chat_session.ChatSession({ ...this.services, sessionManager: this }, id);
       await session2.init();
       this.sessions.set(id, session2);
       import_logger.logger.info(`Restored session from storage: ${id}`, null, "cyan");
       return session2;
     }
-    const activeSessionKeys = await this.services.storage.database.list("session:");
+    const activeSessionKeys = await this.services.storageManager.getDatabase().list("session:");
     if (activeSessionKeys.length >= this.maxSessions) {
       throw import_errors.SessionError.maxSessionsExceeded(activeSessionKeys.length, this.maxSessions);
     }
@@ -152,25 +152,25 @@ class SessionManager {
       messageCount: 0
     };
     try {
-      await this.services.storage.database.set(sessionKey, sessionData);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
     } catch (error) {
       import_logger.logger.error(`Failed to store session metadata for ${id}:`, error);
       throw error;
     }
     let session;
     try {
-      session = new import_chat_session.ChatSession(this.services, id);
+      session = new import_chat_session.ChatSession({ ...this.services, sessionManager: this }, id);
       await session.init();
       this.sessions.set(id, session);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
       import_logger.logger.info(`Created new session: ${id}`, null, "green");
       return session;
     } catch (error) {
       import_logger.logger.error(
         `Failed to initialize session ${id}: ${error instanceof Error ? error.message : String(error)}`
       );
-      await this.services.storage.database.delete(sessionKey);
-      await this.services.storage.cache.delete(sessionKey);
+      await this.services.storageManager.getDatabase().delete(sessionKey);
+      await this.services.storageManager.getCache().delete(sessionKey);
       const reason = error instanceof Error ? error.message : "unknown error";
       throw import_errors.SessionError.initializationFailed(id, reason);
     }
@@ -202,9 +202,12 @@ class SessionManager {
     }
     if (restoreFromStorage) {
       const sessionKey = `session:${sessionId}`;
-      const sessionData = await this.services.storage.database.get(sessionKey);
+      const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
       if (sessionData) {
-        const session = new import_chat_session.ChatSession(this.services, sessionId);
+        const session = new import_chat_session.ChatSession(
+          { ...this.services, sessionManager: this },
+          sessionId
+        );
         await session.init();
         this.sessions.set(sessionId, session);
         return session;
@@ -226,7 +229,7 @@ class SessionManager {
       this.sessions.delete(sessionId);
     }
     const sessionKey = `session:${sessionId}`;
-    await this.services.storage.cache.delete(sessionKey);
+    await this.services.storageManager.getCache().delete(sessionKey);
     import_logger.logger.debug(`Ended session (removed from memory, chat history preserved): ${sessionId}`);
   }
   /**
@@ -244,8 +247,8 @@ class SessionManager {
       this.sessions.delete(sessionId);
     }
     const sessionKey = `session:${sessionId}`;
-    await this.services.storage.database.delete(sessionKey);
-    await this.services.storage.cache.delete(sessionKey);
+    await this.services.storageManager.getDatabase().delete(sessionKey);
+    await this.services.storageManager.getCache().delete(sessionKey);
     import_logger.logger.debug(`Deleted session and conversation history: ${sessionId}`);
   }
   /**
@@ -262,12 +265,12 @@ class SessionManager {
     }
     await session.reset();
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     if (sessionData) {
       sessionData.messageCount = 0;
       sessionData.lastActivity = Date.now();
-      await this.services.storage.database.set(sessionKey, sessionData);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
     }
     import_logger.logger.debug(`Reset session conversation: ${sessionId}`);
   }
@@ -278,7 +281,7 @@ class SessionManager {
    */
   async listSessions() {
     await this.ensureInitialized();
-    const sessionKeys = await this.services.storage.database.list("session:");
+    const sessionKeys = await this.services.storageManager.getDatabase().list("session:");
     return sessionKeys.map((key) => key.replace("session:", ""));
   }
   /**
@@ -290,11 +293,12 @@ class SessionManager {
   async getSessionMetadata(sessionId) {
     await this.ensureInitialized();
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     return sessionData ? {
       createdAt: sessionData.createdAt,
       lastActivity: sessionData.lastActivity,
-      messageCount: sessionData.messageCount
+      messageCount: sessionData.messageCount,
+      title: sessionData.metadata?.title
     } : void 0;
   }
   /**
@@ -311,11 +315,11 @@ class SessionManager {
    */
   async updateSessionActivity(sessionId) {
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     if (sessionData) {
       sessionData.lastActivity = Date.now();
-      await this.services.storage.database.set(sessionKey, sessionData);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
     }
   }
   /**
@@ -324,13 +328,43 @@ class SessionManager {
   async incrementMessageCount(sessionId) {
     await this.ensureInitialized();
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     if (sessionData) {
       sessionData.messageCount++;
       sessionData.lastActivity = Date.now();
-      await this.services.storage.database.set(sessionKey, sessionData);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
+    }
+  }
+  /**
+   * Sets the human-friendly title for a session.
+   * Title is stored in session metadata and cached with TTL.
+   */
+  async setSessionTitle(sessionId, title, opts = {}) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
+    if (!sessionData) {
+      throw import_errors.SessionError.notFound(sessionId);
     }
+    const normalized = title.trim().slice(0, 80);
+    if (opts.ifUnsetOnly && sessionData.metadata?.title) {
+      return;
+    }
+    sessionData.metadata = sessionData.metadata || {};
+    sessionData.metadata.title = normalized;
+    sessionData.lastActivity = Date.now();
+    await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+    await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
+  }
+  /**
+   * Gets the stored title for a session, if any.
+   */
+  async getSessionTitle(sessionId) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
+    return sessionData?.metadata?.title;
   }
   /**
    * Cleans up expired sessions from memory only, preserving chat history in storage.
@@ -341,7 +375,7 @@ class SessionManager {
     const expiredSessions = [];
     for (const [sessionId, _session] of this.sessions.entries()) {
       const sessionKey = `session:${sessionId}`;
-      const sessionData = await this.services.storage.database.get(sessionKey);
+      const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
       if (sessionData && now - sessionData.lastActivity > this.sessionTTL) {
         expiredSessions.push(sessionId);
       }

package/dist/session/session-manager.d.ts

@@ -1,51 +1,22 @@
 import { ChatSession } from './chat-session.js';
-import { PromptManager } from '../systemPrompt/manager.js';
+import { SystemPromptManager } from '../systemPrompt/manager.js';
 import { ToolManager } from '../tools/tool-manager.js';
 import { AgentEventBus } from '../events/index.js';
-import { AgentStateManager } from '../agent/state-manager.js';
-import { ValidatedLLMConfig } from '../llm/schemas.js';
-import { StorageBackends } from '../storage/backend/types.js';
-import '../context/manager.js';
-import '../llm/formatters/types.js';
-import '../context/types.js';
-import '../llm/types.js';
-import '../llm/tokenizer/types.js';
-import '../context/compression/types.js';
-import '../systemPrompt/types.js';
-import '../mcp/manager.js';
-import '../mcp/schemas.js';
-import 'zod';
-import '../mcp/types.js';
-import '@modelcontextprotocol/sdk/client/index.js';
-import '../tools/types.js';
-import 'json-schema';
-import '@modelcontextprotocol/sdk/types.js';
-import './history/types.js';
-import '../llm/services/types.js';
-import 'ai';
-import '../systemPrompt/schemas.js';
-import '../tools/internal-tools/registry.js';
-import '../search/search-service.js';
-import '../storage/backend/database-backend.js';
-import '../search/types.js';
-import '../tools/schemas.js';
-import '../tools/confirmation/types.js';
-import '../tools/confirmation/allowed-tools-provider/types.js';
-import 'events';
-import '../agent/schemas.js';
-import '../storage/backend/cache-backend.js';
-import '../storage/schemas.js';
-
-interface SessionMetadata {
+import type { AgentStateManager } from '../agent/state-manager.js';
+import type { ValidatedLLMConfig } from '../llm/schemas.js';
+import type { StorageManager } from '../storage/index.js';
+import type { PluginManager } from '../plugins/manager.js';
+export interface SessionMetadata {
     createdAt: number;
     lastActivity: number;
     messageCount: number;
+    title?: string;
 }
-interface SessionManagerConfig {
+export interface SessionManagerConfig {
     maxSessions?: number;
     sessionTTL?: number;
 }
-interface SessionData {
+export interface SessionData {
     id: string;
     userId?: string;
     createdAt: number;
@@ -62,8 +33,14 @@ interface SessionData {
  * - Cleaning up expired sessions
  * - Providing session lifecycle management
  * - Persisting session data using the simplified storage backends
+ *
+ * TODO (Telemetry): Add OpenTelemetry metrics collection later if needed
+ *   - Active session gauges (current count)
+ *   - Session creation/deletion counters
+ *   - Session duration histograms
+ *   - Messages per session histograms
  */
-declare class SessionManager {
+export declare class SessionManager {
     private services;
     private sessions;
     private readonly maxSessions;
@@ -74,10 +51,13 @@ declare class SessionManager {
     private readonly pendingCreations;
     constructor(services: {
         stateManager: AgentStateManager;
-        promptManager: PromptManager;
+        systemPromptManager: SystemPromptManager;
         toolManager: ToolManager;
         agentEventBus: AgentEventBus;
-        storage: StorageBackends;
+        storageManager: StorageManager;
+        resourceManager: import('../resources/index.js').ResourceManager;
+        pluginManager: PluginManager;
+        mcpManager: import('../mcp/manager.js').MCPManager;
     }, config?: SessionManagerConfig);
     /**
      * Initialize the SessionManager with persistent storage.
@@ -167,6 +147,17 @@ declare class SessionManager {
      * Increments the message count for a session.
      */
     incrementMessageCount(sessionId: string): Promise<void>;
+    /**
+     * Sets the human-friendly title for a session.
+     * Title is stored in session metadata and cached with TTL.
+     */
+    setSessionTitle(sessionId: string, title: string, opts?: {
+        ifUnsetOnly?: boolean;
+    }): Promise<void>;
+    /**
+     * Gets the stored title for a session, if any.
+     */
+    getSessionTitle(sessionId: string): Promise<string | undefined>;
     /**
      * Cleans up expired sessions from memory only, preserving chat history in storage.
      * This allows inactive sessions to be garbage collected while keeping conversations restorable.
@@ -215,5 +206,4 @@ declare class SessionManager {
      */
     cleanup(): Promise<void>;
 }
-
-export { type SessionData, SessionManager, type SessionManagerConfig, type SessionMetadata };
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/session/session-manager.ts"],"names":[],"mappings":"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"}

package/dist/session/session-manager.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { randomUUID } from "crypto";
 import { ChatSession } from "./chat-session.js";
 import { logger } from "../logger/index.js";
@@ -43,18 +44,18 @@ class SessionManager {
    */
   async restoreSessionsFromStorage() {
     try {
-      const sessionKeys = await this.services.storage.database.list("session:");
+      const sessionKeys = await this.services.storageManager.getDatabase().list("session:");
       logger.debug(`Found ${sessionKeys.length} persisted sessions to restore`);
       for (const sessionKey of sessionKeys) {
         const sessionId = sessionKey.replace("session:", "");
-        const sessionData = await this.services.storage.database.get(sessionKey);
+        const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
         if (sessionData) {
           const now = Date.now();
           const lastActivity = sessionData.lastActivity;
           if (now - lastActivity <= this.sessionTTL) {
             logger.debug(`Session ${sessionId} restored from storage`);
           } else {
-            await this.services.storage.database.delete(sessionKey);
+            await this.services.storageManager.getDatabase().delete(sessionKey);
             logger.debug(`Expired session ${sessionId} cleaned up during restore`);
           }
         }
@@ -109,16 +110,16 @@ class SessionManager {
   async createSessionInternal(id) {
     await this.cleanupExpiredSessions();
     const sessionKey = `session:${id}`;
-    const existingMetadata = await this.services.storage.database.get(sessionKey);
+    const existingMetadata = await this.services.storageManager.getDatabase().get(sessionKey);
     if (existingMetadata) {
       await this.updateSessionActivity(id);
-      const session2 = new ChatSession(this.services, id);
+      const session2 = new ChatSession({ ...this.services, sessionManager: this }, id);
       await session2.init();
       this.sessions.set(id, session2);
       logger.info(`Restored session from storage: ${id}`, null, "cyan");
       return session2;
     }
-    const activeSessionKeys = await this.services.storage.database.list("session:");
+    const activeSessionKeys = await this.services.storageManager.getDatabase().list("session:");
     if (activeSessionKeys.length >= this.maxSessions) {
       throw SessionError.maxSessionsExceeded(activeSessionKeys.length, this.maxSessions);
     }
@@ -129,25 +130,25 @@ class SessionManager {
       messageCount: 0
     };
     try {
-      await this.services.storage.database.set(sessionKey, sessionData);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
     } catch (error) {
       logger.error(`Failed to store session metadata for ${id}:`, error);
       throw error;
     }
     let session;
     try {
-      session = new ChatSession(this.services, id);
+      session = new ChatSession({ ...this.services, sessionManager: this }, id);
       await session.init();
       this.sessions.set(id, session);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
       logger.info(`Created new session: ${id}`, null, "green");
       return session;
     } catch (error) {
       logger.error(
         `Failed to initialize session ${id}: ${error instanceof Error ? error.message : String(error)}`
       );
-      await this.services.storage.database.delete(sessionKey);
-      await this.services.storage.cache.delete(sessionKey);
+      await this.services.storageManager.getDatabase().delete(sessionKey);
+      await this.services.storageManager.getCache().delete(sessionKey);
       const reason = error instanceof Error ? error.message : "unknown error";
       throw SessionError.initializationFailed(id, reason);
     }
@@ -179,9 +180,12 @@ class SessionManager {
     }
     if (restoreFromStorage) {
       const sessionKey = `session:${sessionId}`;
-      const sessionData = await this.services.storage.database.get(sessionKey);
+      const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
       if (sessionData) {
-        const session = new ChatSession(this.services, sessionId);
+        const session = new ChatSession(
+          { ...this.services, sessionManager: this },
+          sessionId
+        );
         await session.init();
         this.sessions.set(sessionId, session);
         return session;
@@ -203,7 +207,7 @@ class SessionManager {
       this.sessions.delete(sessionId);
     }
     const sessionKey = `session:${sessionId}`;
-    await this.services.storage.cache.delete(sessionKey);
+    await this.services.storageManager.getCache().delete(sessionKey);
     logger.debug(`Ended session (removed from memory, chat history preserved): ${sessionId}`);
   }
   /**
@@ -221,8 +225,8 @@ class SessionManager {
       this.sessions.delete(sessionId);
     }
     const sessionKey = `session:${sessionId}`;
-    await this.services.storage.database.delete(sessionKey);
-    await this.services.storage.cache.delete(sessionKey);
+    await this.services.storageManager.getDatabase().delete(sessionKey);
+    await this.services.storageManager.getCache().delete(sessionKey);
     logger.debug(`Deleted session and conversation history: ${sessionId}`);
   }
   /**
@@ -239,12 +243,12 @@ class SessionManager {
     }
     await session.reset();
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     if (sessionData) {
       sessionData.messageCount = 0;
       sessionData.lastActivity = Date.now();
-      await this.services.storage.database.set(sessionKey, sessionData);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
     }
     logger.debug(`Reset session conversation: ${sessionId}`);
   }
@@ -255,7 +259,7 @@ class SessionManager {
    */
   async listSessions() {
     await this.ensureInitialized();
-    const sessionKeys = await this.services.storage.database.list("session:");
+    const sessionKeys = await this.services.storageManager.getDatabase().list("session:");
     return sessionKeys.map((key) => key.replace("session:", ""));
   }
   /**
@@ -267,11 +271,12 @@ class SessionManager {
   async getSessionMetadata(sessionId) {
     await this.ensureInitialized();
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     return sessionData ? {
       createdAt: sessionData.createdAt,
       lastActivity: sessionData.lastActivity,
-      messageCount: sessionData.messageCount
+      messageCount: sessionData.messageCount,
+      title: sessionData.metadata?.title
     } : void 0;
   }
   /**
@@ -288,11 +293,11 @@ class SessionManager {
    */
   async updateSessionActivity(sessionId) {
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     if (sessionData) {
       sessionData.lastActivity = Date.now();
-      await this.services.storage.database.set(sessionKey, sessionData);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
     }
   }
   /**
@@ -301,13 +306,43 @@ class SessionManager {
   async incrementMessageCount(sessionId) {
     await this.ensureInitialized();
     const sessionKey = `session:${sessionId}`;
-    const sessionData = await this.services.storage.database.get(sessionKey);
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
     if (sessionData) {
       sessionData.messageCount++;
       sessionData.lastActivity = Date.now();
-      await this.services.storage.database.set(sessionKey, sessionData);
-      await this.services.storage.cache.set(sessionKey, sessionData, this.sessionTTL / 1e3);
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
+    }
+  }
+  /**
+   * Sets the human-friendly title for a session.
+   * Title is stored in session metadata and cached with TTL.
+   */
+  async setSessionTitle(sessionId, title, opts = {}) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
+    if (!sessionData) {
+      throw SessionError.notFound(sessionId);
     }
+    const normalized = title.trim().slice(0, 80);
+    if (opts.ifUnsetOnly && sessionData.metadata?.title) {
+      return;
+    }
+    sessionData.metadata = sessionData.metadata || {};
+    sessionData.metadata.title = normalized;
+    sessionData.lastActivity = Date.now();
+    await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+    await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
+  }
+  /**
+   * Gets the stored title for a session, if any.
+   */
+  async getSessionTitle(sessionId) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
+    return sessionData?.metadata?.title;
   }
   /**
    * Cleans up expired sessions from memory only, preserving chat history in storage.
@@ -318,7 +353,7 @@ class SessionManager {
     const expiredSessions = [];
     for (const [sessionId, _session] of this.sessions.entries()) {
       const sessionKey = `session:${sessionId}`;
-      const sessionData = await this.services.storage.database.get(sessionKey);
+      const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
       if (sessionData && now - sessionData.lastActivity > this.sessionTTL) {
         expiredSessions.push(sessionId);
       }