@frontmcp/sdk 0.6.3 → 0.7.2

package/mcp-apps/schemas.d.ts

@@ -1,403 +0,0 @@
-/**
- * @file schemas.ts
- * @description Zod schemas for MCP Apps specification validation.
- *
- * @module @frontmcp/sdk/mcp-apps/schemas
- */
-import { z } from 'zod';
-/**
- * MCP Apps MIME type schema.
- */
-export declare const McpAppsMimeTypeSchema: z.ZodLiteral<"text/html+mcp">;
-/**
- * Display mode schema.
- */
-export declare const McpAppsDisplayModeSchema: z.ZodEnum<{
-    inline: "inline";
-    fullscreen: "fullscreen";
-    pip: "pip";
-}>;
-/**
- * Platform type schema.
- */
-export declare const McpAppsPlatformSchema: z.ZodEnum<{
-    web: "web";
-    desktop: "desktop";
-    mobile: "mobile";
-}>;
-/**
- * Theme schema.
- */
-export declare const ThemeSchema: z.ZodEnum<{
-    light: "light";
-    dark: "dark";
-}>;
-/**
- * Content Security Policy schema.
- */
-export declare const McpAppsCSPSchema: z.ZodObject<{
-    connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strict>;
-/**
- * UI Resource metadata schema.
- */
-export declare const UIResourceMetaSchema: z.ZodObject<{
-    csp: z.ZodOptional<z.ZodObject<{
-        connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>>;
-    domain: z.ZodOptional<z.ZodString>;
-    prefersBorder: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-/**
- * UI Resource schema.
- */
-export declare const UIResourceSchema: z.ZodObject<{
-    uri: z.ZodString;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    mimeType: z.ZodLiteral<"text/html+mcp">;
-    _meta: z.ZodOptional<z.ZodObject<{
-        ui: z.ZodOptional<z.ZodObject<{
-            csp: z.ZodOptional<z.ZodObject<{
-                connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            }, z.core.$strict>>;
-            domain: z.ZodOptional<z.ZodString>;
-            prefersBorder: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>;
-    }, z.core.$strip>>;
-}, z.core.$strict>;
-/**
- * Device capabilities schema.
- */
-export declare const DeviceCapabilitiesSchema: z.ZodObject<{
-    touch: z.ZodOptional<z.ZodBoolean>;
-    hover: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-/**
- * Safe area insets schema.
- */
-export declare const SafeAreaInsetsSchema: z.ZodObject<{
-    top: z.ZodNumber;
-    right: z.ZodNumber;
-    bottom: z.ZodNumber;
-    left: z.ZodNumber;
-}, z.core.$strict>;
-/**
- * Viewport info schema.
- */
-export declare const ViewportInfoSchema: z.ZodObject<{
-    width: z.ZodNumber;
-    height: z.ZodNumber;
-    maxHeight: z.ZodOptional<z.ZodNumber>;
-    maxWidth: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strict>;
-/**
- * Tool info schema.
- */
-export declare const ToolInfoSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-    tool: z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>;
-}, z.core.$strict>;
-/**
- * Host context schema.
- */
-export declare const McpAppsHostContextSchema: z.ZodObject<{
-    toolInfo: z.ZodOptional<z.ZodObject<{
-        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-        tool: z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>;
-    }, z.core.$strict>>;
-    theme: z.ZodOptional<z.ZodEnum<{
-        light: "light";
-        dark: "dark";
-    }>>;
-    displayMode: z.ZodOptional<z.ZodEnum<{
-        inline: "inline";
-        fullscreen: "fullscreen";
-        pip: "pip";
-    }>>;
-    viewport: z.ZodOptional<z.ZodObject<{
-        width: z.ZodNumber;
-        height: z.ZodNumber;
-        maxHeight: z.ZodOptional<z.ZodNumber>;
-        maxWidth: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strict>>;
-    locale: z.ZodOptional<z.ZodString>;
-    timeZone: z.ZodOptional<z.ZodString>;
-    platform: z.ZodOptional<z.ZodEnum<{
-        web: "web";
-        desktop: "desktop";
-        mobile: "mobile";
-    }>>;
-    deviceCapabilities: z.ZodOptional<z.ZodObject<{
-        touch: z.ZodOptional<z.ZodBoolean>;
-        hover: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>>;
-    safeAreaInsets: z.ZodOptional<z.ZodObject<{
-        top: z.ZodNumber;
-        right: z.ZodNumber;
-        bottom: z.ZodNumber;
-        left: z.ZodNumber;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-/**
- * JSON-RPC error schema.
- */
-export declare const JsonRpcErrorSchema: z.ZodObject<{
-    code: z.ZodNumber;
-    message: z.ZodString;
-    data: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strict>;
-/**
- * JSON-RPC request schema.
- */
-export declare const JsonRpcRequestSchema: z.ZodObject<{
-    jsonrpc: z.ZodLiteral<"2.0">;
-    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
-    method: z.ZodString;
-    params: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strict>;
-/**
- * JSON-RPC response schema.
- */
-export declare const JsonRpcResponseSchema: z.ZodObject<{
-    jsonrpc: z.ZodLiteral<"2.0">;
-    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
-    result: z.ZodOptional<z.ZodUnknown>;
-    error: z.ZodOptional<z.ZodObject<{
-        code: z.ZodNumber;
-        message: z.ZodString;
-        data: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-/**
- * JSON-RPC notification schema.
- */
-export declare const JsonRpcNotificationSchema: z.ZodObject<{
-    jsonrpc: z.ZodLiteral<"2.0">;
-    method: z.ZodString;
-    params: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strict>;
-/**
- * UI Initialize params schema.
- */
-export declare const McpUiInitializeParamsSchema: z.ZodObject<{
-    protocolVersion: z.ZodString;
-    capabilities: z.ZodOptional<z.ZodObject<{
-        messages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strict>;
-/**
- * UI Initialize result schema.
- */
-export declare const McpUiInitializeResultSchema: z.ZodObject<{
-    protocolVersion: z.ZodString;
-    capabilities: z.ZodObject<{
-        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>;
-    hostContext: z.ZodObject<{
-        toolInfo: z.ZodOptional<z.ZodObject<{
-            id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-            tool: z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-                inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            }, z.core.$strip>;
-        }, z.core.$strict>>;
-        theme: z.ZodOptional<z.ZodEnum<{
-            light: "light";
-            dark: "dark";
-        }>>;
-        displayMode: z.ZodOptional<z.ZodEnum<{
-            inline: "inline";
-            fullscreen: "fullscreen";
-            pip: "pip";
-        }>>;
-        viewport: z.ZodOptional<z.ZodObject<{
-            width: z.ZodNumber;
-            height: z.ZodNumber;
-            maxHeight: z.ZodOptional<z.ZodNumber>;
-            maxWidth: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>>;
-        locale: z.ZodOptional<z.ZodString>;
-        timeZone: z.ZodOptional<z.ZodString>;
-        platform: z.ZodOptional<z.ZodEnum<{
-            web: "web";
-            desktop: "desktop";
-            mobile: "mobile";
-        }>>;
-        deviceCapabilities: z.ZodOptional<z.ZodObject<{
-            touch: z.ZodOptional<z.ZodBoolean>;
-            hover: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        safeAreaInsets: z.ZodOptional<z.ZodObject<{
-            top: z.ZodNumber;
-            right: z.ZodNumber;
-            bottom: z.ZodNumber;
-            left: z.ZodNumber;
-        }, z.core.$strict>>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-/**
- * Tool input params schema.
- */
-export declare const McpUiToolInputParamsSchema: z.ZodObject<{
-    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strict>;
-/**
- * Tool input partial params schema.
- */
-export declare const McpUiToolInputPartialParamsSchema: z.ZodObject<{
-    argumentsDelta: z.ZodString;
-}, z.core.$strict>;
-/**
- * Tool result content item schema.
- */
-export declare const ToolResultContentItemSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-        image: "image";
-        resource: "resource";
-        text: "text";
-    }>;
-    text: z.ZodOptional<z.ZodString>;
-    data: z.ZodOptional<z.ZodString>;
-    mimeType: z.ZodOptional<z.ZodString>;
-    uri: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Tool result params schema.
- */
-export declare const McpUiToolResultParamsSchema: z.ZodObject<{
-    content: z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<{
-            image: "image";
-            resource: "resource";
-            text: "text";
-        }>;
-        text: z.ZodOptional<z.ZodString>;
-        data: z.ZodOptional<z.ZodString>;
-        mimeType: z.ZodOptional<z.ZodString>;
-        uri: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strict>;
-/**
- * Tool cancelled params schema.
- */
-export declare const McpUiToolCancelledParamsSchema: z.ZodObject<{
-    reason: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-/**
- * Size change params schema.
- */
-export declare const McpUiSizeChangeParamsSchema: z.ZodObject<{
-    viewport: z.ZodObject<{
-        width: z.ZodNumber;
-        height: z.ZodNumber;
-        maxHeight: z.ZodOptional<z.ZodNumber>;
-        maxWidth: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-/**
- * Host context change params schema.
- */
-export declare const McpUiHostContextChangeParamsSchema: z.ZodObject<{
-    changes: z.ZodObject<{
-        toolInfo: z.ZodOptional<z.ZodOptional<z.ZodObject<{
-            id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-            tool: z.ZodObject<{
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-                inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            }, z.core.$strip>;
-        }, z.core.$strict>>>;
-        theme: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
-            light: "light";
-            dark: "dark";
-        }>>>;
-        displayMode: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
-            inline: "inline";
-            fullscreen: "fullscreen";
-            pip: "pip";
-        }>>>;
-        viewport: z.ZodOptional<z.ZodOptional<z.ZodObject<{
-            width: z.ZodNumber;
-            height: z.ZodNumber;
-            maxHeight: z.ZodOptional<z.ZodNumber>;
-            maxWidth: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>>>;
-        locale: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        timeZone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        platform: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
-            web: "web";
-            desktop: "desktop";
-            mobile: "mobile";
-        }>>>;
-        deviceCapabilities: z.ZodOptional<z.ZodOptional<z.ZodObject<{
-            touch: z.ZodOptional<z.ZodBoolean>;
-            hover: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>>;
-        safeAreaInsets: z.ZodOptional<z.ZodOptional<z.ZodObject<{
-            top: z.ZodNumber;
-            right: z.ZodNumber;
-            bottom: z.ZodNumber;
-            left: z.ZodNumber;
-        }, z.core.$strict>>>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-/**
- * Open link params schema.
- */
-export declare const McpUiOpenLinkParamsSchema: z.ZodObject<{
-    url: z.ZodString;
-}, z.core.$strict>;
-/**
- * Message params schema.
- */
-export declare const McpUiMessageParamsSchema: z.ZodObject<{
-    content: z.ZodString;
-}, z.core.$strict>;
-/**
- * MCP Apps extension capability schema.
- */
-export declare const McpAppsExtensionCapabilitySchema: z.ZodObject<{
-    mimeTypes: z.ZodArray<z.ZodLiteral<"text/html+mcp">>;
-}, z.core.$strict>;
-/**
- * Tool UI metadata schema.
- */
-export declare const ToolUIMetaSchema: z.ZodObject<{
-    'ui/resourceUri': z.ZodOptional<z.ZodString>;
-    'ui/mimeType': z.ZodOptional<z.ZodLiteral<"text/html+mcp">>;
-}, z.core.$loose>;
-/**
- * Validate a UI resource URI.
- */
-export declare function isValidUIResourceUri(uri: string): boolean;
-/**
- * Validate MCP Apps protocol version.
- */
-export declare function isValidProtocolVersion(version: string): boolean;
-/**
- * Parse and validate UI resource.
- */
-export declare function parseUIResource(data: unknown): z.infer<typeof UIResourceSchema> | null;
-/**
- * Parse and validate host context.
- */
-export declare function parseHostContext(data: unknown): z.infer<typeof McpAppsHostContextSchema> | null;
-/**
- * Default protocol version.
- */
-export declare const DEFAULT_PROTOCOL_VERSION: "2025-01-01";

package/mcp-apps/template.d.ts

@@ -1,94 +0,0 @@
-/**
- * @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;