mcp-use 1.11.0-canary.8 → 1.11.0

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":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACb,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,gBAAgB,EAGjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM1D,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC,eAAe,CAAC,CAAC;AAC9B,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,KAAK,CAAC;AAG5C,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;IACtE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KACnC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,uBAAuB,GAAG,sBAAsB,KACrD,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5B;AAGD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAE7E;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC1C;;;OAGG;WACW,iBAAiB,IAAI,MAAM;IAIlC,QAAQ,EAAE,OAAO,CAAS;IACjC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,mBAAmB,CAAqC;IAChE,OAAO,CAAC,mBAAmB,CAGC;IAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAC3C,OAAO,CAAC,iBAAiB,CAAC,CAEQ;IAClC,OAAO,CAAC,oBAAoB,CAAC,CAEF;gBAGzB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrC,OAAO,CAAC,EAAE,gBAAgB;IA2C5B,OAAO,CAAC,gBAAgB;WAkBV,QAAQ,CACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACzB,SAAS;WAIE,cAAc,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,GACzB,SAAS;IAIZ;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQzC;;;OAGG;IACH,SAAS,CAAC,yBAAyB,CACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAChC,aAAa;IAOhB,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,mBAAmB;IAkE3B;;OAEG;IACU,WAAW,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC;IAc3B;;OAEG;IACU,WAAW,CACtB,KAAK,GAAE,MAAW,EAClB,WAAW,GAAE,OAAO,GAAG,cAAc,GAAG,MAAe,GACtD,OAAO,CAAC,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;IAUjE;;OAEG;IACI,cAAc,IAAI,MAAM,EAAE;IAOjC;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAUpC"}

package/dist/src/client.js

@@ -0,0 +1,21 @@
+import {
+  BaseCodeExecutor,
+  E2BCodeExecutor,
+  MCPClient,
+  VMCodeExecutor,
+  isVMAvailable
+} 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

@@ -482,6 +482,7 @@ var SseConnectionManager = class extends ConnectionManager {
   url;
   opts;
   _transport = null;
+  reinitializing = false;
   /**
    * Create an SSE connection manager.
    *
@@ -494,12 +495,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.
@@ -876,13 +918,27 @@ function generateUUID() {
 __name(generateUUID, "generateUUID");
 
 // src/version.ts
-var VERSION = "1.11.0-canary.8";
+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 {
@@ -1014,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() {
@@ -1144,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)
@@ -1193,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) {
@@ -1229,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";
@@ -1236,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
         });
@@ -1248,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(
@@ -1263,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);
@@ -2001,6 +2096,7 @@ var HttpConnector = class extends BaseConnector {
   sseReadTimeout;
   clientInfo;
   preferSse;
+  disableSseFallback;
   transportType = null;
   streamableTransport = null;
   constructor(baseUrl, opts = {}) {
@@ -2017,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() {
@@ -2073,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);
@@ -2714,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");
@@ -2730,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(
@@ -3065,6 +3175,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);
@@ -3166,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;
@@ -3204,9 +3324,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);
@@ -3222,6 +3358,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,
@@ -3573,6 +3766,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) {
@@ -3724,6 +3981,10 @@ function useMcp(options) {
     listResources,
     listPrompts,
     getPrompt,
+    refreshTools,
+    refreshResources,
+    refreshPrompts,
+    refreshAll,
     retry,
     disconnect,
     authenticate,

package/dist/src/react/index.js

@@ -9,19 +9,18 @@ import {
   useWidgetProps,
   useWidgetState,
   useWidgetTheme
-} from "../../chunk-X7JKFBPN.js";
-import "../../chunk-EBSNALCB.js";
-import "../../chunk-TAEHPLGV.js";
-import {
-  onMcpAuthorization
-} from "../../chunk-J75I2C26.js";
-import "../../chunk-XKTBHYNM.js";
+} from "../../chunk-Y2HHHJQB.js";
+import "../../chunk-VRHAF2WT.js";
+import "../../chunk-GN5HOAV3.js";
 import {
   Tel,
   Telemetry,
   setTelemetrySource
-} from "../../chunk-JPKFN73V.js";
+} from "../../chunk-ZLZOOXMJ.js";
 import "../../chunk-FRUZDWXH.js";
+import {
+  onMcpAuthorization
+} from "../../chunk-J75I2C26.js";
 import "../../chunk-3GQAWCBQ.js";
 export {
   Tel as BrowserTelemetry,