mcp-use 1.11.0-canary.16 → 1.11.0-canary.18

package/dist/{chunk-GVHS2DDJ.js → chunk-6TCXBLDE.js}

@@ -1,6 +1,6 @@
 import {
   MCPClient
-} from "./chunk-FMK46JYP.js";
+} from "./chunk-I3NZCYBR.js";
 import {
   LangChainAdapter
 } from "./chunk-MFSO5PUW.js";
@@ -8,7 +8,7 @@ import {
   Telemetry,
   extractModelInfo,
   getPackageVersion
-} from "./chunk-2FOTPDUJ.js";
+} from "./chunk-MIY5EBAT.js";
 import {
   logger
 } from "./chunk-FRUZDWXH.js";

package/dist/{chunk-RU7FIJVM.js → chunk-BUUAJ4ZA.js}

@@ -4,7 +4,7 @@ import {
 import {
   Telemetry,
   generateUUID
-} from "./chunk-2FOTPDUJ.js";
+} from "./chunk-MIY5EBAT.js";
 import {
   __name
 } from "./chunk-3GQAWCBQ.js";

package/dist/{chunk-76F72Y73.js → chunk-DKK3OEIY.js}

@@ -1,6 +1,6 @@
 import {
   CODE_MODE_AGENT_PROMPT
-} from "./chunk-FMK46JYP.js";
+} from "./chunk-I3NZCYBR.js";
 import {
   __name
 } from "./chunk-3GQAWCBQ.js";

package/dist/{chunk-FMK46JYP.js → chunk-I3NZCYBR.js}

@@ -4,11 +4,11 @@ import {
   ConnectionManager,
   HttpConnector,
   MCPSession
-} from "./chunk-MGYJYTTX.js";
+} from "./chunk-M6HG2X4Q.js";
 import {
   Tel,
   getPackageVersion
-} from "./chunk-2FOTPDUJ.js";
+} from "./chunk-MIY5EBAT.js";
 import {
   logger
 } from "./chunk-FRUZDWXH.js";
@@ -1024,6 +1024,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
     });
   }

package/dist/{chunk-MGYJYTTX.js → chunk-M6HG2X4Q.js}

@@ -1,7 +1,7 @@
 import {
   Tel,
   Telemetry
-} from "./chunk-2FOTPDUJ.js";
+} from "./chunk-MIY5EBAT.js";
 import {
   logger
 } from "./chunk-FRUZDWXH.js";
@@ -1111,6 +1111,7 @@ var HttpConnector = class extends BaseConnector {
   sseReadTimeout;
   clientInfo;
   preferSse;
+  disableSseFallback;
   transportType = null;
   streamableTransport = null;
   constructor(baseUrl, opts = {}) {
@@ -1127,6 +1128,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() {
@@ -1183,6 +1185,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);

package/dist/{chunk-2FOTPDUJ.js → chunk-MIY5EBAT.js}

@@ -92,7 +92,7 @@ function generateUUID() {
 __name(generateUUID, "generateUUID");
 
 // src/version.ts
-var VERSION = "1.11.0-canary.16";
+var VERSION = "1.11.0-canary.18";
 function getPackageVersion() {
   return VERSION;
 }
@@ -610,12 +610,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() {
@@ -740,47 +754,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 fs = __require("fs");
-    const os = __require("os");
-    const path = __require("path");
-    if (!this._userIdPath) {
-      this._userIdPath = path.join(
-        this._getCacheHome(os, path),
-        "mcp_use_3",
-        "telemetry_user_id"
-      );
-    }
-    const isFirstTime = !fs.existsSync(this._userIdPath);
-    if (isFirstTime) {
-      logger.debug(`Creating user ID path: ${this._userIdPath}`);
-      fs.mkdirSync(path.dirname(this._userIdPath), { recursive: true });
-      const newUserId = generateUUID();
-      fs.writeFileSync(this._userIdPath, newUserId);
-      logger.debug(`User ID path created: ${this._userIdPath}`);
-      return newUserId;
+    try {
+      let fs, os, path;
+      try {
+        fs = __require("fs");
+        os = __require("os");
+        path = __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 = path.join(
+          this._getCacheHome(os, path),
+          "mcp_use_3",
+          "telemetry_user_id"
+        );
+      }
+      const isFirstTime = !fs.existsSync(this._userIdPath);
+      if (isFirstTime) {
+        fs.mkdirSync(path.dirname(this._userIdPath), { recursive: true });
+        let newUserId;
+        try {
+          newUserId = generateUUID();
+        } catch (uuidError) {
+          newUserId = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+        }
+        fs.writeFileSync(this._userIdPath, newUserId);
+        return newUserId;
+      }
+      const userId = fs.readFileSync(this._userIdPath, "utf-8").trim();
+      return userId;
+    } catch (e) {
+      try {
+        return `session-${generateUUID()}`;
+      } catch (uuidError) {
+        return `session-${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+      }
     }
-    return fs.readFileSync(this._userIdPath, "utf-8").trim();
   }
   /**
    * Get or create user ID from localStorage (Browser)
@@ -789,14 +821,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()}-${Math.random().toString(36).substring(2, 15)}`;
+        }
         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()}-${Math.random().toString(36).substring(2, 15)}`;
+      }
+      return sessionId;
     }
   }
   _getCacheHome(os, path) {
@@ -825,6 +865,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";
@@ -832,9 +873,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
         });
@@ -844,10 +884,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(
@@ -859,7 +898,7 @@ var Telemetry = class _Telemetry {
       try {
         const scarfProperties = {
           ...properties,
-          user_id: this.userId,
+          user_id: currentUserId,
           event: event.name
         };
         await this._scarfClient.logEvent(scarfProperties);

package/dist/{chunk-6AB7U4KA.js → chunk-OD724W55.js}

@@ -1,11 +1,11 @@
 import {
   BaseMCPClient,
   HttpConnector
-} from "./chunk-MGYJYTTX.js";
+} from "./chunk-M6HG2X4Q.js";
 import {
   Tel,
   getPackageVersion
-} from "./chunk-2FOTPDUJ.js";
+} from "./chunk-MIY5EBAT.js";
 import {
   logger
 } from "./chunk-FRUZDWXH.js";
@@ -63,7 +63,9 @@ var BrowserMCPClient = class _BrowserMCPClient extends BaseMCPClient {
       wrapTransport,
       clientOptions,
       samplingCallback,
-      elicitationCallback
+      elicitationCallback,
+      disableSseFallback,
+      preferSse
     } = serverConfig;
     if (!url) {
       throw new Error("Server URL is required");
@@ -79,8 +81,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(

package/dist/{chunk-J56ACHX4.js → chunk-SRXA64QS.js}

@@ -1,9 +1,9 @@
 import {
   BrowserMCPClient
-} from "./chunk-6AB7U4KA.js";
+} from "./chunk-OD724W55.js";
 import {
   Tel
-} from "./chunk-2FOTPDUJ.js";
+} from "./chunk-MIY5EBAT.js";
 import {
   BrowserOAuthClientProvider,
   sanitizeUrl
@@ -207,7 +207,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;

package/dist/index.cjs

@@ -2790,7 +2790,7 @@ __name(generateUUID, "generateUUID");
 init_logging();
 
 // src/version.ts
-var VERSION = "1.11.0-canary.16";
+var VERSION = "1.11.0-canary.18";
 function getPackageVersion() {
   return VERSION;
 }
@@ -2960,12 +2960,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 +3104,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()}-${Math.random().toString(36).substring(2, 15)}`;
+      }
     }
-    return fs2.readFileSync(this._userIdPath, "utf-8").trim();
   }
   /**
    * Get or create user ID from localStorage (Browser)
@@ -3139,14 +3171,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()}-${Math.random().toString(36).substring(2, 15)}`;
+        }
         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()}-${Math.random().toString(36).substring(2, 15)}`;
+      }
+      return sessionId;
     }
   }
   _getCacheHome(os, path2) {
@@ -3175,6 +3215,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 +3223,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 +3234,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 +3248,7 @@ var Telemetry = class _Telemetry {
       try {
         const scarfProperties = {
           ...properties,
-          user_id: this.userId,
+          user_id: currentUserId,
           event: event.name
         };
         await this._scarfClient.logEvent(scarfProperties);
@@ -5121,6 +5160,7 @@ var HttpConnector = class extends BaseConnector {
   sseReadTimeout;
   clientInfo;
   preferSse;
+  disableSseFallback;
   transportType = null;
   streamableTransport = null;
   constructor(baseUrl, opts = {}) {
@@ -5137,6 +5177,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() {
@@ -5193,6 +5234,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);
@@ -5559,6 +5607,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
     });
   }
@@ -9318,7 +9368,9 @@ var BrowserMCPClient = class _BrowserMCPClient extends BaseMCPClient {
       wrapTransport,
       clientOptions,
       samplingCallback,
-      elicitationCallback
+      elicitationCallback,
+      disableSseFallback,
+      preferSse
     } = serverConfig;
     if (!url) {
       throw new Error("Server URL is required");
@@ -9334,8 +9386,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(
@@ -9543,7 +9599,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;