devtools-protocol 0.0.1601756 → 0.0.1603894

package/json/browser_protocol.json

@@ -6928,7 +6928,8 @@
             "domain": "DOM",
             "description": "This domain exposes DOM read/write operations. Each DOM Node is represented with its mirror object\nthat has an `id`. This `id` can be used to get additional information on the Node, resolve it into\nthe JavaScript object wrapper, etc. It is important that client receives DOM events only for the\nnodes that are known to the client. Backend keeps track of the nodes that were sent to the client\nand never sends the same node twice. It is client's responsibility to collect information about\nthe nodes that were sent to the client. Note that `iframe` owner elements will return\ncorresponding document elements as their child nodes.",
             "dependencies": [
-                "Runtime"
+                "Runtime",
+                "Network"
             ],
             "types": [
                 {
@@ -7285,10 +7286,10 @@
                             }
                         },
                         {
-                            "name": "isAdRelated",
+                            "name": "adProvenance",
                             "experimental": true,
                             "optional": true,
-                            "type": "boolean"
+                            "$ref": "Network.AdProvenance"
                         }
                     ]
                 },
@@ -8854,9 +8855,10 @@
                             "$ref": "DOM.NodeId"
                         },
                         {
-                            "name": "isAdRelated",
-                            "description": "If the node is ad related.",
-                            "type": "boolean"
+                            "name": "adProvenance",
+                            "description": "The provenance of the ad related node, if it is ad related.",
+                            "optional": true,
+                            "$ref": "Network.AdProvenance"
                         }
                     ]
                 },
@@ -17297,6 +17299,26 @@
                         }
                     ]
                 },
+                {
+                    "id": "AdProvenance",
+                    "description": "Represents the provenance of an ad resource or element. Only one of\n`filterlistRule` or `adScriptAncestry` can be set. If `filterlistRule`\nis provided, the resource URL directly matches a filter list rule. If\n`adScriptAncestry` is provided, an ad script initiated the resource fetch or\nappended the element to the DOM. If neither is provided, the entity is\nknown to be an ad, but provenance tracking information is unavailable.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "filterlistRule",
+                            "description": "The filterlist rule that matched, if any.",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "adScriptAncestry",
+                            "description": "The script ancestry that created the ad, if any.",
+                            "optional": true,
+                            "$ref": "AdAncestry"
+                        }
+                    ]
+                },
                 {
                     "id": "CrossOriginOpenerPolicyValue",
                     "experimental": true,
@@ -31396,6 +31418,16 @@
                         }
                     ]
                 },
+                {
+                    "id": "InvocationStatus",
+                    "description": "Represents the status of a tool invocation.",
+                    "type": "string",
+                    "enum": [
+                        "Success",
+                        "Canceled",
+                        "Error"
+                    ]
+                },
                 {
                     "id": "Tool",
                     "description": "Definition of a tool that can be invoked.",
@@ -31477,6 +31509,66 @@
                             }
                         }
                     ]
+                },
+                {
+                    "name": "toolInvoked",
+                    "description": "Event fired when a tool invocation starts.",
+                    "parameters": [
+                        {
+                            "name": "toolName",
+                            "description": "Name of the tool to invoke.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "frameId",
+                            "description": "Frame id",
+                            "$ref": "Page.FrameId"
+                        },
+                        {
+                            "name": "invocationId",
+                            "description": "Invocation identifier.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "input",
+                            "description": "The input parameters used for the invocation.",
+                            "type": "string"
+                        }
+                    ]
+                },
+                {
+                    "name": "toolResponded",
+                    "description": "Event fired when a tool invocation completes or fails.",
+                    "parameters": [
+                        {
+                            "name": "invocationId",
+                            "description": "Invocation identifier.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "status",
+                            "description": "Status of the invocation.",
+                            "$ref": "InvocationStatus"
+                        },
+                        {
+                            "name": "output",
+                            "description": "Output or error delivered as delivered to the agent. Missing if `status` is anything other than Success.",
+                            "optional": true,
+                            "type": "object"
+                        },
+                        {
+                            "name": "errorText",
+                            "description": "Error text for protocol users.",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "exception",
+                            "description": "The exception object, if the javascript tool threw an error>",
+                            "optional": true,
+                            "$ref": "Runtime.RemoteObject"
+                        }
+                    ]
                 }
             ]
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1601756",
+  "version": "0.0.1603894",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

package/pdl/domains/DOM.pdl

@@ -13,6 +13,7 @@
 # corresponding document elements as their child nodes.
 domain DOM
   depends on Runtime
+  depends on Network
 
   # Unique DOM node identifier.
   type NodeId extends integer
@@ -184,7 +185,7 @@ domain DOM
       experimental optional boolean isScrollable
       experimental optional boolean affectedByStartingStyles
       experimental optional array of StyleSheetId adoptedStyleSheets
-      experimental optional boolean isAdRelated
+      experimental optional Network.AdProvenance adProvenance
 
   # A structure to hold the top-level node of a detached tree and an array of its retained descendants.
   type DetachedElementInfo extends object
@@ -919,8 +920,8 @@ domain DOM
     parameters
       # The id of the node.
       DOM.NodeId nodeId
-      # If the node is ad related.
-      boolean isAdRelated
+      # The provenance of the ad related node, if it is ad related.
+      optional Network.AdProvenance adProvenance
 
   # Fired when a node's starting styles changes.
   experimental event affectedByStartingStylesFlagUpdated

package/pdl/domains/Network.pdl

@@ -1825,6 +1825,19 @@ domain Network
       # `ancestryChain` to be tagged as an ad.
       optional string rootScriptFilterlistRule
 
+  # Represents the provenance of an ad resource or element. Only one of
+  # `filterlistRule` or `adScriptAncestry` can be set. If `filterlistRule`
+  # is provided, the resource URL directly matches a filter list rule. If
+  # `adScriptAncestry` is provided, an ad script initiated the resource fetch or
+  # appended the element to the DOM. If neither is provided, the entity is
+  # known to be an ad, but provenance tracking information is unavailable.
+  experimental type AdProvenance extends object
+    properties
+      # The filterlist rule that matched, if any.
+      optional string filterlistRule
+      # The script ancestry that created the ad, if any.
+      optional AdAncestry adScriptAncestry
+
   # Fired when additional information about a requestWillBeSent event is available from the
   # network stack. Not every requestWillBeSent event will have an additional
   # requestWillBeSentExtraInfo fired for it, and there is no guarantee whether requestWillBeSent

package/pdl/domains/WebMCP.pdl

@@ -11,12 +11,20 @@ experimental domain WebMCP
 
   # Tool annotations
   type Annotation extends object
+
     properties
       # A hint indicating that the tool does not modify any state.
       optional boolean readOnly
       # If the declarative tool was declared with the autosubmit attribute.
       optional boolean autosubmit
 
+  # Represents the status of a tool invocation.
+  type InvocationStatus extends string
+    enum
+      Success
+      Canceled
+      Error
+
   # Definition of a tool that can be invoked.
   type Tool extends object
     properties
@@ -51,3 +59,30 @@ experimental domain WebMCP
     parameters
       # Array of tools that were removed.
       array of Tool tools
+
+  # Event fired when a tool invocation starts.
+  event toolInvoked
+    parameters
+      # Name of the tool to invoke.
+      string toolName
+      # Frame id
+      Page.FrameId frameId
+      # Invocation identifier.
+      string invocationId
+      # The input parameters used for the invocation.
+      string input
+
+  # Event fired when a tool invocation completes or fails.
+  event toolResponded
+    parameters
+      # Invocation identifier.
+      string invocationId
+      # Status of the invocation.
+      InvocationStatus status
+      # Output or error delivered as delivered to the agent. Missing if `status` is anything other than Success.
+      optional object output
+      # Error text for protocol users.
+      optional string errorText
+      # The exception object, if the javascript tool threw an error>
+      optional Runtime.RemoteObject exception
+

package/types/protocol-mapping.d.ts

@@ -1122,6 +1122,14 @@ export namespace ProtocolMapping {
          * Event fired when tools are removed.
          */
         'WebMCP.toolsRemoved': [Protocol.WebMCP.ToolsRemovedEvent];
+        /**
+         * Event fired when a tool invocation starts.
+         */
+        'WebMCP.toolInvoked': [Protocol.WebMCP.ToolInvokedEvent];
+        /**
+         * Event fired when a tool invocation completes or fails.
+         */
+        'WebMCP.toolResponded': [Protocol.WebMCP.ToolRespondedEvent];
     }
 
     export interface Commands {

package/types/protocol-proxy-api.d.ts

@@ -5515,6 +5515,16 @@ export namespace ProtocolProxyApi {
          */
         on(event: 'toolsRemoved', listener: (params: Protocol.WebMCP.ToolsRemovedEvent) => void): void;
 
+        /**
+         * Event fired when a tool invocation starts.
+         */
+        on(event: 'toolInvoked', listener: (params: Protocol.WebMCP.ToolInvokedEvent) => void): void;
+
+        /**
+         * Event fired when a tool invocation completes or fails.
+         */
+        on(event: 'toolResponded', listener: (params: Protocol.WebMCP.ToolRespondedEvent) => void): void;
+
     }
 }
 

package/types/protocol-tests-proxy-api.d.ts

@@ -5993,6 +5993,20 @@ export namespace ProtocolTestsProxyApi {
         offToolsRemoved(listener: (event: { params: Protocol.WebMCP.ToolsRemovedEvent }) => void): void;
         onceToolsRemoved(eventMatcher?: (event: { params: Protocol.WebMCP.ToolsRemovedEvent }) => boolean): Promise<{ params: Protocol.WebMCP.ToolsRemovedEvent }>;
 
+        /**
+         * Event fired when a tool invocation starts.
+         */
+        onToolInvoked(listener: (event: { params: Protocol.WebMCP.ToolInvokedEvent }) => void): void;
+        offToolInvoked(listener: (event: { params: Protocol.WebMCP.ToolInvokedEvent }) => void): void;
+        onceToolInvoked(eventMatcher?: (event: { params: Protocol.WebMCP.ToolInvokedEvent }) => boolean): Promise<{ params: Protocol.WebMCP.ToolInvokedEvent }>;
+
+        /**
+         * Event fired when a tool invocation completes or fails.
+         */
+        onToolResponded(listener: (event: { params: Protocol.WebMCP.ToolRespondedEvent }) => void): void;
+        offToolResponded(listener: (event: { params: Protocol.WebMCP.ToolRespondedEvent }) => void): void;
+        onceToolResponded(eventMatcher?: (event: { params: Protocol.WebMCP.ToolRespondedEvent }) => boolean): Promise<{ params: Protocol.WebMCP.ToolRespondedEvent }>;
+
     }
 }
 

package/types/protocol.d.ts

@@ -7062,7 +7062,7 @@ export namespace Protocol {
             /**
              * @experimental
              */
-            isAdRelated?: boolean;
+            adProvenance?: Network.AdProvenance;
         }
 
         /**
@@ -8138,9 +8138,9 @@ export namespace Protocol {
              */
             nodeId: DOM.NodeId;
             /**
-             * If the node is ad related.
+             * The provenance of the ad related node, if it is ad related.
              */
-            isAdRelated: boolean;
+            adProvenance?: Network.AdProvenance;
         }
 
         /**
@@ -13687,6 +13687,26 @@ export namespace Protocol {
             rootScriptFilterlistRule?: string;
         }
 
+        /**
+         * Represents the provenance of an ad resource or element. Only one of
+         * `filterlistRule` or `adScriptAncestry` can be set. If `filterlistRule`
+         * is provided, the resource URL directly matches a filter list rule. If
+         * `adScriptAncestry` is provided, an ad script initiated the resource fetch or
+         * appended the element to the DOM. If neither is provided, the entity is
+         * known to be an ad, but provenance tracking information is unavailable.
+         * @experimental
+         */
+        export interface AdProvenance {
+            /**
+             * The filterlist rule that matched, if any.
+             */
+            filterlistRule?: string;
+            /**
+             * The script ancestry that created the ad, if any.
+             */
+            adScriptAncestry?: AdAncestry;
+        }
+
         /**
          * @experimental
          */
@@ -22328,6 +22348,11 @@ export namespace Protocol {
             autosubmit?: boolean;
         }
 
+        /**
+         * Represents the status of a tool invocation.
+         */
+        export type InvocationStatus = ('Success' | 'Canceled' | 'Error');
+
         /**
          * Definition of a tool that can be invoked.
          */
@@ -22381,6 +22406,54 @@ export namespace Protocol {
              */
             tools: Tool[];
         }
+
+        /**
+         * Event fired when a tool invocation starts.
+         */
+        export interface ToolInvokedEvent {
+            /**
+             * Name of the tool to invoke.
+             */
+            toolName: string;
+            /**
+             * Frame id
+             */
+            frameId: Page.FrameId;
+            /**
+             * Invocation identifier.
+             */
+            invocationId: string;
+            /**
+             * The input parameters used for the invocation.
+             */
+            input: string;
+        }
+
+        /**
+         * Event fired when a tool invocation completes or fails.
+         */
+        export interface ToolRespondedEvent {
+            /**
+             * Invocation identifier.
+             */
+            invocationId: string;
+            /**
+             * Status of the invocation.
+             */
+            status: InvocationStatus;
+            /**
+             * Output or error delivered as delivered to the agent. Missing if `status` is anything other than Success.
+             */
+            output?: any;
+            /**
+             * Error text for protocol users.
+             */
+            errorText?: string;
+            /**
+             * The exception object, if the javascript tool threw an error>
+             */
+            exception?: Runtime.RemoteObject;
+        }
     }
 }