osborn 0.8.8 → 0.8.9

package/dist/index.js

@@ -227,6 +227,47 @@ function startApiServer(workingDir, port) {
             setTimeout(() => process.exit(0), 150);
             return;
         }
+        // GET /events — Server-Sent Events heartbeat for cloud-sandbox keepalive.
+        //
+        // This endpoint is the single thing preventing Sprites' CRIU-based
+        // hibernation from freezing osborn's Node.js event loop and dropping our
+        // LiveKit WebSocket mid-session. Short HTTP pings don't work: Sprites'
+        // warm state serves /health responses from a process snapshot without
+        // actually resuming the event loop, so background timers (including
+        // LiveKit heartbeats) stop firing after a few seconds. That causes the
+        // LiveKit server to drop osborn's participant, delete the room, and
+        // leave any future user joins stuck at "Connecting..." forever.
+        //
+        // An OPEN long-lived TCP connection keeps the sprite in 'running' state.
+        // The frontend opens this endpoint on chat page mount and holds it open
+        // for the entire voice session. While open, osborn's event loop ticks
+        // continuously, LiveKit heartbeats fire, and the room stays alive.
+        //
+        // For local (non-cloud) dev, this endpoint is harmless — it just idles
+        // on a client that may never connect. Zero cost when unused.
+        if (req.method === 'GET' && url.pathname === '/events') {
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive',
+                // Disable proxy buffering (nginx-style) so each ping is flushed
+                // through Sprites' reverse proxy immediately rather than batched.
+                'X-Accel-Buffering': 'no',
+            });
+            res.write(`: sprite-keepalive connected at ${new Date().toISOString()}\n\n`);
+            const heartbeat = setInterval(() => {
+                try {
+                    res.write(`: ping ${Date.now()}\n\n`);
+                }
+                catch { }
+            }, 10_000);
+            req.on('close', () => {
+                clearInterval(heartbeat);
+                console.log('[events] SSE client disconnected');
+            });
+            console.log('[events] SSE client connected');
+            return;
+        }
         res.writeHead(404, { 'Content-Type': 'application/json' });
         res.end(JSON.stringify({ error: 'Not found' }));
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osborn",
-  "version": "0.8.8",
+  "version": "0.8.9",
   "description": "Voice AI coding assistant - local agent that connects to Osborn frontend",
   "type": "module",
   "bin": {