@mcp-b/webmcp-ts-sdk 2.3.1 → 3.0.0-beta.20260529000441

package/README.md

@@ -52,7 +52,7 @@ Compatibility note:
 - `BrowserMcpServer.registerTool(tool, options?)` accepts the WebMCP April 23, 2026 draft signature, including `options.signal` (`AbortSignal`) for unregistration. When the signal aborts, both the server-side registration and the mirrored native registration are removed.
 - The same call still returns a deprecated `{ unregister }` compatibility handle so existing MCP-B integrations do not break, even though spec/native runtimes return `undefined`. The handle will be removed in the next major version — prefer `options.signal`.
 - `unregisterTool(name)` was removed from the WebMCP draft on April 23, 2026 in favor of the `AbortSignal` flow. It is kept on `BrowserMcpServer` with a one-time deprecation warning to interoperate with current Chrome Beta 147 (which still ships the string-name API). It will be removed in the next major version.
-- `provideContext()` and `clearContext()` were removed from the WebMCP draft on March 5, 2026. They are kept here as deprecated compatibility shims and emit a one-time deprecation warning when invoked.
+- `provideContext()` and `clearContext()` were removed from the WebMCP draft on March 5, 2026 and are not exposed by `BrowserMcpServer`.
 
 ## Modifications from Official SDK
 

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as z3 from "zod/v3";
 import * as z from "zod/v4";
 import * as z4 from "zod/v4/core";
-import { InputSchema, ModelContextCore, ModelContextOptions, ModelContextRegisterToolOptions, ModelContextTestingToolInfo, ModelContextToolReference, ResourceContents as ResourceContents$1, ToolDescriptor, ToolListItem, ToolResponse } from "@mcp-b/webmcp-types";
+import { InputSchema, ModelContextCore, ModelContextRegisterToolOptions, ModelContextTestingExecuteToolOptions, ModelContextToolInfo, ModelContextToolReference, ResourceContents as ResourceContents$1, ToolDescriptor, ToolListItem, ToolResponse } from "@mcp-b/webmcp-types";
 
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.d.ts
 type AnySchema = z3.ZodTypeAny | z4.$ZodType;
 type AnyObjectSchema = z3.AnyZodObject | z4.$ZodObject | AnySchema;
 type ZodRawShapeCompat = Record<string, AnySchema>;
@@ -14,7 +14,7 @@ type SchemaOutput<S> = S extends z3.ZodTypeAny ? z3.infer<S> : S extends z4.$Zod
  */
 type ShapeOutput<Shape extends ZodRawShapeCompat> = { [K in keyof Shape]: SchemaOutput<Shape[K]> };
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/server/auth/types.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/auth/types.d.ts
 /**
  * Information about a validated access token, provided to request handlers.
  */
@@ -47,7 +47,7 @@ interface AuthInfo {
   extra?: Record<string, unknown>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/types.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/types.d.ts
 declare const LATEST_PROTOCOL_VERSION = "2025-11-25";
 declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
 /**
@@ -5729,7 +5729,7 @@ type ServerRequest = Infer<typeof ServerRequestSchema>;
 type ServerNotification = Infer<typeof ServerNotificationSchema>;
 type ServerResult = Infer<typeof ServerResultSchema>;
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/transport.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/transport.d.ts
 /**
  * Options for sending a JSON-RPC message.
  */
@@ -5803,7 +5803,7 @@ interface Transport {
   setProtocolVersion?: (version: string) => void;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.d.ts
 /**
  * Extended handler extra with task store for task creation.
  * @experimental
@@ -6019,7 +6019,7 @@ interface TaskStore {
   }>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/responseMessage.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/responseMessage.d.ts
 /**
  * Base message type
  */
@@ -6061,7 +6061,7 @@ interface ErrorMessage extends BaseResponseMessage {
  */
 type ResponseMessage<T extends Result> = TaskStatusMessage | TaskCreatedMessage | ResultMessage<T> | ErrorMessage;
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.d.ts
 /**
  * Callback for progress notifications.
  */
@@ -7529,7 +7529,7 @@ declare enum TypeName {
   String = "string"
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/types.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/types.d.ts
 /**
  * JSON Schema type definition (JSON Schema Draft 2020-12)
  *
@@ -7594,7 +7594,7 @@ interface jsonSchemaValidator {
   getValidator<T>(schema: JsonSchemaType): JsonSchemaValidator$2<T>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/client.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/client.d.ts
 /**
  * Experimental task features for MCP clients.
  *
@@ -7703,7 +7703,7 @@ declare class ExperimentalClientTasks<RequestT extends Request = Request, Notifi
   requestStream<T extends AnyObjectSchema>(request: ClientRequest | RequestT, resultSchema: T, options?: RequestOptions): AsyncGenerator<ResponseMessage<SchemaOutput<T>>, void, void>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/client/index.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/client/index.d.ts
 type ClientOptions = ProtocolOptions & {
   /**
    * Capabilities to advertise as being supported by this client.
@@ -8271,7 +8271,7 @@ declare class Client<RequestT extends Request = Request, NotificationT extends N
   sendRootsListChanged(): Promise<void>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.d.ts
 /**
  * Buffers a continuous stdio stream into discrete JSON-RPC messages.
  */
@@ -8283,7 +8283,7 @@ declare class ReadBuffer {
 }
 declare function serializeMessage(message: JSONRPCMessage): string;
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.d.ts
 /**
  * Experimental task features for low-level MCP servers.
  *
@@ -8356,7 +8356,7 @@ declare class ExperimentalServerTasks<RequestT extends Request = Request, Notifi
   cancelTask(taskId: string, options?: RequestOptions): Promise<CancelTaskResult>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.d.ts
 type ServerOptions = ProtocolOptions & {
   /**
    * Capabilities to advertise as being supported by this server.
@@ -8547,7 +8547,7 @@ declare class Server<RequestT extends Request = Request, NotificationT extends N
   sendPromptListChanged(): Promise<void>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/uriTemplate.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/uriTemplate.d.ts
 type Variables = Record<string, string | string[]>;
 declare class UriTemplate {
   /**
@@ -8573,7 +8573,7 @@ declare class UriTemplate {
   match(uri: string): Variables | null;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.d.ts
 /**
  * Experimental task features for McpServer.
  *
@@ -8641,7 +8641,7 @@ declare class ExperimentalMcpServerTasks {
   }, handler: ToolTaskHandler<InputArgs>): RegisteredTool;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.3.5/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.d.ts
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.26.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.d.ts
 /**
  * High-level MCP server that provides a simpler API for working with resources, tools, and prompts.
  * For advanced usage (like sending notifications or setting custom request handlers), use the underlying
@@ -9012,8 +9012,8 @@ type RegisteredToolHandle = {
  * (resources, prompts, elicitation, sampling) via BaseMcpServer.
  *
  * Deprecated compatibility (kept for Chrome Beta 147 and existing wrappers,
- * removed in the next major): `unregisterTool(name)`, `provideContext()`,
- * `clearContext()`, and the `{ unregister }` handle returned from `registerTool`.
+ * removed in the next major): `unregisterTool(name)` and the `{ unregister }`
+ * handle returned from `registerTool`.
  *
  * When `native` is provided, tool operations are mirrored so that
  * navigator.modelContextTesting stays in sync.
@@ -9024,8 +9024,6 @@ declare class BrowserMcpServer extends McpServer {
   private _promptSchemas;
   private _jsonValidator;
   private _publicMethodsBound;
-  private _provideContextDeprecationWarned;
-  private _clearContextDeprecationWarned;
   private _unregisterToolDeprecationWarned;
   private _nativeToolCleanups;
   private _producerEventTarget;
@@ -9068,7 +9066,6 @@ declare class BrowserMcpServer extends McpServer {
    */
   syncNativeTools(): number;
   unregisterTool(nameOrTool: string | ModelContextToolReference): void;
-  private clearRegisteredTools;
   registerResource(descriptor: {
     uri: string;
     name: string;
@@ -9090,11 +9087,7 @@ declare class BrowserMcpServer extends McpServer {
   }): {
     unregister: () => void;
   };
-  provideContext(options?: ModelContextOptions): void;
-  clearContext(): void;
   private resolveToolNameForUnregister;
-  private warnProvideContextDeprecationOnce;
-  private warnClearContextDeprecationOnce;
   private warnUnregisterToolDeprecationOnce;
   listResources(): Array<{
     uri: string;
@@ -9118,7 +9111,7 @@ declare class BrowserMcpServer extends McpServer {
     messages: PromptMessage[];
   }>;
   listTools(): ToolListItem[];
-  getTools(): ModelContextTestingToolInfo[];
+  getTools(): Promise<ModelContextToolInfo[]>;
   /**
    * Override SDK's validateToolInput to handle both Zod schemas and plain JSON Schema.
    * Zod schemas use the SDK's safeParseAsync; plain JSON Schema uses PolyfillJsonSchemaValidator.
@@ -9136,6 +9129,7 @@ declare class BrowserMcpServer extends McpServer {
     name: string;
     arguments?: Record<string, unknown>;
   }): Promise<ToolResponse>;
+  executeTool(tool: ModelContextToolInfo, inputArgsJson: string, options?: ModelContextTestingExecuteToolOptions): Promise<string | null>;
   executeTool(name: string, args?: Record<string, unknown>): Promise<ToolResponse>;
   /**
    * Override connect to initialize request handlers BEFORE the transport connection.