@lagoon-protocol/lagoon-mcp 0.2.24 → 0.3.0

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

@@ -0,0 +1,78 @@
+/**
+ * Rate Limiter Utilities
+ *
+ * Provides controlled concurrency for GraphQL requests to prevent 429 rate limit errors.
+ * Uses p-limit for efficient promise-based concurrency limiting.
+ *
+ * Background:
+ * The GraphQL API (proxied via Cloudflare) has strict rate limits (~5-10 req/10s).
+ * Tools like compare_vaults make multiple parallel requests that can trigger 429 errors.
+ * These utilities limit concurrent requests to stay within rate limits.
+ */
+import pLimit from 'p-limit';
+/**
+ * Default concurrency limit for GraphQL requests.
+ * Conservative value to respect ~5-10 req/10s rate limit.
+ */
+export declare const DEFAULT_CONCURRENCY = 2;
+/**
+ * Type for the p-limit limiter function.
+ */
+export type Limiter = ReturnType<typeof pLimit>;
+/**
+ * Creates a rate limiter instance with the specified concurrency.
+ *
+ * @param concurrency - Maximum number of concurrent operations (default: 2)
+ * @returns A p-limit limiter function
+ *
+ * @example
+ * ```typescript
+ * const limiter = createRateLimiter(2);
+ * const results = await Promise.all(
+ *   items.map(item => limiter(() => fetchData(item)))
+ * );
+ * ```
+ */
+export declare function createRateLimiter(concurrency?: number): Limiter;
+/**
+ * Maps over an array with rate-limited concurrency.
+ *
+ * This is the primary utility for converting unbounded Promise.all patterns
+ * to rate-limited parallel execution. Maintains order of results.
+ *
+ * @param items - Array of items to process
+ * @param fn - Async function to apply to each item
+ * @param concurrency - Maximum concurrent operations (default: 2)
+ * @returns Promise resolving to array of results in same order as input
+ *
+ * @example
+ * ```typescript
+ * // Before: Unbounded parallel (causes 429 errors)
+ * const results = await Promise.all(
+ *   vaults.map(v => fetchComposition(v.address))
+ * );
+ *
+ * // After: Rate-limited parallel (max 2 concurrent)
+ * const results = await rateLimitedMap(
+ *   vaults,
+ *   v => fetchComposition(v.address),
+ *   2
+ * );
+ * ```
+ */
+export declare function rateLimitedMap<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>, concurrency?: number): Promise<R[]>;
+/**
+ * Shared rate limiter for GraphQL composition queries.
+ * Used across tools that query the Octav API (vault composition).
+ *
+ * @example
+ * ```typescript
+ * import { compositionLimiter } from '../utils/rate-limiter.js';
+ *
+ * const results = await Promise.all(
+ *   vaults.map(v => compositionLimiter(() => fetchComposition(v.address)))
+ * );
+ * ```
+ */
+export declare const compositionLimiter: import("p-limit").LimitFunction;
+//# sourceMappingURL=rate-limiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,GAAE,MAA4B,GAAG,OAAO,CAEpF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,CAAC,EACvC,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,WAAW,GAAE,MAA4B,GACxC,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,iCAAyC,CAAC"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,79 @@
+/**
+ * Rate Limiter Utilities
+ *
+ * Provides controlled concurrency for GraphQL requests to prevent 429 rate limit errors.
+ * Uses p-limit for efficient promise-based concurrency limiting.
+ *
+ * Background:
+ * The GraphQL API (proxied via Cloudflare) has strict rate limits (~5-10 req/10s).
+ * Tools like compare_vaults make multiple parallel requests that can trigger 429 errors.
+ * These utilities limit concurrent requests to stay within rate limits.
+ */
+import pLimit from 'p-limit';
+/**
+ * Default concurrency limit for GraphQL requests.
+ * Conservative value to respect ~5-10 req/10s rate limit.
+ */
+export const DEFAULT_CONCURRENCY = 2;
+/**
+ * Creates a rate limiter instance with the specified concurrency.
+ *
+ * @param concurrency - Maximum number of concurrent operations (default: 2)
+ * @returns A p-limit limiter function
+ *
+ * @example
+ * ```typescript
+ * const limiter = createRateLimiter(2);
+ * const results = await Promise.all(
+ *   items.map(item => limiter(() => fetchData(item)))
+ * );
+ * ```
+ */
+export function createRateLimiter(concurrency = DEFAULT_CONCURRENCY) {
+    return pLimit(concurrency);
+}
+/**
+ * Maps over an array with rate-limited concurrency.
+ *
+ * This is the primary utility for converting unbounded Promise.all patterns
+ * to rate-limited parallel execution. Maintains order of results.
+ *
+ * @param items - Array of items to process
+ * @param fn - Async function to apply to each item
+ * @param concurrency - Maximum concurrent operations (default: 2)
+ * @returns Promise resolving to array of results in same order as input
+ *
+ * @example
+ * ```typescript
+ * // Before: Unbounded parallel (causes 429 errors)
+ * const results = await Promise.all(
+ *   vaults.map(v => fetchComposition(v.address))
+ * );
+ *
+ * // After: Rate-limited parallel (max 2 concurrent)
+ * const results = await rateLimitedMap(
+ *   vaults,
+ *   v => fetchComposition(v.address),
+ *   2
+ * );
+ * ```
+ */
+export async function rateLimitedMap(items, fn, concurrency = DEFAULT_CONCURRENCY) {
+    const limiter = pLimit(concurrency);
+    return Promise.all(items.map((item, index) => limiter(() => fn(item, index))));
+}
+/**
+ * Shared rate limiter for GraphQL composition queries.
+ * Used across tools that query the Octav API (vault composition).
+ *
+ * @example
+ * ```typescript
+ * import { compositionLimiter } from '../utils/rate-limiter.js';
+ *
+ * const results = await Promise.all(
+ *   vaults.map(v => compositionLimiter(() => fetchComposition(v.address)))
+ * );
+ * ```
+ */
+export const compositionLimiter = createRateLimiter(DEFAULT_CONCURRENCY);
+//# sourceMappingURL=rate-limiter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAOrC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,cAAsB,mBAAmB;IACzE,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAU,EACV,EAA0C,EAC1C,cAAsB,mBAAmB;IAEzC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lagoon-protocol/lagoon-mcp",
-  "version": "0.2.24",
+  "version": "0.3.0",
   "description": "MCP server for Lagoon DeFi vault analytics - FOR INFORMATIONAL USE ONLY, NOT FINANCIAL ADVICE. Natural language access to vault data, portfolios, and performance metrics",
   "type": "module",
   "main": "./dist/index.js",
@@ -86,6 +86,7 @@
     "graphql": "^16.8.1",
     "graphql-request": "^6.1.0",
     "node-cache": "^5.1.2",
+    "p-limit": "^6.1.0",
     "zod": "^3.22.4"
   },
   "devDependencies": {