@dollhousemcp/mcp-server 1.5.2 → 1.6.0

package/dist/utils/ToolCache.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Generic caching utility for tool discovery with TTL and memory limits
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export interface CacheEntry<T> {
+    value: T;
+    timestamp: number;
+    hits: number;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    maxSize: number;
+    hitRate: number;
+}
+/**
+ * Generic cache with TTL support and memory limit protection
+ */
+export declare class ToolCache<T = any> {
+    private cache;
+    private readonly maxEntries;
+    private readonly ttlMs;
+    private stats;
+    constructor(maxEntries?: number, ttlMinutes?: number);
+    /**
+     * Get cached value if valid, otherwise return undefined
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set cached value with automatic memory limit enforcement
+     */
+    set(key: string, value: T): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Clear specific cache entry
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cached entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Remove oldest entries when cache is full
+     */
+    private evictOldest;
+    /**
+     * Clean up expired entries (can be called periodically)
+     */
+    cleanup(): number;
+}
+/**
+ * Specialized cache for MCP Tool discovery results
+ */
+export declare class ToolDiscoveryCache extends ToolCache<Tool[]> {
+    private static readonly CACHE_KEY;
+    constructor();
+    /**
+     * Get cached tool list
+     */
+    getToolList(): Tool[] | undefined;
+    /**
+     * Cache tool list
+     */
+    setToolList(tools: Tool[]): void;
+    /**
+     * Invalidate cached tool list
+     */
+    invalidateToolList(): void;
+    /**
+     * Log performance metrics
+     */
+    logPerformance(): void;
+}
+//# sourceMappingURL=ToolCache.d.ts.map

package/dist/utils/ToolCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCache.d.ts","sourceRoot":"","sources":["../../src/utils/ToolCache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,GAAG;IAC5B,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,KAAK,CAGX;gBAEU,UAAU,GAAE,MAAY,EAAE,UAAU,GAAE,MAAU;IAK5D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAwB/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAiBhC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,QAAQ,IAAI,UAAU;IAWtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,OAAO,IAAI,MAAM;CAiBlB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAyB;;IAO1D;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE,GAAG,SAAS;IAgBjC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAYhC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;OAEG;IACH,cAAc,IAAI,IAAI;CAUvB"}

package/dist/utils/ToolCache.js

@@ -0,0 +1,196 @@
+/**
+ * Generic caching utility for tool discovery with TTL and memory limits
+ */
+import { logger } from './logger.js';
+/**
+ * Generic cache with TTL support and memory limit protection
+ */
+export class ToolCache {
+    cache = new Map();
+    maxEntries;
+    ttlMs;
+    stats = {
+        hits: 0,
+        misses: 0
+    };
+    constructor(maxEntries = 100, ttlMinutes = 1) {
+        this.maxEntries = maxEntries;
+        this.ttlMs = ttlMinutes * 60 * 1000; // Convert minutes to milliseconds
+    }
+    /**
+     * Get cached value if valid, otherwise return undefined
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return undefined;
+        }
+        // Check if entry has expired
+        const now = Date.now();
+        if (now - entry.timestamp > this.ttlMs) {
+            this.cache.delete(key);
+            this.stats.misses++;
+            logger.debug('ToolCache: Cache entry expired', { key, age: now - entry.timestamp });
+            return undefined;
+        }
+        // Entry is valid
+        entry.hits++;
+        this.stats.hits++;
+        logger.debug('ToolCache: Cache hit', { key, hits: entry.hits, age: now - entry.timestamp });
+        return entry.value;
+    }
+    /**
+     * Set cached value with automatic memory limit enforcement
+     */
+    set(key, value) {
+        const now = Date.now();
+        // Enforce memory limit by removing oldest entries if needed
+        while (this.cache.size >= this.maxEntries && !this.cache.has(key)) {
+            this.evictOldest();
+        }
+        this.cache.set(key, {
+            value,
+            timestamp: now,
+            hits: 0
+        });
+        logger.debug('ToolCache: Cache set', { key, cacheSize: this.cache.size });
+    }
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Clear specific cache entry
+     */
+    delete(key) {
+        const deleted = this.cache.delete(key);
+        if (deleted) {
+            logger.debug('ToolCache: Cache entry deleted', { key });
+        }
+        return deleted;
+    }
+    /**
+     * Clear all cached entries
+     */
+    clear() {
+        this.cache.clear();
+        this.stats.hits = 0;
+        this.stats.misses = 0;
+        logger.debug('ToolCache: Cache cleared');
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const totalRequests = this.stats.hits + this.stats.misses;
+        return {
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            size: this.cache.size,
+            maxSize: this.maxEntries,
+            hitRate: totalRequests > 0 ? this.stats.hits / totalRequests : 0
+        };
+    }
+    /**
+     * Remove oldest entries when cache is full
+     */
+    evictOldest() {
+        if (this.cache.size === 0)
+            return;
+        // Find the oldest entry (lowest timestamp)
+        let oldestKey;
+        let oldestTimestamp = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.timestamp < oldestTimestamp) {
+                oldestTimestamp = entry.timestamp;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            logger.debug('ToolCache: Evicted oldest entry', { key: oldestKey, age: Date.now() - oldestTimestamp });
+        }
+    }
+    /**
+     * Clean up expired entries (can be called periodically)
+     */
+    cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > this.ttlMs) {
+                this.cache.delete(key);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            logger.debug('ToolCache: Cleaned up expired entries', { cleaned, remaining: this.cache.size });
+        }
+        return cleaned;
+    }
+}
+/**
+ * Specialized cache for MCP Tool discovery results
+ */
+export class ToolDiscoveryCache extends ToolCache {
+    static CACHE_KEY = 'tool_discovery_list';
+    constructor() {
+        // 1-minute TTL, max 100 entries (though we'll likely only use 1 key)
+        super(100, 1);
+    }
+    /**
+     * Get cached tool list
+     */
+    getToolList() {
+        const startTime = Date.now();
+        const result = this.get(ToolDiscoveryCache.CACHE_KEY);
+        const duration = Date.now() - startTime;
+        if (result) {
+            logger.info('ToolDiscoveryCache: Retrieved cached tool list', {
+                toolCount: result.length,
+                duration: `${duration}ms`,
+                stats: this.getStats()
+            });
+        }
+        return result;
+    }
+    /**
+     * Cache tool list
+     */
+    setToolList(tools) {
+        const startTime = Date.now();
+        this.set(ToolDiscoveryCache.CACHE_KEY, tools);
+        const duration = Date.now() - startTime;
+        logger.info('ToolDiscoveryCache: Cached tool list', {
+            toolCount: tools.length,
+            duration: `${duration}ms`,
+            stats: this.getStats()
+        });
+    }
+    /**
+     * Invalidate cached tool list
+     */
+    invalidateToolList() {
+        const deleted = this.delete(ToolDiscoveryCache.CACHE_KEY);
+        if (deleted) {
+            logger.info('ToolDiscoveryCache: Invalidated cached tool list');
+        }
+    }
+    /**
+     * Log performance metrics
+     */
+    logPerformance() {
+        const stats = this.getStats();
+        logger.info('ToolDiscoveryCache: Performance metrics', {
+            hitRate: `${(stats.hitRate * 100).toFixed(1)}%`,
+            hits: stats.hits,
+            misses: stats.misses,
+            cacheSize: stats.size,
+            efficiency: stats.hits > 0 ? 'GOOD' : 'NEEDS_WARMUP'
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVG9vbENhY2hlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL1Rvb2xDYWNoZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUdILE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFnQnJDOztHQUVHO0FBQ0gsTUFBTSxPQUFPLFNBQVM7SUFDWixLQUFLLEdBQStCLElBQUksR0FBRyxFQUFFLENBQUM7SUFDckMsVUFBVSxDQUFTO0lBQ25CLEtBQUssQ0FBUztJQUN2QixLQUFLLEdBQUc7UUFDZCxJQUFJLEVBQUUsQ0FBQztRQUNQLE1BQU0sRUFBRSxDQUFDO0tBQ1YsQ0FBQztJQUVGLFlBQVksYUFBcUIsR0FBRyxFQUFFLGFBQXFCLENBQUM7UUFDMUQsSUFBSSxDQUFDLFVBQVUsR0FBRyxVQUFVLENBQUM7UUFDN0IsSUFBSSxDQUFDLEtBQUssR0FBRyxVQUFVLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDLGtDQUFrQztJQUN6RSxDQUFDO0lBRUQ7O09BRUc7SUFDSCxHQUFHLENBQUMsR0FBVztRQUNiLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBRWxDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNYLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDcEIsT0FBTyxTQUFTLENBQUM7UUFDbkIsQ0FBQztRQUVELDZCQUE2QjtRQUM3QixNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDdkIsSUFBSSxHQUFHLEdBQUcsS0FBSyxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDdkMsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7WUFDdkIsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLEVBQUUsQ0FB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S0FBSyxDQUFDLENBQUM7UUFDOUMsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLFNBQVMsQ0FBQztRQUV4QyxNQUFNLENBQUMsSUFBSSxDQUFDLHNDQUFzQyxFQUFFO1lBQ2xELFNBQVMsRUFBRSxLQUFLLENBQUMsTUFBTTtZQUN2QixRQUFRLEVBQUUsR0FBRyxRQUFRLElBQUk7WUFDekIsS0FBSyxFQUFFLElBQUksQ0FBQyxRQUFRLEVBQUU7U0FDdkIsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztJQUVEOztPQUVHO0lBQ0gsa0JBQWtCO1FBQ2hCLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUMsa0JBQWtCLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDMUQsSUFBSSxPQUFPLEVBQUUsQ0FBQztZQUNaLE1BQU0sQ0FBQyxJQUFJLENBQUMsa0RBQWtELENBQUMsQ0FBQztRQUNsRSxDQUFDO0lBQ0gsQ0FBQztJQUVEOztPQUVHO0lBQ0gsY0FBYztRQUNaLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztRQUM5QixNQUFNLENBQUMsSUFBSSxDQUFDLHlDQUF5QyxFQUFFO1lBQ3JELE9BQU8sRUFBRSxHQUFHLENBQUMsS0FBSyxDQUFDLE9BQU8sR0FBRyxHQUFHLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUc7WUFDL0MsSUFBSSxFQUFFLEtBQUssQ0FBQyxJQUFJO1lBQ2hCLE1BQU0sRUFBRSxLQUFLLENBQUMsTUFBTTtZQUNwQixTQUFTLEVBQUUsS0FBSyxDQUFDLElBQUk7WUFDckIsVUFBVSxFQUFFLEtBQUssQ0FBQyxJQUFJLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLGNBQWM7U0FDckQsQ0FBQyxDQUFDO0lBQ0wsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogR2VuZXJpYyBjYWNoaW5nIHV0aWxpdHkgZm9yIHRvb2wgZGlzY292ZXJ5IHdpdGggVFRMIGFuZCBtZW1vcnkgbGltaXRzXG4gKi9cblxuaW1wb3J0IHsgVG9vbCB9IGZyb20gXCJAbW9kZWxjb250ZXh0cHJvdG9jb2wvc2RrL3R5cGVzLmpzXCI7XG5pbXBvcnQgeyBsb2dnZXIgfSBmcm9tICcuL2xvZ2dlci5qcyc7XG5cbmV4cG9ydCBpbnRlcmZhY2UgQ2FjaGVFbnRyeTxUPiB7XG4gIHZhbHVlOiBUO1xuICB0aW1lc3RhbXA6IG51bWJlcjtcbiAgaGl0czogbnVtYmVyO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIENhY2hlU3RhdHMge1xuICBoaXRzOiBudW1iZXI7XG4gIG1pc3NlczogbnVtYmVyO1xuICBzaXplOiBudW1iZXI7XG4gIG1heFNpemU6IG51bWJlcjtcbiAgaGl0UmF0ZTogbnVtYmVyO1xufVxuXG4vKipcbiAqIEdlbmVyaWMgY2FjaGUgd2l0aCBUVEwgc3VwcG9ydCBhbmQgbWVtb3J5IGxpbWl0IHByb3RlY3Rpb25cbiAqL1xuZXhwb3J0IGNsYXNzIFRvb2xDYWNoZTxUID0gYW55PiB7XG4gIHByaXZhdGUgY2FjaGU6IE1hcDxzdHJpbmcsIENhY2hlRW50cnk8VD4+ID0gbmV3IE1hcCgpO1xuICBwcml2YXRlIHJlYWRvbmx5IG1heEVudHJpZXM6IG51bWJlcjtcbiAgcHJpdmF0ZSByZWFkb25seSB0dGxNczogbnVtYmVyO1xuICBwcml2YXRlIHN0YXRzID0ge1xuICAgIGhpdHM6IDAsXG4gICAgbWlzc2VzOiAwXG4gIH07XG5cbiAgY29uc3RydWN0b3IobWF4RW50cmllczogbnVtYmVyID0gMTAwLCB0dGxNaW51dGVzOiBudW1iZXIgPSAxKSB7XG4gICAgdGhpcy5tYXhFbnRyaWVzID0gbWF4RW50cmllcztcbiAgICB0aGlzLnR0bE1zID0gdHRsTWludXRlcyAqIDYwICogMTAwMDsgLy8gQ29udmVydCBtaW51dGVzIHRvIG1pbGxpc2Vjb25kc1xuICB9XG5cbiAgLyoqXG4gICAqIEdldCBjYWNoZWQgdmFsdWUgaWYgdmFsaWQsIG90aGVyd2lzZSByZXR1cm4gdW5kZWZpbmVkXG4gICAqL1xuICBnZXQoa2V5OiBzdHJpbmcpOiBUIHwgdW5kZWZpbmVkIHtcbiAgICBjb25zdCBlbnRyeSA9IHRoaXMuY2FjaGUuZ2V0KGtleSk7XG4gICAgXG4gICAgaWYgKCFlbnRyeSkge1xuICAgICAgdGhpcy5zdGF0cy5taXNzZXMrKztcbiAgICAgIHJldHVybiB1bmRlZmluZWQ7XG4gICAgfVxuXG4gICAgLy8gQ2hlY2sgaWYgZW50cnkgaGFzIGV4cGlyZWRcbiAgICBjb25zdCBub3cgPSBEYXRlLm5vdygpO1xuICAgIGlmIChub3cgLSBlbnRyeS50aW1lc3RhbXAgPiB0aGlzLnR0bE1zKSB7XG4gICAgICB0aGlzLmNhY2hlLmRlbGV0ZShrZXkpO1xuICAgICAgdGhpcy5zdGF0cy5taXNzZXMrKztcbiAgICAgIGxvZ2dlci5kZWJ1ZygnVG9vbENhY2hlOiBDYWNoZSBlbnRyeSBleHBpcmVkJywgeyBrZXksIGFnZTogbm93IC0gZW50cnkudGltZXN0YW1wIH0pO1xuICAgICAgcmV0dXJuIHVuZGVmaW5lZDtcbiAgICB9XG5cbiAgICAvLyBFbnRyeSBpcyB2YWxpZFxuICAgIGVudHJ5LmhpdHMrKztcbiAgICB0aGlzLnN0YXRzLmhpdHMrKztcbiAgICBsb2dnZXIuZGVidWcoJ1Rvb2xDYWNoZTogQ2FjaGUgaGl0JywgeyBrZXksIGhpdHM6IGVudHJ5LmhpdHMsIGFnZTogbm93IC0gZW50cnkudGltZXN0YW1wIH0pO1xuICAgIHJldHVybiBlbnRyeS52YWx1ZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBTZXQgY2FjaGVkIHZhbHVlIHdpdGggYXV0b21hdGljIG1lbW9yeSBsaW1pdCBlbmZvcmNlbWVudFxuICAgKi9cbiAgc2V0KGtleTogc3RyaW5nLCB2YWx1ZTogVCk6IHZvaWQge1xuICAgIGNvbnN0IG5vdyA9IERhdGUubm93KCk7XG4gICAgXG4gICAgLy8gRW5mb3JjZSBtZW1vcnkgbGltaXQgYnkgcmVtb3Zpbmcgb2xkZXN0IGVudHJpZXMgaWYgbmVlZGVkXG4gICAgd2hpbGUgKHRoaXMuY2FjaGUuc2l6ZSA+PSB0aGlzLm1heEVudHJpZXMgJiYgIXRoaXMuY2FjaGUuaGFzKGtleSkpIHtcbiAgICAgIHRoaXMuZXZpY3RPbGRlc3QoKTtcbiAgICB9XG5cbiAgICB0aGlzLmNhY2hlLnNldChrZXksIHtcbiAgICAgIHZhbHVlLFxuICAgICAgdGltZXN0YW1wOiBub3csXG4gICAgICBoaXRzOiAwXG4gICAgfSk7XG5cbiAgICBsb2dnZXIuZGVidWcoJ1Rvb2xDYWNoZTogQ2FjaGUgc2V0JywgeyBrZXksIGNhY2hlU2l6ZTogdGhpcy5jYWNoZS5zaXplIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIENoZWNrIGlmIGtleSBleGlzdHMgYW5kIGlzIG5vdCBleHBpcmVkXG4gICAqL1xuICBoYXMoa2V5OiBzdHJpbmcpOiBib29sZWFuIHtcbiAgICByZXR1cm4gdGhpcy5nZXQoa2V5KSAhPT0gdW5kZWZpbmVkO1xuICB9XG5cbiAgLyoqXG4gICAqIENsZWFyIHNwZWNpZmljIGNhY2hlIGVudHJ5XG4gICAqL1xuICBkZWxldGUoa2V5OiBzdHJpbmcpOiBib29sZWFuIHtcbiAgICBjb25zdCBkZWxldGVkID0gdGhpcy5jYWNoZS5kZWxldGUoa2V5KTtcbiAgICBpZiAoZGVsZXRlZCkge1xuICAgICAgbG9nZ2VyLmRlYnVnKCdUb29sQ2FjaGU6IENhY2hlIGVudHJ5IGRlbGV0ZWQnLCB7IGtleSB9KTtcbiAgICB9XG4gICAgcmV0dXJuIGRlbGV0ZWQ7XG4gIH1cblxuICAvKipcbiAgICogQ2xlYXIgYWxsIGNhY2hlZCBlbnRyaWVzXG4gICAqL1xuICBjbGVhcigpOiB2b2lkIHtcbiAgICB0aGlzLmNhY2hlLmNsZWFyKCk7XG4gICAgdGhpcy5zdGF0cy5oaXRzID0gMDtcbiAgICB0aGlzLnN0YXRzLm1pc3NlcyA9IDA7XG4gICAgbG9nZ2VyLmRlYnVnKCdUb29sQ2FjaGU6IENhY2hlIGNsZWFyZWQnKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgY2FjaGUgc3RhdGlzdGljc1xuICAgKi9cbiAgZ2V0U3RhdHMoKTogQ2FjaGVTdGF0cyB7XG4gICAgY29uc3QgdG90YWxSZXF1ZXN0cyA9IHRoaXMuc3RhdHMuaGl0cyArIHRoaXMuc3RhdHMubWlzc2VzO1xuICAgIHJldHVybiB7XG4gICAgICBoaXRzOiB0aGlzLnN0YXRzLmhpdHMsXG4gICAgICBtaXNzZXM6IHRoaXMuc3RhdHMubWlzc2VzLFxuICAgICAgc2l6ZTogdGhpcy5jYWNoZS5zaXplLFxuICAgICAgbWF4U2l6ZTogdGhpcy5tYXhFbnRyaWVzLFxuICAgICAgaGl0UmF0ZTogdG90YWxSZXF1ZXN0cyA+IDAgPyB0aGlzLnN0YXRzLmhpdHMgLyB0b3RhbFJlcXVlc3RzIDogMFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogUmVtb3ZlIG9sZGVzdCBlbnRyaWVzIHdoZW4gY2FjaGUgaXMgZnVsbFxuICAgKi9cbiAgcHJpdmF0ZSBldmljdE9sZGVzdCgpOiB2b2lkIHtcbiAgICBpZiAodGhpcy5jYWNoZS5zaXplID09PSAwKSByZXR1cm47XG5cbiAgICAvLyBGaW5kIHRoZSBvbGRlc3QgZW50cnkgKGxvd2VzdCB0aW1lc3RhbXApXG4gICAgbGV0IG9sZGVzdEtleTogc3RyaW5nIHwgdW5kZWZpbmVkO1xuICAgIGxldCBvbGRlc3RUaW1lc3RhbXAgPSBEYXRlLm5vdygpO1xuXG4gICAgZm9yIChjb25zdCBba2V5LCBlbnRyeV0gb2YgdGhpcy5jYWNoZS5lbnRyaWVzKCkpIHtcbiAgICAgIGlmIChlbnRyeS50aW1lc3RhbXAgPCBvbGRlc3RUaW1lc3RhbXApIHtcbiAgICAgICAgb2xkZXN0VGltZXN0YW1wID0gZW50cnkudGltZXN0YW1wO1xuICAgICAgICBvbGRlc3RLZXkgPSBrZXk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgaWYgKG9sZGVzdEtleSkge1xuICAgICAgdGhpcy5jYWNoZS5kZWxldGUob2xkZXN0S2V5KTtcbiAgICAgIGxvZ2dlci5kZWJ1ZygnVG9vbENhY2hlOiBFdmljdGVkIG9sZGVzdCBlbnRyeScsIHsga2V5OiBvbGRlc3RLZXksIGFnZTogRGF0ZS5ub3coKSAtIG9sZGVzdFRpbWVzdGFtcCB9KTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogQ2xlYW4gdXAgZXhwaXJlZCBlbnRyaWVzIChjYW4gYmUgY2FsbGVkIHBlcmlvZGljYWxseSlcbiAgICovXG4gIGNsZWFudXAoKTogbnVtYmVyIHtcbiAgICBjb25zdCBub3cgPSBEYXRlLm5vdygpO1xuICAgIGxldCBjbGVhbmVkID0gMDtcblxuICAgIGZvciAoY29uc3QgW2tleSwgZW50cnldIG9mIHRoaXMuY2FjaGUuZW50cmllcygpKSB7XG4gICAgICBpZiAobm93IC0gZW50cnkudGltZXN0YW1wID4gdGhpcy50dGxNcykge1xuICAgICAgICB0aGlzLmNhY2hlLmRlbGV0ZShrZXkpO1xuICAgICAgICBjbGVhbmVkKys7XG4gICAgICB9XG4gICAgfVxuXG4gICAgaWYgKGNsZWFuZWQgPiAwKSB7XG4gICAgICBsb2dnZXIuZGVidWcoJ1Rvb2xDYWNoZTogQ2xlYW5lZCB1cCBleHBpcmVkIGVudHJpZXMnLCB7IGNsZWFuZWQsIHJlbWFpbmluZzogdGhpcy5jYWNoZS5zaXplIH0pO1xuICAgIH1cblxuICAgIHJldHVybiBjbGVhbmVkO1xuICB9XG59XG5cbi8qKlxuICogU3BlY2lhbGl6ZWQgY2FjaGUgZm9yIE1DUCBUb29sIGRpc2NvdmVyeSByZXN1bHRzXG4gKi9cbmV4cG9ydCBjbGFzcyBUb29sRGlzY292ZXJ5Q2FjaGUgZXh0ZW5kcyBUb29sQ2FjaGU8VG9vbFtdPiB7XG4gIHByaXZhdGUgc3RhdGljIHJlYWRvbmx5IENBQ0hFX0tFWSA9ICd0b29sX2Rpc2NvdmVyeV9saXN0JztcblxuICBjb25zdHJ1Y3RvcigpIHtcbiAgICAvLyAxLW1pbnV0ZSBUVEwsIG1heCAxMDAgZW50cmllcyAodGhvdWdoIHdlJ2xsIGxpa2VseSBvbmx5IHVzZSAxIGtleSlcbiAgICBzdXBlcigxMDAsIDEpO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldCBjYWNoZWQgdG9vbCBsaXN0XG4gICAqL1xuICBnZXRUb29sTGlzdCgpOiBUb29sW10gfCB1bmRlZmluZWQge1xuICAgIGNvbnN0IHN0YXJ0VGltZSA9IERhdGUubm93KCk7XG4gICAgY29uc3QgcmVzdWx0ID0gdGhpcy5nZXQoVG9vbERpc2NvdmVyeUNhY2hlLkNBQ0hFX0tFWSk7XG4gICAgY29uc3QgZHVyYXRpb24gPSBEYXRlLm5vdygpIC0gc3RhcnRUaW1lO1xuICAgIFxuICAgIGlmIChyZXN1bHQpIHtcbiAgICAgIGxvZ2dlci5pbmZvKCdUb29sRGlzY292ZXJ5Q2FjaGU6IFJldHJpZXZlZCBjYWNoZWQgdG9vbCBsaXN0JywgeyBcbiAgICAgICAgdG9vbENvdW50OiByZXN1bHQubGVuZ3RoLCBcbiAgICAgICAgZHVyYXRpb246IGAke2R1cmF0aW9ufW1zYCxcbiAgICAgICAgc3RhdHM6IHRoaXMuZ2V0U3RhdHMoKVxuICAgICAgfSk7XG4gICAgfVxuICAgIFxuICAgIHJldHVybiByZXN1bHQ7XG4gIH1cblxuICAvKipcbiAgICogQ2FjaGUgdG9vbCBsaXN0XG4gICAqL1xuICBzZXRUb29sTGlzdCh0b29sczogVG9vbFtdKTogdm9pZCB7XG4gICAgY29uc3Qgc3RhcnRUaW1lID0gRGF0ZS5ub3coKTtcbiAgICB0aGlzLnNldChUb29sRGlzY292ZXJ5Q2FjaGUuQ0FDSEVfS0VZLCB0b29scyk7XG4gICAgY29uc3QgZHVyYXRpb24gPSBEYXRlLm5vdygpIC0gc3RhcnRUaW1lO1xuICAgIFxuICAgIGxvZ2dlci5pbmZvKCdUb29sRGlzY292ZXJ5Q2FjaGU6IENhY2hlZCB0b29sIGxpc3QnLCB7IFxuICAgICAgdG9vbENvdW50OiB0b29scy5sZW5ndGgsIFxuICAgICAgZHVyYXRpb246IGAke2R1cmF0aW9ufW1zYCxcbiAgICAgIHN0YXRzOiB0aGlzLmdldFN0YXRzKClcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbnZhbGlkYXRlIGNhY2hlZCB0b29sIGxpc3RcbiAgICovXG4gIGludmFsaWRhdGVUb29sTGlzdCgpOiB2b2lkIHtcbiAgICBjb25zdCBkZWxldGVkID0gdGhpcy5kZWxldGUoVG9vbERpc2NvdmVyeUNhY2hlLkNBQ0hFX0tFWSk7XG4gICAgaWYgKGRlbGV0ZWQpIHtcbiAgICAgIGxvZ2dlci5pbmZvKCdUb29sRGlzY292ZXJ5Q2FjaGU6IEludmFsaWRhdGVkIGNhY2hlZCB0b29sIGxpc3QnKTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogTG9nIHBlcmZvcm1hbmNlIG1ldHJpY3NcbiAgICovXG4gIGxvZ1BlcmZvcm1hbmNlKCk6IHZvaWQge1xuICAgIGNvbnN0IHN0YXRzID0gdGhpcy5nZXRTdGF0cygpO1xuICAgIGxvZ2dlci5pbmZvKCdUb29sRGlzY292ZXJ5Q2FjaGU6IFBlcmZvcm1hbmNlIG1ldHJpY3MnLCB7XG4gICAgICBoaXRSYXRlOiBgJHsoc3RhdHMuaGl0UmF0ZSAqIDEwMCkudG9GaXhlZCgxKX0lYCxcbiAgICAgIGhpdHM6IHN0YXRzLmhpdHMsXG4gICAgICBtaXNzZXM6IHN0YXRzLm1pc3NlcyxcbiAgICAgIGNhY2hlU2l6ZTogc3RhdHMuc2l6ZSxcbiAgICAgIGVmZmljaWVuY3k6IHN0YXRzLmhpdHMgPiAwID8gJ0dPT0QnIDogJ05FRURTX1dBUk1VUCdcbiAgICB9KTtcbiAgfVxufSJdfQ==

package/dist/utils/errorCodes.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Centralized error codes for consistent error handling across the application.
+ * Error codes follow the pattern: CATEGORY_SPECIFIC_ERROR
+ */
+/**
+ * Validation error codes - Input validation failures
+ */
+export declare const ValidationErrorCodes: {
+    readonly INVALID_INPUT: "VALIDATION_INVALID_INPUT";
+    readonly REQUIRED_FIELD: "VALIDATION_REQUIRED_FIELD";
+    readonly INVALID_FORMAT: "VALIDATION_INVALID_FORMAT";
+    readonly INVALID_LENGTH: "VALIDATION_INVALID_LENGTH";
+    readonly INVALID_RANGE: "VALIDATION_INVALID_RANGE";
+    readonly INVALID_TYPE: "VALIDATION_INVALID_TYPE";
+    readonly INVALID_PERSONA_ID: "VALIDATION_INVALID_PERSONA_ID";
+    readonly INVALID_SEARCH_QUERY: "VALIDATION_INVALID_SEARCH_QUERY";
+    readonly INVALID_COLLECTION_PATH: "VALIDATION_INVALID_COLLECTION_PATH";
+    readonly INVALID_URL: "VALIDATION_INVALID_URL";
+    readonly INVALID_FILENAME: "VALIDATION_INVALID_FILENAME";
+    readonly INVALID_PATH: "VALIDATION_INVALID_PATH";
+    readonly PATH_TRAVERSAL: "VALIDATION_PATH_TRAVERSAL";
+    readonly INVALID_CHARACTER: "VALIDATION_INVALID_CHARACTER";
+    readonly CONFIRMATION_REQUIRED: "VALIDATION_CONFIRMATION_REQUIRED";
+    readonly INVALID_CATEGORY: "VALIDATION_INVALID_CATEGORY";
+    readonly CONTENT_TOO_LARGE: "VALIDATION_CONTENT_TOO_LARGE";
+    readonly TEMPLATE_TOO_LARGE: "VALIDATION_TEMPLATE_TOO_LARGE";
+    readonly TOO_MANY_VARIABLES: "VALIDATION_TOO_MANY_VARIABLES";
+    readonly INVALID_INCLUDE_PATH: "VALIDATION_INVALID_INCLUDE_PATH";
+    readonly MAX_INCLUDE_DEPTH: "VALIDATION_MAX_INCLUDE_DEPTH";
+    readonly REQUIRED_VARIABLE: "VALIDATION_REQUIRED_VARIABLE";
+    readonly DANGEROUS_PATTERN: "VALIDATION_DANGEROUS_PATTERN";
+    readonly PATTERN_TOO_COMPLEX: "VALIDATION_PATTERN_TOO_COMPLEX";
+    readonly PATTERN_MISMATCH: "VALIDATION_PATTERN_MISMATCH";
+    readonly INVALID_PATTERN: "VALIDATION_INVALID_PATTERN";
+    readonly INVALID_OPTIONS: "VALIDATION_INVALID_OPTIONS";
+    readonly INVALID_NUMBER: "VALIDATION_INVALID_NUMBER";
+    readonly INVALID_DATE: "VALIDATION_INVALID_DATE";
+    readonly INVALID_ARRAY: "VALIDATION_INVALID_ARRAY";
+    readonly INVALID_OBJECT: "VALIDATION_INVALID_OBJECT";
+    readonly INVALID_FRAMEWORK: "VALIDATION_INVALID_FRAMEWORK";
+    readonly INVALID_RISK_TOLERANCE: "VALIDATION_INVALID_RISK_TOLERANCE";
+    readonly MAX_GOALS_EXCEEDED: "VALIDATION_MAX_GOALS_EXCEEDED";
+    readonly GOAL_TOO_SHORT: "VALIDATION_GOAL_TOO_SHORT";
+    readonly HARMFUL_CONTENT: "VALIDATION_HARMFUL_CONTENT";
+    readonly DEPENDENCY_CYCLE: "VALIDATION_DEPENDENCY_CYCLE";
+    readonly GOAL_NOT_FOUND: "VALIDATION_GOAL_NOT_FOUND";
+    readonly INVALID_GOAL_STATUS: "VALIDATION_INVALID_GOAL_STATUS";
+    readonly CONTEXT_TOO_LARGE: "VALIDATION_CONTEXT_TOO_LARGE";
+    readonly STATE_TOO_LARGE: "VALIDATION_STATE_TOO_LARGE";
+};
+/**
+ * Network error codes - API and network failures
+ */
+export declare const NetworkErrorCodes: {
+    readonly REQUEST_FAILED: "NETWORK_REQUEST_FAILED";
+    readonly INVALID_RESPONSE: "NETWORK_INVALID_RESPONSE";
+    readonly RESPONSE_TOO_LARGE: "NETWORK_RESPONSE_TOO_LARGE";
+    readonly API_ERROR: "NETWORK_API_ERROR";
+    readonly RATE_LIMIT_EXCEEDED: "NETWORK_RATE_LIMIT_EXCEEDED";
+    readonly FETCH_FAILED: "NETWORK_FETCH_FAILED";
+};
+/**
+ * System error codes - Internal system failures
+ */
+export declare const SystemErrorCodes: {
+    readonly LOAD_FAILED: "SYSTEM_LOAD_FAILED";
+    readonly SAVE_FAILED: "SYSTEM_SAVE_FAILED";
+    readonly DELETE_FAILED: "SYSTEM_DELETE_FAILED";
+    readonly IMPORT_FAILED: "SYSTEM_IMPORT_FAILED";
+    readonly EXPORT_FAILED: "SYSTEM_EXPORT_FAILED";
+    readonly DESERIALIZATION_FAILED: "SYSTEM_DESERIALIZATION_FAILED";
+    readonly UNKNOWN_FRAMEWORK: "SYSTEM_UNKNOWN_FRAMEWORK";
+    readonly UNSUPPORTED_FORMAT: "SYSTEM_UNSUPPORTED_FORMAT";
+};
+/**
+ * All error codes combined for easy access
+ */
+export declare const ErrorCodes: {
+    readonly LOAD_FAILED: "SYSTEM_LOAD_FAILED";
+    readonly SAVE_FAILED: "SYSTEM_SAVE_FAILED";
+    readonly DELETE_FAILED: "SYSTEM_DELETE_FAILED";
+    readonly IMPORT_FAILED: "SYSTEM_IMPORT_FAILED";
+    readonly EXPORT_FAILED: "SYSTEM_EXPORT_FAILED";
+    readonly DESERIALIZATION_FAILED: "SYSTEM_DESERIALIZATION_FAILED";
+    readonly UNKNOWN_FRAMEWORK: "SYSTEM_UNKNOWN_FRAMEWORK";
+    readonly UNSUPPORTED_FORMAT: "SYSTEM_UNSUPPORTED_FORMAT";
+    readonly REQUEST_FAILED: "NETWORK_REQUEST_FAILED";
+    readonly INVALID_RESPONSE: "NETWORK_INVALID_RESPONSE";
+    readonly RESPONSE_TOO_LARGE: "NETWORK_RESPONSE_TOO_LARGE";
+    readonly API_ERROR: "NETWORK_API_ERROR";
+    readonly RATE_LIMIT_EXCEEDED: "NETWORK_RATE_LIMIT_EXCEEDED";
+    readonly FETCH_FAILED: "NETWORK_FETCH_FAILED";
+    readonly INVALID_INPUT: "VALIDATION_INVALID_INPUT";
+    readonly REQUIRED_FIELD: "VALIDATION_REQUIRED_FIELD";
+    readonly INVALID_FORMAT: "VALIDATION_INVALID_FORMAT";
+    readonly INVALID_LENGTH: "VALIDATION_INVALID_LENGTH";
+    readonly INVALID_RANGE: "VALIDATION_INVALID_RANGE";
+    readonly INVALID_TYPE: "VALIDATION_INVALID_TYPE";
+    readonly INVALID_PERSONA_ID: "VALIDATION_INVALID_PERSONA_ID";
+    readonly INVALID_SEARCH_QUERY: "VALIDATION_INVALID_SEARCH_QUERY";
+    readonly INVALID_COLLECTION_PATH: "VALIDATION_INVALID_COLLECTION_PATH";
+    readonly INVALID_URL: "VALIDATION_INVALID_URL";
+    readonly INVALID_FILENAME: "VALIDATION_INVALID_FILENAME";
+    readonly INVALID_PATH: "VALIDATION_INVALID_PATH";
+    readonly PATH_TRAVERSAL: "VALIDATION_PATH_TRAVERSAL";
+    readonly INVALID_CHARACTER: "VALIDATION_INVALID_CHARACTER";
+    readonly CONFIRMATION_REQUIRED: "VALIDATION_CONFIRMATION_REQUIRED";
+    readonly INVALID_CATEGORY: "VALIDATION_INVALID_CATEGORY";
+    readonly CONTENT_TOO_LARGE: "VALIDATION_CONTENT_TOO_LARGE";
+    readonly TEMPLATE_TOO_LARGE: "VALIDATION_TEMPLATE_TOO_LARGE";
+    readonly TOO_MANY_VARIABLES: "VALIDATION_TOO_MANY_VARIABLES";
+    readonly INVALID_INCLUDE_PATH: "VALIDATION_INVALID_INCLUDE_PATH";
+    readonly MAX_INCLUDE_DEPTH: "VALIDATION_MAX_INCLUDE_DEPTH";
+    readonly REQUIRED_VARIABLE: "VALIDATION_REQUIRED_VARIABLE";
+    readonly DANGEROUS_PATTERN: "VALIDATION_DANGEROUS_PATTERN";
+    readonly PATTERN_TOO_COMPLEX: "VALIDATION_PATTERN_TOO_COMPLEX";
+    readonly PATTERN_MISMATCH: "VALIDATION_PATTERN_MISMATCH";
+    readonly INVALID_PATTERN: "VALIDATION_INVALID_PATTERN";
+    readonly INVALID_OPTIONS: "VALIDATION_INVALID_OPTIONS";
+    readonly INVALID_NUMBER: "VALIDATION_INVALID_NUMBER";
+    readonly INVALID_DATE: "VALIDATION_INVALID_DATE";
+    readonly INVALID_ARRAY: "VALIDATION_INVALID_ARRAY";
+    readonly INVALID_OBJECT: "VALIDATION_INVALID_OBJECT";
+    readonly INVALID_FRAMEWORK: "VALIDATION_INVALID_FRAMEWORK";
+    readonly INVALID_RISK_TOLERANCE: "VALIDATION_INVALID_RISK_TOLERANCE";
+    readonly MAX_GOALS_EXCEEDED: "VALIDATION_MAX_GOALS_EXCEEDED";
+    readonly GOAL_TOO_SHORT: "VALIDATION_GOAL_TOO_SHORT";
+    readonly HARMFUL_CONTENT: "VALIDATION_HARMFUL_CONTENT";
+    readonly DEPENDENCY_CYCLE: "VALIDATION_DEPENDENCY_CYCLE";
+    readonly GOAL_NOT_FOUND: "VALIDATION_GOAL_NOT_FOUND";
+    readonly INVALID_GOAL_STATUS: "VALIDATION_INVALID_GOAL_STATUS";
+    readonly CONTEXT_TOO_LARGE: "VALIDATION_CONTEXT_TOO_LARGE";
+    readonly STATE_TOO_LARGE: "VALIDATION_STATE_TOO_LARGE";
+};
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
+//# sourceMappingURL=errorCodes.d.ts.map

package/dist/utils/errorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCodes.d.ts","sourceRoot":"","sources":["../../src/utils/errorCodes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;CASnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/utils/errorCodes.js

@@ -0,0 +1,87 @@
+/**
+ * Centralized error codes for consistent error handling across the application.
+ * Error codes follow the pattern: CATEGORY_SPECIFIC_ERROR
+ */
+/**
+ * Validation error codes - Input validation failures
+ */
+export const ValidationErrorCodes = {
+    // General validation
+    INVALID_INPUT: 'VALIDATION_INVALID_INPUT',
+    REQUIRED_FIELD: 'VALIDATION_REQUIRED_FIELD',
+    INVALID_FORMAT: 'VALIDATION_INVALID_FORMAT',
+    INVALID_LENGTH: 'VALIDATION_INVALID_LENGTH',
+    INVALID_RANGE: 'VALIDATION_INVALID_RANGE',
+    INVALID_TYPE: 'VALIDATION_INVALID_TYPE',
+    // Specific validation
+    INVALID_PERSONA_ID: 'VALIDATION_INVALID_PERSONA_ID',
+    INVALID_SEARCH_QUERY: 'VALIDATION_INVALID_SEARCH_QUERY',
+    INVALID_COLLECTION_PATH: 'VALIDATION_INVALID_COLLECTION_PATH',
+    INVALID_URL: 'VALIDATION_INVALID_URL',
+    INVALID_FILENAME: 'VALIDATION_INVALID_FILENAME',
+    INVALID_PATH: 'VALIDATION_INVALID_PATH',
+    PATH_TRAVERSAL: 'VALIDATION_PATH_TRAVERSAL',
+    INVALID_CHARACTER: 'VALIDATION_INVALID_CHARACTER',
+    CONFIRMATION_REQUIRED: 'VALIDATION_CONFIRMATION_REQUIRED',
+    INVALID_CATEGORY: 'VALIDATION_INVALID_CATEGORY',
+    CONTENT_TOO_LARGE: 'VALIDATION_CONTENT_TOO_LARGE',
+    // Template validation
+    TEMPLATE_TOO_LARGE: 'VALIDATION_TEMPLATE_TOO_LARGE',
+    TOO_MANY_VARIABLES: 'VALIDATION_TOO_MANY_VARIABLES',
+    INVALID_INCLUDE_PATH: 'VALIDATION_INVALID_INCLUDE_PATH',
+    MAX_INCLUDE_DEPTH: 'VALIDATION_MAX_INCLUDE_DEPTH',
+    REQUIRED_VARIABLE: 'VALIDATION_REQUIRED_VARIABLE',
+    DANGEROUS_PATTERN: 'VALIDATION_DANGEROUS_PATTERN',
+    PATTERN_TOO_COMPLEX: 'VALIDATION_PATTERN_TOO_COMPLEX',
+    PATTERN_MISMATCH: 'VALIDATION_PATTERN_MISMATCH',
+    INVALID_PATTERN: 'VALIDATION_INVALID_PATTERN',
+    INVALID_OPTIONS: 'VALIDATION_INVALID_OPTIONS',
+    INVALID_NUMBER: 'VALIDATION_INVALID_NUMBER',
+    INVALID_DATE: 'VALIDATION_INVALID_DATE',
+    INVALID_ARRAY: 'VALIDATION_INVALID_ARRAY',
+    INVALID_OBJECT: 'VALIDATION_INVALID_OBJECT',
+    // Agent validation
+    INVALID_FRAMEWORK: 'VALIDATION_INVALID_FRAMEWORK',
+    INVALID_RISK_TOLERANCE: 'VALIDATION_INVALID_RISK_TOLERANCE',
+    MAX_GOALS_EXCEEDED: 'VALIDATION_MAX_GOALS_EXCEEDED',
+    GOAL_TOO_SHORT: 'VALIDATION_GOAL_TOO_SHORT',
+    HARMFUL_CONTENT: 'VALIDATION_HARMFUL_CONTENT',
+    DEPENDENCY_CYCLE: 'VALIDATION_DEPENDENCY_CYCLE',
+    GOAL_NOT_FOUND: 'VALIDATION_GOAL_NOT_FOUND',
+    INVALID_GOAL_STATUS: 'VALIDATION_INVALID_GOAL_STATUS',
+    CONTEXT_TOO_LARGE: 'VALIDATION_CONTEXT_TOO_LARGE',
+    STATE_TOO_LARGE: 'VALIDATION_STATE_TOO_LARGE',
+};
+/**
+ * Network error codes - API and network failures
+ */
+export const NetworkErrorCodes = {
+    REQUEST_FAILED: 'NETWORK_REQUEST_FAILED',
+    INVALID_RESPONSE: 'NETWORK_INVALID_RESPONSE',
+    RESPONSE_TOO_LARGE: 'NETWORK_RESPONSE_TOO_LARGE',
+    API_ERROR: 'NETWORK_API_ERROR',
+    RATE_LIMIT_EXCEEDED: 'NETWORK_RATE_LIMIT_EXCEEDED',
+    FETCH_FAILED: 'NETWORK_FETCH_FAILED',
+};
+/**
+ * System error codes - Internal system failures
+ */
+export const SystemErrorCodes = {
+    LOAD_FAILED: 'SYSTEM_LOAD_FAILED',
+    SAVE_FAILED: 'SYSTEM_SAVE_FAILED',
+    DELETE_FAILED: 'SYSTEM_DELETE_FAILED',
+    IMPORT_FAILED: 'SYSTEM_IMPORT_FAILED',
+    EXPORT_FAILED: 'SYSTEM_EXPORT_FAILED',
+    DESERIALIZATION_FAILED: 'SYSTEM_DESERIALIZATION_FAILED',
+    UNKNOWN_FRAMEWORK: 'SYSTEM_UNKNOWN_FRAMEWORK',
+    UNSUPPORTED_FORMAT: 'SYSTEM_UNSUPPORTED_FORMAT',
+};
+/**
+ * All error codes combined for easy access
+ */
+export const ErrorCodes = {
+    ...ValidationErrorCodes,
+    ...NetworkErrorCodes,
+    ...SystemErrorCodes,
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JDb2Rlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9lcnJvckNvZGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVIOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUc7SUFDbEMscUJBQXFCO0lBQ3JCLGFBQWEsRUFBRSwwQkFBMEI7SUFDekMsY0FBYyxFQUFFLDJCQUEyQjtJQUMzQyxjQUFjLEVBQUUsMkJBQTJCO0lBQzNDLGNBQWMsRUFBRSwyQkFBMkI7SUFDM0MsYUFBYSxFQUFFLDBCQUEwQjtJQUN6QyxZQUFZLEVBQUUseUJBQXlCO0lBRXZDLHNCQUFzQjtJQUN0QixrQkFBa0IsRUFBRSwrQkFBK0I7SUFDbkQsb0JBQW9CLEVBQUUsaUNBQWlDO0lBQ3ZELHVCQUF1QixFQUFFLG9DQUFvQztJQUM3RCxXQUFXLEVBQUUsd0JBQXdCO0lBQ3JDLGdCQUFnQixFQUFFLDZCQUE2QjtJQUMvQyxZQUFZLEVBQUUseUJBQXlCO0lBQ3ZDLGNBQWMsRUFBRSwyQkFBMkI7SUFDM0MsaUJBQWlCLEVBQUUsOEJBQThCO0lBQ2pELHFCQUFxQixFQUFFLGtDQUFrQztJQUN6RCxnQkFBZ0IsRUFBRSw2QkFBNkI7SUFDL0MsaUJBQWlCLEVBQUUsOEJBQThCO0lBRWpELHNCQUFzQjtJQUN0QixrQkFBa0IsRUFBRSwrQkFBK0I7SUFDbkQsa0JBQWtCLEVBQUUsK0JBQStCO0lBQ25ELG9CQUFvQixFQUFFLGlDQUFpQztJQUN2RCxpQkFBaUIsRUFBRSw4QkFBOEI7SUFDakQsaUJBQWlCLEVBQUUsOEJBQThCO0lBQ2pELGlCQUFpQixFQUFFLDhCQUE4QjtJQUNqRCxtQkFBbUIsRUFBRSxnQ0FBZ0M7SUFDckQsZ0JBQWdCLEVBQUUsNkJBQTZCO0lBQy9DLGVBQWUsRUFBRSw0QkFBNEI7SUFDN0MsZUFBZSxFQUFFLDRCQUE0QjtJQUM3QyxjQUFjLEVBQUUsMkJBQTJCO0lBQzNDLFlBQVksRUFBRSx5QkFBeUI7SUFDdkMsYUFBYSxFQUFFLDBCQUEwQjtJQUN6QyxjQUFjLEVBQUUsMkJBQTJCO0lBRTNDLG1CQUFtQjtJQUNuQixpQkFBaUIsRUFBRSw4QkFBOEI7SUFDakQsc0JBQXNCLEVBQUUsbUNBQW1DO0lBQzNELGtCQUFrQixFQUFFLCtCQUErQjtJQUNuRCxjQUFjLEVBQUUsMkJBQTJCO0lBQzNDLGVBQWUsRUFBRSw0QkFBNEI7SUFDN0MsZ0JBQWdCLEVBQUUsNkJBQTZCO0lBQy9DLGNBQWMsRUFBRSwyQkFBMkI7SUFDM0MsbUJBQW1CLEVBQUUsZ0NBQWdDO0lBQ3JELGlCQUFpQixFQUFFLDhCQUE4QjtJQUNqRCxlQUFlLEVBQUUsNEJBQTRCO0NBQ3JDLENBQUM7QUFFWDs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHO0lBQy9CLGNBQWMsRUFBRSx3QkFBd0I7SUFDeEMsZ0JBQWdCLEVBQUUsMEJBQTBCO0lBQzVDLGtCQUFrQixFQUFFLDRCQUE0QjtJQUNoRCxTQUFTLEVBQUUsbUJBQW1CO0lBQzlCLG1CQUFtQixFQUFFLDZCQUE2QjtJQUNsRCxZQUFZLEVBQUUsc0JBQXNCO0NBQzVCLENBQUM7QUFFWDs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHO0lBQzlCLFdBQVcsRUFBRSxvQkFBb0I7SUFDakMsV0FBVyxFQUFFLG9CQUFvQjtJQUNqQyxhQUFhLEVBQUUsc0JBQXNCO0lBQ3JDLGFBQWEsRUFBRSxzQkFBc0I7SUFDckMsYUFBYSxFQUFFLHNCQUFzQjtJQUNyQyxzQkFBc0IsRUFBRSwrQkFBK0I7SUFDdkQsaUJBQWlCLEVBQUUsMEJBQTBCO0lBQzdDLGtCQUFrQixFQUFFLDJCQUEyQjtDQUN2QyxDQUFDO0FBRVg7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxVQUFVLEdBQUc7SUFDeEIsR0FBRyxvQkFBb0I7SUFDdkIsR0FBRyxpQkFBaUI7SUFDcEIsR0FBRyxnQkFBZ0I7Q0FDWCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBDZW50cmFsaXplZCBlcnJvciBjb2RlcyBmb3IgY29uc2lzdGVudCBlcnJvciBoYW5kbGluZyBhY3Jvc3MgdGhlIGFwcGxpY2F0aW9uLlxuICogRXJyb3IgY29kZXMgZm9sbG93IHRoZSBwYXR0ZXJuOiBDQVRFR09SWV9TUEVDSUZJQ19FUlJPUlxuICovXG5cbi8qKlxuICogVmFsaWRhdGlvbiBlcnJvciBjb2RlcyAtIElucHV0IHZhbGlkYXRpb24gZmFpbHVyZXNcbiAqL1xuZXhwb3J0IGNvbnN0IFZhbGlkYXRpb25FcnJvckNvZGVzID0ge1xuICAvLyBHZW5lcmFsIHZhbGlkYXRpb25cbiAgSU5WQUxJRF9JTlBVVDogJ1ZBTElEQVRJT05fSU5WQUxJRF9JTlBVVCcsXG4gIFJFUVVJUkVEX0ZJRUxEOiAnVkFMSURBVElPTl9SRVFVSVJFRF9GSUVMRCcsXG4gIElOVkFMSURfRk9STUFUOiAnVkFMSURBVElPTl9JTlZBTElEX0ZPUk1BVCcsXG4gIElOVkFMSURfTEVOR1RIOiAnVkFMSURBVElPTl9JTlZBTElEX0xFTkdUSCcsXG4gIElOVkFMSURfUkFOR0U6ICdWQUxJREFUSU9OX0lOVkFMSURfUkFOR0UnLFxuICBJTlZBTElEX1RZUEU6ICdWQUxJREFUSU9OX0lOVkFMSURfVFlQRScsXG4gIFxuICAvLyBTcGVjaWZpYyB2YWxpZGF0aW9uXG4gIElOVkFMSURfUEVSU09OQV9JRDogJ1ZBTElEQVRJT05fSU5WQUxJRF9QRVJTT05BX0lEJyxcbiAgSU5WQUxJRF9TRUFSQ0hfUVVFUlk6ICdWQUxJREFUSU9OX0lOVkFMSURfU0VBUkNIX1FVRVJZJyxcbiAgSU5WQUxJRF9DT0xMRUNUSU9OX1BBVEg6ICdWQUxJREFUSU9OX0lOVkFMSURfQ09MTEVDVElPTl9QQVRIJyxcbiAgSU5WQUxJRF9VUkw6ICdWQUxJREFUSU9OX0lOVkFMSURfVVJMJyxcbiAgSU5WQUxJRF9GSUxFTkFNRTogJ1ZBTElEQVRJT05fSU5WQUxJRF9GSUxFTkFNRScsXG4gIElOVkFMSURfUEFUSDogJ1ZBTElEQVRJT05fSU5WQUxJRF9QQVRIJyxcbiAgUEFUSF9UUkFWRVJTQUw6ICdWQUxJREFUSU9OX1BBVEhfVFJBVkVSU0FMJyxcbiAgSU5WQUxJRF9DSEFSQUNURVI6ICdWQUxJREFUSU9OX0lOVkFMSURfQ0hBUkFDVEVSJyxcbiAgQ09ORklSTUFUSU9OX1JFUVVJUkVEOiAnVkFMSURBVElPTl9DT05GSVJNQVRJT05fUkVRVUlSRUQnLFxuICBJTlZBTElEX0NBVEVHT1JZOiAnVkFMSURBVElPTl9JTlZBTElEX0NBVEVHT1JZJyxcbiAgQ09OVEVOVF9UT09fTEFSR0U6ICdWQUxJREFUSU9OX0NPTlRFTlRfVE9PX0xBUkdFJyxcbiAgXG4gIC8vIFRlbXBsYXRlIHZhbGlkYXRpb25cbiAgVEVNUExBVEVfVE9PX0xBUkdFOiAnVkFMSURBVElPTl9URU1QTEFURV9UT09fTEFSR0UnLFxuICBUT09fTUFOWV9WQVJJQUJMRVM6ICdWQUxJREFUSU9OX1RPT19NQU5ZX1ZBUklBQkxFUycsXG4gIElOVkFMSURfSU5DTFVERV9QQVRIOiAnVkFMSURBVElPTl9JTlZBTElEX0lOQ0xVREVfUEFUSCcsXG4gIE1BWF9JTkNMVURFX0RFUFRIOiAnVkFMSURBVElPTl9NQVhfSU5DTFVERV9ERVBUSCcsXG4gIFJFUVVJUkVEX1ZBUklBQkxFOiAnVkFMSURBVElPTl9SRVFVSVJFRF9WQVJJQUJMRScsXG4gIERBTkdFUk9VU19QQVRURVJOOiAnVkFMSURBVElPTl9EQU5HRVJPVVNfUEFUVEVSTicsXG4gIFBBVFRFUk5fVE9PX0NPTVBMRVg6ICdWQUxJREFUSU9OX1BBVFRFUk5fVE9PX0NPTVBMRVgnLFxuICBQQVRURVJOX01JU01BVENIOiAnVkFMSURBVElPTl9QQVRURVJOX01JU01BVENIJyxcbiAgSU5WQUxJRF9QQVRURVJOOiAnVkFMSURBVElPTl9JTlZBTElEX1BBVFRFUk4nLFxuICBJTlZBTElEX09QVElPTlM6ICdWQUxJREFUSU9OX0lOVkFMSURfT1BUSU9OUycsXG4gIElOVkFMSURfTlVNQkVSOiAnVkFMSURBVElPTl9JTlZBTElEX05VTUJFUicsXG4gIElOVkFMSURfREFURTogJ1ZBTElEQVRJT05fSU5WQUxJRF9EQVRFJyxcbiAgSU5WQUxJRF9BUlJBWTogJ1ZBTElEQVRJT05fSU5WQUxJRF9BUlJBWScsXG4gIElOVkFMSURfT0JKRUNUOiAnVkFMSURBVElPTl9JTlZBTElEX09CSkVDVCcsXG4gIFxuICAvLyBBZ2VudCB2YWxpZGF0aW9uXG4gIElOVkFMSURfRlJBTUVXT1JLOiAnVkFMSURBVElPTl9JTlZBTElEX0ZSQU1FV09SSycsXG4gIElOVkFMSURfUklTS19UT0xFUkFOQ0U6ICdWQUxJREFUSU9OX0lOVkFMSURfUklTS19UT0xFUkFOQ0UnLFxuICBNQVhfR09BTFNfRVhDRUVERUQ6ICdWQUxJREFUSU9OX01BWF9HT0FMU19FWENFRURFRCcsXG4gIEdPQUxfVE9PX1NIT1JUOiAnVkFMSURBVElPTl9HT0FMX1RPT19TSE9SVCcsXG4gIEhBUk1GVUxfQ09OVEVOVDogJ1ZBTElEQVRJT05fSEFSTUZVTF9DT05URU5UJyxcbiAgREVQRU5ERU5DWV9DWUNMRTogJ1ZBTElEQVRJT05fREVQRU5ERU5DWV9DWUNMRScsXG4gIEdPQUxfTk9UX0ZPVU5EOiAnVkFMSURBVElPTl9HT0FMX05PVF9GT1VORCcsXG4gIElOVkFMSURfR09BTF9TVEFUVVM6ICdWQUxJREFUSU9OX0lOVkFMSURfR09BTF9TVEFUVVMnLFxuICBDT05URVhUX1RPT19MQVJHRTogJ1ZBTElEQVRJT05fQ09OVEVYVF9UT09fTEFSR0UnLFxuICBTVEFURV9UT09fTEFSR0U6ICdWQUxJREFUSU9OX1NUQVRFX1RPT19MQVJHRScsXG59IGFzIGNvbnN0O1xuXG4vKipcbiAqIE5ldHdvcmsgZXJyb3IgY29kZXMgLSBBUEkgYW5kIG5ldHdvcmsgZmFpbHVyZXNcbiAqL1xuZXhwb3J0IGNvbnN0IE5ldHdvcmtFcnJvckNvZGVzID0ge1xuICBSRVFVRVNUX0ZBSUxFRDogJ05FVFdPUktfUkVRVUVTVF9GQUlMRUQnLFxuICBJTlZBTElEX1JFU1BPTlNFOiAnTkVUV09SS19JTlZBTElEX1JFU1BPTlNFJyxcbiAgUkVTUE9OU0VfVE9PX0xBUkdFOiAnTkVUV09SS19SRVNQT05TRV9UT09fTEFSR0UnLFxuICBBUElfRVJST1I6ICdORVRXT1JLX0FQSV9FUlJPUicsXG4gIFJBVEVfTElNSVRfRVhDRUVERUQ6ICdORVRXT1JLX1JBVEVfTElNSVRfRVhDRUVERUQnLFxuICBGRVRDSF9GQUlMRUQ6ICdORVRXT1JLX0ZFVENIX0ZBSUxFRCcsXG59IGFzIGNvbnN0O1xuXG4vKipcbiAqIFN5c3RlbSBlcnJvciBjb2RlcyAtIEludGVybmFsIHN5c3RlbSBmYWlsdXJlc1xuICovXG5leHBvcnQgY29uc3QgU3lzdGVtRXJyb3JDb2RlcyA9IHtcbiAgTE9BRF9GQUlMRUQ6ICdTWVNURU1fTE9BRF9GQUlMRUQnLFxuICBTQVZFX0ZBSUxFRDogJ1NZU1RFTV9TQVZFX0ZBSUxFRCcsXG4gIERFTEVURV9GQUlMRUQ6ICdTWVNURU1fREVMRVRFX0ZBSUxFRCcsXG4gIElNUE9SVF9GQUlMRUQ6ICdTWVNURU1fSU1QT1JUX0ZBSUxFRCcsXG4gIEVYUE9SVF9GQUlMRUQ6ICdTWVNURU1fRVhQT1JUX0ZBSUxFRCcsXG4gIERFU0VSSUFMSVpBVElPTl9GQUlMRUQ6ICdTWVNURU1fREVTRVJJQUxJWkFUSU9OX0ZBSUxFRCcsXG4gIFVOS05PV05fRlJBTUVXT1JLOiAnU1lTVEVNX1VOS05PV05fRlJBTUVXT1JLJyxcbiAgVU5TVVBQT1JURURfRk9STUFUOiAnU1lTVEVNX1VOU1VQUE9SVEVEX0ZPUk1BVCcsXG59IGFzIGNvbnN0O1xuXG4vKipcbiAqIEFsbCBlcnJvciBjb2RlcyBjb21iaW5lZCBmb3IgZWFzeSBhY2Nlc3NcbiAqL1xuZXhwb3J0IGNvbnN0IEVycm9yQ29kZXMgPSB7XG4gIC4uLlZhbGlkYXRpb25FcnJvckNvZGVzLFxuICAuLi5OZXR3b3JrRXJyb3JDb2RlcyxcbiAgLi4uU3lzdGVtRXJyb3JDb2Rlcyxcbn0gYXMgY29uc3Q7XG5cbmV4cG9ydCB0eXBlIEVycm9yQ29kZSA9IHR5cGVvZiBFcnJvckNvZGVzW2tleW9mIHR5cGVvZiBFcnJvckNvZGVzXTsiXX0=

package/dist/utils/index.d.ts

@@ -4,4 +4,7 @@
 export * from './git.js';
 export * from './filesystem.js';
 export * from './version.js';
+export * from './SecureDownloader.js';
+export * from './RateLimiter.js';
+export * from './ToolCache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -4,4 +4,7 @@
 export * from './git.js';
 export * from './filesystem.js';
 export * from './version.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSCxjQUFjLFVBQVUsQ0FBQztBQUN6QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsY0FBYyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBVdGlsaXRpZXMgbW9kdWxlIGV4cG9ydHNcbiAqL1xuXG5leHBvcnQgKiBmcm9tICcuL2dpdC5qcyc7XG5leHBvcnQgKiBmcm9tICcuL2ZpbGVzeXN0ZW0uanMnO1xuZXhwb3J0ICogZnJvbSAnLi92ZXJzaW9uLmpzJzsiXX0=
+export * from './SecureDownloader.js';
+export * from './RateLimiter.js';
+export * from './ToolCache.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSCxjQUFjLFVBQVUsQ0FBQztBQUN6QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsdUJBQXVCLENBQUM7QUFDdEMsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLGdCQUFnQixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBVdGlsaXRpZXMgbW9kdWxlIGV4cG9ydHNcbiAqL1xuXG5leHBvcnQgKiBmcm9tICcuL2dpdC5qcyc7XG5leHBvcnQgKiBmcm9tICcuL2ZpbGVzeXN0ZW0uanMnO1xuZXhwb3J0ICogZnJvbSAnLi92ZXJzaW9uLmpzJztcbmV4cG9ydCAqIGZyb20gJy4vU2VjdXJlRG93bmxvYWRlci5qcyc7XG5leHBvcnQgKiBmcm9tICcuL1JhdGVMaW1pdGVyLmpzJztcbmV4cG9ydCAqIGZyb20gJy4vVG9vbENhY2hlLmpzJzsiXX0=

package/dist/utils/installation.d.ts

@@ -5,7 +5,7 @@
 export type InstallationType = 'npm' | 'git' | 'unknown';
 export declare class InstallationDetector {
     private static cachedType;
-    private static get MAX_SEARCH_DEPTH();
+    private static readonly MAX_SEARCH_DEPTH;
     /**
      * Detect the installation type (npm global, git clone, or unknown)
      */

package/dist/utils/installation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/utils/installation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAiC;IAG1D,OAAO,CAAC,MAAM,KAAK,gBAAgB,GAElC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,gBAAgB;IA8D9C;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,GAAG,IAAI;IA2BxC;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM,GAAG,IAAI;IA4B5C;;OAEG;IACH,MAAM,CAAC,0BAA0B,IAAI,MAAM;IAqB3C;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;CAG1B"}
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/utils/installation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAiC;IAG1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAM;IAE9C;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,gBAAgB;IAgE9C;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,GAAG,IAAI;IA6BxC;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM,GAAG,IAAI;IA4B5C;;OAEG;IACH,MAAM,CAAC,0BAA0B,IAAI,MAAM;IAqB3C;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;CAG1B"}