@serfab/cadre-core 0.6.0 → 0.8.1

package/dist/diagnostics/webrtc-turn-tracker.js

@@ -0,0 +1,196 @@
+/**
+ * webrtc-turn-tracker.ts — observe whether ICE selected a TURN relay candidate
+ * for each WebRTC session, so a TURN-relayed `/webrtc` connection can be
+ * reclassified `relayed`/`webrtc-turn` instead of silently counted `direct`.
+ *
+ * `@libp2p/webrtc` keeps the underlying `RTCPeerConnection` private and never
+ * surfaces it on the libp2p `Connection`, so the multiaddr classifier
+ * (`connection-path.ts`) cannot see the ICE candidate types. This tracker hooks
+ * `globalThis.RTCPeerConnection` at install time: every connection that reaches
+ * `connectionState === 'connected'` is inspected via `getStats()`, and the
+ * relay/not-relay verdict for the selected candidate pair is pushed onto a FIFO
+ * queue. {@link CadreNode} drains that queue on each `connection:open` to tag the
+ * matching peer (see {@link consume}).
+ *
+ * The correlation between a queued settlement and a `connection:open` is
+ * timing-based and best-effort — it degrades gracefully (unknown → treated as not
+ * relayed, a safe default that never produces a false `relayed`). It is inert on
+ * Node.js / any runtime with no `RTCPeerConnection`.
+ */
+import debug from 'debug';
+const log = debug('sereus:cadre:turn-tracker');
+/**
+ * Hard cap on the FIFO queue. In steady state every settlement is consumed by a
+ * `connection:open`, so the queue stays tiny; the cap only bounds a pathological
+ * leak (settlements that never get a matching consume).
+ */
+const MAX_QUEUE = 64;
+export class TurnRelayTracker {
+    constructor() {
+        this.queue = [];
+        /** One settlement record per connection; guards against repeated `connected` events. */
+        this.observed = new WeakSet();
+    }
+    /**
+     * Wrap `globalThis.RTCPeerConnection` with a subclass that records each
+     * connection's TURN-relay verdict when it settles. Idempotent. A NOP when no
+     * `RTCPeerConnection` exists (Node.js / no WebRTC polyfill) — the tracker stays
+     * inert and {@link consume} always returns `null`.
+     */
+    install() {
+        if (this.OriginalRTCPeerConnection) {
+            return; // already installed
+        }
+        const Original = globalThis.RTCPeerConnection;
+        if (typeof Original !== 'function') {
+            log('install: no globalThis.RTCPeerConnection — tracker inert (Node.js / no polyfill)');
+            return;
+        }
+        this.OriginalRTCPeerConnection = Original;
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const tracker = this;
+        class TrackedRTCPeerConnection extends Original {
+            constructor(...args) {
+                super(...args);
+                try {
+                    this.addEventListener('connectionstatechange', () => {
+                        try {
+                            if (this.connectionState === 'connected' && !tracker.observed.has(this)) {
+                                tracker.observed.add(this);
+                                void tracker.recordSettlement(this);
+                            }
+                        }
+                        catch (error) {
+                            log('connectionstatechange handler failed: %o', error);
+                        }
+                    });
+                }
+                catch (error) {
+                    log('install: failed to attach connectionstatechange listener: %o', error);
+                }
+            }
+        }
+        globalThis.RTCPeerConnection = TrackedRTCPeerConnection;
+        log('install: wrapped globalThis.RTCPeerConnection');
+    }
+    /**
+     * Pop the most recent settled entry within `windowMs` ms of now, returning its
+     * relay verdict (`true`/`false`); `null` when the queue has no matching entry.
+     * Also prunes entries older than the window (they can never match a later
+     * consume). Synchronous and safe to call from a `connection:open` handler.
+     */
+    consume(windowMs) {
+        const now = Date.now();
+        let result = null;
+        // Walk newest → oldest; the most recent in-window settlement is the best
+        // correlation for a just-opened connection.
+        for (let i = this.queue.length - 1; i >= 0; i--) {
+            if (now - this.queue[i].settledAtMs <= windowMs) {
+                result = this.queue[i].isRelay;
+                this.queue.splice(i, 1);
+                break;
+            }
+        }
+        this.pruneOlderThan(now - windowMs);
+        return result;
+    }
+    /** Restore the original `RTCPeerConnection` and clear the queue. Idempotent. */
+    dispose() {
+        if (this.OriginalRTCPeerConnection) {
+            globalThis.RTCPeerConnection = this.OriginalRTCPeerConnection;
+            this.OriginalRTCPeerConnection = undefined;
+        }
+        this.queue.length = 0;
+    }
+    /**
+     * Inspect a settled connection's stats and queue its TURN-relay verdict. Any
+     * failure (stats API absent, rejected promise, malformed report) is caught and
+     * recorded as `isRelay: false` — the safe default (unknown → not relayed) keeps
+     * the connection counted rather than dropping it.
+     */
+    async recordSettlement(pc) {
+        // Defaults to not-relayed (the safe "unknown" verdict); only the success path
+        // below overrides it, so a getStats failure leaves it false.
+        let isRelay = false;
+        try {
+            const report = await pc.getStats();
+            isRelay = selectedCandidatePairIsRelay(statsToMap(report));
+        }
+        catch (error) {
+            log('recordSettlement: getStats failed, keeping not-relayed default: %o', error);
+        }
+        this.queue.push({ settledAtMs: Date.now(), isRelay });
+        if (this.queue.length > MAX_QUEUE) {
+            this.queue.shift();
+        }
+    }
+    /** Drop queued entries settled before `cutoffMs` (the queue is in push order). */
+    pruneOlderThan(cutoffMs) {
+        while (this.queue.length > 0 && this.queue[0].settledAtMs < cutoffMs) {
+            this.queue.shift();
+        }
+    }
+}
+/** Materialise an `RTCStatsReport` into a plain map keyed by stats id. */
+function statsToMap(report) {
+    const map = new Map();
+    report.forEach((value, key) => {
+        map.set(key, value);
+    });
+    return map;
+}
+/**
+ * Whether the selected ICE candidate pair used a TURN relay candidate on either
+ * end. The pair is the transport's `selectedCandidatePairId` when present, else
+ * the nominated succeeded pair, else any succeeded pair.
+ */
+function selectedCandidatePairIsRelay(stats) {
+    const pair = findSelectedPair(stats);
+    if (!pair) {
+        return false;
+    }
+    const local = pair.localCandidateId ? stats.get(pair.localCandidateId) : undefined;
+    const remote = pair.remoteCandidateId ? stats.get(pair.remoteCandidateId) : undefined;
+    return isRelayCandidate(local) || isRelayCandidate(remote);
+}
+function isRelayCandidate(stat) {
+    return stat?.type === 'local-candidate' || stat?.type === 'remote-candidate'
+        ? stat.candidateType === 'relay'
+        : false;
+}
+function findSelectedPair(stats) {
+    const selectedId = selectedPairIdFromTransport(stats);
+    if (selectedId) {
+        const stat = stats.get(selectedId);
+        if (stat?.type === 'candidate-pair') {
+            return stat;
+        }
+    }
+    let succeeded;
+    for (const stat of stats.values()) {
+        if (stat.type !== 'candidate-pair') {
+            continue;
+        }
+        const pair = stat;
+        if (pair.state !== 'succeeded') {
+            continue;
+        }
+        if (pair.nominated) {
+            return pair; // nominated succeeded pair wins outright
+        }
+        succeeded ?? (succeeded = pair);
+    }
+    return succeeded;
+}
+function selectedPairIdFromTransport(stats) {
+    for (const stat of stats.values()) {
+        if (stat.type === 'transport') {
+            const id = stat.selectedCandidatePairId;
+            if (typeof id === 'string') {
+                return id;
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=webrtc-turn-tracker.js.map

package/dist/diagnostics/webrtc-turn-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc-turn-tracker.js","sourceRoot":"","sources":["../../src/diagnostics/webrtc-turn-tracker.ts"],"names":[],"mappings":"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"}

package/dist/hibernation-manager.d.ts

@@ -6,6 +6,17 @@ export interface HibernationCallbacks {
     onIdle: (strandId: string) => Promise<void>;
     onHibernate: (strandId: string) => Promise<void>;
     onWake: (strandId: string) => Promise<void>;
+    /**
+     * Perform a real cohort check-in for a hibernating strand. The implementation
+     * (`CadreNode.handleStrandCheckIn`) resumes the strand, gives it a bounded
+     * window to connect to reachable cohort peers and surface pending activity,
+     * then re-hibernates if still idle. The manager AWAITS this before scheduling
+     * the next (longer-delayed) check-in, so a slow check-in never overlaps the
+     * next tick. After it resolves the manager inspects `instance.status`: a
+     * strand left non-`hibernating` is treated as woken (backoff resets on the
+     * next hibernation); a strand left `hibernating` escalates the backoff.
+     */
+    onCheckIn: (strandId: string) => Promise<void>;
 }
 /**
  * Manages strand hibernation state transitions based on activity.
@@ -20,7 +31,20 @@ export declare class HibernationManager {
     private readonly config;
     private readonly callbacks;
     private readonly timers;
+    /**
+     * Pending check-in timers, one per hibernating strand. Unlike the old fixed
+     * `setInterval`, these are single-shot `setTimeout`s rescheduled by
+     * {@link runCheckIn} with an escalating delay — so a long-running `onCheckIn`
+     * can never overlap the next tick, and the period adapts to the backoff.
+     */
     private readonly checkInTimers;
+    /**
+     * In-flight wake promises keyed by strandId. Coalesces overlapping wake
+     * triggers (two near-simultaneous activities, or activity racing a force wake)
+     * so `onWake` — and the libp2p-node rebuild it drives — runs at most once per
+     * concurrent wake.
+     */
+    private readonly wakePromises;
     private running;
     constructor(config: HibernationConfig, callbacks: HibernationCallbacks);
     /**
@@ -35,6 +59,31 @@ export declare class HibernationManager {
      * Stop managing hibernation
      */
     stop(): void;
+    /**
+     * Whether a strand with this instance's latency hint ever hibernates — `false`
+     * for realtime (Infinity idle timeout, see {@link HIBERNATION_TIMEOUTS}), also
+     * honouring any per-hint `customTimeouts` override. Imperative callers
+     * (`CadreNode.hibernateStrand` / `hibernateAll`) use this as the single source
+     * of truth for "skip realtime", consistent with {@link trackStrand} declining
+     * to track Infinity-timeout strands.
+     */
+    hibernates(instance: StrandInstance): boolean;
+    /**
+     * Imperatively hibernate a tracked strand now, bypassing the idle/hibernate
+     * timers — the mobile background-entry path. Cancels the strand's pending
+     * idle/hibernate AND check-in timers so none can later re-fire `onHibernate`
+     * on the already-quiesced strand or resurrect one the caller means to keep
+     * down, then invokes `onHibernate` (quiesce + mark hibernating).
+     *
+     * Unlike the timer path ({@link handleHibernateTimeout}) it deliberately does
+     * NOT re-arm the check-in chain: a force-hibernate keeps the strand down until
+     * the caller drives the next wake on demand (push-delivered on mobile), so a
+     * stray check-in timer must not bring it back up.
+     *
+     * @returns `true` if the strand was hibernated, `false` (no-op) for a realtime
+     *   strand that never hibernates.
+     */
+    forceHibernate(instance: StrandInstance): Promise<boolean>;
     /**
      * Register a strand for hibernation management
      */
@@ -51,11 +100,41 @@ export declare class HibernationManager {
      * Force wake a hibernating strand
      */
     wakeStrand(strandId: string): Promise<void>;
+    /**
+     * Begin a wake for a strand, or coalesce with one already in flight. Ensures
+     * `onWake` runs at most once per concurrent wake — the returned promise is
+     * shared by all overlapping callers and cleared once it settles. Force-wake
+     * callers await it; activity-driven callers fire-and-forget.
+     */
+    private beginWake;
     private scheduleIdleTransition;
     private handleIdleTimeout;
     private scheduleHibernateTransition;
     private handleHibernateTimeout;
+    /**
+     * Arm the next check-in for a hibernating strand. Each call is a single-shot
+     * `setTimeout` (not a fixed `setInterval`) so the period escalates per
+     * {@link runCheckIn} and a slow `onCheckIn` never overlaps the next tick.
+     *
+     * `delay` is omitted by the chain start ({@link handleHibernateTimeout}),
+     * defaulting to the base `checkInInterval` — which is why backoff naturally
+     * resets to base each fresh hibernation cycle, with no per-strand counter to
+     * clear on wake. Subsequent ticks pass the escalated, capped delay.
+     */
     private scheduleCheckIn;
+    /**
+     * Run a single check-in tick: invoke `onCheckIn` (a real resume → bounded
+     * sync window → re-hibernate-if-idle cycle in `CadreNode`) and AWAIT it before
+     * deciding the next step.
+     *
+     * - If the strand woke during the check-in (`onCheckIn` left it non-
+     *   `hibernating`), stop the chain — the activity path has re-armed the
+     *   idle/hibernate timers, and the next hibernation restarts the chain at the
+     *   base delay (backoff reset).
+     * - Otherwise escalate the delay by `checkInBackoffFactor`, capped at
+     *   `checkInMaxInterval`, and reschedule.
+     */
+    private runCheckIn;
     private clearTimer;
     private clearTimers;
     /**

package/dist/hibernation-manager.js

@@ -13,7 +13,20 @@ const log = debug('sereus:cadre:hibernation');
 export class HibernationManager {
     constructor(config, callbacks) {
         this.timers = new Map();
+        /**
+         * Pending check-in timers, one per hibernating strand. Unlike the old fixed
+         * `setInterval`, these are single-shot `setTimeout`s rescheduled by
+         * {@link runCheckIn} with an escalating delay — so a long-running `onCheckIn`
+         * can never overlap the next tick, and the period adapts to the backoff.
+         */
         this.checkInTimers = new Map();
+        /**
+         * In-flight wake promises keyed by strandId. Coalesces overlapping wake
+         * triggers (two near-simultaneous activities, or activity racing a force wake)
+         * so `onWake` — and the libp2p-node rebuild it drives — runs at most once per
+         * concurrent wake.
+         */
+        this.wakePromises = new Map();
         this.running = false;
         this.config = config;
         this.callbacks = callbacks;
@@ -30,7 +43,9 @@ export class HibernationManager {
         return {
             idleTimeout: custom.idleTimeout ?? defaults.idleTimeout,
             hibernateTimeout: custom.hibernateTimeout ?? defaults.hibernateTimeout,
-            checkInInterval: custom.checkInInterval ?? defaults.checkInInterval
+            checkInInterval: custom.checkInInterval ?? defaults.checkInInterval,
+            checkInBackoffFactor: custom.checkInBackoffFactor ?? defaults.checkInBackoffFactor,
+            checkInMaxInterval: custom.checkInMaxInterval ?? defaults.checkInMaxInterval
         };
     }
     /**
@@ -55,11 +70,53 @@ export class HibernationManager {
         }
         this.timers.clear();
         for (const timer of this.checkInTimers.values()) {
-            clearInterval(timer);
+            clearTimeout(timer);
         }
         this.checkInTimers.clear();
+        // In-flight wakes clean themselves up via their finally; drop the references
+        // so a fresh start coalesces cleanly.
+        this.wakePromises.clear();
         log('HibernationManager stopped');
     }
+    /**
+     * Whether a strand with this instance's latency hint ever hibernates — `false`
+     * for realtime (Infinity idle timeout, see {@link HIBERNATION_TIMEOUTS}), also
+     * honouring any per-hint `customTimeouts` override. Imperative callers
+     * (`CadreNode.hibernateStrand` / `hibernateAll`) use this as the single source
+     * of truth for "skip realtime", consistent with {@link trackStrand} declining
+     * to track Infinity-timeout strands.
+     */
+    hibernates(instance) {
+        return this.getTimeouts(instance.latencyHint).idleTimeout !== Infinity;
+    }
+    /**
+     * Imperatively hibernate a tracked strand now, bypassing the idle/hibernate
+     * timers — the mobile background-entry path. Cancels the strand's pending
+     * idle/hibernate AND check-in timers so none can later re-fire `onHibernate`
+     * on the already-quiesced strand or resurrect one the caller means to keep
+     * down, then invokes `onHibernate` (quiesce + mark hibernating).
+     *
+     * Unlike the timer path ({@link handleHibernateTimeout}) it deliberately does
+     * NOT re-arm the check-in chain: a force-hibernate keeps the strand down until
+     * the caller drives the next wake on demand (push-delivered on mobile), so a
+     * stray check-in timer must not bring it back up.
+     *
+     * @returns `true` if the strand was hibernated, `false` (no-op) for a realtime
+     *   strand that never hibernates.
+     */
+    async forceHibernate(instance) {
+        if (!this.hibernates(instance)) {
+            log('forceHibernate: strand %s is realtime; no-op', instance.strandId);
+            return false;
+        }
+        // Cancel idle/hibernate + check-in timers BEFORE quiescing so nothing fights
+        // the imperative hibernate (a stale hibernate timer firing on the quiesced
+        // strand, or a check-in resuming a strand the caller wants kept down).
+        this.clearTimers(instance.strandId);
+        await this.callbacks.onHibernate(instance.strandId);
+        log('forceHibernate: strand %s hibernated (timers cancelled, not re-armed)', instance.strandId);
+        return true;
+    }
     /**
      * Register a strand for hibernation management
      */
@@ -91,11 +148,31 @@ export class HibernationManager {
             return;
         const { strandId, status, latencyHint } = instance;
         instance.lastActivity = new Date();
-        // If idle or hibernating, wake up
+        // If idle or hibernating, wake up. Coalesce so two near-simultaneous
+        // activities don't each fire onWake (which would rebuild two libp2p nodes).
         if (status === 'idle' || status === 'hibernating') {
             log('Activity on %s strand %s - waking', status, strandId);
             this.clearTimers(strandId);
-            void this.callbacks.onWake(strandId);
+            // Fire-and-forget; force-wake awaiters see errors, so swallow (and log)
+            // here to avoid an unhandled rejection on this best-effort path.
+            //
+            // Once the wake settles (CadreNode rebuilds the runtime and marks the
+            // strand `active`), re-arm the idle→hibernate→check-in cycle. Without this
+            // a strand that wakes then goes quiet stays `active` forever and never
+            // re-hibernates — so the check-in backoff could never restart at base.
+            // Guarded on `active` so a wake that did not transition (a coalesced
+            // no-op, or a still-mid-flight rebuild) never arms a stray timer.
+            void this.beginWake(strandId).then(() => {
+                if (this.running && instance.status === 'active') {
+                    const timeouts = this.getTimeouts(instance.latencyHint);
+                    if (timeouts.idleTimeout !== Infinity) {
+                        this.scheduleIdleTransition(instance);
+                    }
+                }
+            }).catch((err) => {
+                log('Activity-driven wake failed for strand %s: %o', strandId, err);
+            });
+            return;
         }
         // Reschedule idle transition if active
         if (status === 'active') {
@@ -110,7 +187,29 @@ export class HibernationManager {
      */
     async wakeStrand(strandId) {
         this.clearTimers(strandId);
-        await this.callbacks.onWake(strandId);
+        await this.beginWake(strandId);
+    }
+    /**
+     * Begin a wake for a strand, or coalesce with one already in flight. Ensures
+     * `onWake` runs at most once per concurrent wake — the returned promise is
+     * shared by all overlapping callers and cleared once it settles. Force-wake
+     * callers await it; activity-driven callers fire-and-forget.
+     */
+    beginWake(strandId) {
+        const existing = this.wakePromises.get(strandId);
+        if (existing) {
+            return existing;
+        }
+        const wake = (async () => {
+            try {
+                await this.callbacks.onWake(strandId);
+            }
+            finally {
+                this.wakePromises.delete(strandId);
+            }
+        })();
+        this.wakePromises.set(strandId, wake);
+        return wake;
     }
     scheduleIdleTransition(instance) {
         const { strandId, latencyHint } = instance;
@@ -128,13 +227,16 @@ export class HibernationManager {
         if (!this.running)
             return;
         log('Idle timeout for strand %s', strandId);
-        // Transition to idle
+        // Transition to idle. The callback can reject (e.g. a future idle handler
+        // that releases resources); catch so the timer chain never unhandled-rejects.
         void this.callbacks.onIdle(strandId).then(() => {
             // Schedule hibernate transition
             const timeouts = this.getTimeouts(latencyHint);
             if (timeouts.hibernateTimeout !== Infinity) {
                 this.scheduleHibernateTransition(instance);
             }
+        }).catch((err) => {
+            log('onIdle failed for strand %s: %o', strandId, err);
         });
     }
     scheduleHibernateTransition(instance) {
@@ -153,36 +255,84 @@ export class HibernationManager {
         if (!this.running)
             return;
         log('Hibernate timeout for strand %s', strandId);
-        // Transition to hibernating
+        // Transition to hibernating. onHibernate now releases strand-network
+        // resources (quiesce), so its close()/stop() can reject — catch so a failed
+        // hibernate logs instead of producing an unhandled rejection.
         void this.callbacks.onHibernate(strandId).then(() => {
             // Schedule periodic check-ins
             const timeouts = this.getTimeouts(latencyHint);
             if (timeouts.checkInInterval !== Infinity) {
                 this.scheduleCheckIn(instance);
             }
+        }).catch((err) => {
+            log('onHibernate failed for strand %s: %o', strandId, err);
         });
     }
-    scheduleCheckIn(instance) {
+    /**
+     * Arm the next check-in for a hibernating strand. Each call is a single-shot
+     * `setTimeout` (not a fixed `setInterval`) so the period escalates per
+     * {@link runCheckIn} and a slow `onCheckIn` never overlaps the next tick.
+     *
+     * `delay` is omitted by the chain start ({@link handleHibernateTimeout}),
+     * defaulting to the base `checkInInterval` — which is why backoff naturally
+     * resets to base each fresh hibernation cycle, with no per-strand counter to
+     * clear on wake. Subsequent ticks pass the escalated, capped delay.
+     */
+    scheduleCheckIn(instance, delay) {
         const { strandId, latencyHint } = instance;
         const timeouts = this.getTimeouts(latencyHint);
-        // Clear existing check-in timer
+        const currentDelay = delay ?? timeouts.checkInInterval;
+        // Replace any existing check-in timer (no-op if the firing timer rescheduled us).
         const existing = this.checkInTimers.get(strandId);
         if (existing) {
-            clearInterval(existing);
+            clearTimeout(existing);
         }
-        // Schedule periodic check-ins
-        const timer = setInterval(() => {
-            if (!this.running) {
-                clearInterval(timer);
-                return;
-            }
-            log('Check-in for hibernating strand %s', strandId);
-            instance.nextCheckIn = new Date(Date.now() + timeouts.checkInInterval);
-            // In a real implementation, this would query the cohort for pending activity
-            // For now, we just update the nextCheckIn timestamp
-        }, timeouts.checkInInterval);
+        const timer = setTimeout(() => {
+            void this.runCheckIn(instance, currentDelay);
+        }, currentDelay);
         this.checkInTimers.set(strandId, timer);
-        instance.nextCheckIn = new Date(Date.now() + timeouts.checkInInterval);
+        instance.nextCheckIn = new Date(Date.now() + currentDelay);
+    }
+    /**
+     * Run a single check-in tick: invoke `onCheckIn` (a real resume → bounded
+     * sync window → re-hibernate-if-idle cycle in `CadreNode`) and AWAIT it before
+     * deciding the next step.
+     *
+     * - If the strand woke during the check-in (`onCheckIn` left it non-
+     *   `hibernating`), stop the chain — the activity path has re-armed the
+     *   idle/hibernate timers, and the next hibernation restarts the chain at the
+     *   base delay (backoff reset).
+     * - Otherwise escalate the delay by `checkInBackoffFactor`, capped at
+     *   `checkInMaxInterval`, and reschedule.
+     */
+    async runCheckIn(instance, currentDelay) {
+        const { strandId, latencyHint } = instance;
+        if (!this.running)
+            return;
+        log('Check-in for hibernating strand %s (delay=%dms)', strandId, currentDelay);
+        try {
+            await this.callbacks.onCheckIn(strandId);
+        }
+        catch (err) {
+            // A failed check-in (e.g. resume threw) must not break the chain — log and
+            // fall through to reschedule the next, longer-delayed attempt.
+            log('onCheckIn failed for strand %s: %o', strandId, err);
+        }
+        if (!this.running)
+            return;
+        // The check-in either woke the strand (CadreNode left it active) or left it
+        // hibernating. Inspect the shared instance the callback just mutated.
+        if (instance.status !== 'hibernating') {
+            log('Check-in woke strand %s; backoff resets on next hibernation', strandId);
+            this.checkInTimers.delete(strandId);
+            // The chain is stopping; drop the now-stale next-check-in advertisement so
+            // `getStrand` doesn't report a phantom check-in for a strand that is awake.
+            instance.nextCheckIn = undefined;
+            return;
+        }
+        const timeouts = this.getTimeouts(latencyHint);
+        const nextDelay = Math.min(currentDelay * timeouts.checkInBackoffFactor, timeouts.checkInMaxInterval);
+        this.scheduleCheckIn(instance, nextDelay);
     }
     clearTimer(strandId) {
         const timer = this.timers.get(strandId);
@@ -195,7 +345,7 @@ export class HibernationManager {
         this.clearTimer(strandId);
         const checkInTimer = this.checkInTimers.get(strandId);
         if (checkInTimer) {
-            clearInterval(checkInTimer);
+            clearTimeout(checkInTimer);
             this.checkInTimers.delete(strandId);
         }
     }

package/dist/hibernation-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"hibernation-manager.js","sourceRoot":"","sources":["../src/hibernation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,GAAG,GAAG,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAW9C;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IAO7B,YAAY,MAAyB,EAAE,SAA+B;QAJrD,WAAM,GAA+C,IAAI,GAAG,EAAE,CAAC;QAC/D,kBAAa,GAAgD,IAAI,GAAG,EAAE,CAAC;QAChF,YAAO,GAAG,KAAK,CAAC;QAGtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,GAAG,CAAC,wCAAwC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAiB;QACnC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QAE7B,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;YACvD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB;YACtE,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe;SACpE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,GAAG,CAAC,4BAA4B,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,mBAAmB;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAE3B,GAAG,CAAC,4BAA4B,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAwB;QAClC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAElD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE/C,2CAA2C;QAC3C,IAAI,QAAQ,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACtC,GAAG,CAAC,sDAAsD,EAAE,QAAQ,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QAED,GAAG,CAAC,8CAA8C,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC3E,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAgB;QAC5B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3B,GAAG,CAAC,sCAAsC,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAwB;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAElD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QACnD,QAAQ,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;QAEnC,kCAAkC;QAClC,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;YAClD,GAAG,CAAC,mCAAmC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC3D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC3B,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,uCAAuC;QACvC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,QAAQ,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;gBACtC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAEO,sBAAsB,CAAC,QAAwB;QACrD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE/C,uBAAuB;QACvB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE1B,2BAA2B;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QAEzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAEO,iBAAiB,CAAC,QAAwB;QAChD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QAE3C,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,GAAG,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;QAE5C,qBAAqB;QACrB,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC7C,gCAAgC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,QAAQ,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;gBAC3C,IAAI,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,2BAA2B,CAAC,QAAwB;QAC1D,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE/C,uBAAuB;QACvB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE1B,gCAAgC;QAChC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAE9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAEO,sBAAsB,CAAC,QAAwB;QACrD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QAE3C,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,GAAG,CAAC,iCAAiC,EAAE,QAAQ,CAAC,CAAC;QAEjD,4BAA4B;QAC5B,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAClD,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;gBAC1C,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,QAAwB;QAC9C,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE/C,gCAAgC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAED,8BAA8B;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,GAAG,CAAC,oCAAoC,EAAE,QAAQ,CAAC,CAAC;YACpD,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;YAEvE,6EAA6E;YAC7E,oDAAoD;QACtD,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;QAE7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxC,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IACzE,CAAC;IAEO,UAAU,CAAC,QAAgB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,QAAgB;QAClC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,YAAY,EAAE,CAAC;YACjB,aAAa,CAAC,YAAY,CAAC,CAAC;YAC5B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YAC5C,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI;SAC3D,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"hibernation-manager.js","sourceRoot":"","sources":["../src/hibernation-manager.ts"],"names":[],"mappings":"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"}