brms-host 1.0.0

package/build/index.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * BRMS Host entry point.
+ *
+ * - Starts an HTTP server on port 3100 exposing MCP via Streamable HTTP
+ * - Starts the native messaging bridge to communicate with the Chrome extension
+ */
+import { createServer as createHttpServer } from 'node:http';
+import { writeFileSync, appendFileSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer } from './server.js';
+import { bridge } from './bridge/native-messaging.js';
+import { log } from './utils/logger.js';
+const PORT = parseInt(process.env.BRMS_PORT ?? '3100', 10);
+const DEBUG_LOG = '/tmp/brms-host-debug.log';
+function debugLog(msg) {
+    const line = `[${new Date().toISOString()}] ${msg}\n`;
+    try {
+        appendFileSync(DEBUG_LOG, line);
+    }
+    catch { }
+    log.info(msg);
+}
+// Catch everything that might kill the process
+process.on('exit', (code) => {
+    debugLog(`Process exiting with code ${code}`);
+});
+process.on('uncaughtException', (err) => {
+    debugLog(`UNCAUGHT EXCEPTION: ${err.stack ?? err.message}`);
+});
+process.on('unhandledRejection', (reason) => {
+    debugLog(`UNHANDLED REJECTION: ${reason}`);
+});
+process.on('SIGTERM', () => debugLog('Received SIGTERM'));
+process.on('SIGINT', () => debugLog('Received SIGINT'));
+// Keep process alive even if stdin closes
+process.stdin.on('end', () => {
+    debugLog('stdin ended — keeping process alive');
+});
+process.stdin.resume();
+async function main() {
+    writeFileSync(DEBUG_LOG, `=== BRMS Host starting at ${new Date().toISOString()} ===\n`);
+    debugLog(`PID: ${process.pid}, Node: ${process.version}`);
+    debugLog(`stdin isTTY: ${process.stdin.isTTY}, stdout isTTY: ${process.stdout.isTTY}`);
+    bridge.start();
+    debugLog('Bridge started');
+    const mcpServer = createServer();
+    debugLog('MCP server created');
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+    });
+    const httpServer = createHttpServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', `http://localhost:${PORT}`);
+        if (url.pathname === '/mcp') {
+            try {
+                // Parse body for POST requests before passing to transport
+                if (req.method === 'POST') {
+                    const body = await new Promise((resolve, reject) => {
+                        let data = '';
+                        req.on('data', (chunk) => { data += chunk.toString(); });
+                        req.on('end', () => resolve(data));
+                        req.on('error', reject);
+                    });
+                    const parsedBody = JSON.parse(body);
+                    await transport.handleRequest(req, res, parsedBody);
+                }
+                else {
+                    await transport.handleRequest(req, res);
+                }
+            }
+            catch (err) {
+                debugLog(`MCP request error: ${err instanceof Error ? err.stack : err}`);
+                if (!res.headersSent) {
+                    res.writeHead(500, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: String(err) }));
+                }
+            }
+            return;
+        }
+        if (url.pathname === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: 'ok', extensionConnected: bridge.isConnected() }));
+            return;
+        }
+        res.writeHead(404);
+        res.end('Not found');
+    });
+    await mcpServer.connect(transport);
+    debugLog('MCP connected to transport');
+    httpServer.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            debugLog(`Port ${PORT} in use, retrying in 1s...`);
+            setTimeout(() => {
+                httpServer.close();
+                httpServer.listen(PORT);
+            }, 1000);
+        }
+        else {
+            debugLog(`HTTP server error: ${err.message}`);
+        }
+    });
+    httpServer.listen(PORT, () => {
+        debugLog(`HTTP server listening on :${PORT}`);
+    });
+}
+main().catch((err) => {
+    debugLog(`Fatal error in main: ${err.stack ?? err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3D,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAE7C,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC;IACtD,IAAI,CAAC;QAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACjD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChB,CAAC;AAED,+CAA+C;AAC/C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;IAC1B,QAAQ,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACtC,QAAQ,CAAC,uBAAuB,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,QAAQ,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC1D,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAExD,0CAA0C;AAC1C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;IAC3B,QAAQ,CAAC,qCAAqC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;AAEvB,KAAK,UAAU,IAAI;IACjB,aAAa,CAAC,SAAS,EAAE,6BAA6B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACxF,QAAQ,CAAC,QAAQ,OAAO,CAAC,GAAG,WAAW,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,OAAO,CAAC,KAAK,CAAC,KAAK,mBAAmB,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAEvF,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAE3B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;KACvC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAEhE,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,2DAA2D;gBAC3D,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;wBACzD,IAAI,IAAI,GAAG,EAAE,CAAC;wBACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;wBACjE,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;wBACnC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC1B,CAAC,CAAC,CAAC;oBACH,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACpC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;gBACtD,CAAC;qBAAM,CAAC;oBACN,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBACzE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;oBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC/B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;IAEvC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;QACpD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9B,QAAQ,CAAC,QAAQ,IAAI,4BAA4B,CAAC,CAAC;YACnD,UAAU,CAAC,GAAG,EAAE;gBACd,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QAC3B,QAAQ,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,QAAQ,CAAC,wBAAwB,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;

package/build/server.js

@@ -0,0 +1,30 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerConnectionTools } from './tools/connection.tools.js';
+import { registerNetworkTools } from './tools/network.tools.js';
+import { registerDOMTools } from './tools/dom.tools.js';
+import { registerConsoleTools } from './tools/console.tools.js';
+import { registerStyleTools } from './tools/styles.tools.js';
+import { registerLayoutTools } from './tools/layout.tools.js';
+import { registerScreenshotTools } from './tools/screenshot.tools.js';
+import { registerEventTools } from './tools/events.tools.js';
+import { registerDebugTools } from './tools/debug.tools.js';
+export function createServer() {
+    const server = new McpServer({
+        name: 'brms',
+        version: '1.0.0',
+    });
+    // Phase 1 — core browser inspection
+    registerConnectionTools(server);
+    registerNetworkTools(server);
+    registerDOMTools(server);
+    registerConsoleTools(server);
+    // Phase 2 — styles, layout, screenshots, event listeners
+    registerStyleTools(server);
+    registerLayoutTools(server);
+    registerScreenshotTools(server);
+    registerEventTools(server);
+    // Phase 3 — AI debugging layer
+    registerDebugTools(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oCAAoC;IACpC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,yDAAyD;IACzD,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,+BAA+B;IAC/B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/tools/connection.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerConnectionTools(server: McpServer): void;

package/build/tools/connection.tools.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { browserManager } from '../browser/connection.js';
+import { networkMonitor } from '../browser/network.js';
+import { consoleCapture } from '../browser/console.js';
+import { safeResult } from '../utils/errors.js';
+export function registerConnectionTools(server) {
+    server.tool('connect_browser', 'Connect to the browser via the BRMS Chrome Extension. The extension must be installed and active.', {}, async () => {
+        return safeResult(async () => {
+            const pages = await browserManager.connect();
+            networkMonitor.attach();
+            consoleCapture.attach();
+            return JSON.stringify({ connected: true, pages }, null, 2);
+        });
+    });
+    server.tool('list_pages', 'List all open tabs/pages in the connected browser.', {}, async () => {
+        return safeResult(async () => {
+            const pages = await browserManager.getPages();
+            return JSON.stringify(pages, null, 2);
+        });
+    });
+    server.tool('select_page', 'Select an open browser tab by index for subsequent inspection.', { index: z.number().int().min(0).describe('Zero-based index of the page to select') }, async ({ index }) => {
+        return safeResult(async () => {
+            const info = await browserManager.selectPage(index);
+            return JSON.stringify(info, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=connection.tools.js.map

package/build/tools/connection.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.tools.js","sourceRoot":"","sources":["../../src/tools/connection.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,mGAAmG,EACnG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;YAE7C,cAAc,CAAC,MAAM,EAAE,CAAC;YACxB,cAAc,CAAC,MAAM,EAAE,CAAC;YAExB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,oDAAoD,EACpD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,aAAa,EACb,gEAAgE,EAChE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC,EAAE,EACrF,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/console.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerConsoleTools(server: McpServer): void;

package/build/tools/console.tools.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { consoleCapture } from '../browser/console.js';
+import { safeResult } from '../utils/errors.js';
+export function registerConsoleTools(server) {
+    server.tool('get_console_errors', 'Return console errors (and optionally warnings) captured from the active page.', {
+        limit: z.number().int().min(1).max(200).optional().describe('Max number of entries to return'),
+        includeWarnings: z.boolean().optional().describe('Also include console warnings (default: false)'),
+    }, async ({ limit, includeWarnings }) => {
+        return safeResult(async () => {
+            const errors = consoleCapture.getErrors(limit);
+            let results = [...errors];
+            if (includeWarnings) {
+                const warnings = consoleCapture.getEntries('warn', limit);
+                results = [...results, ...warnings].sort((a, b) => a.timestamp - b.timestamp);
+                if (limit)
+                    results = results.slice(-limit);
+            }
+            if (results.length === 0) {
+                return 'No console errors captured.';
+            }
+            return JSON.stringify(results, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=console.tools.js.map

package/build/tools/console.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.tools.js","sourceRoot":"","sources":["../../src/tools/console.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,gFAAgF,EAChF;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC9F,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KACnG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE;QACnC,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAE1B,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBAC1D,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;gBAC9E,IAAI,KAAK;oBAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;YAC7C,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,6BAA6B,CAAC;YACvC,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/debug.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDebugTools(server: McpServer): void;

package/build/tools/debug.tools.js

@@ -0,0 +1,226 @@
+import { z } from 'zod';
+import { bridge } from '../bridge/native-messaging.js';
+import { networkMonitor } from '../browser/network.js';
+import { consoleCapture } from '../browser/console.js';
+import { safeResult } from '../utils/errors.js';
+export function registerDebugTools(server) {
+    // ───────────────────────────────────────────────
+    // debug_element
+    // ───────────────────────────────────────────────
+    server.tool('debug_element', 'Comprehensive diagnosis of why an element may not be clickable, visible, or behaving as expected. Checks the element and its entire ancestor chain for CSS issues, overlaps, disabled state, stacking context, and clickability.', {
+        selector: z.string().describe('CSS selector of the element to debug'),
+    }, async ({ selector }) => {
+        return safeResult(async () => {
+            const analysis = await bridge.sendRequest('debug_element', { selector });
+            if (!analysis.found) {
+                const result = { issue: 'Element not found', reasons: [`No element matches selector: ${selector}`], confidence: 1.0 };
+                return JSON.stringify(result);
+            }
+            const failedChecks = analysis.checks.filter((c) => !c.passed);
+            const diagnosis = {
+                issue: failedChecks.length > 0 ? failedChecks[0].detail : 'No obvious issues detected',
+                reasons: failedChecks.map((c) => c.detail),
+                confidence: failedChecks.length > 0 ? Math.min(0.95, 0.7 + failedChecks.length * 0.05) : 0.4,
+            };
+            return JSON.stringify({ ...analysis, diagnosis }, null, 2);
+        });
+    });
+    // ───────────────────────────────────────────────
+    // diagnose_network
+    // ───────────────────────────────────────────────
+    server.tool('diagnose_network', 'Diagnose network issues: failed requests, slow responses, CORS problems, rate limiting, and error body parsing. Groups failures by domain.', {
+        urlPattern: z.string().optional().describe('Regex pattern to filter by URL'),
+    }, async ({ urlPattern }) => {
+        return safeResult(async () => {
+            const entries = networkMonitor.getEntries({ urlPattern });
+            const consoleErrors = consoleCapture.getErrors();
+            const durations = entries.map((e) => e.timing.duration).filter((d) => d > 0).sort((a, b) => a - b);
+            const p95Index = Math.floor(durations.length * 0.95);
+            const p95 = durations[p95Index] ?? 0;
+            const timingBuckets = { fast: 0, normal: 0, slow: 0, verySlow: 0 };
+            for (const d of durations) {
+                if (d < 200)
+                    timingBuckets.fast++;
+                else if (d < 1000)
+                    timingBuckets.normal++;
+                else if (d < 3000)
+                    timingBuckets.slow++;
+                else
+                    timingBuckets.verySlow++;
+            }
+            const failedRequests = entries
+                .filter((e) => e.status !== null && e.status >= 400)
+                .map((e) => {
+                let errorBody = null;
+                if (e.responseBody) {
+                    try {
+                        const parsed = JSON.parse(e.responseBody);
+                        errorBody = parsed.message || parsed.error || parsed.detail || e.responseBody.slice(0, 500);
+                    }
+                    catch {
+                        errorBody = e.responseBody.slice(0, 500);
+                    }
+                }
+                return { url: e.url, status: e.status, method: e.method, errorBody };
+            });
+            const corsIssues = entries
+                .filter((e) => e.status === null && !e.resourceType.match(/^(image|stylesheet|font|media)$/i))
+                .map((e) => ({ url: e.url, method: e.method }));
+            const rateLimited = entries
+                .filter((e) => e.status === 429)
+                .map((e) => {
+                let domain = '';
+                try {
+                    domain = new URL(e.url).hostname;
+                }
+                catch { }
+                return { url: e.url, domain };
+            });
+            const failuresByDomain = {};
+            for (const f of failedRequests) {
+                try {
+                    const domain = new URL(f.url).hostname;
+                    failuresByDomain[domain] = (failuresByDomain[domain] || 0) + 1;
+                }
+                catch { }
+            }
+            const parts = [];
+            parts.push(`${entries.length} total requests captured`);
+            if (failedRequests.length > 0)
+                parts.push(`${failedRequests.length} failed (4xx/5xx)`);
+            if (corsIssues.length > 0)
+                parts.push(`${corsIssues.length} possible CORS issues`);
+            if (rateLimited.length > 0)
+                parts.push(`${rateLimited.length} rate-limited (429)`);
+            if (timingBuckets.verySlow > 0)
+                parts.push(`${timingBuckets.verySlow} very slow requests (>3s)`);
+            if (p95 > 1000)
+                parts.push(`P95 response time: ${Math.round(p95)}ms`);
+            if (failedRequests.length === 0 && corsIssues.length === 0)
+                parts.push('No issues detected');
+            const diagnosis = {
+                totalRequests: entries.length,
+                timingBuckets,
+                p95ResponseTime: Math.round(p95),
+                failedRequests: failedRequests.slice(-30),
+                corsIssues: corsIssues.slice(-10),
+                rateLimited: rateLimited.slice(-10),
+                failuresByDomain,
+                relatedConsoleErrors: consoleErrors.slice(-10).map((e) => e.text),
+                summary: parts.join('. ') + '.',
+            };
+            return JSON.stringify(diagnosis, null, 2);
+        });
+    });
+    // ───────────────────────────────────────────────
+    // correlate_issues
+    // ───────────────────────────────────────────────
+    server.tool('correlate_issues', 'Cross-reference network errors, console errors, and DOM state. Detects broken resources, auth failure chains, repeated errors, and ranks by severity.', {}, async () => {
+        return safeResult(async () => {
+            const allNetworkEntries = networkMonitor.getEntries();
+            const networkErrors = allNetworkEntries.filter((e) => e.status !== null && e.status >= 400);
+            const consoleErrors = consoleCapture.getErrors(100);
+            const allConsole = consoleCapture.getEntries(undefined, 200);
+            const correlations = [];
+            // 1. Network <-> Console: URL pathname matching
+            for (const netErr of networkErrors.slice(-30)) {
+                let pathname = '';
+                try {
+                    pathname = new URL(netErr.url).pathname;
+                }
+                catch {
+                    continue;
+                }
+                const related = consoleErrors.filter((ce) => ce.text.includes(pathname));
+                if (related.length > 0) {
+                    correlations.push({
+                        domain: 'network <-> console',
+                        severity: netErr.status >= 500 ? 'critical' : 'warning',
+                        details: `Failed ${netErr.method} ${netErr.url} (${netErr.status}) has ${related.length} related console error(s)`,
+                        evidence: related.slice(0, 3).map((r) => r.text.slice(0, 200)),
+                    });
+                }
+            }
+            // 2. Network -> DOM: broken images, failed scripts/stylesheets
+            const brokenResources = allNetworkEntries.filter((e) => (e.status !== null && e.status >= 400) &&
+                ['script', 'stylesheet', 'image'].includes(e.resourceType));
+            for (const res of brokenResources.slice(-10)) {
+                let severity = 'warning';
+                if (res.resourceType === 'script')
+                    severity = 'critical';
+                correlations.push({
+                    domain: 'network -> DOM',
+                    severity,
+                    details: `Broken ${res.resourceType}: ${res.url} (${res.status})`,
+                    evidence: [`Resource type: ${res.resourceType}`, `Status: ${res.status}`],
+                });
+            }
+            // 3. Console -> DOM: check if element IDs from console errors exist
+            const errorTexts = consoleErrors.slice(-20).map((e) => e.text);
+            const domCorrelations = await bridge.sendRequest('correlate_dom_check', { errors: errorTexts });
+            const domResults = (domCorrelations.results ?? []);
+            for (const dc of domResults) {
+                correlations.push({
+                    domain: 'console -> DOM',
+                    severity: dc.exists ? 'info' : 'warning',
+                    details: `Console error references ${dc.selector} (${dc.exists ? 'element exists' : 'element NOT found'})`,
+                    evidence: [dc.error],
+                });
+            }
+            // 4. Auth failure chains (401 -> redirect pattern)
+            const authFailures = networkErrors.filter((e) => e.status === 401 || e.status === 403);
+            if (authFailures.length > 0) {
+                const redirectsAfter = allNetworkEntries.filter((e) => (e.status === 302 || e.status === 301) &&
+                    e.timestamp > authFailures[0].timestamp);
+                correlations.push({
+                    domain: 'auth chain',
+                    severity: 'critical',
+                    details: `${authFailures.length} auth failure(s) (401/403)${redirectsAfter.length > 0 ? ` followed by ${redirectsAfter.length} redirect(s)` : ''}`,
+                    evidence: authFailures.slice(0, 5).map((a) => `${a.method} ${a.url} -> ${a.status}`),
+                });
+            }
+            // 5. Repeated errors
+            const errorCounts = {};
+            for (const ce of consoleErrors) {
+                const key = ce.text.slice(0, 100);
+                errorCounts[key] = (errorCounts[key] || 0) + 1;
+            }
+            const repeated = Object.entries(errorCounts).filter(([, count]) => count >= 3);
+            for (const [text, count] of repeated) {
+                correlations.push({
+                    domain: 'repeated errors',
+                    severity: 'warning',
+                    details: `Console error repeated ${count} times`,
+                    evidence: [text],
+                });
+            }
+            // 6. Timeline (last 30 events chronologically)
+            const timeline = [
+                ...allNetworkEntries.slice(-15).map((e) => ({
+                    type: 'network',
+                    time: e.timestamp,
+                    summary: `${e.method} ${e.url.slice(0, 80)} -> ${e.status ?? 'aborted'}`,
+                })),
+                ...allConsole.slice(-15).map((e) => ({
+                    type: 'console',
+                    time: e.timestamp,
+                    summary: `[${e.level}] ${e.text.slice(0, 100)}`,
+                })),
+            ].sort((a, b) => a.time - b.time);
+            const severityOrder = { critical: 0, warning: 1, info: 2 };
+            correlations.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+            const critical = correlations.filter((c) => c.severity === 'critical').length;
+            const warning = correlations.filter((c) => c.severity === 'warning').length;
+            return JSON.stringify({
+                networkErrors: networkErrors.length,
+                consoleErrors: consoleErrors.length,
+                correlations,
+                timeline: timeline.slice(-30),
+                summary: correlations.length > 0
+                    ? `Found ${correlations.length} correlation(s): ${critical} critical, ${warning} warning, ${correlations.length - critical - warning} info`
+                    : 'No cross-domain correlations found',
+            }, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=debug.tools.js.map

package/build/tools/debug.tools.js.map

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

package/build/tools/dom.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDOMTools(server: McpServer): void;

package/build/tools/dom.tools.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { getSnapshot, queryDOM } from '../browser/dom.js';
+import { safeResult } from '../utils/errors.js';
+export function registerDOMTools(server) {
+    server.tool('get_dom_tree', 'Return the DOM tree structure of the active page. Optionally scope to a CSS selector and limit tree depth.', {
+        selector: z.string().optional().describe('CSS selector to scope the tree (default: entire document)'),
+        depth: z.number().int().min(1).max(20).optional().describe('Max tree depth (default: 10)'),
+    }, async ({ selector, depth }) => {
+        return safeResult(async () => {
+            const tree = await getSnapshot(selector, depth);
+            return JSON.stringify(tree, null, 2);
+        });
+    });
+    server.tool('query_dom', 'Query the active page DOM using a CSS selector. Returns matching elements with tag, id, classes, text content, and attributes.', {
+        selector: z.string().describe('CSS selector to query'),
+    }, async ({ selector }) => {
+        return safeResult(async () => {
+            const elements = await queryDOM(selector);
+            if (elements.length === 0) {
+                return `No elements found matching selector: ${selector}`;
+            }
+            return JSON.stringify(elements, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=dom.tools.js.map

package/build/tools/dom.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.tools.js","sourceRoot":"","sources":["../../src/tools/dom.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,cAAc,EACd,4GAA4G,EAC5G;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QACrG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC3F,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5B,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,WAAW,EACX,gIAAgI,EAChI;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KACvD,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,wCAAwC,QAAQ,EAAE,CAAC;YAC5D,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/events.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerEventTools(server: McpServer): void;

package/build/tools/events.tools.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { bridge } from '../bridge/native-messaging.js';
+import { safeResult } from '../utils/errors.js';
+export function registerEventTools(server) {
+    server.tool('get_event_listeners', 'Get event listeners attached to elements matching a selector via Chrome DevTools Protocol. Returns event type, handler source preview, and listener options.', {
+        selector: z.string().describe('CSS selector to query'),
+    }, async ({ selector }) => {
+        return safeResult(async () => {
+            const result = await bridge.sendRequest('get_event_listeners', { selector });
+            const results = result.results;
+            if (!results || results.length === 0) {
+                return `No elements found for selector: ${selector}`;
+            }
+            return JSON.stringify(results, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=events.tools.js.map

package/build/tools/events.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.tools.js","sourceRoot":"","sources":["../../src/tools/events.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,8JAA8J,EAC9J;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KACvD,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAyC,CAAC;YAEjE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrC,OAAO,mCAAmC,QAAQ,EAAE,CAAC;YACvD,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/layout.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerLayoutTools(server: McpServer): void;

package/build/tools/layout.tools.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { bridge } from '../bridge/native-messaging.js';
+import { safeResult } from '../utils/errors.js';
+export function registerLayoutTools(server) {
+    server.tool('get_layout_info', 'Get bounding box, visibility, viewport status, overlap detection, parent clipping, and scroll context for elements matching a selector.', {
+        selector: z.string().describe('CSS selector to query'),
+    }, async ({ selector }) => {
+        return safeResult(async () => {
+            const result = await bridge.sendRequest('get_layout', { selector });
+            return JSON.stringify(result.results ?? result, null, 2);
+        });
+    });
+    server.tool('get_visible_elements', 'Return all interactive elements currently visible in the viewport with accessibility info (role, aria-label, disabled state).', {}, async () => {
+        return safeResult(async () => {
+            const result = await bridge.sendRequest('get_visible', {});
+            return JSON.stringify(result.elements ?? result, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=layout.tools.js.map

package/build/tools/layout.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.tools.js","sourceRoot":"","sources":["../../src/tools/layout.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,yIAAyI,EACzI;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KACvD,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,+HAA+H,EAC/H,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/network.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerNetworkTools(server: McpServer): void;

package/build/tools/network.tools.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { networkMonitor } from '../browser/network.js';
+import { safeResult } from '../utils/errors.js';
+export function registerNetworkTools(server) {
+    server.tool('get_network_calls', 'Return captured network requests from the active page. Supports filtering by URL pattern, status code, and resource type.', {
+        urlPattern: z.string().optional().describe('Regex pattern to filter by URL'),
+        statusCode: z.number().int().optional().describe('Filter by exact HTTP status code'),
+        resourceType: z.string().optional().describe('Filter by resource type (xhr, fetch, document, stylesheet, image, script, etc.)'),
+        limit: z.number().int().min(1).max(100).optional().describe('Max number of entries to return (default: all, max 100)'),
+    }, async ({ urlPattern, statusCode, resourceType, limit }) => {
+        return safeResult(async () => {
+            const entries = networkMonitor.getEntries({ urlPattern, statusCode, resourceType, limit });
+            if (entries.length === 0) {
+                return 'No network calls captured yet. Browse some pages first, then try again.';
+            }
+            const summary = entries.map((e) => ({
+                url: e.url,
+                method: e.method,
+                status: e.status,
+                resourceType: e.resourceType,
+                timing: e.timing,
+                requestBody: e.requestBody,
+                responseBody: e.responseBody?.slice(0, 2000) ?? null,
+            }));
+            return JSON.stringify(summary, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=network.tools.js.map

package/build/tools/network.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.tools.js","sourceRoot":"","sources":["../../src/tools/network.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,2HAA2H,EAC3H;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC5E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACpF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iFAAiF,CAAC;QAC/H,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;KACvH,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;QACxD,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;YAE3F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,yEAAyE,CAAC;YACnF,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI;aACrD,CAAC,CAAC,CAAC;YAEJ,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/screenshot.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerScreenshotTools(server: McpServer): void;