mcp-use 1.9.1-canary.1 → 1.10.0-canary.11

package/dist/src/server/index.cjs

@@ -31,6 +31,360 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// src/telemetry/events.ts
+function createServerRunEventData(server, transport) {
+  const toolRegistrations = Array.from(server.registrations.tools.values());
+  const promptRegistrations = Array.from(server.registrations.prompts.values());
+  const resourceRegistrations = Array.from(
+    server.registrations.resources.values()
+  );
+  const templateRegistrations = Array.from(
+    server.registrations.resourceTemplates.values()
+  );
+  const allResources = resourceRegistrations.map((r) => ({
+    name: r.config.name,
+    title: r.config.title ?? null,
+    description: r.config.description ?? null,
+    uri: r.config.uri ?? null,
+    mime_type: r.config.mimeType ?? null
+  }));
+  const appsSdkResources = allResources.filter(
+    (r) => r.mime_type === "text/html+skybridge"
+  );
+  const mcpUiResources = allResources.filter(
+    (r) => r.mime_type === "text/uri-list" || r.mime_type === "text/html"
+  );
+  const mcpAppsResources = allResources.filter(
+    (r) => r.mime_type === "text/html+mcp"
+  );
+  return {
+    transport,
+    toolsNumber: server.registeredTools.length,
+    resourcesNumber: server.registeredResources.length,
+    promptsNumber: server.registeredPrompts.length,
+    auth: !!server.oauthProvider,
+    name: server.config.name,
+    description: server.config.description ?? null,
+    baseUrl: server.serverBaseUrl ?? null,
+    toolNames: server.registeredTools.length > 0 ? server.registeredTools : null,
+    resourceNames: server.registeredResources.length > 0 ? server.registeredResources : null,
+    promptNames: server.registeredPrompts.length > 0 ? server.registeredPrompts : null,
+    tools: toolRegistrations.length > 0 ? toolRegistrations.map((r) => ({
+      name: r.config.name,
+      title: r.config.title ?? null,
+      description: r.config.description ?? null,
+      input_schema: r.config.schema ? JSON.stringify(r.config.schema) : null,
+      output_schema: r.config.outputSchema ? JSON.stringify(r.config.outputSchema) : null
+    })) : null,
+    resources: allResources.length > 0 ? allResources : null,
+    prompts: promptRegistrations.length > 0 ? promptRegistrations.map((r) => ({
+      name: r.config.name,
+      title: r.config.title ?? null,
+      description: r.config.description ?? null,
+      args: r.config.args ? JSON.stringify(r.config.args) : null
+    })) : null,
+    templates: templateRegistrations.length > 0 ? templateRegistrations.map((r) => ({
+      name: r.config.name,
+      title: r.config.title ?? null,
+      description: r.config.description ?? null
+    })) : null,
+    capabilities: {
+      logging: true,
+      resources: { subscribe: true, listChanged: true }
+    },
+    appsSdkResources: appsSdkResources.length > 0 ? appsSdkResources : null,
+    appsSdkResourcesNumber: appsSdkResources.length,
+    mcpUiResources: mcpUiResources.length > 0 ? mcpUiResources : null,
+    mcpUiResourcesNumber: mcpUiResources.length,
+    mcpAppsResources: mcpAppsResources.length > 0 ? mcpAppsResources : null,
+    mcpAppsResourcesNumber: mcpAppsResources.length
+  };
+}
+var BaseTelemetryEvent, MCPAgentExecutionEvent, ServerRunEvent, ServerInitializeEvent, ServerToolCallEvent, ServerResourceCallEvent, ServerPromptCallEvent, ServerContextEvent, MCPClientInitEvent, ConnectorInitEvent, ClientAddServerEvent, ClientRemoveServerEvent;
+var init_events = __esm({
+  "src/telemetry/events.ts"() {
+    "use strict";
+    BaseTelemetryEvent = class {
+      static {
+        __name(this, "BaseTelemetryEvent");
+      }
+    };
+    MCPAgentExecutionEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "MCPAgentExecutionEvent");
+      }
+      get name() {
+        return "mcp_agent_execution";
+      }
+      get properties() {
+        return {
+          // Core execution info
+          execution_method: this.data.executionMethod,
+          query: this.data.query,
+          query_length: this.data.query.length,
+          success: this.data.success,
+          // Agent configuration
+          model_provider: this.data.modelProvider,
+          model_name: this.data.modelName,
+          server_count: this.data.serverCount,
+          server_identifiers: this.data.serverIdentifiers,
+          total_tools_available: this.data.totalToolsAvailable,
+          tools_available_names: this.data.toolsAvailableNames,
+          max_steps_configured: this.data.maxStepsConfigured,
+          memory_enabled: this.data.memoryEnabled,
+          use_server_manager: this.data.useServerManager,
+          // Execution parameters (always include, even if null)
+          max_steps_used: this.data.maxStepsUsed,
+          manage_connector: this.data.manageConnector,
+          external_history_used: this.data.externalHistoryUsed,
+          // Execution results (always include, even if null)
+          steps_taken: this.data.stepsTaken ?? null,
+          tools_used_count: this.data.toolsUsedCount ?? null,
+          tools_used_names: this.data.toolsUsedNames ?? null,
+          response: this.data.response ?? null,
+          response_length: this.data.response ? this.data.response.length : null,
+          execution_time_ms: this.data.executionTimeMs ?? null,
+          error_type: this.data.errorType ?? null,
+          conversation_history_length: this.data.conversationHistoryLength ?? null
+        };
+      }
+    };
+    __name(createServerRunEventData, "createServerRunEventData");
+    ServerRunEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerRunEvent");
+      }
+      get name() {
+        return "server_run";
+      }
+      get properties() {
+        return {
+          transport: this.data.transport,
+          tools_number: this.data.toolsNumber,
+          resources_number: this.data.resourcesNumber,
+          prompts_number: this.data.promptsNumber,
+          auth: this.data.auth,
+          name: this.data.name,
+          description: this.data.description ?? null,
+          base_url: this.data.baseUrl ?? null,
+          tool_names: this.data.toolNames ?? null,
+          resource_names: this.data.resourceNames ?? null,
+          prompt_names: this.data.promptNames ?? null,
+          tools: this.data.tools ?? null,
+          resources: this.data.resources ?? null,
+          prompts: this.data.prompts ?? null,
+          templates: this.data.templates ?? null,
+          capabilities: this.data.capabilities ? JSON.stringify(this.data.capabilities) : null,
+          apps_sdk_resources: this.data.appsSdkResources ? JSON.stringify(this.data.appsSdkResources) : null,
+          apps_sdk_resources_number: this.data.appsSdkResourcesNumber ?? 0,
+          mcp_ui_resources: this.data.mcpUiResources ? JSON.stringify(this.data.mcpUiResources) : null,
+          mcp_ui_resources_number: this.data.mcpUiResourcesNumber ?? 0,
+          mcp_apps_resources: this.data.mcpAppsResources ? JSON.stringify(this.data.mcpAppsResources) : null,
+          mcp_apps_resources_number: this.data.mcpAppsResourcesNumber ?? 0
+        };
+      }
+    };
+    ServerInitializeEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerInitializeEvent");
+      }
+      get name() {
+        return "server_initialize_call";
+      }
+      get properties() {
+        return {
+          protocol_version: this.data.protocolVersion,
+          client_info: JSON.stringify(this.data.clientInfo),
+          client_capabilities: JSON.stringify(this.data.clientCapabilities),
+          session_id: this.data.sessionId ?? null
+        };
+      }
+    };
+    ServerToolCallEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerToolCallEvent");
+      }
+      get name() {
+        return "server_tool_call";
+      }
+      get properties() {
+        return {
+          tool_name: this.data.toolName,
+          length_input_argument: this.data.lengthInputArgument,
+          success: this.data.success,
+          error_type: this.data.errorType ?? null,
+          execution_time_ms: this.data.executionTimeMs ?? null
+        };
+      }
+    };
+    ServerResourceCallEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerResourceCallEvent");
+      }
+      get name() {
+        return "server_resource_call";
+      }
+      get properties() {
+        return {
+          name: this.data.name,
+          description: this.data.description,
+          contents: this.data.contents,
+          success: this.data.success,
+          error_type: this.data.errorType ?? null
+        };
+      }
+    };
+    ServerPromptCallEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerPromptCallEvent");
+      }
+      get name() {
+        return "server_prompt_call";
+      }
+      get properties() {
+        return {
+          name: this.data.name,
+          description: this.data.description,
+          success: this.data.success,
+          error_type: this.data.errorType ?? null
+        };
+      }
+    };
+    ServerContextEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerContextEvent");
+      }
+      get name() {
+        return `server_context_${this.data.contextType}`;
+      }
+      get properties() {
+        return {
+          context_type: this.data.contextType,
+          notification_type: this.data.notificationType ?? null
+        };
+      }
+    };
+    MCPClientInitEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "MCPClientInitEvent");
+      }
+      get name() {
+        return "mcpclient_init";
+      }
+      get properties() {
+        return {
+          code_mode: this.data.codeMode,
+          sandbox: this.data.sandbox,
+          all_callbacks: this.data.allCallbacks,
+          verify: this.data.verify,
+          servers: this.data.servers,
+          num_servers: this.data.numServers,
+          is_browser: this.data.isBrowser
+        };
+      }
+    };
+    ConnectorInitEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ConnectorInitEvent");
+      }
+      get name() {
+        return "connector_init";
+      }
+      get properties() {
+        return {
+          connector_type: this.data.connectorType,
+          server_command: this.data.serverCommand ?? null,
+          server_args: this.data.serverArgs ?? null,
+          server_url: this.data.serverUrl ?? null,
+          public_identifier: this.data.publicIdentifier ?? null
+        };
+      }
+    };
+    ClientAddServerEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ClientAddServerEvent");
+      }
+      get name() {
+        return "client_add_server";
+      }
+      get properties() {
+        const { serverName, serverConfig } = this.data;
+        const url = serverConfig.url;
+        return {
+          server_name: serverName,
+          server_url_domain: url ? this._extractHostname(url) : null,
+          transport: serverConfig.transport ?? null,
+          has_auth: !!(serverConfig.authToken || serverConfig.authProvider)
+        };
+      }
+      _extractHostname(url) {
+        try {
+          return new URL(url).hostname;
+        } catch {
+          return null;
+        }
+      }
+    };
+    ClientRemoveServerEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ClientRemoveServerEvent");
+      }
+      get name() {
+        return "client_remove_server";
+      }
+      get properties() {
+        return {
+          server_name: this.data.serverName
+        };
+      }
+    };
+  }
+});
+
 // src/server/utils/runtime.ts
 function getEnv(key) {
   if (isDeno) {
@@ -68,57 +422,1005 @@ var init_runtime = __esm({
           const data = await globalThis.Deno.readFile(path);
           return data.buffer;
         }
-        const { readFileSync } = await import("fs");
-        const buffer = readFileSync(path);
-        return buffer.buffer.slice(
-          buffer.byteOffset,
-          buffer.byteOffset + buffer.byteLength
-        );
-      },
-      async existsSync(path) {
-        if (isDeno) {
+        const { readFileSync } = await import("fs");
+        const buffer = readFileSync(path);
+        return buffer.buffer.slice(
+          buffer.byteOffset,
+          buffer.byteOffset + buffer.byteLength
+        );
+      },
+      async existsSync(path) {
+        if (isDeno) {
+          try {
+            await globalThis.Deno.stat(path);
+            return true;
+          } catch {
+            return false;
+          }
+        }
+        const { existsSync } = await import("fs");
+        return existsSync(path);
+      },
+      async readdirSync(path) {
+        if (isDeno) {
+          const entries = [];
+          for await (const entry of globalThis.Deno.readDir(path)) {
+            entries.push(entry.name);
+          }
+          return entries;
+        }
+        const { readdirSync } = await import("fs");
+        return readdirSync(path);
+      }
+    };
+    pathHelpers = {
+      join(...paths) {
+        if (isDeno) {
+          return paths.join("/").replace(/\/+/g, "/");
+        }
+        return paths.join("/").replace(/\/+/g, "/");
+      },
+      relative(from, to) {
+        const fromParts = from.split("/").filter((p) => p);
+        const toParts = to.split("/").filter((p) => p);
+        let i = 0;
+        while (i < fromParts.length && i < toParts.length && fromParts[i] === toParts[i]) {
+          i++;
+        }
+        const upCount = fromParts.length - i;
+        const relativeParts = [...Array(upCount).fill(".."), ...toParts.slice(i)];
+        return relativeParts.join("/");
+      }
+    };
+    __name(generateUUID, "generateUUID");
+  }
+});
+
+// src/logging.ts
+async function getNodeModules() {
+  if (typeof process !== "undefined" && process.platform) {
+    try {
+      const fs = await import("fs");
+      const path = await import("path");
+      return { fs: fs.default, path: path.default };
+    } catch {
+      return { fs: null, path: null };
+    }
+  }
+  return { fs: null, path: null };
+}
+function loadWinstonSync() {
+  if (typeof require !== "undefined") {
+    try {
+      winston = require("winston");
+    } catch {
+    }
+  }
+}
+async function getWinston() {
+  if (!winston) {
+    winston = await import("winston");
+  }
+  return winston;
+}
+function isNodeJSEnvironment() {
+  try {
+    if (typeof navigator !== "undefined" && navigator.userAgent?.includes("Cloudflare-Workers")) {
+      return false;
+    }
+    if (typeof globalThis.EdgeRuntime !== "undefined" || typeof globalThis.Deno !== "undefined") {
+      return false;
+    }
+    const hasNodeGlobals = typeof process !== "undefined" && typeof process.platform !== "undefined" && typeof __dirname !== "undefined";
+    return hasNodeGlobals;
+  } catch {
+    return false;
+  }
+}
+function resolveLevel(env) {
+  const envValue = typeof process !== "undefined" && process.env ? env : void 0;
+  switch (envValue?.trim()) {
+    case "2":
+      return "debug";
+    case "1":
+      return "info";
+    default:
+      return "info";
+  }
+}
+var winston, DEFAULT_LOGGER_NAME, SimpleConsoleLogger, Logger, logger;
+var init_logging = __esm({
+  "src/logging.ts"() {
+    "use strict";
+    __name(getNodeModules, "getNodeModules");
+    winston = null;
+    __name(loadWinstonSync, "loadWinstonSync");
+    __name(getWinston, "getWinston");
+    DEFAULT_LOGGER_NAME = "mcp-use";
+    __name(isNodeJSEnvironment, "isNodeJSEnvironment");
+    SimpleConsoleLogger = class {
+      static {
+        __name(this, "SimpleConsoleLogger");
+      }
+      _level;
+      name;
+      constructor(name = DEFAULT_LOGGER_NAME, level = "info") {
+        this.name = name;
+        this._level = level;
+      }
+      shouldLog(level) {
+        const levels = [
+          "error",
+          "warn",
+          "info",
+          "http",
+          "verbose",
+          "debug",
+          "silly"
+        ];
+        const currentIndex = levels.indexOf(this._level);
+        const messageIndex = levels.indexOf(level);
+        return messageIndex <= currentIndex;
+      }
+      formatMessage(level, message) {
+        const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
+        return `${timestamp} [${this.name}] ${level}: ${message}`;
+      }
+      error(message) {
+        if (this.shouldLog("error")) {
+          console.error(this.formatMessage("error", message));
+        }
+      }
+      warn(message) {
+        if (this.shouldLog("warn")) {
+          console.warn(this.formatMessage("warn", message));
+        }
+      }
+      info(message) {
+        if (this.shouldLog("info")) {
+          console.info(this.formatMessage("info", message));
+        }
+      }
+      debug(message) {
+        if (this.shouldLog("debug")) {
+          console.debug(this.formatMessage("debug", message));
+        }
+      }
+      http(message) {
+        if (this.shouldLog("http")) {
+          console.log(this.formatMessage("http", message));
+        }
+      }
+      verbose(message) {
+        if (this.shouldLog("verbose")) {
+          console.log(this.formatMessage("verbose", message));
+        }
+      }
+      silly(message) {
+        if (this.shouldLog("silly")) {
+          console.log(this.formatMessage("silly", message));
+        }
+      }
+      // Make it compatible with Winston interface
+      get level() {
+        return this._level;
+      }
+      set level(newLevel) {
+        this._level = newLevel;
+      }
+    };
+    __name(resolveLevel, "resolveLevel");
+    Logger = class {
+      static {
+        __name(this, "Logger");
+      }
+      static instances = {};
+      static simpleInstances = {};
+      static currentFormat = "minimal";
+      static get(name = DEFAULT_LOGGER_NAME) {
+        if (!isNodeJSEnvironment()) {
+          if (!this.simpleInstances[name]) {
+            const debugEnv = typeof process !== "undefined" && process.env?.DEBUG || void 0;
+            this.simpleInstances[name] = new SimpleConsoleLogger(
+              name,
+              resolveLevel(debugEnv)
+            );
+          }
+          return this.simpleInstances[name];
+        }
+        if (!this.instances[name]) {
+          if (!winston) {
+            throw new Error("Winston not loaded - call Logger.configure() first");
+          }
+          const { createLogger, format } = winston;
+          const { combine, timestamp, label, colorize, splat } = format;
+          this.instances[name] = createLogger({
+            level: resolveLevel(process.env.DEBUG),
+            format: combine(
+              colorize(),
+              splat(),
+              label({ label: name }),
+              timestamp({ format: "HH:mm:ss" }),
+              this.getFormatter()
+            ),
+            transports: []
+          });
+        }
+        return this.instances[name];
+      }
+      static getFormatter() {
+        if (!winston) {
+          throw new Error("Winston not loaded");
+        }
+        const { format } = winston;
+        const { printf } = format;
+        const minimalFormatter = printf(({ level, message, label, timestamp }) => {
+          return `${timestamp} [${label}] ${level}: ${message}`;
+        });
+        const detailedFormatter = printf(({ level, message, label, timestamp }) => {
+          return `${timestamp} [${label}] ${level.toUpperCase()}: ${message}`;
+        });
+        const emojiFormatter = printf(({ level, message, label, timestamp }) => {
+          return `${timestamp} [${label}] ${level.toUpperCase()}: ${message}`;
+        });
+        switch (this.currentFormat) {
+          case "minimal":
+            return minimalFormatter;
+          case "detailed":
+            return detailedFormatter;
+          case "emoji":
+            return emojiFormatter;
+          default:
+            return minimalFormatter;
+        }
+      }
+      static async configure(options = {}) {
+        const { level, console: console2 = true, file, format = "minimal" } = options;
+        const debugEnv = typeof process !== "undefined" && process.env?.DEBUG || void 0;
+        const resolvedLevel = level ?? resolveLevel(debugEnv);
+        this.currentFormat = format;
+        if (!isNodeJSEnvironment()) {
+          Object.values(this.simpleInstances).forEach((logger2) => {
+            logger2.level = resolvedLevel;
+          });
+          return;
+        }
+        await getWinston();
+        if (!winston) {
+          throw new Error("Failed to load winston");
+        }
+        const root = this.get();
+        root.level = resolvedLevel;
+        const winstonRoot = root;
+        winstonRoot.clear();
+        if (console2) {
+          winstonRoot.add(new winston.transports.Console());
+        }
+        if (file) {
+          const { fs: nodeFs, path: nodePath } = await getNodeModules();
+          if (nodeFs && nodePath) {
+            const dir = nodePath.dirname(nodePath.resolve(file));
+            if (!nodeFs.existsSync(dir)) {
+              nodeFs.mkdirSync(dir, { recursive: true });
+            }
+            winstonRoot.add(new winston.transports.File({ filename: file }));
+          }
+        }
+        const { format: winstonFormat } = winston;
+        const { combine, timestamp, label, colorize, splat } = winstonFormat;
+        Object.values(this.instances).forEach((logger2) => {
+          if (logger2 && "format" in logger2) {
+            logger2.level = resolvedLevel;
+            logger2.format = combine(
+              colorize(),
+              splat(),
+              label({ label: DEFAULT_LOGGER_NAME }),
+              timestamp({ format: "HH:mm:ss" }),
+              this.getFormatter()
+            );
+          }
+        });
+      }
+      static setDebug(enabled) {
+        let level;
+        if (enabled === 2 || enabled === true) level = "debug";
+        else if (enabled === 1) level = "info";
+        else level = "info";
+        Object.values(this.simpleInstances).forEach((logger2) => {
+          logger2.level = level;
+        });
+        Object.values(this.instances).forEach((logger2) => {
+          if (logger2) {
+            logger2.level = level;
+          }
+        });
+        if (typeof process !== "undefined" && process.env) {
+          process.env.DEBUG = enabled ? enabled === true ? "2" : String(enabled) : "0";
+        }
+      }
+      static setFormat(format) {
+        this.currentFormat = format;
+        this.configure({ format });
+      }
+    };
+    if (isNodeJSEnvironment()) {
+      loadWinstonSync();
+      if (winston) {
+        Logger.configure();
+      }
+    }
+    logger = Logger.get();
+  }
+});
+
+// src/version.ts
+function getPackageVersion() {
+  return VERSION;
+}
+var VERSION;
+var init_version = __esm({
+  "src/version.ts"() {
+    "use strict";
+    VERSION = "1.10.0-canary.11";
+    __name(getPackageVersion, "getPackageVersion");
+  }
+});
+
+// src/telemetry/utils.ts
+var init_utils = __esm({
+  "src/telemetry/utils.ts"() {
+    "use strict";
+    init_version();
+  }
+});
+
+// src/telemetry/telemetry.ts
+function detectRuntimeEnvironment() {
+  try {
+    if (typeof globalThis.Bun !== "undefined") {
+      return "bun";
+    }
+    if (typeof globalThis.Deno !== "undefined") {
+      return "deno";
+    }
+    if (typeof navigator !== "undefined" && navigator.userAgent?.includes("Cloudflare-Workers")) {
+      return "cloudflare-workers";
+    }
+    if (typeof globalThis.EdgeRuntime !== "undefined") {
+      return "edge";
+    }
+    if (typeof window !== "undefined" && typeof document !== "undefined") {
+      return "browser";
+    }
+    if (typeof process !== "undefined" && typeof process.versions?.node !== "undefined") {
+      return "node";
+    }
+    return "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function getStorageCapability(env) {
+  switch (env) {
+    case "node":
+    case "bun":
+      return "filesystem";
+    case "browser":
+      try {
+        if (typeof localStorage !== "undefined") {
+          localStorage.setItem("__mcp_use_test__", "1");
+          localStorage.removeItem("__mcp_use_test__");
+          return "localStorage";
+        }
+      } catch {
+      }
+      return "session-only";
+    case "deno":
+      return "session-only";
+    default:
+      return "session-only";
+  }
+}
+function getRuntimeEnvironment() {
+  if (cachedEnvironment === null) {
+    cachedEnvironment = detectRuntimeEnvironment();
+  }
+  return cachedEnvironment;
+}
+var USER_ID_STORAGE_KEY, cachedEnvironment, ScarfEventLogger, Telemetry;
+var init_telemetry = __esm({
+  "src/telemetry/telemetry.ts"() {
+    "use strict";
+    init_runtime();
+    init_logging();
+    init_events();
+    init_utils();
+    USER_ID_STORAGE_KEY = "mcp_use_user_id";
+    __name(detectRuntimeEnvironment, "detectRuntimeEnvironment");
+    __name(getStorageCapability, "getStorageCapability");
+    cachedEnvironment = null;
+    __name(getRuntimeEnvironment, "getRuntimeEnvironment");
+    ScarfEventLogger = class {
+      static {
+        __name(this, "ScarfEventLogger");
+      }
+      endpoint;
+      timeout;
+      constructor(endpoint, timeout = 3e3) {
+        this.endpoint = endpoint;
+        this.timeout = timeout;
+      }
+      async logEvent(properties) {
+        try {
+          const controller = new AbortController();
+          const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+          const response = await fetch(this.endpoint, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json"
+            },
+            body: JSON.stringify(properties),
+            signal: controller.signal
+          });
+          clearTimeout(timeoutId);
+          if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+          }
+        } catch (error2) {
+          logger.debug(`Failed to send Scarf event: ${error2}`);
+        }
+      }
+    };
+    Telemetry = class _Telemetry {
+      static {
+        __name(this, "Telemetry");
+      }
+      static instance = null;
+      PROJECT_API_KEY = "phc_lyTtbYwvkdSbrcMQNPiKiiRWrrM1seyKIMjycSvItEI";
+      HOST = "https://eu.i.posthog.com";
+      SCARF_GATEWAY_URL = "https://mcpuse.gateway.scarf.sh/events-ts";
+      UNKNOWN_USER_ID = "UNKNOWN_USER_ID";
+      _currUserId = null;
+      _posthogNodeClient = null;
+      _posthogBrowserClient = null;
+      _posthogLoading = null;
+      _scarfClient = null;
+      _runtimeEnvironment;
+      _storageCapability;
+      _source;
+      // Node.js specific paths (lazily computed)
+      _userIdPath = null;
+      _versionDownloadPath = null;
+      constructor() {
+        this._runtimeEnvironment = getRuntimeEnvironment();
+        this._storageCapability = getStorageCapability(this._runtimeEnvironment);
+        this._source = typeof process !== "undefined" && process.env?.MCP_USE_TELEMETRY_SOURCE || this._runtimeEnvironment;
+        const telemetryDisabled = this._checkTelemetryDisabled();
+        const canSupportTelemetry = this._runtimeEnvironment !== "unknown";
+        if (telemetryDisabled) {
+          this._posthogNodeClient = null;
+          this._posthogBrowserClient = null;
+          this._scarfClient = null;
+          logger.debug("Telemetry disabled via environment/localStorage");
+        } else if (!canSupportTelemetry) {
+          this._posthogNodeClient = null;
+          this._posthogBrowserClient = null;
+          this._scarfClient = null;
+          logger.debug(
+            `Telemetry disabled - unknown environment: ${this._runtimeEnvironment}`
+          );
+        } else {
+          logger.info(
+            "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}`);
+            this._scarfClient = null;
+          }
+        }
+      }
+      _checkTelemetryDisabled() {
+        if (typeof process !== "undefined" && process.env?.MCP_USE_ANONYMIZED_TELEMETRY?.toLowerCase() === "false") {
+          return true;
+        }
+        if (typeof localStorage !== "undefined" && localStorage.getItem("MCP_USE_ANONYMIZED_TELEMETRY") === "false") {
+          return true;
+        }
+        return false;
+      }
+      async _initPostHog() {
+        const isBrowser = this._runtimeEnvironment === "browser";
+        if (isBrowser) {
+          await this._initPostHogBrowser();
+        } else {
+          await this._initPostHogNode();
+        }
+      }
+      async _initPostHogBrowser() {
+        try {
+          const posthogModule = await import("posthog-js");
+          const posthog = posthogModule.default || posthogModule.posthog;
+          if (!posthog || typeof posthog.init !== "function") {
+            throw new Error("posthog-js module did not export expected interface");
+          }
+          posthog.init(this.PROJECT_API_KEY, {
+            api_host: this.HOST,
+            persistence: "localStorage",
+            autocapture: false,
+            // We only want explicit captures
+            capture_pageview: false,
+            // We don't want automatic pageview tracking
+            disable_session_recording: true,
+            // No session recording
+            loaded: /* @__PURE__ */ __name(() => {
+              logger.debug("PostHog browser client initialized");
+            }, "loaded")
+          });
+          this._posthogBrowserClient = posthog;
+        } catch (e) {
+          logger.warn(`Failed to initialize PostHog browser telemetry: ${e}`);
+          this._posthogBrowserClient = null;
+        }
+      }
+      async _initPostHogNode() {
+        try {
+          const { PostHog } = await import("posthog-node");
+          const isServerlessEnvironment = [
+            "cloudflare-workers",
+            "edge",
+            "deno"
+          ].includes(this._runtimeEnvironment);
+          const posthogOptions = {
+            host: this.HOST,
+            disableGeoip: false
+          };
+          if (isServerlessEnvironment) {
+            posthogOptions.flushAt = 1;
+            posthogOptions.flushInterval = 0;
+          }
+          this._posthogNodeClient = new PostHog(
+            this.PROJECT_API_KEY,
+            posthogOptions
+          );
+          logger.debug("PostHog Node.js client initialized");
+        } catch (e) {
+          logger.warn(`Failed to initialize PostHog Node.js telemetry: ${e}`);
+          this._posthogNodeClient = null;
+        }
+      }
+      /**
+       * Get the detected runtime environment
+       */
+      get runtimeEnvironment() {
+        return this._runtimeEnvironment;
+      }
+      /**
+       * Get the storage capability for this environment
+       */
+      get storageCapability() {
+        return this._storageCapability;
+      }
+      static getInstance() {
+        if (!_Telemetry.instance) {
+          _Telemetry.instance = new _Telemetry();
+        }
+        return _Telemetry.instance;
+      }
+      /**
+       * Set the source identifier for telemetry events.
+       * This allows tracking usage from different applications.
+       * @param source - The source identifier (e.g., "my-app", "cli", "vs-code-extension")
+       */
+      setSource(source) {
+        this._source = source;
+        logger.debug(`Telemetry source set to: ${source}`);
+      }
+      /**
+       * Get the current source identifier.
+       */
+      getSource() {
+        return this._source;
+      }
+      /**
+       * Check if telemetry is enabled.
+       */
+      get isEnabled() {
+        return this._posthogNodeClient !== null || this._posthogBrowserClient !== null || this._scarfClient !== null;
+      }
+      get userId() {
+        if (this._currUserId) {
+          return this._currUserId;
+        }
+        try {
+          switch (this._storageCapability) {
+            case "filesystem":
+              this._currUserId = this._getUserIdFromFilesystem();
+              break;
+            case "localStorage":
+              this._currUserId = this._getUserIdFromLocalStorage();
+              break;
+            case "session-only":
+            default:
+              this._currUserId = `session-${generateUUID()}`;
+              logger.debug(
+                `Using session-based user ID (${this._runtimeEnvironment} environment)`
+              );
+              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)
+       */
+      _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;
+        }
+        return fs.readFileSync(this._userIdPath, "utf-8").trim();
+      }
+      /**
+       * Get or create user ID from localStorage (Browser)
+       */
+      _getUserIdFromLocalStorage() {
+        try {
+          let userId = localStorage.getItem(USER_ID_STORAGE_KEY);
+          if (!userId) {
+            userId = generateUUID();
+            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()}`;
+        }
+      }
+      _getCacheHome(os, path) {
+        const envVar = process.env.XDG_CACHE_HOME;
+        if (envVar && path.isAbsolute(envVar)) {
+          return envVar;
+        }
+        const platform = process.platform;
+        const homeDir = os.homedir();
+        if (platform === "win32") {
+          const appdata = process.env.LOCALAPPDATA || process.env.APPDATA;
+          if (appdata) {
+            return appdata;
+          }
+          return path.join(homeDir, "AppData", "Local");
+        } else if (platform === "darwin") {
+          return path.join(homeDir, "Library", "Caches");
+        } else {
+          return path.join(homeDir, ".cache");
+        }
+      }
+      async capture(event) {
+        if (this._posthogLoading) {
+          await this._posthogLoading;
+        }
+        if (!this._posthogNodeClient && !this._posthogBrowserClient && !this._scarfClient) {
+          return;
+        }
+        const properties = { ...event.properties };
+        properties.mcp_use_version = getPackageVersion();
+        properties.language = "typescript";
+        properties.source = this._source;
+        properties.runtime = this._runtimeEnvironment;
+        if (this._posthogNodeClient) {
+          try {
+            logger.debug(`CAPTURE: PostHog Node Event ${event.name}`);
+            this._posthogNodeClient.capture({
+              distinctId: this.userId,
+              event: event.name,
+              properties
+            });
+          } catch (e) {
+            logger.debug(`Failed to track PostHog Node event ${event.name}: ${e}`);
+          }
+        }
+        if (this._posthogBrowserClient) {
+          try {
+            logger.debug(`CAPTURE: PostHog Browser Event ${event.name}`);
+            this._posthogBrowserClient.capture(event.name, {
+              ...properties,
+              distinct_id: this.userId
+            });
+          } catch (e) {
+            logger.debug(
+              `Failed to track PostHog Browser event ${event.name}: ${e}`
+            );
+          }
+        }
+        if (this._scarfClient) {
+          try {
+            const scarfProperties = {
+              ...properties,
+              user_id: this.userId,
+              event: event.name
+            };
+            await this._scarfClient.logEvent(scarfProperties);
+          } catch (e) {
+            logger.debug(`Failed to track Scarf event ${event.name}: ${e}`);
+          }
+        }
+      }
+      // ============================================================================
+      // Package Download Tracking (Node.js only)
+      // ============================================================================
+      /**
+       * Track package download event.
+       * This is a public wrapper that safely accesses userId.
+       */
+      async trackPackageDownload(properties) {
+        return this._trackPackageDownloadInternal(this.userId, properties);
+      }
+      /**
+       * Internal method to track package download with explicit userId.
+       */
+      async _trackPackageDownloadInternal(userId, properties) {
+        if (!this._scarfClient) {
+          return;
+        }
+        if (this._storageCapability !== "filesystem") {
+          return;
+        }
+        try {
+          const fs = require("fs");
+          const path = require("path");
+          const os = require("os");
+          if (!this._versionDownloadPath) {
+            this._versionDownloadPath = path.join(
+              this._getCacheHome(os, path),
+              "mcp_use",
+              "download_version"
+            );
+          }
+          const currentVersion = getPackageVersion();
+          let shouldTrack = false;
+          let firstDownload = false;
+          if (!fs.existsSync(this._versionDownloadPath)) {
+            shouldTrack = true;
+            firstDownload = true;
+            fs.mkdirSync(path.dirname(this._versionDownloadPath), {
+              recursive: true
+            });
+            fs.writeFileSync(this._versionDownloadPath, currentVersion);
+          } else {
+            const savedVersion = fs.readFileSync(this._versionDownloadPath, "utf-8").trim();
+            if (currentVersion > savedVersion) {
+              shouldTrack = true;
+              firstDownload = false;
+              fs.writeFileSync(this._versionDownloadPath, currentVersion);
+            }
+          }
+          if (shouldTrack) {
+            logger.debug(
+              `Tracking package download event with properties: ${JSON.stringify(properties)}`
+            );
+            const eventProperties = { ...properties || {} };
+            eventProperties.mcp_use_version = currentVersion;
+            eventProperties.user_id = userId;
+            eventProperties.event = "package_download";
+            eventProperties.first_download = firstDownload;
+            eventProperties.language = "typescript";
+            eventProperties.source = this._source;
+            eventProperties.runtime = this._runtimeEnvironment;
+            await this._scarfClient.logEvent(eventProperties);
+          }
+        } catch (e) {
+          logger.debug(`Failed to track Scarf package_download event: ${e}`);
+        }
+      }
+      // ============================================================================
+      // Agent Events
+      // ============================================================================
+      async trackAgentExecution(data) {
+        if (!this.isEnabled) return;
+        const event = new MCPAgentExecutionEvent(data);
+        await this.capture(event);
+      }
+      // ============================================================================
+      // Server Events
+      // ============================================================================
+      /**
+       * Track server run event directly from an MCPServer instance.
+       */
+      async trackServerRunFromServer(server, transport) {
+        if (!this.isEnabled) return;
+        const data = createServerRunEventData(server, transport);
+        const event = new ServerRunEvent(data);
+        await this.capture(event);
+      }
+      async trackServerInitialize(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerInitializeEvent(data);
+        await this.capture(event);
+      }
+      async trackServerToolCall(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerToolCallEvent(data);
+        await this.capture(event);
+      }
+      async trackServerResourceCall(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerResourceCallEvent(data);
+        await this.capture(event);
+      }
+      async trackServerPromptCall(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerPromptCallEvent(data);
+        await this.capture(event);
+      }
+      async trackServerContext(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerContextEvent(data);
+        await this.capture(event);
+      }
+      // ============================================================================
+      // Client Events
+      // ============================================================================
+      async trackMCPClientInit(data) {
+        if (!this.isEnabled) return;
+        const event = new MCPClientInitEvent(data);
+        await this.capture(event);
+      }
+      async trackConnectorInit(data) {
+        if (!this.isEnabled) return;
+        const event = new ConnectorInitEvent(data);
+        await this.capture(event);
+      }
+      async trackClientAddServer(serverName, serverConfig) {
+        if (!this.isEnabled) return;
+        const event = new ClientAddServerEvent({ serverName, serverConfig });
+        await this.capture(event);
+      }
+      async trackClientRemoveServer(serverName) {
+        if (!this.isEnabled) return;
+        const event = new ClientRemoveServerEvent({ serverName });
+        await this.capture(event);
+      }
+      // ============================================================================
+      // React Hook / Browser specific events
+      // ============================================================================
+      async trackUseMcpConnection(data) {
+        if (!this.isEnabled) return;
+        await this.capture({
+          name: "usemcp_connection",
+          properties: {
+            url_domain: new URL(data.url).hostname,
+            // Only domain for privacy
+            transport_type: data.transportType,
+            success: data.success,
+            error_type: data.errorType ?? null,
+            connection_time_ms: data.connectionTimeMs ?? null,
+            has_oauth: data.hasOAuth,
+            has_sampling: data.hasSampling,
+            has_elicitation: data.hasElicitation
+          }
+        });
+      }
+      async trackUseMcpToolCall(data) {
+        if (!this.isEnabled) return;
+        await this.capture({
+          name: "usemcp_tool_call",
+          properties: {
+            tool_name: data.toolName,
+            success: data.success,
+            error_type: data.errorType ?? null,
+            execution_time_ms: data.executionTimeMs ?? null
+          }
+        });
+      }
+      async trackUseMcpResourceRead(data) {
+        if (!this.isEnabled) return;
+        await this.capture({
+          name: "usemcp_resource_read",
+          properties: {
+            resource_uri_scheme: data.resourceUri.split(":")[0],
+            // Only scheme for privacy
+            success: data.success,
+            error_type: data.errorType ?? null
+          }
+        });
+      }
+      // ============================================================================
+      // Browser-specific Methods
+      // ============================================================================
+      /**
+       * Identify the current user (useful for linking sessions)
+       * Browser only - no-op in Node.js
+       */
+      identify(userId, properties) {
+        if (this._posthogBrowserClient) {
           try {
-            await globalThis.Deno.stat(path);
-            return true;
-          } catch {
-            return false;
+            this._posthogBrowserClient.identify(userId, properties);
+          } catch (e) {
+            logger.debug(`Failed to identify user: ${e}`);
           }
         }
-        const { existsSync } = await import("fs");
-        return existsSync(path);
-      },
-      async readdirSync(path) {
-        if (isDeno) {
-          const entries = [];
-          for await (const entry of globalThis.Deno.readDir(path)) {
-            entries.push(entry.name);
+      }
+      /**
+       * Reset the user identity (useful for logout)
+       * Browser only - no-op in Node.js
+       */
+      reset() {
+        if (this._posthogBrowserClient) {
+          try {
+            this._posthogBrowserClient.reset();
+          } catch (e) {
+            logger.debug(`Failed to reset user: ${e}`);
           }
-          return entries;
         }
-        const { readdirSync } = await import("fs");
-        return readdirSync(path);
+        this._currUserId = null;
       }
-    };
-    pathHelpers = {
-      join(...paths) {
-        if (isDeno) {
-          return paths.join("/").replace(/\/+/g, "/");
+      // ============================================================================
+      // Node.js-specific Methods
+      // ============================================================================
+      /**
+       * Flush the telemetry queue (Node.js only)
+       */
+      flush() {
+        if (this._posthogNodeClient) {
+          try {
+            this._posthogNodeClient.flush();
+            logger.debug("PostHog client telemetry queue flushed");
+          } catch (e) {
+            logger.debug(`Failed to flush PostHog client: ${e}`);
+          }
         }
-        return paths.join("/").replace(/\/+/g, "/");
-      },
-      relative(from, to) {
-        const fromParts = from.split("/").filter((p) => p);
-        const toParts = to.split("/").filter((p) => p);
-        let i = 0;
-        while (i < fromParts.length && i < toParts.length && fromParts[i] === toParts[i]) {
-          i++;
+      }
+      /**
+       * Shutdown the telemetry client (Node.js only)
+       */
+      shutdown() {
+        if (this._posthogNodeClient) {
+          try {
+            this._posthogNodeClient.shutdown();
+            logger.debug("PostHog client shutdown successfully");
+          } catch (e) {
+            logger.debug(`Error shutting down PostHog client: ${e}`);
+          }
         }
-        const upCount = fromParts.length - i;
-        const relativeParts = [...Array(upCount).fill(".."), ...toParts.slice(i)];
-        return relativeParts.join("/");
       }
     };
-    __name(generateUUID, "generateUUID");
+  }
+});
+
+// src/telemetry/index.ts
+var init_telemetry2 = __esm({
+  "src/telemetry/index.ts"() {
+    "use strict";
+    init_events();
+    init_telemetry();
+    init_utils();
   }
 });
 
@@ -373,6 +1675,9 @@ function createSampleMethod(createMessage, progressToken, sendNotification2) {
         `Sampling timed out after ${timeout}ms`
       );
       console.log("[SAMPLING DEBUG] Got result:", result);
+      Telemetry.getInstance().trackServerContext({
+        contextType: "sample"
+      }).catch((e) => console.debug(`Failed to track sample context: ${e}`));
       return result;
     } catch (error2) {
       console.error("[SAMPLING DEBUG] Error during sampling:", error2);
@@ -395,6 +1700,9 @@ function createElicitMethod(elicitInput) {
     const { timeout } = options ?? {};
     const sdkTimeout = timeout && timeout !== Infinity ? timeout : 2147483647;
     const result = await elicitInput(sdkParams, { timeout: sdkTimeout });
+    Telemetry.getInstance().trackServerContext({
+      contextType: "elicit"
+    }).catch((e) => console.debug(`Failed to track elicit context: ${e}`));
     if (zodSchema && result.action === "accept" && result.data) {
       try {
         const validatedData = zodSchema.parse(result.data);
@@ -403,9 +1711,10 @@ function createElicitMethod(elicitInput) {
           data: validatedData
         };
       } catch (error2) {
+        const err = error2;
         throw new ElicitationValidationError(
-          `Elicitation data validation failed: ${error2.message}`,
-          error2
+          `Elicitation data validation failed: ${err.message}`,
+          err
         );
       }
     }
@@ -442,7 +1751,7 @@ function createLogMethod(sendNotification2, minLogLevel) {
   if (!sendNotification2) {
     return void 0;
   }
-  return async (level, message, logger) => {
+  return async (level, message, logger2) => {
     if (!shouldLogMessage(level, minLogLevel)) {
       return;
     }
@@ -451,12 +1760,78 @@ function createLogMethod(sendNotification2, minLogLevel) {
       params: {
         level,
         data: message,
-        logger: logger || "tool"
+        logger: logger2 || "tool"
       }
     });
+    Telemetry.getInstance().trackServerContext({
+      contextType: "notification",
+      notificationType: "message"
+    }).catch(
+      (e) => console.debug(`Failed to track notification context: ${e}`)
+    );
+  };
+}
+function createClientCapabilityChecker(clientCapabilities) {
+  const caps = clientCapabilities || {};
+  return {
+    can(capability) {
+      return capability in caps;
+    },
+    capabilities() {
+      return { ...caps };
+    }
+  };
+}
+function createSendNotificationMethod(sessionId, sessions) {
+  if (!sessionId || !sessions) {
+    return void 0;
+  }
+  return async (method, params) => {
+    const session = sessions.get(sessionId);
+    if (!session?.sendNotification) {
+      console.warn(
+        `[MCP] Cannot send notification to session ${sessionId} - no sendNotification function`
+      );
+      return;
+    }
+    try {
+      await session.sendNotification({
+        method,
+        params: params || {}
+      });
+    } catch (error2) {
+      console.error(
+        `[MCP] Error sending notification to session ${sessionId}:`,
+        error2
+      );
+    }
   };
 }
-function createEnhancedContext(baseContext, createMessage, elicitInput, progressToken, sendNotification2, minLogLevel) {
+function createSendNotificationToSessionMethod(sessions) {
+  if (!sessions) {
+    return void 0;
+  }
+  return async (sessionId, method, params) => {
+    const session = sessions.get(sessionId);
+    if (!session?.sendNotification) {
+      return false;
+    }
+    try {
+      await session.sendNotification({
+        method,
+        params: params || {}
+      });
+      return true;
+    } catch (error2) {
+      console.error(
+        `[MCP] Error sending notification to session ${sessionId}:`,
+        error2
+      );
+      return false;
+    }
+  };
+}
+function createEnhancedContext(baseContext, createMessage, elicitInput, progressToken, sendNotification2, minLogLevel, clientCapabilities, sessionId, sessions) {
   const enhancedContext = baseContext ? Object.create(baseContext) : {};
   enhancedContext.sample = createSampleMethod(
     createMessage,
@@ -469,15 +1844,33 @@ function createEnhancedContext(baseContext, createMessage, elicitInput, progress
     sendNotification2
   );
   enhancedContext.log = createLogMethod(sendNotification2, minLogLevel);
+  enhancedContext.client = createClientCapabilityChecker(clientCapabilities);
+  if (sessionId) {
+    enhancedContext.session = {
+      sessionId
+    };
+  }
+  const sendNotificationMethod = createSendNotificationMethod(
+    sessionId,
+    sessions
+  );
+  if (sendNotificationMethod) {
+    enhancedContext.sendNotification = sendNotificationMethod;
+  }
+  const sendNotificationToSessionMethod = createSendNotificationToSessionMethod(sessions);
+  if (sendNotificationToSessionMethod) {
+    enhancedContext.sendNotificationToSession = sendNotificationToSessionMethod;
+  }
   return enhancedContext;
 }
 var import_zod_json_schema_compat, LOG_LEVELS, VALID_LOG_LEVELS;
 var init_tool_execution_helpers = __esm({
   "src/server/tools/tool-execution-helpers.ts"() {
     "use strict";
-    import_zod_json_schema_compat = require("@modelcontextprotocol/sdk/server/zod-json-schema-compat.js");
+    import_zod_json_schema_compat = require("@mcp-use/modelcontextprotocol-sdk/server/zod-json-schema-compat.js");
     init_errors();
     init_runtime();
+    init_telemetry2();
     __name(findSessionContext, "findSessionContext");
     __name(sendProgressNotification, "sendProgressNotification");
     __name(withTimeout, "withTimeout");
@@ -508,6 +1901,9 @@ var init_tool_execution_helpers = __esm({
     __name(isValidLogLevel, "isValidLogLevel");
     __name(shouldLogMessage, "shouldLogMessage");
     __name(createLogMethod, "createLogMethod");
+    __name(createClientCapabilityChecker, "createClientCapabilityChecker");
+    __name(createSendNotificationMethod, "createSendNotificationMethod");
+    __name(createSendNotificationToSessionMethod, "createSendNotificationToSessionMethod");
     __name(createEnhancedContext, "createEnhancedContext");
   }
 });
@@ -705,6 +2101,8 @@ var init_conversion2 = __esm({
 // src/server/index.ts
 var server_exports = {};
 __export(server_exports, {
+  MCPServer: () => MCPServer,
+  VERSION: () => VERSION,
   adaptConnectMiddleware: () => adaptConnectMiddleware,
   adaptMiddleware: () => adaptMiddleware,
   array: () => array,
@@ -719,6 +2117,7 @@ __export(server_exports, {
   css: () => css,
   error: () => error,
   getAuth: () => getAuth,
+  getPackageVersion: () => getPackageVersion,
   getRequestContext: () => getRequestContext,
   hasAnyScope: () => hasAnyScope,
   hasRequestContext: () => hasRequestContext,
@@ -746,9 +2145,11 @@ __export(server_exports, {
 module.exports = __toCommonJS(server_exports);
 
 // src/server/mcp-server.ts
-var import_mcp2 = require("@modelcontextprotocol/sdk/server/mcp.js");
-var import_types2 = require("@modelcontextprotocol/sdk/types.js");
+var import_mcp2 = require("@mcp-use/modelcontextprotocol-sdk/server/mcp.js");
+var import_types2 = require("@mcp-use/modelcontextprotocol-sdk/types.js");
 var import_zod2 = require("zod");
+init_telemetry2();
+init_version();
 
 // src/server/widgets/index.ts
 init_runtime();
@@ -1026,37 +2427,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
@@ -1734,6 +3110,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,
@@ -1749,7 +3126,8 @@ function createWidgetRegistration(widgetName, metadata, html2, serverConfig, isD
         type: "appsSdk",
         props,
         html: html2,
-        dev: isDev
+        dev: isDev,
+        exposeAsTool
       },
       ...metadata._meta || {}
     },
@@ -2029,10 +3407,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)
@@ -2053,12 +3463,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
@@ -2317,25 +3730,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:
@@ -2344,12 +3763,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,
@@ -2371,9 +3790,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,
@@ -2398,70 +3817,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");
 
@@ -2599,7 +4025,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,
@@ -2610,7 +4036,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) {
@@ -2633,11 +4061,11 @@ __name(toolRegistration, "toolRegistration");
 init_tool_execution_helpers();
 
 // src/server/resources/index.ts
-var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_mcp = require("@mcp-use/modelcontextprotocol-sdk/server/mcp.js");
 init_conversion();
 
 // src/server/resources/subscriptions.ts
-var import_types = require("@modelcontextprotocol/sdk/types.js");
+var import_types = require("@mcp-use/modelcontextprotocol-sdk/types.js");
 init_context_storage();
 var ResourceSubscriptionManager = class {
   static {
@@ -2839,24 +4267,25 @@ function registerResourceTemplate(resourceTemplateDefinition, callback) {
       `Resource template '${resourceTemplateDefinition.name}' must have either a readCallback property or a callback parameter`
     );
   }
-  const template = new import_mcp.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 import_mcp.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;
@@ -2866,10 +4295,7 @@ function registerResourceTemplate(resourceTemplateDefinition, callback) {
     template,
     metadata,
     async (uri) => {
-      const params = this.parseTemplateUri(
-        resourceTemplateDefinition.resourceTemplate.uriTemplate,
-        uri.toString()
-      );
+      const params = this.parseTemplateUri(uriTemplate, uri.toString());
       const { getRequestContext: getRequestContext2, runWithContext: runWithContext2 } = await Promise.resolve().then(() => (init_context_storage(), context_storage_exports));
       const { findSessionContext: findSessionContext2 } = await Promise.resolve().then(() => (init_tool_execution_helpers(), tool_execution_helpers_exports));
       const initialRequestContext = getRequestContext2();
@@ -2884,8 +4310,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)) {
@@ -3229,8 +4659,9 @@ __name(startIdleCleanup, "startIdleCleanup");
 
 // src/server/endpoints/mount-mcp.ts
 init_runtime();
+init_telemetry2();
 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;
@@ -3266,6 +4697,27 @@ 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}`);
@@ -3509,12 +4961,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 || []
       };
@@ -3562,9 +5015,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
@@ -3588,8 +5048,6 @@ var McpServer = class {
   buildId;
   sessions = /* @__PURE__ */ new Map();
   idleCleanupInterval;
-  oauthConfig;
-  // Store OAuth config for lazy initialization
   oauthSetupState = {
     complete: false,
     provider: void 0,
@@ -3598,15 +5056,21 @@ 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
    */
@@ -3631,7 +5095,7 @@ 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;
@@ -3653,12 +5117,12 @@ var McpServer = class {
       }
     );
     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() {
@@ -3668,38 +5132,94 @@ 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.
@@ -3717,8 +5237,8 @@ var McpServer = class {
         }
       }
     );
-    for (const [name, recipe] of this.registrationRecipes.tools) {
-      const { config, handler: actualCallback } = recipe;
+    for (const [name, registration] of this.registrations.tools) {
+      const { config, handler: actualCallback } = registration;
       let inputSchema;
       if (config.schema) {
         inputSchema = this.convertZodSchemaToParams(config.schema);
@@ -3737,6 +5257,15 @@ var McpServer = class {
           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);
@@ -3748,11 +5277,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;
           }
@@ -3763,7 +5293,10 @@ var McpServer = class {
           newServer.server.elicitInput.bind(newServer.server),
           progressToken,
           sendNotification2,
-          session?.logLevel
+          session?.logLevel,
+          session?.clientCapabilities,
+          sessionId,
+          this.sessions
         );
         const executeCallback = /* @__PURE__ */ __name(async () => {
           if (actualCallback.length >= 2) {
@@ -3771,10 +5304,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,
@@ -3788,8 +5337,8 @@ 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);
@@ -3798,13 +5347,28 @@ var McpServer = class {
       } else {
         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 Promise.resolve().then(() => (init_conversion2(), conversion_exports2));
+          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 Promise.resolve().then(() => (init_conversion2(), conversion_exports2));
-        return convertToolResultToPromptResult2(result);
       }, "wrappedHandler");
       newServer.registerPrompt(
         name,
@@ -3816,15 +5380,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 Promise.resolve().then(() => (init_conversion(), conversion_exports));
+          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 Promise.resolve().then(() => (init_conversion(), conversion_exports));
-        return convertToolResultToResourceResult2(config.uri, result);
       }, "wrappedHandler");
       newServer.registerResource(
         config.name,
@@ -3837,24 +5428,25 @@ var McpServer = class {
         wrappedHandler
       );
     }
-    for (const [_name, recipe] of this.registrationRecipes.resourceTemplates) {
-      const { config, handler } = recipe;
-      const template = new import_mcp2.ResourceTemplate(
-        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 import_mcp2.ResourceTemplate(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;
@@ -3863,23 +5455,49 @@ 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 Promise.resolve().then(() => (init_conversion(), conversion_exports));
+            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 Promise.resolve().then(() => (init_conversion(), conversion_exports));
-          return convertToolResultToResourceResult2(uri.toString(), result);
         }
       );
     }
     newServer.server.setRequestHandler(
       import_zod2.z.object({ method: import_zod2.z.literal("logging/setLevel") }).passthrough(),
-      async (request) => {
+      (async (request, extra) => {
         const level = request.params?.level;
         if (!level) {
           throw new import_types2.McpError(
@@ -3918,7 +5536,7 @@ var McpServer = class {
           "[MCP] Could not find session for logging/setLevel request"
         );
         throw new import_types2.McpError(import_types2.ErrorCode.InternalError, "Could not find session");
-      }
+      })
     );
     this.subscriptionManager.registerHandlers(newServer, this.sessions);
     return newServer;
@@ -3934,18 +5552,18 @@ 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;
@@ -3968,7 +5586,9 @@ var McpServer = class {
   async notifyResourceUpdated(uri) {
     return this.subscriptionManager.notifyResourceUpdated(uri, this.sessions);
   }
-  uiResource = uiResourceRegistration;
+  uiResource = /* @__PURE__ */ __name((definition) => {
+    return uiResourceRegistration(this, definition);
+  }, "uiResource");
   /**
    * Mount MCP server endpoints at /mcp and /sse
    *
@@ -3993,7 +5613,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()
@@ -4056,7 +5676,7 @@ var McpServer = class {
       this.serverHost,
       this.serverPort
     );
-    if (this.oauthConfig && !this.oauthSetupState.complete) {
+    if (this.oauthProvider && !this.oauthSetupState.complete) {
       await setupOAuthForServer(
         this.app,
         this.oauthProvider,
@@ -4071,10 +5691,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
    *
@@ -4093,7 +5717,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);
@@ -4102,14 +5726,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,
@@ -4128,6 +5752,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) => {
@@ -4179,8 +5805,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,
@@ -4196,6 +5823,7 @@ function createMCPServer(name, config = {}) {
 __name(createMCPServer, "createMCPServer");
 
 // src/server/index.ts
+init_version();
 init_context_storage();
 
 // src/server/oauth/providers/supabase.ts
@@ -4262,12 +5890,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
@@ -4340,6 +5969,7 @@ var Auth0OAuthProvider = class {
     }
   }
   getUserInfo(payload) {
+    const scope = payload.scope;
     return {
       userId: payload.sub,
       email: payload.email,
@@ -4352,7 +5982,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
@@ -4424,8 +6054,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) {
@@ -4439,6 +6071,7 @@ var KeycloakOAuthProvider = class {
         }
       );
     }
+    const scope = payload.scope;
     return {
       userId: payload.sub,
       email: payload.email,
@@ -4449,7 +6082,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,
@@ -4578,7 +6211,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}`);
     }
@@ -4587,16 +6220,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() {