chrome-devtools-mcp 1.2.0 → 1.4.0

package/build/src/{DevtoolsUtils.js → devtools/DevtoolsUtils.js}

@@ -3,9 +3,10 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Mutex } from '../Mutex.js';
+import { DevTools } from '../third_party/index.js';
 import { PuppeteerDevToolsConnection } from './DevToolsConnectionAdapter.js';
-import { Mutex } from './Mutex.js';
-import { DevTools } from './third_party/index.js';
+import { McpHostBindingAdapter } from './McpHostBindingAdapter.js';
 /**
  * A mock implementation of an issues manager that only implements the methods
  * that are actually used by the IssuesAggregator
@@ -16,79 +17,82 @@ export class FakeIssuesManager extends DevTools.Common.ObjectWrapper
         return [];
     }
 }
-// DevTools CDP errors can get noisy.
-DevTools.ProtocolClient.InspectorBackend.test.suppressRequestErrors = true;
-// Stub out Network emulation commands on the DevTools Agent prototype globally.
-// This prevents the DevTools Frontend from ever resetting/clearing Puppeteer's
-// active network blocking/throttling rules during target setup or session lifetime.
-const networkAgentPrototype = DevTools.ProtocolClient.InspectorBackend.inspectorBackend.agentPrototypes.get('Network');
-if (networkAgentPrototype) {
-    Object.defineProperty(networkAgentPrototype, 'invoke_emulateNetworkConditionsByRule', {
-        value: () => {
-            return Promise.resolve({
-                ruleIds: [],
-                getError: () => undefined,
-            });
-        },
-        writable: true,
-        configurable: true,
-        enumerable: true,
-    });
-    Object.defineProperty(networkAgentPrototype, 'invoke_overrideNetworkState', {
-        value: () => {
-            return Promise.resolve({
-                getError: () => undefined,
-            });
-        },
-        writable: true,
-        configurable: true,
-        enumerable: true,
-    });
-    Object.defineProperty(networkAgentPrototype, 'invoke_enable', {
-        value: () => {
-            return Promise.resolve({
-                getError: () => undefined,
-            });
-        },
-        writable: true,
-        configurable: true,
-        enumerable: true,
-    });
-    Object.defineProperty(networkAgentPrototype, 'invoke_disable', {
-        value: () => {
-            return Promise.resolve({
-                getError: () => undefined,
-            });
+export function overrideDevToolsGlobals({ loadResource, }) {
+    DevTools.Host.InspectorFrontendHost.installInspectorFrontendHost(new McpHostBindingAdapter(loadResource));
+    // DevTools CDP errors can get noisy.
+    DevTools.ProtocolClient.InspectorBackend.test.suppressRequestErrors = true;
+    // Stub out Network emulation commands on the DevTools Agent prototype globally.
+    // This prevents the DevTools Frontend from ever resetting/clearing Puppeteer's
+    // active network blocking/throttling rules during target setup or session lifetime.
+    const networkAgentPrototype = DevTools.ProtocolClient.InspectorBackend.inspectorBackend.agentPrototypes.get('Network');
+    if (networkAgentPrototype) {
+        Object.defineProperty(networkAgentPrototype, 'invoke_emulateNetworkConditionsByRule', {
+            value: () => {
+                return Promise.resolve({
+                    ruleIds: [],
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_overrideNetworkState', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_enable', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_disable', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_setBlockedURLs', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+    }
+    DevTools.I18n.DevToolsLocale.DevToolsLocale.instance({
+        create: true,
+        data: {
+            navigatorLanguage: 'en-US',
+            settingLanguage: 'en-US',
+            lookupClosestDevToolsLocale: l => l,
         },
-        writable: true,
-        configurable: true,
-        enumerable: true,
     });
-    Object.defineProperty(networkAgentPrototype, 'invoke_setBlockedURLs', {
-        value: () => {
-            return Promise.resolve({
-                getError: () => undefined,
-            });
-        },
-        writable: true,
-        configurable: true,
-        enumerable: true,
+    DevTools.I18n.i18n.registerLocaleDataForTest('en-US', {});
+    DevTools.Formatter.FormatterWorkerPool.FormatterWorkerPool.instance({
+        forceNew: true,
+        entrypointURL: import.meta
+            .resolve('../third_party/devtools-formatter-worker.js'),
     });
 }
-DevTools.I18n.DevToolsLocale.DevToolsLocale.instance({
-    create: true,
-    data: {
-        navigatorLanguage: 'en-US',
-        settingLanguage: 'en-US',
-        lookupClosestDevToolsLocale: l => l,
-    },
-});
-DevTools.I18n.i18n.registerLocaleDataForTest('en-US', {});
-DevTools.Formatter.FormatterWorkerPool.FormatterWorkerPool.instance({
-    forceNew: true,
-    entrypointURL: import.meta
-        .resolve('./third_party/devtools-formatter-worker.js'),
-});
 export class UniverseManager {
     #browser;
     #createUniverseFor;

package/build/src/devtools/McpHostBindingAdapter.js

@@ -0,0 +1,165 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable @typescript-eslint/no-empty-function */
+import { DevTools } from '../third_party/index.js';
+/**
+ * BaseClass that is noop or throws for methods.
+ * the McpHostBindingAdapter should only implement methods
+ * that it needs to support.
+ */
+class BaseMcpHostBindingAdapter {
+    connectAutomaticFileSystem() { }
+    disconnectAutomaticFileSystem() { }
+    addFileSystem() { }
+    loadCompleted() { }
+    indexPath() { }
+    setInspectedPageBounds() { }
+    showCertificateViewer() { }
+    setWhitelistedShortcuts() { }
+    setEyeDropperActive() { }
+    inspectElementCompleted() { }
+    openInNewTab() { }
+    openSearchResultsInNewTab() { }
+    showItemInFolder() { }
+    removeFileSystem() { }
+    requestFileSystems() { }
+    save() { }
+    append() { }
+    close() { }
+    searchInPath() { }
+    stopIndexing() { }
+    bringToFront() { }
+    closeWindow() { }
+    copyText() { }
+    inspectedURLChanged() { }
+    isolatedFileSystem() {
+        throw new Error('Not implemented');
+    }
+    registerPreference() { }
+    getPreferences() { }
+    getPreference() { }
+    setPreference() { }
+    removePreference() { }
+    clearPreferences() { }
+    getSyncInformation() { }
+    getHostConfig() { }
+    upgradeDraggedFileSystemPermissions() { }
+    platform() {
+        throw new Error('Not implemented');
+    }
+    recordCountHistogram() { }
+    recordEnumeratedHistogram() { }
+    recordPerformanceHistogram() { }
+    recordPerformanceHistogramMedium() { }
+    recordUserMetricsAction() { }
+    recordNewBadgeUsage() { }
+    sendMessageToBackend() { }
+    setDevicesDiscoveryConfig() { }
+    setDevicesUpdatesEnabled() { }
+    openRemotePage() { }
+    openNodeFrontend() { }
+    setInjectedScriptForOrigin() { }
+    setIsDocked() { }
+    showSurvey() { }
+    canShowSurvey() { }
+    zoomFactor() {
+        throw new Error('Not implemented');
+    }
+    zoomIn() { }
+    zoomOut() { }
+    resetZoom() { }
+    showContextMenuAtPoint() { }
+    reattach() { }
+    readyForTest() { }
+    connectionReady() { }
+    setOpenNewWindowForPopups() { }
+    isHostedMode() {
+        throw new Error('Not implemented');
+    }
+    setAddExtensionCallback() { }
+    initialTargetId() {
+        throw new Error('Not implemented');
+    }
+    doAidaConversation(_request, _streamId, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    registerAidaClientEvent(_request, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    aidaCodeComplete(_request, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    dispatchHttpRequest(_request, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    recordImpression() { }
+    recordResize() { }
+    recordClick() { }
+    recordHover() { }
+    recordDrag() { }
+    recordChange() { }
+    recordKeyDown() { }
+    recordSettingAccess() { }
+    recordFunctionCall() { }
+    setChromeFlag() { }
+    requestRestart() { }
+    loadNetworkResource(_urlString, _headers, _streamId, _callback) { }
+}
+export class McpHostBindingAdapter extends BaseMcpHostBindingAdapter {
+    #loadResource;
+    constructor(loadResource) {
+        super();
+        this.#loadResource = loadResource;
+    }
+    isolatedFileSystem() {
+        return null;
+    }
+    platform() {
+        switch (process.platform) {
+            case 'darwin':
+                return 'mac';
+            case 'win32':
+                return 'windows';
+            default:
+                return 'linux';
+        }
+    }
+    zoomFactor() {
+        return 1;
+    }
+    isHostedMode() {
+        return true;
+    }
+    initialTargetId() {
+        return Promise.resolve(null);
+    }
+    loadNetworkResource(urlString, _headers, streamId, callback) {
+        if (!URL.canParse(urlString)) {
+            callback({
+                statusCode: 404,
+                urlValid: false,
+            });
+            return;
+        }
+        this.#loadResource(urlString)
+            .then(content => {
+            DevTools.Host.ResourceLoader.streamWrite(streamId, content);
+            callback({ statusCode: 200 });
+        })
+            .catch(() => {
+            callback({ statusCode: 404 });
+        });
+    }
+}
+//# sourceMappingURL=McpHostBindingAdapter.js.map

package/build/src/formatters/ConsoleFormatter.js

@@ -3,7 +3,7 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { createStackTraceForConsoleMessage, SymbolizedError, } from '../DevtoolsUtils.js';
+import { createStackTraceForConsoleMessage, SymbolizedError, } from '../devtools/DevtoolsUtils.js';
 import { UncaughtError } from '../PageCollector.js';
 import * as DevTools from '../third_party/index.js';
 export class ConsoleFormatter {

package/build/src/formatters/HeapSnapshotFormatter.js

@@ -45,6 +45,28 @@ export class HeapSnapshotFormatter {
         }
         return lines.join('\n');
     }
+    static formatRetainingPaths(retainingPaths) {
+        const lines = [];
+        function formatEdge(edge, depth) {
+            const indent = '  '.repeat(depth);
+            lines.push(`${indent}<- @${edge.nodeId} ${edge.nodeName} via ${edge.edgeType} ${edge.edgeName} (distance: ${edge.distance})`);
+            for (const child of edge.children) {
+                formatEdge(child, depth + 1);
+            }
+        }
+        for (const path of retainingPaths) {
+            formatEdge(path, 0);
+        }
+        return lines.join('\n');
+    }
+    static formatDominators(dominators) {
+        const lines = [];
+        lines.push('nodeId,nodeName,selfSize,retainedSize');
+        for (const node of dominators) {
+            lines.push(`${node.nodeId},${node.nodeName},${DevTools.I18n.ByteUtilities.formatBytesToKb(node.selfSize)},${DevTools.I18n.ByteUtilities.formatBytesToKb(node.retainedSize)}`);
+        }
+        return lines.join('\n');
+    }
     #getSortedAggregates() {
         return Object.values(this.#aggregates).sort((a, b) => b.maxRet - a.maxRet);
     }

package/build/src/formatters/NetworkFormatter.js

@@ -226,7 +226,9 @@ function converNetworkRequestDetailedToStringDetailed(data) {
     if (redirectChain?.length) {
         response.push(`### Redirect chain`);
         let indent = 0;
-        for (const request of redirectChain.reverse()) {
+        // `redirectChain` is already ordered by toJSONDetailed(); don't reverse it
+        // again here or the text output contradicts structuredContent (the JSON).
+        for (const request of redirectChain) {
             response.push(`${'  '.repeat(indent)}${convertNetworkRequestConciseToString(request)}`);
             indent++;
         }

package/build/src/third_party/THIRD_PARTY_NOTICES

@@ -324,7 +324,7 @@ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH RE
 
 Name: semver
 URL: git+https://github.com/npm/node-semver.git
-Version: 7.8.1
+Version: 7.8.5
 License: ISC
 
 The ISC License
@@ -867,14 +867,14 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 Name: puppeteer-core
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/puppeteer-core
-Version: 25.1.0
+Version: 25.2.0
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
 
 Name: @puppeteer/browsers
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/browsers
-Version: 3.0.4
+Version: 3.0.5
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
@@ -910,7 +910,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 Name: @toon-format/toon
 URL: https://toonformat.dev
-Version: 2.2.0
+Version: 2.3.0
 License: MIT
 
 MIT License

package/build/src/third_party/bundled-packages.json

@@ -1,12 +1,12 @@
 {
   "@modelcontextprotocol/sdk": "1.29.0",
   "@toon-format/toon": "^2.2.0",
-  "chrome-devtools-frontend": "1.0.1641723",
+  "chrome-devtools-frontend": "1.0.1650035",
   "core-js": "3.49.0",
   "debug": "4.4.3",
-  "lighthouse": "13.3.0",
+  "lighthouse": "13.4.0",
   "semver": "^7.7.4",
   "urlpattern-polyfill": "^10.1.0",
   "yargs": "18.0.0",
-  "puppeteer-core": "25.1.0"
+  "puppeteer-core": "25.2.0"
 }

package/build/src/third_party/devtools-formatter-worker.js

@@ -2645,7 +2645,6 @@ var ExperimentName;
     ExperimentName["ALL"] = "*";
     ExperimentName["PROTOCOL_MONITOR"] = "protocol-monitor";
     ExperimentName["INSTRUMENTATION_BREAKPOINTS"] = "instrumentation-breakpoints";
-    ExperimentName["USE_SOURCE_MAP_SCOPES"] = "use-source-map-scopes";
     ExperimentName["DURABLE_MESSAGES"] = "durable-messages";
     ExperimentName["JPEG_XL"] = "jpeg-xl";
     ExperimentName["PLUS_BUTTON"] = "plus-button";

package/build/src/third_party/devtools-heap-snapshot-worker.js

@@ -642,10 +642,14 @@ class Diff {
     removedCount = 0;
     addedSize = 0;
     removedSize = 0;
-    deletedIndexes = [];
-    addedIndexes = [];
     countDelta;
     sizeDelta;
+    addedIndexes = [];
+    addedIds = [];
+    addedSelfSizes = [];
+    deletedIndexes = [];
+    deletedIds = [];
+    deletedSelfSizes = [];
     constructor(name) {
         this.name = name;
     }
@@ -2840,7 +2844,6 @@ var ExperimentName;
     ExperimentName["ALL"] = "*";
     ExperimentName["PROTOCOL_MONITOR"] = "protocol-monitor";
     ExperimentName["INSTRUMENTATION_BREAKPOINTS"] = "instrumentation-breakpoints";
-    ExperimentName["USE_SOURCE_MAP_SCOPES"] = "use-source-map-scopes";
     ExperimentName["DURABLE_MESSAGES"] = "durable-messages";
     ExperimentName["JPEG_XL"] = "jpeg-xl";
     ExperimentName["PLUS_BUTTON"] = "plus-button";
@@ -5936,6 +5939,9 @@ class HeapSnapshotProxy extends HeapSnapshotProxyObject {
     nodeClassKey(snapshotObjectId) {
         return this.callMethodPromise('nodeClassKey', snapshotObjectId);
     }
+    nodeIndexForId(nodeId) {
+        return this.callMethodPromise('nodeIndexForId', nodeId);
+    }
     createEdgesProvider(nodeIndex) {
         return this.callFactoryMethod('createEdgesProvider', HeapSnapshotProviderProxy, nodeIndex);
     }
@@ -5996,6 +6002,9 @@ class HeapSnapshotProxy extends HeapSnapshotProxyObject {
     getRetainingPaths(nodeIndex, maxDepth, maxNodes, maxSiblings) {
         return this.callMethodPromise('getRetainingPaths', nodeIndex, maxDepth, maxNodes, maxSiblings);
     }
+    getDominatorsOf(nodeIndex) {
+        return this.callMethodPromise('getDominatorsOf', nodeIndex);
+    }
     unignoreNodeInRetainersView(nodeIndex) {
         return this.callMethodPromise('unignoreNodeInRetainersView', nodeIndex);
     }
@@ -7064,6 +7073,16 @@ class HeapSnapshot {
         }
         this.#progress.updateStatus('Finished processing.');
     }
+    nodeIndexForId(nodeId) {
+        const nodesLength = this.nodes.length;
+        const { nodes, nodeFieldCount, nodeIdOffset } = this;
+        for (let nodeIndex = 0; nodeIndex < nodesLength; nodeIndex += nodeFieldCount) {
+            if (nodes.getValue(nodeIndex + nodeIdOffset) === nodeId) {
+                return nodeIndex;
+            }
+        }
+        return undefined;
+    }
     startInitStep1InSecondThread(secondWorker) {
         const resultsFromSecondWorker = new Promise((resolve, reject) => {
             const listener = (e) => {
@@ -7315,6 +7334,12 @@ class HeapSnapshot {
             }
         };
         switch (filterName) {
+            case 'objectsRetainedByContexts':
+                traverse((_node, edge) => {
+                    return !this.isContextObject(edge.node());
+                });
+                markUnreachableNodes();
+                return (node) => !getBit(node);
             case 'objectsRetainedByDetachedDomNodes':
                 traverse((_node, edge) => {
                     return edge.node().detachedness() !== 2 ;
@@ -7458,6 +7483,9 @@ class HeapSnapshot {
     isUserRoot(_node) {
         return true;
     }
+    isContextObject(_node) {
+        return false;
+    }
     calculateShallowSizes() {
     }
     calculateDistances(isForRetainersView, filter) {
@@ -8287,6 +8315,8 @@ class HeapSnapshot {
             const nodeAId = baseIds[i];
             if (nodeAId < nodeB.id()) {
                 diff.deletedIndexes.push(baseIndexes[i]);
+                diff.deletedIds.push(nodeAId);
+                diff.deletedSelfSizes.push(baseSelfSizes[i]);
                 diff.removedCount++;
                 diff.removedSize += baseSelfSizes[i];
                 ++i;
@@ -8294,6 +8324,8 @@ class HeapSnapshot {
             else if (nodeAId >
                 nodeB.id()) {
                 diff.addedIndexes.push(indexes[j]);
+                diff.addedIds.push(nodeB.id());
+                diff.addedSelfSizes.push(nodeB.selfSize());
                 diff.addedCount++;
                 diff.addedSize += nodeB.selfSize();
                 nodeB.nodeIndex = indexes[++j];
@@ -8305,12 +8337,16 @@ class HeapSnapshot {
         }
         while (i < l) {
             diff.deletedIndexes.push(baseIndexes[i]);
+            diff.deletedIds.push(baseIds[i]);
+            diff.deletedSelfSizes.push(baseSelfSizes[i]);
             diff.removedCount++;
             diff.removedSize += baseSelfSizes[i];
             ++i;
         }
         while (j < m) {
             diff.addedIndexes.push(indexes[j]);
+            diff.addedIds.push(nodeB.id());
+            diff.addedSelfSizes.push(nodeB.selfSize());
             diff.addedCount++;
             diff.addedSize += nodeB.selfSize();
             nodeB.nodeIndex = indexes[++j];
@@ -8466,6 +8502,30 @@ class HeapSnapshot {
         const paths = buildForest(nodeIndex, 0);
         return { paths, limitsReached };
     }
+    getDominatorsOf(nodeIndex) {
+        const chain = [];
+        let currentIndex = nodeIndex;
+        const rootIndex = this.rootNodeIndex;
+        while (currentIndex !== undefined) {
+            const node = this.createNode(currentIndex);
+            chain.push({
+                nodeId: node.id(),
+                nodeIndex: currentIndex,
+                nodeName: node.name(),
+                retainedSize: node.retainedSize(),
+                selfSize: node.selfSize(),
+            });
+            if (currentIndex === rootIndex) {
+                break;
+            }
+            const nextIndex = node.dominatorIndex();
+            if (nextIndex === currentIndex) {
+                break;
+            }
+            currentIndex = nextIndex;
+        }
+        return chain;
+    }
     createAddedNodesProvider(baseSnapshotId, classKey) {
         const snapshotDiff = this.#snapshotDiffs[baseSnapshotId];
         const diffForClass = snapshotDiff[classKey];
@@ -8960,6 +9020,10 @@ class JSHeapSnapshot extends HeapSnapshot {
     isUserRoot(node) {
         return node.isUserRoot() || node.isDocumentDOMTreesRoot();
     }
+    isContextObject(node) {
+        const name = node.rawName();
+        return name === 'system / Context' || name.startsWith('system / Context / ');
+    }
     userObjectsMapAndFlag() {
         return { map: this.flags, flag: this.nodeFlags.pageObject };
     }