@trentapps/manager-protocol 1.3.0

package/dist/engine/RateLimiter.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Enterprise Agent Supervisor - Rate Limiter
+ *
+ * Token bucket rate limiting with multiple scopes and configurations.
+ * Uses extracted utilities from src/utils/rate-limiting.ts for
+ * bucket key building and sliding window logic.
+ */
+import type { RateLimitConfig, RateLimitState, ActionCategory } from '../types/index.js';
+export declare class RateLimiter {
+    private configs;
+    private buckets;
+    private lastCleanup;
+    private cleanupIntervalMs;
+    /**
+     * Register a rate limit configuration
+     */
+    registerLimit(config: RateLimitConfig): void;
+    /**
+     * Register multiple rate limit configurations
+     */
+    registerLimits(configs: RateLimitConfig[]): void;
+    /**
+     * Remove a rate limit configuration
+     */
+    removeLimit(configId: string): boolean;
+    /**
+     * Check if an action should be rate limited
+     */
+    checkLimit(params: {
+        agentId?: string;
+        sessionId?: string;
+        userId?: string;
+        actionCategory?: ActionCategory;
+        actionType?: string;
+    }): {
+        allowed: boolean;
+        limitId?: string;
+        state?: RateLimitState;
+    };
+    /**
+     * Record a request (consume from bucket)
+     */
+    recordRequest(params: {
+        agentId?: string;
+        sessionId?: string;
+        userId?: string;
+        actionCategory?: ActionCategory;
+        actionType?: string;
+    }): void;
+    /**
+     * Get current state for a specific limit
+     */
+    getState(configId: string, params: {
+        agentId?: string;
+        sessionId?: string;
+        userId?: string;
+    }): RateLimitState | null;
+    /**
+     * Get all registered configurations
+     */
+    getConfigs(): RateLimitConfig[];
+    /**
+     * Clear all buckets (useful for testing)
+     */
+    clearBuckets(): void;
+    /**
+     * Convert params to BucketIdentifiers for the utility function
+     */
+    private toIdentifiers;
+    /**
+     * Get or create a bucket with SlidingWindow
+     */
+    private getOrCreateBucket;
+    /**
+     * Clean up expired buckets to prevent memory leaks
+     * Removes buckets that are older than their window duration
+     */
+    private cleanupExpiredBuckets;
+}
+export declare const rateLimiter: RateLimiter;
+//# sourceMappingURL=RateLimiter.d.ts.map

package/dist/engine/RateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/engine/RateLimiter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAWzF,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,iBAAiB,CAAyB;IAElD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI5C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IAMhD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE;IAyDlE;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI;IAqBR;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,cAAc,GAAG,IAAI;IA8BzB;;OAEG;IACH,UAAU,IAAI,eAAe,EAAE;IAI/B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAmC9B;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/engine/RateLimiter.js

@@ -0,0 +1,215 @@
+/**
+ * Enterprise Agent Supervisor - Rate Limiter
+ *
+ * Token bucket rate limiting with multiple scopes and configurations.
+ * Uses extracted utilities from src/utils/rate-limiting.ts for
+ * bucket key building and sliding window logic.
+ */
+import { buildBucketKey, SlidingWindow } from '../utils/rate-limiting.js';
+export class RateLimiter {
+    configs = new Map();
+    buckets = new Map();
+    lastCleanup = Date.now();
+    cleanupIntervalMs = 5 * 60 * 1000; // Cleanup every 5 minutes
+    /**
+     * Register a rate limit configuration
+     */
+    registerLimit(config) {
+        this.configs.set(config.id, config);
+    }
+    /**
+     * Register multiple rate limit configurations
+     */
+    registerLimits(configs) {
+        for (const config of configs) {
+            this.registerLimit(config);
+        }
+    }
+    /**
+     * Remove a rate limit configuration
+     */
+    removeLimit(configId) {
+        return this.configs.delete(configId);
+    }
+    /**
+     * Check if an action should be rate limited
+     */
+    checkLimit(params) {
+        const now = Date.now();
+        // Periodically clean up expired buckets to prevent memory leaks
+        this.cleanupExpiredBuckets(now);
+        for (const [configId, config] of this.configs) {
+            if (!config.enabled)
+                continue;
+            // Check if action category matches (if specified)
+            if (config.actionCategories && params.actionCategory) {
+                if (!config.actionCategories.includes(params.actionCategory)) {
+                    continue;
+                }
+            }
+            // Build bucket key using extracted utility
+            const identifiers = this.toIdentifiers(params);
+            const bucketKey = buildBucketKey(config.scope, identifiers, configId);
+            const bucket = this.getOrCreateBucket(bucketKey, config);
+            // Check if window can accept using SlidingWindow
+            if (!bucket.window.canAccept(now)) {
+                const stats = bucket.window.getStats(now);
+                return {
+                    allowed: false,
+                    limitId: configId,
+                    state: {
+                        key: bucketKey,
+                        count: stats.count,
+                        windowStart: stats.windowStart,
+                        remaining: 0,
+                        resetAt: stats.resetAtISO
+                    }
+                };
+            }
+            // Check burst limit if configured
+            if (config.burstLimit && !bucket.window.canAcceptBurst(now)) {
+                const stats = bucket.window.getStats(now);
+                return {
+                    allowed: false,
+                    limitId: configId,
+                    state: {
+                        key: bucketKey,
+                        count: stats.count,
+                        windowStart: stats.windowStart,
+                        remaining: 0,
+                        resetAt: stats.resetAtISO
+                    }
+                };
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Record a request (consume from bucket)
+     */
+    recordRequest(params) {
+        const now = Date.now();
+        for (const [configId, config] of this.configs) {
+            if (!config.enabled)
+                continue;
+            if (config.actionCategories && params.actionCategory) {
+                if (!config.actionCategories.includes(params.actionCategory)) {
+                    continue;
+                }
+            }
+            const identifiers = this.toIdentifiers(params);
+            const bucketKey = buildBucketKey(config.scope, identifiers, configId);
+            const bucket = this.getOrCreateBucket(bucketKey, config);
+            // Record the request in the sliding window
+            bucket.window.record(now);
+        }
+    }
+    /**
+     * Get current state for a specific limit
+     */
+    getState(configId, params) {
+        const config = this.configs.get(configId);
+        if (!config)
+            return null;
+        const now = Date.now();
+        const identifiers = this.toIdentifiers(params);
+        const bucketKey = buildBucketKey(config.scope, identifiers, configId);
+        const bucket = this.buckets.get(bucketKey);
+        if (!bucket) {
+            return {
+                key: bucketKey,
+                count: 0,
+                windowStart: now,
+                remaining: config.maxRequests,
+                resetAt: new Date(now + config.windowMs).toISOString()
+            };
+        }
+        const stats = bucket.window.getStats(now);
+        return {
+            key: bucketKey,
+            count: stats.count,
+            windowStart: stats.windowStart,
+            remaining: stats.remaining,
+            resetAt: stats.resetAtISO
+        };
+    }
+    /**
+     * Get all registered configurations
+     */
+    getConfigs() {
+        return Array.from(this.configs.values());
+    }
+    /**
+     * Clear all buckets (useful for testing)
+     */
+    clearBuckets() {
+        this.buckets.clear();
+    }
+    /**
+     * Convert params to BucketIdentifiers for the utility function
+     */
+    toIdentifiers(params) {
+        return {
+            agentId: params.agentId,
+            sessionId: params.sessionId,
+            userId: params.userId,
+            actionType: params.actionType
+        };
+    }
+    /**
+     * Get or create a bucket with SlidingWindow
+     */
+    getOrCreateBucket(key, config) {
+        let bucket = this.buckets.get(key);
+        if (!bucket) {
+            bucket = {
+                key,
+                window: new SlidingWindow({
+                    windowMs: config.windowMs,
+                    maxRequests: config.maxRequests,
+                    burstLimit: config.burstLimit,
+                    algorithm: 'fixed' // Use fixed window for consistent behavior with original implementation
+                })
+            };
+            this.buckets.set(key, bucket);
+        }
+        return bucket;
+    }
+    /**
+     * Clean up expired buckets to prevent memory leaks
+     * Removes buckets that are older than their window duration
+     */
+    cleanupExpiredBuckets(now) {
+        // Only cleanup every cleanupIntervalMs to avoid excessive work
+        if (now - this.lastCleanup < this.cleanupIntervalMs) {
+            return;
+        }
+        this.lastCleanup = now;
+        // Find the maximum window duration across all configs
+        let maxWindowMs = 60000; // Default 1 minute
+        for (const config of this.configs.values()) {
+            if (config.windowMs > maxWindowMs) {
+                maxWindowMs = config.windowMs;
+            }
+        }
+        // Remove buckets that are older than the maximum window
+        // This uses >= for consistency with window expiration checks
+        // A bucket is expired when: now - windowStart >= 2*maxWindowMs (2x safety margin)
+        let removedCount = 0;
+        for (const [key, bucket] of this.buckets.entries()) {
+            const state = bucket.window.getState();
+            // Off-by-one fix: use consistent >= comparison for boundary calculation
+            // Window boundary semantics: now - windowStart >= threshold means expired
+            if (now - state.windowStart >= maxWindowMs * 2) {
+                this.buckets.delete(key);
+                removedCount++;
+            }
+        }
+        if (removedCount > 0) {
+            console.log(`[RateLimiter] Cleaned up ${removedCount} expired buckets`);
+        }
+    }
+}
+// Export singleton instance
+export const rateLimiter = new RateLimiter();
+//# sourceMappingURL=RateLimiter.js.map

package/dist/engine/RateLimiter.js.map

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

package/dist/engine/RuleDependencyAnalyzer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Enterprise Agent Supervisor - Rule Dependency Analyzer (Task #37)
+ *
+ * Analyzes and validates rule interdependencies, detects circular dependencies,
+ * and provides topologically sorted execution order.
+ */
+import type { BusinessRule, RuleDependencyGraph, DependencyValidationResult } from '../types/index.js';
+export interface DependencyAnalyzerOptions {
+    /**
+     * Maximum allowed depth for dependency chains before warning
+     */
+    maxDepthWarning?: number;
+    /**
+     * Whether to include disabled rules in analysis
+     */
+    includeDisabled?: boolean;
+}
+export declare class RuleDependencyAnalyzer {
+    private options;
+    constructor(options?: DependencyAnalyzerOptions);
+    /**
+     * Build a complete dependency graph from a set of rules
+     */
+    analyzeDependencies(rules: BusinessRule[]): RuleDependencyGraph;
+    /**
+     * Find all circular dependencies in the rule set
+     */
+    findCircularDependencies(rules: BusinessRule[]): string[][];
+    /**
+     * Get topologically sorted execution order for rules
+     * Rules with dependencies come after their dependencies
+     */
+    getExecutionOrder(rules: BusinessRule[]): string[];
+    /**
+     * Validate all dependencies in the rule set
+     */
+    validateDependencies(rules: BusinessRule[]): DependencyValidationResult;
+    /**
+     * Get rules that depend on a specific rule (direct dependents)
+     */
+    getDependents(ruleId: string, rules: BusinessRule[]): BusinessRule[];
+    /**
+     * Get all rules that a specific rule depends on (direct dependencies)
+     */
+    getDependencies(ruleId: string, rules: BusinessRule[]): BusinessRule[];
+    /**
+     * Get all transitive dependencies for a rule
+     */
+    getTransitiveDependencies(ruleId: string, rules: BusinessRule[]): BusinessRule[];
+    /**
+     * Get all rules that would be affected if a rule is disabled
+     */
+    getAffectedByDisabling(ruleId: string, rules: BusinessRule[]): BusinessRule[];
+    /**
+     * Get rules sorted by execution order respecting dependencies
+     * This integrates with the RulesEngine for proper evaluation order
+     */
+    getSortedRulesForExecution(rules: BusinessRule[]): BusinessRule[];
+    /**
+     * Calculate depth for each node in the dependency graph
+     */
+    private calculateDepths;
+    /**
+     * Detect conflicts between currently active rules
+     */
+    private detectActiveConflicts;
+    /**
+     * Find dependencies that reference non-existent rules
+     */
+    private findOrphanedDependencies;
+}
+export declare const ruleDependencyAnalyzer: RuleDependencyAnalyzer;
+//# sourceMappingURL=RuleDependencyAnalyzer.d.ts.map

package/dist/engine/RuleDependencyAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuleDependencyAnalyzer.d.ts","sourceRoot":"","sources":["../../src/engine/RuleDependencyAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAEnB,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAOD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,GAAE,yBAA8B;IAInD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,mBAAmB;IAyD/D;;OAEG;IACH,wBAAwB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,EAAE;IA+C3D;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE;IAkFlD;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,0BAA0B;IA0GvE;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAMpE;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAgBtE;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAiChF;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IA+B7E;;;OAGG;IACH,0BAA0B,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IA4BjE;;OAEG;IACH,OAAO,CAAC,eAAe;IA2CvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6B7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAqBjC;AAGD,eAAO,MAAM,sBAAsB,wBAA+B,CAAC"}