@aexol/spectral 0.9.113 → 0.9.114

package/dist/relay/client.d.ts

@@ -96,6 +96,12 @@ export declare class RelayClient extends EventEmitter {
     private ws;
     private disposed;
     private reconnectAttempt;
+    /** Timestamp of the last `open` event; 0 when socket is closed. */
+    private openedAtMs;
+    /** Consecutive closes where the socket was open < STABLE_OPEN_MS. */
+    private consecutiveRapidCloses;
+    /** Start of the current rapid-close counting window (ms epoch). */
+    private tightLoopWindowStart;
     private reconnectTimer;
     private sendQueue;
     /** Set true when the WS error handler sees an HTTP 401/403 upgrade rejection. */

package/dist/relay/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,SAAS,MAAM,IAAI,CAAC;AAuB3B,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD,2DAA2D;IAC3D,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAE3E,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAgB;IACjC,iFAAiF;IACjF,OAAO,CAAC,UAAU,CAAS;IAE3B,qEAAqE;IACrE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAA+B;gBAExC,IAAI,EAAE,kBAAkB;IAYpC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAMf;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAqBzC;;;OAGG;IACH,OAAO,IAAI,IAAI;IA2Bf,OAAO,CAAC,UAAU;IAsJlB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,YAAY;IAOpB;;;;;OAKG;YACW,WAAW;YA8BX,iBAAiB;CAmDhC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,SAAS,MAAM,IAAI,CAAC;AA4B3B,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD,2DAA2D;IAC3D,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAE3E,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,mEAAmE;IACnE,OAAO,CAAC,UAAU,CAAK;IACvB,qEAAqE;IACrE,OAAO,CAAC,sBAAsB,CAAK;IACnC,mEAAmE;IACnE,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAgB;IACjC,iFAAiF;IACjF,OAAO,CAAC,UAAU,CAAS;IAE3B,qEAAqE;IACrE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAA+B;gBAExC,IAAI,EAAE,kBAAkB;IAYpC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAMf;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAqBzC;;;OAGG;IACH,OAAO,IAAI,IAAI;IA2Bf,OAAO,CAAC,UAAU;IA4LlB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,YAAY;IAOpB;;;;;OAKG;YACW,WAAW;YA8BX,iBAAiB;CAmDhC"}

package/dist/relay/client.js

@@ -49,6 +49,11 @@ const SEND_QUEUE_CAP = 100;
 const RECONNECT_SCHEDULE = [1000, 2000, 5000, 15000, 30000];
 /** ±20% jitter on each scheduled delay. */
 const JITTER_RATIO = 0.2;
+/** Minimum socket open duration to consider the connection stable and reset backoff. */
+const STABLE_OPEN_MS = 5_000;
+/** Max rapid closes within TIGHT_LOOP_WINDOW_MS before giving up. */
+const TIGHT_LOOP_MAX_CLOSES = 5;
+const TIGHT_LOOP_WINDOW_MS = 60_000;
 /**
  * Watchdog interval (ms). Every `WATCHDOG_INTERVAL_MS` we check whether
  * the socket has been silent longer than `WATCHDOG_SILENCE_MS`.
@@ -73,6 +78,12 @@ export class RelayClient extends EventEmitter {
     ws = null;
     disposed = false;
     reconnectAttempt = 0;
+    /** Timestamp of the last `open` event; 0 when socket is closed. */
+    openedAtMs = 0;
+    /** Consecutive closes where the socket was open < STABLE_OPEN_MS. */
+    consecutiveRapidCloses = 0;
+    /** Start of the current rapid-close counting window (ms epoch). */
+    tightLoopWindowStart = 0;
     reconnectTimer = null;
     sendQueue = [];
     /** Set true when the WS error handler sees an HTTP 401/403 upgrade rejection. */
@@ -173,7 +184,7 @@ export class RelayClient extends EventEmitter {
         this.startWatchdog();
         ws.on("open", () => {
             this.lastActivityMs = Date.now();
-            this.reconnectAttempt = 0;
+            this.openedAtMs = Date.now();
             // Flush any queued frames.
             const queued = this.sendQueue;
             this.sendQueue = [];
@@ -237,6 +248,38 @@ export class RelayClient extends EventEmitter {
         ws.on("close", (code, reason) => {
             this.ws = null;
             this.stopWatchdog();
+            // Stable-open gate: only reset backoff if the socket was open long
+            // enough to be considered healthy. A connect→immediate-die loop (1006,
+            // proxy kill, duplicate instance) must escalate through the full
+            // schedule instead of pinning at RECONNECT_SCHEDULE[0] = 1s forever.
+            const openDuration = this.openedAtMs > 0 ? Date.now() - this.openedAtMs : 0;
+            this.openedAtMs = 0;
+            if (openDuration >= STABLE_OPEN_MS) {
+                this.reconnectAttempt = 0;
+                this.consecutiveRapidCloses = 0;
+            }
+            else {
+                // Tight-loop detection: if the socket dies repeatedly right after
+                // open, bail out with an actionable message instead of reconnecting
+                // forever.
+                const now = Date.now();
+                if (now - this.tightLoopWindowStart > TIGHT_LOOP_WINDOW_MS) {
+                    this.tightLoopWindowStart = now;
+                    this.consecutiveRapidCloses = 1;
+                }
+                else {
+                    this.consecutiveRapidCloses++;
+                }
+                if (this.consecutiveRapidCloses >= TIGHT_LOOP_MAX_CLOSES) {
+                    this.logger.error("\n✗ Relay connection dropped repeatedly right after opening.");
+                    this.logger.error("  This usually means another `spectral serve` process is running for the same machine,");
+                    this.logger.error("  or a reverse proxy / firewall is closing the WebSocket immediately.");
+                    this.logger.error('  Check: `ps aux | grep "spectral serve"` and your proxy WS timeout settings.\n');
+                    this.dispose();
+                    this.exit(1);
+                    return;
+                }
+            }
             const reasonStr = reason?.toString() ?? "";
             this.emit("close", { code, reason: reasonStr });
             if (this.disposed)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.113",
+  "version": "0.9.114",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,