dartmind 17.0.0

package/dist/jobs/JobManager.js

@@ -0,0 +1,336 @@
+/**
+ * JobManager - Manage background jobs and long-running operations
+ *
+ * Features:
+ * - Background job execution
+ * - Job queuing and prioritization
+ * - Progress tracking
+ * - Job cancellation
+ * - Result handling
+ */
+import { EventEmitter } from 'events';
+import { getAbortManager } from '../infrastructure/AbortManager.js';
+import { secureRandomString } from '../utils/random.js';
+export class JobManager extends EventEmitter {
+    static instance;
+    jobs = new Map();
+    queue = [];
+    runningJobs = new Set();
+    config;
+    constructor(config) {
+        super();
+        this.setMaxListeners(100); // Allow many job event listeners
+        this.config = {
+            maxConcurrentJobs: 3,
+            maxQueueSize: 100,
+            defaultTimeout: 300000, // 5 minutes
+            retryFailedJobs: false,
+            maxRetries: 2,
+            ...config,
+        };
+    }
+    static getInstance(config) {
+        if (!JobManager.instance) {
+            JobManager.instance = new JobManager(config);
+        }
+        return JobManager.instance;
+    }
+    /**
+     * Create and queue a new job
+     */
+    async createJob(name, execute, options = {}) {
+        if (this.queue.length >= this.config.maxQueueSize) {
+            throw new Error(`Job queue is full (max: ${this.config.maxQueueSize})`);
+        }
+        const id = this.generateJobId();
+        const job = {
+            id,
+            name,
+            description: options.description ?? name,
+            status: 'pending',
+            priority: options.priority ?? 'normal',
+            progress: 0,
+            createdAt: Date.now(),
+            metadata: options.metadata,
+            execute,
+        };
+        this.jobs.set(id, job);
+        this.addToQueue(id, job.priority);
+        this.emit('job:created', job);
+        this.processQueue();
+        return job;
+    }
+    /**
+     * Add job to queue based on priority
+     */
+    addToQueue(jobId, priority) {
+        const priorityOrder = {
+            critical: 0,
+            high: 1,
+            normal: 2,
+            low: 3,
+        };
+        const jobPriorityValue = priorityOrder[priority];
+        // Find insertion point
+        let insertIndex = this.queue.length;
+        for (let i = 0; i < this.queue.length; i++) {
+            const existingJob = this.jobs.get(this.queue[i]);
+            if (existingJob && priorityOrder[existingJob.priority] > jobPriorityValue) {
+                insertIndex = i;
+                break;
+            }
+        }
+        this.queue.splice(insertIndex, 0, jobId);
+    }
+    /**
+     * Process the job queue
+     */
+    async processQueue() {
+        while (this.queue.length > 0 &&
+            this.runningJobs.size < this.config.maxConcurrentJobs) {
+            const jobId = this.queue.shift();
+            if (jobId) {
+                this.runJob(jobId);
+            }
+        }
+    }
+    /**
+     * Run a job
+     */
+    async runJob(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job)
+            return;
+        this.runningJobs.add(jobId);
+        job.status = 'running';
+        job.startedAt = Date.now();
+        this.emit('job:started', job);
+        const abortManager = getAbortManager();
+        const operation = abortManager.createOperation(`job-${jobId}`, this.config.defaultTimeout);
+        const signal = operation.controller.signal;
+        try {
+            const onProgress = (progress, message) => {
+                job.progress = Math.min(100, Math.max(0, progress));
+                job.progressMessage = message;
+                this.emit('job:progress', { job, progress, message });
+            };
+            const data = await job.execute(signal, onProgress);
+            job.status = 'completed';
+            job.completedAt = Date.now();
+            job.progress = 100;
+            job.result = {
+                success: true,
+                data,
+                duration: job.completedAt - (job.startedAt ?? job.createdAt),
+            };
+            this.emit('job:completed', job);
+        }
+        catch (error) {
+            job.completedAt = Date.now();
+            if (signal.aborted) {
+                job.status = 'cancelled';
+                job.result = {
+                    success: false,
+                    error: 'Job was cancelled',
+                    duration: job.completedAt - (job.startedAt ?? job.createdAt),
+                };
+                this.emit('job:cancelled', job);
+            }
+            else {
+                job.status = 'failed';
+                job.result = {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    duration: job.completedAt - (job.startedAt ?? job.createdAt),
+                };
+                this.emit('job:failed', job);
+            }
+        }
+        finally {
+            this.runningJobs.delete(jobId);
+            abortManager.abort(`job-${jobId}`);
+            this.processQueue();
+        }
+    }
+    /**
+     * Cancel a job
+     */
+    cancelJob(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job)
+            return false;
+        if (job.status === 'pending') {
+            // Remove from queue
+            const index = this.queue.indexOf(jobId);
+            if (index !== -1) {
+                this.queue.splice(index, 1);
+            }
+            job.status = 'cancelled';
+            job.completedAt = Date.now();
+            this.emit('job:cancelled', job);
+            return true;
+        }
+        if (job.status === 'running') {
+            // Abort the operation
+            const abortManager = getAbortManager();
+            return abortManager.abort(`job-${jobId}`, 'User cancelled');
+        }
+        return false;
+    }
+    /**
+     * Get job by ID
+     */
+    getJob(jobId) {
+        return this.jobs.get(jobId);
+    }
+    /**
+     * Get all jobs
+     */
+    getAllJobs() {
+        return Array.from(this.jobs.values());
+    }
+    /**
+     * Get jobs by status
+     */
+    getJobsByStatus(status) {
+        return this.getAllJobs().filter(job => job.status === status);
+    }
+    /**
+     * Get running jobs
+     */
+    getRunningJobs() {
+        return this.getJobsByStatus('running');
+    }
+    /**
+     * Get pending jobs
+     */
+    getPendingJobs() {
+        return this.getJobsByStatus('pending');
+    }
+    /**
+     * Get completed jobs
+     */
+    getCompletedJobs() {
+        return this.getJobsByStatus('completed');
+    }
+    /**
+     * Get queue length
+     */
+    getQueueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Get running job count
+     */
+    getRunningCount() {
+        return this.runningJobs.size;
+    }
+    /**
+     * Wait for a job to complete
+     */
+    async waitForJob(jobId, timeoutMs) {
+        const job = this.jobs.get(jobId);
+        if (!job) {
+            throw new Error(`Job not found: ${jobId}`);
+        }
+        if (job.status === 'completed' || job.status === 'failed' || job.status === 'cancelled') {
+            return job.result;
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = timeoutMs
+                ? setTimeout(() => {
+                    cleanup();
+                    reject(new Error(`Timeout waiting for job: ${jobId}`));
+                }, timeoutMs)
+                : null;
+            const onComplete = (completedJob) => {
+                if (completedJob.id === jobId) {
+                    cleanup();
+                    resolve(completedJob.result);
+                }
+            };
+            const onFailed = (failedJob) => {
+                if (failedJob.id === jobId) {
+                    cleanup();
+                    resolve(failedJob.result);
+                }
+            };
+            const onCancelled = (cancelledJob) => {
+                if (cancelledJob.id === jobId) {
+                    cleanup();
+                    resolve(cancelledJob.result);
+                }
+            };
+            const cleanup = () => {
+                if (timeout)
+                    clearTimeout(timeout);
+                this.off('job:completed', onComplete);
+                this.off('job:failed', onFailed);
+                this.off('job:cancelled', onCancelled);
+            };
+            this.on('job:completed', onComplete);
+            this.on('job:failed', onFailed);
+            this.on('job:cancelled', onCancelled);
+        });
+    }
+    /**
+     * Clear completed/failed/cancelled jobs
+     */
+    clearFinishedJobs() {
+        let cleared = 0;
+        for (const [id, job] of this.jobs) {
+            if (['completed', 'failed', 'cancelled'].includes(job.status)) {
+                this.jobs.delete(id);
+                cleared++;
+            }
+        }
+        this.emit('jobs:cleared', { count: cleared });
+        return cleared;
+    }
+    /**
+     * Cancel all jobs
+     */
+    cancelAllJobs() {
+        let cancelled = 0;
+        // Cancel pending jobs
+        for (const jobId of this.queue) {
+            if (this.cancelJob(jobId)) {
+                cancelled++;
+            }
+        }
+        // Cancel running jobs
+        for (const jobId of this.runningJobs) {
+            if (this.cancelJob(jobId)) {
+                cancelled++;
+            }
+        }
+        return cancelled;
+    }
+    /**
+     * Get job stats
+     */
+    getStats() {
+        const jobs = this.getAllJobs();
+        return {
+            total: jobs.length,
+            pending: jobs.filter(j => j.status === 'pending').length,
+            running: jobs.filter(j => j.status === 'running').length,
+            completed: jobs.filter(j => j.status === 'completed').length,
+            failed: jobs.filter(j => j.status === 'failed').length,
+            cancelled: jobs.filter(j => j.status === 'cancelled').length,
+            queueLength: this.queue.length,
+        };
+    }
+    /**
+     * Generate unique job ID
+     */
+    generateJobId() {
+        const timestamp = Date.now().toString(36);
+        const random = secureRandomString(6);
+        return `job-${timestamp}-${random}`;
+    }
+}
+// Export singleton getter
+export const getJobManager = JobManager.getInstance;
+export default JobManager;
+//# sourceMappingURL=JobManager.js.map

package/dist/jobs/JobManager.js.map

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

package/dist/jobs/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Jobs Module
+ *
+ * Exports job management components
+ */
+export { JobManager, getJobManager, type Job, type JobStatus, type JobPriority, type JobResult, type JobManagerConfig, } from './JobManager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,aAAa,EACb,KAAK,GAAG,EACR,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/jobs/index.js

@@ -0,0 +1,7 @@
+/**
+ * Jobs Module
+ *
+ * Exports job management components
+ */
+export { JobManager, getJobManager, } from './JobManager.js';
+//# sourceMappingURL=index.js.map

package/dist/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,aAAa,GAMd,MAAM,iBAAiB,CAAC"}

package/dist/mcp/MCPHealthChecker.d.ts

@@ -0,0 +1,122 @@
+/**
+ * FlutterAI V16 - MCPHealthChecker
+ * Issue 16.1: MCP Server Startup Verification
+ *
+ * Verify all MCP servers are healthy before operations:
+ * - Health check with timeout
+ * - Retry logic for transient failures
+ * - Block operations until all healthy
+ *
+ * @module mcp/MCPHealthChecker
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+export interface MCPServerConfig {
+    id: string;
+    name: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    required?: boolean;
+}
+export interface MCPServerHealth {
+    serverId: string;
+    serverName: string;
+    healthy: boolean;
+    responseTimeMs?: number;
+    lastCheck: Date;
+    consecutiveFailures: number;
+    errorMessage?: string;
+}
+export interface MCPHealthStatus {
+    allHealthy: boolean;
+    servers: MCPServerHealth[];
+    unhealthyCount: number;
+    totalServers: number;
+    lastFullCheck: Date;
+}
+export interface MCPHealthCheckerConfig {
+    healthCheckTimeoutMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    checkIntervalMs?: number;
+}
+export declare class MCPHealthChecker extends EventEmitter {
+    private config;
+    private servers;
+    private healthStatus;
+    private checkInterval;
+    private healthCheckFn;
+    constructor(servers?: MCPServerConfig[], config?: MCPHealthCheckerConfig);
+    /**
+     * Set custom health check function
+     */
+    setHealthCheckFn(fn: (server: MCPServerConfig) => Promise<boolean>): void;
+    /**
+     * Check health of all servers
+     */
+    checkAll(): Promise<MCPHealthStatus>;
+    /**
+     * Check health of required servers only
+     */
+    checkRequired(): Promise<MCPHealthStatus>;
+    /**
+     * Check health of a specific server
+     */
+    checkServer(serverId: string): Promise<MCPServerHealth>;
+    /**
+     * Wait until all servers are healthy or timeout
+     */
+    waitForHealthy(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Wait until required servers are healthy or timeout
+     */
+    waitForRequiredHealthy(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Verify startup - throws if required servers not healthy
+     */
+    verifyStartup(): Promise<void>;
+    /**
+     * Start periodic health checks
+     */
+    startPeriodicChecks(): void;
+    /**
+     * Stop periodic health checks
+     */
+    stopPeriodicChecks(): void;
+    /**
+     * Get current health status
+     */
+    getStatus(): MCPHealthStatus;
+    /**
+     * Get list of registered servers
+     */
+    getRegisteredServers(): MCPServerConfig[];
+    /**
+     * Register a new server
+     */
+    registerServer(server: MCPServerConfig): void;
+    /**
+     * Unregister a server
+     */
+    unregisterServer(serverId: string): void;
+    /**
+     * Get health summary
+     */
+    getHealth(): {
+        healthy: boolean;
+        message: string;
+    };
+    private performHealthCheck;
+    private delay;
+}
+/**
+ * Create an MCPHealthChecker with default settings
+ */
+export declare function createMCPHealthChecker(servers?: MCPServerConfig[], config?: MCPHealthCheckerConfig): MCPHealthChecker;
+/**
+ * Create an MCPHealthChecker for FlutterAI default servers
+ */
+export declare function createFlutterAIMCPHealthChecker(config?: MCPHealthCheckerConfig): MCPHealthChecker;
+export default MCPHealthChecker;
+//# sourceMappingURL=MCPHealthChecker.d.ts.map

package/dist/mcp/MCPHealthChecker.d.ts.map

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