@revealui/mcp 0.0.1-pre.0 → 0.1.1

package/dist/hypervisor.js

@@ -0,0 +1,359 @@
+/**
+ * MCP Hypervisor
+ *
+ * Manages N running MCP server processes, pings them for liveness, and
+ * dynamically exposes their tools at runtime. Inspired by the
+ * MCPCompatibilityLayer/MCPHypervisor pattern from AnythingLLM.
+ *
+ * Architecture:
+ *   - Singleton: one hypervisor per process manages all MCP servers
+ *   - Each server is spawned with piped stdio for JSON-RPC communication
+ *   - Tool names are namespaced: @@mcp_{serverName}_{toolName}
+ *   - Health check loop: every 60s, process.exitCode check + tools/list probe
+ *
+ * Wire format: newline-delimited JSON-RPC 2.0 (stdin/stdout)
+ */
+import { spawn } from 'node:child_process';
+import { registerCleanupHandler } from '@revealui/core/monitoring';
+import { logger } from '@revealui/core/observability/logger';
+// =============================================================================
+// Constants
+// =============================================================================
+const HEALTH_CHECK_INTERVAL_MS = 60_000;
+const REQUEST_TIMEOUT_MS = 5_000;
+const MCP_TOOL_PREFIX = '@@mcp';
+// =============================================================================
+// MCPHypervisor
+// =============================================================================
+/**
+ * Singleton that manages MCP server processes and their tool registries.
+ *
+ * @example
+ * ```typescript
+ * const hypervisor = MCPHypervisor.getInstance()
+ *
+ * hypervisor.registerServer({
+ *   name: 'stripe',
+ *   command: 'pnpm',
+ *   args: ['dlx', '@stripe/mcp', '--tools=all', '--api-key=sk_...'],
+ * })
+ *
+ * await hypervisor.startServer('stripe')
+ * const tools = hypervisor.getAllTools()
+ * // tools[0].namespacedName === '@@mcp_stripe_create_payment_intent'
+ * ```
+ */
+export class MCPHypervisor {
+    static instance = null;
+    servers = new Map();
+    requestCounter = 0;
+    pendingRequests = new Map();
+    healthCheckTimer = null;
+    constructor() {
+        registerCleanupHandler('mcp-hypervisor', async () => this.stopAll(), 'Stop all MCP server processes', 85);
+        this.startHealthCheckLoop();
+    }
+    static getInstance() {
+        if (!MCPHypervisor.instance) {
+            MCPHypervisor.instance = new MCPHypervisor();
+        }
+        return MCPHypervisor.instance;
+    }
+    // ---------------------------------------------------------------------------
+    // Server registration
+    // ---------------------------------------------------------------------------
+    /**
+     * Register an MCP server configuration without starting it.
+     */
+    registerServer(config) {
+        if (this.servers.has(config.name)) {
+            logger.warn(`[MCPHypervisor] Server "${config.name}" is already registered`);
+            return;
+        }
+        this.servers.set(config.name, {
+            config,
+            process: null,
+            tools: [],
+            healthy: false,
+            lastPingAt: null,
+        });
+        logger.info(`[MCPHypervisor] Registered server: ${config.name}`);
+    }
+    /**
+     * Unregister a server (stops it first if running).
+     */
+    async unregisterServer(name) {
+        const entry = this.servers.get(name);
+        if (!entry)
+            return;
+        if (entry.process)
+            await this.stopServer(name);
+        this.servers.delete(name);
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Spawn the MCP server process with piped stdio.
+     * Tools are discovered via `listServerTools()` after startup.
+     */
+    async startServer(name) {
+        const entry = this.servers.get(name);
+        if (!entry)
+            throw new Error(`[MCPHypervisor] Unknown server: "${name}"`);
+        if (entry.process && entry.process.exitCode === null) {
+            logger.info(`[MCPHypervisor] Server "${name}" is already running`);
+            return;
+        }
+        const { config } = entry;
+        const child = spawn(config.command, config.args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, ...config.env },
+        });
+        entry.process = child;
+        entry.healthy = false;
+        entry.tools = [];
+        // Buffer incoming stdout for JSON-RPC response parsing
+        let buffer = '';
+        child.stdout?.on('data', (chunk) => {
+            buffer += chunk.toString();
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? ''; // keep incomplete line in buffer
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const msg = JSON.parse(trimmed);
+                    this.handleResponse(msg);
+                }
+                catch {
+                    // Non-JSON output from server — ignore
+                }
+            }
+        });
+        child.stderr?.on('data', (chunk) => {
+            logger.warn(`[MCPHypervisor] ${name} stderr: ${chunk.toString().trim()}`);
+        });
+        child.on('exit', (code) => {
+            logger.warn(`[MCPHypervisor] Server "${name}" exited with code ${code}`);
+            entry.healthy = false;
+            // Reject all pending requests for this server
+            for (const [id, pending] of this.pendingRequests) {
+                pending.reject(new Error(`Server "${name}" exited`));
+                clearTimeout(pending.timer);
+                this.pendingRequests.delete(id);
+            }
+        });
+        // Allow a brief startup window, then probe tools
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        try {
+            await this.listServerTools(name);
+            entry.healthy = true;
+            logger.info(`[MCPHypervisor] Server "${name}" started (${entry.tools.length} tools)`);
+        }
+        catch (error) {
+            logger.warn(`[MCPHypervisor] Server "${name}" started but tool discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+            // Still mark healthy if the process is alive (tools may not be supported)
+            entry.healthy = entry.process.exitCode === null;
+        }
+    }
+    /**
+     * Stop a running MCP server process.
+     */
+    async stopServer(name) {
+        const entry = this.servers.get(name);
+        if (!entry?.process)
+            return;
+        entry.process.kill('SIGTERM');
+        await new Promise((resolve) => setTimeout(resolve, 200));
+        if (entry.process.exitCode === null) {
+            entry.process.kill('SIGKILL');
+        }
+        entry.process = null;
+        entry.healthy = false;
+        entry.tools = [];
+        logger.info(`[MCPHypervisor] Stopped server: ${name}`);
+    }
+    /**
+     * Stop all running servers.
+     */
+    async stopAll() {
+        this.stopHealthCheckLoop();
+        await Promise.all(Array.from(this.servers.keys()).map((name) => this.stopServer(name)));
+    }
+    // ---------------------------------------------------------------------------
+    // JSON-RPC communication
+    // ---------------------------------------------------------------------------
+    /**
+     * Send a JSON-RPC request to a running server and await the response.
+     */
+    sendRequest(name, method, params) {
+        const entry = this.servers.get(name);
+        if (!entry?.process || entry.process.exitCode !== null) {
+            return Promise.reject(new Error(`Server "${name}" is not running`));
+        }
+        const id = ++this.requestCounter;
+        const request = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            ...(params !== undefined && { params }),
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`Request ${method} timed out after ${REQUEST_TIMEOUT_MS}ms`));
+            }, REQUEST_TIMEOUT_MS);
+            this.pendingRequests.set(id, { resolve, reject, timer });
+            try {
+                entry.process?.stdin?.write(`${JSON.stringify(request)}\n`);
+            }
+            catch (error) {
+                clearTimeout(timer);
+                this.pendingRequests.delete(id);
+                reject(error);
+            }
+        });
+    }
+    handleResponse(msg) {
+        const pending = this.pendingRequests.get(msg.id);
+        if (!pending)
+            return;
+        clearTimeout(pending.timer);
+        this.pendingRequests.delete(msg.id);
+        if (msg.error) {
+            pending.reject(new Error(`JSON-RPC error ${msg.error.code}: ${msg.error.message}`));
+        }
+        else {
+            pending.resolve(msg.result);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Health checks
+    // ---------------------------------------------------------------------------
+    /**
+     * Ping a server — checks process liveness and sends a JSON-RPC `ping`.
+     * Updates `entry.healthy`.
+     */
+    async pingServer(name) {
+        const entry = this.servers.get(name);
+        if (!entry)
+            return false;
+        // Process liveness check
+        if (!entry.process || entry.process.exitCode !== null) {
+            entry.healthy = false;
+            return false;
+        }
+        entry.lastPingAt = Date.now();
+        try {
+            await this.sendRequest(name, 'ping');
+            entry.healthy = true;
+            return true;
+        }
+        catch {
+            // ping not supported by all servers — still healthy if process is alive
+            entry.healthy = entry.process.exitCode === null;
+            return entry.healthy;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Tool discovery
+    // ---------------------------------------------------------------------------
+    /**
+     * Discover tools from a running server via JSON-RPC `tools/list`.
+     * Caches the result in the server entry.
+     */
+    async listServerTools(name) {
+        const entry = this.servers.get(name);
+        if (!entry)
+            throw new Error(`Unknown server: "${name}"`);
+        const result = await this.sendRequest(name, 'tools/list');
+        const tools = result?.tools ?? [];
+        entry.tools = tools;
+        return tools;
+    }
+    /**
+     * Return all tools from all healthy servers, namespaced as
+     * `@@mcp_{serverName}_{toolName}` to avoid collisions.
+     */
+    getAllTools() {
+        const tools = [];
+        for (const [serverName, entry] of this.servers) {
+            if (!entry.healthy)
+                continue;
+            for (const tool of entry.tools) {
+                tools.push({
+                    namespacedName: `${MCP_TOOL_PREFIX}_${serverName}_${tool.name}`,
+                    serverName,
+                    tool,
+                });
+            }
+        }
+        return tools;
+    }
+    /**
+     * Call a tool on a running MCP server via JSON-RPC `tools/call`.
+     *
+     * @param serverName - The registered server name
+     * @param toolName - The tool name (without namespace prefix)
+     * @param args - Arguments to pass to the tool
+     */
+    async callTool(serverName, toolName, args) {
+        return this.sendRequest(serverName, 'tools/call', {
+            name: toolName,
+            arguments: args,
+        });
+    }
+    /**
+     * Return the health status of all registered servers.
+     */
+    getStatus() {
+        const status = {};
+        for (const [name, entry] of this.servers) {
+            status[name] = {
+                healthy: entry.healthy,
+                toolCount: entry.tools.length,
+                pid: entry.process?.pid ?? null,
+            };
+        }
+        return status;
+    }
+    // ---------------------------------------------------------------------------
+    // Health check loop
+    // ---------------------------------------------------------------------------
+    startHealthCheckLoop() {
+        this.healthCheckTimer = setInterval(async () => {
+            for (const [name] of this.servers) {
+                try {
+                    await this.pingServer(name);
+                }
+                catch {
+                    // Already handled inside pingServer
+                }
+            }
+        }, HEALTH_CHECK_INTERVAL_MS);
+        // Don't prevent process exit
+        this.healthCheckTimer.unref?.();
+    }
+    stopHealthCheckLoop() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Testing utilities
+    // ---------------------------------------------------------------------------
+    /**
+     * Reset the singleton (for testing only).
+     * @internal
+     */
+    static _resetForTests() {
+        if (MCPHypervisor.instance) {
+            MCPHypervisor.instance.stopHealthCheckLoop();
+            MCPHypervisor.instance = null;
+        }
+    }
+}
+//# sourceMappingURL=hypervisor.js.map

package/dist/hypervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypervisor.js","sourceRoot":"","sources":["../src/hypervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAwD5D,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,wBAAwB,GAAG,MAAM,CAAA;AACvC,MAAM,kBAAkB,GAAG,KAAK,CAAA;AAChC,MAAM,eAAe,GAAG,OAAO,CAAA;AAE/B,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAA;IAE5C,OAAO,GAA6B,IAAI,GAAG,EAAE,CAAA;IAC7C,cAAc,GAAG,CAAC,CAAA;IAClB,eAAe,GAGnB,IAAI,GAAG,EAAE,CAAA;IACL,gBAAgB,GAA0B,IAAI,CAAA;IAEtD;QACE,sBAAsB,CACpB,gBAAgB,EAChB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAC1B,+BAA+B,EAC/B,EAAE,CACH,CAAA;QACD,IAAI,CAAC,oBAAoB,EAAE,CAAA;IAC7B,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAA;QAC9C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAA;IAC/B,CAAC;IAED,8EAA8E;IAC9E,sBAAsB;IACtB,8EAA8E;IAE9E;;OAEG;IACH,cAAc,CAAC,MAAuB;QACpC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAA;YAC5E,OAAM;QACR,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;YAC5B,MAAM;YACN,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,IAAI;SACjB,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,CAAC,sCAAsC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,IAAI,KAAK,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAED,8EAA8E;IAC9E,YAAY;IACZ,8EAA8E;IAE9E;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,GAAG,CAAC,CAAA;QACxE,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,sBAAsB,CAAC,CAAA;YAClE,OAAM;QACR,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;YAC/C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE;SACvC,CAAC,CAAA;QAEF,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;QACrB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;QACrB,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;QAEhB,uDAAuD;QACvD,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAA;YAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAChC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA,CAAC,iCAAiC;YAC5D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;gBAC3B,IAAI,CAAC,OAAO;oBAAE,SAAQ;gBACtB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAA;oBAClD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,uCAAuC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,CAAC,IAAI,CAAC,mBAAmB,IAAI,YAAY,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC3E,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,sBAAsB,IAAI,EAAE,CAAC,CAAA;YACxE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;YACrB,8CAA8C;YAC9C,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACjD,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,IAAI,UAAU,CAAC,CAAC,CAAA;gBACpD,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBAC3B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YACjC,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,iDAAiD;QACjD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QAE9D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;YAChC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;YACpB,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,cAAc,KAAK,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAA;QACvF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,2BAA2B,IAAI,wCAC7B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAA;YACD,0EAA0E;YAC1E,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAA;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,EAAE,OAAO;YAAE,OAAM;QAE3B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QAE9D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC/B,CAAC;QAED,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;QACpB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;QACrB,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;QAChB,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAC1B,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzF,CAAC;IAED,8EAA8E;IAC9E,yBAAyB;IACzB,8EAA8E;IAE9E;;OAEG;IACK,WAAW,CAAC,IAAY,EAAE,MAAc,EAAE,MAAgB;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,IAAI,kBAAkB,CAAC,CAAC,CAAA;QACrE,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,CAAA;QAChC,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;SACxC,CAAA;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBAC/B,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,MAAM,oBAAoB,kBAAkB,IAAI,CAAC,CAAC,CAAA;YAChF,CAAC,EAAE,kBAAkB,CAAC,CAAA;YAEtB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;YAExD,IAAI,CAAC;gBACH,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC7D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBAC/B,MAAM,CAAC,KAAK,CAAC,CAAA;YACf,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,cAAc,CAAC,GAAoB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,OAAO;YAAE,OAAM;QAEpB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAEnC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QACrF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QAExB,yBAAyB;QACzB,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtD,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;YACrB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACpC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;YACxE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAA;YAC/C,OAAO,KAAK,CAAC,OAAO,CAAA;QACtB,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,iBAAiB;IACjB,8EAA8E;IAE9E;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAA;QAExD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QAEzD,MAAM,KAAK,GAAI,MAAgC,EAAE,KAAK,IAAI,EAAE,CAAA;QAC5D,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;QACnB,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,MAAM,KAAK,GAAqB,EAAE,CAAA;QAElC,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,SAAQ;YAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC;oBACT,cAAc,EAAE,GAAG,eAAe,IAAI,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE;oBAC/D,UAAU;oBACV,IAAI;iBACL,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,UAAkB,EAAE,QAAgB,EAAE,IAAa;QAChE,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE;YAChD,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QACP,MAAM,MAAM,GAAgF,EAAE,CAAA;QAC9F,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,GAAG;gBACb,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;gBAC7B,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI;aAChC,CAAA;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,8EAA8E;IAC9E,oBAAoB;IACpB,8EAA8E;IAEtE,oBAAoB;QAC1B,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YAC7C,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;gBAC7B,CAAC;gBAAC,MAAM,CAAC;oBACP,oCAAoC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC,EAAE,wBAAwB,CAAC,CAAA;QAE5B,6BAA6B;QAC7B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,CAAA;IACjC,CAAC;IAEO,mBAAmB;QACzB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;YACpC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,oBAAoB;IACpB,8EAA8E;IAE9E;;;OAGG;IACH,MAAM,CAAC,cAAc;QACnB,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAA;YAC5C,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAA;QAC/B,CAAC;IACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @revealui/mcp
+ *
+ * Model Context Protocol integrations for RevealUI.
+ *
+ * Provides:
+ * - MCP adapter framework (Vercel, Stripe, Neon)
+ * - Database adapter (PGlite / PostgreSQL) with CRDT support
+ * - MCP contracts (Zod schemas for request/response/tool bridging)
+ * - MCP server launchers (code-validator, stripe, neon, etc.)
+ *
+ * @packageDocumentation
+ */
+/**
+ * Check if the MCP package is licensed for use.
+ * Initializes the license cache from environment variables, then checks the tier.
+ * Returns false with a warning log if no Pro/Enterprise license is active.
+ */
+export declare function checkMcpLicense(): Promise<boolean>;
+export { type CrdtOperationsInsert, type CrdtOperationsRow, connectPglite, connectPostgres, createMcpDbClient, type McpDbClient, type QueryResult, } from './adapters/db.js';
+export { getMcpConfig, type McpConfig as McpEnvConfig, type McpMetricsMode, } from './config/index.js';
+export { agentDefinitionToAgentCard, agentDefinitionToMcpTools, contractsToolDefinitionToMcpTool, type MCPAdapterConfig, MCPAdapterConfigSchema, type MCPRequest, type MCPRequestOptions, MCPRequestOptionsSchema, MCPRequestSchema, type MCPResponse, type MCPResponseMetadata, MCPResponseMetadataSchema, MCPResponseSchema, mcpToolToContractsToolDefinition, } from './contracts.js';
+export { MCPHypervisor, type MCPServerConfig, type MCPTool, type NamespacedTool, } from './hypervisor.js';
+export { createMCPAdapter, disposeAllAdapters, generateIdempotencyKey, generateUniqueIdempotencyKey, MCPAdapter, type MCPConfig, NeonAdapter, StripeAdapter, VercelAdapter, } from './servers/adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAUxD;AAGD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,IAAI,YAAY,EAC9B,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAChC,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,UAAU,EACV,KAAK,SAAS,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAA"}