Lighthouse: change auditing message when AI is running

This CL updates the Lighthouse status view so that we can show a custom
string when AI is running LH vs the user is, so the dialog is less
confusing.

It also adds some tests to the status view for the header; the tests
aren't perfect because the StatusView is not a proper UI Eng widget, but
they are better than none and cover the new header text changes.

Bug: 489620101
Change-Id: I93b603607718b4ca17807fba60a9b3d88b36e032
Reviewed-on: https://chromium-review.googlesource.com/c/devtools/devtools-frontend/+/7673381
Auto-Submit: Jack Franklin <[email protected]>
Reviewed-by: Kim-Anh Tran <[email protected]>
Commit-Queue: Kim-Anh Tran <[email protected]>

Author: jackfranklin

front_end/models/lighthouse/RunTypes.ts

@@ -38,4 +38,5 @@ export interface Flags {
 
 export interface RunOverrides {
   categoryIds: CategoryId[];
+  isAIControlled?: boolean;
 }

front_end/panels/lighthouse/BUILD.gn

@@ -95,6 +95,7 @@ devtools_ui_module("unittests") {
     "LighthouseProtocolService.test.ts",
     "LighthouseReportRenderer.test.ts",
     "LighthouseStartView.test.ts",
+    "LighthouseStatusView.test.ts",
     "LighthouseTimespanView.test.ts",
     "RadioSetting.test.ts",
   ]

front_end/panels/lighthouse/LighthouseController.ts

@@ -191,6 +191,7 @@ class LighthouseRun {
     formFactor: (string|undefined),
     mode: string,
   };
+  readonly isAIControlled: boolean;
   private emulationStateBefore?: {
     emulation: {
       type: EmulationModel.DeviceModeModel.Type,
@@ -209,12 +210,13 @@ class LighthouseRun {
 
   constructor(
       controller: LighthouseController, protocolService: ProtocolService, inspectedURL: Platform.DevToolsPath.UrlString,
-      categoryIDs: string[], flags: {formFactor: (string|undefined), mode: string}) {
+      categoryIDs: string[], flags: {formFactor: (string|undefined), mode: string}, isAIControlled: boolean) {
     this.controller = controller;
     this.protocolService = protocolService;
     this.inspectedURL = inspectedURL;
     this.categoryIDs = categoryIDs;
     this.flags = flags;
+    this.isAIControlled = isAIControlled;
     this.#isRunning = false;
   }
 
@@ -550,6 +552,7 @@ export class LighthouseController extends Common.ObjectWrapper.ObjectWrapper<Eve
       inspectedURL: this.currentLighthouseRun.inspectedURL,
       categoryIDs: this.currentLighthouseRun.categoryIDs,
       flags: this.currentLighthouseRun.flags,
+      isAIControlled: this.currentLighthouseRun.isAIControlled,
     };
   }
 
@@ -661,7 +664,8 @@ export class LighthouseController extends Common.ObjectWrapper.ObjectWrapper<Eve
 
       this.recordMetrics(flags, categoryIDs);
 
-      this.currentLighthouseRun = new LighthouseRun(this, this.protocolService, inspectedURL, categoryIDs, flags);
+      this.currentLighthouseRun = new LighthouseRun(
+          this, this.protocolService, inspectedURL, categoryIDs, flags, Boolean(overrides?.isAIControlled));
       await this.currentLighthouseRun.start();
       resolve();
     });

front_end/panels/lighthouse/LighthousePanel.ts

@@ -289,9 +289,10 @@ export class LighthousePanel extends UI.Panel.Panel {
   }
 
   private renderStatusView(): void {
-    const inspectedURL = this.controller.getCurrentRun()?.inspectedURL;
+    const currentRun = this.controller.getCurrentRun();
     this.contentElement.classList.toggle('in-progress', true);
-    this.statusView.setInspectedURL(inspectedURL);
+    this.statusView.setInspectedURL(currentRun?.inspectedURL);
+    this.statusView.setAIControlled(Boolean(currentRun?.isAIControlled));
     this.statusView.show(this.contentElement);
   }
 

front_end/panels/lighthouse/LighthouseProtocolService.ts

@@ -55,6 +55,7 @@ export interface LighthouseRun {
     formFactor: (string|undefined),
     mode: string,
   };
+  isAIControlled?: boolean;
 }
 
 /**

front_end/panels/lighthouse/LighthouseStatusView.test.ts

@@ -0,0 +1,61 @@
+// Copyright 2026 The Chromium Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import {getCleanTextContentFromSingleElement, renderElementIntoDOM} from '../../testing/DOMHelpers.js';
+import {describeWithEnvironment} from '../../testing/EnvironmentHelpers.js';
+
+import * as LighthouseModule from './lighthouse.js';
+
+describeWithEnvironment('LighthouseStatusView', () => {
+  let statusView: LighthouseModule.LighthouseStatusView.StatusView;
+  let container: HTMLElement;
+
+  beforeEach(() => {
+    const protocolService = new LighthouseModule.LighthouseProtocolService.ProtocolService();
+    const controller = new LighthouseModule.LighthouseController.LighthouseController(protocolService);
+    const panel =
+        LighthouseModule.LighthousePanel.LighthousePanel.instance({forceNew: true, protocolService, controller});
+    statusView = new LighthouseModule.LighthouseStatusView.StatusView(panel);
+    container = document.createElement('div');
+    renderElementIntoDOM(container);
+  });
+
+  function getHeaderText(statusView: LighthouseModule.LighthouseStatusView.StatusView): string {
+    assert.isOk(statusView.dialog.contentElement.shadowRoot);
+    const headerText = getCleanTextContentFromSingleElement(statusView.dialog.contentElement.shadowRoot, '.header');
+    return headerText;
+  }
+
+  it('shows the correct header for non-AI controlled runs', () => {
+    statusView.setAIControlled(false);
+    statusView.setInspectedURL('http://example.com');
+    statusView.show(container);
+
+    assert.strictEqual(getHeaderText(statusView), 'Auditing example.com…');
+  });
+
+  it('shows the correct header for AI controlled runs', () => {
+    statusView.setAIControlled(true);
+    statusView.setInspectedURL('http://example.com');
+    statusView.show(container);
+
+    assert.strictEqual(getHeaderText(statusView), 'AI assistance is auditing example.com…');
+  });
+
+  it('shows the correct header when no URL is set', () => {
+    statusView.setAIControlled(false);
+    statusView.setInspectedURL('');
+    statusView.show(container);
+
+    assert.strictEqual(getHeaderText(statusView), 'Auditing your web page…');
+  });
+
+  it('shows the correct header for AI controlled runs when no URL is set', () => {
+    statusView.setAIControlled(true);
+    statusView.setInspectedURL('');
+    statusView.show(container);
+
+    assert.strictEqual(getHeaderText(statusView), 'AI assistance is auditing your web page…');
+  });
+});

front_end/panels/lighthouse/LighthouseStatusView.ts

@@ -33,6 +33,15 @@ const UIStrings = {
    * @description Status text in Lighthouse splash screen while an audit is being performed
    */
   auditingYourWebPage: 'Auditing your web page',
+  /**
+   * @description Status text in Lighthouse splash screen while an AI assistant is performing an audit
+   * @example {github.com} PH1
+   */
+  aiAuditingS: 'AI assistance is auditing {PH1}',
+  /**
+   * @description Status text in Lighthouse splash screen while an AI assistant is performing an audit
+   */
+  aiAuditingYourWebPage: 'AI assistance is auditing your web page',
   /**
    * @description Status text in Lighthouse splash screen while an audit is being performed, and cancellation to take effect
    */
@@ -245,13 +254,14 @@ export class StatusView {
   private currentPhase: StatusPhase|null;
   private scheduledFastFactTimeout: number|null;
   private dialogRoot: ShadowRoot|null = null;
-  private readonly dialog: UI.Dialog.Dialog;
+  readonly dialog: UI.Dialog.Dialog;
 
   private statusHeader: string;
   private statusText: string;
   private progressBarClass: string;
   private progressBarValue: number;
   private cancelButtonVisible: boolean;
+  private isAIControlled: boolean;
   private bugReport: {error: Error, auditURL: string, knownBugPattern?: boolean}|null;
 
   constructor(panel: LighthousePanel) {
@@ -273,6 +283,7 @@ export class StatusView {
     this.progressBarClass = '';
     this.progressBarValue = 0;
     this.cancelButtonVisible = true;
+    this.isAIControlled = false;
     this.bugReport = null;
 
     this.render();
@@ -317,15 +328,24 @@ export class StatusView {
     this.reset();
     this.updateStatus(i18nString(UIStrings.loading));
 
-    const parsedURL = Common.ParsedURL.ParsedURL.fromString(this.inspectedURL);
-    const pageHost = parsedURL?.host;
-    const statusHeader =
-        pageHost ? i18nString(UIStrings.auditingS, {PH1: pageHost}) : i18nString(UIStrings.auditingYourWebPage);
+    const statusHeader = this.getStatusHeader();
     this.renderStatusHeader(statusHeader);
     this.dialog.show(dialogRenderElement);
     this.render();
   }
 
+  private getStatusHeader(): string {
+    const parsedURL = Common.ParsedURL.ParsedURL.fromString(this.inspectedURL);
+    const pageHost = parsedURL?.host;
+
+    if (this.isAIControlled) {
+      return pageHost ? i18nString(UIStrings.aiAuditingS, {PH1: pageHost}) :
+                        i18nString(UIStrings.aiAuditingYourWebPage);
+    }
+
+    return pageHost ? i18nString(UIStrings.auditingS, {PH1: pageHost}) : i18nString(UIStrings.auditingYourWebPage);
+  }
+
   private renderStatusHeader(statusHeader?: string): void {
     this.statusHeader = `${statusHeader}…`;
     this.render();
@@ -337,6 +357,10 @@ export class StatusView {
     }
   }
 
+  setAIControlled(isAIControlled: boolean): void {
+    this.isAIControlled = isAIControlled;
+  }
+
   setInspectedURL(url = ''): void {
     this.inspectedURL = url;
   }