devtools-protocol 0.0.1595872 → 0.0.1596832

package/json/browser_protocol.json

@@ -31384,6 +31384,118 @@
                     ]
                 }
             ]
+        },
+        {
+            "domain": "WebMCP",
+            "experimental": true,
+            "dependencies": [
+                "Runtime",
+                "Page",
+                "DOM"
+            ],
+            "types": [
+                {
+                    "id": "Annotation",
+                    "description": "Tool annotations",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "readOnly",
+                            "description": "A hint indicating that the tool does not modify any state.",
+                            "optional": true,
+                            "type": "boolean"
+                        },
+                        {
+                            "name": "autosubmit",
+                            "description": "If the declarative tool was declared with the autosubmit attribute.",
+                            "optional": true,
+                            "type": "boolean"
+                        }
+                    ]
+                },
+                {
+                    "id": "Tool",
+                    "description": "Definition of a tool that can be invoked.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "name",
+                            "description": "Tool name.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "description",
+                            "description": "Tool description.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "inputSchema",
+                            "description": "Schema for the tool's input parameters.",
+                            "optional": true,
+                            "type": "object"
+                        },
+                        {
+                            "name": "annotations",
+                            "description": "Optional annotations for the tool.",
+                            "optional": true,
+                            "$ref": "Annotation"
+                        },
+                        {
+                            "name": "frameId",
+                            "description": "Frame identifier associated with the tool registration.",
+                            "$ref": "Page.FrameId"
+                        },
+                        {
+                            "name": "backendNodeId",
+                            "description": "Optional node ID for declarative tools.",
+                            "optional": true,
+                            "$ref": "DOM.BackendNodeId"
+                        },
+                        {
+                            "name": "stackTrace",
+                            "description": "The stack trace at the time of the registration.",
+                            "optional": true,
+                            "$ref": "Runtime.StackTrace"
+                        }
+                    ]
+                }
+            ],
+            "commands": [
+                {
+                    "name": "enable",
+                    "description": "Enables the WebMCP domain, allowing events to be sent. Enabling the domain will trigger a toolsAdded event for\nall currently registered tools."
+                }
+            ],
+            "events": [
+                {
+                    "name": "toolsAdded",
+                    "description": "Event fired when new tools are added.",
+                    "parameters": [
+                        {
+                            "name": "tools",
+                            "description": "Array of tools that were added.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "Tool"
+                            }
+                        }
+                    ]
+                },
+                {
+                    "name": "toolsRemoved",
+                    "description": "Event fired when tools are removed.",
+                    "parameters": [
+                        {
+                            "name": "tools",
+                            "description": "Array of tools that were removed.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "Tool"
+                            }
+                        }
+                    ]
+                }
+            ]
         }
     ]
 }

package/package.json

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

package/pdl/browser_protocol.pdl

@@ -56,3 +56,4 @@ include domains/Tethering.pdl
 include domains/Tracing.pdl
 include domains/WebAudio.pdl
 include domains/WebAuthn.pdl
+include domains/WebMCP.pdl

package/types/protocol-mapping.d.ts

@@ -1114,6 +1114,14 @@ export namespace ProtocolMapping {
          * Triggered when a credential is used in a webauthn assertion.
          */
         'WebAuthn.credentialAsserted': [Protocol.WebAuthn.CredentialAssertedEvent];
+        /**
+         * Event fired when new tools are added.
+         */
+        'WebMCP.toolsAdded': [Protocol.WebMCP.ToolsAddedEvent];
+        /**
+         * Event fired when tools are removed.
+         */
+        'WebMCP.toolsRemoved': [Protocol.WebMCP.ToolsRemovedEvent];
     }
 
     export interface Commands {
@@ -6318,6 +6326,14 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.WebAuthn.SetCredentialPropertiesRequest];
             returnType: void;
         };
+        /**
+         * Enables the WebMCP domain, allowing events to be sent. Enabling the domain will trigger a toolsAdded event for
+         * all currently registered tools.
+         */
+        'WebMCP.enable': {
+            paramsType: [];
+            returnType: void;
+        };
     }
 }
 

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

@@ -122,6 +122,8 @@ export namespace ProtocolProxyApi {
 
         WebAuthn: WebAuthnApi;
 
+        WebMCP: WebMCPApi;
+
     }
 
 
@@ -5495,6 +5497,25 @@ export namespace ProtocolProxyApi {
         on(event: 'credentialAsserted', listener: (params: Protocol.WebAuthn.CredentialAssertedEvent) => void): void;
 
     }
+
+    export interface WebMCPApi {
+        /**
+         * Enables the WebMCP domain, allowing events to be sent. Enabling the domain will trigger a toolsAdded event for
+         * all currently registered tools.
+         */
+        enable(): Promise<void>;
+
+        /**
+         * Event fired when new tools are added.
+         */
+        on(event: 'toolsAdded', listener: (params: Protocol.WebMCP.ToolsAddedEvent) => void): void;
+
+        /**
+         * Event fired when tools are removed.
+         */
+        on(event: 'toolsRemoved', listener: (params: Protocol.WebMCP.ToolsRemovedEvent) => void): void;
+
+    }
 }
 
 export default ProtocolProxyApi;

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

@@ -122,6 +122,8 @@ export namespace ProtocolTestsProxyApi {
 
         WebAuthn: WebAuthnApi;
 
+        WebMCP: WebMCPApi;
+
     }
 
 
@@ -5969,6 +5971,29 @@ export namespace ProtocolTestsProxyApi {
         onceCredentialAsserted(eventMatcher?: (event: { params: Protocol.WebAuthn.CredentialAssertedEvent }) => boolean): Promise<{ params: Protocol.WebAuthn.CredentialAssertedEvent }>;
 
     }
+
+    export interface WebMCPApi {
+        /**
+         * Enables the WebMCP domain, allowing events to be sent. Enabling the domain will trigger a toolsAdded event for
+         * all currently registered tools.
+         */
+        enable(): Promise<{id: number, result: void, sessionId: string}>;
+
+        /**
+         * Event fired when new tools are added.
+         */
+        onToolsAdded(listener: (event: { params: Protocol.WebMCP.ToolsAddedEvent }) => void): void;
+        offToolsAdded(listener: (event: { params: Protocol.WebMCP.ToolsAddedEvent }) => void): void;
+        onceToolsAdded(eventMatcher?: (event: { params: Protocol.WebMCP.ToolsAddedEvent }) => boolean): Promise<{ params: Protocol.WebMCP.ToolsAddedEvent }>;
+
+        /**
+         * Event fired when tools are removed.
+         */
+        onToolsRemoved(listener: (event: { params: Protocol.WebMCP.ToolsRemovedEvent }) => void): void;
+        offToolsRemoved(listener: (event: { params: Protocol.WebMCP.ToolsRemovedEvent }) => void): void;
+        onceToolsRemoved(eventMatcher?: (event: { params: Protocol.WebMCP.ToolsRemovedEvent }) => boolean): Promise<{ params: Protocol.WebMCP.ToolsRemovedEvent }>;
+
+    }
 }
 
 export default ProtocolTestsProxyApi;

package/types/protocol.d.ts

@@ -22326,6 +22326,80 @@ export namespace Protocol {
             credential: Credential;
         }
     }
+
+    /**
+     * @experimental
+     */
+    export namespace WebMCP {
+
+        /**
+         * Tool annotations
+         */
+        export interface Annotation {
+            /**
+             * A hint indicating that the tool does not modify any state.
+             */
+            readOnly?: boolean;
+            /**
+             * If the declarative tool was declared with the autosubmit attribute.
+             */
+            autosubmit?: boolean;
+        }
+
+        /**
+         * Definition of a tool that can be invoked.
+         */
+        export interface Tool {
+            /**
+             * Tool name.
+             */
+            name: string;
+            /**
+             * Tool description.
+             */
+            description: string;
+            /**
+             * Schema for the tool's input parameters.
+             */
+            inputSchema?: any;
+            /**
+             * Optional annotations for the tool.
+             */
+            annotations?: Annotation;
+            /**
+             * Frame identifier associated with the tool registration.
+             */
+            frameId: Page.FrameId;
+            /**
+             * Optional node ID for declarative tools.
+             */
+            backendNodeId?: DOM.BackendNodeId;
+            /**
+             * The stack trace at the time of the registration.
+             */
+            stackTrace?: Runtime.StackTrace;
+        }
+
+        /**
+         * Event fired when new tools are added.
+         */
+        export interface ToolsAddedEvent {
+            /**
+             * Array of tools that were added.
+             */
+            tools: Tool[];
+        }
+
+        /**
+         * Event fired when tools are removed.
+         */
+        export interface ToolsRemovedEvent {
+            /**
+             * Array of tools that were removed.
+             */
+            tools: Tool[];
+        }
+    }
 }
 
 export default Protocol;