mcp-use 1.8.1 → 1.9.0-canary.1

package/dist/chunk-KUEVOU4M.js

@@ -0,0 +1,49 @@
+import {
+  __name
+} from "./chunk-3GQAWCBQ.js";
+
+// src/errors.ts
+var ElicitationValidationError = class _ElicitationValidationError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "ElicitationValidationError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _ElicitationValidationError);
+    }
+  }
+  static {
+    __name(this, "ElicitationValidationError");
+  }
+};
+var ElicitationTimeoutError = class _ElicitationTimeoutError extends Error {
+  constructor(message, timeoutMs) {
+    super(message);
+    this.timeoutMs = timeoutMs;
+    this.name = "ElicitationTimeoutError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _ElicitationTimeoutError);
+    }
+  }
+  static {
+    __name(this, "ElicitationTimeoutError");
+  }
+};
+var ElicitationDeclinedError = class _ElicitationDeclinedError extends Error {
+  static {
+    __name(this, "ElicitationDeclinedError");
+  }
+  constructor(message = "User declined the elicitation request") {
+    super(message);
+    this.name = "ElicitationDeclinedError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _ElicitationDeclinedError);
+    }
+  }
+};
+
+export {
+  ElicitationValidationError,
+  ElicitationTimeoutError,
+  ElicitationDeclinedError
+};

package/dist/{chunk-LWAQBWXN.js → chunk-QREDNTLS.js}

@@ -1,6 +1,6 @@
 import {
   BaseConnector
-} from "./chunk-DWTSQOEC.js";
+} from "./chunk-ZQUCGISK.js";
 import {
   __name
 } from "./chunk-3GQAWCBQ.js";

package/dist/{chunk-X2HZKCNO.js → chunk-UADIRKWG.js}

@@ -1,6 +1,6 @@
 import {
   BaseConnector
-} from "./chunk-DWTSQOEC.js";
+} from "./chunk-ZQUCGISK.js";
 import {
   logger
 } from "./chunk-34R6SIER.js";
@@ -391,7 +391,9 @@ var HttpConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       logger.debug(
@@ -445,6 +447,7 @@ var HttpConnector = class extends BaseConnector {
       this.transportType = "streamable-http";
       this.setupNotificationHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation via streamable HTTP: ${baseUrl}`
       );
@@ -474,7 +477,9 @@ var HttpConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       logger.debug(
@@ -489,6 +494,7 @@ var HttpConnector = class extends BaseConnector {
       this.transportType = "sse";
       this.setupNotificationHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation via HTTP/SSE: ${baseUrl}`
       );

package/dist/{chunk-HDYKWLGV.js → chunk-VYOEQ5NZ.js}

@@ -1,6 +1,6 @@
 import {
   BrowserMCPClient
-} from "./chunk-X2HZKCNO.js";
+} from "./chunk-UADIRKWG.js";
 import {
   BrowserOAuthClientProvider,
   sanitizeUrl
@@ -50,7 +50,8 @@ function useMcp(options) {
     // 5 minutes default for SSE read timeout
     wrapTransport,
     onNotification,
-    samplingCallback
+    samplingCallback,
+    onElicitation
   } = options;
   const [state, setState] = useState("discovering");
   const [tools, setTools] = useState([]);
@@ -208,6 +209,8 @@ function useMcp(options) {
           // ← Pass client config to connector
           samplingCallback,
           // ← Pass sampling callback to connector
+          elicitationCallback: onElicitation,
+          // ← Pass elicitation callback to connector
           wrapTransport: wrapTransport ? (transport) => {
             console.log(
               "[useMcp] Applying transport wrapper for server:",

package/dist/{chunk-DWTSQOEC.js → chunk-ZQUCGISK.js}

@@ -8,7 +8,8 @@ import {
 // src/connectors/base.ts
 import {
   ListRootsRequestSchema,
-  CreateMessageRequestSchema
+  CreateMessageRequestSchema,
+  ElicitRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 var BaseConnector = class {
   static {
@@ -182,6 +183,33 @@ var BaseConnector = class {
       "setupSamplingHandler: Sampling handler registered successfully"
     );
   }
+  /**
+   * Internal: set up elicitation/create request handler.
+   * This is called after the client connects to register the handler for elicitation requests.
+   */
+  setupElicitationHandler() {
+    if (!this.client) {
+      logger.debug("setupElicitationHandler: No client available");
+      return;
+    }
+    if (!this.opts.elicitationCallback) {
+      logger.debug("setupElicitationHandler: No elicitation callback provided");
+      return;
+    }
+    logger.debug(
+      "setupElicitationHandler: Setting up elicitation request handler"
+    );
+    this.client.setRequestHandler(
+      ElicitRequestSchema,
+      async (request, _extra) => {
+        logger.debug("Server requested elicitation, forwarding to callback");
+        return await this.opts.elicitationCallback(request.params);
+      }
+    );
+    logger.debug(
+      "setupElicitationHandler: Elicitation handler registered successfully"
+    );
+  }
   /** Disconnect and release resources. */
   async disconnect() {
     if (!this.connected) {

package/dist/index.cjs

@@ -1055,6 +1055,9 @@ __export(index_exports, {
   BrowserOAuthClientProvider: () => BrowserOAuthClientProvider,
   ConnectMCPServerTool: () => ConnectMCPServerTool,
   E2BCodeExecutor: () => E2BCodeExecutor,
+  ElicitationDeclinedError: () => ElicitationDeclinedError,
+  ElicitationTimeoutError: () => ElicitationTimeoutError,
+  ElicitationValidationError: () => ElicitationValidationError,
   ErrorBoundary: () => ErrorBoundary,
   HttpConnector: () => HttpConnector,
   Image: () => Image,
@@ -5650,6 +5653,33 @@ var BaseConnector = class {
       "setupSamplingHandler: Sampling handler registered successfully"
     );
   }
+  /**
+   * Internal: set up elicitation/create request handler.
+   * This is called after the client connects to register the handler for elicitation requests.
+   */
+  setupElicitationHandler() {
+    if (!this.client) {
+      logger.debug("setupElicitationHandler: No client available");
+      return;
+    }
+    if (!this.opts.elicitationCallback) {
+      logger.debug("setupElicitationHandler: No elicitation callback provided");
+      return;
+    }
+    logger.debug(
+      "setupElicitationHandler: Setting up elicitation request handler"
+    );
+    this.client.setRequestHandler(
+      import_types.ElicitRequestSchema,
+      async (request, _extra) => {
+        logger.debug("Server requested elicitation, forwarding to callback");
+        return await this.opts.elicitationCallback(request.params);
+      }
+    );
+    logger.debug(
+      "setupElicitationHandler: Elicitation handler registered successfully"
+    );
+  }
   /** Disconnect and release resources. */
   async disconnect() {
     if (!this.connected) {
@@ -6399,7 +6429,9 @@ var HttpConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       logger.debug(
@@ -6453,6 +6485,7 @@ var HttpConnector = class extends BaseConnector {
       this.transportType = "streamable-http";
       this.setupNotificationHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation via streamable HTTP: ${baseUrl}`
       );
@@ -6482,7 +6515,9 @@ var HttpConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       logger.debug(
@@ -6497,6 +6532,7 @@ var HttpConnector = class extends BaseConnector {
       this.transportType = "sse";
       this.setupNotificationHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation via HTTP/SSE: ${baseUrl}`
       );
@@ -6640,7 +6676,9 @@ var StdioConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       this.client = new import_client2.Client(this.clientInfo, clientOptions);
@@ -6649,6 +6687,7 @@ var StdioConnector = class extends BaseConnector {
       this.setupNotificationHandler();
       this.setupRootsHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation: ${this.command}`
       );
@@ -6991,6 +7030,7 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
   _codeExecutorConfig = "vm";
   _executorOptions;
   _samplingCallback;
+  _elicitationCallback;
   constructor(config, options) {
     if (config) {
       if (typeof config === "string") {
@@ -7017,6 +7057,7 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
     this._codeExecutorConfig = executorConfig;
     this._executorOptions = executorOptions;
     this._samplingCallback = options?.samplingCallback;
+    this._elicitationCallback = options?.elicitationCallback;
     if (this.codeMode) {
       this._setupCodeModeConnector();
     }
@@ -7043,7 +7084,8 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
    */
   createConnectorFromConfig(serverConfig) {
     return createConnectorFromConfig(serverConfig, {
-      samplingCallback: this._samplingCallback
+      samplingCallback: this._samplingCallback,
+      elicitationCallback: this._elicitationCallback
     });
   }
   _setupCodeModeConnector() {
@@ -8112,7 +8154,8 @@ function useMcp(options) {
     // 5 minutes default for SSE read timeout
     wrapTransport,
     onNotification,
-    samplingCallback
+    samplingCallback,
+    onElicitation
   } = options;
   const [state, setState] = (0, import_react.useState)("discovering");
   const [tools, setTools] = (0, import_react.useState)([]);
@@ -8270,6 +8313,8 @@ function useMcp(options) {
           // ← Pass client config to connector
           samplingCallback,
           // ← Pass sampling callback to connector
+          elicitationCallback: onElicitation,
+          // ← Pass elicitation callback to connector
           wrapTransport: wrapTransport ? (transport) => {
             console.log(
               "[useMcp] Applying transport wrapper for server:",
@@ -9692,3 +9737,43 @@ __name(McpUseProvider, "McpUseProvider");
 var PROMPTS = {
   CODE_MODE: CODE_MODE_AGENT_PROMPT
 };
+
+// src/errors.ts
+var ElicitationValidationError = class _ElicitationValidationError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "ElicitationValidationError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _ElicitationValidationError);
+    }
+  }
+  static {
+    __name(this, "ElicitationValidationError");
+  }
+};
+var ElicitationTimeoutError = class _ElicitationTimeoutError extends Error {
+  constructor(message, timeoutMs) {
+    super(message);
+    this.timeoutMs = timeoutMs;
+    this.name = "ElicitationTimeoutError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _ElicitationTimeoutError);
+    }
+  }
+  static {
+    __name(this, "ElicitationTimeoutError");
+  }
+};
+var ElicitationDeclinedError = class _ElicitationDeclinedError extends Error {
+  static {
+    __name(this, "ElicitationDeclinedError");
+  }
+  constructor(message = "User declined the elicitation request") {
+    super(message);
+    this.name = "ElicitationDeclinedError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _ElicitationDeclinedError);
+    }
+  }
+};

package/dist/index.d.ts

@@ -37,6 +37,7 @@ export type { NotificationHandler };
 export type { CodeModeConfig, E2BExecutorOptions, ExecutorOptions, MCPClientOptions, VMExecutorOptions, } from "./src/client.js";
 export { BaseCodeExecutor, E2BCodeExecutor, VMCodeExecutor, isVMAvailable, } from "./src/client.js";
 export type { ExecutionResult, SearchToolsFunction, ToolNamespaceInfo, ToolSearchResult, } from "./src/client/codeExecutor.js";
+export { ElicitationDeclinedError, ElicitationTimeoutError, ElicitationValidationError, } from "./src/errors.js";
 export type { CreateMessageRequest, CreateMessageResult, } from "@modelcontextprotocol/sdk/types.js";
 /**
  * Type alias for the params property of CreateMessageRequest.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAExE,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGzE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,MAAM,EACN,MAAM,EACN,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,cAAc,EACd,kBAAkB,GACnB,CAAC;AAGF,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAGpC,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAExE,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGzE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,MAAM,EACN,MAAM,EACN,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,cAAc,EACd,kBAAkB,GACnB,CAAC;AAGF,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAGpC,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC"}

package/dist/index.js

@@ -24,7 +24,7 @@ import "./chunk-JQKKMUCT.js";
 import {
   CodeModeConnector,
   PROMPTS
-} from "./chunk-LWAQBWXN.js";
+} from "./chunk-QREDNTLS.js";
 import {
   ErrorBoundary,
   Image,
@@ -36,25 +36,30 @@ import {
   useWidgetProps,
   useWidgetState,
   useWidgetTheme
-} from "./chunk-HDYKWLGV.js";
+} from "./chunk-VYOEQ5NZ.js";
 import {
   BaseMCPClient,
   ConnectionManager,
   HttpConnector,
   MCPSession,
   WebSocketConnector
-} from "./chunk-X2HZKCNO.js";
+} from "./chunk-UADIRKWG.js";
 import {
   BrowserOAuthClientProvider,
   onMcpAuthorization
 } from "./chunk-3R5PDYIN.js";
 import {
   BaseConnector
-} from "./chunk-DWTSQOEC.js";
+} from "./chunk-ZQUCGISK.js";
 import {
   Logger,
   logger
 } from "./chunk-34R6SIER.js";
+import {
+  ElicitationDeclinedError,
+  ElicitationTimeoutError,
+  ElicitationValidationError
+} from "./chunk-KUEVOU4M.js";
 import "./chunk-MTHLLDCX.js";
 import {
   __name,
@@ -819,7 +824,9 @@ var StdioConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       this.client = new Client(this.clientInfo, clientOptions);
@@ -828,6 +835,7 @@ var StdioConnector = class extends BaseConnector {
       this.setupNotificationHandler();
       this.setupRootsHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation: ${this.command}`
       );
@@ -892,6 +900,7 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
   _codeExecutorConfig = "vm";
   _executorOptions;
   _samplingCallback;
+  _elicitationCallback;
   constructor(config, options) {
     if (config) {
       if (typeof config === "string") {
@@ -918,6 +927,7 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
     this._codeExecutorConfig = executorConfig;
     this._executorOptions = executorOptions;
     this._samplingCallback = options?.samplingCallback;
+    this._elicitationCallback = options?.elicitationCallback;
     if (this.codeMode) {
       this._setupCodeModeConnector();
     }
@@ -944,7 +954,8 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
    */
   createConnectorFromConfig(serverConfig) {
     return createConnectorFromConfig(serverConfig, {
-      samplingCallback: this._samplingCallback
+      samplingCallback: this._samplingCallback,
+      elicitationCallback: this._elicitationCallback
     });
   }
   _setupCodeModeConnector() {
@@ -1467,6 +1478,9 @@ export {
   BrowserOAuthClientProvider,
   ConnectMCPServerTool,
   E2BCodeExecutor,
+  ElicitationDeclinedError,
+  ElicitationTimeoutError,
+  ElicitationValidationError,
   ErrorBoundary,
   HttpConnector,
   Image,

package/dist/src/agents/index.js

@@ -8,8 +8,8 @@ import {
 import "../../chunk-CPG2WZUL.js";
 import {
   PROMPTS
-} from "../../chunk-LWAQBWXN.js";
-import "../../chunk-DWTSQOEC.js";
+} from "../../chunk-QREDNTLS.js";
+import "../../chunk-ZQUCGISK.js";
 import "../../chunk-34R6SIER.js";
 import "../../chunk-MTHLLDCX.js";
 import "../../chunk-3GQAWCBQ.js";

package/dist/src/browser.cjs

@@ -1412,6 +1412,33 @@ var BaseConnector = class {
       "setupSamplingHandler: Sampling handler registered successfully"
     );
   }
+  /**
+   * Internal: set up elicitation/create request handler.
+   * This is called after the client connects to register the handler for elicitation requests.
+   */
+  setupElicitationHandler() {
+    if (!this.client) {
+      logger.debug("setupElicitationHandler: No client available");
+      return;
+    }
+    if (!this.opts.elicitationCallback) {
+      logger.debug("setupElicitationHandler: No elicitation callback provided");
+      return;
+    }
+    logger.debug(
+      "setupElicitationHandler: Setting up elicitation request handler"
+    );
+    this.client.setRequestHandler(
+      import_types.ElicitRequestSchema,
+      async (request, _extra) => {
+        logger.debug("Server requested elicitation, forwarding to callback");
+        return await this.opts.elicitationCallback(request.params);
+      }
+    );
+    logger.debug(
+      "setupElicitationHandler: Elicitation handler registered successfully"
+    );
+  }
   /** Disconnect and release resources. */
   async disconnect() {
     if (!this.connected) {
@@ -1795,7 +1822,9 @@ var HttpConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       logger.debug(
@@ -1849,6 +1878,7 @@ var HttpConnector = class extends BaseConnector {
       this.transportType = "streamable-http";
       this.setupNotificationHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation via streamable HTTP: ${baseUrl}`
       );
@@ -1878,7 +1908,9 @@ var HttpConnector = class extends BaseConnector {
           roots: { listChanged: true },
           // Always advertise roots capability
           // Add sampling capability if callback is provided
-          ...this.opts.samplingCallback ? { sampling: {} } : {}
+          ...this.opts.samplingCallback ? { sampling: {} } : {},
+          // Add elicitation capability if callback is provided
+          ...this.opts.elicitationCallback ? { elicitation: { form: {}, url: {} } } : {}
         }
       };
       logger.debug(
@@ -1893,6 +1925,7 @@ var HttpConnector = class extends BaseConnector {
       this.transportType = "sse";
       this.setupNotificationHandler();
       this.setupSamplingHandler();
+      this.setupElicitationHandler();
       logger.debug(
         `Successfully connected to MCP implementation via HTTP/SSE: ${baseUrl}`
       );

package/dist/src/browser.js

@@ -16,14 +16,14 @@ import {
   HttpConnector,
   MCPSession,
   WebSocketConnector
-} from "../chunk-X2HZKCNO.js";
+} from "../chunk-UADIRKWG.js";
 import {
   BrowserOAuthClientProvider,
   onMcpAuthorization
 } from "../chunk-3R5PDYIN.js";
 import {
   BaseConnector
-} from "../chunk-DWTSQOEC.js";
+} from "../chunk-ZQUCGISK.js";
 import {
   Logger,
   logger

package/dist/src/client/prompts.js

@@ -1,7 +1,7 @@
 import {
   PROMPTS
-} from "../../chunk-LWAQBWXN.js";
-import "../../chunk-DWTSQOEC.js";
+} from "../../chunk-QREDNTLS.js";
+import "../../chunk-ZQUCGISK.js";
 import "../../chunk-34R6SIER.js";
 import "../../chunk-3GQAWCBQ.js";
 export {

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { CreateMessageRequest, CreateMessageResult } from "@modelcontextprotocol/sdk/types.js";
+import type { CreateMessageRequest, CreateMessageResult, ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult } from "@modelcontextprotocol/sdk/types.js";
 import { BaseMCPClient } from "./client/base.js";
 import type { ExecutionResult } from "./client/codeExecutor.js";
 import { BaseCodeExecutor } from "./client/codeExecutor.js";
@@ -27,6 +27,16 @@ export interface MCPClientOptions {
      * `sampling/createMessage` requests by calling this callback.
      */
     samplingCallback?: (params: CreateMessageRequest["params"]) => Promise<CreateMessageResult>;
+    /**
+     * Optional callback function to handle elicitation requests from servers.
+     * When provided, the client will declare elicitation capability and handle
+     * `elicitation/create` requests by calling this callback.
+     *
+     * Elicitation allows servers to request additional information from users:
+     * - Form mode: Collect structured data with JSON schema validation
+     * - URL mode: Direct users to external URLs for sensitive interactions
+     */
+    elicitationCallback?: (params: ElicitRequestFormParams | ElicitRequestURLParams) => Promise<ElicitResult>;
 }
 export { BaseCodeExecutor, E2BCodeExecutor, isVMAvailable, VMCodeExecutor, } from "./client/codeExecutor.js";
 /**
@@ -45,6 +55,7 @@ export declare class MCPClient extends BaseMCPClient {
     private _codeExecutorConfig;
     private _executorOptions?;
     private _samplingCallback?;
+    private _elicitationCallback?;
     constructor(config?: string | Record<string, any>, options?: MCPClientOptions);
     static fromDict(cfg: Record<string, any>, options?: MCPClientOptions): MCPClient;
     static fromConfigFile(path: string, options?: MCPClientOptions): MCPClient;

package/dist/src/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,gBAAgB,EAGjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC,eAAe,CAAC,CAAC;AAC9B,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,KAAK,CAAC;AAG5C,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;IACtE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KACnC,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AAGD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,aAAa;IACnC,QAAQ,EAAE,OAAO,CAAS;IACjC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,mBAAmB,CAAqC;IAChE,OAAO,CAAC,mBAAmB,CAGC;IAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAC3C,OAAO,CAAC,iBAAiB,CAAC,CAEQ;gBAGhC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrC,OAAO,CAAC,EAAE,gBAAgB;WAwCd,QAAQ,CACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACzB,SAAS;WAIE,cAAc,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,GACzB,SAAS;IAIZ;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQzC;;;OAGG;IACH,SAAS,CAAC,yBAAyB,CACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAChC,aAAa;IAMhB,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,mBAAmB;IAkE3B;;OAEG;IACU,WAAW,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC;IAc3B;;OAEG;IACU,WAAW,CACtB,KAAK,GAAE,MAAW,EAClB,WAAW,GAAE,OAAO,GAAG,cAAc,GAAG,MAAe,GACtD,OAAO,CAAC,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;IAUjE;;OAEG;IACI,cAAc,IAAI,MAAM,EAAE;IAOjC;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAUpC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}