@better-agent/core 0.1.0-beta.1

package/dist/mcp/tool/mcp-http-transport.mjs

@@ -0,0 +1,307 @@
+import { MCPClientError } from "../error/mcp-client-error.mjs";
+import { parseJSONRPCMessage, parseJSONRPCMessageArray } from "./json-rpc-message.mjs";
+import { LATEST_PROTOCOL_VERSION } from "./types.mjs";
+
+//#region src/mcp/tool/mcp-http-transport.ts
+/**
+* HTTP transport for MCP using the Streamable HTTP transport pattern.
+*/
+var HttpMCPTransport = class {
+	url;
+	abortController;
+	headers;
+	redirect;
+	sessionId;
+	inboundSseConnection;
+	lastInboundEventId;
+	inboundReconnectAttempts = 0;
+	reconnectionOptions;
+	onclose;
+	onerror;
+	onmessage;
+	validateAdvancedNumber(value, field) {
+		if (value === void 0) return;
+		if (!Number.isFinite(value) || value < 0) throw new Error(`MCP HTTP Transport Error: '${field}' must be a non-negative number.`);
+		return value;
+	}
+	constructor({ url, headers, redirect, sessionId, advanced }) {
+		this.url = new URL(url);
+		this.headers = headers;
+		this.redirect = redirect;
+		this.sessionId = sessionId;
+		const reconnectInitialDelayMs = this.validateAdvancedNumber(advanced?.reconnectInitialDelayMs, "reconnectInitialDelayMs");
+		const reconnectMaxDelayMs = this.validateAdvancedNumber(advanced?.reconnectMaxDelayMs, "reconnectMaxDelayMs");
+		const reconnectBackoffFactor = this.validateAdvancedNumber(advanced?.reconnectBackoffFactor, "reconnectBackoffFactor");
+		const reconnectMaxRetries = this.validateAdvancedNumber(advanced?.reconnectMaxRetries, "reconnectMaxRetries");
+		this.reconnectionOptions = {
+			initialReconnectionDelay: reconnectInitialDelayMs ?? 1e3,
+			maxReconnectionDelay: reconnectMaxDelayMs ?? 3e4,
+			reconnectionDelayGrowFactor: reconnectBackoffFactor ?? 1.5,
+			maxRetries: reconnectMaxRetries ?? 2
+		};
+	}
+	/**
+	* Builds common headers for requests.
+	*/
+	async commonHeaders(base) {
+		const headers = {
+			...this.headers,
+			...base,
+			"mcp-protocol-version": LATEST_PROTOCOL_VERSION
+		};
+		if (this.sessionId) headers["mcp-session-id"] = this.sessionId;
+		return headers;
+	}
+	async start() {
+		if (this.abortController) throw new Error("MCP HTTP Transport Error: Transport already started.");
+		this.abortController = new AbortController();
+		this.openInboundSse();
+	}
+	async close() {
+		this.inboundSseConnection?.close();
+		try {
+			if (this.sessionId && this.abortController && !this.abortController.signal.aborted) {
+				const headers = await this.commonHeaders({});
+				await fetch(this.url, {
+					method: "DELETE",
+					headers,
+					...this.redirect ? { redirect: this.redirect } : {},
+					signal: this.abortController.signal
+				}).catch(() => void 0);
+			}
+		} catch {}
+		this.abortController?.abort();
+		this.onclose?.();
+	}
+	async send(message) {
+		const attempt = async (_triedAuth = false) => {
+			try {
+				const init = {
+					method: "POST",
+					headers: await this.commonHeaders({
+						"Content-Type": "application/json",
+						Accept: "application/json, text/event-stream"
+					}),
+					body: JSON.stringify(message),
+					...this.redirect ? { redirect: this.redirect } : {},
+					signal: this.abortController?.signal ?? null
+				};
+				const response = await fetch(this.url, init);
+				const sessionId = response.headers.get("mcp-session-id");
+				if (sessionId) this.sessionId = sessionId;
+				if (response.status === 202) {
+					if (!this.inboundSseConnection) this.openInboundSse();
+					return;
+				}
+				if (!response.ok) {
+					const text = await response.text().catch(() => null);
+					let errorMessage = `MCP HTTP Transport Error: POSTing to endpoint (HTTP ${response.status})`;
+					if (text) errorMessage += `: ${text}`;
+					if (response.status === 404) errorMessage += ". This server does not support HTTP transport. Try using `sse` transport instead";
+					const error = new MCPClientError({
+						message: errorMessage,
+						context: {
+							status: response.status,
+							url: this.url.href
+						}
+					});
+					this.onerror?.(error);
+					throw error;
+				}
+				if ("id" in message) {
+					const contentType = response.headers.get("content-type") || "";
+					if (contentType.includes("application/json")) {
+						const messages = parseJSONRPCMessageArray(await response.json());
+						for (const msg of messages) this.onmessage?.(msg);
+						return;
+					}
+					if (contentType.includes("text/event-stream")) {
+						if (!response.body) {
+							const error = new MCPClientError({ message: "MCP HTTP Transport Error: text/event-stream response without body" });
+							this.onerror?.(error);
+							throw error;
+						}
+						await this.processEventStream(response.body);
+						return;
+					}
+				} else if ((response.headers.get("content-type") || "").includes("application/json")) await response.json().catch(() => {});
+				else await response.text().catch(() => {});
+			} catch (error) {
+				const mcpError = error instanceof MCPClientError ? error : new MCPClientError({
+					message: error instanceof Error ? error.message : "Unknown transport error",
+					cause: error
+				});
+				this.onerror?.(mcpError);
+				throw mcpError;
+			}
+		};
+		await attempt();
+	}
+	/**
+	* Processes an SSE event stream.
+	*/
+	async processEventStream(body) {
+		const reader = body.pipeThrough(new TextDecoderStream()).pipeThrough(new EventSourceParserStream()).getReader();
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) return;
+				const { event, data, id } = value;
+				if (id) this.lastInboundEventId = id;
+				if (event === "message") try {
+					const msg = parseJSONRPCMessage(JSON.parse(data));
+					this.onmessage?.(msg);
+				} catch (_error) {
+					const e = new MCPClientError({ message: "MCP HTTP Transport Error: Failed to parse message" });
+					this.onerror?.(e);
+				}
+			}
+		} catch (error) {
+			if (error instanceof Error && error.name === "AbortError") return;
+			const mcpError = error instanceof MCPClientError ? error : new MCPClientError({
+				message: error instanceof Error ? error.message : "Stream processing error",
+				cause: error
+			});
+			this.onerror?.(mcpError);
+		}
+	}
+	/**
+	* Calculate next reconnection delay using exponential backoff.
+	*/
+	getNextReconnectionDelay(attempt) {
+		const { initialReconnectionDelay, reconnectionDelayGrowFactor, maxReconnectionDelay } = this.reconnectionOptions;
+		return Math.min(initialReconnectionDelay * reconnectionDelayGrowFactor ** attempt, maxReconnectionDelay);
+	}
+	/**
+	* Schedule SSE reconnection attempt.
+	*/
+	scheduleInboundSseReconnection() {
+		const { maxRetries } = this.reconnectionOptions;
+		if (maxRetries > 0 && this.inboundReconnectAttempts >= maxRetries) {
+			this.onerror?.(new MCPClientError({ message: `MCP HTTP Transport Error: Maximum reconnection attempts (${maxRetries}) exceeded.` }));
+			return;
+		}
+		const delay = this.getNextReconnectionDelay(this.inboundReconnectAttempts);
+		this.inboundReconnectAttempts += 1;
+		setTimeout(async () => {
+			if (this.abortController?.signal.aborted) return;
+			await this.openInboundSse(false, this.lastInboundEventId);
+		}, delay);
+	}
+	/**
+	* Open inbound SSE connection for receiving messages.
+	*/
+	async openInboundSse(_triedAuth = false, resumeToken) {
+		try {
+			const headers = await this.commonHeaders({ Accept: "text/event-stream" });
+			if (resumeToken) headers["last-event-id"] = resumeToken;
+			const response = await fetch(this.url.href, {
+				method: "GET",
+				headers,
+				...this.redirect ? { redirect: this.redirect } : {},
+				signal: this.abortController?.signal ?? null
+			});
+			const sessionId = response.headers.get("mcp-session-id");
+			if (sessionId) this.sessionId = sessionId;
+			if (response.status === 405) return;
+			if (!response.ok || !response.body) {
+				const error = new MCPClientError({
+					message: `MCP HTTP Transport Error: GET SSE failed: ${response.status} ${response.statusText}`,
+					context: {
+						status: response.status,
+						statusText: response.statusText
+					}
+				});
+				this.onerror?.(error);
+				return;
+			}
+			const reader = response.body.pipeThrough(new TextDecoderStream()).pipeThrough(new EventSourceParserStream()).getReader();
+			this.inboundSseConnection = { close: () => reader.cancel() };
+			this.inboundReconnectAttempts = 0;
+			try {
+				while (true) {
+					const { done, value } = await reader.read();
+					if (done) {
+						if (!this.abortController?.signal.aborted) this.scheduleInboundSseReconnection();
+						return;
+					}
+					const { event, data, id } = value;
+					if (id) this.lastInboundEventId = id;
+					if (event === "message") try {
+						const msg = parseJSONRPCMessage(JSON.parse(data));
+						this.onmessage?.(msg);
+					} catch (_error) {
+						const e = new MCPClientError({ message: "MCP HTTP Transport Error: Failed to parse message" });
+						this.onerror?.(e);
+					}
+				}
+			} catch (error) {
+				if (error instanceof Error && error.name === "AbortError") return;
+				const mcpError = error instanceof MCPClientError ? error : new MCPClientError({
+					message: error instanceof Error ? error.message : "SSE connection error",
+					cause: error
+				});
+				this.onerror?.(mcpError);
+				if (!this.abortController?.signal.aborted) this.scheduleInboundSseReconnection();
+			}
+		} catch (error) {
+			if (error instanceof Error && error.name === "AbortError") return;
+			const mcpError = error instanceof MCPClientError ? error : new MCPClientError({
+				message: error instanceof Error ? error.message : "SSE connection setup error",
+				cause: error
+			});
+			this.onerror?.(mcpError);
+			if (!this.abortController?.signal.aborted) this.scheduleInboundSseReconnection();
+		}
+	}
+};
+/**
+* Parse SSE events from a stream.
+*
+* Implements the EventSource parsing algorithm.
+*/
+var EventSourceParserStream = class extends TransformStream {
+	constructor() {
+		let buffer = "";
+		let data = "";
+		let lastEventId = "";
+		let eventName = "";
+		super({ transform(chunk, controller) {
+			buffer += chunk;
+			const lines = buffer.split("\n");
+			buffer = lines.pop() || "";
+			for (const line of lines) {
+				if (line === "") {
+					if (data !== "") controller.enqueue({
+						event: eventName || void 0,
+						data: data.slice(0, -1),
+						id: lastEventId || void 0
+					});
+					data = "";
+					eventName = "";
+					continue;
+				}
+				if (line.startsWith(":")) continue;
+				const colonIndex = line.indexOf(":");
+				const field = colonIndex === -1 ? line : line.slice(0, colonIndex);
+				const value = colonIndex === -1 ? "" : line.slice(colonIndex + 1).startsWith(" ") ? line.slice(colonIndex + 2) : line.slice(colonIndex + 1);
+				switch (field) {
+					case "event":
+						eventName = value;
+						break;
+					case "data":
+						data += `${value}\n`;
+						break;
+					case "id":
+						lastEventId = value;
+						break;
+					case "retry": break;
+				}
+			}
+		} });
+	}
+};
+
+//#endregion
+export { HttpMCPTransport };
+//# sourceMappingURL=mcp-http-transport.mjs.map

package/dist/mcp/tool/mcp-http-transport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http-transport.mjs","names":[],"sources":["../../../src/mcp/tool/mcp-http-transport.ts"],"sourcesContent":["import { MCPClientError } from \"../error/mcp-client-error\";\nimport {\n    type JSONRPCMessage,\n    parseJSONRPCMessage,\n    parseJSONRPCMessageArray,\n} from \"./json-rpc-message\";\nimport type { MCPTransport, MCPTransportAdvancedConfig } from \"./mcp-transport\";\nimport { LATEST_PROTOCOL_VERSION } from \"./types\";\n\n/**\n * HTTP transport for MCP using the Streamable HTTP transport pattern.\n */\nexport class HttpMCPTransport implements MCPTransport {\n    private url: URL;\n    private abortController?: AbortController;\n    private headers: Record<string, string> | undefined;\n    private redirect: RequestRedirect | undefined;\n    private sessionId: string | undefined;\n    private inboundSseConnection?: { close: () => void };\n\n    // Reconnection state for the inbound SSE channel.\n    private lastInboundEventId?: string;\n    private inboundReconnectAttempts = 0;\n    private readonly reconnectionOptions: {\n        initialReconnectionDelay: number;\n        maxReconnectionDelay: number;\n        reconnectionDelayGrowFactor: number;\n        maxRetries: number;\n    };\n\n    onclose: (() => void) | undefined;\n    onerror: ((error: MCPClientError) => void) | undefined;\n    onmessage: ((message: JSONRPCMessage) => void) | undefined;\n\n    private validateAdvancedNumber(\n        value: number | undefined,\n        field: keyof MCPTransportAdvancedConfig,\n    ): number | undefined {\n        if (value === undefined) {\n            return undefined;\n        }\n\n        if (!Number.isFinite(value) || value < 0) {\n            throw new Error(`MCP HTTP Transport Error: '${field}' must be a non-negative number.`);\n        }\n\n        return value;\n    }\n\n    constructor({\n        url,\n        headers,\n        redirect,\n        sessionId,\n        advanced,\n    }: {\n        url: string;\n        headers: Record<string, string> | undefined;\n        redirect?: RequestRedirect;\n        sessionId: string | undefined;\n        advanced?: MCPTransportAdvancedConfig;\n    }) {\n        this.url = new URL(url);\n        this.headers = headers;\n        this.redirect = redirect;\n        this.sessionId = sessionId;\n        const reconnectInitialDelayMs = this.validateAdvancedNumber(\n            advanced?.reconnectInitialDelayMs,\n            \"reconnectInitialDelayMs\",\n        );\n        const reconnectMaxDelayMs = this.validateAdvancedNumber(\n            advanced?.reconnectMaxDelayMs,\n            \"reconnectMaxDelayMs\",\n        );\n        const reconnectBackoffFactor = this.validateAdvancedNumber(\n            advanced?.reconnectBackoffFactor,\n            \"reconnectBackoffFactor\",\n        );\n        const reconnectMaxRetries = this.validateAdvancedNumber(\n            advanced?.reconnectMaxRetries,\n            \"reconnectMaxRetries\",\n        );\n        this.reconnectionOptions = {\n            initialReconnectionDelay: reconnectInitialDelayMs ?? 1000,\n            maxReconnectionDelay: reconnectMaxDelayMs ?? 30000,\n            reconnectionDelayGrowFactor: reconnectBackoffFactor ?? 1.5,\n            maxRetries: reconnectMaxRetries ?? 2,\n        };\n    }\n\n    /**\n     * Builds common headers for requests.\n     */\n    private async commonHeaders(base: Record<string, string>): Promise<Record<string, string>> {\n        const headers: Record<string, string> = {\n            ...this.headers,\n            ...base,\n            \"mcp-protocol-version\": LATEST_PROTOCOL_VERSION,\n        };\n\n        if (this.sessionId) {\n            headers[\"mcp-session-id\"] = this.sessionId;\n        }\n\n        return headers;\n    }\n\n    async start(): Promise<void> {\n        if (this.abortController) {\n            throw new Error(\"MCP HTTP Transport Error: Transport already started.\");\n        }\n\n        this.abortController = new AbortController();\n\n        // Start listening for inbound server messages on the side channel.\n        void this.openInboundSse();\n    }\n\n    async close(): Promise<void> {\n        this.inboundSseConnection?.close();\n\n        try {\n            if (this.sessionId && this.abortController && !this.abortController.signal.aborted) {\n                const headers = await this.commonHeaders({});\n                await fetch(this.url, {\n                    method: \"DELETE\",\n                    headers,\n                    ...(this.redirect ? { redirect: this.redirect } : {}),\n                    signal: this.abortController.signal,\n                }).catch(() => undefined);\n            }\n        } catch {}\n\n        this.abortController?.abort();\n        this.onclose?.();\n    }\n\n    async send(message: JSONRPCMessage): Promise<void> {\n        const attempt = async (_triedAuth = false): Promise<void> => {\n            try {\n                const headers = await this.commonHeaders({\n                    \"Content-Type\": \"application/json\",\n                    Accept: \"application/json, text/event-stream\",\n                });\n\n                const init: RequestInit = {\n                    method: \"POST\",\n                    headers,\n                    body: JSON.stringify(message),\n                    ...(this.redirect ? { redirect: this.redirect } : {}),\n                    signal: this.abortController?.signal ?? null,\n                };\n\n                const response = await fetch(this.url, init);\n\n                // Track session id for resumable sessions when the server provides one.\n                const sessionId = response.headers.get(\"mcp-session-id\");\n                if (sessionId) {\n                    this.sessionId = sessionId;\n                }\n\n                // Server accepted the message without an immediate payload.\n                if (response.status === 202) {\n                    // If inbound SSE was not available earlier, try again now.\n                    if (!this.inboundSseConnection) {\n                        void this.openInboundSse();\n                    }\n                    return;\n                }\n\n                if (!response.ok) {\n                    const text = await response.text().catch(() => null);\n                    let errorMessage = `MCP HTTP Transport Error: POSTing to endpoint (HTTP ${response.status})`;\n                    if (text) {\n                        errorMessage += `: ${text}`;\n                    }\n\n                    if (response.status === 404) {\n                        errorMessage +=\n                            \". This server does not support HTTP transport. Try using `sse` transport instead\";\n                    }\n\n                    const error = new MCPClientError({\n                        message: errorMessage,\n                        context: { status: response.status, url: this.url.href },\n                    });\n                    this.onerror?.(error);\n                    throw error;\n                }\n\n                // Only requests with ids expect a direct response payload.\n                if (\"id\" in message) {\n                    const contentType = response.headers.get(\"content-type\") || \"\";\n\n                    if (contentType.includes(\"application/json\")) {\n                        const data = await response.json();\n                        const messages = parseJSONRPCMessageArray(data);\n                        for (const msg of messages) {\n                            this.onmessage?.(msg);\n                        }\n                        return;\n                    }\n\n                    if (contentType.includes(\"text/event-stream\")) {\n                        if (!response.body) {\n                            const error = new MCPClientError({\n                                message:\n                                    \"MCP HTTP Transport Error: text/event-stream response without body\",\n                            });\n                            this.onerror?.(error);\n                            throw error;\n                        }\n\n                        await this.processEventStream(\n                            response.body as ReadableStream<BufferSource>,\n                        );\n                        return;\n                    }\n                } else {\n                    // Notifications still drain the body so connections are not leaked.\n                    const contentType = response.headers.get(\"content-type\") || \"\";\n                    if (contentType.includes(\"application/json\")) {\n                        await response.json().catch(() => {}); // Drain JSON response\n                    } else {\n                        await response.text().catch(() => {}); // Drain text response\n                    }\n                }\n            } catch (error) {\n                const mcpError =\n                    error instanceof MCPClientError\n                        ? error\n                        : new MCPClientError({\n                              message:\n                                  error instanceof Error\n                                      ? error.message\n                                      : \"Unknown transport error\",\n                              cause: error,\n                          });\n                this.onerror?.(mcpError);\n                throw mcpError;\n            }\n        };\n\n        await attempt();\n    }\n\n    /**\n     * Processes an SSE event stream.\n     */\n    private async processEventStream(body: ReadableStream<BufferSource>): Promise<void> {\n        const reader = body\n            .pipeThrough(new TextDecoderStream())\n            .pipeThrough(new EventSourceParserStream())\n            .getReader();\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) return;\n\n                const { event, data, id } = value as {\n                    event?: string;\n                    data: string;\n                    id?: string;\n                };\n\n                if (id) {\n                    this.lastInboundEventId = id;\n                }\n\n                if (event === \"message\") {\n                    try {\n                        const msg = parseJSONRPCMessage(JSON.parse(data));\n                        this.onmessage?.(msg);\n                    } catch (_error) {\n                        const e = new MCPClientError({\n                            message: \"MCP HTTP Transport Error: Failed to parse message\",\n                        });\n                        this.onerror?.(e);\n                    }\n                }\n            }\n        } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n                return;\n            }\n            const mcpError =\n                error instanceof MCPClientError\n                    ? error\n                    : new MCPClientError({\n                          message:\n                              error instanceof Error ? error.message : \"Stream processing error\",\n                          cause: error,\n                      });\n            this.onerror?.(mcpError);\n        }\n    }\n\n    /**\n     * Calculate next reconnection delay using exponential backoff.\n     */\n    private getNextReconnectionDelay(attempt: number): number {\n        const { initialReconnectionDelay, reconnectionDelayGrowFactor, maxReconnectionDelay } =\n            this.reconnectionOptions;\n        return Math.min(\n            initialReconnectionDelay * reconnectionDelayGrowFactor ** attempt,\n            maxReconnectionDelay,\n        );\n    }\n\n    /**\n     * Schedule SSE reconnection attempt.\n     */\n    private scheduleInboundSseReconnection(): void {\n        const { maxRetries } = this.reconnectionOptions;\n        if (maxRetries > 0 && this.inboundReconnectAttempts >= maxRetries) {\n            this.onerror?.(\n                new MCPClientError({\n                    message: `MCP HTTP Transport Error: Maximum reconnection attempts (${maxRetries}) exceeded.`,\n                }),\n            );\n            return;\n        }\n\n        const delay = this.getNextReconnectionDelay(this.inboundReconnectAttempts);\n        this.inboundReconnectAttempts += 1;\n\n        setTimeout(async () => {\n            if (this.abortController?.signal.aborted) return;\n            await this.openInboundSse(false, this.lastInboundEventId);\n        }, delay);\n    }\n\n    /**\n     * Open inbound SSE connection for receiving messages.\n     */\n    private async openInboundSse(_triedAuth = false, resumeToken?: string): Promise<void> {\n        try {\n            const headers = await this.commonHeaders({\n                Accept: \"text/event-stream\",\n            });\n\n            if (resumeToken) {\n                headers[\"last-event-id\"] = resumeToken;\n            }\n\n            const response = await fetch(this.url.href, {\n                method: \"GET\",\n                headers,\n                ...(this.redirect ? { redirect: this.redirect } : {}),\n                signal: this.abortController?.signal ?? null,\n            });\n\n            // Track session ID\n            const sessionId = response.headers.get(\"mcp-session-id\");\n            if (sessionId) {\n                this.sessionId = sessionId;\n            }\n\n            // 405 = method not allowed, SSE might not be supported\n            if (response.status === 405) {\n                return;\n            }\n\n            if (!response.ok || !response.body) {\n                const error = new MCPClientError({\n                    message: `MCP HTTP Transport Error: GET SSE failed: ${response.status} ${response.statusText}`,\n                    context: { status: response.status, statusText: response.statusText },\n                });\n                this.onerror?.(error);\n                return;\n            }\n\n            const reader = (response.body as ReadableStream<BufferSource>)\n                .pipeThrough(new TextDecoderStream())\n                .pipeThrough(new EventSourceParserStream())\n                .getReader();\n\n            this.inboundSseConnection = {\n                close: () => reader.cancel(),\n            };\n            this.inboundReconnectAttempts = 0;\n\n            // Process events\n            try {\n                while (true) {\n                    const { done, value } = await reader.read();\n                    if (done) {\n                        // Connection closed cleanly - attempt reconnection\n                        if (!this.abortController?.signal.aborted) {\n                            this.scheduleInboundSseReconnection();\n                        }\n                        return;\n                    }\n\n                    const { event, data, id } = value as {\n                        event?: string;\n                        data: string;\n                        id?: string;\n                    };\n\n                    if (id) {\n                        this.lastInboundEventId = id;\n                    }\n\n                    if (event === \"message\") {\n                        try {\n                            const msg = parseJSONRPCMessage(JSON.parse(data));\n                            this.onmessage?.(msg);\n                        } catch (_error) {\n                            const e = new MCPClientError({\n                                message: \"MCP HTTP Transport Error: Failed to parse message\",\n                            });\n                            this.onerror?.(e);\n                        }\n                    }\n                }\n            } catch (error) {\n                if (error instanceof Error && error.name === \"AbortError\") {\n                    return;\n                }\n                const mcpError =\n                    error instanceof MCPClientError\n                        ? error\n                        : new MCPClientError({\n                              message:\n                                  error instanceof Error ? error.message : \"SSE connection error\",\n                              cause: error,\n                          });\n                this.onerror?.(mcpError);\n                if (!this.abortController?.signal.aborted) {\n                    this.scheduleInboundSseReconnection();\n                }\n            }\n        } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n                return;\n            }\n            const mcpError =\n                error instanceof MCPClientError\n                    ? error\n                    : new MCPClientError({\n                          message:\n                              error instanceof Error ? error.message : \"SSE connection setup error\",\n                          cause: error,\n                      });\n            this.onerror?.(mcpError);\n            if (!this.abortController?.signal.aborted) {\n                this.scheduleInboundSseReconnection();\n            }\n        }\n    }\n}\n\n/**\n * Parse SSE events from a stream.\n *\n * Implements the EventSource parsing algorithm.\n */\nclass EventSourceParserStream extends TransformStream<\n    string,\n    { event: string | undefined; data: string; id: string | undefined }\n> {\n    constructor() {\n        let buffer = \"\";\n        let data = \"\"; // Move data to constructor scope for cross-chunk events\n        let lastEventId = \"\";\n        let eventName = \"\";\n\n        super({\n            transform(chunk, controller) {\n                buffer += chunk;\n                const lines = buffer.split(\"\\n\");\n                buffer = lines.pop() || \"\";\n\n                for (const line of lines) {\n                    if (line === \"\") {\n                        // Dispatch event\n                        if (data !== \"\") {\n                            controller.enqueue({\n                                event: eventName || undefined,\n                                data: data.slice(0, -1), // Remove trailing newline\n                                id: lastEventId || undefined,\n                            });\n                        }\n                        // Reset event state after dispatch\n                        data = \"\";\n                        eventName = \"\";\n                        continue;\n                    }\n\n                    if (line.startsWith(\":\")) {\n                        // Comment line, ignore\n                        continue;\n                    }\n\n                    const colonIndex = line.indexOf(\":\");\n                    const field = colonIndex === -1 ? line : line.slice(0, colonIndex);\n                    const value =\n                        colonIndex === -1\n                            ? \"\"\n                            : line.slice(colonIndex + 1).startsWith(\" \")\n                              ? line.slice(colonIndex + 2)\n                              : line.slice(colonIndex + 1);\n\n                    switch (field) {\n                        case \"event\":\n                            eventName = value;\n                            break;\n                        case \"data\":\n                            data += `${value}\\n`;\n                            break;\n                        case \"id\":\n                            lastEventId = value;\n                            break;\n                        case \"retry\":\n                            // Retry timing is handled by the transport\n                            break;\n                    }\n                }\n            },\n        });\n    }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import { ServerToolDefinition } from "../../tools/types.mjs";
+import { MCPTool } from "./types.mjs";
+import { MCPClient } from "./mcp-client.mjs";
+
+//#region src/mcp/tool/mcp-tools.d.ts
+type MCPServerToolDefinition = ServerToolDefinition<any, string, unknown>;
+/**
+ * Converts MCP tools into Better Agent server tool definitions.
+ *
+ * @param client MCP client used for tool calls.
+ * @param tools MCP tool definitions from the server.
+ * @param options Optional prefix for tool names.
+ * @returns Server tool definitions with working handlers.
+ */
+declare function convertMCPTools(client: MCPClient, tools: MCPTool[], options?: {
+  /** Optional prefix to add to tool names. */prefix?: string;
+}): MCPServerToolDefinition[];
+//#endregion
+export { convertMCPTools };
+//# sourceMappingURL=mcp-tools.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.mts","names":[],"sources":["../../../src/mcp/tool/mcp-tools.ts"],"mappings":";;;;;KAMK,uBAAA,GAA0B,oBAAA;;AAH2B;;;;;AAa1D;;iBAAgB,eAAA,CACZ,MAAA,EAAQ,SAAA,EACR,KAAA,EAAO,OAAA,IACP,OAAA;EAFQ,4CAIJ,MAAA;AAAA,IAEL,uBAAA"}

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

@@ -0,0 +1,73 @@
+import { TOOL_JSON_SCHEMA } from "../../tools/constants.mjs";
+
+//#region src/mcp/tool/mcp-tools.ts
+/**
+* Converts MCP tools into Better Agent server tool definitions.
+*
+* @param client MCP client used for tool calls.
+* @param tools MCP tool definitions from the server.
+* @param options Optional prefix for tool names.
+* @returns Server tool definitions with working handlers.
+*/
+function convertMCPTools(client, tools, options) {
+	return tools.map((tool) => convertMCPTool(client, tool, options?.prefix));
+}
+/**
+* Converts one MCP tool into a Better Agent server tool definition.
+*/
+function convertMCPTool(client, tool, prefix) {
+	const name = prefix ? `${prefix}_${tool.name}` : tool.name;
+	const handler = async (input, _ctx) => {
+		return convertToolResult(await client.callTool({
+			name: tool.name,
+			arguments: input
+		}));
+	};
+	const jsonSchema = {
+		type: "object",
+		properties: tool.inputSchema.properties ?? {},
+		required: tool.inputSchema.required ?? [],
+		...tool.inputSchema.$schema ? { $schema: tool.inputSchema.$schema } : {}
+	};
+	return {
+		kind: "server",
+		name,
+		description: tool.description ?? `MCP tool: ${tool.name}`,
+		schema: tool.inputSchema,
+		handler,
+		[TOOL_JSON_SCHEMA]: jsonSchema
+	};
+}
+/**
+* Converts an MCP tool result into a Better Agent tool result value.
+*/
+function convertToolResult(result) {
+	if (result.isError === true) {
+		const errorMessage = result.content ? result.content.filter((item) => item.type === "text").map((item) => item.text).join("\n") : "Tool execution failed";
+		throw new Error(errorMessage);
+	}
+	if (result.structuredContent !== void 0) return result.structuredContent;
+	if (result.content === void 0 || result.content.length === 0) return { success: true };
+	const firstItem = result.content[0];
+	if (result.content.length === 1 && firstItem !== void 0 && firstItem.type === "text") return firstItem.text;
+	return result.content.map((item) => {
+		switch (item.type) {
+			case "text": return item.text;
+			case "image": return {
+				type: "image",
+				data: item.data,
+				mimeType: item.mimeType
+			};
+			case "resource": return {
+				type: "resource",
+				uri: item.resource.uri,
+				content: item.resource.text ?? item.resource.blob
+			};
+			default: return item;
+		}
+	});
+}
+
+//#endregion
+export { convertMCPTools };
+//# sourceMappingURL=mcp-tools.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.mjs","names":[],"sources":["../../../src/mcp/tool/mcp-tools.ts"],"sourcesContent":["import { TOOL_JSON_SCHEMA } from \"../../tools/constants\";\nimport type { ServerToolDefinition, ToolHandler } from \"../../tools/types\";\nimport type { MCPClient } from \"./mcp-client\";\nimport type { MCPCallToolResult, MCPTool } from \"./types\";\n\n// biome-ignore lint/suspicious/noExplicitAny:\ntype MCPServerToolDefinition = ServerToolDefinition<any, string, unknown>;\n\n/**\n * Converts MCP tools into Better Agent server tool definitions.\n *\n * @param client MCP client used for tool calls.\n * @param tools MCP tool definitions from the server.\n * @param options Optional prefix for tool names.\n * @returns Server tool definitions with working handlers.\n */\nexport function convertMCPTools(\n    client: MCPClient,\n    tools: MCPTool[],\n    options?: {\n        /** Optional prefix to add to tool names. */\n        prefix?: string;\n    },\n): MCPServerToolDefinition[] {\n    return tools.map((tool) => convertMCPTool(client, tool, options?.prefix));\n}\n\n/**\n * Converts one MCP tool into a Better Agent server tool definition.\n */\nfunction convertMCPTool(\n    client: MCPClient,\n    tool: MCPTool,\n    prefix?: string,\n): MCPServerToolDefinition {\n    const name = prefix ? `${prefix}_${tool.name}` : tool.name;\n\n    // The generated handler proxies execution back to the MCP server.\n    const handler: ToolHandler<unknown, unknown> = async (\n        input: unknown,\n        _ctx: { signal: AbortSignal; emit: (event: unknown) => Promise<void> },\n    ) => {\n        const result = await client.callTool({\n            name: tool.name,\n            arguments: input as Record<string, unknown>,\n        });\n\n        // Normalize the MCP result into a Better Agent-friendly value.\n        return convertToolResult(result);\n    };\n\n    // Build a JSON Schema payload that matches Better Agent's tool expectations.\n    const jsonSchema: Record<string, unknown> = {\n        type: \"object\",\n        properties: tool.inputSchema.properties ?? {},\n        required: tool.inputSchema.required ?? [],\n        ...(tool.inputSchema.$schema ? { $schema: tool.inputSchema.$schema } : {}),\n    };\n\n    return {\n        kind: \"server\",\n        name,\n        description: tool.description ?? `MCP tool: ${tool.name}`,\n        // MCP schemas are discovered at runtime, so the public tool type is intentionally erased.\n        schema: tool.inputSchema as Record<string, unknown>,\n        handler,\n        [TOOL_JSON_SCHEMA]: jsonSchema,\n    };\n}\n\n/**\n * Converts an MCP tool result into a Better Agent tool result value.\n */\nfunction convertToolResult(result: MCPCallToolResult): unknown {\n    // Text content is used to build a readable thrown error when MCP marks the call as failed.\n    if (result.isError === true) {\n        const errorMessage = result.content\n            ? result.content\n                  .filter((item) => item.type === \"text\")\n                  .map((item) => item.text)\n                  .join(\"\\n\")\n            : \"Tool execution failed\";\n\n        throw new Error(errorMessage);\n    }\n\n    // Prefer structured content when the server provides it.\n    if (result.structuredContent !== undefined) {\n        return result.structuredContent;\n    }\n\n    if (result.content === undefined || result.content.length === 0) {\n        return { success: true };\n    }\n\n    // Collapse one text item into a plain string for convenience.\n    const firstItem = result.content[0];\n    if (result.content.length === 1 && firstItem !== undefined && firstItem.type === \"text\") {\n        return firstItem.text;\n    }\n\n    // Preserve multi-item results in a simple array form.\n    return result.content.map((item) => {\n        switch (item.type) {\n            case \"text\":\n                return item.text;\n            case \"image\":\n                return {\n                    type: \"image\",\n                    data: item.data,\n                    mimeType: item.mimeType,\n                };\n            case \"resource\":\n                return {\n                    type: \"resource\",\n                    uri: item.resource.uri,\n                    content: item.resource.text ?? item.resource.blob,\n                };\n            default:\n                return item;\n        }\n    });\n}\n"],"mappings":";;;;;;;;;;;AAgBA,SAAgB,gBACZ,QACA,OACA,SAIyB;AACzB,QAAO,MAAM,KAAK,SAAS,eAAe,QAAQ,MAAM,SAAS,OAAO,CAAC;;;;;AAM7E,SAAS,eACL,QACA,MACA,QACuB;CACvB,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,KAAK,SAAS,KAAK;CAGtD,MAAM,UAAyC,OAC3C,OACA,SACC;AAOD,SAAO,kBANQ,MAAM,OAAO,SAAS;GACjC,MAAM,KAAK;GACX,WAAW;GACd,CAAC,CAG8B;;CAIpC,MAAM,aAAsC;EACxC,MAAM;EACN,YAAY,KAAK,YAAY,cAAc,EAAE;EAC7C,UAAU,KAAK,YAAY,YAAY,EAAE;EACzC,GAAI,KAAK,YAAY,UAAU,EAAE,SAAS,KAAK,YAAY,SAAS,GAAG,EAAE;EAC5E;AAED,QAAO;EACH,MAAM;EACN;EACA,aAAa,KAAK,eAAe,aAAa,KAAK;EAEnD,QAAQ,KAAK;EACb;GACC,mBAAmB;EACvB;;;;;AAML,SAAS,kBAAkB,QAAoC;AAE3D,KAAI,OAAO,YAAY,MAAM;EACzB,MAAM,eAAe,OAAO,UACtB,OAAO,QACF,QAAQ,SAAS,KAAK,SAAS,OAAO,CACtC,KAAK,SAAS,KAAK,KAAK,CACxB,KAAK,KAAK,GACf;AAEN,QAAM,IAAI,MAAM,aAAa;;AAIjC,KAAI,OAAO,sBAAsB,OAC7B,QAAO,OAAO;AAGlB,KAAI,OAAO,YAAY,UAAa,OAAO,QAAQ,WAAW,EAC1D,QAAO,EAAE,SAAS,MAAM;CAI5B,MAAM,YAAY,OAAO,QAAQ;AACjC,KAAI,OAAO,QAAQ,WAAW,KAAK,cAAc,UAAa,UAAU,SAAS,OAC7E,QAAO,UAAU;AAIrB,QAAO,OAAO,QAAQ,KAAK,SAAS;AAChC,UAAQ,KAAK,MAAb;GACI,KAAK,OACD,QAAO,KAAK;GAChB,KAAK,QACD,QAAO;IACH,MAAM;IACN,MAAM,KAAK;IACX,UAAU,KAAK;IAClB;GACL,KAAK,WACD,QAAO;IACH,MAAM;IACN,KAAK,KAAK,SAAS;IACnB,SAAS,KAAK,SAAS,QAAQ,KAAK,SAAS;IAChD;GACL,QACI,QAAO;;GAEjB"}

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

@@ -0,0 +1,81 @@
+import { MCPClientError } from "../error/mcp-client-error.mjs";
+import { JSONRPCMessage } from "./json-rpc-message.mjs";
+
+//#region src/mcp/tool/mcp-transport.d.ts
+/**
+ * Transport interface for MCP communication.
+ */
+interface MCPTransport {
+  /**
+   * Starts the transport.
+   */
+  start(): Promise<void>;
+  /**
+   * Sends a JSON-RPC message.
+   */
+  send(message: JSONRPCMessage): Promise<void>;
+  /**
+   * Closes the transport and releases resources.
+   */
+  close(): Promise<void>;
+  /** Called when the transport closes. */
+  onclose: (() => void) | undefined;
+  /** Called when a transport error occurs. */
+  onerror: ((error: MCPClientError) => void) | undefined;
+  /** Called when a message is received from the server. */
+  onmessage: ((message: JSONRPCMessage) => void) | undefined;
+}
+/**
+ * Configuration for MCP HTTP transport.
+ */
+interface MCPTransportAdvancedConfig {
+  /** Initial delay before the first reconnect attempt. */
+  reconnectInitialDelayMs?: number;
+  /** Maximum reconnect delay after backoff is applied. */
+  reconnectMaxDelayMs?: number;
+  /** Exponential backoff multiplier for reconnect attempts. */
+  reconnectBackoffFactor?: number;
+  /** Maximum number of reconnect attempts. */
+  reconnectMaxRetries?: number;
+}
+/**
+ * HTTP transport config.
+ */
+interface MCPHttpTransportConfig {
+  type: "http";
+  /** MCP server URL. */
+  url: string;
+  /** Additional HTTP headers. */
+  headers?: Record<string, string>;
+  /** How to handle HTTP redirects. */
+  redirect?: "follow" | "error";
+  /** Session id for resumable connections. */
+  sessionId?: string;
+  /** Advanced transport controls. */
+  advanced?: MCPTransportAdvancedConfig;
+}
+/**
+ * SSE transport config.
+ */
+interface MCPSseTransportConfig {
+  type: "sse";
+  /** MCP server SSE endpoint URL. */
+  url: string;
+  /** Additional HTTP headers. */
+  headers?: Record<string, string>;
+  /** How to handle HTTP redirects. */
+  redirect?: "follow" | "error";
+  /** Advanced transport controls. */
+  advanced?: MCPTransportAdvancedConfig;
+}
+/**
+ * MCP transport config.
+ */
+type MCPTransportConfig = MCPHttpTransportConfig | MCPSseTransportConfig;
+/**
+ * Checks whether a transport is a custom implementation.
+ */
+declare function isCustomMCPTransport(transport: MCPTransportConfig | MCPTransport): transport is MCPTransport;
+//#endregion
+export { MCPHttpTransportConfig, MCPSseTransportConfig, MCPTransport, MCPTransportAdvancedConfig, MCPTransportConfig, isCustomMCPTransport };
+//# sourceMappingURL=mcp-transport.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-transport.d.mts","names":[],"sources":["../../../src/mcp/tool/mcp-transport.ts"],"mappings":";;;;;;AAMA;UAAiB,YAAA;;;;EAIb,KAAA,IAAS,OAAA;EAUA;;;EALT,IAAA,CAAK,OAAA,EAAS,cAAA,GAAiB,OAAA;EAcK;;;EATpC,KAAA,IAAS,OAAA;EALK;EAQd,OAAA;EAR+B;EAW/B,OAAA,IAAW,KAAA,EAAO,cAAA;EANT;EAST,SAAA,IAAa,OAAA,EAAS,cAAA;AAAA;;;;UAMT,0BAAA;EANA;EAQb,uBAAA;EARoC;EAUpC,mBAAA;EAJuC;EAMvC,sBAAA;EANuC;EAQvC,mBAAA;AAAA;;;;UAMa,sBAAA;EACb,IAAA;EADmC;EAInC,GAAA;EAYqC;EATrC,OAAA,GAAU,MAAA;EAHV;EAMA,QAAA;EAHU;EAMV,SAAA;EAAA;EAGA,QAAA,GAAW,0BAAA;AAAA;;;AAMf;UAAiB,qBAAA;EACb,IAAA;EAYqC;EATrC,GAAA;EAAA;EAGA,OAAA,GAAU,MAAA;EAAA;EAGV,QAAA;EAGA;EAAA,QAAA,GAAW,0BAAA;AAAA;;AAMf;;KAAY,kBAAA,GAAqB,sBAAA,GAAyB,qBAAA;;;AAK1D;iBAAgB,oBAAA,CACZ,SAAA,EAAW,kBAAA,GAAqB,YAAA,GACjC,SAAA,IAAa,YAAA"}

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

@@ -0,0 +1,11 @@
+//#region src/mcp/tool/mcp-transport.ts
+/**
+* Checks whether a transport is a custom implementation.
+*/
+function isCustomMCPTransport(transport) {
+	return "start" in transport && typeof transport.start === "function" && "send" in transport && typeof transport.send === "function" && "close" in transport && typeof transport.close === "function";
+}
+
+//#endregion
+export { isCustomMCPTransport };
+//# sourceMappingURL=mcp-transport.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-transport.mjs","names":[],"sources":["../../../src/mcp/tool/mcp-transport.ts"],"sourcesContent":["import type { MCPClientError } from \"../error/mcp-client-error\";\nimport type { JSONRPCMessage } from \"./json-rpc-message\";\n\n/**\n * Transport interface for MCP communication.\n */\nexport interface MCPTransport {\n    /**\n     * Starts the transport.\n     */\n    start(): Promise<void>;\n\n    /**\n     * Sends a JSON-RPC message.\n     */\n    send(message: JSONRPCMessage): Promise<void>;\n\n    /**\n     * Closes the transport and releases resources.\n     */\n    close(): Promise<void>;\n\n    /** Called when the transport closes. */\n    onclose: (() => void) | undefined;\n\n    /** Called when a transport error occurs. */\n    onerror: ((error: MCPClientError) => void) | undefined;\n\n    /** Called when a message is received from the server. */\n    onmessage: ((message: JSONRPCMessage) => void) | undefined;\n}\n\n/**\n * Configuration for MCP HTTP transport.\n */\nexport interface MCPTransportAdvancedConfig {\n    /** Initial delay before the first reconnect attempt. */\n    reconnectInitialDelayMs?: number;\n    /** Maximum reconnect delay after backoff is applied. */\n    reconnectMaxDelayMs?: number;\n    /** Exponential backoff multiplier for reconnect attempts. */\n    reconnectBackoffFactor?: number;\n    /** Maximum number of reconnect attempts. */\n    reconnectMaxRetries?: number;\n}\n\n/**\n * HTTP transport config.\n */\nexport interface MCPHttpTransportConfig {\n    type: \"http\";\n\n    /** MCP server URL. */\n    url: string;\n\n    /** Additional HTTP headers. */\n    headers?: Record<string, string>;\n\n    /** How to handle HTTP redirects. */\n    redirect?: \"follow\" | \"error\";\n\n    /** Session id for resumable connections. */\n    sessionId?: string;\n\n    /** Advanced transport controls. */\n    advanced?: MCPTransportAdvancedConfig;\n}\n\n/**\n * SSE transport config.\n */\nexport interface MCPSseTransportConfig {\n    type: \"sse\";\n\n    /** MCP server SSE endpoint URL. */\n    url: string;\n\n    /** Additional HTTP headers. */\n    headers?: Record<string, string>;\n\n    /** How to handle HTTP redirects. */\n    redirect?: \"follow\" | \"error\";\n\n    /** Advanced transport controls. */\n    advanced?: MCPTransportAdvancedConfig;\n}\n\n/**\n * MCP transport config.\n */\nexport type MCPTransportConfig = MCPHttpTransportConfig | MCPSseTransportConfig;\n\n/**\n * Checks whether a transport is a custom implementation.\n */\nexport function isCustomMCPTransport(\n    transport: MCPTransportConfig | MCPTransport,\n): transport is MCPTransport {\n    return (\n        \"start\" in transport &&\n        typeof transport.start === \"function\" &&\n        \"send\" in transport &&\n        typeof transport.send === \"function\" &&\n        \"close\" in transport &&\n        typeof transport.close === \"function\"\n    );\n}\n"],"mappings":";;;;AA+FA,SAAgB,qBACZ,WACyB;AACzB,QACI,WAAW,aACX,OAAO,UAAU,UAAU,cAC3B,UAAU,aACV,OAAO,UAAU,SAAS,cAC1B,WAAW,aACX,OAAO,UAAU,UAAU"}