@seat-mesh/daemon 0.1.26 → 0.1.29

package/dist/connectivity/connectivity-recovery.test.js

@@ -0,0 +1,170 @@
+import { describe, expect, it } from "vitest";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { clearOcLimitBannerForPane, maybeEndRateLimitEpisode, newConnectivityRecoveryState, shouldChainRotateUntilAfterSmart, shouldNotifyProxyDownStuck, smartRestartCooldownLeftSec, updateIpifyProbeStreak, updatePaneConnectStreak, updateRateLimitEpisode, } from "./connectivity-recovery.js";
+describe("updateIpifyProbeStreak (debounce shallow ipify failures)", () => {
+    it("does not confirm down on the first failure", () => {
+        const state = newConnectivityRecoveryState();
+        const r = updateIpifyProbeStreak(state, false, 3);
+        expect(r.confirmedDown).toBe(false);
+        expect(r.streak).toBe(1);
+    });
+    it("confirms down only after threshold consecutive failures", () => {
+        const state = newConnectivityRecoveryState();
+        updateIpifyProbeStreak(state, false, 3);
+        updateIpifyProbeStreak(state, false, 3);
+        const r = updateIpifyProbeStreak(state, false, 3);
+        expect(r.confirmedDown).toBe(true);
+        expect(r.streak).toBe(3);
+    });
+    it("resets streak when carrier is ok again", () => {
+        const state = newConnectivityRecoveryState();
+        updateIpifyProbeStreak(state, false, 3);
+        updateIpifyProbeStreak(state, true, 3);
+        expect(state.ipifyFailStreak).toBe(0);
+        const r = updateIpifyProbeStreak(state, false, 3);
+        expect(r.confirmedDown).toBe(false);
+        expect(r.streak).toBe(1);
+    });
+});
+describe("updatePaneConnectStreak (PROXY-DOWN scrollback debounce)", () => {
+    it("does not confirm connect on first observation", () => {
+        const m = new Map();
+        const r = updatePaneConnectStreak(m, "%1", true, 15);
+        expect(r.confirmed).toBe(false);
+        expect(r.streak).toBe(1);
+    });
+    it("confirms only after threshold consecutive observations", () => {
+        const m = new Map();
+        for (let i = 0; i < 14; i++) {
+            updatePaneConnectStreak(m, "%1", true, 15);
+        }
+        const r = updatePaneConnectStreak(m, "%1", true, 15);
+        expect(r.confirmed).toBe(true);
+        expect(r.streak).toBe(15);
+    });
+    it("resets when the pane no longer shows connect errors", () => {
+        const m = new Map();
+        updatePaneConnectStreak(m, "%1", true, 15);
+        updatePaneConnectStreak(m, "%1", false, 15);
+        expect(m.has("%1")).toBe(false);
+    });
+});
+describe("updateRateLimitEpisode (OC-LIMIT rising-edge/episode)", () => {
+    it("starts an episode on the first rate-limited pane", () => {
+        const state = newConnectivityRecoveryState();
+        const r = updateRateLimitEpisode(state, true, 1_000);
+        expect(r.action).toBe("start");
+        expect(state.rateLimitEpisodeActive).toBe(true);
+        expect(state.lastRateLimitSeenAt).toBe(1_000);
+    });
+    it("does not re-trigger while the episode is already active (no re-arm loop)", () => {
+        const state = newConnectivityRecoveryState();
+        updateRateLimitEpisode(state, true, 1_000);
+        const r = updateRateLimitEpisode(state, true, 2_000);
+        expect(r.action).toBe("continue");
+        expect(state.lastRateLimitSeenAt).toBe(2_000);
+    });
+    it("does not clear immediately when limited panes disappear (flicker grace)", () => {
+        const state = newConnectivityRecoveryState();
+        updateRateLimitEpisode(state, true, 1_000);
+        const r = updateRateLimitEpisode(state, false, 1_500, 120_000);
+        expect(r.action).toBe("none");
+        expect(state.rateLimitEpisodeActive).toBe(true);
+    });
+    it("clears the episode once the grace period has elapsed with no limited panes", () => {
+        const state = newConnectivityRecoveryState();
+        updateRateLimitEpisode(state, true, 1_000);
+        const r = updateRateLimitEpisode(state, false, 1_000 + 120_001, 120_000);
+        expect(r.action).toBe("clear");
+        expect(state.rateLimitEpisodeActive).toBe(false);
+    });
+    it("newConnectivityRecoveryState includes rateLimitRecoveryStarted false", () => {
+        expect(newConnectivityRecoveryState().rateLimitRecoveryStarted).toBe(false);
+    });
+    it("is a no-op when never armed and still no limit", () => {
+        const state = newConnectivityRecoveryState();
+        const r = updateRateLimitEpisode(state, false, 1_000);
+        expect(r.action).toBe("none");
+    });
+});
+describe("shouldChainRotateUntilAfterSmart (Proxy-SMART -> rotate-until chaining)", () => {
+    it("chains when Proxy-SMART skipped on cooldown (exit 2)", () => {
+        expect(shouldChainRotateUntilAfterSmart({ exitCode: 2, ipBefore: "1.2.3.4", ipAfter: "1.2.3.4" })).toBe(true);
+    });
+    it("chains when the carrier IP failed to resolve after SMART", () => {
+        expect(shouldChainRotateUntilAfterSmart({ exitCode: 0, ipBefore: "1.2.3.4", ipAfter: null })).toBe(true);
+    });
+    it("chains when the carrier IP is unchanged (SMART no-op)", () => {
+        expect(shouldChainRotateUntilAfterSmart({ exitCode: 0, ipBefore: "1.2.3.4", ipAfter: "1.2.3.4" })).toBe(true);
+    });
+    it("chains when SMART exited non-zero for any other reason", () => {
+        expect(shouldChainRotateUntilAfterSmart({ exitCode: 1, ipBefore: "1.2.3.4", ipAfter: "5.6.7.8" })).toBe(true);
+    });
+    it("does NOT chain when SMART succeeded and rotated the carrier IP", () => {
+        expect(shouldChainRotateUntilAfterSmart({ exitCode: 0, ipBefore: "1.2.3.4", ipAfter: "5.6.7.8" })).toBe(false);
+    });
+});
+describe("shouldNotifyProxyDownStuck (PROXY-DOWN silence fix)", () => {
+    it("does not notify before an episode has started", () => {
+        const state = newConnectivityRecoveryState();
+        expect(shouldNotifyProxyDownStuck(state, 1_000, 120_000)).toBe(false);
+    });
+    it("does not notify before the threshold elapses", () => {
+        const state = newConnectivityRecoveryState();
+        state.proxyDownEpisodeStartAt = 1_000;
+        expect(shouldNotifyProxyDownStuck(state, 1_000 + 119_999, 120_000)).toBe(false);
+    });
+    it("notifies once the threshold elapses", () => {
+        const state = newConnectivityRecoveryState();
+        state.proxyDownEpisodeStartAt = 1_000;
+        expect(shouldNotifyProxyDownStuck(state, 1_000 + 120_000, 120_000)).toBe(true);
+    });
+    it("never re-fires once already notified for this episode", () => {
+        const state = newConnectivityRecoveryState();
+        state.proxyDownEpisodeStartAt = 1_000;
+        state.proxyDownStuckNotified = true;
+        expect(shouldNotifyProxyDownStuck(state, 1_000 + 999_999, 120_000)).toBe(false);
+    });
+});
+describe("clearOcLimitBannerForPane", () => {
+    it("removes pane from ocLimited and ends episode when cache empty", () => {
+        const state = newConnectivityRecoveryState();
+        state.ocLimited.add("%9");
+        state.rateLimitEpisodeActive = true;
+        state.rateLimitRecoveryStarted = true;
+        expect(clearOcLimitBannerForPane(state, "%9")).toBe(true);
+        expect(state.ocLimited.has("%9")).toBe(false);
+        maybeEndRateLimitEpisode(state);
+        expect(state.rateLimitEpisodeActive).toBe(false);
+        expect(state.rateLimitRecoveryStarted).toBe(false);
+    });
+});
+describe("smartRestartCooldownLeftSec (harness-parity stamp file)", () => {
+    const tmpStamp = path.join(os.tmpdir(), `sm-test-smart-restart-${process.pid}.last`);
+    it("returns 0 when the stamp file does not exist", () => {
+        expect(smartRestartCooldownLeftSec(tmpStamp, 1800, 1_000_000)).toBe(0);
+    });
+    it("returns seconds left when within the cooldown window", () => {
+        const nowSec = 1_000_000;
+        fs.writeFileSync(tmpStamp, String(nowSec - 100));
+        try {
+            expect(smartRestartCooldownLeftSec(tmpStamp, 1800, nowSec * 1000)).toBe(1700);
+        }
+        finally {
+            fs.rmSync(tmpStamp, { force: true });
+        }
+    });
+    it("returns 0 once the cooldown window has fully elapsed", () => {
+        const nowSec = 1_000_000;
+        fs.writeFileSync(tmpStamp, String(nowSec - 1800));
+        try {
+            expect(smartRestartCooldownLeftSec(tmpStamp, 1800, nowSec * 1000)).toBe(0);
+        }
+        finally {
+            fs.rmSync(tmpStamp, { force: true });
+        }
+    });
+});
+//# sourceMappingURL=connectivity-recovery.test.js.map

package/dist/connectivity/connectivity-recovery.test.js.map

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

package/dist/connectivity/oc-resume-ack.d.ts

@@ -0,0 +1,32 @@
+import type { ProviderRegistry } from "@seat-mesh/core";
+export interface ResumeAckWave {
+    paneIds: Set<string>;
+    acked: Set<string>;
+    reason: string;
+    startedAt: number;
+    timeoutNotified: boolean;
+}
+export declare function currentResumeAckWave(): ResumeAckWave | null;
+/** Test-only: reset module state between cases. */
+export declare function resetResumeAckWave(): void;
+/**
+ * Pure decision: given a wave's ack progress, what should the daemon do next?
+ * Exported for unit testing without tmux/process spawning.
+ */
+export declare function nextAckWaveAction(input: {
+    total: number;
+    ackedCount: number;
+    startedAt: number;
+    timeoutNotified: boolean;
+}, nowMs?: number, timeoutMs?: number): "idle" | "all-acked" | "timeout" | "waiting";
+/**
+ * Call right after a resume wave is sent — arms ack tracking for exactly those panes.
+ * A fresh wave replaces whatever was pending (the newest resume is the one that matters).
+ */
+export declare function armResumeAckWave(paneIds: string[], reason: string): void;
+/**
+ * Poll tick: check pending panes for proof they're actually working again (composer no
+ * longer shows `limit`), then notify operator once the wave fully confirms or times out.
+ */
+export declare function pollResumeAcks(registry: ProviderRegistry, workspace: string, log: (line: string) => void, onPaneAcked?: (paneId: string) => void): void;
+//# sourceMappingURL=oc-resume-ack.d.ts.map

package/dist/connectivity/oc-resume-ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oc-resume-ack.d.ts","sourceRoot":"","sources":["../../src/connectivity/oc-resume-ack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOxD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAKD,wBAAgB,oBAAoB,IAAI,aAAa,GAAG,IAAI,CAE3D;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,EACzF,KAAK,GAAE,MAAmB,EAC1B,SAAS,GAAE,MAAuB,GACjC,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAK9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASxE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACrC,IAAI,CAwDN"}

package/dist/connectivity/oc-resume-ack.js

@@ -0,0 +1,89 @@
+import { capturePaneSnapshot } from "@seat-mesh/tmux";
+import { notifyConnectivityStatus, RESUME_ACK_HOWTO } from "./oc-resume.js";
+/** How long to wait for a resumed pane to prove it's working again before flagging it stuck. */
+const ACK_TIMEOUT_MS = 5 * 60_000;
+/** Module-level: at most one resume wave is tracked for ack at a time (a new wave replaces it). */
+let activeWave = null;
+export function currentResumeAckWave() {
+    return activeWave;
+}
+/** Test-only: reset module state between cases. */
+export function resetResumeAckWave() {
+    activeWave = null;
+}
+/**
+ * Pure decision: given a wave's ack progress, what should the daemon do next?
+ * Exported for unit testing without tmux/process spawning.
+ */
+export function nextAckWaveAction(input, nowMs = Date.now(), timeoutMs = ACK_TIMEOUT_MS) {
+    if (input.total <= 0)
+        return "idle";
+    if (input.ackedCount >= input.total)
+        return "all-acked";
+    if (!input.timeoutNotified && nowMs - input.startedAt >= timeoutMs)
+        return "timeout";
+    return "waiting";
+}
+/**
+ * Call right after a resume wave is sent — arms ack tracking for exactly those panes.
+ * A fresh wave replaces whatever was pending (the newest resume is the one that matters).
+ */
+export function armResumeAckWave(paneIds, reason) {
+    if (!paneIds.length)
+        return;
+    activeWave = {
+        paneIds: new Set(paneIds),
+        acked: new Set(),
+        reason,
+        startedAt: Date.now(),
+        timeoutNotified: false,
+    };
+}
+/**
+ * Poll tick: check pending panes for proof they're actually working again (composer no
+ * longer shows `limit`), then notify operator once the wave fully confirms or times out.
+ */
+export function pollResumeAcks(registry, workspace, log, onPaneAcked) {
+    const wave = activeWave;
+    if (!wave)
+        return;
+    for (const paneId of wave.paneIds) {
+        if (wave.acked.has(paneId))
+            continue;
+        const snap = capturePaneSnapshot(paneId);
+        if (!snap) {
+            wave.acked.add(paneId);
+            continue;
+        }
+        const prov = registry.detect(snap);
+        if (prov?.id !== "opencode") {
+            wave.acked.add(paneId);
+            continue;
+        }
+        if (prov.composerState(snap).phase !== "limit") {
+            wave.acked.add(paneId);
+            log(`OC-RESUME ack ${paneId} confirmed working — clearing OC-LIMIT banner`);
+            onPaneAcked?.(paneId);
+        }
+    }
+    const action = nextAckWaveAction({
+        total: wave.paneIds.size,
+        ackedCount: wave.acked.size,
+        startedAt: wave.startedAt,
+        timeoutNotified: wave.timeoutNotified,
+    });
+    if (action === "all-acked") {
+        log(`OC-RESUME all acked (${wave.acked.size}/${wave.paneIds.size}) reason=${wave.reason}`);
+        notifyConnectivityStatus(workspace, "OC resume", `All ${wave.paneIds.size} resumed OC panes acked — limit screens cleared (${wave.reason}).`, "No action needed.", "complete");
+        activeWave = null;
+        return;
+    }
+    if (action === "timeout") {
+        wave.timeoutNotified = true;
+        const stuck = wave.paneIds.size - wave.acked.size;
+        const ageSec = Math.round((Date.now() - wave.startedAt) / 1000);
+        log(`OC-RESUME ack timeout: ${stuck}/${wave.paneIds.size} unconfirmed after ${ageSec}s`);
+        notifyConnectivityStatus(workspace, "OC resume", `${stuck}/${wave.paneIds.size} resumed panes still not acked after ${ageSec}s (${wave.reason}).`, `${RESUME_ACK_HOWTO} Stuck panes: open pane, confirm limit text gone or press Enter once on resume.`, "incomplete");
+    }
+}
+//# sourceMappingURL=oc-resume-ack.js.map

package/dist/connectivity/oc-resume-ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oc-resume-ack.js","sourceRoot":"","sources":["../../src/connectivity/oc-resume-ack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,gGAAgG;AAChG,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AAUlC,mGAAmG;AACnG,IAAI,UAAU,GAAyB,IAAI,CAAC;AAE5C,MAAM,UAAU,oBAAoB;IAClC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,kBAAkB;IAChC,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAyF,EACzF,QAAgB,IAAI,CAAC,GAAG,EAAE,EAC1B,YAAoB,cAAc;IAElC,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,WAAW,CAAC;IACxD,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,KAAK,GAAG,KAAK,CAAC,SAAS,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IACrF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiB,EAAE,MAAc;IAChE,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO;IAC5B,UAAU,GAAG;QACX,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC;QACzB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,eAAe,EAAE,KAAK;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA0B,EAC1B,SAAiB,EACjB,GAA2B,EAC3B,WAAsC;IAEtC,MAAM,IAAI,GAAG,UAAU,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,EAAE,EAAE,KAAK,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACvB,GAAG,CAAC,iBAAiB,MAAM,+CAA+C,CAAC,CAAC;YAC5E,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACxB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,eAAe,EAAE,IAAI,CAAC,eAAe;KACtC,CAAC,CAAC;IAEH,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,GAAG,CAAC,wBAAwB,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,wBAAwB,CACtB,SAAS,EACT,WAAW,EACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,oDAAoD,IAAI,CAAC,MAAM,IAAI,EAC3F,mBAAmB,EACnB,UAAU,CACX,CAAC;QACF,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,GAAG,CAAC,0BAA0B,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,sBAAsB,MAAM,GAAG,CAAC,CAAC;QACzF,wBAAwB,CACtB,SAAS,EACT,WAAW,EACX,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,wCAAwC,MAAM,MAAM,IAAI,CAAC,MAAM,IAAI,EAChG,GAAG,gBAAgB,iFAAiF,EACpG,YAAY,CACb,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/connectivity/oc-resume-ack.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=oc-resume-ack.test.d.ts.map

package/dist/connectivity/oc-resume-ack.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oc-resume-ack.test.d.ts","sourceRoot":"","sources":["../../src/connectivity/oc-resume-ack.test.ts"],"names":[],"mappings":""}

package/dist/connectivity/oc-resume-ack.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { nextAckWaveAction } from "./oc-resume-ack.js";
+describe("nextAckWaveAction (OC-RESUME ack-confirmation wave)", () => {
+    it("is idle when there is nothing to track", () => {
+        expect(nextAckWaveAction({ total: 0, ackedCount: 0, startedAt: 0, timeoutNotified: false }, 1_000, 300_000)).toBe("idle");
+    });
+    it("waits while some panes are still unconfirmed and under the timeout", () => {
+        expect(nextAckWaveAction({ total: 3, ackedCount: 1, startedAt: 1_000, timeoutNotified: false }, 1_000 + 60_000, 300_000)).toBe("waiting");
+    });
+    it("reports all-acked once every pane has confirmed, regardless of elapsed time", () => {
+        expect(nextAckWaveAction({ total: 3, ackedCount: 3, startedAt: 1_000, timeoutNotified: false }, 1_000 + 999_999, 300_000)).toBe("all-acked");
+    });
+    it("reports timeout once the threshold elapses with stragglers left", () => {
+        expect(nextAckWaveAction({ total: 3, ackedCount: 1, startedAt: 1_000, timeoutNotified: false }, 1_000 + 300_000, 300_000)).toBe("timeout");
+    });
+    it("never re-fires timeout once already notified", () => {
+        expect(nextAckWaveAction({ total: 3, ackedCount: 1, startedAt: 1_000, timeoutNotified: true }, 1_000 + 999_999, 300_000)).toBe("waiting");
+    });
+    it("prefers all-acked over timeout when both conditions technically hold", () => {
+        expect(nextAckWaveAction({ total: 3, ackedCount: 3, startedAt: 1_000, timeoutNotified: false }, 1_000 + 300_000, 300_000)).toBe("all-acked");
+    });
+});
+//# sourceMappingURL=oc-resume-ack.test.js.map

package/dist/connectivity/oc-resume-ack.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oc-resume-ack.test.js","sourceRoot":"","sources":["../../src/connectivity/oc-resume-ack.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACnE,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CACJ,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CACrG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CACJ,iBAAiB,CACf,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,EACrE,KAAK,GAAG,MAAM,EACd,OAAO,CACR,CACF,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,CACJ,iBAAiB,CACf,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,EACrE,KAAK,GAAG,OAAO,EACf,OAAO,CACR,CACF,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CACJ,iBAAiB,CACf,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,EACrE,KAAK,GAAG,OAAO,EACf,OAAO,CACR,CACF,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CACJ,iBAAiB,CACf,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,EACpE,KAAK,GAAG,OAAO,EACf,OAAO,CACR,CACF,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,CACJ,iBAAiB,CACf,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,EACrE,KAAK,GAAG,OAAO,EACf,OAAO,CACR,CACF,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/connectivity/oc-resume.d.ts

@@ -0,0 +1,25 @@
+import type { ProviderRegistry } from "@seat-mesh/core";
+import { INBOX_NOTIFY_SLOT, type InboxNotifyPhase } from "@seat-mesh/tmux";
+export { INBOX_NOTIFY_SLOT };
+export type { InboxNotifyPhase };
+/** Shown on resume-sent / ack toasts so operator knows ack is inbox-automatic, not a manual command. */
+export declare const RESUME_ACK_HOWTO: string;
+export declare function notifyConnectivityStatus(workspace: string, topic: string, sessionAbout: string, check: string, phase?: InboxNotifyPhase): void;
+/** @deprecated Use resume wave notify with carrier meta instead. */
+export declare function notifyProxyCarrierIp(workspace: string, fromIp: string | null, toIp: string, reason: string): void;
+export declare function resumeOneOpenCodePane(paneId: string, registry: ProviderRegistry): {
+    ok: boolean;
+    cmd?: string;
+    reason?: string;
+};
+export declare function resumeAllOpenCodePanes(paneIds: string[], registry: ProviderRegistry, log?: (line: string) => void): {
+    sent: number;
+    total: number;
+    sentPaneIds: string[];
+};
+export interface ResumeWaveMeta {
+    fromIp?: string | null;
+    toIp?: string | null;
+}
+export declare function notifyResumeWave(workspace: string, reason: string, sent: number, total: number, meta?: ResumeWaveMeta): void;
+//# sourceMappingURL=oc-resume.d.ts.map

package/dist/connectivity/oc-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oc-resume.d.ts","sourceRoot":"","sources":["../../src/connectivity/oc-resume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAIL,iBAAiB,EAEjB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,wGAAwG;AACxG,eAAO,MAAM,gBAAgB,QAE+E,CAAC;AAE7G,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,gBAA6B,GACnC,IAAI,CAEN;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,CAWN;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GACzB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAchD;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBxD;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,cAAc,GACpB,IAAI,CAwBN"}

package/dist/connectivity/oc-resume.js

@@ -0,0 +1,84 @@
+import { formatOpenCodeResumeCommand } from "@seat-mesh/providers";
+import { capturePaneSnapshot, injectToPane, withPaneInputEnabled, INBOX_NOTIFY_SLOT, runInboxDesktopNotifySync, } from "@seat-mesh/tmux";
+export { INBOX_NOTIFY_SLOT };
+/** Shown on resume-sent / ack toasts so operator knows ack is inbox-automatic, not a manual command. */
+export const RESUME_ACK_HOWTO = "Ack: automatic — when the OC composer is back (limit screen gone), inbox clears the OC-LIMIT border on that pane. " +
+    "Complete toast = all borders cleared. Incomplete after 5m = eyeball stuck panes. Nothing for you to run.";
+export function notifyConnectivityStatus(workspace, topic, sessionAbout, check, phase = "starting") {
+    runInboxDesktopNotifySync(workspace, { topic, phase, sessionAbout, check });
+}
+/** @deprecated Use resume wave notify with carrier meta instead. */
+export function notifyProxyCarrierIp(workspace, fromIp, toIp, reason) {
+    const sessionAbout = fromIp && fromIp !== toIp
+        ? `Proxy ${reason}: carrier ${fromIp} -> ${toIp}.`
+        : `Proxy ${reason}: carrier ${toIp}.`;
+    runInboxDesktopNotifySync(workspace, {
+        phase: "sent",
+        topic: "Proxy rotate",
+        sessionAbout,
+        check: "Waiting for OC panes to confirm resume...",
+    });
+}
+export function resumeOneOpenCodePane(paneId, registry) {
+    const snap = capturePaneSnapshot(paneId);
+    if (!snap)
+        return { ok: false };
+    const prov = registry.detect(snap);
+    if (prov?.id !== "opencode")
+        return { ok: false };
+    const cmd = formatOpenCodeResumeCommand(snap);
+    if (!cmd)
+        return { ok: false, reason: "no-ses-id" };
+    const plan = prov.injectPlan(snap);
+    let ok = false;
+    withPaneInputEnabled(paneId, () => {
+        injectToPane(paneId, cmd, plan, prov.id, snap.captureTail, snap.captureTailAnsi);
+        ok = true;
+    });
+    return ok ? { ok: true, cmd } : { ok: false, reason: "inject-failed" };
+}
+export function resumeAllOpenCodePanes(paneIds, registry, log) {
+    let sent = 0;
+    let total = 0;
+    const sentPaneIds = [];
+    for (const paneId of paneIds) {
+        const snap = capturePaneSnapshot(paneId);
+        if (!snap)
+            continue;
+        if (registry.detect(snap)?.id !== "opencode")
+            continue;
+        total += 1;
+        const r = resumeOneOpenCodePane(paneId, registry);
+        if (r.ok) {
+            sent += 1;
+            sentPaneIds.push(paneId);
+            log?.(`OC-RESUME ${paneId} ${r.cmd ?? "resume"}`);
+        }
+    }
+    return { sent, total, sentPaneIds };
+}
+export function notifyResumeWave(workspace, reason, sent, total, meta) {
+    const ipLine = meta?.toIp && meta.fromIp !== meta.toIp
+        ? `Carrier ${meta.fromIp ?? "?"} -> ${meta.toIp}. `
+        : meta?.toIp
+            ? `Carrier ${meta.toIp}. `
+            : "";
+    if (sent > 0) {
+        runInboxDesktopNotifySync(workspace, {
+            phase: "sent",
+            topic: "OC resume",
+            sessionAbout: `${ipLine}Resume pasted to ${sent}/${total} OpenCode panes (${reason}).`,
+            check: RESUME_ACK_HOWTO,
+        });
+        return;
+    }
+    if (total > 0) {
+        runInboxDesktopNotifySync(workspace, {
+            phase: "incomplete",
+            topic: "OC resume",
+            sessionAbout: `${ipLine}Found ${total} OC panes but resume was not delivered (${reason}).`,
+            check: "Check OC panes manually — may be busy or keyboard-locked.",
+        });
+    }
+}
+//# sourceMappingURL=oc-resume.js.map

package/dist/connectivity/oc-resume.js.map

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

package/dist/inbox/delivery-hold.d.ts

@@ -0,0 +1,11 @@
+import type { MeshOrchestratorCtx } from "../orchestrator/mesh-orchestrator.js";
+export interface DeliveryHoldResult {
+    hold: boolean;
+    reason?: string;
+}
+/** Gate peer/inbox inject: OC limit, proxy-down (OC only), context-not-ready (post-replace). */
+export declare function deliveryHoldForPane(ctx: MeshOrchestratorCtx, targetPane: string, opts?: {
+    isColdStart?: boolean;
+    allowCheckbackComms?: boolean;
+}): DeliveryHoldResult;
+//# sourceMappingURL=delivery-hold.d.ts.map

package/dist/inbox/delivery-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-hold.d.ts","sourceRoot":"","sources":["../../src/inbox/delivery-hold.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,gGAAgG;AAChG,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,mBAAmB,EACxB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAClE,kBAAkB,CAwBpB"}

package/dist/inbox/delivery-hold.js

@@ -0,0 +1,34 @@
+import { capturePaneSnapshot, hasDeliveredColdStartPeer, hasPendingColdStartPeer, isPaneContextReady, } from "@seat-mesh/tmux";
+function isOpenCodePane(registry, paneId) {
+    const snap = capturePaneSnapshot(paneId);
+    if (!snap)
+        return false;
+    return registry.detect(snap)?.id === "opencode";
+}
+/** Gate peer/inbox inject: OC limit, proxy-down (OC only), context-not-ready (post-replace). */
+export function deliveryHoldForPane(ctx, targetPane, opts = {}) {
+    if (ctx.ocLimitedPaneIds.has(targetPane)) {
+        return { hold: true, reason: "held:limit" };
+    }
+    if (ctx.proxyDownActive && isOpenCodePane(ctx.registry, targetPane)) {
+        return { hold: true, reason: "held:proxy-down" };
+    }
+    if (!opts.isColdStart) {
+        const pending = hasPendingColdStartPeer(ctx.loaded, targetPane);
+        const ready = isPaneContextReady(ctx.loaded, targetPane);
+        if (!ready && pending) {
+            if (opts.allowCheckbackComms &&
+                hasDeliveredColdStartPeer(ctx.loaded, targetPane)) {
+                // Duplicate FRESH SUMMON queued — Check:/room verify must not wedge forever.
+            }
+            else {
+                return { hold: true, reason: "held:context-pending" };
+            }
+        }
+        else if (!ready) {
+            return { hold: true, reason: "held:context-pending" };
+        }
+    }
+    return { hold: false };
+}
+//# sourceMappingURL=delivery-hold.js.map

package/dist/inbox/delivery-hold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-hold.js","sourceRoot":"","sources":["../../src/inbox/delivery-hold.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AASzB,SAAS,cAAc,CAAC,QAA0B,EAAE,MAAc;IAChE,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,UAAU,CAAC;AAClD,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,mBAAmB,CACjC,GAAwB,EACxB,UAAkB,EAClB,OAAiE,EAAE;IAEnE,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,GAAG,CAAC,eAAe,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,uBAAuB,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC;YACtB,IACE,IAAI,CAAC,mBAAmB;gBACxB,yBAAyB,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACjD,CAAC;gBACD,6EAA6E;YAC/E,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/inbox/delivery-hold.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=delivery-hold.test.d.ts.map

package/dist/inbox/delivery-hold.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-hold.test.d.ts","sourceRoot":"","sources":["../../src/inbox/delivery-hold.test.ts"],"names":[],"mappings":""}

package/dist/inbox/delivery-hold.test.js

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { deliveryHoldForPane } from "./delivery-hold.js";
+function stubCtx(workspace, opts = {}) {
+    return {
+        loaded: {
+            workspace,
+            profileDir: workspace,
+            profilePath: "",
+            profile: {
+                seats: { root: "seats" },
+                data: { root: "runtime" },
+                state: { meshAgentsJson: "mesh-agents.json", agentsJson: "agents.json" },
+                roles: { dir: "roles" },
+            },
+            workspaceId: "test01",
+            sessionName: "mesh-test01",
+        },
+        registry: { detect: () => null },
+        store: {},
+        session: "mesh",
+        baseWindow: "base",
+        workersWindow: "workers",
+        minisWindow: "minis",
+        log: () => { },
+        ocLimitedPaneIds: opts.ocLimited ?? new Set(),
+        proxyDownActive: opts.proxyDown ?? false,
+    };
+}
+describe("deliveryHoldForPane", () => {
+    it("holds non-cold-start when OC limit active on pane", () => {
+        const ctx = stubCtx("/tmp/x", { ocLimited: new Set(["%1"]) });
+        expect(deliveryHoldForPane(ctx, "%1", { isColdStart: false }).reason).toBe("held:limit");
+        expect(deliveryHoldForPane(ctx, "%1", { isColdStart: true }).hold).toBe(true);
+    });
+    it("passes when pane not limited and no context gate", () => {
+        const ctx = stubCtx("/tmp/x");
+        expect(deliveryHoldForPane(ctx, "%9", { isColdStart: false }).hold).toBe(false);
+    });
+});
+//# sourceMappingURL=delivery-hold.test.js.map

package/dist/inbox/delivery-hold.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-hold.test.js","sourceRoot":"","sources":["../../src/inbox/delivery-hold.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,SAAS,OAAO,CACd,SAAiB,EACjB,OAAyD,EAAE;IAE3D,OAAO;QACL,MAAM,EAAE;YACN,SAAS;YACT,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,EAAE;YACf,OAAO,EAAE;gBACP,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;gBACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBACzB,KAAK,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE;gBACxE,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;aACI;YAC7B,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,aAAa;SACH;QACzB,QAAQ,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAiC;QAC/D,KAAK,EAAE,EAAkC;QACzC,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,MAAM;QAClB,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,OAAO;QACpB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,gBAAgB,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,GAAG,EAAE;QAC7C,eAAe,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK;KACzC,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzF,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/inbox/inbox-overload.d.ts

@@ -0,0 +1,19 @@
+import type { QueueStore } from "../store/create-queue-store.js";
+/** Pending inject pressure (peer queue + armed checkbacks on this pane). */
+export declare const INBOX_OVERLOAD_THRESHOLD = 25;
+export declare const INBOX_OVERLOAD_COOLDOWN_MS: number;
+export declare function resetInboxOverloadStateForTests(): void;
+export declare function countInboxTriggersForPane(store: QueueStore, paneId: string): number;
+export declare function overloadCooldownRemainingMs(paneId: string, nowMs?: number): number;
+export declare function overloadWarnMessage(count: number): string;
+export interface InboxOverloadEval {
+    hold: boolean;
+    reason?: string;
+    count: number;
+    /** Deliver once when entering cooldown (use force inject). */
+    warn?: boolean;
+    warnMessage?: string;
+}
+/** Rising edge at >= threshold starts 10m cooldown; all injects held until it expires. */
+export declare function evaluateInboxOverload(store: QueueStore, paneId: string, nowMs?: number): InboxOverloadEval;
+//# sourceMappingURL=inbox-overload.d.ts.map

package/dist/inbox/inbox-overload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-overload.d.ts","sourceRoot":"","sources":["../../src/inbox/inbox-overload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAGjE,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,0BAA0B,QAAiB,CAAC;AAIzD,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,MAAM,CAGtF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,SAAa,GACjB,iBAAiB,CAuBnB"}