@webmcp-auto-ui/core 0.5.0 → 2.5.4

package/dist/webmcp-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"webmcp-helpers.js","sourceRoot":"","sources":["../src/webmcp-helpers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wCAAwC;AACxC,sEAAsE;AACtE,0CAA0C;AAC1C,8EAA8E;AAE9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAgBD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;AAE5C,SAAS,KAAK;IAIZ,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAClD,OAAQ,SAAgD,CAAC,YAAwC,IAAI,IAAI,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAe;IAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,MAAM,QAAQ,GAAG,UAAU,KAAK,CAAC,EAAE,EAAE,CAAC;IACtC,IAAI,CAAC;QAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACvE,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,WAAW,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,WAAW,gBAAgB,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QACvJ,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;QAChC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,IAAI,CAAC;QAAC,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAAE,eAAe,CAAC,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"webmcp-helpers.js","sourceRoot":"","sources":["../src/webmcp-helpers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wCAAwC;AACxC,8CAA8C;AAC9C,0CAA0C;AAC1C,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,kFAAkF;AAClF,8EAA8E;AAI9E,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/webmcp-server.d.ts

@@ -0,0 +1,54 @@
+export interface WebMcpServerOptions {
+    description: string;
+}
+export interface WebMcpToolDef {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: (params: Record<string, unknown>) => Promise<unknown>;
+}
+/** A vanilla renderer: receives a container + data, optionally returns a cleanup function. */
+export type WidgetRenderer = ((container: HTMLElement, data: Record<string, unknown>) => void | (() => void)) | unknown;
+export interface WidgetEntry {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    recipe: string;
+    renderer: WidgetRenderer;
+    group?: string;
+    /** True when the renderer is a plain function (not a framework component). */
+    vanilla: boolean;
+}
+export interface WebMcpServer {
+    readonly name: string;
+    readonly description: string;
+    registerWidget(recipeMarkdown: string, renderer: WidgetRenderer): void;
+    addTool(tool: WebMcpToolDef): void;
+    layer(): {
+        protocol: 'webmcp';
+        serverName: string;
+        description: string;
+        tools: WebMcpToolDef[];
+    };
+    getWidget(name: string): WidgetEntry | undefined;
+    listWidgets(): WidgetEntry[];
+}
+export interface ParsedFrontmatter {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+/**
+ * Parse a markdown file with YAML frontmatter (--- delimited).
+ * Supports: scalars, nested objects (indentation), arrays (- item), inline values.
+ * No external YAML dependency.
+ */
+export declare function parseFrontmatter(markdown: string): ParsedFrontmatter;
+/**
+ * Mount a widget into a DOM container by searching registered servers.
+ * If the renderer is a function (vanilla renderer), it is called directly.
+ * Returns an optional cleanup function.
+ * Falls back to a text placeholder if no server provides the widget.
+ */
+export declare function mountWidget(container: HTMLElement, type: string, data: Record<string, unknown>, servers: WebMcpServer[]): (() => void) | void;
+export declare function createWebMcpServer(name: string, options: WebMcpServerOptions): WebMcpServer;
+//# sourceMappingURL=webmcp-server.d.ts.map

package/dist/webmcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp-server.d.ts","sourceRoot":"","sources":["../src/webmcp-server.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,8FAA8F;AAC9F,MAAM,MAAM,cAAc,GACtB,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAChF,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACvE,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAEnC,KAAK,IAAI;QACP,QAAQ,EAAE,QAAQ,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,EAAE,CAAC;KACxB,CAAC;IAEF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACjD,WAAW,IAAI,WAAW,EAAE,CAAC;CAC9B;AAMD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAgBpE;AAsMD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,YAAY,EAAE,GACtB,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAQrB;AA6CD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAwLd"}

package/dist/webmcp-server.js

@@ -0,0 +1,425 @@
+// ---------------------------------------------------------------------------
+// @webmcp-auto-ui/core — WebMCP Server
+// A WebMCP server exposes tools and widget recipes for local UI rendering.
+// Symmetric to MCP (remote data) — WebMCP handles display/interaction.
+// ---------------------------------------------------------------------------
+import { validateJsonSchema } from './validate.js';
+/**
+ * Parse a markdown file with YAML frontmatter (--- delimited).
+ * Supports: scalars, nested objects (indentation), arrays (- item), inline values.
+ * No external YAML dependency.
+ */
+export function parseFrontmatter(markdown) {
+    const trimmed = markdown.trimStart();
+    if (!trimmed.startsWith('---\n') && !trimmed.startsWith('---\r\n')) {
+        return { frontmatter: {}, body: markdown };
+    }
+    const endIdx = trimmed.indexOf('\n---', 3);
+    if (endIdx === -1) {
+        return { frontmatter: {}, body: markdown };
+    }
+    const yamlBlock = trimmed.slice(4, endIdx); // skip opening "---\n"
+    const body = trimmed.slice(endIdx + 4).replace(/^\r?\n/, ''); // skip closing "---\n" or "---\r\n"
+    const frontmatter = parseYaml(yamlBlock);
+    return { frontmatter, body };
+}
+function tokenize(yaml) {
+    return yaml.split('\n').map(raw => {
+        const match = raw.match(/^(\s*)/);
+        const indent = match ? match[1].length : 0;
+        return { indent, raw, content: raw.trim() };
+    }).filter(l => l.content !== '' && !l.content.startsWith('#'));
+}
+function parseYaml(yaml) {
+    const lines = tokenize(yaml);
+    const [result] = parseObject(lines, 0, 0);
+    return result;
+}
+/**
+ * Parse an object starting at `start` with minimum indentation `minIndent`.
+ * Returns [parsed object, next line index].
+ */
+function parseObject(lines, start, minIndent) {
+    const obj = {};
+    let i = start;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.indent < minIndent)
+            break;
+        // key: value
+        const kvMatch = line.content.match(/^([^:]+?):\s*(.*)?$/);
+        if (!kvMatch) {
+            i++;
+            continue;
+        }
+        const key = kvMatch[1].trim();
+        const valuePart = (kvMatch[2] ?? '').trim();
+        if (valuePart !== '') {
+            // Inline value
+            obj[key] = parseScalar(valuePart);
+            i++;
+        }
+        else {
+            // Block value — look ahead to determine if array or nested object
+            if (i + 1 < lines.length && lines[i + 1].indent > line.indent) {
+                const childIndent = lines[i + 1].indent;
+                if (lines[i + 1].content.startsWith('- ')) {
+                    const [arr, next] = parseArray(lines, i + 1, childIndent);
+                    obj[key] = arr;
+                    i = next;
+                }
+                else {
+                    const [nested, next] = parseObject(lines, i + 1, childIndent);
+                    obj[key] = nested;
+                    i = next;
+                }
+            }
+            else {
+                obj[key] = null;
+                i++;
+            }
+        }
+    }
+    return [obj, i];
+}
+/**
+ * Parse an array starting at `start` with items at `minIndent`.
+ */
+function parseArray(lines, start, minIndent) {
+    const arr = [];
+    let i = start;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.indent < minIndent)
+            break;
+        if (!line.content.startsWith('- '))
+            break;
+        const itemContent = line.content.slice(2).trim();
+        // Check if this is a mapping item (- key: value on same line, possibly with children)
+        const kvMatch = itemContent.match(/^([^:]+?):\s*(.*)?$/);
+        if (kvMatch) {
+            // It's a mapping starting on the dash line
+            const firstKey = kvMatch[1].trim();
+            const firstVal = (kvMatch[2] ?? '').trim();
+            const itemObj = {};
+            itemObj[firstKey] = firstVal !== '' ? parseScalar(firstVal) : null;
+            // Collect remaining keys of this mapping (indented deeper than the dash)
+            i++;
+            const childIndent = line.indent + 2; // standard: items indented 2 past dash
+            while (i < lines.length && lines[i].indent >= childIndent && !lines[i].content.startsWith('- ')) {
+                const childKv = lines[i].content.match(/^([^:]+?):\s*(.*)?$/);
+                if (childKv) {
+                    const ck = childKv[1].trim();
+                    const cv = (childKv[2] ?? '').trim();
+                    if (cv !== '') {
+                        itemObj[ck] = parseScalar(cv);
+                    }
+                    else if (i + 1 < lines.length && lines[i + 1].indent > lines[i].indent) {
+                        const nextIndent = lines[i + 1].indent;
+                        if (lines[i + 1].content.startsWith('- ')) {
+                            const [subArr, next] = parseArray(lines, i + 1, nextIndent);
+                            itemObj[ck] = subArr;
+                            i = next;
+                            continue;
+                        }
+                        else {
+                            const [subObj, next] = parseObject(lines, i + 1, nextIndent);
+                            itemObj[ck] = subObj;
+                            i = next;
+                            continue;
+                        }
+                    }
+                    else {
+                        itemObj[ck] = null;
+                    }
+                }
+                i++;
+            }
+            arr.push(itemObj);
+        }
+        else {
+            // Simple scalar item
+            arr.push(parseScalar(itemContent));
+            i++;
+        }
+    }
+    return [arr, i];
+}
+/**
+ * Parse a scalar YAML value: numbers, booleans, null, inline objects/arrays, or strings.
+ */
+function parseScalar(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null' || value === '~')
+        return null;
+    // Quoted string
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    // Inline JSON-style object { key: val, ... }
+    if (value.startsWith('{') && value.endsWith('}')) {
+        return parseInlineObject(value);
+    }
+    // Inline array [a, b, c]
+    if (value.startsWith('[') && value.endsWith(']')) {
+        const inner = value.slice(1, -1).trim();
+        if (inner === '')
+            return [];
+        return inner.split(',').map(s => parseScalar(s.trim()));
+    }
+    // Number
+    const num = Number(value);
+    if (!isNaN(num) && value !== '')
+        return num;
+    return value;
+}
+/**
+ * Parse inline YAML object like { type: string, description: Some text }
+ */
+function parseInlineObject(value) {
+    const inner = value.slice(1, -1).trim();
+    const obj = {};
+    // Split on ", " but only at top level (no nested braces handling needed for our use case)
+    const parts = inner.split(/,\s*/);
+    for (const part of parts) {
+        const colonIdx = part.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const k = part.slice(0, colonIdx).trim();
+        const v = part.slice(colonIdx + 1).trim();
+        obj[k] = parseScalar(v);
+    }
+    return obj;
+}
+// ---------------------------------------------------------------------------
+// Mount helper — framework-agnostic widget mounting
+// ---------------------------------------------------------------------------
+/**
+ * Mount a widget into a DOM container by searching registered servers.
+ * If the renderer is a function (vanilla renderer), it is called directly.
+ * Returns an optional cleanup function.
+ * Falls back to a text placeholder if no server provides the widget.
+ */
+export function mountWidget(container, type, data, servers) {
+    for (const server of servers) {
+        const widget = server.getWidget(type);
+        if (widget?.renderer && widget.vanilla) {
+            return widget.renderer(container, data);
+        }
+    }
+    container.textContent = `[${type}]`;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Image URL sanitizer — strips hallucinated URLs from widget params
+// ---------------------------------------------------------------------------
+const VALID_URL_PREFIXES = ['http://', 'https://', 'data:', '/'];
+const IMAGE_KEY_PATTERN = /^(src|image|avatar|photo|thumbnail|poster|icon|logo|cover|banner|background)$/i;
+/** Recursively scan widget params and nullify image-like fields with invalid URLs. */
+function sanitizeImageUrls(obj) {
+    if (Array.isArray(obj))
+        return obj.map(sanitizeImageUrls);
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (IMAGE_KEY_PATTERN.test(key) && typeof value === 'string') {
+                if (VALID_URL_PREFIXES.some(p => value.startsWith(p))) {
+                    result[key] = value;
+                }
+                else {
+                    // Invalid image URL — strip it (likely hallucinated)
+                    // Keep the key but set to undefined so the widget can use its fallback
+                }
+            }
+            else if (typeof value === 'object' && value !== null) {
+                // Special case: avatar as object { src: '...' }
+                if (IMAGE_KEY_PATTERN.test(key) && 'src' in value) {
+                    const srcVal = value.src;
+                    if (typeof srcVal === 'string' && !VALID_URL_PREFIXES.some(p => srcVal.startsWith(p))) {
+                        // Strip the whole avatar object if src is invalid
+                        continue;
+                    }
+                }
+                result[key] = sanitizeImageUrls(value);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    return obj;
+}
+export function createWebMcpServer(name, options) {
+    const widgets = new Map();
+    const customTools = [];
+    let builtinTools = null;
+    function generateId() {
+        return 'w_' + Math.random().toString(36).slice(2, 8);
+    }
+    /** Lazily create the 3 built-in tools on first widget registration. */
+    function ensureBuiltinTools() {
+        if (builtinTools)
+            return;
+        builtinTools = [
+            {
+                name: 'search_recipes',
+                description: 'List available widget recipes with their descriptions.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Optional search term to filter recipes',
+                        },
+                    },
+                    additionalProperties: false,
+                },
+                execute: async (params) => {
+                    const query = params.query?.toLowerCase();
+                    const results = [...widgets.values()]
+                        .filter(w => !query || w.name.includes(query) || w.description.toLowerCase().includes(query))
+                        .map(w => ({ name: w.name, description: w.description, group: w.group }));
+                    return results;
+                },
+            },
+            {
+                name: 'list_recipes',
+                description: 'List all available widget recipes with their name and description.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                    additionalProperties: false,
+                },
+                execute: async () => {
+                    const results = [...widgets.values()]
+                        .map(w => ({ name: w.name, description: w.description, group: w.group }));
+                    return results;
+                },
+            },
+            {
+                name: 'get_recipe',
+                description: 'Get the full recipe for a widget: JSON schema + usage instructions.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Widget name' },
+                    },
+                    required: ['name'],
+                    additionalProperties: false,
+                },
+                execute: async (params) => {
+                    const widgetName = params.name;
+                    const entry = widgets.get(widgetName);
+                    if (!entry) {
+                        return { error: `Widget "${widgetName}" not found. Available: ${[...widgets.keys()].join(', ')}` };
+                    }
+                    return {
+                        name: entry.name,
+                        description: entry.description,
+                        schema: entry.inputSchema,
+                        recipe: entry.recipe,
+                    };
+                },
+            },
+            {
+                name: 'widget_display',
+                // Description is dynamic — rebuilt in layer()
+                description: 'Display a widget on the canvas. REQUIRED: {name: "widget_type", params: {…}}. Example: {name: "text", params: {content: "Hello world"}}',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Widget name (e.g. "text", "stat", "list", "chart", "data-table")' },
+                        params: {
+                            type: 'object',
+                            description: 'Widget parameters as JSON object (call get_recipe for the full schema). Example for text: {content: "Hello"}',
+                            additionalProperties: true,
+                        },
+                    },
+                    required: ['name'],
+                    additionalProperties: false,
+                },
+                execute: async (params) => {
+                    const widgetName = params.name;
+                    const entry = widgets.get(widgetName);
+                    if (!entry) {
+                        return {
+                            error: `Widget "${widgetName}" not found. Available: ${[...widgets.keys()].join(', ')}`,
+                        };
+                    }
+                    const rawParams = (params.params ?? {});
+                    const validation = validateJsonSchema(rawParams, entry.inputSchema);
+                    if (!validation.valid) {
+                        return {
+                            error: 'Validation failed',
+                            details: validation.errors,
+                            expected_schema: entry.inputSchema,
+                        };
+                    }
+                    // Sanitize image URLs — strip hallucinated/invalid URLs before sending to UI
+                    const widgetParams = sanitizeImageUrls(rawParams);
+                    return { widget: widgetName, data: widgetParams, id: generateId() };
+                },
+            },
+        ];
+    }
+    const server = {
+        get name() { return name; },
+        get description() { return options.description; },
+        registerWidget(recipeMarkdown, renderer) {
+            const { frontmatter, body } = parseFrontmatter(recipeMarkdown);
+            const widgetName = frontmatter.widget;
+            if (!widgetName) {
+                throw new Error('Recipe frontmatter must include a "widget" field.');
+            }
+            const schema = frontmatter.schema;
+            if (!schema) {
+                throw new Error(`Recipe "${widgetName}" frontmatter must include a "schema" field.`);
+            }
+            const entry = {
+                name: widgetName,
+                description: frontmatter.description ?? '',
+                inputSchema: schema,
+                recipe: body,
+                renderer,
+                group: frontmatter.group,
+                vanilla: typeof renderer === 'function',
+            };
+            widgets.set(widgetName, entry);
+            ensureBuiltinTools();
+        },
+        addTool(tool) {
+            customTools.push(tool);
+        },
+        layer() {
+            const allTools = [...customTools];
+            if (builtinTools) {
+                // Rebuild widget_display description with current widget names
+                const names = [...widgets.keys()];
+                const displayTool = builtinTools.find(t => t.name === 'widget_display');
+                displayTool.description = `Display a widget on the canvas. REQUIRED: {name: "widget_type", params: {…}}. Example: {name: "text", params: {content: "Hello"}}. Available widgets: ${names.join(', ')}.`;
+                allTools.push(...builtinTools);
+            }
+            return {
+                protocol: 'webmcp',
+                serverName: name,
+                description: options.description,
+                tools: allTools,
+            };
+        },
+        getWidget(widgetName) {
+            return widgets.get(widgetName);
+        },
+        listWidgets() {
+            return [...widgets.values()];
+        },
+    };
+    return server;
+}
+//# sourceMappingURL=webmcp-server.js.map

package/dist/webmcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp-server.js","sourceRoot":"","sources":["../src/webmcp-server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webmcp-auto-ui/core",
-  "version": "0.5.0",
+  "version": "2.5.4",
   "description": "W3C WebMCP polyfill + MCP Streamable HTTP client — zero dependencies, framework-agnostic",
   "license": "AGPL-3.0-or-later",
   "author": "jb@media.mit.edu",

package/src/client.d.ts

@@ -0,0 +1,26 @@
+import type { McpServerInfo, McpCapabilities, McpInitializeResult, McpTool, McpToolResult, McpClientOptions } from './types.js';
+export declare class McpClient {
+    private url;
+    private options;
+    private sessionId;
+    private tools;
+    private serverInfo;
+    private capabilities;
+    private connected;
+    private rpcIdCounter;
+    private isReconnecting;
+    private reconnectPromise;
+    constructor(url: string, options?: McpClientOptions);
+    connect(): Promise<McpInitializeResult>;
+    listTools(): Promise<McpTool[]>;
+    callTool(name: string, args?: Record<string, unknown>): Promise<McpToolResult>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getServerInfo(): McpServerInfo | null;
+    getCapabilities(): McpCapabilities | null;
+    getTools(): McpTool[];
+    getSessionId(): string | null;
+    private notify;
+    private rpc;
+    private parseSseResponse;
+}

package/src/client.ts

@@ -131,7 +131,9 @@ export class McpClient {
       ...this.options.headers,
     };
     if (this.sessionId) headers['Mcp-Session-Id'] = this.sessionId;
-    await fetch(this.url, { method: 'POST', headers, body: JSON.stringify(body) }).catch((e) => console.warn('[McpClient] initialized notification failed:', e));
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.options.timeout);
+    await fetch(this.url, { method: 'POST', headers, body: JSON.stringify(body), signal: controller.signal }).catch((e) => console.warn('[McpClient] notification failed:', e)).finally(() => clearTimeout(timer));
   }
 
   private async rpc<T>(method: string, params?: Record<string, unknown>, attempt = 0): Promise<T> {

package/src/events.d.ts

@@ -0,0 +1,16 @@
+import type { ToolExecuteResult, PostMessageBridgeOptions } from './types.js';
+type ToolExecutor = (name: string, args: Record<string, unknown>) => Promise<ToolExecuteResult>;
+export declare function listenForAgentCalls(executor: ToolExecutor, options?: PostMessageBridgeOptions): () => void;
+/** @deprecated Use the stop function returned by listenForAgentCalls() instead. */
+export declare function stopListening(): void;
+/**
+ * Helper for agents / Chrome extensions that want to call a tool via
+ * postMessage and get the result as a Promise.
+ */
+export declare function callToolViaPostMessage(name: string, args: Record<string, unknown>, options?: {
+    timeout?: number;
+    targetWindow?: Window;
+} & PostMessageBridgeOptions): Promise<ToolExecuteResult>;
+/** Type guard — returns true if data looks like any webmcp:* event. */
+export declare function isWebMCPEvent(data: unknown): boolean;
+export {};

package/src/index.d.ts

@@ -0,0 +1,13 @@
+export type { JsonSchemaType, JsonSchemaObject, JsonSchema, ToolAnnotations, ModelContextTool, ToolExecuteCallback, ModelContextClient, UserInteractionOptions, UserInteractionResult, ToolRegistrationOptions, RegisteredTool, ContextRegistration, ToolsChangedCallback, ModelContext, ModelContextTesting, ModelContextTestingToolInfo, ToolContentType, ToolContentText, ToolContentImage, ToolContentResource, ToolContentError, ToolContent, ToolExecuteResult, ToolResultMetadata, AuthContext, ConfirmationTier, ConfirmationPolicy, WebMCPPolyfillOptions, JsonRpcRequest, JsonRpcError, JsonRpcResponse, McpServerInfo, McpCapabilities, McpInitializeResult, McpTool, McpToolResultContent, McpToolResult, McpListToolsResult, McpClientOptions, WebMCPCallToolEvent, WebMCPToolResultEvent, WebMCPToolErrorEvent, PostMessageBridgeOptions, } from './types.js';
+export { validateJsonSchema } from './validate.js';
+export type { ValidationResult, ValidationError } from './validate.js';
+export { initializeWebMCPPolyfill, cleanupWebMCPPolyfill, hasNativeWebMCP, executeToolInternal, } from './polyfill.js';
+export { McpClient } from './client.js';
+export { listenForAgentCalls, stopListening, callToolViaPostMessage, isWebMCPEvent, } from './events.js';
+export { dispatchAndWait, signalCompletion, sanitizeSchema, sanitizeSchemaWithReport, flattenSchema, unflattenParams, createToolGroup, } from './utils.js';
+export type { SchemaPatch } from './utils.js';
+export { textResult, jsonResult, } from './webmcp-helpers.js';
+export { McpMultiClient } from './multi-client.js';
+export type { ConnectedServer } from './multi-client.js';
+export { createWebMcpServer, parseFrontmatter, mountWidget } from './webmcp-server.js';
+export type { WebMcpServer, WebMcpServerOptions, WebMcpToolDef, WidgetEntry, WidgetRenderer } from './webmcp-server.js';

package/src/index.ts

@@ -76,21 +76,23 @@ export {
   dispatchAndWait,
   signalCompletion,
   sanitizeSchema,
+  sanitizeSchemaWithReport,
+  flattenSchema,
+  unflattenParams,
   createToolGroup,
 } from './utils.js';
+export type { SchemaPatch } from './utils.js';
 
-// WebMCP helpers (skill registry + result builders)
+// WebMCP helpers (result builders)
 export {
   textResult,
   jsonResult,
-  registerSkill,
-  unregisterSkill,
-  getSkill,
-  listSkills,
-  clearSkills,
 } from './webmcp-helpers.js';
-export type { SkillDef } from './webmcp-helpers.js';
 
 // Multi-MCP client
 export { McpMultiClient } from './multi-client.js';
 export type { ConnectedServer } from './multi-client.js';
+
+// WebMCP Server
+export { createWebMcpServer, parseFrontmatter, mountWidget } from './webmcp-server.js';
+export type { WebMcpServer, WebMcpServerOptions, WebMcpToolDef, WidgetEntry, WidgetRenderer } from './webmcp-server.js';