@ai-sdk/mcp 2.0.0-canary.54 → 2.0.0-canary.56

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @ai-sdk/mcp
 
+## 2.0.0-canary.56
+
+### Patch Changes
+
+- dcefad3: fix(mcp): respond to ping requests with an empty result per JSON-RPC spec (closes #6282)
+
+## 2.0.0-canary.55
+
+### Patch Changes
+
+- f7bc0b4: feat(mcp): expose `statusCode`, `url`, and `responseBody` on `MCPClientError` for HTTP transport failures
+
+  `MCPClientError` now carries structured HTTP context when it originates from the
+  streamable HTTP transport. This lets downstream consumers (e.g. agent frameworks
+  that need to decide whether to fall back from streamable HTTP to legacy SSE
+  transport per the MCP spec) branch on the actual response status without parsing
+  the error message string.
+
+  Fields are optional — they remain `undefined` for stdio transport errors and for
+  non-response failures (network errors, aborts).
+
 ## 2.0.0-canary.54
 
 ### Patch Changes

package/dist/index.js

@@ -20,12 +20,18 @@ var MCPClientError = class extends (_b = AISDKError, _a = symbol, _b) {
     message,
     cause,
     data,
-    code
+    code,
+    statusCode,
+    url,
+    responseBody
   }) {
     super({ name: name3, message, cause });
     this[_a] = true;
     this.data = data;
     this.code = code;
+    this.statusCode = statusCode;
+    this.url = url;
+    this.responseBody = responseBody;
   }
   static isInstance(error) {
     return AISDKError.hasMarker(error, marker);
@@ -326,8 +332,8 @@ var SafeUrlSchema = z3.string().url().superRefine((val, ctx) => {
   }
 }).refine(
   (url) => {
-    const u = new URL(url);
-    return u.protocol !== "javascript:" && u.protocol !== "data:" && u.protocol !== "vbscript:";
+    const parsedUrl = new URL(url);
+    return parsedUrl.protocol !== "javascript:" && parsedUrl.protocol !== "data:" && parsedUrl.protocol !== "vbscript:";
   },
   { message: "URL cannot use javascript:, data:, or vbscript: scheme" }
 );
@@ -1417,7 +1423,10 @@ var HttpMCPTransport = class {
             errorMessage += ". This server does not support HTTP transport. Try using `sse` transport instead";
           }
           const error2 = new MCPClientError({
-            message: errorMessage
+            message: errorMessage,
+            statusCode: response.status,
+            url: this.url.href,
+            responseBody: text != null ? text : void 0
           });
           (_c = this.onerror) == null ? void 0 : _c.call(this, error2);
           throw error2;
@@ -1429,14 +1438,20 @@ var HttpMCPTransport = class {
         const contentType = response.headers.get("content-type") || "";
         if (contentType.includes("application/json")) {
           const data = await response.json();
-          const messages = Array.isArray(data) ? data.map((m) => JSONRPCMessageSchema.parse(m)) : [JSONRPCMessageSchema.parse(data)];
-          for (const m of messages) (_d = this.onmessage) == null ? void 0 : _d.call(this, m);
+          const messages = Array.isArray(data) ? data.map(
+            (message2) => JSONRPCMessageSchema.parse(message2)
+          ) : [JSONRPCMessageSchema.parse(data)];
+          for (const jsonRpcMessage of messages) {
+            (_d = this.onmessage) == null ? void 0 : _d.call(this, jsonRpcMessage);
+          }
           return;
         }
         if (contentType.includes("text/event-stream")) {
           if (!response.body) {
             const error2 = new MCPClientError({
-              message: "MCP HTTP Transport Error: text/event-stream response without body"
+              message: "MCP HTTP Transport Error: text/event-stream response without body",
+              statusCode: response.status,
+              url: this.url.href
             });
             (_e = this.onerror) == null ? void 0 : _e.call(this, error2);
             throw error2;
@@ -1452,8 +1467,8 @@ var HttpMCPTransport = class {
                 const { event, data } = value;
                 if (event === "message") {
                   try {
-                    const msg = await parseJSONRPCMessage(data);
-                    (_a4 = this.onmessage) == null ? void 0 : _a4.call(this, msg);
+                    const jsonRpcMessage = await parseJSONRPCMessage(data);
+                    (_a4 = this.onmessage) == null ? void 0 : _a4.call(this, jsonRpcMessage);
                   } catch (error2) {
                     const e = new MCPClientError({
                       message: "MCP HTTP Transport Error: Failed to parse message",
@@ -1474,7 +1489,9 @@ var HttpMCPTransport = class {
           return;
         }
         const error = new MCPClientError({
-          message: `MCP HTTP Transport Error: Unexpected content type: ${contentType}`
+          message: `MCP HTTP Transport Error: Unexpected content type: ${contentType}`,
+          statusCode: response.status,
+          url: this.url.href
         });
         (_f = this.onerror) == null ? void 0 : _f.call(this, error);
         throw error;
@@ -1556,7 +1573,9 @@ var HttpMCPTransport = class {
       }
       if (!response.ok || !response.body) {
         const error = new MCPClientError({
-          message: `MCP HTTP Transport Error: GET SSE failed: ${response.status} ${response.statusText}`
+          message: `MCP HTTP Transport Error: GET SSE failed: ${response.status} ${response.statusText}`,
+          statusCode: response.status,
+          url: this.url.href
         });
         (_d = this.onerror) == null ? void 0 : _d.call(this, error);
         return;
@@ -1575,8 +1594,8 @@ var HttpMCPTransport = class {
             }
             if (event === "message") {
               try {
-                const msg = await parseJSONRPCMessage(data);
-                (_a4 = this.onmessage) == null ? void 0 : _a4.call(this, msg);
+                const jsonRpcMessage = await parseJSONRPCMessage(data);
+                (_a4 = this.onmessage) == null ? void 0 : _a4.call(this, jsonRpcMessage);
               } catch (error) {
                 const e = new MCPClientError({
                   message: "MCP HTTP Transport Error: Failed to parse message",
@@ -2213,6 +2232,14 @@ var DefaultMCPClient = class {
   }
   async onRequestMessage(request) {
     try {
+      if (request.method === "ping") {
+        await this.transport.send({
+          jsonrpc: "2.0",
+          id: request.id,
+          result: {}
+        });
+        return;
+      }
       if (request.method !== "elicitation/create") {
         await this.transport.send({
           jsonrpc: "2.0",