@mcp-b/webmcp-polyfill 0.0.0-beta-20260216200013

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mcp-b contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# @mcp-b/webmcp-polyfill
+
+Strict WebMCP core runtime polyfill for `navigator.modelContext`.
+
+This package installs only the core API:
+
+- `provideContext(options?)`
+- `registerTool(tool)`
+- `unregisterTool(name)`
+- `clearContext()`
+
+It does not install MCP bridge extension methods like `callTool`, resources, or prompts.
+For the full MCPB runtime (core + bridge extensions), use `@mcp-b/global`.
+
+## Install
+
+```bash
+pnpm add @mcp-b/webmcp-polyfill
+```
+
+## Usage
+
+```ts
+import { initializeWebMCPPolyfill } from '@mcp-b/webmcp-polyfill';
+
+initializeWebMCPPolyfill();
+```
+
+## Options
+
+```ts
+initializeWebMCPPolyfill({
+  installTestingShim: 'if-missing',
+});
+```
+
+- `installTestingShim`:
+  - `true` or `'if-missing'` (default): install parity helpers only when `navigator.modelContextTesting` is missing.
+  - `'always'`: replace any existing `navigator.modelContextTesting`.
+  - `false`: do not install `navigator.modelContextTesting`.
+
+## Interop with `@mcp-b/global`
+
+- Default behavior is non-destructive: if `navigator.modelContext` already exists, this package does nothing.
+- When a page already has this core polyfill and later loads `@mcp-b/global`, global runs in attach-only mode (keeps the existing object identity and adds bridge/runtime features).
+- Repeated injection of `@mcp-b/global` is idempotent (first initialization wins).
+
+## Migration Notes
+
+- `forceOverride` has been removed from `initializeWebMCPPolyfill` options.
+- Existing callers passing `forceOverride` should remove that field.
+
+## Testing Shim
+
+When `installTestingShim` is enabled, this package can install a minimal
+`navigator.modelContextTesting` surface for parity-style tests:
+
+- `listTools()`
+- `executeTool(toolName, inputArgsJson, options?)`
+- `registerToolsChangedCallback(callback)`
+- `getCrossDocumentScriptToolResult()`
+
+## Cleanup
+
+```ts
+import { cleanupWebMCPPolyfill } from '@mcp-b/webmcp-polyfill';
+
+cleanupWebMCPPolyfill();
+```

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+import { InputSchema } from "@mcp-b/webmcp-types";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/index.d.ts
+type StandardInputValidatorSchema = StandardSchemaV1<Record<string, unknown>, Record<string, unknown>>;
+interface StandardJSONSchemaV1<Input = unknown, Output = Input> {
+  readonly '~standard': {
+    readonly version: 1;
+    readonly vendor: string;
+    readonly types?: {
+      readonly input: Input;
+      readonly output: Output;
+    } | undefined;
+    readonly jsonSchema: {
+      readonly input: (options: {
+        readonly target: 'draft-2020-12' | 'draft-07' | 'openapi-3.0' | ({} & string);
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+      }) => Record<string, unknown>;
+      readonly output: (options: {
+        readonly target: 'draft-2020-12' | 'draft-07' | 'openapi-3.0' | ({} & string);
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+      }) => Record<string, unknown>;
+    };
+  };
+}
+type StandardInputJsonSchema = StandardJSONSchemaV1<Record<string, unknown>, Record<string, unknown>>;
+type ToolInputSchema = InputSchema | StandardInputValidatorSchema | StandardInputJsonSchema;
+type ToolOutputSchema = InputSchema | StandardInputJsonSchema;
+type StandardValidationResult = Awaited<ReturnType<StandardInputValidatorSchema['~standard']['validate']>>;
+type StandardValidationIssue = NonNullable<StandardValidationResult['issues']>[number];
+interface WebMCPPolyfillInitOptions {
+  /**
+   * Controls installation of navigator.modelContextTesting when this polyfill provides modelContext.
+   * - true or 'if-missing' (default): install only when modelContextTesting is missing.
+   * - 'always': install even when modelContextTesting already exists.
+   * - false: do not install.
+   * @default 'if-missing'
+   */
+  installTestingShim?: boolean | 'always' | 'if-missing';
+  /**
+   * Deprecated no-op kept for backward compatibility with previous wrappers.
+   */
+  disableIframeTransportByDefault?: boolean;
+}
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+declare function validateArgsWithSchema(args: Record<string, unknown>, schema: InputSchema): StandardValidationIssue | null;
+declare function initializeWebMCPPolyfill(options?: WebMCPPolyfillInitOptions): void;
+declare function cleanupWebMCPPolyfill(): void;
+//#endregion
+export { StandardInputJsonSchema, StandardInputValidatorSchema, StandardJSONSchemaV1, ToolInputSchema, ToolOutputSchema, WebMCPPolyfillInitOptions, cleanupWebMCPPolyfill, initializeWebMCPPolyfill, initializeWebMCPPolyfill as initializeWebModelContextPolyfill, isPlainObject, validateArgsWithSchema };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;KAwBY,4BAAA,GAA+B,iBACzC,yBACA;UAEe,+CAA+C;EAJpD,SAAA,WAAA,EAAA;IACV,SAAA,OAAA,EAAA,CAAA;IACA,SAAA,MAAA,EAAA,MAAA;IAFyC,SAAA,KAAA,CAAA,EAAA;MAAgB,SAAA,KAAA,EAQpB,KARoB;MAI1C,SAAA,MAAoB,EAI0B,MAJ1B;IAA2B,CAAA,GAAA,SAAA;IAIzB,SAAA,UAAA,EAAA;MAAwB,SAAA,KAAA,EAAA,CAAA,OAAA,EAAA;QAI7B,SAAA,MAAA,EAAA,eAAA,GAAA,UAAA,GAAA,aAAA,GAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA;QACtB,SAAA,cAAA,CAAA,EADsB,MACtB,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,SAAA;MAGsB,CAAA,EAAA,GAHtB,MAGsB,CAAA,MAAA,EAAA,OAAA,CAAA;MACtB,SAAA,MAAA,EAAA,CAAA,OAAA,EAAA;QAAM,SAAA,MAAA,EAAA,eAAA,GAAA,UAAA,GAAA,aAAA,GAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA;QAIN,SAAA,cAAuB,CAAA,EALD,MAKC,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,SAAA;MACjC,CAAA,EAAA,GALU,MAKV,CAAA,MAAA,EAAA,OAAA,CAAA;IACA,CAAA;EAFoC,CAAA;;AAI1B,KAJA,uBAAA,GAA0B,oBAIX,CAHzB,MAGyB,CAAA,MAAA,EAAA,OAAA,CAAA,EAFzB,MAEyB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;AAAG,KAAlB,eAAA,GAAkB,WAAA,GAAc,4BAAd,GAA6C,uBAA7C;AAAc,KAChC,gBAAA,GAAmB,WADa,GACC,uBADD;KAGvC,wBAAA,GAA2B,OAH2C,CAIzE,UAJyE,CAI9D,4BAJ8D,CAAA,WAAA,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA;KAMtE,uBAAA,GAA0B,WANmE,CAMvD,wBANuD,CAAA,QAAA,CAAA,CAAA,CAAA,MAAA,CAAA;AACtF,UAkCK,yBAAA,CAlCc;EAE1B;;;;;AAAkC;AAgCvC;EA8KgB,kBAAa,CAAA,EAAA,OAA2B,GAAA,QAAM,GAAA,YAAA;EAuO9C;;;EAGb,+BAAA,CAAA,EAAA,OAAA;;AA+Ja,iBAzYA,aAAA,CAyYwB,KAAW,EAAA,OAAA,CAAA,EAAA,KAAA,IAzYK,MAyYoB,CAAA,MAAA,EAAA,OAAA,CAAA;AAiD5D,iBAnNA,sBAAA,CAmNqB,IAAA,EAlN7B,MAkN6B,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAjN3B,WAiN2B,CAAA,EAhNlC,uBAgNkC,GAAA,IAAA;iBAjDrB,wBAAA,WAAmC;iBAiDnC,qBAAA,CAAA"}

package/dist/index.js

@@ -0,0 +1,354 @@
+import { Validator } from "@cfworker/json-schema";
+
+//#region src/index.ts
+const FAILED_TO_PARSE_INPUT_ARGUMENTS_MESSAGE = "Failed to parse input arguments";
+const TOOL_INVOCATION_FAILED_MESSAGE = "Tool was executed but the invocation failed. For example, the script function threw an error";
+const TOOL_CANCELLED_MESSAGE = "Tool was cancelled";
+const DEFAULT_INPUT_SCHEMA = {
+	type: "object",
+	properties: {}
+};
+const STANDARD_JSON_SCHEMA_TARGETS = ["draft-2020-12", "draft-07"];
+const POLYFILL_MARKER_PROPERTY = "__isWebMCPPolyfill";
+const STANDARD_VALIDATOR_SYMBOL = Symbol("standardValidator");
+const installState = {
+	installed: false,
+	previousModelContextDescriptor: void 0,
+	previousModelContextTestingDescriptor: void 0
+};
+var StrictWebMCPContext = class {
+	tools = /* @__PURE__ */ new Map();
+	toolsChangedCallback = null;
+	provideContext(options = {}) {
+		const nextTools = /* @__PURE__ */ new Map();
+		for (const tool of options.tools ?? []) {
+			const normalized = normalizeToolDescriptor(tool, nextTools);
+			nextTools.set(normalized.name, normalized);
+		}
+		this.tools = nextTools;
+		this.notifyToolsChanged();
+	}
+	clearContext() {
+		this.tools.clear();
+		this.notifyToolsChanged();
+	}
+	registerTool(tool) {
+		const normalized = normalizeToolDescriptor(tool, this.tools);
+		this.tools.set(normalized.name, normalized);
+		this.notifyToolsChanged();
+	}
+	unregisterTool(name) {
+		if (this.tools.delete(name)) this.notifyToolsChanged();
+	}
+	getTestingShim() {
+		return {
+			listTools: () => {
+				return [...this.tools.values()].map((tool) => {
+					const output = {
+						name: tool.name,
+						description: tool.description
+					};
+					try {
+						output.inputSchema = JSON.stringify(tool.inputSchema);
+					} catch {}
+					return output;
+				});
+			},
+			executeTool: (toolName, inputArgsJson, options) => this.executeToolForTesting(toolName, inputArgsJson, options),
+			registerToolsChangedCallback: (callback) => {
+				if (typeof callback !== "function") throw new TypeError("Failed to execute 'registerToolsChangedCallback' on 'ModelContextTesting': parameter 1 is not of type 'Function'.");
+				this.toolsChangedCallback = callback;
+			},
+			getCrossDocumentScriptToolResult: async () => "[]"
+		};
+	}
+	async executeToolForTesting(toolName, inputArgsJson, options) {
+		if (options?.signal?.aborted) throw createUnknownError(TOOL_CANCELLED_MESSAGE);
+		const tool = this.tools.get(toolName);
+		if (!tool) throw createUnknownError(`Tool not found: ${toolName}`);
+		const args = parseInputArgsJson(inputArgsJson);
+		const validationError = await validateArgsForTool(args, tool);
+		if (validationError) throw createUnknownError(validationError);
+		let contextActive = true;
+		const client = { requestUserInteraction: async (callback) => {
+			if (!contextActive) throw new Error(`ModelContextClient for tool "${toolName}" is no longer active after execute() resolved`);
+			if (typeof callback !== "function") throw new TypeError("requestUserInteraction(callback) requires a function callback");
+			return callback();
+		} };
+		try {
+			const execution = tool.execute(args, client);
+			return toSerializedTestingResult(await withAbortSignal(Promise.resolve(execution), options?.signal));
+		} catch {
+			throw createUnknownError(TOOL_INVOCATION_FAILED_MESSAGE);
+		} finally {
+			contextActive = false;
+		}
+	}
+	notifyToolsChanged() {
+		if (!this.toolsChangedCallback) return;
+		queueMicrotask(() => {
+			try {
+				this.toolsChangedCallback?.();
+			} catch {}
+		});
+	}
+};
+function createUnknownError(message) {
+	try {
+		return new DOMException(message, "UnknownError");
+	} catch {
+		const error = new Error(message);
+		error.name = "UnknownError";
+		return error;
+	}
+}
+function parseInputArgsJson(inputArgsJson) {
+	let parsed;
+	try {
+		parsed = JSON.parse(inputArgsJson);
+	} catch {
+		throw createUnknownError(FAILED_TO_PARSE_INPUT_ARGUMENTS_MESSAGE);
+	}
+	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw createUnknownError(FAILED_TO_PARSE_INPUT_ARGUMENTS_MESSAGE);
+	return parsed;
+}
+function isPlainObject(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function getStandardProps(value) {
+	if (!isPlainObject(value)) return null;
+	const standard = value["~standard"];
+	if (!isPlainObject(standard)) return null;
+	return standard;
+}
+function isStandardInputValidatorSchema(value) {
+	const standard = getStandardProps(value);
+	return Boolean(standard && standard.version === 1 && typeof standard.validate === "function");
+}
+function isStandardInputJsonSchema(value) {
+	const standard = getStandardProps(value);
+	if (!standard || standard.version !== 1 || !isPlainObject(standard.jsonSchema)) return false;
+	return typeof standard.jsonSchema.input === "function";
+}
+function createStandardValidatorFromJsonSchema(schema) {
+	return { "~standard": {
+		version: 1,
+		vendor: "@mcp-b/webmcp-polyfill-json-schema",
+		validate(value) {
+			if (!isPlainObject(value)) return { issues: [{ message: "expected object arguments" }] };
+			const issue = validateArgsWithSchema(value, schema);
+			if (issue) return { issues: [issue] };
+			return { value };
+		}
+	} };
+}
+function convertStandardInputSchema(schema) {
+	for (const target of STANDARD_JSON_SCHEMA_TARGETS) try {
+		const converted = schema["~standard"].jsonSchema.input({ target });
+		validateInputSchema(converted);
+		return converted;
+	} catch {}
+	throw new Error("Failed to convert Standard JSON Schema inputSchema to a JSON Schema object");
+}
+function normalizeInputSchema(inputSchema) {
+	if (inputSchema === void 0) {
+		const normalized = DEFAULT_INPUT_SCHEMA;
+		return {
+			inputSchema: normalized,
+			standardValidator: createStandardValidatorFromJsonSchema(normalized)
+		};
+	}
+	if (isStandardInputJsonSchema(inputSchema)) {
+		const converted = convertStandardInputSchema(inputSchema);
+		return {
+			inputSchema: converted,
+			standardValidator: createStandardValidatorFromJsonSchema(converted)
+		};
+	}
+	if (isStandardInputValidatorSchema(inputSchema)) return {
+		inputSchema: DEFAULT_INPUT_SCHEMA,
+		standardValidator: inputSchema
+	};
+	validateInputSchema(inputSchema);
+	return {
+		inputSchema,
+		standardValidator: createStandardValidatorFromJsonSchema(inputSchema)
+	};
+}
+function validateInputSchema(schema) {
+	if (!isPlainObject(schema)) throw new Error("inputSchema must be a JSON Schema object");
+	validateJsonSchemaNode(schema, "$");
+}
+function validateJsonSchemaNode(node, path) {
+	const typeValue = node.type;
+	if (typeValue !== void 0 && typeof typeValue !== "string" && !(Array.isArray(typeValue) && typeValue.every((entry) => typeof entry === "string" && entry.length > 0))) throw new Error(`Invalid JSON Schema at ${path}: "type" must be a string or string[]`);
+	const requiredValue = node.required;
+	if (requiredValue !== void 0 && !(Array.isArray(requiredValue) && requiredValue.every((entry) => typeof entry === "string"))) throw new Error(`Invalid JSON Schema at ${path}: "required" must be an array of strings`);
+	const propertiesValue = node.properties;
+	if (propertiesValue !== void 0) {
+		if (!isPlainObject(propertiesValue)) throw new Error(`Invalid JSON Schema at ${path}: "properties" must be an object`);
+		for (const [key, value] of Object.entries(propertiesValue)) {
+			if (!isPlainObject(value)) throw new Error(`Invalid JSON Schema at ${path}.properties.${key}: expected object schema`);
+			validateJsonSchemaNode(value, `${path}.properties.${key}`);
+		}
+	}
+	const itemsValue = node.items;
+	if (itemsValue !== void 0) if (Array.isArray(itemsValue)) for (const [index, value] of itemsValue.entries()) {
+		if (!isPlainObject(value)) throw new Error(`Invalid JSON Schema at ${path}.items[${index}]: expected object schema`);
+		validateJsonSchemaNode(value, `${path}.items[${index}]`);
+	}
+	else if (isPlainObject(itemsValue)) validateJsonSchemaNode(itemsValue, `${path}.items`);
+	else throw new Error(`Invalid JSON Schema at ${path}: "items" must be an object or object[]`);
+	for (const keyword of [
+		"allOf",
+		"anyOf",
+		"oneOf"
+	]) {
+		const value = node[keyword];
+		if (value === void 0) continue;
+		if (!Array.isArray(value)) throw new Error(`Invalid JSON Schema at ${path}: "${keyword}" must be an array`);
+		for (const [index, entry] of value.entries()) {
+			if (!isPlainObject(entry)) throw new Error(`Invalid JSON Schema at ${path}.${keyword}[${index}]: expected object schema`);
+			validateJsonSchemaNode(entry, `${path}.${keyword}[${index}]`);
+		}
+	}
+	const notValue = node.not;
+	if (notValue !== void 0) {
+		if (!isPlainObject(notValue)) throw new Error(`Invalid JSON Schema at ${path}: "not" must be an object schema`);
+		validateJsonSchemaNode(notValue, `${path}.not`);
+	}
+	try {
+		JSON.stringify(node);
+	} catch {
+		throw new Error(`Invalid JSON Schema at ${path}: schema must be JSON-serializable`);
+	}
+}
+function normalizeToolDescriptor(tool, existing) {
+	if (!tool || typeof tool !== "object") throw new TypeError("registerTool(tool) requires a tool object");
+	if (typeof tool.name !== "string" || tool.name.length === 0) throw new TypeError("Tool \"name\" must be a non-empty string");
+	if (typeof tool.description !== "string" || tool.description.length === 0) throw new TypeError("Tool \"description\" must be a non-empty string");
+	if (typeof tool.execute !== "function") throw new TypeError("Tool \"execute\" must be a function");
+	if (existing.has(tool.name)) throw new Error(`Tool already registered: ${tool.name}`);
+	const normalizedInputSchema = normalizeInputSchema(tool.inputSchema);
+	return {
+		...tool,
+		inputSchema: normalizedInputSchema.inputSchema,
+		[STANDARD_VALIDATOR_SYMBOL]: normalizedInputSchema.standardValidator
+	};
+}
+function validateArgsWithSchema(args, schema) {
+	const result = new Validator(schema, "2020-12", true).validate(args);
+	if (result.valid) return null;
+	const error = result.errors[result.errors.length - 1];
+	if (!error) return { message: "Input validation failed" };
+	return { message: error.error };
+}
+function formatStandardIssuePath(path) {
+	if (!path || path.length === 0) return null;
+	const segments = path.map((segment) => {
+		if (isPlainObject(segment) && "key" in segment) return segment.key;
+		return segment;
+	}).map((segment) => String(segment)).filter((segment) => segment.length > 0);
+	if (segments.length === 0) return null;
+	return segments.join(".");
+}
+async function validateArgsWithStandardSchema(args, schema) {
+	let result;
+	try {
+		result = await Promise.resolve(schema["~standard"].validate(args));
+	} catch {
+		return "Input validation error: schema validation failed";
+	}
+	if (!result.issues || result.issues.length === 0) return null;
+	const firstIssue = result.issues[0];
+	if (!firstIssue) return "Input validation error";
+	const path = formatStandardIssuePath(firstIssue?.path);
+	if (path) return `Input validation error: ${firstIssue.message} at ${path}`;
+	return `Input validation error: ${firstIssue.message}`;
+}
+async function validateArgsForTool(args, tool) {
+	return validateArgsWithStandardSchema(args, tool[STANDARD_VALIDATOR_SYMBOL]);
+}
+function getFirstTextBlock(result) {
+	for (const block of result.content ?? []) if (block.type === "text" && "text" in block && typeof block.text === "string") return block.text;
+	return null;
+}
+function toSerializedTestingResult(result) {
+	if (result.isError) throw createUnknownError(getFirstTextBlock(result)?.replace(/^Error:\s*/i, "").trim() || TOOL_INVOCATION_FAILED_MESSAGE);
+	const metadata = result.metadata;
+	if (metadata && typeof metadata === "object" && metadata.willNavigate) return null;
+	try {
+		return JSON.stringify(result);
+	} catch {
+		throw createUnknownError(TOOL_INVOCATION_FAILED_MESSAGE);
+	}
+}
+function withAbortSignal(operation, signal) {
+	if (!signal) return operation;
+	if (signal.aborted) return Promise.reject(createUnknownError(TOOL_CANCELLED_MESSAGE));
+	return new Promise((resolve, reject) => {
+		const onAbort = () => {
+			cleanup();
+			reject(createUnknownError(TOOL_CANCELLED_MESSAGE));
+		};
+		const cleanup = () => {
+			signal.removeEventListener("abort", onAbort);
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		operation.then((value) => {
+			cleanup();
+			resolve(value);
+		}, (error) => {
+			cleanup();
+			reject(error);
+		});
+	});
+}
+function getNavigator() {
+	if (typeof navigator !== "undefined") return navigator;
+	return null;
+}
+function defineNavigatorProperty(target, key, value) {
+	Object.defineProperty(target, key, {
+		configurable: true,
+		enumerable: true,
+		writable: false,
+		value
+	});
+}
+function initializeWebMCPPolyfill(options) {
+	const nav = getNavigator();
+	if (!nav) return;
+	if (Boolean(nav.modelContext)) return;
+	if (installState.installed) cleanupWebMCPPolyfill();
+	const context = new StrictWebMCPContext();
+	const modelContext = context;
+	modelContext[POLYFILL_MARKER_PROPERTY] = true;
+	installState.previousModelContextDescriptor = Object.getOwnPropertyDescriptor(nav, "modelContext");
+	installState.previousModelContextTestingDescriptor = Object.getOwnPropertyDescriptor(nav, "modelContextTesting");
+	defineNavigatorProperty(nav, "modelContext", modelContext);
+	const installTestingShim = options?.installTestingShim ?? "if-missing";
+	const hasModelContextTesting = Boolean(nav.modelContextTesting);
+	if (installTestingShim === "always" || (installTestingShim === true || installTestingShim === "if-missing") && !hasModelContextTesting) defineNavigatorProperty(nav, "modelContextTesting", context.getTestingShim());
+	installState.installed = true;
+}
+function cleanupWebMCPPolyfill() {
+	const nav = getNavigator();
+	if (!nav || !installState.installed) return;
+	const restore = (key, previousDescriptor) => {
+		if (previousDescriptor) {
+			Object.defineProperty(nav, key, previousDescriptor);
+			return;
+		}
+		delete nav[key];
+	};
+	restore("modelContext", installState.previousModelContextDescriptor);
+	restore("modelContextTesting", installState.previousModelContextTestingDescriptor);
+	installState.installed = false;
+	installState.previousModelContextDescriptor = void 0;
+	installState.previousModelContextTestingDescriptor = void 0;
+}
+
+//#endregion
+export { cleanupWebMCPPolyfill, initializeWebMCPPolyfill, initializeWebMCPPolyfill as initializeWebModelContextPolyfill, isPlainObject, validateArgsWithSchema };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DEFAULT_INPUT_SCHEMA: InputSchema","installState: InstallState","output: ModelContextTestingToolInfo","client: ModelContextClient","parsed: unknown","result: StandardValidationResult"],"sources":["../src/index.ts"],"sourcesContent":["import { type Schema, Validator } from '@cfworker/json-schema';\nimport type {\n  InputSchema,\n  ModelContext,\n  ModelContextClient,\n  ModelContextOptions,\n  ModelContextTesting,\n  ModelContextTestingExecuteToolOptions,\n  ModelContextTestingToolInfo,\n  ToolDescriptor,\n  ToolResponse,\n} from '@mcp-b/webmcp-types';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nconst FAILED_TO_PARSE_INPUT_ARGUMENTS_MESSAGE = 'Failed to parse input arguments';\nconst TOOL_INVOCATION_FAILED_MESSAGE =\n  'Tool was executed but the invocation failed. For example, the script function threw an error';\nconst TOOL_CANCELLED_MESSAGE = 'Tool was cancelled';\nconst DEFAULT_INPUT_SCHEMA: InputSchema = { type: 'object', properties: {} };\nconst STANDARD_JSON_SCHEMA_TARGETS = ['draft-2020-12', 'draft-07'] as const;\n\nconst POLYFILL_MARKER_PROPERTY = '__isWebMCPPolyfill' as const;\nconst STANDARD_VALIDATOR_SYMBOL = Symbol('standardValidator');\n\nexport type StandardInputValidatorSchema = StandardSchemaV1<\n  Record<string, unknown>,\n  Record<string, unknown>\n>;\nexport interface StandardJSONSchemaV1<Input = unknown, Output = Input> {\n  readonly '~standard': {\n    readonly version: 1;\n    readonly vendor: string;\n    readonly types?: { readonly input: Input; readonly output: Output } | undefined;\n    readonly jsonSchema: {\n      readonly input: (options: {\n        readonly target: 'draft-2020-12' | 'draft-07' | 'openapi-3.0' | ({} & string);\n        readonly libraryOptions?: Record<string, unknown> | undefined;\n      }) => Record<string, unknown>;\n      readonly output: (options: {\n        readonly target: 'draft-2020-12' | 'draft-07' | 'openapi-3.0' | ({} & string);\n        readonly libraryOptions?: Record<string, unknown> | undefined;\n      }) => Record<string, unknown>;\n    };\n  };\n}\nexport type StandardInputJsonSchema = StandardJSONSchemaV1<\n  Record<string, unknown>,\n  Record<string, unknown>\n>;\nexport type ToolInputSchema = InputSchema | StandardInputValidatorSchema | StandardInputJsonSchema;\nexport type ToolOutputSchema = InputSchema | StandardInputJsonSchema;\n\ntype StandardValidationResult = Awaited<\n  ReturnType<StandardInputValidatorSchema['~standard']['validate']>\n>;\ntype StandardValidationIssue = NonNullable<StandardValidationResult['issues']>[number];\n\ninterface PolyfillModelContext extends ModelContext {\n  [POLYFILL_MARKER_PROPERTY]: true;\n}\n\ninterface PolyfillToolDescriptor\n  extends ToolDescriptor<Record<string, unknown>, ToolResponse, string> {\n  inputSchema: InputSchema;\n  [STANDARD_VALIDATOR_SYMBOL]: StandardInputValidatorSchema;\n}\n\ninterface NormalizedInputSchema {\n  inputSchema: InputSchema;\n  standardValidator: StandardInputValidatorSchema;\n}\n\ninterface InstallState {\n  installed: boolean;\n  previousModelContextDescriptor: PropertyDescriptor | undefined;\n  previousModelContextTestingDescriptor: PropertyDescriptor | undefined;\n}\n\nconst installState: InstallState = {\n  installed: false,\n  previousModelContextDescriptor: undefined,\n  previousModelContextTestingDescriptor: undefined,\n};\n\nexport interface WebMCPPolyfillInitOptions {\n  /**\n   * Controls installation of navigator.modelContextTesting when this polyfill provides modelContext.\n   * - true or 'if-missing' (default): install only when modelContextTesting is missing.\n   * - 'always': install even when modelContextTesting already exists.\n   * - false: do not install.\n   * @default 'if-missing'\n   */\n  installTestingShim?: boolean | 'always' | 'if-missing';\n\n  /**\n   * Deprecated no-op kept for backward compatibility with previous wrappers.\n   */\n  disableIframeTransportByDefault?: boolean;\n}\n\nclass StrictWebMCPContext {\n  private tools = new Map<string, PolyfillToolDescriptor>();\n  private toolsChangedCallback: (() => void) | null = null;\n\n  provideContext(options: ModelContextOptions = {}): void {\n    const nextTools = new Map<string, PolyfillToolDescriptor>();\n\n    for (const tool of options.tools ?? []) {\n      const normalized = normalizeToolDescriptor(tool, nextTools);\n      nextTools.set(normalized.name, normalized);\n    }\n\n    this.tools = nextTools;\n    this.notifyToolsChanged();\n  }\n\n  clearContext(): void {\n    this.tools.clear();\n    this.notifyToolsChanged();\n  }\n\n  registerTool(tool: ToolDescriptor): void {\n    const normalized = normalizeToolDescriptor(tool, this.tools);\n    this.tools.set(normalized.name, normalized);\n    this.notifyToolsChanged();\n  }\n\n  unregisterTool(name: string): void {\n    const removed = this.tools.delete(name);\n    if (removed) {\n      this.notifyToolsChanged();\n    }\n  }\n\n  getTestingShim(): ModelContextTesting {\n    return {\n      listTools: () => {\n        return [...this.tools.values()].map((tool) => {\n          const output: ModelContextTestingToolInfo = {\n            name: tool.name,\n            description: tool.description,\n          };\n\n          try {\n            output.inputSchema = JSON.stringify(tool.inputSchema);\n          } catch {\n            // Keep inputSchema omitted when serialization fails.\n          }\n\n          return output;\n        });\n      },\n      executeTool: (\n        toolName: string,\n        inputArgsJson: string,\n        options?: ModelContextTestingExecuteToolOptions\n      ) => this.executeToolForTesting(toolName, inputArgsJson, options),\n      registerToolsChangedCallback: (callback: () => void) => {\n        if (typeof callback !== 'function') {\n          throw new TypeError(\n            \"Failed to execute 'registerToolsChangedCallback' on 'ModelContextTesting': parameter 1 is not of type 'Function'.\"\n          );\n        }\n        this.toolsChangedCallback = callback;\n      },\n      getCrossDocumentScriptToolResult: async () => '[]',\n    };\n  }\n\n  private async executeToolForTesting(\n    toolName: string,\n    inputArgsJson: string,\n    options?: ModelContextTestingExecuteToolOptions\n  ): Promise<string | null> {\n    if (options?.signal?.aborted) {\n      throw createUnknownError(TOOL_CANCELLED_MESSAGE);\n    }\n\n    const tool = this.tools.get(toolName);\n    if (!tool) {\n      throw createUnknownError(`Tool not found: ${toolName}`);\n    }\n\n    const args = parseInputArgsJson(inputArgsJson);\n    const validationError = await validateArgsForTool(args, tool);\n    if (validationError) {\n      throw createUnknownError(validationError);\n    }\n\n    let contextActive = true;\n    const client: ModelContextClient = {\n      requestUserInteraction: async (callback: () => Promise<unknown>): Promise<unknown> => {\n        if (!contextActive) {\n          throw new Error(\n            `ModelContextClient for tool \"${toolName}\" is no longer active after execute() resolved`\n          );\n        }\n\n        if (typeof callback !== 'function') {\n          throw new TypeError('requestUserInteraction(callback) requires a function callback');\n        }\n\n        return callback();\n      },\n    };\n\n    try {\n      const execution = tool.execute(args, client);\n      const result = await withAbortSignal(Promise.resolve(execution), options?.signal);\n      return toSerializedTestingResult(result);\n    } catch {\n      throw createUnknownError(TOOL_INVOCATION_FAILED_MESSAGE);\n    } finally {\n      contextActive = false;\n    }\n  }\n\n  private notifyToolsChanged(): void {\n    if (!this.toolsChangedCallback) {\n      return;\n    }\n\n    queueMicrotask(() => {\n      try {\n        this.toolsChangedCallback?.();\n      } catch {\n        // Callback errors are ignored to match browser event callback behavior.\n      }\n    });\n  }\n}\n\nfunction createUnknownError(message: string): Error {\n  try {\n    return new DOMException(message, 'UnknownError');\n  } catch {\n    const error = new Error(message);\n    error.name = 'UnknownError';\n    return error;\n  }\n}\n\nfunction parseInputArgsJson(inputArgsJson: string): Record<string, unknown> {\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(inputArgsJson);\n  } catch {\n    throw createUnknownError(FAILED_TO_PARSE_INPUT_ARGUMENTS_MESSAGE);\n  }\n\n  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    throw createUnknownError(FAILED_TO_PARSE_INPUT_ARGUMENTS_MESSAGE);\n  }\n\n  return parsed as Record<string, unknown>;\n}\n\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction getStandardProps(value: unknown): Record<string, unknown> | null {\n  if (!isPlainObject(value)) {\n    return null;\n  }\n\n  const standard = value['~standard'];\n  if (!isPlainObject(standard)) {\n    return null;\n  }\n\n  return standard;\n}\n\nfunction isStandardInputValidatorSchema(value: unknown): value is StandardInputValidatorSchema {\n  const standard = getStandardProps(value);\n  return Boolean(standard && standard.version === 1 && typeof standard.validate === 'function');\n}\n\nfunction isStandardInputJsonSchema(value: unknown): value is StandardInputJsonSchema {\n  const standard = getStandardProps(value);\n  if (!standard || standard.version !== 1 || !isPlainObject(standard.jsonSchema)) {\n    return false;\n  }\n\n  return typeof standard.jsonSchema.input === 'function';\n}\n\nfunction createStandardValidatorFromJsonSchema(schema: InputSchema): StandardInputValidatorSchema {\n  return {\n    '~standard': {\n      version: 1,\n      vendor: '@mcp-b/webmcp-polyfill-json-schema',\n      validate(value: unknown): StandardValidationResult {\n        if (!isPlainObject(value)) {\n          return {\n            issues: [{ message: 'expected object arguments' }],\n          };\n        }\n\n        const issue = validateArgsWithSchema(value, schema);\n        if (issue) {\n          return {\n            issues: [issue],\n          };\n        }\n\n        return {\n          value,\n        };\n      },\n    },\n  };\n}\n\nfunction convertStandardInputSchema(schema: StandardInputJsonSchema): InputSchema {\n  for (const target of STANDARD_JSON_SCHEMA_TARGETS) {\n    try {\n      const converted = schema['~standard'].jsonSchema.input({ target });\n      validateInputSchema(converted);\n      return converted;\n    } catch {\n      // Try the next target.\n    }\n  }\n\n  throw new Error('Failed to convert Standard JSON Schema inputSchema to a JSON Schema object');\n}\n\nfunction normalizeInputSchema(inputSchema: ToolInputSchema | undefined): NormalizedInputSchema {\n  if (inputSchema === undefined) {\n    const normalized = DEFAULT_INPUT_SCHEMA;\n    return {\n      inputSchema: normalized,\n      standardValidator: createStandardValidatorFromJsonSchema(normalized),\n    };\n  }\n\n  if (isStandardInputJsonSchema(inputSchema)) {\n    // Prefer JSON conversion for parity across JSON and Standard Schema inputs.\n    const converted = convertStandardInputSchema(inputSchema);\n    return {\n      inputSchema: converted,\n      standardValidator: createStandardValidatorFromJsonSchema(converted),\n    };\n  }\n\n  if (isStandardInputValidatorSchema(inputSchema)) {\n    return {\n      inputSchema: DEFAULT_INPUT_SCHEMA,\n      standardValidator: inputSchema,\n    };\n  }\n\n  validateInputSchema(inputSchema);\n  return {\n    inputSchema,\n    standardValidator: createStandardValidatorFromJsonSchema(inputSchema),\n  };\n}\n\nfunction validateInputSchema(schema: unknown): asserts schema is InputSchema {\n  if (!isPlainObject(schema)) {\n    throw new Error('inputSchema must be a JSON Schema object');\n  }\n\n  validateJsonSchemaNode(schema, '$');\n}\n\nfunction validateJsonSchemaNode(node: Record<string, unknown>, path: string): void {\n  const typeValue = node.type;\n  if (\n    typeValue !== undefined &&\n    typeof typeValue !== 'string' &&\n    !(\n      Array.isArray(typeValue) &&\n      typeValue.every((entry) => typeof entry === 'string' && entry.length > 0)\n    )\n  ) {\n    throw new Error(`Invalid JSON Schema at ${path}: \"type\" must be a string or string[]`);\n  }\n\n  const requiredValue = node.required;\n  if (\n    requiredValue !== undefined &&\n    !(Array.isArray(requiredValue) && requiredValue.every((entry) => typeof entry === 'string'))\n  ) {\n    throw new Error(`Invalid JSON Schema at ${path}: \"required\" must be an array of strings`);\n  }\n\n  const propertiesValue = node.properties;\n  if (propertiesValue !== undefined) {\n    if (!isPlainObject(propertiesValue)) {\n      throw new Error(`Invalid JSON Schema at ${path}: \"properties\" must be an object`);\n    }\n\n    for (const [key, value] of Object.entries(propertiesValue)) {\n      if (!isPlainObject(value)) {\n        throw new Error(`Invalid JSON Schema at ${path}.properties.${key}: expected object schema`);\n      }\n      validateJsonSchemaNode(value, `${path}.properties.${key}`);\n    }\n  }\n\n  const itemsValue = node.items;\n  if (itemsValue !== undefined) {\n    if (Array.isArray(itemsValue)) {\n      for (const [index, value] of itemsValue.entries()) {\n        if (!isPlainObject(value)) {\n          throw new Error(`Invalid JSON Schema at ${path}.items[${index}]: expected object schema`);\n        }\n        validateJsonSchemaNode(value, `${path}.items[${index}]`);\n      }\n    } else if (isPlainObject(itemsValue)) {\n      validateJsonSchemaNode(itemsValue, `${path}.items`);\n    } else {\n      throw new Error(`Invalid JSON Schema at ${path}: \"items\" must be an object or object[]`);\n    }\n  }\n\n  for (const keyword of ['allOf', 'anyOf', 'oneOf'] as const) {\n    const value = node[keyword];\n    if (value === undefined) {\n      continue;\n    }\n\n    if (!Array.isArray(value)) {\n      throw new Error(`Invalid JSON Schema at ${path}: \"${keyword}\" must be an array`);\n    }\n\n    for (const [index, entry] of value.entries()) {\n      if (!isPlainObject(entry)) {\n        throw new Error(\n          `Invalid JSON Schema at ${path}.${keyword}[${index}]: expected object schema`\n        );\n      }\n      validateJsonSchemaNode(entry, `${path}.${keyword}[${index}]`);\n    }\n  }\n\n  const notValue = node.not;\n  if (notValue !== undefined) {\n    if (!isPlainObject(notValue)) {\n      throw new Error(`Invalid JSON Schema at ${path}: \"not\" must be an object schema`);\n    }\n    validateJsonSchemaNode(notValue, `${path}.not`);\n  }\n\n  try {\n    JSON.stringify(node);\n  } catch {\n    throw new Error(`Invalid JSON Schema at ${path}: schema must be JSON-serializable`);\n  }\n}\n\nfunction normalizeToolDescriptor(\n  tool: ToolDescriptor,\n  existing: Map<string, PolyfillToolDescriptor>\n): PolyfillToolDescriptor {\n  if (!tool || typeof tool !== 'object') {\n    throw new TypeError('registerTool(tool) requires a tool object');\n  }\n\n  if (typeof tool.name !== 'string' || tool.name.length === 0) {\n    throw new TypeError('Tool \"name\" must be a non-empty string');\n  }\n\n  if (typeof tool.description !== 'string' || tool.description.length === 0) {\n    throw new TypeError('Tool \"description\" must be a non-empty string');\n  }\n\n  if (typeof tool.execute !== 'function') {\n    throw new TypeError('Tool \"execute\" must be a function');\n  }\n\n  if (existing.has(tool.name)) {\n    throw new Error(`Tool already registered: ${tool.name}`);\n  }\n\n  const normalizedInputSchema = normalizeInputSchema(tool.inputSchema);\n\n  return {\n    ...tool,\n    inputSchema: normalizedInputSchema.inputSchema,\n    [STANDARD_VALIDATOR_SYMBOL]: normalizedInputSchema.standardValidator,\n  };\n}\n\nexport function validateArgsWithSchema(\n  args: Record<string, unknown>,\n  schema: InputSchema\n): StandardValidationIssue | null {\n  const validator = new Validator(schema as Schema, '2020-12', true);\n  const result = validator.validate(args);\n\n  if (result.valid) {\n    return null;\n  }\n\n  // Use the deepest (last) error for the most specific message.\n  const error = result.errors[result.errors.length - 1];\n  if (!error) {\n    return { message: 'Input validation failed' };\n  }\n\n  return { message: error.error };\n}\n\nfunction formatStandardIssuePath(path: StandardValidationIssue['path']) {\n  if (!path || path.length === 0) {\n    return null;\n  }\n\n  const segments = path\n    .map((segment) => {\n      if (isPlainObject(segment) && 'key' in segment) {\n        return segment.key;\n      }\n      return segment;\n    })\n    .map((segment) => String(segment))\n    .filter((segment) => segment.length > 0);\n\n  if (segments.length === 0) {\n    return null;\n  }\n\n  return segments.join('.');\n}\n\nasync function validateArgsWithStandardSchema(\n  args: Record<string, unknown>,\n  schema: StandardInputValidatorSchema\n): Promise<string | null> {\n  let result: StandardValidationResult;\n\n  try {\n    result = await Promise.resolve(schema['~standard'].validate(args));\n  } catch {\n    return 'Input validation error: schema validation failed';\n  }\n\n  if (!result.issues || result.issues.length === 0) {\n    return null;\n  }\n\n  const firstIssue = result.issues[0];\n  if (!firstIssue) {\n    return 'Input validation error';\n  }\n\n  const path = formatStandardIssuePath(firstIssue?.path);\n  if (path) {\n    return `Input validation error: ${firstIssue.message} at ${path}`;\n  }\n\n  return `Input validation error: ${firstIssue.message}`;\n}\n\nasync function validateArgsForTool(\n  args: Record<string, unknown>,\n  tool: PolyfillToolDescriptor\n): Promise<string | null> {\n  return validateArgsWithStandardSchema(args, tool[STANDARD_VALIDATOR_SYMBOL]);\n}\n\nfunction getFirstTextBlock(result: ToolResponse): string | null {\n  for (const block of result.content ?? []) {\n    if (block.type === 'text' && 'text' in block && typeof block.text === 'string') {\n      return block.text;\n    }\n  }\n\n  return null;\n}\n\nfunction toSerializedTestingResult(result: ToolResponse): string | null {\n  if (result.isError) {\n    const firstText = getFirstTextBlock(result);\n    const message = firstText?.replace(/^Error:\\s*/i, '').trim() || TOOL_INVOCATION_FAILED_MESSAGE;\n    throw createUnknownError(message);\n  }\n\n  const metadata = (result as ToolResponse & { metadata?: { willNavigate?: boolean } }).metadata;\n  if (metadata && typeof metadata === 'object' && metadata.willNavigate) {\n    return null;\n  }\n\n  try {\n    return JSON.stringify(result);\n  } catch {\n    throw createUnknownError(TOOL_INVOCATION_FAILED_MESSAGE);\n  }\n}\n\nfunction withAbortSignal<T>(operation: Promise<T>, signal?: AbortSignal): Promise<T> {\n  if (!signal) {\n    return operation;\n  }\n\n  if (signal.aborted) {\n    return Promise.reject(createUnknownError(TOOL_CANCELLED_MESSAGE));\n  }\n\n  return new Promise<T>((resolve, reject) => {\n    const onAbort = () => {\n      cleanup();\n      reject(createUnknownError(TOOL_CANCELLED_MESSAGE));\n    };\n\n    const cleanup = () => {\n      signal.removeEventListener('abort', onAbort);\n    };\n\n    signal.addEventListener('abort', onAbort, { once: true });\n\n    operation.then(\n      (value) => {\n        cleanup();\n        resolve(value);\n      },\n      (error) => {\n        cleanup();\n        reject(error);\n      }\n    );\n  });\n}\n\nfunction getNavigator(): Navigator | null {\n  if (typeof navigator !== 'undefined') {\n    return navigator;\n  }\n\n  return null;\n}\n\nfunction defineNavigatorProperty<K extends keyof Navigator>(\n  target: Navigator,\n  key: K,\n  value: Navigator[K]\n): void {\n  Object.defineProperty(target, key, {\n    configurable: true,\n    enumerable: true,\n    writable: false,\n    value,\n  });\n}\n\nexport function initializeWebMCPPolyfill(options?: WebMCPPolyfillInitOptions): void {\n  const nav = getNavigator();\n  if (!nav) {\n    return;\n  }\n\n  const hasModelContext = Boolean(nav.modelContext);\n\n  if (hasModelContext) {\n    return;\n  }\n\n  if (installState.installed) {\n    cleanupWebMCPPolyfill();\n  }\n\n  const context = new StrictWebMCPContext();\n  const modelContext = context as unknown as PolyfillModelContext;\n  modelContext[POLYFILL_MARKER_PROPERTY] = true;\n\n  installState.previousModelContextDescriptor = Object.getOwnPropertyDescriptor(\n    nav,\n    'modelContext'\n  );\n  installState.previousModelContextTestingDescriptor = Object.getOwnPropertyDescriptor(\n    nav,\n    'modelContextTesting'\n  );\n\n  defineNavigatorProperty(nav, 'modelContext', modelContext as Navigator['modelContext']);\n\n  const installTestingShim = options?.installTestingShim ?? 'if-missing';\n  const hasModelContextTesting = Boolean(nav.modelContextTesting);\n  const shouldInstallTestingShim =\n    installTestingShim === 'always' ||\n    ((installTestingShim === true || installTestingShim === 'if-missing') &&\n      !hasModelContextTesting);\n\n  if (shouldInstallTestingShim) {\n    defineNavigatorProperty(\n      nav,\n      'modelContextTesting',\n      context.getTestingShim() as Navigator['modelContextTesting']\n    );\n  }\n\n  installState.installed = true;\n}\n\nexport function cleanupWebMCPPolyfill(): void {\n  const nav = getNavigator();\n  if (!nav || !installState.installed) {\n    return;\n  }\n\n  const restore = <K extends keyof Navigator>(\n    key: K,\n    previousDescriptor: PropertyDescriptor | undefined\n  ) => {\n    if (previousDescriptor) {\n      Object.defineProperty(nav, key, previousDescriptor);\n      return;\n    }\n\n    delete (nav as unknown as Record<string, unknown>)[key as string];\n  };\n\n  restore('modelContext', installState.previousModelContextDescriptor);\n  restore('modelContextTesting', installState.previousModelContextTestingDescriptor);\n\n  installState.installed = false;\n  installState.previousModelContextDescriptor = undefined;\n  installState.previousModelContextTestingDescriptor = undefined;\n}\n\nexport { initializeWebMCPPolyfill as initializeWebModelContextPolyfill };\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@mcp-b/webmcp-polyfill",
+  "version": "0.0.0-beta-20260216200013",
+  "description": "Strict WebMCP core runtime polyfill for navigator.modelContext",
+  "keywords": [
+    "webmcp",
+    "model-context",
+    "navigator-modelcontext",
+    "polyfill",
+    "browser"
+  ],
+  "homepage": "https://docs.mcp-b.ai/packages/webmcp-polyfill",
+  "bugs": {
+    "url": "https://github.com/WebMCP-org/npm-packages/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WebMCP-org/npm-packages.git",
+    "directory": "packages/webmcp-polyfill"
+  },
+  "license": "MIT",
+  "author": "Alex Nahas",
+  "sideEffects": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@cfworker/json-schema": "^4.1.1",
+    "@standard-schema/spec": "^1.1.0",
+    "@mcp-b/webmcp-types": "0.0.0-beta-20260216200013"
+  },
+  "devDependencies": {
+    "@vitest/browser": "^4.0.18",
+    "@vitest/browser-playwright": "^4.0.18",
+    "@vitest/coverage-v8": "^4.0.18",
+    "playwright": "^1.58.0",
+    "tsdown": "^0.15.10",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "pnpm --filter @mcp-b/webmcp-types build && tsdown",
+    "check": "biome check --write .",
+    "clean": "rm -rf dist .turbo",
+    "format": "biome format --write .",
+    "lint": "biome lint --write .",
+    "publish:dry": "pnpm publish --access public --dry-run",
+    "publish:npm": "pnpm publish --access public",
+    "test": "vitest run",
+    "test:browser": "vitest run --config vitest.browser.config.ts --browser.headless",
+    "test:browser:ui": "vitest --config vitest.browser.config.ts --browser",
+    "typecheck": "pnpm --filter @mcp-b/webmcp-types build && tsc --noEmit && vitest run --typecheck --silent"
+  }
+}