lighthouse 13.0.3 → 13.2.0

package/CONTRIBUTING.md

@@ -8,7 +8,7 @@ We tag issues that are good candidates for those new to the code with [`good fir
 
 ## Follow the coding style
 
-The `.eslintrc.cjs` file defines all. We use [JSDoc](http://usejsdoc.org/) with [TypeScript `checkJs`](https://www.typescriptlang.org/docs/handbook/type-checking-javascript-files.html#supported-jsdoc). Annotations are encouraged for all contributions.
+The `.eslintrc.cjs` file defines all. We use [JSDoc](https://jsdoc.app/) with [TypeScript `checkJs`](https://www.typescriptlang.org/docs/handbook/type-checking-javascript-files.html#supported-jsdoc). Annotations are encouraged for all contributions.
 
 ## Learn about the architecture
 

package/cli/bin.js

@@ -107,6 +107,11 @@ async function begin() {
     cliFlags.precomputedLanternData = data;
   }
 
+  if (!Array.isArray(cliFlags.chromeFlags)) {
+    cliFlags.chromeFlags = [cliFlags.chromeFlags];
+  }
+  cliFlags.chromeFlags.push('--enable-features=DevToolsWebMCPSupport');
+
   // By default, cliFlags.enableErrorReporting is undefined so the user is
   // prompted. This can be overridden with an explicit flag or by the cached
   // answer returned by askPermission().

package/cli/test/smokehouse/__snapshots__/report-assert-test.js.snap

@@ -3,7 +3,7 @@
 exports[`getAssertionReport works (multiple failing) 1`] = `
 "X difference at cumulative-layout-shift audit.details.items.length
               expected: []
-                 found: [{\\"cumulativeLayoutShiftMainFrame\\":0.09957584751767748,\\"newEngineResult\\":{\\"cumulativeLayoutShift\\":0.09957584751767748,\\"cumulativeLayoutShiftMainFrame\\":0.09957584751767748},\\"newEngineResultDiffered\\":false}]
+                 found: [{\\"cumulativeLayoutShiftMainFrame\\":0.099576,\\"newEngineResult\\":{\\"cumulativeLayoutShift\\":0.099576,\\"cumulativeLayoutShiftMainFrame\\":0.099576},\\"newEngineResultDiffered\\":false}]
 
 
   X difference at cumulative-layout-shift audit.details.blah
@@ -17,7 +17,7 @@ exports[`getAssertionReport works (multiple failing) 1`] = `
         \\"description\\": \\"Cumulative Layout Shift measures the movement of visible elements within the viewport. [Learn more about the Cumulative Layout Shift metric](https://web.dev/articles/cls).\\",
         \\"score\\": 0.9,
         \\"scoreDisplayMode\\": \\"numeric\\",
-        \\"numericValue\\": 0.09957584751767748,
+        \\"numericValue\\": 0.099576,
         \\"numericUnit\\": \\"unitless\\",
         \\"displayValue\\": \\"0.1\\",
         \\"scoringOptions\\": {
@@ -28,10 +28,10 @@ exports[`getAssertionReport works (multiple failing) 1`] = `
           \\"type\\": \\"debugdata\\",
           \\"items\\": [
             {
-              \\"cumulativeLayoutShiftMainFrame\\": 0.09957584751767748,
+              \\"cumulativeLayoutShiftMainFrame\\": 0.099576,
               \\"newEngineResult\\": {
-                \\"cumulativeLayoutShift\\": 0.09957584751767748,
-                \\"cumulativeLayoutShiftMainFrame\\": 0.09957584751767748
+                \\"cumulativeLayoutShift\\": 0.099576,
+                \\"cumulativeLayoutShiftMainFrame\\": 0.099576
               },
               \\"newEngineResultDiffered\\": false
             }
@@ -43,7 +43,7 @@ exports[`getAssertionReport works (multiple failing) 1`] = `
 exports[`getAssertionReport works (trivial failing) 1`] = `
 "X difference at cumulative-layout-shift audit.details.items.length
               expected: []
-                 found: [{\\"cumulativeLayoutShiftMainFrame\\":0.09957584751767748,\\"newEngineResult\\":{\\"cumulativeLayoutShift\\":0.09957584751767748,\\"cumulativeLayoutShiftMainFrame\\":0.09957584751767748},\\"newEngineResultDiffered\\":false}]
+                 found: [{\\"cumulativeLayoutShiftMainFrame\\":0.099576,\\"newEngineResult\\":{\\"cumulativeLayoutShift\\":0.099576,\\"cumulativeLayoutShiftMainFrame\\":0.099576},\\"newEngineResultDiffered\\":false}]
 
           found result:
       {
@@ -52,7 +52,7 @@ exports[`getAssertionReport works (trivial failing) 1`] = `
         \\"description\\": \\"Cumulative Layout Shift measures the movement of visible elements within the viewport. [Learn more about the Cumulative Layout Shift metric](https://web.dev/articles/cls).\\",
         \\"score\\": 0.9,
         \\"scoreDisplayMode\\": \\"numeric\\",
-        \\"numericValue\\": 0.09957584751767748,
+        \\"numericValue\\": 0.099576,
         \\"numericUnit\\": \\"unitless\\",
         \\"displayValue\\": \\"0.1\\",
         \\"scoringOptions\\": {
@@ -63,10 +63,10 @@ exports[`getAssertionReport works (trivial failing) 1`] = `
           \\"type\\": \\"debugdata\\",
           \\"items\\": [
             {
-              \\"cumulativeLayoutShiftMainFrame\\": 0.09957584751767748,
+              \\"cumulativeLayoutShiftMainFrame\\": 0.099576,
               \\"newEngineResult\\": {
-                \\"cumulativeLayoutShift\\": 0.09957584751767748,
-                \\"cumulativeLayoutShiftMainFrame\\": 0.09957584751767748
+                \\"cumulativeLayoutShift\\": 0.099576,
+                \\"cumulativeLayoutShiftMainFrame\\": 0.099576
               },
               \\"newEngineResultDiffered\\": false
             }

package/cli/test/smokehouse/config/exclusions.js

@@ -31,6 +31,50 @@ const exclusions = {
     // Disabled because is timing out.
     'oopif-scripts',
   ],
+  'devtools-mcp': [
+    // Disabled because performance tracing related audits are not supported.
+    'byte-efficiency',
+    'byte-gzip',
+    'dbw',
+    'errors-expired-ssl',
+    'errors-iframe-expired-ssl',
+    'errors-infinite-loop',
+    'forms-autocomplete',
+    'fps-max-passive',
+    'fps-max',
+    'fps-overflow-x',
+    'lantern-fetch',
+    'lantern-idle-callback-long',
+    'lantern-idle-callback-short',
+    'lantern-online',
+    'lantern-set-timeout',
+    'lantern-xhr',
+    'legacy-javascript',
+    'metrics-debugger',
+    'metrics-delayed-fcp',
+    'metrics-delayed-lcp',
+    'metrics-tricky-tti-late-fcp',
+    'metrics-tricky-tti',
+    'oopif-requests',
+    'oopif-scripts',
+    'perf-debug',
+    'perf-diagnostics-animations',
+    'perf-diagnostics-unsized-images',
+    'perf-fonts',
+    'perf-frame-metrics',
+    'perf-preload',
+    'perf-trace-elements',
+    'redirects-client-paint-server',
+    'redirects-history-push-state',
+    'redirects-multiple-server',
+    'redirects-scripts',
+    'redirects-single-client',
+    'redirects-single-server',
+    'screenshot',
+    'shift-attribution',
+    'source-maps',
+    'timing',
+  ],
 };
 
 for (const array of Object.values(exclusions)) {

package/cli/test/smokehouse/frontends/smokehouse-bin.js

@@ -33,9 +33,10 @@ const coreTestDefnsPath =
  * contingent on having built all the bundles.
  */
 const runnerPaths = {
-  cli: '../lighthouse-runners/cli.js',
-  bundle: '../lighthouse-runners/bundle.js',
-  devtools: '../lighthouse-runners/devtools.js',
+  'cli': '../lighthouse-runners/cli.js',
+  'bundle': '../lighthouse-runners/bundle.js',
+  'devtools': '../lighthouse-runners/devtools.js',
+  'devtools-mcp': '../lighthouse-runners/devtools-mcp.js',
 };
 
 /**
@@ -146,7 +147,7 @@ async function begin() {
       },
       'runner': {
         default: 'cli',
-        choices: ['cli', 'bundle', 'devtools'],
+        choices: ['cli', 'bundle', 'devtools', 'devtools-mcp'],
         describe: 'The method of running Lighthouse',
       },
       'tests-path': {

package/cli/test/smokehouse/lighthouse-runners/devtools-mcp.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Launch Chrome and do a full Lighthouse run via the Lighthouse DevTools MCP bundle.
+ * @param {string} url
+ * @param {LH.Config=} config
+ * @param {LocalConsole=} logger
+ * @param {Smokehouse.SmokehouseOptions['testRunnerOptions']=} testRunnerOptions
+ * @return {Promise<{lhr: LH.Result, artifacts: LH.Artifacts}>}
+ */
+export function runLighthouse(url: string, config?: LH.Config | undefined, logger?: LocalConsole | undefined, testRunnerOptions?: Smokehouse.SmokehouseOptions["testRunnerOptions"] | undefined): Promise<{
+    lhr: LH.Result;
+    artifacts: LH.Artifacts;
+}>;
+import { LocalConsole } from '../lib/local-console.js';
+//# sourceMappingURL=devtools-mcp.d.ts.map

package/cli/test/smokehouse/lighthouse-runners/devtools-mcp.js

@@ -0,0 +1,141 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview A runner that launches Chrome and executes Lighthouse via the
+ * DevTools MCP bundle.
+ */
+
+import fs from 'fs';
+import os from 'os';
+import {Worker, isMainThread, parentPort, workerData} from 'worker_threads';
+import {once} from 'events';
+
+import puppeteer from 'puppeteer-core';
+import * as ChromeLauncher from 'chrome-launcher';
+
+import {LH_ROOT} from '../../../../shared/root.js';
+import {loadArtifacts, saveArtifacts} from '../../../../core/lib/asset-saver.js';
+import {LocalConsole} from '../lib/local-console.js';
+
+// This runs only in the worker. The rest runs on the main thread.
+if (!isMainThread && parentPort) {
+  (async () => {
+    const {url, config, testRunnerOptions} = workerData;
+    try {
+      const result = await runBundledLighthouse(url, config, testRunnerOptions);
+      // Save to assets directory because LighthouseError won't survive postMessage.
+      const assetsDir = fs.mkdtempSync(os.tmpdir() + '/smoke-mcp-assets-');
+      await saveArtifacts(result.artifacts, assetsDir);
+      const value = {
+        lhr: result.lhr,
+        assetsDir,
+      };
+      parentPort?.postMessage({type: 'result', value});
+    } catch (err) {
+      console.error(err);
+      parentPort?.postMessage({type: 'error', value: err.toString()});
+    }
+  })();
+}
+
+/**
+ * @param {string} url
+ * @param {LH.Config|undefined} config
+ * @param {Smokehouse.SmokehouseOptions['testRunnerOptions']} testRunnerOptions
+ * @return {Promise<{lhr: LH.Result, artifacts: LH.Artifacts}>}
+ */
+async function runBundledLighthouse(url, config, testRunnerOptions) {
+  if (isMainThread || !parentPort) {
+    throw new Error('must be called in worker');
+  }
+
+  // Load bundle.
+  const {navigation} = await import(LH_ROOT + '/dist/lighthouse-devtools-mcp-bundle.js');
+
+  // Launch and connect to Chrome.
+  const launchedChrome = await ChromeLauncher.launch({
+    chromeFlags: [
+      testRunnerOptions?.headless ? '--headless=new' : '',
+    ],
+  });
+  const port = launchedChrome.port;
+
+  // Run Lighthouse.
+  try {
+    const logLevel = testRunnerOptions?.isDebug ? 'verbose' : 'info';
+
+    // Puppeteer is not included in the bundle, we must create the page here.
+    const browser = await puppeteer.connect({browserURL: `http://127.0.0.1:${port}`});
+    const page = await browser.newPage();
+
+    // navigation(page, requestor, options)
+    const runnerResult = await navigation(page, url, {config, flags: {port, logLevel}});
+
+    if (!runnerResult) throw new Error('No runnerResult');
+
+    return {
+      lhr: runnerResult.lhr,
+      artifacts: runnerResult.artifacts,
+    };
+  } finally {
+    // Clean up and return results.
+    launchedChrome.kill();
+  }
+}
+
+/**
+ * Launch Chrome and do a full Lighthouse run via the Lighthouse DevTools MCP bundle.
+ * @param {string} url
+ * @param {LH.Config=} config
+ * @param {LocalConsole=} logger
+ * @param {Smokehouse.SmokehouseOptions['testRunnerOptions']=} testRunnerOptions
+ * @return {Promise<{lhr: LH.Result, artifacts: LH.Artifacts}>}
+ */
+async function runLighthouse(url, config, logger, testRunnerOptions = {}) {
+  logger = logger || new LocalConsole();
+
+  const worker = new Worker(new URL(import.meta.url), {
+    stdout: true,
+    stderr: true,
+    workerData: {url, config, testRunnerOptions},
+  });
+  worker.stdout.setEncoding('utf8');
+  worker.stderr.setEncoding('utf8');
+  worker.stdout.addListener('data', (data) => {
+    logger.log(`[STDOUT] ${data}`);
+  });
+  worker.stderr.addListener('data', (data) => {
+    logger.log(`[STDERR] ${data}`);
+  });
+  const [workerResponse] = await once(worker, 'message');
+
+  if (workerResponse.type === 'error') {
+    const log = logger.getLog();
+    throw new Error(`Worker returned an error: ${workerResponse.value}
+Log:
+${log}
+`);
+  }
+
+  const result = workerResponse.value;
+  if (!result.lhr || !result.assetsDir) {
+    throw new Error(`invalid response from worker:
+${JSON.stringify(result, null, 2)}`);
+  }
+
+  const artifacts = loadArtifacts(result.assetsDir);
+  fs.rmSync(result.assetsDir, {recursive: true});
+
+  return {
+    lhr: result.lhr,
+    artifacts,
+  };
+}
+
+export {
+  runLighthouse,
+};

package/core/audits/accessibility/autocomplete-valid.d.ts

@@ -0,0 +1,10 @@
+export default AutocompleteValid;
+declare class AutocompleteValid extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=autocomplete-valid.d.ts.map

package/core/audits/accessibility/autocomplete-valid.js

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures the autocomplete attribute is correct and suitable for the form field.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if all form fields have valid autocomplete attributes. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: '`autocomplete` attributes are used correctly',
+  /** Title of an accessibility audit that evaluates if all form fields have valid autocomplete attributes. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: '`autocomplete` attributes are not used correctly',
+  /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
+  description: 'The `autocomplete` attribute values must be valid and correctly applied for ' +
+      'screen readers to function correctly. ' +
+      '[Learn more about valid autocomplete values](https://dequeuniversity.com/rules/axe/4.11/autocomplete-valid).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class AutocompleteValid extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'autocomplete-valid',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default AutocompleteValid;
+export {UIStrings};

package/core/audits/accessibility/presentation-role-conflict.d.ts

@@ -0,0 +1,10 @@
+export default PresentationRoleConflict;
+declare class PresentationRoleConflict extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=presentation-role-conflict.d.ts.map

package/core/audits/accessibility/presentation-role-conflict.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures elements which are marked to be removed from the accessibility tree are in fact removed.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if elements with presentation role have conflicts. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: 'Elements with `role="none"` or `role="presentation"` do not have conflicts',
+  /** Title of an accessibility audit that evaluates if elements with presentation role have conflicts. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: 'Elements with `role="none"` or `role="presentation"` have conflicts',
+  /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with \'Learn\' becomes link text to additional documentation. */
+  description: 'There are certain cases where the semantic role of an element with `role="none"` ' +
+      'or `role="presentation"` does not resolve to none or presentation. To ensure the ' +
+      'element remains removed from the accessibility tree, you should not add any global ' +
+      'ARIA attributes to the element or make it focusable. ' +
+      '[Learn more about presentation role conflict](https://dequeuniversity.com/rules/axe/4.11/presentation-role-conflict).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class PresentationRoleConflict extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'presentation-role-conflict',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default PresentationRoleConflict;
+export {UIStrings};

package/core/audits/accessibility/svg-img-alt.d.ts

@@ -0,0 +1,10 @@
+export default SvgImgAlt;
+declare class SvgImgAlt extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=svg-img-alt.d.ts.map

package/core/audits/accessibility/svg-img-alt.js

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures SVG elements with an img role have an accessible text alternative.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if SVG elements with an img role have an accessible text alternative. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: 'SVG elements with an `img` role have an accessible text alternative',
+  /** Title of an accessibility audit that evaluates if SVG elements with an img role have an accessible text alternative. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: 'SVG elements with an `img` role do not have an accessible text alternative',
+  /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with \'Learn\' becomes link text to additional documentation. */
+  description: 'Ensures SVG elements with an `img`, `graphics-document` or `graphics-symbol` ' +
+      'role have an accessible text alternative. ' +
+      '[Learn more about SVG alt text](https://dequeuniversity.com/rules/axe/4.11/svg-img-alt).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class SvgImgAlt extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'svg-img-alt',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default SvgImgAlt;
+export {UIStrings};

package/core/audits/agentic/agent-accessibility-tree.d.ts

@@ -0,0 +1,19 @@
+export default AgentAccessibilityTree;
+declare class AgentAccessibilityTree extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Audit.Product}
+     */
+    static audit(artifacts: LH.Artifacts): LH.Audit.Product;
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+    let columnRule: string;
+    let columnElement: string;
+    let failedSectionTitle: string;
+    let displayValuePassed: string;
+}
+import { Audit } from '../audit.js';
+//# sourceMappingURL=agent-accessibility-tree.d.ts.map

package/core/audits/agentic/agent-accessibility-tree.js

@@ -0,0 +1,115 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {Audit} from '../audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title shown when all agent accessibility checks pass. */
+  title: 'Accessibility tree is well-formed',
+  /** Title shown when one or more agent accessibility checks fail. */
+  failureTitle: 'Accessibility tree is not well-formed',
+  /** Description of a Lighthouse audit that tells the user *why* they need a well-formed accessibility tree. */
+  description: 'A well-formed accessibility tree helps AI agents to ' +
+    'navigate and interact with the page.',
+  /** Label of a table column that identifies the accessibility rule that failed. */
+  columnRule: 'Failing Rule',
+  /** Label of a table column that identifies the HTML element that failed the rule. */
+  columnElement: 'Failing Element',
+  /** Title of the section containing failed accessibility checks. */
+  failedSectionTitle: 'Failed Audits',
+  /** Message shown when all accessibility checks pass. */
+  displayValuePassed: 'All audits passed',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+const TARGET_RULES = new Set([
+  'button-name',
+  'input-button-name',
+  'input-image-alt',
+  'label',
+  'link-name',
+  'select-name',
+  'document-title',
+  'aria-allowed-attr',
+  'aria-allowed-role',
+  'aria-command-name',
+  'aria-conditional-attr',
+  'aria-dialog-name',
+  'aria-hidden-body',
+  'aria-hidden-focus',
+  'aria-input-field-name',
+  'aria-prohibited-attr',
+  'aria-required-attr',
+  'aria-required-children',
+  'aria-required-parent',
+  'aria-roles',
+  'aria-text',
+  'aria-toggle-field-name',
+  'aria-tooltip-name',
+  'aria-treeitem-name',
+  'aria-valid-attr',
+  'aria-valid-attr-value',
+  'duplicate-id-aria',
+  'definition-list',
+  'table-duplicate-name',
+  'tabindex',
+  'autocomplete-valid',
+  'presentation-role-conflict',
+  'svg-img-alt',
+]);
+
+class AgentAccessibilityTree extends Audit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'agent-accessibility-tree',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+
+  /**
+   * @param {LH.Artifacts} artifacts
+   * @return {LH.Audit.Product}
+   */
+  static audit(artifacts) {
+    const violations = (artifacts.Accessibility && artifacts.Accessibility.violations) || [];
+    const failedRules = violations.filter(v => TARGET_RULES.has(v.id));
+
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      {key: 'description', valueType: 'text', label: str_(i18n.UIStrings.columnDescription)},
+      {key: 'node', valueType: 'node', label: str_(UIStrings.columnElement)},
+    ];
+
+    const items = failedRules.map(rule => ({
+      description: rule.help || rule.description,
+      node: rule.nodes?.[0] ? Audit.makeNodeItem(rule.nodes[0].node) : undefined,
+    }));
+
+    const listItems = [];
+
+    if (items.length > 0) {
+      const table = Audit.makeTableDetails(headings, items);
+      listItems.push(Audit.makeListDetailSectionItem(table, str_(UIStrings.failedSectionTitle)));
+    }
+
+    return {
+      score: Number(items.length === 0),
+      details: listItems.length > 0 ? Audit.makeListDetails(listItems) : undefined,
+      displayValue: items.length === 0 ? str_(UIStrings.displayValuePassed) : undefined,
+    };
+  }
+}
+
+export default AgentAccessibilityTree;
+export {UIStrings};

package/core/audits/agentic/llms-txt.d.ts

@@ -0,0 +1,20 @@
+export default LlmsTxt;
+declare class LlmsTxt extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Audit.Product}
+     */
+    static audit(artifacts: LH.Artifacts): LH.Audit.Product;
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+    let displayValueHttpBadCode: string;
+    let explanation: string;
+    let missingH1: string;
+    let tooShort: string;
+    let missingLinks: string;
+}
+import { Audit } from '../audit.js';
+//# sourceMappingURL=llms-txt.d.ts.map