cbrowser 14.2.2 → 14.2.4

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAkVH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAmwEpD"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAkYH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA2xEpD"}

package/dist/mcp-server.js

@@ -49,6 +49,44 @@ async function getBrowser() {
     }
     return browser;
 }
+/**
+ * v14.2.1: Retry wrapper for transient browser errors.
+ * Retries operations that fail with common transient error patterns.
+ */
+async function withRetry(operation, options = {}) {
+    const maxRetries = options.maxRetries ?? 2;
+    const retryDelay = options.retryDelay ?? 500;
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (e) {
+            lastError = e;
+            const errorMessage = lastError.message || "";
+            // Check if this is a transient error worth retrying
+            const isTransient = errorMessage.includes("Target closed") ||
+                errorMessage.includes("Execution context") ||
+                errorMessage.includes("Session closed") ||
+                errorMessage.includes("Connection refused") ||
+                errorMessage.includes("Browser disconnected");
+            if (!isTransient || attempt === maxRetries) {
+                throw lastError;
+            }
+            // Wait before retry with exponential backoff
+            await new Promise((r) => setTimeout(r, retryDelay * (attempt + 1)));
+            // Try to recover the browser before retrying
+            try {
+                const b = await getBrowser();
+                await b.recoverBrowser();
+            }
+            catch {
+                // Recovery failed, will retry operation anyway
+            }
+        }
+    }
+    throw lastError;
+}
 // Session storage (in-memory, cleared when server restarts)
 const comparisonSessions = new Map();
 // WCAG criteria reference for barrier mapping
@@ -230,22 +268,25 @@ export async function startMcpServer() {
     server.tool("navigate", "Navigate to a URL and take a screenshot", {
         url: z.string().url().describe("The URL to navigate to"),
     }, async ({ url }) => {
-        const b = await getBrowser();
-        const result = await b.navigate(url);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({
-                        success: true,
-                        url: result.url,
-                        title: result.title,
-                        loadTime: result.loadTime,
-                        screenshot: result.screenshot,
-                    }, null, 2),
-                },
-            ],
-        };
+        // v14.2.1: Wrap with retry for transient errors
+        return await withRetry(async () => {
+            const b = await getBrowser();
+            const result = await b.navigate(url);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            url: result.url,
+                            title: result.title,
+                            loadTime: result.loadTime,
+                            screenshot: result.screenshot,
+                        }, null, 2),
+                    },
+                ],
+            };
+        });
     });
     // =========================================================================
     // Interaction Tools
@@ -255,24 +296,27 @@ export async function startMcpServer() {
         force: z.boolean().optional().describe("Bypass safety checks for destructive actions"),
         verbose: z.boolean().optional().describe("Return available elements and AI suggestions on failure"),
     }, async ({ selector, force, verbose }) => {
-        const b = await getBrowser();
-        const result = await b.click(selector, { force, verbose });
-        const response = {
-            success: result.success,
-            message: result.message,
-            screenshot: result.screenshot,
-        };
-        if (verbose && !result.success) {
-            if (result.availableElements)
-                response.availableElements = result.availableElements;
-            if (result.aiSuggestion)
-                response.aiSuggestion = result.aiSuggestion;
-            if (result.debugScreenshot)
-                response.debugScreenshot = result.debugScreenshot;
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
-        };
+        // v14.2.1: Wrap with retry for transient errors
+        return await withRetry(async () => {
+            const b = await getBrowser();
+            const result = await b.click(selector, { force, verbose });
+            const response = {
+                success: result.success,
+                message: result.message,
+                screenshot: result.screenshot,
+            };
+            if (verbose && !result.success) {
+                if (result.availableElements)
+                    response.availableElements = result.availableElements;
+                if (result.aiSuggestion)
+                    response.aiSuggestion = result.aiSuggestion;
+                if (result.debugScreenshot)
+                    response.debugScreenshot = result.debugScreenshot;
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        });
     });
     server.tool("smart_click", "Click with auto-retry and self-healing selectors. v11.8.0: Added confidence gating - only reports success if healed selector has >= 60% confidence.", {
         selector: z.string().describe("Element to click"),
@@ -326,23 +370,26 @@ export async function startMcpServer() {
         value: z.string().describe("Value to enter"),
         verbose: z.boolean().optional().describe("Return available inputs and AI suggestions on failure"),
     }, async ({ selector, value, verbose }) => {
-        const b = await getBrowser();
-        const result = await b.fill(selector, value, { verbose });
-        const response = {
-            success: result.success,
-            message: result.message,
-        };
-        if (verbose && !result.success) {
-            if (result.availableInputs)
-                response.availableInputs = result.availableInputs;
-            if (result.aiSuggestion)
-                response.aiSuggestion = result.aiSuggestion;
-            if (result.debugScreenshot)
-                response.debugScreenshot = result.debugScreenshot;
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
-        };
+        // v14.2.1: Wrap with retry for transient errors
+        return await withRetry(async () => {
+            const b = await getBrowser();
+            const result = await b.fill(selector, value, { verbose });
+            const response = {
+                success: result.success,
+                message: result.message,
+            };
+            if (verbose && !result.success) {
+                if (result.availableInputs)
+                    response.availableInputs = result.availableInputs;
+                if (result.aiSuggestion)
+                    response.aiSuggestion = result.aiSuggestion;
+                if (result.debugScreenshot)
+                    response.debugScreenshot = result.debugScreenshot;
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        });
     });
     // =========================================================================
     // Extraction Tools
@@ -350,30 +397,36 @@ export async function startMcpServer() {
     server.tool("screenshot", "Take a screenshot of the current page", {
         path: z.string().optional().describe("Optional path to save the screenshot"),
     }, async ({ path }) => {
-        const b = await getBrowser();
-        const file = await b.screenshot(path);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({ screenshot: file }, null, 2),
-                },
-            ],
-        };
+        // v14.2.1: Wrap with retry for transient errors
+        return await withRetry(async () => {
+            const b = await getBrowser();
+            const file = await b.screenshot(path);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ screenshot: file }, null, 2),
+                    },
+                ],
+            };
+        });
     });
     server.tool("extract", "Extract data from the page", {
         what: z.enum(["links", "headings", "forms", "images", "text"]).describe("What to extract"),
     }, async ({ what }) => {
-        const b = await getBrowser();
-        const result = await b.extract(what);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result.data, null, 2),
-                },
-            ],
-        };
+        // v14.2.1: Wrap with retry for transient errors
+        return await withRetry(async () => {
+            const b = await getBrowser();
+            const result = await b.extract(what);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result.data, null, 2),
+                    },
+                ],
+            };
+        });
     });
     // =========================================================================
     // Assertion Tools
@@ -503,16 +556,19 @@ export async function startMcpServer() {
     // Self-Healing Tools
     // =========================================================================
     server.tool("heal_stats", "Get self-healing selector cache statistics", {}, async () => {
-        const b = await getBrowser();
-        const stats = b.getSelectorCacheStats();
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(stats, null, 2),
-                },
-            ],
-        };
+        // v14.2.1: Wrap with retry for transient errors
+        return await withRetry(async () => {
+            const b = await getBrowser();
+            const stats = b.getSelectorCacheStats();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(stats, null, 2),
+                    },
+                ],
+            };
+        });
     });
     // =========================================================================
     // Visual Testing Tools (v7.0.0+)
@@ -1914,14 +1970,20 @@ Begin the simulation now. Narrate your thoughts as this persona.
                             url: result.url,
                             goal: result.goal,
                             overallScore: result.overallScore,
-                            resultsSummary: result.results.map((r) => ({
-                                persona: r.persona,
-                                disabilityType: r.disabilityType,
-                                goalAchieved: r.goalAchieved,
-                                empathyScore: r.empathyScore,
-                                barrierCount: r.barriers.length,
-                                wcagViolationCount: r.wcagViolations.length,
-                            })),
+                            resultsSummary: result.results.map((r) => {
+                                // v14.2.4: Show both total barriers and unique barrier types
+                                const uniqueTypes = new Set(r.barriers.map(b => b.type));
+                                return {
+                                    persona: r.persona,
+                                    disabilityType: r.disabilityType,
+                                    goalAchieved: r.goalAchieved,
+                                    empathyScore: r.empathyScore,
+                                    barrierCount: r.barriers.length,
+                                    uniqueBarrierTypes: uniqueTypes.size,
+                                    barrierTypes: Array.from(uniqueTypes),
+                                    wcagViolationCount: r.wcagViolations.length,
+                                };
+                            }),
                             allWcagViolations: result.allWcagViolations,
                             topBarriers: result.topBarriers.slice(0, 5), // v11.11.0: Deduplicated by type
                             topRemediation: result.combinedRemediation.slice(0, 5),