@frontmcp/sdk 0.4.0 → 0.5.0

package/src/mcp-apps/schemas.js

@@ -0,0 +1,345 @@
+"use strict";
+/**
+ * @file schemas.ts
+ * @description Zod schemas for MCP Apps specification validation.
+ *
+ * @module @frontmcp/sdk/mcp-apps/schemas
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROTOCOL_VERSION = exports.ToolUIMetaSchema = exports.McpAppsExtensionCapabilitySchema = exports.McpUiMessageParamsSchema = exports.McpUiOpenLinkParamsSchema = exports.McpUiHostContextChangeParamsSchema = exports.McpUiSizeChangeParamsSchema = exports.McpUiToolCancelledParamsSchema = exports.McpUiToolResultParamsSchema = exports.ToolResultContentItemSchema = exports.McpUiToolInputPartialParamsSchema = exports.McpUiToolInputParamsSchema = exports.McpUiInitializeResultSchema = exports.McpUiInitializeParamsSchema = exports.JsonRpcNotificationSchema = exports.JsonRpcResponseSchema = exports.JsonRpcRequestSchema = exports.JsonRpcErrorSchema = exports.McpAppsHostContextSchema = exports.ToolInfoSchema = exports.ViewportInfoSchema = exports.SafeAreaInsetsSchema = exports.DeviceCapabilitiesSchema = exports.UIResourceSchema = exports.UIResourceMetaSchema = exports.McpAppsCSPSchema = exports.ThemeSchema = exports.McpAppsPlatformSchema = exports.McpAppsDisplayModeSchema = exports.McpAppsMimeTypeSchema = void 0;
+exports.isValidUIResourceUri = isValidUIResourceUri;
+exports.isValidProtocolVersion = isValidProtocolVersion;
+exports.parseUIResource = parseUIResource;
+exports.parseHostContext = parseHostContext;
+const zod_1 = require("zod");
+const types_1 = require("./types");
+// ============================================
+// Basic Schemas
+// ============================================
+/**
+ * MCP Apps MIME type schema.
+ */
+exports.McpAppsMimeTypeSchema = zod_1.z.literal(types_1.MCP_APPS_MIME_TYPE);
+/**
+ * Display mode schema.
+ */
+exports.McpAppsDisplayModeSchema = zod_1.z.enum(['inline', 'fullscreen', 'pip']);
+/**
+ * Platform type schema.
+ */
+exports.McpAppsPlatformSchema = zod_1.z.enum(['web', 'desktop', 'mobile']);
+/**
+ * Theme schema.
+ */
+exports.ThemeSchema = zod_1.z.enum(['light', 'dark']);
+// ============================================
+// CSP Schema
+// ============================================
+/**
+ * Content Security Policy schema.
+ */
+exports.McpAppsCSPSchema = zod_1.z
+    .object({
+    connectDomains: zod_1.z.array(zod_1.z.string().url()).optional(),
+    resourceDomains: zod_1.z.array(zod_1.z.string().url()).optional(),
+})
+    .strict();
+// ============================================
+// UI Resource Schemas
+// ============================================
+/**
+ * UI Resource metadata schema.
+ */
+exports.UIResourceMetaSchema = zod_1.z
+    .object({
+    csp: exports.McpAppsCSPSchema.optional(),
+    domain: zod_1.z.string().optional(),
+    prefersBorder: zod_1.z.boolean().optional(),
+})
+    .strict();
+/**
+ * UI Resource schema.
+ */
+exports.UIResourceSchema = zod_1.z
+    .object({
+    uri: zod_1.z.string().startsWith('ui://'),
+    name: zod_1.z.string().min(1),
+    description: zod_1.z.string().optional(),
+    mimeType: exports.McpAppsMimeTypeSchema,
+    _meta: zod_1.z
+        .object({
+        ui: exports.UIResourceMetaSchema.optional(),
+    })
+        .optional(),
+})
+    .strict();
+// ============================================
+// Host Context Schemas
+// ============================================
+/**
+ * Device capabilities schema.
+ */
+exports.DeviceCapabilitiesSchema = zod_1.z
+    .object({
+    touch: zod_1.z.boolean().optional(),
+    hover: zod_1.z.boolean().optional(),
+})
+    .strict();
+/**
+ * Safe area insets schema.
+ */
+exports.SafeAreaInsetsSchema = zod_1.z
+    .object({
+    top: zod_1.z.number(),
+    right: zod_1.z.number(),
+    bottom: zod_1.z.number(),
+    left: zod_1.z.number(),
+})
+    .strict();
+/**
+ * Viewport info schema.
+ */
+exports.ViewportInfoSchema = zod_1.z
+    .object({
+    width: zod_1.z.number().positive(),
+    height: zod_1.z.number().positive(),
+    maxHeight: zod_1.z.number().positive().optional(),
+    maxWidth: zod_1.z.number().positive().optional(),
+})
+    .strict();
+/**
+ * Tool info schema.
+ */
+exports.ToolInfoSchema = zod_1.z
+    .object({
+    id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    tool: zod_1.z.object({
+        name: zod_1.z.string().min(1),
+        description: zod_1.z.string().optional(),
+        inputSchema: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    }),
+})
+    .strict();
+/**
+ * Host context schema.
+ */
+exports.McpAppsHostContextSchema = zod_1.z
+    .object({
+    toolInfo: exports.ToolInfoSchema.optional(),
+    theme: exports.ThemeSchema.optional(),
+    displayMode: exports.McpAppsDisplayModeSchema.optional(),
+    viewport: exports.ViewportInfoSchema.optional(),
+    locale: zod_1.z.string().optional(),
+    timeZone: zod_1.z.string().optional(),
+    platform: exports.McpAppsPlatformSchema.optional(),
+    deviceCapabilities: exports.DeviceCapabilitiesSchema.optional(),
+    safeAreaInsets: exports.SafeAreaInsetsSchema.optional(),
+})
+    .strict();
+// ============================================
+// JSON-RPC Schemas
+// ============================================
+/**
+ * JSON-RPC error schema.
+ */
+exports.JsonRpcErrorSchema = zod_1.z
+    .object({
+    code: zod_1.z.number().int(),
+    message: zod_1.z.string(),
+    data: zod_1.z.unknown().optional(),
+})
+    .strict();
+/**
+ * JSON-RPC request schema.
+ */
+exports.JsonRpcRequestSchema = zod_1.z
+    .object({
+    jsonrpc: zod_1.z.literal('2.0'),
+    id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]),
+    method: zod_1.z.string().min(1),
+    params: zod_1.z.unknown().optional(),
+})
+    .strict();
+/**
+ * JSON-RPC response schema.
+ */
+exports.JsonRpcResponseSchema = zod_1.z
+    .object({
+    jsonrpc: zod_1.z.literal('2.0'),
+    id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]),
+    result: zod_1.z.unknown().optional(),
+    error: exports.JsonRpcErrorSchema.optional(),
+})
+    .strict();
+/**
+ * JSON-RPC notification schema.
+ */
+exports.JsonRpcNotificationSchema = zod_1.z
+    .object({
+    jsonrpc: zod_1.z.literal('2.0'),
+    method: zod_1.z.string().min(1),
+    params: zod_1.z.unknown().optional(),
+})
+    .strict();
+// ============================================
+// MCP Apps Protocol Message Schemas
+// ============================================
+/**
+ * UI Initialize params schema.
+ */
+exports.McpUiInitializeParamsSchema = zod_1.z
+    .object({
+    protocolVersion: zod_1.z.string(),
+    capabilities: zod_1.z
+        .object({
+        messages: zod_1.z.array(zod_1.z.string()).optional(),
+    })
+        .optional(),
+})
+    .strict();
+/**
+ * UI Initialize result schema.
+ */
+exports.McpUiInitializeResultSchema = zod_1.z
+    .object({
+    protocolVersion: zod_1.z.string(),
+    capabilities: zod_1.z.object({
+        extensions: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    }),
+    hostContext: exports.McpAppsHostContextSchema,
+})
+    .strict();
+/**
+ * Tool input params schema.
+ */
+exports.McpUiToolInputParamsSchema = zod_1.z
+    .object({
+    arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+})
+    .strict();
+/**
+ * Tool input partial params schema.
+ */
+exports.McpUiToolInputPartialParamsSchema = zod_1.z
+    .object({
+    argumentsDelta: zod_1.z.string(),
+})
+    .strict();
+/**
+ * Tool result content item schema.
+ */
+exports.ToolResultContentItemSchema = zod_1.z.object({
+    type: zod_1.z.enum(['text', 'image', 'resource']),
+    text: zod_1.z.string().optional(),
+    data: zod_1.z.string().optional(),
+    mimeType: zod_1.z.string().optional(),
+    uri: zod_1.z.string().optional(),
+});
+/**
+ * Tool result params schema.
+ */
+exports.McpUiToolResultParamsSchema = zod_1.z
+    .object({
+    content: zod_1.z.array(exports.ToolResultContentItemSchema),
+    structuredContent: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    _meta: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+})
+    .strict();
+/**
+ * Tool cancelled params schema.
+ */
+exports.McpUiToolCancelledParamsSchema = zod_1.z
+    .object({
+    reason: zod_1.z.string().optional(),
+})
+    .strict();
+/**
+ * Size change params schema.
+ */
+exports.McpUiSizeChangeParamsSchema = zod_1.z
+    .object({
+    viewport: exports.ViewportInfoSchema,
+})
+    .strict();
+/**
+ * Host context change params schema.
+ */
+exports.McpUiHostContextChangeParamsSchema = zod_1.z
+    .object({
+    changes: exports.McpAppsHostContextSchema.partial(),
+})
+    .strict();
+/**
+ * Open link params schema.
+ */
+exports.McpUiOpenLinkParamsSchema = zod_1.z
+    .object({
+    url: zod_1.z.string().url(),
+})
+    .strict();
+/**
+ * Message params schema.
+ */
+exports.McpUiMessageParamsSchema = zod_1.z
+    .object({
+    content: zod_1.z.string().min(1),
+})
+    .strict();
+// ============================================
+// Extension Capability Schema
+// ============================================
+/**
+ * MCP Apps extension capability schema.
+ */
+exports.McpAppsExtensionCapabilitySchema = zod_1.z
+    .object({
+    mimeTypes: zod_1.z.array(exports.McpAppsMimeTypeSchema),
+})
+    .strict();
+// ============================================
+// Tool Metadata Extension Schema
+// ============================================
+/**
+ * Tool UI metadata schema.
+ */
+exports.ToolUIMetaSchema = zod_1.z
+    .object({
+    'ui/resourceUri': zod_1.z.string().startsWith('ui://').optional(),
+    'ui/mimeType': exports.McpAppsMimeTypeSchema.optional(),
+})
+    .passthrough(); // Allow additional platform-specific fields
+// ============================================
+// Validation Helpers
+// ============================================
+/**
+ * Validate a UI resource URI.
+ */
+function isValidUIResourceUri(uri) {
+    return uri.startsWith('ui://') && uri.length > 5;
+}
+/**
+ * Validate MCP Apps protocol version.
+ */
+function isValidProtocolVersion(version) {
+    // Accept current version or future versions
+    return /^\d{4}-\d{2}-\d{2}$/.test(version);
+}
+/**
+ * Parse and validate UI resource.
+ */
+function parseUIResource(data) {
+    const result = exports.UIResourceSchema.safeParse(data);
+    return result.success ? result.data : null;
+}
+/**
+ * Parse and validate host context.
+ */
+function parseHostContext(data) {
+    const result = exports.McpAppsHostContextSchema.safeParse(data);
+    return result.success ? result.data : null;
+}
+/**
+ * Default protocol version.
+ */
+exports.DEFAULT_PROTOCOL_VERSION = types_1.MCP_APPS_PROTOCOL_VERSION;
+//# sourceMappingURL=schemas.js.map

package/src/mcp-apps/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/mcp-apps/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file schemas.ts\n * @description Zod schemas for MCP Apps specification validation.\n *\n * @module @frontmcp/sdk/mcp-apps/schemas\n */\n\nimport { z } from 'zod';\nimport { MCP_APPS_MIME_TYPE, MCP_APPS_PROTOCOL_VERSION } from './types';\n\n// ============================================\n// Basic Schemas\n// ============================================\n\n/**\n * MCP Apps MIME type schema.\n */\nexport const McpAppsMimeTypeSchema = z.literal(MCP_APPS_MIME_TYPE);\n\n/**\n * Display mode schema.\n */\nexport const McpAppsDisplayModeSchema = z.enum(['inline', 'fullscreen', 'pip']);\n\n/**\n * Platform type schema.\n */\nexport const McpAppsPlatformSchema = z.enum(['web', 'desktop', 'mobile']);\n\n/**\n * Theme schema.\n */\nexport const ThemeSchema = z.enum(['light', 'dark']);\n\n// ============================================\n// CSP Schema\n// ============================================\n\n/**\n * Content Security Policy schema.\n */\nexport const McpAppsCSPSchema = z\n  .object({\n    connectDomains: z.array(z.string().url()).optional(),\n    resourceDomains: z.array(z.string().url()).optional(),\n  })\n  .strict();\n\n// ============================================\n// UI Resource Schemas\n// ============================================\n\n/**\n * UI Resource metadata schema.\n */\nexport const UIResourceMetaSchema = z\n  .object({\n    csp: McpAppsCSPSchema.optional(),\n    domain: z.string().optional(),\n    prefersBorder: z.boolean().optional(),\n  })\n  .strict();\n\n/**\n * UI Resource schema.\n */\nexport const UIResourceSchema = z\n  .object({\n    uri: z.string().startsWith('ui://'),\n    name: z.string().min(1),\n    description: z.string().optional(),\n    mimeType: McpAppsMimeTypeSchema,\n    _meta: z\n      .object({\n        ui: UIResourceMetaSchema.optional(),\n      })\n      .optional(),\n  })\n  .strict();\n\n// ============================================\n// Host Context Schemas\n// ============================================\n\n/**\n * Device capabilities schema.\n */\nexport const DeviceCapabilitiesSchema = z\n  .object({\n    touch: z.boolean().optional(),\n    hover: z.boolean().optional(),\n  })\n  .strict();\n\n/**\n * Safe area insets schema.\n */\nexport const SafeAreaInsetsSchema = z\n  .object({\n    top: z.number(),\n    right: z.number(),\n    bottom: z.number(),\n    left: z.number(),\n  })\n  .strict();\n\n/**\n * Viewport info schema.\n */\nexport const ViewportInfoSchema = z\n  .object({\n    width: z.number().positive(),\n    height: z.number().positive(),\n    maxHeight: z.number().positive().optional(),\n    maxWidth: z.number().positive().optional(),\n  })\n  .strict();\n\n/**\n * Tool info schema.\n */\nexport const ToolInfoSchema = z\n  .object({\n    id: z.union([z.string(), z.number()]).optional(),\n    tool: z.object({\n      name: z.string().min(1),\n      description: z.string().optional(),\n      inputSchema: z.record(z.string(), z.unknown()).optional(),\n    }),\n  })\n  .strict();\n\n/**\n * Host context schema.\n */\nexport const McpAppsHostContextSchema = z\n  .object({\n    toolInfo: ToolInfoSchema.optional(),\n    theme: ThemeSchema.optional(),\n    displayMode: McpAppsDisplayModeSchema.optional(),\n    viewport: ViewportInfoSchema.optional(),\n    locale: z.string().optional(),\n    timeZone: z.string().optional(),\n    platform: McpAppsPlatformSchema.optional(),\n    deviceCapabilities: DeviceCapabilitiesSchema.optional(),\n    safeAreaInsets: SafeAreaInsetsSchema.optional(),\n  })\n  .strict();\n\n// ============================================\n// JSON-RPC Schemas\n// ============================================\n\n/**\n * JSON-RPC error schema.\n */\nexport const JsonRpcErrorSchema = z\n  .object({\n    code: z.number().int(),\n    message: z.string(),\n    data: z.unknown().optional(),\n  })\n  .strict();\n\n/**\n * JSON-RPC request schema.\n */\nexport const JsonRpcRequestSchema = z\n  .object({\n    jsonrpc: z.literal('2.0'),\n    id: z.union([z.string(), z.number()]),\n    method: z.string().min(1),\n    params: z.unknown().optional(),\n  })\n  .strict();\n\n/**\n * JSON-RPC response schema.\n */\nexport const JsonRpcResponseSchema = z\n  .object({\n    jsonrpc: z.literal('2.0'),\n    id: z.union([z.string(), z.number()]),\n    result: z.unknown().optional(),\n    error: JsonRpcErrorSchema.optional(),\n  })\n  .strict();\n\n/**\n * JSON-RPC notification schema.\n */\nexport const JsonRpcNotificationSchema = z\n  .object({\n    jsonrpc: z.literal('2.0'),\n    method: z.string().min(1),\n    params: z.unknown().optional(),\n  })\n  .strict();\n\n// ============================================\n// MCP Apps Protocol Message Schemas\n// ============================================\n\n/**\n * UI Initialize params schema.\n */\nexport const McpUiInitializeParamsSchema = z\n  .object({\n    protocolVersion: z.string(),\n    capabilities: z\n      .object({\n        messages: z.array(z.string()).optional(),\n      })\n      .optional(),\n  })\n  .strict();\n\n/**\n * UI Initialize result schema.\n */\nexport const McpUiInitializeResultSchema = z\n  .object({\n    protocolVersion: z.string(),\n    capabilities: z.object({\n      extensions: z.record(z.string(), z.unknown()).optional(),\n    }),\n    hostContext: McpAppsHostContextSchema,\n  })\n  .strict();\n\n/**\n * Tool input params schema.\n */\nexport const McpUiToolInputParamsSchema = z\n  .object({\n    arguments: z.record(z.string(), z.unknown()),\n  })\n  .strict();\n\n/**\n * Tool input partial params schema.\n */\nexport const McpUiToolInputPartialParamsSchema = z\n  .object({\n    argumentsDelta: z.string(),\n  })\n  .strict();\n\n/**\n * Tool result content item schema.\n */\nexport const ToolResultContentItemSchema = z.object({\n  type: z.enum(['text', 'image', 'resource']),\n  text: z.string().optional(),\n  data: z.string().optional(),\n  mimeType: z.string().optional(),\n  uri: z.string().optional(),\n});\n\n/**\n * Tool result params schema.\n */\nexport const McpUiToolResultParamsSchema = z\n  .object({\n    content: z.array(ToolResultContentItemSchema),\n    structuredContent: z.record(z.string(), z.unknown()).optional(),\n    _meta: z.record(z.string(), z.unknown()).optional(),\n  })\n  .strict();\n\n/**\n * Tool cancelled params schema.\n */\nexport const McpUiToolCancelledParamsSchema = z\n  .object({\n    reason: z.string().optional(),\n  })\n  .strict();\n\n/**\n * Size change params schema.\n */\nexport const McpUiSizeChangeParamsSchema = z\n  .object({\n    viewport: ViewportInfoSchema,\n  })\n  .strict();\n\n/**\n * Host context change params schema.\n */\nexport const McpUiHostContextChangeParamsSchema = z\n  .object({\n    changes: McpAppsHostContextSchema.partial(),\n  })\n  .strict();\n\n/**\n * Open link params schema.\n */\nexport const McpUiOpenLinkParamsSchema = z\n  .object({\n    url: z.string().url(),\n  })\n  .strict();\n\n/**\n * Message params schema.\n */\nexport const McpUiMessageParamsSchema = z\n  .object({\n    content: z.string().min(1),\n  })\n  .strict();\n\n// ============================================\n// Extension Capability Schema\n// ============================================\n\n/**\n * MCP Apps extension capability schema.\n */\nexport const McpAppsExtensionCapabilitySchema = z\n  .object({\n    mimeTypes: z.array(McpAppsMimeTypeSchema),\n  })\n  .strict();\n\n// ============================================\n// Tool Metadata Extension Schema\n// ============================================\n\n/**\n * Tool UI metadata schema.\n */\nexport const ToolUIMetaSchema = z\n  .object({\n    'ui/resourceUri': z.string().startsWith('ui://').optional(),\n    'ui/mimeType': McpAppsMimeTypeSchema.optional(),\n  })\n  .passthrough(); // Allow additional platform-specific fields\n\n// ============================================\n// Validation Helpers\n// ============================================\n\n/**\n * Validate a UI resource URI.\n */\nexport function isValidUIResourceUri(uri: string): boolean {\n  return uri.startsWith('ui://') && uri.length > 5;\n}\n\n/**\n * Validate MCP Apps protocol version.\n */\nexport function isValidProtocolVersion(version: string): boolean {\n  // Accept current version or future versions\n  return /^\\d{4}-\\d{2}-\\d{2}$/.test(version);\n}\n\n/**\n * Parse and validate UI resource.\n */\nexport function parseUIResource(data: unknown): z.infer<typeof UIResourceSchema> | null {\n  const result = UIResourceSchema.safeParse(data);\n  return result.success ? result.data : null;\n}\n\n/**\n * Parse and validate host context.\n */\nexport function parseHostContext(data: unknown): z.infer<typeof McpAppsHostContextSchema> | null {\n  const result = McpAppsHostContextSchema.safeParse(data);\n  return result.success ? result.data : null;\n}\n\n/**\n * Default protocol version.\n */\nexport const DEFAULT_PROTOCOL_VERSION = MCP_APPS_PROTOCOL_VERSION;\n"]}

package/src/mcp-apps/template.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @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
+ */
+import type { McpAppsCSP, ToolInfo } from './types';
+/**
+ * Options for generating MCP Apps HTML template.
+ */
+export interface McpAppsTemplateOptions {
+    /** Tool information */
+    toolInfo?: ToolInfo;
+    /** Tool input arguments */
+    input?: Record<string, unknown>;
+    /** Tool output/result */
+    output?: unknown;
+    /** Structured content for UI rendering */
+    structuredContent?: unknown;
+    /** Content Security Policy */
+    csp?: McpAppsCSP;
+    /** Page title */
+    title?: string;
+    /** Additional head content (styles, meta tags) */
+    headContent?: string;
+    /** Main body content (HTML) */
+    bodyContent: string;
+    /** Additional scripts to include */
+    scripts?: string[];
+    /** Whether to include the MCP bridge runtime */
+    includeBridge?: boolean;
+    /** Custom bridge configuration */
+    bridgeConfig?: McpAppsBridgeConfig;
+    /** Initial theme */
+    theme?: 'light' | 'dark';
+    /** Debug mode - adds console logging */
+    debug?: boolean;
+}
+/**
+ * MCP Apps bridge configuration.
+ */
+export interface McpAppsBridgeConfig {
+    /** Protocol version */
+    protocolVersion?: string;
+    /** Trusted origin for postMessage */
+    trustedOrigin?: string;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+}
+/**
+ * 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'] },
+ * });
+ * ```
+ */
+export declare function generateMcpAppsTemplate(options: McpAppsTemplateOptions): string;
+/**
+ * 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
+ */
+export declare function wrapInMcpAppsTemplate(html: string, options: Omit<McpAppsTemplateOptions, 'bodyContent'>): string;
+/**
+ * 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
+ */
+export declare function createSimpleMcpAppsTemplate(content: string, title?: string): string;
+/**
+ * Extract body content from MCP Apps template.
+ * Useful for testing.
+ *
+ * @param html - Complete HTML document
+ * @returns Body content string or null
+ */
+export declare function extractBodyContent(html: string): string | null;