@goodandready/dsh-goal 0.1.4 → 0.1.6

package/lib/index.js

@@ -41,7 +41,7 @@ function sessionIdOf(invocationOrReq, fallback = 'default') {
 export const Config = z.object({
   maxIterations: z.number().default(25).description('Safety limit: max autonomous iterations per goal'),
   autoDrive: z.boolean().default(true).description('Automatically continue the loop after each turn'),
-  enableSound: z.boolean().default(true).description('Play a sound when a goal completes'),
+  enableSound: z.boolean().default(true).description('Play synthesized audio chime on goal completion or failure'),
   storagePath: z.string().default('').description('Custom filesystem path for persistent state storage'),
 });
 
@@ -52,6 +52,9 @@ export function apply(ctx, config = {}) {
   const sessionAgents = new Map(); // sessionId -> agent
   let lastActiveAgent = null;
 
+  // SSE clients: sid -> Set of res objects
+  const sseClients = new Map();
+
   let currentSettings = {
     maxIterations: config?.maxIterations ?? 25,
     autoDrive: config?.autoDrive ?? true,
@@ -71,6 +74,30 @@ export function apply(ctx, config = {}) {
     storagePath,
   });
 
+  // Subscribe to engine changes for realtime Server-Sent Events broadcasting
+  engine.subscribe((snapshot, sid) => {
+    const clients = sseClients.get(sid);
+    if (clients && clients.size > 0) {
+      const payload = `data: ${JSON.stringify(snapshot)}\n\n`;
+      for (const clientRes of clients) {
+        try {
+          clientRes.write(payload);
+        } catch (_) {}
+      }
+    }
+    if (sid !== 'default' && sseClients.has('default')) {
+      const defClients = sseClients.get('default');
+      if (defClients && defClients.size > 0) {
+        const payload = `data: ${JSON.stringify(snapshot)}\n\n`;
+        for (const clientRes of defClients) {
+          try {
+            clientRes.write(payload);
+          } catch (_) {}
+        }
+      }
+    }
+  });
+
   // Динамическое внедрение сервиса agents для управления жизненным циклом
   ctx.inject(['agents'], (actx) => {
     agentsService = actx.agents;
@@ -87,6 +114,13 @@ export function apply(ctx, config = {}) {
       }
     } else {
       runningAgents.delete(agent);
+      if (lastActiveAgent === agent && (status === 'stopped' || status === 'completed' || status === 'error')) {
+        lastActiveAgent = null;
+      }
+      const sid = sessionIdOf(agent, null);
+      if (sid && sessionAgents.get(sid) === agent && (status === 'stopped' || status === 'completed' || status === 'error')) {
+        sessionAgents.delete(sid);
+      }
     }
   });
 
@@ -383,10 +417,22 @@ export function apply(ctx, config = {}) {
     });
   });
 
-  // 5. Регистрация HTTP REST API маршрутов
+  // 5. Регистрация HTTP REST API маршрутов и SSE событий
   ctx.effect(() => {
     if (!ctx.webServer?.register) return () => {};
 
+    // Keepalive ping timer for SSE connections (every 20s)
+    const keepaliveTimer = setInterval(() => {
+      for (const clients of sseClients.values()) {
+        for (const res of clients) {
+          try {
+            res.write(': keepalive\n\n');
+          } catch (_) {}
+        }
+      }
+    }, 20000);
+    if (typeof keepaliveTimer.unref === 'function') keepaliveTimer.unref();
+
     const unreg = ctx.webServer.register({
       kind: 'prefix',
       path: '/dsh-goal',
@@ -394,6 +440,34 @@ export function apply(ctx, config = {}) {
         const url = new URL(req.url, `http://${req.headers.host || 'localhost'}`);
         const pathname = url.pathname;
 
+        // GET /dsh-goal/events — Server-Sent Events realtime snapshot stream
+        if (req.method === 'GET' && (pathname === '/dsh-goal/events' || pathname === '/dsh-goal/events/')) {
+          const sid = sessionIdOf(req, 'default');
+          res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            'Connection': 'keep-alive',
+            'X-Accel-Buffering': 'no',
+          });
+
+          if (!sseClients.has(sid)) {
+            sseClients.set(sid, new Set());
+          }
+          sseClients.get(sid).add(res);
+
+          const initialSnap = engine.getSnapshot(sid);
+          res.write(`data: ${JSON.stringify(initialSnap)}\n\n`);
+
+          req.on('close', () => {
+            const set = sseClients.get(sid);
+            if (set) {
+              set.delete(res);
+              if (set.size === 0) sseClients.delete(sid);
+            }
+          });
+          return;
+        }
+
         res.setHeader('Content-Type', 'application/json; charset=utf-8');
 
         // GET /dsh-goal/state
@@ -428,8 +502,23 @@ export function apply(ctx, config = {}) {
           }
 
           let body = '';
-          req.on('data', (chunk) => { body += chunk; });
+          let bodySize = 0;
+          const MAX_PAYLOAD_BYTES = 256 * 1024;
+          let limitExceeded = false;
+
+          req.on('data', (chunk) => {
+            bodySize += chunk.length;
+            if (bodySize > MAX_PAYLOAD_BYTES) {
+              limitExceeded = true;
+              req.pause();
+              res.statusCode = 413;
+              return res.end(JSON.stringify({ error: 'Payload too large: max 256 KB allowed' }));
+            }
+            body += chunk;
+          });
+
           req.on('end', () => {
+            if (limitExceeded) return;
             try {
               const data = JSON.parse(body || '{}');
               const sid = data.sessionId || sessionIdOf(req, 'default');
@@ -461,6 +550,10 @@ export function apply(ctx, config = {}) {
                   sessionAgents.delete(sid);
                   break;
                 case 'update_milestone':
+                  if (!milestoneId || !status) {
+                    res.statusCode = 400;
+                    return res.end(JSON.stringify({ error: 'milestoneId and status are required' }));
+                  }
                   engine.updateMilestone(milestoneId, status, notes, sid);
                   result = engine.getSnapshot(sid);
                   break;
@@ -485,9 +578,18 @@ export function apply(ctx, config = {}) {
     });
 
     return () => {
+      clearInterval(keepaliveTimer);
       if (typeof unreg === 'function') unreg();
+      for (const clients of sseClients.values()) {
+        for (const res of clients) {
+          try {
+            res.end();
+          } catch (_) {}
+        }
+      }
+      sseClients.clear();
     };
-  }, 'dsh-goal: HTTP WebServer Routes');
+  }, 'dsh-goal: HTTP WebServer Routes & SSE');
 
   // 6. Подписка на события сессии (автономный цикл)
   ctx.effect(() => {
@@ -504,10 +606,18 @@ export function apply(ctx, config = {}) {
           return;
         }
 
+        // Item 3: Smart Progress Guard — detect idle loops without progress
+        const stallCount = engine.incrementStallCount(sid);
+        if (stallCount >= 2) {
+          engine.pause('Агент не продвинулся по плану за последние 2 итерации — требуется внимание оператора', sid);
+          return;
+        }
+
         const canContinue = engine.incrementIteration(sid);
         if (!canContinue) return;
 
-        setTimeout(() => {
+        // Item 2: Low-Latency AutoDrive — setImmediate instead of static setTimeout
+        const triggerNextTurn = () => {
           const currentSnap = engine.getSnapshot(sid);
           if (currentSnap.hasActiveGoal && currentSnap.state === GoalState.RUNNING) {
             const promptMsg = createGoalUserMessage(
@@ -543,7 +653,13 @@ export function apply(ctx, config = {}) {
               }
             }
           }
-        }, 300);
+        };
+
+        if (typeof setImmediate === 'function') {
+          setImmediate(triggerNextTurn);
+        } else {
+          setTimeout(triggerNextTurn, 0);
+        }
       }
     };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-goal",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Goal mode & autonomous execution plugin for DeepSeek Harness with sticky top banner",
   "type": "module",
   "main": "./lib/index.js",