@framers/agentos 0.1.0

package/dist/core/conversation/ConversationManager.js

@@ -0,0 +1,558 @@
+// File: backend/agentos/core/conversation/ConversationManager.ts
+/**
+ * @fileoverview Manages the lifecycle of ConversationContext instances in AgentOS.
+ * Responsible for creating, retrieving, storing (both in-memory and persistently
+ * using sql-storage-adapter), and managing active conversation states. It ensures conversations
+ * can be rehydrated and maintained across sessions.
+ *
+ * @module backend/agentos/core/conversation/ConversationManager
+ * @see ./ConversationContext.ts
+ * @see ../../ai_utilities/IUtilityAI.ts
+ * @see @framers/sql-storage-adapter
+ */
+import { ConversationContext } from './ConversationContext.js';
+import { createConversationMessage } from './ConversationMessage.js';
+import { uuidv4 } from '../../utils/uuid.js';
+import { GMIError, GMIErrorCode } from '../../utils/errors.js';
+/**
+ * SQL schema for conversations table (compatible with SQLite, PostgreSQL, IndexedDB)
+ */
+const CONVERSATIONS_SCHEMA = `
+CREATE TABLE IF NOT EXISTS conversations (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  gmi_instance_id TEXT,
+  title TEXT,
+  language TEXT,
+  session_details TEXT DEFAULT '{}',
+  is_archived INTEGER DEFAULT 0,
+  tags TEXT DEFAULT '[]',
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS conversation_messages (
+  id TEXT PRIMARY KEY,
+  conversation_id TEXT NOT NULL,
+  role TEXT NOT NULL,
+  content TEXT NOT NULL,
+  timestamp INTEGER NOT NULL,
+  tool_calls TEXT,
+  tool_call_id TEXT,
+  multimodal_data TEXT,
+  audio_url TEXT,
+  audio_transcript TEXT,
+  voice_settings TEXT,
+  metadata TEXT DEFAULT '{}',
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_conversations_user_id ON conversations(user_id);
+CREATE INDEX IF NOT EXISTS idx_conversations_gmi_instance_id ON conversations(gmi_instance_id);
+CREATE INDEX IF NOT EXISTS idx_conversation_messages_conversation_id ON conversation_messages(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_conversation_messages_timestamp ON conversation_messages(timestamp);
+`;
+/**
+ * @class ConversationManager
+ * @description Manages ConversationContext instances for AgentOS, handling their
+ * creation, retrieval, in-memory caching, and persistent storage via sql-storage-adapter.
+ * This class is vital for maintaining conversational state across user sessions and
+ * GMI interactions.
+ */
+export class ConversationManager {
+    /**
+     * Constructs a ConversationManager instance.
+     * Initialization via `initialize()` is required before use.
+     */
+    constructor() {
+        /**
+         * Flag indicating if the manager has been successfully initialized.
+         * @private
+         * @type {boolean}
+         */
+        this.initialized = false;
+        this.managerId = `conv-mgr-${uuidv4()}`;
+        this.activeConversations = new Map();
+    }
+    /**
+     * Initializes the ConversationManager with its configuration and dependencies.
+     * This method sets up persistence if enabled and prepares the manager for operation.
+     *
+     * @public
+     * @async
+     * @param {ConversationManagerConfig} config - Configuration for the manager.
+     * @param {IUtilityAI} [utilityAIService] - Optional IUtilityAI instance, primarily
+     * used by ConversationContext instances for features like summarization.
+     * @param {StorageAdapter} [storageAdapter] - Optional storage adapter for database persistence.
+     * Required if `config.persistenceEnabled` is true.
+     * @returns {Promise<void>} A promise that resolves when initialization is complete.
+     * @throws {GMIError} If configuration is invalid or dependencies are missing when required.
+     */
+    async initialize(config, utilityAIService, storageAdapter) {
+        if (this.initialized) {
+            console.warn(`ConversationManager (ID: ${this.managerId}) already initialized. Consider if re-initialization is intended and its effects on state.`);
+        }
+        this.config = {
+            defaultConversationContextConfig: config.defaultConversationContextConfig || {},
+            maxActiveConversationsInMemory: config.maxActiveConversationsInMemory ?? 1000,
+            inactivityTimeoutMs: config.inactivityTimeoutMs ?? 3600000, // 1 hour
+            persistenceEnabled: config.persistenceEnabled ?? true, // Default to true
+            ...config, // Spread last to ensure explicit config values override defaults if provided
+        };
+        this.utilityAIService = utilityAIService;
+        this.storageAdapter = this.config.persistenceEnabled ? storageAdapter : undefined;
+        if (this.config.persistenceEnabled && !this.storageAdapter) {
+            console.warn(`ConversationManager (ID: ${this.managerId}): Persistence is enabled in config, but no StorageAdapter was provided. Persistence will be effectively disabled.`);
+            this.config.persistenceEnabled = false;
+        }
+        // Initialize schema if persistence is enabled
+        if (this.config.persistenceEnabled && this.storageAdapter) {
+            try {
+                await this.storageAdapter.exec(CONVERSATIONS_SCHEMA);
+                console.log(`ConversationManager (ID: ${this.managerId}): Schema initialized.`);
+            }
+            catch (error) {
+                console.error(`ConversationManager (ID: ${this.managerId}): Failed to initialize schema:`, error);
+                throw new GMIError(`Failed to initialize conversation schema.`, GMIErrorCode.DATABASE_ERROR, { underlyingError: error.message });
+            }
+        }
+        this.initialized = true;
+        console.log(`ConversationManager (ID: ${this.managerId}) initialized. Persistence: ${this.config.persistenceEnabled}. Max in-memory: ${this.config.maxActiveConversationsInMemory}.`);
+    }
+    /**
+     * Ensures that the manager has been initialized before performing operations.
+     * @private
+     * @throws {GMIError} If the manager is not initialized.
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new GMIError("ConversationManager is not initialized. Call initialize() first.", GMIErrorCode.NOT_INITIALIZED, { managerId: this.managerId });
+        }
+    }
+    /**
+     * Creates a new conversation context or retrieves an existing one.
+     * If `conversationId` is provided:
+     * - Tries to find it in the active (in-memory) cache.
+     * - If not in cache and persistence is enabled, tries to load from the database.
+     * - If not found in DB or persistence disabled, creates a new context with this ID.
+     * If no `conversationId` is provided, a new one is generated.
+     * Manages in-memory cache size by evicting the oldest conversation if capacity is reached.
+     *
+     * @public
+     * @async
+     * @param {string} [conversationId] - Optional ID of an existing conversation. This ID will also be used as the `ConversationContext.sessionId`.
+     * @param {string} [userId] - ID of the user associated with the conversation.
+     * @param {string} [gmiInstanceId] - ID of the GMI instance this conversation is for.
+     * @param {string} [activePersonaId] - ID of the active persona for the conversation.
+     * @param {Record<string, any>} [initialMetadata={}] - Initial metadata for a new conversation.
+     * @param {Partial<ConversationContextConfig>} [overrideConfig] - Config overrides for a new context.
+     * @returns {Promise<ConversationContext>} The created or retrieved ConversationContext.
+     * @throws {GMIError} If essential parameters for creating a new context are missing or if an error occurs.
+     */
+    async getOrCreateConversationContext(conversationId, userId, gmiInstanceId, activePersonaId, initialMetadata = {}, overrideConfig) {
+        this.ensureInitialized();
+        const effectiveConversationId = conversationId || `conv_${uuidv4()}`;
+        const context = this.activeConversations.get(effectiveConversationId);
+        if (context) {
+            // Update context identifiers if provided and different. These setters should exist on ConversationContext or be handled via setMetadata.
+            if (userId && context.getMetadata('userId') !== userId)
+                context.setMetadata('userId', userId);
+            if (gmiInstanceId && context.getMetadata('gmiInstanceId') !== gmiInstanceId)
+                context.setMetadata('gmiInstanceId', gmiInstanceId);
+            if (activePersonaId && context.getMetadata('activePersonaId') !== activePersonaId)
+                context.setMetadata('activePersonaId', activePersonaId);
+            context.setMetadata('_lastAccessed', Date.now());
+            return context;
+        }
+        if (this.config.persistenceEnabled && this.storageAdapter) {
+            const loadedContext = await this.loadConversationFromDB(effectiveConversationId);
+            if (loadedContext) {
+                if (this.activeConversations.size >= this.config.maxActiveConversationsInMemory) {
+                    await this.evictOldestConversation();
+                }
+                this.activeConversations.set(effectiveConversationId, loadedContext);
+                loadedContext.setMetadata('_lastAccessed', Date.now());
+                return loadedContext;
+            }
+        }
+        const contextConfig = {
+            ...this.config.defaultConversationContextConfig,
+            userId: userId || this.config.defaultConversationContextConfig?.userId,
+            gmiInstanceId: gmiInstanceId || this.config.defaultConversationContextConfig?.gmiInstanceId,
+            activePersonaId: activePersonaId || this.config.defaultConversationContextConfig?.activePersonaId,
+            utilityAI: this.utilityAIService || this.config.defaultConversationContextConfig?.utilityAI,
+            ...(overrideConfig || {}), // Apply overrides
+        }; // Cast as fully required after merging
+        const newContext = new ConversationContext(effectiveConversationId, contextConfig, [], initialMetadata);
+        newContext.setMetadata('_lastAccessed', Date.now());
+        if (this.activeConversations.size >= this.config.maxActiveConversationsInMemory) {
+            await this.evictOldestConversation();
+        }
+        this.activeConversations.set(effectiveConversationId, newContext);
+        return newContext;
+    }
+    /**
+     * Retrieves a ConversationContext if present in memory or persistent storage.
+     * Returns null when not found.
+     */
+    async getConversation(conversationId) {
+        this.ensureInitialized();
+        const inMemory = this.activeConversations.get(conversationId);
+        if (inMemory) {
+            return inMemory;
+        }
+        const loaded = await this.loadConversationFromDB(conversationId);
+        return loaded ?? null;
+    }
+    /**
+     * Lists minimal context info for a given session. Currently returns a single entry
+     * matching the provided sessionId if found in memory or storage.
+     */
+    async listContextsForSession(sessionId) {
+        return this.getConversationInfo(sessionId);
+    }
+    /**
+     * Saves a ConversationContext to persistent storage if persistence is enabled.
+     * This is called automatically when a context is evicted from memory or during shutdown.
+     *
+     * @public
+     * @async
+     * @param {ConversationContext} context - The ConversationContext to save.
+     * @throws {GMIError} If the save operation fails.
+     */
+    async saveConversation(context) {
+        this.ensureInitialized();
+        if (this.config.persistenceEnabled && this.storageAdapter) {
+            await this.saveConversationToDB(context);
+        }
+    }
+    /**
+     * Deletes a conversation from both memory and persistent storage.
+     *
+     * @public
+     * @async
+     * @param {string} conversationId - The ID of the conversation to delete.
+     * @throws {GMIError} If the deletion fails.
+     */
+    async deleteConversation(conversationId) {
+        this.ensureInitialized();
+        this.activeConversations.delete(conversationId);
+        if (this.config.persistenceEnabled && this.storageAdapter) {
+            try {
+                await this.storageAdapter.run('DELETE FROM conversations WHERE id = ?', [conversationId]);
+                // Messages are deleted via CASCADE, but explicit delete for safety
+                await this.storageAdapter.run('DELETE FROM conversation_messages WHERE conversation_id = ?', [conversationId]);
+            }
+            catch (error) {
+                console.error(`ConversationManager (ID: ${this.managerId}): Error deleting conversation ${conversationId} from DB:`, error);
+                throw new GMIError(`Failed to delete conversation ${conversationId} from database.`, GMIErrorCode.DATABASE_ERROR, { underlyingError: error.message });
+            }
+        }
+    }
+    /**
+     * Gets basic info about a conversation (ID and creation timestamp).
+     * Checks in-memory cache first, then persistent storage if enabled.
+     *
+     * @public
+     * @async
+     * @param {string} sessionId - The ID of the conversation.
+     * @returns {Promise<Array<{ sessionId: string; createdAt: number }>>} Array with conversation info, or empty if not found.
+     */
+    async getConversationInfo(sessionId) {
+        this.ensureInitialized();
+        const context = this.activeConversations.get(sessionId);
+        if (context) {
+            return [{ sessionId: context.sessionId, createdAt: context.createdAt }];
+        }
+        // Optionally, try loading from DB if not in memory to provide info
+        if (this.config.persistenceEnabled && this.storageAdapter) {
+            try {
+                const dbConvo = await this.storageAdapter.get('SELECT id, created_at FROM conversations WHERE id = ?', [sessionId]);
+                if (dbConvo) {
+                    return [{ sessionId: dbConvo.id, createdAt: dbConvo.created_at }];
+                }
+            }
+            catch (error) {
+                console.error(`ConversationManager (ID: ${this.managerId}): Error fetching conversation info for ${sessionId}:`, error);
+            }
+        }
+        return [];
+    }
+    /**
+     * Gets the last active time for a conversation, typically the timestamp of the last message or update.
+     * Checks in-memory cache first, then persistent storage if enabled.
+     *
+     * @public
+     * @async
+     * @param {string} conversationId - The ID of the conversation.
+     * @returns {Promise<number | undefined>} Timestamp of last activity (Unix epoch ms), or undefined if not found.
+     */
+    async getLastActiveTimeForConversation(conversationId) {
+        this.ensureInitialized();
+        const context = this.activeConversations.get(conversationId);
+        if (context) {
+            const lastMessage = context.getLastMessage();
+            return lastMessage?.timestamp || context.createdAt;
+        }
+        if (this.config.persistenceEnabled && this.storageAdapter) {
+            try {
+                const convo = await this.storageAdapter.get('SELECT updated_at FROM conversations WHERE id = ?', [conversationId]);
+                return convo?.updated_at;
+            }
+            catch (error) {
+                console.error(`ConversationManager (ID: ${this.managerId}): Error fetching 'updated_at' for conversation ${conversationId} from DB:`, error);
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Evicts the oldest (Least Recently Used based on `_lastAccessed` metadata)
+     * conversation from the in-memory cache.
+     * If persistence is enabled, ensures the conversation is saved to DB before eviction.
+     * @private
+     * @async
+     */
+    async evictOldestConversation() {
+        if (this.activeConversations.size === 0)
+            return;
+        let oldestSessionId;
+        let oldestTimestamp = Infinity;
+        for (const [sessionId, context] of this.activeConversations.entries()) {
+            const lastAccessed = context.getMetadata('_lastAccessed') || context.createdAt;
+            if (lastAccessed < oldestTimestamp) {
+                oldestTimestamp = lastAccessed;
+                oldestSessionId = sessionId;
+            }
+        }
+        if (oldestSessionId) {
+            const contextToEvict = this.activeConversations.get(oldestSessionId);
+            console.warn(`ConversationManager (ID: ${this.managerId}): Max in-memory conversations reached (${this.activeConversations.size}/${this.config.maxActiveConversationsInMemory}). Evicting conversation ${oldestSessionId}. Last accessed: ${new Date(oldestTimestamp).toISOString()}`);
+            if (contextToEvict && this.config.persistenceEnabled && this.storageAdapter) {
+                try {
+                    await this.saveConversationToDB(contextToEvict);
+                    console.log(`ConversationManager (ID: ${this.managerId}): Successfully saved conversation ${oldestSessionId} to DB before eviction.`);
+                }
+                catch (error) {
+                    console.error(`ConversationManager (ID: ${this.managerId}): Failed to save conversation ${oldestSessionId} to DB before eviction. Data might be lost if not already persisted. Error:`, error);
+                }
+            }
+            this.activeConversations.delete(oldestSessionId);
+        }
+    }
+    /**
+     * Saves a ConversationContext to the database using StorageAdapter.
+     * This is an upsert operation: creates if not exists, updates if exists.
+     * Handles serialization of messages and metadata within a transaction.
+     *
+     * @async
+     * @private
+     * @param {ConversationContext} context - The ConversationContext to save.
+     * @throws {GMIError} If the database operation fails.
+     */
+    async saveConversationToDB(context) {
+        if (!this.storageAdapter || !this.config.persistenceEnabled)
+            return;
+        const contextJSON = context.toJSON();
+        try {
+            await this.storageAdapter.transaction(async (tx) => {
+                const now = Date.now();
+                const conversationData = {
+                    id: context.sessionId,
+                    user_id: context.userId,
+                    gmi_instance_id: context.gmiInstanceId || null,
+                    title: contextJSON.sessionMetadata?.title || `Conversation from ${new Date(context.createdAt).toLocaleDateString()}`,
+                    language: context.currentLanguage || null,
+                    session_details: JSON.stringify(contextJSON.sessionMetadata || {}),
+                    is_archived: contextJSON.sessionMetadata?.isArchived ? 1 : 0,
+                    tags: JSON.stringify(contextJSON.sessionMetadata?.tags || []),
+                    created_at: context.createdAt,
+                    updated_at: now,
+                };
+                // Upsert conversation (cross-platform compatible)
+                // Check if exists first, then INSERT or UPDATE
+                const existing = await tx.get('SELECT created_at FROM conversations WHERE id = ?', [conversationData.id]);
+                const finalCreatedAt = existing?.created_at || conversationData.created_at;
+                if (existing) {
+                    // Update existing (works on all databases)
+                    await tx.run(`UPDATE conversations SET
+             user_id = ?, gmi_instance_id = ?, title = ?, language = ?, session_details = ?,
+             is_archived = ?, tags = ?, updated_at = ?
+             WHERE id = ?`, [
+                        conversationData.user_id,
+                        conversationData.gmi_instance_id,
+                        conversationData.title,
+                        conversationData.language,
+                        conversationData.session_details,
+                        conversationData.is_archived,
+                        conversationData.tags,
+                        conversationData.updated_at,
+                        conversationData.id,
+                    ]);
+                }
+                else {
+                    // Insert new (works on all databases)
+                    await tx.run(`INSERT INTO conversations (id, user_id, gmi_instance_id, title, language, session_details, is_archived, tags, created_at, updated_at)
+             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                        conversationData.id,
+                        conversationData.user_id,
+                        conversationData.gmi_instance_id,
+                        conversationData.title,
+                        conversationData.language,
+                        conversationData.session_details,
+                        conversationData.is_archived,
+                        conversationData.tags,
+                        finalCreatedAt,
+                        conversationData.updated_at,
+                    ]);
+                }
+                // Delete old messages
+                await tx.run('DELETE FROM conversation_messages WHERE conversation_id = ?', [context.sessionId]);
+                // Insert new messages
+                if (contextJSON.messages && contextJSON.messages.length > 0) {
+                    for (const msg of contextJSON.messages) {
+                        const messageId = msg.id || `msg_${uuidv4()}`;
+                        await tx.run(`INSERT INTO conversation_messages (
+                id, conversation_id, role, content, timestamp, tool_calls, tool_call_id,
+                multimodal_data, audio_url, audio_transcript, voice_settings, metadata
+              ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                            messageId,
+                            context.sessionId,
+                            msg.role.toString(),
+                            typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content),
+                            msg.timestamp,
+                            msg.tool_calls ? JSON.stringify(msg.tool_calls) : null,
+                            msg.tool_call_id || null,
+                            msg.multimodalData ? JSON.stringify(msg.multimodalData) : null,
+                            msg.audioUrl || null,
+                            msg.audioTranscript || null,
+                            msg.voiceSettings ? JSON.stringify(msg.voiceSettings) : null,
+                            JSON.stringify(msg.metadata || {}),
+                        ]);
+                    }
+                }
+            });
+        }
+        catch (error) {
+            console.error(`ConversationManager (ID: ${this.managerId}): Error saving conversation ${context.sessionId} to DB: ${error.message}`, error);
+            throw new GMIError(`Failed to save conversation ${context.sessionId} to database.`, GMIErrorCode.DATABASE_ERROR, { underlyingError: error.message, stack: error.stack });
+        }
+    }
+    /**
+     * Loads a ConversationContext from the database using StorageAdapter.
+     * Reconstructs the ConversationContext instance along with its messages and metadata.
+     *
+     * @async
+     * @private
+     * @param {string} conversationId - The ID of the conversation to load.
+     * @returns {Promise<ConversationContext | undefined>} The loaded ConversationContext or undefined if not found.
+     * @throws {GMIError} If the database operation fails or data inconsistency is detected.
+     */
+    async loadConversationFromDB(conversationId) {
+        if (!this.storageAdapter || !this.config.persistenceEnabled)
+            return undefined;
+        try {
+            const convoData = await this.storageAdapter.get('SELECT * FROM conversations WHERE id = ?', [conversationId]);
+            if (!convoData)
+                return undefined;
+            const messages = await this.storageAdapter.all('SELECT * FROM conversation_messages WHERE conversation_id = ? ORDER BY timestamp ASC', [conversationId]);
+            const internalMessages = messages.map((dbMsg) => {
+                let parsedContent;
+                try {
+                    if (dbMsg.content && ((dbMsg.content.startsWith('{') && dbMsg.content.endsWith('}')) || (dbMsg.content.startsWith('[') && dbMsg.content.endsWith(']')))) {
+                        parsedContent = JSON.parse(dbMsg.content);
+                    }
+                    else {
+                        parsedContent = dbMsg.content;
+                    }
+                }
+                catch {
+                    console.warn(`ConversationManager (ID: ${this.managerId}): Failed to parse content for message ${dbMsg.id} from DB as JSON, using as string.`);
+                    parsedContent = dbMsg.content;
+                }
+                const messageOptions = {
+                    tool_calls: dbMsg.tool_calls ? JSON.parse(dbMsg.tool_calls) : undefined,
+                    tool_call_id: dbMsg.tool_call_id || undefined,
+                    metadata: dbMsg.metadata ? JSON.parse(dbMsg.metadata) : undefined,
+                    ...(dbMsg.multimodal_data && { multimodalData: JSON.parse(dbMsg.multimodal_data) }),
+                    ...(dbMsg.audio_url && { audioUrl: dbMsg.audio_url }),
+                    ...(dbMsg.audio_transcript && { audioTranscript: dbMsg.audio_transcript }),
+                    ...(dbMsg.voice_settings && { voiceSettings: JSON.parse(dbMsg.voice_settings) }),
+                };
+                return createConversationMessage(dbMsg.role, parsedContent, {
+                    ...messageOptions,
+                    id: dbMsg.id,
+                    timestamp: dbMsg.timestamp,
+                });
+            });
+            const sessionMetadataFromDB = JSON.parse(convoData.session_details || '{}');
+            const contextSpecificConfig = sessionMetadataFromDB.contextConfigOverrides || {};
+            const finalContextConfig = {
+                ...this.config.defaultConversationContextConfig,
+                userId: convoData.user_id || this.config.defaultConversationContextConfig?.userId,
+                gmiInstanceId: convoData.gmi_instance_id || this.config.defaultConversationContextConfig?.gmiInstanceId,
+                activePersonaId: sessionMetadataFromDB.activePersonaId || this.config.defaultConversationContextConfig?.activePersonaId,
+                utilityAI: this.utilityAIService,
+                ...contextSpecificConfig,
+            };
+            const context = ConversationContext.fromJSON({
+                sessionId: convoData.id,
+                createdAt: convoData.created_at,
+                messages: internalMessages,
+                config: {
+                    ...finalContextConfig,
+                    utilityAIServiceId: this.utilityAIService?.utilityId,
+                },
+                sessionMetadata: sessionMetadataFromDB,
+            }, (serviceId) => {
+                if (this.utilityAIService && serviceId === this.utilityAIService.utilityId) {
+                    return this.utilityAIService;
+                }
+                if (serviceId && (!this.utilityAIService || serviceId !== this.utilityAIService.utilityId)) {
+                    console.warn(`ConversationManager (ID: ${this.managerId}): Conversation ${conversationId} stored utilityAIServiceId '${serviceId}' which differs from current or is unavailable.`);
+                }
+                return this.utilityAIService;
+            });
+            console.log(`ConversationManager (ID: ${this.managerId}): Conversation ${conversationId} loaded from DB with ${internalMessages.length} messages.`);
+            return context;
+        }
+        catch (error) {
+            console.error(`ConversationManager (ID: ${this.managerId}): Error loading conversation ${conversationId} from DB: ${error.message}`, error);
+            throw new GMIError(`Failed to load conversation ${conversationId} from database.`, GMIErrorCode.DATABASE_ERROR, { underlyingError: error.message, stack: error.stack });
+        }
+    }
+    /**
+     * Shuts down the ConversationManager.
+     * If persistence is enabled, ensures all active conversations are saved to the database.
+     * Clears the in-memory cache of conversations.
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    async shutdown() {
+        if (!this.initialized) {
+            console.warn(`ConversationManager (ID: ${this.managerId}) shutdown called but was not initialized.`);
+            return;
+        }
+        console.log(`ConversationManager (ID: ${this.managerId}): Shutting down...`);
+        if (this.config.persistenceEnabled && this.storageAdapter) {
+            console.log(`ConversationManager (ID: ${this.managerId}): Saving all active conversations (${this.activeConversations.size}) before shutdown...`);
+            let savedCount = 0;
+            for (const context of this.activeConversations.values()) {
+                try {
+                    await this.saveConversationToDB(context);
+                    savedCount++;
+                }
+                catch (error) {
+                    console.error(`ConversationManager (ID: ${this.managerId}): Error saving conversation ${context.sessionId} during shutdown:`, error);
+                }
+            }
+            console.log(`ConversationManager (ID: ${this.managerId}): ${savedCount} active conversations processed for saving.`);
+        }
+        this.activeConversations.clear();
+        this.initialized = false;
+        console.log(`ConversationManager (ID: ${this.managerId}): Shutdown complete. In-memory cache cleared.`);
+    }
+}
+//# sourceMappingURL=ConversationManager.js.map

package/dist/core/conversation/ConversationManager.js.map

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