mcp-web-inspector 0.1.3 → 0.2.0

package/README.md

@@ -39,6 +39,33 @@ npm install -g mcp-web-inspector
 
 All configurations below use `npx` which automatically downloads and runs the latest version. Click to expand installation instructions for your AI tool:
 
+<details>
+<summary><b>🚀 Codex CLI</b></summary>
+
+### Installation via CLI
+
+```bash
+# Add the server globally
+codex mcp add web-inspector -- npx -y mcp-web-inspector
+
+# Verify it was registered
+codex mcp list
+```
+
+### Manual Configuration
+
+Codex stores MCP server definitions in `~/.codex/config.toml`. Add (or create) an entry under the `[mcp.servers]` table:
+
+```toml
+[mcp.servers.web-inspector]
+command = "npx"
+args = ["-y", "mcp-web-inspector"]
+```
+
+Restart Codex CLI to make sure the new server is available in future sessions.
+
+</details>
+
 <details>
 <summary><b>🤖 Claude Code (CLI)</b></summary>
 
@@ -109,10 +136,10 @@ Restart Claude Desktop after saving the configuration.
 
 ```bash
 # VS Code Stable
-code --add-mcp '{"name":"web-inspector","command":"npx","args":["mcp-web-inspector"]}'
+code --add-mcp '{"name":"web-inspector","command":"npx","args":["-y","mcp-web-inspector"]}'
 
 # VS Code Insiders
-code-insiders --add-mcp '{"name":"web-inspector","command":"npx","args":["mcp-web-inspector"]}'
+code-insiders --add-mcp '{"name":"web-inspector","command":"npx","args":["-y","mcp-web-inspector"]}'
 ```
 
 ### Manual Configuration
@@ -277,6 +304,8 @@ Most MCP-compatible tools use a similar configuration format. Look for:
 }
 ```
 
+CLI-first assistants such as GitHub Copilot CLI, Copylot CLI, Continue CLI, and other emerging AI coders follow the same pattern—either run their `mcp add` command with `npx -y mcp-web-inspector` or drop the snippet above into their MCP config file.
+
 If your tool supports MCP but isn't listed here, consult its documentation for the exact configuration file location.
 
 </details>
@@ -289,6 +318,7 @@ Customize server behavior with command line flags:
 
 - **`--no-save-session`** - Disable automatic session persistence (start with fresh browser state each time)
 - **`--user-data-dir <path>`** - Custom directory for session data (default: `./.mcp-web-inspector`)
+- **`--headless`** - Run browser in headless mode by default (no visible window)
 
 **Example usage:**
 ```json
@@ -302,6 +332,30 @@ Customize server behavior with command line flags:
 }
 ```
 
+**Run in headless mode for automation/CI:**
+```json
+{
+  "mcpServers": {
+    "web-inspector": {
+      "command": "npx",
+      "args": ["-y", "mcp-web-inspector", "--headless"]
+    }
+  }
+}
+```
+
+**Combine multiple flags:**
+```json
+{
+  "mcpServers": {
+    "web-inspector": {
+      "command": "npx",
+      "args": ["-y", "mcp-web-inspector", "--headless", "--no-save-session"]
+    }
+  }
+}
+```
+
 ---
 
 ## Session Persistence & Data Storage
@@ -395,8 +449,8 @@ rm -rf ./.mcp-web-inspector/screenshots    # Clear screenshots only
 - Session files can be large and bloat your git history
 
 **Best practices:**
-- Use `headless: true` for automation and CI/CD environments
-- Use `headless: false` only when debugging interactively
+- **Default is visible browser** (`headless: false`) for interactive debugging
+- Use `headless: true` explicitly for automation and CI/CD environments
 - Clear session data after testing sensitive applications
 - Use `--no-save-session` flag when testing on shared/public sites
 
@@ -570,11 +624,16 @@ Ultra-lightweight existence check. Returns simple ✓ exists or ✗ not found st
 Navigate to a URL with full browser configuration options.
 
 **Parameters:**
-- `browserType` - chromium, firefox, or webkit
-- `width`, `height` - Viewport dimensions
-- `headless` - Run in headless mode
-- `timeout` - Navigation timeout
-- `waitUntil` - Navigation wait condition
+- `browserType` - chromium, firefox, or webkit (default: chromium)
+- `width`, `height` - Viewport dimensions (default: auto-detected screen size)
+- `headless` - Run in headless mode (default: **false** - browser window visible)
+- `timeout` - Navigation timeout in ms (default: 30000)
+- `waitUntil` - Navigation wait condition (default: "load")
+
+**Default Behavior:**
+- Browser window is **visible by default** for interactive debugging
+- Use `headless: true` for automation, CI/CD, or when you don't need visual feedback
+- Use `headless: false` (or omit) when debugging interactively
 
 #### `go_back`
 Navigate back in browser history. Essential for testing navigation flows and multi-step forms.

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createToolDefinitions } from "./tools.js";
+import { createToolDefinitions } from "./tools/common/registry.js";
 import { setupRequestHandlers } from "./requestHandler.js";
 import { parseArgs } from "node:util";
 import { setSessionConfig } from "./toolHandler.js";
@@ -16,6 +16,10 @@ const { values } = parseArgs({
             type: 'string',
             default: './.mcp-web-inspector',
         },
+        'headless': {
+            type: 'boolean',
+            default: false,
+        },
     },
     strict: false,
 });
@@ -25,6 +29,7 @@ const sessionConfig = {
     saveSession: !Boolean(values['no-save-session']),
     userDataDir: `${baseDir}/user-data`,
     screenshotsDir: `${baseDir}/screenshots`,
+    headlessDefault: Boolean(values['headless']),
 };
 setSessionConfig(sessionConfig);
 async function runServer() {

package/dist/toolConstants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tool constants - separate file to avoid circular dependencies
+ */
+/**
+ * Get list of all browser tool names
+ */
+export declare const BROWSER_TOOLS: string[];

package/dist/toolConstants.js

@@ -0,0 +1,46 @@
+/**
+ * Tool constants - separate file to avoid circular dependencies
+ */
+/**
+ * Get list of all browser tool names
+ */
+export const BROWSER_TOOLS = [
+    // Navigation & Control
+    "navigate",
+    "go_back",
+    "go_forward",
+    "screenshot",
+    // DOM Inspection (PRIMARY)
+    "inspect_dom",
+    "get_test_ids",
+    "query_selector",
+    "find_by_text",
+    // Visibility & Position
+    "check_visibility",
+    "compare_element_alignment",
+    "inspect_ancestors",
+    "element_exists",
+    "wait_for_element",
+    "wait_for_network_idle",
+    // Style & Content
+    "get_computed_styles",
+    "measure_element",
+    "get_text",
+    "get_html",
+    "get_console_logs",
+    // Network Monitoring
+    "list_network_requests",
+    "get_request_details",
+    // Interactions (for debugging/testing workflows)
+    "click",
+    "fill",
+    "hover",
+    "select",
+    "upload_file",
+    "drag",
+    "press_key",
+    // JavaScript Execution
+    "evaluate",
+    // Cleanup
+    "close"
+];

package/dist/toolHandler.d.ts

@@ -1,5 +1,6 @@
 import type { Page } from 'playwright';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { SessionConfig } from './tools/common/types.js';
 export interface NetworkRequest {
     index: number;
     method: string;
@@ -18,11 +19,6 @@ export interface NetworkRequest {
         body: string | null;
     };
 }
-interface SessionConfig {
-    saveSession: boolean;
-    userDataDir: string;
-    screenshotsDir: string;
-}
 /**
  * Sets the session configuration
  */
@@ -31,6 +27,10 @@ export declare function setSessionConfig(config: Partial<SessionConfig>): void;
  * Gets the screenshots directory
  */
 export declare function getScreenshotsDir(): string;
+/**
+ * Gets the default headless setting
+ */
+export declare function getHeadlessDefault(): boolean;
 /**
  * Resets browser and page variables
  * Used when browser is closed
@@ -48,7 +48,7 @@ export declare function clearNetworkLog(): void;
  * Sets the provided page to the global page variable
  * @param newPage The Page object to set as the global page
  */
-export declare function setGlobalPage(newPage: Page): void;
+export declare function setGlobalPage(newPage: Page): Promise<void>;
 interface BrowserSettings {
     viewport?: {
         width?: number;

package/dist/toolHandler.js

@@ -1,25 +1,6 @@
 import { chromium, firefox, webkit, devices } from 'playwright';
-import { BROWSER_TOOLS } from './tools.js';
 import { checkBrowsersInstalled, getInstallationInstructions } from './utils/browserCheck.js';
-import { ScreenshotTool, NavigationTool, CloseBrowserTool, ConsoleLogsTool } from './tools/browser/index.js';
-import { ClickTool, FillTool, SelectTool, HoverTool, EvaluateTool, UploadFileTool } from './tools/browser/interaction.js';
-import { VisibleTextTool, VisibleHtmlTool } from './tools/browser/visiblePage.js';
-import { ElementVisibilityTool } from './tools/browser/elementVisibility.js';
-import { InspectDomTool } from './tools/browser/inspectDom.js';
-import { GetTestIdsTool } from './tools/browser/getTestIds.js';
-import { QuerySelectorAllTool } from './tools/browser/querySelectorAll.js';
-import { FindByTextTool } from './tools/browser/findByText.js';
-import { GetComputedStylesTool } from './tools/browser/computedStyles.js';
-import { MeasureElementTool } from './tools/browser/measureElement.js';
-import { ElementExistsTool } from './tools/browser/elementExists.js';
-import { CompareElementAlignmentTool } from './tools/browser/compareElementAlignment.js';
-import { InspectAncestorsTool } from './tools/browser/ancestorInspection.js';
-import { GoBackTool, GoForwardTool } from './tools/browser/navigation.js';
-import { DragTool, PressKeyTool } from './tools/browser/interaction.js';
-import { WaitForElementTool } from './tools/browser/waitForElement.js';
-import { WaitForNetworkIdleTool } from './tools/browser/waitForNetworkIdle.js';
-import { ListNetworkRequestsTool } from './tools/browser/listNetworkRequests.js';
-import { GetRequestDetailsTool } from './tools/browser/getRequestDetails.js';
+import { getToolInstance, isBrowserTool, executeTool } from './tools/common/registry.js';
 // Global state
 let browser;
 let page;
@@ -29,6 +10,7 @@ let sessionConfig = {
     saveSession: false,
     userDataDir: './.mcp-web-inspector/user-data',
     screenshotsDir: './.mcp-web-inspector/screenshots',
+    headlessDefault: false,
 };
 /**
  * Sets the session configuration
@@ -42,6 +24,12 @@ export function setSessionConfig(config) {
 export function getScreenshotsDir() {
     return sessionConfig.screenshotsDir;
 }
+/**
+ * Gets the default headless setting
+ */
+export function getHeadlessDefault() {
+    return sessionConfig.headlessDefault;
+}
 /**
  * Resets browser and page variables
  * Used when browser is closed
@@ -68,52 +56,61 @@ export function clearNetworkLog() {
  * Sets the provided page to the global page variable
  * @param newPage The Page object to set as the global page
  */
-export function setGlobalPage(newPage) {
+export async function setGlobalPage(newPage) {
     page = newPage;
+    // Register console message handlers and network listeners for the new page
+    await registerConsoleMessage(page);
+    await registerNetworkListeners(page);
     page.bringToFront(); // Bring the new tab to the front
-    console.log("Global page has been updated.");
+    console.log("Global page has been updated with listeners registered.");
 }
-// Tool instances
-let screenshotTool;
-let navigationTool;
-let closeBrowserTool;
-let consoleLogsTool;
-let clickTool;
-let fillTool;
-let selectTool;
-let hoverTool;
-let uploadFileTool;
-let evaluateTool;
-let visibleTextTool;
-let visibleHtmlTool;
-let goBackTool;
-let goForwardTool;
-let dragTool;
-let pressKeyTool;
-let elementVisibilityTool;
-let inspectDomTool;
-let getTestIdsTool;
-let querySelectorAllTool;
-let findByTextTool;
-let getComputedStylesTool;
-let measureElementTool;
-let elementExistsTool;
-let compareElementAlignmentTool;
-let inspectAncestorsTool;
-let waitForElementTool;
-let waitForNetworkIdleTool;
-let listNetworkRequestsTool;
-let getRequestDetailsTool;
 /**
  * Device preset mapping to Playwright device descriptors
  */
 const DEVICE_PRESETS = {
+    // Mobile devices
     'iphone-se': 'iPhone SE',
     'iphone-14': 'iPhone 14',
     'iphone-14-pro': 'iPhone 14 Pro',
     'pixel-5': 'Pixel 5',
     'ipad': 'iPad (gen 7)',
-    'samsung-s21': 'Galaxy S21'
+    'samsung-s21': 'Galaxy S21',
+    // Desktop devices (custom configs)
+    'desktop-1080p': 'Desktop 1080p',
+    'desktop-2k': 'Desktop 2K',
+    'laptop-hd': 'Laptop HD'
+};
+/**
+ * Custom device configurations for presets not in Playwright's built-in devices
+ */
+const CUSTOM_DEVICE_CONFIGS = {
+    'Desktop 1080p': {
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.7204.23 Safari/537.36',
+        viewport: { width: 1920, height: 1080 },
+        screen: { width: 1920, height: 1080 },
+        deviceScaleFactor: 1,
+        isMobile: false,
+        hasTouch: false,
+        defaultBrowserType: 'chromium'
+    },
+    'Desktop 2K': {
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.7204.23 Safari/537.36',
+        viewport: { width: 2560, height: 1440 },
+        screen: { width: 2560, height: 1440 },
+        deviceScaleFactor: 1,
+        isMobile: false,
+        hasTouch: false,
+        defaultBrowserType: 'chromium'
+    },
+    'Laptop HD': {
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.7204.23 Safari/537.36',
+        viewport: { width: 1366, height: 768 },
+        screen: { width: 1366, height: 768 },
+        deviceScaleFactor: 1,
+        isMobile: false,
+        hasTouch: false,
+        defaultBrowserType: 'chromium'
+    }
 };
 /**
  * Register network event listeners
@@ -163,6 +160,7 @@ async function registerNetworkListeners(page) {
 }
 async function registerConsoleMessage(page) {
     page.on("console", (msg) => {
+        const consoleLogsTool = getToolInstance("get_console_logs", null);
         if (consoleLogsTool) {
             const type = msg.type();
             let text = msg.text();
@@ -186,6 +184,7 @@ async function registerConsoleMessage(page) {
     });
     // Uncaught exception
     page.on("pageerror", (error) => {
+        const consoleLogsTool = getToolInstance("get_console_logs", null);
         if (consoleLogsTool) {
             const message = error.message;
             const stack = error.stack || "";
@@ -300,7 +299,7 @@ export async function ensureBrowser(browserSettings) {
         }
         // Launch new browser if needed
         if (!browser) {
-            const { viewport, userAgent, headless = false, browserType = 'chromium', device } = browserSettings ?? {};
+            const { viewport, userAgent, headless = sessionConfig.headlessDefault, browserType = 'chromium', device } = browserSettings ?? {};
             // If browser type is changing, force a new browser instance
             if (browser && currentBrowserType !== browserType) {
                 try {
@@ -315,12 +314,13 @@ export async function ensureBrowser(browserSettings) {
             let deviceConfig = null;
             if (device && DEVICE_PRESETS[device]) {
                 const playwrightDeviceName = DEVICE_PRESETS[device];
-                deviceConfig = devices[playwrightDeviceName];
+                // Check custom configs first, then Playwright's built-in devices
+                deviceConfig = CUSTOM_DEVICE_CONFIGS[playwrightDeviceName] || devices[playwrightDeviceName];
                 if (deviceConfig) {
                     console.error(`Using device preset: ${device} (${playwrightDeviceName})`);
                 }
                 else {
-                    console.error(`Warning: Device preset ${playwrightDeviceName} not found in Playwright devices`);
+                    console.error(`Warning: Device preset ${playwrightDeviceName} not found`);
                 }
             }
             console.error(`Launching new ${browserType} browser instance...`);
@@ -451,12 +451,13 @@ export async function ensureBrowser(browserSettings) {
         }
         resetBrowserState();
         // Try one more time from scratch
-        const { viewport, userAgent, headless = false, browserType = 'chromium', device } = browserSettings ?? {};
+        const { viewport, userAgent, headless = sessionConfig.headlessDefault, browserType = 'chromium', device } = browserSettings ?? {};
         // Get device configuration if device preset is specified
         let deviceConfig = null;
         if (device && DEVICE_PRESETS[device]) {
             const playwrightDeviceName = DEVICE_PRESETS[device];
-            deviceConfig = devices[playwrightDeviceName];
+            // Check custom configs first, then Playwright's built-in devices
+            deviceConfig = CUSTOM_DEVICE_CONFIGS[playwrightDeviceName] || devices[playwrightDeviceName];
         }
         // Use the appropriate browser engine
         let browserInstance;
@@ -554,78 +555,10 @@ export async function ensureBrowser(browserSettings) {
         return page;
     }
 }
-/**
- * Initialize all tool instances
- */
-function initializeTools(server) {
-    // Browser tools
-    if (!screenshotTool)
-        screenshotTool = new ScreenshotTool(server);
-    if (!navigationTool)
-        navigationTool = new NavigationTool(server);
-    if (!closeBrowserTool)
-        closeBrowserTool = new CloseBrowserTool(server);
-    if (!consoleLogsTool)
-        consoleLogsTool = new ConsoleLogsTool(server);
-    if (!clickTool)
-        clickTool = new ClickTool(server);
-    if (!fillTool)
-        fillTool = new FillTool(server);
-    if (!selectTool)
-        selectTool = new SelectTool(server);
-    if (!hoverTool)
-        hoverTool = new HoverTool(server);
-    if (!uploadFileTool)
-        uploadFileTool = new UploadFileTool(server);
-    if (!evaluateTool)
-        evaluateTool = new EvaluateTool(server);
-    if (!visibleTextTool)
-        visibleTextTool = new VisibleTextTool(server);
-    if (!visibleHtmlTool)
-        visibleHtmlTool = new VisibleHtmlTool(server);
-    if (!goBackTool)
-        goBackTool = new GoBackTool(server);
-    if (!goForwardTool)
-        goForwardTool = new GoForwardTool(server);
-    if (!dragTool)
-        dragTool = new DragTool(server);
-    if (!pressKeyTool)
-        pressKeyTool = new PressKeyTool(server);
-    if (!elementVisibilityTool)
-        elementVisibilityTool = new ElementVisibilityTool(server);
-    if (!inspectDomTool)
-        inspectDomTool = new InspectDomTool(server);
-    if (!getTestIdsTool)
-        getTestIdsTool = new GetTestIdsTool(server);
-    if (!querySelectorAllTool)
-        querySelectorAllTool = new QuerySelectorAllTool(server);
-    if (!findByTextTool)
-        findByTextTool = new FindByTextTool(server);
-    if (!getComputedStylesTool)
-        getComputedStylesTool = new GetComputedStylesTool(server);
-    if (!measureElementTool)
-        measureElementTool = new MeasureElementTool(server);
-    if (!elementExistsTool)
-        elementExistsTool = new ElementExistsTool(server);
-    if (!compareElementAlignmentTool)
-        compareElementAlignmentTool = new CompareElementAlignmentTool(server);
-    if (!inspectAncestorsTool)
-        inspectAncestorsTool = new InspectAncestorsTool(server);
-    if (!waitForElementTool)
-        waitForElementTool = new WaitForElementTool(server);
-    if (!waitForNetworkIdleTool)
-        waitForNetworkIdleTool = new WaitForNetworkIdleTool(server);
-    if (!listNetworkRequestsTool)
-        listNetworkRequestsTool = new ListNetworkRequestsTool(server);
-    if (!getRequestDetailsTool)
-        getRequestDetailsTool = new GetRequestDetailsTool(server);
-}
 /**
  * Main handler for tool calls
  */
 export async function handleToolCall(name, args, server) {
-    // Initialize tools
-    initializeTools(server);
     try {
         // Special case for browser close to ensure it always works
         if (name === "close") {
@@ -657,8 +590,9 @@ export async function handleToolCall(name, args, server) {
                 isError: false,
             };
         }
+        const requiresBrowser = isBrowserTool(name);
         // Check if we have a disconnected browser that needs cleanup
-        if (browser && !browser.isConnected() && BROWSER_TOOLS.includes(name)) {
+        if (browser && !browser.isConnected() && requiresBrowser) {
             console.error("Detected disconnected browser before tool execution, cleaning up...");
             try {
                 await browser.close().catch(() => { }); // Ignore errors
@@ -673,7 +607,7 @@ export async function handleToolCall(name, args, server) {
             server
         };
         // Set up browser if needed
-        if (BROWSER_TOOLS.includes(name)) {
+        if (requiresBrowser) {
             const browserSettings = {
                 viewport: {
                     width: args.width,
@@ -699,83 +633,13 @@ export async function handleToolCall(name, args, server) {
                 };
             }
         }
-        // Route to appropriate tool
-        switch (name) {
-            // Browser tools
-            case "navigate":
-                return await navigationTool.execute(args, context);
-            case "screenshot":
-                return await screenshotTool.execute(args, context);
-            case "close":
-                return await closeBrowserTool.execute(args, context);
-            case "get_console_logs":
-                return await consoleLogsTool.execute(args, context);
-            case "click":
-                return await clickTool.execute(args, context);
-            case "fill":
-                return await fillTool.execute(args, context);
-            case "select":
-                return await selectTool.execute(args, context);
-            case "hover":
-                return await hoverTool.execute(args, context);
-            case "upload_file":
-                return await uploadFileTool.execute(args, context);
-            case "evaluate":
-                return await evaluateTool.execute(args, context);
-            case "get_text":
-                return await visibleTextTool.execute(args, context);
-            case "get_html":
-                return await visibleHtmlTool.execute(args, context);
-            case "go_back":
-                return await goBackTool.execute(args, context);
-            case "go_forward":
-                return await goForwardTool.execute(args, context);
-            case "drag":
-                return await dragTool.execute(args, context);
-            case "press_key":
-                return await pressKeyTool.execute(args, context);
-            case "check_visibility":
-                return await elementVisibilityTool.execute(args, context);
-            case "inspect_dom":
-                return await inspectDomTool.execute(args, context);
-            case "get_test_ids":
-                return await getTestIdsTool.execute(args, context);
-            case "query_selector":
-                return await querySelectorAllTool.execute(args, context);
-            case "find_by_text":
-                return await findByTextTool.execute(args, context);
-            case "get_computed_styles":
-                return await getComputedStylesTool.execute(args, context);
-            case "measure_element":
-                return await measureElementTool.execute(args, context);
-            case "element_exists":
-                return await elementExistsTool.execute(args, context);
-            case "compare_element_alignment":
-                return await compareElementAlignmentTool.execute(args, context);
-            case "inspect_ancestors":
-                return await inspectAncestorsTool.execute(args, context);
-            case "wait_for_element":
-                return await waitForElementTool.execute(args, context);
-            case "wait_for_network_idle":
-                return await waitForNetworkIdleTool.execute(args, context);
-            case "list_network_requests":
-                return await listNetworkRequestsTool.execute(args, context);
-            case "get_request_details":
-                return await getRequestDetailsTool.execute(args, context);
-            default:
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Unknown tool: ${name}`,
-                        }],
-                    isError: true,
-                };
-        }
+        // Route to appropriate tool using registry
+        return await executeTool(name, args, context, server);
     }
     catch (error) {
         console.error(`Error handling tool ${name}:`, error);
         // Handle browser-specific errors at the top level
-        if (BROWSER_TOOLS.includes(name)) {
+        if (isBrowserTool(name)) {
             const errorMessage = error.message;
             if (errorMessage.includes("Target page, context or browser has been closed") ||
                 errorMessage.includes("Browser has been disconnected") ||
@@ -806,30 +670,35 @@ export async function handleToolCall(name, args, server) {
  * Get console logs
  */
 export function getConsoleLogs() {
+    const consoleLogsTool = getToolInstance("get_console_logs", null);
     return consoleLogsTool?.getConsoleLogs() ?? [];
 }
 /**
  * Get screenshots
  */
 export function getScreenshots() {
+    const screenshotTool = getToolInstance("screenshot", null);
     return screenshotTool?.getScreenshots() ?? new Map();
 }
 /**
  * Update last interaction timestamp
  */
 export function updateLastInteractionTimestamp() {
+    const consoleLogsTool = getToolInstance("get_console_logs", null);
     consoleLogsTool?.updateLastInteractionTimestamp();
 }
 /**
  * Update last navigation timestamp
  */
 export function updateLastNavigationTimestamp() {
+    const consoleLogsTool = getToolInstance("get_console_logs", null);
     consoleLogsTool?.updateLastNavigationTimestamp();
 }
 /**
  * Clear console logs
  */
 export function clearConsoleLogs() {
+    const consoleLogsTool = getToolInstance("get_console_logs", null);
     consoleLogsTool?.clearConsoleLogs();
 }
 export { registerConsoleMessage };

package/dist/tools/browser/ancestorInspection.d.ts

@@ -12,5 +12,7 @@ export declare class InspectAncestorsTool extends BrowserToolBase {
     private formatAncestorChain;
     private formatBorder;
     private formatOverflow;
+    private formatLayoutContext;
+    private formatMarginDetails;
     private generateDiagnostics;
 }