opera-devtools-mcp 0.7.0 → 0.8.0

package/build/src/opera/webStorageWarning.js

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2026 Opera Norway AS. All rights reserved.
+ *
+ * This file is an original work developed by Opera.
+ */
+/**
+ * Node's Web Storage warning, and the one read of `localStorage` that provokes
+ * it.
+ *
+ * Node defines `localStorage` as a lazy global accessor. Reading it without
+ * `--localstorage-file` yields `undefined` and prints, once, to stderr:
+ *
+ *   ExperimentalWarning: localStorage is not available because
+ *   --localstorage-file was not provided.
+ *
+ * The bundled `debug` package reads it when it initializes
+ * (`node_modules/debug/src/browser.js` → `localstorage()`, reached through
+ * `lighthouse-logger` and `third_party/lighthouse-devtools-mcp-bundle.js`), and
+ * every entry point reaches that: the warning preceded a CLI command's own
+ * output, led the MCP server's stderr, and opened the daemon's log. The read
+ * only ever wants the "no storage here" answer its `try { return localStorage }
+ * catch {}` falls back to anyway; the warning is its entire effect.
+ *
+ * This module takes the accessor away first, replacing it with the `undefined`
+ * the read produces. It is deliberately neither `--disable-warning` nor
+ * `process.removeAllListeners('warning')`: those hide every experimental
+ * warning, including the ones worth reading, and the flag cannot reach a
+ * Windows `.cmd` shim or a plain `node build/…/bin.js`.
+ *
+ * The guard installs on import, so a process whose own imports load
+ * `third_party` first — the daemon — can preload this file instead; see
+ * `preloadWebStorageWarningGuardInChildren`.
+ */
+import fs from 'node:fs';
+import process from 'node:process';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+/**
+ * Removes the accessor, so the read becomes the `undefined` it already fell back
+ * to and prints nothing.
+ *
+ * Nothing happens on a Node without the accessor, or when the process was told
+ * where to keep Web Storage: `--localstorage-file` is the whole of the opt-in,
+ * and with it the getter hands back a real `Storage` that must survive.
+ */
+function installWebStorageWarningGuard() {
+    const descriptor = Object.getOwnPropertyDescriptor(globalThis, 'localStorage');
+    // `--localstorage-file` can arrive as a Node flag or through NODE_OPTIONS,
+    // which the daemon inherits from this process.
+    const configured = [
+        ...process.execArgv,
+        ...(process.env.NODE_OPTIONS?.split(/\s+/) ?? []),
+    ].some(arg => arg === '--localstorage-file' || arg.startsWith('--localstorage-file='));
+    // No accessor — older Node, or Web Storage not exposed at all — leaves
+    // nothing to do. A second call lands here too: the install below replaces the
+    // accessor with a plain value, so the `get` is gone.
+    if (!descriptor?.get || configured) {
+        return;
+    }
+    Object.defineProperty(globalThis, 'localStorage', {
+        value: undefined,
+        configurable: true,
+        writable: true,
+    });
+}
+installWebStorageWarningGuard();
+/**
+ * Hand the guard to every Node child this process spawns, by preloading it
+ * through `NODE_OPTIONS`.
+ *
+ * The daemon is the child that needs it: `src/daemon/daemon.ts` reaches
+ * `third_party/index.ts` through its own static imports, so no module of ours
+ * can run first in that process — only a `--import` preload can. The daemon
+ * passes its environment on to the MCP server it supervises, so one call at the
+ * CLI's entry point covers both.
+ *
+ * A guard file that is not there is not a reason to fail a spawn: this removes
+ * a warning, and a preload that cannot be resolved would abort the child.
+ */
+export function preloadWebStorageWarningGuardInChildren() {
+    const guardFile = fileURLToPath(new URL('./webStorageWarning.js', import.meta.url));
+    if (!fs.existsSync(guardFile)) {
+        return;
+    }
+    const option = `--import=${pathToFileURL(guardFile).href}`;
+    const current = process.env.NODE_OPTIONS?.trim();
+    if (current?.includes(option)) {
+        return;
+    }
+    process.env.NODE_OPTIONS = current ? `${current} ${option}` : option;
+}
+//# sourceMappingURL=webStorageWarning.js.map

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

@@ -15361,3 +15361,4 @@ HOST_RUNTIME.workerScope.onmessage = function (event) {
     }
 };
 HOST_RUNTIME.workerScope.postMessage('workerReady');
+//# sourceMappingURL=devtools-formatter-worker.js.map

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

@@ -10416,3 +10416,4 @@ class HeapSnapshotWorkerDispatcher {
 const dispatcher = new HeapSnapshotWorkerDispatcher(HOST_RUNTIME.workerScope.postMessage.bind(HOST_RUNTIME.workerScope));
 HOST_RUNTIME.workerScope.onmessage = dispatcher.dispatchMessage.bind(dispatcher);
 HOST_RUNTIME.workerScope.postMessage('workerReady');
+//# sourceMappingURL=devtools-heap-snapshot-worker.js.map

package/build/src/third_party/index.js

@@ -181165,4 +181165,5 @@ const snapshot = snapshot$1;
 const navigation = navigation$1;
 const generateReport = generateReport$1;
 
-export { AsyncDisposableStack, Browser as BrowserEnum, CDPSessionEvent, CdpPage, Client, mcp as DevTools, DisposableStack, KnownDevices, ListRootsRequestSchema, ListRootsResultSchema, Locator, McpServer, Mutex$2 as Mutex, PipeTransport, PredefinedNetworkConditions, RootsListChangedNotificationSchema, ScreenRecorder, SetLevelRequestSchema, StdioClientTransport, StdioServerTransport, SuppressedError$1 as SuppressedError, ajv, detectBrowserPlatform, generateReport, getGcfEncode, getToonEncode, hideBin, navigation, puppeteer, resolveDefaultUserDataDir, index as semver, snapshot, Yargs as yargs, z$2 as zod };
+export { AsyncDisposableStack, Browser as BrowserEnum, CDPSessionEvent, CdpPage, Client, ConnectionClosedError, mcp as DevTools, DisposableStack, KnownDevices, ListRootsRequestSchema, ListRootsResultSchema, Locator, LoggingMessageNotificationSchema, McpServer, Mutex$2 as Mutex, PipeTransport, PredefinedNetworkConditions, RootsListChangedNotificationSchema, ScreenRecorder, SetLevelRequestSchema, StdioClientTransport, StdioServerTransport, SuppressedError$1 as SuppressedError, TargetCloseError, ajv, detectBrowserPlatform, generateReport, getGcfEncode, getToonEncode, hideBin, navigation, puppeteer, resolveDefaultUserDataDir, index as semver, snapshot, Yargs as yargs, z$2 as zod };
+//# sourceMappingURL=index.js.map

package/build/src/utils/url.js

@@ -3,6 +3,7 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { isOperaStartPage } from '../opera/operaPages.js';
 const ALLOWED_PROTOCOLS = new Set(['http:', 'https:', 'ws:', 'wss:']);
 const IPV4_LOOPBACK_REGEX = /^127(?:\.(?:25[0-5]|2[0-4]\d|[01]?\d\d?)){3}$/;
 /**
@@ -72,6 +73,11 @@ export function isAllowedUrl(url, options) {
                 path.startsWith('inspect'))) {
             return true;
         }
+        // Opera's start page, which is where every tab the user opens by hand
+        // begins; see `opera/operaPages.ts` for why it cannot be filtered out.
+        if (isOperaStartPage(parsed)) {
+            return true;
+        }
     }
     if (parsed.protocol === 'chrome:' ||
         parsed.protocol === 'chrome-untrusted:') {

package/build/src/version.js

@@ -5,5 +5,5 @@
  *
  * Modified by Opera Software AS.
  */
-export const VERSION = '0.7.0';
+export const VERSION = '0.8.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "opera-devtools-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MCP server for Opera DevTools",
   "type": "module",
   "bin": {
-    "opera-devtools-mcp": "./build/src/bin/opera-devtools-mcp.js",
-    "opera-devtools": "./build/src/bin/opera-devtools.js"
+    "opera-devtools-mcp": "./build/src/bin/opera-devtools-mcp.js"
   },
   "main": "./build/src/index.js",
   "scripts": {
@@ -13,10 +12,13 @@
     "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
     "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",
+    "prepublishOnly": "npm run bundle",
     "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-metrics && npm run format",
+    "link": "node scripts/link.ts",
+    "link:cli": "node scripts/link.ts --with-cli",
     "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",
@@ -35,7 +37,9 @@
     "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"
+    "test:memory": "npm run build && node scripts/profile/profile_mcp.ts --threshold-percentage 1",
+    "test:stress": "npm run build && STRESS_ALLOW_PROCESS_KILLS=true node --import ./build/tests/setup.js --test --test-force-exit --test-timeout=600000 build/tests/stress/runner.test.js",
+    "test:stress:docker": "node scripts/stress-docker.js"
   },
   "files": [
     "build/src",
@@ -51,6 +55,9 @@
   },
   "homepage": "https://github.com/operasoftware/opera-devtools-mcp#readme",
   "mcpName": "io.github.operasoftware/opera-devtools-mcp",
+  "dependencies": {
+    "@toon-format/toon": "^4.1.0"
+  },
   "devDependencies": {
     "@blackwell-systems/gcf": "^2.2.2",
     "@eslint/js": "^10.0.1",
@@ -60,7 +67,6 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@stylistic/eslint-plugin": "^5.4.0",
-    "@toon-format/toon": "^4.1.0",
     "@types/filesystem": "^0.0.36",
     "@types/node": "^26.0.0",
     "@types/semver": "^7.7.1",
@@ -87,13 +93,9 @@
     "zod": "^3.25.76"
   },
   "peerDependencies": {
-    "@blackwell-systems/gcf": "^2.2.2",
-    "@toon-format/toon": "^4.1.0"
+    "@blackwell-systems/gcf": "^2.2.2"
   },
   "peerDependenciesMeta": {
-    "@toon-format/toon": {
-      "optional": true
-    },
     "@blackwell-systems/gcf": {
       "optional": true
     }

package/build/src/bin/opera-devtools.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-/**
- * @license
- * Copyright 2026 Opera Software AS.
- * SPDX-License-Identifier: Apache-2.0
- */
-// Opera-named bin entry (see `package.json` `bin`). The implementation lives in
-// the upstream-owned file and is branded via `src/opera/branding.ts`.
-import './chrome-devtools.js';
-//# sourceMappingURL=opera-devtools.js.map