chrome-devtools-frontend 1.0.1638082 → 1.0.1640418

package/front_end/core/host/AidaClientTypes.ts

@@ -29,16 +29,18 @@ export interface Content {
   role: Role;
 }
 
-export type Part = {
-  text: string,
-}|{
-  functionCall: AidaFunctionCall,
-}|{
+export interface FunctionResponsePart {
   functionResponse: {
     name: string,
     response: Record<string, unknown>,
-  },
+  };
+}
+
+export type Part = {
+  text: string,
 }|{
+  functionCall: AidaFunctionCall,
+}|FunctionResponsePart|{
   /** Inline media bytes. */
   inlineData: MediaBlob,
 };

package/front_end/core/sdk/DOMStorageModel.ts

@@ -59,7 +59,7 @@ export class DOMStorage extends Common.ObjectWrapper.ObjectWrapper<DOMStorage.Ev
     return DOMStorage.storageId(this.#storageKey, this.#isLocalStorage);
   }
 
-  get storageKey(): string|null {
+  get storageKey(): string {
     return this.#storageKey;
   }
 

package/front_end/core/sdk/TargetManager.ts

@@ -105,13 +105,26 @@ export class TargetManager extends Common.ObjectWrapper.ObjectWrapper<EventTypes
     await Promise.all(suspendPromises);
   }
 
+  async #waitForPromiseWithTimeout(promise: Promise<void>, timeoutMessage: string): Promise<void> {
+    const {promise: timeoutPromise, resolve: timeoutResolve} = Promise.withResolvers<void>();
+    const timeoutId = globalThis.setTimeout(() => {
+      Common.Console.Console.instance().warn(timeoutMessage);
+      timeoutResolve();
+    }, 2000);
+    await Promise.race([promise, timeoutPromise]);
+    globalThis.clearTimeout(timeoutId);
+    timeoutResolve();  // avoids "pending async operations" error from test harness.
+  }
+
   async resumeAllTargets(): Promise<void> {
     if (!this.#isSuspended) {
       return;
     }
     this.#isSuspended = false;
     this.dispatchEventToListeners(Events.SUSPEND_STATE_CHANGED);
-    const resumePromises = Array.from(this.#targets.values(), target => target.resume());
+    const resumePromises = Array.from(this.#targets.values(), async target => {
+      await this.#waitForPromiseWithTimeout(target.resume(), `Timeout waiting for target ${target.name()} to resume`);
+    });
     await Promise.all(resumePromises);
   }
 

package/front_end/entrypoints/heap_snapshot_worker/HeapSnapshot.ts

@@ -2818,6 +2818,153 @@ export abstract class HeapSnapshot {
     return new HeapSnapshotEdgesProvider(this, filter, node.retainers(), indexProvider);
   }
 
+  getRetainingPaths(
+      nodeIndex: number,
+      maxDepth = 30,
+      maxNodes = 5000,
+      maxSiblings = 100,
+      ): HeapSnapshotModel.HeapSnapshotModel.RetainingPaths {
+    const {
+      nodeFieldCount,
+      firstRetainerIndex,
+      retainingNodes,
+      retainingEdges,
+      edgeTypeOffset,
+      edgeWeakType,
+      containmentEdges
+    } = this;
+    const distances = this.#nodeDistancesForRetainersView ?? this.nodeDistances;
+    let traversedNodesCount = 0;
+    const visiting = new Set<number>();
+    const visited = new Map<number, number>();
+    // Distance 0: Synthetic root, Distance 1: (GC roots), Distance 2: e.g. (Stack roots) or (Handle scope)
+    const rootDistance = 2;
+    const limitsReached: {depth?: boolean, nodes?: boolean, siblings?: boolean} = {};
+
+    const buildForest =
+        (currentIndex: number, currentDepth: number): HeapSnapshotModel.HeapSnapshotModel.RetainingEdge[] => {
+          traversedNodesCount++;
+
+          if (traversedNodesCount > maxNodes) {
+            limitsReached.nodes = true;
+            return [];
+          }
+
+          if (currentDepth >= maxDepth) {
+            limitsReached.depth = true;
+            return [];
+          }
+
+          const ordinal = currentIndex / nodeFieldCount;
+          const currentDistance = distances[ordinal];
+
+          if (currentDistance <= rootDistance) {
+            return [];
+          }
+
+          if (visiting.has(currentIndex)) {
+            return [];
+          }
+
+          const cachedDepth = visited.get(currentIndex);
+          if (cachedDepth !== undefined) {
+            // Only revisit the node if the current depth is less than the cached depth. In that case we might now find a path to the root.
+            if (currentDepth >= cachedDepth) {
+              return [];
+            }
+          }
+
+          visiting.add(currentIndex);
+
+          const beginRetainerIndex = firstRetainerIndex[ordinal];
+          const endRetainerIndex = firstRetainerIndex[ordinal + 1];
+
+          const retainers: Array<{retainerIndex: number, dist: number, nodeIndex: number}> = [];
+
+          for (let retainerIndex = beginRetainerIndex; retainerIndex < endRetainerIndex; ++retainerIndex) {
+            const retainerNodeIndex = retainingNodes[retainerIndex];
+            const retainerNodeOrdinal = retainerNodeIndex / nodeFieldCount;
+            const dist = distances[retainerNodeOrdinal];
+
+            const globalEdgeIndex = retainingEdges[retainerIndex];
+            if (this.isEdgeIgnoredInRetainersView(globalEdgeIndex)) {
+              continue;
+            }
+
+            // Skip weak edges
+            const edgeType = containmentEdges.getValue(globalEdgeIndex + edgeTypeOffset);
+            if (edgeType === edgeWeakType) {
+              continue;
+            }
+
+            if (dist >= 0) {
+              const remainingDepth = maxDepth - currentDepth;
+              // Since recursion halts at rootDistance, the remaining edges to path termination is exactly dist - rootDistance.
+              const neededDepth = dist - rootDistance;
+              if (neededDepth < remainingDepth) {
+                retainers.push({retainerIndex, dist, nodeIndex: retainerNodeIndex});
+              } else {
+                limitsReached.depth = true;
+              }
+            }
+          }
+
+          // Sort retainers by distance (shortest to GC roots first).
+          retainers.sort((a, b) => a.dist - b.dist);
+
+          // Limit number of traversed retainers.
+          const length = Math.min(retainers.length, maxSiblings);
+          if (retainers.length > maxSiblings) {
+            limitsReached.siblings = true;
+          }
+
+          const forest: HeapSnapshotModel.HeapSnapshotModel.RetainingEdge[] = [];
+
+          for (let i = 0; i < length; i++) {
+            const retainer = retainers[i];
+            const edge = this.createRetainingEdge(retainer.retainerIndex);
+            const globalEdgeIndex = retainingEdges[retainer.retainerIndex];
+
+            const isRoot = retainer.dist === rootDistance;
+            let children: HeapSnapshotModel.HeapSnapshotModel.RetainingEdge[] = [];
+
+            if (isRoot) {
+              traversedNodesCount++;
+
+              if (traversedNodesCount > maxNodes) {
+                limitsReached.nodes = true;
+                break;
+              }
+            } else {
+              children = buildForest(retainer.nodeIndex, currentDepth + 1);
+              if (children.length === 0) {
+                continue;
+              }
+            }
+
+            const retainerNode = this.createNode(retainer.nodeIndex);
+            forest.push({
+              edgeIndex: globalEdgeIndex,
+              edgeName: edge.name(),
+              edgeType: edge.type(),
+              nodeId: retainerNode.id(),
+              nodeIndex: retainer.nodeIndex,
+              nodeName: retainerNode.name(),
+              distance: retainer.dist,
+              children,
+            });
+          }
+
+          visiting.delete(currentIndex);
+          visited.set(currentIndex, currentDepth);
+
+          return forest;
+        };
+
+    const paths = buildForest(nodeIndex, 0);
+    return {paths, limitsReached};
+  }
+
   createAddedNodesProvider(baseSnapshotId: string, classKey: string): HeapSnapshotNodesProvider {
     const snapshotDiff = this.#snapshotDiffs[baseSnapshotId];
     const diffForClass = snapshotDiff[classKey];

package/front_end/generated/ARIAProperties.js

@@ -762,10 +762,6 @@ export const config = {
     "spinbutton"
    ],
    "type": "string"
-  },
-  {
-   "name": "aria-virtualcontent",
-   "type": "string"
   }
  ],
  "metadata": {

package/front_end/generated/InspectorBackendCommands.ts

@@ -43,6 +43,10 @@ inspectorBackend.registerType("Accessibility.AXProperty", [{"name": "name", "typ
 inspectorBackend.registerType("Accessibility.AXValue", [{"name": "type", "type": "string", "optional": false, "description": "The type of this value.", "typeRef": "Accessibility.AXValueType"}, {"name": "value", "type": "any", "optional": true, "description": "The computed value of this property.", "typeRef": null}, {"name": "relatedNodes", "type": "array", "optional": true, "description": "One or more related nodes, if applicable.", "typeRef": "Accessibility.AXRelatedNode"}, {"name": "sources", "type": "array", "optional": true, "description": "The sources which contributed to the computation of this property.", "typeRef": "Accessibility.AXValueSource"}]);
 inspectorBackend.registerType("Accessibility.AXNode", [{"name": "nodeId", "type": "string", "optional": false, "description": "Unique identifier for this node.", "typeRef": "Accessibility.AXNodeId"}, {"name": "ignored", "type": "boolean", "optional": false, "description": "Whether this node is ignored for accessibility", "typeRef": null}, {"name": "ignoredReasons", "type": "array", "optional": true, "description": "Collection of reasons why this node is hidden.", "typeRef": "Accessibility.AXProperty"}, {"name": "role", "type": "object", "optional": true, "description": "This `Node`'s role, whether explicit or implicit.", "typeRef": "Accessibility.AXValue"}, {"name": "chromeRole", "type": "object", "optional": true, "description": "This `Node`'s Chrome raw role.", "typeRef": "Accessibility.AXValue"}, {"name": "name", "type": "object", "optional": true, "description": "The accessible name for this `Node`.", "typeRef": "Accessibility.AXValue"}, {"name": "description", "type": "object", "optional": true, "description": "The accessible description for this `Node`.", "typeRef": "Accessibility.AXValue"}, {"name": "value", "type": "object", "optional": true, "description": "The value for this `Node`.", "typeRef": "Accessibility.AXValue"}, {"name": "properties", "type": "array", "optional": true, "description": "All other properties", "typeRef": "Accessibility.AXProperty"}, {"name": "parentId", "type": "string", "optional": true, "description": "ID for this node's parent.", "typeRef": "Accessibility.AXNodeId"}, {"name": "childIds", "type": "array", "optional": true, "description": "IDs for each of this node's child nodes.", "typeRef": "Accessibility.AXNodeId"}, {"name": "backendDOMNodeId", "type": "number", "optional": true, "description": "The backend ID for the associated DOM node, if any.", "typeRef": "DOM.BackendNodeId"}, {"name": "frameId", "type": "string", "optional": true, "description": "The frame ID for the frame associated with this nodes document.", "typeRef": "Page.FrameId"}]);
 
+// Ads.
+inspectorBackend.registerCommand("Ads.getAdMetrics", [], ["metrics"], "Retrieves ad metrics for the current page.");
+inspectorBackend.registerType("Ads.AdMetrics", [{"name": "viewportAdDensityByArea", "type": "number", "optional": false, "description": "The viewport ad density by area, represented as a percentage (an integer between 0 and 100).", "typeRef": null}, {"name": "averageViewportAdDensityByArea", "type": "number", "optional": false, "description": "The time-weighted average of the viewport ad density by area, measured across the duration of the page.", "typeRef": null}, {"name": "viewportAdCount", "type": "number", "optional": false, "description": "The number of ads currently visible within the viewport.", "typeRef": null}, {"name": "averageViewportAdCount", "type": "number", "optional": false, "description": "The time-weighted average of the viewport ad count, measured across the duration of the page.", "typeRef": null}, {"name": "totalAdCpuTime", "type": "number", "optional": false, "description": "The total ad CPU usage, in milliseconds.", "typeRef": null}, {"name": "totalAdNetworkBytes", "type": "number", "optional": false, "description": "The total ad network bytes.", "typeRef": null}]);
+
 // Animation.
 inspectorBackend.registerEnum("Animation.AnimationType", {CSSTransition: "CSSTransition", CSSAnimation: "CSSAnimation", WebAnimation: "WebAnimation"});
 inspectorBackend.registerEvent("Animation.animationCanceled", ["id"]);
@@ -87,7 +91,7 @@ inspectorBackend.registerEnum("Audits.GenericIssueErrorType", {FormLabelForNameE
 inspectorBackend.registerEnum("Audits.ClientHintIssueReason", {MetaTagAllowListInvalidOrigin: "MetaTagAllowListInvalidOrigin", MetaTagModifiedHTML: "MetaTagModifiedHTML"});
 inspectorBackend.registerEnum("Audits.FederatedAuthRequestIssueReason", {ShouldEmbargo: "ShouldEmbargo", TooManyRequests: "TooManyRequests", WellKnownHttpNotFound: "WellKnownHttpNotFound", WellKnownNoResponse: "WellKnownNoResponse", WellKnownInvalidResponse: "WellKnownInvalidResponse", WellKnownListEmpty: "WellKnownListEmpty", WellKnownInvalidContentType: "WellKnownInvalidContentType", ConfigNotInWellKnown: "ConfigNotInWellKnown", WellKnownTooBig: "WellKnownTooBig", ConfigHttpNotFound: "ConfigHttpNotFound", ConfigNoResponse: "ConfigNoResponse", ConfigInvalidResponse: "ConfigInvalidResponse", ConfigInvalidContentType: "ConfigInvalidContentType", IdpNotPotentiallyTrustworthy: "IdpNotPotentiallyTrustworthy", DisabledInSettings: "DisabledInSettings", DisabledInFlags: "DisabledInFlags", ErrorFetchingSignin: "ErrorFetchingSignin", InvalidSigninResponse: "InvalidSigninResponse", AccountsHttpNotFound: "AccountsHttpNotFound", AccountsNoResponse: "AccountsNoResponse", AccountsInvalidResponse: "AccountsInvalidResponse", AccountsListEmpty: "AccountsListEmpty", AccountsInvalidContentType: "AccountsInvalidContentType", IdTokenHttpNotFound: "IdTokenHttpNotFound", IdTokenNoResponse: "IdTokenNoResponse", IdTokenInvalidResponse: "IdTokenInvalidResponse", IdTokenIdpErrorResponse: "IdTokenIdpErrorResponse", IdTokenCrossSiteIdpErrorResponse: "IdTokenCrossSiteIdpErrorResponse", IdTokenInvalidRequest: "IdTokenInvalidRequest", IdTokenInvalidContentType: "IdTokenInvalidContentType", ErrorIdToken: "ErrorIdToken", Canceled: "Canceled", RpPageNotVisible: "RpPageNotVisible", SilentMediationFailure: "SilentMediationFailure", NotSignedInWithIdp: "NotSignedInWithIdp", MissingTransientUserActivation: "MissingTransientUserActivation", ReplacedByActiveMode: "ReplacedByActiveMode", RelyingPartyOriginIsOpaque: "RelyingPartyOriginIsOpaque", TypeNotMatching: "TypeNotMatching", UiDismissedNoEmbargo: "UiDismissedNoEmbargo", CorsError: "CorsError", SuppressedBySegmentationPlatform: "SuppressedBySegmentationPlatform"});
 inspectorBackend.registerEnum("Audits.FederatedAuthUserInfoRequestIssueReason", {NotSameOrigin: "NotSameOrigin", NotIframe: "NotIframe", NotPotentiallyTrustworthy: "NotPotentiallyTrustworthy", NoAPIPermission: "NoApiPermission", NotSignedInWithIdp: "NotSignedInWithIdp", NoAccountSharingPermission: "NoAccountSharingPermission", InvalidConfigOrWellKnown: "InvalidConfigOrWellKnown", InvalidAccountsResponse: "InvalidAccountsResponse", NoReturningUserFromFetchedAccounts: "NoReturningUserFromFetchedAccounts"});
-inspectorBackend.registerEnum("Audits.EmailVerificationRequestIssueReason", {InvalidEmail: "InvalidEmail", DnsFetchFailed: "DnsFetchFailed", DnsInvalidRecord: "DnsInvalidRecord", WellKnownHttpNotFound: "WellKnownHttpNotFound", WellKnownNoResponse: "WellKnownNoResponse", WellKnownInvalidResponse: "WellKnownInvalidResponse", WellKnownListEmpty: "WellKnownListEmpty", WellKnownInvalidContentType: "WellKnownInvalidContentType", WellKnownMissingIssuanceEndpoint: "WellKnownMissingIssuanceEndpoint", WellKnownIssuanceEndpointCrossOrigin: "WellKnownIssuanceEndpointCrossOrigin", WellKnownUnsupportedSigningAlgorithm: "WellKnownUnsupportedSigningAlgorithm", TokenHttpNotFound: "TokenHttpNotFound", TokenNoResponse: "TokenNoResponse", TokenInvalidResponse: "TokenInvalidResponse", TokenInvalidContentType: "TokenInvalidContentType", TokenMalformedSdJwt: "TokenMalformedSdJwt", TokenInvalidSdJwt: "TokenInvalidSdJwt", KeyBindingSigningFailed: "KeyBindingSigningFailed", RpOriginIsOpaque: "RpOriginIsOpaque", WellKnownMissingAccountsEndpoint: "WellKnownMissingAccountsEndpoint", UserLoggedOut: "UserLoggedOut", WellKnownAccountsEndpointCrossOrigin: "WellKnownAccountsEndpointCrossOrigin"});
+inspectorBackend.registerEnum("Audits.EmailVerificationRequestIssueReason", {InvalidEmail: "InvalidEmail", DnsFetchFailed: "DnsFetchFailed", DnsInvalidRecord: "DnsInvalidRecord", WellKnownHttpNotFound: "WellKnownHttpNotFound", WellKnownNoResponse: "WellKnownNoResponse", WellKnownInvalidResponse: "WellKnownInvalidResponse", WellKnownListEmpty: "WellKnownListEmpty", WellKnownInvalidContentType: "WellKnownInvalidContentType", WellKnownMissingIssuanceEndpoint: "WellKnownMissingIssuanceEndpoint", WellKnownIssuanceEndpointCrossOrigin: "WellKnownIssuanceEndpointCrossOrigin", WellKnownUnsupportedSigningAlgorithm: "WellKnownUnsupportedSigningAlgorithm", TokenHttpNotFound: "TokenHttpNotFound", TokenNoResponse: "TokenNoResponse", TokenInvalidResponse: "TokenInvalidResponse", TokenInvalidContentType: "TokenInvalidContentType", TokenMalformedSdJwt: "TokenMalformedSdJwt", TokenInvalidSdJwt: "TokenInvalidSdJwt", KeyBindingSigningFailed: "KeyBindingSigningFailed", RpOriginIsOpaque: "RpOriginIsOpaque", WellKnownMissingAccountsEndpoint: "WellKnownMissingAccountsEndpoint", UserLoggedOut: "UserLoggedOut", WellKnownAccountsEndpointCrossOrigin: "WellKnownAccountsEndpointCrossOrigin", AccountsHttpNotFound: "AccountsHttpNotFound", AccountsNoResponse: "AccountsNoResponse", AccountsInvalidResponse: "AccountsInvalidResponse", AccountsInvalidContentType: "AccountsInvalidContentType", AccountsEmptyList: "AccountsEmptyList", EmailVerificationWellKnownHttpNotFound: "EmailVerificationWellKnownHttpNotFound", EmailVerificationWellKnownNoResponse: "EmailVerificationWellKnownNoResponse", EmailVerificationWellKnownInvalidResponse: "EmailVerificationWellKnownInvalidResponse", EmailVerificationWellKnownInvalidContentType: "EmailVerificationWellKnownInvalidContentType", JwksHttpNotFound: "JwksHttpNotFound", JwksInvalidResponse: "JwksInvalidResponse", TokenVerificationSdJwtUnsupportedHeaderAlg: "TokenVerificationSdJwtUnsupportedHeaderAlg", TokenVerificationSdJwtMissingIss: "TokenVerificationSdJwtMissingIss", TokenVerificationSdJwtMissingIat: "TokenVerificationSdJwtMissingIat", TokenVerificationSdJwtMissingCnf: "TokenVerificationSdJwtMissingCnf", TokenVerificationSdJwtMissingEmail: "TokenVerificationSdJwtMissingEmail", TokenVerificationSdJwtInvalidIssuedAt: "TokenVerificationSdJwtInvalidIssuedAt", TokenVerificationSdJwtInvalidIssuer: "TokenVerificationSdJwtInvalidIssuer", TokenVerificationSdJwtJwksMissingKeys: "TokenVerificationSdJwtJwksMissingKeys", TokenVerificationSdJwtSignatureFailed: "TokenVerificationSdJwtSignatureFailed", TokenVerificationSdJwtInvalidEmailVerified: "TokenVerificationSdJwtInvalidEmailVerified", TokenVerificationSdJwtInvalidEmail: "TokenVerificationSdJwtInvalidEmail", TokenVerificationSdJwtInvalidHolderKey: "TokenVerificationSdJwtInvalidHolderKey", TokenVerificationKbInvalidTyp: "TokenVerificationKbInvalidTyp", TokenVerificationKbMissingAud: "TokenVerificationKbMissingAud", TokenVerificationKbMissingNonce: "TokenVerificationKbMissingNonce", TokenVerificationKbMissingIat: "TokenVerificationKbMissingIat", TokenVerificationKbMissingSdHash: "TokenVerificationKbMissingSdHash", TokenVerificationKbInvalidIssuedAt: "TokenVerificationKbInvalidIssuedAt", TokenVerificationKbInvalidAudience: "TokenVerificationKbInvalidAudience", TokenVerificationKbInvalidNonce: "TokenVerificationKbInvalidNonce", TokenVerificationKbInvalidSdHash: "TokenVerificationKbInvalidSdHash", TokenVerificationKbMissingCnf: "TokenVerificationKbMissingCnf", TokenVerificationKbSignatureFailed: "TokenVerificationKbSignatureFailed"});
 inspectorBackend.registerEnum("Audits.PartitioningBlobURLInfo", {BlockedCrossPartitionFetching: "BlockedCrossPartitionFetching", EnforceNoopenerForNavigation: "EnforceNoopenerForNavigation"});
 inspectorBackend.registerEnum("Audits.ElementAccessibilityIssueReason", {DisallowedSelectChild: "DisallowedSelectChild", DisallowedOptGroupChild: "DisallowedOptGroupChild", NonPhrasingContentOptionChild: "NonPhrasingContentOptionChild", InteractiveContentOptionChild: "InteractiveContentOptionChild", InteractiveContentLegendChild: "InteractiveContentLegendChild", InteractiveContentSummaryDescendant: "InteractiveContentSummaryDescendant"});
 inspectorBackend.registerEnum("Audits.StyleSheetLoadingIssueReason", {LateImportRule: "LateImportRule", RequestFailed: "RequestFailed"});
@@ -352,7 +356,7 @@ inspectorBackend.registerCommand("CrashReportContext.getEntries", [], ["entries"
 inspectorBackend.registerType("CrashReportContext.CrashReportContextEntry", [{"name": "key", "type": "string", "optional": false, "description": "", "typeRef": null}, {"name": "value", "type": "string", "optional": false, "description": "", "typeRef": null}, {"name": "frameId", "type": "string", "optional": false, "description": "The ID of the frame where the key-value pair was set.", "typeRef": "Page.FrameId"}]);
 
 // DOM.
-inspectorBackend.registerEnum("DOM.PseudoType", {FirstLine: "first-line", FirstLetter: "first-letter", Checkmark: "checkmark", Before: "before", After: "after", ExpandIcon: "expand-icon", PickerIcon: "picker-icon", InterestButton: "interest-button", Marker: "marker", Backdrop: "backdrop", Column: "column", Selection: "selection", SearchText: "search-text", TargetText: "target-text", SpellingError: "spelling-error", GrammarError: "grammar-error", Highlight: "highlight", FirstLineInherited: "first-line-inherited", ScrollMarker: "scroll-marker", ScrollMarkerGroup: "scroll-marker-group", ScrollButton: "scroll-button", Scrollbar: "scrollbar", ScrollbarThumb: "scrollbar-thumb", ScrollbarButton: "scrollbar-button", ScrollbarTrack: "scrollbar-track", ScrollbarTrackPiece: "scrollbar-track-piece", ScrollbarCorner: "scrollbar-corner", Resizer: "resizer", InputListButton: "input-list-button", ViewTransition: "view-transition", ViewTransitionGroup: "view-transition-group", ViewTransitionImagePair: "view-transition-image-pair", ViewTransitionGroupChildren: "view-transition-group-children", ViewTransitionOld: "view-transition-old", ViewTransitionNew: "view-transition-new", Placeholder: "placeholder", FileSelectorButton: "file-selector-button", DetailsContent: "details-content", Picker: "picker", PermissionIcon: "permission-icon", OverscrollAreaParent: "overscroll-area-parent"});
+inspectorBackend.registerEnum("DOM.PseudoType", {FirstLine: "first-line", FirstLetter: "first-letter", Checkmark: "checkmark", Before: "before", After: "after", ExpandIcon: "expand-icon", PickerIcon: "picker-icon", InterestButton: "interest-button", Marker: "marker", Backdrop: "backdrop", Column: "column", Selection: "selection", SearchText: "search-text", TargetText: "target-text", SpellingError: "spelling-error", GrammarError: "grammar-error", Highlight: "highlight", FirstLineInherited: "first-line-inherited", ScrollMarker: "scroll-marker", ScrollMarkerGroup: "scroll-marker-group", ScrollButton: "scroll-button", Scrollbar: "scrollbar", ScrollbarThumb: "scrollbar-thumb", ScrollbarButton: "scrollbar-button", ScrollbarTrack: "scrollbar-track", ScrollbarTrackPiece: "scrollbar-track-piece", ScrollbarCorner: "scrollbar-corner", Resizer: "resizer", InputListButton: "input-list-button", ViewTransition: "view-transition", ViewTransitionGroup: "view-transition-group", ViewTransitionImagePair: "view-transition-image-pair", ViewTransitionGroupChildren: "view-transition-group-children", ViewTransitionOld: "view-transition-old", ViewTransitionNew: "view-transition-new", Placeholder: "placeholder", FileSelectorButton: "file-selector-button", DetailsContent: "details-content", Picker: "picker", PermissionIcon: "permission-icon", OverscrollAreaParent: "overscroll-area-parent", Skeleton: "skeleton"});
 inspectorBackend.registerEnum("DOM.ShadowRootType", {UserAgent: "user-agent", Open: "open", Closed: "closed"});
 inspectorBackend.registerEnum("DOM.CompatibilityMode", {QuirksMode: "QuirksMode", LimitedQuirksMode: "LimitedQuirksMode", NoQuirksMode: "NoQuirksMode"});
 inspectorBackend.registerEnum("DOM.PhysicalAxes", {Horizontal: "Horizontal", Vertical: "Vertical", Both: "Both"});
@@ -1213,7 +1217,7 @@ inspectorBackend.registerEnum("Preload.SpeculationAction", {Prefetch: "Prefetch"
 inspectorBackend.registerEnum("Preload.SpeculationTargetHint", {Blank: "Blank", Self: "Self"});
 inspectorBackend.registerEnum("Preload.PrerenderFinalStatus", {Activated: "Activated", Destroyed: "Destroyed", LowEndDevice: "LowEndDevice", InvalidSchemeRedirect: "InvalidSchemeRedirect", InvalidSchemeNavigation: "InvalidSchemeNavigation", NavigationRequestBlockedByCsp: "NavigationRequestBlockedByCsp", MojoBinderPolicy: "MojoBinderPolicy", RendererProcessCrashed: "RendererProcessCrashed", RendererProcessKilled: "RendererProcessKilled", Download: "Download", TriggerDestroyed: "TriggerDestroyed", NavigationNotCommitted: "NavigationNotCommitted", NavigationBadHttpStatus: "NavigationBadHttpStatus", ClientCertRequested: "ClientCertRequested", NavigationRequestNetworkError: "NavigationRequestNetworkError", CancelAllHostsForTesting: "CancelAllHostsForTesting", DidFailLoad: "DidFailLoad", Stop: "Stop", SslCertificateError: "SslCertificateError", LoginAuthRequested: "LoginAuthRequested", UaChangeRequiresReload: "UaChangeRequiresReload", BlockedByClient: "BlockedByClient", AudioOutputDeviceRequested: "AudioOutputDeviceRequested", MixedContent: "MixedContent", TriggerBackgrounded: "TriggerBackgrounded", MemoryLimitExceeded: "MemoryLimitExceeded", DataSaverEnabled: "DataSaverEnabled", TriggerUrlHasEffectiveUrl: "TriggerUrlHasEffectiveUrl", ActivatedBeforeStarted: "ActivatedBeforeStarted", InactivePageRestriction: "InactivePageRestriction", StartFailed: "StartFailed", TimeoutBackgrounded: "TimeoutBackgrounded", CrossSiteRedirectInInitialNavigation: "CrossSiteRedirectInInitialNavigation", CrossSiteNavigationInInitialNavigation: "CrossSiteNavigationInInitialNavigation", SameSiteCrossOriginRedirectNotOptInInInitialNavigation: "SameSiteCrossOriginRedirectNotOptInInInitialNavigation", SameSiteCrossOriginNavigationNotOptInInInitialNavigation: "SameSiteCrossOriginNavigationNotOptInInInitialNavigation", ActivationNavigationParameterMismatch: "ActivationNavigationParameterMismatch", ActivatedInBackground: "ActivatedInBackground", EmbedderHostDisallowed: "EmbedderHostDisallowed", ActivationNavigationDestroyedBeforeSuccess: "ActivationNavigationDestroyedBeforeSuccess", TabClosedByUserGesture: "TabClosedByUserGesture", TabClosedWithoutUserGesture: "TabClosedWithoutUserGesture", PrimaryMainFrameRendererProcessCrashed: "PrimaryMainFrameRendererProcessCrashed", PrimaryMainFrameRendererProcessKilled: "PrimaryMainFrameRendererProcessKilled", ActivationFramePolicyNotCompatible: "ActivationFramePolicyNotCompatible", PreloadingDisabled: "PreloadingDisabled", BatterySaverEnabled: "BatterySaverEnabled", ActivatedDuringMainFrameNavigation: "ActivatedDuringMainFrameNavigation", PreloadingUnsupportedByWebContents: "PreloadingUnsupportedByWebContents", CrossSiteRedirectInMainFrameNavigation: "CrossSiteRedirectInMainFrameNavigation", CrossSiteNavigationInMainFrameNavigation: "CrossSiteNavigationInMainFrameNavigation", SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation: "SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation", SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation: "SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation", MemoryPressureOnTrigger: "MemoryPressureOnTrigger", MemoryPressureAfterTriggered: "MemoryPressureAfterTriggered", PrerenderingDisabledByDevTools: "PrerenderingDisabledByDevTools", SpeculationRuleRemoved: "SpeculationRuleRemoved", ActivatedWithAuxiliaryBrowsingContexts: "ActivatedWithAuxiliaryBrowsingContexts", MaxNumOfRunningEagerPrerendersExceeded: "MaxNumOfRunningEagerPrerendersExceeded", MaxNumOfRunningNonEagerPrerendersExceeded: "MaxNumOfRunningNonEagerPrerendersExceeded", MaxNumOfRunningEmbedderPrerendersExceeded: "MaxNumOfRunningEmbedderPrerendersExceeded", PrerenderingUrlHasEffectiveUrl: "PrerenderingUrlHasEffectiveUrl", RedirectedPrerenderingUrlHasEffectiveUrl: "RedirectedPrerenderingUrlHasEffectiveUrl", ActivationUrlHasEffectiveUrl: "ActivationUrlHasEffectiveUrl", JavaScriptInterfaceAdded: "JavaScriptInterfaceAdded", JavaScriptInterfaceRemoved: "JavaScriptInterfaceRemoved", AllPrerenderingCanceled: "AllPrerenderingCanceled", WindowClosed: "WindowClosed", SlowNetwork: "SlowNetwork", OtherPrerenderedPageActivated: "OtherPrerenderedPageActivated", V8OptimizerDisabled: "V8OptimizerDisabled", PrerenderFailedDuringPrefetch: "PrerenderFailedDuringPrefetch", BrowsingDataRemoved: "BrowsingDataRemoved", PrerenderHostReused: "PrerenderHostReused", FormSubmitWhenPrerendering: "FormSubmitWhenPrerendering", CrossDocumentRestart: "CrossDocumentRestart"});
 inspectorBackend.registerEnum("Preload.PreloadingStatus", {Pending: "Pending", Running: "Running", Ready: "Ready", Success: "Success", Failure: "Failure", NotSupported: "NotSupported"});
-inspectorBackend.registerEnum("Preload.PrefetchStatus", {PrefetchAllowed: "PrefetchAllowed", PrefetchFailedIneligibleRedirect: "PrefetchFailedIneligibleRedirect", PrefetchFailedInvalidRedirect: "PrefetchFailedInvalidRedirect", PrefetchFailedMIMENotSupported: "PrefetchFailedMIMENotSupported", PrefetchFailedNetError: "PrefetchFailedNetError", PrefetchFailedNon2XX: "PrefetchFailedNon2XX", PrefetchEvictedAfterBrowsingDataRemoved: "PrefetchEvictedAfterBrowsingDataRemoved", PrefetchEvictedAfterCandidateRemoved: "PrefetchEvictedAfterCandidateRemoved", PrefetchEvictedForNewerPrefetch: "PrefetchEvictedForNewerPrefetch", PrefetchHeldback: "PrefetchHeldback", PrefetchIneligibleRetryAfter: "PrefetchIneligibleRetryAfter", PrefetchIsPrivacyDecoy: "PrefetchIsPrivacyDecoy", PrefetchIsStale: "PrefetchIsStale", PrefetchNotEligibleBrowserContextOffTheRecord: "PrefetchNotEligibleBrowserContextOffTheRecord", PrefetchNotEligibleDataSaverEnabled: "PrefetchNotEligibleDataSaverEnabled", PrefetchNotEligibleExistingProxy: "PrefetchNotEligibleExistingProxy", PrefetchNotEligibleHostIsNonUnique: "PrefetchNotEligibleHostIsNonUnique", PrefetchNotEligibleNonDefaultStoragePartition: "PrefetchNotEligibleNonDefaultStoragePartition", PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy: "PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy", PrefetchNotEligibleSchemeIsNotHttps: "PrefetchNotEligibleSchemeIsNotHttps", PrefetchNotEligibleUserHasCookies: "PrefetchNotEligibleUserHasCookies", PrefetchNotEligibleUserHasServiceWorker: "PrefetchNotEligibleUserHasServiceWorker", PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler: "PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler", PrefetchNotEligibleRedirectFromServiceWorker: "PrefetchNotEligibleRedirectFromServiceWorker", PrefetchNotEligibleRedirectToServiceWorker: "PrefetchNotEligibleRedirectToServiceWorker", PrefetchNotEligibleBatterySaverEnabled: "PrefetchNotEligibleBatterySaverEnabled", PrefetchNotEligiblePreloadingDisabled: "PrefetchNotEligiblePreloadingDisabled", PrefetchNotFinishedInTime: "PrefetchNotFinishedInTime", PrefetchNotStarted: "PrefetchNotStarted", PrefetchNotUsedCookiesChanged: "PrefetchNotUsedCookiesChanged", PrefetchProxyNotAvailable: "PrefetchProxyNotAvailable", PrefetchResponseUsed: "PrefetchResponseUsed", PrefetchSuccessfulButNotUsed: "PrefetchSuccessfulButNotUsed", PrefetchNotUsedProbeFailed: "PrefetchNotUsedProbeFailed"});
+inspectorBackend.registerEnum("Preload.PrefetchStatus", {PrefetchAllowed: "PrefetchAllowed", PrefetchFailedIneligibleRedirect: "PrefetchFailedIneligibleRedirect", PrefetchFailedInvalidRedirect: "PrefetchFailedInvalidRedirect", PrefetchFailedMIMENotSupported: "PrefetchFailedMIMENotSupported", PrefetchFailedNetError: "PrefetchFailedNetError", PrefetchFailedNon2XX: "PrefetchFailedNon2XX", PrefetchEvictedAfterBrowsingDataRemoved: "PrefetchEvictedAfterBrowsingDataRemoved", PrefetchEvictedAfterCandidateRemoved: "PrefetchEvictedAfterCandidateRemoved", PrefetchEvictedForNewerPrefetch: "PrefetchEvictedForNewerPrefetch", PrefetchHeldback: "PrefetchHeldback", PrefetchIneligibleRetryAfter: "PrefetchIneligibleRetryAfter", PrefetchIsPrivacyDecoy: "PrefetchIsPrivacyDecoy", PrefetchIsStale: "PrefetchIsStale", PrefetchNotEligibleBlockedByConnectionAllowlist: "PrefetchNotEligibleBlockedByConnectionAllowlist", PrefetchNotEligibleBrowserContextOffTheRecord: "PrefetchNotEligibleBrowserContextOffTheRecord", PrefetchNotEligibleDataSaverEnabled: "PrefetchNotEligibleDataSaverEnabled", PrefetchNotEligibleExistingProxy: "PrefetchNotEligibleExistingProxy", PrefetchNotEligibleHostIsNonUnique: "PrefetchNotEligibleHostIsNonUnique", PrefetchNotEligibleNonDefaultStoragePartition: "PrefetchNotEligibleNonDefaultStoragePartition", PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy: "PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy", PrefetchNotEligibleSchemeIsNotHttps: "PrefetchNotEligibleSchemeIsNotHttps", PrefetchNotEligibleUserHasCookies: "PrefetchNotEligibleUserHasCookies", PrefetchNotEligibleUserHasServiceWorker: "PrefetchNotEligibleUserHasServiceWorker", PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler: "PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler", PrefetchNotEligibleRedirectFromServiceWorker: "PrefetchNotEligibleRedirectFromServiceWorker", PrefetchNotEligibleRedirectToServiceWorker: "PrefetchNotEligibleRedirectToServiceWorker", PrefetchNotEligibleBatterySaverEnabled: "PrefetchNotEligibleBatterySaverEnabled", PrefetchNotEligiblePreloadingDisabled: "PrefetchNotEligiblePreloadingDisabled", PrefetchNotFinishedInTime: "PrefetchNotFinishedInTime", PrefetchNotStarted: "PrefetchNotStarted", PrefetchNotUsedCookiesChanged: "PrefetchNotUsedCookiesChanged", PrefetchProxyNotAvailable: "PrefetchProxyNotAvailable", PrefetchResponseUsed: "PrefetchResponseUsed", PrefetchSuccessfulButNotUsed: "PrefetchSuccessfulButNotUsed", PrefetchNotUsedProbeFailed: "PrefetchNotUsedProbeFailed", PrefetchCancelledOnUserNavigation: "PrefetchCancelledOnUserNavigation"});
 inspectorBackend.registerEvent("Preload.ruleSetUpdated", ["ruleSet"]);
 inspectorBackend.registerEvent("Preload.ruleSetRemoved", ["id"]);
 inspectorBackend.registerEvent("Preload.preloadEnabledStateUpdated", ["disabledByPreference", "disabledByDataSaver", "disabledByBatterySaver", "disabledByHoldbackPrefetchSpeculationRules", "disabledByHoldbackPrerenderSpeculationRules"]);

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

@@ -1089,6 +1089,13 @@ export namespace ProtocolMapping {
       paramsType: [Protocol.Accessibility.QueryAXTreeRequest?];
       returnType: Protocol.Accessibility.QueryAXTreeResponse;
     };
+    /**
+     * Retrieves ad metrics for the current page.
+     */
+    'Ads.getAdMetrics': {
+      paramsType: [];
+      returnType: Protocol.Ads.GetAdMetricsResponse;
+    };
     /**
      * Disables animation domain notifications.
      */

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

@@ -20,6 +20,8 @@ declare namespace ProtocolProxyApi {
   export interface ProtocolApi {
     Accessibility: AccessibilityApi;
 
+    Ads: AdsApi;
+
     Animation: AnimationApi;
 
     Audits: AuditsApi;
@@ -133,6 +135,8 @@ declare namespace ProtocolProxyApi {
   export interface ProtocolDispatchers {
     Accessibility: AccessibilityDispatcher;
 
+    Ads: AdsDispatcher;
+
     Animation: AnimationDispatcher;
 
     Audits: AuditsDispatcher;
@@ -308,6 +312,16 @@ declare namespace ProtocolProxyApi {
 
   }
 
+  export interface AdsApi {
+    /**
+     * Retrieves ad metrics for the current page.
+     */
+    invoke_getAdMetrics(): Promise<Protocol.Ads.GetAdMetricsResponse>;
+
+  }
+  export interface AdsDispatcher {
+  }
+
   export interface AnimationApi {
     /**
      * Disables animation domain notifications.

package/front_end/generated/protocol.ts

@@ -435,6 +435,49 @@ export namespace Accessibility {
   }
 }
 
+/**
+ * A domain for ad-related metrics and data.
+ */
+export namespace Ads {
+
+  /**
+   * Ad metrics for a page.
+   */
+  export interface AdMetrics {
+    /**
+     * The viewport ad density by area, represented as a percentage (an integer
+     * between 0 and 100).
+     */
+    viewportAdDensityByArea: integer;
+    /**
+     * The time-weighted average of the viewport ad density by area, measured
+     * across the duration of the page.
+     */
+    averageViewportAdDensityByArea: number;
+    /**
+     * The number of ads currently visible within the viewport.
+     */
+    viewportAdCount: integer;
+    /**
+     * The time-weighted average of the viewport ad count, measured across the
+     * duration of the page.
+     */
+    averageViewportAdCount: number;
+    /**
+     * The total ad CPU usage, in milliseconds.
+     */
+    totalAdCpuTime: number;
+    /**
+     * The total ad network bytes.
+     */
+    totalAdNetworkBytes: number;
+  }
+
+  export interface GetAdMetricsResponse extends ProtocolResponseWithError {
+    metrics: AdMetrics;
+  }
+}
+
 export namespace Animation {
 
   export const enum AnimationType {
@@ -1389,6 +1432,40 @@ export namespace Audits {
     WellKnownMissingAccountsEndpoint = 'WellKnownMissingAccountsEndpoint',
     UserLoggedOut = 'UserLoggedOut',
     WellKnownAccountsEndpointCrossOrigin = 'WellKnownAccountsEndpointCrossOrigin',
+    AccountsHttpNotFound = 'AccountsHttpNotFound',
+    AccountsNoResponse = 'AccountsNoResponse',
+    AccountsInvalidResponse = 'AccountsInvalidResponse',
+    AccountsInvalidContentType = 'AccountsInvalidContentType',
+    AccountsEmptyList = 'AccountsEmptyList',
+    EmailVerificationWellKnownHttpNotFound = 'EmailVerificationWellKnownHttpNotFound',
+    EmailVerificationWellKnownNoResponse = 'EmailVerificationWellKnownNoResponse',
+    EmailVerificationWellKnownInvalidResponse = 'EmailVerificationWellKnownInvalidResponse',
+    EmailVerificationWellKnownInvalidContentType = 'EmailVerificationWellKnownInvalidContentType',
+    JwksHttpNotFound = 'JwksHttpNotFound',
+    JwksInvalidResponse = 'JwksInvalidResponse',
+    TokenVerificationSdJwtUnsupportedHeaderAlg = 'TokenVerificationSdJwtUnsupportedHeaderAlg',
+    TokenVerificationSdJwtMissingIss = 'TokenVerificationSdJwtMissingIss',
+    TokenVerificationSdJwtMissingIat = 'TokenVerificationSdJwtMissingIat',
+    TokenVerificationSdJwtMissingCnf = 'TokenVerificationSdJwtMissingCnf',
+    TokenVerificationSdJwtMissingEmail = 'TokenVerificationSdJwtMissingEmail',
+    TokenVerificationSdJwtInvalidIssuedAt = 'TokenVerificationSdJwtInvalidIssuedAt',
+    TokenVerificationSdJwtInvalidIssuer = 'TokenVerificationSdJwtInvalidIssuer',
+    TokenVerificationSdJwtJwksMissingKeys = 'TokenVerificationSdJwtJwksMissingKeys',
+    TokenVerificationSdJwtSignatureFailed = 'TokenVerificationSdJwtSignatureFailed',
+    TokenVerificationSdJwtInvalidEmailVerified = 'TokenVerificationSdJwtInvalidEmailVerified',
+    TokenVerificationSdJwtInvalidEmail = 'TokenVerificationSdJwtInvalidEmail',
+    TokenVerificationSdJwtInvalidHolderKey = 'TokenVerificationSdJwtInvalidHolderKey',
+    TokenVerificationKbInvalidTyp = 'TokenVerificationKbInvalidTyp',
+    TokenVerificationKbMissingAud = 'TokenVerificationKbMissingAud',
+    TokenVerificationKbMissingNonce = 'TokenVerificationKbMissingNonce',
+    TokenVerificationKbMissingIat = 'TokenVerificationKbMissingIat',
+    TokenVerificationKbMissingSdHash = 'TokenVerificationKbMissingSdHash',
+    TokenVerificationKbInvalidIssuedAt = 'TokenVerificationKbInvalidIssuedAt',
+    TokenVerificationKbInvalidAudience = 'TokenVerificationKbInvalidAudience',
+    TokenVerificationKbInvalidNonce = 'TokenVerificationKbInvalidNonce',
+    TokenVerificationKbInvalidSdHash = 'TokenVerificationKbInvalidSdHash',
+    TokenVerificationKbMissingCnf = 'TokenVerificationKbMissingCnf',
+    TokenVerificationKbSignatureFailed = 'TokenVerificationKbSignatureFailed',
   }
 
   /**
@@ -4702,6 +4779,7 @@ export namespace DOM {
     Picker = 'picker',
     PermissionIcon = 'permission-icon',
     OverscrollAreaParent = 'overscroll-area-parent',
+    Skeleton = 'skeleton',
   }
 
   /**
@@ -17147,6 +17225,7 @@ export namespace Preload {
     PrefetchIneligibleRetryAfter = 'PrefetchIneligibleRetryAfter',
     PrefetchIsPrivacyDecoy = 'PrefetchIsPrivacyDecoy',
     PrefetchIsStale = 'PrefetchIsStale',
+    PrefetchNotEligibleBlockedByConnectionAllowlist = 'PrefetchNotEligibleBlockedByConnectionAllowlist',
     PrefetchNotEligibleBrowserContextOffTheRecord = 'PrefetchNotEligibleBrowserContextOffTheRecord',
     PrefetchNotEligibleDataSaverEnabled = 'PrefetchNotEligibleDataSaverEnabled',
     PrefetchNotEligibleExistingProxy = 'PrefetchNotEligibleExistingProxy',
@@ -17168,6 +17247,7 @@ export namespace Preload {
     PrefetchResponseUsed = 'PrefetchResponseUsed',
     PrefetchSuccessfulButNotUsed = 'PrefetchSuccessfulButNotUsed',
     PrefetchNotUsedProbeFailed = 'PrefetchNotUsedProbeFailed',
+    PrefetchCancelledOnUserNavigation = 'PrefetchCancelledOnUserNavigation',
   }
 
   /**

package/front_end/global_typings/global_defs.d.ts

@@ -12,6 +12,19 @@ declare module '*.css.js' {
   export default styles;
 }
 
+declare module '*.skill.js' {
+  // Duplicated from front_end/models/ai_assistance/skills/Skill.ts
+  // to avoid importing from the source tree in a global declaration file,
+  // which was causing build artifacts to be generated in the source tree.
+  interface Skill {
+    name: 'styling';
+    description: string;
+    allowedTools: string[];
+    instructions: string;
+  }
+  export const skill: Skill;
+}
+
 // TODO: remove once URLPattern types are available in TypeScript (see https://github.com/microsoft/TypeScript-DOM-lib-generator/issues/1199).
 declare class URLPattern {
   constructor(input: string);

package/front_end/models/ai_assistance/AiAgent2.ts

@@ -0,0 +1,116 @@
+// 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 * as Host from '../../core/host/host.js';
+
+import {
+  type AgentOptions,
+  AiAgent,
+  type ContextResponse,
+  type ConversationContext,
+  type RequestOptions,
+  ResponseType
+} from './agents/AiAgent.js';
+import {debugLog} from './debug.js';
+import type {Skill, SkillName} from './skills/Skill.js';
+import {SKILLS} from './skills/SkillRegistry.js';
+
+export class AiAgent2 extends AiAgent<unknown> {
+  // TODO: The static preamble is a placeholder and will eventually live server-side.
+  readonly preamble = 'You are a unified AI assistant in Chrome DevTools. You can learn skills to help the user.';
+  readonly clientFeature = Host.AidaClient.ClientFeature.CHROME_STYLING_AGENT;  // Placeholder
+  readonly userTier = 'TESTERS';
+
+  #skillsInjected = false;
+
+  get options(): RequestOptions {
+    return {};
+  }
+
+  readonly #activeSkills = new Set<SkillName>();
+
+  constructor(opts: AgentOptions) {
+    super(opts);
+    const skillsList = Object.keys(SKILLS).join(', ');
+    this.declareFunction<{skills: SkillName[]}>('learnSkills', {
+      description: `Load skills to help with the task. Available skills: ${skillsList}.`,
+      parameters: {
+        type: Host.AidaClient.ParametersTypes.OBJECT,
+        description: 'Parameters for learning skills',
+        properties: {
+          skills: {
+            type: Host.AidaClient.ParametersTypes.ARRAY,
+            items: {
+              type: Host.AidaClient.ParametersTypes.STRING,
+              description: 'Skill name',
+            },
+            description: 'List of skill names to load',
+          },
+        },
+        required: ['skills'],
+      },
+      displayInfoFromArgs: args => {
+        return {
+          title: `Learning skills: ${args.skills.join(', ')}`,
+        };
+      },
+      handler: async args => {
+        const result = await this.learnSkill(args.skills);
+        return {result};
+      },
+    });
+  }
+
+  override async enhanceQuery(query: string): Promise<string> {
+    if (this.#skillsInjected) {
+      return query;
+    }
+    this.#skillsInjected = true;
+    const skillsManifest = Object.entries(SKILLS).map(([name, skill]) => `- ${name}: ${skill.description}`).join('\n');
+    return `Available skills:
+${skillsManifest}
+
+You must call \`learnSkills\` to load a skill before you can use it.
+
+User query: ${query}`;
+  }
+
+  async *
+      handleContextDetails(_select: ConversationContext<unknown>|null): AsyncGenerator<ContextResponse, void, void> {
+    yield {
+      type: ResponseType.CONTEXT,
+      details: [{
+        title: 'Status',
+        text: 'Minimal agent initialized.',
+      }],
+    };
+  }
+
+  async learnSkill(names: SkillName[]): Promise<string> {
+    let response = '';
+    for (const name of names) {
+      debugLog(`AiAgent2: Attempting to load skill ${name}`);
+      if (this.#activeSkills.has(name)) {
+        debugLog(`AiAgent2: Skill ${name} is already loaded`);
+        response += `Skill ${name} is already loaded.\n`;
+        continue;
+      }
+
+      const skillObj: Skill = SKILLS[name];
+      if (skillObj) {
+        this.#activeSkills.add(name);
+        debugLog(`AiAgent2: Skill ${name} loaded successfully`);
+        response += `Skill ${name} loaded. Instructions:\n${skillObj.instructions}\n`;
+      } else {
+        debugLog(`AiAgent2: Failed to load skill ${name}`);
+        response += `Failed to load skill ${name}. Valid skills are: ${Object.keys(SKILLS).join(', ')}.\n`;
+      }
+    }
+    return response.trim();
+  }
+
+  get activeSkills(): Set<SkillName> {
+    return this.#activeSkills;
+  }
+}