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

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

@@ -0,0 +1,438 @@
+import { logPrefix } from '../../home/display.js';
+import { isUsageLimitHold } from '../../contract/index.js';
+import { atTaskHead } from './launch-read-resolver.js';
+import { getRepoInfo } from '../../server/git.js';
+import { nextLineEntry } from '../line-order.js';
+import { executionBlockedByRootFinish, historyDeletionPending } from './run-guards.js';
+/** Shared empty holds for the common "nothing is held" pump — avoids allocating per sweep. */
+const NO_HOLDS = { deadline: new Set(), inFlight: new Set() };
+/** The oldest eligible wake, with account and record reads kept lazy in line order. */
+export function oldestEligibleWakeAt(entries, reads, configuredDefaultRunner) {
+    let oldest = null;
+    let holds;
+    for (const id of entries) {
+        const at = reads.wakeJoinedAt(id);
+        if (at === undefined || (oldest !== null && at >= oldest))
+            continue;
+        holds ??= reads.accountHolds();
+        // The same blockers `pump()` applies, capacity aside: a wake that cannot leave for any of
+        // them must not win the slot for its project's unstarted work. A runnerless record runs on
+        // the configured default, which only `pump()` reads (async); until it has, such a wake is
+        // not advertised while anything is held.
+        const runnerless = holds.deadline.size + holds.inFlight.size > 0 && atTaskHead.runnerless(reads, id);
+        if (runnerless && configuredDefaultRunner === undefined)
+            continue;
+        if (!reads.canLeaveLine(id, holds, configuredDefaultRunner ?? 'claude'))
+            continue;
+        oldest = at;
+    }
+    return oldest;
+}
+/** Owns the scheduler's line and its in-memory admission state. */
+export class RunLine {
+    context;
+    host;
+    constructor(context, host) {
+        this.context = context;
+        this.host = host;
+    }
+    /** 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). */
+    configuredDefaultRunner;
+    pumping = false;
+    /** 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. */
+    pumpRepoInfo;
+    /** The cached probe found no usable repository: the one-task fallback applies. */
+    repoMissing = false;
+    /** 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. */
+    pumpAgain = false;
+    queue = [];
+    pendingJobs = new Map();
+    /** 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. */
+    pendingContinuations = new Map();
+    // Queue + `starting` set (spec 006, janitor's pump() pattern): `starting`
+    // covers the window between shifting a run off the queue and the run
+    // registering in `active`, so parallel-slot counting is never racy.
+    starting = new Set();
+    // Runs parked at `waiting` (open session, ball in the user's court). They
+    // don't consume a `maxParallel` slot (open-mercato/cezar#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. Invariant:
+    // `waiting ⊆ active` — always cleared together via dropActive().
+    waiting = new Set();
+    /** Durable monitoring subset. Only the configured number receives the waiting-slot exemption. */
+    monitoring = new Set();
+    /** 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. */
+    waitWakeQueuedAt = new Map();
+    waitWakeAdmitted = new Set();
+    /** The watchdog ignores the usage hold for one pump sweep. */
+    forceNextPump = false;
+    /** Forced starts keep bypassing the spawn-time gate until dropActive. */
+    forceStarted = new Set();
+    /** 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). */
+    poolWakeQueued(runId) {
+        return this.inPool(runId) && this.hasWake(runId) && this.host.activeHas(runId);
+    }
+    /**
+     * 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() {
+        // A CI or timer park keeps its slot (hearsay-tools/cezarion#1233): up to
+        // `maxMonitoringSessions` of them hold a monitoring slot instead of a regular one, and the
+        // rest keep their regular slot. Every other park holds none: a park whose top wait is human
+        // or workers (hearsay-tools/cezarion#1235) is in `waiting` and outside the pool.
+        const parkedWithoutSlot = [...this.parked()].filter(id => !this.inPool(id)).length;
+        const pool = Math.min(this.poolSize(), this.context.semaphore.maxMonitoringSessions());
+        return this.host.activeSize() + this.startingCount() - parkedWithoutSlot - pool;
+    }
+    /** 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() {
+        const head = this.entries()[0];
+        if (!head)
+            return null;
+        const wakeQueuedAt = this.wakeJoinedAt(head);
+        if (wakeQueuedAt !== undefined)
+            return wakeQueuedAt;
+        const createdAt = this.context.store.getRun(head)?.createdAt;
+        const ms = createdAt ? Date.parse(createdAt) : Number.NaN;
+        return Number.isNaN(ms) ? null : ms;
+    }
+    /** 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`). */
+    wakeJoinedAt(runId) {
+        const wake = this.wakeAt(runId) ?? this.continuation(runId)?.lineJoinedAt;
+        if (wake !== undefined || !this.hasJob(runId))
+            return wake;
+        // An owned worker is its family's work in progress, not a new task: it joins the wakes at its
+        // creation, so its parent's later wake (a worker wait that timed out, say) does not take the
+        // slot before the worker it waits on has run.
+        const run = this.context.store.getRun(runId);
+        if (run?.delegation?.role !== 'worker')
+            return undefined;
+        const created = Date.parse(run.createdAt);
+        return Number.isFinite(created) ? created : undefined;
+    }
+    /** 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() {
+        return oldestEligibleWakeAt(this.entries(), {
+            wakeJoinedAt: id => this.wakeJoinedAt(id),
+            accountHolds: () => this.context.semaphore.accountHolds(),
+            getRun: id => this.context.store.getRun(id),
+            canLeaveLine: (id, holds, fallback) => this.canLeaveLine(id, holds, fallback),
+        }, this.configuredDefaultRunner);
+    }
+    /** 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). */
+    canLeaveLine(id, holds, fallbackRunner) {
+        if (this.host.maintenance(id))
+            return false;
+        const queued = this.context.store.getRun(id);
+        if (!queued || historyDeletionPending(this.context.store, id))
+            return true;
+        if (this.host.admitted(id) && !this.host.activeHas(id))
+            return false;
+        if (executionBlockedByRootFinish(this.context.store, queued))
+            return false;
+        return !atTaskHead.heldFor(this.host.withExecutionAccount(queued), holds, fallbackRunner);
+    }
+    /**
+     * 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 this.context.semaphore.release();
+    }
+    /**
+     * 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.
+     */
+    async pump() {
+        return this.context.work.track('pump', this.pumpWork());
+    }
+    async pumpWork() {
+        // Any recovery, scoped or not: each ends with a pump of its own, so nothing waits for long.
+        if (this.context.disposed() || this.host.recovering())
+            return;
+        this.host.reconcileAutoResumes();
+        // A pump requested while one is in flight can't just be dropped: the
+        // in-flight pass may already have read capacity (it awaits `getRepoInfo`
+        // before the first check), so a slot freed in that window would be lost
+        // until the next unrelated event. Re-run the sweep instead.
+        if (this.pumping) {
+            this.pumpAgain = true;
+            return;
+        }
+        this.pumping = true;
+        try {
+            do {
+                this.pumpAgain = false;
+                const repo = await (this.pumpRepoInfo ??= getRepoInfo(this.context.repoRoot));
+                this.repoMissing = repo === null;
+                const maxParallel = this.context.semaphore.maxParallel();
+                // Per-project ceiling (spec 2026-07-22-per-project-concurrency): this
+                // project never runs more than its own configured `maxParallel`; absent
+                // an override it equals the workspace cap, so behavior is unchanged.
+                const projectMax = this.context.semaphore.projectMaxParallel(this.context.repoRoot);
+                // `waiting` runs don't hold a slot (#347) — see busySlots(). The check
+                // below is the only slot gate: resumes never pass through it. A run
+                // starts only under BOTH the workspace cap and this project's ceiling.
+                const capacity = () => this.context.semaphore.busy() < maxParallel &&
+                    this.host.busySlots() < projectMax &&
+                    (repo !== null || this.host.busySlots() < 1);
+                // The usage-limit hold (spec 2026-08-03-auto-resume-after-usage-limit).
+                //
+                // A limit closes an ACCOUNT, not a run — so starting the next queued task walks it into
+                // the same wall. Measured before this gate existed: eight tasks under `maxParallel: 2`
+                // all failed within 517 ms, each spawning a CLI (and, outside worktree-opt-out mode, a
+                // worktree and a branch) only to be marked `scheduled`. The cap was respected at every
+                // instant and was no brake at all, because a doomed run lives ~200 ms.
+                //
+                // So: while any run on an account is waiting out a limit, nothing new starts on THAT
+                // account. Other accounts (a second login, a different backend) keep running — the hold
+                // is keyed, not global. The set is derived from the durable records rather than tracked
+                // separately, which is what makes it survive a restart, expire on its own, and lift the
+                // instant a user cancels a resume.
+                // The watchdog's one-shot override — read and cleared here, so a forced sweep never
+                // leaks into the next ordinary one.
+                const forced = this.takeForced();
+                const holds = this.entries().length > 0 && !forced ? this.context.semaphore.accountHolds() : NO_HOLDS;
+                const anyHold = holds.deadline.size > 0 || holds.inFlight.size > 0;
+                // Only pay for the config read when something is actually held: a queued record may name
+                // no runner, and then the account it would use is the configured default.
+                const defaultRunner = anyHold ? atTaskHead.defaultRunner(await atTaskHead.config(this.context.repoRoot, this.context.home)) : undefined;
+                if (defaultRunner !== undefined)
+                    this.configuredDefaultRunner = defaultRunner;
+                while (this.entries().length > 0) {
+                    // Recovery may have begun while this pump awaited repository/config discovery.
+                    if (this.context.disposed() || this.host.recovering())
+                        return;
+                    // Wakes first, then unstarted runs, each FIFO among the entries that CAN start
+                    // (hearsay-tools/cezarion#1236); a held one keeps its place in the queue rather than
+                    // being dequeued and re-queued (which would churn its position and its record).
+                    const next = nextLineEntry(this.entries(), (id) => this.wakeJoinedAt(id), (id) => (capacity() || this.poolWakeQueued(id)) && this.canLeaveLine(id, anyHold ? holds : NO_HOLDS, defaultRunner ?? 'claude'));
+                    if (next === -1)
+                        break; // every queued run has a durable reason to remain held
+                    const candidate = this.entries()[next];
+                    if (this.host.workerExecutionStopped(candidate)) {
+                        this.host.cancel(candidate);
+                        continue;
+                    }
+                    if (!this.checkpointQueuedWorker(candidate, next))
+                        continue;
+                    const runId = this.takeAt(next);
+                    if (!runId)
+                        break;
+                    const wake = this.host.admitQueuedWaitWake(runId);
+                    if (wake === 'deferred')
+                        break;
+                    if (wake === 'handled')
+                        continue;
+                    this.launchQueuedRun(runId, forced);
+                }
+            } while (this.pumpAgain);
+        }
+        finally {
+            this.pumping = false;
+        }
+    }
+    /**
+     * 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() {
+        if (this.context.disposed() || !this.repoMissing || this.entries().length === 0)
+            return;
+        const busy = this.host.busySlots();
+        if (busy < 1 || busy >= this.context.semaphore.projectMaxParallel(this.context.repoRoot))
+            return;
+        if (this.context.semaphore.busy() >= this.context.semaphore.maxParallel())
+            return;
+        this.pumpRepoInfo = undefined;
+        this.repoMissing = false;
+        void this.host.pump();
+    }
+    /** Checkpoint before dequeue, while worker cancellation can still find the queued entry. */
+    checkpointQueuedWorker(candidate, next) {
+        if (!this.host.activeHas(candidate) && (this.hasJob(candidate) || this.hasContinuation(candidate))) {
+            try {
+                this.host.beginWorkerExecution(candidate);
+            }
+            catch (error) {
+                this.takeAt(next);
+                this.takePending(candidate);
+                this.host.move(candidate, { error: this.host.admissionError(error, 'worker execution checkpoint unavailable') });
+                return false;
+            }
+        }
+        return true;
+    }
+    launchQueuedRun(runId, forced) {
+        if (this.removeWake(runId, false))
+            this.admitWake(runId);
+        // A forced sweep has to reach the spawn: the gate inside `execute` asks the same
+        // question and would send this run straight back to the queue.
+        if (forced)
+            this.markForced(runId);
+        const { job, continuation } = this.takePending(runId);
+        if (!job && !continuation)
+            return;
+        this.markStarting(runId);
+        this.host.launchQueuedRun(runId, job, continuation);
+    }
+    /**
+     * 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.
+     */
+    async rescueStalledQueue(now = Date.now()) {
+        return this.context.work.track('rescueStalledQueue', this.rescueStalledQueueWork(now));
+    }
+    async rescueStalledQueueWork(now = Date.now()) {
+        if (this.context.disposed())
+            return;
+        // First, the worst shape: a record that says `queued` while the engine holds no job, no
+        // continuation and no queue entry for it. `pump()` cannot see such a run — it iterates the
+        // queue, and this one is not in it — so nothing will ever start it. Re-adopt it through the
+        // same path boot recovery uses.
+        for (const run of this.context.store.listRuns()) {
+            if (run.status !== 'queued' || this.host.recoveringRun(run))
+                continue;
+            if (this.host.activeHas(run.id) || this.hasStarting(run.id))
+                continue;
+            if (this.hasJob(run.id) || this.hasContinuation(run.id))
+                continue;
+            if (this.hasQueued(run.id))
+                continue;
+            console.warn(`${logPrefix()} queue watchdog: re-adopting queued run ${run.id} the engine had lost`);
+            await this.host.reviveQueuedRun(run, 'queue watchdog');
+        }
+        if (this.entries().length === 0)
+            return;
+        if (this.host.busySlots() > 0 || this.startingCount() > 0)
+            return;
+        if (this.context.semaphore.busy() > 0)
+            return;
+        // A future deadline is a real reason to sit still: that timer will fire and pump.
+        for (const run of this.context.store.listRuns()) {
+            if (!isUsageLimitHold(run))
+                continue;
+            const deadline = Date.parse(run.autoResumeAt);
+            if (Number.isFinite(deadline) && deadline > now)
+                return;
+        }
+        if (this.context.semaphore.accountHolds().inFlight.size === 0) {
+            // Not the hold, then — some other wakeup went missing. An ordinary pump is the whole fix,
+            // and it is idempotent, so this stays quiet.
+            void this.host.pump();
+            return;
+        }
+        console.warn(`${logPrefix()} queue watchdog: work is queued, nothing is running, and the usage-limit hold has no`
+            + ' deadline behind it — starting the next task anyway');
+        this.forceNext();
+        void this.host.pump();
+    }
+    entries() { return this.queue; }
+    indexOf(id) { return this.queue.indexOf(id); }
+    hasQueued(id) { return this.queue.includes(id); }
+    hasStarting(id) { return this.starting.has(id); }
+    startingCount() { return this.starting.size; }
+    parked() { return this.waiting; }
+    isParked(id) { return this.waiting.has(id); }
+    inPool(id) { return this.monitoring.has(id); }
+    poolSize() { return this.monitoring.size; }
+    wakeAt(id) { return this.waitWakeQueuedAt.get(id); }
+    hasWake(id) { return this.waitWakeQueuedAt.has(id); }
+    isAdmitted(id) { return this.waitWakeAdmitted.has(id); }
+    admissions() { return this.waitWakeAdmitted; }
+    hasJob(id) { return this.pendingJobs.has(id); }
+    job(id) { return this.pendingJobs.get(id); }
+    hasContinuation(id) { return this.pendingContinuations.has(id); }
+    continuation(id) { return this.pendingContinuations.get(id); }
+    enqueueJob(id, job) { this.pendingJobs.set(id, job); this.queue.push(id); }
+    enqueueContinuation(id, continuation, onlyIfAbsent = false) {
+        this.pendingContinuations.set(id, continuation);
+        if (!onlyIfAbsent || !this.queue.includes(id))
+            this.queue.push(id);
+    }
+    enqueueWake(id, at, onlyIfAbsent = true) {
+        this.waitWakeQueuedAt.set(id, at);
+        if (!onlyIfAbsent || !this.queue.includes(id))
+            this.queue.push(id);
+    }
+    markWake(id, at) { this.waitWakeQueuedAt.set(id, at); }
+    removeWake(id, removeEntry = true) {
+        const removed = this.waitWakeQueuedAt.delete(id);
+        if (removed && removeEntry) {
+            const index = this.queue.indexOf(id);
+            if (index >= 0)
+                this.queue.splice(index, 1);
+        }
+        return removed;
+    }
+    takeAt(index) { return this.queue.splice(index, 1)[0]; }
+    takePending(id) {
+        const job = this.pendingJobs.get(id);
+        const continuation = this.pendingContinuations.get(id);
+        this.pendingJobs.delete(id);
+        this.pendingContinuations.delete(id);
+        return { job, continuation };
+    }
+    markStarting(id) { this.starting.add(id); }
+    unmarkStarting(id) { this.starting.delete(id); }
+    park(id) { this.waiting.add(id); }
+    unpark(id) { this.waiting.delete(id); }
+    joinPool(id) { this.monitoring.add(id); }
+    leavePool(id) { return this.monitoring.delete(id); }
+    admitWake(id) { this.waitWakeAdmitted.add(id); }
+    retireAdmission(id) { return this.waitWakeAdmitted.delete(id); }
+    forceNext() { this.forceNextPump = true; }
+    takeForced() { const forced = this.forceNextPump; this.forceNextPump = false; return forced; }
+    markForced(id) { this.forceStarted.add(id); }
+    clearForced(id) { this.forceStarted.delete(id); }
+    isForced(id) { return this.forceStarted.has(id); }
+    forget(id) {
+        this.waiting.delete(id);
+        this.monitoring.delete(id);
+        this.waitWakeAdmitted.delete(id);
+        this.removeWake(id);
+    }
+    dispose() {
+        this.waiting.clear();
+        this.starting.clear();
+        this.queue.length = 0;
+        this.pendingJobs.clear();
+        this.pendingContinuations.clear();
+    }
+}
+//# sourceMappingURL=run-line.js.map

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

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

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

@@ -0,0 +1,116 @@
+import type { WaitEngine } from './wait-engine.ts';
+import type { RunExitId } from '../../runs/run-exits.ts';
+import type { ContinueRunOptions } from '../continuation-admission.ts';
+import type { WorkerScratchCleanup } from '../../delegation/scratch-cleanup.ts';
+import type { HumanWaits } from './human-waits.ts';
+import type { InboxClaims } from './inbox-claims.ts';
+import type { WorkerOrphans } from './worker-orphans.ts';
+import type { RunRecord, RunStore } from '../../runs/store.ts';
+import type { RunModuleContext } from './types.ts';
+import type { FamilyReconciler } from './family-reconciler.ts';
+import type { WorkerQuestions } from './worker-questions.ts';
+import type { AutoResumeScheduler } from './auto-resume.ts';
+interface RunRecoveryHost {
+    waitEngine: WaitEngine;
+    workerScratchCleanup: WorkerScratchCleanup;
+    humanWaits: HumanWaits;
+    inboxClaims: InboxClaims;
+    orphans: WorkerOrphans;
+    isActive(id: string): boolean;
+    workerExecutionStopped(id: string): boolean;
+    move(id: string, exit: RunExitId, patch?: Omit<Parameters<RunStore['updateRun']>[1], 'status'>): unknown;
+    cancel(id: string): unknown;
+    continueRun(id: string, opts: ContinueRunOptions, defer: boolean): {
+        ok: boolean;
+        error?: string;
+    };
+    reviveQueuedRun(run: RunRecord, reason: string): Promise<void>;
+    requeueInterruptedRun(run: RunRecord, step: RunRecord['currentStepId']): boolean;
+    checkpointRestartContext(run: RunRecord): RunRecord;
+    deliverConversationInput(id: string): void;
+    answerRoutedQuestion(id: string): void;
+    queueWaitWake(id: string): void;
+    owesWake(run: RunRecord): boolean;
+    settleOrphanedWorkerExecution(id: string): boolean;
+    settleRequestedRootFinish(id: string): Promise<void>;
+    settleSuccess(id: string): Promise<void>;
+    reconcileWorkerWaits(family?: string): void;
+    pump(): Promise<void>;
+    recover(family?: string): Promise<void>;
+}
+export declare class RunRecovery {
+    private readonly context;
+    private readonly familyReconciler;
+    private readonly workerQuestions;
+    private readonly autoResumeScheduler;
+    private readonly host;
+    private readonly restartContinuationPrompt;
+    /** What the recovery in progress covers: every run at boot (`family` undefined), or the one
+     *  family an adoption hands it (#779, plan step 3). Undefined: no recovery in progress. */
+    private recoveryScope;
+    /** Settles when the recovery in progress (if any) has finished. */
+    private recoveryInFlight;
+    /** Adoptions of dead processes' runs, one at a time (`adoptOrphanedRun`). */
+    private adoptionTail;
+    constructor(context: RunModuleContext, familyReconciler: FamilyReconciler, workerQuestions: WorkerQuestions, autoResumeScheduler: AutoResumeScheduler, host: RunRecoveryHost, restartContinuationPrompt: string);
+    /** Whether any recovery is in progress: one at a time (`recover`), and `pump` waits for it. */
+    get recovering(): boolean;
+    /**
+     * Whether a recovery in progress holds this run, so its wakes, input flushes and delegation
+     * reconciles wait for that recovery's own passes: every run during boot recovery, and only the
+     * adopted family's during a recovery scoped to one. The rest of a running project stays live: a
+     * wake held back for an unrelated family would be lost, since the scoped passes never revisit it.
+     */
+    recoveringRun(run: RunRecord | string | undefined): boolean;
+    recover(familyRootId?: string): Promise<void>;
+    adoptOrphanedRun(runId: string, opts?: {
+        stop?: boolean;
+    }): Promise<boolean>;
+    /** The workers in scope whose generation a dead controller left `starting`, and the members of
+     *  their families, whose transcript facts recovery prepares before it settles them. */
+    private collectOrphanWorkerGenerations;
+    /** Recovery's first pass over the live set: the input state a dead controller left behind. */
+    private recoverUnreadInputs;
+    /** Settles each orphaned `starting` generation, or re-probes it when its proof does not settle. */
+    private settleOrphanWorkerGenerations;
+    /** Restart sweeps every worker's scratch; an adopted family schedules only its own members. */
+    private recoverWorkerScratch;
+    /**
+     * One live run of the restart loop. Returns the promise the loop must await (a root finish, a
+     * re-queue or a settlement), else `undefined`.
+     */
+    private recoverLiveRun;
+    /** True when a worker's root takes no more work from it: a settled root cancels the worker
+     *  (hearsay-tools/cezarion#2410), and a finishing root leaves it as it is. */
+    private recoveryLeavesWorkerToRoot;
+    /** An unanswered `ask.requested` with no open human wait (a row written before every ask opened
+     *  one) gets an open agent wait shown as that ask. Answer delivery still reads the transcript.
+     *  Cezar's own wait not shown as that ask is replaced, as the live ask does: a crash between
+     *  saving the ask and replacing it leaves that wait open (review of #1437). */
+    private adoptTranscriptAsk;
+    /** The human wait upgraded from a stored `hasPendingHumanAsk` (`turnId: 'legacy'`, never shown)
+     *  is settled as answered when the transcript's facts are known and hold no unanswered ask: that
+     *  flag was read from the transcript, so its ask was answered after the row was last saved.
+     *  Unknown facts are no evidence, and the wait stays open. */
+    private settleAnsweredLegacyAsk;
+    /** The run as recovery reads it after it reconciles the run's question state. */
+    private reconcileRecoveredAsk;
+    /** True when the recovered run stays parked: on a human wait, a pending question or its waits. */
+    private parkRecoveredRun;
+    /** Parks a recovered run: `waiting`, with each of its open waits re-armed. */
+    private parkOnOpenWaits;
+    /**
+     * A `waiting` run that did not park. Returns the settlement the loop must await, else
+     * `undefined`.
+     */
+    private recoverClosedWaitingRun;
+    /** A recovered run whose structured question cannot be answered fails with its open steps. */
+    private failRecoveredInvalidAsk;
+    /** A `running` run whose process died mid-turn. */
+    private recoverInterruptedRun;
+    /** Delivers the parent replies routed to each worker in scope. */
+    private answerRecoveredRoutedQuestions;
+    /** Re-arms each live run's waits, or queues the wake it owes. */
+    private rearmRecoveredWakes;
+}
+export {};