mcp-image 0.1.0 → 0.2.0

package/dist/infrastructure/concurrency/concurrencyManager.js

@@ -0,0 +1,345 @@
+"use strict";
+/**
+ * Concurrency Manager - Resource competition and concurrent operation management
+ * Prevents system overload and manages resource allocation across concurrent operations
+ * Provides intelligent queuing and resource contention resolution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConcurrencyManager = exports.ResourceContentionError = void 0;
+const result_1 = require("../../types/result");
+const orchestrationErrorHandler_1 = require("../errorHandling/orchestrationErrorHandler");
+/**
+ * Resource contention error
+ */
+class ResourceContentionError extends Error {
+    constructor(message, metadata = {}) {
+        super(message);
+        this.metadata = metadata;
+        this.name = 'ResourceContentionError';
+    }
+}
+exports.ResourceContentionError = ResourceContentionError;
+/**
+ * Default resource limits
+ */
+const DEFAULT_RESOURCE_LIMITS = {
+    maxMemory: 1024 * 1024 * 1024, // 1GB
+    maxCpu: 80, // 80% CPU usage
+    maxNetworkBandwidth: 100 * 1024 * 1024, // 100MB/s
+    maxConcurrentOperations: 10,
+    maxConcurrentConnections: 50,
+};
+/**
+ * ConcurrencyManager implementation for resource and operation management
+ */
+class ConcurrencyManager {
+    constructor(resourceLimits = DEFAULT_RESOURCE_LIMITS) {
+        this.activeOperations = new Map();
+        this.operationQueue = [];
+        this.nextOperationId = 1;
+        this.resourceLimits = { ...resourceLimits };
+        this.currentUsage = {
+            memory: 0,
+            cpu: 0,
+            networkBandwidth: 0,
+            concurrentOperations: 0,
+            concurrentConnections: 0,
+        };
+    }
+    /**
+     * Manage concurrent operation with resource allocation
+     */
+    async manageConcurrentOperation(operation, resourceRequirements, priority = orchestrationErrorHandler_1.OperationPriority.NORMAL) {
+        // Check resource availability
+        const resourceCheck = await this.checkResourceAvailability(resourceRequirements);
+        if (!resourceCheck.available) {
+            return this.handleResourceContention(operation, priority, resourceRequirements);
+        }
+        // Execute with resource management
+        const operationId = this.generateOperationId();
+        try {
+            this.trackOperation(operationId, resourceRequirements);
+            const result = await operation();
+            return (0, result_1.Ok)(result);
+        }
+        catch (error) {
+            return (0, result_1.Err)(new ResourceContentionError(`Operation failed: ${error}`, {
+                operationId,
+                requirements: resourceRequirements,
+            }));
+        }
+        finally {
+            this.releaseOperation(operationId);
+        }
+    }
+    /**
+     * Check if resources are available for the operation
+     */
+    async checkResourceAvailability(requirements) {
+        const wouldExceedMemory = this.currentUsage.memory + requirements.memory > this.resourceLimits.maxMemory;
+        const wouldExceedCpu = this.currentUsage.cpu + requirements.cpu > this.resourceLimits.maxCpu;
+        const wouldExceedBandwidth = this.currentUsage.networkBandwidth + requirements.networkBandwidth >
+            this.resourceLimits.maxNetworkBandwidth;
+        const wouldExceedOperations = this.currentUsage.concurrentOperations + 1 > this.resourceLimits.maxConcurrentOperations;
+        const wouldExceedConnections = this.currentUsage.concurrentConnections + requirements.concurrentConnections >
+            this.resourceLimits.maxConcurrentConnections;
+        const available = !wouldExceedMemory &&
+            !wouldExceedCpu &&
+            !wouldExceedBandwidth &&
+            !wouldExceedOperations &&
+            !wouldExceedConnections;
+        let reason;
+        if (!available) {
+            const issues = [];
+            if (wouldExceedMemory)
+                issues.push('memory');
+            if (wouldExceedCpu)
+                issues.push('cpu');
+            if (wouldExceedBandwidth)
+                issues.push('bandwidth');
+            if (wouldExceedOperations)
+                issues.push('concurrent operations');
+            if (wouldExceedConnections)
+                issues.push('concurrent connections');
+            reason = `Resource limits exceeded: ${issues.join(', ')}`;
+        }
+        return {
+            available,
+            currentUsage: { ...this.currentUsage },
+            estimatedWaitTime: available ? 0 : this.estimateWaitTime(requirements),
+            reason: reason || 'Unknown reason',
+        };
+    }
+    /**
+     * Handle resource contention with queuing or rejection
+     */
+    async handleResourceContention(operation, priority, requirements) {
+        if (priority === orchestrationErrorHandler_1.OperationPriority.HIGH || priority === orchestrationErrorHandler_1.OperationPriority.CRITICAL) {
+            // Queue high priority operations
+            return this.queueOperation(operation, priority, requirements);
+        }
+        // Reject low priority operations with guidance
+        const estimatedWait = this.estimateWaitTime(requirements);
+        return (0, result_1.Err)(new ResourceContentionError('System busy - try again in a few moments', {
+            estimatedWait,
+            currentLoad: this.calculateCurrentLoad(),
+            suggestion: 'Consider reducing request complexity or trying again later',
+        }));
+    }
+    /**
+     * Queue operation for later execution
+     */
+    async queueOperation(operation, priority, requirements) {
+        const queuedOperation = {
+            id: this.generateOperationId(),
+            operation: operation,
+            priority,
+            requirements,
+            queuedAt: new Date(),
+            estimatedDuration: this.estimateOperationDuration(requirements),
+        };
+        // Insert into queue based on priority
+        this.insertIntoQueue(queuedOperation);
+        // Wait for operation to be processed
+        return new Promise((resolve) => {
+            const checkQueue = async () => {
+                const resourceCheck = await this.checkResourceAvailability(requirements);
+                if (resourceCheck.available && this.operationQueue[0]?.id === queuedOperation.id) {
+                    // Remove from queue and execute
+                    this.operationQueue.shift();
+                    const operationId = queuedOperation.id;
+                    try {
+                        this.trackOperation(operationId, requirements);
+                        const result = await queuedOperation.operation();
+                        resolve((0, result_1.Ok)(result));
+                    }
+                    catch (error) {
+                        resolve((0, result_1.Err)(new ResourceContentionError(`Queued operation failed: ${error}`, {
+                            operationId,
+                            queuedAt: queuedOperation.queuedAt,
+                        })));
+                    }
+                    finally {
+                        this.releaseOperation(operationId);
+                    }
+                }
+                else {
+                    // Check again after a delay
+                    setTimeout(checkQueue, 1000);
+                }
+            };
+            checkQueue();
+        });
+    }
+    /**
+     * Insert operation into priority-based queue
+     */
+    insertIntoQueue(operation) {
+        const priorityOrder = {
+            [orchestrationErrorHandler_1.OperationPriority.CRITICAL]: 0,
+            [orchestrationErrorHandler_1.OperationPriority.HIGH]: 1,
+            [orchestrationErrorHandler_1.OperationPriority.NORMAL]: 2,
+            [orchestrationErrorHandler_1.OperationPriority.LOW]: 3,
+        };
+        const insertIndex = this.operationQueue.findIndex((queued) => priorityOrder[queued.priority] > priorityOrder[operation.priority]);
+        if (insertIndex === -1) {
+            this.operationQueue.push(operation);
+        }
+        else {
+            this.operationQueue.splice(insertIndex, 0, operation);
+        }
+    }
+    /**
+     * Track active operation and update resource usage
+     */
+    trackOperation(operationId, requirements) {
+        const tracking = {
+            id: operationId,
+            startTime: new Date(),
+            requirements,
+            estimatedEndTime: new Date(Date.now() + this.estimateOperationDuration(requirements)),
+            actualUsage: {},
+        };
+        this.activeOperations.set(operationId, tracking);
+        // Update current usage
+        this.currentUsage.memory += requirements.memory;
+        this.currentUsage.cpu += requirements.cpu;
+        this.currentUsage.networkBandwidth += requirements.networkBandwidth;
+        this.currentUsage.concurrentOperations += 1;
+        this.currentUsage.concurrentConnections += requirements.concurrentConnections;
+    }
+    /**
+     * Release operation and free resources
+     */
+    releaseOperation(operationId) {
+        const tracking = this.activeOperations.get(operationId);
+        if (!tracking)
+            return;
+        // Update current usage
+        this.currentUsage.memory -= tracking.requirements.memory;
+        this.currentUsage.cpu -= tracking.requirements.cpu;
+        this.currentUsage.networkBandwidth -= tracking.requirements.networkBandwidth;
+        this.currentUsage.concurrentOperations -= 1;
+        this.currentUsage.concurrentConnections -= tracking.requirements.concurrentConnections;
+        // Ensure no negative values
+        this.currentUsage.memory = Math.max(0, this.currentUsage.memory);
+        this.currentUsage.cpu = Math.max(0, this.currentUsage.cpu);
+        this.currentUsage.networkBandwidth = Math.max(0, this.currentUsage.networkBandwidth);
+        this.currentUsage.concurrentOperations = Math.max(0, this.currentUsage.concurrentOperations);
+        this.currentUsage.concurrentConnections = Math.max(0, this.currentUsage.concurrentConnections);
+        this.activeOperations.delete(operationId);
+    }
+    /**
+     * Generate unique operation ID
+     */
+    generateOperationId() {
+        return `op-${Date.now()}-${this.nextOperationId++}`;
+    }
+    /**
+     * Estimate wait time for resource availability
+     */
+    estimateWaitTime(requirements) {
+        const activeOps = Array.from(this.activeOperations.values());
+        if (activeOps.length === 0)
+            return 0;
+        // Find the operation that would free enough resources
+        const sortedByEndTime = activeOps.sort((a, b) => a.estimatedEndTime.getTime() - b.estimatedEndTime.getTime());
+        for (const op of sortedByEndTime) {
+            const timeUntilEnd = Math.max(0, op.estimatedEndTime.getTime() - Date.now());
+            // Simulate releasing this operation
+            const projectedUsage = {
+                memory: this.currentUsage.memory - op.requirements.memory,
+                cpu: this.currentUsage.cpu - op.requirements.cpu,
+                networkBandwidth: this.currentUsage.networkBandwidth - op.requirements.networkBandwidth,
+                concurrentOperations: this.currentUsage.concurrentOperations - 1,
+                concurrentConnections: this.currentUsage.concurrentConnections - op.requirements.concurrentConnections,
+            };
+            // Check if resources would be available
+            const wouldHaveResources = projectedUsage.memory + requirements.memory <= this.resourceLimits.maxMemory &&
+                projectedUsage.cpu + requirements.cpu <= this.resourceLimits.maxCpu &&
+                projectedUsage.networkBandwidth + requirements.networkBandwidth <=
+                    this.resourceLimits.maxNetworkBandwidth &&
+                projectedUsage.concurrentOperations + 1 <= this.resourceLimits.maxConcurrentOperations &&
+                projectedUsage.concurrentConnections + requirements.concurrentConnections <=
+                    this.resourceLimits.maxConcurrentConnections;
+            if (wouldHaveResources) {
+                return timeUntilEnd;
+            }
+        }
+        // Fallback: estimate based on average operation duration
+        const avgDuration = this.calculateAverageOperationDuration();
+        return avgDuration * 0.5; // Conservative estimate
+    }
+    /**
+     * Estimate operation duration based on resource requirements
+     */
+    estimateOperationDuration(requirements) {
+        // Base duration on resource complexity
+        const memoryFactor = requirements.memory / (1024 * 1024); // MB
+        const cpuFactor = requirements.cpu;
+        const networkFactor = requirements.networkBandwidth / (1024 * 1024); // MB/s
+        // Estimate based on empirical factors (in milliseconds)
+        const baseDuration = 5000; // 5 seconds base
+        const estimatedDuration = baseDuration + memoryFactor * 100 + cpuFactor * 200 + networkFactor * 50;
+        return Math.max(1000, estimatedDuration); // Minimum 1 second
+    }
+    /**
+     * Calculate average operation duration from active operations
+     */
+    calculateAverageOperationDuration() {
+        const activeOps = Array.from(this.activeOperations.values());
+        if (activeOps.length === 0)
+            return 10000; // Default 10 seconds
+        const totalEstimatedDuration = activeOps.reduce((sum, op) => sum + (op.estimatedEndTime.getTime() - op.startTime.getTime()), 0);
+        return totalEstimatedDuration / activeOps.length;
+    }
+    /**
+     * Calculate current system load percentage
+     */
+    calculateCurrentLoad() {
+        const memoryLoad = (this.currentUsage.memory / this.resourceLimits.maxMemory) * 100;
+        const cpuLoad = (this.currentUsage.cpu / this.resourceLimits.maxCpu) * 100;
+        const networkLoad = (this.currentUsage.networkBandwidth / this.resourceLimits.maxNetworkBandwidth) * 100;
+        const operationLoad = (this.currentUsage.concurrentOperations / this.resourceLimits.maxConcurrentOperations) * 100;
+        const connectionLoad = (this.currentUsage.concurrentConnections / this.resourceLimits.maxConcurrentConnections) * 100;
+        return Math.max(memoryLoad, cpuLoad, networkLoad, operationLoad, connectionLoad);
+    }
+    /**
+     * Get current system status
+     */
+    getSystemStatus() {
+        return {
+            currentUsage: { ...this.currentUsage },
+            resourceLimits: { ...this.resourceLimits },
+            activeOperations: this.activeOperations.size,
+            queuedOperations: this.operationQueue.length,
+            currentLoad: this.calculateCurrentLoad(),
+        };
+    }
+    /**
+     * Force cleanup of stale operations
+     */
+    cleanup() {
+        const now = Date.now();
+        const staleThreshold = 5 * 60 * 1000; // 5 minutes
+        for (const [id, tracking] of this.activeOperations.entries()) {
+            if (now - tracking.startTime.getTime() > staleThreshold) {
+                this.releaseOperation(id);
+            }
+        }
+        // Clean up old queued operations
+        const maxQueueAge = 10 * 60 * 1000; // 10 minutes
+        let i = 0;
+        while (i < this.operationQueue.length) {
+            const queuedOp = this.operationQueue[i];
+            if (queuedOp && now - queuedOp.queuedAt.getTime() > maxQueueAge) {
+                this.operationQueue.splice(i, 1);
+            }
+            else {
+                i++;
+            }
+        }
+    }
+}
+exports.ConcurrencyManager = ConcurrencyManager;
+//# sourceMappingURL=concurrencyManager.js.map

package/dist/infrastructure/concurrency/concurrencyManager.js.map

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

package/dist/infrastructure/config/secureConfigManager.d.ts

@@ -0,0 +1,319 @@
+/**
+ * Secure Configuration Manager - Encrypted configuration with access control and auditing
+ * Provides secure storage, retrieval, and management of configuration data
+ * Addresses CONFIG4, CONFIG5 requirements and supports security framework
+ */
+/**
+ * Secure configuration data structure
+ */
+export interface SecureConfig {
+    config: ConfigData;
+    metadata: ConfigMetadata;
+}
+/**
+ * Configuration data (generic structure)
+ */
+export interface ConfigData {
+    [key: string]: unknown;
+}
+/**
+ * Configuration metadata
+ */
+export interface ConfigMetadata {
+    lastUpdated: number;
+    version: string;
+    checksum: string;
+    encryptedAt?: number;
+    updatedBy?: string;
+}
+/**
+ * Encrypted configuration store
+ */
+export interface EncryptedConfigStore {
+    store(component: string, encryptedData: EncryptedConfigData): Promise<void>;
+    retrieve(component: string): Promise<EncryptedConfigData>;
+    exists(component: string): Promise<boolean>;
+    delete(component: string): Promise<void>;
+    list(): Promise<string[]>;
+    backup(): Promise<ConfigBackup>;
+    restore(backup: ConfigBackup): Promise<void>;
+}
+/**
+ * Encrypted configuration data
+ */
+export interface EncryptedConfigData {
+    encryptedContent: string;
+    encryptionMethod: string;
+    lastUpdated: number;
+    version: string;
+    checksum: string;
+    salt?: string;
+    iv?: string;
+}
+/**
+ * Configuration backup
+ */
+export interface ConfigBackup {
+    backupId: string;
+    timestamp: number;
+    components: Record<string, EncryptedConfigData>;
+    metadata: {
+        totalComponents: number;
+        backupSize: number;
+        checksum: string;
+    };
+}
+/**
+ * Configuration validator
+ */
+export interface ConfigValidator {
+    validate(component: string, config: ConfigData): Promise<ConfigValidationResult>;
+    getSchema(component: string): ConfigSchema | null;
+    registerSchema(component: string, schema: ConfigSchema): void;
+}
+/**
+ * Configuration validation result
+ */
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: ConfigValidationError[];
+    warnings: ConfigValidationWarning[];
+}
+/**
+ * Configuration validation error
+ */
+export interface ConfigValidationError {
+    field: string;
+    message: string;
+    severity: 'error' | 'warning';
+    code: string;
+}
+/**
+ * Configuration validation warning
+ */
+export interface ConfigValidationWarning {
+    field: string;
+    message: string;
+    recommendation: string;
+    code: string;
+}
+/**
+ * Configuration schema definition
+ */
+export interface ConfigSchema {
+    type: 'object';
+    properties: Record<string, ConfigPropertySchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+/**
+ * Configuration property schema
+ */
+export interface ConfigPropertySchema {
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    description?: string;
+    required?: boolean;
+    default?: unknown;
+    enum?: unknown[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    items?: ConfigPropertySchema;
+    properties?: Record<string, ConfigPropertySchema>;
+}
+/**
+ * Configuration audit logger
+ */
+export interface ConfigAuditLogger {
+    logAccess(event: ConfigAccessEvent): Promise<void>;
+    logUpdate(event: ConfigUpdateEvent): Promise<void>;
+    logDeletion(event: ConfigDeletionEvent): Promise<void>;
+    getAuditHistory(component: string, timeRange: TimeRange): Promise<ConfigAuditEvent[]>;
+    searchAuditLogs(criteria: AuditSearchCriteria): Promise<ConfigAuditEvent[]>;
+}
+/**
+ * Configuration access event
+ */
+export interface ConfigAccessEvent {
+    component: string;
+    timestamp: number;
+    accessType: 'read' | 'list' | 'exists';
+    userId?: string;
+    sessionId?: string;
+    ipAddress?: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Configuration update event
+ */
+export interface ConfigUpdateEvent {
+    component: string;
+    timestamp: number;
+    updatedBy: string;
+    backupId: string;
+    changes?: ConfigChange[];
+    success: boolean;
+    error?: string;
+}
+/**
+ * Configuration deletion event
+ */
+export interface ConfigDeletionEvent {
+    component: string;
+    timestamp: number;
+    deletedBy: string;
+    reason: string;
+    backupId: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Generic configuration audit event
+ */
+export interface ConfigAuditEvent {
+    eventId: string;
+    eventType: 'access' | 'update' | 'deletion' | 'backup' | 'restore';
+    component: string;
+    timestamp: number;
+    userId?: string;
+    details: Record<string, unknown>;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Configuration change details
+ */
+export interface ConfigChange {
+    field: string;
+    oldValue: unknown;
+    newValue: unknown;
+    changeType: 'added' | 'modified' | 'removed';
+}
+/**
+ * Time range for queries
+ */
+export interface TimeRange {
+    start: number;
+    end: number;
+}
+/**
+ * Audit search criteria
+ */
+export interface AuditSearchCriteria {
+    component?: string;
+    eventType?: string;
+    userId?: string;
+    timeRange?: TimeRange;
+    success?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Configuration update authorization
+ */
+export interface ConfigUpdateAuthorization {
+    userId: string;
+    permissions: string[];
+    sessionId: string;
+    timestamp: number;
+    reason?: string;
+}
+/**
+ * Authorization validation result
+ */
+export interface AuthorizationResult {
+    authorized: boolean;
+    reason?: string;
+    permissions: string[];
+    restrictions: string[];
+}
+/**
+ * Configuration update result
+ */
+export interface ConfigUpdateResult {
+    success: boolean;
+    backupId?: string;
+    errors?: ConfigValidationError[];
+    warnings?: ConfigValidationWarning[];
+}
+/**
+ * Configuration errors
+ */
+export declare class InvalidConfigurationError extends Error {
+    constructor(errors: ConfigValidationError[]);
+}
+export declare class UnauthorizedConfigUpdateError extends Error {
+    constructor(reason: string);
+}
+export declare class ConfigurationUpdateFailedError extends Error {
+    constructor(message: string);
+}
+/**
+ * Secure Configuration Manager - Main implementation
+ */
+export declare class SecureConfigManager {
+    private encryptedConfig;
+    private configValidators;
+    private configAuditLogger;
+    constructor();
+    /**
+     * Get secure configuration for component
+     */
+    getSecureConfiguration(component: string, userId?: string): Promise<SecureConfig>;
+    /**
+     * Update secure configuration
+     */
+    updateSecureConfiguration(component: string, newConfig: ConfigData, authorization: ConfigUpdateAuthorization): Promise<ConfigUpdateResult>;
+    /**
+     * Decrypt configuration data
+     */
+    private decryptConfiguration;
+    /**
+     * Encrypt configuration data
+     */
+    private encryptConfiguration;
+    /**
+     * Validate configuration
+     */
+    private validateConfiguration;
+    /**
+     * Validate update authorization
+     */
+    private validateUpdateAuthorization;
+    /**
+     * Create configuration backup
+     */
+    private createConfigurationBackup;
+    /**
+     * Restore from backup
+     */
+    private restoreFromBackup;
+    /**
+     * Generate checksum
+     */
+    private generateChecksum;
+    /**
+     * Register configuration schema
+     */
+    registerSchema(component: string, schema: ConfigSchema): void;
+    /**
+     * Get configuration audit history
+     */
+    getAuditHistory(component: string, timeRange: TimeRange): Promise<ConfigAuditEvent[]>;
+    /**
+     * Delete configuration
+     */
+    deleteConfiguration(component: string, authorization: ConfigUpdateAuthorization, reason: string): Promise<void>;
+    /**
+     * List all configuration components
+     */
+    listComponents(): Promise<string[]>;
+    /**
+     * Check if configuration exists
+     */
+    hasConfiguration(component: string): Promise<boolean>;
+}
+//# sourceMappingURL=secureConfigManager.d.ts.map