@soulcraft/brainy 0.41.0 → 0.44.0

package/dist/distributed/healthMonitor.js

@@ -0,0 +1,244 @@
+/**
+ * Health Monitor
+ * Monitors and reports instance health in distributed deployments
+ */
+export class HealthMonitor {
+    constructor(configManager) {
+        this.requestCount = 0;
+        this.errorCount = 0;
+        this.totalLatency = 0;
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+        this.vectorCount = 0;
+        this.checkInterval = 30000; // 30 seconds
+        this.metricsWindow = []; // Sliding window for RPS calculation
+        this.latencyWindow = []; // Sliding window for latency
+        this.windowSize = 60000; // 1 minute window
+        this.configManager = configManager;
+        this.startTime = Date.now();
+    }
+    /**
+     * Start health monitoring
+     */
+    start() {
+        // Initial health update
+        this.updateHealth();
+        // Schedule periodic health checks
+        this.healthCheckTimer = setInterval(() => {
+            this.updateHealth();
+        }, this.checkInterval);
+    }
+    /**
+     * Stop health monitoring
+     */
+    stop() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+    }
+    /**
+     * Update health status and metrics
+     */
+    async updateHealth() {
+        const metrics = this.collectMetrics();
+        // Update config with latest metrics
+        await this.configManager.updateMetrics({
+            vectorCount: metrics.vectorCount,
+            cacheHitRate: metrics.cacheHitRate,
+            memoryUsage: metrics.memoryUsage,
+            cpuUsage: metrics.cpuUsage
+        });
+        // Clean sliding windows
+        this.cleanWindows();
+    }
+    /**
+     * Collect current metrics
+     */
+    collectMetrics() {
+        const memUsage = process.memoryUsage();
+        return {
+            vectorCount: this.vectorCount,
+            cacheHitRate: this.calculateCacheHitRate(),
+            memoryUsage: memUsage.heapUsed,
+            cpuUsage: this.getCPUUsage(),
+            requestsPerSecond: this.calculateRPS(),
+            averageLatency: this.calculateAverageLatency(),
+            errorRate: this.calculateErrorRate()
+        };
+    }
+    /**
+     * Calculate cache hit rate
+     */
+    calculateCacheHitRate() {
+        const total = this.cacheHits + this.cacheMisses;
+        if (total === 0)
+            return 0;
+        return this.cacheHits / total;
+    }
+    /**
+     * Calculate requests per second
+     */
+    calculateRPS() {
+        const now = Date.now();
+        const recentRequests = this.metricsWindow.filter(timestamp => now - timestamp < this.windowSize);
+        return recentRequests.length / (this.windowSize / 1000);
+    }
+    /**
+     * Calculate average latency
+     */
+    calculateAverageLatency() {
+        if (this.latencyWindow.length === 0)
+            return 0;
+        const sum = this.latencyWindow.reduce((a, b) => a + b, 0);
+        return sum / this.latencyWindow.length;
+    }
+    /**
+     * Calculate error rate
+     */
+    calculateErrorRate() {
+        if (this.requestCount === 0)
+            return 0;
+        return this.errorCount / this.requestCount;
+    }
+    /**
+     * Get CPU usage (simplified)
+     */
+    getCPUUsage() {
+        // Simplified CPU usage based on process time
+        const usage = process.cpuUsage();
+        const total = usage.user + usage.system;
+        const seconds = (Date.now() - this.startTime) / 1000;
+        return Math.min(100, (total / 1000000 / seconds) * 100);
+    }
+    /**
+     * Clean old entries from sliding windows
+     */
+    cleanWindows() {
+        const now = Date.now();
+        const cutoff = now - this.windowSize;
+        this.metricsWindow = this.metricsWindow.filter(t => t > cutoff);
+        // Keep only recent latency measurements
+        if (this.latencyWindow.length > 100) {
+            this.latencyWindow = this.latencyWindow.slice(-100);
+        }
+    }
+    /**
+     * Record a request
+     * @param latency - Request latency in milliseconds
+     * @param error - Whether the request resulted in an error
+     */
+    recordRequest(latency, error = false) {
+        this.requestCount++;
+        this.metricsWindow.push(Date.now());
+        this.latencyWindow.push(latency);
+        if (error) {
+            this.errorCount++;
+        }
+    }
+    /**
+     * Record cache access
+     * @param hit - Whether it was a cache hit
+     */
+    recordCacheAccess(hit) {
+        if (hit) {
+            this.cacheHits++;
+        }
+        else {
+            this.cacheMisses++;
+        }
+    }
+    /**
+     * Update vector count
+     * @param count - New vector count
+     */
+    updateVectorCount(count) {
+        this.vectorCount = count;
+    }
+    /**
+     * Get current health status
+     * @returns Health status object
+     */
+    getHealthStatus() {
+        const metrics = this.collectMetrics();
+        const uptime = Date.now() - this.startTime;
+        const warnings = [];
+        const errors = [];
+        // Check for warnings
+        if (metrics.memoryUsage > 1024 * 1024 * 1024) { // > 1GB
+            warnings.push('High memory usage detected');
+        }
+        if (metrics.cacheHitRate < 0.5) {
+            warnings.push('Low cache hit rate');
+        }
+        if (metrics.errorRate && metrics.errorRate > 0.05) {
+            warnings.push('High error rate detected');
+        }
+        if (metrics.averageLatency && metrics.averageLatency > 1000) {
+            warnings.push('High latency detected');
+        }
+        // Check for errors
+        if (metrics.memoryUsage > 2 * 1024 * 1024 * 1024) { // > 2GB
+            errors.push('Critical memory usage');
+        }
+        if (metrics.errorRate && metrics.errorRate > 0.2) {
+            errors.push('Critical error rate');
+        }
+        // Determine overall status
+        let status = 'healthy';
+        if (errors.length > 0) {
+            status = 'unhealthy';
+        }
+        else if (warnings.length > 0) {
+            status = 'degraded';
+        }
+        return {
+            status,
+            instanceId: this.configManager.getInstanceId(),
+            role: this.configManager.getRole(),
+            uptime,
+            lastCheck: new Date().toISOString(),
+            metrics,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            errors: errors.length > 0 ? errors : undefined
+        };
+    }
+    /**
+     * Get health check endpoint data
+     * @returns JSON-serializable health data
+     */
+    getHealthEndpointData() {
+        const status = this.getHealthStatus();
+        return {
+            status: status.status,
+            instanceId: status.instanceId,
+            role: status.role,
+            uptime: Math.floor(status.uptime / 1000), // Convert to seconds
+            lastCheck: status.lastCheck,
+            metrics: {
+                vectorCount: status.metrics.vectorCount,
+                cacheHitRate: Math.round(status.metrics.cacheHitRate * 100) / 100,
+                memoryUsageMB: Math.round(status.metrics.memoryUsage / 1024 / 1024),
+                cpuUsagePercent: Math.round(status.metrics.cpuUsage || 0),
+                requestsPerSecond: Math.round(status.metrics.requestsPerSecond || 0),
+                averageLatencyMs: Math.round(status.metrics.averageLatency || 0),
+                errorRate: Math.round((status.metrics.errorRate || 0) * 100) / 100
+            },
+            warnings: status.warnings,
+            errors: status.errors
+        };
+    }
+    /**
+     * Reset metrics (useful for testing)
+     */
+    resetMetrics() {
+        this.requestCount = 0;
+        this.errorCount = 0;
+        this.totalLatency = 0;
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+        this.metricsWindow = [];
+        this.latencyWindow = [];
+    }
+}
+//# sourceMappingURL=healthMonitor.js.map

package/dist/distributed/healthMonitor.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/distributed/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,UAAU,EACV,sBAAsB,EACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,YAAY,EACV,aAAa,EACb,YAAY,EACb,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,aAAa,EACd,MAAM,qBAAqB,CAAA"}

package/dist/distributed/index.js

@@ -0,0 +1,9 @@
+/**
+ * Distributed module exports
+ */
+export { DistributedConfigManager } from './configManager.js';
+export { HashPartitioner, AffinityPartitioner } from './hashPartitioner.js';
+export { BaseOperationalMode, ReaderMode, WriterMode, HybridMode, OperationalModeFactory } from './operationalModes.js';
+export { DomainDetector } from './domainDetector.js';
+export { HealthMonitor } from './healthMonitor.js';
+//# sourceMappingURL=index.js.map

package/dist/distributed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/distributed/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,UAAU,EACV,sBAAsB,EACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/distributed/operationalModes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationalModes.d.ts","sourceRoot":"","sources":["../../src/distributed/operationalModes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACb,MAAM,8BAA8B,CAAA;AAErC;;GAEG;AACH,8BAAsB,mBAAoB,YAAW,eAAe;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IAErC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI;CAmBhE;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;IACjD,OAAO,UAAO;IACd,QAAQ,UAAQ;IAChB,SAAS,UAAQ;IAEjB,aAAa,EAAE,aAAa,CAQ3B;IAED;;OAEG;IACH,cAAc;;;;;;;;;CAWf;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;IACjD,OAAO,UAAQ;IACf,QAAQ,UAAO;IACf,SAAS,UAAO;IAEhB,aAAa,EAAE,aAAa,CAQ3B;IAED;;OAEG;IACH,cAAc;;;;;;;;CAUf;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;IACjD,OAAO,UAAO;IACd,QAAQ,UAAO;IACf,SAAS,UAAO;IAEhB,aAAa,EAAE,aAAa,CAQ3B;IAED,OAAO,CAAC,cAAc,CAAc;IAEpC;;OAEG;IACH,cAAc;;;;;;;;IAWd;;;;OAIG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAwBnE;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB;IAc1D;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAC3B,IAAI,EAAE,YAAY,EAClB,cAAc,EAAE,OAAO,CAAC,aAAa,CAAC,GACrC,mBAAmB;CAWvB"}

package/dist/distributed/operationalModes.js

@@ -0,0 +1,201 @@
+/**
+ * Operational Modes for Distributed Brainy
+ * Defines different modes with optimized caching strategies
+ */
+/**
+ * Base operational mode
+ */
+export class BaseOperationalMode {
+    /**
+     * Validate operation is allowed in this mode
+     */
+    validateOperation(operation) {
+        switch (operation) {
+            case 'read':
+                if (!this.canRead) {
+                    throw new Error('Read operations are not allowed in write-only mode');
+                }
+                break;
+            case 'write':
+                if (!this.canWrite) {
+                    throw new Error('Write operations are not allowed in read-only mode');
+                }
+                break;
+            case 'delete':
+                if (!this.canDelete) {
+                    throw new Error('Delete operations are not allowed in this mode');
+                }
+                break;
+        }
+    }
+}
+/**
+ * Read-only mode optimized for query performance
+ */
+export class ReaderMode extends BaseOperationalMode {
+    constructor() {
+        super(...arguments);
+        this.canRead = true;
+        this.canWrite = false;
+        this.canDelete = false;
+        this.cacheStrategy = {
+            hotCacheRatio: 0.8, // 80% of memory for read cache
+            prefetchAggressive: true, // Aggressively prefetch related vectors
+            ttl: 3600000, // 1 hour cache TTL
+            compressionEnabled: true, // Trade CPU for more cache capacity
+            writeBufferSize: 0, // No write buffer needed
+            batchWrites: false, // No writes
+            adaptive: true // Adapt to query patterns
+        };
+    }
+    /**
+     * Get optimized cache configuration for readers
+     */
+    getCacheConfig() {
+        return {
+            hotCacheMaxSize: 1000000, // Large hot cache
+            hotCacheEvictionThreshold: 0.9, // Keep cache full
+            warmCacheTTL: 3600000, // 1 hour warm cache
+            batchSize: 100, // Large batch reads
+            autoTune: true, // Auto-tune for read patterns
+            autoTuneInterval: 60000, // Tune every minute
+            readOnly: true // Enable read-only optimizations
+        };
+    }
+}
+/**
+ * Write-only mode optimized for ingestion
+ */
+export class WriterMode extends BaseOperationalMode {
+    constructor() {
+        super(...arguments);
+        this.canRead = false;
+        this.canWrite = true;
+        this.canDelete = true;
+        this.cacheStrategy = {
+            hotCacheRatio: 0.2, // Only 20% for cache, rest for write buffer
+            prefetchAggressive: false, // No prefetching needed
+            ttl: 60000, // Short TTL (1 minute)
+            compressionEnabled: false, // Speed over memory efficiency
+            writeBufferSize: 10000, // Large write buffer for batching
+            batchWrites: true, // Enable write batching
+            adaptive: false // Fixed strategy for consistent writes
+        };
+    }
+    /**
+     * Get optimized cache configuration for writers
+     */
+    getCacheConfig() {
+        return {
+            hotCacheMaxSize: 100000, // Small hot cache
+            hotCacheEvictionThreshold: 0.5, // Aggressive eviction
+            warmCacheTTL: 60000, // 1 minute warm cache
+            batchSize: 1000, // Large batch writes
+            autoTune: false, // Fixed configuration
+            writeOnly: true // Enable write-only optimizations
+        };
+    }
+}
+/**
+ * Hybrid mode that can both read and write
+ */
+export class HybridMode extends BaseOperationalMode {
+    constructor() {
+        super(...arguments);
+        this.canRead = true;
+        this.canWrite = true;
+        this.canDelete = true;
+        this.cacheStrategy = {
+            hotCacheRatio: 0.5, // Balanced cache/buffer allocation
+            prefetchAggressive: false, // Moderate prefetching
+            ttl: 600000, // 10 minute TTL
+            compressionEnabled: true, // Compress when beneficial
+            writeBufferSize: 5000, // Moderate write buffer
+            batchWrites: true, // Batch writes when possible
+            adaptive: true // Adapt to workload mix
+        };
+        this.readWriteRatio = 0.5; // Track read/write ratio
+    }
+    /**
+     * Get balanced cache configuration
+     */
+    getCacheConfig() {
+        return {
+            hotCacheMaxSize: 500000, // Medium cache size
+            hotCacheEvictionThreshold: 0.7, // Balanced eviction
+            warmCacheTTL: 600000, // 10 minute warm cache
+            batchSize: 500, // Medium batch size
+            autoTune: true, // Auto-tune based on workload
+            autoTuneInterval: 300000 // Tune every 5 minutes
+        };
+    }
+    /**
+     * Update cache strategy based on workload
+     * @param readCount - Number of recent reads
+     * @param writeCount - Number of recent writes
+     */
+    updateWorkloadBalance(readCount, writeCount) {
+        const total = readCount + writeCount;
+        if (total === 0)
+            return;
+        this.readWriteRatio = readCount / total;
+        // Adjust cache strategy based on workload
+        if (this.readWriteRatio > 0.8) {
+            // Read-heavy workload
+            this.cacheStrategy.hotCacheRatio = 0.7;
+            this.cacheStrategy.prefetchAggressive = true;
+            this.cacheStrategy.writeBufferSize = 2000;
+        }
+        else if (this.readWriteRatio < 0.2) {
+            // Write-heavy workload
+            this.cacheStrategy.hotCacheRatio = 0.3;
+            this.cacheStrategy.prefetchAggressive = false;
+            this.cacheStrategy.writeBufferSize = 8000;
+        }
+        else {
+            // Balanced workload
+            this.cacheStrategy.hotCacheRatio = 0.5;
+            this.cacheStrategy.prefetchAggressive = false;
+            this.cacheStrategy.writeBufferSize = 5000;
+        }
+    }
+}
+/**
+ * Factory for creating operational modes
+ */
+export class OperationalModeFactory {
+    /**
+     * Create operational mode based on role
+     * @param role - The instance role
+     * @returns The appropriate operational mode
+     */
+    static createMode(role) {
+        switch (role) {
+            case 'reader':
+                return new ReaderMode();
+            case 'writer':
+                return new WriterMode();
+            case 'hybrid':
+                return new HybridMode();
+            default:
+                // Default to reader for safety
+                return new ReaderMode();
+        }
+    }
+    /**
+     * Create mode with custom cache strategy
+     * @param role - The instance role
+     * @param customStrategy - Custom cache strategy overrides
+     * @returns The operational mode with custom strategy
+     */
+    static createModeWithStrategy(role, customStrategy) {
+        const mode = this.createMode(role);
+        // Apply custom strategy overrides
+        mode.cacheStrategy = {
+            ...mode.cacheStrategy,
+            ...customStrategy
+        };
+        return mode;
+    }
+}
+//# sourceMappingURL=operationalModes.js.map

package/dist/distributed/operationalModes.js.map

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

package/dist/errors/brainyError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainyError.d.ts","sourceRoot":"","sources":["../../src/errors/brainyError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,iBAAiB,CAAA;AAEjG;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,eAAe,CAAA;IACrC,SAAgB,SAAS,EAAE,OAAO,CAAA;IAClC,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAA;IACrC,SAAgB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAA;gBAG/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,SAAS,GAAE,OAAe,EAC1B,aAAa,CAAC,EAAE,KAAK,EACrB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM;IAgBvB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,GAAG,WAAW;IASxF;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,GAAG,WAAW;IASnE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,GAAG,WAAW;IASnE;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAQ9C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,WAAW;IAW5F;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAqCzC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW;CAkClE"}

package/dist/errors/brainyError.js

@@ -0,0 +1,113 @@
+/**
+ * Custom error types for Brainy operations
+ * Provides better error classification and handling
+ */
+/**
+ * Custom error class for Brainy operations
+ * Provides error type classification and retry information
+ */
+export class BrainyError extends Error {
+    constructor(message, type, retryable = false, originalError, attemptNumber, maxRetries) {
+        super(message);
+        this.name = 'BrainyError';
+        this.type = type;
+        this.retryable = retryable;
+        this.originalError = originalError;
+        this.attemptNumber = attemptNumber;
+        this.maxRetries = maxRetries;
+        // Maintain proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, BrainyError);
+        }
+    }
+    /**
+     * Create a timeout error
+     */
+    static timeout(operation, timeoutMs, originalError) {
+        return new BrainyError(`Operation '${operation}' timed out after ${timeoutMs}ms`, 'TIMEOUT', true, originalError);
+    }
+    /**
+     * Create a network error
+     */
+    static network(message, originalError) {
+        return new BrainyError(`Network error: ${message}`, 'NETWORK', true, originalError);
+    }
+    /**
+     * Create a storage error
+     */
+    static storage(message, originalError) {
+        return new BrainyError(`Storage error: ${message}`, 'STORAGE', true, originalError);
+    }
+    /**
+     * Create a not found error
+     */
+    static notFound(resource) {
+        return new BrainyError(`Resource not found: ${resource}`, 'NOT_FOUND', false);
+    }
+    /**
+     * Create a retry exhausted error
+     */
+    static retryExhausted(operation, maxRetries, lastError) {
+        return new BrainyError(`Operation '${operation}' failed after ${maxRetries} retry attempts`, 'RETRY_EXHAUSTED', false, lastError, maxRetries, maxRetries);
+    }
+    /**
+     * Check if an error is retryable
+     */
+    static isRetryable(error) {
+        if (error instanceof BrainyError) {
+            return error.retryable;
+        }
+        // Check for common retryable error patterns
+        const message = error.message.toLowerCase();
+        const name = error.name.toLowerCase();
+        // Network-related errors that are typically retryable
+        if (message.includes('timeout') ||
+            message.includes('network') ||
+            message.includes('connection') ||
+            message.includes('econnreset') ||
+            message.includes('enotfound') ||
+            message.includes('etimedout') ||
+            name.includes('timeout')) {
+            return true;
+        }
+        // AWS SDK specific retryable errors
+        if (message.includes('throttling') ||
+            message.includes('rate limit') ||
+            message.includes('service unavailable') ||
+            message.includes('internal server error') ||
+            message.includes('bad gateway') ||
+            message.includes('gateway timeout')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Convert a generic error to a BrainyError with appropriate classification
+     */
+    static fromError(error, operation) {
+        if (error instanceof BrainyError) {
+            return error;
+        }
+        const message = error.message.toLowerCase();
+        const name = error.name.toLowerCase();
+        // Classify the error based on common patterns
+        if (message.includes('timeout') || name.includes('timeout')) {
+            return BrainyError.timeout(operation || 'unknown', 0, error);
+        }
+        if (message.includes('network') ||
+            message.includes('connection') ||
+            message.includes('econnreset') ||
+            message.includes('enotfound') ||
+            message.includes('etimedout')) {
+            return BrainyError.network(error.message, error);
+        }
+        if (message.includes('nosuchkey') ||
+            message.includes('not found') ||
+            message.includes('does not exist')) {
+            return BrainyError.notFound(operation || 'resource');
+        }
+        // Default to storage error for unclassified errors
+        return BrainyError.storage(error.message, error);
+    }
+}
+//# sourceMappingURL=brainyError.js.map

package/dist/errors/brainyError.js.map

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