@supernal/interface 1.0.6 → 1.0.7

package/dist/esm/src/ai/AIInterface.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Generic AI Interface for Tool Command Processing
+ *
+ * Uses core abstractions:
+ * - ToolMatcher (pluggable matching strategies)
+ * - ParameterExtractor (declarative parameter extraction)
+ * - ToolExecutor (universal execution engine)
+ * - SuggestionEngine ("Did You Mean?" system)
+ *
+ * NO HARDCODED ROUTES - everything is inferred from NavigationGraph
+ */
+import type { ToolMetadata } from "../decorators/Tool";
+import { ToolMatcher } from "./ToolMatcher";
+import { ParameterExtractor } from "./ParameterExtractor";
+import { ToolExecutor } from "./ToolExecutor";
+import { SuggestionEngine } from "./SuggestionEngine";
+export interface AICommand {
+    query: string;
+    tool?: ToolMetadata;
+    confidence: number;
+    requiresApproval: boolean;
+    parameters?: unknown[];
+    parsedIntent?: {
+        action: string;
+        target?: string;
+        value?: string;
+    };
+}
+export interface AIResponse {
+    success: boolean;
+    message: string;
+    executedTool?: string;
+    timestamp: string;
+}
+/**
+ * Generic AI Interface - works for ANY app with ZERO configuration
+ * Container detection is INFERRED from NavigationGraph
+ *
+ * Supports pluggable matching strategies via ToolMatcher.
+ * For LLM-based matching, see @supernalintelligence/interface-enterprise
+ */
+export declare class AIInterface {
+    protected matcher: ToolMatcher;
+    protected paramExtractor: ParameterExtractor;
+    protected executor: ToolExecutor;
+    protected suggestionEngine: SuggestionEngine;
+    constructor();
+    /**
+     * Register a custom matcher strategy (for BYOK LLM integration)
+     * @param strategy Custom matching strategy
+     */
+    registerMatcherStrategy(strategy: any): void;
+    /**
+     * Get current container - INFERRED from NavigationGraph
+     * NO HARDCODED ROUTE MAPPINGS
+     */
+    private getCurrentContext;
+    /**
+     * Find matching tools using ToolMatcher
+     */
+    findToolsForCommand(query: string): Promise<AICommand[]>;
+    /**
+     * Execute a command using ToolExecutor
+     */
+    executeCommand(commands: AICommand[], useFirstMatch?: boolean): Promise<AIResponse>;
+    /**
+     * CONVENIENCE: Process a text query end-to-end
+     */
+    processQuery(query: string): Promise<AIResponse>;
+    /**
+     * Get all available commands for help/autocomplete
+     */
+    getAvailableCommands(): string[];
+    /**
+     * Get suggestions for incomplete query (autocomplete)
+     */
+    getSuggestions(partialQuery: string): Promise<string[]>;
+}
+//# sourceMappingURL=AIInterface.d.ts.map

package/dist/esm/src/ai/AIInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIInterface.d.ts","sourceRoot":"","sources":["../../../../src/ai/AIInterface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAqB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IAEtB,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC;IAC/B,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAC7C,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC;IACjC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;;IAU7C;;;OAGG;IACI,uBAAuB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAInD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiD9D;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,aAAa,GAAE,OAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA6D/F;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKtD;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAsBhC;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAM9D"}

package/dist/esm/src/ai/AIInterface.js

@@ -0,0 +1,179 @@
+/**
+ * Generic AI Interface for Tool Command Processing
+ *
+ * Uses core abstractions:
+ * - ToolMatcher (pluggable matching strategies)
+ * - ParameterExtractor (declarative parameter extraction)
+ * - ToolExecutor (universal execution engine)
+ * - SuggestionEngine ("Did You Mean?" system)
+ *
+ * NO HARDCODED ROUTES - everything is inferred from NavigationGraph
+ */
+import { ToolRegistry } from '../background/registry/ToolRegistry.js';
+import { NavigationGraph } from '../background/navigation/NavigationGraph.js';
+import { ToolMatcher } from './ToolMatcher.js';
+import { ParameterExtractor } from './ParameterExtractor.js';
+import { ToolExecutor } from './ToolExecutor.js';
+import { SuggestionEngine } from './SuggestionEngine.js';
+/**
+ * Generic AI Interface - works for ANY app with ZERO configuration
+ * Container detection is INFERRED from NavigationGraph
+ *
+ * Supports pluggable matching strategies via ToolMatcher.
+ * For LLM-based matching, see @supernalintelligence/interface-enterprise
+ */
+export class AIInterface {
+    constructor() {
+        // Initialize core abstractions
+        this.matcher = new ToolMatcher();
+        this.paramExtractor = new ParameterExtractor();
+        this.executor = new ToolExecutor();
+        this.suggestionEngine = new SuggestionEngine();
+    }
+    /**
+     * Register a custom matcher strategy (for BYOK LLM integration)
+     * @param strategy Custom matching strategy
+     */
+    registerMatcherStrategy(strategy) {
+        this.matcher.registerStrategy(strategy);
+    }
+    /**
+     * Get current container - INFERRED from NavigationGraph
+     * NO HARDCODED ROUTE MAPPINGS
+     */
+    getCurrentContext() {
+        if (typeof window === 'undefined') {
+            return {
+                currentContainer: 'unknown',
+                currentPage: 'unknown'
+            };
+        }
+        // Use the context set by useContainer() hook, NOT route inference
+        // This ensures the context matches what the page component registered
+        const graph = NavigationGraph.getInstance();
+        const currentContainer = graph.getCurrentContext() || 'unknown';
+        return {
+            currentContainer,
+            currentPage: currentContainer
+        };
+    }
+    /**
+     * Find matching tools using ToolMatcher
+     */
+    async findToolsForCommand(query) {
+        console.log(`🔍 [AI] Finding tools for: "${query}"`);
+        // Get all available tools
+        const toolsMap = ToolRegistry.getAllTools();
+        const allTools = Array.from(toolsMap.values());
+        const context = this.getCurrentContext();
+        console.log(`📍 [AI] Current context:`, context);
+        // Filter tools by current container
+        // Priority: 1) Scoped to current container, 2) Global (no containerId), 3) Global navigation
+        const scopedTools = allTools.filter(tool => tool.containerId === context.currentContainer);
+        const globalTools = allTools.filter(tool => !tool.containerId);
+        const navigationTools = allTools.filter(tool => tool.containerId !== context.currentContainer && tool.category === 'navigation');
+        console.log(`📦 [AI] Scoped tools: ${scopedTools.length}, Global tools: ${globalTools.length}, Navigation tools: ${navigationTools.length}`);
+        // Combine: scoped first, then global, then navigation
+        const contextTools = [...scopedTools, ...globalTools, ...navigationTools];
+        console.log(`📦 [AI] Total filtered to ${contextTools.length} tools for context: ${context.currentContainer}`);
+        // Use ToolMatcher to find matches
+        const matches = await this.matcher.findMatches(query, contextTools, context, 5);
+        // Convert to AICommand format
+        const commands = matches.map(match => ({
+            query,
+            tool: match.tool,
+            confidence: match.confidence,
+            requiresApproval: match.tool.dangerLevel === 'dangerous' || match.tool.dangerLevel === 'destructive',
+            parameters: match.parameters || []
+        }));
+        console.log(`✅ [AI] Found ${commands.length} matching tools:`, commands.map(c => `${c.tool?.name} (${Math.round((c.confidence || 0) * 100)}%)`));
+        return commands;
+    }
+    /**
+     * Execute a command using ToolExecutor
+     */
+    async executeCommand(commands, useFirstMatch = true) {
+        if (commands.length === 0) {
+            // Use SuggestionEngine for helpful response
+            const toolsMap = ToolRegistry.getAllTools();
+            const allTools = Array.from(toolsMap.values());
+            const context = this.getCurrentContext();
+            // Get available commands for current context
+            const contextTools = allTools.filter(t => t.aiEnabled &&
+                (!t.containerId || t.containerId === context.currentContainer || t.category === 'navigation'));
+            const examples = contextTools.flatMap(t => t.examples || []).slice(0, 5);
+            return {
+                success: false,
+                message: `❓ No matching command found.\n\n💡 Try:\n${examples.map(ex => `• "${ex}"`).join('\n')}`,
+                timestamp: new Date().toISOString()
+            };
+        }
+        const command = commands[0]; // Use highest confidence match
+        if (!command.tool) {
+            return {
+                success: false,
+                message: `❌ No tool found for command`,
+                timestamp: new Date().toISOString()
+            };
+        }
+        console.log(`🎯 [AI] Executing: ${command.tool.name}`);
+        // Extract parameters using ParameterExtractor
+        const extraction = await this.paramExtractor.extract(command.query, command.tool);
+        const parameters = extraction.parameters.length > 0 ? extraction.parameters : command.parameters;
+        console.log(`📋 [AI] Parameters:`, parameters);
+        // Execute using ToolExecutor
+        try {
+            const result = await this.executor.execute(command.tool, parameters || []);
+            return {
+                success: result.success,
+                message: result.success ? `✅ ${result.message}` : `❌ ${result.message}`,
+                executedTool: command.tool.name,
+                timestamp: new Date().toISOString()
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                message: `❌ ${errorMsg}`,
+                timestamp: new Date().toISOString()
+            };
+        }
+    }
+    /**
+     * CONVENIENCE: Process a text query end-to-end
+     */
+    async processQuery(query) {
+        const commands = await this.findToolsForCommand(query);
+        return this.executeCommand(commands, true);
+    }
+    /**
+     * Get all available commands for help/autocomplete
+     */
+    getAvailableCommands() {
+        const toolsMap = ToolRegistry.getAllTools();
+        const allTools = Array.from(toolsMap.values());
+        const context = this.getCurrentContext();
+        // Filter by current context
+        const contextTools = allTools.filter(tool => !tool.containerId ||
+            tool.containerId === context.currentContainer ||
+            tool.category === 'navigation');
+        // Extract examples
+        const commands = [];
+        for (const tool of contextTools) {
+            const examples = tool.examples || [];
+            commands.push(...examples);
+        }
+        return commands;
+    }
+    /**
+     * Get suggestions for incomplete query (autocomplete)
+     */
+    async getSuggestions(partialQuery) {
+        const toolsMap = ToolRegistry.getAllTools();
+        const allTools = Array.from(toolsMap.values());
+        const suggestions = this.suggestionEngine.getSuggestions(partialQuery, allTools, 5);
+        return suggestions.map(s => s.text);
+    }
+}
+//# sourceMappingURL=AIInterface.js.map

package/dist/esm/src/ai/AIInterface.js.map

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

package/dist/esm/src/ai/ParameterExtractor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ParameterExtractor - Extract parameters from natural language queries
+ *
+ * Supports multiple extraction strategies:
+ * - Pattern-based (using tool examples)
+ * - Entity extraction (dates, numbers, names)
+ * - LLM-based extraction (structured JSON)
+ */
+import type { ToolMetadata } from '../decorators/Tool';
+/**
+ * Extracted parameter with metadata
+ */
+export interface ExtractedParameter {
+    value: any;
+    type: 'string' | 'number' | 'boolean' | 'date' | 'object';
+    confidence: number;
+    source: 'pattern' | 'entity' | 'llm';
+}
+/**
+ * Parameter extraction result
+ */
+export interface ExtractionResult {
+    parameters: any[];
+    confidence: number;
+    reasoning?: string;
+}
+/**
+ * Base interface for extraction strategies
+ */
+export interface ExtractorStrategy {
+    name: string;
+    priority: number;
+    extract(query: string, tool: ToolMetadata): Promise<ExtractionResult | null>;
+}
+/**
+ * Main ParameterExtractor orchestrator
+ */
+export declare class ParameterExtractor {
+    private strategies;
+    constructor();
+    /**
+     * Register a new extraction strategy
+     */
+    registerStrategy(strategy: ExtractorStrategy): void;
+    /**
+     * Extract parameters from query for a specific tool
+     */
+    extract(query: string, tool: ToolMetadata): Promise<ExtractionResult>;
+}
+//# sourceMappingURL=ParameterExtractor.d.ts.map

package/dist/esm/src/ai/ParameterExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParameterExtractor.d.ts","sourceRoot":"","sources":["../../../../src/ai/ParameterExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,GAAG,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC9E;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAA2B;;IAQ7C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAKnD;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAqB5E"}

package/dist/esm/src/ai/ParameterExtractor.js

@@ -0,0 +1,136 @@
+/**
+ * ParameterExtractor - Extract parameters from natural language queries
+ *
+ * Supports multiple extraction strategies:
+ * - Pattern-based (using tool examples)
+ * - Entity extraction (dates, numbers, names)
+ * - LLM-based extraction (structured JSON)
+ */
+/**
+ * Main ParameterExtractor orchestrator
+ */
+export class ParameterExtractor {
+    constructor() {
+        this.strategies = [];
+        // Register default strategies
+        this.registerStrategy(new PatternExtractor());
+        this.registerStrategy(new EntityExtractor());
+    }
+    /**
+     * Register a new extraction strategy
+     */
+    registerStrategy(strategy) {
+        this.strategies.push(strategy);
+        this.strategies.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Extract parameters from query for a specific tool
+     */
+    async extract(query, tool) {
+        // Try each strategy in priority order
+        for (const strategy of this.strategies) {
+            try {
+                const result = await strategy.extract(query, tool);
+                if (result && result.confidence >= 60) {
+                    console.log(`✅ [ParamExtract] Used strategy: ${strategy.name}`, result);
+                    return result;
+                }
+            }
+            catch (error) {
+                console.warn(`[ParamExtract] Strategy ${strategy.name} failed:`, error);
+            }
+        }
+        // No successful extraction
+        return {
+            parameters: [],
+            confidence: 0,
+            reasoning: 'No extraction strategy succeeded'
+        };
+    }
+}
+/**
+ * Pattern-based extraction using tool examples
+ */
+class PatternExtractor {
+    constructor() {
+        this.name = 'pattern';
+        this.priority = 80;
+    }
+    async extract(query, tool) {
+        const examples = tool.examples || [];
+        if (examples.length === 0) {
+            return null;
+        }
+        const lowerQuery = query.toLowerCase().trim();
+        // Try to match each example pattern
+        for (const example of examples) {
+            const pattern = example.toLowerCase();
+            // Check if query starts with the pattern
+            if (lowerQuery.startsWith(pattern)) {
+                // Extract trailing text as parameter
+                const trailing = query.substring(example.length).trim();
+                if (trailing) {
+                    console.log(`🔍 [PatternExtract] Matched: "${example}" → param: "${trailing}"`);
+                    return {
+                        parameters: [trailing],
+                        confidence: 90,
+                        reasoning: `Matched pattern: "${example}"`
+                    };
+                }
+            }
+            // Check if pattern contains a placeholder (e.g., "open blog {title}")
+            const placeholderMatch = pattern.match(/\{(\w+)\}/);
+            if (placeholderMatch) {
+                // Create a regex from the pattern
+                const regexPattern = pattern.replace(/\{(\w+)\}/g, '(.+?)');
+                const regex = new RegExp(`^${regexPattern}$`, 'i');
+                const match = lowerQuery.match(regex);
+                if (match && match[1]) {
+                    console.log(`🔍 [PatternExtract] Placeholder match: "${example}" → param: "${match[1]}"`);
+                    return {
+                        parameters: [match[1].trim()],
+                        confidence: 95,
+                        reasoning: `Matched placeholder in: "${example}"`
+                    };
+                }
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Entity extraction for common types (numbers, dates, etc.)
+ */
+class EntityExtractor {
+    constructor() {
+        this.name = 'entity';
+        this.priority = 60;
+    }
+    async extract(query, tool) {
+        const parameters = [];
+        // Extract numbers
+        const numberMatch = query.match(/\d+/);
+        if (numberMatch) {
+            parameters.push(parseInt(numberMatch[0], 10));
+        }
+        // Extract quoted strings
+        const quotedMatch = query.match(/"([^"]+)"/);
+        if (quotedMatch) {
+            parameters.push(quotedMatch[1]);
+        }
+        // Extract common entities (colors, themes, etc.)
+        const colorMatch = query.match(/\b(red|blue|green|dark|light|black|white)\b/i);
+        if (colorMatch) {
+            parameters.push(colorMatch[1].toLowerCase());
+        }
+        if (parameters.length > 0) {
+            return {
+                parameters,
+                confidence: 70,
+                reasoning: `Extracted ${parameters.length} entities`
+            };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=ParameterExtractor.js.map

package/dist/esm/src/ai/ParameterExtractor.js.map

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

package/dist/esm/src/ai/SuggestionEngine.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SuggestionEngine - "Did You Mean?" system for invalid queries
+ *
+ * Provides helpful suggestions when user queries don't match any tools:
+ * - Typo detection (Levenshtein distance)
+ * - Similar command suggestions
+ * - Available command list
+ */
+import type { ToolMetadata } from '../decorators/Tool';
+/**
+ * Suggestion with confidence
+ */
+export interface Suggestion {
+    text: string;
+    confidence: number;
+    type: 'typo' | 'similar' | 'example' | 'category';
+    tool?: ToolMetadata;
+}
+/**
+ * SuggestionEngine for generating "Did You Mean?" prompts
+ */
+export declare class SuggestionEngine {
+    /**
+     * Generate suggestions for an invalid/ambiguous query
+     * @param query User's query
+     * @param tools Available tools
+     * @param maxSuggestions Maximum number of suggestions to return
+     */
+    getSuggestions(query: string, tools: ToolMetadata[], maxSuggestions?: number): Suggestion[];
+    /**
+     * Format suggestions into a user-friendly message
+     */
+    formatSuggestions(suggestions: Suggestion[]): string;
+    /**
+     * Match query to a category
+     */
+    private matchCategory;
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    private levenshtein;
+}
+//# sourceMappingURL=SuggestionEngine.d.ts.map

package/dist/esm/src/ai/SuggestionEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestionEngine.d.ts","sourceRoot":"","sources":["../../../../src/ai/SuggestionEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAClD,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,GAAE,MAAU,GACzB,UAAU,EAAE;IAgFf;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM;IA4BpD;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,WAAW;CA2BpB"}

package/dist/esm/src/ai/SuggestionEngine.js

@@ -0,0 +1,153 @@
+/**
+ * SuggestionEngine - "Did You Mean?" system for invalid queries
+ *
+ * Provides helpful suggestions when user queries don't match any tools:
+ * - Typo detection (Levenshtein distance)
+ * - Similar command suggestions
+ * - Available command list
+ */
+/**
+ * SuggestionEngine for generating "Did You Mean?" prompts
+ */
+export class SuggestionEngine {
+    /**
+     * Generate suggestions for an invalid/ambiguous query
+     * @param query User's query
+     * @param tools Available tools
+     * @param maxSuggestions Maximum number of suggestions to return
+     */
+    getSuggestions(query, tools, maxSuggestions = 5) {
+        const suggestions = [];
+        const lowerQuery = query.toLowerCase().trim();
+        // 1. Check for typos (Levenshtein distance ≤ 3)
+        for (const tool of tools) {
+            const examples = tool.examples || [];
+            const allPhrases = [tool.name, ...examples];
+            for (const phrase of allPhrases) {
+                const distance = this.levenshtein(lowerQuery, phrase.toLowerCase());
+                if (distance <= 3 && distance > 0) {
+                    const confidence = Math.round((1 - distance / Math.max(lowerQuery.length, phrase.length)) * 100);
+                    suggestions.push({
+                        text: phrase,
+                        confidence,
+                        type: 'typo',
+                        tool
+                    });
+                }
+            }
+        }
+        // 2. Find similar commands (keyword overlap)
+        const queryWords = lowerQuery.split(/\s+/);
+        for (const tool of tools) {
+            const examples = tool.examples || [];
+            const toolWords = [
+                ...tool.name.toLowerCase().split(/\s+/),
+                ...(tool.description?.toLowerCase().split(/\s+/) || []),
+                ...examples.flatMap((e) => e.toLowerCase().split(/\s+/))
+            ];
+            const overlap = queryWords.filter(w => toolWords.includes(w)).length;
+            if (overlap > 0) {
+                const confidence = Math.round((overlap / queryWords.length) * 100);
+                // Use first example if available, otherwise tool name
+                const text = examples[0] || tool.name;
+                suggestions.push({
+                    text,
+                    confidence,
+                    type: 'similar',
+                    tool
+                });
+            }
+        }
+        // 3. Category-based suggestions
+        const categoryMatch = this.matchCategory(lowerQuery);
+        if (categoryMatch) {
+            const categoryTools = tools.filter(t => t.category === categoryMatch);
+            for (const tool of categoryTools.slice(0, 3)) {
+                const examples = tool.examples || [];
+                const text = examples[0] || tool.name;
+                suggestions.push({
+                    text,
+                    confidence: 60,
+                    type: 'category',
+                    tool
+                });
+            }
+        }
+        // Sort by confidence and deduplicate
+        const sorted = suggestions
+            .sort((a, b) => b.confidence - a.confidence)
+            .filter((s, i, arr) => 
+        // Remove duplicates (same text)
+        i === arr.findIndex(other => other.text === s.text))
+            .slice(0, maxSuggestions);
+        return sorted;
+    }
+    /**
+     * Format suggestions into a user-friendly message
+     */
+    formatSuggestions(suggestions) {
+        if (suggestions.length === 0) {
+            return 'No suggestions available. Try typing "help" to see all commands.';
+        }
+        const typos = suggestions.filter(s => s.type === 'typo');
+        const similar = suggestions.filter(s => s.type === 'similar' || s.type === 'category');
+        let message = '';
+        if (typos.length > 0) {
+            message += '❓ Did you mean?\n';
+            for (const typo of typos.slice(0, 3)) {
+                message += `  • "${typo.text}"\n`;
+            }
+        }
+        if (similar.length > 0) {
+            if (message)
+                message += '\n';
+            message += '💡 Similar commands:\n';
+            for (const sim of similar.slice(0, 3)) {
+                message += `  • "${sim.text}"\n`;
+            }
+        }
+        return message.trim();
+    }
+    /**
+     * Match query to a category
+     */
+    matchCategory(query) {
+        const categories = {
+            'navigation': ['go', 'open', 'navigate', 'show', 'view', 'page'],
+            'theme': ['theme', 'color', 'dark', 'light', 'appearance'],
+            'data': ['load', 'fetch', 'get', 'data', 'retrieve'],
+            'form': ['submit', 'save', 'form', 'input', 'enter'],
+            'state': ['set', 'change', 'update', 'modify', 'status']
+        };
+        for (const [category, keywords] of Object.entries(categories)) {
+            if (keywords.some(kw => query.includes(kw))) {
+                return category;
+            }
+        }
+        return null;
+    }
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    levenshtein(a, b) {
+        const matrix = [];
+        for (let i = 0; i <= b.length; i++) {
+            matrix[i] = [i];
+        }
+        for (let j = 0; j <= a.length; j++) {
+            matrix[0][j] = j;
+        }
+        for (let i = 1; i <= b.length; i++) {
+            for (let j = 1; j <= a.length; j++) {
+                if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                    matrix[i][j] = matrix[i - 1][j - 1];
+                }
+                else {
+                    matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+                }
+            }
+        }
+        return matrix[b.length][a.length];
+    }
+}
+//# sourceMappingURL=SuggestionEngine.js.map