@frontmcp/plugins 0.4.1 → 0.5.1

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

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,6 @@
+export * from './audit-logger.service';
+export * from './output-sanitizer';
+export * from './error-enrichment.service';
+export * from './tool-search.service';
+export * from './synonym-expansion.service';
+export { default as EnclaveService } from './enclave.service';

package/src/codecall/services/index.js

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

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

package/src/codecall/services/output-sanitizer.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Output Sanitizer for CodeCall
+ *
+ * Sanitizes script outputs to prevent information leakage through:
+ * - Error messages with stack traces or file paths
+ * - Large outputs that could contain sensitive data
+ * - Recursive structures that could cause DoS
+ *
+ * Security considerations:
+ * - All sanitization is defensive (fail-safe)
+ * - Outputs are truncated, not rejected
+ * - Circular references are handled
+ * - Prototype pollution is prevented
+ */
+/**
+ * Configuration for output sanitization.
+ */
+export interface OutputSanitizerConfig {
+    /**
+     * Maximum depth for nested objects/arrays.
+     * @default 10
+     */
+    maxDepth: number;
+    /**
+     * Maximum length for string values.
+     * @default 10000
+     */
+    maxStringLength: number;
+    /**
+     * Maximum number of keys in an object.
+     * @default 100
+     */
+    maxObjectKeys: number;
+    /**
+     * Maximum number of items in an array.
+     * @default 1000
+     */
+    maxArrayLength: number;
+    /**
+     * Maximum total size of serialized output in bytes.
+     * @default 1MB
+     */
+    maxTotalSize: number;
+    /**
+     * Remove error stack traces.
+     * @default true
+     */
+    removeStackTraces: boolean;
+    /**
+     * Remove file paths from strings.
+     * @default true
+     */
+    removeFilePaths: boolean;
+}
+/**
+ * Default sanitization configuration.
+ */
+export declare const DEFAULT_SANITIZER_CONFIG: OutputSanitizerConfig;
+/**
+ * Result of sanitization.
+ */
+export interface SanitizationResult<T> {
+    /** Sanitized value */
+    value: T;
+    /** Whether any sanitization was applied */
+    wasModified: boolean;
+    /** Warnings about what was sanitized */
+    warnings: string[];
+}
+/**
+ * Sanitize output from CodeCall script execution.
+ *
+ * @param output - Raw output from script
+ * @param config - Sanitization configuration
+ * @returns Sanitized output with metadata
+ */
+export declare function sanitizeOutput<T = unknown>(output: unknown, config?: Partial<OutputSanitizerConfig>): SanitizationResult<T>;
+/**
+ * Quick check if a value needs sanitization.
+ * Used for optimization - skip sanitization for simple values.
+ */
+export declare function needsSanitization(value: unknown): boolean;
+/**
+ * Sanitize a log message (less aggressive than output sanitization).
+ */
+export declare function sanitizeLogMessage(message: string, maxLength?: number): string;