@frontmcp/plugins 0.6.0 → 0.6.2

package/src/codecall/services/error-enrichment.service.js

@@ -1,387 +0,0 @@
-"use strict";
-// file: libs/plugins/src/codecall/services/error-enrichment.service.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorEnrichmentService = exports.ERROR_CATEGORIES = void 0;
-const tslib_1 = require("tslib");
-const sdk_1 = require("@frontmcp/sdk");
-/**
- * Error categories for classification.
- */
-exports.ERROR_CATEGORIES = {
-    /** Script syntax or parsing error */
-    SYNTAX: 'syntax',
-    /** AST validation blocked dangerous code */
-    SECURITY: 'security',
-    /** Script exceeded timeout */
-    TIMEOUT: 'timeout',
-    /** Tool not found */
-    TOOL_NOT_FOUND: 'tool_not_found',
-    /** Tool access denied */
-    TOOL_ACCESS_DENIED: 'tool_access_denied',
-    /** Tool validation error */
-    TOOL_VALIDATION: 'tool_validation',
-    /** Tool execution error */
-    TOOL_EXECUTION: 'tool_execution',
-    /** Runtime error in script */
-    RUNTIME: 'runtime',
-    /** Unknown error */
-    UNKNOWN: 'unknown',
-};
-/**
- * Error patterns for classification and enrichment.
- */
-const ERROR_PATTERNS = [
-    // Syntax errors
-    {
-        pattern: /SyntaxError|Unexpected token|Unexpected identifier|missing \)|missing \}/i,
-        category: exports.ERROR_CATEGORIES.SYNTAX,
-        suggestions: [
-            'Check for missing parentheses, brackets, or braces',
-            'Verify all strings are properly quoted',
-            'Ensure semicolons are used correctly (if required)',
-            'Check for typos in keywords like "function", "return", "const"',
-        ],
-        recoverable: true,
-    },
-    {
-        pattern: /Unterminated string|Invalid or unexpected token/i,
-        category: exports.ERROR_CATEGORIES.SYNTAX,
-        suggestions: [
-            'Check that all strings are closed with matching quotes',
-            'Ensure template literals use backticks (`)',
-            'Verify there are no unescaped special characters in strings',
-        ],
-        recoverable: true,
-    },
-    // Security errors (AST validation)
-    {
-        pattern: /eval|Function constructor|dangerous pattern|blocked|forbidden/i,
-        category: exports.ERROR_CATEGORIES.SECURITY,
-        suggestions: [
-            'Avoid using eval() or new Function()',
-            'Do not access global objects like process, require, or import',
-            'Use callTool() to interact with external systems',
-        ],
-        docs: ['codecall/security'],
-        recoverable: true,
-    },
-    {
-        pattern: /self.?reference|codecall:/i,
-        category: exports.ERROR_CATEGORIES.SECURITY,
-        suggestions: [
-            'CodeCall tools (codecall:*) cannot be called from within scripts',
-            'Use the tools directly from your LLM context instead',
-        ],
-        recoverable: false,
-    },
-    // Timeout errors
-    {
-        pattern: /timeout|timed out|exceeded.*time/i,
-        category: exports.ERROR_CATEGORIES.TIMEOUT,
-        suggestions: [
-            'Reduce the number of tool calls in your script',
-            'Avoid infinite loops or deep recursion',
-            'Break large operations into smaller scripts',
-            'Consider using pagination for data fetching',
-        ],
-        recoverable: true,
-    },
-    // Tool not found
-    {
-        pattern: /tool.*not found|unknown tool|no such tool/i,
-        category: exports.ERROR_CATEGORIES.TOOL_NOT_FOUND,
-        suggestions: [
-            'Use codecall:search to find available tools',
-            'Check the tool name for typos',
-            'Verify the tool is available in your current context',
-        ],
-        example: `// First search for the tool
-const results = await codecall:search({ query: "user management" });
-
-// Then use the correct tool name
-const user = await callTool('users:getById', { id: '123' });`,
-        recoverable: true,
-    },
-    // Tool access denied
-    {
-        pattern: /access denied|permission denied|not authorized|forbidden/i,
-        category: exports.ERROR_CATEGORIES.TOOL_ACCESS_DENIED,
-        suggestions: [
-            'Check if the tool is in the allowedTools list',
-            'Verify your authentication credentials',
-            'Contact your administrator for access',
-        ],
-        recoverable: false,
-    },
-    // Tool validation errors
-    {
-        pattern: /validation|invalid input|required.*missing|type.*expected/i,
-        category: exports.ERROR_CATEGORIES.TOOL_VALIDATION,
-        suggestions: [
-            'Use codecall:describe to check the tool input schema',
-            'Ensure all required parameters are provided',
-            'Verify parameter types match the schema',
-        ],
-        example: `// Check tool schema first
-const schema = await codecall:describe({ toolNames: ['users:create'] });
-
-// Then provide correct input
-const user = await callTool('users:create', {
-  name: 'John',      // required: string
-  email: 'j@ex.com', // required: string
-  age: 30            // optional: number
-});`,
-        recoverable: true,
-    },
-    // Runtime errors
-    {
-        pattern: /TypeError|ReferenceError|is not defined|is not a function|cannot read property/i,
-        category: exports.ERROR_CATEGORIES.RUNTIME,
-        suggestions: [
-            'Check that all variables are defined before use',
-            'Verify function names and property access',
-            'Handle null/undefined values with optional chaining (?.) or nullish coalescing (??)',
-        ],
-        example: `// Use optional chaining for safe property access
-const name = result?.user?.name ?? 'Unknown';
-
-// Check for undefined before using
-if (result && result.data) {
-  return result.data;
-}`,
-        recoverable: true,
-    },
-    {
-        pattern: /Maximum call stack|stack overflow|too much recursion/i,
-        category: exports.ERROR_CATEGORIES.RUNTIME,
-        suggestions: [
-            'Check for infinite recursion in your script',
-            'Add a base case to recursive functions',
-            'Consider using iteration instead of recursion',
-        ],
-        recoverable: true,
-    },
-];
-/**
- * Error Enrichment Service
- *
- * Transforms raw errors into user-friendly, actionable error messages.
- * Provides suggestions for fixing common errors and links to documentation.
- *
- * Security: Never exposes internal details, only provides helpful guidance.
- */
-let ErrorEnrichmentService = class ErrorEnrichmentService {
-    /**
-     * Enrich an error with category, suggestions, and examples.
-     *
-     * @param error - The error to enrich (Error object, string, or unknown)
-     * @param context - Optional context for more specific suggestions
-     * @returns Enriched error with actionable information
-     */
-    enrich(error, context) {
-        const message = this.extractMessage(error);
-        const code = this.extractCode(error);
-        // Try to match against known patterns
-        for (const pattern of ERROR_PATTERNS) {
-            if (pattern.pattern.test(message)) {
-                return {
-                    category: pattern.category,
-                    message: this.formatMessage(message, pattern.category),
-                    suggestions: this.contextualizeSuggestions(pattern.suggestions, context),
-                    docs: pattern.docs,
-                    example: pattern.example,
-                    code,
-                    recoverable: pattern.recoverable,
-                };
-            }
-        }
-        // Default to unknown error
-        return {
-            category: exports.ERROR_CATEGORIES.UNKNOWN,
-            message: this.formatMessage(message, exports.ERROR_CATEGORIES.UNKNOWN),
-            suggestions: [
-                'Check your script for errors',
-                'Use codecall:search to find available tools',
-                'Use codecall:describe to check tool schemas',
-            ],
-            code,
-            recoverable: true,
-        };
-    }
-    /**
-     * Enrich a tool-specific error.
-     */
-    enrichToolError(toolName, errorCode, rawMessage) {
-        switch (errorCode) {
-            case 'NOT_FOUND':
-                return {
-                    category: exports.ERROR_CATEGORIES.TOOL_NOT_FOUND,
-                    message: `Tool "${toolName}" was not found`,
-                    suggestions: [
-                        `Use codecall:search to find tools similar to "${toolName}"`,
-                        'Check the tool name for typos',
-                        'The tool may not be available in your current context',
-                    ],
-                    recoverable: true,
-                };
-            case 'ACCESS_DENIED':
-                return {
-                    category: exports.ERROR_CATEGORIES.TOOL_ACCESS_DENIED,
-                    message: `Access denied for tool "${toolName}"`,
-                    suggestions: [
-                        'Check if the tool is in your allowedTools list',
-                        'Verify your authentication credentials',
-                        'Contact your administrator if you need access',
-                    ],
-                    recoverable: false,
-                };
-            case 'VALIDATION':
-                return {
-                    category: exports.ERROR_CATEGORIES.TOOL_VALIDATION,
-                    message: `Input validation failed for tool "${toolName}"`,
-                    suggestions: [
-                        `Run codecall:describe({ toolNames: ['${toolName}'] }) to see the expected schema`,
-                        'Ensure all required parameters are provided',
-                        'Check that parameter types are correct',
-                    ],
-                    example: `// Get tool schema
-const info = await callTool('codecall:describe', { toolNames: ['${toolName}'] });
-console.log(info.tools[0].inputSchema);`,
-                    recoverable: true,
-                };
-            case 'TIMEOUT':
-                return {
-                    category: exports.ERROR_CATEGORIES.TIMEOUT,
-                    message: `Tool "${toolName}" execution timed out`,
-                    suggestions: [
-                        'The operation may be taking too long',
-                        'Try with simpler or smaller inputs',
-                        'Consider breaking the operation into smaller parts',
-                    ],
-                    recoverable: true,
-                };
-            case 'SELF_REFERENCE':
-                return {
-                    category: exports.ERROR_CATEGORIES.SECURITY,
-                    message: `Cannot call CodeCall tool "${toolName}" from within a script`,
-                    suggestions: [
-                        'CodeCall meta-tools (codecall:*) cannot be called from scripts',
-                        'Use these tools directly from your LLM conversation',
-                        'For tool calls, use regular tools instead',
-                    ],
-                    recoverable: false,
-                };
-            default:
-                return {
-                    category: exports.ERROR_CATEGORIES.TOOL_EXECUTION,
-                    message: `Tool "${toolName}" execution failed`,
-                    suggestions: [
-                        'Check the tool input parameters',
-                        'Try with simpler inputs to isolate the issue',
-                        'The tool may be temporarily unavailable',
-                    ],
-                    recoverable: true,
-                };
-        }
-    }
-    /**
-     * Create a brief error summary for logging.
-     */
-    summarize(error) {
-        const enriched = this.enrich(error);
-        return `[${enriched.category}] ${enriched.message}`;
-    }
-    /**
-     * Extract error message from various error types.
-     */
-    extractMessage(error) {
-        if (error instanceof Error) {
-            return error.message;
-        }
-        if (typeof error === 'string') {
-            return error;
-        }
-        if (error && typeof error === 'object' && 'message' in error) {
-            return String(error.message);
-        }
-        return 'An unknown error occurred';
-    }
-    /**
-     * Extract error code if available.
-     */
-    extractCode(error) {
-        if (error && typeof error === 'object' && 'code' in error) {
-            return String(error.code);
-        }
-        return undefined;
-    }
-    /**
-     * Format error message for user consumption.
-     * Removes technical details while keeping useful information.
-     */
-    formatMessage(message, category) {
-        // Remove file paths
-        let formatted = message.replace(/(?:\/[\w.-]+)+|(?:[A-Za-z]:\\[\w\\.-]+)+/g, '');
-        // Remove line numbers
-        formatted = formatted.replace(/:\d+:\d+/g, '');
-        // Remove stack traces
-        formatted = formatted.replace(/\n\s*at .*/g, '');
-        // Clean up whitespace
-        formatted = formatted.replace(/\s+/g, ' ').trim();
-        // Truncate if too long
-        if (formatted.length > 200) {
-            formatted = formatted.substring(0, 200) + '...';
-        }
-        // Add category prefix if message is too generic
-        if (formatted.length < 20) {
-            const prefix = this.getCategoryPrefix(category);
-            if (prefix) {
-                formatted = `${prefix}: ${formatted}`;
-            }
-        }
-        return formatted || 'An error occurred';
-    }
-    /**
-     * Get a human-readable prefix for error category.
-     */
-    getCategoryPrefix(category) {
-        switch (category) {
-            case exports.ERROR_CATEGORIES.SYNTAX:
-                return 'Syntax error';
-            case exports.ERROR_CATEGORIES.SECURITY:
-                return 'Security violation';
-            case exports.ERROR_CATEGORIES.TIMEOUT:
-                return 'Timeout';
-            case exports.ERROR_CATEGORIES.TOOL_NOT_FOUND:
-                return 'Tool not found';
-            case exports.ERROR_CATEGORIES.TOOL_ACCESS_DENIED:
-                return 'Access denied';
-            case exports.ERROR_CATEGORIES.TOOL_VALIDATION:
-                return 'Validation error';
-            case exports.ERROR_CATEGORIES.TOOL_EXECUTION:
-                return 'Execution error';
-            case exports.ERROR_CATEGORIES.RUNTIME:
-                return 'Runtime error';
-            default:
-                return 'Error';
-        }
-    }
-    /**
-     * Contextualize suggestions based on context.
-     */
-    contextualizeSuggestions(suggestions, context) {
-        if (!context?.toolName) {
-            return suggestions;
-        }
-        return suggestions.map((s) => s.replace(/the tool/gi, `"${context.toolName}"`));
-    }
-};
-exports.ErrorEnrichmentService = ErrorEnrichmentService;
-exports.ErrorEnrichmentService = ErrorEnrichmentService = tslib_1.__decorate([
-    (0, sdk_1.Provider)({
-        name: 'codecall:error-enrichment',
-        scope: sdk_1.ProviderScope.GLOBAL,
-    })
-], ErrorEnrichmentService);
-exports.default = ErrorEnrichmentService;
-//# sourceMappingURL=error-enrichment.service.js.map

package/src/codecall/services/error-enrichment.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-enrichment.service.js","sourceRoot":"","sources":["../../../../src/codecall/services/error-enrichment.service.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/plugins/src/codecall/services/error-enrichment.service.ts\n\nimport { Provider, ProviderScope } from '@frontmcp/sdk';\n\n/**\n * Error categories for classification.\n */\nexport const ERROR_CATEGORIES = {\n  /** Script syntax or parsing error */\n  SYNTAX: 'syntax',\n  /** AST validation blocked dangerous code */\n  SECURITY: 'security',\n  /** Script exceeded timeout */\n  TIMEOUT: 'timeout',\n  /** Tool not found */\n  TOOL_NOT_FOUND: 'tool_not_found',\n  /** Tool access denied */\n  TOOL_ACCESS_DENIED: 'tool_access_denied',\n  /** Tool validation error */\n  TOOL_VALIDATION: 'tool_validation',\n  /** Tool execution error */\n  TOOL_EXECUTION: 'tool_execution',\n  /** Runtime error in script */\n  RUNTIME: 'runtime',\n  /** Unknown error */\n  UNKNOWN: 'unknown',\n} as const;\n\nexport type ErrorCategory = (typeof ERROR_CATEGORIES)[keyof typeof ERROR_CATEGORIES];\n\n/**\n * Enriched error with actionable suggestions.\n */\nexport interface EnrichedError {\n  /** Error category */\n  category: ErrorCategory;\n  /** User-friendly error message */\n  message: string;\n  /** Actionable suggestions for fixing the error */\n  suggestions: string[];\n  /** Related documentation links */\n  docs?: string[];\n  /** Example of correct usage (if applicable) */\n  example?: string;\n  /** Original error code (if available) */\n  code?: string;\n  /** Whether the error is recoverable */\n  recoverable: boolean;\n}\n\n/**\n * Error patterns for classification.\n */\ninterface ErrorPattern {\n  /** Pattern to match against error message */\n  pattern: RegExp;\n  /** Category to assign */\n  category: ErrorCategory;\n  /** Suggestions for this error type */\n  suggestions: string[];\n  /** Documentation links */\n  docs?: string[];\n  /** Example of correct usage */\n  example?: string;\n  /** Whether this error is recoverable */\n  recoverable: boolean;\n}\n\n/**\n * Error patterns for classification and enrichment.\n */\nconst ERROR_PATTERNS: ErrorPattern[] = [\n  // Syntax errors\n  {\n    pattern: /SyntaxError|Unexpected token|Unexpected identifier|missing \\)|missing \\}/i,\n    category: ERROR_CATEGORIES.SYNTAX,\n    suggestions: [\n      'Check for missing parentheses, brackets, or braces',\n      'Verify all strings are properly quoted',\n      'Ensure semicolons are used correctly (if required)',\n      'Check for typos in keywords like \"function\", \"return\", \"const\"',\n    ],\n    recoverable: true,\n  },\n  {\n    pattern: /Unterminated string|Invalid or unexpected token/i,\n    category: ERROR_CATEGORIES.SYNTAX,\n    suggestions: [\n      'Check that all strings are closed with matching quotes',\n      'Ensure template literals use backticks (`)',\n      'Verify there are no unescaped special characters in strings',\n    ],\n    recoverable: true,\n  },\n\n  // Security errors (AST validation)\n  {\n    pattern: /eval|Function constructor|dangerous pattern|blocked|forbidden/i,\n    category: ERROR_CATEGORIES.SECURITY,\n    suggestions: [\n      'Avoid using eval() or new Function()',\n      'Do not access global objects like process, require, or import',\n      'Use callTool() to interact with external systems',\n    ],\n    docs: ['codecall/security'],\n    recoverable: true,\n  },\n  {\n    pattern: /self.?reference|codecall:/i,\n    category: ERROR_CATEGORIES.SECURITY,\n    suggestions: [\n      'CodeCall tools (codecall:*) cannot be called from within scripts',\n      'Use the tools directly from your LLM context instead',\n    ],\n    recoverable: false,\n  },\n\n  // Timeout errors\n  {\n    pattern: /timeout|timed out|exceeded.*time/i,\n    category: ERROR_CATEGORIES.TIMEOUT,\n    suggestions: [\n      'Reduce the number of tool calls in your script',\n      'Avoid infinite loops or deep recursion',\n      'Break large operations into smaller scripts',\n      'Consider using pagination for data fetching',\n    ],\n    recoverable: true,\n  },\n\n  // Tool not found\n  {\n    pattern: /tool.*not found|unknown tool|no such tool/i,\n    category: ERROR_CATEGORIES.TOOL_NOT_FOUND,\n    suggestions: [\n      'Use codecall:search to find available tools',\n      'Check the tool name for typos',\n      'Verify the tool is available in your current context',\n    ],\n    example: `// First search for the tool\nconst results = await codecall:search({ query: \"user management\" });\n\n// Then use the correct tool name\nconst user = await callTool('users:getById', { id: '123' });`,\n    recoverable: true,\n  },\n\n  // Tool access denied\n  {\n    pattern: /access denied|permission denied|not authorized|forbidden/i,\n    category: ERROR_CATEGORIES.TOOL_ACCESS_DENIED,\n    suggestions: [\n      'Check if the tool is in the allowedTools list',\n      'Verify your authentication credentials',\n      'Contact your administrator for access',\n    ],\n    recoverable: false,\n  },\n\n  // Tool validation errors\n  {\n    pattern: /validation|invalid input|required.*missing|type.*expected/i,\n    category: ERROR_CATEGORIES.TOOL_VALIDATION,\n    suggestions: [\n      'Use codecall:describe to check the tool input schema',\n      'Ensure all required parameters are provided',\n      'Verify parameter types match the schema',\n    ],\n    example: `// Check tool schema first\nconst schema = await codecall:describe({ toolNames: ['users:create'] });\n\n// Then provide correct input\nconst user = await callTool('users:create', {\n  name: 'John',      // required: string\n  email: 'j@ex.com', // required: string\n  age: 30            // optional: number\n});`,\n    recoverable: true,\n  },\n\n  // Runtime errors\n  {\n    pattern: /TypeError|ReferenceError|is not defined|is not a function|cannot read property/i,\n    category: ERROR_CATEGORIES.RUNTIME,\n    suggestions: [\n      'Check that all variables are defined before use',\n      'Verify function names and property access',\n      'Handle null/undefined values with optional chaining (?.) or nullish coalescing (??)',\n    ],\n    example: `// Use optional chaining for safe property access\nconst name = result?.user?.name ?? 'Unknown';\n\n// Check for undefined before using\nif (result && result.data) {\n  return result.data;\n}`,\n    recoverable: true,\n  },\n  {\n    pattern: /Maximum call stack|stack overflow|too much recursion/i,\n    category: ERROR_CATEGORIES.RUNTIME,\n    suggestions: [\n      'Check for infinite recursion in your script',\n      'Add a base case to recursive functions',\n      'Consider using iteration instead of recursion',\n    ],\n    recoverable: true,\n  },\n];\n\n/**\n * Error Enrichment Service\n *\n * Transforms raw errors into user-friendly, actionable error messages.\n * Provides suggestions for fixing common errors and links to documentation.\n *\n * Security: Never exposes internal details, only provides helpful guidance.\n */\n@Provider({\n  name: 'codecall:error-enrichment',\n  scope: ProviderScope.GLOBAL,\n})\nexport class ErrorEnrichmentService {\n  /**\n   * Enrich an error with category, suggestions, and examples.\n   *\n   * @param error - The error to enrich (Error object, string, or unknown)\n   * @param context - Optional context for more specific suggestions\n   * @returns Enriched error with actionable information\n   */\n  enrich(error: unknown, context?: { toolName?: string; scriptSnippet?: string }): EnrichedError {\n    const message = this.extractMessage(error);\n    const code = this.extractCode(error);\n\n    // Try to match against known patterns\n    for (const pattern of ERROR_PATTERNS) {\n      if (pattern.pattern.test(message)) {\n        return {\n          category: pattern.category,\n          message: this.formatMessage(message, pattern.category),\n          suggestions: this.contextualizeSuggestions(pattern.suggestions, context),\n          docs: pattern.docs,\n          example: pattern.example,\n          code,\n          recoverable: pattern.recoverable,\n        };\n      }\n    }\n\n    // Default to unknown error\n    return {\n      category: ERROR_CATEGORIES.UNKNOWN,\n      message: this.formatMessage(message, ERROR_CATEGORIES.UNKNOWN),\n      suggestions: [\n        'Check your script for errors',\n        'Use codecall:search to find available tools',\n        'Use codecall:describe to check tool schemas',\n      ],\n      code,\n      recoverable: true,\n    };\n  }\n\n  /**\n   * Enrich a tool-specific error.\n   */\n  enrichToolError(toolName: string, errorCode: string, rawMessage?: string): EnrichedError {\n    switch (errorCode) {\n      case 'NOT_FOUND':\n        return {\n          category: ERROR_CATEGORIES.TOOL_NOT_FOUND,\n          message: `Tool \"${toolName}\" was not found`,\n          suggestions: [\n            `Use codecall:search to find tools similar to \"${toolName}\"`,\n            'Check the tool name for typos',\n            'The tool may not be available in your current context',\n          ],\n          recoverable: true,\n        };\n\n      case 'ACCESS_DENIED':\n        return {\n          category: ERROR_CATEGORIES.TOOL_ACCESS_DENIED,\n          message: `Access denied for tool \"${toolName}\"`,\n          suggestions: [\n            'Check if the tool is in your allowedTools list',\n            'Verify your authentication credentials',\n            'Contact your administrator if you need access',\n          ],\n          recoverable: false,\n        };\n\n      case 'VALIDATION':\n        return {\n          category: ERROR_CATEGORIES.TOOL_VALIDATION,\n          message: `Input validation failed for tool \"${toolName}\"`,\n          suggestions: [\n            `Run codecall:describe({ toolNames: ['${toolName}'] }) to see the expected schema`,\n            'Ensure all required parameters are provided',\n            'Check that parameter types are correct',\n          ],\n          example: `// Get tool schema\nconst info = await callTool('codecall:describe', { toolNames: ['${toolName}'] });\nconsole.log(info.tools[0].inputSchema);`,\n          recoverable: true,\n        };\n\n      case 'TIMEOUT':\n        return {\n          category: ERROR_CATEGORIES.TIMEOUT,\n          message: `Tool \"${toolName}\" execution timed out`,\n          suggestions: [\n            'The operation may be taking too long',\n            'Try with simpler or smaller inputs',\n            'Consider breaking the operation into smaller parts',\n          ],\n          recoverable: true,\n        };\n\n      case 'SELF_REFERENCE':\n        return {\n          category: ERROR_CATEGORIES.SECURITY,\n          message: `Cannot call CodeCall tool \"${toolName}\" from within a script`,\n          suggestions: [\n            'CodeCall meta-tools (codecall:*) cannot be called from scripts',\n            'Use these tools directly from your LLM conversation',\n            'For tool calls, use regular tools instead',\n          ],\n          recoverable: false,\n        };\n\n      default:\n        return {\n          category: ERROR_CATEGORIES.TOOL_EXECUTION,\n          message: `Tool \"${toolName}\" execution failed`,\n          suggestions: [\n            'Check the tool input parameters',\n            'Try with simpler inputs to isolate the issue',\n            'The tool may be temporarily unavailable',\n          ],\n          recoverable: true,\n        };\n    }\n  }\n\n  /**\n   * Create a brief error summary for logging.\n   */\n  summarize(error: unknown): string {\n    const enriched = this.enrich(error);\n    return `[${enriched.category}] ${enriched.message}`;\n  }\n\n  /**\n   * Extract error message from various error types.\n   */\n  private extractMessage(error: unknown): string {\n    if (error instanceof Error) {\n      return error.message;\n    }\n    if (typeof error === 'string') {\n      return error;\n    }\n    if (error && typeof error === 'object' && 'message' in error) {\n      return String((error as { message: unknown }).message);\n    }\n    return 'An unknown error occurred';\n  }\n\n  /**\n   * Extract error code if available.\n   */\n  private extractCode(error: unknown): string | undefined {\n    if (error && typeof error === 'object' && 'code' in error) {\n      return String((error as { code: unknown }).code);\n    }\n    return undefined;\n  }\n\n  /**\n   * Format error message for user consumption.\n   * Removes technical details while keeping useful information.\n   */\n  private formatMessage(message: string, category: ErrorCategory): string {\n    // Remove file paths\n    let formatted = message.replace(/(?:\\/[\\w.-]+)+|(?:[A-Za-z]:\\\\[\\w\\\\.-]+)+/g, '');\n\n    // Remove line numbers\n    formatted = formatted.replace(/:\\d+:\\d+/g, '');\n\n    // Remove stack traces\n    formatted = formatted.replace(/\\n\\s*at .*/g, '');\n\n    // Clean up whitespace\n    formatted = formatted.replace(/\\s+/g, ' ').trim();\n\n    // Truncate if too long\n    if (formatted.length > 200) {\n      formatted = formatted.substring(0, 200) + '...';\n    }\n\n    // Add category prefix if message is too generic\n    if (formatted.length < 20) {\n      const prefix = this.getCategoryPrefix(category);\n      if (prefix) {\n        formatted = `${prefix}: ${formatted}`;\n      }\n    }\n\n    return formatted || 'An error occurred';\n  }\n\n  /**\n   * Get a human-readable prefix for error category.\n   */\n  private getCategoryPrefix(category: ErrorCategory): string {\n    switch (category) {\n      case ERROR_CATEGORIES.SYNTAX:\n        return 'Syntax error';\n      case ERROR_CATEGORIES.SECURITY:\n        return 'Security violation';\n      case ERROR_CATEGORIES.TIMEOUT:\n        return 'Timeout';\n      case ERROR_CATEGORIES.TOOL_NOT_FOUND:\n        return 'Tool not found';\n      case ERROR_CATEGORIES.TOOL_ACCESS_DENIED:\n        return 'Access denied';\n      case ERROR_CATEGORIES.TOOL_VALIDATION:\n        return 'Validation error';\n      case ERROR_CATEGORIES.TOOL_EXECUTION:\n        return 'Execution error';\n      case ERROR_CATEGORIES.RUNTIME:\n        return 'Runtime error';\n      default:\n        return 'Error';\n    }\n  }\n\n  /**\n   * Contextualize suggestions based on context.\n   */\n  private contextualizeSuggestions(suggestions: string[], context?: { toolName?: string }): string[] {\n    if (!context?.toolName) {\n      return suggestions;\n    }\n\n    return suggestions.map((s) => s.replace(/the tool/gi, `\"${context.toolName}\"`));\n  }\n}\n\nexport default ErrorEnrichmentService;\n"]}

package/src/codecall/services/index.js

@@ -1,13 +0,0 @@
-"use strict";
-// file: libs/plugins/src/codecall/services/index.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnclaveService = void 0;
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./audit-logger.service"), exports);
-tslib_1.__exportStar(require("./output-sanitizer"), exports);
-tslib_1.__exportStar(require("./error-enrichment.service"), exports);
-tslib_1.__exportStar(require("./tool-search.service"), exports);
-tslib_1.__exportStar(require("./synonym-expansion.service"), exports);
-var enclave_service_1 = require("./enclave.service");
-Object.defineProperty(exports, "EnclaveService", { enumerable: true, get: function () { return tslib_1.__importDefault(enclave_service_1).default; } });
-//# sourceMappingURL=index.js.map

package/src/codecall/services/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/codecall/services/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;;AAEpD,iEAAuC;AACvC,6DAAmC;AACnC,qEAA2C;AAC3C,gEAAsC;AACtC,sEAA4C;AAC5C,qDAA8D;AAArD,0IAAA,OAAO,OAAkB","sourcesContent":["// file: libs/plugins/src/codecall/services/index.ts\n\nexport * from './audit-logger.service';\nexport * from './output-sanitizer';\nexport * from './error-enrichment.service';\nexport * from './tool-search.service';\nexport * from './synonym-expansion.service';\nexport { default as EnclaveService } from './enclave.service';\n"]}