chrome-devtools-frontend 1.0.1683520 → 1.0.1689415

package/front_end/generated/protocol.ts

@@ -504,9 +504,32 @@ export namespace Ads {
     removeAdFrames: Page.FrameId[];
   }
 
+  /**
+   * An ad script.
+   * Note: when the script is a transitive ad script, we only fill in the
+   * immediate ancestor script in the provenance's adScriptAncestry field (as its
+   * first entry), rather than filling in the full ancestry. This saves work for
+   * the backend, and the frontend can reconstruct the full ancestry if
+   * necessary.
+   */
+  export interface AdScript {
+    /**
+     * The script ID.
+     */
+    scriptId: Runtime.ScriptId;
+    /**
+     * The ad provenance.
+     */
+    provenance: Network.AdProvenance;
+  }
+
   export interface GetAdMetricsResponse extends ProtocolResponseWithError {
     metrics: AdMetrics;
   }
+
+  export interface GetAdScriptsResponse extends ProtocolResponseWithError {
+    newScripts: AdScript[];
+  }
 }
 
 export namespace Animation {
@@ -2627,6 +2650,15 @@ export namespace Browser {
     arguments: string[];
   }
 
+  export interface AddMockCameraRequest {
+    /**
+     * Required non-empty identifier for the mock camera. This is mapped to an
+     * internal virtual-device identifier and is not the MediaDeviceInfo.deviceId
+     * exposed to the page.
+     */
+    deviceId: string;
+  }
+
   export interface GetHistogramsRequest {
     /**
      * Requested substring in name. Only histograms which have query as a
@@ -11760,6 +11792,9 @@ export namespace Network {
     filterlistRule?: string;
     /**
      * The script ancestry that created the ad, if any.
+     * Note: depending on the context, this may represent the full ancestry up
+     * to the root script, or it may contain only one script representing the
+     * immediate ancestor.
      */
     adScriptAncestry?: AdAncestry;
   }
@@ -14608,6 +14643,7 @@ export namespace Page {
     Gamepad = 'gamepad',
     Geolocation = 'geolocation',
     Gyroscope = 'gyroscope',
+    Haptics = 'haptics',
     Hid = 'hid',
     IdentityCredentialsGet = 'identity-credentials-get',
     IdleDetection = 'idle-detection',
@@ -17712,6 +17748,62 @@ export namespace ServiceWorker {
     Redundant = 'redundant',
   }
 
+  /**
+   * Mostly corresponds to `RouterCondition` in ServiceWorker spec
+   * (https://www.w3.org/TR/service-workers/#dictdef-routercondition) while this
+   * currently lacks support for the nested conditions ("or" and "not").
+   * TODO(crbug.com/540469610): Support recursive conditions.
+   */
+  export interface ServiceWorkerRouterCondition {
+    /**
+     * Plain text, or JSON serialization of URLPatternInit or URLPattern
+     */
+    urlPattern?: string;
+    requestMethod?: string;
+    requestMode?: string;
+    requestDestination?: string;
+    runningStatus?: ServiceWorkerVersionRunningStatus;
+  }
+
+  export const enum ServiceWorkerRouterSourceType {
+    Cache = 'cache',
+    FetchEvent = 'fetchEvent',
+    Network = 'network',
+    RaceNetworkAndFetchHandler = 'raceNetworkAndFetchHandler',
+    RaceNetworkAndCache = 'raceNetworkAndCache',
+    SourceDict = 'sourceDict',
+  }
+
+  /**
+   * https://www.w3.org/TR/service-workers/#dictdef-routersourcedict
+   */
+  export interface ServiceWorkerRouterSourceDict {
+    cacheName: string;
+  }
+
+  /**
+   * Corresponds to `RouterSource` in the spec while the representation is different as follows.
+   * (https://www.w3.org/TR/service-workers/#typedefdef-routersource)
+   * - `RouterSourceEnum`: `type` equals `cache`, `sourceDict` is null.
+   * - `RouterSourceDict`: `type` equals `sourceDict`, `sourceDict` has valid value.
+   */
+  export interface ServiceWorkerRouterSource {
+    type: ServiceWorkerRouterSourceType;
+    /**
+     * Non-empty iff `type` equals "sourceDict".
+     */
+    sourceDict?: ServiceWorkerRouterSourceDict;
+  }
+
+  export interface ServiceWorkerRouterRule {
+    condition: ServiceWorkerRouterCondition;
+    source: ServiceWorkerRouterSource;
+    /**
+     * Rule ID assigned by the browser. Unique within each ServiceWorkerVersion.
+     */
+    id: integer;
+  }
+
   /**
    * ServiceWorker version.
    */
@@ -17732,7 +17824,13 @@ export namespace ServiceWorker {
     scriptResponseTime?: number;
     controlledClients?: Target.TargetID[];
     targetId?: Target.TargetID;
+    /**
+     * Migration to `typedRouterRules` is in progress. The browser sends either
+     * `routerRules` or `typedRouterRules`.
+     * TODO(crbug.com/540469610): Remove `routerRules` after the migration.
+     */
     routerRules?: string;
+    typedRouterRules?: ServiceWorkerRouterRule[];
   }
 
   /**
@@ -18179,7 +18277,6 @@ export namespace Storage {
     Websql = 'websql',
     Service_workers = 'service_workers',
     Cache_storage = 'cache_storage',
-    Shared_storage = 'shared_storage',
     Storage_buckets = 'storage_buckets',
     All = 'all',
     Other = 'other',
@@ -18208,217 +18305,6 @@ export namespace Storage {
     count: number;
   }
 
-  /**
-   * Enum of shared storage access scopes.
-   */
-  export const enum SharedStorageAccessScope {
-    Window = 'window',
-    SharedStorageWorklet = 'sharedStorageWorklet',
-    Header = 'header',
-  }
-
-  /**
-   * Enum of shared storage access methods.
-   */
-  export const enum SharedStorageAccessMethod {
-    AddModule = 'addModule',
-    CreateWorklet = 'createWorklet',
-    SelectURL = 'selectURL',
-    Run = 'run',
-    BatchUpdate = 'batchUpdate',
-    Set = 'set',
-    Append = 'append',
-    Delete = 'delete',
-    Clear = 'clear',
-    Get = 'get',
-    Keys = 'keys',
-    Values = 'values',
-    Entries = 'entries',
-    Length = 'length',
-    RemainingBudget = 'remainingBudget',
-  }
-
-  /**
-   * Struct for a single key-value pair in an origin's shared storage.
-   */
-  export interface SharedStorageEntry {
-    key: string;
-    value: string;
-  }
-
-  /**
-   * Details for an origin's shared storage.
-   */
-  export interface SharedStorageMetadata {
-    /**
-     * Time when the origin's shared storage was last created.
-     */
-    creationTime: Network.TimeSinceEpoch;
-    /**
-     * Number of key-value pairs stored in origin's shared storage.
-     */
-    length: integer;
-    /**
-     * Current amount of bits of entropy remaining in the navigation budget.
-     */
-    remainingBudget: number;
-    /**
-     * Total number of bytes stored as key-value pairs in origin's shared
-     * storage.
-     */
-    bytesUsed: integer;
-  }
-
-  /**
-   * Represents a dictionary object passed in as privateAggregationConfig to
-   * run or selectURL.
-   */
-  export interface SharedStoragePrivateAggregationConfig {
-    /**
-     * The chosen aggregation service deployment.
-     */
-    aggregationCoordinatorOrigin?: string;
-    /**
-     * The context ID provided.
-     */
-    contextId?: string;
-    /**
-     * Configures the maximum size allowed for filtering IDs.
-     */
-    filteringIdMaxBytes: integer;
-    /**
-     * The limit on the number of contributions in the final report.
-     */
-    maxContributions?: integer;
-  }
-
-  /**
-   * Pair of reporting metadata details for a candidate URL for `selectURL()`.
-   */
-  export interface SharedStorageReportingMetadata {
-    eventType: string;
-    reportingUrl: string;
-  }
-
-  /**
-   * Bundles a candidate URL with its reporting metadata.
-   */
-  export interface SharedStorageUrlWithMetadata {
-    /**
-     * Spec of candidate URL.
-     */
-    url: string;
-    /**
-     * Any associated reporting metadata.
-     */
-    reportingMetadata: SharedStorageReportingMetadata[];
-  }
-
-  /**
-   * Bundles the parameters for shared storage access events whose
-   * presence/absence can vary according to SharedStorageAccessType.
-   */
-  export interface SharedStorageAccessParams {
-    /**
-     * Spec of the module script URL.
-     * Present only for SharedStorageAccessMethods: addModule and
-     * createWorklet.
-     */
-    scriptSourceUrl?: string;
-    /**
-     * String denoting "context-origin", "script-origin", or a custom
-     * origin to be used as the worklet's data origin.
-     * Present only for SharedStorageAccessMethod: createWorklet.
-     */
-    dataOrigin?: string;
-    /**
-     * Name of the registered operation to be run.
-     * Present only for SharedStorageAccessMethods: run and selectURL.
-     */
-    operationName?: string;
-    /**
-     * ID of the operation call.
-     * Present only for SharedStorageAccessMethods: run and selectURL.
-     */
-    operationId?: string;
-    /**
-     * Whether or not to keep the worket alive for future run or selectURL
-     * calls.
-     * Present only for SharedStorageAccessMethods: run and selectURL.
-     */
-    keepAlive?: boolean;
-    /**
-     * Configures the private aggregation options.
-     * Present only for SharedStorageAccessMethods: run and selectURL.
-     */
-    privateAggregationConfig?: SharedStoragePrivateAggregationConfig;
-    /**
-     * The operation's serialized data in bytes (converted to a string).
-     * Present only for SharedStorageAccessMethods: run and selectURL.
-     * TODO(crbug.com/401011862): Consider updating this parameter to binary.
-     */
-    serializedData?: string;
-    /**
-     * Array of candidate URLs' specs, along with any associated metadata.
-     * Present only for SharedStorageAccessMethod: selectURL.
-     */
-    urlsWithMetadata?: SharedStorageUrlWithMetadata[];
-    /**
-     * Spec of the URN:UUID generated for a selectURL call.
-     * Present only for SharedStorageAccessMethod: selectURL.
-     */
-    urnUuid?: string;
-    /**
-     * Key for a specific entry in an origin's shared storage.
-     * Present only for SharedStorageAccessMethods: set, append, delete, and
-     * get.
-     */
-    key?: string;
-    /**
-     * Value for a specific entry in an origin's shared storage.
-     * Present only for SharedStorageAccessMethods: set and append.
-     */
-    value?: string;
-    /**
-     * Whether or not to set an entry for a key if that key is already present.
-     * Present only for SharedStorageAccessMethod: set.
-     */
-    ignoreIfPresent?: boolean;
-    /**
-     * A number denoting the (0-based) order of the worklet's
-     * creation relative to all other shared storage worklets created by
-     * documents using the current storage partition.
-     * Present only for SharedStorageAccessMethods: addModule, createWorklet.
-     */
-    workletOrdinal?: integer;
-    /**
-     * Hex representation of the DevTools token used as the TargetID for the
-     * associated shared storage worklet.
-     * Present only for SharedStorageAccessMethods: addModule, createWorklet,
-     * run, selectURL, and any other SharedStorageAccessMethod when the
-     * SharedStorageAccessScope is sharedStorageWorklet.
-     */
-    workletTargetId?: Target.TargetID;
-    /**
-     * Name of the lock to be acquired, if present.
-     * Optionally present only for SharedStorageAccessMethods: batchUpdate,
-     * set, append, delete, and clear.
-     */
-    withLock?: string;
-    /**
-     * If the method has been called as part of a batchUpdate, then this
-     * number identifies the batch to which it belongs.
-     * Optionally present only for SharedStorageAccessMethods:
-     * batchUpdate (required), set, append, delete, and clear.
-     */
-    batchUpdateId?: string;
-    /**
-     * Number of modifier methods sent in batch.
-     * Present only for SharedStorageAccessMethod: batchUpdate.
-     */
-    batchSize?: integer;
-  }
-
   export const enum StorageBucketsDurability {
     Relaxed = 'relaxed',
     Strict = 'strict',
@@ -18646,50 +18532,6 @@ export namespace Storage {
     didDeleteTokens: boolean;
   }
 
-  export interface GetSharedStorageMetadataRequest {
-    ownerOrigin: string;
-  }
-
-  export interface GetSharedStorageMetadataResponse extends ProtocolResponseWithError {
-    metadata: SharedStorageMetadata;
-  }
-
-  export interface GetSharedStorageEntriesRequest {
-    ownerOrigin: string;
-  }
-
-  export interface GetSharedStorageEntriesResponse extends ProtocolResponseWithError {
-    entries: SharedStorageEntry[];
-  }
-
-  export interface SetSharedStorageEntryRequest {
-    ownerOrigin: string;
-    key: string;
-    value: string;
-    /**
-     * If `ignoreIfPresent` is included and true, then only sets the entry if
-     * `key` doesn't already exist.
-     */
-    ignoreIfPresent?: boolean;
-  }
-
-  export interface DeleteSharedStorageEntryRequest {
-    ownerOrigin: string;
-    key: string;
-  }
-
-  export interface ClearSharedStorageEntriesRequest {
-    ownerOrigin: string;
-  }
-
-  export interface ResetSharedStorageBudgetRequest {
-    ownerOrigin: string;
-  }
-
-  export interface SetSharedStorageTrackingRequest {
-    enable: boolean;
-  }
-
   export interface SetStorageBucketTrackingRequest {
     storageKey: string;
     enable: boolean;
@@ -18791,79 +18633,6 @@ export namespace Storage {
     bucketId: string;
   }
 
-  /**
-   * Shared storage was accessed by the associated page.
-   * The following parameters are included in all events.
-   */
-  export interface SharedStorageAccessedEvent {
-    /**
-     * Time of the access.
-     */
-    accessTime: Network.TimeSinceEpoch;
-    /**
-     * Enum value indicating the access scope.
-     */
-    scope: SharedStorageAccessScope;
-    /**
-     * Enum value indicating the Shared Storage API method invoked.
-     */
-    method: SharedStorageAccessMethod;
-    /**
-     * DevTools Frame Token for the primary frame tree's root.
-     */
-    mainFrameId: Page.FrameId;
-    /**
-     * Serialization of the origin owning the Shared Storage data.
-     */
-    ownerOrigin: string;
-    /**
-     * Serialization of the site owning the Shared Storage data.
-     */
-    ownerSite: string;
-    /**
-     * The sub-parameters wrapped by `params` are all optional and their
-     * presence/absence depends on `type`.
-     */
-    params: SharedStorageAccessParams;
-  }
-
-  /**
-   * A shared storage run or selectURL operation finished its execution.
-   * The following parameters are included in all events.
-   */
-  export interface SharedStorageWorkletOperationExecutionFinishedEvent {
-    /**
-     * Time that the operation finished.
-     */
-    finishedTime: Network.TimeSinceEpoch;
-    /**
-     * Time, in microseconds, from start of shared storage JS API call until
-     * end of operation execution in the worklet.
-     */
-    executionTime: integer;
-    /**
-     * Enum value indicating the Shared Storage API method invoked.
-     */
-    method: SharedStorageAccessMethod;
-    /**
-     * ID of the operation call.
-     */
-    operationId: string;
-    /**
-     * Hex representation of the DevTools token used as the TargetID for the
-     * associated shared storage worklet.
-     */
-    workletTargetId: Target.TargetID;
-    /**
-     * DevTools Frame Token for the primary frame tree's root.
-     */
-    mainFrameId: Page.FrameId;
-    /**
-     * Serialization of the origin owning the Shared Storage data.
-     */
-    ownerOrigin: string;
-  }
-
   export interface StorageBucketCreatedOrUpdatedEvent {
     bucketInfo: StorageBucketInfo;
   }
@@ -20247,7 +20016,7 @@ export namespace WebAuthn {
      * every assertion operation will report a value of 0.
      * See https://w3c.github.io/webauthn/#signature-counter
      */
-    signCount: integer;
+    signCount: number;
     /**
      * The large blob associated with the credential.
      * See https://w3c.github.io/webauthn/#sctn-large-blob-extension
@@ -20386,7 +20155,7 @@ export namespace WebAuthn {
      * assertion operation will report a value of 0.
      * See https://w3c.github.io/webauthn/#signature-counter
      */
-    signCount?: integer;
+    signCount?: number;
   }
 
   /**
@@ -20438,6 +20207,10 @@ export namespace WebMCP {
      * A hint indicating that the tool output may contain untrusted content, ex: UGC, 3rd party data.
      */
     untrustedContent?: boolean;
+    /**
+     * A hint indicating that executing the tool will result in consequential actions, ex: booking a flight, transferring money.
+     */
+    consequential?: boolean;
     /**
      * If the declarative tool was declared with the autosubmit attribute.
      */

package/front_end/models/ai_assistance/AiAgent2.ts

@@ -18,7 +18,9 @@ import {
 } from './agents/AiAgent.js';
 import {type ExecuteJsAgentOptions, executeJsCode} from './agents/ExecuteJavascript.js';
 import {ChangeManager} from './ChangeManager.js';
+import {AccessibilityContext} from './contexts/AccessibilityContext.js';
 import {DOMNodeContext} from './contexts/DOMNodeContext.js';
+import {PerformanceTraceContext} from './contexts/PerformanceTraceContext.js';
 import {debugLog} from './debug.js';
 import {ExtensionScope} from './ExtensionScope.js';
 import type {Skill, SkillName} from './skills/Skill.js';
@@ -47,7 +49,7 @@ Your role is to help web developers debug, analyze, and optimize web application
 # Workflow
 1. **Analyze**: Understand the user's intent, the context provided, and what they are trying to achieve.
 2. **Investigate**: Proactively use your learned skills and tools to gather live data. Do not make assumptions or guess without sufficient evidence.
-3. **Analyze**: Explore multiple potential explanations and solutions. Distinguish between the primary root cause and contributing factors.
+3. **Diagnose**: Explore multiple potential explanations and solutions. Distinguish between the primary root cause and contributing factors.
 4. **Respond**: Provide a structured, clear, and actionable response.
 
 # Response Structure
@@ -57,9 +59,14 @@ If the user asks a question that requires an investigation or debugging, use thi
 * **Suggestion(s)**: List actionable solution suggestion(s) in order of impact.
   - Example: "**Suggestion**: [Suggestion]" or "**Suggestions**:" followed by a bulleted list.
 
+# Follow-up Suggestions
+* Output a list of suggested follow-up queries or actions for the user at the very end of your response.
+* The format MUST be SUGGESTIONS: ["suggestion 1", "suggestion 2"] on its own single line.
+* Ensure suggestions are relevant, concise, and helpful next steps for the user.
+
 # Constraints
 * **CRITICAL**: You are a web development assistant. NEVER provide answers to questions of unrelated topics (such as legal advice, financial advice, personal opinions, medical advice, religion, race, politics, sexuality, gender, or any other non-web-development topics). If asked about these, respond with: "Sorry, I can't answer that. I'm best at questions about web development and debugging."
-* **CRITICAL**: Do not write full Python programs or other scripts to interact with the environment. Only invoke the allowed tools.
+* **CRITICAL**: Do not write standalone scripts (such as Python or bash) or arbitrary code to interact with the environment. The only way to execute code in the inspected page is via the 'executeJavaScript' tool.
 * **CRITICAL**: Do not expose raw, internal system identifiers (such as database IDs, internal node paths, or event keys) directly to the user. Use descriptive names instead.`;
 
 export interface AiAgent2Options extends ExecuteJsAgentOptions {
@@ -69,9 +76,9 @@ export interface AiAgent2Options extends ExecuteJsAgentOptions {
 
 export class AiAgent2 extends AiAgent<unknown> {
   // TODO: The static preamble is a placeholder and will eventually live server-side.
-  readonly preamble = preamble;
-  readonly clientFeature = Host.AidaClient.ClientFeature.CHROME_DEVTOOLS_V2_AGENT;
-  readonly userTier = 'TESTERS';
+  readonly preamble: string = preamble;
+  readonly clientFeature: Host.AidaClient.ClientFeature = Host.AidaClient.ClientFeature.CHROME_DEVTOOLS_V2_AGENT;
+  readonly userTier: string = 'TESTERS';
 
   #changes: ChangeManager;
   #execJs: typeof executeJsCode;
@@ -85,9 +92,12 @@ export class AiAgent2 extends AiAgent<unknown> {
   }
 
   protected override async preRun(): Promise<void> {
+    // One-way latch: once sensitive data enters the conversation history,
+    // logging must remain disabled for the lifetime of this agent instance.
     if (this.context && !this.context.isLoggingEnabled()) {
-      this.setServerSideLoggingActive(false);
+      this.disableServerSideLogging();
     }
+
     const target = this.targetManager.primaryPageTarget();
     const domModel = target?.model(SDK.DOMModel.DOMModel);
     // Ensure the DOM document is requested and cached in DOMModel so that
@@ -124,7 +134,7 @@ export class AiAgent2 extends AiAgent<unknown> {
     this.#declaredTools.add('learnSkills');
     this.declareFunction<{skills: SkillName[]}>('learnSkills', {
       description: () => {
-        const unloadedSkills = Object.keys(SKILLS).filter(name => !this.#activeSkills.has(name as SkillName));
+        const unloadedSkills = Object.keys(this.getSkills()).filter(name => !this.#activeSkills.has(name as SkillName));
         return `Loads the specified skills to gain access to their specialized tools. Call this ONLY for skills listed under Available skills that are not yet loaded. Do not call this for skills that are already loaded. Available skills that are not yet loaded: ${
             unloadedSkills.join(', ')}.`;
       },
@@ -183,6 +193,9 @@ QUERY: ${query}`;
       return enhancedQuery;
     }
 
+    // Note: Test assertion helpers in front_end/testing/AiAssistanceHelpers.ts (assertSkillLoaded,
+    // assertSkillNotLoaded) rely on this formatting (`Available skills that are not yet loaded:`
+    // and `- ${name}: ${skill.description}`). If this format is updated, update those helpers too.
     const skillsManifest = unloadedSkills.map(([name, skill]) => `- ${name}: ${skill.description}`).join('\n');
     return `Available skills that are not yet loaded:
 ${skillsManifest}
@@ -266,7 +279,6 @@ User query: ${enhancedQuery}`;
       displayInfoFromArgs: tool.displayInfoFromArgs,
       handler: (args, options) => {
         const context: AllToolsCapabilities = {
-          conversationContext: this.context ?? null,
           changeManager: this.#changes,
           createExtensionScope: this.#createExtensionScope.bind(this),
           execJs: this.#execJs,
@@ -274,10 +286,12 @@ User query: ${enhancedQuery}`;
               (this.context instanceof DOMNodeContext ? this.context.getItem() : this.#getDocumentBodyNode()),
           getTarget: () => this.targetManager.primaryPageTarget(),
           getEstablishedOrigin: () => this.#getConversationOrigin(),
-          lighthouseRecording: this.#lighthouseRecording,
+          getLighthouseReport: () => (this.context instanceof AccessibilityContext ? this.context.getItem() : null),
+          runLighthouse: async overrides => await (this.#lighthouseRecording?.(overrides) ?? null),
+          getPerformanceTraceContext: () => (this.context instanceof PerformanceTraceContext ? this.context : null),
           performanceRecordAndReload: this.#performanceRecordAndReload,
-          setLoggingEnabled: (enabled: boolean) => {
-            this.setServerSideLoggingActive(enabled);
+          disableLogging: () => {
+            this.disableServerSideLogging();
           },
         };
         return tool.handler(args, context, options);