@pcircle/claude-code-buddy-mcp 2.3.1

package/dist/core/BackgroundExecutor.js

@@ -0,0 +1,492 @@
+import { randomBytes } from 'crypto';
+import { TaskScheduler } from './TaskScheduler.js';
+import { ResultHandler } from './ResultHandler.js';
+import { ExecutionMonitor } from './ExecutionMonitor.js';
+import { logger } from '../utils/logger.js';
+import { AttributionManager } from '../ui/AttributionManager.js';
+import { ValidationError, NotFoundError, StateError } from '../errors/index.js';
+import { looksLikeSensitive, hashValue } from '../telemetry/sanitization.js';
+export class TimeoutError extends Error {
+    constructor(duration) {
+        super(`Task timed out after ${duration}ms. Consider breaking down the task into smaller operations or increasing maxDuration in config.resourceLimits.`);
+        this.name = 'TimeoutError';
+    }
+}
+export class BackgroundExecutor {
+    scheduler;
+    activeWorkers;
+    resourceMonitor;
+    tasks;
+    processingLock = false;
+    cleanupTimers = new Map();
+    cleanupScheduled = new Set();
+    cleanupCancelCounts = new Map();
+    activeTimeouts = new Set();
+    eventBus;
+    attributionManager;
+    resultHandler;
+    executionMonitor;
+    MAX_TASK_HISTORY = 1000;
+    FORCE_CLEANUP_AGE = 3600000;
+    MAX_CLEANUP_CANCELS = 10;
+    constructor(resourceMonitor, eventBus) {
+        this.scheduler = new TaskScheduler(resourceMonitor);
+        this.activeWorkers = new Map();
+        this.resourceMonitor = resourceMonitor;
+        this.tasks = new Map();
+        this.eventBus = eventBus;
+        this.resultHandler = new ResultHandler();
+        this.executionMonitor = new ExecutionMonitor(eventBus);
+        if (this.eventBus) {
+            this.attributionManager = new AttributionManager(this.eventBus);
+        }
+    }
+    async executeTask(task, config) {
+        if (config.resourceLimits?.maxDuration !== undefined) {
+            const duration = config.resourceLimits.maxDuration;
+            const MAX_ALLOWED_DURATION = 3600000;
+            if (typeof duration !== 'number') {
+                throw new ValidationError('maxDuration must be a number', {
+                    provided: duration,
+                    type: typeof duration,
+                });
+            }
+            if (!Number.isFinite(duration)) {
+                throw new ValidationError('maxDuration must be a finite number', {
+                    provided: duration,
+                    isNaN: Number.isNaN(duration),
+                    isFinite: Number.isFinite(duration),
+                    reason: Number.isNaN(duration)
+                        ? 'NaN causes immediate timeout (DoS attack vector)'
+                        : 'Infinity causes task to never timeout (resource leak)',
+                });
+            }
+            if (!Number.isSafeInteger(duration)) {
+                throw new ValidationError('maxDuration must be a safe integer', {
+                    provided: duration,
+                    isSafeInteger: Number.isSafeInteger(duration),
+                    maxSafeInteger: Number.MAX_SAFE_INTEGER,
+                });
+            }
+            if (duration <= 0) {
+                throw new ValidationError('maxDuration must be greater than 0', {
+                    provided: duration,
+                    isNegativeZero: Object.is(duration, -0),
+                });
+            }
+            if (duration > MAX_ALLOWED_DURATION) {
+                throw new ValidationError(`maxDuration cannot exceed ${MAX_ALLOWED_DURATION}ms (1 hour)`, {
+                    provided: duration,
+                    max: MAX_ALLOWED_DURATION,
+                });
+            }
+        }
+        const resourceCheck = this.resourceMonitor.canRunBackgroundTask(config);
+        const canQueue = (resourceCheck.reason?.includes('Max concurrent background agents') &&
+            !resourceCheck.reason?.includes('(0)')) ||
+            (resourceCheck.reason?.includes('requires') &&
+                resourceCheck.reason?.includes('available'));
+        if (!resourceCheck.canExecute && !canQueue) {
+            throw new ValidationError(`Cannot execute background task: ${resourceCheck.reason}. ${resourceCheck.suggestion}`, {
+                reason: resourceCheck.reason,
+                suggestion: resourceCheck.suggestion,
+                resources: resourceCheck.resources,
+                canQueue
+            });
+        }
+        const taskId = `bg-${randomBytes(8).toString('hex')}`;
+        const backgroundTask = {
+            taskId,
+            status: 'queued',
+            task,
+            config,
+            startTime: new Date(),
+            progress: {
+                progress: 0,
+                currentStage: 'queued',
+            },
+        };
+        this.tasks.set(taskId, backgroundTask);
+        this.executionMonitor.registerTask(taskId, backgroundTask);
+        this.scheduler.enqueue(backgroundTask);
+        logger.info(`BackgroundExecutor: Task ${taskId} queued with priority ${config.priority}`);
+        this.processQueue();
+        return taskId;
+    }
+    processQueue() {
+        if (this.processingLock) {
+            return;
+        }
+        this.processingLock = true;
+        try {
+            while (!this.scheduler.isEmpty()) {
+                const backgroundTask = this.scheduler.getNextTask();
+                if (!backgroundTask) {
+                    break;
+                }
+                this.startTaskExecution(backgroundTask).catch((error) => {
+                    logger.error(`[BackgroundExecutor] Task ${backgroundTask.taskId} execution error:`, this.sanitizeErrorForLog(error));
+                });
+            }
+        }
+        catch (error) {
+            logger.error('[BackgroundExecutor] CRITICAL: Exception in processQueue', {
+                message: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+                queueSize: this.scheduler.size(),
+                activeTasks: this.activeWorkers.size,
+            });
+        }
+        finally {
+            this.processingLock = false;
+        }
+    }
+    async startTaskExecution(backgroundTask) {
+        const { taskId, task, config } = backgroundTask;
+        this.resourceMonitor.registerBackgroundTask();
+        backgroundTask.status = 'running';
+        backgroundTask.progress = {
+            progress: 0,
+            currentStage: 'starting',
+        };
+        this.tasks.set(taskId, backgroundTask);
+        logger.info(`BackgroundExecutor: Starting task ${taskId}`);
+        let cancelled = false;
+        const cancel = () => {
+            cancelled = true;
+        };
+        const updateProgress = (progress, stage) => {
+            if (cancelled) {
+                return;
+            }
+            this.executionMonitor.updateProgress(taskId, backgroundTask, progress, stage);
+        };
+        let executePromise = this.executeTaskInternal(task, config, updateProgress, () => cancelled);
+        let timeoutId;
+        let timeoutFired = false;
+        try {
+            if (config.resourceLimits?.maxDuration) {
+                const timeoutPromise = new Promise((_, reject) => {
+                    timeoutId = setTimeout(() => {
+                        timeoutFired = true;
+                        cancel();
+                        reject(new TimeoutError(config.resourceLimits.maxDuration));
+                    }, config.resourceLimits.maxDuration);
+                    this.activeTimeouts.add(timeoutId);
+                });
+                executePromise = Promise.race([executePromise, timeoutPromise]);
+            }
+        }
+        catch (error) {
+            if (timeoutId) {
+                this.clearTaskTimeout(timeoutId);
+            }
+            throw error;
+        }
+        const promise = executePromise;
+        this.activeWorkers.set(taskId, {
+            promise,
+            cancel,
+            updateProgress,
+        });
+        promise
+            .then(result => {
+            if (timeoutId && !timeoutFired) {
+                this.clearTaskTimeout(timeoutId);
+            }
+            if (cancelled) {
+                this.handleTaskCancelled(taskId);
+            }
+            else {
+                this.handleTaskCompleted(taskId, result);
+            }
+        })
+            .catch(error => {
+            if (timeoutId && !timeoutFired) {
+                this.clearTaskTimeout(timeoutId);
+            }
+            if (error instanceof TimeoutError) {
+                this.handleTaskFailed(taskId, error);
+            }
+            else if (cancelled) {
+                this.handleTaskCancelled(taskId);
+            }
+            else {
+                this.handleTaskFailed(taskId, error);
+            }
+        })
+            .finally(() => {
+            this.activeWorkers.delete(taskId);
+            this.resourceMonitor.unregisterBackgroundTask();
+            this.processQueue();
+        });
+    }
+    async executeTaskInternal(task, config, updateProgress, isCancelled) {
+        updateProgress(0.1, 'executing');
+        if (typeof task === 'function') {
+            const result = await task({
+                updateProgress,
+                isCancelled,
+            });
+            return result;
+        }
+        const taskData = task;
+        if (task && typeof taskData.execute === 'function') {
+            const result = await taskData.execute({
+                updateProgress,
+                isCancelled,
+            });
+            return result;
+        }
+        updateProgress(1.0, 'completed');
+        return task;
+    }
+    handleTaskCompleted(taskId, result) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return;
+        }
+        this.resultHandler.handleCompleted(task, result);
+        this.tasks.set(taskId, task);
+        this.scheduleTaskCleanup(taskId);
+    }
+    handleTaskFailed(taskId, error) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return;
+        }
+        this.resultHandler.handleFailed(task, error);
+        this.tasks.set(taskId, task);
+        this.scheduleTaskCleanup(taskId);
+    }
+    handleTaskCancelled(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return;
+        }
+        this.resultHandler.handleCancelled(task);
+        this.tasks.set(taskId, task);
+        this.scheduleTaskCleanup(taskId);
+    }
+    scheduleTaskCleanup(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return;
+        }
+        if (task.endTime && Date.now() - task.endTime.getTime() > this.FORCE_CLEANUP_AGE) {
+            logger.warn(`[BackgroundExecutor] Force cleaning up task ${taskId} - exceeded max age`);
+            this.tasks.delete(taskId);
+            this.cleanupTimers.delete(taskId);
+            this.cleanupScheduled.delete(taskId);
+            this.cleanupCancelCounts.delete(taskId);
+            return;
+        }
+        if (this.tasks.size > this.MAX_TASK_HISTORY) {
+            this.forceCleanupOldestTasks(100);
+        }
+        if (this.cleanupScheduled.has(taskId)) {
+            return;
+        }
+        this.cleanupScheduled.add(taskId);
+        const timerId = setTimeout(() => {
+            setImmediate(() => {
+                if (this.cleanupScheduled.has(taskId)) {
+                    this.tasks.delete(taskId);
+                    this.cleanupTimers.delete(taskId);
+                    this.cleanupScheduled.delete(taskId);
+                    this.cleanupCancelCounts.delete(taskId);
+                }
+            });
+        }, 60000);
+        this.cleanupTimers.set(taskId, timerId);
+    }
+    cancelTaskCleanup(taskId) {
+        const cancelCount = this.cleanupCancelCounts.get(taskId) || 0;
+        if (cancelCount >= this.MAX_CLEANUP_CANCELS) {
+            logger.warn(`[BackgroundExecutor] Task ${taskId} cleanup cancelled ${cancelCount} times - forcing cleanup`);
+            this.tasks.delete(taskId);
+            this.cleanupTimers.delete(taskId);
+            this.cleanupScheduled.delete(taskId);
+            this.cleanupCancelCounts.delete(taskId);
+            return;
+        }
+        const timerId = this.cleanupTimers.get(taskId);
+        if (timerId) {
+            clearTimeout(timerId);
+            this.cleanupTimers.delete(taskId);
+            this.cleanupScheduled.delete(taskId);
+            this.cleanupCancelCounts.set(taskId, cancelCount + 1);
+            logger.info(`BackgroundExecutor: Cancelled cleanup for task ${taskId} (count: ${cancelCount + 1})`);
+        }
+    }
+    clearTaskTimeout(timeoutId) {
+        clearTimeout(timeoutId);
+        this.activeTimeouts.delete(timeoutId);
+    }
+    forceCleanupOldestTasks(count) {
+        const completedTasks = Array.from(this.tasks.entries())
+            .filter(([_, task]) => ['completed', 'failed', 'cancelled'].includes(task.status))
+            .sort((a, b) => {
+            const aTime = a[1].endTime?.getTime() || 0;
+            const bTime = b[1].endTime?.getTime() || 0;
+            return aTime - bTime;
+        })
+            .slice(0, count);
+        for (const [taskId, _] of completedTasks) {
+            this.tasks.delete(taskId);
+            const timerId = this.cleanupTimers.get(taskId);
+            if (timerId) {
+                clearTimeout(timerId);
+                this.cleanupTimers.delete(taskId);
+            }
+            this.cleanupScheduled.delete(taskId);
+            this.cleanupCancelCounts.delete(taskId);
+        }
+        if (completedTasks.length > 0) {
+            logger.warn(`[BackgroundExecutor] Force cleaned ${completedTasks.length} oldest tasks (history limit: ${this.MAX_TASK_HISTORY})`);
+        }
+    }
+    sanitizeErrorForLog(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        let sanitized = message.replace(/[\x00-\x1F\x7F-\x9F]/g, '');
+        const lines = sanitized.split(/\r?\n/);
+        const sanitizedLines = lines.map((line) => {
+            if (looksLikeSensitive(line)) {
+                return `[REDACTED:${hashValue(line)}]`;
+            }
+            const words = line.split(/\s+/);
+            const sanitizedWords = words.map((word) => {
+                if (looksLikeSensitive(word)) {
+                    return `[REDACTED:${hashValue(word)}]`;
+                }
+                return word;
+            });
+            return sanitizedWords.join(' ');
+        });
+        sanitized = sanitizedLines.join('\n');
+        return sanitized.substring(0, 1000);
+    }
+    async getProgress(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new NotFoundError(`Task ${taskId} not found`, 'task', taskId);
+        }
+        return (task.progress || {
+            progress: 0,
+            currentStage: task.status,
+        });
+    }
+    async cancelTask(taskId) {
+        this.cancelTaskCleanup(taskId);
+        if (this.scheduler.removeTask(taskId)) {
+            const task = this.tasks.get(taskId);
+            if (task) {
+                task.status = 'cancelled';
+                task.endTime = new Date();
+                this.tasks.set(taskId, task);
+            }
+            logger.info(`BackgroundExecutor: Cancelled queued task ${taskId}`);
+            return;
+        }
+        const worker = this.activeWorkers.get(taskId);
+        if (worker) {
+            worker.cancel();
+            const task = this.tasks.get(taskId);
+            if (task) {
+                task.status = 'cancelled';
+                task.endTime = new Date();
+                this.tasks.set(taskId, task);
+            }
+            logger.info(`BackgroundExecutor: Cancelling running task ${taskId}`);
+            return;
+        }
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new NotFoundError(`Task ${taskId} not found`, 'task', taskId);
+        }
+        if (task.status === 'completed' || task.status === 'failed' || task.status === 'cancelled') {
+            throw new StateError(`Cannot cancel task ${taskId} - already ${task.status}`, {
+                taskId,
+                currentStatus: task.status,
+                operation: 'cancel',
+                allowedStatuses: ['pending', 'running']
+            });
+        }
+    }
+    getTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (task) {
+            this.cancelTaskCleanup(taskId);
+        }
+        return task;
+    }
+    getAllTasks() {
+        return Array.from(this.tasks.values());
+    }
+    getTasksByStatus(status) {
+        return Array.from(this.tasks.values()).filter(task => task.status === status);
+    }
+    getStats() {
+        const counts = { queued: 0, running: 0, completed: 0, failed: 0, cancelled: 0 };
+        for (const task of this.tasks.values()) {
+            if (task.status in counts) {
+                counts[task.status]++;
+            }
+        }
+        return { ...counts, queueStats: this.scheduler.getStats() };
+    }
+    clearFinishedTasks() {
+        const finishedStatuses = ['completed', 'failed', 'cancelled'];
+        let cleared = 0;
+        for (const [taskId, task] of this.tasks.entries()) {
+            if (finishedStatuses.includes(task.status)) {
+                this.tasks.delete(taskId);
+                cleared++;
+            }
+        }
+        logger.info(`BackgroundExecutor: Cleared ${cleared} finished tasks`);
+        return cleared;
+    }
+    async completeTask(taskId, result) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new NotFoundError(`Task ${taskId} not found`, 'task', taskId);
+        }
+        task.status = 'completed';
+        task.endTime = new Date();
+        task.result = result;
+        task.progress = {
+            progress: 1.0,
+            currentStage: 'completed',
+        };
+        this.tasks.set(taskId, task);
+        logger.info(`BackgroundExecutor: Task ${taskId} manually completed`);
+        if (this.attributionManager) {
+            const timeSaved = this.estimateTimeSaved(task);
+            const taskData = task.task;
+            this.attributionManager.recordSuccess([taskId], taskData.description || 'Background task completed', { timeSaved });
+        }
+    }
+    async failTask(taskId, error) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new NotFoundError(`Task ${taskId} not found`, 'task', taskId);
+        }
+        task.status = 'failed';
+        task.endTime = new Date();
+        task.error = error;
+        this.tasks.set(taskId, task);
+        logger.error(`BackgroundExecutor: Task ${taskId} manually failed:`, error);
+        if (this.attributionManager) {
+            const taskData = task.task;
+            this.attributionManager.recordError([taskId], taskData.description || 'Background task failed', error, false);
+        }
+    }
+    estimateTimeSaved(task) {
+        const duration = task.endTime
+            ? task.endTime.getTime() - task.startTime.getTime()
+            : 0;
+        return Math.floor((duration * 2) / 60000);
+    }
+}
+//# sourceMappingURL=BackgroundExecutor.js.map

package/dist/core/BackgroundExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundExecutor.js","sourceRoot":"","sources":["../../src/core/BackgroundExecutor.ts"],"names":[],"mappings":"AAiEA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAU7E,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,QAAgB;QAC1B,KAAK,CACH,wBAAwB,QAAQ,iHAAiH,CAClJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AA+HD,MAAM,OAAO,kBAAkB;IACrB,SAAS,CAAgB;IACzB,aAAa,CAA4B;IACzC,eAAe,CAAkB;IACjC,KAAK,CAA8B;IAInC,cAAc,GAAY,KAAK,CAAC;IAChC,aAAa,GAAgC,IAAI,GAAG,EAAE,CAAC;IACvD,gBAAgB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAC1C,mBAAmB,GAAwB,IAAI,GAAG,EAAE,CAAC;IACrD,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;IAChD,QAAQ,CAAc;IACtB,kBAAkB,CAAsB;IACxC,aAAa,CAAgB;IAC7B,gBAAgB,CAAmB;IAG1B,gBAAgB,GAAG,IAAI,CAAC;IACxB,iBAAiB,GAAG,OAAO,CAAC;IAC5B,mBAAmB,GAAG,EAAE,CAAC;IAuB1C,YAAY,eAAgC,EAAE,QAAqB;QACjE,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAGvD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAgED,KAAK,CAAC,WAAW,CAAC,IAAa,EAAE,MAAuB;QAEtD,IAAI,MAAM,CAAC,cAAc,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC;YACnD,MAAM,oBAAoB,GAAG,OAAO,CAAC;YAGrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,eAAe,CAAC,8BAA8B,EAAE;oBACxD,QAAQ,EAAE,QAAQ;oBAClB,IAAI,EAAE,OAAO,QAAQ;iBACtB,CAAC,CAAC;YACL,CAAC;YAGD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,eAAe,CAAC,qCAAqC,EAAE;oBAC/D,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;oBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACnC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;wBAC5B,CAAC,CAAC,kDAAkD;wBACpD,CAAC,CAAC,uDAAuD;iBAC5D,CAAC,CAAC;YACL,CAAC;YAGD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,eAAe,CAAC,oCAAoC,EAAE;oBAC9D,QAAQ,EAAE,QAAQ;oBAClB,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;oBAC7C,cAAc,EAAE,MAAM,CAAC,gBAAgB;iBACxC,CAAC,CAAC;YACL,CAAC;YAGD,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,eAAe,CAAC,oCAAoC,EAAE;oBAC9D,QAAQ,EAAE,QAAQ;oBAClB,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;iBACxC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,QAAQ,GAAG,oBAAoB,EAAE,CAAC;gBACpC,MAAM,IAAI,eAAe,CACvB,6BAA6B,oBAAoB,aAAa,EAC9D;oBACE,QAAQ,EAAE,QAAQ;oBAClB,GAAG,EAAE,oBAAoB;iBAC1B,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAGD,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAKxE,MAAM,QAAQ,GACZ,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,kCAAkC,CAAC;YAClE,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC;gBAC1C,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAEhD,IAAI,CAAC,aAAa,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3C,MAAM,IAAI,eAAe,CACvB,mCAAmC,aAAa,CAAC,MAAM,KAAK,aAAa,CAAC,UAAU,EAAE,EACtF;gBACE,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,UAAU,EAAE,aAAa,CAAC,UAAU;gBACpC,SAAS,EAAE,aAAa,CAAC,SAAS;gBAClC,QAAQ;aACT,CACF,CAAC;QACJ,CAAC;QAGD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,cAAc,GAAmB;YACrC,MAAM;YACN,MAAM,EAAE,QAAQ;YAChB,IAAI;YACJ,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE;gBACR,QAAQ,EAAE,CAAC;gBACX,YAAY,EAAE,QAAQ;aACvB;SACF,CAAC;QAGF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAG3D,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEvC,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,yBAAyB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAG1F,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAYO,YAAY;QAElB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAE3B,IAAI,CAAC;YAEH,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;gBAEjC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;gBACpD,IAAI,CAAC,cAAc,EAAE,CAAC;oBAEpB,MAAM;gBACR,CAAC;gBAKD,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACtD,MAAM,CAAC,KAAK,CACV,6BAA6B,cAAc,CAAC,MAAM,mBAAmB,EACrE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAChC,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAGf,MAAM,CAAC,KAAK,CACV,0DAA0D,EAC1D;gBACE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBACvD,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;gBAChC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;aACrC,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IAKO,KAAK,CAAC,kBAAkB,CAAC,cAA8B;QAC7D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;QAGhD,IAAI,CAAC,eAAe,CAAC,sBAAsB,EAAE,CAAC;QAG9C,cAAc,CAAC,MAAM,GAAG,SAAS,CAAC;QAClC,cAAc,CAAC,QAAQ,GAAG;YACxB,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,UAAU;SACzB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAEvC,MAAM,CAAC,IAAI,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;QAG3D,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;QAGF,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAE,KAAc,EAAE,EAAE;YAC1D,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChF,CAAC,CAAC;QAGF,IAAI,cAAc,GAAqB,IAAI,CAAC,mBAAmB,CAC7D,IAAI,EACJ,MAAM,EACN,cAAc,EACd,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QAGF,IAAI,SAAqC,CAAC;QAC1C,IAAI,YAAY,GAAG,KAAK,CAAC;QAEzB,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC;gBACvC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBACtD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC1B,YAAY,GAAG,IAAI,CAAC;wBAEpB,MAAM,EAAE,CAAC;wBAET,MAAM,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,cAAe,CAAC,WAAY,CAAC,CAAC,CAAC;oBAChE,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;oBAGtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;gBAGH,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEf,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC;QAG/B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE;YAC7B,OAAO;YACP,MAAM;YACN,cAAc;SACf,CAAC,CAAC;QAGH,OAAO;aACJ,IAAI,CAAC,MAAM,CAAC,EAAE;YAEb,IAAI,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC/B,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,KAAK,CAAC,EAAE;YAEb,IAAI,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC/B,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAClC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,SAAS,EAAE,CAAC;gBACrB,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YAEZ,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,eAAe,CAAC,wBAAwB,EAAE,CAAC;YAGhD,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACP,CAAC;IAKO,KAAK,CAAC,mBAAmB,CAC/B,IAAa,EACb,MAAuB,EACvB,cAA0D,EAC1D,WAA0B;QAG1B,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAKjC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;gBACxB,cAAc;gBACd,WAAW;aACZ,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAGD,MAAM,QAAQ,GAAG,IAAgB,CAAC;QAClC,IAAI,IAAI,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;gBACpC,cAAc;gBACd,WAAW;aACZ,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAGD,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAQO,mBAAmB,CAAC,MAAc,EAAE,MAAe;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAG7B,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAQO,gBAAgB,CAAC,MAAc,EAAE,KAAY;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAG7B,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAQO,mBAAmB,CAAC,MAAc;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAG7B,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAYO,mBAAmB,CAAC,MAAc;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAGD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACjF,MAAM,CAAC,IAAI,CAAC,+CAA+C,MAAM,qBAAqB,CAAC,CAAC;YACxF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAGD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC5C,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QAGD,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAG9B,YAAY,CAAC,GAAG,EAAE;gBAEhB,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAClC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAWO,iBAAiB,CAAC,MAAc;QAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE9D,IAAI,WAAW,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CACT,6BAA6B,MAAM,sBAAsB,WAAW,0BAA0B,CAC/F,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,kDAAkD,MAAM,YAAY,WAAW,GAAG,CAAC,GAAG,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAQO,gBAAgB,CAAC,SAAyB;QAChD,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAUO,uBAAuB,CAAC,KAAa;QAC3C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;aACpD,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aACjF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,OAAO,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAEnB,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CACT,sCAAsC,cAAc,CAAC,MAAM,iCAAiC,IAAI,CAAC,gBAAgB,GAAG,CACrH,CAAC;QACJ,CAAC;IACH,CAAC;IAoBO,mBAAmB,CAAC,KAAc;QACxC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAGvE,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QAI7D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAExC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,OAAO,aAAa,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;YACzC,CAAC;YAGD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACxC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7B,OAAO,aAAa,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;gBACzC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAGtC,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IA0CD,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,aAAa,CACrB,QAAQ,MAAM,YAAY,EAC1B,MAAM,EACN,MAAM,CACP,CAAC;QACJ,CAAC;QAED,OAAO,CACL,IAAI,CAAC,QAAQ,IAAI;YACf,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,IAAI,CAAC,MAAM;SAC1B,CACF,CAAC;IACJ,CAAC;IA8DD,KAAK,CAAC,UAAU,CAAC,MAAc;QAG7B,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAG/B,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;gBAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAGD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,EAAE,CAAC;YAGhB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;gBAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,+CAA+C,MAAM,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAGD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,aAAa,CACrB,QAAQ,MAAM,YAAY,EAC1B,MAAM,EACN,MAAM,CACP,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3F,MAAM,IAAI,UAAU,CAClB,sBAAsB,MAAM,cAAc,IAAI,CAAC,MAAM,EAAE,EACvD;gBACE,MAAM;gBACN,aAAa,EAAE,IAAI,CAAC,MAAM;gBAC1B,SAAS,EAAE,QAAQ;gBACnB,eAAe,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aACxC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAoCD,OAAO,CAAC,MAAc;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAIpC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IA8BD,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IA0CD,gBAAgB,CAAC,MAAkB;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAChF,CAAC;IA0CD,QAAQ;QAQN,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAEhF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,MAA6B,CAAC,EAAE,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9D,CAAC;IAsCD,kBAAkB;QAChB,MAAM,gBAAgB,GAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC5E,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1B,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,iBAAiB,CAAC,CAAC;QACrE,OAAO,OAAO,CAAC;IACjB,CAAC;IAoCD,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,MAAe;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,aAAa,CACrB,QAAQ,MAAM,YAAY,EAC1B,MAAM,EACN,MAAM,CACP,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG;YACd,QAAQ,EAAE,GAAG;YACb,YAAY,EAAE,WAAW;SAC1B,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE7B,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,qBAAqB,CAAC,CAAC;QAGrE,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAgB,CAAC;YACvC,IAAI,CAAC,kBAAkB,CAAC,aAAa,CACnC,CAAC,MAAM,CAAC,EACR,QAAQ,CAAC,WAAW,IAAI,2BAA2B,EACnD,EAAE,SAAS,EAAE,CACd,CAAC;QACJ,CAAC;IACH,CAAC;IAqCD,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,KAAY;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,aAAa,CACrB,QAAQ,MAAM,YAAY,EAC1B,MAAM,EACN,MAAM,CACP,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE7B,MAAM,CAAC,KAAK,CAAC,4BAA4B,MAAM,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAG3E,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAgB,CAAC;YACvC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CACjC,CAAC,MAAM,CAAC,EACR,QAAQ,CAAC,WAAW,IAAI,wBAAwB,EAChD,KAAK,EACL,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAMO,iBAAiB,CAAC,IAAoB;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO;YAC3B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;YACnD,CAAC,CAAC,CAAC,CAAC;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/core/BackgroundExecutorConstants.d.ts

@@ -0,0 +1,8 @@
+export declare const TASK_CLEANUP: {
+    readonly FINISHED_TASK_CLEANUP_MS: number;
+};
+export declare const PROGRESS_MILESTONES: {
+    readonly EXECUTION_STARTED: 0.1;
+    readonly QUEUED: 0;
+};
+//# sourceMappingURL=BackgroundExecutorConstants.d.ts.map

package/dist/core/BackgroundExecutorConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundExecutorConstants.d.ts","sourceRoot":"","sources":["../../src/core/BackgroundExecutorConstants.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,YAAY;;CAGf,CAAC;AAOX,eAAO,MAAM,mBAAmB;;;CAKtB,CAAC"}

package/dist/core/BackgroundExecutorConstants.js

@@ -0,0 +1,8 @@
+export const TASK_CLEANUP = {
+    FINISHED_TASK_CLEANUP_MS: 5 * 60 * 1000,
+};
+export const PROGRESS_MILESTONES = {
+    EXECUTION_STARTED: 0.1,
+    QUEUED: 0,
+};
+//# sourceMappingURL=BackgroundExecutorConstants.js.map

package/dist/core/BackgroundExecutorConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundExecutorConstants.js","sourceRoot":"","sources":["../../src/core/BackgroundExecutorConstants.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,YAAY,GAAG;IAE1B,wBAAwB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;CAC/B,CAAC;AAOX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAEjC,iBAAiB,EAAE,GAAG;IAEtB,MAAM,EAAE,CAAC;CACD,CAAC"}

package/dist/core/CheckpointDetector.d.ts

@@ -0,0 +1,25 @@
+export type CheckpointCallback = (data: Record<string, unknown>) => Promise<{
+    success: boolean;
+}>;
+export interface CheckpointMetadata {
+    description?: string;
+    priority?: string;
+    category?: string;
+}
+export interface CheckpointTriggerResult {
+    triggered: boolean;
+    checkpointName: string;
+    error?: string;
+    failedCallbacks?: number;
+}
+export declare class CheckpointDetector {
+    private checkpoints;
+    registerCheckpoint(checkpointName: string, callback: CheckpointCallback, metadata?: CheckpointMetadata): boolean;
+    addCallback(checkpointName: string, callback: CheckpointCallback): boolean;
+    isCheckpointRegistered(checkpointName: string): boolean;
+    getRegisteredCheckpoints(): string[];
+    triggerCheckpoint(checkpointName: string, data: Record<string, unknown>): Promise<CheckpointTriggerResult>;
+    unregisterCheckpoint(checkpointName: string): boolean;
+    getCheckpointMetadata(checkpointName: string): CheckpointMetadata | undefined;
+}
+//# sourceMappingURL=CheckpointDetector.d.ts.map

package/dist/core/CheckpointDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckpointDetector.d.ts","sourceRoot":"","sources":["../../src/core/CheckpointDetector.ts"],"names":[],"mappings":"AA4EA,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAiBnC,MAAM,WAAW,kBAAkB;IAEjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiBD,MAAM,WAAW,uBAAuB;IAEtC,SAAS,EAAE,OAAO,CAAC;IAGnB,cAAc,EAAE,MAAM,CAAC;IAGvB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAgBD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAA2C;IAyD9D,kBAAkB,CAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,OAAO;IAgEV,WAAW,CACT,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO;IAqDV,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAuCvD,wBAAwB,IAAI,MAAM,EAAE;IA+E9B,iBAAiB,CACrB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,uBAAuB,CAAC;IAuFnC,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IA2DrD,qBAAqB,CACnB,cAAc,EAAE,MAAM,GACrB,kBAAkB,GAAG,SAAS;CAGlC"}

package/dist/core/CheckpointDetector.js

@@ -0,0 +1,67 @@
+import { NotFoundError } from '../errors/index.js';
+export class CheckpointDetector {
+    checkpoints = new Map();
+    registerCheckpoint(checkpointName, callback, metadata) {
+        if (!checkpointName || !callback) {
+            return false;
+        }
+        this.checkpoints.set(checkpointName, {
+            callbacks: [callback],
+            metadata,
+        });
+        return true;
+    }
+    addCallback(checkpointName, callback) {
+        const entry = this.checkpoints.get(checkpointName);
+        if (!entry) {
+            return false;
+        }
+        entry.callbacks.push(callback);
+        return true;
+    }
+    isCheckpointRegistered(checkpointName) {
+        return this.checkpoints.has(checkpointName);
+    }
+    getRegisteredCheckpoints() {
+        return Array.from(this.checkpoints.keys());
+    }
+    async triggerCheckpoint(checkpointName, data) {
+        if (!this.isCheckpointRegistered(checkpointName)) {
+            throw new NotFoundError(`Checkpoint "${checkpointName}" is not registered`, 'checkpoint', checkpointName);
+        }
+        const entry = this.checkpoints.get(checkpointName);
+        let failedCallbacks = 0;
+        let firstError;
+        for (const callback of entry.callbacks) {
+            try {
+                await callback(data);
+            }
+            catch (error) {
+                failedCallbacks++;
+                if (!firstError) {
+                    firstError =
+                        error instanceof Error ? error.message : 'Unknown error';
+                }
+            }
+        }
+        if (failedCallbacks === entry.callbacks.length) {
+            return {
+                triggered: false,
+                checkpointName,
+                error: firstError,
+            };
+        }
+        return {
+            triggered: true,
+            checkpointName,
+            failedCallbacks: failedCallbacks > 0 ? failedCallbacks : undefined,
+        };
+    }
+    unregisterCheckpoint(checkpointName) {
+        return this.checkpoints.delete(checkpointName);
+    }
+    getCheckpointMetadata(checkpointName) {
+        return this.checkpoints.get(checkpointName)?.metadata;
+    }
+}
+//# sourceMappingURL=CheckpointDetector.js.map

package/dist/core/CheckpointDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckpointDetector.js","sourceRoot":"","sources":["../../src/core/CheckpointDetector.ts"],"names":[],"mappings":"AAwDA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA6FnD,MAAM,OAAO,kBAAkB;IACrB,WAAW,GAAiC,IAAI,GAAG,EAAE,CAAC;IAyD9D,kBAAkB,CAChB,cAAsB,EACtB,QAA4B,EAC5B,QAA6B;QAE7B,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE;YACnC,SAAS,EAAE,CAAC,QAAQ,CAAC;YACrB,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAsDD,WAAW,CACT,cAAsB,EACtB,QAA4B;QAE5B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IA6CD,sBAAsB,CAAC,cAAsB;QAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAqCD,wBAAwB;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IA6ED,KAAK,CAAC,iBAAiB,CACrB,cAAsB,EACtB,IAA6B;QAG7B,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,aAAa,CACrB,eAAe,cAAc,qBAAqB,EAClD,YAAY,EACZ,cAAc,CACf,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAE,CAAC;QACpD,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,UAA8B,CAAC;QAGnC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,eAAe,EAAE,CAAC;gBAClB,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,UAAU;wBACR,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QAGD,IAAI,eAAe,KAAK,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC/C,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,cAAc;gBACd,KAAK,EAAE,UAAU;aAClB,CAAC;QACJ,CAAC;QAGD,OAAO;YACL,SAAS,EAAE,IAAI;YACf,cAAc;YACd,eAAe,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;SACnE,CAAC;IACJ,CAAC;IA6CD,oBAAoB,CAAC,cAAsB;QACzC,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;IAyDD,qBAAqB,CACnB,cAAsB;QAEtB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC;IACxD,CAAC;CACF"}