devtools-protocol 0.0.1602427 → 0.0.1603894

package/json/browser_protocol.json

@@ -31418,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.",
@@ -31499,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.1602427",
+  "version": "0.0.1603894",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

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

@@ -22348,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.
          */
@@ -22401,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;
+        }
     }
 }