@mcp-b/global 0.0.0-beta-20260109203913 → 0.0.0

package/dist/index.js

@@ -4,7 +4,90 @@ import { jsonSchemaToZod } from "@composio/json-schema-to-zod";
 import { z } from "zod";
 import { zodToJsonSchema as zodToJsonSchema$1 } from "zod-to-json-schema";
 
+//#region src/logger.ts
+/**
+* @license
+* Copyright 2025 Google LLC
+* SPDX-License-Identifier: Apache-2.0
+*/
+/**
+* Lightweight logging system for @mcp-b/global
+*
+* Design Decision: This implements a custom logger instead of using the 'debug'
+* package to reduce bundle size and eliminate external dependencies in the
+* browser build. The API is intentionally simpler, focusing on the specific
+* needs of browser-based MCP implementations.
+*
+* Configuration via localStorage:
+* - localStorage.setItem('WEBMCP_DEBUG', '*') - enable all debug logging
+* - localStorage.setItem('WEBMCP_DEBUG', 'WebModelContext') - enable specific namespace
+* - localStorage.setItem('WEBMCP_DEBUG', 'WebModelContext,NativeAdapter') - multiple namespaces
+* - localStorage.setItem('WEBMCP_DEBUG', 'WebModelContext:') - enable namespace and sub-namespaces
+* - localStorage.removeItem('WEBMCP_DEBUG') - disable debug logging (default)
+*
+* Environment Support:
+* - Automatically detects localStorage availability
+* - Gracefully degrades to "disabled" state when localStorage is inaccessible
+* - Never throws errors from configuration checks (safe for private browsing mode)
+*/
+/** localStorage key for debug configuration */
+const DEBUG_CONFIG_KEY = "WEBMCP_DEBUG";
+/**
+* Check if debug logging is enabled for a namespace
+*
+* Supports namespace hierarchy via colons. Setting 'WebModelContext' will match
+* both 'WebModelContext' and 'WebModelContext:init', but NOT 'WebModelContextTesting'.
+*/
+function isDebugEnabled(namespace) {
+	if (typeof window === "undefined" || !window.localStorage) return false;
+	try {
+		const debugConfig = localStorage.getItem(DEBUG_CONFIG_KEY);
+		if (!debugConfig) return false;
+		if (debugConfig === "*") return true;
+		return debugConfig.split(",").map((p) => p.trim()).some((pattern) => namespace === pattern || namespace.startsWith(`${pattern}:`));
+	} catch {
+		return false;
+	}
+}
+/**
+* No-op function for disabled log levels
+*/
+const noop = () => {};
+/**
+* Create a namespaced logger
+*
+* Uses .bind() to prepend namespace prefixes to console methods without manual
+* string concatenation. Debug enablement is determined at logger creation time
+* for performance - changes to localStorage after creation won't affect existing
+* loggers. Refresh the page to apply new WEBMCP_DEBUG settings.
+*
+* @param namespace - Namespace for the logger (e.g., 'WebModelContext', 'NativeAdapter')
+* @returns Logger instance with debug, info, warn, error methods
+*
+* @example
+* ```typescript
+* const logger = createLogger('WebModelContext');
+* logger.debug('Tool registered:', toolName); // Only shown if WEBMCP_DEBUG includes 'WebModelContext'
+* logger.error('Execution failed:', error); // Always enabled
+* ```
+*/
+function createLogger(namespace) {
+	const prefix = `[${namespace}]`;
+	const isDebug = isDebugEnabled(namespace);
+	const boundWarn = console.warn.bind(console, prefix);
+	const boundError = console.error.bind(console, prefix);
+	const boundLog = console.log.bind(console, prefix);
+	return {
+		warn: boundWarn,
+		error: boundError,
+		debug: isDebug ? boundLog : noop,
+		info: isDebug ? boundLog : noop
+	};
+}
+
+//#endregion
 //#region src/validation.ts
+const logger$2 = createLogger("WebModelContext");
 /**
 * Detect if a schema is a Zod schema object (Record<string, ZodType>)
 * or a JSON Schema object
@@ -24,7 +107,7 @@ function jsonSchemaToZod$1(jsonSchema) {
 	try {
 		return jsonSchemaToZod(jsonSchema);
 	} catch (error) {
-		console.warn("[Web Model Context] Failed to convert JSON Schema to Zod:", error);
+		logger$2.warn("Failed to convert JSON Schema to Zod:", error);
 		return z.object({}).passthrough();
 	}
 }
@@ -74,6 +157,10 @@ function validateWithZod(data, validator) {
 
 //#endregion
 //#region src/global.ts
+const logger$1 = createLogger("WebModelContext");
+const nativeLogger = createLogger("NativeAdapter");
+const bridgeLogger = createLogger("MCPBridge");
+const testingLogger = createLogger("ModelContextTesting");
 /**
 * Marker property name used to identify polyfill implementations.
 * This constant ensures single source of truth for the marker used in
@@ -142,7 +229,6 @@ var NativeModelContextAdapter = class {
 		this.nativeContext = nativeContext;
 		this.nativeTesting = nativeTesting;
 		this.nativeTesting.registerToolsChangedCallback(() => {
-			console.log("[Native Adapter] Tool change detected from native API");
 			this.syncToolsFromNative();
 		});
 		this.syncToolsFromNative();
@@ -159,7 +245,6 @@ var NativeModelContextAdapter = class {
 		this.syncInProgress = true;
 		try {
 			const nativeTools = this.nativeTesting.listTools();
-			console.log(`[Native Adapter] Syncing ${nativeTools.length} tools from native API`);
 			this.bridge.tools.clear();
 			for (const toolInfo of nativeTools) try {
 				const inputSchema = JSON.parse(toolInfo.inputSchema);
@@ -175,7 +260,7 @@ var NativeModelContextAdapter = class {
 				};
 				this.bridge.tools.set(toolInfo.name, validatedTool);
 			} catch (error) {
-				console.error(`[Native Adapter] Failed to sync tool "${toolInfo.name}":`, error);
+				nativeLogger.error(`Failed to sync tool "${toolInfo.name}":`, error);
 			}
 			this.notifyMCPServers();
 		} finally {
@@ -235,7 +320,6 @@ var NativeModelContextAdapter = class {
 	* @param {ModelContextInput} context - Context containing tools to register
 	*/
 	provideContext(context) {
-		console.log("[Native Adapter] Delegating provideContext to native API");
 		this.nativeContext.provideContext(context);
 	}
 	/**
@@ -247,7 +331,6 @@ var NativeModelContextAdapter = class {
 	* @returns {{unregister: () => void}} Object with unregister function
 	*/
 	registerTool(tool) {
-		console.log(`[Native Adapter] Delegating registerTool("${tool.name}") to native API`);
 		return this.nativeContext.registerTool(tool);
 	}
 	/**
@@ -257,7 +340,6 @@ var NativeModelContextAdapter = class {
 	* @param {string} name - Name of the tool to unregister
 	*/
 	unregisterTool(name) {
-		console.log(`[Native Adapter] Delegating unregisterTool("${name}") to native API`);
 		this.nativeContext.unregisterTool(name);
 	}
 	/**
@@ -265,7 +347,6 @@ var NativeModelContextAdapter = class {
 	* Delegates to navigator.modelContext.clearContext().
 	*/
 	clearContext() {
-		console.log("[Native Adapter] Delegating clearContext to native API");
 		this.nativeContext.clearContext();
 	}
 	/**
@@ -278,12 +359,11 @@ var NativeModelContextAdapter = class {
 	* @internal
 	*/
 	async executeTool(toolName, args) {
-		console.log(`[Native Adapter] Executing tool "${toolName}" via native API`);
 		try {
 			const result = await this.nativeTesting.executeTool(toolName, JSON.stringify(args));
 			return this.convertToToolResponse(result);
 		} catch (error) {
-			console.error(`[Native Adapter] Error executing tool "${toolName}":`, error);
+			nativeLogger.error(`Error executing tool "${toolName}":`, error);
 			return {
 				content: [{
 					type: "text",
@@ -314,7 +394,7 @@ var NativeModelContextAdapter = class {
 	* This is a polyfill-only feature.
 	*/
 	registerResource(_resource) {
-		console.warn("[Native Adapter] registerResource is not supported by native API");
+		nativeLogger.warn("registerResource is not supported by native API");
 		return { unregister: () => {} };
 	}
 	/**
@@ -322,7 +402,7 @@ var NativeModelContextAdapter = class {
 	* Note: Native Chromium API does not yet support resources.
 	*/
 	unregisterResource(_uri) {
-		console.warn("[Native Adapter] unregisterResource is not supported by native API");
+		nativeLogger.warn("unregisterResource is not supported by native API");
 	}
 	/**
 	* Lists all registered resources.
@@ -352,7 +432,7 @@ var NativeModelContextAdapter = class {
 	* This is a polyfill-only feature.
 	*/
 	registerPrompt(_prompt) {
-		console.warn("[Native Adapter] registerPrompt is not supported by native API");
+		nativeLogger.warn("registerPrompt is not supported by native API");
 		return { unregister: () => {} };
 	}
 	/**
@@ -360,7 +440,7 @@ var NativeModelContextAdapter = class {
 	* Note: Native Chromium API does not yet support prompts.
 	*/
 	unregisterPrompt(_name) {
-		console.warn("[Native Adapter] unregisterPrompt is not supported by native API");
+		nativeLogger.warn("unregisterPrompt is not supported by native API");
 	}
 	/**
 	* Lists all registered prompts.
@@ -415,7 +495,6 @@ var NativeModelContextAdapter = class {
 	* This is handled by the polyfill.
 	*/
 	async createMessage(params) {
-		console.log("[Native Adapter] Requesting sampling from client");
 		const underlyingServer = this.bridge.tabServer.server;
 		if (!underlyingServer?.createMessage) throw new Error("Sampling is not supported: no connected client with sampling capability");
 		return underlyingServer.createMessage(params);
@@ -426,7 +505,6 @@ var NativeModelContextAdapter = class {
 	* This is handled by the polyfill.
 	*/
 	async elicitInput(params) {
-		console.log("[Native Adapter] Requesting elicitation from client");
 		const underlyingServer = this.bridge.tabServer.server;
 		if (!underlyingServer?.elicitInput) throw new Error("Elicitation is not supported: no connected client with elicitation capability");
 		return underlyingServer.elicitInput(params);
@@ -565,7 +643,7 @@ var WebModelContextTesting = class {
 		for (const callback of this.toolsChangedCallbacks) try {
 			callback();
 		} catch (error) {
-			console.error("[Model Context Testing] Error in tools changed callback:", error);
+			testingLogger.error("Error in tools changed callback:", error);
 		}
 	}
 	/**
@@ -579,7 +657,6 @@ var WebModelContextTesting = class {
 	* @throws {Error} If the tool does not exist
 	*/
 	async executeTool(toolName, inputArgsJson) {
-		console.log(`[Model Context Testing] Executing tool: ${toolName}`);
 		let args;
 		try {
 			args = JSON.parse(inputArgsJson);
@@ -616,7 +693,6 @@ var WebModelContextTesting = class {
 	*/
 	registerToolsChangedCallback(callback) {
 		this.toolsChangedCallbacks.add(callback);
-		console.log("[Model Context Testing] Tools changed callback registered");
 	}
 	/**
 	* Gets all tool calls that have been recorded (polyfill extension).
@@ -631,7 +707,6 @@ var WebModelContextTesting = class {
 	*/
 	clearToolCalls() {
 		this.toolCallHistory = [];
-		console.log("[Model Context Testing] Tool call history cleared");
 	}
 	/**
 	* Sets a mock response for a specific tool (polyfill extension).
@@ -642,7 +717,6 @@ var WebModelContextTesting = class {
 	*/
 	setMockToolResponse(toolName, response) {
 		this.mockResponses.set(toolName, response);
-		console.log(`[Model Context Testing] Mock response set for tool: ${toolName}`);
 	}
 	/**
 	* Clears the mock response for a specific tool (polyfill extension).
@@ -651,14 +725,12 @@ var WebModelContextTesting = class {
 	*/
 	clearMockToolResponse(toolName) {
 		this.mockResponses.delete(toolName);
-		console.log(`[Model Context Testing] Mock response cleared for tool: ${toolName}`);
 	}
 	/**
 	* Clears all mock tool responses (polyfill extension).
 	*/
 	clearAllMockToolResponses() {
 		this.mockResponses.clear();
-		console.log("[Model Context Testing] All mock responses cleared");
 	}
 	/**
 	* Gets the current tools registered in the system (polyfill extension).
@@ -675,7 +747,6 @@ var WebModelContextTesting = class {
 	reset() {
 		this.clearToolCalls();
 		this.clearAllMockToolResponses();
-		console.log("[Model Context Testing] Testing state reset");
 	}
 };
 /**
@@ -781,14 +852,13 @@ var WebModelContext = class {
 	* @throws {Error} If a name/uri collides with existing dynamic items
 	*/
 	provideContext(context) {
-		const toolCount = context.tools?.length ?? 0;
-		const resourceCount = context.resources?.length ?? 0;
-		const promptCount = context.prompts?.length ?? 0;
-		console.log(`[Web Model Context] provideContext: ${toolCount} tools, ${resourceCount} resources, ${promptCount} prompts`);
 		this.provideContextTools.clear();
 		this.provideContextResources.clear();
 		this.provideContextPrompts.clear();
 		for (const tool of context.tools ?? []) {
+			if (tool.name.startsWith("_")) logger$1.warn(`⚠️ Warning: Tool name "${tool.name}" starts with underscore. This may cause compatibility issues with some MCP clients. Consider using a letter as the first character.`);
+			if (/^[0-9]/.test(tool.name)) logger$1.warn(`⚠️ Warning: Tool name "${tool.name}" starts with a number. This may cause compatibility issues. Consider using a letter as the first character.`);
+			if (tool.name.startsWith("-")) logger$1.warn(`⚠️ Warning: Tool name "${tool.name}" starts with hyphen. This may cause compatibility issues. Consider using a letter as the first character.`);
 			if (this.dynamicTools.has(tool.name)) throw new Error(`[Web Model Context] Tool name collision: "${tool.name}" is already registered via registerTool(). Please use a different name or unregister the dynamic tool first.`);
 			const { jsonSchema: inputJson, zodValidator: inputZod } = normalizeSchema(tool.inputSchema);
 			const normalizedOutput = tool.outputSchema ? normalizeSchema(tool.outputSchema) : null;
@@ -871,11 +941,13 @@ var WebModelContext = class {
 	* @throws {Error} If tool name collides with existing tools
 	*/
 	registerTool(tool) {
-		console.log(`[Web Model Context] Registering tool dynamically: ${tool.name}`);
+		if (tool.name.startsWith("_")) logger$1.warn(`⚠️ Warning: Tool name "${tool.name}" starts with underscore. This may cause compatibility issues with some MCP clients. Consider using a letter as the first character.`);
+		if (/^[0-9]/.test(tool.name)) logger$1.warn(`⚠️ Warning: Tool name "${tool.name}" starts with a number. This may cause compatibility issues. Consider using a letter as the first character.`);
+		if (tool.name.startsWith("-")) logger$1.warn(`⚠️ Warning: Tool name "${tool.name}" starts with hyphen. This may cause compatibility issues. Consider using a letter as the first character.`);
 		const now = Date.now();
 		const lastRegistration = this.toolRegistrationTimestamps.get(tool.name);
 		if (lastRegistration && now - lastRegistration < RAPID_DUPLICATE_WINDOW_MS) {
-			console.warn(`[Web Model Context] Tool "${tool.name}" registered multiple times within ${RAPID_DUPLICATE_WINDOW_MS}ms. This is likely due to React Strict Mode double-mounting. Ignoring duplicate registration.`);
+			logger$1.warn(`Tool "${tool.name}" registered multiple times within ${RAPID_DUPLICATE_WINDOW_MS}ms. This is likely due to React Strict Mode double-mounting. Ignoring duplicate registration.`);
 			const existingUnregister = this.toolUnregisterFunctions.get(tool.name);
 			if (existingUnregister) return { unregister: existingUnregister };
 		}
@@ -898,10 +970,9 @@ var WebModelContext = class {
 		this.updateBridgeTools();
 		this.scheduleListChanged("tools");
 		const unregisterFn = () => {
-			console.log(`[Web Model Context] Unregistering tool: ${tool.name}`);
 			if (this.provideContextTools.has(tool.name)) throw new Error(`[Web Model Context] Cannot unregister tool "${tool.name}": This tool was registered via provideContext(). Use provideContext() to update the base tool set.`);
 			if (!this.dynamicTools.has(tool.name)) {
-				console.warn(`[Web Model Context] Tool "${tool.name}" is not registered, ignoring unregister call`);
+				logger$1.warn(`Tool "${tool.name}" is not registered, ignoring unregister call`);
 				return;
 			}
 			this.dynamicTools.delete(tool.name);
@@ -922,11 +993,10 @@ var WebModelContext = class {
 	* @throws {Error} If resource URI collides with existing resources
 	*/
 	registerResource(resource) {
-		console.log(`[Web Model Context] Registering resource dynamically: ${resource.uri}`);
 		const now = Date.now();
 		const lastRegistration = this.resourceRegistrationTimestamps.get(resource.uri);
 		if (lastRegistration && now - lastRegistration < RAPID_DUPLICATE_WINDOW_MS) {
-			console.warn(`[Web Model Context] Resource "${resource.uri}" registered multiple times within ${RAPID_DUPLICATE_WINDOW_MS}ms. This is likely due to React Strict Mode double-mounting. Ignoring duplicate registration.`);
+			logger$1.warn(`Resource "${resource.uri}" registered multiple times within ${RAPID_DUPLICATE_WINDOW_MS}ms. This is likely due to React Strict Mode double-mounting. Ignoring duplicate registration.`);
 			const existingUnregister = this.resourceUnregisterFunctions.get(resource.uri);
 			if (existingUnregister) return { unregister: existingUnregister };
 		}
@@ -938,10 +1008,9 @@ var WebModelContext = class {
 		this.updateBridgeResources();
 		this.scheduleListChanged("resources");
 		const unregisterFn = () => {
-			console.log(`[Web Model Context] Unregistering resource: ${resource.uri}`);
 			if (this.provideContextResources.has(resource.uri)) throw new Error(`[Web Model Context] Cannot unregister resource "${resource.uri}": This resource was registered via provideContext(). Use provideContext() to update the base resource set.`);
 			if (!this.dynamicResources.has(resource.uri)) {
-				console.warn(`[Web Model Context] Resource "${resource.uri}" is not registered, ignoring unregister call`);
+				logger$1.warn(`Resource "${resource.uri}" is not registered, ignoring unregister call`);
 				return;
 			}
 			this.dynamicResources.delete(resource.uri);
@@ -960,11 +1029,10 @@ var WebModelContext = class {
 	* @param {string} uri - URI of the resource to unregister
 	*/
 	unregisterResource(uri) {
-		console.log(`[Web Model Context] Unregistering resource: ${uri}`);
 		const inProvideContext = this.provideContextResources.has(uri);
 		const inDynamic = this.dynamicResources.has(uri);
 		if (!inProvideContext && !inDynamic) {
-			console.warn(`[Web Model Context] Resource "${uri}" is not registered, ignoring unregister call`);
+			logger$1.warn(`Resource "${uri}" is not registered, ignoring unregister call`);
 			return;
 		}
 		if (inProvideContext) this.provideContextResources.delete(uri);
@@ -1013,11 +1081,10 @@ var WebModelContext = class {
 	* @throws {Error} If prompt name collides with existing prompts
 	*/
 	registerPrompt(prompt) {
-		console.log(`[Web Model Context] Registering prompt dynamically: ${prompt.name}`);
 		const now = Date.now();
 		const lastRegistration = this.promptRegistrationTimestamps.get(prompt.name);
 		if (lastRegistration && now - lastRegistration < RAPID_DUPLICATE_WINDOW_MS) {
-			console.warn(`[Web Model Context] Prompt "${prompt.name}" registered multiple times within ${RAPID_DUPLICATE_WINDOW_MS}ms. This is likely due to React Strict Mode double-mounting. Ignoring duplicate registration.`);
+			logger$1.warn(`Prompt "${prompt.name}" registered multiple times within ${RAPID_DUPLICATE_WINDOW_MS}ms. This is likely due to React Strict Mode double-mounting. Ignoring duplicate registration.`);
 			const existingUnregister = this.promptUnregisterFunctions.get(prompt.name);
 			if (existingUnregister) return { unregister: existingUnregister };
 		}
@@ -1029,10 +1096,9 @@ var WebModelContext = class {
 		this.updateBridgePrompts();
 		this.scheduleListChanged("prompts");
 		const unregisterFn = () => {
-			console.log(`[Web Model Context] Unregistering prompt: ${prompt.name}`);
 			if (this.provideContextPrompts.has(prompt.name)) throw new Error(`[Web Model Context] Cannot unregister prompt "${prompt.name}": This prompt was registered via provideContext(). Use provideContext() to update the base prompt set.`);
 			if (!this.dynamicPrompts.has(prompt.name)) {
-				console.warn(`[Web Model Context] Prompt "${prompt.name}" is not registered, ignoring unregister call`);
+				logger$1.warn(`Prompt "${prompt.name}" is not registered, ignoring unregister call`);
 				return;
 			}
 			this.dynamicPrompts.delete(prompt.name);
@@ -1051,11 +1117,10 @@ var WebModelContext = class {
 	* @param {string} name - Name of the prompt to unregister
 	*/
 	unregisterPrompt(name) {
-		console.log(`[Web Model Context] Unregistering prompt: ${name}`);
 		const inProvideContext = this.provideContextPrompts.has(name);
 		const inDynamic = this.dynamicPrompts.has(name);
 		if (!inProvideContext && !inDynamic) {
-			console.warn(`[Web Model Context] Prompt "${name}" is not registered, ignoring unregister call`);
+			logger$1.warn(`Prompt "${name}" is not registered, ignoring unregister call`);
 			return;
 		}
 		if (inProvideContext) this.provideContextPrompts.delete(name);
@@ -1091,11 +1156,10 @@ var WebModelContext = class {
 	* @param {string} name - Name of the tool to unregister
 	*/
 	unregisterTool(name) {
-		console.log(`[Web Model Context] Unregistering tool: ${name}`);
 		const inProvideContext = this.provideContextTools.has(name);
 		const inDynamic = this.dynamicTools.has(name);
 		if (!inProvideContext && !inDynamic) {
-			console.warn(`[Web Model Context] Tool "${name}" is not registered, ignoring unregister call`);
+			logger$1.warn(`Tool "${name}" is not registered, ignoring unregister call`);
 			return;
 		}
 		if (inProvideContext) this.provideContextTools.delete(name);
@@ -1112,7 +1176,6 @@ var WebModelContext = class {
 	* Removes all tools, resources, and prompts registered via provideContext() and register* methods.
 	*/
 	clearContext() {
-		console.log("[Web Model Context] Clearing all context (tools, resources, prompts)");
 		this.provideContextTools.clear();
 		this.dynamicTools.clear();
 		this.toolRegistrationTimestamps.clear();
@@ -1142,7 +1205,6 @@ var WebModelContext = class {
 		this.bridge.tools.clear();
 		for (const [name, tool] of this.provideContextTools) this.bridge.tools.set(name, tool);
 		for (const [name, tool] of this.dynamicTools) this.bridge.tools.set(name, tool);
-		console.log(`[Web Model Context] Updated bridge with ${this.provideContextTools.size} base tools + ${this.dynamicTools.size} dynamic tools = ${this.bridge.tools.size} total`);
 	}
 	/**
 	* Notifies all servers and testing callbacks that the tools list has changed.
@@ -1170,7 +1232,6 @@ var WebModelContext = class {
 		this.bridge.resources.clear();
 		for (const [uri, resource] of this.provideContextResources) this.bridge.resources.set(uri, resource);
 		for (const [uri, resource] of this.dynamicResources) this.bridge.resources.set(uri, resource);
-		console.log(`[Web Model Context] Updated bridge with ${this.provideContextResources.size} base resources + ${this.dynamicResources.size} dynamic resources = ${this.bridge.resources.size} total`);
 	}
 	/**
 	* Notifies all servers that the resources list has changed.
@@ -1196,7 +1257,6 @@ var WebModelContext = class {
 		this.bridge.prompts.clear();
 		for (const [name, prompt] of this.provideContextPrompts) this.bridge.prompts.set(name, prompt);
 		for (const [name, prompt] of this.dynamicPrompts) this.bridge.prompts.set(name, prompt);
-		console.log(`[Web Model Context] Updated bridge with ${this.provideContextPrompts.size} base prompts + ${this.dynamicPrompts.size} dynamic prompts = ${this.bridge.prompts.size} total`);
 	}
 	/**
 	* Notifies all servers that the prompts list has changed.
@@ -1239,7 +1299,7 @@ var WebModelContext = class {
 					break;
 				default: {
 					const _exhaustive = listType;
-					console.error(`[Web Model Context] Unknown list type: ${_exhaustive}`);
+					logger$1.error(`Unknown list type: ${_exhaustive}`);
 				}
 			}
 		});
@@ -1254,13 +1314,12 @@ var WebModelContext = class {
 	* @internal
 	*/
 	async readResource(uri) {
-		console.log(`[Web Model Context] Reading resource: ${uri}`);
 		const staticResource = this.bridge.resources.get(uri);
 		if (staticResource && !staticResource.isTemplate) try {
 			const parsedUri = new URL(uri);
 			return await staticResource.read(parsedUri);
 		} catch (error) {
-			console.error(`[Web Model Context] Error reading resource ${uri}:`, error);
+			logger$1.error(`Error reading resource ${uri}:`, error);
 			throw error;
 		}
 		for (const resource of this.bridge.resources.values()) {
@@ -1270,7 +1329,7 @@ var WebModelContext = class {
 				const parsedUri = new URL(uri);
 				return await resource.read(parsedUri, params);
 			} catch (error) {
-				console.error(`[Web Model Context] Error reading resource ${uri}:`, error);
+				logger$1.error(`Error reading resource ${uri}:`, error);
 				throw error;
 			}
 		}
@@ -1315,20 +1374,19 @@ var WebModelContext = class {
 	* @internal
 	*/
 	async getPrompt(name, args) {
-		console.log(`[Web Model Context] Getting prompt: ${name}`);
 		const prompt = this.bridge.prompts.get(name);
 		if (!prompt) throw new Error(`Prompt not found: ${name}`);
 		if (prompt.argsValidator && args) {
 			const validation = validateWithZod(args, prompt.argsValidator);
 			if (!validation.success) {
-				console.error(`[Web Model Context] Argument validation failed for prompt ${name}:`, validation.error);
+				logger$1.error(`Argument validation failed for prompt ${name}:`, validation.error);
 				throw new Error(`Argument validation error for prompt "${name}":\n${validation.error}`);
 			}
 		}
 		try {
 			return await prompt.get(args ?? {});
 		} catch (error) {
-			console.error(`[Web Model Context] Error getting prompt ${name}:`, error);
+			logger$1.error(`Error getting prompt ${name}:`, error);
 			throw error;
 		}
 	}
@@ -1351,10 +1409,9 @@ var WebModelContext = class {
 	async executeTool(toolName, args) {
 		const tool = this.bridge.tools.get(toolName);
 		if (!tool) throw new Error(`Tool not found: ${toolName}`);
-		console.log(`[Web Model Context] Validating input for tool: ${toolName}`);
 		const validation = validateWithZod(args, tool.inputValidator);
 		if (!validation.success) {
-			console.error(`[Web Model Context] Input validation failed for ${toolName}:`, validation.error);
+			logger$1.error(`Input validation failed for ${toolName}:`, validation.error);
 			return {
 				content: [{
 					type: "text",
@@ -1367,31 +1424,24 @@ var WebModelContext = class {
 		if (this.testingAPI) this.testingAPI.recordToolCall(toolName, validatedArgs);
 		if (this.testingAPI?.hasMockResponse(toolName)) {
 			const mockResponse = this.testingAPI.getMockResponse(toolName);
-			if (mockResponse) {
-				console.log(`[Web Model Context] Returning mock response for tool: ${toolName}`);
-				return mockResponse;
-			}
+			if (mockResponse) return mockResponse;
 		}
 		const event = new WebToolCallEvent(toolName, validatedArgs);
 		this.dispatchEvent(event);
 		if (event.defaultPrevented && event.hasResponse()) {
 			const response = event.getResponse();
-			if (response) {
-				console.log(`[Web Model Context] Tool ${toolName} handled by event listener`);
-				return response;
-			}
+			if (response) return response;
 		}
-		console.log(`[Web Model Context] Executing tool: ${toolName}`);
 		try {
 			const response = await tool.execute(validatedArgs);
 			if (tool.outputValidator && response.structuredContent) {
 				const outputValidation = validateWithZod(response.structuredContent, tool.outputValidator);
-				if (!outputValidation.success) console.warn(`[Web Model Context] Output validation failed for ${toolName}:`, outputValidation.error);
+				if (!outputValidation.success) logger$1.warn(`Output validation failed for ${toolName}:`, outputValidation.error);
 			}
-			if (response.metadata && "willNavigate" in response.metadata) console.info(`[Web Model Context] Tool "${toolName}" will trigger navigation`, response.metadata);
+			if (response.metadata && typeof response.metadata === "object" && "willNavigate" in response.metadata) logger$1.info(`Tool "${toolName}" will trigger navigation`, response.metadata);
 			return response;
 		} catch (error) {
-			console.error(`[Web Model Context] Error executing tool ${toolName}:`, error);
+			logger$1.error(`Error executing tool ${toolName}:`, error);
 			return {
 				content: [{
 					type: "text",
@@ -1425,7 +1475,6 @@ var WebModelContext = class {
 	* @returns {Promise<SamplingResult>} The LLM completion result
 	*/
 	async createMessage(params) {
-		console.log("[Web Model Context] Requesting sampling from client");
 		const underlyingServer = this.bridge.tabServer.server;
 		if (!underlyingServer?.createMessage) throw new Error("Sampling is not supported: no connected client with sampling capability");
 		return underlyingServer.createMessage(params);
@@ -1438,7 +1487,6 @@ var WebModelContext = class {
 	* @returns {Promise<ElicitationResult>} The user's response
 	*/
 	async elicitInput(params) {
-		console.log("[Web Model Context] Requesting elicitation from client");
 		const underlyingServer = this.bridge.tabServer.server;
 		if (!underlyingServer?.elicitInput) throw new Error("Elicitation is not supported: no connected client with elicitation capability");
 		return underlyingServer.elicitInput(params);
@@ -1453,16 +1501,13 @@ var WebModelContext = class {
 * @returns {MCPBridge} The initialized MCP bridge
 */
 function initializeMCPBridge(options) {
-	console.log("[Web Model Context] Initializing MCP bridge");
 	const hostname = window.location.hostname || "localhost";
 	const transportOptions = options?.transport;
 	const setupServerHandlers = (server, bridge$1) => {
 		server.setRequestHandler(ListToolsRequestSchema, async () => {
-			console.log("[MCP Bridge] Handling list_tools request");
 			return { tools: bridge$1.modelContext.listTools() };
 		});
 		server.setRequestHandler(CallToolRequestSchema, async (request) => {
-			console.log(`[MCP Bridge] Handling call_tool request: ${request.params.name}`);
 			const toolName = request.params.name;
 			const args = request.params.arguments || {};
 			try {
@@ -1473,40 +1518,35 @@ function initializeMCPBridge(options) {
 					...response.structuredContent && { structuredContent: response.structuredContent }
 				};
 			} catch (error) {
-				console.error(`[MCP Bridge] Error calling tool ${toolName}:`, error);
+				bridgeLogger.error(`Error calling tool ${toolName}:`, error);
 				throw error;
 			}
 		});
 		server.setRequestHandler(ListResourcesRequestSchema, async () => {
-			console.log("[MCP Bridge] Handling list_resources request");
 			return { resources: bridge$1.modelContext.listResources() };
 		});
 		server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-			console.log(`[MCP Bridge] Handling read_resource request: ${request.params.uri}`);
 			try {
 				return await bridge$1.modelContext.readResource(request.params.uri);
 			} catch (error) {
-				console.error(`[MCP Bridge] Error reading resource ${request.params.uri}:`, error);
+				bridgeLogger.error(`Error reading resource ${request.params.uri}:`, error);
 				throw error;
 			}
 		});
 		server.setRequestHandler(ListPromptsRequestSchema, async () => {
-			console.log("[MCP Bridge] Handling list_prompts request");
 			return { prompts: bridge$1.modelContext.listPrompts() };
 		});
 		server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-			console.log(`[MCP Bridge] Handling get_prompt request: ${request.params.name}`);
 			try {
 				return await bridge$1.modelContext.getPrompt(request.params.name, request.params.arguments);
 			} catch (error) {
-				console.error(`[MCP Bridge] Error getting prompt ${request.params.name}:`, error);
+				bridgeLogger.error(`Error getting prompt ${request.params.name}:`, error);
 				throw error;
 			}
 		});
 	};
 	const customTransport = transportOptions?.create?.();
 	if (customTransport) {
-		console.log("[Web Model Context] Using custom transport");
 		const server = new Server({
 			name: hostname,
 			version: "1.0.0"
@@ -1526,10 +1566,8 @@ function initializeMCPBridge(options) {
 		bridge$1.modelContext = new WebModelContext(bridge$1);
 		setupServerHandlers(server, bridge$1);
 		server.connect(customTransport);
-		console.log("[Web Model Context] MCP server connected with custom transport");
 		return bridge$1;
 	}
-	console.log("[Web Model Context] Using dual-server mode");
 	const tabServerEnabled = transportOptions?.tabServer !== false;
 	const tabServer = new Server({
 		name: `${hostname}-tab`,
@@ -1556,12 +1594,10 @@ function initializeMCPBridge(options) {
 			...restTabServerOptions
 		});
 		tabServer.connect(tabTransport);
-		console.log("[Web Model Context] Tab server connected");
 	}
 	const isInIframe = typeof window !== "undefined" && window.parent !== window;
 	const iframeServerConfig = transportOptions?.iframeServer;
 	if (iframeServerConfig !== false && (iframeServerConfig !== void 0 || isInIframe)) {
-		console.log("[Web Model Context] Enabling iframe server");
 		const iframeServer = new Server({
 			name: `${hostname}-iframe`,
 			version: "1.0.0"
@@ -1578,7 +1614,6 @@ function initializeMCPBridge(options) {
 		});
 		iframeServer.connect(iframeTransport);
 		bridge.iframeServer = iframeServer;
-		console.log("[Web Model Context] Iframe server connected");
 	}
 	return bridge;
 }
@@ -1604,7 +1639,7 @@ function initializeMCPBridge(options) {
 */
 function initializeWebModelContext(options) {
 	if (typeof window === "undefined") {
-		console.warn("[Web Model Context] Not in browser environment, skipping initialization");
+		logger$1.warn("Not in browser environment, skipping initialization");
 		return;
 	}
 	const effectiveOptions = options ?? window.__webModelContextOptions;
@@ -1613,12 +1648,12 @@ function initializeWebModelContext(options) {
 		const nativeContext = window.navigator.modelContext;
 		const nativeTesting = window.navigator.modelContextTesting;
 		if (!nativeContext || !nativeTesting) {
-			console.error("[Web Model Context] Native API detection mismatch");
+			logger$1.error("Native API detection mismatch");
 			return;
 		}
-		console.log("✅ [Web Model Context] Native Chromium API detected");
-		console.log("   Using native implementation with MCP bridge synchronization");
-		console.log("   Native API will automatically collect tools from embedded iframes");
+		logger$1.info("✅ Native Chromium API detected");
+		logger$1.info("   Using native implementation with MCP bridge synchronization");
+		logger$1.info("   Native API will automatically collect tools from embedded iframes");
 		try {
 			const bridge = initializeMCPBridge(effectiveOptions);
 			bridge.modelContext = new NativeModelContextAdapter(bridge, nativeContext, nativeTesting);
@@ -1628,29 +1663,29 @@ function initializeWebModelContext(options) {
 				writable: false,
 				configurable: true
 			});
-			console.log("✅ [Web Model Context] MCP bridge synced with native API");
-			console.log("   MCP clients will receive automatic tool updates from native registry");
+			logger$1.info("✅ MCP bridge synced with native API");
+			logger$1.info("   MCP clients will receive automatic tool updates from native registry");
 		} catch (error) {
-			console.error("[Web Model Context] Failed to initialize native adapter:", error);
+			logger$1.error("Failed to initialize native adapter:", error);
 			throw error;
 		}
 		return;
 	}
 	if (native.hasNativeContext && !native.hasNativeTesting) {
-		console.warn("[Web Model Context] Partial native API detected");
-		console.warn("   navigator.modelContext exists but navigator.modelContextTesting is missing");
-		console.warn("   Cannot sync with native API. Please enable experimental features:");
-		console.warn("      - Navigate to chrome://flags");
-		console.warn("      - Enable \"Experimental Web Platform Features\"");
-		console.warn("      - Or launch with: --enable-experimental-web-platform-features");
-		console.warn("   Skipping initialization to avoid conflicts");
+		logger$1.warn("Partial native API detected");
+		logger$1.warn("   navigator.modelContext exists but navigator.modelContextTesting is missing");
+		logger$1.warn("   Cannot sync with native API. Please enable experimental features:");
+		logger$1.warn("      - Navigate to chrome://flags");
+		logger$1.warn("      - Enable \"Experimental Web Platform Features\"");
+		logger$1.warn("      - Or launch with: --enable-experimental-web-platform-features");
+		logger$1.warn("   Skipping initialization to avoid conflicts");
 		return;
 	}
 	if (window.navigator.modelContext) {
-		console.warn("[Web Model Context] window.navigator.modelContext already exists, skipping initialization");
+		logger$1.warn("window.navigator.modelContext already exists, skipping initialization");
 		return;
 	}
-	console.log("[Web Model Context] Native API not detected, installing polyfill");
+	logger$1.info("Native API not detected, installing polyfill");
 	try {
 		const bridge = initializeMCPBridge(effectiveOptions);
 		Object.defineProperty(window.navigator, "modelContext", {
@@ -1663,12 +1698,12 @@ function initializeWebModelContext(options) {
 			writable: false,
 			configurable: true
 		});
-		console.log("✅ [Web Model Context] window.navigator.modelContext initialized successfully");
-		console.log("[Model Context Testing] Installing polyfill");
-		console.log("   💡 To use the native implementation in Chromium:");
-		console.log("      - Navigate to chrome://flags");
-		console.log("      - Enable \"Experimental Web Platform Features\"");
-		console.log("      - Or launch with: --enable-experimental-web-platform-features");
+		logger$1.info("✅ window.navigator.modelContext initialized successfully");
+		testingLogger.info("Installing polyfill");
+		testingLogger.info("   💡 To use the native implementation in Chromium:");
+		testingLogger.info("      - Navigate to chrome://flags");
+		testingLogger.info("      - Enable \"Experimental Web Platform Features\"");
+		testingLogger.info("      - Or launch with: --enable-experimental-web-platform-features");
 		const testingAPI = new WebModelContextTesting(bridge);
 		bridge.modelContextTesting = testingAPI;
 		bridge.modelContext.setTestingAPI(testingAPI);
@@ -1677,9 +1712,9 @@ function initializeWebModelContext(options) {
 			writable: false,
 			configurable: true
 		});
-		console.log("✅ [Model Context Testing] Polyfill installed at window.navigator.modelContextTesting");
+		testingLogger.info("✅ Polyfill installed at window.navigator.modelContextTesting");
 	} catch (error) {
-		console.error("[Web Model Context] Failed to initialize:", error);
+		logger$1.error("Failed to initialize:", error);
 		throw error;
 	}
 }
@@ -1701,16 +1736,17 @@ function cleanupWebModelContext() {
 		window.__mcpBridge.tabServer.close();
 		if (window.__mcpBridge.iframeServer) window.__mcpBridge.iframeServer.close();
 	} catch (error) {
-		console.warn("[Web Model Context] Error closing MCP servers:", error);
+		logger$1.warn("Error closing MCP servers:", error);
 	}
 	delete window.navigator.modelContext;
 	delete window.navigator.modelContextTesting;
 	delete window.__mcpBridge;
-	console.log("[Web Model Context] Cleaned up");
+	logger$1.info("Cleaned up");
 }
 
 //#endregion
 //#region src/index.ts
+const logger = createLogger("WebModelContext");
 function mergeTransportOptions(base, override) {
 	if (!base) return override;
 	if (!override) return base;
@@ -1738,7 +1774,7 @@ function parseScriptTagOptions(script) {
 	if (dataset.webmcpOptions) try {
 		return JSON.parse(dataset.webmcpOptions);
 	} catch (error) {
-		console.error("[Web Model Context] Invalid JSON in data-webmcp-options:", error);
+		logger.error("Invalid JSON in data-webmcp-options:", error);
 		return;
 	}
 	const options = {};
@@ -1781,10 +1817,10 @@ if (typeof window !== "undefined" && typeof document !== "undefined") {
 	try {
 		if (shouldAutoInitialize) initializeWebModelContext(mergedOptions);
 	} catch (error) {
-		console.error("[Web Model Context] Auto-initialization failed:", error);
+		logger.error("Auto-initialization failed:", error);
 	}
 }
 
 //#endregion
-export { cleanupWebModelContext, initializeWebModelContext, zodToJsonSchema };
+export { cleanupWebModelContext, createLogger, initializeWebModelContext, zodToJsonSchema };
 //# sourceMappingURL=index.js.map