browser-devtools-mcp 0.0.2 → 0.1.0

package/dist/tools/interaction/resize-window.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResizeWindow = void 0;
+const zod_1 = require("zod");
+const MIN_WINDOW_WIDTH = 200;
+const MIN_WINDOW_HEIGHT = 200;
+class ResizeWindow {
+    name() {
+        return 'interaction_resize-window';
+    }
+    description() {
+        return `
+Resizes the REAL BROWSER WINDOW (OS-level window) for the current page using Chrome DevTools Protocol (CDP).
+
+This tool works best on Chromium-based browsers (Chromium/Chrome/Edge).
+It is especially useful in headful sessions when you run with viewport emulation disabled (viewport: null),
+so the page layout follows the OS window size.
+
+Important:
+- If Playwright viewport emulation is enabled (viewport is NOT null), resizing the OS window may not change page layout.
+- On non-Chromium browsers (Firefox/WebKit), CDP is not available and this tool will fail.
+        `.trim();
+    }
+    inputSchema() {
+        return {
+            width: zod_1.z
+                .number()
+                .int()
+                .min(MIN_WINDOW_WIDTH)
+                .optional()
+                .describe('Target window width in pixels (required when state="normal").'),
+            height: zod_1.z
+                .number()
+                .int()
+                .min(MIN_WINDOW_HEIGHT)
+                .optional()
+                .describe('Target window height in pixels (required when state="normal").'),
+            state: zod_1.z
+                .enum(['normal', 'maximized', 'minimized', 'fullscreen'])
+                .optional()
+                .default('normal')
+                .describe('Target window state. If not "normal", width/height may be ignored by the browser.'),
+        };
+    }
+    outputSchema() {
+        return {
+            requested: zod_1.z
+                .object({
+                width: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Requested window width (pixels). Null if not provided.'),
+                height: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Requested window height (pixels). Null if not provided.'),
+                state: zod_1.z
+                    .enum([
+                    'normal',
+                    'maximized',
+                    'minimized',
+                    'fullscreen',
+                ])
+                    .describe('Requested window state.'),
+            })
+                .describe('Requested window change parameters.'),
+            before: zod_1.z
+                .object({
+                windowId: zod_1.z
+                    .number()
+                    .int()
+                    .describe('CDP window id for the current target.'),
+                state: zod_1.z
+                    .string()
+                    .nullable()
+                    .describe('Window state before resizing.'),
+                left: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window left position before resizing.'),
+                top: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window top position before resizing.'),
+                width: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window width before resizing.'),
+                height: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window height before resizing.'),
+            })
+                .describe('Window bounds before resizing.'),
+            after: zod_1.z
+                .object({
+                windowId: zod_1.z
+                    .number()
+                    .int()
+                    .describe('CDP window id for the current target.'),
+                state: zod_1.z
+                    .string()
+                    .nullable()
+                    .describe('Window state after resizing.'),
+                left: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window left position after resizing.'),
+                top: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window top position after resizing.'),
+                width: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window width after resizing.'),
+                height: zod_1.z
+                    .number()
+                    .int()
+                    .nullable()
+                    .describe('Window height after resizing.'),
+            })
+                .describe('Window bounds after resizing.'),
+            viewport: zod_1.z
+                .object({
+                innerWidth: zod_1.z
+                    .number()
+                    .int()
+                    .describe('window.innerWidth after resizing (CSS pixels).'),
+                innerHeight: zod_1.z
+                    .number()
+                    .int()
+                    .describe('window.innerHeight after resizing (CSS pixels).'),
+                outerWidth: zod_1.z
+                    .number()
+                    .int()
+                    .describe('window.outerWidth after resizing (CSS pixels).'),
+                outerHeight: zod_1.z
+                    .number()
+                    .int()
+                    .describe('window.outerHeight after resizing (CSS pixels).'),
+                devicePixelRatio: zod_1.z
+                    .number()
+                    .describe('window.devicePixelRatio after resizing.'),
+            })
+                .describe('Page viewport metrics after resizing (helps verify responsive behavior).'),
+        };
+    }
+    async handle(context, args) {
+        const state = args.state ?? 'normal';
+        const width = args.width;
+        const height = args.height;
+        if (state === 'normal') {
+            if (typeof width !== 'number' || typeof height !== 'number') {
+                throw new Error('state="normal" requires both width and height.');
+            }
+        }
+        const page = context.page;
+        const cdp = await page.context().newCDPSession(page);
+        try {
+            const info = await cdp.send('Browser.getWindowForTarget', {});
+            const windowId = Number(info.windowId);
+            const beforeBounds = info.bounds ?? {};
+            const before = {
+                windowId: windowId,
+                state: typeof beforeBounds.windowState === 'string'
+                    ? beforeBounds.windowState
+                    : null,
+                left: typeof beforeBounds.left === 'number'
+                    ? beforeBounds.left
+                    : null,
+                top: typeof beforeBounds.top === 'number'
+                    ? beforeBounds.top
+                    : null,
+                width: typeof beforeBounds.width === 'number'
+                    ? beforeBounds.width
+                    : null,
+                height: typeof beforeBounds.height === 'number'
+                    ? beforeBounds.height
+                    : null,
+            };
+            const boundsToSet = {};
+            if (state !== 'normal') {
+                boundsToSet.windowState = state;
+            }
+            else {
+                boundsToSet.windowState = 'normal';
+                boundsToSet.width = width;
+                boundsToSet.height = height;
+            }
+            await cdp.send('Browser.setWindowBounds', {
+                windowId: windowId,
+                bounds: boundsToSet,
+            });
+            const afterInfo = await cdp.send('Browser.getWindowForTarget', {});
+            const afterBounds = afterInfo.bounds ?? {};
+            const after = {
+                windowId: windowId,
+                state: typeof afterBounds.windowState === 'string'
+                    ? afterBounds.windowState
+                    : null,
+                left: typeof afterBounds.left === 'number'
+                    ? afterBounds.left
+                    : null,
+                top: typeof afterBounds.top === 'number'
+                    ? afterBounds.top
+                    : null,
+                width: typeof afterBounds.width === 'number'
+                    ? afterBounds.width
+                    : null,
+                height: typeof afterBounds.height === 'number'
+                    ? afterBounds.height
+                    : null,
+            };
+            const metrics = await page.evaluate(() => {
+                return {
+                    innerWidth: window.innerWidth,
+                    innerHeight: window.innerHeight,
+                    outerWidth: window.outerWidth,
+                    outerHeight: window.outerHeight,
+                    devicePixelRatio: window.devicePixelRatio,
+                };
+            });
+            const viewport = {
+                innerWidth: Number(metrics.innerWidth),
+                innerHeight: Number(metrics.innerHeight),
+                outerWidth: Number(metrics.outerWidth),
+                outerHeight: Number(metrics.outerHeight),
+                devicePixelRatio: Number(metrics.devicePixelRatio),
+            };
+            return {
+                requested: {
+                    width: typeof width === 'number' ? width : null,
+                    height: typeof height === 'number' ? height : null,
+                    state: state,
+                },
+                before,
+                after,
+                viewport,
+            };
+        }
+        catch (e) {
+            const msg = String(e?.message ?? e);
+            throw new Error(`Failed to resize real browser window via CDP. This tool works best on Chromium-based browsers. Original error: ${msg}`);
+        }
+        finally {
+            await cdp.detach().catch(() => { });
+        }
+    }
+}
+exports.ResizeWindow = ResizeWindow;
+//# sourceMappingURL=resize-window.js.map

package/dist/tools/interaction/resize-window.js.map

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

package/dist/tools/interaction/scroll.js

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scroll = void 0;
+const zod_1 = require("zod");
+const DEFAULT_BEHAVIOR = 'auto';
+const DEFAULT_MODE = 'by';
+class Scroll {
+    name() {
+        return 'interaction_scroll';
+    }
+    description() {
+        return `
+Scrolls the page viewport or a specific scrollable element.
+
+Modes:
+- 'by': Scrolls by a relative delta (dx/dy) from the current scroll position.
+- 'to': Scrolls to an absolute scroll position (x/y).
+- 'top': Scrolls to the very top.
+- 'bottom': Scrolls to the very bottom.
+- 'left': Scrolls to the far left.
+- 'right': Scrolls to the far right.
+
+Use this tool to:
+- Reveal content below the fold
+- Jump to the top/bottom without knowing exact positions
+- Bring elements into view before clicking
+- Inspect lazy-loaded content that appears on scroll
+        `.trim();
+    }
+    inputSchema() {
+        return {
+            mode: zod_1.z
+                .enum(['by', 'to', 'top', 'bottom', 'left', 'right'])
+                .optional()
+                .default(DEFAULT_MODE)
+                .describe('Scroll mode. "by" uses dx/dy, "to" uses x/y, and top/bottom/left/right jump to edges.'),
+            selector: zod_1.z
+                .string()
+                .optional()
+                .describe('Optional CSS selector for a scrollable container. If omitted, scrolls the document viewport.'),
+            dx: zod_1.z
+                .number()
+                .optional()
+                .describe('Horizontal scroll delta in pixels (used when mode="by"). Default: 0.'),
+            dy: zod_1.z
+                .number()
+                .optional()
+                .describe('Vertical scroll delta in pixels (used when mode="by"). Default: 0.'),
+            x: zod_1.z
+                .number()
+                .optional()
+                .describe('Absolute horizontal scroll position in pixels (used when mode="to").'),
+            y: zod_1.z
+                .number()
+                .optional()
+                .describe('Absolute vertical scroll position in pixels (used when mode="to").'),
+            behavior: zod_1.z
+                .enum(['auto', 'smooth'])
+                .optional()
+                .default(DEFAULT_BEHAVIOR)
+                .describe('Native scroll behavior. Use "auto" for deterministic automation.'),
+        };
+    }
+    outputSchema() {
+        return {
+            mode: zod_1.z
+                .enum(['by', 'to', 'top', 'bottom', 'left', 'right'])
+                .describe('The scroll mode used.'),
+            selector: zod_1.z
+                .string()
+                .nullable()
+                .describe('The selector of the scroll container if provided; otherwise null (document viewport).'),
+            behavior: zod_1.z
+                .enum(['auto', 'smooth'])
+                .describe('The scroll behavior used.'),
+            before: zod_1.z
+                .object({
+                x: zod_1.z.number().describe('ScrollLeft before scrolling.'),
+                y: zod_1.z.number().describe('ScrollTop before scrolling.'),
+                scrollWidth: zod_1.z
+                    .number()
+                    .describe('Total scrollable width before scrolling.'),
+                scrollHeight: zod_1.z
+                    .number()
+                    .describe('Total scrollable height before scrolling.'),
+                clientWidth: zod_1.z
+                    .number()
+                    .describe('Viewport/container client width before scrolling.'),
+                clientHeight: zod_1.z
+                    .number()
+                    .describe('Viewport/container client height before scrolling.'),
+            })
+                .describe('Scroll metrics before the scroll action.'),
+            after: zod_1.z
+                .object({
+                x: zod_1.z.number().describe('ScrollLeft after scrolling.'),
+                y: zod_1.z.number().describe('ScrollTop after scrolling.'),
+                scrollWidth: zod_1.z
+                    .number()
+                    .describe('Total scrollable width after scrolling.'),
+                scrollHeight: zod_1.z
+                    .number()
+                    .describe('Total scrollable height after scrolling.'),
+                clientWidth: zod_1.z
+                    .number()
+                    .describe('Viewport/container client width after scrolling.'),
+                clientHeight: zod_1.z
+                    .number()
+                    .describe('Viewport/container client height after scrolling.'),
+            })
+                .describe('Scroll metrics after the scroll action.'),
+            canScrollX: zod_1.z
+                .boolean()
+                .describe('Whether horizontal scrolling is possible (scrollWidth > clientWidth).'),
+            canScrollY: zod_1.z
+                .boolean()
+                .describe('Whether vertical scrolling is possible (scrollHeight > clientHeight).'),
+            maxScrollX: zod_1.z
+                .number()
+                .describe('Maximum horizontal scrollLeft (scrollWidth - clientWidth).'),
+            maxScrollY: zod_1.z
+                .number()
+                .describe('Maximum vertical scrollTop (scrollHeight - clientHeight).'),
+            isAtLeft: zod_1.z
+                .boolean()
+                .describe('Whether the scroll position is at the far left.'),
+            isAtRight: zod_1.z
+                .boolean()
+                .describe('Whether the scroll position is at the far right.'),
+            isAtTop: zod_1.z
+                .boolean()
+                .describe('Whether the scroll position is at the very top.'),
+            isAtBottom: zod_1.z
+                .boolean()
+                .describe('Whether the scroll position is at the very bottom.'),
+        };
+    }
+    async handle(context, args) {
+        const mode = args.mode ?? DEFAULT_MODE;
+        const selector = args.selector;
+        const behavior = args.behavior ?? DEFAULT_BEHAVIOR;
+        const dx = args.dx ?? 0;
+        const dy = args.dy ?? 0;
+        const x = args.x;
+        const y = args.y;
+        if (mode === 'to') {
+            if (typeof x !== 'number' && typeof y !== 'number') {
+                throw new Error('mode="to" requires at least one of x or y.');
+            }
+        }
+        if (mode === 'by') {
+            if (dx === 0 && dy === 0) {
+                throw new Error('mode="by" requires dx and/or dy to be non-zero.');
+            }
+        }
+        const result = await context.page.evaluate(({ modeEval, selectorEval, dxEval, dyEval, xEval, yEval, behaviorEval, }) => {
+            const getTarget = () => {
+                if (selectorEval) {
+                    const el = document.querySelector(selectorEval);
+                    if (!el) {
+                        throw new Error(`Element with selector "${selectorEval}" not found`);
+                    }
+                    return el;
+                }
+                const scrolling = document.scrollingElement ||
+                    document.documentElement ||
+                    document.body;
+                if (!scrolling) {
+                    throw new Error('No scrolling element available.');
+                }
+                return scrolling;
+            };
+            const readMetrics = (el) => {
+                return {
+                    x: el.scrollLeft,
+                    y: el.scrollTop,
+                    scrollWidth: el.scrollWidth,
+                    scrollHeight: el.scrollHeight,
+                    clientWidth: el.clientWidth,
+                    clientHeight: el.clientHeight,
+                };
+            };
+            const clamp = (v, min, max) => {
+                if (v < min) {
+                    return min;
+                }
+                if (v > max) {
+                    return max;
+                }
+                return v;
+            };
+            const doScroll = (el) => {
+                const maxX = Math.max(0, el.scrollWidth - el.clientWidth);
+                const maxY = Math.max(0, el.scrollHeight - el.clientHeight);
+                if (modeEval === 'by') {
+                    const nextX = clamp(el.scrollLeft + dxEval, 0, maxX);
+                    const nextY = clamp(el.scrollTop + dyEval, 0, maxY);
+                    el.scrollTo({
+                        left: nextX,
+                        top: nextY,
+                        behavior: behaviorEval,
+                    });
+                    return;
+                }
+                if (modeEval === 'to') {
+                    const nextX = typeof xEval === 'number'
+                        ? clamp(xEval, 0, maxX)
+                        : el.scrollLeft;
+                    const nextY = typeof yEval === 'number'
+                        ? clamp(yEval, 0, maxY)
+                        : el.scrollTop;
+                    el.scrollTo({
+                        left: nextX,
+                        top: nextY,
+                        behavior: behaviorEval,
+                    });
+                    return;
+                }
+                if (modeEval === 'top') {
+                    el.scrollTo({
+                        top: 0,
+                        left: el.scrollLeft,
+                        behavior: behaviorEval,
+                    });
+                    return;
+                }
+                if (modeEval === 'bottom') {
+                    el.scrollTo({
+                        top: maxY,
+                        left: el.scrollLeft,
+                        behavior: behaviorEval,
+                    });
+                    return;
+                }
+                if (modeEval === 'left') {
+                    el.scrollTo({
+                        left: 0,
+                        top: el.scrollTop,
+                        behavior: behaviorEval,
+                    });
+                    return;
+                }
+                if (modeEval === 'right') {
+                    el.scrollTo({
+                        left: maxX,
+                        top: el.scrollTop,
+                        behavior: behaviorEval,
+                    });
+                    return;
+                }
+            };
+            const target = getTarget();
+            const before = readMetrics(target);
+            doScroll(target);
+            const after = readMetrics(target);
+            const maxScrollX = Math.max(0, after.scrollWidth - after.clientWidth);
+            const maxScrollY = Math.max(0, after.scrollHeight - after.clientHeight);
+            const canScrollX = after.scrollWidth > after.clientWidth;
+            const canScrollY = after.scrollHeight > after.clientHeight;
+            const eps = 1;
+            const isAtLeft = after.x <= eps;
+            const isAtRight = after.x >= maxScrollX - eps;
+            const isAtTop = after.y <= eps;
+            const isAtBottom = after.y >= maxScrollY - eps;
+            return {
+                before,
+                after,
+                canScrollX,
+                canScrollY,
+                maxScrollX,
+                maxScrollY,
+                isAtLeft,
+                isAtRight,
+                isAtTop,
+                isAtBottom,
+            };
+        }, {
+            modeEval: mode,
+            selectorEval: selector,
+            dxEval: dx,
+            dyEval: dy,
+            xEval: x,
+            yEval: y,
+            behaviorEval: behavior,
+        });
+        return {
+            mode: mode,
+            selector: selector ?? null,
+            behavior: behavior,
+            before: result.before,
+            after: result.after,
+            canScrollX: result.canScrollX,
+            canScrollY: result.canScrollY,
+            maxScrollX: result.maxScrollX,
+            maxScrollY: result.maxScrollY,
+            isAtLeft: result.isAtLeft,
+            isAtRight: result.isAtRight,
+            isAtTop: result.isAtTop,
+            isAtBottom: result.isAtBottom,
+        };
+    }
+}
+exports.Scroll = Scroll;
+//# sourceMappingURL=scroll.js.map

package/dist/tools/interaction/scroll.js.map

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

package/dist/tools/{monitoring → o11y}/get-console-messages.js

@@ -6,7 +6,7 @@ const utils_1 = require("../../utils");
 const zod_1 = require("zod");
 class GetConsoleMessages {
     name() {
-        return 'monitoring_get-console-messages';
+        return 'o11y_get-console-messages';
     }
     description() {
         return 'Retrieves console messages/logs from the browser with filtering options.';

package/dist/tools/o11y/get-console-messages.js.map

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

package/dist/tools/{monitoring → o11y}/get-http-requests.js

@@ -6,7 +6,7 @@ const zod_1 = require("zod");
 const utils_1 = require("../../utils");
 class GetHttpRequests {
     name() {
-        return 'monitoring_get-http-requests';
+        return 'o11y_get-http-requests';
     }
     description() {
         return 'Retrieves HTTP requests from the browser with filtering options.';

package/dist/tools/o11y/get-http-requests.js.map

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

package/dist/tools/o11y/get-trace-id.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetTraceId = void 0;
+const zod_1 = require("zod");
+class GetTraceId {
+    name() {
+        return 'o11y_get-trace-id';
+    }
+    description() {
+        return 'Gets the OpenTelemetry compatible trace id of the current session.';
+    }
+    inputSchema() {
+        return {};
+    }
+    outputSchema() {
+        return {
+            traceId: zod_1.z
+                .string()
+                .describe('The OpenTelemetry compatible trace id of the current session if available.')
+                .optional(),
+        };
+    }
+    async handle(context, args) {
+        return {
+            traceId: await context.getTraceId(),
+        };
+    }
+}
+exports.GetTraceId = GetTraceId;
+//# sourceMappingURL=get-trace-id.js.map