zback 1.4.1 → 1.4.2

package/README.md

@@ -82,3 +82,16 @@ The npm package declares its remote administration capabilities as dual-use soft
 ```sh
 npm test
 ```
+
+## Connection health (1.2.6)
+
+Normal WebSocket ping/pong checks update the local health timestamp silently. A
+`Connection restored` message is printed **only after a real WebSocket
+disconnection and a successful new handshake**, never after a routine pong.
+A delayed pong has a 60-second grace period before the client reconnects.
+The private session identifier remains derived from the local agent key and
+does not change on reconnection. If the connection truly closes, the terminal
+now reports the WebSocket close code and available server reason.
+
+Update the backend to 1.2.4 for relaxed server heartbeat handling too. This
+does not change `--timeout 0`, MCP tools, or interactive consent behavior.

package/bin/zback.js

@@ -10,9 +10,9 @@ import { createTerminal, createEventReporter } from '../src/terminal.js';
 import { activeSession, agentKey, consentFile, hasConsent, initStateDir, logFile, readJson, resetKey, sameSession, saveJson, settingsFile, stateFile, alive } from '../src/runtime.js';
 
 const ENTRY = fileURLToPath(import.meta.url);
-const VERSION = '1.2.5';
+const VERSION = '1.2.6';
 const DEFAULT_URL = 'wss://zb.soymaycol.icu/ws';
-const STALE_AFTER_MS = 60000;
+const STALE_AFTER_MS = 120000;
 
 function connectionStatus(state) {
   if (state.status === 'connected' && (!Number.isFinite(Date.parse(state.updated)) || Date.now() - Date.parse(state.updated) > STALE_AFTER_MS)) return 'unresponsive';
@@ -113,8 +113,9 @@ async function worker() {
   const mark = data => {
     const previous = readJson(stateFile);
     if (previous && previous.status !== 'stopped' && previous.pid !== process.pid && alive(previous.pid)) return;
-    saveJson(stateFile, { pid: process.pid, started, version: VERSION, updated: new Date().toISOString(), ...data });
-    if (data.status === 'connected') {
+    const { heartbeat, ...state } = data;
+    saveJson(stateFile, { pid: process.pid, started, version: VERSION, updated: new Date().toISOString(), ...state });
+    if (data.status === 'connected' && !heartbeat) {
       reporter.clearProblem();
       if (!lastId) terminal.connected(data.id, mcpEndpoint(settings.url));
       else terminal.restored();
@@ -242,8 +243,9 @@ async function start(options) {
     let lastId = null;
     const reporter = createEventReporter(terminal);
     const mark = data => {
-      saveJson(stateFile, { pid: process.pid, started, version: VERSION, updated: new Date().toISOString(), ...data });
-      if (data.status === 'connected') {
+      const { heartbeat, ...state } = data;
+      saveJson(stateFile, { pid: process.pid, started, version: VERSION, updated: new Date().toISOString(), ...state });
+      if (data.status === 'connected' && !heartbeat) {
         reporter.clearProblem();
         if (!lastId) terminal.connected(data.id, mcpEndpoint(options.url));
         else terminal.restored();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zback",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Opt-in foreground remote shell administration with a persistent WebSocket agent and private session credential",
   "type": "module",
   "bin": {

package/src/agent.js

@@ -63,7 +63,7 @@ export async function connectAgent(options, onState, token, onEvent = () => {},
     }
   }
   const heartbeatInterval = options.heartbeatIntervalMs ?? 20000;
-  const pongTimeout = options.pongTimeoutMs ?? 12000;
+  const pongTimeout = options.pongTimeoutMs ?? 60000;
   let stopped = false;
   let retries = 0;
   let socket = null;
@@ -136,7 +136,7 @@ export async function connectAgent(options, onState, token, onEvent = () => {},
           const pong = () => {
             clearTimeout(pongTimer);
             pongTimer = null;
-            if (welcomed && !stopped) update('connected', { id: lastId });
+            if (welcomed && !stopped) update('connected', { id: lastId, heartbeat: true });
           };
           const checkConnection = () => {
             if (current.readyState !== WebSocketClient.OPEN || pongTimer || stopped) return;
@@ -193,7 +193,7 @@ export async function connectAgent(options, onState, token, onEvent = () => {},
           const failed = error => disconnected(error?.message || 'WebSocket connection failed');
           const closed = (code, reason) => {
             const detail = reason?.toString();
-            disconnected(welcomed ? 'Connection lost' : `Backend closed the connection (WebSocket ${code}${detail ? `: ${detail}` : ''})`);
+            disconnected(welcomed ? `Connection lost (WebSocket ${code}${detail ? `: ${detail}` : ''})` : `Backend closed the connection (WebSocket ${code}${detail ? `: ${detail}` : ''})`);
           };
           current.on('open', opened);
           current.on('message', received);