@pinepaper.studio/mcp-server 1.3.0 → 1.3.2

package/dist/taxonomy/error-recovery.js

@@ -0,0 +1,205 @@
+/**
+ * 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 { getTaxonomyMatcher } from './matcher.js';
+/**
+ * Build rich error recovery context for common errors
+ */
+export function buildErrorRecovery(errorType, context) {
+    const { failedId, availableItems = [], userInput, toolName, locale } = context;
+    switch (errorType) {
+        case 'ITEM_NOT_FOUND': {
+            const similar = findSimilarItemId(failedId || '', availableItems);
+            return {
+                error: `Item "${failedId}" not found`,
+                code: 'ITEM_NOT_FOUND',
+                hint: similar
+                    ? `Did you mean "${similar}"?`
+                    : 'Use pinepaper_get_items to list all available items',
+                suggestions: ['pinepaper_get_items'],
+                availableItems: availableItems.slice(0, 5),
+                didYouMean: similar,
+                example: `pinepaper_modify_item({ itemId: "${similar || 'item_1'}", properties: {...} })`,
+            };
+        }
+        case 'INVALID_RELATION': {
+            return {
+                error: 'Invalid relation type or missing target',
+                code: 'INVALID_RELATION',
+                hint: 'Relations require both sourceId and targetId to exist',
+                suggestions: ['pinepaper_get_items', 'pinepaper_query_relations'],
+                availableItems: availableItems.slice(0, 5),
+                example: `pinepaper_add_relation({ sourceId: "item_1", targetId: "item_2", relationType: "orbits" })`,
+            };
+        }
+        case 'GENERATOR_NOT_FOUND': {
+            const generators = [
+                'drawSunburst',
+                'drawWaves',
+                'drawGrid',
+                'drawCircuit',
+                'drawSunsetScene',
+                'drawStackedCircles',
+                'drawPattern',
+            ];
+            return {
+                error: 'Generator not found',
+                code: 'GENERATOR_NOT_FOUND',
+                hint: 'Available generators: ' + generators.join(', '),
+                suggestions: ['pinepaper_list_generators'],
+                example: `pinepaper_execute_generator({ generatorName: "drawSunburst" })`,
+            };
+        }
+        case 'TOOL_MISMATCH': {
+            // Use taxonomy to suggest better tool
+            const taxonomyMatcher = getTaxonomyMatcher();
+            let similarConcepts = [];
+            if (userInput) {
+                // This is synchronous lookup from already-built index
+                taxonomyMatcher.findMatches(userInput, locale).then((matches) => {
+                    similarConcepts = matches.slice(0, 3);
+                });
+            }
+            return {
+                error: `Tool "${toolName}" may not be the best choice for this request`,
+                code: 'TOOL_MISMATCH',
+                hint: similarConcepts.length > 0
+                    ? `Consider using "${similarConcepts[0]?.node.tool.tool}" instead`
+                    : 'Use pinepaper_recommend_approach for tool suggestions',
+                suggestions: similarConcepts.map((m) => m.node.tool.tool),
+                similarConcepts,
+            };
+        }
+        case 'VALIDATION_ERROR': {
+            return {
+                error: 'Invalid parameters provided',
+                code: 'VALIDATION_ERROR',
+                hint: 'Check the tool documentation for required and optional parameters',
+                suggestions: ['Check tool inputSchema for required fields'],
+                example: getToolExample(toolName || ''),
+            };
+        }
+        default:
+            return {
+                error: errorType,
+                code: 'UNKNOWN_ERROR',
+                hint: 'Check the MCP server logs for more details',
+                suggestions: ['pinepaper_get_items', 'pinepaper_browser_status'],
+            };
+    }
+}
+/**
+ * Find a similar item ID using Levenshtein distance
+ */
+function findSimilarItemId(failedId, availableItems) {
+    if (!failedId || availableItems.length === 0)
+        return undefined;
+    let bestMatch;
+    let bestDistance = Infinity;
+    for (const item of availableItems) {
+        const distance = levenshteinDistance(failedId.toLowerCase(), item.id.toLowerCase());
+        if (distance < bestDistance && distance <= 3) {
+            // Allow up to 3 edits
+            bestDistance = distance;
+            bestMatch = item.id;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Calculate Levenshtein distance between two strings
+ */
+function levenshteinDistance(str1, str2) {
+    const m = str1.length;
+    const n = str2.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    const dp = Array(m + 1)
+        .fill(null)
+        .map(() => Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (str1[i - 1] === str2[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1];
+            }
+            else {
+                dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + 1);
+            }
+        }
+    }
+    return dp[m][n];
+}
+/**
+ * Get an example usage for a tool
+ */
+function getToolExample(toolName) {
+    const examples = {
+        pinepaper_create_item: `pinepaper_create_item({ itemType: "circle", position: {x: 400, y: 300}, properties: {radius: 50, color: "#3b82f6"} })`,
+        pinepaper_modify_item: `pinepaper_modify_item({ itemId: "item_1", properties: {color: "#ef4444"} })`,
+        pinepaper_delete_item: `pinepaper_delete_item({ itemId: "item_1" })`,
+        pinepaper_add_relation: `pinepaper_add_relation({ sourceId: "item_1", targetId: "item_2", relationType: "orbits", params: {radius: 100, speed: 0.5} })`,
+        pinepaper_animate: `pinepaper_animate({ itemId: "item_1", animationType: "pulse", speed: 0.5 })`,
+        pinepaper_execute_generator: `pinepaper_execute_generator({ generatorName: "drawSunburst" })`,
+        pinepaper_create_scene: `pinepaper_create_scene({ items: [{name: "sun", itemType: "circle", properties: {radius: 50, color: "#fbbf24"}}], animations: [{target: "sun", type: "pulse"}] })`,
+    };
+    return examples[toolName] || `${toolName}({ /* see tool definition */ })`;
+}
+/**
+ * Format error context for MCP response
+ */
+export function formatRichError(context) {
+    const parts = [];
+    parts.push(`Error: ${context.error}`);
+    if (context.hint) {
+        parts.push(`Hint: ${context.hint}`);
+    }
+    if (context.didYouMean) {
+        parts.push(`Did you mean: "${context.didYouMean}"`);
+    }
+    if (context.availableItems && context.availableItems.length > 0) {
+        const itemList = context.availableItems.map((i) => `${i.id} (${i.type})`).join(', ');
+        parts.push(`Available items: ${itemList}`);
+    }
+    if (context.suggestions && context.suggestions.length > 0) {
+        parts.push(`Suggestions: ${context.suggestions.join(', ')}`);
+    }
+    if (context.example) {
+        parts.push(`Example: ${context.example}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Build taxonomy-aware error for tool validation
+ */
+export async function validateToolWithTaxonomy(toolName, userInput, locale) {
+    const matcher = getTaxonomyMatcher();
+    await matcher.initialize();
+    const matches = await matcher.findMatches(userInput, locale);
+    if (matches.length === 0) {
+        return null; // Can't validate without matches
+    }
+    const topMatch = matches[0];
+    // Check if the selected tool matches the taxonomy recommendation
+    if (topMatch.node.tool.tool !== toolName && topMatch.similarity > 0.8) {
+        return {
+            error: `Tool "${toolName}" may not be optimal for this request`,
+            code: 'TOOL_MISMATCH',
+            hint: `The taxonomy suggests "${topMatch.node.tool.tool}" based on "${topMatch.matchedTerm}"`,
+            suggestions: [topMatch.node.tool.tool],
+            similarConcepts: matches.slice(0, 3),
+            example: getToolExample(topMatch.node.tool.tool),
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=error-recovery.js.map

package/dist/taxonomy/error-recovery.js.map

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

package/dist/taxonomy/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Semantic Taxonomy System
+ *
+ * Provides multilingual semantic tool selection for the PinePaper MCP server.
+ * This module exports all taxonomy-related functionality.
+ *
+ * @example
+ * import { getIntentClassifier, getTaxonomyMatcher } from './taxonomy/index.js';
+ *
+ * const classifier = getIntentClassifier();
+ * await classifier.initialize();
+ *
+ * // Classify user intent in any language
+ * const analysis = await classifier.classify("faire tourner la lune autour de la terre");
+ * console.log(analysis.recommendedTool); // { name: 'pinepaper_add_relation', params: {...} }
+ */
+export type { TaxonomyNode, ModifierNode, TaxonomyCategory, MultilingualTerms, ToolMapping, ParameterExtractor, SchemaOrgReference, ClassificationResult, TaxonomyMatch, ExtractedEntity, IntentAnalysis, TaxonomyConfig, TaxonomyError, TaxonomyErrorCode, } from './types.js';
+export { DEFAULT_TAXONOMY_CONFIG } from './types.js';
+export { ANIMATION_TAXONOMY, MOTION_TAXONOMY, TRANSFORMATION_TAXONOMY, ITEM_TAXONOMY, BACKGROUND_TAXONOMY, MODIFIER_NODES, getTaxonomyNode, getNodesByCategory, getModifier, } from './registry.js';
+export { TaxonomyMatcher, getTaxonomyMatcher, resetTaxonomyMatcher, } from './matcher.js';
+export { IntentClassifier, getIntentClassifier, resetIntentClassifier, } from './classifier.js';
+export type { ErrorRecoveryContext } from './error-recovery.js';
+export { buildErrorRecovery, formatRichError, validateToolWithTaxonomy, } from './error-recovery.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/taxonomy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,wBAAwB,GACzB,MAAM,qBAAqB,CAAC"}

package/dist/taxonomy/index.js

@@ -0,0 +1,25 @@
+/**
+ * Semantic Taxonomy System
+ *
+ * Provides multilingual semantic tool selection for the PinePaper MCP server.
+ * This module exports all taxonomy-related functionality.
+ *
+ * @example
+ * import { getIntentClassifier, getTaxonomyMatcher } from './taxonomy/index.js';
+ *
+ * const classifier = getIntentClassifier();
+ * await classifier.initialize();
+ *
+ * // Classify user intent in any language
+ * const analysis = await classifier.classify("faire tourner la lune autour de la terre");
+ * console.log(analysis.recommendedTool); // { name: 'pinepaper_add_relation', params: {...} }
+ */
+export { DEFAULT_TAXONOMY_CONFIG } from './types.js';
+// Registry exports
+export { ANIMATION_TAXONOMY, MOTION_TAXONOMY, TRANSFORMATION_TAXONOMY, ITEM_TAXONOMY, BACKGROUND_TAXONOMY, MODIFIER_NODES, getTaxonomyNode, getNodesByCategory, getModifier, } from './registry.js';
+// Matcher exports
+export { TaxonomyMatcher, getTaxonomyMatcher, resetTaxonomyMatcher, } from './matcher.js';
+// Classifier exports
+export { IntentClassifier, getIntentClassifier, resetIntentClassifier, } from './classifier.js';
+export { buildErrorRecovery, formatRichError, validateToolWithTaxonomy, } from './error-recovery.js';
+//# sourceMappingURL=index.js.map

package/dist/taxonomy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/taxonomy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,wBAAwB,GACzB,MAAM,qBAAqB,CAAC"}

package/dist/taxonomy/matcher.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Semantic Taxonomy Matcher
+ *
+ * Provides fast keyword-based matching with fallback to pattern matching.
+ * Uses a hybrid approach: keyword index for exact matches, pattern matching
+ * for fuzzy matches, and can be extended with embeddings for semantic search.
+ */
+import type { SupportedLocale } from '../i18n/types.js';
+import type { TaxonomyNode, ModifierNode, TaxonomyMatch, TaxonomyConfig } from './types.js';
+/**
+ * Modifier match result
+ */
+interface ModifierMatch {
+    modifier: ModifierNode;
+    matched: boolean;
+    extractedValue?: string | number;
+}
+/**
+ * Semantic Taxonomy Matcher
+ *
+ * Provides fast, multilingual matching of user input to taxonomy concepts.
+ */
+export declare class TaxonomyMatcher {
+    private keywordIndex;
+    private phraseIndex;
+    private config;
+    private initialized;
+    constructor(config?: Partial<TaxonomyConfig>);
+    /**
+     * Initialize the matcher by building keyword indexes
+     */
+    initialize(): Promise<void>;
+    /**
+     * Build the keyword index for fast lookups
+     */
+    private buildKeywordIndex;
+    /**
+     * Build the phrase index for multi-word matches
+     */
+    private buildPhraseIndex;
+    /**
+     * Find the best matching taxonomy nodes for user input
+     */
+    findMatches(input: string, preferredLocale?: SupportedLocale): Promise<TaxonomyMatch[]>;
+    /**
+     * Find exact phrase matches
+     */
+    private findPhraseMatches;
+    /**
+     * Find keyword matches
+     */
+    private findKeywordMatches;
+    /**
+     * Find pattern-based matches (fuzzy matching)
+     */
+    private findPatternMatches;
+    /**
+     * Calculate string similarity using a combination of techniques
+     */
+    private calculateStringSimilarity;
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    private levenshteinDistance;
+    /**
+     * Detect modifiers in user input
+     */
+    detectModifiers(input: string, locale?: SupportedLocale): ModifierMatch[];
+    /**
+     * Extract parameter values from input using tool's extractors
+     */
+    extractParameters(input: string, node: TaxonomyNode, locale?: SupportedLocale): Record<string, unknown>;
+    /**
+     * Detect the language of the input
+     * Simple heuristic based on character analysis
+     */
+    detectLocale(input: string): SupportedLocale;
+    /**
+     * Get the best single match
+     */
+    findBestMatch(input: string, locale?: SupportedLocale): Promise<TaxonomyMatch | null>;
+    /**
+     * Check if matcher is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get configuration
+     */
+    getConfig(): TaxonomyConfig;
+    /**
+     * Update configuration
+     */
+    setConfig(config: Partial<TaxonomyConfig>): void;
+}
+/**
+ * Get or create the singleton TaxonomyMatcher instance
+ */
+export declare function getTaxonomyMatcher(config?: Partial<TaxonomyConfig>): TaxonomyMatcher;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetTaxonomyMatcher(): void;
+export {};
+//# sourceMappingURL=matcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/taxonomy/matcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EAEf,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,UAAU,aAAa;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAWhD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA+B7F;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiD1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA8BjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,aAAa,EAAE;IAiDzE;;OAEG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA2B1B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAqE5C;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3F;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,cAAc;IAI3B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;CAGjD;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,eAAe,CAKpF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}