@astermind/cybernetic-chatbot-client 2.2.21 → 2.2.34

package/dist/CyberneticLocalRAG.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CyberneticLocalRAG.d.ts","sourceRoot":"","sources":["../src/CyberneticLocalRAG.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtE,UAAU,cAAc;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAkC;IAEpD;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CvD;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsDjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CpE;;OAEG;IACH,eAAe,IAAI,YAAY;IAa/B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,UAAU;CAarB"}
+{"version":3,"file":"CyberneticLocalRAG.d.ts","sourceRoot":"","sources":["../src/CyberneticLocalRAG.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtE,UAAU,cAAc;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAkC;IAEpD;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDvD;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsDjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CpE;;OAEG;IACH,eAAe,IAAI,YAAY;IAa/B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAWhB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,UAAU;CAarB"}

package/dist/CyberneticSessionStorage.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Session data structure stored in sessionStorage
+ */
+export interface StoredSession {
+    /** Session ID from backend API */
+    sessionId: string;
+    /** Timestamp when session was created/last updated */
+    updatedAt: number;
+    /** Optional conversation messages for UI restoration */
+    messages?: StoredMessage[];
+}
+/**
+ * Message structure for conversation history
+ */
+export interface StoredMessage {
+    /** Unique message ID */
+    id: string;
+    /** 'user' or 'assistant' */
+    role: 'user' | 'assistant';
+    /** Message content */
+    content: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Whether response was from offline fallback */
+    offline?: boolean;
+    /** Confidence level of response */
+    confidence?: 'high' | 'medium' | 'low' | 'none';
+}
+/**
+ * Configuration for session persistence
+ */
+export interface SessionStorageConfig {
+    /** Enable session persistence (default: true) */
+    enabled?: boolean;
+    /** Storage key prefix (default: 'astermind_session') */
+    storageKey?: string;
+    /** Session TTL in milliseconds (default: 30 minutes) */
+    sessionTtl?: number;
+    /** Persist conversation messages (default: true) */
+    persistMessages?: boolean;
+    /** Maximum messages to store (default: 50) */
+    maxMessages?: number;
+}
+/**
+ * Session storage manager for persisting chatbot sessions
+ *
+ * Uses sessionStorage to maintain conversation continuity across
+ * page navigations within the same browser session.
+ */
+export declare class CyberneticSessionStorage {
+    private config;
+    private cachedSession;
+    constructor(config?: SessionStorageConfig);
+    /**
+     * Check if sessionStorage is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Get the current session ID (if valid)
+     */
+    getSessionId(): string | null;
+    /**
+     * Get the full stored session (if valid)
+     */
+    getSession(): StoredSession | null;
+    /**
+     * Save/update session ID
+     */
+    saveSessionId(sessionId: string): void;
+    /**
+     * Add a message to the conversation history
+     */
+    addMessage(message: Omit<StoredMessage, 'id' | 'timestamp'>): void;
+    /**
+     * Get conversation messages
+     */
+    getMessages(): StoredMessage[];
+    /**
+     * Clear the stored session
+     */
+    clear(): void;
+    /**
+     * Start a new session (clears existing and optionally sets new ID)
+     */
+    startNewSession(sessionId?: string): void;
+    /**
+     * Check if we have a valid stored session
+     */
+    hasValidSession(): boolean;
+    /**
+     * Get session info for debugging/status
+     */
+    getSessionInfo(): {
+        hasSession: boolean;
+        sessionId: string | null;
+        messageCount: number;
+        lastUpdated: Date | null;
+        ttlRemaining: number | null;
+    };
+    /**
+     * Check if a session is still valid (not expired)
+     */
+    private isSessionValid;
+    /**
+     * Load session from sessionStorage
+     */
+    private loadFromStorage;
+    /**
+     * Save session to sessionStorage
+     */
+    private saveToStorage;
+    /**
+     * Generate a unique message ID
+     */
+    private generateMessageId;
+}
+//# sourceMappingURL=CyberneticSessionStorage.d.ts.map

package/dist/CyberneticSessionStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CyberneticSessionStorage.d.ts","sourceRoot":"","sources":["../src/CyberneticSessionStorage.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;;;;GAKG;AACH,qBAAa,wBAAwB;IACjC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,aAAa,CAA8B;gBAEvC,MAAM,CAAC,EAAE,oBAAoB;IASzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAatB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAO7B;;OAEG;IACH,UAAU,IAAI,aAAa,GAAG,IAAI;IAuBlC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IActC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI;IA0BlE;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE;IAO9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;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;IA6BD;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAG5B"}

package/dist/agentic/CyberneticIntentClassifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CyberneticIntentClassifier.d.ts","sourceRoot":"","sources":["../../src/agentic/CyberneticIntentClassifier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,oBAAoB,EAIpB,WAAW,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACR,mBAAmB,EACnB,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAoCzD;;;;;GAKG;AACH,qBAAa,0BAA0B;IACnC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,aAAa,CAAoC;IAEzD,8CAA8C;IAC9C,OAAO,CAAC,gBAAgB,CAAiC;IAEzD;;;;;;OAMG;gBACS,MAAM,EAAE,WAAW,EAAE,MAAM,GAAE,MAAW,EAAE,MAAM,GAAE,MAAW;IAmBzE;;OAEG;IACH,OAAO,CAAC,YAAY;IA6CpB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB;IA6C/C;;OAEG;IACH,OAAO,CAAC,WAAW;IAwLnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4BhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,SAAS,IAAI,WAAW;IAMxB;;;;;OAKG;IACG,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrE;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAiDlC;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IAIrC;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAIzC;;OAEG;IACH,SAAS,IAAI,OAAO;IAMpB;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAe1C;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAyCnC;;;;OAIG;IACH,cAAc,IAAI,OAAO;IAQzB;;;;;OAKG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOzC;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC;;;;OAIG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,IAAI;IAI9C;;;;OAIG;IACH,iBAAiB,IAAI,mBAAmB,EAAE;CAO7C"}
+{"version":3,"file":"CyberneticIntentClassifier.d.ts","sourceRoot":"","sources":["../../src/agentic/CyberneticIntentClassifier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,oBAAoB,EAIpB,WAAW,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACR,mBAAmB,EACnB,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAoCzD;;;;;GAKG;AACH,qBAAa,0BAA0B;IACnC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,aAAa,CAAoC;IAEzD,8CAA8C;IAC9C,OAAO,CAAC,gBAAgB,CAAiC;IAEzD;;;;;;OAMG;gBACS,MAAM,EAAE,WAAW,EAAE,MAAM,GAAE,MAAW,EAAE,MAAM,GAAE,MAAW;IAgCzE;;OAEG;IACH,OAAO,CAAC,YAAY;IA6CpB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB;IA6C/C;;OAEG;IACH,OAAO,CAAC,WAAW;IAwLnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4BhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,SAAS,IAAI,WAAW;IAMxB;;;;;OAKG;IACG,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrE;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAiDlC;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IAIrC;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAIzC;;OAEG;IACH,SAAS,IAAI,OAAO;IAMpB;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAe1C;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAyCnC;;;;OAIG;IACH,cAAc,IAAI,OAAO;IAQzB;;;;;OAKG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOzC;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC;;;;OAIG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,IAAI;IAI9C;;;;OAIG;IACH,iBAAiB,IAAI,mBAAmB,EAAE;CAO7C"}

package/dist/agentic/SiteMapDiscovery.d.ts

@@ -6,6 +6,9 @@ import type { AgenticSiteMapEntry, EnhancedSiteMapEntry, MultiSourceSiteMapConfi
  * 1. Static props (explicit configuration)
  * 2. Framework auto-discovery (React Router, Vue Router, etc.)
  * 3. Backend API (tenant-specific sitemaps)
+ *
+ * Zero-config mode: When agentic is enabled but no siteMapConfig provided,
+ * automatically discovers routes using smart defaults.
  */
 export declare class SiteMapDiscovery {
     private config;
@@ -17,6 +20,8 @@ export declare class SiteMapDiscovery {
     private backendCache;
     private isInitialized;
     private initPromise;
+    private detectedFramework;
+    private popstateHandler;
     constructor(config: MultiSourceSiteMapConfig, apiUrl: string, apiKey: string);
     /**
      * Initialize all sitemap sources
@@ -24,6 +29,42 @@ export declare class SiteMapDiscovery {
      */
     initialize(): Promise<void>;
     private performInitialization;
+    /**
+     * Wait for DOM to be ready before scanning
+     */
+    private waitForDOMReady;
+    /**
+     * Set up popstate listener to re-discover on SPA navigation
+     */
+    private setupPopstateListener;
+    /**
+     * Refresh discovery in background without blocking
+     */
+    private refreshInBackground;
+    /**
+     * Get localStorage cache key for current origin
+     */
+    private getCacheKey;
+    /**
+     * Load discovered entries from localStorage cache
+     */
+    private loadFromLocalStorage;
+    /**
+     * Save discovered entries to localStorage cache
+     */
+    private saveToLocalStorage;
+    /**
+     * Clear localStorage cache
+     */
+    clearCache(): void;
+    /**
+     * Dispose of resources (event listeners, etc.)
+     */
+    dispose(): void;
+    /**
+     * Get detected framework name
+     */
+    getDetectedFramework(): string;
     /**
      * Get merged sitemap entries with deduplication
      */
@@ -59,6 +100,7 @@ export declare class SiteMapDiscovery {
     private discoverAngularRoutes;
     /**
      * Discover routes by scanning DOM navigation elements
+     * Uses smart defaults when no selectors provided
      */
     private discoverFromDOM;
     private fetchFromBackend;

package/dist/agentic/SiteMapDiscovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SiteMapDiscovery.d.ts","sourceRoot":"","sources":["../../src/agentic/SiteMapDiscovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,mBAAmB,EACnB,oBAAoB,EAEpB,wBAAwB,EAE3B,MAAM,aAAa,CAAC;AAqBrB;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,cAAc,CAA8B;IAEpD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAA8B;gBAG7C,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;IAYlB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YASnB,qBAAqB;IAgCnC;;OAEG;IACH,gBAAgB,IAAI,oBAAoB,EAAE;IAQ1C;;OAEG;IACH,gBAAgB,IAAI,mBAAmB,EAAE;YAa3B,qBAAqB;IAoEnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA4B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,eAAe;YA0DT,gBAAgB;IAmE9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,OAAO,CAAC,YAAY;IA8DpB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAQtF"}
+{"version":3,"file":"SiteMapDiscovery.d.ts","sourceRoot":"","sources":["../../src/agentic/SiteMapDiscovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,mBAAmB,EACnB,oBAAoB,EAEpB,wBAAwB,EAE3B,MAAM,aAAa,CAAC;AA4GrB;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,cAAc,CAA8B;IAEpD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,eAAe,CAA6B;gBAGhD,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;IAclB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YASnB,qBAAqB;IAkDnC;;OAEG;YACW,eAAe;IAc7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;YACW,mBAAmB;IAejC;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,gBAAgB,IAAI,oBAAoB,EAAE;IAQ1C;;OAEG;IACH,gBAAgB,IAAI,mBAAmB,EAAE;YAa3B,qBAAqB;IAqEnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA4B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;;OAGG;IACH,OAAO,CAAC,eAAe;YAgFT,gBAAgB;IAmE9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,OAAO,CAAC,YAAY;IA8DpB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAQtF"}

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

@@ -640,6 +640,10 @@ class CyberneticLocalRAG {
         // Tokenize and build document frequency
         const docFreq = new Map();
         for (const doc of documents) {
+            // Skip documents without content
+            if (!doc.content) {
+                continue;
+            }
             const tokens = this.tokenize(doc.content);
             const uniqueTokens = new Set(tokens);
             // Count document frequency
@@ -790,6 +794,9 @@ class CyberneticLocalRAG {
      * Tokenize text into words
      */
     tokenize(text) {
+        if (!text || typeof text !== 'string') {
+            return [];
+        }
         return text
             .toLowerCase()
             .replace(/[^\w\s]/g, ' ')
@@ -2653,6 +2660,68 @@ function loadConfig(options = {}) {
 
 // src/agentic/SiteMapDiscovery.ts
 // Multi-source sitemap discovery and merging for agentic navigation
+// Zero-config mode: automatically discovers routes on any site
+// ==================== SMART DEFAULTS ====================
+/**
+ * Comprehensive default selectors that work on most sites
+ * Covers semantic HTML, common CSS patterns, and framework conventions
+ */
+const DEFAULT_NAV_SELECTORS = [
+    // Semantic HTML5 navigation
+    'nav a[href]',
+    '[role="navigation"] a[href]',
+    'header a[href]',
+    // Common CSS class patterns
+    '.nav a[href]',
+    '.navbar a[href]',
+    '.navigation a[href]',
+    '.sidebar a[href]',
+    '.side-nav a[href]',
+    '.sidenav a[href]',
+    '.menu a[href]',
+    '.main-menu a[href]',
+    '.top-menu a[href]',
+    // Data attributes
+    '[data-nav] a[href]',
+    '[data-menu] a[href]',
+    '[data-navigation] a[href]',
+    // ARIA patterns
+    '[aria-label*="navigation" i] a[href]',
+    '[aria-label*="menu" i] a[href]',
+    // Breadcrumbs
+    '[aria-label*="breadcrumb" i] a[href]',
+    '.breadcrumb a[href]',
+    '.breadcrumbs a[href]',
+    // Generic internal links (fallback - caught last)
+    'a[href^="/"]',
+];
+/**
+ * Default paths to exclude from discovery
+ * Covers common auth, API, and framework-internal routes
+ */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    // Authentication routes
+    '/login', '/logout', '/signin', '/signout', '/sign-in', '/sign-out',
+    '/register', '/signup', '/sign-up', '/forgot-password', '/reset-password',
+    '/auth/*', '/oauth/*', '/callback/*', '/sso/*',
+    // API and framework internals
+    '/api/*', '/_next/*', '/_nuxt/*', '/__*',
+    // Special links
+    'javascript:*', 'mailto:*', 'tel:*', '#*',
+];
+/**
+ * Default maximum number of links to scan from DOM
+ * Prevents performance issues on sites with many links
+ */
+const DEFAULT_MAX_DOM_LINKS = 200;
+/**
+ * Default cache TTL for localStorage (5 minutes)
+ */
+const DEFAULT_CACHE_TTL = 5 * 60 * 1000;
+/**
+ * Cache version - increment when cache format changes
+ */
+const CACHE_VERSION = '1';
 /**
  * Multi-source sitemap discovery and management
  *
@@ -2660,6 +2729,9 @@ function loadConfig(options = {}) {
  * 1. Static props (explicit configuration)
  * 2. Framework auto-discovery (React Router, Vue Router, etc.)
  * 3. Backend API (tenant-specific sitemaps)
+ *
+ * Zero-config mode: When agentic is enabled but no siteMapConfig provided,
+ * automatically discovers routes using smart defaults.
  */
 class SiteMapDiscovery {
     constructor(config, apiUrl, apiKey) {
@@ -2669,6 +2741,8 @@ class SiteMapDiscovery {
         this.backendCache = null;
         this.isInitialized = false;
         this.initPromise = null;
+        this.detectedFramework = 'generic';
+        this.popstateHandler = null;
         this.config = config;
         this.apiUrl = apiUrl;
         this.apiKey = apiKey;
@@ -2677,6 +2751,7 @@ class SiteMapDiscovery {
             this.staticEntries = this.enhanceEntries(config.static, 'props');
         }
     }
+    // ==================== INITIALIZATION ====================
     /**
      * Initialize all sitemap sources
      * Call this during widget initialization or first query based on loadStrategy
@@ -2691,8 +2766,19 @@ class SiteMapDiscovery {
         this.isInitialized = true;
     }
     async performInitialization() {
+        // Wait for DOM to be ready before discovery
+        await this.waitForDOMReady();
+        // Try to load from localStorage cache first
+        const cachedEntries = this.loadFromLocalStorage();
+        if (cachedEntries) {
+            this.discoveredEntries = cachedEntries;
+            console.log(`[SiteMapDiscovery] Loaded ${cachedEntries.length} entries from cache`);
+            // Still run discovery in background to refresh cache
+            this.refreshInBackground();
+            return;
+        }
         const tasks = [];
-        // Source 2: Framework auto-discovery
+        // Source 2: Framework auto-discovery (enabled by default)
         if (this.config.discovery?.enabled !== false) {
             tasks.push(this.discoverFromFramework());
         }
@@ -2706,6 +2792,8 @@ class SiteMapDiscovery {
                 const { entries, source } = result.value;
                 if (source === 'discovery') {
                     this.discoveredEntries = entries;
+                    // Save to localStorage
+                    this.saveToLocalStorage(entries);
                 }
                 else if (source === 'backend') {
                     this.backendEntries = entries;
@@ -2715,9 +2803,144 @@ class SiteMapDiscovery {
                 console.warn('[SiteMapDiscovery] Source failed:', result.reason);
             }
         }
+        // Set up popstate listener for SPA navigation
+        this.setupPopstateListener();
         const total = this.staticEntries.length + this.discoveredEntries.length + this.backendEntries.length;
         console.log(`[SiteMapDiscovery] Initialized with ${total} total entries (${this.staticEntries.length} static, ${this.discoveredEntries.length} discovered, ${this.backendEntries.length} backend)`);
     }
+    /**
+     * Wait for DOM to be ready before scanning
+     */
+    async waitForDOMReady() {
+        if (typeof document === 'undefined')
+            return;
+        if (document.readyState === 'complete' || document.readyState === 'interactive') {
+            // DOM is ready, but give frameworks a microtask to mount
+            await new Promise(resolve => setTimeout(resolve, 0));
+            return;
+        }
+        return new Promise((resolve) => {
+            document.addEventListener('DOMContentLoaded', () => resolve(), { once: true });
+        });
+    }
+    /**
+     * Set up popstate listener to re-discover on SPA navigation
+     */
+    setupPopstateListener() {
+        if (typeof window === 'undefined')
+            return;
+        this.popstateHandler = () => {
+            // Debounce re-discovery
+            setTimeout(() => {
+                this.refreshInBackground();
+            }, 100);
+        };
+        window.addEventListener('popstate', this.popstateHandler);
+    }
+    /**
+     * Refresh discovery in background without blocking
+     */
+    async refreshInBackground() {
+        try {
+            const result = await this.discoverFromFramework();
+            if (result.entries.length > 0) {
+                this.discoveredEntries = result.entries;
+                this.saveToLocalStorage(result.entries);
+            }
+        }
+        catch (error) {
+            // Silent fail for background refresh
+            console.debug('[SiteMapDiscovery] Background refresh failed:', error);
+        }
+    }
+    // ==================== LOCALSTORAGE CACHING ====================
+    /**
+     * Get localStorage cache key for current origin
+     */
+    getCacheKey() {
+        if (typeof window === 'undefined')
+            return 'astermind-sitemap';
+        return `astermind-sitemap-${window.location.origin}`;
+    }
+    /**
+     * Load discovered entries from localStorage cache
+     */
+    loadFromLocalStorage() {
+        if (typeof localStorage === 'undefined')
+            return null;
+        try {
+            const key = this.getCacheKey();
+            const cached = localStorage.getItem(key);
+            if (!cached)
+                return null;
+            const data = JSON.parse(cached);
+            // Check version
+            if (data.version !== CACHE_VERSION) {
+                localStorage.removeItem(key);
+                return null;
+            }
+            // Check TTL
+            const ttl = this.config.discovery?.cacheTtl ?? DEFAULT_CACHE_TTL;
+            if (Date.now() - data.timestamp > ttl) {
+                localStorage.removeItem(key);
+                return null;
+            }
+            this.detectedFramework = data.framework;
+            return data.entries;
+        }
+        catch (error) {
+            console.debug('[SiteMapDiscovery] Failed to load from cache:', error);
+            return null;
+        }
+    }
+    /**
+     * Save discovered entries to localStorage cache
+     */
+    saveToLocalStorage(entries) {
+        if (typeof localStorage === 'undefined')
+            return;
+        if (this.config.discovery?.cacheRoutes === false)
+            return;
+        try {
+            const key = this.getCacheKey();
+            const data = {
+                entries,
+                url: typeof window !== 'undefined' ? window.location.href : '',
+                timestamp: Date.now(),
+                framework: this.detectedFramework,
+                version: CACHE_VERSION
+            };
+            localStorage.setItem(key, JSON.stringify(data));
+        }
+        catch (error) {
+            // localStorage might be full or disabled
+            console.debug('[SiteMapDiscovery] Failed to save to cache:', error);
+        }
+    }
+    /**
+     * Clear localStorage cache
+     */
+    clearCache() {
+        if (typeof localStorage === 'undefined')
+            return;
+        localStorage.removeItem(this.getCacheKey());
+    }
+    // ==================== CLEANUP ====================
+    /**
+     * Dispose of resources (event listeners, etc.)
+     */
+    dispose() {
+        if (this.popstateHandler && typeof window !== 'undefined') {
+            window.removeEventListener('popstate', this.popstateHandler);
+            this.popstateHandler = null;
+        }
+    }
+    /**
+     * Get detected framework name
+     */
+    getDetectedFramework() {
+        return this.detectedFramework;
+    }
     /**
      * Get merged sitemap entries with deduplication
      */
@@ -2744,6 +2967,7 @@ class SiteMapDiscovery {
         try {
             // Detect framework if not specified
             const framework = config.framework || this.detectFramework();
+            this.detectedFramework = framework;
             let routes = [];
             switch (framework) {
                 case 'react-router':
@@ -2927,26 +3151,31 @@ class SiteMapDiscovery {
     }
     /**
      * Discover routes by scanning DOM navigation elements
+     * Uses smart defaults when no selectors provided
      */
     discoverFromDOM(selectors) {
         const routes = [];
         if (typeof document === 'undefined')
             return routes;
-        const defaultSelectors = [
-            'nav a[href]',
-            '[role="navigation"] a[href]',
-            '.nav a[href]',
-            '.navigation a[href]',
-            '.sidebar a[href]',
-            '.menu a[href]',
-            'header a[href]'
-        ];
-        const allSelectors = selectors || defaultSelectors;
+        // Use provided selectors or smart defaults
+        const allSelectors = selectors || DEFAULT_NAV_SELECTORS;
+        // Get max links limit from config or use default
+        const maxLinks = this.config.discovery?.maxDomLinks ?? DEFAULT_MAX_DOM_LINKS;
+        // Get exclude patterns (merge user-provided with defaults)
+        const userExcludes = this.config.discovery?.excludePaths || [];
+        const allExcludes = [...DEFAULT_EXCLUDE_PATTERNS, ...userExcludes];
         const seen = new Set();
+        let linkCount = 0;
         for (const selector of allSelectors) {
+            // Stop if we've hit the limit
+            if (linkCount >= maxLinks)
+                break;
             try {
                 const links = document.querySelectorAll(selector);
                 for (const link of links) {
+                    // Stop if we've hit the limit
+                    if (linkCount >= maxLinks)
+                        break;
                     const href = link.getAttribute('href');
                     if (!href)
                         continue;
@@ -2955,14 +3184,31 @@ class SiteMapDiscovery {
                         continue;
                     }
                     // Normalize path
-                    const path = href.startsWith('/') ? href : `/${href}`;
-                    // Skip duplicates, anchors, and special links
-                    if (seen.has(path) || path.startsWith('/#') || path === '/' || path.includes('javascript:')) {
-                        continue;
+                    let path = href;
+                    if (href.startsWith('http')) {
+                        try {
+                            path = new URL(href).pathname;
+                        }
+                        catch {
+                            continue;
+                        }
+                    }
+                    else if (!href.startsWith('/')) {
+                        path = `/${href}`;
                     }
-                    seen.add(path);
                     // Clean path (remove query string and hash)
                     const cleanPath = path.split('?')[0].split('#')[0];
+                    // Skip duplicates
+                    if (seen.has(cleanPath))
+                        continue;
+                    // Skip root path
+                    if (cleanPath === '/')
+                        continue;
+                    // Skip paths matching exclude patterns
+                    if (this.shouldExcludeRoute(cleanPath, allExcludes))
+                        continue;
+                    seen.add(cleanPath);
+                    linkCount++;
                     routes.push({
                         path: cleanPath,
                         name: link.textContent?.trim() || this.pathToName(cleanPath)
@@ -2973,6 +3219,7 @@ class SiteMapDiscovery {
                 // Invalid selector - skip
             }
         }
+        console.log(`[SiteMapDiscovery] DOM scan found ${routes.length} routes (limit: ${maxLinks})`);
         return routes;
     }
     // ==================== SOURCE 3: BACKEND API ====================
@@ -3260,9 +3507,18 @@ class CyberneticIntentClassifier {
         this.modalIndex = new Map();
         // Build indexes for fast lookup
         this.buildIndexes();
-        // Initialize multi-source sitemap discovery if configured
-        if (config.siteMapConfig) {
-            this.siteMapDiscovery = new SiteMapDiscovery(config.siteMapConfig, apiUrl, apiKey);
+        // Auto-enable sitemap discovery when agentic is enabled but no explicit config provided
+        // This enables zero-config mode: just set enabled: true and discovery works automatically
+        const siteMapConfig = config.siteMapConfig ?? (config.enabled && !config.siteMap?.length
+            ? { discovery: { enabled: true } }
+            : undefined);
+        // Initialize multi-source sitemap discovery
+        if (siteMapConfig) {
+            this.siteMapDiscovery = new SiteMapDiscovery(siteMapConfig, apiUrl, apiKey);
+            // Log zero-config mode activation
+            if (!config.siteMapConfig && config.enabled) {
+                console.log('[CyberneticIntentClassifier] Zero-config mode: auto-discovery enabled');
+            }
         }
     }
     /**