@melaya/runner 1.1.18 → 1.1.19

package/dist/browserBridge.js

@@ -1356,6 +1356,12 @@ export async function startBrowserBridge(opts) {
             },
         };
     }
+    // Post an (unchanged) heartbeat frame at least this often so the viewer's
+    // frame watchdog never trips on a STATIC page. Without it, a page that is not
+    // animating (the agent is reasoning, or the page is idle) produced ZERO frames
+    // and the client showed "The live view was interrupted" even though capture was
+    // running fine. Must be shorter than the client's interrupt threshold.
+    const FRAME_HEARTBEAT_MS = 2_000;
     // sessionId -> WatchLease
     const watchLeases = new Map();
     function postFrame(lease, jpegB64, tabs) {
@@ -1479,14 +1485,19 @@ export async function startBrowserBridge(opts) {
             }
             const { image_b64: jpegB64 } = await takeScreenshot(targetLease);
             const changed = jpegB64 !== lease.lastJpegB64;
+            const heartbeatDue = Date.now() - lease.lastPostAt >= FRAME_HEARTBEAT_MS;
             if (changed) {
                 lease.lastJpegB64 = jpegB64;
                 postFrame(lease, jpegB64, tabsPayload);
+                lease.lastPostAt = Date.now();
             }
-            else if (tabsPayload !== undefined) {
-                // Tabs changed but frame did not; send frame anyway so the tab update
-                // is not dropped (the frame body carries the tabs field).
+            else if (tabsPayload !== undefined || heartbeatDue) {
+                // Tabs changed but frame did not, OR the page is static and the viewer's
+                // watchdog is about to trip: send the (unchanged) frame anyway so the tab
+                // update is not dropped and the live view never shows "interrupted" while
+                // capture is actually running. This is the static-page heartbeat.
                 postFrame(lease, jpegB64, tabsPayload);
+                lease.lastPostAt = Date.now();
             }
             // Adaptive FPS: 250 ms (4 fps) when changed, 500 ms (2 fps) when
             // the page is static. The cap is 4 fps; do not go lower than 2 fps
@@ -1576,6 +1587,7 @@ export async function startBrowserBridge(opts) {
             timer: null,
             lastJpegB64: "",
             lastTabsJson: "",
+            lastPostAt: 0,
         };
         watchLeases.set(sessionId, lease);
         log(`[watch] frame producer started for session ${sessionId.slice(0, 16)} run=${matchedRunId.slice(0, 10)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melaya/runner",
-  "version": "1.1.18",
+  "version": "1.1.19",
   "description": "Run Melaya AI pipelines locally with your own LM Studio or Ollama models",
   "license": "UNLICENSED",
   "private": false,