claudehq 1.0.2 → 1.0.5

package/lib/routes/orchestration.js

@@ -0,0 +1,417 @@
+/**
+ * Orchestration API Routes - HTTP route handlers for multi-agent orchestration
+ *
+ * Provides REST API endpoints for:
+ * - Orchestration CRUD
+ * - Agent CRUD
+ * - Dependency management
+ * - Templates
+ * - Execution control
+ */
+
+/**
+ * Create orchestration route handlers
+ * @param {Object} deps - Dependencies
+ * @param {Object} deps.orchestrationData - Orchestration data module
+ * @param {Object} deps.orchestrationExecutor - Orchestration executor module
+ * @returns {Object} Route handlers
+ */
+function createOrchestrationRoutes(deps) {
+  const { orchestrationData, orchestrationExecutor } = deps;
+
+  return {
+    // =========================================================================
+    // Orchestration CRUD
+    // =========================================================================
+
+    /**
+     * GET /api/orchestrations - List all orchestrations
+     */
+    handleListOrchestrations(req, res) {
+      const orchestrations = orchestrationData.listOrchestrations();
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ ok: true, orchestrations }));
+    },
+
+    /**
+     * POST /api/orchestrations - Create a new orchestration
+     */
+    handleCreateOrchestration(req, res) {
+      let body = '';
+      req.on('data', chunk => body += chunk);
+      req.on('end', () => {
+        try {
+          const config = JSON.parse(body);
+          const result = orchestrationData.createOrchestration(config);
+
+          if (result.error) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: result.error }));
+          } else {
+            res.writeHead(201, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, orchestration: result.orchestration }));
+          }
+        } catch (e) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: e.message }));
+        }
+      });
+    },
+
+    /**
+     * GET /api/orchestrations/:id - Get orchestration by ID
+     */
+    handleGetOrchestration(req, res, id) {
+      const orchestration = orchestrationData.getOrchestration(id);
+      if (orchestration) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true, orchestration }));
+      } else {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: 'Orchestration not found' }));
+      }
+    },
+
+    /**
+     * PATCH /api/orchestrations/:id - Update orchestration
+     */
+    handleUpdateOrchestration(req, res, id) {
+      let body = '';
+      req.on('data', chunk => body += chunk);
+      req.on('end', () => {
+        try {
+          const updates = JSON.parse(body);
+          const result = orchestrationData.updateOrchestration(id, updates);
+
+          if (result.error) {
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: result.error }));
+          } else {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, orchestration: result.orchestration }));
+          }
+        } catch (e) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: e.message }));
+        }
+      });
+    },
+
+    /**
+     * DELETE /api/orchestrations/:id - Delete orchestration
+     */
+    handleDeleteOrchestration(req, res, id) {
+      const result = orchestrationData.deleteOrchestration(id);
+      if (result.error) {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: result.error }));
+      } else {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true }));
+      }
+    },
+
+    // =========================================================================
+    // Orchestration Execution
+    // =========================================================================
+
+    /**
+     * POST /api/orchestrations/:id/start - Start orchestration
+     */
+    handleStartOrchestration(req, res, id) {
+      orchestrationExecutor.startOrchestration(id).then((result) => {
+        if (result.error) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: result.error }));
+        } else {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: true, ...result }));
+        }
+      }).catch((e) => {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: e.message }));
+      });
+    },
+
+    /**
+     * POST /api/orchestrations/:id/stop - Stop orchestration
+     */
+    handleStopOrchestration(req, res, id) {
+      orchestrationExecutor.stopOrchestration(id).then((result) => {
+        if (result.error) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: result.error }));
+        } else {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: true, ...result }));
+        }
+      }).catch((e) => {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: e.message }));
+      });
+    },
+
+    /**
+     * GET /api/orchestrations/:id/stats - Get orchestration statistics
+     */
+    handleGetStats(req, res, id) {
+      const stats = orchestrationData.getOrchestrationStats(id);
+      if (stats) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true, stats }));
+      } else {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: 'Orchestration not found' }));
+      }
+    },
+
+    // =========================================================================
+    // Agent CRUD
+    // =========================================================================
+
+    /**
+     * POST /api/orchestrations/:id/agents - Add agent
+     */
+    handleAddAgent(req, res, orchestrationId) {
+      let body = '';
+      req.on('data', chunk => body += chunk);
+      req.on('end', () => {
+        try {
+          const agentConfig = JSON.parse(body);
+          const result = orchestrationData.addAgent(orchestrationId, agentConfig);
+
+          if (result.error) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: result.error }));
+          } else {
+            res.writeHead(201, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, agent: result.agent }));
+          }
+        } catch (e) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: e.message }));
+        }
+      });
+    },
+
+    /**
+     * PATCH /api/orchestrations/:id/agents/:agentId - Update agent
+     */
+    handleUpdateAgent(req, res, orchestrationId, agentId) {
+      let body = '';
+      req.on('data', chunk => body += chunk);
+      req.on('end', () => {
+        try {
+          const updates = JSON.parse(body);
+          const result = orchestrationData.updateAgent(orchestrationId, agentId, updates);
+
+          if (result.error) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: result.error }));
+          } else {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, agent: result.agent }));
+          }
+        } catch (e) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: e.message }));
+        }
+      });
+    },
+
+    /**
+     * DELETE /api/orchestrations/:id/agents/:agentId - Remove agent
+     */
+    handleRemoveAgent(req, res, orchestrationId, agentId) {
+      const result = orchestrationData.removeAgent(orchestrationId, agentId);
+      if (result.error) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: result.error }));
+      } else {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true }));
+      }
+    },
+
+    /**
+     * GET /api/orchestrations/:id/agents/:agentId/status - Get agent tmux status
+     */
+    handleGetAgentStatus(req, res, orchestrationId, agentId) {
+      orchestrationExecutor.getAgentTmuxStatus(agentId).then((status) => {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true, ...status }));
+      }).catch((e) => {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: e.message }));
+      });
+    },
+
+    /**
+     * POST /api/orchestrations/:id/agents/:agentId/spawn - Manually spawn agent
+     */
+    handleSpawnAgent(req, res, orchestrationId, agentId) {
+      orchestrationExecutor.spawnAgent(orchestrationId, agentId).then((result) => {
+        if (result.error) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: result.error }));
+        } else {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: true, ...result }));
+        }
+      }).catch((e) => {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: e.message }));
+      });
+    },
+
+    /**
+     * POST /api/orchestrations/:id/agents/:agentId/kill - Kill agent
+     */
+    handleKillAgent(req, res, orchestrationId, agentId) {
+      orchestrationExecutor.killAgent(orchestrationId, agentId).then((result) => {
+        if (result.error) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: result.error }));
+        } else {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: true }));
+        }
+      }).catch((e) => {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: e.message }));
+      });
+    },
+
+    /**
+     * POST /api/orchestrations/:id/agents/:agentId/prompt - Send prompt to agent
+     */
+    handleSendAgentPrompt(req, res, orchestrationId, agentId) {
+      let body = '';
+      req.on('data', chunk => body += chunk);
+      req.on('end', async () => {
+        try {
+          const { prompt } = JSON.parse(body);
+          if (!prompt) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: 'Prompt is required' }));
+            return;
+          }
+
+          const result = await orchestrationExecutor.sendPromptToAgent(orchestrationId, agentId, prompt);
+          if (result.error) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: result.error }));
+          } else {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true }));
+          }
+        } catch (e) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: e.message }));
+        }
+      });
+    },
+
+    // =========================================================================
+    // Dependencies
+    // =========================================================================
+
+    /**
+     * POST /api/orchestrations/:id/agents/:agentId/dependencies - Add dependency
+     */
+    handleAddDependency(req, res, orchestrationId, agentId) {
+      let body = '';
+      req.on('data', chunk => body += chunk);
+      req.on('end', () => {
+        try {
+          const { dependsOnAgentId } = JSON.parse(body);
+          if (!dependsOnAgentId) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: 'dependsOnAgentId is required' }));
+            return;
+          }
+
+          const result = orchestrationData.addAgentDependency(orchestrationId, agentId, dependsOnAgentId);
+          if (result.error) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: result.error }));
+          } else {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true }));
+          }
+        } catch (e) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: e.message }));
+        }
+      });
+    },
+
+    /**
+     * DELETE /api/orchestrations/:id/agents/:agentId/dependencies/:depId - Remove dependency
+     */
+    handleRemoveDependency(req, res, orchestrationId, agentId, depId) {
+      const result = orchestrationData.removeAgentDependency(orchestrationId, agentId, depId);
+      if (result.error) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: result.error }));
+      } else {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true }));
+      }
+    },
+
+    // =========================================================================
+    // Templates
+    // =========================================================================
+
+    /**
+     * GET /api/orchestration-templates - List templates
+     */
+    handleListTemplates(req, res) {
+      const templates = orchestrationData.getTemplates();
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ ok: true, templates }));
+    },
+
+    /**
+     * GET /api/orchestration-templates/:id - Get template details
+     */
+    handleGetTemplate(req, res, templateId) {
+      const template = orchestrationData.getTemplate(templateId);
+      if (template) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true, template }));
+      } else {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: 'Template not found' }));
+      }
+    },
+
+    /**
+     * POST /api/orchestration-templates/:id - Create from template
+     */
+    handleCreateFromTemplate(req, res, templateId) {
+      let body = '';
+      req.on('data', chunk => body += chunk);
+      req.on('end', () => {
+        try {
+          const options = body ? JSON.parse(body) : {};
+          const result = orchestrationData.createFromTemplate(templateId, options);
+
+          if (result.error) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: result.error }));
+          } else {
+            res.writeHead(201, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, orchestration: result.orchestration }));
+          }
+        } catch (e) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: false, error: e.message }));
+        }
+      });
+    }
+  };
+}
+
+module.exports = { createOrchestrationRoutes };