Add quiescent canonical recovery sessions without rewriting requests

This commit is contained in:
2026-11-08 01:41:23 +08:00
parent 0c7fae6e32
commit a0417b4811
11 changed files with 276 additions and 20 deletions
+17 -4
View File
@@ -34,6 +34,7 @@ export function createScheduler(options: SchedulerOptions) {
const waiters = new Map<Id, Set<Id>>(), dependents = new Map<Id, Set<Id>>(), indexed = new Set<Id>();
const retry = createMinHeap<{ id: Id; dueAt: number; sequence: number; token: number }>((a, b) => a.dueAt - b.dueAt || a.sequence - b.sequence);
const tokens = new Map<Id, number>(), active = new Map<Id, { controller: AbortController; promise: Promise<void>; kind: FrozenRequest['kind'] }>();
const holds = new Set<symbol>();
const laneWaiters = new Map<NonNullable<FrozenRequest['kind']>, Set<Id>>(), deferredRetries = new Map<Id, { id: Id; dueAt: number; sequence: number; token: number }>();
let timer: unknown, pumpTimer: unknown, enqueueSequence = 0, stopped = true, closed = false, pumping = false;
const delay = (attempt: number) => Math.max(1, options.retryDelay?.(attempt) ?? Math.min(30_000, 500 * 2 ** Math.min(attempt, 6)));
@@ -84,11 +85,11 @@ export function createScheduler(options: SchedulerOptions) {
function armTimer() {
if (timer !== undefined) { clock.clearTimer(timer); timer = undefined; }
while (retry.peek() && !validRetry(retry.peek()!)) retry.pop();
if (stopped || active.size >= concurrency || !retry.peek()) return;
if (stopped || holds.size || active.size >= concurrency || !retry.peek()) return;
timer = clock.setTimer(() => { timer = undefined; pump(); }, Math.max(0, retry.peek()!.dueAt - clock.now()));
}
function launch(id: Id, action: 'submit' | 'query') {
if (active.has(id) || stopped) return;
if (active.has(id) || stopped || holds.size) return;
const controller = new AbortController();
// Start in a microtask so the handle exists before any synchronous adapter error.
const promise = Promise.resolve().then(async () => {
@@ -126,7 +127,7 @@ export function createScheduler(options: SchedulerOptions) {
active.set(id, { controller, promise, kind: options.getLedger().requests.get(id)?.kind });
}
function pump() {
if (stopped || pumping) return;
if (stopped || holds.size || pumping) return;
pumping = true;
try {
while (active.size < concurrency && retry.peek() && retry.peek()!.dueAt <= clock.now()) {
@@ -163,7 +164,7 @@ export function createScheduler(options: SchedulerOptions) {
}
} finally {
pumping = false; armTimer();
if (!stopped && ready.size && active.size < concurrency && pumpTimer === undefined) pumpTimer = clock.setTimer(() => { pumpTimer = undefined; pump(); }, 0);
if (!stopped && !holds.size && ready.size && active.size < concurrency && pumpTimer === undefined) pumpTimer = clock.setTimer(() => { pumpTimer = undefined; pump(); }, 0);
}
}
return Object.freeze({
@@ -182,6 +183,18 @@ export function createScheduler(options: SchedulerOptions) {
pump();
},
notify(operationIds: readonly Id[]) { for (const id of operationIds) index(id); pump(); },
/** Acquire synchronously, then settle(): already admitted work completes with its original identity. */
hold() {
if (closed) throw fault('scheduler_closed');
const token = Symbol(); holds.add(token);
if (timer !== undefined) clock.clearTimer(timer);
if (pumpTimer !== undefined) clock.clearTimer(pumpTimer);
timer = pumpTimer = undefined;
return () => {
if (!holds.delete(token) || holds.size || stopped) return;
pump();
};
},
/** Explicit retry after storage/auth/permission recovery; preserves frozen bodies. */
async resume() {
if (stopped) return;