@astermind/cybernetic-chatbot-client 2.2.59 → 2.2.62

package/dist/CyberneticClient.d.ts

@@ -1,4 +1,5 @@
 import { CyberneticOfflineStorage } from './CyberneticOfflineStorage.js';
+import type { StoredMessage } from './CyberneticSessionStorage.js';
 import { LicenseManager } from './license/index.js';
 import type { CyberneticConfig, CyberneticResponse, CyberneticError, ConnectionStatus, AskOptions, StreamCallbacks, CacheStatus, SystemSettings, AgenticConfig, SourcesConfig } from './types.js';
 import type { LicenseState } from './license/types.js';
@@ -33,6 +34,7 @@ export declare class CyberneticClient {
     private licenseManager;
     private offlineStorage;
     private omegaRAG;
+    private sessionStorage;
     private offlineWarningShown;
     constructor(config: CyberneticConfig);
     /**
@@ -174,6 +176,35 @@ export declare class CyberneticClient {
      * Get offline storage instance for advanced operations
      */
     getOfflineStorage(): CyberneticOfflineStorage | null;
+    /**
+     * Get stored messages from a previous session for UI restoration.
+     * Call after construction to check for resumable conversations.
+     */
+    getStoredMessages(): StoredMessage[];
+    /**
+     * Check if a valid stored session exists that can be resumed.
+     */
+    hasStoredSession(): boolean;
+    /**
+     * Get session info for debugging/status display.
+     */
+    getSessionInfo(): {
+        hasSession: boolean;
+        sessionId: string | null;
+        messageCount: number;
+        lastUpdated: Date | null;
+        ttlRemaining: number | null;
+    };
+    /**
+     * Clear the stored session and start fresh.
+     * Use for "New Conversation" actions.
+     */
+    clearSession(): void;
+    /**
+     * Start a new session, clearing any stored data.
+     * Optionally sets a new sessionId immediately.
+     */
+    startNewSession(sessionId?: string): void;
     /**
      * Send a message to the chatbot
      * Always returns a response, never throws

package/dist/CyberneticClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CyberneticClient.d.ts","sourceRoot":"","sources":["../src/CyberneticClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CyberneticClient.d.ts","sourceRoot":"","sources":["../src/CyberneticClient.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EACR,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,aAAa,EAIb,aAAa,EAEhB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,iDAAiD;IAEjD,KAAK,EAAE,GAAG,CAAC;IACX,4DAA4D;IAE5D,gBAAgB,CAAC,EAAE,GAAG,CAAC;CAC1B;AA6BD;;;;;GAKG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAgC;IAGjD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IAGlD,OAAO,CAAC,mBAAmB,CAAoC;IAG/D,OAAO,CAAC,cAAc,CAAiB;IAGvC,OAAO,CAAC,cAAc,CAAyC;IAG/D,OAAO,CAAC,QAAQ,CAAgC;IAGhD,OAAO,CAAC,cAAc,CAA2B;IAGjD,OAAO,CAAC,mBAAmB,CAAS;gBAExB,MAAM,EAAE,gBAAgB;IAuFpC;;;;;;;;;;OAUG;IACH,eAAe,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI;IAKxD;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAW3B;;OAEG;IACH,sBAAsB,IAAI,mBAAmB,GAAG,IAAI;IAIpD;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAMxC;;;OAGG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;;;;;OAMG;IACH,wBAAwB,CAAC,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO;IAiBlE;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;QAC7B,MAAM,EAAE;YACJ,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACpC,GAAG,IAAI,CAAC;QACT,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,GAAG,IAAI;IAaR;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAeF;;;;;;;OAOG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;QAC3D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAC9B,MAAM,CAAC,EAAE;YACL,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACpC,CAAC;QACF,YAAY,CAAC,EAAE;YACX,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACL,CAAC;IA0BF;;;OAGG;YACW,iBAAiB;IA8E/B;;OAEG;YACW,eAAe;IA4B7B;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3C;;OAEG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;OAEG;IACH,mBAAmB,IAAI;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KAC1B,GAAG,IAAI;IAIR;;OAEG;IACH,iBAAiB,IAAI;QACjB,MAAM,EAAE,OAAO,CAAC;QAChB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KAC1B;IAID;;OAEG;IACH,iBAAiB,IAAI,wBAAwB,GAAG,IAAI;IAMpD;;;OAGG;IACH,iBAAiB,IAAI,aAAa,EAAE;IAIpC;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,cAAc,IAAI;QACd,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;QACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B;IAID;;;OAGG;IACH,YAAY,IAAI,IAAI;IAIpB;;;OAGG;IACH,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAMzC;;;;;;OAMG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsF7E;;;;;;OAMG;IACG,SAAS,CACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC;IAkFhB;;;OAGG;YACW,YAAY;IAoD1B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBhC;;OAEG;IACH,SAAS,IAAI;QACT,UAAU,EAAE,gBAAgB,CAAC;QAC7B,KAAK,EAAE,WAAW,CAAC;QACnB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;QAClC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;QACtC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;KAChC;IAUD;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAazC;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;IA8BlD;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,qBAAqB,IAAI,MAAM,GAAG,SAAS;IAI3C;;OAEG;IACH,YAAY,IAAI,OAAO;IAevB;;OAEG;YACW,YAAY;IAuC1B;;;OAGG;YACW,WAAW;IAgIzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGhB"}

package/dist/cybernetic-chatbot-client-full.esm.js

@@ -1374,6 +1374,230 @@ class WebSocketTransport {
     }
 }
 
+// src/CyberneticSessionStorage.ts
+// Session storage manager for persisting chatbot session across page navigations
+const DEFAULT_CONFIG = {
+    enabled: true,
+    storageKey: 'astermind_session',
+    sessionTtl: 30 * 60 * 1000, // 30 minutes
+    persistMessages: true,
+    maxMessages: 50
+};
+/**
+ * Session storage manager for persisting chatbot sessions
+ *
+ * Uses sessionStorage to maintain conversation continuity across
+ * page navigations within the same browser session.
+ */
+class CyberneticSessionStorage {
+    constructor(config) {
+        this.cachedSession = null;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // Load cached session on initialization
+        if (this.config.enabled && this.isAvailable()) {
+            this.cachedSession = this.loadFromStorage();
+        }
+    }
+    /**
+     * Check if sessionStorage is available
+     */
+    isAvailable() {
+        if (typeof window === 'undefined')
+            return false;
+        try {
+            const testKey = '__astermind_test__';
+            window.sessionStorage.setItem(testKey, 'test');
+            window.sessionStorage.removeItem(testKey);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get the current session ID (if valid)
+     */
+    getSessionId() {
+        if (!this.config.enabled)
+            return null;
+        const session = this.getSession();
+        return session?.sessionId ?? null;
+    }
+    /**
+     * Get the full stored session (if valid)
+     */
+    getSession() {
+        if (!this.config.enabled)
+            return null;
+        // Use cached session if available
+        if (this.cachedSession) {
+            if (this.isSessionValid(this.cachedSession)) {
+                return this.cachedSession;
+            }
+            // Session expired, clear it
+            this.clear();
+            return null;
+        }
+        // Try loading from storage
+        const session = this.loadFromStorage();
+        if (session && this.isSessionValid(session)) {
+            this.cachedSession = session;
+            return session;
+        }
+        return null;
+    }
+    /**
+     * Save/update session ID
+     */
+    saveSessionId(sessionId) {
+        if (!this.config.enabled || !sessionId)
+            return;
+        const existingSession = this.getSession();
+        const session = {
+            sessionId,
+            updatedAt: Date.now(),
+            messages: existingSession?.messages ?? []
+        };
+        this.saveToStorage(session);
+        this.cachedSession = session;
+    }
+    /**
+     * Add a message to the conversation history
+     */
+    addMessage(message) {
+        if (!this.config.enabled || !this.config.persistMessages)
+            return;
+        const session = this.getSession();
+        if (!session)
+            return;
+        const newMessage = {
+            ...message,
+            id: this.generateMessageId(),
+            timestamp: Date.now()
+        };
+        // Add new message and trim if necessary
+        session.messages = session.messages ?? [];
+        session.messages.push(newMessage);
+        // Keep only the most recent messages
+        if (session.messages.length > this.config.maxMessages) {
+            session.messages = session.messages.slice(-this.config.maxMessages);
+        }
+        session.updatedAt = Date.now();
+        this.saveToStorage(session);
+        this.cachedSession = session;
+    }
+    /**
+     * Get conversation messages
+     */
+    getMessages() {
+        if (!this.config.enabled || !this.config.persistMessages)
+            return [];
+        const session = this.getSession();
+        return session?.messages ?? [];
+    }
+    /**
+     * Clear the stored session
+     */
+    clear() {
+        this.cachedSession = null;
+        if (!this.isAvailable())
+            return;
+        try {
+            window.sessionStorage.removeItem(this.config.storageKey);
+        }
+        catch (error) {
+            console.warn('[CyberneticSessionStorage] Failed to clear session:', error);
+        }
+    }
+    /**
+     * Start a new session (clears existing and optionally sets new ID)
+     */
+    startNewSession(sessionId) {
+        this.clear();
+        if (sessionId) {
+            this.saveSessionId(sessionId);
+        }
+    }
+    /**
+     * Check if we have a valid stored session
+     */
+    hasValidSession() {
+        return this.getSession() !== null;
+    }
+    /**
+     * Get session info for debugging/status
+     */
+    getSessionInfo() {
+        const session = this.getSession();
+        if (!session) {
+            return {
+                hasSession: false,
+                sessionId: null,
+                messageCount: 0,
+                lastUpdated: null,
+                ttlRemaining: null
+            };
+        }
+        const ttlRemaining = Math.max(0, this.config.sessionTtl - (Date.now() - session.updatedAt));
+        return {
+            hasSession: true,
+            sessionId: session.sessionId,
+            messageCount: session.messages?.length ?? 0,
+            lastUpdated: new Date(session.updatedAt),
+            ttlRemaining
+        };
+    }
+    // ==================== PRIVATE METHODS ====================
+    /**
+     * Check if a session is still valid (not expired)
+     */
+    isSessionValid(session) {
+        const age = Date.now() - session.updatedAt;
+        return age < this.config.sessionTtl;
+    }
+    /**
+     * Load session from sessionStorage
+     */
+    loadFromStorage() {
+        if (!this.isAvailable())
+            return null;
+        try {
+            const stored = window.sessionStorage.getItem(this.config.storageKey);
+            if (!stored)
+                return null;
+            const session = JSON.parse(stored);
+            // Validate structure
+            if (!session.sessionId || typeof session.updatedAt !== 'number') {
+                return null;
+            }
+            return session;
+        }
+        catch (error) {
+            console.warn('[CyberneticSessionStorage] Failed to load session:', error);
+            return null;
+        }
+    }
+    /**
+     * Save session to sessionStorage
+     */
+    saveToStorage(session) {
+        if (!this.isAvailable())
+            return;
+        try {
+            window.sessionStorage.setItem(this.config.storageKey, JSON.stringify(session));
+        }
+        catch (error) {
+            console.warn('[CyberneticSessionStorage] Failed to save session:', error);
+        }
+    }
+    /**
+     * Generate a unique message ID
+     */
+    generateMessageId() {
+        return `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+
 // src/config.ts
 // Configuration loading and validation
 /** Default API URL when not specified */
@@ -2338,6 +2562,8 @@ class CyberneticClient {
             licenseKey: config.licenseKey,
             environment: config.environment,
         });
+        // Initialize session storage (auto-loads existing session from browser sessionStorage)
+        this.sessionStorage = new CyberneticSessionStorage(config.session);
         // Verify license asynchronously (non-blocking)
         this.licenseManager.verify().then(() => {
             // Check client feature after verification
@@ -2638,6 +2864,40 @@ class CyberneticClient {
     getOfflineStorage() {
         return this.offlineStorage;
     }
+    // ==================== SESSION PERSISTENCE METHODS (ADR-028) ====================
+    /**
+     * Get stored messages from a previous session for UI restoration.
+     * Call after construction to check for resumable conversations.
+     */
+    getStoredMessages() {
+        return this.sessionStorage.getMessages();
+    }
+    /**
+     * Check if a valid stored session exists that can be resumed.
+     */
+    hasStoredSession() {
+        return this.sessionStorage.hasValidSession();
+    }
+    /**
+     * Get session info for debugging/status display.
+     */
+    getSessionInfo() {
+        return this.sessionStorage.getSessionInfo();
+    }
+    /**
+     * Clear the stored session and start fresh.
+     * Use for "New Conversation" actions.
+     */
+    clearSession() {
+        this.sessionStorage.clear();
+    }
+    /**
+     * Start a new session, clearing any stored data.
+     * Optionally sets a new sessionId immediately.
+     */
+    startNewSession(sessionId) {
+        this.sessionStorage.startNewSession(sessionId);
+    }
     // ==================== CORE METHODS ====================
     /**
      * Send a message to the chatbot
@@ -2651,6 +2911,11 @@ class CyberneticClient {
         if (!message || typeof message !== 'string') {
             return this.createErrorResponse('Message is required', 'none');
         }
+        // Auto-resolve sessionId: explicit option > stored session > none (ADR-028)
+        const resolvedSessionId = options?.sessionId ?? this.sessionStorage.getSessionId() ?? undefined;
+        const resolvedOptions = resolvedSessionId
+            ? { ...options, sessionId: resolvedSessionId }
+            : options;
         // Check maintenance mode before API call (ADR-200)
         const settings = await this.checkSystemStatus();
         if (settings.maintenanceMode || settings.forceOfflineClients) {
@@ -2671,10 +2936,16 @@ class CyberneticClient {
         }
         // Try API first
         try {
-            const response = await this.apiWithRetry(message, options);
+            const response = await this.apiWithRetry(message, resolvedOptions);
             this.setStatus('online');
             // Process response through license manager (may add warning in production)
             const processedReply = this.licenseManager.processResponse(response.reply);
+            // Persist session state (ADR-028)
+            if (response.sessionId) {
+                this.sessionStorage.saveSessionId(response.sessionId);
+            }
+            this.sessionStorage.addMessage({ role: 'user', content: message });
+            this.sessionStorage.addMessage({ role: 'assistant', content: processedReply, confidence: 'high' });
             return {
                 reply: processedReply,
                 confidence: 'high',
@@ -2720,6 +2991,13 @@ class CyberneticClient {
             });
             return;
         }
+        // Auto-resolve sessionId: explicit option > stored session > none (ADR-028)
+        const resolvedSessionId = options?.sessionId ?? this.sessionStorage.getSessionId() ?? undefined;
+        const resolvedOptions = resolvedSessionId
+            ? { ...options, sessionId: resolvedSessionId }
+            : options;
+        // Save user message immediately (ADR-028)
+        this.sessionStorage.addMessage({ role: 'user', content: message });
         // Check maintenance mode before API call (ADR-200)
         const settings = await this.checkSystemStatus();
         if (settings.maintenanceMode || settings.forceOfflineClients) {
@@ -2732,14 +3010,19 @@ class CyberneticClient {
         if (this.wsTransport && this.config.transport !== 'rest') {
             try {
                 await this.wsTransport.chatStream(message, {
-                    sessionId: options?.sessionId,
-                    context: options?.context,
+                    sessionId: resolvedOptions?.sessionId,
+                    context: resolvedOptions?.context,
                     onToken: callbacks.onToken,
                     onSources: callbacks.onSources,
                     onComplete: (response) => {
                         this.setStatus('online');
                         // Process through license manager
                         const processedReply = this.licenseManager.processResponse(response.reply);
+                        // Persist session state (ADR-028)
+                        if (response.sessionId) {
+                            this.sessionStorage.saveSessionId(response.sessionId);
+                        }
+                        this.sessionStorage.addMessage({ role: 'assistant', content: processedReply, confidence: 'high' });
                         callbacks.onComplete?.({
                             ...response,
                             reply: processedReply
@@ -2749,7 +3032,7 @@ class CyberneticClient {
                         // In 'auto' mode, fall back to SSE on WS error
                         if (this.config.transport === 'auto') {
                             console.warn('[Cybernetic] WebSocket error, falling back to SSE:', error.message);
-                            this.streamViaSSE(message, callbacks, options);
+                            this.streamViaSSE(message, callbacks, resolvedOptions);
                         }
                         else {
                             // 'websocket' mode — no fallback
@@ -2775,7 +3058,7 @@ class CyberneticClient {
             }
         }
         // REST+SSE path (on-prem, or fallback from WebSocket)
-        await this.streamViaSSE(message, callbacks, options);
+        await this.streamViaSSE(message, callbacks, resolvedOptions);
     }
     /**
      * Stream chat via REST+SSE (original transport).
@@ -2792,6 +3075,11 @@ class CyberneticClient {
                     this.setStatus('online');
                     // Process response through license manager (may add warning in production)
                     const processedReply = this.licenseManager.processResponse(data.fullText);
+                    // Persist session state (ADR-028)
+                    if (data.sessionId) {
+                        this.sessionStorage.saveSessionId(data.sessionId);
+                    }
+                    this.sessionStorage.addMessage({ role: 'assistant', content: processedReply, confidence: 'high' });
                     callbacks.onComplete?.({
                         reply: processedReply,
                         confidence: 'high',