promptspeak-mcp-server 0.1.0

package/dist/http/services/missions.js

@@ -0,0 +1,701 @@
+/**
+ * Mission Service
+ *
+ * Manages mission lifecycle: create, validate, deploy, monitor, complete.
+ * Provides the backend for mission-briefing UI.
+ */
+import { getRuntimeDatabase } from '../database/index.js';
+import { getEventBus } from '../../swarm/registry/event-emitter.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// MISSION SERVICE
+// ═══════════════════════════════════════════════════════════════════════════════
+export class MissionService {
+    static instance = null;
+    constructor() { }
+    /**
+     * Get singleton instance.
+     */
+    static getInstance() {
+        if (!MissionService.instance) {
+            MissionService.instance = new MissionService();
+        }
+        return MissionService.instance;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // CRUD OPERATIONS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Create a new mission.
+     */
+    create(request) {
+        const db = getRuntimeDatabase();
+        const missionId = `mission_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
+        const now = new Date().toISOString();
+        db.prepare(`
+      INSERT INTO missions (
+        mission_id, name, description, mission_type, config,
+        target_criteria, constraints, status, priority,
+        scheduled_start_at, scheduled_end_at, created_by,
+        created_at, updated_at
+      ) VALUES (
+        @missionId, @name, @description, @missionType, @config,
+        @targetCriteria, @constraints, 'draft', @priority,
+        @scheduledStartAt, @scheduledEndAt, @createdBy,
+        @createdAt, @updatedAt
+      )
+    `).run({
+            missionId,
+            name: request.name,
+            description: request.description ?? null,
+            missionType: request.missionType,
+            config: JSON.stringify(request.config ?? {}),
+            targetCriteria: request.targetCriteria ? JSON.stringify(request.targetCriteria) : null,
+            constraints: request.constraints ? JSON.stringify(request.constraints) : null,
+            priority: request.priority ?? 5,
+            scheduledStartAt: request.scheduledStartAt ?? null,
+            scheduledEndAt: request.scheduledEndAt ?? null,
+            createdBy: request.createdBy,
+            createdAt: now,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'created', { actor: request.createdBy });
+        this.emitMissionEvent(missionId, 'created');
+        return this.get(missionId);
+    }
+    /**
+     * Get a mission by ID.
+     */
+    get(missionId) {
+        const db = getRuntimeDatabase();
+        const row = db.prepare('SELECT * FROM missions WHERE mission_id = ?').get(missionId);
+        return row ? this.rowToRecord(row) : null;
+    }
+    /**
+     * List missions with optional filters.
+     */
+    list(options = {}) {
+        const db = getRuntimeDatabase();
+        let query = 'SELECT * FROM missions WHERE 1=1';
+        const params = {};
+        if (options.status) {
+            const statuses = Array.isArray(options.status) ? options.status : [options.status];
+            const placeholders = statuses.map((_, i) => `@status${i}`).join(', ');
+            query += ` AND status IN (${placeholders})`;
+            statuses.forEach((s, i) => {
+                params[`status${i}`] = s;
+            });
+        }
+        if (options.missionType) {
+            query += ' AND mission_type = @missionType';
+            params.missionType = options.missionType;
+        }
+        if (options.createdBy) {
+            query += ' AND created_by = @createdBy';
+            params.createdBy = options.createdBy;
+        }
+        query += ' ORDER BY priority DESC, created_at DESC';
+        if (options.limit) {
+            query += ' LIMIT @limit';
+            params.limit = options.limit;
+        }
+        if (options.offset) {
+            query += ' OFFSET @offset';
+            params.offset = options.offset;
+        }
+        const rows = db.prepare(query).all(params);
+        return rows.map(this.rowToRecord);
+    }
+    /**
+     * Update a mission.
+     */
+    update(missionId, updates) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        const setClauses = [];
+        const params = { missionId };
+        if (updates.name !== undefined) {
+            setClauses.push('name = @name');
+            params.name = updates.name;
+        }
+        if (updates.description !== undefined) {
+            setClauses.push('description = @description');
+            params.description = updates.description;
+        }
+        if (updates.config !== undefined) {
+            setClauses.push('config = @config');
+            params.config = JSON.stringify(updates.config);
+        }
+        if (updates.targetCriteria !== undefined) {
+            setClauses.push('target_criteria = @targetCriteria');
+            params.targetCriteria = JSON.stringify(updates.targetCriteria);
+        }
+        if (updates.constraints !== undefined) {
+            setClauses.push('constraints = @constraints');
+            params.constraints = JSON.stringify(updates.constraints);
+        }
+        if (updates.priority !== undefined) {
+            setClauses.push('priority = @priority');
+            params.priority = updates.priority;
+        }
+        if (updates.progressPercent !== undefined) {
+            setClauses.push('progress_percent = @progressPercent');
+            params.progressPercent = updates.progressPercent;
+        }
+        if (updates.itemsProcessed !== undefined) {
+            setClauses.push('items_processed = @itemsProcessed');
+            params.itemsProcessed = updates.itemsProcessed;
+        }
+        if (updates.errorsCount !== undefined) {
+            setClauses.push('errors_count = @errorsCount');
+            params.errorsCount = updates.errorsCount;
+        }
+        setClauses.push('updated_at = @updatedAt');
+        params.updatedAt = new Date().toISOString();
+        if (setClauses.length === 1)
+            return false; // Only updated_at
+        const result = db.prepare(`
+      UPDATE missions SET ${setClauses.join(', ')} WHERE mission_id = @missionId
+    `).run(params);
+        if (result.changes > 0) {
+            this.recordEvent(missionId, 'updated', { changes: Object.keys(updates) });
+        }
+        return result.changes > 0;
+    }
+    /**
+     * Delete a mission (only if draft or cancelled).
+     */
+    delete(missionId) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        if (!['draft', 'cancelled', 'failed'].includes(mission.status)) {
+            throw new Error(`Cannot delete mission in ${mission.status} status`);
+        }
+        const result = db.prepare('DELETE FROM missions WHERE mission_id = ?').run(missionId);
+        return result.changes > 0;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // LIFECYCLE OPERATIONS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Validate a mission before deployment.
+     */
+    validate(missionId) {
+        const mission = this.get(missionId);
+        if (!mission) {
+            return { valid: false, errors: ['Mission not found'], warnings: [] };
+        }
+        const errors = [];
+        const warnings = [];
+        // Required fields
+        if (!mission.name?.trim()) {
+            errors.push('Mission name is required');
+        }
+        // Config validation
+        if (mission.config.maxAgents && mission.config.maxAgents < 1) {
+            errors.push('maxAgents must be at least 1');
+        }
+        if (mission.config.timeout && mission.config.timeout < 1) {
+            errors.push('timeout must be at least 1 minute');
+        }
+        // Type-specific validation
+        if (mission.missionType === 'data_acquisition') {
+            if (!mission.targetCriteria?.searchTerms?.length) {
+                warnings.push('No search terms defined - mission may have limited scope');
+            }
+        }
+        // Constraints validation
+        if (mission.constraints?.maxBudget && mission.constraints.maxBudget <= 0) {
+            errors.push('maxBudget must be positive');
+        }
+        // Schedule validation
+        if (mission.scheduledStartAt && mission.scheduledEndAt) {
+            if (new Date(mission.scheduledEndAt) <= new Date(mission.scheduledStartAt)) {
+                errors.push('Scheduled end must be after start');
+            }
+        }
+        const valid = errors.length === 0;
+        // Update mission with validation result
+        const db = getRuntimeDatabase();
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = @status,
+          validated_at = @validatedAt,
+          validation_errors = @validationErrors,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            status: valid ? 'validated' : mission.status,
+            validatedAt: valid ? now : null,
+            validationErrors: errors.length > 0 ? JSON.stringify(errors) : null,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, valid ? 'validated' : 'validation_failed', {
+            errors,
+            warnings,
+        });
+        return { valid, errors, warnings };
+    }
+    /**
+     * Deploy a mission to agents.
+     */
+    deploy(missionId, agentIds, approvedBy) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        if (mission.status !== 'validated') {
+            throw new Error(`Cannot deploy mission in ${mission.status} status - must be validated first`);
+        }
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = 'deploying',
+          assigned_agents = @assignedAgents,
+          approved_by = @approvedBy,
+          approved_at = @approvedAt,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            assignedAgents: JSON.stringify(agentIds),
+            approvedBy: approvedBy ?? null,
+            approvedAt: approvedBy ? now : null,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'deployed', {
+            agentIds,
+            approvedBy,
+            previousState: 'validated',
+            newState: 'deploying',
+        });
+        this.emitMissionEvent(missionId, 'deployed');
+        // Transition to active after deployment
+        setTimeout(() => this.transitionToActive(missionId), 1000);
+        return true;
+    }
+    /**
+     * Transition mission to active status.
+     */
+    transitionToActive(missionId) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission || mission.status !== 'deploying')
+            return;
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = 'active',
+          deployed_at = @deployedAt,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            deployedAt: now,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'started', {
+            previousState: 'deploying',
+            newState: 'active',
+        });
+        this.emitMissionEvent(missionId, 'started');
+    }
+    /**
+     * Pause a running mission.
+     */
+    pause(missionId, reason) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        if (mission.status !== 'active') {
+            throw new Error(`Cannot pause mission in ${mission.status} status`);
+        }
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = 'paused',
+          status_message = @reason,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            reason: reason ?? null,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'paused', {
+            reason,
+            previousState: 'active',
+            newState: 'paused',
+        });
+        this.emitMissionEvent(missionId, 'paused');
+        return true;
+    }
+    /**
+     * Resume a paused mission.
+     */
+    resume(missionId) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        if (mission.status !== 'paused') {
+            throw new Error(`Cannot resume mission in ${mission.status} status`);
+        }
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = 'active',
+          status_message = NULL,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'resumed', {
+            previousState: 'paused',
+            newState: 'active',
+        });
+        this.emitMissionEvent(missionId, 'resumed');
+        return true;
+    }
+    /**
+     * Complete a mission.
+     */
+    complete(missionId, summary) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        if (!['active', 'paused'].includes(mission.status)) {
+            throw new Error(`Cannot complete mission in ${mission.status} status`);
+        }
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = 'completed',
+          completed_at = @completedAt,
+          progress_percent = 100,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            completedAt: now,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'completed', {
+            summary,
+            previousState: mission.status,
+            newState: 'completed',
+        });
+        this.emitMissionEvent(missionId, 'completed');
+        return true;
+    }
+    /**
+     * Fail a mission.
+     */
+    fail(missionId, error) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = 'failed',
+          status_message = @error,
+          completed_at = @completedAt,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            error,
+            completedAt: now,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'failed', {
+            error,
+            previousState: mission.status,
+            newState: 'failed',
+        });
+        this.emitMissionEvent(missionId, 'failed');
+        return true;
+    }
+    /**
+     * Cancel a mission.
+     */
+    cancel(missionId, reason) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        if (['completed', 'failed', 'cancelled'].includes(mission.status)) {
+            throw new Error(`Cannot cancel mission in ${mission.status} status`);
+        }
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET status = 'cancelled',
+          status_message = @reason,
+          completed_at = @completedAt,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            reason: reason ?? null,
+            completedAt: now,
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'cancelled', {
+            reason,
+            previousState: mission.status,
+            newState: 'cancelled',
+        });
+        this.emitMissionEvent(missionId, 'cancelled');
+        return true;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // AGENT ASSIGNMENT
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Assign an agent to a mission.
+     */
+    assignAgent(missionId, agentId) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        const agents = new Set(mission.assignedAgents);
+        if (agents.has(agentId))
+            return true; // Already assigned
+        agents.add(agentId);
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET assigned_agents = @assignedAgents,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            assignedAgents: JSON.stringify([...agents]),
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'agent_assigned', { agentId });
+        return true;
+    }
+    /**
+     * Remove an agent from a mission.
+     */
+    removeAgent(missionId, agentId) {
+        const db = getRuntimeDatabase();
+        const mission = this.get(missionId);
+        if (!mission)
+            return false;
+        const agents = new Set(mission.assignedAgents);
+        if (!agents.has(agentId))
+            return true; // Not assigned
+        agents.delete(agentId);
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE missions
+      SET assigned_agents = @assignedAgents,
+          updated_at = @updatedAt
+      WHERE mission_id = @missionId
+    `).run({
+            missionId,
+            assignedAgents: JSON.stringify([...agents]),
+            updatedAt: now,
+        });
+        this.recordEvent(missionId, 'agent_removed', { agentId });
+        return true;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PROGRESS TRACKING
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Update mission progress.
+     */
+    updateProgress(missionId, progress) {
+        const db = getRuntimeDatabase();
+        const now = new Date().toISOString();
+        const setClauses = ['updated_at = @updatedAt'];
+        const params = { missionId, updatedAt: now };
+        if (progress.percent !== undefined) {
+            setClauses.push('progress_percent = @percent');
+            params.percent = Math.max(0, Math.min(100, progress.percent));
+        }
+        if (progress.itemsProcessed !== undefined) {
+            setClauses.push('items_processed = @itemsProcessed');
+            params.itemsProcessed = progress.itemsProcessed;
+        }
+        if (progress.errorsCount !== undefined) {
+            setClauses.push('errors_count = @errorsCount');
+            params.errorsCount = progress.errorsCount;
+        }
+        const result = db.prepare(`
+      UPDATE missions SET ${setClauses.join(', ')} WHERE mission_id = @missionId
+    `).run(params);
+        if (result.changes > 0) {
+            this.recordEvent(missionId, 'progress', progress);
+            this.emitMissionEvent(missionId, 'progress');
+        }
+        return result.changes > 0;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // EVENTS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get events for a mission.
+     */
+    getEvents(missionId, options = {}) {
+        const db = getRuntimeDatabase();
+        let query = 'SELECT * FROM mission_events WHERE mission_id = ? ORDER BY timestamp DESC';
+        const params = [missionId];
+        if (options.limit) {
+            query += ' LIMIT ?';
+            params.push(options.limit);
+        }
+        const rows = db.prepare(query).all(...params);
+        return rows.map(row => ({
+            eventId: row.event_id,
+            missionId: row.mission_id,
+            eventType: row.event_type,
+            agentId: row.agent_id,
+            actor: row.actor,
+            details: row.details ? JSON.parse(row.details) : undefined,
+            previousState: row.previous_state,
+            newState: row.new_state,
+            timestamp: row.timestamp,
+        }));
+    }
+    /**
+     * Record a mission event.
+     */
+    recordEvent(missionId, eventType, details) {
+        const db = getRuntimeDatabase();
+        const eventId = `mevt_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
+        db.prepare(`
+      INSERT INTO mission_events (event_id, mission_id, event_type, actor, details, previous_state, new_state)
+      VALUES (@eventId, @missionId, @eventType, @actor, @details, @previousState, @newState)
+    `).run({
+            eventId,
+            missionId,
+            eventType,
+            actor: details?.actor ?? null,
+            details: details ? JSON.stringify(details) : null,
+            previousState: details?.previousState ?? null,
+            newState: details?.newState ?? null,
+        });
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // STATISTICS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get mission statistics.
+     */
+    getStats() {
+        const db = getRuntimeDatabase();
+        const statusCounts = db.prepare(`
+      SELECT status, COUNT(*) as count FROM missions GROUP BY status
+    `).all();
+        const typeCounts = db.prepare(`
+      SELECT mission_type as type, COUNT(*) as count FROM missions GROUP BY mission_type
+    `).all();
+        const today = new Date();
+        today.setHours(0, 0, 0, 0);
+        const completedToday = db.prepare(`
+      SELECT COUNT(*) as count FROM missions
+      WHERE status = 'completed' AND completed_at >= ?
+    `).get(today.toISOString());
+        const byStatus = {
+            draft: 0, validated: 0, pending_deployment: 0, deploying: 0,
+            active: 0, paused: 0, completed: 0, failed: 0, cancelled: 0,
+        };
+        statusCounts.forEach(row => {
+            byStatus[row.status] = row.count;
+        });
+        const byType = {
+            data_acquisition: 0, monitoring: 0, analysis: 0, reconnaissance: 0, custom: 0,
+        };
+        typeCounts.forEach(row => {
+            byType[row.type] = row.count;
+        });
+        return {
+            total: Object.values(byStatus).reduce((a, b) => a + b, 0),
+            byStatus,
+            byType,
+            activeCount: byStatus.active + byStatus.deploying,
+            completedToday: completedToday.count,
+        };
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // HELPERS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Convert database row to record.
+     */
+    rowToRecord(row) {
+        return {
+            missionId: row.mission_id,
+            name: row.name,
+            description: row.description,
+            missionType: row.mission_type,
+            config: JSON.parse(row.config),
+            targetCriteria: row.target_criteria ? JSON.parse(row.target_criteria) : undefined,
+            constraints: row.constraints ? JSON.parse(row.constraints) : undefined,
+            status: row.status,
+            statusMessage: row.status_message,
+            assignedAgents: row.assigned_agents ? JSON.parse(row.assigned_agents) : [],
+            deployedAt: row.deployed_at,
+            completedAt: row.completed_at,
+            validatedAt: row.validated_at,
+            validationErrors: row.validation_errors ? JSON.parse(row.validation_errors) : undefined,
+            progressPercent: row.progress_percent,
+            itemsProcessed: row.items_processed,
+            errorsCount: row.errors_count,
+            priority: row.priority,
+            scheduledStartAt: row.scheduled_start_at,
+            scheduledEndAt: row.scheduled_end_at,
+            createdBy: row.created_by,
+            approvedBy: row.approved_by,
+            approvedAt: row.approved_at,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * Emit mission event to WebSocket clients.
+     */
+    emitMissionEvent(missionId, eventType) {
+        try {
+            const eventBus = getEventBus();
+            const mission = this.get(missionId);
+            eventBus.emit('mission_event', {
+                type: 'mission_update',
+                missionId,
+                eventType,
+                mission,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch {
+            // Event bus may not be initialized
+        }
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// CONVENIENCE EXPORTS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Get the service singleton.
+ */
+export function getMissionService() {
+    return MissionService.getInstance();
+}
+//# sourceMappingURL=missions.js.map