chrome-devtools-frontend 1.0.1590494 → 1.0.1592129

package/docs/ui_engineering.md

@@ -611,7 +611,7 @@ export const DEFAULT_VIEW = (input, _output, target) => {
       <a href="https://www.google.com" data-some-key="some-value" role="some-role">some-text</a>
       <img src="https://www.google.com/some-image.png" alt="some-alt" draggable="true" height="100"
           hidden="hidden" href="https://www.google.com" id="some-id" name="some-name" rel="some-rel"
-          scope="some-scope"></img>
+          scope="some-scope">
       <input type="text" placeholder="some-placeholder" value="some-value"
           ?disabled=${!this.enabled} checked>
     </div>`,
@@ -1383,6 +1383,39 @@ export const DEFAULT_VIEW = (input, _output, target) => {
 };
 ```
 
+In a more complex case you might want to skip rendering of the collapsed nodes
+subtrees and temporarily expand nodes to show search matches. This could be done
+as follows:
+
+```typescript
+export const DEFAULT_VIEW = (input, _output, target) => {
+  render(html`
+    <div>
+      <devtools-tree .template=${html`
+        <ul role="tree">
+          ${input.topLevelNodes.map(node => html`
+            <li role="treeitem" ?open=${containsSearchResult(node)}>
+              ${node.name}
+              ${node.children.length ? html`
+                <ul role="group">
+                  ${ifExpanded(node.children.map(renderChild))}
+                </ul>
+              ` : nothing}
+            </li>`)}
+        </ul>
+      `}></devtools-tree>
+    </div>`,
+    target, {host: input});
+};
+```
+
+Here `open` attribute overrides the expansion state set by the user. Once `open`
+attribute is removed, the expansion state is reversed to the last state set by
+the user.
+
+`ifExpanded` is a lit directive provided on `UI.TreeOutline` and it makes its
+argument render only if the current tree node is expanded.
+
 ## Refactoring UI.Toolbar.Provider
 
 As part of the migration, sometimes classes need to be broken up into smaller pieces. Classes implementing

package/front_end/core/common/Gzip.ts

@@ -37,11 +37,26 @@ export async function fileToString(file: File): Promise<string> {
  * Decompress a gzipped ArrayBuffer to a string.
  * Consider using `arrayBufferToString` instead, which can handle both gzipped and plain text buffers.
  */
-export async function decompress(gzippedBuffer: ArrayBufferLike): Promise<string> {
+export async function decompress(gzippedBuffer: ArrayBufferLike, charset = 'utf-8'): Promise<string> {
   const buffer = await gzipCodec(gzippedBuffer, new DecompressionStream('gzip'));
-  const str = new TextDecoder('utf-8').decode(buffer);
+  const str = new TextDecoder(charset).decode(buffer);
   return str;
 }
+
+/**
+ * Decompress a deflate-encoded ArrayBuffer to a string.
+ * Tries 'deflate' (zlib wrapper) first, then falls back to 'deflate-raw'.
+ */
+export async function decompressDeflate(buffer: ArrayBufferLike, charset = 'utf-8'): Promise<string> {
+  let decompressedBuffer: ArrayBuffer;
+  try {
+    decompressedBuffer = await gzipCodec(buffer, new DecompressionStream('deflate'));
+  } catch {
+    // Try deflate-raw format if zlib-wrapped deflate fails.
+    decompressedBuffer = await gzipCodec(buffer, new DecompressionStream('deflate-raw'));
+  }
+  return new TextDecoder(charset).decode(decompressedBuffer);
+}
 export async function compress(str: string): Promise<ArrayBuffer> {
   const encoded = new TextEncoder().encode(str);
   const buffer = await gzipCodec(encoded, new CompressionStream('gzip'));

package/front_end/core/host/AidaClient.ts

@@ -528,8 +528,8 @@ export class AidaClient {
   async *
       doConversation(request: DoConversationRequest, options?: {signal?: AbortSignal}):
           AsyncGenerator<DoConversationResponse, void, void> {
-    if (!InspectorFrontendHostInstance.doAidaConversation) {
-      throw new Error('doAidaConversation is not available');
+    if (!InspectorFrontendHostInstance.dispatchHttpRequest) {
+      throw new Error('dispatchHttpRequest is not available');
     }
 
     // Disable logging for now.
@@ -559,19 +559,42 @@ export class AidaClient {
       };
     })();
     const streamId = bindOutputStream(stream);
-    InspectorFrontendHostInstance.doAidaConversation(JSON.stringify(request), streamId, result => {
-      if (result.statusCode === 403) {
-        stream.fail(new Error('Server responded: permission denied'));
-      } else if (result.error) {
-        stream.fail(new Error(`Cannot send request: ${result.error} ${result.detail || ''}`));
-      } else if (result.netErrorName === 'net::ERR_TIMED_OUT') {
-        stream.fail(new Error('doAidaConversation timed out'));
-      } else if (result.statusCode !== 200) {
-        stream.fail(new Error(`Request failed: ${JSON.stringify(result)}`));
-      } else {
-        void stream.close();
-      }
-    });
+    DispatchHttpRequestClient
+        .makeHttpRequest(
+            {
+              service: SERVICE_NAME,
+              path: '/v1/aida:doConversation',
+              method: 'POST',
+              body: JSON.stringify(request),
+              streamId,
+            },
+            options)
+        .then(
+            () => {
+              void stream.close();
+            },
+            err => {
+              if (err instanceof DispatchHttpRequestClient.DispatchHttpRequestError && err.response) {
+                const result = err.response;
+                if (result.statusCode === 403) {
+                  stream.fail(new Error('Server responded: permission denied'));
+                  return;
+                }
+                if ('error' in result && result.error) {
+                  stream.fail(new Error(`Cannot send request: ${result.error} ${result.detail || ''}`));
+                  return;
+                }
+                if ('netErrorName' in result && result.netErrorName === 'net::ERR_TIMED_OUT') {
+                  stream.fail(new Error('doAidaConversation timed out'));
+                  return;
+                }
+                if (result.statusCode !== 200) {
+                  stream.fail(new Error(`Request failed: ${JSON.stringify(result)}`));
+                  return;
+                }
+              }
+              stream.fail(err);
+            });
     let chunk;
     const text = [];
     let inCodeChunk = false;

package/front_end/core/host/DispatchHttpRequestClient.ts

@@ -12,7 +12,7 @@ export enum ErrorType {
 }
 
 export class DispatchHttpRequestError extends Error {
-  constructor(readonly type: ErrorType, options?: ErrorOptions) {
+  constructor(readonly type: ErrorType, readonly response?: DispatchHttpRequestResult, options?: ErrorOptions) {
     super(undefined, options);
   }
 }
@@ -38,18 +38,21 @@ export async function makeHttpRequest<R>(
 
   debugLog({request, response});
   if (response.statusCode === 404) {
-    throw new DispatchHttpRequestError(ErrorType.NOT_FOUND);
+    throw new DispatchHttpRequestError(ErrorType.NOT_FOUND, response);
   }
 
   if ('response' in response && response.statusCode === 200) {
+    if (request.streamId && !response.response) {
+      return null as R;
+    }
     try {
       return JSON.parse(response.response) as R;
     } catch (err) {
-      throw new DispatchHttpRequestError(ErrorType.HTTP_RESPONSE_UNAVAILABLE, {cause: err});
+      throw new DispatchHttpRequestError(ErrorType.HTTP_RESPONSE_UNAVAILABLE, response, {cause: err});
     }
   }
 
-  throw new DispatchHttpRequestError(ErrorType.HTTP_RESPONSE_UNAVAILABLE);
+  throw new DispatchHttpRequestError(ErrorType.HTTP_RESPONSE_UNAVAILABLE, response);
 }
 
 function isDebugMode(): boolean {

package/front_end/core/host/InspectorFrontendHostAPI.ts

@@ -263,12 +263,14 @@ export type DispatchHttpRequestRequest = {
   path: string,
   method: 'GET',
   queryParams?: Record<string, string|string[]>,
+  streamId?: number,
   body?: never,
 }|{
   service: string,
   path: string,
   method: 'POST',
   queryParams?: Record<string, string|string[]>,
+  streamId?: number,
   // A JSON string containing the request body.
   body?: string,
 };

package/front_end/core/host/UserMetrics.ts

@@ -825,10 +825,11 @@ export enum DevtoolsExperiments {
   'use-source-map-scopes' = 76,
   'timeline-show-postmessage-events' = 86,
   'timeline-debug-mode' = 93,
+  'durable-messages' = 110,
   /* eslint-enable @typescript-eslint/naming-convention */
 
   // Increment this when new experiments are added.
-  MAX_VALUE = 110,
+  MAX_VALUE = 111,
 }
 
 /** Update DevToolsIssuesPanelIssueExpanded from tools/metrics/histograms/enums.xml if new enum is added. **/

package/front_end/core/root/ExperimentNames.ts

@@ -23,6 +23,7 @@ export enum ExperimentName {
   USE_SOURCE_MAP_SCOPES = 'use-source-map-scopes',
   TIMELINE_SHOW_POST_MESSAGE_EVENTS = 'timeline-show-postmessage-events',
   TIMELINE_DEBUG_MODE = 'timeline-debug-mode',
+  DURABLE_MESSAGES = 'durable-messages',
   // Adding or removing an entry from this enum?
   // You will need to update:
   // 1. DevToolsExperiments enum in host/UserMetrics.ts

package/front_end/core/root/Runtime.ts

@@ -534,6 +534,10 @@ export interface HostConfigAnimationStylesInStylesTab {
   enabled: boolean;
 }
 
+export interface HostConfigJpegXlImageFormat {
+  enabled: boolean;
+}
+
 export interface HostConfigThirdPartyCookieControls {
   thirdPartyCookieRestrictionEnabled: boolean;
   thirdPartyCookieMetadataEnabled: boolean;
@@ -641,6 +645,7 @@ export type HostConfig = Platform.TypeScriptUtilities.RecursivePartial<{
   isOffTheRecord: boolean,
   devToolsEnableOriginBoundCookies: HostConfigEnableOriginBoundCookies,
   devToolsAnimationStylesInStylesTab: HostConfigAnimationStylesInStylesTab,
+  devToolsJpegXlImageFormat: HostConfigJpegXlImageFormat,
   thirdPartyCookieControls: HostConfigThirdPartyCookieControls,
   devToolsAiGeneratedTimelineLabels: AiGeneratedTimelineLabels,
   devToolsAllowPopoverForcing: AllowPopoverForcing,

package/front_end/core/sdk/CSSMetadata.ts

@@ -1344,6 +1344,24 @@ const extraPropertyValues = new Map<string, Set<string>>([
   ['-webkit-transform-origin-x', new Set(['left', 'right', 'center'])],
   ['-webkit-transform-origin-y', new Set(['top', 'bottom', 'center'])],
   ['width', new Set(['-webkit-fill-available', 'stretch'])],
+  [
+    'animation-trigger',
+    new Set([
+      'play',
+      'pause',
+      'play-once',
+      'play-alternate',
+      'play-forwards',
+      'play-backwards',
+      'play-pause',
+      'replay',
+    ]),
+  ],
+  ['timeline-trigger-activation-range-start', new Set(['normal'])],
+  ['timeline-trigger-activation-range-end', new Set(['normal'])],
+  ['timeline-trigger-active-range-start', new Set(['normal'])],
+  ['timeline-trigger-active-range-end', new Set(['normal'])],
+
   ['contain-intrinsic-width', new Set(['auto none', 'auto 100px'])],
   ['contain-intrinsic-height', new Set(['auto none', 'auto 100px'])],
   ['contain-intrinsic-size', new Set(['auto none', 'auto 100px'])],

package/front_end/core/sdk/EmulationModel.ts

@@ -191,6 +191,7 @@ export class EmulationModel extends SDKModel<void> {
     }
 
     const avifFormatDisabledSetting = Common.Settings.Settings.instance().moduleSetting('avif-format-disabled');
+    const jpegXlFormatDisabledSetting = Common.Settings.Settings.instance().moduleSetting('jpeg-xl-format-disabled');
     const webpFormatDisabledSetting = Common.Settings.Settings.instance().moduleSetting('webp-format-disabled');
 
     const updateDisabledImageFormats = (): void => {
@@ -198,6 +199,9 @@ export class EmulationModel extends SDKModel<void> {
       if (avifFormatDisabledSetting.get()) {
         types.push(Protocol.Emulation.DisabledImageType.Avif);
       }
+      if (jpegXlFormatDisabledSetting.get()) {
+        types.push(Protocol.Emulation.DisabledImageType.Jxl);
+      }
       if (webpFormatDisabledSetting.get()) {
         types.push(Protocol.Emulation.DisabledImageType.Webp);
       }
@@ -205,9 +209,10 @@ export class EmulationModel extends SDKModel<void> {
     };
 
     avifFormatDisabledSetting.addChangeListener(updateDisabledImageFormats);
+    jpegXlFormatDisabledSetting.addChangeListener(updateDisabledImageFormats);
     webpFormatDisabledSetting.addChangeListener(updateDisabledImageFormats);
 
-    if (avifFormatDisabledSetting.get() || webpFormatDisabledSetting.get()) {
+    if (avifFormatDisabledSetting.get() || jpegXlFormatDisabledSetting.get() || webpFormatDisabledSetting.get()) {
       updateDisabledImageFormats();
     }
 

package/front_end/core/sdk/NetworkManager.ts

@@ -277,13 +277,56 @@ export class NetworkManager extends SDKModel<EventTypes> {
       return null;
     }
     try {
-      const {postData} = await manager.#networkAgent.invoke_getRequestPostData({requestId});
+      const {postData, base64Encoded} = await manager.#networkAgent.invoke_getRequestPostData({requestId});
+      if (base64Encoded && postData) {
+        // Decode base64 to get raw bytes as an ArrayBuffer.
+        const binaryString = window.atob(postData);
+        const bytes = new Uint8Array(binaryString.length);
+        for (let i = 0; i < binaryString.length; i++) {
+          bytes[i] = binaryString.charCodeAt(i);
+        }
+
+        // Extract charset from request Content-Type header, defaulting to utf-8.
+        const requestContentType = request.requestContentType();
+        const charset =
+            requestContentType ? Platform.MimeType.parseContentType(requestContentType).charset ?? 'utf-8' : 'utf-8';
+
+        // If the request body is compressed, attempt to decompress it.
+        const contentEncoding = request.requestContentEncoding()?.toLowerCase();
+        if (contentEncoding) {
+          const decompressed = await NetworkManager.#tryDecompressBody(bytes.buffer, contentEncoding, charset);
+          if (decompressed !== null) {
+            return decompressed;
+          }
+        }
+
+        // Not compressed or decompression not applicable -- decode as text.
+        return new TextDecoder(charset).decode(bytes);
+      }
       return postData;
     } catch (e) {
       return e.message;
     }
   }
 
+  /**
+   * Attempts to decompress a compressed request body.
+   * Returns the decompressed string, or null if decompression is not applicable.
+   */
+  static async #tryDecompressBody(buffer: ArrayBuffer, encoding: string, charset: string): Promise<string|null> {
+    try {
+      if (encoding.includes('gzip') && Common.Gzip.isGzip(buffer)) {
+        return await Common.Gzip.decompress(buffer, charset);
+      }
+      if (encoding.includes('deflate')) {
+        return await Common.Gzip.decompressDeflate(buffer, charset);
+      }
+    } catch (e) {
+      console.warn('Failed to decompress request body:', e);
+    }
+    return null;
+  }
+
   static connectionType(conditions: Conditions): Protocol.Network.ConnectionType {
     if (!conditions.download && !conditions.upload) {
       return Protocol.Network.ConnectionType.None;
@@ -567,7 +610,11 @@ export class NetworkDispatcher implements ProtocolProxyApi.NetworkDispatcher {
   private updateNetworkRequestWithRequest(networkRequest: NetworkRequest, request: Protocol.Network.Request): void {
     networkRequest.requestMethod = request.method;
     networkRequest.setRequestHeaders(this.headersMapToHeadersArray(request.headers));
-    networkRequest.setRequestFormData(Boolean(request.hasPostData), request.postData || null);
+    // If the request body is compressed, discard the inline postData which is
+    // garbled (binary-as-text). The getRequestPostData command will provide
+    // properly base64-encoded data that we can decompress.
+    const isCompressed = Boolean(networkRequest.requestContentEncoding());
+    networkRequest.setRequestFormData(Boolean(request.hasPostData), isCompressed ? null : (request.postData || null));
     networkRequest.setInitialPriority(request.initialPriority);
     networkRequest.mixedContentType = request.mixedContentType || Protocol.Security.MixedContentType.None;
     networkRequest.setReferrerPolicy(request.referrerPolicy);

package/front_end/core/sdk/NetworkRequest.ts

@@ -1471,6 +1471,10 @@ export class NetworkRequest extends Common.ObjectWrapper.ObjectWrapper<EventType
     return this.requestHeaderValue('Content-Type');
   }
 
+  requestContentEncoding(): string|undefined {
+    return this.requestHeaderValue('Content-Encoding');
+  }
+
   hasErrorStatusCode(): boolean {
     return this.statusCode >= 400;
   }

package/front_end/core/sdk/RuntimeModel.ts

@@ -262,7 +262,8 @@ export class RuntimeModel extends SDKModel<EventTypes> {
     }
 
     if (object.isNode()) {
-      void Common.Revealer.reveal(object).then(object.release.bind(object));
+      const omitFocus = hints !== null && typeof hints === 'object' && 'omitFocus' in hints && Boolean(hints.omitFocus);
+      void Common.Revealer.reveal(object, omitFocus).then(object.release.bind(object));
       return;
     }
 

package/front_end/core/sdk/sdk-meta.ts

@@ -313,6 +313,14 @@ const UIStrings = {
    * @description Title of a setting that enables AVIF format
    */
   enableAvifFormat: 'Enable `AVIF` format',
+  /**
+   * @description Title of a setting that disables JPEG XL format
+   */
+  disableJpegXlFormat: 'Disable `JPEG XL` format',
+  /**
+   * @description Title of a setting that enables JPEG XL format
+   */
+  enableJpegXlFormat: 'Enable `JPEG XL` format',
   /**
    * @description Title of a setting that disables WebP format
    */
@@ -1072,6 +1080,24 @@ Common.Settings.registerSettingExtension({
   defaultValue: false,
 });
 
+Common.Settings.registerSettingExtension({
+  category: Common.Settings.SettingCategory.RENDERING,
+  settingName: 'jpeg-xl-format-disabled',
+  settingType: Common.Settings.SettingType.BOOLEAN,
+  storageType: Common.Settings.SettingStorageType.SESSION,
+  options: [
+    {
+      value: true,
+      title: i18nLazyString(UIStrings.disableJpegXlFormat),
+    },
+    {
+      value: false,
+      title: i18nLazyString(UIStrings.enableJpegXlFormat),
+    },
+  ],
+  defaultValue: false,
+});
+
 Common.Settings.registerSettingExtension({
   category: Common.Settings.SettingCategory.RENDERING,
   settingName: 'webp-format-disabled',

package/front_end/entrypoints/inspector_main/RenderingOptions.ts

@@ -7,6 +7,7 @@
 import * as Common from '../../core/common/common.js';
 import * as Host from '../../core/host/host.js';
 import * as i18n from '../../core/i18n/i18n.js';
+import * as Root from '../../core/root/root.js';
 import * as SettingsUI from '../../ui/legacy/components/settings_ui/settings_ui.js';
 import * as UI from '../../ui/legacy/legacy.js';
 import * as VisualLogging from '../../ui/visual_logging/visual_logging.js';
@@ -145,10 +146,14 @@ const UIStrings = {
    */
   disableAvifImageFormat: 'Disable `AVIF` image format',
   /**
-   * @description Explanation text for both the 'Disable AVIF image format' and 'Disable WebP image
-   * format' settings in the Rendering tool.
+   * @description Explanation text for the image format disabling settings in the Rendering tool.
    */
   requiresAPageReloadToApplyAnd: 'Requires a page reload to apply and disables caching for image requests.',
+  /**
+   * @description The name of a checkbox setting in the Rendering tool. This setting disables the
+   * page from loading images with the JPEG XL format.
+   */
+  disableJpegXlImageFormat: 'Disable `JPEG XL` image format',
   /**
    * @description The name of a checkbox setting in the Rendering tool. This setting disables the
    * page from loading images with the WebP format.
@@ -184,7 +189,13 @@ const supportsPrefersContrast = (): boolean => {
   return window.matchMedia(query).matches;
 };
 
+const supportsJpegXl = (): boolean => {
+  return Boolean(Root.Runtime.hostConfig.devToolsJpegXlImageFormat?.enabled);
+};
+
 export class RenderingOptionsView extends UI.Widget.VBox {
+  #jpegXlCheckboxAdded = false;
+
   constructor() {
     super({useShadowDom: true});
     this.registerRequiredCSS(renderingOptionsStyles);
@@ -266,13 +277,19 @@ export class RenderingOptionsView extends UI.Widget.VBox {
 
     this.contentElement.createChild('div').classList.add('panel-section-separator');
 
+    const avifFormatDisabledSetting = Common.Settings.Settings.instance().moduleSetting('avif-format-disabled');
+    const jpegXlFormatDisabledSetting = Common.Settings.Settings.instance().moduleSetting('jpeg-xl-format-disabled');
+    const webpFormatDisabledSetting = Common.Settings.Settings.instance().moduleSetting('webp-format-disabled');
+
     this.#appendCheckbox(
         i18nString(UIStrings.disableAvifImageFormat), i18nString(UIStrings.requiresAPageReloadToApplyAnd),
-        Common.Settings.Settings.instance().moduleSetting('avif-format-disabled'));
+        avifFormatDisabledSetting);
 
-    this.#appendCheckbox(
+    const webpCheckbox = this.#appendCheckbox(
         i18nString(UIStrings.disableWebpImageFormat), i18nString(UIStrings.requiresAPageReloadToApplyAnd),
-        Common.Settings.Settings.instance().moduleSetting('webp-format-disabled'));
+        webpFormatDisabledSetting);
+
+    this.#appendJpegXlCheckboxWhenSupported(webpCheckbox, jpegXlFormatDisabledSetting);
 
     this.contentElement.createChild('div').classList.add('panel-section-separator');
   }
@@ -286,6 +303,18 @@ export class RenderingOptionsView extends UI.Widget.VBox {
     return checkbox;
   }
 
+  #appendJpegXlCheckboxWhenSupported(
+      webpCheckbox: UI.UIUtils.CheckboxLabel, jpegXlFormatDisabledSetting: Common.Settings.Setting<boolean>): void {
+    if (this.#jpegXlCheckboxAdded || !supportsJpegXl()) {
+      return;
+    }
+
+    this.#jpegXlCheckboxAdded = true;
+    webpCheckbox.before(this.#appendCheckbox(
+        i18nString(UIStrings.disableJpegXlImageFormat), i18nString(UIStrings.requiresAPageReloadToApplyAnd),
+        jpegXlFormatDisabledSetting));
+  }
+
   #appendSelect(label: string, setting: Common.Settings.Setting<unknown>): void {
     const control = SettingsUI.SettingsUI.createControlForSetting(setting, label);
     if (control) {

package/front_end/entrypoints/main/MainImpl.ts

@@ -423,6 +423,14 @@ export class MainImpl {
         'Performance panel: show postMessage dispatch and handling flows',
     );
 
+    Root.Runtime.experiments.registerHostExperiment({
+      name: Root.ExperimentNames.ExperimentName.DURABLE_MESSAGES,
+      title: 'Durable Messages',
+      aboutFlag: 'devtools-enable-durable-messages',
+      isEnabled: Root.Runtime.hostConfig.devToolsEnableDurableMessages?.enabled ?? false,
+      requiresChromeRestart: false,
+    });
+
     Root.Runtime.experiments.enableExperimentsByDefault([
       Root.ExperimentNames.ExperimentName.FULL_ACCESSIBILITY_TREE,
       Root.ExperimentNames.ExperimentName.USE_SOURCE_MAP_SCOPES,

package/front_end/generated/InspectorBackendCommands.ts

@@ -557,6 +557,7 @@ inspectorBackend.registerCommand("Emulation.setSmallViewportHeightDifferenceOver
 inspectorBackend.registerCommand("Emulation.getScreenInfos", [], ["screenInfos"], "Returns device's screen configuration. In headful mode, the physical screens configuration is returned, whereas in headless mode, a virtual headless screen configuration is provided instead.");
 inspectorBackend.registerCommand("Emulation.addScreen", [{"name": "left", "type": "number", "optional": false, "description": "Offset of the left edge of the screen in pixels.", "typeRef": null}, {"name": "top", "type": "number", "optional": false, "description": "Offset of the top edge of the screen in pixels.", "typeRef": null}, {"name": "width", "type": "number", "optional": false, "description": "The width of the screen in pixels.", "typeRef": null}, {"name": "height", "type": "number", "optional": false, "description": "The height of the screen in pixels.", "typeRef": null}, {"name": "workAreaInsets", "type": "object", "optional": true, "description": "Specifies the screen's work area. Default is entire screen.", "typeRef": "Emulation.WorkAreaInsets"}, {"name": "devicePixelRatio", "type": "number", "optional": true, "description": "Specifies the screen's device pixel ratio. Default is 1.", "typeRef": null}, {"name": "rotation", "type": "number", "optional": true, "description": "Specifies the screen's rotation angle. Available values are 0, 90, 180 and 270. Default is 0.", "typeRef": null}, {"name": "colorDepth", "type": "number", "optional": true, "description": "Specifies the screen's color depth in bits. Default is 24.", "typeRef": null}, {"name": "label", "type": "string", "optional": true, "description": "Specifies the descriptive label for the screen. Default is none.", "typeRef": null}, {"name": "isInternal", "type": "boolean", "optional": true, "description": "Indicates whether the screen is internal to the device or external, attached to the device. Default is false.", "typeRef": null}], ["screenInfo"], "Add a new screen to the device. Only supported in headless mode.");
 inspectorBackend.registerCommand("Emulation.removeScreen", [{"name": "screenId", "type": "string", "optional": false, "description": "", "typeRef": "Emulation.ScreenId"}], [], "Remove screen from the device. Only supported in headless mode.");
+inspectorBackend.registerCommand("Emulation.setPrimaryScreen", [{"name": "screenId", "type": "string", "optional": false, "description": "", "typeRef": "Emulation.ScreenId"}], [], "Set primary screen. Only supported in headless mode. Note that this changes the coordinate system origin to the top-left of the new primary screen, updating the bounds and work areas of all existing screens accordingly.");
 inspectorBackend.registerType("Emulation.SafeAreaInsets", [{"name": "top", "type": "number", "optional": true, "description": "Overrides safe-area-inset-top.", "typeRef": null}, {"name": "topMax", "type": "number", "optional": true, "description": "Overrides safe-area-max-inset-top.", "typeRef": null}, {"name": "left", "type": "number", "optional": true, "description": "Overrides safe-area-inset-left.", "typeRef": null}, {"name": "leftMax", "type": "number", "optional": true, "description": "Overrides safe-area-max-inset-left.", "typeRef": null}, {"name": "bottom", "type": "number", "optional": true, "description": "Overrides safe-area-inset-bottom.", "typeRef": null}, {"name": "bottomMax", "type": "number", "optional": true, "description": "Overrides safe-area-max-inset-bottom.", "typeRef": null}, {"name": "right", "type": "number", "optional": true, "description": "Overrides safe-area-inset-right.", "typeRef": null}, {"name": "rightMax", "type": "number", "optional": true, "description": "Overrides safe-area-max-inset-right.", "typeRef": null}]);
 inspectorBackend.registerType("Emulation.ScreenOrientation", [{"name": "type", "type": "string", "optional": false, "description": "Orientation type.", "typeRef": null}, {"name": "angle", "type": "number", "optional": false, "description": "Orientation angle.", "typeRef": null}]);
 inspectorBackend.registerType("Emulation.DisplayFeature", [{"name": "orientation", "type": "string", "optional": false, "description": "Orientation of a display feature in relation to screen", "typeRef": null}, {"name": "offset", "type": "number", "optional": false, "description": "The offset from the screen origin in either the x (for vertical orientation) or y (for horizontal orientation) direction.", "typeRef": null}, {"name": "maskLength", "type": "number", "optional": false, "description": "A display feature may mask content such that it is not physically displayed - this length along with the offset describes this area. A display feature that only splits content will have a 0 mask_length.", "typeRef": null}]);

package/front_end/generated/protocol-mapping.d.ts

@@ -2782,6 +2782,16 @@ export namespace ProtocolMapping {
       paramsType: [Protocol.Emulation.RemoveScreenRequest];
       returnType: void;
     };
+    /**
+     * Set primary screen. Only supported in headless mode.
+     * Note that this changes the coordinate system origin to the top-left
+     * of the new primary screen, updating the bounds and work areas
+     * of all existing screens accordingly.
+     */
+    'Emulation.setPrimaryScreen': {
+      paramsType: [Protocol.Emulation.SetPrimaryScreenRequest];
+      returnType: void;
+    };
     /**
      * Sets breakpoint on particular native event.
      */

package/front_end/generated/protocol-proxy-api.d.ts

@@ -1852,6 +1852,14 @@ declare namespace ProtocolProxyApi {
      */
     invoke_removeScreen(params: Protocol.Emulation.RemoveScreenRequest): Promise<Protocol.ProtocolResponseWithError>;
 
+    /**
+     * Set primary screen. Only supported in headless mode.
+     * Note that this changes the coordinate system origin to the top-left
+     * of the new primary screen, updating the bounds and work areas
+     * of all existing screens accordingly.
+     */
+    invoke_setPrimaryScreen(params: Protocol.Emulation.SetPrimaryScreenRequest): Promise<Protocol.ProtocolResponseWithError>;
+
   }
   export interface EmulationDispatcher {
     /**

package/front_end/generated/protocol.ts

@@ -7550,6 +7550,10 @@ export namespace Emulation {
   export interface RemoveScreenRequest {
     screenId: ScreenId;
   }
+
+  export interface SetPrimaryScreenRequest {
+    screenId: ScreenId;
+  }
 }
 
 /**
@@ -10153,7 +10157,7 @@ export namespace Network {
   }
 
   /**
-   * The render blocking behavior of a resource request.
+   * The render-blocking behavior of a resource request.
    */
   export const enum RenderBlockingBehavior {
     Blocking = 'Blocking',
@@ -12670,7 +12674,7 @@ export namespace Network {
      */
     hasUserGesture?: boolean;
     /**
-     * The render blocking behavior of the request.
+     * The render-blocking behavior of the request.
      */
     renderBlockingBehavior?: RenderBlockingBehavior;
   }

package/front_end/models/ai_assistance/AiConversation.ts

@@ -6,6 +6,7 @@ import * as Host from '../../core/host/host.js';
 import * as Root from '../../core/root/root.js';
 import * as SDK from '../../core/sdk/sdk.js';
 import * as Trace from '../../models/trace/trace.js';
+import * as Greendev from '../greendev/greendev.js';
 import * as NetworkTimeCalculator from '../network_time_calculator/network_time_calculator.js';
 
 import {
@@ -17,6 +18,7 @@ import {
   ResponseType,
   type UserQuery
 } from './agents/AiAgent.js';
+import {BreakpointDebuggerAgent} from './agents/BreakpointDebuggerAgent.js';
 import {ContextSelectionAgent} from './agents/ContextSelectionAgent.js';
 import {FileAgent, FileContext} from './agents/FileAgent.js';
 import {NetworkAgent, RequestContext} from './agents/NetworkAgent.js';
@@ -326,6 +328,13 @@ export class AiConversation {
         this.#agent = new PerformanceAgent(options);
         break;
       }
+      case ConversationType.BREAKPOINT: {
+        const breakpointAgentEnabled = Greendev.Prototypes.instance().isEnabled('breakpointDebuggerAgent');
+        if (breakpointAgentEnabled) {
+          this.#agent = new BreakpointDebuggerAgent(options);
+        }
+        break;
+      }
       case ConversationType.NONE: {
         this.#agent = new ContextSelectionAgent(options);
         break;

package/front_end/models/ai_assistance/AiHistoryStorage.ts

@@ -13,6 +13,7 @@ export const enum ConversationType {
   FILE = 'drjones-file',
   NETWORK = 'drjones-network-request',
   PERFORMANCE = 'drjones-performance-full',
+  BREAKPOINT = 'breakpoint',
 }
 
 export interface SerializedConversation {