opera-devtools-mcp 0.2.4 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opera-devtools-mcp",
-  "version": "0.2.4",
+  "version": "0.4.0",
   "description": "MCP server for Opera DevTools",
   "type": "module",
   "bin": {
@@ -9,28 +9,34 @@
   },
   "main": "./build/src/index.js",
   "scripts": {
-    "cli:generate": "node --experimental-strip-types scripts/generate-cli.ts",
+    "cli:generate": "node scripts/generate-cli.ts",
     "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
-    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs && node -e \"require('fs').rmSync('build/node_modules', {recursive: true, force: true})\" && node --experimental-strip-types scripts/append-lighthouse-notices.ts",
-    "build": "tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
+    "bundle": "npm run clean && npm run build && rollup -c rollup.config.js && node -e \"require('fs').rmSync('build/node_modules', {recursive: true, force: true})\" && node scripts/append-lighthouse-notices.ts",
+    "build": "tsc && node scripts/post-build.ts",
     "typecheck": "tsc --noEmit",
     "format": "eslint --cache --fix . && prettier --write --cache .",
     "check-format": "eslint --cache . && prettier --check --cache .;",
-    "gen": "npm run build && npm run docs:generate && npm run cli:generate && npm run update-tool-call-metrics && npm run format",
-    "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
-    "start": "npm run build && node build/src/bin/chrome-devtools-mcp.js",
-    "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/bin/chrome-devtools-mcp.js",
-    "test": "npm run build && node scripts/test.mjs",
-    "test:no-build": "node scripts/test.mjs",
-    "test:only": "npm run build && node scripts/test.mjs --test-only",
-    "test:update-snapshots": "npm run build && node scripts/test.mjs --test-update-snapshots",
-    "prepare": "node --experimental-strip-types scripts/prepare.ts",
-    "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts",
-    "update-lighthouse": "node --experimental-strip-types scripts/update-lighthouse.ts",
-    "update-tool-call-metrics": "node --experimental-strip-types scripts/update_tool_call_metrics.ts",
-    "verify-npm-package": "node scripts/verify-npm-package.mjs",
-    "eval": "npm run build && node --experimental-strip-types scripts/eval_gemini.ts",
-    "count-tokens": "node --experimental-strip-types scripts/count_tokens.ts"
+    "gen": "npm run build && npm run docs:generate && npm run cli:generate && npm run update-metrics && npm run format",
+    "docs:generate": "node scripts/generate-docs.ts",
+    "start": "npm run build && node build/src/bin/opera-devtools-mcp.js",
+    "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/bin/opera-devtools-mcp.js",
+    "test": "npm run build && node scripts/test.js --test-skip-pattern=THIRD_PARTY_NOTICES",
+    "test:no-build": "node scripts/test.js --test-skip-pattern=THIRD_PARTY_NOTICES",
+    "test:notices": "npm run bundle && node scripts/test.js tests/third_party_notices.test.ts",
+    "test:notices:no-build": "node scripts/test.js tests/third_party_notices.test.ts",
+    "test:only": "npm run build && node scripts/test.js --test-only",
+    "test:update-snapshots": "npm run build && node scripts/test.js --test-update-snapshots",
+    "prepare": "node scripts/prepare.ts && node scripts/setup-intake.ts",
+    "sync": "npm ci && git submodule update --init",
+    "verify-upstream-seam": "node scripts/verify-upstream-seam.ts",
+    "verify-server-json-version": "node scripts/verify-server-json-version.ts",
+    "update-lighthouse": "node scripts/update-lighthouse.ts",
+    "update-metrics": "node scripts/update_metrics.ts",
+    "verify-npm-package": "node scripts/verify-npm-package.js",
+    "eval": "npm run build && node scripts/eval_gemini.ts",
+    "count-tokens": "node scripts/count_tokens.ts",
+    "profile": "npm run build && node scripts/profile/profile_mcp.ts",
+    "test:memory": "npm run build && node scripts/profile/profile_mcp.ts --threshold-percentage 1"
   },
   "files": [
     "build/src",
@@ -47,43 +53,47 @@
   "homepage": "https://github.com/operasoftware/opera-devtools-mcp#readme",
   "mcpName": "io.github.operasoftware/opera-devtools-mcp",
   "devDependencies": {
-    "@eslint/js": "^9.35.0",
+    "@blackwell-systems/gcf": "^2.2.2",
+    "@eslint/js": "^10.0.1",
     "@google/genai": "^2.0.1",
-    "@modelcontextprotocol/sdk": "1.29.0",
+    "@modelcontextprotocol/sdk": "1.30.0",
     "@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",
+    "@toon-format/toon": "^4.1.0",
     "@types/filesystem": "^0.0.36",
-    "@types/node": "^25.0.0",
+    "@types/node": "^26.0.0",
     "@types/semver": "^7.7.1",
-    "@types/sinon": "^21.0.0",
+    "@types/sinon": "^22.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.1628368",
     "core-js": "3.49.0",
-    "debug": "4.4.3",
-    "eslint": "^9.35.0",
+    "eslint": "^10.7.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^17.0.0",
-    "lighthouse": "13.3.0",
+    "lighthouse": "13.4.1",
     "prettier": "^3.6.2",
-    "puppeteer": "24.43.0",
-    "rollup": "4.60.3",
+    "puppeteer": "25.6.0",
+    "rollup": "4.62.4",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "semver": "^7.7.4",
     "sinon": "^22.0.0",
-    "tiktoken": "^1.0.22",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.43.0",
-    "urlpattern-polyfill": "^10.1.0",
-    "yargs": "18.0.0"
+    "yargs": "18.1.0",
+    "zod": "^3.25.76"
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=23"
+  },
+  "overrides": {
+    "eslint-plugin-import": {
+      "eslint": "$eslint"
+    },
+    "puppeteer-core": "$puppeteer"
   }
 }

package/build/src/DevToolsConnectionAdapter.js

@@ -1,70 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CDPSessionEvent } from './third_party/index.js';
-/**
- * This class makes a puppeteer connection look like DevTools CDPConnection.
- *
- * Since we connect "root" DevTools targets to specific pages, we scope everything to a puppeteer CDP session.
- *
- * We don't have to recursively listen for 'sessionattached' as the "root" CDP session sees all child session attached
- * events, regardless how deeply nested they are.
- */
-export class PuppeteerDevToolsConnection {
-    #connection;
-    #observers = new Set();
-    #sessionEventHandlers = new Map();
-    constructor(session) {
-        this.#connection = session.connection();
-        session.on(CDPSessionEvent.SessionAttached, this.#startForwardingCdpEvents.bind(this));
-        session.on(CDPSessionEvent.SessionDetached, this.#stopForwardingCdpEvents.bind(this));
-        this.#startForwardingCdpEvents(session);
-    }
-    send(method, params, sessionId) {
-        if (sessionId === undefined) {
-            throw new Error('Attempting to send on the root session. This must not happen');
-        }
-        const session = this.#connection.session(sessionId);
-        if (!session) {
-            throw new Error('Unknown session ' + sessionId);
-        }
-        // Rolled protocol version between puppeteer and DevTools doesn't necessarily match
-        /* eslint-disable @typescript-eslint/no-explicit-any */
-        return session
-            .send(method, params)
-            .then(result => ({ result }))
-            .catch(error => ({ error }));
-        /* eslint-enable @typescript-eslint/no-explicit-any */
-    }
-    observe(observer) {
-        this.#observers.add(observer);
-    }
-    unobserve(observer) {
-        this.#observers.delete(observer);
-    }
-    #startForwardingCdpEvents(session) {
-        const handler = this.#handleEvent.bind(this, session.id());
-        this.#sessionEventHandlers.set(session.id(), handler);
-        session.on('*', handler);
-    }
-    #stopForwardingCdpEvents(session) {
-        const handler = this.#sessionEventHandlers.get(session.id());
-        if (handler) {
-            session.off('*', handler);
-        }
-    }
-    #handleEvent(sessionId, type, event) {
-        if (typeof type === 'string' &&
-            type !== CDPSessionEvent.SessionAttached &&
-            type !== CDPSessionEvent.SessionDetached) {
-            this.#observers.forEach(observer => observer.onEvent({
-                method: type,
-                sessionId,
-                params: event,
-            }));
-        }
-    }
-}
-//# sourceMappingURL=DevToolsConnectionAdapter.js.map

package/build/src/HeapSnapshotManager.js

@@ -1,110 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import fsSync from 'node:fs';
-import path from 'node:path';
-import { DevTools } from './third_party/index.js';
-import { createIdGenerator, stableIdSymbol, } from './utils/id.js';
-export class HeapSnapshotManager {
-    #snapshots = new Map();
-    async getSnapshot(filePath) {
-        const absolutePath = path.resolve(filePath);
-        const cached = this.#snapshots.get(absolutePath);
-        if (cached) {
-            return cached.snapshot;
-        }
-        const { snapshot, worker } = await this.#loadSnapshot(absolutePath);
-        this.#snapshots.set(absolutePath, {
-            snapshot,
-            worker,
-            uidToClassKey: new Map(),
-            classKeyToUid: new Map(),
-            idGenerator: createIdGenerator(),
-        });
-        return snapshot;
-    }
-    async getAggregates(filePath) {
-        const snapshot = await this.getSnapshot(filePath);
-        const filter = new DevTools.HeapSnapshotModel.HeapSnapshotModel.NodeFilter();
-        const aggregates = await snapshot.aggregatesWithFilter(filter);
-        for (const key of Object.keys(aggregates)) {
-            const uid = await this.getOrCreateUidForClassKey(filePath, key);
-            const aggregate = aggregates[key];
-            if (aggregate) {
-                aggregate[stableIdSymbol] = uid;
-            }
-        }
-        return aggregates;
-    }
-    async getStats(filePath) {
-        const snapshot = await this.getSnapshot(filePath);
-        return await snapshot.getStatistics();
-    }
-    async getStaticData(filePath) {
-        const snapshot = await this.getSnapshot(filePath);
-        return snapshot.staticData;
-    }
-    async getOrCreateUidForClassKey(filePath, classKey) {
-        const cached = this.#getCachedSnapshot(filePath);
-        let uid = cached.classKeyToUid.get(classKey);
-        if (!uid) {
-            uid = cached.idGenerator();
-            cached.classKeyToUid.set(classKey, uid);
-            cached.uidToClassKey.set(uid, classKey);
-        }
-        return uid;
-    }
-    async getNodesByUid(filePath, uid) {
-        const snapshot = await this.getSnapshot(filePath);
-        const filter = new DevTools.HeapSnapshotModel.HeapSnapshotModel.NodeFilter();
-        const className = await this.resolveClassKeyFromUid(filePath, uid);
-        if (!className) {
-            throw new Error(`Class with UID ${uid} not found in heap snapshot`);
-        }
-        const provider = snapshot.createNodesProviderForClass(className, filter);
-        const range = await provider.serializeItemsRange(0, 1);
-        return await provider.serializeItemsRange(0, range.totalLength);
-    }
-    #getCachedSnapshot(filePath) {
-        const absolutePath = path.resolve(filePath);
-        const cached = this.#snapshots.get(absolutePath);
-        if (!cached) {
-            throw new Error(`Snapshot not loaded for ${filePath}`);
-        }
-        return cached;
-    }
-    async resolveClassKeyFromUid(filePath, uid) {
-        const cached = this.#getCachedSnapshot(filePath);
-        return cached.uidToClassKey.get(uid);
-    }
-    async #loadSnapshot(absolutePath) {
-        const workerProxy = new DevTools.HeapSnapshotModel.HeapSnapshotProxy.HeapSnapshotWorkerProxy(() => {
-            /* noop */
-        }, import.meta.resolve('./third_party/devtools-heap-snapshot-worker.js'));
-        const { promise: snapshotPromise, resolve: resolveSnapshot } = Promise.withResolvers();
-        const loaderProxy = workerProxy.createLoader(1, snapshotProxy => {
-            resolveSnapshot(snapshotProxy);
-        });
-        const fileStream = fsSync.createReadStream(absolutePath, {
-            encoding: 'utf-8',
-            highWaterMark: 1024 * 1024,
-        });
-        for await (const chunk of fileStream) {
-            await loaderProxy.write(chunk);
-        }
-        await loaderProxy.close();
-        const snapshot = await snapshotPromise;
-        return { snapshot, worker: workerProxy };
-    }
-    dispose(filePath) {
-        const absolutePath = path.resolve(filePath);
-        const cached = this.#snapshots.get(absolutePath);
-        if (cached) {
-            cached.worker.dispose();
-            this.#snapshots.delete(absolutePath);
-        }
-    }
-}
-//# sourceMappingURL=HeapSnapshotManager.js.map

package/build/src/Mutex.js

@@ -1,38 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google Inc.
- * SPDX-License-Identifier: Apache-2.0
- */
-export class Mutex {
-    static Guard = class Guard {
-        #mutex;
-        constructor(mutex) {
-            this.#mutex = mutex;
-        }
-        dispose() {
-            return this.#mutex.release();
-        }
-    };
-    #locked = false;
-    #acquirers = [];
-    // This is FIFO.
-    async acquire() {
-        if (!this.#locked) {
-            this.#locked = true;
-            return new Mutex.Guard(this);
-        }
-        const { resolve, promise } = Promise.withResolvers();
-        this.#acquirers.push(resolve);
-        await promise;
-        return new Mutex.Guard(this);
-    }
-    release() {
-        const resolve = this.#acquirers.shift();
-        if (!resolve) {
-            this.#locked = false;
-            return;
-        }
-        resolve();
-    }
-}
-//# sourceMappingURL=Mutex.js.map

package/build/src/WaitForHelper.js

@@ -1,195 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { logger } from './logger.js';
-export class WaitForHelper {
-    #abortController = new AbortController();
-    #page;
-    #stableDomTimeout;
-    #stableDomFor;
-    #expectNavigationIn;
-    #navigationTimeout;
-    constructor(page, cpuTimeoutMultiplier, networkTimeoutMultiplier) {
-        this.#stableDomTimeout = 3000 * cpuTimeoutMultiplier;
-        this.#stableDomFor = 100 * cpuTimeoutMultiplier;
-        this.#expectNavigationIn = 100 * cpuTimeoutMultiplier;
-        this.#navigationTimeout = 3000 * networkTimeoutMultiplier;
-        this.#page = page;
-    }
-    /**
-     * A wrapper that executes a action and waits for
-     * a potential navigation, after which it waits
-     * for the DOM to be stable before returning.
-     */
-    async waitForStableDom() {
-        const stableDomObserver = await this.#page.evaluateHandle(timeout => {
-            let timeoutId;
-            function callback() {
-                clearTimeout(timeoutId);
-                timeoutId = setTimeout(() => {
-                    domObserver.resolver.resolve();
-                    domObserver.observer.disconnect();
-                }, timeout);
-            }
-            const domObserver = {
-                resolver: Promise.withResolvers(),
-                observer: new MutationObserver(callback),
-            };
-            // It's possible that the DOM is not gonna change so we
-            // need to start the timeout initially.
-            callback();
-            domObserver.observer.observe(document.body, {
-                childList: true,
-                subtree: true,
-                attributes: true,
-            });
-            return domObserver;
-        }, this.#stableDomFor);
-        this.#abortController.signal.addEventListener('abort', async () => {
-            try {
-                await stableDomObserver.evaluate(observer => {
-                    observer.observer.disconnect();
-                    observer.resolver.resolve();
-                });
-                await stableDomObserver.dispose();
-            }
-            catch {
-                // Ignored cleanup errors
-            }
-        });
-        return Promise.race([
-            stableDomObserver.evaluate(async (observer) => {
-                return await observer.resolver.promise;
-            }),
-            this.timeout(this.#stableDomTimeout).then(() => {
-                throw new Error('Timeout');
-            }),
-        ]);
-    }
-    async waitForNavigationStarted() {
-        // Currently Puppeteer does not have API
-        // For when a navigation is about to start
-        const navigationStartedPromise = new Promise(resolve => {
-            const listener = (event) => {
-                if ([
-                    'historySameDocument',
-                    'historyDifferentDocument',
-                    'sameDocument',
-                ].includes(event.navigationType)) {
-                    resolve(false);
-                    return;
-                }
-                resolve(true);
-            };
-            this.#page._client().on('Page.frameStartedNavigating', listener);
-            this.#abortController.signal.addEventListener('abort', () => {
-                resolve(false);
-                this.#page._client().off('Page.frameStartedNavigating', listener);
-            });
-        });
-        return await Promise.race([
-            navigationStartedPromise,
-            this.timeout(this.#expectNavigationIn).then(() => false),
-        ]);
-    }
-    timeout(time) {
-        return new Promise(res => {
-            const id = setTimeout(res, time);
-            this.#abortController.signal.addEventListener('abort', () => {
-                res();
-                clearTimeout(id);
-            });
-        });
-    }
-    async waitForEventsAfterAction(action, options) {
-        let dialogOpened = false;
-        const dialogWatcher = () => {
-            dialogOpened = true;
-        };
-        this.#page.on('dialog', dialogWatcher);
-        if (options?.handleDialog) {
-            const dialogHandler = (dialog) => {
-                if (options.handleDialog === 'dismiss') {
-                    void dialog.dismiss();
-                }
-                else if (options.handleDialog === 'accept') {
-                    void dialog.accept();
-                }
-                else {
-                    void dialog.accept(options.handleDialog);
-                }
-            };
-            this.#page.on('dialog', dialogHandler);
-            this.#abortController.signal.addEventListener('abort', () => {
-                this.#page.off('dialog', dialogHandler);
-            });
-        }
-        this.#abortController.signal.addEventListener('abort', () => {
-            this.#page.off('dialog', dialogWatcher);
-        });
-        const urlBeforeAction = this.#page.url();
-        const navigationFinished = this.waitForNavigationStarted()
-            .then(navigationStated => {
-            if (navigationStated) {
-                return this.#page.waitForNavigation({
-                    timeout: options?.timeout ?? this.#navigationTimeout,
-                    signal: this.#abortController.signal,
-                });
-            }
-            return;
-        })
-            .catch(error => logger(error));
-        try {
-            await action();
-        }
-        catch (error) {
-            // Clear up pending promises
-            this.#abortController.abort();
-            throw error;
-        }
-        try {
-            await navigationFinished;
-            if (dialogOpened) {
-                return {};
-            }
-            // Wait for stable dom after navigation so we execute in
-            // the correct context. Skip if a dialog opened during the action
-            // since JS is paused and evaluateHandle would hang.
-            await this.waitForStableDom();
-        }
-        catch (error) {
-            logger(error);
-        }
-        finally {
-            this.#abortController.abort();
-        }
-        const urlAfterAction = this.#page.url();
-        return {
-            ...(urlAfterAction !== urlBeforeAction
-                ? { navigatedToUrl: urlAfterAction }
-                : {}),
-        };
-    }
-}
-export function appendWaitForResult(response, result) {
-    if (result.navigatedToUrl) {
-        response.appendResponseLine(`Page navigated to ${result.navigatedToUrl}.`);
-    }
-}
-export function getNetworkMultiplierFromString(condition) {
-    const puppeteerCondition = condition;
-    switch (puppeteerCondition) {
-        case 'Fast 4G':
-            return 1;
-        case 'Slow 4G':
-            return 2.5;
-        case 'Fast 3G':
-            return 5;
-        case 'Slow 3G':
-            return 10;
-    }
-    return 1;
-}
-//# sourceMappingURL=WaitForHelper.js.map