@mastra/mcp 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/index.cjs

@@ -1,38 +1,38 @@
 'use strict';
 
+var $RefParser = require('@apidevtools/json-schema-ref-parser');
 var base = require('@mastra/core/base');
 var error = require('@mastra/core/error');
-var protocol_js = require('@modelcontextprotocol/sdk/shared/protocol.js');
-var equal = require('fast-deep-equal');
-var uuid = require('uuid');
-var $RefParser = require('@apidevtools/json-schema-ref-parser');
 var tools = require('@mastra/core/tools');
 var utils = require('@mastra/core/utils');
-var index_js$1 = require('@modelcontextprotocol/sdk/client/index.js');
-var sse_js$1 = require('@modelcontextprotocol/sdk/client/sse.js');
-var stdio_js$1 = require('@modelcontextprotocol/sdk/client/stdio.js');
-var streamableHttp_js$1 = require('@modelcontextprotocol/sdk/client/streamableHttp.js');
+var index_js = require('@modelcontextprotocol/sdk/client/index.js');
+var sse_js = require('@modelcontextprotocol/sdk/client/sse.js');
+var stdio_js = require('@modelcontextprotocol/sdk/client/stdio.js');
+var streamableHttp_js = require('@modelcontextprotocol/sdk/client/streamableHttp.js');
+var protocol_js = require('@modelcontextprotocol/sdk/shared/protocol.js');
 var types_js = require('@modelcontextprotocol/sdk/types.js');
 var exitHook = require('exit-hook');
 var zod = require('zod');
 var zodFromJsonSchema = require('zod-from-json-schema');
 var zodFromJsonSchemaV3 = require('zod-from-json-schema-v3');
+var equal = require('fast-deep-equal');
+var uuid = require('uuid');
 var crypto$1 = require('crypto');
 var mcp = require('@mastra/core/mcp');
 var requestContext = require('@mastra/core/request-context');
-var index_js = require('@modelcontextprotocol/sdk/server/index.js');
-var sse_js = require('@modelcontextprotocol/sdk/server/sse.js');
-var stdio_js = require('@modelcontextprotocol/sdk/server/stdio.js');
-var streamableHttp_js = require('@modelcontextprotocol/sdk/server/streamableHttp.js');
+var index_js$1 = require('@modelcontextprotocol/sdk/server/index.js');
+var sse_js$1 = require('@modelcontextprotocol/sdk/server/sse.js');
+var stdio_js$1 = require('@modelcontextprotocol/sdk/server/stdio.js');
+var streamableHttp_js$1 = require('@modelcontextprotocol/sdk/server/streamableHttp.js');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var equal__default = /*#__PURE__*/_interopDefault(equal);
 var $RefParser__default = /*#__PURE__*/_interopDefault($RefParser);
+var equal__default = /*#__PURE__*/_interopDefault(equal);
 
-// src/client/configuration.ts
+// src/client/client.ts
 
-// src/client/elicitationActions.ts
+// src/client/actions/elicitation.ts
 var ElicitationClientActions = class {
   client;
   logger;
@@ -85,6 +85,23 @@ var ElicitationClientActions = class {
     this.client.setElicitationRequestHandler(handler);
   }
 };
+
+// src/client/actions/progress.ts
+var ProgressClientActions = class {
+  client;
+  logger;
+  constructor({ client, logger }) {
+    this.client = client;
+    this.logger = logger;
+  }
+  /**
+   * Set a notification handler for progress updates.
+   * @param handler The callback function to handle progress notifications.
+   */
+  onUpdate(handler) {
+    this.client.setProgressNotificationHandler(handler);
+  }
+};
 var PromptClientActions = class {
   client;
   logger;
@@ -374,6 +391,7 @@ var ResourceClientActions = class {
 
 // src/client/client.ts
 var DEFAULT_SERVER_CONNECT_TIMEOUT_MSEC = 3e3;
+var SSE_FALLBACK_STATUS_CODES = [400, 404, 405];
 function convertLogLevelToLoggerMethod(level) {
   switch (level) {
     case "debug":
@@ -398,17 +416,21 @@ var InternalMastraMCPClient = class extends base.MastraBase {
   timeout;
   logHandler;
   enableServerLogs;
+  enableProgressTracking;
   serverConfig;
   transport;
   currentOperationContext = null;
   exitHookUnsubscribe;
   sigTermHandler;
+  _roots;
   /** Provides access to resource operations (list, read, subscribe, etc.) */
   resources;
   /** Provides access to prompt operations (list, get, notifications) */
   prompts;
   /** Provides access to elicitation operations (request handling) */
   elicitation;
+  /** Provides access to progress operations (notifications) */
+  progress;
   /**
    * @internal
    */
@@ -425,8 +447,16 @@ var InternalMastraMCPClient = class extends base.MastraBase {
     this.logHandler = server.logger;
     this.enableServerLogs = server.enableServerLogs ?? true;
     this.serverConfig = server;
-    const clientCapabilities = { ...capabilities, elicitation: {} };
-    this.client = new index_js$1.Client(
+    this.enableProgressTracking = !!server.enableProgressTracking;
+    this._roots = server.roots ?? [];
+    const hasRoots = this._roots.length > 0 || !!capabilities.roots;
+    const clientCapabilities = {
+      ...capabilities,
+      elicitation: {},
+      // Auto-enable roots capability if roots are provided
+      ...hasRoots ? { roots: { listChanged: true, ...capabilities.roots ?? {} } } : {}
+    };
+    this.client = new index_js.Client(
       {
         name,
         version
@@ -436,9 +466,13 @@ var InternalMastraMCPClient = class extends base.MastraBase {
       }
     );
     this.setupLogging();
+    if (hasRoots) {
+      this.setupRootsHandler();
+    }
     this.resources = new ResourceClientActions({ client: this, logger: this.logger });
     this.prompts = new PromptClientActions({ client: this, logger: this.logger });
     this.elicitation = new ElicitationClientActions({ client: this, logger: this.logger });
+    this.progress = new ProgressClientActions({ client: this, logger: this.logger });
   }
   /**
    * Log a message at the specified level
@@ -477,13 +511,70 @@ var InternalMastraMCPClient = class extends base.MastraBase {
       );
     }
   }
+  /**
+   * Set up handler for roots/list requests from the server.
+   *
+   * Per MCP spec (https://modelcontextprotocol.io/specification/2025-11-25/client/roots):
+   * When a server sends a roots/list request, the client responds with the configured roots.
+   */
+  setupRootsHandler() {
+    this.log("debug", "Setting up roots/list request handler");
+    this.client.setRequestHandler(types_js.ListRootsRequestSchema, async () => {
+      this.log("debug", `Responding to roots/list request with ${this._roots.length} roots`);
+      return { roots: this._roots };
+    });
+  }
+  /**
+   * Get the currently configured roots.
+   *
+   * @returns Array of configured filesystem roots
+   */
+  get roots() {
+    return [...this._roots];
+  }
+  /**
+   * Update the list of filesystem roots and notify the server.
+   *
+   * Per MCP spec, when roots change, the client sends a `notifications/roots/list_changed`
+   * notification to inform the server that it should re-fetch the roots list.
+   *
+   * @param roots - New list of filesystem roots
+   *
+   * @example
+   * ```typescript
+   * await client.setRoots([
+   *   { uri: 'file:///home/user/projects', name: 'Projects' },
+   *   { uri: 'file:///tmp', name: 'Temp' }
+   * ]);
+   * ```
+   */
+  async setRoots(roots) {
+    this.log("debug", `Updating roots to ${roots.length} entries`);
+    this._roots = [...roots];
+    await this.sendRootsListChanged();
+  }
+  /**
+   * Send a roots/list_changed notification to the server.
+   *
+   * Per MCP spec, clients that support `listChanged` MUST send this notification
+   * when the list of roots changes. The server will then call roots/list to get
+   * the updated list.
+   */
+  async sendRootsListChanged() {
+    if (!this.transport) {
+      this.log("debug", "Cannot send roots/list_changed: not connected");
+      return;
+    }
+    this.log("debug", "Sending notifications/roots/list_changed");
+    await this.client.notification({ method: "notifications/roots/list_changed" });
+  }
   async connectStdio(command) {
     this.log("debug", `Using Stdio transport for command: ${command}`);
     try {
-      this.transport = new stdio_js$1.StdioClientTransport({
+      this.transport = new stdio_js.StdioClientTransport({
         command,
         args: this.serverConfig.args,
-        env: { ...stdio_js$1.getDefaultEnvironment(), ...this.serverConfig.env || {} }
+        env: { ...stdio_js.getDefaultEnvironment(), ...this.serverConfig.env || {} }
       });
       await this.client.connect(this.transport, { timeout: this.serverConfig.timeout ?? this.timeout });
       this.log("debug", `Successfully connected to MCP server via Stdio`);
@@ -493,16 +584,17 @@ var InternalMastraMCPClient = class extends base.MastraBase {
     }
   }
   async connectHttp(url) {
-    const { requestInit, eventSourceInit, authProvider, connectTimeout } = this.serverConfig;
+    const { requestInit, eventSourceInit, authProvider, connectTimeout, fetch } = this.serverConfig;
     this.log("debug", `Attempting to connect to URL: ${url}`);
     let shouldTrySSE = url.pathname.endsWith(`/sse`);
     if (!shouldTrySSE) {
       try {
         this.log("debug", "Trying Streamable HTTP transport...");
-        const streamableTransport = new streamableHttp_js$1.StreamableHTTPClientTransport(url, {
+        const streamableTransport = new streamableHttp_js.StreamableHTTPClientTransport(url, {
           requestInit,
           reconnectionOptions: this.serverConfig.reconnectionOptions,
-          authProvider
+          authProvider,
+          fetch
         });
         await this.client.connect(streamableTransport, {
           timeout: connectTimeout ?? DEFAULT_SERVER_CONNECT_TIMEOUT_MSEC
@@ -511,13 +603,23 @@ var InternalMastraMCPClient = class extends base.MastraBase {
         this.log("debug", "Successfully connected using Streamable HTTP transport.");
       } catch (error) {
         this.log("debug", `Streamable HTTP transport failed: ${error}`);
+        const status = error?.code;
+        if (status !== void 0 && !SSE_FALLBACK_STATUS_CODES.includes(status)) {
+          throw error;
+        }
         shouldTrySSE = true;
       }
     }
     if (shouldTrySSE) {
       this.log("debug", "Falling back to deprecated HTTP+SSE transport...");
       try {
-        const sseTransport = new sse_js$1.SSEClientTransport(url, { requestInit, eventSourceInit, authProvider });
+        const sseEventSourceInit = fetch ? { ...eventSourceInit, fetch } : eventSourceInit;
+        const sseTransport = new sse_js.SSEClientTransport(url, {
+          requestInit,
+          eventSourceInit: sseEventSourceInit,
+          authProvider,
+          fetch
+        });
         await this.client.connect(sseTransport, { timeout: this.serverConfig.timeout ?? this.timeout });
         this.transport = sseTransport;
         this.log("debug", "Successfully connected using deprecated HTTP+SSE transport.");
@@ -596,7 +698,7 @@ var InternalMastraMCPClient = class extends base.MastraBase {
    * @internal
    */
   get sessionId() {
-    if (this.transport instanceof streamableHttp_js$1.StreamableHTTPClientTransport) {
+    if (this.transport instanceof streamableHttp_js.StreamableHTTPClientTransport) {
       return this.transport.sessionId;
     }
     return void 0;
@@ -617,7 +719,7 @@ var InternalMastraMCPClient = class extends base.MastraBase {
       throw e;
     } finally {
       this.transport = void 0;
-      this.isConnected = Promise.resolve(false);
+      this.isConnected = null;
       if (this.exitHookUnsubscribe) {
         this.exitHookUnsubscribe();
         this.exitHookUnsubscribe = void 0;
@@ -628,6 +730,53 @@ var InternalMastraMCPClient = class extends base.MastraBase {
       }
     }
   }
+  /**
+   * Checks if an error indicates a session invalidation that requires reconnection.
+   * 
+   * Common session-related errors include:
+   * - "No valid session ID provided" (HTTP 400)
+   * - "Server not initialized" (HTTP 400)
+   * - Connection refused errors
+   * 
+   * @param error - The error to check
+   * @returns true if the error indicates a session problem requiring reconnection
+   * 
+   * @internal
+   */
+  isSessionError(error) {
+    if (!(error instanceof Error)) {
+      return false;
+    }
+    const errorMessage = error.message.toLowerCase();
+    return errorMessage.includes("no valid session") || errorMessage.includes("session") || errorMessage.includes("server not initialized") || errorMessage.includes("http 400") || errorMessage.includes("http 401") || errorMessage.includes("http 403") || errorMessage.includes("econnrefused") || errorMessage.includes("fetch failed") || errorMessage.includes("connection refused");
+  }
+  /**
+   * Forces a reconnection to the MCP server by disconnecting and reconnecting.
+   * 
+   * This is useful when the session becomes invalid (e.g., after server restart)
+   * and the client needs to establish a fresh connection.
+   * 
+   * @returns Promise resolving when reconnection is complete
+   * @throws {Error} If reconnection fails
+   * 
+   * @internal
+   */
+  async forceReconnect() {
+    this.log("debug", "Forcing reconnection to MCP server...");
+    try {
+      if (this.transport) {
+        await this.transport.close();
+      }
+    } catch (e) {
+      this.log("debug", "Error during force disconnect (ignored)", {
+        error: e instanceof Error ? e.message : String(e)
+      });
+    }
+    this.transport = void 0;
+    this.isConnected = null;
+    await this.connect();
+    this.log("debug", "Successfully reconnected to MCP server");
+  }
   async listResources() {
     this.log("debug", `Requesting resources from MCP server`);
     return await this.client.request({ method: "resources/list" }, types_js.ListResourcesResultSchema, {
@@ -714,6 +863,12 @@ var InternalMastraMCPClient = class extends base.MastraBase {
       return handler(request.params);
     });
   }
+  setProgressNotificationHandler(handler) {
+    this.log("debug", "Setting progress notification handler");
+    this.client.setNotificationHandler(types_js.ProgressNotificationSchema, (notification) => {
+      handler(notification.params);
+    });
+  }
   async convertInputSchema(inputSchema) {
     if (utils.isZodType(inputSchema)) {
       return inputSchema;
@@ -787,7 +942,7 @@ var InternalMastraMCPClient = class extends base.MastraBase {
   }
   async tools() {
     this.log("debug", `Requesting tools from MCP server`);
-    const { tools: tools$1 } = await this.client.listTools({ timeout: this.timeout });
+    const { tools: tools$1 } = await this.client.listTools({}, { timeout: this.timeout });
     const toolsRes = {};
     for (const tool of tools$1) {
       this.log("debug", `Processing tool: ${tool.name}`);
@@ -800,12 +955,14 @@ var InternalMastraMCPClient = class extends base.MastraBase {
           execute: async (input, context) => {
             const previousContext = this.currentOperationContext;
             this.currentOperationContext = context?.requestContext || null;
-            try {
-              this.log("debug", `Executing tool: ${tool.name}`, { toolArgs: input });
+            const executeToolCall = async () => {
+              this.log("debug", `Executing tool: ${tool.name}`, { toolArgs: input, runId: context?.runId });
               const res = await this.client.callTool(
                 {
                   name: tool.name,
-                  arguments: input
+                  arguments: input,
+                  // Use runId as progress token if available, otherwise generate a random UUID
+                  ...this.enableProgressTracking ? { _meta: { progressToken: context?.runId || crypto.randomUUID() } } : {}
                 },
                 types_js.CallToolResultSchema,
                 {
@@ -817,7 +974,27 @@ var InternalMastraMCPClient = class extends base.MastraBase {
                 return res.structuredContent;
               }
               return res;
+            };
+            try {
+              return await executeToolCall();
             } catch (e) {
+              if (this.isSessionError(e)) {
+                this.log("debug", `Session error detected for tool ${tool.name}, attempting reconnection...`, {
+                  error: e instanceof Error ? e.message : String(e)
+                });
+                try {
+                  await this.forceReconnect();
+                  this.log("debug", `Retrying tool ${tool.name} after reconnection...`);
+                  return await executeToolCall();
+                } catch (reconnectError) {
+                  this.log("error", `Reconnection or retry failed for tool ${tool.name}`, {
+                    originalError: e instanceof Error ? e.message : String(e),
+                    reconnectError: reconnectError instanceof Error ? reconnectError.stack : String(reconnectError),
+                    toolArgs: input
+                  });
+                  throw e;
+                }
+              }
               this.log("error", `Error calling tool: ${tool.name}`, {
                 error: e instanceof Error ? e.stack : JSON.stringify(e, null, 2),
                 toolArgs: input
@@ -841,8 +1018,6 @@ var InternalMastraMCPClient = class extends base.MastraBase {
     return toolsRes;
   }
 };
-
-// src/client/configuration.ts
 var mcpClientInstances = /* @__PURE__ */ new Map();
 var MCPClient = class extends base.MastraBase {
   serverConfigs = {};
@@ -915,6 +1090,48 @@ To fix this you have three different options:
     this.addToInstanceCache();
     return this;
   }
+  /**
+   * Provides access to progress-related operations for tracking long-running operations.
+   *
+   * Progress tracking allows MCP servers to send updates about the status of ongoing operations,
+   * providing real-time feedback to users about task completion and current state.
+   *
+   * @example
+   * ```typescript
+   * // Set up handler for progress updates from a server
+   * await mcp.progress.onUpdate('serverName', (params) => {
+   *   console.log(`Progress: ${params.progress}%`);
+   *   console.log(`Status: ${params.message}`);
+   *   
+   *   if (params.total) {
+   *     console.log(`Completed ${params.progress} of ${params.total} items`);
+   *   }
+   * });
+   * ```
+   */
+  get progress() {
+    this.addToInstanceCache();
+    return {
+      onUpdate: async (serverName, handler) => {
+        try {
+          const internalClient = await this.getConnectedClientForServer(serverName);
+          return internalClient.progress.onUpdate(handler);
+        } catch (err) {
+          throw new error.MastraError(
+            {
+              id: "MCP_CLIENT_ON_UPDATE_PROGRESS_FAILED",
+              domain: error.ErrorDomain.MCP,
+              category: error.ErrorCategory.THIRD_PARTY,
+              details: {
+                serverName
+              }
+            },
+            err
+          );
+        }
+      }
+    };
+  }
   /**
    * Provides access to elicitation-related operations for interactive user input collection.
    *
@@ -2160,7 +2377,7 @@ var MCPServer = class extends mcp.MCPServerBase {
     if (opts.prompts) {
       capabilities.prompts = { listChanged: true };
     }
-    this.server = new index_js.Server({ name: this.name, version: this.version }, { capabilities });
+    this.server = new index_js$1.Server({ name: this.name, version: this.version }, { capabilities });
     this.logger.info(
       `Initialized MCPServer '${this.name}' v${this.version} (ID: ${this.id}) with tools: ${Object.keys(this.convertedTools).join(", ")} and resources. Capabilities: ${JSON.stringify(capabilities)}`
     );
@@ -2185,8 +2402,8 @@ var MCPServer = class extends mcp.MCPServerBase {
       }
     });
     this.elicitation = {
-      sendRequest: async (request) => {
-        return this.handleElicitationRequest(request);
+      sendRequest: async (request, options) => {
+        return this.handleElicitationRequest(request, void 0, options);
       }
     };
   }
@@ -2196,15 +2413,51 @@ var MCPServer = class extends mcp.MCPServerBase {
    *
    * @param request - The elicitation request containing message and schema
    * @param serverInstance - Optional server instance to use; defaults to main server for backward compatibility
+   * @param options - Optional request options (timeout, signal, etc.)
    * @returns Promise that resolves to the client's response
    */
-  async handleElicitationRequest(request, serverInstance) {
+  async handleElicitationRequest(request, serverInstance, options) {
     this.logger.debug(`Sending elicitation request: ${request.message}`);
     const server = serverInstance || this.server;
-    const response = await server.elicitInput(request);
+    const response = await server.elicitInput(request, options);
     this.logger.debug(`Received elicitation response: ${JSON.stringify(response)}`);
     return response;
   }
+  /**
+   * Reads and parses the JSON body from an HTTP request.
+   * If the request body was already parsed by middleware (e.g., express.json()),
+   * it uses the pre-parsed body from req.body. Otherwise, it reads from the stream.
+   *
+   * This allows the MCP server to work with Express apps that use express.json()
+   * globally without requiring special route exclusions.
+   *
+   * @param req - The incoming HTTP request
+   * @param options - Optional configuration
+   * @param options.preParsedOnly - If true, only return pre-parsed body from middleware,
+   *   returning undefined if not available. This allows the caller to fall back to
+   *   their own body reading logic (e.g., SDK's getRawBody with size limits).
+   */
+  async readJsonBody(req, options) {
+    const reqWithBody = req;
+    if (reqWithBody.body !== void 0) {
+      return reqWithBody.body;
+    }
+    if (options?.preParsedOnly) {
+      return void 0;
+    }
+    return new Promise((resolve, reject) => {
+      let data = "";
+      req.on("data", (chunk) => data += chunk);
+      req.on("end", () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch (e) {
+          reject(e);
+        }
+      });
+      req.on("error", reject);
+    });
+  }
   /**
    * Creates a new Server instance configured with all handlers for HTTP sessions.
    * Each HTTP client connection gets its own Server instance to avoid routing conflicts.
@@ -2221,7 +2474,7 @@ var MCPServer = class extends mcp.MCPServerBase {
     if (this.promptOptions) {
       capabilities.prompts = { listChanged: true };
     }
-    const serverInstance = new index_js.Server({ name: this.name, version: this.version }, { capabilities });
+    const serverInstance = new index_js$1.Server({ name: this.name, version: this.version }, { capabilities });
     this.registerHandlersOnServer(serverInstance);
     return serverInstance;
   }
@@ -2290,8 +2543,8 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
           };
         }
         const sessionElicitation = {
-          sendRequest: async (request2) => {
-            return this.handleElicitationRequest(request2, serverInstance);
+          sendRequest: async (request2, options) => {
+            return this.handleElicitationRequest(request2, serverInstance, options);
           }
         };
         const mcpOptions = {
@@ -2593,7 +2846,9 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
           try {
             const proxiedContext = context?.requestContext || new requestContext.RequestContext();
             if (context?.mcp?.extra) {
-              proxiedContext.set("mcp.extra", context.mcp.extra);
+              Object.entries(context.mcp.extra).forEach(([key, value]) => {
+                proxiedContext.set(key, value);
+              });
             }
             const response = await agent.generate(inputData.message, {
               ...context ?? {},
@@ -2662,10 +2917,16 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
             inputData
           );
           try {
-            const run2 = await workflow.createRun({ runId: context?.requestContext?.get("runId") });
+            const proxiedContext = context?.requestContext || new requestContext.RequestContext();
+            if (context?.mcp?.extra) {
+              Object.entries(context.mcp.extra).forEach(([key, value]) => {
+                proxiedContext.set(key, value);
+              });
+            }
+            const run2 = await workflow.createRun({ runId: proxiedContext?.get("runId") });
             const response = await run2.start({
               inputData,
-              requestContext: context?.requestContext,
+              requestContext: proxiedContext,
               tracingContext: context?.tracingContext
             });
             return response;
@@ -2784,7 +3045,7 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
    * ```
    */
   async startStdio() {
-    this.stdioTransport = new stdio_js.StdioServerTransport();
+    this.stdioTransport = new stdio_js$1.StdioServerTransport();
     try {
       await this.server.connect(this.stdioTransport);
     } catch (error$1) {
@@ -2821,7 +3082,7 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
    *
    * @example
    * ```typescript
-   * import http from 'http';
+   * import http from 'node:http';
    *
    * const httpServer = http.createServer(async (req, res) => {
    *   await server.startSSE({
@@ -2852,7 +3113,8 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
           res.end("SSE connection not established");
           return;
         }
-        await this.sseTransport.handlePostMessage(req, res);
+        const parsedBody = await this.readJsonBody(req, { preParsedOnly: true });
+        await this.sseTransport.handlePostMessage(req, res, parsedBody);
       } else {
         this.logger.debug("Unknown path:", { path: url.pathname });
         res.writeHead(404);
@@ -2979,8 +3241,8 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
    *
    * @example
    * ```typescript
-   * import http from 'http';
-   * import { randomUUID } from 'crypto';
+   * import http from 'node:http';
+   * import { randomUUID } from 'node:crypto';
    *
    * const httpServer = http.createServer(async (req, res) => {
    *   await server.startHTTP({
@@ -3059,38 +3321,16 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
             `startHTTP: Handling GET request for existing session ${sessionId}. Calling transport.handleRequest.`
           );
         }
-        const body = req.method === "POST" ? await new Promise((resolve, reject) => {
-          let data = "";
-          req.on("data", (chunk) => data += chunk);
-          req.on("end", () => {
-            try {
-              resolve(JSON.parse(data));
-            } catch (e) {
-              reject(e);
-            }
-          });
-          req.on("error", reject);
-        }) : void 0;
+        const body = req.method === "POST" ? await this.readJsonBody(req) : void 0;
         await transport.handleRequest(req, res, body);
       } else {
         this.logger.debug(`startHTTP: No existing Streamable HTTP session ID found. ${req.method}`);
         if (req.method === "POST") {
-          const body = await new Promise((resolve, reject) => {
-            let data = "";
-            req.on("data", (chunk) => data += chunk);
-            req.on("end", () => {
-              try {
-                resolve(JSON.parse(data));
-              } catch (e) {
-                reject(e);
-              }
-            });
-            req.on("error", reject);
-          });
+          const body = await this.readJsonBody(req);
           const { isInitializeRequest } = await import('@modelcontextprotocol/sdk/types.js');
           if (isInitializeRequest(body)) {
             this.logger.debug("startHTTP: Received Streamable HTTP initialize request, creating new transport.");
-            transport = new streamableHttp_js.StreamableHTTPServerTransport({
+            transport = new streamableHttp_js$1.StreamableHTTPServerTransport({
               ...mergedOptions,
               sessionIdGenerator: mergedOptions.sessionIdGenerator,
               onsessioninitialized: (id) => {
@@ -3196,24 +3436,13 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
   async handleServerlessRequest(req, res) {
     try {
       this.logger.debug(`handleServerlessRequest: Received ${req.method} request`);
-      const body = req.method === "POST" ? await new Promise((resolve, reject) => {
-        let data = "";
-        req.on("data", (chunk) => data += chunk);
-        req.on("end", () => {
-          try {
-            resolve(JSON.parse(data));
-          } catch (e) {
-            reject(new Error(`Invalid JSON in request body: ${e instanceof Error ? e.message : String(e)}`));
-          }
-        });
-        req.on("error", reject);
-      }) : void 0;
+      const body = req.method === "POST" ? await this.readJsonBody(req) : void 0;
       this.logger.debug(`handleServerlessRequest: Processing ${req.method} request`, {
         method: body?.method,
         id: body?.id
       });
       const transientServer = this.createServerInstance();
-      const tempTransport = new streamableHttp_js.StreamableHTTPServerTransport({
+      const tempTransport = new streamableHttp_js$1.StreamableHTTPServerTransport({
         sessionIdGenerator: void 0,
         enableJsonResponse: true
       });
@@ -3275,7 +3504,7 @@ Provided arguments: ${JSON.stringify(request.params.arguments, null, 2)}`
   }) {
     try {
       this.logger.debug("Received SSE connection");
-      this.sseTransport = new sse_js.SSEServerTransport(messagePath, res);
+      this.sseTransport = new sse_js$1.SSEServerTransport(messagePath, res);
       await this.server.connect(this.sseTransport);
       this.server.onclose = async () => {
         this.sseTransport = void 0;
@@ -3638,6 +3867,7 @@ Provided arguments: ${JSON.stringify(args, null, 2)}`,
   }
 };
 
+exports.InternalMastraMCPClient = InternalMastraMCPClient;
 exports.MCPClient = MCPClient;
 exports.MCPServer = MCPServer;
 //# sourceMappingURL=index.cjs.map