@revealui/mcp 0.1.7 → 0.1.9

package/dist/hypervisor.d.ts

@@ -159,7 +159,7 @@ export declare class MCPHypervisor {
     /**
      * Start an MCP server with tenant-specific credentials.
      * Each tenant gets its own isolated server process with credentials
-     * resolved from the database (BYOK keys or platform defaults).
+     * resolved from the database (stored keys or platform defaults).
      *
      * Server instances are keyed by `${tenantId}:${serverName}`.
      */

package/dist/hypervisor.js

@@ -371,7 +371,7 @@ export class MCPHypervisor {
     /**
      * Start an MCP server with tenant-specific credentials.
      * Each tenant gets its own isolated server process with credentials
-     * resolved from the database (BYOK keys or platform defaults).
+     * resolved from the database (stored keys or platform defaults).
      *
      * Server instances are keyed by `${tenantId}:${serverName}`.
      */

package/dist/index.d.ts

@@ -4,10 +4,10 @@
  * Model Context Protocol integrations for RevealUI.
  *
  * Provides:
- * - MCP hypervisor: process management, tool discovery, health checks (production-ready)
- * - MCP adapter framework: base class with retry, idempotency, error handling (production-ready)
- * - Database adapter: PGlite / PostgreSQL with CRDT support (production-ready)
- * - MCP contracts: Zod schemas for request/response/tool bridging (production-ready)
+ * - MCP hypervisor: process management, tool discovery, health checks (pre-wired)
+ * - MCP adapter framework: base class with retry, idempotency, error handling (pre-wired)
+ * - Database adapter: PGlite / PostgreSQL with CRDT support (pre-wired)
+ * - MCP contracts: Zod schemas for request/response/tool bridging (pre-wired)
  *
  * Server adapter status:
  * - NeonAdapter, StripeAdapter, VercelAdapter: scaffolded (adapter config + error mapping only,
@@ -27,7 +27,8 @@ export { getMcpConfig, type McpConfig as McpEnvConfig, type McpMetricsMode, } fr
 export { agentDefinitionToAgentCard, agentDefinitionToMcpTools, contractsToolDefinitionToMcpTool, type MCPAdapterConfig, MCPAdapterConfigSchema, type MCPRequest, type MCPRequestOptions, MCPRequestOptionsSchema, MCPRequestSchema, type MCPResponse, type MCPResponseMetadata, MCPResponseMetadataSchema, MCPResponseSchema, mcpToolToContractsToolDefinition, type ToolOutputSchemaName, ToolOutputSchemas, validateToolOutput, } from './contracts.js';
 export { type MCPCredentialResolver, MCPHypervisor, type MCPServerConfig, type MCPTenantContext, type MCPTool, type NamespacedTool, } from './hypervisor.js';
 export { executePipeline, type PipelineResult, type PipelineStep, type PipelineStepResult, } from './pipeline.js';
-export { DEFAULT_TIER_LIMITS, McpRateLimiter, type RateLimitConfig, type RateLimitResult, } from './rate-limiter.js';
+export { InMemoryRateLimitStore, PGliteRateLimitStore, type RateLimitStore, type WindowEntry, } from './rate-limit-store.js';
+export { DEFAULT_TIER_LIMITS, McpRateLimiter, type McpRateLimiterOptions, type RateLimitConfig, type RateLimitResult, } from './rate-limiter.js';
 export { createMCPAdapter, disposeAllAdapters, generateIdempotencyKey, generateUniqueIdempotencyKey, type IdempotencyStore, MCPAdapter, type MCPConfig, NeonAdapter, StripeAdapter, VercelAdapter, } from './servers/adapter.js';
 export { launchNeonMcp } from './servers/neon.js';
 export { launchNextDevtoolsMcp } from './servers/next-devtools.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;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,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,IAAI,YAAY,EAC9B,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAE3B,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,EAChC,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,qBAAqB,EAC1B,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,UAAU,EACV,KAAK,SAAS,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,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;AAEtD,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAElF,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;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,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,IAAI,YAAY,EAC9B,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAE3B,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,EAChC,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,qBAAqB,EAC1B,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,UAAU,EACV,KAAK,SAAS,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,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;AAEtD,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAElF,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -4,10 +4,10 @@
  * Model Context Protocol integrations for RevealUI.
  *
  * Provides:
- * - MCP hypervisor: process management, tool discovery, health checks (production-ready)
- * - MCP adapter framework: base class with retry, idempotency, error handling (production-ready)
- * - Database adapter: PGlite / PostgreSQL with CRDT support (production-ready)
- * - MCP contracts: Zod schemas for request/response/tool bridging (production-ready)
+ * - MCP hypervisor: process management, tool discovery, health checks (pre-wired)
+ * - MCP adapter framework: base class with retry, idempotency, error handling (pre-wired)
+ * - Database adapter: PGlite / PostgreSQL with CRDT support (pre-wired)
+ * - MCP contracts: Zod schemas for request/response/tool bridging (pre-wired)
  *
  * Server adapter status:
  * - NeonAdapter, StripeAdapter, VercelAdapter: scaffolded (adapter config + error mapping only,
@@ -44,6 +44,8 @@ export { agentDefinitionToAgentCard, agentDefinitionToMcpTools, contractsToolDef
 export { MCPHypervisor, } from './hypervisor.js';
 // Tool pipeline (composition / chaining)
 export { executePipeline, } from './pipeline.js';
+// Rate limit stores (pluggable backends)
+export { InMemoryRateLimitStore, PGliteRateLimitStore, } from './rate-limit-store.js';
 // Rate limiting (per-tier)
 export { DEFAULT_TIER_LIMITS, McpRateLimiter, } from './rate-limiter.js';
 // Adapter framework

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,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"}
+{"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,yCAAyC;AACzC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAC/B,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,cAAc,GAIf,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/rate-limit-store.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Rate Limit Store — Pluggable backends for rate limiter state.
+ *
+ * - InMemoryRateLimitStore: Map-backed, zero-dep, single-instance (default)
+ * - PGliteRateLimitStore: PostgreSQL-backed via PGlite, supports per-instance
+ *   persistence and can be extended with ElectricSQL for distributed sync.
+ */
+export interface WindowEntry {
+    count: number;
+    windowStart: number;
+}
+/**
+ * Pluggable storage backend for rate limiter window entries.
+ * Implementations must handle TTL-based expiry internally.
+ */
+export interface RateLimitStore {
+    /** Get the current window entry for a key, or null if expired/missing. */
+    get(key: string): Promise<WindowEntry | null>;
+    /** Set or overwrite the window entry for a key. */
+    set(key: string, entry: WindowEntry): Promise<void>;
+    /** Increment the count for a key. Returns the new count. */
+    increment(key: string): Promise<number>;
+    /**
+     * Atomically increment count only if below limit.
+     * Returns the new count and whether the increment happened.
+     * This prevents race conditions where concurrent requests all pass
+     * a non-atomic read-check-increment sequence.
+     */
+    incrementIfBelow(key: string, limit: number): Promise<{
+        count: number;
+        incremented: boolean;
+    }>;
+    /** Remove expired entries older than the given cutoff timestamp. */
+    cleanup(cutoffMs: number): Promise<number>;
+    /** Clear all entries. */
+    clear(): Promise<void>;
+    /** Release any resources (timers, connections). */
+    close(): Promise<void>;
+}
+export declare class InMemoryRateLimitStore implements RateLimitStore {
+    private windows;
+    get(key: string): Promise<WindowEntry | null>;
+    set(key: string, entry: WindowEntry): Promise<void>;
+    increment(key: string): Promise<number>;
+    incrementIfBelow(key: string, limit: number): Promise<{
+        count: number;
+        incremented: boolean;
+    }>;
+    cleanup(cutoffMs: number): Promise<number>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+}
+/** Minimal PGlite interface — avoids importing the full @electric-sql/pglite package. */
+interface PGliteInstance {
+    exec(query: string): Promise<unknown>;
+    query<T = Record<string, unknown>>(query: string, params?: unknown[]): Promise<{
+        rows: T[];
+    }>;
+    close(): Promise<void>;
+}
+interface PGliteRateLimitStoreOptions {
+    /** PGlite instance (caller owns lifecycle unless closeOnDestroy is true). */
+    db: PGliteInstance;
+    /** Close the PGlite instance when close() is called (default: false). */
+    closeOnDestroy?: boolean;
+}
+export declare class PGliteRateLimitStore implements RateLimitStore {
+    private db;
+    private ready;
+    private closeOnDestroy;
+    constructor(options: PGliteRateLimitStoreOptions);
+    private init;
+    get(key: string): Promise<WindowEntry | null>;
+    set(key: string, entry: WindowEntry): Promise<void>;
+    increment(key: string): Promise<number>;
+    incrementIfBelow(key: string, limit: number): Promise<{
+        count: number;
+        incremented: boolean;
+    }>;
+    cleanup(cutoffMs: number): Promise<number>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=rate-limit-store.d.ts.map

package/dist/rate-limit-store.d.ts.map

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

package/dist/rate-limit-store.js

@@ -0,0 +1,120 @@
+/**
+ * Rate Limit Store — Pluggable backends for rate limiter state.
+ *
+ * - InMemoryRateLimitStore: Map-backed, zero-dep, single-instance (default)
+ * - PGliteRateLimitStore: PostgreSQL-backed via PGlite, supports per-instance
+ *   persistence and can be extended with ElectricSQL for distributed sync.
+ */
+// =============================================================================
+// In-memory store (Map-backed, default)
+// =============================================================================
+export class InMemoryRateLimitStore {
+    windows = new Map();
+    async get(key) {
+        return this.windows.get(key) ?? null;
+    }
+    async set(key, entry) {
+        this.windows.set(key, entry);
+    }
+    async increment(key) {
+        const entry = this.windows.get(key);
+        if (!entry)
+            return 0;
+        entry.count++;
+        return entry.count;
+    }
+    async incrementIfBelow(key, limit) {
+        const entry = this.windows.get(key);
+        if (!entry)
+            return { count: 0, incremented: false };
+        if (entry.count >= limit)
+            return { count: entry.count, incremented: false };
+        entry.count++;
+        return { count: entry.count, incremented: true };
+    }
+    async cleanup(cutoffMs) {
+        let removed = 0;
+        for (const [key, entry] of this.windows) {
+            if (entry.windowStart < cutoffMs) {
+                this.windows.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    async clear() {
+        this.windows.clear();
+    }
+    async close() {
+        this.windows.clear();
+    }
+}
+const CREATE_RATE_LIMIT_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS _rate_limit_windows (
+    key           TEXT PRIMARY KEY,
+    count         INTEGER NOT NULL DEFAULT 0,
+    window_start  BIGINT NOT NULL
+  );
+`;
+export class PGliteRateLimitStore {
+    db;
+    ready;
+    closeOnDestroy;
+    constructor(options) {
+        this.db = options.db;
+        this.closeOnDestroy = options.closeOnDestroy ?? false;
+        this.ready = this.init();
+    }
+    async init() {
+        await this.db.exec(CREATE_RATE_LIMIT_TABLE_SQL);
+    }
+    async get(key) {
+        await this.ready;
+        const result = await this.db.query('SELECT count, window_start FROM _rate_limit_windows WHERE key = $1', [key]);
+        const row = result.rows[0];
+        if (!row)
+            return null;
+        return { count: row.count, windowStart: Number(row.window_start) };
+    }
+    async set(key, entry) {
+        await this.ready;
+        await this.db.query(`INSERT INTO _rate_limit_windows (key, count, window_start)
+       VALUES ($1, $2, $3)
+       ON CONFLICT (key) DO UPDATE
+       SET count = EXCLUDED.count, window_start = EXCLUDED.window_start`, [key, entry.count, entry.windowStart]);
+    }
+    async increment(key) {
+        await this.ready;
+        const result = await this.db.query(`UPDATE _rate_limit_windows SET count = count + 1 WHERE key = $1 RETURNING count`, [key]);
+        const row = result.rows[0];
+        return row?.count ?? 0;
+    }
+    async incrementIfBelow(key, limit) {
+        await this.ready;
+        const result = await this.db.query(`UPDATE _rate_limit_windows SET count = count + 1
+       WHERE key = $1 AND count < $2
+       RETURNING count`, [key, limit]);
+        const row = result.rows[0];
+        if (row)
+            return { count: row.count, incremented: true };
+        // No rows updated — either key missing or limit reached
+        const current = await this.get(key);
+        return { count: current?.count ?? 0, incremented: false };
+    }
+    async cleanup(cutoffMs) {
+        await this.ready;
+        const result = await this.db.query(`WITH deleted AS (DELETE FROM _rate_limit_windows WHERE window_start < $1 RETURNING 1)
+       SELECT count(*)::text AS count FROM deleted`, [cutoffMs]);
+        return Number.parseInt(result.rows[0]?.count ?? '0', 10);
+    }
+    async clear() {
+        await this.ready;
+        await this.db.exec('DELETE FROM _rate_limit_windows');
+    }
+    async close() {
+        if (this.closeOnDestroy) {
+            await this.db.close();
+        }
+    }
+}
+//# sourceMappingURL=rate-limit-store.js.map

package/dist/rate-limit-store.js.map

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

package/dist/rate-limiter.d.ts

@@ -1,20 +1,31 @@
 /**
  * MCP Rate Limiter
  *
- * In-memory fixed-window rate limiter scoped by tenant + tier.
- * For distributed deployments, share state via PGlite or ElectricSQL.
+ * Fixed-window rate limiter scoped by tenant + tier.
+ * Supports pluggable storage backends via RateLimitStore:
+ * - InMemoryRateLimitStore (default, Map-backed)
+ * - PGliteRateLimitStore (SQL-backed, persistent)
  *
  * @example
  * ```typescript
+ * // In-memory (default)
  * const limiter = new McpRateLimiter();
  *
- * const result = limiter.check('tenant-123', 'pro');
+ * // PGlite-backed
+ * import { PGlite } from '@electric-sql/pglite';
+ * import { PGliteRateLimitStore } from './rate-limit-store.js';
+ * const db = new PGlite();
+ * const limiter = new McpRateLimiter({
+ *   store: new PGliteRateLimitStore({ db }),
+ * });
+ *
+ * const result = await limiter.check('tenant-123', 'pro');
  * if (!result.allowed) {
  *   throw new Error(`Rate limited. Retry after ${result.resetMs}ms`);
  * }
- * // result.remaining === requests left in window
  * ```
  */
+import { type RateLimitStore } from './rate-limit-store.js';
 export interface RateLimitConfig {
     /** Max requests per window */
     maxRequests: number;
@@ -27,27 +38,33 @@ export interface RateLimitResult {
     limit: number;
     resetMs: number;
 }
+export interface McpRateLimiterOptions {
+    /** Tier-based rate limit configuration. */
+    limits?: Record<string, RateLimitConfig>;
+    /** Storage backend (default: InMemoryRateLimitStore). */
+    store?: RateLimitStore;
+}
 /** 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.
+ * Fixed-window rate limiter scoped by tenant + tier.
+ * Accepts a pluggable RateLimitStore for different storage backends.
  */
 export declare class McpRateLimiter {
-    private windows;
+    private store;
     private limits;
     private cleanupInterval;
-    constructor(limits?: Record<string, RateLimitConfig>);
+    constructor(options?: McpRateLimiterOptions);
     /**
      * 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;
+    check(tenantId: string, tier: string): Promise<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;
+    dispose(): Promise<void>;
 }
 //# sourceMappingURL=rate-limiter.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMpF,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;AAED,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,yDAAyD;IACzD,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAMD,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAK/D,CAAC;AAMF;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,eAAe,CAA+C;gBAE1D,OAAO,GAAE,qBAA0B;IAU/C;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA8BrE,2CAA2C;IAC3C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAIzD,uCAAuC;YACzB,OAAO;IAOrB,4EAA4E;IACtE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B"}

package/dist/rate-limiter.js

@@ -1,20 +1,31 @@
 /**
  * MCP Rate Limiter
  *
- * In-memory fixed-window rate limiter scoped by tenant + tier.
- * For distributed deployments, share state via PGlite or ElectricSQL.
+ * Fixed-window rate limiter scoped by tenant + tier.
+ * Supports pluggable storage backends via RateLimitStore:
+ * - InMemoryRateLimitStore (default, Map-backed)
+ * - PGliteRateLimitStore (SQL-backed, persistent)
  *
  * @example
  * ```typescript
+ * // In-memory (default)
  * const limiter = new McpRateLimiter();
  *
- * const result = limiter.check('tenant-123', 'pro');
+ * // PGlite-backed
+ * import { PGlite } from '@electric-sql/pglite';
+ * import { PGliteRateLimitStore } from './rate-limit-store.js';
+ * const db = new PGlite();
+ * const limiter = new McpRateLimiter({
+ *   store: new PGliteRateLimitStore({ db }),
+ * });
+ *
+ * const result = await limiter.check('tenant-123', 'pro');
  * if (!result.allowed) {
  *   throw new Error(`Rate limited. Retry after ${result.resetMs}ms`);
  * }
- * // result.remaining === requests left in window
  * ```
  */
+import { InMemoryRateLimitStore } from './rate-limit-store.js';
 // =============================================================================
 // Default tier limits
 // =============================================================================
@@ -29,17 +40,20 @@ export const DEFAULT_TIER_LIMITS = {
 // Rate limiter
 // =============================================================================
 /**
- * In-memory fixed-window rate limiter scoped by tenant + tier.
- * For distributed deployments, share state via PGlite or ElectricSQL.
+ * Fixed-window rate limiter scoped by tenant + tier.
+ * Accepts a pluggable RateLimitStore for different storage backends.
  */
 export class McpRateLimiter {
-    windows = new Map();
+    store;
     limits;
     cleanupInterval = null;
-    constructor(limits = DEFAULT_TIER_LIMITS) {
-        this.limits = limits;
+    constructor(options = {}) {
+        this.limits = options.limits ?? DEFAULT_TIER_LIMITS;
+        this.store = options.store ?? new InMemoryRateLimitStore();
         // Clean up expired windows every 60s
-        this.cleanupInterval = setInterval(() => this.cleanup(), 60_000);
+        this.cleanupInterval = setInterval(() => {
+            void this.cleanup();
+        }, 60_000);
         if (this.cleanupInterval.unref)
             this.cleanupInterval.unref();
     }
@@ -47,24 +61,26 @@ export class McpRateLimiter {
      * Check if a request is allowed and consume one token if so.
      * Returns quota information including remaining requests and reset time.
      */
-    check(tenantId, tier) {
+    async 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);
+        let entry = await this.store.get(key);
         // New window or expired window
         if (!entry || now - entry.windowStart >= config.windowMs) {
             entry = { count: 0, windowStart: now };
-            this.windows.set(key, entry);
+            await this.store.set(key, entry);
         }
         const resetMs = config.windowMs - (now - entry.windowStart);
-        if (entry.count >= config.maxRequests) {
+        // Atomic check-and-increment: prevents concurrent requests from
+        // all passing a stale count check before any increment lands.
+        const result = await this.store.incrementIfBelow(key, config.maxRequests);
+        if (!result.incremented) {
             return { allowed: false, remaining: 0, limit: config.maxRequests, resetMs };
         }
-        entry.count++;
         return {
             allowed: true,
-            remaining: Math.max(0, config.maxRequests - entry.count),
+            remaining: Math.max(0, config.maxRequests - result.count),
             limit: config.maxRequests,
             resetMs,
         };
@@ -74,23 +90,19 @@ export class McpRateLimiter {
         this.limits[tier] = config;
     }
     /** Clean up expired window entries. */
-    cleanup() {
+    async 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);
-            }
-        }
+        // Use the longest window duration × 2 as the expiry cutoff
+        const maxWindowMs = Math.max(...Object.values(this.limits).map((c) => c.windowMs));
+        await this.store.cleanup(now - maxWindowMs * 2);
     }
     /** Dispose the rate limiter, clearing the cleanup timer and all windows. */
-    dispose() {
+    async dispose() {
         if (this.cleanupInterval) {
             clearInterval(this.cleanupInterval);
             this.cleanupInterval = null;
         }
-        this.windows.clear();
+        await this.store.close();
     }
 }
 //# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limiter.js.map

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

package/dist/servers/_email-provider.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Email provider for MCP servers.
+ *
+ * Provider priority:
+ *   1. Gmail REST API  (GOOGLE_SERVICE_ACCOUNT_EMAIL + GOOGLE_PRIVATE_KEY)
+ *   2. SMTP            (SMTP_HOST + SMTP_USER + SMTP_PASS)
+ *   3. Resend API      (RESEND_API_KEY) — deprecated, kept as fallback
+ *
+ * Gmail uses a Google Workspace service account with domain-wide delegation
+ * to send as EMAIL_FROM via the Gmail REST API. Edge-compatible (fetch + jose).
+ */
+export interface EmailPayload {
+    from: string;
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    reply_to?: string;
+    tags?: Array<{
+        name: string;
+        value: string;
+    }>;
+}
+export interface EmailResult {
+    provider: 'gmail' | 'resend';
+    id?: string;
+    data?: unknown;
+}
+/**
+ * Send a single email using the best available provider.
+ * Gmail REST API is preferred; falls back to Resend if Gmail is not configured.
+ */
+export declare function sendEmail(payload: EmailPayload, overrides?: Record<string, string>): Promise<EmailResult>;
+/**
+ * Send a batch of emails. Uses Gmail for each individually (no batch API),
+ * or Resend batch API if Gmail is not configured.
+ */
+export declare function sendEmailBatch(payloads: EmailPayload[], overrides?: Record<string, string>): Promise<EmailResult>;
+//# sourceMappingURL=_email-provider.d.ts.map

package/dist/servers/_email-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_email-provider.d.ts","sourceRoot":"","sources":["../../src/servers/_email-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAyKD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,YAAY,EACrB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACrC,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACrC,OAAO,CAAC,WAAW,CAAC,CAkBtB"}