@smartbear/mcp 0.13.2 → 0.13.3

package/dist/common/pollyfills.js

@@ -0,0 +1,67 @@
+import { ToolError } from "./tools.js";
+async function executeSamplingOrPolyfill(server, prompt, maxTokens = 1e3) {
+  if (!server.isSamplingSupported()) {
+    return createPolyfillResult(prompt);
+  }
+  try {
+    const response = await server.server.createMessage({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: prompt
+          }
+        }
+      ],
+      maxTokens
+    });
+    const content = response.content;
+    if (content.type !== "text") {
+      throw new ToolError(
+        `Received unexpected response type from sampling: ${content.type}`
+      );
+    }
+    return content.text;
+  } catch (error) {
+    console.error(error);
+    return createPolyfillResult(prompt);
+  }
+}
+function createPolyfillResult(prompt) {
+  return {
+    requiresPromptExecution: true,
+    prompt,
+    instructions: "Please execute the above prompt using your AI capabilities and re-request this tool with the result. Include the prompt result in your next request to continue the operation."
+  };
+}
+function isSamplingPolyfillResult(value) {
+  return typeof value === "object" && value !== null && "requiresPromptExecution" in value && value.requiresPromptExecution === true;
+}
+async function executeElicitationOrPolyfill(server, params, options) {
+  if (!server.isElicitationSupported()) {
+    return createElicitationPolyfillResult(params);
+  }
+  try {
+    return await server.server.elicitInput(params, options);
+  } catch (error) {
+    console.error(error);
+    return createElicitationPolyfillResult(params);
+  }
+}
+function createElicitationPolyfillResult(params) {
+  return {
+    requiresInputCollection: true,
+    inputRequest: params,
+    instructions: "Please collect the requested input from the user and re-request this tool with the collected values. Include the input results in your next request to continue the operation."
+  };
+}
+function isElicitationPolyfillResult(value) {
+  return typeof value === "object" && value !== null && "requiresInputCollection" in value && value.requiresInputCollection === true;
+}
+export {
+  executeElicitationOrPolyfill,
+  executeSamplingOrPolyfill,
+  isElicitationPolyfillResult,
+  isSamplingPolyfillResult
+};

package/dist/common/server.js

@@ -3,10 +3,13 @@ import { ZodObject, ZodIntersection, ZodOptional, ZodDefault, ZodRecord, ZodStri
 import Bugsnag from "./bugsnag.js";
 import { CacheService } from "./cache.js";
 import { MCP_SERVER_VERSION, MCP_SERVER_NAME } from "./info.js";
+import { executeElicitationOrPolyfill, isElicitationPolyfillResult } from "./pollyfills.js";
 import { ToolError } from "./tools.js";
 import { unwrapZodType } from "./zod-utils.js";
 class SmartBearMcpServer extends McpServer {
   cache;
+  samplingSupported = false;
+  elicitationSupported = false;
   constructor() {
     super(
       {
@@ -31,6 +34,18 @@ class SmartBearMcpServer extends McpServer {
   getCache() {
     return this.cache;
   }
+  setSamplingSupported(supported) {
+    this.samplingSupported = supported;
+  }
+  isSamplingSupported() {
+    return this.samplingSupported;
+  }
+  setElicitationSupported(supported) {
+    this.elicitationSupported = supported;
+  }
+  isElicitationSupported() {
+    return this.elicitationSupported;
+  }
   async addClient(client) {
     await client.registerTools(
       (params, cb) => {
@@ -70,18 +85,36 @@ class SmartBearMcpServer extends McpServer {
                   ]
                 };
               } else {
-                Bugsnag.notify(e, (event) => {
-                  event.addMetadata("app", { tool: toolName });
-                  event.unhandled = true;
-                });
+                Bugsnag.notify(
+                  e,
+                  (event) => {
+                    event.addMetadata("app", { tool: toolName });
+                    event.unhandled = true;
+                  }
+                );
               }
               throw e;
             }
           }
         );
       },
-      (params, options) => {
-        return this.server.elicitInput(params, options);
+      async (params, options) => {
+        const result = await executeElicitationOrPolyfill(
+          this,
+          params,
+          options
+        );
+        if (isElicitationPolyfillResult(result)) {
+          const schemaStr = "requestedSchema" in result.inputRequest ? `
+
+Schema: ${JSON.stringify(result.inputRequest.requestedSchema, null, 2)}` : "";
+          throw new ToolError(
+            `Input collection required: ${result.inputRequest.message}${schemaStr}
+
+${result.instructions}`
+          );
+        }
+        return result;
       }
     );
     if (client.registerResources) {
@@ -97,10 +130,13 @@ class SmartBearMcpServer extends McpServer {
             try {
               return await cb(url2, variables, extra);
             } catch (e) {
-              Bugsnag.notify(e, (event) => {
-                event.addMetadata("app", { resource: name, url: url2 });
-                event.unhandled = true;
-              });
+              Bugsnag.notify(
+                e,
+                (event) => {
+                  event.addMetadata("app", { resource: name, url: url2 });
+                  event.unhandled = true;
+                }
+              );
               throw e;
             }
           }

package/dist/common/transport-http.js

@@ -136,6 +136,19 @@ async function createNewTransport(req, res, transports) {
       transports.set(newSessionId, { server, transport });
     }
   });
+  transport.onmessage = (message) => {
+    if ("method" in message && message.method === "initialize") {
+      if (message.params?.protocolVersion === "2025-11-25") {
+        const clientCapabilities = message.params?.capabilities;
+        if (Object.hasOwn(clientCapabilities, "sampling")) {
+          server.setSamplingSupported(true);
+        }
+        if (Object.hasOwn(clientCapabilities, "elicitation")) {
+          server.setElicitationSupported(true);
+        }
+      }
+    }
+  };
   transport.onclose = () => {
     if (transport.sessionId) {
       console.log(`[MCP] Session closed: ${transport.sessionId}`);

package/dist/common/transport-stdio.js

@@ -41,6 +41,19 @@ ${message.join("\n")}` : "No clients support environment variable configuration.
     }
   }
   const transport = new StdioServerTransport();
+  transport.onmessage = (message) => {
+    if ("method" in message && message.method === "initialize") {
+      if (message.params?.protocolVersion === "2025-11-25") {
+        const clientCapabilities = message.params?.capabilities;
+        if (Object.hasOwn(clientCapabilities, "sampling")) {
+          server.setSamplingSupported(true);
+        }
+        if (Object.hasOwn(clientCapabilities, "elicitation")) {
+          server.setElicitationSupported(true);
+        }
+      }
+    }
+  };
   await server.connect(transport);
 }
 function getEnvVarName(client, key) {

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.13.2";
+const version = "0.13.3";
 const config = { "mcpServerName": "SmartBear MCP Server" };
 const packageJson = {
   version,

package/dist/pactflow/client/prompt-utils.js

@@ -1,27 +1,15 @@
+import { executeSamplingOrPolyfill, isSamplingPolyfillResult } from "../../common/pollyfills.js";
 import { ToolError } from "../../common/tools.js";
 import { MatcherRecommendationInputSchema, EndpointMatcherSchema } from "./ai.js";
 import { OADMatcherPrompt } from "./prompts.js";
 async function getOADMatcherRecommendations(openAPI, server) {
-  const matcherResponse = await server.createMessage({
-    messages: [
-      {
-        role: "user",
-        content: {
-          type: "text",
-          text: OADMatcherPrompt.replace("{0}", JSON.stringify(openAPI))
-        }
-      }
-    ],
-    maxTokens: 1e3
-  });
-  const regex = /```json[c5]?([\s\S]*?)```/i;
-  const content = matcherResponse.content;
-  if (content.type !== "text") {
-    throw new Error(
-      `Received unexpected response type from matcher recommendations: ${content.type}`
-    );
+  const prompt = OADMatcherPrompt.replace("{0}", JSON.stringify(openAPI));
+  const response = await executeSamplingOrPolyfill(server, prompt, 1e3);
+  if (isSamplingPolyfillResult(response)) {
+    return response;
   }
-  const match = regex.exec(content.text);
+  const regex = /```json[c5]?([\s\S]*?)```/i;
+  const match = regex.exec(response);
   if (match) {
     const jsonText = match[1].trim();
     const parsed = JSON.parse(jsonText);
@@ -34,6 +22,9 @@ async function getOADMatcherRecommendations(openAPI, server) {
   }
 }
 async function getUserMatcherSelection(recommendations, getInput) {
+  if (isSamplingPolyfillResult(recommendations)) {
+    return recommendations;
+  }
   const recommendationsMap = /* @__PURE__ */ new Map();
   recommendations.forEach((rec, index) => {
     recommendationsMap.set(`Recommendation ${index + 1}`, JSON.stringify(rec));

package/dist/pactflow/client.js

@@ -1,5 +1,6 @@
 import zod__default from "zod";
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
+import { isSamplingPolyfillResult } from "../common/pollyfills.js";
 import { ToolError } from "../common/tools.js";
 import { getOADMatcherRecommendations, getUserMatcherSelection } from "./client/prompt-utils.js";
 import { PROMPTS } from "./client/prompts.js";
@@ -47,7 +48,7 @@ class PactflowClient {
     }
     this.baseUrl = config.base_url;
     this.aiBaseUrl = `${this.baseUrl}/api/ai`;
-    this._server = server.server;
+    this._server = server;
   }
   isConfigured() {
     return this.baseUrl !== void 0;
@@ -58,7 +59,7 @@ class PactflowClient {
    *
    * @param toolInput The input data for the generation process.
    * @param getInput Function to get additional input from the user if needed.
-   * @returns The result of the generation process.
+   * @returns The result of the generation process or a polyfill result requiring prompt execution.
    * @throws Error if the HTTP request fails or the operation times out.
    */
   async generate(toolInput, getInput) {
@@ -67,10 +68,16 @@ class PactflowClient {
         toolInput.openapi.document,
         this.server
       );
+      if (isSamplingPolyfillResult(matcherResponse)) {
+        return matcherResponse;
+      }
       const userSelection = await getUserMatcherSelection(
         matcherResponse,
         getInput
       );
+      if (isSamplingPolyfillResult(userSelection)) {
+        return userSelection;
+      }
       toolInput.openapi.matcher = userSelection;
     }
     const status_response = await this.submitHttpCallback(
@@ -87,7 +94,7 @@ class PactflowClient {
    *
    * @param toolInput The input data for the review process.
    * @param getInput Function to get additional input from the user if needed.
-   * @returns The result of the review process.
+   * @returns The result of the review process or a polyfill result requiring prompt execution.
    * @throws Error if the HTTP request fails or the operation times out.
    */
   async review(toolInput, getInput) {
@@ -96,10 +103,16 @@ class PactflowClient {
         toolInput.openapi.document,
         this.server
       );
+      if (isSamplingPolyfillResult(matcherResponse)) {
+        return matcherResponse;
+      }
       const userSelection = await getUserMatcherSelection(
         matcherResponse,
         getInput
       );
+      if (isSamplingPolyfillResult(userSelection)) {
+        return userSelection;
+      }
       toolInput.openapi.matcher = userSelection;
     }
     const status_response = await this.submitHttpCallback("/review", toolInput);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "description": "MCP server for interacting SmartBear Products",
   "keywords": [
     "smartbear",