@pinepaper.studio/mcp-server 1.3.1 → 1.3.3

package/dist/taxonomy/classifier.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Intent Classifier
+ *
+ * High-level classifier that combines taxonomy matching, modifier detection,
+ * entity extraction, and parameter inference to understand user intent
+ * and recommend the best MCP tool.
+ */
+import type { SupportedLocale } from '../i18n/types.js';
+import type { IntentAnalysis, TaxonomyError, TaxonomyConfig } from './types.js';
+/**
+ * Intent Classifier
+ *
+ * Analyzes user input to determine intent and recommend appropriate MCP tools.
+ */
+export declare class IntentClassifier {
+    private matcher;
+    private config;
+    private initialized;
+    constructor(config?: Partial<TaxonomyConfig>);
+    /**
+     * Initialize the classifier
+     */
+    initialize(): Promise<void>;
+    /**
+     * Classify user input and recommend tool
+     */
+    classify(input: string, providedLocale?: SupportedLocale): Promise<IntentAnalysis>;
+    /**
+     * Extract entities from user input
+     */
+    private extractEntities;
+    /**
+     * Build tool parameters from classification and entities
+     */
+    private buildToolParams;
+    /**
+     * Convert position keyword to coordinates
+     */
+    private positionKeywordToCoordinates;
+    /**
+     * Check if clarification is needed
+     */
+    private needsClarification;
+    /**
+     * Build clarification prompt
+     */
+    private buildClarificationPrompt;
+    /**
+     * Get suggestions when no match is found
+     */
+    private getSuggestions;
+    /**
+     * Validate a tool selection against the taxonomy
+     */
+    validateToolSelection(toolName: string, userInput: string): Promise<TaxonomyError | null>;
+    /**
+     * Get tool recommendation with rich context
+     */
+    getRecommendation(input: string, locale?: SupportedLocale): Promise<{
+        tool: string;
+        params: Record<string, unknown>;
+        confidence: number;
+        explanation: string;
+    } | null>;
+}
+/**
+ * Get or create the singleton IntentClassifier instance
+ */
+export declare function getIntentClassifier(config?: Partial<TaxonomyConfig>): IntentClassifier;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetIntentClassifier(): void;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/taxonomy/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/taxonomy/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAEV,cAAc,EAId,aAAa,EAEb,cAAc,EACf,MAAM,YAAY,CAAC;AAuFpB;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAY5C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA4ExF;;OAEG;IACH,OAAO,CAAC,eAAe;IAwFvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAqBpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA6B/F;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC;QACxE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI,CAAC;CAmBV;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,gBAAgB,CAKtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/taxonomy/classifier.js

@@ -0,0 +1,448 @@
+/**
+ * Intent Classifier
+ *
+ * High-level classifier that combines taxonomy matching, modifier detection,
+ * entity extraction, and parameter inference to understand user intent
+ * and recommend the best MCP tool.
+ */
+import { getTaxonomyMatcher } from './matcher.js';
+import { ANIMATION_TAXONOMY } from './registry.js';
+/**
+ * Color name to hex mapping for common colors
+ */
+const COLOR_MAP = {
+    // Basic colors
+    red: '#ff0000',
+    green: '#00ff00',
+    blue: '#0000ff',
+    yellow: '#ffff00',
+    orange: '#ffa500',
+    purple: '#800080',
+    pink: '#ffc0cb',
+    white: '#ffffff',
+    black: '#000000',
+    gray: '#808080',
+    grey: '#808080',
+    brown: '#a52a2a',
+    cyan: '#00ffff',
+    magenta: '#ff00ff',
+    // Extended colors
+    gold: '#ffd700',
+    silver: '#c0c0c0',
+    navy: '#000080',
+    teal: '#008080',
+    maroon: '#800000',
+    olive: '#808000',
+    lime: '#00ff00',
+    aqua: '#00ffff',
+    coral: '#ff7f50',
+    salmon: '#fa8072',
+    turquoise: '#40e0d0',
+    violet: '#ee82ee',
+    indigo: '#4b0082',
+    crimson: '#dc143c',
+    beige: '#f5f5dc',
+    ivory: '#fffff0',
+    lavender: '#e6e6fa',
+    // Multilingual color names
+    rojo: '#ff0000',
+    verde: '#00ff00',
+    azul: '#0000ff',
+    amarillo: '#ffff00',
+    naranja: '#ffa500',
+    morado: '#800080',
+    blanco: '#ffffff',
+    negro: '#000000',
+    rouge: '#ff0000',
+    vert: '#00ff00',
+    bleu: '#0000ff',
+    jaune: '#ffff00',
+    blanc: '#ffffff',
+    noir: '#000000',
+    rot: '#ff0000',
+    grün: '#00ff00',
+    blau: '#0000ff',
+    gelb: '#ffff00',
+    weiss: '#ffffff',
+    schwarz: '#000000',
+};
+/**
+ * Patterns for extracting entities from user input
+ */
+const ENTITY_PATTERNS = {
+    // Hex color (#fff, #ffffff)
+    hexColor: /#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})\b/g,
+    // RGB/RGBA
+    rgbColor: /rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)/gi,
+    // Numbers with optional units
+    number: /\b(\d+(?:\.\d+)?)\s*(px|%|deg|s|ms|seconds?)?\b/gi,
+    // Position keywords
+    position: /\b(center|top|bottom|left|right|top-left|top-right|bottom-left|bottom-right|middle)\b/gi,
+    // Named items (quoted strings or specific patterns)
+    quotedString: /"([^"]+)"|'([^']+)'/g,
+};
+/**
+ * Intent Classifier
+ *
+ * Analyzes user input to determine intent and recommend appropriate MCP tools.
+ */
+export class IntentClassifier {
+    matcher;
+    config;
+    initialized = false;
+    constructor(config) {
+        this.config = {
+            minConfidence: 0.6,
+            useSemanticSearch: false,
+            maxSuggestions: 3,
+            defaultLocale: 'en',
+            debug: false,
+            ...config,
+        };
+        this.matcher = getTaxonomyMatcher(config);
+    }
+    /**
+     * Initialize the classifier
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.matcher.initialize();
+        this.initialized = true;
+    }
+    /**
+     * Classify user input and recommend tool
+     */
+    async classify(input, providedLocale) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        // 1. Detect language
+        const detectedLocale = providedLocale || this.matcher.detectLocale(input);
+        // 2. Find taxonomy matches
+        const matches = await this.matcher.findMatches(input, detectedLocale);
+        // 3. Detect modifiers
+        const modifierMatches = this.matcher.detectModifiers(input, detectedLocale);
+        const activeModifiers = modifierMatches.map((m) => m.modifier);
+        // 4. Extract entities
+        const entities = this.extractEntities(input);
+        // 5. Build classification result
+        let classification;
+        if (matches.length === 0) {
+            classification = {
+                method: 'unknown',
+                confidence: 0,
+                suggestions: this.getSuggestions(input),
+                detectedLocale,
+            };
+        }
+        else {
+            const bestMatch = matches[0];
+            classification = {
+                method: bestMatch.similarity > 0.85 ? 'keyword' : 'pattern',
+                confidence: bestMatch.similarity,
+                node: bestMatch.node,
+                modifiers: activeModifiers,
+                extractedParams: this.matcher.extractParameters(input, bestMatch.node, detectedLocale),
+                detectedLocale,
+            };
+        }
+        // 6. Build recommended tool call
+        let recommendedTool;
+        if (classification.node) {
+            const params = this.buildToolParams(classification.node, classification, entities, activeModifiers);
+            recommendedTool = {
+                name: classification.node.tool.tool,
+                params,
+            };
+        }
+        // 7. Check if clarification is needed
+        const needsClarification = this.needsClarification(classification, matches);
+        // 8. Build alternatives
+        const alternatives = matches.length > 1
+            ? matches.slice(1).map((m) => ({
+                method: 'pattern',
+                confidence: m.similarity,
+                node: m.node,
+                detectedLocale,
+            }))
+            : undefined;
+        return {
+            classification,
+            entities,
+            recommendedTool,
+            alternatives,
+            needsClarification,
+            clarificationPrompt: needsClarification ? this.buildClarificationPrompt(matches, input) : undefined,
+        };
+    }
+    /**
+     * Extract entities from user input
+     */
+    extractEntities(input) {
+        const entities = [];
+        // Extract hex colors
+        const hexMatches = input.matchAll(ENTITY_PATTERNS.hexColor);
+        for (const match of hexMatches) {
+            entities.push({
+                type: 'color',
+                value: match[0],
+                normalized: match[0].toLowerCase(),
+                position: { start: match.index, end: match.index + match[0].length },
+            });
+        }
+        // Extract RGB colors
+        const rgbMatches = input.matchAll(ENTITY_PATTERNS.rgbColor);
+        for (const match of rgbMatches) {
+            const r = parseInt(match[1], 10);
+            const g = parseInt(match[2], 10);
+            const b = parseInt(match[3], 10);
+            const hex = `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+            entities.push({
+                type: 'color',
+                value: match[0],
+                normalized: hex,
+                position: { start: match.index, end: match.index + match[0].length },
+            });
+        }
+        // Extract named colors
+        const lowerInput = input.toLowerCase();
+        for (const [name, hex] of Object.entries(COLOR_MAP)) {
+            const index = lowerInput.indexOf(name);
+            if (index !== -1) {
+                // Check it's a word boundary
+                const before = index > 0 ? lowerInput[index - 1] : ' ';
+                const after = lowerInput[index + name.length] || ' ';
+                if (/\s|^/.test(before) && /\s|$|[.,!?;:]/.test(after)) {
+                    entities.push({
+                        type: 'color',
+                        value: name,
+                        normalized: hex,
+                        position: { start: index, end: index + name.length },
+                    });
+                }
+            }
+        }
+        // Extract numbers
+        const numberMatches = input.matchAll(ENTITY_PATTERNS.number);
+        for (const match of numberMatches) {
+            const value = parseFloat(match[1]);
+            const unit = match[2]?.toLowerCase();
+            entities.push({
+                type: 'number',
+                value: match[0],
+                normalized: { value, unit },
+                position: { start: match.index, end: match.index + match[0].length },
+            });
+        }
+        // Extract positions
+        const positionMatches = input.matchAll(ENTITY_PATTERNS.position);
+        for (const match of positionMatches) {
+            entities.push({
+                type: 'position',
+                value: match[0],
+                normalized: match[0].toLowerCase(),
+                position: { start: match.index, end: match.index + match[0].length },
+            });
+        }
+        // Extract quoted strings (names, labels)
+        const quotedMatches = input.matchAll(ENTITY_PATTERNS.quotedString);
+        for (const match of quotedMatches) {
+            const content = match[1] || match[2];
+            entities.push({
+                type: 'name',
+                value: content,
+                normalized: content,
+                position: { start: match.index, end: match.index + match[0].length },
+            });
+        }
+        return entities;
+    }
+    /**
+     * Build tool parameters from classification and entities
+     */
+    buildToolParams(node, classification, entities, modifiers) {
+        const params = {
+            ...node.tool.defaultParams,
+            ...classification.extractedParams,
+        };
+        // Apply modifier modifications
+        for (const modifier of modifiers) {
+            Object.assign(params, modifier.modifications);
+        }
+        // Apply entities
+        const colorEntity = entities.find((e) => e.type === 'color');
+        if (colorEntity && !params.fillColor) {
+            params.fillColor = colorEntity.normalized;
+        }
+        // Apply position if found
+        const positionEntity = entities.find((e) => e.type === 'position');
+        if (positionEntity && !params.position) {
+            params.position = this.positionKeywordToCoordinates(positionEntity.normalized);
+        }
+        // Apply size/radius from numbers
+        const numberEntities = entities.filter((e) => e.type === 'number');
+        for (const numEntity of numberEntities) {
+            const { value, unit } = numEntity.normalized;
+            if (unit === 'px' || unit === undefined) {
+                // Could be radius or size
+                if (!params.radius && node.id.includes('circle')) {
+                    params.radius = value;
+                }
+                else if (!params.size) {
+                    params.size = value;
+                }
+            }
+            else if (unit === 's' || unit === 'seconds') {
+                params.duration = value;
+            }
+            else if (unit === 'deg') {
+                params.angle = value;
+            }
+        }
+        // Apply name/content from quoted strings
+        const nameEntity = entities.find((e) => e.type === 'name');
+        if (nameEntity && node.id === 'create_text') {
+            params.content = nameEntity.normalized;
+        }
+        return params;
+    }
+    /**
+     * Convert position keyword to coordinates
+     */
+    positionKeywordToCoordinates(keyword) {
+        // Default canvas size assumptions (can be made configurable)
+        const width = 1920;
+        const height = 1080;
+        const positions = {
+            center: { x: width / 2, y: height / 2 },
+            middle: { x: width / 2, y: height / 2 },
+            top: { x: width / 2, y: 100 },
+            bottom: { x: width / 2, y: height - 100 },
+            left: { x: 100, y: height / 2 },
+            right: { x: width - 100, y: height / 2 },
+            'top-left': { x: 100, y: 100 },
+            'top-right': { x: width - 100, y: 100 },
+            'bottom-left': { x: 100, y: height - 100 },
+            'bottom-right': { x: width - 100, y: height - 100 },
+        };
+        return positions[keyword] || positions.center;
+    }
+    /**
+     * Check if clarification is needed
+     */
+    needsClarification(classification, matches) {
+        // Unknown classification
+        if (classification.method === 'unknown') {
+            return true;
+        }
+        // Low confidence
+        if (classification.confidence < this.config.minConfidence) {
+            return true;
+        }
+        // Multiple high-confidence matches (ambiguous)
+        if (matches.length >= 2) {
+            const secondBest = matches[1];
+            if (secondBest.similarity > 0.7 && classification.confidence - secondBest.similarity < 0.1) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Build clarification prompt
+     */
+    buildClarificationPrompt(matches, input) {
+        if (matches.length === 0) {
+            return `I couldn't understand what you want to do with "${input}". Could you rephrase or be more specific?`;
+        }
+        if (matches.length === 1 && matches[0].similarity < this.config.minConfidence) {
+            return `Did you mean "${matches[0].node.id.replace(/_/g, ' ')}"? (Confidence: ${Math.round(matches[0].similarity * 100)}%)`;
+        }
+        // Multiple ambiguous matches
+        const options = matches
+            .slice(0, 3)
+            .map((m, i) => `${i + 1}. ${m.node.id.replace(/_/g, ' ')} (${Math.round(m.similarity * 100)}%)`)
+            .join('\n');
+        return `I found multiple possible interpretations:\n${options}\n\nWhich one did you mean?`;
+    }
+    /**
+     * Get suggestions when no match is found
+     */
+    getSuggestions(input) {
+        // Return common concepts as suggestions
+        const commonConcepts = [
+            'create_circle',
+            'create_rectangle',
+            'create_text',
+            'rotation',
+            'orbital_motion',
+            'pulse',
+            'fade',
+        ];
+        return commonConcepts.slice(0, this.config.maxSuggestions);
+    }
+    /**
+     * Validate a tool selection against the taxonomy
+     */
+    async validateToolSelection(toolName, userInput) {
+        // Find taxonomy node for this tool
+        const matchingNode = ANIMATION_TAXONOMY.find((n) => n.tool.tool === toolName);
+        if (!matchingNode) {
+            // Tool not in taxonomy, can't validate
+            return null;
+        }
+        // Check if user input aligns with this tool's concept
+        const matches = await this.matcher.findMatches(userInput);
+        const topMatch = matches[0];
+        if (!topMatch) {
+            return null; // Can't determine mismatch
+        }
+        if (topMatch.node.tool.tool !== toolName && topMatch.similarity > 0.8) {
+            return {
+                code: 'TAXONOMY_AMBIGUOUS',
+                message: `Tool "${toolName}" may not be the best choice for this request`,
+                suggestions: [topMatch.node.tool.tool],
+                hint: `Consider using "${topMatch.node.tool.tool}" instead (matched "${topMatch.matchedTerm}" with ${Math.round(topMatch.similarity * 100)}% confidence)`,
+            };
+        }
+        return null;
+    }
+    /**
+     * Get tool recommendation with rich context
+     */
+    async getRecommendation(input, locale) {
+        const analysis = await this.classify(input, locale);
+        if (!analysis.recommendedTool) {
+            return null;
+        }
+        const explanation = analysis.classification.node
+            ? `Matched "${analysis.classification.node.id}" via ${analysis.classification.method} ` +
+                `(${Math.round(analysis.classification.confidence * 100)}% confidence)`
+            : 'No specific match found';
+        return {
+            tool: analysis.recommendedTool.name,
+            params: analysis.recommendedTool.params,
+            confidence: analysis.classification.confidence,
+            explanation,
+        };
+    }
+}
+// Singleton instance
+let classifierInstance = null;
+/**
+ * Get or create the singleton IntentClassifier instance
+ */
+export function getIntentClassifier(config) {
+    if (!classifierInstance) {
+        classifierInstance = new IntentClassifier(config);
+    }
+    return classifierInstance;
+}
+/**
+ * Reset the singleton instance (for testing)
+ */
+export function resetIntentClassifier() {
+    classifierInstance = null;
+}
+//# sourceMappingURL=classifier.js.map

package/dist/taxonomy/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/taxonomy/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAmB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAmC,MAAM,eAAe,CAAC;AAEpF;;GAEG;AACH,MAAM,SAAS,GAA2B;IACxC,eAAe;IACf,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAElB,kBAAkB;IAClB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IAEnB,2BAA2B;IAC3B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,eAAe,GAAG;IACtB,4BAA4B;IAC5B,QAAQ,EAAE,qCAAqC;IAE/C,WAAW;IACX,QAAQ,EAAE,0DAA0D;IAEpE,8BAA8B;IAC9B,MAAM,EAAE,mDAAmD;IAE3D,oBAAoB;IACpB,QAAQ,EACN,yFAAyF;IAE3F,oDAAoD;IACpD,YAAY,EAAE,sBAAsB;CACrC,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACnB,OAAO,CAAkB;IACzB,MAAM,CAAiB;IACvB,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,MAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG;YACZ,aAAa,EAAE,GAAG;YAClB,iBAAiB,EAAE,KAAK;YACxB,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,KAAK;YACZ,GAAG,MAAM;SACV,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,cAAgC;QAC5D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QAED,qBAAqB;QACrB,MAAM,cAAc,GAAG,cAAc,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAE1E,2BAA2B;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAEtE,sBAAsB;QACtB,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAC5E,MAAM,eAAe,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE/D,sBAAsB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAE7C,iCAAiC;QACjC,IAAI,cAAoC,CAAC;QAEzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,cAAc,GAAG;gBACf,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,CAAC;gBACb,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBACvC,cAAc;aACf,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC7B,cAAc,GAAG;gBACf,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBAC3D,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,SAAS,EAAE,eAAe;gBAC1B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC;gBACtF,cAAc;aACf,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,IAAI,eAAkD,CAAC;QAEvD,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;YAEpG,eAAe,GAAG;gBAChB,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACnC,MAAM;aACP,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAE5E,wBAAwB;QACxB,MAAM,YAAY,GAChB,OAAO,CAAC,MAAM,GAAG,CAAC;YAChB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3B,MAAM,EAAE,SAAkB;gBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,cAAc;aACf,CAAC,CAAC;YACL,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,cAAc;YACd,QAAQ;YACR,eAAe;YACf,YAAY;YACZ,kBAAkB;YAClB,mBAAmB,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;SACpG,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAa;QACnC,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,qBAAqB;QACrB,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;gBACf,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;gBAClC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAM,EAAE,GAAG,EAAE,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;aACvE,CAAC,CAAC;QACL,CAAC;QAED,qBAAqB;QACrB,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACtH,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;gBACf,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAM,EAAE,GAAG,EAAE,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;aACvE,CAAC,CAAC;QACL,CAAC;QAED,uBAAuB;QACvB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,6BAA6B;gBAC7B,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBACvD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;gBACrD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvD,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,IAAI;wBACX,UAAU,EAAE,GAAG;wBACf,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE;qBACrD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YAErC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;gBACf,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC3B,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAM,EAAE,GAAG,EAAE,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;aACvE,CAAC,CAAC;QACL,CAAC;QAED,oBAAoB;QACpB,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;gBACf,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;gBAClC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAM,EAAE,GAAG,EAAE,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;aACvE,CAAC,CAAC;QACL,CAAC;QAED,yCAAyC;QACzC,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACnE,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAM,EAAE,GAAG,EAAE,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;aACvE,CAAC,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,IAAkB,EAClB,cAAoC,EACpC,QAA2B,EAC3B,SAAyB;QAEzB,MAAM,MAAM,GAA4B;YACtC,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa;YAC1B,GAAG,cAAc,CAAC,eAAe;SAClC,CAAC;QAEF,+BAA+B;QAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC;QAED,iBAAiB;QACjB,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAC7D,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC;QAC5C,CAAC;QAED,0BAA0B;QAC1B,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACnE,IAAI,cAAc,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,4BAA4B,CAAC,cAAc,CAAC,UAAoB,CAAC,CAAC;QAC3F,CAAC;QAED,iCAAiC;QACjC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACnE,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;YACvC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,UAA8C,CAAC;YAEjF,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxC,0BAA0B;gBAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACjD,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;gBACxB,CAAC;qBAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACxB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC9C,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC1B,CAAC;iBAAM,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YACvB,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAC3D,IAAI,UAAU,IAAI,IAAI,CAAC,EAAE,KAAK,aAAa,EAAE,CAAC;YAC5C,MAAM,CAAC,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,4BAA4B,CAAC,OAAe;QAClD,6DAA6D;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC;QAEpB,MAAM,SAAS,GAA6C;YAC1D,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;YACvC,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;YACvC,GAAG,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE;YAC7B,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE;YACzC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;YAC/B,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;YACxC,UAAU,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;YAC9B,WAAW,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;YACvC,aAAa,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE;YAC1C,cAAc,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE;SACpD,CAAC;QAEF,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,cAAoC,EAAE,OAAc;QAC7E,yBAAyB;QACzB,IAAI,cAAc,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iBAAiB;QACjB,IAAI,cAAc,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,+CAA+C;QAC/C,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,UAAU,CAAC,UAAU,GAAG,GAAG,IAAI,cAAc,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBAC3F,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,wBAAwB,CAAC,OAAc,EAAE,KAAa;QAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,mDAAmD,KAAK,4CAA4C,CAAC;QAC9G,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9E,OAAO,iBAAiB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC;QAC9H,CAAC;QAED,6BAA6B;QAC7B,MAAM,OAAO,GAAG,OAAO;aACpB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC;aAC/F,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO,+CAA+C,OAAO,6BAA6B,CAAC;IAC7F,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,KAAa;QAClC,wCAAwC;QACxC,MAAM,cAAc,GAAG;YACrB,eAAe;YACf,kBAAkB;YAClB,aAAa;YACb,UAAU;YACV,gBAAgB;YAChB,OAAO;YACP,MAAM;SACP,CAAC;QAEF,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,QAAgB,EAAE,SAAiB;QAC7D,mCAAmC;QACnC,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAE9E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,uCAAuC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,sDAAsD;QACtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAE5B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,CAAC,2BAA2B;QAC1C,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;YACtE,OAAO;gBACL,IAAI,EAAE,oBAAyC;gBAC/C,OAAO,EAAE,SAAS,QAAQ,+CAA+C;gBACzE,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBACtC,IAAI,EAAE,mBAAmB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,uBAAuB,QAAQ,CAAC,WAAW,UAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,eAAe;aAC1J,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAa,EAAE,MAAwB;QAM7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEpD,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI;YAC9C,CAAC,CAAC,YAAY,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,SAAS,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG;gBACrF,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,GAAG,GAAG,CAAC,eAAe;YACzE,CAAC,CAAC,yBAAyB,CAAC;QAE9B,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,IAAI;YACnC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM;YACvC,UAAU,EAAE,QAAQ,CAAC,cAAc,CAAC,UAAU;YAC9C,WAAW;SACZ,CAAC;IACJ,CAAC;CACF;AAED,qBAAqB;AACrB,IAAI,kBAAkB,GAA4B,IAAI,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgC;IAClE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC"}

package/dist/taxonomy/error-recovery.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Rich Error Recovery with Taxonomy Suggestions
+ *
+ * Provides intelligent error messages with suggestions based on
+ * the semantic taxonomy. Helps users and AI understand how to
+ * fix mistakes and find the right tools.
+ */
+import type { SupportedLocale } from '../i18n/types.js';
+import type { TaxonomyErrorCode, TaxonomyMatch } from './types.js';
+/**
+ * Error recovery context with rich suggestions
+ */
+export interface ErrorRecoveryContext {
+    /** The original error */
+    error: string;
+    /** Error code for programmatic handling */
+    code: TaxonomyErrorCode | string;
+    /** Human-readable hint */
+    hint?: string;
+    /** Suggested alternative tools or actions */
+    suggestions?: string[];
+    /** Available items that might be relevant */
+    availableItems?: Array<{
+        id: string;
+        type: string;
+    }>;
+    /** Similar concepts from taxonomy */
+    similarConcepts?: TaxonomyMatch[];
+    /** Did you mean this item? */
+    didYouMean?: string;
+    /** Example of correct usage */
+    example?: string;
+}
+/**
+ * Build rich error recovery context for common errors
+ */
+export declare function buildErrorRecovery(errorType: string, context: {
+    failedId?: string;
+    availableItems?: Array<{
+        id: string;
+        type: string;
+    }>;
+    userInput?: string;
+    toolName?: string;
+    locale?: SupportedLocale;
+}): ErrorRecoveryContext;
+/**
+ * Format error context for MCP response
+ */
+export declare function formatRichError(context: ErrorRecoveryContext): string;
+/**
+ * Build taxonomy-aware error for tool validation
+ */
+export declare function validateToolWithTaxonomy(toolName: string, userInput: string, locale?: SupportedLocale): Promise<ErrorRecoveryContext | null>;
+//# sourceMappingURL=error-recovery.d.ts.map

package/dist/taxonomy/error-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-recovery.d.ts","sourceRoot":"","sources":["../../src/taxonomy/error-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAiB,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIlF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACjC,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,qCAAqC;IACrC,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,GACA,oBAAoB,CA0FtB;AA6ED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA2BrE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyBtC"}