chrome-devtools-frontend 1.0.1611825 → 1.0.1613625

package/.agents/skills/verification/SKILL.md

@@ -25,9 +25,13 @@ description: MANDATORY: Activate this skill ANY TIME you need to build the proje
 - `npm run lint` will execute ESLint and StyleLint. It will report any violations and automatically fix them where possible.
 - To run the linter on a specific file or directory, you can run `npm run lint -- <PATH>` where `PATH` is a path to a file or directory. This will also automatically fix violations where possible.
 
+## Presubmit
+
+- `git cl presubmit -u` will check if the current change is ready for upload. It will also format and lint the change.
+
 ## Best practices
 
 - Run tests often to verify your changes.
 - Prefer using a fast build, if it exists, to keep the feedback loop shorter.
 - Periodically compile with TypeScript to check for type errors.
-- Run linting at the end of your code changes.
+- Run `git cl presubmit -u` at the end of your code changes.

package/front_end/Images/src/flowsheet.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="20px" viewBox="0 -960 960 960" width="20px" fill="currentColor"><path d="M168-456v192-432V-456Zm383.79 312q15.21 0 25.71-10.29t10.5-25.5q0-15.21-10.29-25.71t-25.5-10.5q-15.21 0-25.71 10.29t-10.5 25.5q0 15.21 10.29 25.71t25.5 10.5Zm240-360q15.21 0 25.71-10.29t10.5-25.5q0-15.21-10.29-25.71t-25.5-10.5q-15.21 0-25.71 10.29t-10.5 25.5q0 15.21 10.29 25.71t25.5 10.5ZM240-528h204v-72H240v72Zm0 168h204v-72H240v72Zm-72 168q-29.7 0-50.85-21.16Q96-234.32 96-264.04v-432.24Q96-726 117.15-747T168-768h624q29.7 0 50.85 21.15Q864-725.7 864-696H168v432h204v72H168Zm307.5 88.52Q444-134.96 444-179.92 444-215 464-243t52-39v-102h240v-54q-32-11-52-38.92t-20-63.05q0-45.03 31.5-76.53T792-648q45 0 76.5 31.48t31.5 76.44Q900-505 880-477t-52 39v126H588v30q32 11 52 38.92t20 63.05q0 45.03-31.5 76.53T552-72q-45 0-76.5-31.48Z"/></svg>

package/front_end/core/common/Color.ts

@@ -684,6 +684,7 @@ export interface Color {
 
 const EPSILON = 0.01;
 const WIDE_RANGE_EPSILON = 1;  // For comparisons on channels with a wider range than [0,1]
+const STRICT_EPSILON = 1e-4;
 function equals(a: number[], b: number[], accuracy?: number): boolean;
 function equals(a: number|null, b: number|null, accuracy?: number): boolean;
 function equals(a: number|null|number[], b: number|null|number[], accuracy = EPSILON): boolean {
@@ -994,7 +995,7 @@ export class LCH implements Color {
   // See "powerless" component definitions in
   // https://www.w3.org/TR/css-color-4/#specifying-lab-lch
   isHuePowerless(): boolean {
-    return equals(this.c, 0);
+    return equals(this.c, 0, STRICT_EPSILON);
   }
   static fromSpec(spec: ColorParameterSpec, text: string): LCH|null {
     const L = parsePercentage(spec[0], [0, 100]) ?? parseNumber(spec[0]);
@@ -1592,7 +1593,7 @@ export class HSL implements Color {
     this.l = clamp(l, {min: 0, max: 1});
     s = equals(this.l, 0) || equals(this.l, 1) ? 0 : s;
     this.s = clamp(s, {min: 0, max: 1});
-    h = equals(this.s, 0) ? 0 : h;
+    h = equals(this.s, 0, STRICT_EPSILON) ? 0 : h;
     this.h = normalizeHue(h * 360) / 360;
     this.alpha = clamp(alpha ?? null, {min: 0, max: 1});
     this.#authoredText = authoredText;

package/front_end/core/common/MapWithDefault.ts

@@ -8,7 +8,7 @@
  * TODO: Once the proposal is merged, just replace `MapWithDefault` with `Map` and remove it.
  **/
 export class MapWithDefault<K, V> extends Map<K, V> {
-  getOrInsert(key: K, defaultValue: V): V {
+  override getOrInsert(key: K, defaultValue: V): V {
     if (!this.has(key)) {
       this.set(key, defaultValue);
     }
@@ -16,7 +16,7 @@ export class MapWithDefault<K, V> extends Map<K, V> {
     return this.get(key) as V;
   }
 
-  getOrInsertComputed(key: K, callbackFunction: (key: K) => V): V {
+  override getOrInsertComputed(key: K, callbackFunction: (key: K) => V): V {
     if (!this.has(key)) {
       this.set(key, callbackFunction(key));
     }

package/front_end/core/common/Object.ts

@@ -119,31 +119,34 @@ export class ObjectWrapper<Events> implements EventTarget<Events> {
 export function eventMixin<Events, Base extends Platform.Constructor.Constructor<object>>(base: Base) {
   console.assert(base !== HTMLElement);
   return class EventHandling extends base implements EventTarget<Events> {
-    #events = new ObjectWrapper<Events>();
+    // Note that the weird name is due to TSC disallowing private/protected fields in
+    // anonmous exported classes. We use a `__` prefix to prevent clashes with `base`.
+    // eslint-disable-next-line @devtools/no-underscored-properties, @typescript-eslint/naming-convention
+    __events = new ObjectWrapper<Events>();
 
     addEventListener<T extends keyof Events>(
         eventType: T, listener: (arg0: EventTargetEvent<Events[T]>) => void,
         thisObject?: Object): EventDescriptor<Events, T> {
-      return this.#events.addEventListener(eventType, listener, thisObject);
+      return this.__events.addEventListener(eventType, listener, thisObject);
     }
 
     once<T extends keyof Events>(eventType: T): Promise<Events[T]> {
-      return this.#events.once(eventType);
+      return this.__events.once(eventType);
     }
 
     removeEventListener<T extends keyof Events>(
         eventType: T, listener: (arg0: EventTargetEvent<Events[T]>) => void, thisObject?: Object): void {
-      this.#events.removeEventListener(eventType, listener, thisObject);
+      this.__events.removeEventListener(eventType, listener, thisObject);
     }
 
     hasEventListeners(eventType: keyof Events): boolean {
-      return this.#events.hasEventListeners(eventType);
+      return this.__events.hasEventListeners(eventType);
     }
 
     dispatchEventToListeners<T extends keyof Events>(
         eventType: Platform.TypeScriptUtilities.NoUnion<T>,
         ...eventData: EventPayloadToRestParameters<Events, T>): void {
-      this.#events.dispatchEventToListeners(eventType, ...eventData);
+      this.__events.dispatchEventToListeners(eventType, ...eventData);
     }
   };
 }

package/front_end/core/platform/StringUtilities.ts

@@ -276,6 +276,7 @@ export const removeURLFragment = (inputStr: string): string => {
 };
 
 const SPECIAL_REGEX_CHARACTERS = '^[]{}()\\.^$*+?|-,';
+const SPECIAL_URL_PATTERN_CHARACTERS = '?+*(){}\\:';
 
 export const regexSpecialCharacters = function(): string {
   return SPECIAL_REGEX_CHARACTERS;
@@ -450,6 +451,10 @@ export const escapeForRegExp = (str: string): string => {
   return escapeCharacters(str, SPECIAL_REGEX_CHARACTERS);
 };
 
+export const escapeForURLPattern = (text: string): string => {
+  return escapeCharacters(text, SPECIAL_URL_PATTERN_CHARACTERS);
+};
+
 export const naturalOrderComparator = (a: string, b: string): number => {
   const chunk = /^\d+|^\D+/;
   let chunkA, chunkB, numA, numB;

package/front_end/core/sdk/NetworkManager.ts

@@ -32,6 +32,10 @@ const UIStrings = {
    * @description Explanation why no content is shown for WebSocket connection.
    */
   noContentForWebSocket: 'Content for WebSockets is currently not supported',
+  /**
+   * @description Explanation why no content is shown for Server-Sent Events (SSE).
+   */
+  noContentForSSE: 'Content for Server-Sent Events (SSE) is currently not supported',
   /**
    * @description Explanation why no content is shown for redirect response.
    */
@@ -215,6 +219,9 @@ export class NetworkManager extends SDKModel<EventTypes> {
       return {error: i18nString(UIStrings.noContentForWebSocket)};
     }
     if (!request.finished) {
+      if (Boolean(request.eventSourceMessages()?.length)) {
+        return {error: i18nString(UIStrings.noContentForSSE)};
+      }
       await request.once(NetworkRequestEvents.FINISHED_LOADING);
     }
     if (request.isRedirect()) {

package/front_end/generated/InspectorBackendCommands.ts

@@ -867,7 +867,7 @@ inspectorBackend.registerCommand("Network.continueInterceptedRequest", [{"name":
 inspectorBackend.registerCommand("Network.deleteCookies", [{"name": "name", "type": "string", "optional": false, "description": "Name of the cookies to remove.", "typeRef": null}, {"name": "url", "type": "string", "optional": true, "description": "If specified, deletes all the cookies with the given name where domain and path match provided URL.", "typeRef": null}, {"name": "domain", "type": "string", "optional": true, "description": "If specified, deletes only cookies with the exact domain.", "typeRef": null}, {"name": "path", "type": "string", "optional": true, "description": "If specified, deletes only cookies with the exact path.", "typeRef": null}, {"name": "partitionKey", "type": "object", "optional": true, "description": "If specified, deletes only cookies with the the given name and partitionKey where all partition key attributes match the cookie partition key attribute.", "typeRef": "Network.CookiePartitionKey"}], [], "Deletes browser cookies with matching name and url or domain/path/partitionKey pair.");
 inspectorBackend.registerCommand("Network.disable", [], [], "Disables network tracking, prevents network events from being sent to the client.");
 inspectorBackend.registerCommand("Network.emulateNetworkConditions", [{"name": "offline", "type": "boolean", "optional": false, "description": "True to emulate internet disconnection.", "typeRef": null}, {"name": "latency", "type": "number", "optional": false, "description": "Minimum latency from request sent to response headers received (ms).", "typeRef": null}, {"name": "downloadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.", "typeRef": null}, {"name": "uploadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.", "typeRef": null}, {"name": "connectionType", "type": "string", "optional": true, "description": "Connection type if known.", "typeRef": "Network.ConnectionType"}, {"name": "packetLoss", "type": "number", "optional": true, "description": "WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.", "typeRef": null}, {"name": "packetQueueLength", "type": "number", "optional": true, "description": "WebRTC packet queue length (packet). 0 removes any queue length limitations.", "typeRef": null}, {"name": "packetReordering", "type": "boolean", "optional": true, "description": "WebRTC packetReordering feature.", "typeRef": null}], [], "Activates emulation of network conditions. This command is deprecated in favor of the emulateNetworkConditionsByRule and overrideNetworkState commands, which can be used together to the same effect.");
-inspectorBackend.registerCommand("Network.emulateNetworkConditionsByRule", [{"name": "offline", "type": "boolean", "optional": false, "description": "True to emulate internet disconnection.", "typeRef": null}, {"name": "matchedNetworkConditions", "type": "array", "optional": false, "description": "Configure conditions for matching requests. If multiple entries match a request, the first entry wins.  Global conditions can be configured by leaving the urlPattern for the conditions empty. These global conditions are also applied for throttling of p2p connections.", "typeRef": "Network.NetworkConditions"}], ["ruleIds"], "Activates emulation of network conditions for individual requests using URL match patterns. Unlike the deprecated Network.emulateNetworkConditions this method does not affect `navigator` state. Use Network.overrideNetworkState to explicitly modify `navigator` behavior.");
+inspectorBackend.registerCommand("Network.emulateNetworkConditionsByRule", [{"name": "offline", "type": "boolean", "optional": true, "description": "True to emulate internet disconnection. Deprecated, use the offline property in matchedNetworkConditions or emulateOfflineServiceWorker instead.", "typeRef": null}, {"name": "emulateOfflineServiceWorker", "type": "boolean", "optional": true, "description": "True to emulate offline service worker.", "typeRef": null}, {"name": "matchedNetworkConditions", "type": "array", "optional": false, "description": "Configure conditions for matching requests. If multiple entries match a request, the first entry wins.  Global conditions can be configured by leaving the urlPattern for the conditions empty. These global conditions are also applied for throttling of p2p connections.", "typeRef": "Network.NetworkConditions"}], ["ruleIds"], "Activates emulation of network conditions for individual requests using URL match patterns. Unlike the deprecated Network.emulateNetworkConditions this method does not affect `navigator` state. Use Network.overrideNetworkState to explicitly modify `navigator` behavior.");
 inspectorBackend.registerCommand("Network.overrideNetworkState", [{"name": "offline", "type": "boolean", "optional": false, "description": "True to emulate internet disconnection.", "typeRef": null}, {"name": "latency", "type": "number", "optional": false, "description": "Minimum latency from request sent to response headers received (ms).", "typeRef": null}, {"name": "downloadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.", "typeRef": null}, {"name": "uploadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.", "typeRef": null}, {"name": "connectionType", "type": "string", "optional": true, "description": "Connection type if known.", "typeRef": "Network.ConnectionType"}], [], "Override the state of navigator.onLine and navigator.connection.");
 inspectorBackend.registerCommand("Network.enable", [{"name": "maxTotalBufferSize", "type": "number", "optional": true, "description": "Buffer size in bytes to use when preserving network payloads (XHRs, etc). This is the maximum number of bytes that will be collected by this DevTools session.", "typeRef": null}, {"name": "maxResourceBufferSize", "type": "number", "optional": true, "description": "Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).", "typeRef": null}, {"name": "maxPostDataSize", "type": "number", "optional": true, "description": "Longest post body size (in bytes) that would be included in requestWillBeSent notification", "typeRef": null}, {"name": "reportDirectSocketTraffic", "type": "boolean", "optional": true, "description": "Whether DirectSocket chunk send/receive events should be reported.", "typeRef": null}, {"name": "enableDurableMessages", "type": "boolean", "optional": true, "description": "Enable storing response bodies outside of renderer, so that these survive a cross-process navigation. Requires maxTotalBufferSize to be set. Currently defaults to false. This field is being deprecated in favor of the dedicated configureDurableMessages command, due to the possibility of deadlocks when awaiting Network.enable before issuing Runtime.runIfWaitingForDebugger.", "typeRef": null}], [], "Enables network tracking, network events will now be delivered to the client.");
 inspectorBackend.registerCommand("Network.configureDurableMessages", [{"name": "maxTotalBufferSize", "type": "number", "optional": true, "description": "Buffer size in bytes to use when preserving network payloads (XHRs, etc).", "typeRef": null}, {"name": "maxResourceBufferSize", "type": "number", "optional": true, "description": "Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).", "typeRef": null}], [], "Configures storing response bodies outside of renderer, so that these survive a cross-process navigation. If maxTotalBufferSize is not set, durable messages are disabled.");
@@ -923,7 +923,7 @@ inspectorBackend.registerType("Network.SignedExchangeSignature", [{"name": "labe
 inspectorBackend.registerType("Network.SignedExchangeHeader", [{"name": "requestUrl", "type": "string", "optional": false, "description": "Signed exchange request URL.", "typeRef": null}, {"name": "responseCode", "type": "number", "optional": false, "description": "Signed exchange response code.", "typeRef": null}, {"name": "responseHeaders", "type": "object", "optional": false, "description": "Signed exchange response headers.", "typeRef": "Network.Headers"}, {"name": "signatures", "type": "array", "optional": false, "description": "Signed exchange response signature.", "typeRef": "Network.SignedExchangeSignature"}, {"name": "headerIntegrity", "type": "string", "optional": false, "description": "Signed exchange header integrity hash in the form of `sha256-<base64-hash-value>`.", "typeRef": null}]);
 inspectorBackend.registerType("Network.SignedExchangeError", [{"name": "message", "type": "string", "optional": false, "description": "Error message.", "typeRef": null}, {"name": "signatureIndex", "type": "number", "optional": true, "description": "The index of the signature which caused the error.", "typeRef": null}, {"name": "errorField", "type": "string", "optional": true, "description": "The field which caused the error.", "typeRef": "Network.SignedExchangeErrorField"}]);
 inspectorBackend.registerType("Network.SignedExchangeInfo", [{"name": "outerResponse", "type": "object", "optional": false, "description": "The outer response of signed HTTP exchange which was received from network.", "typeRef": "Network.Response"}, {"name": "hasExtraInfo", "type": "boolean", "optional": false, "description": "Whether network response for the signed exchange was accompanied by extra headers.", "typeRef": null}, {"name": "header", "type": "object", "optional": true, "description": "Information about the signed exchange header.", "typeRef": "Network.SignedExchangeHeader"}, {"name": "securityDetails", "type": "object", "optional": true, "description": "Security details for the signed exchange header.", "typeRef": "Network.SecurityDetails"}, {"name": "errors", "type": "array", "optional": true, "description": "Errors occurred while handling the signed exchange.", "typeRef": "Network.SignedExchangeError"}]);
-inspectorBackend.registerType("Network.NetworkConditions", [{"name": "urlPattern", "type": "string", "optional": false, "description": "Only matching requests will be affected by these conditions. Patterns use the URLPattern constructor string syntax (https://urlpattern.spec.whatwg.org/) and must be absolute. If the pattern is empty, all requests are matched (including p2p connections).", "typeRef": null}, {"name": "latency", "type": "number", "optional": false, "description": "Minimum latency from request sent to response headers received (ms).", "typeRef": null}, {"name": "downloadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.", "typeRef": null}, {"name": "uploadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.", "typeRef": null}, {"name": "connectionType", "type": "string", "optional": true, "description": "Connection type if known.", "typeRef": "Network.ConnectionType"}, {"name": "packetLoss", "type": "number", "optional": true, "description": "WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.", "typeRef": null}, {"name": "packetQueueLength", "type": "number", "optional": true, "description": "WebRTC packet queue length (packet). 0 removes any queue length limitations.", "typeRef": null}, {"name": "packetReordering", "type": "boolean", "optional": true, "description": "WebRTC packetReordering feature.", "typeRef": null}]);
+inspectorBackend.registerType("Network.NetworkConditions", [{"name": "urlPattern", "type": "string", "optional": false, "description": "Only matching requests will be affected by these conditions. Patterns use the URLPattern constructor string syntax (https://urlpattern.spec.whatwg.org/) and must be absolute. If the pattern is empty, all requests are matched (including p2p connections).", "typeRef": null}, {"name": "latency", "type": "number", "optional": false, "description": "Minimum latency from request sent to response headers received (ms).", "typeRef": null}, {"name": "downloadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.", "typeRef": null}, {"name": "uploadThroughput", "type": "number", "optional": false, "description": "Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.", "typeRef": null}, {"name": "connectionType", "type": "string", "optional": true, "description": "Connection type if known.", "typeRef": "Network.ConnectionType"}, {"name": "packetLoss", "type": "number", "optional": true, "description": "WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.", "typeRef": null}, {"name": "packetQueueLength", "type": "number", "optional": true, "description": "WebRTC packet queue length (packet). 0 removes any queue length limitations.", "typeRef": null}, {"name": "packetReordering", "type": "boolean", "optional": true, "description": "WebRTC packetReordering feature.", "typeRef": null}, {"name": "offline", "type": "boolean", "optional": true, "description": "True to emulate internet disconnection.", "typeRef": null}]);
 inspectorBackend.registerType("Network.BlockPattern", [{"name": "urlPattern", "type": "string", "optional": false, "description": "URL pattern to match. Patterns use the URLPattern constructor string syntax (https://urlpattern.spec.whatwg.org/) and must be absolute. Example: `*://*:*/*.css`.", "typeRef": null}, {"name": "block", "type": "boolean", "optional": false, "description": "Whether or not to block the pattern. If false, a matching request will not be blocked even if it matches a later `BlockPattern`.", "typeRef": null}]);
 inspectorBackend.registerType("Network.DirectTCPSocketOptions", [{"name": "noDelay", "type": "boolean", "optional": false, "description": "TCP_NODELAY option", "typeRef": null}, {"name": "keepAliveDelay", "type": "number", "optional": true, "description": "Expected to be unsigned integer.", "typeRef": null}, {"name": "sendBufferSize", "type": "number", "optional": true, "description": "Expected to be unsigned integer.", "typeRef": null}, {"name": "receiveBufferSize", "type": "number", "optional": true, "description": "Expected to be unsigned integer.", "typeRef": null}, {"name": "dnsQueryType", "type": "string", "optional": true, "description": "", "typeRef": "Network.DirectSocketDnsQueryType"}]);
 inspectorBackend.registerType("Network.DirectUDPSocketOptions", [{"name": "remoteAddr", "type": "string", "optional": true, "description": "", "typeRef": null}, {"name": "remotePort", "type": "number", "optional": true, "description": "Unsigned int 16.", "typeRef": null}, {"name": "localAddr", "type": "string", "optional": true, "description": "", "typeRef": null}, {"name": "localPort", "type": "number", "optional": true, "description": "Unsigned int 16.", "typeRef": null}, {"name": "dnsQueryType", "type": "string", "optional": true, "description": "", "typeRef": "Network.DirectSocketDnsQueryType"}, {"name": "sendBufferSize", "type": "number", "optional": true, "description": "Expected to be unsigned integer.", "typeRef": null}, {"name": "receiveBufferSize", "type": "number", "optional": true, "description": "Expected to be unsigned integer.", "typeRef": null}, {"name": "multicastLoopback", "type": "boolean", "optional": true, "description": "", "typeRef": null}, {"name": "multicastTimeToLive", "type": "number", "optional": true, "description": "Unsigned int 8.", "typeRef": null}, {"name": "multicastAllowAddressSharing", "type": "boolean", "optional": true, "description": "", "typeRef": null}]);

package/front_end/generated/protocol.ts

@@ -11376,6 +11376,10 @@ export namespace Network {
      * WebRTC packetReordering feature.
      */
     packetReordering?: boolean;
+    /**
+     * True to emulate internet disconnection.
+     */
+    offline?: boolean;
   }
 
   export interface BlockPattern {
@@ -12154,9 +12158,15 @@ export namespace Network {
 
   export interface EmulateNetworkConditionsByRuleRequest {
     /**
-     * True to emulate internet disconnection.
+     * True to emulate internet disconnection. Deprecated, use the offline property in matchedNetworkConditions
+     * or emulateOfflineServiceWorker instead.
+     * @deprecated
      */
-    offline: boolean;
+    offline?: boolean;
+    /**
+     * True to emulate offline service worker.
+     */
+    emulateOfflineServiceWorker?: boolean;
     /**
      * Configure conditions for matching requests. If multiple entries match a request, the first entry wins.  Global
      * conditions can be configured by leaving the urlPattern for the conditions empty. These global conditions are

package/front_end/models/ai_assistance/agents/README.md

@@ -0,0 +1,77 @@
+# AI Agents
+
+This directory contains the implementations of various AI agents used in the AI Assistance panel in Chrome DevTools.
+
+## Performance Agent
+
+The `PerformanceAgent` analyzes performance traces. This documentation details the specific data provided to the agent and the data it can retrieve via functions.
+
+### Initial Data Provided to the Agent
+
+When a conversation starts or the context changes, the agent is provided with a set of "facts" and query enhancements. This data forms the agent's base knowledge about the trace.
+
+#### Trace Facts (Initial Context)
+
+Facts are text-based data summaries injected into the conversation. The agent receives:
+
+- **Data Schema Descriptions**: Text explaining the format of call frame and network data to help the agent interpret subsequent tool outputs.
+- **Environment State**: Flags indicating if the trace is a fresh recording or loaded from an external file.
+- **Trace Summary Data**: A text summary containing key performance metrics (LCP, INP, CLS) and basic trace metadata.
+- **Critical Requests Data**: A text list of the most critical network requests identified in the trace.
+- **Main Thread Activity Data**: A bottom-up aggregated summary of where time was spent on the main thread.
+- **Longest Tasks Data**: A list of the longest tasks found on the main thread.
+- **Third Party Activity Data**: A summary of time spent on third-party scripts.
+
+#### Context Selection (Additional initial context)
+
+The agent receives additional initial context based on the user's context selection. The context can be a Trace, an Insight, or a specific Event:
+
+- **Trace Context**: No additional context is added beyond the base trace facts.
+- **Insight Context**: The agent receives the name and key of the specific performance insight selected.
+- **Event Context**: The agent receives the serialized details of the specific trace event selected.
+
+
+### Data Retrieval Functions (Tools)
+
+The agent can request additional data by calling functions. Here is the data the agent receives from each function:
+
+#### `getInsightDetails`
+- **Arguments**: `insightSetId` (string), `insightName` (string)
+- **Data Returned to Agent**: A detailed text representation of the specific insight (e.g., LCP breakdown components, render-blocking resource URLs).
+
+#### `getEventByKey`
+- **Arguments**: `eventKey` (string)
+- **Data Returned to Agent**: The full JSON representation of the specific trace event.
+
+#### `getMainThreadTrackSummary`
+- **Arguments**: `min` (integer, optional), `max` (integer, optional)
+- **Data Returned to Agent**: A comprehensive text summary of main thread activity *within the specified bounds*.
+  - **Note**: This differs from the initial "Main Thread Activity Data" fact as it is scoped to the provided time range and includes significantly more data: a **top-down tree**, a **bottom-up tree**, a **third-parties summary**, and a list of **related insights** for events in that range.
+
+#### `getNetworkTrackSummary`
+- **Arguments**: `min` (integer, optional), `max` (integer, optional)
+- **Data Returned to Agent**: A text summary of network requests and activity within the bounds.
+
+#### `getDetailedCallTree`
+- **Arguments**: `eventKey` (string)
+- **Data Returned to Agent**: A detailed call tree representation for the specified event.
+
+#### `addElementAnnotation`
+- **Arguments**: `elementId` (string), `annotationMessage` (string)
+- **Data Returned to Agent**: Confirmation of success or an error message. (Note: This function also modifies the DevTools UI by adding a visual annotation).
+
+#### `addNetworkRequestAnnotation`
+- **Arguments**: `eventKey` (string), `annotationMessage` (string)
+- **Data Returned to Agent**: Confirmation of success or an error message. (Note: This function also modifies the DevTools UI by adding a visual annotation).
+
+#### `getFunctionCode`
+- **Arguments**: `scriptUrl` (string), `line` (integer), `column` (integer)
+- **Data Returned to Agent**: The source code lines for the function, annotated with performance cost per line if available.
+
+#### `getResourceContent`
+- **Arguments**: `url` (string)
+- **Data Returned to Agent**: The full text content of the specified resource (e.g., script file).
+
+#### `selectEventByKey`
+- **Arguments**: `eventKey` (string)
+- **Data Returned to Agent**: Confirmation of success or an error message. (Note: This function also modifies the DevTools UI by selecting the event in the flamechart).

package/front_end/models/greendev/Prototypes.ts

@@ -9,7 +9,7 @@ let instance: Prototypes|null = null;
 
 export interface GreenDevSettings {
   aiAnnotations: Common.Settings.Setting<boolean>;
-  copyToGemini: Common.Settings.Setting<boolean>;
+  beyondStyling: Common.Settings.Setting<boolean>;
   breakpointDebuggerAgent: Common.Settings.Setting<boolean>;
   emulationCapabilities: Common.Settings.Setting<boolean>;
 }
@@ -42,8 +42,11 @@ export class Prototypes {
         false,
         Common.Settings.SettingStorageType.LOCAL,
     );
-    const copyToGemini =
-        settings.createSetting('greendev-copy-to-gemini-enabled', false, Common.Settings.SettingStorageType.LOCAL);
+    const beyondStyling = settings.createSetting(
+        'greendev-beyond-styling-enabled',
+        false,
+        Common.Settings.SettingStorageType.LOCAL,
+    );
     const breakpointDebuggerAgent = settings.createSetting(
         'greendev-breakpoint-debugger-agent-enabled',
         false,
@@ -55,6 +58,6 @@ export class Prototypes {
         Common.Settings.SettingStorageType.LOCAL,
     );
 
-    return {aiAnnotations, copyToGemini, breakpointDebuggerAgent, emulationCapabilities};
+    return {aiAnnotations, beyondStyling, breakpointDebuggerAgent, emulationCapabilities};
   }
 }

package/front_end/models/har/HARFormat.ts

@@ -171,6 +171,7 @@ export class HAREntry extends HARBase {
     this.custom.set('initiator', this.importInitiator(data['_initiator']));
     this.custom.set('priority', HARBase.optionalString(data['_priority']));
     this.custom.set('resourceType', HARBase.optionalString(data['_resourceType']));
+    this.custom.set('eventSourceMessages', this.#importEventSourceMessages(data['_eventSourceMessages']));
     this.custom.set('webSocketMessages', this.importWebSocketMessages(data['_webSocketMessages']));
   }
 
@@ -196,6 +197,21 @@ export class HAREntry extends HARBase {
     }
     return outputMessages;
   }
+
+  #importEventSourceMessages(inputMessages: any): HAREventSourceMessage[]|undefined {
+    if (!Array.isArray(inputMessages)) {
+      return;
+    }
+
+    const outputMessages = [];
+    for (const message of inputMessages) {
+      if (typeof message !== 'object') {
+        return;
+      }
+      outputMessages.push(new HAREventSourceMessage(message));
+    }
+    return outputMessages;
+  }
 }
 
 class HARRequest extends HARBase {
@@ -480,3 +496,17 @@ class HARWebSocketMessage extends HARBase {
     this.type = HARBase.optionalString(data['type']);
   }
 }
+
+class HAREventSourceMessage extends HARBase {
+  time: number|undefined;
+  eventName: string|undefined;
+  eventId: string|undefined;
+  data: string|undefined;
+  constructor(data: any) {
+    super(data);
+    this.time = HARBase.optionalNumber(data['time']);
+    this.eventName = HARBase.optionalString(data['eventName']);
+    this.eventId = HARBase.optionalString(data['eventId']);
+    this.data = HARBase.optionalString(data['data']);
+  }
+}

package/front_end/models/har/Importer.ts

@@ -137,7 +137,18 @@ export class Importer {
         async () =>
             new TextUtils.ContentData.ContentData(contentText ?? '', isBase64, mimeType ?? '', charset ?? undefined));
 
-    if (request.mimeType === Platform.MimeType.MimeType.EVENTSTREAM && contentText) {
+    const importedEventSourceMessages = entry.customAsArray('eventSourceMessages');
+
+    if (importedEventSourceMessages) {
+      for (const message of importedEventSourceMessages) {
+        if (message.time === undefined || message.eventName === undefined || message.eventId === undefined) {
+          continue;
+        }
+        // message.data may be undefined, if saved in a sanitized context
+
+        request.addEventSourceMessage(message.time, message.eventName, message.eventId, message.data);
+      }
+    } else if (request.mimeType === Platform.MimeType.MimeType.EVENTSTREAM && contentText) {
       const issueTime = entry.startedDateTime.getTime() / 1000;
       const onEvent = (eventName: string, data: string, eventId: string): void => {
         request.addEventSourceMessage(issueTime, eventName, eventId, data);

package/front_end/models/har/Log.ts

@@ -176,6 +176,26 @@ export class Entry {
       delete entry._webSocketMessages;
     }
 
+    const eventSourceMessages = harEntry.request.eventSourceMessages();
+    if (eventSourceMessages?.length) {
+      const messages = [];
+      for (const message of eventSourceMessages) {
+        const messageDTO: EventSourceMessageDTO = {
+          time: message.time,
+          eventName: message.eventName,
+          eventId: message.eventId,
+        };
+        if (!options.sanitize) {
+          // Omit the data when sanitizing, as it could contain sensitive information.
+          messageDTO.data = message.data;
+        }
+        messages.push(messageDTO);
+      }
+      entry._eventSourceMessages = messages;
+    } else {
+      delete entry._eventSourceMessages;
+    }
+
     return entry;
   }
 
@@ -490,6 +510,7 @@ export interface EntryDTO {
   _priority: Protocol.Network.ResourcePriority|null;
   _resourceType: string;
   _webSocketMessages?: Object[];
+  _eventSourceMessages?: EventSourceMessageDTO[];
   cache: Object;
   connection?: string;
   pageref?: string;
@@ -540,3 +561,10 @@ export interface LogDTO {
   pages: Page[];
   entries: EntryDTO[];
 }
+
+export interface EventSourceMessageDTO {
+  time: number;
+  eventName: string;
+  eventId: string;
+  data?: string;
+}

package/front_end/models/heap_snapshot/HeapSnapshotProxy.ts

@@ -17,13 +17,15 @@ export class HeapSnapshotWorkerProxy extends Common.ObjectWrapper.ObjectWrapper<
   readonly previousCallbacks = new Set<number>();
   readonly worker: PlatformApi.HostRuntime.Worker;
   interval?: number;
+  readonly workerUrl?: string;
 
-  constructor(eventHandler: (arg0: string, arg1: string) => void) {
+  constructor(eventHandler: (arg0: string, arg1: string) => void, workerUrl?: string) {
     super();
     this.eventHandler = eventHandler;
+    this.workerUrl = workerUrl;
     this.worker = Platform.HostRuntime.HOST_RUNTIME.createWorker(
-        new URL('../../entrypoints/heap_snapshot_worker/heap_snapshot_worker-entrypoint.js', import.meta.url)
-            .toString());
+        workerUrl ?? import.meta.resolve('../../entrypoints/heap_snapshot_worker/heap_snapshot_worker-entrypoint.js'),
+    );
     this.worker.onmessage = this.messageReceived.bind(this);
   }
 
@@ -236,7 +238,7 @@ export class HeapSnapshotLoaderProxy extends HeapSnapshotProxyObject implements
 
   async close(): Promise<void> {
     await this.callMethodPromise('close');
-    const secondWorker = new HeapSnapshotWorkerProxy(() => {});
+    const secondWorker = new HeapSnapshotWorkerProxy(() => {}, this.worker.workerUrl);
     const channel = new MessageChannel();
     await secondWorker.setupForSecondaryInit(channel.port2);
     const snapshotProxy = await this.callFactoryMethodPromise('buildSnapshot', HeapSnapshotProxy, [channel.port1]);

package/front_end/panels/ai_assistance/AiAssistancePanel.ts

@@ -44,6 +44,7 @@ import {
 import {DisabledWidget} from './components/DisabledWidget.js';
 import {ExploreWidget} from './components/ExploreWidget.js';
 import {MarkdownRendererWithCodeBlock} from './components/MarkdownRendererWithCodeBlock.js';
+import {OptInChangeDialog} from './components/OptInChangeDialog.js';
 import {PerformanceAgentMarkdownRenderer} from './components/PerformanceAgentMarkdownRenderer.js';
 import {StylingAgentMarkdownRenderer} from './components/StylingAgentMarkdownRenderer.js';
 import {
@@ -252,6 +253,16 @@ const UIStringsNotTranslate = {
    */
   inputDisclaimerForAccessibilityEnterpriseNoLogging:
       'Chat messages and the selected Lighthouse report are sent to Google. The content you submit and that is generated by this feature will not be used to improve Google’s AI models. This is an experimental AI feature and won’t always get it right.',
+  /**
+   * @description Disclaimer text right after the chat input when V2 is enabled.
+   */
+  inputDisclaimerV2:
+      'Chat messages, data accessible for this site via DevTools panels and Web APIs, and items you select such as network requests, files, and performance traces are sent to Google and may be seen by human reviewers to improve this feature. This is an experimental AI feature and won’t always get it right.',
+  /**
+   * @description Disclaimer text right after the chat input when V2 is enabled and enterprise logging is off.
+   */
+  inputDisclaimerEnterpriseNoLoggingV2:
+      'Chat messages, data accessible for this site via DevTools panels and Web APIs, and items you select such as network requests, files, and performance traces are sent to Google. The content submitted to and generated by this feature will not be used to improve Google’s AI models. This is an experimental AI feature and won’t always get it right.',
 } as const;
 
 const str_ = i18n.i18n.registerUIStrings('panels/ai_assistance/AiAssistancePanel.ts', UIStrings);
@@ -779,11 +790,32 @@ export class AiAssistancePanel extends UI.Panel.Panel {
             return await this.#conversationSummaryAgent.summarizeConversation(markdown);
           },
           onTextSubmit: async (
-
               text: string, imageInput?: Host.AidaClient.Part,
               multimodalInputType?: AiAssistanceModel.AiAgent.MultimodalInputType) => {
-            Host.userMetrics.actionTaken(Host.UserMetrics.Action.AiAssistanceQuerySubmitted);
-            await this.#startConversation(text, imageInput, multimodalInputType);
+            const submit = (): void => {
+              Host.userMetrics.actionTaken(Host.UserMetrics.Action.AiAssistanceQuerySubmitted);
+              void this.#startConversation(text, imageInput, multimodalInputType);
+            };
+
+            const isAIV2Enabled = Root.Runtime.hostConfig.devToolsAiAssistanceV2?.enabled;
+            const seenSetting =
+                Common.Settings.Settings.instance().moduleSetting('ai-assistance-v2-opt-in-change-dialog-seen');
+            if (isAIV2Enabled && !seenSetting.get()) {
+              OptInChangeDialog.show({
+                onGotIt: () => {
+                  seenSetting.set(true);
+                  submit();
+                },
+                onManageSettings: () => {
+                  seenSetting.set(true);
+                  this.#viewOutput.chatView?.setInputValue(text);
+                  void UI.ViewManager.ViewManager.instance().showView('chrome-ai');
+                },
+              });
+              return;
+            }
+
+            submit();
           },
           onInspectElementClick: this.#handleSelectElementClick.bind(this),
           onFeedbackSubmit: this.#handleFeedbackSubmit.bind(this),
@@ -1396,46 +1428,54 @@ export class AiAssistancePanel extends UI.Panel.Panel {
       return i18nString(UIStrings.inputDisclaimerForEmptyState);
     }
 
-    const noLogging = Root.Runtime.hostConfig.aidaAvailability?.enterprisePolicyValue ===
+    const loggingEnabled = Root.Runtime.hostConfig.aidaAvailability?.enterprisePolicyValue !==
         Root.Runtime.GenAiEnterprisePolicyValue.ALLOW_WITHOUT_LOGGING;
+
+    if (Root.Runtime.hostConfig.devToolsAiAssistanceV2?.enabled) {
+      if (loggingEnabled) {
+        return lockedString(UIStringsNotTranslate.inputDisclaimerV2);
+      }
+      return lockedString(UIStringsNotTranslate.inputDisclaimerEnterpriseNoLoggingV2);
+    }
+
     switch (this.#conversation.type) {
       case AiAssistanceModel.AiHistoryStorage.ConversationType.STYLING:
-        if (noLogging) {
-          return lockedString(UIStringsNotTranslate.inputDisclaimerForStylingEnterpriseNoLogging);
+        if (loggingEnabled) {
+          return lockedString(UIStringsNotTranslate.inputDisclaimerForStyling);
         }
-        return lockedString(UIStringsNotTranslate.inputDisclaimerForStyling);
+        return lockedString(UIStringsNotTranslate.inputDisclaimerForStylingEnterpriseNoLogging);
       case AiAssistanceModel.AiHistoryStorage.ConversationType.FILE:
-        if (noLogging) {
-          return lockedString(UIStringsNotTranslate.inputDisclaimerForFileEnterpriseNoLogging);
+        if (loggingEnabled) {
+          return lockedString(UIStringsNotTranslate.inputDisclaimerForFile);
         }
-        return lockedString(UIStringsNotTranslate.inputDisclaimerForFile);
+        return lockedString(UIStringsNotTranslate.inputDisclaimerForFileEnterpriseNoLogging);
       case AiAssistanceModel.AiHistoryStorage.ConversationType.NETWORK:
-        if (noLogging) {
-          return lockedString(UIStringsNotTranslate.inputDisclaimerForNetworkEnterpriseNoLogging);
+        if (loggingEnabled) {
+          return lockedString(UIStringsNotTranslate.inputDisclaimerForNetwork);
         }
-        return lockedString(UIStringsNotTranslate.inputDisclaimerForNetwork);
+        return lockedString(UIStringsNotTranslate.inputDisclaimerForNetworkEnterpriseNoLogging);
 
       // It is deliberate that both Performance agents use the same disclaimer
       // text and this has been approved by Privacy.
       case AiAssistanceModel.AiHistoryStorage.ConversationType.PERFORMANCE:
-        if (noLogging) {
-          return lockedString(UIStringsNotTranslate.inputDisclaimerForPerformanceEnterpriseNoLogging);
+        if (loggingEnabled) {
+          return lockedString(UIStringsNotTranslate.inputDisclaimerForPerformance);
         }
-        return lockedString(UIStringsNotTranslate.inputDisclaimerForPerformance);
+        return lockedString(UIStringsNotTranslate.inputDisclaimerForPerformanceEnterpriseNoLogging);
 
       case AiAssistanceModel.AiHistoryStorage.ConversationType.ACCESSIBILITY:
-        if (noLogging) {
-          return lockedString(UIStringsNotTranslate.inputDisclaimerForAccessibilityEnterpriseNoLogging);
+        if (loggingEnabled) {
+          return lockedString(UIStringsNotTranslate.inputDisclaimerForAccessibility);
         }
-        return lockedString(UIStringsNotTranslate.inputDisclaimerForAccessibility);
+        return lockedString(UIStringsNotTranslate.inputDisclaimerForAccessibilityEnterpriseNoLogging);
 
       case AiAssistanceModel.AiHistoryStorage.ConversationType.BREAKPOINT:
 
       case AiAssistanceModel.AiHistoryStorage.ConversationType.NONE:
-        if (noLogging) {
-          return lockedString(UIStringsNotTranslate.inputDisclaimerForNoContextEnterpriseNoLogging);
+        if (loggingEnabled) {
+          return lockedString(UIStringsNotTranslate.inputDisclaimerForNoContext);
         }
-        return lockedString(UIStringsNotTranslate.inputDisclaimerForNoContext);
+        return lockedString(UIStringsNotTranslate.inputDisclaimerForNoContextEnterpriseNoLogging);
     }
   }