npm - @frontmcp/sdk - Versions diffs - 0.6.0 → 0.6.2 - Mend

@frontmcp/sdk 0.6.0 → 0.6.2

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.

Files changed (1053) hide show

package/src/mcp-apps/template.js DELETED Viewed

@@ -1,419 +0,0 @@
-"use strict";
-/**
- * @file template.ts
- * @description MCP Apps HTML template generator.
- *
- * Generates standard HTML5 documents with embedded MCP bridge for MCP Apps spec compliance.
- *
- * @module @frontmcp/sdk/mcp-apps/template
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateMcpAppsTemplate = generateMcpAppsTemplate;
-exports.wrapInMcpAppsTemplate = wrapInMcpAppsTemplate;
-exports.createSimpleMcpAppsTemplate = createSimpleMcpAppsTemplate;
-exports.extractBodyContent = extractBodyContent;
-const types_1 = require("./types");
-const csp_1 = require("./csp");
-// ============================================
-// Template Generator
-// ============================================
-/**
- * Generate MCP Apps compliant HTML5 document.
- *
- * @param options - Template options
- * @returns Complete HTML5 document string
- *
- * @example
- * ```typescript
- * const html = generateMcpAppsTemplate({
- *   title: 'Weather Dashboard',
- *   bodyContent: '<div id="weather">Loading...</div>',
- *   toolInfo: { tool: { name: 'get_weather' } },
- *   input: { city: 'San Francisco' },
- *   output: { temperature: 72, condition: 'sunny' },
- *   csp: { connectDomains: ['https://api.weather.com'] },
- * });
- * ```
- */
-function generateMcpAppsTemplate(options) {
-    const { toolInfo, input, output, structuredContent, csp, title = 'MCP App', headContent = '', bodyContent, scripts = [], includeBridge = true, bridgeConfig, theme = 'light', debug = false, } = options;
-    // Build CSP meta tag
-    const cspMeta = (0, csp_1.buildCSPMetaTag)(csp);
-    // Build data attributes for initial state
-    const dataAttrs = buildDataAttributes({ toolInfo, input, output, structuredContent });
-    // Build bridge script
-    const bridgeScript = includeBridge ? generateBridgeScript({ ...bridgeConfig, debug }) : '';
-    // Build additional scripts
-    const additionalScripts = scripts.map((s) => `<script>${s}</script>`).join('\n');
-    return `<!DOCTYPE html>
-<html lang="en" data-theme="${escapeAttr(theme)}">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  ${cspMeta}
-  <meta name="mcp-apps-version" content="${types_1.MCP_APPS_PROTOCOL_VERSION}">
-  <meta name="mcp-apps-mime-type" content="${types_1.MCP_APPS_MIME_TYPE}">
-  <title>${escapeHtml(title)}</title>
-  <style>
-    :root {
-      --mcp-bg: #ffffff;
-      --mcp-text: #1a1a1a;
-      --mcp-border: #e5e5e5;
-      --mcp-primary: #0969da;
-      --mcp-error: #cf222e;
-      --mcp-success: #1a7f37;
-    }
-    [data-theme="dark"] {
-      --mcp-bg: #0d1117;
-      --mcp-text: #c9d1d9;
-      --mcp-border: #30363d;
-      --mcp-primary: #58a6ff;
-      --mcp-error: #f85149;
-      --mcp-success: #3fb950;
-    }
-    * { box-sizing: border-box; }
-    body {
-      margin: 0;
-      padding: 16px;
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      background: var(--mcp-bg);
-      color: var(--mcp-text);
-      line-height: 1.5;
-    }
-  </style>
-  ${headContent}
-</head>
-<body ${dataAttrs}>
-  ${bodyContent}
-  ${bridgeScript}
-  ${additionalScripts}
-</body>
-</html>`;
-}
-// ============================================
-// Bridge Script Generator
-// ============================================
-/**
- * Generate the MCP Apps bridge runtime script.
- */
-function generateBridgeScript(config) {
-    const { protocolVersion = types_1.MCP_APPS_PROTOCOL_VERSION, trustedOrigin = '*', requestTimeout = 30000, debug = false, } = config || {};
-    return `<script>
-(function() {
-  'use strict';
-  // MCP Apps Bridge Runtime
-  const MCP_PROTOCOL_VERSION = '${protocolVersion}';
-  const REQUEST_TIMEOUT = ${requestTimeout};
-  const DEBUG = ${debug};
-  // State
-  let initialized = false;
-  let hostContext = {};
-  let pendingRequests = new Map();
-  let messageId = 0;
-  let trustedOrigin = '${trustedOrigin}';
-  // Logging
-  function log(...args) {
-    if (DEBUG) console.log('[MCP Bridge]', ...args);
-  }
-  // Generate unique message ID
-  function nextId() {
-    return ++messageId;
-  }
-  // Send JSON-RPC message to host
-  function sendMessage(message) {
-    log('Sending:', message);
-    parent.postMessage(message, trustedOrigin);
-  }
-  // Send JSON-RPC request and wait for response
-  function sendRequest(method, params) {
-    return new Promise((resolve, reject) => {
-      const id = nextId();
-      const request = {
-        jsonrpc: '2.0',
-        id: id,
-        method: method,
-        params: params
-      };
-      const timeout = setTimeout(() => {
-        pendingRequests.delete(id);
-        reject(new Error('Request timeout: ' + method));
-      }, REQUEST_TIMEOUT);
-      pendingRequests.set(id, { resolve, reject, timeout });
-      sendMessage(request);
-    });
-  }
-  // Send JSON-RPC notification (no response expected)
-  function sendNotification(method, params) {
-    sendMessage({
-      jsonrpc: '2.0',
-      method: method,
-      params: params
-    });
-  }
-  // Handle incoming messages from host
-  function handleMessage(event) {
-    // Validate origin on first message (trust-on-first-use)
-    if (trustedOrigin === '*' && event.origin) {
-      trustedOrigin = event.origin;
-      log('Trusted origin set to:', trustedOrigin);
-    }
-    const data = event.data;
-    if (!data || data.jsonrpc !== '2.0') return;
-    log('Received:', data);
-    // Handle response to our request
-    if (data.id !== undefined && pendingRequests.has(data.id)) {
-      const { resolve, reject, timeout } = pendingRequests.get(data.id);
-      clearTimeout(timeout);
-      pendingRequests.delete(data.id);
-      if (data.error) {
-        reject(new Error(data.error.message || 'Unknown error'));
-      } else {
-        resolve(data.result);
-      }
-      return;
-    }
-    // Handle notifications from host
-    if (data.method) {
-      handleNotification(data.method, data.params);
-    }
-  }
-  // Handle notifications from host
-  function handleNotification(method, params) {
-    switch (method) {
-      case '${types_1.MCP_APPS_METHODS.TOOL_INPUT}':
-        window.dispatchEvent(new CustomEvent('mcp:tool-input', { detail: params }));
-        break;
-      case '${types_1.MCP_APPS_METHODS.TOOL_INPUT_PARTIAL}':
-        window.dispatchEvent(new CustomEvent('mcp:tool-input-partial', { detail: params }));
-        break;
-      case '${types_1.MCP_APPS_METHODS.TOOL_RESULT}':
-        window.dispatchEvent(new CustomEvent('mcp:tool-result', { detail: params }));
-        break;
-      case '${types_1.MCP_APPS_METHODS.TOOL_CANCELLED}':
-        window.dispatchEvent(new CustomEvent('mcp:tool-cancelled', { detail: params }));
-        break;
-      case '${types_1.MCP_APPS_METHODS.SIZE_CHANGE}':
-        window.dispatchEvent(new CustomEvent('mcp:size-change', { detail: params }));
-        break;
-      case '${types_1.MCP_APPS_METHODS.HOST_CONTEXT_CHANGE}':
-        Object.assign(hostContext, params.changes);
-        window.dispatchEvent(new CustomEvent('mcp:context-change', { detail: params.changes }));
-        // Update theme if changed
-        if (params.changes.theme) {
-          document.documentElement.setAttribute('data-theme', params.changes.theme);
-        }
-        break;
-      case '${types_1.MCP_APPS_METHODS.RESOURCE_TEARDOWN}':
-        window.dispatchEvent(new CustomEvent('mcp:teardown', { detail: params }));
-        break;
-    }
-  }
-  // Initialize connection with host
-  async function initialize() {
-    if (initialized) return hostContext;
-    try {
-      const result = await sendRequest('${types_1.MCP_APPS_METHODS.INITIALIZE}', {
-        protocolVersion: MCP_PROTOCOL_VERSION,
-        capabilities: {
-          messages: ['${types_1.MCP_APPS_METHODS.TOOL_INPUT}', '${types_1.MCP_APPS_METHODS.TOOL_RESULT}']
-        }
-      });
-      hostContext = result.hostContext || {};
-      initialized = true;
-      // Apply initial theme
-      if (hostContext.theme) {
-        document.documentElement.setAttribute('data-theme', hostContext.theme);
-      }
-      // Send initialized notification
-      sendNotification('${types_1.MCP_APPS_METHODS.INITIALIZED}', {});
-      log('Initialized with context:', hostContext);
-      window.dispatchEvent(new CustomEvent('mcp:initialized', { detail: hostContext }));
-      return hostContext;
-    } catch (error) {
-      console.error('[MCP Bridge] Initialization failed:', error);
-      throw error;
-    }
-  }
-  // Public API
-  window.mcpBridge = {
-    // Initialize connection
-    initialize: initialize,
-    // Get current host context
-    getHostContext: function() {
-      return { ...hostContext };
-    },
-    // Get tool info
-    getToolInfo: function() {
-      return hostContext.toolInfo;
-    },
-    // Call a tool on the MCP server
-    callTool: function(name, args) {
-      return sendRequest('${types_1.MCP_APPS_METHODS.TOOLS_CALL}', { name, arguments: args });
-    },
-    // Read a resource
-    readResource: function(uri) {
-      return sendRequest('${types_1.MCP_APPS_METHODS.RESOURCES_READ}', { uri });
-    },
-    // Request host to open a link
-    openLink: function(url) {
-      return sendRequest('${types_1.MCP_APPS_METHODS.OPEN_LINK}', { url });
-    },
-    // Send message to host's chat
-    sendMessage: function(content) {
-      return sendRequest('${types_1.MCP_APPS_METHODS.MESSAGE}', { content });
-    },
-    // Log message to host
-    log: function(level, message, data) {
-      sendNotification('${types_1.MCP_APPS_METHODS.NOTIFICATIONS_MESSAGE}', {
-        level: level,
-        logger: 'mcp-app',
-        data: { message, ...data }
-      });
-    },
-    // Ping host
-    ping: function() {
-      return sendRequest('${types_1.MCP_APPS_METHODS.PING}', {});
-    },
-    // Check if initialized
-    isInitialized: function() {
-      return initialized;
-    },
-    // Protocol version
-    protocolVersion: MCP_PROTOCOL_VERSION
-  };
-  // Listen for messages
-  window.addEventListener('message', handleMessage);
-  // Auto-initialize when DOM is ready
-  if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', function() {
-      initialize().catch(function(err) {
-        log('Auto-init failed:', err);
-      });
-    });
-  } else {
-    initialize().catch(function(err) {
-      log('Auto-init failed:', err);
-    });
-  }
-  log('Bridge loaded');
-})();
-</script>`;
-}
-// ============================================
-// Helper Functions
-// ============================================
-/**
- * Build data attributes for initial state injection.
- */
-function buildDataAttributes(options) {
-    const attrs = [];
-    if (options.toolInfo) {
-        attrs.push(`data-mcp-tool="${escapeAttr(JSON.stringify(options.toolInfo))}"`);
-    }
-    if (options.input) {
-        attrs.push(`data-mcp-input="${escapeAttr(JSON.stringify(options.input))}"`);
-    }
-    if (options.output !== undefined) {
-        attrs.push(`data-mcp-output="${escapeAttr(JSON.stringify(options.output))}"`);
-    }
-    if (options.structuredContent !== undefined) {
-        attrs.push(`data-mcp-structured="${escapeAttr(JSON.stringify(options.structuredContent))}"`);
-    }
-    return attrs.join(' ');
-}
-/**
- * Escape HTML content.
- */
-function escapeHtml(str) {
-    return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-}
-/**
- * Escape HTML attribute value.
- */
-function escapeAttr(str) {
-    return str
-        .replace(/&/g, '&amp;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&#39;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;');
-}
-// ============================================
-// Utility Functions
-// ============================================
-/**
- * Wrap existing HTML content in MCP Apps template.
- *
- * @param html - Existing HTML content
- * @param options - Template options (without bodyContent)
- * @returns Complete MCP Apps HTML document
- */
-function wrapInMcpAppsTemplate(html, options) {
-    return generateMcpAppsTemplate({
-        ...options,
-        bodyContent: html,
-    });
-}
-/**
- * Create a minimal MCP Apps template for simple content.
- *
- * @param content - Simple text or HTML content
- * @param title - Page title
- * @returns Complete MCP Apps HTML document
- */
-function createSimpleMcpAppsTemplate(content, title) {
-    return generateMcpAppsTemplate({
-        title: title || 'MCP App',
-        bodyContent: `<div class="mcp-content">${content}</div>`,
-        includeBridge: true,
-    });
-}
-/**
- * Extract body content from MCP Apps template.
- * Useful for testing.
- *
- * @param html - Complete HTML document
- * @returns Body content string or null
- */
-function extractBodyContent(html) {
-    const match = html.match(/<body[^>]*>([\s\S]*?)<script/);
-    return match ? match[1].trim() : null;
-}
-//# sourceMappingURL=template.js.map

package/src/mcp-apps/template.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/mcp-apps/template.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file template.ts\n * @description MCP Apps HTML template generator.\n *\n * Generates standard HTML5 documents with embedded MCP bridge for MCP Apps spec compliance.\n *\n * @module @frontmcp/sdk/mcp-apps/template\n */\n\nimport type { McpAppsCSP, McpAppsHostContext, ToolInfo } from './types';\nimport { MCP_APPS_MIME_TYPE, MCP_APPS_PROTOCOL_VERSION, MCP_APPS_METHODS } from './types';\nimport { buildCSPMetaTag } from './csp';\n\n// ============================================\n// Template Options\n// ============================================\n\n/**\n * Options for generating MCP Apps HTML template.\n */\nexport interface McpAppsTemplateOptions {\n /** Tool information */\n toolInfo?: ToolInfo;\n /** Tool input arguments */\n input?: Record<string, unknown>;\n /** Tool output/result */\n output?: unknown;\n /** Structured content for UI rendering */\n structuredContent?: unknown;\n /** Content Security Policy */\n csp?: McpAppsCSP;\n /** Page title */\n title?: string;\n /** Additional head content (styles, meta tags) */\n headContent?: string;\n /** Main body content (HTML) */\n bodyContent: string;\n /** Additional scripts to include */\n scripts?: string[];\n /** Whether to include the MCP bridge runtime */\n includeBridge?: boolean;\n /** Custom bridge configuration */\n bridgeConfig?: McpAppsBridgeConfig;\n /** Initial theme */\n theme?: 'light' | 'dark';\n /** Debug mode - adds console logging */\n debug?: boolean;\n}\n\n/**\n * MCP Apps bridge configuration.\n */\nexport interface McpAppsBridgeConfig {\n /** Protocol version */\n protocolVersion?: string;\n /** Trusted origin for postMessage */\n trustedOrigin?: string;\n /** Request timeout in milliseconds */\n requestTimeout?: number;\n}\n\n// ============================================\n// Template Generator\n// ============================================\n\n/**\n * Generate MCP Apps compliant HTML5 document.\n *\n * @param options - Template options\n * @returns Complete HTML5 document string\n *\n * @example\n * ```typescript\n * const html = generateMcpAppsTemplate({\n * title: 'Weather Dashboard',\n * bodyContent: '<div id=\"weather\">Loading...</div>',\n * toolInfo: { tool: { name: 'get_weather' } },\n * input: { city: 'San Francisco' },\n * output: { temperature: 72, condition: 'sunny' },\n * csp: { connectDomains: ['https://api.weather.com'] },\n * });\n * ```\n */\nexport function generateMcpAppsTemplate(options: McpAppsTemplateOptions): string {\n const {\n toolInfo,\n input,\n output,\n structuredContent,\n csp,\n title = 'MCP App',\n headContent = '',\n bodyContent,\n scripts = [],\n includeBridge = true,\n bridgeConfig,\n theme = 'light',\n debug = false,\n } = options;\n\n // Build CSP meta tag\n const cspMeta = buildCSPMetaTag(csp);\n\n // Build data attributes for initial state\n const dataAttrs = buildDataAttributes({ toolInfo, input, output, structuredContent });\n\n // Build bridge script\n const bridgeScript = includeBridge ? generateBridgeScript({ ...bridgeConfig, debug }) : '';\n\n // Build additional scripts\n const additionalScripts = scripts.map((s) => `<script>${s}</script>`).join('\\n');\n\n return `<!DOCTYPE html>\n<html lang=\"en\" data-theme=\"${escapeAttr(theme)}\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n ${cspMeta}\n <meta name=\"mcp-apps-version\" content=\"${MCP_APPS_PROTOCOL_VERSION}\">\n <meta name=\"mcp-apps-mime-type\" content=\"${MCP_APPS_MIME_TYPE}\">\n <title>${escapeHtml(title)}</title>\n <style>\n :root {\n --mcp-bg: #ffffff;\n --mcp-text: #1a1a1a;\n --mcp-border: #e5e5e5;\n --mcp-primary: #0969da;\n --mcp-error: #cf222e;\n --mcp-success: #1a7f37;\n }\n [data-theme=\"dark\"] {\n --mcp-bg: #0d1117;\n --mcp-text: #c9d1d9;\n --mcp-border: #30363d;\n --mcp-primary: #58a6ff;\n --mcp-error: #f85149;\n --mcp-success: #3fb950;\n }\n * { box-sizing: border-box; }\n body {\n margin: 0;\n padding: 16px;\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n background: var(--mcp-bg);\n color: var(--mcp-text);\n line-height: 1.5;\n }\n </style>\n ${headContent}\n</head>\n<body ${dataAttrs}>\n ${bodyContent}\n ${bridgeScript}\n ${additionalScripts}\n</body>\n</html>`;\n}\n\n// ============================================\n// Bridge Script Generator\n// ============================================\n\n/**\n * Generate the MCP Apps bridge runtime script.\n */\nfunction generateBridgeScript(config?: McpAppsBridgeConfig & { debug?: boolean }): string {\n const {\n protocolVersion = MCP_APPS_PROTOCOL_VERSION,\n trustedOrigin = '*',\n requestTimeout = 30000,\n debug = false,\n } = config || {};\n\n return `<script>\n(function() {\n 'use strict';\n\n // MCP Apps Bridge Runtime\n const MCP_PROTOCOL_VERSION = '${protocolVersion}';\n const REQUEST_TIMEOUT = ${requestTimeout};\n const DEBUG = ${debug};\n\n // State\n let initialized = false;\n let hostContext = {};\n let pendingRequests = new Map();\n let messageId = 0;\n let trustedOrigin = '${trustedOrigin}';\n\n // Logging\n function log(...args) {\n if (DEBUG) console.log('[MCP Bridge]', ...args);\n }\n\n // Generate unique message ID\n function nextId() {\n return ++messageId;\n }\n\n // Send JSON-RPC message to host\n function sendMessage(message) {\n log('Sending:', message);\n parent.postMessage(message, trustedOrigin);\n }\n\n // Send JSON-RPC request and wait for response\n function sendRequest(method, params) {\n return new Promise((resolve, reject) => {\n const id = nextId();\n const request = {\n jsonrpc: '2.0',\n id: id,\n method: method,\n params: params\n };\n\n const timeout = setTimeout(() => {\n pendingRequests.delete(id);\n reject(new Error('Request timeout: ' + method));\n }, REQUEST_TIMEOUT);\n\n pendingRequests.set(id, { resolve, reject, timeout });\n sendMessage(request);\n });\n }\n\n // Send JSON-RPC notification (no response expected)\n function sendNotification(method, params) {\n sendMessage({\n jsonrpc: '2.0',\n method: method,\n params: params\n });\n }\n\n // Handle incoming messages from host\n function handleMessage(event) {\n // Validate origin on first message (trust-on-first-use)\n if (trustedOrigin === '*' && event.origin) {\n trustedOrigin = event.origin;\n log('Trusted origin set to:', trustedOrigin);\n }\n\n const data = event.data;\n if (!data || data.jsonrpc !== '2.0') return;\n\n log('Received:', data);\n\n // Handle response to our request\n if (data.id !== undefined && pendingRequests.has(data.id)) {\n const { resolve, reject, timeout } = pendingRequests.get(data.id);\n clearTimeout(timeout);\n pendingRequests.delete(data.id);\n\n if (data.error) {\n reject(new Error(data.error.message || 'Unknown error'));\n } else {\n resolve(data.result);\n }\n return;\n }\n\n // Handle notifications from host\n if (data.method) {\n handleNotification(data.method, data.params);\n }\n }\n\n // Handle notifications from host\n function handleNotification(method, params) {\n switch (method) {\n case '${MCP_APPS_METHODS.TOOL_INPUT}':\n window.dispatchEvent(new CustomEvent('mcp:tool-input', { detail: params }));\n break;\n case '${MCP_APPS_METHODS.TOOL_INPUT_PARTIAL}':\n window.dispatchEvent(new CustomEvent('mcp:tool-input-partial', { detail: params }));\n break;\n case '${MCP_APPS_METHODS.TOOL_RESULT}':\n window.dispatchEvent(new CustomEvent('mcp:tool-result', { detail: params }));\n break;\n case '${MCP_APPS_METHODS.TOOL_CANCELLED}':\n window.dispatchEvent(new CustomEvent('mcp:tool-cancelled', { detail: params }));\n break;\n case '${MCP_APPS_METHODS.SIZE_CHANGE}':\n window.dispatchEvent(new CustomEvent('mcp:size-change', { detail: params }));\n break;\n case '${MCP_APPS_METHODS.HOST_CONTEXT_CHANGE}':\n Object.assign(hostContext, params.changes);\n window.dispatchEvent(new CustomEvent('mcp:context-change', { detail: params.changes }));\n // Update theme if changed\n if (params.changes.theme) {\n document.documentElement.setAttribute('data-theme', params.changes.theme);\n }\n break;\n case '${MCP_APPS_METHODS.RESOURCE_TEARDOWN}':\n window.dispatchEvent(new CustomEvent('mcp:teardown', { detail: params }));\n break;\n }\n }\n\n // Initialize connection with host\n async function initialize() {\n if (initialized) return hostContext;\n\n try {\n const result = await sendRequest('${MCP_APPS_METHODS.INITIALIZE}', {\n protocolVersion: MCP_PROTOCOL_VERSION,\n capabilities: {\n messages: ['${MCP_APPS_METHODS.TOOL_INPUT}', '${MCP_APPS_METHODS.TOOL_RESULT}']\n }\n });\n\n hostContext = result.hostContext || {};\n initialized = true;\n\n // Apply initial theme\n if (hostContext.theme) {\n document.documentElement.setAttribute('data-theme', hostContext.theme);\n }\n\n // Send initialized notification\n sendNotification('${MCP_APPS_METHODS.INITIALIZED}', {});\n\n log('Initialized with context:', hostContext);\n window.dispatchEvent(new CustomEvent('mcp:initialized', { detail: hostContext }));\n\n return hostContext;\n } catch (error) {\n console.error('[MCP Bridge] Initialization failed:', error);\n throw error;\n }\n }\n\n // Public API\n window.mcpBridge = {\n // Initialize connection\n initialize: initialize,\n\n // Get current host context\n getHostContext: function() {\n return { ...hostContext };\n },\n\n // Get tool info\n getToolInfo: function() {\n return hostContext.toolInfo;\n },\n\n // Call a tool on the MCP server\n callTool: function(name, args) {\n return sendRequest('${MCP_APPS_METHODS.TOOLS_CALL}', { name, arguments: args });\n },\n\n // Read a resource\n readResource: function(uri) {\n return sendRequest('${MCP_APPS_METHODS.RESOURCES_READ}', { uri });\n },\n\n // Request host to open a link\n openLink: function(url) {\n return sendRequest('${MCP_APPS_METHODS.OPEN_LINK}', { url });\n },\n\n // Send message to host's chat\n sendMessage: function(content) {\n return sendRequest('${MCP_APPS_METHODS.MESSAGE}', { content });\n },\n\n // Log message to host\n log: function(level, message, data) {\n sendNotification('${MCP_APPS_METHODS.NOTIFICATIONS_MESSAGE}', {\n level: level,\n logger: 'mcp-app',\n data: { message, ...data }\n });\n },\n\n // Ping host\n ping: function() {\n return sendRequest('${MCP_APPS_METHODS.PING}', {});\n },\n\n // Check if initialized\n isInitialized: function() {\n return initialized;\n },\n\n // Protocol version\n protocolVersion: MCP_PROTOCOL_VERSION\n };\n\n // Listen for messages\n window.addEventListener('message', handleMessage);\n\n // Auto-initialize when DOM is ready\n if (document.readyState === 'loading') {\n document.addEventListener('DOMContentLoaded', function() {\n initialize().catch(function(err) {\n log('Auto-init failed:', err);\n });\n });\n } else {\n initialize().catch(function(err) {\n log('Auto-init failed:', err);\n });\n }\n\n log('Bridge loaded');\n})();\n</script>`;\n}\n\n// ============================================\n// Helper Functions\n// ============================================\n\n/**\n * Build data attributes for initial state injection.\n */\nfunction buildDataAttributes(options: {\n toolInfo?: ToolInfo;\n input?: Record<string, unknown>;\n output?: unknown;\n structuredContent?: unknown;\n}): string {\n const attrs: string[] = [];\n\n if (options.toolInfo) {\n attrs.push(`data-mcp-tool=\"${escapeAttr(JSON.stringify(options.toolInfo))}\"`);\n }\n\n if (options.input) {\n attrs.push(`data-mcp-input=\"${escapeAttr(JSON.stringify(options.input))}\"`);\n }\n\n if (options.output !== undefined) {\n attrs.push(`data-mcp-output=\"${escapeAttr(JSON.stringify(options.output))}\"`);\n }\n\n if (options.structuredContent !== undefined) {\n attrs.push(`data-mcp-structured=\"${escapeAttr(JSON.stringify(options.structuredContent))}\"`);\n }\n\n return attrs.join(' ');\n}\n\n/**\n * Escape HTML content.\n */\nfunction escapeHtml(str: string): string {\n return str.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>');\n}\n\n/**\n * Escape HTML attribute value.\n */\nfunction escapeAttr(str: string): string {\n return str\n .replace(/&/g, '&')\n .replace(/\"/g, '"')\n .replace(/'/g, ''')\n .replace(/</g, '<')\n .replace(/>/g, '>');\n}\n\n// ============================================\n// Utility Functions\n// ============================================\n\n/**\n * Wrap existing HTML content in MCP Apps template.\n *\n * @param html - Existing HTML content\n * @param options - Template options (without bodyContent)\n * @returns Complete MCP Apps HTML document\n */\nexport function wrapInMcpAppsTemplate(html: string, options: Omit<McpAppsTemplateOptions, 'bodyContent'>): string {\n return generateMcpAppsTemplate({\n ...options,\n bodyContent: html,\n });\n}\n\n/**\n * Create a minimal MCP Apps template for simple content.\n *\n * @param content - Simple text or HTML content\n * @param title - Page title\n * @returns Complete MCP Apps HTML document\n */\nexport function createSimpleMcpAppsTemplate(content: string, title?: string): string {\n return generateMcpAppsTemplate({\n title: title || 'MCP App',\n bodyContent: `<div class=\"mcp-content\">${content}</div>`,\n includeBridge: true,\n });\n}\n\n/**\n * Extract body content from MCP Apps template.\n * Useful for testing.\n *\n * @param html - Complete HTML document\n * @returns Body content string or null\n */\nexport function extractBodyContent(html: string): string | null {\n const match = html.match(/<body[^>]*>([\\s\\S]*?)<script/);\n return match ? match[1].trim() : null;\n}\n"]}

package/src/mcp-apps/types.js DELETED Viewed

@@ -1,59 +0,0 @@
-"use strict";
-/**
- * @file types.ts
- * @description MCP Apps specification types.
- *
- * Implements types from the MCP Apps extension specification:
- * https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx
- *
- * @module @frontmcp/sdk/mcp-apps/types
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCP_APPS_PROTOCOL_VERSION = exports.MCP_APPS_METHODS = exports.MCP_APPS_MIME_TYPE = void 0;
-// ============================================
-// MIME Types
-// ============================================
-/**
- * MCP Apps content MIME type.
- * MVP specification supports only HTML5 documents.
- */
-exports.MCP_APPS_MIME_TYPE = 'text/html+mcp';
-// ============================================
-// MCP Apps Method Names
-// ============================================
-/**
- * MCP Apps protocol method names.
- */
-exports.MCP_APPS_METHODS = {
-    // Lifecycle
-    INITIALIZE: 'ui/initialize',
-    INITIALIZED: 'ui/notifications/initialized',
-    // Tool lifecycle notifications (Host → UI)
-    TOOL_INPUT: 'ui/notifications/tool-input',
-    TOOL_INPUT_PARTIAL: 'ui/notifications/tool-input-partial',
-    TOOL_RESULT: 'ui/notifications/tool-result',
-    TOOL_CANCELLED: 'ui/notifications/tool-cancelled',
-    // Context notifications (Host → UI)
-    SIZE_CHANGE: 'ui/notifications/size-change',
-    HOST_CONTEXT_CHANGE: 'ui/host-context-change',
-    RESOURCE_TEARDOWN: 'ui/resource-teardown',
-    // UI Requests (UI → Host)
-    OPEN_LINK: 'ui/open-link',
-    MESSAGE: 'ui/message',
-    // Standard MCP methods that UI can use
-    TOOLS_CALL: 'tools/call',
-    RESOURCES_READ: 'resources/read',
-    NOTIFICATIONS_MESSAGE: 'notifications/message',
-    PING: 'ping',
-    // Sandbox proxy (web hosts only)
-    SANDBOX_READY: 'ui/notifications/sandbox-ready',
-    SANDBOX_RESOURCE_READY: 'ui/notifications/sandbox-resource-ready',
-};
-// ============================================
-// Protocol Version
-// ============================================
-/**
- * Current MCP Apps protocol version.
- */
-exports.MCP_APPS_PROTOCOL_VERSION = '2025-01-01';
-//# sourceMappingURL=types.js.map

package/src/mcp-apps/types.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp-apps/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+CAA+C;AAC/C,aAAa;AACb,+CAA+C;AAE/C;;;GAGG;AACU,QAAA,kBAAkB,GAAG,eAAwB,CAAC;AAuS3D,+CAA+C;AAC/C,wBAAwB;AACxB,+CAA+C;AAE/C;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,YAAY;IACZ,UAAU,EAAE,eAAe;IAC3B,WAAW,EAAE,8BAA8B;IAE3C,2CAA2C;IAC3C,UAAU,EAAE,6BAA6B;IACzC,kBAAkB,EAAE,qCAAqC;IACzD,WAAW,EAAE,8BAA8B;IAC3C,cAAc,EAAE,iCAAiC;IAEjD,oCAAoC;IACpC,WAAW,EAAE,8BAA8B;IAC3C,mBAAmB,EAAE,wBAAwB;IAC7C,iBAAiB,EAAE,sBAAsB;IAEzC,0BAA0B;IAC1B,SAAS,EAAE,cAAc;IACzB,OAAO,EAAE,YAAY;IAErB,uCAAuC;IACvC,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;IAChC,qBAAqB,EAAE,uBAAuB;IAC9C,IAAI,EAAE,MAAM;IAEZ,iCAAiC;IACjC,aAAa,EAAE,gCAAgC;IAC/C,sBAAsB,EAAE,yCAAyC;CACzD,CAAC;AA8CX,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C;;GAEG;AACU,QAAA,yBAAyB,GAAG,YAAqB,CAAC","sourcesContent":["/**\n * @file types.ts\n * @description MCP Apps specification types.\n *\n * Implements types from the MCP Apps extension specification:\n * https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx\n *\n * @module @frontmcp/sdk/mcp-apps/types\n */\n\n// ============================================\n// MIME Types\n// ============================================\n\n/**\n * MCP Apps content MIME type.\n * MVP specification supports only HTML5 documents.\n */\nexport const MCP_APPS_MIME_TYPE = 'text/html+mcp' as const;\n\n/**\n * Supported MIME types for MCP Apps resources.\n */\nexport type McpAppsMimeType = typeof MCP_APPS_MIME_TYPE;\n\n// ============================================\n// UI Resource Types\n// ============================================\n\n/**\n * Content Security Policy configuration for UI resources.\n * Hosts construct CSP headers from these declared domains.\n */\nexport interface McpAppsCSP {\n /** Domains allowed for network requests (fetch, XHR, WebSocket) */\n connectDomains?: string[];\n /** Domains allowed for static assets (images, scripts, fonts) */\n resourceDomains?: string[];\n}\n\n/**\n * UI Resource metadata as defined in MCP Apps spec.\n * Included in `_meta.ui` field of resource declarations.\n */\nexport interface UIResourceMeta {\n /** Content Security Policy configuration */\n csp?: McpAppsCSP;\n /** Dedicated sandbox origin for this resource */\n domain?: string;\n /** Whether host should render visual boundary around UI */\n prefersBorder?: boolean;\n}\n\n/**\n * Complete UI Resource declaration for MCP Apps.\n */\nexport interface UIResource {\n /** Resource URI (must start with \"ui://\") */\n uri: string;\n /** Human-readable display name */\n name: string;\n /** Optional description */\n description?: string;\n /** MIME type - must be \"text/html+mcp\" for MVP */\n mimeType: McpAppsMimeType;\n /** UI-specific metadata */\n _meta?: {\n ui?: UIResourceMeta;\n };\n}\n\n// ============================================\n// Host Context Types\n// ============================================\n\n/**\n * Display modes for UI rendering.\n */\nexport type McpAppsDisplayMode = 'inline' | 'fullscreen' | 'pip';\n\n/**\n * Platform types for host environment.\n */\nexport type McpAppsPlatform = 'web' | 'desktop' | 'mobile';\n\n/**\n * Device capability flags.\n */\nexport interface DeviceCapabilities {\n /** Touch input available */\n touch?: boolean;\n /** Hover interactions available */\n hover?: boolean;\n}\n\n/**\n * Safe area insets for device screens.\n */\nexport interface SafeAreaInsets {\n top: number;\n right: number;\n bottom: number;\n left: number;\n}\n\n/**\n * Viewport dimensions.\n */\nexport interface ViewportInfo {\n width: number;\n height: number;\n maxHeight?: number;\n maxWidth?: number;\n}\n\n/**\n * Tool information passed to UI.\n */\nexport interface ToolInfo {\n /** Request ID for this tool invocation */\n id?: string | number;\n /** Tool definition */\n tool: {\n name: string;\n description?: string;\n inputSchema?: Record<string, unknown>;\n };\n}\n\n/**\n * Host context provided to UI on initialization.\n * Contains environment information from the host.\n */\nexport interface McpAppsHostContext {\n /** Tool information for this UI context */\n toolInfo?: ToolInfo;\n /** Current theme */\n theme?: 'light' | 'dark';\n /** Current display mode */\n displayMode?: McpAppsDisplayMode;\n /** Viewport dimensions */\n viewport?: ViewportInfo;\n /** User's locale (BCP 47 tag) */\n locale?: string;\n /** User's timezone (IANA name) */\n timeZone?: string;\n /** Host platform type */\n platform?: McpAppsPlatform;\n /** Device capabilities */\n deviceCapabilities?: DeviceCapabilities;\n /** Safe area insets */\n safeAreaInsets?: SafeAreaInsets;\n}\n\n// ============================================\n// JSON-RPC Message Types\n// ============================================\n\n/**\n * Base JSON-RPC 2.0 message.\n */\nexport interface JsonRpcMessage {\n jsonrpc: '2.0';\n}\n\n/**\n * JSON-RPC request message.\n */\nexport interface JsonRpcRequest extends JsonRpcMessage {\n id: string | number;\n method: string;\n params?: unknown;\n}\n\n/**\n * JSON-RPC response message.\n */\nexport interface JsonRpcResponse extends JsonRpcMessage {\n id: string | number;\n result?: unknown;\n error?: JsonRpcError;\n}\n\n/**\n * JSON-RPC notification (no response expected).\n */\nexport interface JsonRpcNotification extends JsonRpcMessage {\n method: string;\n params?: unknown;\n}\n\n/**\n * JSON-RPC error object.\n */\nexport interface JsonRpcError {\n code: number;\n message: string;\n data?: unknown;\n}\n\n// ============================================\n// MCP Apps Protocol Messages\n// ============================================\n\n/**\n * UI Initialize request parameters.\n * Sent by UI to host on startup.\n */\nexport interface McpUiInitializeParams {\n /** Protocol version */\n protocolVersion: string;\n /** UI capabilities */\n capabilities?: {\n /** Supported message types */\n messages?: string[];\n };\n}\n\n/**\n * UI Initialize response from host.\n */\nexport interface McpUiInitializeResult {\n /** Protocol version (should match request) */\n protocolVersion: string;\n /** Host capabilities */\n capabilities: {\n /** Host-provided extensions */\n extensions?: Record<string, unknown>;\n };\n /** Host context information */\n hostContext: McpAppsHostContext;\n}\n\n/**\n * Tool input notification parameters.\n * Sent by host to UI with complete tool arguments.\n */\nexport interface McpUiToolInputParams {\n /** Tool arguments */\n arguments: Record<string, unknown>;\n}\n\n/**\n * Tool input partial notification parameters.\n * Sent by host to UI during streaming.\n */\nexport interface McpUiToolInputPartialParams {\n /** Partial tool arguments (incremental) */\n argumentsDelta: string;\n}\n\n/**\n * Tool result notification parameters.\n * Sent by host to UI after tool execution.\n */\nexport interface McpUiToolResultParams {\n /** Tool execution result */\n content: Array<{\n type: 'text' | 'image' | 'resource';\n text?: string;\n data?: string;\n mimeType?: string;\n uri?: string;\n }>;\n /** Structured content for UI rendering only */\n structuredContent?: Record<string, unknown>;\n /** Additional metadata */\n _meta?: Record<string, unknown>;\n}\n\n/**\n * Tool cancelled notification parameters.\n */\nexport interface McpUiToolCancelledParams {\n /** Reason for cancellation */\n reason?: string;\n}\n\n/**\n * Size change notification parameters.\n * Sent by host when UI viewport changes.\n */\nexport interface McpUiSizeChangeParams {\n /** New viewport dimensions */\n viewport: ViewportInfo;\n}\n\n/**\n * Host context change notification parameters.\n */\nexport interface McpUiHostContextChangeParams {\n /** Changed context fields */\n changes: Partial<McpAppsHostContext>;\n}\n\n/**\n * Open link request parameters.\n * Sent by UI to request host open a URL.\n */\nexport interface McpUiOpenLinkParams {\n /** URL to open */\n url: string;\n}\n\n/**\n * Send message request parameters.\n * Sent by UI to send content to host's chat.\n */\nexport interface McpUiMessageParams {\n /** Message content */\n content: string;\n}\n\n// ============================================\n// MCP Apps Method Names\n// ============================================\n\n/**\n * MCP Apps protocol method names.\n */\nexport const MCP_APPS_METHODS = {\n // Lifecycle\n INITIALIZE: 'ui/initialize',\n INITIALIZED: 'ui/notifications/initialized',\n\n // Tool lifecycle notifications (Host → UI)\n TOOL_INPUT: 'ui/notifications/tool-input',\n TOOL_INPUT_PARTIAL: 'ui/notifications/tool-input-partial',\n TOOL_RESULT: 'ui/notifications/tool-result',\n TOOL_CANCELLED: 'ui/notifications/tool-cancelled',\n\n // Context notifications (Host → UI)\n SIZE_CHANGE: 'ui/notifications/size-change',\n HOST_CONTEXT_CHANGE: 'ui/host-context-change',\n RESOURCE_TEARDOWN: 'ui/resource-teardown',\n\n // UI Requests (UI → Host)\n OPEN_LINK: 'ui/open-link',\n MESSAGE: 'ui/message',\n\n // Standard MCP methods that UI can use\n TOOLS_CALL: 'tools/call',\n RESOURCES_READ: 'resources/read',\n NOTIFICATIONS_MESSAGE: 'notifications/message',\n PING: 'ping',\n\n // Sandbox proxy (web hosts only)\n SANDBOX_READY: 'ui/notifications/sandbox-ready',\n SANDBOX_RESOURCE_READY: 'ui/notifications/sandbox-resource-ready',\n} as const;\n\n// ============================================\n// Extension Capability Types\n// ============================================\n\n/**\n * MCP Apps extension capability declaration.\n * Advertised by clients during connection.\n */\nexport interface McpAppsExtensionCapability {\n /** Supported MIME types */\n mimeTypes: McpAppsMimeType[];\n}\n\n/**\n * Client extensions object including MCP Apps.\n */\nexport interface McpClientExtensions {\n 'io.modelcontextprotocol/ui'?: McpAppsExtensionCapability;\n [key: string]: unknown;\n}\n\n// ============================================\n// Tool Metadata Extension\n// ============================================\n\n/**\n * Tool metadata extension for MCP Apps.\n * Added to tool's `_meta` field to link to UI resource.\n */\nexport interface ToolUIMeta {\n /** URI of the UI resource template */\n 'ui/resourceUri'?: string;\n /** MIME type of the UI resource */\n 'ui/mimeType'?: McpAppsMimeType;\n}\n\n/**\n * Extended tool result metadata including MCP Apps fields.\n */\nexport interface McpAppsToolResultMeta extends ToolUIMeta {\n /** Additional platform-specific metadata */\n [key: string]: unknown;\n}\n\n// ============================================\n// Protocol Version\n// ============================================\n\n/**\n * Current MCP Apps protocol version.\n */\nexport const MCP_APPS_PROTOCOL_VERSION = '2025-01-01' as const;\n"]}

package/src/notification/index.js DELETED Viewed

@@ -1,13 +0,0 @@
-"use strict";
-// file: libs/sdk/src/notification/index.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCP_APPS_EXTENSION_KEY = exports.hasMcpAppsExtension = exports.detectPlatformFromCapabilities = exports.detectPlatformFromUserAgent = exports.detectAIPlatform = exports.MCP_LOGGING_LEVEL_PRIORITY = exports.NotificationService = void 0;
-var notification_service_1 = require("./notification.service");
-Object.defineProperty(exports, "NotificationService", { enumerable: true, get: function () { return notification_service_1.NotificationService; } });
-Object.defineProperty(exports, "MCP_LOGGING_LEVEL_PRIORITY", { enumerable: true, get: function () { return notification_service_1.MCP_LOGGING_LEVEL_PRIORITY; } });
-Object.defineProperty(exports, "detectAIPlatform", { enumerable: true, get: function () { return notification_service_1.detectAIPlatform; } });
-Object.defineProperty(exports, "detectPlatformFromUserAgent", { enumerable: true, get: function () { return notification_service_1.detectPlatformFromUserAgent; } });
-Object.defineProperty(exports, "detectPlatformFromCapabilities", { enumerable: true, get: function () { return notification_service_1.detectPlatformFromCapabilities; } });
-Object.defineProperty(exports, "hasMcpAppsExtension", { enumerable: true, get: function () { return notification_service_1.hasMcpAppsExtension; } });
-Object.defineProperty(exports, "MCP_APPS_EXTENSION_KEY", { enumerable: true, get: function () { return notification_service_1.MCP_APPS_EXTENSION_KEY; } });
-//# sourceMappingURL=index.js.map

package/src/notification/index.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/notification/index.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAE3C,+DAegC;AAd9B,2HAAA,mBAAmB,OAAA;AAInB,kIAAA,0BAA0B,OAAA;AAK1B,wHAAA,gBAAgB,OAAA;AAChB,mIAAA,2BAA2B,OAAA;AAC3B,sIAAA,8BAA8B,OAAA;AAC9B,2HAAA,mBAAmB,OAAA;AACnB,8HAAA,sBAAsB,OAAA","sourcesContent":["// file: libs/sdk/src/notification/index.ts\n\nexport {\n NotificationService,\n type McpNotificationMethod,\n type RegisteredServer,\n type McpLoggingLevel,\n MCP_LOGGING_LEVEL_PRIORITY,\n type Root,\n type ClientCapabilities,\n type ClientInfo,\n type AIPlatformType,\n detectAIPlatform,\n detectPlatformFromUserAgent,\n detectPlatformFromCapabilities,\n hasMcpAppsExtension,\n MCP_APPS_EXTENSION_KEY,\n} from './notification.service';\n"]}