@revealui/mcp 0.1.3 → 0.1.7

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,iBAAiB,EAAE,CAAC;IAC1B,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CACT,+EAA+E;YAC7E,iDAAiD,CACpD,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mBAAmB;AACnB,OAAO,EAGL,aAAa,EACb,eAAe,EACf,iBAAiB,GAGlB,MAAM,kBAAkB,CAAC;AAC1B,gBAAgB;AAChB,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAC3B,0CAA0C;AAC1C,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAEhC,sBAAsB,EAGtB,uBAAuB,EACvB,gBAAgB,EAGhB,yBAAyB,EACzB,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AACxB,0DAA0D;AAC1D,OAAO,EAEL,aAAa,GAKd,MAAM,iBAAiB,CAAC;AACzB,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,UAAU,EAEV,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,iBAAiB,EAAE,CAAC;IAC1B,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CACT,+EAA+E;YAC7E,iDAAiD,CACpD,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mBAAmB;AACnB,OAAO,EAGL,aAAa,EACb,eAAe,EACf,iBAAiB,GAGlB,MAAM,kBAAkB,CAAC;AAC1B,2DAA2D;AAC3D,OAAO,EACL,iBAAiB,EAEjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,gBAAgB;AAChB,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAC3B,0CAA0C;AAC1C,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAEhC,sBAAsB,EAGtB,uBAAuB,EACvB,gBAAgB,EAGhB,yBAAyB,EACzB,iBAAiB,EACjB,gCAAgC,EAEhC,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,0DAA0D;AAC1D,OAAO,EAEL,aAAa,GAKd,MAAM,iBAAiB,CAAC;AACzB,yCAAyC;AACzC,OAAO,EACL,eAAe,GAIhB,MAAM,eAAe,CAAC;AACvB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,cAAc,GAGf,MAAM,mBAAmB,CAAC;AAC3B,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAE5B,UAAU,EAEV,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,gCAAgC;AAChC,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,8CAA8C;AAC9C,OAAO,EAIL,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Tool Pipeline
+ *
+ * Lightweight tool composition that lets agents chain MCP tool calls
+ * declaratively. Steps execute sequentially, with data flowing between
+ * them via `$ref` parameter references.
+ *
+ * @example
+ * ```typescript
+ * const result = await executePipeline(hypervisor, ctx, [
+ *   {
+ *     label: 'customer',
+ *     tool: '@@mcp_stripe_create_customer',
+ *     params: { email: 'user@example.com' },
+ *   },
+ *   {
+ *     label: 'payment',
+ *     tool: '@@mcp_stripe_create_payment_intent',
+ *     params: {
+ *       customer: { $ref: 'customer.id' },
+ *       amount: 2000,
+ *       currency: 'usd',
+ *     },
+ *   },
+ * ]);
+ * ```
+ */
+import type { MCPHypervisor, MCPTenantContext } from './hypervisor.js';
+export interface PipelineStep {
+    /** Namespaced tool name (e.g., @@mcp_stripe_create_payment_intent) */
+    tool: string;
+    /** Parameters — can reference previous step outputs via $ref syntax */
+    params: Record<string, unknown>;
+    /** Optional: only run if condition is met */
+    when?: (previousResults: Map<string, unknown>) => boolean;
+    /** Step label for referencing in later steps */
+    label?: string;
+}
+export interface PipelineStepResult {
+    label: string;
+    tool: string;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    durationMs: number;
+}
+export interface PipelineResult {
+    success: boolean;
+    steps: PipelineStepResult[];
+    totalDurationMs: number;
+}
+/**
+ * Execute a sequence of tool calls with data flowing between steps.
+ *
+ * Parameter references: use `{ "$ref": "step_label.path.to.value" }`
+ * to reference output from a previous step.
+ *
+ * Tools are identified by their namespaced name (`@@mcp_{server}_{tool}`)
+ * and dispatched through the hypervisor's tenant-scoped call path.
+ */
+export declare function executePipeline(hypervisor: MCPHypervisor, ctx: MCPTenantContext, steps: PipelineStep[]): Promise<PipelineResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMvE,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAC1D,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAYD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,aAAa,EACzB,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,YAAY,EAAE,GACpB,OAAO,CAAC,cAAc,CAAC,CA0EzB"}

package/dist/pipeline.js

@@ -0,0 +1,230 @@
+/**
+ * Tool Pipeline
+ *
+ * Lightweight tool composition that lets agents chain MCP tool calls
+ * declaratively. Steps execute sequentially, with data flowing between
+ * them via `$ref` parameter references.
+ *
+ * @example
+ * ```typescript
+ * const result = await executePipeline(hypervisor, ctx, [
+ *   {
+ *     label: 'customer',
+ *     tool: '@@mcp_stripe_create_customer',
+ *     params: { email: 'user@example.com' },
+ *   },
+ *   {
+ *     label: 'payment',
+ *     tool: '@@mcp_stripe_create_payment_intent',
+ *     params: {
+ *       customer: { $ref: 'customer.id' },
+ *       amount: 2000,
+ *       currency: 'usd',
+ *     },
+ *   },
+ * ]);
+ * ```
+ */
+// =============================================================================
+// Constants
+// =============================================================================
+const MCP_TOOL_PREFIX = '@@mcp_';
+// =============================================================================
+// Pipeline executor
+// =============================================================================
+/**
+ * Execute a sequence of tool calls with data flowing between steps.
+ *
+ * Parameter references: use `{ "$ref": "step_label.path.to.value" }`
+ * to reference output from a previous step.
+ *
+ * Tools are identified by their namespaced name (`@@mcp_{server}_{tool}`)
+ * and dispatched through the hypervisor's tenant-scoped call path.
+ */
+export async function executePipeline(hypervisor, ctx, steps) {
+    const results = new Map();
+    const stepResults = [];
+    const pipelineStart = Date.now();
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        if (!step)
+            continue;
+        const label = step.label ?? `step_${i}`;
+        const stepStart = Date.now();
+        // Check condition
+        if (step.when && !step.when(results)) {
+            stepResults.push({
+                label,
+                tool: step.tool,
+                success: true,
+                data: { skipped: true },
+                durationMs: 0,
+            });
+            continue;
+        }
+        // Resolve $ref parameters
+        const resolvedParams = resolveRefs(step.params, results);
+        try {
+            // Parse the namespaced tool name into server + tool
+            const { serverName, toolName } = parseNamespacedTool(step.tool);
+            // Call the tool through the hypervisor's tenant-scoped path
+            const response = await hypervisor.callToolForTenant(serverName, ctx.tenantId, toolName, resolvedParams);
+            // Attempt to parse text content responses as JSON
+            const data = extractResponseData(response);
+            results.set(label, data);
+            stepResults.push({
+                label,
+                tool: step.tool,
+                success: true,
+                data,
+                durationMs: Date.now() - stepStart,
+            });
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            stepResults.push({
+                label,
+                tool: step.tool,
+                success: false,
+                error: errorMsg,
+                durationMs: Date.now() - stepStart,
+            });
+            // Pipeline fails on first error
+            return {
+                success: false,
+                steps: stepResults,
+                totalDurationMs: Date.now() - pipelineStart,
+            };
+        }
+    }
+    return {
+        success: true,
+        steps: stepResults,
+        totalDurationMs: Date.now() - pipelineStart,
+    };
+}
+// =============================================================================
+// Tool name parsing
+// =============================================================================
+/**
+ * Parse a namespaced tool name like `@@mcp_stripe_create_payment_intent`
+ * into `{ serverName: 'stripe', toolName: 'create_payment_intent' }`.
+ *
+ * The convention is `@@mcp_{serverName}_{toolName}` where the server name
+ * is the first segment after the prefix and the tool name is everything
+ * after it (may contain underscores).
+ */
+function parseNamespacedTool(namespacedName) {
+    if (!namespacedName.startsWith(MCP_TOOL_PREFIX)) {
+        throw new Error(`Invalid tool name "${namespacedName}": must start with "${MCP_TOOL_PREFIX}"`);
+    }
+    const rest = namespacedName.slice(MCP_TOOL_PREFIX.length);
+    const firstUnderscore = rest.indexOf('_');
+    if (firstUnderscore === -1 || firstUnderscore === 0) {
+        throw new Error(`Invalid tool name "${namespacedName}": expected format "${MCP_TOOL_PREFIX}{server}_{tool}"`);
+    }
+    return {
+        serverName: rest.slice(0, firstUnderscore),
+        toolName: rest.slice(firstUnderscore + 1),
+    };
+}
+// =============================================================================
+// Response extraction
+// =============================================================================
+/**
+ * Attempt to extract structured data from an MCP tool response.
+ * If the response contains a text content block with valid JSON, parse it.
+ * Otherwise return the raw response.
+ */
+function extractResponseData(response) {
+    if (typeof response === 'object' &&
+        response !== null &&
+        'content' in response &&
+        Array.isArray(response.content)) {
+        const content = response.content;
+        const first = content[0];
+        if (first &&
+            typeof first === 'object' &&
+            'type' in first &&
+            first.type === 'text' &&
+            'text' in first) {
+            try {
+                return JSON.parse(first.text);
+            }
+            catch {
+                // Not JSON — return raw text
+                return first.text;
+            }
+        }
+    }
+    return response;
+}
+// =============================================================================
+// $ref resolution
+// =============================================================================
+/**
+ * Resolve `$ref` values in params by looking up previous step results.
+ * Format: `{ "$ref": "step_label.path.to.value" }`
+ */
+function resolveRefs(params, results) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (isRef(value)) {
+            resolved[key] = resolveRef(value.$ref, results);
+        }
+        else if (Array.isArray(value)) {
+            resolved[key] = resolveRefsInArray(value, results);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            resolved[key] = resolveRefs(value, results);
+        }
+        else {
+            resolved[key] = value;
+        }
+    }
+    return resolved;
+}
+function resolveRefsInArray(items, results) {
+    return items.map((item) => {
+        if (isRef(item)) {
+            return resolveRef(item.$ref, results);
+        }
+        if (Array.isArray(item)) {
+            return resolveRefsInArray(item, results);
+        }
+        if (typeof item === 'object' && item !== null) {
+            return resolveRefs(item, results);
+        }
+        return item;
+    });
+}
+function isRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        '$ref' in value &&
+        typeof value.$ref === 'string');
+}
+function resolveRef(ref, results) {
+    const parts = ref.split('.');
+    const stepLabel = parts[0];
+    if (!stepLabel) {
+        throw new Error('Pipeline ref error: empty $ref string');
+    }
+    const data = results.get(stepLabel);
+    if (data === undefined) {
+        throw new Error(`Pipeline ref error: step "${stepLabel}" not found`);
+    }
+    let current = data;
+    for (let i = 1; i < parts.length; i++) {
+        if (current === null || current === undefined) {
+            throw new Error(`Pipeline ref error: cannot traverse "${ref}" — null at "${parts.slice(0, i + 1).join('.')}"`);
+        }
+        const segment = parts[i];
+        if (!segment)
+            continue;
+        current = current[segment];
+    }
+    return current;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/rate-limiter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MCP Rate Limiter
+ *
+ * In-memory fixed-window rate limiter scoped by tenant + tier.
+ * For distributed deployments, share state via PGlite or ElectricSQL.
+ *
+ * @example
+ * ```typescript
+ * const limiter = new McpRateLimiter();
+ *
+ * const result = limiter.check('tenant-123', 'pro');
+ * if (!result.allowed) {
+ *   throw new Error(`Rate limited. Retry after ${result.resetMs}ms`);
+ * }
+ * // result.remaining === requests left in window
+ * ```
+ */
+export interface RateLimitConfig {
+    /** Max requests per window */
+    maxRequests: number;
+    /** Window size in milliseconds */
+    windowMs: number;
+}
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    limit: number;
+    resetMs: number;
+}
+/** Default rate limits per tier. */
+export declare const DEFAULT_TIER_LIMITS: Record<string, RateLimitConfig>;
+/**
+ * In-memory fixed-window rate limiter scoped by tenant + tier.
+ * For distributed deployments, share state via PGlite or ElectricSQL.
+ */
+export declare class McpRateLimiter {
+    private windows;
+    private limits;
+    private cleanupInterval;
+    constructor(limits?: Record<string, RateLimitConfig>);
+    /**
+     * Check if a request is allowed and consume one token if so.
+     * Returns quota information including remaining requests and reset time.
+     */
+    check(tenantId: string, tier: string): RateLimitResult;
+    /** Override limits for a specific tier. */
+    setTierLimit(tier: string, config: RateLimitConfig): void;
+    /** Clean up expired window entries. */
+    private cleanup;
+    /** Dispose the rate limiter, clearing the cleanup timer and all windows. */
+    dispose(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAK/D,CAAC;AAeF;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,eAAe,CAA+C;gBAE1D,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAuB;IAOzE;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe;IA4BtD,2CAA2C;IAC3C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAIzD,uCAAuC;IACvC,OAAO,CAAC,OAAO;IAWf,4EAA4E;IAC5E,OAAO,IAAI,IAAI;CAOhB"}

package/dist/rate-limiter.js

@@ -0,0 +1,96 @@
+/**
+ * MCP Rate Limiter
+ *
+ * In-memory fixed-window rate limiter scoped by tenant + tier.
+ * For distributed deployments, share state via PGlite or ElectricSQL.
+ *
+ * @example
+ * ```typescript
+ * const limiter = new McpRateLimiter();
+ *
+ * const result = limiter.check('tenant-123', 'pro');
+ * if (!result.allowed) {
+ *   throw new Error(`Rate limited. Retry after ${result.resetMs}ms`);
+ * }
+ * // result.remaining === requests left in window
+ * ```
+ */
+// =============================================================================
+// Default tier limits
+// =============================================================================
+/** Default rate limits per tier. */
+export const DEFAULT_TIER_LIMITS = {
+    free: { maxRequests: 60, windowMs: 60_000 },
+    pro: { maxRequests: 300, windowMs: 60_000 },
+    max: { maxRequests: 1000, windowMs: 60_000 },
+    enterprise: { maxRequests: 5000, windowMs: 60_000 },
+};
+// =============================================================================
+// Rate limiter
+// =============================================================================
+/**
+ * In-memory fixed-window rate limiter scoped by tenant + tier.
+ * For distributed deployments, share state via PGlite or ElectricSQL.
+ */
+export class McpRateLimiter {
+    windows = new Map();
+    limits;
+    cleanupInterval = null;
+    constructor(limits = DEFAULT_TIER_LIMITS) {
+        this.limits = limits;
+        // Clean up expired windows every 60s
+        this.cleanupInterval = setInterval(() => this.cleanup(), 60_000);
+        if (this.cleanupInterval.unref)
+            this.cleanupInterval.unref();
+    }
+    /**
+     * Check if a request is allowed and consume one token if so.
+     * Returns quota information including remaining requests and reset time.
+     */
+    check(tenantId, tier) {
+        const config = this.limits[tier] ?? this.limits.free ?? { maxRequests: 60, windowMs: 60_000 };
+        const key = `${tenantId}:${tier}`;
+        const now = Date.now();
+        let entry = this.windows.get(key);
+        // New window or expired window
+        if (!entry || now - entry.windowStart >= config.windowMs) {
+            entry = { count: 0, windowStart: now };
+            this.windows.set(key, entry);
+        }
+        const resetMs = config.windowMs - (now - entry.windowStart);
+        if (entry.count >= config.maxRequests) {
+            return { allowed: false, remaining: 0, limit: config.maxRequests, resetMs };
+        }
+        entry.count++;
+        return {
+            allowed: true,
+            remaining: Math.max(0, config.maxRequests - entry.count),
+            limit: config.maxRequests,
+            resetMs,
+        };
+    }
+    /** Override limits for a specific tier. */
+    setTierLimit(tier, config) {
+        this.limits[tier] = config;
+    }
+    /** Clean up expired window entries. */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.windows) {
+            const tier = key.split(':')[1] ?? 'free';
+            const config = this.limits[tier] ?? { windowMs: 60_000 };
+            if (now - entry.windowStart >= config.windowMs * 2) {
+                this.windows.delete(key);
+            }
+        }
+    }
+    /** Dispose the rate limiter, clearing the cleanup timer and all windows. */
+    dispose() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.windows.clear();
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limiter.js.map

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

package/dist/servers/_launcher-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * MCP Launcher Utilities
+ *
+ * Self-contained logger and exit codes for MCP server launcher scripts.
+ * Replaces the @revealui/scripts dependency so the MCP package has no
+ * cross-package imports beyond its own declared dependencies.
+ */
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly CONFIG_ERROR: 2;
+    readonly EXECUTION_ERROR: 3;
+};
+export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+interface LauncherLogger {
+    info(msg: string): void;
+    error(msg: string): void;
+    warning(msg: string): void;
+    success(msg: string): void;
+    header(msg: string): void;
+}
+/**
+ * Create a lightweight launcher logger that writes to stderr
+ * (so it doesn't interfere with MCP JSON-RPC on stdout).
+ */
+export declare function createLauncherLogger(): LauncherLogger;
+export {};
+//# sourceMappingURL=_launcher-utils.d.ts.map

package/dist/servers/_launcher-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_launcher-utils.d.ts","sourceRoot":"","sources":["../../src/servers/_launcher-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAMhE,UAAU,cAAc;IACtB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAuBrD"}

package/dist/servers/_launcher-utils.js

@@ -0,0 +1,45 @@
+/**
+ * MCP Launcher Utilities
+ *
+ * Self-contained logger and exit codes for MCP server launcher scripts.
+ * Replaces the @revealui/scripts dependency so the MCP package has no
+ * cross-package imports beyond its own declared dependencies.
+ */
+// =============================================================================
+// Exit Codes
+// =============================================================================
+export const ExitCode = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    CONFIG_ERROR: 2,
+    EXECUTION_ERROR: 3,
+};
+/**
+ * Create a lightweight launcher logger that writes to stderr
+ * (so it doesn't interfere with MCP JSON-RPC on stdout).
+ */
+export function createLauncherLogger() {
+    return {
+        info(msg) {
+            // biome-ignore lint/suspicious/noConsole: MCP launcher logger intentionally writes to stderr
+            console.error(`\x1b[36m[mcp]\x1b[0m ${msg}`); // console-allowed
+        },
+        error(msg) {
+            // biome-ignore lint/suspicious/noConsole: MCP launcher logger intentionally writes to stderr
+            console.error(`\x1b[31m[mcp] ERROR:\x1b[0m ${msg}`); // console-allowed
+        },
+        warning(msg) {
+            // biome-ignore lint/suspicious/noConsole: MCP launcher logger intentionally writes to stderr
+            console.error(`\x1b[33m[mcp] WARN:\x1b[0m ${msg}`); // console-allowed
+        },
+        success(msg) {
+            // biome-ignore lint/suspicious/noConsole: MCP launcher logger intentionally writes to stderr
+            console.error(`\x1b[32m[mcp]\x1b[0m ${msg}`); // console-allowed
+        },
+        header(msg) {
+            // biome-ignore lint/suspicious/noConsole: MCP launcher logger intentionally writes to stderr
+            console.error(`\n\x1b[1m\x1b[36m${msg}\x1b[0m\n`); // console-allowed
+        },
+    };
+}
+//# sourceMappingURL=_launcher-utils.js.map

package/dist/servers/_launcher-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_launcher-utils.js","sourceRoot":"","sources":["../../src/servers/_launcher-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,eAAe,EAAE,CAAC;CACV,CAAC;AAgBX;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,CAAC,GAAW;YACd,6FAA6F;YAC7F,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC,CAAC,kBAAkB;QAClE,CAAC;QACD,KAAK,CAAC,GAAW;YACf,6FAA6F;YAC7F,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC,CAAC,kBAAkB;QACzE,CAAC;QACD,OAAO,CAAC,GAAW;YACjB,6FAA6F;YAC7F,OAAO,CAAC,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC,CAAC,kBAAkB;QACxE,CAAC;QACD,OAAO,CAAC,GAAW;YACjB,6FAA6F;YAC7F,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC,CAAC,kBAAkB;QAClE,CAAC;QACD,MAAM,CAAC,GAAW;YAChB,6FAA6F;YAC7F,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,WAAW,CAAC,CAAC,CAAC,kBAAkB;QACvE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/servers/adapter.d.ts

@@ -50,21 +50,37 @@ export interface MCPResponse {
         idempotencyKey?: string;
     };
 }
+/**
+ * Persistent backend for idempotency cache.
+ * Implementations handle their own TTL expiration for stored entries.
+ */
+export interface IdempotencyStore {
+    get(key: string): Promise<{
+        response: MCPResponse;
+        expiresAt: number;
+    } | null>;
+    set(key: string, response: MCPResponse, ttlMs: number): Promise<void>;
+    delete(key: string): Promise<void>;
+}
 /**
  * In-memory idempotency cache for preventing duplicate operations.
- * Each adapter instance has its own cache.
+ * Each adapter instance has its own cache. Optionally backed by a
+ * persistent {@link IdempotencyStore} for cross-process durability.
  */
 declare class IdempotencyCache {
     private cache;
+    private store;
     private cleanupInterval;
     private readonly DEFAULT_TTL;
-    constructor();
+    constructor(store?: IdempotencyStore);
     /**
-     * Get a cached response by idempotency key
+     * Get a cached response by idempotency key.
+     * Checks memory first, then falls through to the persistent store.
      */
-    get(key: string): MCPResponse | null;
+    get(key: string): Promise<MCPResponse | null>;
     /**
-     * Store a response with idempotency key
+     * Store a response with idempotency key.
+     * Writes to both memory and the persistent store (if configured).
      */
     set(key: string, response: MCPResponse, ttl?: number): void;
     /**
@@ -72,7 +88,7 @@ declare class IdempotencyCache {
      */
     has(key: string): boolean;
     /**
-     * Remove expired entries
+     * Remove expired entries (memory only — store manages its own TTL)
      */
     private cleanup;
     /**

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

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