@cgh567/agent 2.4.3 → 2.4.5

package/daemon/routes/hed.js

@@ -0,0 +1,133 @@
+'use strict';
+
+const { HEDEngine } = require('../lib/hed-engine');
+
+/**
+ * HED API routes — /api/hed/*
+ * Follows the standard Helios router pattern: returns true if handled, false otherwise.
+ * Initialized lazily inside startApi() via createHedRoutes(mgQuery).
+ */
+
+function jsonOk(res, data, status = 200) {
+  res.writeHead(status, {
+    'Content-Type': 'application/json',
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'GET, POST, PATCH, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Accept',
+  });
+  res.end(JSON.stringify(data));
+}
+
+function jsonErr(res, status, message) {
+  res.writeHead(status, {
+    'Content-Type': 'application/json',
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'GET, POST, PATCH, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Accept',
+  });
+  res.end(JSON.stringify({ error: message }));
+}
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    let body = '';
+    req.on('data', chunk => { body += chunk; });
+    req.on('end', () => {
+      try { resolve(body ? JSON.parse(body) : {}); }
+      catch (e) { reject(new Error('Invalid JSON body')); }
+    });
+    req.on('error', reject);
+  });
+}
+
+function createHedRoutes(mgQuery) {
+  const engine = new HEDEngine(mgQuery);
+
+  return async function hedRoute(req, res, ctx, pathname, method) {
+    // Only handle /api/hed paths
+    if (!pathname.startsWith('/api/hed')) return false;
+
+    const mg = ctx?.mgQuery ?? mgQuery;
+    const _engine = ctx?.mgQuery ? new HEDEngine(ctx.mgQuery) : engine;
+
+    try {
+      // POST /api/hed — create a new HED
+      if (method === 'POST' && pathname === '/api/hed') {
+        const body = await readBody(req);
+        const { companyId, title, intent, worldStateSnapshot, operations, goalId } = body;
+        if (!companyId || !title || !operations?.length) {
+          jsonErr(res, 400, 'companyId, title, and operations are required');
+          return true;
+        }
+        const result = await _engine.createHED({ companyId, title, intent, worldStateSnapshot, operations, goalId });
+        jsonOk(res, result, 201);
+        return true;
+      }
+
+      // POST /api/hed/:id/approve — HITL approval
+      const approveMatch = method === 'POST' && pathname.match(/^\/api\/hed\/([^/]+)\/approve$/);
+      if (approveMatch) {
+        const hedId = approveMatch[1];
+        const body = await readBody(req);
+        const { approvedBy } = body;
+        await _engine.approveHED(hedId, approvedBy || 'human');
+        jsonOk(res, { hedId, approved: true });
+        return true;
+      }
+
+      // GET /api/hed/:id/review — aggregated review report
+      const reviewMatch = method === 'GET' && pathname.match(/^\/api\/hed\/([^/]+)\/review$/);
+      if (reviewMatch) {
+        const hedId = reviewMatch[1];
+        const operations = await _engine.getOperations(hedId);
+        const findings = operations.map(op => ({
+          opId: op.id,
+          status: op.status,
+          reviewVerdict: op.reviewVerdict || 'pending'
+        }));
+        const aligned = findings.filter(f => f.reviewVerdict === 'ALIGNED').length;
+        const deviated = findings.filter(f => f.reviewVerdict === 'DEVIATED').length;
+        const failed = findings.filter(f => f.reviewVerdict === 'FAILED').length;
+        jsonOk(res, {
+          hedId,
+          findings,
+          summary: { aligned, deviated, failed, pending: findings.length - aligned - deviated - failed }
+        });
+        return true;
+      }
+
+      // PATCH /api/hed/:hedId/operations/:opId — update operation status
+      const opPatchMatch = method === 'PATCH' && pathname.match(/^\/api\/hed\/([^/]+)\/operations\/([^/]+)$/);
+      if (opPatchMatch) {
+        const opId = opPatchMatch[2];
+        const body = await readBody(req);
+        const { status, summary, sessionKey, verdict } = body;
+        if (status === 'done' || status === 'completed') {
+          await _engine.completeOperation(opId, { summary, sessionKey, verdict });
+        }
+        jsonOk(res, { opId, updated: true });
+        return true;
+      }
+
+      // GET /api/hed/:id — get HED + all operations
+      const hedMatch = method === 'GET' && pathname.match(/^\/api\/hed\/([^/]+)$/);
+      if (hedMatch) {
+        const hedId = hedMatch[1];
+        const hed = await _engine.getHED(hedId);
+        if (!hed) { jsonErr(res, 404, 'HED not found'); return true; }
+        const operations = await _engine.getOperations(hedId);
+        jsonOk(res, { ...hed, operations });
+        return true;
+      }
+
+    } catch (err) {
+      console.error('[hed-routes] error:', err.message);
+      jsonErr(res, 500, err.message);
+      return true;
+    }
+
+    return false;
+  };
+}
+
+module.exports = { createHedRoutes };