mcp-use 1.11.0-canary.8 → 1.11.0

package/dist/index.cjs

@@ -2790,7 +2790,7 @@ __name(generateUUID, "generateUUID");
 init_logging();
 
 // src/version.ts
-var VERSION = "1.11.0-canary.8";
+var VERSION = "1.11.0";
 function getPackageVersion() {
   return VERSION;
 }
@@ -2829,6 +2829,20 @@ function extractModelInfo(llm) {
 __name(extractModelInfo, "extractModelInfo");
 
 // src/telemetry/telemetry.ts
+function secureRandomString() {
+  if (typeof window !== "undefined" && window.crypto && typeof window.crypto.getRandomValues === "function") {
+    const array = new Uint8Array(8);
+    window.crypto.getRandomValues(array);
+    return Array.from(array, (v) => v.toString(16).padStart(2, "0")).join("");
+  }
+  try {
+    const crypto = require("crypto");
+    return crypto.randomBytes(8).toString("hex");
+  } catch (e) {
+    return Math.random().toString(36).substring(2, 15);
+  }
+}
+__name(secureRandomString, "secureRandomString");
 var USER_ID_STORAGE_KEY = "mcp_use_user_id";
 function detectRuntimeEnvironment() {
   try {
@@ -2960,12 +2974,26 @@ var Telemetry = class _Telemetry {
         "Anonymized telemetry enabled. Set MCP_USE_ANONYMIZED_TELEMETRY=false to disable."
       );
       this._posthogLoading = this._initPostHog();
-      try {
-        this._scarfClient = new ScarfEventLogger(this.SCARF_GATEWAY_URL, 3e3);
-      } catch (e) {
-        logger.warn(`Failed to initialize Scarf telemetry: ${e}`);
+      if (this._runtimeEnvironment !== "browser") {
+        try {
+          this._scarfClient = new ScarfEventLogger(
+            this.SCARF_GATEWAY_URL,
+            3e3
+          );
+        } catch (e) {
+          logger.warn(`Failed to initialize Scarf telemetry: ${e}`);
+          this._scarfClient = null;
+        }
+      } else {
         this._scarfClient = null;
       }
+      if (this._storageCapability === "filesystem" && this._scarfClient) {
+        setTimeout(() => {
+          this.trackPackageDownload({ triggered_by: "initialization" }).catch(
+            (e) => logger.debug(`Failed to track package download: ${e}`)
+          );
+        }, 0);
+      }
     }
   }
   _checkTelemetryDisabled() {
@@ -3090,47 +3118,65 @@ var Telemetry = class _Telemetry {
           break;
         case "session-only":
         default:
-          this._currUserId = `session-${generateUUID()}`;
-          logger.debug(
-            `Using session-based user ID (${this._runtimeEnvironment} environment)`
-          );
+          try {
+            this._currUserId = `session-${generateUUID()}`;
+          } catch (uuidError) {
+            this._currUserId = `session-${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+          }
           break;
       }
-      if (this._storageCapability === "filesystem" && this._currUserId) {
-        this._trackPackageDownloadInternal(this._currUserId, {
-          triggered_by: "user_id_property"
-        }).catch((e) => logger.debug(`Failed to track package download: ${e}`));
-      }
     } catch (e) {
-      logger.debug(`Failed to get/create user ID: ${e}`);
       this._currUserId = this.UNKNOWN_USER_ID;
     }
     return this._currUserId;
   }
   /**
    * Get or create user ID from filesystem (Node.js/Bun)
+   * Falls back to session ID if filesystem operations fail
    */
   _getUserIdFromFilesystem() {
-    const fs2 = require("fs");
-    const os = require("os");
-    const path2 = require("path");
-    if (!this._userIdPath) {
-      this._userIdPath = path2.join(
-        this._getCacheHome(os, path2),
-        "mcp_use_3",
-        "telemetry_user_id"
-      );
-    }
-    const isFirstTime = !fs2.existsSync(this._userIdPath);
-    if (isFirstTime) {
-      logger.debug(`Creating user ID path: ${this._userIdPath}`);
-      fs2.mkdirSync(path2.dirname(this._userIdPath), { recursive: true });
-      const newUserId = generateUUID();
-      fs2.writeFileSync(this._userIdPath, newUserId);
-      logger.debug(`User ID path created: ${this._userIdPath}`);
-      return newUserId;
+    try {
+      let fs2, os, path2;
+      try {
+        fs2 = require("fs");
+        os = require("os");
+        path2 = require("path");
+      } catch (requireError) {
+        try {
+          const sessionId = `session-${generateUUID()}`;
+          return sessionId;
+        } catch (uuidError) {
+          return `session-${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+        }
+      }
+      if (!this._userIdPath) {
+        this._userIdPath = path2.join(
+          this._getCacheHome(os, path2),
+          "mcp_use_3",
+          "telemetry_user_id"
+        );
+      }
+      const isFirstTime = !fs2.existsSync(this._userIdPath);
+      if (isFirstTime) {
+        fs2.mkdirSync(path2.dirname(this._userIdPath), { recursive: true });
+        let newUserId;
+        try {
+          newUserId = generateUUID();
+        } catch (uuidError) {
+          newUserId = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+        }
+        fs2.writeFileSync(this._userIdPath, newUserId);
+        return newUserId;
+      }
+      const userId = fs2.readFileSync(this._userIdPath, "utf-8").trim();
+      return userId;
+    } catch (e) {
+      try {
+        return `session-${generateUUID()}`;
+      } catch (uuidError) {
+        return `session-${Date.now()}-${secureRandomString()}`;
+      }
     }
-    return fs2.readFileSync(this._userIdPath, "utf-8").trim();
   }
   /**
    * Get or create user ID from localStorage (Browser)
@@ -3139,14 +3185,22 @@ var Telemetry = class _Telemetry {
     try {
       let userId = localStorage.getItem(USER_ID_STORAGE_KEY);
       if (!userId) {
-        userId = generateUUID();
+        try {
+          userId = generateUUID();
+        } catch (uuidError) {
+          userId = `${Date.now()}-${secureRandomString()}`;
+        }
         localStorage.setItem(USER_ID_STORAGE_KEY, userId);
-        logger.debug(`Created new browser user ID`);
       }
       return userId;
     } catch (e) {
-      logger.debug(`localStorage access failed: ${e}`);
-      return `session-${generateUUID()}`;
+      let sessionId;
+      try {
+        sessionId = `session-${generateUUID()}`;
+      } catch (uuidError) {
+        sessionId = `session-${Date.now()}-${secureRandomString()}`;
+      }
+      return sessionId;
     }
   }
   _getCacheHome(os, path2) {
@@ -3175,6 +3229,7 @@ var Telemetry = class _Telemetry {
     if (!this._posthogNodeClient && !this._posthogBrowserClient && !this._scarfClient) {
       return;
     }
+    const currentUserId = this.userId;
     const properties = { ...event.properties };
     properties.mcp_use_version = getPackageVersion();
     properties.language = "typescript";
@@ -3182,9 +3237,8 @@ var Telemetry = class _Telemetry {
     properties.runtime = this._runtimeEnvironment;
     if (this._posthogNodeClient) {
       try {
-        logger.debug(`CAPTURE: PostHog Node Event ${event.name}`);
         this._posthogNodeClient.capture({
-          distinctId: this.userId,
+          distinctId: currentUserId,
           event: event.name,
           properties
         });
@@ -3194,10 +3248,9 @@ var Telemetry = class _Telemetry {
     }
     if (this._posthogBrowserClient) {
       try {
-        logger.debug(`CAPTURE: PostHog Browser Event ${event.name}`);
         this._posthogBrowserClient.capture(event.name, {
           ...properties,
-          distinct_id: this.userId
+          distinct_id: currentUserId
         });
       } catch (e) {
         logger.debug(
@@ -3209,7 +3262,7 @@ var Telemetry = class _Telemetry {
       try {
         const scarfProperties = {
           ...properties,
-          user_id: this.userId,
+          user_id: currentUserId,
           event: event.name
         };
         await this._scarfClient.logEvent(scarfProperties);
@@ -5033,6 +5086,7 @@ var SseConnectionManager = class extends ConnectionManager {
   url;
   opts;
   _transport = null;
+  reinitializing = false;
   /**
    * Create an SSE connection manager.
    *
@@ -5045,12 +5099,53 @@ var SseConnectionManager = class extends ConnectionManager {
     this.opts = opts;
   }
   /**
-   * Spawn a new `SSEClientTransport` and start the connection.
+   * Spawn a new `SSEClientTransport` and wrap it with 404 handling.
+   * Per MCP spec, clients MUST re-initialize when receiving 404 for stale sessions.
    */
   async establishConnection() {
-    this._transport = new import_sse.SSEClientTransport(this.url, this.opts);
+    const transport = new import_sse.SSEClientTransport(this.url, this.opts);
+    const originalSend = transport.send.bind(transport);
+    transport.send = async (message) => {
+      const sendMessage = /* @__PURE__ */ __name(async (msg) => {
+        if (Array.isArray(msg)) {
+          for (const singleMsg of msg) {
+            await originalSend(singleMsg);
+          }
+        } else {
+          await originalSend(msg);
+        }
+      }, "sendMessage");
+      try {
+        await sendMessage(message);
+      } catch (error) {
+        if (error?.code === 404 && transport.sessionId && !this.reinitializing) {
+          logger.warn(
+            `[SSE] Session not found (404), re-initializing per MCP spec...`
+          );
+          this.reinitializing = true;
+          try {
+            transport.sessionId = void 0;
+            await this.reinitialize(transport);
+            logger.info(`[SSE] Re-initialization successful, retrying request`);
+            await sendMessage(message);
+          } finally {
+            this.reinitializing = false;
+          }
+        } else {
+          throw error;
+        }
+      }
+    };
+    this._transport = transport;
     logger.debug(`${this.constructor.name} connected successfully`);
-    return this._transport;
+    return transport;
+  }
+  /**
+   * Re-initialize the transport with a new session
+   * This is called when the server returns 404 for a stale session
+   */
+  async reinitialize(transport) {
+    logger.debug(`[SSE] Re-initialization triggered`);
   }
   /**
    * Close the underlying transport and clean up resources.
@@ -5079,6 +5174,7 @@ var HttpConnector = class extends BaseConnector {
   sseReadTimeout;
   clientInfo;
   preferSse;
+  disableSseFallback;
   transportType = null;
   streamableTransport = null;
   constructor(baseUrl, opts = {}) {
@@ -5095,6 +5191,7 @@ var HttpConnector = class extends BaseConnector {
       version: "1.0.0"
     };
     this.preferSse = opts.preferSse ?? false;
+    this.disableSseFallback = opts.disableSseFallback ?? false;
   }
   /** Establish connection to the MCP implementation via HTTP (streamable or SSE). */
   async connect() {
@@ -5151,6 +5248,13 @@ var HttpConnector = class extends BaseConnector {
         authError.code = 401;
         throw authError;
       }
+      if (this.disableSseFallback) {
+        logger.info("SSE fallback disabled - failing connection");
+        await this.cleanupResources();
+        throw new Error(
+          `Streamable HTTP connection failed: ${fallbackReason}. SSE fallback is disabled.`
+        );
+      }
       logger.info("\u{1F504} Falling back to SSE transport...");
       try {
         await this.connectWithSse(baseUrl);
@@ -5517,6 +5621,8 @@ function createConnectorFromConfig(serverConfig, connectorOptions) {
       authToken: serverConfig.auth_token || serverConfig.authToken,
       // Only force SSE if explicitly requested
       preferSse: serverConfig.preferSse || transport === "sse",
+      // Disable SSE fallback if explicitly disabled in config
+      disableSseFallback: serverConfig.disableSseFallback,
       ...connectorOptions
     });
   }
@@ -9276,7 +9382,9 @@ var BrowserMCPClient = class _BrowserMCPClient extends BaseMCPClient {
       wrapTransport,
       clientOptions,
       samplingCallback,
-      elicitationCallback
+      elicitationCallback,
+      disableSseFallback,
+      preferSse
     } = serverConfig;
     if (!url) {
       throw new Error("Server URL is required");
@@ -9292,8 +9400,12 @@ var BrowserMCPClient = class _BrowserMCPClient extends BaseMCPClient {
       // ← Pass client options (capabilities, etc.) to connector
       samplingCallback,
       // ← Pass sampling callback to connector
-      elicitationCallback
+      elicitationCallback,
       // ← Pass elicitation callback to connector
+      disableSseFallback,
+      // ← Disable automatic SSE fallback
+      preferSse
+      // ← Use SSE transport directly
     };
     if (clientOptions) {
       console.log(
@@ -9395,6 +9507,11 @@ function useMcp(options) {
       if (clientRef.current) {
         try {
           const serverName = "inspector-server";
+          const session = clientRef.current.getSession(serverName);
+          if (session && session._healthCheckCleanup) {
+            session._healthCheckCleanup();
+            session._healthCheckCleanup = null;
+          }
           await clientRef.current.closeSession(serverName);
         } catch (err) {
           if (!quiet) addLog("warn", "Error closing session:", err);
@@ -9496,7 +9613,12 @@ function useMcp(options) {
         const serverName = "inspector-server";
         const serverConfig = {
           url,
-          transport: transportTypeParam === "sse" ? "http" : transportTypeParam
+          transport: transportTypeParam === "sse" ? "http" : transportTypeParam,
+          // Disable SSE fallback when using explicit HTTP transport (not SSE)
+          // This prevents automatic HTTP → SSE fallback at the connector level
+          disableSseFallback: transportTypeParam === "http",
+          // Use SSE transport when explicitly requested
+          preferSse: transportTypeParam === "sse"
         };
         if (customHeaders && Object.keys(customHeaders).length > 0) {
           serverConfig.headers = customHeaders;
@@ -9534,9 +9656,25 @@ function useMcp(options) {
           serverName,
           false
         );
-        if (onNotification) {
-          session.on("notification", onNotification);
-        }
+        session.on("notification", (notification) => {
+          onNotification?.(notification);
+          if (notification.method === "notifications/tools/list_changed") {
+            addLog("info", "Tools list changed, auto-refreshing...");
+            refreshTools().catch(
+              (err) => addLog("warn", "Auto-refresh tools failed:", err)
+            );
+          } else if (notification.method === "notifications/resources/list_changed") {
+            addLog("info", "Resources list changed, auto-refreshing...");
+            refreshResources().catch(
+              (err) => addLog("warn", "Auto-refresh resources failed:", err)
+            );
+          } else if (notification.method === "notifications/prompts/list_changed") {
+            addLog("info", "Prompts list changed, auto-refreshing...");
+            refreshPrompts().catch(
+              (err) => addLog("warn", "Auto-refresh prompts failed:", err)
+            );
+          }
+        });
         await session.initialize();
         addLog("info", "\u2705 Successfully connected to MCP server");
         addLog("info", "Server info:", session.connector.serverInfo);
@@ -9552,6 +9690,63 @@ function useMcp(options) {
         );
         setState("ready");
         successfulTransportRef.current = transportTypeParam;
+        const setupConnectionMonitoring = /* @__PURE__ */ __name(() => {
+          let healthCheckInterval = null;
+          let lastSuccessfulCheck = Date.now();
+          const HEALTH_CHECK_INTERVAL = 1e4;
+          const HEALTH_CHECK_TIMEOUT = 3e4;
+          const checkConnectionHealth = /* @__PURE__ */ __name(async () => {
+            if (!isMountedRef.current || stateRef.current !== "ready") {
+              if (healthCheckInterval) {
+                clearInterval(healthCheckInterval);
+                healthCheckInterval = null;
+              }
+              return;
+            }
+            try {
+              await session.connector.listTools();
+              lastSuccessfulCheck = Date.now();
+            } catch (err) {
+              const timeSinceLastSuccess = Date.now() - lastSuccessfulCheck;
+              if (timeSinceLastSuccess > HEALTH_CHECK_TIMEOUT) {
+                addLog(
+                  "warn",
+                  `Connection appears to be broken (no response for ${Math.round(timeSinceLastSuccess / 1e3)}s), attempting to reconnect...`
+                );
+                if (healthCheckInterval) {
+                  clearInterval(healthCheckInterval);
+                  healthCheckInterval = null;
+                }
+                if (autoReconnectRef.current && isMountedRef.current) {
+                  setState("discovering");
+                  addLog("info", "Auto-reconnecting to MCP server...");
+                  setTimeout(
+                    () => {
+                      if (isMountedRef.current && stateRef.current === "discovering") {
+                        connect();
+                      }
+                    },
+                    typeof autoReconnectRef.current === "number" ? autoReconnectRef.current : DEFAULT_RECONNECT_DELAY
+                  );
+                }
+              }
+            }
+          }, "checkConnectionHealth");
+          healthCheckInterval = setInterval(
+            checkConnectionHealth,
+            HEALTH_CHECK_INTERVAL
+          );
+          return () => {
+            if (healthCheckInterval) {
+              clearInterval(healthCheckInterval);
+              healthCheckInterval = null;
+            }
+          };
+        }, "setupConnectionMonitoring");
+        if (autoReconnect) {
+          const cleanup = setupConnectionMonitoring();
+          session._healthCheckCleanup = cleanup;
+        }
         Tel.getInstance().trackUseMcpConnection({
           url,
           transportType: transportTypeParam,
@@ -9903,6 +10098,70 @@ function useMcp(options) {
       throw err;
     }
   }, [state]);
+  const refreshTools = (0, import_react.useCallback)(async () => {
+    if (stateRef.current !== "ready" || !clientRef.current) {
+      addLog("debug", "Cannot refresh tools - client not ready");
+      return;
+    }
+    addLog("debug", "Refreshing tools list");
+    try {
+      const serverName = "inspector-server";
+      const session = clientRef.current.getSession(serverName);
+      if (!session) {
+        addLog("warn", "No active session found for tools refresh");
+        return;
+      }
+      const toolsResult = await session.connector.listTools();
+      setTools(toolsResult || []);
+      addLog("info", "Tools list refreshed successfully");
+    } catch (err) {
+      addLog("warn", "Failed to refresh tools:", err);
+    }
+  }, [addLog]);
+  const refreshResources = (0, import_react.useCallback)(async () => {
+    if (stateRef.current !== "ready" || !clientRef.current) {
+      addLog("debug", "Cannot refresh resources - client not ready");
+      return;
+    }
+    addLog("debug", "Refreshing resources list");
+    try {
+      const serverName = "inspector-server";
+      const session = clientRef.current.getSession(serverName);
+      if (!session) {
+        addLog("warn", "No active session found for resources refresh");
+        return;
+      }
+      const resourcesResult = await session.connector.listAllResources();
+      setResources(resourcesResult.resources || []);
+      addLog("info", "Resources list refreshed successfully");
+    } catch (err) {
+      addLog("warn", "Failed to refresh resources:", err);
+    }
+  }, [addLog]);
+  const refreshPrompts = (0, import_react.useCallback)(async () => {
+    if (stateRef.current !== "ready" || !clientRef.current) {
+      addLog("debug", "Cannot refresh prompts - client not ready");
+      return;
+    }
+    addLog("debug", "Refreshing prompts list");
+    try {
+      const serverName = "inspector-server";
+      const session = clientRef.current.getSession(serverName);
+      if (!session) {
+        addLog("warn", "No active session found for prompts refresh");
+        return;
+      }
+      const promptsResult = await session.connector.listPrompts();
+      setPrompts(promptsResult.prompts || []);
+      addLog("info", "Prompts list refreshed successfully");
+    } catch (err) {
+      addLog("warn", "Failed to refresh prompts:", err);
+    }
+  }, [addLog]);
+  const refreshAll = (0, import_react.useCallback)(async () => {
+    addLog("info", "Refreshing all lists (tools, resources, prompts)");
+    await Promise.all([refreshTools(), refreshResources(), refreshPrompts()]);
+  }, [refreshTools, refreshResources, refreshPrompts, addLog]);
   const getPrompt = (0, import_react.useCallback)(
     async (name, args) => {
       if (stateRef.current !== "ready" || !clientRef.current) {
@@ -10054,6 +10313,10 @@ function useMcp(options) {
     listResources,
     listPrompts,
     getPrompt,
+    refreshTools,
+    refreshResources,
+    refreshPrompts,
+    refreshAll,
     retry,
     disconnect,
     authenticate,
@@ -10995,7 +11258,7 @@ function McpUseProvider({
 }
 __name(McpUseProvider, "McpUseProvider");
 
-// src/client/prompts.ts
+// src/agents/prompts/index.ts
 var PROMPTS = {
   CODE_MODE: CODE_MODE_AGENT_PROMPT
 };

package/dist/index.js

@@ -9,38 +9,38 @@ import {
   streamEventsToAISDKWithTools
 } from "./chunk-LGDFGYRL.js";
 import "./chunk-GXNAXUDI.js";
-import "./chunk-ZFZPZ4GE.js";
+import {
+  PROMPTS
+} from "./chunk-V77WS6CS.js";
 import {
   AcquireActiveMCPServerTool,
   AddMCPServerFromConfigTool,
-  BaseCodeExecutor,
   ConnectMCPServerTool,
-  E2BCodeExecutor,
   ListMCPServersTool,
   MCPAgent,
-  MCPClient,
   ObservabilityManager,
   ReleaseMCPServerConnectionTool,
   RemoteAgent,
   ServerManager,
-  StdioConnector,
-  VMCodeExecutor,
   createLLMFromString,
   getSupportedProviders,
-  isVMAvailable,
   isValidLLMString,
-  loadConfigFile,
   parseLLMString
-} from "./chunk-5RTMAOZ6.js";
+} from "./chunk-A4QJRN7Z.js";
 import "./chunk-JRGQRPTN.js";
+import {
+  BaseCodeExecutor,
+  E2BCodeExecutor,
+  MCPClient,
+  StdioConnector,
+  VMCodeExecutor,
+  isVMAvailable,
+  loadConfigFile
+} from "./chunk-QPIDKGV4.js";
 import {
   BaseAdapter
 } from "./chunk-MFSO5PUW.js";
 import "./chunk-JQKKMUCT.js";
-import {
-  PROMPTS
-} from "./chunk-GVU7C2ZD.js";
-import "./chunk-JZNXOM7C.js";
 import {
   ErrorBoundary,
   Image,
@@ -52,30 +52,28 @@ import {
   useWidgetProps,
   useWidgetState,
   useWidgetTheme
-} from "./chunk-X7JKFBPN.js";
-import "./chunk-EBSNALCB.js";
+} from "./chunk-Y2HHHJQB.js";
+import "./chunk-VRHAF2WT.js";
 import {
+  BaseConnector,
   HttpConnector,
   MCPSession
-} from "./chunk-TAEHPLGV.js";
-import {
-  BrowserOAuthClientProvider,
-  onMcpAuthorization
-} from "./chunk-J75I2C26.js";
-import {
-  BaseConnector
-} from "./chunk-XKTBHYNM.js";
+} from "./chunk-GN5HOAV3.js";
 import {
   Tel,
   Telemetry,
   VERSION,
   getPackageVersion,
   setTelemetrySource
-} from "./chunk-JPKFN73V.js";
+} from "./chunk-ZLZOOXMJ.js";
 import {
   Logger,
   logger
 } from "./chunk-FRUZDWXH.js";
+import {
+  BrowserOAuthClientProvider,
+  onMcpAuthorization
+} from "./chunk-J75I2C26.js";
 import {
   __name
 } from "./chunk-3GQAWCBQ.js";

package/dist/notifications-FLGIFS56.js

@@ -0,0 +1,9 @@
+import {
+  sendNotificationToAll,
+  sendNotificationToSession
+} from "./chunk-UWWLWLS2.js";
+import "./chunk-3GQAWCBQ.js";
+export {
+  sendNotificationToAll,
+  sendNotificationToSession
+};