chore: try snapshot

Author: OrKoN

.prettierignore

@@ -1,2 +1,3 @@
 # Prettier-only ignores.
 CHANGELOG.md
+src/third_party/lighthouse-devtools-mcp-bundle.js

README.md

@@ -353,6 +353,8 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 
 <!-- BEGIN AUTO GENERATED TOOLS -->
 
+- **Audits** (1 tools)
+  - [`lighthouse_audit`](docs/tool-reference.md#lighthouse_audit)
 - **Input automation** (8 tools)
   - [`click`](docs/tool-reference.md#click)
   - [`drag`](docs/tool-reference.md#drag)

docs/tool-reference.md

@@ -2,6 +2,8 @@
 
 # Chrome DevTools MCP Tool Reference
 
+- **[Audits](#audits)** (1 tools)
+  - [`lighthouse_audit`](#lighthouse_audit)
 - **[Input automation](#input-automation)** (8 tools)
   - [`click`](#click)
   - [`drag`](#drag)
@@ -35,6 +37,22 @@
   - [`take_screenshot`](#take_screenshot)
   - [`take_snapshot`](#take_snapshot)
 
+## Audits
+
+### `lighthouse_audit`
+
+**Description:** Runs a Lighthouse audit on the currently selected page.
+
+**Parameters:**
+
+- **categories** (array) _(optional)_: The categories to audit. Defaults to all available categories.
+- **device** (enum: "desktop", "mobile") _(optional)_: The device to [`emulate`](#emulate). "desktop" is the default. "mobile" emulates a mobile device.
+- **formats** (array) _(optional)_: Report formats to produce.
+- **mode** (enum: "navigation", "snapshot") _(optional)_: The mode to run Lighthouse in. "navigation" is the default and will reload the current page. "snapshot" analyzes the page in its current state.
+- **outputDirPath** (string) _(optional)_: The directory to output the reports to. If not provided, temporary files will be created.
+
+---
+
 ## Input automation
 
 ### `click`

eslint.config.mjs

@@ -14,7 +14,11 @@ import tseslint from 'typescript-eslint';
 import localPlugin from './scripts/eslint_rules/local-plugin.js';
 
 export default defineConfig([
-  globalIgnores(['**/node_modules', '**/build/']),
+  globalIgnores([
+    '**/node_modules',
+    '**/build/',
+    'src/third_party/lighthouse-devtools-mcp-bundle.js',
+  ]),
   importPlugin.flatConfigs.typescript,
   {
     languageOptions: {

package-lock.json

@@ -22,6 +22,7 @@
     "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",
     "eval": "npm run build && CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS=true node --experimental-strip-types scripts/eval_gemini.ts",
     "count-tokens": "node --experimental-strip-types scripts/count_tokens.ts"
   },
@@ -61,7 +62,7 @@
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^17.0.0",
-    "lighthouse": "^13.0.1",
+    "lighthouse": "13.0.2",
     "prettier": "^3.6.2",
     "puppeteer": "24.37.2",
     "rollup": "4.57.1",

package.json

@@ -107,7 +107,8 @@ function listBundledDeps() {
           Object.entries(devDependencies).filter(
             ([name]) =>
               aggregatedStats.bundledPackages.has(name) ||
-              name === 'chrome-devtools-frontend',
+              name === 'chrome-devtools-frontend' ||
+              name === 'lighthouse',
           ),
         );
 
@@ -260,11 +261,15 @@ export default [
         return true;
       }
 
-      const existingExternals = ['./bidi.js', '../bidi/bidi.js'];
+      const existingExternals = [
+        './bidi.js',
+        '../bidi/bidi.js',
+        './lighthouse-devtools-mcp-bundle.js',
+      ];
+
       if (existingExternals.includes(source)) {
         return true;
       }
-
       return false;
     },
   ),

rollup.config.mjs

@@ -27,7 +27,9 @@ function removeConflictingGlobalDeclaration(): void {
     projectRoot,
     'node_modules/@paulirish/trace_engine/models/trace/ModelImpl.d.ts',
   );
-  console.log('Removing conflicting global declaration from @paulirish/trace_engine...');
+  console.log(
+    'Removing conflicting global declaration from @paulirish/trace_engine...',
+  );
   const content = readFileSync(filePath, 'utf-8');
   // Remove the declare global block using regex
   // Matches: declare global { ... interface HTMLElementEventMap { ... } ... }

scripts/prepare.ts

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {execSync} from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const ROOT_DIR = process.cwd();
+const LIGHTHOUSE_DIR = path.resolve(ROOT_DIR, '../lighthouse');
+const DEST_PATH = path.join(
+  ROOT_DIR,
+  'src/third_party/lighthouse-devtools-mcp-bundle.js',
+);
+
+function main() {
+  if (!fs.existsSync(LIGHTHOUSE_DIR)) {
+    console.error(`Lighthouse directory not found at ${LIGHTHOUSE_DIR}`);
+    process.exit(1);
+  }
+
+  console.log('Running yarn in lighthouse directory...');
+  execSync('yarn', {cwd: LIGHTHOUSE_DIR, stdio: 'inherit'});
+
+  console.log('Building lighthouse-devtools-mcp bundle...');
+  execSync('yarn build-devtools-mcp', {cwd: LIGHTHOUSE_DIR, stdio: 'inherit'});
+
+  // Look for the bundle in dist/ or root
+  const potentialPaths = [
+    path.join(LIGHTHOUSE_DIR, 'dist', 'lighthouse-devtools-mcp-bundle.js'),
+    path.join(LIGHTHOUSE_DIR, 'lighthouse-devtools-mcp-bundle.js'),
+  ];
+
+  let bundlePath = '';
+  for (const p of potentialPaths) {
+    if (fs.existsSync(p)) {
+      bundlePath = p;
+      break;
+    }
+  }
+
+  if (!bundlePath) {
+    console.error(
+      `Could not find built bundle. Checked:\n${potentialPaths.join('\n')}`,
+    );
+    process.exit(1);
+  }
+
+  console.log(`Copying bundle from ${bundlePath} to ${DEST_PATH}...`);
+  fs.copyFileSync(bundlePath, DEST_PATH);
+
+  console.log('Done.');
+}
+
+main();