mcp-use 1.11.0-canary.9 → 1.11.0

package/dist/src/client.cjs

@@ -34,6 +34,7 @@ __export(client_exports, {
   BaseCodeExecutor: () => BaseCodeExecutor,
   E2BCodeExecutor: () => E2BCodeExecutor,
   MCPClient: () => MCPClient,
+  MCPSession: () => MCPSession,
   VMCodeExecutor: () => VMCodeExecutor,
   isVMAvailable: () => isVMAvailable
 });
@@ -941,13 +942,27 @@ function generateUUID() {
 __name(generateUUID, "generateUUID");
 
 // src/version.ts
-var VERSION = "1.11.0-canary.9";
+var VERSION = "1.11.0";
 function getPackageVersion() {
   return VERSION;
 }
 __name(getPackageVersion, "getPackageVersion");
 
 // 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 {
@@ -1079,12 +1094,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() {
@@ -1209,47 +1238,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)
@@ -1258,14 +1305,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) {
@@ -1294,6 +1349,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";
@@ -1301,9 +1357,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
         });
@@ -1313,10 +1368,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(
@@ -1328,7 +1382,7 @@ var Telemetry = class _Telemetry {
       try {
         const scarfProperties = {
           ...properties,
-          user_id: this.userId,
+          user_id: currentUserId,
           event: event.name
         };
         await this._scarfClient.logEvent(scarfProperties);
@@ -3142,6 +3196,7 @@ var HttpConnector = class extends BaseConnector {
   sseReadTimeout;
   clientInfo;
   preferSse;
+  disableSseFallback;
   transportType = null;
   streamableTransport = null;
   constructor(baseUrl, opts = {}) {
@@ -3158,6 +3213,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() {
@@ -3214,6 +3270,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);
@@ -3578,6 +3641,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/src/client.d.ts

@@ -39,6 +39,8 @@ export interface MCPClientOptions {
     elicitationCallback?: (params: ElicitRequestFormParams | ElicitRequestURLParams) => Promise<ElicitResult>;
 }
 export { BaseCodeExecutor, E2BCodeExecutor, isVMAvailable, VMCodeExecutor, } from "./client/codeExecutor.js";
+export { MCPSession } from "./session.js";
+export type { CallToolResult, Notification, Root, Tool } from "./session.js";
 /**
  * Node.js-specific MCPClient implementation
  *

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/src/client.js

@@ -4,17 +4,18 @@ import {
   MCPClient,
   VMCodeExecutor,
   isVMAvailable
-} from "../chunk-WW3A2EKQ.js";
-import "../chunk-M7WATKYM.js";
-import "../chunk-HU2DGJ5J.js";
-import "../chunk-XEFWIBQF.js";
-import "../chunk-Q5LZL6BH.js";
+} from "../chunk-QPIDKGV4.js";
+import {
+  MCPSession
+} from "../chunk-GN5HOAV3.js";
+import "../chunk-ZLZOOXMJ.js";
 import "../chunk-FRUZDWXH.js";
 import "../chunk-3GQAWCBQ.js";
 export {
   BaseCodeExecutor,
   E2BCodeExecutor,
   MCPClient,
+  MCPSession,
   VMCodeExecutor,
   isVMAvailable
 };

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKjE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAGpE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAC/C,aAAa,CAwBf"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKjE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAGpE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAC/C,aAAa,CA0Bf"}

package/dist/src/connectors/http.d.ts

@@ -10,6 +10,7 @@ export interface HttpConnectorOptions extends ConnectorInitOptions {
         version: string;
     };
     preferSse?: boolean;
+    disableSseFallback?: boolean;
 }
 export declare class HttpConnector extends BaseConnector {
     private readonly baseUrl;
@@ -18,6 +19,7 @@ export declare class HttpConnector extends BaseConnector {
     private readonly sseReadTimeout;
     private readonly clientInfo;
     private readonly preferSse;
+    private readonly disableSseFallback;
     private transportType;
     private streamableTransport;
     constructor(baseUrl: string, opts?: HttpConnectorOptions);

package/dist/src/connectors/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connectors/http.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,mBAAmB,CAA8C;gBAE7D,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAkB5D,mFAAmF;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAqHhB,yBAAyB;YAkJzB,cAAc;IAqE5B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7C;IAED;;OAEG;IACH,gBAAgB,IAAI,iBAAiB,GAAG,KAAK,GAAG,IAAI;CAGrD"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connectors/http.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,mBAAmB,CAA8C;gBAE7D,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAmB5D,mFAAmF;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YA8HhB,yBAAyB;YAkJzB,cAAc;IAqE5B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7C;IAED;;OAEG;IACH,gBAAgB,IAAI,iBAAiB,GAAG,KAAK,GAAG,IAAI;CAGrD"}

package/dist/src/react/index.cjs

@@ -918,13 +918,27 @@ function generateUUID() {
 __name(generateUUID, "generateUUID");
 
 // src/version.ts
-var VERSION = "1.11.0-canary.9";
+var VERSION = "1.11.0";
 function getPackageVersion() {
   return VERSION;
 }
 __name(getPackageVersion, "getPackageVersion");
 
 // 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 {
@@ -1056,12 +1070,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() {
@@ -1186,47 +1214,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()}-${secureRandomString()}`;
+      }
     }
-    return fs.readFileSync(this._userIdPath, "utf-8").trim();
   }
   /**
    * Get or create user ID from localStorage (Browser)
@@ -1235,14 +1281,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, path) {
@@ -1271,6 +1325,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";
@@ -1278,9 +1333,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
         });
@@ -1290,10 +1344,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(
@@ -1305,7 +1358,7 @@ var Telemetry = class _Telemetry {
       try {
         const scarfProperties = {
           ...properties,
-          user_id: this.userId,
+          user_id: currentUserId,
           event: event.name
         };
         await this._scarfClient.logEvent(scarfProperties);
@@ -2043,6 +2096,7 @@ var HttpConnector = class extends BaseConnector {
   sseReadTimeout;
   clientInfo;
   preferSse;
+  disableSseFallback;
   transportType = null;
   streamableTransport = null;
   constructor(baseUrl, opts = {}) {
@@ -2059,6 +2113,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() {
@@ -2115,6 +2170,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);
@@ -2756,7 +2818,9 @@ var BrowserMCPClient = class _BrowserMCPClient extends BaseMCPClient {
       wrapTransport,
       clientOptions,
       samplingCallback,
-      elicitationCallback
+      elicitationCallback,
+      disableSseFallback,
+      preferSse
     } = serverConfig;
     if (!url) {
       throw new Error("Server URL is required");
@@ -2772,8 +2836,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(
@@ -3213,7 +3281,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/src/react/index.js

@@ -9,19 +9,18 @@ import {
   useWidgetProps,
   useWidgetState,
   useWidgetTheme
-} from "../../chunk-F3BZFJCD.js";
-import "../../chunk-5QFJZ7H3.js";
-import {
-  onMcpAuthorization
-} from "../../chunk-J75I2C26.js";
-import "../../chunk-HU2DGJ5J.js";
-import "../../chunk-XEFWIBQF.js";
+} from "../../chunk-Y2HHHJQB.js";
+import "../../chunk-VRHAF2WT.js";
+import "../../chunk-GN5HOAV3.js";
 import {
   Tel,
   Telemetry,
   setTelemetrySource
-} from "../../chunk-Q5LZL6BH.js";
+} from "../../chunk-ZLZOOXMJ.js";
 import "../../chunk-FRUZDWXH.js";
+import {
+  onMcpAuthorization
+} from "../../chunk-J75I2C26.js";
 import "../../chunk-3GQAWCBQ.js";
 export {
   Tel as BrowserTelemetry,

package/dist/src/react/useMcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMcp.d.ts","sourceRoot":"","sources":["../../../src/react/useMcp.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAgwC3D"}
+{"version":3,"file":"useMcp.d.ts","sourceRoot":"","sources":["../../../src/react/useMcp.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAqwC3D"}