chrome-devtools-mcp 0.10.1 → 0.11.0

package/build/node_modules/chrome-devtools-frontend/front_end/core/host/AidaClient.js

@@ -368,13 +368,13 @@ export class AidaClient {
         }
         return { generatedSamples, metadata };
     }
-    async generateCode(request) {
+    async generateCode(request, options) {
         const response = await DispatchHttpRequestClient.makeHttpRequest({
             service: SERVICE_NAME,
             path: '/v1/aida:generateCode',
             method: 'POST',
             body: JSON.stringify(request),
-        });
+        }, options);
         return response;
     }
 }
@@ -389,7 +389,7 @@ export function convertToUserTierEnum(userTier) {
                 return UserTier.PUBLIC;
         }
     }
-    return UserTier.BETA;
+    return UserTier.PUBLIC;
 }
 let hostConfigTrackerInstance;
 export class HostConfigTracker extends Common.ObjectWrapper.ObjectWrapper {

package/build/node_modules/chrome-devtools-frontend/front_end/core/host/DispatchHttpRequestClient.js

@@ -6,6 +6,7 @@ export var ErrorType;
 (function (ErrorType) {
     ErrorType["HTTP_RESPONSE_UNAVAILABLE"] = "HTTP_RESPONSE_UNAVAILABLE";
     ErrorType["NOT_FOUND"] = "NOT_FOUND";
+    ErrorType["ABORT"] = "ABORT";
 })(ErrorType || (ErrorType = {}));
 export class DispatchHttpRequestError extends Error {
     type;
@@ -14,9 +15,20 @@ export class DispatchHttpRequestError extends Error {
         this.type = type;
     }
 }
-export async function makeHttpRequest(request) {
-    const response = await new Promise(resolve => {
-        InspectorFrontendHostInstance.dispatchHttpRequest(request, resolve);
+export async function makeHttpRequest(request, options) {
+    const signal = options?.signal;
+    if (signal?.aborted) {
+        throw new DispatchHttpRequestError(ErrorType.ABORT);
+    }
+    const response = await new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(new DispatchHttpRequestError(ErrorType.ABORT));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+        InspectorFrontendHostInstance.dispatchHttpRequest(request, result => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve(result);
+        });
     });
     debugLog({ request, response });
     if (response.statusCode === 404) {

package/build/node_modules/chrome-devtools-frontend/front_end/core/host/GdpClient.js

@@ -40,6 +40,7 @@ function normalizeBadgeName(name) {
     return name.replace(/profiles\/[^/]+\/awards\//, 'profiles/me/awards/');
 }
 export const GOOGLE_DEVELOPER_PROGRAM_PROFILE_LINK = 'https://developers.google.com/profile/u/me';
+const ORIGIN_APPLICATION_NAME = 'APPLICATION_CHROME_DEVTOOLS';
 async function makeHttpRequest(request) {
     if (!isGdpProfilesAvailable()) {
         throw new DispatchHttpRequestClient.DispatchHttpRequestError(DispatchHttpRequestClient.ErrorType.HTTP_RESPONSE_UNAVAILABLE);
@@ -146,6 +147,9 @@ export class GdpClient {
                 body: JSON.stringify({
                     user,
                     newsletter_email: emailPreference,
+                    creation_origin: {
+                        origin_application: ORIGIN_APPLICATION_NAME,
+                    }
                 }),
             });
             this.#clearCache();

package/build/node_modules/chrome-devtools-frontend/front_end/core/host/InspectorFrontendHost.js

@@ -2,439 +2,12 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 import * as Common from '../common/common.js';
-import * as i18n from '../i18n/i18n.js';
-import * as Platform from '../platform/platform.js';
 import * as Root from '../root/root.js';
-import { EventDescriptors, Events, } from './InspectorFrontendHostAPI.js';
+import { EventDescriptors, } from './InspectorFrontendHostAPI.js';
+import { InspectorFrontendHostStub } from './InspectorFrontendHostStub.js';
 import { streamWrite as resourceLoaderStreamWrite } from './ResourceLoader.js';
-const UIStrings = {
-    /**
-     * @description Document title in Inspector Frontend Host of the DevTools window
-     * @example {example.com} PH1
-     */
-    devtoolsS: 'DevTools - {PH1}',
-};
-const str_ = i18n.i18n.registerUIStrings('core/host/InspectorFrontendHost.ts', UIStrings);
-const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
-const MAX_RECORDED_HISTOGRAMS_SIZE = 100;
-const OVERRIDES_FILE_SYSTEM_PATH = '/overrides';
-/**
- * The `InspectorFrontendHostStub` is a stub interface used the frontend is loaded like a webpage. Examples:
- *   - devtools://devtools/bundled/devtools_app.html
- *   - https://chrome-devtools-frontend.appspot.com/serve_rev/@030cc140435b0152645522b9864b75cac6c0a854/worker_app.html
- *   - http://localhost:9222/devtools/inspector.html?ws=localhost:9222/devtools/page/xTARGET_IDx
- *
- * When the frontend runs within the native embedder, then the InspectorFrontendHostAPI methods are provided
- * by devtools_compatibility.js. Those leverage `DevToolsAPI.sendMessageToEmbedder()` which match up with
- * the embedder API defined here: https://source.chromium.org/search?q=f:devtools%20f:dispatcher%20f:cc%20symbol:CreateForDevToolsFrontend&sq=&ss=chromium%2Fchromium%2Fsrc
- * The native implementations live in devtools_ui_bindings.cc: https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/devtools/devtools_ui_bindings.cc
- */
-export class InspectorFrontendHostStub {
-    #urlsBeingSaved = new Map();
-    #fileSystem = null;
-    recordedCountHistograms = [];
-    recordedEnumeratedHistograms = [];
-    recordedPerformanceHistograms = [];
-    constructor() {
-        // Guard against errors should this file ever be imported at the top level
-        // within a worker - in which case this constructor is run. If there's no
-        // document, we can early exit.
-        if (typeof document === 'undefined') {
-            return;
-        }
-        function stopEventPropagation(event) {
-            // Let browser handle Ctrl+/Ctrl- shortcuts in hosted mode.
-            const zoomModifier = this.platform() === 'mac' ? event.metaKey : event.ctrlKey;
-            if (zoomModifier && (event.key === '+' || event.key === '-')) {
-                event.stopPropagation();
-            }
-        }
-        document.addEventListener('keydown', event => {
-            stopEventPropagation.call(this, (event));
-        }, true);
-    }
-    platform() {
-        const userAgent = navigator.userAgent;
-        if (userAgent.includes('Windows NT')) {
-            return 'windows';
-        }
-        if (userAgent.includes('Mac OS X')) {
-            return 'mac';
-        }
-        return 'linux';
-    }
-    loadCompleted() {
-    }
-    bringToFront() {
-    }
-    closeWindow() {
-    }
-    setIsDocked(_isDocked, callback) {
-        window.setTimeout(callback, 0);
-    }
-    showSurvey(_trigger, callback) {
-        window.setTimeout(() => callback({ surveyShown: false }), 0);
-    }
-    canShowSurvey(_trigger, callback) {
-        window.setTimeout(() => callback({ canShowSurvey: false }), 0);
-    }
-    /**
-     * Requests inspected page to be placed atop of the inspector frontend with specified bounds.
-     */
-    setInspectedPageBounds(_bounds) {
-    }
-    inspectElementCompleted() {
-    }
-    setInjectedScriptForOrigin(_origin, _script) {
-    }
-    inspectedURLChanged(url) {
-        document.title = i18nString(UIStrings.devtoolsS, { PH1: url.replace(/^https?:\/\//, '') });
-    }
-    copyText(text) {
-        if (text === undefined || text === null) {
-            return;
-        }
-        void navigator.clipboard.writeText(text);
-    }
-    openInNewTab(url) {
-        if (Common.ParsedURL.schemeIs(url, 'javascript:')) {
-            return;
-        }
-        window.open(url, '_blank');
-    }
-    openSearchResultsInNewTab(_query) {
-        Common.Console.Console.instance().error('Search is not enabled in hosted mode. Please inspect using chrome://inspect');
-    }
-    showItemInFolder(_fileSystemPath) {
-        Common.Console.Console.instance().error('Show item in folder is not enabled in hosted mode. Please inspect using chrome://inspect');
-    }
-    // Reminder: the methods in this class belong to InspectorFrontendHostStub and are typically not executed.
-    // InspectorFrontendHostStub is ONLY used in the uncommon case of devtools not being embedded. For example: trace.cafe or http://localhost:9222/devtools/inspector.html?ws=localhost:9222/devtools/page/xTARGET_IDx
-    save(url, content, _forceSaveAs, isBase64) {
-        let buffer = this.#urlsBeingSaved.get(url)?.buffer;
-        if (!buffer) {
-            buffer = [];
-            this.#urlsBeingSaved.set(url, { isBase64, buffer });
-        }
-        buffer.push(content);
-        this.events.dispatchEventToListeners(Events.SavedURL, { url, fileSystemPath: url });
-    }
-    append(url, content) {
-        const buffer = this.#urlsBeingSaved.get(url)?.buffer;
-        if (buffer) {
-            buffer.push(content);
-            this.events.dispatchEventToListeners(Events.AppendedToURL, url);
-        }
-    }
-    close(url) {
-        const { isBase64, buffer } = this.#urlsBeingSaved.get(url) || { isBase64: false, buffer: [] };
-        this.#urlsBeingSaved.delete(url);
-        let fileName = '';
-        if (url) {
-            try {
-                const trimmed = Platform.StringUtilities.trimURL(url);
-                fileName = Platform.StringUtilities.removeURLFragment(trimmed);
-            }
-            catch {
-                // If url is not a valid URL, it is probably a filename.
-                fileName = url;
-            }
-        }
-        /* eslint-disable-next-line @devtools/no-imperative-dom-api */
-        const link = document.createElement('a');
-        link.download = fileName;
-        let blob;
-        if (isBase64) {
-            const bytes = Common.Base64.decode(buffer.join(''));
-            blob = new Blob([bytes], { type: 'application/gzip' });
-        }
-        else {
-            blob = new Blob(buffer, { type: 'text/plain' });
-        }
-        const blobUrl = URL.createObjectURL(blob);
-        link.href = blobUrl;
-        link.click();
-        URL.revokeObjectURL(blobUrl);
-    }
-    sendMessageToBackend(_message) {
-    }
-    recordCountHistogram(histogramName, sample, min, exclusiveMax, bucketSize) {
-        if (this.recordedCountHistograms.length >= MAX_RECORDED_HISTOGRAMS_SIZE) {
-            this.recordedCountHistograms.shift();
-        }
-        this.recordedCountHistograms.push({ histogramName, sample, min, exclusiveMax, bucketSize });
-    }
-    recordEnumeratedHistogram(actionName, actionCode, _bucketSize) {
-        if (this.recordedEnumeratedHistograms.length >= MAX_RECORDED_HISTOGRAMS_SIZE) {
-            this.recordedEnumeratedHistograms.shift();
-        }
-        this.recordedEnumeratedHistograms.push({ actionName, actionCode });
-    }
-    recordPerformanceHistogram(histogramName, duration) {
-        if (this.recordedPerformanceHistograms.length >= MAX_RECORDED_HISTOGRAMS_SIZE) {
-            this.recordedPerformanceHistograms.shift();
-        }
-        this.recordedPerformanceHistograms.push({ histogramName, duration });
-    }
-    recordUserMetricsAction(_umaName) {
-    }
-    recordNewBadgeUsage(_featureName) {
-    }
-    connectAutomaticFileSystem(_fileSystemPath, _fileSystemUUID, _addIfMissing, callback) {
-        queueMicrotask(() => callback({ success: false }));
-    }
-    disconnectAutomaticFileSystem(_fileSystemPath) {
-    }
-    requestFileSystems() {
-        this.events.dispatchEventToListeners(Events.FileSystemsLoaded, []);
-    }
-    addFileSystem(_type) {
-        const onFileSystem = (fs) => {
-            this.#fileSystem = fs;
-            const fileSystem = {
-                fileSystemName: 'sandboxedRequestedFileSystem',
-                fileSystemPath: OVERRIDES_FILE_SYSTEM_PATH,
-                rootURL: 'filesystem:devtools://devtools/isolated/',
-                type: 'overrides',
-            };
-            this.events.dispatchEventToListeners(Events.FileSystemAdded, { fileSystem });
-        };
-        window.webkitRequestFileSystem(window.TEMPORARY, 1024 * 1024, onFileSystem);
-    }
-    removeFileSystem(_fileSystemPath) {
-        const removalCallback = (entries) => {
-            entries.forEach(entry => {
-                if (entry.isDirectory) {
-                    entry.removeRecursively(() => { });
-                }
-                else if (entry.isFile) {
-                    entry.remove(() => { });
-                }
-            });
-        };
-        if (this.#fileSystem) {
-            this.#fileSystem.root.createReader().readEntries(removalCallback);
-        }
-        this.#fileSystem = null;
-        this.events.dispatchEventToListeners(Events.FileSystemRemoved, OVERRIDES_FILE_SYSTEM_PATH);
-    }
-    isolatedFileSystem(_fileSystemId, _registeredName) {
-        return this.#fileSystem;
-    }
-    loadNetworkResource(url, _headers, streamId, callback) {
-        fetch(url)
-            .then(async (result) => {
-            const respBuffer = await result.arrayBuffer();
-            const text = await Common.Gzip.arrayBufferToString(respBuffer);
-            return text;
-        })
-            .then(function (text) {
-            resourceLoaderStreamWrite(streamId, text);
-            callback({
-                statusCode: 200,
-                headers: undefined,
-                messageOverride: undefined,
-                netError: undefined,
-                netErrorName: undefined,
-                urlValid: undefined,
-            });
-        })
-            .catch(function () {
-            callback({
-                statusCode: 404,
-                headers: undefined,
-                messageOverride: undefined,
-                netError: undefined,
-                netErrorName: undefined,
-                urlValid: undefined,
-            });
-        });
-    }
-    registerPreference(_name, _options) {
-    }
-    getPreferences(callback) {
-        const prefs = {};
-        for (const name in window.localStorage) {
-            prefs[name] = window.localStorage[name];
-        }
-        callback(prefs);
-    }
-    getPreference(name, callback) {
-        callback(window.localStorage[name]);
-    }
-    setPreference(name, value) {
-        window.localStorage[name] = value;
-    }
-    removePreference(name) {
-        delete window.localStorage[name];
-    }
-    clearPreferences() {
-        window.localStorage.clear();
-    }
-    getSyncInformation(callback) {
-        if ('getSyncInformationForTesting' in globalThis) {
-            // @ts-expect-error for testing
-            return callback(globalThis.getSyncInformationForTesting());
-        }
-        callback({
-            isSyncActive: false,
-            arePreferencesSynced: false,
-        });
-    }
-    getHostConfig(callback) {
-        // This HostConfig config is used in the hosted mode (see the
-        // comment on top of this class). Only add non-default config params
-        // here that you want to also apply in the hosted mode. For tests
-        // use the hostConfigForTesting override.
-        const hostConfigForHostedMode = {
-            devToolsVeLogging: {
-                enabled: true,
-            },
-            thirdPartyCookieControls: {
-                thirdPartyCookieMetadataEnabled: true,
-                thirdPartyCookieHeuristicsEnabled: true,
-                managedBlockThirdPartyCookies: 'Unset',
-            },
-            devToolsIpProtectionPanelInDevTools: {
-                enabled: false,
-            },
-            devToolsFlexibleLayout: {
-                verticalDrawerEnabled: true,
-            },
-            devToolsStartingStyleDebugging: {
-                enabled: false,
-            },
-        };
-        if ('hostConfigForTesting' in globalThis) {
-            const { hostConfigForTesting } = globalThis;
-            for (const key of Object.keys(hostConfigForTesting)) {
-                const mergeEntry = (key) => {
-                    if (typeof hostConfigForHostedMode[key] === 'object' && typeof hostConfigForTesting[key] === 'object') {
-                        // If the config is an object, merge the settings, but preferring
-                        // the hostConfigForTesting values over the result values.
-                        hostConfigForHostedMode[key] = { ...hostConfigForHostedMode[key], ...hostConfigForTesting[key] };
-                    }
-                    else {
-                        // Override with the testing config if the value is present + not null/undefined.
-                        hostConfigForHostedMode[key] = hostConfigForTesting[key] ?? hostConfigForHostedMode[key];
-                    }
-                };
-                mergeEntry(key);
-            }
-        }
-        callback(hostConfigForHostedMode);
-    }
-    upgradeDraggedFileSystemPermissions(_fileSystem) {
-    }
-    indexPath(_requestId, _fileSystemPath, _excludedFolders) {
-    }
-    stopIndexing(_requestId) {
-    }
-    searchInPath(_requestId, _fileSystemPath, _query) {
-    }
-    zoomFactor() {
-        return 1;
-    }
-    zoomIn() {
-    }
-    zoomOut() {
-    }
-    resetZoom() {
-    }
-    setWhitelistedShortcuts(_shortcuts) {
-    }
-    setEyeDropperActive(_active) {
-    }
-    showCertificateViewer(_certChain) {
-    }
-    reattach(_callback) {
-    }
-    readyForTest() {
-    }
-    connectionReady() {
-    }
-    setOpenNewWindowForPopups(_value) {
-    }
-    setDevicesDiscoveryConfig(_config) {
-    }
-    setDevicesUpdatesEnabled(_enabled) {
-    }
-    openRemotePage(_browserId, _url) {
-    }
-    openNodeFrontend() {
-    }
-    showContextMenuAtPoint(_x, _y, _items, _document) {
-        throw new Error('Soft context menu should be used');
-    }
-    /**
-     * Think of **Hosted mode** as "non-embedded" mode; you can see a devtools frontend URL as the tab's URL. It's an atypical way that DevTools is run.
-     * Whereas in **Non-hosted** (aka "embedded"), DevTools is embedded and fully dockable. It's the common way DevTools is run.
-     *
-     * **Hosted mode** == we're using the `InspectorFrontendHostStub`. impl. (@see `InspectorFrontendHostStub` class comment)
-     * Whereas with **non-hosted** mode, native `DevToolsEmbedderMessageDispatcher` is used for CDP and more.
-     *
-     * Relationships to other signals:
-     * - Hosted-ness does not indicate whether the frontend is _connected to a valid CDP target_.
-     * - Being _"dockable"_ (aka `canDock`) is typically aligned but technically orthogonal.
-     * - It's unrelated to the _tab's (main frame's) URL_. Though in non-hosted, the devtools frame origin will always be `devtools://devtools`.
-     *
-     *  | Example case                                         | Mode           | Example devtools                                                                   |
-     *  | :--------------------------------------------------- | :------------- | :---------------------------------------------------------------------------- |
-     *  | tab URL: anything. embedded DevTools w/ native CDP bindings    | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html?targetType=tab&...`            |
-     *  | tab URL: `devtools://…?ws=…`                | **Hosted**     | `devtools://devtools/bundled/devtools_app.html?ws=localhost:9228/...`         |
-     *  | tab URL: `devtools://…` but no connection   | **Hosted**     | `devtools://devtools/bundled/devtools_app.html`                               |
-     *  | tab URL: `https://…` but no connection      | **Hosted**     | `https://chrome-devtools-frontend.appspot.com/serve_rev/@.../worker_app.html` |
-     *  | tab URL: `http://…?ws=` (connected)         | **Hosted**     | `http://localhost:9222/devtools/inspector.html?ws=localhost:9222/...`         |
-     */
-    isHostedMode() {
-        return true;
-    }
-    setAddExtensionCallback(_callback) {
-        // Extensions are not supported in hosted mode.
-    }
-    async initialTargetId() {
-        return null;
-    }
-    doAidaConversation(_request, _streamId, callback) {
-        callback({
-            error: 'Not implemented',
-        });
-    }
-    registerAidaClientEvent(_request, callback) {
-        callback({
-            error: 'Not implemented',
-        });
-    }
-    aidaCodeComplete(_request, callback) {
-        callback({
-            error: 'Not implemented',
-        });
-    }
-    dispatchHttpRequest(_request, callback) {
-        callback({ error: 'Not implemented' });
-    }
-    recordImpression(_event) {
-    }
-    recordResize(_event) {
-    }
-    recordClick(_event) {
-    }
-    recordHover(_event) {
-    }
-    recordDrag(_event) {
-    }
-    recordChange(_event) {
-    }
-    recordKeyDown(_event) {
-    }
-    recordSettingAccess(_event) {
-    }
-    recordFunctionCall(_event) {
-    }
-}
-// @ts-expect-error Global injected by devtools_compatibility.js
 // eslint-disable-next-line @typescript-eslint/naming-convention
-export let InspectorFrontendHostInstance = globalThis.InspectorFrontendHost;
+export let InspectorFrontendHostInstance;
 class InspectorFrontendAPIImpl {
     constructor() {
         for (const descriptor of EventDescriptors) {
@@ -470,33 +43,37 @@ class InspectorFrontendAPIImpl {
         resourceLoaderStreamWrite(id, chunk);
     }
 }
-(function () {
-    function initializeInspectorFrontendHost() {
-        if (!InspectorFrontendHostInstance) {
-            // Instantiate stub for web-hosted mode if necessary.
-            // @ts-expect-error Global injected by devtools_compatibility.js
-            globalThis.InspectorFrontendHost = InspectorFrontendHostInstance = new InspectorFrontendHostStub();
-        }
-        else {
-            // Otherwise add stubs for missing methods that are declared in the interface.
-            const proto = InspectorFrontendHostStub.prototype;
-            for (const name of Object.getOwnPropertyNames(proto)) {
-                const stub = proto[name];
-                if (typeof stub !== 'function' || InspectorFrontendHostInstance[name]) {
-                    continue;
-                }
-                console.error(`Incompatible embedder: method Host.InspectorFrontendHost.${name} is missing. Using stub instead.`);
-                // @ts-expect-error Global injected by devtools_compatibility.js
-                InspectorFrontendHostInstance[name] = stub;
+/**
+ * Installs the provided host bindings implementation as the globally used one by DevTools.
+ *
+ *   - In non-hosted mode this is provided by `devtools_compatibility.js`.
+ *   - In hosted mode this tends to be the {@link InspectorFrontendHostStub}.
+ *   - For the MCP server this is a custom node.js specific implementation.
+ *
+ * Note that missing methods will be copied over from the stub.
+ */
+export function installInspectorFrontendHost(instance) {
+    globalThis.InspectorFrontendHost = InspectorFrontendHostInstance = instance;
+    if (!(instance instanceof InspectorFrontendHostStub)) {
+        // Add stubs for missing methods.
+        const proto = InspectorFrontendHostStub.prototype;
+        for (const name of Object.getOwnPropertyNames(proto)) {
+            const stub = proto[name];
+            if (typeof stub !== 'function' || InspectorFrontendHostInstance[name]) {
+                continue;
             }
+            console.error(`Incompatible embedder: method Host.InspectorFrontendHost.${name} is missing. Using stub instead.`);
+            // @ts-expect-error Global injected by devtools_compatibility.js
+            InspectorFrontendHostInstance[name] = stub;
         }
-        // Attach the events object.
-        InspectorFrontendHostInstance.events = new Common.ObjectWrapper.ObjectWrapper();
     }
+    // Attach the events object.
+    InspectorFrontendHostInstance.events = new Common.ObjectWrapper.ObjectWrapper();
+}
+(function () {
     // FIXME: This file is included into both apps, since the devtools_app needs the InspectorFrontendHostAPI only,
     // so the host instance should not be initialized there.
-    initializeInspectorFrontendHost();
-    // @ts-expect-error Global injected by devtools_compatibility.js
+    installInspectorFrontendHost(globalThis.InspectorFrontendHost ?? new InspectorFrontendHostStub());
     globalThis.InspectorFrontendAPI = new InspectorFrontendAPIImpl();
 })();
 export function isUnderTest(prefs) {
@@ -511,3 +88,5 @@ export function isUnderTest(prefs) {
     return Common.Settings.Settings.hasInstance() &&
         Common.Settings.Settings.instance().createSetting('isUnderTest', false).get();
 }
+// The stub class used to be declared here so for backwards compatibility we re-export it from here.
+export { InspectorFrontendHostStub };