@mcp-b/transports 1.0.2 → 1.1.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
-import { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
+import { Transport, TransportSendOptions } from "@modelcontextprotocol/sdk/shared/transport.js";
 
+//#region src/browser-types.d.ts
 /**
  * Unique identifier for an event in the event store
  */
@@ -13,217 +14,218 @@ type StreamId = string;
  * Options for connecting to an MCP server
  */
 interface MCPConnectOptions {
-    /**
-     * The event ID to resume from if reconnecting
-     */
-    resumeFrom?: EventId;
+  /**
+   * The event ID to resume from if reconnecting
+   */
+  resumeFrom?: EventId;
 }
 /**
  * Information about the MCP server
  */
 interface MCPServerInfo {
-    /**
-     * Unique identifier for this server instance
-     */
-    instanceId: string;
-    /**
-     * Whether the server maintains session state
-     */
-    stateful: boolean;
-    /**
-     * Whether the server has event storage enabled
-     */
-    hasEventStore: boolean;
+  /**
+   * Unique identifier for this server instance
+   */
+  instanceId: string;
+  /**
+   * Whether the server maintains session state
+   */
+  stateful: boolean;
+  /**
+   * Whether the server has event storage enabled
+   */
+  hasEventStore: boolean;
 }
 /**
  * Event storage interface for accessing stored events
  */
 interface MCPEventStore {
-    /**
-     * Get stored events, optionally filtered by client and/or after a specific event
-     * @param clientId - Optional client ID to filter events
-     * @param afterEventId - Optional event ID to get events after
-     * @param limit - Maximum number of events to return (default: 100)
-     */
-    getEvents(clientId?: string, afterEventId?: EventId, limit?: number): StoredEvent[];
-    /**
-     * Get the ID of the last event, optionally for a specific client
-     * @param clientId - Optional client ID to filter by
-     */
-    getLastEventId(clientId?: string): EventId | null;
-    /**
-     * Clear stored events, optionally for a specific client
-     * @param clientId - Optional client ID to clear events for
-     */
-    clearEvents(clientId?: string): void;
+  /**
+   * Get stored events, optionally filtered by client and/or after a specific event
+   * @param clientId - Optional client ID to filter events
+   * @param afterEventId - Optional event ID to get events after
+   * @param limit - Maximum number of events to return (default: 100)
+   */
+  getEvents(clientId?: string, afterEventId?: EventId, limit?: number): StoredEvent[];
+  /**
+   * Get the ID of the last event, optionally for a specific client
+   * @param clientId - Optional client ID to filter by
+   */
+  getLastEventId(clientId?: string): EventId | null;
+  /**
+   * Clear stored events, optionally for a specific client
+   * @param clientId - Optional client ID to clear events for
+   */
+  clearEvents(clientId?: string): void;
 }
 /**
  * The MCP interface exposed on window for browser environments
  */
 interface MCPBrowserInterface {
-    /**
-     * Connect a client to the MCP server
-     * @param clientId - Unique identifier for the client
-     * @param options - Optional connection options
-     * @returns MessagePort for communication or null if connection fails
-     */
-    connect(clientId: string, options?: MCPConnectOptions): MessagePort | null;
-    /**
-     * Disconnect a client from the MCP server
-     * @param clientId - The client ID to disconnect
-     */
-    disconnect(clientId: string): void;
-    /**
-     * Terminate a client's session and clean up all associated resources
-     * @param clientId - The client ID to terminate
-     */
-    terminateSession?(clientId: string): void;
-    /**
-     * Check if the MCP server is available and running
-     */
-    isServerAvailable(): boolean;
-    /**
-     * Get information about the MCP server
-     */
-    getServerInfo(): MCPServerInfo;
-    /**
-     * Event storage access (only available in stateful mode with event store)
-     */
-    events?: MCPEventStore;
+  /**
+   * Connect a client to the MCP server
+   * @param clientId - Unique identifier for the client
+   * @param options - Optional connection options
+   * @returns MessagePort for communication or null if connection fails
+   */
+  connect(clientId: string, options?: MCPConnectOptions): MessagePort | null;
+  /**
+   * Disconnect a client from the MCP server
+   * @param clientId - The client ID to disconnect
+   */
+  disconnect(clientId: string): void;
+  /**
+   * Terminate a client's session and clean up all associated resources
+   * @param clientId - The client ID to terminate
+   */
+  terminateSession?(clientId: string): void;
+  /**
+   * Check if the MCP server is available and running
+   */
+  isServerAvailable(): boolean;
+  /**
+   * Get information about the MCP server
+   */
+  getServerInfo(): MCPServerInfo;
+  /**
+   * Event storage access (only available in stateful mode with event store)
+   */
+  events?: MCPEventStore;
 }
 /**
  * Extended Window interface with MCP support
  */
 interface MCPWindow extends Window {
-    mcp?: MCPBrowserInterface;
+  mcp?: MCPBrowserInterface;
 }
 /**
  * Message types for internal MCP communication
  */
 interface MCPServerInfoMessage {
-    type: 'mcp-server-info';
-    serverInstanceId: string;
-    serverSessionId?: string;
-    hasEventStore: boolean;
-    streamId: StreamId;
+  type: 'mcp-server-info';
+  serverInstanceId: string;
+  serverSessionId?: string;
+  hasEventStore: boolean;
+  streamId: StreamId;
 }
 interface MCPEventMessage {
-    type: 'mcp-event';
-    eventId: EventId;
-    message: JSONRPCMessage;
+  type: 'mcp-event';
+  eventId: EventId;
+  message: JSONRPCMessage;
 }
 interface MCPReplayEventMessage {
-    type: 'mcp-replay-event';
-    eventId: EventId;
-    message: JSONRPCMessage;
+  type: 'mcp-replay-event';
+  eventId: EventId;
+  message: JSONRPCMessage;
 }
 /**
  * Stored event with metadata for event sourcing
  */
 interface StoredEvent {
-    eventId: EventId;
-    streamId: StreamId;
-    message: JSONRPCMessage;
-    timestamp: number;
-    clientId: string;
+  eventId: EventId;
+  streamId: StreamId;
+  message: JSONRPCMessage;
+  timestamp: number;
+  clientId: string;
 }
 declare enum NativeMessageType {
-    START = "start",
-    STARTED = "started",
-    STOP = "stop",
-    STOPPED = "stopped",
-    PING = "ping",
-    PONG = "pong",
-    ERROR = "error",
-    LIST_TOOLS = "list_tools",
-    CALL_TOOL = "call_tool",
-    TOOL_LIST_UPDATED = "tool_list_updated",
-    TOOL_LIST_UPDATED_ACK = "tool_list_updated_ack",
-    PROCESS_DATA = "process_data",
-    SERVER_STARTED = "server_started",
-    SERVER_STOPPED = "server_stopped",
-    ERROR_FROM_NATIVE_HOST = "error_from_native_host",
-    CONNECT_NATIVE = "connectNative",
-    PING_NATIVE = "ping_native",
-    DISCONNECT_NATIVE = "disconnect_native"
+  START = "start",
+  STARTED = "started",
+  STOP = "stop",
+  STOPPED = "stopped",
+  PING = "ping",
+  PONG = "pong",
+  ERROR = "error",
+  LIST_TOOLS = "list_tools",
+  CALL_TOOL = "call_tool",
+  TOOL_LIST_UPDATED = "tool_list_updated",
+  TOOL_LIST_UPDATED_ACK = "tool_list_updated_ack",
+  PROCESS_DATA = "process_data",
+  SERVER_STARTED = "server_started",
+  SERVER_STOPPED = "server_stopped",
+  ERROR_FROM_NATIVE_HOST = "error_from_native_host",
+  CONNECT_NATIVE = "connectNative",
+  PING_NATIVE = "ping_native",
+  DISCONNECT_NATIVE = "disconnect_native",
 }
 /**
  * Chrome Extension Constants
  * Centralized configuration values and magic constants
  */
 declare const NATIVE_HOST: {
-    readonly NAME: "com.chromemcp.nativehost";
-    readonly DEFAULT_PORT: 12306;
+  readonly NAME: "com.chromemcp.nativehost";
+  readonly DEFAULT_PORT: 12306;
 };
 declare const ERROR_MESSAGES: {
-    readonly NATIVE_CONNECTION_FAILED: "Failed to connect to native host";
-    readonly NATIVE_DISCONNECTED: "Native connection disconnected";
-    readonly SERVER_STATUS_LOAD_FAILED: "Failed to load server status";
-    readonly TOOL_EXECUTION_FAILED: "Tool execution failed";
-    readonly SERVER_STATUS_SAVE_FAILED: "Failed to save server status";
+  readonly NATIVE_CONNECTION_FAILED: "Failed to connect to native host";
+  readonly NATIVE_DISCONNECTED: "Native connection disconnected";
+  readonly SERVER_STATUS_LOAD_FAILED: "Failed to load server status";
+  readonly TOOL_EXECUTION_FAILED: "Tool execution failed";
+  readonly SERVER_STATUS_SAVE_FAILED: "Failed to save server status";
 };
 declare const SUCCESS_MESSAGES: {
-    readonly TOOL_EXECUTED: "Tool executed successfully";
-    readonly CONNECTION_ESTABLISHED: "Connection established";
-    readonly SERVER_STARTED: "Server started successfully";
-    readonly SERVER_STOPPED: "Server stopped successfully";
+  readonly TOOL_EXECUTED: "Tool executed successfully";
+  readonly CONNECTION_ESTABLISHED: "Connection established";
+  readonly SERVER_STARTED: "Server started successfully";
+  readonly SERVER_STOPPED: "Server stopped successfully";
 };
 declare const STORAGE_KEYS: {
-    readonly SERVER_STATUS: "serverStatus";
+  readonly SERVER_STATUS: "serverStatus";
 };
 declare const BACKGROUND_MESSAGE_TYPES: {
-    readonly GET_SERVER_STATUS: "get_server_status";
-    readonly REFRESH_SERVER_STATUS: "refresh_server_status";
-    readonly SERVER_STATUS_CHANGED: "server_status_changed";
+  readonly GET_SERVER_STATUS: "get_server_status";
+  readonly REFRESH_SERVER_STATUS: "refresh_server_status";
+  readonly SERVER_STATUS_CHANGED: "server_status_changed";
 };
 declare const HOST_NAME: "com.chromemcp.nativehost";
 /**
  * Server status management interface
  */
 interface ServerStatus {
-    isRunning: boolean;
-    port?: number;
-    lastUpdated: number;
+  isRunning: boolean;
+  port?: number;
+  lastUpdated: number;
 }
-
+//#endregion
+//#region src/ExtensionClientTransport.d.ts
 /**
  * Configuration options for ExtensionClientTransport
  */
 interface ExtensionClientTransportOptions {
-    /**
-     * The extension ID to connect to (optional for same-extension connections)
-     */
-    extensionId?: string;
-    /**
-     * Port name for the connection
-     * Default: 'mcp'
-     */
-    portName?: string;
-    /**
-     * Enable automatic reconnection on disconnect
-     * Default: true
-     */
-    autoReconnect?: boolean;
-    /**
-     * Maximum number of reconnection attempts
-     * Default: 10
-     */
-    maxReconnectAttempts?: number;
-    /**
-     * Initial reconnection delay in milliseconds
-     * Default: 1000
-     */
-    reconnectDelay?: number;
-    /**
-     * Maximum reconnection delay in milliseconds
-     * Default: 30000
-     */
-    maxReconnectDelay?: number;
-    /**
-     * Reconnection backoff multiplier
-     * Default: 1.5
-     */
-    reconnectBackoffMultiplier?: number;
+  /**
+   * The extension ID to connect to (optional for same-extension connections)
+   */
+  extensionId?: string;
+  /**
+   * Port name for the connection
+   * Default: 'mcp'
+   */
+  portName?: string;
+  /**
+   * Enable automatic reconnection on disconnect
+   * Default: true
+   */
+  autoReconnect?: boolean;
+  /**
+   * Maximum number of reconnection attempts
+   * Default: 10
+   */
+  maxReconnectAttempts?: number;
+  /**
+   * Initial reconnection delay in milliseconds
+   * Default: 1000
+   */
+  reconnectDelay?: number;
+  /**
+   * Maximum reconnection delay in milliseconds
+   * Default: 30000
+   */
+  maxReconnectDelay?: number;
+  /**
+   * Reconnection backoff multiplier
+   * Default: 1.5
+   */
+  reconnectBackoffMultiplier?: number;
 }
 /**
  * Client transport for Chrome extensions using Port-based messaging.
@@ -233,70 +235,71 @@ interface ExtensionClientTransportOptions {
  * Features automatic reconnection to handle background service worker lifecycle.
  */
 declare class ExtensionClientTransport implements Transport {
-    private _port?;
-    private _extensionId?;
-    private _portName;
-    private _messageHandler?;
-    private _disconnectHandler?;
-    private _isReconnecting;
-    private _reconnectAttempts;
-    private _reconnectTimer?;
-    private _currentReconnectDelay;
-    private _isStarted;
-    private _isClosed;
-    private _autoReconnect;
-    private _maxReconnectAttempts;
-    private _reconnectDelay;
-    private _maxReconnectDelay;
-    private _reconnectBackoffMultiplier;
-    onclose?: () => void;
-    onerror?: (error: Error) => void;
-    onmessage?: (message: JSONRPCMessage) => void;
-    constructor(options?: ExtensionClientTransportOptions);
-    /**
-     * Starts the transport by connecting to the extension port
-     */
-    start(): Promise<void>;
-    /**
-     * Connects to the extension port
-     */
-    private _connect;
-    /**
-     * Sends a message to the server
-     */
-    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
-    /**
-     * Closes the transport
-     */
-    close(): Promise<void>;
-    /**
-     * Cleans up event listeners and references
-     */
-    private _cleanup;
-    /**
-     * Schedules a reconnection attempt
-     */
-    private _scheduleReconnect;
-    /**
-     * Attempts to reconnect to the extension
-     */
-    private _attemptReconnect;
+  private _port;
+  private _extensionId;
+  private _portName;
+  private _messageHandler;
+  private _disconnectHandler;
+  private _isReconnecting;
+  private _reconnectAttempts;
+  private _reconnectTimer;
+  private _currentReconnectDelay;
+  private _isStarted;
+  private _isClosed;
+  private _autoReconnect;
+  private _maxReconnectAttempts;
+  private _reconnectDelay;
+  private _maxReconnectDelay;
+  private _reconnectBackoffMultiplier;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(options?: ExtensionClientTransportOptions);
+  /**
+   * Starts the transport by connecting to the extension port
+   */
+  start(): Promise<void>;
+  /**
+   * Connects to the extension port
+   */
+  private _connect;
+  /**
+   * Sends a message to the server
+   */
+  send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+  /**
+   * Closes the transport
+   */
+  close(): Promise<void>;
+  /**
+   * Cleans up event listeners and references
+   */
+  private _cleanup;
+  /**
+   * Schedules a reconnection attempt
+   */
+  private _scheduleReconnect;
+  /**
+   * Attempts to reconnect to the extension
+   */
+  private _attemptReconnect;
 }
-
+//#endregion
+//#region src/ExtensionServerTransport.d.ts
 /**
  * Configuration options for ExtensionServerTransport
  */
 type ExtensionServerTransportOptions = {
-    /**
-     * Enable keep-alive mechanism to prevent service worker shutdown
-     * Default: true
-     */
-    keepAlive?: boolean;
-    /**
-     * Keep-alive interval in milliseconds
-     * Default: 25000 (25 seconds, less than Chrome's 30-second timeout)
-     */
-    keepAliveInterval?: number;
+  /**
+   * Enable keep-alive mechanism to prevent service worker shutdown
+   * Default: true
+   */
+  keepAlive?: boolean;
+  /**
+   * Keep-alive interval in milliseconds
+   * Default: 25000 (25 seconds, less than Chrome's 30-second timeout)
+   */
+  keepAliveInterval?: number;
 };
 /**
  * Server transport for Chrome extensions using Port-based messaging.
@@ -308,91 +311,236 @@ type ExtensionServerTransportOptions = {
  * - Graceful connection state management
  */
 declare class ExtensionServerTransport implements Transport {
-    private _port;
-    private _started;
-    private _messageHandler?;
-    private _disconnectHandler?;
-    private _keepAliveTimer?;
-    private _options;
-    private _connectionInfo;
-    onclose?: () => void;
-    onerror?: (error: Error) => void;
-    onmessage?: (message: JSONRPCMessage) => void;
-    constructor(port: chrome.runtime.Port, options?: ExtensionServerTransportOptions);
-    /**
-     * Starts the transport and begins handling messages
-     */
-    start(): Promise<void>;
-    /**
-     * Sends a message to the client
-     */
-    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
-    /**
-     * Closes the transport
-     */
-    close(): Promise<void>;
-    /**
-     * Cleans up event listeners and references
-     */
-    private _cleanup;
-    /**
-     * Starts the keep-alive mechanism
-     */
-    private _startKeepAlive;
-    /**
-     * Stops the keep-alive mechanism
-     */
-    private _stopKeepAlive;
-    /**
-     * Gets connection information
-     */
-    getConnectionInfo(): {
-        uptime: number;
-        isConnected: boolean;
-        connectedAt: number;
-        lastMessageAt: number;
-        messageCount: number;
-    };
+  private _port;
+  private _started;
+  private _messageHandler;
+  private _disconnectHandler;
+  private _keepAliveTimer;
+  private _options;
+  private _connectionInfo;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(port: chrome.runtime.Port, options?: ExtensionServerTransportOptions);
+  /**
+   * Starts the transport and begins handling messages
+   */
+  start(): Promise<void>;
+  /**
+   * Sends a message to the client
+   */
+  send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+  /**
+   * Closes the transport
+   */
+  close(): Promise<void>;
+  /**
+   * Cleans up event listeners and references
+   */
+  private _cleanup;
+  /**
+   * Starts the keep-alive mechanism
+   */
+  private _startKeepAlive;
+  /**
+   * Stops the keep-alive mechanism
+   */
+  private _stopKeepAlive;
+  /**
+   * Gets connection information
+   */
+  getConnectionInfo(): {
+    uptime: number;
+    isConnected: boolean;
+    connectedAt: number;
+    lastMessageAt: number;
+    messageCount: number;
+  };
+}
+//#endregion
+//#region src/IframeChildTransport.d.ts
+interface IframeChildTransportOptions {
+  /** Whitelist of parent origins allowed to connect (for security) */
+  allowedOrigins: string[];
+  /** Optional channel name (default: 'mcp-iframe') */
+  channelId?: string;
+  /** Retry interval for broadcasting ready signal in milliseconds (default: 250) */
+  serverReadyRetryMs?: number;
 }
-
+/**
+ * IframeChildTransport - Server transport for iframe
+ *
+ * Use this transport when an iframe wants to expose an MCP server to its parent page.
+ * Supports cross-origin communication.
+ *
+ * @example
+ * ```typescript
+ * const transport = new IframeChildTransport({
+ *   allowedOrigins: ['https://parent-app.com'],
+ * });
+ *
+ * const server = new Server({ name: 'IframeApp', version: '1.0.0' });
+ * await server.connect(transport);
+ * ```
+ */
+declare class IframeChildTransport implements Transport {
+  private _started;
+  private _allowedOrigins;
+  private _channelId;
+  private _messageHandler?;
+  private _clientOrigin?;
+  private _serverReadyTimeout;
+  private readonly _serverReadyRetryMs;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(options: IframeChildTransportOptions);
+  start(): Promise<void>;
+  private broadcastServerReady;
+  private scheduleServerReadyRetry;
+  private clearServerReadyRetry;
+  send(message: JSONRPCMessage): Promise<void>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/IframeParentTransport.d.ts
+interface IframeParentTransportOptions {
+  /** Reference to the iframe element */
+  iframe: HTMLIFrameElement;
+  /** Expected origin of the iframe (for security) */
+  targetOrigin: string;
+  /** Optional channel name (default: 'mcp-iframe') */
+  channelId?: string;
+  /** Retry interval for ready handshake in milliseconds (default: 250) */
+  checkReadyRetryMs?: number;
+}
+/**
+ * IframeParentTransport - Client transport for parent page
+ *
+ * Use this transport when the parent page wants to connect to an MCP server
+ * running inside an iframe. Supports cross-origin communication.
+ *
+ * @example
+ * ```typescript
+ * const iframe = document.querySelector('iframe');
+ * const transport = new IframeParentTransport({
+ *   iframe,
+ *   targetOrigin: 'https://iframe-app.com',
+ * });
+ *
+ * const client = new Client({ name: 'Parent', version: '1.0.0' });
+ * await client.connect(transport);
+ * ```
+ */
+declare class IframeParentTransport implements Transport {
+  private _started;
+  private _iframe;
+  private _targetOrigin;
+  private _channelId;
+  private _messageHandler?;
+  private _checkReadyTimeout;
+  private readonly _checkReadyRetryMs;
+  readonly serverReadyPromise: Promise<void>;
+  private _serverReadyResolve;
+  private _serverReadyReject;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(options: IframeParentTransportOptions);
+  start(): Promise<void>;
+  private sendCheckReady;
+  private scheduleCheckReadyRetry;
+  private clearCheckReadyRetry;
+  send(message: JSONRPCMessage): Promise<void>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/TabClientTransport.d.ts
+interface TabClientTransportOptions {
+  /** Origin expected from the server window (for security) */
+  targetOrigin: string;
+  /** Optional channel name (default: 'mcp-default') */
+  channelId?: string;
+}
+declare class TabClientTransport implements Transport {
+  private _started;
+  private _targetOrigin;
+  private _channelId;
+  private _messageHandler?;
+  readonly serverReadyPromise: Promise<void>;
+  private _serverReadyResolve;
+  private _serverReadyReject;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(options: TabClientTransportOptions);
+  start(): Promise<void>;
+  private sendCheckReady;
+  send(message: JSONRPCMessage): Promise<void>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/TabServerTransport.d.ts
+interface TabServerTransportOptions {
+  /** Whitelist of origins allowed to connect (for security) */
+  allowedOrigins: string[];
+  /** Optional channel name (default: 'mcp-default') */
+  channelId?: string;
+}
+declare class TabServerTransport implements Transport {
+  private _started;
+  private _allowedOrigins;
+  private _channelId;
+  private _messageHandler?;
+  private _clientOrigin?;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(options: TabServerTransportOptions);
+  start(): Promise<void>;
+  send(message: JSONRPCMessage): Promise<void>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/UserScriptClientTransport.d.ts
 /**
  * Configuration options for UserScriptClientTransport
  */
 interface UserScriptClientTransportOptions {
-    /**
-     * The extension ID to connect to (optional for same-extension connections)
-     */
-    extensionId?: string;
-    /**
-     * Port name for the connection
-     * Default: 'mcp'
-     */
-    portName?: string;
-    /**
-     * Enable automatic reconnection on disconnect
-     * Default: true
-     */
-    autoReconnect?: boolean;
-    /**
-     * Maximum number of reconnection attempts
-     * Default: 10
-     */
-    maxReconnectAttempts?: number;
-    /**
-     * Initial reconnection delay in milliseconds
-     * Default: 1000
-     */
-    reconnectDelay?: number;
-    /**
-     * Maximum reconnection delay in milliseconds
-     * Default: 30000
-     */
-    maxReconnectDelay?: number;
-    /**
-     * Reconnection backoff multiplier
-     * Default: 1.5
-     */
-    reconnectBackoffMultiplier?: number;
+  /**
+   * The extension ID to connect to (optional for same-extension connections)
+   */
+  extensionId?: string;
+  /**
+   * Port name for the connection
+   * Default: 'mcp'
+   */
+  portName?: string;
+  /**
+   * Enable automatic reconnection on disconnect
+   * Default: true
+   */
+  autoReconnect?: boolean;
+  /**
+   * Maximum number of reconnection attempts
+   * Default: 10
+   */
+  maxReconnectAttempts?: number;
+  /**
+   * Initial reconnection delay in milliseconds
+   * Default: 1000
+   */
+  reconnectDelay?: number;
+  /**
+   * Maximum reconnection delay in milliseconds
+   * Default: 30000
+   */
+  maxReconnectDelay?: number;
+  /**
+   * Reconnection backoff multiplier
+   * Default: 1.5
+   */
+  reconnectBackoffMultiplier?: number;
 }
 /**
  * Client transport for Chrome MV3 User Scripts using Port-based messaging.
@@ -403,70 +551,71 @@ interface UserScriptClientTransportOptions {
  * Features automatic reconnection to handle background service worker lifecycle.
  */
 declare class UserScriptClientTransport implements Transport {
-    private _port?;
-    private _extensionId?;
-    private _portName;
-    private _messageHandler?;
-    private _disconnectHandler?;
-    private _isReconnecting;
-    private _reconnectAttempts;
-    private _reconnectTimer?;
-    private _currentReconnectDelay;
-    private _isStarted;
-    private _isClosed;
-    private _autoReconnect;
-    private _maxReconnectAttempts;
-    private _reconnectDelay;
-    private _maxReconnectDelay;
-    private _reconnectBackoffMultiplier;
-    onclose?: () => void;
-    onerror?: (error: Error) => void;
-    onmessage?: (message: JSONRPCMessage) => void;
-    constructor(options?: UserScriptClientTransportOptions);
-    /**
-     * Starts the transport by connecting to the extension port
-     */
-    start(): Promise<void>;
-    /**
-     * Connects to the extension port
-     */
-    private _connect;
-    /**
-     * Sends a message to the server
-     */
-    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
-    /**
-     * Closes the transport
-     */
-    close(): Promise<void>;
-    /**
-     * Cleans up event listeners and references
-     */
-    private _cleanup;
-    /**
-     * Schedules a reconnection attempt
-     */
-    private _scheduleReconnect;
-    /**
-     * Attempts to reconnect to the extension
-     */
-    private _attemptReconnect;
+  private _port;
+  private _extensionId;
+  private _portName;
+  private _messageHandler;
+  private _disconnectHandler;
+  private _isReconnecting;
+  private _reconnectAttempts;
+  private _reconnectTimer;
+  private _currentReconnectDelay;
+  private _isStarted;
+  private _isClosed;
+  private _autoReconnect;
+  private _maxReconnectAttempts;
+  private _reconnectDelay;
+  private _maxReconnectDelay;
+  private _reconnectBackoffMultiplier;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(options?: UserScriptClientTransportOptions);
+  /**
+   * Starts the transport by connecting to the extension port
+   */
+  start(): Promise<void>;
+  /**
+   * Connects to the extension port
+   */
+  private _connect;
+  /**
+   * Sends a message to the server
+   */
+  send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+  /**
+   * Closes the transport
+   */
+  close(): Promise<void>;
+  /**
+   * Cleans up event listeners and references
+   */
+  private _cleanup;
+  /**
+   * Schedules a reconnection attempt
+   */
+  private _scheduleReconnect;
+  /**
+   * Attempts to reconnect to the extension
+   */
+  private _attemptReconnect;
 }
-
+//#endregion
+//#region src/UserScriptServerTransport.d.ts
 /**
  * Configuration options for UserScriptServerTransport
  */
 type UserScriptServerTransportOptions = {
-    /**
-     * Enable keep-alive mechanism to prevent service worker shutdown
-     * Default: true
-     */
-    keepAlive?: boolean;
-    /**
-     * Keep-alive interval in milliseconds
-     * Default: 25000 (25 seconds, less than Chrome's 30-second timeout)
-     */
-    keepAliveInterval?: number;
+  /**
+   * Enable keep-alive mechanism to prevent service worker shutdown
+   * Default: true
+   */
+  keepAlive?: boolean;
+  /**
+   * Keep-alive interval in milliseconds
+   * Default: 25000 (25 seconds, less than Chrome's 30-second timeout)
+   */
+  keepAliveInterval?: number;
 };
 /**
  * Server transport for Chrome MV3 User Scripts using Port-based messaging.
@@ -480,92 +629,52 @@ type UserScriptServerTransportOptions = {
  * - Graceful connection state management
  */
 declare class UserScriptServerTransport implements Transport {
-    private _port;
-    private _started;
-    private _messageHandler?;
-    private _disconnectHandler?;
-    private _keepAliveTimer?;
-    private _options;
-    private _connectionInfo;
-    onclose?: () => void;
-    onerror?: (error: Error) => void;
-    onmessage?: (message: JSONRPCMessage) => void;
-    constructor(port: chrome.runtime.Port, options?: UserScriptServerTransportOptions);
-    /**
-     * Starts the transport and begins handling messages
-     */
-    start(): Promise<void>;
-    /**
-     * Sends a message to the client
-     */
-    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
-    /**
-     * Closes the transport
-     */
-    close(): Promise<void>;
-    /**
-     * Cleans up event listeners and references
-     */
-    private _cleanup;
-    /**
-     * Starts the keep-alive mechanism
-     */
-    private _startKeepAlive;
-    /**
-     * Stops the keep-alive mechanism
-     */
-    private _stopKeepAlive;
-    /**
-     * Gets connection information
-     */
-    getConnectionInfo(): {
-        uptime: number;
-        isConnected: boolean;
-        connectedAt: number;
-        lastMessageAt: number;
-        messageCount: number;
-    };
-}
-
-interface TabClientTransportOptions {
-    targetOrigin: string;
-    channelId?: string;
-}
-declare class TabClientTransport implements Transport {
-    private _started;
-    private _targetOrigin;
-    private _channelId;
-    private _messageHandler?;
-    readonly serverReadyPromise: Promise<void>;
-    private _serverReadyResolve;
-    private _serverReadyReject;
-    onclose?: () => void;
-    onerror?: (error: Error) => void;
-    onmessage?: (message: JSONRPCMessage) => void;
-    constructor(options: TabClientTransportOptions);
-    start(): Promise<void>;
-    private sendCheckReady;
-    send(message: JSONRPCMessage): Promise<void>;
-    close(): Promise<void>;
+  private _port;
+  private _started;
+  private _messageHandler;
+  private _disconnectHandler;
+  private _keepAliveTimer;
+  private _options;
+  private _connectionInfo;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(port: chrome.runtime.Port, options?: UserScriptServerTransportOptions);
+  /**
+   * Starts the transport and begins handling messages
+   */
+  start(): Promise<void>;
+  /**
+   * Sends a message to the client
+   */
+  send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+  /**
+   * Closes the transport
+   */
+  close(): Promise<void>;
+  /**
+   * Cleans up event listeners and references
+   */
+  private _cleanup;
+  /**
+   * Starts the keep-alive mechanism
+   */
+  private _startKeepAlive;
+  /**
+   * Stops the keep-alive mechanism
+   */
+  private _stopKeepAlive;
+  /**
+   * Gets connection information
+   */
+  getConnectionInfo(): {
+    uptime: number;
+    isConnected: boolean;
+    connectedAt: number;
+    lastMessageAt: number;
+    messageCount: number;
+  };
 }
-
-interface TabServerTransportOptions {
-    allowedOrigins: string[];
-    channelId?: string;
-}
-declare class TabServerTransport implements Transport {
-    private _started;
-    private _allowedOrigins;
-    private _channelId;
-    private _messageHandler?;
-    private _clientOrigin?;
-    onclose?: () => void;
-    onerror?: (error: Error) => void;
-    onmessage?: (message: JSONRPCMessage) => void;
-    constructor(options: TabServerTransportOptions);
-    start(): Promise<void>;
-    send(message: JSONRPCMessage): Promise<void>;
-    close(): Promise<void>;
-}
-
-export { BACKGROUND_MESSAGE_TYPES, ERROR_MESSAGES, type EventId, ExtensionClientTransport, type ExtensionClientTransportOptions, ExtensionServerTransport, type ExtensionServerTransportOptions, HOST_NAME, type MCPBrowserInterface, type MCPConnectOptions, type MCPEventMessage, type MCPEventStore, type MCPReplayEventMessage, type MCPServerInfo, type MCPServerInfoMessage, type MCPWindow, NATIVE_HOST, NativeMessageType, STORAGE_KEYS, SUCCESS_MESSAGES, type ServerStatus, type StoredEvent, type StreamId, TabClientTransport, type TabClientTransportOptions, TabServerTransport, type TabServerTransportOptions, UserScriptClientTransport, type UserScriptClientTransportOptions, UserScriptServerTransport, type UserScriptServerTransportOptions };
+//#endregion
+export { BACKGROUND_MESSAGE_TYPES, ERROR_MESSAGES, EventId, ExtensionClientTransport, ExtensionClientTransportOptions, ExtensionServerTransport, ExtensionServerTransportOptions, HOST_NAME, IframeChildTransport, IframeChildTransportOptions, IframeParentTransport, IframeParentTransportOptions, MCPBrowserInterface, MCPConnectOptions, MCPEventMessage, MCPEventStore, MCPReplayEventMessage, MCPServerInfo, MCPServerInfoMessage, MCPWindow, NATIVE_HOST, NativeMessageType, STORAGE_KEYS, SUCCESS_MESSAGES, ServerStatus, StoredEvent, StreamId, TabClientTransport, TabClientTransportOptions, TabServerTransport, TabServerTransportOptions, UserScriptClientTransport, UserScriptClientTransportOptions, UserScriptServerTransport, UserScriptServerTransportOptions };
+//# sourceMappingURL=index.d.ts.map