@revealui/mcp 0.0.1-pre.0 → 0.1.0

package/dist/packages/mcp/src/hypervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypervisor.d.ts","sourceRoot":"","sources":["../../../../src/hypervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,OAAO,CAAA;CACd;AAoCD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,eAAe,CAGV;IACb,OAAO,CAAC,gBAAgB,CAA8B;IAEtD,OAAO;IAUP,MAAM,CAAC,WAAW,IAAI,aAAa;IAWnC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAe7C;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqE9C;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,cAAc;IAkBtB;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BhD;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAWvD;;;OAGG;IACH,WAAW,IAAI,cAAc,EAAE;IAkB/B;;;;;;OAMG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrF;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAgBxF,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,mBAAmB;IAW3B;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI;CAM9B"}

package/dist/packages/mcp/src/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/packages/mcp/src/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/packages/mcp/src/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/packages/mcp/src/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"}

package/dist/packages/mcp/src/index.js

@@ -0,0 +1,41 @@
+/**
+ * @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
+ */
+import { isFeatureEnabled } from '@revealui/core/features';
+import { initializeLicense } from '@revealui/core/license';
+import { logger } from '@revealui/core/observability/logger';
+/**
+ * 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 async function checkMcpLicense() {
+    await initializeLicense();
+    if (!isFeatureEnabled('mcp')) {
+        logger.warn('[@revealui/mcp] MCP server integration requires a Pro or Enterprise license. ' +
+            'Visit https://revealui.com/pricing for details.');
+        return false;
+    }
+    return true;
+}
+// Database adapter
+export { connectPglite, connectPostgres, createMcpDbClient, } from './adapters/db.js';
+// Configuration
+export { getMcpConfig, } from './config/index.js';
+// Contracts (Zod schemas + tool bridging)
+export { agentDefinitionToAgentCard, agentDefinitionToMcpTools, contractsToolDefinitionToMcpTool, MCPAdapterConfigSchema, MCPRequestOptionsSchema, MCPRequestSchema, MCPResponseMetadataSchema, MCPResponseSchema, mcpToolToContractsToolDefinition, } from './contracts.js';
+// Hypervisor: process management + dynamic tool discovery
+export { MCPHypervisor, } from './hypervisor.js';
+// Adapter framework
+export { createMCPAdapter, disposeAllAdapters, generateIdempotencyKey, generateUniqueIdempotencyKey, MCPAdapter, NeonAdapter, StripeAdapter, VercelAdapter, } from './servers/adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/packages/mcp/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,iBAAiB,EAAE,CAAA;IACzB,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CACT,+EAA+E;YAC7E,iDAAiD,CACpD,CAAA;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,mBAAmB;AACnB,OAAO,EAGL,aAAa,EACb,eAAe,EACf,iBAAiB,GAGlB,MAAM,kBAAkB,CAAA;AACzB,gBAAgB;AAChB,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAA;AAC1B,0CAA0C;AAC1C,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAEhC,sBAAsB,EAGtB,uBAAuB,EACvB,gBAAgB,EAGhB,yBAAyB,EACzB,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,gBAAgB,CAAA;AACvB,0DAA0D;AAC1D,OAAO,EACL,aAAa,GAId,MAAM,iBAAiB,CAAA;AACxB,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,UAAU,EAEV,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAA"}

package/dist/packages/mcp/src/servers/adapter.d.ts

@@ -0,0 +1,199 @@
+#!/usr/bin/env tsx
+/**
+ * MCP Adapter - Generic Model Context Protocol Integration
+ *
+ * Provides a unified interface for all MCP server integrations,
+ * eliminating code duplication across different service adapters.
+ *
+ * Usage:
+ *   const adapter = new MCPAdapter('vercel', config)
+ *   await adapter.execute(request)
+ */
+/**
+ * Dispose all active MCP adapters (cleanup on shutdown)
+ */
+export declare function disposeAllAdapters(): void;
+export interface MCPRequest {
+    action: string;
+    parameters?: Record<string, unknown>;
+    options?: {
+        timeout?: number;
+        retries?: number;
+        dryRun?: boolean;
+        /** Idempotency key to prevent duplicate operations */
+        idempotencyKey?: string;
+        /** TTL for idempotency cache in milliseconds (default: 5 minutes) */
+        idempotencyTTL?: number;
+    };
+}
+export interface MCPResponse {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    metadata?: {
+        duration: number;
+        retries: number;
+        service: string;
+        /** Indicates this response was served from idempotency cache */
+        cached?: boolean;
+        /** The idempotency key that was used */
+        idempotencyKey?: string;
+    };
+}
+/**
+ * In-memory idempotency cache for preventing duplicate operations.
+ * Each adapter instance has its own cache.
+ */
+declare class IdempotencyCache {
+    private cache;
+    private cleanupInterval;
+    private readonly DEFAULT_TTL;
+    constructor();
+    /**
+     * Get a cached response by idempotency key
+     */
+    get(key: string): MCPResponse | null;
+    /**
+     * Store a response with idempotency key
+     */
+    set(key: string, response: MCPResponse, ttl?: number): void;
+    /**
+     * Check if a key exists in the cache
+     */
+    has(key: string): boolean;
+    /**
+     * Remove expired entries
+     */
+    private cleanup;
+    /**
+     * Clear all cached entries
+     */
+    clear(): void;
+    /**
+     * Stop the cleanup interval
+     */
+    dispose(): void;
+    /**
+     * Get cache statistics
+     */
+    stats(): {
+        size: number;
+        keys: string[];
+    };
+}
+export interface MCPConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    retries?: number;
+    environment?: 'development' | 'production';
+}
+export declare abstract class MCPAdapter {
+    protected serviceName: string;
+    protected config: MCPConfig;
+    protected logger: import("@revealui/scripts").Logger;
+    protected idempotencyCache: IdempotencyCache;
+    constructor(serviceName: string, config: MCPConfig);
+    /**
+     * Dispose of adapter resources (cleanup idempotency cache)
+     */
+    dispose(): void;
+    /**
+     * Get idempotency cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Clear the idempotency cache
+     */
+    clearCache(): void;
+    /**
+     * Execute an MCP request
+     *
+     * If an idempotencyKey is provided in options, the request will be checked
+     * against the cache. If a cached response exists, it will be returned
+     * immediately. Otherwise, the request will be executed and the response
+     * will be cached for future duplicate requests.
+     */
+    execute(request: MCPRequest): Promise<MCPResponse>;
+    /**
+     * Validate the incoming request
+     */
+    protected validateRequest(request: MCPRequest): void;
+    /**
+     * Check if an action is supported by this adapter
+     */
+    protected abstract isValidAction(action: string): boolean;
+    /**
+     * Execute the actual request (implemented by subclasses)
+     */
+    protected abstract executeRequest(request: MCPRequest): Promise<unknown>;
+    /**
+     * Create a dry-run response
+     */
+    protected createDryRunResponse(request: MCPRequest): MCPResponse;
+    /**
+     * Get authentication headers for API calls
+     */
+    protected getAuthHeaders(): Record<string, string>;
+    /**
+     * Get the authentication header name for this service
+     */
+    protected abstract getAuthHeaderName(): string;
+    /**
+     * Make an HTTP request with proper error handling
+     */
+    protected makeRequest(method: 'GET' | 'POST' | 'PUT' | 'DELETE', url: string, data?: unknown): Promise<unknown>;
+}
+export declare class VercelAdapter extends MCPAdapter {
+    constructor(config: MCPConfig);
+    protected isValidAction(action: string): boolean;
+    protected getAuthHeaderName(): string;
+    protected executeRequest(request: MCPRequest): Promise<unknown>;
+}
+export declare class StripeAdapter extends MCPAdapter {
+    constructor(config: MCPConfig);
+    protected isValidAction(action: string): boolean;
+    protected getAuthHeaderName(): string;
+    protected executeRequest(request: MCPRequest): Promise<unknown>;
+}
+export declare class NeonAdapter extends MCPAdapter {
+    constructor(config: MCPConfig);
+    protected isValidAction(action: string): boolean;
+    protected getAuthHeaderName(): string;
+    protected executeRequest(request: MCPRequest): Promise<unknown>;
+}
+export declare function createMCPAdapter(service: string, config: MCPConfig): MCPAdapter;
+/**
+ * Generate an idempotency key based on the request content.
+ *
+ * This creates a deterministic key from the action and parameters,
+ * so identical requests will get the same key.
+ *
+ * @example
+ * ```typescript
+ * const key = generateIdempotencyKey({
+ *   action: 'deploy',
+ *   parameters: { projectId: '123' }
+ * })
+ * // Returns: "deploy:a1b2c3d4e5f6..."
+ * ```
+ */
+export declare function generateIdempotencyKey(request: MCPRequest): string;
+/**
+ * Generate a unique idempotency key with timestamp.
+ *
+ * Use this when you want each request to be unique but still
+ * want idempotency protection against rapid duplicate submissions.
+ *
+ * @example
+ * ```typescript
+ * const key = generateUniqueIdempotencyKey('deploy')
+ * // Returns: "deploy:1706536800000:a1b2c3d4"
+ * ```
+ */
+export declare function generateUniqueIdempotencyKey(action: string): string;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/packages/mcp/src/servers/adapter.d.ts.map

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