@revealui/mcp 0.0.1-pre.0 → 0.1.0

package/dist/packages/dev/src/code-validator/validator.js.map

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

package/dist/packages/mcp/src/adapters/db.d.ts

@@ -0,0 +1,46 @@
+/**
+ * DB adapter for MCP.
+ * - `connectPglite()` initializes ElectricSQL/pglite client with CRDT metadata.
+ * - `connectPostgres()` creates a standard Postgres client with Electric metadata.
+ * - `createMcpDbClient()` factory that selects adapter based on config.
+ *
+ * Uses @revealui/contracts as the single source of truth for CRDT operation types.
+ */
+import type { CrdtOperationsInsert, CrdtOperationsRow } from '@revealui/contracts';
+export interface QueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    affectedRows?: number;
+}
+export type McpDbClient = {
+    query: <T = Record<string, unknown>>(sql: string, params?: unknown[]) => Promise<QueryResult<T>>;
+    close: () => Promise<void>;
+};
+/** Re-export contracts CRDT types for consumers */
+export type { CrdtOperationsRow, CrdtOperationsInsert };
+/**
+ * Connect to PGlite (embedded PostgreSQL) for local development/testing.
+ * Uses dynamic import to avoid bundling @electric-sql/pglite when not needed.
+ *
+ * @param options - Optional connection options
+ * @param options.dataDir - Override the default data directory. Use ':memory:' for in-memory.
+ */
+export declare function connectPglite(options?: {
+    dataDir?: string;
+}): Promise<McpDbClient>;
+/**
+ * Connect to PostgreSQL for production use.
+ * Supports Neon, Supabase, and generic PostgreSQL with SSL.
+ */
+export declare function connectPostgres(): Promise<McpDbClient>;
+/**
+ * Factory function that creates an MCP database client based on configuration.
+ * Reads `persistenceDriver` from getMcpConfig() to determine which adapter to use.
+ */
+export declare function createMcpDbClient(): Promise<McpDbClient>;
+declare const _default: {
+    connectPglite: typeof connectPglite;
+    connectPostgres: typeof connectPostgres;
+    createMcpDbClient: typeof createMcpDbClient;
+};
+export default _default;
+//# sourceMappingURL=db.d.ts.map

package/dist/packages/mcp/src/adapters/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/db.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGlF,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAChG,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;AAED,mDAAmD;AACnD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAA;AA8BvD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CA8CxF;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CA+C5D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CAS9D;;;;;;AAED,wBAAoE"}

package/dist/packages/mcp/src/adapters/db.js

@@ -0,0 +1,127 @@
+/**
+ * DB adapter for MCP.
+ * - `connectPglite()` initializes ElectricSQL/pglite client with CRDT metadata.
+ * - `connectPostgres()` creates a standard Postgres client with Electric metadata.
+ * - `createMcpDbClient()` factory that selects adapter based on config.
+ *
+ * Uses @revealui/contracts as the single source of truth for CRDT operation types.
+ */
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import getMcpConfig from '@revealui/config/mcp';
+import { getSSLConfig } from '@revealui/core/database/ssl-config';
+// CRDT operations table schema for conflict-free replication
+const CRDT_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS crdt_operations (
+    id TEXT PRIMARY KEY,
+    document_id TEXT NOT NULL,
+    operation_type TEXT NOT NULL,
+    payload JSONB NOT NULL,
+    vector_clock JSONB NOT NULL,
+    node_id TEXT NOT NULL,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    applied_at TIMESTAMPTZ
+  );
+  CREATE INDEX IF NOT EXISTS idx_crdt_ops_document ON crdt_operations(document_id);
+  CREATE INDEX IF NOT EXISTS idx_crdt_ops_node ON crdt_operations(node_id);
+  CREATE INDEX IF NOT EXISTS idx_crdt_ops_created ON crdt_operations(created_at DESC);
+`;
+/**
+ * Connect to PGlite (embedded PostgreSQL) for local development/testing.
+ * Uses dynamic import to avoid bundling @electric-sql/pglite when not needed.
+ *
+ * @param options - Optional connection options
+ * @param options.dataDir - Override the default data directory. Use ':memory:' for in-memory.
+ */
+export async function connectPglite(options) {
+    const cfg = getMcpConfig();
+    // Determine data directory from options, config, or default
+    // Use ':memory:' for in-memory database (useful for testing)
+    const dataDir = options?.dataDir || cfg.electricDatabaseUrl || '.revealui/mcp/pglite';
+    let db;
+    try {
+        // Ensure directory exists if not in-memory
+        if (dataDir !== ':memory:') {
+            await mkdir(dirname(dataDir), { recursive: true });
+        }
+        const { PGlite } = await import('@electric-sql/pglite');
+        db = new PGlite(dataDir);
+        await db.waitReady;
+    }
+    catch (error) {
+        const err = error;
+        if (err.message?.includes('Cannot find module') || err.message?.includes('MODULE_NOT_FOUND')) {
+            throw new Error('@electric-sql/pglite is not installed. Run: pnpm add -D @electric-sql/pglite');
+        }
+        throw error;
+    }
+    // Create CRDT operations table
+    await db.exec(CRDT_TABLE_SQL);
+    return {
+        async query(sql, params) {
+            const result = await db.query(sql, params);
+            return {
+                rows: result.rows,
+                affectedRows: result.affectedRows,
+            };
+        },
+        async close() {
+            await db.close();
+        },
+    };
+}
+/**
+ * Connect to PostgreSQL for production use.
+ * Supports Neon, Supabase, and generic PostgreSQL with SSL.
+ */
+export async function connectPostgres() {
+    const cfg = getMcpConfig();
+    const connectionString = cfg.electricDatabaseUrl ||
+        process.env.DATABASE_URL ||
+        process.env.POSTGRES_URL ||
+        process.env.SUPABASE_DATABASE_URI;
+    if (!connectionString) {
+        throw new Error('Database connection string not found. Set ELECTRIC_DATABASE_URL, DATABASE_URL, POSTGRES_URL, or SUPABASE_DATABASE_URI.');
+    }
+    const { Pool } = await import('pg');
+    const pool = new Pool({
+        connectionString,
+        ssl: getSSLConfig(connectionString),
+    });
+    // Test connection
+    const client = await pool.connect();
+    try {
+        await client.query('SELECT 1');
+    }
+    finally {
+        client.release();
+    }
+    // Create CRDT operations table
+    await pool.query(CRDT_TABLE_SQL);
+    return {
+        async query(sql, params) {
+            const result = await pool.query(sql, params);
+            return {
+                rows: result.rows,
+                affectedRows: result.rowCount ?? undefined,
+            };
+        },
+        async close() {
+            await pool.end();
+        },
+    };
+}
+/**
+ * Factory function that creates an MCP database client based on configuration.
+ * Reads `persistenceDriver` from getMcpConfig() to determine which adapter to use.
+ */
+export async function createMcpDbClient() {
+    const cfg = getMcpConfig();
+    if (cfg.persistenceDriver === 'postgres') {
+        return connectPostgres();
+    }
+    // Default to pglite for local development
+    return connectPglite();
+}
+export default { connectPglite, connectPostgres, createMcpDbClient };
+//# sourceMappingURL=db.js.map

package/dist/packages/mcp/src/adapters/db.js.map

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

package/dist/packages/mcp/src/config/index.d.ts

@@ -0,0 +1,11 @@
+export type McpMetricsMode = 'logs' | 'otel' | 'prometheus';
+export interface McpConfig {
+    persistenceDriver: 'pglite' | 'postgres';
+    electricDatabaseUrl: string | null;
+    electricApiKey: string | null;
+    metricsMode: McpMetricsMode;
+    pgvectorEnabled: boolean;
+}
+export declare function getMcpConfig(): McpConfig;
+export default getMcpConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/mcp/src/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/config/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAA;AAE3D,MAAM,WAAW,SAAS;IACxB,iBAAiB,EAAE,QAAQ,GAAG,UAAU,CAAA;IACxC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,cAAc,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;CACzB;AAOD,wBAAgB,YAAY,IAAI,SAAS,CAYxC;AAED,eAAe,YAAY,CAAA"}

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

@@ -0,0 +1,18 @@
+function boolFromEnv(v, fallback = false) {
+    if (v === undefined)
+        return fallback;
+    return ['1', 'true', 'yes'].includes(v.toLowerCase());
+}
+export function getMcpConfig() {
+    const persistenceDriver = process.env.MCP_PERSISTENCE_DRIVER || 'pglite';
+    const metricsMode = process.env.MCP_METRICS_MODE || 'logs';
+    return {
+        persistenceDriver,
+        electricDatabaseUrl: process.env.ELECTRIC_DATABASE_URL || null,
+        electricApiKey: process.env.ELECTRIC_API_KEY || null,
+        metricsMode,
+        pgvectorEnabled: boolFromEnv(process.env.PGVECTOR_ENABLED, false),
+    };
+}
+export default getMcpConfig;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/config/index.ts"],"names":[],"mappings":"AAUA,SAAS,WAAW,CAAC,CAAqB,EAAE,QAAQ,GAAG,KAAK;IAC1D,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,iBAAiB,GACpB,OAAO,CAAC,GAAG,CAAC,sBAAgD,IAAI,QAAQ,CAAA;IAC3E,MAAM,WAAW,GAAI,OAAO,CAAC,GAAG,CAAC,gBAAmC,IAAI,MAAM,CAAA;IAE9E,OAAO;QACL,iBAAiB;QACjB,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI;QAC9D,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI;QACpD,WAAW;QACX,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC;KAClE,CAAA;AACH,CAAC;AAED,eAAe,YAAY,CAAA"}

package/dist/packages/mcp/src/contracts.d.ts

@@ -0,0 +1,131 @@
+/**
+ * MCP Contracts
+ *
+ * Zod schemas for MCP-specific types, built on top of @revealui/contracts.
+ * These provide runtime validation for MCP request/response payloads
+ * and bridge MCP SDK tool definitions to contracts ToolDefinition.
+ */
+import { type A2AAgentCard, type A2AAuth, type AgentDefinition, type ToolDefinition, z } from '@revealui/contracts';
+/**
+ * Schema for MCP request options (idempotency, retry, dry-run)
+ */
+export declare const MCPRequestOptionsSchema: z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    retries: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    idempotencyTTL: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type MCPRequestOptions = z.infer<typeof MCPRequestOptionsSchema>;
+/**
+ * Schema for an MCP request payload
+ */
+export declare const MCPRequestSchema: z.ZodObject<{
+    action: z.ZodString;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    options: z.ZodOptional<z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        retries: z.ZodOptional<z.ZodNumber>;
+        dryRun: z.ZodOptional<z.ZodBoolean>;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
+        idempotencyTTL: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MCPRequest = z.infer<typeof MCPRequestSchema>;
+/**
+ * Schema for MCP response metadata
+ */
+export declare const MCPResponseMetadataSchema: z.ZodObject<{
+    duration: z.ZodNumber;
+    retries: z.ZodNumber;
+    service: z.ZodString;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MCPResponseMetadata = z.infer<typeof MCPResponseMetadataSchema>;
+/**
+ * Schema for an MCP response payload
+ */
+export declare const MCPResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        duration: z.ZodNumber;
+        retries: z.ZodNumber;
+        service: z.ZodString;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MCPResponse = z.infer<typeof MCPResponseSchema>;
+/**
+ * Schema for MCP adapter configuration
+ */
+export declare const MCPAdapterConfigSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    retries: z.ZodOptional<z.ZodNumber>;
+    environment: z.ZodOptional<z.ZodEnum<{
+        development: "development";
+        production: "production";
+    }>>;
+}, z.core.$strip>;
+export type MCPAdapterConfig = z.infer<typeof MCPAdapterConfigSchema>;
+/**
+ * Converts an MCP SDK tool definition (JSON Schema-based) to a contracts ToolDefinition.
+ *
+ * The MCP SDK uses JSON Schema for tool `inputSchema`, while contracts uses
+ * a structured ToolParameter format. This bridge maps between them.
+ */
+export declare function mcpToolToContractsToolDefinition(mcpTool: {
+    name: string;
+    description?: string;
+    inputSchema?: {
+        type: string;
+        properties?: Record<string, {
+            type?: string;
+            description?: string;
+            default?: unknown;
+            enum?: string[];
+        }>;
+        required?: string[];
+    };
+}): ToolDefinition;
+/**
+ * Converts a contracts ToolDefinition back to an MCP SDK-compatible tool shape.
+ * Useful for registering contracts-defined tools with MCP servers.
+ */
+export declare function contractsToolDefinitionToMcpTool(tool: ToolDefinition): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+            default?: unknown;
+            enum?: string[];
+        }>;
+        required: string[];
+    };
+};
+/**
+ * Converts a RevealUI AgentDefinition to a Google A2A AgentCard.
+ * Wraps the contracts-level `agentDefinitionToCard` with optional MCP-specific overrides.
+ *
+ * @param agent - The agent definition (source of truth)
+ * @param baseUrl - The server base URL (e.g. https://api.revealui.com)
+ * @param opts - Optional overrides for auth scheme and streaming capability
+ */
+export declare function agentDefinitionToAgentCard(agent: AgentDefinition, baseUrl: string, opts?: {
+    authScheme?: A2AAuth;
+    streaming?: boolean;
+}): A2AAgentCard;
+/**
+ * Converts all tools in a RevealUI AgentDefinition to MCP tool specs.
+ * Uses `contractsToolDefinitionToMcpTool` for each tool.
+ */
+export declare function agentDefinitionToMcpTools(agent: AgentDefinition): ReturnType<typeof contractsToolDefinitionToMcpTool>[];
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../src/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,eAAe,EAEpB,KAAK,cAAc,EAGnB,CAAC,EACF,MAAM,qBAAqB,CAAA;AAM5B;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;iBAMlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAI3B,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAK5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;iBAMjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAMrE;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,CAAC,EAAE,MAAM,CACjB,MAAM,EACN;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAC5E,CAAA;QACD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF,GAAG,cAAc,CAuBjB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,cAAc,GAAG;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAC1E,CAAA;QACD,QAAQ,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;CACF,CA6BA;AAMD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD,YAAY,CAiBd;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,eAAe,GACrB,UAAU,CAAC,OAAO,gCAAgC,CAAC,EAAE,CAEvD"}

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

@@ -0,0 +1,153 @@
+/**
+ * MCP Contracts
+ *
+ * Zod schemas for MCP-specific types, built on top of @revealui/contracts.
+ * These provide runtime validation for MCP request/response payloads
+ * and bridge MCP SDK tool definitions to contracts ToolDefinition.
+ */
+import { agentDefinitionToCard, ToolDefinitionSchema, z, } from '@revealui/contracts';
+// =============================================================================
+// MCP Request / Response Schemas
+// =============================================================================
+/**
+ * Schema for MCP request options (idempotency, retry, dry-run)
+ */
+export const MCPRequestOptionsSchema = z.object({
+    timeout: z.number().positive().optional(),
+    retries: z.number().int().nonnegative().optional(),
+    dryRun: z.boolean().optional(),
+    idempotencyKey: z.string().optional(),
+    idempotencyTTL: z.number().positive().optional(),
+});
+/**
+ * Schema for an MCP request payload
+ */
+export const MCPRequestSchema = z.object({
+    action: z.string().min(1),
+    parameters: z.record(z.string(), z.unknown()).optional(),
+    options: MCPRequestOptionsSchema.optional(),
+});
+/**
+ * Schema for MCP response metadata
+ */
+export const MCPResponseMetadataSchema = z.object({
+    duration: z.number().nonnegative(),
+    retries: z.number().int().nonnegative(),
+    service: z.string(),
+    cached: z.boolean().optional(),
+    idempotencyKey: z.string().optional(),
+});
+/**
+ * Schema for an MCP response payload
+ */
+export const MCPResponseSchema = z.object({
+    success: z.boolean(),
+    data: z.unknown().optional(),
+    error: z.string().optional(),
+    metadata: MCPResponseMetadataSchema.optional(),
+});
+/**
+ * Schema for MCP adapter configuration
+ */
+export const MCPAdapterConfigSchema = z.object({
+    apiKey: z.string().optional(),
+    baseUrl: z.string().url().optional(),
+    timeout: z.number().positive().optional(),
+    retries: z.number().int().nonnegative().optional(),
+    environment: z.enum(['development', 'production']).optional(),
+});
+// =============================================================================
+// Tool Definition Bridge
+// =============================================================================
+/**
+ * Converts an MCP SDK tool definition (JSON Schema-based) to a contracts ToolDefinition.
+ *
+ * The MCP SDK uses JSON Schema for tool `inputSchema`, while contracts uses
+ * a structured ToolParameter format. This bridge maps between them.
+ */
+export function mcpToolToContractsToolDefinition(mcpTool) {
+    const parameters = {};
+    if (mcpTool.inputSchema?.properties) {
+        const required = new Set(mcpTool.inputSchema.required ?? []);
+        for (const [key, prop] of Object.entries(mcpTool.inputSchema.properties)) {
+            parameters[key] = {
+                type: prop.type ?? 'string',
+                description: prop.description ?? '',
+                required: required.has(key),
+                ...(prop.default !== undefined && { default: prop.default }),
+                ...(prop.enum && { enum: prop.enum }),
+            };
+        }
+    }
+    return ToolDefinitionSchema.parse({
+        name: mcpTool.name,
+        description: mcpTool.description ?? `MCP tool: ${mcpTool.name}`,
+        parameters,
+        destructive: false,
+    });
+}
+/**
+ * Converts a contracts ToolDefinition back to an MCP SDK-compatible tool shape.
+ * Useful for registering contracts-defined tools with MCP servers.
+ */
+export function contractsToolDefinitionToMcpTool(tool) {
+    const properties = {};
+    const required = [];
+    for (const [key, param] of Object.entries(tool.parameters)) {
+        properties[key] = {
+            type: param.type,
+            description: param.description,
+            ...(param.default !== undefined && { default: param.default }),
+            ...(param.enum && { enum: param.enum }),
+        };
+        if (param.required) {
+            required.push(key);
+        }
+    }
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: {
+            type: 'object',
+            properties,
+            required,
+        },
+    };
+}
+// =============================================================================
+// Agent Card Bridge
+// =============================================================================
+/**
+ * Converts a RevealUI AgentDefinition to a Google A2A AgentCard.
+ * Wraps the contracts-level `agentDefinitionToCard` with optional MCP-specific overrides.
+ *
+ * @param agent - The agent definition (source of truth)
+ * @param baseUrl - The server base URL (e.g. https://api.revealui.com)
+ * @param opts - Optional overrides for auth scheme and streaming capability
+ */
+export function agentDefinitionToAgentCard(agent, baseUrl, opts) {
+    const card = agentDefinitionToCard(agent, baseUrl);
+    if (!opts)
+        return card;
+    const { authScheme, streaming } = opts;
+    return {
+        ...card,
+        ...(authScheme !== undefined && { authentication: authScheme }),
+        capabilities: {
+            ...(card.capabilities ?? {
+                streaming: false,
+                pushNotifications: false,
+                stateTransitionHistory: false,
+            }),
+            streaming: streaming ?? card.capabilities?.streaming ?? false,
+        },
+    };
+}
+/**
+ * Converts all tools in a RevealUI AgentDefinition to MCP tool specs.
+ * Uses `contractsToolDefinitionToMcpTool` for each tool.
+ */
+export function agentDefinitionToMcpTools(agent) {
+    return agent.tools.map(contractsToolDefinitionToMcpTool);
+}
+//# sourceMappingURL=contracts.js.map

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

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

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

@@ -0,0 +1,132 @@
+/**
+ * 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)
+ */
+export interface MCPServerConfig {
+    /** Unique name for this server (used in tool namespacing) */
+    name: string;
+    /** Executable to run (e.g. 'node', 'pnpm') */
+    command: string;
+    /** Arguments to the command */
+    args: string[];
+    /** Additional environment variables */
+    env?: Record<string, string>;
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface NamespacedTool {
+    /** Namespaced name: @@mcp_{serverName}_{toolName} */
+    namespacedName: string;
+    serverName: string;
+    tool: MCPTool;
+}
+/**
+ * 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 declare class MCPHypervisor {
+    private static instance;
+    private servers;
+    private requestCounter;
+    private pendingRequests;
+    private healthCheckTimer;
+    private constructor();
+    static getInstance(): MCPHypervisor;
+    /**
+     * Register an MCP server configuration without starting it.
+     */
+    registerServer(config: MCPServerConfig): void;
+    /**
+     * Unregister a server (stops it first if running).
+     */
+    unregisterServer(name: string): Promise<void>;
+    /**
+     * Spawn the MCP server process with piped stdio.
+     * Tools are discovered via `listServerTools()` after startup.
+     */
+    startServer(name: string): Promise<void>;
+    /**
+     * Stop a running MCP server process.
+     */
+    stopServer(name: string): Promise<void>;
+    /**
+     * Stop all running servers.
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Send a JSON-RPC request to a running server and await the response.
+     */
+    private sendRequest;
+    private handleResponse;
+    /**
+     * Ping a server — checks process liveness and sends a JSON-RPC `ping`.
+     * Updates `entry.healthy`.
+     */
+    pingServer(name: string): Promise<boolean>;
+    /**
+     * Discover tools from a running server via JSON-RPC `tools/list`.
+     * Caches the result in the server entry.
+     */
+    listServerTools(name: string): Promise<MCPTool[]>;
+    /**
+     * Return all tools from all healthy servers, namespaced as
+     * `@@mcp_{serverName}_{toolName}` to avoid collisions.
+     */
+    getAllTools(): NamespacedTool[];
+    /**
+     * 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
+     */
+    callTool(serverName: string, toolName: string, args: unknown): Promise<unknown>;
+    /**
+     * Return the health status of all registered servers.
+     */
+    getStatus(): Record<string, {
+        healthy: boolean;
+        toolCount: number;
+        pid: number | null;
+    }>;
+    private startHealthCheckLoop;
+    private stopHealthCheckLoop;
+    /**
+     * Reset the singleton (for testing only).
+     * @internal
+     */
+    static _resetForTests(): void;
+}
+//# sourceMappingURL=hypervisor.d.ts.map