cbrowser 17.5.3 → 17.6.1

package/dist/mcp-tools/base/browser-management-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CBrowser MCP Tools - Browser Management Tools
+ *
+ * @copyright 2026 WF Media (Alexandria Eden) alexandria.shai.eden@gmail.com
+ * @license BSL-1.1 (Business Source License 1.1)
+ */
+import type { McpServer, ToolRegistrationContext } from "../types.js";
+/**
+ * Register browser management tools (4 tools: status, browser_health, browser_recover, reset_browser)
+ */
+export declare function registerBrowserManagementTools(server: McpServer, { getBrowser }: ToolRegistrationContext): void;
+//# sourceMappingURL=browser-management-tools.d.ts.map

package/dist/mcp-tools/base/browser-management-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-management-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/base/browser-management-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAItE;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,EACjB,EAAE,UAAU,EAAE,EAAE,uBAAuB,GACtC,IAAI,CA8EN"}

package/dist/mcp-tools/base/browser-management-tools.js

@@ -0,0 +1,69 @@
+/**
+ * CBrowser MCP Tools - Browser Management Tools
+ *
+ * @copyright 2026 WF Media (Alexandria Eden) alexandria.shai.eden@gmail.com
+ * @license BSL-1.1 (Business Source License 1.1)
+ */
+import { z } from "zod";
+import { getStatusInfo } from "../../config.js";
+import { VERSION } from "../../version.js";
+/**
+ * Register browser management tools (4 tools: status, browser_health, browser_recover, reset_browser)
+ */
+export function registerBrowserManagementTools(server, { getBrowser }) {
+    server.tool("status", "Get CBrowser environment status and diagnostics including data directories, installed browsers, configuration, and self-healing cache statistics", {}, async () => {
+        const info = await getStatusInfo(VERSION);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(info, null, 2),
+                },
+            ],
+        };
+    });
+    server.tool("browser_health", "Check if the browser is healthy and responsive. Use this before operations if you suspect the browser may have crashed.", {}, async () => {
+        const b = await getBrowser();
+        const result = await b.isBrowserHealthy();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    server.tool("browser_recover", "Attempt to recover from a browser crash by restarting the browser process. Use this when browser_health returns unhealthy.", {
+        restoreUrl: z.string().url().optional().describe("URL to restore after recovery (uses last known URL if not provided)"),
+        maxAttempts: z.number().optional().default(3).describe("Maximum recovery attempts"),
+    }, async ({ restoreUrl, maxAttempts }) => {
+        const b = await getBrowser();
+        const result = await b.recoverBrowser({ restoreUrl, maxAttempts });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    server.tool("reset_browser", "Reset the browser to a clean state. Clears all cookies, localStorage, sessionStorage, and browser state. Use this when you need a fresh browser environment.", {}, async () => {
+        const b = await getBrowser();
+        await b.reset();
+        await b.launch();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        message: "Browser reset to clean state and relaunched",
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=browser-management-tools.js.map

package/dist/mcp-tools/base/browser-management-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-management-tools.js","sourceRoot":"","sources":["../../../src/mcp-tools/base/browser-management-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAAiB,EACjB,EAAE,UAAU,EAA2B;IAEvC,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,kJAAkJ,EAClJ,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,yHAAyH,EACzH,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,CAAC,GAAG,MAAM,UAAU,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,4HAA4H,EAC5H;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;QACvH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KACpF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE;QACpC,MAAM,CAAC,GAAG,MAAM,UAAU,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;QACnE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,8JAA8J,EAC9J,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,CAAC,GAAG,MAAM,UAAU,EAAE,CAAC;QAC7B,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,6CAA6C;qBACvD,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp-tools/base/bug-analysis-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CBrowser MCP Tools - Bug Analysis Tools
+ *
+ * @copyright 2026 WF Media (Alexandria Eden) alexandria.shai.eden@gmail.com
+ * @license BSL-1.1 (Business Source License 1.1)
+ */
+import type { McpServer, ToolRegistrationContext } from "../types.js";
+/**
+ * Register bug analysis tools (2 tools: hunt_bugs, chaos_test)
+ */
+export declare function registerBugAnalysisTools(server: McpServer, { getBrowser }: ToolRegistrationContext): void;
+//# sourceMappingURL=bug-analysis-tools.d.ts.map

package/dist/mcp-tools/base/bug-analysis-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-analysis-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/base/bug-analysis-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtE;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,EAAE,UAAU,EAAE,EAAE,uBAAuB,GACtC,IAAI,CA6FN"}

package/dist/mcp-tools/base/bug-analysis-tools.js

@@ -0,0 +1,97 @@
+/**
+ * CBrowser MCP Tools - Bug Analysis Tools
+ *
+ * @copyright 2026 WF Media (Alexandria Eden) alexandria.shai.eden@gmail.com
+ * @license BSL-1.1 (Business Source License 1.1)
+ */
+import { z } from "zod";
+import { huntBugs, runChaosTest } from "../../analysis/index.js";
+/**
+ * Register bug analysis tools (2 tools: hunt_bugs, chaos_test)
+ */
+export function registerBugAnalysisTools(server, { getBrowser }) {
+    server.tool("hunt_bugs", "Autonomous bug hunting - crawl and find issues. Returns bugs with severity, selector, and actionable recommendation for each issue found.", {
+        url: z.string().url().describe("Starting URL to hunt from"),
+        maxPages: z.number().optional().default(10).describe("Maximum pages to visit"),
+        timeout: z.number().optional().default(60000).describe("Timeout in milliseconds"),
+    }, async ({ url, maxPages, timeout }) => {
+        const b = await getBrowser();
+        const result = await huntBugs(b, url, { maxPages, timeout });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        pagesVisited: result.pagesVisited,
+                        bugsFound: result.bugs.length,
+                        duration: result.duration,
+                        bugs: result.bugs.slice(0, 10).map(bug => ({
+                            type: bug.type,
+                            severity: bug.severity,
+                            description: bug.description,
+                            url: bug.url,
+                            selector: bug.selector,
+                            recommendation: bug.recommendation,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    server.tool("chaos_test", "Inject failures and test resilience", {
+        url: z.string().url().describe("URL to test"),
+        networkLatency: z.number().optional().describe("Simulate network latency (ms)"),
+        offline: z.boolean().optional().describe("Simulate offline mode"),
+        blockUrls: z.array(z.string()).optional().describe("URL patterns to block"),
+    }, async ({ url, networkLatency, offline, blockUrls }) => {
+        const b = await getBrowser();
+        try {
+            const result = await runChaosTest(b, url, { networkLatency, offline, blockUrls });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            passed: result.passed,
+                            errors: result.errors,
+                            duration: result.duration,
+                            impact: result.impact,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            try {
+                await b.recoverBrowser();
+            }
+            catch {
+                // Browser recovery failed, but continue with error response
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            passed: false,
+                            errors: [`Chaos test crashed: ${error.message}`],
+                            duration: 0,
+                            impact: {
+                                loadTimeMs: 0,
+                                blockedResources: [],
+                                failedResources: [],
+                                delayedResources: [],
+                                pageCompleted: false,
+                                pageInteractive: false,
+                                consoleErrors: 0,
+                                degradationSummary: ["Test crashed - browser recovered"],
+                            },
+                            recovered: true,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=bug-analysis-tools.js.map

package/dist/mcp-tools/base/bug-analysis-tools.js.map

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

package/dist/mcp-tools/base/cognitive-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CBrowser MCP Tools - Cognitive Simulation Tools
+ *
+ * @copyright 2026 WF Media (Alexandria Eden) alexandria.shai.eden@gmail.com
+ * @license BSL-1.1 (Business Source License 1.1)
+ */
+import type { McpServer, ToolRegistrationContext } from "../types.js";
+/**
+ * Register cognitive simulation tools (3 tools: cognitive_journey_init, cognitive_journey_update_state, list_cognitive_personas)
+ */
+export declare function registerCognitiveTools(server: McpServer, { getBrowser }: ToolRegistrationContext): void;
+//# sourceMappingURL=cognitive-tools.d.ts.map

package/dist/mcp-tools/base/cognitive-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/base/cognitive-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAkBtE;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,EAAE,UAAU,EAAE,EAAE,uBAAuB,GACtC,IAAI,CAodN"}