@nexus-cortex/core 4.26.0

package/dist/mcp/McpServerRegistry.js

@@ -0,0 +1,281 @@
+/**
+ * MCP Server Registry
+ *
+ * Registry of known MCP servers (community + custom).
+ * Provides server definitions, capabilities, and search functionality.
+ *
+ * Phase 2.5 Day 4.5: MCP Auto-Injection System
+ */
+/**
+ * MCP Server Registry
+ *
+ * Manages known MCP servers and provides search/discovery functionality.
+ */
+export class McpServerRegistry {
+    servers = new Map();
+    constructor() {
+        // Auto-load community registry on construction
+        this.loadCommunityRegistry();
+    }
+    /**
+     * Load community registry (built-in verified servers)
+     */
+    loadCommunityRegistry() {
+        const communityServers = [
+            // Filesystem server
+            {
+                name: 'filesystem',
+                displayName: 'Filesystem',
+                description: 'File system operations (read, write, list, search files and directories)',
+                category: 'filesystem',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-filesystem'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-filesystem',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem',
+                capabilities: ['read_file', 'write_file', 'list_directory', 'search_files', 'get_file_info'],
+                recommendedFor: ['node', 'web', 'general']
+            },
+            // Puppeteer server
+            {
+                name: 'puppeteer',
+                displayName: 'Puppeteer',
+                description: 'Browser automation and web scraping using headless Chrome',
+                category: 'browser',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-puppeteer'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-puppeteer',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer',
+                capabilities: ['puppeteer_navigate', 'puppeteer_screenshot', 'puppeteer_click', 'puppeteer_fill', 'puppeteer_select'],
+                recommendedFor: ['web', 'testing', 'scraping']
+            },
+            // PostgreSQL server
+            {
+                name: 'postgres',
+                displayName: 'PostgreSQL',
+                description: 'PostgreSQL database access and query execution',
+                category: 'database',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-postgres'],
+                requiredEnv: ['DATABASE_URL'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-postgres',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/postgres',
+                capabilities: ['query', 'list_tables', 'describe_table', 'get_schema'],
+                recommendedFor: ['database', 'backend']
+            },
+            // SQLite server
+            {
+                name: 'sqlite',
+                displayName: 'SQLite',
+                description: 'SQLite database access and query execution',
+                category: 'database',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-sqlite'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-sqlite',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite',
+                capabilities: ['query', 'list_tables', 'describe_table', 'create_table'],
+                recommendedFor: ['database', 'mobile', 'desktop']
+            },
+            // GitHub server
+            {
+                name: 'github',
+                displayName: 'GitHub',
+                description: 'GitHub API integration for repository operations',
+                category: 'api',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-github'],
+                requiredEnv: ['GITHUB_TOKEN'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-github',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/github',
+                capabilities: ['create_issue', 'list_issues', 'get_file_contents', 'create_pull_request', 'search_repositories'],
+                recommendedFor: ['git', 'development']
+            },
+            // Slack server
+            {
+                name: 'slack',
+                displayName: 'Slack',
+                description: 'Slack workspace integration for messaging and collaboration',
+                category: 'productivity',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-slack'],
+                requiredEnv: ['SLACK_BOT_TOKEN'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-slack',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/slack',
+                capabilities: ['send_message', 'list_channels', 'get_channel_history', 'add_reaction'],
+                recommendedFor: ['productivity', 'communication']
+            },
+            // Git server
+            {
+                name: 'git',
+                displayName: 'Git',
+                description: 'Git repository operations and version control',
+                category: 'development',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-git'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-git',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/git',
+                capabilities: ['git_status', 'git_diff', 'git_log', 'git_commit', 'git_branch'],
+                recommendedFor: ['git', 'development']
+            },
+            // Memory server
+            {
+                name: 'memory',
+                displayName: 'Memory',
+                description: 'Persistent memory storage for conversations across sessions',
+                category: 'productivity',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-memory'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-memory',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/memory',
+                capabilities: ['store_memory', 'retrieve_memory', 'search_memory', 'delete_memory'],
+                recommendedFor: ['general', 'productivity']
+            },
+            // Brave Search server
+            {
+                name: 'brave-search',
+                displayName: 'Brave Search',
+                description: 'Web search using Brave Search API',
+                category: 'api',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-brave-search'],
+                requiredEnv: ['BRAVE_API_KEY'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-brave-search',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search',
+                capabilities: ['web_search', 'local_search', 'news_search'],
+                recommendedFor: ['research', 'general']
+            },
+            // Google Drive server
+            {
+                name: 'gdrive',
+                displayName: 'Google Drive',
+                description: 'Google Drive file access and management',
+                category: 'productivity',
+                command: 'npx',
+                defaultArgs: ['-y', '@modelcontextprotocol/server-gdrive'],
+                requiredEnv: ['GDRIVE_CLIENT_ID', 'GDRIVE_CLIENT_SECRET'],
+                verified: true,
+                npmPackage: '@modelcontextprotocol/server-gdrive',
+                documentation: 'https://github.com/modelcontextprotocol/servers/tree/main/src/gdrive',
+                capabilities: ['list_files', 'read_file', 'write_file', 'search_files'],
+                recommendedFor: ['productivity', 'collaboration']
+            }
+        ];
+        // Register all community servers
+        communityServers.forEach(server => {
+            this.servers.set(server.name, server);
+        });
+    }
+    /**
+     * Register a custom server
+     */
+    registerServer(definition) {
+        this.servers.set(definition.name, definition);
+    }
+    /**
+     * Get server definition by name
+     */
+    getServer(name) {
+        return this.servers.get(name);
+    }
+    /**
+     * Get all registered servers
+     */
+    getAllServers() {
+        return Array.from(this.servers.values());
+    }
+    /**
+     * Get servers by category
+     */
+    getServersByCategory(category) {
+        return Array.from(this.servers.values())
+            .filter(server => server.category === category);
+    }
+    /**
+     * Search servers by capability
+     */
+    searchByCapability(capability) {
+        return Array.from(this.servers.values())
+            .filter(server => server.capabilities?.some(cap => cap.toLowerCase().includes(capability.toLowerCase())));
+    }
+    /**
+     * Get recommended servers for a project type
+     */
+    getRecommendedServers(projectType) {
+        return Array.from(this.servers.values())
+            .filter(server => server.recommendedFor?.includes(projectType.toLowerCase()));
+    }
+    /**
+     * Search servers by query (searches name, description, capabilities)
+     */
+    search(query) {
+        const lowerQuery = query.toLowerCase();
+        return Array.from(this.servers.values())
+            .filter(server => {
+            // Search in name
+            if (server.name.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            // Search in display name
+            if (server.displayName.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            // Search in description
+            if (server.description.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            // Search in capabilities
+            if (server.capabilities?.some(cap => cap.toLowerCase().includes(lowerQuery))) {
+                return true;
+            }
+            return false;
+        });
+    }
+    /**
+     * Get verified (official) servers only
+     */
+    getVerifiedServers() {
+        return Array.from(this.servers.values())
+            .filter(server => server.verified);
+    }
+    /**
+     * Check if a server is registered
+     */
+    hasServer(name) {
+        return this.servers.has(name);
+    }
+    /**
+     * Get count of registered servers
+     */
+    getServerCount() {
+        return this.servers.size;
+    }
+    /**
+     * Remove a server from registry
+     */
+    unregisterServer(name) {
+        this.servers.delete(name);
+    }
+    /**
+     * Clear all servers (except community servers)
+     */
+    clearCustomServers() {
+        const communityServerNames = Array.from(this.servers.values())
+            .filter(s => s.verified)
+            .map(s => s.name);
+        // Remove all non-verified servers
+        Array.from(this.servers.keys()).forEach(name => {
+            if (!communityServerNames.includes(name)) {
+                this.servers.delete(name);
+            }
+        });
+    }
+}
+//# sourceMappingURL=McpServerRegistry.js.map

package/dist/mcp/McpServerRegistry.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP (Model Context Protocol) Infrastructure
+ *
+ * Minimal viable MCP implementation for Nexus Cortex.
+ * Provides client management and server communication via stdio transport.
+ */
+export { McpClient, McpConnectionStatus } from './McpClient.js';
+export type { McpServerConfig } from './McpClient.js';
+export { McpClientManager, McpDiscoveryState } from './McpClientManager.js';
+export type { McpServerInfo } from './McpClientManager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,9 @@
+/**
+ * MCP (Model Context Protocol) Infrastructure
+ *
+ * Minimal viable MCP implementation for Nexus Cortex.
+ * Provides client management and server communication via stdio transport.
+ */
+export { McpClient, McpConnectionStatus } from './McpClient.js';
+export { McpClientManager, McpDiscoveryState } from './McpClientManager.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mcp/mcpToolNamespacing.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP tool namespacing helpers.
+ *
+ * MCP servers (e.g. nexus-browser, filesystem) define tool names in their own
+ * naming convention — typically lowercase verbs (`browse`, `scan`,
+ * `read_text_file`). When multiple servers connect, or when a server's tool
+ * name overlaps with a native executor (e.g. `Read` vs `read`), bare names
+ * collide. We surface MCP tools to the model with a `<serverName>__<toolName>`
+ * prefix so every name is unambiguous.
+ *
+ * The prefix uses double-underscore as the separator; it is split on the FIRST
+ * occurrence so tool names that themselves contain `__` survive a round-trip.
+ */
+export declare function prefixMcpToolName(serverName: string, toolName: string): string;
+export interface ParsedMcpToolName {
+    serverName: string;
+    toolName: string;
+}
+/**
+ * Parse a prefixed name. Returns `null` when the input has no separator OR
+ * when either side of the separator is empty (the input is not a valid
+ * prefixed name).
+ */
+export declare function parseMcpToolName(name: string): ParsedMcpToolName | null;
+export declare function isPrefixedMcpToolName(name: string): boolean;
+//# sourceMappingURL=mcpToolNamespacing.d.ts.map

package/dist/mcp/mcpToolNamespacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolNamespacing.d.ts","sourceRoot":"","sources":["../../src/mcp/mcpToolNamespacing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAOvE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/mcp/mcpToolNamespacing.js

@@ -0,0 +1,36 @@
+/**
+ * MCP tool namespacing helpers.
+ *
+ * MCP servers (e.g. nexus-browser, filesystem) define tool names in their own
+ * naming convention — typically lowercase verbs (`browse`, `scan`,
+ * `read_text_file`). When multiple servers connect, or when a server's tool
+ * name overlaps with a native executor (e.g. `Read` vs `read`), bare names
+ * collide. We surface MCP tools to the model with a `<serverName>__<toolName>`
+ * prefix so every name is unambiguous.
+ *
+ * The prefix uses double-underscore as the separator; it is split on the FIRST
+ * occurrence so tool names that themselves contain `__` survive a round-trip.
+ */
+const SEPARATOR = '__';
+export function prefixMcpToolName(serverName, toolName) {
+    return `${serverName}${SEPARATOR}${toolName}`;
+}
+/**
+ * Parse a prefixed name. Returns `null` when the input has no separator OR
+ * when either side of the separator is empty (the input is not a valid
+ * prefixed name).
+ */
+export function parseMcpToolName(name) {
+    const sepIndex = name.indexOf(SEPARATOR);
+    if (sepIndex <= 0)
+        return null;
+    const serverName = name.slice(0, sepIndex);
+    const toolName = name.slice(sepIndex + SEPARATOR.length);
+    if (!serverName || !toolName)
+        return null;
+    return { serverName, toolName };
+}
+export function isPrefixedMcpToolName(name) {
+    return parseMcpToolName(name) !== null;
+}
+//# sourceMappingURL=mcpToolNamespacing.js.map

package/dist/mcp/mcpToolNamespacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolNamespacing.js","sourceRoot":"","sources":["../../src/mcp/mcpToolNamespacing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,QAAgB;IACpE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;AAChD,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AACzC,CAAC"}

package/dist/mcp/test-mcp-integration.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Integration Test
+ *
+ * Tests the MCP infrastructure with the @modelcontextprotocol/server-filesystem server.
+ * This is a manual integration test to verify the MCP implementation works with a real server.
+ */
+export {};
+//# sourceMappingURL=test-mcp-integration.d.ts.map

package/dist/mcp/test-mcp-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-mcp-integration.d.ts","sourceRoot":"","sources":["../../src/mcp/test-mcp-integration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/mcp/test-mcp-integration.js

@@ -0,0 +1,115 @@
+/**
+ * MCP Integration Test
+ *
+ * Tests the MCP infrastructure with the @modelcontextprotocol/server-filesystem server.
+ * This is a manual integration test to verify the MCP implementation works with a real server.
+ */
+import { McpClientManager } from './index.js';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+async function testMcpIntegration() {
+    console.log('=== MCP Integration Test ===\n');
+    try {
+        // 1. Create MCP Client Manager
+        console.log('1. Creating MCP Client Manager...');
+        const manager = new McpClientManager(true); // Enable debug mode
+        console.log('[OK] Manager created\n');
+        // 2. Add filesystem server configuration
+        console.log('2. Adding filesystem MCP server configuration...');
+        const testDir = resolve(__dirname, '..', '..', 'test-mcp-workspace');
+        manager.addServerConfig('filesystem', {
+            name: 'filesystem',
+            command: 'npx',
+            args: ['@modelcontextprotocol/server-filesystem', testDir],
+            timeout: 30000,
+        });
+        console.log(`[OK] Server configured with test directory: ${testDir}\n`);
+        // 3. Connect to the server
+        console.log('3. Connecting to filesystem MCP server...');
+        await manager.connectToServer('filesystem');
+        console.log('[OK] Connected successfully\n');
+        // Wait a moment for connection to stabilize
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        // 4. Discover tools
+        console.log('4. Discovering tools from server...');
+        const tools = await manager.discoverServerTools('filesystem');
+        console.log(`[OK] Discovered ${tools.length} tools:`);
+        tools.forEach((tool, index) => {
+            console.log(` ${index + 1}. ${tool.name} - ${tool.description || 'No description'}`);
+        });
+        console.log('');
+        // 5. Discover resources
+        console.log('5. Discovering resources from server...');
+        try {
+            const resources = await manager.discoverServerResources('filesystem');
+            console.log(`[OK] Discovered ${resources.length} resources`);
+            if (resources.length > 0) {
+                resources.forEach((resource, index) => {
+                    console.log(` ${index + 1}. ${resource.uri} - ${resource.name || 'No name'}`);
+                });
+            }
+        }
+        catch (error) {
+            if (error.message.includes('Method not found')) {
+                console.log(' ⚠  Server does not support resources (this is OK)');
+            }
+            else {
+                throw error;
+            }
+        }
+        console.log('');
+        // 6. Get all tools from manager
+        console.log('6. Getting all tools from manager...');
+        const allTools = manager.getAllTools();
+        console.log(`[OK] Manager reports ${allTools.length} total tools\n`);
+        // 7. Test tool execution
+        console.log('7. Testing tool execution...');
+        if (tools.length > 0) {
+            // Try to find list_allowed_directories tool
+            const listDirTool = tools.find(t => t.name === 'list_allowed_directories');
+            if (listDirTool) {
+                console.log(' Executing: list_allowed_directories');
+                const result = await manager.callTool('filesystem', 'list_allowed_directories', {});
+                console.log(' Result:', JSON.stringify(result, null, 2));
+                console.log('[OK] Tool execution successful\n');
+            }
+            else {
+                console.log(' ⚠  list_allowed_directories tool not found');
+                console.log(' Available tools:', tools.map(t => t.name).join(', '));
+                console.log('');
+            }
+        }
+        // 8. Get server info
+        console.log('8. Getting server information...');
+        const serverInfo = manager.getServerInfo();
+        console.log('[OK] Server info:');
+        serverInfo.forEach(info => {
+            console.log(` - ${info.name}: ${info.status} (${info.toolCount} tools, ${info.resourceCount} resources)`);
+        });
+        console.log('');
+        // 9. Cleanup
+        console.log('9. Cleaning up...');
+        await manager.cleanup();
+        console.log('[OK] Cleanup complete\n');
+        console.log('=== [OK] All Tests Passed! ===');
+        return true;
+    }
+    catch (error) {
+        console.error('\n[ERROR] Test failed with error:');
+        console.error(error);
+        return false;
+    }
+}
+// Run the test
+console.log('Starting MCP integration test...\n');
+testMcpIntegration()
+    .then(success => {
+    process.exit(success ? 0 : 1);
+})
+    .catch(error => {
+    console.error('Unhandled error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=test-mcp-integration.js.map

package/dist/mcp/test-mcp-integration.js.map

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

package/dist/middleware/ErrorClassificationMiddleware.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Error Classification Middleware
+ *
+ * Provides error classification and retry eligibility determination for the orchestrator.
+ * Extracted from CortexOrchestrator.ts (lines 2197-2252) as part of the parallel
+ * refactor project.
+ *
+ * This component is standalone and can be used independently of the orchestrator.
+ *
+ * @version 1.0.0
+ * @author Agent 1 - Parallel Refactor Wave 1
+ */
+import type { IErrorClassifier, ErrorClassification } from './contracts/MiddlewareContracts.js';
+/**
+ * ErrorClassificationMiddleware
+ *
+ * Classifies errors into categories and determines whether they are retryable.
+ * Supports network errors, HTTP status codes, file system errors, permission errors,
+ * and abort errors.
+ *
+ * @example
+ * ```typescript
+ * const classifier = new ErrorClassificationMiddleware();
+ *
+ * const error = new Error('ECONNRESET');
+ * const classification = classifier.classify(error);
+ * console.log(classification.isRetryable); // true
+ * console.log(classification.errorType); // 'network'
+ * ```
+ */
+export declare class ErrorClassificationMiddleware implements IErrorClassifier {
+    /**
+     * Network error patterns that indicate transient connectivity issues
+     */
+    private readonly networkErrorPatterns;
+    /**
+     * HTTP status codes that are typically retryable
+     */
+    private readonly retryableStatusCodes;
+    /**
+     * File system error patterns that indicate temporary resource contention
+     */
+    private readonly temporaryFsErrorPatterns;
+    /**
+     * Permission and validation error patterns that are not retryable
+     */
+    private readonly nonRetryablePatterns;
+    /**
+     * Classify an error and provide detailed information
+     *
+     * @param error - The error to classify
+     * @returns Complete error classification with type, retryability, and metadata
+     *
+     * @example
+     * ```typescript
+     * const error = new Error('ETIMEDOUT');
+     * const result = classifier.classify(error);
+     * // {
+     * //   isRetryable: true,
+     * //   errorType: 'network',
+     * //   message: 'ETIMEDOUT',
+     * //   metadata: { errorName: 'error' }
+     * // }
+     * ```
+     */
+    classify(error: any): ErrorClassification;
+    /**
+     * Determine if an error is retryable
+     *
+     * @param error - The error to check
+     * @returns true if the error is transient and should be retried
+     *
+     * @example
+     * ```typescript
+     * const error = { status: 503 };
+     * classifier.isRetryable(error); // true
+     *
+     * const permError = new Error('EACCES');
+     * classifier.isRetryable(permError); // false
+     * ```
+     */
+    isRetryable(error: any): boolean;
+    /**
+     * Get the type of error
+     *
+     * @param error - The error to classify
+     * @returns The error type category
+     *
+     * @example
+     * ```typescript
+     * const error = new Error('ECONNRESET');
+     * classifier.getErrorType(error); // 'network'
+     *
+     * const permError = new Error('EACCES');
+     * classifier.getErrorType(permError); // 'permission'
+     * ```
+     */
+    getErrorType(error: any): ErrorClassification['errorType'];
+    /**
+     * Normalize a string for case-insensitive comparison
+     *
+     * @param value - The string to normalize
+     * @returns Lowercase string or empty string if null/undefined
+     */
+    private normalizeString;
+    /**
+     * Check if error message or name matches any of the given patterns
+     *
+     * @param errorMessage - Normalized error message
+     * @param errorName - Normalized error name
+     * @param patterns - Array of patterns to match against
+     * @returns true if any pattern matches
+     */
+    private matchesPattern;
+}
+//# sourceMappingURL=ErrorClassificationMiddleware.d.ts.map

package/dist/middleware/ErrorClassificationMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorClassificationMiddleware.d.ts","sourceRoot":"","sources":["../../src/middleware/ErrorClassificationMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,6BAA8B,YAAW,gBAAgB;IACpE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CASnC;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAkC;IAEvE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAuB;IAEhE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CASnC;IAEF;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,mBAAmB;IA4BzC;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAsChC;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,mBAAmB,CAAC,WAAW,CAAC;IAyC1D;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CASvB"}