@revealui/mcp 0.1.1 → 0.1.5

package/dist/servers/stripe.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env tsx
+/**
+ * Stripe MCP Server Launcher
+ *
+ * Starts the Stripe MCP server for AI-powered payment management.
+ *
+ * Usage:
+ *   pnpm mcp:stripe
+ */
+/**
+ * Launch the Stripe MCP server.
+ * Exported for programmatic use by the Hypervisor.
+ */
+export declare function launchStripeMcp(): Promise<void>;
+//# sourceMappingURL=stripe.d.ts.map

package/dist/servers/stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/servers/stripe.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAmEH;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrD"}

package/dist/servers/stripe.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env tsx
+/**
+ * Stripe MCP Server Launcher
+ *
+ * Starts the Stripe MCP server for AI-powered payment management.
+ *
+ * Usage:
+ *   pnpm mcp:stripe
+ */
+import { spawn } from 'node:child_process';
+import { config } from 'dotenv';
+import { checkMcpLicense } from '../index.js';
+import { createLauncherLogger, ExitCode } from './_launcher-utils.js';
+const logger = createLauncherLogger();
+// Load environment variables
+config();
+const MAX_RESTARTS = 3;
+const RESTART_DELAYS_MS = [2000, 4000, 8000];
+async function spawnStripe(stripeSecretKey) {
+    return new Promise((resolve) => {
+        const child = spawn('pnpm', ['dlx', '@stripe/mcp', '--tools=all'], {
+            stdio: 'inherit',
+            env: { ...process.env, STRIPE_SECRET_KEY: stripeSecretKey },
+        });
+        child.on('error', (error) => {
+            logger.error(`Failed to start Stripe MCP server: ${error.message}`);
+            resolve(ExitCode.CONFIG_ERROR);
+        });
+        child.on('exit', (code) => resolve(code ?? 0));
+        process.on('SIGINT', () => {
+            child.kill('SIGINT');
+        });
+        process.on('SIGTERM', () => {
+            child.kill('SIGTERM');
+        });
+    });
+}
+async function startStripeMCP() {
+    const stripeSecretKey = process.env.STRIPE_SECRET_KEY;
+    if (!stripeSecretKey) {
+        logger.error('STRIPE_SECRET_KEY environment variable is required');
+        logger.info('   Get your key from: https://dashboard.stripe.com/apikeys');
+        process.exit(ExitCode.CONFIG_ERROR);
+    }
+    const withRestart = process.argv.includes('--restart');
+    logger.header('Starting Stripe MCP Server');
+    logger.info(`   Secret Key: ${stripeSecretKey.substring(0, 12)}...`);
+    if (withRestart)
+        logger.info('   Restart mode: enabled (up to 3 attempts)');
+    let attempt = 0;
+    while (true) {
+        const code = await spawnStripe(stripeSecretKey);
+        if (!withRestart || attempt >= MAX_RESTARTS) {
+            process.exit(code ?? 0);
+        }
+        const delay = RESTART_DELAYS_MS[attempt] ?? 8000;
+        attempt++;
+        logger.warning(`   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MAX_RESTARTS})...`);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+}
+/**
+ * Launch the Stripe MCP server.
+ * Exported for programmatic use by the Hypervisor.
+ */
+export async function launchStripeMcp() {
+    if (!(await checkMcpLicense())) {
+        throw new Error('MCP license check failed');
+    }
+    await startStripeMCP();
+}
+/**
+ * Main function (CLI entrypoint)
+ */
+async function main() {
+    try {
+        await launchStripeMcp();
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ExitCode.EXECUTION_ERROR);
+    }
+}
+main();
+//# sourceMappingURL=stripe.js.map

package/dist/servers/stripe.js.map

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

package/dist/servers/supabase.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env tsx
+/**
+ * Supabase MCP Server Launcher
+ *
+ * Starts the Supabase MCP server for AI-powered database management.
+ *
+ * Usage:
+ *   pnpm mcp:supabase
+ */
+/**
+ * Launch the Supabase MCP server.
+ * Exported for programmatic use by the Hypervisor.
+ */
+export declare function launchSupabaseMcp(): Promise<void>;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/servers/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/servers/supabase.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAiIH;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD"}

package/dist/servers/supabase.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env tsx
+/**
+ * Supabase MCP Server Launcher
+ *
+ * Starts the Supabase MCP server for AI-powered database management.
+ *
+ * Usage:
+ *   pnpm mcp:supabase
+ */
+import { spawn } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { config } from 'dotenv';
+import { checkMcpLicense } from '../index.js';
+import { createLauncherLogger, ExitCode } from './_launcher-utils.js';
+const logger = createLauncherLogger();
+// Load environment variables
+config();
+async function startSupabaseMCP() {
+    // Supabase MCP uses local package supabase-mcp
+    // Verified: Package expects SUPABASE_URL, SUPABASE_ANON_KEY, and SUPABASE_SERVICE_ROLE_KEY
+    // Source: node_modules/supabase-mcp/dist/esm/config.js and services/supabase.js
+    //
+    // NEW API KEY SUPPORT (2025):
+    // Supabase introduced new API keys: sb_publishable_... (replaces anon) and sb_secret_... (replaces service_role)
+    // Legacy keys (anon/service_role JWT) still work but will be deprecated in Nov 2025
+    // The @supabase/supabase-js client accepts any key format, so we support both
+    // Reference: https://github.com/orgs/supabase/discussions/29260
+    const supabaseUrl = process.env.SUPABASE_URL;
+    // Support both legacy and new API key formats
+    // New format: SUPABASE_PUBLISHABLE_KEY (sb_publishable_...) or SUPABASE_ANON_KEY (legacy)
+    // New format: SUPABASE_SECRET_KEY (sb_secret_...) or SUPABASE_SERVICE_ROLE_KEY (legacy)
+    const supabaseAnonKey = process.env.SUPABASE_PUBLISHABLE_KEY || process.env.SUPABASE_ANON_KEY;
+    const supabaseServiceRoleKey = process.env.SUPABASE_SECRET_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY;
+    if (!supabaseUrl) {
+        logger.error('SUPABASE_URL is required');
+        logger.info('   Get your credentials from: https://supabase.com/dashboard → Settings → API');
+        process.exit(ExitCode.CONFIG_ERROR);
+    }
+    if (!supabaseAnonKey) {
+        logger.error('SUPABASE_ANON_KEY or SUPABASE_PUBLISHABLE_KEY is required');
+        logger.info('   Legacy: SUPABASE_ANON_KEY (anon JWT key)');
+        logger.info('   New: SUPABASE_PUBLISHABLE_KEY (sb_publishable_... key)');
+        logger.info('   Get from: https://supabase.com/dashboard → Settings → API');
+        process.exit(ExitCode.CONFIG_ERROR);
+    }
+    if (!supabaseServiceRoleKey) {
+        logger.error('SUPABASE_SERVICE_ROLE_KEY or SUPABASE_SECRET_KEY is required');
+        logger.info('   Legacy: SUPABASE_SERVICE_ROLE_KEY (service_role JWT key)');
+        logger.info('   New: SUPABASE_SECRET_KEY (sb_secret_... key)');
+        logger.info('   Note: Required for MCP server operations (full database access)');
+        logger.info('   Get from: https://supabase.com/dashboard → Settings → API');
+        process.exit(ExitCode.CONFIG_ERROR);
+    }
+    // MCP_API_KEY is required by supabase-mcp package for server authentication
+    // This is NOT a Supabase key - it's a key you generate yourself to secure the MCP server
+    let mcpApiKey = process.env.MCP_API_KEY;
+    if (!mcpApiKey) {
+        // Auto-generate a secure random key if not provided
+        mcpApiKey = randomBytes(32).toString('hex');
+        logger.warning('MCP_API_KEY not set - auto-generated a secure key');
+        logger.warning('   Add this to your .env file to persist it:');
+        logger.warning(`   MCP_API_KEY=${mcpApiKey}`);
+        logger.warning('   (This key secures your MCP server endpoint)');
+    }
+    const withRestart = process.argv.includes('--restart');
+    logger.header('Starting Supabase MCP Server (Local)');
+    logger.info(`   Supabase URL: ${supabaseUrl}`);
+    if (withRestart)
+        logger.info('   Restart mode: enabled (up to 3 attempts)');
+    // Detect key format for logging
+    const usingNewKeys = process.env.SUPABASE_PUBLISHABLE_KEY || process.env.SUPABASE_SECRET_KEY;
+    if (usingNewKeys) {
+        logger.info('   Using new API key format (sb_publishable_/sb_secret_)');
+    }
+    else {
+        logger.info('   Using legacy API key format (anon/service_role JWT)');
+        logger.warning('   Consider migrating to new keys before Nov 2025');
+        logger.info('   See: https://github.com/orgs/supabase/discussions/29260');
+    }
+    // Build env once — used for all spawn attempts
+    // Package validates: SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, MCP_API_KEY
+    // We map new keys to legacy variable names for package compatibility
+    const spawnEnv = {
+        ...process.env,
+        SUPABASE_URL: supabaseUrl,
+        SUPABASE_ANON_KEY: supabaseAnonKey,
+        SUPABASE_SERVICE_ROLE_KEY: supabaseServiceRoleKey,
+        MCP_API_KEY: mcpApiKey,
+        SUPABASE_PUBLISHABLE_KEY: process.env.SUPABASE_PUBLISHABLE_KEY,
+        SUPABASE_SECRET_KEY: process.env.SUPABASE_SECRET_KEY,
+    };
+    const MaxRestarts = 3;
+    const RestartDelaysMs = [2000, 4000, 8000];
+    const spawnSupabase = () => new Promise((resolve) => {
+        const child = spawn('pnpm', ['dlx', 'supabase-mcp'], { stdio: 'inherit', env: spawnEnv });
+        child.on('error', (error) => {
+            logger.error(`Failed to start Supabase MCP server: ${error.message}`);
+            resolve(ExitCode.CONFIG_ERROR);
+        });
+        child.on('exit', (code) => resolve(code ?? 0));
+        process.on('SIGINT', () => {
+            child.kill('SIGINT');
+        });
+        process.on('SIGTERM', () => {
+            child.kill('SIGTERM');
+        });
+    });
+    let attempt = 0;
+    while (true) {
+        const code = await spawnSupabase();
+        if (!withRestart || attempt >= MaxRestarts) {
+            process.exit(code ?? 0);
+        }
+        const delay = RestartDelaysMs[attempt] ?? 8000;
+        attempt++;
+        logger.warning(`   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MaxRestarts})...`);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+}
+/**
+ * Launch the Supabase MCP server.
+ * Exported for programmatic use by the Hypervisor.
+ */
+export async function launchSupabaseMcp() {
+    if (!(await checkMcpLicense())) {
+        throw new Error('MCP license check failed');
+    }
+    await startSupabaseMCP();
+}
+/**
+ * Main function (CLI entrypoint)
+ */
+async function main() {
+    try {
+        await launchSupabaseMcp();
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ExitCode.EXECUTION_ERROR);
+    }
+}
+main();
+//# sourceMappingURL=supabase.js.map

package/dist/servers/supabase.js.map

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

package/dist/servers/vercel.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env tsx
+/**
+ * Vercel MCP Server Launcher
+ *
+ * Starts the Vercel MCP server for AI-powered Vercel management.
+ *
+ * Usage:
+ *   pnpm mcp:vercel
+ */
+/**
+ * Launch the Vercel MCP server.
+ * Exported for programmatic use by the Hypervisor.
+ */
+export declare function launchVercelMcp(): Promise<void>;
+//# sourceMappingURL=vercel.d.ts.map

package/dist/servers/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../src/servers/vercel.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAoEH;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrD"}

package/dist/servers/vercel.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env tsx
+/**
+ * Vercel MCP Server Launcher
+ *
+ * Starts the Vercel MCP server for AI-powered Vercel management.
+ *
+ * Usage:
+ *   pnpm mcp:vercel
+ */
+import { spawn } from 'node:child_process';
+import { config } from 'dotenv';
+import { checkMcpLicense } from '../index.js';
+import { createLauncherLogger, ExitCode } from './_launcher-utils.js';
+const logger = createLauncherLogger();
+// Load environment variables
+config();
+const MAX_RESTARTS = 3;
+const RESTART_DELAYS_MS = [2000, 4000, 8000];
+async function spawnVercel(vercelApiKey) {
+    return new Promise((resolve) => {
+        // Pass credentials via environment only — never as CLI arguments (visible in ps aux).
+        const child = spawn('pnpm', ['exec', 'vercel-mcp'], {
+            stdio: 'inherit',
+            env: { ...process.env, VERCEL_API_KEY: vercelApiKey },
+        });
+        child.on('error', (error) => {
+            logger.error(`Failed to start Vercel MCP server: ${error.message}`);
+            resolve(ExitCode.CONFIG_ERROR);
+        });
+        child.on('exit', (code) => resolve(code ?? 0));
+        process.on('SIGINT', () => {
+            child.kill('SIGINT');
+        });
+        process.on('SIGTERM', () => {
+            child.kill('SIGTERM');
+        });
+    });
+}
+async function startVercelMCP() {
+    const vercelApiKey = process.env.VERCEL_API_KEY ?? process.env.VERCEL_TOKEN;
+    if (!vercelApiKey) {
+        logger.error('VERCEL_API_KEY environment variable is required');
+        logger.info('   Get your token from: https://vercel.com/account/tokens');
+        process.exit(ExitCode.CONFIG_ERROR);
+    }
+    const withRestart = process.argv.includes('--restart');
+    logger.header('Starting Vercel MCP Server');
+    logger.info(`   API Key: ${vercelApiKey.substring(0, 8)}...`);
+    if (withRestart)
+        logger.info('   Restart mode: enabled (up to 3 attempts)');
+    let attempt = 0;
+    while (true) {
+        const code = await spawnVercel(vercelApiKey);
+        if (!withRestart || attempt >= MAX_RESTARTS) {
+            process.exit(code ?? 0);
+        }
+        const delay = RESTART_DELAYS_MS[attempt] ?? 8000;
+        attempt++;
+        logger.warning(`   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MAX_RESTARTS})...`);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+}
+/**
+ * Launch the Vercel MCP server.
+ * Exported for programmatic use by the Hypervisor.
+ */
+export async function launchVercelMcp() {
+    if (!(await checkMcpLicense())) {
+        throw new Error('MCP license check failed');
+    }
+    await startVercelMCP();
+}
+/**
+ * Main function (CLI entrypoint)
+ */
+async function main() {
+    try {
+        await launchVercelMcp();
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ExitCode.EXECUTION_ERROR);
+    }
+}
+main();
+//# sourceMappingURL=vercel.js.map

package/dist/servers/vercel.js.map

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

package/dist/stores/postgres-idempotency.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Postgres-backed Idempotency Store
+ *
+ * Persistent implementation of the {@link IdempotencyStore} interface
+ * using a PostgreSQL table. Stores MCP responses keyed by idempotency
+ * key with automatic TTL expiration via a `expires_at` column.
+ *
+ * Table schema (auto-created on first use):
+ *   mcp_idempotency_cache (
+ *     key        TEXT PRIMARY KEY,
+ *     response   JSONB NOT NULL,
+ *     expires_at TIMESTAMPTZ NOT NULL
+ *   )
+ */
+import type { IdempotencyStore } from '../servers/adapter.js';
+interface PgClient {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+    }>;
+}
+/**
+ * Create a Postgres-backed idempotency store.
+ *
+ * @param client - Any object with a `.query(text, values?)` method
+ *                 (e.g. `pg.Pool`, `pg.Client`, `@neondatabase/serverless` pool).
+ * @param opts   - Optional configuration
+ */
+export declare function createPostgresIdempotencyStore(client: PgClient, opts?: {
+    ensureTable?: boolean;
+}): IdempotencyStore;
+export {};
+//# sourceMappingURL=postgres-idempotency.d.ts.map

package/dist/stores/postgres-idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-idempotency.d.ts","sourceRoot":"","sources":["../../src/stores/postgres-idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,uBAAuB,CAAC;AAE3E,UAAU,QAAQ;IAChB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;CACvF;AAYD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,QAAQ,EAChB,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,gBAAgB,CAwClB"}

package/dist/stores/postgres-idempotency.js

@@ -0,0 +1,63 @@
+/**
+ * Postgres-backed Idempotency Store
+ *
+ * Persistent implementation of the {@link IdempotencyStore} interface
+ * using a PostgreSQL table. Stores MCP responses keyed by idempotency
+ * key with automatic TTL expiration via a `expires_at` column.
+ *
+ * Table schema (auto-created on first use):
+ *   mcp_idempotency_cache (
+ *     key        TEXT PRIMARY KEY,
+ *     response   JSONB NOT NULL,
+ *     expires_at TIMESTAMPTZ NOT NULL
+ *   )
+ */
+const TABLE = 'mcp_idempotency_cache';
+const CREATE_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLE} (
+    key        TEXT PRIMARY KEY,
+    response   JSONB NOT NULL,
+    expires_at TIMESTAMPTZ NOT NULL
+  );
+`;
+/**
+ * Create a Postgres-backed idempotency store.
+ *
+ * @param client - Any object with a `.query(text, values?)` method
+ *                 (e.g. `pg.Pool`, `pg.Client`, `@neondatabase/serverless` pool).
+ * @param opts   - Optional configuration
+ */
+export function createPostgresIdempotencyStore(client, opts) {
+    let tableEnsured = opts?.ensureTable === false;
+    async function ensureTable() {
+        if (tableEnsured)
+            return;
+        await client.query(CREATE_TABLE_SQL);
+        tableEnsured = true;
+    }
+    return {
+        async get(key) {
+            await ensureTable();
+            const { rows } = await client.query(`SELECT response, expires_at FROM ${TABLE} WHERE key = $1 AND expires_at > NOW()`, [key]);
+            const row = rows[0];
+            if (!row)
+                return null;
+            return {
+                response: row.response,
+                expiresAt: new Date(row.expires_at).getTime(),
+            };
+        },
+        async set(key, response, ttlMs) {
+            await ensureTable();
+            const expiresAt = new Date(Date.now() + ttlMs).toISOString();
+            await client.query(`INSERT INTO ${TABLE} (key, response, expires_at)
+         VALUES ($1, $2, $3)
+         ON CONFLICT (key) DO UPDATE SET response = $2, expires_at = $3`, [key, JSON.stringify(response), expiresAt]);
+        },
+        async delete(key) {
+            await ensureTable();
+            await client.query(`DELETE FROM ${TABLE} WHERE key = $1`, [key]);
+        },
+    };
+}
+//# sourceMappingURL=postgres-idempotency.js.map

package/dist/stores/postgres-idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-idempotency.js","sourceRoot":"","sources":["../../src/stores/postgres-idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,MAAM,KAAK,GAAG,uBAAuB,CAAC;AAEtC,MAAM,gBAAgB,GAAG;+BACM,KAAK;;;;;CAKnC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAAgB,EAChB,IAAgC;IAEhC,IAAI,YAAY,GAAG,IAAI,EAAE,WAAW,KAAK,KAAK,CAAC;IAE/C,KAAK,UAAU,WAAW;QACxB,IAAI,YAAY;YAAE,OAAO;QACzB,MAAM,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACrC,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CACjC,oCAAoC,KAAK,wCAAwC,EACjF,CAAC,GAAG,CAAC,CACN,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,GAAG,CAAC,QAAuB;gBACrC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAoB,CAAC,CAAC,OAAO,EAAE;aACxD,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,QAAqB,EAAE,KAAa;YACzD,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7D,MAAM,MAAM,CAAC,KAAK,CAChB,eAAe,KAAK;;wEAE4C,EAChE,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAC3C,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,KAAK,CAAC,eAAe,KAAK,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MCP Telemetry
+ *
+ * Structured event emitter for MCP operations. Supports multiple
+ * subscribers and provides convenience methods for common event types.
+ *
+ * @example
+ * ```typescript
+ * const telemetry = McpTelemetry.getInstance();
+ *
+ * // Register a JSON-lines handler
+ * telemetry.on(McpTelemetry.createJsonLogHandler());
+ *
+ * // Emit events
+ * telemetry.toolInvoke('stripe', 'create_customer', 'tenant-1', 'pro');
+ * telemetry.toolComplete('stripe', 'create_customer', true, 42, {
+ *   tenant: 'tenant-1',
+ * });
+ * ```
+ */
+export type McpEventType = 'tool.invoke' | 'tool.complete' | 'tool.error' | 'pipeline.start' | 'pipeline.complete' | 'server.start' | 'server.stop' | 'server.health' | 'auth.validate' | 'cache.hit' | 'cache.miss';
+export interface McpEvent {
+    type: McpEventType;
+    timestamp: number;
+    server?: string;
+    tool?: string;
+    tenant?: string;
+    tier?: string;
+    durationMs?: number;
+    success?: boolean;
+    cached?: boolean;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export type McpEventHandler = (event: McpEvent) => void;
+/**
+ * Simple event emitter for MCP telemetry.
+ * Supports multiple subscribers and structured event types.
+ * Default handler logs to structured JSON on stderr.
+ */
+export declare class McpTelemetry {
+    private handlers;
+    private static instance;
+    static getInstance(): McpTelemetry;
+    /** Register an event handler. Returns an unsubscribe function. */
+    on(handler: McpEventHandler): () => void;
+    /** Emit an event to all registered handlers. */
+    emit(event: McpEvent): void;
+    /** Convenience: emit a tool invocation event. */
+    toolInvoke(server: string, tool: string, tenant?: string, tier?: string): void;
+    /** Convenience: emit a tool completion event. */
+    toolComplete(server: string, tool: string, success: boolean, durationMs: number, opts?: {
+        tenant?: string;
+        cached?: boolean;
+        error?: string;
+    }): void;
+    /** Create a JSON-lines log handler (writes to stderr). */
+    static createJsonLogHandler(): McpEventHandler;
+    /**
+     * Create an OpenTelemetry-compatible span handler stub.
+     * Pass your own tracer instance to wire real OTel export.
+     */
+    static createOtelHandler(tracer?: OtelTracerLike): McpEventHandler;
+    /** Reset singleton (for testing). */
+    static reset(): void;
+}
+/** Minimal OTel tracer shape — avoids requiring @opentelemetry/api as a dependency. */
+interface OtelTracerLike {
+    startSpan(name: string): {
+        end(): void;
+        setAttribute(key: string, value: unknown): void;
+    };
+}
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,eAAe,GACf,eAAe,GACf,WAAW,GACX,YAAY,CAAC;AAEjB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAMxD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC,kEAAkE;IAClE,EAAE,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI;IAOxC,gDAAgD;IAChD,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAU3B,iDAAiD;IACjD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAW9E,iDAAiD;IACjD,YAAY,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,IAAI;IAYP,0DAA0D;IAC1D,MAAM,CAAC,oBAAoB,IAAI,eAAe;IAM9C;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,eAAe;IAYlE,qCAAqC;IACrC,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB;AAMD,uFAAuF;AACvF,UAAU,cAAc;IACtB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;QACvB,GAAG,IAAI,IAAI,CAAC;QACZ,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;KACjD,CAAC;CACH"}