@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5682

package/dist/workflows/run/run-finish.js

@@ -0,0 +1,256 @@
+import { logPrefix } from '../../home/display.js';
+import { WAIT_KINDS } from './wait-kinds.js';
+import { transitionTurnBoundary } from './turn-boundary.js';
+import { cezarDoneRequestSchema } from '../../contract/index.js';
+import { doneErrorMessage } from '../../ci-wait/errors.js';
+import { openCompletionRequests, recordRequestRefusal } from '../completion-policy.js';
+import { openWaitList, openWaits } from '../waits.js';
+import { toolSessionRefusal } from './cezar-tools.js';
+import { clearIdleTimer, clearAutosaveTimer } from './input-timers.js';
+import { hasPendingHumanAsk } from './pending-ask-facts.js';
+import * as completionGateReads from './completion-gate.js';
+export class RunFinish {
+    context;
+    completionGateHost;
+    runSettlement;
+    turnSettler;
+    turnNudges;
+    line;
+    host;
+    constructor(context, completionGateHost, runSettlement, turnSettler, turnNudges, line, host) {
+        this.context = context;
+        this.completionGateHost = completionGateHost;
+        this.runSettlement = runSettlement;
+        this.turnSettler = turnSettler;
+        this.turnNudges = turnNudges;
+        this.line = line;
+        this.host = host;
+    }
+    /**
+     * `cezar_done` (hearsay-tools/cezarion#1234). Accepted, the run finishes at this turn's end
+     * through the done branch, which cancels every open wait; in a workflow step that is not the
+     * last, that branch completes the step and the next one starts (hearsay-tools/cezarion#1620), and
+     * the answer says which. Refused, the answer says what to do
+     * first. The gate is the completion gate, in order: the session, a root finish, the user's
+     * question, then for a root its workers' questions, live workers and uncollected results. The turn end re-checks it (`deferParentCompletion`).
+     */
+    acceptDone(runId, generation, request, signal) {
+        const parsed = cezarDoneRequestSchema.parse(request);
+        const state = this.completionGateHost.active.get(runId);
+        const open_waits = openWaitList(this.context.store.getRun(runId)?.waits ?? []);
+        const refuse = (code, message, workers = []) => {
+            // Fixed codes only, as for wait registration.
+            console.warn(`${logPrefix()} cezar_done refused: ${code}`);
+            return { ok: false, code, message, ...(workers.length ? { workers: workers.slice(0, 64) } : {}), open_waits };
+        };
+        const session = toolSessionRefusal(this.context.store.getRun(runId), state, this.completionGateHost.active.get(runId), generation, signal, this.context.disposed());
+        const run = this.context.store.getRun(runId);
+        if (session || !run || !state?.liveSession.session)
+            return refuse(session ?? 'run_missing', doneErrorMessage(session ?? 'run_missing'));
+        if (this.host.executionBlockedByRootFinish(run))
+            return refuse('root_finish_pending', doneErrorMessage('root_finish_pending'));
+        // The answer a continuation opened with is not a pending question while its turn runs.
+        // A cezar_ask this turn registered is pending too, before its turn end shows it
+        // (hearsay-tools/cezarion#2442).
+        if (state.boundary.pendingHumanAsk || this.host.hasUnansweredHumanAsk(runId) || askedThisTurn(run))
+            return refuse('human_question_pending', doneErrorMessage('human_question_pending'));
+        const refusal = this.completionRefusal(runId);
+        if (refusal) {
+            recordRequestRefusal(state, refusal, true);
+            return refuse(refusal.code, refusal.message, refusal.workers);
+        }
+        transitionTurnBoundary(state, { kind: 'done-request', session: state.liveSession.session, ...(parsed.summary === undefined ? {} : { summary: parsed.summary }) });
+        const next = state.boundary.nextStep?.session === state.liveSession.session ? state.boundary.nextStep.label : undefined;
+        return { ok: true, finishes: 'at_turn_end', ...(next === undefined ? { completes: 'task' } : { completes: 'step', next_step: next }), open_waits };
+    }
+    completionRefusal(runId) { return completionGateReads.completionRefusal(this.context, this.completionGateHost, runId); }
+    /** The read-only verdict and explicit Finish share this decision. Operational failures
+     * (for example a failed durable write) are still handled at execution time. */
+    finishDecision(runId) { return completionGateReads.finishDecision(this.context, this.completionGateHost, runId); }
+    deferParentCompletion(runId) {
+        const gate = this.completionGate(runId);
+        if (gate === 'accept')
+            return false;
+        const state = this.completionGateHost.active.get(runId);
+        // Mid-turn, the live turn end takes its done to the gate itself, behind owed input and waits.
+        if (typeof gate === 'object' && state?.liveSession.session && state.boundary.atTurnBoundary === state.liveSession.session) {
+            this.turnSettler.settleTurn(runId, state, 'gate', this.turnSettler.boundaryTurn(runId, state, state.liveSession.session, true), gate);
+        }
+        return true;
+    }
+    /** The completion gate for a root's done: `accept`; a refusal a live session takes as its turn
+     *  end's (`settleTurn`); or `held` when the gate settled it itself: a stopped root, a refusal
+     *  queued for a closed session, or a pending human question that parks for the user. */
+    completionGate(runId) {
+        let parent = this.context.store.getRun(runId);
+        if (parent?.delegation?.role !== 'root')
+            return 'accept';
+        // A late success callback has no authority to reopen a stopped/reviewing root.
+        if (['done', 'review', 'failed', 'cancelled'].includes(parent.status))
+            return 'held';
+        const state = this.completionGateHost.active.get(runId);
+        const pendingAsk = this.familyQuestionPending(runId, parent.delegation.receipts.length, state);
+        if (!pendingAsk && this.completionMayPass(runId))
+            return 'accept';
+        if (parent.delegation.finishRequestedAt) {
+            // Legacy accepted Finish cannot strand the new gate behind an execution ban.
+            const { finishRequestedAt: _intent, ...delegation } = parent.delegation;
+            this.context.store.commitDelegation([{ id: runId, delegation }]);
+            parent = { ...parent, delegation };
+        }
+        if (parent.delegation?.role !== 'root')
+            return 'accept';
+        const refusal = pendingAsk ? undefined : this.completionRefusal(runId);
+        if (refusal && state?.liveSession.session?.open)
+            return refusal;
+        // A legacy accepted Finish takes the same path as a done: its refusal reopens the session.
+        if (refusal) {
+            this.turnNudges.queueCompletionRefusal(runId, refusal);
+            return 'held';
+        }
+        // Every blocker but the pending human question is a refusal: the question parks for the user.
+        this.context.store.appendEvent(runId, { type: 'note', tone: 'warning', message: 'Completion blocked: answer the pending human question.' });
+        this.host.move(runId, 'park', { finishedAt: undefined }, { stepId: state?.liveSession.currentStepId });
+        this.context.store.flush();
+        if (state) {
+            clearIdleTimer(state);
+            this.line.leavePool(runId);
+            this.line.park(runId);
+            this.line.releaseSlot();
+        }
+        return 'held';
+    }
+    /** Only a root with workers keeps its pending question through completion
+     *  (hearsay-tools/cezarion#2784): every task is a root once provisioned. */
+    familyQuestionPending(runId, receipts, state) {
+        if (receipts === 0)
+            return false;
+        return hasPendingHumanAsk(runId, id => this.completionGateHost.pendingHumanAskSeq(id)) || !!state?.boundary.pendingHumanAsk;
+    }
+    /** Human Finish keeps the worker guarantees and bypasses request obligations only. */
+    completionMayPass(runId) { return completionGateReads.completionMayPass(this.context, this.completionGateHost, runId); }
+    /** Finish can arrive during continuation preflight. Retain its accepted
+     * payload in the ordinary queue, releasing the slot without opening a session. */
+    holdContinuationForRootFinish(runId, continuation, state) {
+        const run = this.context.store.getRun(runId);
+        if (!run || !this.host.executionBlockedByRootFinish(run))
+            return false;
+        this.line.enqueueContinuation(runId, continuation, true);
+        this.context.store.updateStep(runId, continuation.stepId, { status: 'pending' });
+        this.host.move(runId, 'requeue');
+        if (state)
+            clearAutosaveTimer(state);
+        this.line.unmarkStarting(runId);
+        this.host.dropActive(runId);
+        return true;
+    }
+    async settleRequestedRootFinish(runId) {
+        return this.context.work.track('settleRequestedRootFinish', this.settleRequestedRootFinishWork(runId));
+    }
+    async settleRequestedRootFinishWork(runId) {
+        try {
+            const status = this.context.store.getRun(runId)?.status;
+            if (status === 'review') {
+                this.finish(runId);
+                return;
+            }
+            if (status === 'running')
+                this.host.move(runId, 'park');
+            this.host.reconcileWorkerWaits(runId);
+            await this.runSettlement.settleSuccess(runId, true);
+        }
+        catch {
+            console.warn(`${logPrefix()} parent finish checkpoint failed; intent retained for retry`);
+        }
+    }
+    /** Close the open session gracefully — the run then completes as `done`
+     *  (or rests at `review` when the worktree holds changes, spec 009).
+     *  On a run already resting at `review` (no session — the engine loop is
+     *  over), "Finish" is the third review exit: accept the changes without a
+     *  PR and flip straight to `done`. */
+    finish(runId) {
+        const decision = this.finishDecision(runId);
+        if ('reason' in decision) {
+            if (decision.warn)
+                this.context.store.appendEvent(runId, { type: 'note', tone: 'warning', message: decision.reason });
+            return false;
+        }
+        const state = this.completionGateHost.active.get(runId);
+        if (decision.action === 'session' && state?.liveSession.session) {
+            try {
+                this.host.waitEngine.cancelAll(runId);
+                this.acceptRootRequestFinish(runId);
+            }
+            catch {
+                return false;
+            }
+            this.closeQuestionOnFinish(runId);
+            state.liveSession.requestFinish();
+            clearIdleTimer(state);
+            this.context.store.appendEvent(runId, { type: 'lifecycle', message: 'session closed by user' });
+            state.liveSession.session.end();
+            return true;
+        }
+        const run = this.context.store.getRun(runId);
+        if (decision.action === 'root') {
+            try {
+                this.context.store.commitRootFinishIntent(runId);
+                this.host.reconcileWorkerWaits(runId);
+            }
+            catch {
+                return false;
+            }
+            // A root without workers may Finish with a question pending (hearsay-tools/cezarion#2784):
+            // close it first, so the completion gate does not park the task on it again.
+            this.closeQuestionOnFinish(runId);
+            void this.settleRequestedRootFinish(runId);
+            return true;
+        }
+        if (decision.action === 'waiting' && run) {
+            this.closeQuestionOnFinish(runId);
+            const finishedAt = new Date().toISOString();
+            for (const step of run.steps) {
+                if (step.status === 'waiting' || step.status === 'running') {
+                    this.context.store.updateStep(runId, step.id, { status: 'done', finishedAt });
+                }
+            }
+            void this.runSettlement.settleSuccess(runId);
+            return true;
+        }
+        if (decision.action === 'review') {
+            try {
+                this.acceptRootRequestFinish(runId);
+            }
+            catch {
+                return false;
+            }
+            this.closeQuestionOnFinish(runId);
+            this.host.move(runId, 'accept-review');
+            this.context.store.appendEvent(runId, { type: 'lifecycle', message: 'review accepted — finished without a PR' });
+            return true;
+        }
+        return false;
+    }
+    /** Persist the human's authority before settling obligations or closing a live session. */
+    acceptRootRequestFinish(runId) {
+        const run = this.context.store.getRun(runId);
+        if (run?.delegation?.role !== 'root' || !openCompletionRequests(this.context.store, runId).sent.length)
+            return;
+        this.context.store.commitDelegation([{ id: runId, delegation: { ...run.delegation, finishRequestedAt: new Date().toISOString() } }]);
+        this.host.reconcileWorkerWaits(runId);
+    }
+    /** Finish ends the task, so an unanswered question is closed rather than left answerable on a
+     * finished run (hearsay-tools/cezarion#1260). A root with workers never gets here with one pending:
+     * its Finish is refused until the question is answered. Stop keeps the question, which a human may still
+     * answer to reopen the run (open-mercato/cezar#505). */
+    closeQuestionOnFinish(runId) {
+        const askSeq = this.completionGateHost.pendingHumanAskSeq(runId);
+        if (askSeq !== undefined)
+            this.context.store.appendEvent(runId, { type: 'human-ask-closed', askSeq, reason: 'finish' });
+    }
+}
+/** An agent question registered in this turn: open, and not yet shown (no `askSeq`). */
+function askedThisTurn(run) {
+    return WAIT_KINDS.human.select(openWaits(run)).some(wait => wait.source !== 'cezar' && wait.askSeq === undefined);
+}
+//# sourceMappingURL=run-finish.js.map

package/dist/workflows/run/run-finish.js.map

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

package/dist/workflows/run/run-guards.d.ts

@@ -0,0 +1,15 @@
+import type { ActiveRun } from '../active-run.ts';
+import type { RunRecord, RunStore } from '../../runs/store.ts';
+export declare function rootFinishRequested(store: Pick<RunStore, 'getRun'>, runId: string): boolean;
+export declare function executionBlockedByRootFinish(store: Pick<RunStore, 'getRun'>, run: RunRecord): boolean;
+/** Irreversible history removal is an execution tombstone, including for legacy children. */
+export declare function historyDeletionPending(store: Pick<RunStore, 'getRun'>, runId: string): boolean;
+export declare function workerExecutionStopped(store: Pick<RunStore, 'getRun'>, runId: string, stopped: (id: string) => boolean): boolean;
+export declare function canProceedWithRun(run: RunRecord | undefined, workerExecutionStopped: () => boolean, executionBlockedByRootFinish: (run: RunRecord) => boolean): run is RunRecord;
+/** The delegation family a run belongs to, by its root's id: a worker's parent, else itself. */
+export declare function familyOf(run: RunRecord): string;
+export declare function isDisposedDelegatedRun(store: Pick<RunStore, 'getRun'>, disposed: () => boolean, runId: string): boolean;
+/** Shutdown is not completion. Explicit terminal controls retain their precedence. */
+export declare function preserveRunAfterDisposal(store: Pick<RunStore, 'getRun'>, disposed: () => boolean, runId: string, state: ActiveRun): boolean;
+/** Only an original workflow that has never executed may return to its queue. */
+export declare function isUntouchedCancelledRun(run: RunRecord): boolean;

package/dist/workflows/run/run-guards.js

@@ -0,0 +1,39 @@
+export function rootFinishRequested(store, runId) {
+    const delegation = store.getRun(runId)?.delegation;
+    return delegation?.role === 'root' && !!delegation.finishRequestedAt;
+}
+export function executionBlockedByRootFinish(store, run) {
+    return rootFinishRequested(store, run.delegation?.role === 'worker' ? run.delegation.parentRunId : run.id);
+}
+/** Irreversible history removal is an execution tombstone, including for legacy children. */
+export function historyDeletionPending(store, runId) {
+    const run = store.getRun(runId);
+    const parent = run?.delegation?.role === 'worker' ? store.getRun(run.delegation.parentRunId) : run;
+    return parent?.delegation?.role === 'root' && parent.delegation.historyDeletion === 'pending';
+}
+export function workerExecutionStopped(store, runId, stopped) {
+    const run = store.getRun(runId);
+    return historyDeletionPending(store, runId) || run?.delegation?.role === 'invalid' || (run?.delegation?.role === 'worker' &&
+        (!!run.delegation.destroy || stopped(runId)));
+}
+export function canProceedWithRun(run, workerExecutionStopped, executionBlockedByRootFinish) {
+    return !(!run || run.stopping || workerExecutionStopped() || executionBlockedByRootFinish(run));
+}
+/** The delegation family a run belongs to, by its root's id: a worker's parent, else itself. */
+export function familyOf(run) {
+    return run.delegation?.role === 'worker' ? run.delegation.parentRunId : run.id;
+}
+export function isDisposedDelegatedRun(store, disposed, runId) {
+    const role = store.getRun(runId)?.delegation?.role;
+    return disposed() && (role === 'root' || role === 'worker' || !!store.getRun(runId)?.waits?.length);
+}
+/** Shutdown is not completion. Explicit terminal controls retain their precedence. */
+export function preserveRunAfterDisposal(store, disposed, runId, state) {
+    return isDisposedDelegatedRun(store, disposed, runId) && !state.liveSession.cancelled && !state.liveSession.finishRequested;
+}
+/** Only an original workflow that has never executed may return to its queue. */
+export function isUntouchedCancelledRun(run) {
+    return run.status === 'cancelled' && !run.startedAt && !!run.workflowDef &&
+        run.steps.every(step => step.status === 'pending' && !step.startedAt && !step.sessionId);
+}
+//# sourceMappingURL=run-guards.js.map

package/dist/workflows/run/run-guards.js.map

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

package/dist/workflows/run/run-line.d.ts

@@ -0,0 +1,187 @@
+import type { RunnerId } from '../../core/agent-runner.ts';
+import type { RunRecord } from '../../runs/store.ts';
+import type { AccountHolds } from '../../workspace/semaphore.ts';
+import type { RunModuleContext } from './types.ts';
+import type { WorkflowDef } from '../types.ts';
+import type { PendingContinuation, StartRunInput } from './types.ts';
+export type PendingJob = {
+    workflow: WorkflowDef;
+    input: StartRunInput;
+    startAt?: number | undefined;
+};
+interface RunLineHost {
+    activeSize(): number;
+    activeHas(id: string): boolean;
+    withExecutionAccount(run: RunRecord): RunRecord;
+    maintenance(id: string): boolean;
+    admitted(id: string): boolean | undefined;
+    workerExecutionStopped(id: string): boolean;
+    recovering(): boolean | undefined;
+    recoveringRun(run: RunRecord): boolean;
+    reconcileAutoResumes(): void;
+    cancel(id: string): boolean;
+    move(id: string, patch: {
+        error: string;
+    }): unknown;
+    beginWorkerExecution(id: string): void;
+    admissionError(error: unknown, fallback: string): string;
+    admitQueuedWaitWake(id: string): 'none' | 'handled' | 'deferred';
+    launchQueuedRun(id: string, job: PendingJob | undefined, continuation: PendingContinuation | undefined): void;
+    reviveQueuedRun(run: RunRecord, reason: string): Promise<void>;
+    pump(): Promise<void>;
+    busySlots(): number;
+}
+/** The oldest eligible wake, with account and record reads kept lazy in line order. */
+export declare function oldestEligibleWakeAt(entries: Iterable<string>, reads: {
+    wakeJoinedAt(id: string): number | undefined;
+    accountHolds(): AccountHolds;
+    getRun(id: string): RunRecord | undefined;
+    canLeaveLine(id: string, holds: AccountHolds, fallback: RunnerId): boolean;
+}, configuredDefaultRunner: RunnerId | undefined): number | null;
+/** Owns the scheduler's line and its in-memory admission state. */
+export declare class RunLine {
+    private readonly context;
+    private readonly host;
+    constructor(context?: RunModuleContext, host?: RunLineHost);
+    /** The configured default runner as `pump()` last read it, so the sync `oldestWakeAt()` resolves
+     *  a runnerless record's account the same way (hearsay-tools/cezarion#1236). */
+    private configuredDefaultRunner;
+    private pumping;
+    /** The scheduler only needs repo presence. Cache the promise (including null) so every sweep
+     * doesn't spawn Git (hearsay-tools/cezarion#364); only `rediscoverRepo()` drops a null result.
+     * execute() still reads fresh branch/remote metadata for each run. */
+    private pumpRepoInfo?;
+    /** The cached probe found no usable repository: the one-task fallback applies. */
+    private repoMissing;
+    /** A pump that arrived while one was in flight — replayed by `pump()`'s own
+     *  loop so a slot freed mid-sweep is never a lost wakeup. */
+    private pumpAgain;
+    readonly queue: string[];
+    readonly pendingJobs: Map<string, PendingJob>;
+    /** Interrupted agent turns recovered after a process restart. Unlike an
+     *  explicit user Continue, these are bulk scheduler work and must re-enter
+     *  through `pump()` so both workspace and per-project caps are honored. */
+    readonly pendingContinuations: Map<string, PendingContinuation>;
+    readonly starting: Set<string>;
+    readonly waiting: Set<string>;
+    /** Durable monitoring subset. Only the configured number receives the waiting-slot exemption. */
+    readonly monitoring: Set<string>;
+    /** A run whose resolved waits wait for a wake (hearsay-tools/cezarion#1233). Separate from
+     *  human waiting: these resumes MUST reacquire scheduler capacity. Keyed by run id. */
+    readonly waitWakeQueuedAt: Map<string, number>;
+    readonly waitWakeAdmitted: Set<string>;
+    /** The watchdog ignores the usage hold for one pump sweep. */
+    private forceNextPump;
+    /** Forced starts keep bypassing the spawn-time gate until dropActive. */
+    private readonly forceStarted;
+    /** A monitoring-pool member's wake waiting in the line: it already holds its slot, so it needs
+     *  no regular one to leave (hearsay-tools/cezarion#1236). */
+    private poolWakeQueued;
+    /**
+     * Slots this manager holds against the workspace-wide cap. `waiting` runs
+     * don't hold a slot (#347): an idle claude process costs memory but no
+     * tokens, queued work progressing matters more, and the idle timeout already
+     * bounds how long a session can sit open. Because the exemption lives HERE —
+     * in the count, not in any acquire path — a message into a `waiting` run
+     * (sendMessage) resumes it immediately even when that momentarily exceeds
+     * `maxParallel`, including when other projects saturate the cap.
+     */
+    busySlots(): number;
+    /** Epoch ms of this manager's oldest queued run (the semaphore's fairness
+     *  key when a freed slot is broadcast), or null when nothing is queued.
+     *  `queue` is FIFO — `startRun` pushes and `recover()` re-queues by
+     *  `createdAt` — so the head is the oldest. */
+    oldestQueuedAt(): number | null;
+    /** When a queued entry joined the line as a wake of a run already in progress, or undefined for
+     *  a run that has not started (hearsay-tools/cezarion#1236, `nextLineEntry`). */
+    private wakeJoinedAt;
+    /** The oldest wake in this manager's line that an account hold does not keep there, or null:
+     *  the semaphore gives a freed slot to the project holding the oldest such wake before any
+     *  project's unstarted runs. A held wake is left out, or its project would take the slot and
+     *  start a new task ahead of another project's started run (hearsay-tools/cezarion#1236). */
+    oldestWakeAt(): number | null;
+    /** Can this queued entry leave the line now, capacity aside? No worktree cleanup, no
+     *  autosave cleanup, no pending root finish, no account hold, and not already admitted
+     *  elsewhere. `pump()` and `oldestWakeAt()` share it, so the workspace order and the project
+     *  order agree (hearsay-tools/cezarion#1236). */
+    private canLeaveLine;
+    /**
+     * A slot this manager held just came free. Pump the whole WORKSPACE, not
+     * just this manager: `maxParallel` is counted across every project, so the
+     * run that should take the slot is the workspace's oldest queued one — which
+     * usually sits in another project's queue. Pumping only `this` is what left
+     * a queued run in project B stuck at `queued` while project A's runs came
+     * and went. `release()` pumps this manager too, so it replaces the local
+     * `pump()` at every slot-freeing transition.
+     */
+    releaseSlot(): void;
+    /**
+     * Start queued runs while parallel slots are free. A run starts only under
+     * BOTH ceilings: the WORKSPACE `resources.maxParallel` (default 2, counted
+     * across every manager — spec 2026-07-20, step 2.5) AND this project's own
+     * per-project `maxParallel` when the registry sets one (spec 2026-07-22,
+     * inherits the workspace cap when unset). Legacy per-repo `maxParallel` keys
+     * are ignored. A non-git directory degrades to 1 sequential run in the repo
+     * root (spec 006 degradation rule), which is always the tighter bound.
+     */
+    pump(): Promise<void>;
+    private pumpWork;
+    /**
+     * Probe Git again when queued work waits only behind the one-task fallback, so a project opened
+     * before its first commit gets normal scheduling without a restart (hearsay-tools/cezarion#2257).
+     * Every other case spawns no Git: a found repository stays cached, as hearsay-tools/cezarion#364 needs.
+     */
+    rediscoverRepo(): void;
+    /** Checkpoint before dequeue, while worker cancellation can still find the queued entry. */
+    private checkpointQueuedWorker;
+    private launchQueuedRun;
+    /**
+     * Repair queued records missing executable state. Rescue an idle queue only when no running work
+     * or future appointment explains it; start through ordinary caps. Public for direct tests.
+     */
+    rescueStalledQueue(now?: number): Promise<void>;
+    private rescueStalledQueueWork;
+    entries(): readonly string[];
+    indexOf(id: string): number;
+    hasQueued(id: string): boolean;
+    hasStarting(id: string): boolean;
+    startingCount(): number;
+    parked(): ReadonlySet<string>;
+    isParked(id: string): boolean;
+    inPool(id: string): boolean;
+    poolSize(): number;
+    wakeAt(id: string): number | undefined;
+    hasWake(id: string): boolean;
+    isAdmitted(id: string): boolean;
+    admissions(): ReadonlySet<string>;
+    hasJob(id: string): boolean;
+    job(id: string): PendingJob | undefined;
+    hasContinuation(id: string): boolean;
+    continuation(id: string): PendingContinuation | undefined;
+    enqueueJob(id: string, job: PendingJob): void;
+    enqueueContinuation(id: string, continuation: PendingContinuation, onlyIfAbsent?: boolean): void;
+    enqueueWake(id: string, at: number, onlyIfAbsent?: boolean): void;
+    markWake(id: string, at: number): void;
+    removeWake(id: string, removeEntry?: boolean): boolean;
+    takeAt(index: number): string | undefined;
+    takePending(id: string): {
+        job: PendingJob | undefined;
+        continuation: PendingContinuation | undefined;
+    };
+    markStarting(id: string): void;
+    unmarkStarting(id: string): void;
+    park(id: string): void;
+    unpark(id: string): void;
+    joinPool(id: string): void;
+    leavePool(id: string): boolean;
+    admitWake(id: string): void;
+    retireAdmission(id: string): boolean;
+    forceNext(): void;
+    takeForced(): boolean;
+    markForced(id: string): void;
+    clearForced(id: string): void;
+    isForced(id: string): boolean;
+    forget(id: string): void;
+    dispose(): void;
+}
+export {};