sliccy 6.247.10 → 6.247.12

package/dist/node-server/_shared/backoff.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Capped exponential backoff, in one place.
+ *
+ * The delay formula `Math.min(baseMs * 2 ** attempt, capMs)` was hand-rolled
+ * nine-plus times across the three floats and webapp internals (CDP reconnect,
+ * kernel realm HTTP retry, scoop turn-runner, jshd supervisor, follower model
+ * surface, extension side panel, electron/lick reconnect). The copies drifted
+ * on base, cap, jitter, and the attempt-exponent clamp — and the storm-hardening
+ * (jitter + exponent clamp) added for the CDP reconnect never reached the rest.
+ *
+ * `nextBackoffDelayMs` is the single definition. `nextCdpReconnectDelayMs`
+ * (jitter + exponent clamp + injectable `random` for tests) was the most
+ * complete copy and is the template; each site now passes its own
+ * `baseMs`/`capMs` instead of re-deriving the formula.
+ */
+export interface BackoffOptions {
+    /**
+     * How many failures have already been recorded, `0` = the gap after the
+     * first failure. Clamped to `>= 0`; fractional values are used as-is.
+     */
+    attempt: number;
+    /** Delay for `attempt === 0`, before any doubling. */
+    baseMs: number;
+    /**
+     * Upper bound on the returned delay (jitter included). Omit for an uncapped
+     * `baseMs * 2 ** attempt` — matches the sites that never clamped.
+     */
+    capMs?: number;
+    /**
+     * Fraction of the exponential delay added as random jitter, in `[0, 1]`.
+     * Default `0` (no jitter). The jittered delay still respects `capMs`.
+     */
+    jitter?: number;
+    /**
+     * Clamp the exponent so `2 ** shift` cannot overflow after a long failure
+     * streak. Omit to leave the exponent unbounded (uncapped callers rely on
+     * `capMs` or a bounded `attempt` instead).
+     */
+    maxShift?: number;
+    /** Returns a value in `[0, 1)`; injectable so tests can pin the jitter. */
+    random?: () => number;
+}
+/**
+ * Delay before the next retry. With no `capMs`/`maxShift`/`jitter` this is
+ * exactly `baseMs * 2 ** attempt`; adding them layers on the storm-hardening.
+ */
+export declare function nextBackoffDelayMs({ attempt, baseMs, capMs, jitter, maxShift, random, }: BackoffOptions): number;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/node-server/_shared/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,MAAM,EACN,KAAK,EACL,MAAU,EACV,QAAQ,EACR,MAAoB,GACrB,EAAE,cAAc,GAAG,MAAM,CAQzB"}

package/dist/node-server/_shared/backoff.js

@@ -0,0 +1,31 @@
+/**
+ * Capped exponential backoff, in one place.
+ *
+ * The delay formula `Math.min(baseMs * 2 ** attempt, capMs)` was hand-rolled
+ * nine-plus times across the three floats and webapp internals (CDP reconnect,
+ * kernel realm HTTP retry, scoop turn-runner, jshd supervisor, follower model
+ * surface, extension side panel, electron/lick reconnect). The copies drifted
+ * on base, cap, jitter, and the attempt-exponent clamp — and the storm-hardening
+ * (jitter + exponent clamp) added for the CDP reconnect never reached the rest.
+ *
+ * `nextBackoffDelayMs` is the single definition. `nextCdpReconnectDelayMs`
+ * (jitter + exponent clamp + injectable `random` for tests) was the most
+ * complete copy and is the template; each site now passes its own
+ * `baseMs`/`capMs` instead of re-deriving the formula.
+ */
+/**
+ * Delay before the next retry. With no `capMs`/`maxShift`/`jitter` this is
+ * exactly `baseMs * 2 ** attempt`; adding them layers on the storm-hardening.
+ */
+export function nextBackoffDelayMs({ attempt, baseMs, capMs, jitter = 0, maxShift, random = Math.random, }) {
+    let shift = Math.max(0, attempt);
+    if (maxShift !== undefined)
+        shift = Math.min(shift, maxShift);
+    const exp = baseMs * 2 ** shift;
+    const capped = capMs === undefined ? exp : Math.min(capMs, exp);
+    if (jitter <= 0)
+        return capped;
+    const withJitter = capped + Math.round(capped * jitter * random());
+    return capMs === undefined ? withJitter : Math.min(capMs, withJitter);
+}
+//# sourceMappingURL=backoff.js.map

package/dist/node-server/_shared/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA8BH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,MAAM,EACN,KAAK,EACL,MAAM,GAAG,CAAC,EACV,QAAQ,EACR,MAAM,GAAG,IAAI,CAAC,MAAM,GACL;IACf,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,SAAS;QAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChE,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC/B,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACnE,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACxE,CAAC"}

package/dist/node-server/_shared/index.d.ts

@@ -1,4 +1,5 @@
 export * from './agent-wire-types.js';
+export * from './backoff.js';
 export * from './base64.js';
 export * from './bridge-protocol.js';
 export * from './byte-range.js';

package/dist/node-server/_shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/node-server/_shared/index.js

@@ -1,5 +1,6 @@
 // Re-exports added in Task 1.2 (secret-masking) and Task 1.3 (secrets-pipeline).
 export * from './agent-wire-types.js';
+export * from './backoff.js';
 export * from './base64.js';
 export * from './bridge-protocol.js';
 export * from './byte-range.js';

package/dist/node-server/_shared/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/node-server/electron-tray-follower.js

@@ -10,7 +10,7 @@
 // `slicc-cli`'s Go follower (same signalling + `hello` handshake + data-channel
 // label), reusing the shared wire types.
 import { randomUUID } from 'node:crypto';
-import { isTrayChunkFrame, successorVersionFromLinkHeader, TRAY_MAX_PENDING_REASSEMBLIES, TRAY_SYNC_PROTOCOL_VERSION, } from './_shared/index.js';
+import { isTrayChunkFrame, nextBackoffDelayMs, successorVersionFromLinkHeader, TRAY_MAX_PENDING_REASSEMBLIES, TRAY_SYNC_PROTOCOL_VERSION, } from './_shared/index.js';
 // werift is a pure-TS WebRTC stack (no native build) that interops with the
 // browser leader's RTCPeerConnection.
 import { RTCPeerConnection, } from 'werift';
@@ -280,7 +280,11 @@ export class ElectronTrayFollower {
             this.stop();
             return;
         }
-        const delayMs = Math.min(1000 * 2 ** this.reconnectAttempts, 15000);
+        const delayMs = nextBackoffDelayMs({
+            attempt: this.reconnectAttempts,
+            baseMs: 1000,
+            capMs: 15000,
+        });
         this.reconnectAttempts++;
         this.log(`[electron-follower] tray-control channel lost — reconnecting in ${delayMs}ms ` +
             `(attempt ${this.reconnectAttempts}/${this.maxReconnects})`);