@astermind/cybernetic-chatbot-client 1.0.9 → 2.2.3

package/README.md

@@ -29,9 +29,11 @@ Cybernetic Chatbot Client is the official JavaScript SDK for integrating [AsterM
 - [Configuration](#configuration)
 - [Features](#features)
   - [Offline-First Architecture](#offline-first-architecture)
+  - [Pre-computed Vector Export (Advanced)](#pre-computed-vector-export-advanced)
   - [Streaming Responses](#streaming-responses)
   - [Session Management](#session-management)
   - [Agentic Capabilities](#agentic-capabilities)
+  - [Sitemap Configuration](#sitemap-configuration)
   - [Maintenance Mode Support](#maintenance-mode-support)
 - [Bundle Options](#bundle-options)
 - [API Reference](#api-reference)
@@ -367,6 +369,12 @@ interface CyberneticConfig {
 
   /** Agentic capabilities configuration (requires full bundle) */
   agentic?: AgenticConfig;
+
+  /** Offline vector export configuration (see Pre-computed Vector Export section) */
+  offline?: OfflineConfig;
+
+  /** Sitemap configuration for agentic navigation (see Sitemap Configuration section) */
+  sitemap?: SiteMapConfig;
 }
 
 type ConnectionStatus = 'online' | 'offline' | 'connecting' | 'error';
@@ -438,6 +446,134 @@ await client.clearCache();
 
 **Cache Validation**: The server controls cache retention via `cacheRetentionHours` (default: 168 hours / 7 days). The client respects this setting and marks responses as stale when appropriate.
 
+### Pre-computed Vector Export (Advanced)
+
+For enhanced offline performance, the client supports loading pre-computed TF-IDF vectors exported from the AsterMind admin panel. This eliminates client-side vector computation and provides faster, more consistent offline search results.
+
+#### Exporting Vectors from Admin
+
+1. Navigate to your AsterMind admin panel
+2. Go to **Settings > Vector Export** (or **Documents > Export**)
+3. Click **Export Vectors for Offline Use**
+4. Download the JSON export file or note the export URL
+
+The export file contains pre-computed TF-IDF vectors, document metadata, and optionally sitemap and category information for agentic navigation.
+
+#### Configuring Offline Vectors
+
+```typescript
+import { CyberneticClient } from '@astermind/cybernetic-chatbot-client';
+
+const client = new CyberneticClient({
+  apiUrl: 'https://api.astermind.ai',
+  apiKey: 'am_your_api_key',
+
+  // Offline vector configuration
+  offline: {
+    enabled: true,
+    vectorFileUrl: 'https://your-cdn.com/vectors/export.json',  // URL to exported vectors
+    storageMode: 'indexeddb',  // 'memory' | 'indexeddb' | 'hybrid'
+    maxCacheAge: 604800000,    // 7 days in milliseconds
+    autoRefresh: true,         // Auto-refresh when new export available
+
+    // Optional: Omega advanced RAG (requires @astermind/astermind-community)
+    omega: {
+      enabled: true,
+      modelUrl: 'https://your-cdn.com/models/omega-model.json'
+    }
+  }
+});
+```
+
+#### Inline Vector Data
+
+You can also provide vector data directly in the configuration:
+
+```typescript
+const client = new CyberneticClient({
+  apiUrl: 'https://api.astermind.ai',
+  apiKey: 'am_your_api_key',
+  offline: {
+    enabled: true,
+    vectorData: exportedVectorObject,  // Loaded from file or bundled
+    storageMode: 'memory'
+  }
+});
+```
+
+#### Offline Configuration Options
+
+```typescript
+interface OfflineConfig {
+  /** Enable offline vector support */
+  enabled: boolean;
+
+  /** URL to fetch vector export JSON */
+  vectorFileUrl?: string;
+
+  /** Inline vector data (alternative to URL) */
+  vectorData?: OfflineVectorExport;
+
+  /** Storage mode for cached vectors */
+  storageMode?: 'memory' | 'indexeddb' | 'hybrid';
+
+  /** Maximum cache age in milliseconds (default: 7 days) */
+  maxCacheAge?: number;
+
+  /** Auto-refresh vectors when new export available */
+  autoRefresh?: boolean;
+
+  /** Omega advanced RAG configuration */
+  omega?: {
+    enabled: boolean;
+    modelUrl?: string;
+    modelData?: SerializedModel;
+    config?: {
+      topK?: number;
+      rerankerTopK?: number;
+      minScore?: number;
+    };
+  };
+}
+```
+
+#### Checking Offline Status
+
+```typescript
+// Get local RAG status
+const ragStatus = client.getLocalRAGStatus();
+console.log(ragStatus);
+// {
+//   loaded: true,
+//   loadedFromExport: true,
+//   documentCount: 150,
+//   chunkCount: 1200,
+//   exportVersion: '1.0.0',
+//   exportedAt: '2024-01-15T10:30:00Z'
+// }
+
+// Check if Omega is enabled and ready
+if (client.isOmegaOfflineEnabled()) {
+  const modelInfo = client.getOfflineModelInfo();
+  console.log('Omega model:', modelInfo);
+}
+
+// Force reload vectors
+await client.reloadOfflineVectors();
+```
+
+#### Console Warning
+
+When `offline.enabled` is `true` but no vectors are loaded (missing URL, network error, or invalid data), the client logs a one-time console warning:
+
+```
+[CyberneticClient] Warning: Offline mode enabled but no vectors loaded.
+Configure 'offline.vectorFileUrl' or provide 'offline.vectorData' for offline support.
+Falling back to standard caching mode.
+```
+
+This helps identify configuration issues without disrupting functionality.
+
 ### Streaming Responses
 
 Real-time token streaming via Server-Sent Events (SSE):
@@ -571,6 +707,110 @@ const intent = classifier.classify('take me to the settings page');
 - **Rate Limiting**: Maximum actions per minute (default: 5)
 - **Confirmation Flow**: Optional user approval before action execution
 
+### Sitemap Configuration
+
+The sitemap enables intelligent navigation by mapping user intent to application routes. You can configure it statically or load it from the vector export:
+
+#### Static Sitemap Configuration
+
+```typescript
+const client = new CyberneticClient({
+  apiUrl: 'https://api.astermind.ai',
+  apiKey: 'am_your_api_key',
+
+  // Static sitemap configuration
+  sitemap: {
+    enabled: true,
+    entries: [
+      {
+        path: '/dashboard',
+        name: 'Dashboard',
+        description: 'Main dashboard with analytics',
+        aliases: ['home', 'main', 'overview'],
+        keywords: ['stats', 'metrics', 'analytics']
+      },
+      {
+        path: '/settings',
+        name: 'Settings',
+        description: 'User and application settings',
+        aliases: ['preferences', 'config', 'options'],
+        keywords: ['account', 'profile', 'configuration']
+      },
+      {
+        path: '/products',
+        name: 'Products',
+        description: 'Product catalog and management',
+        aliases: ['catalog', 'inventory'],
+        keywords: ['items', 'shop', 'store']
+      }
+    ]
+  }
+});
+```
+
+#### Loading Sitemap from Vector Export
+
+When using pre-computed vectors, the sitemap can be included in the export and loaded automatically:
+
+```typescript
+const client = new CyberneticClient({
+  apiUrl: 'https://api.astermind.ai',
+  apiKey: 'am_your_api_key',
+  offline: {
+    enabled: true,
+    vectorFileUrl: 'https://your-cdn.com/vectors/export.json'
+  },
+  sitemap: {
+    enabled: true,
+    loadFromExport: true  // Load sitemap from vector export
+  }
+});
+```
+
+#### Sitemap Configuration Options
+
+```typescript
+interface SiteMapConfig {
+  /** Enable sitemap-based navigation */
+  enabled: boolean;
+
+  /** Static sitemap entries */
+  entries?: SiteMapEntry[];
+
+  /** Load sitemap from vector export (requires offline.enabled) */
+  loadFromExport?: boolean;
+
+  /** URL to fetch sitemap JSON separately */
+  sitemapUrl?: string;
+}
+
+interface SiteMapEntry {
+  /** Route path (e.g., '/dashboard') */
+  path: string;
+
+  /** Display name */
+  name: string;
+
+  /** Description for context matching */
+  description?: string;
+
+  /** Alternative names/phrases */
+  aliases?: string[];
+
+  /** Related keywords for matching */
+  keywords?: string[];
+
+  /** Authentication required */
+  requiresAuth?: boolean;
+
+  /** Required user roles */
+  roles?: string[];
+
+  /** Child routes */
+  children?: SiteMapEntry[];
+}
+```
+
 ### Maintenance Mode Support
 
 The client handles backend maintenance mode gracefully (per ADR-200):

package/dist/CyberneticClient.d.ts

@@ -1,5 +1,6 @@
+import { CyberneticOfflineStorage } from './CyberneticOfflineStorage.js';
 import { LicenseManager } from './license/index.js';
-import type { CyberneticConfig, CyberneticResponse, CyberneticError, ConnectionStatus, AskOptions, StreamCallbacks, CacheStatus, SystemSettings, AgenticConfig } from './types.js';
+import type { CyberneticConfig, CyberneticResponse, CyberneticError, ConnectionStatus, AskOptions, StreamCallbacks, CacheStatus, SystemSettings, AgenticConfig, SourcesConfig } from './types.js';
 import type { LicenseState } from './license/types.js';
 /**
  * Interface for agentic capabilities registration
@@ -29,6 +30,9 @@ export declare class CyberneticClient {
     private readonly SETTINGS_CHECK_INTERVAL;
     private agenticCapabilities;
     private licenseManager;
+    private offlineStorage;
+    private omegaRAG;
+    private offlineWarningShown;
     constructor(config: CyberneticConfig);
     /**
      * Register agentic capabilities
@@ -54,6 +58,19 @@ export declare class CyberneticClient {
      * Get agentic configuration
      */
     getAgenticConfig(): AgenticConfig | null;
+    /**
+     * Get sources configuration
+     * Returns merged configuration with all defaults applied
+     */
+    getSourcesConfig(): SourcesConfig;
+    /**
+     * Check if a specific source feature is available
+     * Takes into account configuration, connection status, and requirements
+     *
+     * @param feature - The feature to check ('summary' or 'download')
+     * @returns Whether the feature is available
+     */
+    isSourceFeatureAvailable(feature: 'summary' | 'download'): boolean;
     /**
      * Classify user message intent for agentic action
      * Only works if agentic capabilities are registered and enabled
@@ -116,6 +133,46 @@ export declare class CyberneticClient {
             error?: string;
         };
     }>;
+    /**
+     * Initialize offline vector support
+     * Loads pre-exported vectors from URL or inline data
+     */
+    private initializeOffline;
+    /**
+     * Initialize Omega RAG module
+     */
+    private initializeOmega;
+    /**
+     * Manually reload offline vectors
+     * Clears cache and re-fetches from configured source
+     */
+    reloadOfflineVectors(): Promise<void>;
+    /**
+     * Check if Omega offline RAG is enabled and ready
+     */
+    isOmegaOfflineEnabled(): boolean;
+    /**
+     * Get offline model info (if Omega is loaded)
+     */
+    getOfflineModelInfo(): {
+        version: string;
+        savedAt: string;
+        documentCount: number;
+        vocabularySize: number;
+    } | null;
+    /**
+     * Get local RAG export status
+     */
+    getLocalRAGStatus(): {
+        loaded: boolean;
+        loadedFromExport: boolean;
+        documentCount: number;
+        exportVersion?: string;
+    };
+    /**
+     * Get offline storage instance for advanced operations
+     */
+    getOfflineStorage(): CyberneticOfflineStorage | null;
     /**
      * Send a message to the chatbot
      * Always returns a response, never throws
@@ -181,6 +238,7 @@ export declare class CyberneticClient {
     private apiWithRetry;
     /**
      * Fallback to local RAG processing
+     * Uses Omega RAG if available, falls back to simple TF-IDF
      */
     private fallbackAsk;
     /**

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":"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"}

package/dist/CyberneticLocalRAG.d.ts

@@ -1,4 +1,4 @@
-import type { CachedDocument } from './types.js';
+import type { CachedDocument, OfflineVectorExport } from './types.js';
 interface LocalRAGResult {
     answer: string;
     sources: Array<{
@@ -14,10 +14,22 @@ interface LocalRAGResult {
  * Provides offline fallback when backend is unavailable.
  * Uses simple TF-IDF for document matching (no vector embeddings).
  */
+export interface ExportStatus {
+    loaded: boolean;
+    loadedFromExport: boolean;
+    documentCount: number;
+    chunkCount: number;
+    exportVersion?: string;
+    exportedAt?: string;
+}
 export declare class CyberneticLocalRAG {
     private documents;
     private idf;
     private indexed;
+    private loadedFromExport;
+    private exportVersion?;
+    private exportedAt?;
+    private vocabulary;
     /**
      * Check if documents are indexed
      */
@@ -34,6 +46,17 @@ export declare class CyberneticLocalRAG {
      * Reset the index
      */
     reset(): void;
+    /**
+     * Load pre-computed vectors from an export file
+     * This skips client-side TF-IDF computation by using pre-computed values
+     *
+     * @param exportData - The offline vector export data
+     */
+    loadFromExport(exportData: OfflineVectorExport): Promise<void>;
+    /**
+     * Get export status information
+     */
+    getExportStatus(): ExportStatus;
     /**
      * Tokenize text into words
      */

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,MAAM,YAAY,CAAC;AAEjD,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,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,OAAO,CAAS;IAExB;;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;IAQb;;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;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"}

package/dist/CyberneticOfflineStorage.d.ts

@@ -0,0 +1,63 @@
+import type { OfflineVectorExport } from './types.js';
+export interface OfflineStorageMeta {
+    version: string;
+    exportedAt: string;
+    documentCount: number;
+    chunkCount: number;
+    type: 'general' | 'tenant' | 'combined';
+}
+/**
+ * IndexedDB storage for offline vector exports
+ * Provides persistent caching of pre-computed TF-IDF vectors
+ */
+export declare class CyberneticOfflineStorage {
+    private db;
+    private dbPromise;
+    private readonly dbName;
+    private readonly dbVersion;
+    /**
+     * Initialize IndexedDB for vector storage
+     */
+    private initDB;
+    /**
+     * Store vector export in IndexedDB
+     */
+    store(id: string, exportData: OfflineVectorExport): Promise<void>;
+    /**
+     * Retrieve vector export from IndexedDB
+     */
+    retrieve(id: string): Promise<OfflineVectorExport | null>;
+    /**
+     * Check if cached vectors are valid (not expired)
+     */
+    isValid(id: string, maxAge: number): Promise<boolean>;
+    /**
+     * Get cached export metadata without loading full data
+     */
+    getMeta(id: string): Promise<OfflineStorageMeta | null>;
+    /**
+     * Check if any cached vectors exist
+     */
+    hasData(): Promise<boolean>;
+    /**
+     * Get all cached export IDs
+     */
+    getStoredIds(): Promise<string[]>;
+    /**
+     * Clear specific cached vectors
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Clear all cached vectors
+     */
+    clear(): Promise<void>;
+    /**
+     * Get the database connection
+     */
+    private getDB;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=CyberneticOfflineStorage.d.ts.map

package/dist/CyberneticOfflineStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CyberneticOfflineStorage.d.ts","sourceRoot":"","sources":["../src/CyberneticOfflineStorage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAetD,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACjC,OAAO,CAAC,EAAE,CAA+C;IACzD,OAAO,CAAC,SAAS,CAAwD;IACzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAK;IAE/B;;OAEG;YACW,MAAM;IAqBpB;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvE;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAM/D;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3D;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAc7D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAMjC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;YACW,KAAK;IAOnB;;OAEG;IACH,KAAK,IAAI,IAAI;CAOhB"}

package/dist/agentic/CyberneticIntentClassifier.d.ts

@@ -1,4 +1,5 @@
 import type { IntentClassification, AgentConfig } from './types.js';
+import type { OfflineVectorExport, SiteMapConfig, CategoryDefinition } from '../types.js';
 /**
  * Intent classifier for agentic actions
  *
@@ -10,6 +11,8 @@ export declare class CyberneticIntentClassifier {
     private siteMapIndex;
     private formIndex;
     private modalIndex;
+    private categories;
+    private topicKeywords;
     constructor(config: AgentConfig);
     /**
      * Build search indexes from configuration
@@ -74,5 +77,42 @@ export declare class CyberneticIntentClassifier {
      * Get configuration
      */
     getConfig(): AgentConfig;
+    /**
+     * Train classifier from exported documents
+     * Extracts topics and keywords for better intent classification
+     *
+     * @param exportData - The offline vector export data
+     */
+    trainFromExport(exportData: OfflineVectorExport): Promise<void>;
+    /**
+     * Load sitemap from configuration
+     *
+     * @param config - Sitemap configuration with URL or inline data
+     */
+    loadSitemap(config: SiteMapConfig): Promise<void>;
+    /**
+     * Load sitemap entries into the index
+     */
+    private loadSitemapEntries;
+    /**
+     * Extract topics and keywords from document content
+     */
+    private extractTopicsFromDocuments;
+    /**
+     * Check if word is a stop word
+     */
+    private isStopWord;
+    /**
+     * Get loaded categories
+     */
+    getCategories(): CategoryDefinition[];
+    /**
+     * Get topic keywords
+     */
+    getTopicKeywords(): Map<string, string[]>;
+    /**
+     * Check if classifier has been trained
+     */
+    isTrained(): boolean;
 }
 //# sourceMappingURL=CyberneticIntentClassifier.d.ts.map

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;AAoCpB;;;;;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;gBAExC,MAAM,EAAE,WAAW;IAU/B;;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,gBAAgB;IA4BxB;;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;CAG3B"}
+{"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,EACrB,MAAM,aAAa,CAAC;AAoCrB;;;;;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;gBAE7C,MAAM,EAAE,WAAW;IAU/B;;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,gBAAgB;IA4BxB;;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;CAGvB"}