@roxybrowser/openapi 1.0.4-beta.0 → 1.0.4-beta.1

package/lib/index.js

@@ -12,7 +12,7 @@ import { RoxyClient } from './roxy-client.js';
 import { BrowserCreator } from './browser/browser-creator.js';
 import { ProxyManager } from './proxy/proxy-manager.js';
 import { ErrorAnalyzer } from './utils/error-analyzer.js';
-import { ConfigError, BrowserCreationError, } from './types.js';
+import { ConfigError, RoxyApiError, BrowserCreationError, LATEST_CORE_VERSION, } from './types.js';
 // ========== Configuration ==========
 function getConfig() {
     const apiHost = process.env.ROXY_API_HOST || 'http://127.0.0.1:50000';
@@ -925,130 +925,214 @@ class RoxyBrowserMCPServer {
         if (!params.workspaceId) {
             throw new Error('workspaceId is required');
         }
-        // Build configuration from simple parameters
-        const config = BrowserCreator.buildSimpleConfig(params);
-        const finalConfig = BrowserCreator.applyDefaults(config);
-        // Validate configuration
-        const validation = BrowserCreator.validateConfig(finalConfig);
-        if (!validation.valid) {
-            throw new BrowserCreationError(`Configuration validation failed: ${validation.errors.join(', ')}`);
+        try {
+            // Build configuration from simple parameters
+            const config = BrowserCreator.buildSimpleConfig(params);
+            const finalConfig = BrowserCreator.applyDefaults(config);
+            // Validate configuration
+            const validation = BrowserCreator.validateConfig(finalConfig);
+            if (!validation.valid) {
+                throw new BrowserCreationError(`Configuration validation failed: ${validation.errors.join(', ')}`);
+            }
+            // Create browser
+            const result = await this.roxyClient.createBrowser(finalConfig);
+            const response = {
+                browser: {
+                    dirId: result.dirId,
+                    windowName: finalConfig.windowName || 'Simple Browser',
+                    workspaceId: params.workspaceId,
+                    projectId: params.projectId,
+                    proxyConfigured: !!(params.proxyHost && params.proxyPort),
+                },
+                message: `Browser created successfully with ID: ${result.dirId}`,
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ **Simple Browser Created**\n\n` +
+                            `**Browser ID:** \`${response.browser.dirId}\`\n` +
+                            `**Name:** ${response.browser.windowName}\n` +
+                            `**Workspace:** ${response.browser.workspaceId}\n` +
+                            `${response.browser.projectId ? `**Project:** ${response.browser.projectId}\n` : ''}` +
+                            `**Proxy:** ${response.browser.proxyConfigured ? '✅ Configured' : '❌ Not configured'}\n\n` +
+                            `*Use this browser ID with \`roxy_open_browsers\` to start the browser and get CDP endpoints for automation.*`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Check for quota error specifically
+            if (error instanceof RoxyApiError && error.code === 409 &&
+                error.message.includes('额度不足')) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ **浏览器创建失败 - 窗口额度不足 / Browser Creation Failed - Insufficient Profiles Quota**\n\n` +
+                                `**错误信息 / Error:** ${error.message}\n\n` +
+                                `**解决步骤 / Solution Steps:**\n` +
+                                `1. 打开 RoxyBrowser 应用 / Open RoxyBrowser app\n` +
+                                `2. 前往费用中心 / Go to Billing Center\n` +
+                                `3. 购买或升级窗口套餐 / Purchase or upgrade profiles plan\n` +
+                                `4. 或者删除不需要的浏览器窗口以释放额度 / Or delete unused browser profiles to free up quota\n` +
+                                `5. 等待生效后重试创建 / Retry creation after quota is available\n\n` +
+                                `💡 **重要提示 / Important:** 必须使用 \`roxy_delete_browsers\` 删除浏览器才能释放额度，仅关闭浏览器无法释放额度。\n` +
+                                `You must use \`roxy_delete_browsers\` to delete profiles to free up quota. Simply closing browsers will NOT free up quota.`,
+                        }],
+                };
+            }
+            // Use enhanced error analysis for other errors
+            const formattedError = ErrorAnalyzer.formatErrorForDisplay(error instanceof Error ? error : new Error('Unknown error'));
+            return {
+                content: [{ type: 'text', text: formattedError }],
+            };
         }
-        // Create browser
-        const result = await this.roxyClient.createBrowser(finalConfig);
-        const response = {
-            browser: {
-                dirId: result.dirId,
-                windowName: finalConfig.windowName || 'Simple Browser',
-                workspaceId: params.workspaceId,
-                projectId: params.projectId,
-                proxyConfigured: !!(params.proxyHost && params.proxyPort),
-            },
-            message: `Browser created successfully with ID: ${result.dirId}`,
-        };
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `✅ **Simple Browser Created**\n\n` +
-                        `**Browser ID:** \`${response.browser.dirId}\`\n` +
-                        `**Name:** ${response.browser.windowName}\n` +
-                        `**Workspace:** ${response.browser.workspaceId}\n` +
-                        `${response.browser.projectId ? `**Project:** ${response.browser.projectId}\n` : ''}` +
-                        `**Proxy:** ${response.browser.proxyConfigured ? '✅ Configured' : '❌ Not configured'}\n\n` +
-                        `*Use this browser ID with \`roxy_open_browsers\` to start the browser and get CDP endpoints for automation.*`,
-                },
-            ],
-        };
     }
     async handleCreateBrowserStandard(args) {
         const params = args;
         if (!params.workspaceId) {
             throw new Error('workspaceId is required');
         }
-        // Build configuration from standard parameters
-        const config = BrowserCreator.buildStandardConfig(params);
-        const finalConfig = BrowserCreator.applyDefaults(config);
-        // Validate configuration
-        const validation = BrowserCreator.validateConfig(finalConfig);
-        if (!validation.valid) {
-            throw new BrowserCreationError(`Configuration validation failed: ${validation.errors.join(', ')}`);
+        try {
+            // Build configuration from standard parameters
+            const config = BrowserCreator.buildStandardConfig(params);
+            const finalConfig = BrowserCreator.applyDefaults(config);
+            // Validate configuration
+            const validation = BrowserCreator.validateConfig(finalConfig);
+            if (!validation.valid) {
+                throw new BrowserCreationError(`Configuration validation failed: ${validation.errors.join(', ')}`);
+            }
+            // Create browser
+            const result = await this.roxyClient.createBrowser(finalConfig);
+            const response = {
+                browser: {
+                    dirId: result.dirId,
+                    windowName: finalConfig.windowName || 'Standard Browser',
+                    workspaceId: params.workspaceId,
+                    projectId: params.projectId,
+                    os: finalConfig.os || 'Windows',
+                    coreVersion: finalConfig.coreVersion || LATEST_CORE_VERSION,
+                    proxyInfo: params.proxyInfo,
+                    windowSize: `${params.openWidth || '1000'}x${params.openHeight || '1000'}`,
+                },
+                message: `Standard browser created successfully with ID: ${result.dirId}`,
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ **Standard Browser Created**\n\n` +
+                            `**Browser ID:** \`${response.browser.dirId}\`\n` +
+                            `**Name:** ${response.browser.windowName}\n` +
+                            `**OS:** ${response.browser.os} ${finalConfig.osVersion || ''}\n` +
+                            `**Core Version:** ${response.browser.coreVersion}\n` +
+                            `**Window Size:** ${response.browser.windowSize}\n` +
+                            `**Workspace:** ${response.browser.workspaceId}\n` +
+                            `${response.browser.projectId ? `**Project:** ${response.browser.projectId}\n` : ''}` +
+                            `**Proxy:** ${response.browser.proxyInfo ? '✅ Configured' : '❌ Not configured'}\n\n` +
+                            `*Browser is ready for automation. Use \`roxy_open_browsers\` to start it.*`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Check for quota error specifically
+            if (error instanceof RoxyApiError && error.code === 409 &&
+                error.message.includes('额度不足')) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ **浏览器创建失败 - 窗口额度不足 / Browser Creation Failed - Insufficient Profiles Quota**\n\n` +
+                                `**错误信息 / Error:** ${error.message}\n\n` +
+                                `**解决步骤 / Solution Steps:**\n` +
+                                `1. 打开 RoxyBrowser 应用 / Open RoxyBrowser app\n` +
+                                `2. 前往费用中心 / Go to Billing Center\n` +
+                                `3. 购买或升级窗口套餐 / Purchase or upgrade profiles plan\n` +
+                                `4. 或者删除不需要的浏览器窗口以释放额度 / Or delete unused browser profiles to free up quota\n` +
+                                `5. 等待生效后重试创建 / Retry creation after quota is available\n\n` +
+                                `💡 **重要提示 / Important:** 必须使用 \`roxy_delete_browsers\` 删除浏览器才能释放额度，仅关闭浏览器无法释放额度。\n` +
+                                `You must use \`roxy_delete_browsers\` to delete profiles to free up quota. Simply closing browsers will NOT free up quota.`,
+                        }],
+                };
+            }
+            // Use enhanced error analysis for other errors
+            const formattedError = ErrorAnalyzer.formatErrorForDisplay(error instanceof Error ? error : new Error('Unknown error'));
+            return {
+                content: [{ type: 'text', text: formattedError }],
+            };
         }
-        // Create browser
-        const result = await this.roxyClient.createBrowser(finalConfig);
-        const response = {
-            browser: {
-                dirId: result.dirId,
-                windowName: finalConfig.windowName || 'Standard Browser',
-                workspaceId: params.workspaceId,
-                projectId: params.projectId,
-                os: finalConfig.os || 'Windows',
-                coreVersion: finalConfig.coreVersion || '125',
-                proxyInfo: params.proxyInfo,
-                windowSize: `${params.openWidth || '1000'}x${params.openHeight || '1000'}`,
-            },
-            message: `Standard browser created successfully with ID: ${result.dirId}`,
-        };
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `✅ **Standard Browser Created**\n\n` +
-                        `**Browser ID:** \`${response.browser.dirId}\`\n` +
-                        `**Name:** ${response.browser.windowName}\n` +
-                        `**OS:** ${response.browser.os} ${finalConfig.osVersion || ''}\n` +
-                        `**Core Version:** ${response.browser.coreVersion}\n` +
-                        `**Window Size:** ${response.browser.windowSize}\n` +
-                        `**Workspace:** ${response.browser.workspaceId}\n` +
-                        `${response.browser.projectId ? `**Project:** ${response.browser.projectId}\n` : ''}` +
-                        `**Proxy:** ${response.browser.proxyInfo ? '✅ Configured' : '❌ Not configured'}\n\n` +
-                        `*Browser is ready for automation. Use \`roxy_open_browsers\` to start it.*`,
-                },
-            ],
-        };
     }
     async handleCreateBrowserAdvanced(args) {
         const params = args;
         if (!params.workspaceId) {
             throw new Error('workspaceId is required');
         }
-        // Build configuration from advanced parameters
-        const config = BrowserCreator.buildAdvancedConfig(params);
-        const finalConfig = BrowserCreator.applyDefaults(config);
-        // Validate configuration
-        const validation = BrowserCreator.validateConfig(finalConfig);
-        if (!validation.valid) {
-            throw new BrowserCreationError(`Configuration validation failed: ${validation.errors.join(', ')}`);
-        }
-        // Create browser
-        const result = await this.roxyClient.createBrowser(finalConfig);
-        const response = {
-            browser: {
-                dirId: result.dirId,
-                config: finalConfig,
-            },
-            message: `Advanced browser created successfully with ID: ${result.dirId}`,
-        };
-        // Create detailed status text
-        const configSummary = [
-            `**Browser ID:** \`${response.browser.dirId}\``,
-            `**Name:** ${finalConfig.windowName || 'Advanced Browser'}`,
-            `**OS:** ${finalConfig.os || 'Windows'} ${finalConfig.osVersion || ''}`,
-            `**Core Version:** ${finalConfig.coreVersion || '125'}`,
-            finalConfig.userAgent ? `**User Agent:** ${finalConfig.userAgent.substring(0, 50)}...` : '',
-            `**Search Engine:** ${finalConfig.searchEngine || 'Google'}`,
-            finalConfig.proxyInfo?.proxyCategory !== 'noproxy' ? `**Proxy:** ✅ ${finalConfig.proxyInfo?.proxyCategory} ${finalConfig.proxyInfo?.host}:${finalConfig.proxyInfo?.port}` : '**Proxy:** ❌ No proxy',
-            finalConfig.fingerInfo?.randomFingerprint ? '**Fingerprint:** 🎲 Random' : '**Fingerprint:** 🔒 Fixed',
-            finalConfig.defaultOpenUrl?.length ? `**Default URLs:** ${finalConfig.defaultOpenUrl.length} URL(s)` : '',
-        ].filter(Boolean).join('\n');
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `✅ **Advanced Browser Created**\n\n${configSummary}\n\n` +
-                        `*Advanced browser configured with complete control. Use \`roxy_open_browsers\` to start it.*`,
+        try {
+            // Build configuration from advanced parameters
+            const config = BrowserCreator.buildAdvancedConfig(params);
+            const finalConfig = BrowserCreator.applyDefaults(config);
+            // Validate configuration
+            const validation = BrowserCreator.validateConfig(finalConfig);
+            if (!validation.valid) {
+                throw new BrowserCreationError(`Configuration validation failed: ${validation.errors.join(', ')}`);
+            }
+            // Create browser
+            const result = await this.roxyClient.createBrowser(finalConfig);
+            const response = {
+                browser: {
+                    dirId: result.dirId,
+                    config: finalConfig,
                 },
-            ],
-        };
+                message: `Advanced browser created successfully with ID: ${result.dirId}`,
+            };
+            // Create detailed status text
+            const configSummary = [
+                `**Browser ID:** \`${response.browser.dirId}\``,
+                `**Name:** ${finalConfig.windowName || 'Advanced Browser'}`,
+                `**OS:** ${finalConfig.os || 'Windows'} ${finalConfig.osVersion || ''}`,
+                `**Core Version:** ${finalConfig.coreVersion || LATEST_CORE_VERSION}`,
+                finalConfig.userAgent ? `**User Agent:** ${finalConfig.userAgent.substring(0, 50)}...` : '',
+                `**Search Engine:** ${finalConfig.searchEngine || 'Google'}`,
+                finalConfig.proxyInfo?.proxyCategory !== 'noproxy' ? `**Proxy:** ✅ ${finalConfig.proxyInfo?.proxyCategory} ${finalConfig.proxyInfo?.host}:${finalConfig.proxyInfo?.port}` : '**Proxy:** ❌ No proxy',
+                finalConfig.fingerInfo?.randomFingerprint ? '**Fingerprint:** 🎲 Random' : '**Fingerprint:** 🔒 Fixed',
+                finalConfig.defaultOpenUrl?.length ? `**Default URLs:** ${finalConfig.defaultOpenUrl.length} URL(s)` : '',
+            ].filter(Boolean).join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ **Advanced Browser Created**\n\n${configSummary}\n\n` +
+                            `*Advanced browser configured with complete control. Use \`roxy_open_browsers\` to start it.*`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Check for quota error specifically
+            if (error instanceof RoxyApiError && error.code === 409 &&
+                error.message.includes('额度不足')) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ **浏览器创建失败 - 窗口额度不足 / Browser Creation Failed - Insufficient Profiles Quota**\n\n` +
+                                `**错误信息 / Error:** ${error.message}\n\n` +
+                                `**解决步骤 / Solution Steps:**\n` +
+                                `1. 打开 RoxyBrowser 应用 / Open RoxyBrowser app\n` +
+                                `2. 前往费用中心 / Go to Billing Center\n` +
+                                `3. 购买或升级窗口套餐 / Purchase or upgrade profiles plan\n` +
+                                `4. 或者删除不需要的浏览器窗口以释放额度 / Or delete unused browser profiles to free up quota\n` +
+                                `5. 等待生效后重试创建 / Retry creation after quota is available\n\n` +
+                                `💡 **重要提示 / Important:** 必须使用 \`roxy_delete_browsers\` 删除浏览器才能释放额度，仅关闭浏览器无法释放额度。\n` +
+                                `You must use \`roxy_delete_browsers\` to delete profiles to free up quota. Simply closing browsers will NOT free up quota.`,
+                        }],
+                };
+            }
+            // Use enhanced error analysis for other errors
+            const formattedError = ErrorAnalyzer.formatErrorForDisplay(error instanceof Error ? error : new Error('Unknown error'));
+            return {
+                content: [{ type: 'text', text: formattedError }],
+            };
+        }
     }
     async handleValidateProxyConfig(args) {
         const { proxyInfo } = args;
@@ -1128,20 +1212,62 @@ class RoxyBrowserMCPServer {
         if (!params.workspaceId || !params.dirIds || params.dirIds.length === 0) {
             throw new Error('workspaceId and dirIds are required');
         }
-        const results = await this.roxyClient.openBrowsers(params.workspaceId, params.dirIds, params.args);
+        const { successes, failures } = await this.roxyClient.openBrowsers(params.workspaceId, params.dirIds, params.args);
+        // Build success message
+        let message = '';
+        if (successes.length > 0) {
+            message += `✅ **Successfully opened ${successes.length} browser(s):**\n\n` +
+                successes.map(result => `**Browser ${result.dirId || 'Unknown'}** (PID: ${result.pid})\n` +
+                    `  - CDP WebSocket: \`${result.ws}\`\n` +
+                    `  - HTTP Endpoint: \`${result.http}\`\n` +
+                    `  - Core Version: ${result.coreVersion}`).join('\n\n') +
+                '\n\n**Use these WebSocket URLs with playwright-mcp:**\n' +
+                '```bash\n' +
+                successes.map(result => `npx @playwright/mcp@latest --cdp-endpoint "${result.ws}"`).join('\n') +
+                '\n```';
+        }
+        // Build failure message with special handling for quota errors
+        if (failures.length > 0) {
+            if (successes.length > 0) {
+                message += '\n\n---\n\n';
+            }
+            // Check if any failures are quota errors (code 101 or 409)
+            const quotaErrors = failures.filter(f => f.errorCode === 101 || (f.errorCode === 409 && f.error.includes('额度不足')));
+            const otherErrors = failures.filter(f => !quotaErrors.includes(f));
+            if (quotaErrors.length > 0) {
+                message += `❌ **Failed to open ${quotaErrors.length} browser(s) - Insufficient Profiles Quota / 窗口额度不足:**\n\n`;
+                quotaErrors.forEach(failure => {
+                    message += `  - Browser ID: \`${failure.dirId}\`\n    Error: ${failure.error}\n`;
+                });
+                message += '\n**解决步骤 / Solution Steps:**\n';
+                message += '1. 打开 RoxyBrowser 应用 / Open RoxyBrowser app\n';
+                message += '2. 前往费用中心 / Go to Billing Center\n';
+                message += '3. 购买或升级窗口套餐 / Purchase or upgrade profiles plan\n';
+                message += '4. 或者删除不需要的浏览器窗口以释放额度 / Or delete unused browser profiles to free up quota\n\n';
+                message += '💡 **重要提示 / Important:** 必须使用 `roxy_delete_browsers` 删除浏览器才能释放额度，仅关闭浏览器无法释放额度。\n';
+                message += 'You must use `roxy_delete_browsers` to delete profiles to free up quota. Simply closing browsers will NOT free up quota.';
+            }
+            if (otherErrors.length > 0) {
+                if (quotaErrors.length > 0) {
+                    message += '\n\n';
+                }
+                message += `❌ **Failed to open ${otherErrors.length} browser(s) - Other Errors:**\n\n`;
+                otherErrors.forEach(failure => {
+                    message += `  - Browser ID: \`${failure.dirId}\`\n`;
+                    message += `    Error: ${failure.error}\n`;
+                    message += `    Retryable: ${failure.retryable ? '✅ Yes' : '❌ No'}\n`;
+                });
+            }
+        }
+        // If all failed
+        if (successes.length === 0 && failures.length > 0) {
+            message = `❌ **Failed to open all ${failures.length} browser(s)**\n\n` + message;
+        }
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Successfully opened ${results.length} browsers:\n\n` +
-                        results.map(result => `**Browser ${result.dirId || 'Unknown'}** (PID: ${result.pid})\n` +
-                            `  - CDP WebSocket: \`${result.ws}\`\n` +
-                            `  - HTTP Endpoint: \`${result.http}\`\n` +
-                            `  - Core Version: ${result.coreVersion}`).join('\n\n') +
-                        '\n\n**Use these WebSocket URLs with playwright-mcp:**\n' +
-                        '```bash\n' +
-                        results.map(result => `npx @playwright/mcp@latest --cdp-endpoint "${result.ws}"`).join('\n') +
-                        '\n```',
+                    text: message,
                 },
             ],
         };
@@ -1405,20 +1531,30 @@ class RoxyBrowserMCPServer {
             throw new Error('workspaceId and dirId are required');
         }
         const detail = await this.roxyClient.getBrowserDetail(workspaceId, dirId);
+        // Save cookie count before removing cookies to save tokens
+        const cookieCount = detail.cookie?.length || 0;
+        // Create a copy without cookies (cookies can be very large)
+        const { cookie, ...detailWithoutCookies } = detail;
+        // Create summary
+        const summary = `**Browser Details Summary**\n\n` +
+            `**ID:** \`${detail.dirId}\`\n` +
+            `**Name:** ${detail.windowName}\n` +
+            `**Sort Number:** ${detail.windowSortNum}\n` +
+            `**Project:** ${detail.projectName} (ID: ${detail.projectId})\n` +
+            `**OS:** ${detail.os} ${detail.osVersion}\n` +
+            `**Core Version:** ${detail.coreVersion}\n` +
+            `**Search Engine:** ${detail.searchEngine}\n` +
+            `**Open Status:** ${detail.openStatus ? '✅ Opened' : '❌ Closed'}\n` +
+            `**Cookies:** ${cookieCount} stored (excluded from response to save tokens)\n\n` +
+            `**Full Details (JSON):**\n` +
+            '```json\n' +
+            JSON.stringify(detailWithoutCookies, null, 2) +
+            '\n```';
         return {
             content: [
                 {
                     type: 'text',
-                    text: `**Browser Details**\n\n` +
-                        `**ID:** \`${detail.dirId}\`\n` +
-                        `**Name:** ${detail.windowName}\n` +
-                        `**OS:** ${detail.os} ${detail.osVersion}\n` +
-                        `**Core:** ${detail.coreVersion}\n` +
-                        `**User Agent:** ${detail.userAgent}\n` +
-                        `**Proxy:** ${detail.proxyInfo?.host || 'None'}:${detail.proxyInfo?.port || ''}\n` +
-                        `**Created:** ${detail.createTime}\n` +
-                        `**Updated:** ${detail.updateTime}\n` +
-                        `**Open Status:** ${detail.openStatus ? 'Opened' : 'Closed'}`,
+                    text: summary,
                 },
             ],
         };