@mcp-b/webmcp-local-relay 4.0.0 → 5.0.0

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 import { EventEmitter } from "node:events";
-import { CallToolRequestParamsSchema, CallToolResult, CallToolResult as CallToolResult$1, CallToolResultSchema, Tool, Tool as Tool$1, ToolAnnotations, ToolAnnotations as ToolAnnotations$1, ToolAnnotationsSchema, ToolSchema } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestParamsSchema, CallToolResultSchema, ToolAnnotationsSchema, ToolSchema } from "@modelcontextprotocol/core";
 import { z } from "zod/v4";
-import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import * as _$_modelcontextprotocol_server0 from "@modelcontextprotocol/server";
+import { CallToolResult, Tool, ToolAnnotations, Transport } from "@modelcontextprotocol/server";
 
 //#region src/protocol.d.ts
 /**
@@ -11,14 +12,12 @@ declare const NormalizedToolSchema: z.ZodObject<{
   description: z.ZodOptional<z.ZodString>;
   inputSchema: z.ZodObject<{
     type: z.ZodLiteral<"object">;
-    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<object, object>>>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue, z.core.$ZodTypeInternals<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue>>>>;
     required: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$catchall<z.ZodUnknown>>;
   outputSchema: z.ZodOptional<z.ZodObject<{
-    type: z.ZodLiteral<"object">;
-    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<object, object>>>;
-    required: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  }, z.core.$catchall<z.ZodUnknown>>>;
+    $schema: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
   annotations: z.ZodOptional<z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     readOnlyHint: z.ZodOptional<z.ZodBoolean>;
@@ -46,15 +45,6 @@ declare const NormalizedToolSchema: z.ZodObject<{
   title: z.ZodOptional<z.ZodString>;
   name: z.ZodString;
 }, z.core.$strip>;
-/**
- * Permissive inbound tool shape from browser/widget payloads.
- *
- * Only enforces a non-empty name at ingest. All other fields are normalized
- * against SDK schemas by {@link normalizeInboundTool}.
- */
-declare const InboundToolSchema: z.ZodObject<{
-  name: z.ZodString;
-}, z.core.$loose>;
 /**
  * SDK-derived argument schema for tool invocation payloads.
  */
@@ -63,7 +53,45 @@ declare const RelayInvokeArgsSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.Zo
  * Default input schema applied when inbound payload omits or provides
  * a non-object input schema.
  */
-declare const DEFAULT_TOOL_INPUT_SCHEMA: Tool$1['inputSchema'];
+declare const DEFAULT_TOOL_INPUT_SCHEMA: Tool['inputSchema'];
+/** SDK tool schema with a browser-compatible default input schema. */
+declare const InboundToolSchema: z.ZodObject<{
+  description: z.ZodOptional<z.ZodString>;
+  outputSchema: z.ZodOptional<z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+  annotations: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+    destructiveHint: z.ZodOptional<z.ZodBoolean>;
+    idempotentHint: z.ZodOptional<z.ZodBoolean>;
+    openWorldHint: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>;
+  execution: z.ZodOptional<z.ZodObject<{
+    taskSupport: z.ZodOptional<z.ZodEnum<{
+      optional: "optional";
+      required: "required";
+      forbidden: "forbidden";
+    }>>;
+  }, z.core.$strip>>;
+  _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    src: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+    sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    theme: z.ZodOptional<z.ZodEnum<{
+      light: "light";
+      dark: "dark";
+    }>>;
+  }, z.core.$strip>>>;
+  title: z.ZodOptional<z.ZodString>;
+  name: z.ZodString;
+  inputSchema: z.ZodOptional<z.ZodObject<{
+    type: z.ZodLiteral<"object">;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue, z.core.$ZodTypeInternals<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue>>>>;
+    required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$catchall<z.ZodUnknown>>>;
+}, z.core.$strip>;
 /**
  * Canonical normalized relay tool shape.
  */
@@ -71,27 +99,21 @@ type RelayTool = z.infer<typeof NormalizedToolSchema>;
 /**
  * Canonical relay tool annotations shape.
  */
-type RelayToolAnnotations = ToolAnnotations$1;
+type RelayToolAnnotations = ToolAnnotations;
 /**
  * Canonical relay call result shape.
  */
-type RelayCallToolResult = CallToolResult$1;
+type RelayCallToolResult = CallToolResult;
 /**
  * Invocation argument object shape derived from MCP SDK request params.
  */
 type RelayInvokeArgs = Exclude<z.infer<typeof RelayInvokeArgsSchema>, undefined>;
 /**
- * Normalizes permissive inbound tool payloads into SDK-compliant Tool objects.
- *
- * Invalid optional metadata (description, output schema, annotations, etc.)
- * is dropped. Invalid/missing inputSchema falls back to an empty object schema.
+ * Applies the browser default input schema and validates the complete SDK tool.
  */
 declare function normalizeInboundTool(inbound: z.infer<typeof InboundToolSchema>): RelayTool;
 //#endregion
 //#region src/schemas.d.ts
-/**
- * Schema for source identity bootstrap message.
- */
 declare const BrowserHelloMessageSchema: z.ZodObject<{
   type: z.ZodLiteral<"hello">;
   tabId: z.ZodString;
@@ -113,21 +135,53 @@ declare const BrowserToRelayMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"tools/list">;
   tools: z.ZodPipe<z.ZodArray<z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    outputSchema: z.ZodOptional<z.ZodObject<{
+      $schema: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    annotations: z.ZodOptional<z.ZodObject<{
+      title: z.ZodOptional<z.ZodString>;
+      readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+      destructiveHint: z.ZodOptional<z.ZodBoolean>;
+      idempotentHint: z.ZodOptional<z.ZodBoolean>;
+      openWorldHint: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    execution: z.ZodOptional<z.ZodObject<{
+      taskSupport: z.ZodOptional<z.ZodEnum<{
+        optional: "optional";
+        required: "required";
+        forbidden: "forbidden";
+      }>>;
+    }, z.core.$strip>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      src: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+      sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      theme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+      }>>;
+    }, z.core.$strip>>>;
+    title: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
-  }, z.core.$loose>>, z.ZodTransform<{
+    inputSchema: z.ZodOptional<z.ZodObject<{
+      type: z.ZodLiteral<"object">;
+      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue, z.core.$ZodTypeInternals<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue>>>>;
+      required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+  }, z.core.$strip>>, z.ZodTransform<{
     inputSchema: {
       [x: string]: unknown;
       type: "object";
-      properties?: Record<string, object> | undefined;
+      properties?: Record<string, _$_modelcontextprotocol_server0.JSONValue> | undefined;
       required?: string[] | undefined;
     };
     name: string;
     description?: string | undefined;
     outputSchema?: {
       [x: string]: unknown;
-      type: "object";
-      properties?: Record<string, object> | undefined;
-      required?: string[] | undefined;
+      $schema?: string | undefined;
     } | undefined;
     annotations?: {
       title?: string | undefined;
@@ -148,27 +202,87 @@ declare const BrowserToRelayMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     }[] | undefined;
     title?: string | undefined;
   }[], {
-    [x: string]: unknown;
     name: string;
+    description?: string | undefined;
+    outputSchema?: {
+      [x: string]: unknown;
+      $schema?: string | undefined;
+    } | undefined;
+    annotations?: {
+      title?: string | undefined;
+      readOnlyHint?: boolean | undefined;
+      destructiveHint?: boolean | undefined;
+      idempotentHint?: boolean | undefined;
+      openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+      taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: Record<string, unknown> | undefined;
+    icons?: {
+      src: string;
+      mimeType?: string | undefined;
+      sizes?: string[] | undefined;
+      theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+    inputSchema?: {
+      [x: string]: unknown;
+      type: "object";
+      properties?: Record<string, _$_modelcontextprotocol_server0.JSONValue> | undefined;
+      required?: string[] | undefined;
+    } | undefined;
   }[]>>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"tools/changed">;
   tools: z.ZodPipe<z.ZodArray<z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    outputSchema: z.ZodOptional<z.ZodObject<{
+      $schema: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    annotations: z.ZodOptional<z.ZodObject<{
+      title: z.ZodOptional<z.ZodString>;
+      readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+      destructiveHint: z.ZodOptional<z.ZodBoolean>;
+      idempotentHint: z.ZodOptional<z.ZodBoolean>;
+      openWorldHint: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    execution: z.ZodOptional<z.ZodObject<{
+      taskSupport: z.ZodOptional<z.ZodEnum<{
+        optional: "optional";
+        required: "required";
+        forbidden: "forbidden";
+      }>>;
+    }, z.core.$strip>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      src: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+      sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      theme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+      }>>;
+    }, z.core.$strip>>>;
+    title: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
-  }, z.core.$loose>>, z.ZodTransform<{
+    inputSchema: z.ZodOptional<z.ZodObject<{
+      type: z.ZodLiteral<"object">;
+      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue, z.core.$ZodTypeInternals<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue>>>>;
+      required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+  }, z.core.$strip>>, z.ZodTransform<{
     inputSchema: {
       [x: string]: unknown;
       type: "object";
-      properties?: Record<string, object> | undefined;
+      properties?: Record<string, _$_modelcontextprotocol_server0.JSONValue> | undefined;
       required?: string[] | undefined;
     };
     name: string;
     description?: string | undefined;
     outputSchema?: {
       [x: string]: unknown;
-      type: "object";
-      properties?: Record<string, object> | undefined;
-      required?: string[] | undefined;
+      $schema?: string | undefined;
     } | undefined;
     annotations?: {
       title?: string | undefined;
@@ -189,8 +303,36 @@ declare const BrowserToRelayMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     }[] | undefined;
     title?: string | undefined;
   }[], {
-    [x: string]: unknown;
     name: string;
+    description?: string | undefined;
+    outputSchema?: {
+      [x: string]: unknown;
+      $schema?: string | undefined;
+    } | undefined;
+    annotations?: {
+      title?: string | undefined;
+      readOnlyHint?: boolean | undefined;
+      destructiveHint?: boolean | undefined;
+      idempotentHint?: boolean | undefined;
+      openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+      taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: Record<string, unknown> | undefined;
+    icons?: {
+      src: string;
+      mimeType?: string | undefined;
+      sizes?: string[] | undefined;
+      theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+    inputSchema?: {
+      [x: string]: unknown;
+      type: "object";
+      properties?: Record<string, _$_modelcontextprotocol_server0.JSONValue> | undefined;
+      required?: string[] | undefined;
+    } | undefined;
   }[]>>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"result">;
@@ -198,11 +340,7 @@ declare const BrowserToRelayMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
   result: z.ZodUnknown;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"pong">;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"elicitation-request">;
-  callId: z.ZodString;
-  params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "type">;
 /**
  * Browser-to-relay message payload.
  */
@@ -294,18 +432,11 @@ declare const RelayToBrowserMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
   type: z.ZodLiteral<"ping">;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"reload">;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"elicitation-response">;
-  callId: z.ZodString;
-  result: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "type">;
 /**
  * Relay-to-browser message payload.
  */
 type RelayToBrowserMessage = z.infer<typeof RelayToBrowserMessageSchema>;
-/**
- * Relay-to-relay protocol (client mode <-> server mode).
- */
 /**
  * Schema for source metadata transmitted in relay-to-relay messages.
  */
@@ -336,7 +467,7 @@ declare const RelayClientToServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
   callId: z.ZodString;
   toolName: z.ZodString;
   args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "type">;
 /**
  * Relay client to server message payload.
  */
@@ -359,14 +490,12 @@ declare const RelayServerToClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     description: z.ZodOptional<z.ZodString>;
     inputSchema: z.ZodObject<{
       type: z.ZodLiteral<"object">;
-      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<object, object>>>;
+      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue, z.core.$ZodTypeInternals<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue>>>>;
       required: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$catchall<z.ZodUnknown>>;
     outputSchema: z.ZodOptional<z.ZodObject<{
-      type: z.ZodLiteral<"object">;
-      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<object, object>>>;
-      required: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$catchall<z.ZodUnknown>>>;
+      $schema: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     annotations: z.ZodOptional<z.ZodObject<{
       title: z.ZodOptional<z.ZodString>;
       readOnlyHint: z.ZodOptional<z.ZodBoolean>;
@@ -394,7 +523,7 @@ declare const RelayServerToClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     title: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
   }, z.core.$strip>>;
-  sources: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+  sources: z.ZodArray<z.ZodObject<{
     sourceId: z.ZodString;
     tabId: z.ZodString;
     origin: z.ZodOptional<z.ZodString>;
@@ -404,18 +533,30 @@ declare const RelayServerToClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     connectedAt: z.ZodNumber;
     lastSeenAt: z.ZodNumber;
     toolCount: z.ZodNumber;
-  }, z.core.$strip>>>>;
-  toolSourceMap: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+  }, z.core.$strip>>;
+  toolSourceMap: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
   type: z.ZodLiteral<"relay/tools">;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"relay/result">;
   callId: z.ZodString;
   result: z.ZodObject<{
     _meta: z.ZodOptional<z.ZodObject<{
-      progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-      "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
-        taskId: z.ZodString;
-      }, z.core.$strip>>;
+      readonly "io.modelcontextprotocol/serverInfo": z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        version: z.ZodString;
+        websiteUrl: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          src: z.ZodString;
+          mimeType: z.ZodOptional<z.ZodString>;
+          sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+          theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+          }>>;
+        }, z.core.$strip>>>;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>>;
     }, z.core.$loose>>;
     content: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
       type: z.ZodLiteral<"text">;
@@ -504,7 +645,7 @@ declare const RelayServerToClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
       }, z.core.$strip>>;
       _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>]>>>;
-    structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    structuredContent: z.ZodOptional<z.ZodUnknown>;
     isError: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$loose>;
 }, z.core.$strip>, z.ZodObject<{
@@ -512,14 +653,12 @@ declare const RelayServerToClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     description: z.ZodOptional<z.ZodString>;
     inputSchema: z.ZodObject<{
       type: z.ZodLiteral<"object">;
-      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<object, object>>>;
+      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue, z.core.$ZodTypeInternals<_$_modelcontextprotocol_server0.JSONValue, _$_modelcontextprotocol_server0.JSONValue>>>>;
       required: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$catchall<z.ZodUnknown>>;
     outputSchema: z.ZodOptional<z.ZodObject<{
-      type: z.ZodLiteral<"object">;
-      properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<object, object>>>;
-      required: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$catchall<z.ZodUnknown>>>;
+      $schema: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     annotations: z.ZodOptional<z.ZodObject<{
       title: z.ZodOptional<z.ZodString>;
       readOnlyHint: z.ZodOptional<z.ZodBoolean>;
@@ -547,7 +686,7 @@ declare const RelayServerToClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     title: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
   }, z.core.$strip>>;
-  sources: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+  sources: z.ZodArray<z.ZodObject<{
     sourceId: z.ZodString;
     tabId: z.ZodString;
     origin: z.ZodOptional<z.ZodString>;
@@ -557,10 +696,10 @@ declare const RelayServerToClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     connectedAt: z.ZodNumber;
     lastSeenAt: z.ZodNumber;
     toolCount: z.ZodNumber;
-  }, z.core.$strip>>>>;
-  toolSourceMap: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+  }, z.core.$strip>>;
+  toolSourceMap: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
   type: z.ZodLiteral<"relay/tools-changed">;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "type">;
 /**
  * Relay server to client message payload.
  */
@@ -573,10 +712,10 @@ type RelayServerToClientMessage = z.infer<typeof RelayServerToClientMessageSchem
 interface SourceMetadata {
   sourceId: string;
   tabId: string;
-  origin: string | undefined;
-  url: string | undefined;
-  title: string | undefined;
-  iconUrl: string | undefined;
+  origin?: string | undefined;
+  url?: string | undefined;
+  title?: string | undefined;
+  iconUrl?: string | undefined;
   connectedAt: number;
   lastSeenAt: number;
 }
@@ -667,10 +806,6 @@ declare class RelayRegistry {
    * Converts internal source metadata to public source info.
    */
   private toSourceInfo;
-  /**
-   * Removes all tool providers for a connection.
-   */
-  private removeConnectionTools;
   /**
    * Rebuilds public tool names after source set changes.
    *
@@ -720,7 +855,7 @@ interface RelayBridgeServerOptions {
    */
   persistPath?: string;
   /**
-   * Allowed host page origins reported by browser `hello` messages.
+   * Allowed host page origins verified from browser WebSocket requests.
    * Use `["*"]` to allow all origins.
    *
    * Permissive by default for zero-config developer experience: any browser
@@ -738,7 +873,7 @@ interface RelayBridgeServerOptions {
   maxPayloadBytes?: number;
   /**
    * Timeout used for browser tool invocations.
-   * @defaultValue `25000`
+   * @defaultValue `65000`
    */
   invokeTimeoutMs?: number;
   /**
@@ -784,7 +919,9 @@ declare class RelayBridgeServer extends EventEmitter {
   private readonly instanceId;
   private wss;
   private readonly socketByConnectionId;
+  private readonly requestOriginByConnectionId;
   private readonly pendingInvocations;
+  private readonly browserClientConnectionIds;
   private readonly relayClientConnectionIds;
   private readonly heartbeatIntervalByConnectionId;
   private readonly lastPongByConnectionId;
@@ -841,6 +978,7 @@ declare class RelayBridgeServer extends EventEmitter {
   start(): Promise<void>;
   private startUsingPortStrategy;
   private isAddressInUseError;
+  private persistSelectedPort;
   private tryAttachToExistingRelay;
   /**
    * Stops all relay resources and rejects any pending invocations.
@@ -861,22 +999,21 @@ declare class RelayBridgeServer extends EventEmitter {
   }): Promise<RelayCallToolResult>;
   private startAsServer;
   private buildServerHello;
-  private invokeToolLocally;
   /**
-   * Handles a raw WebSocket message from a connected source.
-   *
-   * Routes relay-protocol messages (`relay/*`) to the relay client handler
-   * and browser-protocol messages to the existing browser handler.
+   * `async` is load-bearing: {@link onRelayClientMessage} consumes this through
+   * `.then(onResult, onError)`, so a synchronous throw would escape the socket
+   * message handler as an uncaught exception and leave the relay client waiting
+   * for a `relay/result` that never arrives.
    */
+  private invokeToolLocally;
+  /** Handles a raw message according to the negotiated WebSocket protocol. */
   private onSocketMessage;
-  /**
-   * Sends an elicitation response back to the browser source that requested it.
-   */
-  sendElicitationResponse(connectionId: string, callId: string, result: Record<string, unknown>): void;
+  private onBrowserClientMessage;
   /**
    * Handles relay-protocol messages from relay client connections.
    */
   private onRelayClientMessage;
+  private sendRelayResult;
   /**
    * Pushes current tool state to all connected relay clients.
    */
@@ -907,10 +1044,6 @@ declare class RelayBridgeServer extends EventEmitter {
    * Builds the complete relay response payload including tools and source metadata.
    */
   private buildRelayToolsPayload;
-  /**
-   * Maps aggregated tools to the wire format used by the relay protocol.
-   */
-  private toWireTools;
   private isHostOriginAllowed;
   private sendHelloAccepted;
   private sendHelloRejected;
@@ -930,6 +1063,7 @@ declare class RelayBridgeServer extends EventEmitter {
  * Parsed CLI options for relay startup.
  */
 interface CliOptions {
+  help: boolean;
   host: string;
   port: number;
   portExplicitlySet: boolean;
@@ -938,6 +1072,7 @@ interface CliOptions {
   workspace?: string;
   relayId?: string;
   maxPayloadBytes?: number;
+  invokeTimeoutMs?: number;
 }
 /**
  * Parses supported CLI flags for relay startup.
@@ -984,12 +1119,7 @@ declare class LocalRelayMcpServer {
    */
   readonly bridge: RelayBridgeServer;
   private readonly mcpServer;
-  private readonly staticToolData;
-  private readonly dynamicToolHandles;
-  private readonly dynamicToolData;
-  private readonly dynamicToolSignature;
-  private syncing;
-  private syncRequested;
+  private readonly dynamicTools;
   private syncDebounceTimer;
   private connected;
   /**
@@ -1018,32 +1148,15 @@ declare class LocalRelayMcpServer {
    * Returns dynamic tool names currently registered in MCP.
    */
   listDynamicToolNames(): string[];
-  /**
-   * Overrides the SDK's ListTools handler to return real JSON Schema
-   * for dynamic tools instead of the empty `z.object({}).passthrough()`
-   * schema that the SDK would otherwise convert to `{ type: 'object' }`.
-   *
-   * The MCP SDK's McpServer internally runs `toJsonSchemaCompat()` on
-   * registered inputSchema values, which strips plain JSON Schema objects
-   * (non-Zod) to empty schemas. This override bypasses that conversion
-   * for dynamic (relayed) tools while preserving static tools as-is.
-   */
-  private overrideListToolsHandler;
-  private registerStaticTool;
   /**
    * Registers built-in management tools exposed by the relay.
    */
   private registerStaticTools;
-  /**
-   * Builds a concise plain-text list of available tools.
-   */
-  private buildToolSummary;
   /**
    * Opens a URL in the user's default browser using the platform open command.
    *
-   * Uses the re-serialized `URL.href` to prevent injection of shell metacharacters.
-   * On Windows, PowerShell `Start-Process` is used instead of `cmd /c start`
-   * because cmd.exe interprets `&`, `|`, and other metacharacters in URLs.
+   * Passes the re-serialized `URL.href` directly to the platform launcher.
+   * No shell or command-language string is involved.
    */
   private openInBrowser;
   /**
@@ -1055,10 +1168,6 @@ declare class LocalRelayMcpServer {
    * notifications through the stdio transport and overwhelming the agent.
    */
   private debouncedSyncDynamicTools;
-  /**
-   * Coalesces concurrent sync requests into a single serialized sync loop.
-   */
-  private syncDynamicTools;
   /**
    * Returns the current aggregated tool list, dispatching based on bridge mode.
    */
@@ -1069,9 +1178,9 @@ declare class LocalRelayMcpServer {
    */
   private buildAggregatedToolsFromRelay;
   /**
-   * Applies registry tool state to MCP dynamic registrations.
+   * Applies current aggregated tool state to MCP dynamic registrations.
    */
-  private applyDynamicTools;
+  private syncDynamicTools;
   /**
    * Registers a single dynamic tool and returns a removal handle.
    */
@@ -1089,10 +1198,6 @@ declare class LocalRelayMcpServer {
    * same tools does not trigger a needless remove+re-register cycle.
    */
   private toolSignature;
-  /**
-   * Logs tool sync errors with full detail.
-   */
-  private logSyncError;
 }
 //#endregion
 //#region src/naming.d.ts
@@ -1116,5 +1221,5 @@ declare function buildPublicToolName(options: {
   disambiguate?: boolean;
 }): string;
 //#endregion
-export { type AggregatedTool, type BrowserToRelayMessage, BrowserToRelayMessageSchema, CallToolRequestParamsSchema, type CallToolResult, CallToolResultSchema, type CliOptions, DEFAULT_TOOL_INPUT_SCHEMA, HelloRequiredError, InboundToolSchema, LocalRelayMcpServer, type LocalRelayMcpServerOptions, NormalizedToolSchema, RelayBridgeServer, type RelayBridgeServerOptions, type RelayCallToolResult, type RelayClientToServerMessage, RelayClientToServerMessageSchema, type RelayDescriptor, RelayDescriptorSchema, type RelayHelloAcceptedMessage, RelayHelloAcceptedMessageSchema, type RelayHelloRejectedMessage, RelayHelloRejectedMessageSchema, type RelayInvokeArgs, RelayInvokeArgsSchema, RelayRegistry, type RelayServerToClientMessage, RelayServerToClientMessageSchema, type RelaySourceInfo, RelaySourceInfoSchema, type RelayToBrowserMessage, RelayToBrowserMessageSchema, type RelayTool, type RelayToolAnnotations, type ResolvedInvocation, type ServerHelloMessage, ServerHelloMessageSchema, type SourceInfo, type Tool, type ToolAnnotations, ToolAnnotationsSchema, ToolSchema, buildPublicToolName, extractSanitizedDomain, normalizeInboundTool, parseCliOptions, printHelp, sanitizeName };
+export { type AggregatedTool, type BrowserToRelayMessage, BrowserToRelayMessageSchema, CallToolRequestParamsSchema, CallToolResultSchema, type CliOptions, DEFAULT_TOOL_INPUT_SCHEMA, HelloRequiredError, InboundToolSchema, LocalRelayMcpServer, type LocalRelayMcpServerOptions, NormalizedToolSchema, RelayBridgeServer, type RelayBridgeServerOptions, type RelayCallToolResult, type RelayClientToServerMessage, RelayClientToServerMessageSchema, type RelayDescriptor, RelayDescriptorSchema, type RelayHelloAcceptedMessage, RelayHelloAcceptedMessageSchema, type RelayHelloRejectedMessage, RelayHelloRejectedMessageSchema, type RelayInvokeArgs, RelayInvokeArgsSchema, RelayRegistry, type RelayServerToClientMessage, RelayServerToClientMessageSchema, type RelaySourceInfo, RelaySourceInfoSchema, type RelayToBrowserMessage, RelayToBrowserMessageSchema, type RelayTool, type RelayToolAnnotations, type ResolvedInvocation, type ServerHelloMessage, ServerHelloMessageSchema, type SourceInfo, ToolAnnotationsSchema, ToolSchema, buildPublicToolName, extractSanitizedDomain, normalizeInboundTool, parseCliOptions, printHelp, sanitizeName };
 //# sourceMappingURL=index.d.mts.map