@mcp-b/webmcp-polyfill 2.3.2 → 3.0.0-beta.20260702171253

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Schema, Validator } from '@cfworker/json-schema';\nimport type {\n InputSchema,\n JsonObject,\n ModelContext,\n ModelContextClient,\n ModelContextOptions,\n ModelContextRegisterToolOptions,\n ModelContextTesting,\n ModelContextTestingExecuteToolOptions,\n ModelContextTestingToolInfo,\n ModelContextToolReference,\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 extends ToolDescriptor<Record<string, unknown>, unknown, 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 whether the polyfill auto-initializes when loaded.\n * Set to false to prevent auto-initialization; then call initializeWebMCPPolyfill() manually.\n * @default true\n */\n autoInitialize?: boolean;\n\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 extends EventTarget {\n private tools = new Map<string, PolyfillToolDescriptor>();\n private testingShim: PolyfillTestingShim | null = null;\n private _ontoolchange: ((this: ModelContext, ev: Event) => unknown) | null = null;\n private provideContextDeprecationWarned = false;\n private clearContextDeprecationWarned = false;\n private unregisterToolDeprecationWarned = false;\n\n get ontoolchange(): ((this: ModelContext, ev: Event) => unknown) | null {\n return this._ontoolchange;\n }\n\n set ontoolchange(handler: ((this: ModelContext, ev: Event) => unknown) | null) {\n this._ontoolchange = handler;\n }\n\n provideContext(options: ModelContextOptions = {}): void {\n this.warnProvideContextDeprecationOnce();\n\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.warnClearContextDeprecationOnce();\n\n this.tools.clear();\n this.notifyToolsChanged();\n }\n\n registerTool(tool: ToolDescriptor, options?: ModelContextRegisterToolOptions): void {\n const signal = options?.signal;\n\n if (signal?.aborted) {\n console.warn(\n `[WebMCPPolyfill] registerTool(\"${\n tool?.name ?? '<unknown>'\n }\") skipped: options.signal was already aborted.`\n );\n return;\n }\n\n const normalized = normalizeToolDescriptor(tool, this.tools);\n this.tools.set(normalized.name, normalized);\n this.notifyToolsChanged();\n\n if (signal) {\n signal.addEventListener(\n 'abort',\n () => {\n if (this.tools.delete(normalized.name)) {\n this.notifyToolsChanged();\n }\n },\n { once: true }\n );\n }\n }\n\n unregisterTool(nameOrTool: string | ModelContextToolReference): void {\n this.warnUnregisterToolDeprecationOnce();\n\n const name = getToolNameForUnregister(nameOrTool);\n const removed = this.tools.delete(name);\n if (removed) {\n this.notifyToolsChanged();\n }\n }\n\n getTools(): ModelContextTestingToolInfo[] {\n return this.getToolInfos();\n }\n\n getTestingShim(): PolyfillTestingShim {\n if (!this.testingShim) {\n this.testingShim = new PolyfillTestingShim(this);\n }\n return this.testingShim;\n }\n\n /** @internal Used by PolyfillTestingShim */\n getToolInfos(): ModelContextTestingToolInfo[] {\n return [...this.tools.values()].map((tool) => {\n let inputSchema: string;\n try {\n inputSchema = JSON.stringify(tool.inputSchema ?? { type: 'object' });\n } catch {\n inputSchema = '{\"type\":\"object\"}';\n }\n return { name: tool.name, description: tool.description, inputSchema };\n });\n }\n\n /** @internal Used by PolyfillTestingShim */\n 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 rawResult = await withAbortSignal(Promise.resolve(execution), options?.signal);\n return toSerializedTestingResult(normalizeToolResponse(rawResult));\n } catch (error) {\n const detail =\n error instanceof Error\n ? `${TOOL_INVOCATION_FAILED_MESSAGE}: ${error.message}`\n : TOOL_INVOCATION_FAILED_MESSAGE;\n throw createUnknownError(detail);\n } finally {\n contextActive = false;\n }\n }\n\n private notifyToolsChanged(): void {\n queueMicrotask(() => {\n const event = new Event('toolchange');\n try {\n this._ontoolchange?.call(this as unknown as ModelContext, event);\n } catch (error) {\n console.warn('[WebMCPPolyfill] navigator.modelContext.ontoolchange handler threw:', error);\n }\n this.dispatchEvent(event);\n this.testingShim?.dispatchToolChange();\n });\n }\n\n private warnProvideContextDeprecationOnce(): void {\n if (this.provideContextDeprecationWarned) {\n return;\n }\n\n this.provideContextDeprecationWarned = true;\n console.warn(\n '[WebMCPPolyfill] navigator.modelContext.provideContext() is deprecated and will be removed in the next major version. Register tools individually with registerTool() instead.'\n );\n }\n\n private warnClearContextDeprecationOnce(): void {\n if (this.clearContextDeprecationWarned) {\n return;\n }\n\n this.clearContextDeprecationWarned = true;\n console.warn(\n '[WebMCPPolyfill] navigator.modelContext.clearContext() is deprecated and will be removed in the next major version. Unregister individual tools instead.'\n );\n }\n\n private warnUnregisterToolDeprecationOnce(): void {\n if (this.unregisterToolDeprecationWarned) {\n return;\n }\n\n this.unregisterToolDeprecationWarned = true;\n console.warn(\n '[WebMCPPolyfill] navigator.modelContext.unregisterTool() is deprecated. The April 23, 2026 WebMCP draft removed it in favor of registerTool(tool, { signal }) — pass an AbortSignal and abort it to unregister.'\n );\n }\n}\n\n/**\n * EventTarget-based testing shim matching the native Chromium ModelContextTesting surface.\n *\n * Fires `toolchange` events and supports the `ontoolchange` handler property,\n * matching the native Chromium 148 API. The deprecated `registerToolsChangedCallback`\n * is kept as a compat layer that wraps `addEventListener`.\n */\nclass PolyfillTestingShim extends EventTarget implements ModelContextTesting {\n private context: StrictWebMCPContext;\n private _ontoolchange: ((this: ModelContextTesting, ev: Event) => unknown) | null = null;\n\n constructor(context: StrictWebMCPContext) {\n super();\n this.context = context;\n }\n\n listTools(): ModelContextTestingToolInfo[] {\n return this.context.getToolInfos();\n }\n\n executeTool(\n toolName: string,\n inputArgsJson: string,\n options?: ModelContextTestingExecuteToolOptions\n ): Promise<string | null> {\n return this.context.executeToolForTesting(toolName, inputArgsJson, options);\n }\n\n getCrossDocumentScriptToolResult(): Promise<string> {\n return Promise.resolve('[]');\n }\n\n get ontoolchange(): ((this: ModelContextTesting, ev: Event) => unknown) | null {\n return this._ontoolchange;\n }\n\n set ontoolchange(handler: ((this: ModelContextTesting, ev: Event) => unknown) | null) {\n this._ontoolchange = handler;\n }\n\n /**\n * @deprecated Use `addEventListener('toolchange', callback)` instead.\n * Kept for backward compatibility with older polyfill consumers.\n */\n registerToolsChangedCallback(callback: () => void): 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.addEventListener('toolchange', callback);\n }\n\n /** @internal Called by StrictWebMCPContext when tools change. */\n dispatchToolChange(): void {\n const event = new Event('toolchange');\n try {\n this._ontoolchange?.call(this, event);\n } catch (error) {\n console.warn('[WebMCPPolyfill] ontoolchange handler threw:', error);\n }\n this.dispatchEvent(event);\n // Deprecated compat: fire old event name so existing listeners keep working\n this.dispatchEvent(new Event('toolschanged'));\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\nfunction getToolNameForUnregister(nameOrTool: string | ModelContextToolReference): string {\n if (typeof nameOrTool === 'string') {\n return nameOrTool;\n }\n\n if (isPlainObject(nameOrTool) && typeof nameOrTool.name === 'string') {\n return nameOrTool.name;\n }\n\n throw new TypeError(\n \"Failed to execute 'unregisterTool' on 'ModelContext': parameter 1 must be a string or an object with a string name.\"\n );\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 (error) {\n console.warn(\n `[WebMCPPolyfill] Standard JSON Schema conversion failed for target \"${target}\":`,\n error\n );\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\n // Empty {} is valid JSON Schema but lacks type:\"object\" required by MCP.\n if (Object.keys(inputSchema as Record<string, unknown>).length === 0) {\n return {\n inputSchema: DEFAULT_INPUT_SCHEMA,\n standardValidator: createStandardValidatorFromJsonSchema(DEFAULT_INPUT_SCHEMA),\n };\n }\n\n const normalizedSchema =\n inputSchema.type === undefined\n ? ({ type: 'object', ...inputSchema } as InputSchema)\n : inputSchema;\n return {\n inputSchema: normalizedSchema,\n standardValidator: createStandardValidatorFromJsonSchema(normalizedSchema),\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 const annotations = tool.annotations;\n const normalizedAnnotations = annotations\n ? {\n ...annotations,\n ...(annotations.readOnlyHint === 'true'\n ? { readOnlyHint: true }\n : annotations.readOnlyHint === 'false'\n ? { readOnlyHint: false }\n : {}),\n ...(annotations.destructiveHint === 'true'\n ? { destructiveHint: true }\n : annotations.destructiveHint === 'false'\n ? { destructiveHint: false }\n : {}),\n ...(annotations.idempotentHint === 'true'\n ? { idempotentHint: true }\n : annotations.idempotentHint === 'false'\n ? { idempotentHint: false }\n : {}),\n ...(annotations.openWorldHint === 'true'\n ? { openWorldHint: true }\n : annotations.openWorldHint === 'false'\n ? { openWorldHint: false }\n : {}),\n }\n : undefined;\n\n return {\n ...tool,\n ...(normalizedAnnotations ? { annotations: normalizedAnnotations } : {}),\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 (error) {\n const detail = error instanceof Error ? `: ${error.message}` : '';\n console.error('[WebMCPPolyfill] Standard Schema validation threw unexpectedly:', error);\n return `Input validation error: schema validation failed${detail}`;\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 isCallToolResult(value: unknown): value is ToolResponse {\n return isPlainObject(value) && Array.isArray(value.content);\n}\n\nfunction isJsonPrimitive(value: unknown): value is string | number | boolean | null {\n return (\n value === null ||\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n );\n}\n\nfunction isJsonValue(value: unknown): boolean {\n if (isJsonPrimitive(value)) {\n return Number.isFinite(value as number) || typeof value !== 'number';\n }\n\n if (Array.isArray(value)) {\n return value.every((entry) => isJsonValue(entry));\n }\n\n if (!isPlainObject(value)) {\n return false;\n }\n\n return Object.values(value).every((entry) => isJsonValue(entry));\n}\n\nfunction toStructuredContent(value: unknown): JsonObject | undefined {\n if (!isPlainObject(value) || !isJsonValue(value)) {\n return undefined;\n }\n\n return value as JsonObject;\n}\n\nfunction serializeTextContent(value: unknown): string {\n if (typeof value === 'string') {\n return value;\n }\n\n try {\n const candidate = JSON.stringify(value);\n return candidate ?? String(value);\n } catch {\n return String(value);\n }\n}\n\nfunction normalizeToolResponse(value: unknown): ToolResponse {\n if (isCallToolResult(value)) {\n return value;\n }\n\n const structuredContent = toStructuredContent(value);\n\n return {\n content: [\n {\n type: 'text',\n text: serializeTextContent(value),\n },\n ],\n ...(structuredContent ? { structuredContent } : {}),\n isError: false,\n };\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\ndeclare global {\n interface Window {\n __webMCPPolyfillOptions?: WebMCPPolyfillInitOptions;\n }\n}\n\nif (typeof window !== 'undefined' && typeof document !== 'undefined') {\n const options = window.__webMCPPolyfillOptions;\n const shouldAutoInitialize = options?.autoInitialize !== false;\n\n if (shouldAutoInitialize) {\n try {\n initializeWebMCPPolyfill(options);\n } catch (error) {\n console.error('[WebMCPPolyfill] Auto-initialization failed:', error);\n }\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n InputSchema,\n ModelContext,\n ModelContextClient,\n ModelContextRegisterToolOptions,\n ModelContextTesting,\n ModelContextTestingExecuteToolOptions,\n ModelContextTestingToolInfo,\n ModelContextToolInfo,\n ModelContextToolReference,\n ToolDescriptor,\n ToolResponse,\n} from '@mcp-b/webmcp-types';\nimport {\n isPlainObject,\n normalizeInputSchema,\n toJsonValue,\n validateValueWithSchema,\n} from './schema.js';\nimport type { StandardInputValidatorSchema } from './schema.js';\nexport {\n isPlainObject,\n normalizeInputSchema,\n toJsonValue,\n validateValueWithSchema,\n} from './schema.js';\nexport type {\n StandardInputJsonSchema,\n StandardInputValidatorSchema,\n StandardJSONSchemaV1,\n ToolInputSchema,\n ToolOutputSchema,\n} from './schema.js';\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';\n/** WebMCP §4.2 tool name: ASCII alnum, underscore, hyphen, period; 1–128 code points. */\nconst VALID_TOOL_NAME_RE = /^[A-Za-z0-9_\\-.]{1,128}$/u;\n\nconst POLYFILL_MARKER_PROPERTY = '__isWebMCPPolyfill' as const;\nconst STANDARD_VALIDATOR_SYMBOL = Symbol('standardValidator');\n\nfunction createAbortError(): Error {\n return new DOMException('signal is aborted without reason', 'AbortError');\n}\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 extends ToolDescriptor<Record<string, unknown>, unknown, string> {\n inputSchema: InputSchema;\n [STANDARD_VALIDATOR_SYMBOL]: StandardInputValidatorSchema;\n}\n\ninterface InstallState {\n installed: boolean;\n previousNavigatorModelContextDescriptor: PropertyDescriptor | undefined;\n previousNavigatorModelContextTestingDescriptor: PropertyDescriptor | undefined;\n previousDocumentModelContextDescriptor: PropertyDescriptor | undefined;\n installedNavigatorModelContext: boolean;\n installedNavigatorModelContextTesting: boolean;\n installedDocumentModelContext: boolean;\n}\n\nconst installState: InstallState = {\n installed: false,\n previousNavigatorModelContextDescriptor: undefined,\n previousNavigatorModelContextTestingDescriptor: undefined,\n previousDocumentModelContextDescriptor: undefined,\n installedNavigatorModelContext: false,\n installedNavigatorModelContextTesting: false,\n installedDocumentModelContext: false,\n};\n\nexport interface WebMCPPolyfillInitOptions {\n /**\n * Controls whether the polyfill auto-initializes when loaded.\n * Set to false to prevent auto-initialization; then call initializeWebMCPPolyfill() manually.\n * @default true\n */\n autoInitialize?: boolean;\n\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 extends EventTarget {\n private tools = new Map<string, PolyfillToolDescriptor>();\n private testingShim: PolyfillTestingShim | null = null;\n private _ontoolchange: ((this: ModelContext, ev: Event) => unknown) | null = null;\n private unregisterToolDeprecationWarned = false;\n private toolsChangedQueued = false;\n\n get ontoolchange(): ((this: ModelContext, ev: Event) => unknown) | null {\n return this._ontoolchange;\n }\n\n set ontoolchange(handler: ((this: ModelContext, ev: Event) => unknown) | null) {\n this._ontoolchange = handler;\n }\n\n registerTool(tool: ToolDescriptor, options?: ModelContextRegisterToolOptions): Promise<void> {\n const signal = options?.signal;\n\n if (signal?.aborted) {\n return Promise.reject(createAbortError());\n }\n\n const normalized = normalizeToolDescriptor(tool, this.tools);\n this.tools.set(normalized.name, normalized);\n this.notifyToolsChanged();\n\n if (signal) {\n signal.addEventListener(\n 'abort',\n () => {\n if (this.tools.delete(normalized.name)) {\n this.notifyToolsChanged();\n }\n },\n { once: true }\n );\n }\n\n return Promise.resolve();\n }\n\n unregisterTool(nameOrTool: string | ModelContextToolReference): void {\n this.warnUnregisterToolDeprecationOnce();\n\n const name = getToolNameForUnregister(nameOrTool);\n const removed = this.tools.delete(name);\n if (removed) {\n this.notifyToolsChanged();\n }\n }\n\n getTools(): Promise<ModelContextToolInfo[]> {\n return Promise.resolve(this.getRegisteredToolInfos());\n }\n\n executeTool(\n tool: ModelContextToolInfo,\n inputArgsJson: string,\n options?: ModelContextTestingExecuteToolOptions\n ): Promise<string | null> {\n return this.executeToolByName(tool.name, inputArgsJson, options, false);\n }\n\n getTestingShim(): PolyfillTestingShim {\n if (!this.testingShim) {\n this.testingShim = new PolyfillTestingShim(this);\n }\n return this.testingShim;\n }\n\n /** @internal Used by PolyfillTestingShim */\n getToolInfos(): ModelContextTestingToolInfo[] {\n return [...this.tools.values()].map((tool) => {\n let inputSchema: string;\n try {\n inputSchema = JSON.stringify(tool.inputSchema ?? { type: 'object' });\n } catch {\n inputSchema = '{\"type\":\"object\"}';\n }\n return { name: tool.name, description: tool.description, inputSchema };\n });\n }\n\n /** @internal Used by getTools() */\n getRegisteredToolInfos(): ModelContextToolInfo[] {\n return this.getToolInfos().map((toolInfo) => {\n const tool = this.tools.get(toolInfo.name);\n return {\n ...toolInfo,\n title: tool?.title ?? '',\n origin: globalThis.location?.origin ?? '',\n window: globalThis.window,\n };\n });\n }\n\n /** @internal Used by PolyfillTestingShim */\n async executeToolForTesting(\n toolName: string,\n inputArgsJson: string,\n options?: ModelContextTestingExecuteToolOptions\n ): Promise<string | null> {\n return this.executeToolByName(toolName, inputArgsJson, options, true);\n }\n\n private async executeToolByName(\n toolName: string,\n inputArgsJson: string,\n options: ModelContextTestingExecuteToolOptions | undefined,\n normalizeResult: boolean\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 rawResult = await withAbortSignal(Promise.resolve(execution), options?.signal);\n const normalizedResult = normalizeToolResponse(rawResult);\n const outputValidationError = validateOutputForTool(normalizedResult, tool);\n if (outputValidationError) {\n throw new Error(outputValidationError);\n }\n if (normalizeResult) {\n return toSerializedTestingResult(normalizedResult);\n }\n const serialized = JSON.stringify(rawResult);\n return serialized === undefined ? null : serialized;\n } catch (error) {\n const detail =\n error instanceof Error\n ? `${TOOL_INVOCATION_FAILED_MESSAGE}: ${error.message}`\n : TOOL_INVOCATION_FAILED_MESSAGE;\n throw createUnknownError(detail);\n } finally {\n contextActive = false;\n }\n }\n\n private notifyToolsChanged(): void {\n if (this.toolsChangedQueued) {\n return;\n }\n this.toolsChangedQueued = true;\n\n queueMicrotask(() => {\n this.toolsChangedQueued = false;\n const event = new Event('toolchange');\n try {\n this._ontoolchange?.call(this as unknown as ModelContext, event);\n } catch (error) {\n console.warn('[WebMCPPolyfill] navigator.modelContext.ontoolchange handler threw:', error);\n }\n this.dispatchEvent(event);\n this.testingShim?.dispatchToolChange();\n });\n }\n\n private warnUnregisterToolDeprecationOnce(): void {\n if (this.unregisterToolDeprecationWarned) {\n return;\n }\n\n this.unregisterToolDeprecationWarned = true;\n console.warn(\n '[WebMCPPolyfill] navigator.modelContext.unregisterTool() is deprecated. The April 23, 2026 WebMCP draft removed it in favor of registerTool(tool, { signal }) — pass an AbortSignal and abort it to unregister.'\n );\n }\n}\n\n/**\n * EventTarget-based testing shim matching the native Chromium ModelContextTesting surface.\n *\n * Fires `toolchange` events and supports the `ontoolchange` handler property,\n * matching the native Chromium 148 API. The deprecated `registerToolsChangedCallback`\n * is kept as a compat layer that wraps `addEventListener`.\n */\nclass PolyfillTestingShim extends EventTarget implements ModelContextTesting {\n private context: StrictWebMCPContext;\n private _ontoolchange: ((this: ModelContextTesting, ev: Event) => unknown) | null = null;\n\n constructor(context: StrictWebMCPContext) {\n super();\n this.context = context;\n }\n\n listTools(): ModelContextTestingToolInfo[] {\n return this.context.getToolInfos();\n }\n\n executeTool(\n toolName: string,\n inputArgsJson: string,\n options?: ModelContextTestingExecuteToolOptions\n ): Promise<string | null> {\n return this.context.executeToolForTesting(toolName, inputArgsJson, options);\n }\n\n getCrossDocumentScriptToolResult(): Promise<string> {\n return Promise.resolve('[]');\n }\n\n get ontoolchange(): ((this: ModelContextTesting, ev: Event) => unknown) | null {\n return this._ontoolchange;\n }\n\n set ontoolchange(handler: ((this: ModelContextTesting, ev: Event) => unknown) | null) {\n this._ontoolchange = handler;\n }\n\n /**\n * @deprecated Use `addEventListener('toolchange', callback)` instead.\n * Kept for backward compatibility with older polyfill consumers.\n */\n registerToolsChangedCallback(callback: () => void): 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.addEventListener('toolchange', callback);\n }\n\n /** @internal Called by StrictWebMCPContext when tools change. */\n dispatchToolChange(): void {\n const event = new Event('toolchange');\n try {\n this._ontoolchange?.call(this, event);\n } catch (error) {\n console.warn('[WebMCPPolyfill] ontoolchange handler threw:', error);\n }\n this.dispatchEvent(event);\n // Deprecated compat: fire old event name so existing listeners keep working\n this.dispatchEvent(new Event('toolschanged'));\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 createInvalidStateError(message: string): DOMException | Error {\n try {\n return new DOMException(message, 'InvalidStateError');\n } catch {\n const error = new Error(message);\n error.name = 'InvalidStateError';\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\nfunction getToolNameForUnregister(nameOrTool: string | ModelContextToolReference): string {\n if (typeof nameOrTool === 'string') {\n return nameOrTool;\n }\n\n if (isPlainObject(nameOrTool) && typeof nameOrTool.name === 'string') {\n return nameOrTool.name;\n }\n\n throw new TypeError(\n \"Failed to execute 'unregisterTool' on 'ModelContext': parameter 1 must be a string or an object with a string name.\"\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 createInvalidStateError('Tool \"name\" must be a non-empty string');\n }\n\n if (!VALID_TOOL_NAME_RE.test(tool.name) || Array.from(tool.name).length > 128) {\n throw createInvalidStateError(\n 'Tool \"name\" must be 1–128 characters and contain only ASCII alphanumeric, underscore, hyphen, or period'\n );\n }\n\n if (typeof tool.description !== 'string' || tool.description.length === 0) {\n throw createInvalidStateError('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 const annotations = tool.annotations;\n const normalizedAnnotations = annotations\n ? {\n ...annotations,\n ...(annotations.readOnlyHint === 'true'\n ? { readOnlyHint: true }\n : annotations.readOnlyHint === 'false'\n ? { readOnlyHint: false }\n : {}),\n ...(annotations.destructiveHint === 'true'\n ? { destructiveHint: true }\n : annotations.destructiveHint === 'false'\n ? { destructiveHint: false }\n : {}),\n ...(annotations.idempotentHint === 'true'\n ? { idempotentHint: true }\n : annotations.idempotentHint === 'false'\n ? { idempotentHint: false }\n : {}),\n ...(annotations.openWorldHint === 'true'\n ? { openWorldHint: true }\n : annotations.openWorldHint === 'false'\n ? { openWorldHint: false }\n : {}),\n }\n : undefined;\n\n return {\n ...tool,\n ...(normalizedAnnotations ? { annotations: normalizedAnnotations } : {}),\n inputSchema: normalizedInputSchema.inputSchema,\n [STANDARD_VALIDATOR_SYMBOL]: normalizedInputSchema.standardValidator,\n };\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 (error) {\n const detail = error instanceof Error ? `: ${error.message}` : '';\n console.error('[WebMCPPolyfill] Standard Schema validation threw unexpectedly:', error);\n return `Input validation error: schema validation failed${detail}`;\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 validateOutputForTool(result: ToolResponse, tool: PolyfillToolDescriptor): string | null {\n if (!tool.outputSchema || result.isError) {\n return null;\n }\n\n if (result.structuredContent === undefined) {\n return `Output validation error: Tool ${tool.name} has an output schema but no structured content was provided`;\n }\n\n const issue = validateValueWithSchema(result.structuredContent, tool.outputSchema);\n return issue ? `Output validation error: ${issue.message}` : null;\n}\n\nfunction isCallToolResult(value: unknown): value is ToolResponse {\n return isPlainObject(value) && Array.isArray(value.content);\n}\n\nfunction serializeTextContent(value: unknown): string {\n if (typeof value === 'string') {\n return value;\n }\n\n try {\n const candidate = JSON.stringify(value);\n return candidate ?? String(value);\n } catch {\n return String(value);\n }\n}\n\nfunction normalizeToolResponse(value: unknown): ToolResponse {\n if (isCallToolResult(value)) {\n return value;\n }\n\n const structuredContent = toJsonValue(value);\n\n return {\n content: [\n {\n type: 'text',\n text: serializeTextContent(value),\n },\n ],\n ...(structuredContent !== undefined ? { structuredContent } : {}),\n isError: false,\n };\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 getDocument(): Document | null {\n if (typeof document !== 'undefined') {\n return document;\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\nfunction defineDocumentModelContextProperty(target: Document, value: ModelContext): void {\n Object.defineProperty(target, 'modelContext', {\n configurable: true,\n enumerable: true,\n writable: false,\n value,\n });\n}\n\nlet navigatorModelContextDeprecationWarned = false;\n\n// Per webmachinelearning/webmcp#173 / PR #184, the modelContext getter moved\n// from Navigator to Document. We install on document.modelContext as the\n// primary surface and expose navigator.modelContext as a deprecated alias that\n// returns the same instance and logs a one-time console warning on first\n// access. This mirrors the deprecation behavior shipped in Chrome 150.\nfunction defineDeprecatedNavigatorModelContext(target: Navigator, value: ModelContext): void {\n Object.defineProperty(target, 'modelContext', {\n configurable: true,\n enumerable: true,\n get() {\n if (!navigatorModelContextDeprecationWarned) {\n navigatorModelContextDeprecationWarned = true;\n console.warn(\n '[WebMCPPolyfill] navigator.modelContext is deprecated. The May 27, 2026 WebMCP draft moved the modelContext getter from Navigator to Document — use document.modelContext instead. See https://github.com/webmachinelearning/webmcp/pull/184.'\n );\n }\n return value;\n },\n });\n}\n\nexport function initializeWebMCPPolyfill(options?: WebMCPPolyfillInitOptions): void {\n const nav = getNavigator();\n const doc = getDocument();\n if (!nav && !doc) {\n return;\n }\n\n const documentModelContext = doc?.modelContext;\n const hasDocumentModelContext = Boolean(documentModelContext);\n\n if (hasDocumentModelContext) {\n return;\n }\n\n const navigatorModelContext = nav?.modelContext;\n const hasNavigatorModelContext = Boolean(navigatorModelContext);\n\n if (installState.installed) {\n cleanupWebMCPPolyfill();\n }\n\n if (doc && navigatorModelContext) {\n installState.previousDocumentModelContextDescriptor = Object.getOwnPropertyDescriptor(\n doc,\n 'modelContext'\n );\n defineDocumentModelContextProperty(doc, navigatorModelContext);\n installState.installedDocumentModelContext = true;\n installState.installed = true;\n return;\n }\n\n if (hasNavigatorModelContext) {\n return;\n }\n\n const context = new StrictWebMCPContext();\n const modelContext = context as unknown as PolyfillModelContext;\n modelContext[POLYFILL_MARKER_PROPERTY] = true;\n\n if (doc) {\n installState.previousDocumentModelContextDescriptor = Object.getOwnPropertyDescriptor(\n doc,\n 'modelContext'\n );\n defineDocumentModelContextProperty(doc, modelContext as ModelContext);\n installState.installedDocumentModelContext = true;\n }\n\n if (nav) {\n installState.previousNavigatorModelContextDescriptor = Object.getOwnPropertyDescriptor(\n nav,\n 'modelContext'\n );\n installState.previousNavigatorModelContextTestingDescriptor = Object.getOwnPropertyDescriptor(\n nav,\n 'modelContextTesting'\n );\n\n // Reset the one-shot warning flag so a fresh install warns again on first access.\n navigatorModelContextDeprecationWarned = false;\n defineDeprecatedNavigatorModelContext(nav, modelContext as ModelContext);\n installState.installedNavigatorModelContext = true;\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 installState.installedNavigatorModelContextTesting = true;\n }\n }\n\n installState.installed = true;\n}\n\nexport function cleanupWebMCPPolyfill(): void {\n if (!installState.installed) {\n return;\n }\n\n const restore = (\n target: Navigator | Document,\n key: string,\n previousDescriptor: PropertyDescriptor | undefined\n ) => {\n if (previousDescriptor) {\n Object.defineProperty(target, key, previousDescriptor);\n return;\n }\n\n delete (target as unknown as Record<string, unknown>)[key];\n };\n\n const nav = getNavigator();\n const doc = getDocument();\n\n if (doc && installState.installedDocumentModelContext) {\n restore(doc, 'modelContext', installState.previousDocumentModelContextDescriptor);\n }\n if (nav && installState.installedNavigatorModelContext) {\n restore(nav, 'modelContext', installState.previousNavigatorModelContextDescriptor);\n }\n if (nav && installState.installedNavigatorModelContextTesting) {\n restore(\n nav,\n 'modelContextTesting',\n installState.previousNavigatorModelContextTestingDescriptor\n );\n }\n\n installState.installed = false;\n installState.previousDocumentModelContextDescriptor = undefined;\n installState.previousNavigatorModelContextDescriptor = undefined;\n installState.previousNavigatorModelContextTestingDescriptor = undefined;\n installState.installedDocumentModelContext = false;\n installState.installedNavigatorModelContext = false;\n installState.installedNavigatorModelContextTesting = false;\n navigatorModelContextDeprecationWarned = false;\n}\n\nexport { initializeWebMCPPolyfill as initializeWebModelContextPolyfill };\n\ndeclare global {\n interface Window {\n __webMCPPolyfillOptions?: WebMCPPolyfillInitOptions;\n }\n}\n\nif (typeof window !== 'undefined' && typeof document !== 'undefined') {\n const options = window.__webMCPPolyfillOptions;\n const shouldAutoInitialize = options?.autoInitialize !== false;\n\n if (shouldAutoInitialize) {\n try {\n initializeWebMCPPolyfill(options);\n } catch (error) {\n console.error('[WebMCPPolyfill] Auto-initialization failed:', error);\n }\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { InputSchema, JsonSchemaForInference, JsonValue } from "@mcp-b/webmcp-types";
2
+ import { StandardJSONSchemaV1, StandardJSONSchemaV1 as StandardJSONSchemaV1$1, StandardSchemaV1 } from "@standard-schema/spec";
3
+
4
+ //#region src/schema.d.ts
5
+ type StandardInputValidatorSchema = StandardSchemaV1<Record<string, unknown>, Record<string, unknown>>;
6
+ type StandardInputJsonSchema = StandardJSONSchemaV1$1<Record<string, unknown>, Record<string, unknown>>;
7
+ type ToolInputSchema = InputSchema | StandardInputValidatorSchema | StandardInputJsonSchema;
8
+ type ToolOutputSchema = InputSchema | StandardInputJsonSchema;
9
+ type StandardValidationResult = Awaited<ReturnType<StandardInputValidatorSchema['~standard']['validate']>>;
10
+ type StandardValidationIssue = NonNullable<StandardValidationResult['issues']>[number];
11
+ interface NormalizedInputSchema {
12
+ inputSchema: InputSchema;
13
+ standardValidator: StandardInputValidatorSchema;
14
+ }
15
+ declare function isPlainObject(value: unknown): value is Record<string, unknown>;
16
+ declare function toJsonValue(value: unknown): JsonValue | undefined;
17
+ declare function normalizeInputSchema(inputSchema: ToolInputSchema | undefined): NormalizedInputSchema;
18
+ declare function validateValueWithSchema(value: unknown, schema: InputSchema | JsonSchemaForInference): StandardValidationIssue | null;
19
+ //#endregion
20
+ export { NormalizedInputSchema, StandardInputJsonSchema, StandardInputValidatorSchema, type StandardJSONSchemaV1, StandardValidationIssue, StandardValidationResult, ToolInputSchema, ToolOutputSchema, isPlainObject, normalizeInputSchema, toJsonValue, validateValueWithSchema };
21
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","names":[],"sources":["../src/schema.ts"],"mappings":";;;;KAQY,4BAAA,GAA+B,gBAAA,CACzC,MAAA,mBACA,MAAA;AAAA,KAEU,uBAAA,GAA0B,sBAAA,CACpC,MAAA,mBACA,MAAA;AAAA,KAEU,eAAA,GAAkB,WAAA,GAAc,4BAAA,GAA+B,uBAAA;AAAA,KAC/D,gBAAA,GAAmB,WAAA,GAAc,uBAAA;AAAA,KAEjC,wBAAA,GAA2B,OAAA,CACrC,UAAA,CAAW,4BAAA;AAAA,KAED,uBAAA,GAA0B,WAAA,CAAY,wBAAA;AAAA,UAEjC,qBAAA;EACf,WAAA,EAAa,WAAA;EACb,iBAAA,EAAmB,4BAAA;AAAA;AAAA,iBAGL,aAAA,CAAc,KAAA,YAAiB,KAAA,IAAS,MAAA;AAAA,iBA6CxC,WAAA,CAAY,KAAA,YAAiB,SAAA;AAAA,iBA4E7B,oBAAA,CACd,WAAA,EAAa,eAAA,eACZ,qBAAA;AAAA,iBA2Ia,uBAAA,CACd,KAAA,WACA,MAAA,EAAQ,WAAA,GAAc,sBAAA,GACrB,uBAAA"}
package/dist/schema.js ADDED
@@ -0,0 +1,167 @@
1
+ import { Validator } from "@cfworker/json-schema";
2
+
3
+ //#region src/schema.ts
4
+ const DEFAULT_INPUT_SCHEMA = {
5
+ type: "object",
6
+ properties: {}
7
+ };
8
+ const STANDARD_JSON_SCHEMA_TARGETS = ["draft-2020-12", "draft-07"];
9
+ function isPlainObject(value) {
10
+ return typeof value === "object" && value !== null && !Array.isArray(value);
11
+ }
12
+ function isJsonObjectRecord(value) {
13
+ if (!isPlainObject(value)) return false;
14
+ const prototype = Object.getPrototypeOf(value);
15
+ return prototype === Object.prototype || prototype === null;
16
+ }
17
+ function isJsonValue(value, seen = /* @__PURE__ */ new WeakSet()) {
18
+ if (value === null || typeof value === "string" || typeof value === "boolean") return true;
19
+ if (typeof value === "number") return Number.isFinite(value);
20
+ if (typeof value !== "object") return false;
21
+ if (seen.has(value)) return false;
22
+ seen.add(value);
23
+ try {
24
+ return (Array.isArray(value) ? value : isJsonObjectRecord(value) ? Object.values(value) : null)?.every((entry) => isJsonValue(entry, seen)) ?? false;
25
+ } catch {
26
+ return false;
27
+ } finally {
28
+ seen.delete(value);
29
+ }
30
+ }
31
+ function toJsonValue(value) {
32
+ return isJsonValue(value) ? value : void 0;
33
+ }
34
+ function getStandardProps(value) {
35
+ if (!isPlainObject(value)) return null;
36
+ const standard = value["~standard"];
37
+ if (!isPlainObject(standard)) return null;
38
+ return standard;
39
+ }
40
+ function isStandardInputValidatorSchema(value) {
41
+ const standard = getStandardProps(value);
42
+ return Boolean(standard && standard.version === 1 && typeof standard.validate === "function");
43
+ }
44
+ function isStandardInputJsonSchema(value) {
45
+ const standard = getStandardProps(value);
46
+ if (!standard || standard.version !== 1 || !isPlainObject(standard.jsonSchema)) return false;
47
+ return typeof standard.jsonSchema.input === "function";
48
+ }
49
+ function createStandardValidatorFromJsonSchema(schema) {
50
+ return { "~standard": {
51
+ version: 1,
52
+ vendor: "@mcp-b/webmcp-polyfill-json-schema",
53
+ validate(value) {
54
+ if (!isPlainObject(value)) return { issues: [{ message: "expected object arguments" }] };
55
+ const issue = validateValueWithSchema(value, schema);
56
+ if (issue) return { issues: [issue] };
57
+ return { value };
58
+ }
59
+ } };
60
+ }
61
+ function convertStandardInputSchema(schema) {
62
+ const failures = [];
63
+ for (const target of STANDARD_JSON_SCHEMA_TARGETS) try {
64
+ const converted = schema["~standard"].jsonSchema.input({ target });
65
+ validateInputSchema(converted);
66
+ return converted;
67
+ } catch (error) {
68
+ failures.push({
69
+ target,
70
+ error
71
+ });
72
+ }
73
+ console.warn("[WebMCPPolyfill] Standard JSON Schema conversion failed:", failures);
74
+ throw new Error("Failed to convert Standard JSON Schema inputSchema to a JSON Schema object");
75
+ }
76
+ function normalizeInputSchema(inputSchema) {
77
+ if (inputSchema === void 0) {
78
+ const normalized = DEFAULT_INPUT_SCHEMA;
79
+ return {
80
+ inputSchema: normalized,
81
+ standardValidator: createStandardValidatorFromJsonSchema(normalized)
82
+ };
83
+ }
84
+ if (isStandardInputJsonSchema(inputSchema)) {
85
+ const converted = convertStandardInputSchema(inputSchema);
86
+ return {
87
+ inputSchema: converted,
88
+ standardValidator: createStandardValidatorFromJsonSchema(converted)
89
+ };
90
+ }
91
+ if (isStandardInputValidatorSchema(inputSchema)) return {
92
+ inputSchema: DEFAULT_INPUT_SCHEMA,
93
+ standardValidator: inputSchema
94
+ };
95
+ validateInputSchema(inputSchema);
96
+ if (Object.keys(inputSchema).length === 0) return {
97
+ inputSchema: DEFAULT_INPUT_SCHEMA,
98
+ standardValidator: createStandardValidatorFromJsonSchema(DEFAULT_INPUT_SCHEMA)
99
+ };
100
+ const normalizedSchema = inputSchema.type === void 0 ? {
101
+ type: "object",
102
+ ...inputSchema
103
+ } : inputSchema;
104
+ return {
105
+ inputSchema: normalizedSchema,
106
+ standardValidator: createStandardValidatorFromJsonSchema(normalizedSchema)
107
+ };
108
+ }
109
+ function validateInputSchema(schema) {
110
+ if (!isPlainObject(schema)) throw new Error("inputSchema must be a JSON Schema object");
111
+ validateJsonSchemaNode(schema, "$");
112
+ }
113
+ function validateJsonSchemaNode(node, path) {
114
+ const typeValue = node.type;
115
+ 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[]`);
116
+ const requiredValue = node.required;
117
+ 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`);
118
+ const propertiesValue = node.properties;
119
+ if (propertiesValue !== void 0) {
120
+ if (!isPlainObject(propertiesValue)) throw new Error(`Invalid JSON Schema at ${path}: "properties" must be an object`);
121
+ for (const [key, value] of Object.entries(propertiesValue)) {
122
+ if (!isPlainObject(value)) throw new Error(`Invalid JSON Schema at ${path}.properties.${key}: expected object schema`);
123
+ validateJsonSchemaNode(value, `${path}.properties.${key}`);
124
+ }
125
+ }
126
+ const itemsValue = node.items;
127
+ if (itemsValue !== void 0) if (Array.isArray(itemsValue)) for (const [index, value] of itemsValue.entries()) {
128
+ if (!isPlainObject(value)) throw new Error(`Invalid JSON Schema at ${path}.items[${index}]: expected object schema`);
129
+ validateJsonSchemaNode(value, `${path}.items[${index}]`);
130
+ }
131
+ else if (isPlainObject(itemsValue)) validateJsonSchemaNode(itemsValue, `${path}.items`);
132
+ else throw new Error(`Invalid JSON Schema at ${path}: "items" must be an object or object[]`);
133
+ for (const keyword of [
134
+ "allOf",
135
+ "anyOf",
136
+ "oneOf"
137
+ ]) {
138
+ const value = node[keyword];
139
+ if (value === void 0) continue;
140
+ if (!Array.isArray(value)) throw new Error(`Invalid JSON Schema at ${path}: "${keyword}" must be an array`);
141
+ for (const [index, entry] of value.entries()) {
142
+ if (!isPlainObject(entry)) throw new Error(`Invalid JSON Schema at ${path}.${keyword}[${index}]: expected object schema`);
143
+ validateJsonSchemaNode(entry, `${path}.${keyword}[${index}]`);
144
+ }
145
+ }
146
+ const notValue = node.not;
147
+ if (notValue !== void 0) {
148
+ if (!isPlainObject(notValue)) throw new Error(`Invalid JSON Schema at ${path}: "not" must be an object schema`);
149
+ validateJsonSchemaNode(notValue, `${path}.not`);
150
+ }
151
+ try {
152
+ JSON.stringify(node);
153
+ } catch {
154
+ throw new Error(`Invalid JSON Schema at ${path}: schema must be JSON-serializable`);
155
+ }
156
+ }
157
+ function validateValueWithSchema(value, schema) {
158
+ const result = new Validator(schema, "2020-12", true).validate(value);
159
+ if (result.valid) return null;
160
+ const error = result.errors[result.errors.length - 1];
161
+ if (!error) return { message: "Input validation failed" };
162
+ return { message: error.error };
163
+ }
164
+
165
+ //#endregion
166
+ export { isPlainObject, normalizeInputSchema, toJsonValue, validateValueWithSchema };
167
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { type Schema, Validator } from '@cfworker/json-schema';\nimport type { InputSchema, JsonSchemaForInference, JsonValue } from '@mcp-b/webmcp-types';\nimport type { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec';\nexport type { StandardJSONSchemaV1 } from '@standard-schema/spec';\n\nconst DEFAULT_INPUT_SCHEMA: InputSchema = { type: 'object', properties: {} };\nconst STANDARD_JSON_SCHEMA_TARGETS = ['draft-2020-12', 'draft-07'] as const;\n\nexport type StandardInputValidatorSchema = StandardSchemaV1<\n Record<string, unknown>,\n Record<string, unknown>\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\nexport type StandardValidationResult = Awaited<\n ReturnType<StandardInputValidatorSchema['~standard']['validate']>\n>;\nexport type StandardValidationIssue = NonNullable<StandardValidationResult['issues']>[number];\n\nexport interface NormalizedInputSchema {\n inputSchema: InputSchema;\n standardValidator: StandardInputValidatorSchema;\n}\n\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isJsonObjectRecord(value: unknown): value is Record<string, unknown> {\n if (!isPlainObject(value)) {\n return false;\n }\n\n const prototype = Object.getPrototypeOf(value);\n return prototype === Object.prototype || prototype === null;\n}\n\nfunction isJsonValue(value: unknown, seen = new WeakSet<object>()): value is JsonValue {\n if (value === null || typeof value === 'string' || typeof value === 'boolean') {\n return true;\n }\n\n if (typeof value === 'number') {\n return Number.isFinite(value);\n }\n\n if (typeof value !== 'object') {\n return false;\n }\n\n if (seen.has(value)) {\n return false;\n }\n\n seen.add(value);\n try {\n const entries = Array.isArray(value)\n ? value\n : isJsonObjectRecord(value)\n ? Object.values(value)\n : null;\n return entries?.every((entry) => isJsonValue(entry, seen)) ?? false;\n } catch {\n return false;\n } finally {\n seen.delete(value);\n }\n}\n\nexport function toJsonValue(value: unknown): JsonValue | undefined {\n return isJsonValue(value) ? value : undefined;\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 = validateValueWithSchema(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 const failures: Array<{ error: unknown; target: (typeof STANDARD_JSON_SCHEMA_TARGETS)[number] }> =\n [];\n\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 (error) {\n failures.push({ target, error });\n }\n }\n\n console.warn('[WebMCPPolyfill] Standard JSON Schema conversion failed:', failures);\n throw new Error('Failed to convert Standard JSON Schema inputSchema to a JSON Schema object');\n}\n\nexport function normalizeInputSchema(\n inputSchema: ToolInputSchema | undefined\n): 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\n // Empty {} is valid JSON Schema but lacks type:\"object\" required by MCP.\n if (Object.keys(inputSchema as Record<string, unknown>).length === 0) {\n return {\n inputSchema: DEFAULT_INPUT_SCHEMA,\n standardValidator: createStandardValidatorFromJsonSchema(DEFAULT_INPUT_SCHEMA),\n };\n }\n\n const normalizedSchema =\n inputSchema.type === undefined\n ? ({ type: 'object', ...inputSchema } as InputSchema)\n : inputSchema;\n return {\n inputSchema: normalizedSchema,\n standardValidator: createStandardValidatorFromJsonSchema(normalizedSchema),\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\nexport function validateValueWithSchema(\n value: unknown,\n schema: InputSchema | JsonSchemaForInference\n): StandardValidationIssue | null {\n const validator = new Validator(schema as Schema, '2020-12', true);\n const result = validator.validate(value);\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"],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mcp-b/webmcp-polyfill",
3
- "version": "2.3.2",
4
- "description": "Strict WebMCP core runtime polyfill for navigator.modelContext",
3
+ "version": "3.0.0-beta.20260702171253",
4
+ "description": "Strict WebMCP core runtime polyfill for document.modelContext (with deprecated navigator.modelContext alias)",
5
5
  "keywords": [
6
6
  "browser",
7
7
  "model-context",
@@ -9,7 +9,7 @@
9
9
  "polyfill",
10
10
  "webmcp"
11
11
  ],
12
- "homepage": "https://docs.mcp-b.ai/packages/webmcp-polyfill",
12
+ "homepage": "https://docs.mcp-b.ai/packages/webmcp-polyfill/reference",
13
13
  "bugs": {
14
14
  "url": "https://github.com/WebMCP-org/npm-packages/issues"
15
15
  },
@@ -35,6 +35,11 @@
35
35
  "import": "./dist/index.js",
36
36
  "default": "./dist/index.js"
37
37
  },
38
+ "./schema": {
39
+ "types": "./dist/schema.d.ts",
40
+ "import": "./dist/schema.js",
41
+ "default": "./dist/schema.js"
42
+ },
38
43
  "./iife": {
39
44
  "script": "./dist/index.iife.js",
40
45
  "default": "./dist/index.iife.js"
@@ -47,14 +52,14 @@
47
52
  "dependencies": {
48
53
  "@cfworker/json-schema": "^4.1.1",
49
54
  "@standard-schema/spec": "^1.1.0",
50
- "@mcp-b/webmcp-types": "2.3.2"
55
+ "@mcp-b/webmcp-types": "3.0.0-beta.20260702171253"
51
56
  },
52
57
  "devDependencies": {
53
- "@vitest/coverage-v8": "^4.1.0",
58
+ "@vitest/coverage-v8": "^4.1.7",
54
59
  "happy-dom": "^20.8.9",
55
- "playwright": "^1.58.0",
60
+ "playwright": "^1.60.0",
56
61
  "typescript": "^5.8.3",
57
- "vite-plus": "latest",
62
+ "vite-plus": "^0.1.22",
58
63
  "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
59
64
  },
60
65
  "engines": {
@@ -71,6 +76,7 @@
71
76
  "test": "vp test run",
72
77
  "test:browser": "vp test run --config vitest.browser.config.ts --browser.headless",
73
78
  "test:browser:ui": "vp test --config vitest.browser.config.ts --browser",
79
+ "test:conformance": "vp test run --config vitest.conformance.config.ts --browser.headless",
74
80
  "typecheck": "pnpm --filter @mcp-b/webmcp-types build && tsc --noEmit && vp test run --typecheck --silent"
75
81
  }
76
82
  }