@defai.digital/mcp-server 13.0.3

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

@@ -0,0 +1,136 @@
+/**
+ * MCP Tool Rate Limiter Middleware
+ *
+ * Implements rate limiting for MCP tools using a sliding window algorithm
+ * with token bucket for burst handling.
+ *
+ * Invariants enforced:
+ * - INV-MCP-006: Rate limits enforced per tool
+ * - INV-MCP-007: RATE_LIMITED errors include retryAfter
+ * - INV-RL-001: Rate limits are enforced per tool
+ * - INV-RL-002: Exceeded limits return RATE_LIMITED error with retryAfter
+ * - INV-RL-003: Limits are configurable without code changes
+ * - INV-RL-004: Read tools have higher limits than mutation tools
+ */
+import type { RateLimitConfig, RateLimitResult, RateLimitError, McpRateLimitToolCategory as ToolCategory } from '@defai.digital/contracts';
+/**
+ * Internal state for tracking rate limits per tool
+ */
+interface RateLimitBucket {
+    /** Tokens available (for burst) */
+    tokens: number;
+    /** Last refill timestamp */
+    lastRefill: number;
+    /** Request count in current minute window */
+    minuteCount: number;
+    /** Minute window start timestamp */
+    minuteStart: number;
+}
+/**
+ * Rate limiter configuration
+ */
+export interface RateLimiterConfig {
+    /** Whether rate limiting is enabled globally */
+    enabled: boolean;
+    /** Custom limits per tool (overrides defaults) */
+    customLimits: Map<string, RateLimitConfig>;
+    /** Custom limits per category (overrides defaults) */
+    categoryLimits: Map<ToolCategory, RateLimitConfig>;
+}
+/**
+ * Rate Limiter for MCP Tools
+ *
+ * Uses a combination of:
+ * 1. Token bucket for burst handling
+ * 2. Sliding window for requests-per-minute tracking
+ */
+export declare class RateLimiter {
+    private readonly buckets;
+    private config;
+    constructor(config?: Partial<RateLimiterConfig>);
+    /**
+     * Gets the effective rate limit for a tool
+     * Priority: customLimits > categoryLimits > DEFAULT_RATE_LIMITS
+     */
+    getLimit(toolName: string): RateLimitConfig;
+    /**
+     * Checks if a tool call is allowed under rate limits
+     * INV-RL-001: Rate limits are enforced per tool
+     */
+    check(toolName: string): RateLimitResult;
+    /**
+     * Consumes a rate limit token for a tool
+     * Call this after check() returns allowed: true and before executing the tool
+     */
+    consume(toolName: string): void;
+    /**
+     * Checks and consumes in one operation
+     * Returns the check result, and if allowed, also consumes the token
+     */
+    checkAndConsume(toolName: string): RateLimitResult;
+    /**
+     * Creates a rate limit error for rejected requests
+     * INV-MCP-007: RATE_LIMITED errors include retryAfter
+     */
+    createError(toolName: string, result: RateLimitResult): RateLimitError;
+    /**
+     * Updates rate limiter configuration
+     * INV-RL-003: Limits are configurable without code changes
+     */
+    configure(config: Partial<RateLimiterConfig>): void;
+    /**
+     * Sets a custom limit for a specific tool
+     */
+    setToolLimit(toolName: string, limit: RateLimitConfig): void;
+    /**
+     * Sets a custom limit for a category
+     */
+    setCategoryLimit(category: ToolCategory, limit: RateLimitConfig): void;
+    /**
+     * Removes custom limit for a tool (reverts to category/default)
+     */
+    removeToolLimit(toolName: string): void;
+    /**
+     * Gets current state for a tool (for debugging/monitoring)
+     */
+    getState(toolName: string): {
+        bucket: RateLimitBucket | undefined;
+        limit: RateLimitConfig;
+        category: ToolCategory;
+    };
+    /**
+     * Resets rate limit state for a tool
+     */
+    reset(toolName: string): void;
+    /**
+     * Resets all rate limit state
+     */
+    resetAll(): void;
+    /**
+     * Checks if rate limiting is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Gets or creates a bucket for a tool
+     */
+    private getOrCreateBucket;
+    /**
+     * Refills tokens based on elapsed time
+     * Uses token bucket algorithm: tokens refill at rate of rpm/60 per second
+     */
+    private refillTokens;
+}
+/**
+ * Gets the global rate limiter instance (singleton)
+ */
+export declare function getRateLimiter(): RateLimiter;
+/**
+ * Sets the global rate limiter instance (for testing)
+ */
+export declare function setRateLimiter(limiter: RateLimiter): void;
+/**
+ * Resets the global rate limiter (for testing)
+ */
+export declare function resetRateLimiter(): void;
+export {};
+//# sourceMappingURL=rate-limiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,wBAAwB,IAAI,YAAY,EACzC,MAAM,0BAA0B,CAAC;AAOlC;;GAEG;AACH,UAAU,eAAe;IACvB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IAEjB,kDAAkD;IAClD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE3C,sDAAsD;IACtD,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;CACpD;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAQ/C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAkB3C;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAuExC;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ/B;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAQlD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,cAAc;IAQtE;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAYnD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI;IAI5D;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI;IAItE;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG;QAC1B,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;QACpC,KAAK,EAAE,eAAe,CAAC;QACvB,QAAQ,EAAE,YAAY,CAAC;KACxB;IAQD;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAYrB;AAOD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}

package/dist/middleware/rate-limiter.js

@@ -0,0 +1,262 @@
+/**
+ * MCP Tool Rate Limiter Middleware
+ *
+ * Implements rate limiting for MCP tools using a sliding window algorithm
+ * with token bucket for burst handling.
+ *
+ * Invariants enforced:
+ * - INV-MCP-006: Rate limits enforced per tool
+ * - INV-MCP-007: RATE_LIMITED errors include retryAfter
+ * - INV-RL-001: Rate limits are enforced per tool
+ * - INV-RL-002: Exceeded limits return RATE_LIMITED error with retryAfter
+ * - INV-RL-003: Limits are configurable without code changes
+ * - INV-RL-004: Read tools have higher limits than mutation tools
+ */
+import { getToolCategory, getDefaultRateLimit, createRateLimitError, } from '@defai.digital/contracts';
+/**
+ * Rate Limiter for MCP Tools
+ *
+ * Uses a combination of:
+ * 1. Token bucket for burst handling
+ * 2. Sliding window for requests-per-minute tracking
+ */
+export class RateLimiter {
+    buckets = new Map();
+    config;
+    constructor(config) {
+        this.config = {
+            enabled: config?.enabled ?? true,
+            customLimits: config?.customLimits ?? new Map(),
+            categoryLimits: config?.categoryLimits ?? new Map(),
+        };
+    }
+    /**
+     * Gets the effective rate limit for a tool
+     * Priority: customLimits > categoryLimits > DEFAULT_RATE_LIMITS
+     */
+    getLimit(toolName) {
+        // Check custom tool-specific limit
+        const customLimit = this.config.customLimits.get(toolName);
+        if (customLimit !== undefined) {
+            return customLimit;
+        }
+        // Check category limit
+        const category = getToolCategory(toolName);
+        const categoryLimit = this.config.categoryLimits.get(category);
+        if (categoryLimit !== undefined) {
+            return categoryLimit;
+        }
+        // Fall back to default
+        return getDefaultRateLimit(toolName);
+    }
+    /**
+     * Checks if a tool call is allowed under rate limits
+     * INV-RL-001: Rate limits are enforced per tool
+     */
+    check(toolName) {
+        // If rate limiting is disabled, always allow
+        if (!this.config.enabled) {
+            const limit = this.getLimit(toolName);
+            return {
+                allowed: true,
+                remaining: limit.rpm,
+                resetIn: 0,
+                limit,
+            };
+        }
+        const limit = this.getLimit(toolName);
+        // If tool-specific rate limiting is disabled, allow
+        if (!limit.enabled) {
+            return {
+                allowed: true,
+                remaining: limit.rpm,
+                resetIn: 0,
+                limit,
+            };
+        }
+        const now = Date.now();
+        const bucket = this.getOrCreateBucket(toolName, limit, now);
+        // Refill tokens based on time elapsed
+        this.refillTokens(bucket, limit, now);
+        // Check minute window
+        const minuteElapsed = now - bucket.minuteStart;
+        if (minuteElapsed >= 60000) {
+            // Reset minute window
+            bucket.minuteCount = 0;
+            bucket.minuteStart = now;
+        }
+        // Calculate remaining and reset time
+        const remaining = Math.max(0, limit.rpm - bucket.minuteCount);
+        const resetIn = Math.ceil((60000 - (now - bucket.minuteStart)) / 1000);
+        // Check if request is allowed
+        // Must have both: tokens available AND not exceeded RPM
+        if (bucket.tokens < 1 || bucket.minuteCount >= limit.rpm) {
+            // INV-RL-002: Return retryAfter
+            // Guard against division by zero when rpm is 0 (rate limiting disabled at limit level)
+            const tokenRefillTime = limit.rpm > 0
+                ? Math.ceil((1 / (limit.rpm / 60)) * 1000) / 1000 // Time for 1 token
+                : 60; // Default to 60 seconds if rpm is 0
+            const retryAfter = bucket.tokens < 1
+                ? tokenRefillTime
+                : resetIn;
+            return {
+                allowed: false,
+                remaining,
+                resetIn,
+                retryAfter: Math.ceil(retryAfter),
+                limit,
+            };
+        }
+        return {
+            allowed: true,
+            remaining: remaining - 1, // Account for this request
+            resetIn,
+            limit,
+        };
+    }
+    /**
+     * Consumes a rate limit token for a tool
+     * Call this after check() returns allowed: true and before executing the tool
+     */
+    consume(toolName) {
+        const bucket = this.buckets.get(toolName);
+        if (bucket !== undefined) {
+            bucket.tokens = Math.max(0, bucket.tokens - 1);
+            bucket.minuteCount++;
+        }
+    }
+    /**
+     * Checks and consumes in one operation
+     * Returns the check result, and if allowed, also consumes the token
+     */
+    checkAndConsume(toolName) {
+        const result = this.check(toolName);
+        if (result.allowed) {
+            this.consume(toolName);
+        }
+        return result;
+    }
+    /**
+     * Creates a rate limit error for rejected requests
+     * INV-MCP-007: RATE_LIMITED errors include retryAfter
+     */
+    createError(toolName, result) {
+        return createRateLimitError(toolName, result.retryAfter ?? 60, result.limit.rpm);
+    }
+    /**
+     * Updates rate limiter configuration
+     * INV-RL-003: Limits are configurable without code changes
+     */
+    configure(config) {
+        if (config.enabled !== undefined) {
+            this.config.enabled = config.enabled;
+        }
+        if (config.customLimits !== undefined) {
+            this.config.customLimits = config.customLimits;
+        }
+        if (config.categoryLimits !== undefined) {
+            this.config.categoryLimits = config.categoryLimits;
+        }
+    }
+    /**
+     * Sets a custom limit for a specific tool
+     */
+    setToolLimit(toolName, limit) {
+        this.config.customLimits.set(toolName, limit);
+    }
+    /**
+     * Sets a custom limit for a category
+     */
+    setCategoryLimit(category, limit) {
+        this.config.categoryLimits.set(category, limit);
+    }
+    /**
+     * Removes custom limit for a tool (reverts to category/default)
+     */
+    removeToolLimit(toolName) {
+        this.config.customLimits.delete(toolName);
+    }
+    /**
+     * Gets current state for a tool (for debugging/monitoring)
+     */
+    getState(toolName) {
+        return {
+            bucket: this.buckets.get(toolName),
+            limit: this.getLimit(toolName),
+            category: getToolCategory(toolName),
+        };
+    }
+    /**
+     * Resets rate limit state for a tool
+     */
+    reset(toolName) {
+        this.buckets.delete(toolName);
+    }
+    /**
+     * Resets all rate limit state
+     */
+    resetAll() {
+        this.buckets.clear();
+    }
+    /**
+     * Checks if rate limiting is enabled
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Gets or creates a bucket for a tool
+     */
+    getOrCreateBucket(toolName, limit, now) {
+        let bucket = this.buckets.get(toolName);
+        if (bucket === undefined) {
+            bucket = {
+                tokens: limit.burst,
+                lastRefill: now,
+                minuteCount: 0,
+                minuteStart: now,
+            };
+            this.buckets.set(toolName, bucket);
+        }
+        return bucket;
+    }
+    /**
+     * Refills tokens based on elapsed time
+     * Uses token bucket algorithm: tokens refill at rate of rpm/60 per second
+     */
+    refillTokens(bucket, limit, now) {
+        const elapsed = now - bucket.lastRefill;
+        const refillRate = limit.rpm / 60000; // Tokens per millisecond
+        const tokensToAdd = elapsed * refillRate;
+        bucket.tokens = Math.min(limit.burst, bucket.tokens + tokensToAdd);
+        bucket.lastRefill = now;
+    }
+}
+/**
+ * Global rate limiter instance
+ */
+let globalRateLimiter = null;
+/**
+ * Gets the global rate limiter instance (singleton)
+ */
+export function getRateLimiter() {
+    if (globalRateLimiter === null) {
+        globalRateLimiter = new RateLimiter();
+    }
+    return globalRateLimiter;
+}
+/**
+ * Sets the global rate limiter instance (for testing)
+ */
+export function setRateLimiter(limiter) {
+    globalRateLimiter = limiter;
+}
+/**
+ * Resets the global rate limiter (for testing)
+ */
+export function resetRateLimiter() {
+    if (globalRateLimiter !== null) {
+        globalRateLimiter.resetAll();
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/middleware/rate-limiter.js.map

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

package/dist/prompts/agent-guide.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agent Guide MCP Prompt
+ *
+ * Provides comprehensive documentation for using the AutomatosX agent system.
+ * Teaches Claude Code (and other consumers) how to effectively use agents.
+ */
+import type { MCPPrompt, PromptHandler } from '../types.js';
+/**
+ * Agent guide prompt definition
+ */
+export declare const agentGuidePrompt: MCPPrompt;
+/**
+ * Handler for agent-guide prompt
+ */
+export declare const handleAgentGuide: PromptHandler;
+//# sourceMappingURL=agent-guide.d.ts.map

package/dist/prompts/agent-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guide.d.ts","sourceRoot":"","sources":["../../src/prompts/agent-guide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAU9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAwX9B,CAAC"}