mcp-use 1.11.0-canary.13 → 1.11.0-canary.14

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "1.11.0-canary.13",
+  "version": "1.11.0-canary.14",
   "description": "Opinionated MCP Framework for TypeScript (@modelcontextprotocol/sdk compatible) - Build MCP Agents, Clients and Servers with support for ChatGPT Apps, Code Mode, OAuth, Notifications, Sampling, Observability and more.",
   "author": "mcp-use, Inc.",
   "license": "MIT",
@@ -137,8 +137,8 @@
     "posthog-node": "^5.17.2",
     "ws": "^8.18.3",
     "zod": "^4.2.0",
-    "@mcp-use/cli": "2.6.0-canary.13",
-    "@mcp-use/inspector": "0.13.0-canary.13"
+    "@mcp-use/cli": "2.6.0-canary.14",
+    "@mcp-use/inspector": "0.13.0-canary.14"
   },
   "optionalDependencies": {
     "chalk": "^5.6.2",
@@ -200,36 +200,36 @@
     "release": "npm version patch --tag-version-prefix=v && git push --follow-tags",
     "release:minor": "npm version minor --tag-version-prefix=v && git push --follow-tags",
     "release:major": "npm version major --tag-version-prefix=v && git push --follow-tags",
-    "example:airbnb": "tsx examples/client/airbnb_use.ts",
-    "example:browser": "tsx examples/client/browser_use.ts",
-    "example:chat": "tsx examples/client/chat_example.ts",
-    "example:stream": "tsx examples/client/stream_example.ts",
+    "example:airbnb": "tsx examples/typescript/agent/integrations/airbnb_use.ts",
+    "example:browser": "tsx examples/typescript/agent/integrations/browser_use.ts",
+    "example:chat": "tsx examples/typescript/agent/basic/chat_example.ts",
+    "example:stream": "tsx examples/typescript/agent/advanced/stream_example.ts",
     "example:stream_events": "tsx examples/client/stream_events_example.ts",
-    "example:ai_sdk": "tsx examples/client/ai_sdk_example.ts",
-    "example:filesystem": "tsx examples/client/filesystem_use.ts",
-    "example:http": "tsx examples/client/http_example.ts",
-    "example:everything": "tsx examples/client/mcp_everything.ts",
-    "example:multi": "tsx examples/client/multi_server_example.ts",
+    "example:ai_sdk": "tsx examples/typescript/agent/frameworks/ai_sdk_example.ts",
+    "example:filesystem": "tsx examples/typescript/agent/integrations/filesystem_use.ts",
+    "example:http": "tsx examples/typescript/client/basic/http_example.ts",
+    "example:everything": "tsx examples/typescript/agent/basic/mcp_everything.ts",
+    "example:multi": "tsx examples/typescript/agent/server-management/multi_server_example.ts",
     "example:sandbox": "tsx examples/client/sandbox_everything.ts",
     "example:oauth": "tsx examples/client/simple_oauth_example.ts",
-    "example:blender": "tsx examples/client/blender_use.ts",
-    "example:add_server": "tsx examples/client/add_server_tool.ts",
-    "example:structured": "tsx examples/client/structured_output.ts",
-    "example:observability": "tsx examples/client/observability.ts",
-    "example:simplified": "tsx examples/client/simplified_agent_example.ts",
-    "example:commonjs": "node examples/client/commonjs_example.cjs",
-    "example:code_mode": "tsx examples/client/code_mode_example.ts",
-    "example:code_mode_e2b": "source .env 2>/dev/null || true && tsx examples/client/code_mode_e2b_example.ts",
-    "example:server:notification": "tsx examples/server/notification-example/src/server.ts",
-    "example:client:notification": "tsx examples/client/notification-client.ts",
-    "example:notifications": "lsof -ti:3000 | xargs kill -9 2>/dev/null; tsx examples/server/notifications/src/server.ts & sleep 3 && tsx examples/client/notification-client.ts",
-    "example:server:sampling": "tsx examples/server/sampling/src/server.ts",
-    "example:client:sampling": "tsx examples/client/sampling-client.ts",
-    "example:server:elicitation": "tsx examples/server/elicitation/src/server.ts",
-    "example:sampling": "lsof -ti:3000 | xargs kill -9 2>/dev/null; tsx examples/server/sampling/src/server.ts & sleep 3 && tsx examples/client/sampling-client.ts",
-    "example:server:oauth:supabase": "tsx examples/server/oauth/supabase/src/server.ts",
-    "example:client:oauth:auth0": "tsx examples/server/oauth/auth0/src/server.ts",
-    "example:client:oauth:workos": "tsx examples/server/oauth/workos/src/server.ts",
-    "example:client:oauth:keycloak": "tsx examples/server/oauth/keycloak/src/server.ts"
+    "example:blender": "tsx examples/typescript/agent/integrations/blender_use.ts",
+    "example:add_server": "tsx examples/typescript/agent/server-management/add_server_tool.ts",
+    "example:structured": "tsx examples/typescript/agent/advanced/structured_output.ts",
+    "example:observability": "tsx examples/typescript/agent/advanced/observability.ts",
+    "example:simplified": "tsx examples/typescript/agent/basic/simplified_agent_example.ts",
+    "example:commonjs": "node examples/typescript/client/basic/commonjs_example.cjs",
+    "example:code_mode": "tsx examples/typescript/agent/code-mode/code_mode_example.ts",
+    "example:code_mode_e2b": "source .env 2>/dev/null || true && tsx examples/typescript/agent/code-mode/code_mode_e2b_example.ts",
+    "example:server:notification": "tsx examples/typescript/server/features/notifications/src/server.ts",
+    "example:client:notification": "tsx examples/typescript/client/communication/notification-client.ts",
+    "example:notifications": "lsof -ti:3000 | xargs kill -9 2>/dev/null; tsx examples/typescript/server/features/notifications/src/server.ts & sleep 3 && tsx examples/typescript/client/communication/notification-client.ts",
+    "example:server:sampling": "tsx examples/typescript/server/features/sampling/src/server.ts",
+    "example:client:sampling": "tsx examples/typescript/client/communication/sampling-client.ts",
+    "example:server:elicitation": "tsx examples/typescript/server/features/elicitation/src/server.ts",
+    "example:sampling": "lsof -ti:3000 | xargs kill -9 2>/dev/null; tsx examples/typescript/server/features/sampling/src/server.ts & sleep 3 && tsx examples/typescript/client/communication/sampling-client.ts",
+    "example:server:oauth:supabase": "tsx examples/typescript/server/oauth/supabase/src/server.ts",
+    "example:client:oauth:auth0": "tsx examples/typescript/server/oauth/auth0/src/server.ts",
+    "example:client:oauth:workos": "tsx examples/typescript/server/oauth/workos/src/server.ts",
+    "example:client:oauth:keycloak": "tsx examples/typescript/server/oauth/keycloak/src/server.ts"
   }
 }

package/dist/chunk-2RSYU23F.js

@@ -1,12 +0,0 @@
-import {
-  CODE_MODE_AGENT_PROMPT
-} from "./chunk-AQVGN2CI.js";
-
-// src/client/prompts.ts
-var PROMPTS = {
-  CODE_MODE: CODE_MODE_AGENT_PROMPT
-};
-
-export {
-  PROMPTS
-};

package/dist/chunk-6I4P5WXY.js

@@ -1,491 +0,0 @@
-import {
-  Telemetry
-} from "./chunk-TZKOAITC.js";
-import {
-  logger
-} from "./chunk-FRUZDWXH.js";
-import {
-  __name
-} from "./chunk-3GQAWCBQ.js";
-
-// src/connectors/base.ts
-import {
-  ListRootsRequestSchema,
-  CreateMessageRequestSchema,
-  ElicitRequestSchema
-} from "@mcp-use/modelcontextprotocol-sdk/types.js";
-var BaseConnector = class {
-  static {
-    __name(this, "BaseConnector");
-  }
-  client = null;
-  connectionManager = null;
-  toolsCache = null;
-  capabilitiesCache = null;
-  serverInfoCache = null;
-  connected = false;
-  opts;
-  notificationHandlers = [];
-  rootsCache = [];
-  constructor(opts = {}) {
-    this.opts = opts;
-    if (opts.roots) {
-      this.rootsCache = [...opts.roots];
-    }
-  }
-  /**
-   * Track connector initialization event
-   * Should be called by subclasses after successful connection
-   */
-  trackConnectorInit(data) {
-    const connectorType = this.constructor.name;
-    Telemetry.getInstance().trackConnectorInit({
-      connectorType,
-      ...data
-    }).catch((e) => logger.debug(`Failed to track connector init: ${e}`));
-  }
-  /**
-   * Register a handler for server notifications
-   *
-   * @param handler - Function to call when a notification is received
-   *
-   * @example
-   * ```typescript
-   * connector.onNotification((notification) => {
-   *   console.log(`Received: ${notification.method}`, notification.params);
-   * });
-   * ```
-   */
-  onNotification(handler) {
-    this.notificationHandlers.push(handler);
-    if (this.client) {
-      this.setupNotificationHandler();
-    }
-  }
-  /**
-   * Internal: wire notification handlers to the SDK client
-   * Includes automatic handling for list_changed notifications per MCP spec
-   */
-  setupNotificationHandler() {
-    if (!this.client) return;
-    this.client.fallbackNotificationHandler = async (notification) => {
-      switch (notification.method) {
-        case "notifications/tools/list_changed":
-          await this.refreshToolsCache();
-          break;
-        case "notifications/resources/list_changed":
-          await this.onResourcesListChanged();
-          break;
-        case "notifications/prompts/list_changed":
-          await this.onPromptsListChanged();
-          break;
-        default:
-          break;
-      }
-      for (const handler of this.notificationHandlers) {
-        try {
-          await handler(notification);
-        } catch (err) {
-          logger.error("Error in notification handler:", err);
-        }
-      }
-    };
-  }
-  /**
-   * Auto-refresh tools cache when server sends tools/list_changed notification
-   */
-  async refreshToolsCache() {
-    if (!this.client) return;
-    try {
-      logger.debug(
-        "[Auto] Refreshing tools cache due to list_changed notification"
-      );
-      const result = await this.client.listTools();
-      this.toolsCache = result.tools ?? [];
-      logger.debug(
-        `[Auto] Refreshed tools cache: ${this.toolsCache.length} tools`
-      );
-    } catch (err) {
-      logger.warn("[Auto] Failed to refresh tools cache:", err);
-    }
-  }
-  /**
-   * Called when server sends resources/list_changed notification
-   * Resources aren't cached by default, but we log for user awareness
-   */
-  async onResourcesListChanged() {
-    logger.debug(
-      "[Auto] Resources list changed - clients should re-fetch if needed"
-    );
-  }
-  /**
-   * Called when server sends prompts/list_changed notification
-   * Prompts aren't cached by default, but we log for user awareness
-   */
-  async onPromptsListChanged() {
-    logger.debug(
-      "[Auto] Prompts list changed - clients should re-fetch if needed"
-    );
-  }
-  /**
-   * Set roots and notify the server.
-   * Roots represent directories or files that the client has access to.
-   *
-   * @param roots - Array of Root objects with `uri` (must start with "file://") and optional `name`
-   *
-   * @example
-   * ```typescript
-   * await connector.setRoots([
-   *   { uri: "file:///home/user/project", name: "My Project" },
-   *   { uri: "file:///home/user/data" }
-   * ]);
-   * ```
-   */
-  async setRoots(roots) {
-    this.rootsCache = [...roots];
-    if (this.client) {
-      logger.debug(
-        `Sending roots/list_changed notification with ${roots.length} root(s)`
-      );
-      await this.client.sendRootsListChanged();
-    }
-  }
-  /**
-   * Get the current roots.
-   */
-  getRoots() {
-    return [...this.rootsCache];
-  }
-  /**
-   * Internal: set up roots/list request handler.
-   * This is called after the client connects to register the handler for server requests.
-   */
-  setupRootsHandler() {
-    if (!this.client) return;
-    this.client.setRequestHandler(
-      ListRootsRequestSchema,
-      async (_request, _extra) => {
-        logger.debug(
-          `Server requested roots list, returning ${this.rootsCache.length} root(s)`
-        );
-        return { roots: this.rootsCache };
-      }
-    );
-  }
-  /**
-   * Internal: set up sampling/createMessage request handler.
-   * This is called after the client connects to register the handler for sampling requests.
-   */
-  setupSamplingHandler() {
-    if (!this.client) {
-      logger.debug("setupSamplingHandler: No client available");
-      return;
-    }
-    if (!this.opts.samplingCallback) {
-      logger.debug("setupSamplingHandler: No sampling callback provided");
-      return;
-    }
-    logger.debug("setupSamplingHandler: Setting up sampling request handler");
-    this.client.setRequestHandler(
-      CreateMessageRequestSchema,
-      async (request, _extra) => {
-        logger.debug("Server requested sampling, forwarding to callback");
-        return await this.opts.samplingCallback(request.params);
-      }
-    );
-    logger.debug(
-      "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) {
-      logger.debug("Not connected to MCP implementation");
-      return;
-    }
-    logger.debug("Disconnecting from MCP implementation");
-    await this.cleanupResources();
-    this.connected = false;
-    logger.debug("Disconnected from MCP implementation");
-  }
-  /** Check if the client is connected */
-  get isClientConnected() {
-    return this.client != null;
-  }
-  /**
-   * Initialise the MCP session **after** `connect()` has succeeded.
-   *
-   * In the SDK, `Client.connect(transport)` automatically performs the
-   * protocol‑level `initialize` handshake, so we only need to cache the list of
-   * tools and expose some server info.
-   */
-  async initialize(defaultRequestOptions = this.opts.defaultRequestOptions ?? {}) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug("Caching server capabilities & tools");
-    const capabilities = this.client.getServerCapabilities();
-    this.capabilitiesCache = capabilities || null;
-    const serverInfo = this.client.getServerVersion();
-    this.serverInfoCache = serverInfo || null;
-    const listToolsRes = await this.client.listTools(
-      void 0,
-      defaultRequestOptions
-    );
-    this.toolsCache = listToolsRes.tools ?? [];
-    logger.debug(`Fetched ${this.toolsCache.length} tools from server`);
-    logger.debug("Server capabilities:", capabilities);
-    logger.debug("Server info:", serverInfo);
-    return capabilities;
-  }
-  /** Lazily expose the cached tools list. */
-  get tools() {
-    if (!this.toolsCache) {
-      throw new Error("MCP client is not initialized; call initialize() first");
-    }
-    return this.toolsCache;
-  }
-  /** Expose cached server capabilities. */
-  get serverCapabilities() {
-    return this.capabilitiesCache || {};
-  }
-  /** Expose cached server info. */
-  get serverInfo() {
-    return this.serverInfoCache;
-  }
-  /** Call a tool on the server. */
-  async callTool(name, args, options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    const enhancedOptions = options ? { ...options } : void 0;
-    if (enhancedOptions?.resetTimeoutOnProgress && !enhancedOptions.onprogress) {
-      enhancedOptions.onprogress = () => {
-      };
-      logger.debug(
-        `[BaseConnector] Added onprogress callback for tool '${name}' to enable progressToken`
-      );
-    }
-    logger.debug(`Calling tool '${name}' with args`, args);
-    const res = await this.client.callTool(
-      { name, arguments: args },
-      void 0,
-      enhancedOptions
-    );
-    logger.debug(`Tool '${name}' returned`, res);
-    return res;
-  }
-  /**
-   * List all available tools from the MCP server.
-   * This method fetches fresh tools from the server, unlike the `tools` getter which returns cached tools.
-   *
-   * @param options - Optional request options
-   * @returns Array of available tools
-   */
-  async listTools(options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    const result = await this.client.listTools(void 0, options);
-    return result.tools ?? [];
-  }
-  /**
-   * List resources from the server with optional pagination
-   *
-   * @param cursor - Optional cursor for pagination
-   * @param options - Request options
-   * @returns Resource list with optional nextCursor for pagination
-   */
-  async listResources(cursor, options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug("Listing resources", cursor ? `with cursor: ${cursor}` : "");
-    return await this.client.listResources({ cursor }, options);
-  }
-  /**
-   * List all resources from the server, automatically handling pagination
-   *
-   * @param options - Request options
-   * @returns Complete list of all resources
-   */
-  async listAllResources(options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    if (!this.capabilitiesCache?.resources) {
-      logger.debug("Server does not advertise resources capability, skipping");
-      return { resources: [] };
-    }
-    try {
-      logger.debug("Listing all resources (with auto-pagination)");
-      const allResources = [];
-      let cursor = void 0;
-      do {
-        const result = await this.client.listResources({ cursor }, options);
-        allResources.push(...result.resources || []);
-        cursor = result.nextCursor;
-      } while (cursor);
-      return { resources: allResources };
-    } catch (err) {
-      const error = err;
-      if (error.code === -32601) {
-        logger.debug("Server advertised resources but method not found");
-        return { resources: [] };
-      }
-      throw err;
-    }
-  }
-  /**
-   * List resource templates from the server
-   *
-   * @param options - Request options
-   * @returns List of available resource templates
-   */
-  async listResourceTemplates(options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug("Listing resource templates");
-    return await this.client.listResourceTemplates(void 0, options);
-  }
-  /** Read a resource by URI. */
-  async readResource(uri, options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug(`Reading resource ${uri}`);
-    const res = await this.client.readResource({ uri }, options);
-    return res;
-  }
-  /**
-   * Subscribe to resource updates
-   *
-   * @param uri - URI of the resource to subscribe to
-   * @param options - Request options
-   */
-  async subscribeToResource(uri, options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug(`Subscribing to resource: ${uri}`);
-    return await this.client.subscribeResource({ uri }, options);
-  }
-  /**
-   * Unsubscribe from resource updates
-   *
-   * @param uri - URI of the resource to unsubscribe from
-   * @param options - Request options
-   */
-  async unsubscribeFromResource(uri, options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug(`Unsubscribing from resource: ${uri}`);
-    return await this.client.unsubscribeResource({ uri }, options);
-  }
-  async listPrompts() {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    if (!this.capabilitiesCache?.prompts) {
-      logger.debug("Server does not advertise prompts capability, skipping");
-      return { prompts: [] };
-    }
-    try {
-      logger.debug("Listing prompts");
-      return await this.client.listPrompts();
-    } catch (err) {
-      const error = err;
-      if (error.code === -32601) {
-        logger.debug("Server advertised prompts but method not found");
-        return { prompts: [] };
-      }
-      throw err;
-    }
-  }
-  async getPrompt(name, args) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug(`Getting prompt ${name}`);
-    return await this.client.getPrompt({ name, arguments: args });
-  }
-  /** Send a raw request through the client. */
-  async request(method, params = null, options) {
-    if (!this.client) {
-      throw new Error("MCP client is not connected");
-    }
-    logger.debug(`Sending raw request '${method}' with params`, params);
-    return await this.client.request(
-      { method, params: params ?? {} },
-      void 0,
-      options
-    );
-  }
-  /**
-   * Helper to tear down the client & connection manager safely.
-   */
-  async cleanupResources() {
-    const issues = [];
-    if (this.client) {
-      try {
-        if (typeof this.client.close === "function") {
-          await this.client.close();
-        }
-      } catch (e) {
-        const msg = `Error closing client: ${e}`;
-        logger.warn(msg);
-        issues.push(msg);
-      } finally {
-        this.client = null;
-      }
-    }
-    if (this.connectionManager) {
-      try {
-        await this.connectionManager.stop();
-      } catch (e) {
-        const msg = `Error stopping connection manager: ${e}`;
-        logger.warn(msg);
-        issues.push(msg);
-      } finally {
-        this.connectionManager = null;
-      }
-    }
-    this.toolsCache = null;
-    if (issues.length) {
-      logger.warn(`Resource cleanup finished with ${issues.length} issue(s)`);
-    }
-  }
-};
-
-export {
-  BaseConnector
-};