chrome-devtools-mcp 0.11.0 → 0.12.1

package/build/src/third_party/issue-descriptions/permissionElementActivationDisabled.md

@@ -0,0 +1,7 @@
+# Activation disabled
+
+The "{PLACEHOLDER_Type}" element could not be activated for the following reason: {PLACEHOLDER_DisableReason}.
+
+To resolve this issue, ensure that the element follows all styling restrictions and is fully visible to the user.
+
+You can use the command line flag `--runtime-enabled-features=BypassPepcSecurityForTesting` to bypass this behavior for testing purposes.

package/build/src/third_party/issue-descriptions/permissionElementActivationDisabledWithOccluder.md

@@ -0,0 +1,9 @@
+# Activation disabled
+
+The "{PLACEHOLDER_Type}" element could not be activated for the following reason: {PLACEHOLDER_DisableReason}.
+
+The element is occluded by: "{PLACEHOLDER_OccluderInfo}"
+
+To resolve this issue, ensure that the element follows all styling restrictions and is fully visible to the user.
+
+You can use the command line flag `--runtime-enabled-features=BypassPepcSecurityForTesting` to bypass this behavior for testing purposes.

package/build/src/third_party/issue-descriptions/permissionElementActivationDisabledWithOccluderParent.md

@@ -0,0 +1,9 @@
+# Activation disabled
+
+The "{PLACEHOLDER_Type}" element could not be activated for the following reason: {PLACEHOLDER_DisableReason}.
+
+The element is occluded by: "{PLACEHOLDER_OccluderInfo}" (parent element: "{PLACEHOLDER_OccluderParentInfo}")
+
+To resolve this issue, ensure that the element follows all styling restrictions and is fully visible to the user.
+
+You can use the command line flag `--runtime-enabled-features=BypassPepcSecurityForTesting` to bypass this behavior for testing purposes.

package/build/src/third_party/issue-descriptions/permissionElementCspFrameAncestorsMissing.md

@@ -0,0 +1,5 @@
+# CSP `frame-ancestors` missing
+
+The "{PLACEHOLDER_Type}" element is used in a cross-origin iframe, but the required `frame-ancestors` Content Security Policy directive is missing.
+
+To resolve this issue, add a `frame-ancestors` Content Security Policy directive to the iframe.

package/build/src/third_party/issue-descriptions/permissionElementFencedFrameDisallowed.md

@@ -0,0 +1,5 @@
+# Fenced frame disallowed
+
+The "{PLACEHOLDER_Type}" element is not allowed in a fenced frame.
+
+To resolve this issue, ensure the element is not used in a fenced frame.

package/build/src/third_party/issue-descriptions/permissionElementFontSizeTooLarge.md

@@ -0,0 +1,5 @@
+# Font size too large
+
+The "{PLACEHOLDER_Type}" element's font size is too large.
+
+To resolve this issue, ensure that the element's font is at most 'xx-large'.

package/build/src/third_party/issue-descriptions/permissionElementFontSizeTooSmall.md

@@ -0,0 +1,5 @@
+# Font size too small
+
+The "{PLACEHOLDER_Type}" element's font size is too small.
+
+To resolve this issue, ensure that the element's font is at least 'small'.

package/build/src/third_party/issue-descriptions/permissionElementGeolocationDeprecated.md

@@ -0,0 +1,5 @@
+# Geolocation deprecated
+
+Using `<permission type="geolocation">` is deprecated.
+
+To resolve this issue, use the `<geolocation>` element instead.

package/build/src/third_party/issue-descriptions/permissionElementInsetBoxShadowUnsupported.md

@@ -0,0 +1,5 @@
+# Unsupported inset box shadow
+
+The "{PLACEHOLDER_Type}" element does not support `inset` box shadows.
+
+To resolve this issue, remove the `inset` keyword from the relevant stylesheet.

package/build/src/third_party/issue-descriptions/permissionElementInvalidDisplayStyle.md

@@ -0,0 +1,5 @@
+# Invalid display style
+
+The "{PLACEHOLDER_Type}" element has an invalid display style. Values that result in an unsupported layout are not allowed.
+
+To resolve this issue, consider using 'inline-block', 'block', or 'flex' instead.

package/build/src/third_party/issue-descriptions/permissionElementInvalidSizeValue.md

@@ -0,0 +1,5 @@
+# Invalid size value
+
+Content, intrinsic, or stretch sizes are not supported as values for the min/max width and height of the "{PLACEHOLDER_Type}" element.
+
+To resolve this issue, use absolute or relative lengths for the element's width and height.

package/build/src/third_party/issue-descriptions/permissionElementInvalidType.md

@@ -0,0 +1,5 @@
+# Invalid type attribute
+
+The "{PLACEHOLDER_Type}" type is not supported.
+
+To resolve this issue, ensure the element's type is one of the supported values: "camera", "microphone", "geolocation", "camera microphone".

package/build/src/third_party/issue-descriptions/permissionElementInvalidTypeActivation.md

@@ -0,0 +1,5 @@
+# Invalid type activation
+
+An element with the "{PLACEHOLDER_Type}" type was attempted to be activated. However this type is not supported.
+
+To resolve this issue, ensure the element's type is one of the supported values: "camera", "microphone", "geolocation", "camera microphone".

package/build/src/third_party/issue-descriptions/permissionElementLowContrast.md

@@ -0,0 +1,5 @@
+# Low contrast
+
+The contrast between the text color and background color of the "{PLACEHOLDER_Type}" element is too low.
+
+To resolve this issue, ensure that your text/background colors have more contrast between them.

package/build/src/third_party/issue-descriptions/permissionElementNonOpaqueColor.md

@@ -0,0 +1,5 @@
+# Non-opaque color
+
+The text color or background color of the "{PLACEHOLDER_Type}" element is non-opaque.
+
+To resolve this issue, ensure the element's text and background colors have their alpha channel value at 100%.

package/build/src/third_party/issue-descriptions/permissionElementPaddingBottomUnsupported.md

@@ -0,0 +1,6 @@
+# Unsupported bottom padding
+
+The "{PLACEHOLDER_Type}" element does not support `padding-bottom`.
+`padding-bottom` is always set to be identical to `padding-top`.
+
+To resolve this issue, ensure the element's `padding-bottom` is unset or identical to `padding-top`.

package/build/src/third_party/issue-descriptions/permissionElementPaddingRightUnsupported.md

@@ -0,0 +1,6 @@
+# Unsupported right padding
+
+The "{PLACEHOLDER_Type}" element does not support `padding-right`.
+`padding-right` is always set to be identical to `padding-left`.
+
+To resolve this issue, ensure the element's `padding-right` is unset or identical to `padding-left`.

package/build/src/third_party/issue-descriptions/permissionElementPermissionsPolicyBlocked.md

@@ -0,0 +1,5 @@
+# Permissions policy blocked
+
+The "{PLACEHOLDER_Type}" element is blocked by the "{PLACEHOLDER_PermissionName}" permission policy.
+
+To resolve this issue, ensure the frame which contains the element is loaded with the appropriate permission policy by its embedder.

package/build/src/third_party/issue-descriptions/permissionElementRegistrationFailed.md

@@ -0,0 +1,5 @@
+# Quota exceeded
+
+The "{PLACEHOLDER_Type}" element has surpassed the maximum instances quota per page.
+
+To resolve this issue, ensure that you have no more than 3 elements of the same type per page.

package/build/src/third_party/issue-descriptions/permissionElementRequestInProgress.md

@@ -0,0 +1,5 @@
+# Request in progress
+
+A permission request on the "{PLACEHOLDER_Type}" element was prevented because a previous request is still in progress.
+
+To resolve this issue, ensure that the site does not allow users to interact with the element behind the current content scrim (for example by moving the element to a document in a new window, which is not covered by the scrim).

package/build/src/third_party/issue-descriptions/permissionElementSecurityChecksFailed.md

@@ -0,0 +1,5 @@
+# Activation disabled (quota)
+
+The "{PLACEHOLDER_Type}" element could not be activated because the page's quota has been exceeded.
+
+To resolve this issue, ensure that you have no more than 3 elements of the same type per page.

package/build/src/third_party/issue-descriptions/permissionElementTypeNotSupported.md

@@ -0,0 +1,5 @@
+# Permission not supported
+
+The permission type "{PLACEHOLDER_Type}" is not supported by this browser and therefore the element will not be functional.
+
+To resolve this issue, ensure the element's type is one of the supported values: "camera", "microphone", "geolocation", "camera microphone".

package/build/src/third_party/issue-descriptions/permissionElementUntrustedEvent.md

@@ -0,0 +1,7 @@
+# Untrusted event
+
+The "{PLACEHOLDER_Type}" element can only be activated by actual user clicks, not simulated ones.
+
+To resolve this issue, do not use frameworks which simulate click events, (e.g. via `click()`) and do not prevent the `DOMActivate` event.
+
+You can use the command line flag `--runtime-enabled-features=BypassPepcSecurityForTesting` to bypass this behavior for testing purposes.

package/build/src/tools/pages.js

@@ -29,13 +29,19 @@ export const selectPage = defineTool({
     schema: {
         pageIdx: zod
             .number()
-            .describe('The index of the page to select. Call list_pages to list pages.'),
+            .describe(`The index of the page to select. Call ${listPages.name} to get available pages.`),
+        bringToFront: zod
+            .boolean()
+            .optional()
+            .describe('Whether to focus the page and bring it to the top.'),
     },
     handler: async (request, response, context) => {
         const page = context.getPageByIdx(request.params.pageIdx);
-        await page.bringToFront();
         context.selectPage(page);
         response.setIncludePages(true);
+        if (request.params.bringToFront) {
+            await page.bringToFront();
+        }
     },
 });
 export const closePage = defineTool({

package/build/src/trace-processing/parse.js

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { AgentFocus, TraceEngine, PerformanceTraceFormatter, PerformanceInsightFormatter, } from '../../node_modules/chrome-devtools-frontend/mcp/mcp.js';
 import { logger } from '../logger.js';
-const engine = TraceEngine.TraceModel.Model.createWithAllHandlers();
+import { DevTools } from '../third_party/index.js';
+const engine = DevTools.TraceEngine.TraceModel.Model.createWithAllHandlers();
 export function traceResultIsSuccess(x) {
     return 'parsedTrace' in x;
 }
@@ -48,12 +48,12 @@ export async function parseRawTraceBuffer(buffer) {
 }
 const extraFormatDescriptions = `Information on performance traces may contain main thread activity represented as call frames and network requests.
 
-${PerformanceTraceFormatter.callFrameDataFormatDescription}
+${DevTools.PerformanceTraceFormatter.callFrameDataFormatDescription}
 
-${PerformanceTraceFormatter.networkDataFormatDescription}`;
+${DevTools.PerformanceTraceFormatter.networkDataFormatDescription}`;
 export function getTraceSummary(result) {
-    const focus = AgentFocus.fromParsedTrace(result.parsedTrace);
-    const formatter = new PerformanceTraceFormatter(focus);
+    const focus = DevTools.AgentFocus.fromParsedTrace(result.parsedTrace);
+    const formatter = new DevTools.PerformanceTraceFormatter(focus);
     const summaryText = formatter.formatTraceSummary();
     return `## Summary of Performance trace findings:
 ${summaryText}
@@ -79,6 +79,6 @@ export function getInsightOutput(result, insightSetId, insightName) {
             error: `No Insight with the name ${insightName} found. Double check the name you provided is accurate and try again.`,
         };
     }
-    const formatter = new PerformanceInsightFormatter(AgentFocus.fromParsedTrace(result.parsedTrace), matchingInsight);
+    const formatter = new DevTools.PerformanceInsightFormatter(DevTools.AgentFocus.fromParsedTrace(result.parsedTrace), matchingInsight);
     return { output: formatter.formatInsight() };
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",
   "main": "index.js",
   "scripts": {
     "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
-    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs",
+    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs && node -e \"require('fs').rmSync('build/node_modules', {recursive: true, force: true})\"",
     "build": "tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
     "typecheck": "tsc --noEmit",
     "format": "eslint --cache --fix . && prettier --write --cache .",
@@ -16,11 +16,12 @@
     "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
     "start": "npm run build && node build/src/index.js",
     "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/index.js",
-    "test:node20": "node --require ./build/tests/setup.js --test-reporter spec --test-force-exit --test build/tests",
-    "test": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test \"build/tests/**/*.test.js\"",
-    "test:only": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
-    "test:only:no-build": "node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
-    "test:update-snapshots": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-force-exit --test --test-update-snapshots \"build/tests/**/*.test.js\"",
+    "test:node20": "node --import ./build/tests/setup.js --test-reporter spec --test-force-exit --test build/tests",
+    "test:no-build": "node --import ./build/tests/setup.js --no-warnings=ExperimentalWarning --experimental-print-required-tla --test-reporter spec --test-force-exit --test \"build/tests/**/*.test.js\"",
+    "test": "npm run build && npm run test:no-build",
+    "test:only": "npm run build && npm run test:only:no-build",
+    "test:only:no-build": "node --import ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
+    "test:update-snapshots": "npm run build && node --import ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-force-exit --test --test-update-snapshots \"build/tests/**/*.test.js\"",
     "prepare": "node --experimental-strip-types scripts/prepare.ts",
     "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts"
   },
@@ -40,19 +41,19 @@
   "mcpName": "io.github.ChromeDevTools/chrome-devtools-mcp",
   "devDependencies": {
     "@eslint/js": "^9.35.0",
-    "@modelcontextprotocol/sdk": "1.24.1",
+    "@modelcontextprotocol/sdk": "1.24.3",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@stylistic/eslint-plugin": "^5.4.0",
     "@types/debug": "^4.1.12",
     "@types/filesystem": "^0.0.36",
-    "@types/node": "^24.3.3",
+    "@types/node": "^25.0.0",
     "@types/sinon": "^21.0.0",
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1550444",
+    "chrome-devtools-frontend": "1.0.1555430",
     "core-js": "3.47.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -60,7 +61,7 @@
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.4.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.32.0",
+    "puppeteer": "24.33.0",
     "rollup": "4.53.3",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",

package/build/node_modules/chrome-devtools-frontend/LICENSE

@@ -1,27 +0,0 @@
-// Copyright 2014 The Chromium Authors
-//
-// Redistribution and use in source and binary forms, with or without
-// modification, are permitted provided that the following conditions are
-// met:
-//
-//    * Redistributions of source code must retain the above copyright
-// notice, this list of conditions and the following disclaimer.
-//    * Redistributions in binary form must reproduce the above
-// copyright notice, this list of conditions and the following disclaimer
-// in the documentation and/or other materials provided with the
-// distribution.
-//    * Neither the name of Google Inc. nor the names of its
-// contributors may be used to endorse or promote products derived from
-// this software without specific prior written permission.
-//
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/App.js

@@ -1,4 +0,0 @@
-// Copyright 2019 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-export {};

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/AppProvider.js

@@ -1,17 +0,0 @@
-// Copyright 2019 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-import * as Root from '../root/root.js';
-const registeredAppProvider = [];
-export function registerAppProvider(registration) {
-    registeredAppProvider.push(registration);
-}
-export function getRegisteredAppProviders() {
-    return registeredAppProvider
-        .filter(provider => Root.Runtime.Runtime.isDescriptorEnabled({ experiment: undefined, condition: provider.condition }))
-        .sort((firstProvider, secondProvider) => {
-        const order1 = firstProvider.order || 0;
-        const order2 = secondProvider.order || 0;
-        return order1 - order2;
-    });
-}

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/Base64.js

@@ -1,43 +0,0 @@
-// Copyright 2020 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-export const BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
-export const BASE64_CODES = new Uint8Array(123);
-for (let index = 0; index < BASE64_CHARS.length; ++index) {
-    BASE64_CODES[BASE64_CHARS.charCodeAt(index)] = index;
-}
-/**
- * Decodes Base64-encoded data from a string without performing any kind of checking.
- */
-export function decode(input) {
-    let bytesLength = ((input.length * 3) / 4) >>> 0;
-    if (input.charCodeAt(input.length - 2) === 0x3d /* '=' */) {
-        bytesLength -= 2;
-    }
-    else if (input.charCodeAt(input.length - 1) === 0x3d /* '=' */) {
-        bytesLength -= 1;
-    }
-    const bytes = new Uint8Array(bytesLength);
-    for (let index = 0, offset = 0; index < input.length; index += 4) {
-        const a = BASE64_CODES[input.charCodeAt(index + 0)];
-        const b = BASE64_CODES[input.charCodeAt(index + 1)];
-        const c = BASE64_CODES[input.charCodeAt(index + 2)];
-        const d = BASE64_CODES[input.charCodeAt(index + 3)];
-        bytes[offset++] = (a << 2) | (b >> 4);
-        bytes[offset++] = ((b & 0x0f) << 4) | (c >> 2);
-        bytes[offset++] = ((c & 0x03) << 6) | (d & 0x3f);
-    }
-    return bytes;
-}
-export function encode(input) {
-    return new Promise((resolve, reject) => {
-        const reader = new FileReader();
-        reader.onerror = () => reject(new Error('failed to convert to base64'));
-        reader.onload = () => {
-            const blobAsUrl = reader.result;
-            const [, base64] = blobAsUrl.split(',', 2);
-            resolve(base64);
-        };
-        reader.readAsDataURL(new Blob([input]));
-    });
-}

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/CharacterIdMap.js

@@ -1,27 +0,0 @@
-// Copyright 2016 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-export class CharacterIdMap {
-    #elementToCharacter = new Map();
-    #characterToElement = new Map();
-    #charCode = 33;
-    toChar(object) {
-        let character = this.#elementToCharacter.get(object);
-        if (!character) {
-            if (this.#charCode >= 0xFFFF) {
-                throw new Error('CharacterIdMap ran out of capacity!');
-            }
-            character = String.fromCharCode(this.#charCode++);
-            this.#elementToCharacter.set(object, character);
-            this.#characterToElement.set(character, object);
-        }
-        return character;
-    }
-    fromChar(character) {
-        const object = this.#characterToElement.get(character);
-        if (object === undefined) {
-            return null;
-        }
-        return object;
-    }
-}