@fleettools/server 0.1.0

package/dist/server/api/src/coordination/agent-spawner-routes.js

@@ -0,0 +1,321 @@
+/**
+ * Agent Spawner Routes for FleetTools Coordination System
+ *
+ * Provides REST API endpoints for agent lifecycle management
+ */
+import { AgentSpawner, AgentType } from './agent-spawner.js';
+const agentSpawner = new AgentSpawner();
+export function registerAgentSpawnerRoutes(router, headers) {
+    // Spawn a new agent
+    router.post('/api/v1/agents/spawn', async (request) => {
+        try {
+            const body = await request.json();
+            if (!body.type || !Object.values(AgentType).includes(body.type)) {
+                return new Response(JSON.stringify({
+                    error: 'Invalid agent type. Must be one of: ' + Object.values(AgentType).join(', ')
+                }), {
+                    status: 400,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            const agent = await agentSpawner.spawn({
+                type: body.type,
+                task: body.task,
+                metadata: body.metadata,
+                config: body.config
+            });
+            return new Response(JSON.stringify({
+                success: true,
+                data: agent
+            }), {
+                status: 201,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to spawn agent',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Get all agents
+    router.get('/api/v1/agents', async (request) => {
+        try {
+            const agents = agentSpawner.getActiveAgents();
+            return new Response(JSON.stringify({
+                success: true,
+                data: agents,
+                count: agents.length
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to get agents',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Get specific agent details
+    router.get('/api/v1/agents/:id', async (request, params) => {
+        try {
+            const agent = agentSpawner.getAgent(params.id);
+            if (!agent) {
+                return new Response(JSON.stringify({
+                    error: 'Agent not found'
+                }), {
+                    status: 404,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            return new Response(JSON.stringify({
+                success: true,
+                data: agent
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to get agent',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Terminate an agent
+    router.delete('/api/v1/agents/:id', async (request, params) => {
+        try {
+            await agentSpawner.terminate(params.id);
+            return new Response(JSON.stringify({
+                success: true,
+                data: {
+                    agent: {
+                        id: params.id,
+                        status: 'terminated'
+                    }
+                }
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to terminate agent',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Report agent progress
+    router.post('/api/v1/agents/:id/progress', async (request, params) => {
+        try {
+            const body = await request.json();
+            const agent = agentSpawner.getAgent(params.id);
+            if (!agent) {
+                return new Response(JSON.stringify({
+                    error: 'Agent not found'
+                }), {
+                    status: 404,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            // Update agent metadata with progress information
+            agent.metadata = {
+                ...agent.metadata,
+                progress: body.progress,
+                progressUpdated: new Date().toISOString()
+            };
+            agent.updatedAt = new Date().toISOString();
+            return new Response(JSON.stringify({
+                success: true,
+                data: {
+                    agent: {
+                        id: params.id,
+                        status: 'terminated'
+                    }
+                }
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to update progress',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Agent heartbeat
+    router.post('/api/v1/agents/:id/heartbeat', async (request, params) => {
+        try {
+            await agentSpawner.updateHeartbeat(params.id);
+            return new Response(JSON.stringify({
+                success: true,
+                data: {
+                    agent: {
+                        id: params.id,
+                        status: 'terminated'
+                    }
+                }
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to process heartbeat',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Get agent health
+    router.get('/api/v1/agents/:id/health', async (request, params) => {
+        try {
+            const health = await agentSpawner.getAgentHealth(params.id);
+            return new Response(JSON.stringify({
+                success: true,
+                data: health
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to get agent health',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Get system health
+    router.get('/api/v1/agents/system/health', async (request) => {
+        try {
+            const health = await agentSpawner.getSystemHealth();
+            return new Response(JSON.stringify({
+                success: true,
+                data: health
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to get system health',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Get agent resource history
+    router.get('/api/v1/agents/:id/resource-history', async (request, params) => {
+        try {
+            const history = await agentSpawner.getResourceHistory(params.id);
+            return new Response(JSON.stringify({
+                success: true,
+                data: {
+                    history
+                }
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to get resource history',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Get agent resource trends
+    router.get('/api/v1/agents/:id/resource-trends', async (request, params) => {
+        try {
+            const trends = await agentSpawner.getResourceTrends(params.id);
+            return new Response(JSON.stringify({
+                success: true,
+                data: trends
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to get resource trends',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    // Get agent logs
+    router.get('/api/v1/agents/:id/logs', async (request, params) => {
+        try {
+            const url = new URL(request.url);
+            const lines = parseInt(url.searchParams.get('lines') || '50');
+            const eventsOnly = url.searchParams.get('events') === 'true';
+            // Mock logs for now - in real implementation would store logs
+            const logs = [
+                {
+                    timestamp: new Date().toISOString(),
+                    level: 'INFO',
+                    message: 'Agent started successfully',
+                    data: { agentId: params.id }
+                }
+            ].slice(0, lines);
+            return new Response(JSON.stringify({
+                success: true,
+                data: {
+                    logs: eventsOnly ? logs.filter(log => log.level === 'EVENT') : logs
+                }
+            }), {
+                status: 200,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: 'Failed to get logs',
+                message: error.message
+            }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+}
+//# sourceMappingURL=agent-spawner-routes.js.map

package/dist/server/api/src/coordination/agent-spawner-routes.js.map

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

package/dist/server/api/src/coordination/agent-spawner.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Agent Spawner for FleetTools Coordination System
+ *
+ * Manages agent lifecycle: spawning, monitoring, and termination
+ * Integrates with Squawk mailbox system for coordination
+ */
+export declare enum AgentType {
+    FRONTEND = "frontend",
+    BACKEND = "backend",
+    TESTING = "testing",
+    DOCUMENTATION = "documentation",
+    SECURITY = "security",
+    PERFORMANCE = "performance"
+}
+export declare enum AgentStatus {
+    SPAWNING = "spawning",
+    RUNNING = "running",
+    IDLE = "idle",
+    BUSY = "busy",
+    ERROR = "error",
+    TERMINATED = "terminated",
+    FAILED = "failed"
+}
+export interface AgentHandle {
+    id: string;
+    type: AgentType;
+    pid?: number;
+    status: AgentStatus;
+    mailboxId: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata: Record<string, any>;
+}
+export interface AgentSpawnRequest {
+    type: AgentType;
+    task?: string;
+    metadata?: Record<string, any>;
+    config?: AgentConfig;
+}
+export interface AgentConfig {
+    timeout?: number;
+    retries?: number;
+    resources?: {
+        memory?: string;
+        cpu?: string;
+    };
+    environment?: Record<string, string>;
+}
+export interface AgentMonitor {
+    status: AgentStatus;
+    uptime?: number;
+    lastHeartbeat?: string;
+    resourceUsage?: {
+        memory: number;
+        cpu: number;
+    };
+    errors: Array<{
+        timestamp: string;
+        error: string;
+        count: number;
+    }>;
+}
+export declare class AgentSpawner {
+    private agents;
+    private mailboxPath;
+    private heartbeatInterval?;
+    private recoveryInterval?;
+    private readonly heartbeatTimeout;
+    private readonly recoveryEnabled;
+    constructor(mailboxPath?: string);
+    /**
+     * Spawn a new agent with timeout and retry logic
+     */
+    spawn(request: AgentSpawnRequest): Promise<AgentHandle>;
+    /**
+     * Monitor agent status and health with comprehensive checks
+     */
+    monitor(agentId: string): Promise<AgentMonitor>;
+    /**
+     * Terminate an agent
+     */
+    terminate(agentId: string, graceful?: boolean): Promise<void>;
+    /**
+     * Get all active agents
+     */
+    getActiveAgents(): AgentHandle[];
+    /**
+     * Get agents by type
+     */
+    getAgentsByType(type: AgentType): AgentHandle[];
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId: string): AgentHandle | undefined;
+    private createMailbox;
+    private cleanupMailbox;
+    private executeAgentSpawn;
+    private cleanupFailedSpawn;
+    private getLastHeartbeat;
+    private getAgentErrors;
+    private getAgentResourceUsage;
+    private getProcessResourceUsage;
+    private getLinuxProcessUsage;
+    private getMacOSProcessUsage;
+    private getMockResourceUsage;
+    private storeResourceHistory;
+    getResourceHistory(agentId: string): Promise<Array<{
+        timestamp: string;
+        memory: number;
+        cpu: number;
+    }>>;
+    getResourceTrends(agentId: string): Promise<{
+        avgMemory: number;
+        avgCpu: number;
+        peakMemory: number;
+        peakCpu: number;
+    }>;
+    updateHeartbeat(agentId: string): Promise<void>;
+    logError(agentId: string, error: string): Promise<void>;
+    private calculateUptime;
+    private ensureDirectory;
+    private writeFile;
+    private removeDirectory;
+    /**
+     * Start heartbeat monitoring for all agents
+     */
+    private startHeartbeatMonitoring;
+    /**
+     * Start automatic recovery monitoring
+     */
+    private startRecoveryMonitoring;
+    /**
+     * Check heartbeats for all running agents
+     */
+    private checkAgentHeartbeats;
+    /**
+     * Handle missed heartbeat scenarios
+     */
+    private handleMissedHeartbeat;
+    /**
+     * Perform recovery checks and attempts
+     */
+    private performRecoveryChecks;
+    /**
+     * Attempt to recover a failed agent
+     */
+    private attemptAgentRecovery;
+    /**
+     * Send recovery event notifications
+     */
+    private sendRecoveryEvent;
+    /**
+     * Get agent health status with detailed metrics
+     */
+    getAgentHealth(agentId: string): Promise<{
+        status: AgentStatus;
+        isHealthy: boolean;
+        lastHeartbeat?: string;
+        uptime?: number;
+        resourceUsage?: {
+            memory: number;
+            cpu: number;
+        };
+        errors: Array<{
+            timestamp: string;
+            error: string;
+            count: number;
+        }>;
+        recoveryAttempts?: number;
+    }>;
+    /**
+     * Get system-wide agent health summary
+     */
+    getSystemHealth(): Promise<{
+        totalAgents: number;
+        healthyAgents: number;
+        unhealthyAgents: number;
+        recoveringAgents: number;
+        failedAgents: number;
+        overallHealth: 'healthy' | 'degraded' | 'critical';
+    }>;
+    /**
+     * Cleanup method to stop monitoring intervals
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=agent-spawner.d.ts.map

package/dist/server/api/src/coordination/agent-spawner.d.ts.map

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