@astermind/cybernetic-chatbot-client 1.0.6

package/dist/ApiClient.d.ts

@@ -0,0 +1,86 @@
+import type { Source, SystemSettings } from './types.js';
+interface ChatRequest {
+    sessionId?: string;
+    context?: {
+        currentPage?: string;
+        pageTitle?: string;
+    };
+}
+interface ChatResponse {
+    reply: string;
+    sessionId: string;
+    sources: Source[];
+    usage: {
+        tokensUsed: number;
+        quotaRemaining: {
+            minute: number;
+            day: number;
+        };
+    };
+}
+interface StreamCallbacks {
+    onToken?: (token: string) => void;
+    onSources?: (sources: Source[]) => void;
+    onComplete?: (data: {
+        fullText: string;
+        sessionId?: string;
+        sources?: Source[];
+    }) => void;
+    onError?: (error: Error) => void;
+}
+interface StatusResponse {
+    status: string;
+    apiKey: {
+        id: string;
+        scopes: string[];
+    };
+    quota: {
+        perMinute: {
+            limit: number;
+            remaining: number;
+        };
+        perDay: {
+            limit: number;
+            remaining: number;
+        };
+    };
+    systemSettings?: SystemSettings;
+}
+/**
+ * HTTP/SSE client for AsterMind backend
+ */
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    /**
+     * Send chat message and get complete response
+     */
+    chat(message: string, options?: ChatRequest): Promise<ChatResponse>;
+    /**
+     * Send chat message with streaming response via SSE
+     */
+    chatStream(message: string, options: ChatRequest & StreamCallbacks): Promise<void>;
+    /**
+     * Get general documents for caching
+     */
+    getGeneralDocs(since?: string | null): Promise<Array<{
+        id: string;
+        title: string;
+        content: string;
+        updatedAt: string;
+    }>>;
+    /**
+     * Get API status, quota, and system settings
+     */
+    getStatus(): Promise<StatusResponse>;
+    /**
+     * Health check (no auth required)
+     */
+    health(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=ApiClient.d.ts.map

package/dist/ApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiClient.d.ts","sourceRoot":"","sources":["../src/ApiClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzD,UAAU,WAAW;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED,UAAU,YAAY;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE;YACZ,MAAM,EAAE,MAAM,CAAC;YACf,GAAG,EAAE,MAAM,CAAC;SACf,CAAC;KACL,CAAC;CACL;AAED,UAAU,eAAe;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC;AAED,UAAU,cAAc;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzC,KAAK,EAAE;QACH,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAChD,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAChD,CAAC;IACF,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK3C;;OAEG;IACG,IAAI,CACN,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,YAAY,CAAC;IAsBxB;;OAEG;IACG,UAAU,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GAAG,eAAe,GACvC,OAAO,CAAC,IAAI,CAAC;IAuEhB;;OAEG;IACG,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QACvD,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAqBH;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAc1C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CASjE"}

package/dist/CyberneticCache.d.ts

@@ -0,0 +1,56 @@
+import type { CachedDocument, CacheStatus } from './types.js';
+interface CacheConfig {
+    storage: 'indexeddb' | 'localstorage';
+    maxAge: number;
+}
+/**
+ * Document cache for offline RAG fallback
+ */
+export declare class CyberneticCache {
+    private config;
+    private db;
+    private dbPromise;
+    private documentCount;
+    private lastSyncAt;
+    constructor(config: CacheConfig);
+    /**
+     * Load metadata from localStorage
+     */
+    private loadLocalStorageMetadata;
+    /**
+     * Initialize IndexedDB
+     */
+    private initDB;
+    /**
+     * Get database instance
+     */
+    private getDB;
+    /**
+     * Load cached metadata (count, last sync)
+     */
+    private loadMetadata;
+    /**
+     * Store documents in cache
+     */
+    store(documents: CachedDocument[]): Promise<void>;
+    /**
+     * Retrieve all cached documents
+     */
+    retrieve(): Promise<CachedDocument[]>;
+    /**
+     * Get last sync timestamp
+     */
+    getLastSync(): Promise<string | null>;
+    /**
+     * Get cache status
+     */
+    getStatus(): CacheStatus;
+    /**
+     * Clear all cached data
+     */
+    clear(): Promise<void>;
+    private storeLocalStorage;
+    private retrieveLocalStorage;
+}
+export {};
+//# sourceMappingURL=CyberneticCache.d.ts.map

package/dist/CyberneticCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CyberneticCache.d.ts","sourceRoot":"","sources":["../src/CyberneticCache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmB9D,UAAU,WAAW;IACjB,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,EAAE,CAAgD;IAC1D,OAAO,CAAC,SAAS,CAAyD;IAC1E,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAuB;gBAE7B,MAAM,EAAE,WAAW;IAW/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;OAEG;YACW,MAAM;IAsBpB;;OAEG;YACW,KAAK;IAMnB;;OAEG;YACW,YAAY;IAU1B;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BvD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAS3C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI3C;;OAEG;IACH,SAAS,IAAI,WAAW;IAaxB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,oBAAoB;CAQ/B"}

package/dist/CyberneticClient.d.ts

@@ -0,0 +1,207 @@
+import { LicenseManager } from './license/index.js';
+import type { CyberneticConfig, CyberneticResponse, CyberneticError, ConnectionStatus, AskOptions, StreamCallbacks, CacheStatus, SystemSettings, AgenticConfig } from './types.js';
+import type { LicenseState } from './license/types.js';
+/**
+ * Interface for agentic capabilities registration
+ * Used by registerAgenticCapabilities() helper from agentic module
+ */
+export interface AgenticCapabilities {
+    /** CyberneticAgent class for DOM interactions */
+    agent: any;
+    /** CyberneticIntentClassifier class for intent detection */
+    intentClassifier?: any;
+}
+/**
+ * Cybernetic Chatbot Client
+ *
+ * Provides API access to AsterMind backend with offline fallback.
+ * Always returns a response, never throws exceptions.
+ */
+export declare class CyberneticClient {
+    private config;
+    private apiClient;
+    private cache;
+    private localRAG;
+    private status;
+    private lastError;
+    private systemSettings;
+    private settingsLastChecked;
+    private readonly SETTINGS_CHECK_INTERVAL;
+    private agenticCapabilities;
+    private licenseManager;
+    constructor(config: CyberneticConfig);
+    /**
+     * Register agentic capabilities
+     * Called by registerAgenticCapabilities() helper from agentic module
+     *
+     * @example
+     * ```typescript
+     * import { CyberneticClient, registerAgenticCapabilities } from '@astermind/cybernetic-chatbot-client';
+     * const client = new CyberneticClient(config);
+     * registerAgenticCapabilities(client);
+     * ```
+     */
+    registerAgentic(capabilities: AgenticCapabilities): void;
+    /**
+     * Check if agentic capabilities are available and enabled
+     */
+    isAgenticEnabled(): boolean;
+    /**
+     * Get registered agentic capabilities (for advanced use)
+     */
+    getAgenticCapabilities(): AgenticCapabilities | null;
+    /**
+     * Get agentic configuration
+     */
+    getAgenticConfig(): AgenticConfig | null;
+    /**
+     * Classify user message intent for agentic action
+     * Only works if agentic capabilities are registered and enabled
+     *
+     * @param message - User's message to classify
+     * @returns Intent classification or null if agentic not available
+     */
+    classifyIntent(message: string): {
+        action: {
+            id: string;
+            type: string;
+            target: string;
+            confidence: number;
+            explanation?: string;
+            params?: Record<string, unknown>;
+        } | null;
+        shouldEscalate: boolean;
+        rawConfidence: number;
+        matchedPatterns?: string[];
+    } | null;
+    /**
+     * Execute an agent action
+     * Only works if agentic capabilities are registered and enabled
+     *
+     * @param action - Action to execute
+     * @returns Action result or error
+     */
+    executeAction(action: {
+        id: string;
+        type: string;
+        target: string;
+        confidence: number;
+        params?: Record<string, unknown>;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        error?: string;
+    }>;
+    /**
+     * Smart ask - checks for action intent first, then falls back to RAG
+     * Combines agentic classification with standard RAG query
+     *
+     * @param message - User's message
+     * @param options - Optional request configuration
+     * @returns Object containing response, action, and/or action result
+     */
+    smartAsk(message: string, options?: AskOptions): Promise<{
+        response?: CyberneticResponse;
+        action?: {
+            id: string;
+            type: string;
+            target: string;
+            confidence: number;
+            explanation?: string;
+            params?: Record<string, unknown>;
+        };
+        actionResult?: {
+            success: boolean;
+            message: string;
+            error?: string;
+        };
+    }>;
+    /**
+     * Send a message to the chatbot
+     * Always returns a response, never throws
+     *
+     * @param message - User's message
+     * @param options - Optional request configuration
+     */
+    ask(message: string, options?: AskOptions): Promise<CyberneticResponse>;
+    /**
+     * Send a message with streaming response
+     *
+     * @param message - User's message
+     * @param callbacks - Streaming event callbacks
+     * @param options - Optional request configuration
+     */
+    askStream(message: string, callbacks: StreamCallbacks, options?: AskOptions): Promise<void>;
+    /**
+     * Sync documents to local cache for offline use
+     */
+    syncCache(): Promise<void>;
+    /**
+     * Get current connection status including system settings
+     */
+    getStatus(): {
+        connection: ConnectionStatus;
+        cache: CacheStatus;
+        lastError: CyberneticError | null;
+        systemSettings: SystemSettings | null;
+        license: LicenseState | null;
+    };
+    /**
+     * Get license manager for advanced license operations
+     */
+    getLicenseManager(): LicenseManager;
+    /**
+     * Clear local cache
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Manually check if backend is reachable
+     */
+    checkConnection(): Promise<boolean>;
+    /**
+     * Check system status including maintenance mode
+     * Called periodically and before API calls
+     */
+    checkSystemStatus(): Promise<SystemSettings>;
+    /**
+     * Check if maintenance mode is active
+     */
+    isMaintenanceMode(): boolean;
+    /**
+     * Get maintenance message if in maintenance mode
+     */
+    getMaintenanceMessage(): string | undefined;
+    /**
+     * Validate cache using server-configured retention hours
+     */
+    isCacheValid(): boolean;
+    /**
+     * API call with retry logic
+     */
+    private apiWithRetry;
+    /**
+     * Fallback to local RAG processing
+     */
+    private fallbackAsk;
+    /**
+     * Monitor browser online/offline events
+     */
+    private monitorConnection;
+    /**
+     * Update connection status and notify listeners
+     */
+    private setStatus;
+    /**
+     * Normalize various error types to CyberneticError
+     */
+    private normalizeError;
+    /**
+     * Create standardized error response
+     */
+    private createErrorResponse;
+    /**
+     * Async sleep utility
+     */
+    private sleep;
+}
+//# sourceMappingURL=CyberneticClient.d.ts.map

package/dist/CyberneticClient.d.ts.map

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

package/dist/CyberneticLocalRAG.d.ts

@@ -0,0 +1,59 @@
+import type { CachedDocument } from './types.js';
+interface LocalRAGResult {
+    answer: string;
+    sources: Array<{
+        title: string;
+        snippet: string;
+        score: number;
+    }>;
+    topScore: number;
+}
+/**
+ * Local RAG engine using TF-IDF similarity
+ *
+ * Provides offline fallback when backend is unavailable.
+ * Uses simple TF-IDF for document matching (no vector embeddings).
+ */
+export declare class CyberneticLocalRAG {
+    private documents;
+    private idf;
+    private indexed;
+    /**
+     * Check if documents are indexed
+     */
+    isIndexed(): boolean;
+    /**
+     * Index documents for local search
+     */
+    index(documents: CachedDocument[]): Promise<void>;
+    /**
+     * Process query and generate response
+     */
+    ask(query: string): Promise<LocalRAGResult>;
+    /**
+     * Reset the index
+     */
+    reset(): void;
+    /**
+     * Tokenize text into words
+     */
+    private tokenize;
+    /**
+     * Compute term frequency
+     */
+    private computeTermFrequency;
+    /**
+     * Compute cosine similarity between two TF-IDF vectors
+     */
+    private cosineSimilarity;
+    /**
+     * Extract most relevant snippet from content
+     */
+    private extractRelevantSnippet;
+    /**
+     * Check if word is a stop word
+     */
+    private isStopWord;
+}
+export {};
+//# sourceMappingURL=CyberneticLocalRAG.d.ts.map

package/dist/CyberneticLocalRAG.d.ts.map

@@ -0,0 +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"}

package/dist/agentic/CyberneticAgent.d.ts

@@ -0,0 +1,111 @@
+import { CyberneticIntentClassifier } from './CyberneticIntentClassifier.js';
+import type { AgentAction, ActionResult, IntentClassification, AgentConfig } from './types.js';
+/**
+ * DOM interaction agent
+ *
+ * Executes actions on the host page based on classified intent.
+ * Supports navigation, form filling, clicking, scrolling, and more.
+ */
+export declare class CyberneticAgent {
+    private config;
+    private classifier;
+    private highlightOverlay;
+    private actionCount;
+    private lastActionReset;
+    constructor(config: AgentConfig);
+    /**
+     * Interpret user message and determine action
+     *
+     * @param message - User's message to interpret
+     * @returns Intent classification with suggested action
+     */
+    interpretIntent(message: string): IntentClassification;
+    /**
+     * Execute an agent action
+     *
+     * @param action - The action to execute
+     * @returns Result of action execution
+     */
+    executeAction(action: AgentAction): Promise<ActionResult>;
+    /**
+     * Check if an action type is allowed by configuration
+     */
+    private isActionAllowed;
+    /**
+     * Check if selector is allowed (not blocked)
+     */
+    private isSelectorAllowed;
+    /**
+     * Navigate to a URL
+     */
+    private navigate;
+    /**
+     * Fill a form field
+     */
+    private fillForm;
+    /**
+     * Click an element
+     */
+    private clickElement;
+    /**
+     * Trigger a modal by clicking its trigger element
+     */
+    private triggerModal;
+    /**
+     * Scroll to an element
+     */
+    private scrollToElement;
+    /**
+     * Highlight an element with animation
+     */
+    highlightElement(selector: string): Promise<ActionResult>;
+    /**
+     * Execute a custom action callback
+     */
+    private executeCustomAction;
+    /**
+     * Check if URL is internal to the current site
+     */
+    private isInternalUrl;
+    /**
+     * Try client-side navigation for SPAs
+     */
+    private tryClientSideNavigation;
+    /**
+     * Validate navigation URL
+     */
+    private validateNavigationUrl;
+    /**
+     * Sanitize CSS selector to prevent injection
+     */
+    private sanitizeSelector;
+    /**
+     * Validate custom action is in whitelist
+     */
+    private isAllowedCustomAction;
+    /**
+     * Remove highlight overlay
+     */
+    private removeHighlight;
+    /**
+     * Inject required styles
+     */
+    private injectStyles;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Get agent configuration
+     */
+    getConfig(): AgentConfig;
+    /**
+     * Get the intent classifier
+     */
+    getClassifier(): CyberneticIntentClassifier;
+    /**
+     * Reset action count (for testing)
+     */
+    resetActionCount(): void;
+}
+//# sourceMappingURL=CyberneticAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CyberneticAgent.d.ts","sourceRoot":"","sources":["../../src/agentic/CyberneticAgent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EACR,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAc;gBAEzB,MAAM,EAAE,WAAW;IAU/B;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB;IAItD;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAyD/D;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;YACW,QAAQ;IAqEtB;;OAEG;YACW,QAAQ;IAuFtB;;OAEG;YACW,YAAY;IA2D1B;;OAEG;YACW,YAAY;IAI1B;;OAEG;YACW,eAAe;IA6C7B;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwE/D;;OAEG;YACW,mBAAmB;IA2BjC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,aAAa,IAAI,0BAA0B;IAI3C;;OAEG;IACH,gBAAgB,IAAI,IAAI;CAI3B"}

package/dist/agentic/CyberneticIntentClassifier.d.ts

@@ -0,0 +1,78 @@
+import type { IntentClassification, AgentConfig } from './types.js';
+/**
+ * Intent classifier for agentic actions
+ *
+ * Classifies user messages to determine if they should trigger
+ * a local DOM action or be sent to the backend RAG.
+ */
+export declare class CyberneticIntentClassifier {
+    private config;
+    private siteMapIndex;
+    private formIndex;
+    private modalIndex;
+    constructor(config: AgentConfig);
+    /**
+     * Build search indexes from configuration
+     */
+    private buildIndexes;
+    /**
+     * Classify user message intent
+     *
+     * @param message - User's message to classify
+     * @returns Classification result with action and confidence
+     */
+    classify(message: string): IntentClassification;
+    /**
+     * Build action from pattern match
+     */
+    private buildAction;
+    /**
+     * Extract target from regex match
+     */
+    private extractTarget;
+    /**
+     * Find site map match for target string
+     */
+    private findSiteMapMatch;
+    /**
+     * Fuzzy match against site map for unstructured queries
+     */
+    private fuzzyMatchSiteMap;
+    /**
+     * Match custom action keywords
+     */
+    private matchCustomAction;
+    /**
+     * Parse form fill intent
+     */
+    private parseFormIntent;
+    /**
+     * Find button selector by name
+     */
+    private findButtonSelector;
+    /**
+     * Find modal config by name
+     */
+    private findModalConfig;
+    /**
+     * Find scroll target selector
+     */
+    private findScrollTarget;
+    /**
+     * Find element by description
+     */
+    private findElementByDescription;
+    /**
+     * Generate unique selector for an element
+     */
+    private generateUniqueSelector;
+    /**
+     * Calculate string similarity (Jaccard index)
+     */
+    private calculateSimilarity;
+    /**
+     * Get configuration
+     */
+    getConfig(): AgentConfig;
+}
+//# sourceMappingURL=CyberneticIntentClassifier.d.ts.map

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

@@ -0,0 +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"}

package/dist/agentic/index.d.ts

@@ -0,0 +1,13 @@
+export { CyberneticAgent } from './CyberneticAgent.js';
+export { CyberneticIntentClassifier } from './CyberneticIntentClassifier.js';
+export { registerAgenticCapabilities } from './register.js';
+export type { ActionType, AgentAction, ActionResult, IntentClassification, SiteMapEntry, FormFieldConfig, ModalTriggerConfig, AgentConfig } from './types.js';
+export { ClickTool } from './tools/ClickTool.js';
+export type { ClickOptions } from './tools/ClickTool.js';
+export { FillTool } from './tools/FillTool.js';
+export type { FillOptions } from './tools/FillTool.js';
+export { ScrollTool } from './tools/ScrollTool.js';
+export type { ScrollOptions } from './tools/ScrollTool.js';
+export { NavigateTool } from './tools/NavigateTool.js';
+export type { NavigateOptions } from './tools/NavigateTool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agentic/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAG5D,YAAY,EACR,UAAU,EACV,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,WAAW,EACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/agentic/register.d.ts

@@ -0,0 +1,32 @@
+import type { CyberneticClient } from '../CyberneticClient.js';
+/**
+ * Register agentic capabilities with a CyberneticClient
+ *
+ * This function is the bridge between core and agentic modules.
+ * It must be called after creating the client to enable agentic features.
+ *
+ * @example
+ * ```typescript
+ * import { CyberneticClient, registerAgenticCapabilities } from '@astermind/cybernetic-chatbot-client';
+ *
+ * const client = new CyberneticClient({
+ *     apiUrl: 'https://api.example.com',
+ *     apiKey: 'am_xxx_123',
+ *     agentic: {
+ *         enabled: true,
+ *         allowedActions: ['click', 'fill', 'scroll'],
+ *         confirmActions: true
+ *     }
+ * });
+ *
+ * // Register agentic capabilities
+ * registerAgenticCapabilities(client);
+ *
+ * // Now client supports agentic responses
+ * const response = await client.ask('Click the Add to Cart button');
+ * ```
+ *
+ * @param client - The CyberneticClient instance to register capabilities with
+ */
+export declare function registerAgenticCapabilities(client: CyberneticClient): void;
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/agentic/register.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,wBAAwB,CAAC;AAIpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAM1E"}