@better-agent/core 0.1.0-beta.1

package/dist/mcp/tool/mcp-client.d.mts

@@ -0,0 +1,71 @@
+import { MCPClientError } from "../error/mcp-client-error.mjs";
+import { MCPTransport, MCPTransportConfig } from "./mcp-transport.mjs";
+import { ClientCapabilities, ListPromptsResult, ListResourceTemplatesResult, ListResourcesResult, ListToolsResult, MCPCallToolParams, MCPCallToolResult, MCPGetPromptParams, MCPGetPromptResult, MCPReadResourceParams, MCPReadResourceResult, PaginatedRequest, RequestOptions } from "./types.mjs";
+
+//#region src/mcp/tool/mcp-client.d.ts
+/**
+ * MCP client configuration.
+ */
+interface MCPClientConfig {
+  /** Transport config or a custom transport instance. */
+  transport: MCPTransportConfig | MCPTransport;
+  /** Optional client name. Defaults to `"better-agent-mcp-client"`. */
+  name?: string;
+  /** Optional client version. Defaults to `"1.0.0"`. */
+  version?: string;
+  /** Optional callback for uncaught errors. */
+  onUncaughtError?: (error: MCPClientError) => void;
+  /** Optional client capabilities to advertise. */
+  capabilities?: ClientCapabilities;
+}
+/**
+ * MCP client interface.
+ */
+interface MCPClient {
+  /** Lists available tools from the server. */
+  listTools(options?: {
+    params?: PaginatedRequest;
+    options?: RequestOptions;
+  }): Promise<ListToolsResult>;
+  /** Calls a tool on the server. */
+  callTool(params: MCPCallToolParams, options?: RequestOptions): Promise<MCPCallToolResult>;
+  /** Lists available resources. */
+  listResources(options?: {
+    params?: PaginatedRequest;
+    options?: RequestOptions;
+  }): Promise<ListResourcesResult>;
+  /** Lists resource templates. */
+  listResourceTemplates(options?: {
+    options?: RequestOptions;
+  }): Promise<ListResourceTemplatesResult>;
+  /** Reads a resource. */
+  readResource(params: MCPReadResourceParams, options?: RequestOptions): Promise<MCPReadResourceResult>;
+  /** Lists available prompts. */
+  listPrompts(options?: {
+    params?: PaginatedRequest;
+    options?: RequestOptions;
+  }): Promise<ListPromptsResult>;
+  /** Gets a prompt. */
+  getPrompt(params: MCPGetPromptParams, options?: RequestOptions): Promise<MCPGetPromptResult>;
+  /** Closes the connection. */
+  close(): Promise<void>;
+}
+/**
+ * Creates and initializes an MCP client.
+ *
+ * @param config MCP client configuration.
+ * @returns An initialized MCP client.
+ *
+ * @example
+ * ```ts
+ * const client = await createMCPClient({
+ *   transport: { type: "http", url: "http://localhost:3000/mcp" },
+ * });
+ *
+ * const tools = await client.listTools();
+ * ```
+ */
+declare function createMCPClient(config: MCPClientConfig): Promise<MCPClient>;
+//#endregion
+export { MCPClient, MCPClientConfig, createMCPClient };
+//# sourceMappingURL=mcp-client.d.mts.map

package/dist/mcp/tool/mcp-client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.mts","names":[],"sources":["../../../src/mcp/tool/mcp-client.ts"],"mappings":";;;;;;;AAmCA;UAAiB,eAAA;;EAEb,SAAA,EAAW,kBAAA,GAAqB,YAAA;EAAA;EAGhC,IAAA;EASe;EANf,OAAA;EAMiC;EAHjC,eAAA,IAAmB,KAAA,EAAO,cAAA;EATf;EAYX,YAAA,GAAe,kBAAA;AAAA;;;;UAMF,SAAA;EANb;EAQA,SAAA,CAAU,OAAA;IACN,MAAA,GAAS,gBAAA;IACT,OAAA,GAAU,cAAA;EAAA,IACV,OAAA,CAAQ,eAAA;EALU;EAQtB,QAAA,CAAS,MAAA,EAAQ,iBAAA,EAAmB,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,iBAAA;EAL1D;EAQb,aAAA,CAAc,OAAA;IACV,MAAA,GAAS,gBAAA;IACT,OAAA,GAAU,cAAA;EAAA,IACV,OAAA,CAAQ,mBAAA;EANkC;EAS9C,qBAAA,CAAsB,OAAA;IAClB,OAAA,GAAU,cAAA;EAAA,IACV,OAAA,CAAQ,2BAAA;EANE;EASd,YAAA,CACI,MAAA,EAAQ,qBAAA,EACR,OAAA,GAAU,cAAA,GACX,OAAA,CAAQ,qBAAA;EAXP;EAcJ,WAAA,CAAY,OAAA;IACR,MAAA,GAAS,gBAAA;IACT,OAAA,GAAU,cAAA;EAAA,IACV,OAAA,CAAQ,iBAAA;EAPE;EAUd,SAAA,CAAU,MAAA,EAAQ,kBAAA,EAAoB,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,kBAAA;EATtE;EAYH,KAAA,IAAS,OAAA;AAAA;;;;;;;;;;;;;;;;iBAkBS,eAAA,CAAgB,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,SAAA"}

package/dist/mcp/tool/mcp-client.mjs

@@ -0,0 +1,304 @@
+import { MCPClientError } from "../error/mcp-client-error.mjs";
+import { isJSONRPCError, isJSONRPCResponse } from "./json-rpc-message.mjs";
+import { LATEST_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS } from "./types.mjs";
+import { HttpMCPTransport } from "./mcp-http-transport.mjs";
+import { isCustomMCPTransport } from "./mcp-transport.mjs";
+
+//#region src/mcp/tool/mcp-client.ts
+/**
+* Creates and initializes an MCP client.
+*
+* @param config MCP client configuration.
+* @returns An initialized MCP client.
+*
+* @example
+* ```ts
+* const client = await createMCPClient({
+*   transport: { type: "http", url: "http://localhost:3000/mcp" },
+* });
+*
+* const tools = await client.listTools();
+* ```
+*/
+async function createMCPClient(config) {
+	const client = new DefaultMCPClient(config);
+	await client.init();
+	return client;
+}
+/**
+* Default MCP client implementation.
+*/
+var DefaultMCPClient = class {
+	transport;
+	onUncaughtError;
+	clientInfo;
+	clientCapabilities;
+	requestMessageId = 0;
+	responseHandlers = /* @__PURE__ */ new Map();
+	serverCapabilities = {};
+	isClosed = true;
+	constructor({ transport: transportConfig, name = "better-agent-mcp-client", version = "1.0.0", onUncaughtError, capabilities }) {
+		this.onUncaughtError = onUncaughtError;
+		this.clientCapabilities = capabilities ?? {};
+		if (isCustomMCPTransport(transportConfig)) this.transport = transportConfig;
+		else this.transport = this.createTransport(transportConfig);
+		this.transport.onclose = () => this.onClose();
+		this.transport.onerror = (error) => this.onError(error);
+		this.transport.onmessage = (message) => {
+			if ("id" in message) if ("error" in message || "result" in message) this.onResponse(message);
+			else this.onError(/* @__PURE__ */ new Error("Server requests not supported"));
+		};
+		this.clientInfo = {
+			name,
+			version
+		};
+	}
+	/**
+	* Creates a transport from config.
+	*/
+	createTransport(config) {
+		switch (config.type) {
+			case "http": return new HttpMCPTransport({
+				url: config.url,
+				headers: config.headers,
+				redirect: config.redirect,
+				sessionId: config.sessionId,
+				advanced: config.advanced
+			});
+			case "sse": return new HttpMCPTransport({
+				url: config.url,
+				headers: config.headers,
+				redirect: config.redirect,
+				sessionId: void 0,
+				advanced: config.advanced
+			});
+			default: throw new Error(`Unsupported transport type: ${config.type}`);
+		}
+	}
+	/**
+	* Initializes the client and completes the MCP handshake.
+	*/
+	async init() {
+		try {
+			await this.transport.start();
+			this.isClosed = false;
+			const result = await this.request({
+				method: "initialize",
+				params: {
+					protocolVersion: LATEST_PROTOCOL_VERSION,
+					capabilities: this.clientCapabilities,
+					clientInfo: this.clientInfo
+				},
+				options: void 0
+			});
+			if (!SUPPORTED_PROTOCOL_VERSIONS.includes(result.protocolVersion)) throw new Error(`Server's protocol version is not supported: ${result.protocolVersion}`);
+			this.serverCapabilities = result.capabilities;
+			await this.notification({ method: "notifications/initialized" });
+			return this;
+		} catch (error) {
+			await this.close();
+			throw error;
+		}
+	}
+	/**
+	* Closes the connection and cleans up.
+	*/
+	async close() {
+		if (this.isClosed) return;
+		await this.transport.close();
+		this.onClose();
+	}
+	/**
+	* Checks whether the server supports a capability.
+	*/
+	assertCapability(method) {
+		switch (method) {
+			case "initialize": break;
+			case "tools/list":
+			case "tools/call":
+				if (!this.serverCapabilities.tools) throw new Error("Server does not support tools");
+				break;
+			case "resources/list":
+			case "resources/read":
+			case "resources/templates/list":
+				if (!this.serverCapabilities.resources) throw new Error("Server does not support resources");
+				break;
+			case "prompts/list":
+			case "prompts/get":
+				if (!this.serverCapabilities.prompts) throw new Error("Server does not support prompts");
+				break;
+			default: throw new Error(`Unsupported method: ${method}`);
+		}
+	}
+	/**
+	* Send a JSON-RPC request and wait for response.
+	*/
+	async request({ method, params, options }) {
+		return new Promise((resolve, reject) => {
+			if (this.isClosed) return reject(/* @__PURE__ */ new Error("Attempted to send a request from a closed client"));
+			this.assertCapability(method);
+			const signal = options?.signal;
+			signal?.throwIfAborted();
+			const messageId = this.requestMessageId++;
+			const jsonrpcRequest = {
+				jsonrpc: "2.0",
+				id: messageId,
+				method,
+				params
+			};
+			const cleanup = () => {
+				this.responseHandlers.delete(messageId);
+			};
+			let timeoutId;
+			if (options?.timeout !== void 0) timeoutId = setTimeout(() => {
+				cleanup();
+				reject(/* @__PURE__ */ new Error(`Request timed out after ${options.timeout}ms`));
+			}, options.timeout);
+			const cleanupWithTimeout = () => {
+				cleanup();
+				if (timeoutId !== void 0) clearTimeout(timeoutId);
+			};
+			const abortHandler = () => {
+				cleanupWithTimeout();
+				reject(/* @__PURE__ */ new Error(`Request was aborted: ${signal?.reason || "Unknown reason"}`));
+			};
+			signal?.addEventListener("abort", abortHandler);
+			this.responseHandlers.set(messageId, (response) => {
+				signal?.removeEventListener("abort", abortHandler);
+				if (signal?.aborted) {
+					cleanupWithTimeout();
+					return reject(/* @__PURE__ */ new Error(`Request was aborted: ${signal.reason}`));
+				}
+				if (response instanceof MCPClientError) {
+					cleanupWithTimeout();
+					return reject(response);
+				}
+				if (isJSONRPCError(response)) {
+					cleanupWithTimeout();
+					const error = new Error(String(response.error.message));
+					Object.assign(error, { jsonRpcCode: response.error.code });
+					return reject(error);
+				}
+				if (!isJSONRPCResponse(response)) {
+					cleanupWithTimeout();
+					return reject(new MCPClientError({ message: "Received invalid JSON-RPC response shape." }));
+				}
+				cleanupWithTimeout();
+				resolve(response.result);
+			});
+			this.transport.send(jsonrpcRequest).catch((error) => {
+				signal?.removeEventListener("abort", abortHandler);
+				cleanupWithTimeout();
+				reject(error);
+			});
+		});
+	}
+	/**
+	* Send a JSON-RPC notification (no response expected).
+	*/
+	async notification({ method, params }) {
+		if (this.isClosed) throw new Error("Attempted to send a notification from a closed client");
+		const jsonrpcNotification = {
+			jsonrpc: "2.0",
+			method,
+			params
+		};
+		await this.transport.send(jsonrpcNotification);
+	}
+	/**
+	* Handle transport closure.
+	*/
+	onClose() {
+		if (this.isClosed) return;
+		this.isClosed = true;
+		const error = /* @__PURE__ */ new Error("Connection closed");
+		for (const handler of this.responseHandlers.values()) handler({
+			jsonrpc: "2.0",
+			id: -1,
+			error: {
+				code: -32e3,
+				message: error.message
+			}
+		});
+		this.responseHandlers.clear();
+		this.onUncaughtError?.(error);
+	}
+	/**
+	* Handle transport errors.
+	*/
+	onError(error) {
+		this.onUncaughtError?.(error);
+	}
+	/**
+	* Handle incoming JSON-RPC responses.
+	*/
+	onResponse(response) {
+		const messageId = Number(response.id);
+		const handler = this.responseHandlers.get(messageId);
+		if (handler === void 0) {
+			this.onError(new MCPClientError({
+				message: `Protocol error: Received a response for an unknown message ID: ${JSON.stringify(response)}`,
+				context: {
+					messageId,
+					response
+				}
+			}));
+			return;
+		}
+		this.responseHandlers.delete(messageId);
+		handler(response);
+	}
+	async listTools({ params, options } = {}) {
+		return this.request({
+			method: "tools/list",
+			params,
+			options
+		});
+	}
+	async callTool(params, options) {
+		return this.request({
+			method: "tools/call",
+			params,
+			options
+		});
+	}
+	async listResources({ params, options } = {}) {
+		return this.request({
+			method: "resources/list",
+			params,
+			options
+		});
+	}
+	async listResourceTemplates({ options } = {}) {
+		return this.request({
+			method: "resources/templates/list",
+			params: void 0,
+			options
+		});
+	}
+	async readResource(params, options) {
+		return this.request({
+			method: "resources/read",
+			params,
+			options
+		});
+	}
+	async listPrompts({ params, options } = {}) {
+		return this.request({
+			method: "prompts/list",
+			params,
+			options
+		});
+	}
+	async getPrompt(params, options) {
+		return this.request({
+			method: "prompts/get",
+			params,
+			options
+		});
+	}
+};
+
+//#endregion
+export { createMCPClient };
+//# sourceMappingURL=mcp-client.mjs.map

package/dist/mcp/tool/mcp-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.mjs","names":[],"sources":["../../../src/mcp/tool/mcp-client.ts"],"sourcesContent":["import { MCPClientError } from \"../error/mcp-client-error\";\nimport type {\n    JSONRPCError,\n    JSONRPCMessage,\n    JSONRPCRequest,\n    JSONRPCResponse,\n} from \"./json-rpc-message\";\nimport { isJSONRPCError, isJSONRPCResponse } from \"./json-rpc-message\";\nimport { HttpMCPTransport } from \"./mcp-http-transport\";\nimport type { MCPTransport, MCPTransportConfig } from \"./mcp-transport\";\nimport { isCustomMCPTransport } from \"./mcp-transport\";\nimport type {\n    ClientCapabilities,\n    InitializeParams,\n    InitializeResult,\n    ListPromptsResult,\n    ListResourceTemplatesResult,\n    ListResourcesResult,\n    ListToolsResult,\n    MCPCallToolParams,\n    MCPCallToolResult,\n    MCPGetPromptParams,\n    MCPGetPromptResult,\n    MCPImplementationInfo,\n    MCPReadResourceParams,\n    MCPReadResourceResult,\n    PaginatedRequest,\n    RequestOptions,\n    ServerCapabilities,\n} from \"./types\";\nimport { LATEST_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS } from \"./types\";\n\n/**\n * MCP client configuration.\n */\nexport interface MCPClientConfig {\n    /** Transport config or a custom transport instance. */\n    transport: MCPTransportConfig | MCPTransport;\n\n    /** Optional client name. Defaults to `\"better-agent-mcp-client\"`. */\n    name?: string;\n\n    /** Optional client version. Defaults to `\"1.0.0\"`. */\n    version?: string;\n\n    /** Optional callback for uncaught errors. */\n    onUncaughtError?: (error: MCPClientError) => void;\n\n    /** Optional client capabilities to advertise. */\n    capabilities?: ClientCapabilities;\n}\n\n/**\n * MCP client interface.\n */\nexport interface MCPClient {\n    /** Lists available tools from the server. */\n    listTools(options?: {\n        params?: PaginatedRequest;\n        options?: RequestOptions;\n    }): Promise<ListToolsResult>;\n\n    /** Calls a tool on the server. */\n    callTool(params: MCPCallToolParams, options?: RequestOptions): Promise<MCPCallToolResult>;\n\n    /** Lists available resources. */\n    listResources(options?: {\n        params?: PaginatedRequest;\n        options?: RequestOptions;\n    }): Promise<ListResourcesResult>;\n\n    /** Lists resource templates. */\n    listResourceTemplates(options?: {\n        options?: RequestOptions;\n    }): Promise<ListResourceTemplatesResult>;\n\n    /** Reads a resource. */\n    readResource(\n        params: MCPReadResourceParams,\n        options?: RequestOptions,\n    ): Promise<MCPReadResourceResult>;\n\n    /** Lists available prompts. */\n    listPrompts(options?: {\n        params?: PaginatedRequest;\n        options?: RequestOptions;\n    }): Promise<ListPromptsResult>;\n\n    /** Gets a prompt. */\n    getPrompt(params: MCPGetPromptParams, options?: RequestOptions): Promise<MCPGetPromptResult>;\n\n    /** Closes the connection. */\n    close(): Promise<void>;\n}\n\n/**\n * Creates and initializes an MCP client.\n *\n * @param config MCP client configuration.\n * @returns An initialized MCP client.\n *\n * @example\n * ```ts\n * const client = await createMCPClient({\n *   transport: { type: \"http\", url: \"http://localhost:3000/mcp\" },\n * });\n *\n * const tools = await client.listTools();\n * ```\n */\nexport async function createMCPClient(config: MCPClientConfig): Promise<MCPClient> {\n    const client = new DefaultMCPClient(config);\n    await client.init();\n    return client;\n}\n\n/**\n * Default MCP client implementation.\n */\nclass DefaultMCPClient implements MCPClient {\n    private transport: MCPTransport;\n    private onUncaughtError: ((error: MCPClientError) => void) | undefined;\n    private clientInfo: MCPImplementationInfo;\n    private clientCapabilities: ClientCapabilities;\n    private requestMessageId = 0;\n    private responseHandlers: Map<\n        number,\n        (response: JSONRPCResponse | JSONRPCError | MCPClientError) => void\n    > = new Map();\n    private serverCapabilities: ServerCapabilities = {};\n    private isClosed = true;\n\n    constructor({\n        transport: transportConfig,\n        name = \"better-agent-mcp-client\",\n        version = \"1.0.0\",\n        onUncaughtError,\n        capabilities,\n    }: MCPClientConfig) {\n        this.onUncaughtError = onUncaughtError;\n        this.clientCapabilities = capabilities ?? {};\n\n        // Reuse a custom transport when one is provided.\n        if (isCustomMCPTransport(transportConfig)) {\n            this.transport = transportConfig;\n        } else {\n            this.transport = this.createTransport(transportConfig);\n        }\n\n        // Map transport lifecycle into the client's request/response bookkeeping.\n        this.transport.onclose = () => this.onClose();\n        this.transport.onerror = (error: MCPClientError) => this.onError(error);\n        this.transport.onmessage = (message: JSONRPCMessage) => {\n            // Handle requests vs responses/notifications\n            if (\"id\" in message) {\n                if (\"error\" in message || \"result\" in message) {\n                    this.onResponse(message as JSONRPCResponse | JSONRPCError);\n                } else {\n                    // Server-initiated requests are not supported yet.\n                    this.onError(new Error(\"Server requests not supported\") as MCPClientError);\n                }\n            } else {\n                // Notifications are ignored for now.\n            }\n        };\n\n        this.clientInfo = { name, version };\n    }\n\n    /**\n     * Creates a transport from config.\n     */\n    private createTransport(config: MCPTransportConfig): MCPTransport {\n        switch (config.type) {\n            case \"http\":\n                return new HttpMCPTransport({\n                    url: config.url,\n                    headers: config.headers,\n                    redirect: config.redirect,\n                    sessionId: config.sessionId,\n                    advanced: config.advanced,\n                });\n            case \"sse\":\n                // SSE uses the same transport implementation with an inbound SSE channel.\n                return new HttpMCPTransport({\n                    url: config.url,\n                    headers: config.headers,\n                    redirect: config.redirect,\n                    sessionId: undefined,\n                    advanced: config.advanced,\n                });\n            default:\n                throw new Error(`Unsupported transport type: ${(config as { type: string }).type}`);\n        }\n    }\n\n    /**\n     * Initializes the client and completes the MCP handshake.\n     */\n    async init(): Promise<this> {\n        try {\n            await this.transport.start();\n            this.isClosed = false;\n\n            const result = await this.request<InitializeResult>({\n                method: \"initialize\",\n                params: {\n                    protocolVersion: LATEST_PROTOCOL_VERSION,\n                    capabilities: this.clientCapabilities,\n                    clientInfo: this.clientInfo,\n                } as InitializeParams,\n                options: undefined,\n            });\n\n            // Fail fast on unsupported protocol versions.\n            const supportedVersions: readonly string[] = SUPPORTED_PROTOCOL_VERSIONS;\n            if (!supportedVersions.includes(result.protocolVersion)) {\n                throw new Error(\n                    `Server's protocol version is not supported: ${result.protocolVersion}`,\n                );\n            }\n\n            this.serverCapabilities = result.capabilities;\n\n            // Finish the required post-initialize notification.\n            await this.notification({ method: \"notifications/initialized\" });\n\n            return this;\n        } catch (error) {\n            await this.close();\n            throw error;\n        }\n    }\n\n    /**\n     * Closes the connection and cleans up.\n     */\n    async close(): Promise<void> {\n        if (this.isClosed) return;\n        await this.transport.close();\n        this.onClose();\n    }\n\n    /**\n     * Checks whether the server supports a capability.\n     */\n    private assertCapability(method: string): void {\n        switch (method) {\n            case \"initialize\":\n                break;\n            case \"tools/list\":\n            case \"tools/call\":\n                if (!this.serverCapabilities.tools) {\n                    throw new Error(\"Server does not support tools\");\n                }\n                break;\n            case \"resources/list\":\n            case \"resources/read\":\n            case \"resources/templates/list\":\n                if (!this.serverCapabilities.resources) {\n                    throw new Error(\"Server does not support resources\");\n                }\n                break;\n            case \"prompts/list\":\n            case \"prompts/get\":\n                if (!this.serverCapabilities.prompts) {\n                    throw new Error(\"Server does not support prompts\");\n                }\n                break;\n            default:\n                throw new Error(`Unsupported method: ${method}`);\n        }\n    }\n\n    /**\n     * Send a JSON-RPC request and wait for response.\n     */\n    private async request<T>({\n        method,\n        params,\n        options,\n    }: {\n        method: string;\n        params: unknown | undefined;\n        options: RequestOptions | undefined;\n    }): Promise<T> {\n        return new Promise((resolve, reject) => {\n            if (this.isClosed) {\n                return reject(new Error(\"Attempted to send a request from a closed client\"));\n            }\n\n            this.assertCapability(method);\n\n            const signal = options?.signal;\n            signal?.throwIfAborted();\n\n            const messageId = this.requestMessageId++;\n\n            const jsonrpcRequest: JSONRPCRequest = {\n                jsonrpc: \"2.0\",\n                id: messageId,\n                method,\n                params: params as Record<string, unknown> | undefined,\n            };\n\n            const cleanup = () => {\n                this.responseHandlers.delete(messageId);\n            };\n\n            // Set up timeout if specified\n            let timeoutId: NodeJS.Timeout | undefined;\n            if (options?.timeout !== undefined) {\n                timeoutId = setTimeout(() => {\n                    cleanup();\n                    reject(new Error(`Request timed out after ${options.timeout}ms`));\n                }, options.timeout);\n            }\n\n            const cleanupWithTimeout = () => {\n                cleanup();\n                if (timeoutId !== undefined) {\n                    clearTimeout(timeoutId);\n                }\n            };\n\n            // Add abort signal listener for cancellation\n            const abortHandler = () => {\n                cleanupWithTimeout();\n                reject(new Error(`Request was aborted: ${signal?.reason || \"Unknown reason\"}`));\n            };\n\n            signal?.addEventListener(\"abort\", abortHandler);\n\n            this.responseHandlers.set(messageId, (response) => {\n                signal?.removeEventListener(\"abort\", abortHandler);\n\n                if (signal?.aborted) {\n                    cleanupWithTimeout();\n                    return reject(new Error(`Request was aborted: ${signal.reason}`));\n                }\n\n                // Check if it's an MCPClientError\n                if (response instanceof MCPClientError) {\n                    cleanupWithTimeout();\n                    return reject(response);\n                }\n\n                // Check if it's a JSON-RPC error\n                if (isJSONRPCError(response)) {\n                    cleanupWithTimeout();\n                    const error = new Error(String(response.error.message)) as MCPClientError;\n                    // Use Object.assign to set the jsonRpcCode since it's readonly\n                    Object.assign(error, { jsonRpcCode: response.error.code });\n                    return reject(error);\n                }\n\n                if (!isJSONRPCResponse(response)) {\n                    cleanupWithTimeout();\n                    return reject(\n                        new MCPClientError({\n                            message: \"Received invalid JSON-RPC response shape.\",\n                        }),\n                    );\n                }\n\n                cleanupWithTimeout();\n                resolve(response.result as T);\n            });\n\n            this.transport.send(jsonrpcRequest).catch((error) => {\n                signal?.removeEventListener(\"abort\", abortHandler);\n                cleanupWithTimeout();\n                reject(error);\n            });\n        });\n    }\n\n    /**\n     * Send a JSON-RPC notification (no response expected).\n     */\n    private async notification({\n        method,\n        params,\n    }: {\n        method: string;\n        params?: unknown;\n    }): Promise<void> {\n        if (this.isClosed) {\n            throw new Error(\"Attempted to send a notification from a closed client\");\n        }\n\n        const jsonrpcNotification = {\n            jsonrpc: \"2.0\" as const,\n            method,\n            params: params as Record<string, unknown> | undefined,\n        };\n        await this.transport.send(jsonrpcNotification);\n    }\n\n    /**\n     * Handle transport closure.\n     */\n    private onClose(): void {\n        if (this.isClosed) return;\n\n        this.isClosed = true;\n        const error = new Error(\"Connection closed\") as MCPClientError;\n\n        // Reject all pending requests\n        for (const handler of this.responseHandlers.values()) {\n            handler({\n                jsonrpc: \"2.0\",\n                id: -1,\n                error: { code: -32000, message: error.message },\n            } as JSONRPCError);\n        }\n\n        this.responseHandlers.clear();\n        this.onUncaughtError?.(error);\n    }\n\n    /**\n     * Handle transport errors.\n     */\n    private onError(error: MCPClientError): void {\n        this.onUncaughtError?.(error);\n    }\n\n    /**\n     * Handle incoming JSON-RPC responses.\n     */\n    private onResponse(response: JSONRPCResponse | JSONRPCError): void {\n        const messageId = Number(response.id);\n        const handler = this.responseHandlers.get(messageId);\n\n        if (handler === undefined) {\n            this.onError(\n                new MCPClientError({\n                    message: `Protocol error: Received a response for an unknown message ID: ${JSON.stringify(response)}`,\n                    context: { messageId, response },\n                }),\n            );\n            return;\n        }\n\n        this.responseHandlers.delete(messageId);\n        handler(response);\n    }\n\n    // Public API implementations\n\n    async listTools({\n        params,\n        options,\n    }: {\n        params?: PaginatedRequest;\n        options?: RequestOptions;\n    } = {}): Promise<ListToolsResult> {\n        return this.request<ListToolsResult>({\n            method: \"tools/list\",\n            params,\n            options,\n        });\n    }\n\n    async callTool(\n        params: MCPCallToolParams,\n        options?: RequestOptions,\n    ): Promise<MCPCallToolResult> {\n        return this.request<MCPCallToolResult>({\n            method: \"tools/call\",\n            params,\n            options,\n        });\n    }\n\n    async listResources({\n        params,\n        options,\n    }: {\n        params?: PaginatedRequest;\n        options?: RequestOptions;\n    } = {}): Promise<ListResourcesResult> {\n        return this.request<ListResourcesResult>({\n            method: \"resources/list\",\n            params,\n            options,\n        });\n    }\n\n    async listResourceTemplates({\n        options,\n    }: {\n        options?: RequestOptions;\n    } = {}): Promise<ListResourceTemplatesResult> {\n        return this.request<ListResourceTemplatesResult>({\n            method: \"resources/templates/list\",\n            params: undefined,\n            options,\n        });\n    }\n\n    async readResource(\n        params: MCPReadResourceParams,\n        options?: RequestOptions,\n    ): Promise<MCPReadResourceResult> {\n        return this.request<MCPReadResourceResult>({\n            method: \"resources/read\",\n            params,\n            options,\n        });\n    }\n\n    async listPrompts({\n        params,\n        options,\n    }: {\n        params?: PaginatedRequest;\n        options?: RequestOptions;\n    } = {}): Promise<ListPromptsResult> {\n        return this.request<ListPromptsResult>({\n            method: \"prompts/list\",\n            params,\n            options,\n        });\n    }\n\n    async getPrompt(\n        params: MCPGetPromptParams,\n        options?: RequestOptions,\n    ): Promise<MCPGetPromptResult> {\n        return this.request<MCPGetPromptResult>({\n            method: \"prompts/get\",\n            params,\n            options,\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/mcp/tool/mcp-http-transport.d.mts

@@ -0,0 +1,62 @@
+import { MCPClientError } from "../error/mcp-client-error.mjs";
+import { JSONRPCMessage } from "./json-rpc-message.mjs";
+import { MCPTransport, MCPTransportAdvancedConfig } from "./mcp-transport.mjs";
+
+//#region src/mcp/tool/mcp-http-transport.d.ts
+/**
+ * HTTP transport for MCP using the Streamable HTTP transport pattern.
+ */
+declare class HttpMCPTransport implements MCPTransport {
+  private url;
+  private abortController?;
+  private headers;
+  private redirect;
+  private sessionId;
+  private inboundSseConnection?;
+  private lastInboundEventId?;
+  private inboundReconnectAttempts;
+  private readonly reconnectionOptions;
+  onclose: (() => void) | undefined;
+  onerror: ((error: MCPClientError) => void) | undefined;
+  onmessage: ((message: JSONRPCMessage) => void) | undefined;
+  private validateAdvancedNumber;
+  constructor({
+    url,
+    headers,
+    redirect,
+    sessionId,
+    advanced
+  }: {
+    url: string;
+    headers: Record<string, string> | undefined;
+    redirect?: RequestRedirect;
+    sessionId: string | undefined;
+    advanced?: MCPTransportAdvancedConfig;
+  });
+  /**
+   * Builds common headers for requests.
+   */
+  private commonHeaders;
+  start(): Promise<void>;
+  close(): Promise<void>;
+  send(message: JSONRPCMessage): Promise<void>;
+  /**
+   * Processes an SSE event stream.
+   */
+  private processEventStream;
+  /**
+   * Calculate next reconnection delay using exponential backoff.
+   */
+  private getNextReconnectionDelay;
+  /**
+   * Schedule SSE reconnection attempt.
+   */
+  private scheduleInboundSseReconnection;
+  /**
+   * Open inbound SSE connection for receiving messages.
+   */
+  private openInboundSse;
+}
+//#endregion
+export { HttpMCPTransport };
+//# sourceMappingURL=mcp-http-transport.d.mts.map

package/dist/mcp/tool/mcp-http-transport.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http-transport.d.mts","names":[],"sources":["../../../src/mcp/tool/mcp-http-transport.ts"],"mappings":";;;;;;;AAYA;cAAa,gBAAA,YAA4B,YAAA;EAAA,QAC7B,GAAA;EAAA,QACA,eAAA;EAAA,QACA,OAAA;EAAA,QACA,QAAA;EAAA,QACA,SAAA;EAAA,QACA,oBAAA;EAAA,QAGA,kBAAA;EAAA,QACA,wBAAA;EAAA,iBACS,mBAAA;EAOjB,OAAA;EACA,OAAA,IAAW,KAAA,EAAO,cAAA;EAClB,SAAA,IAAa,OAAA,EAAS,cAAA;EAAA,QAEd,sBAAA;;IAgBJ,GAAA;IACA,OAAA;IACA,QAAA;IACA,SAAA;IACA;EAAA;IAEA,GAAA;IACA,OAAA,EAAS,MAAA;IACT,QAAA,GAAW,eAAA;IACX,SAAA;IACA,QAAA,GAAW,0BAAA;EAAA;EA9CP;;;EAAA,QA+EM,aAAA;EAcR,KAAA,CAAA,GAAS,OAAA;EAWT,KAAA,CAAA,GAAS,OAAA;EAmBT,IAAA,CAAK,OAAA,EAAS,cAAA,GAAiB,OAAA;EAlHpB;;;EAAA,QAkOH,kBAAA;EA1NH;;;EAAA,QA8QH,wBAAA;EA3QA;;;EAAA,QAuRA,8BAAA;EAtQJ;;;EAAA,QA6RU,cAAA;AAAA"}