@mcp-use/client 2.4.2 → 2.4.3-canary.0

package/dist/index.d.ts

@@ -2,8 +2,9 @@
  * `@mcp-use/client` — MCP client for connecting to Model Context Protocol servers.
  *
  * Connectors, protocol-neutral MCP connections, project configuration, OAuth,
- * and code-mode helpers. The SDK negotiates legacy sessionful and modern
- * sessionless MCP servers automatically.
+ * and code-mode helpers. By default, HTTP connections negotiate the server's
+ * supported MCP protocol automatically and stdio connections use the sessionful
+ * protocol; set `protocolNegotiation` to override either default.
  */
 import "./telemetry/configure-node.js";
 export { auth, UnauthorizedError } from "@modelcontextprotocol/client";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,+BAA+B,CAAC;AAEvC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kCAAkC,CAAC;AAGjD,cAAc,0BAA0B,CAAC;AAGzC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,GAAG,EACH,SAAS,EACT,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,+BAA+B,CAAC;AAEvC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kCAAkC,CAAC;AAGjD,cAAc,0BAA0B,CAAC;AAGzC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,GAAG,EACH,SAAS,EACT,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1559,7 +1559,7 @@ init_connector_telemetry();
 init_logging();
 
 // src/utils/version.ts
-var VERSION = "2.4.2";
+var VERSION = "2.4.3-canary.0";
 function getPackageVersion() {
   return VERSION;
 }
@@ -3611,7 +3611,8 @@ var SKILLS_EXTENSION_ID = "io.modelcontextprotocol/skills";
 var MCPConnection = class {
   /**
    * The underlying connector managing the transport layer.
-   * This is the Stdio, HTTP, or WebSocket connector handling actual communication.
+   * This is the stdio or HTTP connector for a server, or the in-process
+   * connector that backs code mode.
    */
   connector;
   /**
@@ -3622,12 +3623,12 @@ var MCPConnection = class {
   /**
    * Creates a new MCP session.
    *
-   * @param connector - The connector to use for communication (Stdio, HTTP, WebSocket)
+   * @param connector - The connector to use for communication (stdio, HTTP, or code mode)
    * @param autoConnect - Whether to automatically connect during initialization (default: true)
    *
    * @example
    * ```typescript
-   * const connector = new HttpConnector({ url: 'http://localhost:3000/mcp' });
+   * const connector = new HttpConnector('http://localhost:3000/mcp');
    * const session = new MCPSession(connector);
    * await session.initialize(); // Auto-connects and initializes
    * ```
@@ -3647,9 +3648,11 @@ var MCPConnection = class {
   /**
    * Establishes the connection to the MCP server.
    *
-   * This method starts the underlying transport (spawns process for Stdio,
-   * opens WebSocket, etc.) but does not perform the MCP initialization
-   * handshake. Call {@link initialize} after connecting.
+   * For stdio and HTTP connectors, this method starts the underlying
+   * transport (spawns the process for stdio, opens the HTTP transport) and
+   * performs the MCP initialization handshake through the SDK client. Call
+   * {@link initialize} afterwards to cache the server's capabilities, server
+   * info, and tools.
    *
    * @returns Promise that resolves when connected
    *
@@ -3687,9 +3690,10 @@ var MCPConnection = class {
   /**
    * Initializes the MCP session with the server.
    *
-   * This method performs the MCP initialization handshake, exchanging
-   * capabilities and metadata with the server. If `autoConnect` is true
-   * and the session is not yet connected, it will connect first.
+   * This method caches the capabilities, server info, and tools negotiated
+   * during {@link connect}. If `autoConnect` is true and the session is not
+   * yet connected, it connects first, which performs the MCP initialization
+   * handshake.
    *
    * After initialization, you can list and call tools, read resources, etc.
    *
@@ -4322,7 +4326,7 @@ var BaseMCPClient = class {
    *
    * @param serverName - The name of the server as defined in the client configuration
    * @param autoInitialize - Whether to automatically initialize the session (default: true)
-   * @returns A promise that resolves to the created MCPSession instance
+   * @returns A promise that resolves to the created MCPConnection instance (also exported as MCPSession).
    * @throws If the server is not found in the configuration
    *
    * @example
@@ -4417,6 +4421,7 @@ var BaseMCPClient = class {
    * the negotiated protocol version and normalized server metadata.
    *
    * @param serverName - The configured server name.
+   * @returns A ready MCPConnection for calling tools and accessing server resources.
    */
   async connect(serverName) {
     return this.createSession(serverName);
@@ -5721,7 +5726,7 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
    * ```typescript
    * if (client.codeMode) {
    *   const result = await client.executeCode('return 2 + 2');
-   *   console.log(result.output); // "4"
+   *   console.log(result.result); // 4
    * }
    * ```
    */
@@ -6012,11 +6017,12 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
    *
    * This method is only available when code mode is enabled. It executes the
    * provided code in an isolated environment (VM or E2B sandbox) and returns
-   * the results including stdout, stderr, and return value.
+   * the return value, captured console output, any error message, and the
+   * execution time.
    *
    * @param code - JavaScript/TypeScript code to execute
    * @param timeout - Optional execution timeout in milliseconds
-   * @returns Execution result with output, errors, and return value
+   * @returns Execution result with `result`, `logs`, `error`, and `execution_time`
    * @throws If code mode is not enabled
    *
    * @example
@@ -6028,17 +6034,16 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
    *   return 2 + 2;
    * `);
    *
-   * console.log(result.stdout);      // "Hello, world!\n"
-   * console.log(result.returnValue); // 4
+   * console.log(result.logs);   // ["Hello, world!"]
+   * console.log(result.result); // 4
    * ```
    *
    * @example
    * ```typescript
-   * // With timeout
-   * try {
-   *   const result = await client.executeCode('while(true) {}', 1000);
-   * } catch (error) {
-   *   console.log('Execution timed out');
+   * // With timeout: errors are reported in the result, not thrown
+   * const result = await client.executeCode('while(true) {}', 1000);
+   * if (result.error) {
+   *   console.log(result.error); // "Script execution timed out"
    * }
    * ```
    *
@@ -6069,7 +6074,7 @@ var MCPClient = class _MCPClient extends BaseMCPClient {
    *
    * // Search for all tools
    * const allTools = await client.searchTools();
-   * console.log(`Found ${allTools.tools.length} tools`);
+   * console.log(`Found ${allTools.results.length} tools`);
    *
    * // Search for specific tools
    * const fileTools = await client.searchTools('file', 'descriptions');