@defai.digital/resilience-domain 13.0.3

package/dist/loop-guard.js

@@ -0,0 +1,164 @@
+/**
+ * Loop Guard Implementation
+ *
+ * Prevents infinite loops and runaway execution.
+ */
+import { LoopGuardErrorCodes, createDefaultLoopGuardConfig, createLoopGuardContext, } from './_contracts.js';
+/**
+ * Loop guard error
+ */
+export class LoopGuardError extends Error {
+    code;
+    context;
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'LoopGuardError';
+    }
+    static maxIterations(context) {
+        return new LoopGuardError(LoopGuardErrorCodes.MAX_ITERATIONS, `Maximum iterations (${context.iterations}) exceeded`, context);
+    }
+    static maxDuration(context) {
+        return new LoopGuardError(LoopGuardErrorCodes.MAX_DURATION, `Maximum duration (${context.elapsedMs}ms) exceeded`, context);
+    }
+    static contextNotFound(contextId) {
+        return new LoopGuardError(LoopGuardErrorCodes.CONTEXT_NOT_FOUND, `Loop guard context not found: ${contextId}`);
+    }
+}
+/**
+ * Creates a loop guard
+ */
+export function createLoopGuard(config) {
+    const cfg = { ...createDefaultLoopGuardConfig(), ...config };
+    const contexts = new Map();
+    const listeners = new Set();
+    function emitWarning(contextId, result) {
+        for (const listener of listeners) {
+            try {
+                listener(contextId, result);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    return {
+        startContext(contextId, metadata) {
+            const context = createLoopGuardContext(contextId);
+            contexts.set(contextId, {
+                ...context,
+                metadata,
+                startTime: Date.now(),
+            });
+        },
+        checkIteration(contextId) {
+            const context = contexts.get(contextId);
+            if (!context) {
+                throw LoopGuardError.contextNotFound(contextId);
+            }
+            // Update iteration and elapsed time
+            context.iterations++;
+            context.elapsedMs = Date.now() - context.startTime;
+            // Check max iterations
+            if (context.iterations >= cfg.maxIterations) {
+                return {
+                    status: 'blocked',
+                    iteration: context.iterations,
+                    elapsedMs: context.elapsedMs,
+                    reason: `Maximum iterations (${cfg.maxIterations}) exceeded`,
+                    blockType: 'max-iterations',
+                };
+            }
+            // Check max duration
+            if (context.elapsedMs >= cfg.maxDurationMs) {
+                return {
+                    status: 'blocked',
+                    iteration: context.iterations,
+                    elapsedMs: context.elapsedMs,
+                    reason: `Maximum duration (${cfg.maxDurationMs}ms) exceeded`,
+                    blockType: 'max-duration',
+                };
+            }
+            // Check iteration warning
+            if (!context.warningIssued && context.iterations >= cfg.warnAtIterations) {
+                context.warningIssued = true;
+                const result = {
+                    status: 'warning',
+                    iteration: context.iterations,
+                    elapsedMs: context.elapsedMs,
+                    message: `Approaching iteration limit (${context.iterations}/${cfg.maxIterations})`,
+                    warningType: 'iteration',
+                };
+                emitWarning(contextId, result);
+                return result;
+            }
+            // Check duration warning
+            if (!context.warningIssued && context.elapsedMs >= cfg.warnAtDurationMs) {
+                context.warningIssued = true;
+                const result = {
+                    status: 'warning',
+                    iteration: context.iterations,
+                    elapsedMs: context.elapsedMs,
+                    message: `Approaching duration limit (${context.elapsedMs}ms/${cfg.maxDurationMs}ms)`,
+                    warningType: 'duration',
+                };
+                emitWarning(contextId, result);
+                return result;
+            }
+            return {
+                status: 'ok',
+                iteration: context.iterations,
+                elapsedMs: context.elapsedMs,
+            };
+        },
+        endContext(contextId) {
+            const context = contexts.get(contextId);
+            if (context) {
+                context.elapsedMs = Date.now() - context.startTime;
+                contexts.delete(contextId);
+                // Return without internal startTime property
+                const { startTime: _startTime, ...result } = context;
+                return result;
+            }
+            return undefined;
+        },
+        getContext(contextId) {
+            const context = contexts.get(contextId);
+            if (context) {
+                const { startTime: _startTime, ...result } = context;
+                return {
+                    ...result,
+                    elapsedMs: Date.now() - context.startTime,
+                };
+            }
+            return undefined;
+        },
+        onWarning(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+/**
+ * Creates a loop guard that throws on blocked
+ */
+export function createStrictLoopGuard(config) {
+    const guard = createLoopGuard(config);
+    const originalCheck = guard.checkIteration.bind(guard);
+    guard.checkIteration = (contextId) => {
+        const result = originalCheck(contextId);
+        if (result.status === 'blocked') {
+            const context = guard.getContext(contextId);
+            if (result.blockType === 'max-iterations') {
+                throw LoopGuardError.maxIterations(context);
+            }
+            else {
+                throw LoopGuardError.maxDuration(context);
+            }
+        }
+        return result;
+    };
+    return guard;
+}
+//# sourceMappingURL=loop-guard.js.map

package/dist/loop-guard.js.map

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

package/dist/metrics-collector.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Metrics Collector Implementation
+ *
+ * Basic observability metrics for monitoring system health.
+ */
+import { type MetricsTimeRange, type RequestMetric, type ErrorMetric, type MetricsSnapshot } from './_contracts.js';
+/**
+ * Metrics collector interface
+ */
+export interface MetricsCollector {
+    /** Record a request metric */
+    recordRequest(metric: RequestMetric): void;
+    /** Record an error metric */
+    recordError(metric: ErrorMetric): void;
+    /** Get metrics snapshot */
+    getStats(timeRange?: MetricsTimeRange): MetricsSnapshot;
+    /** Reset all metrics */
+    reset(): void;
+    /** Get raw request metrics */
+    getRequestMetrics(limit?: number): RequestMetric[];
+    /** Get raw error metrics */
+    getErrorMetrics(limit?: number): ErrorMetric[];
+}
+/**
+ * Metrics collector configuration
+ */
+export interface MetricsCollectorConfig {
+    /** Maximum number of request metrics to retain */
+    maxRequestMetrics: number;
+    /** Maximum number of error metrics to retain */
+    maxErrorMetrics: number;
+    /** Default time range for stats (e.g., '-1h') */
+    defaultTimeRange: string;
+}
+/**
+ * Creates a metrics collector
+ */
+export declare function createMetricsCollector(config?: Partial<MetricsCollectorConfig>): MetricsCollector;
+export declare function getGlobalMetrics(): MetricsCollector;
+export declare function resetGlobalMetrics(): void;
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../src/metrics-collector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAE3C,6BAA6B;IAC7B,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAEvC,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;IAExD,wBAAwB;IACxB,KAAK,IAAI,IAAI,CAAC;IAEd,8BAA8B;IAC9B,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAEnD,4BAA4B;IAC5B,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IAExB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAQD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC,gBAAgB,CAyMlB;AAOD,wBAAgB,gBAAgB,IAAI,gBAAgB,CAKnD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/metrics-collector.js

@@ -0,0 +1,189 @@
+/**
+ * Metrics Collector Implementation
+ *
+ * Basic observability metrics for monitoring system health.
+ */
+import { TIME_MULTIPLIERS, DEFAULT_TIME_RANGE_MS, } from './_contracts.js';
+const DEFAULT_CONFIG = {
+    maxRequestMetrics: 10000,
+    maxErrorMetrics: 1000,
+    defaultTimeRange: '-1h',
+};
+/**
+ * Creates a metrics collector
+ */
+export function createMetricsCollector(config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const requestMetrics = [];
+    const errorMetrics = [];
+    function parseTimeRange(timeRange) {
+        const end = timeRange.end === 'now' ? new Date() : new Date(timeRange.end);
+        let start;
+        if (timeRange.start.startsWith('-')) {
+            // Relative time like '-1h', '-30m', '-1d'
+            const match = /^-(\d+)([smhd])$/.exec(timeRange.start);
+            if (match) {
+                const value = parseInt(match[1], 10);
+                const unit = match[2];
+                const ms = value * (TIME_MULTIPLIERS[unit] ?? DEFAULT_TIME_RANGE_MS);
+                start = new Date(end.getTime() - ms);
+            }
+            else {
+                start = new Date(end.getTime() - DEFAULT_TIME_RANGE_MS);
+            }
+        }
+        else {
+            start = new Date(timeRange.start);
+        }
+        return { start, end };
+    }
+    function filterByTimeRange(items, timeRange) {
+        const { start, end } = parseTimeRange(timeRange);
+        return items.filter((item) => {
+            const ts = new Date(item.timestamp);
+            return ts >= start && ts <= end;
+        });
+    }
+    function calculateLatencyStats(latencies) {
+        if (latencies.length === 0) {
+            return { min: 0, max: 0, mean: 0, p50: 0, p95: 0, p99: 0, count: 0 };
+        }
+        const sorted = [...latencies].sort((a, b) => a - b);
+        const count = sorted.length;
+        const percentile = (p) => {
+            const index = Math.ceil((p / 100) * count) - 1;
+            return sorted[Math.max(0, Math.min(index, count - 1))];
+        };
+        return {
+            min: sorted[0],
+            max: sorted[count - 1],
+            mean: Math.round(latencies.reduce((a, b) => a + b, 0) / count),
+            p50: percentile(50),
+            p95: percentile(95),
+            p99: percentile(99),
+            count,
+        };
+    }
+    return {
+        recordRequest(metric) {
+            requestMetrics.push(metric);
+            // Trim if over limit
+            if (requestMetrics.length > cfg.maxRequestMetrics) {
+                requestMetrics.splice(0, requestMetrics.length - cfg.maxRequestMetrics);
+            }
+        },
+        recordError(metric) {
+            errorMetrics.push(metric);
+            // Trim if over limit
+            if (errorMetrics.length > cfg.maxErrorMetrics) {
+                errorMetrics.splice(0, errorMetrics.length - cfg.maxErrorMetrics);
+            }
+        },
+        getStats(timeRange) {
+            const range = timeRange ?? {
+                start: cfg.defaultTimeRange,
+                end: 'now',
+            };
+            const filteredRequests = filterByTimeRange(requestMetrics, range);
+            const filteredErrors = filterByTimeRange(errorMetrics, range);
+            // Calculate request stats
+            const successCount = filteredRequests.filter((r) => r.success).length;
+            const failureCount = filteredRequests.length - successCount;
+            const successRate = filteredRequests.length > 0
+                ? successCount / filteredRequests.length
+                : 1;
+            // Calculate latency stats
+            const latencies = filteredRequests.map((r) => r.durationMs);
+            const latencyStats = calculateLatencyStats(latencies);
+            // Calculate token stats
+            const inputTokens = filteredRequests.reduce((sum, r) => sum + (r.inputTokens ?? 0), 0);
+            const outputTokens = filteredRequests.reduce((sum, r) => sum + (r.outputTokens ?? 0), 0);
+            // Calculate cost stats
+            const totalCost = filteredRequests.reduce((sum, r) => sum + (r.estimatedCost ?? 0), 0);
+            // Group errors by code
+            const errorsByCode = {};
+            for (const error of filteredErrors) {
+                errorsByCode[error.code] = (errorsByCode[error.code] ?? 0) + 1;
+            }
+            // Group by provider
+            const byProvider = {};
+            for (const req of filteredRequests) {
+                if (!byProvider[req.providerId]) {
+                    byProvider[req.providerId] = {
+                        requests: 0,
+                        failures: 0,
+                        latencyP50: 0,
+                        tokens: 0,
+                    };
+                }
+                const p = byProvider[req.providerId];
+                p.requests++;
+                if (!req.success)
+                    p.failures++;
+                p.tokens += (req.inputTokens ?? 0) + (req.outputTokens ?? 0);
+            }
+            // Calculate per-provider p50
+            for (const providerId of Object.keys(byProvider)) {
+                const providerLatencies = filteredRequests
+                    .filter((r) => r.providerId === providerId)
+                    .map((r) => r.durationMs);
+                byProvider[providerId].latencyP50 =
+                    calculateLatencyStats(providerLatencies).p50;
+            }
+            return {
+                timeRange: range,
+                requests: {
+                    total: filteredRequests.length,
+                    success: successCount,
+                    failure: failureCount,
+                    successRate: Math.round(successRate * 1000) / 1000,
+                },
+                latency: latencyStats,
+                tokens: {
+                    input: inputTokens,
+                    output: outputTokens,
+                    total: inputTokens + outputTokens,
+                },
+                cost: {
+                    estimated: Math.round(totalCost * 10000) / 10000,
+                    perRequest: filteredRequests.length > 0
+                        ? Math.round((totalCost / filteredRequests.length) * 10000) / 10000
+                        : 0,
+                },
+                errors: errorsByCode,
+                byProvider,
+                generatedAt: new Date().toISOString(),
+            };
+        },
+        reset() {
+            requestMetrics.length = 0;
+            errorMetrics.length = 0;
+        },
+        getRequestMetrics(limit) {
+            if (limit) {
+                return requestMetrics.slice(-limit);
+            }
+            return [...requestMetrics];
+        },
+        getErrorMetrics(limit) {
+            if (limit) {
+                return errorMetrics.slice(-limit);
+            }
+            return [...errorMetrics];
+        },
+    };
+}
+/**
+ * Global metrics collector singleton
+ */
+let globalMetrics = null;
+export function getGlobalMetrics() {
+    if (!globalMetrics) {
+        globalMetrics = createMetricsCollector();
+    }
+    return globalMetrics;
+}
+export function resetGlobalMetrics() {
+    globalMetrics = null;
+}
+//# sourceMappingURL=metrics-collector.js.map

package/dist/metrics-collector.js.map

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

package/dist/rate-limiter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Rate Limiter Implementation
+ *
+ * Token bucket rate limiting to prevent API limit violations.
+ */
+import { type RateLimiterConfig, type RateLimiterStats, type RateLimiterAcquireResult } from './_contracts.js';
+/**
+ * Rate limiter error
+ */
+export declare class RateLimiterError extends Error {
+    readonly code: string;
+    readonly retryAfterMs?: number | undefined;
+    constructor(code: string, message: string, retryAfterMs?: number | undefined);
+    static rateLimited(retryAfterMs: number): RateLimiterError;
+    static queueFull(): RateLimiterError;
+    static timeout(): RateLimiterError;
+}
+/**
+ * Rate limiter interface
+ */
+export interface RateLimiter {
+    /** Acquire capacity (waits if needed) */
+    acquire(tokens?: number): Promise<RateLimiterAcquireResult>;
+    /** Try to acquire capacity (non-blocking) */
+    tryAcquire(tokens?: number): boolean;
+    /** Get current statistics */
+    getStats(): RateLimiterStats;
+    /** Reset the limiter */
+    reset(): void;
+}
+/**
+ * Creates a rate limiter
+ */
+export declare function createRateLimiter(config?: Partial<RateLimiterConfig>): RateLimiter;
+//# 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;;;;GAIG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAK9B,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,IAAI,EAAE,MAAM;aAEZ,YAAY,CAAC,EAAE,MAAM;gBAFrB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,YAAY,CAAC,EAAE,MAAM,YAAA;IAMvC,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB;IAQ1D,MAAM,CAAC,SAAS,IAAI,gBAAgB;IAOpC,MAAM,CAAC,OAAO,IAAI,gBAAgB;CAMnC;AAWD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE5D,6CAA6C;IAC7C,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAErC,6BAA6B;IAC7B,QAAQ,IAAI,gBAAgB,CAAC;IAE7B,wBAAwB;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,WAAW,CAqLb"}

package/dist/rate-limiter.js

@@ -0,0 +1,189 @@
+/**
+ * Rate Limiter Implementation
+ *
+ * Token bucket rate limiting to prevent API limit violations.
+ */
+import { RateLimiterErrorCodes, createDefaultRateLimiterConfig, DEFAULT_TOKEN_WINDOW_MS, DEFAULT_CHECK_INTERVAL_MS, } from './_contracts.js';
+/**
+ * Rate limiter error
+ */
+export class RateLimiterError extends Error {
+    code;
+    retryAfterMs;
+    constructor(code, message, retryAfterMs) {
+        super(message);
+        this.code = code;
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'RateLimiterError';
+    }
+    static rateLimited(retryAfterMs) {
+        return new RateLimiterError(RateLimiterErrorCodes.RATE_LIMITED, `Rate limit exceeded. Retry after ${retryAfterMs}ms`, retryAfterMs);
+    }
+    static queueFull() {
+        return new RateLimiterError(RateLimiterErrorCodes.QUEUE_FULL, 'Rate limiter queue is full');
+    }
+    static timeout() {
+        return new RateLimiterError(RateLimiterErrorCodes.TIMEOUT, 'Rate limiter queue timeout');
+    }
+}
+/**
+ * Creates a rate limiter
+ */
+export function createRateLimiter(config) {
+    const cfg = { ...createDefaultRateLimiterConfig(), ...config };
+    // Token bucket state
+    let tokens = cfg.requestsPerMinute * cfg.burstMultiplier;
+    const maxTokens = cfg.requestsPerMinute * cfg.burstMultiplier;
+    const refillRate = cfg.requestsPerMinute / 60000; // tokens per ms
+    let lastRefillTime = Date.now();
+    // Token tracking for LLM APIs
+    let llmTokensUsed = 0;
+    let llmTokenWindowStart = Date.now();
+    // Statistics
+    let requestsAllowed = 0;
+    let requestsRejected = 0;
+    const windowStart = new Date().toISOString();
+    // Queue
+    const queue = [];
+    let processingQueue = false;
+    function refillTokens() {
+        const now = Date.now();
+        const elapsed = now - lastRefillTime;
+        const refill = elapsed * refillRate;
+        tokens = Math.min(maxTokens, tokens + refill);
+        lastRefillTime = now;
+        // Reset LLM token window if minute elapsed
+        if (cfg.tokensPerMinute && now - llmTokenWindowStart >= DEFAULT_TOKEN_WINDOW_MS) {
+            llmTokensUsed = 0;
+            llmTokenWindowStart = now;
+        }
+    }
+    function calculateWaitTime(requestTokens) {
+        if (tokens >= requestTokens)
+            return 0;
+        const deficit = requestTokens - tokens;
+        return Math.ceil(deficit / refillRate);
+    }
+    function processQueue() {
+        if (processingQueue || queue.length === 0)
+            return;
+        processingQueue = true;
+        const processNext = () => {
+            if (queue.length === 0) {
+                processingQueue = false;
+                return;
+            }
+            const request = queue[0];
+            if (!request) {
+                processingQueue = false;
+                return;
+            }
+            const now = Date.now();
+            // Check timeout
+            if (now - request.enqueuedAt >= cfg.queueTimeoutMs) {
+                queue.shift();
+                request.resolve({
+                    acquired: false,
+                    reason: 'timeout',
+                });
+                setTimeout(processNext, 0);
+                return;
+            }
+            refillTokens();
+            if (tokens >= request.tokens) {
+                queue.shift();
+                tokens -= request.tokens;
+                requestsAllowed++;
+                request.resolve({
+                    acquired: true,
+                    waitedMs: now - request.enqueuedAt,
+                });
+                setTimeout(processNext, 0);
+            }
+            else {
+                // Wait for tokens
+                const waitTime = calculateWaitTime(request.tokens);
+                setTimeout(processNext, Math.min(waitTime, DEFAULT_CHECK_INTERVAL_MS));
+            }
+        };
+        processNext();
+    }
+    return {
+        async acquire(requestTokens = 1) {
+            refillTokens();
+            // Check LLM token limit
+            if (cfg.tokensPerMinute && llmTokensUsed >= cfg.tokensPerMinute) {
+                const retryAfterMs = DEFAULT_TOKEN_WINDOW_MS - (Date.now() - llmTokenWindowStart);
+                requestsRejected++;
+                return {
+                    acquired: false,
+                    reason: 'limit-exceeded',
+                    retryAfterMs,
+                };
+            }
+            // Try immediate acquisition
+            if (tokens >= requestTokens && queue.length === 0) {
+                tokens -= requestTokens;
+                requestsAllowed++;
+                return { acquired: true, waitedMs: 0 };
+            }
+            // Check queue capacity
+            if (queue.length >= cfg.maxQueueSize) {
+                requestsRejected++;
+                return { acquired: false, reason: 'queue-full' };
+            }
+            // Queue the request
+            return new Promise((resolve) => {
+                queue.push({
+                    tokens: requestTokens,
+                    resolve,
+                    enqueuedAt: Date.now(),
+                });
+                processQueue();
+            });
+        },
+        tryAcquire(requestTokens = 1) {
+            refillTokens();
+            // Check LLM token limit
+            if (cfg.tokensPerMinute && llmTokensUsed >= cfg.tokensPerMinute) {
+                requestsRejected++;
+                return false;
+            }
+            if (tokens >= requestTokens && queue.length === 0) {
+                tokens -= requestTokens;
+                requestsAllowed++;
+                return true;
+            }
+            requestsRejected++;
+            return false;
+        },
+        getStats() {
+            refillTokens();
+            return {
+                requestsAllowed,
+                requestsRejected,
+                queueSize: queue.length,
+                tokensUsed: llmTokensUsed,
+                availableCapacity: tokens,
+                nextRefillMs: tokens >= maxTokens ? 0 : Math.ceil((maxTokens - tokens) / refillRate),
+                windowStart,
+            };
+        },
+        reset() {
+            tokens = maxTokens;
+            lastRefillTime = Date.now();
+            llmTokensUsed = 0;
+            llmTokenWindowStart = Date.now();
+            requestsAllowed = 0;
+            requestsRejected = 0;
+            // Clear queue
+            while (queue.length > 0) {
+                const request = queue.shift();
+                if (request) {
+                    request.resolve({ acquired: false, reason: 'timeout' });
+                }
+            }
+        },
+    };
+}
+//# 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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"}