@roxybrowser/openapi 1.0.3 → 1.0.4-beta.0

package/lib/utils/error-analyzer.js

@@ -0,0 +1,380 @@
+/**
+ * Error Analysis Utility
+ *
+ * Provides intelligent error analysis, categorization, and troubleshooting guidance
+ */
+import { RoxyApiError, ROXY_ERROR_MAP, NETWORK_ERROR_PATTERNS, ConfigError, BrowserCreationError, } from '../types.js';
+export class ErrorAnalyzer {
+    /**
+     * Analyze a single error and provide detailed insights
+     */
+    static analyzeError(error) {
+        if (error instanceof RoxyApiError) {
+            return this.analyzeRoxyApiError(error);
+        }
+        if (error instanceof ConfigError) {
+            return this.analyzeConfigError(error);
+        }
+        if (error instanceof BrowserCreationError) {
+            return this.analyzeBrowserCreationError(error);
+        }
+        // Generic error analysis
+        return this.analyzeGenericError(error);
+    }
+    /**
+     * Analyze RoxyBrowser API errors
+     */
+    static analyzeRoxyApiError(error) {
+        const baseResult = {
+            category: error.category,
+            severity: error.severity,
+            description: error.errorInfo?.description || error.message,
+            chineseDescription: error.errorInfo?.chineseMsg || '未知错误',
+            troubleshooting: error.getTroubleshootingSteps(),
+            retryable: error.isRetryable(),
+            suggestedActions: [],
+            relatedErrors: [],
+        };
+        if (error.isRetryable()) {
+            baseResult.retryStrategy = error.getRetryStrategy();
+        }
+        // Add specific suggestions based on error type
+        baseResult.suggestedActions = this.generateSuggestedActions(error);
+        baseResult.relatedErrors = this.findRelatedErrors(error.code);
+        return baseResult;
+    }
+    /**
+     * Analyze configuration errors
+     */
+    static analyzeConfigError(error) {
+        return {
+            category: 'configuration',
+            severity: 'high',
+            description: 'Configuration error - invalid or missing settings',
+            chineseDescription: '配置错误 - 配置无效或缺失',
+            troubleshooting: [
+                'Check environment variables (ROXY_API_KEY, ROXY_API_HOST)',
+                'Verify RoxyBrowser application settings',
+                'Ensure all required configuration is provided',
+                'Check configuration file syntax and format',
+            ],
+            retryable: false,
+            suggestedActions: [
+                'Review configuration setup',
+                'Check environment variable spelling',
+                'Restart application after fixing configuration',
+            ],
+        };
+    }
+    /**
+     * Analyze browser creation errors
+     */
+    static analyzeBrowserCreationError(error) {
+        const hasPartialResults = error.partialResults && error.partialResults.length > 0;
+        return {
+            category: 'browser',
+            severity: hasPartialResults ? 'medium' : 'high',
+            description: 'Browser creation failed - configuration or resource issue',
+            chineseDescription: '浏览器创建失败 - 配置或资源问题',
+            troubleshooting: [
+                'Verify workspace and project IDs exist',
+                'Check browser configuration parameters',
+                'Ensure sufficient system resources',
+                'Validate proxy settings if used',
+                'Check for conflicting browser instances',
+            ],
+            retryable: true,
+            retryStrategy: {
+                shouldRetry: true,
+                delayMs: 2000,
+                maxRetries: 2,
+            },
+            suggestedActions: hasPartialResults ? [
+                'Retry with failed configurations only',
+                'Reduce batch size',
+                'Check specific error details for each failure',
+            ] : [
+                'Validate all configuration parameters',
+                'Check system resources',
+                'Try creating browsers one at a time',
+            ],
+        };
+    }
+    /**
+     * Analyze generic errors
+     */
+    static analyzeGenericError(error) {
+        // Check for network error patterns
+        const networkPattern = NETWORK_ERROR_PATTERNS.find(pattern => pattern.pattern.test(error.message));
+        if (networkPattern) {
+            return {
+                category: 'network',
+                severity: 'high',
+                description: networkPattern.description,
+                chineseDescription: '网络连接错误',
+                troubleshooting: networkPattern.troubleshooting,
+                retryable: true,
+                retryStrategy: {
+                    shouldRetry: true,
+                    delayMs: 3000,
+                    maxRetries: 3,
+                },
+                suggestedActions: [
+                    'Check network connectivity',
+                    'Verify service availability',
+                    'Try again after a brief wait',
+                ],
+            };
+        }
+        return {
+            category: 'unknown',
+            severity: 'medium',
+            description: error.message || 'Unknown error occurred',
+            chineseDescription: '未知错误',
+            troubleshooting: [
+                'Check application logs for more details',
+                'Verify system status',
+                'Try the operation again',
+            ],
+            retryable: true,
+            retryStrategy: {
+                shouldRetry: true,
+                delayMs: 1000,
+                maxRetries: 1,
+            },
+            suggestedActions: [
+                'Review error message for clues',
+                'Check system resources',
+                'Contact support if issue persists',
+            ],
+        };
+    }
+    /**
+     * Generate context-specific suggested actions
+     */
+    static generateSuggestedActions(error) {
+        const actions = [];
+        switch (error.code) {
+            case 401:
+                actions.push('Copy API key from RoxyBrowser settings', 'Set ROXY_API_KEY environment variable', 'Restart the MCP server');
+                break;
+            case 404:
+                actions.push('Use roxy_list_workspaces to find valid workspace IDs', 'Use roxy_list_browsers to find valid browser IDs', 'Check if resources were deleted');
+                break;
+            case 409:
+                actions.push('Close conflicting browser instances', 'Use roxy_close_browsers tool', 'Wait a moment and try again');
+                break;
+            case 500:
+                actions.push('Check RoxyBrowser application status', 'Restart RoxyBrowser if needed', 'Check system resources');
+                break;
+            case 408:
+            case 504:
+                actions.push('Increase timeout settings', 'Reduce batch operation size', 'Check network connectivity');
+                break;
+        }
+        return actions;
+    }
+    /**
+     * Find related error codes that might have similar causes
+     */
+    static findRelatedErrors(errorCode) {
+        const related = [];
+        // Group related errors
+        const authErrors = [401, 403];
+        const networkErrors = [408, 502, 503, 504];
+        const resourceErrors = [404, 409];
+        if (authErrors.includes(errorCode)) {
+            related.push(...authErrors.filter(code => code !== errorCode).map(code => `Error ${code}`));
+        }
+        else if (networkErrors.includes(errorCode)) {
+            related.push(...networkErrors.filter(code => code !== errorCode).map(code => `Error ${code}`));
+        }
+        else if (resourceErrors.includes(errorCode)) {
+            related.push(...resourceErrors.filter(code => code !== errorCode).map(code => `Error ${code}`));
+        }
+        return related;
+    }
+    /**
+     * Analyze multiple errors to find patterns and provide batch insights
+     */
+    static analyzeBatchErrors(errors) {
+        const analysis = {
+            totalErrors: errors.length,
+            errorsByCategory: {},
+            errorsBySeverity: {},
+            commonPatterns: [],
+            recommendations: [],
+            retryableCount: 0,
+            criticalCount: 0,
+        };
+        const errorMessages = [];
+        const errorCodes = [];
+        // Analyze each error
+        for (const error of errors) {
+            const result = this.analyzeError(error);
+            // Count by category
+            analysis.errorsByCategory[result.category] = (analysis.errorsByCategory[result.category] || 0) + 1;
+            // Count by severity
+            analysis.errorsBySeverity[result.severity] = (analysis.errorsBySeverity[result.severity] || 0) + 1;
+            // Track retryable and critical errors
+            if (result.retryable)
+                analysis.retryableCount++;
+            if (result.severity === 'critical')
+                analysis.criticalCount++;
+            errorMessages.push(error.message);
+            if (error instanceof RoxyApiError) {
+                errorCodes.push(error.code);
+            }
+        }
+        // Find common patterns
+        analysis.commonPatterns = this.findCommonPatterns(errorMessages, errorCodes);
+        // Generate recommendations
+        analysis.recommendations = this.generateBatchRecommendations(analysis);
+        return analysis;
+    }
+    /**
+     * Find common patterns in error messages and codes
+     */
+    static findCommonPatterns(messages, codes) {
+        const patterns = [];
+        // Count error codes
+        const codeCount = {};
+        const codeMessages = {};
+        codes.forEach((code, index) => {
+            codeCount[code] = (codeCount[code] || 0) + 1;
+            if (!codeMessages[code])
+                codeMessages[code] = [];
+            codeMessages[code].push(messages[index]);
+        });
+        // Add significant error code patterns
+        Object.entries(codeCount).forEach(([code, count]) => {
+            if (count >= 2) {
+                const errorInfo = ROXY_ERROR_MAP[parseInt(code)];
+                patterns.push({
+                    pattern: errorInfo ? `${errorInfo.name} (${code})` : `Error Code ${code}`,
+                    count,
+                    affectedItems: codeMessages[parseInt(code)].slice(0, 3), // Show first 3 examples
+                });
+            }
+        });
+        // Look for common message patterns
+        const commonKeywords = ['timeout', 'connection', 'authentication', 'not found', 'conflict'];
+        commonKeywords.forEach(keyword => {
+            const matchingMessages = messages.filter(msg => msg.toLowerCase().includes(keyword.toLowerCase()));
+            if (matchingMessages.length >= 2) {
+                patterns.push({
+                    pattern: `Messages containing "${keyword}"`,
+                    count: matchingMessages.length,
+                    affectedItems: matchingMessages.slice(0, 3),
+                });
+            }
+        });
+        return patterns.sort((a, b) => b.count - a.count);
+    }
+    /**
+     * Generate batch-level recommendations
+     */
+    static generateBatchRecommendations(analysis) {
+        const recommendations = [];
+        // Critical errors
+        if (analysis.criticalCount > 0) {
+            recommendations.push('🚨 Critical errors detected - immediate attention required');
+        }
+        // Authentication issues
+        if (analysis.errorsByCategory.authentication > 0) {
+            recommendations.push('🔑 Authentication issues detected - check API key and permissions');
+        }
+        // Network issues
+        if (analysis.errorsByCategory.network > 0) {
+            recommendations.push('🌐 Network issues detected - check connectivity and proxy settings');
+        }
+        // High retry rate
+        if (analysis.retryableCount > analysis.totalErrors * 0.7) {
+            recommendations.push('🔄 Many errors are retryable - consider implementing automatic retry');
+        }
+        // Browser conflicts
+        if (analysis.errorsByCategory.browser > 0) {
+            recommendations.push('🖥️ Browser-related issues detected - check resource availability and conflicts');
+        }
+        // Configuration issues
+        if (analysis.errorsByCategory.configuration > 0) {
+            recommendations.push('⚙️ Configuration issues detected - review settings and parameters');
+        }
+        return recommendations;
+    }
+    /**
+     * Format error analysis for display to user/AI
+     */
+    static formatErrorForDisplay(error) {
+        const analysis = this.analyzeError(error);
+        let formatted = `## 错误分析 / Error Analysis\n\n`;
+        formatted += `**错误类型 / Category**: ${analysis.category}\n`;
+        formatted += `**严重程度 / Severity**: ${analysis.severity}\n`;
+        formatted += `**描述 / Description**: ${analysis.description}\n`;
+        formatted += `**中文说明**: ${analysis.chineseDescription}\n\n`;
+        if (analysis.troubleshooting.length > 0) {
+            formatted += `### 故障排除步骤 / Troubleshooting Steps\n`;
+            analysis.troubleshooting.forEach((step, index) => {
+                formatted += `${index + 1}. ${step}\n`;
+            });
+            formatted += '\n';
+        }
+        if (analysis.suggestedActions.length > 0) {
+            formatted += `### 建议操作 / Suggested Actions\n`;
+            analysis.suggestedActions.forEach((action, index) => {
+                formatted += `${index + 1}. ${action}\n`;
+            });
+            formatted += '\n';
+        }
+        if (analysis.retryable && analysis.retryStrategy) {
+            formatted += `### 重试策略 / Retry Strategy\n`;
+            formatted += `- **可重试 / Retryable**: ✅ Yes\n`;
+            formatted += `- **延迟 / Delay**: ${analysis.retryStrategy.delayMs}ms\n`;
+            formatted += `- **最大重试次数 / Max Retries**: ${analysis.retryStrategy.maxRetries}\n\n`;
+        }
+        else {
+            formatted += `### 重试策略 / Retry Strategy\n`;
+            formatted += `- **可重试 / Retryable**: ❌ No\n\n`;
+        }
+        if (analysis.relatedErrors && analysis.relatedErrors.length > 0) {
+            formatted += `### 相关错误 / Related Errors\n`;
+            formatted += `${analysis.relatedErrors.join(', ')}\n\n`;
+        }
+        return formatted;
+    }
+    /**
+     * Format batch analysis for display
+     */
+    static formatBatchAnalysisForDisplay(analysis) {
+        let formatted = `## 批量错误分析 / Batch Error Analysis\n\n`;
+        formatted += `**总错误数 / Total Errors**: ${analysis.totalErrors}\n`;
+        formatted += `**可重试错误 / Retryable Errors**: ${analysis.retryableCount}\n`;
+        formatted += `**严重错误 / Critical Errors**: ${analysis.criticalCount}\n\n`;
+        if (Object.keys(analysis.errorsByCategory).length > 0) {
+            formatted += `### 错误分类统计 / Error Categories\n`;
+            Object.entries(analysis.errorsByCategory).forEach(([category, count]) => {
+                formatted += `- **${category}**: ${count}\n`;
+            });
+            formatted += '\n';
+        }
+        if (analysis.commonPatterns.length > 0) {
+            formatted += `### 常见错误模式 / Common Patterns\n`;
+            analysis.commonPatterns.forEach((pattern, index) => {
+                formatted += `${index + 1}. **${pattern.pattern}** (${pattern.count} occurrences)\n`;
+                if (pattern.affectedItems.length > 0) {
+                    formatted += `   Examples: ${pattern.affectedItems.slice(0, 2).join(', ')}\n`;
+                }
+            });
+            formatted += '\n';
+        }
+        if (analysis.recommendations.length > 0) {
+            formatted += `### 建议 / Recommendations\n`;
+            analysis.recommendations.forEach((rec, index) => {
+                formatted += `${index + 1}. ${rec}\n`;
+            });
+            formatted += '\n';
+        }
+        return formatted;
+    }
+}
+//# sourceMappingURL=error-analyzer.js.map

package/lib/utils/error-analyzer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roxybrowser/openapi",
-  "version": "1.0.3",
+  "version": "1.0.4-beta.0",
   "description": "MCP server for RoxyBrowser automation - manage browser instances and get CDP endpoints",
   "type": "module",
   "bin": {
@@ -15,7 +15,8 @@
     "start": "node lib/index.js",
     "dev": "tsc --watch",
     "clean": "npx rimraf lib",
-    "npm-publish": "npm run clean && npm run build && npm publish"
+    "npm-publish": "npm run clean && npm version patch --no-git-tag-version && npm run build && npm publish",
+    "publish:beta": "npm version prerelease --preid=beta --no-git-tag-version && npm run build && npm publish --tag beta"
   },
   "keywords": [
     "mcp",
@@ -32,7 +33,7 @@
   "author": "RoxyBrowser",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.18.0" 
+    "@modelcontextprotocol/sdk": "^1.18.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/lib/browser/template-manager.d.ts

@@ -1,48 +0,0 @@
-/**
- * Browser Template Manager
- *
- * Provides predefined browser templates for common use cases
- */
-import { BrowserTemplate, BrowserTemplateType, BrowserCreateConfig, ProxyInfo } from '../types.js';
-export declare class TemplateManager {
-    private static templates;
-    /**
-     * Get available template names and descriptions
-     */
-    static getAvailableTemplates(): Array<{
-        name: BrowserTemplateType;
-        description: string;
-    }>;
-    /**
-     * Get template configuration by name
-     */
-    static getTemplate(templateName: BrowserTemplateType): BrowserTemplate | null;
-    /**
-     * Get template configuration merged with custom overrides
-     */
-    static getTemplateConfig(templateName: BrowserTemplateType, customConfig?: Partial<BrowserCreateConfig>): Partial<BrowserCreateConfig>;
-    /**
-     * Create a custom template
-     */
-    static createCustomTemplate(name: string, description: string, config: Partial<BrowserCreateConfig>): BrowserTemplate;
-    /**
-     * Get template optimized for specific proxy configuration
-     */
-    static getTemplateForProxy(templateName: BrowserTemplateType, proxyInfo: ProxyInfo): Partial<BrowserCreateConfig>;
-    /**
-     * Get template optimized for specific country/region
-     */
-    static getTemplateForRegion(templateName: BrowserTemplateType, countryCode: string, language?: string): Partial<BrowserCreateConfig>;
-    /**
-     * Get regional settings by country code
-     */
-    private static getRegionalSettings;
-    /**
-     * Validate template configuration
-     */
-    static validateTemplate(template: BrowserTemplate): {
-        valid: boolean;
-        errors: string[];
-    };
-}
-//# sourceMappingURL=template-manager.d.ts.map

package/lib/browser/template-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template-manager.d.ts","sourceRoot":"","sources":["../../src/browser/template-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EAEV,MAAM,aAAa,CAAC;AAErB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAqLtB;IAEF;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,mBAAmB,GAAG,eAAe,GAAG,IAAI;IAI7E;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,YAAY,EAAE,mBAAmB,EACjC,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAC1C,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACnC,eAAe;IAQlB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,YAAY,EAAE,mBAAmB,EACjC,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAuB/B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAqBlC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAsBzF"}