mcp-use 1.9.1-canary.0 → 1.10.0-canary.10

package/dist/src/server/index.js

@@ -2,11 +2,12 @@ import {
   getRequestContext,
   hasRequestContext,
   runWithContext
-} from "../../chunk-5URNFWCQ.js";
+} from "../../chunk-LWVK6RXA.js";
 import {
   createEnhancedContext,
-  findSessionContext
-} from "../../chunk-KHTTBIRP.js";
+  findSessionContext,
+  isValidLogLevel
+} from "../../chunk-BPP5XYP6.js";
 import {
   convertToolResultToResourceResult
 } from "../../chunk-362PI25Z.js";
@@ -15,13 +16,17 @@ import {
 } from "../../chunk-2EYAMIT3.js";
 import "../../chunk-KUEVOU4M.js";
 import {
+  Telemetry,
+  VERSION,
   fsHelpers,
   generateUUID,
   getCwd,
   getEnv,
+  getPackageVersion,
   isDeno,
   pathHelpers
-} from "../../chunk-MTHLLDCX.js";
+} from "../../chunk-6EYDSXO6.js";
+import "../../chunk-34R6SIER.js";
 import {
   __name
 } from "../../chunk-3GQAWCBQ.js";
@@ -30,7 +35,12 @@ import {
 import {
   McpServer as OfficialMcpServer,
   ResourceTemplate as ResourceTemplate2
-} from "@modelcontextprotocol/sdk/server/mcp.js";
+} from "@mcp-use/modelcontextprotocol-sdk/server/mcp.js";
+import {
+  McpError,
+  ErrorCode
+} from "@mcp-use/modelcontextprotocol-sdk/types.js";
+import { z as z2 } from "zod";
 
 // src/server/utils/response-helpers.ts
 function text(content) {
@@ -63,7 +73,109 @@ function image(data, mimeType = "image/png") {
   };
 }
 __name(image, "image");
-function resource(uri, mimeType, text2) {
+function getAudioMimeType(filename) {
+  const ext = filename.split(".").pop()?.toLowerCase();
+  switch (ext) {
+    case "wav":
+      return "audio/wav";
+    case "mp3":
+      return "audio/mpeg";
+    case "ogg":
+      return "audio/ogg";
+    case "m4a":
+      return "audio/mp4";
+    case "webm":
+      return "audio/webm";
+    case "flac":
+      return "audio/flac";
+    case "aac":
+      return "audio/aac";
+    default:
+      return "audio/wav";
+  }
+}
+__name(getAudioMimeType, "getAudioMimeType");
+function arrayBufferToBase64(buffer) {
+  if (isDeno) {
+    const bytes = new Uint8Array(buffer);
+    let binary2 = "";
+    for (let i = 0; i < bytes.length; i++) {
+      binary2 += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary2);
+  } else {
+    return Buffer.from(buffer).toString("base64");
+  }
+}
+__name(arrayBufferToBase64, "arrayBufferToBase64");
+function audio(dataOrPath, mimeType) {
+  const isFilePath = dataOrPath.includes("/") || dataOrPath.includes("\\") || dataOrPath.includes(".");
+  if (isFilePath && dataOrPath.length < 1e3) {
+    return (async () => {
+      const buffer = await fsHelpers.readFile(dataOrPath);
+      const base64Data = arrayBufferToBase64(buffer);
+      const inferredMimeType = mimeType || getAudioMimeType(dataOrPath);
+      return {
+        content: [
+          {
+            type: "audio",
+            data: base64Data,
+            mimeType: inferredMimeType
+          }
+        ],
+        _meta: {
+          mimeType: inferredMimeType,
+          isAudio: true
+        }
+      };
+    })();
+  }
+  const finalMimeType = mimeType || "audio/wav";
+  return {
+    content: [
+      {
+        type: "audio",
+        data: dataOrPath,
+        mimeType: finalMimeType
+      }
+    ],
+    _meta: {
+      mimeType: finalMimeType,
+      isAudio: true
+    }
+  };
+}
+__name(audio, "audio");
+function resource(uri, mimeTypeOrContent, text2) {
+  if (typeof mimeTypeOrContent === "object" && mimeTypeOrContent !== null && "content" in mimeTypeOrContent) {
+    const contentResult = mimeTypeOrContent;
+    let extractedText;
+    let extractedMimeType;
+    if (contentResult._meta && typeof contentResult._meta === "object") {
+      const meta = contentResult._meta;
+      if (meta.mimeType && typeof meta.mimeType === "string") {
+        extractedMimeType = meta.mimeType;
+      }
+    }
+    if (contentResult.content && contentResult.content.length > 0) {
+      const firstContent = contentResult.content[0];
+      if (firstContent.type === "text" && "text" in firstContent) {
+        extractedText = firstContent.text;
+      }
+    }
+    const resourceContent2 = {
+      type: "resource",
+      resource: {
+        uri,
+        ...extractedMimeType && { mimeType: extractedMimeType },
+        ...extractedText && { text: extractedText }
+      }
+    };
+    return {
+      content: [resourceContent2]
+    };
+  }
+  const mimeType = mimeTypeOrContent;
   const resourceContent = {
     type: "resource",
     resource: {
@@ -202,37 +314,12 @@ function binary(base64Data, mimeType) {
 }
 __name(binary, "binary");
 function widget(config) {
-  const {
-    name,
-    data,
-    message,
-    invoking,
-    invoked,
-    widgetAccessible = true,
-    resultCanProduceWidget = true,
-    buildId
-  } = config;
-  const randomId = Math.random().toString(36).substring(2, 15);
-  const buildIdPart = buildId ? `-${buildId}` : "";
-  const uniqueUri = `ui://widget/${name}${buildIdPart}-${randomId}.html`;
-  const metadata = {
-    "openai/outputTemplate": uniqueUri,
-    "openai/widgetAccessible": widgetAccessible,
-    "openai/resultCanProduceWidget": resultCanProduceWidget
-  };
-  if (invoking) {
-    metadata["openai/toolInvocation/invoking"] = invoking;
-  }
-  if (invoked) {
-    metadata["openai/toolInvocation/invoked"] = invoked;
-  }
-  const displayMessage = message || `Displaying ${name}`;
+  const { data, message } = config;
   return {
-    _meta: metadata,
     content: [
       {
         type: "text",
-        text: displayMessage
+        text: message || ""
       }
     ],
     // structuredContent will be injected as window.openai.toolOutput by Apps SDK
@@ -338,7 +425,7 @@ function parseTemplateUri(template, uri) {
   const params = {};
   let regexPattern = template.replace(/[.*+?^$()[\]\\|]/g, "\\$&");
   const paramNames = [];
-  regexPattern = regexPattern.replace(/\\\{([^}]+)\\\}/g, (_, paramName) => {
+  regexPattern = regexPattern.replace(/\{([^}]+)\}/g, (_, paramName) => {
     paramNames.push(paramName);
     return "([^/]+)";
   });
@@ -901,6 +988,7 @@ function createWidgetRegistration(widgetName, metadata, html2, serverConfig, isD
   const props = metadata.inputs || {};
   const description = metadata.description || `Widget: ${widgetName}`;
   const title = metadata.title || widgetName;
+  const exposeAsTool = metadata.exposeAsTool !== void 0 ? metadata.exposeAsTool : true;
   const mcp_connect_domain = serverConfig.serverBaseUrl ? new URL(serverConfig.serverBaseUrl || "").origin : null;
   return {
     name: widgetName,
@@ -916,7 +1004,8 @@ function createWidgetRegistration(widgetName, metadata, html2, serverConfig, isD
         type: "appsSdk",
         props,
         html: html2,
-        dev: isDev
+        dev: isDev,
+        exposeAsTool
       },
       ...metadata._meta || {}
     },
@@ -1196,10 +1285,42 @@ if (container && Component) {
       console.log(`[WIDGETS] Watching resources directory: ${resourcesPath}`);
     }
   };
+  const nodeStubsPlugin = {
+    name: "node-stubs",
+    enforce: "pre",
+    resolveId(id) {
+      if (id === "posthog-node" || id.startsWith("posthog-node/")) {
+        return "\0virtual:posthog-node-stub";
+      }
+      return null;
+    },
+    load(id) {
+      if (id === "\0virtual:posthog-node-stub") {
+        return `
+export class PostHog {
+  constructor() {}
+  capture() {}
+  identify() {}
+  alias() {}
+  flush() { return Promise.resolve(); }
+  shutdown() { return Promise.resolve(); }
+}
+export default PostHog;
+`;
+      }
+      return null;
+    }
+  };
   const viteServer = await createServer({
     root: tempDir,
     base: baseRoute + "/",
-    plugins: [ssrCssPlugin, watchResourcesPlugin, tailwindcss(), react()],
+    plugins: [
+      nodeStubsPlugin,
+      ssrCssPlugin,
+      watchResourcesPlugin,
+      tailwindcss(),
+      react()
+    ],
     resolve: {
       alias: {
         "@": pathHelpers.join(getCwd(), resourcesDir)
@@ -1220,12 +1341,15 @@ if (container && Component) {
     // Explicitly tell Vite to watch files outside root
     // This is needed because widget entry files import from resources directory
     optimizeDeps: {
-      // Don't optimize dependencies that might change
-      exclude: []
+      // Exclude Node.js-only packages from browser bundling
+      // posthog-node is for server-side telemetry and doesn't work in browser
+      exclude: ["posthog-node"]
     },
     ssr: {
       // Force Vite to transform these packages in SSR instead of using external requires
-      noExternal: ["@openai/apps-sdk-ui", "react-router"]
+      noExternal: ["@openai/apps-sdk-ui", "react-router"],
+      // Mark Node.js-only packages as external in SSR mode
+      external: ["posthog-node"]
     },
     define: {
       // Define process.env for SSR context
@@ -1482,25 +1606,31 @@ function setupWidgetRoutes(app, serverConfig) {
 __name(setupWidgetRoutes, "setupWidgetRoutes");
 
 // src/server/widgets/ui-resource-registration.ts
-function uiResourceRegistration(definition) {
+function uiResourceRegistration(server, definition) {
   const displayName = definition.title || definition.name;
+  if (definition.type === "appsSdk" && definition._meta) {
+    server.widgetDefinitions.set(
+      definition.name,
+      definition._meta
+    );
+  }
   let resourceUri;
   let mimeType;
   switch (definition.type) {
     case "externalUrl":
-      resourceUri = generateWidgetUri(definition.widget, this.buildId);
+      resourceUri = generateWidgetUri(definition.widget, server.buildId);
       mimeType = "text/uri-list";
       break;
     case "rawHtml":
-      resourceUri = generateWidgetUri(definition.name, this.buildId);
+      resourceUri = generateWidgetUri(definition.name, server.buildId);
       mimeType = "text/html";
       break;
     case "remoteDom":
-      resourceUri = generateWidgetUri(definition.name, this.buildId);
+      resourceUri = generateWidgetUri(definition.name, server.buildId);
       mimeType = "application/vnd.mcp-ui.remote-dom+javascript";
       break;
     case "appsSdk":
-      resourceUri = generateWidgetUri(definition.name, this.buildId, ".html");
+      resourceUri = generateWidgetUri(definition.name, server.buildId, ".html");
       mimeType = "text/html+skybridge";
       break;
     default:
@@ -1509,12 +1639,12 @@ function uiResourceRegistration(definition) {
       );
   }
   const serverConfig = {
-    serverHost: this.serverHost,
-    serverPort: this.serverPort || 3e3,
-    serverBaseUrl: this.serverBaseUrl,
-    buildId: this.buildId
+    serverHost: server.serverHost,
+    serverPort: server.serverPort || 3e3,
+    serverBaseUrl: server.serverBaseUrl,
+    buildId: server.buildId
   };
-  this.resource({
+  server.resource({
     name: definition.name,
     uri: resourceUri,
     title: definition.title,
@@ -1536,9 +1666,9 @@ function uiResourceRegistration(definition) {
     }, "readCallback")
   });
   if (definition.type === "appsSdk") {
-    const buildIdPart = this.buildId ? `-${this.buildId}` : "";
+    const buildIdPart = server.buildId ? `-${server.buildId}` : "";
     const uriTemplate = `ui://widget/${definition.name}${buildIdPart}-{id}.html`;
-    this.resourceTemplate({
+    server.resourceTemplate({
       name: `${definition.name}-dynamic`,
       resourceTemplate: {
         uriTemplate,
@@ -1563,70 +1693,77 @@ function uiResourceRegistration(definition) {
       }, "readCallback")
     });
   }
-  const toolMetadata = definition._meta || {};
-  if (definition.type === "appsSdk" && definition.appsSdkMetadata) {
-    toolMetadata["openai/outputTemplate"] = resourceUri;
-    const toolMetadataFields = [
-      "openai/toolInvocation/invoking",
-      "openai/toolInvocation/invoked",
-      "openai/widgetAccessible",
-      "openai/resultCanProduceWidget"
-    ];
-    for (const field of toolMetadataFields) {
-      if (definition.appsSdkMetadata[field] !== void 0) {
-        toolMetadata[field] = definition.appsSdkMetadata[field];
+  const widgetMetadata = definition._meta?.["mcp-use/widget"];
+  const exposeAsTool = definition.exposeAsTool ?? widgetMetadata?.exposeAsTool ?? true;
+  if (exposeAsTool) {
+    const toolMetadata = definition._meta || {};
+    if (definition.type === "appsSdk" && definition.appsSdkMetadata) {
+      toolMetadata["openai/outputTemplate"] = resourceUri;
+      const toolMetadataFields = [
+        "openai/toolInvocation/invoking",
+        "openai/toolInvocation/invoked",
+        "openai/widgetAccessible",
+        "openai/resultCanProduceWidget"
+      ];
+      for (const field of toolMetadataFields) {
+        if (definition.appsSdkMetadata[field] !== void 0) {
+          toolMetadata[field] = definition.appsSdkMetadata[field];
+        }
       }
     }
-  }
-  this.tool({
-    name: definition.name,
-    title: definition.title,
-    description: definition.description,
-    inputs: convertPropsToInputs(definition.props),
-    _meta: Object.keys(toolMetadata).length > 0 ? toolMetadata : void 0,
-    cb: /* @__PURE__ */ __name(async (params) => {
-      const uiResource = await createWidgetUIResource(
-        definition,
-        params,
-        serverConfig
-      );
-      if (definition.type === "appsSdk") {
-        const randomId = Math.random().toString(36).substring(2, 15);
-        const uniqueUri = generateWidgetUri(
-          definition.name,
-          this.buildId,
-          ".html",
-          randomId
+    server.tool(
+      {
+        name: definition.name,
+        title: definition.title,
+        description: definition.description,
+        inputs: convertPropsToInputs(definition.props),
+        annotations: definition.toolAnnotations,
+        _meta: Object.keys(toolMetadata).length > 0 ? toolMetadata : void 0
+      },
+      async (params) => {
+        const uiResource = await createWidgetUIResource(
+          definition,
+          params,
+          serverConfig
         );
-        const uniqueToolMetadata = {
-          ...toolMetadata,
-          "openai/outputTemplate": uniqueUri
-        };
+        if (definition.type === "appsSdk") {
+          const randomId = Math.random().toString(36).substring(2, 15);
+          const uniqueUri = generateWidgetUri(
+            definition.name,
+            server.buildId,
+            ".html",
+            randomId
+          );
+          const uniqueToolMetadata = {
+            ...toolMetadata,
+            "openai/outputTemplate": uniqueUri
+          };
+          return {
+            _meta: uniqueToolMetadata,
+            content: [
+              {
+                type: "text",
+                text: `Displaying ${displayName}`
+              }
+            ],
+            // structuredContent will be injected as window.openai.toolOutput by Apps SDK
+            structuredContent: params
+          };
+        }
         return {
-          _meta: uniqueToolMetadata,
           content: [
             {
               type: "text",
-              text: `Displaying ${displayName}`
-            }
-          ],
-          // structuredContent will be injected as window.openai.toolOutput by Apps SDK
-          structuredContent: params
+              text: `Displaying ${displayName}`,
+              description: `Show MCP-UI widget for ${displayName}`
+            },
+            uiResource
+          ]
         };
       }
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Displaying ${displayName}`,
-            description: `Show MCP-UI widget for ${displayName}`
-          },
-          uiResource
-        ]
-      };
-    }, "cb")
-  });
-  return this;
+    );
+  }
+  return server;
 }
 __name(uiResourceRegistration, "uiResourceRegistration");
 
@@ -1762,7 +1899,7 @@ function toolRegistration(toolDefinition, callback) {
       const initialRequestContext = getRequestContext();
       const extraProgressToken = extra?._meta?.progressToken;
       const extraSendNotification = extra?.sendNotification;
-      const { requestContext, progressToken, sendNotification: sendNotification2 } = findSessionContext(
+      const { requestContext, session, progressToken, sendNotification: sendNotification2 } = findSessionContext(
         this.sessions,
         initialRequestContext,
         extraProgressToken,
@@ -1773,7 +1910,9 @@ function toolRegistration(toolDefinition, callback) {
         this.createMessage.bind(this),
         this.server.server.elicitInput.bind(this.server.server),
         progressToken,
-        sendNotification2
+        sendNotification2,
+        session?.logLevel,
+        session?.clientCapabilities
       );
       const executeCallback = /* @__PURE__ */ __name(async () => {
         if (actualCallback.length >= 2) {
@@ -1793,7 +1932,155 @@ function toolRegistration(toolDefinition, callback) {
 __name(toolRegistration, "toolRegistration");
 
 // src/server/resources/index.ts
-import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResourceTemplate } from "@mcp-use/modelcontextprotocol-sdk/server/mcp.js";
+
+// src/server/resources/subscriptions.ts
+import {
+  SubscribeRequestSchema,
+  UnsubscribeRequestSchema
+} from "@mcp-use/modelcontextprotocol-sdk/types.js";
+var ResourceSubscriptionManager = class {
+  static {
+    __name(this, "ResourceSubscriptionManager");
+  }
+  /**
+   * Tracks resource subscriptions per session
+   * Map structure: uri -> Set<sessionId>
+   */
+  subscriptions = /* @__PURE__ */ new Map();
+  /**
+   * Register subscription handlers with an MCP server instance
+   *
+   * @param server - The native MCP server instance
+   * @param sessions - Map of active sessions
+   */
+  registerHandlers(server, sessions) {
+    server.server.setRequestHandler(
+      SubscribeRequestSchema,
+      async (request) => {
+        const { uri } = request.params;
+        const sessionId = this.getSessionIdFromContext(sessions, server);
+        if (!sessionId) {
+          console.warn(
+            `[MCP] Could not determine session ID for resource subscription to ${uri}`
+          );
+          return {};
+        }
+        if (!this.subscriptions.has(uri)) {
+          this.subscriptions.set(uri, /* @__PURE__ */ new Set());
+        }
+        this.subscriptions.get(uri).add(sessionId);
+        console.log(
+          `[MCP] Session ${sessionId} subscribed to resource: ${uri}`
+        );
+        return {};
+      }
+    );
+    server.server.setRequestHandler(
+      UnsubscribeRequestSchema,
+      async (request) => {
+        const { uri } = request.params;
+        const sessionId = this.getSessionIdFromContext(sessions, server);
+        if (!sessionId) {
+          console.warn(
+            `[MCP] Could not determine session ID for resource unsubscribe from ${uri}`
+          );
+          return {};
+        }
+        const subscribers = this.subscriptions.get(uri);
+        if (subscribers) {
+          subscribers.delete(sessionId);
+          if (subscribers.size === 0) {
+            this.subscriptions.delete(uri);
+          }
+          console.log(
+            `[MCP] Session ${sessionId} unsubscribed from resource: ${uri}`
+          );
+        }
+        return {};
+      }
+    );
+  }
+  /**
+   * Get session ID from request context or sessions map
+   *
+   * @param sessions - Map of active sessions
+   * @param server - The server instance to match against
+   * @returns The session ID, or undefined if not found
+   */
+  getSessionIdFromContext(sessions, server) {
+    const requestContext = getRequestContext();
+    let sessionId;
+    if (requestContext) {
+      sessionId = requestContext.req.header("mcp-session-id");
+    }
+    if (!sessionId) {
+      for (const [sid, session] of sessions.entries()) {
+        if (session.server === server) {
+          sessionId = sid;
+          break;
+        }
+      }
+    }
+    return sessionId;
+  }
+  /**
+   * Notify subscribed clients that a resource has been updated
+   *
+   * This method sends a `notifications/resources/updated` notification to all
+   * sessions that have subscribed to the specified resource URI.
+   *
+   * @param uri - The URI of the resource that changed
+   * @param sessions - Map of active sessions
+   * @returns Promise that resolves when all notifications have been sent
+   */
+  async notifyResourceUpdated(uri, sessions) {
+    const subscribers = this.subscriptions.get(uri);
+    if (!subscribers || subscribers.size === 0) {
+      return;
+    }
+    console.log(
+      `[MCP] Notifying ${subscribers.size} subscriber(s) of resource update: ${uri}`
+    );
+    for (const sessionId of subscribers) {
+      const session = sessions.get(sessionId);
+      if (session?.server) {
+        try {
+          await session.server.server.sendResourceUpdated({ uri });
+          console.log(
+            `[MCP] Sent resource update notification to session ${sessionId}`
+          );
+        } catch (error2) {
+          console.error(
+            `[MCP] Failed to send resource update notification to session ${sessionId}:`,
+            error2
+          );
+        }
+      }
+    }
+  }
+  /**
+   * Clean up resource subscriptions for a closed session
+   *
+   * This method is called automatically when a session is closed to remove
+   * all resource subscriptions associated with that session.
+   *
+   * @param sessionId - The session ID to clean up
+   */
+  cleanupSession(sessionId) {
+    for (const [uri, subscribers] of this.subscriptions) {
+      subscribers.delete(sessionId);
+      if (subscribers.size === 0) {
+        this.subscriptions.delete(uri);
+      }
+    }
+    console.log(
+      `[MCP] Cleaned up resource subscriptions for session ${sessionId}`
+    );
+  }
+};
+
+// src/server/resources/index.ts
 function registerResource(resourceDefinition, callback) {
   const actualCallback = callback || resourceDefinition.readCallback;
   if (!actualCallback) {
@@ -1803,8 +2090,8 @@ function registerResource(resourceDefinition, callback) {
   }
   const explicitMimeType = resourceDefinition.mimeType;
   const wrappedCallback = /* @__PURE__ */ __name(async () => {
-    const { getRequestContext: getRequestContext2, runWithContext: runWithContext2 } = await import("../../context-storage-TXQ4DVSS.js");
-    const { findSessionContext: findSessionContext2 } = await import("../../tool-execution-helpers-IVUDHXMK.js");
+    const { getRequestContext: getRequestContext2, runWithContext: runWithContext2 } = await import("../../context-storage-NA4MHWOZ.js");
+    const { findSessionContext: findSessionContext2 } = await import("../../tool-execution-helpers-XFVBSRXM.js");
     const initialRequestContext = getRequestContext2();
     const sessions = this.sessions || /* @__PURE__ */ new Map();
     const { requestContext } = findSessionContext2(
@@ -1852,24 +2139,25 @@ function registerResourceTemplate(resourceTemplateDefinition, callback) {
       `Resource template '${resourceTemplateDefinition.name}' must have either a readCallback property or a callback parameter`
     );
   }
-  const template = new ResourceTemplate(
-    resourceTemplateDefinition.resourceTemplate.uriTemplate,
-    {
-      list: void 0,
-      // Optional: callback to list all matching resources
-      complete: void 0
-      // Optional: callback for auto-completion
-    }
-  );
+  const isFlatStructure = "uriTemplate" in resourceTemplateDefinition;
+  const uriTemplate = isFlatStructure ? resourceTemplateDefinition.uriTemplate : resourceTemplateDefinition.resourceTemplate.uriTemplate;
+  const mimeType = isFlatStructure ? resourceTemplateDefinition.mimeType : resourceTemplateDefinition.resourceTemplate.mimeType;
+  const templateDescription = isFlatStructure ? void 0 : resourceTemplateDefinition.resourceTemplate.description;
+  const template = new ResourceTemplate(uriTemplate, {
+    list: void 0,
+    // Optional: callback to list all matching resources
+    complete: void 0
+    // Optional: callback for auto-completion
+  });
   const metadata = {};
   if (resourceTemplateDefinition.title) {
     metadata.title = resourceTemplateDefinition.title;
   }
-  if (resourceTemplateDefinition.description || resourceTemplateDefinition.resourceTemplate.description) {
-    metadata.description = resourceTemplateDefinition.description || resourceTemplateDefinition.resourceTemplate.description;
+  if (resourceTemplateDefinition.description || templateDescription) {
+    metadata.description = resourceTemplateDefinition.description || templateDescription;
   }
-  if (resourceTemplateDefinition.resourceTemplate.mimeType) {
-    metadata.mimeType = resourceTemplateDefinition.resourceTemplate.mimeType;
+  if (mimeType) {
+    metadata.mimeType = mimeType;
   }
   if (resourceTemplateDefinition.annotations) {
     metadata.annotations = resourceTemplateDefinition.annotations;
@@ -1879,12 +2167,9 @@ function registerResourceTemplate(resourceTemplateDefinition, callback) {
     template,
     metadata,
     async (uri) => {
-      const params = this.parseTemplateUri(
-        resourceTemplateDefinition.resourceTemplate.uriTemplate,
-        uri.toString()
-      );
-      const { getRequestContext: getRequestContext2, runWithContext: runWithContext2 } = await import("../../context-storage-TXQ4DVSS.js");
-      const { findSessionContext: findSessionContext2 } = await import("../../tool-execution-helpers-IVUDHXMK.js");
+      const params = this.parseTemplateUri(uriTemplate, uri.toString());
+      const { getRequestContext: getRequestContext2, runWithContext: runWithContext2 } = await import("../../context-storage-NA4MHWOZ.js");
+      const { findSessionContext: findSessionContext2 } = await import("../../tool-execution-helpers-XFVBSRXM.js");
       const initialRequestContext = getRequestContext2();
       const sessions = this.sessions || /* @__PURE__ */ new Map();
       const { requestContext } = findSessionContext2(
@@ -1897,8 +2182,12 @@ function registerResourceTemplate(resourceTemplateDefinition, callback) {
       const executeCallback = /* @__PURE__ */ __name(async () => {
         if (actualCallback.length >= 3) {
           return await actualCallback(uri, params, enhancedContext);
+        } else if (actualCallback.length === 2) {
+          return await actualCallback(uri, params);
+        } else if (actualCallback.length === 1) {
+          return await actualCallback(uri);
         }
-        return await actualCallback(uri, params);
+        return await actualCallback();
       }, "executeCallback");
       const result = requestContext ? await runWithContext2(requestContext, executeCallback) : await executeCallback();
       if ("contents" in result && Array.isArray(result.contents)) {
@@ -1928,12 +2217,14 @@ function registerPrompt(promptDefinition, callback) {
     argsSchema = this.convertZodSchemaToParams(
       promptDefinition.schema
     );
+  } else if (promptDefinition.args && promptDefinition.args.length > 0) {
+    argsSchema = this.createParamsSchema(promptDefinition.args);
   } else {
-    argsSchema = this.createParamsSchema(promptDefinition.args || []);
+    argsSchema = void 0;
   }
   const wrappedCallback = /* @__PURE__ */ __name(async (params, extra) => {
-    const { getRequestContext: getRequestContext2, runWithContext: runWithContext2 } = await import("../../context-storage-TXQ4DVSS.js");
-    const { findSessionContext: findSessionContext2 } = await import("../../tool-execution-helpers-IVUDHXMK.js");
+    const { getRequestContext: getRequestContext2, runWithContext: runWithContext2 } = await import("../../context-storage-NA4MHWOZ.js");
+    const { findSessionContext: findSessionContext2 } = await import("../../tool-execution-helpers-XFVBSRXM.js");
     const initialRequestContext = getRequestContext2();
     const sessions = this.sessions || /* @__PURE__ */ new Map();
     const { requestContext } = findSessionContext2(
@@ -2204,7 +2495,7 @@ async function sendNotificationToSession2(sessionId, method, params) {
 __name(sendNotificationToSession2, "sendNotificationToSession");
 
 // src/server/sessions/session-manager.ts
-function startIdleCleanup(sessions, idleTimeoutMs) {
+function startIdleCleanup(sessions, idleTimeoutMs, mcpServerInstance) {
   if (idleTimeoutMs <= 0) {
     return void 0;
   }
@@ -2222,6 +2513,7 @@ function startIdleCleanup(sessions, idleTimeoutMs) {
       );
       for (const sessionId of expiredSessions) {
         sessions.delete(sessionId);
+        mcpServerInstance?.cleanupSessionSubscriptions?.(sessionId);
       }
     }
   }, 6e4);
@@ -2230,12 +2522,16 @@ __name(startIdleCleanup, "startIdleCleanup");
 
 // src/server/endpoints/mount-mcp.ts
 async function mountMcp(app, mcpServerInstance, sessions, config, isProductionMode2) {
-  const { FetchStreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/experimental/fetch-streamable-http/index.js");
+  const { FetchStreamableHTTPServerTransport } = await import("@mcp-use/modelcontextprotocol-sdk/experimental/fetch-streamable-http/index.js");
   const idleTimeoutMs = config.sessionIdleTimeoutMs ?? 3e5;
   const transports = /* @__PURE__ */ new Map();
   let idleCleanupInterval;
   if (idleTimeoutMs > 0) {
-    idleCleanupInterval = startIdleCleanup(sessions, idleTimeoutMs);
+    idleCleanupInterval = startIdleCleanup(
+      sessions,
+      idleTimeoutMs,
+      mcpServerInstance
+    );
   }
   const handleRequest = /* @__PURE__ */ __name(async (c) => {
     const sessionId = c.req.header("mcp-session-id");
@@ -2262,11 +2558,33 @@ async function mountMcp(app, mcpServerInstance, sessions, config, isProductionMo
           context: c,
           honoContext: c
         });
+        server.server.oninitialized = () => {
+          const clientCapabilities = server.server.getClientCapabilities();
+          const clientInfo = server.server.getClientInfo?.() || {};
+          const protocolVersion = server.server.getProtocolVersion?.() || "unknown";
+          if (clientCapabilities && sessions.has(sid)) {
+            const session = sessions.get(sid);
+            session.clientCapabilities = clientCapabilities;
+            console.log(
+              `[MCP] Captured client capabilities for session ${sid}:`,
+              Object.keys(clientCapabilities)
+            );
+          }
+          Telemetry.getInstance().trackServerInitialize({
+            protocolVersion: String(protocolVersion),
+            clientInfo: clientInfo || {},
+            clientCapabilities: clientCapabilities || {},
+            sessionId: sid
+          }).catch(
+            (e) => console.debug(`Failed to track server initialize: ${e}`)
+          );
+        };
       }, "onsessioninitialized"),
       onsessionclosed: /* @__PURE__ */ __name((sid) => {
         console.log(`[MCP] Session closed: ${sid}`);
         transports.delete(sid);
         sessions.delete(sid);
+        mcpServerInstance.cleanupSessionSubscriptions?.(sid);
       }, "onsessionclosed")
     });
     await server.connect(transport);
@@ -2504,12 +2822,13 @@ function createBearerAuthMiddleware(provider, baseUrl) {
       const result = await provider.verifyToken(token);
       const payload = result.payload;
       const user = provider.getUserInfo(payload);
+      const scope = payload.scope;
       const authInfo = {
         user,
         payload,
         accessToken: token,
         // Extract scopes from scope claim (OAuth standard)
-        scopes: payload.scope ? payload.scope.split(" ") : [],
+        scopes: scope ? scope.split(" ") : [],
         // Extract permissions (Auth0 style, or custom)
         permissions: payload.permissions || []
       };
@@ -2557,9 +2876,16 @@ async function setupOAuthForServer(app, oauthProvider, baseUrl, state) {
 __name(setupOAuthForServer, "setupOAuthForServer");
 
 // src/server/mcp-server.ts
-var McpServer = class {
+var MCPServerClass = class {
   static {
-    __name(this, "McpServer");
+    __name(this, "MCPServerClass");
+  }
+  /**
+   * Get the mcp-use package version.
+   * Works in all environments (Node.js, browser, Cloudflare Workers, Deno, etc.)
+   */
+  static getPackageVersion() {
+    return getPackageVersion();
   }
   /**
    * Native MCP server instance from @modelcontextprotocol/sdk
@@ -2583,8 +2909,6 @@ var McpServer = class {
   buildId;
   sessions = /* @__PURE__ */ new Map();
   idleCleanupInterval;
-  oauthConfig;
-  // Store OAuth config for lazy initialization
   oauthSetupState = {
     complete: false,
     provider: void 0,
@@ -2593,15 +2917,37 @@ var McpServer = class {
   oauthProvider;
   oauthMiddleware;
   /**
-   * Storage for registration "recipes" that can be replayed on new server instances
+   * Storage for registrations that can be replayed on new server instances
    * Following the official SDK pattern where each session gets its own server instance
+   * @internal Exposed for telemetry purposes
    */
-  registrationRecipes = {
+  registrations = {
     tools: /* @__PURE__ */ new Map(),
     prompts: /* @__PURE__ */ new Map(),
     resources: /* @__PURE__ */ new Map(),
     resourceTemplates: /* @__PURE__ */ new Map()
   };
+  /**
+   * Storage for widget definitions, used to inject metadata into tool responses
+   * when using the widget() helper with returnsWidget option
+   */
+  widgetDefinitions = /* @__PURE__ */ new Map();
+  /**
+   * Resource subscription manager for tracking and notifying resource updates
+   */
+  subscriptionManager = new ResourceSubscriptionManager();
+  /**
+   * Clean up resource subscriptions for a closed session
+   *
+   * This method is called automatically when a session is closed to remove
+   * all resource subscriptions associated with that session.
+   *
+   * @param sessionId - The session ID to clean up
+   * @internal
+   */
+  cleanupSessionSubscriptions(sessionId) {
+    this.subscriptionManager.cleanupSession(sessionId);
+  }
   /**
    * Creates a new MCP server instance with Hono integration
    *
@@ -2610,23 +2956,34 @@ var McpServer = class {
    * access to Hono methods while preserving MCP server functionality.
    *
    * @param config - Server configuration including name, version, and description
-   * @returns A proxied McpServer instance that supports both MCP and Hono methods
+   * @returns A proxied MCPServer instance that supports both MCP and Hono methods
    */
   constructor(config) {
     this.config = config;
     this.serverHost = config.host || "localhost";
     this.serverBaseUrl = config.baseUrl;
-    this.nativeServer = new OfficialMcpServer({
-      name: config.name,
-      version: config.version
-    });
+    this.nativeServer = new OfficialMcpServer(
+      {
+        name: config.name,
+        version: config.version
+      },
+      {
+        capabilities: {
+          logging: {},
+          resources: {
+            subscribe: true,
+            listChanged: true
+          }
+        }
+      }
+    );
     this.app = createHonoApp(requestLogger);
-    this.oauthConfig = config.oauth;
+    this.oauthProvider = config.oauth;
     this.wrapRegistrationMethods();
     return createHonoProxy(this, this.app);
   }
   /**
-   * Wrap registration methods to capture recipes following official SDK pattern.
+   * Wrap registration methods to capture registrations following official SDK pattern.
    * Each session will get a fresh server instance with all registrations replayed.
    */
   wrapRegistrationMethods() {
@@ -2636,50 +2993,113 @@ var McpServer = class {
     const originalResourceTemplate = registerResourceTemplate;
     const self = this;
     this.tool = ((toolDefinition, callback) => {
-      const actualCallback = callback || toolDefinition.cb;
-      self.registrationRecipes.tools.set(toolDefinition.name, {
-        config: toolDefinition,
-        handler: actualCallback
-      });
-      return originalTool.call(self, toolDefinition, callback);
+      const widgetConfig = toolDefinition.widget;
+      const widgetName = widgetConfig?.name;
+      if (widgetConfig && widgetName) {
+        const buildIdPart = self.buildId ? `-${self.buildId}` : "";
+        const outputTemplate = `ui://widget/${widgetName}${buildIdPart}.html`;
+        toolDefinition._meta = {
+          ...toolDefinition._meta,
+          "openai/outputTemplate": outputTemplate,
+          "openai/toolInvocation/invoking": widgetConfig.invoking ?? `Loading ${widgetName}...`,
+          "openai/toolInvocation/invoked": widgetConfig.invoked ?? `${widgetName} ready`,
+          "openai/widgetAccessible": widgetConfig.widgetAccessible ?? true,
+          "openai/resultCanProduceWidget": widgetConfig.resultCanProduceWidget ?? true
+        };
+      }
+      let actualCallback = callback || toolDefinition.cb;
+      if (widgetConfig && widgetName && actualCallback) {
+        const originalCallback = actualCallback;
+        actualCallback = /* @__PURE__ */ __name((async (params, ctx) => {
+          const result = await originalCallback(params, ctx);
+          const widgetDef = self.widgetDefinitions.get(widgetName);
+          if (result && typeof result === "object") {
+            const randomId = Math.random().toString(36).substring(2, 15);
+            const buildIdPart = self.buildId ? `-${self.buildId}` : "";
+            const uniqueUri = `ui://widget/${widgetName}${buildIdPart}-${randomId}.html`;
+            const responseMeta = {
+              ...widgetDef || {},
+              // Include mcp-use/widget and other widget metadata
+              "openai/outputTemplate": uniqueUri,
+              "openai/toolInvocation/invoking": widgetConfig.invoking ?? `Loading ${widgetName}...`,
+              "openai/toolInvocation/invoked": widgetConfig.invoked ?? `${widgetName} ready`,
+              "openai/widgetAccessible": widgetConfig.widgetAccessible ?? true,
+              "openai/resultCanProduceWidget": widgetConfig.resultCanProduceWidget ?? true
+            };
+            result._meta = responseMeta;
+            if (result.content?.[0]?.type === "text" && !result.content[0].text) {
+              result.content[0].text = `Displaying ${widgetName}`;
+            }
+          }
+          return result;
+        }), "actualCallback");
+      }
+      if (actualCallback) {
+        self.registrations.tools.set(toolDefinition.name, {
+          config: toolDefinition,
+          handler: actualCallback
+        });
+      }
+      return originalTool.call(self, toolDefinition, actualCallback);
     });
-    this.prompt = function(promptDefinition, callback) {
+    this.prompt = ((promptDefinition, callback) => {
       const actualCallback = callback || promptDefinition.cb;
-      self.registrationRecipes.prompts.set(promptDefinition.name, {
-        config: promptDefinition,
-        handler: actualCallback
-      });
-      return originalPrompt.call(self, promptDefinition, callback);
-    };
-    this.resource = function(resourceDefinition, callback) {
+      if (actualCallback) {
+        self.registrations.prompts.set(promptDefinition.name, {
+          config: promptDefinition,
+          handler: actualCallback
+        });
+      }
+      return originalPrompt.call(
+        self,
+        promptDefinition,
+        callback
+      );
+    });
+    this.resource = ((resourceDefinition, callback) => {
       const actualCallback = callback || resourceDefinition.readCallback;
-      const resourceKey = `${resourceDefinition.name}:${resourceDefinition.uri}`;
-      self.registrationRecipes.resources.set(resourceKey, {
-        config: resourceDefinition,
-        handler: actualCallback
-      });
+      if (actualCallback) {
+        const resourceKey = `${resourceDefinition.name}:${resourceDefinition.uri}`;
+        self.registrations.resources.set(resourceKey, {
+          config: resourceDefinition,
+          handler: actualCallback
+        });
+      }
       return originalResource.call(self, resourceDefinition, callback);
-    };
-    this.resourceTemplate = function(templateDefinition, callback) {
+    });
+    this.resourceTemplate = ((templateDefinition, callback) => {
       const actualCallback = callback || templateDefinition.readCallback;
-      self.registrationRecipes.resourceTemplates.set(templateDefinition.name, {
-        config: templateDefinition,
-        handler: actualCallback
-      });
-      return originalResourceTemplate.call(self, templateDefinition, callback);
-    };
+      if (actualCallback) {
+        self.registrations.resourceTemplates.set(templateDefinition.name, {
+          config: templateDefinition,
+          handler: actualCallback
+        });
+      }
+      return originalResourceTemplate.call(
+        self,
+        templateDefinition,
+        callback
+      );
+    });
   }
   /**
    * Create a new server instance for a session following official SDK pattern.
    * This is called for each initialize request to create an isolated server.
    */
   getServerForSession() {
-    const newServer = new OfficialMcpServer({
-      name: this.config.name,
-      version: this.config.version
-    });
-    for (const [name, recipe] of this.registrationRecipes.tools) {
-      const { config, handler: actualCallback } = recipe;
+    const newServer = new OfficialMcpServer(
+      {
+        name: this.config.name,
+        version: this.config.version
+      },
+      {
+        capabilities: {
+          logging: {}
+        }
+      }
+    );
+    for (const [name, registration] of this.registrations.tools) {
+      const { config, handler: actualCallback } = registration;
       let inputSchema;
       if (config.schema) {
         inputSchema = this.convertZodSchemaToParams(config.schema);
@@ -2692,12 +3112,21 @@ var McpServer = class {
         const initialRequestContext = getRequestContext();
         const extraProgressToken = extra?._meta?.progressToken;
         const extraSendNotification = extra?.sendNotification;
-        const { requestContext, progressToken, sendNotification: sendNotification2 } = findSessionContext(
+        const { requestContext, session, progressToken, sendNotification: sendNotification2 } = findSessionContext(
           this.sessions,
           initialRequestContext,
           extraProgressToken,
           extraSendNotification
         );
+        let sessionId;
+        if (session) {
+          for (const [id, s] of this.sessions.entries()) {
+            if (s === session) {
+              sessionId = id;
+              break;
+            }
+          }
+        }
         const createMessageWithLogging = /* @__PURE__ */ __name(async (params2, options) => {
           console.log("[createMessage] About to call server.createMessage");
           console.log("[createMessage] Has server:", !!newServer);
@@ -2709,11 +3138,12 @@ var McpServer = class {
             console.log("[createMessage] Got result successfully");
             return result;
           } catch (err) {
+            const error2 = err;
             console.error(
               "[createMessage] Error:",
-              err.message,
+              error2.message,
               "Code:",
-              err.code
+              error2.code
             );
             throw err;
           }
@@ -2723,7 +3153,11 @@ var McpServer = class {
           createMessageWithLogging,
           newServer.server.elicitInput.bind(newServer.server),
           progressToken,
-          sendNotification2
+          sendNotification2,
+          session?.logLevel,
+          session?.clientCapabilities,
+          sessionId,
+          this.sessions
         );
         const executeCallback = /* @__PURE__ */ __name(async () => {
           if (actualCallback.length >= 2) {
@@ -2731,10 +3165,26 @@ var McpServer = class {
           }
           return await actualCallback(params);
         }, "executeCallback");
-        if (requestContext) {
-          return await runWithContext(requestContext, executeCallback);
+        const startTime = Date.now();
+        let success = true;
+        let errorType = null;
+        try {
+          const result = requestContext ? await runWithContext(requestContext, executeCallback) : await executeCallback();
+          return result;
+        } catch (err) {
+          success = false;
+          errorType = err instanceof Error ? err.name : "unknown_error";
+          throw err;
+        } finally {
+          const executionTimeMs = Date.now() - startTime;
+          Telemetry.getInstance().trackServerToolCall({
+            toolName: name,
+            lengthInputArgument: JSON.stringify(params).length,
+            success,
+            errorType,
+            executionTimeMs
+          }).catch((e) => console.debug(`Failed to track tool call: ${e}`));
         }
-        return await executeCallback();
       }, "wrappedHandler");
       newServer.registerTool(
         name,
@@ -2748,21 +3198,38 @@ var McpServer = class {
         wrappedHandler
       );
     }
-    for (const [name, recipe] of this.registrationRecipes.prompts) {
-      const { config, handler } = recipe;
+    for (const [name, registration] of this.registrations.prompts) {
+      const { config, handler } = registration;
       let argsSchema;
       if (config.schema) {
         argsSchema = this.convertZodSchemaToParams(config.schema);
+      } else if (config.args && config.args.length > 0) {
+        argsSchema = this.createParamsSchema(config.args);
       } else {
-        argsSchema = this.createParamsSchema(config.args || []);
+        argsSchema = void 0;
       }
-      const wrappedHandler = /* @__PURE__ */ __name(async (params) => {
-        const result = await handler(params);
-        if ("messages" in result && Array.isArray(result.messages)) {
-          return result;
+      const wrappedHandler = /* @__PURE__ */ __name(async (params, extra) => {
+        let success = true;
+        let errorType = null;
+        try {
+          const result = await handler(params, extra);
+          if ("messages" in result && Array.isArray(result.messages)) {
+            return result;
+          }
+          const { convertToolResultToPromptResult: convertToolResultToPromptResult2 } = await import("../../conversion-OTRZZBUU.js");
+          return convertToolResultToPromptResult2(result);
+        } catch (err) {
+          success = false;
+          errorType = err instanceof Error ? err.name : "unknown_error";
+          throw err;
+        } finally {
+          Telemetry.getInstance().trackServerPromptCall({
+            name,
+            description: config.description ?? null,
+            success,
+            errorType
+          }).catch((e) => console.debug(`Failed to track prompt call: ${e}`));
         }
-        const { convertToolResultToPromptResult: convertToolResultToPromptResult2 } = await import("../../conversion-OTRZZBUU.js");
-        return convertToolResultToPromptResult2(result);
       }, "wrappedHandler");
       newServer.registerPrompt(
         name,
@@ -2774,15 +3241,42 @@ var McpServer = class {
         wrappedHandler
       );
     }
-    for (const [_key, recipe] of this.registrationRecipes.resources) {
-      const { config, handler } = recipe;
-      const wrappedHandler = /* @__PURE__ */ __name(async () => {
-        const result = await handler();
-        if ("contents" in result && Array.isArray(result.contents)) {
-          return result;
+    for (const [_key, registration] of this.registrations.resources) {
+      const { config, handler } = registration;
+      const wrappedHandler = /* @__PURE__ */ __name(async (extra) => {
+        let success = true;
+        let errorType = null;
+        let contents = [];
+        try {
+          const result = await handler(extra);
+          if ("contents" in result && Array.isArray(result.contents)) {
+            contents = result.contents;
+            return result;
+          }
+          const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await import("../../conversion-5MA4VY3B.js");
+          const converted = convertToolResultToResourceResult2(
+            config.uri,
+            result
+          );
+          contents = converted.contents || [];
+          return converted;
+        } catch (err) {
+          success = false;
+          errorType = err instanceof Error ? err.name : "unknown_error";
+          throw err;
+        } finally {
+          Telemetry.getInstance().trackServerResourceCall({
+            name: config.name,
+            description: config.description ?? null,
+            contents: contents.map((c) => ({
+              mime_type: c.mimeType ?? null,
+              text: c.text ? `[text: ${c.text.length} chars]` : null,
+              blob: c.blob ? `[blob: ${c.blob.length} bytes]` : null
+            })),
+            success,
+            errorType
+          }).catch((e) => console.debug(`Failed to track resource call: ${e}`));
         }
-        const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await import("../../conversion-5MA4VY3B.js");
-        return convertToolResultToResourceResult2(config.uri, result);
       }, "wrappedHandler");
       newServer.registerResource(
         config.name,
@@ -2795,24 +3289,25 @@ var McpServer = class {
         wrappedHandler
       );
     }
-    for (const [_name, recipe] of this.registrationRecipes.resourceTemplates) {
-      const { config, handler } = recipe;
-      const template = new ResourceTemplate2(
-        config.resourceTemplate.uriTemplate,
-        {
-          list: void 0,
-          complete: void 0
-        }
-      );
+    for (const [_name, registration] of this.registrations.resourceTemplates) {
+      const { config, handler } = registration;
+      const isFlatStructure = "uriTemplate" in config;
+      const uriTemplate = isFlatStructure ? config.uriTemplate : config.resourceTemplate.uriTemplate;
+      const mimeType = isFlatStructure ? config.mimeType : config.resourceTemplate.mimeType;
+      const templateDescription = isFlatStructure ? void 0 : config.resourceTemplate.description;
+      const template = new ResourceTemplate2(uriTemplate, {
+        list: void 0,
+        complete: void 0
+      });
       const metadata = {};
       if (config.title) {
         metadata.title = config.title;
       }
-      if (config.description || config.resourceTemplate.description) {
-        metadata.description = config.description || config.resourceTemplate.description;
+      if (config.description || templateDescription) {
+        metadata.description = config.description || templateDescription;
       }
-      if (config.resourceTemplate.mimeType) {
-        metadata.mimeType = config.resourceTemplate.mimeType;
+      if (mimeType) {
+        metadata.mimeType = mimeType;
       }
       if (config.annotations) {
         metadata.annotations = config.annotations;
@@ -2821,20 +3316,90 @@ var McpServer = class {
         config.name,
         template,
         metadata,
-        async (uri) => {
-          const params = this.parseTemplateUri(
-            config.resourceTemplate.uriTemplate,
-            uri.toString()
-          );
-          const result = await handler(uri, params);
-          if ("contents" in result && Array.isArray(result.contents)) {
-            return result;
+        async (uri, extra) => {
+          let success = true;
+          let errorType = null;
+          let contents = [];
+          try {
+            const params = this.parseTemplateUri(uriTemplate, uri.toString());
+            const result = await handler(uri, params, extra);
+            if ("contents" in result && Array.isArray(result.contents)) {
+              contents = result.contents;
+              return result;
+            }
+            const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await import("../../conversion-5MA4VY3B.js");
+            const converted = convertToolResultToResourceResult2(
+              uri.toString(),
+              result
+            );
+            contents = converted.contents || [];
+            return converted;
+          } catch (err) {
+            success = false;
+            errorType = err instanceof Error ? err.name : "unknown_error";
+            throw err;
+          } finally {
+            Telemetry.getInstance().trackServerResourceCall({
+              name: config.name,
+              description: config.description ?? null,
+              contents: contents.map((c) => ({
+                mimeType: c.mimeType ?? null,
+                text: c.text ? `[text: ${c.text.length} chars]` : null,
+                blob: c.blob ? `[blob: ${c.blob.length} bytes]` : null
+              })),
+              success,
+              errorType
+            }).catch(
+              (e) => console.debug(`Failed to track resource template call: ${e}`)
+            );
           }
-          const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await import("../../conversion-5MA4VY3B.js");
-          return convertToolResultToResourceResult2(uri.toString(), result);
         }
       );
     }
+    newServer.server.setRequestHandler(
+      z2.object({ method: z2.literal("logging/setLevel") }).passthrough(),
+      (async (request, extra) => {
+        const level = request.params?.level;
+        if (!level) {
+          throw new McpError(
+            ErrorCode.InvalidParams,
+            "Missing 'level' parameter"
+          );
+        }
+        if (!isValidLogLevel(level)) {
+          throw new McpError(
+            ErrorCode.InvalidParams,
+            `Invalid log level '${level}'. Must be one of: debug, info, notice, warning, error, critical, alert, emergency`
+          );
+        }
+        const requestContext = getRequestContext();
+        if (requestContext) {
+          const sessionId = requestContext.req.header("mcp-session-id");
+          if (sessionId && this.sessions.has(sessionId)) {
+            const session = this.sessions.get(sessionId);
+            session.logLevel = level;
+            console.log(
+              `[MCP] Set log level to '${level}' for session ${sessionId}`
+            );
+            return {};
+          }
+        }
+        for (const [sessionId, session] of this.sessions.entries()) {
+          if (session.server === newServer) {
+            session.logLevel = level;
+            console.log(
+              `[MCP] Set log level to '${level}' for session ${sessionId}`
+            );
+            return {};
+          }
+        }
+        console.warn(
+          "[MCP] Could not find session for logging/setLevel request"
+        );
+        throw new McpError(ErrorCode.InternalError, "Could not find session");
+      })
+    );
+    this.subscriptionManager.registerHandlers(newServer, this.sessions);
     return newServer;
   }
   /**
@@ -2848,23 +3413,43 @@ var McpServer = class {
       this.serverPort
     );
   }
-  // Tool registration helper
-  tool = toolRegistration;
+  // Tool registration helper - type is set in wrapRegistrationMethods
+  tool;
   // Schema conversion helpers (used by tool registration)
   convertZodSchemaToParams = convertZodSchemaToParams;
   createParamsSchema = createParamsSchema;
   // Template URI parsing helper (used by resource templates)
   parseTemplateUri = parseTemplateUri;
-  // Resource registration helpers
-  resource = registerResource;
-  resourceTemplate = registerResourceTemplate;
-  // Prompt registration helper
-  prompt = registerPrompt;
+  // Resource registration helpers - types are set in wrapRegistrationMethods
+  resource;
+  resourceTemplate;
+  // Prompt registration helper - type is set in wrapRegistrationMethods
+  prompt;
   // Notification helpers
   getActiveSessions = getActiveSessions;
   sendNotification = sendNotification;
   sendNotificationToSession = sendNotificationToSession2;
-  uiResource = uiResourceRegistration;
+  /**
+   * Notify subscribed clients that a resource has been updated
+   *
+   * This method sends a `notifications/resources/updated` notification to all
+   * sessions that have subscribed to the specified resource URI.
+   *
+   * @param uri - The URI of the resource that changed
+   * @returns Promise that resolves when all notifications have been sent
+   *
+   * @example
+   * ```typescript
+   * // After updating a resource, notify subscribers
+   * await server.notifyResourceUpdated("file:///path/to/resource.txt");
+   * ```
+   */
+  async notifyResourceUpdated(uri) {
+    return this.subscriptionManager.notifyResourceUpdated(uri, this.sessions);
+  }
+  uiResource = /* @__PURE__ */ __name((definition) => {
+    return uiResourceRegistration(this, definition);
+  }, "uiResource");
   /**
    * Mount MCP server endpoints at /mcp and /sse
    *
@@ -2889,7 +3474,7 @@ var McpServer = class {
     const result = await mountMcp(
       this.app,
       this,
-      // Pass the McpServer instance so mountMcp can call getServerForSession()
+      // Pass the MCPServer instance so mountMcp can call getServerForSession()
       this.sessions,
       this.config,
       isProductionMode()
@@ -2947,7 +3532,12 @@ var McpServer = class {
     if (hostEnv) {
       this.serverHost = hostEnv;
     }
-    if (this.oauthConfig && !this.oauthSetupState.complete) {
+    this.serverBaseUrl = getServerBaseUrl(
+      this.serverBaseUrl,
+      this.serverHost,
+      this.serverPort
+    );
+    if (this.oauthProvider && !this.oauthSetupState.complete) {
       await setupOAuthForServer(
         this.app,
         this.oauthProvider,
@@ -2962,10 +3552,14 @@ var McpServer = class {
     await this.mountMcp();
     await this.mountInspector();
     this.logRegisteredItems();
+    this._trackServerRun("http");
     await startServer(this.app, this.serverPort, this.serverHost, {
       onDenoRequest: rewriteSupabaseRequest
     });
   }
+  _trackServerRun(transport) {
+    Telemetry.getInstance().trackServerRunFromServer(this, transport).catch((e) => console.debug(`Failed to track server run: ${e}`));
+  }
   /**
    * Get the fetch handler for the server after mounting all endpoints
    *
@@ -2984,7 +3578,7 @@ var McpServer = class {
    * @example
    * ```typescript
    * // For Supabase Edge Functions (handles path rewriting automatically)
-   * const server = createMCPServer('my-server');
+   * const server = new MCPServer({ name: 'my-server', version: '1.0.0' });
    * server.tool({ ... });
    * const handler = await server.getHandler({ provider: 'supabase' });
    * Deno.serve(handler);
@@ -2993,14 +3587,14 @@ var McpServer = class {
    * @example
    * ```typescript
    * // For Cloudflare Workers
-   * const server = createMCPServer('my-server');
+   * const server = new MCPServer({ name: 'my-server', version: '1.0.0' });
    * server.tool({ ... });
    * const handler = await server.getHandler();
    * export default { fetch: handler };
    * ```
    */
   async getHandler(options) {
-    if (this.oauthConfig && !this.oauthSetupState.complete) {
+    if (this.oauthProvider && !this.oauthSetupState.complete) {
       await setupOAuthForServer(
         this.app,
         this.oauthProvider,
@@ -3019,6 +3613,8 @@ var McpServer = class {
     console.log("[MCP] Mounting inspector");
     await this.mountInspector();
     console.log("[MCP] Mounted inspector");
+    const provider = options?.provider || "fetch";
+    this._trackServerRun(provider);
     const fetchHandler = this.app.fetch.bind(this.app);
     if (options?.provider === "supabase") {
       return async (req) => {
@@ -3070,8 +3666,9 @@ var McpServer = class {
     }
   }
 };
+var MCPServer = MCPServerClass;
 function createMCPServer(name, config = {}) {
-  const instance = new McpServer({
+  const instance = new MCPServerClass({
     name,
     version: config.version || "1.0.0",
     description: config.description,
@@ -3155,12 +3752,13 @@ var SupabaseOAuthProvider = class {
     }
   }
   getUserInfo(payload) {
+    const userMetadata = payload.user_metadata;
     return {
       userId: payload.sub || payload.user_id,
       email: payload.email,
-      name: payload.user_metadata?.name || payload.user_metadata?.full_name,
-      username: payload.user_metadata?.username,
-      picture: payload.user_metadata?.avatar_url,
+      name: userMetadata?.name || userMetadata?.full_name,
+      username: userMetadata?.username,
+      picture: userMetadata?.avatar_url,
       roles: payload.role ? [payload.role] : [],
       permissions: payload.aal ? [`aal:${payload.aal}`] : [],
       // Include Supabase-specific claims
@@ -3233,6 +3831,7 @@ var Auth0OAuthProvider = class {
     }
   }
   getUserInfo(payload) {
+    const scope = payload.scope;
     return {
       userId: payload.sub,
       email: payload.email,
@@ -3245,7 +3844,7 @@ var Auth0OAuthProvider = class {
       // Auth0 can include roles (if configured)
       roles: payload.roles || payload["https://your-app.com/roles"] || [],
       // Include scope as well
-      scopes: payload.scope ? payload.scope.split(" ") : [],
+      scopes: scope ? scope.split(" ") : [],
       // Additional Auth0-specific claims
       email_verified: payload.email_verified,
       updated_at: payload.updated_at
@@ -3317,8 +3916,10 @@ var KeycloakOAuthProvider = class {
     }
   }
   getUserInfo(payload) {
-    const realmRoles = payload.realm_access?.roles || [];
-    const clientRoles = this.config.clientId && payload.resource_access?.[this.config.clientId]?.roles || [];
+    const realmAccess = payload.realm_access;
+    const realmRoles = realmAccess?.roles || [];
+    const resourceAccess = payload.resource_access;
+    const clientRoles = this.config.clientId && (resourceAccess?.[this.config.clientId]?.roles || []) || [];
     const allRoles = [...realmRoles, ...clientRoles];
     const permissions = [];
     if (payload.resource_access) {
@@ -3332,6 +3933,7 @@ var KeycloakOAuthProvider = class {
         }
       );
     }
+    const scope = payload.scope;
     return {
       userId: payload.sub,
       email: payload.email,
@@ -3342,7 +3944,7 @@ var KeycloakOAuthProvider = class {
       roles: allRoles,
       permissions,
       // Include scope as well
-      scopes: payload.scope ? payload.scope.split(" ") : [],
+      scopes: scope ? scope.split(" ") : [],
       // Keycloak-specific claims
       email_verified: payload.email_verified,
       given_name: payload.given_name,
@@ -3471,7 +4073,7 @@ var CustomOAuthProvider = class {
   async verifyToken(token) {
     try {
       const result = await this.config.verifyToken(token);
-      return { payload: result };
+      return result;
     } catch (error2) {
       throw new Error(`Custom OAuth verification failed: ${error2}`);
     }
@@ -3480,16 +4082,19 @@ var CustomOAuthProvider = class {
     if (this.config.getUserInfo) {
       return this.config.getUserInfo(payload);
     }
+    const scope = payload.scope;
+    const roles = payload.roles;
+    const permissions = payload.permissions;
     return {
       userId: payload.sub || payload.user_id || payload.id,
-      email: payload.email,
-      name: payload.name,
-      username: payload.username || payload.preferred_username,
-      nickname: payload.nickname,
-      picture: payload.picture || payload.avatar_url,
-      roles: payload.roles || [],
-      permissions: payload.permissions || [],
-      scopes: payload.scope ? payload.scope.split(" ") : []
+      email: payload.email ? payload.email : void 0,
+      name: payload.name ? payload.name : void 0,
+      username: payload.username || payload.preferred_username ? payload.username || payload.preferred_username : void 0,
+      nickname: payload.nickname ? payload.nickname : void 0,
+      picture: payload.picture || payload.avatar_url ? payload.picture || payload.avatar_url : void 0,
+      roles: Array.isArray(roles) ? roles : [],
+      permissions: Array.isArray(permissions) ? permissions : [],
+      scopes: scope ? scope.split(" ") : []
     };
   }
   getIssuer() {
@@ -3674,9 +4279,12 @@ function requireAnyScope(needed) {
 }
 __name(requireAnyScope, "requireAnyScope");
 export {
+  MCPServer,
+  VERSION,
   adaptConnectMiddleware,
   adaptMiddleware,
   array,
+  audio,
   binary,
   buildWidgetUrl,
   createExternalUrlResource,
@@ -3687,6 +4295,7 @@ export {
   css,
   error,
   getAuth,
+  getPackageVersion,
   getRequestContext,
   hasAnyScope,
   hasRequestContext,